Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
Light the diagram from anywhere in a step
tt-a1i0cc5e295d80a
diff --git a/archify/explainer/reader.css b/archify/explainer/reader.cssindex 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.jsindex 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.mjsindex 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 stepsconst 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 stepsconst 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);