@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.3.0

package/dist/components/VariantMatrixVersionPanel.js

@@ -0,0 +1,162 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo } from "react";
+/**
+ * Resolve which snapshot the panel should pull from `history`.
+ *
+ * Behaviour matches `PreflightDiffPanel.resolveBaselineSnapshot`:
+ * an explicit version wins when found, else falls back to the
+ * most-recent snapshot. Returns `undefined` only when `history` is
+ * empty. Falling back keeps the panel useful after a host trims
+ * history below the user's saved selection.
+ *
+ * Pure function; exposed for hosts that mirror the panel's
+ * selection in their own chrome.
+ *
+ * @public
+ */
+export function resolveSnapshot(history, version) {
+    if (history.length === 0)
+        return undefined;
+    if (version !== undefined) {
+        const explicit = history.find((s) => s.version === version);
+        if (explicit)
+            return explicit;
+    }
+    return history[history.length - 1];
+}
+/**
+ * Compute the variant-row + token-column diff between two matrices.
+ *
+ * Variants are matched by `id`; the human-readable `name` and token
+ * `overrides` are compared per-id. Token keys are diffed as sets
+ * (order-insensitive). Pure function — no React, no DOM.
+ *
+ * @public
+ */
+export function diffVariantMatrices(baseline, current) {
+    const baselineById = new Map(baseline.variants.map((v) => [v.id, v]));
+    const currentById = new Map(current.variants.map((v) => [v.id, v]));
+    const addedVariants = [];
+    const removedVariants = [];
+    const modifiedVariants = [];
+    for (const v of current.variants) {
+        const prior = baselineById.get(v.id);
+        if (!prior) {
+            addedVariants.push(v);
+            continue;
+        }
+        const changedTokens = diffOverrideKeys(prior.overrides, v.overrides);
+        const nameChanged = prior.name !== v.name;
+        if (changedTokens.length > 0 || nameChanged) {
+            modifiedVariants.push({
+                id: v.id,
+                name: v.name,
+                changedTokens,
+                nameChanged,
+            });
+        }
+    }
+    for (const v of baseline.variants) {
+        if (!currentById.has(v.id))
+            removedVariants.push(v);
+    }
+    const baselineTokens = new Set(baseline.tokenKeys);
+    const currentTokens = new Set(current.tokenKeys);
+    const addedTokenKeys = current.tokenKeys.filter((k) => !baselineTokens.has(k));
+    const removedTokenKeys = baseline.tokenKeys.filter((k) => !currentTokens.has(k));
+    return { addedVariants, removedVariants, modifiedVariants, addedTokenKeys, removedTokenKeys };
+}
+/**
+ * Diff two override maps and return the set of keys whose value
+ * differs. Keys present in only one side count as changed (the
+ * other side resolves to undefined). Uses `Object.hasOwn` so
+ * inherited properties don't sneak in.
+ */
+function diffOverrideKeys(prior, next) {
+    const keys = new Set();
+    for (const k of Object.keys(prior))
+        keys.add(k);
+    for (const k of Object.keys(next))
+        keys.add(k);
+    const changed = [];
+    for (const k of keys) {
+        const a = Object.hasOwn(prior, k) ? prior[k] : undefined;
+        const b = Object.hasOwn(next, k) ? next[k] : undefined;
+        if (a !== b)
+            changed.push(k);
+    }
+    return changed.sort();
+}
+const COLORS = {
+    added: "#070",
+    removed: "#a00",
+    modified: "#a60",
+    tokenChange: "#06a",
+};
+/**
+ * Read-only viewer for a versioned variant matrix history. Picks
+ * a baseline + current version (dropdowns) and renders a per-row
+ * diff plus a token-column diff.
+ *
+ * @public
+ */
+export function VariantMatrixVersionPanel({ history, baselineVersion, currentVersion, onBaselineChange, onCurrentChange, }) {
+    // All hooks must run before any conditional return — toggling
+    // `history` between empty and non-empty across renders would
+    // otherwise change the hook count and trip
+    // "Rendered fewer hooks than expected". The helpers tolerate
+    // empty input (`resolveSnapshot` returns undefined,
+    // `history[0]?.version` is undefined) so the work is cheap on
+    // the empty path.
+    const resolvedCurrent = resolveSnapshot(history, currentVersion);
+    // Default baseline = the version *before* current; lets the panel
+    // open with the most useful comparison ("what changed in the last
+    // edit?") without the host wiring two selectors.
+    const defaultBaselineVersion = history.length >= 2 ? history[history.length - 2]?.version : history[0]?.version;
+    const resolvedBaseline = resolveSnapshot(history, baselineVersion ?? defaultBaselineVersion);
+    const diff = useMemo(() => resolvedBaseline && resolvedCurrent
+        ? diffVariantMatrices(resolvedBaseline.matrix, resolvedCurrent.matrix)
+        : null, [resolvedBaseline, resolvedCurrent]);
+    if (history.length === 0) {
+        return (_jsx("div", { "data-testid": "variant-matrix-version-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "No matrix history yet \u2014 save the matrix to capture the first version." }));
+    }
+    return (_jsxs("div", { "data-testid": "variant-matrix-version-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: {
+                    display: "flex",
+                    alignItems: "baseline",
+                    gap: "0.5rem",
+                    marginBottom: "0.5rem",
+                }, children: [_jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Variant matrix diff" }), _jsx(VersionPicker, { dataTestId: "variant-matrix-baseline", label: "vs.", value: resolvedBaseline?.version ?? "", history: history, onChange: onBaselineChange }), _jsx(VersionPicker, { dataTestId: "variant-matrix-current", label: "\u2192", value: resolvedCurrent?.version ?? "", history: history, onChange: onCurrentChange })] }), diff && (_jsxs(_Fragment, { children: [_jsx(DiffSection, { label: "Added variants", color: COLORS.added, entries: diff.addedVariants.map((v) => v.name) }), _jsx(DiffSection, { label: "Removed variants", color: COLORS.removed, entries: diff.removedVariants.map((v) => v.name) }), _jsx(DiffSection, { label: "Modified variants", color: COLORS.modified, entries: diff.modifiedVariants.map((v) => v.changedTokens.length > 0
+                            ? `${v.name} (${v.changedTokens.join(", ")}${v.nameChanged ? "; renamed" : ""})`
+                            : `${v.name} (renamed)`) }), _jsx(DiffSection, { label: "Added token columns", color: COLORS.tokenChange, entries: [...diff.addedTokenKeys] }), _jsx(DiffSection, { label: "Removed token columns", color: COLORS.tokenChange, entries: [...diff.removedTokenKeys] })] }))] }));
+}
+/**
+ * One-row section of the diff viewer. Renders only when `entries`
+ * is non-empty, so an unchanged comparison shows nothing — keeps
+ * the panel quiet when there's nothing to say.
+ *
+ * Intra-package helper.
+ */
+function DiffSection({ label, color, entries, }) {
+    if (entries.length === 0)
+        return null;
+    return (_jsxs("section", { style: { marginBottom: "0.5rem" }, children: [_jsxs("h4", { style: { margin: "0 0 0.25rem 0", fontSize: "0.75rem", color }, children: [label, " (", entries.length, ")"] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: entries.map((entry, i) => (
+                // Composite key — two variants can legitimately share a
+                // name (the id is what disambiguates), and a token-column
+                // name can repeat across kind buckets. Including the index
+                // keeps React's reconciliation correct without exposing
+                // the internal ids in the rendered output.
+                _jsx("li", { style: { padding: "0.125rem 0.5rem", fontSize: "0.8125rem" }, children: entry }, `${label}-${i}-${entry}`))) })] }));
+}
+/**
+ * Version dropdown used twice in the header (baseline + current).
+ * Disabled state covers the read-only case where the host hasn't
+ * wired a setter.
+ *
+ * Intra-package helper.
+ */
+function VersionPicker({ dataTestId, label, value, history, onChange, }) {
+    return (_jsxs("label", { style: { fontSize: "0.75rem", color: "#666" }, children: [`${label} `, _jsx("select", { "data-testid": dataTestId, value: value, onChange: (e) => onChange?.(e.target.value), disabled: onChange === undefined, style: { fontFamily: "monospace", fontSize: "0.75rem" }, children: history.map((s) => (_jsxs("option", { value: s.version, children: ["v", s.version] }, s.version))) })] }));
+}
+//# sourceMappingURL=VariantMatrixVersionPanel.js.map

package/dist/components/VariantMatrixVersionPanel.js.map

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

package/dist/components/WebhookNotifyPanel.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Wave 4 I1 — Generic webhook notify panel.
+ *
+ * Companion to the I3 {@link SlackNotifyPanel} (Wave 4 PR-11). Where
+ * I3 targets a single integration (Slack incoming webhooks) with a
+ * canned message template per event, I1 is the generic catch-all —
+ * the host wires any outbound HTTP integration (Zapier, n8n, GitHub
+ * Actions repository_dispatch, internal worker queues, custom tenant
+ * endpoints) by supplying a {@link WebhookNotifyFn} adapter and the
+ * panel emits a typed {@link WebhookNotificationEvent} payload.
+ *
+ * The wire shape is intentionally structured rather than free-form
+ * text: downstream consumers can pattern-match on `kind` and read
+ * typed fields off `context`, rather than parsing English. Hosts that
+ * want a human-readable rendering on top of the structured payload
+ * wrap their own adapter.
+ *
+ * Pairs with the synergy `webhook.notify` workflow node when one is
+ * deployed; hosts running purely client-side `fetch()` calls wire a
+ * local adapter in the meantime.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * The set of editor events the panel can emit. Mirrors
+ * {@link SlackNotificationEventKind} for cross-integration parity —
+ * the two panels respond to the same event vocabulary so a host can
+ * wire I1 + I3 against the same trigger list.
+ *
+ * @public
+ */
+export type WebhookNotificationEventKind = "preflight-blocked" | "preflight-cleared" | "job-submitted" | "variant-approved" | "approval-requested" | "custom";
+/**
+ * Context the host passes in alongside the chosen event. Mirrors
+ * {@link SlackNotificationContext} so a single host-side state object
+ * can feed both panels; the webhook payload preserves the structured
+ * fields rather than rendering them into a single text line.
+ *
+ * @public
+ */
+export type WebhookNotificationContext = {
+    /** Human-readable document name. */
+    documentName?: string;
+    /** Stable identifier the host uses to link back to the document. */
+    documentId?: string;
+    /** Optional clickable URL the downstream consumer can use to 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. */
+    actor?: string;
+    /** Free-form additional text — the panel surfaces an optional note
+     *  input that populates this; downstream consumers may render it as
+     *  a description / commit message / etc. */
+    text?: string;
+};
+/**
+ * Canonical structured payload the panel POSTs to the host adapter.
+ * The `kind` + `context` split keeps the wire shape pattern-matchable
+ * (no English-parsing required on the receiver) while leaving the
+ * envelope (`integration`, `sentAt`) free for routing.
+ *
+ * @public
+ */
+export type WebhookNotificationEvent = {
+    /** Schema version — bump on breaking shape changes. */
+    schemaVersion: 1;
+    /** Event kind from {@link WebhookNotificationEventKind}. */
+    kind: WebhookNotificationEventKind;
+    /** Structured context — see {@link WebhookNotificationContext}. */
+    context: WebhookNotificationContext;
+    /** Optional integration identifier the host can use to route the
+     *  event to one of many wired endpoints (e.g. `"zapier-main"`,
+     *  `"github-actions-staging"`). When absent, the host adapter
+     *  decides the default destination. */
+    integration?: string;
+    /** ISO 8601 timestamp the panel stamps at send time. */
+    sentAt: string;
+};
+/**
+ * Pure helper — composes a {@link WebhookNotificationEvent} from a
+ * kind + context + optional integration. Stamps `sentAt` to the
+ * passed-in `now()` so tests can pin the timestamp. Pure function;
+ * no I/O.
+ *
+ * @public
+ */
+export declare function composeWebhookEvent(kind: WebhookNotificationEventKind, context: WebhookNotificationContext, options?: {
+    integration?: string;
+    now?: () => Date;
+}): WebhookNotificationEvent;
+/**
+ * Host adapter — POSTs the composed payload to the wired endpoint
+ * (typically via a server-side proxy or the synergy `webhook.notify`
+ * node). Resolves on accept; rejects on transport / validation
+ * errors and the panel surfaces the message inline.
+ *
+ * @public
+ */
+export type WebhookNotifyFn = (event: WebhookNotificationEvent) => Promise<void>;
+/**
+ * Human-readable labels for each event kind, in the order they appear
+ * in the dropdown. Mirrors {@link SlackNotifyPanel}'s label map so the
+ * two panels stay in lockstep.
+ *
+ * @public
+ */
+export declare const WEBHOOK_NOTIFICATION_EVENT_LABELS: Readonly<Record<WebhookNotificationEventKind, string>>;
+/**
+ * Configuration for the {@link WebhookNotifyPanel}.
+ *
+ * The host supplies the {@link WebhookNotifyFn} adapter, the typed
+ * {@link WebhookNotificationContext}, and (optionally) a list of
+ * integration ids that populate the panel's "Integration" dropdown.
+ * The panel handles event-kind selection, the optional free-form
+ * note, the send button state machine, and surfaces success / error
+ * inline.
+ *
+ * @public
+ */
+export type WebhookNotifyPanelProps = {
+    /** Host adapter — see {@link WebhookNotifyFn}. */
+    notify: WebhookNotifyFn;
+    /** Typed context to bundle into the outgoing event. The host
+     *  typically wires this from the active document. */
+    context: WebhookNotificationContext;
+    /** Optional initial event selection. Defaults to
+     *  `"job-submitted"` — the most common webhook trigger across
+     *  CI / queue / chat integrations. */
+    defaultEvent?: WebhookNotificationEventKind;
+    /** Optional list of integration ids the host has wired. Surfaces as
+     *  a dropdown; when absent the panel omits the picker and the
+     *  outgoing event has no `integration` field set. */
+    integrations?: readonly string[];
+    /** Optional initial integration selection. Must match one of
+     *  `integrations`; when absent the first entry is selected. */
+    defaultIntegration?: 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 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?: (event: WebhookNotificationEvent) => void;
+};
+/**
+ * Stateful panel — picks an event template + integration, lets the
+ * user append a custom note, composes the typed event via
+ * {@link composeWebhookEvent}, and POSTs through the host adapter.
+ *
+ * @public
+ */
+export declare function WebhookNotifyPanel({ notify, context, defaultEvent, integrations, defaultIntegration, errorMessage, onSuccess, }: WebhookNotifyPanelProps): ReactElement;
+//# sourceMappingURL=WebhookNotifyPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookNotifyPanel.d.ts","sourceRoot":"","sources":["../../src/components/WebhookNotifyPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GACpC,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,QAAQ,CAAC;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;oCACgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;qDACiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;gDAE4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,uDAAuD;IACvD,aAAa,EAAE,CAAC,CAAC;IACjB,4DAA4D;IAC5D,IAAI,EAAE,4BAA4B,CAAC;IACnC,mEAAmE;IACnE,OAAO,EAAE,0BAA0B,CAAC;IACpC;;;2CAGuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GACnD,wBAAwB,CAS1B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,MAAM,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAQ7C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,kDAAkD;IAClD,MAAM,EAAE,eAAe,CAAC;IACxB;yDACqD;IACrD,OAAO,EAAE,0BAA0B,CAAC;IACpC;;0CAEsC;IACtC,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C;;yDAEqD;IACrD,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;mEAC+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;qEAGiE;IACjE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC;qDACiD;IACjD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,SAAS,GACV,EAAE,uBAAuB,GAAG,YAAY,CAgIxC"}

package/dist/components/WebhookNotifyPanel.js

@@ -0,0 +1,100 @@
+// 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 — composes a {@link WebhookNotificationEvent} from a
+ * kind + context + optional integration. Stamps `sentAt` to the
+ * passed-in `now()` so tests can pin the timestamp. Pure function;
+ * no I/O.
+ *
+ * @public
+ */
+export function composeWebhookEvent(kind, context, options) {
+    const now = options?.now ?? (() => new Date());
+    return {
+        schemaVersion: 1,
+        kind,
+        context,
+        ...(options?.integration && { integration: options.integration }),
+        sentAt: now().toISOString(),
+    };
+}
+/**
+ * Human-readable labels for each event kind, in the order they appear
+ * in the dropdown. Mirrors {@link SlackNotifyPanel}'s label map so the
+ * two panels stay in lockstep.
+ *
+ * @public
+ */
+export const WEBHOOK_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 event",
+};
+/**
+ * Stateful panel — picks an event template + integration, lets the
+ * user append a custom note, composes the typed event via
+ * {@link composeWebhookEvent}, and POSTs through the host adapter.
+ *
+ * @public
+ */
+export function WebhookNotifyPanel({ notify, context, defaultEvent, integrations, defaultIntegration, errorMessage, onSuccess, }) {
+    const [event, setEvent] = useState(defaultEvent ?? "job-submitted");
+    // Validate `defaultIntegration` against the wired list — a host-supplied
+    // default that isn't in `integrations` would otherwise quietly ship as
+    // the outgoing event's `integration` field even though the user can't
+    // see / change it in the dropdown.
+    const [integration, setIntegration] = useState(() => {
+        if (defaultIntegration && integrations?.includes(defaultIntegration)) {
+            return defaultIntegration;
+        }
+        return integrations?.[0] ?? "";
+    });
+    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.
+    const resetOutcome = () => {
+        setState((prev) => (prev.kind === "ok" || prev.kind === "error" ? { kind: "idle" } : prev));
+    };
+    const onClick = async () => {
+        setState({ kind: "sending" });
+        const payload = composeWebhookEvent(event, {
+            ...context,
+            ...(note.trim() && { text: note }),
+        }, integration ? { integration } : undefined);
+        try {
+            await notify(payload);
+            setState({ kind: "ok" });
+            onSuccess?.(payload);
+        }
+        catch (err) {
+            // Guard against a host-supplied errorMessage that throws.
+            let message = "Couldn't send webhook notification.";
+            if (errorMessage) {
+                try {
+                    message = errorMessage(err);
+                }
+                catch {
+                    // fall back to the default
+                }
+            }
+            setState({ kind: "error", message });
+        }
+    };
+    return (_jsxs("div", { "data-testid": "webhook-notify-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Webhook 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(WEBHOOK_NOTIFICATION_EVENT_LABELS).map(([k, label]) => (_jsx("option", { value: k, children: label }, k))) })] }), integrations && integrations.length > 0 && (_jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Integration", _jsx("select", { "aria-label": "Integration", value: integration, onChange: (e) => {
+                            setIntegration(e.target.value);
+                            resetOutcome();
+                        }, style: { display: "block", marginTop: "0.125rem", width: "100%" }, children: integrations.map((id) => (_jsx("option", { value: id, children: id }, id))) })] })), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Note", _jsx("textarea", { "aria-label": "Note", placeholder: "Optional \u2014 included as context.text", 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…" : "Send webhook" }), 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=WebhookNotifyPanel.js.map

package/dist/components/WebhookNotifyPanel.js.map

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

package/dist/components/WhiteUnderbasePanel.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Wave 3 C2 — White / underbase auto-generation panel.
+ *
+ * Many packaging substrates (foils, dark plastics, kraft) require an
+ * opaque white layer printed *under* the CMYK / spots so the
+ * subsequent ink lays down with the colour the designer specified
+ * rather than being tinted by the substrate. Manually authoring this
+ * separation is tedious and error-prone — C2 asks compile-pdf's
+ * `white_underbase` producer to compute the union of CMYK fill
+ * coverage on the page and emit a new `White` separation matching
+ * that union, optionally choked inward by a small amount so the
+ * white doesn't peek out from underneath the chromatic ink.
+ *
+ * Pure-adapter design (same shape as the rest of the AI / I family
+ * panels): the host wires a {@link WhiteUnderbaseGeneratorFn} that
+ * fronts the producer; the panel owns config inputs and lifecycle
+ * state.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * Spec for one underbase-generation request. Mirrors the
+ * `WhiteUnderbaseOptions` shape on compile-pdf's
+ * `/v1/white-underbase/apply` endpoint so a host can pass the value
+ * straight through.
+ *
+ * @public
+ */
+export type WhiteUnderbaseSpec = {
+    /** Name to assign the new separation. Default `"White"`. */
+    separationName: string;
+    /** Opacity of the underbase (0..1). 1 = solid white. */
+    opacity: number;
+    /** Distance (in mm) to choke the white inward from the chromatic
+     *  ink edges. Prevents the white from peeking out around the
+     *  printed colour. 0 = no choke. */
+    chokeMm: number;
+    /** How the underbase relates to overlapping chromatic ink:
+     *  - `solid` — white covers the entire chromatic region (default)
+     *  - `subtract-cmyk` — white opacity is scaled down where CMYK
+     *    coverage approaches 100% (lighter inks need less underbase) */
+    knockoutMode: "solid" | "subtract-cmyk";
+};
+/**
+ * Default spec values — sensible for the most common case
+ * (white-ink underbase on dark substrate, no choke).
+ *
+ * @public
+ */
+export declare const DEFAULT_WHITE_UNDERBASE_SPEC: WhiteUnderbaseSpec;
+/**
+ * Result returned by the host generator. The host typically wires
+ * this to `CompilePdfClient.whiteUnderbase()` which calls
+ * `/v1/white-underbase/apply` and returns the producer's
+ * `separation_name` + `coverage_pct` fields.
+ *
+ * @public
+ */
+export type WhiteUnderbaseResult = {
+    separationName: string;
+    /** Percentage of the page area covered by the new underbase
+     *  separation. Useful as a sanity check (e.g. > 95 % suggests the
+     *  page is mostly chromatic — review the choke). */
+    coveragePct: number;
+};
+/**
+ * Host adapter — generates the white underbase for the active
+ * document. Rejects on transport / validation errors and the panel
+ * surfaces the message inline.
+ *
+ * @public
+ */
+export type WhiteUnderbaseGeneratorFn = (spec: WhiteUnderbaseSpec) => Promise<WhiteUnderbaseResult>;
+/**
+ * Pure helper — validates a spec. Returns the first error message
+ * encountered or `null` when the spec is valid. Hosts can call this
+ * to disable the "Generate" button preemptively. Pure function.
+ *
+ * @public
+ */
+export declare function validateWhiteUnderbaseSpec(spec: WhiteUnderbaseSpec): string | null;
+/**
+ * Configuration for the {@link WhiteUnderbasePanel}.
+ *
+ * @public
+ */
+export type WhiteUnderbasePanelProps = {
+    /** Initial spec values — `DEFAULT_WHITE_UNDERBASE_SPEC` if absent. */
+    initialSpec?: Partial<WhiteUnderbaseSpec>;
+    /** Generator adapter — when absent, the panel renders in
+     *  read-only mode (config inputs disabled). Useful when the host
+     *  wants to surface the controls but defer the network wire. */
+    generator?: WhiteUnderbaseGeneratorFn;
+    /** Fired after a successful generation — typically used to refresh
+     *  the editor's separations registry / inks panel. */
+    onGenerated?: (result: WhiteUnderbaseResult) => void;
+};
+/**
+ * Stateful panel — exposes inputs for every {@link WhiteUnderbaseSpec}
+ * field, dispatches the generator, and surfaces the result chip /
+ * inline error. Handles loading, validation, and success states.
+ *
+ * @public
+ */
+export declare function WhiteUnderbasePanel({ initialSpec, generator, onGenerated, }: WhiteUnderbasePanelProps): ReactElement;
+//# sourceMappingURL=WhiteUnderbasePanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WhiteUnderbasePanel.d.ts","sourceRoot":"","sources":["../../src/components/WhiteUnderbasePanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;wCAEoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB;;;wEAGoE;IACpE,YAAY,EAAE,OAAO,GAAG,eAAe,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAK1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB;;wDAEoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,IAAI,EAAE,kBAAkB,KACrB,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAalF;AAED;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1C;;oEAEgE;IAChE,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC;0DACsD;IACtD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,SAAS,EACT,WAAW,GACZ,EAAE,wBAAwB,GAAG,YAAY,CAyIzC"}