Skip to content

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

fix(viewer): keep navigation dock clear of diagram stage (#113)

Friend A7fe139ebe2e5
diff --git a/archify.zip b/archify.zip
index b4f1c653..b6dcc9c8 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/assets/template.html b/archify/assets/template.html
index 37e83d0f..8e15e85c 100644
--- a/archify/assets/template.html
+++ b/archify/assets/template.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5845,6 +5852,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6019,6 +6027,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -10982,9 +10991,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -10995,10 +11004,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11015,26 +11027,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11048,15 +11110,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11065,50 +11135,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11116,6 +11229,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11137,8 +11254,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11157,7 +11274,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11178,6 +11295,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11197,6 +11315,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11282,9 +11401,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11406,9 +11559,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/bin/visual-check.mjs b/archify/bin/visual-check.mjs
index 5c9183f2..1a483a90 100644
--- a/archify/bin/visual-check.mjs
+++ b/archify/bin/visual-check.mjs
@@ -381,7 +381,11 @@ export class ChromeVisualBrowser {
const metrics = await evaluate(this.cdp, sessionId, `(function () {
var reader = document.querySelector('.container');
var diagram = document.querySelector('.diagram-container');
- var svg = diagram && diagram.querySelector(':scope > svg');
+ var svg = diagram && (
+ diagram.querySelector(':scope > svg') ||
+ diagram.querySelector(':scope > .diagram-stage > svg')
+ );
+ var stage = diagram && (diagram.querySelector(':scope > .diagram-stage') || svg);
var legend = svg && svg.querySelector('[data-legend]');
var navigationDock = diagram && diagram.querySelector('.diagram-nav');
var viewBox = svg && svg.viewBox && svg.viewBox.baseVal;
@@ -415,7 +419,12 @@ export class ChromeVisualBrowser {
return width * height;
}
var legendRect = legend ? legend.getBoundingClientRect() : null;
+ var stageRect = window.Archify && Archify.viewerChromeLayout
+ && typeof Archify.viewerChromeLayout.stageRect === 'function'
+ ? Archify.viewerChromeLayout.stageRect()
+ : (stage ? stage.getBoundingClientRect() : null);
var navigationDockRect = navigationDock ? navigationDock.getBoundingClientRect() : null;
+ var stageDockIntersectionArea = intersectionArea(stageRect, navigationDockRect);
var viewerChromeReceipt = window.Archify && Archify.viewerChromeLayout
&& typeof Archify.viewerChromeLayout.receipt === 'function'
? Archify.viewerChromeLayout.receipt()
@@ -434,7 +443,12 @@ export class ChromeVisualBrowser {
minimumProjectedNodeTextDetail: minimum ? minimum.detail : null,
hasLegend: Boolean(legendRect && legendRect.width && legendRect.height),
hasNavigationDock: Boolean(navigationDockRect && navigationDockRect.width && navigationDockRect.height),
- legendDockIntersectionArea: intersectionArea(legendRect, navigationDockRect),
+ legendDockIntersectionArea: stageDockIntersectionArea > 0
+ ? intersectionArea(legendRect, navigationDockRect)
+ : 0,
+ dockStageIntersectionArea: stageDockIntersectionArea,
+ dockStageGap: stageRect && navigationDockRect ? navigationDockRect.top - stageRect.bottom : null,
+ viewerChromeRequiredGap: viewerChromeReceipt ? viewerChromeReceipt.gap : null,
viewerChromeReserve: viewerChromeReceipt ? viewerChromeReceipt.reserve : 0,
viewerChromeActive: viewerChromeReceipt ? viewerChromeReceipt.active : false
};
@@ -491,7 +505,18 @@ function observation({ width, height, theme, metrics }) {
const readabilityOk = minimumProjectedNodeTextPx == null
|| minimumProjectedNodeTextPx >= MIN_PROJECTED_NODE_TEXT_PX;
const legendDockIntersectionArea = Number(metrics.legendDockIntersectionArea) || 0;
- const viewerChromeOk = legendDockIntersectionArea <= 0.5;
+ const dockStageIntersectionArea = Number(metrics.dockStageIntersectionArea) || 0;
+ const dockStageGap = metrics.dockStageGap == null ? null : Number(metrics.dockStageGap);
+ const receiptDockStageGap = metrics.viewerChromeRequiredGap == null
+ ? null
+ : Number(metrics.viewerChromeRequiredGap);
+ const requiredDockStageGap = Number.isFinite(receiptDockStageGap) ? receiptDockStageGap : 0;
+ const viewerChromeStageOk = !metrics.hasNavigationDock || (
+ Number.isFinite(dockStageGap)
+ && dockStageIntersectionArea <= 0.5
+ && dockStageGap >= requiredDockStageGap - 1
+ );
+ const viewerChromeOk = legendDockIntersectionArea <= 0.5 && viewerChromeStageOk;
return {
width,
height,
@@ -514,6 +539,10 @@ function observation({ width, height, theme, metrics }) {
hasLegend: Boolean(metrics.hasLegend),
hasNavigationDock: Boolean(metrics.hasNavigationDock),
legendDockIntersectionArea,
+ dockStageIntersectionArea,
+ dockStageGap,
+ requiredDockStageGap,
+ viewerChromeStageOk,
viewerChromeReserve: Number(metrics.viewerChromeReserve) || 0,
viewerChromeActive: Boolean(metrics.viewerChromeActive),
viewerChromeOk,
@@ -546,6 +575,88 @@ function contactSheetHtml({ artifactPath, receipt, screenshots }) {
`;
}
+function viewportSubject(artifact, entry) {
+ return {
+ artifact,
+ viewport: { width: entry.width, height: entry.height, theme: entry.theme },
+ };
+}
+
+function failureDiagnostic({ code, message, subject, evidence, supportedFixes, severity = 'error' }) {
+ return { code, severity, message, subject, evidence, supportedFixes };
+}
+
+function observationDiagnostics({ artifact, allObservations, readabilityObservations }) {
+ const diagnostics = [];
+ for (const entry of allObservations) {
+ if (!entry.ok) {
+ diagnostics.push(failureDiagnostic({
+ code: 'viewer/viewport-overflow',
+ message: `The rendered artifact overflows the ${entry.width}x${entry.height} ${entry.theme} viewport.`,
+ subject: viewportSubject(artifact, entry),
+ evidence: {
+ innerWidth: entry.innerWidth,
+ innerHeight: entry.innerHeight,
+ scrollWidth: entry.scrollWidth,
+ scrollHeight: entry.scrollHeight,
+ overflowX: entry.overflowX,
+ overflowY: entry.overflowY,
+ },
+ supportedFixes: [
+ `contain the rendered layout within ${entry.width}x${entry.height}, then rerun visual-check`,
+ ],
+ }));
+ }
+ if (entry.legendDockIntersectionArea > 0.5) {
+ diagnostics.push(failureDiagnostic({
+ code: 'viewer/chrome-legend-clearance',
+ message: `The navigation Dock obscures the SVG Legend at ${entry.width}x${entry.height} (${entry.theme}).`,
+ subject: viewportSubject(artifact, entry),
+ evidence: { legendDockIntersectionArea: entry.legendDockIntersectionArea },
+ supportedFixes: [
+ 'move the SVG Legend or Viewer Dock until legendDockIntersectionArea is 0, then rerun visual-check',
+ ],
+ }));
+ }
+ if (!entry.viewerChromeStageOk) {
+ const stageOverlapsDock = entry.dockStageIntersectionArea > 0.5;
+ diagnostics.push(failureDiagnostic({
+ code: 'viewer/chrome-stage-clearance',
+ message: stageOverlapsDock
+ ? `Navigation Dock enters the protected SVG stage at ${entry.width}x${entry.height} (${entry.theme}).`
+ : `Navigation Dock clearance from the protected SVG stage is below the required gap at ${entry.width}x${entry.height} (${entry.theme}).`,
+ subject: viewportSubject(artifact, entry),
+ evidence: {
+ dockStageIntersectionArea: entry.dockStageIntersectionArea,
+ dockStageGap: entry.dockStageGap,
+ requiredDockStageGap: entry.requiredDockStageGap,
+ },
+ supportedFixes: [
+ `adjust Viewer stage reservation or clipping until dockStageGap is at least ${entry.requiredDockStageGap} and dockStageIntersectionArea is 0, then rerun visual-check`,
+ ],
+ }));
+ }
+ }
+ for (const entry of readabilityObservations) {
+ if (entry.readabilityOk) continue;
+ diagnostics.push(failureDiagnostic({
+ code: 'viewer/projected-text-readability',
+ message: `Projected ${entry.minimumProjectedNodeTextDetail || 'node'} text is below the readability floor at ${entry.width}x${entry.height}.`,
+ subject: viewportSubject(artifact, entry),
+ evidence: {
+ text: entry.minimumProjectedNodeText,
+ detail: entry.minimumProjectedNodeTextDetail,
+ minimumProjectedNodeTextPx: entry.minimumProjectedNodeTextPx,
+ minimumRequiredNodeTextPx: entry.minimumRequiredNodeTextPx,
+ },
+ supportedFixes: [
+ `increase projected node text to at least ${entry.minimumRequiredNodeTextPx}px at ${entry.width}x${entry.height}, then rerun visual-check`,
+ ],
+ }));
+ }
+ return diagnostics;
+}
+
function baseReceipt({ artifactPath, artifact, outputs, chrome }) {
return {
schemaVersion: 1,
@@ -560,6 +671,7 @@ function baseReceipt({ artifactPath, artifact, outputs, chrome }) {
},
state: { detail: 'read', motion: 'still' },
chrome,
+ diagnostics: [],
containment: { status: 'fail', viewports: [] },
readability: { status: 'fail', minimumProjectedNodeTextPx: MIN_PROJECTED_NODE_TEXT_PX, viewports: [] },
viewerChrome: { status: 'fail', viewports: [] },
@@ -606,6 +718,14 @@ export async function runVisualCheck({
receipt.viewerChrome.status = 'skipped';
receipt.captures.status = 'skipped';
receipt.error = 'Chrome or Chromium is unavailable. Set ARCHIFY_CHROME to its executable path.';
+ receipt.diagnostics = [failureDiagnostic({
+ code: 'viewer/chrome-unavailable',
+ severity: 'warning',
+ message: receipt.error,
+ subject: { artifact },
+ evidence: { executable: null },
+ supportedFixes: ['set ARCHIFY_CHROME to a Chrome or Chromium executable and rerun visual-check'],
+ })];
persistReceipt(outputs, receipt);
return { exitCode: EXIT.skipped, receipt };
}
@@ -660,6 +780,11 @@ export async function runVisualCheck({
const containmentPass = allObservations.every((entry) => entry.ok);
const readabilityPass = receipt.readability.viewports.every((entry) => entry.readabilityOk);
const viewerChromePass = allObservations.every((entry) => entry.viewerChromeOk);
+ receipt.diagnostics = observationDiagnostics({
+ artifact,
+ allObservations,
+ readabilityObservations: receipt.readability.viewports,
+ });
receipt.containment.status = containmentPass ? 'pass' : 'fail';
receipt.readability.status = readabilityPass ? 'pass' : 'fail';
receipt.viewerChrome.status = viewerChromePass ? 'pass' : 'fail';
@@ -685,6 +810,13 @@ export async function runVisualCheck({
receipt.captures.status = 'fail';
receipt.captures.screenshots = [];
receipt.captures.contactSheet = null;
+ receipt.diagnostics = [failureDiagnostic({
+ code: 'viewer/visual-check-runtime',
+ message: 'visual-check could not complete its Chrome inspection.',
+ subject: { artifact },
+ evidence: { reason: error.message },
+ supportedFixes: ['resolve the reported Chrome inspection error, then rerun visual-check'],
+ })];
persistReceipt(outputs, receipt);
return { exitCode: EXIT.fail, receipt };
} finally {
diff --git a/archify/examples/dataflow-product-analytics.html b/archify/examples/dataflow-product-analytics.html
index 5c5aa1a3..4a3c6288 100644
--- a/archify/examples/dataflow-product-analytics.html
+++ b/archify/examples/dataflow-product-analytics.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5956,6 +5963,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6130,6 +6138,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11093,9 +11102,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11106,10 +11115,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11126,26 +11138,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11159,15 +11221,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11176,50 +11246,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11227,6 +11340,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11248,8 +11365,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11268,7 +11385,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11289,6 +11406,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11308,6 +11426,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11393,9 +11512,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11517,9 +11670,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/examples/lifecycle-agent-run.html b/archify/examples/lifecycle-agent-run.html
index b0e9d5c0..ea79fa9b 100644
--- a/archify/examples/lifecycle-agent-run.html
+++ b/archify/examples/lifecycle-agent-run.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5905,6 +5912,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6079,6 +6087,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11042,9 +11051,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11055,10 +11064,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11075,26 +11087,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11108,15 +11170,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11125,50 +11195,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11176,6 +11289,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11197,8 +11314,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11217,7 +11334,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11238,6 +11355,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11257,6 +11375,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11342,9 +11461,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11466,9 +11619,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/examples/sequence-cache-miss-request.html b/archify/examples/sequence-cache-miss-request.html
index 09a5f30b..aaa74306 100644
--- a/archify/examples/sequence-cache-miss-request.html
+++ b/archify/examples/sequence-cache-miss-request.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5971,6 +5978,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6145,6 +6153,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11108,9 +11117,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11121,10 +11130,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11141,26 +11153,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11174,15 +11236,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11191,50 +11261,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11242,6 +11355,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11263,8 +11380,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11283,7 +11400,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11304,6 +11421,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11323,6 +11441,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11408,9 +11527,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11532,9 +11685,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/examples/web-app-rendered.html b/archify/examples/web-app-rendered.html
index 924ac0ca..cef9fccf 100644
--- a/archify/examples/web-app-rendered.html
+++ b/archify/examples/web-app-rendered.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5920,6 +5927,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6094,6 +6102,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11057,9 +11066,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11070,10 +11079,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11090,26 +11102,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11123,15 +11185,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11140,50 +11210,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11191,6 +11304,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11212,8 +11329,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11232,7 +11349,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11253,6 +11370,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11272,6 +11390,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11357,9 +11476,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11481,9 +11634,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/examples/workflow-agent-tool-call-rendered.html b/archify/examples/workflow-agent-tool-call-rendered.html
index 4baecadc..b5ea59d3 100644
--- a/archify/examples/workflow-agent-tool-call-rendered.html
+++ b/archify/examples/workflow-agent-tool-call-rendered.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5953,6 +5960,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6127,6 +6135,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11090,9 +11099,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11103,10 +11112,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11123,26 +11135,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11156,15 +11218,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11173,50 +11243,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11224,6 +11337,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11245,8 +11362,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11265,7 +11382,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11286,6 +11403,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11305,6 +11423,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11390,9 +11509,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11514,9 +11667,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/archify/test/adaptive-reader-layout.test.mjs b/archify/test/adaptive-reader-layout.test.mjs
index e9be6359..6a8fa7a1 100644
--- a/archify/test/adaptive-reader-layout.test.mjs
+++ b/archify/test/adaptive-reader-layout.test.mjs
@@ -39,6 +39,7 @@ test('desktop readability budget matches the minimum adaptive reader at 1440 by
assert.equal(DESKTOP_READER_HORIZONTAL_CHROME, 30);
assert.equal(DESKTOP_READER_DIAGRAM_WIDTH, 930);
assert.match(reader, new RegExp(`var MIN_READER_WIDTH = ${DESKTOP_READER_MIN_WIDTH}`));
+ assert.match(template, /html\[data-nav-stage-rail="true"\] body \{ padding-block: 0\.375rem; \}/);
assert.match(template, /@media \(min-width: 768px\) and \(max-height: 1100px\)[\s\S]*?\.diagram-container \{[\s\S]*?padding: 0\.875rem;[\s\S]*?padding-bottom: calc\(0\.875rem \+ var\(--archify-nav-reserve\)\);/);
assert.match(template, /@media \(min-width: 768px\) and \(max-height: 920px\)[\s\S]*?body \{ padding-block: 1\.25rem; \}/);
assert.match(template, /\.diagram-container \{[\s\S]*?border: 1px solid var\(--panel-border\)/);
diff --git a/archify/test/viewer-chrome-layout.test.mjs b/archify/test/viewer-chrome-layout.test.mjs
index 3ee20dc5..6b9725ff 100644
--- a/archify/test/viewer-chrome-layout.test.mjs
+++ b/archify/test/viewer-chrome-layout.test.mjs
@@ -7,6 +7,7 @@ import path from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { ChromeVisualBrowser, findChrome } from '../bin/visual-check.mjs';
+import { MIN_PROJECTED_NODE_TEXT_PX } from '../renderers/shared/desktop-readability.mjs';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const skillRoot = path.resolve(__dirname, '..');
@@ -33,6 +34,25 @@ function render(mode, example) {
return output;
}
+function renderWithoutLegend() {
+ const source = JSON.parse(fs.readFileSync(
+ path.join(skillRoot, 'examples', CASES.architecture),
+ 'utf8',
+ ));
+ source.meta = { ...source.meta, legend: { mode: 'hidden' } };
+ const input = path.join(tmp, 'architecture-no-legend.json');
+ const output = path.join(tmp, 'architecture-no-legend.html');
+ fs.writeFileSync(input, `${JSON.stringify(source, null, 2)}\n`);
+ execFileSync(process.execPath, [
+ path.join(skillRoot, 'bin', 'archify.mjs'),
+ 'render',
+ 'architecture',
+ input,
+ output,
+ ]);
+ return output;
+}
+
function canonicalSvg(html) {
return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
}
@@ -118,16 +138,51 @@ async function finalGeometry(browser, sessionId) {
var lens = document.getElementById('semantic-lens');
var radar = document.getElementById('overview-map');
var passport = document.getElementById('focus-chip');
+ var chromeReceipt = window.Archify && Archify.viewerChromeLayout
+ && typeof Archify.viewerChromeLayout.receipt === 'function'
+ ? Archify.viewerChromeLayout.receipt()
+ : null;
+ var viewBox = svg && svg.viewBox && svg.viewBox.baseVal;
+ var projectedScale = svg && viewBox && viewBox.width > 0
+ ? Math.min(1, svg.getBoundingClientRect().width / viewBox.width)
+ : 0;
+ var minimumProjectedNodeTextPx = null;
+ if (svg && projectedScale > 0) {
+ Array.from(svg.querySelectorAll('text[data-node-label], text[data-boundary-label], text[data-detail="context"]')).forEach(function (text) {
+ if (text.hasAttribute('data-detail') && !text.closest('[data-node-id]')) return;
+ var sourceFontPx = parseFloat(text.getAttribute('font-size') || '');
+ if (!Number.isFinite(sourceFontPx)) return;
+ var projectedFontPx = sourceFontPx * projectedScale;
+ if (minimumProjectedNodeTextPx == null || projectedFontPx < minimumProjectedNodeTextPx) {
+ minimumProjectedNodeTextPx = projectedFontPx;
+ }
+ });
+ }
var legendRect = legend && getComputedStyle(legend).display !== 'none' ? legend.getBoundingClientRect() : null;
var navRect = nav && getComputedStyle(nav).display !== 'none' ? nav.getBoundingClientRect() : null;
- var svgRect = svg ? svg.getBoundingClientRect() : null;
+ var stageRect = window.Archify && Archify.viewerChromeLayout
+ && typeof Archify.viewerChromeLayout.stageRect === 'function'
+ ? Archify.viewerChromeLayout.stageRect()
+ : null;
var lensRect = lens && !lens.hidden && getComputedStyle(lens).display !== 'none' ? lens.getBoundingClientRect() : null;
var radarRect = radar && !radar.hidden && getComputedStyle(radar).display !== 'none' ? radar.getBoundingClientRect() : null;
var passportRect = passport && !passport.hidden && getComputedStyle(passport).display !== 'none' ? passport.getBoundingClientRect() : null;
+ var stageDockIntersectionArea = area(stageRect, navRect);
+ var semanticDockIntersectionArea = stageDockIntersectionArea > 0 && navRect && svg
+ ? Array.from(svg.querySelectorAll('[data-node-id]')).reduce(function (maximum, node) {
+ return Math.max(maximum, area(node.getBoundingClientRect(), navRect));
+ }, 0)
+ : 0;
return {
reserve: parseFloat(getComputedStyle(container).getPropertyValue('--archify-nav-reserve')) || 0,
- stageGap: navRect && svgRect ? navRect.top - svgRect.bottom : null,
- legendDockIntersectionArea: area(legendRect, navRect),
+ receiptReserve: chromeReceipt ? chromeReceipt.reserve : null,
+ receiptEligible: chromeReceipt ? chromeReceipt.eligible : null,
+ receiptStageIntersectionArea: chromeReceipt ? chromeReceipt.stageIntersectionArea : null,
+ minimumProjectedNodeTextPx: minimumProjectedNodeTextPx,
+ stageGap: navRect && stageRect ? navRect.top - stageRect.bottom : null,
+ dockStageIntersectionArea: stageDockIntersectionArea,
+ legendDockIntersectionArea: stageDockIntersectionArea > 0 ? area(legendRect, navRect) : 0,
+ semanticDockIntersectionArea: semanticDockIntersectionArea,
legendLensIntersectionArea: area(legendRect, lensRect),
navLensIntersectionArea: area(navRect, lensRect),
legendRadarIntersectionArea: area(legendRect, radarRect),
@@ -139,11 +194,40 @@ async function finalGeometry(browser, sessionId) {
navRect: navRect ? { left: navRect.left, right: navRect.right, top: navRect.top, bottom: navRect.bottom } : null,
passportRect: passportRect ? { left: passportRect.left, right: passportRect.right, top: passportRect.top, bottom: passportRect.bottom } : null,
radarRect: radarRect ? { left: radarRect.left, right: radarRect.right, top: radarRect.top, bottom: radarRect.bottom } : null,
- hasLegend: Boolean(legendRect && legendRect.width && legendRect.height)
+ hasLegend: Boolean(legendRect && legendRect.width && legendRect.height),
+ scrollWidth: document.documentElement.scrollWidth,
+ scrollHeight: document.documentElement.scrollHeight,
+ innerWidth: window.innerWidth,
+ innerHeight: window.innerHeight,
+ containerBottom: container ? container.getBoundingClientRect().bottom : null,
+ containerHeight: container ? container.clientHeight : null,
+ receiptGap: chromeReceipt ? chromeReceipt.gap : null,
+ navBottom: navRect ? navRect.bottom : null
};
})()`);
}
+async function edgePaintHitsUnderDock(browser, sessionId, selector) {
+ return evaluate(browser, sessionId, `(function () {
+ var edge = document.querySelector(${JSON.stringify(selector)});
+ var nav = document.querySelector('.diagram-nav');
+ if (!edge || !nav || typeof edge.getTotalLength !== 'function') return null;
+ var navRect = nav.getBoundingClientRect();
+ var matrix = edge.getScreenCTM();
+ var length = edge.getTotalLength();
+ var hits = [];
+ for (var offset = 0; offset <= length; offset += 0.25) {
+ var point = edge.getPointAtLength(offset).matrixTransform(matrix);
+ if (point.x < navRect.left || point.x > navRect.right || point.y < navRect.top || point.y > navRect.bottom) continue;
+ if (document.elementsFromPoint(point.x, point.y).includes(edge)) {
+ hits.push({ x: point.x, y: point.y });
+ if (hits.length >= 5) break;
+ }
+ }
+ return hits;
+ })()`);
+}
+
async function load(browser, artifactPath, { width = 1440, height = 900, query = '' } = {}) {
const sessionId = await browser.sessionPromise;
await browser.cdp.send('Emulation.setDeviceMetricsOverride', {
@@ -164,11 +248,19 @@ async function load(browser, artifactPath, { width = 1440, height = 900, query =
}
test('the public CLI gives all typed renderers one final Viewer contract', () => {
+ const directChildSvg = /<div class="diagram-container"[^>]*>\s*<svg\b/;
+ assert.doesNotMatch(
+ '<div class="diagram-container"><section></section><svg>',
+ directChildSvg,
+ 'the direct-child assertion must not cross an intervening wrapper',
+ );
for (const [mode, example] of Object.entries(CASES)) {
const output = render(mode, example);
const html = fs.readFileSync(output, 'utf8');
assert.match(html, /class="[^"]*\bdiagram-nav\b[^"]*"/, mode);
assert.match(html, /data-legend/, mode);
+ assert.match(html, directChildSvg, `${mode} keeps the SVG as a direct child`);
+ assert.doesNotMatch(html, /class="diagram-stage"/, `${mode} does not re-nest the exported SVG`);
assert.doesNotMatch(canonicalSvg(html), /nav-safe-rail|archify-nav-reserve|viewerChromeLayout/, mode);
execFileSync(process.execPath, [path.join(skillRoot, 'bin', 'archify.mjs'), 'check', output]);
}
@@ -178,7 +270,60 @@ test('Viewer chrome remains outside the canonical SVG export boundary', () => {
const html = fs.readFileSync(render('architecture', CASES.architecture), 'utf8');
const svg = canonicalSvg(html);
assert.match(svg, /data-legend/);
- assert.doesNotMatch(svg, /diagram-nav|data-nav-safe-rail|viewerChromeLayout/);
+ assert.doesNotMatch(svg, /diagram-nav|data-nav-stage-rail|viewerChromeLayout/);
+});
+
+test('Dock Safe Rail keeps typed renderers clear across themes, Presentation, and low-height desktops', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ const matrix = Object.keys(CASES).flatMap((mode) => [
+ { mode, theme: 'light', width: 1440, height: 820, present: false },
+ { mode, theme: 'dark', width: 1440, height: 900, present: true },
+ ]);
+ try {
+ for (const entry of matrix) {
+ const query = `?theme=${entry.theme}${entry.present ? '&present=1' : ''}`;
+ const sessionId = await load(browser, render(entry.mode, CASES[entry.mode]), {
+ width: entry.width,
+ height: entry.height,
+ query,
+ });
+ const receipt = await finalGeometry(browser, sessionId);
+ const message = `${entry.mode}: ${JSON.stringify({ entry, receipt })}`;
+ assert.ok(receipt.reserve > 0, message);
+ assert.ok(receipt.stageGap >= 9, message);
+ assert.equal(receipt.dockStageIntersectionArea, 0, message);
+ assert.ok(receipt.scrollWidth <= receipt.innerWidth, message);
+ assert.ok(receipt.navBottom <= receipt.containerBottom + 0.5, message);
+ /* Normal artifacts intentionally keep supporting cards in document
+ flow on low-height pages. Presentation removes that document scroll
+ while every mode keeps the Viewer itself vertically contained. */
+ if (entry.present) {
+ assert.ok(receipt.scrollHeight <= receipt.innerHeight, message);
+ }
+ assert.ok(receipt.minimumProjectedNodeTextPx >= MIN_PROJECTED_NODE_TEXT_PX, message);
+ }
+ } finally {
+ await browser.close();
+ }
+});
+
+test('an artifact with no Legend still receives the desktop stage rail', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ try {
+ const sessionId = await load(browser, renderWithoutLegend());
+ const receipt = await finalGeometry(browser, sessionId);
+
+ assert.equal(receipt.hasLegend, false, JSON.stringify(receipt));
+ assert.ok(receipt.reserve > 0, JSON.stringify(receipt));
+ assert.ok(receipt.stageGap >= 9, JSON.stringify(receipt));
+ assert.ok(receipt.navBottom <= receipt.containerBottom + 0.5, JSON.stringify(receipt));
+ } finally {
+ await browser.close();
+ }
});
test('Dock Safe Rail resolves a forced Legend collision across the shared diagram viewer', {
@@ -206,7 +351,8 @@ test('Dock Safe Rail resolves a forced Legend collision across the shared diagra
if (setup.noLegend) {
const receipt = await finalGeometry(browser, sessionId);
- assert.equal(receipt.reserve, 0, mode);
+ assert.ok(receipt.reserve > 0, mode);
+ assert.ok(receipt.stageGap >= 9, mode);
continue;
}
await waitForLayout(browser, sessionId);
@@ -253,7 +399,7 @@ test('Maka remains collision-free at the reported Retina-equivalent viewport', {
}
});
-test('a real 5px Legend gap keeps the zero-reserve layout unchanged', {
+test('a real 5px Legend gap keeps the stage rail and Legend clear', {
skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
}, async () => {
const browser = new ChromeVisualBrowser(chromePath);
@@ -274,7 +420,8 @@ test('a real 5px Legend gap keeps the zero-reserve layout unchanged', {
const receipt = await finalGeometry(browser, sessionId);
assert.equal(receipt.legendDockIntersectionArea, 0, JSON.stringify(receipt));
- assert.equal(receipt.reserve, 0, JSON.stringify(receipt));
+ assert.ok(receipt.reserve > 0, JSON.stringify(receipt));
+ assert.ok(receipt.stageGap >= 9, JSON.stringify(receipt));
} finally {
await browser.close();
}
@@ -331,22 +478,243 @@ test('manual zoom and pan reschedules Legend and Dock collision measurement', {
const receipt = await finalGeometry(browser, sessionId);
assert.equal(receipt.legendDockIntersectionArea, 0, JSON.stringify(receipt));
+ assert.equal(receipt.semanticDockIntersectionArea, 0, JSON.stringify(receipt));
assert.ok(receipt.reserve > 0, JSON.stringify(receipt));
} finally {
await browser.close();
}
});
-test('localized multiline Legends remain clear across themes, presets, and zoom levels', {
+test('camera pan clips authored relationship paint at the protected stage boundary', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ try {
+ const sessionId = await load(browser, render('architecture', CASES.architecture));
+ await evaluate(browser, sessionId, `(function () {
+ var container = document.querySelector('.diagram-container');
+ var zoomIn = document.querySelector('[data-view="in"]');
+ for (var index = 0; index < 8; index += 1) zoomIn.click();
+ var svg = container.querySelector(':scope > svg');
+ var rect = svg.getBoundingClientRect();
+ var pointer = { bubbles: true, pointerId: 11, button: 0 };
+ var startX = rect.left + rect.width / 2;
+ var startY = rect.top + rect.height / 2;
+ container.dispatchEvent(new PointerEvent('pointerdown', Object.assign({ clientX: startX, clientY: startY }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointermove', Object.assign({ clientX: startX, clientY: startY + 500 }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointerup', Object.assign({ clientX: startX, clientY: startY + 500 }, pointer)));
+ })()`);
+ await waitForLayout(browser, sessionId);
+ const hits = await edgePaintHitsUnderDock(
+ browser,
+ sessionId,
+ 'path[data-edge-id="jwt-verification"][data-edge-from="auth"][data-edge-to="api"]',
+ );
+
+ assert.deepEqual(hits, [], JSON.stringify(hits));
+ } finally {
+ await browser.close();
+ }
+});
+
+test('live camera transitions keep authored relationship paint outside the Dock on every frame', {
skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
}, async () => {
const browser = new ChromeVisualBrowser(chromePath);
- const cases = [
- { preset: 'classic', theme: 'light', zoom: 1 },
- { preset: 'signal-flow', theme: 'dark', zoom: 1.25 },
- { preset: 'blueprint', theme: 'light', zoom: 2 },
- { preset: 'editorial', theme: 'dark', zoom: 2 },
+ const artifact = render('architecture', CASES.architecture);
+ const scenarios = [
+ { name: 'zoom-in', setupZoomClicks: 7, action: 'in', duration: 260, clearsClip: false },
+ { name: 'zoom-out', setupZoomClicks: 8, action: 'out', duration: 260, clearsClip: false },
+ { name: 'reset', setupZoomClicks: 8, action: 'reset', duration: 420, clearsClip: true },
+ { name: 'interrupted zoom', setupZoomClicks: 8, action: 'interrupt', duration: 420, clearsClip: false },
];
+ try {
+ for (const scenario of scenarios) {
+ const sessionId = await load(browser, artifact);
+ const result = await evaluate(browser, sessionId, `(function () {
+ var scenario = ${JSON.stringify(scenario)};
+ var container = document.querySelector('.diagram-container');
+ var svg = container.querySelector(':scope > svg');
+ var zoomIn = document.querySelector('[data-view="in"]');
+ var zoomOut = document.querySelector('[data-view="out"]');
+ for (var index = 0; index < scenario.setupZoomClicks; index += 1) zoomIn.click();
+
+ var rect = svg.getBoundingClientRect();
+ var pointer = { bubbles: true, pointerId: 17, button: 0 };
+ var x = rect.left + rect.width / 2;
+ var y = rect.top + rect.height / 2;
+ container.dispatchEvent(new PointerEvent('pointerdown', Object.assign({ clientX: x, clientY: y }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointermove', Object.assign({ clientX: x, clientY: y + 500 }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointerup', Object.assign({ clientX: x, clientY: y + 500 }, pointer)));
+
+ document.documentElement.removeAttribute('data-motion');
+ return new Promise(function (resolve) {
+ requestAnimationFrame(function () {
+ if (scenario.action === 'in') zoomIn.click();
+ else if (scenario.action === 'out') zoomOut.click();
+ else if (scenario.action === 'reset') document.querySelector('[data-view="reset"]').click();
+ else {
+ zoomOut.click();
+ requestAnimationFrame(function () { zoomIn.click(); });
+ }
+ var edge = document.querySelector(
+ 'path[data-edge-id="jwt-verification"][data-edge-from="auth"][data-edge-to="api"]'
+ );
+ var hits = [];
+ var started = performance.now();
+ function sample(now) {
+ var dock = document.querySelector('.diagram-nav').getBoundingClientRect();
+ var matrix = edge.getScreenCTM();
+ var length = edge.getTotalLength();
+ for (var offset = 0; offset <= length; offset += 0.25) {
+ var point = edge.getPointAtLength(offset).matrixTransform(matrix);
+ if (
+ point.x >= dock.left && point.x <= dock.right &&
+ point.y >= dock.top && point.y <= dock.bottom &&
+ document.elementsFromPoint(point.x, point.y).includes(edge)
+ ) {
+ hits.push({ ms: now - started, x: point.x, y: point.y });
+ break;
+ }
+ }
+ if (now - started < scenario.duration) requestAnimationFrame(sample);
+ else resolve({ hits: hits, clipPath: svg.style.getPropertyValue('clip-path') });
+ }
+ requestAnimationFrame(sample);
+ });
+ });
+ })()`, true);
+
+ assert.deepEqual(result.hits, [], `${scenario.name}: ${JSON.stringify(result.hits)}`);
+ if (scenario.clearsClip) {
+ assert.equal(result.clipPath, '', `${scenario.name} retains runtime clip-path`);
+ }
+ }
+ } finally {
+ await browser.close();
+ }
+});
+
+test('zoom keeps the desktop rail stable and reports protected stage geometry', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ try {
+ const sessionId = await load(browser, render('architecture', CASES.architecture));
+ const baseline = await finalGeometry(browser, sessionId);
+ await evaluate(browser, sessionId, `(function () {
+ var container = document.querySelector('.diagram-container');
+ var zoomIn = document.querySelector('[data-view="in"]');
+ for (var index = 0; index < 8; index += 1) zoomIn.click();
+ var svg = container.querySelector(':scope > svg');
+ var rect = svg.getBoundingClientRect();
+ var pointer = { bubbles: true, pointerId: 13, button: 0 };
+ var startX = rect.left + rect.width / 2;
+ var startY = rect.top + rect.height / 2;
+ container.dispatchEvent(new PointerEvent('pointerdown', Object.assign({ clientX: startX, clientY: startY }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointermove', Object.assign({ clientX: startX + 210, clientY: startY - 500 }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointerup', Object.assign({ clientX: startX + 210, clientY: startY - 500 }, pointer)));
+ })()`);
+ await waitForLayout(browser, sessionId);
+ const zoomed = await finalGeometry(browser, sessionId);
+
+ assert.ok(Math.abs(zoomed.reserve - baseline.reserve) <= 1, JSON.stringify({ baseline, zoomed }));
+ assert.equal(zoomed.dockStageIntersectionArea, 0, JSON.stringify({ baseline, zoomed }));
+ assert.equal(zoomed.receiptStageIntersectionArea, 0, JSON.stringify({ baseline, zoomed }));
+ } finally {
+ await browser.close();
+ }
+});
+
+test('Reset followed immediately by zoom and pan retains a collision-free desktop rail', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ try {
+ const sessionId = await load(browser, render('architecture', CASES.architecture));
+ const baseline = await finalGeometry(browser, sessionId);
+ await evaluate(browser, sessionId, `(function () {
+ var container = document.querySelector('.diagram-container');
+ document.querySelector('[data-view="reset"]').click();
+ var zoomIn = document.querySelector('[data-view="in"]');
+ for (var index = 0; index < 8; index += 1) zoomIn.click();
+ var svg = container.querySelector(':scope > svg');
+ var rect = svg.getBoundingClientRect();
+ var pointer = { bubbles: true, pointerId: 11, button: 0 };
+ var startX = rect.left + rect.width / 2;
+ var startY = rect.top + rect.height / 2;
+ container.dispatchEvent(new PointerEvent('pointerdown', Object.assign({ clientX: startX, clientY: startY }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointermove', Object.assign({ clientX: startX, clientY: startY + 500 }, pointer)));
+ container.dispatchEvent(new PointerEvent('pointerup', Object.assign({ clientX: startX, clientY: startY + 500 }, pointer)));
+ })()`);
+ await waitForLayout(browser, sessionId);
+ const receipt = await finalGeometry(browser, sessionId);
+
+ assert.ok(receipt.reserve > 0, JSON.stringify({ baseline, receipt }));
+ assert.ok(receipt.reserve <= baseline.reserve + 1, JSON.stringify({ baseline, receipt }));
+ assert.equal(receipt.semanticDockIntersectionArea, 0, JSON.stringify({ baseline, receipt }));
+ } finally {
+ await browser.close();
+ }
+});
+
+test('zoomed camera restores its bounded desktop rail after crossing the mobile breakpoint', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ try {
+ const sessionId = await load(browser, render('architecture', CASES.architecture));
+ const baseline = await finalGeometry(browser, sessionId);
+ await evaluate(browser, sessionId, `(function () {
+ var zoomIn = document.querySelector('[data-view="in"]');
+ for (var index = 0; index < 8; index += 1) zoomIn.click();
+ })()`);
+ await waitForLayout(browser, sessionId);
+ const zoomed = await finalGeometry(browser, sessionId);
+
+ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {
+ width: 720,
+ height: 900,
+ deviceScaleFactor: 1,
+ mobile: false,
+ }, sessionId);
+ await waitForLayout(browser, sessionId);
+ const mobile = await finalGeometry(browser, sessionId);
+ assert.equal(mobile.reserve, 0, JSON.stringify(mobile));
+
+ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {
+ width: 1440,
+ height: 900,
+ deviceScaleFactor: 1,
+ mobile: false,
+ }, sessionId);
+ await waitForLayout(browser, sessionId);
+ const restored = await finalGeometry(browser, sessionId);
+
+ assert.ok(Math.abs(restored.reserve - baseline.reserve) <= 1, JSON.stringify({ baseline, zoomed, restored }));
+ assert.equal(restored.receiptReserve, restored.reserve, JSON.stringify(restored));
+ assert.equal(restored.receiptEligible, true, JSON.stringify(restored));
+ assert.ok(restored.scrollHeight <= restored.innerHeight, JSON.stringify(restored));
+ } finally {
+ await browser.close();
+ }
+});
+
+test('localized multiline Legends remain clear across required viewports, themes, and presets', {
+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
+}, async () => {
+ const browser = new ChromeVisualBrowser(chromePath);
+ const viewports = [[1440, 900], [1600, 1000], [1920, 1080], [2048, 1320]];
+ const cases = viewports.flatMap(([width, height]) => (
+ ['light', 'dark'].flatMap((theme) => (
+ ['classic', 'signal-flow', 'blueprint', 'editorial'].map((preset) => ({
+ width,
+ height,
+ theme,
+ preset,
+ }))
+ ))
+ ));
try {
const sessionId = await load(browser, render('architecture', CASES.architecture), { width: 1920, height: 1080 });
await evaluate(browser, sessionId, `(function () {
@@ -366,13 +734,18 @@ test('localized multiline Legends remain clear across themes, presets, and zoom
})()`);
for (const entry of cases) {
+ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {
+ width: entry.width,
+ height: entry.height,
+ deviceScaleFactor: 1,
+ mobile: false,
+ }, sessionId);
await evaluate(browser, sessionId, `(function () {
var html = document.documentElement;
var nav = document.querySelector('.diagram-nav');
html.setAttribute('data-preset', ${JSON.stringify(entry.preset)});
html.setAttribute('data-theme', ${JSON.stringify(entry.theme)});
- html.style.fontSize = ${JSON.stringify(`${entry.zoom * 100}%`)};
- document.body.style.zoom = ${JSON.stringify(String(entry.zoom))};
+ document.querySelector('[data-view="reset"]').click();
nav.removeAttribute('style');
window.dispatchEvent(new Event('resize'));
})()`);
@@ -384,10 +757,9 @@ test('localized multiline Legends remain clear across themes, presets, and zoom
var legend = document.querySelector('[data-legend]').getBoundingClientRect();
var nav = document.querySelector('.diagram-nav');
var containerRect = container.getBoundingClientRect();
- var renderedZoom = nav.offsetHeight ? nav.getBoundingClientRect().height / nav.offsetHeight : ${entry.zoom};
nav.style.right = '0';
nav.style.left = '0';
- nav.style.bottom = Math.max(0, (containerRect.bottom - legend.bottom) / renderedZoom) + 'px';
+ nav.style.bottom = Math.max(0, containerRect.bottom - legend.bottom) + 'px';
nav.style.width = 'auto';
window.dispatchEvent(new Event('resize'));
})()`);
@@ -397,6 +769,8 @@ test('localized multiline Legends remain clear across themes, presets, and zoom
}
assert.equal(receipt.legendDockIntersectionArea, 0, JSON.stringify({ ...entry, receipt }));
assert.ok(receipt.reserve > 0, JSON.stringify({ ...entry, receipt }));
+ assert.equal(receipt.dockStageIntersectionArea, 0, JSON.stringify({ ...entry, receipt }));
+ assert.ok(receipt.stageGap >= 9, JSON.stringify({ ...entry, receipt }));
}
} finally {
await browser.close();
@@ -462,7 +836,7 @@ test('Radar, Passport, Legend, and Dock remain mutually clear on desktop and nar
}
});
-test('mobile, embed, hidden Legend, and print keep reserve at zero', {
+test('mobile, embed, and print keep zero reserve while hidden Legends retain the stage rail', {
skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',
}, async () => {
const browser = new ChromeVisualBrowser(chromePath);
@@ -483,7 +857,8 @@ test('mobile, embed, hidden Legend, and print keep reserve at zero', {
})()`);
await waitForLayout(browser, sessionId);
receipt = await finalGeometry(browser, sessionId);
- assert.equal(receipt.reserve, 0, `hidden: ${JSON.stringify(receipt)}`);
+ assert.ok(receipt.reserve > 0, `hidden: ${JSON.stringify(receipt)}`);
+ assert.ok(receipt.stageGap >= 9, `hidden: ${JSON.stringify(receipt)}`);
await browser.cdp.send('Emulation.setEmulatedMedia', { media: 'print' }, sessionId);
await waitForLayout(browser, sessionId);
diff --git a/archify/test/visual-check.test.mjs b/archify/test/visual-check.test.mjs
index 0c531ffe..62127ec6 100644
--- a/archify/test/visual-check.test.mjs
+++ b/archify/test/visual-check.test.mjs
@@ -31,7 +31,7 @@ function sha256(file) {
return createHash('sha256').update(fs.readFileSync(file)).digest('hex');
}
-function fakeBrowser({ overflowAt, unreadableAt, chromeCollisionAt, screenshotFailure } = {}) {
+function fakeBrowser({ overflowAt, unreadableAt, chromeCollisionAt, stageCollisionAt, stageGapAt, screenshotFailure } = {}) {
const calls = [];
return {
calls,
@@ -44,6 +44,9 @@ function fakeBrowser({ overflowAt, unreadableAt, chromeCollisionAt, screenshotFa
const overflow = overflowAt?.({ width, height, theme }) || false;
const unreadable = unreadableAt?.({ width, height, theme }) || false;
const chromeCollision = chromeCollisionAt?.({ width, height, theme }) || false;
+ const stageCollision = stageCollisionAt?.({ width, height, theme }) || false;
+ const dockStageGap = stageGapAt?.({ width, height, theme }) ?? (stageCollision ? -12 : 10);
+ const stageClearanceFailure = stageCollision || dockStageGap < 10;
return {
innerWidth: width,
innerHeight: height,
@@ -59,8 +62,11 @@ function fakeBrowser({ overflowAt, unreadableAt, chromeCollisionAt, screenshotFa
hasLegend: true,
hasNavigationDock: true,
legendDockIntersectionArea: chromeCollision ? 42 : 0,
- viewerChromeReserve: chromeCollision ? 0 : 44,
- viewerChromeActive: !chromeCollision,
+ dockStageIntersectionArea: stageCollision ? 84 : 0,
+ dockStageGap,
+ viewerChromeRequiredGap: 10,
+ viewerChromeReserve: chromeCollision || stageClearanceFailure ? 0 : 44,
+ viewerChromeActive: !chromeCollision && !stageClearanceFailure,
};
},
async close() {},
@@ -126,6 +132,8 @@ test('visual-check converts a Chrome DevTools pipe reset and captured stderr int
assert.match(result.receipt.error, /Chrome DevTools read pipe failed/);
assert.match(result.receipt.error, /ECONNRESET/);
assert.match(result.receipt.error, /Chrome sandbox initialization failed/);
+ assert.equal(result.receipt.diagnostics[0]?.code, 'viewer/visual-check-runtime');
+ assert.match(result.receipt.diagnostics[0]?.evidence?.reason || '', /ECONNRESET/);
assert.equal(fs.existsSync(sidecarPaths(input).receipt), true);
});
@@ -156,6 +164,7 @@ test('visual-check reports Chrome early exit status and stderr without an uncaug
assert.match(result.receipt.error, /Chrome DevTools process exit failed/);
assert.match(result.receipt.error, /exit code 23/);
assert.match(result.receipt.error, /Chrome rejected its launch flags/);
+ assert.equal(result.receipt.diagnostics[0]?.code, 'viewer/visual-check-runtime');
});
test('visual-check records four containment viewports and four endpoint theme captures', async () => {
@@ -170,6 +179,7 @@ test('visual-check records four containment viewports and four endpoint theme ca
assert.equal(result.exitCode, 0);
assert.equal(result.receipt.status, 'pass');
+ assert.deepEqual(result.receipt.diagnostics, []);
assert.equal(result.receipt.visualReview, 'pending');
assert.equal(result.receipt.viewerChrome.status, 'pass');
assert.equal(result.receipt.containment.viewports.length, VISUAL_CHECK_VIEWPORTS.length);
@@ -214,6 +224,14 @@ test('visual-check returns 1 and preserves evidence when any viewport overflows'
result.receipt.containment.viewports.filter((entry) => !entry.ok).map((entry) => [entry.width, entry.height]),
[[1600, 1000]],
);
+ const diagnostic = result.receipt.diagnostics.find(
+ (entry) => entry.code === 'viewer/viewport-overflow',
+ );
+ assert.deepEqual(diagnostic?.subject, {
+ artifact: input,
+ viewport: { width: 1600, height: 1000, theme: 'light' },
+ });
+ assert.equal(diagnostic?.evidence?.scrollWidth, 1601);
assert.equal(fs.existsSync(sidecarPaths(input).contactSheet), true);
});
@@ -237,6 +255,12 @@ test('visual-check returns 1 when the real reader projects node text below 6px',
assert.equal(desktop?.minimumProjectedNodeText, 'Compact node');
assert.equal(desktop?.minimumProjectedNodeTextDetail, 'primary');
assert.equal(desktop?.readabilityOk, false);
+ const diagnostic = result.receipt.diagnostics.find(
+ (entry) => entry.code === 'viewer/projected-text-readability',
+ );
+ assert.equal(diagnostic?.evidence?.text, 'Compact node');
+ assert.equal(diagnostic?.evidence?.minimumProjectedNodeTextPx, 5.72);
+ assert.equal(diagnostic?.evidence?.minimumRequiredNodeTextPx, 6);
});
test('visual-check returns 1 when the navigation dock obscures the SVG legend', async () => {
@@ -259,6 +283,72 @@ test('visual-check returns 1 when the navigation dock obscures the SVG legend',
);
assert.equal(desktop?.legendDockIntersectionArea, 42);
assert.equal(desktop?.viewerChromeOk, false);
+ const diagnostic = result.receipt.diagnostics.find(
+ (entry) => entry.code === 'viewer/chrome-legend-clearance',
+ );
+ assert.equal(diagnostic?.evidence?.legendDockIntersectionArea, 42);
+});
+
+test('visual-check returns 1 when the navigation dock enters the SVG stage', async () => {
+ const input = artifact('viewer-stage-collision.html');
+ const result = await runVisualCheck({
+ artifactPath: input,
+ chromePath: '/fake/chrome',
+ browserFactory: async () => fakeBrowser({
+ stageCollisionAt: ({ width, height, theme }) => (
+ width === 1920 && height === 1080 && theme === 'light'
+ ),
+ }),
+ });
+
+ assert.equal(result.exitCode, 1);
+ assert.equal(result.receipt.status, 'fail');
+ assert.equal(result.receipt.viewerChrome.status, 'fail');
+ const desktop = result.receipt.viewerChrome.viewports.find(
+ (entry) => entry.width === 1920 && entry.height === 1080,
+ );
+ assert.equal(desktop?.dockStageIntersectionArea, 84);
+ assert.equal(desktop?.dockStageGap, -12);
+ assert.equal(desktop?.requiredDockStageGap, 10);
+ assert.equal(desktop?.viewerChromeStageOk, false);
+ assert.equal(desktop?.viewerChromeOk, false);
+ const diagnostic = result.receipt.diagnostics.find(
+ (entry) => entry.code === 'viewer/chrome-stage-clearance',
+ );
+ assert.deepEqual(diagnostic?.subject, {
+ artifact: input,
+ viewport: { width: 1920, height: 1080, theme: 'light' },
+ });
+ assert.deepEqual(diagnostic?.evidence, {
+ dockStageIntersectionArea: 84,
+ dockStageGap: -12,
+ requiredDockStageGap: 10,
+ });
+ assert.match(diagnostic?.message || '', /enters the protected SVG stage/);
+ assert.ok(diagnostic?.supportedFixes.some((fix) => fix.includes('dockStageGap')));
+ assert.equal(diagnostic?.supportedFixes.some((fix) => fix.includes('regenerate')), false);
+});
+
+test('visual-check describes insufficient stage clearance without claiming an overlap', async () => {
+ const input = artifact('viewer-stage-low-gap.html');
+ const result = await runVisualCheck({
+ artifactPath: input,
+ chromePath: '/fake/chrome',
+ browserFactory: async () => fakeBrowser({
+ stageGapAt: ({ width, height, theme }) => (
+ width === 1920 && height === 1080 && theme === 'light' ? 5 : 10
+ ),
+ }),
+ });
+
+ assert.equal(result.exitCode, 1);
+ const diagnostic = result.receipt.diagnostics.find(
+ (entry) => entry.code === 'viewer/chrome-stage-clearance',
+ );
+ assert.equal(diagnostic?.evidence?.dockStageIntersectionArea, 0);
+ assert.equal(diagnostic?.evidence?.dockStageGap, 5);
+ assert.match(diagnostic?.message || '', /clearance.*below the required gap/i);
+ assert.doesNotMatch(diagnostic?.message || '', /enters/i);
});
test('visual-check returns 1 and removes misleading capture sidecars on screenshot failure', async () => {
@@ -279,6 +369,8 @@ test('visual-check returns 1 and removes misleading capture sidecars on screensh
assert.equal(result.receipt.status, 'fail');
assert.equal(result.receipt.captures.status, 'fail');
assert.match(result.receipt.error, /synthetic screenshot failure/);
+ assert.equal(result.receipt.diagnostics[0]?.code, 'viewer/visual-check-runtime');
+ assert.match(result.receipt.diagnostics[0]?.evidence?.reason || '', /synthetic screenshot failure/);
assert.equal(fs.existsSync(outputs.contactSheet), false);
assert.equal(outputs.screenshots.some((entry) => fs.existsSync(entry.path)), false);
assert.equal(fs.existsSync(outputs.receipt), true);
@@ -297,6 +389,8 @@ test('visual-check returns 2 with a truthful skipped receipt when Chrome is unav
assert.equal(result.receipt.viewerChrome.status, 'skipped');
assert.equal(result.receipt.captures.status, 'skipped');
assert.equal(result.receipt.visualReview, 'pending');
+ assert.equal(result.receipt.diagnostics[0]?.code, 'viewer/chrome-unavailable');
+ assert.ok(result.receipt.diagnostics[0]?.supportedFixes.some((fix) => fix.includes('ARCHIFY_CHROME')));
assert.equal(fs.existsSync(sidecarPaths(input).receipt), true);
});
diff --git a/archify/test/webm-artifact.smoke.mjs b/archify/test/webm-artifact.smoke.mjs
index cc2402fd..82822d4b 100644
--- a/archify/test/webm-artifact.smoke.mjs
+++ b/archify/test/webm-artifact.smoke.mjs
@@ -1011,6 +1011,7 @@ try {
function stableLiveSnapshot() {
var clone = svg.cloneNode(true);
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
Array.from(clone.querySelectorAll('[data-legend-bridge-runtime]')).forEach(function (element) { element.remove(); });
return clone.outerHTML;
@@ -1514,6 +1515,7 @@ try {
function stableLiveSnapshot() {
var clone = svg.cloneNode(true);
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
Array.from(clone.querySelectorAll('[data-legend-bridge-runtime]')).forEach(function (element) { element.remove(); });
return clone.outerHTML;
diff --git a/docs/assets/archify-live-proof.gif b/docs/assets/archify-live-proof.gif
index 634e2634..beb6a591 100644
Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differ
diff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.json
index caf21a3e..9e8a544b 100644
--- a/docs/assets/archify-live-proof.json
+++ b/docs/assets/archify-live-proof.json
@@ -7,13 +7,13 @@
"fps": 10,
"frameCount": 54,
"durationSeconds": 5.4,
- "bytes": 1638067,
- "sha256": "106284c0f3cce8331798c66f674888c16f10274d566aca6d0053625fdef9fbc1",
+ "bytes": 918340,
+ "sha256": "af7940a3d61f386a2e3afb21549bc689b3f3c7d142239e6cce52d4b3b511af2d",
"scenes": [
{
"id": "signal-flow",
"artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",
- "artifactSha256": "326cad00bebb0753b717067753e6f6ab70ba4d8ca9ebd70f04c3444be964a107",
+ "artifactSha256": "7d9c378a53f9bd870a1f4e67db0d4b8e2bedbdb78c3678764aef4a48b4d1b391",
"view": "happy-path",
"eyebrow": "WORKFLOW · SIGNAL FLOW",
"title": "Agent Tool Call",
@@ -22,7 +22,7 @@
{
"id": "blueprint",
"artifact": "docs/gallery/artifacts/production-deployment.architecture.html",
- "artifactSha256": "845d666d08e1a1e7175f15017fe0b6b4181b2d1e316ffddf963a0eb8586e3cfb",
+ "artifactSha256": "c640b8bde8a2400b99e01d9b8fc690e4a2ee47dde299363839499b27404f5fe0",
"view": "request-boundary",
"eyebrow": "ARCHITECTURE · BLUEPRINT",
"title": "Production Deployment",
@@ -31,7 +31,7 @@
{
"id": "classic",
"artifact": "docs/gallery/artifacts/cache-miss.sequence.html",
- "artifactSha256": "dc53913ea5fed26c3021bd1c0a7545bd98a89e458fc0e61b00086e6c7d9cf36d",
+ "artifactSha256": "c027d67e0e8e3286617897254d9ddb4de04f714ff01231b05f535f9e62d20b82",
"view": "cache-fallback",
"eyebrow": "SEQUENCE · CLASSIC",
"title": "Cache Miss Request",
diff --git a/docs/cases/mco-runtime.architecture.html b/docs/cases/mco-runtime.architecture.html
index 41a2f91d..0f9f07da 100644
--- a/docs/cases/mco-runtime.architecture.html
+++ b/docs/cases/mco-runtime.architecture.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5973,6 +5980,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6147,6 +6155,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11110,9 +11119,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11123,10 +11132,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11143,26 +11155,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11176,15 +11238,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11193,50 +11263,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11244,6 +11357,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11265,8 +11382,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11285,7 +11402,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11306,6 +11423,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11325,6 +11443,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11410,9 +11529,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11534,9 +11687,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery.html b/docs/gallery.html
index d20f2d37..9743a2f5 100644
--- a/docs/gallery.html
+++ b/docs/gallery.html
@@ -306,7 +306,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 11E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="326cad00bebb0753b717067753e6f6ab70ba4d8ca9ebd70f04c3444be964a107">326cad00bebb</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="7d9c378a53f9bd870a1f4e67db0d4b8e2bedbdb78c3678764aef4a48b4d1b391">7d9c378a53f9</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/agent-tool-call.workflow.html?present=1&amp;play=1#view=happy-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -336,7 +336,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="845d666d08e1a1e7175f15017fe0b6b4181b2d1e316ffddf963a0eb8586e3cfb">845d666d08e1</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="c640b8bde8a2400b99e01d9b8fc690e4a2ee47dde299363839499b27404f5fe0">c640b8bde8a2</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/production-deployment.architecture.html?present=1&amp;play=1#view=request-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -365,7 +365,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 12E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="dc53913ea5fed26c3021bd1c0a7545bd98a89e458fc0e61b00086e6c7d9cf36d">dc53913ea5fe</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="c027d67e0e8e3286617897254d9ddb4de04f714ff01231b05f535f9e62d20b82">c027d67e0e8e</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/cache-miss.sequence.html?present=1&amp;play=1#view=cache-fallback" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -394,7 +394,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="a86e4c5a4639001472b1e504ce32e16ad72ecad494b3c370526b8e510fb53bc6">a86e4c5a4639</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="1a5118b5902b43c8ebc299379cf0bf317e69dadc11c9e4a4c4f264542033ac1b">1a5118b5902b</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/release-delivery.workflow.html?present=1&amp;play=1#view=approval-to-production" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -423,7 +423,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 10E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="3d4cb4bacd3bce995ddc8256313346a2dfe08bbd0fd15800068155d2e0148ab8">3d4cb4bacd3b</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="2e3b3a8270c108e99104857888606b92f2b7abd63841210df837d27ea8e533c2">2e3b3a8270c1</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/incident-response.workflow.html?present=1&amp;play=1#view=mitigate-and-verify" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -452,7 +452,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="03e11443c4c59f3ce9a68b78b00721f797684bf2db6bbb4ea4a97439c29edfd2">03e11443c4c5</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="d71260a3c92d3bae6c19260794a36b86e101c882b1a2723e722a6e127ae96ad8">d71260a3c92d</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/product-analytics.dataflow.html?present=1&amp;play=1#view=consent-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -481,7 +481,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 14E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="27ed053c2efa46856c0b80b700d5208e2905b394d80aec99e9d2f7b8a449306d">27ed053c2efa</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="03351223c865f8e74bc65ad1fc51c330a8c4bd007cdbe3f69cbd2a7fdadf1e58">03351223c865</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/async-job-roundtrip.sequence.html?present=1&amp;play=1#view=work-and-retry" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -510,7 +510,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="57e82e1c5fee0647ddbd9e5e6e9b103c6044b78800cb87ee425d142e40bf3749">57e82e1c5fee</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="4b649b9f886e59df0def182b0ec1bd5aca1bba115e7335ff60a498a7f87aa0c2">4b649b9f886e</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/event-stream.dataflow.html?present=1&amp;play=1#view=order-transit" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -539,7 +539,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 6E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="db4fc7207fb6395701b1c94d27d8a10faebc875c4e618a44b6d840ef3d108fac">db4fc7207fb6</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ee5b76cbd7ac35173eb7e9a341a22bd7052877433797fca123786deebda27c7f">ee5b76cbd7ac</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html?present=1&amp;play=1#view=main-lifecycle" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -568,7 +568,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 6E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="d9d994d74dc0acce1b3372d9dd73993639bbc4f5b600466543dca0e083477fa5">d9d994d74dc0</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="d62f3c11044a4c864a6c589e32e0ee4128ad1546c30afa3fe1131d6fcf3bb82f">d62f3c11044a</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html?present=1&amp;play=1#view=rollback-outcomes" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -597,7 +597,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 9E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e14e396f93cf35ca7c53be87d463041ea42c43fb3ade7f1cd1ce9c84522d2e94">e14e396f93cf</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="b51b04e6061e1a5713ca8e026d5755dd58bea9ccf6233171ca6acafdb0fb7a4f">b51b04e6061e</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/web-app.architecture.html?present=1&amp;play=1#view=request-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -683,8 +683,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 11,
- "artifactBytes": 713856,
- "artifactSha256": "326cad00bebb0753b717067753e6f6ab70ba4d8ca9ebd70f04c3444be964a107",
+ "artifactBytes": 720452,
+ "artifactSha256": "7d9c378a53f9bd870a1f4e67db0d4b8e2bedbdb78c3678764aef4a48b4d1b391",
"sourceBytes": 6367,
"sourceSha256": "9c94c8c0b2104478b77befb4cc5e343d381acba6e66645ab17616fde20b60e05",
"checks": [
@@ -783,8 +783,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": "deployment-ownership",
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 718276,
- "artifactSha256": "845d666d08e1a1e7175f15017fe0b6b4181b2d1e316ffddf963a0eb8586e3cfb",
+ "artifactBytes": 724872,
+ "artifactSha256": "c640b8bde8a2400b99e01d9b8fc690e4a2ee47dde299363839499b27404f5fe0",
"sourceBytes": 5476,
"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb",
"checks": [
@@ -883,8 +883,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 12,
- "artifactBytes": 710246,
- "artifactSha256": "dc53913ea5fed26c3021bd1c0a7545bd98a89e458fc0e61b00086e6c7d9cf36d",
+ "artifactBytes": 716842,
+ "artifactSha256": "c027d67e0e8e3286617897254d9ddb4de04f714ff01231b05f535f9e62d20b82",
"sourceBytes": 4345,
"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389",
"checks": [
@@ -983,8 +983,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 712642,
- "artifactSha256": "a86e4c5a4639001472b1e504ce32e16ad72ecad494b3c370526b8e510fb53bc6",
+ "artifactBytes": 719238,
+ "artifactSha256": "1a5118b5902b43c8ebc299379cf0bf317e69dadc11c9e4a4c4f264542033ac1b",
"sourceBytes": 5164,
"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91",
"checks": [
@@ -1083,8 +1083,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 10,
- "artifactBytes": 709971,
- "artifactSha256": "3d4cb4bacd3bce995ddc8256313346a2dfe08bbd0fd15800068155d2e0148ab8",
+ "artifactBytes": 716567,
+ "artifactSha256": "2e3b3a8270c108e99104857888606b92f2b7abd63841210df837d27ea8e533c2",
"sourceBytes": 5375,
"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b",
"checks": [
@@ -1183,8 +1183,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 713900,
- "artifactSha256": "03e11443c4c59f3ce9a68b78b00721f797684bf2db6bbb4ea4a97439c29edfd2",
+ "artifactBytes": 720496,
+ "artifactSha256": "d71260a3c92d3bae6c19260794a36b86e101c882b1a2723e722a6e127ae96ad8",
"sourceBytes": 5627,
"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110",
"checks": [
@@ -1283,8 +1283,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 14,
- "artifactBytes": 710656,
- "artifactSha256": "27ed053c2efa46856c0b80b700d5208e2905b394d80aec99e9d2f7b8a449306d",
+ "artifactBytes": 717252,
+ "artifactSha256": "03351223c865f8e74bc65ad1fc51c330a8c4bd007cdbe3f69cbd2a7fdadf1e58",
"sourceBytes": 4370,
"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9",
"checks": [
@@ -1383,8 +1383,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 717863,
- "artifactSha256": "57e82e1c5fee0647ddbd9e5e6e9b103c6044b78800cb87ee425d142e40bf3749",
+ "artifactBytes": 724459,
+ "artifactSha256": "4b649b9f886e59df0def182b0ec1bd5aca1bba115e7335ff60a498a7f87aa0c2",
"sourceBytes": 5433,
"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e",
"checks": [
@@ -1483,8 +1483,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 6,
- "artifactBytes": 707535,
- "artifactSha256": "db4fc7207fb6395701b1c94d27d8a10faebc875c4e618a44b6d840ef3d108fac",
+ "artifactBytes": 714131,
+ "artifactSha256": "ee5b76cbd7ac35173eb7e9a341a22bd7052877433797fca123786deebda27c7f",
"sourceBytes": 4417,
"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42",
"checks": [
@@ -1583,8 +1583,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 6,
- "artifactBytes": 708527,
- "artifactSha256": "d9d994d74dc0acce1b3372d9dd73993639bbc4f5b600466543dca0e083477fa5",
+ "artifactBytes": 715123,
+ "artifactSha256": "d62f3c11044a4c864a6c589e32e0ee4128ad1546c30afa3fe1131d6fcf3bb82f",
"sourceBytes": 4274,
"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71",
"checks": [
@@ -1683,8 +1683,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 9,
- "artifactBytes": 708620,
- "artifactSha256": "e14e396f93cf35ca7c53be87d463041ea42c43fb3ade7f1cd1ce9c84522d2e94",
+ "artifactBytes": 715216,
+ "artifactSha256": "b51b04e6061e1a5713ca8e026d5755dd58bea9ccf6233171ca6acafdb0fb7a4f",
"sourceBytes": 3793,
"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf",
"checks": [
diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.html
index b0e9d5c0..ea79fa9b 100644
--- a/docs/gallery/artifacts/agent-run.lifecycle.html
+++ b/docs/gallery/artifacts/agent-run.lifecycle.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5905,6 +5912,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6079,6 +6087,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11042,9 +11051,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11055,10 +11064,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11075,26 +11087,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11108,15 +11170,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11125,50 +11195,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11176,6 +11289,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11197,8 +11314,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11217,7 +11334,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11238,6 +11355,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11257,6 +11375,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11342,9 +11461,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11466,9 +11619,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/agent-tool-call.workflow.html b/docs/gallery/artifacts/agent-tool-call.workflow.html
index 4baecadc..b5ea59d3 100644
--- a/docs/gallery/artifacts/agent-tool-call.workflow.html
+++ b/docs/gallery/artifacts/agent-tool-call.workflow.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5953,6 +5960,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6127,6 +6135,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11090,9 +11099,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11103,10 +11112,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11123,26 +11135,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11156,15 +11218,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11173,50 +11243,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11224,6 +11337,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11245,8 +11362,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11265,7 +11382,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11286,6 +11403,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11305,6 +11423,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11390,9 +11509,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11514,9 +11667,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/async-job-roundtrip.sequence.html b/docs/gallery/artifacts/async-job-roundtrip.sequence.html
index a45e42ad..7016aef1 100644
--- a/docs/gallery/artifacts/async-job-roundtrip.sequence.html
+++ b/docs/gallery/artifacts/async-job-roundtrip.sequence.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5983,6 +5990,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6157,6 +6165,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11120,9 +11129,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11133,10 +11142,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11153,26 +11165,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11186,15 +11248,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11203,50 +11273,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11254,6 +11367,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11275,8 +11392,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11295,7 +11412,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11316,6 +11433,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11335,6 +11453,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11420,9 +11539,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11544,9 +11697,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/cache-miss.sequence.html b/docs/gallery/artifacts/cache-miss.sequence.html
index 09a5f30b..aaa74306 100644
--- a/docs/gallery/artifacts/cache-miss.sequence.html
+++ b/docs/gallery/artifacts/cache-miss.sequence.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5971,6 +5978,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6145,6 +6153,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11108,9 +11117,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11121,10 +11130,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11141,26 +11153,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11174,15 +11236,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11191,50 +11261,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11242,6 +11355,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11263,8 +11380,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11283,7 +11400,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11304,6 +11421,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11323,6 +11441,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11408,9 +11527,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11532,9 +11685,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.html
index c9f03c76..9001d825 100644
--- a/docs/gallery/artifacts/deployment-release.lifecycle.html
+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5917,6 +5924,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6091,6 +6099,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11054,9 +11063,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11067,10 +11076,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11087,26 +11099,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11120,15 +11182,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11137,50 +11207,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11188,6 +11301,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11209,8 +11326,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11229,7 +11346,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11250,6 +11367,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11269,6 +11387,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11354,9 +11473,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11478,9 +11631,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/event-stream.dataflow.html b/docs/gallery/artifacts/event-stream.dataflow.html
index a9fb484c..0e18a15c 100644
--- a/docs/gallery/artifacts/event-stream.dataflow.html
+++ b/docs/gallery/artifacts/event-stream.dataflow.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5995,6 +6002,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6169,6 +6177,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11132,9 +11141,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11145,10 +11154,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11165,26 +11177,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11198,15 +11260,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11215,50 +11285,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11266,6 +11379,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11287,8 +11404,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11307,7 +11424,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11328,6 +11445,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11347,6 +11465,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11432,9 +11551,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11556,9 +11709,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/incident-response.workflow.html b/docs/gallery/artifacts/incident-response.workflow.html
index 31844641..31870c1f 100644
--- a/docs/gallery/artifacts/incident-response.workflow.html
+++ b/docs/gallery/artifacts/incident-response.workflow.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5922,6 +5929,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6096,6 +6104,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11059,9 +11068,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11072,10 +11081,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11092,26 +11104,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11125,15 +11187,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11142,50 +11212,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11193,6 +11306,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11214,8 +11331,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11234,7 +11351,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11255,6 +11372,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11274,6 +11392,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11359,9 +11478,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11483,9 +11636,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/product-analytics.dataflow.html b/docs/gallery/artifacts/product-analytics.dataflow.html
index 5c5aa1a3..4a3c6288 100644
--- a/docs/gallery/artifacts/product-analytics.dataflow.html
+++ b/docs/gallery/artifacts/product-analytics.dataflow.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5956,6 +5963,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6130,6 +6138,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11093,9 +11102,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11106,10 +11115,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11126,26 +11138,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11159,15 +11221,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11176,50 +11246,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11227,6 +11340,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11248,8 +11365,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11268,7 +11385,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11289,6 +11406,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11308,6 +11426,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11393,9 +11512,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11517,9 +11670,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/production-deployment.architecture.html b/docs/gallery/artifacts/production-deployment.architecture.html
index eb11bc88..5fd911c7 100644
--- a/docs/gallery/artifacts/production-deployment.architecture.html
+++ b/docs/gallery/artifacts/production-deployment.architecture.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5987,6 +5994,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6161,6 +6169,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11124,9 +11133,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11137,10 +11146,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11157,26 +11169,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11190,15 +11252,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11207,50 +11277,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11258,6 +11371,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11279,8 +11396,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11299,7 +11416,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11320,6 +11437,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11339,6 +11457,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11424,9 +11543,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11548,9 +11701,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/release-delivery.workflow.html b/docs/gallery/artifacts/release-delivery.workflow.html
index 909c4de1..ee85de98 100644
--- a/docs/gallery/artifacts/release-delivery.workflow.html
+++ b/docs/gallery/artifacts/release-delivery.workflow.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5948,6 +5955,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6122,6 +6130,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11085,9 +11094,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11098,10 +11107,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11118,26 +11130,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11151,15 +11213,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11168,50 +11238,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11219,6 +11332,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11240,8 +11357,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11260,7 +11377,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11281,6 +11398,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11300,6 +11418,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11385,9 +11504,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11509,9 +11662,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/artifacts/web-app.architecture.html b/docs/gallery/artifacts/web-app.architecture.html
index 924ac0ca..cef9fccf 100644
--- a/docs/gallery/artifacts/web-app.architecture.html
+++ b/docs/gallery/artifacts/web-app.architecture.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5920,6 +5927,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6094,6 +6102,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11057,9 +11066,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11070,10 +11079,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11090,26 +11102,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11123,15 +11185,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11140,50 +11210,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11191,6 +11304,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11212,8 +11329,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11232,7 +11349,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11253,6 +11370,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11272,6 +11390,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11357,9 +11476,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11481,9 +11634,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.json
index 496e5eec..f4ef80da 100644
--- a/docs/gallery/manifest.json
+++ b/docs/gallery/manifest.json
@@ -27,8 +27,8 @@
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 11,
- "artifactBytes": 713856,
- "artifactSha256": "326cad00bebb0753b717067753e6f6ab70ba4d8ca9ebd70f04c3444be964a107",
+ "artifactBytes": 720452,
+ "artifactSha256": "7d9c378a53f9bd870a1f4e67db0d4b8e2bedbdb78c3678764aef4a48b4d1b391",
"sourceBytes": 6367,
"sourceSha256": "9c94c8c0b2104478b77befb4cc5e343d381acba6e66645ab17616fde20b60e05",
"checks": [
@@ -127,8 +127,8 @@
"engineeringProfile": "deployment-ownership",
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 718276,
- "artifactSha256": "845d666d08e1a1e7175f15017fe0b6b4181b2d1e316ffddf963a0eb8586e3cfb",
+ "artifactBytes": 724872,
+ "artifactSha256": "c640b8bde8a2400b99e01d9b8fc690e4a2ee47dde299363839499b27404f5fe0",
"sourceBytes": 5476,
"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb",
"checks": [
@@ -227,8 +227,8 @@
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 12,
- "artifactBytes": 710246,
- "artifactSha256": "dc53913ea5fed26c3021bd1c0a7545bd98a89e458fc0e61b00086e6c7d9cf36d",
+ "artifactBytes": 716842,
+ "artifactSha256": "c027d67e0e8e3286617897254d9ddb4de04f714ff01231b05f535f9e62d20b82",
"sourceBytes": 4345,
"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389",
"checks": [
@@ -327,8 +327,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 712642,
- "artifactSha256": "a86e4c5a4639001472b1e504ce32e16ad72ecad494b3c370526b8e510fb53bc6",
+ "artifactBytes": 719238,
+ "artifactSha256": "1a5118b5902b43c8ebc299379cf0bf317e69dadc11c9e4a4c4f264542033ac1b",
"sourceBytes": 5164,
"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91",
"checks": [
@@ -427,8 +427,8 @@
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 10,
- "artifactBytes": 709971,
- "artifactSha256": "3d4cb4bacd3bce995ddc8256313346a2dfe08bbd0fd15800068155d2e0148ab8",
+ "artifactBytes": 716567,
+ "artifactSha256": "2e3b3a8270c108e99104857888606b92f2b7abd63841210df837d27ea8e533c2",
"sourceBytes": 5375,
"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b",
"checks": [
@@ -527,8 +527,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 713900,
- "artifactSha256": "03e11443c4c59f3ce9a68b78b00721f797684bf2db6bbb4ea4a97439c29edfd2",
+ "artifactBytes": 720496,
+ "artifactSha256": "d71260a3c92d3bae6c19260794a36b86e101c882b1a2723e722a6e127ae96ad8",
"sourceBytes": 5627,
"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110",
"checks": [
@@ -627,8 +627,8 @@
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 14,
- "artifactBytes": 710656,
- "artifactSha256": "27ed053c2efa46856c0b80b700d5208e2905b394d80aec99e9d2f7b8a449306d",
+ "artifactBytes": 717252,
+ "artifactSha256": "03351223c865f8e74bc65ad1fc51c330a8c4bd007cdbe3f69cbd2a7fdadf1e58",
"sourceBytes": 4370,
"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9",
"checks": [
@@ -727,8 +727,8 @@
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 717863,
- "artifactSha256": "57e82e1c5fee0647ddbd9e5e6e9b103c6044b78800cb87ee425d142e40bf3749",
+ "artifactBytes": 724459,
+ "artifactSha256": "4b649b9f886e59df0def182b0ec1bd5aca1bba115e7335ff60a498a7f87aa0c2",
"sourceBytes": 5433,
"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e",
"checks": [
@@ -827,8 +827,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 6,
- "artifactBytes": 707535,
- "artifactSha256": "db4fc7207fb6395701b1c94d27d8a10faebc875c4e618a44b6d840ef3d108fac",
+ "artifactBytes": 714131,
+ "artifactSha256": "ee5b76cbd7ac35173eb7e9a341a22bd7052877433797fca123786deebda27c7f",
"sourceBytes": 4417,
"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42",
"checks": [
@@ -927,8 +927,8 @@
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 6,
- "artifactBytes": 708527,
- "artifactSha256": "d9d994d74dc0acce1b3372d9dd73993639bbc4f5b600466543dca0e083477fa5",
+ "artifactBytes": 715123,
+ "artifactSha256": "d62f3c11044a4c864a6c589e32e0ee4128ad1546c30afa3fe1131d6fcf3bb82f",
"sourceBytes": 4274,
"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71",
"checks": [
@@ -1027,8 +1027,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 9,
- "artifactBytes": 708620,
- "artifactSha256": "e14e396f93cf35ca7c53be87d463041ea42c43fb3ade7f1cd1ce9c84522d2e94",
+ "artifactBytes": 715216,
+ "artifactSha256": "b51b04e6061e1a5713ca8e026d5755dd58bea9ccf6233171ca6acafdb0fb7a4f",
"sourceBytes": 3793,
"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf",
"checks": [
diff --git a/examples/archify-repo-grid.html b/examples/archify-repo-grid.html
index 877faa4f..0bb4651a 100644
--- a/examples/archify-repo-grid.html
+++ b/examples/archify-repo-grid.html
@@ -3,7 +3,7 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="generator" content="archify 2.15.0">
+ <meta name="generator" content="archify 2.16.0-dev.0">
<title>Archify Pipeline Diagram</title>
<script>
// Resolve the theme before first paint so light-preference users don't
@@ -586,10 +586,13 @@
justify-content: center;
min-height: 0;
padding: 0.75rem;
+ padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -655,7 +658,7 @@
}
html[data-preset="signal-flow"] .header-row::after {
- content: "SIGNAL FLOW";
+ content: attr(data-preset-badge-signal-flow);
margin-left: auto;
color: var(--frontend-stroke);
border: 1px solid var(--frontend-stroke);
@@ -679,7 +682,7 @@
animation: none;
}
html[data-preset="blueprint"] .header-row::after {
- content: "BLUEPRINT / REV 01";
+ content: attr(data-preset-badge-blueprint);
margin-left: auto;
padding: 0.28rem 0.55rem;
border-top: 1px solid var(--frontend-stroke);
@@ -708,7 +711,7 @@
animation: none;
}
html[data-preset="editorial"] .header-row::after {
- content: "EDITORIAL / FIELD NOTE";
+ content: attr(data-preset-badge-editorial);
margin-left: auto;
padding: 0.32rem 0 0.24rem;
border-bottom: 2px solid var(--arrow-emphasis);
@@ -722,10 +725,12 @@
}
.diagram-container {
+ --archify-nav-reserve: 0px;
background: var(--panel);
border-radius: 1rem;
border: 1px solid var(--panel-border);
padding: 1.5rem;
+ padding-bottom: calc(1.5rem + var(--archify-nav-reserve));
overflow: hidden;
position: relative;
}
@@ -785,7 +790,7 @@
border: 1px solid var(--panel-border);
background: var(--panel);
color: var(--arrow-emphasis);
- content: "ARCHIFY / PLATE 04";
+ content: attr(data-preset-badge-editorial-plate);
font-family: Georgia, 'Times New Roman', serif;
font-size: 0.52rem;
font-style: italic;
@@ -1052,7 +1057,7 @@
.overview-map {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 12;
width: 11.25rem;
overflow: hidden;
@@ -1085,6 +1090,36 @@
padding: 0.42rem 0.48rem 0.38rem 0.55rem;
border-bottom: 1px solid var(--toolbar-border);
background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);
+ cursor: grab;
+ touch-action: none;
+ user-select: none;
+ }
+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }
+ .overview-map[data-placement-invalid="true"] {
+ border-color: var(--security-stroke);
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);
+ }
+ .overview-map[data-compact="true"] {
+ width: 7.4rem;
+ }
+ .overview-map[data-compact="true"] .overview-map-head {
+ grid-template-columns: minmax(0, 1fr) auto;
+ gap: 0.24rem;
+ min-height: 1.5rem;
+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;
+ border-bottom: 0;
+ }
+ .overview-map[data-compact="true"] .overview-map-live,
+ .overview-map[data-compact="true"] .overview-map-copy,
+ .overview-map[data-compact="true"] .overview-map-surface,
+ .overview-map[data-compact="true"] .overview-map-hint {
+ display: none;
+ }
+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }
+ .overview-map[data-compact="true"] .overview-map-close {
+ width: 1.15rem;
+ height: 1.15rem;
+ font-size: 0.72rem;
}
.overview-map-live {
width: 0.42rem;
@@ -1115,6 +1150,26 @@
white-space: nowrap;
text-overflow: ellipsis;
}
+ .overview-map-expand {
+ display: none;
+ align-items: center;
+ justify-content: center;
+ min-width: 0;
+ height: 1.2rem;
+ padding: 0 0.34rem;
+ overflow: hidden;
+ border: 0;
+ border-radius: 0.3rem;
+ background: transparent;
+ color: var(--frontend-stroke);
+ font: inherit;
+ font-size: 0.49rem;
+ font-weight: 700;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ white-space: nowrap;
+ cursor: pointer;
+ }
.overview-map-close {
width: 1.55rem;
height: 1.55rem;
@@ -1127,8 +1182,11 @@
font-size: 0.9rem;
cursor: pointer;
}
+ .overview-map-expand:hover,
+ .overview-map-expand:focus-visible,
.overview-map-close:hover,
.overview-map-close:focus-visible { background: var(--toolbar-hover); }
+ .overview-map-expand:focus-visible,
.overview-map-close:focus-visible,
.overview-map-surface:focus-visible,
.overview-map-node:focus-visible {
@@ -1210,6 +1268,24 @@
color: var(--frontend-stroke);
background: var(--toolbar-hover);
}
+ .overview-map-feedback {
+ position: absolute;
+ right: 1rem;
+ bottom: 4.15rem;
+ z-index: 13;
+ max-width: min(16rem, calc(100% - 2rem));
+ padding: 0.38rem 0.55rem;
+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));
+ border-radius: 0.5rem;
+ background: var(--toolbar-menu-bg);
+ color: var(--toolbar-text);
+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+ font-size: 0.52rem;
+ line-height: 1.35;
+ pointer-events: none;
+ }
+ .overview-map-feedback[hidden] { display: none; }
+ .focus-chip[data-radar-yielded="true"] { display: none !important; }
.diagram-nav #btn-route-probe[aria-pressed="true"] {
color: var(--backend-stroke);
background: var(--toolbar-hover);
@@ -1226,7 +1302,7 @@
.semantic-lens {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 24;
width: min(20rem, calc(100% - 2rem));
overflow: hidden;
@@ -1401,7 +1477,7 @@
.route-probe {
position: absolute;
left: 1rem;
- bottom: 1rem;
+ bottom: calc(1rem + var(--archify-nav-reserve));
z-index: 12;
width: min(46rem, calc(100% - 25rem));
min-width: 18rem;
@@ -2800,13 +2876,22 @@
scrolling at 900–1080px heights. */
@media (min-width: 768px) and (max-height: 1100px) {
.header { margin-bottom: 1rem; }
- .diagram-container { padding: 0.875rem; }
+ .diagram-container {
+ padding: 0.875rem;
+ padding-bottom: calc(0.875rem + var(--archify-nav-reserve));
+ }
.cards { margin-top: 1rem; }
.card { padding: 1rem; }
}
@media (min-width: 768px) and (max-height: 920px) {
+ body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -2921,6 +3006,7 @@
svg[data-chapter-preview] [data-node-id],
svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }
.diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }
+ .diagram-container { --archify-nav-reserve: 0px !important; }
html[data-preset="signal-flow"] .diagram-container,
html[data-preset="signal-flow"] .card { background: #ffffff; }
.cards { grid-template-columns: 1fr 1fr; }
@@ -3572,16 +3658,17 @@
width: min(10.25rem, calc(100% - 1rem));
}
.overview-map[data-docked="true"] {
- right: 0.5rem;
+ right: var(--archify-radar-right, 0.5rem);
top: var(--archify-radar-top, 0.5rem);
bottom: auto;
transform: none !important;
}
.overview-map[data-docked="true"][data-dock-side="left"] {
right: auto;
- left: 0.5rem;
+ left: var(--archify-radar-left, 0.5rem);
}
.overview-map-surface { height: 4rem; }
+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }
.semantic-lens {
right: 0.5rem;
bottom: 3.7rem;
@@ -4863,7 +4950,10 @@
<div class="container">
<!-- Header -->
<div class="header">
- <div class="header-row">
+ <div class="header-row"
+ data-preset-badge-signal-flow="SIGNAL FLOW"
+ data-preset-badge-blueprint="BLUEPRINT / REV 01"
+ data-preset-badge-editorial="EDITORIAL / FIELD NOTE">
<div class="pulse-dot"></div>
<h1>Archify Pipeline</h1>
</div>
@@ -4872,6 +4962,7 @@
<script id="archify-guided-views-data" type="application/json">[]</script>
+ <script id="archify-i18n-data" type="application/json">{"locale":"en","messages":{"viewer.kind.frontend":"Frontend","viewer.kind.backend":"Backend","viewer.kind.database":"Database","viewer.kind.cloud":"Cloud","viewer.kind.security":"Security","viewer.kind.messagebus":"Message bus","viewer.kind.external":"External","viewer.kind.neutral":"Neutral","viewer.kind.node":"Node","viewer.kind.start":"Start","viewer.kind.active":"Active","viewer.kind.waiting":"Waiting","viewer.kind.decision":"Decision","viewer.kind.success":"Success","viewer.kind.failure":"Failure","viewer.toolbar.actions":"Diagram actions","viewer.theme.toggle.title":"Toggle theme (T)","viewer.theme.toggle":"Toggle color theme","viewer.theme.dark":"Dark","viewer.theme.light":"Light","viewer.preset.choose.title":"Choose visual style (S cycles)","viewer.preset.choose":"Choose visual style","viewer.preset.style":"Style","viewer.preset.menu":"Visual style","viewer.preset.identity":"Visual identity","viewer.preset.cycles":"S cycles","viewer.preset.classic":"Classic","viewer.preset.classic.short":"Classic","viewer.preset.classic.hint":"Stable technical default","viewer.preset.flow":"Signal Flow","viewer.preset.flow.short":"Flow","viewer.preset.flow.hint":"Motion-forward presentation","viewer.preset.blueprint":"Blueprint","viewer.preset.blueprint.hint":"Engineering review","viewer.preset.editorial":"Editorial","viewer.preset.editorial.hint":"Publication and launch notes","viewer.preset.badge.signalFlow":"SIGNAL FLOW","viewer.preset.badge.blueprint":"BLUEPRINT / REV 01","viewer.preset.badge.editorial":"EDITORIAL / FIELD NOTE","viewer.preset.badge.editorialPlate":"ARCHIFY / PLATE 04","viewer.preset.current":"Visual style: {style}. Choose visual style","viewer.motion.live":"Live","viewer.motion.still":"Still","viewer.motion.pause":"Pause motion","viewer.motion.resume":"Resume motion","viewer.motion.reduced":"Motion paused by reduced-motion preference","viewer.motion.hidden":"Motion paused while this page is hidden","viewer.motion.yielding":"Pause motion; currently yielding to {owner}","viewer.motion.yielding.title":"Live preview enabled · yielding to {owner}","viewer.owner.story":"the guided story","viewer.owner.chapter":"the active chapter","viewer.owner.chapterPreview":"the chapter delta preview","viewer.owner.handoff":"the chapter handoff","viewer.owner.route":"Route Probe","viewer.owner.lens":"Semantic Lens","viewer.owner.relationship":"Relationship Preview","viewer.owner.intent":"Intent Trace","viewer.owner.focus":"semantic focus","viewer.owner.legend":"legend preview","viewer.owner.reader":"reader interaction","viewer.present.enter":"Enter presentation stage","viewer.present.enter.title":"Presentation stage (F)","viewer.present.exit":"Exit presentation stage","viewer.present.exit.title":"Exit presentation stage (F or Escape)","viewer.present.present":"Present","viewer.present.exit.label":"Exit","viewer.export.button":"Export","viewer.export.button.title":"Export diagram (E)","viewer.export.diagram":"Export diagram","viewer.export.menu":"Export","viewer.export.subtitle":"Portable, clean outputs","viewer.export.share":"Share","viewer.export.shareCard":"Share Card","viewer.export.routeShareCard":"Route Share Card","viewer.export.reachShareCard":"Reach Share Card","viewer.export.copyShareCard":"Copy Share Card","viewer.export.copyDiagram":"Copy diagram","viewer.export.clipboardPng":"PNG to clipboard","viewer.export.raster":"Raster images","viewer.export.image":"Image","viewer.export.lossless":"Lossless image","viewer.export.compact":"Compact image","viewer.export.modern":"Modern image","viewer.export.vectorMotion":"Vector and motion","viewer.export.vectorMotion.heading":"Vector \u0026 motion","viewer.export.editable":"Editable vector","viewer.export.motion6s":"6s motion","viewer.export.unsupported":"Not supported by this browser","viewer.export.clipboardUnsupported":"Clipboard image write not supported by this browser","viewer.export.clipboardUnsupported.period":"Clipboard image write not supported by this browser.","viewer.export.clipboardUnsupported.short":"Clipboard image write not supported in this browser.","viewer.export.motionUnavailable":"Motion capture unavailable in this browser","viewer.export.webmUnavailable":"WebM unavailable in this browser","viewer.export.failed":"Export failed: {message}","viewer.export.unknownVariant":"Unknown Share Card variant: {variant}","viewer.export.routeRequired":"Trace a route before exporting a Route Share Card","viewer.export.reachRequired":"Trace authored reach before exporting a Reach Share Card","viewer.export.unknown":"unknown","viewer.export.routeFailed":"Route Share Card export failed: {message}","viewer.export.reachFailed":"Reach Share Card export failed: {message}","viewer.export.copyFailed":"Copy failed: {message}","viewer.export.copiedPng":"Copied PNG to clipboard","viewer.export.copiedShare":"Copied Share Card","viewer.export.downloadedShare":"Downloaded Share Card","viewer.export.downloadedRoute":"Downloaded Route Share Card","viewer.export.downloadedReach":"Downloaded Reach Share Card","viewer.export.downloadedWebm":"Downloaded WebM","viewer.export.recording":"Recording 6 seconds of motion…","viewer.export.card.routeSummary.one":"Route: {source} → {target} · {count} directed hop","viewer.export.card.routeSummary.other":"Route: {source} → {target} · {count} directed hops","viewer.export.card.reachSummary":"Authored {direction} from {origin} · {nodes} · {links} · max {hops}","viewer.export.card.node.one":"{count} node","viewer.export.card.node.other":"{count} nodes","viewer.export.card.link.one":"{count} link","viewer.export.card.link.other":"{count} links","viewer.export.card.hop.one":"{count} hop","viewer.export.card.hop.other":"{count} hops","viewer.export.card.routeBadge":"ARCHIFY · ROUTE · {hops}","viewer.export.card.reachBadge":"ARCHIFY · {direction} REACH","viewer.export.card.defaultBadge":"ARCHIFY · {preset} · {theme}","viewer.export.direction.upstream":"Upstream","viewer.export.direction.downstream":"Downstream","viewer.export.error.canvasUnavailable":"Canvas unavailable for {label}","viewer.export.error.contextUnavailable":"2D canvas context unavailable for {label}","viewer.export.error.toBlobUnavailable":"canvas.toBlob unavailable for {label}","viewer.export.error.toBlobNull":"canvas.toBlob returned no data for {label}","viewer.export.error.variantsCombined":"Share Card variants cannot be combined","viewer.export.error.viewerState":"Share Card export could not remove temporary viewer state","viewer.export.error.routeState":"Route Card export could not preserve the resolved route safely","viewer.export.error.reachState":"Reach Card export could not preserve authored reach safely","viewer.export.error.webmRequirements":"WebM motion export requires a trace animation and browser MediaRecorder support","viewer.export.error.mediaRecorder":"MediaRecorder failed","viewer.export.error.emptyWebm":"MediaRecorder produced an empty WebM","viewer.export.error.webmBackground":"SVG background could not be loaded for WebM export","viewer.guided.region":"Guided diagram views","viewer.guided.previous":"Previous guided view","viewer.guided.previous.title":"Previous guided view ([)","viewer.guided.next":"Next guided view","viewer.guided.next.title":"Next guided view (])","viewer.guided.views":"Guided views","viewer.guided.explore":"Explore this system","viewer.guided.intro":"Step through curated paths without changing the source diagram.","viewer.guided.trail":"Story trail","viewer.guided.beat":"Beat","viewer.guided.nextBeat":"Next","viewer.guided.play":"Play guided story","viewer.guided.play.title":"Play guided story (P)","viewer.guided.pause":"Pause guided story","viewer.guided.pause.title":"Pause guided story (P)","viewer.guided.replay":"Replay guided story","viewer.guided.replay.title":"Replay guided story (P)","viewer.guided.playStory":"Play story","viewer.guided.pauseStory":"Pause","viewer.guided.replayStory":"Replay story","viewer.guided.motionUnavailable":"Story playback unavailable while motion is Still","viewer.guided.enableMotion":"Switch motion to Live to play the guided story","viewer.guided.selectBeatLink":"Select a Story Beat to copy its exact link","viewer.guided.copyMoment":"Copy moment","viewer.guided.momentCopied":"Moment link copied","viewer.guided.momentCopyFailed":"Could not copy story moment link","viewer.guided.copied":"Copied","viewer.guided.copyFailed":"Copy failed","viewer.guided.showAll":"Show all","viewer.guided.showAll.aria":"Show entire diagram","viewer.guided.chapters":"Story chapters","viewer.guided.storyTrail":"Story trail for {label}: {count} beats","viewer.guided.chapter.open":"Open chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.current":"Current chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.selectedNodes":"{count} selected nodes","viewer.guided.chapter.stops":"{count} stops","viewer.guided.chapter.stop.one":"{count} stop","viewer.guided.chapter.stop.other":"{count} stops","viewer.guided.chapter.current.title":"{label} — current chapter, {count} stops","viewer.guided.chapter.delta.expanded":"{stay} stay, {enter} enter, {leave} leave","viewer.guided.chapter.delta.aria":"Open chapter {index} of {total}: {label}. Chapter focus delta: {delta}","viewer.guided.chapter.delta.title":"{label} — {delta} chapter focus","viewer.guided.handoff":"{from} → {to} · via {label}","viewer.guided.share.chapter":"Chapter {index} / {total}","viewer.guided.share.initial":"Chapter 01 / 01","viewer.guided.share.default":"Guided chapter","viewer.guided.state.ready":"Ready","viewer.guided.state.playing":"Playing","viewer.guided.state.settled":"Settled","viewer.guided.state.paused":"Paused","viewer.guided.state.pinned":"Pinned","viewer.guided.state.still":"Still","viewer.guided.share.step":"Step {index} / {total} · {label}","viewer.guided.share.staticMoment":"{step} · Static moment","viewer.guided.share.complete":"{count} steps complete · {note}","viewer.guided.share.settled":"Path settled for reading.","viewer.guided.share.staticPath":"{count} steps · Static path","viewer.guided.share.ready":"{count} steps · Ready","viewer.guided.share.aria":"{state} chapter {index} of {total}: {label}. {beat}. {route}","viewer.guided.beat.start":"Beat {index} / {total} · {label} · starting point","viewer.guided.beat.forward":"Beat {index} / {total} · {from} → {to}","viewer.guided.beat.reverse":"Beat {index} / {total} · {from} → {to} · reverse authored link","viewer.guided.beat.multiple":"Beat {index} / {total} · {from} ⇄ {to} · {count} authored links","viewer.guided.beat.group":"Beat {index} / {total} · {from} · {to} · grouped · no direct link","viewer.guided.beat.aria.prefix":"Story beat {index} of {total}: {label}. ","viewer.guided.beat.aria.start":"Starting point.","viewer.guided.beat.aria.forward":"From {from} through one authored forward relationship.","viewer.guided.beat.aria.reverse":"From {from}; the authored relationship points from {to} to {from}.","viewer.guided.beat.aria.multiple":"From {from} through {count} authored relationships; shown without arbitrary motion.","viewer.guided.beat.aria.group":"Grouped from {from} with no direct authored relationship.","viewer.guided.caption.start":"Starting point","viewer.guided.caption.grouped":"Grouped transition · no direct authored link","viewer.guided.caption.more":" +{count} more","viewer.guided.caption.reverse":"Reverse authored relationship","viewer.guided.caption.relationships":"{count} authored relationships","viewer.guided.caption.relationship":"Authored relationship","viewer.guided.caption.direction":"authored direction: {from} → {to}","viewer.guided.caption.starting":"Authored starting point","viewer.guided.beatLink":"Copy link to current story moment: Beat {index} of {total}: {label}","viewer.guided.noStory":"This diagram has no authored guided story.","viewer.guide.eyebrow":"Diagram guide","viewer.guide.close":"Close diagram guide","viewer.guide.inspecting":"Inspecting compiled semantics","viewer.guide.actions":"Diagram exploration actions","viewer.guide.find":"Find any node","viewer.guide.find.hint":"Search labels, responsibilities, kinds, and stable IDs.","viewer.guide.route":"Trace a route","viewer.guide.route.aria":"Trace a directed route","viewer.guide.route.hint":"Ask how two semantic nodes connect in authored direction.","viewer.guide.map":"See the whole system","viewer.guide.map.hint":"Open Semantic Radar with a live viewport and stable nodes.","viewer.guide.lens":"Compare semantic kinds","viewer.guide.lens.hint":"Count roles, reveal their traffic, and compare direct authored links.","viewer.guide.story":"Play the guided story","viewer.guide.story.hint":"Walk the authored chapters and real relationships.","viewer.guide.present":"Enter Presentation Stage","viewer.guide.present.hint":"Give the live diagram the viewport without changing export.","viewer.guide.shortcuts":"Additional keyboard shortcuts","viewer.guide.shortcut.export":"Export","viewer.guide.shortcut.theme":"Theme","viewer.guide.shortcut.style":"Style","viewer.guide.shortcut.reset":"Reset","viewer.guide.shortcut.zoomIn":"Zoom in","viewer.guide.shortcut.zoomOut":"Zoom out","viewer.guide.shortcut.close":"Close","viewer.guide.facts":"{nodes} · {relationships} · {views}","viewer.guide.fact.node.one":"{count} semantic node","viewer.guide.fact.node.other":"{count} semantic nodes","viewer.guide.fact.relationship.one":"{count} relationship","viewer.guide.fact.relationship.other":"{count} relationships","viewer.guide.fact.view.one":"{count} guided view","viewer.guide.fact.view.other":"{count} guided views","viewer.guide.story.available.one":"Walk {count} authored chapter and its real relationships.","viewer.guide.story.available.other":"Walk {count} authored chapters and their real relationships.","viewer.guide.story.unavailable":"No authored guided story in this diagram.","viewer.guide.open":"Open diagram guide","viewer.guide.noStory":"This diagram has no authored guided story.","viewer.finder.title":"Find a node","viewer.finder.close":"Close node finder","viewer.finder.placeholder":"Search labels or IDs","viewer.finder.search":"Search diagram nodes","viewer.finder.results":"Diagram nodes","viewer.finder.empty":"No matching nodes","viewer.finder.result.focus":"Focus {label}","viewer.finder.result.routeStart":"Choose {label} as route start","viewer.finder.result.routeTarget":"Choose {label} as route destination, {links}","viewer.finder.status.empty":"No matching nodes","viewer.finder.status.count.one":"{count} matching node","viewer.finder.status.count.other":"{count} matching nodes","viewer.finder.noun.nodes":"nodes","viewer.finder.link.one":"{count} link","viewer.finder.link.other":"{count} links","viewer.finder.result.focus.one":"Focus {label}, {count} related connection","viewer.finder.result.focus.other":"Focus {label}, {count} related connections","viewer.finder.status.filtered":"{visible} of {available} {noun}","viewer.finder.status.all":"{available} {noun}","viewer.passport.eyebrow":"Semantic passport","viewer.passport.metadata":"Node metadata","viewer.passport.evidence":"Verified source evidence","viewer.passport.verified":"Verified source","viewer.passport.reach":"Authored reach","viewer.passport.reach.trace":"Trace authored reachability","viewer.passport.upstream":"Upstream","viewer.passport.downstream":"Downstream","viewer.passport.upstream.trace":"Trace upstream authored reachability","viewer.passport.downstream.trace":"Trace downstream authored reachability","viewer.passport.close":"Close semantic passport","viewer.passport.copy":"Copy link","viewer.passport.copy.focus":"Copy link to focused node","viewer.passport.relations":"Relations","viewer.passport.relations.show":"Show connected relationships","viewer.passport.relations.hide":"Hide connected relationships","viewer.passport.relations.list":"Connected relationships","viewer.passport.copyRelation":"Copy relation","viewer.passport.copyNode":"Copy node","viewer.passport.copyPinned":"Copy link to pinned relationship","viewer.passport.copySource":"Copy link to source node","viewer.passport.copy.focused.success":"Focused node link copied","viewer.passport.copy.pinned.success":"Pinned relationship link copied","viewer.passport.copy.focused.failed":"Could not copy focused node link","viewer.passport.copy.pinned.failed":"Could not copy pinned relationship link","viewer.passport.relationship.none":"No connected relationships","viewer.passport.relationship.count.one":"{count} relation","viewer.passport.relationship.count.other":"{count} relations","viewer.passport.relationship.show.one":"Show {count} connected relationship","viewer.passport.relationship.show.other":"Show {count} connected relationships","viewer.passport.relationship.summary":"{out} outgoing · {in} incoming{loops}","viewer.passport.relationship.loops":" · {count} loop","viewer.passport.relationship.explorer":"Direct relationship explorer","viewer.passport.relationship.help":"Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.","viewer.passport.relationship.loopsBack":"loops back","viewer.passport.relationship.connectsTo":"connects to","viewer.passport.relationship.connectsFrom":"connects from","viewer.passport.relationship.pinned":"Pinned relationship · {from} → {to} · {label}","viewer.passport.relationship.inspect":"Inspect relationship {index} of {total}: {from} to {to}, {label}. Press Enter for details.","viewer.passport.relationship.group.out":"Outgoing","viewer.passport.relationship.group.in":"Incoming","viewer.passport.relationship.group.loop":"Self loops","viewer.passport.relationship.row":"{group}: {relationship}, {neighbor}","viewer.passport.relationship.direction.out":"OUT →","viewer.passport.relationship.direction.in":"← IN","viewer.passport.relationship.direction.loop":"LOOP","viewer.passport.sourceCount.one":"{count} verified source reference","viewer.passport.sourceCount.other":"{count} verified source references","viewer.passport.sourceMarker":"SRC","viewer.passport.beacon.one":"{count} verified source; focus this node to inspect","viewer.passport.beacon.other":"{count} verified sources; focus this node to inspect","viewer.passport.repository.open":"Open verified repository revision {revision}","viewer.passport.source.open":"Open verified source {path} at revision {revision}","viewer.passport.source.openLink":"Open ↗","viewer.passport.reach.upstream.one":"Trace {count} upstream authored node","viewer.passport.reach.upstream.other":"Trace {count} upstream authored nodes","viewer.passport.reach.downstream.one":"Trace {count} downstream authored node","viewer.passport.reach.downstream.other":"Trace {count} downstream authored nodes","viewer.passport.reach.noUpstream":"No upstream authored nodes","viewer.passport.reach.noDownstream":"No downstream authored nodes","viewer.passport.reach.status":"{direction} · {nodes} nodes · {links} links · max {hops} hops","viewer.route.eyebrow":"Route probe","viewer.route.start":"Choose a start node","viewer.route.start.find":"Find start","viewer.route.start.find.aria":"Find a route start","viewer.route.copy":"Copy link","viewer.route.copy.aria":"Copy link to traced route","viewer.route.clear":"Clear","viewer.route.clear.aria":"Clear route probe","viewer.route.traced":"Traced route","viewer.route.pickTwo":"Pick two semantic nodes on the diagram","viewer.route.pickOne":"Pick a semantic node on the diagram","viewer.route.controls":"Route journey controls","viewer.route.previous":"Previous route position","viewer.route.play":"Play route journey","viewer.route.pause":"Pause route journey","viewer.route.replay":"Replay route journey","viewer.route.next":"Next route position","viewer.route.journey":"Journey","viewer.route.pause.label":"Pause","viewer.route.replay.label":"Replay","viewer.route.overview":"Overview","viewer.route.overview.aria":"Show complete route overview","viewer.route.instructions":"Choose the source, then the destination. Direction matters.","viewer.route.destination":"Choose a destination from {label}","viewer.route.destination.find":"Find target","viewer.route.destination.find.aria":"Find a reachable route destination","viewer.route.differentDestination":"Choose a different destination","viewer.route.distinct":"A route needs two distinct semantic nodes.","viewer.route.unreachable":"No directed route to {label}","viewer.route.unreachable.detail":"{target} is not reachable from {source}. Pick a highlighted destination.","viewer.route.start.instructions":"Select the source. The next step will reveal only directed destinations.","viewer.route.copy.success":"Traced route link copied","viewer.route.copy.failed":"Could not copy traced route link","viewer.route.position":"Route position {index} of {total}: {label}","viewer.route.step":"Step {index} of {total} · {phase} · {label}","viewer.route.motionRequired":"Automatic journey requires Live motion","viewer.route.trigger.clear":"Clear traced route","viewer.route.overview.status":"{nodes} · {hops} · shortest authored route","viewer.route.overview.node.one":"{count} node","viewer.route.overview.node.other":"{count} nodes","viewer.route.overview.hop.one":"{count} directed hop","viewer.route.overview.hop.other":"{count} directed hops","viewer.route.phase.playing":"Playing","viewer.route.phase.complete":"Complete","viewer.route.phase.inspecting":"Inspecting","viewer.route.destination.count.one":"{count} directed destination available. Pick a highlighted node.","viewer.route.destination.count.other":"{count} directed destinations available. Pick a highlighted node.","viewer.route.noOutgoing":"No outgoing route starts here. Clear and choose another source.","viewer.route.result.title":"{source} to {target}","viewer.route.finder.source.title":"Choose route start","viewer.route.finder.source.placeholder":"Search route sources","viewer.route.finder.source.empty":"No matching route sources","viewer.route.finder.source.results":"Nodes that can start a route","viewer.route.finder.source.noun":"route sources","viewer.route.finder.source.badge":"start","viewer.route.finder.target.title":"Destination from {label}","viewer.route.finder.target.placeholder":"Search reachable destinations","viewer.route.finder.target.empty":"No matching reachable destinations","viewer.route.finder.target.results":"Reachable route destinations","viewer.route.finder.target.noun":"reachable destinations","viewer.route.hop.one":"{count} hop","viewer.route.hop.other":"{count} hops","viewer.lens.eyebrow":"Semantic lens","viewer.lens.title":"Compare system roles","viewer.lens.close":"Close semantic lens","viewer.lens.instruction":"Choose up to two semantic kinds. One reveals its real traffic; two compare only direct authored relationships.","viewer.lens.kinds":"Semantic kinds","viewer.lens.choose":"Choose a kind to inspect its nodes and touching relationships.","viewer.lens.copy":"Copy link to semantic lens","viewer.lens.clear":"Clear semantic lens","viewer.lens.open":"Open semantic lens","viewer.lens.openActive":"Open active semantic lens","viewer.lens.legend":"Semantic legend","viewer.lens.legend.inspect.one":"Inspect {label}, {count} node","viewer.lens.legend.inspect.other":"Inspect {label}, {count} nodes","viewer.lens.kind.count.one":"{label}, {count} node","viewer.lens.kind.count.other":"{label}, {count} nodes","viewer.lens.compare.one":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationship","viewer.lens.compare.other":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationships","viewer.lens.single":"{nodes} · {relationships} · connected peers remain visible","viewer.lens.node.one":"{count} {label} node","viewer.lens.node.other":"{count} {label} nodes","viewer.lens.relationship.one":"{count} touching relationship","viewer.lens.relationship.other":"{count} touching relationships","viewer.radar.title":"Semantic radar","viewer.radar.building":"Building overview","viewer.radar.openFull":"Open full semantic radar","viewer.radar.open":"Open radar","viewer.radar.close":"Close semantic radar","viewer.radar.surface":"Diagram overview. Click a node to focus it, or use arrow keys to pan.","viewer.radar.click":"Click node","viewer.radar.drag":"Drag to pan","viewer.radar.space":"Semantic radar needs more MAP space.","viewer.radar.nodes":"Semantic diagram radar nodes","viewer.radar.focus":"Focus {label} from Semantic Radar","viewer.radar.status":"{count} nodes · {viewport}","viewer.radar.fullMap":"{count} nodes · full map","viewer.radar.compacted":"Radar compacted to avoid covering the Semantic Passport or MAP controls.","viewer.radar.cancelWaiting":"Cancel semantic radar waiting for more MAP space","viewer.radar.needsSpace":"Semantic radar needs more visible MAP space","viewer.radar.viewport.full":"full map","viewer.radar.viewport.width":"{percent}% width","viewer.radar.viewport.scale":"{percent}% viewport","viewer.nav.controls":"Diagram view controls","viewer.nav.route":"Trace a directed route","viewer.nav.route.title":"Trace route (R)","viewer.nav.route.short":"PATH","viewer.nav.radar":"Open semantic radar","viewer.nav.radar.title":"Semantic radar (M)","viewer.nav.radar.short":"MAP","viewer.nav.lens":"Open semantic lens","viewer.nav.lens.title":"Semantic lens (L)","viewer.nav.lens.short":"LENS","viewer.nav.find":"Find a node","viewer.nav.find.title":"Find a node (/)","viewer.nav.guide":"Open diagram guide","viewer.nav.guide.title":"Diagram guide (?)","viewer.nav.zoomOut":"Zoom out","viewer.nav.zoomOut.title":"Zoom out (-)","viewer.nav.reset":"Reset diagram view","viewer.nav.reset.title":"Reset view (0)","viewer.nav.read":"READ","viewer.nav.zoomIn":"Zoom in","viewer.nav.zoomIn.title":"Zoom in (+)","viewer.nav.camera":"{hint}. Reset diagram view","viewer.nav.camera.title":"{semantic}{hint} · reset view (0)","viewer.nav.camera.semantic":"Semantic camera active · ","viewer.nav.level.map":"MAP","viewer.nav.level.read":"READ","viewer.nav.level.full":"FULL","viewer.nav.level.auto":"AUTO","viewer.nav.detail.map":"Zoom in to reveal relationship labels and node context","viewer.nav.detail.read":"Zoom in again to reveal tags and annotations","viewer.nav.detail.full":"Full diagram detail","viewer.intent.summary":"{label}. {out} outgoing, {in} incoming{loops}. {total} connections. Press Enter for details.","viewer.intent.loops":", {count} self loop","viewer.common.copied":"Copied","viewer.common.copyFailed":"Copy failed","viewer.common.copyLink":"Copy link","viewer.common.clear":"Clear","viewer.common.close":"Close"}}</script>
<div class="guided-views no-print" id="guided-views" hidden aria-label="Guided diagram views">
<button id="guided-view-prev" type="button" aria-label="Previous guided view" title="Previous guided view ([)">&#8592;</button>
<div class="guided-view-copy">
@@ -4912,8 +5003,9 @@
</div>
<!-- Main Diagram -->
- <div class="diagram-container" data-detail-level="read">
- <svg viewBox="0 0 1064 356" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
+ <div class="diagram-container" data-detail-level="read"
+ data-preset-badge-editorial-plate="ARCHIFY / PLATE 04">
+ <svg viewBox="0 0 1064 356" role="img" lang="en" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
<title id="archify-diagram-title">Archify Pipeline</title>
<desc id="archify-diagram-description">Grid placement demo — row/col instead of manual pos</desc>
<!-- Definitions -->
@@ -5076,7 +5168,7 @@
<!-- Boundary labels (foreground masks keep routes out of titles) -->
<g data-graph-role="structural-frame-label" data-composition-frame-id="0" data-composition-frame-kind="region" data-composition-frame-label="archify/ skill package">
<rect data-graph-role="structural-frame-label-mask" x="302" y="80" width="128.8" height="16" rx="3" class="c-mask"/>
- <text x="306" y="93" class="t-cloud" font-size="9" font-weight="600">archify/ skill package</text>
+ <text data-boundary-label="" x="306" y="93" class="t-cloud" font-size="9" font-weight="600">archify/ skill package</text>
</g>
<!-- Legend -->
@@ -5272,11 +5364,13 @@
<strong id="overview-map-title">Semantic radar</strong>
<small id="overview-map-status" aria-live="polite">Building overview</small>
</span>
+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button>
<button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">&#215;</button>
</div>
<div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div>
<div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div>
</div>
+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p>
<div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls">
<button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button>
<button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>
@@ -5308,6 +5402,37 @@
<script>
var Archify = {};
+ var archifyI18nData = (function () {
+ var node = document.getElementById('archify-i18n-data');
+ try { return JSON.parse(node ? node.textContent : '{}'); }
+ catch (_) { return { locale: 'en', messages: {} }; }
+ })();
+ Archify.locale = archifyI18nData.locale || 'en';
+
+ function viewerText(key, values) {
+ var messages = archifyI18nData.messages || {};
+ var template = Object.prototype.hasOwnProperty.call(messages, key) ? messages[key] : key;
+ return String(template).replace(/\{([a-zA-Z0-9_]+)\}/g, function (match, name) {
+ return values && Object.prototype.hasOwnProperty.call(values, name) ? String(values[name]) : match;
+ });
+ }
+
+ function viewerCount(key, count, values) {
+ var suffix = Number(count) === 1 ? '.one' : '.other';
+ var payload = Object.assign({}, values || {}, { count: count });
+ return viewerText(key + suffix, payload);
+ }
+
+ function viewerKindLabel(value) {
+ var normalized = String(value || 'node').toLowerCase();
+ var knownKey = 'viewer.kind.' + normalized;
+ var known = viewerText(knownKey);
+ if (known !== knownKey) return known;
+ return normalized
+ .replace(/messagebus/gi, 'message bus')
+ .replace(/[-_]+/g, ' ')
+ .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
+ }
function hasDrawableGeometry(element) {
if (!element) return false;
@@ -5338,7 +5463,12 @@
============================================================ */
Archify.preset = (function () {
var PRESETS = ['classic', 'signal-flow', 'blueprint', 'editorial'];
- var LABELS = { classic: 'Classic', 'signal-flow': 'Flow', blueprint: 'Blueprint', editorial: 'Editorial' };
+ var LABELS = {
+ classic: viewerText('viewer.preset.classic.short'),
+ 'signal-flow': viewerText('viewer.preset.flow.short'),
+ blueprint: viewerText('viewer.preset.blueprint'),
+ editorial: viewerText('viewer.preset.editorial')
+ };
var html = document.documentElement;
var svg = document.querySelector('.diagram-container svg');
var btn = document.getElementById('btn-preset');
@@ -5365,8 +5495,8 @@
svg.setAttribute('data-preset', preset);
btn.setAttribute('data-preset-option', preset);
label.textContent = LABELS[preset];
- btn.setAttribute('aria-label', 'Visual style: ' + LABELS[preset] + '. Choose visual style');
- btn.title = 'Choose visual style (S cycles)';
+ btn.setAttribute('aria-label', viewerText('viewer.preset.current', { style: LABELS[preset] }));
+ btn.title = viewerText('viewer.preset.choose.title');
options().forEach(function (option) {
var selected = option.getAttribute('data-preset-value') === preset;
option.setAttribute('aria-checked', String(selected));
@@ -5478,7 +5608,7 @@
function apply(theme) {
html.setAttribute('data-theme', theme);
- label.textContent = theme === 'dark' ? 'Dark' : 'Light';
+ label.textContent = viewerText(theme === 'dark' ? 'viewer.theme.dark' : 'viewer.theme.light');
btn.setAttribute('aria-pressed', theme === 'light' ? 'true' : 'false');
}
@@ -5527,6 +5657,18 @@
var SHARE_CARD_PADDING = 36;
var SHARE_CARD_HEADER = 112;
+ function exportError(key, values) {
+ var error = new Error(viewerText(key, values));
+ error.archifyViewerMessage = true;
+ return error;
+ }
+
+ function exportMessage(error) {
+ return error && error.archifyViewerMessage
+ ? error.message
+ : viewerText('viewer.export.unknown');
+ }
+
function diagramFilename() {
var title = (document.title || 'diagram')
.replace(/\s+Architecture(\s+Diagram)?$/i, '')
@@ -5729,6 +5871,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -5903,6 +6046,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -6122,7 +6266,7 @@
format === 'webp' ? 'image/webp' : 'image/png';
var quality = format === 'png' ? undefined : 0.95;
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for ' + format));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: format }));
else resolve(blob);
}, mime, quality);
} catch (error) {
@@ -6158,11 +6302,11 @@
function canvas2dOrThrow(canvas, label) {
if (!canvas || typeof canvas.getContext !== 'function') {
- throw new Error('Canvas unavailable for ' + label);
+ throw exportError('viewer.export.error.canvasUnavailable', { label: label });
}
var ctx = canvas.getContext('2d');
- if (!ctx) throw new Error('2D canvas context unavailable for ' + label);
- if (typeof canvas.toBlob !== 'function') throw new Error('canvas.toBlob unavailable for ' + label);
+ if (!ctx) throw exportError('viewer.export.error.contextUnavailable', { label: label });
+ if (typeof canvas.toBlob !== 'function') throw exportError('viewer.export.error.toBlobUnavailable', { label: label });
return ctx;
}
@@ -6170,14 +6314,14 @@
options = options || {};
var routeSnapshot = options.routeSnapshot || null;
var reachSnapshot = options.reachSnapshot || null;
- if (routeSnapshot && reachSnapshot) return Promise.reject(new Error('Share Card variants cannot be combined'));
+ if (routeSnapshot && reachSnapshot) return Promise.reject(exportError('viewer.export.error.variantsCombined'));
var svg = document.querySelector('.diagram-container svg');
var vb = svg.viewBox.baseVal;
var sourceScale = Math.min(2, pickSafeScale(vb.width, vb.height));
var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot, reachSnapshot: reachSnapshot });
- if (!data.canonicalStateClean) return Promise.reject(new Error('Share Card export could not remove temporary viewer state'));
- if (routeSnapshot && !data.routeStateClean) return Promise.reject(new Error('Route Card export could not preserve the resolved route safely'));
- if (reachSnapshot && !data.reachStateClean) return Promise.reject(new Error('Reach Card export could not preserve authored reach safely'));
+ if (!data.canonicalStateClean) return Promise.reject(exportError('viewer.export.error.viewerState'));
+ if (routeSnapshot && !data.routeStateClean) return Promise.reject(exportError('viewer.export.error.routeState'));
+ if (reachSnapshot && !data.reachStateClean) return Promise.reject(exportError('viewer.export.error.reachState'));
var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });
var svgUrl = URL.createObjectURL(svgBlob);
@@ -6188,7 +6332,7 @@
var canvas = document.createElement('canvas');
canvas.width = SHARE_CARD_WIDTH;
canvas.height = SHARE_CARD_HEIGHT;
- var ctx = canvas2dOrThrow(canvas, 'Share Card');
+ var ctx = canvas2dOrThrow(canvas, viewerText('viewer.export.shareCard'));
var computed = getComputedStyle(document.documentElement);
var bg = computed.getPropertyValue('--bg').trim() || currentBg();
var text = computed.getPropertyValue('--text').trim() || '#ffffff';
@@ -6201,21 +6345,37 @@
var titleNode = document.querySelector('.header h1');
var subtitleNode = document.querySelector('.header .subtitle');
var title = titleNode ? titleNode.textContent : document.title;
+ var directionLabel = reachSnapshot
+ ? viewerText('viewer.export.direction.' + reachSnapshot.direction)
+ : '';
var subtitle = routeSnapshot
- ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'
+ ? viewerCount('viewer.export.card.routeSummary', routeSnapshot.hops, {
+ source: routeSnapshot.source.label,
+ target: routeSnapshot.target.label
+ })
: reachSnapshot
- ? 'Authored ' + reachSnapshot.direction + ' from ' + reachSnapshot.origin.label + ' · ' +
- (reachSnapshot.nodeIds.length - 1) + ' nodes · ' + reachSnapshot.edges.length +
- ' links · max ' + reachSnapshot.maxDepth + ' hops'
+ ? viewerText('viewer.export.card.reachSummary', {
+ direction: directionLabel,
+ origin: reachSnapshot.origin.label,
+ nodes: viewerCount('viewer.export.card.node', reachSnapshot.nodeIds.length - 1),
+ links: viewerCount('viewer.export.card.link', reachSnapshot.edges.length),
+ hops: viewerCount('viewer.export.card.hop', reachSnapshot.maxDepth)
+ })
: subtitleNode ? subtitleNode.textContent : '';
var preset = document.documentElement.getAttribute('data-preset') || 'classic';
var theme = document.documentElement.getAttribute('data-theme') || 'dark';
- var presetLabel = preset === 'signal-flow' ? 'FLOW' : preset.toUpperCase();
+ var presetKey = preset === 'signal-flow'
+ ? 'viewer.preset.flow.short'
+ : 'viewer.preset.' + preset;
+ var presetLabel = viewerText(presetKey).toUpperCase();
+ var themeLabel = viewerText('viewer.theme.' + theme).toUpperCase();
var cardLabel = routeSnapshot
- ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'
+ ? viewerText('viewer.export.card.routeBadge', {
+ hops: viewerCount('viewer.export.card.hop', routeSnapshot.hops).toUpperCase()
+ })
: reachSnapshot
- ? 'ARCHIFY · ' + reachSnapshot.direction.toUpperCase() + ' REACH'
- : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();
+ ? viewerText('viewer.export.card.reachBadge', { direction: directionLabel.toUpperCase() })
+ : viewerText('viewer.export.card.defaultBadge', { preset: presetLabel, theme: themeLabel });
ctx.fillStyle = bg;
ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);
@@ -6253,7 +6413,7 @@
URL.revokeObjectURL(svgUrl);
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for Share Card'));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: viewerText('viewer.export.shareCard') }));
else resolve(blob);
}, 'image/png');
} catch (error) {
@@ -6273,17 +6433,17 @@
options = options || {};
if (!options.variant) return renderShareCard();
if (options.variant !== 'route' && options.variant !== 'reach') {
- return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));
+ return Promise.reject(exportError('viewer.export.unknownVariant', { variant: options.variant }));
}
if (options.variant === 'route') {
var routeSnapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
- if (!routeSnapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ if (!routeSnapshot) return Promise.reject(exportError('viewer.export.routeRequired'));
return renderShareCard({ routeSnapshot: routeSnapshot });
}
var snapshot = Archify.focus && typeof Archify.focus.reachabilitySnapshot === 'function'
? Archify.focus.reachabilitySnapshot()
: null;
- if (!snapshot) return Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ if (!snapshot) return Promise.reject(exportError('viewer.export.reachRequired'));
return renderShareCard({ reachSnapshot: snapshot });
}
@@ -6317,7 +6477,7 @@
function recordWebm(options) {
options = options || {};
if (!canRecordMotion()) {
- return Promise.reject(new Error('WebM motion export requires a trace animation and browser MediaRecorder support'));
+ return Promise.reject(exportError('viewer.export.error.webmRequirements'));
}
var duration = Math.max(250, Number(options.duration) || MOTION_DURATION);
var fps = Math.max(1, Number(options.fps) || MOTION_FPS);
@@ -6515,12 +6675,12 @@
};
recorder.onerror = function (event) {
cleanup();
- reject(event.error || new Error('MediaRecorder failed'));
+ reject(event.error || exportError('viewer.export.error.mediaRecorder'));
};
recorder.onstop = function () {
cleanup();
var blob = new Blob(chunks, { type: recorder.mimeType || mime });
- if (!blob.size) reject(new Error('MediaRecorder produced an empty WebM'));
+ if (!blob.size) reject(exportError('viewer.export.error.emptyWebm'));
else resolve(blob);
};
drawMotionFrame(ctx, backgroundImage, motionScene, 0);
@@ -6541,7 +6701,7 @@
};
backgroundImage.onerror = function () {
URL.revokeObjectURL(sourceUrl);
- reject(new Error('SVG background could not be loaded for WebM export'));
+ reject(exportError('viewer.export.error.webmBackground'));
};
backgroundImage.src = sourceUrl;
});
@@ -6599,11 +6759,11 @@
items().forEach(function (it) {
if (it.dataset.format && !supports(it.dataset.format)) {
it.disabled = true;
- it.title = 'Not supported by this browser';
+ it.title = viewerText('viewer.export.unsupported');
}
if ((it.dataset.action === 'copy' || it.dataset.action === 'copy-share-card') && !canCopyImage()) {
it.disabled = true;
- it.title = 'Clipboard image write not supported by this browser';
+ it.title = viewerText('viewer.export.clipboardUnsupported');
}
});
@@ -6694,12 +6854,12 @@
var base = diagramFilename();
close(true);
clearExportReceipt();
- if (format === 'webm') toast('Recording 6 seconds of motion…');
+ if (format === 'webm') toast(viewerText('viewer.export.recording'));
return (format === 'share-card'
? rasterizeShareCard().then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
download(blob, base + '-share-card.png');
- toast('Downloaded Share Card');
+ toast(viewerText('viewer.export.downloadedShare'));
})
: format === 'svg'
? Promise.resolve(serializeSvg(1, { autoTheme: true })).then(function (d) {
@@ -6712,7 +6872,7 @@
document.documentElement.setAttribute('data-last-motion-bytes', String(blob.size));
recordExportReceipt('webm', blob, true);
download(blob, base + '.webm');
- toast('Downloaded WebM');
+ toast(viewerText('viewer.export.downloadedWebm'));
})
: rasterize(format).then(function (blob) {
recordExportReceipt(format, blob, true);
@@ -6720,20 +6880,21 @@
})
).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : format;
+ var technicalMessage = err && err.message ? err.message : format;
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', format);
- document.documentElement.setAttribute('data-last-export-error', message);
- if (format === 'webm' && /MediaRecorder|WebM motion export|empty WebM/i.test(message)) {
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ if (format === 'webm') {
var motionItem = menu.querySelector('button[data-format="webm"]');
if (motionItem) {
motionItem.disabled = true;
- motionItem.title = 'Motion capture unavailable in this browser';
+ motionItem.title = viewerText('viewer.export.motionUnavailable');
motionItem.style.opacity = '0.5';
}
- toast('WebM unavailable in this browser');
+ toast(viewerText('viewer.export.webmUnavailable'));
return;
}
- alert('Export failed: ' + message);
+ alert(viewerText('viewer.export.failed', { message: message }));
});
}
@@ -6743,18 +6904,19 @@
var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
var blobPromise = snapshot
? renderShareCard({ routeSnapshot: snapshot })
- : Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ : Promise.reject(exportError('viewer.export.routeRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'route', true);
download(blob, diagramFilename() + '-route-share-card.png');
- toast('Downloaded Route Share Card');
+ toast(viewerText('viewer.export.downloadedRoute'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Route Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.routeFailed', { message: message }));
});
}
@@ -6766,18 +6928,19 @@
: null;
var blobPromise = snapshot
? renderShareCard({ reachSnapshot: snapshot })
- : Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ : Promise.reject(exportError('viewer.export.reachRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'reach', false, true);
download(blob, diagramFilename() + '-' + snapshot.direction + '-reach-share-card.png');
- toast('Downloaded Reach Share Card');
+ toast(viewerText('viewer.export.downloadedReach'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Reach Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.reachFailed', { message: message }));
});
}
@@ -6842,21 +7005,22 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported by this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.period'));
return;
}
var blobPromise = rasterizeShareCard();
return writePngToClipboard(blobPromise).then(function () {
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
- toast('Copied Share Card');
+ toast(viewerText('viewer.export.copiedShare'));
});
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'unknown';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Copy failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.copyFailed', { message: message }));
});
}
@@ -6864,15 +7028,17 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported in this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.short'));
return;
}
var blobPromise = rasterize('png');
return writePngToClipboard(blobPromise).then(function () {
- toast('Copied PNG to clipboard');
+ toast(viewerText('viewer.export.copiedPng'));
}).catch(function (err) {
console.error(err);
- alert('Copy failed: ' + (err && err.message ? err.message : 'unknown'));
+ alert(viewerText('viewer.export.copyFailed', {
+ message: exportMessage(err)
+ }));
});
}
@@ -6998,17 +7164,17 @@
return readerPaused || reducedMotion() || hasSuspension();
}
function ownerLabel(value) {
- if (value === 'story') return 'the guided story';
- if (value === 'chapter') return 'the active chapter';
- if (value === 'chapter-preview') return 'the chapter delta preview';
- if (value === 'handoff') return 'the chapter handoff';
- if (value === 'route') return 'Route Probe';
- if (value === 'lens') return 'Semantic Lens';
- if (value === 'relationship') return 'Relationship Preview';
- if (value === 'intent') return 'Intent Trace';
- if (value === 'focus') return 'semantic focus';
- if (value === 'legend') return 'legend preview';
- return 'reader interaction';
+ if (value === 'story') return viewerText('viewer.owner.story');
+ if (value === 'chapter') return viewerText('viewer.owner.chapter');
+ if (value === 'chapter-preview') return viewerText('viewer.owner.chapterPreview');
+ if (value === 'handoff') return viewerText('viewer.owner.handoff');
+ if (value === 'route') return viewerText('viewer.owner.route');
+ if (value === 'lens') return viewerText('viewer.owner.lens');
+ if (value === 'relationship') return viewerText('viewer.owner.relationship');
+ if (value === 'intent') return viewerText('viewer.owner.intent');
+ if (value === 'focus') return viewerText('viewer.owner.focus');
+ if (value === 'legend') return viewerText('viewer.owner.legend');
+ return viewerText('viewer.owner.reader');
}
function render() {
if (!capable) return;
@@ -7022,7 +7188,7 @@
}
btn.setAttribute('aria-pressed', paused ? 'false' : 'true');
btn.disabled = systemPaused;
- label.textContent = paused ? 'Still' : 'Live';
+ label.textContent = viewerText(paused ? 'viewer.motion.still' : 'viewer.motion.live');
if (paused && lastEffectivePaused !== true && Archify.guidedViews && Archify.guidedViews.isPlaying()) {
Archify.guidedViews.pause();
}
@@ -7035,20 +7201,20 @@
lastEffectivePaused = paused;
if (Archify.routeProbe && typeof Archify.routeProbe.syncMotion === 'function') Archify.routeProbe.syncMotion();
if (systemPaused) {
- btn.setAttribute('aria-label', 'Motion paused by reduced-motion preference');
- btn.title = 'Motion paused by reduced-motion preference';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.reduced'));
+ btn.title = viewerText('viewer.motion.reduced');
} else if (hasSuspension()) {
- btn.setAttribute('aria-label', 'Motion paused while this page is hidden');
- btn.title = 'Motion paused while this page is hidden';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.hidden'));
+ btn.title = viewerText('viewer.motion.hidden');
} else if (paused) {
- btn.setAttribute('aria-label', 'Resume motion');
- btn.title = 'Resume motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.resume'));
+ btn.title = viewerText('viewer.motion.resume');
} else if (owner) {
- btn.setAttribute('aria-label', 'Pause motion; currently yielding to ' + ownerLabel(owner));
- btn.title = 'Live preview enabled · yielding to ' + ownerLabel(owner);
+ btn.setAttribute('aria-label', viewerText('viewer.motion.yielding', { owner: ownerLabel(owner) }));
+ btn.title = viewerText('viewer.motion.yielding.title', { owner: ownerLabel(owner) });
} else {
- btn.setAttribute('aria-label', 'Pause motion');
- btn.title = 'Pause motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.pause'));
+ btn.title = viewerText('viewer.motion.pause');
}
}
function setPaused(next, options) {
@@ -7219,7 +7385,7 @@
if (!box || !Number.isFinite(box.x) || !Number.isFinite(box.y) || !Number.isFinite(box.width) || box.width < 36) return;
var count = sources.length;
- var label = count + ' verified source' + (count === 1 ? '' : 's') + '; focus this node to inspect';
+ var label = viewerCount('viewer.passport.beacon', count);
var beacon = document.createElementNS(svgNamespace, 'g');
beacon.classList.add('source-evidence-beacon');
beacon.setAttribute('data-source-evidence-beacon', '');
@@ -7235,7 +7401,7 @@
var text = document.createElementNS(svgNamespace, 'text');
text.setAttribute('x', '15');
text.setAttribute('y', '8.25');
- text.textContent = 'SRC ' + count;
+ text.textContent = viewerText('viewer.passport.sourceMarker') + ' ' + count;
beacon.appendChild(title);
beacon.appendChild(plate);
beacon.appendChild(text);
@@ -7244,7 +7410,7 @@
var originalLabel = node.getAttribute('aria-label') || '';
node.setAttribute('data-source-evidence-count', String(count));
node.setAttribute('data-source-evidence-original-label', originalLabel);
- node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + count + ' verified source reference' + (count === 1 ? '' : 's'));
+ node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + viewerCount('viewer.passport.sourceCount', count));
installed += 1;
});
return installed;
@@ -7422,11 +7588,11 @@
upstreamBtn.disabled = upstreamReach === 0;
downstreamBtn.disabled = downstreamReach === 0;
upstreamBtn.setAttribute('aria-label', upstreamReach
- ? 'Trace ' + upstreamReach + ' upstream authored node' + (upstreamReach === 1 ? '' : 's')
- : 'No upstream authored nodes');
+ ? viewerCount('viewer.passport.reach.upstream', upstreamReach)
+ : viewerText('viewer.passport.reach.noUpstream'));
downstreamBtn.setAttribute('aria-label', downstreamReach
- ? 'Trace ' + downstreamReach + ' downstream authored node' + (downstreamReach === 1 ? '' : 's')
- : 'No downstream authored nodes');
+ ? viewerCount('viewer.passport.reach.downstream', downstreamReach)
+ : viewerText('viewer.passport.reach.noDownstream'));
reachSection.hidden = false;
}
function applyReachability(direction, options) {
@@ -7472,11 +7638,15 @@
var activeButton = direction === 'upstream' ? upstreamBtn : downstreamBtn;
activeButton.setAttribute('aria-pressed', 'true');
var reachableCount = result.nodeIds.length - 1;
- var directionLabel = direction === 'upstream' ? 'Upstream' : 'Downstream';
- reachStatus.textContent = directionLabel + ' · ' + reachableCount + ' node' +
- (reachableCount === 1 ? '' : 's') + ' · ' + result.edgeKeys.length + ' link' +
- (result.edgeKeys.length === 1 ? '' : 's') + ' · max ' + result.maxDepth + ' hop' +
- (result.maxDepth === 1 ? '' : 's');
+ var directionLabel = viewerText(direction === 'upstream'
+ ? 'viewer.passport.upstream'
+ : 'viewer.passport.downstream');
+ reachStatus.textContent = viewerText('viewer.passport.reach.status', {
+ direction: directionLabel,
+ nodes: reachableCount,
+ links: result.edgeKeys.length,
+ hops: result.maxDepth
+ });
reachStatus.hidden = false;
if (Archify.exportMenu && typeof Archify.exportMenu.syncReachShare === 'function') {
Archify.exportMenu.syncReachShare();
@@ -7603,7 +7773,7 @@
var slug = repository.url.replace(/^https:\/\/github\.com\//, '').replace(/\/$/, '');
repositoryLink.href = repository.url + '/tree/' + repository.revision;
repositoryLink.textContent = slug + ' @ ' + repository.shortRevision;
- repositoryLink.setAttribute('aria-label', 'Open verified repository revision ' + repository.revision);
+ repositoryLink.setAttribute('aria-label', viewerText('viewer.passport.repository.open', { revision: repository.revision }));
sources.forEach(function (source) {
var link = document.createElement('a');
link.className = 'semantic-passport-source';
@@ -7611,13 +7781,13 @@
link.target = '_blank';
link.rel = 'noopener noreferrer';
link.referrerPolicy = 'no-referrer';
- link.setAttribute('aria-label', 'Open verified source ' + source.path + ' at revision ' + repository.shortRevision);
+ link.setAttribute('aria-label', viewerText('viewer.passport.source.open', { path: source.path, revision: repository.shortRevision }));
var name = document.createElement('strong');
name.textContent = source.label || source.path.split('/').pop() || source.path;
var location = document.createElement('code');
location.textContent = source.line
? 'L' + source.line + (source.endLine && source.endLine !== source.line ? '–' + source.endLine : '') + ' ↗'
- : 'Open ↗';
+ : viewerText('viewer.passport.source.openLink');
var sourcePath = document.createElement('small');
sourcePath.textContent = source.path;
link.appendChild(name);
@@ -7629,7 +7799,7 @@
}
function renderPassport(id, node) {
setPassportValue(detail, node.getAttribute('data-node-sublabel'));
- setPassportValue(kind, node.getAttribute('data-node-kind') || 'node');
+ setPassportValue(kind, viewerKindLabel(node.getAttribute('data-node-kind') || 'node'));
setPassportValue(context, node.getAttribute('data-node-context'));
setPassportValue(tag, node.getAttribute('data-node-tag'));
setPassportValue(document.getElementById('focus-brand'), node.getAttribute('data-node-brand'));
@@ -7660,7 +7830,11 @@
direction: direction,
neighborId: neighborId,
neighborLabel: neighbor ? nodeLabel(neighbor, neighborId) : neighborId,
- label: edgeLabel || (direction === 'loop' ? 'loops back' : direction === 'out' ? 'connects to' : 'connects from')
+ label: edgeLabel || viewerText(direction === 'loop'
+ ? 'viewer.passport.relationship.loopsBack'
+ : direction === 'out'
+ ? 'viewer.passport.relationship.connectsTo'
+ : 'viewer.passport.relationship.connectsFrom')
});
});
return relationships;
@@ -7703,7 +7877,9 @@
fromLabel: byId[from] ? nodeLabel(byId[from], from) : from,
toLabel: byId[to] ? nodeLabel(byId[to], to) : to,
labelValue: labelValue,
- label: labelValue || (from === to ? 'loops back' : 'connects to'),
+ label: labelValue || viewerText(from === to
+ ? 'viewer.passport.relationship.loopsBack'
+ : 'viewer.passport.relationship.connectsTo'),
edge: edge,
shapes: shapes,
invalid: false
@@ -7730,14 +7906,14 @@
function renderRelationshipCopyAction() {
var record = pinnedRelationshipRecord();
if (record && record.id) {
- copyBtn.textContent = 'Copy relation';
- copyBtn.setAttribute('aria-label', 'Copy link to pinned relationship');
+ copyBtn.textContent = viewerText('viewer.passport.copyRelation');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copyPinned'));
} else if (pinnedRelationshipKey) {
- copyBtn.textContent = 'Copy node';
- copyBtn.setAttribute('aria-label', 'Copy link to source node');
+ copyBtn.textContent = viewerText('viewer.passport.copyNode');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copySource'));
} else {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
}
}
function relationshipHitGeometry(shape, className) {
@@ -8056,7 +8232,11 @@
var target = relationshipHitTarget(key);
if (target) target.setAttribute('aria-pressed', 'true');
renderRelationshipCopyAction();
- summary.textContent = 'Pinned relationship · ' + record.fromLabel + ' → ' + record.toLabel + ' · ' + record.label;
+ summary.textContent = viewerText('viewer.passport.relationship.pinned', {
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
revealPinnedRelationship(record);
if (options.updateUrl !== false && record.id) {
try { history.replaceState(null, '', location.pathname + location.search + '#relation=' + encodeURIComponent(record.id)); } catch (_) {}
@@ -8075,10 +8255,10 @@
relationshipHitOverlay.setAttribute('class', 'relationship-hit-overlay');
relationshipHitOverlay.setAttribute('data-relationship-hit-overlay', '');
relationshipHitOverlay.setAttribute('role', 'group');
- relationshipHitOverlay.setAttribute('aria-label', 'Direct relationship explorer');
+ relationshipHitOverlay.setAttribute('aria-label', viewerText('viewer.passport.relationship.explorer'));
var relationshipHelp = document.createElementNS(svgNamespace, 'desc');
relationshipHelp.id = 'archify-relationship-help';
- relationshipHelp.textContent = 'Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.';
+ relationshipHelp.textContent = viewerText('viewer.passport.relationship.help');
relationshipHitOverlay.appendChild(relationshipHelp);
records.forEach(function (record, index) {
var target = document.createElementNS(svgNamespace, 'g');
@@ -8092,7 +8272,13 @@
target.setAttribute('tabindex', index === 0 ? '0' : '-1');
target.setAttribute('aria-pressed', 'false');
target.setAttribute('aria-describedby', relationshipHelp.id);
- var description = 'Inspect relationship ' + (index + 1) + ' of ' + records.length + ': ' + record.fromLabel + ' to ' + record.toLabel + ', ' + record.label + '. Press Enter for details.';
+ var description = viewerText('viewer.passport.relationship.inspect', {
+ index: index + 1,
+ total: records.length,
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
target.setAttribute('aria-label', description);
var title = document.createElementNS(svgNamespace, 'title');
title.textContent = record.fromLabel + ' \u2192 ' + record.toLabel + ' \u00b7 ' + record.label;
@@ -8188,25 +8374,29 @@
var relationships = relationshipsFor(id, byId);
chip.removeAttribute('data-relations-expanded');
relationsBtn.setAttribute('aria-expanded', 'false');
- relationsBtn.textContent = relationships.length + ' relation' + (relationships.length === 1 ? '' : 's');
- relationsBtn.setAttribute('aria-label', 'Show ' + relationships.length + ' connected relationship' + (relationships.length === 1 ? '' : 's'));
+ relationsBtn.textContent = viewerCount('viewer.passport.relationship.count', relationships.length);
+ relationsBtn.setAttribute('aria-label', viewerCount('viewer.passport.relationship.show', relationships.length));
var counts = { out: 0, in: 0, loop: 0 };
relationships.forEach(function (relationship) { counts[relationship.direction] += 1; });
- summary.textContent = counts.out + ' outgoing · ' + counts.in + ' incoming' + (counts.loop ? ' · ' + counts.loop + ' loop' : '');
+ summary.textContent = viewerText('viewer.passport.relationship.summary', {
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.passport.relationship.loops', { count: counts.loop }) : ''
+ });
renderReachabilityControls(id);
relationshipList.textContent = '';
if (!relationships.length) {
var empty = document.createElement('p');
empty.className = 'relationship-lens-empty';
- empty.textContent = 'No connected relationships';
+ empty.textContent = viewerText('viewer.passport.relationship.none');
relationshipList.appendChild(empty);
return;
}
[
- { id: 'out', label: 'Outgoing' },
- { id: 'in', label: 'Incoming' },
- { id: 'loop', label: 'Self loops' }
+ { id: 'out', label: viewerText('viewer.passport.relationship.group.out') },
+ { id: 'in', label: viewerText('viewer.passport.relationship.group.in') },
+ { id: 'loop', label: viewerText('viewer.passport.relationship.group.loop') }
].forEach(function (group) {
var items = relationships.filter(function (relationship) { return relationship.direction === group.id; });
if (!items.length) return;
@@ -8226,11 +8416,19 @@
button.setAttribute('data-relationship-from', relationship.from);
button.setAttribute('data-relationship-to', relationship.to);
if (relationship.id) button.setAttribute('data-relationship-id', relationship.id);
- button.setAttribute('aria-label', group.label + ': ' + relationship.label + ', ' + relationship.neighborLabel);
+ button.setAttribute('aria-label', viewerText('viewer.passport.relationship.row', {
+ group: group.label,
+ relationship: relationship.label,
+ neighbor: relationship.neighborLabel
+ }));
var direction = document.createElement('span');
direction.className = 'relationship-lens-direction';
direction.setAttribute('aria-hidden', 'true');
- direction.textContent = relationship.direction === 'out' ? 'OUT →' : relationship.direction === 'in' ? '← IN' : 'LOOP';
+ direction.textContent = viewerText(relationship.direction === 'out'
+ ? 'viewer.passport.relationship.direction.out'
+ : relationship.direction === 'in'
+ ? 'viewer.passport.relationship.direction.in'
+ : 'viewer.passport.relationship.direction.loop');
var target = document.createElement('strong');
target.textContent = relationship.neighborLabel;
var relation = document.createElement('small');
@@ -8281,6 +8479,45 @@
preferred = nodeCenter - chip.offsetHeight / 2;
}
var top = Math.max(minTop, Math.min(maxTop, preferred));
+ var chipRect = chip.getBoundingClientRect();
+ var safeGap = 10;
+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;
+ var protectedRects = (protectViewerChrome
+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]
+ : [])
+ .filter(function (element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ })
+ .map(function (element) { return element.getBoundingClientRect(); })
+ .filter(function (rect) {
+ return rect.width > 0 && rect.height > 0 &&
+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;
+ });
+ if (protectedRects.length) {
+ var candidates = [top, minTop, maxTop];
+ protectedRects.forEach(function (rect) {
+ candidates.push(
+ rect.top - containerRect.top - chip.offsetHeight - safeGap,
+ rect.bottom - containerRect.top + safeGap
+ );
+ });
+ var valid = candidates.map(function (candidate) {
+ return Math.max(minTop, Math.min(maxTop, candidate));
+ }).filter(function (candidate, index, all) {
+ if (all.indexOf(candidate) !== index) return false;
+ var candidateTop = containerRect.top + candidate;
+ var candidateBottom = candidateTop + chip.offsetHeight;
+ return protectedRects.every(function (rect) {
+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;
+ });
+ });
+ valid.sort(function (first, second) {
+ return Math.abs(first - preferred) - Math.abs(second - preferred);
+ });
+ if (valid.length) top = valid[0];
+ }
chip.style.top = Math.round(top) + 'px';
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
}
@@ -8331,10 +8568,10 @@
upstreamBtn.disabled = true;
downstreamBtn.disabled = true;
relationshipList.textContent = '';
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
- relationsBtn.textContent = 'Relations';
- relationsBtn.setAttribute('aria-label', 'Show connected relationships');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
+ relationsBtn.textContent = viewerText('viewer.passport.relations');
+ relationsBtn.setAttribute('aria-label', viewerText('viewer.passport.relations.show'));
relationsBtn.setAttribute('aria-expanded', 'false');
chip.removeAttribute('data-relations-expanded');
chip.style.removeProperty('top');
@@ -8402,7 +8639,7 @@
svg.setAttribute('data-focus-active', normalized.join(' '));
var defaultLabel = normalized.length === 1
? nodeLabel(byId[normalized[0]], normalized[0])
- : normalized.length + ' selected nodes';
+ : viewerText('viewer.guided.chapter.selectedNodes', { count: normalized.length });
label.textContent = options.label || defaultLabel;
chip.hidden = options.hideChip === true || normalized.length !== 1 || selectionMode;
if (!chip.hidden) {
@@ -8448,10 +8685,10 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
copyBtn.setAttribute('aria-label', copied
- ? (relationId ? 'Pinned relationship link copied' : 'Focused node link copied')
- : (relationId ? 'Could not copy pinned relationship link' : 'Could not copy focused node link'));
+ ? viewerText(relationId ? 'viewer.passport.copy.pinned.success' : 'viewer.passport.copy.focused.success')
+ : viewerText(relationId ? 'viewer.passport.copy.pinned.failed' : 'viewer.passport.copy.focused.failed'));
window.setTimeout(function () {
renderRelationshipCopyAction();
}, 1600);
@@ -8490,7 +8727,9 @@
if (expanded) chip.removeAttribute('data-relations-expanded');
else chip.setAttribute('data-relations-expanded', 'true');
relationsBtn.setAttribute('aria-expanded', expanded ? 'false' : 'true');
- relationsBtn.setAttribute('aria-label', expanded ? 'Show connected relationships' : 'Hide connected relationships');
+ relationsBtn.setAttribute('aria-label', viewerText(expanded
+ ? 'viewer.passport.relations.show'
+ : 'viewer.passport.relations.hide'));
requestLensPlacement();
});
relationshipList.addEventListener('click', function (event) {
@@ -8552,7 +8791,7 @@
var target = event.target;
if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;
if (container.getAttribute('data-just-panned') === 'true') return;
- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;
+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;
clear();
}, true);
window.addEventListener('scroll', requestLensPlacement, { passive: true });
@@ -8776,9 +9015,13 @@
svg.setAttribute('data-intent-trace-active', id);
if (options.announce === true) {
var total = counts.out + counts.in + counts.loop;
- status.textContent = nodeLabel(selected, id) + '. ' + counts.out + ' outgoing, ' +
- counts.in + ' incoming' + (counts.loop ? ', ' + counts.loop + ' self loop' : '') +
- '. ' + total + ' connection' + (total === 1 ? '' : 's') + '. Press Enter for details.';
+ status.textContent = viewerText('viewer.intent.summary', {
+ label: nodeLabel(selected, id),
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.intent.loops', { count: counts.loop }) : '',
+ total: total
+ });
}
return true;
}
@@ -9081,8 +9324,11 @@
drawHandoffAnchor(anchor);
var node = findNode(anchor);
var nodeLabel = node ? (node.getAttribute('data-node-label') || anchor) : anchor;
- handoffReceipt.textContent = (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1) +
- ' \u2192 ' + (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1) + ' \u00b7 via ' + nodeLabel;
+ handoffReceipt.textContent = viewerText('viewer.guided.handoff', {
+ from: (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1),
+ to: (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1),
+ label: nodeLabel
+ });
handoffReceipt.hidden = false;
}
if (Archify.motionGovernor) {
@@ -9139,8 +9385,13 @@
button.setAttribute('data-guided-view-id', view.id);
button.setAttribute('aria-pressed', 'false');
button.setAttribute('tabindex', index === 0 ? '0' : '-1');
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + view.label + ', ' + view.focus.length + ' stops');
- button.title = view.label + ' — ' + (view.note || view.focus.length + ' selected nodes');
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.open', {
+ index: index + 1,
+ total: views.length,
+ label: view.label,
+ count: view.focus.length
+ }));
+ button.title = view.label + ' — ' + (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }));
var position = document.createElement('span');
position.className = 'guided-view-chapter-index';
position.setAttribute('aria-hidden', 'true');
@@ -9150,7 +9401,7 @@
title.textContent = view.label;
var stops = document.createElement('em');
stops.className = 'guided-view-chapter-count';
- stops.textContent = view.focus.length + ' stop' + (view.focus.length === 1 ? '' : 's');
+ stops.textContent = viewerCount('viewer.guided.chapter.stop', view.focus.length);
var delta = document.createElement('span');
delta.className = 'guided-view-chapter-delta';
delta.hidden = true;
@@ -9183,20 +9434,40 @@
stops.hidden = false;
deltaLabel.hidden = true;
button.removeAttribute('data-chapter-delta');
- button.setAttribute('aria-label', 'Current chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + ', ' + views[index].focus.length + ' stops');
- button.title = views[index].label + ' — current chapter, ' + views[index].focus.length + ' stops';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.current', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ count: views[index].focus.length
+ }));
+ button.title = viewerText('viewer.guided.chapter.current.title', {
+ label: views[index].label,
+ count: views[index].focus.length
+ });
} else {
var delta = chapterDelta(activeIndex >= 0 ? views[activeIndex] : null, views[index]);
var compact = '=' + delta.stay.length + ' +' + delta.enter.length + ' \u2212' + delta.leave.length;
- var expanded = delta.stay.length + ' stay, ' + delta.enter.length + ' enter, ' + delta.leave.length + ' leave';
+ var expanded = viewerText('viewer.guided.chapter.delta.expanded', {
+ stay: delta.stay.length,
+ enter: delta.enter.length,
+ leave: delta.leave.length
+ });
stops.hidden = true;
deltaLabel.hidden = false;
deltaLabel.querySelector('[data-delta-kind="stay"]').textContent = '=' + delta.stay.length;
deltaLabel.querySelector('[data-delta-kind="enter"]').textContent = '+' + delta.enter.length;
deltaLabel.querySelector('[data-delta-kind="leave"]').textContent = '\u2212' + delta.leave.length;
button.setAttribute('data-chapter-delta', compact);
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + '. Chapter focus delta: ' + expanded);
- button.title = views[index].label + ' — ' + compact + ' chapter focus';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.delta.aria', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ delta: expanded
+ }));
+ button.title = viewerText('viewer.guided.chapter.delta.title', {
+ label: views[index].label,
+ delta: compact
+ });
}
if (current) button.setAttribute('aria-current', 'step');
else button.removeAttribute('aria-current');
@@ -9324,33 +9595,44 @@
function shareCueStatus(state) {
return {
- pending: 'Ready',
- playing: 'Playing',
- complete: 'Settled',
- interrupted: 'Paused',
- pinned: 'Pinned',
- 'reduced-motion': 'Still'
- }[state] || 'Ready';
+ pending: viewerText('viewer.guided.state.ready'),
+ playing: viewerText('viewer.guided.state.playing'),
+ complete: viewerText('viewer.guided.state.settled'),
+ interrupted: viewerText('viewer.guided.state.paused'),
+ pinned: viewerText('viewer.guided.state.pinned'),
+ 'reduced-motion': viewerText('viewer.guided.state.still')
+ }[state] || viewerText('viewer.guided.state.ready');
}
function shareCueBeatCopy(state, view, stops) {
var total = stops.length;
var activeStop = storyBeatIndex >= 0 ? stops[storyBeatIndex] : null;
if ((state === 'playing' || state === 'interrupted') && activeStop) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent;
+ return viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ });
}
if (state === 'pinned' && activeStop) {
return storyBeatCopy(storySteps[storyBeatIndex], total);
}
if (state === 'reduced-motion' && activeStop && hashBeatMatchesCurrent()) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent + ' · Static moment';
+ return viewerText('viewer.guided.share.staticMoment', {
+ step: viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ })
+ });
}
- if (state === 'complete') return total + ' steps complete · ' + (view.note || 'Path settled for reading.');
- if (state === 'reduced-motion') return total + ' steps · Static path';
- if (state === 'pending') return total + ' steps · Ready';
- return view.note || view.focus.length + ' selected nodes';
+ if (state === 'complete') return viewerText('viewer.guided.share.complete', {
+ count: total,
+ note: view.note || viewerText('viewer.guided.share.settled')
+ });
+ if (state === 'reduced-motion') return viewerText('viewer.guided.share.staticPath', { count: total });
+ if (state === 'pending') return viewerText('viewer.guided.share.ready', { count: total });
+ return view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length });
}
function renderShareCue() {
@@ -9375,11 +9657,21 @@
shareCue.setAttribute('data-state', state);
shareCue.setAttribute('aria-live', state === 'playing' ? 'off' : 'polite');
shareCueState.textContent = shareCueStatus(state);
- shareCueCount.textContent = 'Chapter ' + (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1) + ' / ' + (views.length < 10 ? '0' : '') + views.length;
+ shareCueCount.textContent = viewerText('viewer.guided.share.chapter', {
+ index: (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1),
+ total: (views.length < 10 ? '0' : '') + views.length
+ });
shareCueLabel.textContent = view.label;
shareCueNote.textContent = beatCopy;
shareCueRoute.textContent = route;
- shareCue.setAttribute('aria-label', shareCueStatus(state) + ' chapter ' + (activeIndex + 1) + ' of ' + views.length + ': ' + view.label + '. ' + beatCopy + '. ' + route);
+ shareCue.setAttribute('aria-label', viewerText('viewer.guided.share.aria', {
+ state: shareCueStatus(state),
+ index: activeIndex + 1,
+ total: views.length,
+ label: view.label,
+ beat: beatCopy,
+ route: route
+ }));
}
function setShareCueProgress(fraction) {
@@ -9470,24 +9762,24 @@
if (!step) return '';
var position = (step.index + 1 < 10 ? '0' : '') + (step.index + 1);
var countValue = (total < 10 ? '0' : '') + total;
- if (step.relation === 'start') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u00b7 starting point';
- if (step.relation === 'forward') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u2192 ' + step.nodeLabel;
- if (step.relation === 'reverse') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u2192 ' + step.previousLabel + ' \u00b7 reverse authored link';
- if (step.relation === 'multiple') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u21c4 ' + step.nodeLabel + ' \u00b7 ' + step.edges.length + ' authored links';
- return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u00b7 ' + step.nodeLabel + ' \u00b7 grouped \u00b7 no direct link';
+ if (step.relation === 'start') return viewerText('viewer.guided.beat.start', { index: position, total: countValue, label: step.nodeLabel });
+ if (step.relation === 'forward') return viewerText('viewer.guided.beat.forward', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'reverse') return viewerText('viewer.guided.beat.reverse', { index: position, total: countValue, from: step.nodeLabel, to: step.previousLabel });
+ if (step.relation === 'multiple') return viewerText('viewer.guided.beat.multiple', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel, count: step.edges.length });
+ return viewerText('viewer.guided.beat.group', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
}
function storyBeatAria(step, total) {
- var prefix = 'Story beat ' + (step.index + 1) + ' of ' + total + ': ' + step.nodeLabel + '. ';
- if (step.relation === 'start') return prefix + 'Starting point.';
- if (step.relation === 'forward') return prefix + 'From ' + step.previousLabel + ' through one authored forward relationship.';
- if (step.relation === 'reverse') return prefix + 'From ' + step.previousLabel + '; the authored relationship points from ' + step.nodeLabel + ' to ' + step.previousLabel + '.';
- if (step.relation === 'multiple') return prefix + 'From ' + step.previousLabel + ' through ' + step.edges.length + ' authored relationships; shown without arbitrary motion.';
- return prefix + 'Grouped from ' + step.previousLabel + ' with no direct authored relationship.';
+ var prefix = viewerText('viewer.guided.beat.aria.prefix', { index: step.index + 1, total: total, label: step.nodeLabel });
+ if (step.relation === 'start') return prefix + viewerText('viewer.guided.beat.aria.start');
+ if (step.relation === 'forward') return prefix + viewerText('viewer.guided.beat.aria.forward', { from: step.previousLabel });
+ if (step.relation === 'reverse') return prefix + viewerText('viewer.guided.beat.aria.reverse', { from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'multiple') return prefix + viewerText('viewer.guided.beat.aria.multiple', { from: step.previousLabel, count: step.edges.length });
+ return prefix + viewerText('viewer.guided.beat.aria.group', { from: step.previousLabel });
}
function storyCaptionRouteCopy(step) {
- if (step.relation === 'start') return step.nodeLabel + ' · Starting point';
+ if (step.relation === 'start') return step.nodeLabel + ' · ' + viewerText('viewer.guided.caption.start');
if (step.relation === 'reverse') return step.previousLabel + ' ← ' + step.nodeLabel;
if (step.relation === 'multiple') return step.previousLabel + ' ⇄ ' + step.nodeLabel;
if (step.relation === 'group') return step.previousLabel + ' · ' + step.nodeLabel;
@@ -9496,15 +9788,15 @@
function storyCaptionDetailCopy(step) {
var facts = [];
- if (step.relation === 'group') facts.push('Grouped transition · no direct authored link');
- else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? ' +' + (step.edgeLabels.length - 3) + ' more' : ''));
- else if (step.relation === 'reverse') facts.push('Reverse authored relationship');
- else if (step.relation === 'multiple') facts.push(step.edges.length + ' authored relationships');
- else if (step.relation !== 'start') facts.push('Authored relationship');
- if (step.relation === 'reverse') facts.push('authored direction: ' + step.nodeLabel + ' → ' + step.previousLabel);
+ if (step.relation === 'group') facts.push(viewerText('viewer.guided.caption.grouped'));
+ else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? viewerText('viewer.guided.caption.more', { count: step.edgeLabels.length - 3 }) : ''));
+ else if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.reverse'));
+ else if (step.relation === 'multiple') facts.push(viewerText('viewer.guided.caption.relationships', { count: step.edges.length }));
+ else if (step.relation !== 'start') facts.push(viewerText('viewer.guided.caption.relationship'));
+ if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.direction', { from: step.nodeLabel, to: step.previousLabel }));
if (step.responsibility) facts.push(step.responsibility);
if (step.context) facts.push(step.context);
- if (!facts.length) facts.push('Authored starting point');
+ if (!facts.length) facts.push(viewerText('viewer.guided.caption.starting'));
return facts.join(' · ');
}
@@ -9560,17 +9852,17 @@
if (beatLinkFeedbackTimer) clearTimeout(beatLinkFeedbackTimer);
beatLinkFeedbackTimer = null;
beatLink.removeAttribute('data-copy-state');
- beatLinkLabel.textContent = 'Copy moment';
+ beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
}
function syncBeatLink() {
var step = storyBeatIndex >= 0 ? storySteps[storyBeatIndex] : null;
var available = !!(activeIndex >= 0 && step && !currentHandoff);
beatLink.disabled = !available;
- if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = 'Copy moment';
+ if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
var description = available
- ? 'Copy link to current story moment: Beat ' + (step.index + 1) + ' of ' + storySteps.length + ': ' + step.nodeLabel
- : 'Select a Story Beat to copy its exact link';
+ ? viewerText('viewer.guided.beatLink', { index: step.index + 1, total: storySteps.length, label: step.nodeLabel })
+ : viewerText('viewer.guided.selectBeatLink');
beatLink.setAttribute('aria-label', description);
beatLink.title = description;
}
@@ -9578,8 +9870,8 @@
function setBeatLinkFeedback(copied) {
resetBeatLinkFeedback();
beatLink.setAttribute('data-copy-state', copied ? 'copied' : 'failed');
- beatLinkLabel.textContent = copied ? 'Copied' : 'Copy failed';
- beatLink.setAttribute('aria-label', copied ? 'Moment link copied' : 'Could not copy story moment link');
+ beatLinkLabel.textContent = viewerText(copied ? 'viewer.guided.copied' : 'viewer.guided.copyFailed');
+ beatLink.setAttribute('aria-label', viewerText(copied ? 'viewer.guided.momentCopied' : 'viewer.guided.momentCopyFailed'));
beatLinkFeedbackTimer = setTimeout(function () {
resetBeatLinkFeedback();
syncBeatLink();
@@ -9833,7 +10125,7 @@
stop.removeAttribute('aria-current');
});
note.setAttribute('aria-live', 'polite');
- if (activeIndex >= 0) note.textContent = views[activeIndex].note || views[activeIndex].focus.length + ' selected nodes';
+ if (activeIndex >= 0) note.textContent = views[activeIndex].note || viewerText('viewer.guided.chapter.selectedNodes', { count: views[activeIndex].focus.length });
renderStoryCaption(null, 0);
renderShareCue();
syncBeatLink();
@@ -9912,7 +10204,7 @@
trail.appendChild(stop);
});
trail.hidden = labels.length === 0;
- trail.setAttribute('aria-label', 'Story trail for ' + view.label + ': ' + labels.length + ' beats');
+ trail.setAttribute('aria-label', viewerText('viewer.guided.storyTrail', { label: view.label, count: labels.length }));
trail.scrollLeft = 0;
svg.setAttribute('data-story-active', view.id);
@@ -9991,21 +10283,39 @@
syncStoryPlayback();
play.disabled = !playing && !automaticPlaybackAllowed;
play.setAttribute('aria-pressed', playing ? 'true' : 'false');
- play.setAttribute('aria-label', playing ? 'Pause guided story' : (!automaticPlaybackAllowed ? 'Story playback unavailable while motion is Still' : (storyPlaybackComplete ? 'Replay guided story' : 'Play guided story')));
- play.title = playing ? 'Pause guided story (P)' : (!automaticPlaybackAllowed ? 'Switch motion to Live to play the guided story' : (storyPlaybackComplete ? 'Replay guided story (P)' : 'Play guided story (P)'));
+ play.setAttribute('aria-label', viewerText(playing
+ ? 'viewer.guided.pause'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.motionUnavailable'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay'
+ : 'viewer.guided.play'));
+ play.title = viewerText(playing
+ ? 'viewer.guided.pause.title'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.enableMotion'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay.title'
+ : 'viewer.guided.play.title');
playIcon.textContent = playing ? '\u2016' : '\u25b6';
- playLabel.textContent = playing ? 'Pause' : (storyPlaybackComplete ? 'Replay story' : 'Play story');
+ playLabel.textContent = viewerText(playing
+ ? 'viewer.guided.pauseStory'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replayStory'
+ : 'viewer.guided.playStory');
if (storyCaption && !storyCaption.hidden) storyCaption.setAttribute('aria-live', playing ? 'off' : 'polite');
}
function render() {
var view = views[activeIndex];
count.textContent = activeIndex < 0 ? '0 / ' + views.length : (activeIndex + 1) + ' / ' + views.length;
- label.textContent = view ? view.label : 'Explore this system';
+ label.textContent = view ? view.label : viewerText('viewer.guided.explore');
note.setAttribute('aria-live', storyBeatIndex >= 0 ? 'off' : 'polite');
note.textContent = storyBeatIndex >= 0
? storyBeatCopy(storySteps[storyBeatIndex], storySteps.length)
- : (view ? (view.note || view.focus.length + ' selected nodes') : 'Step through curated paths without changing the source diagram.');
+ : (view
+ ? (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }))
+ : viewerText('viewer.guided.intro'));
prev.disabled = activeIndex < 0;
next.disabled = activeIndex >= views.length - 1;
all.disabled = activeIndex < 0;
@@ -10489,6 +10799,46 @@
embed, presentation, print, and non-wide diagrams retain their own
established layout contracts.
============================================================ */
+ Archify.waitForStableLayout = function (options) {
+ options = options || {};
+ var maximumFrames = Math.max(1, Number(options.maximumFrames) || 240);
+ var fontsReady = document.fonts && document.fonts.ready
+ ? document.fonts.ready.catch(function () {})
+ : Promise.resolve();
+ return fontsReady.then(function () {
+ if (typeof options.schedule === 'function') options.schedule();
+ return new Promise(function (resolve, reject) {
+ var previous = '';
+ var stableFrames = 0;
+ var sampledFrames = 0;
+ function sample() {
+ sampledFrames += 1;
+ if (typeof options.pending === 'function' && options.pending()) {
+ previous = '';
+ stableFrames = 0;
+ } else {
+ var current = typeof options.snapshot === 'function' ? options.snapshot() : '';
+ if (current === previous) stableFrames += 1;
+ else {
+ previous = current;
+ stableFrames = 0;
+ }
+ if (stableFrames >= 3) {
+ resolve({ stable: true, snapshot: current, sampledFrames: sampledFrames });
+ return;
+ }
+ }
+ if (sampledFrames >= maximumFrames) {
+ reject(new Error(options.timeoutMessage || 'Layout did not reach stable dimensions.'));
+ return;
+ }
+ requestAnimationFrame(sample);
+ }
+ requestAnimationFrame(sample);
+ });
+ });
+ };
+
Archify.readerLayout = (function () {
var html = document.documentElement;
var body = document.body;
@@ -10608,6 +10958,31 @@
if (frame) return;
frame = requestAnimationFrame(measure);
}
+ function stableSnapshot() {
+ var shellRect = shell ? shell.getBoundingClientRect() : { width: 0, height: 0 };
+ var diagramRect = diagram ? diagram.getBoundingClientRect() : { width: 0, height: 0 };
+ return [
+ lastWidth,
+ html.getAttribute('data-reader-layout') || '',
+ html.getAttribute('data-reader-overflow') || '',
+ Math.ceil(document.documentElement.scrollWidth),
+ Math.ceil(document.documentElement.scrollHeight),
+ Math.ceil(document.body.scrollWidth),
+ Math.ceil(document.body.scrollHeight),
+ Math.round(shellRect.width * 100) / 100,
+ Math.round(shellRect.height * 100) / 100,
+ Math.round(diagramRect.width * 100) / 100,
+ Math.round(diagramRect.height * 100) / 100
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Adaptive reader layout did not reach stable dimensions.'
+ });
+ }
window.addEventListener('resize', schedule, { passive: true });
window.addEventListener('load', schedule, { once: true });
@@ -10627,11 +11002,324 @@
return {
measure: measure,
schedule: schedule,
+ whenStable: whenStable,
active: function () { return html.getAttribute('data-reader-layout') === 'adaptive'; },
receipt: function () { return { ratio: ratio, width: lastWidth }; }
};
})();
+ /* ============================================================
+ Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
+ ============================================================ */
+ Archify.viewerChromeLayout = (function () {
+ var html = document.documentElement;
+ var container = document.querySelector('.diagram-container');
+ var svg = container && container.querySelector(':scope > svg');
+ var nav = container && container.querySelector('.diagram-nav');
+ var legend = svg && svg.querySelector('[data-legend]');
+ var frame = 0;
+ var settleFrame = 0;
+ var reserve = 0;
+ var railLatched = false;
+ var probingBaseline = false;
+ var probePromise = null;
+ var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
+ var lastReceipt = null;
+ var SAFE_GAP = 10;
+
+ function visible(element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ }
+ function usable(rect) {
+ return Boolean(rect && rect.width > 0 && rect.height > 0);
+ }
+ function intersectionArea(a, b) {
+ var width = Math.max(0, Math.min(a.right, b.right) - Math.max(a.left, b.left));
+ var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
+ return width * height;
+ }
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
+ function eligible() {
+ return Boolean(
+ container && svg && nav &&
+ window.innerWidth > 720 &&
+ html.getAttribute('data-embed') !== 'true' &&
+ (!window.matchMedia || !window.matchMedia('print').matches) &&
+ visible(nav)
+ );
+ }
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
+ function writeReserve(next, options) {
+ options = options || {};
+ next = Math.max(0, Math.ceil(next));
+ if (Math.abs(next - reserve) < 1) return false;
+ reserve = next;
+ if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
+ container.style.setProperty('--archify-nav-reserve', reserve + 'px');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
+ } else {
+ container.style.removeProperty('--archify-nav-reserve');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
+ }
+ if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
+ Archify.readerLayout.schedule();
+ }
+ if (options.quiet !== true) {
+ if (settleFrame) cancelAnimationFrame(settleFrame);
+ settleFrame = requestAnimationFrame(function () {
+ settleFrame = 0;
+ schedule();
+ });
+ }
+ return true;
+ }
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
+ writeReserve(0, { quiet: probingBaseline });
+ lastReceipt = {
+ eligible: false,
+ active: false,
+ reserve: 0,
+ gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
+ baselineIntersectionArea: 0,
+ intersectionArea: 0
+ };
+ return lastReceipt;
+ }
+ function measure() {
+ frame = 0;
+ if (probingBaseline) return null;
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
+
+ var navRect = nav.getBoundingClientRect();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
+
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
+ baselineIntersectionArea = actualIntersectionArea;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
+ }
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
+ if (writeReserve(reserve + remaining)) return null;
+ }
+
+ navRect = nav.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
+ };
+ return lastReceipt;
+ }
+ function reprobe() {
+ if (probingBaseline) return probePromise || Promise.resolve(false);
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
+ probingBaseline = true;
+ railLatched = false;
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ writeReserve(0, { quiet: true });
+ var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
+ ? Archify.readerLayout.whenStable().catch(function () {})
+ : Promise.resolve();
+ probePromise = readerReady.then(function () {
+ probingBaseline = false;
+ probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
+ schedule();
+ return true;
+ });
+ return probePromise;
+ }
+ function schedule() {
+ if (frame) return;
+ frame = requestAnimationFrame(measure);
+ }
+ function stableSnapshot() {
+ var containerRect = container ? container.getBoundingClientRect() : { width: 0, height: 0 };
+ var navRect = nav ? nav.getBoundingClientRect() : { top: 0, left: 0 };
+ var legendRect = legend ? legend.getBoundingClientRect() : { top: 0, left: 0 };
+ return [
+ reserve,
+ Math.round(containerRect.width * 100) / 100,
+ Math.round(containerRect.height * 100) / 100,
+ Math.round(navRect.left * 100) / 100,
+ Math.round(navRect.top * 100) / 100,
+ Math.round(legendRect.left * 100) / 100,
+ Math.round(legendRect.top * 100) / 100,
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame || probingBaseline); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Viewer chrome layout did not reach stable dimensions.'
+ });
+ }
+
+ window.addEventListener('resize', reprobe, { passive: true });
+ window.addEventListener('load', schedule, { once: true });
+ window.addEventListener('beforeprint', schedule);
+ window.addEventListener('afterprint', reprobe);
+ if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
+ if (typeof ResizeObserver === 'function') {
+ var resizeObserver = new ResizeObserver(schedule);
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ }
+ if (typeof MutationObserver === 'function') {
+ var contentObserver = new MutationObserver(function (records) {
+ var viewerModeChanged = records.some(function (record) { return record.target === html; });
+ if (viewerModeChanged) reprobe();
+ else schedule();
+ });
+ if (legend) contentObserver.observe(legend, { attributes: true, childList: true, subtree: true });
+ contentObserver.observe(html, {
+ attributes: true,
+ attributeFilter: ['data-embed', 'data-present', 'data-preset', 'data-theme']
+ });
+ }
+ schedule();
+
+ return {
+ measure: measure,
+ schedule: schedule,
+ reprobe: reprobe,
+ whenStable: whenStable,
+ stageRect: protectedStageRect,
+ active: function () { return reserve > 0; },
+ receipt: function () { return lastReceipt || measure(); }
+ };
+ })();
+
Archify.view = (function () {
var container = document.querySelector('.diagram-container');
var svg = container.querySelector('svg');
@@ -10646,6 +11334,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -10707,36 +11396,76 @@
var semantic = state.mode === 'semantic' && state.scale > 1.01;
var detail = detailLevel();
var percent = Math.round(state.scale * 100) + '%';
- var levelLabel = detail === 'map' ? 'MAP ' : detail === 'read' ? 'READ ' : 'FULL ';
+ var levelLabel = viewerText('viewer.nav.level.' + detail);
var detailHint = detail === 'map'
- ? 'Zoom in to reveal relationship labels and node context'
+ ? viewerText('viewer.nav.detail.map')
: detail === 'read'
- ? 'Zoom in again to reveal tags and annotations'
- : 'Full diagram detail';
- var resolvedLevel = (semantic ? 'AUTO ' : levelLabel).trim();
- var showDetailLevel = resolvedLevel !== 'READ';
+ ? viewerText('viewer.nav.detail.read')
+ : viewerText('viewer.nav.detail.full');
+ var resolvedLevel = semantic ? viewerText('viewer.nav.level.auto') : levelLabel;
+ var showDetailLevel = semantic || detail !== 'read';
if (resetDetailLabel) {
resetDetailLabel.textContent = resolvedLevel;
resetDetailLabel.hidden = !showDetailLevel;
}
if (resetPercentLabel) resetPercentLabel.textContent = percent;
resetBtn.toggleAttribute('data-detail-visible', showDetailLevel);
- resetBtn.title = (semantic ? 'Semantic camera active · ' : '') + detailHint + ' · reset view (0)';
- resetBtn.setAttribute('aria-label', detailHint + '. Reset diagram view');
+ resetBtn.title = viewerText('viewer.nav.camera.title', {
+ semantic: semantic ? viewerText('viewer.nav.camera.semantic') : '',
+ hint: detailHint
+ });
+ resetBtn.setAttribute('aria-label', viewerText('viewer.nav.camera', { hint: detailHint }));
resetBtn.setAttribute('data-detail-level', detail);
container.setAttribute('data-detail-level', detail);
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
container.classList.toggle('is-pannable', state.scale > 1);
svg.setAttribute('data-view-scale', String(state.scale));
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
+ if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.schedule === 'function') {
+ Archify.viewerChromeLayout.schedule();
+ }
}
function sampleRenderedState() {
var transform = '';
@@ -11127,21 +11856,35 @@
var container = document.querySelector('.diagram-container');
var diagram = container.querySelector(':scope > svg');
var panel = document.getElementById('overview-map');
+ var panelHead = panel.querySelector('.overview-map-head');
var surface = document.getElementById('overview-map-surface');
var status = document.getElementById('overview-map-status');
var trigger = document.getElementById('btn-overview-map');
var closeBtn = document.getElementById('overview-map-close');
+ var expandBtn = document.getElementById('overview-map-expand');
+ var feedback = document.getElementById('overview-map-feedback');
+ var navigation = container.querySelector('.diagram-nav');
+ var passport = document.getElementById('focus-chip');
var namespace = 'http://www.w3.org/2000/svg';
var viewBox = diagram.viewBox && diagram.viewBox.baseVal;
var mapSvg = document.createElementNS(namespace, 'svg');
var nodeLayer = document.createElementNS(namespace, 'g');
var viewport = document.createElementNS(namespace, 'rect');
var nodes = [];
- var drag = null;
+ var viewportDrag = null;
+ var panelDrag = null;
+ var manualPosition = null;
+ var lastPlacement = null;
+ var requestedOpen = false;
+ var passportYielded = false;
+ var passportPreviousAriaHidden = null;
var syncFrame = 0;
+ var spaceRetryTimer = 0;
+ var spaceRetryCount = 0;
+ var placementGap = 16;
mapSvg.setAttribute('role', 'group');
- mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');
+ mapSvg.setAttribute('aria-label', viewerText('viewer.radar.nodes'));
mapSvg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
nodeLayer.setAttribute('class', 'overview-map-nodes');
viewport.setAttribute('class', 'overview-map-viewport');
@@ -11176,63 +11919,301 @@
rect.setAttribute('data-kind', node.getAttribute('data-node-kind') || 'neutral');
rect.setAttribute('tabindex', '0');
rect.setAttribute('role', 'button');
- rect.setAttribute('aria-label', 'Focus ' + nodeLabel(node, id) + ' from Semantic Radar');
+ rect.setAttribute('aria-label', viewerText('viewer.radar.focus', { label: nodeLabel(node, id) }));
nodeLayer.appendChild(rect);
nodes.push({ id: id, node: node, rect: rect });
});
- status.textContent = nodes.length + ' nodes · full map';
+ status.textContent = viewerText('viewer.radar.fullMap', { count: nodes.length });
return true;
}
- function updateDocking() {
- if (panel.hidden) return;
- var containerRect = container.getBoundingClientRect();
- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;
- if (!intersectsWindow) {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
- return;
- }
- var active = diagram.querySelector('[data-focus-selected]');
- var activeRect = active ? active.getBoundingClientRect() : null;
- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);
- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));
- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));
- var topLimit = Math.max(16, containerRect.top + 16);
- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);
- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;
- var panelRight = panelLeft + panel.offsetWidth;
+ function visibleRect(element) {
+ if (!element || element.hidden) return null;
+ var rect = element.getBoundingClientRect();
+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;
+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };
+ }
+ function panelRectAt(position) {
+ return {
+ left: position.left,
+ top: position.top,
+ right: position.left + panel.offsetWidth,
+ bottom: position.top + panel.offsetHeight,
+ width: panel.offsetWidth,
+ height: panel.offsetHeight
+ };
+ }
+ function rectsIntersect(first, second, gap) {
+ gap = Number(gap) || 0;
+ return first.left < second.right + gap &&
+ first.right > second.left - gap &&
+ first.top < second.bottom + gap &&
+ first.bottom > second.top - gap;
+ }
+ function intersectionArea(first, second) {
+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));
+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));
+ return width * height;
+ }
+ function clamp(value, minimum, maximum) {
+ if (maximum < minimum) return minimum;
+ return Math.max(minimum, Math.min(maximum, value));
+ }
+ function placementContext() {
+ var containerRect = visibleRect(container);
+ if (!containerRect) return null;
+ var controlRect = visibleRect(navigation);
+ var left = Math.max(placementGap, containerRect.left + placementGap);
+ var top = Math.max(placementGap, containerRect.top + placementGap);
+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);
+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);
+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);
var lens = document.getElementById('focus-chip');
- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;
- var blockers = [activeRect, lensRect].filter(function (rect) {
- return rect && rect.right > panelLeft && rect.left < panelRight;
- });
- var desiredTop = bottomLimit - panel.offsetHeight;
- var candidates = [desiredTop, topLimit];
- blockers.forEach(function (rect) {
- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);
- });
- var valid = candidates.filter(function (candidate) {
- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;
- return blockers.every(function (rect) {
- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;
- });
+ var lensRect = visibleRect(lens);
+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));
+ var active = diagram.querySelector('[data-focus-selected]');
+ var activeRect = visibleRect(active);
+ return {
+ bounds: { left: left, top: top, right: right, bottom: bottom },
+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),
+ softBlockers: [activeRect].filter(Boolean),
+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'
+ };
+ }
+ function positionIsValid(position, context) {
+ if (!position || !context) return false;
+ var rect = panelRectAt(position);
+ var bounds = context.bounds;
+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;
+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });
+ }
+ function cornerCandidates(context) {
+ var bounds = context.bounds;
+ var left = bounds.left;
+ var right = Math.max(left, bounds.right - panel.offsetWidth);
+ var top = bounds.top;
+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);
+ var preferredLeft = context.preferredSide === 'left' ? left : right;
+ var alternateLeft = context.preferredSide === 'left' ? right : left;
+ return [
+ { left: preferredLeft, top: bottom },
+ { left: alternateLeft, top: bottom },
+ { left: preferredLeft, top: top },
+ { left: alternateLeft, top: top }
+ ].filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function nearbyCandidates(context, reference) {
+ var bounds = context.bounds;
+ var maximumLeft = bounds.right - panel.offsetWidth;
+ var maximumTop = bounds.bottom - panel.offsetHeight;
+ var requested = reference ? {
+ left: clamp(reference.left, bounds.left, maximumLeft),
+ top: clamp(reference.top, bounds.top, maximumTop)
+ } : null;
+ var horizontal = [bounds.left, maximumLeft];
+ var vertical = [bounds.top, maximumTop];
+ if (requested) {
+ horizontal.push(requested.left);
+ vertical.push(requested.top);
+ }
+ context.hardBlockers.forEach(function (blocker) {
+ horizontal.push(
+ blocker.left - placementGap - panel.offsetWidth,
+ blocker.right + placementGap
+ );
+ vertical.push(
+ blocker.top - placementGap - panel.offsetHeight,
+ blocker.bottom + placementGap
+ );
+ });
+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });
+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });
+ var candidates = [];
+ horizontal.forEach(function (left) {
+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });
+ });
+ return candidates.filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
});
- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });
- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);
- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);
+ }
+ function placementScore(position, context, reference, softWeight) {
+ var rect = panelRectAt(position);
+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);
+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;
+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);
+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);
+ return distance + softOverlap * softWeight;
+ }
+ function chooseRadarPlacement(context, reference, options) {
+ options = options || {};
+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;
+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));
+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });
+ valid.sort(function (first, second) {
+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);
+ });
+ return valid.length ? valid[0] : null;
+ }
+ function applyPlacement(position, remember) {
+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;
panel.setAttribute('data-docked', 'true');
- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');
- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');
- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');
- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');
+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');
+ if (useLeft) {
+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');
+ panel.style.removeProperty('--archify-radar-right');
+ } else {
+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');
+ panel.style.removeProperty('--archify-radar-left');
+ }
+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');
+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };
+ }
+ function resetDockingStyles() {
+ panel.removeAttribute('data-docked');
+ panel.removeAttribute('data-dock-side');
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ panel.style.removeProperty('--archify-radar-right');
+ panel.style.removeProperty('--archify-radar-left');
+ panel.style.removeProperty('--archify-radar-top');
+ }
+ function updateDocking() {
+ var options = arguments[0] || {};
+ if (panel.hidden) return false;
+ if (panelDrag) return true;
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ var context = placementContext();
+ if (!context) {
+ resetDockingStyles();
+ return false;
+ }
+ var reference = manualPosition || lastPlacement;
+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };
+ var placement = manualPosition && positionIsValid(manualPosition, context)
+ ? manualPosition
+ : chooseRadarPlacement(context, reference, placementOptions);
+ var compact = false;
+ if (!placement && options.allowCompact !== false) {
+ compact = true;
+ panel.setAttribute('data-compact', 'true');
+ panel.setAttribute('data-placement-degraded', 'true');
+ panel.setAttribute('title', viewerText('viewer.radar.compacted'));
+ context = placementContext();
+ placement = chooseRadarPlacement(context, reference, placementOptions);
+ }
+ if (!placement) {
+ resetDockingStyles();
+ panel.setAttribute('data-placement-unavailable', 'true');
+ return false;
+ }
+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };
+ applyPlacement(placement, true);
+ return true;
+ }
+ function clearSpaceRetry() {
+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);
+ spaceRetryTimer = 0;
+ }
+ function yieldPassport() {
+ if (!passport || passport.hidden || passportYielded) return passportYielded;
+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');
+ passportYielded = true;
+ passport.setAttribute('data-radar-yielded', 'true');
+ passport.setAttribute('aria-hidden', 'true');
+ return true;
+ }
+ function restorePassport() {
+ if (!passport || !passportYielded) return;
+ passportYielded = false;
+ passport.removeAttribute('data-radar-yielded');
+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');
+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);
+ passportPreviousAriaHidden = null;
+ }
+ function reflectVisible() {
+ panel.hidden = false;
+ panel.removeAttribute('data-placement-unavailable');
+ trigger.setAttribute('aria-expanded', 'true');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.close'));
+ trigger.title = viewerText('viewer.nav.radar.title');
+ feedback.hidden = true;
+ }
+ function scheduleSpaceRetry() {
+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;
+ spaceRetryCount += 1;
+ spaceRetryTimer = window.setTimeout(function () {
+ spaceRetryTimer = 0;
+ attemptRequestedOpen();
+ }, 60);
+ }
+ function reflectUnavailable() {
+ restorePassport();
+ panel.hidden = true;
+ panel.setAttribute('data-placement-unavailable', 'true');
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.cancelWaiting'));
+ trigger.setAttribute('data-radar-space-limited', 'true');
+ trigger.title = viewerText('viewer.radar.needsSpace');
+ feedback.hidden = false;
+ scheduleSpaceRetry();
+ }
+ function attemptRequestedOpen(options) {
+ options = options || {};
+ if (!requestedOpen) return false;
+ panel.hidden = false;
+ if (!updateDocking(options)) {
+ reflectUnavailable();
+ return false;
+ }
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ reflectVisible();
+ sync();
+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();
+ return true;
+ }
+ function expandCompactRadar() {
+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;
+ yieldPassport();
+ if (!updateDocking({ allowCompact: false })) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return false;
+ }
+ }
+ reflectVisible();
+ sync();
+ if (!panel.hasAttribute('data-compact')) surface.focus();
+ return !panel.hasAttribute('data-compact');
}
function syncNow() {
syncFrame = 0;
if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;
- updateDocking();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ if (passportYielded && panel.hasAttribute('data-compact')) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ }
+ reflectVisible();
var visible = Archify.view.logicalViewport();
if (!visible) return;
viewport.setAttribute('x', String(visible.x));
@@ -11242,9 +12223,11 @@
var full = visible.width >= viewBox.width * 0.98 && visible.height >= viewBox.height * 0.98;
var mobileWide = window.innerWidth <= 720 && container.hasAttribute('data-wide-diagram');
var viewportCopy = full
- ? 'full map'
- : (mobileWide ? Math.round(visible.width / viewBox.width * 100) + '% width' : Math.round(visible.scale * 100) + '% viewport');
- status.textContent = nodes.length + ' nodes · ' + viewportCopy;
+ ? viewerText('viewer.radar.viewport.full')
+ : (mobileWide
+ ? viewerText('viewer.radar.viewport.width', { percent: Math.round(visible.width / viewBox.width * 100) })
+ : viewerText('viewer.radar.viewport.scale', { percent: Math.round(visible.scale * 100) }));
+ status.textContent = viewerText('viewer.radar.status', { count: nodes.length, viewport: viewportCopy });
nodes.forEach(function (item) {
var active = item.node.hasAttribute('data-focus-selected') ||
item.node.getAttribute('data-story-beat-state') === 'active';
@@ -11253,6 +12236,10 @@
});
}
function sync() {
+ if (requestedOpen && panel.hidden) {
+ attemptRequestedOpen();
+ return;
+ }
if (syncFrame) return;
syncFrame = requestAnimationFrame(syncNow);
}
@@ -11263,25 +12250,31 @@
if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {
Archify.semanticLens.close({ restoreFocus: false });
}
- panel.hidden = !next;
- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');
- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');
+ requestedOpen = next;
if (next) {
+ clearSpaceRetry();
+ spaceRetryCount = 0;
build();
- updateDocking();
- sync();
- if (options.focus === true) surface.focus();
+ attemptRequestedOpen(options);
} else {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ viewportDrag = null;
+ panelDrag = null;
+ container.classList.remove('is-panning');
+ panel.hidden = true;
+ resetDockingStyles();
+ restorePassport();
+ feedback.hidden = true;
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.nav.radar'));
+ trigger.title = viewerText('viewer.nav.radar.title');
if (options.restoreFocus === true) trigger.focus();
}
return next;
}
- function toggle() { return setOpen(panel.hidden, { focus: false }); }
+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }
function close(options) { return setOpen(false, options); }
function bringNodeIntoWindow(node) {
var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;
@@ -11326,31 +12319,91 @@
Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });
sync();
}
- function endDrag(event) {
- if (!drag) return;
- drag = null;
+ function endViewportDrag(event) {
+ if (!viewportDrag) return;
+ viewportDrag = null;
panel.removeAttribute('data-dragging');
container.classList.remove('is-panning');
try { surface.releasePointerCapture(event.pointerId); } catch (_) {}
}
+ function beginPanelDrag(event) {
+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;
+ var context = placementContext();
+ if (!context) return;
+ var rect = panel.getBoundingClientRect();
+ event.preventDefault();
+ event.stopPropagation();
+ panelDrag = {
+ pointerId: event.pointerId,
+ originX: event.clientX,
+ originY: event.clientY,
+ start: { left: rect.left, top: rect.top },
+ current: { left: rect.left, top: rect.top },
+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null
+ };
+ panel.setAttribute('data-panel-dragging', 'true');
+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}
+ }
+ function movePanelDrag(event) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ var context = placementContext();
+ if (!context) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var bounds = context.bounds;
+ var position = {
+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),
+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)
+ };
+ panelDrag.current = position;
+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');
+ else panel.setAttribute('data-placement-invalid', 'true');
+ applyPlacement(position, false);
+ }
+ function finishPanelDrag(event, cancel) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var activeDrag = panelDrag;
+ panelDrag = null;
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}
+ var context = placementContext();
+ if (!context) return;
+ if (cancel) {
+ manualPosition = activeDrag.previousManual;
+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };
+ updateDocking();
+ return;
+ }
+ var requested = activeDrag.current;
+ manualPosition = { left: requested.left, top: requested.top };
+ updateDocking();
+ }
trigger.addEventListener('click', toggle);
closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });
+ expandBtn.addEventListener('click', expandCompactRadar);
+ panelHead.addEventListener('pointerdown', beginPanelDrag);
+ panelHead.addEventListener('pointermove', movePanelDrag);
+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });
+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });
surface.addEventListener('pointerdown', function (event) {
if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;
event.preventDefault();
- drag = { pointerId: event.pointerId };
+ viewportDrag = { pointerId: event.pointerId };
panel.setAttribute('data-dragging', 'true');
container.classList.add('is-panning');
try { surface.setPointerCapture(event.pointerId); } catch (_) {}
navigate(event);
});
surface.addEventListener('pointermove', function (event) {
- if (!drag || drag.pointerId !== event.pointerId) return;
+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;
navigate(event);
});
- surface.addEventListener('pointerup', endDrag);
- surface.addEventListener('pointercancel', endDrag);
+ surface.addEventListener('pointerup', endViewportDrag);
+ surface.addEventListener('pointercancel', endViewportDrag);
surface.addEventListener('click', function (event) {
var node = event.target.closest('[data-radar-node-id]');
if (node) focusNode(node.getAttribute('data-radar-node-id'));
@@ -11383,8 +12436,32 @@
Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });
sync();
});
- window.addEventListener('resize', sync);
- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });
+ document.addEventListener('keydown', function (event) {
+ if (!panelDrag || event.key !== 'Escape') return;
+ finishPanelDrag({
+ pointerId: panelDrag.pointerId,
+ preventDefault: function () { event.preventDefault(); },
+ stopPropagation: function () { event.stopPropagation(); }
+ }, true);
+ }, true);
+ function reflow() {
+ if (!requestedOpen) return;
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ sync();
+ }
+ window.addEventListener('resize', reflow);
+ window.addEventListener('scroll', reflow, { passive: true });
+ if (typeof ResizeObserver === 'function') {
+ var radarResizeObserver = new ResizeObserver(function (entries) {
+ if (!requestedOpen) return;
+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;
+ reflow();
+ });
+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {
+ radarResizeObserver.observe(element);
+ });
+ }
requestAnimationFrame(build);
return {
@@ -11393,7 +12470,7 @@
toggle: toggle,
sync: sync,
focus: focusNode,
- isOpen: function () { return !panel.hidden; },
+ isOpen: function () { return requestedOpen; },
count: function () { return nodes.length; }
};
})();
@@ -11423,9 +12500,9 @@
function render(next) {
btn.setAttribute('aria-pressed', next ? 'true' : 'false');
- btn.setAttribute('aria-label', next ? 'Exit presentation stage' : 'Enter presentation stage');
- btn.title = next ? 'Exit presentation stage (F or Escape)' : 'Presentation stage (F)';
- label.textContent = next ? 'Exit' : 'Present';
+ btn.setAttribute('aria-label', viewerText(next ? 'viewer.present.exit' : 'viewer.present.enter'));
+ btn.title = viewerText(next ? 'viewer.present.exit.title' : 'viewer.present.enter.title');
+ label.textContent = viewerText(next ? 'viewer.present.exit.label' : 'viewer.present.present');
}
function setActive(next, options) {
@@ -11494,11 +12571,11 @@
function defaultContext() {
return {
kind: 'focus',
- title: 'Find a node',
- placeholder: 'Search labels or IDs',
- empty: 'No matching nodes',
- resultsLabel: 'Diagram nodes',
- availableNoun: 'nodes',
+ title: viewerText('viewer.finder.title'),
+ placeholder: viewerText('viewer.finder.placeholder'),
+ empty: viewerText('viewer.finder.empty'),
+ resultsLabel: viewerText('viewer.finder.results'),
+ availableNoun: viewerText('viewer.finder.noun.nodes'),
allowedIds: null,
badges: null
};
@@ -11623,13 +12700,13 @@
var badge = context.badges && context.badges[item.id]
? context.badges[item.id]
: context.kind === 'focus'
- ? item.links + (item.links === 1 ? ' link' : ' links')
+ ? viewerCount('viewer.finder.link', item.links)
: String(item.links);
var action = context.kind === 'route-source'
- ? 'Choose ' + item.label + ' as route start'
+ ? viewerText('viewer.finder.result.routeStart', { label: item.label })
: context.kind === 'route-target'
- ? 'Choose ' + item.label + ' as route destination, ' + badge
- : 'Focus ' + item.label + ', ' + item.links + ' related connection' + (item.links === 1 ? '' : 's');
+ ? viewerText('viewer.finder.result.routeTarget', { label: item.label, links: badge })
+ : viewerCount('viewer.finder.result.focus', item.links, { label: item.label });
button.setAttribute('aria-label', action);
var name = document.createElement('strong');
@@ -11638,8 +12715,8 @@
links.textContent = badge;
links.title = context.kind === 'focus' ? badge : action;
var meta = document.createElement('small');
- meta.textContent = [item.type, item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
- meta.title = [item.type, item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.textContent = [viewerKindLabel(item.type), item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.title = [viewerKindLabel(item.type), item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
button.appendChild(name);
button.appendChild(links);
button.appendChild(meta);
@@ -11648,8 +12725,12 @@
});
empty.hidden = visibleItems.length !== 0;
status.textContent = query
- ? visibleItems.length + ' of ' + available.length + ' ' + context.availableNoun
- : available.length + ' ' + context.availableNoun;
+ ? viewerText('viewer.finder.status.filtered', {
+ visible: visibleItems.length,
+ available: available.length,
+ noun: context.availableNoun
+ })
+ : viewerText('viewer.finder.status.all', { available: available.length, noun: context.availableNoun });
}
function open(options) {
@@ -11949,7 +13030,11 @@
item.setAttribute('data-route-journey-index', String(index));
item.setAttribute('data-route-node-id', id);
item.setAttribute('tabindex', index === 0 ? '0' : '-1');
- item.setAttribute('aria-label', 'Route position ' + (index + 1) + ' of ' + ids.length + ': ' + nodeLabel(byId[id], id));
+ item.setAttribute('aria-label', viewerText('viewer.route.position', {
+ index: index + 1,
+ total: ids.length,
+ label: nodeLabel(byId[id], id)
+ }));
}
item.className = 'route-probe-node';
item.textContent = nodeLabel(byId[id], id);
@@ -11961,7 +13046,7 @@
}
function setTrigger(active) {
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Clear traced route' : 'Trace a directed route');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.route.trigger.clear' : 'viewer.guide.route.aria'));
}
function clear(options) {
options = options || {};
@@ -11978,14 +13063,14 @@
panel.hidden = true;
panel.setAttribute('data-state', 'idle');
panel.removeAttribute('data-finder-open');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick two semantic nodes on the diagram');
- status.textContent = 'Choose the source, then the destination. Direction matters.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickTwo'));
+ status.textContent = viewerText('viewer.route.instructions');
findBtn.hidden = true;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
- copyBtn.textContent = 'Copy link';
+ copyBtn.textContent = viewerText('viewer.route.copy');
if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();
setTrigger(false);
if (wasActive && options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
@@ -12116,7 +13201,10 @@
!Archify.motionGovernor.isPaused();
}
function routeOverviewStatus() {
- return activeNodeIds.length + ' nodes · ' + activeEdges.length + ' directed hop' + (activeEdges.length === 1 ? '' : 's') + ' · shortest authored route';
+ return viewerText('viewer.route.overview.status', {
+ nodes: viewerCount('viewer.route.overview.node', activeNodeIds.length),
+ hops: viewerCount('viewer.route.overview.hop', activeEdges.length)
+ });
}
function centerJourneyButton(button) {
if (!button) return;
@@ -12146,19 +13234,19 @@
journeyPlayBtn.setAttribute('aria-pressed', journeyPlaying ? 'true' : 'false');
if (journeyPlaying) {
journeyPlayIcon.textContent = '\u275a\u275a';
- journeyPlayLabel.textContent = 'Pause';
- journeyPlayBtn.setAttribute('aria-label', 'Pause route journey');
- journeyPlayBtn.title = 'Pause route journey';
+ journeyPlayLabel.textContent = viewerText('viewer.route.pause.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.pause'));
+ journeyPlayBtn.title = viewerText('viewer.route.pause');
} else if (journeyComplete || journeyIndex === activeNodeIds.length - 1) {
journeyPlayIcon.textContent = '\u21bb';
- journeyPlayLabel.textContent = 'Replay';
- journeyPlayBtn.setAttribute('aria-label', 'Replay route journey');
- journeyPlayBtn.title = canPlay ? 'Replay route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.replay.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.replay'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.replay' : 'viewer.route.motionRequired');
} else {
journeyPlayIcon.textContent = '\u25b6';
- journeyPlayLabel.textContent = 'Journey';
- journeyPlayBtn.setAttribute('aria-label', 'Play route journey');
- journeyPlayBtn.title = canPlay ? 'Play route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.journey');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.play'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.play' : 'viewer.route.motionRequired');
}
}
function journeyGeometry(shape) {
@@ -12249,8 +13337,17 @@
else button.removeAttribute('aria-current');
});
if (options.center !== false) centerJourneyButton(buttons[journeyIndex]);
- var phase = journeyPlaying ? 'Playing' : (journeyComplete ? 'Complete' : 'Inspecting');
- status.textContent = 'Step ' + (journeyIndex + 1) + ' of ' + activeNodeIds.length + ' · ' + phase + ' · ' + nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex]);
+ var phase = viewerText(journeyPlaying
+ ? 'viewer.route.phase.playing'
+ : journeyComplete
+ ? 'viewer.route.phase.complete'
+ : 'viewer.route.phase.inspecting');
+ status.textContent = viewerText('viewer.route.step', {
+ index: journeyIndex + 1,
+ total: activeNodeIds.length,
+ phase: phase,
+ label: nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex])
+ });
if (options.pulse === true && journeyIndex > 0) renderJourneyPulse(activeEdges[journeyIndex - 1]);
if (options.reveal !== false && Archify.view && typeof Archify.view.reveal === 'function') {
Archify.view.reveal(activeNodeIds.slice(Math.max(0, journeyIndex - 1), Math.min(activeNodeIds.length, journeyIndex + 2)), {
@@ -12422,15 +13519,15 @@
});
svg.setAttribute('data-route-picking', 'target');
panel.setAttribute('data-state', 'target');
- title.textContent = 'Choose a destination from ' + nodeLabel(byId[id], id);
+ title.textContent = viewerText('viewer.route.destination', { label: nodeLabel(byId[id], id) });
renderPath([id]);
var count = Math.max(0, Object.keys(reached).length - 1);
status.textContent = count
- ? count + ' directed destination' + (count === 1 ? '' : 's') + ' available. Pick a highlighted node.'
- : 'No outgoing route starts here. Clear and choose another source.';
+ ? viewerCount('viewer.route.destination.count', count)
+ : viewerText('viewer.route.noOutgoing');
findBtn.hidden = false;
- findBtn.textContent = 'Find target';
- findBtn.setAttribute('aria-label', 'Find a reachable route destination');
+ findBtn.textContent = viewerText('viewer.route.destination.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.destination.find.aria'));
requestDocking();
return true;
}
@@ -12462,7 +13559,10 @@
renderPath(result.nodes, { interactive: true });
panel.setAttribute('data-state', 'result');
panel.hidden = false;
- title.textContent = nodeLabel(byId[startId], startId) + ' to ' + nodeLabel(byId[endId], endId);
+ title.textContent = viewerText('viewer.route.result.title', {
+ source: nodeLabel(byId[startId], startId),
+ target: nodeLabel(byId[endId], endId)
+ });
findBtn.hidden = true;
copyBtn.hidden = false;
setTrigger(true);
@@ -12484,15 +13584,18 @@
if (mode !== 'target') return false;
if (id === startId) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'Choose a different destination';
- status.textContent = 'A route needs two distinct semantic nodes.';
+ title.textContent = viewerText('viewer.route.differentDestination');
+ status.textContent = viewerText('viewer.route.distinct');
return false;
}
var result = shortestDirectedPath(startId, id);
if (!result) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'No directed route to ' + nodeLabel(byId[id], id);
- status.textContent = nodeLabel(byId[id], id) + ' is not reachable from ' + nodeLabel(byId[startId], startId) + '. Pick a highlighted destination.';
+ title.textContent = viewerText('viewer.route.unreachable', { label: nodeLabel(byId[id], id) });
+ status.textContent = viewerText('viewer.route.unreachable.detail', {
+ target: nodeLabel(byId[id], id),
+ source: nodeLabel(byId[startId], startId)
+ });
return false;
}
return showResult(result, options);
@@ -12520,12 +13623,12 @@
panel.hidden = false;
panel.setAttribute('data-state', 'source');
svg.setAttribute('data-route-picking', 'source');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick a semantic node on the diagram');
- status.textContent = 'Select the source. The next step will reveal only directed destinations.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickOne'));
+ status.textContent = viewerText('viewer.route.start.instructions');
findBtn.hidden = false;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
setTrigger(true);
if (focused && nodesById()[focused]) chooseStart(focused);
@@ -12552,14 +13655,14 @@
return outgoing[id] && outgoing[id].length;
});
var sourceBadges = {};
- sourceIds.forEach(function (id) { sourceBadges[id] = 'start'; });
+ sourceIds.forEach(function (id) { sourceBadges[id] = viewerText('viewer.route.finder.source.badge'); });
return {
kind: 'route-source',
- title: 'Choose route start',
- placeholder: 'Search route sources',
- empty: 'No matching route sources',
- resultsLabel: 'Nodes that can start a route',
- availableNoun: 'route sources',
+ title: viewerText('viewer.route.finder.source.title'),
+ placeholder: viewerText('viewer.route.finder.source.placeholder'),
+ empty: viewerText('viewer.route.finder.source.empty'),
+ resultsLabel: viewerText('viewer.route.finder.source.results'),
+ availableNoun: viewerText('viewer.route.finder.source.noun'),
allowedIds: sourceIds,
badges: sourceBadges
};
@@ -12569,15 +13672,15 @@
var targetIds = Object.keys(distances).filter(function (id) { return id !== startId && byId[id]; });
var targetBadges = {};
targetIds.forEach(function (id) {
- targetBadges[id] = distances[id] + ' hop' + (distances[id] === 1 ? '' : 's');
+ targetBadges[id] = viewerCount('viewer.route.hop', distances[id]);
});
return {
kind: 'route-target',
- title: 'Destination from ' + nodeLabel(byId[startId], startId),
- placeholder: 'Search reachable destinations',
- empty: 'No matching reachable destinations',
- resultsLabel: 'Reachable route destinations',
- availableNoun: 'reachable destinations',
+ title: viewerText('viewer.route.finder.target.title', { label: nodeLabel(byId[startId], startId) }),
+ placeholder: viewerText('viewer.route.finder.target.placeholder'),
+ empty: viewerText('viewer.route.finder.target.empty'),
+ resultsLabel: viewerText('viewer.route.finder.target.results'),
+ availableNoun: viewerText('viewer.route.finder.target.noun'),
allowedIds: targetIds,
badges: targetBadges
};
@@ -12618,11 +13721,11 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- copyBtn.setAttribute('aria-label', copied ? 'Traced route link copied' : 'Could not copy traced route link');
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ copyBtn.setAttribute('aria-label', viewerText(copied ? 'viewer.route.copy.success' : 'viewer.route.copy.failed'));
window.setTimeout(function () {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to traced route');
+ copyBtn.textContent = viewerText('viewer.route.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.route.copy.aria'));
}, 1600);
return copied;
});
@@ -12775,12 +13878,6 @@
var finePointerQuery = window.matchMedia ? window.matchMedia('(hover: hover) and (pointer: fine)') : null;
var MAX_LENS_FLOW_EDGES = 24;
- function kindLabel(value) {
- return String(value || 'neutral')
- .replace(/messagebus/gi, 'message bus')
- .replace(/[-_]+/g, ' ')
- .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
- }
function nodesById() {
var byId = {};
Array.prototype.forEach.call(svg.querySelectorAll('[data-node-id][data-node-kind]'), function (node) {
@@ -12795,7 +13892,7 @@
Object.keys(byId).forEach(function (id) {
var node = byId[id];
var value = node.getAttribute('data-node-kind') || 'neutral';
- var kind = kinds[value] || (kinds[value] = { id: value, label: kindLabel(value), nodes: [] });
+ var kind = kinds[value] || (kinds[value] = { id: value, label: viewerKindLabel(value), nodes: [] });
kind.nodes.push(node);
});
return Object.keys(kinds).map(function (key) { return kinds[key]; }).sort(function (a, b) {
@@ -12899,7 +13996,7 @@
entry.setAttribute('role', 'button');
entry.setAttribute('tabindex', legendEntries.length ? '-1' : '0');
var visibleLabel = entry.getAttribute('data-legend-label') || fact.label;
- entry.setAttribute('aria-label', 'Inspect ' + visibleLabel + ', ' + count + ' node' + (count === 1 ? '' : 's'));
+ entry.setAttribute('aria-label', viewerCount('viewer.lens.legend.inspect', count, { label: visibleLabel }));
entry.setAttribute('aria-pressed', 'false');
entry.setAttribute('aria-haspopup', 'dialog');
entry.setAttribute('aria-controls', 'semantic-lens');
@@ -12908,7 +14005,7 @@
});
if (!legendEntries.length) return false;
legendBridge.setAttribute('role', legendEntries.length >= 3 ? 'toolbar' : 'group');
- legendBridge.setAttribute('aria-label', 'Semantic legend');
+ legendBridge.setAttribute('aria-label', viewerText('viewer.lens.legend'));
syncLegendBridge();
layoutLegendBridge();
try {
@@ -13056,7 +14153,7 @@
button.className = 'semantic-lens-kind';
button.setAttribute('data-kind', kind.id);
button.setAttribute('aria-pressed', selectedKinds.indexOf(kind.id) >= 0 ? 'true' : 'false');
- button.setAttribute('aria-label', kind.label + ', ' + kind.nodes.length + ' node' + (kind.nodes.length === 1 ? '' : 's'));
+ button.setAttribute('aria-label', viewerCount('viewer.lens.kind.count', kind.nodes.length, { label: kind.label }));
button.disabled = selectedKinds.length >= 2 && selectedKinds.indexOf(kind.id) === -1;
var swatch = document.createElement('span');
swatch.className = 'semantic-lens-swatch';
@@ -13082,7 +14179,7 @@
function updateTrigger() {
var active = selectedKinds.length > 0;
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Open active semantic lens' : 'Open semantic lens');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.lens.openActive' : 'viewer.lens.open'));
copyBtn.hidden = !active;
syncLegendBridge();
}
@@ -13093,7 +14190,7 @@
}
function dockPanel(byId) {
panel.removeAttribute('data-dock-side');
- if (panel.hidden || !selectedKinds.length || window.innerWidth <= 720) return 'right';
+ if (panel.hidden || window.innerWidth <= 720) return 'right';
var panelRect = panel.getBoundingClientRect();
var containerRect = container.getBoundingClientRect();
if (!panelRect.width || !panelRect.height) return 'right';
@@ -13106,6 +14203,17 @@
var rightCandidate = { left: containerRect.right - 16 - width, right: containerRect.right - 16, top: top, bottom: panelRect.bottom };
var leftScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(leftCandidate, rect); }, 0);
var rightScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(rightCandidate, rect); }, 0);
+ var legend = svg.querySelector('[data-legend]');
+ var nav = container.querySelector('.diagram-nav');
+ var protectedRects = [legend, nav].filter(function (element) {
+ return element && !element.hidden && window.getComputedStyle(element).display !== 'none';
+ }).map(function (element) { return element.getBoundingClientRect(); });
+ leftScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(leftCandidate, rect) * 1000;
+ }, 0);
+ rightScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(rightCandidate, rect) * 1000;
+ }, 0);
var side = leftScore < rightScore ? 'left' : 'right';
panel.setAttribute('data-dock-side', side);
return side;
@@ -13117,7 +14225,7 @@
var nodeKind = {};
Object.keys(byId).forEach(function (id) { nodeKind[id] = byId[id].getAttribute('data-node-kind') || 'neutral'; });
if (!selectedKinds.length) {
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
updateTrigger();
renderKinds();
dockPanel(byId);
@@ -13172,13 +14280,18 @@
renderFlowOverlay(matchedFlow);
if (crossKind) {
var total = forward + reverse;
- status.textContent = kindLabel(selectedKinds[0]) + ' → ' + kindLabel(selectedKinds[1]) + ': ' + forward + ' · ' +
- kindLabel(selectedKinds[1]) + ' → ' + kindLabel(selectedKinds[0]) + ': ' + reverse + ' · ' +
- total + ' direct relationship' + (total === 1 ? '' : 's');
+ status.textContent = viewerCount('viewer.lens.compare', total, {
+ first: viewerKindLabel(selectedKinds[0]),
+ second: viewerKindLabel(selectedKinds[1]),
+ forward: forward,
+ reverse: reverse
+ });
} else {
var nodeCount = collectKinds().filter(function (kind) { return kind.id === selectedKinds[0]; })[0].nodes.length;
- status.textContent = nodeCount + ' ' + kindLabel(selectedKinds[0]) + ' node' + (nodeCount === 1 ? '' : 's') + ' · ' +
- touching + ' touching relationship' + (touching === 1 ? '' : 's') + ' · connected peers remain visible';
+ status.textContent = viewerText('viewer.lens.single', {
+ nodes: viewerCount('viewer.lens.node', nodeCount, { label: viewerKindLabel(selectedKinds[0]) }),
+ relationships: viewerCount('viewer.lens.relationship', touching)
+ });
}
updateTrigger();
renderKinds();
@@ -13251,7 +14364,7 @@
panel.removeAttribute('data-dock-side');
updateTrigger();
renderKinds();
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
if (options.updateUrl !== false) updateHash();
if (options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
Archify.view.reset({ automatic: true });
@@ -13279,8 +14392,8 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- window.setTimeout(function () { copyBtn.textContent = 'Copy link'; }, 1600);
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ window.setTimeout(function () { copyBtn.textContent = viewerText('viewer.common.copyLink'); }, 1600);
return copied;
});
}
@@ -13452,14 +14565,16 @@
var nodes = svg.querySelectorAll('[data-node-id]').length;
var relationships = relationshipCount();
var views = viewCount();
- stats.textContent = nodes + ' semantic node' + (nodes === 1 ? '' : 's') + ' · ' +
- relationships + ' relationship' + (relationships === 1 ? '' : 's') + ' · ' +
- views + ' guided view' + (views === 1 ? '' : 's');
+ stats.textContent = viewerText('viewer.guide.facts', {
+ nodes: viewerCount('viewer.guide.fact.node', nodes),
+ relationships: viewerCount('viewer.guide.fact.relationship', relationships),
+ views: viewerCount('viewer.guide.fact.view', views)
+ });
storyBtn.disabled = views === 0;
storyBtn.setAttribute('aria-disabled', views === 0 ? 'true' : 'false');
storyCopy.textContent = views
- ? 'Walk ' + views + ' authored chapter' + (views === 1 ? '' : 's') + ' and their real relationships.'
- : 'No authored guided story in this diagram.';
+ ? viewerCount('viewer.guide.story.available', views)
+ : viewerText('viewer.guide.story.unavailable');
}
function actionButtons() {
return Array.prototype.slice.call(actions.querySelectorAll('.diagram-guide-action:not(:disabled)'));
@@ -13470,7 +14585,7 @@
html.removeAttribute('data-guide-open');
routePanel.removeAttribute('data-guide-open');
trigger.setAttribute('aria-expanded', 'false');
- trigger.setAttribute('aria-label', 'Open diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.open'));
feedback.textContent = '';
if (options.restoreFocus !== false) trigger.focus();
return false;
@@ -13493,7 +14608,7 @@
html.setAttribute('data-guide-open', 'true');
routePanel.setAttribute('data-guide-open', 'true');
trigger.setAttribute('aria-expanded', 'true');
- trigger.setAttribute('aria-label', 'Close diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.close'));
feedback.textContent = '';
requestAnimationFrame(function () {
var first = actionButtons()[0];
@@ -13505,7 +14620,7 @@
function execute(action) {
feedback.textContent = '';
if (action === 'story' && !viewCount()) {
- feedback.textContent = 'This diagram has no authored guided story.';
+ feedback.textContent = viewerText('viewer.guide.noStory');
return false;
}
close({ restoreFocus: false });
diff --git a/examples/archify-repo.html b/examples/archify-repo.html
index 018c8227..14ab404c 100644
--- a/examples/archify-repo.html
+++ b/examples/archify-repo.html
@@ -3,7 +3,7 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="generator" content="archify 2.15.0">
+ <meta name="generator" content="archify 2.16.0-dev.0">
<title>Archify Diagram</title>
<script>
// Resolve the theme before first paint so light-preference users don't
@@ -586,10 +586,13 @@
justify-content: center;
min-height: 0;
padding: 0.75rem;
+ padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -655,7 +658,7 @@
}
html[data-preset="signal-flow"] .header-row::after {
- content: "SIGNAL FLOW";
+ content: attr(data-preset-badge-signal-flow);
margin-left: auto;
color: var(--frontend-stroke);
border: 1px solid var(--frontend-stroke);
@@ -679,7 +682,7 @@
animation: none;
}
html[data-preset="blueprint"] .header-row::after {
- content: "BLUEPRINT / REV 01";
+ content: attr(data-preset-badge-blueprint);
margin-left: auto;
padding: 0.28rem 0.55rem;
border-top: 1px solid var(--frontend-stroke);
@@ -708,7 +711,7 @@
animation: none;
}
html[data-preset="editorial"] .header-row::after {
- content: "EDITORIAL / FIELD NOTE";
+ content: attr(data-preset-badge-editorial);
margin-left: auto;
padding: 0.32rem 0 0.24rem;
border-bottom: 2px solid var(--arrow-emphasis);
@@ -722,10 +725,12 @@
}
.diagram-container {
+ --archify-nav-reserve: 0px;
background: var(--panel);
border-radius: 1rem;
border: 1px solid var(--panel-border);
padding: 1.5rem;
+ padding-bottom: calc(1.5rem + var(--archify-nav-reserve));
overflow: hidden;
position: relative;
}
@@ -785,7 +790,7 @@
border: 1px solid var(--panel-border);
background: var(--panel);
color: var(--arrow-emphasis);
- content: "ARCHIFY / PLATE 04";
+ content: attr(data-preset-badge-editorial-plate);
font-family: Georgia, 'Times New Roman', serif;
font-size: 0.52rem;
font-style: italic;
@@ -1052,7 +1057,7 @@
.overview-map {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 12;
width: 11.25rem;
overflow: hidden;
@@ -1085,6 +1090,36 @@
padding: 0.42rem 0.48rem 0.38rem 0.55rem;
border-bottom: 1px solid var(--toolbar-border);
background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);
+ cursor: grab;
+ touch-action: none;
+ user-select: none;
+ }
+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }
+ .overview-map[data-placement-invalid="true"] {
+ border-color: var(--security-stroke);
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);
+ }
+ .overview-map[data-compact="true"] {
+ width: 7.4rem;
+ }
+ .overview-map[data-compact="true"] .overview-map-head {
+ grid-template-columns: minmax(0, 1fr) auto;
+ gap: 0.24rem;
+ min-height: 1.5rem;
+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;
+ border-bottom: 0;
+ }
+ .overview-map[data-compact="true"] .overview-map-live,
+ .overview-map[data-compact="true"] .overview-map-copy,
+ .overview-map[data-compact="true"] .overview-map-surface,
+ .overview-map[data-compact="true"] .overview-map-hint {
+ display: none;
+ }
+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }
+ .overview-map[data-compact="true"] .overview-map-close {
+ width: 1.15rem;
+ height: 1.15rem;
+ font-size: 0.72rem;
}
.overview-map-live {
width: 0.42rem;
@@ -1115,6 +1150,26 @@
white-space: nowrap;
text-overflow: ellipsis;
}
+ .overview-map-expand {
+ display: none;
+ align-items: center;
+ justify-content: center;
+ min-width: 0;
+ height: 1.2rem;
+ padding: 0 0.34rem;
+ overflow: hidden;
+ border: 0;
+ border-radius: 0.3rem;
+ background: transparent;
+ color: var(--frontend-stroke);
+ font: inherit;
+ font-size: 0.49rem;
+ font-weight: 700;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ white-space: nowrap;
+ cursor: pointer;
+ }
.overview-map-close {
width: 1.55rem;
height: 1.55rem;
@@ -1127,8 +1182,11 @@
font-size: 0.9rem;
cursor: pointer;
}
+ .overview-map-expand:hover,
+ .overview-map-expand:focus-visible,
.overview-map-close:hover,
.overview-map-close:focus-visible { background: var(--toolbar-hover); }
+ .overview-map-expand:focus-visible,
.overview-map-close:focus-visible,
.overview-map-surface:focus-visible,
.overview-map-node:focus-visible {
@@ -1210,6 +1268,24 @@
color: var(--frontend-stroke);
background: var(--toolbar-hover);
}
+ .overview-map-feedback {
+ position: absolute;
+ right: 1rem;
+ bottom: 4.15rem;
+ z-index: 13;
+ max-width: min(16rem, calc(100% - 2rem));
+ padding: 0.38rem 0.55rem;
+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));
+ border-radius: 0.5rem;
+ background: var(--toolbar-menu-bg);
+ color: var(--toolbar-text);
+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+ font-size: 0.52rem;
+ line-height: 1.35;
+ pointer-events: none;
+ }
+ .overview-map-feedback[hidden] { display: none; }
+ .focus-chip[data-radar-yielded="true"] { display: none !important; }
.diagram-nav #btn-route-probe[aria-pressed="true"] {
color: var(--backend-stroke);
background: var(--toolbar-hover);
@@ -1226,7 +1302,7 @@
.semantic-lens {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 24;
width: min(20rem, calc(100% - 2rem));
overflow: hidden;
@@ -1401,7 +1477,7 @@
.route-probe {
position: absolute;
left: 1rem;
- bottom: 1rem;
+ bottom: calc(1rem + var(--archify-nav-reserve));
z-index: 12;
width: min(46rem, calc(100% - 25rem));
min-width: 18rem;
@@ -2800,13 +2876,22 @@
scrolling at 900–1080px heights. */
@media (min-width: 768px) and (max-height: 1100px) {
.header { margin-bottom: 1rem; }
- .diagram-container { padding: 0.875rem; }
+ .diagram-container {
+ padding: 0.875rem;
+ padding-bottom: calc(0.875rem + var(--archify-nav-reserve));
+ }
.cards { margin-top: 1rem; }
.card { padding: 1rem; }
}
@media (min-width: 768px) and (max-height: 920px) {
+ body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -2921,6 +3006,7 @@
svg[data-chapter-preview] [data-node-id],
svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }
.diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }
+ .diagram-container { --archify-nav-reserve: 0px !important; }
html[data-preset="signal-flow"] .diagram-container,
html[data-preset="signal-flow"] .card { background: #ffffff; }
.cards { grid-template-columns: 1fr 1fr; }
@@ -3572,16 +3658,17 @@
width: min(10.25rem, calc(100% - 1rem));
}
.overview-map[data-docked="true"] {
- right: 0.5rem;
+ right: var(--archify-radar-right, 0.5rem);
top: var(--archify-radar-top, 0.5rem);
bottom: auto;
transform: none !important;
}
.overview-map[data-docked="true"][data-dock-side="left"] {
right: auto;
- left: 0.5rem;
+ left: var(--archify-radar-left, 0.5rem);
}
.overview-map-surface { height: 4rem; }
+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }
.semantic-lens {
right: 0.5rem;
bottom: 3.7rem;
@@ -4863,7 +4950,10 @@
<div class="container">
<!-- Header -->
<div class="header">
- <div class="header-row">
+ <div class="header-row"
+ data-preset-badge-signal-flow="SIGNAL FLOW"
+ data-preset-badge-blueprint="BLUEPRINT / REV 01"
+ data-preset-badge-editorial="EDITORIAL / FIELD NOTE">
<div class="pulse-dot"></div>
<h1>Archify</h1>
</div>
@@ -4872,6 +4962,7 @@
<script id="archify-guided-views-data" type="application/json">[]</script>
+ <script id="archify-i18n-data" type="application/json">{"locale":"en","messages":{"viewer.kind.frontend":"Frontend","viewer.kind.backend":"Backend","viewer.kind.database":"Database","viewer.kind.cloud":"Cloud","viewer.kind.security":"Security","viewer.kind.messagebus":"Message bus","viewer.kind.external":"External","viewer.kind.neutral":"Neutral","viewer.kind.node":"Node","viewer.kind.start":"Start","viewer.kind.active":"Active","viewer.kind.waiting":"Waiting","viewer.kind.decision":"Decision","viewer.kind.success":"Success","viewer.kind.failure":"Failure","viewer.toolbar.actions":"Diagram actions","viewer.theme.toggle.title":"Toggle theme (T)","viewer.theme.toggle":"Toggle color theme","viewer.theme.dark":"Dark","viewer.theme.light":"Light","viewer.preset.choose.title":"Choose visual style (S cycles)","viewer.preset.choose":"Choose visual style","viewer.preset.style":"Style","viewer.preset.menu":"Visual style","viewer.preset.identity":"Visual identity","viewer.preset.cycles":"S cycles","viewer.preset.classic":"Classic","viewer.preset.classic.short":"Classic","viewer.preset.classic.hint":"Stable technical default","viewer.preset.flow":"Signal Flow","viewer.preset.flow.short":"Flow","viewer.preset.flow.hint":"Motion-forward presentation","viewer.preset.blueprint":"Blueprint","viewer.preset.blueprint.hint":"Engineering review","viewer.preset.editorial":"Editorial","viewer.preset.editorial.hint":"Publication and launch notes","viewer.preset.badge.signalFlow":"SIGNAL FLOW","viewer.preset.badge.blueprint":"BLUEPRINT / REV 01","viewer.preset.badge.editorial":"EDITORIAL / FIELD NOTE","viewer.preset.badge.editorialPlate":"ARCHIFY / PLATE 04","viewer.preset.current":"Visual style: {style}. Choose visual style","viewer.motion.live":"Live","viewer.motion.still":"Still","viewer.motion.pause":"Pause motion","viewer.motion.resume":"Resume motion","viewer.motion.reduced":"Motion paused by reduced-motion preference","viewer.motion.hidden":"Motion paused while this page is hidden","viewer.motion.yielding":"Pause motion; currently yielding to {owner}","viewer.motion.yielding.title":"Live preview enabled · yielding to {owner}","viewer.owner.story":"the guided story","viewer.owner.chapter":"the active chapter","viewer.owner.chapterPreview":"the chapter delta preview","viewer.owner.handoff":"the chapter handoff","viewer.owner.route":"Route Probe","viewer.owner.lens":"Semantic Lens","viewer.owner.relationship":"Relationship Preview","viewer.owner.intent":"Intent Trace","viewer.owner.focus":"semantic focus","viewer.owner.legend":"legend preview","viewer.owner.reader":"reader interaction","viewer.present.enter":"Enter presentation stage","viewer.present.enter.title":"Presentation stage (F)","viewer.present.exit":"Exit presentation stage","viewer.present.exit.title":"Exit presentation stage (F or Escape)","viewer.present.present":"Present","viewer.present.exit.label":"Exit","viewer.export.button":"Export","viewer.export.button.title":"Export diagram (E)","viewer.export.diagram":"Export diagram","viewer.export.menu":"Export","viewer.export.subtitle":"Portable, clean outputs","viewer.export.share":"Share","viewer.export.shareCard":"Share Card","viewer.export.routeShareCard":"Route Share Card","viewer.export.reachShareCard":"Reach Share Card","viewer.export.copyShareCard":"Copy Share Card","viewer.export.copyDiagram":"Copy diagram","viewer.export.clipboardPng":"PNG to clipboard","viewer.export.raster":"Raster images","viewer.export.image":"Image","viewer.export.lossless":"Lossless image","viewer.export.compact":"Compact image","viewer.export.modern":"Modern image","viewer.export.vectorMotion":"Vector and motion","viewer.export.vectorMotion.heading":"Vector \u0026 motion","viewer.export.editable":"Editable vector","viewer.export.motion6s":"6s motion","viewer.export.unsupported":"Not supported by this browser","viewer.export.clipboardUnsupported":"Clipboard image write not supported by this browser","viewer.export.clipboardUnsupported.period":"Clipboard image write not supported by this browser.","viewer.export.clipboardUnsupported.short":"Clipboard image write not supported in this browser.","viewer.export.motionUnavailable":"Motion capture unavailable in this browser","viewer.export.webmUnavailable":"WebM unavailable in this browser","viewer.export.failed":"Export failed: {message}","viewer.export.unknownVariant":"Unknown Share Card variant: {variant}","viewer.export.routeRequired":"Trace a route before exporting a Route Share Card","viewer.export.reachRequired":"Trace authored reach before exporting a Reach Share Card","viewer.export.unknown":"unknown","viewer.export.routeFailed":"Route Share Card export failed: {message}","viewer.export.reachFailed":"Reach Share Card export failed: {message}","viewer.export.copyFailed":"Copy failed: {message}","viewer.export.copiedPng":"Copied PNG to clipboard","viewer.export.copiedShare":"Copied Share Card","viewer.export.downloadedShare":"Downloaded Share Card","viewer.export.downloadedRoute":"Downloaded Route Share Card","viewer.export.downloadedReach":"Downloaded Reach Share Card","viewer.export.downloadedWebm":"Downloaded WebM","viewer.export.recording":"Recording 6 seconds of motion…","viewer.export.card.routeSummary.one":"Route: {source} → {target} · {count} directed hop","viewer.export.card.routeSummary.other":"Route: {source} → {target} · {count} directed hops","viewer.export.card.reachSummary":"Authored {direction} from {origin} · {nodes} · {links} · max {hops}","viewer.export.card.node.one":"{count} node","viewer.export.card.node.other":"{count} nodes","viewer.export.card.link.one":"{count} link","viewer.export.card.link.other":"{count} links","viewer.export.card.hop.one":"{count} hop","viewer.export.card.hop.other":"{count} hops","viewer.export.card.routeBadge":"ARCHIFY · ROUTE · {hops}","viewer.export.card.reachBadge":"ARCHIFY · {direction} REACH","viewer.export.card.defaultBadge":"ARCHIFY · {preset} · {theme}","viewer.export.direction.upstream":"Upstream","viewer.export.direction.downstream":"Downstream","viewer.export.error.canvasUnavailable":"Canvas unavailable for {label}","viewer.export.error.contextUnavailable":"2D canvas context unavailable for {label}","viewer.export.error.toBlobUnavailable":"canvas.toBlob unavailable for {label}","viewer.export.error.toBlobNull":"canvas.toBlob returned no data for {label}","viewer.export.error.variantsCombined":"Share Card variants cannot be combined","viewer.export.error.viewerState":"Share Card export could not remove temporary viewer state","viewer.export.error.routeState":"Route Card export could not preserve the resolved route safely","viewer.export.error.reachState":"Reach Card export could not preserve authored reach safely","viewer.export.error.webmRequirements":"WebM motion export requires a trace animation and browser MediaRecorder support","viewer.export.error.mediaRecorder":"MediaRecorder failed","viewer.export.error.emptyWebm":"MediaRecorder produced an empty WebM","viewer.export.error.webmBackground":"SVG background could not be loaded for WebM export","viewer.guided.region":"Guided diagram views","viewer.guided.previous":"Previous guided view","viewer.guided.previous.title":"Previous guided view ([)","viewer.guided.next":"Next guided view","viewer.guided.next.title":"Next guided view (])","viewer.guided.views":"Guided views","viewer.guided.explore":"Explore this system","viewer.guided.intro":"Step through curated paths without changing the source diagram.","viewer.guided.trail":"Story trail","viewer.guided.beat":"Beat","viewer.guided.nextBeat":"Next","viewer.guided.play":"Play guided story","viewer.guided.play.title":"Play guided story (P)","viewer.guided.pause":"Pause guided story","viewer.guided.pause.title":"Pause guided story (P)","viewer.guided.replay":"Replay guided story","viewer.guided.replay.title":"Replay guided story (P)","viewer.guided.playStory":"Play story","viewer.guided.pauseStory":"Pause","viewer.guided.replayStory":"Replay story","viewer.guided.motionUnavailable":"Story playback unavailable while motion is Still","viewer.guided.enableMotion":"Switch motion to Live to play the guided story","viewer.guided.selectBeatLink":"Select a Story Beat to copy its exact link","viewer.guided.copyMoment":"Copy moment","viewer.guided.momentCopied":"Moment link copied","viewer.guided.momentCopyFailed":"Could not copy story moment link","viewer.guided.copied":"Copied","viewer.guided.copyFailed":"Copy failed","viewer.guided.showAll":"Show all","viewer.guided.showAll.aria":"Show entire diagram","viewer.guided.chapters":"Story chapters","viewer.guided.storyTrail":"Story trail for {label}: {count} beats","viewer.guided.chapter.open":"Open chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.current":"Current chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.selectedNodes":"{count} selected nodes","viewer.guided.chapter.stops":"{count} stops","viewer.guided.chapter.stop.one":"{count} stop","viewer.guided.chapter.stop.other":"{count} stops","viewer.guided.chapter.current.title":"{label} — current chapter, {count} stops","viewer.guided.chapter.delta.expanded":"{stay} stay, {enter} enter, {leave} leave","viewer.guided.chapter.delta.aria":"Open chapter {index} of {total}: {label}. Chapter focus delta: {delta}","viewer.guided.chapter.delta.title":"{label} — {delta} chapter focus","viewer.guided.handoff":"{from} → {to} · via {label}","viewer.guided.share.chapter":"Chapter {index} / {total}","viewer.guided.share.initial":"Chapter 01 / 01","viewer.guided.share.default":"Guided chapter","viewer.guided.state.ready":"Ready","viewer.guided.state.playing":"Playing","viewer.guided.state.settled":"Settled","viewer.guided.state.paused":"Paused","viewer.guided.state.pinned":"Pinned","viewer.guided.state.still":"Still","viewer.guided.share.step":"Step {index} / {total} · {label}","viewer.guided.share.staticMoment":"{step} · Static moment","viewer.guided.share.complete":"{count} steps complete · {note}","viewer.guided.share.settled":"Path settled for reading.","viewer.guided.share.staticPath":"{count} steps · Static path","viewer.guided.share.ready":"{count} steps · Ready","viewer.guided.share.aria":"{state} chapter {index} of {total}: {label}. {beat}. {route}","viewer.guided.beat.start":"Beat {index} / {total} · {label} · starting point","viewer.guided.beat.forward":"Beat {index} / {total} · {from} → {to}","viewer.guided.beat.reverse":"Beat {index} / {total} · {from} → {to} · reverse authored link","viewer.guided.beat.multiple":"Beat {index} / {total} · {from} ⇄ {to} · {count} authored links","viewer.guided.beat.group":"Beat {index} / {total} · {from} · {to} · grouped · no direct link","viewer.guided.beat.aria.prefix":"Story beat {index} of {total}: {label}. ","viewer.guided.beat.aria.start":"Starting point.","viewer.guided.beat.aria.forward":"From {from} through one authored forward relationship.","viewer.guided.beat.aria.reverse":"From {from}; the authored relationship points from {to} to {from}.","viewer.guided.beat.aria.multiple":"From {from} through {count} authored relationships; shown without arbitrary motion.","viewer.guided.beat.aria.group":"Grouped from {from} with no direct authored relationship.","viewer.guided.caption.start":"Starting point","viewer.guided.caption.grouped":"Grouped transition · no direct authored link","viewer.guided.caption.more":" +{count} more","viewer.guided.caption.reverse":"Reverse authored relationship","viewer.guided.caption.relationships":"{count} authored relationships","viewer.guided.caption.relationship":"Authored relationship","viewer.guided.caption.direction":"authored direction: {from} → {to}","viewer.guided.caption.starting":"Authored starting point","viewer.guided.beatLink":"Copy link to current story moment: Beat {index} of {total}: {label}","viewer.guided.noStory":"This diagram has no authored guided story.","viewer.guide.eyebrow":"Diagram guide","viewer.guide.close":"Close diagram guide","viewer.guide.inspecting":"Inspecting compiled semantics","viewer.guide.actions":"Diagram exploration actions","viewer.guide.find":"Find any node","viewer.guide.find.hint":"Search labels, responsibilities, kinds, and stable IDs.","viewer.guide.route":"Trace a route","viewer.guide.route.aria":"Trace a directed route","viewer.guide.route.hint":"Ask how two semantic nodes connect in authored direction.","viewer.guide.map":"See the whole system","viewer.guide.map.hint":"Open Semantic Radar with a live viewport and stable nodes.","viewer.guide.lens":"Compare semantic kinds","viewer.guide.lens.hint":"Count roles, reveal their traffic, and compare direct authored links.","viewer.guide.story":"Play the guided story","viewer.guide.story.hint":"Walk the authored chapters and real relationships.","viewer.guide.present":"Enter Presentation Stage","viewer.guide.present.hint":"Give the live diagram the viewport without changing export.","viewer.guide.shortcuts":"Additional keyboard shortcuts","viewer.guide.shortcut.export":"Export","viewer.guide.shortcut.theme":"Theme","viewer.guide.shortcut.style":"Style","viewer.guide.shortcut.reset":"Reset","viewer.guide.shortcut.zoomIn":"Zoom in","viewer.guide.shortcut.zoomOut":"Zoom out","viewer.guide.shortcut.close":"Close","viewer.guide.facts":"{nodes} · {relationships} · {views}","viewer.guide.fact.node.one":"{count} semantic node","viewer.guide.fact.node.other":"{count} semantic nodes","viewer.guide.fact.relationship.one":"{count} relationship","viewer.guide.fact.relationship.other":"{count} relationships","viewer.guide.fact.view.one":"{count} guided view","viewer.guide.fact.view.other":"{count} guided views","viewer.guide.story.available.one":"Walk {count} authored chapter and its real relationships.","viewer.guide.story.available.other":"Walk {count} authored chapters and their real relationships.","viewer.guide.story.unavailable":"No authored guided story in this diagram.","viewer.guide.open":"Open diagram guide","viewer.guide.noStory":"This diagram has no authored guided story.","viewer.finder.title":"Find a node","viewer.finder.close":"Close node finder","viewer.finder.placeholder":"Search labels or IDs","viewer.finder.search":"Search diagram nodes","viewer.finder.results":"Diagram nodes","viewer.finder.empty":"No matching nodes","viewer.finder.result.focus":"Focus {label}","viewer.finder.result.routeStart":"Choose {label} as route start","viewer.finder.result.routeTarget":"Choose {label} as route destination, {links}","viewer.finder.status.empty":"No matching nodes","viewer.finder.status.count.one":"{count} matching node","viewer.finder.status.count.other":"{count} matching nodes","viewer.finder.noun.nodes":"nodes","viewer.finder.link.one":"{count} link","viewer.finder.link.other":"{count} links","viewer.finder.result.focus.one":"Focus {label}, {count} related connection","viewer.finder.result.focus.other":"Focus {label}, {count} related connections","viewer.finder.status.filtered":"{visible} of {available} {noun}","viewer.finder.status.all":"{available} {noun}","viewer.passport.eyebrow":"Semantic passport","viewer.passport.metadata":"Node metadata","viewer.passport.evidence":"Verified source evidence","viewer.passport.verified":"Verified source","viewer.passport.reach":"Authored reach","viewer.passport.reach.trace":"Trace authored reachability","viewer.passport.upstream":"Upstream","viewer.passport.downstream":"Downstream","viewer.passport.upstream.trace":"Trace upstream authored reachability","viewer.passport.downstream.trace":"Trace downstream authored reachability","viewer.passport.close":"Close semantic passport","viewer.passport.copy":"Copy link","viewer.passport.copy.focus":"Copy link to focused node","viewer.passport.relations":"Relations","viewer.passport.relations.show":"Show connected relationships","viewer.passport.relations.hide":"Hide connected relationships","viewer.passport.relations.list":"Connected relationships","viewer.passport.copyRelation":"Copy relation","viewer.passport.copyNode":"Copy node","viewer.passport.copyPinned":"Copy link to pinned relationship","viewer.passport.copySource":"Copy link to source node","viewer.passport.copy.focused.success":"Focused node link copied","viewer.passport.copy.pinned.success":"Pinned relationship link copied","viewer.passport.copy.focused.failed":"Could not copy focused node link","viewer.passport.copy.pinned.failed":"Could not copy pinned relationship link","viewer.passport.relationship.none":"No connected relationships","viewer.passport.relationship.count.one":"{count} relation","viewer.passport.relationship.count.other":"{count} relations","viewer.passport.relationship.show.one":"Show {count} connected relationship","viewer.passport.relationship.show.other":"Show {count} connected relationships","viewer.passport.relationship.summary":"{out} outgoing · {in} incoming{loops}","viewer.passport.relationship.loops":" · {count} loop","viewer.passport.relationship.explorer":"Direct relationship explorer","viewer.passport.relationship.help":"Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.","viewer.passport.relationship.loopsBack":"loops back","viewer.passport.relationship.connectsTo":"connects to","viewer.passport.relationship.connectsFrom":"connects from","viewer.passport.relationship.pinned":"Pinned relationship · {from} → {to} · {label}","viewer.passport.relationship.inspect":"Inspect relationship {index} of {total}: {from} to {to}, {label}. Press Enter for details.","viewer.passport.relationship.group.out":"Outgoing","viewer.passport.relationship.group.in":"Incoming","viewer.passport.relationship.group.loop":"Self loops","viewer.passport.relationship.row":"{group}: {relationship}, {neighbor}","viewer.passport.relationship.direction.out":"OUT →","viewer.passport.relationship.direction.in":"← IN","viewer.passport.relationship.direction.loop":"LOOP","viewer.passport.sourceCount.one":"{count} verified source reference","viewer.passport.sourceCount.other":"{count} verified source references","viewer.passport.sourceMarker":"SRC","viewer.passport.beacon.one":"{count} verified source; focus this node to inspect","viewer.passport.beacon.other":"{count} verified sources; focus this node to inspect","viewer.passport.repository.open":"Open verified repository revision {revision}","viewer.passport.source.open":"Open verified source {path} at revision {revision}","viewer.passport.source.openLink":"Open ↗","viewer.passport.reach.upstream.one":"Trace {count} upstream authored node","viewer.passport.reach.upstream.other":"Trace {count} upstream authored nodes","viewer.passport.reach.downstream.one":"Trace {count} downstream authored node","viewer.passport.reach.downstream.other":"Trace {count} downstream authored nodes","viewer.passport.reach.noUpstream":"No upstream authored nodes","viewer.passport.reach.noDownstream":"No downstream authored nodes","viewer.passport.reach.status":"{direction} · {nodes} nodes · {links} links · max {hops} hops","viewer.route.eyebrow":"Route probe","viewer.route.start":"Choose a start node","viewer.route.start.find":"Find start","viewer.route.start.find.aria":"Find a route start","viewer.route.copy":"Copy link","viewer.route.copy.aria":"Copy link to traced route","viewer.route.clear":"Clear","viewer.route.clear.aria":"Clear route probe","viewer.route.traced":"Traced route","viewer.route.pickTwo":"Pick two semantic nodes on the diagram","viewer.route.pickOne":"Pick a semantic node on the diagram","viewer.route.controls":"Route journey controls","viewer.route.previous":"Previous route position","viewer.route.play":"Play route journey","viewer.route.pause":"Pause route journey","viewer.route.replay":"Replay route journey","viewer.route.next":"Next route position","viewer.route.journey":"Journey","viewer.route.pause.label":"Pause","viewer.route.replay.label":"Replay","viewer.route.overview":"Overview","viewer.route.overview.aria":"Show complete route overview","viewer.route.instructions":"Choose the source, then the destination. Direction matters.","viewer.route.destination":"Choose a destination from {label}","viewer.route.destination.find":"Find target","viewer.route.destination.find.aria":"Find a reachable route destination","viewer.route.differentDestination":"Choose a different destination","viewer.route.distinct":"A route needs two distinct semantic nodes.","viewer.route.unreachable":"No directed route to {label}","viewer.route.unreachable.detail":"{target} is not reachable from {source}. Pick a highlighted destination.","viewer.route.start.instructions":"Select the source. The next step will reveal only directed destinations.","viewer.route.copy.success":"Traced route link copied","viewer.route.copy.failed":"Could not copy traced route link","viewer.route.position":"Route position {index} of {total}: {label}","viewer.route.step":"Step {index} of {total} · {phase} · {label}","viewer.route.motionRequired":"Automatic journey requires Live motion","viewer.route.trigger.clear":"Clear traced route","viewer.route.overview.status":"{nodes} · {hops} · shortest authored route","viewer.route.overview.node.one":"{count} node","viewer.route.overview.node.other":"{count} nodes","viewer.route.overview.hop.one":"{count} directed hop","viewer.route.overview.hop.other":"{count} directed hops","viewer.route.phase.playing":"Playing","viewer.route.phase.complete":"Complete","viewer.route.phase.inspecting":"Inspecting","viewer.route.destination.count.one":"{count} directed destination available. Pick a highlighted node.","viewer.route.destination.count.other":"{count} directed destinations available. Pick a highlighted node.","viewer.route.noOutgoing":"No outgoing route starts here. Clear and choose another source.","viewer.route.result.title":"{source} to {target}","viewer.route.finder.source.title":"Choose route start","viewer.route.finder.source.placeholder":"Search route sources","viewer.route.finder.source.empty":"No matching route sources","viewer.route.finder.source.results":"Nodes that can start a route","viewer.route.finder.source.noun":"route sources","viewer.route.finder.source.badge":"start","viewer.route.finder.target.title":"Destination from {label}","viewer.route.finder.target.placeholder":"Search reachable destinations","viewer.route.finder.target.empty":"No matching reachable destinations","viewer.route.finder.target.results":"Reachable route destinations","viewer.route.finder.target.noun":"reachable destinations","viewer.route.hop.one":"{count} hop","viewer.route.hop.other":"{count} hops","viewer.lens.eyebrow":"Semantic lens","viewer.lens.title":"Compare system roles","viewer.lens.close":"Close semantic lens","viewer.lens.instruction":"Choose up to two semantic kinds. One reveals its real traffic; two compare only direct authored relationships.","viewer.lens.kinds":"Semantic kinds","viewer.lens.choose":"Choose a kind to inspect its nodes and touching relationships.","viewer.lens.copy":"Copy link to semantic lens","viewer.lens.clear":"Clear semantic lens","viewer.lens.open":"Open semantic lens","viewer.lens.openActive":"Open active semantic lens","viewer.lens.legend":"Semantic legend","viewer.lens.legend.inspect.one":"Inspect {label}, {count} node","viewer.lens.legend.inspect.other":"Inspect {label}, {count} nodes","viewer.lens.kind.count.one":"{label}, {count} node","viewer.lens.kind.count.other":"{label}, {count} nodes","viewer.lens.compare.one":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationship","viewer.lens.compare.other":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationships","viewer.lens.single":"{nodes} · {relationships} · connected peers remain visible","viewer.lens.node.one":"{count} {label} node","viewer.lens.node.other":"{count} {label} nodes","viewer.lens.relationship.one":"{count} touching relationship","viewer.lens.relationship.other":"{count} touching relationships","viewer.radar.title":"Semantic radar","viewer.radar.building":"Building overview","viewer.radar.openFull":"Open full semantic radar","viewer.radar.open":"Open radar","viewer.radar.close":"Close semantic radar","viewer.radar.surface":"Diagram overview. Click a node to focus it, or use arrow keys to pan.","viewer.radar.click":"Click node","viewer.radar.drag":"Drag to pan","viewer.radar.space":"Semantic radar needs more MAP space.","viewer.radar.nodes":"Semantic diagram radar nodes","viewer.radar.focus":"Focus {label} from Semantic Radar","viewer.radar.status":"{count} nodes · {viewport}","viewer.radar.fullMap":"{count} nodes · full map","viewer.radar.compacted":"Radar compacted to avoid covering the Semantic Passport or MAP controls.","viewer.radar.cancelWaiting":"Cancel semantic radar waiting for more MAP space","viewer.radar.needsSpace":"Semantic radar needs more visible MAP space","viewer.radar.viewport.full":"full map","viewer.radar.viewport.width":"{percent}% width","viewer.radar.viewport.scale":"{percent}% viewport","viewer.nav.controls":"Diagram view controls","viewer.nav.route":"Trace a directed route","viewer.nav.route.title":"Trace route (R)","viewer.nav.route.short":"PATH","viewer.nav.radar":"Open semantic radar","viewer.nav.radar.title":"Semantic radar (M)","viewer.nav.radar.short":"MAP","viewer.nav.lens":"Open semantic lens","viewer.nav.lens.title":"Semantic lens (L)","viewer.nav.lens.short":"LENS","viewer.nav.find":"Find a node","viewer.nav.find.title":"Find a node (/)","viewer.nav.guide":"Open diagram guide","viewer.nav.guide.title":"Diagram guide (?)","viewer.nav.zoomOut":"Zoom out","viewer.nav.zoomOut.title":"Zoom out (-)","viewer.nav.reset":"Reset diagram view","viewer.nav.reset.title":"Reset view (0)","viewer.nav.read":"READ","viewer.nav.zoomIn":"Zoom in","viewer.nav.zoomIn.title":"Zoom in (+)","viewer.nav.camera":"{hint}. Reset diagram view","viewer.nav.camera.title":"{semantic}{hint} · reset view (0)","viewer.nav.camera.semantic":"Semantic camera active · ","viewer.nav.level.map":"MAP","viewer.nav.level.read":"READ","viewer.nav.level.full":"FULL","viewer.nav.level.auto":"AUTO","viewer.nav.detail.map":"Zoom in to reveal relationship labels and node context","viewer.nav.detail.read":"Zoom in again to reveal tags and annotations","viewer.nav.detail.full":"Full diagram detail","viewer.intent.summary":"{label}. {out} outgoing, {in} incoming{loops}. {total} connections. Press Enter for details.","viewer.intent.loops":", {count} self loop","viewer.common.copied":"Copied","viewer.common.copyFailed":"Copy failed","viewer.common.copyLink":"Copy link","viewer.common.clear":"Clear","viewer.common.close":"Close"}}</script>
<div class="guided-views no-print" id="guided-views" hidden aria-label="Guided diagram views">
<button id="guided-view-prev" type="button" aria-label="Previous guided view" title="Previous guided view ([)">&#8592;</button>
<div class="guided-view-copy">
@@ -4912,8 +5003,9 @@
</div>
<!-- Main Diagram -->
- <div class="diagram-container" data-detail-level="read">
- <svg viewBox="0 0 1340 568" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
+ <div class="diagram-container" data-detail-level="read"
+ data-preset-badge-editorial-plate="ARCHIFY / PLATE 04">
+ <svg viewBox="0 0 1340 568" role="img" lang="en" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
<title id="archify-diagram-title">Archify</title>
<desc id="archify-diagram-description">Agent skill → JSON IR → typed renderers → standalone HTML</desc>
<!-- Definitions -->
@@ -5114,7 +5206,7 @@
<!-- Boundary labels (foreground masks keep routes out of titles) -->
<g data-graph-role="structural-frame-label" data-composition-frame-id="0" data-composition-frame-kind="region" data-composition-frame-label="archify/ skill package">
<rect data-graph-role="structural-frame-label-mask" x="374" y="120" width="128.8" height="16" rx="3" class="c-mask"/>
- <text x="378" y="133" class="t-cloud" font-size="9" font-weight="600">archify/ skill package</text>
+ <text data-boundary-label="" x="378" y="133" class="t-cloud" font-size="9" font-weight="600">archify/ skill package</text>
</g>
<!-- Legend -->
@@ -5310,11 +5402,13 @@
<strong id="overview-map-title">Semantic radar</strong>
<small id="overview-map-status" aria-live="polite">Building overview</small>
</span>
+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button>
<button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">&#215;</button>
</div>
<div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div>
<div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div>
</div>
+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p>
<div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls">
<button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button>
<button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>
@@ -5370,6 +5464,37 @@
<script>
var Archify = {};
+ var archifyI18nData = (function () {
+ var node = document.getElementById('archify-i18n-data');
+ try { return JSON.parse(node ? node.textContent : '{}'); }
+ catch (_) { return { locale: 'en', messages: {} }; }
+ })();
+ Archify.locale = archifyI18nData.locale || 'en';
+
+ function viewerText(key, values) {
+ var messages = archifyI18nData.messages || {};
+ var template = Object.prototype.hasOwnProperty.call(messages, key) ? messages[key] : key;
+ return String(template).replace(/\{([a-zA-Z0-9_]+)\}/g, function (match, name) {
+ return values && Object.prototype.hasOwnProperty.call(values, name) ? String(values[name]) : match;
+ });
+ }
+
+ function viewerCount(key, count, values) {
+ var suffix = Number(count) === 1 ? '.one' : '.other';
+ var payload = Object.assign({}, values || {}, { count: count });
+ return viewerText(key + suffix, payload);
+ }
+
+ function viewerKindLabel(value) {
+ var normalized = String(value || 'node').toLowerCase();
+ var knownKey = 'viewer.kind.' + normalized;
+ var known = viewerText(knownKey);
+ if (known !== knownKey) return known;
+ return normalized
+ .replace(/messagebus/gi, 'message bus')
+ .replace(/[-_]+/g, ' ')
+ .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
+ }
function hasDrawableGeometry(element) {
if (!element) return false;
@@ -5400,7 +5525,12 @@
============================================================ */
Archify.preset = (function () {
var PRESETS = ['classic', 'signal-flow', 'blueprint', 'editorial'];
- var LABELS = { classic: 'Classic', 'signal-flow': 'Flow', blueprint: 'Blueprint', editorial: 'Editorial' };
+ var LABELS = {
+ classic: viewerText('viewer.preset.classic.short'),
+ 'signal-flow': viewerText('viewer.preset.flow.short'),
+ blueprint: viewerText('viewer.preset.blueprint'),
+ editorial: viewerText('viewer.preset.editorial')
+ };
var html = document.documentElement;
var svg = document.querySelector('.diagram-container svg');
var btn = document.getElementById('btn-preset');
@@ -5427,8 +5557,8 @@
svg.setAttribute('data-preset', preset);
btn.setAttribute('data-preset-option', preset);
label.textContent = LABELS[preset];
- btn.setAttribute('aria-label', 'Visual style: ' + LABELS[preset] + '. Choose visual style');
- btn.title = 'Choose visual style (S cycles)';
+ btn.setAttribute('aria-label', viewerText('viewer.preset.current', { style: LABELS[preset] }));
+ btn.title = viewerText('viewer.preset.choose.title');
options().forEach(function (option) {
var selected = option.getAttribute('data-preset-value') === preset;
option.setAttribute('aria-checked', String(selected));
@@ -5540,7 +5670,7 @@
function apply(theme) {
html.setAttribute('data-theme', theme);
- label.textContent = theme === 'dark' ? 'Dark' : 'Light';
+ label.textContent = viewerText(theme === 'dark' ? 'viewer.theme.dark' : 'viewer.theme.light');
btn.setAttribute('aria-pressed', theme === 'light' ? 'true' : 'false');
}
@@ -5589,6 +5719,18 @@
var SHARE_CARD_PADDING = 36;
var SHARE_CARD_HEADER = 112;
+ function exportError(key, values) {
+ var error = new Error(viewerText(key, values));
+ error.archifyViewerMessage = true;
+ return error;
+ }
+
+ function exportMessage(error) {
+ return error && error.archifyViewerMessage
+ ? error.message
+ : viewerText('viewer.export.unknown');
+ }
+
function diagramFilename() {
var title = (document.title || 'diagram')
.replace(/\s+Architecture(\s+Diagram)?$/i, '')
@@ -5791,6 +5933,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -5965,6 +6108,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -6184,7 +6328,7 @@
format === 'webp' ? 'image/webp' : 'image/png';
var quality = format === 'png' ? undefined : 0.95;
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for ' + format));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: format }));
else resolve(blob);
}, mime, quality);
} catch (error) {
@@ -6220,11 +6364,11 @@
function canvas2dOrThrow(canvas, label) {
if (!canvas || typeof canvas.getContext !== 'function') {
- throw new Error('Canvas unavailable for ' + label);
+ throw exportError('viewer.export.error.canvasUnavailable', { label: label });
}
var ctx = canvas.getContext('2d');
- if (!ctx) throw new Error('2D canvas context unavailable for ' + label);
- if (typeof canvas.toBlob !== 'function') throw new Error('canvas.toBlob unavailable for ' + label);
+ if (!ctx) throw exportError('viewer.export.error.contextUnavailable', { label: label });
+ if (typeof canvas.toBlob !== 'function') throw exportError('viewer.export.error.toBlobUnavailable', { label: label });
return ctx;
}
@@ -6232,14 +6376,14 @@
options = options || {};
var routeSnapshot = options.routeSnapshot || null;
var reachSnapshot = options.reachSnapshot || null;
- if (routeSnapshot && reachSnapshot) return Promise.reject(new Error('Share Card variants cannot be combined'));
+ if (routeSnapshot && reachSnapshot) return Promise.reject(exportError('viewer.export.error.variantsCombined'));
var svg = document.querySelector('.diagram-container svg');
var vb = svg.viewBox.baseVal;
var sourceScale = Math.min(2, pickSafeScale(vb.width, vb.height));
var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot, reachSnapshot: reachSnapshot });
- if (!data.canonicalStateClean) return Promise.reject(new Error('Share Card export could not remove temporary viewer state'));
- if (routeSnapshot && !data.routeStateClean) return Promise.reject(new Error('Route Card export could not preserve the resolved route safely'));
- if (reachSnapshot && !data.reachStateClean) return Promise.reject(new Error('Reach Card export could not preserve authored reach safely'));
+ if (!data.canonicalStateClean) return Promise.reject(exportError('viewer.export.error.viewerState'));
+ if (routeSnapshot && !data.routeStateClean) return Promise.reject(exportError('viewer.export.error.routeState'));
+ if (reachSnapshot && !data.reachStateClean) return Promise.reject(exportError('viewer.export.error.reachState'));
var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });
var svgUrl = URL.createObjectURL(svgBlob);
@@ -6250,7 +6394,7 @@
var canvas = document.createElement('canvas');
canvas.width = SHARE_CARD_WIDTH;
canvas.height = SHARE_CARD_HEIGHT;
- var ctx = canvas2dOrThrow(canvas, 'Share Card');
+ var ctx = canvas2dOrThrow(canvas, viewerText('viewer.export.shareCard'));
var computed = getComputedStyle(document.documentElement);
var bg = computed.getPropertyValue('--bg').trim() || currentBg();
var text = computed.getPropertyValue('--text').trim() || '#ffffff';
@@ -6263,21 +6407,37 @@
var titleNode = document.querySelector('.header h1');
var subtitleNode = document.querySelector('.header .subtitle');
var title = titleNode ? titleNode.textContent : document.title;
+ var directionLabel = reachSnapshot
+ ? viewerText('viewer.export.direction.' + reachSnapshot.direction)
+ : '';
var subtitle = routeSnapshot
- ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'
+ ? viewerCount('viewer.export.card.routeSummary', routeSnapshot.hops, {
+ source: routeSnapshot.source.label,
+ target: routeSnapshot.target.label
+ })
: reachSnapshot
- ? 'Authored ' + reachSnapshot.direction + ' from ' + reachSnapshot.origin.label + ' · ' +
- (reachSnapshot.nodeIds.length - 1) + ' nodes · ' + reachSnapshot.edges.length +
- ' links · max ' + reachSnapshot.maxDepth + ' hops'
+ ? viewerText('viewer.export.card.reachSummary', {
+ direction: directionLabel,
+ origin: reachSnapshot.origin.label,
+ nodes: viewerCount('viewer.export.card.node', reachSnapshot.nodeIds.length - 1),
+ links: viewerCount('viewer.export.card.link', reachSnapshot.edges.length),
+ hops: viewerCount('viewer.export.card.hop', reachSnapshot.maxDepth)
+ })
: subtitleNode ? subtitleNode.textContent : '';
var preset = document.documentElement.getAttribute('data-preset') || 'classic';
var theme = document.documentElement.getAttribute('data-theme') || 'dark';
- var presetLabel = preset === 'signal-flow' ? 'FLOW' : preset.toUpperCase();
+ var presetKey = preset === 'signal-flow'
+ ? 'viewer.preset.flow.short'
+ : 'viewer.preset.' + preset;
+ var presetLabel = viewerText(presetKey).toUpperCase();
+ var themeLabel = viewerText('viewer.theme.' + theme).toUpperCase();
var cardLabel = routeSnapshot
- ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'
+ ? viewerText('viewer.export.card.routeBadge', {
+ hops: viewerCount('viewer.export.card.hop', routeSnapshot.hops).toUpperCase()
+ })
: reachSnapshot
- ? 'ARCHIFY · ' + reachSnapshot.direction.toUpperCase() + ' REACH'
- : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();
+ ? viewerText('viewer.export.card.reachBadge', { direction: directionLabel.toUpperCase() })
+ : viewerText('viewer.export.card.defaultBadge', { preset: presetLabel, theme: themeLabel });
ctx.fillStyle = bg;
ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);
@@ -6315,7 +6475,7 @@
URL.revokeObjectURL(svgUrl);
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for Share Card'));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: viewerText('viewer.export.shareCard') }));
else resolve(blob);
}, 'image/png');
} catch (error) {
@@ -6335,17 +6495,17 @@
options = options || {};
if (!options.variant) return renderShareCard();
if (options.variant !== 'route' && options.variant !== 'reach') {
- return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));
+ return Promise.reject(exportError('viewer.export.unknownVariant', { variant: options.variant }));
}
if (options.variant === 'route') {
var routeSnapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
- if (!routeSnapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ if (!routeSnapshot) return Promise.reject(exportError('viewer.export.routeRequired'));
return renderShareCard({ routeSnapshot: routeSnapshot });
}
var snapshot = Archify.focus && typeof Archify.focus.reachabilitySnapshot === 'function'
? Archify.focus.reachabilitySnapshot()
: null;
- if (!snapshot) return Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ if (!snapshot) return Promise.reject(exportError('viewer.export.reachRequired'));
return renderShareCard({ reachSnapshot: snapshot });
}
@@ -6379,7 +6539,7 @@
function recordWebm(options) {
options = options || {};
if (!canRecordMotion()) {
- return Promise.reject(new Error('WebM motion export requires a trace animation and browser MediaRecorder support'));
+ return Promise.reject(exportError('viewer.export.error.webmRequirements'));
}
var duration = Math.max(250, Number(options.duration) || MOTION_DURATION);
var fps = Math.max(1, Number(options.fps) || MOTION_FPS);
@@ -6577,12 +6737,12 @@
};
recorder.onerror = function (event) {
cleanup();
- reject(event.error || new Error('MediaRecorder failed'));
+ reject(event.error || exportError('viewer.export.error.mediaRecorder'));
};
recorder.onstop = function () {
cleanup();
var blob = new Blob(chunks, { type: recorder.mimeType || mime });
- if (!blob.size) reject(new Error('MediaRecorder produced an empty WebM'));
+ if (!blob.size) reject(exportError('viewer.export.error.emptyWebm'));
else resolve(blob);
};
drawMotionFrame(ctx, backgroundImage, motionScene, 0);
@@ -6603,7 +6763,7 @@
};
backgroundImage.onerror = function () {
URL.revokeObjectURL(sourceUrl);
- reject(new Error('SVG background could not be loaded for WebM export'));
+ reject(exportError('viewer.export.error.webmBackground'));
};
backgroundImage.src = sourceUrl;
});
@@ -6661,11 +6821,11 @@
items().forEach(function (it) {
if (it.dataset.format && !supports(it.dataset.format)) {
it.disabled = true;
- it.title = 'Not supported by this browser';
+ it.title = viewerText('viewer.export.unsupported');
}
if ((it.dataset.action === 'copy' || it.dataset.action === 'copy-share-card') && !canCopyImage()) {
it.disabled = true;
- it.title = 'Clipboard image write not supported by this browser';
+ it.title = viewerText('viewer.export.clipboardUnsupported');
}
});
@@ -6756,12 +6916,12 @@
var base = diagramFilename();
close(true);
clearExportReceipt();
- if (format === 'webm') toast('Recording 6 seconds of motion…');
+ if (format === 'webm') toast(viewerText('viewer.export.recording'));
return (format === 'share-card'
? rasterizeShareCard().then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
download(blob, base + '-share-card.png');
- toast('Downloaded Share Card');
+ toast(viewerText('viewer.export.downloadedShare'));
})
: format === 'svg'
? Promise.resolve(serializeSvg(1, { autoTheme: true })).then(function (d) {
@@ -6774,7 +6934,7 @@
document.documentElement.setAttribute('data-last-motion-bytes', String(blob.size));
recordExportReceipt('webm', blob, true);
download(blob, base + '.webm');
- toast('Downloaded WebM');
+ toast(viewerText('viewer.export.downloadedWebm'));
})
: rasterize(format).then(function (blob) {
recordExportReceipt(format, blob, true);
@@ -6782,20 +6942,21 @@
})
).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : format;
+ var technicalMessage = err && err.message ? err.message : format;
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', format);
- document.documentElement.setAttribute('data-last-export-error', message);
- if (format === 'webm' && /MediaRecorder|WebM motion export|empty WebM/i.test(message)) {
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ if (format === 'webm') {
var motionItem = menu.querySelector('button[data-format="webm"]');
if (motionItem) {
motionItem.disabled = true;
- motionItem.title = 'Motion capture unavailable in this browser';
+ motionItem.title = viewerText('viewer.export.motionUnavailable');
motionItem.style.opacity = '0.5';
}
- toast('WebM unavailable in this browser');
+ toast(viewerText('viewer.export.webmUnavailable'));
return;
}
- alert('Export failed: ' + message);
+ alert(viewerText('viewer.export.failed', { message: message }));
});
}
@@ -6805,18 +6966,19 @@
var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
var blobPromise = snapshot
? renderShareCard({ routeSnapshot: snapshot })
- : Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ : Promise.reject(exportError('viewer.export.routeRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'route', true);
download(blob, diagramFilename() + '-route-share-card.png');
- toast('Downloaded Route Share Card');
+ toast(viewerText('viewer.export.downloadedRoute'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Route Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.routeFailed', { message: message }));
});
}
@@ -6828,18 +6990,19 @@
: null;
var blobPromise = snapshot
? renderShareCard({ reachSnapshot: snapshot })
- : Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ : Promise.reject(exportError('viewer.export.reachRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'reach', false, true);
download(blob, diagramFilename() + '-' + snapshot.direction + '-reach-share-card.png');
- toast('Downloaded Reach Share Card');
+ toast(viewerText('viewer.export.downloadedReach'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Reach Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.reachFailed', { message: message }));
});
}
@@ -6904,21 +7067,22 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported by this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.period'));
return;
}
var blobPromise = rasterizeShareCard();
return writePngToClipboard(blobPromise).then(function () {
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
- toast('Copied Share Card');
+ toast(viewerText('viewer.export.copiedShare'));
});
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'unknown';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Copy failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.copyFailed', { message: message }));
});
}
@@ -6926,15 +7090,17 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported in this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.short'));
return;
}
var blobPromise = rasterize('png');
return writePngToClipboard(blobPromise).then(function () {
- toast('Copied PNG to clipboard');
+ toast(viewerText('viewer.export.copiedPng'));
}).catch(function (err) {
console.error(err);
- alert('Copy failed: ' + (err && err.message ? err.message : 'unknown'));
+ alert(viewerText('viewer.export.copyFailed', {
+ message: exportMessage(err)
+ }));
});
}
@@ -7060,17 +7226,17 @@
return readerPaused || reducedMotion() || hasSuspension();
}
function ownerLabel(value) {
- if (value === 'story') return 'the guided story';
- if (value === 'chapter') return 'the active chapter';
- if (value === 'chapter-preview') return 'the chapter delta preview';
- if (value === 'handoff') return 'the chapter handoff';
- if (value === 'route') return 'Route Probe';
- if (value === 'lens') return 'Semantic Lens';
- if (value === 'relationship') return 'Relationship Preview';
- if (value === 'intent') return 'Intent Trace';
- if (value === 'focus') return 'semantic focus';
- if (value === 'legend') return 'legend preview';
- return 'reader interaction';
+ if (value === 'story') return viewerText('viewer.owner.story');
+ if (value === 'chapter') return viewerText('viewer.owner.chapter');
+ if (value === 'chapter-preview') return viewerText('viewer.owner.chapterPreview');
+ if (value === 'handoff') return viewerText('viewer.owner.handoff');
+ if (value === 'route') return viewerText('viewer.owner.route');
+ if (value === 'lens') return viewerText('viewer.owner.lens');
+ if (value === 'relationship') return viewerText('viewer.owner.relationship');
+ if (value === 'intent') return viewerText('viewer.owner.intent');
+ if (value === 'focus') return viewerText('viewer.owner.focus');
+ if (value === 'legend') return viewerText('viewer.owner.legend');
+ return viewerText('viewer.owner.reader');
}
function render() {
if (!capable) return;
@@ -7084,7 +7250,7 @@
}
btn.setAttribute('aria-pressed', paused ? 'false' : 'true');
btn.disabled = systemPaused;
- label.textContent = paused ? 'Still' : 'Live';
+ label.textContent = viewerText(paused ? 'viewer.motion.still' : 'viewer.motion.live');
if (paused && lastEffectivePaused !== true && Archify.guidedViews && Archify.guidedViews.isPlaying()) {
Archify.guidedViews.pause();
}
@@ -7097,20 +7263,20 @@
lastEffectivePaused = paused;
if (Archify.routeProbe && typeof Archify.routeProbe.syncMotion === 'function') Archify.routeProbe.syncMotion();
if (systemPaused) {
- btn.setAttribute('aria-label', 'Motion paused by reduced-motion preference');
- btn.title = 'Motion paused by reduced-motion preference';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.reduced'));
+ btn.title = viewerText('viewer.motion.reduced');
} else if (hasSuspension()) {
- btn.setAttribute('aria-label', 'Motion paused while this page is hidden');
- btn.title = 'Motion paused while this page is hidden';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.hidden'));
+ btn.title = viewerText('viewer.motion.hidden');
} else if (paused) {
- btn.setAttribute('aria-label', 'Resume motion');
- btn.title = 'Resume motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.resume'));
+ btn.title = viewerText('viewer.motion.resume');
} else if (owner) {
- btn.setAttribute('aria-label', 'Pause motion; currently yielding to ' + ownerLabel(owner));
- btn.title = 'Live preview enabled · yielding to ' + ownerLabel(owner);
+ btn.setAttribute('aria-label', viewerText('viewer.motion.yielding', { owner: ownerLabel(owner) }));
+ btn.title = viewerText('viewer.motion.yielding.title', { owner: ownerLabel(owner) });
} else {
- btn.setAttribute('aria-label', 'Pause motion');
- btn.title = 'Pause motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.pause'));
+ btn.title = viewerText('viewer.motion.pause');
}
}
function setPaused(next, options) {
@@ -7281,7 +7447,7 @@
if (!box || !Number.isFinite(box.x) || !Number.isFinite(box.y) || !Number.isFinite(box.width) || box.width < 36) return;
var count = sources.length;
- var label = count + ' verified source' + (count === 1 ? '' : 's') + '; focus this node to inspect';
+ var label = viewerCount('viewer.passport.beacon', count);
var beacon = document.createElementNS(svgNamespace, 'g');
beacon.classList.add('source-evidence-beacon');
beacon.setAttribute('data-source-evidence-beacon', '');
@@ -7297,7 +7463,7 @@
var text = document.createElementNS(svgNamespace, 'text');
text.setAttribute('x', '15');
text.setAttribute('y', '8.25');
- text.textContent = 'SRC ' + count;
+ text.textContent = viewerText('viewer.passport.sourceMarker') + ' ' + count;
beacon.appendChild(title);
beacon.appendChild(plate);
beacon.appendChild(text);
@@ -7306,7 +7472,7 @@
var originalLabel = node.getAttribute('aria-label') || '';
node.setAttribute('data-source-evidence-count', String(count));
node.setAttribute('data-source-evidence-original-label', originalLabel);
- node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + count + ' verified source reference' + (count === 1 ? '' : 's'));
+ node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + viewerCount('viewer.passport.sourceCount', count));
installed += 1;
});
return installed;
@@ -7484,11 +7650,11 @@
upstreamBtn.disabled = upstreamReach === 0;
downstreamBtn.disabled = downstreamReach === 0;
upstreamBtn.setAttribute('aria-label', upstreamReach
- ? 'Trace ' + upstreamReach + ' upstream authored node' + (upstreamReach === 1 ? '' : 's')
- : 'No upstream authored nodes');
+ ? viewerCount('viewer.passport.reach.upstream', upstreamReach)
+ : viewerText('viewer.passport.reach.noUpstream'));
downstreamBtn.setAttribute('aria-label', downstreamReach
- ? 'Trace ' + downstreamReach + ' downstream authored node' + (downstreamReach === 1 ? '' : 's')
- : 'No downstream authored nodes');
+ ? viewerCount('viewer.passport.reach.downstream', downstreamReach)
+ : viewerText('viewer.passport.reach.noDownstream'));
reachSection.hidden = false;
}
function applyReachability(direction, options) {
@@ -7534,11 +7700,15 @@
var activeButton = direction === 'upstream' ? upstreamBtn : downstreamBtn;
activeButton.setAttribute('aria-pressed', 'true');
var reachableCount = result.nodeIds.length - 1;
- var directionLabel = direction === 'upstream' ? 'Upstream' : 'Downstream';
- reachStatus.textContent = directionLabel + ' · ' + reachableCount + ' node' +
- (reachableCount === 1 ? '' : 's') + ' · ' + result.edgeKeys.length + ' link' +
- (result.edgeKeys.length === 1 ? '' : 's') + ' · max ' + result.maxDepth + ' hop' +
- (result.maxDepth === 1 ? '' : 's');
+ var directionLabel = viewerText(direction === 'upstream'
+ ? 'viewer.passport.upstream'
+ : 'viewer.passport.downstream');
+ reachStatus.textContent = viewerText('viewer.passport.reach.status', {
+ direction: directionLabel,
+ nodes: reachableCount,
+ links: result.edgeKeys.length,
+ hops: result.maxDepth
+ });
reachStatus.hidden = false;
if (Archify.exportMenu && typeof Archify.exportMenu.syncReachShare === 'function') {
Archify.exportMenu.syncReachShare();
@@ -7665,7 +7835,7 @@
var slug = repository.url.replace(/^https:\/\/github\.com\//, '').replace(/\/$/, '');
repositoryLink.href = repository.url + '/tree/' + repository.revision;
repositoryLink.textContent = slug + ' @ ' + repository.shortRevision;
- repositoryLink.setAttribute('aria-label', 'Open verified repository revision ' + repository.revision);
+ repositoryLink.setAttribute('aria-label', viewerText('viewer.passport.repository.open', { revision: repository.revision }));
sources.forEach(function (source) {
var link = document.createElement('a');
link.className = 'semantic-passport-source';
@@ -7673,13 +7843,13 @@
link.target = '_blank';
link.rel = 'noopener noreferrer';
link.referrerPolicy = 'no-referrer';
- link.setAttribute('aria-label', 'Open verified source ' + source.path + ' at revision ' + repository.shortRevision);
+ link.setAttribute('aria-label', viewerText('viewer.passport.source.open', { path: source.path, revision: repository.shortRevision }));
var name = document.createElement('strong');
name.textContent = source.label || source.path.split('/').pop() || source.path;
var location = document.createElement('code');
location.textContent = source.line
? 'L' + source.line + (source.endLine && source.endLine !== source.line ? '–' + source.endLine : '') + ' ↗'
- : 'Open ↗';
+ : viewerText('viewer.passport.source.openLink');
var sourcePath = document.createElement('small');
sourcePath.textContent = source.path;
link.appendChild(name);
@@ -7691,7 +7861,7 @@
}
function renderPassport(id, node) {
setPassportValue(detail, node.getAttribute('data-node-sublabel'));
- setPassportValue(kind, node.getAttribute('data-node-kind') || 'node');
+ setPassportValue(kind, viewerKindLabel(node.getAttribute('data-node-kind') || 'node'));
setPassportValue(context, node.getAttribute('data-node-context'));
setPassportValue(tag, node.getAttribute('data-node-tag'));
setPassportValue(document.getElementById('focus-brand'), node.getAttribute('data-node-brand'));
@@ -7722,7 +7892,11 @@
direction: direction,
neighborId: neighborId,
neighborLabel: neighbor ? nodeLabel(neighbor, neighborId) : neighborId,
- label: edgeLabel || (direction === 'loop' ? 'loops back' : direction === 'out' ? 'connects to' : 'connects from')
+ label: edgeLabel || viewerText(direction === 'loop'
+ ? 'viewer.passport.relationship.loopsBack'
+ : direction === 'out'
+ ? 'viewer.passport.relationship.connectsTo'
+ : 'viewer.passport.relationship.connectsFrom')
});
});
return relationships;
@@ -7765,7 +7939,9 @@
fromLabel: byId[from] ? nodeLabel(byId[from], from) : from,
toLabel: byId[to] ? nodeLabel(byId[to], to) : to,
labelValue: labelValue,
- label: labelValue || (from === to ? 'loops back' : 'connects to'),
+ label: labelValue || viewerText(from === to
+ ? 'viewer.passport.relationship.loopsBack'
+ : 'viewer.passport.relationship.connectsTo'),
edge: edge,
shapes: shapes,
invalid: false
@@ -7792,14 +7968,14 @@
function renderRelationshipCopyAction() {
var record = pinnedRelationshipRecord();
if (record && record.id) {
- copyBtn.textContent = 'Copy relation';
- copyBtn.setAttribute('aria-label', 'Copy link to pinned relationship');
+ copyBtn.textContent = viewerText('viewer.passport.copyRelation');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copyPinned'));
} else if (pinnedRelationshipKey) {
- copyBtn.textContent = 'Copy node';
- copyBtn.setAttribute('aria-label', 'Copy link to source node');
+ copyBtn.textContent = viewerText('viewer.passport.copyNode');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copySource'));
} else {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
}
}
function relationshipHitGeometry(shape, className) {
@@ -8118,7 +8294,11 @@
var target = relationshipHitTarget(key);
if (target) target.setAttribute('aria-pressed', 'true');
renderRelationshipCopyAction();
- summary.textContent = 'Pinned relationship · ' + record.fromLabel + ' → ' + record.toLabel + ' · ' + record.label;
+ summary.textContent = viewerText('viewer.passport.relationship.pinned', {
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
revealPinnedRelationship(record);
if (options.updateUrl !== false && record.id) {
try { history.replaceState(null, '', location.pathname + location.search + '#relation=' + encodeURIComponent(record.id)); } catch (_) {}
@@ -8137,10 +8317,10 @@
relationshipHitOverlay.setAttribute('class', 'relationship-hit-overlay');
relationshipHitOverlay.setAttribute('data-relationship-hit-overlay', '');
relationshipHitOverlay.setAttribute('role', 'group');
- relationshipHitOverlay.setAttribute('aria-label', 'Direct relationship explorer');
+ relationshipHitOverlay.setAttribute('aria-label', viewerText('viewer.passport.relationship.explorer'));
var relationshipHelp = document.createElementNS(svgNamespace, 'desc');
relationshipHelp.id = 'archify-relationship-help';
- relationshipHelp.textContent = 'Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.';
+ relationshipHelp.textContent = viewerText('viewer.passport.relationship.help');
relationshipHitOverlay.appendChild(relationshipHelp);
records.forEach(function (record, index) {
var target = document.createElementNS(svgNamespace, 'g');
@@ -8154,7 +8334,13 @@
target.setAttribute('tabindex', index === 0 ? '0' : '-1');
target.setAttribute('aria-pressed', 'false');
target.setAttribute('aria-describedby', relationshipHelp.id);
- var description = 'Inspect relationship ' + (index + 1) + ' of ' + records.length + ': ' + record.fromLabel + ' to ' + record.toLabel + ', ' + record.label + '. Press Enter for details.';
+ var description = viewerText('viewer.passport.relationship.inspect', {
+ index: index + 1,
+ total: records.length,
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
target.setAttribute('aria-label', description);
var title = document.createElementNS(svgNamespace, 'title');
title.textContent = record.fromLabel + ' \u2192 ' + record.toLabel + ' \u00b7 ' + record.label;
@@ -8250,25 +8436,29 @@
var relationships = relationshipsFor(id, byId);
chip.removeAttribute('data-relations-expanded');
relationsBtn.setAttribute('aria-expanded', 'false');
- relationsBtn.textContent = relationships.length + ' relation' + (relationships.length === 1 ? '' : 's');
- relationsBtn.setAttribute('aria-label', 'Show ' + relationships.length + ' connected relationship' + (relationships.length === 1 ? '' : 's'));
+ relationsBtn.textContent = viewerCount('viewer.passport.relationship.count', relationships.length);
+ relationsBtn.setAttribute('aria-label', viewerCount('viewer.passport.relationship.show', relationships.length));
var counts = { out: 0, in: 0, loop: 0 };
relationships.forEach(function (relationship) { counts[relationship.direction] += 1; });
- summary.textContent = counts.out + ' outgoing · ' + counts.in + ' incoming' + (counts.loop ? ' · ' + counts.loop + ' loop' : '');
+ summary.textContent = viewerText('viewer.passport.relationship.summary', {
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.passport.relationship.loops', { count: counts.loop }) : ''
+ });
renderReachabilityControls(id);
relationshipList.textContent = '';
if (!relationships.length) {
var empty = document.createElement('p');
empty.className = 'relationship-lens-empty';
- empty.textContent = 'No connected relationships';
+ empty.textContent = viewerText('viewer.passport.relationship.none');
relationshipList.appendChild(empty);
return;
}
[
- { id: 'out', label: 'Outgoing' },
- { id: 'in', label: 'Incoming' },
- { id: 'loop', label: 'Self loops' }
+ { id: 'out', label: viewerText('viewer.passport.relationship.group.out') },
+ { id: 'in', label: viewerText('viewer.passport.relationship.group.in') },
+ { id: 'loop', label: viewerText('viewer.passport.relationship.group.loop') }
].forEach(function (group) {
var items = relationships.filter(function (relationship) { return relationship.direction === group.id; });
if (!items.length) return;
@@ -8288,11 +8478,19 @@
button.setAttribute('data-relationship-from', relationship.from);
button.setAttribute('data-relationship-to', relationship.to);
if (relationship.id) button.setAttribute('data-relationship-id', relationship.id);
- button.setAttribute('aria-label', group.label + ': ' + relationship.label + ', ' + relationship.neighborLabel);
+ button.setAttribute('aria-label', viewerText('viewer.passport.relationship.row', {
+ group: group.label,
+ relationship: relationship.label,
+ neighbor: relationship.neighborLabel
+ }));
var direction = document.createElement('span');
direction.className = 'relationship-lens-direction';
direction.setAttribute('aria-hidden', 'true');
- direction.textContent = relationship.direction === 'out' ? 'OUT →' : relationship.direction === 'in' ? '← IN' : 'LOOP';
+ direction.textContent = viewerText(relationship.direction === 'out'
+ ? 'viewer.passport.relationship.direction.out'
+ : relationship.direction === 'in'
+ ? 'viewer.passport.relationship.direction.in'
+ : 'viewer.passport.relationship.direction.loop');
var target = document.createElement('strong');
target.textContent = relationship.neighborLabel;
var relation = document.createElement('small');
@@ -8343,6 +8541,45 @@
preferred = nodeCenter - chip.offsetHeight / 2;
}
var top = Math.max(minTop, Math.min(maxTop, preferred));
+ var chipRect = chip.getBoundingClientRect();
+ var safeGap = 10;
+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;
+ var protectedRects = (protectViewerChrome
+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]
+ : [])
+ .filter(function (element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ })
+ .map(function (element) { return element.getBoundingClientRect(); })
+ .filter(function (rect) {
+ return rect.width > 0 && rect.height > 0 &&
+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;
+ });
+ if (protectedRects.length) {
+ var candidates = [top, minTop, maxTop];
+ protectedRects.forEach(function (rect) {
+ candidates.push(
+ rect.top - containerRect.top - chip.offsetHeight - safeGap,
+ rect.bottom - containerRect.top + safeGap
+ );
+ });
+ var valid = candidates.map(function (candidate) {
+ return Math.max(minTop, Math.min(maxTop, candidate));
+ }).filter(function (candidate, index, all) {
+ if (all.indexOf(candidate) !== index) return false;
+ var candidateTop = containerRect.top + candidate;
+ var candidateBottom = candidateTop + chip.offsetHeight;
+ return protectedRects.every(function (rect) {
+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;
+ });
+ });
+ valid.sort(function (first, second) {
+ return Math.abs(first - preferred) - Math.abs(second - preferred);
+ });
+ if (valid.length) top = valid[0];
+ }
chip.style.top = Math.round(top) + 'px';
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
}
@@ -8393,10 +8630,10 @@
upstreamBtn.disabled = true;
downstreamBtn.disabled = true;
relationshipList.textContent = '';
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
- relationsBtn.textContent = 'Relations';
- relationsBtn.setAttribute('aria-label', 'Show connected relationships');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
+ relationsBtn.textContent = viewerText('viewer.passport.relations');
+ relationsBtn.setAttribute('aria-label', viewerText('viewer.passport.relations.show'));
relationsBtn.setAttribute('aria-expanded', 'false');
chip.removeAttribute('data-relations-expanded');
chip.style.removeProperty('top');
@@ -8464,7 +8701,7 @@
svg.setAttribute('data-focus-active', normalized.join(' '));
var defaultLabel = normalized.length === 1
? nodeLabel(byId[normalized[0]], normalized[0])
- : normalized.length + ' selected nodes';
+ : viewerText('viewer.guided.chapter.selectedNodes', { count: normalized.length });
label.textContent = options.label || defaultLabel;
chip.hidden = options.hideChip === true || normalized.length !== 1 || selectionMode;
if (!chip.hidden) {
@@ -8510,10 +8747,10 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
copyBtn.setAttribute('aria-label', copied
- ? (relationId ? 'Pinned relationship link copied' : 'Focused node link copied')
- : (relationId ? 'Could not copy pinned relationship link' : 'Could not copy focused node link'));
+ ? viewerText(relationId ? 'viewer.passport.copy.pinned.success' : 'viewer.passport.copy.focused.success')
+ : viewerText(relationId ? 'viewer.passport.copy.pinned.failed' : 'viewer.passport.copy.focused.failed'));
window.setTimeout(function () {
renderRelationshipCopyAction();
}, 1600);
@@ -8552,7 +8789,9 @@
if (expanded) chip.removeAttribute('data-relations-expanded');
else chip.setAttribute('data-relations-expanded', 'true');
relationsBtn.setAttribute('aria-expanded', expanded ? 'false' : 'true');
- relationsBtn.setAttribute('aria-label', expanded ? 'Show connected relationships' : 'Hide connected relationships');
+ relationsBtn.setAttribute('aria-label', viewerText(expanded
+ ? 'viewer.passport.relations.show'
+ : 'viewer.passport.relations.hide'));
requestLensPlacement();
});
relationshipList.addEventListener('click', function (event) {
@@ -8614,7 +8853,7 @@
var target = event.target;
if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;
if (container.getAttribute('data-just-panned') === 'true') return;
- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;
+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;
clear();
}, true);
window.addEventListener('scroll', requestLensPlacement, { passive: true });
@@ -8838,9 +9077,13 @@
svg.setAttribute('data-intent-trace-active', id);
if (options.announce === true) {
var total = counts.out + counts.in + counts.loop;
- status.textContent = nodeLabel(selected, id) + '. ' + counts.out + ' outgoing, ' +
- counts.in + ' incoming' + (counts.loop ? ', ' + counts.loop + ' self loop' : '') +
- '. ' + total + ' connection' + (total === 1 ? '' : 's') + '. Press Enter for details.';
+ status.textContent = viewerText('viewer.intent.summary', {
+ label: nodeLabel(selected, id),
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.intent.loops', { count: counts.loop }) : '',
+ total: total
+ });
}
return true;
}
@@ -9143,8 +9386,11 @@
drawHandoffAnchor(anchor);
var node = findNode(anchor);
var nodeLabel = node ? (node.getAttribute('data-node-label') || anchor) : anchor;
- handoffReceipt.textContent = (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1) +
- ' \u2192 ' + (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1) + ' \u00b7 via ' + nodeLabel;
+ handoffReceipt.textContent = viewerText('viewer.guided.handoff', {
+ from: (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1),
+ to: (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1),
+ label: nodeLabel
+ });
handoffReceipt.hidden = false;
}
if (Archify.motionGovernor) {
@@ -9201,8 +9447,13 @@
button.setAttribute('data-guided-view-id', view.id);
button.setAttribute('aria-pressed', 'false');
button.setAttribute('tabindex', index === 0 ? '0' : '-1');
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + view.label + ', ' + view.focus.length + ' stops');
- button.title = view.label + ' — ' + (view.note || view.focus.length + ' selected nodes');
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.open', {
+ index: index + 1,
+ total: views.length,
+ label: view.label,
+ count: view.focus.length
+ }));
+ button.title = view.label + ' — ' + (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }));
var position = document.createElement('span');
position.className = 'guided-view-chapter-index';
position.setAttribute('aria-hidden', 'true');
@@ -9212,7 +9463,7 @@
title.textContent = view.label;
var stops = document.createElement('em');
stops.className = 'guided-view-chapter-count';
- stops.textContent = view.focus.length + ' stop' + (view.focus.length === 1 ? '' : 's');
+ stops.textContent = viewerCount('viewer.guided.chapter.stop', view.focus.length);
var delta = document.createElement('span');
delta.className = 'guided-view-chapter-delta';
delta.hidden = true;
@@ -9245,20 +9496,40 @@
stops.hidden = false;
deltaLabel.hidden = true;
button.removeAttribute('data-chapter-delta');
- button.setAttribute('aria-label', 'Current chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + ', ' + views[index].focus.length + ' stops');
- button.title = views[index].label + ' — current chapter, ' + views[index].focus.length + ' stops';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.current', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ count: views[index].focus.length
+ }));
+ button.title = viewerText('viewer.guided.chapter.current.title', {
+ label: views[index].label,
+ count: views[index].focus.length
+ });
} else {
var delta = chapterDelta(activeIndex >= 0 ? views[activeIndex] : null, views[index]);
var compact = '=' + delta.stay.length + ' +' + delta.enter.length + ' \u2212' + delta.leave.length;
- var expanded = delta.stay.length + ' stay, ' + delta.enter.length + ' enter, ' + delta.leave.length + ' leave';
+ var expanded = viewerText('viewer.guided.chapter.delta.expanded', {
+ stay: delta.stay.length,
+ enter: delta.enter.length,
+ leave: delta.leave.length
+ });
stops.hidden = true;
deltaLabel.hidden = false;
deltaLabel.querySelector('[data-delta-kind="stay"]').textContent = '=' + delta.stay.length;
deltaLabel.querySelector('[data-delta-kind="enter"]').textContent = '+' + delta.enter.length;
deltaLabel.querySelector('[data-delta-kind="leave"]').textContent = '\u2212' + delta.leave.length;
button.setAttribute('data-chapter-delta', compact);
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + '. Chapter focus delta: ' + expanded);
- button.title = views[index].label + ' — ' + compact + ' chapter focus';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.delta.aria', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ delta: expanded
+ }));
+ button.title = viewerText('viewer.guided.chapter.delta.title', {
+ label: views[index].label,
+ delta: compact
+ });
}
if (current) button.setAttribute('aria-current', 'step');
else button.removeAttribute('aria-current');
@@ -9386,33 +9657,44 @@
function shareCueStatus(state) {
return {
- pending: 'Ready',
- playing: 'Playing',
- complete: 'Settled',
- interrupted: 'Paused',
- pinned: 'Pinned',
- 'reduced-motion': 'Still'
- }[state] || 'Ready';
+ pending: viewerText('viewer.guided.state.ready'),
+ playing: viewerText('viewer.guided.state.playing'),
+ complete: viewerText('viewer.guided.state.settled'),
+ interrupted: viewerText('viewer.guided.state.paused'),
+ pinned: viewerText('viewer.guided.state.pinned'),
+ 'reduced-motion': viewerText('viewer.guided.state.still')
+ }[state] || viewerText('viewer.guided.state.ready');
}
function shareCueBeatCopy(state, view, stops) {
var total = stops.length;
var activeStop = storyBeatIndex >= 0 ? stops[storyBeatIndex] : null;
if ((state === 'playing' || state === 'interrupted') && activeStop) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent;
+ return viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ });
}
if (state === 'pinned' && activeStop) {
return storyBeatCopy(storySteps[storyBeatIndex], total);
}
if (state === 'reduced-motion' && activeStop && hashBeatMatchesCurrent()) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent + ' · Static moment';
+ return viewerText('viewer.guided.share.staticMoment', {
+ step: viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ })
+ });
}
- if (state === 'complete') return total + ' steps complete · ' + (view.note || 'Path settled for reading.');
- if (state === 'reduced-motion') return total + ' steps · Static path';
- if (state === 'pending') return total + ' steps · Ready';
- return view.note || view.focus.length + ' selected nodes';
+ if (state === 'complete') return viewerText('viewer.guided.share.complete', {
+ count: total,
+ note: view.note || viewerText('viewer.guided.share.settled')
+ });
+ if (state === 'reduced-motion') return viewerText('viewer.guided.share.staticPath', { count: total });
+ if (state === 'pending') return viewerText('viewer.guided.share.ready', { count: total });
+ return view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length });
}
function renderShareCue() {
@@ -9437,11 +9719,21 @@
shareCue.setAttribute('data-state', state);
shareCue.setAttribute('aria-live', state === 'playing' ? 'off' : 'polite');
shareCueState.textContent = shareCueStatus(state);
- shareCueCount.textContent = 'Chapter ' + (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1) + ' / ' + (views.length < 10 ? '0' : '') + views.length;
+ shareCueCount.textContent = viewerText('viewer.guided.share.chapter', {
+ index: (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1),
+ total: (views.length < 10 ? '0' : '') + views.length
+ });
shareCueLabel.textContent = view.label;
shareCueNote.textContent = beatCopy;
shareCueRoute.textContent = route;
- shareCue.setAttribute('aria-label', shareCueStatus(state) + ' chapter ' + (activeIndex + 1) + ' of ' + views.length + ': ' + view.label + '. ' + beatCopy + '. ' + route);
+ shareCue.setAttribute('aria-label', viewerText('viewer.guided.share.aria', {
+ state: shareCueStatus(state),
+ index: activeIndex + 1,
+ total: views.length,
+ label: view.label,
+ beat: beatCopy,
+ route: route
+ }));
}
function setShareCueProgress(fraction) {
@@ -9532,24 +9824,24 @@
if (!step) return '';
var position = (step.index + 1 < 10 ? '0' : '') + (step.index + 1);
var countValue = (total < 10 ? '0' : '') + total;
- if (step.relation === 'start') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u00b7 starting point';
- if (step.relation === 'forward') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u2192 ' + step.nodeLabel;
- if (step.relation === 'reverse') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u2192 ' + step.previousLabel + ' \u00b7 reverse authored link';
- if (step.relation === 'multiple') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u21c4 ' + step.nodeLabel + ' \u00b7 ' + step.edges.length + ' authored links';
- return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u00b7 ' + step.nodeLabel + ' \u00b7 grouped \u00b7 no direct link';
+ if (step.relation === 'start') return viewerText('viewer.guided.beat.start', { index: position, total: countValue, label: step.nodeLabel });
+ if (step.relation === 'forward') return viewerText('viewer.guided.beat.forward', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'reverse') return viewerText('viewer.guided.beat.reverse', { index: position, total: countValue, from: step.nodeLabel, to: step.previousLabel });
+ if (step.relation === 'multiple') return viewerText('viewer.guided.beat.multiple', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel, count: step.edges.length });
+ return viewerText('viewer.guided.beat.group', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
}
function storyBeatAria(step, total) {
- var prefix = 'Story beat ' + (step.index + 1) + ' of ' + total + ': ' + step.nodeLabel + '. ';
- if (step.relation === 'start') return prefix + 'Starting point.';
- if (step.relation === 'forward') return prefix + 'From ' + step.previousLabel + ' through one authored forward relationship.';
- if (step.relation === 'reverse') return prefix + 'From ' + step.previousLabel + '; the authored relationship points from ' + step.nodeLabel + ' to ' + step.previousLabel + '.';
- if (step.relation === 'multiple') return prefix + 'From ' + step.previousLabel + ' through ' + step.edges.length + ' authored relationships; shown without arbitrary motion.';
- return prefix + 'Grouped from ' + step.previousLabel + ' with no direct authored relationship.';
+ var prefix = viewerText('viewer.guided.beat.aria.prefix', { index: step.index + 1, total: total, label: step.nodeLabel });
+ if (step.relation === 'start') return prefix + viewerText('viewer.guided.beat.aria.start');
+ if (step.relation === 'forward') return prefix + viewerText('viewer.guided.beat.aria.forward', { from: step.previousLabel });
+ if (step.relation === 'reverse') return prefix + viewerText('viewer.guided.beat.aria.reverse', { from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'multiple') return prefix + viewerText('viewer.guided.beat.aria.multiple', { from: step.previousLabel, count: step.edges.length });
+ return prefix + viewerText('viewer.guided.beat.aria.group', { from: step.previousLabel });
}
function storyCaptionRouteCopy(step) {
- if (step.relation === 'start') return step.nodeLabel + ' · Starting point';
+ if (step.relation === 'start') return step.nodeLabel + ' · ' + viewerText('viewer.guided.caption.start');
if (step.relation === 'reverse') return step.previousLabel + ' ← ' + step.nodeLabel;
if (step.relation === 'multiple') return step.previousLabel + ' ⇄ ' + step.nodeLabel;
if (step.relation === 'group') return step.previousLabel + ' · ' + step.nodeLabel;
@@ -9558,15 +9850,15 @@
function storyCaptionDetailCopy(step) {
var facts = [];
- if (step.relation === 'group') facts.push('Grouped transition · no direct authored link');
- else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? ' +' + (step.edgeLabels.length - 3) + ' more' : ''));
- else if (step.relation === 'reverse') facts.push('Reverse authored relationship');
- else if (step.relation === 'multiple') facts.push(step.edges.length + ' authored relationships');
- else if (step.relation !== 'start') facts.push('Authored relationship');
- if (step.relation === 'reverse') facts.push('authored direction: ' + step.nodeLabel + ' → ' + step.previousLabel);
+ if (step.relation === 'group') facts.push(viewerText('viewer.guided.caption.grouped'));
+ else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? viewerText('viewer.guided.caption.more', { count: step.edgeLabels.length - 3 }) : ''));
+ else if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.reverse'));
+ else if (step.relation === 'multiple') facts.push(viewerText('viewer.guided.caption.relationships', { count: step.edges.length }));
+ else if (step.relation !== 'start') facts.push(viewerText('viewer.guided.caption.relationship'));
+ if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.direction', { from: step.nodeLabel, to: step.previousLabel }));
if (step.responsibility) facts.push(step.responsibility);
if (step.context) facts.push(step.context);
- if (!facts.length) facts.push('Authored starting point');
+ if (!facts.length) facts.push(viewerText('viewer.guided.caption.starting'));
return facts.join(' · ');
}
@@ -9622,17 +9914,17 @@
if (beatLinkFeedbackTimer) clearTimeout(beatLinkFeedbackTimer);
beatLinkFeedbackTimer = null;
beatLink.removeAttribute('data-copy-state');
- beatLinkLabel.textContent = 'Copy moment';
+ beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
}
function syncBeatLink() {
var step = storyBeatIndex >= 0 ? storySteps[storyBeatIndex] : null;
var available = !!(activeIndex >= 0 && step && !currentHandoff);
beatLink.disabled = !available;
- if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = 'Copy moment';
+ if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
var description = available
- ? 'Copy link to current story moment: Beat ' + (step.index + 1) + ' of ' + storySteps.length + ': ' + step.nodeLabel
- : 'Select a Story Beat to copy its exact link';
+ ? viewerText('viewer.guided.beatLink', { index: step.index + 1, total: storySteps.length, label: step.nodeLabel })
+ : viewerText('viewer.guided.selectBeatLink');
beatLink.setAttribute('aria-label', description);
beatLink.title = description;
}
@@ -9640,8 +9932,8 @@
function setBeatLinkFeedback(copied) {
resetBeatLinkFeedback();
beatLink.setAttribute('data-copy-state', copied ? 'copied' : 'failed');
- beatLinkLabel.textContent = copied ? 'Copied' : 'Copy failed';
- beatLink.setAttribute('aria-label', copied ? 'Moment link copied' : 'Could not copy story moment link');
+ beatLinkLabel.textContent = viewerText(copied ? 'viewer.guided.copied' : 'viewer.guided.copyFailed');
+ beatLink.setAttribute('aria-label', viewerText(copied ? 'viewer.guided.momentCopied' : 'viewer.guided.momentCopyFailed'));
beatLinkFeedbackTimer = setTimeout(function () {
resetBeatLinkFeedback();
syncBeatLink();
@@ -9895,7 +10187,7 @@
stop.removeAttribute('aria-current');
});
note.setAttribute('aria-live', 'polite');
- if (activeIndex >= 0) note.textContent = views[activeIndex].note || views[activeIndex].focus.length + ' selected nodes';
+ if (activeIndex >= 0) note.textContent = views[activeIndex].note || viewerText('viewer.guided.chapter.selectedNodes', { count: views[activeIndex].focus.length });
renderStoryCaption(null, 0);
renderShareCue();
syncBeatLink();
@@ -9974,7 +10266,7 @@
trail.appendChild(stop);
});
trail.hidden = labels.length === 0;
- trail.setAttribute('aria-label', 'Story trail for ' + view.label + ': ' + labels.length + ' beats');
+ trail.setAttribute('aria-label', viewerText('viewer.guided.storyTrail', { label: view.label, count: labels.length }));
trail.scrollLeft = 0;
svg.setAttribute('data-story-active', view.id);
@@ -10053,21 +10345,39 @@
syncStoryPlayback();
play.disabled = !playing && !automaticPlaybackAllowed;
play.setAttribute('aria-pressed', playing ? 'true' : 'false');
- play.setAttribute('aria-label', playing ? 'Pause guided story' : (!automaticPlaybackAllowed ? 'Story playback unavailable while motion is Still' : (storyPlaybackComplete ? 'Replay guided story' : 'Play guided story')));
- play.title = playing ? 'Pause guided story (P)' : (!automaticPlaybackAllowed ? 'Switch motion to Live to play the guided story' : (storyPlaybackComplete ? 'Replay guided story (P)' : 'Play guided story (P)'));
+ play.setAttribute('aria-label', viewerText(playing
+ ? 'viewer.guided.pause'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.motionUnavailable'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay'
+ : 'viewer.guided.play'));
+ play.title = viewerText(playing
+ ? 'viewer.guided.pause.title'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.enableMotion'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay.title'
+ : 'viewer.guided.play.title');
playIcon.textContent = playing ? '\u2016' : '\u25b6';
- playLabel.textContent = playing ? 'Pause' : (storyPlaybackComplete ? 'Replay story' : 'Play story');
+ playLabel.textContent = viewerText(playing
+ ? 'viewer.guided.pauseStory'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replayStory'
+ : 'viewer.guided.playStory');
if (storyCaption && !storyCaption.hidden) storyCaption.setAttribute('aria-live', playing ? 'off' : 'polite');
}
function render() {
var view = views[activeIndex];
count.textContent = activeIndex < 0 ? '0 / ' + views.length : (activeIndex + 1) + ' / ' + views.length;
- label.textContent = view ? view.label : 'Explore this system';
+ label.textContent = view ? view.label : viewerText('viewer.guided.explore');
note.setAttribute('aria-live', storyBeatIndex >= 0 ? 'off' : 'polite');
note.textContent = storyBeatIndex >= 0
? storyBeatCopy(storySteps[storyBeatIndex], storySteps.length)
- : (view ? (view.note || view.focus.length + ' selected nodes') : 'Step through curated paths without changing the source diagram.');
+ : (view
+ ? (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }))
+ : viewerText('viewer.guided.intro'));
prev.disabled = activeIndex < 0;
next.disabled = activeIndex >= views.length - 1;
all.disabled = activeIndex < 0;
@@ -10551,6 +10861,46 @@
embed, presentation, print, and non-wide diagrams retain their own
established layout contracts.
============================================================ */
+ Archify.waitForStableLayout = function (options) {
+ options = options || {};
+ var maximumFrames = Math.max(1, Number(options.maximumFrames) || 240);
+ var fontsReady = document.fonts && document.fonts.ready
+ ? document.fonts.ready.catch(function () {})
+ : Promise.resolve();
+ return fontsReady.then(function () {
+ if (typeof options.schedule === 'function') options.schedule();
+ return new Promise(function (resolve, reject) {
+ var previous = '';
+ var stableFrames = 0;
+ var sampledFrames = 0;
+ function sample() {
+ sampledFrames += 1;
+ if (typeof options.pending === 'function' && options.pending()) {
+ previous = '';
+ stableFrames = 0;
+ } else {
+ var current = typeof options.snapshot === 'function' ? options.snapshot() : '';
+ if (current === previous) stableFrames += 1;
+ else {
+ previous = current;
+ stableFrames = 0;
+ }
+ if (stableFrames >= 3) {
+ resolve({ stable: true, snapshot: current, sampledFrames: sampledFrames });
+ return;
+ }
+ }
+ if (sampledFrames >= maximumFrames) {
+ reject(new Error(options.timeoutMessage || 'Layout did not reach stable dimensions.'));
+ return;
+ }
+ requestAnimationFrame(sample);
+ }
+ requestAnimationFrame(sample);
+ });
+ });
+ };
+
Archify.readerLayout = (function () {
var html = document.documentElement;
var body = document.body;
@@ -10670,6 +11020,31 @@
if (frame) return;
frame = requestAnimationFrame(measure);
}
+ function stableSnapshot() {
+ var shellRect = shell ? shell.getBoundingClientRect() : { width: 0, height: 0 };
+ var diagramRect = diagram ? diagram.getBoundingClientRect() : { width: 0, height: 0 };
+ return [
+ lastWidth,
+ html.getAttribute('data-reader-layout') || '',
+ html.getAttribute('data-reader-overflow') || '',
+ Math.ceil(document.documentElement.scrollWidth),
+ Math.ceil(document.documentElement.scrollHeight),
+ Math.ceil(document.body.scrollWidth),
+ Math.ceil(document.body.scrollHeight),
+ Math.round(shellRect.width * 100) / 100,
+ Math.round(shellRect.height * 100) / 100,
+ Math.round(diagramRect.width * 100) / 100,
+ Math.round(diagramRect.height * 100) / 100
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Adaptive reader layout did not reach stable dimensions.'
+ });
+ }
window.addEventListener('resize', schedule, { passive: true });
window.addEventListener('load', schedule, { once: true });
@@ -10689,11 +11064,324 @@
return {
measure: measure,
schedule: schedule,
+ whenStable: whenStable,
active: function () { return html.getAttribute('data-reader-layout') === 'adaptive'; },
receipt: function () { return { ratio: ratio, width: lastWidth }; }
};
})();
+ /* ============================================================
+ Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
+ ============================================================ */
+ Archify.viewerChromeLayout = (function () {
+ var html = document.documentElement;
+ var container = document.querySelector('.diagram-container');
+ var svg = container && container.querySelector(':scope > svg');
+ var nav = container && container.querySelector('.diagram-nav');
+ var legend = svg && svg.querySelector('[data-legend]');
+ var frame = 0;
+ var settleFrame = 0;
+ var reserve = 0;
+ var railLatched = false;
+ var probingBaseline = false;
+ var probePromise = null;
+ var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
+ var lastReceipt = null;
+ var SAFE_GAP = 10;
+
+ function visible(element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ }
+ function usable(rect) {
+ return Boolean(rect && rect.width > 0 && rect.height > 0);
+ }
+ function intersectionArea(a, b) {
+ var width = Math.max(0, Math.min(a.right, b.right) - Math.max(a.left, b.left));
+ var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
+ return width * height;
+ }
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
+ function eligible() {
+ return Boolean(
+ container && svg && nav &&
+ window.innerWidth > 720 &&
+ html.getAttribute('data-embed') !== 'true' &&
+ (!window.matchMedia || !window.matchMedia('print').matches) &&
+ visible(nav)
+ );
+ }
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
+ function writeReserve(next, options) {
+ options = options || {};
+ next = Math.max(0, Math.ceil(next));
+ if (Math.abs(next - reserve) < 1) return false;
+ reserve = next;
+ if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
+ container.style.setProperty('--archify-nav-reserve', reserve + 'px');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
+ } else {
+ container.style.removeProperty('--archify-nav-reserve');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
+ }
+ if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
+ Archify.readerLayout.schedule();
+ }
+ if (options.quiet !== true) {
+ if (settleFrame) cancelAnimationFrame(settleFrame);
+ settleFrame = requestAnimationFrame(function () {
+ settleFrame = 0;
+ schedule();
+ });
+ }
+ return true;
+ }
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
+ writeReserve(0, { quiet: probingBaseline });
+ lastReceipt = {
+ eligible: false,
+ active: false,
+ reserve: 0,
+ gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
+ baselineIntersectionArea: 0,
+ intersectionArea: 0
+ };
+ return lastReceipt;
+ }
+ function measure() {
+ frame = 0;
+ if (probingBaseline) return null;
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
+
+ var navRect = nav.getBoundingClientRect();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
+
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
+ baselineIntersectionArea = actualIntersectionArea;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
+ }
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
+ if (writeReserve(reserve + remaining)) return null;
+ }
+
+ navRect = nav.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
+ };
+ return lastReceipt;
+ }
+ function reprobe() {
+ if (probingBaseline) return probePromise || Promise.resolve(false);
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
+ probingBaseline = true;
+ railLatched = false;
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ writeReserve(0, { quiet: true });
+ var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
+ ? Archify.readerLayout.whenStable().catch(function () {})
+ : Promise.resolve();
+ probePromise = readerReady.then(function () {
+ probingBaseline = false;
+ probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
+ schedule();
+ return true;
+ });
+ return probePromise;
+ }
+ function schedule() {
+ if (frame) return;
+ frame = requestAnimationFrame(measure);
+ }
+ function stableSnapshot() {
+ var containerRect = container ? container.getBoundingClientRect() : { width: 0, height: 0 };
+ var navRect = nav ? nav.getBoundingClientRect() : { top: 0, left: 0 };
+ var legendRect = legend ? legend.getBoundingClientRect() : { top: 0, left: 0 };
+ return [
+ reserve,
+ Math.round(containerRect.width * 100) / 100,
+ Math.round(containerRect.height * 100) / 100,
+ Math.round(navRect.left * 100) / 100,
+ Math.round(navRect.top * 100) / 100,
+ Math.round(legendRect.left * 100) / 100,
+ Math.round(legendRect.top * 100) / 100,
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame || probingBaseline); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Viewer chrome layout did not reach stable dimensions.'
+ });
+ }
+
+ window.addEventListener('resize', reprobe, { passive: true });
+ window.addEventListener('load', schedule, { once: true });
+ window.addEventListener('beforeprint', schedule);
+ window.addEventListener('afterprint', reprobe);
+ if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
+ if (typeof ResizeObserver === 'function') {
+ var resizeObserver = new ResizeObserver(schedule);
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ }
+ if (typeof MutationObserver === 'function') {
+ var contentObserver = new MutationObserver(function (records) {
+ var viewerModeChanged = records.some(function (record) { return record.target === html; });
+ if (viewerModeChanged) reprobe();
+ else schedule();
+ });
+ if (legend) contentObserver.observe(legend, { attributes: true, childList: true, subtree: true });
+ contentObserver.observe(html, {
+ attributes: true,
+ attributeFilter: ['data-embed', 'data-present', 'data-preset', 'data-theme']
+ });
+ }
+ schedule();
+
+ return {
+ measure: measure,
+ schedule: schedule,
+ reprobe: reprobe,
+ whenStable: whenStable,
+ stageRect: protectedStageRect,
+ active: function () { return reserve > 0; },
+ receipt: function () { return lastReceipt || measure(); }
+ };
+ })();
+
Archify.view = (function () {
var container = document.querySelector('.diagram-container');
var svg = container.querySelector('svg');
@@ -10708,6 +11396,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -10769,36 +11458,76 @@
var semantic = state.mode === 'semantic' && state.scale > 1.01;
var detail = detailLevel();
var percent = Math.round(state.scale * 100) + '%';
- var levelLabel = detail === 'map' ? 'MAP ' : detail === 'read' ? 'READ ' : 'FULL ';
+ var levelLabel = viewerText('viewer.nav.level.' + detail);
var detailHint = detail === 'map'
- ? 'Zoom in to reveal relationship labels and node context'
+ ? viewerText('viewer.nav.detail.map')
: detail === 'read'
- ? 'Zoom in again to reveal tags and annotations'
- : 'Full diagram detail';
- var resolvedLevel = (semantic ? 'AUTO ' : levelLabel).trim();
- var showDetailLevel = resolvedLevel !== 'READ';
+ ? viewerText('viewer.nav.detail.read')
+ : viewerText('viewer.nav.detail.full');
+ var resolvedLevel = semantic ? viewerText('viewer.nav.level.auto') : levelLabel;
+ var showDetailLevel = semantic || detail !== 'read';
if (resetDetailLabel) {
resetDetailLabel.textContent = resolvedLevel;
resetDetailLabel.hidden = !showDetailLevel;
}
if (resetPercentLabel) resetPercentLabel.textContent = percent;
resetBtn.toggleAttribute('data-detail-visible', showDetailLevel);
- resetBtn.title = (semantic ? 'Semantic camera active · ' : '') + detailHint + ' · reset view (0)';
- resetBtn.setAttribute('aria-label', detailHint + '. Reset diagram view');
+ resetBtn.title = viewerText('viewer.nav.camera.title', {
+ semantic: semantic ? viewerText('viewer.nav.camera.semantic') : '',
+ hint: detailHint
+ });
+ resetBtn.setAttribute('aria-label', viewerText('viewer.nav.camera', { hint: detailHint }));
resetBtn.setAttribute('data-detail-level', detail);
container.setAttribute('data-detail-level', detail);
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
container.classList.toggle('is-pannable', state.scale > 1);
svg.setAttribute('data-view-scale', String(state.scale));
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
+ if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.schedule === 'function') {
+ Archify.viewerChromeLayout.schedule();
+ }
}
function sampleRenderedState() {
var transform = '';
@@ -11189,21 +11918,35 @@
var container = document.querySelector('.diagram-container');
var diagram = container.querySelector(':scope > svg');
var panel = document.getElementById('overview-map');
+ var panelHead = panel.querySelector('.overview-map-head');
var surface = document.getElementById('overview-map-surface');
var status = document.getElementById('overview-map-status');
var trigger = document.getElementById('btn-overview-map');
var closeBtn = document.getElementById('overview-map-close');
+ var expandBtn = document.getElementById('overview-map-expand');
+ var feedback = document.getElementById('overview-map-feedback');
+ var navigation = container.querySelector('.diagram-nav');
+ var passport = document.getElementById('focus-chip');
var namespace = 'http://www.w3.org/2000/svg';
var viewBox = diagram.viewBox && diagram.viewBox.baseVal;
var mapSvg = document.createElementNS(namespace, 'svg');
var nodeLayer = document.createElementNS(namespace, 'g');
var viewport = document.createElementNS(namespace, 'rect');
var nodes = [];
- var drag = null;
+ var viewportDrag = null;
+ var panelDrag = null;
+ var manualPosition = null;
+ var lastPlacement = null;
+ var requestedOpen = false;
+ var passportYielded = false;
+ var passportPreviousAriaHidden = null;
var syncFrame = 0;
+ var spaceRetryTimer = 0;
+ var spaceRetryCount = 0;
+ var placementGap = 16;
mapSvg.setAttribute('role', 'group');
- mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');
+ mapSvg.setAttribute('aria-label', viewerText('viewer.radar.nodes'));
mapSvg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
nodeLayer.setAttribute('class', 'overview-map-nodes');
viewport.setAttribute('class', 'overview-map-viewport');
@@ -11238,63 +11981,301 @@
rect.setAttribute('data-kind', node.getAttribute('data-node-kind') || 'neutral');
rect.setAttribute('tabindex', '0');
rect.setAttribute('role', 'button');
- rect.setAttribute('aria-label', 'Focus ' + nodeLabel(node, id) + ' from Semantic Radar');
+ rect.setAttribute('aria-label', viewerText('viewer.radar.focus', { label: nodeLabel(node, id) }));
nodeLayer.appendChild(rect);
nodes.push({ id: id, node: node, rect: rect });
});
- status.textContent = nodes.length + ' nodes · full map';
+ status.textContent = viewerText('viewer.radar.fullMap', { count: nodes.length });
return true;
}
- function updateDocking() {
- if (panel.hidden) return;
- var containerRect = container.getBoundingClientRect();
- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;
- if (!intersectsWindow) {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
- return;
- }
- var active = diagram.querySelector('[data-focus-selected]');
- var activeRect = active ? active.getBoundingClientRect() : null;
- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);
- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));
- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));
- var topLimit = Math.max(16, containerRect.top + 16);
- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);
- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;
- var panelRight = panelLeft + panel.offsetWidth;
+ function visibleRect(element) {
+ if (!element || element.hidden) return null;
+ var rect = element.getBoundingClientRect();
+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;
+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };
+ }
+ function panelRectAt(position) {
+ return {
+ left: position.left,
+ top: position.top,
+ right: position.left + panel.offsetWidth,
+ bottom: position.top + panel.offsetHeight,
+ width: panel.offsetWidth,
+ height: panel.offsetHeight
+ };
+ }
+ function rectsIntersect(first, second, gap) {
+ gap = Number(gap) || 0;
+ return first.left < second.right + gap &&
+ first.right > second.left - gap &&
+ first.top < second.bottom + gap &&
+ first.bottom > second.top - gap;
+ }
+ function intersectionArea(first, second) {
+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));
+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));
+ return width * height;
+ }
+ function clamp(value, minimum, maximum) {
+ if (maximum < minimum) return minimum;
+ return Math.max(minimum, Math.min(maximum, value));
+ }
+ function placementContext() {
+ var containerRect = visibleRect(container);
+ if (!containerRect) return null;
+ var controlRect = visibleRect(navigation);
+ var left = Math.max(placementGap, containerRect.left + placementGap);
+ var top = Math.max(placementGap, containerRect.top + placementGap);
+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);
+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);
+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);
var lens = document.getElementById('focus-chip');
- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;
- var blockers = [activeRect, lensRect].filter(function (rect) {
- return rect && rect.right > panelLeft && rect.left < panelRight;
- });
- var desiredTop = bottomLimit - panel.offsetHeight;
- var candidates = [desiredTop, topLimit];
- blockers.forEach(function (rect) {
- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);
- });
- var valid = candidates.filter(function (candidate) {
- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;
- return blockers.every(function (rect) {
- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;
- });
+ var lensRect = visibleRect(lens);
+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));
+ var active = diagram.querySelector('[data-focus-selected]');
+ var activeRect = visibleRect(active);
+ return {
+ bounds: { left: left, top: top, right: right, bottom: bottom },
+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),
+ softBlockers: [activeRect].filter(Boolean),
+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'
+ };
+ }
+ function positionIsValid(position, context) {
+ if (!position || !context) return false;
+ var rect = panelRectAt(position);
+ var bounds = context.bounds;
+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;
+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });
+ }
+ function cornerCandidates(context) {
+ var bounds = context.bounds;
+ var left = bounds.left;
+ var right = Math.max(left, bounds.right - panel.offsetWidth);
+ var top = bounds.top;
+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);
+ var preferredLeft = context.preferredSide === 'left' ? left : right;
+ var alternateLeft = context.preferredSide === 'left' ? right : left;
+ return [
+ { left: preferredLeft, top: bottom },
+ { left: alternateLeft, top: bottom },
+ { left: preferredLeft, top: top },
+ { left: alternateLeft, top: top }
+ ].filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function nearbyCandidates(context, reference) {
+ var bounds = context.bounds;
+ var maximumLeft = bounds.right - panel.offsetWidth;
+ var maximumTop = bounds.bottom - panel.offsetHeight;
+ var requested = reference ? {
+ left: clamp(reference.left, bounds.left, maximumLeft),
+ top: clamp(reference.top, bounds.top, maximumTop)
+ } : null;
+ var horizontal = [bounds.left, maximumLeft];
+ var vertical = [bounds.top, maximumTop];
+ if (requested) {
+ horizontal.push(requested.left);
+ vertical.push(requested.top);
+ }
+ context.hardBlockers.forEach(function (blocker) {
+ horizontal.push(
+ blocker.left - placementGap - panel.offsetWidth,
+ blocker.right + placementGap
+ );
+ vertical.push(
+ blocker.top - placementGap - panel.offsetHeight,
+ blocker.bottom + placementGap
+ );
+ });
+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });
+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });
+ var candidates = [];
+ horizontal.forEach(function (left) {
+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });
+ });
+ return candidates.filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
});
- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });
- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);
- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);
+ }
+ function placementScore(position, context, reference, softWeight) {
+ var rect = panelRectAt(position);
+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);
+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;
+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);
+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);
+ return distance + softOverlap * softWeight;
+ }
+ function chooseRadarPlacement(context, reference, options) {
+ options = options || {};
+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;
+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));
+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });
+ valid.sort(function (first, second) {
+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);
+ });
+ return valid.length ? valid[0] : null;
+ }
+ function applyPlacement(position, remember) {
+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;
panel.setAttribute('data-docked', 'true');
- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');
- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');
- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');
- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');
+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');
+ if (useLeft) {
+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');
+ panel.style.removeProperty('--archify-radar-right');
+ } else {
+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');
+ panel.style.removeProperty('--archify-radar-left');
+ }
+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');
+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };
+ }
+ function resetDockingStyles() {
+ panel.removeAttribute('data-docked');
+ panel.removeAttribute('data-dock-side');
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ panel.style.removeProperty('--archify-radar-right');
+ panel.style.removeProperty('--archify-radar-left');
+ panel.style.removeProperty('--archify-radar-top');
+ }
+ function updateDocking() {
+ var options = arguments[0] || {};
+ if (panel.hidden) return false;
+ if (panelDrag) return true;
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ var context = placementContext();
+ if (!context) {
+ resetDockingStyles();
+ return false;
+ }
+ var reference = manualPosition || lastPlacement;
+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };
+ var placement = manualPosition && positionIsValid(manualPosition, context)
+ ? manualPosition
+ : chooseRadarPlacement(context, reference, placementOptions);
+ var compact = false;
+ if (!placement && options.allowCompact !== false) {
+ compact = true;
+ panel.setAttribute('data-compact', 'true');
+ panel.setAttribute('data-placement-degraded', 'true');
+ panel.setAttribute('title', viewerText('viewer.radar.compacted'));
+ context = placementContext();
+ placement = chooseRadarPlacement(context, reference, placementOptions);
+ }
+ if (!placement) {
+ resetDockingStyles();
+ panel.setAttribute('data-placement-unavailable', 'true');
+ return false;
+ }
+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };
+ applyPlacement(placement, true);
+ return true;
+ }
+ function clearSpaceRetry() {
+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);
+ spaceRetryTimer = 0;
+ }
+ function yieldPassport() {
+ if (!passport || passport.hidden || passportYielded) return passportYielded;
+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');
+ passportYielded = true;
+ passport.setAttribute('data-radar-yielded', 'true');
+ passport.setAttribute('aria-hidden', 'true');
+ return true;
+ }
+ function restorePassport() {
+ if (!passport || !passportYielded) return;
+ passportYielded = false;
+ passport.removeAttribute('data-radar-yielded');
+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');
+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);
+ passportPreviousAriaHidden = null;
+ }
+ function reflectVisible() {
+ panel.hidden = false;
+ panel.removeAttribute('data-placement-unavailable');
+ trigger.setAttribute('aria-expanded', 'true');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.close'));
+ trigger.title = viewerText('viewer.nav.radar.title');
+ feedback.hidden = true;
+ }
+ function scheduleSpaceRetry() {
+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;
+ spaceRetryCount += 1;
+ spaceRetryTimer = window.setTimeout(function () {
+ spaceRetryTimer = 0;
+ attemptRequestedOpen();
+ }, 60);
+ }
+ function reflectUnavailable() {
+ restorePassport();
+ panel.hidden = true;
+ panel.setAttribute('data-placement-unavailable', 'true');
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.cancelWaiting'));
+ trigger.setAttribute('data-radar-space-limited', 'true');
+ trigger.title = viewerText('viewer.radar.needsSpace');
+ feedback.hidden = false;
+ scheduleSpaceRetry();
+ }
+ function attemptRequestedOpen(options) {
+ options = options || {};
+ if (!requestedOpen) return false;
+ panel.hidden = false;
+ if (!updateDocking(options)) {
+ reflectUnavailable();
+ return false;
+ }
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ reflectVisible();
+ sync();
+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();
+ return true;
+ }
+ function expandCompactRadar() {
+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;
+ yieldPassport();
+ if (!updateDocking({ allowCompact: false })) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return false;
+ }
+ }
+ reflectVisible();
+ sync();
+ if (!panel.hasAttribute('data-compact')) surface.focus();
+ return !panel.hasAttribute('data-compact');
}
function syncNow() {
syncFrame = 0;
if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;
- updateDocking();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ if (passportYielded && panel.hasAttribute('data-compact')) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ }
+ reflectVisible();
var visible = Archify.view.logicalViewport();
if (!visible) return;
viewport.setAttribute('x', String(visible.x));
@@ -11304,9 +12285,11 @@
var full = visible.width >= viewBox.width * 0.98 && visible.height >= viewBox.height * 0.98;
var mobileWide = window.innerWidth <= 720 && container.hasAttribute('data-wide-diagram');
var viewportCopy = full
- ? 'full map'
- : (mobileWide ? Math.round(visible.width / viewBox.width * 100) + '% width' : Math.round(visible.scale * 100) + '% viewport');
- status.textContent = nodes.length + ' nodes · ' + viewportCopy;
+ ? viewerText('viewer.radar.viewport.full')
+ : (mobileWide
+ ? viewerText('viewer.radar.viewport.width', { percent: Math.round(visible.width / viewBox.width * 100) })
+ : viewerText('viewer.radar.viewport.scale', { percent: Math.round(visible.scale * 100) }));
+ status.textContent = viewerText('viewer.radar.status', { count: nodes.length, viewport: viewportCopy });
nodes.forEach(function (item) {
var active = item.node.hasAttribute('data-focus-selected') ||
item.node.getAttribute('data-story-beat-state') === 'active';
@@ -11315,6 +12298,10 @@
});
}
function sync() {
+ if (requestedOpen && panel.hidden) {
+ attemptRequestedOpen();
+ return;
+ }
if (syncFrame) return;
syncFrame = requestAnimationFrame(syncNow);
}
@@ -11325,25 +12312,31 @@
if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {
Archify.semanticLens.close({ restoreFocus: false });
}
- panel.hidden = !next;
- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');
- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');
+ requestedOpen = next;
if (next) {
+ clearSpaceRetry();
+ spaceRetryCount = 0;
build();
- updateDocking();
- sync();
- if (options.focus === true) surface.focus();
+ attemptRequestedOpen(options);
} else {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ viewportDrag = null;
+ panelDrag = null;
+ container.classList.remove('is-panning');
+ panel.hidden = true;
+ resetDockingStyles();
+ restorePassport();
+ feedback.hidden = true;
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.nav.radar'));
+ trigger.title = viewerText('viewer.nav.radar.title');
if (options.restoreFocus === true) trigger.focus();
}
return next;
}
- function toggle() { return setOpen(panel.hidden, { focus: false }); }
+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }
function close(options) { return setOpen(false, options); }
function bringNodeIntoWindow(node) {
var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;
@@ -11388,31 +12381,91 @@
Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });
sync();
}
- function endDrag(event) {
- if (!drag) return;
- drag = null;
+ function endViewportDrag(event) {
+ if (!viewportDrag) return;
+ viewportDrag = null;
panel.removeAttribute('data-dragging');
container.classList.remove('is-panning');
try { surface.releasePointerCapture(event.pointerId); } catch (_) {}
}
+ function beginPanelDrag(event) {
+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;
+ var context = placementContext();
+ if (!context) return;
+ var rect = panel.getBoundingClientRect();
+ event.preventDefault();
+ event.stopPropagation();
+ panelDrag = {
+ pointerId: event.pointerId,
+ originX: event.clientX,
+ originY: event.clientY,
+ start: { left: rect.left, top: rect.top },
+ current: { left: rect.left, top: rect.top },
+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null
+ };
+ panel.setAttribute('data-panel-dragging', 'true');
+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}
+ }
+ function movePanelDrag(event) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ var context = placementContext();
+ if (!context) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var bounds = context.bounds;
+ var position = {
+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),
+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)
+ };
+ panelDrag.current = position;
+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');
+ else panel.setAttribute('data-placement-invalid', 'true');
+ applyPlacement(position, false);
+ }
+ function finishPanelDrag(event, cancel) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var activeDrag = panelDrag;
+ panelDrag = null;
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}
+ var context = placementContext();
+ if (!context) return;
+ if (cancel) {
+ manualPosition = activeDrag.previousManual;
+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };
+ updateDocking();
+ return;
+ }
+ var requested = activeDrag.current;
+ manualPosition = { left: requested.left, top: requested.top };
+ updateDocking();
+ }
trigger.addEventListener('click', toggle);
closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });
+ expandBtn.addEventListener('click', expandCompactRadar);
+ panelHead.addEventListener('pointerdown', beginPanelDrag);
+ panelHead.addEventListener('pointermove', movePanelDrag);
+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });
+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });
surface.addEventListener('pointerdown', function (event) {
if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;
event.preventDefault();
- drag = { pointerId: event.pointerId };
+ viewportDrag = { pointerId: event.pointerId };
panel.setAttribute('data-dragging', 'true');
container.classList.add('is-panning');
try { surface.setPointerCapture(event.pointerId); } catch (_) {}
navigate(event);
});
surface.addEventListener('pointermove', function (event) {
- if (!drag || drag.pointerId !== event.pointerId) return;
+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;
navigate(event);
});
- surface.addEventListener('pointerup', endDrag);
- surface.addEventListener('pointercancel', endDrag);
+ surface.addEventListener('pointerup', endViewportDrag);
+ surface.addEventListener('pointercancel', endViewportDrag);
surface.addEventListener('click', function (event) {
var node = event.target.closest('[data-radar-node-id]');
if (node) focusNode(node.getAttribute('data-radar-node-id'));
@@ -11445,8 +12498,32 @@
Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });
sync();
});
- window.addEventListener('resize', sync);
- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });
+ document.addEventListener('keydown', function (event) {
+ if (!panelDrag || event.key !== 'Escape') return;
+ finishPanelDrag({
+ pointerId: panelDrag.pointerId,
+ preventDefault: function () { event.preventDefault(); },
+ stopPropagation: function () { event.stopPropagation(); }
+ }, true);
+ }, true);
+ function reflow() {
+ if (!requestedOpen) return;
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ sync();
+ }
+ window.addEventListener('resize', reflow);
+ window.addEventListener('scroll', reflow, { passive: true });
+ if (typeof ResizeObserver === 'function') {
+ var radarResizeObserver = new ResizeObserver(function (entries) {
+ if (!requestedOpen) return;
+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;
+ reflow();
+ });
+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {
+ radarResizeObserver.observe(element);
+ });
+ }
requestAnimationFrame(build);
return {
@@ -11455,7 +12532,7 @@
toggle: toggle,
sync: sync,
focus: focusNode,
- isOpen: function () { return !panel.hidden; },
+ isOpen: function () { return requestedOpen; },
count: function () { return nodes.length; }
};
})();
@@ -11485,9 +12562,9 @@
function render(next) {
btn.setAttribute('aria-pressed', next ? 'true' : 'false');
- btn.setAttribute('aria-label', next ? 'Exit presentation stage' : 'Enter presentation stage');
- btn.title = next ? 'Exit presentation stage (F or Escape)' : 'Presentation stage (F)';
- label.textContent = next ? 'Exit' : 'Present';
+ btn.setAttribute('aria-label', viewerText(next ? 'viewer.present.exit' : 'viewer.present.enter'));
+ btn.title = viewerText(next ? 'viewer.present.exit.title' : 'viewer.present.enter.title');
+ label.textContent = viewerText(next ? 'viewer.present.exit.label' : 'viewer.present.present');
}
function setActive(next, options) {
@@ -11556,11 +12633,11 @@
function defaultContext() {
return {
kind: 'focus',
- title: 'Find a node',
- placeholder: 'Search labels or IDs',
- empty: 'No matching nodes',
- resultsLabel: 'Diagram nodes',
- availableNoun: 'nodes',
+ title: viewerText('viewer.finder.title'),
+ placeholder: viewerText('viewer.finder.placeholder'),
+ empty: viewerText('viewer.finder.empty'),
+ resultsLabel: viewerText('viewer.finder.results'),
+ availableNoun: viewerText('viewer.finder.noun.nodes'),
allowedIds: null,
badges: null
};
@@ -11685,13 +12762,13 @@
var badge = context.badges && context.badges[item.id]
? context.badges[item.id]
: context.kind === 'focus'
- ? item.links + (item.links === 1 ? ' link' : ' links')
+ ? viewerCount('viewer.finder.link', item.links)
: String(item.links);
var action = context.kind === 'route-source'
- ? 'Choose ' + item.label + ' as route start'
+ ? viewerText('viewer.finder.result.routeStart', { label: item.label })
: context.kind === 'route-target'
- ? 'Choose ' + item.label + ' as route destination, ' + badge
- : 'Focus ' + item.label + ', ' + item.links + ' related connection' + (item.links === 1 ? '' : 's');
+ ? viewerText('viewer.finder.result.routeTarget', { label: item.label, links: badge })
+ : viewerCount('viewer.finder.result.focus', item.links, { label: item.label });
button.setAttribute('aria-label', action);
var name = document.createElement('strong');
@@ -11700,8 +12777,8 @@
links.textContent = badge;
links.title = context.kind === 'focus' ? badge : action;
var meta = document.createElement('small');
- meta.textContent = [item.type, item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
- meta.title = [item.type, item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.textContent = [viewerKindLabel(item.type), item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.title = [viewerKindLabel(item.type), item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
button.appendChild(name);
button.appendChild(links);
button.appendChild(meta);
@@ -11710,8 +12787,12 @@
});
empty.hidden = visibleItems.length !== 0;
status.textContent = query
- ? visibleItems.length + ' of ' + available.length + ' ' + context.availableNoun
- : available.length + ' ' + context.availableNoun;
+ ? viewerText('viewer.finder.status.filtered', {
+ visible: visibleItems.length,
+ available: available.length,
+ noun: context.availableNoun
+ })
+ : viewerText('viewer.finder.status.all', { available: available.length, noun: context.availableNoun });
}
function open(options) {
@@ -12011,7 +13092,11 @@
item.setAttribute('data-route-journey-index', String(index));
item.setAttribute('data-route-node-id', id);
item.setAttribute('tabindex', index === 0 ? '0' : '-1');
- item.setAttribute('aria-label', 'Route position ' + (index + 1) + ' of ' + ids.length + ': ' + nodeLabel(byId[id], id));
+ item.setAttribute('aria-label', viewerText('viewer.route.position', {
+ index: index + 1,
+ total: ids.length,
+ label: nodeLabel(byId[id], id)
+ }));
}
item.className = 'route-probe-node';
item.textContent = nodeLabel(byId[id], id);
@@ -12023,7 +13108,7 @@
}
function setTrigger(active) {
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Clear traced route' : 'Trace a directed route');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.route.trigger.clear' : 'viewer.guide.route.aria'));
}
function clear(options) {
options = options || {};
@@ -12040,14 +13125,14 @@
panel.hidden = true;
panel.setAttribute('data-state', 'idle');
panel.removeAttribute('data-finder-open');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick two semantic nodes on the diagram');
- status.textContent = 'Choose the source, then the destination. Direction matters.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickTwo'));
+ status.textContent = viewerText('viewer.route.instructions');
findBtn.hidden = true;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
- copyBtn.textContent = 'Copy link';
+ copyBtn.textContent = viewerText('viewer.route.copy');
if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();
setTrigger(false);
if (wasActive && options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
@@ -12178,7 +13263,10 @@
!Archify.motionGovernor.isPaused();
}
function routeOverviewStatus() {
- return activeNodeIds.length + ' nodes · ' + activeEdges.length + ' directed hop' + (activeEdges.length === 1 ? '' : 's') + ' · shortest authored route';
+ return viewerText('viewer.route.overview.status', {
+ nodes: viewerCount('viewer.route.overview.node', activeNodeIds.length),
+ hops: viewerCount('viewer.route.overview.hop', activeEdges.length)
+ });
}
function centerJourneyButton(button) {
if (!button) return;
@@ -12208,19 +13296,19 @@
journeyPlayBtn.setAttribute('aria-pressed', journeyPlaying ? 'true' : 'false');
if (journeyPlaying) {
journeyPlayIcon.textContent = '\u275a\u275a';
- journeyPlayLabel.textContent = 'Pause';
- journeyPlayBtn.setAttribute('aria-label', 'Pause route journey');
- journeyPlayBtn.title = 'Pause route journey';
+ journeyPlayLabel.textContent = viewerText('viewer.route.pause.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.pause'));
+ journeyPlayBtn.title = viewerText('viewer.route.pause');
} else if (journeyComplete || journeyIndex === activeNodeIds.length - 1) {
journeyPlayIcon.textContent = '\u21bb';
- journeyPlayLabel.textContent = 'Replay';
- journeyPlayBtn.setAttribute('aria-label', 'Replay route journey');
- journeyPlayBtn.title = canPlay ? 'Replay route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.replay.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.replay'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.replay' : 'viewer.route.motionRequired');
} else {
journeyPlayIcon.textContent = '\u25b6';
- journeyPlayLabel.textContent = 'Journey';
- journeyPlayBtn.setAttribute('aria-label', 'Play route journey');
- journeyPlayBtn.title = canPlay ? 'Play route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.journey');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.play'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.play' : 'viewer.route.motionRequired');
}
}
function journeyGeometry(shape) {
@@ -12311,8 +13399,17 @@
else button.removeAttribute('aria-current');
});
if (options.center !== false) centerJourneyButton(buttons[journeyIndex]);
- var phase = journeyPlaying ? 'Playing' : (journeyComplete ? 'Complete' : 'Inspecting');
- status.textContent = 'Step ' + (journeyIndex + 1) + ' of ' + activeNodeIds.length + ' · ' + phase + ' · ' + nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex]);
+ var phase = viewerText(journeyPlaying
+ ? 'viewer.route.phase.playing'
+ : journeyComplete
+ ? 'viewer.route.phase.complete'
+ : 'viewer.route.phase.inspecting');
+ status.textContent = viewerText('viewer.route.step', {
+ index: journeyIndex + 1,
+ total: activeNodeIds.length,
+ phase: phase,
+ label: nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex])
+ });
if (options.pulse === true && journeyIndex > 0) renderJourneyPulse(activeEdges[journeyIndex - 1]);
if (options.reveal !== false && Archify.view && typeof Archify.view.reveal === 'function') {
Archify.view.reveal(activeNodeIds.slice(Math.max(0, journeyIndex - 1), Math.min(activeNodeIds.length, journeyIndex + 2)), {
@@ -12484,15 +13581,15 @@
});
svg.setAttribute('data-route-picking', 'target');
panel.setAttribute('data-state', 'target');
- title.textContent = 'Choose a destination from ' + nodeLabel(byId[id], id);
+ title.textContent = viewerText('viewer.route.destination', { label: nodeLabel(byId[id], id) });
renderPath([id]);
var count = Math.max(0, Object.keys(reached).length - 1);
status.textContent = count
- ? count + ' directed destination' + (count === 1 ? '' : 's') + ' available. Pick a highlighted node.'
- : 'No outgoing route starts here. Clear and choose another source.';
+ ? viewerCount('viewer.route.destination.count', count)
+ : viewerText('viewer.route.noOutgoing');
findBtn.hidden = false;
- findBtn.textContent = 'Find target';
- findBtn.setAttribute('aria-label', 'Find a reachable route destination');
+ findBtn.textContent = viewerText('viewer.route.destination.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.destination.find.aria'));
requestDocking();
return true;
}
@@ -12524,7 +13621,10 @@
renderPath(result.nodes, { interactive: true });
panel.setAttribute('data-state', 'result');
panel.hidden = false;
- title.textContent = nodeLabel(byId[startId], startId) + ' to ' + nodeLabel(byId[endId], endId);
+ title.textContent = viewerText('viewer.route.result.title', {
+ source: nodeLabel(byId[startId], startId),
+ target: nodeLabel(byId[endId], endId)
+ });
findBtn.hidden = true;
copyBtn.hidden = false;
setTrigger(true);
@@ -12546,15 +13646,18 @@
if (mode !== 'target') return false;
if (id === startId) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'Choose a different destination';
- status.textContent = 'A route needs two distinct semantic nodes.';
+ title.textContent = viewerText('viewer.route.differentDestination');
+ status.textContent = viewerText('viewer.route.distinct');
return false;
}
var result = shortestDirectedPath(startId, id);
if (!result) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'No directed route to ' + nodeLabel(byId[id], id);
- status.textContent = nodeLabel(byId[id], id) + ' is not reachable from ' + nodeLabel(byId[startId], startId) + '. Pick a highlighted destination.';
+ title.textContent = viewerText('viewer.route.unreachable', { label: nodeLabel(byId[id], id) });
+ status.textContent = viewerText('viewer.route.unreachable.detail', {
+ target: nodeLabel(byId[id], id),
+ source: nodeLabel(byId[startId], startId)
+ });
return false;
}
return showResult(result, options);
@@ -12582,12 +13685,12 @@
panel.hidden = false;
panel.setAttribute('data-state', 'source');
svg.setAttribute('data-route-picking', 'source');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick a semantic node on the diagram');
- status.textContent = 'Select the source. The next step will reveal only directed destinations.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickOne'));
+ status.textContent = viewerText('viewer.route.start.instructions');
findBtn.hidden = false;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
setTrigger(true);
if (focused && nodesById()[focused]) chooseStart(focused);
@@ -12614,14 +13717,14 @@
return outgoing[id] && outgoing[id].length;
});
var sourceBadges = {};
- sourceIds.forEach(function (id) { sourceBadges[id] = 'start'; });
+ sourceIds.forEach(function (id) { sourceBadges[id] = viewerText('viewer.route.finder.source.badge'); });
return {
kind: 'route-source',
- title: 'Choose route start',
- placeholder: 'Search route sources',
- empty: 'No matching route sources',
- resultsLabel: 'Nodes that can start a route',
- availableNoun: 'route sources',
+ title: viewerText('viewer.route.finder.source.title'),
+ placeholder: viewerText('viewer.route.finder.source.placeholder'),
+ empty: viewerText('viewer.route.finder.source.empty'),
+ resultsLabel: viewerText('viewer.route.finder.source.results'),
+ availableNoun: viewerText('viewer.route.finder.source.noun'),
allowedIds: sourceIds,
badges: sourceBadges
};
@@ -12631,15 +13734,15 @@
var targetIds = Object.keys(distances).filter(function (id) { return id !== startId && byId[id]; });
var targetBadges = {};
targetIds.forEach(function (id) {
- targetBadges[id] = distances[id] + ' hop' + (distances[id] === 1 ? '' : 's');
+ targetBadges[id] = viewerCount('viewer.route.hop', distances[id]);
});
return {
kind: 'route-target',
- title: 'Destination from ' + nodeLabel(byId[startId], startId),
- placeholder: 'Search reachable destinations',
- empty: 'No matching reachable destinations',
- resultsLabel: 'Reachable route destinations',
- availableNoun: 'reachable destinations',
+ title: viewerText('viewer.route.finder.target.title', { label: nodeLabel(byId[startId], startId) }),
+ placeholder: viewerText('viewer.route.finder.target.placeholder'),
+ empty: viewerText('viewer.route.finder.target.empty'),
+ resultsLabel: viewerText('viewer.route.finder.target.results'),
+ availableNoun: viewerText('viewer.route.finder.target.noun'),
allowedIds: targetIds,
badges: targetBadges
};
@@ -12680,11 +13783,11 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- copyBtn.setAttribute('aria-label', copied ? 'Traced route link copied' : 'Could not copy traced route link');
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ copyBtn.setAttribute('aria-label', viewerText(copied ? 'viewer.route.copy.success' : 'viewer.route.copy.failed'));
window.setTimeout(function () {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to traced route');
+ copyBtn.textContent = viewerText('viewer.route.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.route.copy.aria'));
}, 1600);
return copied;
});
@@ -12837,12 +13940,6 @@
var finePointerQuery = window.matchMedia ? window.matchMedia('(hover: hover) and (pointer: fine)') : null;
var MAX_LENS_FLOW_EDGES = 24;
- function kindLabel(value) {
- return String(value || 'neutral')
- .replace(/messagebus/gi, 'message bus')
- .replace(/[-_]+/g, ' ')
- .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
- }
function nodesById() {
var byId = {};
Array.prototype.forEach.call(svg.querySelectorAll('[data-node-id][data-node-kind]'), function (node) {
@@ -12857,7 +13954,7 @@
Object.keys(byId).forEach(function (id) {
var node = byId[id];
var value = node.getAttribute('data-node-kind') || 'neutral';
- var kind = kinds[value] || (kinds[value] = { id: value, label: kindLabel(value), nodes: [] });
+ var kind = kinds[value] || (kinds[value] = { id: value, label: viewerKindLabel(value), nodes: [] });
kind.nodes.push(node);
});
return Object.keys(kinds).map(function (key) { return kinds[key]; }).sort(function (a, b) {
@@ -12961,7 +14058,7 @@
entry.setAttribute('role', 'button');
entry.setAttribute('tabindex', legendEntries.length ? '-1' : '0');
var visibleLabel = entry.getAttribute('data-legend-label') || fact.label;
- entry.setAttribute('aria-label', 'Inspect ' + visibleLabel + ', ' + count + ' node' + (count === 1 ? '' : 's'));
+ entry.setAttribute('aria-label', viewerCount('viewer.lens.legend.inspect', count, { label: visibleLabel }));
entry.setAttribute('aria-pressed', 'false');
entry.setAttribute('aria-haspopup', 'dialog');
entry.setAttribute('aria-controls', 'semantic-lens');
@@ -12970,7 +14067,7 @@
});
if (!legendEntries.length) return false;
legendBridge.setAttribute('role', legendEntries.length >= 3 ? 'toolbar' : 'group');
- legendBridge.setAttribute('aria-label', 'Semantic legend');
+ legendBridge.setAttribute('aria-label', viewerText('viewer.lens.legend'));
syncLegendBridge();
layoutLegendBridge();
try {
@@ -13118,7 +14215,7 @@
button.className = 'semantic-lens-kind';
button.setAttribute('data-kind', kind.id);
button.setAttribute('aria-pressed', selectedKinds.indexOf(kind.id) >= 0 ? 'true' : 'false');
- button.setAttribute('aria-label', kind.label + ', ' + kind.nodes.length + ' node' + (kind.nodes.length === 1 ? '' : 's'));
+ button.setAttribute('aria-label', viewerCount('viewer.lens.kind.count', kind.nodes.length, { label: kind.label }));
button.disabled = selectedKinds.length >= 2 && selectedKinds.indexOf(kind.id) === -1;
var swatch = document.createElement('span');
swatch.className = 'semantic-lens-swatch';
@@ -13144,7 +14241,7 @@
function updateTrigger() {
var active = selectedKinds.length > 0;
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Open active semantic lens' : 'Open semantic lens');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.lens.openActive' : 'viewer.lens.open'));
copyBtn.hidden = !active;
syncLegendBridge();
}
@@ -13155,7 +14252,7 @@
}
function dockPanel(byId) {
panel.removeAttribute('data-dock-side');
- if (panel.hidden || !selectedKinds.length || window.innerWidth <= 720) return 'right';
+ if (panel.hidden || window.innerWidth <= 720) return 'right';
var panelRect = panel.getBoundingClientRect();
var containerRect = container.getBoundingClientRect();
if (!panelRect.width || !panelRect.height) return 'right';
@@ -13168,6 +14265,17 @@
var rightCandidate = { left: containerRect.right - 16 - width, right: containerRect.right - 16, top: top, bottom: panelRect.bottom };
var leftScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(leftCandidate, rect); }, 0);
var rightScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(rightCandidate, rect); }, 0);
+ var legend = svg.querySelector('[data-legend]');
+ var nav = container.querySelector('.diagram-nav');
+ var protectedRects = [legend, nav].filter(function (element) {
+ return element && !element.hidden && window.getComputedStyle(element).display !== 'none';
+ }).map(function (element) { return element.getBoundingClientRect(); });
+ leftScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(leftCandidate, rect) * 1000;
+ }, 0);
+ rightScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(rightCandidate, rect) * 1000;
+ }, 0);
var side = leftScore < rightScore ? 'left' : 'right';
panel.setAttribute('data-dock-side', side);
return side;
@@ -13179,7 +14287,7 @@
var nodeKind = {};
Object.keys(byId).forEach(function (id) { nodeKind[id] = byId[id].getAttribute('data-node-kind') || 'neutral'; });
if (!selectedKinds.length) {
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
updateTrigger();
renderKinds();
dockPanel(byId);
@@ -13234,13 +14342,18 @@
renderFlowOverlay(matchedFlow);
if (crossKind) {
var total = forward + reverse;
- status.textContent = kindLabel(selectedKinds[0]) + ' → ' + kindLabel(selectedKinds[1]) + ': ' + forward + ' · ' +
- kindLabel(selectedKinds[1]) + ' → ' + kindLabel(selectedKinds[0]) + ': ' + reverse + ' · ' +
- total + ' direct relationship' + (total === 1 ? '' : 's');
+ status.textContent = viewerCount('viewer.lens.compare', total, {
+ first: viewerKindLabel(selectedKinds[0]),
+ second: viewerKindLabel(selectedKinds[1]),
+ forward: forward,
+ reverse: reverse
+ });
} else {
var nodeCount = collectKinds().filter(function (kind) { return kind.id === selectedKinds[0]; })[0].nodes.length;
- status.textContent = nodeCount + ' ' + kindLabel(selectedKinds[0]) + ' node' + (nodeCount === 1 ? '' : 's') + ' · ' +
- touching + ' touching relationship' + (touching === 1 ? '' : 's') + ' · connected peers remain visible';
+ status.textContent = viewerText('viewer.lens.single', {
+ nodes: viewerCount('viewer.lens.node', nodeCount, { label: viewerKindLabel(selectedKinds[0]) }),
+ relationships: viewerCount('viewer.lens.relationship', touching)
+ });
}
updateTrigger();
renderKinds();
@@ -13313,7 +14426,7 @@
panel.removeAttribute('data-dock-side');
updateTrigger();
renderKinds();
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
if (options.updateUrl !== false) updateHash();
if (options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
Archify.view.reset({ automatic: true });
@@ -13341,8 +14454,8 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- window.setTimeout(function () { copyBtn.textContent = 'Copy link'; }, 1600);
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ window.setTimeout(function () { copyBtn.textContent = viewerText('viewer.common.copyLink'); }, 1600);
return copied;
});
}
@@ -13514,14 +14627,16 @@
var nodes = svg.querySelectorAll('[data-node-id]').length;
var relationships = relationshipCount();
var views = viewCount();
- stats.textContent = nodes + ' semantic node' + (nodes === 1 ? '' : 's') + ' · ' +
- relationships + ' relationship' + (relationships === 1 ? '' : 's') + ' · ' +
- views + ' guided view' + (views === 1 ? '' : 's');
+ stats.textContent = viewerText('viewer.guide.facts', {
+ nodes: viewerCount('viewer.guide.fact.node', nodes),
+ relationships: viewerCount('viewer.guide.fact.relationship', relationships),
+ views: viewerCount('viewer.guide.fact.view', views)
+ });
storyBtn.disabled = views === 0;
storyBtn.setAttribute('aria-disabled', views === 0 ? 'true' : 'false');
storyCopy.textContent = views
- ? 'Walk ' + views + ' authored chapter' + (views === 1 ? '' : 's') + ' and their real relationships.'
- : 'No authored guided story in this diagram.';
+ ? viewerCount('viewer.guide.story.available', views)
+ : viewerText('viewer.guide.story.unavailable');
}
function actionButtons() {
return Array.prototype.slice.call(actions.querySelectorAll('.diagram-guide-action:not(:disabled)'));
@@ -13532,7 +14647,7 @@
html.removeAttribute('data-guide-open');
routePanel.removeAttribute('data-guide-open');
trigger.setAttribute('aria-expanded', 'false');
- trigger.setAttribute('aria-label', 'Open diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.open'));
feedback.textContent = '';
if (options.restoreFocus !== false) trigger.focus();
return false;
@@ -13555,7 +14670,7 @@
html.setAttribute('data-guide-open', 'true');
routePanel.setAttribute('data-guide-open', 'true');
trigger.setAttribute('aria-expanded', 'true');
- trigger.setAttribute('aria-label', 'Close diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.close'));
feedback.textContent = '';
requestAnimationFrame(function () {
var first = actionButtons()[0];
@@ -13567,7 +14682,7 @@
function execute(action) {
feedback.textContent = '';
if (action === 'story' && !viewCount()) {
- feedback.textContent = 'This diagram has no authored guided story.';
+ feedback.textContent = viewerText('viewer.guide.noStory');
return false;
}
close({ restoreFocus: false });
diff --git a/examples/checkout-platform-delta.html b/examples/checkout-platform-delta.html
index 4fce36ee..7dbea51c 100644
--- a/examples/checkout-platform-delta.html
+++ b/examples/checkout-platform-delta.html
@@ -552,8 +552,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2848,6 +2850,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5408,8 +5415,10 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present=&quot;true&quot;]:not([data-embed=&quot;true&quot;]) .diagram-container &gt; svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present=&quot;true&quot;]:not([data-embed=&quot;true&quot;]) .cards { display: none; }
@@ -7704,6 +7713,11 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .diagram-container[data-nav-stage-rail=&quot;true&quot;] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .cards { margin-top: 0.375rem; }
}
html[data-preset=&quot;blueprint&quot;] .card {
@@ -10672,6 +10686,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty(&#39;transform&#39;);
+ clone.style.removeProperty(&#39;clip-path&#39;);
clone.removeAttribute(&#39;data-view-scale&#39;);
clone.removeAttribute(&#39;data-focus-active&#39;);
clone.removeAttribute(&#39;data-reach-active&#39;);
@@ -10846,6 +10861,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
!clone.hasAttribute(&#39;data-chapter-anchor&#39;) &amp;&amp;
!clone.hasAttribute(&#39;data-chapter-preview&#39;) &amp;&amp;
!clone.style.getPropertyValue(&#39;transform&#39;) &amp;&amp;
+ !clone.style.getPropertyValue(&#39;clip-path&#39;) &amp;&amp;
clone.querySelectorAll(&#39;[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]&#39;).length === 0;
var vb = svg.viewBox.baseVal;
@@ -15809,9 +15825,9 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -15822,10 +15838,13 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -15842,26 +15861,76 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = &#39;&#39;;
+ try { transform = window.getComputedStyle(svg).transform || &#39;&#39;; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(&#39;,&#39;).map(Number);
+ if (values.length === 6 &amp;&amp; values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(&#39;,&#39;).map(Number);
+ if (values3d.length === 16 &amp;&amp; values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container &amp;&amp; svg &amp;&amp; nav &amp;&amp; legend &amp;&amp;
+ container &amp;&amp; svg &amp;&amp; nav &amp;&amp;
window.innerWidth &gt; 720 &amp;&amp;
html.getAttribute(&#39;data-embed&#39;) !== &#39;true&#39; &amp;&amp;
(!window.matchMedia || !window.matchMedia(&#39;print&#39;).matches) &amp;&amp;
- visible(nav) &amp;&amp; visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg &amp;&amp; svg.getAttribute(&#39;data-view-scale&#39;));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) &lt; 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) &lt; 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty(&#39;--archify-nav-reserve&#39;, reserve + &#39;px&#39;);
- container.setAttribute(&#39;data-nav-safe-rail&#39;, &#39;true&#39;);
+ container.setAttribute(&#39;data-nav-stage-rail&#39;, &#39;true&#39;);
+ html.setAttribute(&#39;data-nav-stage-rail&#39;, &#39;true&#39;);
} else {
container.style.removeProperty(&#39;--archify-nav-reserve&#39;);
- container.removeAttribute(&#39;data-nav-safe-rail&#39;);
+ container.removeAttribute(&#39;data-nav-stage-rail&#39;);
+ html.removeAttribute(&#39;data-nav-stage-rail&#39;);
}
if (Archify.readerLayout &amp;&amp; typeof Archify.readerLayout.schedule === &#39;function&#39;) {
Archify.readerLayout.schedule();
@@ -15875,15 +15944,23 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -15892,50 +15969,93 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader&#39;s baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 &amp;&amp; restorableReserve &gt; 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) &amp;&amp; intersectionArea(cameraNavRect, cameraStageRect) &gt; 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve &gt; 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched &amp;&amp; reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched &amp;&amp; reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea &gt; 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap &lt; SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched &amp;&amp; reserve &gt; 0 &amp;&amp; actualIntersectionArea &gt; 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched &amp;&amp; reserve &gt; 0 &amp;&amp; stageGap &lt; SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve &gt; 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve &amp;&amp; !collisionLatched) {
+ if (!cameraAtBaseline()) {
schedule();
return Promise.resolve(false);
}
+ if (!reserve &amp;&amp; !railLatched &amp;&amp; !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout &amp;&amp; typeof Archify.readerLayout.whenStable === &#39;function&#39;
? Archify.readerLayout.whenStable().catch(function () {})
@@ -15943,6 +16063,10 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() &amp;&amp; probeFallbackReserve &gt; 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -15964,8 +16088,8 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? &#39;latched&#39; : &#39;clear&#39;,
- lastReceipt ? lastReceipt.intersectionArea : &#39;&#39;
+ railLatched ? &#39;latched&#39; : &#39;clear&#39;,
+ lastReceipt ? lastReceipt.stageGap : &#39;&#39;
].join(&#39;|&#39;);
}
function whenStable() {
@@ -15984,7 +16108,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
if (document.fonts &amp;&amp; document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === &#39;function&#39;) {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === &#39;function&#39;) {
var contentObserver = new MutationObserver(function (records) {
@@ -16005,6 +16129,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve &gt; 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -16024,6 +16149,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -16109,9 +16235,43 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
container.setAttribute(&#39;data-camera-mode&#39;, state.mode);
container.setAttribute(&#39;data-camera-indicator&#39;, semantic ? &#39;true&#39; : &#39;false&#39;);
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale &lt;= 1.001) {
+ svg.style.removeProperty(&#39;clip-path&#39;);
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = &#39;inset(&#39; + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + &#39;px&#39;;
+ }).join(&#39; &#39;) + &#39;)&#39;;
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) &lt; 0.001 &amp;&amp;
+ Math.abs(rendered.x - state.x) &lt; 0.05 &amp;&amp;
+ Math.abs(rendered.y - state.y) &lt; 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = &#39;translate(&#39; + state.x + &#39;px,&#39; + state.y + &#39;px) scale(&#39; + state.scale + &#39;)&#39;;
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale &lt;= 1;
inBtn.disabled = state.scale &gt;= 3;
@@ -16233,9 +16393,6 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
else stopCameraMotion(&#39;reset&#39;, false);
state = { scale: 1, x: 0, y: 0, mode: &#39;overview&#39; };
apply();
- if (Archify.viewerChromeLayout &amp;&amp; typeof Archify.viewerChromeLayout.reprobe === &#39;function&#39;) {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
@@ -20333,8 +20490,10 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present=&quot;true&quot;]:not([data-embed=&quot;true&quot;]) .diagram-container &gt; svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present=&quot;true&quot;]:not([data-embed=&quot;true&quot;]) .cards { display: none; }
@@ -22629,6 +22788,11 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .diagram-container[data-nav-stage-rail=&quot;true&quot;] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail=&quot;true&quot;] .cards { margin-top: 0.375rem; }
}
html[data-preset=&quot;blueprint&quot;] .card {
@@ -25602,6 +25766,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty(&#39;transform&#39;);
+ clone.style.removeProperty(&#39;clip-path&#39;);
clone.removeAttribute(&#39;data-view-scale&#39;);
clone.removeAttribute(&#39;data-focus-active&#39;);
clone.removeAttribute(&#39;data-reach-active&#39;);
@@ -25776,6 +25941,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
!clone.hasAttribute(&#39;data-chapter-anchor&#39;) &amp;&amp;
!clone.hasAttribute(&#39;data-chapter-preview&#39;) &amp;&amp;
!clone.style.getPropertyValue(&#39;transform&#39;) &amp;&amp;
+ !clone.style.getPropertyValue(&#39;clip-path&#39;) &amp;&amp;
clone.querySelectorAll(&#39;[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]&#39;).length === 0;
var vb = svg.viewBox.baseVal;
@@ -30739,9 +30905,9 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -30752,10 +30918,13 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -30772,26 +30941,76 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = &#39;&#39;;
+ try { transform = window.getComputedStyle(svg).transform || &#39;&#39;; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(&#39;,&#39;).map(Number);
+ if (values.length === 6 &amp;&amp; values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(&#39;,&#39;).map(Number);
+ if (values3d.length === 16 &amp;&amp; values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container &amp;&amp; svg &amp;&amp; nav &amp;&amp; legend &amp;&amp;
+ container &amp;&amp; svg &amp;&amp; nav &amp;&amp;
window.innerWidth &gt; 720 &amp;&amp;
html.getAttribute(&#39;data-embed&#39;) !== &#39;true&#39; &amp;&amp;
(!window.matchMedia || !window.matchMedia(&#39;print&#39;).matches) &amp;&amp;
- visible(nav) &amp;&amp; visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg &amp;&amp; svg.getAttribute(&#39;data-view-scale&#39;));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) &lt; 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) &lt; 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty(&#39;--archify-nav-reserve&#39;, reserve + &#39;px&#39;);
- container.setAttribute(&#39;data-nav-safe-rail&#39;, &#39;true&#39;);
+ container.setAttribute(&#39;data-nav-stage-rail&#39;, &#39;true&#39;);
+ html.setAttribute(&#39;data-nav-stage-rail&#39;, &#39;true&#39;);
} else {
container.style.removeProperty(&#39;--archify-nav-reserve&#39;);
- container.removeAttribute(&#39;data-nav-safe-rail&#39;);
+ container.removeAttribute(&#39;data-nav-stage-rail&#39;);
+ html.removeAttribute(&#39;data-nav-stage-rail&#39;);
}
if (Archify.readerLayout &amp;&amp; typeof Archify.readerLayout.schedule === &#39;function&#39;) {
Archify.readerLayout.schedule();
@@ -30805,15 +31024,23 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -30822,50 +31049,93 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader&#39;s baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 &amp;&amp; restorableReserve &gt; 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) &amp;&amp; intersectionArea(cameraNavRect, cameraStageRect) &gt; 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve &gt; 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched &amp;&amp; reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched &amp;&amp; reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea &gt; 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap &lt; SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched &amp;&amp; reserve &gt; 0 &amp;&amp; actualIntersectionArea &gt; 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched &amp;&amp; reserve &gt; 0 &amp;&amp; stageGap &lt; SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve &gt; 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve &amp;&amp; !collisionLatched) {
+ if (!cameraAtBaseline()) {
schedule();
return Promise.resolve(false);
}
+ if (!reserve &amp;&amp; !railLatched &amp;&amp; !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout &amp;&amp; typeof Archify.readerLayout.whenStable === &#39;function&#39;
? Archify.readerLayout.whenStable().catch(function () {})
@@ -30873,6 +31143,10 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() &amp;&amp; probeFallbackReserve &gt; 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -30894,8 +31168,8 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? &#39;latched&#39; : &#39;clear&#39;,
- lastReceipt ? lastReceipt.intersectionArea : &#39;&#39;
+ railLatched ? &#39;latched&#39; : &#39;clear&#39;,
+ lastReceipt ? lastReceipt.stageGap : &#39;&#39;
].join(&#39;|&#39;);
}
function whenStable() {
@@ -30914,7 +31188,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
if (document.fonts &amp;&amp; document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === &#39;function&#39;) {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === &#39;function&#39;) {
var contentObserver = new MutationObserver(function (records) {
@@ -30935,6 +31209,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve &gt; 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -30954,6 +31229,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -31039,9 +31315,43 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
container.setAttribute(&#39;data-camera-mode&#39;, state.mode);
container.setAttribute(&#39;data-camera-indicator&#39;, semantic ? &#39;true&#39; : &#39;false&#39;);
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale &lt;= 1.001) {
+ svg.style.removeProperty(&#39;clip-path&#39;);
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = &#39;inset(&#39; + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + &#39;px&#39;;
+ }).join(&#39; &#39;) + &#39;)&#39;;
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) &lt; 0.001 &amp;&amp;
+ Math.abs(rendered.x - state.x) &lt; 0.05 &amp;&amp;
+ Math.abs(rendered.y - state.y) &lt; 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = &#39;translate(&#39; + state.x + &#39;px,&#39; + state.y + &#39;px) scale(&#39; + state.scale + &#39;)&#39;;
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale &lt;= 1;
inBtn.disabled = state.scale &gt;= 3;
@@ -31163,9 +31473,6 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
else stopCameraMotion(&#39;reset&#39;, false);
state = { scale: 1, x: 0, y: 0, mode: &#39;overview&#39; };
apply();
- if (Archify.viewerChromeLayout &amp;&amp; typeof Archify.viewerChromeLayout.reprobe === &#39;function&#39;) {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
@@ -34635,7 +34942,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!
const status = document.querySelector('#review-status');
const receiptNode = document.querySelector('#archify-compare-receipt');
const reducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)');
- const exportCss = "\n /* ==========================================================\n THEME VARIABLES — switch by toggling [data-theme] on \u003chtml\u003e\n ========================================================== */\n :root,\n [data-theme=\"dark\"] {\n --bg: #020617;\n --grid: #1e293b;\n --text: #ffffff;\n --text-muted: #94a3b8;\n --text-dim: #475569;\n /* UI chrome and menu hints need more contrast than SVG .t-dim accents */\n --text-faint: #7d8da1;\n\n --panel: rgba(15, 23, 42, 0.5);\n --panel-border: #1e293b;\n --lane-fill: rgba(15, 23, 42, 0.22);\n --lane-stroke: #334155;\n\n --arrow: #64748b;\n --arrow-emphasis: #34d399;\n\n /* Opaque mask color used behind semi-transparent component fills\n so the arrows drawn underneath are properly hidden. */\n --mask: #0f172a;\n\n --frontend-fill: rgba(8, 51, 68, 0.4);\n --frontend-stroke: #22d3ee;\n --backend-fill: rgba(6, 78, 59, 0.4);\n --backend-stroke: #34d399;\n --database-fill: rgba(76, 29, 149, 0.4);\n --database-stroke: #a78bfa;\n --cloud-fill: rgba(120, 53, 15, 0.3);\n --cloud-stroke: #fbbf24;\n --security-fill: rgba(136, 19, 55, 0.4);\n --security-stroke: #fb7185;\n --messagebus-fill: rgba(251, 146, 60, 0.3);\n --messagebus-stroke:#fb923c;\n --external-fill: rgba(30, 41, 59, 0.5);\n --external-stroke: #94a3b8;\n\n --toolbar-bg: rgba(15, 23, 42, 0.8);\n --toolbar-border: #334155;\n --toolbar-text: #e2e8f0;\n --toolbar-hover: rgba(15, 23, 42, 0.95);\n --toolbar-menu-bg: #0f172a;\n }\n\n [data-theme=\"light\"] {\n --bg: #f8fafc;\n --grid: #e2e8f0;\n --text: #0f172a;\n --text-muted: #64748b;\n --text-dim: #94a3b8;\n --text-faint: #64748b;\n\n --panel: #ffffff;\n --panel-border: #e2e8f0;\n --lane-fill: rgba(248, 250, 252, 0.65);\n --lane-stroke: #cbd5e1;\n\n --arrow: #94a3b8;\n --arrow-emphasis: #059669;\n\n --mask: #ffffff;\n\n --frontend-fill: rgba(34, 211, 238, 0.15);\n --frontend-stroke: #0891b2;\n --backend-fill: rgba(52, 211, 153, 0.18);\n --backend-stroke: #059669;\n --database-fill: rgba(167, 139, 250, 0.2);\n --database-stroke: #7c3aed;\n --cloud-fill: rgba(251, 191, 36, 0.18);\n --cloud-stroke: #d97706;\n --security-fill: rgba(251, 113, 133, 0.15);\n --security-stroke: #e11d48;\n --messagebus-fill: rgba(251, 146, 60, 0.15);\n --messagebus-stroke:#ea580c;\n --external-fill: rgba(148, 163, 184, 0.18);\n --external-stroke: #64748b;\n\n --toolbar-bg: rgba(255, 255, 255, 0.92);\n --toolbar-border: #cbd5e1;\n --toolbar-text: #334155;\n --toolbar-hover: #ffffff;\n --toolbar-menu-bg: #ffffff;\n }\n\n /* ==========================================================\n SIGNAL FLOW — an opt-in, motion-forward visual preset.\n The variables also target a standalone exported SVG, whose\n root carries data-preset and data-theme directly.\n ========================================================== */\n [data-preset=\"signal-flow\"][data-theme=\"dark\"] {\n --bg: #030711;\n --grid: #15233a;\n --panel: rgba(6, 14, 28, 0.78);\n --panel-border: #1d3350;\n --lane-fill: rgba(9, 22, 40, 0.5);\n --lane-stroke: #2c4564;\n --text: #f5fbff;\n --text-muted: #9eb0c7;\n --text-dim: #52667f;\n --text-faint: #7890ad;\n --mask: #07101e;\n --frontend-fill: rgba(6, 182, 212, 0.14);\n --frontend-stroke: #67e8f9;\n --backend-fill: rgba(16, 185, 129, 0.14);\n --backend-stroke: #5eead4;\n --database-fill: rgba(139, 92, 246, 0.16);\n --database-stroke: #c4b5fd;\n --cloud-fill: rgba(245, 158, 11, 0.13);\n --cloud-stroke: #fcd34d;\n --security-fill: rgba(244, 63, 94, 0.13);\n --security-stroke: #fda4af;\n --messagebus-fill: rgba(249, 115, 22, 0.13);\n --messagebus-stroke: #fdba74;\n --external-fill: rgba(71, 85, 105, 0.24);\n --external-stroke: #a5b4c7;\n --arrow: #7890ad;\n --arrow-emphasis: #2dd4bf;\n --toolbar-bg: rgba(7, 16, 30, 0.86);\n --toolbar-border: #29415f;\n --toolbar-menu-bg: #07101e;\n }\n\n [data-preset=\"signal-flow\"][data-theme=\"light\"] {\n --bg: #f4f9fc;\n --grid: #d4e5ee;\n --panel: rgba(255, 255, 255, 0.82);\n --panel-border: #bfd5e2;\n --lane-fill: rgba(232, 243, 248, 0.62);\n --lane-stroke: #a9c5d5;\n --text: #102638;\n --text-muted: #587287;\n --text-dim: #8aa2b4;\n --text-faint: #668397;\n --mask: #ffffff;\n --frontend-fill: rgba(6, 182, 212, 0.09);\n --frontend-stroke: #0789a1;\n --backend-fill: rgba(5, 150, 105, 0.09);\n --backend-stroke: #087f69;\n --database-fill: rgba(124, 58, 237, 0.09);\n --database-stroke: #7254c7;\n --cloud-fill: rgba(217, 119, 6, 0.08);\n --cloud-stroke: #b9670b;\n --security-fill: rgba(225, 29, 72, 0.08);\n --security-stroke: #c53a59;\n --messagebus-fill: rgba(234, 88, 12, 0.08);\n --messagebus-stroke: #c65f27;\n --external-fill: rgba(100, 116, 139, 0.1);\n --external-stroke: #607a8c;\n --arrow: #7b97aa;\n --arrow-emphasis: #0d9488;\n }\n\n /* ==========================================================\n BLUEPRINT — a review-first drafting preset for deployment,\n infrastructure, and technical design documentation. It keeps\n the same semantic palette and geometry while trading glow for\n precise grid contrast, squared materials, and drafting marks.\n ========================================================== */\n [data-preset=\"blueprint\"][data-theme=\"dark\"] {\n --bg: #06131f;\n --grid: #17425a;\n --panel: rgba(7, 27, 43, 0.9);\n --panel-border: #27627f;\n --lane-fill: rgba(10, 43, 66, 0.36);\n --lane-stroke: #34799a;\n --text: #e3f6ff;\n --text-muted: #91b8ca;\n --text-dim: #557e92;\n --text-faint: #739caf;\n --mask: #0a2031;\n --frontend-fill: rgba(26, 157, 193, 0.14);\n --frontend-stroke: #66d9ef;\n --backend-fill: rgba(31, 155, 124, 0.13);\n --backend-stroke: #69dfbd;\n --database-fill: rgba(120, 105, 196, 0.14);\n --database-stroke: #b4a8ff;\n --cloud-fill: rgba(197, 145, 43, 0.13);\n --cloud-stroke: #ffd166;\n --security-fill: rgba(199, 76, 104, 0.13);\n --security-stroke: #ff8da1;\n --messagebus-fill: rgba(207, 112, 49, 0.13);\n --messagebus-stroke: #ffad66;\n --external-fill: rgba(84, 119, 139, 0.18);\n --external-stroke: #a7cad9;\n --arrow: #78a3b7;\n --arrow-emphasis: #64dfc1;\n --toolbar-bg: rgba(7, 28, 45, 0.92);\n --toolbar-border: #34799a;\n --toolbar-text: #d8f3ff;\n --toolbar-hover: rgba(18, 58, 83, 0.95);\n --toolbar-menu-bg: #0a2031;\n }\n\n [data-preset=\"blueprint\"][data-theme=\"light\"] {\n --bg: #edf7fa;\n --grid: #b5d5e1;\n --panel: rgba(249, 253, 255, 0.94);\n --panel-border: #78aabd;\n --lane-fill: rgba(210, 232, 240, 0.42);\n --lane-stroke: #83b2c4;\n --text: #123344;\n --text-muted: #4e7486;\n --text-dim: #86a6b4;\n --text-faint: #668c9d;\n --mask: #f9fdff;\n --frontend-fill: rgba(8, 145, 178, 0.08);\n --frontend-stroke: #087f9c;\n --backend-fill: rgba(5, 128, 101, 0.08);\n --backend-stroke: #08755f;\n --database-fill: rgba(100, 75, 180, 0.08);\n --database-stroke: #6757a8;\n --cloud-fill: rgba(181, 120, 15, 0.08);\n --cloud-stroke: #a86609;\n --security-fill: rgba(190, 48, 80, 0.07);\n --security-stroke: #b32f50;\n --messagebus-fill: rgba(196, 81, 22, 0.07);\n --messagebus-stroke: #b65120;\n --external-fill: rgba(79, 112, 128, 0.08);\n --external-stroke: #506f7e;\n --arrow: #6d93a5;\n --arrow-emphasis: #087f69;\n --toolbar-bg: rgba(247, 252, 254, 0.94);\n --toolbar-border: #8ab5c5;\n --toolbar-text: #294f61;\n --toolbar-hover: #ffffff;\n --toolbar-menu-bg: #f9fdff;\n }\n\n /* ==========================================================\n EDITORIAL — a warm, publication-minded preset for design\n reviews, launch notes, and documentation. The diagram keeps\n the same semantic palette and exact geometry, but trades\n software chrome for paper, ink, ruled structure, and one\n restrained vermilion accent.\n ========================================================== */\n [data-preset=\"editorial\"][data-theme=\"dark\"] {\n --bg: #181611;\n --grid: #39342a;\n --panel: rgba(35, 31, 24, 0.96);\n --panel-border: #625a4a;\n --lane-fill: rgba(52, 46, 35, 0.46);\n --lane-stroke: #726957;\n --text: #f4eddf;\n --text-muted: #b9ae9b;\n --text-dim: #776e60;\n --text-faint: #9d917e;\n --mask: #231f18;\n --frontend-fill: rgba(43, 133, 142, 0.16);\n --frontend-stroke: #7fc6c7;\n --backend-fill: rgba(63, 132, 92, 0.16);\n --backend-stroke: #8fc29e;\n --database-fill: rgba(117, 91, 141, 0.17);\n --database-stroke: #c0a4d0;\n --cloud-fill: rgba(170, 119, 49, 0.16);\n --cloud-stroke: #d8ad68;\n --security-fill: rgba(157, 69, 65, 0.17);\n --security-stroke: #df9085;\n --messagebus-fill: rgba(174, 79, 42, 0.16);\n --messagebus-stroke: #df946f;\n --external-fill: rgba(126, 115, 96, 0.18);\n --external-stroke: #b8ad99;\n --arrow: #948978;\n --arrow-emphasis: #dd6b3d;\n --toolbar-bg: rgba(35, 31, 24, 0.92);\n --toolbar-border: #625a4a;\n --toolbar-text: #eee5d5;\n --toolbar-hover: #302a20;\n --toolbar-menu-bg: #231f18;\n }\n\n [data-preset=\"editorial\"][data-theme=\"light\"] {\n --bg: #f2eee5;\n --grid: #d8d0c2;\n --panel: rgba(251, 248, 241, 0.97);\n --panel-border: #c4b9a6;\n --lane-fill: rgba(229, 221, 207, 0.42);\n --lane-stroke: #b8aa94;\n --text: #242018;\n --text-muted: #6f6658;\n --text-dim: #a09788;\n --text-faint: #817767;\n --mask: #fbf8f1;\n --frontend-fill: rgba(31, 117, 126, 0.09);\n --frontend-stroke: #287e84;\n --backend-fill: rgba(42, 119, 75, 0.09);\n --backend-stroke: #397b53;\n --database-fill: rgba(105, 75, 130, 0.09);\n --database-stroke: #765d86;\n --cloud-fill: rgba(157, 103, 31, 0.1);\n --cloud-stroke: #9a671f;\n --security-fill: rgba(153, 58, 52, 0.09);\n --security-stroke: #9e463f;\n --messagebus-fill: rgba(182, 70, 27, 0.09);\n --messagebus-stroke: #ad4b25;\n --external-fill: rgba(101, 91, 75, 0.09);\n --external-stroke: #746b5e;\n --arrow: #8a806f;\n --arrow-emphasis: #bb4c23;\n --toolbar-bg: rgba(251, 248, 241, 0.94);\n --toolbar-border: #c4b9a6;\n --toolbar-text: #40392f;\n --toolbar-hover: #fffdf8;\n --toolbar-menu-bg: #fbf8f1;\n }\n\n * { margin: 0; padding: 0; box-sizing: border-box; }\n\n body {\n font-family: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, 'DejaVu Sans Mono', 'Liberation Mono', 'Noto Sans Mono CJK SC', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', monospace;\n background: var(--bg);\n min-height: 100vh;\n padding: 2rem;\n color: var(--text);\n transition: background 0.2s ease, color 0.2s ease;\n }\n\n html[data-preset=\"signal-flow\"] body {\n background-image:\n radial-gradient(circle at 18% -8%, rgba(34, 211, 238, 0.14), transparent 34rem),\n radial-gradient(circle at 92% 18%, rgba(139, 92, 246, 0.12), transparent 30rem);\n background-attachment: fixed;\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] body {\n background-image:\n radial-gradient(circle at 18% -8%, rgba(6, 182, 212, 0.12), transparent 34rem),\n radial-gradient(circle at 92% 18%, rgba(139, 92, 246, 0.08), transparent 30rem);\n }\n html[data-preset=\"blueprint\"] body {\n background-image:\n linear-gradient(var(--grid) 1px, transparent 1px),\n linear-gradient(90deg, var(--grid) 1px, transparent 1px);\n background-size: 32px 32px;\n background-position: -1px -1px;\n background-attachment: fixed;\n }\n html[data-preset=\"editorial\"] body {\n background-image:\n linear-gradient(90deg, transparent 0, transparent 5.4rem, color-mix(in srgb, var(--security-stroke) 18%, transparent) 5.4rem, color-mix(in srgb, var(--security-stroke) 18%, transparent) calc(5.4rem + 1px), transparent calc(5.4rem + 1px)),\n repeating-linear-gradient(0deg, transparent 0, transparent 31px, color-mix(in srgb, var(--grid) 36%, transparent) 31px, color-mix(in srgb, var(--grid) 36%, transparent) 32px);\n background-attachment: fixed;\n }\n\n /* Gallery/embed mode keeps the generated artifact as the source of truth\n while presenting only its diagram surface inside a proof card. */\n html[data-embed=\"true\"] body {\n min-height: 0;\n padding: 0;\n overflow: hidden;\n background: var(--bg);\n background-image: none;\n }\n html[data-embed=\"true\"] .toolbar,\n html[data-embed=\"true\"] .header,\n html[data-embed=\"true\"] .cards,\n html[data-embed=\"true\"] .diagram-nav,\n html[data-embed=\"true\"] .overview-map,\n html[data-embed=\"true\"] .focus-chip,\n html[data-embed=\"true\"] .route-probe,\n html[data-embed=\"true\"] .semantic-lens,\n html[data-embed=\"true\"] .diagram-guide,\n html[data-embed=\"true\"] .node-finder,\n html[data-embed=\"true\"] .guided-views { display: none !important; }\n html[data-embed=\"true\"] .container { max-width: none; }\n html[data-embed=\"true\"] .diagram-container {\n padding: 0.5rem;\n border: 0;\n border-radius: 0;\n box-shadow: none;\n }\n html[data-embed=\"true\"] .diagram-container svg { min-width: 0; }\n\n /* Share Chapter Cue lives in the HTML viewer layer, not inside the SVG.\n It gives one-shot embeds a title, authored note, truthful stop order,\n and lifecycle state while canonical diagram geometry stays untouched. */\n .share-chapter-cue { display: none; }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .share-chapter-cue:not([hidden]),\n html[data-embed=\"true\"][data-share-moment=\"true\"] .share-chapter-cue:not([hidden]) {\n position: absolute;\n z-index: 18;\n top: 0.85rem;\n left: 50%;\n display: grid;\n grid-template-columns: auto minmax(9rem, 13.5rem) minmax(0, 1fr);\n align-items: center;\n gap: 0.45rem 0.85rem;\n width: min(52rem, calc(100% - 1.5rem));\n min-height: 3.35rem;\n padding: 0.55rem 0.75rem 0.65rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 42%, var(--toolbar-border));\n border-radius: 0.75rem;\n background:\n linear-gradient(115deg, color-mix(in srgb, var(--frontend-fill) 52%, transparent), transparent 45%),\n color-mix(in srgb, var(--toolbar-menu-bg) 92%, transparent);\n color: var(--toolbar-text);\n box-shadow: 0 14px 42px rgba(0, 0, 0, 0.3), inset 0 1px 0 rgba(255, 255, 255, 0.045);\n backdrop-filter: blur(16px);\n pointer-events: none;\n animation: archify-share-cue-enter 280ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n html[data-preset=\"blueprint\"] .share-chapter-cue {\n border-radius: 0.2rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--frontend-fill) 46%, transparent), transparent 36%),\n var(--toolbar-menu-bg);\n box-shadow: 0 10px 28px rgba(0, 0, 0, 0.2);\n backdrop-filter: none;\n }\n html[data-preset=\"editorial\"] .share-chapter-cue {\n border-color: var(--panel-border);\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--security-fill) 58%, transparent), transparent 42%),\n var(--toolbar-menu-bg);\n box-shadow: 0 10px 30px color-mix(in srgb, #000 18%, transparent);\n backdrop-filter: none;\n }\n html[data-preset=\"editorial\"] .share-chapter-state { color: var(--arrow-emphasis); }\n html[data-preset=\"editorial\"] .share-chapter-state::before {\n border-radius: 0;\n box-shadow: none;\n transform: rotate(45deg) scale(0.8);\n }\n .share-chapter-index {\n display: grid;\n gap: 0.12rem;\n min-width: 5rem;\n padding-right: 0.75rem;\n border-right: 1px solid var(--toolbar-border);\n }\n .share-chapter-state {\n display: inline-flex;\n align-items: center;\n gap: 0.36rem;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.14em;\n text-transform: uppercase;\n }\n .share-chapter-state::before {\n width: 0.38rem;\n height: 0.38rem;\n border-radius: 50%;\n background: currentColor;\n box-shadow: 0 0 10px currentColor;\n content: '';\n }\n .share-chapter-cue[data-state=\"playing\"] .share-chapter-state::before {\n animation: archify-share-cue-pulse 1.15s ease-in-out infinite;\n }\n .share-chapter-count {\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 700;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .share-chapter-copy { min-width: 0; }\n .share-chapter-copy strong,\n .share-chapter-copy small,\n .share-chapter-route {\n display: block;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .share-chapter-copy strong {\n color: var(--toolbar-text);\n font-size: 0.6875rem;\n line-height: 1.35;\n }\n .share-chapter-copy small {\n margin-top: 0.08rem;\n color: var(--text-muted);\n font-size: 0.5rem;\n line-height: 1.35;\n }\n .share-chapter-route {\n color: color-mix(in srgb, var(--frontend-stroke) 76%, var(--text-muted));\n font-size: 0.5625rem;\n font-weight: 650;\n letter-spacing: 0.015em;\n text-align: right;\n }\n .share-chapter-progress {\n position: absolute;\n right: 0;\n bottom: 0;\n left: 0;\n height: 2px;\n overflow: hidden;\n background: color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n .share-chapter-progress span {\n display: block;\n width: 100%;\n height: 100%;\n background: linear-gradient(90deg, var(--frontend-stroke), var(--database-stroke));\n box-shadow: 0 0 12px var(--frontend-stroke);\n transform: scaleX(0);\n transform-origin: left center;\n }\n\n /* Presentation Stage is a viewer-only layer: it gives the live diagram\n the viewport while keeping guided views, theme, focus, and exports real.\n Embed mode wins when both query parameters are present. */\n html[data-present=\"true\"]:not([data-embed=\"true\"]) body {\n height: 100dvh;\n min-height: 0;\n padding: 1rem;\n overflow: hidden;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .container {\n display: flex;\n flex-direction: column;\n gap: 0.75rem;\n width: 100%;\n max-width: none;\n height: calc(100dvh - 2rem);\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header {\n flex: none;\n min-width: 0;\n margin: 0;\n padding-right: 23rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row { margin-bottom: 0.25rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .subtitle {\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views {\n flex: none;\n margin-bottom: 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container {\n display: flex;\n flex: 1 1 auto;\n align-items: center;\n justify-content: center;\n min-height: 0;\n padding: 0.75rem;\n padding-bottom: calc(0.75rem + var(--archify-nav-reserve));\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container \u003e svg {\n width: 100%;\n height: 100%;\n min-width: 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .cards { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) #btn-present {\n border-color: var(--frontend-stroke);\n color: var(--frontend-stroke);\n }\n\n /* The reader owns only the outer scale. Wide diagrams keep one authored\n SVG/viewBox while the runtime chooses a desktop width from the actual\n vertical budget. This avoids device-specific files and breakpoint\n jumps between a laptop and a tall monitor. */\n .container {\n width: 100%;\n max-width: var(--archify-reader-width, 1440px);\n margin: 0 auto;\n }\n @media (min-width: 768px) and (max-height: 920px) {\n .header { margin-bottom: 1rem; }\n .diagram-container { padding: 1rem; }\n .cards { margin-top: 1rem; }\n .card { padding: 1rem; }\n }\n\n .header { margin-bottom: 1.5rem; padding-right: 29.5rem; }\n\n html[data-preset=\"signal-flow\"] .header,\n html[data-preset=\"blueprint\"] .header,\n html[data-preset=\"editorial\"] .header { padding-right: 29.5rem; }\n\n .header-row {\n display: flex;\n align-items: center;\n gap: 1rem;\n margin-bottom: 0.5rem;\n }\n\n .pulse-dot {\n width: 12px;\n height: 12px;\n background: var(--frontend-stroke);\n border-radius: 50%;\n animation: none;\n }\n\n html[data-motion-capable=\"true\"] .pulse-dot { animation: pulse 2s infinite; }\n\n @keyframes pulse {\n 0%, 100% { opacity: 1; }\n 50% { opacity: 0.5; }\n }\n\n h1 {\n font-size: 1.5rem;\n font-weight: 700;\n letter-spacing: -0.025em;\n }\n\n .subtitle {\n color: var(--text-muted);\n font-size: 0.875rem;\n margin-left: 1.75rem;\n }\n\n html[data-preset=\"signal-flow\"] .header-row::after {\n content: attr(data-preset-badge-signal-flow);\n margin-left: auto;\n color: var(--frontend-stroke);\n border: 1px solid var(--frontend-stroke);\n border-radius: 999px;\n padding: 0.28rem 0.6rem;\n font-size: 0.625rem;\n letter-spacing: 0.12em;\n opacity: 0.82;\n box-shadow: 0 0 20px rgba(34, 211, 238, 0.12);\n white-space: nowrap;\n }\n\n html[data-preset=\"blueprint\"] .pulse-dot {\n width: 10px;\n height: 10px;\n border: 1px solid var(--frontend-stroke);\n border-radius: 1px;\n background: transparent;\n box-shadow: inset 0 0 0 2px var(--bg);\n transform: rotate(45deg);\n animation: none;\n }\n html[data-preset=\"blueprint\"] .header-row::after {\n content: attr(data-preset-badge-blueprint);\n margin-left: auto;\n padding: 0.28rem 0.55rem;\n border-top: 1px solid var(--frontend-stroke);\n border-bottom: 1px solid var(--frontend-stroke);\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 700;\n letter-spacing: 0.14em;\n white-space: nowrap;\n }\n\n html[data-preset=\"editorial\"] h1,\n html[data-preset=\"editorial\"] .card h3 {\n font-family: Georgia, 'Times New Roman', 'Songti SC', STSong, serif;\n letter-spacing: -0.02em;\n }\n html[data-preset=\"editorial\"] h1 { font-size: 1.72rem; font-weight: 600; }\n html[data-preset=\"editorial\"] .pulse-dot {\n width: 9px;\n height: 9px;\n border: 1px solid var(--arrow-emphasis);\n border-radius: 0;\n background: var(--arrow-emphasis);\n box-shadow: 0 0 0 3px color-mix(in srgb, var(--arrow-emphasis) 14%, transparent);\n transform: rotate(45deg);\n animation: none;\n }\n html[data-preset=\"editorial\"] .header-row::after {\n content: attr(data-preset-badge-editorial);\n margin-left: auto;\n padding: 0.32rem 0 0.24rem;\n border-bottom: 2px solid var(--arrow-emphasis);\n color: var(--arrow-emphasis);\n font-family: Georgia, 'Times New Roman', serif;\n font-size: 0.625rem;\n font-style: italic;\n font-weight: 600;\n letter-spacing: 0.08em;\n white-space: nowrap;\n }\n\n .diagram-container {\n --archify-nav-reserve: 0px;\n background: var(--panel);\n border-radius: 1rem;\n border: 1px solid var(--panel-border);\n padding: 1.5rem;\n padding-bottom: calc(1.5rem + var(--archify-nav-reserve));\n overflow: hidden;\n position: relative;\n }\n\n html[data-preset=\"signal-flow\"] .diagram-container {\n position: relative;\n overflow: hidden;\n background: linear-gradient(180deg, rgba(8, 20, 38, 0.82), rgba(3, 8, 18, 0.94));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.04), 0 28px 80px rgba(0, 0, 0, 0.34);\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] .diagram-container {\n background: linear-gradient(180deg, rgba(255, 255, 255, 0.9), rgba(237, 246, 250, 0.94));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.72), 0 24px 60px rgba(45, 78, 99, 0.12);\n }\n html[data-preset=\"blueprint\"] .diagram-container {\n border-color: var(--panel-border);\n border-radius: 0.35rem;\n background: var(--panel);\n box-shadow:\n inset 0 0 0 1px color-mix(in srgb, var(--panel-border) 34%, transparent),\n 0 18px 48px rgba(0, 0, 0, 0.16);\n }\n html[data-preset=\"blueprint\"] .diagram-container::after {\n content: \"\";\n position: absolute;\n z-index: 10;\n inset: 0.7rem;\n pointer-events: none;\n background:\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left top / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left top / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right top / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right top / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left bottom / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left bottom / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right bottom / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right bottom / 1px 1.35rem no-repeat;\n opacity: 0.58;\n }\n html[data-preset=\"editorial\"] .diagram-container {\n overflow: hidden;\n border-color: var(--panel-border);\n border-radius: 0.38rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--security-fill) 58%, transparent), transparent 12%),\n var(--panel);\n box-shadow:\n 0 1px 0 color-mix(in srgb, var(--text) 6%, transparent),\n 0 18px 48px color-mix(in srgb, #000 19%, transparent);\n }\n html[data-preset=\"editorial\"] .diagram-container::after {\n position: absolute;\n z-index: 10;\n top: 0.72rem;\n right: 1.25rem;\n padding: 0.2rem 0.52rem;\n border: 1px solid var(--panel-border);\n background: var(--panel);\n color: var(--arrow-emphasis);\n content: attr(data-preset-badge-editorial-plate);\n font-family: Georgia, 'Times New Roman', serif;\n font-size: 0.52rem;\n font-style: italic;\n font-weight: 600;\n letter-spacing: 0.09em;\n pointer-events: none;\n }\n html[data-embed=\"true\"][data-preset=\"editorial\"] .diagram-container::after { display: none; }\n html[data-motion-capable=\"true\"][data-preset=\"signal-flow\"][data-ambient-motion=\"running\"] .diagram-container::before {\n content: \"\";\n position: absolute;\n inset: 0;\n pointer-events: none;\n background: linear-gradient(115deg, transparent 28%, rgba(103, 232, 249, 0.035) 48%, transparent 68%);\n transform: translateX(-70%);\n animation: archify-signal-scan 4.8s ease-in-out 1 both;\n }\n\n /* Motion Governor gives the reader a real static state and gives the\n strongest semantic action the only motion budget. Atmosphere resets to\n its authored base instead of freezing mid-cycle. Static artifacts never\n start a decorative pulse or scan. */\n html:not([data-motion-capable=\"true\"]) svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n }\n html[data-motion=\"still\"] .pulse-dot,\n html[data-motion=\"still\"] .diagram-container::before,\n html[data-motion=\"still\"] svg[data-animation=\"trace\"] [data-animate],\n html[data-motion-owner] .pulse-dot,\n html[data-motion-owner] .diagram-container::before,\n html[data-motion-owner] svg[data-animation=\"trace\"] [data-animate],\n html[data-embed=\"true\"] .pulse-dot,\n html[data-embed=\"true\"] .diagram-container::before,\n html[data-share-playback=\"true\"] .pulse-dot,\n html[data-share-playback=\"true\"] .diagram-container::before,\n html[data-document-hidden=\"true\"] .pulse-dot,\n html[data-document-hidden=\"true\"] .diagram-container::before,\n html[data-document-hidden=\"true\"] svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n }\n html[data-motion=\"still\"] .diagram-container::before,\n html[data-motion-owner] .diagram-container::before,\n html[data-embed=\"true\"] .diagram-container::before,\n html[data-share-playback=\"true\"] .diagram-container::before {\n opacity: 0;\n }\n html[data-motion=\"still\"] .guided-view-progress span,\n html[data-motion=\"still\"] .guided-story-caption,\n html[data-motion=\"still\"] .story-trail-flow,\n html[data-motion=\"still\"] .intent-trace-flow,\n html[data-motion=\"still\"] .route-probe-flow,\n html[data-motion=\"still\"] .route-journey-flow,\n html[data-motion=\"still\"] .semantic-lens-flow,\n html[data-motion=\"still\"] .diagram-guide,\n html[data-motion=\"still\"] [data-story-step],\n html[data-motion=\"still\"] .overview-map-live,\n html[data-motion=\"still\"] .guided-view-stop,\n html[data-motion=\"still\"] .share-chapter-cue,\n html[data-motion=\"still\"] .share-chapter-state::before,\n html[data-motion=\"still\"] .share-chapter-progress span,\n html[data-document-hidden=\"true\"] .guided-view-progress span,\n html[data-document-hidden=\"true\"] .story-trail-flow,\n html[data-document-hidden=\"true\"] .intent-trace-flow,\n html[data-document-hidden=\"true\"] .route-probe-flow,\n html[data-document-hidden=\"true\"] .route-journey-flow,\n html[data-document-hidden=\"true\"] .semantic-lens-flow,\n html[data-document-hidden=\"true\"] .diagram-guide,\n html[data-document-hidden=\"true\"] [data-story-step],\n html[data-document-hidden=\"true\"] .overview-map-live,\n html[data-document-hidden=\"true\"] .guided-view-stop,\n html[data-document-hidden=\"true\"] .share-chapter-cue,\n html[data-document-hidden=\"true\"] .share-chapter-state::before,\n html[data-document-hidden=\"true\"] .share-chapter-progress span {\n animation: none !important;\n }\n html[data-motion=\"still\"] .guided-view-progress span {\n transform: scaleX(1) !important;\n }\n html[data-motion=\"still\"] svg[data-story-playing=\"true\"] .story-trail-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.55;\n }\n html[data-motion=\"still\"] .intent-trace-flow,\n html[data-motion=\"still\"] .route-probe-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.72;\n }\n html[data-motion=\"still\"] .route-journey-overlay,\n html[data-document-hidden=\"true\"] .route-journey-overlay { display: none !important; }\n html[data-motion=\"still\"] .relationship-pulse-overlay,\n html[data-motion=\"still\"] .story-carrier-overlay,\n html[data-document-hidden=\"true\"] .story-carrier-overlay { display: none !important; }\n html[data-motion=\"still\"] .chapter-handoff-overlay { display: none !important; }\n html[data-motion=\"still\"] .chapter-handoff-anchor { animation: none !important; }\n html[data-motion=\"still\"] .guided-view-chapter,\n html[data-motion=\"still\"] svg [data-node-id],\n html[data-motion=\"still\"] svg [data-edge-from],\n html[data-motion=\"still\"] svg [data-detail],\n html[data-motion=\"still\"] svg [data-detail-anchor],\n html[data-motion=\"still\"] svg [data-legend-hit],\n html[data-motion=\"still\"] svg {\n transition: none !important;\n }\n\n svg {\n width: 100%;\n min-width: min(900px, 100%);\n display: block;\n transform-origin: 0 0;\n transition: transform 0.18s ease;\n }\n\n .diagram-container.is-camera-moving svg {\n transition: transform 0.42s cubic-bezier(0.22, 1, 0.36, 1);\n }\n .diagram-container.is-camera-transaction svg { transition: none; }\n .diagram-container.is-pannable { cursor: grab; }\n .diagram-container.is-panning { cursor: grabbing; user-select: none; }\n .diagram-container.is-panning svg { transition: none; }\n\n .diagram-nav {\n position: absolute;\n right: 1rem;\n bottom: 1rem;\n z-index: 12;\n display: inline-flex;\n align-items: center;\n max-width: calc(100% - 2rem);\n padding: 0.15rem;\n gap: 0;\n overflow-x: auto;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 48%, transparent);\n border-radius: 0.58rem;\n background: color-mix(in srgb, var(--toolbar-bg) 82%, transparent);\n box-shadow: 0 5px 14px rgba(0, 0, 0, 0.07);\n backdrop-filter: blur(10px);\n scrollbar-width: none;\n }\n .diagram-nav::-webkit-scrollbar { display: none; }\n .diagram-nav button,\n .focus-chip button,\n .guided-views button {\n border: 0;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n cursor: pointer;\n }\n .diagram-nav button {\n min-width: 2rem;\n height: 2rem;\n padding: 0 0.35rem;\n border-radius: 0.35rem;\n color: color-mix(in srgb, var(--toolbar-text) 68%, transparent);\n font-size: 0.56rem;\n font-weight: 600;\n letter-spacing: 0.02em;\n transition: background 0.15s, color 0.15s;\n }\n .diagram-nav button:hover,\n .diagram-nav button:focus-visible,\n .focus-chip button:hover,\n .focus-chip button:focus-visible,\n .guided-views button:hover,\n .guided-views button:focus-visible { background: var(--toolbar-hover); }\n .diagram-nav button:focus-visible,\n .focus-chip button:focus-visible,\n .guided-views button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .diagram-nav button:disabled { opacity: 0.38; cursor: default; }\n .diagram-nav button:disabled:hover { background: transparent; }\n .diagram-nav #btn-route-probe,\n .diagram-nav #btn-overview-map,\n .diagram-nav #btn-semantic-lens {\n min-width: auto;\n padding-inline: 0.5rem;\n color: color-mix(in srgb, var(--toolbar-text) 86%, transparent);\n font-weight: 650;\n }\n .diagram-nav #btn-node-finder,\n .diagram-nav [data-view=\"out\"] {\n position: relative;\n margin-left: 0.25rem;\n }\n .diagram-nav #btn-node-finder::before,\n .diagram-nav [data-view=\"out\"]::before {\n position: absolute;\n top: 0.4rem;\n bottom: 0.4rem;\n left: -0.13rem;\n width: 1px;\n background: color-mix(in srgb, var(--toolbar-border) 62%, transparent);\n content: \"\";\n pointer-events: none;\n }\n .diagram-nav-icon {\n display: block;\n width: 0.72rem;\n height: 0.72rem;\n margin: auto;\n background: currentColor;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .diagram-nav-icon.find {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='8.5' cy='8.5' r='4.5' fill='none' stroke='black' stroke-width='1.8'/%3E%3Cpath d='m12 12 4 4' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='8.5' cy='8.5' r='4.5' fill='none' stroke='black' stroke-width='1.8'/%3E%3Cpath d='m12 12 4 4' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.guide {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='10' cy='10' r='7' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.8 7.3a2.4 2.4 0 014.6.9c0 1.8-2.4 2-2.4 3.7M10 14.9h.01' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='10' cy='10' r='7' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.8 7.3a2.4 2.4 0 014.6.9c0 1.8-2.4 2-2.4 3.7M10 14.9h.01' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.minus {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.plus {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 5v10M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 5v10M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav [data-view=\"reset\"] {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.2rem;\n min-width: 3.1rem;\n padding-inline: 0.35rem;\n }\n .diagram-nav [data-view=\"reset\"][data-detail-visible] {\n min-width: 3.8rem;\n }\n .diagram-nav-detail {\n color: color-mix(in srgb, var(--toolbar-text) 52%, transparent);\n font-size: 0.44rem;\n font-weight: 700;\n line-height: 1;\n letter-spacing: 0.07em;\n }\n .diagram-nav-percent {\n color: color-mix(in srgb, var(--toolbar-text) 84%, transparent);\n font-size: 0.55rem;\n font-weight: 650;\n line-height: 1;\n }\n .diagram-container[data-camera-indicator=\"true\"] .diagram-nav-detail,\n .diagram-container[data-camera-indicator=\"true\"] .diagram-nav-percent { color: var(--frontend-stroke); }\n .diagram-nav #btn-diagram-guide[aria-expanded=\"true\"] {\n color: var(--cloud-stroke);\n background: var(--toolbar-hover);\n }\n\n /* Semantic Radar is a deliberately simplified, viewer-only overview. It\n uses authored node bounds and the live camera viewport rather than\n cloning the canonical SVG, so IDs, filters, animation, and export state\n stay singular and deterministic. */\n .overview-map {\n position: absolute;\n right: 1rem;\n bottom: calc(4.15rem + var(--archify-nav-reserve));\n z-index: 12;\n width: 11.25rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n border-radius: 0.78rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 16px 42px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.625rem;\n }\n .overview-map[hidden] { display: none; }\n .overview-map[data-docked=\"true\"] {\n position: fixed;\n right: var(--archify-radar-right, 1rem);\n top: var(--archify-radar-top, 1rem);\n bottom: auto;\n }\n .overview-map[data-docked=\"true\"][data-dock-side=\"left\"] {\n right: auto;\n left: var(--archify-radar-left, 1rem);\n }\n html[data-preset=\"blueprint\"] .overview-map { border-radius: 0.28rem; }\n .overview-map-head {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.45rem;\n min-height: 2.25rem;\n padding: 0.42rem 0.48rem 0.38rem 0.55rem;\n border-bottom: 1px solid var(--toolbar-border);\n background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);\n cursor: grab;\n touch-action: none;\n user-select: none;\n }\n .overview-map[data-panel-dragging=\"true\"] .overview-map-head { cursor: grabbing; }\n .overview-map[data-placement-invalid=\"true\"] {\n border-color: var(--security-stroke);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);\n }\n .overview-map[data-compact=\"true\"] {\n width: 7.4rem;\n }\n .overview-map[data-compact=\"true\"] .overview-map-head {\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.24rem;\n min-height: 1.5rem;\n padding: 0.05rem 0.16rem 0.05rem 0.32rem;\n border-bottom: 0;\n }\n .overview-map[data-compact=\"true\"] .overview-map-live,\n .overview-map[data-compact=\"true\"] .overview-map-copy,\n .overview-map[data-compact=\"true\"] .overview-map-surface,\n .overview-map[data-compact=\"true\"] .overview-map-hint {\n display: none;\n }\n .overview-map[data-compact=\"true\"] .overview-map-expand { display: inline-flex; }\n .overview-map[data-compact=\"true\"] .overview-map-close {\n width: 1.15rem;\n height: 1.15rem;\n font-size: 0.72rem;\n }\n .overview-map-live {\n width: 0.42rem;\n height: 0.42rem;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 0 0 color-mix(in srgb, var(--backend-stroke) 52%, transparent);\n animation: archify-radar-live 2.4s ease-out infinite;\n }\n .overview-map-copy { min-width: 0; line-height: 1.1; }\n .overview-map-copy strong {\n display: block;\n overflow: hidden;\n color: var(--frontend-stroke);\n font-size: 0.59rem;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .overview-map-copy small {\n display: block;\n margin-top: 0.18rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.52rem;\n letter-spacing: 0.04em;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .overview-map-expand {\n display: none;\n align-items: center;\n justify-content: center;\n min-width: 0;\n height: 1.2rem;\n padding: 0 0.34rem;\n overflow: hidden;\n border: 0;\n border-radius: 0.3rem;\n background: transparent;\n color: var(--frontend-stroke);\n font: inherit;\n font-size: 0.49rem;\n font-weight: 700;\n letter-spacing: 0.06em;\n text-transform: uppercase;\n white-space: nowrap;\n cursor: pointer;\n }\n .overview-map-close {\n width: 1.55rem;\n height: 1.55rem;\n padding: 0;\n border: 0;\n border-radius: 0.34rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 0.9rem;\n cursor: pointer;\n }\n .overview-map-expand:hover,\n .overview-map-expand:focus-visible,\n .overview-map-close:hover,\n .overview-map-close:focus-visible { background: var(--toolbar-hover); }\n .overview-map-expand:focus-visible,\n .overview-map-close:focus-visible,\n .overview-map-surface:focus-visible,\n .overview-map-node:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .overview-map-surface {\n position: relative;\n height: 7rem;\n margin: 0.42rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--panel-border) 72%, transparent);\n border-radius: 0.42rem;\n background:\n linear-gradient(color-mix(in srgb, var(--panel-border) 26%, transparent) 1px, transparent 1px),\n linear-gradient(90deg, color-mix(in srgb, var(--panel-border) 26%, transparent) 1px, transparent 1px),\n color-mix(in srgb, var(--bg) 86%, transparent);\n background-size: 12px 12px;\n cursor: crosshair;\n touch-action: none;\n }\n html[data-preset=\"blueprint\"] .overview-map-surface { border-radius: 0.1rem; }\n .overview-map-surface \u003e svg {\n width: 100%;\n height: 100%;\n min-width: 0;\n transform: none !important;\n transition: none !important;\n display: block;\n overflow: visible;\n }\n .overview-map-node {\n fill: var(--backend-stroke);\n fill-opacity: 0.52;\n stroke: var(--backend-stroke);\n stroke-opacity: 0.86;\n vector-effect: non-scaling-stroke;\n cursor: pointer;\n transition: fill-opacity 140ms ease, stroke-width 140ms ease, filter 140ms ease;\n }\n .overview-map-node[data-kind=\"frontend\"],\n .overview-map-node[data-kind=\"start\"] { fill: var(--frontend-stroke); stroke: var(--frontend-stroke); }\n .overview-map-node[data-kind=\"database\"],\n .overview-map-node[data-kind=\"success\"] { fill: var(--database-stroke); stroke: var(--database-stroke); }\n .overview-map-node[data-kind=\"cloud\"],\n .overview-map-node[data-kind=\"waiting\"] { fill: var(--cloud-stroke); stroke: var(--cloud-stroke); }\n .overview-map-node[data-kind=\"messagebus\"] { fill: var(--messagebus-stroke); stroke: var(--messagebus-stroke); }\n .overview-map-node[data-kind=\"security\"],\n .overview-map-node[data-kind=\"decision\"],\n .overview-map-node[data-kind=\"failure\"] { fill: var(--security-stroke); stroke: var(--security-stroke); }\n .overview-map-node[data-kind=\"external\"],\n .overview-map-node[data-kind=\"neutral\"] { fill: var(--external-stroke); stroke: var(--external-stroke); }\n .overview-map-node[data-radar-active=\"true\"],\n .overview-map-node:hover,\n .overview-map-node:focus-visible {\n fill-opacity: 0.92;\n stroke-width: 2.2;\n filter: drop-shadow(0 0 3px currentColor);\n }\n .overview-map-viewport {\n fill: color-mix(in srgb, var(--frontend-fill) 56%, transparent);\n stroke: var(--frontend-stroke);\n stroke-width: 2;\n vector-effect: non-scaling-stroke;\n pointer-events: none;\n filter: drop-shadow(0 0 3px color-mix(in srgb, var(--frontend-stroke) 54%, transparent));\n }\n .overview-map-hint {\n display: flex;\n justify-content: space-between;\n gap: 0.5rem;\n padding: 0 0.52rem 0.46rem;\n color: var(--text-faint);\n font-size: 0.49rem;\n letter-spacing: 0.06em;\n text-transform: uppercase;\n }\n .diagram-nav #btn-overview-map[aria-expanded=\"true\"] {\n color: var(--frontend-stroke);\n background: var(--toolbar-hover);\n }\n .overview-map-feedback {\n position: absolute;\n right: 1rem;\n bottom: 4.15rem;\n z-index: 13;\n max-width: min(16rem, calc(100% - 2rem));\n padding: 0.38rem 0.55rem;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n border-radius: 0.5rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);\n font-size: 0.52rem;\n line-height: 1.35;\n pointer-events: none;\n }\n .overview-map-feedback[hidden] { display: none; }\n .focus-chip[data-radar-yielded=\"true\"] { display: none !important; }\n .diagram-nav #btn-route-probe[aria-pressed=\"true\"] {\n color: var(--backend-stroke);\n background: var(--toolbar-hover);\n }\n .diagram-nav #btn-semantic-lens[aria-expanded=\"true\"],\n .diagram-nav #btn-semantic-lens[aria-pressed=\"true\"] {\n color: var(--database-stroke);\n background: var(--toolbar-hover);\n }\n\n /* Semantic Lens turns the compiled node-kind palette into an analytical\n legend. One kind reveals its real traffic; two kinds compare only their\n direct authored relationships. Geometry and the canonical SVG stay put. */\n .semantic-lens {\n position: absolute;\n right: 1rem;\n bottom: calc(4.15rem + var(--archify-nav-reserve));\n z-index: 24;\n width: min(20rem, calc(100% - 2rem));\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--database-stroke) 58%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(135deg, color-mix(in srgb, var(--database-fill) 34%, transparent), transparent 48%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 52px rgba(0, 0, 0, 0.36);\n backdrop-filter: blur(18px);\n animation: archify-lens-in 180ms cubic-bezier(0.22, 1, 0.36, 1);\n }\n .semantic-lens[hidden] { display: none; }\n .semantic-lens[data-dock-side=\"left\"] { left: 1rem; right: auto; }\n .semantic-lens[data-dock-side=\"right\"] { left: auto; right: 1rem; }\n html[data-preset=\"blueprint\"] .semantic-lens { border-radius: 0.28rem; }\n .semantic-lens-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.75rem;\n padding: 0.72rem 0.78rem 0.62rem;\n border-bottom: 1px solid var(--toolbar-border);\n }\n .semantic-lens-eyebrow {\n display: block;\n color: var(--database-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.16em;\n text-transform: uppercase;\n }\n .semantic-lens-title {\n display: block;\n margin-top: 0.16rem;\n color: var(--text);\n font-size: 0.82rem;\n letter-spacing: -0.02em;\n }\n .semantic-lens-close {\n width: 1.75rem;\n height: 1.75rem;\n padding: 0;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .semantic-lens-close:hover,\n .semantic-lens-close:focus-visible { background: var(--toolbar-hover); }\n .semantic-lens-instruction {\n margin: 0;\n padding: 0.52rem 0.78rem 0.48rem;\n color: var(--text-faint);\n font-size: 0.55rem;\n line-height: 1.45;\n }\n .semantic-lens-kinds {\n display: grid;\n grid-template-columns: 1fr 1fr;\n gap: 0.3rem;\n max-height: min(15rem, 40vh);\n padding: 0 0.5rem 0.5rem;\n overflow-y: auto;\n scrollbar-width: thin;\n }\n .semantic-lens-kind {\n --lens-color: var(--external-stroke);\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.42rem;\n min-width: 0;\n min-height: 2.15rem;\n padding: 0.35rem 0.42rem;\n border: 1px solid color-mix(in srgb, var(--lens-color) 24%, var(--toolbar-border));\n border-radius: 0.45rem;\n background: color-mix(in srgb, var(--panel) 76%, transparent);\n color: var(--toolbar-text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: border-color 140ms ease, background 140ms ease, opacity 140ms ease;\n }\n html[data-preset=\"blueprint\"] .semantic-lens-kind { border-radius: 0.12rem; }\n .semantic-lens-kind[data-kind=\"frontend\"],\n .semantic-lens-kind[data-kind=\"start\"] { --lens-color: var(--frontend-stroke); }\n .semantic-lens-kind[data-kind=\"backend\"],\n .semantic-lens-kind[data-kind=\"active\"] { --lens-color: var(--backend-stroke); }\n .semantic-lens-kind[data-kind=\"database\"],\n .semantic-lens-kind[data-kind=\"success\"] { --lens-color: var(--database-stroke); }\n .semantic-lens-kind[data-kind=\"cloud\"],\n .semantic-lens-kind[data-kind=\"waiting\"] { --lens-color: var(--cloud-stroke); }\n .semantic-lens-kind[data-kind=\"messagebus\"] { --lens-color: var(--messagebus-stroke); }\n .semantic-lens-kind[data-kind=\"security\"],\n .semantic-lens-kind[data-kind=\"decision\"],\n .semantic-lens-kind[data-kind=\"failure\"] { --lens-color: var(--security-stroke); }\n .semantic-lens-kind:hover,\n .semantic-lens-kind:focus-visible,\n .semantic-lens-kind[aria-pressed=\"true\"] {\n border-color: color-mix(in srgb, var(--lens-color) 78%, var(--toolbar-border));\n background: color-mix(in srgb, var(--lens-color) 11%, var(--panel));\n }\n .semantic-lens-kind:focus-visible,\n .semantic-lens-close:focus-visible,\n .semantic-lens-actions button:focus-visible {\n outline: 2px solid var(--database-stroke);\n outline-offset: 1px;\n }\n .semantic-lens-kind:disabled { opacity: 0.34; cursor: default; }\n .semantic-lens-swatch {\n width: 0.48rem;\n height: 0.48rem;\n border-radius: 50%;\n background: var(--lens-color);\n box-shadow: 0 0 8px color-mix(in srgb, var(--lens-color) 58%, transparent);\n }\n .semantic-lens-kind strong {\n overflow: hidden;\n color: var(--text);\n font-size: 0.61rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-lens-kind em {\n color: var(--lens-color);\n font-size: 0.54rem;\n font-style: normal;\n font-weight: 800;\n }\n .semantic-lens-status {\n min-height: 2.5rem;\n margin: 0;\n padding: 0.55rem 0.78rem;\n border-top: 1px solid var(--toolbar-border);\n color: var(--text-faint);\n font-size: 0.55rem;\n line-height: 1.45;\n }\n .semantic-lens-status strong { color: var(--database-stroke); font-weight: 800; }\n .semantic-lens-actions {\n display: flex;\n justify-content: flex-end;\n gap: 0.28rem;\n padding: 0 0.62rem 0.62rem;\n }\n .semantic-lens-actions button {\n min-height: 1.8rem;\n padding: 0.28rem 0.48rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 0.56rem;\n cursor: pointer;\n }\n .semantic-lens-actions button:hover { background: var(--toolbar-hover); }\n .semantic-lens-actions #semantic-lens-copy { color: var(--database-stroke); }\n @keyframes archify-lens-in {\n from { opacity: 0; transform: translateY(5px) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n\n /* Route Probe answers a reader question over the compiled semantic graph:\n choose two stable nodes and reveal the shortest authored directed route.\n The receipt and signal live entirely in the viewer layer. */\n .route-probe {\n position: absolute;\n left: 1rem;\n bottom: calc(1rem + var(--archify-nav-reserve));\n z-index: 12;\n width: min(46rem, calc(100% - 25rem));\n min-width: 18rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 62%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(115deg, color-mix(in srgb, var(--backend-fill) 50%, transparent), transparent 62%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.625rem;\n }\n .route-probe[hidden] { display: none; }\n .route-probe[data-route-dock=\"top\"] {\n top: 1rem;\n bottom: auto;\n }\n html[data-preset=\"blueprint\"] .route-probe { border-radius: 0.25rem; }\n .route-probe-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.65rem;\n padding: 0.52rem 0.58rem 0.44rem;\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 80%, transparent);\n }\n .route-probe-copy { min-width: 0; }\n .route-probe-eyebrow {\n display: block;\n color: var(--backend-stroke);\n font-size: 0.48rem;\n font-weight: 800;\n letter-spacing: 0.15em;\n text-transform: uppercase;\n }\n .route-probe-title {\n display: block;\n margin-top: 0.14rem;\n overflow: hidden;\n color: var(--toolbar-text);\n font-size: 0.72rem;\n line-height: 1.25;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .route-probe-actions { display: flex; gap: 0.2rem; }\n .route-probe button {\n min-height: 1.55rem;\n padding: 0.25rem 0.42rem;\n border: 0;\n border-radius: 0.36rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n cursor: pointer;\n }\n .route-probe button:hover,\n .route-probe button:focus-visible { background: var(--toolbar-hover); }\n .route-probe button:focus-visible {\n outline: 2px solid var(--backend-stroke);\n outline-offset: 1px;\n }\n .route-probe-copy-link { color: var(--frontend-stroke) !important; }\n .route-probe-find { color: var(--backend-stroke) !important; }\n .route-probe-copy-link[hidden] { display: none; }\n .route-probe-find[hidden] { display: none; }\n .route-probe-path {\n display: flex;\n align-items: center;\n min-height: 2.2rem;\n padding: 0.42rem 0.58rem 0.24rem;\n overflow-x: auto;\n scrollbar-width: thin;\n white-space: nowrap;\n }\n .route-probe-node,\n .route-probe button.route-probe-node {\n flex: none;\n max-width: 9.5rem;\n overflow: hidden;\n min-height: 1.75rem !important;\n padding: 0.22rem 0.38rem;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 46%, var(--toolbar-border));\n border-radius: 999px;\n background: color-mix(in srgb, var(--backend-fill) 52%, transparent);\n color: var(--text);\n font-size: 0.56rem;\n font-weight: 700;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .route-probe-node[data-endpoint=\"start\"] {\n border-color: var(--frontend-stroke);\n color: var(--frontend-stroke);\n }\n .route-probe-node[data-endpoint=\"end\"] {\n border-color: var(--security-stroke);\n color: var(--security-stroke);\n }\n .route-probe-node[data-route-journey-state=\"past\"] { opacity: 0.66; }\n .route-probe-node[data-route-journey-state=\"future\"] { opacity: 0.48; }\n .route-probe-node[aria-current=\"step\"] {\n border-color: var(--backend-stroke);\n background: color-mix(in srgb, var(--backend-fill) 82%, var(--toolbar-menu-bg));\n color: var(--text);\n box-shadow: 0 0 0 1px color-mix(in srgb, var(--backend-stroke) 42%, transparent), 0 0 14px color-mix(in srgb, var(--backend-stroke) 34%, transparent);\n opacity: 1;\n }\n html[data-preset=\"blueprint\"] .route-probe-node[aria-current=\"step\"] {\n border-style: double;\n border-width: 3px;\n border-radius: 0.2rem;\n box-shadow: none;\n }\n .route-probe-arrow {\n flex: none;\n padding: 0 0.28rem;\n color: var(--text-faint);\n font-size: 0.65rem;\n }\n .route-probe-placeholder {\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.03em;\n }\n .route-probe-status {\n display: block;\n min-height: 1.45rem;\n padding: 0.08rem 0.58rem 0.44rem;\n color: var(--text-faint);\n font-size: 0.52rem;\n line-height: 1.35;\n }\n .route-journey-controls {\n display: grid;\n grid-template-columns: 2rem minmax(5.8rem, auto) 2rem minmax(4.8rem, auto);\n justify-content: start;\n gap: 0.22rem;\n padding: 0.08rem 0.58rem 0.28rem;\n }\n .route-journey-controls[hidden] { display: none; }\n .route-journey-controls button {\n min-height: 1.8rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent);\n background: color-mix(in srgb, var(--toolbar-bg) 72%, transparent);\n font-size: 0.54rem;\n font-weight: 700;\n }\n .route-journey-controls button:disabled {\n cursor: default;\n opacity: 0.34;\n }\n .route-journey-play { color: var(--backend-stroke) !important; }\n .route-journey-overview { color: var(--frontend-stroke) !important; }\n .route-journey-controls[data-playing=\"true\"] .route-journey-play {\n border-color: color-mix(in srgb, var(--backend-stroke) 64%, var(--toolbar-border));\n background: color-mix(in srgb, var(--backend-fill) 62%, transparent);\n }\n .route-probe[data-state=\"error\"] {\n border-color: color-mix(in srgb, var(--security-stroke) 72%, var(--toolbar-border));\n }\n .route-probe[data-state=\"error\"] .route-probe-status { color: var(--security-stroke); }\n\n .focus-chip {\n position: absolute;\n left: 1rem;\n top: 1rem;\n z-index: 12;\n display: block;\n width: min(22rem, calc(100% - 13rem));\n max-width: calc(100% - 13rem);\n overflow: hidden;\n border: 1px solid var(--frontend-stroke);\n border-radius: 0.85rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.6875rem;\n }\n .focus-chip[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .focus-chip { border-radius: 0.3rem; }\n .focus-chip button {\n flex: none;\n padding: 0.3rem 0.45rem;\n border-radius: 0.35rem;\n font-size: 0.625rem;\n }\n .relationship-lens-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.75rem;\n padding: 0.7rem 0.75rem 0.65rem;\n border-bottom: 1px solid var(--toolbar-border);\n background: linear-gradient(120deg, color-mix(in srgb, var(--frontend-fill) 34%, transparent), transparent 72%);\n }\n .relationship-lens-copy { min-width: 0; }\n .relationship-lens-actions {\n display: flex;\n flex-direction: column;\n align-items: flex-end;\n gap: 0.18rem;\n }\n .relationship-lens-actions button { white-space: nowrap; }\n .relationship-lens-actions #btn-focus-clear {\n display: grid;\n width: 1.75rem;\n height: 1.75rem;\n padding: 0;\n place-items: center;\n color: var(--text-muted);\n font-size: 1rem;\n line-height: 1;\n }\n .relationship-lens-actions #btn-focus-clear:hover,\n .relationship-lens-actions #btn-focus-clear:focus-visible {\n background: var(--toolbar-hover);\n color: var(--text);\n }\n .relationship-lens-actions #btn-focus-copy { color: var(--frontend-stroke); }\n .relationship-lens-actions #btn-focus-relations { display: none; }\n .relationship-lens-eyebrow {\n display: block;\n margin-bottom: 0.18rem;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.14em;\n text-transform: uppercase;\n }\n .relationship-lens-title {\n display: block;\n overflow: hidden;\n color: var(--text);\n font-size: 0.8rem;\n line-height: 1.35;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-detail {\n display: block;\n margin-top: 0.12rem;\n overflow: hidden;\n color: var(--text-muted);\n font-size: 0.625rem;\n line-height: 1.4;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-detail[hidden] { display: none; }\n .semantic-passport-meta {\n display: flex;\n flex-wrap: wrap;\n gap: 0.24rem;\n margin-top: 0.42rem;\n }\n .semantic-passport-meta span,\n .semantic-passport-meta code {\n max-width: 100%;\n overflow: hidden;\n padding: 0.14rem 0.34rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 82%, transparent);\n border-radius: 999px;\n background: color-mix(in srgb, var(--panel) 68%, transparent);\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5rem;\n letter-spacing: 0.04em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-meta [data-passport=\"kind\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 50%, var(--toolbar-border));\n color: var(--frontend-stroke);\n font-weight: 800;\n text-transform: uppercase;\n }\n .semantic-passport-meta [data-passport=\"tag\"] { color: var(--cloud-stroke); }\n .semantic-passport-meta [data-passport=\"brand\"] {\n border-color: color-mix(in srgb, var(--messagebus-stroke) 52%, var(--toolbar-border));\n color: var(--messagebus-stroke);\n font-weight: 700;\n }\n .semantic-passport-meta [hidden] { display: none; }\n html[data-preset=\"blueprint\"] .semantic-passport-meta span,\n html[data-preset=\"blueprint\"] .semantic-passport-meta code { border-radius: 0.1rem; }\n .semantic-passport-evidence {\n margin-top: 0.52rem;\n padding: 0.5rem;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 32%, var(--toolbar-border));\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--backend-fill) 18%, var(--panel));\n }\n .semantic-passport-evidence[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .semantic-passport-evidence { border-radius: 0.18rem; }\n .semantic-passport-evidence-head {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.55rem;\n margin-bottom: 0.35rem;\n }\n .semantic-passport-evidence-status {\n display: inline-flex;\n align-items: center;\n gap: 0.28rem;\n color: var(--backend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .semantic-passport-evidence-status::before {\n content: '';\n width: 0.38rem;\n height: 0.38rem;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 0 3px color-mix(in srgb, var(--backend-stroke) 14%, transparent);\n }\n .semantic-passport-repository {\n min-width: 0;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n text-decoration: none;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-repository:hover,\n .semantic-passport-repository:focus-visible { color: var(--backend-stroke); }\n .semantic-passport-evidence-links { display: grid; gap: 0.22rem; }\n .semantic-passport-source {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.15rem 0.45rem;\n align-items: center;\n padding: 0.34rem 0.4rem;\n border: 1px solid transparent;\n border-radius: 0.38rem;\n color: var(--text-muted);\n text-decoration: none;\n }\n .semantic-passport-source:hover,\n .semantic-passport-source:focus-visible {\n border-color: color-mix(in srgb, var(--backend-stroke) 42%, transparent);\n background: color-mix(in srgb, var(--backend-fill) 32%, transparent);\n color: var(--text);\n }\n .semantic-passport-source strong {\n overflow: hidden;\n font-size: 0.5625rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-source code {\n color: var(--backend-stroke);\n font: inherit;\n font-size: 0.5rem;\n }\n .semantic-passport-source small {\n grid-column: 1 / -1;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-summary {\n display: block;\n margin-top: 0.12rem;\n color: var(--text-faint);\n font-size: 0.5625rem;\n }\n .semantic-passport-reach {\n display: grid;\n gap: 0.28rem;\n margin-top: 0.52rem;\n padding-top: 0.48rem;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 76%, transparent);\n }\n .semantic-passport-reach[hidden] { display: none; }\n .semantic-passport-reach-label {\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.1em;\n text-transform: uppercase;\n }\n .semantic-passport-reach-actions {\n display: grid;\n grid-template-columns: repeat(2, minmax(0, 1fr));\n gap: 0.25rem;\n }\n .semantic-passport-reach-actions button {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n min-width: 0;\n min-height: 2rem;\n padding: 0.32rem 0.42rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent);\n background: color-mix(in srgb, var(--panel) 70%, transparent);\n color: var(--text-muted);\n text-align: left;\n }\n .semantic-passport-reach-actions button:hover:not(:disabled),\n .semantic-passport-reach-actions button:focus-visible {\n border-color: color-mix(in srgb, var(--frontend-stroke) 62%, var(--toolbar-border));\n color: var(--text);\n }\n .semantic-passport-reach-actions button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .semantic-passport-reach-actions button:disabled {\n cursor: default;\n opacity: 0.5;\n }\n .semantic-passport-reach-actions button[aria-pressed=\"true\"] {\n border-color: color-mix(in srgb, var(--reach-color, var(--frontend-stroke)) 72%, var(--toolbar-border));\n background: color-mix(in srgb, var(--reach-fill, var(--frontend-fill)) 48%, transparent);\n color: var(--text);\n }\n #btn-reach-upstream {\n --reach-color: var(--database-stroke);\n --reach-fill: var(--database-fill);\n }\n #btn-reach-downstream {\n --reach-color: var(--backend-stroke);\n --reach-fill: var(--backend-fill);\n }\n .semantic-passport-reach-actions strong {\n color: var(--reach-color, var(--frontend-stroke));\n font-size: 0.625rem;\n }\n .semantic-passport-reach-status {\n color: var(--text-faint);\n font-size: 0.525rem;\n line-height: 1.4;\n }\n .semantic-passport-reach-status[hidden] { display: none; }\n .relationship-lens-list {\n max-height: min(18rem, 46vh);\n overflow: auto;\n padding: 0.4rem;\n scrollbar-width: thin;\n scrollbar-color: var(--frontend-stroke) transparent;\n }\n .relationship-lens-list::-webkit-scrollbar { width: 4px; }\n .relationship-lens-list::-webkit-scrollbar-thumb {\n border-radius: 999px;\n background: color-mix(in srgb, var(--frontend-stroke) 68%, transparent);\n }\n .relationship-lens-group + .relationship-lens-group { margin-top: 0.35rem; }\n .relationship-lens-group-title {\n display: block;\n padding: 0.24rem 0.38rem 0.16rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .relationship-lens-row {\n display: grid;\n grid-template-columns: 2.1rem minmax(0, 1fr);\n gap: 0.06rem 0.45rem;\n width: 100%;\n padding: 0.45rem 0.5rem !important;\n text-align: left;\n }\n .relationship-lens-row:hover,\n .relationship-lens-row:focus-visible,\n .relationship-lens-row[data-preview-active=\"true\"] {\n background: var(--toolbar-hover);\n box-shadow: inset 2px 0 0 var(--frontend-stroke);\n }\n .relationship-lens-row:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: -2px;\n }\n .relationship-lens-direction {\n grid-row: 1 / 3;\n align-self: center;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n }\n .relationship-lens-row[data-direction=\"in\"] .relationship-lens-direction { color: var(--database-stroke); }\n .relationship-lens-row[data-direction=\"loop\"] .relationship-lens-direction { color: var(--security-stroke); }\n .relationship-lens-row strong {\n overflow: hidden;\n color: var(--text);\n font-size: 0.6875rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-row small {\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5625rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-empty {\n margin: 0;\n padding: 0.75rem;\n color: var(--text-faint);\n font-size: 0.625rem;\n text-align: center;\n }\n\n /* Diagram Guide keeps the artifact's growing reader vocabulary\n discoverable without widening the permanent control bar. It derives\n honest counts at runtime and delegates every action to an existing\n production interaction instead of creating a second command system. */\n .diagram-guide {\n position: absolute;\n top: 1rem;\n right: 1rem;\n z-index: 26;\n width: min(32rem, calc(100% - 2rem));\n max-height: min(42rem, calc(100% - 2rem));\n overflow: auto;\n border: 1px solid color-mix(in srgb, var(--cloud-stroke) 58%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(135deg, color-mix(in srgb, var(--cloud-fill) 32%, transparent), transparent 42%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 22px 64px rgba(0, 0, 0, 0.4);\n backdrop-filter: blur(18px);\n animation: archify-guide-in 180ms cubic-bezier(0.22, 1, 0.36, 1);\n }\n .diagram-guide[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .diagram-guide { border-radius: 0.28rem; }\n .diagram-guide-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 1rem;\n padding: 0.82rem 0.9rem 0.68rem;\n border-bottom: 1px solid var(--toolbar-border);\n }\n .diagram-guide-eyebrow {\n display: block;\n color: var(--cloud-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.16em;\n text-transform: uppercase;\n }\n .diagram-guide-title {\n display: block;\n margin-top: 0.16rem;\n color: var(--text);\n font-size: 0.86rem;\n letter-spacing: -0.02em;\n }\n .diagram-guide-close {\n width: 1.8rem;\n height: 1.8rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .diagram-guide-close:hover,\n .diagram-guide-close:focus-visible { background: var(--toolbar-hover); }\n .diagram-guide-stats {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n margin: 0;\n padding: 0.54rem 0.9rem;\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 74%, transparent);\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.025em;\n }\n .diagram-guide-stats::before {\n content: '';\n width: 0.42rem;\n height: 0.42rem;\n flex: none;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 10px color-mix(in srgb, var(--backend-stroke) 72%, transparent);\n }\n .diagram-guide-actions {\n display: grid;\n grid-template-columns: 1fr 1fr;\n gap: 0.38rem;\n padding: 0.62rem;\n }\n .diagram-guide-action {\n --guide-accent: var(--frontend-stroke);\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.55rem;\n min-height: 4.15rem;\n padding: 0.55rem 0.58rem;\n border: 1px solid color-mix(in srgb, var(--guide-accent) 22%, var(--toolbar-border));\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 78%, transparent);\n color: var(--toolbar-text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: border-color 140ms ease, background 140ms ease, transform 140ms ease;\n }\n .diagram-guide-action[data-guide-action=\"route\"] { --guide-accent: var(--backend-stroke); }\n .diagram-guide-action[data-guide-action=\"map\"] { --guide-accent: var(--database-stroke); }\n .diagram-guide-action[data-guide-action=\"lens\"] { --guide-accent: var(--messagebus-stroke); }\n .diagram-guide-action[data-guide-action=\"story\"] { --guide-accent: var(--security-stroke); }\n .diagram-guide-action[data-guide-action=\"present\"] {\n --guide-accent: var(--cloud-stroke);\n }\n .diagram-guide-action:hover,\n .diagram-guide-action:focus-visible {\n border-color: color-mix(in srgb, var(--guide-accent) 76%, var(--toolbar-border));\n background: color-mix(in srgb, var(--guide-accent) 9%, var(--panel));\n transform: translateY(-1px);\n }\n .diagram-guide-action:focus-visible,\n .diagram-guide-close:focus-visible {\n outline: 2px solid var(--cloud-stroke);\n outline-offset: 1px;\n }\n .diagram-guide-action:disabled {\n opacity: 0.42;\n cursor: default;\n transform: none;\n }\n .diagram-guide-index {\n display: grid;\n place-items: center;\n width: 1.65rem;\n height: 1.65rem;\n border: 1px solid color-mix(in srgb, var(--guide-accent) 64%, var(--toolbar-border));\n border-radius: 0.35rem;\n color: var(--guide-accent);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.06em;\n }\n .diagram-guide-action-copy { min-width: 0; }\n .diagram-guide-action strong {\n display: block;\n overflow: hidden;\n color: var(--text);\n font-size: 0.66rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .diagram-guide-action small {\n display: -webkit-box;\n margin-top: 0.18rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n line-height: 1.35;\n -webkit-box-orient: vertical;\n -webkit-line-clamp: 2;\n }\n .diagram-guide kbd {\n align-self: start;\n min-width: 1.45rem;\n padding: 0.12rem 0.3rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.25rem;\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5rem;\n text-align: center;\n }\n .diagram-guide-shortcuts {\n display: flex;\n flex-wrap: wrap;\n gap: 0.34rem 0.62rem;\n padding: 0.58rem 0.9rem 0.68rem;\n border-top: 1px solid var(--toolbar-border);\n color: var(--text-faint);\n font-size: 0.5rem;\n }\n .diagram-guide-shortcuts span {\n display: inline-flex;\n align-items: center;\n gap: 0.28rem;\n white-space: nowrap;\n }\n .diagram-guide-feedback {\n min-height: 1rem;\n margin: -0.18rem 0.9rem 0.62rem;\n color: var(--security-stroke);\n font-size: 0.5rem;\n }\n .diagram-guide-feedback:empty { display: none; }\n @keyframes archify-guide-in {\n from { opacity: 0; transform: translateY(-5px) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n\n .node-finder {\n position: absolute;\n top: 1rem;\n left: 1rem;\n z-index: 24;\n display: flex;\n flex-direction: column;\n width: min(22rem, calc(100% - 2rem));\n max-height: calc(100% - 2rem);\n overflow: hidden;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.85rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 6px 8px rgba(0, 0, 0, 0.22);\n backdrop-filter: blur(16px);\n }\n .node-finder[hidden] { display: none; }\n .node-finder[data-context=\"route-source\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 68%, var(--toolbar-border));\n }\n .node-finder[data-context=\"route-target\"] {\n border-color: color-mix(in srgb, var(--security-stroke) 68%, var(--toolbar-border));\n }\n html[data-preset=\"blueprint\"] .node-finder { border-radius: 0.3rem; }\n .node-finder-head {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.7rem 0.8rem 0.45rem;\n }\n .node-finder-head strong {\n color: var(--text);\n font-size: 0.6875rem;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .node-finder[data-context=\"route-source\"] .node-finder-head strong { color: var(--frontend-stroke); }\n .node-finder[data-context=\"route-target\"] .node-finder-head strong { color: var(--security-stroke); }\n .node-finder-close {\n width: 1.75rem;\n height: 1.75rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .node-finder-close:hover,\n .node-finder-close:focus-visible { background: var(--toolbar-hover); }\n .node-finder-close:focus-visible,\n .node-finder-result:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: -2px;\n }\n .node-finder-search {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.55rem;\n margin: 0 0.55rem 0.55rem;\n padding: 0 0.7rem;\n min-height: 2.6rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 78%, transparent);\n transition: border-color 160ms ease-out, box-shadow 160ms ease-out;\n }\n html[data-preset=\"blueprint\"] .node-finder-search { border-radius: 0.18rem; }\n .node-finder-search \u003e span { color: var(--frontend-stroke); font-size: 0.875rem; }\n .node-finder-search:focus-within {\n border-color: var(--frontend-stroke);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--frontend-stroke) 20%, transparent);\n }\n .node-finder-input {\n appearance: none;\n width: 100%;\n min-width: 0;\n border: 0;\n outline: 0;\n background: transparent;\n color: var(--text);\n font: inherit;\n font-size: 0.75rem;\n }\n .node-finder-input:focus-visible { outline: none; }\n .node-finder-input::placeholder { color: var(--text-faint); }\n .node-finder kbd {\n padding: 0.1rem 0.32rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.25rem;\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5625rem;\n }\n .node-finder-results {\n display: grid;\n flex: 1 1 auto;\n gap: 0;\n min-height: 0;\n max-height: min(18rem, 48vh);\n margin: 0 0.55rem 0.45rem;\n padding: 0;\n overflow-y: auto;\n overscroll-behavior: contain;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 78%, transparent);\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 54%, transparent);\n scroll-padding-block: 0.25rem;\n scrollbar-width: thin;\n }\n html[data-preset=\"blueprint\"] .node-finder-results { border-radius: 0.18rem; }\n .node-finder-result {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.2rem 0.75rem;\n width: 100%;\n min-height: 3.25rem;\n padding: 0.58rem 0.65rem;\n border: 0;\n border-radius: 0;\n background: transparent;\n color: var(--text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: background-color 160ms ease-out;\n }\n .node-finder-result:not(:last-child) {\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 62%, transparent);\n }\n .node-finder-result:hover,\n .node-finder-result:focus-visible {\n position: relative;\n z-index: 1;\n background: color-mix(in srgb, var(--frontend-fill) 48%, var(--toolbar-hover));\n }\n .node-finder-result strong {\n overflow: hidden;\n font-size: 0.75rem;\n line-height: 1.25;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .node-finder-result small {\n grid-column: 1 / -1;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5625rem;\n letter-spacing: 0.015em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .node-finder-result em {\n align-self: center;\n color: var(--frontend-stroke);\n font-size: 0.625rem;\n font-style: normal;\n }\n .node-finder[data-context^=\"route-\"] .node-finder-result em {\n padding: 0.1rem 0.3rem;\n border: 1px solid color-mix(in srgb, currentColor 52%, transparent);\n border-radius: 999px;\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.05em;\n text-transform: uppercase;\n }\n .node-finder[data-context=\"route-target\"] .node-finder-result em { color: var(--security-stroke); }\n .node-finder-empty {\n padding: 1.1rem 0.75rem 1.25rem;\n color: var(--text-faint);\n font-size: 0.6875rem;\n text-align: center;\n }\n .node-finder-status {\n margin: 0;\n padding: 0.1rem 0.8rem 0.65rem;\n color: var(--text-faint);\n font-size: 0.5625rem;\n }\n\n .guided-views {\n display: grid;\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem auto;\n align-items: stretch;\n gap: 0.35rem;\n min-width: 0;\n margin: 0 0 0.75rem;\n padding: 0.35rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.85rem;\n background: var(--toolbar-bg);\n background: linear-gradient(120deg, var(--toolbar-bg), color-mix(in srgb, var(--toolbar-bg) 82%, var(--frontend-fill)));\n box-shadow: 0 12px 36px rgba(0, 0, 0, 0.16);\n backdrop-filter: blur(12px);\n }\n .guided-views[hidden] { display: none; }\n\n html[data-preset=\"blueprint\"] .guided-views {\n border-color: var(--panel-border);\n border-radius: 0.35rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--frontend-fill) 36%, transparent), transparent 24%),\n var(--toolbar-bg);\n box-shadow: 0 12px 28px rgba(0, 0, 0, 0.12);\n }\n html[data-preset=\"blueprint\"] .guided-views button { border-radius: 0.2rem; }\n html[data-preset=\"blueprint\"] .guided-view-progress { border-radius: 0; }\n html[data-preset=\"blueprint\"] .guided-view-progress span { border-radius: 0; }\n .guided-views button {\n min-width: 0;\n padding: 0.45rem 0.6rem;\n border-radius: 0.55rem;\n font-size: 0.75rem;\n }\n .guided-views \u003e #guided-view-prev,\n .guided-views \u003e #guided-view-next { min-width: 2.75rem; min-height: 2.75rem; }\n .guided-views button:disabled { opacity: 0.3; cursor: default; }\n .guided-view-copy {\n min-width: 0;\n padding: 0.2rem 0.5rem;\n border-left: 1px solid var(--toolbar-border);\n overflow: hidden;\n }\n .guided-view-meta {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n min-height: 1rem;\n margin-bottom: 0.12rem;\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 700;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .guided-view-handoff {\n box-sizing: border-box;\n height: 1rem;\n min-width: 0;\n max-width: 15rem;\n overflow: hidden;\n padding: 0 0.38rem;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 46%, transparent);\n border-radius: 999px;\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-fill) 44%, transparent);\n font-size: 0.5rem;\n line-height: calc(1rem - 2px);\n letter-spacing: 0.06em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-view-handoff[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .guided-view-handoff { border-radius: 0.15rem; }\n .chapter-handoff-overlay { pointer-events: none; }\n .chapter-handoff-anchor {\n fill: color-mix(in srgb, var(--frontend-fill) 10%, transparent);\n stroke: var(--frontend-stroke);\n stroke-width: 2;\n stroke-dasharray: 4 4;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n animation: archify-chapter-anchor 0.42s cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"stay\"] { opacity: 1; }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"enter\"] { opacity: 0.78; }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"leave\"] { opacity: 0.26; }\n @keyframes archify-chapter-anchor {\n 0% { opacity: 0.35; stroke-dashoffset: 8; }\n 45% { opacity: 1; }\n 100% { opacity: 0.72; stroke-dashoffset: 0; }\n }\n .guided-view-progress {\n width: 3.5rem;\n height: 2px;\n overflow: hidden;\n border-radius: 999px;\n background: var(--toolbar-border);\n }\n .guided-view-progress span {\n display: block;\n width: 100%;\n height: 100%;\n border-radius: inherit;\n background: var(--frontend-stroke);\n transform: scaleX(0);\n transform-origin: left center;\n }\n .guided-view-copy strong,\n .guided-view-copy small { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n .guided-view-copy strong { color: var(--toolbar-text); font-size: 0.75rem; line-height: 1.35; }\n .guided-view-copy small { margin-top: 0; color: var(--text-muted); font-size: 0.625rem; line-height: 1.35; }\n .guided-story-caption {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n gap: 0.12rem 0.55rem;\n align-items: center;\n min-width: 0;\n margin-top: 0.18rem;\n padding: 0.3rem 0.5rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 32%, var(--toolbar-border));\n border-radius: 0.58rem;\n background: color-mix(in srgb, var(--frontend-fill) 26%, transparent);\n animation: archify-story-caption-in 140ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n .guided-story-caption[hidden] { display: none; }\n .guided-story-caption-index {\n grid-row: 1 / span 2;\n align-self: stretch;\n display: inline-grid;\n min-width: 3.3rem;\n place-items: center;\n padding-right: 0.52rem;\n border-right: 1px solid color-mix(in srgb, var(--frontend-stroke) 28%, var(--toolbar-border));\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .guided-story-caption strong,\n .guided-story-caption small {\n display: block;\n min-width: 0;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-story-caption strong { color: var(--toolbar-text); font-size: 0.6875rem; line-height: 1.3; }\n .guided-story-caption small { color: var(--text-muted); font-size: 0.5625rem; line-height: 1.35; }\n .guided-story-caption-next {\n grid-column: 3;\n grid-row: 1 / span 2;\n display: grid;\n min-width: 6.4rem;\n max-width: 9.5rem;\n align-self: stretch;\n align-content: center;\n padding-left: 0.58rem;\n border-left: 1px solid color-mix(in srgb, var(--frontend-stroke) 22%, var(--toolbar-border));\n }\n .guided-story-caption-next[hidden] { display: none; }\n .guided-story-caption-next small {\n color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--text-muted));\n font-weight: 800;\n letter-spacing: 0.09em;\n text-transform: uppercase;\n }\n .guided-story-caption-next strong { color: var(--text-muted); font-weight: 700; }\n html[data-preset=\"blueprint\"] .guided-story-caption { border-radius: 0.2rem; }\n .guided-views[data-story-beat] .guided-view-copy \u003e #guided-view-label,\n .guided-views[data-story-beat] .guided-view-copy \u003e #guided-view-note { display: none; }\n @keyframes archify-story-caption-in {\n from { opacity: 0; transform: translateY(3px); }\n to { opacity: 1; transform: translateY(0); }\n }\n .guided-view-trail {\n display: flex;\n align-items: center;\n gap: 0.28rem;\n min-width: 0;\n min-height: 1.7rem;\n margin-top: 0;\n padding: 0;\n overflow-x: auto;\n color: var(--text-faint);\n overscroll-behavior-x: contain;\n touch-action: pan-x;\n scrollbar-width: none;\n white-space: nowrap;\n }\n .guided-view-trail[hidden] { display: none; }\n .guided-view-trail::-webkit-scrollbar { display: none; }\n .guided-view-trail .guided-view-stop {\n appearance: none;\n box-sizing: border-box;\n display: inline-flex;\n flex: 0 0 auto;\n align-items: center;\n gap: 0.28rem;\n min-height: 1.5rem;\n padding: 0.1rem 0.3rem 0.1rem 0.18rem;\n border: 1px solid transparent;\n border-radius: 999px;\n background: transparent;\n color: var(--text-muted);\n cursor: pointer;\n font-family: inherit;\n font-size: 0.5625rem;\n font-weight: 650;\n letter-spacing: 0.02em;\n line-height: 1;\n transition: background 140ms ease, border-color 140ms ease, color 140ms ease, opacity 140ms ease;\n }\n .guided-view-stop:hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 36%, transparent);\n background: color-mix(in srgb, var(--frontend-fill) 34%, transparent);\n }\n .guided-view-stop:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .guided-view-stop:disabled { cursor: wait; }\n .guided-view-stop::before {\n display: inline-grid;\n width: 1rem;\n height: 1rem;\n place-items: center;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 54%, var(--toolbar-border));\n border-radius: 50%;\n background: color-mix(in srgb, var(--frontend-fill) 58%, var(--toolbar-bg));\n color: var(--frontend-stroke);\n content: attr(data-story-number);\n font-size: 0.5rem;\n line-height: 1;\n }\n .guided-view-stop + .guided-view-stop::after {\n order: -1;\n color: color-mix(in srgb, var(--frontend-stroke) 58%, var(--text-faint));\n content: '\\00b7';\n font-size: 0.65rem;\n }\n .guided-view-stop[data-story-link=\"forward\"]::after { content: '\\2192'; }\n .guided-view-stop[data-story-link=\"reverse\"]::after { content: '\\2190'; }\n .guided-view-stop[data-story-link=\"multiple\"]::after { content: '\\21c4'; }\n .guided-view-stop[data-story-beat-state=\"pending\"] { opacity: 0.38; }\n .guided-view-stop[data-story-beat-state=\"next\"] {\n border-style: dashed;\n border-color: color-mix(in srgb, var(--frontend-stroke) 42%, var(--toolbar-border));\n color: color-mix(in srgb, var(--toolbar-text) 68%, var(--text-muted));\n opacity: 0.58;\n }\n .guided-view-stop[data-story-beat-state=\"past\"] { color: var(--text-muted); opacity: 0.76; }\n .guided-view-stop[data-story-beat-state=\"active\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--toolbar-border));\n background: color-mix(in srgb, var(--frontend-fill) 42%, transparent);\n color: var(--toolbar-text);\n font-weight: 800;\n opacity: 1;\n }\n .guided-view-stop[data-story-beat-state=\"active\"]::before {\n border-color: var(--frontend-stroke);\n box-shadow: 0 0 10px color-mix(in srgb, var(--frontend-stroke) 54%, transparent);\n }\n html[data-preset=\"blueprint\"] .guided-view-stop,\n html[data-preset=\"blueprint\"] .guided-view-stop::before { border-radius: 0.1rem; }\n html[data-preset=\"blueprint\"] .guided-view-stop[data-story-beat-state=\"active\"]::before { box-shadow: none; }\n .guided-view-actions { display: flex; align-items: stretch; gap: 0.2rem; }\n .guided-view-actions button { white-space: nowrap; }\n .guided-view-play {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.38rem;\n min-width: 6.25rem !important;\n color: var(--frontend-stroke) !important;\n font-size: 0.625rem !important;\n }\n .guided-view-play[aria-pressed=\"true\"] { background: var(--toolbar-hover); }\n .guided-view-all { min-width: 3.25rem !important; color: var(--text-muted) !important; font-size: 0.625rem !important; }\n .guided-view-beat-link {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.3rem;\n min-width: 5.4rem !important;\n min-height: 1.5rem;\n color: var(--text-muted) !important;\n font-size: 0.5625rem !important;\n letter-spacing: 0.025em;\n transition: background 140ms ease, border-color 140ms ease, color 140ms ease;\n }\n .guided-view-beat-link:not(:disabled):hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n color: var(--frontend-stroke) !important;\n }\n .guided-view-beat-link[data-copy-state=\"copied\"] {\n border-color: color-mix(in srgb, var(--backend-stroke) 58%, var(--toolbar-border));\n background: color-mix(in srgb, var(--backend-fill) 46%, transparent);\n color: var(--backend-stroke) !important;\n }\n .guided-view-index {\n grid-column: 1 / -1;\n min-width: 0;\n padding: 0.28rem 0.12rem 0.08rem;\n overflow: hidden;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n @media (min-width: 721px) {\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-index,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-beat-link,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-all,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-trail,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-copy \u003e #guided-view-label,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-copy \u003e #guided-view-note { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-story-caption { margin-top: 0.08rem; }\n }\n .guided-view-chapters {\n display: flex;\n gap: 0.28rem;\n min-width: 0;\n margin: 0;\n padding: 0.08rem 0.05rem 0.2rem;\n overflow-x: auto;\n list-style: none;\n scroll-padding-inline: 0.05rem;\n scroll-snap-type: x proximity;\n scrollbar-width: none;\n }\n .guided-view-chapters::-webkit-scrollbar { display: none; }\n .guided-view-chapters li {\n display: flex;\n flex: 1 1 0;\n min-width: 9.5rem;\n scroll-snap-align: center;\n }\n .guided-view-chapter {\n position: relative;\n display: grid !important;\n grid-template-columns: 1.55rem minmax(0, 1fr) auto;\n align-items: center;\n width: 100%;\n min-height: 2.75rem;\n padding: 0.36rem 0.48rem !important;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent) !important;\n border-radius: 0.48rem !important;\n background: color-mix(in srgb, var(--toolbar-bg) 88%, transparent) !important;\n color: var(--text-muted) !important;\n text-align: left;\n transition: background 0.16s ease, border-color 0.16s ease, opacity 0.16s ease;\n }\n .guided-view-chapter:hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 58%, var(--toolbar-border)) !important;\n background: color-mix(in srgb, var(--frontend-fill) 42%, var(--toolbar-bg)) !important;\n }\n .guided-view-chapter:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .guided-view-chapter-index {\n display: inline-grid;\n width: 1.32rem;\n height: 1.32rem;\n place-items: center;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 48%, var(--toolbar-border));\n border-radius: 50%;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.03em;\n }\n .guided-view-chapter-title {\n min-width: 0;\n overflow: hidden;\n color: var(--toolbar-text);\n font-size: 0.625rem;\n font-weight: 700;\n line-height: 1.3;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-view-chapter-count {\n grid-column: 3;\n grid-row: 1;\n margin-left: 0.38rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-style: normal;\n font-weight: 650;\n white-space: nowrap;\n }\n .guided-view-chapter-delta {\n display: inline-flex;\n grid-column: 3;\n grid-row: 1;\n align-items: center;\n gap: 0.22rem;\n margin-left: 0.38rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 750;\n letter-spacing: 0.01em;\n white-space: nowrap;\n }\n .guided-view-chapter-delta[hidden] { display: none; }\n .guided-view-chapter-delta [data-delta-kind=\"stay\"] { color: var(--text-muted); }\n .guided-view-chapter-delta [data-delta-kind=\"enter\"] { color: var(--frontend-stroke); }\n .guided-view-chapter-delta [data-delta-kind=\"leave\"] { color: var(--security-stroke); }\n .guided-view-chapter[data-preview-active=\"true\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--toolbar-border)) !important;\n background: color-mix(in srgb, var(--frontend-fill) 54%, var(--toolbar-bg)) !important;\n }\n .guided-view-chapter[data-chapter-position=\"current\"] {\n border: 2px solid var(--frontend-stroke) !important;\n padding: calc(0.36rem - 1px) calc(0.48rem - 1px) !important;\n box-shadow: inset 3px 0 0 var(--frontend-stroke);\n color: var(--toolbar-text) !important;\n }\n .guided-view-chapter[data-chapter-position=\"current\"] .guided-view-chapter-index {\n background: var(--frontend-stroke);\n color: var(--bg);\n }\n .guided-view-chapter[data-chapter-position=\"before\"] {\n border-style: solid !important;\n opacity: 0.72;\n }\n .guided-view-chapter[data-chapter-position=\"after\"] { border-style: dashed !important; }\n html[data-preset=\"signal-flow\"] .guided-view-chapter[data-chapter-position=\"current\"] {\n box-shadow: inset 3px 0 0 var(--frontend-stroke), 0 0 18px color-mix(in srgb, var(--frontend-stroke) 18%, transparent);\n }\n html[data-preset=\"blueprint\"] .guided-view-chapter,\n html[data-preset=\"blueprint\"] .guided-view-chapter-index { border-radius: 0.12rem !important; }\n\n /* Story Shelf — keep every authored chapter and the Play action visible,\n but do not spend a second row on unavailable director controls before\n the reader enters a chapter. Existing data-active-view state expands\n the full guided surface without a new toggle or stored preference. */\n .guided-views[data-active-view=\"all\"] {\n grid-template-columns: minmax(11rem, .72fr) auto minmax(0, 2fr);\n align-items: center;\n padding: 0.28rem 0.35rem;\n }\n .guided-views[data-active-view=\"all\"] \u003e #guided-view-prev,\n .guided-views[data-active-view=\"all\"] \u003e #guided-view-next,\n .guided-views[data-active-view=\"all\"] .guided-view-beat-link,\n .guided-views[data-active-view=\"all\"] .guided-view-all { display: none; }\n .guided-views[data-active-view=\"all\"] .guided-view-copy {\n grid-column: 1;\n grid-row: 1;\n padding: 0.1rem 0.55rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-copy \u003e #guided-view-note { display: none; }\n .guided-views[data-active-view=\"all\"] .guided-view-actions {\n display: block;\n grid-column: 2;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-play { min-height: 2.75rem; }\n .guided-views[data-active-view=\"all\"] .guided-view-index {\n grid-column: 3;\n grid-row: 1;\n padding: 0 0.08rem 0 0.42rem;\n border-top: 0;\n border-left: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n .guided-views[data-active-view=\"all\"] .guided-view-chapters {\n gap: 0.3rem;\n padding: 0;\n }\n\n .cards {\n display: grid;\n grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));\n gap: 1rem;\n margin-top: 2rem;\n }\n\n .card {\n background: var(--panel);\n border-radius: 0.75rem;\n border: 1px solid var(--panel-border);\n padding: 1.25rem;\n }\n\n html[data-preset=\"signal-flow\"] .card {\n background: linear-gradient(145deg, rgba(10, 24, 43, 0.86), rgba(5, 12, 24, 0.92));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.035);\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] .card {\n background: linear-gradient(145deg, rgba(255, 255, 255, 0.92), rgba(237, 246, 250, 0.9));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.82), 0 12px 32px rgba(45, 78, 99, 0.08);\n }\n\n /* Preserve the one-screen guarantee on ordinary laptop displays. The\n high-screen expansion above must not trade a fuller canvas for page\n scrolling at 900–1080px heights. */\n @media (min-width: 768px) and (max-height: 1100px) {\n .header { margin-bottom: 1rem; }\n .diagram-container {\n padding: 0.875rem;\n padding-bottom: calc(0.875rem + var(--archify-nav-reserve));\n }\n .cards { margin-top: 1rem; }\n .card { padding: 1rem; }\n }\n @media (min-width: 768px) and (max-height: 920px) {\n body { padding-block: 1.25rem; }\n .header { margin-bottom: 0.875rem; }\n .cards { margin-top: 0.75rem; }\n }\n\n html[data-preset=\"blueprint\"] .card {\n position: relative;\n border-color: var(--panel-border);\n border-radius: 0.3rem;\n background: var(--panel);\n box-shadow: none;\n }\n html[data-preset=\"blueprint\"] .card::before {\n content: \"\";\n position: absolute;\n top: -1px;\n left: 1rem;\n width: 2.5rem;\n border-top: 2px solid var(--frontend-stroke);\n }\n\n html[data-preset=\"editorial\"] .card {\n position: relative;\n border-radius: 0.28rem;\n background: var(--panel);\n box-shadow: 0 10px 28px color-mix(in srgb, #000 10%, transparent);\n }\n html[data-preset=\"editorial\"] .card::before {\n position: absolute;\n top: -1px;\n left: 1.25rem;\n width: 3.25rem;\n border-top: 3px solid var(--arrow-emphasis);\n content: \"\";\n }\n html[data-preset=\"editorial\"] .card-dot { border-radius: 0; transform: rotate(45deg) scale(0.78); }\n\n .card-header {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n margin-bottom: 0.75rem;\n }\n\n .card-dot {\n width: 8px;\n height: 8px;\n border-radius: 50%;\n }\n\n .card-dot.cyan { background: var(--frontend-stroke); }\n .card-dot.emerald { background: var(--backend-stroke); }\n .card-dot.violet { background: var(--database-stroke); }\n .card-dot.amber { background: var(--cloud-stroke); }\n .card-dot.rose { background: var(--security-stroke); }\n .card-dot.orange { background: var(--messagebus-stroke); }\n .card-dot.slate { background: var(--external-stroke); }\n\n .card h3 { font-size: 0.875rem; font-weight: 600; color: var(--text); }\n\n .card ul {\n list-style: none;\n color: var(--text-muted);\n font-size: 0.75rem;\n }\n\n .card li { margin-bottom: 0.375rem; }\n\n /* ==========================================================\n Print stylesheet — hide interactive controls, force light,\n drop the grid so the diagram doesn't waste ink, use landscape\n so wide diagrams fit, pack summary cards into 2 columns to\n avoid an orphan card on a trailing page.\n ========================================================== */\n @page { size: landscape; margin: 1.5cm; }\n\n @media print {\n /* Force the FULL light palette — including component fills/strokes and\n lane/arrow colors — so printing from dark theme doesn't put neon\n strokes and translucent dark fills on white paper. */\n :root, [data-theme=\"dark\"], [data-theme=\"light\"] {\n --bg: #ffffff;\n --grid: transparent;\n --panel: #ffffff;\n --panel-border: #e2e8f0;\n --text: #0f172a;\n --text-muted: #475569;\n --text-dim: #94a3b8;\n --text-faint: #64748b;\n --mask: #ffffff;\n --lane-fill: rgba(248, 250, 252, 0.65);\n --lane-stroke: #cbd5e1;\n --arrow: #94a3b8;\n --arrow-emphasis: #059669;\n --frontend-fill: rgba(34, 211, 238, 0.15);\n --frontend-stroke: #0891b2;\n --backend-fill: rgba(52, 211, 153, 0.18);\n --backend-stroke: #059669;\n --database-fill: rgba(167, 139, 250, 0.2);\n --database-stroke: #7c3aed;\n --cloud-fill: rgba(251, 191, 36, 0.18);\n --cloud-stroke: #d97706;\n --security-fill: rgba(251, 113, 133, 0.15);\n --security-stroke: #e11d48;\n --messagebus-fill: rgba(251, 146, 60, 0.15);\n --messagebus-stroke:#ea580c;\n --external-fill: rgba(148, 163, 184, 0.18);\n --external-stroke: #64748b;\n }\n body { background: #ffffff !important; padding: 0; }\n .container { max-width: none; }\n .toolbar, .diagram-nav, .focus-chip, .guided-views, .archify-toast, .no-print { display: none !important; }\n .chapter-handoff-overlay { display: none !important; }\n svg [data-node-id][data-chapter-role] { opacity: 1 !important; }\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }\n .diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }\n .diagram-container { --archify-nav-reserve: 0px !important; }\n html[data-preset=\"signal-flow\"] .diagram-container,\n html[data-preset=\"signal-flow\"] .card { background: #ffffff; }\n .cards { grid-template-columns: 1fr 1fr; }\n /* Ensure elements break sensibly across pages */\n .card { break-inside: avoid; page-break-inside: avoid; }\n .diagram-container { break-inside: avoid; page-break-inside: avoid; }\n .diagram-container svg [data-detail] {\n opacity: 1 !important;\n pointer-events: auto !important;\n }\n .diagram-container svg [data-detail-anchor] { transform: none !important; }\n .diagram-container svg[data-lens-active] [data-node-id],\n .diagram-container svg[data-lens-active] [data-edge-from],\n .diagram-container svg[data-legend-preview-active] [data-node-id],\n .diagram-container svg[data-legend-preview-active] [data-edge-from] {\n opacity: 1 !important;\n filter: none !important;\n }\n [data-legend-bridge-runtime] { display: none !important; }\n .semantic-lens-overlay { display: none !important; }\n .relationship-hit-overlay { display: none !important; }\n .relationship-pulse-overlay { display: none !important; }\n .route-probe-overlay, .route-journey-overlay { display: none !important; }\n .story-trail-overlay,\n .story-carrier-overlay { display: none !important; }\n .diagram-container svg[data-focus-active] [data-node-id],\n .diagram-container svg[data-focus-active] [data-edge-from],\n .diagram-container svg[data-reach-active] [data-node-id],\n .diagram-container svg[data-reach-active] [data-edge-from],\n .diagram-container svg[data-story-beat] [data-story-step],\n .diagram-container svg[data-story-beat] [data-edge-from][data-story-beat-step],\n .diagram-container svg[data-route-active] [data-node-id],\n .diagram-container svg[data-route-active] [data-edge-from] {\n opacity: 1 !important;\n filter: none !important;\n animation: none !important;\n }\n h1, .subtitle { color: #0f172a; }\n }\n\n /* ==========================================================\n TOOLBAR (theme toggle + export menu)\n ========================================================== */\n .toolbar {\n position: fixed;\n top: 1rem;\n right: 1rem;\n display: flex;\n align-items: center;\n gap: 0.5rem;\n padding: 0;\n border: 0;\n background: transparent;\n box-shadow: none;\n z-index: 100;\n }\n .toolbar button {\n background: var(--toolbar-bg);\n color: var(--toolbar-text);\n border: 1px solid var(--toolbar-border);\n padding: 0.5rem 0.875rem;\n border-radius: 0.625rem;\n font-family: inherit;\n font-size: 0.75rem;\n font-weight: 500;\n cursor: pointer;\n white-space: nowrap;\n backdrop-filter: blur(10px);\n box-shadow: 0 4px 14px rgba(0, 0, 0, 0.08);\n transition: background 0.15s, border-color 0.15s, color 0.15s;\n display: inline-flex;\n align-items: center;\n gap: 0.375rem;\n min-height: 2.75rem;\n }\n .toolbar button:hover {\n background: var(--toolbar-hover);\n border-color: color-mix(in srgb, var(--arrow) 62%, var(--toolbar-border));\n }\n .toolbar button[aria-expanded=\"true\"],\n .toolbar button[aria-pressed=\"true\"]:not(#btn-theme) {\n background: color-mix(in srgb, var(--frontend-stroke) 10%, var(--toolbar-hover));\n border-color: color-mix(in srgb, var(--frontend-stroke) 48%, var(--toolbar-border));\n }\n .toolbar #btn-export {\n padding-right: 0.82rem;\n padding-left: 0.82rem;\n }\n .toolbar #btn-export:hover,\n .toolbar #btn-export[aria-expanded=\"true\"] {\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-stroke) 10%, var(--toolbar-hover));\n border-color: color-mix(in srgb, var(--frontend-stroke) 54%, var(--toolbar-border));\n }\n .toolbar button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 2px;\n }\n .toolbar #btn-motion[hidden] { display: none !important; }\n .toolbar #btn-motion { min-width: 4.4rem; }\n .toolbar #btn-motion:disabled { cursor: default; opacity: 0.58; }\n .toolbar .preset-wrap,\n .toolbar .export-wrap {\n position: relative;\n }\n .toolbar-icon {\n display: inline-block;\n width: 0.95rem;\n height: 0.95rem;\n flex: 0 0 auto;\n background: currentColor;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .toolbar-chevron {\n width: 0.65rem;\n height: 0.65rem;\n transition: transform 0.15s ease;\n }\n [aria-expanded=\"true\"] \u003e .toolbar-chevron { transform: rotate(180deg); }\n [data-theme=\"light\"] #theme-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cg fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'%3E%3Ccircle cx='10' cy='10' r='3.1'/%3E%3Cpath d='M10 2.2v1.4M10 16.4v1.4M2.2 10h1.4M16.4 10h1.4M4.5 4.5l1 1M14.5 14.5l1 1M15.5 4.5l-1 1M5.5 14.5l-1 1'/%3E%3C/g%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cg fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'%3E%3Ccircle cx='10' cy='10' r='3.1'/%3E%3Cpath d='M10 2.2v1.4M10 16.4v1.4M2.2 10h1.4M16.4 10h1.4M4.5 4.5l1 1M14.5 14.5l1 1M15.5 4.5l-1 1M5.5 14.5l-1 1'/%3E%3C/g%3E%3C/svg%3E\");\n }\n [data-theme=\"dark\"] #theme-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M15.2 12.7A6.3 6.3 0 017.3 4.8a6.3 6.3 0 107.9 7.9Z' fill='none' stroke='black' stroke-width='1.7' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M15.2 12.7A6.3 6.3 0 017.3 4.8a6.3 6.3 0 107.9 7.9Z' fill='none' stroke='black' stroke-width='1.7' stroke-linejoin='round'/%3E%3C/svg%3E\");\n }\n #btn-present[aria-pressed=\"false\"] #present-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 3.2h-4v4M12.8 3.2h4v4M7.2 16.8h-4v-4M12.8 16.8h4v-4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 3.2h-4v4M12.8 3.2h4v4M7.2 16.8h-4v-4M12.8 16.8h4v-4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n #btn-present[aria-pressed=\"true\"] #present-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 7.2h-4v-4M12.8 7.2h4v-4M7.2 12.8h-4v4M12.8 12.8h4v4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 7.2h-4v-4M12.8 7.2h4v-4M7.2 12.8h-4v4M12.8 12.8h4v4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .toolbar-chevron {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='m3 4.5 3 3 3-3' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='m3 4.5 3 3 3-3' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n }\n .toolbar #btn-preset { min-width: 5.4rem; }\n .preset-control-mark {\n width: 0.58rem;\n height: 0.58rem;\n flex: 0 0 auto;\n border: 1px solid var(--frontend-stroke);\n border-radius: 0.2rem;\n background: color-mix(in srgb, var(--frontend-stroke) 28%, transparent);\n transition: border-radius 0.15s, box-shadow 0.15s, transform 0.15s;\n }\n #btn-preset[data-preset-option=\"signal-flow\"] .preset-control-mark {\n border-radius: 50%;\n box-shadow: 0 0 10px color-mix(in srgb, var(--frontend-stroke) 78%, transparent);\n }\n #btn-preset[data-preset-option=\"blueprint\"] .preset-control-mark {\n border-radius: 0.06rem;\n background: transparent;\n box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--frontend-stroke) 32%, transparent);\n transform: rotate(45deg) scale(0.84);\n }\n #btn-preset[data-preset-option=\"editorial\"] .preset-control-mark {\n border-color: var(--arrow-emphasis);\n border-radius: 0;\n background: var(--arrow-emphasis);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--arrow-emphasis) 14%, transparent);\n transform: rotate(45deg) scale(0.72);\n }\n .toolbar .preset-menu {\n position: absolute;\n top: calc(100% + 0.375rem);\n right: 0;\n display: none;\n width: 18.5rem;\n max-width: calc(100vw - 2rem);\n padding: 0.45rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.875rem;\n background: var(--toolbar-menu-bg);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.24);\n }\n .toolbar .preset-menu.open { display: block; }\n .toolbar .preset-menu.open,\n .toolbar .export-menu.open {\n animation: toolbar-menu-in 0.16s cubic-bezier(0.2, 0.8, 0.2, 1);\n transform-origin: top right;\n }\n @keyframes toolbar-menu-in {\n from { opacity: 0; transform: translateY(-0.25rem) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n .preset-menu-heading {\n display: flex;\n align-items: baseline;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.42rem 0.6rem 0.55rem;\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.13em;\n text-transform: uppercase;\n }\n .preset-menu-heading span:last-child {\n font-size: 0.52rem;\n letter-spacing: 0.04em;\n text-transform: none;\n }\n .toolbar .preset-option {\n display: grid;\n grid-template-columns: 2rem minmax(0, 1fr) 1rem;\n align-items: center;\n gap: 0.68rem;\n width: 100%;\n min-height: 3.35rem;\n padding: 0.5rem 0.62rem;\n border: 0;\n border-radius: 0.5rem;\n background: transparent;\n box-shadow: none;\n backdrop-filter: none;\n text-align: left;\n }\n .toolbar .preset-option:hover,\n .toolbar .preset-option:focus-visible { background: var(--toolbar-hover); }\n .toolbar .preset-option[aria-checked=\"true\"] {\n background: color-mix(in srgb, var(--frontend-stroke) 9%, transparent);\n border-color: color-mix(in srgb, var(--frontend-stroke) 36%, transparent);\n }\n .preset-option-swatch {\n position: relative;\n width: 2rem;\n height: 1.55rem;\n overflow: hidden;\n border: 1px solid #64748b;\n border-radius: 0.24rem;\n background: #0f172a;\n box-shadow: inset 0 0 0 1px rgba(255,255,255,0.04);\n }\n .preset-option-swatch::before,\n .preset-option-swatch::after { position: absolute; content: \"\"; }\n .preset-option-swatch.classic::before {\n top: 0.42rem;\n right: 0.35rem;\n bottom: 0.42rem;\n left: 0.35rem;\n border: 1px solid #22d3ee;\n border-radius: 0.16rem;\n background: rgba(34, 211, 238, 0.14);\n }\n .preset-option-swatch.signal-flow {\n border-color: #29415f;\n background: linear-gradient(135deg, #07101e 10%, #10243c 100%);\n }\n .preset-option-swatch.signal-flow::before {\n top: 50%;\n right: 0.2rem;\n left: 0.2rem;\n height: 1px;\n background: linear-gradient(90deg, #67e8f9, #c4b5fd);\n box-shadow: 0 0 8px #67e8f9;\n }\n .preset-option-swatch.signal-flow::after {\n top: calc(50% - 0.13rem);\n right: 0.28rem;\n width: 0.26rem;\n height: 0.26rem;\n border-radius: 50%;\n background: #67e8f9;\n box-shadow: 0 0 7px #67e8f9;\n }\n .preset-option-swatch.blueprint {\n border-color: #34799a;\n border-radius: 0.08rem;\n background-color: #0a2031;\n background-image:\n linear-gradient(rgba(102, 217, 239, 0.18) 1px, transparent 1px),\n linear-gradient(90deg, rgba(102, 217, 239, 0.18) 1px, transparent 1px);\n background-size: 0.42rem 0.42rem;\n }\n .preset-option-swatch.blueprint::before {\n top: 0.34rem;\n right: 0.38rem;\n bottom: 0.34rem;\n left: 0.38rem;\n border: 1px solid #66d9ef;\n }\n .preset-option-swatch.editorial {\n border-color: #b8aa94;\n border-radius: 0.08rem;\n background: repeating-linear-gradient(0deg, #f2eee5 0 0.34rem, #d8d0c2 0.36rem, #f2eee5 0.38rem);\n }\n .preset-option-swatch.editorial::before {\n top: 0;\n bottom: 0;\n left: 0.42rem;\n width: 1px;\n background: #c9502d;\n opacity: 0.72;\n }\n .preset-option-swatch.editorial::after {\n top: 0.52rem;\n right: 0.45rem;\n width: 0.38rem;\n height: 0.38rem;\n background: #c9502d;\n transform: rotate(45deg);\n }\n .preset-option-copy { min-width: 0; }\n .preset-option-copy strong,\n .preset-option-copy small { display: block; }\n .preset-option-copy strong {\n color: var(--toolbar-text);\n font-size: 0.72rem;\n font-weight: 600;\n }\n .preset-option-copy small {\n margin-top: 0.16rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.57rem;\n font-weight: 400;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .preset-option-check {\n display: inline-block;\n width: 0.9rem;\n height: 0.9rem;\n color: var(--frontend-stroke);\n background: currentColor;\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='m3 8.5 3 3 7-7' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='m3 8.5 3 3 7-7' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n opacity: 0;\n }\n .preset-option[aria-checked=\"true\"] .preset-option-check { opacity: 1; }\n html[data-preset=\"editorial\"] .toolbar button,\n html[data-preset=\"editorial\"] .preset-menu,\n html[data-preset=\"editorial\"] .export-menu,\n html[data-preset=\"editorial\"] .overview-map,\n html[data-preset=\"editorial\"] .semantic-lens,\n html[data-preset=\"editorial\"] .route-probe,\n html[data-preset=\"editorial\"] .focus-chip,\n html[data-preset=\"editorial\"] .diagram-guide,\n html[data-preset=\"editorial\"] .node-finder,\n html[data-preset=\"editorial\"] .guided-views,\n html[data-preset=\"editorial\"] .share-chapter-cue {\n border-radius: 0.3rem;\n }\n .motion-control-dot {\n width: 0.46rem;\n height: 0.46rem;\n flex: 0 0 auto;\n border: 1px solid var(--frontend-stroke);\n border-radius: 50%;\n background: var(--frontend-stroke);\n box-shadow: 0 0 9px color-mix(in srgb, var(--frontend-stroke) 72%, transparent);\n }\n #btn-motion[aria-pressed=\"false\"] .motion-control-dot {\n background: transparent;\n box-shadow: none;\n }\n .toolbar .export-menu {\n position: absolute;\n top: calc(100% + 0.375rem);\n right: 0;\n background: var(--toolbar-menu-bg);\n border: 1px solid var(--toolbar-border);\n width: 19rem;\n max-width: calc(100vw - 2rem);\n max-height: calc(100vh - 5.5rem);\n overflow-y: auto;\n border-radius: 0.875rem;\n padding: 0.55rem;\n display: none;\n flex-direction: column;\n box-shadow: 0 18px 48px rgba(0,0,0,0.24);\n }\n .toolbar .export-menu.open { display: flex; }\n .export-menu-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.5rem 0.55rem 0.72rem;\n }\n .export-menu-header strong,\n .export-menu-header span { display: block; }\n .export-menu-header strong {\n color: var(--toolbar-text);\n font-size: 0.78rem;\n font-weight: 650;\n letter-spacing: -0.015em;\n }\n .export-menu-header span {\n margin-top: 0.16rem;\n color: var(--text-faint);\n font-size: 0.56rem;\n }\n .export-menu-header kbd {\n padding: 0.16rem 0.36rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.3rem;\n color: var(--text-faint);\n background: color-mix(in srgb, var(--toolbar-border) 16%, transparent);\n font-family: inherit;\n font-size: 0.54rem;\n font-weight: 600;\n }\n .export-menu-section {\n display: grid;\n grid-template-columns: minmax(0, 1fr);\n gap: 0.18rem;\n }\n .export-menu-section + .export-menu-section {\n margin-top: 0.42rem;\n padding-top: 0.42rem;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 68%, transparent);\n }\n .export-menu-heading {\n grid-column: 1 / -1;\n display: block;\n padding: 0.24rem 0.55rem 0.2rem;\n color: var(--text-faint);\n font-size: 0.54rem;\n font-weight: 600;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .toolbar .export-menu button {\n display: grid;\n grid-template-columns: 1.15rem minmax(0, 1fr);\n align-items: center;\n column-gap: 0.52rem;\n background: transparent;\n border: 1px solid transparent;\n box-shadow: none;\n backdrop-filter: none;\n width: 100%;\n min-height: 3rem;\n text-align: left;\n padding: 0.48rem 0.55rem;\n border-radius: 0.5rem;\n white-space: nowrap;\n }\n .export-item-copy {\n display: block;\n min-width: 0;\n }\n .export-item-copy strong,\n .export-item-copy small { display: block; }\n .export-item-copy strong {\n overflow: hidden;\n color: inherit;\n font-size: 0.7rem;\n font-weight: 550;\n text-overflow: ellipsis;\n }\n .export-item-copy small {\n margin-top: 0.12rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.55rem;\n font-weight: 450;\n text-overflow: ellipsis;\n }\n .toolbar .export-menu button::before {\n width: 1rem;\n height: 1rem;\n background: currentColor;\n content: \"\";\n opacity: 0.72;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .toolbar .export-menu button[data-format=\"share-card\"]::before,\n .toolbar .export-menu button[data-action=\"route-share-card\"]::before,\n .toolbar .export-menu button[data-action=\"reach-share-card\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='black' stroke-width='1.7' d='M3 4.5h14v11H3zM6 12l2.5-2.5 2 2 1.5-1.5 2 2'/%3E%3Ccircle cx='13.8' cy='7.3' r='1.2' fill='black'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='black' stroke-width='1.7' d='M3 4.5h14v11H3zM6 12l2.5-2.5 2 2 1.5-1.5 2 2'/%3E%3Ccircle cx='13.8' cy='7.3' r='1.2' fill='black'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-action^=\"copy\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Crect x='6' y='6' width='10' height='10' rx='1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M4 13H3.5A1.5 1.5 0 012 11.5v-8A1.5 1.5 0 013.5 2h8A1.5 1.5 0 0113 3.5V4' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Crect x='6' y='6' width='10' height='10' rx='1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M4 13H3.5A1.5 1.5 0 012 11.5v-8A1.5 1.5 0 013.5 2h8A1.5 1.5 0 0113 3.5V4' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"png\"]::before,\n .toolbar .export-menu button[data-format=\"jpeg\"]::before,\n .toolbar .export-menu button[data-format=\"webp\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 2.5h7l3 3v12H5zM12 2.5v3h3' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.5 14l2-2 1.5 1.5 1.5-1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 2.5h7l3 3v12H5zM12 2.5v3h3' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.5 14l2-2 1.5 1.5 1.5-1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"svg\"]::before,\n .toolbar .export-menu button[data-format=\"webm\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2.5l7 4v7l-7 4-7-4v-7zM3 6.5l7 4 7-4M10 10.5v7' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2.5l7 4v7l-7 4-7-4v-7zM3 6.5l7 4 7-4M10 10.5v7' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"share-card\"],\n .toolbar .export-menu button[data-action=\"route-share-card\"],\n .toolbar .export-menu button[data-action=\"reach-share-card\"] {\n min-height: 3.35rem;\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-stroke) 8%, transparent);\n border-color: color-mix(in srgb, var(--frontend-stroke) 24%, var(--toolbar-border));\n }\n .toolbar .export-menu button[hidden] { display: none; }\n .toolbar .export-menu button:hover {\n background: var(--toolbar-hover);\n }\n .toolbar .export-menu button:focus-visible {\n background: var(--toolbar-hover);\n outline-offset: -2px;\n }\n .toolbar .export-menu button:disabled {\n color: var(--text-faint);\n background: color-mix(in srgb, var(--toolbar-border) 18%, transparent);\n cursor: not-allowed;\n }\n .toolbar .export-menu button:disabled:hover {\n border-color: transparent;\n }\n .toolbar .export-menu .hint {\n color: var(--text-faint);\n font-size: 0.55rem;\n }\n\n /* Toast — brief feedback for actions like \"copied\" */\n .archify-toast {\n position: fixed;\n top: 1rem;\n left: 50%;\n transform: translateX(-50%) translateY(-8px);\n background: var(--toolbar-menu-bg);\n color: var(--text);\n border: 1px solid var(--toolbar-border);\n padding: 0.5rem 1rem;\n border-radius: 0.5rem;\n font-family: inherit;\n font-size: 0.75rem;\n opacity: 0;\n transition: opacity 0.2s, transform 0.2s;\n z-index: 200;\n pointer-events: none;\n box-shadow: 0 4px 20px rgba(0,0,0,0.25);\n }\n .archify-toast.show {\n opacity: 1;\n transform: translateX(-50%) translateY(0);\n }\n\n @media (max-width: 720px) {\n body { padding: 1rem; }\n .toolbar .preset-menu,\n .toolbar .export-menu {\n position: fixed;\n top: 4.5rem;\n right: 1rem;\n left: 1rem;\n width: auto;\n max-width: none;\n }\n .toolbar {\n position: relative;\n justify-content: flex-end;\n width: max-content;\n max-width: 100%;\n margin-left: auto;\n margin-bottom: 1rem;\n }\n .header { margin-bottom: 1.25rem; padding-right: 0; }\n html[data-preset=\"signal-flow\"] .header,\n html[data-preset=\"blueprint\"] .header,\n html[data-preset=\"editorial\"] .header { padding-right: 0; }\n .header-row {\n gap: 0.75rem;\n align-items: flex-start;\n }\n html[data-preset=\"signal-flow\"] .header-row,\n html[data-preset=\"blueprint\"] .header-row,\n html[data-preset=\"editorial\"] .header-row { flex-wrap: wrap; }\n html[data-preset=\"signal-flow\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n html[data-preset=\"blueprint\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n html[data-preset=\"editorial\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n h1 {\n font-size: 1.25rem;\n line-height: 1.25;\n }\n .subtitle {\n margin-left: 0;\n font-size: 0.8125rem;\n line-height: 1.55;\n }\n .diagram-container {\n padding: 0.75rem;\n border-radius: 0.75rem;\n }\n html:not([data-embed=\"true\"]) .diagram-container {\n padding: 0.75rem 0.75rem 4.25rem;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] {\n overflow-x: auto;\n overflow-y: hidden;\n overscroll-behavior-x: contain;\n scrollbar-width: thin;\n scroll-behavior: smooth;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] \u003e svg {\n min-width: 720px;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .diagram-nav,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .overview-map,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .focus-chip,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .route-probe,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .semantic-lens,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .diagram-guide,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .node-finder {\n transform: translateX(var(--archify-scroll-x, 0px));\n }\n .diagram-nav { right: 0.5rem; bottom: 0.5rem; }\n .diagram-nav button {\n min-width: 2.75rem;\n height: 2.75rem;\n }\n .diagram-nav [data-view=\"reset\"] { min-width: 3.75rem; }\n .diagram-nav [data-view=\"reset\"][data-detail-visible] { min-width: 4.35rem; }\n .overview-map {\n right: 0.5rem;\n bottom: 3.7rem;\n width: min(10.25rem, calc(100% - 1rem));\n }\n .overview-map[data-docked=\"true\"] {\n right: var(--archify-radar-right, 0.5rem);\n top: var(--archify-radar-top, 0.5rem);\n bottom: auto;\n transform: none !important;\n }\n .overview-map[data-docked=\"true\"][data-dock-side=\"left\"] {\n right: auto;\n left: var(--archify-radar-left, 0.5rem);\n }\n .overview-map-surface { height: 4rem; }\n .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }\n .semantic-lens {\n right: 0.5rem;\n bottom: 3.7rem;\n width: calc(100% - 1rem);\n max-height: calc(100% - 4.2rem);\n }\n .semantic-lens[data-dock-side] { left: auto; right: 0.5rem; }\n .semantic-lens-kinds { max-height: min(12rem, 34vh); }\n .focus-chip {\n left: 0.5rem;\n top: 0.5rem;\n width: calc(100% - 1rem);\n max-width: none;\n }\n .relationship-lens-list { max-height: min(12rem, 38vh); }\n .relationship-lens-actions #btn-focus-relations { display: block; color: var(--database-stroke); }\n .focus-chip:not([data-relations-expanded=\"true\"]) .relationship-lens-head { border-bottom-color: transparent; }\n .focus-chip:not([data-relations-expanded=\"true\"]) .relationship-lens-list { display: none; }\n /* While a mobile reader previews one relationship, turn the full Lens\n into a compact peek card. This keeps the exact source and target on\n canvas instead of covering them with a long, scrollable list. */\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-list {\n max-height: none;\n padding: 0.35rem;\n overflow: hidden;\n }\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-group { margin: 0; }\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-group-title,\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-row:not([data-preview-active=\"true\"]) {\n display: none;\n }\n .node-finder {\n top: 0.5rem;\n left: 0.5rem;\n width: min(22rem, calc(100% - 1rem));\n max-height: calc(100% - 1rem);\n }\n .diagram-guide {\n top: 0.5rem;\n right: 0.5rem;\n left: 0.5rem;\n width: auto;\n max-height: calc(100% - 1rem);\n }\n .diagram-guide-head { padding: 0.62rem 0.7rem 0.52rem; }\n .diagram-guide-stats { padding: 0.42rem 0.7rem; }\n .diagram-guide-actions {\n grid-template-columns: 1fr;\n gap: 0.28rem;\n padding: 0.42rem;\n }\n .diagram-guide-action {\n min-height: 3.1rem;\n padding: 0.42rem 0.48rem;\n }\n .diagram-guide-action small {\n display: block;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .diagram-guide-index {\n width: 1.5rem;\n height: 1.5rem;\n }\n .diagram-guide-shortcuts { padding: 0.46rem 0.7rem 0.52rem; }\n .diagram-guide-action[data-guide-action=\"present\"] { grid-column: auto; }\n .route-probe[data-guide-open=\"true\"] {\n visibility: hidden;\n pointer-events: none;\n }\n .node-finder-results { max-height: min(16rem, 38vh); }\n .route-probe {\n left: 0.5rem;\n bottom: 3.7rem;\n width: calc(100% - 1rem);\n min-width: 0;\n }\n .route-probe[data-route-dock=\"top\"] {\n top: 0.5rem;\n bottom: auto;\n }\n .route-probe[data-finder-open=\"true\"] {\n visibility: hidden;\n pointer-events: none;\n }\n .route-probe-head { padding: 0.45rem 0.48rem 0.38rem; }\n .route-probe-path { padding: 0.35rem 0.48rem 0.2rem; }\n .route-probe-node { min-height: 2.75rem !important; }\n .route-journey-controls {\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem minmax(0, 1fr);\n padding: 0.08rem 0.48rem 0.32rem;\n }\n .route-journey-controls button { min-height: 2.75rem; }\n .route-probe-status { padding: 0.05rem 0.48rem 0.38rem; }\n .route-probe-node { max-width: 7.5rem; }\n .guided-views {\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem;\n gap: 0.2rem;\n padding: 0.25rem;\n }\n .guided-view-actions {\n grid-column: 1 / -1;\n display: grid;\n grid-template-columns: repeat(3, minmax(0, 1fr));\n }\n .guided-views \u003e #guided-view-prev,\n .guided-views \u003e #guided-view-next {\n align-self: center;\n height: 2.75rem;\n }\n .guided-view-play,\n .guided-view-all,\n .guided-view-beat-link { min-height: 2.75rem; }\n .guided-view-copy small { white-space: normal; }\n .guided-story-caption { padding: 0.32rem 0.45rem; }\n .guided-story-caption-index { min-width: 2.9rem; padding-right: 0.42rem; }\n .guided-story-caption strong,\n .guided-story-caption small { white-space: normal; }\n .guided-story-caption-next { display: none; }\n .guided-view-trail { min-height: 2rem; }\n .guided-view-trail .guided-view-stop {\n min-height: 2rem;\n padding: 0.22rem 0.42rem 0.22rem 0.28rem;\n }\n .guided-view-handoff { max-width: min(9rem, 32vw); }\n .guided-view-index { padding-top: 0.35rem; }\n .guided-view-chapters {\n gap: 0.35rem;\n scroll-padding-inline: 0.2rem;\n }\n .guided-view-chapters li {\n flex: 0 0 min(14rem, 78vw);\n min-width: 0;\n }\n .guided-view-chapter { min-height: 2.75rem; }\n .guided-views[data-active-view=\"all\"] {\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.2rem;\n padding: 0.25rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-copy {\n grid-column: 1;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-actions {\n grid-column: 2;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-play {\n min-width: 6rem !important;\n min-height: 2.75rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-index {\n grid-column: 1 / -1;\n grid-row: 2;\n padding: 0.3rem 0.08rem 0;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n border-left: 0;\n }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .share-chapter-cue:not([hidden]),\n html[data-embed=\"true\"][data-share-moment=\"true\"] .share-chapter-cue:not([hidden]) {\n top: 0.5rem;\n grid-template-columns: auto minmax(0, 1fr);\n gap: 0.28rem 0.55rem;\n width: calc(100% - 1rem);\n min-height: 0;\n padding: 0.45rem 0.55rem 0.55rem;\n }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .diagram-container {\n padding-top: 4.25rem;\n }\n html[data-embed=\"true\"][data-share-moment=\"true\"] .diagram-container {\n padding-top: 4.25rem;\n }\n .share-chapter-index {\n min-width: 4.4rem;\n padding-right: 0.5rem;\n }\n .share-chapter-copy small { font-size: 0.46rem; }\n .share-chapter-route {\n grid-column: 1 / -1;\n font-size: 0.5rem;\n text-align: left;\n }\n .cards {\n grid-template-columns: 1fr;\n margin-top: 1rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) body { padding: 0.5rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .container {\n gap: 0.5rem;\n height: calc(100dvh - 1rem);\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .toolbar {\n position: fixed;\n top: 0.5rem;\n right: 0.5rem;\n margin: 0;\n gap: 0.25rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .toolbar button {\n min-height: 2.75rem;\n padding: 0.42rem 0.58rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header {\n min-height: 2.25rem;\n padding: 3.5rem 0 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row {\n min-height: 2.25rem;\n margin: 0;\n align-items: center;\n flex-wrap: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row::after,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .pulse-dot,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .subtitle { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) h1 {\n flex: 1 1 auto;\n min-width: 0;\n max-width: 100%;\n overflow: hidden;\n font-size: 0.875rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views {\n padding: 0.2rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-view-copy small { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-story-caption small { display: block; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container { padding: 0.5rem 0.5rem 3.75rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] \u003e svg {\n width: 720px;\n height: auto;\n min-width: 720px;\n }\n }\n\n @media (max-width: 420px) {\n .export-menu-section { grid-template-columns: 1fr; }\n .export-menu-heading,\n .toolbar .export-menu button[data-format=\"share-card\"],\n .toolbar .export-menu button[data-action=\"route-share-card\"],\n .toolbar .export-menu button[data-action=\"reach-share-card\"] { grid-column: 1; }\n }\n\n @media (prefers-reduced-motion: reduce) {\n .guided-story-caption { animation: none !important; }\n .toolbar .preset-menu.open,\n .toolbar .export-menu.open { animation: none; }\n .toolbar-chevron { transition: none; }\n }\n\n @media (max-width: 360px) {\n .toolbar { gap: 0.25rem; }\n .toolbar button { padding-right: 0.58rem; padding-left: 0.58rem; }\n .toolbar #btn-motion { min-width: 4.4rem; padding-right: 0.58rem; padding-left: 0.58rem; }\n #theme-label, #preset-label, #present-label { display: none; }\n .guided-view-handoff { max-width: 6.5rem; }\n }\n\n /* ==========================================================\n SVG SEMANTIC CLASSES — use these instead of inline fill/stroke\n ========================================================== */\n .c-grid { stroke: var(--grid); fill: none; }\n .c-mask { fill: var(--mask); stroke: none; }\n\n .c-frontend { fill: var(--frontend-fill); stroke: var(--frontend-stroke); }\n .c-backend { fill: var(--backend-fill); stroke: var(--backend-stroke); }\n .c-database { fill: var(--database-fill); stroke: var(--database-stroke); }\n .c-cloud { fill: var(--cloud-fill); stroke: var(--cloud-stroke); }\n .c-security { fill: var(--security-fill); stroke: var(--security-stroke); }\n .c-messagebus { fill: var(--messagebus-fill); stroke: var(--messagebus-stroke); }\n .c-external { fill: var(--external-fill); stroke: var(--external-stroke); }\n\n /* Text helpers */\n .t-primary { fill: var(--text); }\n .t-muted { fill: var(--text-muted); }\n .t-dim { fill: var(--text-dim); }\n .t-frontend { fill: var(--frontend-stroke); }\n .t-backend { fill: var(--backend-stroke); }\n .t-database { fill: var(--database-stroke); }\n .t-cloud { fill: var(--cloud-stroke); }\n .t-security { fill: var(--security-stroke); }\n .t-messagebus { fill: var(--messagebus-stroke); }\n .t-external { fill: var(--external-stroke); }\n\n /* Semantic Sigils are small authored role stamps, not icons from a brand\n pack and not viewer controls. Prefix selectors with svg so the canonical\n export's SVG-only stylesheet collector keeps them automatically. */\n svg .semantic-sigil {\n fill: none;\n stroke: currentColor;\n stroke-width: 1.35;\n stroke-linecap: round;\n stroke-linejoin: round;\n opacity: 0.76;\n pointer-events: none;\n }\n svg .semantic-sigil \u003e * { vector-effect: non-scaling-stroke; }\n svg .semantic-sigil .sigil-fill { fill: currentColor; stroke: none; }\n svg .s-frontend { color: var(--frontend-stroke); }\n svg .s-backend { color: var(--backend-stroke); }\n svg .s-database { color: var(--database-stroke); }\n svg .s-cloud { color: var(--cloud-stroke); }\n svg .s-security { color: var(--security-stroke); }\n svg .s-messagebus { color: var(--messagebus-stroke); }\n svg .s-external { color: var(--external-stroke); }\n\n /* Brand Marks are authored identity badges. Their color is contained\n inside one neutral plate so vendor color never replaces Archify's\n semantic node and relationship vocabulary. */\n svg .brand-mark { pointer-events: none; }\n svg .brand-mark-badge { fill: #fff; stroke: none; }\n svg .brand-mark-frame {\n fill: none;\n stroke: #cbd5e1;\n stroke-width: 0.8;\n vector-effect: non-scaling-stroke;\n }\n svg .brand-mark-fallback {\n fill: none;\n stroke: #475569;\n stroke-width: 1.15;\n stroke-linecap: round;\n stroke-linejoin: round;\n }\n svg[data-preset=\"blueprint\"] .brand-mark-badge,\n svg[data-preset=\"blueprint\"] .brand-mark-frame { rx: 1px; }\n\n /* Reading Depth is a viewer-only level-of-detail layer. MAP preserves the\n authored structure and primary labels, READ restores relationship labels\n and node context, and FULL restores tags and fine annotations. Semantic\n intent can reveal the relevant detail without moving any geometry. */\n svg [data-detail] { transition: opacity 160ms ease; }\n svg [data-detail-anchor] {\n transform-box: fill-box;\n transform-origin: center;\n transition: transform 160ms ease;\n }\n .diagram-container[data-detail-level=\"map\"] svg [data-detail=\"context\"],\n .diagram-container[data-detail-level=\"map\"] svg [data-detail=\"fine\"],\n .diagram-container[data-detail-level=\"read\"] svg [data-detail=\"fine\"] {\n opacity: 0;\n pointer-events: none;\n }\n .diagram-container[data-detail-level=\"map\"] svg [data-detail-anchor] {\n transform: translateY(8px);\n }\n\n /* Focus, lens, preview, route, and story states are stronger reader intent than\n the global zoom level. Reveal only their exact semantic matches. */\n svg[data-focus-active] [data-focus-match][data-detail],\n svg[data-focus-active] [data-focus-match] [data-detail],\n svg[data-reach-active] [data-reach-match][data-detail],\n svg[data-reach-active] [data-reach-match] [data-detail],\n svg[data-lens-active] [data-lens-match][data-detail],\n svg[data-lens-active] [data-lens-match] [data-detail],\n svg[data-legend-preview-active] [data-legend-preview-match][data-detail],\n svg[data-legend-preview-active] [data-legend-preview-match] [data-detail],\n svg[data-intent-trace-active] [data-intent-trace-match][data-detail],\n svg[data-intent-trace-active] [data-intent-trace-match] [data-detail],\n svg[data-route-active] [data-route-match][data-detail],\n svg[data-route-active] [data-route-match] [data-detail],\n svg[data-story-active] [data-story-step][data-detail],\n svg[data-story-active] [data-story-step] [data-detail],\n svg[data-relationship-preview-active] [data-relationship-preview][data-detail],\n svg[data-relationship-preview-active] [data-relationship-preview] [data-detail],\n svg [data-node-id]:hover [data-detail],\n svg [data-node-id]:focus-visible [data-detail] {\n opacity: 1;\n pointer-events: auto;\n }\n svg[data-focus-active] [data-focus-match] [data-detail-anchor],\n svg[data-reach-active] [data-reach-match] [data-detail-anchor],\n svg[data-lens-active] [data-lens-match] [data-detail-anchor],\n svg[data-legend-preview-active] [data-legend-preview-match] [data-detail-anchor],\n svg[data-intent-trace-active] [data-intent-trace-match] [data-detail-anchor],\n svg[data-route-active] [data-route-match] [data-detail-anchor],\n svg[data-story-active] [data-story-step] [data-detail-anchor],\n svg [data-node-id]:hover [data-detail-anchor],\n svg [data-node-id]:focus-visible [data-detail-anchor] { transform: none; }\n\n /* Arrows */\n .a-default { stroke: var(--arrow); fill: none; }\n .a-emphasis { stroke: var(--arrow-emphasis); fill: none; }\n .a-security { stroke: var(--security-stroke); fill: none; stroke-dasharray: 5,5; }\n .a-dashed { stroke: var(--database-stroke); fill: none; stroke-dasharray: 4,4; }\n\n /* Arrowhead markers reference these */\n .m-default { fill: var(--arrow); }\n .m-emphasis { fill: var(--arrow-emphasis); }\n .m-security { fill: var(--security-stroke); }\n .m-dashed { fill: var(--database-stroke); }\n\n /* Stable semantic exploration hooks emitted by every renderer. */\n svg [data-node-id] {\n cursor: pointer;\n transition: opacity 0.18s ease, filter 0.18s ease;\n }\n svg [data-edge-from] { transition: opacity 0.18s ease, filter 0.18s ease; }\n svg [data-node-id]:hover,\n svg [data-node-id]:focus-visible {\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n outline: none;\n }\n /* Verified Source Beacons are installed at runtime only for nodes whose\n repository evidence passed the local revision/blob/line checks. They\n live inside the owning node so every focus, route, story, and guided\n view keeps one coherent opacity state. Export serialization removes\n them before producing the canonical SVG or any derived visual. */\n .source-evidence-beacon {\n pointer-events: none;\n opacity: 0.76;\n transition: opacity 160ms ease, filter 160ms ease;\n }\n .source-evidence-beacon rect {\n fill: color-mix(in srgb, var(--mask) 92%, var(--backend-stroke));\n stroke: color-mix(in srgb, var(--backend-stroke) 82%, var(--panel-border));\n stroke-width: 1;\n vector-effect: non-scaling-stroke;\n }\n .source-evidence-beacon text {\n fill: var(--backend-stroke);\n font-size: 5.5px;\n font-weight: 800;\n letter-spacing: 0.06em;\n text-anchor: middle;\n text-transform: uppercase;\n }\n svg [data-node-id]:hover .source-evidence-beacon,\n svg [data-node-id]:focus-visible .source-evidence-beacon,\n svg [data-node-id][data-focus-selected] .source-evidence-beacon {\n opacity: 1;\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--backend-stroke) 72%, transparent));\n }\n svg[data-preset=\"signal-flow\"] .source-evidence-beacon { opacity: 0.9; }\n svg[data-preset=\"blueprint\"] .source-evidence-beacon rect {\n rx: 0.8px;\n filter: none;\n }\n svg [data-legend-kind][role=\"button\"] { cursor: pointer; }\n svg [data-legend-kind]:focus { outline: none; }\n svg [data-legend-hit] {\n fill: transparent;\n stroke: transparent;\n stroke-width: 1.4;\n pointer-events: all;\n vector-effect: non-scaling-stroke;\n transition: stroke 150ms ease, stroke-width 150ms ease, filter 150ms ease;\n }\n svg [data-legend-count-badge] { pointer-events: none; }\n svg [data-legend-count-badge] rect {\n fill: var(--mask);\n stroke: var(--panel-border);\n stroke-width: 1;\n vector-effect: non-scaling-stroke;\n }\n svg [data-legend-count-badge] text {\n fill: var(--text-muted);\n font-size: 8px;\n font-weight: 700;\n text-anchor: middle;\n }\n svg [data-legend-kind][role=\"button\"]:hover [data-legend-hit] {\n stroke: color-mix(in srgb, var(--database-stroke) 58%, transparent);\n }\n svg [data-legend-kind][role=\"button\"]:focus-visible [data-legend-hit] {\n stroke: var(--frontend-stroke);\n stroke-width: 1.8;\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg [data-legend-kind][data-legend-selected] [data-legend-hit] {\n stroke: var(--database-stroke);\n stroke-width: 2.2;\n stroke-dasharray: 3 2;\n }\n svg [data-legend-kind][data-legend-selected] [data-legend-count-badge] rect {\n stroke: var(--database-stroke);\n stroke-width: 1.8;\n }\n svg [data-legend-kind][data-legend-zero] { opacity: 0.44; }\n svg[data-preset=\"signal-flow\"] [data-legend-kind][data-legend-selected] [data-legend-hit] {\n filter: drop-shadow(0 0 4px var(--database-stroke));\n }\n svg[data-preset=\"blueprint\"] [data-legend-hit],\n svg[data-preset=\"blueprint\"] [data-legend-count-badge] rect { rx: 0; filter: none; }\n svg[data-legend-preview-active] [data-node-id],\n svg[data-legend-preview-active] [data-edge-from] { opacity: 0.11; }\n svg[data-legend-preview-active] [data-legend-preview-match] { opacity: 1; }\n svg[data-legend-preview-active] [data-legend-preview-peer] { opacity: 0.62; }\n svg[data-legend-preview-active] [data-legend-preview-selected] {\n filter: drop-shadow(0 0 8px var(--database-stroke));\n }\n svg[data-lens-active] [data-node-id],\n svg[data-lens-active] [data-edge-from] { opacity: 0.11; }\n svg[data-lens-active] [data-lens-match] { opacity: 1; }\n svg[data-lens-active] [data-lens-peer] { opacity: 0.62; }\n svg[data-lens-active] [data-lens-selected] {\n filter: drop-shadow(0 0 10px var(--database-stroke));\n }\n .semantic-lens-overlay { pointer-events: none; }\n .semantic-lens-flow {\n fill: none;\n stroke-width: 3.05;\n stroke-linecap: round;\n stroke-dasharray: 0.075 0.925;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.9;\n animation: archify-semantic-lens-flow 1.35s linear 1 both;\n animation-delay: var(--lens-flow-delay, 0s);\n }\n .semantic-lens-flow[data-direction=\"out\"],\n .semantic-lens-flow[data-direction=\"forward\"] {\n stroke: var(--frontend-stroke);\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n .semantic-lens-flow[data-direction=\"in\"],\n .semantic-lens-flow[data-direction=\"reverse\"] {\n stroke: var(--database-stroke);\n filter: drop-shadow(0 0 3px var(--database-stroke));\n }\n .semantic-lens-flow[data-direction=\"within\"] {\n stroke: var(--messagebus-stroke);\n filter: drop-shadow(0 0 3px var(--messagebus-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow {\n stroke-width: 3.7;\n opacity: 1;\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"out\"],\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"forward\"] {\n filter: drop-shadow(0 0 6px var(--frontend-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"in\"],\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"reverse\"] {\n filter: drop-shadow(0 0 6px var(--database-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"within\"] {\n filter: drop-shadow(0 0 6px var(--messagebus-stroke));\n }\n svg[data-preset=\"blueprint\"] .semantic-lens-flow {\n stroke-width: 2.45;\n stroke-linecap: square;\n filter: none;\n opacity: 0.78;\n }\n html[data-embed=\"true\"] .semantic-lens-overlay { display: none; }\n svg[data-focus-active] [data-node-id],\n svg[data-focus-active] [data-edge-from] { opacity: 0.13; }\n svg[data-focus-active] [data-focus-match] { opacity: 1; }\n svg[data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n\n /* Authored Reachability is a bounded graph query over the relationships\n already present in the artifact. Upstream walks incoming edges;\n downstream walks outgoing edges. It never claims runtime causality and\n changes only viewer emphasis, not canonical geometry or export bytes. */\n svg[data-reach-active] [data-node-id],\n svg[data-reach-active] [data-edge-from] { opacity: 0.09; }\n svg[data-reach-active] [data-reach-match] { opacity: 1; }\n svg[data-reach-active=\"upstream\"] [data-reach-origin] {\n filter: drop-shadow(0 0 11px var(--database-stroke));\n }\n svg[data-reach-active=\"downstream\"] [data-reach-origin] {\n filter: drop-shadow(0 0 11px var(--backend-stroke));\n }\n svg[data-reach-active=\"upstream\"] [data-edge-from][data-reach-match] {\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--database-stroke) 72%, transparent));\n }\n svg[data-reach-active=\"downstream\"] [data-edge-from][data-reach-match] {\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--backend-stroke) 72%, transparent));\n }\n svg[data-preset=\"blueprint\"][data-reach-active] [data-reach-origin],\n svg[data-preset=\"blueprint\"][data-reach-active] [data-edge-from][data-reach-match] {\n filter: none;\n }\n\n /* Direct Relationship Explorer makes authored paths a real input surface\n without changing their visible stroke or canonical SVG. A transparent\n runtime rail supplies forgiving pointer geometry; the exact authored\n path and endpoints continue to carry every visible state. */\n .relationship-hit-overlay { pointer-events: none; }\n .relationship-hit-target { outline: none; }\n .relationship-hit-rail {\n fill: none;\n stroke: transparent;\n stroke-width: 24;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n pointer-events: stroke;\n cursor: pointer;\n }\n .relationship-focus-rail {\n fill: none;\n stroke: color-mix(in srgb, var(--frontend-stroke) 34%, transparent);\n stroke-width: 6;\n stroke-dasharray: 2 4;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n pointer-events: none;\n opacity: 0;\n }\n .relationship-hit-target:focus-visible .relationship-focus-rail {\n opacity: 1;\n }\n svg[data-preset=\"blueprint\"] .relationship-hit-target:focus-visible .relationship-focus-rail {\n stroke-linecap: square;\n filter: none;\n }\n svg[data-relationship-direct-active] [data-node-id],\n svg[data-relationship-direct-active] [data-edge-from] { opacity: 0.16; }\n svg[data-relationship-direct-active] [data-relationship-preview],\n svg[data-relationship-direct-active] [data-relationship-preview-node] { opacity: 1; }\n svg[data-focus-active]:not([data-relationship-pin-active]) .relationship-hit-rail,\n svg[data-story-active] .relationship-hit-rail,\n svg[data-route-picking] .relationship-hit-rail,\n svg[data-route-active] .relationship-hit-rail,\n svg[data-lens-active] .relationship-hit-rail,\n svg[data-chapter-preview] .relationship-hit-rail { pointer-events: none; }\n html[data-embed=\"true\"] .relationship-hit-overlay { display: none; }\n @media (hover: none), (pointer: coarse) {\n .relationship-hit-rail { stroke-width: 24; }\n }\n\n /* Relationship Preview is temporary exploration state layered on top of\n neighborhood focus. It changes emphasis only; exported geometry and the\n relationship's original solid/dashed visual language stay untouched. */\n svg[data-relationship-preview-active] [data-focus-match] { opacity: 0.18; }\n svg[data-relationship-preview-active] [data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview-node] { opacity: 1; }\n svg[data-relationship-preview-active] [data-relationship-preview] {\n filter: drop-shadow(0 0 5px var(--arrow-emphasis));\n }\n svg[data-relationship-preview-active] [data-relationship-preview] path,\n svg[data-relationship-preview-active] path[data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview] line,\n svg[data-relationship-preview-active] line[data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview] polyline,\n svg[data-relationship-preview-active] polyline[data-relationship-preview] {\n stroke-width: 2.75;\n }\n svg[data-relationship-preview-active] [data-relationship-preview-source] {\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n }\n svg[data-relationship-preview-active] [data-relationship-preview-target] {\n filter: drop-shadow(0 0 7px var(--database-stroke));\n }\n .relationship-pulse-overlay { pointer-events: none; }\n .relationship-flow-pulse {\n fill: none;\n stroke: var(--arrow-emphasis);\n stroke-width: 3.35;\n stroke-linecap: round;\n stroke-dasharray: 0.085 0.915;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0;\n filter: drop-shadow(0 0 4px var(--arrow-emphasis));\n animation: archify-relationship-pulse 1.2s linear 1 both;\n }\n svg[data-preset=\"signal-flow\"] .relationship-flow-pulse {\n stroke: var(--frontend-stroke);\n stroke-width: 3.85;\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"] .relationship-flow-pulse {\n stroke-width: 2.5;\n stroke-linecap: square;\n filter: none;\n }\n svg[data-preset=\"editorial\"] .relationship-flow-pulse {\n stroke: var(--arrow-emphasis);\n stroke-width: 2.75;\n filter: none;\n }\n .semantic-flow-token {\n color: var(--frontend-stroke);\n opacity: 0;\n pointer-events: none;\n }\n .relationship-flow-token {\n animation: archify-relationship-token-life 1.2s linear 1 both;\n }\n .story-flow-token {\n animation: archify-relationship-token-life 0.78s linear 1 both;\n }\n .semantic-flow-token-halo {\n fill: var(--mask);\n stroke: currentColor;\n stroke-width: 1.1;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n }\n .relationship-flow-token-shape {\n fill: var(--mask);\n stroke: currentColor;\n stroke-width: 1.35;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n }\n .relationship-flow-token-ink {\n fill: none;\n stroke: currentColor;\n stroke-width: 1.05;\n stroke-linecap: round;\n vector-effect: non-scaling-stroke;\n }\n .relationship-flow-token-dot { fill: currentColor; stroke: none; }\n .semantic-flow-token[data-token-kind=\"data\"] { color: var(--database-stroke); }\n .semantic-flow-token[data-token-kind=\"event\"] { color: var(--messagebus-stroke); }\n .semantic-flow-token[data-token-kind=\"security\"] { color: var(--security-stroke); }\n .semantic-flow-token[data-token-kind=\"state\"] { color: var(--cloud-stroke); }\n svg[data-preset=\"signal-flow\"] .semantic-flow-token {\n filter: drop-shadow(0 0 5px currentColor);\n }\n svg[data-preset=\"blueprint\"] .semantic-flow-token { filter: none; }\n svg[data-preset=\"editorial\"] .semantic-flow-token { filter: none; }\n html[data-embed=\"true\"] .relationship-pulse-overlay { display: none; }\n\n /* Intent Trace is a temporary, pre-click exploration layer. Related\n topology stays readable while a short viewer-only signal runs over\n cloned edge geometry; the authored edge remains untouched underneath. */\n svg[data-intent-trace-active] [data-node-id],\n svg[data-intent-trace-active] [data-edge-from] { opacity: 0.2; }\n svg[data-intent-trace-active] [data-intent-trace-match] { opacity: 1; }\n svg[data-intent-trace-active] [data-intent-trace-selected] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n .intent-trace-overlay { pointer-events: none; }\n .intent-trace-flow {\n fill: none;\n stroke-width: 3.1;\n stroke-linecap: round;\n stroke-dasharray: 0.1 0.9;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.94;\n animation: archify-intent-trace-flow 1.15s linear 1 both;\n }\n /* Direction names describe each edge relative to the focused node only.\n The cloned geometry already runs from the authored source to target, so\n incoming and outgoing signals must share the same playback direction. */\n .intent-trace-flow[data-direction=\"out\"] {\n stroke: var(--frontend-stroke);\n filter: drop-shadow(0 0 4px var(--frontend-stroke));\n }\n .intent-trace-flow[data-direction=\"in\"] {\n stroke: var(--database-stroke);\n filter: drop-shadow(0 0 4px var(--database-stroke));\n animation-direction: normal;\n }\n .intent-trace-flow[data-direction=\"loop\"] {\n stroke: var(--security-stroke);\n filter: drop-shadow(0 0 4px var(--security-stroke));\n }\n svg[data-preset=\"blueprint\"] [data-intent-trace-selected],\n svg[data-preset=\"blueprint\"] .intent-trace-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"editorial\"] [data-intent-trace-selected],\n svg[data-preset=\"editorial\"] .intent-trace-flow { filter: none; }\n .intent-trace-status {\n position: absolute;\n width: 1px;\n height: 1px;\n padding: 0;\n margin: -1px;\n overflow: hidden;\n clip: rect(0, 0, 0, 0);\n clip-path: inset(50%);\n white-space: nowrap;\n border: 0;\n }\n\n /* Route Probe separates a durable two-point query from selection and\n one-hop hover. Only the chosen shortest directed path stays prominent;\n the traveling signal is cloned viewer geometry and never authored SVG. */\n svg[data-route-picking=\"target\"] [data-node-id] { opacity: 0.24; }\n svg[data-route-picking=\"target\"] [data-route-candidate],\n svg[data-route-picking=\"target\"] [data-route-start] { opacity: 1; }\n svg[data-route-picking] [data-node-id] { cursor: crosshair; }\n svg[data-route-picking] [data-route-start] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n svg[data-route-active] [data-node-id],\n svg[data-route-active] [data-edge-from] { opacity: 0.11; }\n svg[data-route-active] [data-route-match] { opacity: 1; }\n svg[data-route-active] [data-route-start] {\n filter: drop-shadow(0 0 11px var(--frontend-stroke));\n }\n svg[data-route-active] [data-route-end] {\n filter: drop-shadow(0 0 11px var(--security-stroke));\n }\n svg[data-route-active] [data-route-step]:not([data-route-start]):not([data-route-end]) {\n filter: drop-shadow(0 0 7px var(--backend-stroke));\n }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"past\"] { opacity: 0.62; }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"future\"] { opacity: 0.34; }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"current\"] { opacity: 1; }\n svg[data-route-journey] [data-node-id][data-route-journey-current] {\n filter: drop-shadow(0 0 10px var(--backend-stroke));\n }\n svg[data-route-journey] [data-edge-from][data-route-journey-current] {\n opacity: 1;\n filter: drop-shadow(0 0 6px var(--backend-stroke));\n }\n .route-probe-overlay { pointer-events: none; }\n .route-journey-overlay { pointer-events: none; }\n .route-probe-flow {\n fill: none;\n stroke: var(--backend-stroke);\n stroke-width: 3.25;\n stroke-linecap: round;\n stroke-dasharray: 0.085 0.915;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n filter: drop-shadow(0 0 5px var(--backend-stroke));\n animation: archify-route-probe-flow 1.1s cubic-bezier(0.22, 1, 0.36, 1) 1 both;\n animation-delay: calc(var(--route-step, 0) * 0.16s);\n }\n .route-journey-flow {\n fill: none;\n stroke: var(--backend-stroke);\n stroke-width: 3.5;\n stroke-linecap: round;\n stroke-dasharray: 0.1 0.9;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0;\n filter: drop-shadow(0 0 6px var(--backend-stroke));\n animation: archify-route-journey-flow 780ms cubic-bezier(0.22, 1, 0.36, 1) 1 both;\n }\n svg[data-preset=\"blueprint\"] [data-route-start],\n svg[data-preset=\"blueprint\"] [data-route-end],\n svg[data-preset=\"blueprint\"] [data-route-step],\n svg[data-preset=\"blueprint\"] .route-probe-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"blueprint\"] .route-journey-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"editorial\"] [data-route-start],\n svg[data-preset=\"editorial\"] [data-route-end],\n svg[data-preset=\"editorial\"] [data-route-step],\n svg[data-preset=\"editorial\"] .route-probe-flow,\n svg[data-preset=\"editorial\"] .route-journey-flow { filter: none; }\n\n svg[data-preset=\"editorial\"] .c-grid {\n stroke-dasharray: 1 4;\n opacity: 0.48;\n }\n svg[data-preset=\"editorial\"] .c-region {\n fill: color-mix(in srgb, var(--cloud-fill) 48%, transparent);\n stroke-dasharray: 9 4;\n }\n svg[data-preset=\"editorial\"] [data-node-id]:hover,\n svg[data-preset=\"editorial\"] [data-node-id]:focus-visible,\n svg[data-preset=\"editorial\"][data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 18%, transparent));\n }\n\n svg[data-preset=\"blueprint\"] .c-grid {\n stroke-dasharray: 1 3;\n opacity: 0.78;\n }\n svg[data-preset=\"blueprint\"] .c-region {\n fill: color-mix(in srgb, var(--cloud-fill) 58%, transparent);\n stroke-dasharray: 12 4 2 4;\n }\n svg[data-preset=\"blueprint\"] .c-security-group,\n svg[data-preset=\"blueprint\"] .c-lane { stroke-dasharray: 7 3; }\n svg[data-preset=\"blueprint\"] [data-node-id]:hover,\n svg[data-preset=\"blueprint\"] [data-node-id]:focus-visible {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"][data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"][data-focus-active][data-reach-active] [data-focus-selected][data-reach-origin] {\n filter: none;\n }\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview],\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview-source],\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview-target] {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n\n /* Story Trail is a viewer-only overlay derived from the ordered focus IDs\n of the active guided view. The authored edge stays underneath with its\n original color, dash pattern, marker, and geometry intact. */\n .story-trail-overlay { pointer-events: none; }\n .story-carrier-overlay { pointer-events: none; }\n .story-trail-flow {\n fill: none;\n stroke: var(--frontend-stroke);\n stroke-width: 2.8;\n stroke-linecap: round;\n vector-effect: non-scaling-stroke;\n opacity: 0.34;\n filter: drop-shadow(0 0 2px var(--frontend-stroke));\n }\n svg[data-story-beat] [data-story-step] {\n opacity: 0.22;\n filter: saturate(0.42);\n transition: opacity 180ms ease, filter 180ms ease;\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"past\"] {\n opacity: 0.72;\n filter: saturate(0.82);\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"next\"] {\n opacity: 0.5;\n filter: saturate(0.66);\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n opacity: 1;\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n animation: archify-story-beat-node 360ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n svg[data-story-beat] [data-edge-from][data-story-beat-step] {\n opacity: 0.16;\n transition: opacity 160ms ease;\n }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"past\"] { opacity: 0.58; }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"next\"] { opacity: 0.34; }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"active\"] { opacity: 1; }\n svg[data-story-beat] .story-trail-flow { opacity: 0; transition: opacity 160ms ease; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"past\"] { opacity: 0.34; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"next\"] { opacity: 0.2; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"active\"] { opacity: 0.92; }\n svg[data-story-beat] .story-trail-flow[data-story-pulse=\"true\"] {\n stroke-dasharray: 2 13;\n stroke-dashoffset: 30;\n opacity: 0.92;\n animation: archify-story-flow 0.78s linear 1 both;\n }\n svg[data-preset=\"blueprint\"] .story-trail-flow {\n stroke-linecap: square;\n filter: none;\n opacity: 0.5;\n }\n svg[data-preset=\"blueprint\"][data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n filter: none;\n animation: none;\n }\n svg[data-preset=\"editorial\"] .story-trail-flow { filter: none; }\n svg[data-preset=\"editorial\"][data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 16%, transparent));\n }\n\n /* Chapter Delta Preview is a static, pre-commit comparison between two\n chapter focus sets. Symbols in the rail carry the meaning without color;\n these SVG rules only make exact stable-ID membership easier to scan. */\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] {\n opacity: 0.1 !important;\n filter: none !important;\n transition: none !important;\n }\n svg[data-chapter-preview] .story-trail-overlay { opacity: 0.08 !important; }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"stay\"] {\n opacity: 0.76 !important;\n filter: saturate(0.7) !important;\n }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"enter\"] {\n opacity: 1 !important;\n filter: saturate(1.2) !important;\n }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"leave\"] {\n opacity: 0.28 !important;\n filter: grayscale(0.72) !important;\n }\n svg[data-preset=\"blueprint\"][data-chapter-preview] [data-node-id] { filter: none !important; }\n\n /* Dashed boundary variants */\n .c-security-group { fill: transparent; stroke: var(--security-stroke); stroke-dasharray: 4,4; }\n .c-region { fill: rgba(251, 191, 36, 0.05); stroke: var(--cloud-stroke); stroke-dasharray: 8,4; }\n .c-lane { fill: var(--lane-fill); stroke: var(--lane-stroke); stroke-dasharray: 6,6; }\n\n /* Optional trace animation, enabled only by meta.animation = \"trace\".\n The ordinary viewer performs one ambient pass and then restores the\n authored solid/security/async line language. WebM samples the same\n authored geometry into an explicit canvas timeline. */\n html[data-ambient-motion=\"running\"] svg[data-animation=\"trace\"] [data-animate=\"edge\"] {\n animation: archify-edge-flow 2.4s linear 1;\n animation-delay: calc(var(--step, 0) * 160ms);\n }\n html[data-ambient-motion=\"running\"] svg[data-animation=\"trace\"] [data-animate=\"node\"] {\n transform-box: fill-box;\n transform-origin: center;\n animation: archify-node-pulse 3.6s ease-in-out 1;\n animation-delay: calc(var(--step, 0) * 160ms);\n }\n svg[data-preset=\"signal-flow\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n stroke-linecap: round;\n filter: drop-shadow(0 0 3px var(--arrow-emphasis));\n animation-duration: 1.75s;\n }\n svg[data-preset=\"signal-flow\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-duration: 3.1s;\n }\n svg[data-preset=\"blueprint\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n stroke-linecap: square;\n filter: none;\n animation-duration: 2.15s;\n }\n svg[data-preset=\"blueprint\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-name: archify-blueprint-node-pulse;\n animation-duration: 3.8s;\n }\n svg[data-preset=\"editorial\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n filter: none;\n animation-duration: 2.2s;\n }\n svg[data-preset=\"editorial\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-name: archify-editorial-node-pulse;\n animation-duration: 3.5s;\n }\n /* Embedded proofs are static until a named Story Trail chapter is played.\n This keeps proof grids calm and ensures ?play=1 stops all viewer motion\n after one 3.2 second chapter instead of leaving ambient trace loops on. */\n html[data-embed=\"true\"] svg[data-animation=\"trace\"] [data-animate],\n html[data-share-playback=\"true\"] svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n stroke-dashoffset: 0;\n }\n @keyframes archify-edge-flow {\n 0% { stroke-dasharray: 10 8; stroke-dashoffset: 54; opacity: 0.42; }\n 88% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }\n 99.9% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }\n 100% { stroke-dashoffset: 0; opacity: 1; }\n }\n @keyframes archify-node-pulse {\n 0%, 72%, 100% { filter: none; stroke-width: 1.5; }\n 18%, 36% {\n filter: drop-shadow(0 0 8px var(--arrow-emphasis));\n stroke-width: 2.4;\n }\n }\n @keyframes archify-blueprint-node-pulse {\n 0%, 72%, 100% { opacity: 1; filter: none; }\n 18%, 36% { opacity: 0.72; filter: drop-shadow(0 0 2px var(--frontend-stroke)); }\n }\n @keyframes archify-editorial-node-pulse {\n 0%, 72%, 100% { opacity: 1; filter: none; }\n 18%, 36% { opacity: 0.78; filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 18%, transparent)); }\n }\n @keyframes archify-signal-scan {\n 0%, 18% { opacity: 1; transform: translateX(-70%); }\n 70% { opacity: 1; transform: translateX(70%); }\n 100% { opacity: 0; transform: translateX(70%); }\n }\n @keyframes archify-radar-live {\n 0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--backend-stroke) 52%, transparent); }\n 55%, 100% { box-shadow: 0 0 0 0.32rem transparent; }\n }\n @keyframes archify-guided-progress {\n from { transform: scaleX(var(--guided-progress-start, 0)); }\n to { transform: scaleX(1); }\n }\n @keyframes archify-story-flow {\n to { stroke-dashoffset: 0; }\n }\n @keyframes archify-intent-trace-flow {\n 0% { opacity: 0.28; stroke-dashoffset: 0; }\n 12%, 78% { opacity: 0.94; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-route-probe-flow {\n 0% { stroke-dashoffset: 0; opacity: 0.96; }\n 78% { stroke-dashoffset: -1; opacity: 0.96; }\n 100% { stroke-dasharray: none; stroke-dashoffset: 0; opacity: 0.58; }\n }\n @keyframes archify-route-journey-flow {\n 0% { opacity: 0.16; stroke-dashoffset: 0; }\n 14%, 76% { opacity: 1; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-semantic-lens-flow {\n 0% { opacity: 0.2; stroke-dashoffset: 0; }\n 12%, 78% { opacity: 0.9; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-relationship-pulse {\n 0% { opacity: 0.18; stroke-dashoffset: 0; }\n 10%, 76% { opacity: 0.98; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-relationship-token-life {\n 0%, 7% { opacity: 0; }\n 13%, 82% { opacity: 1; }\n 100% { opacity: 0; }\n }\n @keyframes archify-story-beat-node {\n from { opacity: 0.48; filter: saturate(0.6); }\n 58% { opacity: 1; filter: drop-shadow(0 0 10px var(--frontend-stroke)); }\n to { opacity: 1; filter: drop-shadow(0 0 7px var(--frontend-stroke)); }\n }\n @keyframes archify-share-cue-enter {\n from { opacity: 0; transform: translate(-50%, -0.45rem); }\n to { opacity: 1; transform: translate(-50%, 0); }\n }\n @keyframes archify-share-cue-pulse {\n 0%, 100% { opacity: 1; transform: scale(1); }\n 50% { opacity: 0.48; transform: scale(0.78); }\n }\n @media (prefers-reduced-motion: reduce) {\n html[data-preset=\"signal-flow\"] .diagram-container::before {\n animation: none !important;\n }\n .pulse-dot { animation: none !important; }\n svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n stroke-dashoffset: 0;\n }\n .guided-view-progress span {\n animation: none !important;\n transform: scaleX(1) !important;\n }\n .story-trail-flow,\n .intent-trace-flow,\n .route-probe-flow,\n .semantic-lens,\n .diagram-guide,\n [data-story-step],\n .overview-map-live,\n .guided-view-stop,\n .share-chapter-cue,\n .chapter-handoff-anchor,\n .share-chapter-state::before,\n .share-chapter-progress span { animation: none !important; }\n .guided-view-chapter,\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] { transition: none !important; }\n svg[data-story-playing=\"true\"] .story-trail-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.55;\n }\n .intent-trace-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.72;\n }\n .route-probe-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.78;\n }\n .route-journey-overlay,\n .story-carrier-overlay { display: none !important; }\n .semantic-lens-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-width: 2.2;\n opacity: 0.34;\n filter: none;\n }\n .relationship-pulse-overlay { display: none !important; }\n .guided-view-chapter { transition: none !important; }\n .source-evidence-beacon,\n svg [data-node-id], svg [data-edge-from], svg [data-detail], svg [data-detail-anchor], svg [data-legend-hit], svg { transition: none !important; }\n }\n ";
+ const exportCss = "\n /* ==========================================================\n THEME VARIABLES — switch by toggling [data-theme] on \u003chtml\u003e\n ========================================================== */\n :root,\n [data-theme=\"dark\"] {\n --bg: #020617;\n --grid: #1e293b;\n --text: #ffffff;\n --text-muted: #94a3b8;\n --text-dim: #475569;\n /* UI chrome and menu hints need more contrast than SVG .t-dim accents */\n --text-faint: #7d8da1;\n\n --panel: rgba(15, 23, 42, 0.5);\n --panel-border: #1e293b;\n --lane-fill: rgba(15, 23, 42, 0.22);\n --lane-stroke: #334155;\n\n --arrow: #64748b;\n --arrow-emphasis: #34d399;\n\n /* Opaque mask color used behind semi-transparent component fills\n so the arrows drawn underneath are properly hidden. */\n --mask: #0f172a;\n\n --frontend-fill: rgba(8, 51, 68, 0.4);\n --frontend-stroke: #22d3ee;\n --backend-fill: rgba(6, 78, 59, 0.4);\n --backend-stroke: #34d399;\n --database-fill: rgba(76, 29, 149, 0.4);\n --database-stroke: #a78bfa;\n --cloud-fill: rgba(120, 53, 15, 0.3);\n --cloud-stroke: #fbbf24;\n --security-fill: rgba(136, 19, 55, 0.4);\n --security-stroke: #fb7185;\n --messagebus-fill: rgba(251, 146, 60, 0.3);\n --messagebus-stroke:#fb923c;\n --external-fill: rgba(30, 41, 59, 0.5);\n --external-stroke: #94a3b8;\n\n --toolbar-bg: rgba(15, 23, 42, 0.8);\n --toolbar-border: #334155;\n --toolbar-text: #e2e8f0;\n --toolbar-hover: rgba(15, 23, 42, 0.95);\n --toolbar-menu-bg: #0f172a;\n }\n\n [data-theme=\"light\"] {\n --bg: #f8fafc;\n --grid: #e2e8f0;\n --text: #0f172a;\n --text-muted: #64748b;\n --text-dim: #94a3b8;\n --text-faint: #64748b;\n\n --panel: #ffffff;\n --panel-border: #e2e8f0;\n --lane-fill: rgba(248, 250, 252, 0.65);\n --lane-stroke: #cbd5e1;\n\n --arrow: #94a3b8;\n --arrow-emphasis: #059669;\n\n --mask: #ffffff;\n\n --frontend-fill: rgba(34, 211, 238, 0.15);\n --frontend-stroke: #0891b2;\n --backend-fill: rgba(52, 211, 153, 0.18);\n --backend-stroke: #059669;\n --database-fill: rgba(167, 139, 250, 0.2);\n --database-stroke: #7c3aed;\n --cloud-fill: rgba(251, 191, 36, 0.18);\n --cloud-stroke: #d97706;\n --security-fill: rgba(251, 113, 133, 0.15);\n --security-stroke: #e11d48;\n --messagebus-fill: rgba(251, 146, 60, 0.15);\n --messagebus-stroke:#ea580c;\n --external-fill: rgba(148, 163, 184, 0.18);\n --external-stroke: #64748b;\n\n --toolbar-bg: rgba(255, 255, 255, 0.92);\n --toolbar-border: #cbd5e1;\n --toolbar-text: #334155;\n --toolbar-hover: #ffffff;\n --toolbar-menu-bg: #ffffff;\n }\n\n /* ==========================================================\n SIGNAL FLOW — an opt-in, motion-forward visual preset.\n The variables also target a standalone exported SVG, whose\n root carries data-preset and data-theme directly.\n ========================================================== */\n [data-preset=\"signal-flow\"][data-theme=\"dark\"] {\n --bg: #030711;\n --grid: #15233a;\n --panel: rgba(6, 14, 28, 0.78);\n --panel-border: #1d3350;\n --lane-fill: rgba(9, 22, 40, 0.5);\n --lane-stroke: #2c4564;\n --text: #f5fbff;\n --text-muted: #9eb0c7;\n --text-dim: #52667f;\n --text-faint: #7890ad;\n --mask: #07101e;\n --frontend-fill: rgba(6, 182, 212, 0.14);\n --frontend-stroke: #67e8f9;\n --backend-fill: rgba(16, 185, 129, 0.14);\n --backend-stroke: #5eead4;\n --database-fill: rgba(139, 92, 246, 0.16);\n --database-stroke: #c4b5fd;\n --cloud-fill: rgba(245, 158, 11, 0.13);\n --cloud-stroke: #fcd34d;\n --security-fill: rgba(244, 63, 94, 0.13);\n --security-stroke: #fda4af;\n --messagebus-fill: rgba(249, 115, 22, 0.13);\n --messagebus-stroke: #fdba74;\n --external-fill: rgba(71, 85, 105, 0.24);\n --external-stroke: #a5b4c7;\n --arrow: #7890ad;\n --arrow-emphasis: #2dd4bf;\n --toolbar-bg: rgba(7, 16, 30, 0.86);\n --toolbar-border: #29415f;\n --toolbar-menu-bg: #07101e;\n }\n\n [data-preset=\"signal-flow\"][data-theme=\"light\"] {\n --bg: #f4f9fc;\n --grid: #d4e5ee;\n --panel: rgba(255, 255, 255, 0.82);\n --panel-border: #bfd5e2;\n --lane-fill: rgba(232, 243, 248, 0.62);\n --lane-stroke: #a9c5d5;\n --text: #102638;\n --text-muted: #587287;\n --text-dim: #8aa2b4;\n --text-faint: #668397;\n --mask: #ffffff;\n --frontend-fill: rgba(6, 182, 212, 0.09);\n --frontend-stroke: #0789a1;\n --backend-fill: rgba(5, 150, 105, 0.09);\n --backend-stroke: #087f69;\n --database-fill: rgba(124, 58, 237, 0.09);\n --database-stroke: #7254c7;\n --cloud-fill: rgba(217, 119, 6, 0.08);\n --cloud-stroke: #b9670b;\n --security-fill: rgba(225, 29, 72, 0.08);\n --security-stroke: #c53a59;\n --messagebus-fill: rgba(234, 88, 12, 0.08);\n --messagebus-stroke: #c65f27;\n --external-fill: rgba(100, 116, 139, 0.1);\n --external-stroke: #607a8c;\n --arrow: #7b97aa;\n --arrow-emphasis: #0d9488;\n }\n\n /* ==========================================================\n BLUEPRINT — a review-first drafting preset for deployment,\n infrastructure, and technical design documentation. It keeps\n the same semantic palette and geometry while trading glow for\n precise grid contrast, squared materials, and drafting marks.\n ========================================================== */\n [data-preset=\"blueprint\"][data-theme=\"dark\"] {\n --bg: #06131f;\n --grid: #17425a;\n --panel: rgba(7, 27, 43, 0.9);\n --panel-border: #27627f;\n --lane-fill: rgba(10, 43, 66, 0.36);\n --lane-stroke: #34799a;\n --text: #e3f6ff;\n --text-muted: #91b8ca;\n --text-dim: #557e92;\n --text-faint: #739caf;\n --mask: #0a2031;\n --frontend-fill: rgba(26, 157, 193, 0.14);\n --frontend-stroke: #66d9ef;\n --backend-fill: rgba(31, 155, 124, 0.13);\n --backend-stroke: #69dfbd;\n --database-fill: rgba(120, 105, 196, 0.14);\n --database-stroke: #b4a8ff;\n --cloud-fill: rgba(197, 145, 43, 0.13);\n --cloud-stroke: #ffd166;\n --security-fill: rgba(199, 76, 104, 0.13);\n --security-stroke: #ff8da1;\n --messagebus-fill: rgba(207, 112, 49, 0.13);\n --messagebus-stroke: #ffad66;\n --external-fill: rgba(84, 119, 139, 0.18);\n --external-stroke: #a7cad9;\n --arrow: #78a3b7;\n --arrow-emphasis: #64dfc1;\n --toolbar-bg: rgba(7, 28, 45, 0.92);\n --toolbar-border: #34799a;\n --toolbar-text: #d8f3ff;\n --toolbar-hover: rgba(18, 58, 83, 0.95);\n --toolbar-menu-bg: #0a2031;\n }\n\n [data-preset=\"blueprint\"][data-theme=\"light\"] {\n --bg: #edf7fa;\n --grid: #b5d5e1;\n --panel: rgba(249, 253, 255, 0.94);\n --panel-border: #78aabd;\n --lane-fill: rgba(210, 232, 240, 0.42);\n --lane-stroke: #83b2c4;\n --text: #123344;\n --text-muted: #4e7486;\n --text-dim: #86a6b4;\n --text-faint: #668c9d;\n --mask: #f9fdff;\n --frontend-fill: rgba(8, 145, 178, 0.08);\n --frontend-stroke: #087f9c;\n --backend-fill: rgba(5, 128, 101, 0.08);\n --backend-stroke: #08755f;\n --database-fill: rgba(100, 75, 180, 0.08);\n --database-stroke: #6757a8;\n --cloud-fill: rgba(181, 120, 15, 0.08);\n --cloud-stroke: #a86609;\n --security-fill: rgba(190, 48, 80, 0.07);\n --security-stroke: #b32f50;\n --messagebus-fill: rgba(196, 81, 22, 0.07);\n --messagebus-stroke: #b65120;\n --external-fill: rgba(79, 112, 128, 0.08);\n --external-stroke: #506f7e;\n --arrow: #6d93a5;\n --arrow-emphasis: #087f69;\n --toolbar-bg: rgba(247, 252, 254, 0.94);\n --toolbar-border: #8ab5c5;\n --toolbar-text: #294f61;\n --toolbar-hover: #ffffff;\n --toolbar-menu-bg: #f9fdff;\n }\n\n /* ==========================================================\n EDITORIAL — a warm, publication-minded preset for design\n reviews, launch notes, and documentation. The diagram keeps\n the same semantic palette and exact geometry, but trades\n software chrome for paper, ink, ruled structure, and one\n restrained vermilion accent.\n ========================================================== */\n [data-preset=\"editorial\"][data-theme=\"dark\"] {\n --bg: #181611;\n --grid: #39342a;\n --panel: rgba(35, 31, 24, 0.96);\n --panel-border: #625a4a;\n --lane-fill: rgba(52, 46, 35, 0.46);\n --lane-stroke: #726957;\n --text: #f4eddf;\n --text-muted: #b9ae9b;\n --text-dim: #776e60;\n --text-faint: #9d917e;\n --mask: #231f18;\n --frontend-fill: rgba(43, 133, 142, 0.16);\n --frontend-stroke: #7fc6c7;\n --backend-fill: rgba(63, 132, 92, 0.16);\n --backend-stroke: #8fc29e;\n --database-fill: rgba(117, 91, 141, 0.17);\n --database-stroke: #c0a4d0;\n --cloud-fill: rgba(170, 119, 49, 0.16);\n --cloud-stroke: #d8ad68;\n --security-fill: rgba(157, 69, 65, 0.17);\n --security-stroke: #df9085;\n --messagebus-fill: rgba(174, 79, 42, 0.16);\n --messagebus-stroke: #df946f;\n --external-fill: rgba(126, 115, 96, 0.18);\n --external-stroke: #b8ad99;\n --arrow: #948978;\n --arrow-emphasis: #dd6b3d;\n --toolbar-bg: rgba(35, 31, 24, 0.92);\n --toolbar-border: #625a4a;\n --toolbar-text: #eee5d5;\n --toolbar-hover: #302a20;\n --toolbar-menu-bg: #231f18;\n }\n\n [data-preset=\"editorial\"][data-theme=\"light\"] {\n --bg: #f2eee5;\n --grid: #d8d0c2;\n --panel: rgba(251, 248, 241, 0.97);\n --panel-border: #c4b9a6;\n --lane-fill: rgba(229, 221, 207, 0.42);\n --lane-stroke: #b8aa94;\n --text: #242018;\n --text-muted: #6f6658;\n --text-dim: #a09788;\n --text-faint: #817767;\n --mask: #fbf8f1;\n --frontend-fill: rgba(31, 117, 126, 0.09);\n --frontend-stroke: #287e84;\n --backend-fill: rgba(42, 119, 75, 0.09);\n --backend-stroke: #397b53;\n --database-fill: rgba(105, 75, 130, 0.09);\n --database-stroke: #765d86;\n --cloud-fill: rgba(157, 103, 31, 0.1);\n --cloud-stroke: #9a671f;\n --security-fill: rgba(153, 58, 52, 0.09);\n --security-stroke: #9e463f;\n --messagebus-fill: rgba(182, 70, 27, 0.09);\n --messagebus-stroke: #ad4b25;\n --external-fill: rgba(101, 91, 75, 0.09);\n --external-stroke: #746b5e;\n --arrow: #8a806f;\n --arrow-emphasis: #bb4c23;\n --toolbar-bg: rgba(251, 248, 241, 0.94);\n --toolbar-border: #c4b9a6;\n --toolbar-text: #40392f;\n --toolbar-hover: #fffdf8;\n --toolbar-menu-bg: #fbf8f1;\n }\n\n * { margin: 0; padding: 0; box-sizing: border-box; }\n\n body {\n font-family: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, 'DejaVu Sans Mono', 'Liberation Mono', 'Noto Sans Mono CJK SC', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', monospace;\n background: var(--bg);\n min-height: 100vh;\n padding: 2rem;\n color: var(--text);\n transition: background 0.2s ease, color 0.2s ease;\n }\n\n html[data-preset=\"signal-flow\"] body {\n background-image:\n radial-gradient(circle at 18% -8%, rgba(34, 211, 238, 0.14), transparent 34rem),\n radial-gradient(circle at 92% 18%, rgba(139, 92, 246, 0.12), transparent 30rem);\n background-attachment: fixed;\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] body {\n background-image:\n radial-gradient(circle at 18% -8%, rgba(6, 182, 212, 0.12), transparent 34rem),\n radial-gradient(circle at 92% 18%, rgba(139, 92, 246, 0.08), transparent 30rem);\n }\n html[data-preset=\"blueprint\"] body {\n background-image:\n linear-gradient(var(--grid) 1px, transparent 1px),\n linear-gradient(90deg, var(--grid) 1px, transparent 1px);\n background-size: 32px 32px;\n background-position: -1px -1px;\n background-attachment: fixed;\n }\n html[data-preset=\"editorial\"] body {\n background-image:\n linear-gradient(90deg, transparent 0, transparent 5.4rem, color-mix(in srgb, var(--security-stroke) 18%, transparent) 5.4rem, color-mix(in srgb, var(--security-stroke) 18%, transparent) calc(5.4rem + 1px), transparent calc(5.4rem + 1px)),\n repeating-linear-gradient(0deg, transparent 0, transparent 31px, color-mix(in srgb, var(--grid) 36%, transparent) 31px, color-mix(in srgb, var(--grid) 36%, transparent) 32px);\n background-attachment: fixed;\n }\n\n /* Gallery/embed mode keeps the generated artifact as the source of truth\n while presenting only its diagram surface inside a proof card. */\n html[data-embed=\"true\"] body {\n min-height: 0;\n padding: 0;\n overflow: hidden;\n background: var(--bg);\n background-image: none;\n }\n html[data-embed=\"true\"] .toolbar,\n html[data-embed=\"true\"] .header,\n html[data-embed=\"true\"] .cards,\n html[data-embed=\"true\"] .diagram-nav,\n html[data-embed=\"true\"] .overview-map,\n html[data-embed=\"true\"] .focus-chip,\n html[data-embed=\"true\"] .route-probe,\n html[data-embed=\"true\"] .semantic-lens,\n html[data-embed=\"true\"] .diagram-guide,\n html[data-embed=\"true\"] .node-finder,\n html[data-embed=\"true\"] .guided-views { display: none !important; }\n html[data-embed=\"true\"] .container { max-width: none; }\n html[data-embed=\"true\"] .diagram-container {\n padding: 0.5rem;\n border: 0;\n border-radius: 0;\n box-shadow: none;\n }\n html[data-embed=\"true\"] .diagram-container svg { min-width: 0; }\n\n /* Share Chapter Cue lives in the HTML viewer layer, not inside the SVG.\n It gives one-shot embeds a title, authored note, truthful stop order,\n and lifecycle state while canonical diagram geometry stays untouched. */\n .share-chapter-cue { display: none; }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .share-chapter-cue:not([hidden]),\n html[data-embed=\"true\"][data-share-moment=\"true\"] .share-chapter-cue:not([hidden]) {\n position: absolute;\n z-index: 18;\n top: 0.85rem;\n left: 50%;\n display: grid;\n grid-template-columns: auto minmax(9rem, 13.5rem) minmax(0, 1fr);\n align-items: center;\n gap: 0.45rem 0.85rem;\n width: min(52rem, calc(100% - 1.5rem));\n min-height: 3.35rem;\n padding: 0.55rem 0.75rem 0.65rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 42%, var(--toolbar-border));\n border-radius: 0.75rem;\n background:\n linear-gradient(115deg, color-mix(in srgb, var(--frontend-fill) 52%, transparent), transparent 45%),\n color-mix(in srgb, var(--toolbar-menu-bg) 92%, transparent);\n color: var(--toolbar-text);\n box-shadow: 0 14px 42px rgba(0, 0, 0, 0.3), inset 0 1px 0 rgba(255, 255, 255, 0.045);\n backdrop-filter: blur(16px);\n pointer-events: none;\n animation: archify-share-cue-enter 280ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n html[data-preset=\"blueprint\"] .share-chapter-cue {\n border-radius: 0.2rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--frontend-fill) 46%, transparent), transparent 36%),\n var(--toolbar-menu-bg);\n box-shadow: 0 10px 28px rgba(0, 0, 0, 0.2);\n backdrop-filter: none;\n }\n html[data-preset=\"editorial\"] .share-chapter-cue {\n border-color: var(--panel-border);\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--security-fill) 58%, transparent), transparent 42%),\n var(--toolbar-menu-bg);\n box-shadow: 0 10px 30px color-mix(in srgb, #000 18%, transparent);\n backdrop-filter: none;\n }\n html[data-preset=\"editorial\"] .share-chapter-state { color: var(--arrow-emphasis); }\n html[data-preset=\"editorial\"] .share-chapter-state::before {\n border-radius: 0;\n box-shadow: none;\n transform: rotate(45deg) scale(0.8);\n }\n .share-chapter-index {\n display: grid;\n gap: 0.12rem;\n min-width: 5rem;\n padding-right: 0.75rem;\n border-right: 1px solid var(--toolbar-border);\n }\n .share-chapter-state {\n display: inline-flex;\n align-items: center;\n gap: 0.36rem;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.14em;\n text-transform: uppercase;\n }\n .share-chapter-state::before {\n width: 0.38rem;\n height: 0.38rem;\n border-radius: 50%;\n background: currentColor;\n box-shadow: 0 0 10px currentColor;\n content: '';\n }\n .share-chapter-cue[data-state=\"playing\"] .share-chapter-state::before {\n animation: archify-share-cue-pulse 1.15s ease-in-out infinite;\n }\n .share-chapter-count {\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 700;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .share-chapter-copy { min-width: 0; }\n .share-chapter-copy strong,\n .share-chapter-copy small,\n .share-chapter-route {\n display: block;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .share-chapter-copy strong {\n color: var(--toolbar-text);\n font-size: 0.6875rem;\n line-height: 1.35;\n }\n .share-chapter-copy small {\n margin-top: 0.08rem;\n color: var(--text-muted);\n font-size: 0.5rem;\n line-height: 1.35;\n }\n .share-chapter-route {\n color: color-mix(in srgb, var(--frontend-stroke) 76%, var(--text-muted));\n font-size: 0.5625rem;\n font-weight: 650;\n letter-spacing: 0.015em;\n text-align: right;\n }\n .share-chapter-progress {\n position: absolute;\n right: 0;\n bottom: 0;\n left: 0;\n height: 2px;\n overflow: hidden;\n background: color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n .share-chapter-progress span {\n display: block;\n width: 100%;\n height: 100%;\n background: linear-gradient(90deg, var(--frontend-stroke), var(--database-stroke));\n box-shadow: 0 0 12px var(--frontend-stroke);\n transform: scaleX(0);\n transform-origin: left center;\n }\n\n /* Presentation Stage is a viewer-only layer: it gives the live diagram\n the viewport while keeping guided views, theme, focus, and exports real.\n Embed mode wins when both query parameters are present. */\n html[data-present=\"true\"]:not([data-embed=\"true\"]) body {\n height: 100dvh;\n min-height: 0;\n padding: 1rem;\n overflow: hidden;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .container {\n display: flex;\n flex-direction: column;\n gap: 0.75rem;\n width: 100%;\n max-width: none;\n height: calc(100dvh - 2rem);\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header {\n flex: none;\n min-width: 0;\n margin: 0;\n padding-right: 23rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row { margin-bottom: 0.25rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .subtitle {\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views {\n flex: none;\n margin-bottom: 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container {\n display: flex;\n flex: 1 1 auto;\n align-items: center;\n justify-content: center;\n min-height: 0;\n padding: 0.75rem;\n padding-bottom: calc(0.75rem + var(--archify-nav-reserve));\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container \u003e svg {\n flex: 1 1 auto;\n height: 100%;\n min-height: 0;\n width: 100%;\n min-width: 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .cards { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) #btn-present {\n border-color: var(--frontend-stroke);\n color: var(--frontend-stroke);\n }\n\n /* The reader owns only the outer scale. Wide diagrams keep one authored\n SVG/viewBox while the runtime chooses a desktop width from the actual\n vertical budget. This avoids device-specific files and breakpoint\n jumps between a laptop and a tall monitor. */\n .container {\n width: 100%;\n max-width: var(--archify-reader-width, 1440px);\n margin: 0 auto;\n }\n @media (min-width: 768px) and (max-height: 920px) {\n .header { margin-bottom: 1rem; }\n .diagram-container { padding: 1rem; }\n .cards { margin-top: 1rem; }\n .card { padding: 1rem; }\n }\n\n .header { margin-bottom: 1.5rem; padding-right: 29.5rem; }\n\n html[data-preset=\"signal-flow\"] .header,\n html[data-preset=\"blueprint\"] .header,\n html[data-preset=\"editorial\"] .header { padding-right: 29.5rem; }\n\n .header-row {\n display: flex;\n align-items: center;\n gap: 1rem;\n margin-bottom: 0.5rem;\n }\n\n .pulse-dot {\n width: 12px;\n height: 12px;\n background: var(--frontend-stroke);\n border-radius: 50%;\n animation: none;\n }\n\n html[data-motion-capable=\"true\"] .pulse-dot { animation: pulse 2s infinite; }\n\n @keyframes pulse {\n 0%, 100% { opacity: 1; }\n 50% { opacity: 0.5; }\n }\n\n h1 {\n font-size: 1.5rem;\n font-weight: 700;\n letter-spacing: -0.025em;\n }\n\n .subtitle {\n color: var(--text-muted);\n font-size: 0.875rem;\n margin-left: 1.75rem;\n }\n\n html[data-preset=\"signal-flow\"] .header-row::after {\n content: attr(data-preset-badge-signal-flow);\n margin-left: auto;\n color: var(--frontend-stroke);\n border: 1px solid var(--frontend-stroke);\n border-radius: 999px;\n padding: 0.28rem 0.6rem;\n font-size: 0.625rem;\n letter-spacing: 0.12em;\n opacity: 0.82;\n box-shadow: 0 0 20px rgba(34, 211, 238, 0.12);\n white-space: nowrap;\n }\n\n html[data-preset=\"blueprint\"] .pulse-dot {\n width: 10px;\n height: 10px;\n border: 1px solid var(--frontend-stroke);\n border-radius: 1px;\n background: transparent;\n box-shadow: inset 0 0 0 2px var(--bg);\n transform: rotate(45deg);\n animation: none;\n }\n html[data-preset=\"blueprint\"] .header-row::after {\n content: attr(data-preset-badge-blueprint);\n margin-left: auto;\n padding: 0.28rem 0.55rem;\n border-top: 1px solid var(--frontend-stroke);\n border-bottom: 1px solid var(--frontend-stroke);\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 700;\n letter-spacing: 0.14em;\n white-space: nowrap;\n }\n\n html[data-preset=\"editorial\"] h1,\n html[data-preset=\"editorial\"] .card h3 {\n font-family: Georgia, 'Times New Roman', 'Songti SC', STSong, serif;\n letter-spacing: -0.02em;\n }\n html[data-preset=\"editorial\"] h1 { font-size: 1.72rem; font-weight: 600; }\n html[data-preset=\"editorial\"] .pulse-dot {\n width: 9px;\n height: 9px;\n border: 1px solid var(--arrow-emphasis);\n border-radius: 0;\n background: var(--arrow-emphasis);\n box-shadow: 0 0 0 3px color-mix(in srgb, var(--arrow-emphasis) 14%, transparent);\n transform: rotate(45deg);\n animation: none;\n }\n html[data-preset=\"editorial\"] .header-row::after {\n content: attr(data-preset-badge-editorial);\n margin-left: auto;\n padding: 0.32rem 0 0.24rem;\n border-bottom: 2px solid var(--arrow-emphasis);\n color: var(--arrow-emphasis);\n font-family: Georgia, 'Times New Roman', serif;\n font-size: 0.625rem;\n font-style: italic;\n font-weight: 600;\n letter-spacing: 0.08em;\n white-space: nowrap;\n }\n\n .diagram-container {\n --archify-nav-reserve: 0px;\n background: var(--panel);\n border-radius: 1rem;\n border: 1px solid var(--panel-border);\n padding: 1.5rem;\n padding-bottom: calc(1.5rem + var(--archify-nav-reserve));\n overflow: hidden;\n position: relative;\n }\n\n html[data-preset=\"signal-flow\"] .diagram-container {\n position: relative;\n overflow: hidden;\n background: linear-gradient(180deg, rgba(8, 20, 38, 0.82), rgba(3, 8, 18, 0.94));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.04), 0 28px 80px rgba(0, 0, 0, 0.34);\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] .diagram-container {\n background: linear-gradient(180deg, rgba(255, 255, 255, 0.9), rgba(237, 246, 250, 0.94));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.72), 0 24px 60px rgba(45, 78, 99, 0.12);\n }\n html[data-preset=\"blueprint\"] .diagram-container {\n border-color: var(--panel-border);\n border-radius: 0.35rem;\n background: var(--panel);\n box-shadow:\n inset 0 0 0 1px color-mix(in srgb, var(--panel-border) 34%, transparent),\n 0 18px 48px rgba(0, 0, 0, 0.16);\n }\n html[data-preset=\"blueprint\"] .diagram-container::after {\n content: \"\";\n position: absolute;\n z-index: 10;\n inset: 0.7rem;\n pointer-events: none;\n background:\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left top / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left top / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right top / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right top / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left bottom / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) left bottom / 1px 1.35rem no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right bottom / 1.35rem 1px no-repeat,\n linear-gradient(var(--frontend-stroke), var(--frontend-stroke)) right bottom / 1px 1.35rem no-repeat;\n opacity: 0.58;\n }\n html[data-preset=\"editorial\"] .diagram-container {\n overflow: hidden;\n border-color: var(--panel-border);\n border-radius: 0.38rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--security-fill) 58%, transparent), transparent 12%),\n var(--panel);\n box-shadow:\n 0 1px 0 color-mix(in srgb, var(--text) 6%, transparent),\n 0 18px 48px color-mix(in srgb, #000 19%, transparent);\n }\n html[data-preset=\"editorial\"] .diagram-container::after {\n position: absolute;\n z-index: 10;\n top: 0.72rem;\n right: 1.25rem;\n padding: 0.2rem 0.52rem;\n border: 1px solid var(--panel-border);\n background: var(--panel);\n color: var(--arrow-emphasis);\n content: attr(data-preset-badge-editorial-plate);\n font-family: Georgia, 'Times New Roman', serif;\n font-size: 0.52rem;\n font-style: italic;\n font-weight: 600;\n letter-spacing: 0.09em;\n pointer-events: none;\n }\n html[data-embed=\"true\"][data-preset=\"editorial\"] .diagram-container::after { display: none; }\n html[data-motion-capable=\"true\"][data-preset=\"signal-flow\"][data-ambient-motion=\"running\"] .diagram-container::before {\n content: \"\";\n position: absolute;\n inset: 0;\n pointer-events: none;\n background: linear-gradient(115deg, transparent 28%, rgba(103, 232, 249, 0.035) 48%, transparent 68%);\n transform: translateX(-70%);\n animation: archify-signal-scan 4.8s ease-in-out 1 both;\n }\n\n /* Motion Governor gives the reader a real static state and gives the\n strongest semantic action the only motion budget. Atmosphere resets to\n its authored base instead of freezing mid-cycle. Static artifacts never\n start a decorative pulse or scan. */\n html:not([data-motion-capable=\"true\"]) svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n }\n html[data-motion=\"still\"] .pulse-dot,\n html[data-motion=\"still\"] .diagram-container::before,\n html[data-motion=\"still\"] svg[data-animation=\"trace\"] [data-animate],\n html[data-motion-owner] .pulse-dot,\n html[data-motion-owner] .diagram-container::before,\n html[data-motion-owner] svg[data-animation=\"trace\"] [data-animate],\n html[data-embed=\"true\"] .pulse-dot,\n html[data-embed=\"true\"] .diagram-container::before,\n html[data-share-playback=\"true\"] .pulse-dot,\n html[data-share-playback=\"true\"] .diagram-container::before,\n html[data-document-hidden=\"true\"] .pulse-dot,\n html[data-document-hidden=\"true\"] .diagram-container::before,\n html[data-document-hidden=\"true\"] svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n }\n html[data-motion=\"still\"] .diagram-container::before,\n html[data-motion-owner] .diagram-container::before,\n html[data-embed=\"true\"] .diagram-container::before,\n html[data-share-playback=\"true\"] .diagram-container::before {\n opacity: 0;\n }\n html[data-motion=\"still\"] .guided-view-progress span,\n html[data-motion=\"still\"] .guided-story-caption,\n html[data-motion=\"still\"] .story-trail-flow,\n html[data-motion=\"still\"] .intent-trace-flow,\n html[data-motion=\"still\"] .route-probe-flow,\n html[data-motion=\"still\"] .route-journey-flow,\n html[data-motion=\"still\"] .semantic-lens-flow,\n html[data-motion=\"still\"] .diagram-guide,\n html[data-motion=\"still\"] [data-story-step],\n html[data-motion=\"still\"] .overview-map-live,\n html[data-motion=\"still\"] .guided-view-stop,\n html[data-motion=\"still\"] .share-chapter-cue,\n html[data-motion=\"still\"] .share-chapter-state::before,\n html[data-motion=\"still\"] .share-chapter-progress span,\n html[data-document-hidden=\"true\"] .guided-view-progress span,\n html[data-document-hidden=\"true\"] .story-trail-flow,\n html[data-document-hidden=\"true\"] .intent-trace-flow,\n html[data-document-hidden=\"true\"] .route-probe-flow,\n html[data-document-hidden=\"true\"] .route-journey-flow,\n html[data-document-hidden=\"true\"] .semantic-lens-flow,\n html[data-document-hidden=\"true\"] .diagram-guide,\n html[data-document-hidden=\"true\"] [data-story-step],\n html[data-document-hidden=\"true\"] .overview-map-live,\n html[data-document-hidden=\"true\"] .guided-view-stop,\n html[data-document-hidden=\"true\"] .share-chapter-cue,\n html[data-document-hidden=\"true\"] .share-chapter-state::before,\n html[data-document-hidden=\"true\"] .share-chapter-progress span {\n animation: none !important;\n }\n html[data-motion=\"still\"] .guided-view-progress span {\n transform: scaleX(1) !important;\n }\n html[data-motion=\"still\"] svg[data-story-playing=\"true\"] .story-trail-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.55;\n }\n html[data-motion=\"still\"] .intent-trace-flow,\n html[data-motion=\"still\"] .route-probe-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.72;\n }\n html[data-motion=\"still\"] .route-journey-overlay,\n html[data-document-hidden=\"true\"] .route-journey-overlay { display: none !important; }\n html[data-motion=\"still\"] .relationship-pulse-overlay,\n html[data-motion=\"still\"] .story-carrier-overlay,\n html[data-document-hidden=\"true\"] .story-carrier-overlay { display: none !important; }\n html[data-motion=\"still\"] .chapter-handoff-overlay { display: none !important; }\n html[data-motion=\"still\"] .chapter-handoff-anchor { animation: none !important; }\n html[data-motion=\"still\"] .guided-view-chapter,\n html[data-motion=\"still\"] svg [data-node-id],\n html[data-motion=\"still\"] svg [data-edge-from],\n html[data-motion=\"still\"] svg [data-detail],\n html[data-motion=\"still\"] svg [data-detail-anchor],\n html[data-motion=\"still\"] svg [data-legend-hit],\n html[data-motion=\"still\"] svg {\n transition: none !important;\n }\n\n svg {\n width: 100%;\n min-width: min(900px, 100%);\n display: block;\n transform-origin: 0 0;\n transition: transform 0.18s ease;\n }\n\n .diagram-container.is-camera-moving svg {\n transition: transform 0.42s cubic-bezier(0.22, 1, 0.36, 1);\n }\n .diagram-container.is-camera-transaction svg { transition: none; }\n .diagram-container.is-pannable { cursor: grab; }\n .diagram-container.is-panning { cursor: grabbing; user-select: none; }\n .diagram-container.is-panning svg { transition: none; }\n\n .diagram-nav {\n position: absolute;\n right: 1rem;\n bottom: 1rem;\n z-index: 12;\n display: inline-flex;\n align-items: center;\n max-width: calc(100% - 2rem);\n padding: 0.15rem;\n gap: 0;\n overflow-x: auto;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 48%, transparent);\n border-radius: 0.58rem;\n background: color-mix(in srgb, var(--toolbar-bg) 82%, transparent);\n box-shadow: 0 5px 14px rgba(0, 0, 0, 0.07);\n backdrop-filter: blur(10px);\n scrollbar-width: none;\n }\n .diagram-nav::-webkit-scrollbar { display: none; }\n .diagram-nav button,\n .focus-chip button,\n .guided-views button {\n border: 0;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n cursor: pointer;\n }\n .diagram-nav button {\n min-width: 2rem;\n height: 2rem;\n padding: 0 0.35rem;\n border-radius: 0.35rem;\n color: color-mix(in srgb, var(--toolbar-text) 68%, transparent);\n font-size: 0.56rem;\n font-weight: 600;\n letter-spacing: 0.02em;\n transition: background 0.15s, color 0.15s;\n }\n .diagram-nav button:hover,\n .diagram-nav button:focus-visible,\n .focus-chip button:hover,\n .focus-chip button:focus-visible,\n .guided-views button:hover,\n .guided-views button:focus-visible { background: var(--toolbar-hover); }\n .diagram-nav button:focus-visible,\n .focus-chip button:focus-visible,\n .guided-views button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .diagram-nav button:disabled { opacity: 0.38; cursor: default; }\n .diagram-nav button:disabled:hover { background: transparent; }\n .diagram-nav #btn-route-probe,\n .diagram-nav #btn-overview-map,\n .diagram-nav #btn-semantic-lens {\n min-width: auto;\n padding-inline: 0.5rem;\n color: color-mix(in srgb, var(--toolbar-text) 86%, transparent);\n font-weight: 650;\n }\n .diagram-nav #btn-node-finder,\n .diagram-nav [data-view=\"out\"] {\n position: relative;\n margin-left: 0.25rem;\n }\n .diagram-nav #btn-node-finder::before,\n .diagram-nav [data-view=\"out\"]::before {\n position: absolute;\n top: 0.4rem;\n bottom: 0.4rem;\n left: -0.13rem;\n width: 1px;\n background: color-mix(in srgb, var(--toolbar-border) 62%, transparent);\n content: \"\";\n pointer-events: none;\n }\n .diagram-nav-icon {\n display: block;\n width: 0.72rem;\n height: 0.72rem;\n margin: auto;\n background: currentColor;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .diagram-nav-icon.find {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='8.5' cy='8.5' r='4.5' fill='none' stroke='black' stroke-width='1.8'/%3E%3Cpath d='m12 12 4 4' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='8.5' cy='8.5' r='4.5' fill='none' stroke='black' stroke-width='1.8'/%3E%3Cpath d='m12 12 4 4' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.guide {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='10' cy='10' r='7' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.8 7.3a2.4 2.4 0 014.6.9c0 1.8-2.4 2-2.4 3.7M10 14.9h.01' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Ccircle cx='10' cy='10' r='7' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.8 7.3a2.4 2.4 0 014.6.9c0 1.8-2.4 2-2.4 3.7M10 14.9h.01' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.minus {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav-icon.plus {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 5v10M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 5v10M5 10h10' fill='none' stroke='black' stroke-width='1.8' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .diagram-nav [data-view=\"reset\"] {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.2rem;\n min-width: 3.1rem;\n padding-inline: 0.35rem;\n }\n .diagram-nav [data-view=\"reset\"][data-detail-visible] {\n min-width: 3.8rem;\n }\n .diagram-nav-detail {\n color: color-mix(in srgb, var(--toolbar-text) 52%, transparent);\n font-size: 0.44rem;\n font-weight: 700;\n line-height: 1;\n letter-spacing: 0.07em;\n }\n .diagram-nav-percent {\n color: color-mix(in srgb, var(--toolbar-text) 84%, transparent);\n font-size: 0.55rem;\n font-weight: 650;\n line-height: 1;\n }\n .diagram-container[data-camera-indicator=\"true\"] .diagram-nav-detail,\n .diagram-container[data-camera-indicator=\"true\"] .diagram-nav-percent { color: var(--frontend-stroke); }\n .diagram-nav #btn-diagram-guide[aria-expanded=\"true\"] {\n color: var(--cloud-stroke);\n background: var(--toolbar-hover);\n }\n\n /* Semantic Radar is a deliberately simplified, viewer-only overview. It\n uses authored node bounds and the live camera viewport rather than\n cloning the canonical SVG, so IDs, filters, animation, and export state\n stay singular and deterministic. */\n .overview-map {\n position: absolute;\n right: 1rem;\n bottom: calc(4.15rem + var(--archify-nav-reserve));\n z-index: 12;\n width: 11.25rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n border-radius: 0.78rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 16px 42px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.625rem;\n }\n .overview-map[hidden] { display: none; }\n .overview-map[data-docked=\"true\"] {\n position: fixed;\n right: var(--archify-radar-right, 1rem);\n top: var(--archify-radar-top, 1rem);\n bottom: auto;\n }\n .overview-map[data-docked=\"true\"][data-dock-side=\"left\"] {\n right: auto;\n left: var(--archify-radar-left, 1rem);\n }\n html[data-preset=\"blueprint\"] .overview-map { border-radius: 0.28rem; }\n .overview-map-head {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.45rem;\n min-height: 2.25rem;\n padding: 0.42rem 0.48rem 0.38rem 0.55rem;\n border-bottom: 1px solid var(--toolbar-border);\n background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);\n cursor: grab;\n touch-action: none;\n user-select: none;\n }\n .overview-map[data-panel-dragging=\"true\"] .overview-map-head { cursor: grabbing; }\n .overview-map[data-placement-invalid=\"true\"] {\n border-color: var(--security-stroke);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);\n }\n .overview-map[data-compact=\"true\"] {\n width: 7.4rem;\n }\n .overview-map[data-compact=\"true\"] .overview-map-head {\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.24rem;\n min-height: 1.5rem;\n padding: 0.05rem 0.16rem 0.05rem 0.32rem;\n border-bottom: 0;\n }\n .overview-map[data-compact=\"true\"] .overview-map-live,\n .overview-map[data-compact=\"true\"] .overview-map-copy,\n .overview-map[data-compact=\"true\"] .overview-map-surface,\n .overview-map[data-compact=\"true\"] .overview-map-hint {\n display: none;\n }\n .overview-map[data-compact=\"true\"] .overview-map-expand { display: inline-flex; }\n .overview-map[data-compact=\"true\"] .overview-map-close {\n width: 1.15rem;\n height: 1.15rem;\n font-size: 0.72rem;\n }\n .overview-map-live {\n width: 0.42rem;\n height: 0.42rem;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 0 0 color-mix(in srgb, var(--backend-stroke) 52%, transparent);\n animation: archify-radar-live 2.4s ease-out infinite;\n }\n .overview-map-copy { min-width: 0; line-height: 1.1; }\n .overview-map-copy strong {\n display: block;\n overflow: hidden;\n color: var(--frontend-stroke);\n font-size: 0.59rem;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .overview-map-copy small {\n display: block;\n margin-top: 0.18rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.52rem;\n letter-spacing: 0.04em;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .overview-map-expand {\n display: none;\n align-items: center;\n justify-content: center;\n min-width: 0;\n height: 1.2rem;\n padding: 0 0.34rem;\n overflow: hidden;\n border: 0;\n border-radius: 0.3rem;\n background: transparent;\n color: var(--frontend-stroke);\n font: inherit;\n font-size: 0.49rem;\n font-weight: 700;\n letter-spacing: 0.06em;\n text-transform: uppercase;\n white-space: nowrap;\n cursor: pointer;\n }\n .overview-map-close {\n width: 1.55rem;\n height: 1.55rem;\n padding: 0;\n border: 0;\n border-radius: 0.34rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 0.9rem;\n cursor: pointer;\n }\n .overview-map-expand:hover,\n .overview-map-expand:focus-visible,\n .overview-map-close:hover,\n .overview-map-close:focus-visible { background: var(--toolbar-hover); }\n .overview-map-expand:focus-visible,\n .overview-map-close:focus-visible,\n .overview-map-surface:focus-visible,\n .overview-map-node:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .overview-map-surface {\n position: relative;\n height: 7rem;\n margin: 0.42rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--panel-border) 72%, transparent);\n border-radius: 0.42rem;\n background:\n linear-gradient(color-mix(in srgb, var(--panel-border) 26%, transparent) 1px, transparent 1px),\n linear-gradient(90deg, color-mix(in srgb, var(--panel-border) 26%, transparent) 1px, transparent 1px),\n color-mix(in srgb, var(--bg) 86%, transparent);\n background-size: 12px 12px;\n cursor: crosshair;\n touch-action: none;\n }\n html[data-preset=\"blueprint\"] .overview-map-surface { border-radius: 0.1rem; }\n .overview-map-surface \u003e svg {\n width: 100%;\n height: 100%;\n min-width: 0;\n transform: none !important;\n transition: none !important;\n display: block;\n overflow: visible;\n }\n .overview-map-node {\n fill: var(--backend-stroke);\n fill-opacity: 0.52;\n stroke: var(--backend-stroke);\n stroke-opacity: 0.86;\n vector-effect: non-scaling-stroke;\n cursor: pointer;\n transition: fill-opacity 140ms ease, stroke-width 140ms ease, filter 140ms ease;\n }\n .overview-map-node[data-kind=\"frontend\"],\n .overview-map-node[data-kind=\"start\"] { fill: var(--frontend-stroke); stroke: var(--frontend-stroke); }\n .overview-map-node[data-kind=\"database\"],\n .overview-map-node[data-kind=\"success\"] { fill: var(--database-stroke); stroke: var(--database-stroke); }\n .overview-map-node[data-kind=\"cloud\"],\n .overview-map-node[data-kind=\"waiting\"] { fill: var(--cloud-stroke); stroke: var(--cloud-stroke); }\n .overview-map-node[data-kind=\"messagebus\"] { fill: var(--messagebus-stroke); stroke: var(--messagebus-stroke); }\n .overview-map-node[data-kind=\"security\"],\n .overview-map-node[data-kind=\"decision\"],\n .overview-map-node[data-kind=\"failure\"] { fill: var(--security-stroke); stroke: var(--security-stroke); }\n .overview-map-node[data-kind=\"external\"],\n .overview-map-node[data-kind=\"neutral\"] { fill: var(--external-stroke); stroke: var(--external-stroke); }\n .overview-map-node[data-radar-active=\"true\"],\n .overview-map-node:hover,\n .overview-map-node:focus-visible {\n fill-opacity: 0.92;\n stroke-width: 2.2;\n filter: drop-shadow(0 0 3px currentColor);\n }\n .overview-map-viewport {\n fill: color-mix(in srgb, var(--frontend-fill) 56%, transparent);\n stroke: var(--frontend-stroke);\n stroke-width: 2;\n vector-effect: non-scaling-stroke;\n pointer-events: none;\n filter: drop-shadow(0 0 3px color-mix(in srgb, var(--frontend-stroke) 54%, transparent));\n }\n .overview-map-hint {\n display: flex;\n justify-content: space-between;\n gap: 0.5rem;\n padding: 0 0.52rem 0.46rem;\n color: var(--text-faint);\n font-size: 0.49rem;\n letter-spacing: 0.06em;\n text-transform: uppercase;\n }\n .diagram-nav #btn-overview-map[aria-expanded=\"true\"] {\n color: var(--frontend-stroke);\n background: var(--toolbar-hover);\n }\n .overview-map-feedback {\n position: absolute;\n right: 1rem;\n bottom: 4.15rem;\n z-index: 13;\n max-width: min(16rem, calc(100% - 2rem));\n padding: 0.38rem 0.55rem;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n border-radius: 0.5rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);\n font-size: 0.52rem;\n line-height: 1.35;\n pointer-events: none;\n }\n .overview-map-feedback[hidden] { display: none; }\n .focus-chip[data-radar-yielded=\"true\"] { display: none !important; }\n .diagram-nav #btn-route-probe[aria-pressed=\"true\"] {\n color: var(--backend-stroke);\n background: var(--toolbar-hover);\n }\n .diagram-nav #btn-semantic-lens[aria-expanded=\"true\"],\n .diagram-nav #btn-semantic-lens[aria-pressed=\"true\"] {\n color: var(--database-stroke);\n background: var(--toolbar-hover);\n }\n\n /* Semantic Lens turns the compiled node-kind palette into an analytical\n legend. One kind reveals its real traffic; two kinds compare only their\n direct authored relationships. Geometry and the canonical SVG stay put. */\n .semantic-lens {\n position: absolute;\n right: 1rem;\n bottom: calc(4.15rem + var(--archify-nav-reserve));\n z-index: 24;\n width: min(20rem, calc(100% - 2rem));\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--database-stroke) 58%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(135deg, color-mix(in srgb, var(--database-fill) 34%, transparent), transparent 48%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 52px rgba(0, 0, 0, 0.36);\n backdrop-filter: blur(18px);\n animation: archify-lens-in 180ms cubic-bezier(0.22, 1, 0.36, 1);\n }\n .semantic-lens[hidden] { display: none; }\n .semantic-lens[data-dock-side=\"left\"] { left: 1rem; right: auto; }\n .semantic-lens[data-dock-side=\"right\"] { left: auto; right: 1rem; }\n html[data-preset=\"blueprint\"] .semantic-lens { border-radius: 0.28rem; }\n .semantic-lens-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.75rem;\n padding: 0.72rem 0.78rem 0.62rem;\n border-bottom: 1px solid var(--toolbar-border);\n }\n .semantic-lens-eyebrow {\n display: block;\n color: var(--database-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.16em;\n text-transform: uppercase;\n }\n .semantic-lens-title {\n display: block;\n margin-top: 0.16rem;\n color: var(--text);\n font-size: 0.82rem;\n letter-spacing: -0.02em;\n }\n .semantic-lens-close {\n width: 1.75rem;\n height: 1.75rem;\n padding: 0;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .semantic-lens-close:hover,\n .semantic-lens-close:focus-visible { background: var(--toolbar-hover); }\n .semantic-lens-instruction {\n margin: 0;\n padding: 0.52rem 0.78rem 0.48rem;\n color: var(--text-faint);\n font-size: 0.55rem;\n line-height: 1.45;\n }\n .semantic-lens-kinds {\n display: grid;\n grid-template-columns: 1fr 1fr;\n gap: 0.3rem;\n max-height: min(15rem, 40vh);\n padding: 0 0.5rem 0.5rem;\n overflow-y: auto;\n scrollbar-width: thin;\n }\n .semantic-lens-kind {\n --lens-color: var(--external-stroke);\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.42rem;\n min-width: 0;\n min-height: 2.15rem;\n padding: 0.35rem 0.42rem;\n border: 1px solid color-mix(in srgb, var(--lens-color) 24%, var(--toolbar-border));\n border-radius: 0.45rem;\n background: color-mix(in srgb, var(--panel) 76%, transparent);\n color: var(--toolbar-text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: border-color 140ms ease, background 140ms ease, opacity 140ms ease;\n }\n html[data-preset=\"blueprint\"] .semantic-lens-kind { border-radius: 0.12rem; }\n .semantic-lens-kind[data-kind=\"frontend\"],\n .semantic-lens-kind[data-kind=\"start\"] { --lens-color: var(--frontend-stroke); }\n .semantic-lens-kind[data-kind=\"backend\"],\n .semantic-lens-kind[data-kind=\"active\"] { --lens-color: var(--backend-stroke); }\n .semantic-lens-kind[data-kind=\"database\"],\n .semantic-lens-kind[data-kind=\"success\"] { --lens-color: var(--database-stroke); }\n .semantic-lens-kind[data-kind=\"cloud\"],\n .semantic-lens-kind[data-kind=\"waiting\"] { --lens-color: var(--cloud-stroke); }\n .semantic-lens-kind[data-kind=\"messagebus\"] { --lens-color: var(--messagebus-stroke); }\n .semantic-lens-kind[data-kind=\"security\"],\n .semantic-lens-kind[data-kind=\"decision\"],\n .semantic-lens-kind[data-kind=\"failure\"] { --lens-color: var(--security-stroke); }\n .semantic-lens-kind:hover,\n .semantic-lens-kind:focus-visible,\n .semantic-lens-kind[aria-pressed=\"true\"] {\n border-color: color-mix(in srgb, var(--lens-color) 78%, var(--toolbar-border));\n background: color-mix(in srgb, var(--lens-color) 11%, var(--panel));\n }\n .semantic-lens-kind:focus-visible,\n .semantic-lens-close:focus-visible,\n .semantic-lens-actions button:focus-visible {\n outline: 2px solid var(--database-stroke);\n outline-offset: 1px;\n }\n .semantic-lens-kind:disabled { opacity: 0.34; cursor: default; }\n .semantic-lens-swatch {\n width: 0.48rem;\n height: 0.48rem;\n border-radius: 50%;\n background: var(--lens-color);\n box-shadow: 0 0 8px color-mix(in srgb, var(--lens-color) 58%, transparent);\n }\n .semantic-lens-kind strong {\n overflow: hidden;\n color: var(--text);\n font-size: 0.61rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-lens-kind em {\n color: var(--lens-color);\n font-size: 0.54rem;\n font-style: normal;\n font-weight: 800;\n }\n .semantic-lens-status {\n min-height: 2.5rem;\n margin: 0;\n padding: 0.55rem 0.78rem;\n border-top: 1px solid var(--toolbar-border);\n color: var(--text-faint);\n font-size: 0.55rem;\n line-height: 1.45;\n }\n .semantic-lens-status strong { color: var(--database-stroke); font-weight: 800; }\n .semantic-lens-actions {\n display: flex;\n justify-content: flex-end;\n gap: 0.28rem;\n padding: 0 0.62rem 0.62rem;\n }\n .semantic-lens-actions button {\n min-height: 1.8rem;\n padding: 0.28rem 0.48rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 0.56rem;\n cursor: pointer;\n }\n .semantic-lens-actions button:hover { background: var(--toolbar-hover); }\n .semantic-lens-actions #semantic-lens-copy { color: var(--database-stroke); }\n @keyframes archify-lens-in {\n from { opacity: 0; transform: translateY(5px) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n\n /* Route Probe answers a reader question over the compiled semantic graph:\n choose two stable nodes and reveal the shortest authored directed route.\n The receipt and signal live entirely in the viewer layer. */\n .route-probe {\n position: absolute;\n left: 1rem;\n bottom: calc(1rem + var(--archify-nav-reserve));\n z-index: 12;\n width: min(46rem, calc(100% - 25rem));\n min-width: 18rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 62%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(115deg, color-mix(in srgb, var(--backend-fill) 50%, transparent), transparent 62%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.625rem;\n }\n .route-probe[hidden] { display: none; }\n .route-probe[data-route-dock=\"top\"] {\n top: 1rem;\n bottom: auto;\n }\n html[data-preset=\"blueprint\"] .route-probe { border-radius: 0.25rem; }\n .route-probe-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.65rem;\n padding: 0.52rem 0.58rem 0.44rem;\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 80%, transparent);\n }\n .route-probe-copy { min-width: 0; }\n .route-probe-eyebrow {\n display: block;\n color: var(--backend-stroke);\n font-size: 0.48rem;\n font-weight: 800;\n letter-spacing: 0.15em;\n text-transform: uppercase;\n }\n .route-probe-title {\n display: block;\n margin-top: 0.14rem;\n overflow: hidden;\n color: var(--toolbar-text);\n font-size: 0.72rem;\n line-height: 1.25;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .route-probe-actions { display: flex; gap: 0.2rem; }\n .route-probe button {\n min-height: 1.55rem;\n padding: 0.25rem 0.42rem;\n border: 0;\n border-radius: 0.36rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n cursor: pointer;\n }\n .route-probe button:hover,\n .route-probe button:focus-visible { background: var(--toolbar-hover); }\n .route-probe button:focus-visible {\n outline: 2px solid var(--backend-stroke);\n outline-offset: 1px;\n }\n .route-probe-copy-link { color: var(--frontend-stroke) !important; }\n .route-probe-find { color: var(--backend-stroke) !important; }\n .route-probe-copy-link[hidden] { display: none; }\n .route-probe-find[hidden] { display: none; }\n .route-probe-path {\n display: flex;\n align-items: center;\n min-height: 2.2rem;\n padding: 0.42rem 0.58rem 0.24rem;\n overflow-x: auto;\n scrollbar-width: thin;\n white-space: nowrap;\n }\n .route-probe-node,\n .route-probe button.route-probe-node {\n flex: none;\n max-width: 9.5rem;\n overflow: hidden;\n min-height: 1.75rem !important;\n padding: 0.22rem 0.38rem;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 46%, var(--toolbar-border));\n border-radius: 999px;\n background: color-mix(in srgb, var(--backend-fill) 52%, transparent);\n color: var(--text);\n font-size: 0.56rem;\n font-weight: 700;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .route-probe-node[data-endpoint=\"start\"] {\n border-color: var(--frontend-stroke);\n color: var(--frontend-stroke);\n }\n .route-probe-node[data-endpoint=\"end\"] {\n border-color: var(--security-stroke);\n color: var(--security-stroke);\n }\n .route-probe-node[data-route-journey-state=\"past\"] { opacity: 0.66; }\n .route-probe-node[data-route-journey-state=\"future\"] { opacity: 0.48; }\n .route-probe-node[aria-current=\"step\"] {\n border-color: var(--backend-stroke);\n background: color-mix(in srgb, var(--backend-fill) 82%, var(--toolbar-menu-bg));\n color: var(--text);\n box-shadow: 0 0 0 1px color-mix(in srgb, var(--backend-stroke) 42%, transparent), 0 0 14px color-mix(in srgb, var(--backend-stroke) 34%, transparent);\n opacity: 1;\n }\n html[data-preset=\"blueprint\"] .route-probe-node[aria-current=\"step\"] {\n border-style: double;\n border-width: 3px;\n border-radius: 0.2rem;\n box-shadow: none;\n }\n .route-probe-arrow {\n flex: none;\n padding: 0 0.28rem;\n color: var(--text-faint);\n font-size: 0.65rem;\n }\n .route-probe-placeholder {\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.03em;\n }\n .route-probe-status {\n display: block;\n min-height: 1.45rem;\n padding: 0.08rem 0.58rem 0.44rem;\n color: var(--text-faint);\n font-size: 0.52rem;\n line-height: 1.35;\n }\n .route-journey-controls {\n display: grid;\n grid-template-columns: 2rem minmax(5.8rem, auto) 2rem minmax(4.8rem, auto);\n justify-content: start;\n gap: 0.22rem;\n padding: 0.08rem 0.58rem 0.28rem;\n }\n .route-journey-controls[hidden] { display: none; }\n .route-journey-controls button {\n min-height: 1.8rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent);\n background: color-mix(in srgb, var(--toolbar-bg) 72%, transparent);\n font-size: 0.54rem;\n font-weight: 700;\n }\n .route-journey-controls button:disabled {\n cursor: default;\n opacity: 0.34;\n }\n .route-journey-play { color: var(--backend-stroke) !important; }\n .route-journey-overview { color: var(--frontend-stroke) !important; }\n .route-journey-controls[data-playing=\"true\"] .route-journey-play {\n border-color: color-mix(in srgb, var(--backend-stroke) 64%, var(--toolbar-border));\n background: color-mix(in srgb, var(--backend-fill) 62%, transparent);\n }\n .route-probe[data-state=\"error\"] {\n border-color: color-mix(in srgb, var(--security-stroke) 72%, var(--toolbar-border));\n }\n .route-probe[data-state=\"error\"] .route-probe-status { color: var(--security-stroke); }\n\n .focus-chip {\n position: absolute;\n left: 1rem;\n top: 1rem;\n z-index: 12;\n display: block;\n width: min(22rem, calc(100% - 13rem));\n max-width: calc(100% - 13rem);\n overflow: hidden;\n border: 1px solid var(--frontend-stroke);\n border-radius: 0.85rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.3);\n backdrop-filter: blur(16px);\n font-size: 0.6875rem;\n }\n .focus-chip[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .focus-chip { border-radius: 0.3rem; }\n .focus-chip button {\n flex: none;\n padding: 0.3rem 0.45rem;\n border-radius: 0.35rem;\n font-size: 0.625rem;\n }\n .relationship-lens-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 0.75rem;\n padding: 0.7rem 0.75rem 0.65rem;\n border-bottom: 1px solid var(--toolbar-border);\n background: linear-gradient(120deg, color-mix(in srgb, var(--frontend-fill) 34%, transparent), transparent 72%);\n }\n .relationship-lens-copy { min-width: 0; }\n .relationship-lens-actions {\n display: flex;\n flex-direction: column;\n align-items: flex-end;\n gap: 0.18rem;\n }\n .relationship-lens-actions button { white-space: nowrap; }\n .relationship-lens-actions #btn-focus-clear {\n display: grid;\n width: 1.75rem;\n height: 1.75rem;\n padding: 0;\n place-items: center;\n color: var(--text-muted);\n font-size: 1rem;\n line-height: 1;\n }\n .relationship-lens-actions #btn-focus-clear:hover,\n .relationship-lens-actions #btn-focus-clear:focus-visible {\n background: var(--toolbar-hover);\n color: var(--text);\n }\n .relationship-lens-actions #btn-focus-copy { color: var(--frontend-stroke); }\n .relationship-lens-actions #btn-focus-relations { display: none; }\n .relationship-lens-eyebrow {\n display: block;\n margin-bottom: 0.18rem;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.14em;\n text-transform: uppercase;\n }\n .relationship-lens-title {\n display: block;\n overflow: hidden;\n color: var(--text);\n font-size: 0.8rem;\n line-height: 1.35;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-detail {\n display: block;\n margin-top: 0.12rem;\n overflow: hidden;\n color: var(--text-muted);\n font-size: 0.625rem;\n line-height: 1.4;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-detail[hidden] { display: none; }\n .semantic-passport-meta {\n display: flex;\n flex-wrap: wrap;\n gap: 0.24rem;\n margin-top: 0.42rem;\n }\n .semantic-passport-meta span,\n .semantic-passport-meta code {\n max-width: 100%;\n overflow: hidden;\n padding: 0.14rem 0.34rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 82%, transparent);\n border-radius: 999px;\n background: color-mix(in srgb, var(--panel) 68%, transparent);\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5rem;\n letter-spacing: 0.04em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-meta [data-passport=\"kind\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 50%, var(--toolbar-border));\n color: var(--frontend-stroke);\n font-weight: 800;\n text-transform: uppercase;\n }\n .semantic-passport-meta [data-passport=\"tag\"] { color: var(--cloud-stroke); }\n .semantic-passport-meta [data-passport=\"brand\"] {\n border-color: color-mix(in srgb, var(--messagebus-stroke) 52%, var(--toolbar-border));\n color: var(--messagebus-stroke);\n font-weight: 700;\n }\n .semantic-passport-meta [hidden] { display: none; }\n html[data-preset=\"blueprint\"] .semantic-passport-meta span,\n html[data-preset=\"blueprint\"] .semantic-passport-meta code { border-radius: 0.1rem; }\n .semantic-passport-evidence {\n margin-top: 0.52rem;\n padding: 0.5rem;\n border: 1px solid color-mix(in srgb, var(--backend-stroke) 32%, var(--toolbar-border));\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--backend-fill) 18%, var(--panel));\n }\n .semantic-passport-evidence[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .semantic-passport-evidence { border-radius: 0.18rem; }\n .semantic-passport-evidence-head {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.55rem;\n margin-bottom: 0.35rem;\n }\n .semantic-passport-evidence-status {\n display: inline-flex;\n align-items: center;\n gap: 0.28rem;\n color: var(--backend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .semantic-passport-evidence-status::before {\n content: '';\n width: 0.38rem;\n height: 0.38rem;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 0 3px color-mix(in srgb, var(--backend-stroke) 14%, transparent);\n }\n .semantic-passport-repository {\n min-width: 0;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n text-decoration: none;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-repository:hover,\n .semantic-passport-repository:focus-visible { color: var(--backend-stroke); }\n .semantic-passport-evidence-links { display: grid; gap: 0.22rem; }\n .semantic-passport-source {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.15rem 0.45rem;\n align-items: center;\n padding: 0.34rem 0.4rem;\n border: 1px solid transparent;\n border-radius: 0.38rem;\n color: var(--text-muted);\n text-decoration: none;\n }\n .semantic-passport-source:hover,\n .semantic-passport-source:focus-visible {\n border-color: color-mix(in srgb, var(--backend-stroke) 42%, transparent);\n background: color-mix(in srgb, var(--backend-fill) 32%, transparent);\n color: var(--text);\n }\n .semantic-passport-source strong {\n overflow: hidden;\n font-size: 0.5625rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .semantic-passport-source code {\n color: var(--backend-stroke);\n font: inherit;\n font-size: 0.5rem;\n }\n .semantic-passport-source small {\n grid-column: 1 / -1;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-summary {\n display: block;\n margin-top: 0.12rem;\n color: var(--text-faint);\n font-size: 0.5625rem;\n }\n .semantic-passport-reach {\n display: grid;\n gap: 0.28rem;\n margin-top: 0.52rem;\n padding-top: 0.48rem;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 76%, transparent);\n }\n .semantic-passport-reach[hidden] { display: none; }\n .semantic-passport-reach-label {\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.1em;\n text-transform: uppercase;\n }\n .semantic-passport-reach-actions {\n display: grid;\n grid-template-columns: repeat(2, minmax(0, 1fr));\n gap: 0.25rem;\n }\n .semantic-passport-reach-actions button {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n min-width: 0;\n min-height: 2rem;\n padding: 0.32rem 0.42rem;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent);\n background: color-mix(in srgb, var(--panel) 70%, transparent);\n color: var(--text-muted);\n text-align: left;\n }\n .semantic-passport-reach-actions button:hover:not(:disabled),\n .semantic-passport-reach-actions button:focus-visible {\n border-color: color-mix(in srgb, var(--frontend-stroke) 62%, var(--toolbar-border));\n color: var(--text);\n }\n .semantic-passport-reach-actions button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .semantic-passport-reach-actions button:disabled {\n cursor: default;\n opacity: 0.5;\n }\n .semantic-passport-reach-actions button[aria-pressed=\"true\"] {\n border-color: color-mix(in srgb, var(--reach-color, var(--frontend-stroke)) 72%, var(--toolbar-border));\n background: color-mix(in srgb, var(--reach-fill, var(--frontend-fill)) 48%, transparent);\n color: var(--text);\n }\n #btn-reach-upstream {\n --reach-color: var(--database-stroke);\n --reach-fill: var(--database-fill);\n }\n #btn-reach-downstream {\n --reach-color: var(--backend-stroke);\n --reach-fill: var(--backend-fill);\n }\n .semantic-passport-reach-actions strong {\n color: var(--reach-color, var(--frontend-stroke));\n font-size: 0.625rem;\n }\n .semantic-passport-reach-status {\n color: var(--text-faint);\n font-size: 0.525rem;\n line-height: 1.4;\n }\n .semantic-passport-reach-status[hidden] { display: none; }\n .relationship-lens-list {\n max-height: min(18rem, 46vh);\n overflow: auto;\n padding: 0.4rem;\n scrollbar-width: thin;\n scrollbar-color: var(--frontend-stroke) transparent;\n }\n .relationship-lens-list::-webkit-scrollbar { width: 4px; }\n .relationship-lens-list::-webkit-scrollbar-thumb {\n border-radius: 999px;\n background: color-mix(in srgb, var(--frontend-stroke) 68%, transparent);\n }\n .relationship-lens-group + .relationship-lens-group { margin-top: 0.35rem; }\n .relationship-lens-group-title {\n display: block;\n padding: 0.24rem 0.38rem 0.16rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .relationship-lens-row {\n display: grid;\n grid-template-columns: 2.1rem minmax(0, 1fr);\n gap: 0.06rem 0.45rem;\n width: 100%;\n padding: 0.45rem 0.5rem !important;\n text-align: left;\n }\n .relationship-lens-row:hover,\n .relationship-lens-row:focus-visible,\n .relationship-lens-row[data-preview-active=\"true\"] {\n background: var(--toolbar-hover);\n box-shadow: inset 2px 0 0 var(--frontend-stroke);\n }\n .relationship-lens-row:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: -2px;\n }\n .relationship-lens-direction {\n grid-row: 1 / 3;\n align-self: center;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n }\n .relationship-lens-row[data-direction=\"in\"] .relationship-lens-direction { color: var(--database-stroke); }\n .relationship-lens-row[data-direction=\"loop\"] .relationship-lens-direction { color: var(--security-stroke); }\n .relationship-lens-row strong {\n overflow: hidden;\n color: var(--text);\n font-size: 0.6875rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-row small {\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5625rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .relationship-lens-empty {\n margin: 0;\n padding: 0.75rem;\n color: var(--text-faint);\n font-size: 0.625rem;\n text-align: center;\n }\n\n /* Diagram Guide keeps the artifact's growing reader vocabulary\n discoverable without widening the permanent control bar. It derives\n honest counts at runtime and delegates every action to an existing\n production interaction instead of creating a second command system. */\n .diagram-guide {\n position: absolute;\n top: 1rem;\n right: 1rem;\n z-index: 26;\n width: min(32rem, calc(100% - 2rem));\n max-height: min(42rem, calc(100% - 2rem));\n overflow: auto;\n border: 1px solid color-mix(in srgb, var(--cloud-stroke) 58%, var(--toolbar-border));\n border-radius: 0.82rem;\n background:\n linear-gradient(135deg, color-mix(in srgb, var(--cloud-fill) 32%, transparent), transparent 42%),\n var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 22px 64px rgba(0, 0, 0, 0.4);\n backdrop-filter: blur(18px);\n animation: archify-guide-in 180ms cubic-bezier(0.22, 1, 0.36, 1);\n }\n .diagram-guide[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .diagram-guide { border-radius: 0.28rem; }\n .diagram-guide-head {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n align-items: start;\n gap: 1rem;\n padding: 0.82rem 0.9rem 0.68rem;\n border-bottom: 1px solid var(--toolbar-border);\n }\n .diagram-guide-eyebrow {\n display: block;\n color: var(--cloud-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.16em;\n text-transform: uppercase;\n }\n .diagram-guide-title {\n display: block;\n margin-top: 0.16rem;\n color: var(--text);\n font-size: 0.86rem;\n letter-spacing: -0.02em;\n }\n .diagram-guide-close {\n width: 1.8rem;\n height: 1.8rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .diagram-guide-close:hover,\n .diagram-guide-close:focus-visible { background: var(--toolbar-hover); }\n .diagram-guide-stats {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n margin: 0;\n padding: 0.54rem 0.9rem;\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 74%, transparent);\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.025em;\n }\n .diagram-guide-stats::before {\n content: '';\n width: 0.42rem;\n height: 0.42rem;\n flex: none;\n border-radius: 50%;\n background: var(--backend-stroke);\n box-shadow: 0 0 10px color-mix(in srgb, var(--backend-stroke) 72%, transparent);\n }\n .diagram-guide-actions {\n display: grid;\n grid-template-columns: 1fr 1fr;\n gap: 0.38rem;\n padding: 0.62rem;\n }\n .diagram-guide-action {\n --guide-accent: var(--frontend-stroke);\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.55rem;\n min-height: 4.15rem;\n padding: 0.55rem 0.58rem;\n border: 1px solid color-mix(in srgb, var(--guide-accent) 22%, var(--toolbar-border));\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 78%, transparent);\n color: var(--toolbar-text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: border-color 140ms ease, background 140ms ease, transform 140ms ease;\n }\n .diagram-guide-action[data-guide-action=\"route\"] { --guide-accent: var(--backend-stroke); }\n .diagram-guide-action[data-guide-action=\"map\"] { --guide-accent: var(--database-stroke); }\n .diagram-guide-action[data-guide-action=\"lens\"] { --guide-accent: var(--messagebus-stroke); }\n .diagram-guide-action[data-guide-action=\"story\"] { --guide-accent: var(--security-stroke); }\n .diagram-guide-action[data-guide-action=\"present\"] {\n --guide-accent: var(--cloud-stroke);\n }\n .diagram-guide-action:hover,\n .diagram-guide-action:focus-visible {\n border-color: color-mix(in srgb, var(--guide-accent) 76%, var(--toolbar-border));\n background: color-mix(in srgb, var(--guide-accent) 9%, var(--panel));\n transform: translateY(-1px);\n }\n .diagram-guide-action:focus-visible,\n .diagram-guide-close:focus-visible {\n outline: 2px solid var(--cloud-stroke);\n outline-offset: 1px;\n }\n .diagram-guide-action:disabled {\n opacity: 0.42;\n cursor: default;\n transform: none;\n }\n .diagram-guide-index {\n display: grid;\n place-items: center;\n width: 1.65rem;\n height: 1.65rem;\n border: 1px solid color-mix(in srgb, var(--guide-accent) 64%, var(--toolbar-border));\n border-radius: 0.35rem;\n color: var(--guide-accent);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.06em;\n }\n .diagram-guide-action-copy { min-width: 0; }\n .diagram-guide-action strong {\n display: block;\n overflow: hidden;\n color: var(--text);\n font-size: 0.66rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .diagram-guide-action small {\n display: -webkit-box;\n margin-top: 0.18rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5rem;\n line-height: 1.35;\n -webkit-box-orient: vertical;\n -webkit-line-clamp: 2;\n }\n .diagram-guide kbd {\n align-self: start;\n min-width: 1.45rem;\n padding: 0.12rem 0.3rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.25rem;\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5rem;\n text-align: center;\n }\n .diagram-guide-shortcuts {\n display: flex;\n flex-wrap: wrap;\n gap: 0.34rem 0.62rem;\n padding: 0.58rem 0.9rem 0.68rem;\n border-top: 1px solid var(--toolbar-border);\n color: var(--text-faint);\n font-size: 0.5rem;\n }\n .diagram-guide-shortcuts span {\n display: inline-flex;\n align-items: center;\n gap: 0.28rem;\n white-space: nowrap;\n }\n .diagram-guide-feedback {\n min-height: 1rem;\n margin: -0.18rem 0.9rem 0.62rem;\n color: var(--security-stroke);\n font-size: 0.5rem;\n }\n .diagram-guide-feedback:empty { display: none; }\n @keyframes archify-guide-in {\n from { opacity: 0; transform: translateY(-5px) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n\n .node-finder {\n position: absolute;\n top: 1rem;\n left: 1rem;\n z-index: 24;\n display: flex;\n flex-direction: column;\n width: min(22rem, calc(100% - 2rem));\n max-height: calc(100% - 2rem);\n overflow: hidden;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.85rem;\n background: var(--toolbar-menu-bg);\n color: var(--toolbar-text);\n box-shadow: 0 6px 8px rgba(0, 0, 0, 0.22);\n backdrop-filter: blur(16px);\n }\n .node-finder[hidden] { display: none; }\n .node-finder[data-context=\"route-source\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 68%, var(--toolbar-border));\n }\n .node-finder[data-context=\"route-target\"] {\n border-color: color-mix(in srgb, var(--security-stroke) 68%, var(--toolbar-border));\n }\n html[data-preset=\"blueprint\"] .node-finder { border-radius: 0.3rem; }\n .node-finder-head {\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.7rem 0.8rem 0.45rem;\n }\n .node-finder-head strong {\n color: var(--text);\n font-size: 0.6875rem;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .node-finder[data-context=\"route-source\"] .node-finder-head strong { color: var(--frontend-stroke); }\n .node-finder[data-context=\"route-target\"] .node-finder-head strong { color: var(--security-stroke); }\n .node-finder-close {\n width: 1.75rem;\n height: 1.75rem;\n border: 0;\n border-radius: 0.35rem;\n background: transparent;\n color: var(--toolbar-text);\n font: inherit;\n font-size: 1rem;\n cursor: pointer;\n }\n .node-finder-close:hover,\n .node-finder-close:focus-visible { background: var(--toolbar-hover); }\n .node-finder-close:focus-visible,\n .node-finder-result:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: -2px;\n }\n .node-finder-search {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n align-items: center;\n gap: 0.55rem;\n margin: 0 0.55rem 0.55rem;\n padding: 0 0.7rem;\n min-height: 2.6rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 78%, transparent);\n transition: border-color 160ms ease-out, box-shadow 160ms ease-out;\n }\n html[data-preset=\"blueprint\"] .node-finder-search { border-radius: 0.18rem; }\n .node-finder-search \u003e span { color: var(--frontend-stroke); font-size: 0.875rem; }\n .node-finder-search:focus-within {\n border-color: var(--frontend-stroke);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--frontend-stroke) 20%, transparent);\n }\n .node-finder-input {\n appearance: none;\n width: 100%;\n min-width: 0;\n border: 0;\n outline: 0;\n background: transparent;\n color: var(--text);\n font: inherit;\n font-size: 0.75rem;\n }\n .node-finder-input:focus-visible { outline: none; }\n .node-finder-input::placeholder { color: var(--text-faint); }\n .node-finder kbd {\n padding: 0.1rem 0.32rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.25rem;\n color: var(--text-faint);\n font: inherit;\n font-size: 0.5625rem;\n }\n .node-finder-results {\n display: grid;\n flex: 1 1 auto;\n gap: 0;\n min-height: 0;\n max-height: min(18rem, 48vh);\n margin: 0 0.55rem 0.45rem;\n padding: 0;\n overflow-y: auto;\n overscroll-behavior: contain;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 78%, transparent);\n border-radius: 0.55rem;\n background: color-mix(in srgb, var(--panel) 54%, transparent);\n scroll-padding-block: 0.25rem;\n scrollbar-width: thin;\n }\n html[data-preset=\"blueprint\"] .node-finder-results { border-radius: 0.18rem; }\n .node-finder-result {\n display: grid;\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.2rem 0.75rem;\n width: 100%;\n min-height: 3.25rem;\n padding: 0.58rem 0.65rem;\n border: 0;\n border-radius: 0;\n background: transparent;\n color: var(--text);\n font: inherit;\n text-align: left;\n cursor: pointer;\n transition: background-color 160ms ease-out;\n }\n .node-finder-result:not(:last-child) {\n border-bottom: 1px solid color-mix(in srgb, var(--toolbar-border) 62%, transparent);\n }\n .node-finder-result:hover,\n .node-finder-result:focus-visible {\n position: relative;\n z-index: 1;\n background: color-mix(in srgb, var(--frontend-fill) 48%, var(--toolbar-hover));\n }\n .node-finder-result strong {\n overflow: hidden;\n font-size: 0.75rem;\n line-height: 1.25;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .node-finder-result small {\n grid-column: 1 / -1;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.5625rem;\n letter-spacing: 0.015em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .node-finder-result em {\n align-self: center;\n color: var(--frontend-stroke);\n font-size: 0.625rem;\n font-style: normal;\n }\n .node-finder[data-context^=\"route-\"] .node-finder-result em {\n padding: 0.1rem 0.3rem;\n border: 1px solid color-mix(in srgb, currentColor 52%, transparent);\n border-radius: 999px;\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.05em;\n text-transform: uppercase;\n }\n .node-finder[data-context=\"route-target\"] .node-finder-result em { color: var(--security-stroke); }\n .node-finder-empty {\n padding: 1.1rem 0.75rem 1.25rem;\n color: var(--text-faint);\n font-size: 0.6875rem;\n text-align: center;\n }\n .node-finder-status {\n margin: 0;\n padding: 0.1rem 0.8rem 0.65rem;\n color: var(--text-faint);\n font-size: 0.5625rem;\n }\n\n .guided-views {\n display: grid;\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem auto;\n align-items: stretch;\n gap: 0.35rem;\n min-width: 0;\n margin: 0 0 0.75rem;\n padding: 0.35rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.85rem;\n background: var(--toolbar-bg);\n background: linear-gradient(120deg, var(--toolbar-bg), color-mix(in srgb, var(--toolbar-bg) 82%, var(--frontend-fill)));\n box-shadow: 0 12px 36px rgba(0, 0, 0, 0.16);\n backdrop-filter: blur(12px);\n }\n .guided-views[hidden] { display: none; }\n\n html[data-preset=\"blueprint\"] .guided-views {\n border-color: var(--panel-border);\n border-radius: 0.35rem;\n background:\n linear-gradient(90deg, color-mix(in srgb, var(--frontend-fill) 36%, transparent), transparent 24%),\n var(--toolbar-bg);\n box-shadow: 0 12px 28px rgba(0, 0, 0, 0.12);\n }\n html[data-preset=\"blueprint\"] .guided-views button { border-radius: 0.2rem; }\n html[data-preset=\"blueprint\"] .guided-view-progress { border-radius: 0; }\n html[data-preset=\"blueprint\"] .guided-view-progress span { border-radius: 0; }\n .guided-views button {\n min-width: 0;\n padding: 0.45rem 0.6rem;\n border-radius: 0.55rem;\n font-size: 0.75rem;\n }\n .guided-views \u003e #guided-view-prev,\n .guided-views \u003e #guided-view-next { min-width: 2.75rem; min-height: 2.75rem; }\n .guided-views button:disabled { opacity: 0.3; cursor: default; }\n .guided-view-copy {\n min-width: 0;\n padding: 0.2rem 0.5rem;\n border-left: 1px solid var(--toolbar-border);\n overflow: hidden;\n }\n .guided-view-meta {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n min-height: 1rem;\n margin-bottom: 0.12rem;\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 700;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .guided-view-handoff {\n box-sizing: border-box;\n height: 1rem;\n min-width: 0;\n max-width: 15rem;\n overflow: hidden;\n padding: 0 0.38rem;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 46%, transparent);\n border-radius: 999px;\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-fill) 44%, transparent);\n font-size: 0.5rem;\n line-height: calc(1rem - 2px);\n letter-spacing: 0.06em;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-view-handoff[hidden] { display: none; }\n html[data-preset=\"blueprint\"] .guided-view-handoff { border-radius: 0.15rem; }\n .chapter-handoff-overlay { pointer-events: none; }\n .chapter-handoff-anchor {\n fill: color-mix(in srgb, var(--frontend-fill) 10%, transparent);\n stroke: var(--frontend-stroke);\n stroke-width: 2;\n stroke-dasharray: 4 4;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n animation: archify-chapter-anchor 0.42s cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"stay\"] { opacity: 1; }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"enter\"] { opacity: 0.78; }\n svg[data-chapter-handoff] [data-node-id][data-chapter-role=\"leave\"] { opacity: 0.26; }\n @keyframes archify-chapter-anchor {\n 0% { opacity: 0.35; stroke-dashoffset: 8; }\n 45% { opacity: 1; }\n 100% { opacity: 0.72; stroke-dashoffset: 0; }\n }\n .guided-view-progress {\n width: 3.5rem;\n height: 2px;\n overflow: hidden;\n border-radius: 999px;\n background: var(--toolbar-border);\n }\n .guided-view-progress span {\n display: block;\n width: 100%;\n height: 100%;\n border-radius: inherit;\n background: var(--frontend-stroke);\n transform: scaleX(0);\n transform-origin: left center;\n }\n .guided-view-copy strong,\n .guided-view-copy small { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n .guided-view-copy strong { color: var(--toolbar-text); font-size: 0.75rem; line-height: 1.35; }\n .guided-view-copy small { margin-top: 0; color: var(--text-muted); font-size: 0.625rem; line-height: 1.35; }\n .guided-story-caption {\n display: grid;\n grid-template-columns: auto minmax(0, 1fr) auto;\n gap: 0.12rem 0.55rem;\n align-items: center;\n min-width: 0;\n margin-top: 0.18rem;\n padding: 0.3rem 0.5rem;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 32%, var(--toolbar-border));\n border-radius: 0.58rem;\n background: color-mix(in srgb, var(--frontend-fill) 26%, transparent);\n animation: archify-story-caption-in 140ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n .guided-story-caption[hidden] { display: none; }\n .guided-story-caption-index {\n grid-row: 1 / span 2;\n align-self: stretch;\n display: inline-grid;\n min-width: 3.3rem;\n place-items: center;\n padding-right: 0.52rem;\n border-right: 1px solid color-mix(in srgb, var(--frontend-stroke) 28%, var(--toolbar-border));\n color: var(--frontend-stroke);\n font-size: 0.5625rem;\n font-weight: 800;\n letter-spacing: 0.08em;\n text-transform: uppercase;\n }\n .guided-story-caption strong,\n .guided-story-caption small {\n display: block;\n min-width: 0;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-story-caption strong { color: var(--toolbar-text); font-size: 0.6875rem; line-height: 1.3; }\n .guided-story-caption small { color: var(--text-muted); font-size: 0.5625rem; line-height: 1.35; }\n .guided-story-caption-next {\n grid-column: 3;\n grid-row: 1 / span 2;\n display: grid;\n min-width: 6.4rem;\n max-width: 9.5rem;\n align-self: stretch;\n align-content: center;\n padding-left: 0.58rem;\n border-left: 1px solid color-mix(in srgb, var(--frontend-stroke) 22%, var(--toolbar-border));\n }\n .guided-story-caption-next[hidden] { display: none; }\n .guided-story-caption-next small {\n color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--text-muted));\n font-weight: 800;\n letter-spacing: 0.09em;\n text-transform: uppercase;\n }\n .guided-story-caption-next strong { color: var(--text-muted); font-weight: 700; }\n html[data-preset=\"blueprint\"] .guided-story-caption { border-radius: 0.2rem; }\n .guided-views[data-story-beat] .guided-view-copy \u003e #guided-view-label,\n .guided-views[data-story-beat] .guided-view-copy \u003e #guided-view-note { display: none; }\n @keyframes archify-story-caption-in {\n from { opacity: 0; transform: translateY(3px); }\n to { opacity: 1; transform: translateY(0); }\n }\n .guided-view-trail {\n display: flex;\n align-items: center;\n gap: 0.28rem;\n min-width: 0;\n min-height: 1.7rem;\n margin-top: 0;\n padding: 0;\n overflow-x: auto;\n color: var(--text-faint);\n overscroll-behavior-x: contain;\n touch-action: pan-x;\n scrollbar-width: none;\n white-space: nowrap;\n }\n .guided-view-trail[hidden] { display: none; }\n .guided-view-trail::-webkit-scrollbar { display: none; }\n .guided-view-trail .guided-view-stop {\n appearance: none;\n box-sizing: border-box;\n display: inline-flex;\n flex: 0 0 auto;\n align-items: center;\n gap: 0.28rem;\n min-height: 1.5rem;\n padding: 0.1rem 0.3rem 0.1rem 0.18rem;\n border: 1px solid transparent;\n border-radius: 999px;\n background: transparent;\n color: var(--text-muted);\n cursor: pointer;\n font-family: inherit;\n font-size: 0.5625rem;\n font-weight: 650;\n letter-spacing: 0.02em;\n line-height: 1;\n transition: background 140ms ease, border-color 140ms ease, color 140ms ease, opacity 140ms ease;\n }\n .guided-view-stop:hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 36%, transparent);\n background: color-mix(in srgb, var(--frontend-fill) 34%, transparent);\n }\n .guided-view-stop:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .guided-view-stop:disabled { cursor: wait; }\n .guided-view-stop::before {\n display: inline-grid;\n width: 1rem;\n height: 1rem;\n place-items: center;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 54%, var(--toolbar-border));\n border-radius: 50%;\n background: color-mix(in srgb, var(--frontend-fill) 58%, var(--toolbar-bg));\n color: var(--frontend-stroke);\n content: attr(data-story-number);\n font-size: 0.5rem;\n line-height: 1;\n }\n .guided-view-stop + .guided-view-stop::after {\n order: -1;\n color: color-mix(in srgb, var(--frontend-stroke) 58%, var(--text-faint));\n content: '\\00b7';\n font-size: 0.65rem;\n }\n .guided-view-stop[data-story-link=\"forward\"]::after { content: '\\2192'; }\n .guided-view-stop[data-story-link=\"reverse\"]::after { content: '\\2190'; }\n .guided-view-stop[data-story-link=\"multiple\"]::after { content: '\\21c4'; }\n .guided-view-stop[data-story-beat-state=\"pending\"] { opacity: 0.38; }\n .guided-view-stop[data-story-beat-state=\"next\"] {\n border-style: dashed;\n border-color: color-mix(in srgb, var(--frontend-stroke) 42%, var(--toolbar-border));\n color: color-mix(in srgb, var(--toolbar-text) 68%, var(--text-muted));\n opacity: 0.58;\n }\n .guided-view-stop[data-story-beat-state=\"past\"] { color: var(--text-muted); opacity: 0.76; }\n .guided-view-stop[data-story-beat-state=\"active\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--toolbar-border));\n background: color-mix(in srgb, var(--frontend-fill) 42%, transparent);\n color: var(--toolbar-text);\n font-weight: 800;\n opacity: 1;\n }\n .guided-view-stop[data-story-beat-state=\"active\"]::before {\n border-color: var(--frontend-stroke);\n box-shadow: 0 0 10px color-mix(in srgb, var(--frontend-stroke) 54%, transparent);\n }\n html[data-preset=\"blueprint\"] .guided-view-stop,\n html[data-preset=\"blueprint\"] .guided-view-stop::before { border-radius: 0.1rem; }\n html[data-preset=\"blueprint\"] .guided-view-stop[data-story-beat-state=\"active\"]::before { box-shadow: none; }\n .guided-view-actions { display: flex; align-items: stretch; gap: 0.2rem; }\n .guided-view-actions button { white-space: nowrap; }\n .guided-view-play {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.38rem;\n min-width: 6.25rem !important;\n color: var(--frontend-stroke) !important;\n font-size: 0.625rem !important;\n }\n .guided-view-play[aria-pressed=\"true\"] { background: var(--toolbar-hover); }\n .guided-view-all { min-width: 3.25rem !important; color: var(--text-muted) !important; font-size: 0.625rem !important; }\n .guided-view-beat-link {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 0.3rem;\n min-width: 5.4rem !important;\n min-height: 1.5rem;\n color: var(--text-muted) !important;\n font-size: 0.5625rem !important;\n letter-spacing: 0.025em;\n transition: background 140ms ease, border-color 140ms ease, color 140ms ease;\n }\n .guided-view-beat-link:not(:disabled):hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));\n color: var(--frontend-stroke) !important;\n }\n .guided-view-beat-link[data-copy-state=\"copied\"] {\n border-color: color-mix(in srgb, var(--backend-stroke) 58%, var(--toolbar-border));\n background: color-mix(in srgb, var(--backend-fill) 46%, transparent);\n color: var(--backend-stroke) !important;\n }\n .guided-view-index {\n grid-column: 1 / -1;\n min-width: 0;\n padding: 0.28rem 0.12rem 0.08rem;\n overflow: hidden;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n @media (min-width: 721px) {\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-index,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-beat-link,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-all,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-trail,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-copy \u003e #guided-view-label,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-view-copy \u003e #guided-view-note { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views[data-playing=\"true\"] .guided-story-caption { margin-top: 0.08rem; }\n }\n .guided-view-chapters {\n display: flex;\n gap: 0.28rem;\n min-width: 0;\n margin: 0;\n padding: 0.08rem 0.05rem 0.2rem;\n overflow-x: auto;\n list-style: none;\n scroll-padding-inline: 0.05rem;\n scroll-snap-type: x proximity;\n scrollbar-width: none;\n }\n .guided-view-chapters::-webkit-scrollbar { display: none; }\n .guided-view-chapters li {\n display: flex;\n flex: 1 1 0;\n min-width: 9.5rem;\n scroll-snap-align: center;\n }\n .guided-view-chapter {\n position: relative;\n display: grid !important;\n grid-template-columns: 1.55rem minmax(0, 1fr) auto;\n align-items: center;\n width: 100%;\n min-height: 2.75rem;\n padding: 0.36rem 0.48rem !important;\n overflow: hidden;\n border: 1px solid color-mix(in srgb, var(--toolbar-border) 86%, transparent) !important;\n border-radius: 0.48rem !important;\n background: color-mix(in srgb, var(--toolbar-bg) 88%, transparent) !important;\n color: var(--text-muted) !important;\n text-align: left;\n transition: background 0.16s ease, border-color 0.16s ease, opacity 0.16s ease;\n }\n .guided-view-chapter:hover {\n border-color: color-mix(in srgb, var(--frontend-stroke) 58%, var(--toolbar-border)) !important;\n background: color-mix(in srgb, var(--frontend-fill) 42%, var(--toolbar-bg)) !important;\n }\n .guided-view-chapter:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 1px;\n }\n .guided-view-chapter-index {\n display: inline-grid;\n width: 1.32rem;\n height: 1.32rem;\n place-items: center;\n border: 1px solid color-mix(in srgb, var(--frontend-stroke) 48%, var(--toolbar-border));\n border-radius: 50%;\n color: var(--frontend-stroke);\n font-size: 0.5rem;\n font-weight: 800;\n letter-spacing: 0.03em;\n }\n .guided-view-chapter-title {\n min-width: 0;\n overflow: hidden;\n color: var(--toolbar-text);\n font-size: 0.625rem;\n font-weight: 700;\n line-height: 1.3;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .guided-view-chapter-count {\n grid-column: 3;\n grid-row: 1;\n margin-left: 0.38rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-style: normal;\n font-weight: 650;\n white-space: nowrap;\n }\n .guided-view-chapter-delta {\n display: inline-flex;\n grid-column: 3;\n grid-row: 1;\n align-items: center;\n gap: 0.22rem;\n margin-left: 0.38rem;\n color: var(--text-faint);\n font-size: 0.5rem;\n font-weight: 750;\n letter-spacing: 0.01em;\n white-space: nowrap;\n }\n .guided-view-chapter-delta[hidden] { display: none; }\n .guided-view-chapter-delta [data-delta-kind=\"stay\"] { color: var(--text-muted); }\n .guided-view-chapter-delta [data-delta-kind=\"enter\"] { color: var(--frontend-stroke); }\n .guided-view-chapter-delta [data-delta-kind=\"leave\"] { color: var(--security-stroke); }\n .guided-view-chapter[data-preview-active=\"true\"] {\n border-color: color-mix(in srgb, var(--frontend-stroke) 72%, var(--toolbar-border)) !important;\n background: color-mix(in srgb, var(--frontend-fill) 54%, var(--toolbar-bg)) !important;\n }\n .guided-view-chapter[data-chapter-position=\"current\"] {\n border: 2px solid var(--frontend-stroke) !important;\n padding: calc(0.36rem - 1px) calc(0.48rem - 1px) !important;\n box-shadow: inset 3px 0 0 var(--frontend-stroke);\n color: var(--toolbar-text) !important;\n }\n .guided-view-chapter[data-chapter-position=\"current\"] .guided-view-chapter-index {\n background: var(--frontend-stroke);\n color: var(--bg);\n }\n .guided-view-chapter[data-chapter-position=\"before\"] {\n border-style: solid !important;\n opacity: 0.72;\n }\n .guided-view-chapter[data-chapter-position=\"after\"] { border-style: dashed !important; }\n html[data-preset=\"signal-flow\"] .guided-view-chapter[data-chapter-position=\"current\"] {\n box-shadow: inset 3px 0 0 var(--frontend-stroke), 0 0 18px color-mix(in srgb, var(--frontend-stroke) 18%, transparent);\n }\n html[data-preset=\"blueprint\"] .guided-view-chapter,\n html[data-preset=\"blueprint\"] .guided-view-chapter-index { border-radius: 0.12rem !important; }\n\n /* Story Shelf — keep every authored chapter and the Play action visible,\n but do not spend a second row on unavailable director controls before\n the reader enters a chapter. Existing data-active-view state expands\n the full guided surface without a new toggle or stored preference. */\n .guided-views[data-active-view=\"all\"] {\n grid-template-columns: minmax(11rem, .72fr) auto minmax(0, 2fr);\n align-items: center;\n padding: 0.28rem 0.35rem;\n }\n .guided-views[data-active-view=\"all\"] \u003e #guided-view-prev,\n .guided-views[data-active-view=\"all\"] \u003e #guided-view-next,\n .guided-views[data-active-view=\"all\"] .guided-view-beat-link,\n .guided-views[data-active-view=\"all\"] .guided-view-all { display: none; }\n .guided-views[data-active-view=\"all\"] .guided-view-copy {\n grid-column: 1;\n grid-row: 1;\n padding: 0.1rem 0.55rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-copy \u003e #guided-view-note { display: none; }\n .guided-views[data-active-view=\"all\"] .guided-view-actions {\n display: block;\n grid-column: 2;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-play { min-height: 2.75rem; }\n .guided-views[data-active-view=\"all\"] .guided-view-index {\n grid-column: 3;\n grid-row: 1;\n padding: 0 0.08rem 0 0.42rem;\n border-top: 0;\n border-left: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n }\n .guided-views[data-active-view=\"all\"] .guided-view-chapters {\n gap: 0.3rem;\n padding: 0;\n }\n\n .cards {\n display: grid;\n grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));\n gap: 1rem;\n margin-top: 2rem;\n }\n\n .card {\n background: var(--panel);\n border-radius: 0.75rem;\n border: 1px solid var(--panel-border);\n padding: 1.25rem;\n }\n\n html[data-preset=\"signal-flow\"] .card {\n background: linear-gradient(145deg, rgba(10, 24, 43, 0.86), rgba(5, 12, 24, 0.92));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.035);\n }\n html[data-preset=\"signal-flow\"][data-theme=\"light\"] .card {\n background: linear-gradient(145deg, rgba(255, 255, 255, 0.92), rgba(237, 246, 250, 0.9));\n box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.82), 0 12px 32px rgba(45, 78, 99, 0.08);\n }\n\n /* Preserve the one-screen guarantee on ordinary laptop displays. The\n high-screen expansion above must not trade a fuller canvas for page\n scrolling at 900–1080px heights. */\n @media (min-width: 768px) and (max-height: 1100px) {\n .header { margin-bottom: 1rem; }\n .diagram-container {\n padding: 0.875rem;\n padding-bottom: calc(0.875rem + var(--archify-nav-reserve));\n }\n .cards { margin-top: 1rem; }\n .card { padding: 1rem; }\n }\n @media (min-width: 768px) and (max-height: 920px) {\n body { padding-block: 1.25rem; }\n .header { margin-bottom: 0.875rem; }\n .cards { margin-top: 0.75rem; }\n html[data-nav-stage-rail=\"true\"] body { padding-block: 0.375rem; }\n html[data-nav-stage-rail=\"true\"] .header { margin-bottom: 0.5rem; }\n html[data-nav-stage-rail=\"true\"] .guided-views { margin-bottom: 0.375rem; }\n html[data-nav-stage-rail=\"true\"] .diagram-container[data-nav-stage-rail=\"true\"] { padding-top: 0.5rem; }\n html[data-nav-stage-rail=\"true\"] .cards { margin-top: 0.375rem; }\n }\n\n html[data-preset=\"blueprint\"] .card {\n position: relative;\n border-color: var(--panel-border);\n border-radius: 0.3rem;\n background: var(--panel);\n box-shadow: none;\n }\n html[data-preset=\"blueprint\"] .card::before {\n content: \"\";\n position: absolute;\n top: -1px;\n left: 1rem;\n width: 2.5rem;\n border-top: 2px solid var(--frontend-stroke);\n }\n\n html[data-preset=\"editorial\"] .card {\n position: relative;\n border-radius: 0.28rem;\n background: var(--panel);\n box-shadow: 0 10px 28px color-mix(in srgb, #000 10%, transparent);\n }\n html[data-preset=\"editorial\"] .card::before {\n position: absolute;\n top: -1px;\n left: 1.25rem;\n width: 3.25rem;\n border-top: 3px solid var(--arrow-emphasis);\n content: \"\";\n }\n html[data-preset=\"editorial\"] .card-dot { border-radius: 0; transform: rotate(45deg) scale(0.78); }\n\n .card-header {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n margin-bottom: 0.75rem;\n }\n\n .card-dot {\n width: 8px;\n height: 8px;\n border-radius: 50%;\n }\n\n .card-dot.cyan { background: var(--frontend-stroke); }\n .card-dot.emerald { background: var(--backend-stroke); }\n .card-dot.violet { background: var(--database-stroke); }\n .card-dot.amber { background: var(--cloud-stroke); }\n .card-dot.rose { background: var(--security-stroke); }\n .card-dot.orange { background: var(--messagebus-stroke); }\n .card-dot.slate { background: var(--external-stroke); }\n\n .card h3 { font-size: 0.875rem; font-weight: 600; color: var(--text); }\n\n .card ul {\n list-style: none;\n color: var(--text-muted);\n font-size: 0.75rem;\n }\n\n .card li { margin-bottom: 0.375rem; }\n\n /* ==========================================================\n Print stylesheet — hide interactive controls, force light,\n drop the grid so the diagram doesn't waste ink, use landscape\n so wide diagrams fit, pack summary cards into 2 columns to\n avoid an orphan card on a trailing page.\n ========================================================== */\n @page { size: landscape; margin: 1.5cm; }\n\n @media print {\n /* Force the FULL light palette — including component fills/strokes and\n lane/arrow colors — so printing from dark theme doesn't put neon\n strokes and translucent dark fills on white paper. */\n :root, [data-theme=\"dark\"], [data-theme=\"light\"] {\n --bg: #ffffff;\n --grid: transparent;\n --panel: #ffffff;\n --panel-border: #e2e8f0;\n --text: #0f172a;\n --text-muted: #475569;\n --text-dim: #94a3b8;\n --text-faint: #64748b;\n --mask: #ffffff;\n --lane-fill: rgba(248, 250, 252, 0.65);\n --lane-stroke: #cbd5e1;\n --arrow: #94a3b8;\n --arrow-emphasis: #059669;\n --frontend-fill: rgba(34, 211, 238, 0.15);\n --frontend-stroke: #0891b2;\n --backend-fill: rgba(52, 211, 153, 0.18);\n --backend-stroke: #059669;\n --database-fill: rgba(167, 139, 250, 0.2);\n --database-stroke: #7c3aed;\n --cloud-fill: rgba(251, 191, 36, 0.18);\n --cloud-stroke: #d97706;\n --security-fill: rgba(251, 113, 133, 0.15);\n --security-stroke: #e11d48;\n --messagebus-fill: rgba(251, 146, 60, 0.15);\n --messagebus-stroke:#ea580c;\n --external-fill: rgba(148, 163, 184, 0.18);\n --external-stroke: #64748b;\n }\n body { background: #ffffff !important; padding: 0; }\n .container { max-width: none; }\n .toolbar, .diagram-nav, .focus-chip, .guided-views, .archify-toast, .no-print { display: none !important; }\n .chapter-handoff-overlay { display: none !important; }\n svg [data-node-id][data-chapter-role] { opacity: 1 !important; }\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }\n .diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }\n .diagram-container { --archify-nav-reserve: 0px !important; }\n html[data-preset=\"signal-flow\"] .diagram-container,\n html[data-preset=\"signal-flow\"] .card { background: #ffffff; }\n .cards { grid-template-columns: 1fr 1fr; }\n /* Ensure elements break sensibly across pages */\n .card { break-inside: avoid; page-break-inside: avoid; }\n .diagram-container { break-inside: avoid; page-break-inside: avoid; }\n .diagram-container svg [data-detail] {\n opacity: 1 !important;\n pointer-events: auto !important;\n }\n .diagram-container svg [data-detail-anchor] { transform: none !important; }\n .diagram-container svg[data-lens-active] [data-node-id],\n .diagram-container svg[data-lens-active] [data-edge-from],\n .diagram-container svg[data-legend-preview-active] [data-node-id],\n .diagram-container svg[data-legend-preview-active] [data-edge-from] {\n opacity: 1 !important;\n filter: none !important;\n }\n [data-legend-bridge-runtime] { display: none !important; }\n .semantic-lens-overlay { display: none !important; }\n .relationship-hit-overlay { display: none !important; }\n .relationship-pulse-overlay { display: none !important; }\n .route-probe-overlay, .route-journey-overlay { display: none !important; }\n .story-trail-overlay,\n .story-carrier-overlay { display: none !important; }\n .diagram-container svg[data-focus-active] [data-node-id],\n .diagram-container svg[data-focus-active] [data-edge-from],\n .diagram-container svg[data-reach-active] [data-node-id],\n .diagram-container svg[data-reach-active] [data-edge-from],\n .diagram-container svg[data-story-beat] [data-story-step],\n .diagram-container svg[data-story-beat] [data-edge-from][data-story-beat-step],\n .diagram-container svg[data-route-active] [data-node-id],\n .diagram-container svg[data-route-active] [data-edge-from] {\n opacity: 1 !important;\n filter: none !important;\n animation: none !important;\n }\n h1, .subtitle { color: #0f172a; }\n }\n\n /* ==========================================================\n TOOLBAR (theme toggle + export menu)\n ========================================================== */\n .toolbar {\n position: fixed;\n top: 1rem;\n right: 1rem;\n display: flex;\n align-items: center;\n gap: 0.5rem;\n padding: 0;\n border: 0;\n background: transparent;\n box-shadow: none;\n z-index: 100;\n }\n .toolbar button {\n background: var(--toolbar-bg);\n color: var(--toolbar-text);\n border: 1px solid var(--toolbar-border);\n padding: 0.5rem 0.875rem;\n border-radius: 0.625rem;\n font-family: inherit;\n font-size: 0.75rem;\n font-weight: 500;\n cursor: pointer;\n white-space: nowrap;\n backdrop-filter: blur(10px);\n box-shadow: 0 4px 14px rgba(0, 0, 0, 0.08);\n transition: background 0.15s, border-color 0.15s, color 0.15s;\n display: inline-flex;\n align-items: center;\n gap: 0.375rem;\n min-height: 2.75rem;\n }\n .toolbar button:hover {\n background: var(--toolbar-hover);\n border-color: color-mix(in srgb, var(--arrow) 62%, var(--toolbar-border));\n }\n .toolbar button[aria-expanded=\"true\"],\n .toolbar button[aria-pressed=\"true\"]:not(#btn-theme) {\n background: color-mix(in srgb, var(--frontend-stroke) 10%, var(--toolbar-hover));\n border-color: color-mix(in srgb, var(--frontend-stroke) 48%, var(--toolbar-border));\n }\n .toolbar #btn-export {\n padding-right: 0.82rem;\n padding-left: 0.82rem;\n }\n .toolbar #btn-export:hover,\n .toolbar #btn-export[aria-expanded=\"true\"] {\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-stroke) 10%, var(--toolbar-hover));\n border-color: color-mix(in srgb, var(--frontend-stroke) 54%, var(--toolbar-border));\n }\n .toolbar button:focus-visible {\n outline: 2px solid var(--frontend-stroke);\n outline-offset: 2px;\n }\n .toolbar #btn-motion[hidden] { display: none !important; }\n .toolbar #btn-motion { min-width: 4.4rem; }\n .toolbar #btn-motion:disabled { cursor: default; opacity: 0.58; }\n .toolbar .preset-wrap,\n .toolbar .export-wrap {\n position: relative;\n }\n .toolbar-icon {\n display: inline-block;\n width: 0.95rem;\n height: 0.95rem;\n flex: 0 0 auto;\n background: currentColor;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .toolbar-chevron {\n width: 0.65rem;\n height: 0.65rem;\n transition: transform 0.15s ease;\n }\n [aria-expanded=\"true\"] \u003e .toolbar-chevron { transform: rotate(180deg); }\n [data-theme=\"light\"] #theme-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cg fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'%3E%3Ccircle cx='10' cy='10' r='3.1'/%3E%3Cpath d='M10 2.2v1.4M10 16.4v1.4M2.2 10h1.4M16.4 10h1.4M4.5 4.5l1 1M14.5 14.5l1 1M15.5 4.5l-1 1M5.5 14.5l-1 1'/%3E%3C/g%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cg fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'%3E%3Ccircle cx='10' cy='10' r='3.1'/%3E%3Cpath d='M10 2.2v1.4M10 16.4v1.4M2.2 10h1.4M16.4 10h1.4M4.5 4.5l1 1M14.5 14.5l1 1M15.5 4.5l-1 1M5.5 14.5l-1 1'/%3E%3C/g%3E%3C/svg%3E\");\n }\n [data-theme=\"dark\"] #theme-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M15.2 12.7A6.3 6.3 0 017.3 4.8a6.3 6.3 0 107.9 7.9Z' fill='none' stroke='black' stroke-width='1.7' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M15.2 12.7A6.3 6.3 0 017.3 4.8a6.3 6.3 0 107.9 7.9Z' fill='none' stroke='black' stroke-width='1.7' stroke-linejoin='round'/%3E%3C/svg%3E\");\n }\n #btn-present[aria-pressed=\"false\"] #present-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 3.2h-4v4M12.8 3.2h4v4M7.2 16.8h-4v-4M12.8 16.8h4v-4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 3.2h-4v4M12.8 3.2h4v4M7.2 16.8h-4v-4M12.8 16.8h4v-4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n #btn-present[aria-pressed=\"true\"] #present-icon {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 7.2h-4v-4M12.8 7.2h4v-4M7.2 12.8h-4v4M12.8 12.8h4v4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M7.2 7.2h-4v-4M12.8 7.2h4v-4M7.2 12.8h-4v4M12.8 12.8h4v4' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round'/%3E%3C/svg%3E\");\n }\n .toolbar-chevron {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='m3 4.5 3 3 3-3' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='m3 4.5 3 3 3-3' fill='none' stroke='black' stroke-width='1.7' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n }\n .toolbar #btn-preset { min-width: 5.4rem; }\n .preset-control-mark {\n width: 0.58rem;\n height: 0.58rem;\n flex: 0 0 auto;\n border: 1px solid var(--frontend-stroke);\n border-radius: 0.2rem;\n background: color-mix(in srgb, var(--frontend-stroke) 28%, transparent);\n transition: border-radius 0.15s, box-shadow 0.15s, transform 0.15s;\n }\n #btn-preset[data-preset-option=\"signal-flow\"] .preset-control-mark {\n border-radius: 50%;\n box-shadow: 0 0 10px color-mix(in srgb, var(--frontend-stroke) 78%, transparent);\n }\n #btn-preset[data-preset-option=\"blueprint\"] .preset-control-mark {\n border-radius: 0.06rem;\n background: transparent;\n box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--frontend-stroke) 32%, transparent);\n transform: rotate(45deg) scale(0.84);\n }\n #btn-preset[data-preset-option=\"editorial\"] .preset-control-mark {\n border-color: var(--arrow-emphasis);\n border-radius: 0;\n background: var(--arrow-emphasis);\n box-shadow: 0 0 0 2px color-mix(in srgb, var(--arrow-emphasis) 14%, transparent);\n transform: rotate(45deg) scale(0.72);\n }\n .toolbar .preset-menu {\n position: absolute;\n top: calc(100% + 0.375rem);\n right: 0;\n display: none;\n width: 18.5rem;\n max-width: calc(100vw - 2rem);\n padding: 0.45rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.875rem;\n background: var(--toolbar-menu-bg);\n box-shadow: 0 18px 48px rgba(0, 0, 0, 0.24);\n }\n .toolbar .preset-menu.open { display: block; }\n .toolbar .preset-menu.open,\n .toolbar .export-menu.open {\n animation: toolbar-menu-in 0.16s cubic-bezier(0.2, 0.8, 0.2, 1);\n transform-origin: top right;\n }\n @keyframes toolbar-menu-in {\n from { opacity: 0; transform: translateY(-0.25rem) scale(0.985); }\n to { opacity: 1; transform: translateY(0) scale(1); }\n }\n .preset-menu-heading {\n display: flex;\n align-items: baseline;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.42rem 0.6rem 0.55rem;\n color: var(--text-faint);\n font-size: 0.56rem;\n letter-spacing: 0.13em;\n text-transform: uppercase;\n }\n .preset-menu-heading span:last-child {\n font-size: 0.52rem;\n letter-spacing: 0.04em;\n text-transform: none;\n }\n .toolbar .preset-option {\n display: grid;\n grid-template-columns: 2rem minmax(0, 1fr) 1rem;\n align-items: center;\n gap: 0.68rem;\n width: 100%;\n min-height: 3.35rem;\n padding: 0.5rem 0.62rem;\n border: 0;\n border-radius: 0.5rem;\n background: transparent;\n box-shadow: none;\n backdrop-filter: none;\n text-align: left;\n }\n .toolbar .preset-option:hover,\n .toolbar .preset-option:focus-visible { background: var(--toolbar-hover); }\n .toolbar .preset-option[aria-checked=\"true\"] {\n background: color-mix(in srgb, var(--frontend-stroke) 9%, transparent);\n border-color: color-mix(in srgb, var(--frontend-stroke) 36%, transparent);\n }\n .preset-option-swatch {\n position: relative;\n width: 2rem;\n height: 1.55rem;\n overflow: hidden;\n border: 1px solid #64748b;\n border-radius: 0.24rem;\n background: #0f172a;\n box-shadow: inset 0 0 0 1px rgba(255,255,255,0.04);\n }\n .preset-option-swatch::before,\n .preset-option-swatch::after { position: absolute; content: \"\"; }\n .preset-option-swatch.classic::before {\n top: 0.42rem;\n right: 0.35rem;\n bottom: 0.42rem;\n left: 0.35rem;\n border: 1px solid #22d3ee;\n border-radius: 0.16rem;\n background: rgba(34, 211, 238, 0.14);\n }\n .preset-option-swatch.signal-flow {\n border-color: #29415f;\n background: linear-gradient(135deg, #07101e 10%, #10243c 100%);\n }\n .preset-option-swatch.signal-flow::before {\n top: 50%;\n right: 0.2rem;\n left: 0.2rem;\n height: 1px;\n background: linear-gradient(90deg, #67e8f9, #c4b5fd);\n box-shadow: 0 0 8px #67e8f9;\n }\n .preset-option-swatch.signal-flow::after {\n top: calc(50% - 0.13rem);\n right: 0.28rem;\n width: 0.26rem;\n height: 0.26rem;\n border-radius: 50%;\n background: #67e8f9;\n box-shadow: 0 0 7px #67e8f9;\n }\n .preset-option-swatch.blueprint {\n border-color: #34799a;\n border-radius: 0.08rem;\n background-color: #0a2031;\n background-image:\n linear-gradient(rgba(102, 217, 239, 0.18) 1px, transparent 1px),\n linear-gradient(90deg, rgba(102, 217, 239, 0.18) 1px, transparent 1px);\n background-size: 0.42rem 0.42rem;\n }\n .preset-option-swatch.blueprint::before {\n top: 0.34rem;\n right: 0.38rem;\n bottom: 0.34rem;\n left: 0.38rem;\n border: 1px solid #66d9ef;\n }\n .preset-option-swatch.editorial {\n border-color: #b8aa94;\n border-radius: 0.08rem;\n background: repeating-linear-gradient(0deg, #f2eee5 0 0.34rem, #d8d0c2 0.36rem, #f2eee5 0.38rem);\n }\n .preset-option-swatch.editorial::before {\n top: 0;\n bottom: 0;\n left: 0.42rem;\n width: 1px;\n background: #c9502d;\n opacity: 0.72;\n }\n .preset-option-swatch.editorial::after {\n top: 0.52rem;\n right: 0.45rem;\n width: 0.38rem;\n height: 0.38rem;\n background: #c9502d;\n transform: rotate(45deg);\n }\n .preset-option-copy { min-width: 0; }\n .preset-option-copy strong,\n .preset-option-copy small { display: block; }\n .preset-option-copy strong {\n color: var(--toolbar-text);\n font-size: 0.72rem;\n font-weight: 600;\n }\n .preset-option-copy small {\n margin-top: 0.16rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.57rem;\n font-weight: 400;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n .preset-option-check {\n display: inline-block;\n width: 0.9rem;\n height: 0.9rem;\n color: var(--frontend-stroke);\n background: currentColor;\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='m3 8.5 3 3 7-7' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='m3 8.5 3 3 7-7' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n opacity: 0;\n }\n .preset-option[aria-checked=\"true\"] .preset-option-check { opacity: 1; }\n html[data-preset=\"editorial\"] .toolbar button,\n html[data-preset=\"editorial\"] .preset-menu,\n html[data-preset=\"editorial\"] .export-menu,\n html[data-preset=\"editorial\"] .overview-map,\n html[data-preset=\"editorial\"] .semantic-lens,\n html[data-preset=\"editorial\"] .route-probe,\n html[data-preset=\"editorial\"] .focus-chip,\n html[data-preset=\"editorial\"] .diagram-guide,\n html[data-preset=\"editorial\"] .node-finder,\n html[data-preset=\"editorial\"] .guided-views,\n html[data-preset=\"editorial\"] .share-chapter-cue {\n border-radius: 0.3rem;\n }\n .motion-control-dot {\n width: 0.46rem;\n height: 0.46rem;\n flex: 0 0 auto;\n border: 1px solid var(--frontend-stroke);\n border-radius: 50%;\n background: var(--frontend-stroke);\n box-shadow: 0 0 9px color-mix(in srgb, var(--frontend-stroke) 72%, transparent);\n }\n #btn-motion[aria-pressed=\"false\"] .motion-control-dot {\n background: transparent;\n box-shadow: none;\n }\n .toolbar .export-menu {\n position: absolute;\n top: calc(100% + 0.375rem);\n right: 0;\n background: var(--toolbar-menu-bg);\n border: 1px solid var(--toolbar-border);\n width: 19rem;\n max-width: calc(100vw - 2rem);\n max-height: calc(100vh - 5.5rem);\n overflow-y: auto;\n border-radius: 0.875rem;\n padding: 0.55rem;\n display: none;\n flex-direction: column;\n box-shadow: 0 18px 48px rgba(0,0,0,0.24);\n }\n .toolbar .export-menu.open { display: flex; }\n .export-menu-header {\n display: flex;\n align-items: flex-start;\n justify-content: space-between;\n gap: 1rem;\n padding: 0.5rem 0.55rem 0.72rem;\n }\n .export-menu-header strong,\n .export-menu-header span { display: block; }\n .export-menu-header strong {\n color: var(--toolbar-text);\n font-size: 0.78rem;\n font-weight: 650;\n letter-spacing: -0.015em;\n }\n .export-menu-header span {\n margin-top: 0.16rem;\n color: var(--text-faint);\n font-size: 0.56rem;\n }\n .export-menu-header kbd {\n padding: 0.16rem 0.36rem;\n border: 1px solid var(--toolbar-border);\n border-radius: 0.3rem;\n color: var(--text-faint);\n background: color-mix(in srgb, var(--toolbar-border) 16%, transparent);\n font-family: inherit;\n font-size: 0.54rem;\n font-weight: 600;\n }\n .export-menu-section {\n display: grid;\n grid-template-columns: minmax(0, 1fr);\n gap: 0.18rem;\n }\n .export-menu-section + .export-menu-section {\n margin-top: 0.42rem;\n padding-top: 0.42rem;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 68%, transparent);\n }\n .export-menu-heading {\n grid-column: 1 / -1;\n display: block;\n padding: 0.24rem 0.55rem 0.2rem;\n color: var(--text-faint);\n font-size: 0.54rem;\n font-weight: 600;\n letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .toolbar .export-menu button {\n display: grid;\n grid-template-columns: 1.15rem minmax(0, 1fr);\n align-items: center;\n column-gap: 0.52rem;\n background: transparent;\n border: 1px solid transparent;\n box-shadow: none;\n backdrop-filter: none;\n width: 100%;\n min-height: 3rem;\n text-align: left;\n padding: 0.48rem 0.55rem;\n border-radius: 0.5rem;\n white-space: nowrap;\n }\n .export-item-copy {\n display: block;\n min-width: 0;\n }\n .export-item-copy strong,\n .export-item-copy small { display: block; }\n .export-item-copy strong {\n overflow: hidden;\n color: inherit;\n font-size: 0.7rem;\n font-weight: 550;\n text-overflow: ellipsis;\n }\n .export-item-copy small {\n margin-top: 0.12rem;\n overflow: hidden;\n color: var(--text-faint);\n font-size: 0.55rem;\n font-weight: 450;\n text-overflow: ellipsis;\n }\n .toolbar .export-menu button::before {\n width: 1rem;\n height: 1rem;\n background: currentColor;\n content: \"\";\n opacity: 0.72;\n -webkit-mask-position: center;\n -webkit-mask-repeat: no-repeat;\n -webkit-mask-size: contain;\n mask-position: center;\n mask-repeat: no-repeat;\n mask-size: contain;\n }\n .toolbar .export-menu button[data-format=\"share-card\"]::before,\n .toolbar .export-menu button[data-action=\"route-share-card\"]::before,\n .toolbar .export-menu button[data-action=\"reach-share-card\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='black' stroke-width='1.7' d='M3 4.5h14v11H3zM6 12l2.5-2.5 2 2 1.5-1.5 2 2'/%3E%3Ccircle cx='13.8' cy='7.3' r='1.2' fill='black'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='black' stroke-width='1.7' d='M3 4.5h14v11H3zM6 12l2.5-2.5 2 2 1.5-1.5 2 2'/%3E%3Ccircle cx='13.8' cy='7.3' r='1.2' fill='black'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-action^=\"copy\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Crect x='6' y='6' width='10' height='10' rx='1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M4 13H3.5A1.5 1.5 0 012 11.5v-8A1.5 1.5 0 013.5 2h8A1.5 1.5 0 0113 3.5V4' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Crect x='6' y='6' width='10' height='10' rx='1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M4 13H3.5A1.5 1.5 0 012 11.5v-8A1.5 1.5 0 013.5 2h8A1.5 1.5 0 0113 3.5V4' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"png\"]::before,\n .toolbar .export-menu button[data-format=\"jpeg\"]::before,\n .toolbar .export-menu button[data-format=\"webp\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 2.5h7l3 3v12H5zM12 2.5v3h3' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.5 14l2-2 1.5 1.5 1.5-1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M5 2.5h7l3 3v12H5zM12 2.5v3h3' fill='none' stroke='black' stroke-width='1.7'/%3E%3Cpath d='M7.5 14l2-2 1.5 1.5 1.5-1.5' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"svg\"]::before,\n .toolbar .export-menu button[data-format=\"webm\"]::before {\n -webkit-mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2.5l7 4v7l-7 4-7-4v-7zM3 6.5l7 4 7-4M10 10.5v7' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n mask-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M10 2.5l7 4v7l-7 4-7-4v-7zM3 6.5l7 4 7-4M10 10.5v7' fill='none' stroke='black' stroke-width='1.7'/%3E%3C/svg%3E\");\n }\n .toolbar .export-menu button[data-format=\"share-card\"],\n .toolbar .export-menu button[data-action=\"route-share-card\"],\n .toolbar .export-menu button[data-action=\"reach-share-card\"] {\n min-height: 3.35rem;\n color: var(--toolbar-text);\n background: color-mix(in srgb, var(--frontend-stroke) 8%, transparent);\n border-color: color-mix(in srgb, var(--frontend-stroke) 24%, var(--toolbar-border));\n }\n .toolbar .export-menu button[hidden] { display: none; }\n .toolbar .export-menu button:hover {\n background: var(--toolbar-hover);\n }\n .toolbar .export-menu button:focus-visible {\n background: var(--toolbar-hover);\n outline-offset: -2px;\n }\n .toolbar .export-menu button:disabled {\n color: var(--text-faint);\n background: color-mix(in srgb, var(--toolbar-border) 18%, transparent);\n cursor: not-allowed;\n }\n .toolbar .export-menu button:disabled:hover {\n border-color: transparent;\n }\n .toolbar .export-menu .hint {\n color: var(--text-faint);\n font-size: 0.55rem;\n }\n\n /* Toast — brief feedback for actions like \"copied\" */\n .archify-toast {\n position: fixed;\n top: 1rem;\n left: 50%;\n transform: translateX(-50%) translateY(-8px);\n background: var(--toolbar-menu-bg);\n color: var(--text);\n border: 1px solid var(--toolbar-border);\n padding: 0.5rem 1rem;\n border-radius: 0.5rem;\n font-family: inherit;\n font-size: 0.75rem;\n opacity: 0;\n transition: opacity 0.2s, transform 0.2s;\n z-index: 200;\n pointer-events: none;\n box-shadow: 0 4px 20px rgba(0,0,0,0.25);\n }\n .archify-toast.show {\n opacity: 1;\n transform: translateX(-50%) translateY(0);\n }\n\n @media (max-width: 720px) {\n body { padding: 1rem; }\n .toolbar .preset-menu,\n .toolbar .export-menu {\n position: fixed;\n top: 4.5rem;\n right: 1rem;\n left: 1rem;\n width: auto;\n max-width: none;\n }\n .toolbar {\n position: relative;\n justify-content: flex-end;\n width: max-content;\n max-width: 100%;\n margin-left: auto;\n margin-bottom: 1rem;\n }\n .header { margin-bottom: 1.25rem; padding-right: 0; }\n html[data-preset=\"signal-flow\"] .header,\n html[data-preset=\"blueprint\"] .header,\n html[data-preset=\"editorial\"] .header { padding-right: 0; }\n .header-row {\n gap: 0.75rem;\n align-items: flex-start;\n }\n html[data-preset=\"signal-flow\"] .header-row,\n html[data-preset=\"blueprint\"] .header-row,\n html[data-preset=\"editorial\"] .header-row { flex-wrap: wrap; }\n html[data-preset=\"signal-flow\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n html[data-preset=\"blueprint\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n html[data-preset=\"editorial\"] .header-row::after {\n margin-left: 0;\n order: 3;\n }\n h1 {\n font-size: 1.25rem;\n line-height: 1.25;\n }\n .subtitle {\n margin-left: 0;\n font-size: 0.8125rem;\n line-height: 1.55;\n }\n .diagram-container {\n padding: 0.75rem;\n border-radius: 0.75rem;\n }\n html:not([data-embed=\"true\"]) .diagram-container {\n padding: 0.75rem 0.75rem 4.25rem;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] {\n overflow-x: auto;\n overflow-y: hidden;\n overscroll-behavior-x: contain;\n scrollbar-width: thin;\n scroll-behavior: smooth;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] \u003e svg {\n min-width: 720px;\n }\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .diagram-nav,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .overview-map,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .focus-chip,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .route-probe,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .semantic-lens,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .diagram-guide,\n html:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] .node-finder {\n transform: translateX(var(--archify-scroll-x, 0px));\n }\n .diagram-nav { right: 0.5rem; bottom: 0.5rem; }\n .diagram-nav button {\n min-width: 2.75rem;\n height: 2.75rem;\n }\n .diagram-nav [data-view=\"reset\"] { min-width: 3.75rem; }\n .diagram-nav [data-view=\"reset\"][data-detail-visible] { min-width: 4.35rem; }\n .overview-map {\n right: 0.5rem;\n bottom: 3.7rem;\n width: min(10.25rem, calc(100% - 1rem));\n }\n .overview-map[data-docked=\"true\"] {\n right: var(--archify-radar-right, 0.5rem);\n top: var(--archify-radar-top, 0.5rem);\n bottom: auto;\n transform: none !important;\n }\n .overview-map[data-docked=\"true\"][data-dock-side=\"left\"] {\n right: auto;\n left: var(--archify-radar-left, 0.5rem);\n }\n .overview-map-surface { height: 4rem; }\n .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }\n .semantic-lens {\n right: 0.5rem;\n bottom: 3.7rem;\n width: calc(100% - 1rem);\n max-height: calc(100% - 4.2rem);\n }\n .semantic-lens[data-dock-side] { left: auto; right: 0.5rem; }\n .semantic-lens-kinds { max-height: min(12rem, 34vh); }\n .focus-chip {\n left: 0.5rem;\n top: 0.5rem;\n width: calc(100% - 1rem);\n max-width: none;\n }\n .relationship-lens-list { max-height: min(12rem, 38vh); }\n .relationship-lens-actions #btn-focus-relations { display: block; color: var(--database-stroke); }\n .focus-chip:not([data-relations-expanded=\"true\"]) .relationship-lens-head { border-bottom-color: transparent; }\n .focus-chip:not([data-relations-expanded=\"true\"]) .relationship-lens-list { display: none; }\n /* While a mobile reader previews one relationship, turn the full Lens\n into a compact peek card. This keeps the exact source and target on\n canvas instead of covering them with a long, scrollable list. */\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-list {\n max-height: none;\n padding: 0.35rem;\n overflow: hidden;\n }\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-group { margin: 0; }\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-group-title,\n .focus-chip[data-relationship-previewing=\"true\"] .relationship-lens-row:not([data-preview-active=\"true\"]) {\n display: none;\n }\n .node-finder {\n top: 0.5rem;\n left: 0.5rem;\n width: min(22rem, calc(100% - 1rem));\n max-height: calc(100% - 1rem);\n }\n .diagram-guide {\n top: 0.5rem;\n right: 0.5rem;\n left: 0.5rem;\n width: auto;\n max-height: calc(100% - 1rem);\n }\n .diagram-guide-head { padding: 0.62rem 0.7rem 0.52rem; }\n .diagram-guide-stats { padding: 0.42rem 0.7rem; }\n .diagram-guide-actions {\n grid-template-columns: 1fr;\n gap: 0.28rem;\n padding: 0.42rem;\n }\n .diagram-guide-action {\n min-height: 3.1rem;\n padding: 0.42rem 0.48rem;\n }\n .diagram-guide-action small {\n display: block;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n .diagram-guide-index {\n width: 1.5rem;\n height: 1.5rem;\n }\n .diagram-guide-shortcuts { padding: 0.46rem 0.7rem 0.52rem; }\n .diagram-guide-action[data-guide-action=\"present\"] { grid-column: auto; }\n .route-probe[data-guide-open=\"true\"] {\n visibility: hidden;\n pointer-events: none;\n }\n .node-finder-results { max-height: min(16rem, 38vh); }\n .route-probe {\n left: 0.5rem;\n bottom: 3.7rem;\n width: calc(100% - 1rem);\n min-width: 0;\n }\n .route-probe[data-route-dock=\"top\"] {\n top: 0.5rem;\n bottom: auto;\n }\n .route-probe[data-finder-open=\"true\"] {\n visibility: hidden;\n pointer-events: none;\n }\n .route-probe-head { padding: 0.45rem 0.48rem 0.38rem; }\n .route-probe-path { padding: 0.35rem 0.48rem 0.2rem; }\n .route-probe-node { min-height: 2.75rem !important; }\n .route-journey-controls {\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem minmax(0, 1fr);\n padding: 0.08rem 0.48rem 0.32rem;\n }\n .route-journey-controls button { min-height: 2.75rem; }\n .route-probe-status { padding: 0.05rem 0.48rem 0.38rem; }\n .route-probe-node { max-width: 7.5rem; }\n .guided-views {\n grid-template-columns: 2.75rem minmax(0, 1fr) 2.75rem;\n gap: 0.2rem;\n padding: 0.25rem;\n }\n .guided-view-actions {\n grid-column: 1 / -1;\n display: grid;\n grid-template-columns: repeat(3, minmax(0, 1fr));\n }\n .guided-views \u003e #guided-view-prev,\n .guided-views \u003e #guided-view-next {\n align-self: center;\n height: 2.75rem;\n }\n .guided-view-play,\n .guided-view-all,\n .guided-view-beat-link { min-height: 2.75rem; }\n .guided-view-copy small { white-space: normal; }\n .guided-story-caption { padding: 0.32rem 0.45rem; }\n .guided-story-caption-index { min-width: 2.9rem; padding-right: 0.42rem; }\n .guided-story-caption strong,\n .guided-story-caption small { white-space: normal; }\n .guided-story-caption-next { display: none; }\n .guided-view-trail { min-height: 2rem; }\n .guided-view-trail .guided-view-stop {\n min-height: 2rem;\n padding: 0.22rem 0.42rem 0.22rem 0.28rem;\n }\n .guided-view-handoff { max-width: min(9rem, 32vw); }\n .guided-view-index { padding-top: 0.35rem; }\n .guided-view-chapters {\n gap: 0.35rem;\n scroll-padding-inline: 0.2rem;\n }\n .guided-view-chapters li {\n flex: 0 0 min(14rem, 78vw);\n min-width: 0;\n }\n .guided-view-chapter { min-height: 2.75rem; }\n .guided-views[data-active-view=\"all\"] {\n grid-template-columns: minmax(0, 1fr) auto;\n gap: 0.2rem;\n padding: 0.25rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-copy {\n grid-column: 1;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-actions {\n grid-column: 2;\n grid-row: 1;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-play {\n min-width: 6rem !important;\n min-height: 2.75rem;\n }\n .guided-views[data-active-view=\"all\"] .guided-view-index {\n grid-column: 1 / -1;\n grid-row: 2;\n padding: 0.3rem 0.08rem 0;\n border-top: 1px solid color-mix(in srgb, var(--toolbar-border) 72%, transparent);\n border-left: 0;\n }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .share-chapter-cue:not([hidden]),\n html[data-embed=\"true\"][data-share-moment=\"true\"] .share-chapter-cue:not([hidden]) {\n top: 0.5rem;\n grid-template-columns: auto minmax(0, 1fr);\n gap: 0.28rem 0.55rem;\n width: calc(100% - 1rem);\n min-height: 0;\n padding: 0.45rem 0.55rem 0.55rem;\n }\n html[data-embed=\"true\"][data-share-playback=\"true\"] .diagram-container {\n padding-top: 4.25rem;\n }\n html[data-embed=\"true\"][data-share-moment=\"true\"] .diagram-container {\n padding-top: 4.25rem;\n }\n .share-chapter-index {\n min-width: 4.4rem;\n padding-right: 0.5rem;\n }\n .share-chapter-copy small { font-size: 0.46rem; }\n .share-chapter-route {\n grid-column: 1 / -1;\n font-size: 0.5rem;\n text-align: left;\n }\n .cards {\n grid-template-columns: 1fr;\n margin-top: 1rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) body { padding: 0.5rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .container {\n gap: 0.5rem;\n height: calc(100dvh - 1rem);\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .toolbar {\n position: fixed;\n top: 0.5rem;\n right: 0.5rem;\n margin: 0;\n gap: 0.25rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .toolbar button {\n min-height: 2.75rem;\n padding: 0.42rem 0.58rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header {\n min-height: 2.25rem;\n padding: 3.5rem 0 0;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row {\n min-height: 2.25rem;\n margin: 0;\n align-items: center;\n flex-wrap: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .header-row::after,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .pulse-dot,\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .subtitle { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) h1 {\n flex: 1 1 auto;\n min-width: 0;\n max-width: 100%;\n overflow: hidden;\n font-size: 0.875rem;\n text-overflow: ellipsis;\n white-space: nowrap;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-views {\n padding: 0.2rem;\n }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-view-copy small { display: none; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .guided-story-caption small { display: block; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container { padding: 0.5rem 0.5rem 3.75rem; }\n html[data-present=\"true\"]:not([data-embed=\"true\"]) .diagram-container[data-wide-diagram=\"true\"] \u003e svg {\n width: 720px;\n height: auto;\n min-width: 720px;\n }\n }\n\n @media (max-width: 420px) {\n .export-menu-section { grid-template-columns: 1fr; }\n .export-menu-heading,\n .toolbar .export-menu button[data-format=\"share-card\"],\n .toolbar .export-menu button[data-action=\"route-share-card\"],\n .toolbar .export-menu button[data-action=\"reach-share-card\"] { grid-column: 1; }\n }\n\n @media (prefers-reduced-motion: reduce) {\n .guided-story-caption { animation: none !important; }\n .toolbar .preset-menu.open,\n .toolbar .export-menu.open { animation: none; }\n .toolbar-chevron { transition: none; }\n }\n\n @media (max-width: 360px) {\n .toolbar { gap: 0.25rem; }\n .toolbar button { padding-right: 0.58rem; padding-left: 0.58rem; }\n .toolbar #btn-motion { min-width: 4.4rem; padding-right: 0.58rem; padding-left: 0.58rem; }\n #theme-label, #preset-label, #present-label { display: none; }\n .guided-view-handoff { max-width: 6.5rem; }\n }\n\n /* ==========================================================\n SVG SEMANTIC CLASSES — use these instead of inline fill/stroke\n ========================================================== */\n .c-grid { stroke: var(--grid); fill: none; }\n .c-mask { fill: var(--mask); stroke: none; }\n\n .c-frontend { fill: var(--frontend-fill); stroke: var(--frontend-stroke); }\n .c-backend { fill: var(--backend-fill); stroke: var(--backend-stroke); }\n .c-database { fill: var(--database-fill); stroke: var(--database-stroke); }\n .c-cloud { fill: var(--cloud-fill); stroke: var(--cloud-stroke); }\n .c-security { fill: var(--security-fill); stroke: var(--security-stroke); }\n .c-messagebus { fill: var(--messagebus-fill); stroke: var(--messagebus-stroke); }\n .c-external { fill: var(--external-fill); stroke: var(--external-stroke); }\n\n /* Text helpers */\n .t-primary { fill: var(--text); }\n .t-muted { fill: var(--text-muted); }\n .t-dim { fill: var(--text-dim); }\n .t-frontend { fill: var(--frontend-stroke); }\n .t-backend { fill: var(--backend-stroke); }\n .t-database { fill: var(--database-stroke); }\n .t-cloud { fill: var(--cloud-stroke); }\n .t-security { fill: var(--security-stroke); }\n .t-messagebus { fill: var(--messagebus-stroke); }\n .t-external { fill: var(--external-stroke); }\n\n /* Semantic Sigils are small authored role stamps, not icons from a brand\n pack and not viewer controls. Prefix selectors with svg so the canonical\n export's SVG-only stylesheet collector keeps them automatically. */\n svg .semantic-sigil {\n fill: none;\n stroke: currentColor;\n stroke-width: 1.35;\n stroke-linecap: round;\n stroke-linejoin: round;\n opacity: 0.76;\n pointer-events: none;\n }\n svg .semantic-sigil \u003e * { vector-effect: non-scaling-stroke; }\n svg .semantic-sigil .sigil-fill { fill: currentColor; stroke: none; }\n svg .s-frontend { color: var(--frontend-stroke); }\n svg .s-backend { color: var(--backend-stroke); }\n svg .s-database { color: var(--database-stroke); }\n svg .s-cloud { color: var(--cloud-stroke); }\n svg .s-security { color: var(--security-stroke); }\n svg .s-messagebus { color: var(--messagebus-stroke); }\n svg .s-external { color: var(--external-stroke); }\n\n /* Brand Marks are authored identity badges. Their color is contained\n inside one neutral plate so vendor color never replaces Archify's\n semantic node and relationship vocabulary. */\n svg .brand-mark { pointer-events: none; }\n svg .brand-mark-badge { fill: #fff; stroke: none; }\n svg .brand-mark-frame {\n fill: none;\n stroke: #cbd5e1;\n stroke-width: 0.8;\n vector-effect: non-scaling-stroke;\n }\n svg .brand-mark-fallback {\n fill: none;\n stroke: #475569;\n stroke-width: 1.15;\n stroke-linecap: round;\n stroke-linejoin: round;\n }\n svg[data-preset=\"blueprint\"] .brand-mark-badge,\n svg[data-preset=\"blueprint\"] .brand-mark-frame { rx: 1px; }\n\n /* Reading Depth is a viewer-only level-of-detail layer. MAP preserves the\n authored structure and primary labels, READ restores relationship labels\n and node context, and FULL restores tags and fine annotations. Semantic\n intent can reveal the relevant detail without moving any geometry. */\n svg [data-detail] { transition: opacity 160ms ease; }\n svg [data-detail-anchor] {\n transform-box: fill-box;\n transform-origin: center;\n transition: transform 160ms ease;\n }\n .diagram-container[data-detail-level=\"map\"] svg [data-detail=\"context\"],\n .diagram-container[data-detail-level=\"map\"] svg [data-detail=\"fine\"],\n .diagram-container[data-detail-level=\"read\"] svg [data-detail=\"fine\"] {\n opacity: 0;\n pointer-events: none;\n }\n .diagram-container[data-detail-level=\"map\"] svg [data-detail-anchor] {\n transform: translateY(8px);\n }\n\n /* Focus, lens, preview, route, and story states are stronger reader intent than\n the global zoom level. Reveal only their exact semantic matches. */\n svg[data-focus-active] [data-focus-match][data-detail],\n svg[data-focus-active] [data-focus-match] [data-detail],\n svg[data-reach-active] [data-reach-match][data-detail],\n svg[data-reach-active] [data-reach-match] [data-detail],\n svg[data-lens-active] [data-lens-match][data-detail],\n svg[data-lens-active] [data-lens-match] [data-detail],\n svg[data-legend-preview-active] [data-legend-preview-match][data-detail],\n svg[data-legend-preview-active] [data-legend-preview-match] [data-detail],\n svg[data-intent-trace-active] [data-intent-trace-match][data-detail],\n svg[data-intent-trace-active] [data-intent-trace-match] [data-detail],\n svg[data-route-active] [data-route-match][data-detail],\n svg[data-route-active] [data-route-match] [data-detail],\n svg[data-story-active] [data-story-step][data-detail],\n svg[data-story-active] [data-story-step] [data-detail],\n svg[data-relationship-preview-active] [data-relationship-preview][data-detail],\n svg[data-relationship-preview-active] [data-relationship-preview] [data-detail],\n svg [data-node-id]:hover [data-detail],\n svg [data-node-id]:focus-visible [data-detail] {\n opacity: 1;\n pointer-events: auto;\n }\n svg[data-focus-active] [data-focus-match] [data-detail-anchor],\n svg[data-reach-active] [data-reach-match] [data-detail-anchor],\n svg[data-lens-active] [data-lens-match] [data-detail-anchor],\n svg[data-legend-preview-active] [data-legend-preview-match] [data-detail-anchor],\n svg[data-intent-trace-active] [data-intent-trace-match] [data-detail-anchor],\n svg[data-route-active] [data-route-match] [data-detail-anchor],\n svg[data-story-active] [data-story-step] [data-detail-anchor],\n svg [data-node-id]:hover [data-detail-anchor],\n svg [data-node-id]:focus-visible [data-detail-anchor] { transform: none; }\n\n /* Arrows */\n .a-default { stroke: var(--arrow); fill: none; }\n .a-emphasis { stroke: var(--arrow-emphasis); fill: none; }\n .a-security { stroke: var(--security-stroke); fill: none; stroke-dasharray: 5,5; }\n .a-dashed { stroke: var(--database-stroke); fill: none; stroke-dasharray: 4,4; }\n\n /* Arrowhead markers reference these */\n .m-default { fill: var(--arrow); }\n .m-emphasis { fill: var(--arrow-emphasis); }\n .m-security { fill: var(--security-stroke); }\n .m-dashed { fill: var(--database-stroke); }\n\n /* Stable semantic exploration hooks emitted by every renderer. */\n svg [data-node-id] {\n cursor: pointer;\n transition: opacity 0.18s ease, filter 0.18s ease;\n }\n svg [data-edge-from] { transition: opacity 0.18s ease, filter 0.18s ease; }\n svg [data-node-id]:hover,\n svg [data-node-id]:focus-visible {\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n outline: none;\n }\n /* Verified Source Beacons are installed at runtime only for nodes whose\n repository evidence passed the local revision/blob/line checks. They\n live inside the owning node so every focus, route, story, and guided\n view keeps one coherent opacity state. Export serialization removes\n them before producing the canonical SVG or any derived visual. */\n .source-evidence-beacon {\n pointer-events: none;\n opacity: 0.76;\n transition: opacity 160ms ease, filter 160ms ease;\n }\n .source-evidence-beacon rect {\n fill: color-mix(in srgb, var(--mask) 92%, var(--backend-stroke));\n stroke: color-mix(in srgb, var(--backend-stroke) 82%, var(--panel-border));\n stroke-width: 1;\n vector-effect: non-scaling-stroke;\n }\n .source-evidence-beacon text {\n fill: var(--backend-stroke);\n font-size: 5.5px;\n font-weight: 800;\n letter-spacing: 0.06em;\n text-anchor: middle;\n text-transform: uppercase;\n }\n svg [data-node-id]:hover .source-evidence-beacon,\n svg [data-node-id]:focus-visible .source-evidence-beacon,\n svg [data-node-id][data-focus-selected] .source-evidence-beacon {\n opacity: 1;\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--backend-stroke) 72%, transparent));\n }\n svg[data-preset=\"signal-flow\"] .source-evidence-beacon { opacity: 0.9; }\n svg[data-preset=\"blueprint\"] .source-evidence-beacon rect {\n rx: 0.8px;\n filter: none;\n }\n svg [data-legend-kind][role=\"button\"] { cursor: pointer; }\n svg [data-legend-kind]:focus { outline: none; }\n svg [data-legend-hit] {\n fill: transparent;\n stroke: transparent;\n stroke-width: 1.4;\n pointer-events: all;\n vector-effect: non-scaling-stroke;\n transition: stroke 150ms ease, stroke-width 150ms ease, filter 150ms ease;\n }\n svg [data-legend-count-badge] { pointer-events: none; }\n svg [data-legend-count-badge] rect {\n fill: var(--mask);\n stroke: var(--panel-border);\n stroke-width: 1;\n vector-effect: non-scaling-stroke;\n }\n svg [data-legend-count-badge] text {\n fill: var(--text-muted);\n font-size: 8px;\n font-weight: 700;\n text-anchor: middle;\n }\n svg [data-legend-kind][role=\"button\"]:hover [data-legend-hit] {\n stroke: color-mix(in srgb, var(--database-stroke) 58%, transparent);\n }\n svg [data-legend-kind][role=\"button\"]:focus-visible [data-legend-hit] {\n stroke: var(--frontend-stroke);\n stroke-width: 1.8;\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg [data-legend-kind][data-legend-selected] [data-legend-hit] {\n stroke: var(--database-stroke);\n stroke-width: 2.2;\n stroke-dasharray: 3 2;\n }\n svg [data-legend-kind][data-legend-selected] [data-legend-count-badge] rect {\n stroke: var(--database-stroke);\n stroke-width: 1.8;\n }\n svg [data-legend-kind][data-legend-zero] { opacity: 0.44; }\n svg[data-preset=\"signal-flow\"] [data-legend-kind][data-legend-selected] [data-legend-hit] {\n filter: drop-shadow(0 0 4px var(--database-stroke));\n }\n svg[data-preset=\"blueprint\"] [data-legend-hit],\n svg[data-preset=\"blueprint\"] [data-legend-count-badge] rect { rx: 0; filter: none; }\n svg[data-legend-preview-active] [data-node-id],\n svg[data-legend-preview-active] [data-edge-from] { opacity: 0.11; }\n svg[data-legend-preview-active] [data-legend-preview-match] { opacity: 1; }\n svg[data-legend-preview-active] [data-legend-preview-peer] { opacity: 0.62; }\n svg[data-legend-preview-active] [data-legend-preview-selected] {\n filter: drop-shadow(0 0 8px var(--database-stroke));\n }\n svg[data-lens-active] [data-node-id],\n svg[data-lens-active] [data-edge-from] { opacity: 0.11; }\n svg[data-lens-active] [data-lens-match] { opacity: 1; }\n svg[data-lens-active] [data-lens-peer] { opacity: 0.62; }\n svg[data-lens-active] [data-lens-selected] {\n filter: drop-shadow(0 0 10px var(--database-stroke));\n }\n .semantic-lens-overlay { pointer-events: none; }\n .semantic-lens-flow {\n fill: none;\n stroke-width: 3.05;\n stroke-linecap: round;\n stroke-dasharray: 0.075 0.925;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.9;\n animation: archify-semantic-lens-flow 1.35s linear 1 both;\n animation-delay: var(--lens-flow-delay, 0s);\n }\n .semantic-lens-flow[data-direction=\"out\"],\n .semantic-lens-flow[data-direction=\"forward\"] {\n stroke: var(--frontend-stroke);\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n .semantic-lens-flow[data-direction=\"in\"],\n .semantic-lens-flow[data-direction=\"reverse\"] {\n stroke: var(--database-stroke);\n filter: drop-shadow(0 0 3px var(--database-stroke));\n }\n .semantic-lens-flow[data-direction=\"within\"] {\n stroke: var(--messagebus-stroke);\n filter: drop-shadow(0 0 3px var(--messagebus-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow {\n stroke-width: 3.7;\n opacity: 1;\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"out\"],\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"forward\"] {\n filter: drop-shadow(0 0 6px var(--frontend-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"in\"],\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"reverse\"] {\n filter: drop-shadow(0 0 6px var(--database-stroke));\n }\n svg[data-preset=\"signal-flow\"] .semantic-lens-flow[data-direction=\"within\"] {\n filter: drop-shadow(0 0 6px var(--messagebus-stroke));\n }\n svg[data-preset=\"blueprint\"] .semantic-lens-flow {\n stroke-width: 2.45;\n stroke-linecap: square;\n filter: none;\n opacity: 0.78;\n }\n html[data-embed=\"true\"] .semantic-lens-overlay { display: none; }\n svg[data-focus-active] [data-node-id],\n svg[data-focus-active] [data-edge-from] { opacity: 0.13; }\n svg[data-focus-active] [data-focus-match] { opacity: 1; }\n svg[data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n\n /* Authored Reachability is a bounded graph query over the relationships\n already present in the artifact. Upstream walks incoming edges;\n downstream walks outgoing edges. It never claims runtime causality and\n changes only viewer emphasis, not canonical geometry or export bytes. */\n svg[data-reach-active] [data-node-id],\n svg[data-reach-active] [data-edge-from] { opacity: 0.09; }\n svg[data-reach-active] [data-reach-match] { opacity: 1; }\n svg[data-reach-active=\"upstream\"] [data-reach-origin] {\n filter: drop-shadow(0 0 11px var(--database-stroke));\n }\n svg[data-reach-active=\"downstream\"] [data-reach-origin] {\n filter: drop-shadow(0 0 11px var(--backend-stroke));\n }\n svg[data-reach-active=\"upstream\"] [data-edge-from][data-reach-match] {\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--database-stroke) 72%, transparent));\n }\n svg[data-reach-active=\"downstream\"] [data-edge-from][data-reach-match] {\n filter: drop-shadow(0 0 4px color-mix(in srgb, var(--backend-stroke) 72%, transparent));\n }\n svg[data-preset=\"blueprint\"][data-reach-active] [data-reach-origin],\n svg[data-preset=\"blueprint\"][data-reach-active] [data-edge-from][data-reach-match] {\n filter: none;\n }\n\n /* Direct Relationship Explorer makes authored paths a real input surface\n without changing their visible stroke or canonical SVG. A transparent\n runtime rail supplies forgiving pointer geometry; the exact authored\n path and endpoints continue to carry every visible state. */\n .relationship-hit-overlay { pointer-events: none; }\n .relationship-hit-target { outline: none; }\n .relationship-hit-rail {\n fill: none;\n stroke: transparent;\n stroke-width: 24;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n pointer-events: stroke;\n cursor: pointer;\n }\n .relationship-focus-rail {\n fill: none;\n stroke: color-mix(in srgb, var(--frontend-stroke) 34%, transparent);\n stroke-width: 6;\n stroke-dasharray: 2 4;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n pointer-events: none;\n opacity: 0;\n }\n .relationship-hit-target:focus-visible .relationship-focus-rail {\n opacity: 1;\n }\n svg[data-preset=\"blueprint\"] .relationship-hit-target:focus-visible .relationship-focus-rail {\n stroke-linecap: square;\n filter: none;\n }\n svg[data-relationship-direct-active] [data-node-id],\n svg[data-relationship-direct-active] [data-edge-from] { opacity: 0.16; }\n svg[data-relationship-direct-active] [data-relationship-preview],\n svg[data-relationship-direct-active] [data-relationship-preview-node] { opacity: 1; }\n svg[data-focus-active]:not([data-relationship-pin-active]) .relationship-hit-rail,\n svg[data-story-active] .relationship-hit-rail,\n svg[data-route-picking] .relationship-hit-rail,\n svg[data-route-active] .relationship-hit-rail,\n svg[data-lens-active] .relationship-hit-rail,\n svg[data-chapter-preview] .relationship-hit-rail { pointer-events: none; }\n html[data-embed=\"true\"] .relationship-hit-overlay { display: none; }\n @media (hover: none), (pointer: coarse) {\n .relationship-hit-rail { stroke-width: 24; }\n }\n\n /* Relationship Preview is temporary exploration state layered on top of\n neighborhood focus. It changes emphasis only; exported geometry and the\n relationship's original solid/dashed visual language stay untouched. */\n svg[data-relationship-preview-active] [data-focus-match] { opacity: 0.18; }\n svg[data-relationship-preview-active] [data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview-node] { opacity: 1; }\n svg[data-relationship-preview-active] [data-relationship-preview] {\n filter: drop-shadow(0 0 5px var(--arrow-emphasis));\n }\n svg[data-relationship-preview-active] [data-relationship-preview] path,\n svg[data-relationship-preview-active] path[data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview] line,\n svg[data-relationship-preview-active] line[data-relationship-preview],\n svg[data-relationship-preview-active] [data-relationship-preview] polyline,\n svg[data-relationship-preview-active] polyline[data-relationship-preview] {\n stroke-width: 2.75;\n }\n svg[data-relationship-preview-active] [data-relationship-preview-source] {\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n }\n svg[data-relationship-preview-active] [data-relationship-preview-target] {\n filter: drop-shadow(0 0 7px var(--database-stroke));\n }\n .relationship-pulse-overlay { pointer-events: none; }\n .relationship-flow-pulse {\n fill: none;\n stroke: var(--arrow-emphasis);\n stroke-width: 3.35;\n stroke-linecap: round;\n stroke-dasharray: 0.085 0.915;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0;\n filter: drop-shadow(0 0 4px var(--arrow-emphasis));\n animation: archify-relationship-pulse 1.2s linear 1 both;\n }\n svg[data-preset=\"signal-flow\"] .relationship-flow-pulse {\n stroke: var(--frontend-stroke);\n stroke-width: 3.85;\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"] .relationship-flow-pulse {\n stroke-width: 2.5;\n stroke-linecap: square;\n filter: none;\n }\n svg[data-preset=\"editorial\"] .relationship-flow-pulse {\n stroke: var(--arrow-emphasis);\n stroke-width: 2.75;\n filter: none;\n }\n .semantic-flow-token {\n color: var(--frontend-stroke);\n opacity: 0;\n pointer-events: none;\n }\n .relationship-flow-token {\n animation: archify-relationship-token-life 1.2s linear 1 both;\n }\n .story-flow-token {\n animation: archify-relationship-token-life 0.78s linear 1 both;\n }\n .semantic-flow-token-halo {\n fill: var(--mask);\n stroke: currentColor;\n stroke-width: 1.1;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n }\n .relationship-flow-token-shape {\n fill: var(--mask);\n stroke: currentColor;\n stroke-width: 1.35;\n stroke-linecap: round;\n stroke-linejoin: round;\n vector-effect: non-scaling-stroke;\n }\n .relationship-flow-token-ink {\n fill: none;\n stroke: currentColor;\n stroke-width: 1.05;\n stroke-linecap: round;\n vector-effect: non-scaling-stroke;\n }\n .relationship-flow-token-dot { fill: currentColor; stroke: none; }\n .semantic-flow-token[data-token-kind=\"data\"] { color: var(--database-stroke); }\n .semantic-flow-token[data-token-kind=\"event\"] { color: var(--messagebus-stroke); }\n .semantic-flow-token[data-token-kind=\"security\"] { color: var(--security-stroke); }\n .semantic-flow-token[data-token-kind=\"state\"] { color: var(--cloud-stroke); }\n svg[data-preset=\"signal-flow\"] .semantic-flow-token {\n filter: drop-shadow(0 0 5px currentColor);\n }\n svg[data-preset=\"blueprint\"] .semantic-flow-token { filter: none; }\n svg[data-preset=\"editorial\"] .semantic-flow-token { filter: none; }\n html[data-embed=\"true\"] .relationship-pulse-overlay { display: none; }\n\n /* Intent Trace is a temporary, pre-click exploration layer. Related\n topology stays readable while a short viewer-only signal runs over\n cloned edge geometry; the authored edge remains untouched underneath. */\n svg[data-intent-trace-active] [data-node-id],\n svg[data-intent-trace-active] [data-edge-from] { opacity: 0.2; }\n svg[data-intent-trace-active] [data-intent-trace-match] { opacity: 1; }\n svg[data-intent-trace-active] [data-intent-trace-selected] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n .intent-trace-overlay { pointer-events: none; }\n .intent-trace-flow {\n fill: none;\n stroke-width: 3.1;\n stroke-linecap: round;\n stroke-dasharray: 0.1 0.9;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.94;\n animation: archify-intent-trace-flow 1.15s linear 1 both;\n }\n /* Direction names describe each edge relative to the focused node only.\n The cloned geometry already runs from the authored source to target, so\n incoming and outgoing signals must share the same playback direction. */\n .intent-trace-flow[data-direction=\"out\"] {\n stroke: var(--frontend-stroke);\n filter: drop-shadow(0 0 4px var(--frontend-stroke));\n }\n .intent-trace-flow[data-direction=\"in\"] {\n stroke: var(--database-stroke);\n filter: drop-shadow(0 0 4px var(--database-stroke));\n animation-direction: normal;\n }\n .intent-trace-flow[data-direction=\"loop\"] {\n stroke: var(--security-stroke);\n filter: drop-shadow(0 0 4px var(--security-stroke));\n }\n svg[data-preset=\"blueprint\"] [data-intent-trace-selected],\n svg[data-preset=\"blueprint\"] .intent-trace-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"editorial\"] [data-intent-trace-selected],\n svg[data-preset=\"editorial\"] .intent-trace-flow { filter: none; }\n .intent-trace-status {\n position: absolute;\n width: 1px;\n height: 1px;\n padding: 0;\n margin: -1px;\n overflow: hidden;\n clip: rect(0, 0, 0, 0);\n clip-path: inset(50%);\n white-space: nowrap;\n border: 0;\n }\n\n /* Route Probe separates a durable two-point query from selection and\n one-hop hover. Only the chosen shortest directed path stays prominent;\n the traveling signal is cloned viewer geometry and never authored SVG. */\n svg[data-route-picking=\"target\"] [data-node-id] { opacity: 0.24; }\n svg[data-route-picking=\"target\"] [data-route-candidate],\n svg[data-route-picking=\"target\"] [data-route-start] { opacity: 1; }\n svg[data-route-picking] [data-node-id] { cursor: crosshair; }\n svg[data-route-picking] [data-route-start] {\n filter: drop-shadow(0 0 10px var(--frontend-stroke));\n }\n svg[data-route-active] [data-node-id],\n svg[data-route-active] [data-edge-from] { opacity: 0.11; }\n svg[data-route-active] [data-route-match] { opacity: 1; }\n svg[data-route-active] [data-route-start] {\n filter: drop-shadow(0 0 11px var(--frontend-stroke));\n }\n svg[data-route-active] [data-route-end] {\n filter: drop-shadow(0 0 11px var(--security-stroke));\n }\n svg[data-route-active] [data-route-step]:not([data-route-start]):not([data-route-end]) {\n filter: drop-shadow(0 0 7px var(--backend-stroke));\n }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"past\"] { opacity: 0.62; }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"future\"] { opacity: 0.34; }\n svg[data-route-journey] [data-route-match][data-route-journey-state=\"current\"] { opacity: 1; }\n svg[data-route-journey] [data-node-id][data-route-journey-current] {\n filter: drop-shadow(0 0 10px var(--backend-stroke));\n }\n svg[data-route-journey] [data-edge-from][data-route-journey-current] {\n opacity: 1;\n filter: drop-shadow(0 0 6px var(--backend-stroke));\n }\n .route-probe-overlay { pointer-events: none; }\n .route-journey-overlay { pointer-events: none; }\n .route-probe-flow {\n fill: none;\n stroke: var(--backend-stroke);\n stroke-width: 3.25;\n stroke-linecap: round;\n stroke-dasharray: 0.085 0.915;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0.96;\n filter: drop-shadow(0 0 5px var(--backend-stroke));\n animation: archify-route-probe-flow 1.1s cubic-bezier(0.22, 1, 0.36, 1) 1 both;\n animation-delay: calc(var(--route-step, 0) * 0.16s);\n }\n .route-journey-flow {\n fill: none;\n stroke: var(--backend-stroke);\n stroke-width: 3.5;\n stroke-linecap: round;\n stroke-dasharray: 0.1 0.9;\n stroke-dashoffset: 0;\n vector-effect: non-scaling-stroke;\n opacity: 0;\n filter: drop-shadow(0 0 6px var(--backend-stroke));\n animation: archify-route-journey-flow 780ms cubic-bezier(0.22, 1, 0.36, 1) 1 both;\n }\n svg[data-preset=\"blueprint\"] [data-route-start],\n svg[data-preset=\"blueprint\"] [data-route-end],\n svg[data-preset=\"blueprint\"] [data-route-step],\n svg[data-preset=\"blueprint\"] .route-probe-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"blueprint\"] .route-journey-flow {\n filter: none;\n stroke-linecap: square;\n }\n svg[data-preset=\"editorial\"] [data-route-start],\n svg[data-preset=\"editorial\"] [data-route-end],\n svg[data-preset=\"editorial\"] [data-route-step],\n svg[data-preset=\"editorial\"] .route-probe-flow,\n svg[data-preset=\"editorial\"] .route-journey-flow { filter: none; }\n\n svg[data-preset=\"editorial\"] .c-grid {\n stroke-dasharray: 1 4;\n opacity: 0.48;\n }\n svg[data-preset=\"editorial\"] .c-region {\n fill: color-mix(in srgb, var(--cloud-fill) 48%, transparent);\n stroke-dasharray: 9 4;\n }\n svg[data-preset=\"editorial\"] [data-node-id]:hover,\n svg[data-preset=\"editorial\"] [data-node-id]:focus-visible,\n svg[data-preset=\"editorial\"][data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 18%, transparent));\n }\n\n svg[data-preset=\"blueprint\"] .c-grid {\n stroke-dasharray: 1 3;\n opacity: 0.78;\n }\n svg[data-preset=\"blueprint\"] .c-region {\n fill: color-mix(in srgb, var(--cloud-fill) 58%, transparent);\n stroke-dasharray: 12 4 2 4;\n }\n svg[data-preset=\"blueprint\"] .c-security-group,\n svg[data-preset=\"blueprint\"] .c-lane { stroke-dasharray: 7 3; }\n svg[data-preset=\"blueprint\"] [data-node-id]:hover,\n svg[data-preset=\"blueprint\"] [data-node-id]:focus-visible {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"][data-focus-active] [data-focus-selected] {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n svg[data-preset=\"blueprint\"][data-focus-active][data-reach-active] [data-focus-selected][data-reach-origin] {\n filter: none;\n }\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview],\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview-source],\n svg[data-preset=\"blueprint\"][data-relationship-preview-active] [data-relationship-preview-target] {\n filter: drop-shadow(0 0 3px var(--frontend-stroke));\n }\n\n /* Story Trail is a viewer-only overlay derived from the ordered focus IDs\n of the active guided view. The authored edge stays underneath with its\n original color, dash pattern, marker, and geometry intact. */\n .story-trail-overlay { pointer-events: none; }\n .story-carrier-overlay { pointer-events: none; }\n .story-trail-flow {\n fill: none;\n stroke: var(--frontend-stroke);\n stroke-width: 2.8;\n stroke-linecap: round;\n vector-effect: non-scaling-stroke;\n opacity: 0.34;\n filter: drop-shadow(0 0 2px var(--frontend-stroke));\n }\n svg[data-story-beat] [data-story-step] {\n opacity: 0.22;\n filter: saturate(0.42);\n transition: opacity 180ms ease, filter 180ms ease;\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"past\"] {\n opacity: 0.72;\n filter: saturate(0.82);\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"next\"] {\n opacity: 0.5;\n filter: saturate(0.66);\n }\n svg[data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n opacity: 1;\n filter: drop-shadow(0 0 7px var(--frontend-stroke));\n animation: archify-story-beat-node 360ms cubic-bezier(0.22, 1, 0.36, 1) both;\n }\n svg[data-story-beat] [data-edge-from][data-story-beat-step] {\n opacity: 0.16;\n transition: opacity 160ms ease;\n }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"past\"] { opacity: 0.58; }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"next\"] { opacity: 0.34; }\n svg[data-story-beat] [data-edge-from][data-story-beat-step][data-story-beat-state=\"active\"] { opacity: 1; }\n svg[data-story-beat] .story-trail-flow { opacity: 0; transition: opacity 160ms ease; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"past\"] { opacity: 0.34; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"next\"] { opacity: 0.2; }\n svg[data-story-beat] .story-trail-flow[data-story-beat-state=\"active\"] { opacity: 0.92; }\n svg[data-story-beat] .story-trail-flow[data-story-pulse=\"true\"] {\n stroke-dasharray: 2 13;\n stroke-dashoffset: 30;\n opacity: 0.92;\n animation: archify-story-flow 0.78s linear 1 both;\n }\n svg[data-preset=\"blueprint\"] .story-trail-flow {\n stroke-linecap: square;\n filter: none;\n opacity: 0.5;\n }\n svg[data-preset=\"blueprint\"][data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n filter: none;\n animation: none;\n }\n svg[data-preset=\"editorial\"] .story-trail-flow { filter: none; }\n svg[data-preset=\"editorial\"][data-story-beat] [data-story-step][data-story-beat-state=\"active\"] {\n filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 16%, transparent));\n }\n\n /* Chapter Delta Preview is a static, pre-commit comparison between two\n chapter focus sets. Symbols in the rail carry the meaning without color;\n these SVG rules only make exact stable-ID membership easier to scan. */\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] {\n opacity: 0.1 !important;\n filter: none !important;\n transition: none !important;\n }\n svg[data-chapter-preview] .story-trail-overlay { opacity: 0.08 !important; }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"stay\"] {\n opacity: 0.76 !important;\n filter: saturate(0.7) !important;\n }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"enter\"] {\n opacity: 1 !important;\n filter: saturate(1.2) !important;\n }\n svg[data-chapter-preview] [data-node-id][data-chapter-preview-role=\"leave\"] {\n opacity: 0.28 !important;\n filter: grayscale(0.72) !important;\n }\n svg[data-preset=\"blueprint\"][data-chapter-preview] [data-node-id] { filter: none !important; }\n\n /* Dashed boundary variants */\n .c-security-group { fill: transparent; stroke: var(--security-stroke); stroke-dasharray: 4,4; }\n .c-region { fill: rgba(251, 191, 36, 0.05); stroke: var(--cloud-stroke); stroke-dasharray: 8,4; }\n .c-lane { fill: var(--lane-fill); stroke: var(--lane-stroke); stroke-dasharray: 6,6; }\n\n /* Optional trace animation, enabled only by meta.animation = \"trace\".\n The ordinary viewer performs one ambient pass and then restores the\n authored solid/security/async line language. WebM samples the same\n authored geometry into an explicit canvas timeline. */\n html[data-ambient-motion=\"running\"] svg[data-animation=\"trace\"] [data-animate=\"edge\"] {\n animation: archify-edge-flow 2.4s linear 1;\n animation-delay: calc(var(--step, 0) * 160ms);\n }\n html[data-ambient-motion=\"running\"] svg[data-animation=\"trace\"] [data-animate=\"node\"] {\n transform-box: fill-box;\n transform-origin: center;\n animation: archify-node-pulse 3.6s ease-in-out 1;\n animation-delay: calc(var(--step, 0) * 160ms);\n }\n svg[data-preset=\"signal-flow\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n stroke-linecap: round;\n filter: drop-shadow(0 0 3px var(--arrow-emphasis));\n animation-duration: 1.75s;\n }\n svg[data-preset=\"signal-flow\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-duration: 3.1s;\n }\n svg[data-preset=\"blueprint\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n stroke-linecap: square;\n filter: none;\n animation-duration: 2.15s;\n }\n svg[data-preset=\"blueprint\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-name: archify-blueprint-node-pulse;\n animation-duration: 3.8s;\n }\n svg[data-preset=\"editorial\"][data-animation=\"trace\"] [data-animate=\"edge\"] {\n filter: none;\n animation-duration: 2.2s;\n }\n svg[data-preset=\"editorial\"][data-animation=\"trace\"] [data-animate=\"node\"] {\n animation-name: archify-editorial-node-pulse;\n animation-duration: 3.5s;\n }\n /* Embedded proofs are static until a named Story Trail chapter is played.\n This keeps proof grids calm and ensures ?play=1 stops all viewer motion\n after one 3.2 second chapter instead of leaving ambient trace loops on. */\n html[data-embed=\"true\"] svg[data-animation=\"trace\"] [data-animate],\n html[data-share-playback=\"true\"] svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n stroke-dashoffset: 0;\n }\n @keyframes archify-edge-flow {\n 0% { stroke-dasharray: 10 8; stroke-dashoffset: 54; opacity: 0.42; }\n 88% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }\n 99.9% { stroke-dasharray: 10 8; stroke-dashoffset: 0; opacity: 1; }\n 100% { stroke-dashoffset: 0; opacity: 1; }\n }\n @keyframes archify-node-pulse {\n 0%, 72%, 100% { filter: none; stroke-width: 1.5; }\n 18%, 36% {\n filter: drop-shadow(0 0 8px var(--arrow-emphasis));\n stroke-width: 2.4;\n }\n }\n @keyframes archify-blueprint-node-pulse {\n 0%, 72%, 100% { opacity: 1; filter: none; }\n 18%, 36% { opacity: 0.72; filter: drop-shadow(0 0 2px var(--frontend-stroke)); }\n }\n @keyframes archify-editorial-node-pulse {\n 0%, 72%, 100% { opacity: 1; filter: none; }\n 18%, 36% { opacity: 0.78; filter: drop-shadow(0 2px 2px color-mix(in srgb, var(--text) 18%, transparent)); }\n }\n @keyframes archify-signal-scan {\n 0%, 18% { opacity: 1; transform: translateX(-70%); }\n 70% { opacity: 1; transform: translateX(70%); }\n 100% { opacity: 0; transform: translateX(70%); }\n }\n @keyframes archify-radar-live {\n 0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--backend-stroke) 52%, transparent); }\n 55%, 100% { box-shadow: 0 0 0 0.32rem transparent; }\n }\n @keyframes archify-guided-progress {\n from { transform: scaleX(var(--guided-progress-start, 0)); }\n to { transform: scaleX(1); }\n }\n @keyframes archify-story-flow {\n to { stroke-dashoffset: 0; }\n }\n @keyframes archify-intent-trace-flow {\n 0% { opacity: 0.28; stroke-dashoffset: 0; }\n 12%, 78% { opacity: 0.94; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-route-probe-flow {\n 0% { stroke-dashoffset: 0; opacity: 0.96; }\n 78% { stroke-dashoffset: -1; opacity: 0.96; }\n 100% { stroke-dasharray: none; stroke-dashoffset: 0; opacity: 0.58; }\n }\n @keyframes archify-route-journey-flow {\n 0% { opacity: 0.16; stroke-dashoffset: 0; }\n 14%, 76% { opacity: 1; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-semantic-lens-flow {\n 0% { opacity: 0.2; stroke-dashoffset: 0; }\n 12%, 78% { opacity: 0.9; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-relationship-pulse {\n 0% { opacity: 0.18; stroke-dashoffset: 0; }\n 10%, 76% { opacity: 0.98; }\n 100% { opacity: 0; stroke-dashoffset: -1; }\n }\n @keyframes archify-relationship-token-life {\n 0%, 7% { opacity: 0; }\n 13%, 82% { opacity: 1; }\n 100% { opacity: 0; }\n }\n @keyframes archify-story-beat-node {\n from { opacity: 0.48; filter: saturate(0.6); }\n 58% { opacity: 1; filter: drop-shadow(0 0 10px var(--frontend-stroke)); }\n to { opacity: 1; filter: drop-shadow(0 0 7px var(--frontend-stroke)); }\n }\n @keyframes archify-share-cue-enter {\n from { opacity: 0; transform: translate(-50%, -0.45rem); }\n to { opacity: 1; transform: translate(-50%, 0); }\n }\n @keyframes archify-share-cue-pulse {\n 0%, 100% { opacity: 1; transform: scale(1); }\n 50% { opacity: 0.48; transform: scale(0.78); }\n }\n @media (prefers-reduced-motion: reduce) {\n html[data-preset=\"signal-flow\"] .diagram-container::before {\n animation: none !important;\n }\n .pulse-dot { animation: none !important; }\n svg[data-animation=\"trace\"] [data-animate] {\n animation: none !important;\n stroke-dashoffset: 0;\n }\n .guided-view-progress span {\n animation: none !important;\n transform: scaleX(1) !important;\n }\n .story-trail-flow,\n .intent-trace-flow,\n .route-probe-flow,\n .semantic-lens,\n .diagram-guide,\n [data-story-step],\n .overview-map-live,\n .guided-view-stop,\n .share-chapter-cue,\n .chapter-handoff-anchor,\n .share-chapter-state::before,\n .share-chapter-progress span { animation: none !important; }\n .guided-view-chapter,\n svg[data-chapter-preview] [data-node-id],\n svg[data-chapter-preview] [data-edge-from] { transition: none !important; }\n svg[data-story-playing=\"true\"] .story-trail-flow {\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.55;\n }\n .intent-trace-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.72;\n }\n .route-probe-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-dashoffset: 0;\n opacity: 0.78;\n }\n .route-journey-overlay,\n .story-carrier-overlay { display: none !important; }\n .semantic-lens-flow {\n animation: none !important;\n stroke-dasharray: none;\n stroke-width: 2.2;\n opacity: 0.34;\n filter: none;\n }\n .relationship-pulse-overlay { display: none !important; }\n .guided-view-chapter { transition: none !important; }\n .source-evidence-beacon,\n svg [data-node-id], svg [data-edge-from], svg [data-detail], svg [data-detail-anchor], svg [data-legend-hit], svg { transition: none !important; }\n }\n ";
let activeIndex = -1;
let playbackToken = 0;
let playbackTimer = 0;
diff --git a/examples/checkout-platform-delta.receipt.json b/examples/checkout-platform-delta.receipt.json
index 70e0d4fd..a099d9b9 100644
--- a/examples/checkout-platform-delta.receipt.json
+++ b/examples/checkout-platform-delta.receipt.json
@@ -219,8 +219,8 @@
"Boundary identity is conservatively derived from kind + label."
],
"artifact": {
- "sha256": "d17be99a05b83d8b6e8673189fba045bc1bc43e28b3cada322bfd9d29f45972f",
- "bytes": 2009103
+ "sha256": "77547966a24755da8ea21914afff28503567f95b99544b3144b18571412acdce",
+ "bytes": 2023742
},
"validation": {
"checksPassed": 28,
diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.html
index 5c5aa1a3..4a3c6288 100644
--- a/examples/dataflow-product-analytics.html
+++ b/examples/dataflow-product-analytics.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5956,6 +5963,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6130,6 +6138,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11093,9 +11102,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11106,10 +11115,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11126,26 +11138,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11159,15 +11221,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11176,50 +11246,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11227,6 +11340,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11248,8 +11365,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11268,7 +11385,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11289,6 +11406,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11308,6 +11426,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11393,9 +11512,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11517,9 +11670,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.html
index b0e9d5c0..ea79fa9b 100644
--- a/examples/lifecycle-agent-run.html
+++ b/examples/lifecycle-agent-run.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5905,6 +5912,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6079,6 +6087,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11042,9 +11051,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11055,10 +11064,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11075,26 +11087,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11108,15 +11170,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11125,50 +11195,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11176,6 +11289,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11197,8 +11314,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11217,7 +11334,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11238,6 +11355,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11257,6 +11375,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11342,9 +11461,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11466,9 +11619,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/examples/maka-architecture.html b/examples/maka-architecture.html
index 8cb264c3..f0446520 100644
--- a/examples/maka-architecture.html
+++ b/examples/maka-architecture.html
@@ -3,7 +3,7 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="generator" content="archify 2.15.0">
+ <meta name="generator" content="archify 2.16.0-dev.0">
<title>Maka Diagram</title>
<script>
// Resolve the theme before first paint so light-preference users don't
@@ -586,10 +586,13 @@
justify-content: center;
min-height: 0;
padding: 0.75rem;
+ padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -655,7 +658,7 @@
}
html[data-preset="signal-flow"] .header-row::after {
- content: "SIGNAL FLOW";
+ content: attr(data-preset-badge-signal-flow);
margin-left: auto;
color: var(--frontend-stroke);
border: 1px solid var(--frontend-stroke);
@@ -679,7 +682,7 @@
animation: none;
}
html[data-preset="blueprint"] .header-row::after {
- content: "BLUEPRINT / REV 01";
+ content: attr(data-preset-badge-blueprint);
margin-left: auto;
padding: 0.28rem 0.55rem;
border-top: 1px solid var(--frontend-stroke);
@@ -708,7 +711,7 @@
animation: none;
}
html[data-preset="editorial"] .header-row::after {
- content: "EDITORIAL / FIELD NOTE";
+ content: attr(data-preset-badge-editorial);
margin-left: auto;
padding: 0.32rem 0 0.24rem;
border-bottom: 2px solid var(--arrow-emphasis);
@@ -722,10 +725,12 @@
}
.diagram-container {
+ --archify-nav-reserve: 0px;
background: var(--panel);
border-radius: 1rem;
border: 1px solid var(--panel-border);
padding: 1.5rem;
+ padding-bottom: calc(1.5rem + var(--archify-nav-reserve));
overflow: hidden;
position: relative;
}
@@ -785,7 +790,7 @@
border: 1px solid var(--panel-border);
background: var(--panel);
color: var(--arrow-emphasis);
- content: "ARCHIFY / PLATE 04";
+ content: attr(data-preset-badge-editorial-plate);
font-family: Georgia, 'Times New Roman', serif;
font-size: 0.52rem;
font-style: italic;
@@ -1052,7 +1057,7 @@
.overview-map {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 12;
width: 11.25rem;
overflow: hidden;
@@ -1085,6 +1090,36 @@
padding: 0.42rem 0.48rem 0.38rem 0.55rem;
border-bottom: 1px solid var(--toolbar-border);
background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);
+ cursor: grab;
+ touch-action: none;
+ user-select: none;
+ }
+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }
+ .overview-map[data-placement-invalid="true"] {
+ border-color: var(--security-stroke);
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);
+ }
+ .overview-map[data-compact="true"] {
+ width: 7.4rem;
+ }
+ .overview-map[data-compact="true"] .overview-map-head {
+ grid-template-columns: minmax(0, 1fr) auto;
+ gap: 0.24rem;
+ min-height: 1.5rem;
+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;
+ border-bottom: 0;
+ }
+ .overview-map[data-compact="true"] .overview-map-live,
+ .overview-map[data-compact="true"] .overview-map-copy,
+ .overview-map[data-compact="true"] .overview-map-surface,
+ .overview-map[data-compact="true"] .overview-map-hint {
+ display: none;
+ }
+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }
+ .overview-map[data-compact="true"] .overview-map-close {
+ width: 1.15rem;
+ height: 1.15rem;
+ font-size: 0.72rem;
}
.overview-map-live {
width: 0.42rem;
@@ -1115,6 +1150,26 @@
white-space: nowrap;
text-overflow: ellipsis;
}
+ .overview-map-expand {
+ display: none;
+ align-items: center;
+ justify-content: center;
+ min-width: 0;
+ height: 1.2rem;
+ padding: 0 0.34rem;
+ overflow: hidden;
+ border: 0;
+ border-radius: 0.3rem;
+ background: transparent;
+ color: var(--frontend-stroke);
+ font: inherit;
+ font-size: 0.49rem;
+ font-weight: 700;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ white-space: nowrap;
+ cursor: pointer;
+ }
.overview-map-close {
width: 1.55rem;
height: 1.55rem;
@@ -1127,8 +1182,11 @@
font-size: 0.9rem;
cursor: pointer;
}
+ .overview-map-expand:hover,
+ .overview-map-expand:focus-visible,
.overview-map-close:hover,
.overview-map-close:focus-visible { background: var(--toolbar-hover); }
+ .overview-map-expand:focus-visible,
.overview-map-close:focus-visible,
.overview-map-surface:focus-visible,
.overview-map-node:focus-visible {
@@ -1210,6 +1268,24 @@
color: var(--frontend-stroke);
background: var(--toolbar-hover);
}
+ .overview-map-feedback {
+ position: absolute;
+ right: 1rem;
+ bottom: 4.15rem;
+ z-index: 13;
+ max-width: min(16rem, calc(100% - 2rem));
+ padding: 0.38rem 0.55rem;
+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));
+ border-radius: 0.5rem;
+ background: var(--toolbar-menu-bg);
+ color: var(--toolbar-text);
+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+ font-size: 0.52rem;
+ line-height: 1.35;
+ pointer-events: none;
+ }
+ .overview-map-feedback[hidden] { display: none; }
+ .focus-chip[data-radar-yielded="true"] { display: none !important; }
.diagram-nav #btn-route-probe[aria-pressed="true"] {
color: var(--backend-stroke);
background: var(--toolbar-hover);
@@ -1226,7 +1302,7 @@
.semantic-lens {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 24;
width: min(20rem, calc(100% - 2rem));
overflow: hidden;
@@ -1401,7 +1477,7 @@
.route-probe {
position: absolute;
left: 1rem;
- bottom: 1rem;
+ bottom: calc(1rem + var(--archify-nav-reserve));
z-index: 12;
width: min(46rem, calc(100% - 25rem));
min-width: 18rem;
@@ -2800,13 +2876,22 @@
scrolling at 900–1080px heights. */
@media (min-width: 768px) and (max-height: 1100px) {
.header { margin-bottom: 1rem; }
- .diagram-container { padding: 0.875rem; }
+ .diagram-container {
+ padding: 0.875rem;
+ padding-bottom: calc(0.875rem + var(--archify-nav-reserve));
+ }
.cards { margin-top: 1rem; }
.card { padding: 1rem; }
}
@media (min-width: 768px) and (max-height: 920px) {
+ body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -2921,6 +3006,7 @@
svg[data-chapter-preview] [data-node-id],
svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }
.diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }
+ .diagram-container { --archify-nav-reserve: 0px !important; }
html[data-preset="signal-flow"] .diagram-container,
html[data-preset="signal-flow"] .card { background: #ffffff; }
.cards { grid-template-columns: 1fr 1fr; }
@@ -3572,16 +3658,17 @@
width: min(10.25rem, calc(100% - 1rem));
}
.overview-map[data-docked="true"] {
- right: 0.5rem;
+ right: var(--archify-radar-right, 0.5rem);
top: var(--archify-radar-top, 0.5rem);
bottom: auto;
transform: none !important;
}
.overview-map[data-docked="true"][data-dock-side="left"] {
right: auto;
- left: 0.5rem;
+ left: var(--archify-radar-left, 0.5rem);
}
.overview-map-surface { height: 4rem; }
+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }
.semantic-lens {
right: 0.5rem;
bottom: 3.7rem;
@@ -4863,7 +4950,10 @@
<div class="container">
<!-- Header -->
<div class="header">
- <div class="header-row">
+ <div class="header-row"
+ data-preset-badge-signal-flow="SIGNAL FLOW"
+ data-preset-badge-blueprint="BLUEPRINT / REV 01"
+ data-preset-badge-editorial="EDITORIAL / FIELD NOTE">
<div class="pulse-dot"></div>
<h1>Maka</h1>
</div>
@@ -4872,6 +4962,7 @@
<script id="archify-guided-views-data" type="application/json">[]</script>
+ <script id="archify-i18n-data" type="application/json">{"locale":"en","messages":{"viewer.kind.frontend":"Frontend","viewer.kind.backend":"Backend","viewer.kind.database":"Database","viewer.kind.cloud":"Cloud","viewer.kind.security":"Security","viewer.kind.messagebus":"Message bus","viewer.kind.external":"External","viewer.kind.neutral":"Neutral","viewer.kind.node":"Node","viewer.kind.start":"Start","viewer.kind.active":"Active","viewer.kind.waiting":"Waiting","viewer.kind.decision":"Decision","viewer.kind.success":"Success","viewer.kind.failure":"Failure","viewer.toolbar.actions":"Diagram actions","viewer.theme.toggle.title":"Toggle theme (T)","viewer.theme.toggle":"Toggle color theme","viewer.theme.dark":"Dark","viewer.theme.light":"Light","viewer.preset.choose.title":"Choose visual style (S cycles)","viewer.preset.choose":"Choose visual style","viewer.preset.style":"Style","viewer.preset.menu":"Visual style","viewer.preset.identity":"Visual identity","viewer.preset.cycles":"S cycles","viewer.preset.classic":"Classic","viewer.preset.classic.short":"Classic","viewer.preset.classic.hint":"Stable technical default","viewer.preset.flow":"Signal Flow","viewer.preset.flow.short":"Flow","viewer.preset.flow.hint":"Motion-forward presentation","viewer.preset.blueprint":"Blueprint","viewer.preset.blueprint.hint":"Engineering review","viewer.preset.editorial":"Editorial","viewer.preset.editorial.hint":"Publication and launch notes","viewer.preset.badge.signalFlow":"SIGNAL FLOW","viewer.preset.badge.blueprint":"BLUEPRINT / REV 01","viewer.preset.badge.editorial":"EDITORIAL / FIELD NOTE","viewer.preset.badge.editorialPlate":"ARCHIFY / PLATE 04","viewer.preset.current":"Visual style: {style}. Choose visual style","viewer.motion.live":"Live","viewer.motion.still":"Still","viewer.motion.pause":"Pause motion","viewer.motion.resume":"Resume motion","viewer.motion.reduced":"Motion paused by reduced-motion preference","viewer.motion.hidden":"Motion paused while this page is hidden","viewer.motion.yielding":"Pause motion; currently yielding to {owner}","viewer.motion.yielding.title":"Live preview enabled · yielding to {owner}","viewer.owner.story":"the guided story","viewer.owner.chapter":"the active chapter","viewer.owner.chapterPreview":"the chapter delta preview","viewer.owner.handoff":"the chapter handoff","viewer.owner.route":"Route Probe","viewer.owner.lens":"Semantic Lens","viewer.owner.relationship":"Relationship Preview","viewer.owner.intent":"Intent Trace","viewer.owner.focus":"semantic focus","viewer.owner.legend":"legend preview","viewer.owner.reader":"reader interaction","viewer.present.enter":"Enter presentation stage","viewer.present.enter.title":"Presentation stage (F)","viewer.present.exit":"Exit presentation stage","viewer.present.exit.title":"Exit presentation stage (F or Escape)","viewer.present.present":"Present","viewer.present.exit.label":"Exit","viewer.export.button":"Export","viewer.export.button.title":"Export diagram (E)","viewer.export.diagram":"Export diagram","viewer.export.menu":"Export","viewer.export.subtitle":"Portable, clean outputs","viewer.export.share":"Share","viewer.export.shareCard":"Share Card","viewer.export.routeShareCard":"Route Share Card","viewer.export.reachShareCard":"Reach Share Card","viewer.export.copyShareCard":"Copy Share Card","viewer.export.copyDiagram":"Copy diagram","viewer.export.clipboardPng":"PNG to clipboard","viewer.export.raster":"Raster images","viewer.export.image":"Image","viewer.export.lossless":"Lossless image","viewer.export.compact":"Compact image","viewer.export.modern":"Modern image","viewer.export.vectorMotion":"Vector and motion","viewer.export.vectorMotion.heading":"Vector \u0026 motion","viewer.export.editable":"Editable vector","viewer.export.motion6s":"6s motion","viewer.export.unsupported":"Not supported by this browser","viewer.export.clipboardUnsupported":"Clipboard image write not supported by this browser","viewer.export.clipboardUnsupported.period":"Clipboard image write not supported by this browser.","viewer.export.clipboardUnsupported.short":"Clipboard image write not supported in this browser.","viewer.export.motionUnavailable":"Motion capture unavailable in this browser","viewer.export.webmUnavailable":"WebM unavailable in this browser","viewer.export.failed":"Export failed: {message}","viewer.export.unknownVariant":"Unknown Share Card variant: {variant}","viewer.export.routeRequired":"Trace a route before exporting a Route Share Card","viewer.export.reachRequired":"Trace authored reach before exporting a Reach Share Card","viewer.export.unknown":"unknown","viewer.export.routeFailed":"Route Share Card export failed: {message}","viewer.export.reachFailed":"Reach Share Card export failed: {message}","viewer.export.copyFailed":"Copy failed: {message}","viewer.export.copiedPng":"Copied PNG to clipboard","viewer.export.copiedShare":"Copied Share Card","viewer.export.downloadedShare":"Downloaded Share Card","viewer.export.downloadedRoute":"Downloaded Route Share Card","viewer.export.downloadedReach":"Downloaded Reach Share Card","viewer.export.downloadedWebm":"Downloaded WebM","viewer.export.recording":"Recording 6 seconds of motion…","viewer.export.card.routeSummary.one":"Route: {source} → {target} · {count} directed hop","viewer.export.card.routeSummary.other":"Route: {source} → {target} · {count} directed hops","viewer.export.card.reachSummary":"Authored {direction} from {origin} · {nodes} · {links} · max {hops}","viewer.export.card.node.one":"{count} node","viewer.export.card.node.other":"{count} nodes","viewer.export.card.link.one":"{count} link","viewer.export.card.link.other":"{count} links","viewer.export.card.hop.one":"{count} hop","viewer.export.card.hop.other":"{count} hops","viewer.export.card.routeBadge":"ARCHIFY · ROUTE · {hops}","viewer.export.card.reachBadge":"ARCHIFY · {direction} REACH","viewer.export.card.defaultBadge":"ARCHIFY · {preset} · {theme}","viewer.export.direction.upstream":"Upstream","viewer.export.direction.downstream":"Downstream","viewer.export.error.canvasUnavailable":"Canvas unavailable for {label}","viewer.export.error.contextUnavailable":"2D canvas context unavailable for {label}","viewer.export.error.toBlobUnavailable":"canvas.toBlob unavailable for {label}","viewer.export.error.toBlobNull":"canvas.toBlob returned no data for {label}","viewer.export.error.variantsCombined":"Share Card variants cannot be combined","viewer.export.error.viewerState":"Share Card export could not remove temporary viewer state","viewer.export.error.routeState":"Route Card export could not preserve the resolved route safely","viewer.export.error.reachState":"Reach Card export could not preserve authored reach safely","viewer.export.error.webmRequirements":"WebM motion export requires a trace animation and browser MediaRecorder support","viewer.export.error.mediaRecorder":"MediaRecorder failed","viewer.export.error.emptyWebm":"MediaRecorder produced an empty WebM","viewer.export.error.webmBackground":"SVG background could not be loaded for WebM export","viewer.guided.region":"Guided diagram views","viewer.guided.previous":"Previous guided view","viewer.guided.previous.title":"Previous guided view ([)","viewer.guided.next":"Next guided view","viewer.guided.next.title":"Next guided view (])","viewer.guided.views":"Guided views","viewer.guided.explore":"Explore this system","viewer.guided.intro":"Step through curated paths without changing the source diagram.","viewer.guided.trail":"Story trail","viewer.guided.beat":"Beat","viewer.guided.nextBeat":"Next","viewer.guided.play":"Play guided story","viewer.guided.play.title":"Play guided story (P)","viewer.guided.pause":"Pause guided story","viewer.guided.pause.title":"Pause guided story (P)","viewer.guided.replay":"Replay guided story","viewer.guided.replay.title":"Replay guided story (P)","viewer.guided.playStory":"Play story","viewer.guided.pauseStory":"Pause","viewer.guided.replayStory":"Replay story","viewer.guided.motionUnavailable":"Story playback unavailable while motion is Still","viewer.guided.enableMotion":"Switch motion to Live to play the guided story","viewer.guided.selectBeatLink":"Select a Story Beat to copy its exact link","viewer.guided.copyMoment":"Copy moment","viewer.guided.momentCopied":"Moment link copied","viewer.guided.momentCopyFailed":"Could not copy story moment link","viewer.guided.copied":"Copied","viewer.guided.copyFailed":"Copy failed","viewer.guided.showAll":"Show all","viewer.guided.showAll.aria":"Show entire diagram","viewer.guided.chapters":"Story chapters","viewer.guided.storyTrail":"Story trail for {label}: {count} beats","viewer.guided.chapter.open":"Open chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.current":"Current chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.selectedNodes":"{count} selected nodes","viewer.guided.chapter.stops":"{count} stops","viewer.guided.chapter.stop.one":"{count} stop","viewer.guided.chapter.stop.other":"{count} stops","viewer.guided.chapter.current.title":"{label} — current chapter, {count} stops","viewer.guided.chapter.delta.expanded":"{stay} stay, {enter} enter, {leave} leave","viewer.guided.chapter.delta.aria":"Open chapter {index} of {total}: {label}. Chapter focus delta: {delta}","viewer.guided.chapter.delta.title":"{label} — {delta} chapter focus","viewer.guided.handoff":"{from} → {to} · via {label}","viewer.guided.share.chapter":"Chapter {index} / {total}","viewer.guided.share.initial":"Chapter 01 / 01","viewer.guided.share.default":"Guided chapter","viewer.guided.state.ready":"Ready","viewer.guided.state.playing":"Playing","viewer.guided.state.settled":"Settled","viewer.guided.state.paused":"Paused","viewer.guided.state.pinned":"Pinned","viewer.guided.state.still":"Still","viewer.guided.share.step":"Step {index} / {total} · {label}","viewer.guided.share.staticMoment":"{step} · Static moment","viewer.guided.share.complete":"{count} steps complete · {note}","viewer.guided.share.settled":"Path settled for reading.","viewer.guided.share.staticPath":"{count} steps · Static path","viewer.guided.share.ready":"{count} steps · Ready","viewer.guided.share.aria":"{state} chapter {index} of {total}: {label}. {beat}. {route}","viewer.guided.beat.start":"Beat {index} / {total} · {label} · starting point","viewer.guided.beat.forward":"Beat {index} / {total} · {from} → {to}","viewer.guided.beat.reverse":"Beat {index} / {total} · {from} → {to} · reverse authored link","viewer.guided.beat.multiple":"Beat {index} / {total} · {from} ⇄ {to} · {count} authored links","viewer.guided.beat.group":"Beat {index} / {total} · {from} · {to} · grouped · no direct link","viewer.guided.beat.aria.prefix":"Story beat {index} of {total}: {label}. ","viewer.guided.beat.aria.start":"Starting point.","viewer.guided.beat.aria.forward":"From {from} through one authored forward relationship.","viewer.guided.beat.aria.reverse":"From {from}; the authored relationship points from {to} to {from}.","viewer.guided.beat.aria.multiple":"From {from} through {count} authored relationships; shown without arbitrary motion.","viewer.guided.beat.aria.group":"Grouped from {from} with no direct authored relationship.","viewer.guided.caption.start":"Starting point","viewer.guided.caption.grouped":"Grouped transition · no direct authored link","viewer.guided.caption.more":" +{count} more","viewer.guided.caption.reverse":"Reverse authored relationship","viewer.guided.caption.relationships":"{count} authored relationships","viewer.guided.caption.relationship":"Authored relationship","viewer.guided.caption.direction":"authored direction: {from} → {to}","viewer.guided.caption.starting":"Authored starting point","viewer.guided.beatLink":"Copy link to current story moment: Beat {index} of {total}: {label}","viewer.guided.noStory":"This diagram has no authored guided story.","viewer.guide.eyebrow":"Diagram guide","viewer.guide.close":"Close diagram guide","viewer.guide.inspecting":"Inspecting compiled semantics","viewer.guide.actions":"Diagram exploration actions","viewer.guide.find":"Find any node","viewer.guide.find.hint":"Search labels, responsibilities, kinds, and stable IDs.","viewer.guide.route":"Trace a route","viewer.guide.route.aria":"Trace a directed route","viewer.guide.route.hint":"Ask how two semantic nodes connect in authored direction.","viewer.guide.map":"See the whole system","viewer.guide.map.hint":"Open Semantic Radar with a live viewport and stable nodes.","viewer.guide.lens":"Compare semantic kinds","viewer.guide.lens.hint":"Count roles, reveal their traffic, and compare direct authored links.","viewer.guide.story":"Play the guided story","viewer.guide.story.hint":"Walk the authored chapters and real relationships.","viewer.guide.present":"Enter Presentation Stage","viewer.guide.present.hint":"Give the live diagram the viewport without changing export.","viewer.guide.shortcuts":"Additional keyboard shortcuts","viewer.guide.shortcut.export":"Export","viewer.guide.shortcut.theme":"Theme","viewer.guide.shortcut.style":"Style","viewer.guide.shortcut.reset":"Reset","viewer.guide.shortcut.zoomIn":"Zoom in","viewer.guide.shortcut.zoomOut":"Zoom out","viewer.guide.shortcut.close":"Close","viewer.guide.facts":"{nodes} · {relationships} · {views}","viewer.guide.fact.node.one":"{count} semantic node","viewer.guide.fact.node.other":"{count} semantic nodes","viewer.guide.fact.relationship.one":"{count} relationship","viewer.guide.fact.relationship.other":"{count} relationships","viewer.guide.fact.view.one":"{count} guided view","viewer.guide.fact.view.other":"{count} guided views","viewer.guide.story.available.one":"Walk {count} authored chapter and its real relationships.","viewer.guide.story.available.other":"Walk {count} authored chapters and their real relationships.","viewer.guide.story.unavailable":"No authored guided story in this diagram.","viewer.guide.open":"Open diagram guide","viewer.guide.noStory":"This diagram has no authored guided story.","viewer.finder.title":"Find a node","viewer.finder.close":"Close node finder","viewer.finder.placeholder":"Search labels or IDs","viewer.finder.search":"Search diagram nodes","viewer.finder.results":"Diagram nodes","viewer.finder.empty":"No matching nodes","viewer.finder.result.focus":"Focus {label}","viewer.finder.result.routeStart":"Choose {label} as route start","viewer.finder.result.routeTarget":"Choose {label} as route destination, {links}","viewer.finder.status.empty":"No matching nodes","viewer.finder.status.count.one":"{count} matching node","viewer.finder.status.count.other":"{count} matching nodes","viewer.finder.noun.nodes":"nodes","viewer.finder.link.one":"{count} link","viewer.finder.link.other":"{count} links","viewer.finder.result.focus.one":"Focus {label}, {count} related connection","viewer.finder.result.focus.other":"Focus {label}, {count} related connections","viewer.finder.status.filtered":"{visible} of {available} {noun}","viewer.finder.status.all":"{available} {noun}","viewer.passport.eyebrow":"Semantic passport","viewer.passport.metadata":"Node metadata","viewer.passport.evidence":"Verified source evidence","viewer.passport.verified":"Verified source","viewer.passport.reach":"Authored reach","viewer.passport.reach.trace":"Trace authored reachability","viewer.passport.upstream":"Upstream","viewer.passport.downstream":"Downstream","viewer.passport.upstream.trace":"Trace upstream authored reachability","viewer.passport.downstream.trace":"Trace downstream authored reachability","viewer.passport.close":"Close semantic passport","viewer.passport.copy":"Copy link","viewer.passport.copy.focus":"Copy link to focused node","viewer.passport.relations":"Relations","viewer.passport.relations.show":"Show connected relationships","viewer.passport.relations.hide":"Hide connected relationships","viewer.passport.relations.list":"Connected relationships","viewer.passport.copyRelation":"Copy relation","viewer.passport.copyNode":"Copy node","viewer.passport.copyPinned":"Copy link to pinned relationship","viewer.passport.copySource":"Copy link to source node","viewer.passport.copy.focused.success":"Focused node link copied","viewer.passport.copy.pinned.success":"Pinned relationship link copied","viewer.passport.copy.focused.failed":"Could not copy focused node link","viewer.passport.copy.pinned.failed":"Could not copy pinned relationship link","viewer.passport.relationship.none":"No connected relationships","viewer.passport.relationship.count.one":"{count} relation","viewer.passport.relationship.count.other":"{count} relations","viewer.passport.relationship.show.one":"Show {count} connected relationship","viewer.passport.relationship.show.other":"Show {count} connected relationships","viewer.passport.relationship.summary":"{out} outgoing · {in} incoming{loops}","viewer.passport.relationship.loops":" · {count} loop","viewer.passport.relationship.explorer":"Direct relationship explorer","viewer.passport.relationship.help":"Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.","viewer.passport.relationship.loopsBack":"loops back","viewer.passport.relationship.connectsTo":"connects to","viewer.passport.relationship.connectsFrom":"connects from","viewer.passport.relationship.pinned":"Pinned relationship · {from} → {to} · {label}","viewer.passport.relationship.inspect":"Inspect relationship {index} of {total}: {from} to {to}, {label}. Press Enter for details.","viewer.passport.relationship.group.out":"Outgoing","viewer.passport.relationship.group.in":"Incoming","viewer.passport.relationship.group.loop":"Self loops","viewer.passport.relationship.row":"{group}: {relationship}, {neighbor}","viewer.passport.relationship.direction.out":"OUT →","viewer.passport.relationship.direction.in":"← IN","viewer.passport.relationship.direction.loop":"LOOP","viewer.passport.sourceCount.one":"{count} verified source reference","viewer.passport.sourceCount.other":"{count} verified source references","viewer.passport.sourceMarker":"SRC","viewer.passport.beacon.one":"{count} verified source; focus this node to inspect","viewer.passport.beacon.other":"{count} verified sources; focus this node to inspect","viewer.passport.repository.open":"Open verified repository revision {revision}","viewer.passport.source.open":"Open verified source {path} at revision {revision}","viewer.passport.source.openLink":"Open ↗","viewer.passport.reach.upstream.one":"Trace {count} upstream authored node","viewer.passport.reach.upstream.other":"Trace {count} upstream authored nodes","viewer.passport.reach.downstream.one":"Trace {count} downstream authored node","viewer.passport.reach.downstream.other":"Trace {count} downstream authored nodes","viewer.passport.reach.noUpstream":"No upstream authored nodes","viewer.passport.reach.noDownstream":"No downstream authored nodes","viewer.passport.reach.status":"{direction} · {nodes} nodes · {links} links · max {hops} hops","viewer.route.eyebrow":"Route probe","viewer.route.start":"Choose a start node","viewer.route.start.find":"Find start","viewer.route.start.find.aria":"Find a route start","viewer.route.copy":"Copy link","viewer.route.copy.aria":"Copy link to traced route","viewer.route.clear":"Clear","viewer.route.clear.aria":"Clear route probe","viewer.route.traced":"Traced route","viewer.route.pickTwo":"Pick two semantic nodes on the diagram","viewer.route.pickOne":"Pick a semantic node on the diagram","viewer.route.controls":"Route journey controls","viewer.route.previous":"Previous route position","viewer.route.play":"Play route journey","viewer.route.pause":"Pause route journey","viewer.route.replay":"Replay route journey","viewer.route.next":"Next route position","viewer.route.journey":"Journey","viewer.route.pause.label":"Pause","viewer.route.replay.label":"Replay","viewer.route.overview":"Overview","viewer.route.overview.aria":"Show complete route overview","viewer.route.instructions":"Choose the source, then the destination. Direction matters.","viewer.route.destination":"Choose a destination from {label}","viewer.route.destination.find":"Find target","viewer.route.destination.find.aria":"Find a reachable route destination","viewer.route.differentDestination":"Choose a different destination","viewer.route.distinct":"A route needs two distinct semantic nodes.","viewer.route.unreachable":"No directed route to {label}","viewer.route.unreachable.detail":"{target} is not reachable from {source}. Pick a highlighted destination.","viewer.route.start.instructions":"Select the source. The next step will reveal only directed destinations.","viewer.route.copy.success":"Traced route link copied","viewer.route.copy.failed":"Could not copy traced route link","viewer.route.position":"Route position {index} of {total}: {label}","viewer.route.step":"Step {index} of {total} · {phase} · {label}","viewer.route.motionRequired":"Automatic journey requires Live motion","viewer.route.trigger.clear":"Clear traced route","viewer.route.overview.status":"{nodes} · {hops} · shortest authored route","viewer.route.overview.node.one":"{count} node","viewer.route.overview.node.other":"{count} nodes","viewer.route.overview.hop.one":"{count} directed hop","viewer.route.overview.hop.other":"{count} directed hops","viewer.route.phase.playing":"Playing","viewer.route.phase.complete":"Complete","viewer.route.phase.inspecting":"Inspecting","viewer.route.destination.count.one":"{count} directed destination available. Pick a highlighted node.","viewer.route.destination.count.other":"{count} directed destinations available. Pick a highlighted node.","viewer.route.noOutgoing":"No outgoing route starts here. Clear and choose another source.","viewer.route.result.title":"{source} to {target}","viewer.route.finder.source.title":"Choose route start","viewer.route.finder.source.placeholder":"Search route sources","viewer.route.finder.source.empty":"No matching route sources","viewer.route.finder.source.results":"Nodes that can start a route","viewer.route.finder.source.noun":"route sources","viewer.route.finder.source.badge":"start","viewer.route.finder.target.title":"Destination from {label}","viewer.route.finder.target.placeholder":"Search reachable destinations","viewer.route.finder.target.empty":"No matching reachable destinations","viewer.route.finder.target.results":"Reachable route destinations","viewer.route.finder.target.noun":"reachable destinations","viewer.route.hop.one":"{count} hop","viewer.route.hop.other":"{count} hops","viewer.lens.eyebrow":"Semantic lens","viewer.lens.title":"Compare system roles","viewer.lens.close":"Close semantic lens","viewer.lens.instruction":"Choose up to two semantic kinds. One reveals its real traffic; two compare only direct authored relationships.","viewer.lens.kinds":"Semantic kinds","viewer.lens.choose":"Choose a kind to inspect its nodes and touching relationships.","viewer.lens.copy":"Copy link to semantic lens","viewer.lens.clear":"Clear semantic lens","viewer.lens.open":"Open semantic lens","viewer.lens.openActive":"Open active semantic lens","viewer.lens.legend":"Semantic legend","viewer.lens.legend.inspect.one":"Inspect {label}, {count} node","viewer.lens.legend.inspect.other":"Inspect {label}, {count} nodes","viewer.lens.kind.count.one":"{label}, {count} node","viewer.lens.kind.count.other":"{label}, {count} nodes","viewer.lens.compare.one":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationship","viewer.lens.compare.other":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationships","viewer.lens.single":"{nodes} · {relationships} · connected peers remain visible","viewer.lens.node.one":"{count} {label} node","viewer.lens.node.other":"{count} {label} nodes","viewer.lens.relationship.one":"{count} touching relationship","viewer.lens.relationship.other":"{count} touching relationships","viewer.radar.title":"Semantic radar","viewer.radar.building":"Building overview","viewer.radar.openFull":"Open full semantic radar","viewer.radar.open":"Open radar","viewer.radar.close":"Close semantic radar","viewer.radar.surface":"Diagram overview. Click a node to focus it, or use arrow keys to pan.","viewer.radar.click":"Click node","viewer.radar.drag":"Drag to pan","viewer.radar.space":"Semantic radar needs more MAP space.","viewer.radar.nodes":"Semantic diagram radar nodes","viewer.radar.focus":"Focus {label} from Semantic Radar","viewer.radar.status":"{count} nodes · {viewport}","viewer.radar.fullMap":"{count} nodes · full map","viewer.radar.compacted":"Radar compacted to avoid covering the Semantic Passport or MAP controls.","viewer.radar.cancelWaiting":"Cancel semantic radar waiting for more MAP space","viewer.radar.needsSpace":"Semantic radar needs more visible MAP space","viewer.radar.viewport.full":"full map","viewer.radar.viewport.width":"{percent}% width","viewer.radar.viewport.scale":"{percent}% viewport","viewer.nav.controls":"Diagram view controls","viewer.nav.route":"Trace a directed route","viewer.nav.route.title":"Trace route (R)","viewer.nav.route.short":"PATH","viewer.nav.radar":"Open semantic radar","viewer.nav.radar.title":"Semantic radar (M)","viewer.nav.radar.short":"MAP","viewer.nav.lens":"Open semantic lens","viewer.nav.lens.title":"Semantic lens (L)","viewer.nav.lens.short":"LENS","viewer.nav.find":"Find a node","viewer.nav.find.title":"Find a node (/)","viewer.nav.guide":"Open diagram guide","viewer.nav.guide.title":"Diagram guide (?)","viewer.nav.zoomOut":"Zoom out","viewer.nav.zoomOut.title":"Zoom out (-)","viewer.nav.reset":"Reset diagram view","viewer.nav.reset.title":"Reset view (0)","viewer.nav.read":"READ","viewer.nav.zoomIn":"Zoom in","viewer.nav.zoomIn.title":"Zoom in (+)","viewer.nav.camera":"{hint}. Reset diagram view","viewer.nav.camera.title":"{semantic}{hint} · reset view (0)","viewer.nav.camera.semantic":"Semantic camera active · ","viewer.nav.level.map":"MAP","viewer.nav.level.read":"READ","viewer.nav.level.full":"FULL","viewer.nav.level.auto":"AUTO","viewer.nav.detail.map":"Zoom in to reveal relationship labels and node context","viewer.nav.detail.read":"Zoom in again to reveal tags and annotations","viewer.nav.detail.full":"Full diagram detail","viewer.intent.summary":"{label}. {out} outgoing, {in} incoming{loops}. {total} connections. Press Enter for details.","viewer.intent.loops":", {count} self loop","viewer.common.copied":"Copied","viewer.common.copyFailed":"Copy failed","viewer.common.copyLink":"Copy link","viewer.common.clear":"Clear","viewer.common.close":"Close"}}</script>
<div class="guided-views no-print" id="guided-views" hidden aria-label="Guided diagram views">
<button id="guided-view-prev" type="button" aria-label="Previous guided view" title="Previous guided view ([)">&#8592;</button>
<div class="guided-view-copy">
@@ -4912,8 +5003,9 @@
</div>
<!-- Main Diagram -->
- <div class="diagram-container" data-detail-level="read">
- <svg viewBox="0 0 1180 588" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
+ <div class="diagram-container" data-detail-level="read"
+ data-preset-badge-editorial-plate="ARCHIFY / PLATE 04">
+ <svg viewBox="0 0 1180 588" role="img" lang="en" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="standard" data-quality-gates="advisory">
<title id="archify-diagram-title">Maka</title>
<desc id="archify-diagram-description">Local-first desktop AI workbench — sessions, tools, permissions, recovery</desc>
<!-- Definitions -->
@@ -4939,11 +5031,9 @@
<rect width="100%" height="100%" fill="url(#grid)" />
<!-- Boundaries (behind everything) -->
- <rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="0" x="170" y="110" width="970" height="410" rx="12" class="c-region" stroke-width="1"/>
- <text x="178" y="128" class="t-cloud" font-size="9" font-weight="600">Electron app + packages/runtime</text>
+ <rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="0" data-composition-frame-label="Electron app + packages/runtime" x="170" y="110" width="970" height="410" rx="12" class="c-region" stroke-width="1"/>
- <rect data-graph-role="structural-frame" data-composition-frame-kind="security-group" data-composition-frame-id="1" x="550" y="110" width="400" height="410" rx="8" class="c-security-group" stroke-width="1"/>
- <text x="558" y="128" class="t-security" font-size="9" font-weight="600">trust boundary</text>
+ <rect data-graph-role="structural-frame" data-composition-frame-kind="security-group" data-composition-frame-id="1" data-composition-frame-label="trust boundary" x="550" y="110" width="400" height="410" rx="8" class="c-security-group" stroke-width="1"/>
<!-- Connection paths (before components for correct z-order) -->
<path data-edge-from="user" data-edge-to="ui" data-edge-key="0" data-composition-points="160,330;200,330" d="M 160 330 L 200 330" class="a-emphasis" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
@@ -4968,7 +5058,7 @@
<rect x="2.5" y="5" width="8.5" height="8" rx="1.5"/>
<path d="M8 2.5h5.5V8M13.5 2.5 7.5 8.5"/>
</g>
- <text data-detail-anchor="" x="100" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">You</text>
+ <text data-node-label="" data-detail-anchor="" x="100" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">You</text>
<text data-detail="context" x="100" y="344" class="t-muted" font-size="9" text-anchor="middle">desktop user</text>
</g>
@@ -4982,7 +5072,7 @@
<circle cx="4.1" cy="4.8" r=".7" class="sigil-fill"/>
<circle cx="6.3" cy="4.8" r=".7" class="sigil-fill"/>
</g>
- <text data-detail-anchor="" x="270" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Desktop UI</text>
+ <text data-node-label="" data-detail-anchor="" x="270" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Desktop UI</text>
<text data-detail="context" x="270" y="344" class="t-muted" font-size="9" text-anchor="middle">React renderer</text>
</g>
@@ -4993,7 +5083,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(396 306) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="460" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Main Process</text>
+ <text data-node-label="" data-detail-anchor="" x="460" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Main Process</text>
<text data-detail="context" x="460" y="344" class="t-muted" font-size="9" text-anchor="middle">Electron IPC</text>
</g>
@@ -5004,7 +5094,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(586 306) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="655" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">SessionManager</text>
+ <text data-node-label="" data-detail-anchor="" x="655" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">SessionManager</text>
<text data-detail="context" x="655" y="344" class="t-muted" font-size="9" text-anchor="middle">public runtime API</text>
</g>
@@ -5015,7 +5105,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(786 306) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="850" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">AgentRun</text>
+ <text data-node-label="" data-detail-anchor="" x="850" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">AgentRun</text>
<text data-detail="context" x="850" y="344" class="t-muted" font-size="9" text-anchor="middle">turn + recovery</text>
</g>
@@ -5026,7 +5116,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(976 306) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="1040" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">ModelAdapter</text>
+ <text data-node-label="" data-detail-anchor="" x="1040" y="328" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">ModelAdapter</text>
<text data-detail="context" x="1040" y="344" class="t-muted" font-size="9" text-anchor="middle">stream + usage</text>
</g>
@@ -5037,7 +5127,7 @@
<g aria-hidden="true" data-semantic-sigil="cloud" class="semantic-sigil s-cloud" transform="translate(976 146) scale(0.6875)">
<path d="M4.3 12.5h7.3a2.4 2.4 0 0 0 .2-4.8 4 4 0 0 0-7.5-1.3A3.1 3.1 0 0 0 4.3 12.5Z"/>
</g>
- <text data-detail-anchor="" x="1040" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Model Providers</text>
+ <text data-node-label="" data-detail-anchor="" x="1040" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Model Providers</text>
<text data-detail="context" x="1040" y="184" class="t-muted" font-size="9" text-anchor="middle">AI SDK / Ollama</text>
<text data-detail="fine" x="1040" y="192" class="t-cloud" font-size="7" text-anchor="middle">API keys local</text>
</g>
@@ -5050,7 +5140,7 @@
<rect x="2.5" y="5" width="8.5" height="8" rx="1.5"/>
<path d="M8 2.5h5.5V8M13.5 2.5 7.5 8.5"/>
</g>
- <text data-detail-anchor="" x="655" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Bots &amp; Gateway</text>
+ <text data-node-label="" data-detail-anchor="" x="655" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Bots &amp; Gateway</text>
<text data-detail="context" x="655" y="184" class="t-muted" font-size="9" text-anchor="middle">Telegram · Feishu · HTTP</text>
</g>
@@ -5062,7 +5152,7 @@
<path d="M8 2.2 13 4v3.5c0 3.1-1.8 5.4-5 6.5-3.2-1.1-5-3.4-5-6.5V4Z"/>
<path d="m5.8 8 1.5 1.5 3-3"/>
</g>
- <text data-detail-anchor="" x="850" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Permission</text>
+ <text data-node-label="" data-detail-anchor="" x="850" y="168" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Permission</text>
<text data-detail="context" x="850" y="184" class="t-muted" font-size="9" text-anchor="middle">policy engine</text>
<text data-detail="fine" x="850" y="192" class="t-security" font-size="7" text-anchor="middle">fail-closed</text>
</g>
@@ -5075,7 +5165,7 @@
<ellipse cx="8" cy="4" rx="5" ry="2"/>
<path d="M3 4v8c0 1.1 2.2 2 5 2s5-.9 5-2V4M3 8c0 1.1 2.2 2 5 2s5-.9 5-2"/>
</g>
- <text data-detail-anchor="" x="655" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Local Storage</text>
+ <text data-node-label="" data-detail-anchor="" x="655" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Local Storage</text>
<text data-detail="context" x="655" y="484" class="t-muted" font-size="9" text-anchor="middle">userData JSONL</text>
</g>
@@ -5089,7 +5179,7 @@
<circle cx="10.5" cy="8" r="1" class="sigil-fill"/>
<circle cx="7" cy="11.5" r="1" class="sigil-fill"/>
</g>
- <text data-detail-anchor="" x="850" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">ToolRuntime</text>
+ <text data-node-label="" data-detail-anchor="" x="850" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">ToolRuntime</text>
<text data-detail="context" x="850" y="484" class="t-muted" font-size="9" text-anchor="middle">validate · abort</text>
</g>
@@ -5103,7 +5193,7 @@
<circle cx="4.1" cy="4.8" r=".7" class="sigil-fill"/>
<circle cx="6.3" cy="4.8" r=".7" class="sigil-fill"/>
</g>
- <text data-detail-anchor="" x="1040" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Local Tools</text>
+ <text data-node-label="" data-detail-anchor="" x="1040" y="468" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Local Tools</text>
<text data-detail="context" x="1040" y="484" class="t-muted" font-size="9" text-anchor="middle">Read · Write · Bash</text>
</g>
@@ -5130,6 +5220,17 @@
+ <!-- Boundary labels (foreground masks keep routes out of titles) -->
+ <g data-graph-role="structural-frame-label" data-composition-frame-id="0" data-composition-frame-kind="region" data-composition-frame-label="Electron app + packages/runtime">
+ <rect data-graph-role="structural-frame-label-mask" x="174" y="120" width="177.4" height="16" rx="3" class="c-mask"/>
+ <text data-boundary-label="" x="178" y="133" class="t-cloud" font-size="9" font-weight="600">Electron app + packages/runtime</text>
+ </g>
+
+ <g data-graph-role="structural-frame-label" data-composition-frame-id="1" data-composition-frame-kind="security-group" data-composition-frame-label="trust boundary">
+ <rect data-graph-role="structural-frame-label-mask" x="554" y="120" width="85.6" height="16" rx="3" class="c-mask"/>
+ <text data-boundary-label="" x="558" y="133" class="t-security" font-size="9" font-weight="600">trust boundary</text>
+ </g>
+
<!-- Legend -->
<g data-legend="" data-legend-bridge="">
<text x="40" y="552" class="t-primary" font-size="12" font-weight="650">Legend</text>
@@ -5327,11 +5428,13 @@
<strong id="overview-map-title">Semantic radar</strong>
<small id="overview-map-status" aria-live="polite">Building overview</small>
</span>
+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button>
<button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">&#215;</button>
</div>
<div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div>
<div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div>
</div>
+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p>
<div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls">
<button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button>
<button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>
@@ -5387,6 +5490,37 @@
<script>
var Archify = {};
+ var archifyI18nData = (function () {
+ var node = document.getElementById('archify-i18n-data');
+ try { return JSON.parse(node ? node.textContent : '{}'); }
+ catch (_) { return { locale: 'en', messages: {} }; }
+ })();
+ Archify.locale = archifyI18nData.locale || 'en';
+
+ function viewerText(key, values) {
+ var messages = archifyI18nData.messages || {};
+ var template = Object.prototype.hasOwnProperty.call(messages, key) ? messages[key] : key;
+ return String(template).replace(/\{([a-zA-Z0-9_]+)\}/g, function (match, name) {
+ return values && Object.prototype.hasOwnProperty.call(values, name) ? String(values[name]) : match;
+ });
+ }
+
+ function viewerCount(key, count, values) {
+ var suffix = Number(count) === 1 ? '.one' : '.other';
+ var payload = Object.assign({}, values || {}, { count: count });
+ return viewerText(key + suffix, payload);
+ }
+
+ function viewerKindLabel(value) {
+ var normalized = String(value || 'node').toLowerCase();
+ var knownKey = 'viewer.kind.' + normalized;
+ var known = viewerText(knownKey);
+ if (known !== knownKey) return known;
+ return normalized
+ .replace(/messagebus/gi, 'message bus')
+ .replace(/[-_]+/g, ' ')
+ .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
+ }
function hasDrawableGeometry(element) {
if (!element) return false;
@@ -5417,7 +5551,12 @@
============================================================ */
Archify.preset = (function () {
var PRESETS = ['classic', 'signal-flow', 'blueprint', 'editorial'];
- var LABELS = { classic: 'Classic', 'signal-flow': 'Flow', blueprint: 'Blueprint', editorial: 'Editorial' };
+ var LABELS = {
+ classic: viewerText('viewer.preset.classic.short'),
+ 'signal-flow': viewerText('viewer.preset.flow.short'),
+ blueprint: viewerText('viewer.preset.blueprint'),
+ editorial: viewerText('viewer.preset.editorial')
+ };
var html = document.documentElement;
var svg = document.querySelector('.diagram-container svg');
var btn = document.getElementById('btn-preset');
@@ -5444,8 +5583,8 @@
svg.setAttribute('data-preset', preset);
btn.setAttribute('data-preset-option', preset);
label.textContent = LABELS[preset];
- btn.setAttribute('aria-label', 'Visual style: ' + LABELS[preset] + '. Choose visual style');
- btn.title = 'Choose visual style (S cycles)';
+ btn.setAttribute('aria-label', viewerText('viewer.preset.current', { style: LABELS[preset] }));
+ btn.title = viewerText('viewer.preset.choose.title');
options().forEach(function (option) {
var selected = option.getAttribute('data-preset-value') === preset;
option.setAttribute('aria-checked', String(selected));
@@ -5557,7 +5696,7 @@
function apply(theme) {
html.setAttribute('data-theme', theme);
- label.textContent = theme === 'dark' ? 'Dark' : 'Light';
+ label.textContent = viewerText(theme === 'dark' ? 'viewer.theme.dark' : 'viewer.theme.light');
btn.setAttribute('aria-pressed', theme === 'light' ? 'true' : 'false');
}
@@ -5606,6 +5745,18 @@
var SHARE_CARD_PADDING = 36;
var SHARE_CARD_HEADER = 112;
+ function exportError(key, values) {
+ var error = new Error(viewerText(key, values));
+ error.archifyViewerMessage = true;
+ return error;
+ }
+
+ function exportMessage(error) {
+ return error && error.archifyViewerMessage
+ ? error.message
+ : viewerText('viewer.export.unknown');
+ }
+
function diagramFilename() {
var title = (document.title || 'diagram')
.replace(/\s+Architecture(\s+Diagram)?$/i, '')
@@ -5808,6 +5959,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -5982,6 +6134,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -6201,7 +6354,7 @@
format === 'webp' ? 'image/webp' : 'image/png';
var quality = format === 'png' ? undefined : 0.95;
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for ' + format));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: format }));
else resolve(blob);
}, mime, quality);
} catch (error) {
@@ -6237,11 +6390,11 @@
function canvas2dOrThrow(canvas, label) {
if (!canvas || typeof canvas.getContext !== 'function') {
- throw new Error('Canvas unavailable for ' + label);
+ throw exportError('viewer.export.error.canvasUnavailable', { label: label });
}
var ctx = canvas.getContext('2d');
- if (!ctx) throw new Error('2D canvas context unavailable for ' + label);
- if (typeof canvas.toBlob !== 'function') throw new Error('canvas.toBlob unavailable for ' + label);
+ if (!ctx) throw exportError('viewer.export.error.contextUnavailable', { label: label });
+ if (typeof canvas.toBlob !== 'function') throw exportError('viewer.export.error.toBlobUnavailable', { label: label });
return ctx;
}
@@ -6249,14 +6402,14 @@
options = options || {};
var routeSnapshot = options.routeSnapshot || null;
var reachSnapshot = options.reachSnapshot || null;
- if (routeSnapshot && reachSnapshot) return Promise.reject(new Error('Share Card variants cannot be combined'));
+ if (routeSnapshot && reachSnapshot) return Promise.reject(exportError('viewer.export.error.variantsCombined'));
var svg = document.querySelector('.diagram-container svg');
var vb = svg.viewBox.baseVal;
var sourceScale = Math.min(2, pickSafeScale(vb.width, vb.height));
var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot, reachSnapshot: reachSnapshot });
- if (!data.canonicalStateClean) return Promise.reject(new Error('Share Card export could not remove temporary viewer state'));
- if (routeSnapshot && !data.routeStateClean) return Promise.reject(new Error('Route Card export could not preserve the resolved route safely'));
- if (reachSnapshot && !data.reachStateClean) return Promise.reject(new Error('Reach Card export could not preserve authored reach safely'));
+ if (!data.canonicalStateClean) return Promise.reject(exportError('viewer.export.error.viewerState'));
+ if (routeSnapshot && !data.routeStateClean) return Promise.reject(exportError('viewer.export.error.routeState'));
+ if (reachSnapshot && !data.reachStateClean) return Promise.reject(exportError('viewer.export.error.reachState'));
var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });
var svgUrl = URL.createObjectURL(svgBlob);
@@ -6267,7 +6420,7 @@
var canvas = document.createElement('canvas');
canvas.width = SHARE_CARD_WIDTH;
canvas.height = SHARE_CARD_HEIGHT;
- var ctx = canvas2dOrThrow(canvas, 'Share Card');
+ var ctx = canvas2dOrThrow(canvas, viewerText('viewer.export.shareCard'));
var computed = getComputedStyle(document.documentElement);
var bg = computed.getPropertyValue('--bg').trim() || currentBg();
var text = computed.getPropertyValue('--text').trim() || '#ffffff';
@@ -6280,21 +6433,37 @@
var titleNode = document.querySelector('.header h1');
var subtitleNode = document.querySelector('.header .subtitle');
var title = titleNode ? titleNode.textContent : document.title;
+ var directionLabel = reachSnapshot
+ ? viewerText('viewer.export.direction.' + reachSnapshot.direction)
+ : '';
var subtitle = routeSnapshot
- ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'
+ ? viewerCount('viewer.export.card.routeSummary', routeSnapshot.hops, {
+ source: routeSnapshot.source.label,
+ target: routeSnapshot.target.label
+ })
: reachSnapshot
- ? 'Authored ' + reachSnapshot.direction + ' from ' + reachSnapshot.origin.label + ' · ' +
- (reachSnapshot.nodeIds.length - 1) + ' nodes · ' + reachSnapshot.edges.length +
- ' links · max ' + reachSnapshot.maxDepth + ' hops'
+ ? viewerText('viewer.export.card.reachSummary', {
+ direction: directionLabel,
+ origin: reachSnapshot.origin.label,
+ nodes: viewerCount('viewer.export.card.node', reachSnapshot.nodeIds.length - 1),
+ links: viewerCount('viewer.export.card.link', reachSnapshot.edges.length),
+ hops: viewerCount('viewer.export.card.hop', reachSnapshot.maxDepth)
+ })
: subtitleNode ? subtitleNode.textContent : '';
var preset = document.documentElement.getAttribute('data-preset') || 'classic';
var theme = document.documentElement.getAttribute('data-theme') || 'dark';
- var presetLabel = preset === 'signal-flow' ? 'FLOW' : preset.toUpperCase();
+ var presetKey = preset === 'signal-flow'
+ ? 'viewer.preset.flow.short'
+ : 'viewer.preset.' + preset;
+ var presetLabel = viewerText(presetKey).toUpperCase();
+ var themeLabel = viewerText('viewer.theme.' + theme).toUpperCase();
var cardLabel = routeSnapshot
- ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'
+ ? viewerText('viewer.export.card.routeBadge', {
+ hops: viewerCount('viewer.export.card.hop', routeSnapshot.hops).toUpperCase()
+ })
: reachSnapshot
- ? 'ARCHIFY · ' + reachSnapshot.direction.toUpperCase() + ' REACH'
- : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();
+ ? viewerText('viewer.export.card.reachBadge', { direction: directionLabel.toUpperCase() })
+ : viewerText('viewer.export.card.defaultBadge', { preset: presetLabel, theme: themeLabel });
ctx.fillStyle = bg;
ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);
@@ -6332,7 +6501,7 @@
URL.revokeObjectURL(svgUrl);
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for Share Card'));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: viewerText('viewer.export.shareCard') }));
else resolve(blob);
}, 'image/png');
} catch (error) {
@@ -6352,17 +6521,17 @@
options = options || {};
if (!options.variant) return renderShareCard();
if (options.variant !== 'route' && options.variant !== 'reach') {
- return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));
+ return Promise.reject(exportError('viewer.export.unknownVariant', { variant: options.variant }));
}
if (options.variant === 'route') {
var routeSnapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
- if (!routeSnapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ if (!routeSnapshot) return Promise.reject(exportError('viewer.export.routeRequired'));
return renderShareCard({ routeSnapshot: routeSnapshot });
}
var snapshot = Archify.focus && typeof Archify.focus.reachabilitySnapshot === 'function'
? Archify.focus.reachabilitySnapshot()
: null;
- if (!snapshot) return Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ if (!snapshot) return Promise.reject(exportError('viewer.export.reachRequired'));
return renderShareCard({ reachSnapshot: snapshot });
}
@@ -6396,7 +6565,7 @@
function recordWebm(options) {
options = options || {};
if (!canRecordMotion()) {
- return Promise.reject(new Error('WebM motion export requires a trace animation and browser MediaRecorder support'));
+ return Promise.reject(exportError('viewer.export.error.webmRequirements'));
}
var duration = Math.max(250, Number(options.duration) || MOTION_DURATION);
var fps = Math.max(1, Number(options.fps) || MOTION_FPS);
@@ -6594,12 +6763,12 @@
};
recorder.onerror = function (event) {
cleanup();
- reject(event.error || new Error('MediaRecorder failed'));
+ reject(event.error || exportError('viewer.export.error.mediaRecorder'));
};
recorder.onstop = function () {
cleanup();
var blob = new Blob(chunks, { type: recorder.mimeType || mime });
- if (!blob.size) reject(new Error('MediaRecorder produced an empty WebM'));
+ if (!blob.size) reject(exportError('viewer.export.error.emptyWebm'));
else resolve(blob);
};
drawMotionFrame(ctx, backgroundImage, motionScene, 0);
@@ -6620,7 +6789,7 @@
};
backgroundImage.onerror = function () {
URL.revokeObjectURL(sourceUrl);
- reject(new Error('SVG background could not be loaded for WebM export'));
+ reject(exportError('viewer.export.error.webmBackground'));
};
backgroundImage.src = sourceUrl;
});
@@ -6678,11 +6847,11 @@
items().forEach(function (it) {
if (it.dataset.format && !supports(it.dataset.format)) {
it.disabled = true;
- it.title = 'Not supported by this browser';
+ it.title = viewerText('viewer.export.unsupported');
}
if ((it.dataset.action === 'copy' || it.dataset.action === 'copy-share-card') && !canCopyImage()) {
it.disabled = true;
- it.title = 'Clipboard image write not supported by this browser';
+ it.title = viewerText('viewer.export.clipboardUnsupported');
}
});
@@ -6773,12 +6942,12 @@
var base = diagramFilename();
close(true);
clearExportReceipt();
- if (format === 'webm') toast('Recording 6 seconds of motion…');
+ if (format === 'webm') toast(viewerText('viewer.export.recording'));
return (format === 'share-card'
? rasterizeShareCard().then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
download(blob, base + '-share-card.png');
- toast('Downloaded Share Card');
+ toast(viewerText('viewer.export.downloadedShare'));
})
: format === 'svg'
? Promise.resolve(serializeSvg(1, { autoTheme: true })).then(function (d) {
@@ -6791,7 +6960,7 @@
document.documentElement.setAttribute('data-last-motion-bytes', String(blob.size));
recordExportReceipt('webm', blob, true);
download(blob, base + '.webm');
- toast('Downloaded WebM');
+ toast(viewerText('viewer.export.downloadedWebm'));
})
: rasterize(format).then(function (blob) {
recordExportReceipt(format, blob, true);
@@ -6799,20 +6968,21 @@
})
).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : format;
+ var technicalMessage = err && err.message ? err.message : format;
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', format);
- document.documentElement.setAttribute('data-last-export-error', message);
- if (format === 'webm' && /MediaRecorder|WebM motion export|empty WebM/i.test(message)) {
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ if (format === 'webm') {
var motionItem = menu.querySelector('button[data-format="webm"]');
if (motionItem) {
motionItem.disabled = true;
- motionItem.title = 'Motion capture unavailable in this browser';
+ motionItem.title = viewerText('viewer.export.motionUnavailable');
motionItem.style.opacity = '0.5';
}
- toast('WebM unavailable in this browser');
+ toast(viewerText('viewer.export.webmUnavailable'));
return;
}
- alert('Export failed: ' + message);
+ alert(viewerText('viewer.export.failed', { message: message }));
});
}
@@ -6822,18 +6992,19 @@
var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
var blobPromise = snapshot
? renderShareCard({ routeSnapshot: snapshot })
- : Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ : Promise.reject(exportError('viewer.export.routeRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'route', true);
download(blob, diagramFilename() + '-route-share-card.png');
- toast('Downloaded Route Share Card');
+ toast(viewerText('viewer.export.downloadedRoute'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Route Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.routeFailed', { message: message }));
});
}
@@ -6845,18 +7016,19 @@
: null;
var blobPromise = snapshot
? renderShareCard({ reachSnapshot: snapshot })
- : Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ : Promise.reject(exportError('viewer.export.reachRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'reach', false, true);
download(blob, diagramFilename() + '-' + snapshot.direction + '-reach-share-card.png');
- toast('Downloaded Reach Share Card');
+ toast(viewerText('viewer.export.downloadedReach'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Reach Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.reachFailed', { message: message }));
});
}
@@ -6921,21 +7093,22 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported by this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.period'));
return;
}
var blobPromise = rasterizeShareCard();
return writePngToClipboard(blobPromise).then(function () {
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
- toast('Copied Share Card');
+ toast(viewerText('viewer.export.copiedShare'));
});
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'unknown';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Copy failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.copyFailed', { message: message }));
});
}
@@ -6943,15 +7116,17 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported in this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.short'));
return;
}
var blobPromise = rasterize('png');
return writePngToClipboard(blobPromise).then(function () {
- toast('Copied PNG to clipboard');
+ toast(viewerText('viewer.export.copiedPng'));
}).catch(function (err) {
console.error(err);
- alert('Copy failed: ' + (err && err.message ? err.message : 'unknown'));
+ alert(viewerText('viewer.export.copyFailed', {
+ message: exportMessage(err)
+ }));
});
}
@@ -7077,17 +7252,17 @@
return readerPaused || reducedMotion() || hasSuspension();
}
function ownerLabel(value) {
- if (value === 'story') return 'the guided story';
- if (value === 'chapter') return 'the active chapter';
- if (value === 'chapter-preview') return 'the chapter delta preview';
- if (value === 'handoff') return 'the chapter handoff';
- if (value === 'route') return 'Route Probe';
- if (value === 'lens') return 'Semantic Lens';
- if (value === 'relationship') return 'Relationship Preview';
- if (value === 'intent') return 'Intent Trace';
- if (value === 'focus') return 'semantic focus';
- if (value === 'legend') return 'legend preview';
- return 'reader interaction';
+ if (value === 'story') return viewerText('viewer.owner.story');
+ if (value === 'chapter') return viewerText('viewer.owner.chapter');
+ if (value === 'chapter-preview') return viewerText('viewer.owner.chapterPreview');
+ if (value === 'handoff') return viewerText('viewer.owner.handoff');
+ if (value === 'route') return viewerText('viewer.owner.route');
+ if (value === 'lens') return viewerText('viewer.owner.lens');
+ if (value === 'relationship') return viewerText('viewer.owner.relationship');
+ if (value === 'intent') return viewerText('viewer.owner.intent');
+ if (value === 'focus') return viewerText('viewer.owner.focus');
+ if (value === 'legend') return viewerText('viewer.owner.legend');
+ return viewerText('viewer.owner.reader');
}
function render() {
if (!capable) return;
@@ -7101,7 +7276,7 @@
}
btn.setAttribute('aria-pressed', paused ? 'false' : 'true');
btn.disabled = systemPaused;
- label.textContent = paused ? 'Still' : 'Live';
+ label.textContent = viewerText(paused ? 'viewer.motion.still' : 'viewer.motion.live');
if (paused && lastEffectivePaused !== true && Archify.guidedViews && Archify.guidedViews.isPlaying()) {
Archify.guidedViews.pause();
}
@@ -7114,20 +7289,20 @@
lastEffectivePaused = paused;
if (Archify.routeProbe && typeof Archify.routeProbe.syncMotion === 'function') Archify.routeProbe.syncMotion();
if (systemPaused) {
- btn.setAttribute('aria-label', 'Motion paused by reduced-motion preference');
- btn.title = 'Motion paused by reduced-motion preference';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.reduced'));
+ btn.title = viewerText('viewer.motion.reduced');
} else if (hasSuspension()) {
- btn.setAttribute('aria-label', 'Motion paused while this page is hidden');
- btn.title = 'Motion paused while this page is hidden';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.hidden'));
+ btn.title = viewerText('viewer.motion.hidden');
} else if (paused) {
- btn.setAttribute('aria-label', 'Resume motion');
- btn.title = 'Resume motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.resume'));
+ btn.title = viewerText('viewer.motion.resume');
} else if (owner) {
- btn.setAttribute('aria-label', 'Pause motion; currently yielding to ' + ownerLabel(owner));
- btn.title = 'Live preview enabled · yielding to ' + ownerLabel(owner);
+ btn.setAttribute('aria-label', viewerText('viewer.motion.yielding', { owner: ownerLabel(owner) }));
+ btn.title = viewerText('viewer.motion.yielding.title', { owner: ownerLabel(owner) });
} else {
- btn.setAttribute('aria-label', 'Pause motion');
- btn.title = 'Pause motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.pause'));
+ btn.title = viewerText('viewer.motion.pause');
}
}
function setPaused(next, options) {
@@ -7298,7 +7473,7 @@
if (!box || !Number.isFinite(box.x) || !Number.isFinite(box.y) || !Number.isFinite(box.width) || box.width < 36) return;
var count = sources.length;
- var label = count + ' verified source' + (count === 1 ? '' : 's') + '; focus this node to inspect';
+ var label = viewerCount('viewer.passport.beacon', count);
var beacon = document.createElementNS(svgNamespace, 'g');
beacon.classList.add('source-evidence-beacon');
beacon.setAttribute('data-source-evidence-beacon', '');
@@ -7314,7 +7489,7 @@
var text = document.createElementNS(svgNamespace, 'text');
text.setAttribute('x', '15');
text.setAttribute('y', '8.25');
- text.textContent = 'SRC ' + count;
+ text.textContent = viewerText('viewer.passport.sourceMarker') + ' ' + count;
beacon.appendChild(title);
beacon.appendChild(plate);
beacon.appendChild(text);
@@ -7323,7 +7498,7 @@
var originalLabel = node.getAttribute('aria-label') || '';
node.setAttribute('data-source-evidence-count', String(count));
node.setAttribute('data-source-evidence-original-label', originalLabel);
- node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + count + ' verified source reference' + (count === 1 ? '' : 's'));
+ node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + viewerCount('viewer.passport.sourceCount', count));
installed += 1;
});
return installed;
@@ -7501,11 +7676,11 @@
upstreamBtn.disabled = upstreamReach === 0;
downstreamBtn.disabled = downstreamReach === 0;
upstreamBtn.setAttribute('aria-label', upstreamReach
- ? 'Trace ' + upstreamReach + ' upstream authored node' + (upstreamReach === 1 ? '' : 's')
- : 'No upstream authored nodes');
+ ? viewerCount('viewer.passport.reach.upstream', upstreamReach)
+ : viewerText('viewer.passport.reach.noUpstream'));
downstreamBtn.setAttribute('aria-label', downstreamReach
- ? 'Trace ' + downstreamReach + ' downstream authored node' + (downstreamReach === 1 ? '' : 's')
- : 'No downstream authored nodes');
+ ? viewerCount('viewer.passport.reach.downstream', downstreamReach)
+ : viewerText('viewer.passport.reach.noDownstream'));
reachSection.hidden = false;
}
function applyReachability(direction, options) {
@@ -7551,11 +7726,15 @@
var activeButton = direction === 'upstream' ? upstreamBtn : downstreamBtn;
activeButton.setAttribute('aria-pressed', 'true');
var reachableCount = result.nodeIds.length - 1;
- var directionLabel = direction === 'upstream' ? 'Upstream' : 'Downstream';
- reachStatus.textContent = directionLabel + ' · ' + reachableCount + ' node' +
- (reachableCount === 1 ? '' : 's') + ' · ' + result.edgeKeys.length + ' link' +
- (result.edgeKeys.length === 1 ? '' : 's') + ' · max ' + result.maxDepth + ' hop' +
- (result.maxDepth === 1 ? '' : 's');
+ var directionLabel = viewerText(direction === 'upstream'
+ ? 'viewer.passport.upstream'
+ : 'viewer.passport.downstream');
+ reachStatus.textContent = viewerText('viewer.passport.reach.status', {
+ direction: directionLabel,
+ nodes: reachableCount,
+ links: result.edgeKeys.length,
+ hops: result.maxDepth
+ });
reachStatus.hidden = false;
if (Archify.exportMenu && typeof Archify.exportMenu.syncReachShare === 'function') {
Archify.exportMenu.syncReachShare();
@@ -7682,7 +7861,7 @@
var slug = repository.url.replace(/^https:\/\/github\.com\//, '').replace(/\/$/, '');
repositoryLink.href = repository.url + '/tree/' + repository.revision;
repositoryLink.textContent = slug + ' @ ' + repository.shortRevision;
- repositoryLink.setAttribute('aria-label', 'Open verified repository revision ' + repository.revision);
+ repositoryLink.setAttribute('aria-label', viewerText('viewer.passport.repository.open', { revision: repository.revision }));
sources.forEach(function (source) {
var link = document.createElement('a');
link.className = 'semantic-passport-source';
@@ -7690,13 +7869,13 @@
link.target = '_blank';
link.rel = 'noopener noreferrer';
link.referrerPolicy = 'no-referrer';
- link.setAttribute('aria-label', 'Open verified source ' + source.path + ' at revision ' + repository.shortRevision);
+ link.setAttribute('aria-label', viewerText('viewer.passport.source.open', { path: source.path, revision: repository.shortRevision }));
var name = document.createElement('strong');
name.textContent = source.label || source.path.split('/').pop() || source.path;
var location = document.createElement('code');
location.textContent = source.line
? 'L' + source.line + (source.endLine && source.endLine !== source.line ? '–' + source.endLine : '') + ' ↗'
- : 'Open ↗';
+ : viewerText('viewer.passport.source.openLink');
var sourcePath = document.createElement('small');
sourcePath.textContent = source.path;
link.appendChild(name);
@@ -7708,7 +7887,7 @@
}
function renderPassport(id, node) {
setPassportValue(detail, node.getAttribute('data-node-sublabel'));
- setPassportValue(kind, node.getAttribute('data-node-kind') || 'node');
+ setPassportValue(kind, viewerKindLabel(node.getAttribute('data-node-kind') || 'node'));
setPassportValue(context, node.getAttribute('data-node-context'));
setPassportValue(tag, node.getAttribute('data-node-tag'));
setPassportValue(document.getElementById('focus-brand'), node.getAttribute('data-node-brand'));
@@ -7739,7 +7918,11 @@
direction: direction,
neighborId: neighborId,
neighborLabel: neighbor ? nodeLabel(neighbor, neighborId) : neighborId,
- label: edgeLabel || (direction === 'loop' ? 'loops back' : direction === 'out' ? 'connects to' : 'connects from')
+ label: edgeLabel || viewerText(direction === 'loop'
+ ? 'viewer.passport.relationship.loopsBack'
+ : direction === 'out'
+ ? 'viewer.passport.relationship.connectsTo'
+ : 'viewer.passport.relationship.connectsFrom')
});
});
return relationships;
@@ -7782,7 +7965,9 @@
fromLabel: byId[from] ? nodeLabel(byId[from], from) : from,
toLabel: byId[to] ? nodeLabel(byId[to], to) : to,
labelValue: labelValue,
- label: labelValue || (from === to ? 'loops back' : 'connects to'),
+ label: labelValue || viewerText(from === to
+ ? 'viewer.passport.relationship.loopsBack'
+ : 'viewer.passport.relationship.connectsTo'),
edge: edge,
shapes: shapes,
invalid: false
@@ -7809,14 +7994,14 @@
function renderRelationshipCopyAction() {
var record = pinnedRelationshipRecord();
if (record && record.id) {
- copyBtn.textContent = 'Copy relation';
- copyBtn.setAttribute('aria-label', 'Copy link to pinned relationship');
+ copyBtn.textContent = viewerText('viewer.passport.copyRelation');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copyPinned'));
} else if (pinnedRelationshipKey) {
- copyBtn.textContent = 'Copy node';
- copyBtn.setAttribute('aria-label', 'Copy link to source node');
+ copyBtn.textContent = viewerText('viewer.passport.copyNode');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copySource'));
} else {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
}
}
function relationshipHitGeometry(shape, className) {
@@ -8135,7 +8320,11 @@
var target = relationshipHitTarget(key);
if (target) target.setAttribute('aria-pressed', 'true');
renderRelationshipCopyAction();
- summary.textContent = 'Pinned relationship · ' + record.fromLabel + ' → ' + record.toLabel + ' · ' + record.label;
+ summary.textContent = viewerText('viewer.passport.relationship.pinned', {
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
revealPinnedRelationship(record);
if (options.updateUrl !== false && record.id) {
try { history.replaceState(null, '', location.pathname + location.search + '#relation=' + encodeURIComponent(record.id)); } catch (_) {}
@@ -8154,10 +8343,10 @@
relationshipHitOverlay.setAttribute('class', 'relationship-hit-overlay');
relationshipHitOverlay.setAttribute('data-relationship-hit-overlay', '');
relationshipHitOverlay.setAttribute('role', 'group');
- relationshipHitOverlay.setAttribute('aria-label', 'Direct relationship explorer');
+ relationshipHitOverlay.setAttribute('aria-label', viewerText('viewer.passport.relationship.explorer'));
var relationshipHelp = document.createElementNS(svgNamespace, 'desc');
relationshipHelp.id = 'archify-relationship-help';
- relationshipHelp.textContent = 'Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.';
+ relationshipHelp.textContent = viewerText('viewer.passport.relationship.help');
relationshipHitOverlay.appendChild(relationshipHelp);
records.forEach(function (record, index) {
var target = document.createElementNS(svgNamespace, 'g');
@@ -8171,7 +8360,13 @@
target.setAttribute('tabindex', index === 0 ? '0' : '-1');
target.setAttribute('aria-pressed', 'false');
target.setAttribute('aria-describedby', relationshipHelp.id);
- var description = 'Inspect relationship ' + (index + 1) + ' of ' + records.length + ': ' + record.fromLabel + ' to ' + record.toLabel + ', ' + record.label + '. Press Enter for details.';
+ var description = viewerText('viewer.passport.relationship.inspect', {
+ index: index + 1,
+ total: records.length,
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
target.setAttribute('aria-label', description);
var title = document.createElementNS(svgNamespace, 'title');
title.textContent = record.fromLabel + ' \u2192 ' + record.toLabel + ' \u00b7 ' + record.label;
@@ -8267,25 +8462,29 @@
var relationships = relationshipsFor(id, byId);
chip.removeAttribute('data-relations-expanded');
relationsBtn.setAttribute('aria-expanded', 'false');
- relationsBtn.textContent = relationships.length + ' relation' + (relationships.length === 1 ? '' : 's');
- relationsBtn.setAttribute('aria-label', 'Show ' + relationships.length + ' connected relationship' + (relationships.length === 1 ? '' : 's'));
+ relationsBtn.textContent = viewerCount('viewer.passport.relationship.count', relationships.length);
+ relationsBtn.setAttribute('aria-label', viewerCount('viewer.passport.relationship.show', relationships.length));
var counts = { out: 0, in: 0, loop: 0 };
relationships.forEach(function (relationship) { counts[relationship.direction] += 1; });
- summary.textContent = counts.out + ' outgoing · ' + counts.in + ' incoming' + (counts.loop ? ' · ' + counts.loop + ' loop' : '');
+ summary.textContent = viewerText('viewer.passport.relationship.summary', {
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.passport.relationship.loops', { count: counts.loop }) : ''
+ });
renderReachabilityControls(id);
relationshipList.textContent = '';
if (!relationships.length) {
var empty = document.createElement('p');
empty.className = 'relationship-lens-empty';
- empty.textContent = 'No connected relationships';
+ empty.textContent = viewerText('viewer.passport.relationship.none');
relationshipList.appendChild(empty);
return;
}
[
- { id: 'out', label: 'Outgoing' },
- { id: 'in', label: 'Incoming' },
- { id: 'loop', label: 'Self loops' }
+ { id: 'out', label: viewerText('viewer.passport.relationship.group.out') },
+ { id: 'in', label: viewerText('viewer.passport.relationship.group.in') },
+ { id: 'loop', label: viewerText('viewer.passport.relationship.group.loop') }
].forEach(function (group) {
var items = relationships.filter(function (relationship) { return relationship.direction === group.id; });
if (!items.length) return;
@@ -8305,11 +8504,19 @@
button.setAttribute('data-relationship-from', relationship.from);
button.setAttribute('data-relationship-to', relationship.to);
if (relationship.id) button.setAttribute('data-relationship-id', relationship.id);
- button.setAttribute('aria-label', group.label + ': ' + relationship.label + ', ' + relationship.neighborLabel);
+ button.setAttribute('aria-label', viewerText('viewer.passport.relationship.row', {
+ group: group.label,
+ relationship: relationship.label,
+ neighbor: relationship.neighborLabel
+ }));
var direction = document.createElement('span');
direction.className = 'relationship-lens-direction';
direction.setAttribute('aria-hidden', 'true');
- direction.textContent = relationship.direction === 'out' ? 'OUT →' : relationship.direction === 'in' ? '← IN' : 'LOOP';
+ direction.textContent = viewerText(relationship.direction === 'out'
+ ? 'viewer.passport.relationship.direction.out'
+ : relationship.direction === 'in'
+ ? 'viewer.passport.relationship.direction.in'
+ : 'viewer.passport.relationship.direction.loop');
var target = document.createElement('strong');
target.textContent = relationship.neighborLabel;
var relation = document.createElement('small');
@@ -8360,6 +8567,45 @@
preferred = nodeCenter - chip.offsetHeight / 2;
}
var top = Math.max(minTop, Math.min(maxTop, preferred));
+ var chipRect = chip.getBoundingClientRect();
+ var safeGap = 10;
+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;
+ var protectedRects = (protectViewerChrome
+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]
+ : [])
+ .filter(function (element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ })
+ .map(function (element) { return element.getBoundingClientRect(); })
+ .filter(function (rect) {
+ return rect.width > 0 && rect.height > 0 &&
+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;
+ });
+ if (protectedRects.length) {
+ var candidates = [top, minTop, maxTop];
+ protectedRects.forEach(function (rect) {
+ candidates.push(
+ rect.top - containerRect.top - chip.offsetHeight - safeGap,
+ rect.bottom - containerRect.top + safeGap
+ );
+ });
+ var valid = candidates.map(function (candidate) {
+ return Math.max(minTop, Math.min(maxTop, candidate));
+ }).filter(function (candidate, index, all) {
+ if (all.indexOf(candidate) !== index) return false;
+ var candidateTop = containerRect.top + candidate;
+ var candidateBottom = candidateTop + chip.offsetHeight;
+ return protectedRects.every(function (rect) {
+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;
+ });
+ });
+ valid.sort(function (first, second) {
+ return Math.abs(first - preferred) - Math.abs(second - preferred);
+ });
+ if (valid.length) top = valid[0];
+ }
chip.style.top = Math.round(top) + 'px';
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
}
@@ -8410,10 +8656,10 @@
upstreamBtn.disabled = true;
downstreamBtn.disabled = true;
relationshipList.textContent = '';
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
- relationsBtn.textContent = 'Relations';
- relationsBtn.setAttribute('aria-label', 'Show connected relationships');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
+ relationsBtn.textContent = viewerText('viewer.passport.relations');
+ relationsBtn.setAttribute('aria-label', viewerText('viewer.passport.relations.show'));
relationsBtn.setAttribute('aria-expanded', 'false');
chip.removeAttribute('data-relations-expanded');
chip.style.removeProperty('top');
@@ -8481,7 +8727,7 @@
svg.setAttribute('data-focus-active', normalized.join(' '));
var defaultLabel = normalized.length === 1
? nodeLabel(byId[normalized[0]], normalized[0])
- : normalized.length + ' selected nodes';
+ : viewerText('viewer.guided.chapter.selectedNodes', { count: normalized.length });
label.textContent = options.label || defaultLabel;
chip.hidden = options.hideChip === true || normalized.length !== 1 || selectionMode;
if (!chip.hidden) {
@@ -8527,10 +8773,10 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
copyBtn.setAttribute('aria-label', copied
- ? (relationId ? 'Pinned relationship link copied' : 'Focused node link copied')
- : (relationId ? 'Could not copy pinned relationship link' : 'Could not copy focused node link'));
+ ? viewerText(relationId ? 'viewer.passport.copy.pinned.success' : 'viewer.passport.copy.focused.success')
+ : viewerText(relationId ? 'viewer.passport.copy.pinned.failed' : 'viewer.passport.copy.focused.failed'));
window.setTimeout(function () {
renderRelationshipCopyAction();
}, 1600);
@@ -8569,7 +8815,9 @@
if (expanded) chip.removeAttribute('data-relations-expanded');
else chip.setAttribute('data-relations-expanded', 'true');
relationsBtn.setAttribute('aria-expanded', expanded ? 'false' : 'true');
- relationsBtn.setAttribute('aria-label', expanded ? 'Show connected relationships' : 'Hide connected relationships');
+ relationsBtn.setAttribute('aria-label', viewerText(expanded
+ ? 'viewer.passport.relations.show'
+ : 'viewer.passport.relations.hide'));
requestLensPlacement();
});
relationshipList.addEventListener('click', function (event) {
@@ -8631,7 +8879,7 @@
var target = event.target;
if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;
if (container.getAttribute('data-just-panned') === 'true') return;
- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;
+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;
clear();
}, true);
window.addEventListener('scroll', requestLensPlacement, { passive: true });
@@ -8855,9 +9103,13 @@
svg.setAttribute('data-intent-trace-active', id);
if (options.announce === true) {
var total = counts.out + counts.in + counts.loop;
- status.textContent = nodeLabel(selected, id) + '. ' + counts.out + ' outgoing, ' +
- counts.in + ' incoming' + (counts.loop ? ', ' + counts.loop + ' self loop' : '') +
- '. ' + total + ' connection' + (total === 1 ? '' : 's') + '. Press Enter for details.';
+ status.textContent = viewerText('viewer.intent.summary', {
+ label: nodeLabel(selected, id),
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.intent.loops', { count: counts.loop }) : '',
+ total: total
+ });
}
return true;
}
@@ -9160,8 +9412,11 @@
drawHandoffAnchor(anchor);
var node = findNode(anchor);
var nodeLabel = node ? (node.getAttribute('data-node-label') || anchor) : anchor;
- handoffReceipt.textContent = (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1) +
- ' \u2192 ' + (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1) + ' \u00b7 via ' + nodeLabel;
+ handoffReceipt.textContent = viewerText('viewer.guided.handoff', {
+ from: (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1),
+ to: (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1),
+ label: nodeLabel
+ });
handoffReceipt.hidden = false;
}
if (Archify.motionGovernor) {
@@ -9218,8 +9473,13 @@
button.setAttribute('data-guided-view-id', view.id);
button.setAttribute('aria-pressed', 'false');
button.setAttribute('tabindex', index === 0 ? '0' : '-1');
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + view.label + ', ' + view.focus.length + ' stops');
- button.title = view.label + ' — ' + (view.note || view.focus.length + ' selected nodes');
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.open', {
+ index: index + 1,
+ total: views.length,
+ label: view.label,
+ count: view.focus.length
+ }));
+ button.title = view.label + ' — ' + (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }));
var position = document.createElement('span');
position.className = 'guided-view-chapter-index';
position.setAttribute('aria-hidden', 'true');
@@ -9229,7 +9489,7 @@
title.textContent = view.label;
var stops = document.createElement('em');
stops.className = 'guided-view-chapter-count';
- stops.textContent = view.focus.length + ' stop' + (view.focus.length === 1 ? '' : 's');
+ stops.textContent = viewerCount('viewer.guided.chapter.stop', view.focus.length);
var delta = document.createElement('span');
delta.className = 'guided-view-chapter-delta';
delta.hidden = true;
@@ -9262,20 +9522,40 @@
stops.hidden = false;
deltaLabel.hidden = true;
button.removeAttribute('data-chapter-delta');
- button.setAttribute('aria-label', 'Current chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + ', ' + views[index].focus.length + ' stops');
- button.title = views[index].label + ' — current chapter, ' + views[index].focus.length + ' stops';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.current', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ count: views[index].focus.length
+ }));
+ button.title = viewerText('viewer.guided.chapter.current.title', {
+ label: views[index].label,
+ count: views[index].focus.length
+ });
} else {
var delta = chapterDelta(activeIndex >= 0 ? views[activeIndex] : null, views[index]);
var compact = '=' + delta.stay.length + ' +' + delta.enter.length + ' \u2212' + delta.leave.length;
- var expanded = delta.stay.length + ' stay, ' + delta.enter.length + ' enter, ' + delta.leave.length + ' leave';
+ var expanded = viewerText('viewer.guided.chapter.delta.expanded', {
+ stay: delta.stay.length,
+ enter: delta.enter.length,
+ leave: delta.leave.length
+ });
stops.hidden = true;
deltaLabel.hidden = false;
deltaLabel.querySelector('[data-delta-kind="stay"]').textContent = '=' + delta.stay.length;
deltaLabel.querySelector('[data-delta-kind="enter"]').textContent = '+' + delta.enter.length;
deltaLabel.querySelector('[data-delta-kind="leave"]').textContent = '\u2212' + delta.leave.length;
button.setAttribute('data-chapter-delta', compact);
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + '. Chapter focus delta: ' + expanded);
- button.title = views[index].label + ' — ' + compact + ' chapter focus';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.delta.aria', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ delta: expanded
+ }));
+ button.title = viewerText('viewer.guided.chapter.delta.title', {
+ label: views[index].label,
+ delta: compact
+ });
}
if (current) button.setAttribute('aria-current', 'step');
else button.removeAttribute('aria-current');
@@ -9403,33 +9683,44 @@
function shareCueStatus(state) {
return {
- pending: 'Ready',
- playing: 'Playing',
- complete: 'Settled',
- interrupted: 'Paused',
- pinned: 'Pinned',
- 'reduced-motion': 'Still'
- }[state] || 'Ready';
+ pending: viewerText('viewer.guided.state.ready'),
+ playing: viewerText('viewer.guided.state.playing'),
+ complete: viewerText('viewer.guided.state.settled'),
+ interrupted: viewerText('viewer.guided.state.paused'),
+ pinned: viewerText('viewer.guided.state.pinned'),
+ 'reduced-motion': viewerText('viewer.guided.state.still')
+ }[state] || viewerText('viewer.guided.state.ready');
}
function shareCueBeatCopy(state, view, stops) {
var total = stops.length;
var activeStop = storyBeatIndex >= 0 ? stops[storyBeatIndex] : null;
if ((state === 'playing' || state === 'interrupted') && activeStop) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent;
+ return viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ });
}
if (state === 'pinned' && activeStop) {
return storyBeatCopy(storySteps[storyBeatIndex], total);
}
if (state === 'reduced-motion' && activeStop && hashBeatMatchesCurrent()) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent + ' · Static moment';
+ return viewerText('viewer.guided.share.staticMoment', {
+ step: viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ })
+ });
}
- if (state === 'complete') return total + ' steps complete · ' + (view.note || 'Path settled for reading.');
- if (state === 'reduced-motion') return total + ' steps · Static path';
- if (state === 'pending') return total + ' steps · Ready';
- return view.note || view.focus.length + ' selected nodes';
+ if (state === 'complete') return viewerText('viewer.guided.share.complete', {
+ count: total,
+ note: view.note || viewerText('viewer.guided.share.settled')
+ });
+ if (state === 'reduced-motion') return viewerText('viewer.guided.share.staticPath', { count: total });
+ if (state === 'pending') return viewerText('viewer.guided.share.ready', { count: total });
+ return view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length });
}
function renderShareCue() {
@@ -9454,11 +9745,21 @@
shareCue.setAttribute('data-state', state);
shareCue.setAttribute('aria-live', state === 'playing' ? 'off' : 'polite');
shareCueState.textContent = shareCueStatus(state);
- shareCueCount.textContent = 'Chapter ' + (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1) + ' / ' + (views.length < 10 ? '0' : '') + views.length;
+ shareCueCount.textContent = viewerText('viewer.guided.share.chapter', {
+ index: (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1),
+ total: (views.length < 10 ? '0' : '') + views.length
+ });
shareCueLabel.textContent = view.label;
shareCueNote.textContent = beatCopy;
shareCueRoute.textContent = route;
- shareCue.setAttribute('aria-label', shareCueStatus(state) + ' chapter ' + (activeIndex + 1) + ' of ' + views.length + ': ' + view.label + '. ' + beatCopy + '. ' + route);
+ shareCue.setAttribute('aria-label', viewerText('viewer.guided.share.aria', {
+ state: shareCueStatus(state),
+ index: activeIndex + 1,
+ total: views.length,
+ label: view.label,
+ beat: beatCopy,
+ route: route
+ }));
}
function setShareCueProgress(fraction) {
@@ -9549,24 +9850,24 @@
if (!step) return '';
var position = (step.index + 1 < 10 ? '0' : '') + (step.index + 1);
var countValue = (total < 10 ? '0' : '') + total;
- if (step.relation === 'start') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u00b7 starting point';
- if (step.relation === 'forward') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u2192 ' + step.nodeLabel;
- if (step.relation === 'reverse') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u2192 ' + step.previousLabel + ' \u00b7 reverse authored link';
- if (step.relation === 'multiple') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u21c4 ' + step.nodeLabel + ' \u00b7 ' + step.edges.length + ' authored links';
- return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u00b7 ' + step.nodeLabel + ' \u00b7 grouped \u00b7 no direct link';
+ if (step.relation === 'start') return viewerText('viewer.guided.beat.start', { index: position, total: countValue, label: step.nodeLabel });
+ if (step.relation === 'forward') return viewerText('viewer.guided.beat.forward', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'reverse') return viewerText('viewer.guided.beat.reverse', { index: position, total: countValue, from: step.nodeLabel, to: step.previousLabel });
+ if (step.relation === 'multiple') return viewerText('viewer.guided.beat.multiple', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel, count: step.edges.length });
+ return viewerText('viewer.guided.beat.group', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
}
function storyBeatAria(step, total) {
- var prefix = 'Story beat ' + (step.index + 1) + ' of ' + total + ': ' + step.nodeLabel + '. ';
- if (step.relation === 'start') return prefix + 'Starting point.';
- if (step.relation === 'forward') return prefix + 'From ' + step.previousLabel + ' through one authored forward relationship.';
- if (step.relation === 'reverse') return prefix + 'From ' + step.previousLabel + '; the authored relationship points from ' + step.nodeLabel + ' to ' + step.previousLabel + '.';
- if (step.relation === 'multiple') return prefix + 'From ' + step.previousLabel + ' through ' + step.edges.length + ' authored relationships; shown without arbitrary motion.';
- return prefix + 'Grouped from ' + step.previousLabel + ' with no direct authored relationship.';
+ var prefix = viewerText('viewer.guided.beat.aria.prefix', { index: step.index + 1, total: total, label: step.nodeLabel });
+ if (step.relation === 'start') return prefix + viewerText('viewer.guided.beat.aria.start');
+ if (step.relation === 'forward') return prefix + viewerText('viewer.guided.beat.aria.forward', { from: step.previousLabel });
+ if (step.relation === 'reverse') return prefix + viewerText('viewer.guided.beat.aria.reverse', { from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'multiple') return prefix + viewerText('viewer.guided.beat.aria.multiple', { from: step.previousLabel, count: step.edges.length });
+ return prefix + viewerText('viewer.guided.beat.aria.group', { from: step.previousLabel });
}
function storyCaptionRouteCopy(step) {
- if (step.relation === 'start') return step.nodeLabel + ' · Starting point';
+ if (step.relation === 'start') return step.nodeLabel + ' · ' + viewerText('viewer.guided.caption.start');
if (step.relation === 'reverse') return step.previousLabel + ' ← ' + step.nodeLabel;
if (step.relation === 'multiple') return step.previousLabel + ' ⇄ ' + step.nodeLabel;
if (step.relation === 'group') return step.previousLabel + ' · ' + step.nodeLabel;
@@ -9575,15 +9876,15 @@
function storyCaptionDetailCopy(step) {
var facts = [];
- if (step.relation === 'group') facts.push('Grouped transition · no direct authored link');
- else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? ' +' + (step.edgeLabels.length - 3) + ' more' : ''));
- else if (step.relation === 'reverse') facts.push('Reverse authored relationship');
- else if (step.relation === 'multiple') facts.push(step.edges.length + ' authored relationships');
- else if (step.relation !== 'start') facts.push('Authored relationship');
- if (step.relation === 'reverse') facts.push('authored direction: ' + step.nodeLabel + ' → ' + step.previousLabel);
+ if (step.relation === 'group') facts.push(viewerText('viewer.guided.caption.grouped'));
+ else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? viewerText('viewer.guided.caption.more', { count: step.edgeLabels.length - 3 }) : ''));
+ else if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.reverse'));
+ else if (step.relation === 'multiple') facts.push(viewerText('viewer.guided.caption.relationships', { count: step.edges.length }));
+ else if (step.relation !== 'start') facts.push(viewerText('viewer.guided.caption.relationship'));
+ if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.direction', { from: step.nodeLabel, to: step.previousLabel }));
if (step.responsibility) facts.push(step.responsibility);
if (step.context) facts.push(step.context);
- if (!facts.length) facts.push('Authored starting point');
+ if (!facts.length) facts.push(viewerText('viewer.guided.caption.starting'));
return facts.join(' · ');
}
@@ -9639,17 +9940,17 @@
if (beatLinkFeedbackTimer) clearTimeout(beatLinkFeedbackTimer);
beatLinkFeedbackTimer = null;
beatLink.removeAttribute('data-copy-state');
- beatLinkLabel.textContent = 'Copy moment';
+ beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
}
function syncBeatLink() {
var step = storyBeatIndex >= 0 ? storySteps[storyBeatIndex] : null;
var available = !!(activeIndex >= 0 && step && !currentHandoff);
beatLink.disabled = !available;
- if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = 'Copy moment';
+ if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
var description = available
- ? 'Copy link to current story moment: Beat ' + (step.index + 1) + ' of ' + storySteps.length + ': ' + step.nodeLabel
- : 'Select a Story Beat to copy its exact link';
+ ? viewerText('viewer.guided.beatLink', { index: step.index + 1, total: storySteps.length, label: step.nodeLabel })
+ : viewerText('viewer.guided.selectBeatLink');
beatLink.setAttribute('aria-label', description);
beatLink.title = description;
}
@@ -9657,8 +9958,8 @@
function setBeatLinkFeedback(copied) {
resetBeatLinkFeedback();
beatLink.setAttribute('data-copy-state', copied ? 'copied' : 'failed');
- beatLinkLabel.textContent = copied ? 'Copied' : 'Copy failed';
- beatLink.setAttribute('aria-label', copied ? 'Moment link copied' : 'Could not copy story moment link');
+ beatLinkLabel.textContent = viewerText(copied ? 'viewer.guided.copied' : 'viewer.guided.copyFailed');
+ beatLink.setAttribute('aria-label', viewerText(copied ? 'viewer.guided.momentCopied' : 'viewer.guided.momentCopyFailed'));
beatLinkFeedbackTimer = setTimeout(function () {
resetBeatLinkFeedback();
syncBeatLink();
@@ -9912,7 +10213,7 @@
stop.removeAttribute('aria-current');
});
note.setAttribute('aria-live', 'polite');
- if (activeIndex >= 0) note.textContent = views[activeIndex].note || views[activeIndex].focus.length + ' selected nodes';
+ if (activeIndex >= 0) note.textContent = views[activeIndex].note || viewerText('viewer.guided.chapter.selectedNodes', { count: views[activeIndex].focus.length });
renderStoryCaption(null, 0);
renderShareCue();
syncBeatLink();
@@ -9991,7 +10292,7 @@
trail.appendChild(stop);
});
trail.hidden = labels.length === 0;
- trail.setAttribute('aria-label', 'Story trail for ' + view.label + ': ' + labels.length + ' beats');
+ trail.setAttribute('aria-label', viewerText('viewer.guided.storyTrail', { label: view.label, count: labels.length }));
trail.scrollLeft = 0;
svg.setAttribute('data-story-active', view.id);
@@ -10070,21 +10371,39 @@
syncStoryPlayback();
play.disabled = !playing && !automaticPlaybackAllowed;
play.setAttribute('aria-pressed', playing ? 'true' : 'false');
- play.setAttribute('aria-label', playing ? 'Pause guided story' : (!automaticPlaybackAllowed ? 'Story playback unavailable while motion is Still' : (storyPlaybackComplete ? 'Replay guided story' : 'Play guided story')));
- play.title = playing ? 'Pause guided story (P)' : (!automaticPlaybackAllowed ? 'Switch motion to Live to play the guided story' : (storyPlaybackComplete ? 'Replay guided story (P)' : 'Play guided story (P)'));
+ play.setAttribute('aria-label', viewerText(playing
+ ? 'viewer.guided.pause'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.motionUnavailable'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay'
+ : 'viewer.guided.play'));
+ play.title = viewerText(playing
+ ? 'viewer.guided.pause.title'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.enableMotion'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay.title'
+ : 'viewer.guided.play.title');
playIcon.textContent = playing ? '\u2016' : '\u25b6';
- playLabel.textContent = playing ? 'Pause' : (storyPlaybackComplete ? 'Replay story' : 'Play story');
+ playLabel.textContent = viewerText(playing
+ ? 'viewer.guided.pauseStory'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replayStory'
+ : 'viewer.guided.playStory');
if (storyCaption && !storyCaption.hidden) storyCaption.setAttribute('aria-live', playing ? 'off' : 'polite');
}
function render() {
var view = views[activeIndex];
count.textContent = activeIndex < 0 ? '0 / ' + views.length : (activeIndex + 1) + ' / ' + views.length;
- label.textContent = view ? view.label : 'Explore this system';
+ label.textContent = view ? view.label : viewerText('viewer.guided.explore');
note.setAttribute('aria-live', storyBeatIndex >= 0 ? 'off' : 'polite');
note.textContent = storyBeatIndex >= 0
? storyBeatCopy(storySteps[storyBeatIndex], storySteps.length)
- : (view ? (view.note || view.focus.length + ' selected nodes') : 'Step through curated paths without changing the source diagram.');
+ : (view
+ ? (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }))
+ : viewerText('viewer.guided.intro'));
prev.disabled = activeIndex < 0;
next.disabled = activeIndex >= views.length - 1;
all.disabled = activeIndex < 0;
@@ -10568,6 +10887,46 @@
embed, presentation, print, and non-wide diagrams retain their own
established layout contracts.
============================================================ */
+ Archify.waitForStableLayout = function (options) {
+ options = options || {};
+ var maximumFrames = Math.max(1, Number(options.maximumFrames) || 240);
+ var fontsReady = document.fonts && document.fonts.ready
+ ? document.fonts.ready.catch(function () {})
+ : Promise.resolve();
+ return fontsReady.then(function () {
+ if (typeof options.schedule === 'function') options.schedule();
+ return new Promise(function (resolve, reject) {
+ var previous = '';
+ var stableFrames = 0;
+ var sampledFrames = 0;
+ function sample() {
+ sampledFrames += 1;
+ if (typeof options.pending === 'function' && options.pending()) {
+ previous = '';
+ stableFrames = 0;
+ } else {
+ var current = typeof options.snapshot === 'function' ? options.snapshot() : '';
+ if (current === previous) stableFrames += 1;
+ else {
+ previous = current;
+ stableFrames = 0;
+ }
+ if (stableFrames >= 3) {
+ resolve({ stable: true, snapshot: current, sampledFrames: sampledFrames });
+ return;
+ }
+ }
+ if (sampledFrames >= maximumFrames) {
+ reject(new Error(options.timeoutMessage || 'Layout did not reach stable dimensions.'));
+ return;
+ }
+ requestAnimationFrame(sample);
+ }
+ requestAnimationFrame(sample);
+ });
+ });
+ };
+
Archify.readerLayout = (function () {
var html = document.documentElement;
var body = document.body;
@@ -10687,6 +11046,31 @@
if (frame) return;
frame = requestAnimationFrame(measure);
}
+ function stableSnapshot() {
+ var shellRect = shell ? shell.getBoundingClientRect() : { width: 0, height: 0 };
+ var diagramRect = diagram ? diagram.getBoundingClientRect() : { width: 0, height: 0 };
+ return [
+ lastWidth,
+ html.getAttribute('data-reader-layout') || '',
+ html.getAttribute('data-reader-overflow') || '',
+ Math.ceil(document.documentElement.scrollWidth),
+ Math.ceil(document.documentElement.scrollHeight),
+ Math.ceil(document.body.scrollWidth),
+ Math.ceil(document.body.scrollHeight),
+ Math.round(shellRect.width * 100) / 100,
+ Math.round(shellRect.height * 100) / 100,
+ Math.round(diagramRect.width * 100) / 100,
+ Math.round(diagramRect.height * 100) / 100
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Adaptive reader layout did not reach stable dimensions.'
+ });
+ }
window.addEventListener('resize', schedule, { passive: true });
window.addEventListener('load', schedule, { once: true });
@@ -10706,11 +11090,324 @@
return {
measure: measure,
schedule: schedule,
+ whenStable: whenStable,
active: function () { return html.getAttribute('data-reader-layout') === 'adaptive'; },
receipt: function () { return { ratio: ratio, width: lastWidth }; }
};
})();
+ /* ============================================================
+ Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
+ ============================================================ */
+ Archify.viewerChromeLayout = (function () {
+ var html = document.documentElement;
+ var container = document.querySelector('.diagram-container');
+ var svg = container && container.querySelector(':scope > svg');
+ var nav = container && container.querySelector('.diagram-nav');
+ var legend = svg && svg.querySelector('[data-legend]');
+ var frame = 0;
+ var settleFrame = 0;
+ var reserve = 0;
+ var railLatched = false;
+ var probingBaseline = false;
+ var probePromise = null;
+ var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
+ var lastReceipt = null;
+ var SAFE_GAP = 10;
+
+ function visible(element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ }
+ function usable(rect) {
+ return Boolean(rect && rect.width > 0 && rect.height > 0);
+ }
+ function intersectionArea(a, b) {
+ var width = Math.max(0, Math.min(a.right, b.right) - Math.max(a.left, b.left));
+ var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
+ return width * height;
+ }
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
+ function eligible() {
+ return Boolean(
+ container && svg && nav &&
+ window.innerWidth > 720 &&
+ html.getAttribute('data-embed') !== 'true' &&
+ (!window.matchMedia || !window.matchMedia('print').matches) &&
+ visible(nav)
+ );
+ }
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
+ function writeReserve(next, options) {
+ options = options || {};
+ next = Math.max(0, Math.ceil(next));
+ if (Math.abs(next - reserve) < 1) return false;
+ reserve = next;
+ if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
+ container.style.setProperty('--archify-nav-reserve', reserve + 'px');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
+ } else {
+ container.style.removeProperty('--archify-nav-reserve');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
+ }
+ if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
+ Archify.readerLayout.schedule();
+ }
+ if (options.quiet !== true) {
+ if (settleFrame) cancelAnimationFrame(settleFrame);
+ settleFrame = requestAnimationFrame(function () {
+ settleFrame = 0;
+ schedule();
+ });
+ }
+ return true;
+ }
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
+ writeReserve(0, { quiet: probingBaseline });
+ lastReceipt = {
+ eligible: false,
+ active: false,
+ reserve: 0,
+ gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
+ baselineIntersectionArea: 0,
+ intersectionArea: 0
+ };
+ return lastReceipt;
+ }
+ function measure() {
+ frame = 0;
+ if (probingBaseline) return null;
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
+
+ var navRect = nav.getBoundingClientRect();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
+
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
+ baselineIntersectionArea = actualIntersectionArea;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
+ }
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
+ if (writeReserve(reserve + remaining)) return null;
+ }
+
+ navRect = nav.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
+ };
+ return lastReceipt;
+ }
+ function reprobe() {
+ if (probingBaseline) return probePromise || Promise.resolve(false);
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
+ probingBaseline = true;
+ railLatched = false;
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ writeReserve(0, { quiet: true });
+ var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
+ ? Archify.readerLayout.whenStable().catch(function () {})
+ : Promise.resolve();
+ probePromise = readerReady.then(function () {
+ probingBaseline = false;
+ probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
+ schedule();
+ return true;
+ });
+ return probePromise;
+ }
+ function schedule() {
+ if (frame) return;
+ frame = requestAnimationFrame(measure);
+ }
+ function stableSnapshot() {
+ var containerRect = container ? container.getBoundingClientRect() : { width: 0, height: 0 };
+ var navRect = nav ? nav.getBoundingClientRect() : { top: 0, left: 0 };
+ var legendRect = legend ? legend.getBoundingClientRect() : { top: 0, left: 0 };
+ return [
+ reserve,
+ Math.round(containerRect.width * 100) / 100,
+ Math.round(containerRect.height * 100) / 100,
+ Math.round(navRect.left * 100) / 100,
+ Math.round(navRect.top * 100) / 100,
+ Math.round(legendRect.left * 100) / 100,
+ Math.round(legendRect.top * 100) / 100,
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame || probingBaseline); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Viewer chrome layout did not reach stable dimensions.'
+ });
+ }
+
+ window.addEventListener('resize', reprobe, { passive: true });
+ window.addEventListener('load', schedule, { once: true });
+ window.addEventListener('beforeprint', schedule);
+ window.addEventListener('afterprint', reprobe);
+ if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
+ if (typeof ResizeObserver === 'function') {
+ var resizeObserver = new ResizeObserver(schedule);
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ }
+ if (typeof MutationObserver === 'function') {
+ var contentObserver = new MutationObserver(function (records) {
+ var viewerModeChanged = records.some(function (record) { return record.target === html; });
+ if (viewerModeChanged) reprobe();
+ else schedule();
+ });
+ if (legend) contentObserver.observe(legend, { attributes: true, childList: true, subtree: true });
+ contentObserver.observe(html, {
+ attributes: true,
+ attributeFilter: ['data-embed', 'data-present', 'data-preset', 'data-theme']
+ });
+ }
+ schedule();
+
+ return {
+ measure: measure,
+ schedule: schedule,
+ reprobe: reprobe,
+ whenStable: whenStable,
+ stageRect: protectedStageRect,
+ active: function () { return reserve > 0; },
+ receipt: function () { return lastReceipt || measure(); }
+ };
+ })();
+
Archify.view = (function () {
var container = document.querySelector('.diagram-container');
var svg = container.querySelector('svg');
@@ -10725,6 +11422,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -10786,36 +11484,76 @@
var semantic = state.mode === 'semantic' && state.scale > 1.01;
var detail = detailLevel();
var percent = Math.round(state.scale * 100) + '%';
- var levelLabel = detail === 'map' ? 'MAP ' : detail === 'read' ? 'READ ' : 'FULL ';
+ var levelLabel = viewerText('viewer.nav.level.' + detail);
var detailHint = detail === 'map'
- ? 'Zoom in to reveal relationship labels and node context'
+ ? viewerText('viewer.nav.detail.map')
: detail === 'read'
- ? 'Zoom in again to reveal tags and annotations'
- : 'Full diagram detail';
- var resolvedLevel = (semantic ? 'AUTO ' : levelLabel).trim();
- var showDetailLevel = resolvedLevel !== 'READ';
+ ? viewerText('viewer.nav.detail.read')
+ : viewerText('viewer.nav.detail.full');
+ var resolvedLevel = semantic ? viewerText('viewer.nav.level.auto') : levelLabel;
+ var showDetailLevel = semantic || detail !== 'read';
if (resetDetailLabel) {
resetDetailLabel.textContent = resolvedLevel;
resetDetailLabel.hidden = !showDetailLevel;
}
if (resetPercentLabel) resetPercentLabel.textContent = percent;
resetBtn.toggleAttribute('data-detail-visible', showDetailLevel);
- resetBtn.title = (semantic ? 'Semantic camera active · ' : '') + detailHint + ' · reset view (0)';
- resetBtn.setAttribute('aria-label', detailHint + '. Reset diagram view');
+ resetBtn.title = viewerText('viewer.nav.camera.title', {
+ semantic: semantic ? viewerText('viewer.nav.camera.semantic') : '',
+ hint: detailHint
+ });
+ resetBtn.setAttribute('aria-label', viewerText('viewer.nav.camera', { hint: detailHint }));
resetBtn.setAttribute('data-detail-level', detail);
container.setAttribute('data-detail-level', detail);
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
container.classList.toggle('is-pannable', state.scale > 1);
svg.setAttribute('data-view-scale', String(state.scale));
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
+ if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.schedule === 'function') {
+ Archify.viewerChromeLayout.schedule();
+ }
}
function sampleRenderedState() {
var transform = '';
@@ -11206,21 +11944,35 @@
var container = document.querySelector('.diagram-container');
var diagram = container.querySelector(':scope > svg');
var panel = document.getElementById('overview-map');
+ var panelHead = panel.querySelector('.overview-map-head');
var surface = document.getElementById('overview-map-surface');
var status = document.getElementById('overview-map-status');
var trigger = document.getElementById('btn-overview-map');
var closeBtn = document.getElementById('overview-map-close');
+ var expandBtn = document.getElementById('overview-map-expand');
+ var feedback = document.getElementById('overview-map-feedback');
+ var navigation = container.querySelector('.diagram-nav');
+ var passport = document.getElementById('focus-chip');
var namespace = 'http://www.w3.org/2000/svg';
var viewBox = diagram.viewBox && diagram.viewBox.baseVal;
var mapSvg = document.createElementNS(namespace, 'svg');
var nodeLayer = document.createElementNS(namespace, 'g');
var viewport = document.createElementNS(namespace, 'rect');
var nodes = [];
- var drag = null;
+ var viewportDrag = null;
+ var panelDrag = null;
+ var manualPosition = null;
+ var lastPlacement = null;
+ var requestedOpen = false;
+ var passportYielded = false;
+ var passportPreviousAriaHidden = null;
var syncFrame = 0;
+ var spaceRetryTimer = 0;
+ var spaceRetryCount = 0;
+ var placementGap = 16;
mapSvg.setAttribute('role', 'group');
- mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');
+ mapSvg.setAttribute('aria-label', viewerText('viewer.radar.nodes'));
mapSvg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
nodeLayer.setAttribute('class', 'overview-map-nodes');
viewport.setAttribute('class', 'overview-map-viewport');
@@ -11255,63 +12007,301 @@
rect.setAttribute('data-kind', node.getAttribute('data-node-kind') || 'neutral');
rect.setAttribute('tabindex', '0');
rect.setAttribute('role', 'button');
- rect.setAttribute('aria-label', 'Focus ' + nodeLabel(node, id) + ' from Semantic Radar');
+ rect.setAttribute('aria-label', viewerText('viewer.radar.focus', { label: nodeLabel(node, id) }));
nodeLayer.appendChild(rect);
nodes.push({ id: id, node: node, rect: rect });
});
- status.textContent = nodes.length + ' nodes · full map';
+ status.textContent = viewerText('viewer.radar.fullMap', { count: nodes.length });
return true;
}
- function updateDocking() {
- if (panel.hidden) return;
- var containerRect = container.getBoundingClientRect();
- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;
- if (!intersectsWindow) {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
- return;
- }
- var active = diagram.querySelector('[data-focus-selected]');
- var activeRect = active ? active.getBoundingClientRect() : null;
- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);
- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));
- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));
- var topLimit = Math.max(16, containerRect.top + 16);
- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);
- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;
- var panelRight = panelLeft + panel.offsetWidth;
+ function visibleRect(element) {
+ if (!element || element.hidden) return null;
+ var rect = element.getBoundingClientRect();
+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;
+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };
+ }
+ function panelRectAt(position) {
+ return {
+ left: position.left,
+ top: position.top,
+ right: position.left + panel.offsetWidth,
+ bottom: position.top + panel.offsetHeight,
+ width: panel.offsetWidth,
+ height: panel.offsetHeight
+ };
+ }
+ function rectsIntersect(first, second, gap) {
+ gap = Number(gap) || 0;
+ return first.left < second.right + gap &&
+ first.right > second.left - gap &&
+ first.top < second.bottom + gap &&
+ first.bottom > second.top - gap;
+ }
+ function intersectionArea(first, second) {
+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));
+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));
+ return width * height;
+ }
+ function clamp(value, minimum, maximum) {
+ if (maximum < minimum) return minimum;
+ return Math.max(minimum, Math.min(maximum, value));
+ }
+ function placementContext() {
+ var containerRect = visibleRect(container);
+ if (!containerRect) return null;
+ var controlRect = visibleRect(navigation);
+ var left = Math.max(placementGap, containerRect.left + placementGap);
+ var top = Math.max(placementGap, containerRect.top + placementGap);
+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);
+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);
+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);
var lens = document.getElementById('focus-chip');
- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;
- var blockers = [activeRect, lensRect].filter(function (rect) {
- return rect && rect.right > panelLeft && rect.left < panelRight;
- });
- var desiredTop = bottomLimit - panel.offsetHeight;
- var candidates = [desiredTop, topLimit];
- blockers.forEach(function (rect) {
- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);
- });
- var valid = candidates.filter(function (candidate) {
- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;
- return blockers.every(function (rect) {
- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;
- });
+ var lensRect = visibleRect(lens);
+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));
+ var active = diagram.querySelector('[data-focus-selected]');
+ var activeRect = visibleRect(active);
+ return {
+ bounds: { left: left, top: top, right: right, bottom: bottom },
+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),
+ softBlockers: [activeRect].filter(Boolean),
+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'
+ };
+ }
+ function positionIsValid(position, context) {
+ if (!position || !context) return false;
+ var rect = panelRectAt(position);
+ var bounds = context.bounds;
+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;
+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });
+ }
+ function cornerCandidates(context) {
+ var bounds = context.bounds;
+ var left = bounds.left;
+ var right = Math.max(left, bounds.right - panel.offsetWidth);
+ var top = bounds.top;
+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);
+ var preferredLeft = context.preferredSide === 'left' ? left : right;
+ var alternateLeft = context.preferredSide === 'left' ? right : left;
+ return [
+ { left: preferredLeft, top: bottom },
+ { left: alternateLeft, top: bottom },
+ { left: preferredLeft, top: top },
+ { left: alternateLeft, top: top }
+ ].filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function nearbyCandidates(context, reference) {
+ var bounds = context.bounds;
+ var maximumLeft = bounds.right - panel.offsetWidth;
+ var maximumTop = bounds.bottom - panel.offsetHeight;
+ var requested = reference ? {
+ left: clamp(reference.left, bounds.left, maximumLeft),
+ top: clamp(reference.top, bounds.top, maximumTop)
+ } : null;
+ var horizontal = [bounds.left, maximumLeft];
+ var vertical = [bounds.top, maximumTop];
+ if (requested) {
+ horizontal.push(requested.left);
+ vertical.push(requested.top);
+ }
+ context.hardBlockers.forEach(function (blocker) {
+ horizontal.push(
+ blocker.left - placementGap - panel.offsetWidth,
+ blocker.right + placementGap
+ );
+ vertical.push(
+ blocker.top - placementGap - panel.offsetHeight,
+ blocker.bottom + placementGap
+ );
+ });
+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });
+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });
+ var candidates = [];
+ horizontal.forEach(function (left) {
+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });
});
- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });
- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);
- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);
+ return candidates.filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function placementScore(position, context, reference, softWeight) {
+ var rect = panelRectAt(position);
+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);
+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;
+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);
+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);
+ return distance + softOverlap * softWeight;
+ }
+ function chooseRadarPlacement(context, reference, options) {
+ options = options || {};
+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;
+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));
+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });
+ valid.sort(function (first, second) {
+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);
+ });
+ return valid.length ? valid[0] : null;
+ }
+ function applyPlacement(position, remember) {
+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;
panel.setAttribute('data-docked', 'true');
- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');
- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');
- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');
- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');
+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');
+ if (useLeft) {
+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');
+ panel.style.removeProperty('--archify-radar-right');
+ } else {
+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');
+ panel.style.removeProperty('--archify-radar-left');
+ }
+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');
+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };
+ }
+ function resetDockingStyles() {
+ panel.removeAttribute('data-docked');
+ panel.removeAttribute('data-dock-side');
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ panel.style.removeProperty('--archify-radar-right');
+ panel.style.removeProperty('--archify-radar-left');
+ panel.style.removeProperty('--archify-radar-top');
+ }
+ function updateDocking() {
+ var options = arguments[0] || {};
+ if (panel.hidden) return false;
+ if (panelDrag) return true;
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ var context = placementContext();
+ if (!context) {
+ resetDockingStyles();
+ return false;
+ }
+ var reference = manualPosition || lastPlacement;
+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };
+ var placement = manualPosition && positionIsValid(manualPosition, context)
+ ? manualPosition
+ : chooseRadarPlacement(context, reference, placementOptions);
+ var compact = false;
+ if (!placement && options.allowCompact !== false) {
+ compact = true;
+ panel.setAttribute('data-compact', 'true');
+ panel.setAttribute('data-placement-degraded', 'true');
+ panel.setAttribute('title', viewerText('viewer.radar.compacted'));
+ context = placementContext();
+ placement = chooseRadarPlacement(context, reference, placementOptions);
+ }
+ if (!placement) {
+ resetDockingStyles();
+ panel.setAttribute('data-placement-unavailable', 'true');
+ return false;
+ }
+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };
+ applyPlacement(placement, true);
+ return true;
+ }
+ function clearSpaceRetry() {
+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);
+ spaceRetryTimer = 0;
+ }
+ function yieldPassport() {
+ if (!passport || passport.hidden || passportYielded) return passportYielded;
+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');
+ passportYielded = true;
+ passport.setAttribute('data-radar-yielded', 'true');
+ passport.setAttribute('aria-hidden', 'true');
+ return true;
+ }
+ function restorePassport() {
+ if (!passport || !passportYielded) return;
+ passportYielded = false;
+ passport.removeAttribute('data-radar-yielded');
+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');
+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);
+ passportPreviousAriaHidden = null;
+ }
+ function reflectVisible() {
+ panel.hidden = false;
+ panel.removeAttribute('data-placement-unavailable');
+ trigger.setAttribute('aria-expanded', 'true');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.close'));
+ trigger.title = viewerText('viewer.nav.radar.title');
+ feedback.hidden = true;
+ }
+ function scheduleSpaceRetry() {
+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;
+ spaceRetryCount += 1;
+ spaceRetryTimer = window.setTimeout(function () {
+ spaceRetryTimer = 0;
+ attemptRequestedOpen();
+ }, 60);
+ }
+ function reflectUnavailable() {
+ restorePassport();
+ panel.hidden = true;
+ panel.setAttribute('data-placement-unavailable', 'true');
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.cancelWaiting'));
+ trigger.setAttribute('data-radar-space-limited', 'true');
+ trigger.title = viewerText('viewer.radar.needsSpace');
+ feedback.hidden = false;
+ scheduleSpaceRetry();
+ }
+ function attemptRequestedOpen(options) {
+ options = options || {};
+ if (!requestedOpen) return false;
+ panel.hidden = false;
+ if (!updateDocking(options)) {
+ reflectUnavailable();
+ return false;
+ }
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ reflectVisible();
+ sync();
+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();
+ return true;
+ }
+ function expandCompactRadar() {
+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;
+ yieldPassport();
+ if (!updateDocking({ allowCompact: false })) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return false;
+ }
+ }
+ reflectVisible();
+ sync();
+ if (!panel.hasAttribute('data-compact')) surface.focus();
+ return !panel.hasAttribute('data-compact');
}
function syncNow() {
syncFrame = 0;
if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;
- updateDocking();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ if (passportYielded && panel.hasAttribute('data-compact')) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ }
+ reflectVisible();
var visible = Archify.view.logicalViewport();
if (!visible) return;
viewport.setAttribute('x', String(visible.x));
@@ -11321,9 +12311,11 @@
var full = visible.width >= viewBox.width * 0.98 && visible.height >= viewBox.height * 0.98;
var mobileWide = window.innerWidth <= 720 && container.hasAttribute('data-wide-diagram');
var viewportCopy = full
- ? 'full map'
- : (mobileWide ? Math.round(visible.width / viewBox.width * 100) + '% width' : Math.round(visible.scale * 100) + '% viewport');
- status.textContent = nodes.length + ' nodes · ' + viewportCopy;
+ ? viewerText('viewer.radar.viewport.full')
+ : (mobileWide
+ ? viewerText('viewer.radar.viewport.width', { percent: Math.round(visible.width / viewBox.width * 100) })
+ : viewerText('viewer.radar.viewport.scale', { percent: Math.round(visible.scale * 100) }));
+ status.textContent = viewerText('viewer.radar.status', { count: nodes.length, viewport: viewportCopy });
nodes.forEach(function (item) {
var active = item.node.hasAttribute('data-focus-selected') ||
item.node.getAttribute('data-story-beat-state') === 'active';
@@ -11332,6 +12324,10 @@
});
}
function sync() {
+ if (requestedOpen && panel.hidden) {
+ attemptRequestedOpen();
+ return;
+ }
if (syncFrame) return;
syncFrame = requestAnimationFrame(syncNow);
}
@@ -11342,25 +12338,31 @@
if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {
Archify.semanticLens.close({ restoreFocus: false });
}
- panel.hidden = !next;
- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');
- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');
+ requestedOpen = next;
if (next) {
+ clearSpaceRetry();
+ spaceRetryCount = 0;
build();
- updateDocking();
- sync();
- if (options.focus === true) surface.focus();
+ attemptRequestedOpen(options);
} else {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ viewportDrag = null;
+ panelDrag = null;
+ container.classList.remove('is-panning');
+ panel.hidden = true;
+ resetDockingStyles();
+ restorePassport();
+ feedback.hidden = true;
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.nav.radar'));
+ trigger.title = viewerText('viewer.nav.radar.title');
if (options.restoreFocus === true) trigger.focus();
}
return next;
}
- function toggle() { return setOpen(panel.hidden, { focus: false }); }
+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }
function close(options) { return setOpen(false, options); }
function bringNodeIntoWindow(node) {
var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;
@@ -11405,31 +12407,91 @@
Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });
sync();
}
- function endDrag(event) {
- if (!drag) return;
- drag = null;
+ function endViewportDrag(event) {
+ if (!viewportDrag) return;
+ viewportDrag = null;
panel.removeAttribute('data-dragging');
container.classList.remove('is-panning');
try { surface.releasePointerCapture(event.pointerId); } catch (_) {}
}
+ function beginPanelDrag(event) {
+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;
+ var context = placementContext();
+ if (!context) return;
+ var rect = panel.getBoundingClientRect();
+ event.preventDefault();
+ event.stopPropagation();
+ panelDrag = {
+ pointerId: event.pointerId,
+ originX: event.clientX,
+ originY: event.clientY,
+ start: { left: rect.left, top: rect.top },
+ current: { left: rect.left, top: rect.top },
+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null
+ };
+ panel.setAttribute('data-panel-dragging', 'true');
+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}
+ }
+ function movePanelDrag(event) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ var context = placementContext();
+ if (!context) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var bounds = context.bounds;
+ var position = {
+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),
+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)
+ };
+ panelDrag.current = position;
+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');
+ else panel.setAttribute('data-placement-invalid', 'true');
+ applyPlacement(position, false);
+ }
+ function finishPanelDrag(event, cancel) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var activeDrag = panelDrag;
+ panelDrag = null;
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}
+ var context = placementContext();
+ if (!context) return;
+ if (cancel) {
+ manualPosition = activeDrag.previousManual;
+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };
+ updateDocking();
+ return;
+ }
+ var requested = activeDrag.current;
+ manualPosition = { left: requested.left, top: requested.top };
+ updateDocking();
+ }
trigger.addEventListener('click', toggle);
closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });
+ expandBtn.addEventListener('click', expandCompactRadar);
+ panelHead.addEventListener('pointerdown', beginPanelDrag);
+ panelHead.addEventListener('pointermove', movePanelDrag);
+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });
+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });
surface.addEventListener('pointerdown', function (event) {
if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;
event.preventDefault();
- drag = { pointerId: event.pointerId };
+ viewportDrag = { pointerId: event.pointerId };
panel.setAttribute('data-dragging', 'true');
container.classList.add('is-panning');
try { surface.setPointerCapture(event.pointerId); } catch (_) {}
navigate(event);
});
surface.addEventListener('pointermove', function (event) {
- if (!drag || drag.pointerId !== event.pointerId) return;
+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;
navigate(event);
});
- surface.addEventListener('pointerup', endDrag);
- surface.addEventListener('pointercancel', endDrag);
+ surface.addEventListener('pointerup', endViewportDrag);
+ surface.addEventListener('pointercancel', endViewportDrag);
surface.addEventListener('click', function (event) {
var node = event.target.closest('[data-radar-node-id]');
if (node) focusNode(node.getAttribute('data-radar-node-id'));
@@ -11462,8 +12524,32 @@
Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });
sync();
});
- window.addEventListener('resize', sync);
- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });
+ document.addEventListener('keydown', function (event) {
+ if (!panelDrag || event.key !== 'Escape') return;
+ finishPanelDrag({
+ pointerId: panelDrag.pointerId,
+ preventDefault: function () { event.preventDefault(); },
+ stopPropagation: function () { event.stopPropagation(); }
+ }, true);
+ }, true);
+ function reflow() {
+ if (!requestedOpen) return;
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ sync();
+ }
+ window.addEventListener('resize', reflow);
+ window.addEventListener('scroll', reflow, { passive: true });
+ if (typeof ResizeObserver === 'function') {
+ var radarResizeObserver = new ResizeObserver(function (entries) {
+ if (!requestedOpen) return;
+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;
+ reflow();
+ });
+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {
+ radarResizeObserver.observe(element);
+ });
+ }
requestAnimationFrame(build);
return {
@@ -11472,7 +12558,7 @@
toggle: toggle,
sync: sync,
focus: focusNode,
- isOpen: function () { return !panel.hidden; },
+ isOpen: function () { return requestedOpen; },
count: function () { return nodes.length; }
};
})();
@@ -11502,9 +12588,9 @@
function render(next) {
btn.setAttribute('aria-pressed', next ? 'true' : 'false');
- btn.setAttribute('aria-label', next ? 'Exit presentation stage' : 'Enter presentation stage');
- btn.title = next ? 'Exit presentation stage (F or Escape)' : 'Presentation stage (F)';
- label.textContent = next ? 'Exit' : 'Present';
+ btn.setAttribute('aria-label', viewerText(next ? 'viewer.present.exit' : 'viewer.present.enter'));
+ btn.title = viewerText(next ? 'viewer.present.exit.title' : 'viewer.present.enter.title');
+ label.textContent = viewerText(next ? 'viewer.present.exit.label' : 'viewer.present.present');
}
function setActive(next, options) {
@@ -11573,11 +12659,11 @@
function defaultContext() {
return {
kind: 'focus',
- title: 'Find a node',
- placeholder: 'Search labels or IDs',
- empty: 'No matching nodes',
- resultsLabel: 'Diagram nodes',
- availableNoun: 'nodes',
+ title: viewerText('viewer.finder.title'),
+ placeholder: viewerText('viewer.finder.placeholder'),
+ empty: viewerText('viewer.finder.empty'),
+ resultsLabel: viewerText('viewer.finder.results'),
+ availableNoun: viewerText('viewer.finder.noun.nodes'),
allowedIds: null,
badges: null
};
@@ -11702,13 +12788,13 @@
var badge = context.badges && context.badges[item.id]
? context.badges[item.id]
: context.kind === 'focus'
- ? item.links + (item.links === 1 ? ' link' : ' links')
+ ? viewerCount('viewer.finder.link', item.links)
: String(item.links);
var action = context.kind === 'route-source'
- ? 'Choose ' + item.label + ' as route start'
+ ? viewerText('viewer.finder.result.routeStart', { label: item.label })
: context.kind === 'route-target'
- ? 'Choose ' + item.label + ' as route destination, ' + badge
- : 'Focus ' + item.label + ', ' + item.links + ' related connection' + (item.links === 1 ? '' : 's');
+ ? viewerText('viewer.finder.result.routeTarget', { label: item.label, links: badge })
+ : viewerCount('viewer.finder.result.focus', item.links, { label: item.label });
button.setAttribute('aria-label', action);
var name = document.createElement('strong');
@@ -11717,8 +12803,8 @@
links.textContent = badge;
links.title = context.kind === 'focus' ? badge : action;
var meta = document.createElement('small');
- meta.textContent = [item.type, item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
- meta.title = [item.type, item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.textContent = [viewerKindLabel(item.type), item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.title = [viewerKindLabel(item.type), item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
button.appendChild(name);
button.appendChild(links);
button.appendChild(meta);
@@ -11727,8 +12813,12 @@
});
empty.hidden = visibleItems.length !== 0;
status.textContent = query
- ? visibleItems.length + ' of ' + available.length + ' ' + context.availableNoun
- : available.length + ' ' + context.availableNoun;
+ ? viewerText('viewer.finder.status.filtered', {
+ visible: visibleItems.length,
+ available: available.length,
+ noun: context.availableNoun
+ })
+ : viewerText('viewer.finder.status.all', { available: available.length, noun: context.availableNoun });
}
function open(options) {
@@ -12028,7 +13118,11 @@
item.setAttribute('data-route-journey-index', String(index));
item.setAttribute('data-route-node-id', id);
item.setAttribute('tabindex', index === 0 ? '0' : '-1');
- item.setAttribute('aria-label', 'Route position ' + (index + 1) + ' of ' + ids.length + ': ' + nodeLabel(byId[id], id));
+ item.setAttribute('aria-label', viewerText('viewer.route.position', {
+ index: index + 1,
+ total: ids.length,
+ label: nodeLabel(byId[id], id)
+ }));
}
item.className = 'route-probe-node';
item.textContent = nodeLabel(byId[id], id);
@@ -12040,7 +13134,7 @@
}
function setTrigger(active) {
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Clear traced route' : 'Trace a directed route');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.route.trigger.clear' : 'viewer.guide.route.aria'));
}
function clear(options) {
options = options || {};
@@ -12057,14 +13151,14 @@
panel.hidden = true;
panel.setAttribute('data-state', 'idle');
panel.removeAttribute('data-finder-open');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick two semantic nodes on the diagram');
- status.textContent = 'Choose the source, then the destination. Direction matters.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickTwo'));
+ status.textContent = viewerText('viewer.route.instructions');
findBtn.hidden = true;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
- copyBtn.textContent = 'Copy link';
+ copyBtn.textContent = viewerText('viewer.route.copy');
if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();
setTrigger(false);
if (wasActive && options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
@@ -12195,7 +13289,10 @@
!Archify.motionGovernor.isPaused();
}
function routeOverviewStatus() {
- return activeNodeIds.length + ' nodes · ' + activeEdges.length + ' directed hop' + (activeEdges.length === 1 ? '' : 's') + ' · shortest authored route';
+ return viewerText('viewer.route.overview.status', {
+ nodes: viewerCount('viewer.route.overview.node', activeNodeIds.length),
+ hops: viewerCount('viewer.route.overview.hop', activeEdges.length)
+ });
}
function centerJourneyButton(button) {
if (!button) return;
@@ -12225,19 +13322,19 @@
journeyPlayBtn.setAttribute('aria-pressed', journeyPlaying ? 'true' : 'false');
if (journeyPlaying) {
journeyPlayIcon.textContent = '\u275a\u275a';
- journeyPlayLabel.textContent = 'Pause';
- journeyPlayBtn.setAttribute('aria-label', 'Pause route journey');
- journeyPlayBtn.title = 'Pause route journey';
+ journeyPlayLabel.textContent = viewerText('viewer.route.pause.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.pause'));
+ journeyPlayBtn.title = viewerText('viewer.route.pause');
} else if (journeyComplete || journeyIndex === activeNodeIds.length - 1) {
journeyPlayIcon.textContent = '\u21bb';
- journeyPlayLabel.textContent = 'Replay';
- journeyPlayBtn.setAttribute('aria-label', 'Replay route journey');
- journeyPlayBtn.title = canPlay ? 'Replay route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.replay.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.replay'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.replay' : 'viewer.route.motionRequired');
} else {
journeyPlayIcon.textContent = '\u25b6';
- journeyPlayLabel.textContent = 'Journey';
- journeyPlayBtn.setAttribute('aria-label', 'Play route journey');
- journeyPlayBtn.title = canPlay ? 'Play route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.journey');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.play'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.play' : 'viewer.route.motionRequired');
}
}
function journeyGeometry(shape) {
@@ -12328,8 +13425,17 @@
else button.removeAttribute('aria-current');
});
if (options.center !== false) centerJourneyButton(buttons[journeyIndex]);
- var phase = journeyPlaying ? 'Playing' : (journeyComplete ? 'Complete' : 'Inspecting');
- status.textContent = 'Step ' + (journeyIndex + 1) + ' of ' + activeNodeIds.length + ' · ' + phase + ' · ' + nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex]);
+ var phase = viewerText(journeyPlaying
+ ? 'viewer.route.phase.playing'
+ : journeyComplete
+ ? 'viewer.route.phase.complete'
+ : 'viewer.route.phase.inspecting');
+ status.textContent = viewerText('viewer.route.step', {
+ index: journeyIndex + 1,
+ total: activeNodeIds.length,
+ phase: phase,
+ label: nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex])
+ });
if (options.pulse === true && journeyIndex > 0) renderJourneyPulse(activeEdges[journeyIndex - 1]);
if (options.reveal !== false && Archify.view && typeof Archify.view.reveal === 'function') {
Archify.view.reveal(activeNodeIds.slice(Math.max(0, journeyIndex - 1), Math.min(activeNodeIds.length, journeyIndex + 2)), {
@@ -12501,15 +13607,15 @@
});
svg.setAttribute('data-route-picking', 'target');
panel.setAttribute('data-state', 'target');
- title.textContent = 'Choose a destination from ' + nodeLabel(byId[id], id);
+ title.textContent = viewerText('viewer.route.destination', { label: nodeLabel(byId[id], id) });
renderPath([id]);
var count = Math.max(0, Object.keys(reached).length - 1);
status.textContent = count
- ? count + ' directed destination' + (count === 1 ? '' : 's') + ' available. Pick a highlighted node.'
- : 'No outgoing route starts here. Clear and choose another source.';
+ ? viewerCount('viewer.route.destination.count', count)
+ : viewerText('viewer.route.noOutgoing');
findBtn.hidden = false;
- findBtn.textContent = 'Find target';
- findBtn.setAttribute('aria-label', 'Find a reachable route destination');
+ findBtn.textContent = viewerText('viewer.route.destination.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.destination.find.aria'));
requestDocking();
return true;
}
@@ -12541,7 +13647,10 @@
renderPath(result.nodes, { interactive: true });
panel.setAttribute('data-state', 'result');
panel.hidden = false;
- title.textContent = nodeLabel(byId[startId], startId) + ' to ' + nodeLabel(byId[endId], endId);
+ title.textContent = viewerText('viewer.route.result.title', {
+ source: nodeLabel(byId[startId], startId),
+ target: nodeLabel(byId[endId], endId)
+ });
findBtn.hidden = true;
copyBtn.hidden = false;
setTrigger(true);
@@ -12563,15 +13672,18 @@
if (mode !== 'target') return false;
if (id === startId) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'Choose a different destination';
- status.textContent = 'A route needs two distinct semantic nodes.';
+ title.textContent = viewerText('viewer.route.differentDestination');
+ status.textContent = viewerText('viewer.route.distinct');
return false;
}
var result = shortestDirectedPath(startId, id);
if (!result) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'No directed route to ' + nodeLabel(byId[id], id);
- status.textContent = nodeLabel(byId[id], id) + ' is not reachable from ' + nodeLabel(byId[startId], startId) + '. Pick a highlighted destination.';
+ title.textContent = viewerText('viewer.route.unreachable', { label: nodeLabel(byId[id], id) });
+ status.textContent = viewerText('viewer.route.unreachable.detail', {
+ target: nodeLabel(byId[id], id),
+ source: nodeLabel(byId[startId], startId)
+ });
return false;
}
return showResult(result, options);
@@ -12599,12 +13711,12 @@
panel.hidden = false;
panel.setAttribute('data-state', 'source');
svg.setAttribute('data-route-picking', 'source');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick a semantic node on the diagram');
- status.textContent = 'Select the source. The next step will reveal only directed destinations.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickOne'));
+ status.textContent = viewerText('viewer.route.start.instructions');
findBtn.hidden = false;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
setTrigger(true);
if (focused && nodesById()[focused]) chooseStart(focused);
@@ -12631,14 +13743,14 @@
return outgoing[id] && outgoing[id].length;
});
var sourceBadges = {};
- sourceIds.forEach(function (id) { sourceBadges[id] = 'start'; });
+ sourceIds.forEach(function (id) { sourceBadges[id] = viewerText('viewer.route.finder.source.badge'); });
return {
kind: 'route-source',
- title: 'Choose route start',
- placeholder: 'Search route sources',
- empty: 'No matching route sources',
- resultsLabel: 'Nodes that can start a route',
- availableNoun: 'route sources',
+ title: viewerText('viewer.route.finder.source.title'),
+ placeholder: viewerText('viewer.route.finder.source.placeholder'),
+ empty: viewerText('viewer.route.finder.source.empty'),
+ resultsLabel: viewerText('viewer.route.finder.source.results'),
+ availableNoun: viewerText('viewer.route.finder.source.noun'),
allowedIds: sourceIds,
badges: sourceBadges
};
@@ -12648,15 +13760,15 @@
var targetIds = Object.keys(distances).filter(function (id) { return id !== startId && byId[id]; });
var targetBadges = {};
targetIds.forEach(function (id) {
- targetBadges[id] = distances[id] + ' hop' + (distances[id] === 1 ? '' : 's');
+ targetBadges[id] = viewerCount('viewer.route.hop', distances[id]);
});
return {
kind: 'route-target',
- title: 'Destination from ' + nodeLabel(byId[startId], startId),
- placeholder: 'Search reachable destinations',
- empty: 'No matching reachable destinations',
- resultsLabel: 'Reachable route destinations',
- availableNoun: 'reachable destinations',
+ title: viewerText('viewer.route.finder.target.title', { label: nodeLabel(byId[startId], startId) }),
+ placeholder: viewerText('viewer.route.finder.target.placeholder'),
+ empty: viewerText('viewer.route.finder.target.empty'),
+ resultsLabel: viewerText('viewer.route.finder.target.results'),
+ availableNoun: viewerText('viewer.route.finder.target.noun'),
allowedIds: targetIds,
badges: targetBadges
};
@@ -12697,11 +13809,11 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- copyBtn.setAttribute('aria-label', copied ? 'Traced route link copied' : 'Could not copy traced route link');
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ copyBtn.setAttribute('aria-label', viewerText(copied ? 'viewer.route.copy.success' : 'viewer.route.copy.failed'));
window.setTimeout(function () {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to traced route');
+ copyBtn.textContent = viewerText('viewer.route.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.route.copy.aria'));
}, 1600);
return copied;
});
@@ -12854,12 +13966,6 @@
var finePointerQuery = window.matchMedia ? window.matchMedia('(hover: hover) and (pointer: fine)') : null;
var MAX_LENS_FLOW_EDGES = 24;
- function kindLabel(value) {
- return String(value || 'neutral')
- .replace(/messagebus/gi, 'message bus')
- .replace(/[-_]+/g, ' ')
- .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
- }
function nodesById() {
var byId = {};
Array.prototype.forEach.call(svg.querySelectorAll('[data-node-id][data-node-kind]'), function (node) {
@@ -12874,7 +13980,7 @@
Object.keys(byId).forEach(function (id) {
var node = byId[id];
var value = node.getAttribute('data-node-kind') || 'neutral';
- var kind = kinds[value] || (kinds[value] = { id: value, label: kindLabel(value), nodes: [] });
+ var kind = kinds[value] || (kinds[value] = { id: value, label: viewerKindLabel(value), nodes: [] });
kind.nodes.push(node);
});
return Object.keys(kinds).map(function (key) { return kinds[key]; }).sort(function (a, b) {
@@ -12978,7 +14084,7 @@
entry.setAttribute('role', 'button');
entry.setAttribute('tabindex', legendEntries.length ? '-1' : '0');
var visibleLabel = entry.getAttribute('data-legend-label') || fact.label;
- entry.setAttribute('aria-label', 'Inspect ' + visibleLabel + ', ' + count + ' node' + (count === 1 ? '' : 's'));
+ entry.setAttribute('aria-label', viewerCount('viewer.lens.legend.inspect', count, { label: visibleLabel }));
entry.setAttribute('aria-pressed', 'false');
entry.setAttribute('aria-haspopup', 'dialog');
entry.setAttribute('aria-controls', 'semantic-lens');
@@ -12987,7 +14093,7 @@
});
if (!legendEntries.length) return false;
legendBridge.setAttribute('role', legendEntries.length >= 3 ? 'toolbar' : 'group');
- legendBridge.setAttribute('aria-label', 'Semantic legend');
+ legendBridge.setAttribute('aria-label', viewerText('viewer.lens.legend'));
syncLegendBridge();
layoutLegendBridge();
try {
@@ -13135,7 +14241,7 @@
button.className = 'semantic-lens-kind';
button.setAttribute('data-kind', kind.id);
button.setAttribute('aria-pressed', selectedKinds.indexOf(kind.id) >= 0 ? 'true' : 'false');
- button.setAttribute('aria-label', kind.label + ', ' + kind.nodes.length + ' node' + (kind.nodes.length === 1 ? '' : 's'));
+ button.setAttribute('aria-label', viewerCount('viewer.lens.kind.count', kind.nodes.length, { label: kind.label }));
button.disabled = selectedKinds.length >= 2 && selectedKinds.indexOf(kind.id) === -1;
var swatch = document.createElement('span');
swatch.className = 'semantic-lens-swatch';
@@ -13161,7 +14267,7 @@
function updateTrigger() {
var active = selectedKinds.length > 0;
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Open active semantic lens' : 'Open semantic lens');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.lens.openActive' : 'viewer.lens.open'));
copyBtn.hidden = !active;
syncLegendBridge();
}
@@ -13172,7 +14278,7 @@
}
function dockPanel(byId) {
panel.removeAttribute('data-dock-side');
- if (panel.hidden || !selectedKinds.length || window.innerWidth <= 720) return 'right';
+ if (panel.hidden || window.innerWidth <= 720) return 'right';
var panelRect = panel.getBoundingClientRect();
var containerRect = container.getBoundingClientRect();
if (!panelRect.width || !panelRect.height) return 'right';
@@ -13185,6 +14291,17 @@
var rightCandidate = { left: containerRect.right - 16 - width, right: containerRect.right - 16, top: top, bottom: panelRect.bottom };
var leftScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(leftCandidate, rect); }, 0);
var rightScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(rightCandidate, rect); }, 0);
+ var legend = svg.querySelector('[data-legend]');
+ var nav = container.querySelector('.diagram-nav');
+ var protectedRects = [legend, nav].filter(function (element) {
+ return element && !element.hidden && window.getComputedStyle(element).display !== 'none';
+ }).map(function (element) { return element.getBoundingClientRect(); });
+ leftScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(leftCandidate, rect) * 1000;
+ }, 0);
+ rightScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(rightCandidate, rect) * 1000;
+ }, 0);
var side = leftScore < rightScore ? 'left' : 'right';
panel.setAttribute('data-dock-side', side);
return side;
@@ -13196,7 +14313,7 @@
var nodeKind = {};
Object.keys(byId).forEach(function (id) { nodeKind[id] = byId[id].getAttribute('data-node-kind') || 'neutral'; });
if (!selectedKinds.length) {
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
updateTrigger();
renderKinds();
dockPanel(byId);
@@ -13251,13 +14368,18 @@
renderFlowOverlay(matchedFlow);
if (crossKind) {
var total = forward + reverse;
- status.textContent = kindLabel(selectedKinds[0]) + ' → ' + kindLabel(selectedKinds[1]) + ': ' + forward + ' · ' +
- kindLabel(selectedKinds[1]) + ' → ' + kindLabel(selectedKinds[0]) + ': ' + reverse + ' · ' +
- total + ' direct relationship' + (total === 1 ? '' : 's');
+ status.textContent = viewerCount('viewer.lens.compare', total, {
+ first: viewerKindLabel(selectedKinds[0]),
+ second: viewerKindLabel(selectedKinds[1]),
+ forward: forward,
+ reverse: reverse
+ });
} else {
var nodeCount = collectKinds().filter(function (kind) { return kind.id === selectedKinds[0]; })[0].nodes.length;
- status.textContent = nodeCount + ' ' + kindLabel(selectedKinds[0]) + ' node' + (nodeCount === 1 ? '' : 's') + ' · ' +
- touching + ' touching relationship' + (touching === 1 ? '' : 's') + ' · connected peers remain visible';
+ status.textContent = viewerText('viewer.lens.single', {
+ nodes: viewerCount('viewer.lens.node', nodeCount, { label: viewerKindLabel(selectedKinds[0]) }),
+ relationships: viewerCount('viewer.lens.relationship', touching)
+ });
}
updateTrigger();
renderKinds();
@@ -13330,7 +14452,7 @@
panel.removeAttribute('data-dock-side');
updateTrigger();
renderKinds();
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
if (options.updateUrl !== false) updateHash();
if (options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
Archify.view.reset({ automatic: true });
@@ -13358,8 +14480,8 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- window.setTimeout(function () { copyBtn.textContent = 'Copy link'; }, 1600);
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ window.setTimeout(function () { copyBtn.textContent = viewerText('viewer.common.copyLink'); }, 1600);
return copied;
});
}
@@ -13531,14 +14653,16 @@
var nodes = svg.querySelectorAll('[data-node-id]').length;
var relationships = relationshipCount();
var views = viewCount();
- stats.textContent = nodes + ' semantic node' + (nodes === 1 ? '' : 's') + ' · ' +
- relationships + ' relationship' + (relationships === 1 ? '' : 's') + ' · ' +
- views + ' guided view' + (views === 1 ? '' : 's');
+ stats.textContent = viewerText('viewer.guide.facts', {
+ nodes: viewerCount('viewer.guide.fact.node', nodes),
+ relationships: viewerCount('viewer.guide.fact.relationship', relationships),
+ views: viewerCount('viewer.guide.fact.view', views)
+ });
storyBtn.disabled = views === 0;
storyBtn.setAttribute('aria-disabled', views === 0 ? 'true' : 'false');
storyCopy.textContent = views
- ? 'Walk ' + views + ' authored chapter' + (views === 1 ? '' : 's') + ' and their real relationships.'
- : 'No authored guided story in this diagram.';
+ ? viewerCount('viewer.guide.story.available', views)
+ : viewerText('viewer.guide.story.unavailable');
}
function actionButtons() {
return Array.prototype.slice.call(actions.querySelectorAll('.diagram-guide-action:not(:disabled)'));
@@ -13549,7 +14673,7 @@
html.removeAttribute('data-guide-open');
routePanel.removeAttribute('data-guide-open');
trigger.setAttribute('aria-expanded', 'false');
- trigger.setAttribute('aria-label', 'Open diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.open'));
feedback.textContent = '';
if (options.restoreFocus !== false) trigger.focus();
return false;
@@ -13572,7 +14696,7 @@
html.setAttribute('data-guide-open', 'true');
routePanel.setAttribute('data-guide-open', 'true');
trigger.setAttribute('aria-expanded', 'true');
- trigger.setAttribute('aria-label', 'Close diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.close'));
feedback.textContent = '';
requestAnimationFrame(function () {
var first = actionButtons()[0];
@@ -13584,7 +14708,7 @@
function execute(action) {
feedback.textContent = '';
if (action === 'story' && !viewCount()) {
- feedback.textContent = 'This diagram has no authored guided story.';
+ feedback.textContent = viewerText('viewer.guide.noStory');
return false;
}
close({ restoreFocus: false });
diff --git a/examples/rag-pipeline.html b/examples/rag-pipeline.html
index c1b174f1..376aabe6 100644
--- a/examples/rag-pipeline.html
+++ b/examples/rag-pipeline.html
@@ -3,7 +3,7 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="generator" content="archify 2.15.0">
+ <meta name="generator" content="archify 2.16.0-dev.0">
<title>RAG Pipeline Diagram</title>
<script>
// Resolve the theme before first paint so light-preference users don't
@@ -586,10 +586,13 @@
justify-content: center;
min-height: 0;
padding: 0.75rem;
+ padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -655,7 +658,7 @@
}
html[data-preset="signal-flow"] .header-row::after {
- content: "SIGNAL FLOW";
+ content: attr(data-preset-badge-signal-flow);
margin-left: auto;
color: var(--frontend-stroke);
border: 1px solid var(--frontend-stroke);
@@ -679,7 +682,7 @@
animation: none;
}
html[data-preset="blueprint"] .header-row::after {
- content: "BLUEPRINT / REV 01";
+ content: attr(data-preset-badge-blueprint);
margin-left: auto;
padding: 0.28rem 0.55rem;
border-top: 1px solid var(--frontend-stroke);
@@ -708,7 +711,7 @@
animation: none;
}
html[data-preset="editorial"] .header-row::after {
- content: "EDITORIAL / FIELD NOTE";
+ content: attr(data-preset-badge-editorial);
margin-left: auto;
padding: 0.32rem 0 0.24rem;
border-bottom: 2px solid var(--arrow-emphasis);
@@ -722,10 +725,12 @@
}
.diagram-container {
+ --archify-nav-reserve: 0px;
background: var(--panel);
border-radius: 1rem;
border: 1px solid var(--panel-border);
padding: 1.5rem;
+ padding-bottom: calc(1.5rem + var(--archify-nav-reserve));
overflow: hidden;
position: relative;
}
@@ -785,7 +790,7 @@
border: 1px solid var(--panel-border);
background: var(--panel);
color: var(--arrow-emphasis);
- content: "ARCHIFY / PLATE 04";
+ content: attr(data-preset-badge-editorial-plate);
font-family: Georgia, 'Times New Roman', serif;
font-size: 0.52rem;
font-style: italic;
@@ -1052,7 +1057,7 @@
.overview-map {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 12;
width: 11.25rem;
overflow: hidden;
@@ -1085,6 +1090,36 @@
padding: 0.42rem 0.48rem 0.38rem 0.55rem;
border-bottom: 1px solid var(--toolbar-border);
background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);
+ cursor: grab;
+ touch-action: none;
+ user-select: none;
+ }
+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }
+ .overview-map[data-placement-invalid="true"] {
+ border-color: var(--security-stroke);
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);
+ }
+ .overview-map[data-compact="true"] {
+ width: 7.4rem;
+ }
+ .overview-map[data-compact="true"] .overview-map-head {
+ grid-template-columns: minmax(0, 1fr) auto;
+ gap: 0.24rem;
+ min-height: 1.5rem;
+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;
+ border-bottom: 0;
+ }
+ .overview-map[data-compact="true"] .overview-map-live,
+ .overview-map[data-compact="true"] .overview-map-copy,
+ .overview-map[data-compact="true"] .overview-map-surface,
+ .overview-map[data-compact="true"] .overview-map-hint {
+ display: none;
+ }
+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }
+ .overview-map[data-compact="true"] .overview-map-close {
+ width: 1.15rem;
+ height: 1.15rem;
+ font-size: 0.72rem;
}
.overview-map-live {
width: 0.42rem;
@@ -1115,6 +1150,26 @@
white-space: nowrap;
text-overflow: ellipsis;
}
+ .overview-map-expand {
+ display: none;
+ align-items: center;
+ justify-content: center;
+ min-width: 0;
+ height: 1.2rem;
+ padding: 0 0.34rem;
+ overflow: hidden;
+ border: 0;
+ border-radius: 0.3rem;
+ background: transparent;
+ color: var(--frontend-stroke);
+ font: inherit;
+ font-size: 0.49rem;
+ font-weight: 700;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ white-space: nowrap;
+ cursor: pointer;
+ }
.overview-map-close {
width: 1.55rem;
height: 1.55rem;
@@ -1127,8 +1182,11 @@
font-size: 0.9rem;
cursor: pointer;
}
+ .overview-map-expand:hover,
+ .overview-map-expand:focus-visible,
.overview-map-close:hover,
.overview-map-close:focus-visible { background: var(--toolbar-hover); }
+ .overview-map-expand:focus-visible,
.overview-map-close:focus-visible,
.overview-map-surface:focus-visible,
.overview-map-node:focus-visible {
@@ -1210,6 +1268,24 @@
color: var(--frontend-stroke);
background: var(--toolbar-hover);
}
+ .overview-map-feedback {
+ position: absolute;
+ right: 1rem;
+ bottom: 4.15rem;
+ z-index: 13;
+ max-width: min(16rem, calc(100% - 2rem));
+ padding: 0.38rem 0.55rem;
+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));
+ border-radius: 0.5rem;
+ background: var(--toolbar-menu-bg);
+ color: var(--toolbar-text);
+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+ font-size: 0.52rem;
+ line-height: 1.35;
+ pointer-events: none;
+ }
+ .overview-map-feedback[hidden] { display: none; }
+ .focus-chip[data-radar-yielded="true"] { display: none !important; }
.diagram-nav #btn-route-probe[aria-pressed="true"] {
color: var(--backend-stroke);
background: var(--toolbar-hover);
@@ -1226,7 +1302,7 @@
.semantic-lens {
position: absolute;
right: 1rem;
- bottom: 4.15rem;
+ bottom: calc(4.15rem + var(--archify-nav-reserve));
z-index: 24;
width: min(20rem, calc(100% - 2rem));
overflow: hidden;
@@ -1401,7 +1477,7 @@
.route-probe {
position: absolute;
left: 1rem;
- bottom: 1rem;
+ bottom: calc(1rem + var(--archify-nav-reserve));
z-index: 12;
width: min(46rem, calc(100% - 25rem));
min-width: 18rem;
@@ -2800,13 +2876,22 @@
scrolling at 900–1080px heights. */
@media (min-width: 768px) and (max-height: 1100px) {
.header { margin-bottom: 1rem; }
- .diagram-container { padding: 0.875rem; }
+ .diagram-container {
+ padding: 0.875rem;
+ padding-bottom: calc(0.875rem + var(--archify-nav-reserve));
+ }
.cards { margin-top: 1rem; }
.card { padding: 1rem; }
}
@media (min-width: 768px) and (max-height: 920px) {
+ body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -2921,6 +3006,7 @@
svg[data-chapter-preview] [data-node-id],
svg[data-chapter-preview] [data-edge-from] { opacity: 1 !important; filter: none !important; }
.diagram-container, .card { box-shadow: none; border-color: #e2e8f0; }
+ .diagram-container { --archify-nav-reserve: 0px !important; }
html[data-preset="signal-flow"] .diagram-container,
html[data-preset="signal-flow"] .card { background: #ffffff; }
.cards { grid-template-columns: 1fr 1fr; }
@@ -3572,16 +3658,17 @@
width: min(10.25rem, calc(100% - 1rem));
}
.overview-map[data-docked="true"] {
- right: 0.5rem;
+ right: var(--archify-radar-right, 0.5rem);
top: var(--archify-radar-top, 0.5rem);
bottom: auto;
transform: none !important;
}
.overview-map[data-docked="true"][data-dock-side="left"] {
right: auto;
- left: 0.5rem;
+ left: var(--archify-radar-left, 0.5rem);
}
.overview-map-surface { height: 4rem; }
+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }
.semantic-lens {
right: 0.5rem;
bottom: 3.7rem;
@@ -4863,7 +4950,10 @@
<div class="container">
<!-- Header -->
<div class="header">
- <div class="header-row">
+ <div class="header-row"
+ data-preset-badge-signal-flow="SIGNAL FLOW"
+ data-preset-badge-blueprint="BLUEPRINT / REV 01"
+ data-preset-badge-editorial="EDITORIAL / FIELD NOTE">
<div class="pulse-dot"></div>
<h1>RAG Pipeline</h1>
</div>
@@ -4871,6 +4961,7 @@
<script id="archify-guided-views-data" type="application/json">[{"id":"query-path","label":"Query path","focus":["user","guardrail","orchestrator","retriever","vectordb","reranker","llm"],"note":"Follow a user question from input through safety filtering, retrieval, and generation to grounded answer."},{"id":"ingestion","label":"Document ingestion","focus":["sources","loader","chunker","embedder","vectordb"],"note":"How raw documents become searchable vector embeddings."},{"id":"safety-and-cache","label":"Safety and cache","focus":["user","guardrail","orchestrator","cache","llm"],"note":"The guardrail intercepts harmful queries before they reach the orchestrator; the semantic cache avoids redundant LLM calls."}]</script>
+ <script id="archify-i18n-data" type="application/json">{"locale":"en","messages":{"viewer.kind.frontend":"Frontend","viewer.kind.backend":"Backend","viewer.kind.database":"Database","viewer.kind.cloud":"Cloud","viewer.kind.security":"Security","viewer.kind.messagebus":"Message bus","viewer.kind.external":"External","viewer.kind.neutral":"Neutral","viewer.kind.node":"Node","viewer.kind.start":"Start","viewer.kind.active":"Active","viewer.kind.waiting":"Waiting","viewer.kind.decision":"Decision","viewer.kind.success":"Success","viewer.kind.failure":"Failure","viewer.toolbar.actions":"Diagram actions","viewer.theme.toggle.title":"Toggle theme (T)","viewer.theme.toggle":"Toggle color theme","viewer.theme.dark":"Dark","viewer.theme.light":"Light","viewer.preset.choose.title":"Choose visual style (S cycles)","viewer.preset.choose":"Choose visual style","viewer.preset.style":"Style","viewer.preset.menu":"Visual style","viewer.preset.identity":"Visual identity","viewer.preset.cycles":"S cycles","viewer.preset.classic":"Classic","viewer.preset.classic.short":"Classic","viewer.preset.classic.hint":"Stable technical default","viewer.preset.flow":"Signal Flow","viewer.preset.flow.short":"Flow","viewer.preset.flow.hint":"Motion-forward presentation","viewer.preset.blueprint":"Blueprint","viewer.preset.blueprint.hint":"Engineering review","viewer.preset.editorial":"Editorial","viewer.preset.editorial.hint":"Publication and launch notes","viewer.preset.badge.signalFlow":"SIGNAL FLOW","viewer.preset.badge.blueprint":"BLUEPRINT / REV 01","viewer.preset.badge.editorial":"EDITORIAL / FIELD NOTE","viewer.preset.badge.editorialPlate":"ARCHIFY / PLATE 04","viewer.preset.current":"Visual style: {style}. Choose visual style","viewer.motion.live":"Live","viewer.motion.still":"Still","viewer.motion.pause":"Pause motion","viewer.motion.resume":"Resume motion","viewer.motion.reduced":"Motion paused by reduced-motion preference","viewer.motion.hidden":"Motion paused while this page is hidden","viewer.motion.yielding":"Pause motion; currently yielding to {owner}","viewer.motion.yielding.title":"Live preview enabled · yielding to {owner}","viewer.owner.story":"the guided story","viewer.owner.chapter":"the active chapter","viewer.owner.chapterPreview":"the chapter delta preview","viewer.owner.handoff":"the chapter handoff","viewer.owner.route":"Route Probe","viewer.owner.lens":"Semantic Lens","viewer.owner.relationship":"Relationship Preview","viewer.owner.intent":"Intent Trace","viewer.owner.focus":"semantic focus","viewer.owner.legend":"legend preview","viewer.owner.reader":"reader interaction","viewer.present.enter":"Enter presentation stage","viewer.present.enter.title":"Presentation stage (F)","viewer.present.exit":"Exit presentation stage","viewer.present.exit.title":"Exit presentation stage (F or Escape)","viewer.present.present":"Present","viewer.present.exit.label":"Exit","viewer.export.button":"Export","viewer.export.button.title":"Export diagram (E)","viewer.export.diagram":"Export diagram","viewer.export.menu":"Export","viewer.export.subtitle":"Portable, clean outputs","viewer.export.share":"Share","viewer.export.shareCard":"Share Card","viewer.export.routeShareCard":"Route Share Card","viewer.export.reachShareCard":"Reach Share Card","viewer.export.copyShareCard":"Copy Share Card","viewer.export.copyDiagram":"Copy diagram","viewer.export.clipboardPng":"PNG to clipboard","viewer.export.raster":"Raster images","viewer.export.image":"Image","viewer.export.lossless":"Lossless image","viewer.export.compact":"Compact image","viewer.export.modern":"Modern image","viewer.export.vectorMotion":"Vector and motion","viewer.export.vectorMotion.heading":"Vector \u0026 motion","viewer.export.editable":"Editable vector","viewer.export.motion6s":"6s motion","viewer.export.unsupported":"Not supported by this browser","viewer.export.clipboardUnsupported":"Clipboard image write not supported by this browser","viewer.export.clipboardUnsupported.period":"Clipboard image write not supported by this browser.","viewer.export.clipboardUnsupported.short":"Clipboard image write not supported in this browser.","viewer.export.motionUnavailable":"Motion capture unavailable in this browser","viewer.export.webmUnavailable":"WebM unavailable in this browser","viewer.export.failed":"Export failed: {message}","viewer.export.unknownVariant":"Unknown Share Card variant: {variant}","viewer.export.routeRequired":"Trace a route before exporting a Route Share Card","viewer.export.reachRequired":"Trace authored reach before exporting a Reach Share Card","viewer.export.unknown":"unknown","viewer.export.routeFailed":"Route Share Card export failed: {message}","viewer.export.reachFailed":"Reach Share Card export failed: {message}","viewer.export.copyFailed":"Copy failed: {message}","viewer.export.copiedPng":"Copied PNG to clipboard","viewer.export.copiedShare":"Copied Share Card","viewer.export.downloadedShare":"Downloaded Share Card","viewer.export.downloadedRoute":"Downloaded Route Share Card","viewer.export.downloadedReach":"Downloaded Reach Share Card","viewer.export.downloadedWebm":"Downloaded WebM","viewer.export.recording":"Recording 6 seconds of motion…","viewer.export.card.routeSummary.one":"Route: {source} → {target} · {count} directed hop","viewer.export.card.routeSummary.other":"Route: {source} → {target} · {count} directed hops","viewer.export.card.reachSummary":"Authored {direction} from {origin} · {nodes} · {links} · max {hops}","viewer.export.card.node.one":"{count} node","viewer.export.card.node.other":"{count} nodes","viewer.export.card.link.one":"{count} link","viewer.export.card.link.other":"{count} links","viewer.export.card.hop.one":"{count} hop","viewer.export.card.hop.other":"{count} hops","viewer.export.card.routeBadge":"ARCHIFY · ROUTE · {hops}","viewer.export.card.reachBadge":"ARCHIFY · {direction} REACH","viewer.export.card.defaultBadge":"ARCHIFY · {preset} · {theme}","viewer.export.direction.upstream":"Upstream","viewer.export.direction.downstream":"Downstream","viewer.export.error.canvasUnavailable":"Canvas unavailable for {label}","viewer.export.error.contextUnavailable":"2D canvas context unavailable for {label}","viewer.export.error.toBlobUnavailable":"canvas.toBlob unavailable for {label}","viewer.export.error.toBlobNull":"canvas.toBlob returned no data for {label}","viewer.export.error.variantsCombined":"Share Card variants cannot be combined","viewer.export.error.viewerState":"Share Card export could not remove temporary viewer state","viewer.export.error.routeState":"Route Card export could not preserve the resolved route safely","viewer.export.error.reachState":"Reach Card export could not preserve authored reach safely","viewer.export.error.webmRequirements":"WebM motion export requires a trace animation and browser MediaRecorder support","viewer.export.error.mediaRecorder":"MediaRecorder failed","viewer.export.error.emptyWebm":"MediaRecorder produced an empty WebM","viewer.export.error.webmBackground":"SVG background could not be loaded for WebM export","viewer.guided.region":"Guided diagram views","viewer.guided.previous":"Previous guided view","viewer.guided.previous.title":"Previous guided view ([)","viewer.guided.next":"Next guided view","viewer.guided.next.title":"Next guided view (])","viewer.guided.views":"Guided views","viewer.guided.explore":"Explore this system","viewer.guided.intro":"Step through curated paths without changing the source diagram.","viewer.guided.trail":"Story trail","viewer.guided.beat":"Beat","viewer.guided.nextBeat":"Next","viewer.guided.play":"Play guided story","viewer.guided.play.title":"Play guided story (P)","viewer.guided.pause":"Pause guided story","viewer.guided.pause.title":"Pause guided story (P)","viewer.guided.replay":"Replay guided story","viewer.guided.replay.title":"Replay guided story (P)","viewer.guided.playStory":"Play story","viewer.guided.pauseStory":"Pause","viewer.guided.replayStory":"Replay story","viewer.guided.motionUnavailable":"Story playback unavailable while motion is Still","viewer.guided.enableMotion":"Switch motion to Live to play the guided story","viewer.guided.selectBeatLink":"Select a Story Beat to copy its exact link","viewer.guided.copyMoment":"Copy moment","viewer.guided.momentCopied":"Moment link copied","viewer.guided.momentCopyFailed":"Could not copy story moment link","viewer.guided.copied":"Copied","viewer.guided.copyFailed":"Copy failed","viewer.guided.showAll":"Show all","viewer.guided.showAll.aria":"Show entire diagram","viewer.guided.chapters":"Story chapters","viewer.guided.storyTrail":"Story trail for {label}: {count} beats","viewer.guided.chapter.open":"Open chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.current":"Current chapter {index} of {total}: {label}, {count} stops","viewer.guided.chapter.selectedNodes":"{count} selected nodes","viewer.guided.chapter.stops":"{count} stops","viewer.guided.chapter.stop.one":"{count} stop","viewer.guided.chapter.stop.other":"{count} stops","viewer.guided.chapter.current.title":"{label} — current chapter, {count} stops","viewer.guided.chapter.delta.expanded":"{stay} stay, {enter} enter, {leave} leave","viewer.guided.chapter.delta.aria":"Open chapter {index} of {total}: {label}. Chapter focus delta: {delta}","viewer.guided.chapter.delta.title":"{label} — {delta} chapter focus","viewer.guided.handoff":"{from} → {to} · via {label}","viewer.guided.share.chapter":"Chapter {index} / {total}","viewer.guided.share.initial":"Chapter 01 / 01","viewer.guided.share.default":"Guided chapter","viewer.guided.state.ready":"Ready","viewer.guided.state.playing":"Playing","viewer.guided.state.settled":"Settled","viewer.guided.state.paused":"Paused","viewer.guided.state.pinned":"Pinned","viewer.guided.state.still":"Still","viewer.guided.share.step":"Step {index} / {total} · {label}","viewer.guided.share.staticMoment":"{step} · Static moment","viewer.guided.share.complete":"{count} steps complete · {note}","viewer.guided.share.settled":"Path settled for reading.","viewer.guided.share.staticPath":"{count} steps · Static path","viewer.guided.share.ready":"{count} steps · Ready","viewer.guided.share.aria":"{state} chapter {index} of {total}: {label}. {beat}. {route}","viewer.guided.beat.start":"Beat {index} / {total} · {label} · starting point","viewer.guided.beat.forward":"Beat {index} / {total} · {from} → {to}","viewer.guided.beat.reverse":"Beat {index} / {total} · {from} → {to} · reverse authored link","viewer.guided.beat.multiple":"Beat {index} / {total} · {from} ⇄ {to} · {count} authored links","viewer.guided.beat.group":"Beat {index} / {total} · {from} · {to} · grouped · no direct link","viewer.guided.beat.aria.prefix":"Story beat {index} of {total}: {label}. ","viewer.guided.beat.aria.start":"Starting point.","viewer.guided.beat.aria.forward":"From {from} through one authored forward relationship.","viewer.guided.beat.aria.reverse":"From {from}; the authored relationship points from {to} to {from}.","viewer.guided.beat.aria.multiple":"From {from} through {count} authored relationships; shown without arbitrary motion.","viewer.guided.beat.aria.group":"Grouped from {from} with no direct authored relationship.","viewer.guided.caption.start":"Starting point","viewer.guided.caption.grouped":"Grouped transition · no direct authored link","viewer.guided.caption.more":" +{count} more","viewer.guided.caption.reverse":"Reverse authored relationship","viewer.guided.caption.relationships":"{count} authored relationships","viewer.guided.caption.relationship":"Authored relationship","viewer.guided.caption.direction":"authored direction: {from} → {to}","viewer.guided.caption.starting":"Authored starting point","viewer.guided.beatLink":"Copy link to current story moment: Beat {index} of {total}: {label}","viewer.guided.noStory":"This diagram has no authored guided story.","viewer.guide.eyebrow":"Diagram guide","viewer.guide.close":"Close diagram guide","viewer.guide.inspecting":"Inspecting compiled semantics","viewer.guide.actions":"Diagram exploration actions","viewer.guide.find":"Find any node","viewer.guide.find.hint":"Search labels, responsibilities, kinds, and stable IDs.","viewer.guide.route":"Trace a route","viewer.guide.route.aria":"Trace a directed route","viewer.guide.route.hint":"Ask how two semantic nodes connect in authored direction.","viewer.guide.map":"See the whole system","viewer.guide.map.hint":"Open Semantic Radar with a live viewport and stable nodes.","viewer.guide.lens":"Compare semantic kinds","viewer.guide.lens.hint":"Count roles, reveal their traffic, and compare direct authored links.","viewer.guide.story":"Play the guided story","viewer.guide.story.hint":"Walk the authored chapters and real relationships.","viewer.guide.present":"Enter Presentation Stage","viewer.guide.present.hint":"Give the live diagram the viewport without changing export.","viewer.guide.shortcuts":"Additional keyboard shortcuts","viewer.guide.shortcut.export":"Export","viewer.guide.shortcut.theme":"Theme","viewer.guide.shortcut.style":"Style","viewer.guide.shortcut.reset":"Reset","viewer.guide.shortcut.zoomIn":"Zoom in","viewer.guide.shortcut.zoomOut":"Zoom out","viewer.guide.shortcut.close":"Close","viewer.guide.facts":"{nodes} · {relationships} · {views}","viewer.guide.fact.node.one":"{count} semantic node","viewer.guide.fact.node.other":"{count} semantic nodes","viewer.guide.fact.relationship.one":"{count} relationship","viewer.guide.fact.relationship.other":"{count} relationships","viewer.guide.fact.view.one":"{count} guided view","viewer.guide.fact.view.other":"{count} guided views","viewer.guide.story.available.one":"Walk {count} authored chapter and its real relationships.","viewer.guide.story.available.other":"Walk {count} authored chapters and their real relationships.","viewer.guide.story.unavailable":"No authored guided story in this diagram.","viewer.guide.open":"Open diagram guide","viewer.guide.noStory":"This diagram has no authored guided story.","viewer.finder.title":"Find a node","viewer.finder.close":"Close node finder","viewer.finder.placeholder":"Search labels or IDs","viewer.finder.search":"Search diagram nodes","viewer.finder.results":"Diagram nodes","viewer.finder.empty":"No matching nodes","viewer.finder.result.focus":"Focus {label}","viewer.finder.result.routeStart":"Choose {label} as route start","viewer.finder.result.routeTarget":"Choose {label} as route destination, {links}","viewer.finder.status.empty":"No matching nodes","viewer.finder.status.count.one":"{count} matching node","viewer.finder.status.count.other":"{count} matching nodes","viewer.finder.noun.nodes":"nodes","viewer.finder.link.one":"{count} link","viewer.finder.link.other":"{count} links","viewer.finder.result.focus.one":"Focus {label}, {count} related connection","viewer.finder.result.focus.other":"Focus {label}, {count} related connections","viewer.finder.status.filtered":"{visible} of {available} {noun}","viewer.finder.status.all":"{available} {noun}","viewer.passport.eyebrow":"Semantic passport","viewer.passport.metadata":"Node metadata","viewer.passport.evidence":"Verified source evidence","viewer.passport.verified":"Verified source","viewer.passport.reach":"Authored reach","viewer.passport.reach.trace":"Trace authored reachability","viewer.passport.upstream":"Upstream","viewer.passport.downstream":"Downstream","viewer.passport.upstream.trace":"Trace upstream authored reachability","viewer.passport.downstream.trace":"Trace downstream authored reachability","viewer.passport.close":"Close semantic passport","viewer.passport.copy":"Copy link","viewer.passport.copy.focus":"Copy link to focused node","viewer.passport.relations":"Relations","viewer.passport.relations.show":"Show connected relationships","viewer.passport.relations.hide":"Hide connected relationships","viewer.passport.relations.list":"Connected relationships","viewer.passport.copyRelation":"Copy relation","viewer.passport.copyNode":"Copy node","viewer.passport.copyPinned":"Copy link to pinned relationship","viewer.passport.copySource":"Copy link to source node","viewer.passport.copy.focused.success":"Focused node link copied","viewer.passport.copy.pinned.success":"Pinned relationship link copied","viewer.passport.copy.focused.failed":"Could not copy focused node link","viewer.passport.copy.pinned.failed":"Could not copy pinned relationship link","viewer.passport.relationship.none":"No connected relationships","viewer.passport.relationship.count.one":"{count} relation","viewer.passport.relationship.count.other":"{count} relations","viewer.passport.relationship.show.one":"Show {count} connected relationship","viewer.passport.relationship.show.other":"Show {count} connected relationships","viewer.passport.relationship.summary":"{out} outgoing · {in} incoming{loops}","viewer.passport.relationship.loops":" · {count} loop","viewer.passport.relationship.explorer":"Direct relationship explorer","viewer.passport.relationship.help":"Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.","viewer.passport.relationship.loopsBack":"loops back","viewer.passport.relationship.connectsTo":"connects to","viewer.passport.relationship.connectsFrom":"connects from","viewer.passport.relationship.pinned":"Pinned relationship · {from} → {to} · {label}","viewer.passport.relationship.inspect":"Inspect relationship {index} of {total}: {from} to {to}, {label}. Press Enter for details.","viewer.passport.relationship.group.out":"Outgoing","viewer.passport.relationship.group.in":"Incoming","viewer.passport.relationship.group.loop":"Self loops","viewer.passport.relationship.row":"{group}: {relationship}, {neighbor}","viewer.passport.relationship.direction.out":"OUT →","viewer.passport.relationship.direction.in":"← IN","viewer.passport.relationship.direction.loop":"LOOP","viewer.passport.sourceCount.one":"{count} verified source reference","viewer.passport.sourceCount.other":"{count} verified source references","viewer.passport.sourceMarker":"SRC","viewer.passport.beacon.one":"{count} verified source; focus this node to inspect","viewer.passport.beacon.other":"{count} verified sources; focus this node to inspect","viewer.passport.repository.open":"Open verified repository revision {revision}","viewer.passport.source.open":"Open verified source {path} at revision {revision}","viewer.passport.source.openLink":"Open ↗","viewer.passport.reach.upstream.one":"Trace {count} upstream authored node","viewer.passport.reach.upstream.other":"Trace {count} upstream authored nodes","viewer.passport.reach.downstream.one":"Trace {count} downstream authored node","viewer.passport.reach.downstream.other":"Trace {count} downstream authored nodes","viewer.passport.reach.noUpstream":"No upstream authored nodes","viewer.passport.reach.noDownstream":"No downstream authored nodes","viewer.passport.reach.status":"{direction} · {nodes} nodes · {links} links · max {hops} hops","viewer.route.eyebrow":"Route probe","viewer.route.start":"Choose a start node","viewer.route.start.find":"Find start","viewer.route.start.find.aria":"Find a route start","viewer.route.copy":"Copy link","viewer.route.copy.aria":"Copy link to traced route","viewer.route.clear":"Clear","viewer.route.clear.aria":"Clear route probe","viewer.route.traced":"Traced route","viewer.route.pickTwo":"Pick two semantic nodes on the diagram","viewer.route.pickOne":"Pick a semantic node on the diagram","viewer.route.controls":"Route journey controls","viewer.route.previous":"Previous route position","viewer.route.play":"Play route journey","viewer.route.pause":"Pause route journey","viewer.route.replay":"Replay route journey","viewer.route.next":"Next route position","viewer.route.journey":"Journey","viewer.route.pause.label":"Pause","viewer.route.replay.label":"Replay","viewer.route.overview":"Overview","viewer.route.overview.aria":"Show complete route overview","viewer.route.instructions":"Choose the source, then the destination. Direction matters.","viewer.route.destination":"Choose a destination from {label}","viewer.route.destination.find":"Find target","viewer.route.destination.find.aria":"Find a reachable route destination","viewer.route.differentDestination":"Choose a different destination","viewer.route.distinct":"A route needs two distinct semantic nodes.","viewer.route.unreachable":"No directed route to {label}","viewer.route.unreachable.detail":"{target} is not reachable from {source}. Pick a highlighted destination.","viewer.route.start.instructions":"Select the source. The next step will reveal only directed destinations.","viewer.route.copy.success":"Traced route link copied","viewer.route.copy.failed":"Could not copy traced route link","viewer.route.position":"Route position {index} of {total}: {label}","viewer.route.step":"Step {index} of {total} · {phase} · {label}","viewer.route.motionRequired":"Automatic journey requires Live motion","viewer.route.trigger.clear":"Clear traced route","viewer.route.overview.status":"{nodes} · {hops} · shortest authored route","viewer.route.overview.node.one":"{count} node","viewer.route.overview.node.other":"{count} nodes","viewer.route.overview.hop.one":"{count} directed hop","viewer.route.overview.hop.other":"{count} directed hops","viewer.route.phase.playing":"Playing","viewer.route.phase.complete":"Complete","viewer.route.phase.inspecting":"Inspecting","viewer.route.destination.count.one":"{count} directed destination available. Pick a highlighted node.","viewer.route.destination.count.other":"{count} directed destinations available. Pick a highlighted node.","viewer.route.noOutgoing":"No outgoing route starts here. Clear and choose another source.","viewer.route.result.title":"{source} to {target}","viewer.route.finder.source.title":"Choose route start","viewer.route.finder.source.placeholder":"Search route sources","viewer.route.finder.source.empty":"No matching route sources","viewer.route.finder.source.results":"Nodes that can start a route","viewer.route.finder.source.noun":"route sources","viewer.route.finder.source.badge":"start","viewer.route.finder.target.title":"Destination from {label}","viewer.route.finder.target.placeholder":"Search reachable destinations","viewer.route.finder.target.empty":"No matching reachable destinations","viewer.route.finder.target.results":"Reachable route destinations","viewer.route.finder.target.noun":"reachable destinations","viewer.route.hop.one":"{count} hop","viewer.route.hop.other":"{count} hops","viewer.lens.eyebrow":"Semantic lens","viewer.lens.title":"Compare system roles","viewer.lens.close":"Close semantic lens","viewer.lens.instruction":"Choose up to two semantic kinds. One reveals its real traffic; two compare only direct authored relationships.","viewer.lens.kinds":"Semantic kinds","viewer.lens.choose":"Choose a kind to inspect its nodes and touching relationships.","viewer.lens.copy":"Copy link to semantic lens","viewer.lens.clear":"Clear semantic lens","viewer.lens.open":"Open semantic lens","viewer.lens.openActive":"Open active semantic lens","viewer.lens.legend":"Semantic legend","viewer.lens.legend.inspect.one":"Inspect {label}, {count} node","viewer.lens.legend.inspect.other":"Inspect {label}, {count} nodes","viewer.lens.kind.count.one":"{label}, {count} node","viewer.lens.kind.count.other":"{label}, {count} nodes","viewer.lens.compare.one":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationship","viewer.lens.compare.other":"{first} → {second}: {forward} · {second} → {first}: {reverse} · {count} direct relationships","viewer.lens.single":"{nodes} · {relationships} · connected peers remain visible","viewer.lens.node.one":"{count} {label} node","viewer.lens.node.other":"{count} {label} nodes","viewer.lens.relationship.one":"{count} touching relationship","viewer.lens.relationship.other":"{count} touching relationships","viewer.radar.title":"Semantic radar","viewer.radar.building":"Building overview","viewer.radar.openFull":"Open full semantic radar","viewer.radar.open":"Open radar","viewer.radar.close":"Close semantic radar","viewer.radar.surface":"Diagram overview. Click a node to focus it, or use arrow keys to pan.","viewer.radar.click":"Click node","viewer.radar.drag":"Drag to pan","viewer.radar.space":"Semantic radar needs more MAP space.","viewer.radar.nodes":"Semantic diagram radar nodes","viewer.radar.focus":"Focus {label} from Semantic Radar","viewer.radar.status":"{count} nodes · {viewport}","viewer.radar.fullMap":"{count} nodes · full map","viewer.radar.compacted":"Radar compacted to avoid covering the Semantic Passport or MAP controls.","viewer.radar.cancelWaiting":"Cancel semantic radar waiting for more MAP space","viewer.radar.needsSpace":"Semantic radar needs more visible MAP space","viewer.radar.viewport.full":"full map","viewer.radar.viewport.width":"{percent}% width","viewer.radar.viewport.scale":"{percent}% viewport","viewer.nav.controls":"Diagram view controls","viewer.nav.route":"Trace a directed route","viewer.nav.route.title":"Trace route (R)","viewer.nav.route.short":"PATH","viewer.nav.radar":"Open semantic radar","viewer.nav.radar.title":"Semantic radar (M)","viewer.nav.radar.short":"MAP","viewer.nav.lens":"Open semantic lens","viewer.nav.lens.title":"Semantic lens (L)","viewer.nav.lens.short":"LENS","viewer.nav.find":"Find a node","viewer.nav.find.title":"Find a node (/)","viewer.nav.guide":"Open diagram guide","viewer.nav.guide.title":"Diagram guide (?)","viewer.nav.zoomOut":"Zoom out","viewer.nav.zoomOut.title":"Zoom out (-)","viewer.nav.reset":"Reset diagram view","viewer.nav.reset.title":"Reset view (0)","viewer.nav.read":"READ","viewer.nav.zoomIn":"Zoom in","viewer.nav.zoomIn.title":"Zoom in (+)","viewer.nav.camera":"{hint}. Reset diagram view","viewer.nav.camera.title":"{semantic}{hint} · reset view (0)","viewer.nav.camera.semantic":"Semantic camera active · ","viewer.nav.level.map":"MAP","viewer.nav.level.read":"READ","viewer.nav.level.full":"FULL","viewer.nav.level.auto":"AUTO","viewer.nav.detail.map":"Zoom in to reveal relationship labels and node context","viewer.nav.detail.read":"Zoom in again to reveal tags and annotations","viewer.nav.detail.full":"Full diagram detail","viewer.intent.summary":"{label}. {out} outgoing, {in} incoming{loops}. {total} connections. Press Enter for details.","viewer.intent.loops":", {count} self loop","viewer.common.copied":"Copied","viewer.common.copyFailed":"Copy failed","viewer.common.copyLink":"Copy link","viewer.common.clear":"Clear","viewer.common.close":"Close"}}</script>
<div class="guided-views no-print" id="guided-views" hidden aria-label="Guided diagram views">
<button id="guided-view-prev" type="button" aria-label="Previous guided view" title="Previous guided view ([)">&#8592;</button>
<div class="guided-view-copy">
@@ -4911,10 +5002,11 @@
</div>
<!-- Main Diagram -->
- <div class="diagram-container" data-detail-level="read">
- <svg viewBox="0 0 980 528" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="showcase">
+ <div class="diagram-container" data-detail-level="read"
+ data-preset-badge-editorial-plate="ARCHIFY / PLATE 04">
+ <svg viewBox="0 0 980 528" role="img" lang="en" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="showcase">
<title id="archify-diagram-title">RAG Pipeline</title>
- <desc id="archify-diagram-description">A architecture diagram generated by Archify.</desc>
+ <desc id="archify-diagram-description">An architecture diagram generated by Archify.</desc>
<!-- Definitions -->
<defs>
<marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
@@ -4938,11 +5030,9 @@
<rect width="100%" height="100%" fill="url(#grid)" />
<!-- Boundaries (behind everything) -->
- <rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="0" x="130" y="40" width="810" height="234" rx="12" class="c-region" stroke-width="1"/>
- <text x="138" y="58" class="t-cloud" font-size="9" font-weight="600">Query Runtime</text>
+ <rect data-graph-role="structural-frame" data-composition-frame-kind="region" data-composition-frame-id="0" data-composition-frame-label="Query Runtime" x="130" y="40" width="810" height="234" rx="12" class="c-region" stroke-width="1"/>
- <rect data-graph-role="structural-frame" data-composition-frame-kind="security-group" data-composition-frame-id="1" x="330" y="360" width="490" height="100" rx="8" class="c-security-group" stroke-width="1"/>
- <text x="338" y="378" class="t-security" font-size="9" font-weight="600">Ingestion Pipeline</text>
+ <rect data-graph-role="structural-frame" data-composition-frame-kind="security-group" data-composition-frame-id="1" data-composition-frame-label="Ingestion Pipeline" x="330" y="360" width="490" height="100" rx="8" class="c-security-group" stroke-width="1"/>
<!-- Connection paths (before components for correct z-order) -->
<path data-edge-from="user" data-edge-to="guardrail" data-edge-label="question" data-edge-key="0" data-edge-id="user-to-guardrail" data-composition-points="130,225;160,225" d="M 130 225 L 160 225" class="a-emphasis" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
@@ -4968,7 +5058,7 @@
<rect x="2.5" y="5" width="8.5" height="8" rx="1.5"/>
<path d="M8 2.5h5.5V8M13.5 2.5 7.5 8.5"/>
</g>
- <text data-detail-anchor="" x="80" y="223" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">User</text>
+ <text data-node-label="" data-detail-anchor="" x="80" y="223" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">User</text>
<text data-detail="context" x="80" y="239" class="t-muted" font-size="9" text-anchor="middle">Chat / API</text>
</g>
@@ -4980,7 +5070,7 @@
<path d="M8 2.2 13 4v3.5c0 3.1-1.8 5.4-5 6.5-3.2-1.1-5-3.4-5-6.5V4Z"/>
<path d="m5.8 8 1.5 1.5 3-3"/>
</g>
- <text data-detail-anchor="" x="215" y="223" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Guardrail</text>
+ <text data-node-label="" data-detail-anchor="" x="215" y="223" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Guardrail</text>
<text data-detail="context" x="215" y="239" class="t-muted" font-size="9" text-anchor="middle">Input filter</text>
<text data-detail="fine" x="215" y="242" class="t-security" font-size="7" text-anchor="middle">PII + toxicity</text>
</g>
@@ -4992,7 +5082,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(316 206) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="375" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Orchestrator</text>
+ <text data-node-label="" data-detail-anchor="" x="375" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Orchestrator</text>
<text data-detail="context" x="375" y="241" class="t-muted" font-size="9" text-anchor="middle">LangGraph agent</text>
</g>
@@ -5004,7 +5094,7 @@
<ellipse cx="8" cy="4" rx="5" ry="2"/>
<path d="M3 4v8c0 1.1 2.2 2 5 2s5-.9 5-2V4M3 8c0 1.1 2.2 2 5 2s5-.9 5-2"/>
</g>
- <text data-detail-anchor="" x="375" y="93" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Semantic Cache</text>
+ <text data-node-label="" data-detail-anchor="" x="375" y="93" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Semantic Cache</text>
<text data-detail="context" x="375" y="109" class="t-muted" font-size="9" text-anchor="middle">Redis :6379</text>
</g>
@@ -5015,7 +5105,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(486 206) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="540" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Retriever</text>
+ <text data-node-label="" data-detail-anchor="" x="540" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Retriever</text>
<text data-detail="context" x="540" y="241" class="t-muted" font-size="9" text-anchor="middle">Hybrid search</text>
</g>
@@ -5027,7 +5117,7 @@
<ellipse cx="8" cy="4" rx="5" ry="2"/>
<path d="M3 4v8c0 1.1 2.2 2 5 2s5-.9 5-2V4M3 8c0 1.1 2.2 2 5 2s5-.9 5-2"/>
</g>
- <text data-detail-anchor="" x="540" y="308" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Vector Store</text>
+ <text data-node-label="" data-detail-anchor="" x="540" y="308" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Vector Store</text>
<text data-detail="context" x="540" y="324" class="t-muted" font-size="9" text-anchor="middle">Milvus</text>
<text data-detail="fine" x="540" y="327" class="t-database" font-size="7" text-anchor="middle">HNSW index</text>
</g>
@@ -5039,7 +5129,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(646 206) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="700" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Reranker</text>
+ <text data-node-label="" data-detail-anchor="" x="700" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Reranker</text>
<text data-detail="context" x="700" y="241" class="t-muted" font-size="9" text-anchor="middle">Cross-encoder</text>
</g>
@@ -5050,7 +5140,7 @@
<g aria-hidden="true" data-semantic-sigil="cloud" class="semantic-sigil s-cloud" transform="translate(806 206) scale(0.6875)">
<path d="M4.3 12.5h7.3a2.4 2.4 0 0 0 .2-4.8 4 4 0 0 0-7.5-1.3A3.1 3.1 0 0 0 4.3 12.5Z"/>
</g>
- <text data-detail-anchor="" x="855" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">LLM</text>
+ <text data-node-label="" data-detail-anchor="" x="855" y="225" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">LLM</text>
<text data-detail="context" x="855" y="241" class="t-muted" font-size="9" text-anchor="middle">Claude API</text>
</g>
@@ -5062,7 +5152,7 @@
<rect x="2.5" y="5" width="8.5" height="8" rx="1.5"/>
<path d="M8 2.5h5.5V8M13.5 2.5 7.5 8.5"/>
</g>
- <text data-detail-anchor="" x="260" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Documents</text>
+ <text data-node-label="" data-detail-anchor="" x="260" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Documents</text>
<text data-detail="context" x="260" y="429" class="t-muted" font-size="9" text-anchor="middle">PDF / Web / DB</text>
</g>
@@ -5073,7 +5163,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(366 396) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="415" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Loader</text>
+ <text data-node-label="" data-detail-anchor="" x="415" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Loader</text>
<text data-detail="context" x="415" y="429" class="t-muted" font-size="9" text-anchor="middle">Parse + extract</text>
</g>
@@ -5084,7 +5174,7 @@
<g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(516 396) scale(0.6875)">
<path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
</g>
- <text data-detail-anchor="" x="565" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Chunker</text>
+ <text data-node-label="" data-detail-anchor="" x="565" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Chunker</text>
<text data-detail="context" x="565" y="429" class="t-muted" font-size="9" text-anchor="middle">Semantic split</text>
</g>
@@ -5095,7 +5185,7 @@
<g aria-hidden="true" data-semantic-sigil="cloud" class="semantic-sigil s-cloud" transform="translate(676 396) scale(0.6875)">
<path d="M4.3 12.5h7.3a2.4 2.4 0 0 0 .2-4.8 4 4 0 0 0-7.5-1.3A3.1 3.1 0 0 0 4.3 12.5Z"/>
</g>
- <text data-detail-anchor="" x="730" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Embedding</text>
+ <text data-node-label="" data-detail-anchor="" x="730" y="413" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Embedding</text>
<text data-detail="context" x="730" y="429" class="t-muted" font-size="9" text-anchor="middle">text-embedding-3</text>
</g>
@@ -5153,6 +5243,17 @@
<text x="635" y="265" class="t-messagebus" font-size="8" text-anchor="middle">vectors</text>
</g>
+ <!-- Boundary labels (foreground masks keep routes out of titles) -->
+ <g data-graph-role="structural-frame-label" data-composition-frame-id="0" data-composition-frame-kind="region" data-composition-frame-label="Query Runtime">
+ <rect data-graph-role="structural-frame-label-mask" x="134" y="50" width="80.2" height="16" rx="3" class="c-mask"/>
+ <text data-boundary-label="" x="138" y="63" class="t-cloud" font-size="9" font-weight="600">Query Runtime</text>
+ </g>
+
+ <g data-graph-role="structural-frame-label" data-composition-frame-id="1" data-composition-frame-kind="security-group" data-composition-frame-label="Ingestion Pipeline">
+ <rect data-graph-role="structural-frame-label-mask" x="334" y="370" width="107.2" height="16" rx="3" class="c-mask"/>
+ <text data-boundary-label="" x="338" y="383" class="t-security" font-size="9" font-weight="600">Ingestion Pipeline</text>
+ </g>
+
<!-- Legend -->
<g data-legend="" data-legend-bridge="">
<text x="40" y="492" class="t-primary" font-size="12" font-weight="650">Legend</text>
@@ -5342,11 +5443,13 @@
<strong id="overview-map-title">Semantic radar</strong>
<small id="overview-map-status" aria-live="polite">Building overview</small>
</span>
+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button>
<button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">&#215;</button>
</div>
<div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div>
<div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div>
</div>
+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p>
<div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls">
<button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button>
<button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>
@@ -5402,6 +5505,37 @@
<script>
var Archify = {};
+ var archifyI18nData = (function () {
+ var node = document.getElementById('archify-i18n-data');
+ try { return JSON.parse(node ? node.textContent : '{}'); }
+ catch (_) { return { locale: 'en', messages: {} }; }
+ })();
+ Archify.locale = archifyI18nData.locale || 'en';
+
+ function viewerText(key, values) {
+ var messages = archifyI18nData.messages || {};
+ var template = Object.prototype.hasOwnProperty.call(messages, key) ? messages[key] : key;
+ return String(template).replace(/\{([a-zA-Z0-9_]+)\}/g, function (match, name) {
+ return values && Object.prototype.hasOwnProperty.call(values, name) ? String(values[name]) : match;
+ });
+ }
+
+ function viewerCount(key, count, values) {
+ var suffix = Number(count) === 1 ? '.one' : '.other';
+ var payload = Object.assign({}, values || {}, { count: count });
+ return viewerText(key + suffix, payload);
+ }
+
+ function viewerKindLabel(value) {
+ var normalized = String(value || 'node').toLowerCase();
+ var knownKey = 'viewer.kind.' + normalized;
+ var known = viewerText(knownKey);
+ if (known !== knownKey) return known;
+ return normalized
+ .replace(/messagebus/gi, 'message bus')
+ .replace(/[-_]+/g, ' ')
+ .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
+ }
function hasDrawableGeometry(element) {
if (!element) return false;
@@ -5432,7 +5566,12 @@
============================================================ */
Archify.preset = (function () {
var PRESETS = ['classic', 'signal-flow', 'blueprint', 'editorial'];
- var LABELS = { classic: 'Classic', 'signal-flow': 'Flow', blueprint: 'Blueprint', editorial: 'Editorial' };
+ var LABELS = {
+ classic: viewerText('viewer.preset.classic.short'),
+ 'signal-flow': viewerText('viewer.preset.flow.short'),
+ blueprint: viewerText('viewer.preset.blueprint'),
+ editorial: viewerText('viewer.preset.editorial')
+ };
var html = document.documentElement;
var svg = document.querySelector('.diagram-container svg');
var btn = document.getElementById('btn-preset');
@@ -5459,8 +5598,8 @@
svg.setAttribute('data-preset', preset);
btn.setAttribute('data-preset-option', preset);
label.textContent = LABELS[preset];
- btn.setAttribute('aria-label', 'Visual style: ' + LABELS[preset] + '. Choose visual style');
- btn.title = 'Choose visual style (S cycles)';
+ btn.setAttribute('aria-label', viewerText('viewer.preset.current', { style: LABELS[preset] }));
+ btn.title = viewerText('viewer.preset.choose.title');
options().forEach(function (option) {
var selected = option.getAttribute('data-preset-value') === preset;
option.setAttribute('aria-checked', String(selected));
@@ -5572,7 +5711,7 @@
function apply(theme) {
html.setAttribute('data-theme', theme);
- label.textContent = theme === 'dark' ? 'Dark' : 'Light';
+ label.textContent = viewerText(theme === 'dark' ? 'viewer.theme.dark' : 'viewer.theme.light');
btn.setAttribute('aria-pressed', theme === 'light' ? 'true' : 'false');
}
@@ -5621,6 +5760,18 @@
var SHARE_CARD_PADDING = 36;
var SHARE_CARD_HEADER = 112;
+ function exportError(key, values) {
+ var error = new Error(viewerText(key, values));
+ error.archifyViewerMessage = true;
+ return error;
+ }
+
+ function exportMessage(error) {
+ return error && error.archifyViewerMessage
+ ? error.message
+ : viewerText('viewer.export.unknown');
+ }
+
function diagramFilename() {
var title = (document.title || 'diagram')
.replace(/\s+Architecture(\s+Diagram)?$/i, '')
@@ -5823,6 +5974,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -5997,6 +6149,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -6216,7 +6369,7 @@
format === 'webp' ? 'image/webp' : 'image/png';
var quality = format === 'png' ? undefined : 0.95;
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for ' + format));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: format }));
else resolve(blob);
}, mime, quality);
} catch (error) {
@@ -6252,11 +6405,11 @@
function canvas2dOrThrow(canvas, label) {
if (!canvas || typeof canvas.getContext !== 'function') {
- throw new Error('Canvas unavailable for ' + label);
+ throw exportError('viewer.export.error.canvasUnavailable', { label: label });
}
var ctx = canvas.getContext('2d');
- if (!ctx) throw new Error('2D canvas context unavailable for ' + label);
- if (typeof canvas.toBlob !== 'function') throw new Error('canvas.toBlob unavailable for ' + label);
+ if (!ctx) throw exportError('viewer.export.error.contextUnavailable', { label: label });
+ if (typeof canvas.toBlob !== 'function') throw exportError('viewer.export.error.toBlobUnavailable', { label: label });
return ctx;
}
@@ -6264,14 +6417,14 @@
options = options || {};
var routeSnapshot = options.routeSnapshot || null;
var reachSnapshot = options.reachSnapshot || null;
- if (routeSnapshot && reachSnapshot) return Promise.reject(new Error('Share Card variants cannot be combined'));
+ if (routeSnapshot && reachSnapshot) return Promise.reject(exportError('viewer.export.error.variantsCombined'));
var svg = document.querySelector('.diagram-container svg');
var vb = svg.viewBox.baseVal;
var sourceScale = Math.min(2, pickSafeScale(vb.width, vb.height));
var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot, reachSnapshot: reachSnapshot });
- if (!data.canonicalStateClean) return Promise.reject(new Error('Share Card export could not remove temporary viewer state'));
- if (routeSnapshot && !data.routeStateClean) return Promise.reject(new Error('Route Card export could not preserve the resolved route safely'));
- if (reachSnapshot && !data.reachStateClean) return Promise.reject(new Error('Reach Card export could not preserve authored reach safely'));
+ if (!data.canonicalStateClean) return Promise.reject(exportError('viewer.export.error.viewerState'));
+ if (routeSnapshot && !data.routeStateClean) return Promise.reject(exportError('viewer.export.error.routeState'));
+ if (reachSnapshot && !data.reachStateClean) return Promise.reject(exportError('viewer.export.error.reachState'));
var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });
var svgUrl = URL.createObjectURL(svgBlob);
@@ -6282,7 +6435,7 @@
var canvas = document.createElement('canvas');
canvas.width = SHARE_CARD_WIDTH;
canvas.height = SHARE_CARD_HEIGHT;
- var ctx = canvas2dOrThrow(canvas, 'Share Card');
+ var ctx = canvas2dOrThrow(canvas, viewerText('viewer.export.shareCard'));
var computed = getComputedStyle(document.documentElement);
var bg = computed.getPropertyValue('--bg').trim() || currentBg();
var text = computed.getPropertyValue('--text').trim() || '#ffffff';
@@ -6295,21 +6448,37 @@
var titleNode = document.querySelector('.header h1');
var subtitleNode = document.querySelector('.header .subtitle');
var title = titleNode ? titleNode.textContent : document.title;
+ var directionLabel = reachSnapshot
+ ? viewerText('viewer.export.direction.' + reachSnapshot.direction)
+ : '';
var subtitle = routeSnapshot
- ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'
+ ? viewerCount('viewer.export.card.routeSummary', routeSnapshot.hops, {
+ source: routeSnapshot.source.label,
+ target: routeSnapshot.target.label
+ })
: reachSnapshot
- ? 'Authored ' + reachSnapshot.direction + ' from ' + reachSnapshot.origin.label + ' · ' +
- (reachSnapshot.nodeIds.length - 1) + ' nodes · ' + reachSnapshot.edges.length +
- ' links · max ' + reachSnapshot.maxDepth + ' hops'
+ ? viewerText('viewer.export.card.reachSummary', {
+ direction: directionLabel,
+ origin: reachSnapshot.origin.label,
+ nodes: viewerCount('viewer.export.card.node', reachSnapshot.nodeIds.length - 1),
+ links: viewerCount('viewer.export.card.link', reachSnapshot.edges.length),
+ hops: viewerCount('viewer.export.card.hop', reachSnapshot.maxDepth)
+ })
: subtitleNode ? subtitleNode.textContent : '';
var preset = document.documentElement.getAttribute('data-preset') || 'classic';
var theme = document.documentElement.getAttribute('data-theme') || 'dark';
- var presetLabel = preset === 'signal-flow' ? 'FLOW' : preset.toUpperCase();
+ var presetKey = preset === 'signal-flow'
+ ? 'viewer.preset.flow.short'
+ : 'viewer.preset.' + preset;
+ var presetLabel = viewerText(presetKey).toUpperCase();
+ var themeLabel = viewerText('viewer.theme.' + theme).toUpperCase();
var cardLabel = routeSnapshot
- ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'
+ ? viewerText('viewer.export.card.routeBadge', {
+ hops: viewerCount('viewer.export.card.hop', routeSnapshot.hops).toUpperCase()
+ })
: reachSnapshot
- ? 'ARCHIFY · ' + reachSnapshot.direction.toUpperCase() + ' REACH'
- : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();
+ ? viewerText('viewer.export.card.reachBadge', { direction: directionLabel.toUpperCase() })
+ : viewerText('viewer.export.card.defaultBadge', { preset: presetLabel, theme: themeLabel });
ctx.fillStyle = bg;
ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);
@@ -6347,7 +6516,7 @@
URL.revokeObjectURL(svgUrl);
canvas.toBlob(function (blob) {
- if (!blob) reject(new Error('toBlob returned null for Share Card'));
+ if (!blob) reject(exportError('viewer.export.error.toBlobNull', { label: viewerText('viewer.export.shareCard') }));
else resolve(blob);
}, 'image/png');
} catch (error) {
@@ -6367,17 +6536,17 @@
options = options || {};
if (!options.variant) return renderShareCard();
if (options.variant !== 'route' && options.variant !== 'reach') {
- return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));
+ return Promise.reject(exportError('viewer.export.unknownVariant', { variant: options.variant }));
}
if (options.variant === 'route') {
var routeSnapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
- if (!routeSnapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ if (!routeSnapshot) return Promise.reject(exportError('viewer.export.routeRequired'));
return renderShareCard({ routeSnapshot: routeSnapshot });
}
var snapshot = Archify.focus && typeof Archify.focus.reachabilitySnapshot === 'function'
? Archify.focus.reachabilitySnapshot()
: null;
- if (!snapshot) return Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ if (!snapshot) return Promise.reject(exportError('viewer.export.reachRequired'));
return renderShareCard({ reachSnapshot: snapshot });
}
@@ -6411,7 +6580,7 @@
function recordWebm(options) {
options = options || {};
if (!canRecordMotion()) {
- return Promise.reject(new Error('WebM motion export requires a trace animation and browser MediaRecorder support'));
+ return Promise.reject(exportError('viewer.export.error.webmRequirements'));
}
var duration = Math.max(250, Number(options.duration) || MOTION_DURATION);
var fps = Math.max(1, Number(options.fps) || MOTION_FPS);
@@ -6609,12 +6778,12 @@
};
recorder.onerror = function (event) {
cleanup();
- reject(event.error || new Error('MediaRecorder failed'));
+ reject(event.error || exportError('viewer.export.error.mediaRecorder'));
};
recorder.onstop = function () {
cleanup();
var blob = new Blob(chunks, { type: recorder.mimeType || mime });
- if (!blob.size) reject(new Error('MediaRecorder produced an empty WebM'));
+ if (!blob.size) reject(exportError('viewer.export.error.emptyWebm'));
else resolve(blob);
};
drawMotionFrame(ctx, backgroundImage, motionScene, 0);
@@ -6635,7 +6804,7 @@
};
backgroundImage.onerror = function () {
URL.revokeObjectURL(sourceUrl);
- reject(new Error('SVG background could not be loaded for WebM export'));
+ reject(exportError('viewer.export.error.webmBackground'));
};
backgroundImage.src = sourceUrl;
});
@@ -6693,11 +6862,11 @@
items().forEach(function (it) {
if (it.dataset.format && !supports(it.dataset.format)) {
it.disabled = true;
- it.title = 'Not supported by this browser';
+ it.title = viewerText('viewer.export.unsupported');
}
if ((it.dataset.action === 'copy' || it.dataset.action === 'copy-share-card') && !canCopyImage()) {
it.disabled = true;
- it.title = 'Clipboard image write not supported by this browser';
+ it.title = viewerText('viewer.export.clipboardUnsupported');
}
});
@@ -6788,12 +6957,12 @@
var base = diagramFilename();
close(true);
clearExportReceipt();
- if (format === 'webm') toast('Recording 6 seconds of motion…');
+ if (format === 'webm') toast(viewerText('viewer.export.recording'));
return (format === 'share-card'
? rasterizeShareCard().then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
download(blob, base + '-share-card.png');
- toast('Downloaded Share Card');
+ toast(viewerText('viewer.export.downloadedShare'));
})
: format === 'svg'
? Promise.resolve(serializeSvg(1, { autoTheme: true })).then(function (d) {
@@ -6806,7 +6975,7 @@
document.documentElement.setAttribute('data-last-motion-bytes', String(blob.size));
recordExportReceipt('webm', blob, true);
download(blob, base + '.webm');
- toast('Downloaded WebM');
+ toast(viewerText('viewer.export.downloadedWebm'));
})
: rasterize(format).then(function (blob) {
recordExportReceipt(format, blob, true);
@@ -6814,20 +6983,21 @@
})
).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : format;
+ var technicalMessage = err && err.message ? err.message : format;
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', format);
- document.documentElement.setAttribute('data-last-export-error', message);
- if (format === 'webm' && /MediaRecorder|WebM motion export|empty WebM/i.test(message)) {
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ if (format === 'webm') {
var motionItem = menu.querySelector('button[data-format="webm"]');
if (motionItem) {
motionItem.disabled = true;
- motionItem.title = 'Motion capture unavailable in this browser';
+ motionItem.title = viewerText('viewer.export.motionUnavailable');
motionItem.style.opacity = '0.5';
}
- toast('WebM unavailable in this browser');
+ toast(viewerText('viewer.export.webmUnavailable'));
return;
}
- alert('Export failed: ' + message);
+ alert(viewerText('viewer.export.failed', { message: message }));
});
}
@@ -6837,18 +7007,19 @@
var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();
var blobPromise = snapshot
? renderShareCard({ routeSnapshot: snapshot })
- : Promise.reject(new Error('Trace a route before exporting a Route Share Card'));
+ : Promise.reject(exportError('viewer.export.routeRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'route', true);
download(blob, diagramFilename() + '-route-share-card.png');
- toast('Downloaded Route Share Card');
+ toast(viewerText('viewer.export.downloadedRoute'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Route Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.routeFailed', { message: message }));
});
}
@@ -6860,18 +7031,19 @@
: null;
var blobPromise = snapshot
? renderShareCard({ reachSnapshot: snapshot })
- : Promise.reject(new Error('Trace authored reach before exporting a Reach Share Card'));
+ : Promise.reject(exportError('viewer.export.reachRequired'));
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, false, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT }, 'reach', false, true);
download(blob, diagramFilename() + '-' + snapshot.direction + '-reach-share-card.png');
- toast('Downloaded Reach Share Card');
+ toast(viewerText('viewer.export.downloadedReach'));
return blob;
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'share-card';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Reach Share Card export failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.reachFailed', { message: message }));
});
}
@@ -6936,21 +7108,22 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported by this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.period'));
return;
}
var blobPromise = rasterizeShareCard();
return writePngToClipboard(blobPromise).then(function () {
return blobPromise.then(function (blob) {
recordExportReceipt('share-card', blob, true, { width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT });
- toast('Copied Share Card');
+ toast(viewerText('viewer.export.copiedShare'));
});
}).catch(function (err) {
console.error(err);
- var message = err && err.message ? err.message : 'unknown';
+ var technicalMessage = err && err.message ? err.message : 'share-card';
+ var message = exportMessage(err);
document.documentElement.setAttribute('data-last-export-error-format', 'share-card');
- document.documentElement.setAttribute('data-last-export-error', message);
- alert('Copy failed: ' + message);
+ document.documentElement.setAttribute('data-last-export-error', technicalMessage);
+ alert(viewerText('viewer.export.copyFailed', { message: message }));
});
}
@@ -6958,15 +7131,17 @@
close(true);
clearExportReceipt();
if (!canCopyImage()) {
- alert('Clipboard image write not supported in this browser.');
+ alert(viewerText('viewer.export.clipboardUnsupported.short'));
return;
}
var blobPromise = rasterize('png');
return writePngToClipboard(blobPromise).then(function () {
- toast('Copied PNG to clipboard');
+ toast(viewerText('viewer.export.copiedPng'));
}).catch(function (err) {
console.error(err);
- alert('Copy failed: ' + (err && err.message ? err.message : 'unknown'));
+ alert(viewerText('viewer.export.copyFailed', {
+ message: exportMessage(err)
+ }));
});
}
@@ -7092,17 +7267,17 @@
return readerPaused || reducedMotion() || hasSuspension();
}
function ownerLabel(value) {
- if (value === 'story') return 'the guided story';
- if (value === 'chapter') return 'the active chapter';
- if (value === 'chapter-preview') return 'the chapter delta preview';
- if (value === 'handoff') return 'the chapter handoff';
- if (value === 'route') return 'Route Probe';
- if (value === 'lens') return 'Semantic Lens';
- if (value === 'relationship') return 'Relationship Preview';
- if (value === 'intent') return 'Intent Trace';
- if (value === 'focus') return 'semantic focus';
- if (value === 'legend') return 'legend preview';
- return 'reader interaction';
+ if (value === 'story') return viewerText('viewer.owner.story');
+ if (value === 'chapter') return viewerText('viewer.owner.chapter');
+ if (value === 'chapter-preview') return viewerText('viewer.owner.chapterPreview');
+ if (value === 'handoff') return viewerText('viewer.owner.handoff');
+ if (value === 'route') return viewerText('viewer.owner.route');
+ if (value === 'lens') return viewerText('viewer.owner.lens');
+ if (value === 'relationship') return viewerText('viewer.owner.relationship');
+ if (value === 'intent') return viewerText('viewer.owner.intent');
+ if (value === 'focus') return viewerText('viewer.owner.focus');
+ if (value === 'legend') return viewerText('viewer.owner.legend');
+ return viewerText('viewer.owner.reader');
}
function render() {
if (!capable) return;
@@ -7116,7 +7291,7 @@
}
btn.setAttribute('aria-pressed', paused ? 'false' : 'true');
btn.disabled = systemPaused;
- label.textContent = paused ? 'Still' : 'Live';
+ label.textContent = viewerText(paused ? 'viewer.motion.still' : 'viewer.motion.live');
if (paused && lastEffectivePaused !== true && Archify.guidedViews && Archify.guidedViews.isPlaying()) {
Archify.guidedViews.pause();
}
@@ -7129,20 +7304,20 @@
lastEffectivePaused = paused;
if (Archify.routeProbe && typeof Archify.routeProbe.syncMotion === 'function') Archify.routeProbe.syncMotion();
if (systemPaused) {
- btn.setAttribute('aria-label', 'Motion paused by reduced-motion preference');
- btn.title = 'Motion paused by reduced-motion preference';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.reduced'));
+ btn.title = viewerText('viewer.motion.reduced');
} else if (hasSuspension()) {
- btn.setAttribute('aria-label', 'Motion paused while this page is hidden');
- btn.title = 'Motion paused while this page is hidden';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.hidden'));
+ btn.title = viewerText('viewer.motion.hidden');
} else if (paused) {
- btn.setAttribute('aria-label', 'Resume motion');
- btn.title = 'Resume motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.resume'));
+ btn.title = viewerText('viewer.motion.resume');
} else if (owner) {
- btn.setAttribute('aria-label', 'Pause motion; currently yielding to ' + ownerLabel(owner));
- btn.title = 'Live preview enabled · yielding to ' + ownerLabel(owner);
+ btn.setAttribute('aria-label', viewerText('viewer.motion.yielding', { owner: ownerLabel(owner) }));
+ btn.title = viewerText('viewer.motion.yielding.title', { owner: ownerLabel(owner) });
} else {
- btn.setAttribute('aria-label', 'Pause motion');
- btn.title = 'Pause motion';
+ btn.setAttribute('aria-label', viewerText('viewer.motion.pause'));
+ btn.title = viewerText('viewer.motion.pause');
}
}
function setPaused(next, options) {
@@ -7313,7 +7488,7 @@
if (!box || !Number.isFinite(box.x) || !Number.isFinite(box.y) || !Number.isFinite(box.width) || box.width < 36) return;
var count = sources.length;
- var label = count + ' verified source' + (count === 1 ? '' : 's') + '; focus this node to inspect';
+ var label = viewerCount('viewer.passport.beacon', count);
var beacon = document.createElementNS(svgNamespace, 'g');
beacon.classList.add('source-evidence-beacon');
beacon.setAttribute('data-source-evidence-beacon', '');
@@ -7329,7 +7504,7 @@
var text = document.createElementNS(svgNamespace, 'text');
text.setAttribute('x', '15');
text.setAttribute('y', '8.25');
- text.textContent = 'SRC ' + count;
+ text.textContent = viewerText('viewer.passport.sourceMarker') + ' ' + count;
beacon.appendChild(title);
beacon.appendChild(plate);
beacon.appendChild(text);
@@ -7338,7 +7513,7 @@
var originalLabel = node.getAttribute('aria-label') || '';
node.setAttribute('data-source-evidence-count', String(count));
node.setAttribute('data-source-evidence-original-label', originalLabel);
- node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + count + ' verified source reference' + (count === 1 ? '' : 's'));
+ node.setAttribute('aria-label', (originalLabel ? originalLabel + ', ' : '') + viewerCount('viewer.passport.sourceCount', count));
installed += 1;
});
return installed;
@@ -7516,11 +7691,11 @@
upstreamBtn.disabled = upstreamReach === 0;
downstreamBtn.disabled = downstreamReach === 0;
upstreamBtn.setAttribute('aria-label', upstreamReach
- ? 'Trace ' + upstreamReach + ' upstream authored node' + (upstreamReach === 1 ? '' : 's')
- : 'No upstream authored nodes');
+ ? viewerCount('viewer.passport.reach.upstream', upstreamReach)
+ : viewerText('viewer.passport.reach.noUpstream'));
downstreamBtn.setAttribute('aria-label', downstreamReach
- ? 'Trace ' + downstreamReach + ' downstream authored node' + (downstreamReach === 1 ? '' : 's')
- : 'No downstream authored nodes');
+ ? viewerCount('viewer.passport.reach.downstream', downstreamReach)
+ : viewerText('viewer.passport.reach.noDownstream'));
reachSection.hidden = false;
}
function applyReachability(direction, options) {
@@ -7566,11 +7741,15 @@
var activeButton = direction === 'upstream' ? upstreamBtn : downstreamBtn;
activeButton.setAttribute('aria-pressed', 'true');
var reachableCount = result.nodeIds.length - 1;
- var directionLabel = direction === 'upstream' ? 'Upstream' : 'Downstream';
- reachStatus.textContent = directionLabel + ' · ' + reachableCount + ' node' +
- (reachableCount === 1 ? '' : 's') + ' · ' + result.edgeKeys.length + ' link' +
- (result.edgeKeys.length === 1 ? '' : 's') + ' · max ' + result.maxDepth + ' hop' +
- (result.maxDepth === 1 ? '' : 's');
+ var directionLabel = viewerText(direction === 'upstream'
+ ? 'viewer.passport.upstream'
+ : 'viewer.passport.downstream');
+ reachStatus.textContent = viewerText('viewer.passport.reach.status', {
+ direction: directionLabel,
+ nodes: reachableCount,
+ links: result.edgeKeys.length,
+ hops: result.maxDepth
+ });
reachStatus.hidden = false;
if (Archify.exportMenu && typeof Archify.exportMenu.syncReachShare === 'function') {
Archify.exportMenu.syncReachShare();
@@ -7697,7 +7876,7 @@
var slug = repository.url.replace(/^https:\/\/github\.com\//, '').replace(/\/$/, '');
repositoryLink.href = repository.url + '/tree/' + repository.revision;
repositoryLink.textContent = slug + ' @ ' + repository.shortRevision;
- repositoryLink.setAttribute('aria-label', 'Open verified repository revision ' + repository.revision);
+ repositoryLink.setAttribute('aria-label', viewerText('viewer.passport.repository.open', { revision: repository.revision }));
sources.forEach(function (source) {
var link = document.createElement('a');
link.className = 'semantic-passport-source';
@@ -7705,13 +7884,13 @@
link.target = '_blank';
link.rel = 'noopener noreferrer';
link.referrerPolicy = 'no-referrer';
- link.setAttribute('aria-label', 'Open verified source ' + source.path + ' at revision ' + repository.shortRevision);
+ link.setAttribute('aria-label', viewerText('viewer.passport.source.open', { path: source.path, revision: repository.shortRevision }));
var name = document.createElement('strong');
name.textContent = source.label || source.path.split('/').pop() || source.path;
var location = document.createElement('code');
location.textContent = source.line
? 'L' + source.line + (source.endLine && source.endLine !== source.line ? '–' + source.endLine : '') + ' ↗'
- : 'Open ↗';
+ : viewerText('viewer.passport.source.openLink');
var sourcePath = document.createElement('small');
sourcePath.textContent = source.path;
link.appendChild(name);
@@ -7723,7 +7902,7 @@
}
function renderPassport(id, node) {
setPassportValue(detail, node.getAttribute('data-node-sublabel'));
- setPassportValue(kind, node.getAttribute('data-node-kind') || 'node');
+ setPassportValue(kind, viewerKindLabel(node.getAttribute('data-node-kind') || 'node'));
setPassportValue(context, node.getAttribute('data-node-context'));
setPassportValue(tag, node.getAttribute('data-node-tag'));
setPassportValue(document.getElementById('focus-brand'), node.getAttribute('data-node-brand'));
@@ -7754,7 +7933,11 @@
direction: direction,
neighborId: neighborId,
neighborLabel: neighbor ? nodeLabel(neighbor, neighborId) : neighborId,
- label: edgeLabel || (direction === 'loop' ? 'loops back' : direction === 'out' ? 'connects to' : 'connects from')
+ label: edgeLabel || viewerText(direction === 'loop'
+ ? 'viewer.passport.relationship.loopsBack'
+ : direction === 'out'
+ ? 'viewer.passport.relationship.connectsTo'
+ : 'viewer.passport.relationship.connectsFrom')
});
});
return relationships;
@@ -7797,7 +7980,9 @@
fromLabel: byId[from] ? nodeLabel(byId[from], from) : from,
toLabel: byId[to] ? nodeLabel(byId[to], to) : to,
labelValue: labelValue,
- label: labelValue || (from === to ? 'loops back' : 'connects to'),
+ label: labelValue || viewerText(from === to
+ ? 'viewer.passport.relationship.loopsBack'
+ : 'viewer.passport.relationship.connectsTo'),
edge: edge,
shapes: shapes,
invalid: false
@@ -7824,14 +8009,14 @@
function renderRelationshipCopyAction() {
var record = pinnedRelationshipRecord();
if (record && record.id) {
- copyBtn.textContent = 'Copy relation';
- copyBtn.setAttribute('aria-label', 'Copy link to pinned relationship');
+ copyBtn.textContent = viewerText('viewer.passport.copyRelation');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copyPinned'));
} else if (pinnedRelationshipKey) {
- copyBtn.textContent = 'Copy node';
- copyBtn.setAttribute('aria-label', 'Copy link to source node');
+ copyBtn.textContent = viewerText('viewer.passport.copyNode');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copySource'));
} else {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
}
}
function relationshipHitGeometry(shape, className) {
@@ -8150,7 +8335,11 @@
var target = relationshipHitTarget(key);
if (target) target.setAttribute('aria-pressed', 'true');
renderRelationshipCopyAction();
- summary.textContent = 'Pinned relationship · ' + record.fromLabel + ' → ' + record.toLabel + ' · ' + record.label;
+ summary.textContent = viewerText('viewer.passport.relationship.pinned', {
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
revealPinnedRelationship(record);
if (options.updateUrl !== false && record.id) {
try { history.replaceState(null, '', location.pathname + location.search + '#relation=' + encodeURIComponent(record.id)); } catch (_) {}
@@ -8169,10 +8358,10 @@
relationshipHitOverlay.setAttribute('class', 'relationship-hit-overlay');
relationshipHitOverlay.setAttribute('data-relationship-hit-overlay', '');
relationshipHitOverlay.setAttribute('role', 'group');
- relationshipHitOverlay.setAttribute('aria-label', 'Direct relationship explorer');
+ relationshipHitOverlay.setAttribute('aria-label', viewerText('viewer.passport.relationship.explorer'));
var relationshipHelp = document.createElementNS(svgNamespace, 'desc');
relationshipHelp.id = 'archify-relationship-help';
- relationshipHelp.textContent = 'Use arrow keys to explore relationships. Press Enter or Space to pin details; Escape clears.';
+ relationshipHelp.textContent = viewerText('viewer.passport.relationship.help');
relationshipHitOverlay.appendChild(relationshipHelp);
records.forEach(function (record, index) {
var target = document.createElementNS(svgNamespace, 'g');
@@ -8186,7 +8375,13 @@
target.setAttribute('tabindex', index === 0 ? '0' : '-1');
target.setAttribute('aria-pressed', 'false');
target.setAttribute('aria-describedby', relationshipHelp.id);
- var description = 'Inspect relationship ' + (index + 1) + ' of ' + records.length + ': ' + record.fromLabel + ' to ' + record.toLabel + ', ' + record.label + '. Press Enter for details.';
+ var description = viewerText('viewer.passport.relationship.inspect', {
+ index: index + 1,
+ total: records.length,
+ from: record.fromLabel,
+ to: record.toLabel,
+ label: record.label
+ });
target.setAttribute('aria-label', description);
var title = document.createElementNS(svgNamespace, 'title');
title.textContent = record.fromLabel + ' \u2192 ' + record.toLabel + ' \u00b7 ' + record.label;
@@ -8282,25 +8477,29 @@
var relationships = relationshipsFor(id, byId);
chip.removeAttribute('data-relations-expanded');
relationsBtn.setAttribute('aria-expanded', 'false');
- relationsBtn.textContent = relationships.length + ' relation' + (relationships.length === 1 ? '' : 's');
- relationsBtn.setAttribute('aria-label', 'Show ' + relationships.length + ' connected relationship' + (relationships.length === 1 ? '' : 's'));
+ relationsBtn.textContent = viewerCount('viewer.passport.relationship.count', relationships.length);
+ relationsBtn.setAttribute('aria-label', viewerCount('viewer.passport.relationship.show', relationships.length));
var counts = { out: 0, in: 0, loop: 0 };
relationships.forEach(function (relationship) { counts[relationship.direction] += 1; });
- summary.textContent = counts.out + ' outgoing · ' + counts.in + ' incoming' + (counts.loop ? ' · ' + counts.loop + ' loop' : '');
+ summary.textContent = viewerText('viewer.passport.relationship.summary', {
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.passport.relationship.loops', { count: counts.loop }) : ''
+ });
renderReachabilityControls(id);
relationshipList.textContent = '';
if (!relationships.length) {
var empty = document.createElement('p');
empty.className = 'relationship-lens-empty';
- empty.textContent = 'No connected relationships';
+ empty.textContent = viewerText('viewer.passport.relationship.none');
relationshipList.appendChild(empty);
return;
}
[
- { id: 'out', label: 'Outgoing' },
- { id: 'in', label: 'Incoming' },
- { id: 'loop', label: 'Self loops' }
+ { id: 'out', label: viewerText('viewer.passport.relationship.group.out') },
+ { id: 'in', label: viewerText('viewer.passport.relationship.group.in') },
+ { id: 'loop', label: viewerText('viewer.passport.relationship.group.loop') }
].forEach(function (group) {
var items = relationships.filter(function (relationship) { return relationship.direction === group.id; });
if (!items.length) return;
@@ -8320,11 +8519,19 @@
button.setAttribute('data-relationship-from', relationship.from);
button.setAttribute('data-relationship-to', relationship.to);
if (relationship.id) button.setAttribute('data-relationship-id', relationship.id);
- button.setAttribute('aria-label', group.label + ': ' + relationship.label + ', ' + relationship.neighborLabel);
+ button.setAttribute('aria-label', viewerText('viewer.passport.relationship.row', {
+ group: group.label,
+ relationship: relationship.label,
+ neighbor: relationship.neighborLabel
+ }));
var direction = document.createElement('span');
direction.className = 'relationship-lens-direction';
direction.setAttribute('aria-hidden', 'true');
- direction.textContent = relationship.direction === 'out' ? 'OUT →' : relationship.direction === 'in' ? '← IN' : 'LOOP';
+ direction.textContent = viewerText(relationship.direction === 'out'
+ ? 'viewer.passport.relationship.direction.out'
+ : relationship.direction === 'in'
+ ? 'viewer.passport.relationship.direction.in'
+ : 'viewer.passport.relationship.direction.loop');
var target = document.createElement('strong');
target.textContent = relationship.neighborLabel;
var relation = document.createElement('small');
@@ -8375,6 +8582,45 @@
preferred = nodeCenter - chip.offsetHeight / 2;
}
var top = Math.max(minTop, Math.min(maxTop, preferred));
+ var chipRect = chip.getBoundingClientRect();
+ var safeGap = 10;
+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;
+ var protectedRects = (protectViewerChrome
+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]
+ : [])
+ .filter(function (element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ })
+ .map(function (element) { return element.getBoundingClientRect(); })
+ .filter(function (rect) {
+ return rect.width > 0 && rect.height > 0 &&
+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;
+ });
+ if (protectedRects.length) {
+ var candidates = [top, minTop, maxTop];
+ protectedRects.forEach(function (rect) {
+ candidates.push(
+ rect.top - containerRect.top - chip.offsetHeight - safeGap,
+ rect.bottom - containerRect.top + safeGap
+ );
+ });
+ var valid = candidates.map(function (candidate) {
+ return Math.max(minTop, Math.min(maxTop, candidate));
+ }).filter(function (candidate, index, all) {
+ if (all.indexOf(candidate) !== index) return false;
+ var candidateTop = containerRect.top + candidate;
+ var candidateBottom = candidateTop + chip.offsetHeight;
+ return protectedRects.every(function (rect) {
+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;
+ });
+ });
+ valid.sort(function (first, second) {
+ return Math.abs(first - preferred) - Math.abs(second - preferred);
+ });
+ if (valid.length) top = valid[0];
+ }
chip.style.top = Math.round(top) + 'px';
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
}
@@ -8425,10 +8671,10 @@
upstreamBtn.disabled = true;
downstreamBtn.disabled = true;
relationshipList.textContent = '';
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to focused node');
- relationsBtn.textContent = 'Relations';
- relationsBtn.setAttribute('aria-label', 'Show connected relationships');
+ copyBtn.textContent = viewerText('viewer.passport.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.passport.copy.focus'));
+ relationsBtn.textContent = viewerText('viewer.passport.relations');
+ relationsBtn.setAttribute('aria-label', viewerText('viewer.passport.relations.show'));
relationsBtn.setAttribute('aria-expanded', 'false');
chip.removeAttribute('data-relations-expanded');
chip.style.removeProperty('top');
@@ -8496,7 +8742,7 @@
svg.setAttribute('data-focus-active', normalized.join(' '));
var defaultLabel = normalized.length === 1
? nodeLabel(byId[normalized[0]], normalized[0])
- : normalized.length + ' selected nodes';
+ : viewerText('viewer.guided.chapter.selectedNodes', { count: normalized.length });
label.textContent = options.label || defaultLabel;
chip.hidden = options.hideChip === true || normalized.length !== 1 || selectionMode;
if (!chip.hidden) {
@@ -8542,10 +8788,10 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
copyBtn.setAttribute('aria-label', copied
- ? (relationId ? 'Pinned relationship link copied' : 'Focused node link copied')
- : (relationId ? 'Could not copy pinned relationship link' : 'Could not copy focused node link'));
+ ? viewerText(relationId ? 'viewer.passport.copy.pinned.success' : 'viewer.passport.copy.focused.success')
+ : viewerText(relationId ? 'viewer.passport.copy.pinned.failed' : 'viewer.passport.copy.focused.failed'));
window.setTimeout(function () {
renderRelationshipCopyAction();
}, 1600);
@@ -8584,7 +8830,9 @@
if (expanded) chip.removeAttribute('data-relations-expanded');
else chip.setAttribute('data-relations-expanded', 'true');
relationsBtn.setAttribute('aria-expanded', expanded ? 'false' : 'true');
- relationsBtn.setAttribute('aria-label', expanded ? 'Show connected relationships' : 'Hide connected relationships');
+ relationsBtn.setAttribute('aria-label', viewerText(expanded
+ ? 'viewer.passport.relations.show'
+ : 'viewer.passport.relations.hide'));
requestLensPlacement();
});
relationshipList.addEventListener('click', function (event) {
@@ -8646,7 +8894,7 @@
var target = event.target;
if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;
if (container.getAttribute('data-just-panned') === 'true') return;
- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;
+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;
clear();
}, true);
window.addEventListener('scroll', requestLensPlacement, { passive: true });
@@ -8870,9 +9118,13 @@
svg.setAttribute('data-intent-trace-active', id);
if (options.announce === true) {
var total = counts.out + counts.in + counts.loop;
- status.textContent = nodeLabel(selected, id) + '. ' + counts.out + ' outgoing, ' +
- counts.in + ' incoming' + (counts.loop ? ', ' + counts.loop + ' self loop' : '') +
- '. ' + total + ' connection' + (total === 1 ? '' : 's') + '. Press Enter for details.';
+ status.textContent = viewerText('viewer.intent.summary', {
+ label: nodeLabel(selected, id),
+ out: counts.out,
+ in: counts.in,
+ loops: counts.loop ? viewerText('viewer.intent.loops', { count: counts.loop }) : '',
+ total: total
+ });
}
return true;
}
@@ -9175,8 +9427,11 @@
drawHandoffAnchor(anchor);
var node = findNode(anchor);
var nodeLabel = node ? (node.getAttribute('data-node-label') || anchor) : anchor;
- handoffReceipt.textContent = (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1) +
- ' \u2192 ' + (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1) + ' \u00b7 via ' + nodeLabel;
+ handoffReceipt.textContent = viewerText('viewer.guided.handoff', {
+ from: (previousIndex + 1 < 10 ? '0' : '') + (previousIndex + 1),
+ to: (nextIndex + 1 < 10 ? '0' : '') + (nextIndex + 1),
+ label: nodeLabel
+ });
handoffReceipt.hidden = false;
}
if (Archify.motionGovernor) {
@@ -9233,8 +9488,13 @@
button.setAttribute('data-guided-view-id', view.id);
button.setAttribute('aria-pressed', 'false');
button.setAttribute('tabindex', index === 0 ? '0' : '-1');
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + view.label + ', ' + view.focus.length + ' stops');
- button.title = view.label + ' — ' + (view.note || view.focus.length + ' selected nodes');
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.open', {
+ index: index + 1,
+ total: views.length,
+ label: view.label,
+ count: view.focus.length
+ }));
+ button.title = view.label + ' — ' + (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }));
var position = document.createElement('span');
position.className = 'guided-view-chapter-index';
position.setAttribute('aria-hidden', 'true');
@@ -9244,7 +9504,7 @@
title.textContent = view.label;
var stops = document.createElement('em');
stops.className = 'guided-view-chapter-count';
- stops.textContent = view.focus.length + ' stop' + (view.focus.length === 1 ? '' : 's');
+ stops.textContent = viewerCount('viewer.guided.chapter.stop', view.focus.length);
var delta = document.createElement('span');
delta.className = 'guided-view-chapter-delta';
delta.hidden = true;
@@ -9277,20 +9537,40 @@
stops.hidden = false;
deltaLabel.hidden = true;
button.removeAttribute('data-chapter-delta');
- button.setAttribute('aria-label', 'Current chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + ', ' + views[index].focus.length + ' stops');
- button.title = views[index].label + ' — current chapter, ' + views[index].focus.length + ' stops';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.current', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ count: views[index].focus.length
+ }));
+ button.title = viewerText('viewer.guided.chapter.current.title', {
+ label: views[index].label,
+ count: views[index].focus.length
+ });
} else {
var delta = chapterDelta(activeIndex >= 0 ? views[activeIndex] : null, views[index]);
var compact = '=' + delta.stay.length + ' +' + delta.enter.length + ' \u2212' + delta.leave.length;
- var expanded = delta.stay.length + ' stay, ' + delta.enter.length + ' enter, ' + delta.leave.length + ' leave';
+ var expanded = viewerText('viewer.guided.chapter.delta.expanded', {
+ stay: delta.stay.length,
+ enter: delta.enter.length,
+ leave: delta.leave.length
+ });
stops.hidden = true;
deltaLabel.hidden = false;
deltaLabel.querySelector('[data-delta-kind="stay"]').textContent = '=' + delta.stay.length;
deltaLabel.querySelector('[data-delta-kind="enter"]').textContent = '+' + delta.enter.length;
deltaLabel.querySelector('[data-delta-kind="leave"]').textContent = '\u2212' + delta.leave.length;
button.setAttribute('data-chapter-delta', compact);
- button.setAttribute('aria-label', 'Open chapter ' + (index + 1) + ' of ' + views.length + ': ' + views[index].label + '. Chapter focus delta: ' + expanded);
- button.title = views[index].label + ' — ' + compact + ' chapter focus';
+ button.setAttribute('aria-label', viewerText('viewer.guided.chapter.delta.aria', {
+ index: index + 1,
+ total: views.length,
+ label: views[index].label,
+ delta: expanded
+ }));
+ button.title = viewerText('viewer.guided.chapter.delta.title', {
+ label: views[index].label,
+ delta: compact
+ });
}
if (current) button.setAttribute('aria-current', 'step');
else button.removeAttribute('aria-current');
@@ -9418,33 +9698,44 @@
function shareCueStatus(state) {
return {
- pending: 'Ready',
- playing: 'Playing',
- complete: 'Settled',
- interrupted: 'Paused',
- pinned: 'Pinned',
- 'reduced-motion': 'Still'
- }[state] || 'Ready';
+ pending: viewerText('viewer.guided.state.ready'),
+ playing: viewerText('viewer.guided.state.playing'),
+ complete: viewerText('viewer.guided.state.settled'),
+ interrupted: viewerText('viewer.guided.state.paused'),
+ pinned: viewerText('viewer.guided.state.pinned'),
+ 'reduced-motion': viewerText('viewer.guided.state.still')
+ }[state] || viewerText('viewer.guided.state.ready');
}
function shareCueBeatCopy(state, view, stops) {
var total = stops.length;
var activeStop = storyBeatIndex >= 0 ? stops[storyBeatIndex] : null;
if ((state === 'playing' || state === 'interrupted') && activeStop) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent;
+ return viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ });
}
if (state === 'pinned' && activeStop) {
return storyBeatCopy(storySteps[storyBeatIndex], total);
}
if (state === 'reduced-motion' && activeStop && hashBeatMatchesCurrent()) {
- return 'Step ' + (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1) + ' / ' +
- (total < 10 ? '0' : '') + total + ' · ' + activeStop.textContent + ' · Static moment';
+ return viewerText('viewer.guided.share.staticMoment', {
+ step: viewerText('viewer.guided.share.step', {
+ index: (storyBeatIndex + 1 < 10 ? '0' : '') + (storyBeatIndex + 1),
+ total: (total < 10 ? '0' : '') + total,
+ label: activeStop.textContent
+ })
+ });
}
- if (state === 'complete') return total + ' steps complete · ' + (view.note || 'Path settled for reading.');
- if (state === 'reduced-motion') return total + ' steps · Static path';
- if (state === 'pending') return total + ' steps · Ready';
- return view.note || view.focus.length + ' selected nodes';
+ if (state === 'complete') return viewerText('viewer.guided.share.complete', {
+ count: total,
+ note: view.note || viewerText('viewer.guided.share.settled')
+ });
+ if (state === 'reduced-motion') return viewerText('viewer.guided.share.staticPath', { count: total });
+ if (state === 'pending') return viewerText('viewer.guided.share.ready', { count: total });
+ return view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length });
}
function renderShareCue() {
@@ -9469,11 +9760,21 @@
shareCue.setAttribute('data-state', state);
shareCue.setAttribute('aria-live', state === 'playing' ? 'off' : 'polite');
shareCueState.textContent = shareCueStatus(state);
- shareCueCount.textContent = 'Chapter ' + (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1) + ' / ' + (views.length < 10 ? '0' : '') + views.length;
+ shareCueCount.textContent = viewerText('viewer.guided.share.chapter', {
+ index: (activeIndex + 1 < 10 ? '0' : '') + (activeIndex + 1),
+ total: (views.length < 10 ? '0' : '') + views.length
+ });
shareCueLabel.textContent = view.label;
shareCueNote.textContent = beatCopy;
shareCueRoute.textContent = route;
- shareCue.setAttribute('aria-label', shareCueStatus(state) + ' chapter ' + (activeIndex + 1) + ' of ' + views.length + ': ' + view.label + '. ' + beatCopy + '. ' + route);
+ shareCue.setAttribute('aria-label', viewerText('viewer.guided.share.aria', {
+ state: shareCueStatus(state),
+ index: activeIndex + 1,
+ total: views.length,
+ label: view.label,
+ beat: beatCopy,
+ route: route
+ }));
}
function setShareCueProgress(fraction) {
@@ -9564,24 +9865,24 @@
if (!step) return '';
var position = (step.index + 1 < 10 ? '0' : '') + (step.index + 1);
var countValue = (total < 10 ? '0' : '') + total;
- if (step.relation === 'start') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u00b7 starting point';
- if (step.relation === 'forward') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u2192 ' + step.nodeLabel;
- if (step.relation === 'reverse') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.nodeLabel + ' \u2192 ' + step.previousLabel + ' \u00b7 reverse authored link';
- if (step.relation === 'multiple') return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u21c4 ' + step.nodeLabel + ' \u00b7 ' + step.edges.length + ' authored links';
- return 'Beat ' + position + ' / ' + countValue + ' \u00b7 ' + step.previousLabel + ' \u00b7 ' + step.nodeLabel + ' \u00b7 grouped \u00b7 no direct link';
+ if (step.relation === 'start') return viewerText('viewer.guided.beat.start', { index: position, total: countValue, label: step.nodeLabel });
+ if (step.relation === 'forward') return viewerText('viewer.guided.beat.forward', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'reverse') return viewerText('viewer.guided.beat.reverse', { index: position, total: countValue, from: step.nodeLabel, to: step.previousLabel });
+ if (step.relation === 'multiple') return viewerText('viewer.guided.beat.multiple', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel, count: step.edges.length });
+ return viewerText('viewer.guided.beat.group', { index: position, total: countValue, from: step.previousLabel, to: step.nodeLabel });
}
function storyBeatAria(step, total) {
- var prefix = 'Story beat ' + (step.index + 1) + ' of ' + total + ': ' + step.nodeLabel + '. ';
- if (step.relation === 'start') return prefix + 'Starting point.';
- if (step.relation === 'forward') return prefix + 'From ' + step.previousLabel + ' through one authored forward relationship.';
- if (step.relation === 'reverse') return prefix + 'From ' + step.previousLabel + '; the authored relationship points from ' + step.nodeLabel + ' to ' + step.previousLabel + '.';
- if (step.relation === 'multiple') return prefix + 'From ' + step.previousLabel + ' through ' + step.edges.length + ' authored relationships; shown without arbitrary motion.';
- return prefix + 'Grouped from ' + step.previousLabel + ' with no direct authored relationship.';
+ var prefix = viewerText('viewer.guided.beat.aria.prefix', { index: step.index + 1, total: total, label: step.nodeLabel });
+ if (step.relation === 'start') return prefix + viewerText('viewer.guided.beat.aria.start');
+ if (step.relation === 'forward') return prefix + viewerText('viewer.guided.beat.aria.forward', { from: step.previousLabel });
+ if (step.relation === 'reverse') return prefix + viewerText('viewer.guided.beat.aria.reverse', { from: step.previousLabel, to: step.nodeLabel });
+ if (step.relation === 'multiple') return prefix + viewerText('viewer.guided.beat.aria.multiple', { from: step.previousLabel, count: step.edges.length });
+ return prefix + viewerText('viewer.guided.beat.aria.group', { from: step.previousLabel });
}
function storyCaptionRouteCopy(step) {
- if (step.relation === 'start') return step.nodeLabel + ' · Starting point';
+ if (step.relation === 'start') return step.nodeLabel + ' · ' + viewerText('viewer.guided.caption.start');
if (step.relation === 'reverse') return step.previousLabel + ' ← ' + step.nodeLabel;
if (step.relation === 'multiple') return step.previousLabel + ' ⇄ ' + step.nodeLabel;
if (step.relation === 'group') return step.previousLabel + ' · ' + step.nodeLabel;
@@ -9590,15 +9891,15 @@
function storyCaptionDetailCopy(step) {
var facts = [];
- if (step.relation === 'group') facts.push('Grouped transition · no direct authored link');
- else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? ' +' + (step.edgeLabels.length - 3) + ' more' : ''));
- else if (step.relation === 'reverse') facts.push('Reverse authored relationship');
- else if (step.relation === 'multiple') facts.push(step.edges.length + ' authored relationships');
- else if (step.relation !== 'start') facts.push('Authored relationship');
- if (step.relation === 'reverse') facts.push('authored direction: ' + step.nodeLabel + ' → ' + step.previousLabel);
+ if (step.relation === 'group') facts.push(viewerText('viewer.guided.caption.grouped'));
+ else if (step.edgeLabels.length) facts.push(step.edgeLabels.slice(0, 3).join(' + ') + (step.edgeLabels.length > 3 ? viewerText('viewer.guided.caption.more', { count: step.edgeLabels.length - 3 }) : ''));
+ else if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.reverse'));
+ else if (step.relation === 'multiple') facts.push(viewerText('viewer.guided.caption.relationships', { count: step.edges.length }));
+ else if (step.relation !== 'start') facts.push(viewerText('viewer.guided.caption.relationship'));
+ if (step.relation === 'reverse') facts.push(viewerText('viewer.guided.caption.direction', { from: step.nodeLabel, to: step.previousLabel }));
if (step.responsibility) facts.push(step.responsibility);
if (step.context) facts.push(step.context);
- if (!facts.length) facts.push('Authored starting point');
+ if (!facts.length) facts.push(viewerText('viewer.guided.caption.starting'));
return facts.join(' · ');
}
@@ -9654,17 +9955,17 @@
if (beatLinkFeedbackTimer) clearTimeout(beatLinkFeedbackTimer);
beatLinkFeedbackTimer = null;
beatLink.removeAttribute('data-copy-state');
- beatLinkLabel.textContent = 'Copy moment';
+ beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
}
function syncBeatLink() {
var step = storyBeatIndex >= 0 ? storySteps[storyBeatIndex] : null;
var available = !!(activeIndex >= 0 && step && !currentHandoff);
beatLink.disabled = !available;
- if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = 'Copy moment';
+ if (!beatLink.hasAttribute('data-copy-state')) beatLinkLabel.textContent = viewerText('viewer.guided.copyMoment');
var description = available
- ? 'Copy link to current story moment: Beat ' + (step.index + 1) + ' of ' + storySteps.length + ': ' + step.nodeLabel
- : 'Select a Story Beat to copy its exact link';
+ ? viewerText('viewer.guided.beatLink', { index: step.index + 1, total: storySteps.length, label: step.nodeLabel })
+ : viewerText('viewer.guided.selectBeatLink');
beatLink.setAttribute('aria-label', description);
beatLink.title = description;
}
@@ -9672,8 +9973,8 @@
function setBeatLinkFeedback(copied) {
resetBeatLinkFeedback();
beatLink.setAttribute('data-copy-state', copied ? 'copied' : 'failed');
- beatLinkLabel.textContent = copied ? 'Copied' : 'Copy failed';
- beatLink.setAttribute('aria-label', copied ? 'Moment link copied' : 'Could not copy story moment link');
+ beatLinkLabel.textContent = viewerText(copied ? 'viewer.guided.copied' : 'viewer.guided.copyFailed');
+ beatLink.setAttribute('aria-label', viewerText(copied ? 'viewer.guided.momentCopied' : 'viewer.guided.momentCopyFailed'));
beatLinkFeedbackTimer = setTimeout(function () {
resetBeatLinkFeedback();
syncBeatLink();
@@ -9927,7 +10228,7 @@
stop.removeAttribute('aria-current');
});
note.setAttribute('aria-live', 'polite');
- if (activeIndex >= 0) note.textContent = views[activeIndex].note || views[activeIndex].focus.length + ' selected nodes';
+ if (activeIndex >= 0) note.textContent = views[activeIndex].note || viewerText('viewer.guided.chapter.selectedNodes', { count: views[activeIndex].focus.length });
renderStoryCaption(null, 0);
renderShareCue();
syncBeatLink();
@@ -10006,7 +10307,7 @@
trail.appendChild(stop);
});
trail.hidden = labels.length === 0;
- trail.setAttribute('aria-label', 'Story trail for ' + view.label + ': ' + labels.length + ' beats');
+ trail.setAttribute('aria-label', viewerText('viewer.guided.storyTrail', { label: view.label, count: labels.length }));
trail.scrollLeft = 0;
svg.setAttribute('data-story-active', view.id);
@@ -10085,21 +10386,39 @@
syncStoryPlayback();
play.disabled = !playing && !automaticPlaybackAllowed;
play.setAttribute('aria-pressed', playing ? 'true' : 'false');
- play.setAttribute('aria-label', playing ? 'Pause guided story' : (!automaticPlaybackAllowed ? 'Story playback unavailable while motion is Still' : (storyPlaybackComplete ? 'Replay guided story' : 'Play guided story')));
- play.title = playing ? 'Pause guided story (P)' : (!automaticPlaybackAllowed ? 'Switch motion to Live to play the guided story' : (storyPlaybackComplete ? 'Replay guided story (P)' : 'Play guided story (P)'));
+ play.setAttribute('aria-label', viewerText(playing
+ ? 'viewer.guided.pause'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.motionUnavailable'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay'
+ : 'viewer.guided.play'));
+ play.title = viewerText(playing
+ ? 'viewer.guided.pause.title'
+ : !automaticPlaybackAllowed
+ ? 'viewer.guided.enableMotion'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replay.title'
+ : 'viewer.guided.play.title');
playIcon.textContent = playing ? '\u2016' : '\u25b6';
- playLabel.textContent = playing ? 'Pause' : (storyPlaybackComplete ? 'Replay story' : 'Play story');
+ playLabel.textContent = viewerText(playing
+ ? 'viewer.guided.pauseStory'
+ : storyPlaybackComplete
+ ? 'viewer.guided.replayStory'
+ : 'viewer.guided.playStory');
if (storyCaption && !storyCaption.hidden) storyCaption.setAttribute('aria-live', playing ? 'off' : 'polite');
}
function render() {
var view = views[activeIndex];
count.textContent = activeIndex < 0 ? '0 / ' + views.length : (activeIndex + 1) + ' / ' + views.length;
- label.textContent = view ? view.label : 'Explore this system';
+ label.textContent = view ? view.label : viewerText('viewer.guided.explore');
note.setAttribute('aria-live', storyBeatIndex >= 0 ? 'off' : 'polite');
note.textContent = storyBeatIndex >= 0
? storyBeatCopy(storySteps[storyBeatIndex], storySteps.length)
- : (view ? (view.note || view.focus.length + ' selected nodes') : 'Step through curated paths without changing the source diagram.');
+ : (view
+ ? (view.note || viewerText('viewer.guided.chapter.selectedNodes', { count: view.focus.length }))
+ : viewerText('viewer.guided.intro'));
prev.disabled = activeIndex < 0;
next.disabled = activeIndex >= views.length - 1;
all.disabled = activeIndex < 0;
@@ -10583,6 +10902,46 @@
embed, presentation, print, and non-wide diagrams retain their own
established layout contracts.
============================================================ */
+ Archify.waitForStableLayout = function (options) {
+ options = options || {};
+ var maximumFrames = Math.max(1, Number(options.maximumFrames) || 240);
+ var fontsReady = document.fonts && document.fonts.ready
+ ? document.fonts.ready.catch(function () {})
+ : Promise.resolve();
+ return fontsReady.then(function () {
+ if (typeof options.schedule === 'function') options.schedule();
+ return new Promise(function (resolve, reject) {
+ var previous = '';
+ var stableFrames = 0;
+ var sampledFrames = 0;
+ function sample() {
+ sampledFrames += 1;
+ if (typeof options.pending === 'function' && options.pending()) {
+ previous = '';
+ stableFrames = 0;
+ } else {
+ var current = typeof options.snapshot === 'function' ? options.snapshot() : '';
+ if (current === previous) stableFrames += 1;
+ else {
+ previous = current;
+ stableFrames = 0;
+ }
+ if (stableFrames >= 3) {
+ resolve({ stable: true, snapshot: current, sampledFrames: sampledFrames });
+ return;
+ }
+ }
+ if (sampledFrames >= maximumFrames) {
+ reject(new Error(options.timeoutMessage || 'Layout did not reach stable dimensions.'));
+ return;
+ }
+ requestAnimationFrame(sample);
+ }
+ requestAnimationFrame(sample);
+ });
+ });
+ };
+
Archify.readerLayout = (function () {
var html = document.documentElement;
var body = document.body;
@@ -10702,6 +11061,31 @@
if (frame) return;
frame = requestAnimationFrame(measure);
}
+ function stableSnapshot() {
+ var shellRect = shell ? shell.getBoundingClientRect() : { width: 0, height: 0 };
+ var diagramRect = diagram ? diagram.getBoundingClientRect() : { width: 0, height: 0 };
+ return [
+ lastWidth,
+ html.getAttribute('data-reader-layout') || '',
+ html.getAttribute('data-reader-overflow') || '',
+ Math.ceil(document.documentElement.scrollWidth),
+ Math.ceil(document.documentElement.scrollHeight),
+ Math.ceil(document.body.scrollWidth),
+ Math.ceil(document.body.scrollHeight),
+ Math.round(shellRect.width * 100) / 100,
+ Math.round(shellRect.height * 100) / 100,
+ Math.round(diagramRect.width * 100) / 100,
+ Math.round(diagramRect.height * 100) / 100
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Adaptive reader layout did not reach stable dimensions.'
+ });
+ }
window.addEventListener('resize', schedule, { passive: true });
window.addEventListener('load', schedule, { once: true });
@@ -10721,11 +11105,324 @@
return {
measure: measure,
schedule: schedule,
+ whenStable: whenStable,
active: function () { return html.getAttribute('data-reader-layout') === 'adaptive'; },
receipt: function () { return { ratio: ratio, width: lastWidth }; }
};
})();
+ /* ============================================================
+ Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
+ ============================================================ */
+ Archify.viewerChromeLayout = (function () {
+ var html = document.documentElement;
+ var container = document.querySelector('.diagram-container');
+ var svg = container && container.querySelector(':scope > svg');
+ var nav = container && container.querySelector('.diagram-nav');
+ var legend = svg && svg.querySelector('[data-legend]');
+ var frame = 0;
+ var settleFrame = 0;
+ var reserve = 0;
+ var railLatched = false;
+ var probingBaseline = false;
+ var probePromise = null;
+ var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
+ var lastReceipt = null;
+ var SAFE_GAP = 10;
+
+ function visible(element) {
+ if (!element || element.hidden) return false;
+ var style = window.getComputedStyle(element);
+ return style.display !== 'none' && style.visibility !== 'hidden';
+ }
+ function usable(rect) {
+ return Boolean(rect && rect.width > 0 && rect.height > 0);
+ }
+ function intersectionArea(a, b) {
+ var width = Math.max(0, Math.min(a.right, b.right) - Math.max(a.left, b.left));
+ var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
+ return width * height;
+ }
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
+ function eligible() {
+ return Boolean(
+ container && svg && nav &&
+ window.innerWidth > 720 &&
+ html.getAttribute('data-embed') !== 'true' &&
+ (!window.matchMedia || !window.matchMedia('print').matches) &&
+ visible(nav)
+ );
+ }
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
+ function writeReserve(next, options) {
+ options = options || {};
+ next = Math.max(0, Math.ceil(next));
+ if (Math.abs(next - reserve) < 1) return false;
+ reserve = next;
+ if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
+ container.style.setProperty('--archify-nav-reserve', reserve + 'px');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
+ } else {
+ container.style.removeProperty('--archify-nav-reserve');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
+ }
+ if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
+ Archify.readerLayout.schedule();
+ }
+ if (options.quiet !== true) {
+ if (settleFrame) cancelAnimationFrame(settleFrame);
+ settleFrame = requestAnimationFrame(function () {
+ settleFrame = 0;
+ schedule();
+ });
+ }
+ return true;
+ }
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
+ writeReserve(0, { quiet: probingBaseline });
+ lastReceipt = {
+ eligible: false,
+ active: false,
+ reserve: 0,
+ gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
+ baselineIntersectionArea: 0,
+ intersectionArea: 0
+ };
+ return lastReceipt;
+ }
+ function measure() {
+ frame = 0;
+ if (probingBaseline) return null;
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
+
+ var navRect = nav.getBoundingClientRect();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
+
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
+ baselineIntersectionArea = actualIntersectionArea;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
+ }
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
+ if (writeReserve(reserve + remaining)) return null;
+ }
+
+ navRect = nav.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
+ };
+ return lastReceipt;
+ }
+ function reprobe() {
+ if (probingBaseline) return probePromise || Promise.resolve(false);
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ probeFallbackReserve = restorableReserve || reserve;
+ probingBaseline = true;
+ railLatched = false;
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ writeReserve(0, { quiet: true });
+ var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
+ ? Archify.readerLayout.whenStable().catch(function () {})
+ : Promise.resolve();
+ probePromise = readerReady.then(function () {
+ probingBaseline = false;
+ probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
+ schedule();
+ return true;
+ });
+ return probePromise;
+ }
+ function schedule() {
+ if (frame) return;
+ frame = requestAnimationFrame(measure);
+ }
+ function stableSnapshot() {
+ var containerRect = container ? container.getBoundingClientRect() : { width: 0, height: 0 };
+ var navRect = nav ? nav.getBoundingClientRect() : { top: 0, left: 0 };
+ var legendRect = legend ? legend.getBoundingClientRect() : { top: 0, left: 0 };
+ return [
+ reserve,
+ Math.round(containerRect.width * 100) / 100,
+ Math.round(containerRect.height * 100) / 100,
+ Math.round(navRect.left * 100) / 100,
+ Math.round(navRect.top * 100) / 100,
+ Math.round(legendRect.left * 100) / 100,
+ Math.round(legendRect.top * 100) / 100,
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
+ ].join('|');
+ }
+ function whenStable() {
+ return Archify.waitForStableLayout({
+ schedule: schedule,
+ pending: function () { return Boolean(frame || settleFrame || probingBaseline); },
+ snapshot: stableSnapshot,
+ timeoutMessage: 'Viewer chrome layout did not reach stable dimensions.'
+ });
+ }
+
+ window.addEventListener('resize', reprobe, { passive: true });
+ window.addEventListener('load', schedule, { once: true });
+ window.addEventListener('beforeprint', schedule);
+ window.addEventListener('afterprint', reprobe);
+ if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
+ if (typeof ResizeObserver === 'function') {
+ var resizeObserver = new ResizeObserver(schedule);
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ }
+ if (typeof MutationObserver === 'function') {
+ var contentObserver = new MutationObserver(function (records) {
+ var viewerModeChanged = records.some(function (record) { return record.target === html; });
+ if (viewerModeChanged) reprobe();
+ else schedule();
+ });
+ if (legend) contentObserver.observe(legend, { attributes: true, childList: true, subtree: true });
+ contentObserver.observe(html, {
+ attributes: true,
+ attributeFilter: ['data-embed', 'data-present', 'data-preset', 'data-theme']
+ });
+ }
+ schedule();
+
+ return {
+ measure: measure,
+ schedule: schedule,
+ reprobe: reprobe,
+ whenStable: whenStable,
+ stageRect: protectedStageRect,
+ active: function () { return reserve > 0; },
+ receipt: function () { return lastReceipt || measure(); }
+ };
+ })();
+
Archify.view = (function () {
var container = document.querySelector('.diagram-container');
var svg = container.querySelector('svg');
@@ -10740,6 +11437,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -10801,36 +11499,76 @@
var semantic = state.mode === 'semantic' && state.scale > 1.01;
var detail = detailLevel();
var percent = Math.round(state.scale * 100) + '%';
- var levelLabel = detail === 'map' ? 'MAP ' : detail === 'read' ? 'READ ' : 'FULL ';
+ var levelLabel = viewerText('viewer.nav.level.' + detail);
var detailHint = detail === 'map'
- ? 'Zoom in to reveal relationship labels and node context'
+ ? viewerText('viewer.nav.detail.map')
: detail === 'read'
- ? 'Zoom in again to reveal tags and annotations'
- : 'Full diagram detail';
- var resolvedLevel = (semantic ? 'AUTO ' : levelLabel).trim();
- var showDetailLevel = resolvedLevel !== 'READ';
+ ? viewerText('viewer.nav.detail.read')
+ : viewerText('viewer.nav.detail.full');
+ var resolvedLevel = semantic ? viewerText('viewer.nav.level.auto') : levelLabel;
+ var showDetailLevel = semantic || detail !== 'read';
if (resetDetailLabel) {
resetDetailLabel.textContent = resolvedLevel;
resetDetailLabel.hidden = !showDetailLevel;
}
if (resetPercentLabel) resetPercentLabel.textContent = percent;
resetBtn.toggleAttribute('data-detail-visible', showDetailLevel);
- resetBtn.title = (semantic ? 'Semantic camera active · ' : '') + detailHint + ' · reset view (0)';
- resetBtn.setAttribute('aria-label', detailHint + '. Reset diagram view');
+ resetBtn.title = viewerText('viewer.nav.camera.title', {
+ semantic: semantic ? viewerText('viewer.nav.camera.semantic') : '',
+ hint: detailHint
+ });
+ resetBtn.setAttribute('aria-label', viewerText('viewer.nav.camera', { hint: detailHint }));
resetBtn.setAttribute('data-detail-level', detail);
container.setAttribute('data-detail-level', detail);
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
container.classList.toggle('is-pannable', state.scale > 1);
svg.setAttribute('data-view-scale', String(state.scale));
if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();
+ if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.schedule === 'function') {
+ Archify.viewerChromeLayout.schedule();
+ }
}
function sampleRenderedState() {
var transform = '';
@@ -11221,21 +11959,35 @@
var container = document.querySelector('.diagram-container');
var diagram = container.querySelector(':scope > svg');
var panel = document.getElementById('overview-map');
+ var panelHead = panel.querySelector('.overview-map-head');
var surface = document.getElementById('overview-map-surface');
var status = document.getElementById('overview-map-status');
var trigger = document.getElementById('btn-overview-map');
var closeBtn = document.getElementById('overview-map-close');
+ var expandBtn = document.getElementById('overview-map-expand');
+ var feedback = document.getElementById('overview-map-feedback');
+ var navigation = container.querySelector('.diagram-nav');
+ var passport = document.getElementById('focus-chip');
var namespace = 'http://www.w3.org/2000/svg';
var viewBox = diagram.viewBox && diagram.viewBox.baseVal;
var mapSvg = document.createElementNS(namespace, 'svg');
var nodeLayer = document.createElementNS(namespace, 'g');
var viewport = document.createElementNS(namespace, 'rect');
var nodes = [];
- var drag = null;
+ var viewportDrag = null;
+ var panelDrag = null;
+ var manualPosition = null;
+ var lastPlacement = null;
+ var requestedOpen = false;
+ var passportYielded = false;
+ var passportPreviousAriaHidden = null;
var syncFrame = 0;
+ var spaceRetryTimer = 0;
+ var spaceRetryCount = 0;
+ var placementGap = 16;
mapSvg.setAttribute('role', 'group');
- mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');
+ mapSvg.setAttribute('aria-label', viewerText('viewer.radar.nodes'));
mapSvg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
nodeLayer.setAttribute('class', 'overview-map-nodes');
viewport.setAttribute('class', 'overview-map-viewport');
@@ -11270,63 +12022,301 @@
rect.setAttribute('data-kind', node.getAttribute('data-node-kind') || 'neutral');
rect.setAttribute('tabindex', '0');
rect.setAttribute('role', 'button');
- rect.setAttribute('aria-label', 'Focus ' + nodeLabel(node, id) + ' from Semantic Radar');
+ rect.setAttribute('aria-label', viewerText('viewer.radar.focus', { label: nodeLabel(node, id) }));
nodeLayer.appendChild(rect);
nodes.push({ id: id, node: node, rect: rect });
});
- status.textContent = nodes.length + ' nodes · full map';
+ status.textContent = viewerText('viewer.radar.fullMap', { count: nodes.length });
return true;
}
- function updateDocking() {
- if (panel.hidden) return;
- var containerRect = container.getBoundingClientRect();
- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;
- if (!intersectsWindow) {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
- return;
- }
- var active = diagram.querySelector('[data-focus-selected]');
- var activeRect = active ? active.getBoundingClientRect() : null;
- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);
- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));
- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));
- var topLimit = Math.max(16, containerRect.top + 16);
- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);
- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;
- var panelRight = panelLeft + panel.offsetWidth;
+ function visibleRect(element) {
+ if (!element || element.hidden) return null;
+ var rect = element.getBoundingClientRect();
+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;
+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };
+ }
+ function panelRectAt(position) {
+ return {
+ left: position.left,
+ top: position.top,
+ right: position.left + panel.offsetWidth,
+ bottom: position.top + panel.offsetHeight,
+ width: panel.offsetWidth,
+ height: panel.offsetHeight
+ };
+ }
+ function rectsIntersect(first, second, gap) {
+ gap = Number(gap) || 0;
+ return first.left < second.right + gap &&
+ first.right > second.left - gap &&
+ first.top < second.bottom + gap &&
+ first.bottom > second.top - gap;
+ }
+ function intersectionArea(first, second) {
+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));
+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));
+ return width * height;
+ }
+ function clamp(value, minimum, maximum) {
+ if (maximum < minimum) return minimum;
+ return Math.max(minimum, Math.min(maximum, value));
+ }
+ function placementContext() {
+ var containerRect = visibleRect(container);
+ if (!containerRect) return null;
+ var controlRect = visibleRect(navigation);
+ var left = Math.max(placementGap, containerRect.left + placementGap);
+ var top = Math.max(placementGap, containerRect.top + placementGap);
+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);
+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);
+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);
var lens = document.getElementById('focus-chip');
- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;
- var blockers = [activeRect, lensRect].filter(function (rect) {
- return rect && rect.right > panelLeft && rect.left < panelRight;
- });
- var desiredTop = bottomLimit - panel.offsetHeight;
- var candidates = [desiredTop, topLimit];
- blockers.forEach(function (rect) {
- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);
- });
- var valid = candidates.filter(function (candidate) {
- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;
- return blockers.every(function (rect) {
- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;
- });
+ var lensRect = visibleRect(lens);
+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));
+ var active = diagram.querySelector('[data-focus-selected]');
+ var activeRect = visibleRect(active);
+ return {
+ bounds: { left: left, top: top, right: right, bottom: bottom },
+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),
+ softBlockers: [activeRect].filter(Boolean),
+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'
+ };
+ }
+ function positionIsValid(position, context) {
+ if (!position || !context) return false;
+ var rect = panelRectAt(position);
+ var bounds = context.bounds;
+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;
+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });
+ }
+ function cornerCandidates(context) {
+ var bounds = context.bounds;
+ var left = bounds.left;
+ var right = Math.max(left, bounds.right - panel.offsetWidth);
+ var top = bounds.top;
+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);
+ var preferredLeft = context.preferredSide === 'left' ? left : right;
+ var alternateLeft = context.preferredSide === 'left' ? right : left;
+ return [
+ { left: preferredLeft, top: bottom },
+ { left: alternateLeft, top: bottom },
+ { left: preferredLeft, top: top },
+ { left: alternateLeft, top: top }
+ ].filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function nearbyCandidates(context, reference) {
+ var bounds = context.bounds;
+ var maximumLeft = bounds.right - panel.offsetWidth;
+ var maximumTop = bounds.bottom - panel.offsetHeight;
+ var requested = reference ? {
+ left: clamp(reference.left, bounds.left, maximumLeft),
+ top: clamp(reference.top, bounds.top, maximumTop)
+ } : null;
+ var horizontal = [bounds.left, maximumLeft];
+ var vertical = [bounds.top, maximumTop];
+ if (requested) {
+ horizontal.push(requested.left);
+ vertical.push(requested.top);
+ }
+ context.hardBlockers.forEach(function (blocker) {
+ horizontal.push(
+ blocker.left - placementGap - panel.offsetWidth,
+ blocker.right + placementGap
+ );
+ vertical.push(
+ blocker.top - placementGap - panel.offsetHeight,
+ blocker.bottom + placementGap
+ );
+ });
+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });
+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });
+ var candidates = [];
+ horizontal.forEach(function (left) {
+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });
});
- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });
- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);
- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);
+ return candidates.filter(function (candidate, index, all) {
+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;
+ });
+ }
+ function placementScore(position, context, reference, softWeight) {
+ var rect = panelRectAt(position);
+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);
+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;
+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);
+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);
+ return distance + softOverlap * softWeight;
+ }
+ function chooseRadarPlacement(context, reference, options) {
+ options = options || {};
+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;
+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));
+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });
+ valid.sort(function (first, second) {
+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);
+ });
+ return valid.length ? valid[0] : null;
+ }
+ function applyPlacement(position, remember) {
+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;
panel.setAttribute('data-docked', 'true');
- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');
- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');
- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');
- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');
+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');
+ if (useLeft) {
+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');
+ panel.style.removeProperty('--archify-radar-right');
+ } else {
+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');
+ panel.style.removeProperty('--archify-radar-left');
+ }
+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');
+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };
+ }
+ function resetDockingStyles() {
+ panel.removeAttribute('data-docked');
+ panel.removeAttribute('data-dock-side');
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ panel.style.removeProperty('--archify-radar-right');
+ panel.style.removeProperty('--archify-radar-left');
+ panel.style.removeProperty('--archify-radar-top');
+ }
+ function updateDocking() {
+ var options = arguments[0] || {};
+ if (panel.hidden) return false;
+ if (panelDrag) return true;
+ panel.removeAttribute('data-compact');
+ panel.removeAttribute('data-placement-degraded');
+ panel.removeAttribute('data-placement-invalid');
+ panel.removeAttribute('data-placement-unavailable');
+ panel.removeAttribute('title');
+ panel.style.removeProperty('visibility');
+ var context = placementContext();
+ if (!context) {
+ resetDockingStyles();
+ return false;
+ }
+ var reference = manualPosition || lastPlacement;
+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };
+ var placement = manualPosition && positionIsValid(manualPosition, context)
+ ? manualPosition
+ : chooseRadarPlacement(context, reference, placementOptions);
+ var compact = false;
+ if (!placement && options.allowCompact !== false) {
+ compact = true;
+ panel.setAttribute('data-compact', 'true');
+ panel.setAttribute('data-placement-degraded', 'true');
+ panel.setAttribute('title', viewerText('viewer.radar.compacted'));
+ context = placementContext();
+ placement = chooseRadarPlacement(context, reference, placementOptions);
+ }
+ if (!placement) {
+ resetDockingStyles();
+ panel.setAttribute('data-placement-unavailable', 'true');
+ return false;
+ }
+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };
+ applyPlacement(placement, true);
+ return true;
+ }
+ function clearSpaceRetry() {
+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);
+ spaceRetryTimer = 0;
+ }
+ function yieldPassport() {
+ if (!passport || passport.hidden || passportYielded) return passportYielded;
+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');
+ passportYielded = true;
+ passport.setAttribute('data-radar-yielded', 'true');
+ passport.setAttribute('aria-hidden', 'true');
+ return true;
+ }
+ function restorePassport() {
+ if (!passport || !passportYielded) return;
+ passportYielded = false;
+ passport.removeAttribute('data-radar-yielded');
+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');
+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);
+ passportPreviousAriaHidden = null;
+ }
+ function reflectVisible() {
+ panel.hidden = false;
+ panel.removeAttribute('data-placement-unavailable');
+ trigger.setAttribute('aria-expanded', 'true');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.close'));
+ trigger.title = viewerText('viewer.nav.radar.title');
+ feedback.hidden = true;
+ }
+ function scheduleSpaceRetry() {
+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;
+ spaceRetryCount += 1;
+ spaceRetryTimer = window.setTimeout(function () {
+ spaceRetryTimer = 0;
+ attemptRequestedOpen();
+ }, 60);
+ }
+ function reflectUnavailable() {
+ restorePassport();
+ panel.hidden = true;
+ panel.setAttribute('data-placement-unavailable', 'true');
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.setAttribute('aria-label', viewerText('viewer.radar.cancelWaiting'));
+ trigger.setAttribute('data-radar-space-limited', 'true');
+ trigger.title = viewerText('viewer.radar.needsSpace');
+ feedback.hidden = false;
+ scheduleSpaceRetry();
+ }
+ function attemptRequestedOpen(options) {
+ options = options || {};
+ if (!requestedOpen) return false;
+ panel.hidden = false;
+ if (!updateDocking(options)) {
+ reflectUnavailable();
+ return false;
+ }
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ reflectVisible();
+ sync();
+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();
+ return true;
+ }
+ function expandCompactRadar() {
+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;
+ yieldPassport();
+ if (!updateDocking({ allowCompact: false })) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return false;
+ }
+ }
+ reflectVisible();
+ sync();
+ if (!panel.hasAttribute('data-compact')) surface.focus();
+ return !panel.hasAttribute('data-compact');
}
function syncNow() {
syncFrame = 0;
if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;
- updateDocking();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ if (passportYielded && panel.hasAttribute('data-compact')) {
+ restorePassport();
+ if (!updateDocking()) {
+ reflectUnavailable();
+ return;
+ }
+ }
+ reflectVisible();
var visible = Archify.view.logicalViewport();
if (!visible) return;
viewport.setAttribute('x', String(visible.x));
@@ -11336,9 +12326,11 @@
var full = visible.width >= viewBox.width * 0.98 && visible.height >= viewBox.height * 0.98;
var mobileWide = window.innerWidth <= 720 && container.hasAttribute('data-wide-diagram');
var viewportCopy = full
- ? 'full map'
- : (mobileWide ? Math.round(visible.width / viewBox.width * 100) + '% width' : Math.round(visible.scale * 100) + '% viewport');
- status.textContent = nodes.length + ' nodes · ' + viewportCopy;
+ ? viewerText('viewer.radar.viewport.full')
+ : (mobileWide
+ ? viewerText('viewer.radar.viewport.width', { percent: Math.round(visible.width / viewBox.width * 100) })
+ : viewerText('viewer.radar.viewport.scale', { percent: Math.round(visible.scale * 100) }));
+ status.textContent = viewerText('viewer.radar.status', { count: nodes.length, viewport: viewportCopy });
nodes.forEach(function (item) {
var active = item.node.hasAttribute('data-focus-selected') ||
item.node.getAttribute('data-story-beat-state') === 'active';
@@ -11347,6 +12339,10 @@
});
}
function sync() {
+ if (requestedOpen && panel.hidden) {
+ attemptRequestedOpen();
+ return;
+ }
if (syncFrame) return;
syncFrame = requestAnimationFrame(syncNow);
}
@@ -11357,25 +12353,31 @@
if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {
Archify.semanticLens.close({ restoreFocus: false });
}
- panel.hidden = !next;
- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');
- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');
+ requestedOpen = next;
if (next) {
+ clearSpaceRetry();
+ spaceRetryCount = 0;
build();
- updateDocking();
- sync();
- if (options.focus === true) surface.focus();
+ attemptRequestedOpen(options);
} else {
- panel.removeAttribute('data-docked');
- panel.removeAttribute('data-dock-side');
- panel.style.removeProperty('--archify-radar-right');
- panel.style.removeProperty('--archify-radar-left');
- panel.style.removeProperty('--archify-radar-top');
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ viewportDrag = null;
+ panelDrag = null;
+ container.classList.remove('is-panning');
+ panel.hidden = true;
+ resetDockingStyles();
+ restorePassport();
+ feedback.hidden = true;
+ trigger.setAttribute('aria-expanded', 'false');
+ trigger.removeAttribute('data-radar-space-limited');
+ trigger.setAttribute('aria-label', viewerText('viewer.nav.radar'));
+ trigger.title = viewerText('viewer.nav.radar.title');
if (options.restoreFocus === true) trigger.focus();
}
return next;
}
- function toggle() { return setOpen(panel.hidden, { focus: false }); }
+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }
function close(options) { return setOpen(false, options); }
function bringNodeIntoWindow(node) {
var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;
@@ -11420,31 +12422,91 @@
Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });
sync();
}
- function endDrag(event) {
- if (!drag) return;
- drag = null;
+ function endViewportDrag(event) {
+ if (!viewportDrag) return;
+ viewportDrag = null;
panel.removeAttribute('data-dragging');
container.classList.remove('is-panning');
try { surface.releasePointerCapture(event.pointerId); } catch (_) {}
}
+ function beginPanelDrag(event) {
+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;
+ var context = placementContext();
+ if (!context) return;
+ var rect = panel.getBoundingClientRect();
+ event.preventDefault();
+ event.stopPropagation();
+ panelDrag = {
+ pointerId: event.pointerId,
+ originX: event.clientX,
+ originY: event.clientY,
+ start: { left: rect.left, top: rect.top },
+ current: { left: rect.left, top: rect.top },
+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null
+ };
+ panel.setAttribute('data-panel-dragging', 'true');
+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}
+ }
+ function movePanelDrag(event) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ var context = placementContext();
+ if (!context) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var bounds = context.bounds;
+ var position = {
+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),
+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)
+ };
+ panelDrag.current = position;
+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');
+ else panel.setAttribute('data-placement-invalid', 'true');
+ applyPlacement(position, false);
+ }
+ function finishPanelDrag(event, cancel) {
+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;
+ event.preventDefault();
+ event.stopPropagation();
+ var activeDrag = panelDrag;
+ panelDrag = null;
+ panel.removeAttribute('data-panel-dragging');
+ panel.removeAttribute('data-placement-invalid');
+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}
+ var context = placementContext();
+ if (!context) return;
+ if (cancel) {
+ manualPosition = activeDrag.previousManual;
+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };
+ updateDocking();
+ return;
+ }
+ var requested = activeDrag.current;
+ manualPosition = { left: requested.left, top: requested.top };
+ updateDocking();
+ }
trigger.addEventListener('click', toggle);
closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });
+ expandBtn.addEventListener('click', expandCompactRadar);
+ panelHead.addEventListener('pointerdown', beginPanelDrag);
+ panelHead.addEventListener('pointermove', movePanelDrag);
+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });
+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });
surface.addEventListener('pointerdown', function (event) {
if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;
event.preventDefault();
- drag = { pointerId: event.pointerId };
+ viewportDrag = { pointerId: event.pointerId };
panel.setAttribute('data-dragging', 'true');
container.classList.add('is-panning');
try { surface.setPointerCapture(event.pointerId); } catch (_) {}
navigate(event);
});
surface.addEventListener('pointermove', function (event) {
- if (!drag || drag.pointerId !== event.pointerId) return;
+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;
navigate(event);
});
- surface.addEventListener('pointerup', endDrag);
- surface.addEventListener('pointercancel', endDrag);
+ surface.addEventListener('pointerup', endViewportDrag);
+ surface.addEventListener('pointercancel', endViewportDrag);
surface.addEventListener('click', function (event) {
var node = event.target.closest('[data-radar-node-id]');
if (node) focusNode(node.getAttribute('data-radar-node-id'));
@@ -11477,8 +12539,32 @@
Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });
sync();
});
- window.addEventListener('resize', sync);
- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });
+ document.addEventListener('keydown', function (event) {
+ if (!panelDrag || event.key !== 'Escape') return;
+ finishPanelDrag({
+ pointerId: panelDrag.pointerId,
+ preventDefault: function () { event.preventDefault(); },
+ stopPropagation: function () { event.stopPropagation(); }
+ }, true);
+ }, true);
+ function reflow() {
+ if (!requestedOpen) return;
+ clearSpaceRetry();
+ spaceRetryCount = 0;
+ sync();
+ }
+ window.addEventListener('resize', reflow);
+ window.addEventListener('scroll', reflow, { passive: true });
+ if (typeof ResizeObserver === 'function') {
+ var radarResizeObserver = new ResizeObserver(function (entries) {
+ if (!requestedOpen) return;
+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;
+ reflow();
+ });
+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {
+ radarResizeObserver.observe(element);
+ });
+ }
requestAnimationFrame(build);
return {
@@ -11487,7 +12573,7 @@
toggle: toggle,
sync: sync,
focus: focusNode,
- isOpen: function () { return !panel.hidden; },
+ isOpen: function () { return requestedOpen; },
count: function () { return nodes.length; }
};
})();
@@ -11517,9 +12603,9 @@
function render(next) {
btn.setAttribute('aria-pressed', next ? 'true' : 'false');
- btn.setAttribute('aria-label', next ? 'Exit presentation stage' : 'Enter presentation stage');
- btn.title = next ? 'Exit presentation stage (F or Escape)' : 'Presentation stage (F)';
- label.textContent = next ? 'Exit' : 'Present';
+ btn.setAttribute('aria-label', viewerText(next ? 'viewer.present.exit' : 'viewer.present.enter'));
+ btn.title = viewerText(next ? 'viewer.present.exit.title' : 'viewer.present.enter.title');
+ label.textContent = viewerText(next ? 'viewer.present.exit.label' : 'viewer.present.present');
}
function setActive(next, options) {
@@ -11588,11 +12674,11 @@
function defaultContext() {
return {
kind: 'focus',
- title: 'Find a node',
- placeholder: 'Search labels or IDs',
- empty: 'No matching nodes',
- resultsLabel: 'Diagram nodes',
- availableNoun: 'nodes',
+ title: viewerText('viewer.finder.title'),
+ placeholder: viewerText('viewer.finder.placeholder'),
+ empty: viewerText('viewer.finder.empty'),
+ resultsLabel: viewerText('viewer.finder.results'),
+ availableNoun: viewerText('viewer.finder.noun.nodes'),
allowedIds: null,
badges: null
};
@@ -11717,13 +12803,13 @@
var badge = context.badges && context.badges[item.id]
? context.badges[item.id]
: context.kind === 'focus'
- ? item.links + (item.links === 1 ? ' link' : ' links')
+ ? viewerCount('viewer.finder.link', item.links)
: String(item.links);
var action = context.kind === 'route-source'
- ? 'Choose ' + item.label + ' as route start'
+ ? viewerText('viewer.finder.result.routeStart', { label: item.label })
: context.kind === 'route-target'
- ? 'Choose ' + item.label + ' as route destination, ' + badge
- : 'Focus ' + item.label + ', ' + item.links + ' related connection' + (item.links === 1 ? '' : 's');
+ ? viewerText('viewer.finder.result.routeTarget', { label: item.label, links: badge })
+ : viewerCount('viewer.finder.result.focus', item.links, { label: item.label });
button.setAttribute('aria-label', action);
var name = document.createElement('strong');
@@ -11732,8 +12818,8 @@
links.textContent = badge;
links.title = context.kind === 'focus' ? badge : action;
var meta = document.createElement('small');
- meta.textContent = [item.type, item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
- meta.title = [item.type, item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.textContent = [viewerKindLabel(item.type), item.id, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
+ meta.title = [viewerKindLabel(item.type), item.id, item.context, item.sublabel, item.tag].filter(Boolean).join(' \u00b7 ');
button.appendChild(name);
button.appendChild(links);
button.appendChild(meta);
@@ -11742,8 +12828,12 @@
});
empty.hidden = visibleItems.length !== 0;
status.textContent = query
- ? visibleItems.length + ' of ' + available.length + ' ' + context.availableNoun
- : available.length + ' ' + context.availableNoun;
+ ? viewerText('viewer.finder.status.filtered', {
+ visible: visibleItems.length,
+ available: available.length,
+ noun: context.availableNoun
+ })
+ : viewerText('viewer.finder.status.all', { available: available.length, noun: context.availableNoun });
}
function open(options) {
@@ -12043,7 +13133,11 @@
item.setAttribute('data-route-journey-index', String(index));
item.setAttribute('data-route-node-id', id);
item.setAttribute('tabindex', index === 0 ? '0' : '-1');
- item.setAttribute('aria-label', 'Route position ' + (index + 1) + ' of ' + ids.length + ': ' + nodeLabel(byId[id], id));
+ item.setAttribute('aria-label', viewerText('viewer.route.position', {
+ index: index + 1,
+ total: ids.length,
+ label: nodeLabel(byId[id], id)
+ }));
}
item.className = 'route-probe-node';
item.textContent = nodeLabel(byId[id], id);
@@ -12055,7 +13149,7 @@
}
function setTrigger(active) {
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Clear traced route' : 'Trace a directed route');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.route.trigger.clear' : 'viewer.guide.route.aria'));
}
function clear(options) {
options = options || {};
@@ -12072,14 +13166,14 @@
panel.hidden = true;
panel.setAttribute('data-state', 'idle');
panel.removeAttribute('data-finder-open');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick two semantic nodes on the diagram');
- status.textContent = 'Choose the source, then the destination. Direction matters.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickTwo'));
+ status.textContent = viewerText('viewer.route.instructions');
findBtn.hidden = true;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
- copyBtn.textContent = 'Copy link';
+ copyBtn.textContent = viewerText('viewer.route.copy');
if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();
setTrigger(false);
if (wasActive && options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
@@ -12210,7 +13304,10 @@
!Archify.motionGovernor.isPaused();
}
function routeOverviewStatus() {
- return activeNodeIds.length + ' nodes · ' + activeEdges.length + ' directed hop' + (activeEdges.length === 1 ? '' : 's') + ' · shortest authored route';
+ return viewerText('viewer.route.overview.status', {
+ nodes: viewerCount('viewer.route.overview.node', activeNodeIds.length),
+ hops: viewerCount('viewer.route.overview.hop', activeEdges.length)
+ });
}
function centerJourneyButton(button) {
if (!button) return;
@@ -12240,19 +13337,19 @@
journeyPlayBtn.setAttribute('aria-pressed', journeyPlaying ? 'true' : 'false');
if (journeyPlaying) {
journeyPlayIcon.textContent = '\u275a\u275a';
- journeyPlayLabel.textContent = 'Pause';
- journeyPlayBtn.setAttribute('aria-label', 'Pause route journey');
- journeyPlayBtn.title = 'Pause route journey';
+ journeyPlayLabel.textContent = viewerText('viewer.route.pause.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.pause'));
+ journeyPlayBtn.title = viewerText('viewer.route.pause');
} else if (journeyComplete || journeyIndex === activeNodeIds.length - 1) {
journeyPlayIcon.textContent = '\u21bb';
- journeyPlayLabel.textContent = 'Replay';
- journeyPlayBtn.setAttribute('aria-label', 'Replay route journey');
- journeyPlayBtn.title = canPlay ? 'Replay route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.replay.label');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.replay'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.replay' : 'viewer.route.motionRequired');
} else {
journeyPlayIcon.textContent = '\u25b6';
- journeyPlayLabel.textContent = 'Journey';
- journeyPlayBtn.setAttribute('aria-label', 'Play route journey');
- journeyPlayBtn.title = canPlay ? 'Play route journey' : 'Automatic journey requires Live motion';
+ journeyPlayLabel.textContent = viewerText('viewer.route.journey');
+ journeyPlayBtn.setAttribute('aria-label', viewerText('viewer.route.play'));
+ journeyPlayBtn.title = viewerText(canPlay ? 'viewer.route.play' : 'viewer.route.motionRequired');
}
}
function journeyGeometry(shape) {
@@ -12343,8 +13440,17 @@
else button.removeAttribute('aria-current');
});
if (options.center !== false) centerJourneyButton(buttons[journeyIndex]);
- var phase = journeyPlaying ? 'Playing' : (journeyComplete ? 'Complete' : 'Inspecting');
- status.textContent = 'Step ' + (journeyIndex + 1) + ' of ' + activeNodeIds.length + ' · ' + phase + ' · ' + nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex]);
+ var phase = viewerText(journeyPlaying
+ ? 'viewer.route.phase.playing'
+ : journeyComplete
+ ? 'viewer.route.phase.complete'
+ : 'viewer.route.phase.inspecting');
+ status.textContent = viewerText('viewer.route.step', {
+ index: journeyIndex + 1,
+ total: activeNodeIds.length,
+ phase: phase,
+ label: nodeLabel(byId[activeNodeIds[journeyIndex]], activeNodeIds[journeyIndex])
+ });
if (options.pulse === true && journeyIndex > 0) renderJourneyPulse(activeEdges[journeyIndex - 1]);
if (options.reveal !== false && Archify.view && typeof Archify.view.reveal === 'function') {
Archify.view.reveal(activeNodeIds.slice(Math.max(0, journeyIndex - 1), Math.min(activeNodeIds.length, journeyIndex + 2)), {
@@ -12516,15 +13622,15 @@
});
svg.setAttribute('data-route-picking', 'target');
panel.setAttribute('data-state', 'target');
- title.textContent = 'Choose a destination from ' + nodeLabel(byId[id], id);
+ title.textContent = viewerText('viewer.route.destination', { label: nodeLabel(byId[id], id) });
renderPath([id]);
var count = Math.max(0, Object.keys(reached).length - 1);
status.textContent = count
- ? count + ' directed destination' + (count === 1 ? '' : 's') + ' available. Pick a highlighted node.'
- : 'No outgoing route starts here. Clear and choose another source.';
+ ? viewerCount('viewer.route.destination.count', count)
+ : viewerText('viewer.route.noOutgoing');
findBtn.hidden = false;
- findBtn.textContent = 'Find target';
- findBtn.setAttribute('aria-label', 'Find a reachable route destination');
+ findBtn.textContent = viewerText('viewer.route.destination.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.destination.find.aria'));
requestDocking();
return true;
}
@@ -12556,7 +13662,10 @@
renderPath(result.nodes, { interactive: true });
panel.setAttribute('data-state', 'result');
panel.hidden = false;
- title.textContent = nodeLabel(byId[startId], startId) + ' to ' + nodeLabel(byId[endId], endId);
+ title.textContent = viewerText('viewer.route.result.title', {
+ source: nodeLabel(byId[startId], startId),
+ target: nodeLabel(byId[endId], endId)
+ });
findBtn.hidden = true;
copyBtn.hidden = false;
setTrigger(true);
@@ -12578,15 +13687,18 @@
if (mode !== 'target') return false;
if (id === startId) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'Choose a different destination';
- status.textContent = 'A route needs two distinct semantic nodes.';
+ title.textContent = viewerText('viewer.route.differentDestination');
+ status.textContent = viewerText('viewer.route.distinct');
return false;
}
var result = shortestDirectedPath(startId, id);
if (!result) {
panel.setAttribute('data-state', 'error');
- title.textContent = 'No directed route to ' + nodeLabel(byId[id], id);
- status.textContent = nodeLabel(byId[id], id) + ' is not reachable from ' + nodeLabel(byId[startId], startId) + '. Pick a highlighted destination.';
+ title.textContent = viewerText('viewer.route.unreachable', { label: nodeLabel(byId[id], id) });
+ status.textContent = viewerText('viewer.route.unreachable.detail', {
+ target: nodeLabel(byId[id], id),
+ source: nodeLabel(byId[startId], startId)
+ });
return false;
}
return showResult(result, options);
@@ -12614,12 +13726,12 @@
panel.hidden = false;
panel.setAttribute('data-state', 'source');
svg.setAttribute('data-route-picking', 'source');
- title.textContent = 'Choose a start node';
- renderPlaceholder('Pick a semantic node on the diagram');
- status.textContent = 'Select the source. The next step will reveal only directed destinations.';
+ title.textContent = viewerText('viewer.route.start');
+ renderPlaceholder(viewerText('viewer.route.pickOne'));
+ status.textContent = viewerText('viewer.route.start.instructions');
findBtn.hidden = false;
- findBtn.textContent = 'Find start';
- findBtn.setAttribute('aria-label', 'Find a route start');
+ findBtn.textContent = viewerText('viewer.route.start.find');
+ findBtn.setAttribute('aria-label', viewerText('viewer.route.start.find.aria'));
copyBtn.hidden = true;
setTrigger(true);
if (focused && nodesById()[focused]) chooseStart(focused);
@@ -12646,14 +13758,14 @@
return outgoing[id] && outgoing[id].length;
});
var sourceBadges = {};
- sourceIds.forEach(function (id) { sourceBadges[id] = 'start'; });
+ sourceIds.forEach(function (id) { sourceBadges[id] = viewerText('viewer.route.finder.source.badge'); });
return {
kind: 'route-source',
- title: 'Choose route start',
- placeholder: 'Search route sources',
- empty: 'No matching route sources',
- resultsLabel: 'Nodes that can start a route',
- availableNoun: 'route sources',
+ title: viewerText('viewer.route.finder.source.title'),
+ placeholder: viewerText('viewer.route.finder.source.placeholder'),
+ empty: viewerText('viewer.route.finder.source.empty'),
+ resultsLabel: viewerText('viewer.route.finder.source.results'),
+ availableNoun: viewerText('viewer.route.finder.source.noun'),
allowedIds: sourceIds,
badges: sourceBadges
};
@@ -12663,15 +13775,15 @@
var targetIds = Object.keys(distances).filter(function (id) { return id !== startId && byId[id]; });
var targetBadges = {};
targetIds.forEach(function (id) {
- targetBadges[id] = distances[id] + ' hop' + (distances[id] === 1 ? '' : 's');
+ targetBadges[id] = viewerCount('viewer.route.hop', distances[id]);
});
return {
kind: 'route-target',
- title: 'Destination from ' + nodeLabel(byId[startId], startId),
- placeholder: 'Search reachable destinations',
- empty: 'No matching reachable destinations',
- resultsLabel: 'Reachable route destinations',
- availableNoun: 'reachable destinations',
+ title: viewerText('viewer.route.finder.target.title', { label: nodeLabel(byId[startId], startId) }),
+ placeholder: viewerText('viewer.route.finder.target.placeholder'),
+ empty: viewerText('viewer.route.finder.target.empty'),
+ resultsLabel: viewerText('viewer.route.finder.target.results'),
+ availableNoun: viewerText('viewer.route.finder.target.noun'),
allowedIds: targetIds,
badges: targetBadges
};
@@ -12712,11 +13824,11 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- copyBtn.setAttribute('aria-label', copied ? 'Traced route link copied' : 'Could not copy traced route link');
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ copyBtn.setAttribute('aria-label', viewerText(copied ? 'viewer.route.copy.success' : 'viewer.route.copy.failed'));
window.setTimeout(function () {
- copyBtn.textContent = 'Copy link';
- copyBtn.setAttribute('aria-label', 'Copy link to traced route');
+ copyBtn.textContent = viewerText('viewer.route.copy');
+ copyBtn.setAttribute('aria-label', viewerText('viewer.route.copy.aria'));
}, 1600);
return copied;
});
@@ -12869,12 +13981,6 @@
var finePointerQuery = window.matchMedia ? window.matchMedia('(hover: hover) and (pointer: fine)') : null;
var MAX_LENS_FLOW_EDGES = 24;
- function kindLabel(value) {
- return String(value || 'neutral')
- .replace(/messagebus/gi, 'message bus')
- .replace(/[-_]+/g, ' ')
- .replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
- }
function nodesById() {
var byId = {};
Array.prototype.forEach.call(svg.querySelectorAll('[data-node-id][data-node-kind]'), function (node) {
@@ -12889,7 +13995,7 @@
Object.keys(byId).forEach(function (id) {
var node = byId[id];
var value = node.getAttribute('data-node-kind') || 'neutral';
- var kind = kinds[value] || (kinds[value] = { id: value, label: kindLabel(value), nodes: [] });
+ var kind = kinds[value] || (kinds[value] = { id: value, label: viewerKindLabel(value), nodes: [] });
kind.nodes.push(node);
});
return Object.keys(kinds).map(function (key) { return kinds[key]; }).sort(function (a, b) {
@@ -12993,7 +14099,7 @@
entry.setAttribute('role', 'button');
entry.setAttribute('tabindex', legendEntries.length ? '-1' : '0');
var visibleLabel = entry.getAttribute('data-legend-label') || fact.label;
- entry.setAttribute('aria-label', 'Inspect ' + visibleLabel + ', ' + count + ' node' + (count === 1 ? '' : 's'));
+ entry.setAttribute('aria-label', viewerCount('viewer.lens.legend.inspect', count, { label: visibleLabel }));
entry.setAttribute('aria-pressed', 'false');
entry.setAttribute('aria-haspopup', 'dialog');
entry.setAttribute('aria-controls', 'semantic-lens');
@@ -13002,7 +14108,7 @@
});
if (!legendEntries.length) return false;
legendBridge.setAttribute('role', legendEntries.length >= 3 ? 'toolbar' : 'group');
- legendBridge.setAttribute('aria-label', 'Semantic legend');
+ legendBridge.setAttribute('aria-label', viewerText('viewer.lens.legend'));
syncLegendBridge();
layoutLegendBridge();
try {
@@ -13150,7 +14256,7 @@
button.className = 'semantic-lens-kind';
button.setAttribute('data-kind', kind.id);
button.setAttribute('aria-pressed', selectedKinds.indexOf(kind.id) >= 0 ? 'true' : 'false');
- button.setAttribute('aria-label', kind.label + ', ' + kind.nodes.length + ' node' + (kind.nodes.length === 1 ? '' : 's'));
+ button.setAttribute('aria-label', viewerCount('viewer.lens.kind.count', kind.nodes.length, { label: kind.label }));
button.disabled = selectedKinds.length >= 2 && selectedKinds.indexOf(kind.id) === -1;
var swatch = document.createElement('span');
swatch.className = 'semantic-lens-swatch';
@@ -13176,7 +14282,7 @@
function updateTrigger() {
var active = selectedKinds.length > 0;
trigger.setAttribute('aria-pressed', active ? 'true' : 'false');
- trigger.setAttribute('aria-label', active ? 'Open active semantic lens' : 'Open semantic lens');
+ trigger.setAttribute('aria-label', viewerText(active ? 'viewer.lens.openActive' : 'viewer.lens.open'));
copyBtn.hidden = !active;
syncLegendBridge();
}
@@ -13187,7 +14293,7 @@
}
function dockPanel(byId) {
panel.removeAttribute('data-dock-side');
- if (panel.hidden || !selectedKinds.length || window.innerWidth <= 720) return 'right';
+ if (panel.hidden || window.innerWidth <= 720) return 'right';
var panelRect = panel.getBoundingClientRect();
var containerRect = container.getBoundingClientRect();
if (!panelRect.width || !panelRect.height) return 'right';
@@ -13200,6 +14306,17 @@
var rightCandidate = { left: containerRect.right - 16 - width, right: containerRect.right - 16, top: top, bottom: panelRect.bottom };
var leftScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(leftCandidate, rect); }, 0);
var rightScore = selectedRects.reduce(function (score, rect) { return score + overlapArea(rightCandidate, rect); }, 0);
+ var legend = svg.querySelector('[data-legend]');
+ var nav = container.querySelector('.diagram-nav');
+ var protectedRects = [legend, nav].filter(function (element) {
+ return element && !element.hidden && window.getComputedStyle(element).display !== 'none';
+ }).map(function (element) { return element.getBoundingClientRect(); });
+ leftScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(leftCandidate, rect) * 1000;
+ }, 0);
+ rightScore += protectedRects.reduce(function (score, rect) {
+ return score + overlapArea(rightCandidate, rect) * 1000;
+ }, 0);
var side = leftScore < rightScore ? 'left' : 'right';
panel.setAttribute('data-dock-side', side);
return side;
@@ -13211,7 +14328,7 @@
var nodeKind = {};
Object.keys(byId).forEach(function (id) { nodeKind[id] = byId[id].getAttribute('data-node-kind') || 'neutral'; });
if (!selectedKinds.length) {
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
updateTrigger();
renderKinds();
dockPanel(byId);
@@ -13266,13 +14383,18 @@
renderFlowOverlay(matchedFlow);
if (crossKind) {
var total = forward + reverse;
- status.textContent = kindLabel(selectedKinds[0]) + ' → ' + kindLabel(selectedKinds[1]) + ': ' + forward + ' · ' +
- kindLabel(selectedKinds[1]) + ' → ' + kindLabel(selectedKinds[0]) + ': ' + reverse + ' · ' +
- total + ' direct relationship' + (total === 1 ? '' : 's');
+ status.textContent = viewerCount('viewer.lens.compare', total, {
+ first: viewerKindLabel(selectedKinds[0]),
+ second: viewerKindLabel(selectedKinds[1]),
+ forward: forward,
+ reverse: reverse
+ });
} else {
var nodeCount = collectKinds().filter(function (kind) { return kind.id === selectedKinds[0]; })[0].nodes.length;
- status.textContent = nodeCount + ' ' + kindLabel(selectedKinds[0]) + ' node' + (nodeCount === 1 ? '' : 's') + ' · ' +
- touching + ' touching relationship' + (touching === 1 ? '' : 's') + ' · connected peers remain visible';
+ status.textContent = viewerText('viewer.lens.single', {
+ nodes: viewerCount('viewer.lens.node', nodeCount, { label: viewerKindLabel(selectedKinds[0]) }),
+ relationships: viewerCount('viewer.lens.relationship', touching)
+ });
}
updateTrigger();
renderKinds();
@@ -13345,7 +14467,7 @@
panel.removeAttribute('data-dock-side');
updateTrigger();
renderKinds();
- status.textContent = 'Choose a kind to inspect its nodes and touching relationships.';
+ status.textContent = viewerText('viewer.lens.choose');
if (options.updateUrl !== false) updateHash();
if (options.preserveView !== true && Archify.view && typeof Archify.view.reset === 'function') {
Archify.view.reset({ automatic: true });
@@ -13373,8 +14495,8 @@
? navigator.clipboard.writeText(value).then(function () { return true; }).catch(function () { return fallbackCopy(value); })
: Promise.resolve(fallbackCopy(value));
return copy.then(function (copied) {
- copyBtn.textContent = copied ? 'Copied' : 'Copy failed';
- window.setTimeout(function () { copyBtn.textContent = 'Copy link'; }, 1600);
+ copyBtn.textContent = viewerText(copied ? 'viewer.common.copied' : 'viewer.common.copyFailed');
+ window.setTimeout(function () { copyBtn.textContent = viewerText('viewer.common.copyLink'); }, 1600);
return copied;
});
}
@@ -13546,14 +14668,16 @@
var nodes = svg.querySelectorAll('[data-node-id]').length;
var relationships = relationshipCount();
var views = viewCount();
- stats.textContent = nodes + ' semantic node' + (nodes === 1 ? '' : 's') + ' · ' +
- relationships + ' relationship' + (relationships === 1 ? '' : 's') + ' · ' +
- views + ' guided view' + (views === 1 ? '' : 's');
+ stats.textContent = viewerText('viewer.guide.facts', {
+ nodes: viewerCount('viewer.guide.fact.node', nodes),
+ relationships: viewerCount('viewer.guide.fact.relationship', relationships),
+ views: viewerCount('viewer.guide.fact.view', views)
+ });
storyBtn.disabled = views === 0;
storyBtn.setAttribute('aria-disabled', views === 0 ? 'true' : 'false');
storyCopy.textContent = views
- ? 'Walk ' + views + ' authored chapter' + (views === 1 ? '' : 's') + ' and their real relationships.'
- : 'No authored guided story in this diagram.';
+ ? viewerCount('viewer.guide.story.available', views)
+ : viewerText('viewer.guide.story.unavailable');
}
function actionButtons() {
return Array.prototype.slice.call(actions.querySelectorAll('.diagram-guide-action:not(:disabled)'));
@@ -13564,7 +14688,7 @@
html.removeAttribute('data-guide-open');
routePanel.removeAttribute('data-guide-open');
trigger.setAttribute('aria-expanded', 'false');
- trigger.setAttribute('aria-label', 'Open diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.open'));
feedback.textContent = '';
if (options.restoreFocus !== false) trigger.focus();
return false;
@@ -13587,7 +14711,7 @@
html.setAttribute('data-guide-open', 'true');
routePanel.setAttribute('data-guide-open', 'true');
trigger.setAttribute('aria-expanded', 'true');
- trigger.setAttribute('aria-label', 'Close diagram guide');
+ trigger.setAttribute('aria-label', viewerText('viewer.guide.close'));
feedback.textContent = '';
requestAnimationFrame(function () {
var first = actionButtons()[0];
@@ -13599,7 +14723,7 @@
function execute(action) {
feedback.textContent = '';
if (action === 'story' && !viewCount()) {
- feedback.textContent = 'This diagram has no authored guided story.';
+ feedback.textContent = viewerText('viewer.guide.noStory');
return false;
}
close({ restoreFocus: false });
diff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.html
index 09a5f30b..aaa74306 100644
--- a/examples/sequence-cache-miss-request.html
+++ b/examples/sequence-cache-miss-request.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5971,6 +5978,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6145,6 +6153,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11108,9 +11117,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11121,10 +11130,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11141,26 +11153,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11174,15 +11236,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11191,50 +11261,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11242,6 +11355,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11263,8 +11380,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11283,7 +11400,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11304,6 +11421,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11323,6 +11441,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11408,9 +11527,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11532,9 +11685,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.html
index 924ac0ca..cef9fccf 100644
--- a/examples/web-app-rendered.html
+++ b/examples/web-app-rendered.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5920,6 +5927,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6094,6 +6102,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11057,9 +11066,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11070,10 +11079,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11090,26 +11102,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11123,15 +11185,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11140,50 +11210,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11191,6 +11304,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11212,8 +11329,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11232,7 +11349,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11253,6 +11370,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11272,6 +11390,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11357,9 +11476,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11481,9 +11634,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/examples/web-app.html b/examples/web-app.html
index 924ac0ca..cef9fccf 100644
--- a/examples/web-app.html
+++ b/examples/web-app.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5920,6 +5927,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6094,6 +6102,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11057,9 +11066,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11070,10 +11079,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11090,26 +11102,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11123,15 +11185,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11140,50 +11210,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11191,6 +11304,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11212,8 +11329,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11232,7 +11349,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11253,6 +11370,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11272,6 +11390,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11357,9 +11476,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11481,9 +11634,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.html
index 4baecadc..b5ea59d3 100644
--- a/examples/workflow-agent-tool-call-rendered.html
+++ b/examples/workflow-agent-tool-call-rendered.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5953,6 +5960,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6127,6 +6135,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11090,9 +11099,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11103,10 +11112,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11123,26 +11135,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11156,15 +11218,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11173,50 +11243,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11224,6 +11337,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11245,8 +11362,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11265,7 +11382,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11286,6 +11403,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11305,6 +11423,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11390,9 +11509,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11514,9 +11667,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};
diff --git a/experiments/mco-showcase/mco-runtime.html b/experiments/mco-showcase/mco-runtime.html
index 604e952f..fe4eff8a 100644
--- a/experiments/mco-showcase/mco-runtime.html
+++ b/experiments/mco-showcase/mco-runtime.html
@@ -589,8 +589,10 @@
padding-bottom: calc(0.75rem + var(--archify-nav-reserve));
}
html[data-present="true"]:not([data-embed="true"]) .diagram-container > svg {
- width: 100%;
+ flex: 1 1 auto;
height: 100%;
+ min-height: 0;
+ width: 100%;
min-width: 0;
}
html[data-present="true"]:not([data-embed="true"]) .cards { display: none; }
@@ -2885,6 +2887,11 @@
body { padding-block: 1.25rem; }
.header { margin-bottom: 0.875rem; }
.cards { margin-top: 0.75rem; }
+ html[data-nav-stage-rail="true"] body { padding-block: 0.375rem; }
+ html[data-nav-stage-rail="true"] .header { margin-bottom: 0.5rem; }
+ html[data-nav-stage-rail="true"] .guided-views { margin-bottom: 0.375rem; }
+ html[data-nav-stage-rail="true"] .diagram-container[data-nav-stage-rail="true"] { padding-top: 0.5rem; }
+ html[data-nav-stage-rail="true"] .cards { margin-top: 0.375rem; }
}
html[data-preset="blueprint"] .card {
@@ -5969,6 +5976,7 @@
// View transforms and neighborhood focus are HTML exploration state,
// never part of a downloaded full-diagram artifact.
clone.style.removeProperty('transform');
+ clone.style.removeProperty('clip-path');
clone.removeAttribute('data-view-scale');
clone.removeAttribute('data-focus-active');
clone.removeAttribute('data-reach-active');
@@ -6143,6 +6151,7 @@
!clone.hasAttribute('data-chapter-anchor') &&
!clone.hasAttribute('data-chapter-preview') &&
!clone.style.getPropertyValue('transform') &&
+ !clone.style.getPropertyValue('clip-path') &&
clone.querySelectorAll('[data-story-overlay], [data-story-carrier-overlay], [data-story-carrier-token], [data-story-step], [data-story-beat-state], [data-story-beat-step], [data-chapter-handoff-overlay], [data-chapter-role], [data-chapter-preview-role], [data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
var vb = svg.viewBox.baseVal;
@@ -11106,9 +11115,9 @@
/* ============================================================
Viewer Chrome Layout — keep HTML controls clear of the canonical SVG
- legend without changing authored geometry. The dock keeps its existing
- position unless its zero-reserve position would cover the legend; only
- then does a small bottom safe rail become part of the reader budget.
+ stage without changing authored geometry. The dock keeps its floating
+ appearance while a small bottom stage rail becomes part of the reader
+ budget whenever its zero-reserve position would enter the stage.
============================================================ */
Archify.viewerChromeLayout = (function () {
var html = document.documentElement;
@@ -11119,10 +11128,13 @@
var frame = 0;
var settleFrame = 0;
var reserve = 0;
- var collisionLatched = false;
+ var railLatched = false;
var probingBaseline = false;
var probePromise = null;
var baselineIntersectionArea = 0;
+ var baselineStageGap = null;
+ var restorableReserve = 0;
+ var probeFallbackReserve = 0;
var lastReceipt = null;
var SAFE_GAP = 10;
@@ -11139,26 +11151,76 @@
var height = Math.max(0, Math.min(a.bottom, b.bottom) - Math.max(a.top, b.top));
return width * height;
}
+ function protectedStageRect() {
+ if (!svg) return null;
+ var rect = svg.getBoundingClientRect();
+ var transform = '';
+ try { transform = window.getComputedStyle(svg).transform || ''; } catch (_) {}
+ var scaleX = 1;
+ var scaleY = 1;
+ var translateX = 0;
+ var translateY = 0;
+ var matrix = transform.match(/^matrix\(([^)]+)\)$/);
+ var matrix3d = transform.match(/^matrix3d\(([^)]+)\)$/);
+ if (matrix) {
+ var values = matrix[1].split(',').map(Number);
+ if (values.length === 6 && values.every(Number.isFinite)) {
+ scaleX = Math.abs(values[0]) || 1;
+ scaleY = Math.abs(values[3]) || 1;
+ translateX = values[4];
+ translateY = values[5];
+ }
+ } else if (matrix3d) {
+ var values3d = matrix3d[1].split(',').map(Number);
+ if (values3d.length === 16 && values3d.every(Number.isFinite)) {
+ scaleX = Math.abs(values3d[0]) || 1;
+ scaleY = Math.abs(values3d[5]) || 1;
+ translateX = values3d[12];
+ translateY = values3d[13];
+ }
+ }
+ var width = rect.width / scaleX;
+ var height = rect.height / scaleY;
+ var left = rect.left - translateX;
+ var top = rect.top - translateY;
+ return {
+ x: left,
+ y: top,
+ left: left,
+ top: top,
+ right: left + width,
+ bottom: top + height,
+ width: width,
+ height: height
+ };
+ }
function eligible() {
return Boolean(
- container && svg && nav && legend &&
+ container && svg && nav &&
window.innerWidth > 720 &&
html.getAttribute('data-embed') !== 'true' &&
(!window.matchMedia || !window.matchMedia('print').matches) &&
- visible(nav) && visible(legend)
+ visible(nav)
);
}
+ function cameraAtBaseline() {
+ var scale = Number(svg && svg.getAttribute('data-view-scale'));
+ return !Number.isFinite(scale) || Math.abs(scale - 1) < 0.001;
+ }
function writeReserve(next, options) {
options = options || {};
next = Math.max(0, Math.ceil(next));
if (Math.abs(next - reserve) < 1) return false;
reserve = next;
if (reserve) {
+ if (options.remember !== false) restorableReserve = reserve;
container.style.setProperty('--archify-nav-reserve', reserve + 'px');
- container.setAttribute('data-nav-safe-rail', 'true');
+ container.setAttribute('data-nav-stage-rail', 'true');
+ html.setAttribute('data-nav-stage-rail', 'true');
} else {
container.style.removeProperty('--archify-nav-reserve');
- container.removeAttribute('data-nav-safe-rail');
+ container.removeAttribute('data-nav-stage-rail');
+ html.removeAttribute('data-nav-stage-rail');
}
if (Archify.readerLayout && typeof Archify.readerLayout.schedule === 'function') {
Archify.readerLayout.schedule();
@@ -11172,15 +11234,23 @@
}
return true;
}
- function clear() {
- collisionLatched = false;
- baselineIntersectionArea = 0;
+ function clear(options) {
+ options = options || {};
+ railLatched = false;
+ if (options.preserveBaseline !== true) {
+ baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
+ }
writeReserve(0, { quiet: probingBaseline });
lastReceipt = {
eligible: false,
active: false,
reserve: 0,
gap: SAFE_GAP,
+ baselineStageGap: null,
+ stageGap: null,
+ stageIntersectionArea: 0,
baselineIntersectionArea: 0,
intersectionArea: 0
};
@@ -11189,50 +11259,93 @@
function measure() {
frame = 0;
if (probingBaseline) return null;
- if (!eligible()) return clear();
+ if (!eligible()) return clear({ preserveBaseline: !cameraAtBaseline() });
+
+ /* Camera transforms enlarge and translate authored paint inside the
+ fixed, clipped root SVG viewport. They must not redefine the
+ reader's baseline rail.
+ Restore that baseline after temporary mobile/embed/print states.
+ Camera Reset preserves the established rail while viewport, mode,
+ and content changes remain responsible for baseline reprobes. */
+ if (!cameraAtBaseline()) {
+ if (reserve === 0 && restorableReserve > 0) {
+ if (writeReserve(restorableReserve)) return null;
+ }
+ var cameraNavRect = nav.getBoundingClientRect();
+ var cameraLegendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var cameraStageRect = protectedStageRect();
+ var cameraIntersectionArea = usable(cameraLegendRect) && intersectionArea(cameraNavRect, cameraStageRect) > 0
+ ? intersectionArea(cameraNavRect, cameraLegendRect)
+ : 0;
+ lastReceipt = {
+ eligible: true,
+ active: reserve > 0,
+ reserve: reserve,
+ gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round((cameraNavRect.top - cameraStageRect.bottom) * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(cameraNavRect, cameraStageRect) * 100) / 100,
+ baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
+ intersectionArea: Math.round(cameraIntersectionArea * 100) / 100
+ };
+ return lastReceipt;
+ }
var navRect = nav.getBoundingClientRect();
- var legendRect = legend.getBoundingClientRect();
- var svgRect = svg.getBoundingClientRect();
- if (!usable(navRect) || !usable(legendRect) || !usable(svgRect)) return clear();
+ var legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ var stageRect = protectedStageRect();
+ if (!usable(navRect) || !usable(stageRect)) return clear();
- var actualIntersectionArea = intersectionArea(navRect, legendRect);
- if (!collisionLatched && reserve === 0) {
+ var actualIntersectionArea = usable(legendRect) ? intersectionArea(navRect, legendRect) : 0;
+ var stageGap = navRect.top - stageRect.bottom;
+ if (!railLatched && reserve === 0) {
baselineIntersectionArea = actualIntersectionArea;
- if (actualIntersectionArea > 0) {
- collisionLatched = true;
- if (writeReserve(Math.max(0, svgRect.bottom + SAFE_GAP - navRect.top))) return null;
+ baselineStageGap = stageGap;
+ if (stageGap < SAFE_GAP) {
+ railLatched = true;
+ if (writeReserve(Math.max(0, SAFE_GAP - stageGap))) return null;
}
- } else if (collisionLatched && reserve > 0 && actualIntersectionArea > 0) {
- /* Once zero-reserve geometry proves a collision, keep that decision
- latched while Adaptive Reader incorporates the rail. If the first
- rail is not quite tall enough (notably in Presentation flex
- layout), grow only by the remaining vertical overlap. */
- var remaining = Math.max(1, legendRect.bottom + SAFE_GAP - navRect.top);
+ } else if (railLatched && reserve > 0 && stageGap < SAFE_GAP) {
+ /* Keep the decision latched while Adaptive Reader incorporates the
+ rail. Presentation and rounded layout values can require one
+ bounded follow-up before the full stage gap is established. */
+ var remaining = Math.max(1, SAFE_GAP - stageGap);
if (writeReserve(reserve + remaining)) return null;
}
navRect = nav.getBoundingClientRect();
- legendRect = legend.getBoundingClientRect();
+ legendRect = visible(legend) ? legend.getBoundingClientRect() : null;
+ stageRect = protectedStageRect();
+ stageGap = navRect.top - stageRect.bottom;
lastReceipt = {
eligible: true,
active: reserve > 0,
reserve: reserve,
gap: SAFE_GAP,
+ baselineStageGap: baselineStageGap == null ? null : Math.round(baselineStageGap * 100) / 100,
+ stageGap: Math.round(stageGap * 100) / 100,
+ stageIntersectionArea: Math.round(intersectionArea(navRect, stageRect) * 100) / 100,
baselineIntersectionArea: Math.round(baselineIntersectionArea * 100) / 100,
- intersectionArea: Math.round(intersectionArea(navRect, legendRect) * 100) / 100
+ intersectionArea: Math.round((usable(legendRect) ? intersectionArea(navRect, legendRect) : 0) * 100) / 100
};
return lastReceipt;
}
function reprobe() {
if (probingBaseline) return probePromise || Promise.resolve(false);
- if (!reserve && !collisionLatched) {
+ if (!cameraAtBaseline()) {
+ schedule();
+ return Promise.resolve(false);
+ }
+ if (!reserve && !railLatched && !restorableReserve) {
schedule();
return Promise.resolve(false);
}
+ probeFallbackReserve = restorableReserve || reserve;
probingBaseline = true;
- collisionLatched = false;
+ railLatched = false;
baselineIntersectionArea = 0;
+ baselineStageGap = null;
+ restorableReserve = 0;
writeReserve(0, { quiet: true });
var readerReady = Archify.readerLayout && typeof Archify.readerLayout.whenStable === 'function'
? Archify.readerLayout.whenStable().catch(function () {})
@@ -11240,6 +11353,10 @@
probePromise = readerReady.then(function () {
probingBaseline = false;
probePromise = null;
+ if (!cameraAtBaseline() && probeFallbackReserve > 0) {
+ restorableReserve = probeFallbackReserve;
+ }
+ probeFallbackReserve = 0;
schedule();
return true;
});
@@ -11261,8 +11378,8 @@
Math.round(navRect.top * 100) / 100,
Math.round(legendRect.left * 100) / 100,
Math.round(legendRect.top * 100) / 100,
- collisionLatched ? 'latched' : 'clear',
- lastReceipt ? lastReceipt.intersectionArea : ''
+ railLatched ? 'latched' : 'clear',
+ lastReceipt ? lastReceipt.stageGap : ''
].join('|');
}
function whenStable() {
@@ -11281,7 +11398,7 @@
if (document.fonts && document.fonts.ready) document.fonts.ready.then(reprobe).catch(function () {});
if (typeof ResizeObserver === 'function') {
var resizeObserver = new ResizeObserver(schedule);
- [nav, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
+ [nav, svg, legend].forEach(function (element) { if (element) resizeObserver.observe(element); });
}
if (typeof MutationObserver === 'function') {
var contentObserver = new MutationObserver(function (records) {
@@ -11302,6 +11419,7 @@
schedule: schedule,
reprobe: reprobe,
whenStable: whenStable,
+ stageRect: protectedStageRect,
active: function () { return reserve > 0; },
receipt: function () { return lastReceipt || measure(); }
};
@@ -11321,6 +11439,7 @@
var cameraFrame = null;
var cameraGeneration = 0;
var cameraTransaction = null;
+ var clipFrame = 0;
var resizeFrame = 0;
var autoScrollUntil = 0;
@@ -11406,9 +11525,43 @@
container.setAttribute('data-camera-mode', state.mode);
container.setAttribute('data-camera-indicator', semantic ? 'true' : 'false');
}
+ function clipToViewport(camera) {
+ camera = camera || state;
+ if (camera.scale <= 1.001) {
+ svg.style.removeProperty('clip-path');
+ return;
+ }
+ var width = svg.clientWidth || 1;
+ var height = svg.clientHeight || 1;
+ var scale = camera.scale;
+ var top = Math.max(0, Math.min(height, -camera.y / scale));
+ var left = Math.max(0, Math.min(width, -camera.x / scale));
+ var right = Math.max(0, Math.min(width, width - (width - camera.x) / scale));
+ var bottom = Math.max(0, Math.min(height, height - (height - camera.y) / scale));
+ svg.style.clipPath = 'inset(' + [top, right, bottom, left].map(function (value) {
+ return Math.round(value * 1000) / 1000 + 'px';
+ }).join(' ') + ')';
+ }
+ function cameraSettled(rendered) {
+ return Math.abs(rendered.scale - state.scale) < 0.001 &&
+ Math.abs(rendered.x - state.x) < 0.05 &&
+ Math.abs(rendered.y - state.y) < 0.05;
+ }
+ function syncViewportClip() {
+ if (clipFrame) cancelAnimationFrame(clipFrame);
+ clipFrame = 0;
+ function sample() {
+ clipFrame = 0;
+ var rendered = sampleRenderedState();
+ clipToViewport(rendered);
+ if (!cameraSettled(rendered)) clipFrame = requestAnimationFrame(sample);
+ }
+ sample();
+ }
function apply() {
clamp();
svg.style.transform = 'translate(' + state.x + 'px,' + state.y + 'px) scale(' + state.scale + ')';
+ syncViewportClip();
renderControls();
outBtn.disabled = state.scale <= 1;
inBtn.disabled = state.scale >= 3;
@@ -11530,9 +11683,6 @@
else stopCameraMotion('reset', false);
state = { scale: 1, x: 0, y: 0, mode: 'overview' };
apply();
- if (Archify.viewerChromeLayout && typeof Archify.viewerChromeLayout.reprobe === 'function') {
- Archify.viewerChromeLayout.reprobe();
- }
}
function centerAt(logicalX, logicalY, options) {
options = options || {};