Skip to content

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

perf(architecture): scan SVG crossovers once and mirror mask state

tt-a1i65de0e080b78
diff --git a/archify/assets/template.html b/archify/assets/template.html
index f7b8da47..21c1e089 100644
--- a/archify/assets/template.html
+++ b/archify/assets/template.html
@@ -942,6 +942,9 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
html:not([data-motion-capable="true"]) svg[data-animation="trace"] [data-animate] {
animation: none !important;
}
+ html:not([data-motion-capable="true"]) svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+ }
html[data-motion="still"] .pulse-dot,
html[data-motion="still"] .diagram-container::before,
html[data-motion="still"] svg[data-animation="trace"] [data-animate],
@@ -954,7 +957,12 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
html[data-share-playback="true"] .diagram-container::before,
html[data-document-hidden="true"] .pulse-dot,
html[data-document-hidden="true"] .diagram-container::before,
- html[data-document-hidden="true"] svg[data-animation="trace"] [data-animate] {
+ html[data-document-hidden="true"] svg[data-animation="trace"] [data-animate],
+ html[data-motion="still"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+ html[data-motion-owner] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+ html[data-embed="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+ html[data-share-playback="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+ html[data-document-hidden="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
animation: none !important;
}
html[data-motion="still"] .diagram-container::before,
@@ -3186,12 +3194,16 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
.story-carrier-overlay { display: none !important; }
.diagram-container svg[data-focus-active] [data-node-id],
.diagram-container svg[data-focus-active] [data-edge-from],
+ .diagram-container svg[data-focus-active] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-reach-active] [data-node-id],
.diagram-container svg[data-reach-active] [data-edge-from],
+ .diagram-container svg[data-reach-active] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-story-beat] [data-story-step],
.diagram-container svg[data-story-beat] [data-edge-from][data-story-beat-step],
+ .diagram-container svg[data-story-beat] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-route-active] [data-node-id],
- .diagram-container svg[data-route-active] [data-edge-from] {
+ .diagram-container svg[data-route-active] [data-edge-from],
+ .diagram-container svg[data-route-active] [data-graph-role="automatic-crossover-underlay"] {
opacity: 1 !important;
filter: none !important;
animation: none !important;
@@ -4231,7 +4243,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
cursor: pointer;
transition: opacity 0.18s ease, filter 0.18s ease;
}
- svg [data-edge-from] { transition: opacity 0.18s ease, filter 0.18s ease; }
+ svg [data-edge-from],
+ svg [data-graph-role="automatic-crossover-underlay"] { transition: opacity 0.18s ease, filter 0.18s ease; }
svg [data-node-id]:hover,
svg [data-node-id]:focus-visible {
filter: drop-shadow(0 0 7px var(--frontend-stroke));
@@ -4380,10 +4393,22 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
opacity: 0.78;
}
html[data-embed="true"] .semantic-lens-overlay { display: none; }
+ /* Automatic crossover masks are visual companions of their one semantic
+ edge. Keep the mask free of data-edge-* identity so graph traversal and
+ export still observe exactly one edge, then mirror reader emphasis from
+ the paired foreground path in this presentation-only wrapper. */
+ svg[data-legend-preview-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"],
+ svg[data-lens-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.11; }
+ svg[data-legend-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-legend-preview-match]) > [data-graph-role="automatic-crossover-underlay"],
+ svg[data-lens-active] [data-graph-role="automatic-crossover"]:has(> [data-lens-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
+ svg[data-legend-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-legend-preview-peer]) > [data-graph-role="automatic-crossover-underlay"],
+ svg[data-lens-active] [data-graph-role="automatic-crossover"]:has(> [data-lens-peer]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.62; }
svg[data-focus-active] [data-node-id],
svg[data-focus-active] [data-edge-from] { opacity: 0.13; }
+ svg[data-focus-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.13; }
svg[data-focus-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-focus-active] [data-focus-match] { opacity: 1; }
+ svg[data-focus-active] [data-graph-role="automatic-crossover"]:has(> [data-focus-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-focus-active] [data-focus-selected] {
filter: drop-shadow(0 0 10px var(--frontend-stroke));
}
@@ -4394,7 +4419,9 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
changes only viewer emphasis, not canonical geometry or export bytes. */
svg[data-reach-active] [data-node-id],
svg[data-reach-active] [data-edge-from] { opacity: 0.09; }
+ svg[data-reach-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.09; }
svg[data-reach-active] [data-reach-match] { opacity: 1; }
+ svg[data-reach-active] [data-graph-role="automatic-crossover"]:has(> [data-reach-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-reach-active="upstream"] [data-reach-origin] {
filter: drop-shadow(0 0 11px var(--database-stroke));
}
@@ -4448,8 +4475,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
}
svg[data-relationship-direct-active] [data-node-id],
svg[data-relationship-direct-active] [data-edge-from] { opacity: 0.16; }
+ svg[data-relationship-direct-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.16; }
svg[data-relationship-direct-active] [data-relationship-preview],
svg[data-relationship-direct-active] [data-relationship-preview-node] { opacity: 1; }
+ svg[data-relationship-direct-active] [data-graph-role="automatic-crossover"]:has(> [data-relationship-preview]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-focus-active]:not([data-relationship-pin-active]) .relationship-hit-rail,
svg[data-story-active] .relationship-hit-rail,
svg[data-route-picking] .relationship-hit-rail,
@@ -4465,9 +4494,11 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
neighborhood focus. It changes emphasis only; exported geometry and the
relationship's original solid/dashed visual language stay untouched. */
svg[data-relationship-preview-active] [data-focus-match] { opacity: 0.18; }
+ svg[data-relationship-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-focus-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.18; }
svg[data-relationship-preview-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-relationship-preview-active] [data-relationship-preview],
svg[data-relationship-preview-active] [data-relationship-preview-node] { opacity: 1; }
+ svg[data-relationship-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-relationship-preview]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-relationship-preview-active] [data-relationship-preview] {
filter: drop-shadow(0 0 5px var(--arrow-emphasis));
}
@@ -4563,8 +4594,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
cloned edge geometry; the authored edge remains untouched underneath. */
svg[data-intent-trace-active] [data-node-id],
svg[data-intent-trace-active] [data-edge-from] { opacity: 0.2; }
+ svg[data-intent-trace-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.2; }
svg[data-intent-trace-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-intent-trace-active] [data-intent-trace-match] { opacity: 1; }
+ svg[data-intent-trace-active] [data-graph-role="automatic-crossover"]:has(> [data-intent-trace-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-intent-trace-active] [data-intent-trace-selected] {
filter: drop-shadow(0 0 10px var(--frontend-stroke));
}
@@ -4627,7 +4660,9 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
}
svg[data-route-active] [data-node-id],
svg[data-route-active] [data-edge-from] { opacity: 0.11; }
+ svg[data-route-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.11; }
svg[data-route-active] [data-route-match] { opacity: 1; }
+ svg[data-route-active] [data-graph-role="automatic-crossover"]:has(> [data-route-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-route-active] [data-route-start] {
filter: drop-shadow(0 0 11px var(--frontend-stroke));
}
@@ -4640,6 +4675,9 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
svg[data-route-journey] [data-route-match][data-route-journey-state="past"] { opacity: 0.62; }
svg[data-route-journey] [data-route-match][data-route-journey-state="future"] { opacity: 0.34; }
svg[data-route-journey] [data-route-match][data-route-journey-state="current"] { opacity: 1; }
+ svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="past"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.62; }
+ svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="future"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.34; }
+ svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="current"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-route-journey] [data-node-id][data-route-journey-current] {
filter: drop-shadow(0 0 10px var(--backend-stroke));
}
@@ -4767,9 +4805,16 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
opacity: 0.16;
transition: opacity 160ms ease;
}
+ svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step]) > [data-graph-role="automatic-crossover-underlay"] {
+ opacity: 0.16;
+ transition: opacity 160ms ease;
+ }
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="past"] { opacity: 0.58; }
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="next"] { opacity: 0.34; }
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="active"] { opacity: 1; }
+ svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="past"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.58; }
+ svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="next"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.34; }
+ svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="active"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-story-beat] .story-trail-flow { opacity: 0; transition: opacity 160ms ease; }
svg[data-story-beat] .story-trail-flow[data-story-beat-state="past"] { opacity: 0.34; }
svg[data-story-beat] .story-trail-flow[data-story-beat-state="next"] { opacity: 0.2; }
@@ -4798,7 +4843,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
chapter focus sets. Symbols in the rail carry the meaning without color;
these SVG rules only make exact stable-ID membership easier to scan. */
svg[data-chapter-preview] [data-node-id],
- svg[data-chapter-preview] [data-edge-from] {
+ svg[data-chapter-preview] [data-edge-from],
+ svg[data-chapter-preview] [data-graph-role="automatic-crossover-underlay"] {
opacity: 0.1 !important;
filter: none !important;
transition: none !important;
@@ -4831,6 +4877,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
animation: archify-edge-flow 2.4s linear 1;
animation-delay: calc(var(--step, 0) * 160ms);
}
+ html[data-ambient-motion="running"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: archify-edge-flow 2.4s linear 1;
+ animation-delay: calc(var(--step, 0) * 160ms);
+ }
html[data-ambient-motion="running"] svg[data-animation="trace"] [data-animate="node"] {
transform-box: fill-box;
transform-origin: center;
@@ -4842,6 +4892,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
filter: drop-shadow(0 0 3px var(--arrow-emphasis));
animation-duration: 1.75s;
}
+ svg[data-preset="signal-flow"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 1.75s; }
svg[data-preset="signal-flow"][data-animation="trace"] [data-animate="node"] {
animation-duration: 3.1s;
}
@@ -4850,6 +4901,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
filter: none;
animation-duration: 2.15s;
}
+ svg[data-preset="blueprint"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 2.15s; }
svg[data-preset="blueprint"][data-animation="trace"] [data-animate="node"] {
animation-name: archify-blueprint-node-pulse;
animation-duration: 3.8s;
@@ -4858,6 +4910,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
filter: none;
animation-duration: 2.2s;
}
+ svg[data-preset="editorial"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 2.2s; }
svg[data-preset="editorial"][data-animation="trace"] [data-animate="node"] {
animation-name: archify-editorial-node-pulse;
animation-duration: 3.5s;
@@ -4870,6 +4923,11 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
animation: none !important;
stroke-dashoffset: 0;
}
+ html[data-embed="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+ html[data-share-playback="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+ stroke-dashoffset: 0;
+ }
@keyframes archify-edge-flow {
0% { stroke-dasharray: 10 8; stroke-dashoffset: 54; opacity: 0.42; }
88% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }
@@ -4959,6 +5017,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
animation: none !important;
stroke-dashoffset: 0;
}
+ svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+ stroke-dashoffset: 0;
+ }
.guided-view-progress span {
animation: none !important;
transform: scaleX(1) !important;
@@ -4977,7 +5039,8 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
.share-chapter-progress span { animation: none !important; }
.guided-view-chapter,
svg[data-chapter-preview] [data-node-id],
- svg[data-chapter-preview] [data-edge-from] { transition: none !important; }
+ svg[data-chapter-preview] [data-edge-from],
+ svg[data-chapter-preview] [data-graph-role="automatic-crossover-underlay"] { transition: none !important; }
svg[data-story-playing="true"] .story-trail-flow {
stroke-dasharray: none;
stroke-dashoffset: 0;
@@ -6329,15 +6392,15 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
}
if (opts.routeSnapshot) {
- style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" +
- "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" +
+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from], svg[data-share-route] [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 0.18; }\n" +
+ "svg[data-share-route] [data-share-route-match], svg[data-share-route] [data-graph-role=\"automatic-crossover\"]:has(> [data-share-route-match]) > [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 1; }\n" +
"svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" +
"svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" +
"svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";
}
if (opts.reachSnapshot) {
- style.textContent += "\nsvg[data-share-reach] [data-node-id], svg[data-share-reach] [data-edge-from] { opacity: 0.14; }\n" +
- "svg[data-share-reach] [data-share-reach-match] { opacity: 1; }\n" +
+ style.textContent += "\nsvg[data-share-reach] [data-node-id], svg[data-share-reach] [data-edge-from], svg[data-share-reach] [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 0.14; }\n" +
+ "svg[data-share-reach] [data-share-reach-match], svg[data-share-reach] [data-graph-role=\"automatic-crossover\"]:has(> [data-share-reach-match]) > [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 1; }\n" +
"svg[data-share-reach] [data-edge-from][data-share-reach-match] { stroke-width: 1.55; }\n" +
"svg[data-share-reach=\"upstream\"] [data-share-reach-origin] > :is(rect, circle, polygon):not(.c-mask) { stroke: var(--database-stroke); stroke-width: 3.4; stroke-dasharray: 5 3; }\n" +
"svg[data-share-reach=\"downstream\"] [data-share-reach-origin] > :is(rect, circle, polygon):not(.c-mask) { stroke: var(--backend-stroke); stroke-width: 3.4; stroke-dasharray: 1 0; }\n" +
@@ -7241,6 +7304,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
} catch (_) {}
})();
+
/* ============================================================
Motion Governor — one reader switch and one motion budget. Ambient
trace yields to the strongest semantic owner; Still also parks bounded
@@ -11198,6 +11262,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
var MIN_READER_WIDTH = 960;
var MAX_READER_WIDTH = 1920;
var MIN_PROJECTED_NODE_TEXT_PX = 6;
+ var declaredMinimumText = svg ? parseFloat(svg.getAttribute('data-reader-min-text') || '') : null;
+ var requestedMinimumText = Number.isFinite(declaredMinimumText)
+ ? Math.max(MIN_PROJECTED_NODE_TEXT_PX, declaredMinimumText)
+ : MIN_PROJECTED_NODE_TEXT_PX;
var SAFE_BOTTOM_GAP = 12;
if (diagram && ratio >= WIDE_RATIO) {
@@ -11229,7 +11297,7 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
}
});
return sourceMinimum != null
- ? Math.min(1, MIN_PROJECTED_NODE_TEXT_PX / sourceMinimum)
+ ? Math.min(1, requestedMinimumText / sourceMinimum)
: 1;
}
function eligible() {
diff --git a/archify/bin/visual-check.mjs b/archify/bin/visual-check.mjs
index 147a2376..61cf3fc9 100644
--- a/archify/bin/visual-check.mjs
+++ b/archify/bin/visual-check.mjs
@@ -37,11 +37,11 @@ export const VISUAL_CHECK_VIEWPORTS = Object.freeze([
Object.freeze({ width: 2048, height: 1320 }),
]);
-const CAPTURE_VIEWPORTS = Object.freeze([
+export const CAPTURE_VIEWPORTS = Object.freeze([
VISUAL_CHECK_VIEWPORTS[0],
VISUAL_CHECK_VIEWPORTS[VISUAL_CHECK_VIEWPORTS.length - 1],
]);
-const THEMES = Object.freeze(['light', 'dark']);
+export const THEMES = Object.freeze(['light', 'dark']);
const EXIT = Object.freeze({ pass: 0, fail: 1, skipped: 2 });
export const CHROME_NO_SANDBOX_ENV = 'ARCHIFY_CHROME_NO_SANDBOX';
const VISUAL_SIDECAR_SUFFIXES = Object.freeze([
diff --git a/archify/renderers/architecture/render-architecture.mjs b/archify/renderers/architecture/render-architecture.mjs
index 90c25312..69eb62dc 100644
--- a/archify/renderers/architecture/render-architecture.mjs
+++ b/archify/renderers/architecture/render-architecture.mjs
@@ -782,11 +782,16 @@ function renderConnectionPath(conn, index) {
const [cls, marker] = arrowClassMap[conn.variant || 'default'] || arrowClassMap.default;
const routed = pathFor(conn);
const strokeWidth = conn.width || (conn.variant === 'emphasis' ? 1.8 : 1.5);
- const underlay = hasAutomaticRouteGeometry(conn)
- ? ` <path data-graph-role="automatic-crossover-underlay" d="${routed.d}" fill="none" stroke="var(--mask)" stroke-width="${strokeWidth + 4}" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>\n`
+ const automaticRoute = hasAutomaticRouteGeometry(conn);
+ const underlay = automaticRoute
+ ? ` <path data-graph-role="automatic-crossover-underlay" d="${routed.d}" fill="none" stroke="var(--mask)" stroke-width="${strokeWidth + 4}" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>\n`
: '';
- const crossover = hasAutomaticRouteGeometry(conn) ? ' data-composition-crossover="halo"' : '';
- return `${underlay} <path ${focusEdgeAttrs(conn.from, conn.to, conn.label, index, conn.id)} data-composition-points="${routePointsValue(routed.points)}"${crossover}${authoredStraightRouteAttrs(conn, routed.points)} d="${routed.d}" class="${cls}"${animateAttr(arch.meta, 'edge', index)} stroke-width="${strokeWidth}" marker-end="url(#${marker})"/>`;
+ const crossover = automaticRoute ? ' data-composition-crossover="halo"' : '';
+ const edge = ` <path ${focusEdgeAttrs(conn.from, conn.to, conn.label, index, conn.id)} data-composition-points="${routePointsValue(routed.points)}"${crossover}${authoredStraightRouteAttrs(conn, routed.points)} d="${routed.d}" class="${cls}"${animateAttr(arch.meta, 'edge', index)} stroke-width="${strokeWidth}" marker-end="url(#${marker})"/>`;
+ if (!automaticRoute) return edge;
+ // The wrapper is presentation-only: viewer state remains on the one semantic
+ // edge, while CSS can keep its preceding mask underlay at the same opacity.
+ return ` <g data-graph-role="automatic-crossover" style="--step:${index}">\n${underlay}${edge.replace(/^ /, ' ')}\n </g>`;
}
function renderConnectionLabel(conn, index) {
diff --git a/archify/scripts/check-render-output.mjs b/archify/scripts/check-render-output.mjs
index 0202bd2e..68c76a70 100644
--- a/archify/scripts/check-render-output.mjs
+++ b/archify/scripts/check-render-output.mjs
@@ -68,6 +68,7 @@ let composition = {
const NON_FINITE_TOKEN = /\b(?:NaN|undefined|Infinity)\b/;
// Consume comments/CDATA as whole tokens, including any tag-like prose.
const SVG_TAG_TOKEN = /<!--[\s\S]*?(?:-->|$)|<!\[CDATA\[[\s\S]*?(?:\]\]>|$)|<(\/?)([A-Za-z][\w:-]*)(?=[\s/>])(?:[^>"']|"[^"]*"|'[^']*')*>/g;
+const AUTOMATIC_CROSSOVER_UNDERLAY_TAG = /<path\b[^>]*\bdata-graph-role="automatic-crossover-underlay"[^>]*\/>/i;
const HTML_VOID_ELEMENTS = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', 'track', 'wbr']);
const SVG_HTML_INTEGRATION_POINTS = new Set(['foreignobject', 'desc', 'title']);
const HTML_ATTRIBUTE = /([A-Za-z_:][\w:.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+))/g;
@@ -343,16 +344,27 @@ process.exitCode = ok ? 0 : 1;
function collectArrows(fragment) {
const arrows = [];
let index = 0;
+ let previousTag = null;
+ let previousTagEnd = 0;
for (const tag of fragment.matchAll(/<(path|line)\b[^>]*>/gi)) {
+ const tagStart = tag.index;
const raw = tag[0];
+ const gap = previousTag ? fragment.slice(previousTagEnd, tagStart) : '';
+ const precedingUnderlay = previousTag
+ && /^\s*$/.test(gap)
+ && previousTag.name === 'path'
+ && previousTag.underlayAttrs;
+ previousTag = {
+ name: tag[1].toLowerCase(),
+ underlayAttrs: tag[1].toLowerCase() === 'path' && AUTOMATIC_CROSSOVER_UNDERLAY_TAG.test(raw)
+ ? parseAttrs(raw)
+ : null,
+ };
+ previousTagEnd = tagStart + raw.length;
if (!/\bclass="[^"]*\ba-(?:default|emphasis|security|dashed)\b/.test(raw)) continue;
if (!/\bmarker-end=/.test(raw)) continue;
const attrs = parseAttrs(raw);
- const precedingUnderlayTag = fragment.slice(0, tag.index).match(
- /(<path\b[^>]*\bdata-graph-role="automatic-crossover-underlay"[^>]*\/>)\s*$/i,
- )?.[1];
- const precedingUnderlay = precedingUnderlayTag ? parseAttrs(precedingUnderlayTag) : null;
const routeStrokeWidth = numberAttr(attrs, 'stroke-width');
const underlayStrokeWidth = precedingUnderlay ? numberAttr(precedingUnderlay, 'stroke-width') : NaN;
const verifiedCrossoverHalo = attrs['data-composition-crossover'] === 'halo'
diff --git a/archify/test/crossover-state-browser.test.mjs b/archify/test/crossover-state-browser.test.mjs
new file mode 100644
index 00000000..f2c4918c
--- /dev/null
+++ b/archify/test/crossover-state-browser.test.mjs
@@ -0,0 +1,209 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { ChromeVisualBrowser, findChrome } from '../bin/visual-check.mjs';
+
+const skillRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const chrome = process.env.ARCHIFY_CHROME ? findChrome() : null;
+
+test('automatic crossover masks follow live relationship state without becoming semantic edges', {
+ skip: chrome ? false : 'Set ARCHIFY_CHROME to run real-browser crossover checks.',
+}, async (t) => {
+ const scratch = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-crossover-state-'));
+ t.after(() => fs.rmSync(scratch, { recursive: true, force: true }));
+ const input = path.join(scratch, 'crossing.architecture.json');
+ const output = path.join(scratch, 'crossing.architecture.html');
+ fs.writeFileSync(input, JSON.stringify({
+ schema_version: 1,
+ diagram_type: 'architecture',
+ meta: {
+ title: 'Crossover reader state', output: 'crossing.architecture.html', quality_profile: 'showcase', animation: 'trace',
+ views: [{ id: 'horizontal', label: 'Horizontal path', focus: ['left', 'right'] }],
+ },
+ components: [
+ { id: 'left', type: 'frontend', label: 'Left', pos: [40, 170], size: [80, 60] },
+ { id: 'right', type: 'backend', label: 'Right', pos: [480, 170], size: [80, 60] },
+ { id: 'top', type: 'database', label: 'Top', pos: [260, 20], size: [80, 60] },
+ { id: 'bottom', type: 'external', label: 'Bottom', pos: [260, 320], size: [80, 60] },
+ ],
+ connections: [
+ { id: 'horizontal', from: 'left', to: 'right', fromSide: 'right', toSide: 'left' },
+ { id: 'vertical', from: 'top', to: 'bottom', fromSide: 'bottom', toSide: 'top' },
+ ],
+ }));
+ execFileSync(process.execPath, [path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'), input, output]);
+
+ const rendered = fs.readFileSync(output, 'utf8');
+ const svgMarkup = rendered.match(/<svg\b[\s\S]*?<\/svg>/i)?.[0] || '';
+ assert.equal((svgMarkup.match(/data-graph-role="automatic-crossover"/g) || []).length, 2);
+ assert.equal((svgMarkup.match(/data-graph-role="automatic-crossover-underlay"/g) || []).length, 2);
+ assert.equal((svgMarkup.match(/data-edge-from=/g) || []).length, 2);
+ assert.doesNotMatch(svgMarkup, /automatic-crossover-underlay"[^>]*data-edge-/);
+
+ const browser = new ChromeVisualBrowser(chrome);
+ t.after(() => browser.close());
+ const session = await browser.sessionPromise;
+ const send = (method, params = {}) => browser.cdp.send(method, params, session);
+ await browser.cdp.send('Browser.setDownloadBehavior', { behavior: 'deny' });
+ async function run(expression, awaitPromise = false) {
+ const result = await send('Runtime.evaluate', { expression, awaitPromise, returnByValue: true });
+ assert.equal(result.exceptionDetails, undefined, result.exceptionDetails?.exception?.description);
+ return result.result?.value;
+ }
+ async function load() {
+ await send('Emulation.setDeviceMetricsOverride', { width: 1440, height: 900, deviceScaleFactor: 1, mobile: false });
+ const loaded = browser.cdp.waitFor('Page.loadEventFired', session);
+ await send('Page.navigate', { url: pathToFileURL(output).href });
+ await loaded;
+ await run('(async () => { await document.fonts.ready; await Archify.viewerChromeLayout.whenStable(); })()', true);
+ }
+ async function pairedOpacity() {
+ return run(`(() => [...document.querySelectorAll('[data-graph-role="automatic-crossover"]')].map(wrapper => {
+ const edge = wrapper.querySelector('[data-edge-from]');
+ const underlay = wrapper.querySelector('[data-graph-role="automatic-crossover-underlay"]');
+ return { id: edge.getAttribute('data-edge-id'), wrapper: Number(getComputedStyle(wrapper).opacity), edge: Number(getComputedStyle(edge).opacity), underlay: Number(getComputedStyle(underlay).opacity),
+ matched: edge.hasAttribute('data-focus-match'), preview: edge.hasAttribute('data-relationship-preview'), beat: edge.getAttribute('data-story-beat-state') };
+ }))()`);
+ }
+ function assertPaired(state, expected = {}) {
+ for (const relation of state) {
+ assert.equal(relation.wrapper, 1, JSON.stringify(relation));
+ assert.equal(relation.underlay, relation.edge, JSON.stringify(relation));
+ if (expected[relation.id] != null) assert.equal(relation.edge, expected[relation.id], JSON.stringify(relation));
+ }
+ }
+ async function samplePairs(frames) {
+ return run(`new Promise(resolve => {
+ const samples = [];
+ function read() {
+ return [...document.querySelectorAll('[data-graph-role="automatic-crossover"]')].map(wrapper => {
+ const edge = wrapper.querySelector('[data-edge-from]');
+ const underlay = wrapper.querySelector('[data-graph-role="automatic-crossover-underlay"]');
+ return {
+ id: edge.getAttribute('data-edge-id'),
+ edge: Number(getComputedStyle(edge).opacity), underlay: Number(getComputedStyle(underlay).opacity),
+ edgeAnimation: getComputedStyle(edge).animationName,
+ underlayAnimation: getComputedStyle(underlay).animationName,
+ edgeDashoffset: getComputedStyle(edge).strokeDashoffset,
+ underlayDashoffset: getComputedStyle(underlay).strokeDashoffset,
+ edgeTransition: edge.getAnimations().some(animation => animation.transitionProperty === 'opacity'),
+ underlayTransition: underlay.getAnimations().some(animation => animation.transitionProperty === 'opacity'),
+ };
+ });
+ }
+ (function sample() {
+ samples.push(read());
+ if (samples.length >= ${Number(frames)}) return resolve(samples);
+ requestAnimationFrame(sample);
+ })();
+ })`, true);
+ }
+ function assertTimedPairs(samples) {
+ for (const sample of samples) {
+ for (const relation of sample) {
+ assert.ok(Math.abs(relation.edge - relation.underlay) < 0.002, JSON.stringify(relation));
+ assert.equal(relation.edgeAnimation, relation.underlayAnimation, JSON.stringify(relation));
+ assert.equal(relation.edgeDashoffset, relation.underlayDashoffset, JSON.stringify(relation));
+ assert.equal(relation.edgeTransition, relation.underlayTransition, JSON.stringify(relation));
+ }
+ }
+ }
+
+ await load();
+ assert.equal(await run(`CSS.supports('selector(g:has(> path))')`), true);
+ const trace = await samplePairs(8);
+ assertTimedPairs(trace);
+ assert.equal(trace.some((sample) => sample.some((relation) => relation.edgeAnimation === 'archify-edge-flow' && relation.edge < 0.99)), true);
+ await run(`new Promise((resolve, reject) => {
+ const start = performance.now();
+ (function waitForAmbientSettle() {
+ if (document.documentElement.getAttribute('data-ambient-motion') === 'settled') return resolve();
+ if (performance.now() - start > 6500) return reject(new Error('Ambient trace did not settle'));
+ requestAnimationFrame(waitForAmbientSettle);
+ })();
+ })`, true);
+ await run(`Archify.focus.set('left', { toggle: false, updateUrl: false })`);
+ const focusTransition = await samplePairs(8);
+ assertTimedPairs(focusTransition);
+ assert.equal(focusTransition.some((sample) => sample.some((relation) => relation.edgeTransition)), true);
+ await run(`new Promise(resolve => setTimeout(resolve, 220))`, true);
+ const focus = await pairedOpacity();
+ assertPaired(focus, { horizontal: 1, vertical: 0.13 });
+ assert.deepEqual(focus.map((relation) => relation.id), ['horizontal', 'vertical']);
+
+ await run(`Archify.focus.inspectRelationshipById('horizontal', { updateUrl: false })`);
+ const preview = await pairedOpacity();
+ assertPaired(preview, { horizontal: 1, vertical: 0.13 });
+ assert.equal(preview.find((relation) => relation.id === 'horizontal').preview, true);
+
+ await run(`Archify.guidedViews.activate('horizontal', { updateUrl: false }); Archify.guidedViews.playCurrent()`);
+ await run(`new Promise((resolve, reject) => {
+ const start = performance.now();
+ (function waitForBeat() {
+ if (document.querySelector('[data-edge-id="horizontal"][data-story-beat-state="active"]')) return resolve();
+ if (performance.now() - start > 3500) return reject(new Error('Story beat did not become active'));
+ requestAnimationFrame(waitForBeat);
+ })();
+ })`, true);
+ await run(`new Promise(resolve => setTimeout(resolve, 220))`, true);
+ const story = await pairedOpacity();
+ assertPaired(story, { horizontal: 1 });
+ assert.equal(story.some((relation) => relation.beat === 'active'), true);
+
+ await load();
+ await run(`Archify.routeProbe.begin({ source: 'left', focusNode: false }); Archify.routeProbe.choose('right', { updateUrl: false })`);
+ async function shareExport(method) {
+ return run(`(async () => {
+ const original = URL.createObjectURL;
+ let source;
+ URL.createObjectURL = value => {
+ if (value.type.startsWith('image/svg+xml')) source = value;
+ return original.call(URL, value);
+ };
+ try { await Archify.exportMenu[${JSON.stringify(method)}](); }
+ finally { URL.createObjectURL = original; }
+ if (!source) throw new Error('Share export did not create its SVG source');
+ const text = await source.text();
+ const root = new DOMParser().parseFromString(text, 'image/svg+xml').documentElement;
+ const host = document.createElement('div');
+ host.style.cssText = 'position:fixed;left:-9999px;top:0;width:600px;height:400px';
+ const renderedRoot = document.importNode(root, true);
+ host.appendChild(renderedRoot); document.body.appendChild(host);
+ await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)));
+ const rendered = [...renderedRoot.querySelectorAll('[data-graph-role="automatic-crossover"]')].map(wrapper => {
+ const edge = wrapper.querySelector('[data-edge-from]');
+ const underlay = wrapper.querySelector('[data-graph-role="automatic-crossover-underlay"]');
+ return { id: edge.getAttribute('data-edge-id'), edge: Number(getComputedStyle(edge).opacity), underlay: Number(getComputedStyle(underlay).opacity) };
+ });
+ host.remove();
+ return {
+ semanticEdges: root.querySelectorAll('[data-edge-from]').length,
+ wrappers: root.querySelectorAll('[data-graph-role="automatic-crossover"]').length,
+ underlays: root.querySelectorAll('[data-graph-role="automatic-crossover-underlay"]').length,
+ style: root.querySelector('style')?.textContent || '',
+ rendered,
+ };
+ })()`, true);
+ }
+ const exported = await shareExport('downloadRouteShareCard');
+ assert.deepEqual({ semanticEdges: exported.semanticEdges, wrappers: exported.wrappers, underlays: exported.underlays },
+ { semanticEdges: 2, wrappers: 2, underlays: 2 });
+ assert.match(exported.style, /automatic-crossover-underlay/);
+ assert.match(exported.style, /data-share-route-match/);
+ assert.deepEqual(exported.rendered, [
+ { id: 'horizontal', edge: 1, underlay: 1 },
+ { id: 'vertical', edge: 0.18, underlay: 0.18 },
+ ]);
+
+ await load();
+ await run(`Archify.focus.set('left', { toggle: false, updateUrl: false }); Archify.focus.reach('downstream', { toggle: false, updateUrl: false, reveal: false })`);
+ const reachExported = await shareExport('downloadReachShareCard');
+ assert.deepEqual(reachExported.rendered, [
+ { id: 'horizontal', edge: 1, underlay: 1 },
+ { id: 'vertical', edge: 0.14, underlay: 0.14 },
+ ]);
+});
diff --git a/archify/test/layout-rules.test.mjs b/archify/test/layout-rules.test.mjs
index e4d0c046..72f6fa50 100644
--- a/archify/test/layout-rules.test.mjs
+++ b/archify/test/layout-rules.test.mjs
@@ -1693,8 +1693,12 @@ test('architecture: unavoidable automatic crossing renders as a verified crossov
const { code, stderr, outPath } = render('architecture', d);
assert.equal(code, 0, stderr);
const html = fs.readFileSync(outPath, 'utf8');
- assert.equal((html.match(/data-graph-role="automatic-crossover-underlay"/g) || []).length, 2);
- assert.equal((html.match(/data-composition-crossover="halo"/g) || []).length, 2);
+ const svg = html.match(/<svg\b[\s\S]*?<\/svg>/i)?.[0] || '';
+ assert.equal((svg.match(/data-graph-role="automatic-crossover-underlay"/g) || []).length, 2);
+ assert.equal((svg.match(/data-graph-role="automatic-crossover"/g) || []).length, 2);
+ assert.equal((svg.match(/data-composition-crossover="halo"/g) || []).length, 2);
+ assert.equal((svg.match(/data-edge-from=/g) || []).length, 2);
+ assert.doesNotMatch(svg, /automatic-crossover-underlay"[^>]*data-edge-/);
const receipt = JSON.parse(execFileSync('node', [
path.join(skillRoot, 'scripts', 'check-render-output.mjs'),
diff --git a/archify/test/reach-share-card.test.mjs b/archify/test/reach-share-card.test.mjs
index d98342d7..07b5b420 100644
--- a/archify/test/reach-share-card.test.mjs
+++ b/archify/test/reach-share-card.test.mjs
@@ -93,8 +93,8 @@ test('Reach variant decorates only a finite canonical clone with static authored
test('Reach styling preserves context, direction, and Blueprint restraint without motion', () => {
const html = render('dataflow', CASES.dataflow);
- assert.match(html, /svg\[data-share-reach\] \[data-node-id\], svg\[data-share-reach\] \[data-edge-from\] \{ opacity: 0\.14; \}/);
- assert.match(html, /svg\[data-share-reach\] \[data-share-reach-match\] \{ opacity: 1; \}/);
+ assert.match(html, /svg\[data-share-reach\] \[data-node-id\], svg\[data-share-reach\] \[data-edge-from\], svg\[data-share-reach\] \[data-graph-role=\\?"automatic-crossover-underlay\\?"\] \{ opacity: 0\.14; \}/);
+ assert.match(html, /svg\[data-share-reach\] \[data-share-reach-match\], svg\[data-share-reach\] \[data-graph-role=\\?"automatic-crossover\\?"\]:has\(> \[data-share-reach-match\]\) > \[data-graph-role=\\?"automatic-crossover-underlay\\?"\] \{ opacity: 1; \}/);
assert.match(html, /data-share-reach=\\?"upstream\\?"[\s\S]*?--database-stroke/);
assert.match(html, /data-share-reach=\\?"downstream\\?"[\s\S]*?--backend-stroke/);
assert.match(html, /data-preset=\\?"blueprint\\?"\]\[data-share-reach\][\s\S]*?filter: none/);
diff --git a/archify/test/render-output-checks.test.mjs b/archify/test/render-output-checks.test.mjs
index e70c11c1..d902f7d0 100644
--- a/archify/test/render-output-checks.test.mjs
+++ b/archify/test/render-output-checks.test.mjs
@@ -216,6 +216,29 @@ test('render output check: verified automatic crossover halos resolve a proper X
assert.deepEqual(result.composition.summary, { errors: 0, warnings: 0 });
});
+test('render output check: crossover halos fail closed when sibling adjacency is interrupted', () => {
+ const underlay = '<path data-graph-role="automatic-crossover-underlay" d="M 20 60 L 200 60" fill="none" stroke="var(--mask)" stroke-width="5.5" pointer-events="none"/>';
+ const route = '<path data-edge-id="left" data-edge-from="a" data-edge-to="b" data-composition-crossover="halo" d="M 20 60 L 200 60" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>';
+ const rightUnderlay = '<path data-graph-role="automatic-crossover-underlay" d="M 100 20 L 100 120" fill="none" stroke="var(--mask)" stroke-width="5.5" pointer-events="none"/>';
+ const rightRoute = '<path data-edge-id="right" data-edge-from="c" data-edge-to="d" data-composition-crossover="halo" d="M 100 20 L 100 120" class="a-dashed" stroke-width="1.5" marker-end="url(#arrowhead-dashed)"/>';
+ for (const [name, separator] of [
+ ['comment', '<!-- an intervening comment -->'],
+ ['element', '<path d="M 1 1 L 2 2"/>'],
+ ['group', '<g></g>'],
+ ]) {
+ const { code, result } = checkHtml(`showcase-crossover-nonadjacent-${name}`, `
+ ${underlay}
+ ${separator}
+ ${route}
+ ${rightUnderlay}
+ ${rightRoute}
+ `, 'showcase');
+ assert.notEqual(code, 0, name);
+ assert.equal(result.composition.metrics.properCrossings, 1, name);
+ assert.equal(result.composition.metrics.resolvedCrossovers, 0, name);
+ }
+});
+
test('render output check: a crossover marker without a matching underlay fails closed', () => {
const { code, result } = checkHtml('showcase-unverified-crossover-halo', `
<path data-graph-role="automatic-crossover-underlay" d="M 20 61 L 200 61" fill="none" stroke="var(--mask)" stroke-width="5.5" pointer-events="none"/>
diff --git a/archify/test/route-share-card.test.mjs b/archify/test/route-share-card.test.mjs
index b501112f..7e4f264a 100644
--- a/archify/test/route-share-card.test.mjs
+++ b/archify/test/route-share-card.test.mjs
@@ -111,8 +111,8 @@ test('Route variant decorates only a finite canonical clone with dedicated stati
test('clone-only Route styling retains context and distinguishes start, middle, and end without motion', () => {
const html = render('dataflow', CASES.dataflow);
- assert.match(html, /svg\[data-share-route\] \[data-node-id\], svg\[data-share-route\] \[data-edge-from\] \{ opacity: 0\.18; \}/);
- assert.match(html, /svg\[data-share-route\] \[data-share-route-match\] \{ opacity: 1; \}/);
+ assert.match(html, /svg\[data-share-route\] \[data-node-id\], svg\[data-share-route\] \[data-edge-from\], svg\[data-share-route\] \[data-graph-role=\\?"automatic-crossover-underlay\\?"\] \{ opacity: 0\.18; \}/);
+ assert.match(html, /svg\[data-share-route\] \[data-share-route-match\], svg\[data-share-route\] \[data-graph-role=\\?"automatic-crossover\\?"\]:has\(> \[data-share-route-match\]\) > \[data-graph-role=\\?"automatic-crossover-underlay\\?"\] \{ opacity: 1; \}/);
assert.match(html, /data-share-route-start[\s\S]*?stroke-dasharray: 5 3/);
assert.match(html, /data-share-route-middle[\s\S]*?stroke-width: 2\.2/);
assert.match(html, /data-share-route-end[\s\S]*?stroke-width: 3\.4/);
diff --git a/scripts/run-browser-tests.mjs b/scripts/run-browser-tests.mjs
index b9f84e36..ebf5c3a7 100644
--- a/scripts/run-browser-tests.mjs
+++ b/scripts/run-browser-tests.mjs
@@ -25,6 +25,7 @@ const testFiles = [
'route-probe-browser.test.mjs',
'guided-views-browser.test.mjs',
'focus-browser.test.mjs',
+ 'crossover-state-browser.test.mjs',
'semantic-passport-move-browser.test.mjs',
'export-browser.test.mjs',
'viewer-identifiers-browser.test.mjs',
diff --git a/viewer/export.js b/viewer/export.js
index 8c332eb9..d541beb1 100644
--- a/viewer/export.js
+++ b/viewer/export.js
@@ -364,15 +364,15 @@
}
if (opts.routeSnapshot) {
- style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" +
- "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" +
+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from], svg[data-share-route] [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 0.18; }\n" +
+ "svg[data-share-route] [data-share-route-match], svg[data-share-route] [data-graph-role=\"automatic-crossover\"]:has(> [data-share-route-match]) > [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 1; }\n" +
"svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" +
"svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" +
"svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";
}
if (opts.reachSnapshot) {
- style.textContent += "\nsvg[data-share-reach] [data-node-id], svg[data-share-reach] [data-edge-from] { opacity: 0.14; }\n" +
- "svg[data-share-reach] [data-share-reach-match] { opacity: 1; }\n" +
+ style.textContent += "\nsvg[data-share-reach] [data-node-id], svg[data-share-reach] [data-edge-from], svg[data-share-reach] [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 0.14; }\n" +
+ "svg[data-share-reach] [data-share-reach-match], svg[data-share-reach] [data-graph-role=\"automatic-crossover\"]:has(> [data-share-reach-match]) > [data-graph-role=\"automatic-crossover-underlay\"] { opacity: 1; }\n" +
"svg[data-share-reach] [data-edge-from][data-share-reach-match] { stroke-width: 1.55; }\n" +
"svg[data-share-reach=\"upstream\"] [data-share-reach-origin] > :is(rect, circle, polygon):not(.c-mask) { stroke: var(--database-stroke); stroke-width: 3.4; stroke-dasharray: 5 3; }\n" +
"svg[data-share-reach=\"downstream\"] [data-share-reach-origin] > :is(rect, circle, polygon):not(.c-mask) { stroke: var(--backend-stroke); stroke-width: 3.4; stroke-dasharray: 1 0; }\n" +
@@ -1274,4 +1274,4 @@
}
}
} catch (_) {}
- })();
\ No newline at end of file
+ })();
diff --git a/viewer/viewer.css b/viewer/viewer.css
index 5613bc52..c88a1713 100644
--- a/viewer/viewer.css
+++ b/viewer/viewer.css
@@ -774,6 +774,9 @@ html[data-motion-capable="true"][data-preset="signal-flow"][data-ambient-motion=
html:not([data-motion-capable="true"]) svg[data-animation="trace"] [data-animate] {
animation: none !important;
}
+html:not([data-motion-capable="true"]) svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+}
html[data-motion="still"] .pulse-dot,
html[data-motion="still"] .diagram-container::before,
html[data-motion="still"] svg[data-animation="trace"] [data-animate],
@@ -786,7 +789,12 @@ html[data-share-playback="true"] .pulse-dot,
html[data-share-playback="true"] .diagram-container::before,
html[data-document-hidden="true"] .pulse-dot,
html[data-document-hidden="true"] .diagram-container::before,
-html[data-document-hidden="true"] svg[data-animation="trace"] [data-animate] {
+html[data-document-hidden="true"] svg[data-animation="trace"] [data-animate],
+html[data-motion="still"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+html[data-motion-owner] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+html[data-embed="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+html[data-share-playback="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+html[data-document-hidden="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
animation: none !important;
}
html[data-motion="still"] .diagram-container::before,
@@ -3018,12 +3026,16 @@ html[data-preset="editorial"] .card-dot { border-radius: 0; transform: rotate(45
.story-carrier-overlay { display: none !important; }
.diagram-container svg[data-focus-active] [data-node-id],
.diagram-container svg[data-focus-active] [data-edge-from],
+ .diagram-container svg[data-focus-active] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-reach-active] [data-node-id],
.diagram-container svg[data-reach-active] [data-edge-from],
+ .diagram-container svg[data-reach-active] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-story-beat] [data-story-step],
.diagram-container svg[data-story-beat] [data-edge-from][data-story-beat-step],
+ .diagram-container svg[data-story-beat] [data-graph-role="automatic-crossover-underlay"],
.diagram-container svg[data-route-active] [data-node-id],
- .diagram-container svg[data-route-active] [data-edge-from] {
+ .diagram-container svg[data-route-active] [data-edge-from],
+ .diagram-container svg[data-route-active] [data-graph-role="automatic-crossover-underlay"] {
opacity: 1 !important;
filter: none !important;
animation: none !important;
@@ -4063,7 +4075,8 @@ svg [data-node-id] {
cursor: pointer;
transition: opacity 0.18s ease, filter 0.18s ease;
}
-svg [data-edge-from] { transition: opacity 0.18s ease, filter 0.18s ease; }
+svg [data-edge-from],
+svg [data-graph-role="automatic-crossover-underlay"] { transition: opacity 0.18s ease, filter 0.18s ease; }
svg [data-node-id]:hover,
svg [data-node-id]:focus-visible {
filter: drop-shadow(0 0 7px var(--frontend-stroke));
@@ -4212,10 +4225,22 @@ svg[data-preset="blueprint"] .semantic-lens-flow {
opacity: 0.78;
}
html[data-embed="true"] .semantic-lens-overlay { display: none; }
+/* Automatic crossover masks are visual companions of their one semantic
+ edge. Keep the mask free of data-edge-* identity so graph traversal and
+ export still observe exactly one edge, then mirror reader emphasis from
+ the paired foreground path in this presentation-only wrapper. */
+svg[data-legend-preview-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"],
+svg[data-lens-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.11; }
+svg[data-legend-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-legend-preview-match]) > [data-graph-role="automatic-crossover-underlay"],
+svg[data-lens-active] [data-graph-role="automatic-crossover"]:has(> [data-lens-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
+svg[data-legend-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-legend-preview-peer]) > [data-graph-role="automatic-crossover-underlay"],
+svg[data-lens-active] [data-graph-role="automatic-crossover"]:has(> [data-lens-peer]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.62; }
svg[data-focus-active] [data-node-id],
svg[data-focus-active] [data-edge-from] { opacity: 0.13; }
+svg[data-focus-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.13; }
svg[data-focus-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-focus-active] [data-focus-match] { opacity: 1; }
+svg[data-focus-active] [data-graph-role="automatic-crossover"]:has(> [data-focus-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-focus-active] [data-focus-selected] {
filter: drop-shadow(0 0 10px var(--frontend-stroke));
}
@@ -4226,7 +4251,9 @@ svg[data-focus-active] [data-focus-selected] {
changes only viewer emphasis, not canonical geometry or export bytes. */
svg[data-reach-active] [data-node-id],
svg[data-reach-active] [data-edge-from] { opacity: 0.09; }
+svg[data-reach-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.09; }
svg[data-reach-active] [data-reach-match] { opacity: 1; }
+svg[data-reach-active] [data-graph-role="automatic-crossover"]:has(> [data-reach-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-reach-active="upstream"] [data-reach-origin] {
filter: drop-shadow(0 0 11px var(--database-stroke));
}
@@ -4280,8 +4307,10 @@ svg[data-preset="blueprint"] .relationship-hit-target:focus-visible .relationshi
}
svg[data-relationship-direct-active] [data-node-id],
svg[data-relationship-direct-active] [data-edge-from] { opacity: 0.16; }
+svg[data-relationship-direct-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.16; }
svg[data-relationship-direct-active] [data-relationship-preview],
svg[data-relationship-direct-active] [data-relationship-preview-node] { opacity: 1; }
+svg[data-relationship-direct-active] [data-graph-role="automatic-crossover"]:has(> [data-relationship-preview]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-focus-active]:not([data-relationship-pin-active]) .relationship-hit-rail,
svg[data-story-active] .relationship-hit-rail,
svg[data-route-picking] .relationship-hit-rail,
@@ -4297,9 +4326,11 @@ html[data-embed="true"] .relationship-hit-overlay { display: none; }
neighborhood focus. It changes emphasis only; exported geometry and the
relationship's original solid/dashed visual language stay untouched. */
svg[data-relationship-preview-active] [data-focus-match] { opacity: 0.18; }
+svg[data-relationship-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-focus-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.18; }
svg[data-relationship-preview-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-relationship-preview-active] [data-relationship-preview],
svg[data-relationship-preview-active] [data-relationship-preview-node] { opacity: 1; }
+svg[data-relationship-preview-active] [data-graph-role="automatic-crossover"]:has(> [data-relationship-preview]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-relationship-preview-active] [data-relationship-preview] {
filter: drop-shadow(0 0 5px var(--arrow-emphasis));
}
@@ -4395,8 +4426,10 @@ html[data-embed="true"] .relationship-pulse-overlay { display: none; }
cloned edge geometry; the authored edge remains untouched underneath. */
svg[data-intent-trace-active] [data-node-id],
svg[data-intent-trace-active] [data-edge-from] { opacity: 0.2; }
+svg[data-intent-trace-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.2; }
svg[data-intent-trace-active] [data-lifecycle-rail] { opacity: 0; }
svg[data-intent-trace-active] [data-intent-trace-match] { opacity: 1; }
+svg[data-intent-trace-active] [data-graph-role="automatic-crossover"]:has(> [data-intent-trace-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-intent-trace-active] [data-intent-trace-selected] {
filter: drop-shadow(0 0 10px var(--frontend-stroke));
}
@@ -4459,7 +4492,9 @@ svg[data-route-picking] [data-route-start] {
}
svg[data-route-active] [data-node-id],
svg[data-route-active] [data-edge-from] { opacity: 0.11; }
+svg[data-route-active] [data-graph-role="automatic-crossover"] > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.11; }
svg[data-route-active] [data-route-match] { opacity: 1; }
+svg[data-route-active] [data-graph-role="automatic-crossover"]:has(> [data-route-match]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-route-active] [data-route-start] {
filter: drop-shadow(0 0 11px var(--frontend-stroke));
}
@@ -4472,6 +4507,9 @@ svg[data-route-active] [data-route-step]:not([data-route-start]):not([data-route
svg[data-route-journey] [data-route-match][data-route-journey-state="past"] { opacity: 0.62; }
svg[data-route-journey] [data-route-match][data-route-journey-state="future"] { opacity: 0.34; }
svg[data-route-journey] [data-route-match][data-route-journey-state="current"] { opacity: 1; }
+svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="past"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.62; }
+svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="future"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.34; }
+svg[data-route-journey] [data-graph-role="automatic-crossover"]:has(> [data-route-match][data-route-journey-state="current"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-route-journey] [data-node-id][data-route-journey-current] {
filter: drop-shadow(0 0 10px var(--backend-stroke));
}
@@ -4599,9 +4637,16 @@ svg[data-story-beat] [data-edge-from][data-story-beat-step] {
opacity: 0.16;
transition: opacity 160ms ease;
}
+svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step]) > [data-graph-role="automatic-crossover-underlay"] {
+ opacity: 0.16;
+ transition: opacity 160ms ease;
+}
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="past"] { opacity: 0.58; }
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="next"] { opacity: 0.34; }
svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state="active"] { opacity: 1; }
+svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="past"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.58; }
+svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="next"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 0.34; }
+svg[data-story-beat] [data-graph-role="automatic-crossover"]:has(> [data-edge-from][data-story-beat-step][data-story-beat-state="active"]) > [data-graph-role="automatic-crossover-underlay"] { opacity: 1; }
svg[data-story-beat] .story-trail-flow { opacity: 0; transition: opacity 160ms ease; }
svg[data-story-beat] .story-trail-flow[data-story-beat-state="past"] { opacity: 0.34; }
svg[data-story-beat] .story-trail-flow[data-story-beat-state="next"] { opacity: 0.2; }
@@ -4630,7 +4675,8 @@ svg[data-preset="editorial"][data-story-beat] [data-story-step][data-story-beat-
chapter focus sets. Symbols in the rail carry the meaning without color;
these SVG rules only make exact stable-ID membership easier to scan. */
svg[data-chapter-preview] [data-node-id],
-svg[data-chapter-preview] [data-edge-from] {
+svg[data-chapter-preview] [data-edge-from],
+svg[data-chapter-preview] [data-graph-role="automatic-crossover-underlay"] {
opacity: 0.1 !important;
filter: none !important;
transition: none !important;
@@ -4663,6 +4709,10 @@ html[data-ambient-motion="running"] svg[data-animation="trace"] [data-animate="e
animation: archify-edge-flow 2.4s linear 1;
animation-delay: calc(var(--step, 0) * 160ms);
}
+html[data-ambient-motion="running"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: archify-edge-flow 2.4s linear 1;
+ animation-delay: calc(var(--step, 0) * 160ms);
+}
html[data-ambient-motion="running"] svg[data-animation="trace"] [data-animate="node"] {
transform-box: fill-box;
transform-origin: center;
@@ -4674,6 +4724,7 @@ svg[data-preset="signal-flow"][data-animation="trace"] [data-animate="edge"] {
filter: drop-shadow(0 0 3px var(--arrow-emphasis));
animation-duration: 1.75s;
}
+svg[data-preset="signal-flow"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 1.75s; }
svg[data-preset="signal-flow"][data-animation="trace"] [data-animate="node"] {
animation-duration: 3.1s;
}
@@ -4682,6 +4733,7 @@ svg[data-preset="blueprint"][data-animation="trace"] [data-animate="edge"] {
filter: none;
animation-duration: 2.15s;
}
+svg[data-preset="blueprint"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 2.15s; }
svg[data-preset="blueprint"][data-animation="trace"] [data-animate="node"] {
animation-name: archify-blueprint-node-pulse;
animation-duration: 3.8s;
@@ -4690,6 +4742,7 @@ svg[data-preset="editorial"][data-animation="trace"] [data-animate="edge"] {
filter: none;
animation-duration: 2.2s;
}
+svg[data-preset="editorial"][data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] { animation-duration: 2.2s; }
svg[data-preset="editorial"][data-animation="trace"] [data-animate="node"] {
animation-name: archify-editorial-node-pulse;
animation-duration: 3.5s;
@@ -4702,6 +4755,11 @@ html[data-share-playback="true"] svg[data-animation="trace"] [data-animate] {
animation: none !important;
stroke-dashoffset: 0;
}
+html[data-embed="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"],
+html[data-share-playback="true"] svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+ stroke-dashoffset: 0;
+}
@keyframes archify-edge-flow {
0% { stroke-dasharray: 10 8; stroke-dashoffset: 54; opacity: 0.42; }
88% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }
@@ -4791,6 +4849,10 @@ html[data-share-playback="true"] svg[data-animation="trace"] [data-animate] {
animation: none !important;
stroke-dashoffset: 0;
}
+ svg[data-animation="trace"] [data-graph-role="automatic-crossover"]:has(> [data-animate="edge"]) > [data-graph-role="automatic-crossover-underlay"] {
+ animation: none !important;
+ stroke-dashoffset: 0;
+ }
.guided-view-progress span {
animation: none !important;
transform: scaleX(1) !important;
@@ -4809,7 +4871,8 @@ html[data-share-playback="true"] svg[data-animation="trace"] [data-animate] {
.share-chapter-progress span { animation: none !important; }
.guided-view-chapter,
svg[data-chapter-preview] [data-node-id],
- svg[data-chapter-preview] [data-edge-from] { transition: none !important; }
+ svg[data-chapter-preview] [data-edge-from],
+ svg[data-chapter-preview] [data-graph-role="automatic-crossover-underlay"] { transition: none !important; }
svg[data-story-playing="true"] .story-trail-flow {
stroke-dasharray: none;
stroke-dashoffset: 0;