@kgdiff/scene 0.0.0-stage → 0.2.0

package/dist/styles.js

@@ -0,0 +1,391 @@
+/**
+ * Static encodings: the "Layer encodings" table of docs/visual-language.md as precomputed,
+ * shared style records per element and layer (`union`, `before`, `after`). The resolver copies
+ * these into frame visuals and only animates elements inside active replay windows.
+ */
+import { desaturate, RampCache } from './color.js';
+import { DASH_EDGE, DASH_GHOST, EMPHASIS, HALO, STROKE } from './constants.js';
+import { assertNever } from './roles.js';
+// ─── Family codes ───────────────────────────────────────────────────────────
+export const F_ADDED = 0;
+export const F_REMOVED = 1;
+export const F_CONTENT = 2;
+export const F_STRUCTURE = 3;
+export const F_IDENTITY = 4;
+export const F_NEUTRAL = 5;
+export const FAMILY_BY_CODE = [
+    'added',
+    'removed',
+    'content',
+    'structure',
+    'identity',
+    'neutral',
+];
+export function familyCode(f) {
+    switch (f) {
+        case 'added':
+            return F_ADDED;
+        case 'removed':
+            return F_REMOVED;
+        case 'content':
+            return F_CONTENT;
+        case 'structure':
+            return F_STRUCTURE;
+        case 'identity':
+            return F_IDENTITY;
+        case 'neutral':
+            return F_NEUTRAL;
+        default:
+            return assertNever(f);
+    }
+}
+const tokenCache = new WeakMap();
+export function tokensFor(theme) {
+    const cached = tokenCache.get(theme);
+    if (cached !== undefined)
+        return cached;
+    const fam = theme.family;
+    const order = [fam.added, fam.removed, fam.content, fam.structure, fam.identity];
+    const tokens = {
+        theme,
+        base: [...order.map((f) => f.base), theme.neutral.node],
+        strong: [...order.map((f) => f.strong), theme.neutral.nodeStroke],
+        text: [...order.map((f) => f.text), theme.neutral.label],
+        soft: [...order.map((f) => f.soft), theme.surface.raised],
+        edge: [...order.map((f) => f.base), theme.neutral.edge],
+        // "content-colored, desaturated": keeps the amber family hint but reads as retired.
+        deprecatedFill: desaturate(fam.content.base, 0.6),
+        deprecatedStroke: desaturate(fam.content.strong, 0.6),
+        background: theme.canvas.background,
+        primary: theme.text.primary,
+        secondary: theme.text.secondary,
+        muted: theme.text.muted,
+        neutralLabel: theme.neutral.label,
+        accent: theme.accent.base,
+        glow: theme.glow,
+        haloScale: theme.glow ? HALO.glowScale : 1,
+        haloAlpha: theme.glow ? HALO.glowAlpha : HALO.ringAlpha,
+        weightRegular: theme.font.weightRegular,
+        weightStrong: theme.font.weightStrong,
+        ramps: new RampCache(),
+    };
+    tokenCache.set(theme, tokens);
+    return tokens;
+}
+/** Rebuild a node style as one literal in fixed field order: every style shares one map. */
+function nodeStyle(o) {
+    return Object.freeze({
+        hidden: o.hidden,
+        family: o.family,
+        fill: o.fill,
+        stroke: o.stroke,
+        dash: o.dash,
+        ring: o.ring,
+        halo: o.halo,
+        labelBefore: o.labelBefore,
+        labelColor: o.labelColor,
+        labelWeight: o.labelWeight,
+        strike: o.strike,
+        changed: o.changed,
+        secondary: o.secondary,
+        badge: o.badge,
+        z: o.z,
+    });
+}
+export const HIDDEN_NODE = nodeStyle({
+    hidden: true,
+    family: F_NEUTRAL,
+    fill: null,
+    stroke: null,
+    dash: null,
+    ring: null,
+    halo: null,
+    labelBefore: false,
+    labelColor: '',
+    labelWeight: 400,
+    strike: false,
+    changed: false,
+    secondary: false,
+    badge: false,
+    z: 0,
+});
+// ─── Edge styles ────────────────────────────────────────────────────────────
+/** Edge label sources. */
+export const EL_NONE = 0;
+export const EL_CURRENT = 1;
+export const EL_BEFORE = 2;
+/** `old → new` (union layer of a relabeled edge). */
+export const EL_UNION = 3;
+/** Rebuild an edge style as one literal in fixed field order: every style shares one map. */
+function edgeStyle(o) {
+    return Object.freeze({
+        hidden: o.hidden,
+        family: o.family,
+        before: o.before,
+        color: o.color,
+        width: o.width,
+        alpha: o.alpha,
+        dash: o.dash,
+        arrow: o.arrow,
+        label: o.label,
+        labelColor: o.labelColor,
+        strike: o.strike,
+        changed: o.changed,
+        z: o.z,
+    });
+}
+export const HIDDEN_EDGE = edgeStyle({
+    hidden: true,
+    family: F_NEUTRAL,
+    before: false,
+    color: '',
+    width: 0,
+    alpha: 0,
+    dash: null,
+    arrow: false,
+    label: EL_NONE,
+    labelColor: '',
+    strike: false,
+    changed: false,
+    z: 0,
+});
+/** Memoized style records: equal looks share one frozen object. */
+export class StyleBook {
+    tokens;
+    nodes = new Map();
+    edges = new Map();
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    node(look, family, o = {}) {
+        const key = `${look}|${family}|${o.labelBefore ? 1 : 0}${o.strike ? 1 : 0}${o.secondary ? 1 : 0}${o.badge ? 1 : 0}`;
+        let style = this.nodes.get(key);
+        if (style === undefined) {
+            style = nodeStyle(this.makeNode(look, family, o));
+            this.nodes.set(key, style);
+        }
+        return style;
+    }
+    makeNode(look, family, o) {
+        const t = this.tokens;
+        const common = {
+            hidden: false,
+            family,
+            dash: null,
+            ring: null,
+            halo: null,
+            labelBefore: o.labelBefore ?? false,
+            labelColor: t.primary,
+            labelWeight: t.weightStrong,
+            strike: o.strike ?? false,
+            changed: true,
+            secondary: o.secondary ?? false,
+            badge: o.badge ?? false,
+            z: 2,
+        };
+        switch (look) {
+            case 'neutral':
+                return {
+                    ...common,
+                    family: F_NEUTRAL,
+                    fill: t.base[F_NEUTRAL],
+                    stroke: t.strong[F_NEUTRAL],
+                    labelColor: t.neutralLabel,
+                    labelWeight: t.weightRegular,
+                    changed: false,
+                    z: 0,
+                };
+            case 'solid':
+                return { ...common, fill: t.base[family], stroke: t.strong[family] };
+            case 'added':
+                return {
+                    ...common,
+                    fill: t.base[family],
+                    stroke: t.strong[family],
+                    halo: t.base[family],
+                };
+            case 'ringed':
+                return {
+                    ...common,
+                    fill: t.base[family],
+                    stroke: t.strong[family],
+                    ring: t.base[family],
+                };
+            case 'ringHalo':
+                return {
+                    ...common,
+                    fill: t.base[family],
+                    stroke: t.strong[family],
+                    ring: t.base[family],
+                    halo: t.base[family],
+                };
+            case 'ghost':
+                return { ...common, fill: null, stroke: t.base[family], dash: DASH_GHOST, z: 1 };
+            case 'deprecated':
+                return {
+                    ...common,
+                    family: F_CONTENT,
+                    fill: t.deprecatedFill,
+                    stroke: t.deprecatedStroke,
+                    ring: t.deprecatedFill,
+                    strike: true,
+                };
+            default:
+                return assertNever(look);
+        }
+    }
+    edge(look, family, before, label, strike = false) {
+        const key = `${look}|${family}|${before ? 1 : 0}|${label}|${strike ? 1 : 0}`;
+        let style = this.edges.get(key);
+        if (style === undefined) {
+            style = edgeStyle(this.makeEdge(look, family, before, label, strike));
+            this.edges.set(key, style);
+        }
+        return style;
+    }
+    makeEdge(look, family, before, label, strike) {
+        const t = this.tokens;
+        const changed = {
+            hidden: false,
+            family,
+            before,
+            color: t.edge[family],
+            width: STROKE.changedEdge,
+            alpha: 1,
+            dash: null,
+            arrow: true,
+            label,
+            labelColor: t.text[family],
+            strike,
+            changed: true,
+            z: 2,
+        };
+        switch (look) {
+            case 'neutral':
+                return {
+                    ...changed,
+                    family: F_NEUTRAL,
+                    color: t.edge[F_NEUTRAL],
+                    width: STROKE.neutralEdge,
+                    labelColor: t.neutralLabel,
+                    changed: false,
+                    z: 0,
+                };
+            case 'solid':
+                return changed;
+            case 'dashed':
+                return { ...changed, dash: DASH_EDGE, z: 1 };
+            case 'collapsed':
+                return { ...changed, dash: DASH_EDGE, alpha: EMPHASIS.collapsedEdge, z: 1 };
+            default:
+                return assertNever(look);
+        }
+    }
+}
+/** [union, before, after] styles of a node (docs/visual-language.md §Layer encodings). */
+export function nodeLayerStyles(book, n) {
+    const fam = familyCode(n.family);
+    const renamed = n.labelBefore !== undefined;
+    switch (n.role) {
+        case 'unchanged': {
+            const s = book.node('neutral', F_NEUTRAL);
+            return [s, s, s];
+        }
+        case 'added': {
+            const s = book.node('added', F_ADDED, { badge: true });
+            return [s, HIDDEN_NODE, s];
+        }
+        case 'removed':
+            return [
+                book.node('ghost', F_REMOVED, { strike: true, badge: true }),
+                book.node('solid', F_REMOVED),
+                HIDDEN_NODE,
+            ];
+        case 'modified':
+            return [
+                book.node('ringed', fam, { secondary: renamed, badge: true }),
+                book.node('ringed', fam, { labelBefore: true }),
+                book.node('ringed', fam, { badge: true }),
+            ];
+        case 'deprecated':
+            return [
+                book.node('deprecated', F_CONTENT, { secondary: renamed, badge: true }),
+                book.node('ringed', F_CONTENT, { labelBefore: true }),
+                book.node('deprecated', F_CONTENT, { badge: true }),
+            ];
+        case 'merge-source':
+            return [
+                book.node('ghost', F_IDENTITY, { strike: true }),
+                book.node('solid', F_IDENTITY, { labelBefore: true }),
+                n.presentAfter ? book.node('deprecated', F_CONTENT) : HIDDEN_NODE,
+            ];
+        case 'merge-target':
+        case 'split-target': {
+            // Before: "neutral or own facet" (`familyBefore`).
+            const own = familyCode(n.familyBefore);
+            const before = !n.presentBefore
+                ? HIDDEN_NODE
+                : own === F_NEUTRAL
+                    ? book.node('neutral', F_NEUTRAL)
+                    : book.node('ringed', own, { labelBefore: true });
+            return [
+                book.node('ringHalo', F_IDENTITY, { secondary: renamed, badge: true }),
+                before,
+                book.node('ringHalo', F_IDENTITY, { badge: true }),
+            ];
+        }
+        case 'split-source':
+            return [
+                n.presentAfter
+                    ? book.node('ringHalo', F_IDENTITY, { secondary: renamed, badge: true })
+                    : book.node('ghost', F_IDENTITY, { strike: true }),
+                book.node('solid', F_IDENTITY, { labelBefore: true }),
+                n.presentAfter ? book.node('ringHalo', F_IDENTITY, { badge: true }) : HIDDEN_NODE,
+            ];
+        default:
+            return assertNever(n.role);
+    }
+}
+/** [union, before, after] styles of an edge (docs/visual-language.md §Layer encodings). */
+export function edgeLayerStyles(book, e) {
+    const fam = familyCode(e.family);
+    const relabeled = e.labelBefore !== undefined;
+    switch (e.role) {
+        case 'unchanged': {
+            const s = book.edge('neutral', F_NEUTRAL, false, EL_NONE);
+            return [s, s, s];
+        }
+        case 'added': {
+            const s = book.edge('solid', F_ADDED, false, EL_CURRENT);
+            return [s, HIDDEN_EDGE, s];
+        }
+        case 'removed':
+            return [
+                book.edge('dashed', F_REMOVED, false, EL_CURRENT, true),
+                book.edge('solid', F_REMOVED, false, EL_CURRENT),
+                HIDDEN_EDGE,
+            ];
+        case 'modified':
+            return [
+                book.edge('solid', fam, false, relabeled ? EL_UNION : EL_CURRENT),
+                book.edge('solid', fam, false, EL_BEFORE),
+                book.edge('solid', fam, false, EL_CURRENT),
+            ];
+        case 'retarget':
+        case 'carried':
+            return [
+                book.edge('solid', fam, false, relabeled ? EL_UNION : EL_CURRENT),
+                book.edge('solid', fam, true, EL_BEFORE),
+                book.edge('solid', fam, false, EL_CURRENT),
+            ];
+        case 'collapsed':
+            return [
+                book.edge('collapsed', F_IDENTITY, false, EL_CURRENT, true),
+                book.edge('solid', F_IDENTITY, false, EL_CURRENT),
+                HIDDEN_EDGE,
+            ];
+        default:
+            return assertNever(e.role);
+    }
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,14 @@
+import type { PaletteName, Theme, ThemeName } from './types.js';
+export declare const FONT_FAMILY: string;
+export declare const FONT_MONO = "\"JetBrains Mono\", \"SF Mono\", ui-monospace, Menlo, Consolas, monospace";
+export declare const THEME_NAMES: readonly ThemeName[];
+export declare const PALETTE_NAMES: readonly PaletteName[];
+/**
+ * Design tokens for a theme / palette pair (docs/visual-language.md §Color).
+ * Returns a deeply frozen, cached object: the same pair always yields the same instance,
+ * so it can key caches.
+ *
+ * @throws KgdiffError(`invalid-input`) for an unknown theme or palette name.
+ */
+export declare function getTheme(name: ThemeName, palette?: PaletteName): Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAA8B,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5F,eAAO,MAAM,WAAW,QAE4D,CAAC;AACrF,eAAO,MAAM,SAAS,8EAA0E,CAAC;AA6IjG,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAsB,CAAC;AACnE,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA8B,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,WAAuB,GAAG,KAAK,CAoBjF"}

package/dist/theme.js

@@ -0,0 +1,154 @@
+/**
+ * Design tokens (docs/visual-language.md §Color tokens, §Typography, motion).
+ *
+ * Four frozen themes: dark ("night") / light ("paper") × default / colorblind palette.
+ * Contrast requirements are asserted by `test/theme.test.ts`.
+ */
+import { KgdiffError } from '@kgdiff/core';
+import { withAlpha } from './color.js';
+export const FONT_FAMILY = 'Inter, "SF Pro Text", -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", ' +
+    '"Hiragino Sans GB", "Microsoft YaHei", "Noto Sans CJK SC", system-ui, sans-serif';
+export const FONT_MONO = '"JetBrains Mono", "SF Mono", ui-monospace, Menlo, Consolas, monospace';
+const MOTION = { fast: 120, base: 220, slow: 420, easing: [0.2, 0, 0, 1] };
+const FONT = {
+    family: FONT_FAMILY,
+    mono: FONT_MONO,
+    size: 12,
+    weightRegular: 400,
+    weightStrong: 600,
+};
+const DARK_FAMILIES = {
+    added: { base: '#34D399', strong: '#6EE7B7', soft: 'rgba(52,211,153,0.16)', text: '#6EE7B7' },
+    removed: { base: '#F87171', strong: '#FCA5A5', soft: 'rgba(248,113,113,0.15)', text: '#FCA5A5' },
+    content: { base: '#FBBF24', strong: '#FCD34D', soft: 'rgba(251,191,36,0.15)', text: '#FCD34D' },
+    structure: { base: '#38BDF8', strong: '#7DD3FC', soft: 'rgba(56,189,248,0.15)', text: '#7DD3FC' },
+    identity: { base: '#A78BFA', strong: '#C4B5FD', soft: 'rgba(167,139,250,0.17)', text: '#C4B5FD' },
+};
+const LIGHT_FAMILIES = {
+    // text: spec #15803D measures 4.20:1 over its soft tint on the canvas (badges); one step
+    // darker, same hue → 4.54:1.
+    added: { base: '#16A34A', strong: '#15803D', soft: 'rgba(22,163,74,0.11)', text: '#147A3A' },
+    removed: { base: '#DC2626', strong: '#B91C1C', soft: 'rgba(220,38,38,0.09)', text: '#B91C1C' },
+    // Spec value #D97706 measures 2.998:1 on #F7F8FA (needs ≥ 3:1); one step darker passes (3.06:1)
+    // and is visually indistinguishable. The soft tint keeps the original hue.
+    content: { base: '#D87506', strong: '#B45309', soft: 'rgba(217,119,6,0.11)', text: '#92400E' },
+    structure: { base: '#0284C7', strong: '#0369A1', soft: 'rgba(2,132,199,0.10)', text: '#075985' },
+    identity: { base: '#7C3AED', strong: '#6D28D9', soft: 'rgba(124,58,237,0.10)', text: '#5B21B6' },
+};
+/**
+ * Okabe–Ito based palette (spec gives base / text). Derived tokens follow the default palette's
+ * pattern: dark `strong` = `text` (as in every default dark family); light `strong` = the sRGB
+ * midpoint of base and text (between mark and text, like content / structure / identity);
+ * `soft` = base at the default palette's per-family tint alpha.
+ */
+function okabeIto(base, soft) {
+    const make = (f) => {
+        const [b, text, strong] = base[f];
+        return { base: b, strong, soft: withAlpha(b, soft[f]), text };
+    };
+    return {
+        added: make('added'),
+        removed: make('removed'),
+        content: make('content'),
+        structure: make('structure'),
+        identity: make('identity'),
+    };
+}
+const DARK_SOFT = { added: 0.16, removed: 0.15, content: 0.15, structure: 0.15, identity: 0.17 };
+const LIGHT_SOFT = { added: 0.11, removed: 0.09, content: 0.11, structure: 0.1, identity: 0.1 };
+const DARK_COLORBLIND = okabeIto({
+    added: ['#56B4E9', '#8FD0F5', '#8FD0F5'],
+    removed: ['#E69F00', '#F5C45C', '#F5C45C'],
+    content: ['#F0E442', '#F5EC85', '#F5EC85'],
+    structure: ['#009E73', '#3CC79E', '#3CC79E'],
+    identity: ['#CC79A7', '#E0A6C6', '#E0A6C6'],
+}, DARK_SOFT);
+const LIGHT_COLORBLIND = okabeIto({
+    added: ['#0072B2', '#005A8C', '#00669F'],
+    removed: ['#D55E00', '#A84A00', '#BF5400'],
+    content: ['#9A8700', '#6E6100', '#847400'],
+    structure: ['#00805C', '#006248', '#007152'],
+    identity: ['#A3477F', '#83335F', '#933D6F'],
+}, LIGHT_SOFT);
+function dark(palette) {
+    return {
+        name: 'dark',
+        palette,
+        canvas: { background: '#0B0E14', grid: 'rgba(148, 163, 184, 0.07)' },
+        surface: {
+            panel: '#11151D',
+            raised: '#171C26',
+            overlay: 'rgba(17, 21, 29, 0.78)',
+            border: 'rgba(255,255,255,0.07)',
+            borderStrong: 'rgba(255,255,255,0.13)',
+            controlBorder: '#5E687C',
+            shadow: '0 8px 32px rgba(0,0,0,0.45), 0 1px 0 rgba(255,255,255,0.04) inset',
+        },
+        // muted: spec #737D8F measures 4.11:1 on raised; same hue, lighter → ≥ 4.5:1 everywhere.
+        text: { primary: '#E7EBF3', secondary: '#A6AFBF', muted: '#7A8495' },
+        accent: { base: '#7C9CFF', strong: '#A3BAFF', soft: 'rgba(124,156,255,0.16)', text: '#A9BEFF' },
+        neutral: { node: '#4B5568', nodeStroke: '#5E687C', edge: '#323A4A', label: '#8B94A6' },
+        family: palette === 'colorblind' ? DARK_COLORBLIND : DARK_FAMILIES,
+        glow: true,
+        font: FONT,
+        motion: MOTION,
+    };
+}
+function light(palette) {
+    return {
+        name: 'light',
+        palette,
+        canvas: { background: '#F7F8FA', grid: 'rgba(15, 23, 42, 0.07)' },
+        surface: {
+            panel: '#FFFFFF',
+            raised: '#FFFFFF',
+            overlay: 'rgba(255, 255, 255, 0.82)',
+            border: 'rgba(15,23,42,0.08)',
+            borderStrong: 'rgba(15,23,42,0.15)',
+            controlBorder: '#8690A3',
+            shadow: '0 8px 28px rgba(15,23,42,0.10), 0 1px 2px rgba(15,23,42,0.06)',
+        },
+        // muted: spec #7B8597 measures 3.50:1 on the canvas; same hue, darker → ≥ 4.5:1 everywhere.
+        text: { primary: '#0F172A', secondary: '#475569', muted: '#687284' },
+        accent: { base: '#3B5BDB', strong: '#2F49B5', soft: 'rgba(59,91,219,0.10)', text: '#2F49B5' },
+        neutral: { node: '#A7B0BF', nodeStroke: '#8C96A8', edge: '#D3D9E2', label: '#5F6B7D' },
+        family: palette === 'colorblind' ? LIGHT_COLORBLIND : LIGHT_FAMILIES,
+        glow: false,
+        font: FONT,
+        motion: MOTION,
+    };
+}
+function deepFreeze(value) {
+    if (typeof value === 'object' && value !== null && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const v of Object.values(value))
+            deepFreeze(v);
+    }
+    return value;
+}
+const cache = new Map();
+export const THEME_NAMES = ['dark', 'light'];
+export const PALETTE_NAMES = ['default', 'colorblind'];
+/**
+ * Design tokens for a theme / palette pair (docs/visual-language.md §Color).
+ * Returns a deeply frozen, cached object: the same pair always yields the same instance,
+ * so it can key caches.
+ *
+ * @throws KgdiffError(`invalid-input`) for an unknown theme or palette name.
+ */
+export function getTheme(name, palette = 'default') {
+    if (!THEME_NAMES.includes(name)) {
+        throw new KgdiffError('invalid-input', `Unknown theme "${String(name)}" (expected "dark" or "light").`);
+    }
+    if (!PALETTE_NAMES.includes(palette)) {
+        throw new KgdiffError('invalid-input', `Unknown palette "${String(palette)}" (expected "default" or "colorblind").`);
+    }
+    const key = `${name}/${palette}`;
+    let theme = cache.get(key);
+    if (theme === undefined) {
+        theme = deepFreeze(name === 'dark' ? dark(palette) : light(palette));
+        cache.set(key, theme);
+    }
+    return theme;
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,CAAC,MAAM,WAAW,GACtB,sFAAsF;IACtF,kFAAkF,CAAC;AACrF,MAAM,CAAC,MAAM,SAAS,GAAG,uEAAuE,CAAC;AAEjG,MAAM,MAAM,GAAoB,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5F,MAAM,IAAI,GAAkB;IAC1B,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,EAAE;IACR,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;CAClB,CAAC;AAIF,MAAM,aAAa,GAAgB;IACjC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;IAChG,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/F,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;IACjG,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;CAClG,CAAC;AAEF,MAAM,cAAc,GAAgB;IAClC,yFAAyF;IACzF,6BAA6B;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9F,gGAAgG;IAChG,2EAA2E;IAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9F,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;IAChG,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;CACjG,CAAC;AAEF;;;;;GAKG;AACH,SAAS,QAAQ,CACf,IAAiF,EACjF,IAA4C;IAE5C,MAAM,IAAI,GAAG,CAAC,CAAe,EAAgB,EAAE;QAC7C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAChE,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACjG,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAEhG,MAAM,eAAe,GAAG,QAAQ,CAC9B;IACE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACxC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1C,SAAS,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC5C,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;CAC5C,EACD,SAAS,CACV,CAAC;AAEF,MAAM,gBAAgB,GAAG,QAAQ,CAC/B;IACE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACxC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1C,SAAS,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC5C,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;CAC5C,EACD,UAAU,CACX,CAAC;AAEF,SAAS,IAAI,CAAC,OAAoB;IAChC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO;QACP,MAAM,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,2BAA2B,EAAE;QACpE,OAAO,EAAE;YACP,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,wBAAwB;YACjC,MAAM,EAAE,wBAAwB;YAChC,YAAY,EAAE,wBAAwB;YACtC,aAAa,EAAE,SAAS;YACxB,MAAM,EAAE,mEAAmE;SAC5E;QACD,yFAAyF;QACzF,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACpE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACtF,MAAM,EAAE,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa;QAClE,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,OAAoB;IACjC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO;QACP,MAAM,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,wBAAwB,EAAE;QACjE,OAAO,EAAE;YACP,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,2BAA2B;YACpC,MAAM,EAAE,qBAAqB;YAC7B,YAAY,EAAE,qBAAqB;YACnC,aAAa,EAAE,SAAS;YACxB,MAAM,EAAE,+DAA+D;SACxE;QACD,4FAA4F;QAC5F,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACpE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC7F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACtF,MAAM,EAAE,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc;QACpE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,OAAO,GAAgB,SAAS;IACxE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CACnB,eAAe,EACf,kBAAkB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,WAAW,CACnB,eAAe,EACf,oBAAoB,MAAM,CAAC,OAAO,CAAC,yCAAyC,CAC7E,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/timeline.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Review / replay order and the replay timeline (docs/algorithms.md §10).
+ */
+import type { HunkKind, Rect, ReplayPhase } from '@kgdiff/core';
+import type { Timeline } from './types.js';
+export declare const PHASE_ORDER: readonly ReplayPhase[];
+export interface TourHunk {
+    readonly phase: ReplayPhase;
+    /** Changed nodes + edges. */
+    readonly size: number;
+    /** Default review order from core (tie-breaker). */
+    readonly order: number;
+    /** Anchor position. */
+    readonly x: number;
+    readonly y: number;
+    /** Indices (into the same array) of hunks that must come first (core `Hunk.requires`). */
+    readonly requires: readonly number[];
+}
+/**
+ * Order hunks as a short spatial tour (docs/algorithms.md §10) that respects `requires`:
+ *
+ * - Only *ready* hunks (every requirement already placed) are candidates.
+ * - Phase is a preference, not a barrier: the candidates are the ready hunks of the earliest
+ *   phase that has any, so a hunk may follow a later-phase hunk it requires.
+ * - The very first hunk is the largest candidate; every next one is the candidate nearest the
+ *   previous anchor (greedy nearest neighbour), which also starts each phase near where the
+ *   previous one ended.
+ * - Ties are broken by the default `order`. Unknown or self requirements are ignored; a cycle
+ *   (never produced by core) is broken by releasing its lowest-`order` hunk.
+ *
+ * Returns indices into `hunks`. ~O((H + R) √H) worst case, near-linear typically.
+ */
+export declare function tourOrder(hunks: readonly TourHunk[]): number[];
+/**
+ * Chapter of each hunk (hunks in a requirement-respecting order, e.g. the tour) for `chapters`
+ * mode: one chapter per phase present, in replay order; a hunk that requires a hunk of a later
+ * chapter moves to that chapter (the earliest chapter not before any requirement). O(H + R).
+ */
+export declare function chapterPlan(hunks: readonly {
+    readonly phase: ReplayPhase;
+    readonly requires: readonly number[];
+}[]): Int32Array;
+/** Play time of one hunk in `hunks` mode: `pace · kindFactor · clamp(√size, 1, 2.2)`. */
+export declare function hunkDuration(kind: HunkKind, size: number, pace: number): number;
+/** Length of a chapter of `n` hunks in `chapters` mode: `pace · clamp(1.2 + log₂ n, 1.2, 4)`. */
+export declare function chapterDuration(n: number, pace: number): number;
+export interface TimelineHunk {
+    readonly kind: HunkKind;
+    readonly phase: ReplayPhase;
+    readonly size: number;
+    readonly bounds: Rect;
+    /** Indices (into the same array) of hunks that must play first. */
+    readonly requires: readonly number[];
+}
+export declare const timelineMode: (hunkCount: number, chapterThreshold: number) => Timeline['mode'];
+/**
+ * Replay schedule for hunks already in play order (docs/algorithms.md §10). The order must
+ * respect `requires` (the tour does; in `chapters` mode, stable-sort the tour by `chapterPlan`).
+ *
+ * - `hunks` mode (≤ `chapterThreshold` hunks): one hunk at a time, 160 ms apart, so every hunk
+ *   starts after its requirements end. Chapters are the consecutive runs of one phase, reported
+ *   for scrubber grouping.
+ * - `chapters` mode: one chapter per `chapterPlan` value, of length
+ *   `pace · clamp(1.2 + log₂ n, 1.2, 4)`; its hunks play together, staggered in play order over
+ *   `35% · (n − 1) / n` of the chapter, so a hunk requiring another of its chapter starts later.
+ *   A chapter's `phase` is the phase it was planned for. Chapters are 160 ms apart.
+ */
+export declare function buildTimeline(hunks: readonly TimelineHunk[], pace: number, chapterThreshold: number): Timeline;
+//# sourceMappingURL=timeline.d.ts.map