@kgdiff/scene 0.0.0-stage → 0.2.0

package/dist/choreography.js

@@ -0,0 +1,271 @@
+import { assertNever, mergeBadge } from './roles.js';
+/** Node animation kinds. */
+export const NA_NONE = 0;
+/** Both states visible: colors / rings / halos crossfade, label slides, ring flashes, badge ticks in. */
+export const NA_FADE = 1;
+/** Shrinks to 0.6·r while its fill drains into a dashed ghost, which lingers, then fades. */
+export const NA_REMOVE = 2;
+/** Pops in (scale 0 → 1.08 → 1, back-out), then its label fades in. */
+export const NA_ADD = 3;
+/** Merge source: travels on a gentle arc into its target, fades on arrival. */
+export const NA_TRAVEL = 4;
+/** Split target: emerges from its source and travels out to its position. */
+export const NA_EMERGE = 5;
+/** Edge animation kinds. */
+export const EA_NONE = 0;
+/** Grows from the existing endpoint (`progress` 0 → 1). */
+export const EA_GROW = 1;
+/** Retracts toward the surviving endpoint (`progress` 1 → 0). */
+export const EA_RETRACT = 2;
+/** The changed end swings around the shared endpoint from the old to the new node. */
+export const EA_SWING = 3;
+/** Carried by a merge: rides the travelling source (before form), then is the after form. */
+export const EA_FOLLOW_MERGE = 4;
+/** Carried by a split: rides the emerging target (after form). */
+export const EA_FOLLOW_SPLIT = 5;
+/** Same geometry, new label / predicate: label swaps, stroke flashes. */
+export const EA_FADE = 6;
+/** Geometry changes with no shared endpoint or no mover: crossfade old form → new form. */
+export const EA_SWAP = 7;
+/** Timings in transform-phase fractions. */
+export const CHOREO = {
+    retract: [0, 0.4],
+    removeShrink: [0.25, 0.55],
+    /** The ghost lingers until 60% of the window (u = (0.6 − 0.18) / 0.64), then fades. */
+    removeGhostFade: [0.65625, 1],
+    splitSourceShrink: [0.6, 0.8],
+    splitSourceFade: [0.8, 1],
+    growFromExisting: [0, 0.45],
+    pop: [0.35, 0.75],
+    popAfterArrival: [0.55, 0.85],
+    growBetweenNew: [0.6, 0.9],
+    growAfterArrival: [0.7, 0.95],
+    growOther: [0.35, 0.85],
+    labelFadeIn: 0.15,
+    travelStagger: 0.15,
+    travel: 0.55,
+    arrivalFade: 0.12,
+    mergeTargetFade: [0.55, 0.85],
+    mergeFlash: [0.7, 1],
+    splitStart: 0.05,
+    splitSourceStay: [0.6, 0.9],
+    modifyFade: [0.3, 0.7],
+    modifyFlash: [0.4, 0.8],
+    labelOut: [0.1, 0.5],
+    labelIn: [0.3, 0.7],
+    /** px the old label rises while fading / the new label rises from. */
+    labelSlide: 6,
+    badgeTick: 0.6,
+    swing: [0.1, 0.8],
+    ghostFade: [0.3, 1],
+    pivotFade: [0.8, 1],
+    edgeFade: [0.2, 0.7],
+    swap: [0.2, 0.8],
+    /** Bend of travel arcs and merge / split arrows. */
+    arc: 0.25,
+};
+function staggered(j, n, start) {
+    const s = start + (n > 1 ? (CHOREO.travelStagger * j) / (n - 1) : CHOREO.travelStagger / 2);
+    return [s, s + CHOREO.travel];
+}
+/** Plan every element's replay animation. O(N + E). */
+export function choreograph(scene, nodeStyles, edgeStyles) {
+    const N = scene.nodes.length;
+    const M = scene.edges.length;
+    const H = scene.hunks.length;
+    const c = {
+        nKind: new Uint8Array(N),
+        nA: new Float64Array(N),
+        nB: new Float64Array(N),
+        nC: new Float64Array(N),
+        nFlashA: new Float64Array(N).fill(-1),
+        nFlashB: new Float64Array(N).fill(-1),
+        nLabelSwap: new Uint8Array(N),
+        nBadgeAt: new Float64Array(N).fill(2),
+        nArrivals: new Array(N).fill(null),
+        nBadgeSteps: new Array(N).fill(null),
+        nPulse: new Uint8Array(N),
+        hPulseContext: new Uint8Array(H),
+        eKind: new Uint8Array(M),
+        eA: new Float64Array(M),
+        eB: new Float64Array(M),
+        eFromTarget: new Uint8Array(M),
+        ePivot: new Int32Array(M).fill(-1),
+    };
+    const nArrivals = c.nArrivals;
+    const nBadgeSteps = c.nBadgeSteps;
+    const set = (i, kind, a, b, extra = 0) => {
+        c.nKind[i] = kind;
+        c.nA[i] = a;
+        c.nB[i] = b;
+        c.nC[i] = extra;
+    };
+    const flash = (i, ab) => {
+        c.nFlashA[i] = ab[0];
+        c.nFlashB[i] = ab[1];
+    };
+    for (const hunk of scene.hunks) {
+        const kind = hunk.kind;
+        const before = (i) => nodeStyles[i][1];
+        const after = (i) => nodeStyles[i][2];
+        // Travelling participants first (they define arrival times).
+        const sources = hunk.nodes.filter((i) => scene.nodes[i]?.role === 'merge-source');
+        sources.forEach((i, j) => {
+            const node = scene.nodes[i];
+            const [a, b] = staggered(j, sources.length, 0);
+            if (node?.flow !== undefined && !node.presentAfter)
+                set(i, NA_TRAVEL, a, b);
+            else if (!after(i).hidden)
+                set(i, NA_FADE, a, b);
+            else
+                set(i, NA_REMOVE, CHOREO.removeShrink[0], CHOREO.removeShrink[1], CHOREO.removeGhostFade[0]);
+        });
+        const targets = hunk.nodes.filter((i) => scene.nodes[i]?.role === 'split-target' &&
+            scene.nodes[i]?.flow !== undefined &&
+            before(i).hidden);
+        targets.forEach((i, j) => {
+            const [a, b] = staggered(j, targets.length, CHOREO.splitStart);
+            set(i, NA_EMERGE, a, b);
+        });
+        let anyBefore = false;
+        for (const i of hunk.nodes) {
+            const node = scene.nodes[i];
+            if (node === undefined)
+                continue;
+            const B = before(i);
+            const A = after(i);
+            if (!B.hidden) {
+                anyBefore = true;
+                c.nPulse[i] = 1;
+            }
+            if (c.nKind[i] !== NA_NONE)
+                continue;
+            if (B.hidden && A.hidden)
+                continue;
+            if (B.hidden) {
+                const [a, b] = kind === 'merge' ? CHOREO.popAfterArrival : CHOREO.pop;
+                set(i, NA_ADD, a, b, Math.min(1, b - 0.05));
+            }
+            else if (A.hidden) {
+                if (kind === 'split') {
+                    set(i, NA_REMOVE, CHOREO.splitSourceShrink[0], CHOREO.splitSourceShrink[1], CHOREO.splitSourceFade[0]);
+                }
+                else {
+                    set(i, NA_REMOVE, CHOREO.removeShrink[0], CHOREO.removeShrink[1], CHOREO.removeGhostFade[0]);
+                }
+            }
+            else if (node.role === 'merge-target') {
+                set(i, NA_FADE, CHOREO.mergeTargetFade[0], CHOREO.mergeTargetFade[1]);
+                flash(i, CHOREO.mergeFlash);
+            }
+            else if (node.role === 'split-source') {
+                set(i, NA_FADE, CHOREO.splitSourceStay[0], CHOREO.splitSourceStay[1]);
+                flash(i, CHOREO.mergeFlash);
+            }
+            else {
+                set(i, NA_FADE, CHOREO.modifyFade[0], CHOREO.modifyFade[1]);
+                if (A.ring !== null)
+                    flash(i, CHOREO.modifyFlash);
+            }
+            if (c.nKind[i] === NA_FADE) {
+                c.nLabelSwap[i] = B.labelBefore && !A.labelBefore && node.labelBefore !== undefined ? 1 : 0;
+                if (A.badge && !B.badge && node.badge !== undefined)
+                    c.nBadgeAt[i] = CHOREO.badgeTick;
+            }
+        }
+        if (!anyBefore)
+            c.hPulseContext[hunk.index] = 1;
+        // Merge targets count their arrivals up: ⊕ 1, ⊕ 2, …, then the final badge.
+        if (kind === 'merge') {
+            for (const i of hunk.nodes) {
+                const node = scene.nodes[i];
+                if (node?.role !== 'merge-target' || node.badge === undefined)
+                    continue;
+                const times = sources
+                    .filter((s) => scene.nodes[s]?.flow === i)
+                    .map((s) => c.nB[s])
+                    .sort((a, b) => a - b);
+                if (times.length === 0)
+                    times.push(CHOREO.mergeFlash[0]);
+                nArrivals[i] = Float64Array.from(times);
+                nBadgeSteps[i] = times.map((_, k) => k === times.length - 1 ? node.badge : mergeBadge(k + 1));
+            }
+        }
+        const appears = (i) => scene.nodes[i]?.hunk === hunk.index && (c.nKind[i] === NA_ADD || c.nKind[i] === NA_EMERGE);
+        const leaves = (i) => scene.nodes[i]?.hunk === hunk.index && (c.nKind[i] === NA_REMOVE || c.nKind[i] === NA_TRAVEL);
+        const edge = (j, kind2, ab, fromTarget = false, pivot = -1) => {
+            c.eKind[j] = kind2;
+            c.eA[j] = ab[0];
+            c.eB[j] = ab[1];
+            c.eFromTarget[j] = fromTarget ? 1 : 0;
+            c.ePivot[j] = pivot;
+        };
+        for (const j of hunk.edges) {
+            const e = scene.edges[j];
+            if (e === undefined)
+                continue;
+            const styles = edgeStyles[j];
+            const B = styles[1];
+            const A = styles[2];
+            switch (e.role) {
+                case 'added': {
+                    // Grow from the endpoint that already exists; between two new nodes, after they pop;
+                    // in merges / splits, once the travellers have arrived.
+                    const sNew = appears(e.s);
+                    const tNew = appears(e.t);
+                    const timing = sNew && tNew
+                        ? CHOREO.growBetweenNew
+                        : kind === 'add' && (sNew || tNew)
+                            ? CHOREO.growFromExisting
+                            : kind === 'merge' || kind === 'split'
+                                ? CHOREO.growAfterArrival
+                                : CHOREO.growOther;
+                    edge(j, EA_GROW, timing, sNew && !tNew);
+                    break;
+                }
+                case 'removed':
+                    edge(j, EA_RETRACT, CHOREO.retract, leaves(e.s) && !leaves(e.t));
+                    break;
+                case 'collapsed':
+                case 'carried': {
+                    if (kind === 'split' && e.role === 'carried') {
+                        const mover = c.nKind[e.s] === NA_EMERGE ? e.s : c.nKind[e.t] === NA_EMERGE ? e.t : -1;
+                        if (mover >= 0)
+                            edge(j, EA_FOLLOW_SPLIT, [c.nA[mover], c.nB[mover]], false, mover);
+                        else
+                            edge(j, EA_SWAP, CHOREO.swap);
+                        break;
+                    }
+                    const mover = c.nKind[e.sb] === NA_TRAVEL ? e.sb : c.nKind[e.tb] === NA_TRAVEL ? e.tb : -1;
+                    if (mover >= 0)
+                        edge(j, EA_FOLLOW_MERGE, [c.nA[mover], c.nB[mover]], false, mover);
+                    else if (e.role === 'collapsed')
+                        edge(j, EA_RETRACT, CHOREO.retract, leaves(e.s) && !leaves(e.t));
+                    else
+                        edge(j, EA_SWAP, CHOREO.swap);
+                    break;
+                }
+                case 'retarget': {
+                    const pivot = e.s === e.sb && e.t !== e.tb ? e.s : e.t === e.tb && e.s !== e.sb ? e.t : -1;
+                    if (pivot >= 0)
+                        edge(j, EA_SWING, CHOREO.swing, false, pivot);
+                    else
+                        edge(j, EA_SWAP, CHOREO.swap);
+                    break;
+                }
+                case 'modified':
+                    edge(j, EA_FADE, CHOREO.edgeFade);
+                    break;
+                case 'unchanged':
+                    break;
+                default:
+                    assertNever(e.role);
+            }
+            // Safety net for unusual style combinations (e.g. an edge hidden in both versions).
+            if (B.hidden && A.hidden)
+                c.eKind[j] = EA_NONE;
+        }
+    }
+    return c;
+}
+//# sourceMappingURL=choreography.js.map

package/dist/choreography.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,42 @@
+/** sRGB color with straight (non-premultiplied) alpha. Channels 0–255, alpha 0–1. */
+export interface Rgba {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    readonly a: number;
+}
+/** Parse `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`, `rgb()`, `rgba()` and `transparent`. */
+export declare function parseColor(css: string): Rgba;
+/** Source-over compositing of `fg` onto `bg` (both may be translucent). */
+export declare function composite(fg: Rgba, bg: Rgba): Rgba;
+/** WCAG 2.x relative luminance of an opaque color. */
+export declare function relativeLuminance(c: Rgba): number;
+/**
+ * WCAG 2.x contrast ratio in [1, 21]. A translucent foreground is composited over the
+ * background first; a translucent background is composited over white (the initial CSS
+ * canvas), since what lies beneath it is unknown.
+ */
+export declare function contrastRatio(foreground: string, background: string): number;
+/** `#rrggbb` when opaque, else `rgba(r, g, b, a)` (alpha rounded to 3 decimals). */
+export declare function formatColor(c: Rgba): string;
+/** Interpolate in sRGB with premultiplied alpha (no dark fringes when fading to transparent). */
+export declare function mixRgba(a: Rgba, b: Rgba, t: number): Rgba;
+/** `a` → `b` at `t` ∈ [0, 1]. */
+export declare function mix(a: string, b: string, t: number): string;
+/** The same color with its alpha replaced. */
+export declare function withAlpha(color: string, alpha: number): string;
+/** Move a color toward the gray of equal luma by `amount` ∈ [0, 1] (alpha kept). */
+export declare function desaturate(color: string, amount: number): string;
+/** Precomputed interpolation `from` → `to` for allocation-free animation. */
+export type ColorRamp = readonly string[];
+/** Number of steps in a ramp: smooth to the eye over the ≤ 1 s transitions it is used for. */
+export declare const RAMP_STEPS = 33;
+export declare function colorRamp(from: string, to: string, steps?: number): ColorRamp;
+/** Sample a ramp at `t` ∈ [0, 1]. Allocation-free. */
+export declare function rampAt(ramp: ColorRamp, t: number): string;
+/** Memoizes ramps by endpoint pair so equal transitions share one array. */
+export declare class RampCache {
+    private readonly cache;
+    get(from: string, to: string): ColorRamp;
+}
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AASA,qFAAqF;AACrF,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAqDD,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO5C;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAKlD;AAOD,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO5E;AAOD,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAM3C;AAED,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED,iCAAiC;AACjC,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,SAAS,MAAM,EAAE,CAAC;AAE1C,8FAA8F;AAC9F,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,SAAS,CASzF;AAED,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,4EAA4E;AAC5E,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAQvC;CACF"}

package/dist/color.js

@@ -0,0 +1,169 @@
+/**
+ * Color math for the design tokens: parsing, alpha compositing, WCAG contrast and
+ * derived colors (mixes, desaturation, precomputed ramps for animation).
+ *
+ * Everything here allocates; it runs when tokens or a resolver are built. Hot paths
+ * (the resolver at 60 fps) only index into precomputed `ColorRamp`s.
+ */
+import { KgdiffError } from '@kgdiff/core';
+const WHITE = { r: 255, g: 255, b: 255, a: 1 };
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+function invalid(css, why) {
+    throw new KgdiffError('invalid-input', `Unsupported color ${JSON.stringify(css)}: ${why}. Use #rgb, #rgba, #rrggbb, #rrggbbaa, rgb() or rgba().`, { color: css });
+}
+function parseHex(css, hex) {
+    if (!/^[0-9a-f]+$/i.test(hex))
+        invalid(css, 'not a hex color');
+    const short = hex.length === 3 || hex.length === 4;
+    if (!short && hex.length !== 6 && hex.length !== 8)
+        invalid(css, 'hex colors have 3, 4, 6 or 8 digits');
+    const channel = (i) => short
+        ? Number.parseInt(hex.charAt(i) + hex.charAt(i), 16)
+        : Number.parseInt(hex.slice(2 * i, 2 * i + 2), 16);
+    const hasAlpha = hex.length === 4 || hex.length === 8;
+    return { r: channel(0), g: channel(1), b: channel(2), a: hasAlpha ? channel(3) / 255 : 1 };
+}
+function parseChannel(css, token, scale) {
+    const percent = token.endsWith('%');
+    const value = Number(percent ? token.slice(0, -1) : token);
+    if (token === '' || !Number.isFinite(value))
+        invalid(css, `bad component "${token}"`);
+    return clamp(percent ? (value / 100) * scale : value, 0, scale);
+}
+function parseFunctional(css, body) {
+    // Both `rgb(1, 2, 3, 0.5)` and `rgb(1 2 3 / 50%)`.
+    const [channels = '', alphaPart, extra] = body.split('/');
+    if (extra !== undefined)
+        invalid(css, 'more than one "/"');
+    const parts = channels
+        .split(/[\s,]+/)
+        .map((s) => s.trim())
+        .filter((s) => s !== '');
+    if (alphaPart !== undefined)
+        parts.push(alphaPart.trim());
+    if (parts.length !== 3 && parts.length !== 4)
+        invalid(css, 'expected 3 or 4 components');
+    const [r = '', g = '', b = '', a] = parts;
+    return {
+        r: parseChannel(css, r, 255),
+        g: parseChannel(css, g, 255),
+        b: parseChannel(css, b, 255),
+        a: a === undefined ? 1 : parseChannel(css, a, 1),
+    };
+}
+/** Parse `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`, `rgb()`, `rgba()` and `transparent`. */
+export function parseColor(css) {
+    const s = css.trim().toLowerCase();
+    if (s.startsWith('#'))
+        return parseHex(css, s.slice(1));
+    if (s === 'transparent')
+        return { r: 0, g: 0, b: 0, a: 0 };
+    const m = /^rgba?\((.*)\)$/.exec(s);
+    if (m)
+        return parseFunctional(css, m[1] ?? '');
+    return invalid(css, 'unknown syntax');
+}
+/** Source-over compositing of `fg` onto `bg` (both may be translucent). */
+export function composite(fg, bg) {
+    const a = fg.a + bg.a * (1 - fg.a);
+    if (a === 0)
+        return { r: 0, g: 0, b: 0, a: 0 };
+    const ch = (f, b) => (f * fg.a + b * bg.a * (1 - fg.a)) / a;
+    return { r: ch(fg.r, bg.r), g: ch(fg.g, bg.g), b: ch(fg.b, bg.b), a };
+}
+const linear = (c) => {
+    const s = c / 255;
+    return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+};
+/** WCAG 2.x relative luminance of an opaque color. */
+export function relativeLuminance(c) {
+    return 0.2126 * linear(c.r) + 0.7152 * linear(c.g) + 0.0722 * linear(c.b);
+}
+/**
+ * WCAG 2.x contrast ratio in [1, 21]. A translucent foreground is composited over the
+ * background first; a translucent background is composited over white (the initial CSS
+ * canvas), since what lies beneath it is unknown.
+ */
+export function contrastRatio(foreground, background) {
+    let bg = parseColor(background);
+    if (bg.a < 1)
+        bg = composite(bg, WHITE);
+    const fg = composite(parseColor(foreground), bg);
+    const l1 = relativeLuminance(fg);
+    const l2 = relativeLuminance(bg);
+    return (Math.max(l1, l2) + 0.05) / (Math.min(l1, l2) + 0.05);
+}
+const hex2 = (v) => Math.round(clamp(v, 0, 255))
+    .toString(16)
+    .padStart(2, '0');
+/** `#rrggbb` when opaque, else `rgba(r, g, b, a)` (alpha rounded to 3 decimals). */
+export function formatColor(c) {
+    if (c.a >= 1)
+        return `#${hex2(c.r)}${hex2(c.g)}${hex2(c.b)}`.toUpperCase();
+    const r = Math.round(clamp(c.r, 0, 255));
+    const g = Math.round(clamp(c.g, 0, 255));
+    const b = Math.round(clamp(c.b, 0, 255));
+    return `rgba(${r}, ${g}, ${b}, ${Math.round(clamp(c.a, 0, 1) * 1000) / 1000})`;
+}
+/** Interpolate in sRGB with premultiplied alpha (no dark fringes when fading to transparent). */
+export function mixRgba(a, b, t) {
+    const u = clamp(t, 0, 1);
+    const alpha = a.a + (b.a - a.a) * u;
+    if (alpha === 0)
+        return { r: 0, g: 0, b: 0, a: 0 };
+    const ch = (x, y) => (x * a.a * (1 - u) + y * b.a * u) / alpha;
+    return { r: ch(a.r, b.r), g: ch(a.g, b.g), b: ch(a.b, b.b), a: alpha };
+}
+/** `a` → `b` at `t` ∈ [0, 1]. */
+export function mix(a, b, t) {
+    return formatColor(mixRgba(parseColor(a), parseColor(b), t));
+}
+/** The same color with its alpha replaced. */
+export function withAlpha(color, alpha) {
+    return formatColor({ ...parseColor(color), a: clamp(alpha, 0, 1) });
+}
+/** Move a color toward the gray of equal luma by `amount` ∈ [0, 1] (alpha kept). */
+export function desaturate(color, amount) {
+    const c = parseColor(color);
+    const gray = 0.2126 * c.r + 0.7152 * c.g + 0.0722 * c.b;
+    const u = clamp(amount, 0, 1);
+    return formatColor({
+        r: c.r + (gray - c.r) * u,
+        g: c.g + (gray - c.g) * u,
+        b: c.b + (gray - c.b) * u,
+        a: c.a,
+    });
+}
+/** Number of steps in a ramp: smooth to the eye over the ≤ 1 s transitions it is used for. */
+export const RAMP_STEPS = 33;
+export function colorRamp(from, to, steps = RAMP_STEPS) {
+    const a = parseColor(from);
+    const b = parseColor(to);
+    const out = [];
+    for (let i = 0; i < steps; i++)
+        out.push(formatColor(mixRgba(a, b, i / (steps - 1))));
+    // Exact endpoints: animations must settle on the very token strings.
+    out[0] = from;
+    out[steps - 1] = to;
+    return Object.freeze(out);
+}
+/** Sample a ramp at `t` ∈ [0, 1]. Allocation-free. */
+export function rampAt(ramp, t) {
+    const n = ramp.length - 1;
+    const i = t <= 0 ? 0 : t >= 1 ? n : Math.round(t * n);
+    return ramp[i];
+}
+/** Memoizes ramps by endpoint pair so equal transitions share one array. */
+export class RampCache {
+    cache = new Map();
+    get(from, to) {
+        const key = `${from}\u0000${to}`;
+        let ramp = this.cache.get(key);
+        if (ramp === undefined) {
+            ramp = colorRamp(from, to);
+            this.cache.set(key, ramp);
+        }
+        return ramp;
+    }
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Numeric constants of the visual language (docs/visual-language.md §Geometry, §Typography,
+ * §Level of detail, §Replay choreography). One place so every module agrees.
+ */
+/** Stroke widths in screen px (constant under zoom). */
+export declare const STROKE: {
+    readonly neutralEdge: 1;
+    readonly changedEdge: 1.75;
+    readonly selectedEdge: 2.5;
+    readonly node: 1.25;
+    readonly hoveredNode: 2;
+    readonly ring: 1.5;
+    /** Gap between the node boundary and its ring, px. */
+    readonly ringGap: 3.5;
+    readonly glyph: 1.5;
+    readonly suggestion: 1.25;
+    /** Diameter of a pivot dot, px. */
+    readonly pivot: 5;
+};
+/** Dash patterns, px. Frozen so they can be shared by every visual without copying. */
+export declare const DASH_GHOST: readonly number[];
+export declare const DASH_EDGE: readonly number[];
+export declare const DASH_DOTTED: readonly number[];
+export declare const HALO: {
+    /** Dark themes: radial glow radius as a multiple of r. */
+    readonly glowScale: 2.6;
+    readonly glowAlpha: 0.32;
+    /** Light themes: offset ring; `radius` is r and renderers draw the ring 5 px outside it, 2 px wide. */
+    readonly ringAlpha: 0.35;
+    readonly ringOffset: 5;
+    readonly ringWidth: 2;
+};
+/** Label typography in px. */
+export declare const LABEL: {
+    readonly size: 12;
+    readonly oldSize: 11;
+    readonly edgeSize: 10.5;
+    /** Gap between the node's bottom and its label, px (`offset = r·k + 5 px`). */
+    readonly offset: 5;
+    /** Secondary label sits this much lower than the primary one. */
+    readonly secondaryGap: 14;
+    /** Line box used for bounds estimation (font size × line height). */
+    readonly lineHeight: 1.3;
+};
+/**
+ * Level-of-detail thresholds (camera zoom). Label thresholds are permissive on purpose: the
+ * renderer's greedy collision culling decides what fits, so the overview of a small graph is
+ * not a field of anonymous dots.
+ */
+export declare const LOD: {
+    readonly changedLabel: 0.35;
+    readonly neutralLabel: 0.5;
+    readonly importantNeutralLabel: 0.35;
+    readonly importantThreshold: 0.7;
+    /** Scenes with at most this many visible nodes (after focus) use the small-scene thresholds. */
+    readonly smallScene: 300;
+    readonly smallChangedLabel: 0.2;
+    readonly smallNeutralLabel: 0.25;
+    readonly edgeLabel: 1.1;
+    readonly badge: 1.2;
+    /** Renderers draw arrowheads on edges with `arrow: false` from this zoom on. */
+    readonly arrow: 1.2;
+};
+/** Parallel edges between one pair curve with ±k·this (k = 1, 2, …). */
+export declare const PARALLEL_CURVATURE = 0.18;
+/** Alpha levels of the selection spotlight, the replay spotlight, filters and focus. */
+export declare const EMPHASIS: {
+    readonly selectedContext: 0.7;
+    readonly selectedRest: 0.18;
+    readonly replayContext: 0.7;
+    readonly replayRest: 0.3;
+    readonly filtered: 0.4;
+    readonly focusContext: 0.55;
+    readonly ghostEdge: 0.45;
+    readonly collapsedEdge: 0.5;
+};
+/** Replay window phases as fractions of the window (spotlight / transform / settle). */
+export declare const PHASE: {
+    readonly spotlightEnd: 0.18;
+    readonly settleStart: 0.82;
+};
+/** Replay timeline (docs/algorithms.md §10). */
+export declare const TIMELINE: {
+    readonly pace: 1100;
+    readonly chapterThreshold: 40;
+    readonly gap: 160;
+    readonly maxStagger: 0.35;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,eAAO,MAAM,MAAM;aACjB,WAAW,EAAE,CAAC;aACd,WAAW,EAAE,IAAI;aACjB,YAAY,EAAE,GAAG;aACjB,IAAI,EAAE,IAAI;aACV,WAAW,EAAE,CAAC;aACd,IAAI,EAAE,GAAG;IACT,sDAAsD;aACtD,OAAO,EAAE,GAAG;aACZ,KAAK,EAAE,GAAG;aACV,UAAU,EAAE,IAAI;IAChB,mCAAmC;aACnC,KAAK,EAAE,CAAC;CACA,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAA4B,CAAC;AACrE,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAA0B,CAAC;AAClE,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA0B,CAAC;AAEpE,eAAO,MAAM,IAAI;IACf,0DAA0D;aAC1D,SAAS,EAAE,GAAG;aACd,SAAS,EAAE,IAAI;IACf,uGAAuG;aACvG,SAAS,EAAE,IAAI;aACf,UAAU,EAAE,CAAC;aACb,SAAS,EAAE,CAAC;CACJ,CAAC;AAEX,8BAA8B;AAC9B,eAAO,MAAM,KAAK;aAChB,IAAI,EAAE,EAAE;aACR,OAAO,EAAE,EAAE;aACX,QAAQ,EAAE,IAAI;IACd,+EAA+E;aAC/E,MAAM,EAAE,CAAC;IACT,iEAAiE;aACjE,YAAY,EAAE,EAAE;IAChB,qEAAqE;aACrE,UAAU,EAAE,GAAG;CACP,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,GAAG;aACd,YAAY,EAAE,IAAI;aAClB,YAAY,EAAE,GAAG;aACjB,qBAAqB,EAAE,IAAI;aAC3B,kBAAkB,EAAE,GAAG;IACvB,gGAAgG;aAChG,UAAU,EAAE,GAAG;aACf,iBAAiB,EAAE,GAAG;aACtB,iBAAiB,EAAE,IAAI;aACvB,SAAS,EAAE,GAAG;aACd,KAAK,EAAE,GAAG;IACV,gFAAgF;aAChF,KAAK,EAAE,GAAG;CACF,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wFAAwF;AACxF,eAAO,MAAM,QAAQ;aACnB,eAAe,EAAE,GAAG;aACpB,YAAY,EAAE,IAAI;aAClB,aAAa,EAAE,GAAG;aAClB,UAAU,EAAE,GAAG;aACf,QAAQ,EAAE,GAAG;aACb,YAAY,EAAE,IAAI;aAClB,SAAS,EAAE,IAAI;aACf,aAAa,EAAE,GAAG;CACV,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,KAAK;aAChB,YAAY,EAAE,IAAI;aAClB,WAAW,EAAE,IAAI;CACT,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,QAAQ;aACnB,IAAI,EAAE,IAAI;aACV,gBAAgB,EAAE,EAAE;aACpB,GAAG,EAAE,GAAG;aACR,UAAU,EAAE,IAAI;CACR,CAAC"}