@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

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

package/dist/components/WhiteUnderbasePanel.js

@@ -0,0 +1,104 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+/**
+ * Default spec values — sensible for the most common case
+ * (white-ink underbase on dark substrate, no choke).
+ *
+ * @public
+ */
+export const DEFAULT_WHITE_UNDERBASE_SPEC = {
+    separationName: "White",
+    opacity: 1,
+    chokeMm: 0,
+    knockoutMode: "solid",
+};
+/**
+ * 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 function validateWhiteUnderbaseSpec(spec) {
+    // Defensive against partial-spec merges that leave fields undefined
+    // (Partial<WhiteUnderbaseSpec> lets a host pass `{ separationName:
+    // undefined }`, which would otherwise throw on `.trim()`).
+    const name = spec.separationName ?? "";
+    if (!name.trim())
+        return "Separation name is required.";
+    if (!Number.isFinite(spec.opacity) || spec.opacity < 0 || spec.opacity > 1) {
+        return "Opacity must be between 0 and 1.";
+    }
+    if (!Number.isFinite(spec.chokeMm))
+        return "Choke must be a number.";
+    if (spec.chokeMm < 0)
+        return "Choke can't be negative.";
+    if (spec.chokeMm > 5)
+        return "Choke above 5 mm is implausibly large; double-check.";
+    return null;
+}
+/**
+ * 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 function WhiteUnderbasePanel({ initialSpec, generator, onGenerated, }) {
+    const [spec, setSpec] = useState(() => {
+        // Field-wise merge — skip undefined values in initialSpec so hosts
+        // passing `{ separationName: undefined }` don't clobber the
+        // defaults and leave required fields unset.
+        const merged = { ...DEFAULT_WHITE_UNDERBASE_SPEC };
+        if (!initialSpec)
+            return merged;
+        for (const key of Object.keys(initialSpec)) {
+            const value = initialSpec[key];
+            if (value !== undefined) {
+                // biome-ignore lint/suspicious/noExplicitAny: dynamic keyed assignment
+                merged[key] = value;
+            }
+        }
+        return merged;
+    });
+    const [status, setStatus] = useState("idle");
+    const [result, setResult] = useState(null);
+    const [errorMsg, setErrorMsg] = useState(null);
+    const validationError = validateWhiteUnderbaseSpec(spec);
+    const canGenerate = !!generator && status !== "loading" && !validationError;
+    const generate = useCallback(async () => {
+        if (!generator)
+            return;
+        setStatus("loading");
+        setErrorMsg(null);
+        try {
+            const next = await generator(spec);
+            setResult(next);
+            setStatus("done");
+            onGenerated?.(next);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "Generation failed.";
+            setErrorMsg(msg);
+            setStatus("error");
+        }
+    }, [generator, spec, onGenerated]);
+    const update = (key, value) => {
+        setSpec((prev) => ({ ...prev, [key]: value }));
+    };
+    return (_jsxs("div", { "data-testid": "white-underbase-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "White underbase" }) }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "0.375rem" }, children: [_jsxs("label", { style: { fontSize: "0.75rem", display: "flex", flexDirection: "column" }, children: [_jsx("span", { style: { color: "#595959", marginBottom: "0.125rem" }, children: "Separation name" }), _jsx("input", { type: "text", value: spec.separationName, onChange: (e) => update("separationName", e.target.value), disabled: !generator, style: { fontSize: "0.8125rem", padding: "0.25rem 0.375rem" } })] }), _jsxs("label", { style: { fontSize: "0.75rem", display: "flex", flexDirection: "column" }, children: [_jsxs("span", { style: { color: "#595959", marginBottom: "0.125rem" }, children: ["Opacity (", spec.opacity.toFixed(2), ")"] }), _jsx("input", { type: "range", min: 0, max: 1, step: 0.05, value: spec.opacity, onChange: (e) => {
+                                    const next = Number(e.target.value);
+                                    if (Number.isFinite(next))
+                                        update("opacity", next);
+                                }, disabled: !generator })] }), _jsxs("label", { style: { fontSize: "0.75rem", display: "flex", flexDirection: "column" }, children: [_jsx("span", { style: { color: "#595959", marginBottom: "0.125rem" }, children: "Choke (mm)" }), _jsx("input", { type: "number", min: 0, max: 5, step: 0.05, value: spec.chokeMm, onChange: (e) => {
+                                    // Empty number input → "" → NaN, which would bypass
+                                    // validation and slip through to the generator. Treat a
+                                    // cleared field as 0 (the no-choke default).
+                                    const next = e.target.value === "" ? 0 : Number(e.target.value);
+                                    if (Number.isFinite(next))
+                                        update("chokeMm", next);
+                                }, disabled: !generator, style: { fontSize: "0.8125rem", padding: "0.25rem 0.375rem" } })] }), _jsxs("label", { style: { fontSize: "0.75rem", display: "flex", flexDirection: "column" }, children: [_jsx("span", { style: { color: "#595959", marginBottom: "0.125rem" }, children: "Knockout mode" }), _jsxs("select", { value: spec.knockoutMode, onChange: (e) => update("knockoutMode", e.target.value), disabled: !generator, style: { fontSize: "0.8125rem", padding: "0.25rem 0.375rem" }, children: [_jsx("option", { value: "solid", children: "solid \u2014 full coverage" }), _jsx("option", { value: "subtract-cmyk", children: "subtract-cmyk \u2014 scale by ink density" })] })] })] }), validationError && (_jsx("div", { role: "alert", style: { marginTop: "0.5rem", fontSize: "0.75rem", color: "#a60" }, children: validationError })), _jsxs("div", { style: { marginTop: "0.5rem", display: "flex", alignItems: "center", gap: "0.5rem" }, children: [_jsx("button", { type: "button", onClick: generate, disabled: !canGenerate, style: { fontSize: "0.75rem", padding: "0.25rem 0.625rem" }, children: status === "loading" ? "Generating…" : "Generate" }), status === "done" && result && (_jsxs("span", { style: { fontSize: "0.75rem", color: "#595959" }, children: [result.separationName, " \u00B7 ", result.coveragePct.toFixed(1), "% coverage"] })), status === "error" && errorMsg && (_jsx("span", { role: "alert", style: { fontSize: "0.75rem", color: "#a00" }, children: errorMsg }))] })] }));
+}
+//# sourceMappingURL=WhiteUnderbasePanel.js.map

package/dist/components/WhiteUnderbasePanel.js.map

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

package/dist/data/dielines.json

@@ -182,5 +182,40 @@
             "previewSvg": "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 54.8 80.2'><rect x='2' y='2' width='50.8' height='76.2' fill='none' stroke='#333' stroke-width='0.5' rx='3'/><line x1='2' y1='12' x2='52.8' y2='12' stroke='#666' stroke-width='0.3'/><text x='27.4' y='47' text-anchor='middle' font-size='6' fill='#666'>Sachet</text><text x='27.4' y='56' text-anchor='middle' font-size='4' fill='#999'>2×3″</text></svg>",
             "tags": ["sachet", "single-serve", "condiment", "sample", "hotel"]
         }
+    ],
+    "templateSets": [
+        {
+            "id": "carton-6x4x2-set",
+            "name": "Carton 6×4×2 (front + back)",
+            "description": "Two-sided dieline for a 6×4×2 straight-tuck carton. Front and back share the same trim.",
+            "category": "carton-set",
+            "pages": [
+                { "templateId": "carton-6x4x2", "name": "Front" },
+                { "templateId": "carton-6x4x2", "name": "Back" }
+            ],
+            "tags": ["carton", "box", "multi-page", "front-back"]
+        },
+        {
+            "id": "carton-8x6x3-set",
+            "name": "Carton 8×6×3 (front + back)",
+            "description": "Two-sided dieline for an 8×6×3 straight-tuck carton.",
+            "category": "carton-set",
+            "pages": [
+                { "templateId": "carton-8x6x3", "name": "Front" },
+                { "templateId": "carton-8x6x3", "name": "Back" }
+            ],
+            "tags": ["carton", "box", "multi-page", "front-back"]
+        },
+        {
+            "id": "standup-pouch-4x6-set",
+            "name": "Stand-Up Pouch 4×6 (front + back)",
+            "description": "Two-sided dieline for a 4×6 stand-up pouch — front graphic + back panel.",
+            "category": "pouch-set",
+            "pages": [
+                { "templateId": "standup-pouch-4x6", "name": "Front" },
+                { "templateId": "standup-pouch-4x6", "name": "Back" }
+            ],
+            "tags": ["pouch", "stand-up", "multi-page", "front-back"]
+        }
     ]
 }

package/dist/hooks/useEditorMode.d.ts

@@ -1,11 +1,31 @@
+/**
+ * Editor UI complexity tier. `"basic"` strips advanced controls and
+ * is the touch/mobile default; `"pro"` shows the full toolset.
+ * Resolved via {@link useEditorMode}.
+ *
+ * @public
+ */
 export type EditorMode = "basic" | "pro";
 /**
- * Resolves the editor mode with this precedence:
- *  1. Explicit user choice persisted in localStorage
- *  2. `prefer` prop (set by the page — e.g. demo passes "auto")
- *  3. Viewport heuristic: pro on >= 900 CSS px, basic otherwise
+ * Resolve the active editor mode and expose a setter that persists
+ * the choice across reloads.
+ *
+ * Precedence (later wins):
+ *
+ *   1. Explicit user choice persisted in `localStorage`
+ *      (`"artworkpdf:editor-mode"`)
+ *   2. The `prefer` arg (typically threaded from the host page —
+ *      `/demo` passes `"auto"` so the viewport heuristic picks)
+ *   3. Viewport heuristic: `"pro"` on wider viewports, `"basic"`
+ *      on narrower ones
+ *
+ * `setMode(null)` clears the persisted preference and falls back to
+ * the heuristic; `isAuto` is true while no explicit choice is saved.
+ *
+ * SSR-safe: returns the resolved fallback until hydration completes,
+ * so the server render matches the first client paint.
  *
- * `setMode(null)` clears the saved preference and returns to auto.
+ * @public
  */
 export declare function useEditorMode(prefer?: EditorMode | "auto"): {
     mode: EditorMode;

package/dist/hooks/useEditorMode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditorMode.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorMode.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAIzC;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,UAAU,GAAG,MAAe,GAAG;IACnE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;CACjB,CAqCA"}
+{"version":3,"file":"useEditorMode.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorMode.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAIzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,UAAU,GAAG,MAAe,GAAG;IACnE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;CACjB,CAqCA"}

package/dist/hooks/useEditorMode.js

@@ -3,12 +3,25 @@
 import { useCallback, useEffect, useState } from "react";
 const STORAGE_KEY = "artworkpdf:editor-mode";
 /**
- * Resolves the editor mode with this precedence:
- *  1. Explicit user choice persisted in localStorage
- *  2. `prefer` prop (set by the page — e.g. demo passes "auto")
- *  3. Viewport heuristic: pro on >= 900 CSS px, basic otherwise
+ * Resolve the active editor mode and expose a setter that persists
+ * the choice across reloads.
  *
- * `setMode(null)` clears the saved preference and returns to auto.
+ * Precedence (later wins):
+ *
+ *   1. Explicit user choice persisted in `localStorage`
+ *      (`"artworkpdf:editor-mode"`)
+ *   2. The `prefer` arg (typically threaded from the host page —
+ *      `/demo` passes `"auto"` so the viewport heuristic picks)
+ *   3. Viewport heuristic: `"pro"` on wider viewports, `"basic"`
+ *      on narrower ones
+ *
+ * `setMode(null)` clears the persisted preference and falls back to
+ * the heuristic; `isAuto` is true while no explicit choice is saved.
+ *
+ * SSR-safe: returns the resolved fallback until hydration completes,
+ * so the server render matches the first client paint.
+ *
+ * @public
  */
 export function useEditorMode(prefer = "auto") {
     const [stored, setStored] = useState(null);

package/dist/hooks/useEditorMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEditorMode.js","sourceRoot":"","sources":["../../src/hooks/useEditorMode.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;AACb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIzD,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,SAA8B,MAAM;IAKhE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK;gBAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,EAAE,CAAC;QACP,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,IAAuB,EAAE,EAAE;QACtD,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;;gBAC1D,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,oEAAoE;IACpE,MAAM,IAAI,GAAe,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,MAAM,QAAQ,GAAe,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"useEditorMode.js","sourceRoot":"","sources":["../../src/hooks/useEditorMode.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;AACb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAWzD,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAC,SAA8B,MAAM;IAKhE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK;gBAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,EAAE,CAAC;QACP,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,IAAuB,EAAE,EAAE;QACtD,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;;gBAC1D,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,oEAAoE;IACpE,MAAM,IAAI,GAAe,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,MAAM,QAAQ,GAAe,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;AACpD,CAAC"}