Skip to content

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

chore: combine the four new diagram types

tt-a1ia1eaad18547b
diff --git a/archify.zip b/archify.zip
index ed67fdb3..9f0c7b3b 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/SKILL.md b/archify/SKILL.md
index 19b367ea..4e9b8be2 100644
--- a/archify/SKILL.md
+++ b/archify/SKILL.md
@@ -1,6 +1,6 @@
---
name: archify
-description: Create polished, validated architecture, workflow, sequence, data-flow, lifecycle/state, entity-relationship, and hierarchy/tree diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, stateDiagram, and erDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, database schemas, ER/entity-relationship models, repository/module/capability hierarchies and decomposition trees, or to convert/beautify Mermaid.
+description: Create polished, validated architecture, workflow, sequence, data-flow, lifecycle/state, entity-relationship, class/interface, hierarchy/tree, event timeline, and execution waterfall diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, stateDiagram, erDiagram, and classDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, database schemas, ER/entity-relationship models, class/interface models, module or capability trees, incident/release timelines, request or agent-run span waterfalls, or to convert/beautify Mermaid.
license: MIT
metadata:
version: "3.0"
@@ -26,8 +26,8 @@ When the user supplies a frozen candidate, run `finalize` first as one CLI invoc
Use this path for ordinary generation. Read branch references only when their stated trigger applies.
-1. Choose `architecture`, `workflow`, `sequence`, `dataflow`, `lifecycle`, `erd`, or `tree` from the question.
-2. Use the exact schema and example paths in the Type router without listing their directories. Read [Authoring defaults](references/authoring-defaults.md) and the mode's example in a bounded batch separate from project documents and complete schemas so neither is truncated; recover any missing section before writing. For Architecture, use the matching showcase example. For Sequence, Dataflow, Lifecycle, and Tree, also read the mode and common schemas. Read the relevant schema definition before choosing any new field, enum, or constrained text, especially boundary kinds. Examples teach shape, not facts. Use fresh IDs, wording, and layout. Go directly to the candidate without preliminary help, doctor, starter validation, temporary diagrams, or output-path listing. Query brands only for an explicitly requested mark; read [Brand marks](references/brand-marks.md) for an unknown mark with a user-provided URL.
+1. Choose `architecture`, `workflow`, `sequence`, `dataflow`, `lifecycle`, `erd`, `class`, `tree`, `timeline`, or `waterfall` from the question.
+2. Use the exact schema and example paths in the Type router without listing their directories. Read [Authoring defaults](references/authoring-defaults.md) and the mode's example in a bounded batch separate from project documents and complete schemas so neither is truncated; recover any missing section before writing. For Architecture, use the matching showcase example. For Sequence, Dataflow, Lifecycle, Class, Tree, Timeline, and Waterfall, also read the mode and common schemas. Read the relevant schema definition before choosing any new field, enum, or constrained text, especially boundary kinds. Examples teach shape, not facts. Use fresh IDs, wording, and layout. Go directly to the candidate without preliminary help, doctor, starter validation, temporary diagrams, or output-path listing. Query brands only for an explicitly requested mark; read [Brand marks](references/brand-marks.md) for an unknown mark with a user-provided URL.
3. Once the requested scope and, for a real codebase, [source evidence](references/repository-authoring.md) are covered, write the complete candidate directly without planning coordinates in prose. Choose Architecture abstraction and connected placement using Authoring defaults before coordinates: show the main user journey and necessary branches, preserve control roles and behavior-changing conditions, and leave enough room for actual relationship labels. No node, relationship, source, view, card, or boundary count is a target or ceiling. Use automatic routes first; add explicit routing only for necessary branch, return, supplied geometry, or measured repair. Set `meta.quality_profile` to `"showcase"` unless the user requests dense `standard`. For ERD, use a table-first layout: show every physical column in `entities[].attributes`, keep its SQL type and source comment, state every key role a column carries (`key` takes a role or a list, so a junction column is `["pk", "fk"]`), and never move columns into cards as a substitute for the table. Classify tables into functional domains before placement, give each domain a concise `tag`, and place its members in one solid block of grid cells — a single row, a single column, or a full block. A tagged table always needs `row`/`col`, because absolute coordinates have no grid cells and a domain whose tables do not fill one block cannot be drawn as a band: the renderer reports `erd/domain-not-drawn` instead of publishing a diagram that cannot name the domain. A multi-domain schema reads best as one domain per column — each `tag` a vertical run — because the reader scales a wide canvas up to the reader width and shrinks a tall one until the page fits, so the wide arrangement is the one that stays complete and legible inside a laptop viewport. A schema-first ERD over roughly 8 tables or 50 fields is itself a dense map: author its first complete-field pass at `standard` and upgrade only once the layout still reads.
4. Once the complete first candidate is written, run `finalize` directly. Its first gate is showcase validation; successful first drafts need no separate pre-validation. Keep the candidate unchanged while the command runs:
diff --git a/archify/examples/class-payment-processors-rendered.html b/archify/examples/class-payment-processors-rendered.html
index 4eb02570..4a8e9b20 100644
--- a/archify/examples/class-payment-processors-rendered.html
+++ b/archify/examples/class-payment-processors-rendered.html
@@ -5955,6 +5955,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5970,9 +5981,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11922,6 +11934,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/examples/class-payments-rendered.html b/archify/examples/class-payments-rendered.html
index 2bda9a09..8f9681f0 100644
--- a/archify/examples/class-payments-rendered.html
+++ b/archify/examples/class-payments-rendered.html
@@ -5778,6 +5778,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5793,9 +5804,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11745,6 +11757,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/examples/timeline-archify-dev-activity-rendered.html b/archify/examples/timeline-archify-dev-activity-rendered.html
index 67fffe9d..d25324af 100644
--- a/archify/examples/timeline-archify-dev-activity-rendered.html
+++ b/archify/examples/timeline-archify-dev-activity-rendered.html
@@ -5895,6 +5895,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5910,9 +5921,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11862,6 +11874,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/examples/timeline-payment-incident-rendered.html b/archify/examples/timeline-payment-incident-rendered.html
index cba83800..27b50ced 100644
--- a/archify/examples/timeline-payment-incident-rendered.html
+++ b/archify/examples/timeline-payment-incident-rendered.html
@@ -5751,6 +5751,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5766,9 +5777,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11718,6 +11730,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/examples/waterfall-checkout-request-rendered.html b/archify/examples/waterfall-checkout-request-rendered.html
index 978a1d53..314f73c0 100644
--- a/archify/examples/waterfall-checkout-request-rendered.html
+++ b/archify/examples/waterfall-checkout-request-rendered.html
@@ -5715,6 +5715,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5730,9 +5741,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11682,6 +11694,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/examples/waterfall-example-rebuild-rendered.html b/archify/examples/waterfall-example-rebuild-rendered.html
index 1acab35b..05389d4f 100644
--- a/archify/examples/waterfall-example-rebuild-rendered.html
+++ b/archify/examples/waterfall-example-rebuild-rendered.html
@@ -5886,6 +5886,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5901,9 +5912,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11853,6 +11865,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/archify/package.json b/archify/package.json
index b1771342..f55a70b3 100644
--- a/archify/package.json
+++ b/archify/package.json
@@ -3,7 +3,7 @@
"version": "3.0.2-dev.1",
"private": true,
"type": "module",
- "description": "JSON-IR diagram renderers (architecture / workflow / sequence / dataflow / lifecycle / erd / tree / erd / class / erd / timeline / erd / waterfall).",
+ "description": "JSON-IR diagram renderers (architecture / workflow / sequence / dataflow / lifecycle / erd / class / tree / timeline / waterfall).",
"license": "MIT",
"bin": {
"archify": "./bin/archify.mjs"
diff --git a/examples/class-payment-processors-rendered.html b/examples/class-payment-processors-rendered.html
index 4eb02570..4a8e9b20 100644
--- a/examples/class-payment-processors-rendered.html
+++ b/examples/class-payment-processors-rendered.html
@@ -5955,6 +5955,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5970,9 +5981,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11922,6 +11934,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/examples/class-payments-rendered.html b/examples/class-payments-rendered.html
index 2bda9a09..8f9681f0 100644
--- a/examples/class-payments-rendered.html
+++ b/examples/class-payments-rendered.html
@@ -5778,6 +5778,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5793,9 +5804,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11745,6 +11757,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/examples/timeline-archify-dev-activity-rendered.html b/examples/timeline-archify-dev-activity-rendered.html
index 67fffe9d..d25324af 100644
--- a/examples/timeline-archify-dev-activity-rendered.html
+++ b/examples/timeline-archify-dev-activity-rendered.html
@@ -5895,6 +5895,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5910,9 +5921,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11862,6 +11874,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/examples/timeline-payment-incident-rendered.html b/examples/timeline-payment-incident-rendered.html
index cba83800..27b50ced 100644
--- a/examples/timeline-payment-incident-rendered.html
+++ b/examples/timeline-payment-incident-rendered.html
@@ -5751,6 +5751,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5766,9 +5777,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11718,6 +11730,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/examples/waterfall-checkout-request-rendered.html b/examples/waterfall-checkout-request-rendered.html
index 978a1d53..314f73c0 100644
--- a/examples/waterfall-checkout-request-rendered.html
+++ b/examples/waterfall-checkout-request-rendered.html
@@ -5715,6 +5715,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5730,9 +5741,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11682,6 +11694,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship
diff --git a/examples/waterfall-example-rebuild-rendered.html b/examples/waterfall-example-rebuild-rendered.html
index 1acab35b..05389d4f 100644
--- a/examples/waterfall-example-rebuild-rendered.html
+++ b/examples/waterfall-example-rebuild-rendered.html
@@ -5886,6 +5886,17 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
Array.prototype.forEach.call(clone.querySelectorAll('[data-node-id][aria-pressed]'), function (el) {
el.setAttribute('aria-pressed', 'false');
});
+ // A downloaded tree is always the complete hierarchy: collapsing is a
+ // reading aid, never a silent change to what the artifact contains.
+ clone.removeAttribute('data-tree-any-collapsed');
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-hidden], [data-tree-collapsed]'), function (el) {
+ el.removeAttribute('data-tree-hidden');
+ el.removeAttribute('data-tree-collapsed');
+ });
+ Array.prototype.forEach.call(clone.querySelectorAll('[data-tree-toggle]'), function (el) {
+ el.setAttribute('aria-expanded', 'true');
+ el.setAttribute('aria-label', el.getAttribute('data-tree-label-collapse') || '');
+ });
return !clone.hasAttribute('data-view-scale') &&
!clone.hasAttribute('data-focus-active') &&
!clone.hasAttribute('data-reach-active') &&
@@ -5901,9 +5912,10 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
!clone.hasAttribute('data-route-journey') &&
!clone.hasAttribute('data-share-route') &&
!clone.hasAttribute('data-share-reach') &&
+ !clone.hasAttribute('data-tree-any-collapsed') &&
!clone.style.getPropertyValue('transform') &&
!clone.style.getPropertyValue('clip-path') &&
- clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor]').length === 0;
+ clone.querySelectorAll('[data-focus-match], [data-focus-selected], [data-reach-match], [data-reach-origin], [data-reach-depth], [data-semantic-lens-overlay], [data-lens-match], [data-lens-selected], [data-lens-peer], [data-legend-bridge], [data-legend-kind], [data-legend-bridge-runtime], [data-legend-count], [data-legend-zero], [data-legend-selected], [data-legend-preview-match], [data-legend-preview-selected], [data-legend-preview-peer], [data-relationship-hit-overlay], [data-relationship-pulse-overlay], [data-relationship-preview], [data-relationship-preview-node], [data-relationship-preview-source], [data-relationship-preview-target], [data-intent-trace-overlay], [data-intent-trace-match], [data-intent-trace-selected], [data-route-probe-overlay], [data-route-journey-overlay], [data-route-match], [data-route-start], [data-route-end], [data-route-step], [data-route-candidate], [data-route-journey-state], [data-route-journey-current], [data-share-route-match], [data-share-route-step], [data-share-route-start], [data-share-route-end], [data-share-route-middle], [data-share-reach-match], [data-share-reach-origin], [data-share-reach-depth], [data-source-evidence-beacon], [data-source-evidence-count], [data-source-evidence-original-label], [data-detail], [data-detail-anchor], [data-tree-hidden], [data-tree-collapsed]').length === 0;
}
@@ -11853,6 +11865,146 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
})();
+ /* ============================================================
+ Tree Branches — expand/collapse for hierarchy diagrams. The renderer
+ lays out the complete tree once and tags every node, link, and toggle
+ with its ancestors; collapsing only hides descendants, so visible nodes
+ never move and the reader keeps their place. Selecting a hidden node
+ through Finder, Outline, or a shared link expands its ancestors. Export
+ always writes the complete tree (see Export Cleanup).
+ ============================================================ */
+ Archify.treeBranches = (function () {
+ var svg = document.querySelector('.diagram-container > svg[data-tree-ui]');
+ if (!svg) return { active: false };
+ var collapsed = Object.create(null);
+ var toggles = Object.create(null);
+ Array.prototype.forEach.call(svg.querySelectorAll('[data-tree-toggle]'), function (toggle) {
+ toggles[toggle.getAttribute('data-tree-toggle')] = toggle;
+ });
+ var tagged = svg.querySelectorAll('[data-tree-ancestors]');
+ var expandAll = svg.querySelector('[data-tree-expand-all]');
+
+ function ancestors(el) {
+ return (el.getAttribute('data-tree-ancestors') || '').split(' ').filter(Boolean);
+ }
+
+ function apply() {
+ Array.prototype.forEach.call(tagged, function (el) {
+ var hidden = ancestors(el).some(function (id) { return collapsed[id]; });
+ if (hidden) el.setAttribute('data-tree-hidden', '');
+ else el.removeAttribute('data-tree-hidden');
+ });
+ var any = false;
+ Object.keys(toggles).forEach(function (id) {
+ var toggle = toggles[id];
+ var isCollapsed = Boolean(collapsed[id]);
+ any = any || isCollapsed;
+ toggle.setAttribute('aria-expanded', isCollapsed ? 'false' : 'true');
+ toggle.setAttribute('aria-label', toggle.getAttribute(isCollapsed ? 'data-tree-label-expand' : 'data-tree-label-collapse') || '');
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (node) {
+ if (isCollapsed) node.setAttribute('data-tree-collapsed', '');
+ else node.removeAttribute('data-tree-collapsed');
+ }
+ });
+ if (any) svg.setAttribute('data-tree-any-collapsed', '');
+ else svg.removeAttribute('data-tree-any-collapsed');
+ }
+
+ function setCollapsed(id, value) {
+ if (!toggles[id]) return false;
+ if (value) collapsed[id] = true;
+ else delete collapsed[id];
+ apply();
+ return true;
+ }
+
+ function toggle(id) { return setCollapsed(id, !collapsed[id]); }
+
+ // Reveal a node by expanding every collapsed ancestor; nothing else moves.
+ function reveal(id) {
+ var node = svg.querySelector('[data-node-id="' + id + '"]');
+ if (!node) return false;
+ var changed = false;
+ ancestors(node).forEach(function (ancestor) {
+ if (collapsed[ancestor]) { delete collapsed[ancestor]; changed = true; }
+ });
+ if (changed) apply();
+ return changed;
+ }
+
+ function restoreAll() {
+ collapsed = Object.create(null);
+ apply();
+ }
+
+ function activate(event) {
+ var target = event.target.closest('[data-tree-toggle], [data-tree-expand-all]');
+ if (!target || !svg.contains(target)) return false;
+ event.preventDefault();
+ event.stopPropagation();
+ if (target.hasAttribute('data-tree-expand-all')) {
+ restoreAll();
+ var root = svg.querySelector('[data-tree-toggle]:not([data-tree-ancestors])');
+ if (root) root.focus();
+ } else {
+ toggle(target.getAttribute('data-tree-toggle'));
+ target.focus();
+ }
+ return true;
+ }
+
+ // Capture phase so the canvas focus handler never treats a toggle press
+ // as a background click that clears the current focus.
+ svg.addEventListener('click', activate, true);
+ svg.addEventListener('keydown', function (event) {
+ if (event.key === 'Enter' || event.key === ' ') { activate(event); return; }
+ var node = event.target.closest('[data-node-id]');
+ if (!node || !svg.contains(node)) return;
+ var id = node.getAttribute('data-node-id');
+ // Arrow keys follow the tree convention: left collapses, right expands.
+ if (event.key === 'ArrowLeft' && toggles[id] && !collapsed[id]) { event.preventDefault(); setCollapsed(id, true); }
+ else if (event.key === 'ArrowRight' && collapsed[id]) { event.preventDefault(); setCollapsed(id, false); }
+ }, true);
+
+ // Finder, Outline, guided views, and shared links all select through the
+ // focus state; a selected node must never stay hidden. The public setter
+ // expands ancestors before the camera frames the node, and the observer
+ // covers any path that changes the pressed state directly.
+ if (Archify.focus && typeof Archify.focus.set === 'function') {
+ var focusSet = Archify.focus.set;
+ Archify.focus.set = function (ids) {
+ (Array.isArray(ids) ? ids : [ids]).forEach(function (id) { if (typeof id === 'string') reveal(id); });
+ return focusSet.apply(this, arguments);
+ };
+ }
+ new MutationObserver(function (records) {
+ records.forEach(function (record) {
+ var el = record.target;
+ if (el.hasAttribute && el.hasAttribute('data-tree-hidden') && el.getAttribute('aria-pressed') === 'true') {
+ reveal(el.getAttribute('data-node-id'));
+ }
+ });
+ }).observe(svg, { subtree: true, attributes: true, attributeFilter: ['aria-pressed'] });
+
+ Object.keys(toggles).forEach(function (id) {
+ if (toggles[id].hasAttribute('data-tree-initially-collapsed')) collapsed[id] = true;
+ });
+ apply();
+
+ return {
+ active: true,
+ toggle: toggle,
+ collapse: function (id) { return setCollapsed(id, true); },
+ expand: function (id) { return setCollapsed(id, false); },
+ reveal: reveal,
+ restoreAll: restoreAll,
+ collapsedIds: function () { return Object.keys(collapsed); },
+ expandAllControl: expandAll
+ };
+ })();
+
+
/* ============================================================
Route Probe — shortest directed path over compiled semantics.
The graph is read from renderer-owned stable IDs and relationship