@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

package/dist/components/EmailNotifyPanel.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Wave 4 I2 — Email notify panel.
+ *
+ * Third member of the Wave 4 integration family alongside I3
+ * {@link SlackNotifyPanel} (Slack incoming webhooks) and I1
+ * {@link WebhookNotifyPanel} (generic outbound webhooks). I2 targets
+ * email — typically the longest-lived notification channel for
+ * artwork-review workflows (approval pings, preflight blockers,
+ * customer-facing job-submitted receipts).
+ *
+ * The host wires an {@link EmailNotifyFn} adapter (SMTP relay,
+ * SendGrid, Postmark, AWS SES, internal Synergy node, etc.). The
+ * panel handles event-template selection, recipient + cc + bcc
+ * inputs, subject / body composition via {@link composeEmailMessage},
+ * and the send-button state machine.
+ *
+ * Pairs with the synergy `email.notify` workflow node when one is
+ * deployed; hosts without a synergy bridge can also POST straight to
+ * their tenant SMTP / transactional-email provider — the adapter
+ * shape is intentionally agnostic.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * The set of editor events that map to canonical email templates.
+ * Mirrors I3's and I1's vocabulary so a single host-side trigger
+ * source can fan out to all three integration panels.
+ *
+ * @public
+ */
+export type EmailNotificationEventKind = "preflight-blocked" | "preflight-cleared" | "job-submitted" | "variant-approved" | "approval-requested" | "custom";
+/**
+ * Context passed to {@link composeEmailMessage}. Most fields are
+ * optional and only render when the chosen template references them.
+ *
+ * @public
+ */
+export type EmailNotificationContext = {
+    /** Human-readable document name surfaced in the subject + body. */
+    documentName?: string;
+    /** Stable identifier the host uses to link back to the document. */
+    documentId?: string;
+    /** Optional clickable URL — rendered as a "View artwork" link in
+     *  the body 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 — surfaces as the byline in
+     *  the body. */
+    actor?: string;
+    /** Free-form additional text appended to the canonical body (or,
+     *  for `"custom"`, used as the entire body). */
+    text?: string;
+};
+/**
+ * Composed email payload — the panel emits this through the host
+ * adapter. The subject + body split keeps the wire shape consumable
+ * by SMTP / transactional-email APIs without further parsing. Plain
+ * text only at this version; rich HTML can land in a future iteration
+ * once hosts express a need.
+ *
+ * @public
+ */
+export type EmailNotificationPayload = {
+    /** Primary recipients. At least one address is required at the
+     *  panel level — the composer doesn't enforce that so it stays
+     *  pure. */
+    to: readonly string[];
+    /** Optional carbon-copy list. */
+    cc?: readonly string[];
+    /** Optional blind carbon-copy list. */
+    bcc?: readonly string[];
+    /** Subject line. */
+    subject: string;
+    /** Plain-text body. */
+    body: string;
+};
+/**
+ * Pure helper — parses a comma / semicolon / whitespace-separated
+ * address list into a deduplicated, trimmed array. Empty input
+ * returns an empty array. Pure function; no I/O.
+ *
+ * @public
+ */
+export declare function parseEmailList(raw: string): readonly string[];
+/**
+ * Pure helper — composes an {@link EmailNotificationPayload} subject
+ * and body from a kind + context + recipient lists. The subject is a
+ * single canonical line per template; the body is a short multi-line
+ * plaintext block that includes whatever fields the context supplies.
+ *
+ * `"custom"` uses `context.text` verbatim as the body and falls back
+ * to a sensible default when the host left it empty — the helper
+ * never silently drops the message.
+ *
+ * Pure function; no I/O.
+ *
+ * @public
+ */
+export declare function composeEmailMessage(kind: EmailNotificationEventKind, context: EmailNotificationContext, recipients: {
+    to: readonly string[];
+    cc?: readonly string[];
+    bcc?: readonly string[];
+}): EmailNotificationPayload;
+/**
+ * Host adapter — POSTs the composed payload to the wired email
+ * provider (typically via a server-side proxy or the synergy
+ * `email.notify` node). Resolves on accept; rejects on transport /
+ * validation errors and the panel surfaces the message inline.
+ *
+ * @public
+ */
+export type EmailNotifyFn = (payload: EmailNotificationPayload) => Promise<void>;
+/**
+ * Human-readable labels for each event kind, in the order they
+ * appear in the dropdown. Mirrors the I3 and I1 label maps so the
+ * three integrations stay in lockstep.
+ *
+ * @public
+ */
+export declare const EMAIL_NOTIFICATION_EVENT_LABELS: Readonly<Record<EmailNotificationEventKind, string>>;
+/**
+ * Configuration for the {@link EmailNotifyPanel}. The host always
+ * supplies the {@link EmailNotifyFn}; the optional fields seed the
+ * recipient + event dropdown defaults so the panel can open
+ * prefilled for the common case.
+ *
+ * @public
+ */
+export type EmailNotifyPanelProps = {
+    /** Host adapter, see {@link EmailNotifyFn}. */
+    notify: EmailNotifyFn;
+    /** Context the panel renders into the chosen template. */
+    context: EmailNotificationContext;
+    /** Optional initial event selection. Defaults to
+     *  `"approval-requested"` — the most common email trigger. */
+    defaultEvent?: EmailNotificationEventKind;
+    /** Optional initial recipients (comma-separated for the input). */
+    defaultTo?: string;
+    /** Optional initial cc list. */
+    defaultCc?: string;
+    /** Optional initial bcc list. */
+    defaultBcc?: string;
+    /** Optional mapper that turns a notify error into a user-facing
+     *  message. The default avoids leaking internal `Error.message`
+     *  strings. */
+    errorMessage?: (err: unknown) => string;
+    /** Optional callback fired on successful notify so the host can
+     *  show a confirmation toast / log analytics. */
+    onSuccess?: (payload: EmailNotificationPayload) => void;
+};
+/**
+ * Stateful panel — picks an event template, captures recipient
+ * lists, lets the user append a custom note, composes the payload
+ * via {@link composeEmailMessage}, and POSTs through the host
+ * adapter.
+ *
+ * @public
+ */
+export declare function EmailNotifyPanel({ notify, context, defaultEvent, defaultTo, defaultCc, defaultBcc, errorMessage, onSuccess, }: EmailNotifyPanelProps): ReactElement;
+//# sourceMappingURL=EmailNotifyPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EmailNotifyPanel.d.ts","sourceRoot":"","sources":["../../src/components/EmailNotifyPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAClC,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;mEAC+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;qDACiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;oBACgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;oDACgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;gBAEY;IACZ,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IACtB,iCAAiC;IACjC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,uCAAuC;IACvC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAa7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE;IAAE,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrF,wBAAwB,CAU1B;AAqED;;;;;;;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;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,+CAA+C;IAC/C,MAAM,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,wBAAwB,CAAC;IAClC;kEAC8D;IAC9D,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;mBAEe;IACf,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;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,GACV,EAAE,qBAAqB,GAAG,YAAY,CAiKtC"}

package/dist/components/EmailNotifyPanel.js

@@ -0,0 +1,211 @@
+// 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";
+const EMAIL_LIST_SEPARATOR = /[,;\s]+/;
+/**
+ * Pure helper — parses a comma / semicolon / whitespace-separated
+ * address list into a deduplicated, trimmed array. Empty input
+ * returns an empty array. Pure function; no I/O.
+ *
+ * @public
+ */
+export function parseEmailList(raw) {
+    if (!raw.trim())
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const part of raw.split(EMAIL_LIST_SEPARATOR)) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const key = trimmed.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(trimmed);
+    }
+    return out;
+}
+/**
+ * Pure helper — composes an {@link EmailNotificationPayload} subject
+ * and body from a kind + context + recipient lists. The subject is a
+ * single canonical line per template; the body is a short multi-line
+ * plaintext block that includes whatever fields the context supplies.
+ *
+ * `"custom"` uses `context.text` verbatim as the body and falls back
+ * to a sensible default when the host left it empty — the helper
+ * never silently drops the message.
+ *
+ * Pure function; no I/O.
+ *
+ * @public
+ */
+export function composeEmailMessage(kind, context, recipients) {
+    const subject = composeSubject(kind, context);
+    const body = composeBody(kind, context);
+    return {
+        to: recipients.to,
+        ...(recipients.cc && recipients.cc.length > 0 && { cc: recipients.cc }),
+        ...(recipients.bcc && recipients.bcc.length > 0 && { bcc: recipients.bcc }),
+        subject,
+        body,
+    };
+}
+/** Resolve a human-readable document name from the context, falling
+ *  back to id and then to a generic placeholder. */
+function documentDisplayName(context) {
+    return context.documentName ?? context.documentId ?? "an artwork document";
+}
+/** Render the email subject line for one of the canonical templates. */
+function composeSubject(kind, context) {
+    const subject = documentDisplayName(context);
+    switch (kind) {
+        case "preflight-blocked":
+            return `Preflight blocked: ${subject}`;
+        case "preflight-cleared":
+            return `Preflight cleared: ${subject}`;
+        case "job-submitted":
+            return `Job submitted: ${subject}`;
+        case "variant-approved":
+            return `Variant approved: ${subject}`;
+        case "approval-requested":
+            return `Approval requested: ${subject}`;
+        case "custom":
+            return `Update: ${subject}`;
+    }
+}
+/** Render the email body (multi-line plaintext) for one of the
+ *  canonical templates; `"custom"` uses `context.text` verbatim. */
+function composeBody(kind, context) {
+    if (kind === "custom") {
+        const trailing = context.text?.trim();
+        if (trailing)
+            return trailing;
+        return `Update on ${documentDisplayName(context)}.`;
+    }
+    const lines = [];
+    const subject = documentDisplayName(context);
+    switch (kind) {
+        case "preflight-blocked": {
+            const n = context.findingCount;
+            const findingsFragment = typeof n === "number" ? ` ${n} finding${n === 1 ? "" : "s"} surfaced.` : "";
+            lines.push(`Preflight is blocking ${subject}.${findingsFragment}`);
+            break;
+        }
+        case "preflight-cleared":
+            lines.push(`Preflight is now clear on ${subject}.`);
+            break;
+        case "job-submitted":
+            lines.push(`A job has been submitted for ${subject}.`);
+            break;
+        case "variant-approved": {
+            const v = context.variantId ? ` (variant ${context.variantId})` : "";
+            lines.push(`A variant${v} was approved on ${subject}.`);
+            break;
+        }
+        case "approval-requested":
+            lines.push(`Approval is requested on ${subject}.`);
+            break;
+    }
+    if (context.actor)
+        lines.push(`By: ${context.actor}`);
+    if (context.documentUrl)
+        lines.push(`View artwork: ${context.documentUrl}`);
+    if (context.text?.trim())
+        lines.push("", context.text.trim());
+    return lines.join("\n");
+}
+/**
+ * Human-readable labels for each event kind, in the order they
+ * appear in the dropdown. Mirrors the I3 and I1 label maps so the
+ * three integrations stay in lockstep.
+ *
+ * @public
+ */
+export const EMAIL_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, captures recipient
+ * lists, lets the user append a custom note, composes the payload
+ * via {@link composeEmailMessage}, and POSTs through the host
+ * adapter.
+ *
+ * @public
+ */
+export function EmailNotifyPanel({ notify, context, defaultEvent, defaultTo, defaultCc, defaultBcc, errorMessage, onSuccess, }) {
+    const [event, setEvent] = useState(defaultEvent ?? "approval-requested");
+    const [toRaw, setToRaw] = useState(defaultTo ?? "");
+    const [ccRaw, setCcRaw] = useState(defaultCc ?? "");
+    const [bccRaw, setBccRaw] = useState(defaultBcc ?? "");
+    const [note, setNote] = useState("");
+    const [state, setState] = useState({ kind: "idle" });
+    // Clear the outcome chip on any input edit — a "Sent" indicator
+    // sitting 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 () => {
+        const to = parseEmailList(toRaw);
+        if (to.length === 0) {
+            setState({ kind: "error", message: "Add at least one recipient." });
+            return;
+        }
+        setState({ kind: "sending" });
+        const payload = composeEmailMessage(event, {
+            ...context,
+            ...(note.trim() && { text: note }),
+        }, {
+            to,
+            cc: parseEmailList(ccRaw),
+            bcc: parseEmailList(bccRaw),
+        });
+        try {
+            await notify(payload);
+            setState({ kind: "ok" });
+            onSuccess?.(payload);
+        }
+        catch (err) {
+            // Guard against a host-supplied errorMessage that throws or returns
+            // a falsy / empty string — either would leave the user staring at a
+            // blank error chip with no idea what happened.
+            let message = "Couldn't send email notification.";
+            if (errorMessage) {
+                try {
+                    const candidate = errorMessage(err);
+                    if (candidate)
+                        message = candidate;
+                }
+                catch {
+                    // fall back to the default
+                }
+            }
+            setState({ kind: "error", message });
+        }
+    };
+    return (_jsxs("div", { "data-testid": "email-notify-panel", style: { padding: "0.5rem" }, children: [_jsx("header", { style: { marginBottom: "0.5rem" }, children: _jsx("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: "Email 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(EMAIL_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: ["To", _jsx("input", { type: "text", "aria-label": "To", placeholder: "reviewer@example.com, \u2026", value: toRaw, onChange: (e) => {
+                            setToRaw(e.target.value);
+                            resetOutcome();
+                        }, style: { display: "block", marginTop: "0.125rem", width: "100%" } })] }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Cc", _jsx("input", { type: "text", "aria-label": "Cc", placeholder: "optional", value: ccRaw, onChange: (e) => {
+                            setCcRaw(e.target.value);
+                            resetOutcome();
+                        }, style: { display: "block", marginTop: "0.125rem", width: "100%" } })] }), _jsxs("label", { style: { display: "block", fontSize: "0.75rem", marginBottom: "0.5rem" }, children: ["Bcc", _jsx("input", { type: "text", "aria-label": "Bcc", placeholder: "optional", value: bccRaw, onChange: (e) => {
+                            setBccRaw(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: event === "custom"
+                            ? "Used as the full body for custom messages"
+                            : "Optional — appended to the body", 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 email" }), 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=EmailNotifyPanel.js.map

package/dist/components/EmailNotifyPanel.js.map

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

package/dist/components/FileDropZone.d.ts

@@ -1,6 +1,14 @@
+import { type Dieline } from "@artworkpdf/dieline-parser";
 type Props = {
+    /** Called when a PDF or raster image is dropped — the existing
+     *  preflight → editor flow takes over. */
     onFile: (file: File) => void;
+    /** Called when a structural dieline file (CF2 / DDES / ARD) is
+     *  dropped. Hosts that want to bypass preflight and seed the
+     *  canvas directly from the parsed `Dieline` should provide this.
+     *  Absent → dieline files are rejected. */
+    onDieline?: (dieline: Dieline) => void;
 };
-export declare function FileDropZone({ onFile }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function FileDropZone({ onFile, onDieline }: Props): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=FileDropZone.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FileDropZone.d.ts","sourceRoot":"","sources":["../../src/components/FileDropZone.tsx"],"names":[],"mappings":"AAIA,KAAK,KAAK,GAAG;IACX,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,2CAwE7C"}
+{"version":3,"file":"FileDropZone.d.ts","sourceRoot":"","sources":["../../src/components/FileDropZone.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,4BAA4B,CAAC;AAGzF,KAAK,KAAK,GAAG;IACX;8CAC0C;IAC1C,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC7B;;;+CAG2C;IAC3C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC;AAeF,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,2CAkHxD"}

package/dist/components/FileDropZone.js

@@ -1,17 +1,58 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { parseARD, parseCF2, parseDDES } from "@artworkpdf/dieline-parser";
 import { useCallback, useRef, useState } from "react";
-export function FileDropZone({ onFile }) {
+/**
+ * Detect which dieline-parser to invoke for a given filename.
+ * Returns `null` for non-dieline files (caller falls back to the
+ * normal PDF / image path).
+ */
+function dielineParserFor(name) {
+    const lower = name.toLowerCase();
+    if (lower.endsWith(".cf2"))
+        return parseCF2;
+    if (lower.endsWith(".ddes"))
+        return parseDDES;
+    if (lower.endsWith(".ard"))
+        return parseARD;
+    return null;
+}
+export function FileDropZone({ onFile, onDieline }) {
     const [dragging, setDragging] = useState(false);
+    const [parseError, setParseError] = useState(null);
     const inputRef = useRef(null);
-    const handle = useCallback((file) => {
+    const dielineSupported = onDieline !== undefined;
+    const handle = useCallback(async (file) => {
+        setParseError(null);
+        // Try the dieline-parser path first when the host supports it
+        // (onDieline provided). PDF / image still flows through the
+        // legacy `onFile` → preflight path. When dielines aren't
+        // supported, .cf2 / .ddes / .ard files fall through to the
+        // PDF/image check below and are silently rejected.
+        const dielineParser = dielineSupported ? dielineParserFor(file.name) : null;
+        if (dielineParser && onDieline) {
+            try {
+                const text = await file.text();
+                const dieline = dielineParser(text);
+                if (dieline.paths.length === 0) {
+                    setParseError(`${file.name}: no recognizable paths in this dieline file.`);
+                    return;
+                }
+                onDieline(dieline);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                setParseError(`${file.name}: ${msg}`);
+            }
+            return;
+        }
         if (file.type === "application/pdf" ||
             file.name.toLowerCase().endsWith(".pdf") ||
             file.type.startsWith("image/")) {
             onFile(file);
         }
-    }, [onFile]);
+    }, [onFile, onDieline, dielineSupported]);
     return (_jsxs("button", { type: "button", onDragOver: (e) => {
             e.preventDefault();
             setDragging(true);
@@ -33,7 +74,7 @@ export function FileDropZone({ onFile }) {
             width: "100%",
             fontFamily: "inherit",
             display: "block",
-        }, children: [_jsx("input", { ref: inputRef, type: "file", accept: ".pdf,image/*", style: { display: "none" }, onChange: (e) => {
+        }, children: [_jsx("input", { ref: inputRef, type: "file", accept: dielineSupported ? ".pdf,.cf2,.ddes,.ard,image/*" : ".pdf,image/*", style: { display: "none" }, onChange: (e) => {
                     const file = e.target.files?.[0];
                     if (file)
                         handle(file);
@@ -43,6 +84,13 @@ export function FileDropZone({ onFile }) {
                     fontWeight: 600,
                     marginBottom: "0.5rem",
                     fontSize: "1rem",
-                }, children: "Drop artwork file here" }), _jsx("span", { style: { display: "block", color: "#666", fontSize: "0.82rem" }, children: "PDF or raster image \u2014 preflight checks run before the canvas opens" })] }));
+                }, children: dielineSupported ? "Drop artwork or dieline file here" : "Drop artwork file here" }), _jsx("span", { style: { display: "block", color: "#666", fontSize: "0.82rem" }, children: dielineSupported
+                    ? "PDF / raster image (runs preflight) — or CF2 / DDES / ARD (seeds the canvas directly)"
+                    : "PDF or raster image — preflight checks run before the canvas opens" }), parseError && (_jsx("span", { role: "alert", "aria-live": "polite", style: {
+                    display: "block",
+                    color: "#ef4444",
+                    marginTop: "0.65rem",
+                    fontSize: "0.8rem",
+                }, children: parseError }))] }));
 }
 //# sourceMappingURL=FileDropZone.js.map

package/dist/components/FileDropZone.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileDropZone.js","sourceRoot":"","sources":["../../src/components/FileDropZone.tsx"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAMtD,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,EAAS;IAC5C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,IAAU,EAAE,EAAE;QACb,IACE,IAAI,CAAC,IAAI,KAAK,iBAAiB;YAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC9B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,EACD,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EACrC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,WAAW,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC,EACD,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,EACxC,KAAK,EAAE;YACL,MAAM,EAAE,cAAc,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;YACxD,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,aAAa;YAC5D,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,MAAM;YACb,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,OAAO;SACjB,aAED,gBACE,GAAG,EAAE,QAAQ,EACb,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAC1B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;oBACd,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;oBACjC,IAAI,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC,GACD,EACF,eACE,KAAK,EAAE;oBACL,OAAO,EAAE,OAAO;oBAChB,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,GAAG;oBACf,YAAY,EAAE,QAAQ;oBACtB,QAAQ,EAAE,MAAM;iBACjB,uCAGI,EACP,eAAM,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,wFAE9D,IACA,CACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"FileDropZone.js","sourceRoot":"","sources":["../../src/components/FileDropZone.tsx"],"names":[],"mappings":"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"}

package/dist/components/FoldEditorPanel.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Wave 2 S4 (PR-4) — interactive fold editor.
+ *
+ * Surfaces each fold edge in `FoldConfig` as a row with an angle
+ * slider, plus an OCG-style "show folded" toggle that hosts wire to
+ * the {@link FoldPreviewOverlay}'s active vs. flat view. Editing is
+ * controlled (`value` / `onChange`); the panel never owns state.
+ *
+ * Pairs with PR-3's `FoldPreviewOverlay` — the slider here updates
+ * `FoldConfig.edges[*].angleDeg`, and the overlay re-renders the
+ * Three.js scene on every commit.
+ *
+ * Designed to stay consumable without `@artworkpdf/document-model`:
+ * the value shape (`FoldEditorPanelValue`) mirrors the document-model
+ * `FoldConfig` field-for-field, same convention as
+ * `EditorSeparation`, `FoldGeometryPanelMetadata`,
+ * `EditorDielinePanel`.
+ *
+ * @public
+ */
+/**
+ * One fold edge between two panels.
+ *
+ * @public
+ */
+export type FoldEditorEdge = {
+    id: string;
+    panelA: string;
+    panelB: string;
+    angleDeg: number;
+    direction?: "mountain" | "valley";
+};
+/**
+ * Controlled value — mirrors document-model's `FoldConfig`.
+ *
+ * @public
+ */
+export type FoldEditorPanelValue = {
+    edges: FoldEditorEdge[];
+    defaultAngleDeg?: number;
+};
+/**
+ * @public
+ */
+export type FoldEditorPanelProps = {
+    /** Current fold configuration. `undefined` means "no panels with
+     *  fold metadata" — the panel renders a placeholder. */
+    value: FoldEditorPanelValue | undefined;
+    /** Fires on every slider tick. Hosts debounce externally if the
+     *  3D scene rebuild becomes expensive. */
+    onChange: (next: FoldEditorPanelValue) => void;
+    /** When `true`, the {@link FoldPreviewOverlay} should render the
+     *  *folded* state; when `false`, the flat unfolded state. Pure UI
+     *  state — the value-side is unaffected. */
+    showFolded?: boolean;
+    /** Fires when the user toggles the show-folded switch. Hosts thread
+     *  this back into a top-level UI flag and pass it to the overlay. */
+    onShowFoldedChange?: (next: boolean) => void;
+    /** Range bounds on the angle slider, in degrees. Defaults to
+     *  `[-180, 180]` — the same range `FoldConfig` permits. */
+    minAngleDeg?: number;
+    maxAngleDeg?: number;
+};
+/**
+ * @public
+ */
+export declare function FoldEditorPanel({ value, onChange, showFolded, onShowFoldedChange, minAngleDeg, maxAngleDeg, }: FoldEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FoldEditorPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FoldEditorPanel.d.ts","sourceRoot":"","sources":["../../src/components/FoldEditorPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;4DACwD;IACxD,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACxC;8CAC0C;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/C;;gDAE4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;yEACqE;IACrE,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C;+DAC2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAKF;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,EAAE,oBAAoB,2CAoHtB"}