@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

package/dist/components/TrapPreviewOverlay.js

@@ -0,0 +1,120 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+/**
+ * D1 background trap-preview overlay.
+ *
+ * Sits as an absolutely-positioned `<canvas>` on top of the Konva
+ * Stage, debouncing calls to a host-supplied
+ * {@link TrapPreviewFn} on every change to the `trigger` prop. Paints
+ * a translucent cyan band over each predicted trap region from the
+ * server's trap-diff so users see where ink spreading / choking will
+ * happen before submitting a full render.
+ *
+ * Approximate preview — uses the metadata-only `/v1/trap/preview`
+ * endpoint (compile-pdf PR #38) which runs the same trap analysis as
+ * `/trap/apply` but skips the PDF write. Users wanting bit-exact
+ * preview must still run a full job.
+ *
+ * @public
+ */
+/** Wipes any previously drawn trap rectangles. Called from every
+ *  "no overlay should be visible right now" branch so the canvas
+ *  doesn't keep stale visuals after the user disables the feature
+ *  or the preview request fails. */
+function clearOverlayCanvas(canvas) {
+    if (!canvas)
+        return;
+    const ctx = canvas.getContext("2d");
+    if (!ctx)
+        return;
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+}
+export function TrapPreviewOverlay({ width, height, pageIndex, pointsToPx, trigger, previewFn, debounceMs = 500, }) {
+    const canvasRef = useRef(null);
+    const [opsCount, setOpsCount] = useState(null);
+    const reqIdRef = useRef(0);
+    useEffect(() => {
+        // `trigger` is intentionally read here (no-op `void` cast) so the
+        // exhaustive-deps lint sees it as used; the actual value is never
+        // consumed — only its identity change is meaningful.
+        void trigger;
+        if (!previewFn || width <= 0 || height <= 0) {
+            // Reset BOTH state and canvas — otherwise the previously drawn
+            // trap bands stay visible after the user disables the feature
+            // via `enable_trap_preview` or the container collapses to 0×0.
+            setOpsCount(null);
+            clearOverlayCanvas(canvasRef.current);
+            return;
+        }
+        reqIdRef.current += 1;
+        const myReqId = reqIdRef.current;
+        const handle = setTimeout(async () => {
+            let result;
+            try {
+                result = await previewFn();
+            }
+            catch {
+                // Network / server failure — clear the overlay and stop. We
+                // don't surface the error because trap preview is advisory;
+                // failures shouldn't block editing.
+                if (myReqId === reqIdRef.current) {
+                    setOpsCount(null);
+                    clearOverlayCanvas(canvasRef.current);
+                }
+                return;
+            }
+            // Stale-response guard: a newer request fired while this one
+            // was in-flight; drop the result.
+            if (myReqId !== reqIdRef.current)
+                return;
+            // The server emits 0-indexed `page_index` (compile-pdf's
+            // `TrapZone.page_index: NonNegativeInt`); our prop is 1-indexed
+            // to match PDF user-facing page numbers. Convert at the boundary.
+            const pageOps = result.operations.filter((o) => o.page_index === pageIndex - 1);
+            setOpsCount(pageOps.length);
+            const canvas = canvasRef.current;
+            if (!canvas)
+                return;
+            canvas.width = Math.round(width);
+            canvas.height = Math.round(height);
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                return;
+            ctx.clearRect(0, 0, canvas.width, canvas.height);
+            ctx.fillStyle = "rgba(14, 165, 233, 0.45)";
+            for (const op of pageOps) {
+                const [llx, lly, urx, ury] = op.rect_pt;
+                const x = llx * pointsToPx;
+                // PDF coords are y-up from bottom; canvas coords are y-down
+                // from top. Mirror against the container height so traps land
+                // where the user sees them on screen.
+                const y = canvas.height - ury * pointsToPx;
+                const w = (urx - llx) * pointsToPx;
+                const h = (ury - lly) * pointsToPx;
+                ctx.fillRect(x, y, w, h);
+            }
+        }, debounceMs);
+        return () => clearTimeout(handle);
+    }, [width, height, pageIndex, pointsToPx, trigger, previewFn, debounceMs]);
+    return (_jsxs(_Fragment, { children: [_jsx("canvas", { ref: canvasRef, style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: `${width}px`,
+                    height: `${height}px`,
+                    pointerEvents: "none",
+                } }), opsCount !== null && opsCount > 0 && (_jsxs("output", { "aria-label": "Trap preview operations", style: {
+                    position: "absolute",
+                    bottom: 8,
+                    right: 8,
+                    padding: "0.25rem 0.5rem",
+                    background: "rgba(14, 116, 144, 0.85)",
+                    color: "#f0f9ff",
+                    fontSize: "0.7rem",
+                    fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+                    borderRadius: 4,
+                    pointerEvents: "none",
+                }, children: [opsCount, " trap", opsCount === 1 ? "" : "s"] }))] }));
+}
+//# sourceMappingURL=TrapPreviewOverlay.js.map

package/dist/components/TrapPreviewOverlay.js.map

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

package/dist/components/VariantMatrixPanel.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Wave 2 V2 — variant matrix UI for variable-data overrides.
+ *
+ * One row per {@link Variant}; one editable column per token in
+ * `tokenKeys`. The token columns mirror the document-level
+ * `variableData` token keys; each `Variant.overrides` maps a subset
+ * of those keys to variant-specific values. Absent keys inherit the
+ * document's defaults at merge time (Wave 3 V1).
+ *
+ * Structurally mirrors `@artworkpdf/document-model`'s `VariantMatrix`
+ * — inlined here so the editor stays consumable without
+ * document-model (same pattern as `EditorSeparation`,
+ * `FoldGeometryPanelMetadata`).
+ *
+ * Controlled component: pass `value` + `onChange`, panel reflects
+ * mutations back to the host on every keystroke. Hosts that need
+ * batched commits should debounce externally.
+ *
+ * @public
+ */
+/**
+ * One row of a {@link VariantMatrixPanelValue}.
+ *
+ * @public
+ */
+export type VariantMatrixPanelVariant = {
+    id: string;
+    name: string;
+    overrides: Record<string, string>;
+};
+/**
+ * Controlled value for the panel — the cross-product of variants
+ * (rows) × token keys (columns).
+ *
+ * @public
+ */
+export type VariantMatrixPanelValue = {
+    tokenKeys: string[];
+    variants: VariantMatrixPanelVariant[];
+};
+/**
+ * @public
+ */
+export type VariantMatrixPanelProps = {
+    /** Current matrix. `undefined` means "no variants configured" —
+     *  the panel offers an empty matrix with the document's token
+     *  keys as columns. */
+    value: VariantMatrixPanelValue | undefined;
+    /** Fires on every change to a variant row, a token cell, or a
+     *  token key. Hosts thread this into `document.variants`. */
+    onChange: (next: VariantMatrixPanelValue) => void;
+    /** Optional initial token keys to surface when `value` is
+     *  `undefined` — typically the document-level `variableData`
+     *  keys, so the matrix immediately reflects the merge surface. */
+    initialTokenKeys?: readonly string[];
+};
+/**
+ * @public
+ */
+export declare function VariantMatrixPanel({ value, onChange, initialTokenKeys }: VariantMatrixPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=VariantMatrixPanel.d.ts.map

package/dist/components/VariantMatrixPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariantMatrixPanel.d.ts","sourceRoot":"","sources":["../../src/components/VariantMatrixPanel.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;2BAEuB;IACvB,KAAK,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC3C;iEAC6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAClD;;sEAEkE;IAClE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,uBAAuB,2CAsJhG"}

package/dist/components/VariantMatrixPanel.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from "react";
+/**
+ * @public
+ */
+export function VariantMatrixPanel({ value, onChange, initialTokenKeys }) {
+    const effective = useMemo(() => {
+        if (value)
+            return value;
+        return {
+            tokenKeys: initialTokenKeys ? [...initialTokenKeys] : [],
+            variants: [],
+        };
+    }, [value, initialTokenKeys]);
+    // Monotonic counter to keep variant IDs stable across delete-then-add
+    // cycles. Length-derived ids (`v-${length + 1}`) collide whenever a
+    // middle row is removed and a new one added, which produces duplicate
+    // React keys and mis-targets row-level updates.
+    const nextVariantSuffix = useRef(1);
+    const addVariant = () => {
+        const used = new Set(effective.variants.map((v) => v.id));
+        let n = nextVariantSuffix.current;
+        let id = `v-${n}`;
+        while (used.has(id)) {
+            n += 1;
+            id = `v-${n}`;
+        }
+        nextVariantSuffix.current = n + 1;
+        onChange({
+            ...effective,
+            variants: [...effective.variants, { id, name: `Variant ${n}`, overrides: {} }],
+        });
+    };
+    const removeVariant = (id) => {
+        onChange({
+            ...effective,
+            variants: effective.variants.filter((v) => v.id !== id),
+        });
+    };
+    const renameVariant = (id, name) => {
+        onChange({
+            ...effective,
+            variants: effective.variants.map((v) => (v.id === id ? { ...v, name } : v)),
+        });
+    };
+    const setOverride = (id, key, val) => {
+        onChange({
+            ...effective,
+            variants: effective.variants.map((v) => {
+                if (v.id !== id)
+                    return v;
+                // Empty string means "clear the override" — drop the key so the
+                // variant falls back to the document-level default at merge
+                // time. Storing `""` would pin the override to an empty string,
+                // which is a different (and surprising) semantic.
+                if (val === "") {
+                    const { [key]: _removed, ...rest } = v.overrides;
+                    return { ...v, overrides: rest };
+                }
+                return { ...v, overrides: { ...v.overrides, [key]: val } };
+            }),
+        });
+    };
+    const addTokenKey = (key) => {
+        const trimmed = key.trim();
+        if (!trimmed || effective.tokenKeys.includes(trimmed))
+            return;
+        onChange({ ...effective, tokenKeys: [...effective.tokenKeys, trimmed] });
+    };
+    const removeTokenKey = (key) => {
+        onChange({
+            ...effective,
+            tokenKeys: effective.tokenKeys.filter((k) => k !== key),
+            variants: effective.variants.map((v) => {
+                if (!(key in v.overrides))
+                    return v;
+                const { [key]: _removed, ...rest } = v.overrides;
+                return { ...v, overrides: rest };
+            }),
+        });
+    };
+    return (_jsxs("div", { "data-testid": "variant-matrix-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: { display: "flex", gap: "0.5rem", alignItems: "baseline" }, children: [_jsx("h3", { style: { margin: 0 }, children: "Variants" }), _jsx("button", { type: "button", onClick: addVariant, "aria-label": "Add variant", children: "+ variant" }), _jsx(TokenKeyAdder, { onAdd: addTokenKey })] }), effective.variants.length === 0 ? (_jsxs("p", { style: { opacity: 0.6 }, children: ["No variants yet. Click ", _jsx("strong", { children: "+ variant" }), " to add the first row."] })) : (_jsxs("table", { style: { borderCollapse: "collapse", marginTop: "0.5rem" }, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { children: "Name" }), effective.tokenKeys.map((k) => (_jsxs("th", { children: [k, " ", _jsx("button", { type: "button", onClick: () => removeTokenKey(k), "aria-label": `Remove token ${k}`, title: `Remove token ${k}`, children: "\u00D7" })] }, k))), _jsx("th", {})] }) }), _jsx("tbody", { children: effective.variants.map((v) => (_jsxs("tr", { children: [_jsx("td", { children: _jsx("input", { value: v.name, onChange: (e) => renameVariant(v.id, e.target.value), "aria-label": `Variant name for ${v.id}` }) }), effective.tokenKeys.map((k) => (_jsx("td", { children: _jsx("input", { value: v.overrides[k] ?? "", onChange: (e) => setOverride(v.id, k, e.target.value), "aria-label": `${v.name} override for ${k}`, placeholder: "\u2014" }) }, k))), _jsx("td", { children: _jsx("button", { type: "button", onClick: () => removeVariant(v.id), "aria-label": `Remove variant ${v.name}`, children: "\u00D7" }) })] }, v.id))) })] }))] }));
+}
+function TokenKeyAdder({ onAdd }) {
+    return (_jsxs("form", { style: { display: "inline-flex", gap: "0.25rem" }, onSubmit: (e) => {
+            e.preventDefault();
+            const form = e.currentTarget;
+            const input = form.elements.namedItem("token");
+            if (input?.value) {
+                onAdd(input.value);
+                input.value = "";
+            }
+        }, children: [_jsx("input", { name: "token", placeholder: "+ token key", "aria-label": "New token key" }), _jsx("button", { type: "submit", children: "add" })] }));
+}
+//# sourceMappingURL=VariantMatrixPanel.js.map

package/dist/components/VariantMatrixPanel.js.map

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

package/dist/components/VariantMatrixVersionPanel.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Wave 4 V3 — versioned variant matrix viewer.
+ *
+ * Reads a list of historical {@link VariantMatrixSnapshot}s (typically
+ * derived from `DocumentV3.variants.version` paired with snapshots
+ * the host persists) and surfaces a "v1.2.0 vs v1.3.0" diff. Hosts
+ * that ship variant-aware versioning land this in their MIS chrome
+ * so a designer can answer "which row did the brand team add in the
+ * last revision?" without a full table re-read.
+ *
+ * Pure controlled component — host owns history, baselineVersion,
+ * and currentVersion. The diff helper {@link diffVariantMatrices}
+ * is exported so hosts can drive custom rendering (sparkline,
+ * change log, MIS audit row) over the same algorithm.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import type { VariantMatrixPanelValue, VariantMatrixPanelVariant } from "./VariantMatrixPanel";
+/**
+ * One historical variant-matrix snapshot. Structurally compatible
+ * with `{ version, ...VariantMatrix }` from
+ * `@artworkpdf/document-model` — hosts that carry their own
+ * version-history list construct snapshots by stamping each
+ * persisted `variants` payload with the matrix-level `version`.
+ *
+ * @public
+ */
+export type VariantMatrixSnapshot = {
+    version: string;
+    matrix: VariantMatrixPanelValue;
+};
+/**
+ * Per-variant modification record produced by
+ * {@link diffVariantMatrices}.
+ *
+ * `changedTokens` is the list of token keys whose value differs
+ * between baseline and current; `nameChanged` is true when the
+ * variant's human-readable `name` changed (with the `id` still
+ * matching). Either being non-empty makes the variant "modified".
+ *
+ * @public
+ */
+export type VariantMatrixModifiedVariant = {
+    id: string;
+    name: string;
+    changedTokens: readonly string[];
+    nameChanged: boolean;
+};
+/**
+ * Result of {@link diffVariantMatrices}.
+ *
+ * - `addedVariants` — present in `current` but not `baseline`.
+ * - `removedVariants` — present in `baseline` but not `current`.
+ * - `modifiedVariants` — present in both with at least one token
+ *    override change or a name change.
+ * - `addedTokenKeys` / `removedTokenKeys` — the diff of the column
+ *    set (`matrix.tokenKeys`).
+ *
+ * @public
+ */
+export type VariantMatrixDiffResult = {
+    addedVariants: readonly VariantMatrixPanelVariant[];
+    removedVariants: readonly VariantMatrixPanelVariant[];
+    modifiedVariants: readonly VariantMatrixModifiedVariant[];
+    addedTokenKeys: readonly string[];
+    removedTokenKeys: readonly string[];
+};
+/**
+ * @public
+ */
+export type VariantMatrixVersionPanelProps = {
+    /** Ordered version history, oldest → newest. Typically the host's
+     *  matrix-snapshot ring buffer. Empty array surfaces a "no
+     *  history yet" hint. */
+    history: readonly VariantMatrixSnapshot[];
+    /** Version to compare against. Absent → the second-to-latest
+     *  snapshot when `history.length >= 2`, else the only snapshot. */
+    baselineVersion?: string;
+    /** Version to compare as "current". Absent → the most-recent
+     *  snapshot. */
+    currentVersion?: string;
+    /** Fires when the user picks a different baseline from the panel's
+     *  dropdown. */
+    onBaselineChange?: (version: string) => void;
+    /** Fires when the user picks a different current version. */
+    onCurrentChange?: (version: string) => void;
+};
+/**
+ * Resolve which snapshot the panel should pull from `history`.
+ *
+ * Behaviour matches `PreflightDiffPanel.resolveBaselineSnapshot`:
+ * an explicit version wins when found, else falls back to the
+ * most-recent snapshot. Returns `undefined` only when `history` is
+ * empty. Falling back keeps the panel useful after a host trims
+ * history below the user's saved selection.
+ *
+ * Pure function; exposed for hosts that mirror the panel's
+ * selection in their own chrome.
+ *
+ * @public
+ */
+export declare function resolveSnapshot(history: readonly VariantMatrixSnapshot[], version: string | undefined): VariantMatrixSnapshot | undefined;
+/**
+ * Compute the variant-row + token-column diff between two matrices.
+ *
+ * Variants are matched by `id`; the human-readable `name` and token
+ * `overrides` are compared per-id. Token keys are diffed as sets
+ * (order-insensitive). Pure function — no React, no DOM.
+ *
+ * @public
+ */
+export declare function diffVariantMatrices(baseline: VariantMatrixPanelValue, current: VariantMatrixPanelValue): VariantMatrixDiffResult;
+/**
+ * Read-only viewer for a versioned variant matrix history. Picks
+ * a baseline + current version (dropdowns) and renders a per-row
+ * diff plus a token-column diff.
+ *
+ * @public
+ */
+export declare function VariantMatrixVersionPanel({ history, baselineVersion, currentVersion, onBaselineChange, onCurrentChange, }: VariantMatrixVersionPanelProps): ReactElement;
+//# sourceMappingURL=VariantMatrixVersionPanel.d.ts.map

package/dist/components/VariantMatrixVersionPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariantMatrixVersionPanel.d.ts","sourceRoot":"","sources":["../../src/components/VariantMatrixVersionPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAE/F;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACpD,eAAe,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACtD,gBAAgB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC1D,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C;;6BAEyB;IACzB,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C;uEACmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;oBACgB;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;oBACgB;IAChB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,qBAAqB,GAAG,SAAS,CAOnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,uBAAuB,EACjC,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,CAmCzB;AA+BD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,OAAO,EACP,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,EAAE,8BAA8B,GAAG,YAAY,CA6F/C"}

package/dist/components/VariantMatrixVersionPanel.js

@@ -0,0 +1,162 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo } from "react";
+/**
+ * Resolve which snapshot the panel should pull from `history`.
+ *
+ * Behaviour matches `PreflightDiffPanel.resolveBaselineSnapshot`:
+ * an explicit version wins when found, else falls back to the
+ * most-recent snapshot. Returns `undefined` only when `history` is
+ * empty. Falling back keeps the panel useful after a host trims
+ * history below the user's saved selection.
+ *
+ * Pure function; exposed for hosts that mirror the panel's
+ * selection in their own chrome.
+ *
+ * @public
+ */
+export function resolveSnapshot(history, version) {
+    if (history.length === 0)
+        return undefined;
+    if (version !== undefined) {
+        const explicit = history.find((s) => s.version === version);
+        if (explicit)
+            return explicit;
+    }
+    return history[history.length - 1];
+}
+/**
+ * Compute the variant-row + token-column diff between two matrices.
+ *
+ * Variants are matched by `id`; the human-readable `name` and token
+ * `overrides` are compared per-id. Token keys are diffed as sets
+ * (order-insensitive). Pure function — no React, no DOM.
+ *
+ * @public
+ */
+export function diffVariantMatrices(baseline, current) {
+    const baselineById = new Map(baseline.variants.map((v) => [v.id, v]));
+    const currentById = new Map(current.variants.map((v) => [v.id, v]));
+    const addedVariants = [];
+    const removedVariants = [];
+    const modifiedVariants = [];
+    for (const v of current.variants) {
+        const prior = baselineById.get(v.id);
+        if (!prior) {
+            addedVariants.push(v);
+            continue;
+        }
+        const changedTokens = diffOverrideKeys(prior.overrides, v.overrides);
+        const nameChanged = prior.name !== v.name;
+        if (changedTokens.length > 0 || nameChanged) {
+            modifiedVariants.push({
+                id: v.id,
+                name: v.name,
+                changedTokens,
+                nameChanged,
+            });
+        }
+    }
+    for (const v of baseline.variants) {
+        if (!currentById.has(v.id))
+            removedVariants.push(v);
+    }
+    const baselineTokens = new Set(baseline.tokenKeys);
+    const currentTokens = new Set(current.tokenKeys);
+    const addedTokenKeys = current.tokenKeys.filter((k) => !baselineTokens.has(k));
+    const removedTokenKeys = baseline.tokenKeys.filter((k) => !currentTokens.has(k));
+    return { addedVariants, removedVariants, modifiedVariants, addedTokenKeys, removedTokenKeys };
+}
+/**
+ * Diff two override maps and return the set of keys whose value
+ * differs. Keys present in only one side count as changed (the
+ * other side resolves to undefined). Uses `Object.hasOwn` so
+ * inherited properties don't sneak in.
+ */
+function diffOverrideKeys(prior, next) {
+    const keys = new Set();
+    for (const k of Object.keys(prior))
+        keys.add(k);
+    for (const k of Object.keys(next))
+        keys.add(k);
+    const changed = [];
+    for (const k of keys) {
+        const a = Object.hasOwn(prior, k) ? prior[k] : undefined;
+        const b = Object.hasOwn(next, k) ? next[k] : undefined;
+        if (a !== b)
+            changed.push(k);
+    }
+    return changed.sort();
+}
+const COLORS = {
+    added: "#070",
+    removed: "#a00",
+    modified: "#a60",
+    tokenChange: "#06a",
+};
+/**
+ * Read-only viewer for a versioned variant matrix history. Picks
+ * a baseline + current version (dropdowns) and renders a per-row
+ * diff plus a token-column diff.
+ *
+ * @public
+ */
+export function VariantMatrixVersionPanel({ history, baselineVersion, currentVersion, onBaselineChange, onCurrentChange, }) {
+    // All hooks must run before any conditional return — toggling
+    // `history` between empty and non-empty across renders would
+    // otherwise change the hook count and trip
+    // "Rendered fewer hooks than expected". The helpers tolerate
+    // empty input (`resolveSnapshot` returns undefined,
+    // `history[0]?.version` is undefined) so the work is cheap on
+    // the empty path.
+    const resolvedCurrent = resolveSnapshot(history, currentVersion);
+    // Default baseline = the version *before* current; lets the panel
+    // open with the most useful comparison ("what changed in the last
+    // edit?") without the host wiring two selectors.
+    const defaultBaselineVersion = history.length >= 2 ? history[history.length - 2]?.version : history[0]?.version;
+    const resolvedBaseline = resolveSnapshot(history, baselineVersion ?? defaultBaselineVersion);
+    const diff = useMemo(() => resolvedBaseline && resolvedCurrent
+        ? diffVariantMatrices(resolvedBaseline.matrix, resolvedCurrent.matrix)
+        : null, [resolvedBaseline, resolvedCurrent]);
+    if (history.length === 0) {
+        return (_jsx("div", { "data-testid": "variant-matrix-version-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "No matrix history yet \u2014 save the matrix to capture the first version." }));
+    }
+    return (_jsxs("div", { "data-testid": "variant-matrix-version-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: {
+                    display: "flex",
+                    alignItems: "baseline",
+                    gap: "0.5rem",
+                    marginBottom: "0.5rem",
+                }, children: [_jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Variant matrix diff" }), _jsx(VersionPicker, { dataTestId: "variant-matrix-baseline", label: "vs.", value: resolvedBaseline?.version ?? "", history: history, onChange: onBaselineChange }), _jsx(VersionPicker, { dataTestId: "variant-matrix-current", label: "\u2192", value: resolvedCurrent?.version ?? "", history: history, onChange: onCurrentChange })] }), diff && (_jsxs(_Fragment, { children: [_jsx(DiffSection, { label: "Added variants", color: COLORS.added, entries: diff.addedVariants.map((v) => v.name) }), _jsx(DiffSection, { label: "Removed variants", color: COLORS.removed, entries: diff.removedVariants.map((v) => v.name) }), _jsx(DiffSection, { label: "Modified variants", color: COLORS.modified, entries: diff.modifiedVariants.map((v) => v.changedTokens.length > 0
+                            ? `${v.name} (${v.changedTokens.join(", ")}${v.nameChanged ? "; renamed" : ""})`
+                            : `${v.name} (renamed)`) }), _jsx(DiffSection, { label: "Added token columns", color: COLORS.tokenChange, entries: [...diff.addedTokenKeys] }), _jsx(DiffSection, { label: "Removed token columns", color: COLORS.tokenChange, entries: [...diff.removedTokenKeys] })] }))] }));
+}
+/**
+ * One-row section of the diff viewer. Renders only when `entries`
+ * is non-empty, so an unchanged comparison shows nothing — keeps
+ * the panel quiet when there's nothing to say.
+ *
+ * Intra-package helper.
+ */
+function DiffSection({ label, color, entries, }) {
+    if (entries.length === 0)
+        return null;
+    return (_jsxs("section", { style: { marginBottom: "0.5rem" }, children: [_jsxs("h4", { style: { margin: "0 0 0.25rem 0", fontSize: "0.75rem", color }, children: [label, " (", entries.length, ")"] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: entries.map((entry, i) => (
+                // Composite key — two variants can legitimately share a
+                // name (the id is what disambiguates), and a token-column
+                // name can repeat across kind buckets. Including the index
+                // keeps React's reconciliation correct without exposing
+                // the internal ids in the rendered output.
+                _jsx("li", { style: { padding: "0.125rem 0.5rem", fontSize: "0.8125rem" }, children: entry }, `${label}-${i}-${entry}`))) })] }));
+}
+/**
+ * Version dropdown used twice in the header (baseline + current).
+ * Disabled state covers the read-only case where the host hasn't
+ * wired a setter.
+ *
+ * Intra-package helper.
+ */
+function VersionPicker({ dataTestId, label, value, history, onChange, }) {
+    return (_jsxs("label", { style: { fontSize: "0.75rem", color: "#666" }, children: [`${label} `, _jsx("select", { "data-testid": dataTestId, value: value, onChange: (e) => onChange?.(e.target.value), disabled: onChange === undefined, style: { fontFamily: "monospace", fontSize: "0.75rem" }, children: history.map((s) => (_jsxs("option", { value: s.version, children: ["v", s.version] }, s.version))) })] }));
+}
+//# sourceMappingURL=VariantMatrixVersionPanel.js.map

package/dist/components/VariantMatrixVersionPanel.js.map

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