Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
feat: export resolved routes as share cards (#43)
tt-a1i440e16d639ed
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c9758048..6711437f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,6 +5,7 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo## [Unreleased]### Added+- **Route Share Card export.** A resolved Route Probe now reveals one contextual **Export → Route Share Card** item that downloads the exact shortest authored path as a 1200×630 PNG while retaining the complete diagram as dimmed context. The exporter consumes Route Probe's ordered node list and stable edge keys directly, applies only static `data-share-route-*` decoration to a finite canonical clone, and never re-runs pathfinding or carries Journey position, motion overlay, camera, Focus, Lens, or Story state. Clear, unreachable, stale, duplicate, and conflicting snapshots fail closed; five-renderer and parallel-edge browser smoke prove exact route identity, full-context retention, PNG pixels, and Journey-state invariance. The receipt remains `format=share-card`, adds `variant=route`, reports `canonical=false` plus `route-state-clean=true`, and the next ordinary export clears the variant. The first slice is download-only and adds no format, schema, layout, dependency, URL, storage, or mobile product surface.- **Clean Label Gate.** Relationship label masks are now measured against every other authored relationship route across all five typed renderers and again in the final HTML checker. `standard` records sub-2px clearance as an exact warning, while `showcase` rejects sub-4px clearance before write and at delivery with both relationship identities, the hit segment, label rectangle, measured distance, threshold, and supported repair controls. A label's own path fragments remain exempt, but shared source/target fan-out does not hide another route. The one real Event Stream collision moved to a clear authored label position, and Proof Lab now publishes 99/99 checks with zero label-route debt. No auto-layout, route rewrite, schema, viewer, export, dependency, or mobile surface was added.- **Copy Share Card.** The Export menu can now copy the existing canonical 1200×630 Share Card directly as `image/png`, reusing one rasterization promise and preserving the current theme, preset, full-diagram containment, and cleanup contract. A successful clipboard write records the same exact dimensions, bytes, and canonical receipt as download. Unsupported image clipboard APIs disable only the copy action; Share Card download and full-diagram Copy PNG remain unchanged. Real Chrome smoke coverage reads back the copied PNG signature and dimensions without adding a toolbar button, dependency, server, storage, schema, layout, or mobile surface.- **Verified Open.** `archify deliver ... --open` now hands the exact committed absolute HTML path to the native macOS, Linux, or Windows opener only after render, artifact checks, receipt creation, and atomic replacement succeed. The option is off by default, uses bounded argument arrays without shell interpolation, and never runs on a failed delivery. Missing, unsupported, timed-out, or failed openers leave the verified artifact successful, add a truthful `open.status` to the one-object JSON receipt, and print the manual absolute path to stderr. No viewer, server, watcher, dependency, network, storage, schema, renderer, layout, export, or mobile surface was added.diff --git a/README.md b/README.mdindex 5a850e54..8b7c936c 100644--- a/README.md+++ b/README.md@@ -18,7 +18,7 @@ Archify is an agent skill for Claude, Codex CLI, and opencode. It produces a sel- **Three live visual presets** — author a default, then try `classic`, `signal-flow`, or `blueprint` on the same topology- **Explore real topology** — find nodes, inspect relationships, trace routes, compare roles, and play guided stories- **Motion is optional** — output stays static unless `meta.animation: "trace"` is explicitly enabled-- **Portable exports** — create, copy, or download a 1200×630 Share Card; copy PNG; or download PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM+- **Portable exports** — create, copy, or download a 1200×630 Share Card; turn a resolved route into a focused Route Share Card; or export PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM- **Typed and checked** — JSON IR, bundled schema validation, default semantic safety gates, and opt-in composition profiles- **Self-contained output** — one shareable HTML file with no viewer runtime dependency- **Built for agent workflows** — install once, then create and refine diagrams through conversation; optionally open only the verified final artifact@@ -64,6 +64,10 @@ The Export menu copies PNG to the clipboard and downloads static or motion forma+After tracing a route, open **Export → Route Share Card** to download the exact authored path as a 1200×630 PNG while retaining the full diagram for context. It is an optional, download-only Share Card variant; ordinary exports remain canonical.+++Open [`examples/web-app.html`](examples/web-app.html) locally to try the complete viewer.## Quick startdiff --git a/README_EN.md b/README_EN.mdindex 5a850e54..8b7c936c 100644--- a/README_EN.md+++ b/README_EN.md@@ -18,7 +18,7 @@ Archify is an agent skill for Claude, Codex CLI, and opencode. It produces a sel- **Three live visual presets** — author a default, then try `classic`, `signal-flow`, or `blueprint` on the same topology- **Explore real topology** — find nodes, inspect relationships, trace routes, compare roles, and play guided stories- **Motion is optional** — output stays static unless `meta.animation: "trace"` is explicitly enabled-- **Portable exports** — create, copy, or download a 1200×630 Share Card; copy PNG; or download PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM+- **Portable exports** — create, copy, or download a 1200×630 Share Card; turn a resolved route into a focused Route Share Card; or export PNG, JPEG, WebP, dual-theme SVG, and trace-enabled WebM- **Typed and checked** — JSON IR, bundled schema validation, default semantic safety gates, and opt-in composition profiles- **Self-contained output** — one shareable HTML file with no viewer runtime dependency- **Built for agent workflows** — install once, then create and refine diagrams through conversation; optionally open only the verified final artifact@@ -64,6 +64,10 @@ The Export menu copies PNG to the clipboard and downloads static or motion forma+After tracing a route, open **Export → Route Share Card** to download the exact authored path as a 1200×630 PNG while retaining the full diagram for context. It is an optional, download-only Share Card variant; ordinary exports remain canonical.+++Open [`examples/web-app.html`](examples/web-app.html) locally to try the complete viewer.## Quick startdiff --git a/README_ZH.md b/README_ZH.mdindex 3f7a410e..2973c557 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -14,7 +14,7 @@ Archify 是一个可用于 Claude、Codex CLI 和 opencode 的 Agent Skill。它- **三套实时视觉预设** —— 先确定作者默认风格,再在同一拓扑上试穿 `classic`、`signal-flow` 或 `blueprint`- **探索真实拓扑** —— 查找节点、检查关系、探查路径、对比角色、播放引导故事- **动态默认关闭** —— 只有显式设置 `meta.animation: "trace"` 才启用动态-- **便携导出** —— 一键生成、复制或下载 1200×630 Share Card,也可复制 PNG,或下载 PNG / JPEG / WebP / 双主题 SVG / WebM+- **便携导出** —— 一键生成、复制或下载 1200×630 Share Card;把已解析路径导出为聚焦的 Route Share Card;也可导出 PNG / JPEG / WebP / 双主题 SVG / WebM- **Typed + Checked** —— Typed JSON IR、内置 Schema 校验、默认语义安全门禁和可选构图档位- **结果完全独立** —— 一个 HTML 文件即可查看和分享,不依赖 Viewer 服务- **适合 Agent 工作流** —— 安装一次,通过对话持续生成和细调;需要时只打开已经验证的最终成品@@ -60,6 +60,10 @@ Export 菜单支持复制 PNG,并下载静态或动态格式:+路径解析完成后,打开 **Export → Route Share Card**,即可把这条真实有向路径下载为 1200×630 PNG,同时保留完整拓扑作为上下文。它是可选、仅下载的 Share Card 变体;普通导出仍保持 canonical。+++在本地打开 [`examples/web-app.html`](examples/web-app.html),即可体验完整 Viewer。## 快速开始diff --git a/ROADMAP.md b/ROADMAP.mdindex 226e545c..c3478a65 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -1,6 +1,8 @@# Archify Roadmap-As of v2.11.0, the coordinate-stability work has shipped as JSON IR plus typed renderers for architecture, workflow, sequence, data-flow, and lifecycle diagrams. Workflow diagrams now also have phase/group/exception-lane structure, happy-path linting, trace animation, and route-crossing guards. The shared viewer adds deterministic semantic node IDs, optional author-controlled relationship IDs with durable `#relation=` links, a pre-click Intent Trace for exact one-hop traffic, a two-endpoint Route Probe with an inspectable Route Journey over deterministic shortest authored paths, searchable Node Finder navigation, read-only one-hop focus with a renderer-owned Semantic Passport and copyable focus link, a runtime-built Semantic Radar for desktop viewport navigation, bounded typed guided views with a visible Named Chapter Rail, pre-commit Chapter Delta Preview, Shared Anchor Handoff, and path-aware Semantic Story Beats, a reader-controlled Live/Still Motion Governor, share-ready one-shot chapters with a title/route/step/state/progress cue, a viewport-filling Presentation Stage, Semantic Camera framing, pan/zoom, three reader-switchable visual presets, a contain-only 1200×630 Share Card, and browser-native WebM export. A generated Proof Lab publishes 11 live scenario artifacts with their exact sources, three named reader views, 99 artifact checks, and named composition receipts; its preview grid stays static while deliberate proof links play one named chapter once. The landing-page Live Proof Stage promotes three of those generated artifacts into the first bounded motion proof, and the README motion reel carries the same proof-first story onto GitHub without claiming SVG animation support. A question-first scenario guide maps concrete user needs to those 11 bounded recipes across the five modes, with one shared source for CLI and GitHub Pages and direct proof navigation. A unified CLI (`bin/archify.mjs`) wraps guide, render, deliver, validate, check, and examples, with an optional verified post-commit open for interactive local handoff. This file records the design decisions that led there, plus the ideas that were explicitly declined. The original v2.4 / v2.5 backlog (export-scale URL param, color-blind palette, gzip+base64 share links) was considered and dropped — see [Not planned](#not-planned) for the rationale on each.+As of v2.11.0, the coordinate-stability work has shipped as JSON IR plus typed renderers for architecture, workflow, sequence, data-flow, and lifecycle diagrams. Workflow diagrams now also have phase/group/exception-lane structure, happy-path linting, trace animation, and route-crossing guards. The shared viewer adds deterministic semantic node IDs, optional author-controlled relationship IDs with durable `#relation=` links, a pre-click Intent Trace for exact one-hop traffic, a two-endpoint Route Probe with an inspectable Route Journey over deterministic shortest authored paths, searchable Node Finder navigation, read-only one-hop focus with a renderer-owned Semantic Passport and copyable focus link, a runtime-built Semantic Radar for desktop viewport navigation, bounded typed guided views with a visible Named Chapter Rail, pre-commit Chapter Delta Preview, Shared Anchor Handoff, and path-aware Semantic Story Beats, a reader-controlled Live/Still Motion Governor, share-ready one-shot chapters with a title/route/step/state/progress cue, a viewport-filling Presentation Stage, Semantic Camera framing, pan/zoom, three reader-switchable visual presets, a contain-only 1200×630 Share Card, a route-focused 1200×630 Route Share Card variant, and browser-native WebM export. A generated Proof Lab publishes 11 live scenario artifacts with their exact sources, three named reader views, 99 artifact checks, and named composition receipts; its preview grid stays static while deliberate proof links play one named chapter once. The landing-page Live Proof Stage promotes three of those generated artifacts into the first bounded motion proof, and the README motion reel carries the same proof-first story onto GitHub without claiming SVG animation support. A question-first scenario guide maps concrete user needs to those 11 bounded recipes across the five modes, with one shared source for CLI and GitHub Pages and direct proof navigation. A unified CLI (`bin/archify.mjs`) wraps guide, render, deliver, validate, check, and examples, with an optional verified post-commit open for interactive local handoff. This file records the design decisions that led there, plus the ideas that were explicitly declined. The original v2.4 / v2.5 backlog (export-scale URL param, color-blind palette, gzip+base64 share links) was considered and dropped — see [Not planned](#not-planned) for the rationale on each.++The latest sharing slice adds a contextual Route Share Card Export item to a completed Route Probe. It consumes the exact ordered node and stable-edge snapshot already resolved by the viewer, then applies only static `data-share-route-*` decoration to a finite canonical clone before reusing the existing 1200×630 Share Card canvas. The complete diagram remains as dimmed context; Journey position, animation overlays, camera, Focus, Lens, and Story never enter the asset. Clear, unreachable, stale, duplicate, or conflicting state fails closed. Browser smoke now covers all five renderer modes, a parallel authored edge, non-empty PNG pixels, immutable live SVG, and identical route-source fingerprints across Journey positions. The receipt remains `format=share-card`, uses `variant=route`, reports scoped route cleanup rather than claiming canonical output, and is cleared by the next ordinary export. The first slice is download-only and adds no new format, schema, layout, dependency, URL, storage, or mobile surface.The latest stability slice adds Clean Label Gate across all five typed renderers and the final artifact checker. Actual rendered label masks must remain at least 4px from every other relationship route in `showcase`; `standard` records sub-2px clearance as a warning. Diagnostics preserve both relationship identities, exact segment geometry, the label rectangle, measured distance, threshold, and renderer-supported repair controls. The label's own path fragments are exempt, but shared endpoints do not hide another route. One real Event Stream label moved to a clear authored position, Proof Lab reaches 99/99 checks, and no auto-layout, route rewrite, schema, viewer, export, dependency, or mobile surface was added.diff --git a/archify.zip b/archify.zipindex 06903504..def70181 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/SKILL.md b/archify/SKILL.mdindex e4928d0c..8d7c5f8c 100644--- a/archify/SKILL.md+++ b/archify/SKILL.md@@ -16,6 +16,8 @@ Every renderer-backed diagram ships with a factual Diagram Guide for discoveringOffer the optional 1200×630 Share Card PNG when the user asks for a README, release, social, or launch preview. It uses the current theme and visual preset, contains the entire canonical diagram without cropping, and never claims validation; the checked HTML remains the source of any delivery receipt. When the browser supports image clipboard writes, Copy Share Card must reuse that same one-pass canonical PNG; unsupported readers retain the download action.+Route Share Card is a reader-invoked optional export, never a default generation or delivery mode. When the user wants to share an incident path, request chain, dependency route, or PR explanation, offer the choice to resolve a Route Probe and use **Export → Route Share Card**; otherwise keep ordinary Share Card and canonical exports unchanged. The contextual Export item appears only after a real directed route resolves, reuses that exact ordered node and stable-edge snapshot without re-running pathfinding, preserves the full diagram as dimmed context, and downloads one 1200×630 PNG named `<diagram-base>-route-share-card.png`. It remains the shared Share Card seam (`Archify.exportMenu.shareCard({ variant: "route" })`) with `format=share-card` and `variant=route`; clear, unreachable, stale, or conflicting routes must fail closed. The isolated clone may use only static `data-share-route-*` decoration and must not include Journey position, animation overlays, camera, Focus, Lens, or Story state. Do not claim the route variant is canonical. This slice is download-only: do not promise Copy Route Share Card, a new format, schema, layout, dependency, URL, or storage surface.+Reading Depth progressively reveals renderer-owned context and fine detail as the reader zooms, while semantic interactions reveal the exact local facts they need at any scale.Direct Relationship Pin makes every unique compiled relationship directly operable without changing the authored line. Give important `connections`, `edges`, `messages`, `flows`, and `transitions` an optional author-controlled `id` using the normal identifier pattern; IDs must be unique within their relationship collection. The renderer keeps its numeric `data-edge-key` for runtime de-duplication and emits the author identity separately as `data-edge-id`. At runtime, reject conflicting source/target/label/ID metadata and clone only path/line/polyline geometry into one viewer-owned overlay below nodes. Use a transparent 24px non-scaling stroke for hit testing plus a separate dashed focus rail; keep exactly one relationship button at `tabindex="0"` and move roving focus with all Arrow keys, Home, and End. Fine-pointer hover and keyboard focus reuse exact Relationship Preview transiently. Click, tap, Enter, or Space opens the source Semantic Passport and pins the exact existing Lens row. When the relationship has an authored ID, the pin writes `#relation=<id>`, changes the action to `Copy relation`, and restores the same source, target, label, path, and bounded camera after reordering; stale IDs fail closed. An ID-less legacy relationship remains an in-page pin, keeps `Copy node`, and never exposes its numeric key. The same relationship, a true background activation, Clear, or Escape clears it. `aria-pressed` conveys the pin while the source/target/label name stays stable. Touch never waits for hover, nodes win near endpoints, panning never activates a relation, and stronger Focus, Story, Route, Semantic Lens, Chapter, and embed states take priority. Do not add another panel, toolbar action, dependency, storage, or authored geometry. Remove all hit, pin, preview, and pulse state from embed, print, and canonical export; preserve the authored `data-edge-id` as semantic SVG identity.diff --git a/archify/assets/template.html b/archify/assets/template.htmlindex 8a34b4c3..3dae6e61 100644--- a/archify/assets/template.html+++ b/archify/assets/template.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4216,6 +4218,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4375,6 +4398,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4400,6 +4501,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4499,6 +4601,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4518,6 +4627,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4527,9 +4637,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4653,6 +4768,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4660,7 +4783,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4704,24 +4828,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4749,75 +4878,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4827,6 +4979,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5089,10 +5250,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5151,9 +5322,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5187,7 +5359,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5212,8 +5384,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5257,13 +5428,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5279,6 +5481,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5320,6 +5524,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5334,6 +5539,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5345,7 +5553,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9619,7 +9836,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9627,6 +9844,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9775,6 +10040,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10254,6 +10520,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10524,6 +10791,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/archify/test/route-share-card.test.mjs b/archify/test/route-share-card.test.mjsnew file mode 100644index 00000000..d2ffa6f9--- /dev/null+++ b/archify/test/route-share-card.test.mjs@@ -0,0 +1,163 @@+import { test } from 'node:test';+import assert from 'node:assert/strict';+import { execFileSync } from 'node:child_process';+import fs from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { fileURLToPath } from 'node:url';++const __dirname = path.dirname(fileURLToPath(import.meta.url));+const skillRoot = path.resolve(__dirname, '..');+const repoRoot = path.resolve(skillRoot, '..');+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-route-share-card-'));++const CASES = {+ architecture: 'web-app.architecture.json',+ workflow: 'agent-tool-call.workflow.json',+ sequence: 'cache-miss-request.sequence.json',+ dataflow: 'product-analytics.dataflow.json',+ lifecycle: 'agent-run.lifecycle.json',+};++function render(mode, example) {+ const output = path.join(tmp, `${mode}.html`);+ execFileSync(process.execPath, [+ path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),+ path.join(skillRoot, 'examples', example),+ output,+ ]);+ return fs.readFileSync(output, 'utf8');+}++function canonicalSvg(html) {+ return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';+}++test('all five renderers inherit one resolved-only Route Share Card Export item', () => {+ for (const [mode, example] of Object.entries(CASES)) {+ const html = render(mode, example);+ assert.match(html, /data-action="route-share-card"[^>]*hidden disabled[^>]*>Route Share Card[\s\S]*?1200(?:×|×)630 PNG/, mode);+ assert.match(html, /function syncRouteShareItem\(\)/, mode);+ assert.match(html, /routeShareItem\.hidden = !snapshot;/, mode);+ assert.match(html, /routeShareItem\.disabled = !snapshot;/, mode);+ assert.match(html, /\.toolbar \.export-menu button\[hidden\] \{ display: none; \}/, mode);+ assert.doesNotMatch(html, /id="route-probe-share"|class="route-probe-share"/, mode);+ assert.doesNotMatch(canonicalSvg(html), /data-share-route(?:-|=)/, mode);+ }+});++test('Route Share Card menu lifecycle excludes hidden state from keyboard navigation', () => {+ const html = render('workflow', CASES.workflow);+ assert.match(html, /function open\(focusLast\)[\s\S]*?syncRouteShareItem\(\);/);+ assert.match(html, /items\(\)\.filter\(function \(i\) \{ return !i\.hidden && !i\.disabled; \}\)/);+ assert.match(html, /function clear\(options\)[\s\S]*?Archify\.exportMenu\.syncRouteShare\(\)/);+ assert.match(html, /function showResult\(result, options\)[\s\S]*?Archify\.exportMenu\.syncRouteShare\(\)/);+ assert.match(html, /html\[data-embed="true"\] \.toolbar/);+ assert.match(html, /@media print[\s\S]*?\.toolbar/);+});++test('Route Share Card snapshots copy exact resolved node and relationship identity without rerouting', () => {+ const html = render('architecture', CASES.architecture);+ const snapshotBlock = html.match(/function exportSnapshot\(\) \{[\s\S]*?\n \}/)?.[0] || '';+ const geometryBlock = html.match(/function hasDrawableGeometry\(element\) \{[\s\S]*?\n \}/)?.[0] || '';+ assert.match(snapshotBlock, /nodeIds: activeNodeIds\.slice\(\)/);+ assert.match(snapshotBlock, /hops: activeEdges\.length/);+ assert.match(snapshotBlock, /edges: activeEdges\.map\(function \(edge\) \{/);+ assert.match(snapshotBlock, /key: edge\.getAttribute\('data-edge-key'\)/);+ assert.match(snapshotBlock, /seenNodeIds = Object\.create\(null\)/);+ assert.match(snapshotBlock, /seenEdgeKeys = Object\.create\(null\)/);+ assert.match(snapshotBlock, /fragment\.getAttribute\('data-edge-from'\) === activeNodeIds\[index\]/);+ assert.match(snapshotBlock, /drawableFragments = fragments\.filter\(hasDrawableGeometry\)/);+ assert.match(snapshotBlock, /drawableFragments\.length !== 1/);+ assert.match(snapshotBlock, /drawableFragments\[0\] !== edge/);+ assert.match(geometryBlock, /geometry\.getTotalLength/);+ assert.match(geometryBlock, /Number\.isFinite\(length\) && length > 0/);+ assert.match(geometryBlock, /nan\|infinity/i);+ assert.match(html, /exportSnapshot: exportSnapshot/);+ assert.doesNotMatch(snapshotBlock, /shortestDirectedPath|outgoingByNode|reachableFrom|labelAt|nearest/i);+});++test('Route Share Card snapshot fails closed when the resolved DOM becomes stale or conflicting', () => {+ const html = render('workflow', CASES.workflow);+ const snapshotBlock = html.match(/function exportSnapshot\(\) \{[\s\S]*?\n \}/)?.[0] || '';+ assert.match(snapshotBlock, /activeNodeIds\.length < 2/);+ assert.match(snapshotBlock, /activeEdges\.length !== activeNodeIds\.length - 1/);+ assert.match(snapshotBlock, /allNodes\.filter\(function \(node\)/);+ assert.match(snapshotBlock, /!edge \|\| !svg\.contains\(edge\)/);+ assert.match(snapshotBlock, /!edgeKey \|\| seenEdgeKeys\[edgeKey\]/);+ assert.match(snapshotBlock, /!fragments\.every/);+ assert.match(snapshotBlock, /return null/);+});++test('Route variant decorates only a finite canonical clone with dedicated static attributes', () => {+ const html = render('architecture', CASES.architecture);+ const applyBlock = html.match(/function applyRouteSnapshot\(clone, snapshot\) \{[\s\S]*?\n \}/)?.[0] || '';+ assert.match(applyBlock, /snapshot\.edges\.length !== snapshot\.nodeIds\.length - 1/);+ assert.match(applyBlock, /snapshot\.hops !== snapshot\.edges\.length/);+ assert.match(applyBlock, /matchedNodes\.length !== 1/);+ assert.match(applyBlock, /matchedEdges\.every/);+ assert.match(applyBlock, /drawableMatches = matchedEdges\.filter\(hasDrawableGeometry\)/);+ assert.match(applyBlock, /drawableMatches\.length !== 1/);+ assert.match(applyBlock, /data-share-route-match/);+ assert.match(applyBlock, /data-share-route-start/);+ assert.match(applyBlock, /data-share-route-middle/);+ assert.match(applyBlock, /data-share-route-end/);+ assert.match(applyBlock, /clone\.removeAttribute\('data-animation'\)/);+ assert.doesNotMatch(applyBlock, /setAttribute\('data-route-(?:match|step|start|end|active|journey)/);+ assert.match(html, /canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot\(clone, opts\.routeSnapshot\)/);+ assert.match(html, /Number\.isFinite\(vb\.width\)[\s\S]*?vb\.width > 0 && vb\.height > 0/);+ assert.ok(html.indexOf('var canonicalStateClean =') < html.indexOf('applyRouteSnapshot(clone, opts.routeSnapshot)'), 'canonical cleanup must precede route decoration');+});++test('clone-only Route styling retains context and distinguishes start, middle, and end without motion', () => {+ const html = render('dataflow', CASES.dataflow);+ assert.match(html, /svg\[data-share-route\] \[data-node-id\], svg\[data-share-route\] \[data-edge-from\] \{ opacity: 0\.18; \}/);+ assert.match(html, /svg\[data-share-route\] \[data-share-route-match\] \{ opacity: 1; \}/);+ assert.match(html, /data-share-route-start[\s\S]*?stroke-dasharray: 5 3/);+ assert.match(html, /data-share-route-middle[\s\S]*?stroke-width: 2\.2/);+ assert.match(html, /data-share-route-end[\s\S]*?stroke-width: 3\.4/);+ assert.doesNotMatch(html.match(/if \(opts\.routeSnapshot\) \{[\s\S]*?\n \}/)?.[0] || '', /display:\s*none|animation:|filter:|transform:/);+});++test('Route Share Card reuses one 1200x630 variant seam and publishes a truthful receipt', () => {+ const html = render('architecture', CASES.architecture);+ assert.match(html, /function rasterizeShareCard\(options\)/);+ assert.match(html, /options\.variant !== 'route'/);+ assert.match(html, /var snapshot = Archify\.routeProbe && Archify\.routeProbe\.exportSnapshot\(\)/);+ assert.match(html, /renderShareCard\(\{ routeSnapshot: snapshot \}\)/);+ assert.doesNotMatch(html, /function rasterizeRouteShareCard|routeShareCard:/);+ assert.match(html, /var title = titleNode \? titleNode\.textContent : document\.title;/);+ assert.match(html, /'Route: ' \+ routeSnapshot\.source\.label \+ ' → ' \+ routeSnapshot\.target\.label \+ ' · ' \+ routeSnapshot\.hops \+ ' directed hops'/);+ assert.match(html, /recordExportReceipt\('share-card', blob, false, \{ width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT \}, 'route', true\)/);+ assert.match(html, /diagramFilename\(\) \+ '-route-share-card\.png'/);+ assert.match(html, /data-last-export-variant/);+ assert.match(html, /data-last-export-route-state-clean/);+ assert.match(html, /clearExportReceipt\(\);[\s\S]*?var snapshot = Archify\.routeProbe/);+ assert.match(html, /function runExport\(format\)[\s\S]*?clearExportReceipt\(\);/);+ assert.match(html, /var ctx = canvas2dOrThrow\(canvas, 'Share Card'\)/);+});++test('skill and READMEs describe the optional Export variant and show one real card without changing the hero', () => {+ const skill = fs.readFileSync(path.join(skillRoot, 'SKILL.md'), 'utf8');+ assert.match(skill, /Export → Route Share Card/);+ assert.match(skill, /format=share-card/);+ assert.match(skill, /variant=route/);+ assert.match(skill, /data-share-route-\*/);+ assert.match(skill, /download-only/i);++ for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ const text = fs.readFileSync(path.join(repoRoot, readme), 'utf8');+ assert.match(text, /Export → Route Share Card/, readme);+ assert.match(text, /docs\/assets\/archify-route-share-card\.png/, readme);+ }++ const png = fs.readFileSync(path.join(repoRoot, 'docs/assets/archify-route-share-card.png'));+ assert.equal(png.subarray(0, 8).toString('hex'), '89504e470d0a1a0a');+ assert.equal(png.readUInt32BE(16), 1200);+ assert.equal(png.readUInt32BE(20), 630);++ const buildZip = fs.readFileSync(path.join(repoRoot, 'scripts/build-zip.sh'), 'utf8');+ assert.match(buildZip, /--exclude '\.validator-check-\*'/, 'concurrent validator scratch must never leak into archify.zip');+});++process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));diff --git a/archify/test/share-card-export.test.mjs b/archify/test/share-card-export.test.mjsindex 4e9abf01..c717177e 100644--- a/archify/test/share-card-export.test.mjs+++ b/archify/test/share-card-export.test.mjs@@ -40,7 +40,7 @@ test('all five renderers expose one explicit 1200x630 Share Card export', () =>assert.match(html, /Share Card[\s\S]*?1200(?:×|×)630 PNG/, mode);assert.match(html, /var SHARE_CARD_WIDTH = 1200;/, mode);assert.match(html, /var SHARE_CARD_HEIGHT = 630;/, mode);- assert.match(html, /function rasterizeShareCard\(\)/, mode);+ assert.match(html, /function rasterizeShareCard\(options\)/, mode);assert.match(html, /format === 'share-card'/, mode);}});@@ -51,7 +51,12 @@ test('Share Card uses contain-only canonical geometry with fixed safe areas', ()assert.match(html, /var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;/);assert.match(html, /var fit = Math\.min\(availableWidth \/ data\.width, availableHeight \/ data\.height\);/);assert.match(html, /ctx\.drawImage\(img, drawX, drawY, drawWidth, drawHeight\);/);- assert.match(html, /serializeSvg\(sourceScale\)/);+ assert.match(html, /function canvas2dOrThrow\(canvas, label\)/);+ assert.match(html, /2D canvas context unavailable for/);+ assert.match(html, /canvas\.toBlob unavailable for/);+ assert.match(html, /img\.onload = function \(\) \{\s*try \{/);+ assert.match(html, /function rasterizeShareCard\(options\)[\s\S]*?if \(!options\.variant\) return renderShareCard\(\);/);+ assert.match(html, /function renderShareCard\(options\)[\s\S]*?serializeSvg\(sourceScale, \{ routeSnapshot: routeSnapshot \}\)/);assert.match(html, /fitCanvasText\(ctx, title, [^)]+\)/);assert.match(html, /ARCHIFY ·/);assert.doesNotMatch(svgBlock(html), /share-card|Share Card|ARCHIFY ·/);@@ -102,7 +107,8 @@ test('Share Card stays viewer-only and reuses export cleanup instead of source sconst html = render('sequence');assert.match(html, /html\[data-embed="true"\] \.toolbar/);assert.match(html, /@media print[\s\S]*?\.toolbar/);- assert.match(html, /function rasterizeShareCard\(\)[\s\S]*?serializeSvg\(sourceScale\)/);+ assert.match(html, /function rasterizeShareCard\(options\)[\s\S]*?if \(!options\.variant\) return renderShareCard\(\);/);+ assert.match(html, /function renderShareCard\(options\)[\s\S]*?serializeSvg\(sourceScale, \{ routeSnapshot: routeSnapshot \}\)/);assert.match(html, /if \(!data\.canonicalStateClean\) return Promise\.reject\(new Error\('Share Card export could not remove temporary viewer state'\)\);/);assert.match(html, /canonicalStateClean/);assert.doesNotMatch(svgBlock(html), /data-last-export-|data-format="share-card"/);diff --git a/archify/test/webm-artifact.smoke.mjs b/archify/test/webm-artifact.smoke.mjsindex 4d191979..989dce26 100644--- a/archify/test/webm-artifact.smoke.mjs+++ b/archify/test/webm-artifact.smoke.mjs@@ -60,6 +60,79 @@ execFileSync(process.execPath, [sequenceOutput,], { stdio: ['ignore', 'ignore', 'pipe'] });+const routeOutputs = {+ architecture: output,+ sequence: sequenceOutput,+};+for (const [mode, example] of Object.entries({+ workflow: 'agent-tool-call.workflow.json',+ dataflow: 'product-analytics.dataflow.json',+ lifecycle: 'agent-run.lifecycle.json',+})) {+ const rendered = path.join(tmp, `${mode}.html`);+ execFileSync(process.execPath, [+ path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),+ path.join(skillRoot, 'examples', example),+ rendered,+ ], { stdio: ['ignore', 'ignore', 'pipe'] });+ routeOutputs[mode] = rendered;+}++const parallelSource = JSON.parse(JSON.stringify(source));+parallelSource.meta.title = 'Parallel Route Identity';+parallelSource.connections[0].label = '';+parallelSource.connections.splice(1, 0, {+ id: 'users-to-cdn-alternate',+ from: 'users',+ to: 'cdn',+ label: '',+});+const parallelInput = path.join(tmp, 'parallel.architecture.json');+const parallelOutput = path.join(tmp, 'parallel.html');+fs.writeFileSync(parallelInput, JSON.stringify(parallelSource));+execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ parallelInput,+ parallelOutput,+], { stdio: ['ignore', 'ignore', 'pipe'] });++const specialSourceLabel = '入口 <script>window.__routeLabelExecuted = true</script> 汉字 🚀 with an intentionally very long endpoint label';+const specialTargetLabel = '终点服务 ✅ emoji + CJK + a second deliberately long endpoint label for header fitting';+const specialComponents = Array.from({ length: 11 }, (_, index) => ({+ id: index === 0 ? 'Route_Source-01' : index === 10 ? 'Route_Target-10' : `route_step-${index}`,+ type: index === 0 ? 'external' : index === 10 ? 'database' : 'backend',+ label: index === 0 ? specialSourceLabel : index === 10 ? specialTargetLabel : `步骤 ${index} · service_${index} ⚙️`,+ sublabel: `hop ${index}`,+ pos: [40 + index * 820, 280],+ size: [index === 0 || index === 10 ? 780 : 220, 72],+}));+const specialRouteSource = {+ schema_version: 1,+ diagram_type: 'architecture',+ meta: {+ title: '多语言 Route Share Card 🚀 with a deliberately long original diagram title that must fit safely',+ subtitle: 'Ten exact authored hops',+ animation: 'trace',+ },+ components: specialComponents,+ boundaries: [],+ connections: specialComponents.slice(0, -1).map((component, index) => ({+ id: `route_edge-${index + 1}`,+ from: component.id,+ to: specialComponents[index + 1].id,+ label: '',+ })),+ cards: [],+};+const specialRouteInput = path.join(tmp, 'special-route.architecture.json');+const specialRouteOutput = path.join(tmp, 'special-route.html');+fs.writeFileSync(specialRouteInput, JSON.stringify(specialRouteSource));+execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ specialRouteInput,+ specialRouteOutput,+], { stdio: ['ignore', 'ignore', 'pipe'] });+assert.equal(typeof WebSocket, 'function', 'Node.js 22+ is required for the Chrome DevTools smoke harness');function delay(ms) {@@ -308,9 +381,534 @@ try {console.log(`ok ${label} Copy Share Card: ${copiedPayload.size} bytes, image/png, truthful receipt`);}+ async function captureRouteShareCard(file, label, sourceId, targetId, options = {}) {+ await navigateReady(file, '!!(window.Archify && Archify.routeProbe && Archify.exportMenu && Archify.exportMenu.downloadRouteShareCard)', label);+ const routePayload = await withTimeout(evaluate(cdp, sessionId, String.raw`(async function () {+ try {+ window.alert = function (message) { window.__archifyRouteAlert = message; };+ Archify.routeProbe.begin({ source: ${JSON.stringify(sourceId)}, focusNode: false });+ if (!Archify.routeProbe.choose(${JSON.stringify(targetId)}, { updateUrl: false })) {+ throw new Error('route did not resolve');+ }+ var snapshot = Archify.routeProbe.exportSnapshot();+ if (!snapshot) throw new Error('resolved route exposed no export snapshot');+ Archify.exportMenu.syncRouteShare();+ var routeMenuItem = document.querySelector('[data-action="route-share-card"]');+ var menuResolved = !!routeMenuItem && !routeMenuItem.hidden && !routeMenuItem.disabled;+ var svg = document.querySelector('.diagram-container svg');+ var firstEdgeKey = snapshot.edges[0].key;+ var primaryCarrier = Array.from(svg.querySelectorAll('[data-edge-key]')).find(function (element) {+ return element.getAttribute('data-edge-key') === firstEdgeKey && hasDrawableGeometry(element);+ });+ if (!primaryCarrier) throw new Error('route exposed no primary geometry carrier');+ var duplicateCarrier = primaryCarrier.cloneNode(true);+ var duplicateGeometry = /^(path|line|polyline)$/i.test(duplicateCarrier.tagName)+ ? duplicateCarrier+ : duplicateCarrier.querySelector('path, line, polyline');+ if (duplicateGeometry.tagName.toLowerCase() === 'path') {+ duplicateGeometry.setAttribute('d', duplicateGeometry.getAttribute('d') + ' M 0 0 L 1 1');+ }+ svg.appendChild(duplicateCarrier);+ var duplicateGeometryRejected = Archify.routeProbe.exportSnapshot() === null;+ var duplicateExportError = '';+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { duplicateExportError = String(error && error.message || error); }+ duplicateCarrier.remove();+ var primaryGeometry = /^(path|line|polyline)$/i.test(primaryCarrier.tagName)+ ? primaryCarrier+ : primaryCarrier.querySelector('path, line, polyline');+ var geometryAttribute = primaryGeometry.tagName.toLowerCase() === 'path' ? 'd' :+ primaryGeometry.tagName.toLowerCase() === 'polyline' ? 'points' : 'x2';+ var originalGeometry = primaryGeometry.getAttribute(geometryAttribute);+ primaryGeometry.setAttribute(geometryAttribute, '');+ var emptyGeometryRejected = Archify.routeProbe.exportSnapshot() === null;+ var emptyGeometryExportError = '';+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { emptyGeometryExportError = String(error && error.message || error); }+ primaryGeometry.setAttribute(geometryAttribute, originalGeometry);+ await new Promise(function (resolve) {+ requestAnimationFrame(function () { requestAnimationFrame(resolve); });+ });+ function stableLiveSnapshot() {+ var clone = svg.cloneNode(true);+ clone.style.removeProperty('transform');+ clone.removeAttribute('data-view-scale');+ Array.from(clone.querySelectorAll('[data-legend-bridge-runtime]')).forEach(function (element) { element.remove(); });+ return clone.outerHTML;+ }+ var liveBefore = stableLiveSnapshot();+ var captured = [];+ var downloads = [];+ var originalCreateObjectURL = URL.createObjectURL.bind(URL);+ var originalAnchorClick = HTMLAnchorElement.prototype.click;+ var originalFillText = CanvasRenderingContext2D.prototype.fillText;+ var headerMetrics = [];+ URL.createObjectURL = function (blob) {+ if (blob && blob.type && blob.type.indexOf('image/svg+xml') === 0) {+ captured.push(blob.text());+ }+ return originalCreateObjectURL(blob);+ };+ HTMLAnchorElement.prototype.click = function () { downloads.push(this.download); };+ CanvasRenderingContext2D.prototype.fillText = function (text, x, y) {+ if (headerMetrics.length < 2 && (y === 62 || y === 87)) {+ headerMetrics.push({+ y: y,+ text: String(text),+ width: this.measureText(String(text)).width,+ maxWidth: y === 62 ? 798 : 848+ });+ }+ return originalFillText.apply(this, arguments);+ };++ var blob;+ var canonicalBlob;+ var routeReceipt;+ var ordinaryReceipt;+ var routeFingerprints = [];+ try {+ blob = await Archify.exportMenu.downloadRouteShareCard();+ routeReceipt = {+ format: document.documentElement.getAttribute('data-last-export-format'),+ variant: document.documentElement.getAttribute('data-last-export-variant'),+ width: document.documentElement.getAttribute('data-last-export-width'),+ height: document.documentElement.getAttribute('data-last-export-height'),+ canonical: document.documentElement.getAttribute('data-last-export-canonical'),+ routeStateClean: document.documentElement.getAttribute('data-last-export-route-state-clean'),+ error: document.documentElement.getAttribute('data-last-export-error')+ };+ var routeSvgText = captured[0] ? await captured[0] : '';+ function fingerprint(text) {+ var hash = 2166136261;+ for (var index = 0; index < text.length; index++) {+ hash ^= text.charCodeAt(index);+ hash = Math.imul(hash, 16777619);+ }+ return (hash >>> 0).toString(16);+ }+ routeFingerprints.push(fingerprint(routeSvgText));++ if (${JSON.stringify(options.journeyInvariance === true)}) {+ async function captureJourneySource(action) {+ action();+ var captureIndex = captured.length;+ await Archify.exportMenu.shareCard({ variant: 'route' });+ routeFingerprints.push(fingerprint(await captured[captureIndex]));+ }+ await captureJourneySource(function () { Archify.routeProbe.selectJourneyIndex(0); });+ await captureJourneySource(function () { Archify.routeProbe.selectJourneyIndex(Math.floor(snapshot.nodeIds.length / 2)); });+ await captureJourneySource(function () { Archify.routeProbe.selectJourneyIndex(snapshot.nodeIds.length - 1); });+ Archify.routeProbe.showOverview({ reveal: false });+ var started = Archify.routeProbe.playJourney();+ if (!started) throw new Error('Route Journey could not enter playing state for invariance check');+ await captureJourneySource(function () {});+ Archify.routeProbe.pauseJourney({ preserveElapsed: false });+ await captureJourneySource(function () {});+ document.documentElement.setAttribute('data-motion', 'still');+ await captureJourneySource(function () {});+ document.documentElement.setAttribute('data-motion', 'live');+ Archify.routeProbe.showOverview({ reveal: false });+ }++ var toBlobError = '';+ var originalToBlob = HTMLCanvasElement.prototype.toBlob;+ HTMLCanvasElement.prototype.toBlob = function (callback) { callback(null); };+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { toBlobError = String(error && error.message || error); }+ finally { HTMLCanvasElement.prototype.toBlob = originalToBlob; }++ var missingToBlobError = '';+ HTMLCanvasElement.prototype.toBlob = undefined;+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { missingToBlobError = String(error && error.message || error); }+ finally { HTMLCanvasElement.prototype.toBlob = originalToBlob; }++ var missingContextError = '';+ var originalGetContext = HTMLCanvasElement.prototype.getContext;+ HTMLCanvasElement.prototype.getContext = function () { return null; };+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { missingContextError = String(error && error.message || error); }+ finally { HTMLCanvasElement.prototype.getContext = originalGetContext; }++ var imageDecodeError = '';+ var OriginalImage = window.Image;+ function FailingImage() {}+ Object.defineProperty(FailingImage.prototype, 'src', {+ set: function () {+ var instance = this;+ queueMicrotask(function () {+ if (typeof instance.onerror === 'function') instance.onerror(new Event('error'));+ });+ }+ });+ window.Image = FailingImage;+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { imageDecodeError = String(error && error.message || error); }+ finally { window.Image = OriginalImage; }++ var unknownVariantError = '';+ try { await Archify.exportMenu.shareCard({ variant: 'unknown' }); }+ catch (error) { unknownVariantError = String(error && error.message || error); }++ var canonicalIndex = captured.length;+ canonicalBlob = await Archify.exportMenu.shareCard();+ var canonicalSvgText = captured[canonicalIndex] ? await captured[canonicalIndex] : '';+ await Archify.exportMenu.run('share-card');+ ordinaryReceipt = {+ format: document.documentElement.getAttribute('data-last-export-format'),+ variant: document.documentElement.getAttribute('data-last-export-variant'),+ width: document.documentElement.getAttribute('data-last-export-width'),+ height: document.documentElement.getAttribute('data-last-export-height'),+ canonical: document.documentElement.getAttribute('data-last-export-canonical'),+ routeStateClean: document.documentElement.getAttribute('data-last-export-route-state-clean'),+ error: document.documentElement.getAttribute('data-last-export-error')+ };+ var svgDownloadIndex = captured.length;+ await Archify.exportMenu.run('svg');+ var exportedSvgText = captured[svgDownloadIndex] ? await captured[svgDownloadIndex] : '';+ var svgReceipt = {+ format: document.documentElement.getAttribute('data-last-export-format'),+ variant: document.documentElement.getAttribute('data-last-export-variant'),+ canonical: document.documentElement.getAttribute('data-last-export-canonical')+ };+ await Archify.exportMenu.run('png');+ var pngReceipt = {+ format: document.documentElement.getAttribute('data-last-export-format'),+ variant: document.documentElement.getAttribute('data-last-export-variant'),+ canonical: document.documentElement.getAttribute('data-last-export-canonical')+ };++ var parser = new DOMParser();+ var routeSvg = parser.parseFromString(routeSvgText, 'image/svg+xml').documentElement;+ var canonicalSvg = parser.parseFromString(canonicalSvgText, 'image/svg+xml').documentElement;+ var exportedSvg = parser.parseFromString(exportedSvgText, 'image/svg+xml').documentElement;+ var matchedNodeIds = Array.from(routeSvg.querySelectorAll('[data-node-id][data-share-route-match]')).map(function (node) {+ return { id: node.getAttribute('data-node-id'), step: Number(node.getAttribute('data-share-route-step')) };+ }).sort(function (a, b) { return a.step - b.step; }).map(function (item) { return item.id; });+ var edgeSteps = new Map();+ Array.from(routeSvg.querySelectorAll('[data-edge-key][data-share-route-match]')).forEach(function (edge) {+ edgeSteps.set(edge.getAttribute('data-edge-key'), Number(edge.getAttribute('data-share-route-step')));+ });+ var matchedEdgeKeys = Array.from(edgeSteps).sort(function (a, b) { return a[1] - b[1]; }).map(function (entry) { return entry[0]; });+ var expectedEdgeKeys = snapshot.edges.map(function (edge) { return edge.key; });+ var routeNodeIds = Array.from(routeSvg.querySelectorAll('[data-node-id]')).map(function (node) { return node.getAttribute('data-node-id'); }).sort();+ var liveNodeIds = Array.from(svg.querySelectorAll('[data-node-id]')).map(function (node) { return node.getAttribute('data-node-id'); }).sort();+ var routeEdgeKeys = Array.from(new Set(Array.from(routeSvg.querySelectorAll('[data-edge-key]')).map(function (edge) { return edge.getAttribute('data-edge-key'); }))).sort();+ var liveEdgeKeys = Array.from(new Set(Array.from(svg.querySelectorAll('[data-edge-key]')).map(function (edge) { return edge.getAttribute('data-edge-key'); }))).sort();++ var bytes = new Uint8Array(await blob.arrayBuffer());+ var binary = '';+ for (var offset = 0; offset < bytes.length; offset += 32768) {+ binary += String.fromCharCode.apply(null, bytes.subarray(offset, offset + 32768));+ }++ await new Promise(function (resolve) {+ requestAnimationFrame(function () { requestAnimationFrame(resolve); });+ });+ var liveAfter = stableLiveSnapshot();+ var liveUnchanged = liveBefore === liveAfter;+ var liveDiff = '';+ if (!liveUnchanged) {+ var diffIndex = 0;+ while (diffIndex < liveBefore.length && diffIndex < liveAfter.length && liveBefore[diffIndex] === liveAfter[diffIndex]) diffIndex++;+ liveDiff = 'at ' + diffIndex + ': before=' + liveBefore.slice(Math.max(0, diffIndex - 80), diffIndex + 160) ++ ' after=' + liveAfter.slice(Math.max(0, diffIndex - 80), diffIndex + 160);+ }++ var asyncClearIndex = captured.length;+ var asyncClearPromise = Archify.exportMenu.shareCard({ variant: 'route' });+ Archify.routeProbe.clear({ updateUrl: false, preserveView: true });+ var asyncClearBlob = await asyncClearPromise;+ var asyncClearFingerprint = fingerprint(await captured[asyncClearIndex]);+ var hiddenAfterClear = routeMenuItem.hidden && routeMenuItem.disabled &&+ getComputedStyle(routeMenuItem).display === 'none';+ var staleError = '';+ try { await Archify.exportMenu.shareCard({ variant: 'route' }); }+ catch (error) { staleError = String(error && error.message || error); }+ await Archify.exportMenu.downloadRouteShareCard();+ var failedReceipt = {+ format: document.documentElement.getAttribute('data-last-export-format'),+ variant: document.documentElement.getAttribute('data-last-export-variant'),+ errorFormat: document.documentElement.getAttribute('data-last-export-error-format'),+ error: document.documentElement.getAttribute('data-last-export-error')+ };++ return {+ ok: true,+ type: blob.type,+ size: blob.size,+ base64: btoa(binary),+ snapshot: snapshot,+ matchedNodeIds: matchedNodeIds,+ matchedEdgeKeys: matchedEdgeKeys,+ expectedEdgeKeys: expectedEdgeKeys,+ routeShare: routeSvg.hasAttribute('data-share-route'),+ routeLiveResidue: routeSvg.querySelectorAll('[data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length,+ routeMotionResidue: (routeSvg.hasAttribute('data-animation') ? 1 : 0) + routeSvg.querySelectorAll('[data-animate]').length,+ routeNodeIds: routeNodeIds,+ liveNodeIds: liveNodeIds,+ routeEdgeKeys: routeEdgeKeys,+ liveEdgeKeys: liveEdgeKeys,+ canonicalRouteResidue: canonicalSvg.querySelectorAll('[data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]').length,+ canonicalRouteActive: canonicalSvg.hasAttribute('data-route-active') || canonicalSvg.hasAttribute('data-share-route'),+ canonicalSize: canonicalBlob.size,+ liveUnchanged: liveUnchanged,+ liveDiff: liveDiff,+ menuResolved: menuResolved,+ duplicateGeometryRejected: duplicateGeometryRejected,+ duplicateExportError: duplicateExportError,+ emptyGeometryRejected: emptyGeometryRejected,+ emptyGeometryExportError: emptyGeometryExportError,+ toBlobError: toBlobError,+ missingToBlobError: missingToBlobError,+ missingContextError: missingContextError,+ imageDecodeError: imageDecodeError,+ unknownVariantError: unknownVariantError,+ headerMetrics: headerMetrics,+ routeLabelExecuted: !!window.__routeLabelExecuted,+ svgReceipt: svgReceipt,+ pngReceipt: pngReceipt,+ exportedSvgRouteResidue: exportedSvg.hasAttribute('data-route-active') ||+ exportedSvg.hasAttribute('data-share-route') ||+ exportedSvg.querySelectorAll('[data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]').length > 0,+ exportedSvgDualTheme: /prefers-color-scheme:\s*light/.test(Array.from(exportedSvg.querySelectorAll('style')).map(function (style) { return style.textContent; }).join('\n')),+ asyncClearStable: asyncClearBlob && asyncClearBlob.type === 'image/png' && asyncClearFingerprint === routeFingerprints[0],+ hiddenAfterClear: hiddenAfterClear,+ staleSnapshot: Archify.routeProbe.exportSnapshot(),+ staleError: staleError,+ routeFingerprints: routeFingerprints,+ downloads: downloads,+ routeReceipt: routeReceipt,+ ordinaryReceipt: ordinaryReceipt,+ failedReceipt: failedReceipt+ };+ } finally {+ URL.createObjectURL = originalCreateObjectURL;+ HTMLAnchorElement.prototype.click = originalAnchorClick;+ CanvasRenderingContext2D.prototype.fillText = originalFillText;+ }+ } catch (error) {+ return { ok: false, error: String(error && error.message || error) };+ }+ })()`, true), 25_000, `${label} Route Card export`);++ assert.equal(routePayload?.ok, true, routePayload?.error || `${label} Route Card export failed`);+ assert.equal(routePayload.type, 'image/png');+ assert.ok(routePayload.size > 20_000, `${label} Route Card is unexpectedly small (${routePayload.size} bytes)`);+ const png = Buffer.from(routePayload.base64, 'base64');+ assert.equal(png.subarray(0, 8).toString('hex'), '89504e470d0a1a0a', `${label} Route Card is not a PNG`);+ assert.equal(png.readUInt32BE(16), 1200, `${label} Route Card width`);+ assert.equal(png.readUInt32BE(20), 630, `${label} Route Card height`);+ const pngPath = path.join(tmp, `${label}.route-share-card.png`);+ fs.writeFileSync(pngPath, png);+ const sampledPixels = execFileSync(ffmpeg, [+ '-v', 'error',+ '-i', pngPath,+ '-vf', 'scale=120:63',+ '-frames:v', '1',+ '-f', 'rawvideo',+ '-pix_fmt', 'rgb24',+ '-',+ ], { maxBuffer: 4 * 1024 * 1024 });+ const sampledColors = new Set();+ for (let offset = 0; offset < sampledPixels.length; offset += 3) {+ sampledColors.add(sampledPixels.subarray(offset, offset + 3).toString('hex'));+ }+ assert.ok(sampledColors.size >= 20, `${label} Route Card has only ${sampledColors.size} sampled colors`);+ assert.equal(routePayload.routeShare, true);+ assert.deepEqual(routePayload.matchedNodeIds, routePayload.snapshot.nodeIds);+ assert.deepEqual(routePayload.matchedEdgeKeys, routePayload.expectedEdgeKeys);+ assert.equal(routePayload.routeLiveResidue, 0);+ assert.equal(routePayload.routeMotionResidue, 0);+ assert.deepEqual(routePayload.routeNodeIds, routePayload.liveNodeIds);+ assert.deepEqual(routePayload.routeEdgeKeys, routePayload.liveEdgeKeys);+ assert.equal(routePayload.canonicalRouteResidue, 0);+ assert.equal(routePayload.canonicalRouteActive, false);+ assert.equal(routePayload.liveUnchanged, true, routePayload.liveDiff);+ assert.equal(routePayload.menuResolved, true);+ assert.equal(routePayload.duplicateGeometryRejected, true);+ assert.match(routePayload.duplicateExportError, /Trace a route before exporting a Route Share Card/);+ assert.equal(routePayload.emptyGeometryRejected, true);+ assert.match(routePayload.emptyGeometryExportError, /Trace a route before exporting a Route Share Card/);+ assert.match(routePayload.toBlobError, /toBlob returned null for Share Card/);+ assert.match(routePayload.missingToBlobError, /canvas\.toBlob unavailable for Share Card/);+ assert.match(routePayload.missingContextError, /2D canvas context unavailable for Share Card/);+ assert.ok(routePayload.imageDecodeError);+ assert.match(routePayload.unknownVariantError, /Unknown Share Card variant: unknown/);+ assert.equal(routePayload.routeLabelExecuted, false);+ assert.deepEqual(routePayload.headerMetrics.map((metric) => metric.y), [62, 87]);+ assert.ok(routePayload.headerMetrics.every((metric) => metric.width <= metric.maxWidth + 0.5), `${label} title/subtitle overflowed the Share Card header`);+ assert.deepEqual(routePayload.svgReceipt, { format: 'svg', variant: null, canonical: 'true' });+ assert.deepEqual(routePayload.pngReceipt, { format: 'png', variant: null, canonical: 'true' });+ assert.equal(routePayload.exportedSvgRouteResidue, false);+ assert.equal(routePayload.exportedSvgDualTheme, true);+ assert.equal(routePayload.asyncClearStable, true);+ assert.equal(routePayload.hiddenAfterClear, true);+ assert.equal(routePayload.staleSnapshot, null);+ assert.match(routePayload.staleError, /Trace a route before exporting a Route Share Card/);+ assert.ok(routePayload.routeFingerprints.every((fingerprint) => fingerprint === routePayload.routeFingerprints[0]), `${label} Route source changed across Journey state`);+ assert.match(routePayload.downloads[0], /-route-share-card\.png$/);+ assert.doesNotMatch(routePayload.downloads[0], /-route-.+-to-.+\.png$/);+ assert.deepEqual(routePayload.routeReceipt, {+ format: 'share-card',+ variant: 'route',+ width: '1200',+ height: '630',+ canonical: 'false',+ routeStateClean: 'true',+ error: null,+ });+ assert.deepEqual(routePayload.ordinaryReceipt, {+ format: 'share-card',+ variant: null,+ width: '1200',+ height: '630',+ canonical: 'true',+ routeStateClean: null,+ error: null,+ });+ assert.equal(routePayload.failedReceipt.format, null);+ assert.equal(routePayload.failedReceipt.variant, null);+ assert.equal(routePayload.failedReceipt.errorFormat, 'share-card');+ assert.match(routePayload.failedReceipt.error, /Trace a route before exporting a Route Share Card/);+ if (options.expectedHops !== undefined) assert.equal(routePayload.snapshot.hops, options.expectedHops);+ if (options.expectedSourceLabel !== undefined) assert.equal(routePayload.snapshot.source.label, options.expectedSourceLabel);+ if (options.expectedTargetLabel !== undefined) assert.equal(routePayload.snapshot.target.label, options.expectedTargetLabel);+ console.log(`ok ${label} Route Card: ${routePayload.size} bytes, ${routePayload.snapshot.nodeIds.length} nodes, ${routePayload.snapshot.edges.length} exact hops`);+ }++ async function verifyDynamicReducedMotionRoute(file, label, sourceId, targetId) {+ await cdp.send('Emulation.setEmulatedMedia', {+ features: [{ name: 'prefers-reduced-motion', value: 'no-preference' }],+ }, sessionId);+ await navigateReady(file, '!!(window.Archify && Archify.routeProbe && Archify.exportMenu && Archify.motionGovernor)', label);++ async function sourceFingerprint() {+ return withTimeout(evaluate(cdp, sessionId, String.raw`(async function () {+ var originalCreateObjectURL = URL.createObjectURL.bind(URL);+ var sourcePromise = null;+ URL.createObjectURL = function (blob) {+ if (!sourcePromise && blob && blob.type && blob.type.indexOf('image/svg+xml') === 0) sourcePromise = blob.text();+ return originalCreateObjectURL(blob);+ };+ try {+ await Archify.exportMenu.shareCard({ variant: 'route' });+ var source = await sourcePromise;+ var hash = 2166136261;+ for (var index = 0; index < source.length; index++) {+ hash ^= source.charCodeAt(index);+ hash = Math.imul(hash, 16777619);+ }+ return (hash >>> 0).toString(16);+ } finally {+ URL.createObjectURL = originalCreateObjectURL;+ }+ })()`, true), 10_000, `${label} source fingerprint`);+ }++ const setup = await evaluate(cdp, sessionId, `(function () {+ Archify.routeProbe.begin({ source: ${JSON.stringify(sourceId)}, focusNode: false });+ if (!Archify.routeProbe.choose(${JSON.stringify(targetId)}, { updateUrl: false })) return { resolved: false };+ Archify.routeProbe.showOverview({ reveal: false });+ return {+ resolved: true,+ started: Archify.routeProbe.playJourney(),+ playing: Archify.routeProbe.isJourneyPlaying(),+ motion: document.documentElement.getAttribute('data-motion')+ };+ })()`);+ assert.deepEqual(setup, { resolved: true, started: true, playing: true, motion: 'live' });+ const before = await sourceFingerprint();++ await cdp.send('Emulation.setEmulatedMedia', {+ features: [{ name: 'prefers-reduced-motion', value: 'reduce' }],+ }, sessionId);+ let reduced = null;+ for (let attempt = 0; attempt < 50; attempt += 1) {+ reduced = await evaluate(cdp, sessionId, `({+ matches: matchMedia('(prefers-reduced-motion: reduce)').matches,+ motion: document.documentElement.getAttribute('data-motion'),+ playing: Archify.routeProbe.isJourneyPlaying()+ })`);+ if (reduced.matches && reduced.motion === 'still' && !reduced.playing) break;+ await delay(20);+ }+ assert.deepEqual(reduced, { matches: true, motion: 'still', playing: false });+ const after = await sourceFingerprint();+ assert.equal(after, before, `${label} source changed after dynamic reduced-motion paused Journey`);++ await cdp.send('Emulation.setEmulatedMedia', {+ features: [{ name: 'prefers-reduced-motion', value: 'no-preference' }],+ }, sessionId);+ console.log(`ok ${label}: dynamic reduced-motion paused Journey without changing Route Card source`);+ }++ async function captureRouteVisualMatrix(file, label, sourceId, targetId) {+ await navigateReady(file, '!!(window.Archify && Archify.preset && Archify.routeProbe && Archify.exportMenu)', label);+ const matrix = await withTimeout(evaluate(cdp, sessionId, String.raw`(async function () {+ Archify.routeProbe.begin({ source: ${JSON.stringify(sourceId)}, focusNode: false });+ if (!Archify.routeProbe.choose(${JSON.stringify(targetId)}, { updateUrl: false })) {+ throw new Error('route did not resolve');+ }+ var identity = JSON.stringify(Archify.routeProbe.exportSnapshot());+ var results = [];+ for (var preset of ['classic', 'signal-flow', 'blueprint']) {+ if (!Archify.preset.apply(preset)) throw new Error('could not apply preset ' + preset);+ for (var theme of ['dark', 'light']) {+ document.documentElement.setAttribute('data-theme', theme);+ var blob = await Archify.exportMenu.shareCard({ variant: 'route' });+ var bytes = new Uint8Array(await blob.arrayBuffer());+ var hash = 2166136261;+ for (var index = 0; index < bytes.length; index++) {+ hash ^= bytes[index];+ hash = Math.imul(hash, 16777619);+ }+ var view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);+ results.push({+ preset: preset,+ theme: theme,+ type: blob.type,+ size: blob.size,+ width: view.getUint32(16),+ height: view.getUint32(20),+ hash: (hash >>> 0).toString(16),+ identity: JSON.stringify(Archify.routeProbe.exportSnapshot())+ });+ }+ }+ return { identity: identity, results: results };+ })()`, true), 20_000, `${label} Route visual matrix`);++ assert.equal(matrix.results.length, 6);+ for (const result of matrix.results) {+ assert.equal(result.type, 'image/png', `${label} ${result.preset}/${result.theme} MIME`);+ assert.equal(result.width, 1200, `${label} ${result.preset}/${result.theme} width`);+ assert.equal(result.height, 630, `${label} ${result.preset}/${result.theme} height`);+ assert.ok(result.size > 20_000, `${label} ${result.preset}/${result.theme} is unexpectedly small`);+ assert.equal(result.identity, matrix.identity, `${label} ${result.preset}/${result.theme} changed route identity`);+ }+ assert.equal(new Set(matrix.results.map((result) => result.hash)).size, 6, `${label} presets/themes should produce six distinct PNGs`);+ console.log(`ok ${label} Route visual matrix: Classic/Flow/Blueprint x dark/light`);+ }+await captureShareCard(output, 'architecture-wide');await captureShareCard(sequenceOutput, 'sequence-tall');await captureCopiedShareCard(output, 'architecture-wide');+ await captureRouteShareCard(routeOutputs.architecture, 'architecture-route', 'users', 'api', { journeyInvariance: true });+ await captureRouteShareCard(routeOutputs.workflow, 'workflow-route', 'user', 'approval');+ await captureRouteShareCard(routeOutputs.sequence, 'sequence-route', 'web', 'db');+ await captureRouteShareCard(routeOutputs.dataflow, 'dataflow-route', 'web', 'dashboard');+ await captureRouteShareCard(routeOutputs.lifecycle, 'lifecycle-route', 'executing', 'cancelled');+ await captureRouteShareCard(parallelOutput, 'parallel-route', 'users', 'cdn');+ await captureRouteShareCard(specialRouteOutput, 'special-10-hop-route', 'Route_Source-01', 'Route_Target-10', {+ expectedHops: 10,+ expectedSourceLabel: specialSourceLabel,+ expectedTargetLabel: specialTargetLabel,+ });+ await captureRouteVisualMatrix(routeOutputs.architecture, 'architecture-route', 'users', 'api');+ await captureRouteVisualMatrix(routeOutputs.sequence, 'sequence-route', 'web', 'db');+ await verifyDynamicReducedMotionRoute(routeOutputs.architecture, 'architecture-route reduced motion', 'users', 'api');await navigateReady(output, '!!(window.Archify && Archify.motion && Archify.motion.canRecord())', 'motion artifact');const payload = await withTimeout(evaluate(cdp, sessionId, String.raw`(async function () {diff --git a/docs/assets/archify-live-proof.gif b/docs/assets/archify-live-proof.gifindex 29396877..d7d135dd 100644Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differdiff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.jsonindex bf5b31b2..31c1a939 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": 1581484,- "sha256": "93c2e964cba9ab73fbc6f418b782135a3f3e7011450717d17458e24063049c52",+ "bytes": 1716211,+ "sha256": "20f166488d793c2c8a33c61df4efb72c2c02cdb1bcaa4fa023660abc7db281e8","scenes": [{"id": "signal-flow","artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",- "artifactSha256": "194692a1cbc60fdc69862e3cf68facd67472f5cce317b0b473c1c78f2a16330b",+ "artifactSha256": "f1bf4782d842acbf2664e43d9fa8ee4057c50230f3f53909a6ea964fc9e004d2","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": "7827b34ca8cee86c4448dd8738c55a60f56640ff12d8217d9d1c45afff4468a0",+ "artifactSha256": "33bd34438d45401740511e221193425c7e1dd65954c980971bff2ddd98c35a43","view": "request-boundary","eyebrow": "ARCHITECTURE · BLUEPRINT","title": "Production Deployment",@@ -31,7 +31,7 @@{"id": "classic","artifact": "docs/gallery/artifacts/cache-miss.sequence.html",- "artifactSha256": "a695f636f38a595ed8b3e76942bc07cbea6455ae4b066b005131645ed0c482dc",+ "artifactSha256": "25f3fa31218706b9265fcb450515a2f1a6b3f1273ff999cf2919b2e9e77d41a0","view": "cache-fallback","eyebrow": "SEQUENCE · CLASSIC","title": "Cache Miss Request",diff --git a/docs/assets/archify-route-share-card.png b/docs/assets/archify-route-share-card.pngnew file mode 100644index 00000000..ffcec13aBinary files /dev/null and b/docs/assets/archify-route-share-card.png differdiff --git a/docs/gallery.html b/docs/gallery.htmlindex 9e284c86..7ee1e997 100644--- a/docs/gallery.html+++ b/docs/gallery.html@@ -324,7 +324,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="194692a1cbc60fdc69862e3cf68facd67472f5cce317b0b473c1c78f2a16330b">194692a1cbc6</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f1bf4782d842acbf2664e43d9fa8ee4057c50230f3f53909a6ea964fc9e004d2">f1bf4782d842</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-tool-call.workflow.html?present=1&play=1#view=happy-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -352,7 +352,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="7827b34ca8cee86c4448dd8738c55a60f56640ff12d8217d9d1c45afff4468a0">7827b34ca8ce</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="33bd34438d45401740511e221193425c7e1dd65954c980971bff2ddd98c35a43">33bd34438d45</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/production-deployment.architecture.html?present=1&play=1#view=request-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -380,7 +380,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="a695f636f38a595ed8b3e76942bc07cbea6455ae4b066b005131645ed0c482dc">a695f636f38a</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="25f3fa31218706b9265fcb450515a2f1a6b3f1273ff999cf2919b2e9e77d41a0">25f3fa312187</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/cache-miss.sequence.html?present=1&play=1#view=cache-fallback" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -408,7 +408,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="5cf4cd7ebaa73d42ec6dac441234736f111f75a29f3de077ffe956cd0aa71791">5cf4cd7ebaa7</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f4a2de28083430d769d0297920dab009db1416034a9e57936675157e6b4caca3">f4a2de280834</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/release-delivery.workflow.html?present=1&play=1#view=approval-to-production" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -436,7 +436,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="5bdb76d9cacbda597f50f466601983d635da5ac9168f25f91df110a81ec67237">5bdb76d9cacb</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="2af31a34467ffbaf2f91675a1aff15a5d7e1d386d0031066ad83ef2ea4684b25">2af31a34467f</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/incident-response.workflow.html?present=1&play=1#view=mitigate-and-verify" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -464,7 +464,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="c29e59f0b5516a49bb3c5e146d202b30c565990c61c76df1387cf777d67d2f80">c29e59f0b551</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="b8ef06a1441f6d2bf3a612ddc0c231305ce32d96fd91df8a798dfea54598f640">b8ef06a1441f</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/product-analytics.dataflow.html?present=1&play=1#view=consent-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -492,7 +492,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="3fcefeff29ac56a83b3a1574ba58b70da8be3dbfaea0eb0d565ef24930ec95c0">3fcefeff29ac</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="d3578494a7a1f3e5de435af2dcac3ee4f7ad991033412b27d59370ac85648007">d3578494a7a1</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/async-job-roundtrip.sequence.html?present=1&play=1#view=work-and-retry" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -520,7 +520,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="c5d4c203813461384f8151ed15b7331bafbd7f1c287a7345ffaeafba955314cb">c5d4c2038134</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="464235b1e3c2ecf21a00ad6c7776e70be95bc4ef80f6a3548954e54bb76b6a6b">464235b1e3c2</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/event-stream.dataflow.html?present=1&play=1#view=order-transit" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -548,7 +548,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 · 5E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="7b169efec1693b1885a88b384934ad46b91d649d2d99b98787c5c17b8696ff94">7b169efec169</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="b3adca83348c60ea79a06cac371e9e8f9d1c924c9fe3e497dde469ebdef0ee88">b3adca83348c</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html?present=1&play=1#view=main-lifecycle" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -576,7 +576,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="11c330d90bb690c4b94fd678e7d81fd0737ea0491c5ef290617426fb496919ea">11c330d90bb6</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="6da6fa280bf61646929eba0e219f20f081ab0c3c68f627a5f2e955e7b711fbc7">6da6fa280bf6</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html?present=1&play=1#view=rollback-outcomes" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -604,7 +604,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="5b8368b97a3941f483ee41ad0cf96b37157a11c9b7a9e870d9ba3c249dae8092">5b8368b97a39</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="1bd46fe5b72adf7a0e786ca3694bd3276c73caa093b8904f20ce22fb5b954754">1bd46fe5b72a</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/web-app.architecture.html?present=1&play=1#view=request-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -681,8 +681,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 12,"edgeCount": 11,- "artifactBytes": 539659,- "artifactSha256": "194692a1cbc60fdc69862e3cf68facd67472f5cce317b0b473c1c78f2a16330b",+ "artifactBytes": 554432,+ "artifactSha256": "f1bf4782d842acbf2664e43d9fa8ee4057c50230f3f53909a6ea964fc9e004d2","sourceBytes": 6470,"sourceSha256": "a3afc6b30044eb256aa15c6195ddfbbcd1a14880d99967ed5605bc621ffb7e5f","checks": [@@ -778,8 +778,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 538815,- "artifactSha256": "7827b34ca8cee86c4448dd8738c55a60f56640ff12d8217d9d1c45afff4468a0",+ "artifactBytes": 553588,+ "artifactSha256": "33bd34438d45401740511e221193425c7e1dd65954c980971bff2ddd98c35a43","sourceBytes": 5308,"sourceSha256": "c3c4ddc8fd8910d8d2bcf2ba97434017d6fa347eb4ee436d2fb519dd0f27c814","checks": [@@ -875,8 +875,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 7,"edgeCount": 12,- "artifactBytes": 533306,- "artifactSha256": "a695f636f38a595ed8b3e76942bc07cbea6455ae4b066b005131645ed0c482dc",+ "artifactBytes": 548079,+ "artifactSha256": "25f3fa31218706b9265fcb450515a2f1a6b3f1273ff999cf2919b2e9e77d41a0","sourceBytes": 4442,"sourceSha256": "30098d81006a18813bab447da698edf74604a1463770f01dc056b0af8cb314ef","checks": [@@ -972,8 +972,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 10,"edgeCount": 10,- "artifactBytes": 535925,- "artifactSha256": "5cf4cd7ebaa73d42ec6dac441234736f111f75a29f3de077ffe956cd0aa71791",+ "artifactBytes": 550698,+ "artifactSha256": "f4a2de28083430d769d0297920dab009db1416034a9e57936675157e6b4caca3","sourceBytes": 5256,"sourceSha256": "44aa56ac6ca807937dfe84a6404e8b07d6394a38ae2ac53248a1985337dfd671","checks": [@@ -1069,8 +1069,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 11,"edgeCount": 10,- "artifactBytes": 535783,- "artifactSha256": "5bdb76d9cacbda597f50f466601983d635da5ac9168f25f91df110a81ec67237",+ "artifactBytes": 550556,+ "artifactSha256": "2af31a34467ffbaf2f91675a1aff15a5d7e1d386d0031066ad83ef2ea4684b25","sourceBytes": 5471,"sourceSha256": "9beb8698b275679a2fc92d4b51288cd5b5fc2115696d06b9168f3d7fef253a72","checks": [@@ -1166,8 +1166,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 10,"edgeCount": 10,- "artifactBytes": 537316,- "artifactSha256": "c29e59f0b5516a49bb3c5e146d202b30c565990c61c76df1387cf777d67d2f80",+ "artifactBytes": 552089,+ "artifactSha256": "b8ef06a1441f6d2bf3a612ddc0c231305ce32d96fd91df8a798dfea54598f640","sourceBytes": 5719,"sourceSha256": "f71c89288f80255bdedcdc0057bcbc155d1d8b1b7476d024b35f4e27c730c974","checks": [@@ -1263,8 +1263,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 7,"edgeCount": 14,- "artifactBytes": 534091,- "artifactSha256": "3fcefeff29ac56a83b3a1574ba58b70da8be3dbfaea0eb0d565ef24930ec95c0",+ "artifactBytes": 548864,+ "artifactSha256": "d3578494a7a1f3e5de435af2dcac3ee4f7ad991033412b27d59370ac85648007","sourceBytes": 4483,"sourceSha256": "1b53d7c4ce7b2d8f6f40b8f33a394abe1d37fc991272b534c1ccd0255920ab52","checks": [@@ -1360,8 +1360,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 541271,- "artifactSha256": "c5d4c203813461384f8151ed15b7331bafbd7f1c287a7345ffaeafba955314cb",+ "artifactBytes": 556044,+ "artifactSha256": "464235b1e3c2ecf21a00ad6c7776e70be95bc4ef80f6a3548954e54bb76b6a6b","sourceBytes": 5543,"sourceSha256": "bbfedc2f1b73bf50932490f7f56d45d5f853e970d2fab26660a04947a783969c","checks": [@@ -1457,8 +1457,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 10,"edgeCount": 5,- "artifactBytes": 530261,- "artifactSha256": "7b169efec1693b1885a88b384934ad46b91d649d2d99b98787c5c17b8696ff94",+ "artifactBytes": 545034,+ "artifactSha256": "b3adca83348c60ea79a06cac371e9e8f9d1c924c9fe3e497dde469ebdef0ee88","sourceBytes": 4353,"sourceSha256": "1d6b34282e014cb2730662b1993158ec67bc0ad2a40520cb441aaee1ad21e4c6","checks": [@@ -1554,8 +1554,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "trace","nodeCount": 11,"edgeCount": 6,- "artifactBytes": 531638,- "artifactSha256": "11c330d90bb690c4b94fd678e7d81fd0737ea0491c5ef290617426fb496919ea",+ "artifactBytes": 546411,+ "artifactSha256": "6da6fa280bf61646929eba0e219f20f081ab0c3c68f627a5f2e955e7b711fbc7","sourceBytes": 4394,"sourceSha256": "aa614f0c9a82f210e301e382f362dfbd7f290bda4d5501de3c99a6cd81b4c0a4","checks": [@@ -1651,8 +1651,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"animation": "static","nodeCount": 10,"edgeCount": 9,- "artifactBytes": 531270,- "artifactSha256": "5b8368b97a3941f483ee41ad0cf96b37157a11c9b7a9e870d9ba3c249dae8092",+ "artifactBytes": 546043,+ "artifactSha256": "1bd46fe5b72adf7a0e786ca3694bd3276c73caa093b8904f20ce22fb5b954754","sourceBytes": 3863,"sourceSha256": "01567b5e49cad5139baa071533a028d22f0e80fedfb49095e0d9330aee7f87db","checks": [diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.htmlindex bd8a2348..0ac8ae67 100644--- a/docs/gallery/artifacts/agent-run.lifecycle.html+++ b/docs/gallery/artifacts/agent-run.lifecycle.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4267,6 +4269,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4426,6 +4449,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4451,6 +4552,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4550,6 +4652,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4569,6 +4678,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4578,9 +4688,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4704,6 +4819,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4711,7 +4834,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4755,24 +4879,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4800,75 +4929,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4878,6 +5030,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5140,10 +5301,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5202,9 +5373,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5238,7 +5410,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5263,8 +5435,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5308,13 +5479,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5330,6 +5532,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5371,6 +5575,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5385,6 +5590,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5396,7 +5604,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9670,7 +9887,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9678,6 +9895,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9826,6 +10091,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10305,6 +10571,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10575,6 +10842,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/agent-tool-call.workflow.html b/docs/gallery/artifacts/agent-tool-call.workflow.htmlindex 33cdb2a5..3dbf22ca 100644--- a/docs/gallery/artifacts/agent-tool-call.workflow.html+++ b/docs/gallery/artifacts/agent-tool-call.workflow.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4347,6 +4349,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4506,6 +4529,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4531,6 +4632,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4630,6 +4732,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4649,6 +4758,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4658,9 +4768,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4784,6 +4899,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4791,7 +4914,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4835,24 +4959,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4880,75 +5009,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4958,6 +5110,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5220,10 +5381,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5282,9 +5453,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5318,7 +5490,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5343,8 +5515,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5388,13 +5559,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5410,6 +5612,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5451,6 +5655,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5465,6 +5670,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5476,7 +5684,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9750,7 +9967,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9758,6 +9975,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9906,6 +10171,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10385,6 +10651,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10655,6 +10922,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/async-job-roundtrip.sequence.html b/docs/gallery/artifacts/async-job-roundtrip.sequence.htmlindex bb9cc7ba..9070338d 100644--- a/docs/gallery/artifacts/async-job-roundtrip.sequence.html+++ b/docs/gallery/artifacts/async-job-roundtrip.sequence.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4334,6 +4336,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4493,6 +4516,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4518,6 +4619,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4617,6 +4719,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4636,6 +4745,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4645,9 +4755,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4771,6 +4886,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4778,7 +4901,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4822,24 +4946,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4867,75 +4996,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4945,6 +5097,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5207,10 +5368,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5269,9 +5440,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5305,7 +5477,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5330,8 +5502,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5375,13 +5546,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5397,6 +5599,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5438,6 +5642,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5452,6 +5657,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5463,7 +5671,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9737,7 +9954,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9745,6 +9962,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9893,6 +10158,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10372,6 +10638,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10642,6 +10909,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/cache-miss.sequence.html b/docs/gallery/artifacts/cache-miss.sequence.htmlindex 891d79d7..771d59c3 100644--- a/docs/gallery/artifacts/cache-miss.sequence.html+++ b/docs/gallery/artifacts/cache-miss.sequence.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4318,6 +4320,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4477,6 +4500,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4502,6 +4603,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4601,6 +4703,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4620,6 +4729,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4629,9 +4739,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4755,6 +4870,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4762,7 +4885,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4806,24 +4930,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4851,75 +4980,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4929,6 +5081,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5191,10 +5352,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5253,9 +5424,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5289,7 +5461,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5314,8 +5486,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5359,13 +5530,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5381,6 +5583,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5422,6 +5626,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5436,6 +5641,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5447,7 +5655,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9721,7 +9938,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9729,6 +9946,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9877,6 +10142,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10356,6 +10622,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10626,6 +10893,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.htmlindex 4649395e..a1169ad6 100644--- a/docs/gallery/artifacts/deployment-release.lifecycle.html+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4281,6 +4283,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4440,6 +4463,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4465,6 +4566,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4564,6 +4666,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4583,6 +4692,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4592,9 +4702,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4718,6 +4833,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4725,7 +4848,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4769,24 +4893,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4814,75 +4943,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4892,6 +5044,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5154,10 +5315,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5216,9 +5387,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5252,7 +5424,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5277,8 +5449,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5322,13 +5493,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5344,6 +5546,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5385,6 +5589,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5399,6 +5604,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5410,7 +5618,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9684,7 +9901,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9692,6 +9909,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9840,6 +10105,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10319,6 +10585,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10589,6 +10856,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/event-stream.dataflow.html b/docs/gallery/artifacts/event-stream.dataflow.htmlindex 04194edf..6ad26601 100644--- a/docs/gallery/artifacts/event-stream.dataflow.html+++ b/docs/gallery/artifacts/event-stream.dataflow.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4353,6 +4355,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4512,6 +4535,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4537,6 +4638,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4636,6 +4738,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4655,6 +4764,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4664,9 +4774,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4790,6 +4905,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4797,7 +4920,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4841,24 +4965,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4886,75 +5015,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4964,6 +5116,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5226,10 +5387,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5288,9 +5459,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5324,7 +5496,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5349,8 +5521,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5394,13 +5565,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5416,6 +5618,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5457,6 +5661,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5471,6 +5676,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5482,7 +5690,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9756,7 +9973,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9764,6 +9981,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9912,6 +10177,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10391,6 +10657,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10661,6 +10928,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/incident-response.workflow.html b/docs/gallery/artifacts/incident-response.workflow.htmlindex 0c600118..5d4449f5 100644--- a/docs/gallery/artifacts/incident-response.workflow.html+++ b/docs/gallery/artifacts/incident-response.workflow.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4316,6 +4318,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4475,6 +4498,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4500,6 +4601,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4599,6 +4701,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4618,6 +4727,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4627,9 +4737,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4753,6 +4868,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4760,7 +4883,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4804,24 +4928,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4849,75 +4978,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4927,6 +5079,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5189,10 +5350,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5251,9 +5422,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5287,7 +5459,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5312,8 +5484,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5357,13 +5528,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5379,6 +5581,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5420,6 +5624,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5434,6 +5639,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5445,7 +5653,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9719,7 +9936,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9727,6 +9944,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9875,6 +10140,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10354,6 +10620,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10624,6 +10891,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/product-analytics.dataflow.html b/docs/gallery/artifacts/product-analytics.dataflow.htmlindex 544a6378..db730a7c 100644--- a/docs/gallery/artifacts/product-analytics.dataflow.html+++ b/docs/gallery/artifacts/product-analytics.dataflow.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4314,6 +4316,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4473,6 +4496,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4498,6 +4599,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4597,6 +4699,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4616,6 +4725,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4625,9 +4735,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4751,6 +4866,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4758,7 +4881,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4802,24 +4926,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4847,75 +4976,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4925,6 +5077,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5187,10 +5348,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5249,9 +5420,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5285,7 +5457,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5310,8 +5482,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5355,13 +5526,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5377,6 +5579,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5418,6 +5622,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5432,6 +5637,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5443,7 +5651,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9717,7 +9934,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9725,6 +9942,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9873,6 +10138,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10352,6 +10618,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10622,6 +10889,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/production-deployment.architecture.html b/docs/gallery/artifacts/production-deployment.architecture.htmlindex a834ff55..78c72c29 100644--- a/docs/gallery/artifacts/production-deployment.architecture.html+++ b/docs/gallery/artifacts/production-deployment.architecture.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4333,6 +4335,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4492,6 +4515,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4517,6 +4618,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4616,6 +4718,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4635,6 +4744,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4644,9 +4754,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4770,6 +4885,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4777,7 +4900,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4821,24 +4945,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4866,75 +4995,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4944,6 +5096,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5206,10 +5367,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5268,9 +5439,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5304,7 +5476,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5329,8 +5501,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5374,13 +5545,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5396,6 +5598,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5437,6 +5641,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5451,6 +5656,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5462,7 +5670,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9736,7 +9953,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9744,6 +9961,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9892,6 +10157,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10371,6 +10637,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10641,6 +10908,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/release-delivery.workflow.html b/docs/gallery/artifacts/release-delivery.workflow.htmlindex cef31446..a423553d 100644--- a/docs/gallery/artifacts/release-delivery.workflow.html+++ b/docs/gallery/artifacts/release-delivery.workflow.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4316,6 +4318,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4475,6 +4498,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4500,6 +4601,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4599,6 +4701,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4618,6 +4727,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4627,9 +4737,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4753,6 +4868,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4760,7 +4883,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4804,24 +4928,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4849,75 +4978,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4927,6 +5079,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5189,10 +5350,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5251,9 +5422,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5287,7 +5459,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5312,8 +5484,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5357,13 +5528,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5379,6 +5581,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5420,6 +5624,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5434,6 +5639,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5445,7 +5653,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9719,7 +9936,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9727,6 +9944,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9875,6 +10140,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10354,6 +10620,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10624,6 +10891,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/artifacts/web-app.architecture.html b/docs/gallery/artifacts/web-app.architecture.htmlindex 231ea463..92d706a2 100644--- a/docs/gallery/artifacts/web-app.architecture.html+++ b/docs/gallery/artifacts/web-app.architecture.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4283,6 +4285,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4442,6 +4465,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4467,6 +4568,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4566,6 +4668,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4585,6 +4694,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4594,9 +4704,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4720,6 +4835,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4727,7 +4850,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4771,24 +4895,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4816,75 +4945,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4894,6 +5046,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5156,10 +5317,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5218,9 +5389,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5254,7 +5426,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5279,8 +5451,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5324,13 +5495,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5346,6 +5548,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5387,6 +5591,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5401,6 +5606,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5412,7 +5620,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9686,7 +9903,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9694,6 +9911,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9842,6 +10107,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10321,6 +10587,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10591,6 +10858,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.jsonindex 9a88298e..e85b85a9 100644--- a/docs/gallery/manifest.json+++ b/docs/gallery/manifest.json@@ -26,8 +26,8 @@"animation": "trace","nodeCount": 12,"edgeCount": 11,- "artifactBytes": 539659,- "artifactSha256": "194692a1cbc60fdc69862e3cf68facd67472f5cce317b0b473c1c78f2a16330b",+ "artifactBytes": 554432,+ "artifactSha256": "f1bf4782d842acbf2664e43d9fa8ee4057c50230f3f53909a6ea964fc9e004d2","sourceBytes": 6470,"sourceSha256": "a3afc6b30044eb256aa15c6195ddfbbcd1a14880d99967ed5605bc621ffb7e5f","checks": [@@ -123,8 +123,8 @@"animation": "trace","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 538815,- "artifactSha256": "7827b34ca8cee86c4448dd8738c55a60f56640ff12d8217d9d1c45afff4468a0",+ "artifactBytes": 553588,+ "artifactSha256": "33bd34438d45401740511e221193425c7e1dd65954c980971bff2ddd98c35a43","sourceBytes": 5308,"sourceSha256": "c3c4ddc8fd8910d8d2bcf2ba97434017d6fa347eb4ee436d2fb519dd0f27c814","checks": [@@ -220,8 +220,8 @@"animation": "trace","nodeCount": 7,"edgeCount": 12,- "artifactBytes": 533306,- "artifactSha256": "a695f636f38a595ed8b3e76942bc07cbea6455ae4b066b005131645ed0c482dc",+ "artifactBytes": 548079,+ "artifactSha256": "25f3fa31218706b9265fcb450515a2f1a6b3f1273ff999cf2919b2e9e77d41a0","sourceBytes": 4442,"sourceSha256": "30098d81006a18813bab447da698edf74604a1463770f01dc056b0af8cb314ef","checks": [@@ -317,8 +317,8 @@"animation": "trace","nodeCount": 10,"edgeCount": 10,- "artifactBytes": 535925,- "artifactSha256": "5cf4cd7ebaa73d42ec6dac441234736f111f75a29f3de077ffe956cd0aa71791",+ "artifactBytes": 550698,+ "artifactSha256": "f4a2de28083430d769d0297920dab009db1416034a9e57936675157e6b4caca3","sourceBytes": 5256,"sourceSha256": "44aa56ac6ca807937dfe84a6404e8b07d6394a38ae2ac53248a1985337dfd671","checks": [@@ -414,8 +414,8 @@"animation": "trace","nodeCount": 11,"edgeCount": 10,- "artifactBytes": 535783,- "artifactSha256": "5bdb76d9cacbda597f50f466601983d635da5ac9168f25f91df110a81ec67237",+ "artifactBytes": 550556,+ "artifactSha256": "2af31a34467ffbaf2f91675a1aff15a5d7e1d386d0031066ad83ef2ea4684b25","sourceBytes": 5471,"sourceSha256": "9beb8698b275679a2fc92d4b51288cd5b5fc2115696d06b9168f3d7fef253a72","checks": [@@ -511,8 +511,8 @@"animation": "trace","nodeCount": 10,"edgeCount": 10,- "artifactBytes": 537316,- "artifactSha256": "c29e59f0b5516a49bb3c5e146d202b30c565990c61c76df1387cf777d67d2f80",+ "artifactBytes": 552089,+ "artifactSha256": "b8ef06a1441f6d2bf3a612ddc0c231305ce32d96fd91df8a798dfea54598f640","sourceBytes": 5719,"sourceSha256": "f71c89288f80255bdedcdc0057bcbc155d1d8b1b7476d024b35f4e27c730c974","checks": [@@ -608,8 +608,8 @@"animation": "trace","nodeCount": 7,"edgeCount": 14,- "artifactBytes": 534091,- "artifactSha256": "3fcefeff29ac56a83b3a1574ba58b70da8be3dbfaea0eb0d565ef24930ec95c0",+ "artifactBytes": 548864,+ "artifactSha256": "d3578494a7a1f3e5de435af2dcac3ee4f7ad991033412b27d59370ac85648007","sourceBytes": 4483,"sourceSha256": "1b53d7c4ce7b2d8f6f40b8f33a394abe1d37fc991272b534c1ccd0255920ab52","checks": [@@ -705,8 +705,8 @@"animation": "trace","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 541271,- "artifactSha256": "c5d4c203813461384f8151ed15b7331bafbd7f1c287a7345ffaeafba955314cb",+ "artifactBytes": 556044,+ "artifactSha256": "464235b1e3c2ecf21a00ad6c7776e70be95bc4ef80f6a3548954e54bb76b6a6b","sourceBytes": 5543,"sourceSha256": "bbfedc2f1b73bf50932490f7f56d45d5f853e970d2fab26660a04947a783969c","checks": [@@ -802,8 +802,8 @@"animation": "trace","nodeCount": 10,"edgeCount": 5,- "artifactBytes": 530261,- "artifactSha256": "7b169efec1693b1885a88b384934ad46b91d649d2d99b98787c5c17b8696ff94",+ "artifactBytes": 545034,+ "artifactSha256": "b3adca83348c60ea79a06cac371e9e8f9d1c924c9fe3e497dde469ebdef0ee88","sourceBytes": 4353,"sourceSha256": "1d6b34282e014cb2730662b1993158ec67bc0ad2a40520cb441aaee1ad21e4c6","checks": [@@ -899,8 +899,8 @@"animation": "trace","nodeCount": 11,"edgeCount": 6,- "artifactBytes": 531638,- "artifactSha256": "11c330d90bb690c4b94fd678e7d81fd0737ea0491c5ef290617426fb496919ea",+ "artifactBytes": 546411,+ "artifactSha256": "6da6fa280bf61646929eba0e219f20f081ab0c3c68f627a5f2e955e7b711fbc7","sourceBytes": 4394,"sourceSha256": "aa614f0c9a82f210e301e382f362dfbd7f290bda4d5501de3c99a6cd81b4c0a4","checks": [@@ -996,8 +996,8 @@"animation": "static","nodeCount": 10,"edgeCount": 9,- "artifactBytes": 531270,- "artifactSha256": "5b8368b97a3941f483ee41ad0cf96b37157a11c9b7a9e870d9ba3c249dae8092",+ "artifactBytes": 546043,+ "artifactSha256": "1bd46fe5b72adf7a0e786ca3694bd3276c73caa093b8904f20ce22fb5b954754","sourceBytes": 3863,"sourceSha256": "01567b5e49cad5139baa071533a028d22f0e80fedfb49095e0d9330aee7f87db","checks": [diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.htmlindex 544a6378..db730a7c 100644--- a/examples/dataflow-product-analytics.html+++ b/examples/dataflow-product-analytics.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4314,6 +4316,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4473,6 +4496,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4498,6 +4599,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4597,6 +4699,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4616,6 +4725,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4625,9 +4735,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4751,6 +4866,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4758,7 +4881,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4802,24 +4926,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4847,75 +4976,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4925,6 +5077,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5187,10 +5348,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5249,9 +5420,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5285,7 +5457,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5310,8 +5482,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5355,13 +5526,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5377,6 +5579,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5418,6 +5622,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5432,6 +5637,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5443,7 +5651,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9717,7 +9934,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9725,6 +9942,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9873,6 +10138,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10352,6 +10618,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10622,6 +10889,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.htmlindex bd8a2348..0ac8ae67 100644--- a/examples/lifecycle-agent-run.html+++ b/examples/lifecycle-agent-run.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4267,6 +4269,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4426,6 +4449,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4451,6 +4552,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4550,6 +4652,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4569,6 +4678,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4578,9 +4688,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4704,6 +4819,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4711,7 +4834,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4755,24 +4879,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4800,75 +4929,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4878,6 +5030,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5140,10 +5301,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5202,9 +5373,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5238,7 +5410,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5263,8 +5435,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5308,13 +5479,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5330,6 +5532,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5371,6 +5575,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5385,6 +5590,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5396,7 +5604,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9670,7 +9887,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9678,6 +9895,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9826,6 +10091,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10305,6 +10571,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10575,6 +10842,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.htmlindex 891d79d7..771d59c3 100644--- a/examples/sequence-cache-miss-request.html+++ b/examples/sequence-cache-miss-request.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4318,6 +4320,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4477,6 +4500,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4502,6 +4603,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4601,6 +4703,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4620,6 +4729,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4629,9 +4739,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4755,6 +4870,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4762,7 +4885,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4806,24 +4930,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4851,75 +4980,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4929,6 +5081,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5191,10 +5352,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5253,9 +5424,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5289,7 +5461,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5314,8 +5486,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5359,13 +5530,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5381,6 +5583,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5422,6 +5626,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5436,6 +5641,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5447,7 +5655,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9721,7 +9938,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9729,6 +9946,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9877,6 +10142,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10356,6 +10622,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10626,6 +10893,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.htmlindex 231ea463..92d706a2 100644--- a/examples/web-app-rendered.html+++ b/examples/web-app-rendered.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4283,6 +4285,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4442,6 +4465,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4467,6 +4568,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4566,6 +4668,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4585,6 +4694,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4594,9 +4704,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4720,6 +4835,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4727,7 +4850,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4771,24 +4895,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4816,75 +4945,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4894,6 +5046,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5156,10 +5317,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5218,9 +5389,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5254,7 +5426,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5279,8 +5451,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5324,13 +5495,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5346,6 +5548,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5387,6 +5591,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5401,6 +5606,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5412,7 +5620,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9686,7 +9903,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9694,6 +9911,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9842,6 +10107,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10321,6 +10587,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10591,6 +10858,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/examples/web-app.html b/examples/web-app.htmlindex 231ea463..92d706a2 100644--- a/examples/web-app.html+++ b/examples/web-app.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4283,6 +4285,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4442,6 +4465,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4467,6 +4568,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4566,6 +4668,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4585,6 +4694,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4594,9 +4704,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4720,6 +4835,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4727,7 +4850,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4771,24 +4895,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4816,75 +4945,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4894,6 +5046,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5156,10 +5317,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5218,9 +5389,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5254,7 +5426,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5279,8 +5451,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5324,13 +5495,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5346,6 +5548,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5387,6 +5591,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5401,6 +5606,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5412,7 +5620,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9686,7 +9903,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9694,6 +9911,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9842,6 +10107,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10321,6 +10587,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10591,6 +10858,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.htmlindex 33cdb2a5..3dbf22ca 100644--- a/examples/workflow-agent-tool-call-rendered.html+++ b/examples/workflow-agent-tool-call-rendered.html@@ -2597,6 +2597,7 @@text-align: left;padding: 0.5rem 0.75rem;}+ .toolbar .export-menu button[hidden] { display: none; }.toolbar .export-menu button:hover {background: var(--toolbar-hover);}@@ -3789,6 +3790,7 @@</button><div class="export-menu" id="export-menu" role="menu" aria-label="Export"><button data-format="share-card" type="button" role="menuitem" tabindex="-1">Share Card <span class="hint">1200×630 PNG</span></button>+ <button data-action="route-share-card" type="button" role="menuitem" tabindex="-1" hidden disabled>Route Share Card <span class="hint">1200×630 PNG</span></button><button data-action="copy-share-card" type="button" role="menuitem" tabindex="-1">Copy Share Card <span class="hint">PNG</span></button><hr role="separator"><button data-action="copy" type="button" role="menuitem" tabindex="-1">Copy to clipboard <span class="hint">PNG</span></button>@@ -4347,6 +4349,27 @@<script>var Archify = {};+ function hasDrawableGeometry(element) {+ if (!element) return false;+ var geometries = /^(path|line|polyline)$/i.test(element.tagName)+ ? [element]+ : Array.prototype.slice.call(element.querySelectorAll('path, line, polyline'));+ return geometries.some(function (geometry) {+ var source = geometry.tagName.toLowerCase() === 'path'+ ? geometry.getAttribute('d')+ : geometry.tagName.toLowerCase() === 'polyline'+ ? geometry.getAttribute('points')+ : [geometry.getAttribute('x1'), geometry.getAttribute('y1'), geometry.getAttribute('x2'), geometry.getAttribute('y2')].join(' ');+ if (!source || /(?:^|[^a-z])(?:nan|infinity)(?:[^a-z]|$)/i.test(source) || typeof geometry.getTotalLength !== 'function') return false;+ try {+ var length = Number(geometry.getTotalLength());+ return Number.isFinite(length) && length > 0;+ } catch (_) {+ return false;+ }+ });+ }+/* ============================================================Visual style try-on — one topology, three bundled presets.The reader's choice is intentionally session-only: it updates the@@ -4506,6 +4529,84 @@* self-themes when embedded in GitHub READMEs or other hosts that* expose a color scheme. Used for "Download SVG".*/+ function applyRouteSnapshot(clone, snapshot) {+ if (!snapshot || !Array.isArray(snapshot.nodeIds) || !Array.isArray(snapshot.edges) ||+ snapshot.nodeIds.length < 2 || snapshot.edges.length !== snapshot.nodeIds.length - 1 ||+ snapshot.hops !== snapshot.edges.length ||+ !snapshot.source || !snapshot.target ||+ snapshot.source.id !== snapshot.nodeIds[0] ||+ snapshot.target.id !== snapshot.nodeIds[snapshot.nodeIds.length - 1]) return false;++ clone.removeAttribute('data-animation');+ Array.prototype.forEach.call(clone.querySelectorAll('[data-animate]'), function (element) {+ element.removeAttribute('data-animate');+ element.style.removeProperty('--step');+ });++ var cloneNodes = Array.prototype.slice.call(clone.querySelectorAll('[data-node-id]'));+ var cloneEdges = Array.prototype.slice.call(clone.querySelectorAll('[data-edge-key]'));+ var nodeIds = Object.create(null);+ var edgeKeys = Object.create(null);+ var nodeMatches = [];+ var edgeMatches = [];++ for (var nodeIndex = 0; nodeIndex < snapshot.nodeIds.length; nodeIndex++) {+ var nodeId = snapshot.nodeIds[nodeIndex];+ if (typeof nodeId !== 'string' || !nodeId || nodeIds[nodeId]) return false;+ var matchedNodes = cloneNodes.filter(function (candidate) {+ return candidate.getAttribute('data-node-id') === nodeId;+ });+ if (matchedNodes.length !== 1) return false;+ nodeIds[nodeId] = true;+ nodeMatches.push(matchedNodes);+ }++ for (var edgeIndex = 0; edgeIndex < snapshot.edges.length; edgeIndex++) {+ var edge = snapshot.edges[edgeIndex];+ var fromId = snapshot.nodeIds[edgeIndex];+ var toId = snapshot.nodeIds[edgeIndex + 1];+ if (!edge || typeof edge.key !== 'string' || !edge.key || edgeKeys[edge.key] ||+ edge.from !== fromId || edge.to !== toId) return false;+ var matchedEdges = cloneEdges.filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edge.key;+ });+ var drawableMatches = matchedEdges.filter(hasDrawableGeometry);+ if (!matchedEdges.length || drawableMatches.length !== 1 || !matchedEdges.every(function (candidate) {+ return candidate.getAttribute('data-edge-from') === edge.from &&+ candidate.getAttribute('data-edge-to') === edge.to &&+ (candidate.getAttribute('data-edge-id') || '') === (edge.id || '');+ })) return false;+ edgeKeys[edge.key] = true;+ edgeMatches.push(matchedEdges);+ }++ clone.setAttribute('data-share-route', '');+ nodeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ if (step === 0) element.setAttribute('data-share-route-start', '');+ else if (step === snapshot.nodeIds.length - 1) element.setAttribute('data-share-route-end', '');+ else element.setAttribute('data-share-route-middle', '');+ });+ });+ edgeMatches.forEach(function (matches, step) {+ matches.forEach(function (element) {+ element.setAttribute('data-share-route-match', '');+ element.setAttribute('data-share-route-step', String(step));+ });+ });++ return clone.hasAttribute('data-share-route') &&+ !clone.hasAttribute('data-animation') &&+ !clone.hasAttribute('data-route-active') &&+ !clone.hasAttribute('data-route-journey') &&+ clone.querySelectorAll('[data-animate], [data-route-match], [data-route-step], [data-route-start], [data-route-end], [data-route-journey-state], [data-route-journey-current], [data-route-journey-overlay]').length === 0 &&+ clone.querySelectorAll('[data-share-route-match]').length ===+ nodeMatches.reduce(function (count, matches) { return count + matches.length; }, 0) ++ edgeMatches.reduce(function (count, matches) { return count + matches.length; }, 0);+ }+function serializeSvg(scale, opts) {// scale: integer multiplier for intrinsic SVG pixel dimensions used by// the raster path. Defaults to 1 (natural size) for SVG download.@@ -4531,6 +4632,7 @@clone.removeAttribute('data-route-picking');clone.removeAttribute('data-route-active');clone.removeAttribute('data-route-journey');+ clone.removeAttribute('data-share-route');clone.removeAttribute('data-story-active');clone.removeAttribute('data-story-playing');clone.removeAttribute('data-story-beat');@@ -4630,6 +4732,13 @@el.removeAttribute('data-route-journey-current');el.style.removeProperty('--route-step');});+ Array.prototype.forEach.call(clone.querySelectorAll('[data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle]'), function (el) {+ el.removeAttribute('data-share-route-match');+ el.removeAttribute('data-share-route-step');+ el.removeAttribute('data-share-route-start');+ el.removeAttribute('data-share-route-end');+ el.removeAttribute('data-share-route-middle');+ });Array.prototype.forEach.call(clone.querySelectorAll('[data-detail], [data-detail-anchor]'), function (el) {el.removeAttribute('data-detail');el.removeAttribute('data-detail-anchor');@@ -4649,6 +4758,7 @@!clone.hasAttribute('data-route-picking') &&!clone.hasAttribute('data-route-active') &&!clone.hasAttribute('data-route-journey') &&+ !clone.hasAttribute('data-share-route') &&!clone.hasAttribute('data-story-active') &&!clone.hasAttribute('data-story-playing') &&!clone.hasAttribute('data-story-beat') &&@@ -4658,9 +4768,14 @@!clone.hasAttribute('data-chapter-anchor') &&!clone.hasAttribute('data-chapter-preview') &&!clone.style.getPropertyValue('transform') &&- 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-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-detail], [data-detail-anchor]').length === 0;+ 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-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-detail], [data-detail-anchor]').length === 0;var vb = svg.viewBox.baseVal;+ var finiteSvgDimensions = Number.isFinite(vb.x) && Number.isFinite(vb.y) &&+ Number.isFinite(vb.width) && Number.isFinite(vb.height) && vb.width > 0 && vb.height > 0;+ var routeStateClean = opts.routeSnapshot+ ? canonicalStateClean && finiteSvgDimensions && applyRouteSnapshot(clone, opts.routeSnapshot)+ : null;// Scale width/height so the browser rasterizes the vectors at target// resolution directly. viewBox stays unchanged so coordinates don't// shift. This is the key to sharp rasters — do NOT scale later via@@ -4784,6 +4899,14 @@bgRect.setAttribute('fill', computed.getPropertyValue('--bg').trim() || '#ffffff');}+ if (opts.routeSnapshot) {+ style.textContent += "\nsvg[data-share-route] [data-node-id], svg[data-share-route] [data-edge-from] { opacity: 0.18; }\n" ++ "svg[data-share-route] [data-share-route-match] { opacity: 1; }\n" ++ "svg[data-share-route] [data-share-route-start] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3; stroke-dasharray: 5 3; }\n" ++ "svg[data-share-route] [data-share-route-middle] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 2.2; }\n" ++ "svg[data-share-route] [data-share-route-end] > :is(rect, circle, polygon):not(.c-mask) { stroke-width: 3.4; stroke-dasharray: 1 0; }\n";+ }+clone.insertBefore(style, clone.firstChild);clone.insertBefore(bgRect, style.nextSibling);@@ -4791,7 +4914,8 @@svgString: new XMLSerializer().serializeToString(clone),width: vb.width * scale,height: vb.height * scale,- canonicalStateClean: canonicalStateClean+ canonicalStateClean: canonicalStateClean,+ routeStateClean: routeStateClean};}@@ -4835,24 +4959,29 @@return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = data.width;- canvas.height = data.height;- var ctx = canvas.getContext('2d');- if (format === 'jpeg') {- ctx.fillStyle = currentBg();- ctx.fillRect(0, 0, canvas.width, canvas.height);+ try {+ var canvas = document.createElement('canvas');+ canvas.width = data.width;+ canvas.height = data.height;+ var ctx = canvas2dOrThrow(canvas, format);+ if (format === 'jpeg') {+ ctx.fillStyle = currentBg();+ ctx.fillRect(0, 0, canvas.width, canvas.height);+ }+ // Draw at natural size — SVG was already rasterized at target res.+ ctx.drawImage(img, 0, 0);+ URL.revokeObjectURL(svgUrl);+ var mime = format === 'jpeg' ? 'image/jpeg' :+ 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));+ else resolve(blob);+ }, mime, quality);+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);}- // Draw at natural size — SVG was already rasterized at target res.- ctx.drawImage(img, 0, 0);- URL.revokeObjectURL(svgUrl);- var mime = format === 'jpeg' ? 'image/jpeg' :- 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));- else resolve(blob);- }, mime, quality);};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4880,75 +5009,98 @@return value + suffix;}- function rasterizeShareCard() {+ function canvas2dOrThrow(canvas, label) {+ if (!canvas || typeof canvas.getContext !== 'function') {+ throw new Error('Canvas unavailable for ' + 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);+ return ctx;+ }++ function renderShareCard(options) {+ options = options || {};+ var routeSnapshot = options.routeSnapshot || null;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);+ var data = serializeSvg(sourceScale, { routeSnapshot: routeSnapshot });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'));var svgBlob = new Blob([data.svgString], { type: 'image/svg+xml;charset=utf-8' });var svgUrl = URL.createObjectURL(svgBlob);return new Promise(function (resolve, reject) {var img = new Image();img.onload = function () {- var canvas = document.createElement('canvas');- canvas.width = SHARE_CARD_WIDTH;- canvas.height = SHARE_CARD_HEIGHT;- var ctx = canvas.getContext('2d');- var computed = getComputedStyle(document.documentElement);- var bg = computed.getPropertyValue('--bg').trim() || currentBg();- var text = computed.getPropertyValue('--text').trim() || '#ffffff';- var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';- var border = computed.getPropertyValue('--panel-border').trim() || '#334155';- var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';- var titleNode = document.querySelector('.header h1');- var subtitleNode = document.querySelector('.header .subtitle');- var title = titleNode ? titleNode.textContent : document.title;- var subtitle = 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();-- ctx.fillStyle = bg;- ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);-- ctx.fillStyle = accent;- ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);-- ctx.textBaseline = 'alphabetic';- ctx.fillStyle = text;- var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');- ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);-- ctx.fillStyle = muted;- var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');- ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);-- ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";- ctx.textAlign = 'right';- ctx.fillStyle = accent;- ctx.fillText('ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase(), SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);- ctx.textAlign = 'left';-- var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;- var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;- var fit = Math.min(availableWidth / data.width, availableHeight / data.height);- var drawWidth = data.width * fit;- var drawHeight = data.height * fit;- var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;- var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;-- ctx.strokeStyle = border;- ctx.lineWidth = 1;- ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);- ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);- URL.revokeObjectURL(svgUrl);-- canvas.toBlob(function (blob) {- if (!blob) reject(new Error('toBlob returned null for Share Card'));- else resolve(blob);- }, 'image/png');+ try {+ var canvas = document.createElement('canvas');+ canvas.width = SHARE_CARD_WIDTH;+ canvas.height = SHARE_CARD_HEIGHT;+ var ctx = canvas2dOrThrow(canvas, 'Share Card');+ var computed = getComputedStyle(document.documentElement);+ var bg = computed.getPropertyValue('--bg').trim() || currentBg();+ var text = computed.getPropertyValue('--text').trim() || '#ffffff';+ var muted = computed.getPropertyValue('--text-muted').trim() || '#94a3b8';+ var border = computed.getPropertyValue('--panel-border').trim() || '#334155';+ var accent = computed.getPropertyValue('--frontend-stroke').trim() || '#22d3ee';+ var titleNode = document.querySelector('.header h1');+ var subtitleNode = document.querySelector('.header .subtitle');+ var title = titleNode ? titleNode.textContent : document.title;+ var subtitle = routeSnapshot+ ? 'Route: ' + routeSnapshot.source.label + ' → ' + routeSnapshot.target.label + ' · ' + routeSnapshot.hops + ' directed hops'+ : 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 cardLabel = routeSnapshot+ ? 'ARCHIFY · ROUTE · ' + routeSnapshot.hops + ' HOPS'+ : 'ARCHIFY · ' + presetLabel + ' · ' + theme.toUpperCase();++ ctx.fillStyle = bg;+ ctx.fillRect(0, 0, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHT);++ ctx.fillStyle = accent;+ ctx.fillRect(SHARE_CARD_PADDING, 27, 42, 3);++ ctx.textBaseline = 'alphabetic';+ ctx.fillStyle = text;+ var fittedTitle = fitCanvasText(ctx, title, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 330, 29, 18, '700');+ ctx.fillText(fittedTitle, SHARE_CARD_PADDING, 62);++ ctx.fillStyle = muted;+ var fittedSubtitle = fitCanvasText(ctx, subtitle, SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2 - 280, 13, 11, '500');+ ctx.fillText(fittedSubtitle, SHARE_CARD_PADDING, 87);++ ctx.font = "600 12px 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";+ ctx.textAlign = 'right';+ ctx.fillStyle = accent;+ ctx.fillText(cardLabel, SHARE_CARD_WIDTH - SHARE_CARD_PADDING, 50);+ ctx.textAlign = 'left';++ var availableWidth = SHARE_CARD_WIDTH - SHARE_CARD_PADDING * 2;+ var availableHeight = SHARE_CARD_HEIGHT - SHARE_CARD_HEADER - SHARE_CARD_PADDING;+ var fit = Math.min(availableWidth / data.width, availableHeight / data.height);+ var drawWidth = data.width * fit;+ var drawHeight = data.height * fit;+ var drawX = SHARE_CARD_PADDING + (availableWidth - drawWidth) / 2;+ var drawY = SHARE_CARD_HEADER + (availableHeight - drawHeight) / 2;++ ctx.strokeStyle = border;+ ctx.lineWidth = 1;+ ctx.strokeRect(drawX - 0.5, drawY - 0.5, drawWidth + 1, drawHeight + 1);+ ctx.drawImage(img, drawX, drawY, drawWidth, drawHeight);+ URL.revokeObjectURL(svgUrl);++ canvas.toBlob(function (blob) {+ if (!blob) reject(new Error('toBlob returned null for Share Card'));+ else resolve(blob);+ }, 'image/png');+ } catch (error) {+ URL.revokeObjectURL(svgUrl);+ reject(error);+ }};img.onerror = function (e) {URL.revokeObjectURL(svgUrl);@@ -4958,6 +5110,15 @@});}+ function rasterizeShareCard(options) {+ options = options || {};+ if (!options.variant) return renderShareCard();+ if (options.variant !== 'route') return Promise.reject(new Error('Unknown Share Card variant: ' + options.variant));+ var snapshot = Archify.routeProbe && Archify.routeProbe.exportSnapshot();+ if (!snapshot) return Promise.reject(new Error('Trace a route before exporting a Route Share Card'));+ return renderShareCard({ routeSnapshot: snapshot });+ }+function motionMimeType() {if (typeof MediaRecorder === 'undefined') return '';var candidates = [@@ -5220,10 +5381,20 @@var menu = document.getElementById('export-menu');var btn = document.getElementById('btn-export');+ var routeShareItem = menu.querySelector('button[data-action="route-share-card"]');var items = function () {return Array.prototype.slice.call(menu.querySelectorAll('button[role="menuitem"]'));};+ function syncRouteShareItem() {+ var snapshot = Archify.routeProbe && typeof Archify.routeProbe.exportSnapshot === 'function'+ ? Archify.routeProbe.exportSnapshot()+ : null;+ routeShareItem.hidden = !snapshot;+ routeShareItem.disabled = !snapshot;+ return snapshot;+ }+// ---- Clipboard support ----------------------------------------------function canCopyImage() {return typeof ClipboardItem !== 'undefined' &&@@ -5282,9 +5453,10 @@function open(focusLast) {if (Archify.semanticLens && typeof Archify.semanticLens.clearPreview === 'function') Archify.semanticLens.clearPreview();if (Archify.semanticLens && Archify.semanticLens.isOpen()) Archify.semanticLens.close({ restoreFocus: false });+ syncRouteShareItem();menu.classList.add('open');btn.setAttribute('aria-expanded', 'true');- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var target = focusLast ? available[available.length - 1] : available[0];if (target) target.focus();}@@ -5318,7 +5490,7 @@if (e.key === 'Escape') { e.preventDefault(); close(true); return; }if (e.key === 'Tab') { close(false); return; }- var available = items().filter(function (i) { return !i.disabled; });+ var available = items().filter(function (i) { return !i.hidden && !i.disabled; });var current = available.indexOf(document.activeElement);switch (e.key) {case 'ArrowDown':@@ -5343,8 +5515,7 @@function runExport(format) {var base = diagramFilename();close(true);- document.documentElement.removeAttribute('data-last-export-error');- document.documentElement.removeAttribute('data-last-export-error-format');+ clearExportReceipt();if (format === 'webm') toast('Recording 6 seconds of motion…');return (format === 'share-card'? rasterizeShareCard().then(function (blob) {@@ -5388,13 +5559,44 @@});}+ function runRouteShareCard() {+ close(false);+ clearExportReceipt();+ 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'));+ 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');+ return blob;+ }).catch(function (err) {+ console.error(err);+ var message = err && err.message ? err.message : 'share-card';+ 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);+ });+ }+// A compact, machine-readable receipt for local QA and generated proof// galleries. It exposes no diagram contents, only the completed format,// byte count, and whether temporary viewer state was excluded.- function recordExportReceipt(format, blob, canonical, dimensions) {+ function recordExportReceipt(format, blob, canonical, dimensions, variant, routeStateClean) {document.documentElement.setAttribute('data-last-export-format', format);document.documentElement.setAttribute('data-last-export-bytes', String(blob.size));document.documentElement.setAttribute('data-last-export-canonical', canonical ? 'true' : 'false');+ if (variant) {+ document.documentElement.setAttribute('data-last-export-variant', variant);+ } else {+ document.documentElement.removeAttribute('data-last-export-variant');+ }+ if (routeStateClean === true) {+ document.documentElement.setAttribute('data-last-export-route-state-clean', 'true');+ } else {+ document.documentElement.removeAttribute('data-last-export-route-state-clean');+ }if (dimensions) {document.documentElement.setAttribute('data-last-export-width', String(dimensions.width));document.documentElement.setAttribute('data-last-export-height', String(dimensions.height));@@ -5410,6 +5612,8 @@document.documentElement.removeAttribute('data-last-export-canonical');document.documentElement.removeAttribute('data-last-export-width');document.documentElement.removeAttribute('data-last-export-height');+ document.documentElement.removeAttribute('data-last-export-variant');+ document.documentElement.removeAttribute('data-last-export-route-state-clean');document.documentElement.removeAttribute('data-last-export-error-format');document.documentElement.removeAttribute('data-last-export-error');}@@ -5451,6 +5655,7 @@function runCopy() {close(true);+ clearExportReceipt();if (!canCopyImage()) {alert('Clipboard image write not supported in this browser.');return;@@ -5465,6 +5670,9 @@}menu.addEventListener('click', function (e) {+ var routeShareCardBtn = e.target.closest('button[data-action="route-share-card"]');+ if (routeShareCardBtn && !routeShareCardBtn.disabled && !routeShareCardBtn.hidden) { runRouteShareCard(); return; }+var copyShareCardBtn = e.target.closest('button[data-action="copy-share-card"]');if (copyShareCardBtn && !copyShareCardBtn.disabled) { runCopyShareCard(); return; }@@ -5476,7 +5684,16 @@});Archify.motion = { canRecord: canRecordMotion, recordWebm: recordWebm };- Archify.exportMenu = { open: open, close: close, isOpen: isOpen, run: runExport, shareCard: rasterizeShareCard, copyShareCard: runCopyShareCard };+ Archify.exportMenu = {+ open: open,+ close: close,+ isOpen: isOpen,+ run: runExport,+ shareCard: rasterizeShareCard,+ downloadRouteShareCard: runRouteShareCard,+ syncRouteShare: syncRouteShareItem,+ copyShareCard: runCopyShareCard+ };// Auto-open on page load for demo/screenshot purposes: ?openExport=1// Wait for fonts (so the menu doesn't flash before typography lands)@@ -9750,7 +9967,7 @@return Array.prototype.slice.call(svg.querySelectorAll('[data-edge-from][data-edge-to]'));}function nodesById() {- var out = {};+ var out = Object.create(null);nodes().forEach(function (node) { out[node.getAttribute('data-node-id')] = node; });return out;}@@ -9758,6 +9975,54 @@return node.getAttribute('data-node-label') ||(node.getAttribute('aria-label') || fallback).replace(/^Focus\s+/, '').split(',')[0];}+ function exportSnapshot() {+ if (mode !== 'result' || activeNodeIds.length < 2 || activeEdges.length !== activeNodeIds.length - 1) return null;+ var allNodes = nodes();+ var byId = nodesById();+ var seenNodeIds = Object.create(null);+ var seenEdgeKeys = Object.create(null);+ if (startId !== activeNodeIds[0] || endId !== activeNodeIds[activeNodeIds.length - 1] ||+ activeNodeIds.some(function (id) {+ if (seenNodeIds[id] || allNodes.filter(function (node) {+ return node.getAttribute('data-node-id') === id;+ }).length !== 1) return true;+ seenNodeIds[id] = true;+ return !byId[id];+ }) ||+ activeEdges.some(function (edge, index) {+ if (!edge || !svg.contains(edge)) return true;+ var edgeKey = edge.getAttribute('data-edge-key');+ var edgeId = edge.getAttribute('data-edge-id') || '';+ if (!edgeKey || seenEdgeKeys[edgeKey]) return true;+ seenEdgeKeys[edgeKey] = true;+ var fragments = Array.prototype.slice.call(svg.querySelectorAll('[data-edge-key]')).filter(function (candidate) {+ return candidate.getAttribute('data-edge-key') === edgeKey;+ });+ var drawableFragments = fragments.filter(hasDrawableGeometry);+ return !fragments.length || !fragments.every(function (fragment) {+ return fragment.getAttribute('data-edge-from') === activeNodeIds[index] &&+ fragment.getAttribute('data-edge-to') === activeNodeIds[index + 1] &&+ (fragment.getAttribute('data-edge-id') || '') === edgeId;+ }) || drawableFragments.length !== 1 || drawableFragments[0] !== edge ||+ edge.getAttribute('data-edge-from') !== activeNodeIds[index] ||+ edge.getAttribute('data-edge-to') !== activeNodeIds[index + 1];+ })) return null;+ return {+ source: { id: startId, label: nodeLabel(byId[startId], startId) },+ target: { id: endId, label: nodeLabel(byId[endId], endId) },+ nodeIds: activeNodeIds.slice(),+ hops: activeEdges.length,+ edges: activeEdges.map(function (edge) {+ return {+ key: edge.getAttribute('data-edge-key'),+ id: edge.getAttribute('data-edge-id') || '',+ from: edge.getAttribute('data-edge-from'),+ to: edge.getAttribute('data-edge-to'),+ label: edge.getAttribute('data-edge-label') || ''+ };+ })+ };+ }function edgeShapes(edge) {if (/^(path|line|polyline)$/i.test(edge.tagName)) return [edge];return Array.prototype.slice.call(edge.querySelectorAll('path, line, polyline'));@@ -9906,6 +10171,7 @@findBtn.setAttribute('aria-label', 'Find a route start');copyBtn.hidden = true;copyBtn.textContent = 'Copy link';+ 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') {Archify.view.reset({ automatic: true });@@ -10385,6 +10651,7 @@findBtn.hidden = true;copyBtn.hidden = false;setTrigger(true);+ if (Archify.exportMenu && typeof Archify.exportMenu.syncRouteShare === 'function') Archify.exportMenu.syncRouteShare();if (options.updateUrl !== false) {replaceRouteHash(encodeURIComponent(startId) + '~' + encodeURIComponent(endId));}@@ -10655,6 +10922,7 @@finderOpening: finderOpening,finderClosed: finderClosed,openFinder: openFinder,+ exportSnapshot: exportSnapshot,active: function () { return mode === 'idle' ? null : mode; },result: function () {return mode === 'result'diff --git a/scripts/build-zip.sh b/scripts/build-zip.shindex 9662edf5..46b12795 100755--- a/scripts/build-zip.sh+++ b/scripts/build-zip.sh@@ -29,6 +29,7 @@ rsync -a \--exclude '.DS_Store' \--exclude '.hive' \--exclude '.workbuddy' \+ --exclude '.validator-check-*' \"$repo_root/archify/" "$stage/archify/"node -e "const fs = require('fs');