@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

package/dist/components/SwatchesPicker.d.ts

@@ -0,0 +1,83 @@
+/**
+ * One PANTONE catalogue entry from compile-pdf's `/v1/spots/*`
+ * endpoints. Mirrors `SpotEntry` on the apps/service
+ * `CompilePdfClient`, kept structural here so editor-app stays
+ * apps/service-dep-free.
+ *
+ * @public
+ */
+export type Spot = {
+    name: string;
+    library?: string | null;
+    lab?: [number, number, number] | null;
+    cmyk_bridge?: [number, number, number, number] | null;
+};
+/**
+ * Search adapter — the editor passes in a function that fronts
+ * `CompilePdfClient.spotSearch()`. Threading the search via a prop
+ * (rather than calling fetch directly) keeps SwatchesPicker
+ * decoupled from the network — tests pass a stub, the demo can
+ * preload an in-memory fixture, etc.
+ *
+ * @public
+ */
+export type SpotSearchFn = (opts: {
+    q?: string;
+    library?: string;
+    limit?: number;
+}) => Promise<{
+    results: Spot[];
+    total: number;
+    limit: number;
+}>;
+/**
+ * Library descriptor — matches the wire shape of one entry in
+ * `/v1/spots/libraries`.
+ *
+ * @public
+ */
+export type SpotLibrary = {
+    id: string;
+    count: number;
+};
+/**
+ * Props for the C3 SwatchesPicker palette.
+ *
+ * `search` is the only required prop; library filter + initial
+ * query are optional. `onSelect` fires when the user clicks a
+ * swatch — typically wired to AI4's `registerSpot` in the host.
+ *
+ * `enable_palettes: false` collapses the entire palette system off;
+ * hosts mount this component only when `isPanelVisible(config,
+ * "swatches")` returns true.
+ *
+ * @public
+ */
+export type SwatchesPickerProps = {
+    search: SpotSearchFn;
+    /** Initial libraries-filter dropdown values. Hosts that already
+     *  fetched `spotLibraries()` thread the result here. */
+    libraries?: SpotLibrary[];
+    /** Optional initial query. */
+    initialQuery?: string;
+    /** Click callback. Receives the full Spot row. */
+    onSelect: (spot: Spot) => void;
+};
+/**
+ * Right-rail palette for browsing compile-pdf's PANTONE catalogue
+ * (codex-pdf's public-domain reference set).
+ *
+ * UX:
+ * - Search input → debounced (250 ms) call to `search()`.
+ * - Optional library dropdown (when `libraries` is supplied).
+ * - Result list as colored chips with the canonical name; click
+ *   fires `onSelect`.
+ * - Footer disclaimer ("public-domain reference, not licensed
+ *   PANTONE data") — present per the trademark stance.
+ *
+ * @returns An `<aside>` element with search input, library filter,
+ *   results list, and the trademark disclaimer footer.
+ * @public
+ */
+export declare function SwatchesPicker({ search, libraries, initialQuery, onSelect, }: SwatchesPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SwatchesPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SwatchesPicker.d.ts","sourceRoot":"","sources":["../../src/components/SwatchesPicker.tsx"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE;IAChC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB;4DACwD;IACxD,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAChC,CAAC;AAoBF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,EACT,YAAiB,EACjB,QAAQ,GACT,EAAE,mBAAmB,2CAuKrB"}

package/dist/components/SwatchesPicker.js

@@ -0,0 +1,151 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+const PANEL_BG = "#1a0f08";
+const BORDER = "#3d1a00";
+const BRAND = "#fc5102";
+const TEXT = "#f4ece6";
+const MUTED = "#888";
+const DEBOUNCE_MS = 250;
+const inputStyle = {
+    flex: 1,
+    padding: "0.4rem 0.6rem",
+    background: "#0f0a05",
+    border: `1px solid ${BORDER}`,
+    borderRadius: 4,
+    color: TEXT,
+    fontSize: "0.8rem",
+    fontFamily: "inherit",
+};
+/**
+ * Right-rail palette for browsing compile-pdf's PANTONE catalogue
+ * (codex-pdf's public-domain reference set).
+ *
+ * UX:
+ * - Search input → debounced (250 ms) call to `search()`.
+ * - Optional library dropdown (when `libraries` is supplied).
+ * - Result list as colored chips with the canonical name; click
+ *   fires `onSelect`.
+ * - Footer disclaimer ("public-domain reference, not licensed
+ *   PANTONE data") — present per the trademark stance.
+ *
+ * @returns An `<aside>` element with search input, library filter,
+ *   results list, and the trademark disclaimer footer.
+ * @public
+ */
+export function SwatchesPicker({ search, libraries, initialQuery = "", onSelect, }) {
+    const [query, setQuery] = useState(initialQuery);
+    const [library, setLibrary] = useState("");
+    const [results, setResults] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const reqIdRef = useRef(0);
+    useEffect(() => {
+        // Debounce — bump the request id and only commit results from
+        // the latest call. Prevents stale results overriding fresh ones
+        // when the user types quickly.
+        const id = ++reqIdRef.current;
+        const handle = setTimeout(() => {
+            setLoading(true);
+            setError(null);
+            const opts = { limit: 50 };
+            if (query)
+                opts.q = query;
+            if (library)
+                opts.library = library;
+            search(opts)
+                .then((res) => {
+                if (id !== reqIdRef.current)
+                    return; // stale
+                setResults(res.results);
+                setLoading(false);
+            })
+                .catch((err) => {
+                if (id !== reqIdRef.current)
+                    return;
+                const msg = err instanceof Error ? err.message : "spots search failed";
+                setError(msg);
+                setLoading(false);
+            });
+        }, DEBOUNCE_MS);
+        return () => clearTimeout(handle);
+    }, [query, library, search]);
+    return (_jsxs("aside", { style: {
+            width: 240,
+            background: PANEL_BG,
+            borderLeft: `1px solid ${BORDER}`,
+            color: TEXT,
+            display: "flex",
+            flexDirection: "column",
+            overflow: "hidden",
+            flexShrink: 0,
+        }, children: [_jsx("div", { style: {
+                    fontSize: "0.7rem",
+                    letterSpacing: "0.08em",
+                    textTransform: "uppercase",
+                    color: MUTED,
+                    padding: "0.55rem 0.85rem",
+                    borderBottom: `1px solid ${BORDER}`,
+                }, children: "Swatches" }), _jsx("div", { style: { padding: "0.55rem 0.65rem", display: "flex", gap: "0.4rem" }, children: _jsx("input", { value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search PANTONE\u2026", "aria-label": "Search PANTONE catalogue", style: inputStyle }) }), libraries && libraries.length > 0 && (_jsx("div", { style: { padding: "0 0.65rem 0.55rem" }, children: _jsxs("select", { value: library, onChange: (e) => setLibrary(e.target.value), "aria-label": "Filter by library", style: { ...inputStyle, width: "100%" }, children: [_jsx("option", { value: "", children: "All libraries" }), libraries.map((lib) => (_jsxs("option", { value: lib.id, children: [lib.id, " (", lib.count, ")"] }, lib.id)))] }) })), _jsxs("div", { style: { flex: 1, overflow: "auto" }, children: [loading && (_jsx("div", { style: { padding: "0.55rem 0.85rem", color: MUTED, fontSize: "0.78rem" }, children: "Loading\u2026" })), error && !loading && (_jsx("div", { role: "alert", style: { padding: "0.55rem 0.85rem", color: "#ef4444", fontSize: "0.78rem" }, children: error })), !loading && !error && results.length === 0 && (_jsx("div", { style: { padding: "0.55rem 0.85rem", color: MUTED, fontSize: "0.78rem" }, children: "No matches." })), !loading &&
+                        !error &&
+                        results.map((spot) => {
+                            const swatchColor = labToCssApprox(spot.lab) ?? "#666";
+                            return (_jsxs("button", { type: "button", onClick: () => onSelect(spot), style: {
+                                    display: "flex",
+                                    alignItems: "center",
+                                    gap: "0.55rem",
+                                    width: "100%",
+                                    padding: "0.35rem 0.85rem",
+                                    background: "transparent",
+                                    border: "none",
+                                    borderLeft: "2px solid transparent",
+                                    cursor: "pointer",
+                                    color: TEXT,
+                                    fontSize: "0.78rem",
+                                    fontFamily: "inherit",
+                                    textAlign: "left",
+                                }, onMouseEnter: (e) => {
+                                    e.currentTarget.style.borderLeftColor = BRAND;
+                                }, onMouseLeave: (e) => {
+                                    e.currentTarget.style.borderLeftColor = "transparent";
+                                }, children: [_jsx("span", { style: {
+                                            display: "inline-block",
+                                            width: 16,
+                                            height: 16,
+                                            borderRadius: 3,
+                                            background: swatchColor,
+                                            border: `1px solid ${BORDER}`,
+                                            flexShrink: 0,
+                                        } }), _jsx("span", { style: { overflow: "hidden", textOverflow: "ellipsis" }, children: spot.name })] }, spot.name));
+                        })] }), _jsx("div", { style: {
+                    padding: "0.45rem 0.85rem",
+                    borderTop: `1px solid ${BORDER}`,
+                    color: MUTED,
+                    fontSize: "0.65rem",
+                    lineHeight: 1.35,
+                }, children: "Public-domain colour-science reference. Not licensed PANTONE data." })] }));
+}
+/**
+ * Crude Lab → CSS-color approximation for the swatch chips. Not a
+ * colorimetric conversion — just enough to give each row a
+ * recognizable tint in the picker. Returns `undefined` for entries
+ * without a Lab triplet (the chip falls back to a neutral grey).
+ *
+ * Lab L is 0-100 (perceptual lightness); we map directly to sRGB
+ * grey then shift slightly toward a/b axes. Future: replace with a
+ * proper Lab→sRGB conversion via culori or chroma-js if perceptual
+ * accuracy matters for the picker.
+ */
+function labToCssApprox(lab) {
+    if (!lab)
+        return undefined;
+    const [L, a, b] = lab;
+    // Very rough — clamps to a tinted grey based on a/b sign.
+    const lum = Math.max(0, Math.min(255, Math.round((L / 100) * 255)));
+    const r = Math.max(0, Math.min(255, lum + Math.round(a * 1.5)));
+    const g = Math.max(0, Math.min(255, lum - Math.round(Math.abs(a) * 0.5)));
+    const bl = Math.max(0, Math.min(255, lum - Math.round(b * 1.5)));
+    return `rgb(${r}, ${g}, ${bl})`;
+}
+//# sourceMappingURL=SwatchesPicker.js.map

package/dist/components/SwatchesPicker.js.map

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

package/dist/components/TacOverlay.d.ts

@@ -0,0 +1,47 @@
+import type Konva from "konva";
+/**
+ * C4 live total-area-coverage overlay.
+ *
+ * Sits as an absolutely-positioned `<canvas>` on top of the Konva
+ * Stage, debouncing a rasterize-and-sample pass on every change to
+ * the watched objects array. Paints pixels whose TAC exceeds the
+ * configured threshold (default 300%) in translucent red — a "where
+ * the ink is going to pool" hint — and shows a `max / avg` chip in
+ * the bottom-left.
+ *
+ * Browser-side sanity check, not a colorimetric proof: the same
+ * caveats as {@link import("../lib/rasterize").sampleTACFromImageData}
+ * apply (subtractive sRGB → CMYK with K-extraction, alpha composited
+ * onto an opaque white background). Production TAC enforcement lives
+ * server-side in compile-pdf's `total_ink_coverage` preflight rule.
+ *
+ * @public
+ */
+export type TacOverlayProps = {
+    /** Live Konva Stage. The overlay no-ops while this is `null` (the
+     *  ref starts null on first render). */
+    stage: Konva.Stage | null;
+    /** Container width/height in CSS pixels — the overlay canvas
+     *  matches these so it lines up with the Stage. */
+    width: number;
+    height: number;
+    /** Re-sample trigger. Any change to this value (by reference for
+     *  arrays, by equality for primitives) debounces a new rasterize
+     *  pass. The value itself isn't read — it just lets React's effect
+     *  diffing detect editor changes. Pass `objects` (the canvas
+     *  contents array) so every commit re-samples. */
+    trigger: unknown;
+    /** TAC threshold in percent (0-400). Pixels at or above the
+     *  threshold are painted; pixels below are transparent. Defaults to
+     *  300% — the standard coated-stock preflight ceiling. */
+    thresholdPct?: number;
+    /** Debounce window in milliseconds before a new sample fires.
+     *  Defaults to 250 ms — fast enough to feel live, slow enough that
+     *  click-drag operations don't thrash the rasterizer. */
+    debounceMs?: number;
+};
+/**
+ * @public
+ */
+export declare function TacOverlay({ stage, width, height, trigger, thresholdPct, debounceMs, }: TacOverlayProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TacOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TacOverlay.d.ts","sourceRoot":"","sources":["../../src/components/TacOverlay.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;4CACwC;IACxC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC1B;uDACmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;sDAIkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;6DAEyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,EACP,YAAkB,EAClB,UAAgB,GACjB,EAAE,eAAe,2CA0HjB"}

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":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAEb,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAqC9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,EACT,MAAM,GAAG,IAAI,GACQ;IACrB,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,MAAM,OAAO,GAAoB,KAAK,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAE3E,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;QACnC,6DAA6D;QAC7D,wDAAwD;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAA0C,EAAE,EAAE;QAChE,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,OAAO,CACL,eACE,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,QAAQ;YACvB,GAAG,EAAE,SAAS;YACd,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,GAAG;SACd,aAED,iBAAO,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,aAC1F,eAAM,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,2BAAmB,EACnD,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,aAClE,gBACE,EAAE,EAAE,OAAO,EACX,IAAI,EAAC,OAAO,EACZ,GAAG,EAAE,KAAK,EACV,GAAG,EAAE,KAAK,EACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,CAAC,OAAO,EACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAClB,EACF,gBACE,KAAK,EAAE;oCACL,QAAQ,EAAE,QAAQ;oCAClB,SAAS,EAAE,OAAO;oCAClB,UAAU,EAAE,gDAAgD;oCAC5D,QAAQ,EAAE,SAAS;iCACpB,aAEA,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WACtB,IACH,IACA,EAER,iBAAO,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,aACzF,eAAM,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,qBAAa,EAC7C,kBACE,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAC7B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAA6C,CAAC,EACnF,KAAK,EAAE;4BACL,OAAO,EAAE,gBAAgB;4BACzB,QAAQ,EAAE,QAAQ;4BAClB,MAAM,EAAE,mBAAmB;4BAC3B,YAAY,EAAE,CAAC;4BACf,UAAU,EAAE,SAAS;yBACtB,aAED,iBAAQ,KAAK,EAAC,MAAM,qCAA8B,EAClD,iBAAQ,KAAK,EAAC,QAAQ,6CAAsC,EAC5D,iBAAQ,KAAK,EAAC,OAAO,4CAAqC,IACnD,IACH,EAER,YACE,KAAK,EAAE;oBACL,MAAM,EAAE,CAAC;oBACT,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,GAAG;iBAChB,iIAIC,IACA,CACP,CAAC;AACJ,CAAC"}

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