@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.3.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/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":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAEb,OAAO,EAAsB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAmExE,MAAM,QAAQ,GAAG,SAAS,CAAC;AAC3B,MAAM,MAAM,GAAG,SAAS,CAAC;AACzB,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,KAAK,GAAG,MAAM,CAAC;AACrB,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,aAAa,MAAM,EAAE;IAC7B,YAAY,EAAE,CAAC;IACf,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,EACT,YAAY,GAAG,EAAE,EACjB,QAAQ,GACY;IACpB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAc,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IACnD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,8DAA8D;QAC9D,gEAAgE;QAChE,+BAA+B;QAC/B,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,MAAM,IAAI,GAAgC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACxD,IAAI,KAAK;gBAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;YAC1B,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC;iBACT,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;gBACZ,IAAI,EAAE,KAAK,QAAQ,CAAC,OAAO;oBAAE,OAAO,CAAC,QAAQ;gBAC7C,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,EAAE,KAAK,QAAQ,CAAC,OAAO;oBAAE,OAAO;gBACpC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC;gBACvE,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACd,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,WAAW,CAAC,CAAC;QAChB,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7B,OAAO,CACL,iBACE,KAAK,EAAE;YACL,KAAK,EAAE,GAAG;YACV,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,aAAa,MAAM,EAAE;YACjC,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,QAAQ;YACvB,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,CAAC;SACd,aAED,cACE,KAAK,EAAE;oBACL,QAAQ,EAAE,QAAQ;oBAClB,aAAa,EAAE,QAAQ;oBACvB,aAAa,EAAE,WAAW;oBAC1B,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,iBAAiB;oBAC1B,YAAY,EAAE,aAAa,MAAM,EAAE;iBACpC,yBAGG,EACN,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,YACxE,gBACE,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACzC,WAAW,EAAC,sBAAiB,gBAClB,0BAA0B,EACrC,KAAK,EAAE,UAAU,GACjB,GACE,EACL,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CACpC,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,YAC1C,kBACE,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,gBAChC,mBAAmB,EAC9B,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,aAEvC,iBAAQ,KAAK,EAAC,EAAE,8BAAuB,EACtC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACtB,kBAAqB,KAAK,EAAE,GAAG,CAAC,EAAE,aAC/B,GAAG,CAAC,EAAE,QAAI,GAAG,CAAC,KAAK,UADT,GAAG,CAAC,EAAE,CAEV,CACV,CAAC,IACK,GACL,CACP,EACD,eAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aACtC,OAAO,IAAI,CACV,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,8BAEvE,CACP,EACA,KAAK,IAAI,CAAC,OAAO,IAAI,CACpB,cACE,IAAI,EAAC,OAAO,EACZ,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,YAE3E,KAAK,GACF,CACP,EACA,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAC7C,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,4BAEvE,CACP,EACA,CAAC,OAAO;wBACP,CAAC,KAAK;wBACN,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;4BACnB,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;4BACvD,OAAO,CACL,kBAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,KAAK,EAAE;oCACL,OAAO,EAAE,MAAM;oCACf,UAAU,EAAE,QAAQ;oCACpB,GAAG,EAAE,SAAS;oCACd,KAAK,EAAE,MAAM;oCACb,OAAO,EAAE,iBAAiB;oCAC1B,UAAU,EAAE,aAAa;oCACzB,MAAM,EAAE,MAAM;oCACd,UAAU,EAAE,uBAAuB;oCACnC,MAAM,EAAE,SAAS;oCACjB,KAAK,EAAE,IAAI;oCACX,QAAQ,EAAE,SAAS;oCACnB,UAAU,EAAE,SAAS;oCACrB,SAAS,EAAE,MAAM;iCAClB,EACD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;oCACjB,CAAC,CAAC,aAAmC,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;gCACvE,CAAC,EACD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;oCACjB,CAAC,CAAC,aAAmC,CAAC,KAAK,CAAC,eAAe,GAAG,aAAa,CAAC;gCAC/E,CAAC,aAED,eACE,KAAK,EAAE;4CACL,OAAO,EAAE,cAAc;4CACvB,KAAK,EAAE,EAAE;4CACT,MAAM,EAAE,EAAE;4CACV,YAAY,EAAE,CAAC;4CACf,UAAU,EAAE,WAAW;4CACvB,MAAM,EAAE,aAAa,MAAM,EAAE;4CAC7B,UAAU,EAAE,CAAC;yCACd,GACD,EACF,eAAM,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAC1D,IAAI,CAAC,IAAI,GACL,KAtCF,IAAI,CAAC,IAAI,CAuCP,CACV,CAAC;wBACJ,CAAC,CAAC,IACA,EACN,cACE,KAAK,EAAE;oBACL,OAAO,EAAE,iBAAiB;oBAC1B,SAAS,EAAE,aAAa,MAAM,EAAE;oBAChC,KAAK,EAAE,KAAK;oBACZ,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,IAAI;iBACjB,mFAGG,IACA,CACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,GAAgD;IACtE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;IACtB,0DAA0D;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;AAClC,CAAC"}

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