@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/components/TacOverlay.js

@@ -0,0 +1,116 @@
+// 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";
+import { rasterizeStage } from "../lib/rasterize";
+/**
+ * @public
+ */
+export function TacOverlay({ stage, width, height, trigger, thresholdPct = 300, debounceMs = 250, }) {
+    const canvasRef = useRef(null);
+    const [readout, setReadout] = useState(null);
+    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 (!stage || width <= 0 || height <= 0) {
+            setReadout(null);
+            return;
+        }
+        const handle = setTimeout(() => {
+            let image;
+            try {
+                image = rasterizeStage(stage);
+            }
+            catch {
+                // Stage's 2d context occasionally fails to acquire during
+                // teardown (unmount race); silently skip — next change will
+                // try again.
+                return;
+            }
+            const canvas = canvasRef.current;
+            if (!canvas)
+                return;
+            // Match the source image so writes are 1:1 — the canvas CSS
+            // size is what scales it back to the displayed Stage area.
+            canvas.width = image.width;
+            canvas.height = image.height;
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                return;
+            // One fused pass: sample TAC per pixel inline AND paint the
+            // overlay where TAC crosses the threshold. We can't reuse the
+            // shared sampler's `perPixelPct` for the threshold check
+            // because that array clamps the 0-400 % range to a byte
+            // (255 = ≥255 %), which collapses every pixel above the
+            // default 300 % threshold to a single bucket; honest threshold
+            // checks need the un-truncated percentage here.
+            const src = image.data;
+            const overlay = ctx.createImageData(image.width, image.height);
+            const dst = overlay.data;
+            const pixelCount = image.width * image.height;
+            let maxPct = 0;
+            let sumPct = 0;
+            for (let p = 0, i = 0; p < src.length; p += 4, i++) {
+                // Pre-multiply with opaque white background so semi-
+                // transparent pixels reflect printable ink. Mirrors the
+                // canonical sampler's composite step.
+                const a = (src[p + 3] ?? 255) / 255;
+                const inv = 1 - a;
+                const r = ((src[p] ?? 0) * a + 255 * inv) / 255;
+                const g = ((src[p + 1] ?? 0) * a + 255 * inv) / 255;
+                const b = ((src[p + 2] ?? 0) * a + 255 * inv) / 255;
+                const k = 1 - Math.max(r, g, b);
+                let c = 0;
+                let m = 0;
+                let y = 0;
+                if (k < 1) {
+                    const scale = 1 - k;
+                    c = (1 - r - k) / scale;
+                    m = (1 - g - k) / scale;
+                    y = (1 - b - k) / scale;
+                }
+                const tac = (c + m + y + k) * 100;
+                if (tac > maxPct)
+                    maxPct = tac;
+                sumPct += tac;
+                if (tac >= thresholdPct) {
+                    const j = i * 4;
+                    dst[j] = 220; // R
+                    dst[j + 1] = 38; // G
+                    dst[j + 2] = 38; // B
+                    // Alpha scales linearly from 64 at threshold to 192 at
+                    // (threshold + 100 %), so a 305 % pixel barely glows but
+                    // a 400 % pixel screams. Clamped to keep the red readable
+                    // over busy artwork.
+                    const intensity = Math.min(192, 64 + (tac - thresholdPct) * 1.28);
+                    dst[j + 3] = intensity;
+                }
+            }
+            ctx.putImageData(overlay, 0, 0);
+            setReadout({ maxPct, avgPct: pixelCount > 0 ? sumPct / pixelCount : 0 });
+        }, debounceMs);
+        return () => clearTimeout(handle);
+    }, [stage, width, height, trigger, thresholdPct, debounceMs]);
+    return (_jsxs(_Fragment, { children: [_jsx("canvas", { ref: canvasRef, style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: `${width}px`,
+                    height: `${height}px`,
+                    pointerEvents: "none",
+                } }), readout !== null && (_jsxs("output", { "aria-label": "Total area coverage", style: {
+                    position: "absolute",
+                    bottom: 8,
+                    left: 8,
+                    padding: "0.25rem 0.5rem",
+                    background: "rgba(15, 23, 42, 0.78)",
+                    color: "#f8fafc",
+                    fontSize: "0.7rem",
+                    fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+                    borderRadius: 4,
+                    pointerEvents: "none",
+                    lineHeight: 1.3,
+                }, children: [_jsxs("div", { children: ["TAC max ", readout.maxPct.toFixed(0), "%"] }), _jsxs("div", { style: { opacity: 0.75 }, children: ["avg ", readout.avgPct.toFixed(0), "%"] })] }))] }));
+}
+//# sourceMappingURL=TacOverlay.js.map

package/dist/components/TacOverlay.js.map

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

package/dist/components/TrapEditorPanel.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Controlled trap-policy shape consumed by the editor. Mirrors
+ * `@artworkpdf/document-model`'s `TrapPolicy` minus the runtime dep
+ * (the published editor package can't pull in document-model). Keep
+ * these in sync; the future structural-dedup follow-up will move both
+ * into a shared types module.
+ *
+ * @public
+ */
+export type TrapEditorValue = {
+    widthMm: number;
+    mode?: "auto" | "spread" | "choke";
+};
+/**
+ * @public
+ */
+export type TrapEditorPanelProps = {
+    /** Current policy. `undefined` means "no trap policy set" — the
+     *  panel renders empty defaults the user can fill in. */
+    value: TrapEditorValue | undefined;
+    /** Fires on every committed change (slider release, select change).
+     *  Hosts wire this to `document.pages[activeIdx].trapConfig` so the
+     *  D1 preview overlay (PR-12) updates live as the user adjusts. */
+    onChange: (next: TrapEditorValue) => void;
+    /** Min width in mm. Defaults to 0 (no trap). */
+    minMm?: number;
+    /** Max width in mm. Defaults to 1.0 — typical maximum for press
+     *  trapping. Hosts can raise for specialty work. */
+    maxMm?: number;
+    /** Step in mm. Defaults to 0.01 mm (one hundredth-millimeter) so
+     *  fine-grain edits feel natural. */
+    stepMm?: number;
+};
+/**
+ * D2 interactive trap-policy editor.
+ *
+ * Controlled component: takes the current `TrapEditorValue` and emits
+ * the next one on every committed change. Surfaces the two fields the
+ * Wave 1 `TrapPolicy` shape supports today — `widthMm` (0–1 mm) and
+ * `mode` (`auto` / `spread` / `choke`). Per-edge (top/right/bottom/
+ * left) and per-color-pair tables are wired in a follow-up once the
+ * compile-pdf trap producer exposes them; the panel layout reserves
+ * space for those without committing to their final shape.
+ *
+ * Renders no chrome of its own — hosts wrap it in whatever modal /
+ * drawer / right-rail container fits their layout (matches
+ * `JobSetupPanel`'s embedding convention).
+ *
+ * @public
+ */
+export declare function TrapEditorPanel({ value, onChange, minMm, maxMm, stepMm, }: TrapEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TrapEditorPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrapEditorPanel.d.ts","sourceRoot":"","sources":["../../src/components/TrapEditorPanel.tsx"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;6DACyD;IACzD,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC;;uEAEmE;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;wDACoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;yCACqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAS,EACT,KAAS,EACT,MAAa,GACd,EAAE,oBAAoB,2CA0FtB"}

package/dist/components/TrapEditorPanel.js

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+/**
+ * D2 interactive trap-policy editor.
+ *
+ * Controlled component: takes the current `TrapEditorValue` and emits
+ * the next one on every committed change. Surfaces the two fields the
+ * Wave 1 `TrapPolicy` shape supports today — `widthMm` (0–1 mm) and
+ * `mode` (`auto` / `spread` / `choke`). Per-edge (top/right/bottom/
+ * left) and per-color-pair tables are wired in a follow-up once the
+ * compile-pdf trap producer exposes them; the panel layout reserves
+ * space for those without committing to their final shape.
+ *
+ * Renders no chrome of its own — hosts wrap it in whatever modal /
+ * drawer / right-rail container fits their layout (matches
+ * `JobSetupPanel`'s embedding convention).
+ *
+ * @public
+ */
+export function TrapEditorPanel({ value, onChange, minMm = 0, maxMm = 1, stepMm = 0.01, }) {
+    const widthId = useId();
+    const modeId = useId();
+    const current = value ?? { widthMm: 0.144, mode: "auto" };
+    const updateWidth = (next) => {
+        // Clamp to the configured range so a stray pointer-up at the
+        // slider edges doesn't propagate an out-of-range value.
+        const clamped = Math.max(minMm, Math.min(maxMm, next));
+        onChange({ ...current, widthMm: clamped });
+    };
+    const updateMode = (next) => {
+        onChange({ ...current, mode: next });
+    };
+    return (_jsxs("div", { style: {
+            display: "flex",
+            flexDirection: "column",
+            gap: "0.75rem",
+            padding: "0.75rem",
+            fontSize: "0.85rem",
+            color: "#1f2937",
+            background: "#ffffff",
+            border: "1px solid #e5e7eb",
+            borderRadius: 6,
+            minWidth: 240,
+        }, children: [_jsxs("label", { htmlFor: widthId, style: { display: "flex", flexDirection: "column", gap: "0.25rem" }, children: [_jsx("span", { style: { fontWeight: 600 }, children: "Trap width" }), _jsxs("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [_jsx("input", { id: widthId, type: "range", min: minMm, max: maxMm, step: stepMm, value: current.widthMm, onChange: (e) => updateWidth(Number.parseFloat(e.target.value)), style: { flex: 1 } }), _jsxs("span", { style: {
+                                    minWidth: "3.5rem",
+                                    textAlign: "right",
+                                    fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+                                    fontSize: "0.75rem",
+                                }, children: [current.widthMm.toFixed(3), " mm"] })] })] }), _jsxs("label", { htmlFor: modeId, style: { display: "flex", flexDirection: "column", gap: "0.25rem" }, children: [_jsx("span", { style: { fontWeight: 600 }, children: "Mode" }), _jsxs("select", { id: modeId, value: current.mode ?? "auto", onChange: (e) => updateMode(e.target.value), style: {
+                            padding: "0.25rem 0.5rem",
+                            fontSize: "0.8rem",
+                            border: "1px solid #d1d5db",
+                            borderRadius: 4,
+                            background: "#ffffff",
+                        }, children: [_jsx("option", { value: "auto", children: "Auto (density-based)" }), _jsx("option", { value: "spread", children: "Spread (lighter into darker)" }), _jsx("option", { value: "choke", children: "Choke (darker into lighter)" })] })] }), _jsx("p", { style: {
+                    margin: 0,
+                    fontSize: "0.7rem",
+                    color: "#6b7280",
+                    lineHeight: 1.4,
+                }, children: "Per-edge and per-color-pair overrides land in a future revision once the compile-pdf trap producer exposes them." })] }));
+}
+//# sourceMappingURL=TrapEditorPanel.js.map

package/dist/components/TrapEditorPanel.js.map

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

package/dist/components/TrapPreviewOverlay.d.ts

@@ -0,0 +1,64 @@
+/**
+ * One trap operation as predicted by the D1 preview pass. Pixel-space
+ * rectangle in PDF points (1 pt = 1/72 in) plus the source/destination
+ * ink names.
+ *
+ * Mirrors compile-pdf's `trap_diff.operations[i]` shape (see
+ * `apps/service/src/compile-pdf-client.ts`'s `TrapOperation`). Kept
+ * inline here so the published editor package has no runtime dep on
+ * apps/service — a future refactor may centralize this shape in
+ * `@artworkpdf/document-model` to remove the structural duplication.
+ *
+ * @public
+ */
+export type TrapPreviewOperation = {
+    /** Server-side page index — **0-indexed**, matching compile-pdf's
+     *  `TrapZone.page_index: NonNegativeInt`. Note the distinct
+     *  convention from the overlay's prop, which uses **1-indexed**
+     *  `pageIndex` to match PDF user-facing page numbers; the overlay
+     *  converts internally. */
+    page_index: number;
+    rect_pt: [number, number, number, number];
+    from_ink: string;
+    to_ink: string;
+    width_pt?: number;
+};
+/**
+ * Pluggable preview fetcher. Hosts inject this so the editor never
+ * imports `CompilePdfClient` directly — matches the
+ * {@link import("./SwatchesPicker").SpotSearchFn} adapter pattern.
+ *
+ * @public
+ */
+export type TrapPreviewFn = () => Promise<{
+    operations: TrapPreviewOperation[];
+}>;
+/**
+ * @public
+ */
+export type TrapPreviewOverlayProps = {
+    /** Container width / height in CSS pixels — the overlay canvas
+     *  matches these so it aligns with the Konva Stage underneath. */
+    width: number;
+    height: number;
+    /** 1-indexed page number to render. The trap-diff payload may carry
+     *  operations for many pages; the overlay only draws this page. */
+    pageIndex: number;
+    /** Stage scale × DPR-equivalent factor: how many CSS pixels one PDF
+     *  point occupies. The component multiplies `rect_pt` by this to
+     *  position each trap rectangle on the overlay. */
+    pointsToPx: number;
+    /** Re-fetch trigger — change this value to debounce a new preview
+     *  pass. The value itself isn't read. Pass the editor's `objects`
+     *  array or a policy-version counter. */
+    trigger: unknown;
+    /** Async fetcher returning the trap operations for the current
+     *  document + policy. Hosts wire this to
+     *  `CompilePdfClient.trapPreview()` and a serialized canvas PDF. */
+    previewFn: TrapPreviewFn | null;
+    /** Debounce window in milliseconds. Defaults to 500 — slower than
+     *  C4's 250 ms because the trap preview is a server round trip. */
+    debounceMs?: number;
+};
+export declare function TrapPreviewOverlay({ width, height, pageIndex, pointsToPx, trigger, previewFn, debounceMs, }: TrapPreviewOverlayProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TrapPreviewOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrapPreviewOverlay.d.ts","sourceRoot":"","sources":["../../src/components/TrapPreviewOverlay.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;+BAI2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC;IACxC,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;sEACkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;uDAEmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB;;6CAEyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB;;wEAEoE;IACpE,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC;uEACmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA8BF,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,MAAM,EACN,SAAS,EACT,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAgB,GACjB,EAAE,uBAAuB,2CAoGzB"}

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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"}