@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.3.0

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

package/dist/components/SlackNotifyPanel.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Wave 4 I3 — Slack-notify panel.
+ *
+ * A small panel that lets the user emit a Slack notification keyed
+ * to a typed editor event (preflight cleared, job submitted, variant
+ * approved, …). The panel handles the UI; the actual webhook POST
+ * is host-wired via a {@link SlackNotifyFn} adapter so the editor
+ * stays runtime-free of any Slack SDK / fetch wrapper.
+ *
+ * Pairs with the synergy `slack.notify` workflow node when one is
+ * deployed — the host typically wires `notify` to that node so the
+ * webhook URL stays server-side. Hosts without a synergy bridge can
+ * also POST straight to a Slack incoming-webhook URL from their own
+ * client code; the adapter shape is intentionally agnostic.
+ *
+ * Designed around the same loader/adapter pattern as
+ * {@link MisEstimateButton}, {@link SwatchesPicker}, etc.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * The set of editor events that map to canonical Slack message
+ * templates. `"custom"` is the escape hatch — when the user wants to
+ * send a free-form message that isn't tied to an event,
+ * {@link composeSlackMessage} renders just `context.text` and ignores
+ * the rest of the context.
+ *
+ * @public
+ */
+export type SlackNotificationEventKind = "preflight-blocked" | "preflight-cleared" | "job-submitted" | "variant-approved" | "approval-requested" | "custom";
+/**
+ * Context passed to {@link composeSlackMessage}. Most fields are
+ * optional and only render when the chosen event template references
+ * them — e.g. `findingCount` is consulted by `"preflight-blocked"` and
+ * `"preflight-cleared"` and ignored otherwise.
+ *
+ * @public
+ */
+export type SlackNotificationContext = {
+    /** Human-readable document name surfaced as the message subject. */
+    documentName?: string;
+    /** Stable identifier the host uses to link back to the document. */
+    documentId?: string;
+    /** Optional clickable URL — Slack renders this as a link below the
+     *  subject line so reviewers can jump straight into the editor. */
+    documentUrl?: string;
+    /** Preflight finding count (errors only for `"preflight-blocked"`,
+     *  total resolved for `"preflight-cleared"`). */
+    findingCount?: number;
+    /** Variant id for `"variant-approved"`. */
+    variantId?: string;
+    /** Reviewer / submitter display name surfaced as the message
+     *  byline. */
+    actor?: string;
+    /** Free-form additional text appended to the canonical template
+     *  (or, for `"custom"`, used as the entire body). */
+    text?: string;
+};
+/**
+ * Canonical Slack incoming-webhook payload shape (subset: only the
+ * fields the panel emits). Hosts that need richer payloads (`blocks`,
+ * `attachments`, threading) wrap their own adapter that augments the
+ * panel output before POSTing.
+ *
+ * @public
+ */
+export type SlackNotificationPayload = {
+    /** Optional channel override (e.g. `"#preflight"`). When absent the
+     *  host's webhook URL determines the channel. */
+    channel?: string;
+    /** Message text. Slack's webhook treats this as the fallback /
+     *  notification text and the main body when no `blocks` are
+     *  supplied. */
+    text: string;
+};
+/**
+ * Pure helper — renders a {@link SlackNotificationContext} into a
+ * canonical Slack message payload. The mapping is intentionally
+ * simple (one short line per event template) so hosts that want
+ * richer messages can post-process the output. Pure function; no I/O.
+ *
+ * `"custom"` returns `context.text` verbatim (or a placeholder when
+ * empty) — the helper never silently drops the message.
+ *
+ * @public
+ */
+export declare function composeSlackMessage(kind: SlackNotificationEventKind, context: SlackNotificationContext): SlackNotificationPayload;
+/**
+ * Host adapter — POSTs the composed payload to Slack (typically via
+ * a server-side proxy or the synergy `slack.notify` node). Resolves
+ * on accept; rejects on transport / validation errors and the panel
+ * surfaces the message inline.
+ *
+ * @public
+ */
+export type SlackNotifyFn = (payload: SlackNotificationPayload) => Promise<void>;
+/**
+ * Human-readable labels for each event kind, in the order they
+ * appear in the dropdown. Exported so hosts that re-use the picker
+ * shape (e.g. in a settings page) stay in lockstep with the panel.
+ *
+ * @public
+ */
+export declare const SLACK_NOTIFICATION_EVENT_LABELS: Readonly<Record<SlackNotificationEventKind, string>>;
+/**
+ * @public
+ */
+export type SlackNotifyPanelProps = {
+    /** Host adapter, see {@link SlackNotifyFn}. */
+    notify: SlackNotifyFn;
+    /** Context the panel renders into the chosen event template. The
+     *  host typically wires this to the active document. */
+    context: SlackNotificationContext;
+    /** Optional initial event selection. Defaults to
+     *  `"preflight-blocked"` — the most common trigger. */
+    defaultEvent?: SlackNotificationEventKind;
+    /** Optional channel override. When absent, the panel's "Channel"
+     *  input is empty and the host's webhook URL decides routing. */
+    defaultChannel?: string;
+    /** Optional mapper that turns a notify error into a user-facing
+     *  message. The default avoids leaking internal `Error.message`
+     *  strings; hosts that want richer surfaces (e.g. validation-error
+     *  toasts) pass their own mapper. The original error is still
+     *  passed in so hosts can log it. */
+    errorMessage?: (err: unknown) => string;
+    /** Optional callback fired on successful notify so the host can
+     *  show a confirmation toast / log analytics. */
+    onSuccess?: (payload: SlackNotificationPayload) => void;
+};
+/**
+ * Stateful panel — picks an event template, lets the user override
+ * channel + append a custom note, composes the payload via
+ * {@link composeSlackMessage}, and POSTs through the host adapter.
+ *
+ * @public
+ */
+export declare function SlackNotifyPanel({ notify, context, defaultEvent, defaultChannel, errorMessage, onSuccess, }: SlackNotifyPanelProps): ReactElement;
+//# sourceMappingURL=SlackNotifyPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SlackNotifyPanel.d.ts","sourceRoot":"","sources":["../../src/components/SlackNotifyPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAClC,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,QAAQ,CAAC;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uEACmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;qDACiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;kBACc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;yDACqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;qDACiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;oBAEgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAyC1B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAQ9F,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,+CAA+C;IAC/C,MAAM,EAAE,aAAa,CAAC;IACtB;4DACwD;IACxD,OAAO,EAAE,wBAAwB,CAAC;IAClC;2DACuD;IACvD,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C;qEACiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;yCAIqC;IACrC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC;qDACiD;IACjD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,GACV,EAAE,qBAAqB,GAAG,YAAY,CAuHtC"}

package/dist/components/SlackNotifyPanel.js

@@ -0,0 +1,133 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+/**
+ * Pure helper — renders a {@link SlackNotificationContext} into a
+ * canonical Slack message payload. The mapping is intentionally
+ * simple (one short line per event template) so hosts that want
+ * richer messages can post-process the output. Pure function; no I/O.
+ *
+ * `"custom"` returns `context.text` verbatim (or a placeholder when
+ * empty) — the helper never silently drops the message.
+ *
+ * @public
+ */
+export function composeSlackMessage(kind, context) {
+    const subject = context.documentName ?? context.documentId ?? "an artwork document";
+    const actor = context.actor ? ` by ${context.actor}` : "";
+    const link = context.documentUrl ? ` <${context.documentUrl}|open>` : "";
+    const trailer = context.text ? ` — ${context.text}` : "";
+    switch (kind) {
+        case "preflight-blocked": {
+            // Treat undefined / unknown counts as "no number to show" rather
+            // than "0" — "Preflight blocked: 0 findings" reads as a
+            // contradiction even though it's how a number-less template
+            // would default.
+            const n = context.findingCount;
+            const findingsFragment = typeof n === "number" ? `: ${n} finding${n === 1 ? "" : "s"}` : "";
+            return {
+                text: `Preflight blocked on ${subject}${actor}${findingsFragment}${link}${trailer}`,
+            };
+        }
+        case "preflight-cleared":
+            return {
+                text: `Preflight cleared on ${subject}${actor}${link}${trailer}`,
+            };
+        case "job-submitted":
+            return {
+                text: `Job submitted for ${subject}${actor}${link}${trailer}`,
+            };
+        case "variant-approved": {
+            const v = context.variantId ? ` (${context.variantId})` : "";
+            return {
+                text: `Variant approved on ${subject}${v}${actor}${link}${trailer}`,
+            };
+        }
+        case "approval-requested":
+            return {
+                text: `Approval requested on ${subject}${actor}${link}${trailer}`,
+            };
+        case "custom":
+            return {
+                text: context.text?.trim() ? context.text : `Update on ${subject}${actor}${link}`,
+            };
+    }
+}
+/**
+ * Human-readable labels for each event kind, in the order they
+ * appear in the dropdown. Exported so hosts that re-use the picker
+ * shape (e.g. in a settings page) stay in lockstep with the panel.
+ *
+ * @public
+ */
+export const SLACK_NOTIFICATION_EVENT_LABELS = {
+    "preflight-blocked": "Preflight blocked",
+    "preflight-cleared": "Preflight cleared",
+    "job-submitted": "Job submitted",
+    "variant-approved": "Variant approved",
+    "approval-requested": "Approval requested",
+    custom: "Custom message",
+};
+/**
+ * Stateful panel — picks an event template, lets the user override
+ * channel + append a custom note, composes the payload via
+ * {@link composeSlackMessage}, and POSTs through the host adapter.
+ *
+ * @public
+ */
+export function SlackNotifyPanel({ notify, context, defaultEvent, defaultChannel, errorMessage, onSuccess, }) {
+    const [event, setEvent] = useState(defaultEvent ?? "preflight-blocked");
+    const [channel, setChannel] = useState(defaultChannel ?? "");
+    const [note, setNote] = useState("");
+    const [state, setState] = useState({ kind: "idle" });
+    // Clear the success / error chip when the user edits any input —
+    // a "Sent" indicator next to an unsent payload reads as a lie. The
+    // wrapper keeps the original setter ergonomic at every call site.
+    const resetOutcome = () => {
+        setState((prev) => (prev.kind === "ok" || prev.kind === "error" ? { kind: "idle" } : prev));
+    };
+    const onClick = async () => {
+        setState({ kind: "sending" });
+        const composed = composeSlackMessage(event, {
+            ...context,
+            ...(note.trim() && { text: note }),
+        });
+        const payload = {
+            ...composed,
+            ...(channel.trim() && { channel: channel.trim() }),
+        };
+        try {
+            await notify(payload);
+            setState({ kind: "ok" });
+            onSuccess?.(payload);
+        }
+        catch (err) {
+            // Guard against a host-supplied errorMessage that throws (e.g.
+            // makes assumptions about `err`'s shape) — without the inner
+            // try/catch the panel would silently swallow the failure and
+            // never enter the `error` state.
+            let message = "Couldn't send Slack notification.";
+            if (errorMessage) {
+                try {
+                    message = errorMessage(err);
+                }
+                catch {
+                    // fall back to the default message
+                }
+            }
+            setState({ kind: "error", message });
+        }
+    };
+    return (_jsxs("div", { "data-testid": "slack-notify-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Slack notify" }) }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Event", _jsx("select", { "aria-label": "Event", value: event, onChange: (e) => {
+                            setEvent(e.target.value);
+                            resetOutcome();
+                        }, style: { display: "block", marginTop: "0.125rem", width: "100%" }, children: Object.entries(SLACK_NOTIFICATION_EVENT_LABELS).map(([k, label]) => (_jsx("option", { value: k, children: label }, k))) })] }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Channel", _jsx("input", { type: "text", "aria-label": "Channel", placeholder: "#preflight (optional)", value: channel, onChange: (e) => {
+                            setChannel(e.target.value);
+                            resetOutcome();
+                        }, style: { display: "block", marginTop: "0.125rem", width: "100%" } })] }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Note", _jsx("textarea", { "aria-label": "Note", placeholder: "Optional \u2014 appended to the message", value: note, onChange: (e) => {
+                            setNote(e.target.value);
+                            resetOutcome();
+                        }, rows: 2, style: { display: "block", marginTop: "0.125rem", width: "100%" } })] }), _jsxs("div", { style: { display: "flex", gap: "0.5rem", alignItems: "center" }, children: [_jsx("button", { type: "button", onClick: onClick, disabled: state.kind === "sending", "aria-busy": state.kind === "sending", children: state.kind === "sending" ? "Sending…" : "Notify Slack" }), state.kind === "ok" && (_jsx("output", { style: { color: "#080", fontSize: "0.75rem" }, children: "Sent" })), state.kind === "error" && (_jsx("span", { role: "alert", style: { color: "#a00", fontSize: "0.75rem" }, children: state.message }))] })] }));
+}
+//# sourceMappingURL=SlackNotifyPanel.js.map

package/dist/components/SlackNotifyPanel.js.map

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

package/dist/components/SmartSpotMatchPanel.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Wave 4 AI2 — Smart spot-match panel.
+ *
+ * Resolves a user-picked CMYK / Lab / hex color to a ranked list of
+ * nearest-PANTONE candidates via a host-supplied loader (typically
+ * fronting compile-pdf's `/v1/spots/match` endpoint or a tenant-local
+ * ΔE engine). Each match carries the canonical {@link Spot} entry +
+ * its ΔE distance from the query so the picker can render
+ * "good / borderline / poor" cues without the editor doing color
+ * math itself.
+ *
+ * Sibling of {@link SwatchesPicker} — that one searches the PANTONE
+ * catalogue by name, this one searches it by color value. Pairs with
+ * the AI4 `registerSpot` flow (Wave 1) — clicking a match feeds the
+ * selected `Spot` into the host's separations registry.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import type { Spot } from "./SwatchesPicker";
+/**
+ * One color-space query the loader recognizes. At least one of
+ * `cmyk` / `lab` / `hex` must be present. The host's loader picks
+ * the most accurate space available (Lab > CMYK > hex) when more
+ * than one is supplied.
+ *
+ * @public
+ */
+export type SpotMatchQuery = {
+    /** Percent CMYK in `[0, 100]` per channel. */
+    cmyk?: readonly [number, number, number, number];
+    /** CIE Lab — L in `[0, 100]`, a/b roughly `[-128, 128]`. */
+    lab?: readonly [number, number, number];
+    /** 7-char sRGB hex including the leading `#` (e.g. `"#ff5102"`). */
+    hex?: string;
+    /** Optional cap on the number of returned matches; loaders that
+     *  ignore it must still return a stable ordering. */
+    limit?: number;
+};
+/**
+ * One ranked match — the canonical PANTONE entry + its ΔE distance
+ * from the query. The panel sorts matches ascending on `deltaE`
+ * (best first) via {@link sortMatchesByDeltaE}.
+ *
+ * @public
+ */
+export type SpotMatch = {
+    spot: Spot;
+    /** CIE ΔE distance. Smaller is better; under ~1 is "imperceptible",
+     *  1–3 is "noticeable", >5 is "poor". */
+    deltaE: number;
+};
+/**
+ * Host adapter — resolves a {@link SpotMatchQuery} to a ranked list
+ * of {@link SpotMatch} candidates. Rejects on transport / validation
+ * errors and the panel surfaces the message inline. Hosts should
+ * memoize the function with `useCallback` so an unrelated parent
+ * re-render doesn't trigger a spurious refetch.
+ *
+ * @public
+ */
+export type SpotMatchLoaderFn = (query: SpotMatchQuery) => Promise<readonly SpotMatch[]>;
+/**
+ * Configuration for the {@link SmartSpotMatchPanel}. The host always
+ * supplies the {@link SpotMatchLoaderFn}; the other three props are
+ * optional and shape the panel's initial state and selection
+ * behaviour. Hosts that want to drive the query from outside the
+ * panel (e.g. wire the active fill colour straight in) flow that
+ * through `initialQuery`; the panel re-derives its query whenever
+ * `initialQuery`'s content changes.
+ *
+ * @public
+ */
+export type SmartSpotMatchPanelProps = {
+    /** Host adapter, see {@link SpotMatchLoaderFn}. */
+    loader: SpotMatchLoaderFn;
+    /** Optional initial query — pre-fills the form. Hosts wire this to
+     *  the active object's fill / stroke color when the user opens the
+     *  panel from a swatch chip. */
+    initialQuery?: SpotMatchQuery;
+    /** Optional cap on returned matches. Defaults to 12 — enough to
+     *  cover the standard `5 ΔE` neighborhood without overwhelming the
+     *  scroll surface. */
+    limit?: number;
+    /** Click callback. Receives the full {@link SpotMatch} so hosts
+     *  can wire it into a separations registry / fill picker. */
+    onSelect?: (match: SpotMatch) => void;
+};
+/**
+ * Pure helper — sorts a `SpotMatch` list ascending on `deltaE`
+ * (best-first). Stable on ties: input order preserved. Returns a
+ * new array.
+ *
+ * @public
+ */
+export declare function sortMatchesByDeltaE(matches: readonly SpotMatch[]): readonly SpotMatch[];
+/**
+ * Pure helper — classifies a ΔE distance into the conventional
+ * print-industry quality band so renderers can color-code matches
+ * consistently. Thresholds are the standard CIE-1994 perceptual cut
+ * points; the panel uses them for the result-row severity chip.
+ *
+ * @public
+ */
+export type DeltaEQuality = "imperceptible" | "noticeable" | "fair" | "poor";
+/**
+ * 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 declare function deltaEQuality(deltaE: number): DeltaEQuality;
+/**
+ * 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 declare function formatDeltaE(deltaE: number): string;
+/**
+ * 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 declare function isQueryReady(query: SpotMatchQuery): boolean;
+/**
+ * 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 declare function SmartSpotMatchPanel({ loader, initialQuery, limit, onSelect, }: SmartSpotMatchPanelProps): ReactElement;
+//# sourceMappingURL=SmartSpotMatchPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SmartSpotMatchPanel.d.ts","sourceRoot":"","sources":["../../src/components/SmartSpotMatchPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,4DAA4D;IAC5D,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;yDACqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,IAAI,CAAC;IACX;6CACyC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;AAEzF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;oCAEgC;IAChC,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B;;0BAEsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;iEAC6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,SAAS,EAAE,CAKvF;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAM3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE3D;AASD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,EAAE,wBAAwB,GAAG,YAAY,CAqGzC"}