@graview/react 0.1.0

package/dist/animation.js

@@ -0,0 +1,245 @@
+import { easeInOut, interpolate, } from "@graview/layout";
+import { useEffect, useRef, useState } from "react";
+import { useGraview } from "./context.js";
+const DEFAULT_DURATION = 520;
+function prefersReducedMotion() {
+    if (typeof window === "undefined" || !window.matchMedia)
+        return false;
+    return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/**
+ * Tweens between two layouts whenever the view changes.
+ *
+ * This is the pay-off for layout being a pure function: there is no list of
+ * known transitions and no per-navigation animation code. ANY two view states
+ * interpolate, so a kind of navigation nobody anticipated animates the same
+ * as the ones that were designed — and a node entering the scene grows out of
+ * whatever group stood in for it, because the interpolation knows where it
+ * came from.
+ *
+ * Motion is the one thing that makes depth legible. Without it, a plane
+ * change is a cut and the viewer has to re-find everything; with it, the eye
+ * follows and spatial memory survives the move.
+ */
+export function useAnimatedLayout(target, options = {}) {
+    const duration = options.duration ?? DEFAULT_DURATION;
+    const enabled = (options.enabled ?? true) && !prefersReducedMotion();
+    const from = useRef(target);
+    const [current, setCurrent] = useState(() => interpolate(target, target, 1));
+    // The LIVE frame, kept in a ref.
+    //
+    // The effect below is not re-created on the frames it itself causes, so a
+    // cleanup closing over `current` sees the frame from when the effect
+    // started — which made an interrupted transition resume from where the
+    // previous one began, and made every navigation after the first jump back
+    // two states before animating forward.
+    const latest = useRef(current);
+    const frame = useRef(null);
+    /*
+     * WHEN THIS FLIGHT BEGAN, kept across restarts. A new target arriving
+     * mid-flight — the camera re-centring a frame after a click, a host
+     * reporting a size, a wheel's worth of events — used to start a fresh
+     * tween from the live frame with the whole duration and the ease-in from
+     * zero, so a stream of them moved the scene a hair a frame and never
+     * arrived: a crawl. The clock belongs to the flight, not the target: a
+     * restart tweens from the live frame to the new target over what is LEFT,
+     * picking the easing up at the velocity it already had.
+     */
+    const clock = useRef(null);
+    useEffect(() => {
+        if (!enabled || typeof requestAnimationFrame === "undefined") {
+            from.current = target;
+            const settled = interpolate(target, target, 1);
+            latest.current = settled;
+            setCurrent(settled);
+            /*
+             * The same settle tick the tween gets, for the cut.
+             *
+             * With motion off — reduced-motion, a test, a drag that owns the
+             * pointer — the render that draws the new layout still measures the
+             * PREVIOUS commit's DOM, so every measured line sat one navigation
+             * behind the cards until something else happened to re-render. One
+             * more render on the next frame reads the settled geometry.
+             */
+            if (typeof requestAnimationFrame === "undefined")
+                return;
+            const tick = requestAnimationFrame(() => {
+                const again = interpolate(target, target, 1);
+                latest.current = again;
+                setCurrent(again);
+            });
+            return () => cancelAnimationFrame(tick);
+        }
+        // Tween from wherever the scene actually IS, not from the last target:
+        // interrupting a transition half way must not snap back to its start.
+        const now = performance.now();
+        const inFlight = clock.current !== null && latest.current.t < 1 && now - clock.current < duration;
+        const start = inFlight ? clock.current : now;
+        clock.current = start;
+        // Where the easing already is, so the rest of the flight continues from
+        // that point on the curve rather than easing in again from a standstill.
+        const alreadyEased = easeInOut(Math.min(1, (now - start) / duration));
+        const origin = from.current;
+        const step = (at) => {
+            const t = Math.min(1, (at - start) / duration);
+            const eased = alreadyEased >= 1 ? 1 : (easeInOut(t) - alreadyEased) / (1 - alreadyEased);
+            const next = interpolate(origin, target, Math.max(0, eased));
+            latest.current = next;
+            setCurrent(next);
+            if (t < 1) {
+                frame.current = requestAnimationFrame(step);
+            }
+            else {
+                clock.current = null;
+                from.current = target;
+                /*
+                 * ONE SETTLE TICK after the last frame has painted.
+                 *
+                 * Anything that measures the DOM during render — connectors, ties,
+                 * captions — reads the PREVIOUS commit's geometry, so the render
+                 * that draws t = 1 measures wherever the scene was a frame earlier.
+                 * On a smooth tween that is a fraction of a percent; across a
+                 * dropped frame it is a visible stray line frozen in mid-air. A
+                 * final render on the next frame measures the settled DOM, and a
+                 * fresh object identity is what makes React run it.
+                 */
+                frame.current = requestAnimationFrame(() => {
+                    const settled = interpolate(target, target, 1);
+                    latest.current = settled;
+                    setCurrent(settled);
+                    frame.current = null;
+                });
+            }
+        };
+        frame.current = requestAnimationFrame(step);
+        return () => {
+            if (frame.current !== null)
+                cancelAnimationFrame(frame.current);
+            // Freeze where the interruption caught it, so the next tween starts
+            // here — from the live frame, not the one this effect began with.
+            const live = latest.current;
+            from.current = {
+                ...target,
+                /*
+                 * INCLUDING THE GROUND IT WAS STANDING ON.
+                 *
+                 * Spreading the target carried the DESTINATION's city into the
+                 * frozen origin, so the next tween interpolated from the new cell
+                 * and the new origin to themselves: the cards flew and the lattice,
+                 * the plots and the roads under them were already there. That is
+                 * the picture flashing to the new place while the buildings walk
+                 * over to join it.
+                 */
+                ...(live.city ? { city: live.city } : {}),
+                nodes: live.nodes.map((node) => ({
+                    ...node,
+                    plane: Math.round(node.plane),
+                })),
+                connectors: live.connectors,
+            };
+        };
+    }, [target, duration, enabled]);
+    return current;
+}
+/**
+ * The nodes implicated by the most recent change, for about a second.
+ *
+ * Human and agent edits arrive through the same subscription carrying the
+ * same diff, so the interface cannot render one differently from the other
+ * even by accident — which is the point. The renderer highlights an agent's
+ * work with exactly the code that highlights yours.
+ */
+export function useTouched(holdMs = 1100) {
+    const { store } = useGraview();
+    const [touched, setTouched] = useState(() => new Set());
+    useEffect(() => {
+        let timer = null;
+        const unsubscribe = store.subscribe((diff) => {
+            setTouched(new Set(diff.touched));
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(() => setTouched(new Set()), holdMs);
+        });
+        return () => {
+            unsubscribe();
+            if (timer)
+                clearTimeout(timer);
+        };
+    }, [store, holdMs]);
+    return touched;
+}
+const NO_WORK = { marks: new Map(), acts: [] };
+/**
+ * WHERE THE SEAT WORKED, MARKED ON THE THINGS THEMSELVES.
+ *
+ * The robot used to walk to what it wrote and stand there, which is the
+ * one thing the body was genuinely good for: attribution in space. The
+ * walk is gone; the attribution is not. Every op the log attributes to an
+ * agent marks what it wrote for a hold, and the acts stay in a list the
+ * companion can offer to fly you to.
+ *
+ * Read from the OP LOG rather than from the seat's own reports, so it is
+ * the same on both render paths, inside a lens, and for a turn that
+ * arrived from somewhere else entirely. An undo takes its marks with it:
+ * an op that undoes another says so, and what it took back stops being
+ * something the seat just did.
+ */
+export function useSeatWork(holdMs = 4000) {
+    const { store } = useGraview();
+    const [work, setWork] = useState(NO_WORK);
+    useEffect(() => {
+        let timer = null;
+        const unsubscribe = store.subscribe((_diff, ops) => {
+            setWork((current) => {
+                const marks = new Map(current.marks);
+                let acts = [...current.acts];
+                for (const op of ops) {
+                    if (op.undoes !== undefined) {
+                        /*
+                         * Taken back: the act leaves the log the companion shows, and
+                         * the marks it put on things leave with it. A mark over a
+                         * change that no longer exists is the seat claiming credit for
+                         * nothing.
+                         */
+                        const undone = acts.find((act) => act.batch === op.undoes || act.wrote.length > 0);
+                        const taken = acts.filter((act) => op.writes.some((id) => act.wrote.includes(id)));
+                        for (const act of taken.length > 0 ? taken : undone ? [undone] : []) {
+                            for (const id of act.wrote)
+                                marks.delete(id);
+                            acts = acts.filter((one) => one.batch !== act.batch);
+                        }
+                        continue;
+                    }
+                    if (op.author.kind !== "agent")
+                        continue;
+                    const who = op.author.id ?? "the seat";
+                    for (const id of op.writes)
+                        marks.set(id, who);
+                    const already = acts.find((act) => act.batch === op.batch);
+                    if (already) {
+                        acts = acts.map((act) => act.batch === op.batch
+                            ? { ...act, wrote: [...new Set([...act.wrote, ...op.writes])] }
+                            : act);
+                    }
+                    else {
+                        acts = [{ batch: op.batch, who, intent: op.intent, at: op.at, wrote: [...op.writes] }, ...acts].slice(0, 12);
+                    }
+                }
+                return marks.size === current.marks.size && acts === current.acts && marks.size === 0
+                    ? current
+                    : { marks, acts };
+            });
+            if (timer)
+                clearTimeout(timer);
+            /* The marks fade; the log stays, because "what did it just do" outlives the flash. */
+            timer = setTimeout(() => setWork((current) => (current.marks.size === 0 ? current : { ...current, marks: new Map() })), holdMs);
+        });
+        return () => {
+            unsubscribe();
+            if (timer)
+                clearTimeout(timer);
+        };
+    }, [store, holdMs]);
+    return work;
+}
+//# sourceMappingURL=animation.js.map

package/dist/animation.js.map

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

package/dist/captions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * WHERE A RELATION'S CAPTION GOES — pure, so it can be held to.
+ *
+ * The neighbourhood is grouped by relation, and each group is captioned
+ * once, above the first row it occupies. Three things this used to get
+ * wrong, all found by a discography whose artist is featured on some songs
+ * and produced others:
+ *
+ * - A group was a CONSECUTIVE run of the frame's nodes, and the frame is
+ *   sorted by id. "Featured on" After Midnight, "produced" Blue Hour,
+ *   "featured on" Rent Is Due made three runs and two captions saying the
+ *   same thing — and, keyed by the edge kind alone, React could not tell
+ *   the two apart, kept the old elements through the next navigation, and
+ *   an album's picture went on saying "their songs" from the artist you had
+ *   left, one caption over every card.
+ * - A caption borrowed three hundred pixels whatever stood beside it, so
+ *   two narrow groups' captions lay across each other.
+ * - The borrowing was clamped to the stage and not to the room the rails
+ *   leave, so the leftmost caption ran under the inspector.
+ */
+export interface CaptionEntry {
+    /** Which relation, read from which end: one caption per key. */
+    readonly key: string;
+    readonly text: string;
+    readonly left: number;
+    readonly right: number;
+    readonly top: number;
+}
+export interface CaptionRun {
+    readonly key: string;
+    readonly text: string;
+    readonly left: number;
+    readonly width: number;
+    /** The top of the row the caption sits over. */
+    readonly top: number;
+}
+/** Wide enough for a full edge description before anything is cut. */
+export declare const MIN_CAPTION = 300;
+export declare function captionRuns(entries: readonly CaptionEntry[], room: {
+    readonly left: number;
+    readonly right: number;
+}): CaptionRun[];
+//# sourceMappingURL=captions.d.ts.map

package/dist/captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../src/captions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,eAAO,MAAM,WAAW,MAAM,CAAC;AAO/B,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD,UAAU,EAAE,CAkDd"}

package/dist/captions.js

@@ -0,0 +1,61 @@
+/** Wide enough for a full edge description before anything is cut. */
+export const MIN_CAPTION = 300;
+/** Cards in one row are within this many pixels of each other's top. */
+const SAME_ROW = 12;
+const GAP = 8;
+/** About how wide a caption's words are drawn: 0.75rem capitals, letter-spaced, on a padded ground. */
+const wordsWidth = (text) => text.length * 8.4 + 16;
+export function captionRuns(entries, room) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const held = groups.get(entry.key);
+        if (held)
+            held.push(entry);
+        else
+            groups.set(entry.key, [entry]);
+    }
+    // Each group over the FIRST row it stands in: the rows after it continue it.
+    const runs = [...groups.values()].map((members) => {
+        const top = Math.min(...members.map((member) => member.top));
+        const row = members.filter((member) => member.top - top <= SAME_ROW);
+        return {
+            key: members[0].key,
+            text: members[0].text,
+            left: Math.min(...row.map((member) => member.left)),
+            right: Math.max(...row.map((member) => member.right)),
+            top,
+        };
+    });
+    runs.sort((a, b) => a.top - b.top || a.left - b.left);
+    /*
+     * What each caption WANTS: its own run, or its words, whichever is wider,
+     * centred on the run. A neighbour's ground is borrowed only as far as the
+     * neighbour does not want it; where both want the gutter between them,
+     * they split it.
+     */
+    const want = runs.map((run) => {
+        const width = Math.max(run.right - run.left, Math.min(MIN_CAPTION, wordsWidth(run.text)));
+        const mid = (run.left + run.right) / 2;
+        return { left: mid - width / 2, right: mid + width / 2 };
+    });
+    return runs.map((run, index) => {
+        const beside = runs
+            .map((other, at) => ({ other, at }))
+            .filter(({ other }) => other !== run && Math.abs(other.top - run.top) <= SAME_ROW);
+        const floors = beside
+            .filter(({ other }) => other.right <= run.left)
+            .map(({ other, at }) => (want[at].right + GAP <= (other.right + run.left) / 2 ? want[at].right + GAP : (other.right + run.left + GAP) / 2));
+        const ceilings = beside
+            .filter(({ other }) => other.left >= run.right)
+            .map(({ other, at }) => (want[at].left - GAP >= (run.right + other.left) / 2 ? want[at].left - GAP : (run.right + other.left - GAP) / 2));
+        const floor = Math.max(room.left, ...floors);
+        const ceiling = Math.min(room.right, ...ceilings);
+        const own = run.right - run.left;
+        const desired = want[index].right - want[index].left;
+        const width = Math.max(own, Math.min(desired, ceiling - floor));
+        const mid = (run.left + run.right) / 2;
+        const left = own >= width ? run.left : Math.max(floor, Math.min(mid - width / 2, ceiling - width));
+        return { key: run.key, text: run.text, left, width, top: run.top };
+    });
+}
+//# sourceMappingURL=captions.js.map

package/dist/captions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.js","sourceRoot":"","sources":["../src/captions.ts"],"names":[],"mappings":"AAsCA,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,wEAAwE;AACxE,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,MAAM,GAAG,GAAG,CAAC,CAAC;AACd,uGAAuG;AACvG,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC;AAEpE,MAAM,UAAU,WAAW,CACzB,OAAgC,EAChC,IAAuD;IAEvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,6EAA6E;IAC7E,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,QAAQ,CAAC,CAAC;QACrE,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,GAAG;YACpB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI;YACtB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrD,GAAG;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD;;;;;OAKG;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1F,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAI;aAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;aACnC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM;aAClB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC;aAC9C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChJ,MAAM,QAAQ,GAAG,MAAM;aACpB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;aAC9C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9I,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;QACnG,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/channels.d.ts

@@ -0,0 +1,15 @@
+import type { Box, Point } from "./routes.js";
+export interface Row {
+    readonly top: number;
+    readonly bottom: number;
+    readonly boxes: readonly Box[];
+}
+/** Boxes grouped into rows by vertical overlap, top to bottom, each row's boxes left to right. */
+export declare function bandRows(band: readonly Box[]): Row[];
+/**
+ * The polyline from one chip to another through the band's gutters. `lane`
+ * staggers lines that share a channel by a few pixels so two relations
+ * along the same gutter do not lie on one another.
+ */
+export declare function channelRoute(from: Box, to: Box, band: readonly Box[], lane?: number): Point[];
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAiB9C,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;CAChC;AAED,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAapD;AAgDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,SAAI,GAAG,KAAK,EAAE,CA2BxF"}

package/dist/channels.js

@@ -0,0 +1,114 @@
+/*
+ * A LINE BETWEEN TWO CHIPS OF ONE BAND runs in the gutters.
+ *
+ * A band of many neighbours is a grid: rows of chips with gaps between the
+ * rows and between the chips. An arc between two of them crossed whatever
+ * lay between, and clipped under every chip it crossed it was left as
+ * confetti — dashes in the gaps that belonged to no visible line. In a
+ * grid the honest road is the gutter: leave a chip by its bottom edge,
+ * travel along the channel between rows, cross rows through a gap between
+ * chips, and arrive at the other chip's top. Nothing is crossed, so
+ * nothing needs clipping, and the whole line is one visible thing.
+ */
+const CLEAR = 12;
+/** Boxes grouped into rows by vertical overlap, top to bottom, each row's boxes left to right. */
+export function bandRows(band) {
+    const sorted = [...band].sort((a, b) => a.y - b.y || a.x - b.x);
+    const rows = [];
+    for (const box of sorted) {
+        const row = rows.find((r) => box.y < r.bottom && box.y + box.height > r.top);
+        if (row) {
+            row.boxes.push(box);
+            row.top = Math.min(row.top, box.y);
+            row.bottom = Math.max(row.bottom, box.y + box.height);
+        }
+        else
+            rows.push({ top: box.y, bottom: box.y + box.height, boxes: [box] });
+    }
+    for (const row of rows)
+        row.boxes.sort((a, b) => a.x - b.x);
+    return rows.sort((a, b) => a.top - b.top);
+}
+const same = (a, b) => a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+const rowOf = (rows, box) => rows.findIndex((row) => row.boxes.some((b) => same(b, box)));
+/** The channel between two consecutive rows, or the space just above the first / below the last. */
+function channelBetween(rows, above, below) {
+    if (above < 0)
+        return rows[0].top - CLEAR * 2;
+    if (below >= rows.length)
+        return rows[rows.length - 1].bottom + CLEAR * 2;
+    return (rows[above].bottom + rows[below].top) / 2;
+}
+/** An x that is clear of every chip in these rows, as near `wanted` as one exists. */
+function clearX(rows, wanted) {
+    // Every row's free intervals, intersected: the gaps between chips plus both margins.
+    let free = [{ from: -Infinity, to: Infinity }];
+    for (const row of rows) {
+        const gaps = [];
+        let cursor = -Infinity;
+        for (const box of row.boxes) {
+            gaps.push({ from: cursor, to: box.x - CLEAR });
+            cursor = box.x + box.width + CLEAR;
+        }
+        gaps.push({ from: cursor, to: Infinity });
+        const next = [];
+        for (const a of free)
+            for (const b of gaps) {
+                const from = Math.max(a.from, b.from);
+                const to = Math.min(a.to, b.to);
+                if (to - from >= 0)
+                    next.push({ from, to });
+            }
+        free = next;
+    }
+    let best = wanted;
+    let distance = Infinity;
+    for (const gap of free) {
+        const x = Math.min(Math.max(wanted, gap.from), gap.to);
+        // A gap between chips over the band's margin, unless the margin is much nearer:
+        // a road down the outside edge, hugging the row's first chip, framed it.
+        const margin = gap.from === -Infinity || gap.to === Infinity;
+        const d = Math.abs(x - wanted) + (margin ? 60 : 0);
+        if (d < distance) {
+            distance = d;
+            best = x;
+        }
+    }
+    return best;
+}
+/**
+ * The polyline from one chip to another through the band's gutters. `lane`
+ * staggers lines that share a channel by a few pixels so two relations
+ * along the same gutter do not lie on one another.
+ */
+export function channelRoute(from, to, band, lane = 0) {
+    const rows = bandRows(band.some((b) => same(b, from)) && band.some((b) => same(b, to)) ? band : [...band, from, to]);
+    const rf = rowOf(rows, from);
+    const rt = rowOf(rows, to);
+    const fx = from.x + from.width / 2;
+    const tx = to.x + to.width / 2;
+    const stagger = ((lane % 3) - 1) * 4;
+    if (rf === rt) {
+        // A U under the row (or over it, for the last row of several): out, along, and back in.
+        const under = rf < rows.length - 1 || rows.length === 1;
+        const y = (under ? channelBetween(rows, rf, rf + 1) : channelBetween(rows, rf - 1, rf)) + stagger;
+        const a = under ? from.y + from.height : from.y;
+        const b = under ? to.y + to.height : to.y;
+        return [{ x: fx, y: a }, { x: fx, y }, { x: tx, y }, { x: tx, y: b }];
+    }
+    const down = rt > rf;
+    const step = down ? 1 : -1;
+    const start = { x: fx, y: down ? from.y + from.height : from.y };
+    const end = { x: tx, y: down ? to.y : to.y + to.height };
+    const first = (down ? channelBetween(rows, rf, rf + 1) : channelBetween(rows, rf - 1, rf)) + stagger;
+    const last = (down ? channelBetween(rows, rt - 1, rt) : channelBetween(rows, rt, rt + 1)) + stagger;
+    if (Math.abs(rt - rf) === 1)
+        return [start, { x: fx, y: first }, { x: tx, y: first }, end];
+    // Rows in between: cross them through a gap between chips, as near the far chip as one is.
+    const between = [];
+    for (let r = rf + step; r !== rt; r += step)
+        between.push(rows[r]);
+    const vx = clearX(between, tx);
+    return [start, { x: fx, y: first }, { x: vx, y: first }, { x: vx, y: last }, { x: tx, y: last }, end];
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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