@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/components/SmartSpotMatchPanel.js

@@ -0,0 +1,159 @@
+// 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, useMemo, useState } from "react";
+/**
+ * Pure helper — sorts a `SpotMatch` list ascending on `deltaE`
+ * (best-first). Stable on ties: input order preserved. Returns a
+ * new array.
+ *
+ * @public
+ */
+export function sortMatchesByDeltaE(matches) {
+    return [...matches]
+        .map((m, i) => ({ m, i }))
+        .sort((a, b) => a.m.deltaE - b.m.deltaE || a.i - b.i)
+        .map((x) => x.m);
+}
+/**
+ * Pure helper — maps a ΔE distance to a {@link DeltaEQuality} band
+ * using the CIE-1994 perceptual cut points (under 1 is
+ * imperceptible, 1–3 is noticeable, 3–5 is fair, ≥5 is poor). Used
+ * by the panel for the per-row severity chip; exported so hosts can
+ * surface the same banding outside the panel (e.g. in a print-proof
+ * audit). Returns `"poor"` for non-finite or negative inputs by
+ * threshold ordering — callers should pre-validate if they care.
+ *
+ * @public
+ */
+export function deltaEQuality(deltaE) {
+    if (!Number.isFinite(deltaE) || deltaE < 0)
+        return "poor";
+    if (deltaE < 1)
+        return "imperceptible";
+    if (deltaE < 3)
+        return "noticeable";
+    if (deltaE < 5)
+        return "fair";
+    return "poor";
+}
+/**
+ * Pure helper — formats ΔE for chip / row display (e.g. `"ΔE 1.2"`).
+ * Two-decimal precision matches what most ΔE engines emit and what
+ * print shops quote.
+ *
+ * @public
+ */
+export function formatDeltaE(deltaE) {
+    return `ΔE ${deltaE.toFixed(2)}`;
+}
+/**
+ * Pure helper — quickly checks whether a query has at least one
+ * color-space populated. Exported so hosts that drive the loader
+ * from outside the panel can gate their fetch on the same predicate.
+ *
+ * @public
+ */
+export function isQueryReady(query) {
+    return Boolean(query.cmyk || query.lab || query.hex?.trim());
+}
+const DELTA_E_COLORS = {
+    imperceptible: "#080",
+    noticeable: "#0a8",
+    fair: "#a60",
+    poor: "#a00",
+};
+/**
+ * Stateful panel — accepts a CMYK or hex input, calls the host
+ * loader, and surfaces ranked matches with ΔE chips. Hosts wire
+ * `onSelect` to push the picked spot into the active object's fill
+ * / stroke or into the separations registry.
+ *
+ * @public
+ */
+export function SmartSpotMatchPanel({ loader, initialQuery, limit, onSelect, }) {
+    const [hex, setHex] = useState(initialQuery?.hex ?? "");
+    const [matches, setMatches] = useState(null);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(false);
+    // Keep the hex input in lockstep with `initialQuery.hex` when the
+    // host swaps the active selection — without this, a panel reused
+    // for a different object would mix new cmyk / lab with the old
+    // hex value in the input.
+    useEffect(() => {
+        setHex(initialQuery?.hex ?? "");
+    }, [initialQuery?.hex]);
+    // Stable query object — re-derived only when content changes, not
+    // when a parent re-render hands back a referentially-different
+    // but content-identical `initialQuery`. The join'd keys identity-
+    // compare on content; the raw refs are read inside but excluded
+    // from the dep list intentionally.
+    const cmykKey = initialQuery?.cmyk?.join(",") ?? "";
+    const labKey = initialQuery?.lab?.join(",") ?? "";
+    // biome-ignore lint/correctness/useExhaustiveDependencies: cmyk / lab are content-keyed via cmykKey / labKey
+    const query = useMemo(() => ({
+        ...(hex.trim() && { hex: hex.trim() }),
+        ...(initialQuery?.cmyk && { cmyk: initialQuery.cmyk }),
+        ...(initialQuery?.lab && { lab: initialQuery.lab }),
+        ...(limit !== undefined && { limit }),
+    }), [hex, cmykKey, labKey, limit]);
+    useEffect(() => {
+        if (!isQueryReady(query)) {
+            setMatches(null);
+            setError(null);
+            setLoading(false);
+            return;
+        }
+        let disposed = false;
+        setLoading(true);
+        setError(null);
+        // Drop the previous result eagerly so stale rows can't be
+        // selected for a query that's no longer current.
+        setMatches(null);
+        void (async () => {
+            try {
+                const next = await loader(query);
+                if (disposed)
+                    return;
+                setMatches(sortMatchesByDeltaE(next));
+            }
+            catch (err) {
+                if (disposed)
+                    return;
+                setMatches(null);
+                setError(err instanceof Error ? err.message : String(err));
+            }
+            finally {
+                if (!disposed)
+                    setLoading(false);
+            }
+        })();
+        return () => {
+            disposed = true;
+        };
+    }, [loader, query]);
+    return (_jsxs("div", { "data-testid": "smart-spot-match-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Find PANTONE match" }) }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["sRGB hex", _jsx("input", { type: "text", "aria-label": "sRGB hex", placeholder: "#ff5102", value: hex, onChange: (e) => setHex(e.target.value), style: { display: "block", marginTop: "0.125rem", width: "100%" } })] }), loading && _jsx("div", { style: { opacity: 0.6, fontSize: "0.75rem" }, children: "Searching\u2026" }), error && (_jsxs("div", { role: "alert", style: { color: "#a00", fontSize: "0.75rem" }, children: ["Couldn't fetch matches: ", error] })), matches && matches.length === 0 && !loading && !error && (_jsx("div", { style: { opacity: 0.6, fontSize: "0.75rem" }, children: "No matches." })), matches && matches.length > 0 && (_jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: matches.map((match) => (_jsx(SmartSpotMatchRow, { match: match, onSelect: onSelect }, `${match.spot.library ?? "-"}|${match.spot.name}`))) }))] }));
+}
+function SmartSpotMatchRow({ match, onSelect, }) {
+    const quality = deltaEQuality(match.deltaE);
+    const chipColor = DELTA_E_COLORS[quality];
+    const rowContents = (_jsxs(_Fragment, { children: [_jsx("span", { style: { flex: 1, fontSize: "0.8125rem" }, children: match.spot.name }), _jsx("span", { "aria-label": `${formatDeltaE(match.deltaE)} — ${quality}`, style: {
+                    fontSize: "0.6875rem",
+                    padding: "0.0625rem 0.375rem",
+                    borderRadius: 999,
+                    background: chipColor,
+                    color: "#fff",
+                }, children: formatDeltaE(match.deltaE) })] }));
+    const rowStyle = {
+        display: "flex",
+        alignItems: "center",
+        gap: "0.5rem",
+        width: "100%",
+        padding: "0.25rem 0.5rem",
+        border: "1px solid transparent",
+        borderRadius: 4,
+        textAlign: "left",
+    };
+    return (_jsx("li", { children: onSelect ? (_jsx("button", { type: "button", onClick: () => onSelect(match), style: { ...rowStyle, cursor: "pointer", background: "transparent" }, "aria-label": match.spot.name, children: rowContents })) : (_jsx("div", { style: rowStyle, children: rowContents })) }));
+}
+//# sourceMappingURL=SmartSpotMatchPanel.js.map

package/dist/components/SmartSpotMatchPanel.js.map

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

package/dist/components/StreamingRenderProgress.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Wave 3 O3 — Streaming render progress panel.
+ *
+ * Shows live per-page progress for a long render that returns
+ * `text/event-stream` via `POST /v1/compose/stream`. The host wires
+ * a {@link StreamingRenderConnectFn} adapter (typically backed by an
+ * `EventSource` or a stubbed `AsyncIterable` for tests); the panel
+ * owns the event accumulator and renders the summary returned by
+ * {@link summarizeStreamingProgress}.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import { type StreamingRenderEvent } from "../lib/streaming-render";
+/**
+ * Host adapter — opens a stream and returns an async iterable of
+ * events plus a `close()` to abort. The shape lets a host wire an
+ * `EventSource` over `/v1/compose/stream`, a `fetch()` with
+ * `ReadableStream`, or a test mock interchangeably.
+ *
+ * The panel iterates events until the stream ends; on unmount it
+ * calls `close()` to abort.
+ *
+ * @public
+ */
+export type StreamingRenderConnectFn = () => {
+    events: AsyncIterable<StreamingRenderEvent>;
+    close: () => void;
+};
+/**
+ * Configuration for the {@link StreamingRenderProgress}.
+ *
+ * @public
+ */
+export type StreamingRenderProgressProps = {
+    /** Connect adapter. When absent the panel renders in
+     *  "ready to connect" mode and never opens a stream. */
+    connect?: StreamingRenderConnectFn;
+    /** Fires when the stream's `done` event lands — typically used
+     *  to redirect to the rendered PDF or refresh the job list. */
+    onDone?: (info: {
+        pdfSha256: string;
+        cacheKey: string;
+    }) => void;
+    /** Fires when the stream emits an error event — typically used
+     *  for telemetry / fallback to non-streaming render. */
+    onError?: (info: {
+        message: string;
+        code: string;
+    }) => void;
+};
+/**
+ * Stateful streaming-progress panel. Connects on mount when
+ * `connect` is supplied, accumulates events, surfaces summary +
+ * per-page badge list, and calls `onDone` / `onError` once.
+ *
+ * @public
+ */
+export declare function StreamingRenderProgress({ connect, onDone, onError, }: StreamingRenderProgressProps): ReactElement;
+//# sourceMappingURL=StreamingRenderProgress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingRenderProgress.d.ts","sourceRoot":"","sources":["../../src/components/StreamingRenderProgress.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM;IAC3C,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC5C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;4DACwD;IACxD,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;mEAC+D;IAC/D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE;4DACwD;IACxD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,MAAM,EACN,OAAO,GACR,EAAE,4BAA4B,GAAG,YAAY,CAwI7C"}

package/dist/components/StreamingRenderProgress.js

@@ -0,0 +1,99 @@
+// 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";
+import { summarizeStreamingProgress, } from "../lib/streaming-render";
+/**
+ * Stateful streaming-progress panel. Connects on mount when
+ * `connect` is supplied, accumulates events, surfaces summary +
+ * per-page badge list, and calls `onDone` / `onError` once.
+ *
+ * @public
+ */
+export function StreamingRenderProgress({ connect, onDone, onError, }) {
+    const [events, setEvents] = useState([]);
+    const handlersRef = useRef({ onDone, onError });
+    handlersRef.current = { onDone, onError };
+    useEffect(() => {
+        if (!connect)
+            return;
+        const handle = connect();
+        let disposed = false;
+        void (async () => {
+            try {
+                for await (const ev of handle.events) {
+                    if (disposed)
+                        return;
+                    setEvents((prev) => [...prev, ev]);
+                    if (ev.kind === "done") {
+                        handlersRef.current.onDone?.({
+                            pdfSha256: ev.pdfSha256,
+                            cacheKey: ev.cacheKey,
+                        });
+                    }
+                    else if (ev.kind === "error") {
+                        handlersRef.current.onError?.({ message: ev.message, code: ev.code });
+                    }
+                }
+            }
+            catch {
+                // Stream tear-down — surface as a synthetic error event so
+                // the summarizer flips to "error" status without the
+                // consumer having to special-case missing events.
+                if (!disposed) {
+                    setEvents((prev) => [
+                        ...prev,
+                        { kind: "error", message: "Stream closed unexpectedly.", code: "E_STREAM_ABORTED" },
+                    ]);
+                }
+            }
+        })();
+        return () => {
+            disposed = true;
+            handle.close();
+        };
+    }, [connect]);
+    const summary = summarizeStreamingProgress(events);
+    return (_jsxs("div", { "data-testid": "streaming-render-progress", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: {
+                    display: "flex",
+                    justifyContent: "space-between",
+                    alignItems: "baseline",
+                    marginBottom: "0.375rem",
+                }, children: [_jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Render progress" }), _jsxs("span", { style: { fontSize: "0.75rem", color: "#595959" }, children: [summary.percent, "% \u00B7 ", summary.completedPages, "/", summary.totalPages || "?"] })] }), _jsx("div", { "aria-label": "Render progress", role: "progressbar", "aria-valuenow": summary.percent, "aria-valuemin": 0, "aria-valuemax": 100, style: {
+                    background: "#eee",
+                    height: 6,
+                    borderRadius: 3,
+                    overflow: "hidden",
+                    marginBottom: "0.5rem",
+                }, children: _jsx("div", { style: {
+                        width: `${summary.percent}%`,
+                        height: "100%",
+                        background: summary.status === "error"
+                            ? "#a00"
+                            : summary.status === "done"
+                                ? "#080"
+                                : "#06a",
+                        transition: "width 200ms linear",
+                    } }) }), summary.status === "error" && summary.errorMessage && (_jsx("div", { role: "alert", style: { fontSize: "0.75rem", color: "#a00", marginBottom: "0.375rem" }, children: summary.errorMessage })), summary.status !== "error" && summary.totalPages > 0 && (_jsx("ul", { "aria-label": "Per-page status", style: {
+                    display: "flex",
+                    flexWrap: "wrap",
+                    gap: "0.25rem",
+                    listStyle: "none",
+                    padding: 0,
+                    margin: 0,
+                }, children: Array.from({ length: summary.totalPages }, (_, i) => {
+                    // O(1) lookup against the pre-computed Set so we don't
+                    // re-scan the raw events array on every badge.
+                    const done = summary.completedPageIndices.has(i);
+                    const active = summary.currentPage === i;
+                    const bg = done ? "#080" : active ? "#06a" : "#ccc";
+                    return (_jsx("li", { title: `Page ${i + 1}: ${done ? "done" : active ? "rendering" : "pending"}`, style: {
+                            width: 16,
+                            height: 16,
+                            borderRadius: 2,
+                            background: bg,
+                            border: "1px solid #999",
+                        } }, i));
+                }) })), summary.receivedBytes > 0 && (_jsxs("div", { style: { fontSize: "0.6875rem", color: "#595959", marginTop: "0.375rem" }, children: [(summary.receivedBytes / 1024).toFixed(1), " KB received"] })), !connect && (_jsx("div", { style: { fontSize: "0.75rem", color: "#595959" }, children: "Streaming adapter not wired." }))] }));
+}
+//# sourceMappingURL=StreamingRenderProgress.js.map

package/dist/components/StreamingRenderProgress.js.map

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

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