@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessRulesPanel.d.ts","sourceRoot":"","sources":["../../src/components/ProcessRulesPanel.tsx"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB;sEACkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,KAAK,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;qCACiC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;sEACkE;IAClE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,oBAAoB,CAAC;IAC7B;iEAC6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC;;;;iCAI6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAa9F;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,WAAW,EACX,OAAO,EACP,MAAM,EACN,QAAQ,EACR,cAAc,GACf,EAAE,sBAAsB,2CA+FxB"}

package/dist/components/ProcessRulesPanel.js

@@ -0,0 +1,143 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Wave 4 P2 — Process-specific preflight panel.
+ *
+ * Surfaces process-physics findings — flexo white-knockout, gravure
+ * max line frequency, screen-print halftone limits, offset overprint
+ * traps — separately from generic preflight (which covers
+ * "does this PDF parse / render") and from {@link ComplianceFindingsPanel}
+ * (which covers "is this artwork *allowed* on the chosen substrate /
+ * market"). The three-way split keeps the audiences focused: a press
+ * operator wants the physics, a brand lead wants the compliance, a
+ * support engineer wants the parse errors.
+ *
+ * Adapter pattern: hosts wire an async function that POSTs the
+ * document + active process to lint-pdf's `/v1/preflight/process`
+ * endpoint and filters to process-physics rules. The editor stays
+ * free of any runtime dep on lint-pdf's HTTP client; same approach
+ * as {@link ComplianceFindingsPanel}, {@link InksPanel}, etc.
+ *
+ * @public
+ */
+import { useEffect, useState } from "react";
+/**
+ * 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 function groupRulesByProcess(rules) {
+    const order = [];
+    const buckets = new Map();
+    for (const r of rules) {
+        let bucket = buckets.get(r.process);
+        if (!bucket) {
+            bucket = [];
+            buckets.set(r.process, bucket);
+            order.push(r.process);
+        }
+        bucket.push(r);
+    }
+    return order.map((process) => ({ process, rules: buckets.get(process) ?? [] }));
+}
+const SEVERITY_COLORS = {
+    error: "#a00",
+    warn: "#a60",
+    info: "#06a",
+};
+/**
+ * @public
+ */
+export function ProcessRulesPanel({ documentB64, process, loader, onSelect, groupByProcess, }) {
+    const [rules, setRules] = useState(null);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(false);
+    useEffect(() => {
+        if (!documentB64 || !process) {
+            setRules(null);
+            setError(null);
+            return;
+        }
+        let disposed = false;
+        setLoading(true);
+        setError(null);
+        // Clear stale findings while the next fetch is in flight — if a
+        // caller ever bypasses the `loading` guard, we don't want the
+        // previous process's rules to flash through.
+        setRules(null);
+        // Wrap in an async IIFE so a *synchronous* throw from the adapter
+        // (e.g. a host validating inputs before constructing fetch) flows
+        // through the same `setError` path as a rejected Promise.
+        void (async () => {
+            try {
+                const next = await loader({ documentB64, process });
+                if (disposed)
+                    return;
+                setRules(next);
+            }
+            catch (err) {
+                if (disposed)
+                    return;
+                setError(err instanceof Error ? err.message : String(err));
+            }
+            finally {
+                if (!disposed)
+                    setLoading(false);
+            }
+        })();
+        return () => {
+            disposed = true;
+        };
+    }, [documentB64, process, loader]);
+    if (!documentB64 || !process) {
+        return (_jsx("div", { "data-testid": "process-rules-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Set process in Job Setup, then export to see process-specific findings." }));
+    }
+    if (loading) {
+        return (_jsx("div", { "data-testid": "process-rules-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Checking process rules\u2026" }));
+    }
+    if (error) {
+        return (_jsxs("div", { "data-testid": "process-rules-panel", role: "alert", style: { padding: "0.5rem", color: "#a00" }, children: ["Couldn't load process rules: ", error] }));
+    }
+    if (!rules || rules.length === 0) {
+        return (_jsxs("div", { "data-testid": "process-rules-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: ["No process-specific issues for ", process, "."] }));
+    }
+    const groups = groupByProcess ? groupRulesByProcess(rules) : null;
+    return (_jsxs("div", { "data-testid": "process-rules-panel", style: { padding: "0.5rem" }, children: [_jsxs("h3", { style: { margin: "0 0 0.5rem 0" }, children: ["Process rules (", rules.length, ")"] }), groups ? (groups.map((g) => (_jsxs("section", { style: { marginBottom: "0.75rem" }, children: [_jsxs("h4", { style: {
+                            margin: "0 0 0.25rem 0",
+                            fontSize: "0.875rem",
+                            textTransform: "capitalize",
+                        }, children: [g.process, " (", g.rules.length, ")"] }), _jsx(ProcessRulesList, { rules: g.rules, onSelect: onSelect })] }, g.process)))) : (_jsx(ProcessRulesList, { rules: rules, onSelect: onSelect }))] }));
+}
+function ProcessRulesList({ rules, onSelect, }) {
+    return (_jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: rules.map((r, i) => {
+            // Append the array index so duplicate (ruleId, pageIndex,
+            // objectId, process) tuples still get unique React keys.
+            const key = `${r.ruleId}-${r.process}-${r.pageIndex ?? "doc"}-${r.objectId ?? ""}-${i}`;
+            const rowContents = (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": "true", style: {
+                            display: "inline-block",
+                            width: "0.5rem",
+                            height: "0.5rem",
+                            borderRadius: "50%",
+                            background: SEVERITY_COLORS[r.severity],
+                            flexShrink: 0,
+                        } }), _jsx("span", { style: { flex: 1 }, children: r.message }), _jsxs("small", { style: { opacity: 0.6, fontFamily: "monospace" }, children: [r.ruleId, r.pageIndex !== undefined ? ` · p${r.pageIndex + 1}` : ""] })] }));
+            const rowStyle = {
+                display: "flex",
+                alignItems: "baseline",
+                gap: "0.5rem",
+                width: "100%",
+                padding: "0.25rem 0.5rem",
+            };
+            return (_jsx("li", { children: onSelect ? (_jsx("button", { type: "button", onClick: () => onSelect(r), "aria-label": `Process rule: ${r.message} (${r.ruleId}${r.pageIndex !== undefined ? `, page ${r.pageIndex + 1}` : ""})`, style: {
+                        ...rowStyle,
+                        background: "transparent",
+                        border: "none",
+                        cursor: "pointer",
+                        textAlign: "left",
+                    }, children: rowContents })) : (_jsx("div", { style: rowStyle, children: rowContents })) }, key));
+        }) }));
+}
+//# sourceMappingURL=ProcessRulesPanel.js.map

package/dist/components/ProcessRulesPanel.js.map

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