Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

Light the diagram from anywhere in a step

tt-a1i0cc5e295d80a
diff --git a/archify/explainer/reader.css b/archify/explainer/reader.css
index 6ea77a0e..2ee94f78 100644
--- a/archify/explainer/reader.css
+++ b/archify/explainer/reader.css
@@ -184,7 +184,9 @@ meter{width:100%;height:8px;accent-color:var(--accent)}
.diagram-link>span{color:var(--faint);font-weight:400;transition:color .15s}
.diagram-link:hover{color:var(--accent);text-decoration:none}
.diagram-link:hover>span{color:var(--accent)}
-.steps li:has(.diagram-link:hover)::before,.steps li:has(.diagram-link:focus-visible)::before{background:var(--accent);color:#fff;border-color:var(--accent)}
+.steps li:has(.diagram-link):hover::before,.steps li:has(.diagram-link:focus-visible)::before{background:var(--accent);color:#fff;border-color:var(--accent)}
+.steps li:hover .diagram-link,.steps li:hover .diagram-link>span{color:var(--accent)}
+.steps li:has(.diagram-link):hover p{color:var(--secondary)}
/* Diagram preview: native SVG re-tinted and re-typeset to the page */
.diagram-panel .panel-body{display:flex;flex-direction:column;padding:14px 16px 16px}
diff --git a/archify/explainer/reader.js b/archify/explainer/reader.js
index 4d4fae82..cfd0b592 100644
--- a/archify/explainer/reader.js
+++ b/archify/explainer/reader.js
@@ -379,8 +379,11 @@
};
all('[data-diagram-link]').forEach(link=>{
link.addEventListener('click',event=>{ event.preventDefault(); openViewer(link.dataset.diagramLink,link.dataset.diagramHash || '',link); });
- const highlight = active => { const {preview,nodes,edges} = targetOf(link); spotlight(preview,active ? nodes : [],active ? edges : []); };
- link.addEventListener('mouseenter',()=>highlight(true)); link.addEventListener('mouseleave',()=>highlight(false)); link.addEventListener('focus',()=>highlight(true)); link.addEventListener('blur',()=>highlight(false));
+ // A walk-through owns the highlight while it runs.
+ const highlight = active => { if (walking) return; const {preview,nodes,edges} = targetOf(link); spotlight(preview,active ? nodes : [],active ? edges : []); };
+ // A step lights its part of the diagram from anywhere in it, its description included.
+ const hover = link.closest('.steps>li') || link;
+ hover.addEventListener('mouseenter',()=>highlight(true)); hover.addEventListener('mouseleave',()=>highlight(false)); link.addEventListener('focus',()=>highlight(true)); link.addEventListener('blur',()=>highlight(false));
});
// A name in the text that is also a node label is linked to that node, once per panel, both ways:
// hovering the word lights the node, hovering the node lights the word.
diff --git a/test/explainer-browser.test.mjs b/test/explainer-browser.test.mjs
index 3a60bd03..c114d2e8 100644
--- a/test/explainer-browser.test.mjs
+++ b/test/explainer-browser.test.mjs
@@ -117,6 +117,7 @@ test('text names light their diagram nodes and walk-throughs step through steps
const terms=[...document.querySelectorAll('#why .term')].map(t=>t.textContent);
const redis=document.querySelector('#why .term[data-node="redis"]');redis.dispatchEvent(new MouseEvent('mouseenter'));
const lit=[...document.querySelectorAll('#native .reader-highlight')].map(e=>e.dataset.nodeId||e.dataset.edgeId);redis.dispatchEvent(new MouseEvent('mouseleave'));
+ const step=document.querySelector('#return-step');step.dispatchEvent(new MouseEvent('mouseenter'));const stepHover=[...document.querySelectorAll('#native .reader-highlight')].map(e=>e.dataset.nodeId||e.dataset.edgeId);step.dispatchEvent(new MouseEvent('mouseleave'));const cleared=!document.querySelector('#native .reader-highlight');
const steps=document.querySelector('ol.steps').previousElementSibling;steps.click();document.querySelector('.walk-bar [data-walk=next]').click();
const current=document.querySelector('.walk-current')?.id,stepLit=[...document.querySelectorAll('#native .reader-highlight')].map(e=>e.dataset.nodeId||e.dataset.edgeId);
document.querySelector('.walk-bar [data-walk=end]').click();const ended=!document.querySelector('.walk-bar')&&!document.querySelector('.walk-current');
@@ -124,9 +125,11 @@ test('text names light their diagram nodes and walk-throughs step through steps
const text=document.querySelector('.walk-text').textContent;
document.querySelector('#how .ask-button').click();document.querySelector('.ask-dialog [data-chip]').click();
let copied='';navigator.clipboard.writeText=value=>{copied=value;return Promise.resolve();};document.querySelector('.ask-dialog [type=submit]').click();
- return new Promise(resolve=>setTimeout(()=>resolve({terms,lit,current,stepLit,ended,text,copied,open:document.querySelector('.ask-dialog').open}),50));})()`);
+ return new Promise(resolve=>setTimeout(()=>resolve({terms,lit,stepHover,cleared,current,stepLit,ended,text,copied,open:document.querySelector('.ask-dialog').open}),50));})()`);
assert.deepEqual(result.terms,['API','Redis'],'each name is linked once per panel');
assert.deepEqual(result.lit,['redis']);
+ assert.deepEqual(result.stepHover.sort(),['redis','redis-to-api-1'],'hovering anywhere in a step lights its node and edge');
+ assert.equal(result.cleared,true);
assert.equal(result.current,'return-step');
assert.ok(result.stepLit.includes('redis-to-api-1'));
assert.equal(result.ended,true);