@issuegraph/viewer 0.1.0

package/dist/mount.js

@@ -0,0 +1,402 @@
+/**
+ * The DOM shell — the only module in this package that touches nodes.
+ *
+ * It is deliberately thin. Everything that could be wrong about WHAT is drawn
+ * lives in the projections, everything that could be wrong about WHERE
+ * navigation goes lives in `navigate`, and what is left here is three
+ * listeners, an index from key to element, and a teardown. A shell that grew
+ * decisions would be a second implementation of the parts above it, testable
+ * only through a DOM.
+ *
+ * IT REACHES NO GLOBAL. The document comes from the container the caller
+ * passed, which is what keeps this module importable on a runtime that has no
+ * DOM — the property the workspace smoke test measures against the published
+ * entry.
+ */
+import { normalizeDocument } from "./document.js";
+import { materialize } from "./element.js";
+import { initialNavigationState, navigate, reconcile, } from "./navigation.js";
+import { sceneFor } from "./render.js";
+import { GROUP_ATTRIBUTE, KEY_ATTRIBUTE } from "./scene.js";
+import { defaultTheme } from "./theme.js";
+/**
+ * Elements that own their own keyboard activation.
+ *
+ * Every row deliberately carries a deep-link chip, and `keydown` BUBBLES — so
+ * the viewer's own Enter/Space handling ran while focus was on the anchor,
+ * called `preventDefault()`, and suppressed the link. A projection that exposes
+ * a link a keyboard cannot follow has not exposed it.
+ */
+const SELF_ACTIVATING_TAGS = new Set([
+    'A',
+    'BUTTON',
+    'INPUT',
+    'SELECT',
+    'TEXTAREA',
+]);
+function ownsItsOwnActivation(target, container) {
+    let cursor = target ?? null;
+    while (cursor !== null && cursor !== container) {
+        const tag = cursor.tagName;
+        if (tag !== undefined && SELF_ACTIVATING_TAGS.has(tag.toUpperCase()))
+            return true;
+        cursor = cursor.parentElement;
+    }
+    return false;
+}
+/**
+ * Walk up from an event target to the nearest element carrying a key.
+ *
+ * BOUNDED AT THE CONTAINER. An unbounded walk keeps climbing into the host's
+ * own page, so an ancestor that happens to carry `data-ig-key` — a host
+ * rendering two viewers, or reusing the attribute — would answer for a click
+ * that landed on nothing of ours. Stopping at the mount point makes the answer
+ * a fact about this viewer.
+ *
+ * DECORATION ANSWERS TOO, through {@link GROUP_ATTRIBUTE}. The enclosure and
+ * its connector are deliberately outside the focus index — one element per key
+ * or `focus()` lands on the wrong one — but they are still visible marks a
+ * reader can click, and the design states the connector IS a click target.
+ * Reading both attributes here separates "what may take focus" from "what may
+ * be pointed at" rather than making one attribute answer both.
+ */
+function keyAt(target, container, 
+// WHICH IDENTITY IS BEING ASKED FOR. Pointing and focusing are different
+// questions — see the note above — so the caller names the attributes rather
+// than a second near-identical walk being written for the narrower one, which
+// is how two walkers drift apart.
+attributes = [KEY_ATTRIBUTE, GROUP_ATTRIBUTE]) {
+    let cursor = target ?? null;
+    while (cursor !== null) {
+        for (const attribute of attributes) {
+            const key = cursor.getAttribute(attribute);
+            if (key !== null && key !== '')
+                return key;
+        }
+        if (cursor === container)
+            return null;
+        cursor = cursor.parentElement;
+    }
+    return null;
+}
+/**
+ * Mount a viewer into a container.
+ *
+ * Returns a handle rather than nothing, because a host that cannot tear this
+ * down leaks a listener on every re-render — the shell's one genuine hazard.
+ */
+export function mountViewer(container, input, options = {}) {
+    const doc = container.ownerDocument;
+    let currentOptions = options;
+    let projection = options.projection ?? 'linear';
+    let normalized = normalizeDocument(input).document;
+    // SEEDED FROM THE OPTIONS, not from nothing. `MountOptions` carries
+    // `selected` and `focused` because it extends the render options, so a caller
+    // restoring a view — after a projection toggle, a route change, a reload —
+    // passes them here. Starting empty silently discarded them and dropped the
+    // caller straight back to the top of the order.
+    let state = {
+        focused: options.focused ?? initialNavigationState.focused,
+        selected: options.selected ?? initialNavigationState.selected,
+    };
+    let root = null;
+    let keyed = new Map();
+    let hovered = null;
+    let destroyed = false;
+    // Set by the first `draw()` below, which runs before any listener can fire.
+    let currentScene = null;
+    const theme = options.theme ?? defaultTheme;
+    // ONE PLACE THAT CLEARS A HOVER, because forgetting a site is exactly how this
+    // kept going wrong: `pointerleave` had it, then a redraw needed it, and now
+    // teardown does too. Three call sites open-coding two lines is a fourth site
+    // waiting to omit them, so the rule lives here and the sites ask for it.
+    const clearHover = () => {
+        if (hovered === null)
+            return;
+        hovered = null;
+        currentOptions.onHover?.(null);
+    };
+    // `announceSelection` is false ONLY for the redraw `emitSelect` runs, which
+    // reports the settled selection itself — see there. Every other caller wants
+    // the notice, because a reconciliation that moves the selection has moved it
+    // out from under whoever set it.
+    const draw = (announceSelection = true) => {
+        // A DOCUMENT UPDATE CAN REMOVE THE SELECTED ISSUE, and `reconcile` carries
+        // the selection through whole — deliberately, because a PROJECTION switch
+        // changes representation rather than subject and dropping it there would
+        // lose the thing the reader is looking at. A document REPLACEMENT is the
+        // other case: the subject can genuinely be gone, and the handle went on
+        // reporting a key this document does not carry, against `update`'s own
+        // documented promise that a still-present selection survives.
+        // THE TEST IS DOCUMENT MEMBERSHIP, WHICH IS WHY IT COSTS THE PROJECTION
+        // SWITCH NOTHING. `setProjection` redraws against the SAME `normalized`, so
+        // `byKey` is unchanged and a still-present selection passes untouched —
+        // preserved across a projection-only change and reconciled on replacement,
+        // from one rule rather than from two entry points that can disagree.
+        // THE SAME SHAPE AND THE SAME TEST AS THE HOVER RECONCILIATION at the foot
+        // of this function, sitting apart from it only because the selection has to
+        // be settled BEFORE the scene is built: `sceneFor` is handed
+        // `state.selected`, so clearing afterwards would draw one frame marking a
+        // selection that no longer exists.
+        // WHAT THE SELECTION WAS BEFORE THIS DRAW TOUCHED IT. Two things can move
+        // it — the document-membership drop just below, and `reconcile`'s
+        // canonicalization to the station this projection draws it under — and the
+        // host has to hear about BOTH. Keying the notice on a single `dropped` flag
+        // covered only the first, so `setProjection` renamed the selection and told
+        // nobody: the handle read the station while the host still held the member.
+        const selectedBefore = state.selected;
+        if (state.selected !== null && !normalized.byKey.has(state.selected)) {
+            state = { ...state, selected: null };
+        }
+        if (root !== null)
+            container.removeChild(root);
+        const scene = sceneFor(normalized, projection, {
+            ...currentOptions,
+            theme: currentOptions.theme ?? theme,
+            selected: state.selected,
+            focused: state.focused,
+        });
+        state = reconcile(scene, state);
+        keyed = new Map();
+        // EVERY POINTER IDENTITY THIS SCENE ACTUALLY DREW, which is a WIDER set than
+        // `keyed` and a NARROWER one than the document. `keyed` holds focus
+        // identities only; decoration announces itself through `GROUP_ATTRIBUTE` and
+        // deliberately never enters the focus index, so an enclosure or a connector
+        // is absent from `keyed` on every redraw. The hover reconciliation below
+        // needs both, and needs them from the SCENE rather than from `byKey`.
+        const drawnHoverable = new Set();
+        // WHICH KEYS ARE INDEXED BY SOMETHING THAT CAN ACTUALLY TAKE FOCUS. `keyed`
+        // is a FOCUS index — its only readers call `focus()` on what it holds — so
+        // holding an element a browser ignores makes it silently useless.
+        // FIRST-WINS WAS THE DEFECT, and the shape is specific: a RAILED lead is
+        // emitted twice with `data-ig-key` — the canvas `<g>`, which carries no
+        // `tabindex` because the rail row owns the tab stop, and then the row. The
+        // canvas comes first, so every ranked row's `focus()` landed on the group:
+        // arrow navigation moved nothing, and focus dropped out of the viewer after
+        // a selection redraw. It passed 258 tests because the test double counted
+        // every `focus()` call regardless of whether the element could take one.
+        // A LATER FOCUSABLE ELEMENT REPLACES A STORED UNFOCUSABLE ONE, rather than
+        // indexing only focusable elements: a key whose every element is unfocusable
+        // still belongs in the map, so `focus?.()` on it is a no-op rather than a
+        // lookup miss, and the pointer identity keeps working exactly as before.
+        // TABINDEX **OR** A NATURALLY FOCUSABLE TAG, the same pair the test double
+        // now applies — two notions of focusable that can disagree is how this class
+        // hides, and it just did.
+        const focusableKeys = new Set();
+        root = materialize(doc, scene.root, {
+            onElement: (spec, node) => {
+                const key = spec.attrs?.[KEY_ATTRIBUTE];
+                if (typeof key === 'string' && key !== '') {
+                    const tabindex = spec.attrs?.tabindex;
+                    const canFocus = (tabindex !== undefined && tabindex !== null) || spec.tag === 'a' || spec.tag === 'button';
+                    if (!keyed.has(key) || (canFocus && !focusableKeys.has(key))) {
+                        keyed.set(key, node);
+                        if (canFocus)
+                            focusableKeys.add(key);
+                    }
+                    drawnHoverable.add(key);
+                }
+                const group = spec.attrs?.[GROUP_ATTRIBUTE];
+                if (typeof group === 'string' && group !== '')
+                    drawnHoverable.add(group);
+            },
+        });
+        container.appendChild(root);
+        currentScene = scene;
+        // A REDRAW CAN REMOVE THE HOVERED ISSUE, and `pointerleave` does not fire
+        // when it does: the element under the pointer is destroyed while the
+        // pointer stays inside the container, so the handler that clears `hovered`
+        // never runs. The host was then left holding a key for an issue this
+        // document no longer carries, and never received the documented
+        // `onHover(null)` until the pointer left the whole viewer.
+        // IN `draw()` RATHER THAN IN `update()`, because the removal is a property
+        // of REDRAWING, not of one entry point — `setProjection` and a selection
+        // redraw can drop the key just as `update` can.
+        // ASK WHAT THIS SCENE DREW, NOT WHAT THE DOCUMENT CARRIES. Both tests reject
+        // `keyed` alone, and for the reason that still stands: decoration announces
+        // itself through `GROUP_ATTRIBUTE` and never enters the focus index, so
+        // clearing on `keyed` would fire constantly on a hover that is perfectly
+        // live. The earlier answer — document membership — was the wrong correction,
+        // because the document is not what the pointer is over.
+        // A PROJECTION SWITCH IS WHERE THE TWO COME APART. An off-order edge endpoint
+        // is drawn on the graph canvas and has no row in the linear projection, so
+        // switching destroys the element while its issue stays in `byKey` — the
+        // document test then preserves a hover on something that is no longer on
+        // screen, and the host never receives the documented `onHover(null)` until
+        // the pointer leaves the whole viewer. `drawnHoverable` carries both
+        // attributes from the scene just materialized, so it answers for decoration
+        // and for issues, on every redraw, from the thing the pointer can touch.
+        if (hovered !== null && !drawnHoverable.has(hovered))
+            clearHover();
+        // TOLD, NOT JUST DROPPED. The host was told a selection began, so leaving it
+        // to infer the ending from a document it happens to have replaced is the
+        // same divergence `clearHover` exists to prevent one line up. Fired AFTER
+        // the DOM is in place, exactly as the hover clear is, so a host that redraws
+        // from this callback finds the viewer already consistent.
+        if (announceSelection && state.selected !== selectedBefore) {
+            currentOptions.onSelect?.(state.selected);
+        }
+    };
+    const emitSelect = (key) => {
+        // A KEY THIS DOCUMENT DOES NOT CARRY IS A SELECTION OF NOTHING, and it has
+        // to be resolved HERE, before the state is written. `select()` is documented
+        // to fire `onSelect` exactly as a click does — and a click can only ever
+        // land on a key the canvas drew, so an unknown key has no click to be
+        // equivalent to. A host holding a stale key from its own list is the
+        // ordinary way one arrives.
+        // WITHOUT THIS, THE TWO NOTIFICATIONS CONTRADICTED EACH OTHER. The state
+        // took the unknown key, `draw()` reconciled it away against `byKey` and
+        // reported `onSelect(null)`, and then this function reported `onSelect(key)`
+        // — so the host was told twice, ending on the key that does not exist,
+        // while the handle read `selected: null`. Resolving first means the state
+        // and the one notification agree, and the reconciliation in `draw()` finds
+        // nothing left to undo.
+        const resolved = key !== null && normalized.byKey.has(key) ? key : null;
+        state = { ...state, selected: resolved, focused: resolved ?? state.focused };
+        // SILENCED, because this function reports the result itself once the draw
+        // has settled it. Letting the draw announce too would fire `onSelect` twice
+        // for one selection whenever reconciliation renamed it — and a caller
+        // cannot tell a doubled notice from a second selection.
+        draw(false);
+        // FOCUS FOLLOWS THE SUBJECT — the movement branch of `onKeyDown` already
+        // does this, and selection needs it for the same reason: `draw()` destroys
+        // the subtree holding focus and mounts a replacement. Without it a reader
+        // who pressed Enter dropped focus out of the viewer entirely, so no later
+        // arrow key reached the container and keyboard navigation was over.
+        // HERE AND NOT IN `draw()`, which is the tempting generalization and the
+        // wrong one: `update()` redraws too, and a host that refreshes the document
+        // while the reader is somewhere else on the page would have focus YANKED
+        // into the viewer. Restoring only where the viewer itself moved the subject
+        // keeps that impossible. Narrowing `draw()` correctly instead would need to
+        // know whether focus was already inside — an `activeElement` this module
+        // deliberately does not ask its host for.
+        // IT COVERS THE CLICK AND `select()` PATHS TOO, which is what the handle
+        // documents: selection "fires onSelect exactly as a click does", and a
+        // click moves focus. `:focus-visible` is what keeps the ring off a pointer
+        // user, so this costs a mouse reader nothing.
+        if (state.focused !== null)
+            keyed.get(state.focused)?.focus?.();
+        // WHAT THE STATE ACTUALLY HOLDS, not what was asked for. `draw()` reconciles
+        // the selection against the scene, which canonicalizes a together unit's
+        // partner to the station that represents it — so reporting `resolved` here
+        // would tell the host a key the handle does not hold, which is the very
+        // disagreement between the two notifications this function was written to
+        // end. `select()` stays equivalent to the click it documents itself as.
+        currentOptions.onSelect?.(state.selected);
+    };
+    const onClick = (event) => {
+        // AN ACTIVATION ON A CONTROL THAT ACTIVATES ITSELF IS THAT CONTROL'S — the
+        // same invariant `onKeyDown` already applies, and the click path needs its
+        // own copy because returning from the keydown handler does NOT suppress the
+        // click the browser synthesizes afterwards. Following a row's deep link was
+        // therefore also selecting the row and firing `onSelect` at the host, for an
+        // activation the anchor owned.
+        // UNCONDITIONAL HERE, CONDITIONAL THERE, and the asymmetry is the point: a
+        // click IS an activation, whereas a keydown may be a MOVEMENT key, which
+        // stays the viewer's even while focus rests on a link.
+        if (ownsItsOwnActivation(event.target, container))
+            return;
+        const key = keyAt(event.target, container);
+        if (key === null)
+            return;
+        emitSelect(key);
+    };
+    const onPointerOver = (event) => {
+        const key = keyAt(event.target, container);
+        if (key === hovered)
+            return;
+        hovered = key;
+        currentOptions.onHover?.(key);
+    };
+    const onPointerLeave = () => {
+        clearHover();
+    };
+    const onKeyDown = (event) => {
+        if (event.key === undefined || currentScene === null)
+            return;
+        // An activation key on a control that activates itself is that control's.
+        // Movement keys are still the viewer's — a reader on a link must be able to
+        // arrow away from it.
+        if ((event.key === 'Enter' || event.key === ' ') &&
+            ownsItsOwnActivation(event.target, container)) {
+            return;
+        }
+        // SYNC FOCUS FROM THE DOM BEFORE MOVING. `state.focused` tracks the viewer's
+        // OWN moves — its arrow keys and its clicks — and native Tab is neither. A
+        // reader who tabs into the deep link inside the third row leaves `focused`
+        // pointing wherever it was, so ArrowDown moved relative to the OLD row and
+        // sent focus BACKWARDS past the row they were standing in.
+        // FOCUS IDENTITY ONLY, hence the explicit attribute list: `GROUP_ATTRIBUTE`
+        // marks decoration that is deliberately outside the focus index, so adopting
+        // one would set `focused` to a key `navigate` cannot find — which resolves
+        // to -1 and throws the reader back to the top of the order. That is the same
+        // bug this fixes, arriving through the fix.
+        // `navigable`, NOT `focusOrder`: a gutter node reachable only sideways is a
+        // legitimate place to be standing, and `focusOrder` does not contain it.
+        const standingOn = keyAt(event.target, container, [KEY_ATTRIBUTE]);
+        if (standingOn !== null && standingOn !== state.focused && currentScene.navigable.includes(standingOn)) {
+            state = { ...state, focused: standingOn };
+        }
+        const result = navigate(currentScene, state, event.key);
+        if (result.command.kind === 'none')
+            return;
+        event.preventDefault?.();
+        if (result.command.kind === 'select') {
+            emitSelect(result.command.key);
+            return;
+        }
+        state = result.state;
+        draw();
+        keyed.get(result.command.key)?.focus?.();
+    };
+    container.addEventListener('click', onClick);
+    container.addEventListener('pointerover', onPointerOver);
+    container.addEventListener('pointerleave', onPointerLeave);
+    container.addEventListener('keydown', onKeyDown);
+    draw();
+    return {
+        update(next, nextOptions) {
+            if (destroyed)
+                return;
+            if (nextOptions !== undefined)
+                currentOptions = nextOptions;
+            if (nextOptions?.projection !== undefined)
+                projection = nextOptions.projection;
+            normalized = normalizeDocument(next).document;
+            draw();
+        },
+        setProjection(next) {
+            if (destroyed)
+                return;
+            projection = next;
+            draw();
+        },
+        select(key) {
+            if (destroyed)
+                return;
+            emitSelect(key);
+        },
+        get state() {
+            return state;
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            // BEFORE THE LISTENERS COME OFF, because after that no `pointerleave` can
+            // fire and the host is left holding a key for an element about to be
+            // removed — a tooltip pinned to nothing. Destruction bypasses `draw()`
+            // entirely, so the redraw reconciliation above never sees this path.
+            clearHover();
+            container.removeEventListener('click', onClick);
+            container.removeEventListener('pointerover', onPointerOver);
+            container.removeEventListener('pointerleave', onPointerLeave);
+            container.removeEventListener('keydown', onKeyDown);
+            if (root !== null)
+                container.removeChild(root);
+            root = null;
+            keyed = new Map();
+        },
+    };
+}
+//# sourceMappingURL=mount.js.map

package/dist/mount.js.map

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

package/dist/navigation.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Keyboard navigation, as a pure reducer.
+ *
+ * It takes a scene, the current state and a key name, and returns the next
+ * state plus the one thing the shell should do. No DOM, no events, no
+ * side-effects — which is what lets the whole key map be tested exhaustively on
+ * a runtime with no DOM at all, and what leaves `mount.ts` with nothing to get
+ * wrong except wiring.
+ *
+ * THE TRAVERSAL IS THE SCENE'S PUBLISHED ORDER, NEVER THE PICTURE. On the spine
+ * that order is rank order, so `Tab` and the vertical keys walk the work order
+ * even where the drawing places boxes elsewhere. Recovering an order from
+ * coordinates is precisely what the design forbids, so this module cannot see
+ * a coordinate.
+ */
+import { type Scene } from './scene.ts';
+export interface NavigationState {
+    /** The roving tab stop. `null` before anything has been focused. */
+    readonly focused: string | null;
+    /** The selected key, which survives a projection change. */
+    readonly selected: string | null;
+}
+/** What the shell should do. `none` means the host keeps its own shortcut. */
+export type NavigationCommand = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'focus';
+    readonly key: string;
+} | {
+    readonly kind: 'select';
+    readonly key: string;
+};
+export interface NavigationResult {
+    readonly state: NavigationState;
+    readonly command: NavigationCommand;
+}
+export declare const initialNavigationState: NavigationState;
+/**
+ * Re-resolve state against a scene.
+ *
+ * Switching projection changes the REPRESENTATION, never the subject, so a
+ * selection carries across. Focus follows it when it can; when the new
+ * projection does not draw the focused key at all, focus falls to the first
+ * item rather than nowhere.
+ */
+export declare function reconcile(scene: Scene, state: NavigationState): NavigationState;
+/**
+ * Apply one key.
+ *
+ * Movement never wraps: the ends of the order are the ends of the work, and a
+ * list that silently teleports to the top reads as a jump rather than as a
+ * boundary. An unhandled key returns the state untouched and `none`, so a host
+ * keeps every shortcut this package does not claim.
+ */
+export declare function navigate(scene: Scene, state: NavigationState, key: string): NavigationResult;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAmB,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,eAAO,MAAM,sBAAsB,EAAE,eAGnC,CAAC;AAeH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CA6B/E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAyC5F"}

package/dist/navigation.js

@@ -0,0 +1,121 @@
+/**
+ * Keyboard navigation, as a pure reducer.
+ *
+ * It takes a scene, the current state and a key name, and returns the next
+ * state plus the one thing the shell should do. No DOM, no events, no
+ * side-effects — which is what lets the whole key map be tested exhaustively on
+ * a runtime with no DOM at all, and what leaves `mount.ts` with nothing to get
+ * wrong except wiring.
+ *
+ * THE TRAVERSAL IS THE SCENE'S PUBLISHED ORDER, NEVER THE PICTURE. On the spine
+ * that order is rank order, so `Tab` and the vertical keys walk the work order
+ * even where the drawing places boxes elsewhere. Recovering an order from
+ * coordinates is precisely what the design forbids, so this module cannot see
+ * a coordinate.
+ */
+import { resolveFocusKey } from "./scene.js";
+export const initialNavigationState = Object.freeze({
+    focused: null,
+    selected: null,
+});
+function indexOfFocus(scene, state) {
+    if (state.focused === null)
+        return -1;
+    return scene.focusOrder.indexOf(state.focused);
+}
+function stay(state) {
+    return { state, command: { kind: 'none' } };
+}
+function moveTo(state, key) {
+    return { state: { ...state, focused: key }, command: { kind: 'focus', key } };
+}
+/**
+ * Re-resolve state against a scene.
+ *
+ * Switching projection changes the REPRESENTATION, never the subject, so a
+ * selection carries across. Focus follows it when it can; when the new
+ * projection does not draw the focused key at all, focus falls to the first
+ * item rather than nowhere.
+ */
+export function reconcile(scene, state) {
+    // Selection is carried WHOLE, even when the new projection does not draw it.
+    // It is the subject, and a switch changes representation rather than subject;
+    // dropping it here would make the toggle lose the thing the reader is looking
+    // at, which is the one property the design fixes about switching.
+    //
+    // Focus goes through the SHARED rule, so what this reports and what the
+    // projection rendered a tab stop on cannot diverge.
+    //
+    // CANONICALIZED THROUGH THE SCENE'S OWN STATIONS FIRST, and that is what makes
+    // "carried whole" true rather than merely stated. A key this projection draws
+    // under another key's station — a together unit's partner — is not a subject
+    // this projection can hold: `navigable` does not list it, so focus could not
+    // follow it and fell to the FIRST entry in the order, an unrelated issue.
+    // Reporting `selected` as the station keeps the subject and lets focus reach
+    // it; the tree publishes no stations, so a partner selected there stays
+    // itself, which is correct because the tree gives it its own row.
+    // HERE RATHER THAN AT THE ENTRY POINTS, because there are four of them —
+    // pointer, `handle.select`, a projection switch, a document update — and only
+    // this one sees the scene that decides the answer. Canonicalizing per entry
+    // point is what left `handle.select` and `setProjection` behaving differently
+    // from the click they are documented to be equivalent to.
+    const station = (key) => key === null || key === undefined ? null : (scene.stationOf.get(key) ?? key);
+    const selected = station(state.selected);
+    return {
+        focused: resolveFocusKey(scene.navigable, station(state.focused), selected),
+        selected,
+    };
+}
+/**
+ * Apply one key.
+ *
+ * Movement never wraps: the ends of the order are the ends of the work, and a
+ * list that silently teleports to the top reads as a jump rather than as a
+ * boundary. An unhandled key returns the state untouched and `none`, so a host
+ * keeps every shortcut this package does not claim.
+ */
+export function navigate(scene, state, key) {
+    const order = scene.focusOrder;
+    if (order.length === 0)
+        return stay(state);
+    const current = indexOfFocus(scene, state);
+    const first = order[0];
+    const last = order[order.length - 1];
+    switch (key) {
+        case 'ArrowDown': {
+            if (current === -1)
+                return moveTo(state, first);
+            const next = order[Math.min(current + 1, order.length - 1)];
+            return next === state.focused ? stay(state) : moveTo(state, next);
+        }
+        case 'ArrowUp': {
+            if (current === -1)
+                return moveTo(state, first);
+            const next = order[Math.max(current - 1, 0)];
+            return next === state.focused ? stay(state) : moveTo(state, next);
+        }
+        case 'ArrowLeft':
+        case 'ArrowRight': {
+            if (state.focused === null)
+                return moveTo(state, first);
+            const neighbours = scene.lateral.get(state.focused);
+            const target = key === 'ArrowLeft' ? neighbours?.left : neighbours?.right;
+            return target === undefined ? stay(state) : moveTo(state, target);
+        }
+        case 'Home':
+            return state.focused === first ? stay(state) : moveTo(state, first);
+        case 'End':
+            return state.focused === last ? stay(state) : moveTo(state, last);
+        case 'Enter':
+        case ' ': {
+            const target = state.focused ?? first;
+            return {
+                state: { focused: target, selected: target },
+                command: { kind: 'select', key: target },
+            };
+        }
+        default:
+            return stay(state);
+    }
+}
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

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