@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

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

package/dist/components/FoldEditorPanel.js

@@ -0,0 +1,65 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const DEFAULT_MIN = -180;
+const DEFAULT_MAX = 180;
+/**
+ * @public
+ */
+export function FoldEditorPanel({ value, onChange, showFolded, onShowFoldedChange, minAngleDeg, maxAngleDeg, }) {
+    const min = minAngleDeg ?? DEFAULT_MIN;
+    const max = maxAngleDeg ?? DEFAULT_MAX;
+    if (!value || value.edges.length === 0) {
+        return (_jsx("div", { "data-testid": "fold-editor-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Load a dieline with fold metadata to edit panel angles." }));
+    }
+    const setEdgeAngle = (id, raw) => {
+        // In-progress edits ("", "-", "1e") parse to `NaN` / partial
+        // values — silently keep the last good angle so the user can
+        // type through to a valid one. The browser owns its `<input>`
+        // DOM value mid-edit, so the field still shows whatever they
+        // typed even though we haven't propagated it.
+        if (raw === "" || raw === "-" || raw === "+")
+            return;
+        const n = Number(raw);
+        if (!Number.isFinite(n))
+            return;
+        const clamped = Math.min(Math.max(n, min), max);
+        onChange({
+            ...value,
+            edges: value.edges.map((e) => (e.id === id ? { ...e, angleDeg: clamped } : e)),
+        });
+    };
+    const setEdgeDirection = (id, direction) => {
+        onChange({
+            ...value,
+            edges: value.edges.map((e) => {
+                if (e.id !== id)
+                    return e;
+                // Clearing the select drops the field entirely — restores the
+                // "no direction declared" state so the renderer can fall back
+                // to its own heuristic.
+                if (direction === undefined) {
+                    const { direction: _omit, ...rest } = e;
+                    return rest;
+                }
+                return { ...e, direction };
+            }),
+        });
+    };
+    return (_jsxs("div", { "data-testid": "fold-editor-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: { display: "flex", alignItems: "baseline", gap: "0.5rem" }, children: [_jsx("h3", { style: { margin: 0 }, children: "Fold angles" }), onShowFoldedChange && (_jsxs("label", { style: { marginLeft: "auto", fontSize: "0.85rem" }, children: [_jsx("input", { type: "checkbox", checked: !!showFolded, onChange: (e) => onShowFoldedChange(e.target.checked), "aria-label": "Show folded preview" }), " ", "Show folded"] }))] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: "0.5rem 0 0 0" }, children: value.edges.map((edge) => (_jsxs("li", { style: {
+                        display: "grid",
+                        gridTemplateColumns: "auto 1fr auto auto",
+                        gap: "0.5rem",
+                        alignItems: "center",
+                        padding: "0.25rem 0",
+                    }, children: [_jsxs("span", { style: { fontFamily: "monospace", fontSize: "0.85rem" }, children: [edge.panelA, " \u2194 ", edge.panelB] }), _jsx("input", { type: "range", min: min, max: max, step: 1, value: edge.angleDeg, onChange: (e) => setEdgeAngle(edge.id, e.target.value), "aria-label": `Angle for ${edge.id}` }), _jsx("input", { type: "number", min: min, max: max, step: 1, value: edge.angleDeg, onChange: (e) => setEdgeAngle(edge.id, e.target.value), "aria-label": `Numeric angle for ${edge.id}`, style: { width: "4rem" } }), _jsxs("select", { value: edge.direction ?? "", onChange: (e) => {
+                                const v = e.target.value;
+                                if (v === "mountain" || v === "valley") {
+                                    setEdgeDirection(edge.id, v);
+                                }
+                                else if (v === "") {
+                                    setEdgeDirection(edge.id, undefined);
+                                }
+                            }, "aria-label": `Fold direction for ${edge.id}`, children: [_jsx("option", { value: "", children: "\u2014" }), _jsx("option", { value: "mountain", children: "mountain" }), _jsx("option", { value: "valley", children: "valley" })] })] }, edge.id))) })] }));
+}
+//# sourceMappingURL=FoldEditorPanel.js.map

package/dist/components/FoldEditorPanel.js.map

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

package/dist/components/FoldPreviewOverlay.d.ts

@@ -0,0 +1,48 @@
+import { type FoldGeometryConfig, type FoldGeometryPanelMetadata } from "../lib/fold-geometry";
+/**
+ * S4 — 3D fold preview overlay (Wave 2 PR-3 scaffold).
+ *
+ * Renders a Three.js scene of the dieline's panels in 3D space.
+ * The PR-3 scaffold ships a *flat* preview (every panel at Z=0)
+ * with the hinge axes drawn in colored lines so the operator can
+ * see where folds will happen. Interactive fold-angle scrubbing
+ * lands in PR-4.
+ *
+ * Bundle note: Three.js is a hard dependency (~150 KB) so hosts
+ * paying for the editor get fold preview out of the box. Hosts that
+ * never need it can disable via {@link EditorConfig.enable_3d_fold_preview}
+ * — when the flag is `false`, this component is never rendered and
+ * the Three.js code path stays cold, but the symbols still ship
+ * with the bundle. A future refactor may switch to a dynamic
+ * `import("three")` for tighter chunking; that's deferred until the
+ * editor's bundle profile shows it's worth the complexity.
+ *
+ * The Three.js scene is owned by this component — it creates the
+ * renderer / scene / camera on mount, recomputes geometry on prop
+ * change, and disposes on unmount. Hosts get a controlled component:
+ * pass `panelMetadata` + `foldConfig`, get a rendered scene.
+ *
+ * @public
+ */
+export type FoldPreviewOverlayProps = {
+    /** Panel registry derived from the active page's dieline.
+     *  Structurally compatible with `document-model`'s `PanelMetadata`.
+     *  When `undefined`, the overlay no-ops (renders an empty container). */
+    panelMetadata: FoldGeometryPanelMetadata | undefined;
+    /** Fold-edge config for the active page. Structurally compatible
+     *  with `document-model`'s `FoldConfig`. When `undefined`, panels
+     *  are still rendered (flat layout), but no hinge lines appear. */
+    foldConfig?: FoldGeometryConfig | undefined;
+    /** Container dimensions in CSS pixels. */
+    width: number;
+    height: number;
+    /** Optional background color for the 3D viewport (CSS color
+     *  string). Defaults to a transparent canvas so the overlay can
+     *  layer over the editor's existing chrome. */
+    backgroundColor?: string;
+};
+/**
+ * @public
+ */
+export declare function FoldPreviewOverlay({ panelMetadata, foldConfig, width, height, backgroundColor, }: FoldPreviewOverlayProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FoldPreviewOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FoldPreviewOverlay.d.ts","sourceRoot":"","sources":["../../src/components/FoldPreviewOverlay.tsx"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAG/B,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;6EAEyE;IACzE,aAAa,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACrD;;uEAEmE;IACnE,UAAU,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC5C,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;mDAE+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,aAAa,EACb,UAAU,EACV,KAAK,EACL,MAAM,EACN,eAAe,GAChB,EAAE,uBAAuB,2CA6FzB"}

package/dist/components/FoldPreviewOverlay.js

@@ -0,0 +1,182 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { buildFoldScene, } from "../lib/fold-geometry";
+/**
+ * @public
+ */
+export function FoldPreviewOverlay({ panelMetadata, foldConfig, width, height, backgroundColor, }) {
+    const containerRef = useRef(null);
+    const sceneRef = useRef(null);
+    // Hold the latest props in a ref so the mount effect's initial
+    // scene picks them up without depending on them — depending on
+    // `panelMetadata` / `foldConfig` here would tear down + recreate
+    // the renderer on every edit, defeating the per-update apply path
+    // in the second effect.
+    const propsRef = useRef({ panelMetadata, foldConfig });
+    propsRef.current = { panelMetadata, foldConfig };
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        // Guard zero / negative dimensions — `setSize(0, 0)` produces a
+        // degenerate canvas and `width / height` on the camera becomes
+        // NaN/Infinity. Layout transitions can briefly hit this during
+        // mount; defer scene creation until both dims are positive.
+        if (width <= 0 || height <= 0)
+            return;
+        let runtime = null;
+        let disposed = false;
+        (async () => {
+            const three = await import("three");
+            if (disposed)
+                return;
+            const created = await createScene(three, container, width, height, backgroundColor);
+            // Re-check after the second await — cleanup may have fired
+            // during `await createScene(...)`. At that point `runtime` was
+            // still null in the cleanup closure, so it couldn't dispose;
+            // do it here ourselves before the renderer / canvas escape.
+            if (disposed) {
+                disposeScene(created);
+                return;
+            }
+            runtime = created;
+            sceneRef.current = runtime;
+            const { panelMetadata: pm, foldConfig: fc } = propsRef.current;
+            const spec = pm ? buildFoldScene(pm, fc) : EMPTY_SCENE;
+            applyScene(three, runtime, spec);
+            // Render-on-change: PR-3's scaffold is static, so one draw per
+            // mutation is enough. PR-4 swaps this for a RAF loop driven by
+            // user interaction (drag-to-fold), so the loop machinery isn't
+            // worth keeping cold here.
+            runtime.renderer.render(runtime.scene, runtime.camera);
+        })().catch((err) => {
+            // Swallow rejections after unmount; surface real errors during
+            // mount (chunk-load failures from `import("three")`, WebGL
+            // context creation failure, etc.) via console so devtools can
+            // catch them.
+            if (!disposed)
+                console.error("[FoldPreviewOverlay] scene init failed", err);
+        });
+        return () => {
+            disposed = true;
+            sceneRef.current = null;
+            if (runtime)
+                disposeScene(runtime);
+        };
+    }, [width, height, backgroundColor]);
+    useEffect(() => {
+        const runtime = sceneRef.current;
+        if (!runtime)
+            return;
+        let disposed = false;
+        (async () => {
+            const three = await import("three");
+            if (disposed)
+                return;
+            // When panelMetadata becomes undefined, apply an empty scene
+            // so previously rendered meshes / hinges clear off the canvas —
+            // matches the documented no-op behaviour for absent metadata.
+            const spec = panelMetadata ? buildFoldScene(panelMetadata, foldConfig) : EMPTY_SCENE;
+            applyScene(three, runtime, spec);
+            runtime.renderer.render(runtime.scene, runtime.camera);
+        })().catch((err) => {
+            if (!disposed)
+                console.error("[FoldPreviewOverlay] scene update failed", err);
+        });
+        return () => {
+            disposed = true;
+        };
+    }, [panelMetadata, foldConfig]);
+    return (_jsx("div", { ref: containerRef, "data-testid": "fold-preview-overlay", style: {
+            position: "relative",
+            width,
+            height,
+            pointerEvents: "auto",
+        } }));
+}
+/** Empty scene spec used to clear the canvas when `panelMetadata`
+ *  is absent. Keeps the meshes / hinges from a previous render off
+ *  the screen. */
+const EMPTY_SCENE = {
+    panels: [],
+    hinges: [],
+    bounds: { min: [0, 0, 0], max: [0, 0, 0] },
+};
+async function createScene(three, container, width, height, backgroundColor) {
+    const renderer = new three.WebGLRenderer({ antialias: true, alpha: !backgroundColor });
+    renderer.setSize(width, height);
+    renderer.setPixelRatio(typeof window !== "undefined" ? window.devicePixelRatio : 1);
+    container.replaceChildren(renderer.domElement);
+    const scene = new three.Scene();
+    if (backgroundColor) {
+        scene.background = new three.Color(backgroundColor);
+    }
+    const camera = new three.PerspectiveCamera(45, width / height, 0.1, 10000);
+    camera.position.set(0, 0, 500);
+    const light = new three.HemisphereLight(0xffffff, 0x202020, 1);
+    scene.add(light);
+    const panelGroup = new three.Group();
+    const hingeGroup = new three.Group();
+    scene.add(panelGroup, hingeGroup);
+    const runtime = {
+        renderer,
+        scene,
+        camera,
+        panelGroup,
+        hingeGroup,
+        resources: [],
+    };
+    return runtime;
+}
+function applyScene(three, runtime, spec) {
+    // Tear down previous geometry without disposing the renderer.
+    runtime.panelGroup.clear();
+    runtime.hingeGroup.clear();
+    for (const r of runtime.resources)
+        r.dispose?.();
+    runtime.resources = [];
+    for (const panel of spec.panels) {
+        const geo = new three.BufferGeometry();
+        const positions = new Float32Array(panel.corners.flatMap((c) => [c[0], c[1], c[2]]));
+        geo.setAttribute("position", new three.BufferAttribute(positions, 3));
+        geo.setIndex([0, 1, 2, 0, 2, 3]);
+        geo.computeVertexNormals();
+        const mat = new three.MeshStandardMaterial({
+            color: 0xe6e6e6,
+            side: three.DoubleSide,
+            roughness: 0.6,
+            metalness: 0.0,
+        });
+        runtime.panelGroup.add(new three.Mesh(geo, mat));
+        runtime.resources.push(geo, mat);
+    }
+    for (const hinge of spec.hinges) {
+        const geo = new three.BufferGeometry().setFromPoints([
+            new three.Vector3(hinge.from[0], hinge.from[1], hinge.from[2]),
+            new three.Vector3(hinge.to[0], hinge.to[1], hinge.to[2]),
+        ]);
+        const mat = new three.LineBasicMaterial({
+            color: hinge.direction === "mountain" ? 0x2563eb : 0xdc2626,
+            linewidth: 2,
+        });
+        runtime.hingeGroup.add(new three.Line(geo, mat));
+        runtime.resources.push(geo, mat);
+    }
+    // Frame the camera around the scene bounds.
+    const { min, max } = spec.bounds;
+    const cx = (min[0] + max[0]) / 2;
+    const cy = (min[1] + max[1]) / 2;
+    const span = Math.max(max[0] - min[0], max[1] - min[1], 1);
+    runtime.camera.position.set(cx, cy, span * 1.2);
+    runtime.camera.lookAt(cx, cy, 0);
+}
+function disposeScene(runtime) {
+    for (const r of runtime.resources)
+        r.dispose?.();
+    runtime.resources = [];
+    runtime.renderer.dispose?.();
+    runtime.renderer.domElement?.parentElement?.removeChild(runtime.renderer.domElement);
+}
+//# sourceMappingURL=FoldPreviewOverlay.js.map

package/dist/components/FoldPreviewOverlay.js.map

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

package/dist/components/Gs1DigitalLinkPanel.d.ts

@@ -0,0 +1,103 @@
+import type { BarcodeRenderFn, BarcodeRenderResult } from "./BarcodeGeneratorPanel";
+/**
+ * One additional GS1 Application Identifier carried in either the URL
+ * path or query string. `ai` is the numeric AI (e.g. `"10"` for lot,
+ * `"17"` for expiration date `YYMMDD`); `value` is the raw payload
+ * before percent-encoding.
+ *
+ * The composer percent-encodes `value` automatically; callers should
+ * pass the human-readable form.
+ *
+ * @public
+ */
+export type Gs1AiEntry = {
+    ai: string;
+    value: string;
+};
+/**
+ * Result returned by {@link composeGs1DigitalLink}. `url` is the
+ * canonical GS1 Digital Link form ready to be QR-encoded;
+ * `pathSegment` and `querySegment` are the split halves the host can
+ * surface separately (e.g. a "preview" UI that highlights mandatory
+ * vs. optional segments).
+ *
+ * @public
+ */
+export type Gs1DigitalLinkResult = {
+    url: string;
+    pathSegment: string;
+    querySegment: string;
+};
+/**
+ * @public
+ */
+export type Gs1DigitalLinkPanelProps = {
+    /** Optional renderer (typically the same adapter wired for
+     *  {@link import("./BarcodeGeneratorPanel").BarcodeGeneratorPanel}).
+     *  When supplied, "Generate QR" calls it with `format: "QR"` and the
+     *  composed Digital Link URL; the bitmap flows to `onRendered`. When
+     *  absent, the panel only emits the URL via `onLink`. */
+    renderer?: BarcodeRenderFn;
+    /** Fired when the user clicks **Preview URL** or **Generate QR**
+     *  with the composed URL. The panel does not fire on every
+     *  keystroke — hosts that want live preview should poll the
+     *  current form values via their own state or wrap
+     *  {@link composeGs1DigitalLink} themselves. */
+    onLink?: (result: Gs1DigitalLinkResult) => void;
+    /** Fired with the rendered bitmap when the host has wired a
+     *  `renderer` and the user clicks "Generate QR". */
+    onRendered?: (result: BarcodeRenderResult) => void;
+    /** Default resolver domain — typically `"id.gs1.org"` or a
+     *  brand-owned alternate. Defaults to `"id.gs1.org"` (the GS1
+     *  community default) when omitted. */
+    defaultDomain?: string;
+};
+/**
+ * The GS1 community-default resolver domain. Re-exported for hosts
+ * that want to display it as a hint or seed a settings UI.
+ *
+ * @public
+ */
+export declare const DEFAULT_GS1_DOMAIN = "id.gs1.org";
+/**
+ * Validate a GS1 AI 17 (expiration date) value: must be exactly six
+ * digits in `YYMMDD` order with month 1-12 and a real calendar day.
+ * Year is two digits per the GS1 spec so the validator checks the
+ * day against an arbitrary 21st-century year — the year value itself
+ * does not constrain the calendar.
+ *
+ * Exported alongside {@link composeGs1DigitalLink} so server-side
+ * callers can reject invalid expiries before composing.
+ *
+ * @public
+ */
+export declare function isValidGs1Ai17(value: string): boolean;
+/**
+ * Compose a canonical GS1 Digital Link URL from a GTIN + optional
+ * path-AIs + optional query-AIs. Pure function — exported so server
+ * components (Next.js RSC, Astro frontmatter) can pre-compute URLs
+ * without bundling the panel.
+ *
+ * Path-AI order is `22 → 10 → 21` per the GS1 Digital Link Standard;
+ * any other AIs flow into the query string in the order supplied.
+ *
+ * @public
+ */
+export declare function composeGs1DigitalLink(input: {
+    domain: string;
+    gtin: string;
+    pathAis?: readonly Gs1AiEntry[];
+    queryAis?: readonly Gs1AiEntry[];
+}): Gs1DigitalLinkResult;
+/**
+ * GS1 Digital Link composer panel. The user picks a domain, types a
+ * GTIN, optionally adds CPV / lot / serial path-AIs and free-form
+ * query-AIs; the panel emits the composed URL via `onLink`. When the
+ * host wires a `renderer`, a "Generate QR" button hands the URL to
+ * the adapter with `format: "QR"` and forwards the bitmap to
+ * `onRendered`.
+ *
+ * @public
+ */
+export declare function Gs1DigitalLinkPanel({ renderer, onLink, onRendered, defaultDomain, }: Gs1DigitalLinkPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Gs1DigitalLinkPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Gs1DigitalLinkPanel.d.ts","sourceRoot":"","sources":["../../src/components/Gs1DigitalLinkPanel.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;6DAIyD;IACzD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;oDAIgD;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAChD;wDACoD;IACpD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD;;2CAEuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAI/C;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAClC,GAAG,oBAAoB,CA6BvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,UAAU,EACV,aAAkC,GACnC,EAAE,wBAAwB,2CA6K1B"}