@issuegraph/editor 0.1.0

package/dist/scale/ladder.js

@@ -0,0 +1,243 @@
+/**
+ * The scale ladder — which of the three canvas tiers applies, and the route out
+ * of the two that refuse.
+ *
+ * The list scales; the graph does not, and that is fine because they answer
+ * different questions. The order rail is complete at any size — "what gets
+ * worked next" is answerable for every issue in the document — while the canvas
+ * is a LOCAL instrument answering "what surrounds this issue". So past its
+ * budget the canvas refuses rather than thinning, and this module is what makes
+ * that refusal actionable.
+ *
+ * ## Why this is layer 2 rather than more of layer 1
+ *
+ * `@issuegraph/viewer` already decides the same three tiers and already draws a
+ * refusal — deliberately an INFORMATIONAL one. Its own source says why: that
+ * package does not narrow, it renders exactly what it is given, so a control it
+ * published could never complete the action it advertised. Narrowing is the
+ * host's, and the editor is the host. What lands here is only the half layer 1
+ * refused to own: a component the reader can actually choose, a search that
+ * reaches one, and a chip that opens the issues the canvas leaves out.
+ *
+ * ## What this module deliberately does not compute
+ *
+ * Components, blocking counts, cycle flags and chain depth all come from
+ * `clustersOf` in the viewer. A second pass out here would be a mirror whose
+ * input space drifts from the canvas it is describing — the exact failure the
+ * package split exists to prevent — and the two would eventually disagree about
+ * whether a component contains a cycle while both were rendered on one screen.
+ */
+import { CLUSTER_ONLY_BUDGET, GRAPH_NODE_BUDGET, clustersOf, normalizeDocument, } from '@issuegraph/viewer';
+import { INITIAL_SCALE_STATE } from "./commands.js";
+/**
+ * The ladder, as the design's table rather than as branches — and pinned to the
+ * viewer's exported budgets rather than restating their numbers, so the tier
+ * and the canvas cannot disagree about what "past budget" means.
+ */
+const CLUSTERS_ONLY = { tier: 'clusters', ceiling: Number.POSITIVE_INFINITY };
+const TIERS = [
+    { tier: 'direct', ceiling: GRAPH_NODE_BUDGET },
+    { tier: 'capsules', ceiling: CLUSTER_ONLY_BUDGET },
+    CLUSTERS_ONLY,
+];
+/** How many capsules the cluster-only tier lists before it says it stopped. */
+const CAPSULE_LIMIT = 12;
+/** How many search matches are listed before the search says it stopped. */
+const MATCH_LIMIT = 20;
+function tierFor(nodeCount) {
+    // The last step's ceiling is infinite, so the fallback is unreachable — it
+    // stays because a total function must not depend on a reader noticing that.
+    return TIERS.find((step) => nodeCount <= step.ceiling) ?? CLUSTERS_ONLY;
+}
+/** The keys carrying at least one relationship: exactly what the canvas draws. */
+function relatedKeys(document) {
+    const keys = new Set();
+    for (const issue of document.issues) {
+        if ((document.edgesOf.get(issue.key) ?? []).length > 0)
+            keys.add(issue.key);
+    }
+    return keys;
+}
+/**
+ * The document restricted to `keep`.
+ *
+ * IT NARROWS THE NORMALIZED DOCUMENT, NEVER THE RAW INPUT, and that is a
+ * correctness rule rather than a convenience. Two things go wrong otherwise.
+ *
+ * The canvas is handed straight to `renderViewer`, which normalizes whatever it
+ * is given — so raw values re-derive every diagnostic this function already
+ * collected about them, and a host surfacing diagnostics sees each one twice.
+ * Worse, `keep` is built from the NORMALIZED document: normalization drops a
+ * duplicate key and strips a url whose scheme the viewer will not link, so
+ * filtering the raw input against a normalized key set can hand the canvas an
+ * issue the ladder never counted — the ladder and the canvas disagreeing about
+ * the node count, which is the one thing this module promises they cannot do.
+ *
+ * A SLOT SURVIVES ONLY IF EVERY MEMBER DOES. A together unit is one position
+ * with several members, and half a unit is not a smaller unit — it is a
+ * different claim about what gets worked together. Members of one unit are
+ * joined by a `together-with` edge, so they are always in the same component
+ * and a focus never splits one; the rule is written for the isolated-exclusion
+ * pass, where a unit could otherwise lose a member that happens to be edge-free.
+ */
+function narrow(input, keep) {
+    return {
+        issues: input.issues.filter((issue) => keep.has(issue.key)),
+        edges: input.edges.filter((edge) => keep.has(edge.from) && keep.has(edge.to)),
+        order: {
+            slots: input.order.slots.filter((slot) => slot.members.every((member) => keep.has(member))),
+            excluded: input.order.excluded.filter((exclusion) => keep.has(exclusion.key)),
+        },
+    };
+}
+/**
+ * A capsule, or `null` for a component with no members.
+ *
+ * NULL RATHER THAN AN EMPTY LEAD. `''` would render a control reading "Focus "
+ * that focuses nothing — an affordance that cannot complete its own action,
+ * which is the exact class the viewer's refusal spent four rounds removing.
+ * `clustersOf` never returns one today; this is what keeps that from becoming a
+ * silent contract.
+ */
+function capsuleOf(cluster) {
+    // `members` is already in the viewer's deterministic order, so the first is a
+    // stable handle rather than whichever member the walk happened to reach first.
+    const lead = cluster.members[0];
+    if (lead === undefined)
+        return null;
+    return {
+        lead,
+        size: cluster.members.length,
+        blockedByEdges: cluster.blockedByEdges,
+        chainDepth: cluster.chainDepth,
+        hasCycle: cluster.hasCycle,
+        members: cluster.members,
+    };
+}
+/** Why the canvas declined, in the reader's terms. One sentence, three cases. */
+function reasonFor(tier, nodeCount, focused) {
+    if (focused) {
+        return `The component you focused is ${String(nodeCount)} issues, itself past this canvas's budget of ${String(GRAPH_NODE_BUDGET)}, so it is not drawing them.`;
+    }
+    if (tier === 'clusters') {
+        return `${String(nodeCount)} related issues is far past this canvas's budget of ${String(GRAPH_NODE_BUDGET)} — past the cluster-only budget of ${String(CLUSTER_ONLY_BUDGET)} as well — so it is listing components and leading with search.`;
+    }
+    return `${String(nodeCount)} related issues is past this canvas's budget of ${String(GRAPH_NODE_BUDGET)}, so it is not drawing them.`;
+}
+function refusalFor(tier, nodeCount, focused, hasCapsules) {
+    if (tier === 'direct')
+        return null;
+    // ALWAYS AT LEAST TWO. Search reaches a component whatever the tier, and the
+    // order rail is complete at any size — so a refusal is never a dead end, and
+    // the emptiness of this list is not something a caller has to defend against.
+    const routes = [];
+    if (hasCapsules) {
+        routes.push({ kind: 'focus-cluster', label: 'Focus one component to draw it on its own.' });
+    }
+    if (focused) {
+        routes.push({ kind: 'clear-focus', label: 'Return to every component.' });
+    }
+    routes.push({
+        kind: 'search',
+        label: 'Search for an issue to focus the component around it.',
+    });
+    routes.push({
+        kind: 'order-rail',
+        label: 'The order list is complete at any size — nothing about the sequence is refused here.',
+    });
+    return {
+        reason: reasonFor(tier, nodeCount, focused),
+        nodeCount,
+        budget: GRAPH_NODE_BUDGET,
+        routes,
+    };
+}
+function searchFor(query, document, leadOf) {
+    const needle = query.trim().toLowerCase();
+    if (needle === '')
+        return { query, matches: [], omitted: 0 };
+    const found = [];
+    for (const issue of document.issues) {
+        // ONLY ISSUES THAT SIT IN A COMPONENT. This search exists to focus one, and
+        // an issue with no relationship has none to focus — offering it would be a
+        // match that cannot be acted on. The issues it leaves out are the ones the
+        // isolated chip is for, which is why the chip is not optional chrome.
+        const lead = leadOf.get(issue.key);
+        if (lead === undefined)
+            continue;
+        if (!issue.key.toLowerCase().includes(needle) &&
+            !issue.title.toLowerCase().includes(needle)) {
+            continue;
+        }
+        found.push({ key: issue.key, title: issue.title, lead });
+    }
+    return {
+        query,
+        matches: found.slice(0, MATCH_LIMIT),
+        omitted: Math.max(0, found.length - MATCH_LIMIT),
+    };
+}
+/**
+ * Resolve one document and one reader position into a ladder.
+ *
+ * Pure and total: no global is read, nothing is fetched, and a `focus` naming a
+ * key this document does not place in any component produces a diagnostic and
+ * every component, rather than a silently unnarrowed canvas that looks focused.
+ */
+export function scaleLadder(input, state = INITIAL_SCALE_STATE) {
+    const { document, diagnostics: normalizeDiagnostics } = normalizeDocument(input);
+    const diagnostics = [...normalizeDiagnostics];
+    const related = relatedKeys(document);
+    const clusters = clustersOf(document);
+    const leadOf = new Map();
+    for (const cluster of clusters) {
+        const lead = cluster.members[0];
+        if (lead === undefined)
+            continue;
+        for (const member of cluster.members)
+            leadOf.set(member, lead);
+    }
+    const requested = state.focus;
+    const focusedCluster = requested === null
+        ? null
+        : (clusters.find((cluster) => cluster.members.includes(requested)) ?? null);
+    if (requested !== null && focusedCluster === null) {
+        diagnostics.push(`focus ${requested} is in no component of this document; showing every component instead`);
+    }
+    const keep = focusedCluster === null ? related : new Set(focusedCluster.members);
+    const canvas = narrow(document, keep);
+    const nodeCount = keep.size;
+    const { tier } = tierFor(nodeCount);
+    // NO CAPSULES WHILE ONE COMPONENT IS FOCUSED. The reader is already inside a
+    // component; listing every other one under a refusal about THIS one would
+    // read as an offer to focus what is already focused.
+    const listable = focusedCluster === null ? clusters : [];
+    const shown = tier === 'clusters' ? listable.slice(0, CAPSULE_LIMIT) : listable;
+    const capsules = tier === 'direct'
+        ? []
+        : shown.map(capsuleOf).filter((capsule) => capsule !== null);
+    const isolatedIssues = document.issues.filter((issue) => !related.has(issue.key));
+    const isolated = {
+        count: isolatedIssues.length,
+        label: `${String(isolatedIssues.length)} isolated ${isolatedIssues.length === 1 ? 'issue' : 'issues'}, with no relationship to draw`,
+        open: state.isolatedOpen,
+        issues: state.isolatedOpen ? isolatedIssues : [],
+    };
+    return {
+        tier,
+        nodeCount,
+        budgets: { node: GRAPH_NODE_BUDGET, clusterOnly: CLUSTER_ONLY_BUDGET },
+        focus: focusedCluster === null ? null : requested,
+        refusal: refusalFor(tier, nodeCount, focusedCluster !== null, capsules.length > 0),
+        capsules,
+        // COUNTED AGAINST WHAT WAS LISTED, not against what was sliced. A component
+        // dropped for having no members is as absent from the list as one past the
+        // limit, and reporting only the slice would under-count it.
+        capsulesOmitted: tier === 'direct' ? 0 : listable.length - capsules.length,
+        isolated,
+        search: tier === 'direct' ? null : searchFor(state.query, document, leadOf),
+        canvas,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=ladder.js.map

package/dist/scale/ladder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ladder.js","sourceRoot":"","sources":["../../src/scale/ladder.ts"],"names":[],"mappings":"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"}

package/dist/scale/render.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The ladder, as markup.
+ *
+ * Pure, like `renderViewer` and for the same reason that package gives: a
+ * rendering package whose output can only be inspected by mounting it cannot be
+ * tested at the level its correctness actually lives at. Everything below is
+ * reachable without a DOM.
+ *
+ * ## The command contract
+ *
+ * Every control this renders publishes what it does as data — `data-ig-command`
+ * names the {@link ScaleCommand} kind, `data-ig-target` carries the key a
+ * `focus` needs, and the search input carries its own query as its value. A
+ * host reads them, calls `scaleReducer`, and renders again.
+ *
+ * THAT INDIRECTION IS THE POINT, not a missing wire. The viewer learned this
+ * the expensive way: a control that cannot complete the action it advertises
+ * draws a finding every round, and the fix was to stop publishing one from a
+ * layer that could not narrow. Layer 2 CAN narrow, so it publishes the controls
+ * — but the narrowing still happens by re-rendering with new state, which means
+ * the dispatcher is whatever owns that state. Wiring the listeners and
+ * restoring focus across the redraw is a mount's job and lands with the
+ * workspace that owns one.
+ *
+ * ## What is drawn, and what is not
+ *
+ * The canvas is rendered through `@issuegraph/viewer` ONLY on the tier that
+ * draws one. Handing an over-budget document to the viewer would make it draw
+ * its own refusal beside this one — two refusals about one document, one of
+ * which has no routes.
+ */
+import { type Theme, type ViewerDocument } from '@issuegraph/viewer';
+import { type ScaleState } from './commands.ts';
+import { type ScaleLadder } from './ladder.ts';
+export interface ScaleLadderOptions {
+    readonly state?: ScaleState | undefined;
+    readonly theme?: Theme | undefined;
+    /** The selector the theme's custom properties are written onto. */
+    readonly themeSelector?: string | undefined;
+    /**
+     * The selected issue key, handed to the viewer as `aria-current`.
+     *
+     * ADDITIVE AND OPTIONAL, for the surface that assembles this beside a rail.
+     * A workspace holds ONE selection and every zone reads it, so a canvas that
+     * could not be told what is selected made the shared value disagree with
+     * itself between zones on every render — the rail marking a row current while
+     * the graph drew the same issue as ordinary.
+     *
+     * Reaches the viewer only on the tier that draws one; there is nothing to
+     * mark on a tier whose canvas is a refusal.
+     */
+    readonly selected?: string | null | undefined;
+    /**
+     * The selected EDGE's identity, drawn on the canvas as a selection halo.
+     *
+     * THE OTHER HALF OF `selected`, AND IT COULD NOT BE FOLDED INTO IT. A
+     * workspace holds one selection of one of two kinds, and the viewer's own
+     * `selected` renders `aria-current` on a NODE — so an edge identity handed to
+     * that option matches nothing, and the canvas drew the selected edge as
+     * ordinary while the inspector was filtered to it. One value, two zones, and
+     * the canvas was the zone that could not read it.
+     *
+     * THE LADDER APPLIES THE OVERLAY ITSELF rather than publishing its scene for
+     * a caller to decorate. Exposing the scene would have left two ways to obtain
+     * this canvas's markup — `result.markup`, and a re-render of the decorated
+     * scene — with the first silently wrong for an edge selection. A result with
+     * a stale field beside a correct one is worse than a narrower option.
+     *
+     * Resolved against `ladder.canvas`, which is what this canvas actually draws:
+     * a narrowed tier, or a refusal that draws no canvas at all, renders as
+     * nothing selected rather than as a halo on a line that is not there.
+     */
+    readonly selectedEdge?: string | null | undefined;
+}
+export interface ScaleLadderResult {
+    readonly ladder: ScaleLadder;
+    /** The canvas, when there is one, followed by the ladder's own chrome. */
+    readonly markup: string;
+    /** The viewer's stylesheet, the theme, and the chrome's own. Install all. */
+    readonly styles: string;
+    readonly diagnostics: readonly string[];
+}
+/** Render one document at one reader position. */
+export declare function renderScaleLadder(input: ViewerDocument, options?: ScaleLadderOptions): ScaleLadderResult;
+//# sourceMappingURL=render.d.ts.map

package/dist/scale/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/scale/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,cAAc,EAOpB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAEL,KAAK,WAAW,EAIjB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAyHD,kDAAkD;AAClD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAsFnB"}

package/dist/scale/render.js

@@ -0,0 +1,194 @@
+/**
+ * The ladder, as markup.
+ *
+ * Pure, like `renderViewer` and for the same reason that package gives: a
+ * rendering package whose output can only be inspected by mounting it cannot be
+ * tested at the level its correctness actually lives at. Everything below is
+ * reachable without a DOM.
+ *
+ * ## The command contract
+ *
+ * Every control this renders publishes what it does as data — `data-ig-command`
+ * names the {@link ScaleCommand} kind, `data-ig-target` carries the key a
+ * `focus` needs, and the search input carries its own query as its value. A
+ * host reads them, calls `scaleReducer`, and renders again.
+ *
+ * THAT INDIRECTION IS THE POINT, not a missing wire. The viewer learned this
+ * the expensive way: a control that cannot complete the action it advertises
+ * draws a finding every round, and the fix was to stop publishing one from a
+ * layer that could not narrow. Layer 2 CAN narrow, so it publishes the controls
+ * — but the narrowing still happens by re-rendering with new state, which means
+ * the dispatcher is whatever owns that state. Wiring the listeners and
+ * restoring focus across the redraw is a mount's job and lands with the
+ * workspace that owns one.
+ *
+ * ## What is drawn, and what is not
+ *
+ * The canvas is rendered through `@issuegraph/viewer` ONLY on the tier that
+ * draws one. Handing an over-budget document to the viewer would make it draw
+ * its own refusal beside this one — two refusals about one document, one of
+ * which has no routes.
+ */
+import { element, renderMarkup, renderViewer, resolveTheme, themeCss, viewerStylesheet, } from '@issuegraph/viewer';
+import { edgeIdentity } from '@issuegraph/core';
+import { attachEdgeOverlays } from "../overlay/render.js";
+import { edgeOverlayStylesheet } from "../overlay/styles.js";
+import { INITIAL_SCALE_STATE } from "./commands.js";
+import { scaleLadder, } from "./ladder.js";
+import { scaleLadderStylesheet } from "./styles.js";
+function refusalSpec(refusal, ladder) {
+    return element('section', { class: 'ig-refusal', role: 'note' }, [
+        element('p', {}, [refusal.reason]),
+        ladder.capsules.length === 0
+            ? null
+            : element('ol', { class: 'ig-list', 'aria-label': 'connected components' }, ladder.capsules.map((capsule) => element('li', { class: 'ig-capsule' }, [
+                element('button', {
+                    type: 'button',
+                    'data-ig-command': 'focus',
+                    'data-ig-target': capsule.lead,
+                }, [`Focus ${capsule.lead}`]),
+                element('span', { class: 'ig-count' }, [`${String(capsule.size)} issues`]),
+                element('span', { class: 'ig-count' }, [
+                    `${String(capsule.blockedByEdges)} blocking`,
+                ]),
+                element('span', { class: 'ig-count' }, [`depth ${String(capsule.chainDepth)}`]),
+                capsule.hasCycle
+                    ? element('span', { class: 'ig-badge', 'data-edge': 'blocked-by' }, ['cycle'])
+                    : null,
+                element('span', { class: 'ig-id' }, [capsule.members.slice(0, 3).join(', ')]),
+            ]))),
+        ladder.capsulesOmitted > 0
+            ? element('p', { class: 'ig-refusal-omitted' }, [
+                `${String(ladder.capsulesOmitted)} further ${ladder.capsulesOmitted === 1 ? 'component is' : 'components are'} not listed.`,
+            ])
+            : null,
+        element('ul', { class: 'ig-ladder-routes', 'aria-label': 'what to do next' }, refusal.routes.map((route) => element('li', { class: 'ig-refusal-next', 'data-route': route.kind }, [route.label]))),
+    ]);
+}
+function searchSpec(search) {
+    return element('div', { class: 'ig-ladder-search' }, [
+        // THE INPUT SITS INSIDE ITS LABEL, so the two are associated without an
+        // `id`. A fixed `id` is not a detail here: a host rendering two documents
+        // side by side would emit it twice, and a duplicated `id` makes `for`
+        // resolve to whichever came first — so one of the two search boxes would
+        // silently lose its label.
+        element('label', {}, [
+            'Search to focus a component',
+            element('input', {
+                type: 'search',
+                'data-ig-command': 'search',
+                value: search.query,
+                autocomplete: 'off',
+            }),
+        ]),
+        search.matches.length === 0
+            ? null
+            : element('ol', { class: 'ig-list', 'aria-label': 'search matches' }, search.matches.map((match) => element('li', { class: 'ig-ladder-match' }, [
+                element('button', { type: 'button', 'data-ig-command': 'focus', 'data-ig-target': match.lead }, [`Focus ${match.key}`]),
+                element('span', { class: 'ig-title' }, [match.title]),
+            ]))),
+        search.omitted > 0
+            ? element('p', { class: 'ig-refusal-omitted' }, [
+                `${String(search.omitted)} further ${search.omitted === 1 ? 'match is' : 'matches are'} not listed.`,
+            ])
+            : null,
+    ]);
+}
+function isolatedSpec(isolated) {
+    // NOTHING IS DRAWN FOR AN EMPTY SET. A chip reading "0 isolated issues" is a
+    // control that opens nothing, and the count IS the information these issues
+    // carry — so with no issues there is nothing to say.
+    if (isolated.count === 0)
+        return null;
+    return element('div', { class: 'ig-ladder-isolated' }, [
+        element('button', {
+            type: 'button',
+            class: 'ig-chip',
+            'aria-expanded': isolated.open ? 'true' : 'false',
+            'data-ig-command': isolated.open ? 'close-isolated' : 'open-isolated',
+        }, [isolated.label]),
+        // A LIST, NEVER A CANVAS. These issues have no relationship to draw, which
+        // is exactly why they were collapsed in the first place.
+        isolated.open
+            ? element('ol', { class: 'ig-isolated-list', 'aria-label': 'isolated issues' }, isolated.issues.map((issue) => element('li', {}, [
+                element('span', { class: 'ig-id' }, [issue.key]),
+                element('span', { class: 'ig-title' }, [issue.title]),
+            ])))
+            : null,
+    ]);
+}
+/** Render one document at one reader position. */
+export function renderScaleLadder(input, options = {}) {
+    const state = options.state ?? INITIAL_SCALE_STATE;
+    const ladder = scaleLadder(input, state);
+    const theme = resolveTheme(options.theme);
+    const canvas = ladder.tier === 'direct'
+        ? renderViewer(ladder.canvas, { projection: 'graph', theme, selected: options.selected ?? null })
+        : null;
+    // THE SELECTION HALO, ATTACHED TO THE SCENE THE CANVAS JUST DREW.
+    //
+    // Resolved against `ladder.canvas.edges` — the document this canvas was
+    // rendered from — rather than against the caller's input. An identity that
+    // names an edge this tier does not draw resolves to nothing here, which is
+    // the same promise every other zone makes: a selection is a NAME, and a name
+    // that no longer resolves renders as nothing selected.
+    const selectedEdge = canvas === null || options.selectedEdge === null || options.selectedEdge === undefined
+        ? null
+        : (ladder.canvas.edges.find((edge) => edgeIdentity(edge.field, edge.from, edge.to) === options.selectedEdge) ?? null);
+    // `states: ['selected']` AND NOTHING ELSE, deliberately. The write states are
+    // the store's to report — this synthesises the one state that is not about a
+    // write, which is exactly how `EDGE_STATES` describes `selected`. An edge
+    // that is ALSO mid-write is overlaid by whoever holds those writes; the two
+    // compose, because `overlayFor` reads a list.
+    const selectedOverlay = selectedEdge === null
+        ? null
+        : {
+            id: edgeIdentity(selectedEdge.field, selectedEdge.from, selectedEdge.to),
+            kind: selectedEdge.field,
+            from: selectedEdge.from,
+            to: selectedEdge.to,
+            states: ['selected'],
+            writes: [],
+        };
+    // `unattached` IS DELIBERATELY NOT SURFACED HERE, and the reason is a fact
+    // about this call site rather than about the value.
+    //
+    // `attachEdgeOverlays` reports an overlay whose edge the scene did not draw
+    // because a caller can hand it edges from anywhere. This one hands it exactly
+    // one edge, found moments earlier IN `ladder.canvas` — the same document the
+    // scene beside it was rendered from — and layer 1 states that geometry cannot
+    // fail for a kept edge: `edgeGeometry` returns `null` only when "a caller
+    // built a layout from a different document than the edge came from".
+    //
+    // So the one state this would report is one the inputs cannot reach, and the
+    // near miss it looks like — the viewer refusing under a `direct` tier —
+    // already reports itself through `canvas.diagnostics`. A diagnostic string no
+    // test can make appear is a claim about behaviour nobody can check; the
+    // reasoning is worth more here than the branch.
+    const overlaid = canvas === null || selectedOverlay === null
+        ? null
+        : attachEdgeOverlays(canvas.scene, [selectedOverlay], { theme });
+    const chrome = element('section', { class: 'ig-ladder', 'data-tier': ladder.tier }, [
+        ladder.focus === null
+            ? null
+            : element('button', { type: 'button', class: 'ig-chip', 'data-ig-command': 'clear-focus' }, ['Return to every component']),
+        ladder.refusal === null ? null : refusalSpec(ladder.refusal, ladder),
+        ladder.search === null ? null : searchSpec(ladder.search),
+        isolatedSpec(ladder.isolated),
+    ]);
+    return {
+        ladder,
+        // SIBLINGS RATHER THAN A HAND-BUILT WRAPPER. Every byte here comes from
+        // `renderMarkup`, so no attribute value in this package is ever
+        // concatenated into markup by hand — which is the escaping surface a
+        // second, hand-rolled renderer would have introduced.
+        markup: `${overlaid === null ? (canvas?.markup ?? '') : renderMarkup(overlaid.scene.root)}${renderMarkup(chrome)}`,
+        // THE OVERLAY'S OWN SHEET TRAVELS WITH THE MARKUP THAT NEEDS IT. The halo
+        // is a class this package styles, so a canvas that can draw one and a
+        // stylesheet a caller has to remember separately is a mark that renders
+        // invisibly whenever the caller forgets.
+        styles: `${viewerStylesheet}\n${themeCss(theme, options.themeSelector ?? ':root')}\n${scaleLadderStylesheet}\n${edgeOverlayStylesheet}`,
+        diagnostics: [...ladder.diagnostics, ...(canvas?.diagnostics ?? [])],
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/scale/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/scale/render.ts"],"names":[],"mappings":"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"}

package/dist/scale/styles.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The ladder chrome's structural stylesheet.
+ *
+ * Same contract as the viewer's, and for the same reason: it carries layout,
+ * weight and state, never a value. Every colour, length and font here is a
+ * `var(--ig-…)` the host's theme resolves, so a second theme keeps working on
+ * the surfaces layer 2 adds rather than only on layer 1's. `styles.test.ts`
+ * scans these bytes for a literal colour or a fixed length and for a token the
+ * theme does not define, so the rule is enforced rather than remembered.
+ *
+ * IT ADDS SELECTORS RATHER THAN REDEFINING THEM. The refusal, its capsules and
+ * their counts already have a look — this file styles only what layer 2
+ * introduces: the ladder container, the routes, the search box, the isolated
+ * chip and the list it opens.
+ *
+ * Shipped as a string for the same reason the viewer's is: an entry that
+ * imports CSS cannot be loaded by a bare Node runtime, and a string needs no
+ * bundler.
+ */
+export declare const scaleLadderStylesheet = "\n.ig-ladder {\n  display: flex;\n  flex-direction: column;\n  gap: var(--ig-space);\n  font-family: var(--ig-font-ui);\n  font-size: var(--ig-font-size);\n  line-height: var(--ig-line-height);\n  color: var(--ig-text-body);\n}\n\n.ig-ladder-routes {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: var(--ig-space-tight);\n  color: var(--ig-text-muted);\n  font-size: var(--ig-font-size-small);\n}\n\n.ig-ladder-search {\n  display: flex;\n  flex-direction: column;\n  gap: var(--ig-space-tight);\n}\n\n.ig-ladder-search input {\n  background: var(--ig-surface);\n  color: var(--ig-text);\n  border: var(--ig-stroke) solid var(--ig-line);\n  border-radius: var(--ig-radius);\n  padding: var(--ig-space-tight);\n  font-family: var(--ig-font-ui);\n  font-size: var(--ig-font-size);\n}\n\n.ig-ladder-search input:focus-visible {\n  outline: var(--ig-focus-ring) solid var(--ig-focus);\n  outline-offset: var(--ig-space-tight);\n}\n\n.ig-ladder-match {\n  display: flex;\n  gap: var(--ig-space-tight);\n  align-items: baseline;\n}\n\n.ig-chip {\n  align-self: flex-start;\n  background: var(--ig-surface-2);\n  color: var(--ig-text-body);\n  border: var(--ig-stroke) solid var(--ig-line);\n  border-radius: var(--ig-radius);\n  padding: var(--ig-space-tight) var(--ig-space);\n  font-family: var(--ig-font-ui);\n  font-size: var(--ig-font-size-small);\n  cursor: pointer;\n}\n\n.ig-chip:focus-visible {\n  outline: var(--ig-focus-ring) solid var(--ig-focus);\n  outline-offset: var(--ig-space-tight);\n}\n\n.ig-chip[aria-expanded='true'] {\n  border-color: var(--ig-accent);\n  color: var(--ig-text);\n}\n\n.ig-isolated-list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: var(--ig-space-tight);\n}\n\n.ig-isolated-list .ig-id {\n  font-family: var(--ig-font-mono);\n  color: var(--ig-text-muted);\n}\n";
+//# sourceMappingURL=styles.d.ts.map

package/dist/scale/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/scale/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,qBAAqB,23DAoFjC,CAAC"}