@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/components/PaletteToSpotPanel.js

@@ -0,0 +1,160 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { sortMatchesByDeltaE } from "./SmartSpotMatchPanel";
+/**
+ * Pure helper — summarizes a list of conversion rows. Pure function;
+ * no I/O.
+ *
+ * @public
+ */
+export function summarizePaletteCoverage(rows) {
+    let matched = 0;
+    let sum = 0;
+    let worst = 0;
+    for (const row of rows) {
+        if (row.status === "matched" && row.bestMatch) {
+            matched++;
+            sum += row.bestMatch.deltaE;
+            if (row.bestMatch.deltaE > worst)
+                worst = row.bestMatch.deltaE;
+        }
+    }
+    return {
+        totalColors: rows.length,
+        matched,
+        unmatched: rows.length - matched,
+        averageDeltaE: matched > 0 ? sum / matched : null,
+        worstDeltaE: matched > 0 ? worst : null,
+    };
+}
+/**
+ * Stateful panel — renders the palette as a table, dispatches the
+ * host matcher per row (lazily on "Match" click or eagerly via the
+ * "Match all" affordance), and surfaces coverage metrics in the
+ * footer.
+ *
+ * @public
+ */
+export function PaletteToSpotPanel({ colors, matchLoader, onCommit, errorMessage, }) {
+    const initialRows = useMemo(() => colors.map((color) => ({ color, status: "idle" })), [colors]);
+    const [rows, setRows] = useState(initialRows);
+    // Re-seed the row state when the input palette changes.
+    useEffect(() => {
+        setRows(initialRows);
+    }, [initialRows]);
+    const matchOne = useCallback(async (color) => {
+        setRows((prev) => prev.map((r) => (r.color.id === color.id ? { ...r, status: "loading" } : r)));
+        try {
+            const matches = await matchLoader({ hex: color.hex });
+            const sorted = sortMatchesByDeltaE(matches);
+            const best = sorted[0];
+            if (!best) {
+                // Loader returned zero matches — surface as a distinct
+                // "no match found" error row rather than a confusing
+                // matched-but-empty state (which would render no match
+                // line, hide Convert, and still flip the button to
+                // "Re-match" as if a match landed).
+                setRows((prev) => prev.map((r) => r.color.id === color.id
+                    ? { color, status: "error", errorMessage: "No match found." }
+                    : r));
+                return;
+            }
+            setRows((prev) => prev.map((r) => r.color.id === color.id
+                ? {
+                    color,
+                    status: "matched",
+                    bestMatch: best,
+                    alternates: sorted,
+                }
+                : r));
+        }
+        catch (err) {
+            let message = "Couldn't fetch matches.";
+            if (errorMessage) {
+                try {
+                    const candidate = errorMessage(err);
+                    if (candidate)
+                        message = candidate;
+                }
+                catch {
+                    // fall back to default
+                }
+            }
+            setRows((prev) => prev.map((r) => r.color.id === color.id ? { color, status: "error", errorMessage: message } : r));
+        }
+    }, [matchLoader, errorMessage]);
+    const matchAll = useCallback(async () => {
+        // Skip rows that are already loading (in-flight) or already matched
+        // (no point re-paying the matcher cost — host can use the per-row
+        // "Re-match" button if they want to refresh a single entry).
+        await Promise.all(rows
+            .filter((r) => r.status !== "loading" && r.status !== "matched")
+            .map((r) => matchOne(r.color)));
+    }, [rows, matchOne]);
+    const commit = useCallback(async (row) => {
+        if (!onCommit || !row.bestMatch)
+            return;
+        try {
+            await onCommit(row.color, row.bestMatch);
+        }
+        catch (err) {
+            // Surface commit failures the same way match failures land
+            // (per-row error state). Without this branch a failed write
+            // would leave the row showing the matched state, suggesting
+            // the spot was committed when it wasn't.
+            let message = "Couldn't commit spot to registry.";
+            if (errorMessage) {
+                try {
+                    const candidate = errorMessage(err);
+                    if (candidate)
+                        message = candidate;
+                }
+                catch {
+                    // fall back to default
+                }
+            }
+            setRows((prev) => prev.map((r) => r.color.id === row.color.id
+                ? { color: row.color, status: "error", errorMessage: message }
+                : r));
+        }
+    }, [onCommit, errorMessage]);
+    const summary = useMemo(() => summarizePaletteCoverage(rows), [rows]);
+    return (_jsxs("div", { "data-testid": "palette-to-spot-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: {
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "space-between",
+                    marginBottom: "0.5rem",
+                }, children: [_jsxs("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: ["Palette \u2192 spot (", rows.length, ")"] }), _jsx("button", { type: "button", onClick: matchAll, disabled: rows.length === 0 || rows.every((r) => r.status === "loading"), style: { fontSize: "0.75rem", padding: "0.125rem 0.5rem" }, children: "Match all" })] }), rows.length === 0 ? (_jsx("div", { "data-testid": "palette-to-spot-panel-empty", style: { opacity: 0.6, fontSize: "0.875rem" }, children: "The active page has no palette colors yet." })) : (_jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: rows.map((row) => (_jsx(PaletteRow, { row: row, onMatch: () => matchOne(row.color), onCommit: onCommit ? () => commit(row) : undefined }, row.color.id))) })), _jsxs("footer", { style: {
+                    marginTop: "0.5rem",
+                    fontSize: "0.75rem",
+                    color: "#595959",
+                    borderTop: "1px solid #eee",
+                    paddingTop: "0.375rem",
+                }, children: ["Matched ", summary.matched, "/", summary.totalColors, summary.averageDeltaE !== null && (_jsxs(_Fragment, { children: [" ", "\u00B7 avg \u0394E ", summary.averageDeltaE.toFixed(2), " \u00B7 worst \u0394E", " ", (summary.worstDeltaE ?? 0).toFixed(2)] }))] })] }));
+}
+/**
+ * Renders one palette row. Intra-package helper — surface
+ * (color swatch + hex + status + match controls) is intentionally
+ * minimal so {@link PaletteToSpotPanel} can swap it without
+ * downstream consumers depending on the shape.
+ */
+function PaletteRow({ row, onMatch, onCommit, }) {
+    return (_jsxs("li", { "data-testid": `palette-to-spot-row-${row.color.id}`, style: {
+            display: "flex",
+            alignItems: "center",
+            gap: "0.5rem",
+            padding: "0.375rem 0.5rem",
+            borderBottom: "1px solid #eee",
+        }, children: [_jsx("span", { "aria-hidden": "true", style: {
+                    display: "inline-block",
+                    width: 18,
+                    height: 18,
+                    borderRadius: 3,
+                    border: "1px solid #ccc",
+                    background: row.color.hex,
+                    flexShrink: 0,
+                } }), _jsxs("div", { style: { flex: 1, fontSize: "0.8125rem" }, children: [_jsxs("div", { style: { fontWeight: 500 }, children: [row.color.name ?? row.color.hex, row.color.usageCount !== undefined && (_jsxs("span", { style: { color: "#595959", fontWeight: 400 }, children: [" \u00B7 ", row.color.usageCount, "\u00D7"] }))] }), row.status === "matched" && row.bestMatch && (_jsxs("div", { style: { fontSize: "0.75rem", color: "#595959" }, children: [row.bestMatch.spot.name, " \u00B7 \u0394E ", row.bestMatch.deltaE.toFixed(2)] })), row.status === "error" && (_jsx("div", { role: "alert", style: { fontSize: "0.75rem", color: "#a00" }, children: row.errorMessage }))] }), row.status === "loading" ? (_jsx("output", { style: { fontSize: "0.75rem", color: "#595959" }, children: "\u2026" })) : (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: onMatch, style: { fontSize: "0.6875rem", padding: "0.0625rem 0.375rem" }, children: row.status === "matched" ? "Re-match" : "Match" }), onCommit && row.status === "matched" && row.bestMatch && (_jsx("button", { type: "button", onClick: onCommit, style: { fontSize: "0.6875rem", padding: "0.0625rem 0.375rem" }, children: "Convert" }))] }))] }));
+}
+//# sourceMappingURL=PaletteToSpotPanel.js.map

package/dist/components/PaletteToSpotPanel.js.map

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

package/dist/components/PreflightAutoFixPanel.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Wave 4 AI3 — Preflight auto-fix suggestions panel.
+ *
+ * Surfaces host-loader-supplied fix suggestions next to each live
+ * preflight finding so a designer can act on a hint without leaving
+ * the editor. Typical suggestion sources: a synergy `preflight.fix`
+ * AI node, a tenant-trained model behind the host's auth, or a
+ * rules-engine that maps `ruleId` → canned remediation.
+ *
+ * Loader-adapter shape (batched: one call resolves suggestions for
+ * every visible finding) matches the rest of the Wave 4 panel family
+ * — `ComplianceFindingsPanel`, `MarkLibraryPanel`, etc. — so hosts
+ * wire one fetch per mount, not one per row.
+ *
+ * Hosts wire `onApply` to apply the `applyHint` (e.g. update a fill,
+ * adjust TAC, swap a font) — the editor stays runtime-free of the
+ * remediation logic.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import type { PreflightFinding } from "./PreflightDiffPanel";
+/**
+ * One AI / rules-engine-suggested fix for a preflight finding.
+ *
+ * `applyHint` is an opaque bag forwarded to `onApply` — its shape is
+ * a contract between the host's loader and its `onApply` handler.
+ * The panel never inspects it.
+ *
+ * @public
+ */
+export type PreflightFixSuggestion = {
+    /** Stable identifier — the panel uses it as the React key for the
+     *  suggestion row and exposes it through `onApply`. */
+    id: string;
+    /** One-line headline shown in the row (e.g. "Lower TAC by
+     *  switching rich black to B=100 K=100"). */
+    summary: string;
+    /** Optional long-form rationale rendered under the summary. */
+    description?: string;
+    /** Optional opaque bag describing the change to apply. */
+    applyHint?: Record<string, unknown>;
+};
+/**
+ * One batched loader result row — pairs a finding's stable
+ * {@link findingKey} with the suggestions the loader returned for it.
+ * Keyed (rather than indexed) so loaders can re-order findings
+ * defensively without the panel mis-pairing rows.
+ *
+ * @public
+ */
+export type PreflightFixSet = {
+    findingKey: string;
+    suggestions: readonly PreflightFixSuggestion[];
+};
+/**
+ * Host adapter — batched: the panel calls it once with every visible
+ * finding and the loader resolves a fix set per finding (or an empty
+ * set for findings the host can't help with). Hosts should memoize
+ * the function with `useCallback` so an unrelated parent re-render
+ * doesn't trigger a spurious refetch.
+ *
+ * @public
+ */
+export type PreflightFixLoaderFn = (findings: readonly PreflightFinding[]) => Promise<readonly PreflightFixSet[]>;
+/**
+ * Pure helper — derives the stable key the diff and the panel pivot
+ * findings on. Matches `PreflightDiffPanel`'s internal keying so the
+ * two panels can be wired to a shared `Set<string>` of focused
+ * findings.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export declare function findingKey(finding: PreflightFinding): string;
+/**
+ * Pure helper — flattens a {@link PreflightFixSet} list into a
+ * `Map<findingKey, suggestions>` for O(1) row lookup. Returns a fresh
+ * `Map` (safe to mutate downstream).
+ *
+ * @public
+ */
+export declare function indexFixSetsByFinding(sets: readonly PreflightFixSet[]): Map<string, readonly PreflightFixSuggestion[]>;
+/**
+ * @public
+ */
+export type PreflightAutoFixPanelProps = {
+    /** The live preflight findings the panel surfaces. Empty array →
+     *  "preflight is clean" empty state. */
+    findings: readonly PreflightFinding[];
+    /** Host adapter, see {@link PreflightFixLoaderFn}. */
+    loader: PreflightFixLoaderFn;
+    /** Fired when the user clicks "Apply" on a suggestion. The host
+     *  inspects `suggestion.applyHint` and mutates the document. */
+    onApply?: (suggestion: PreflightFixSuggestion, finding: PreflightFinding) => void;
+    /** Optional active-finding highlight — the matching row renders in
+     *  the "active" style so hosts can sync the panel selection with
+     *  the canvas / preflight banner. */
+    activeFindingKey?: string;
+};
+/**
+ * Stateful panel — loads the suggestion catalogue on mount, surfaces
+ * each finding with the matching suggestions, and emits `onApply`.
+ * Handles loading / error / empty states inline.
+ *
+ * @public
+ */
+export declare function PreflightAutoFixPanel({ findings, loader, onApply, activeFindingKey, }: PreflightAutoFixPanelProps): ReactElement;
+//# sourceMappingURL=PreflightAutoFixPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreflightAutoFixPanel.d.ts","sourceRoot":"","sources":["../../src/components/PreflightAutoFixPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;2DACuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX;iDAC6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAChD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,KAClC,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;AAEzC;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,eAAe,EAAE,GAC/B,GAAG,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAIhD;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;4CACwC;IACxC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,sDAAsD;IACtD,MAAM,EAAE,oBAAoB,CAAC;IAC7B;oEACgE;IAChE,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClF;;yCAEqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,gBAAgB,GACjB,EAAE,0BAA0B,GAAG,YAAY,CAuH3C"}

package/dist/components/PreflightAutoFixPanel.js

@@ -0,0 +1,119 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+/**
+ * Pure helper — derives the stable key the diff and the panel pivot
+ * findings on. Matches `PreflightDiffPanel`'s internal keying so the
+ * two panels can be wired to a shared `Set<string>` of focused
+ * findings.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export function findingKey(finding) {
+    return `${finding.ruleId}|${finding.severity}|${finding.pageIndex ?? "-"}`;
+}
+/**
+ * Pure helper — flattens a {@link PreflightFixSet} list into a
+ * `Map<findingKey, suggestions>` for O(1) row lookup. Returns a fresh
+ * `Map` (safe to mutate downstream).
+ *
+ * @public
+ */
+export function indexFixSetsByFinding(sets) {
+    const out = new Map();
+    for (const s of sets)
+        out.set(s.findingKey, s.suggestions);
+    return out;
+}
+/**
+ * Stateful panel — loads the suggestion catalogue on mount, surfaces
+ * each finding with the matching suggestions, and emits `onApply`.
+ * Handles loading / error / empty states inline.
+ *
+ * @public
+ */
+export function PreflightAutoFixPanel({ findings, loader, onApply, activeFindingKey, }) {
+    const [sets, setSets] = useState(null);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(false);
+    useEffect(() => {
+        let disposed = false;
+        setLoading(true);
+        setError(null);
+        setSets(null);
+        if (findings.length === 0) {
+            setLoading(false);
+            setSets([]);
+            return () => {
+                disposed = true;
+            };
+        }
+        void (async () => {
+            try {
+                const next = await loader(findings);
+                if (disposed)
+                    return;
+                setSets(next);
+            }
+            catch (err) {
+                if (disposed)
+                    return;
+                setError(err instanceof Error ? err.message : String(err));
+            }
+            finally {
+                if (!disposed)
+                    setLoading(false);
+            }
+        })();
+        return () => {
+            disposed = true;
+        };
+    }, [loader, findings]);
+    const index = useMemo(() => (sets ? indexFixSetsByFinding(sets) : null), [sets]);
+    if (loading) {
+        return (_jsx("div", { "data-testid": "preflight-autofix-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Loading suggestions\u2026" }));
+    }
+    if (error) {
+        return (_jsxs("div", { "data-testid": "preflight-autofix-panel", role: "alert", style: { padding: "0.5rem", color: "#a00" }, children: ["Couldn't load suggestions: ", error] }));
+    }
+    if (!index)
+        return _jsx("div", { "data-testid": "preflight-autofix-panel" });
+    if (findings.length === 0) {
+        return (_jsx("div", { "data-testid": "preflight-autofix-panel", style: { padding: "0.5rem", fontSize: "0.875rem", opacity: 0.6 }, children: "Preflight is clean \u2014 no findings to fix." }));
+    }
+    return (_jsxs("div", { "data-testid": "preflight-autofix-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsxs("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: ["Auto-fix (", findings.length, " finding", findings.length === 1 ? "" : "s", ")"] }) }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: findings.map((f) => {
+                    const key = findingKey(f);
+                    const suggestions = index.get(key) ?? [];
+                    const isActive = key === activeFindingKey;
+                    return (_jsxs("li", { "data-testid": `preflight-autofix-finding-${key}`, style: {
+                            marginBottom: "0.5rem",
+                            padding: "0.375rem 0.5rem",
+                            border: `1px solid ${isActive ? "#2563eb" : "#ddd"}`,
+                            borderRadius: 4,
+                            background: isActive ? "#e0ecff" : "transparent",
+                        }, children: [_jsxs("div", { style: { fontSize: "0.8125rem", fontWeight: 500 }, children: [f.ruleId, " ", _jsxs("span", { style: { color: severityColor(f.severity) }, children: ["(", f.severity, ")"] }), typeof f.pageIndex === "number" && (_jsxs("span", { style: { color: "#666" }, children: [" \u00B7 page ", f.pageIndex + 1] }))] }), suggestions.length === 0 ? (_jsx("div", { style: { fontSize: "0.75rem", color: "#666", marginTop: "0.25rem" }, children: "No suggestions available." })) : (_jsx("ul", { style: { listStyle: "none", padding: 0, margin: "0.25rem 0 0 0" }, children: suggestions.map((s) => (_jsx(PreflightAutoFixSuggestionRow, { suggestion: s, finding: f, onApply: onApply }, s.id))) }))] }, key));
+                }) })] }));
+}
+function severityColor(severity) {
+    switch (severity) {
+        case "error":
+            return "#a00";
+        case "warn":
+            return "#a60";
+        case "info":
+            return "#06a";
+    }
+}
+function PreflightAutoFixSuggestionRow({ suggestion, finding, onApply, }) {
+    return (_jsxs("li", { style: {
+            display: "flex",
+            gap: "0.5rem",
+            alignItems: "flex-start",
+            padding: "0.25rem 0",
+            borderTop: "1px dashed #eee",
+        }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: { fontSize: "0.8125rem" }, children: suggestion.summary }), suggestion.description && (_jsx("div", { style: { fontSize: "0.75rem", color: "#666", marginTop: "0.125rem" }, children: suggestion.description }))] }), onApply && (_jsx("button", { type: "button", onClick: () => onApply(suggestion, finding), style: { fontSize: "0.75rem", padding: "0.125rem 0.5rem" }, children: "Apply" }))] }));
+}
+//# sourceMappingURL=PreflightAutoFixPanel.js.map

package/dist/components/PreflightAutoFixPanel.js.map

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

package/dist/components/PreflightDiffPanel.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Wave 4 P4 — Preflight diff panel.
+ *
+ * Compares the current preflight findings against a previous
+ * {@link PreflightSnapshotInput} from the document's `preflightHistory`
+ * and surfaces what changed: which rules cleared, which are still
+ * firing, and which are new since the baseline. Lets a designer answer
+ * "did my last edit actually fix anything?" without rereading the full
+ * preflight list.
+ *
+ * Pure controlled component: hosts pass `currentFindings` (typically
+ * derived from the live preflight engine) plus the snapshot
+ * `history` (typically `DocumentV3.preflightHistory`) and optionally
+ * the `baselineSnapshotId` to compare against. Absent baseline →
+ * uses the most-recent snapshot. Hosts wire `onBaselineChange` to a
+ * dropdown to flip between historical baselines.
+ *
+ * The diff function {@link diffPreflightFindings} is exported as a
+ * pure helper so hosts can drive a custom rendering (sparkline,
+ * MIS-side audit log, etc.) over the same algorithm.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * One preflight finding — the subset of fields the diff cares about.
+ * Structurally compatible with `PreflightSnapshot.findings[number]`
+ * from `@artworkpdf/document-model`. The panel intentionally ignores
+ * rule messages / severity-detail strings: the diff is keyed by the
+ * stable (`ruleId`, `severity`, `pageIndex`) tuple so a rule
+ * downgraded from `error` → `warn` between snapshots is detected as
+ * a real change, not a no-op.
+ *
+ * @public
+ */
+export type PreflightFinding = {
+    ruleId: string;
+    severity: "error" | "warn" | "info";
+    pageIndex?: number;
+};
+/**
+ * One historical preflight snapshot. Structurally compatible with
+ * `PreflightSnapshot` from `@artworkpdf/document-model` — the panel
+ * accepts the wider doc-model shape unchanged.
+ *
+ * @public
+ */
+export type PreflightSnapshotInput = {
+    id: string;
+    timestamp: string;
+    triggeredBy: "user" | "auto" | "export";
+    findings: readonly PreflightFinding[];
+};
+/**
+ * Result of {@link diffPreflightFindings}.
+ *
+ * - `added` — findings present in `current` but not in `baseline`
+ *   (typically: regressions introduced by the latest edits).
+ * - `removed` — findings in `baseline` but not in `current`
+ *   (typically: rules cleared by the latest edits — the happy case).
+ * - `persisted` — findings present in both (the things the user
+ *   *thought* they fixed but didn't, or known-acceptable warnings).
+ *
+ * @public
+ */
+export type PreflightDiffResult = {
+    added: readonly PreflightFinding[];
+    removed: readonly PreflightFinding[];
+    persisted: readonly PreflightFinding[];
+};
+/**
+ * @public
+ */
+export type PreflightDiffPanelProps = {
+    /** Current live preflight findings. Empty array is treated as
+     *  "preflight ran and found nothing" — the panel renders an
+     *  all-green state when both `currentFindings` and the baseline's
+     *  findings are empty. */
+    currentFindings: readonly PreflightFinding[];
+    /** Snapshot history, oldest → newest. Typically
+     *  `DocumentV3.preflightHistory`. Empty array surfaces a
+     *  "no history yet — run preflight to capture the first snapshot"
+     *  hint. */
+    history: readonly PreflightSnapshotInput[];
+    /** Id of the snapshot to compare against. Absent → the latest
+     *  snapshot (`history[history.length - 1]`). */
+    baselineSnapshotId?: string;
+    /** Fired when the user picks a different baseline from the
+     *  in-panel dropdown. */
+    onBaselineChange?: (snapshotId: string) => void;
+};
+/**
+ * Compute the added / removed / persisted partition between two
+ * finding lists. Pure function — no React, no DOM.
+ *
+ * The diff is keyed by the `(ruleId, severity, pageIndex)` tuple:
+ * two findings collapse only when all three match. This catches
+ * severity downgrades (warn→error counts as a change) and
+ * per-page rule fires (same rule on different pages stays
+ * distinct) which a naive `ruleId`-only diff would mis-classify.
+ *
+ * @public
+ */
+export declare function diffPreflightFindings(baseline: readonly PreflightFinding[], current: readonly PreflightFinding[]): PreflightDiffResult;
+/**
+ * Resolve which snapshot the panel should diff against.
+ *
+ * Returns the entry in `history` whose `id` matches `baselineSnapshotId`
+ * when present; otherwise the most-recent snapshot
+ * (`history[history.length - 1]`). Returns `undefined` only when
+ * `history` is empty. Falling back when the explicit id misses keeps
+ * the panel useful after a host trims history (e.g. cap of 10
+ * snapshots) and the user's previously-saved baseline drops off the
+ * tail.
+ *
+ * Pure function; exposed so hosts that need to mirror the panel's
+ * selection in their own chrome (e.g. an MIS audit log) can call it
+ * without re-implementing the fallback rule.
+ *
+ * @public
+ */
+export declare function resolveBaselineSnapshot(history: readonly PreflightSnapshotInput[], baselineSnapshotId: string | undefined): PreflightSnapshotInput | undefined;
+/**
+ * @public
+ */
+export declare function PreflightDiffPanel({ currentFindings, history, baselineSnapshotId, onBaselineChange, }: PreflightDiffPanelProps): ReactElement;
+//# sourceMappingURL=PreflightDiffPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreflightDiffPanel.d.ts","sourceRoot":"","sources":["../../src/components/PreflightDiffPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;8BAG0B;IAC1B,eAAe,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C;;;gBAGY;IACZ,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C;oDACgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;6BACyB;IACzB,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,mBAAmB,CAerB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,sBAAsB,GAAG,SAAS,CAOpC;AAcD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,gBAAgB,GACjB,EAAE,uBAAuB,GAAG,YAAY,CA8DxC"}

package/dist/components/PreflightDiffPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreflightDiffPanel.js","sourceRoot":"","sources":["../../src/components/PreflightDiffPanel.tsx"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAmGb;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAqC,EACrC,OAAoC;IAEpC,MAAM,KAAK,GAAG,CAAC,CAAmB,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC;IAChG,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YAC7C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA0C,EAC1C,kBAAsC;IAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,kBAAkB,CAAC,CAAC;QAClE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,eAAe,GAAiD;IACpE,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,YAAY,GAAsD;IACtE,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,gBAAgB,GACQ;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CACL,6BAAiB,sBAAsB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,6FAE5E,CACP,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC9E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CACL,6BAAiB,sBAAsB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,6FAE5E,CACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC/E,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;IAEtF,OAAO,CACL,8BAAiB,sBAAsB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAClE,kBACE,KAAK,EAAE;oBACL,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,UAAU;oBACtB,GAAG,EAAE,QAAQ;oBACb,YAAY,EAAE,QAAQ;iBACvB,aAED,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,+BAAqB,EACnE,iBAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aACjD,MAAM,EACP,gCACc,yBAAyB,EACrC,KAAK,EAAE,gBAAgB,CAAC,EAAE,EAC1B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACnD,QAAQ,EAAE,gBAAgB,KAAK,SAAS,EACxC,KAAK,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAEtD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAClB,kBAAmB,KAAK,EAAE,CAAC,CAAC,EAAE,aAC3B,CAAC,CAAC,SAAS,cAAK,CAAC,CAAC,WAAW,KADnB,CAAC,CAAC,EAAE,CAER,CACV,CAAC,GACK,IACH,IACD,EACR,QAAQ,CAAC,CAAC,CAAC,CACV,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,qEAE5C,CACP,CAAC,CAAC,CAAC,CACF,8BACE,KAAC,kBAAkB,IAAC,KAAK,EAAC,SAAS,EAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAC,SAAS,GAAG,EAC7E,KAAC,kBAAkB,IAAC,KAAK,EAAC,cAAc,EAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAC,WAAW,GAAG,EACtF,KAAC,kBAAkB,IAAC,KAAK,EAAC,oBAAoB,EAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAC,OAAO,GAAG,IACnF,CACJ,IACG,CACP,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,IAAI,GAKL;IACC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,CACL,kCAAsB,wBAAwB,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,aACrF,cACE,KAAK,EAAE;oBACL,MAAM,EAAE,eAAe;oBACvB,QAAQ,EAAE,SAAS;oBACnB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;iBAC1B,aAEA,KAAK,QAAI,QAAQ,CAAC,MAAM,SACtB,EACL,aAAI,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,YACpD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBACrB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACrE,OAAO,CACL,cAEE,KAAK,EAAE;4BACL,OAAO,EAAE,MAAM;4BACf,UAAU,EAAE,UAAU;4BACtB,GAAG,EAAE,QAAQ;4BACb,OAAO,EAAE,iBAAiB;yBAC3B,aAED,8BACc,MAAM,EAClB,KAAK,EAAE;oCACL,OAAO,EAAE,cAAc;oCACvB,KAAK,EAAE,QAAQ;oCACf,MAAM,EAAE,QAAQ;oCAChB,YAAY,EAAE,KAAK;oCACnB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC;oCACvC,UAAU,EAAE,CAAC;iCACd,GACD,EACF,eAAM,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,YACrE,CAAC,CAAC,MAAM,GACJ,EACN,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAC5B,iBAAO,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAI,CAAC,CAAC,SAAS,GAAG,CAAC,IAAS,CAC3D,KAxBI,GAAG,CAyBL,CACN,CAAC;gBACJ,CAAC,CAAC,GACC,IACG,CACX,CAAC;AACJ,CAAC"}

package/dist/components/ProcessRulesPanel.d.ts

@@ -0,0 +1,81 @@
+/**
+ * One process-specific preflight finding — mirrors lint-pdf's
+ * `Finding` wire shape with an explicit `process` discriminator the
+ * panel groups by. Duplicated here so the editor stays consumable
+ * without the lint-pdf SDK (same pattern as `ComplianceFinding`).
+ *
+ * @public
+ */
+export type ProcessRule = {
+    ruleId: string;
+    severity: "error" | "warn" | "info";
+    message: string;
+    /** The process class this rule fires under — matches the
+     *  `process_is` matcher in lint-pdf's conditional rule engine. */
+    process: string;
+    /** 0-indexed page reference, if the finding is scoped to one. */
+    pageIndex?: number;
+    /** Optional id of the offending object on `pageIndex`. */
+    objectId?: string;
+};
+/**
+ * Host-supplied adapter. Receives the document + active process and
+ * returns the process-physics findings. Rejects on transport errors;
+ * the panel surfaces the message inline.
+ *
+ * **Identity matters.** The panel re-fetches whenever the `loader`
+ * reference changes — hosts that build the adapter inline should
+ * memoize it with `useCallback` so an unrelated parent re-render
+ * doesn't trigger a spurious round-trip.
+ *
+ * @public
+ */
+export type ProcessRulesLoaderFn = (input: {
+    documentB64: string;
+    process: string;
+}) => Promise<readonly ProcessRule[]>;
+/**
+ * Result row from {@link groupRulesByProcess}. The panel renders one
+ * heading per group when `groupByProcess` is set.
+ *
+ * @public
+ */
+export type ProcessRuleGroup = {
+    process: string;
+    rules: readonly ProcessRule[];
+};
+/**
+ * @public
+ */
+export type ProcessRulesPanelProps = {
+    /** Latest rendered document — base64 PDF or `undefined` for an
+     *  "export first" affordance. */
+    documentB64: string | undefined;
+    /** Active process class from `PrintContext.process`. Drives the
+     *  `process_is` matcher in lint-pdf's conditional rule engine. */
+    process: string | undefined;
+    /** Adapter that resolves to the process-physics findings. */
+    loader: ProcessRulesLoaderFn;
+    /** Optional callback fired when a finding row is clicked — hosts
+     *  wire this to highlight the offending object on canvas. */
+    onSelect?: (rule: ProcessRule) => void;
+    /** When `true`, the panel renders one collapsible group per
+     *  process class (useful when the loader is allowed to surface
+     *  findings for *adjacent* processes — e.g. an offset job with
+     *  flexo-compatible warnings for downstream re-printing). Absent
+     *  or `false`: flat list. */
+    groupByProcess?: boolean;
+};
+/**
+ * Group a flat list of findings by `process` key in first-occurrence
+ * order. Pure function; exposed for hosts that want their own
+ * rendering on top of the same grouping.
+ *
+ * @public
+ */
+export declare function groupRulesByProcess(rules: readonly ProcessRule[]): readonly ProcessRuleGroup[];
+/**
+ * @public
+ */
+export declare function ProcessRulesPanel({ documentB64, process, loader, onSelect, groupByProcess, }: ProcessRulesPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ProcessRulesPanel.d.ts.map