@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.3.0

package/dist/components/DesignSuggestionsPanel.js

@@ -0,0 +1,154 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+/**
+ * Canonical category order — typography is the first thing a human
+ * eye lands on; "other" is the escape hatch at the tail.
+ *
+ * @public
+ */
+export const DESIGN_SUGGESTION_CATEGORY_ORDER = [
+    "typography",
+    "color",
+    "contrast",
+    "layout",
+    "imagery",
+    "other",
+];
+const CATEGORY_LABELS = {
+    typography: "Typography",
+    color: "Color",
+    contrast: "Contrast",
+    layout: "Layout",
+    imagery: "Imagery",
+    other: "Other",
+};
+/**
+ * Pure helper — filters suggestions by category / minConfidence.
+ * Returns a new array; preserves input order. Pure function.
+ *
+ * @public
+ */
+export function filterDesignSuggestions(suggestions, filter) {
+    const min = filter.minConfidence ?? 0;
+    return suggestions.filter((s) => {
+        if (filter.category && s.category !== filter.category)
+            return false;
+        if (min > 0) {
+            if (typeof s.confidence !== "number" || s.confidence < min)
+                return false;
+        }
+        return true;
+    });
+}
+/**
+ * Pure helper — groups suggestions by category in
+ * {@link DESIGN_SUGGESTION_CATEGORY_ORDER}. Returns a stable
+ * six-bucket shape so renderers iterate without absent-key checks.
+ * Unknown runtime categories fall into "other" rather than being
+ * dropped (defensive against forward-compat catalogue extensions).
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export function groupDesignSuggestionsByCategory(suggestions) {
+    const buckets = new Map(DESIGN_SUGGESTION_CATEGORY_ORDER.map((c) => [c, []]));
+    for (const s of suggestions) {
+        const bucket = buckets.get(s.category) ?? buckets.get("other");
+        bucket?.push(s);
+    }
+    return DESIGN_SUGGESTION_CATEGORY_ORDER.map((category) => ({
+        category,
+        suggestions: buckets.get(category) ?? [],
+    }));
+}
+/**
+ * Stateful panel — loads the suggestion stream on mount, exposes a
+ * category filter + min-confidence slider, and emits `onApply` /
+ * `onDismiss`. Handles loading / error / empty states inline.
+ *
+ * @public
+ */
+export function DesignSuggestionsPanel({ loader, defaultMinConfidence, onApply, onDismiss, }) {
+    const [suggestions, setSuggestions] = useState(null);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [category, setCategory] = useState("all");
+    const [minConfidence, setMinConfidence] = useState(defaultMinConfidence ?? 0);
+    useEffect(() => {
+        let disposed = false;
+        setLoading(true);
+        setError(null);
+        setSuggestions(null);
+        void (async () => {
+            try {
+                const next = await loader();
+                if (disposed)
+                    return;
+                setSuggestions(next);
+            }
+            catch (err) {
+                if (disposed)
+                    return;
+                setError(err instanceof Error ? err.message : String(err));
+            }
+            finally {
+                if (!disposed)
+                    setLoading(false);
+            }
+        })();
+        return () => {
+            disposed = true;
+        };
+    }, [loader]);
+    const visibleGroups = useMemo(() => {
+        if (!suggestions)
+            return null;
+        const filtered = filterDesignSuggestions(suggestions, {
+            ...(category !== "all" && { category }),
+            minConfidence,
+        });
+        return groupDesignSuggestionsByCategory(filtered);
+    }, [suggestions, category, minConfidence]);
+    if (loading) {
+        return (_jsx("div", { "data-testid": "design-suggestions-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Loading suggestions\u2026" }));
+    }
+    if (error) {
+        return (_jsxs("div", { "data-testid": "design-suggestions-panel", role: "alert", style: { padding: "0.5rem", color: "#a00" }, children: ["Couldn't load design suggestions: ", error] }));
+    }
+    if (!visibleGroups)
+        return _jsx("div", { "data-testid": "design-suggestions-panel" });
+    const totalVisible = visibleGroups.reduce((s, g) => s + g.suggestions.length, 0);
+    return (_jsxs("div", { "data-testid": "design-suggestions-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: { marginBottom: "0.5rem" }, children: [_jsxs("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: ["Design suggestions (", totalVisible, ")"] }), _jsxs("div", { style: { display: "flex", gap: "0.5rem", marginTop: "0.25rem", alignItems: "center" }, children: [_jsxs("label", { style: { fontSize: "0.75rem" }, children: ["Category", _jsxs("select", { "aria-label": "Category", value: category, onChange: (e) => setCategory(e.target.value), style: { marginLeft: "0.25rem", fontSize: "0.75rem" }, children: [_jsx("option", { value: "all", children: "All" }), DESIGN_SUGGESTION_CATEGORY_ORDER.map((c) => (_jsx("option", { value: c, children: CATEGORY_LABELS[c] }, c)))] })] }), _jsxs("label", { style: { fontSize: "0.75rem", flex: 1 }, children: ["Min confidence: ", minConfidence.toFixed(2), _jsx("input", { type: "range", "aria-label": "Min confidence", min: 0, max: 1, step: 0.05, value: minConfidence, onChange: (e) => setMinConfidence(Number(e.target.value)), style: { display: "block", width: "100%" } })] })] })] }), totalVisible === 0 && (_jsx("div", { "data-testid": "design-suggestions-panel-empty", style: { opacity: 0.6, fontSize: "0.875rem" }, children: "No suggestions match the current filter." })), visibleGroups.map((group) => {
+                if (group.suggestions.length === 0)
+                    return null;
+                return (_jsxs("section", { "data-testid": `design-suggestions-group-${group.category}`, style: { marginBottom: "0.75rem" }, children: [_jsxs("h4", { style: {
+                                margin: "0 0 0.25rem 0",
+                                fontSize: "0.75rem",
+                                color: "#666",
+                                textTransform: "uppercase",
+                                letterSpacing: "0.05em",
+                            }, children: [CATEGORY_LABELS[group.category], " (", group.suggestions.length, ")"] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: group.suggestions.map((s) => (_jsx(DesignSuggestionRow, { suggestion: s, onApply: onApply, onDismiss: onDismiss }, s.id))) })] }, group.category));
+            })] }));
+}
+/**
+ * Renders one suggestion row inside a category group. Intra-package
+ * helper — the row's surface is intentionally minimal (summary +
+ * optional description + optional confidence chip + apply / dismiss
+ * buttons) so {@link DesignSuggestionsPanel} can swap it without
+ * downstream consumers depending on the shape.
+ */
+function DesignSuggestionRow({ suggestion, onApply, onDismiss, }) {
+    return (_jsxs("li", { style: {
+            display: "flex",
+            gap: "0.5rem",
+            alignItems: "flex-start",
+            padding: "0.375rem 0.5rem",
+            border: "1px solid #ddd",
+            borderRadius: 4,
+            marginBottom: "0.25rem",
+        }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: { fontSize: "0.8125rem", fontWeight: 500 }, children: suggestion.summary }), suggestion.description && (_jsx("div", { style: { fontSize: "0.75rem", color: "#666", marginTop: "0.125rem" }, children: suggestion.description })), typeof suggestion.confidence === "number" && (_jsxs("div", { style: { fontSize: "0.6875rem", color: "#595959", marginTop: "0.125rem" }, children: ["confidence ", suggestion.confidence.toFixed(2)] }))] }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "0.125rem" }, children: [onApply && (_jsx("button", { type: "button", onClick: () => onApply(suggestion), style: { fontSize: "0.75rem", padding: "0.125rem 0.5rem" }, children: "Apply" })), onDismiss && (_jsx("button", { type: "button", onClick: () => onDismiss(suggestion), style: { fontSize: "0.75rem", padding: "0.125rem 0.5rem" }, children: "Dismiss" }))] })] }));
+}
+//# sourceMappingURL=DesignSuggestionsPanel.js.map

package/dist/components/DesignSuggestionsPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignSuggestionsPanel.js","sourceRoot":"","sources":["../../src/components/DesignSuggestionsPanel.tsx"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAyBb,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA+ErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwC;IACnF,YAAY;IACZ,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;CACR,CAAC;AAEF,MAAM,eAAe,GAA6C;IAChE,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAwC,EACxC,MAA8B;IAE9B,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;IACtC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpE,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACZ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,GAAG,GAAG;gBAAE,OAAO,KAAK,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gCAAgC,CAC9C,WAAwC;IAExC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,gCAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CACrD,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,gCAAgC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzD,QAAQ;QACR,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;KACzC,CAAC,CAAC,CAAC;AACN,CAAC;AA4BD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,oBAAoB,EACpB,OAAO,EACP,SAAS,GACmB;IAC5B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAqC,IAAI,CAAC,CAAC;IACzF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAmC,KAAK,CAAC,CAAC;IAClF,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC;IAE9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC;gBAC5B,IAAI,QAAQ;oBAAE,OAAO;gBACrB,cAAc,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ;oBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,GAAG,EAAE;YACV,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE;YACpD,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC;YACvC,aAAa;SACd,CAAC,CAAC;QACH,OAAO,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAE3C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,6BAAiB,0BAA0B,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,0CAEhF,CACP,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,8BACc,0BAA0B,EACtC,IAAI,EAAC,OAAO,EACZ,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,mDAER,KAAK,IACpC,CACP,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,aAAa;QAAE,OAAO,6BAAiB,0BAA0B,GAAG,CAAC;IAE1E,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,CACL,8BAAiB,0BAA0B,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aACtE,kBAAQ,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,aACvC,cAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,qCAAuB,YAAY,SAAO,EACxF,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,aACxF,iBAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,yBAEnC,gCACa,UAAU,EACrB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAyC,CAAC,EAChF,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,aAErD,iBAAQ,KAAK,EAAC,KAAK,oBAAa,EAC/B,gCAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC3C,iBAAgB,KAAK,EAAE,CAAC,YACrB,eAAe,CAAC,CAAC,CAAC,IADR,CAAC,CAEL,CACV,CAAC,IACK,IACH,EACR,iBAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,iCAC3B,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EACzC,gBACE,IAAI,EAAC,OAAO,gBACD,gBAAgB,EAC3B,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAC1C,IACI,IACJ,IACC,EACR,YAAY,KAAK,CAAC,IAAI,CACrB,6BACc,gCAAgC,EAC5C,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,yDAGzC,CACP,EACA,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC3B,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAChD,OAAO,CACL,kCAEe,4BAA4B,KAAK,CAAC,QAAQ,EAAE,EACzD,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,aAElC,cACE,KAAK,EAAE;gCACL,MAAM,EAAE,eAAe;gCACvB,QAAQ,EAAE,SAAS;gCACnB,KAAK,EAAE,MAAM;gCACb,aAAa,EAAE,WAAW;gCAC1B,aAAa,EAAE,QAAQ;6BACxB,aAEA,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAI,KAAK,CAAC,WAAW,CAAC,MAAM,SACzD,EACL,aAAI,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,YACpD,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC5B,KAAC,mBAAmB,IAElB,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,IAHf,CAAC,CAAC,EAAE,CAIT,CACH,CAAC,GACC,KAxBA,KAAK,CAAC,QAAQ,CAyBX,CACX,CAAC;YACJ,CAAC,CAAC,IACE,CACP,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,EAC3B,UAAU,EACV,OAAO,EACP,SAAS,GAKV;IACC,OAAO,CACL,cACE,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,QAAQ;YACb,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,iBAAiB;YAC1B,MAAM,EAAE,gBAAgB;YACxB,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,SAAS;SACxB,aAED,eAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,aACrB,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,YAAG,UAAU,CAAC,OAAO,GAAO,EACjF,UAAU,CAAC,WAAW,IAAI,CACzB,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YACtE,UAAU,CAAC,WAAW,GACnB,CACP,EACA,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,IAAI,CAC5C,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,4BAChE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IACxC,CACP,IACG,EACN,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,aACtE,OAAO,IAAI,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAClC,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,sBAGnD,CACV,EACA,SAAS,IAAI,CACZ,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EACpC,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,wBAGnD,CACV,IACG,IACH,CACN,CAAC;AACJ,CAAC"}

package/dist/components/DielineParametersPanel.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Editable dieline parameters. All values are in **mm**; the
+ * conversion to PDF points happens at the regen step. `depthMm` is
+ * optional because flat dielines (labels, postcards) don't carry a
+ * third dimension.
+ *
+ * @public
+ */
+export type DielineParameters = {
+    widthMm: number;
+    heightMm: number;
+    depthMm?: number;
+    bleedMm: number;
+};
+/**
+ * @public
+ */
+export type DielineParametersPanelProps = {
+    /** Current parameters. `undefined` means "no parametric template
+     *  loaded" — the panel shows a placeholder. */
+    value: DielineParameters | undefined;
+    /** Fires on every committed change. Hosts debounce externally if
+     *  the regen step is expensive. */
+    onChange: (next: DielineParameters) => void;
+    /** Fires when the user *finishes* editing a field (input blur or
+     *  Enter key). Distinct from `onChange` which fires on every
+     *  keystroke. Hosts wire this into their undo stack so a 50→500
+     *  width drag commits as one history entry rather than 451. */
+    onCommit?: (next: DielineParameters) => void;
+    /** Optional inclusive bounds for the numeric inputs. Defaults are
+     *  conservative (1 - 2000 mm); hosts that ship a stricter
+     *  parametric generator pass tighter bounds so the input clamps
+     *  before reaching the generator. */
+    minWidthMm?: number;
+    maxWidthMm?: number;
+    minHeightMm?: number;
+    maxHeightMm?: number;
+    minDepthMm?: number;
+    maxDepthMm?: number;
+    /** When `true`, hides the depth input even if `value.depthMm` is
+     *  set. Useful for flat-only contexts (labels, postcards). */
+    hideDepth?: boolean;
+    /** When `true`, hides the live preview thumbnail. Useful for
+     *  tight UI surfaces or when the host already renders its own
+     *  preview elsewhere. */
+    hidePreview?: boolean;
+};
+/**
+ * Compute validation warnings for a set of dieline parameters.
+ *
+ * Exported so hosts that want to mirror the panel's validation
+ * surface (e.g. a sticky banner above the canvas) can call the
+ * same check function without re-implementing the rules.
+ *
+ * @public
+ */
+export declare function validateDielineParameters(value: DielineParameters): string[];
+/**
+ * @public
+ */
+export declare function DielineParametersPanel({ value, onChange, onCommit, minWidthMm, maxWidthMm, minHeightMm, maxHeightMm, minDepthMm, maxDepthMm, hideDepth, hidePreview, }: DielineParametersPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DielineParametersPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DielineParametersPanel.d.ts","sourceRoot":"","sources":["../../src/components/DielineParametersPanel.tsx"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;mDAC+C;IAC/C,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC;uCACmC;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C;;;mEAG+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C;;;yCAGqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;kEAC8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;6BAEyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAcF;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAkB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,GACZ,EAAE,2BAA2B,2CAmL7B"}

package/dist/components/DielineParametersPanel.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from "react";
+const DEFAULT_MIN_MM = 1;
+const DEFAULT_MAX_MM = 2000;
+const MAX_BLEED_MM = 20;
+/** When bleed exceeds this fraction of the shorter trim dimension,
+ *  the panel surfaces a warning — at 50% the bleed ring is bigger
+ *  than the trim and most parametric generators reject it. */
+const BLEED_WARN_FRACTION = 0.5;
+/** SVG preview canvas size in CSS pixels. The dieline scales to
+ *  fit; the size is fixed so the panel layout stays stable as the
+ *  user changes dimensions. */
+const PREVIEW_SIZE_PX = 120;
+/**
+ * Compute validation warnings for a set of dieline parameters.
+ *
+ * Exported so hosts that want to mirror the panel's validation
+ * surface (e.g. a sticky banner above the canvas) can call the
+ * same check function without re-implementing the rules.
+ *
+ * @public
+ */
+export function validateDielineParameters(value) {
+    const warnings = [];
+    const minTrim = Math.min(value.widthMm, value.heightMm);
+    // Both checks guard on `minTrim > 0` so partial mid-edit values
+    // (e.g. user clears a field momentarily) don't flash spurious
+    // warnings. Once both width and height are populated, the
+    // guard releases and validation fires normally.
+    if (minTrim > 0 && value.bleedMm > minTrim * BLEED_WARN_FRACTION) {
+        warnings.push(`Bleed ${value.bleedMm} mm exceeds ${(BLEED_WARN_FRACTION * 100).toFixed(0)}% of the shorter trim (${minTrim} mm) — most parametric generators will reject this.`);
+    }
+    if (minTrim > 0 && value.depthMm !== undefined && value.depthMm > minTrim) {
+        warnings.push(`Depth ${value.depthMm} mm exceeds the shorter trim ${minTrim} mm — the carton would not close.`);
+    }
+    return warnings;
+}
+/**
+ * @public
+ */
+export function DielineParametersPanel({ value, onChange, onCommit, minWidthMm, maxWidthMm, minHeightMm, maxHeightMm, minDepthMm, maxDepthMm, hideDepth, hidePreview, }) {
+    const bounds = useMemo(() => ({
+        width: {
+            min: minWidthMm ?? DEFAULT_MIN_MM,
+            max: maxWidthMm ?? DEFAULT_MAX_MM,
+        },
+        height: {
+            min: minHeightMm ?? DEFAULT_MIN_MM,
+            max: maxHeightMm ?? DEFAULT_MAX_MM,
+        },
+        depth: {
+            min: minDepthMm ?? DEFAULT_MIN_MM,
+            max: maxDepthMm ?? DEFAULT_MAX_MM,
+        },
+    }), [minWidthMm, maxWidthMm, minHeightMm, maxHeightMm, minDepthMm, maxDepthMm]);
+    // `warnings` recomputes only when `value` changes — the validation
+    // rules don't depend on bounds so we don't pull them into the dep
+    // array. Computing here (not inside the JSX) lets the empty case
+    // fast-path the no-warning render.
+    const warnings = useMemo(() => (value ? validateDielineParameters(value) : []), [value]);
+    // Track the value as of the last commit so blur on an untouched
+    // field doesn't push a duplicate history entry to the host.
+    // `value` is recreated by `onChange` on every keystroke (via the
+    // spread in `set`), so a reference compare is sufficient.
+    const lastCommittedRef = useRef(value);
+    if (!value) {
+        return (_jsx("div", { "data-testid": "dieline-parameters-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Load a parametric dieline to edit its dimensions." }));
+    }
+    const set = (patch) => {
+        onChange({ ...value, ...patch });
+    };
+    const commit = () => {
+        // Skip if the value hasn't changed since the last commit —
+        // blur on an untouched field shouldn't fire an undo-stack
+        // entry. Reference compare is safe because `set` recreates
+        // the object on every keystroke.
+        if (value === lastCommittedRef.current)
+            return;
+        lastCommittedRef.current = value;
+        onCommit?.(value);
+    };
+    // Enter inside a numeric input should commit the same way blur
+    // does — matches the contract documented on `onCommit` and keeps
+    // keyboard-only users from being stuck in a "no commit ever
+    // fires" state when they tab through fields with `Enter`.
+    const commitOnEnter = (e) => {
+        if (e.key === "Enter")
+            commit();
+    };
+    // Parse a numeric input, clamping to [min, max]. Empty / `NaN`
+    // returns `null` so callers can decide what to do — width/height/
+    // bleed treat that as a no-op (host keeps the last good value
+    // while the user is mid-edit), so `Number("")` no longer leaks
+    // `NaN` through `onChange`.
+    const parseClamped = (raw, min, max) => {
+        if (raw === "")
+            return null;
+        const n = Number(raw);
+        if (!Number.isFinite(n))
+            return null;
+        return Math.min(Math.max(n, min), max);
+    };
+    return (_jsxs("div", { "data-testid": "dieline-parameters-panel", style: { padding: "0.5rem" }, children: [_jsx("h3", { style: { margin: "0 0 0.5rem 0" }, children: "Dieline parameters" }), _jsxs("div", { style: { display: "grid", gridTemplateColumns: "auto 1fr", gap: "0.25rem 0.5rem" }, children: [_jsx("label", { htmlFor: "dieline-width", children: "Width (mm)" }), _jsx("input", { id: "dieline-width", type: "number", step: "0.1", min: bounds.width.min, max: bounds.width.max, value: value.widthMm, onChange: (e) => {
+                            const next = parseClamped(e.target.value, bounds.width.min, bounds.width.max);
+                            if (next !== null)
+                                set({ widthMm: next });
+                        }, onBlur: commit, onKeyDown: commitOnEnter, "aria-label": "Width in millimetres" }), _jsx("label", { htmlFor: "dieline-height", children: "Height (mm)" }), _jsx("input", { id: "dieline-height", type: "number", step: "0.1", min: bounds.height.min, max: bounds.height.max, value: value.heightMm, onChange: (e) => {
+                            const next = parseClamped(e.target.value, bounds.height.min, bounds.height.max);
+                            if (next !== null)
+                                set({ heightMm: next });
+                        }, onBlur: commit, onKeyDown: commitOnEnter, "aria-label": "Height in millimetres" }), !hideDepth && (_jsxs(_Fragment, { children: [_jsx("label", { htmlFor: "dieline-depth", children: "Depth (mm)" }), _jsx("input", { id: "dieline-depth", type: "number", step: "0.1", min: bounds.depth.min, max: bounds.depth.max, value: value.depthMm ?? "", onChange: (e) => {
+                                    const raw = e.target.value;
+                                    if (raw === "") {
+                                        // Empty input clears the depth — surfaces as
+                                        // `undefined` to the host so flat dielines stay flat.
+                                        const { depthMm: _omit, ...rest } = value;
+                                        onChange(rest);
+                                        return;
+                                    }
+                                    const next = parseClamped(raw, bounds.depth.min, bounds.depth.max);
+                                    if (next !== null)
+                                        set({ depthMm: next });
+                                }, onBlur: commit, onKeyDown: commitOnEnter, "aria-label": "Depth in millimetres", placeholder: "\u2014" })] })), _jsx("label", { htmlFor: "dieline-bleed", children: "Bleed (mm)" }), _jsx("input", { id: "dieline-bleed", type: "number", step: "0.1", min: 0, max: MAX_BLEED_MM, value: value.bleedMm, onChange: (e) => {
+                            const next = parseClamped(e.target.value, 0, MAX_BLEED_MM);
+                            if (next !== null)
+                                set({ bleedMm: next });
+                        }, onBlur: commit, onKeyDown: commitOnEnter, "aria-label": "Bleed in millimetres" })] }), warnings.length > 0 && (_jsx("ul", { "data-testid": "dieline-parameters-warnings", role: "alert", style: {
+                    margin: "0.5rem 0 0 0",
+                    padding: "0.4rem 0.6rem 0.4rem 1.2rem",
+                    background: "#fff8e1",
+                    border: "1px solid #f0c419",
+                    borderRadius: 4,
+                    color: "#8a6d00",
+                    fontSize: "0.85rem",
+                }, children: warnings.map((w) => (_jsx("li", { children: w }, w))) })), !hidePreview && _jsx(DielineParametersPreview, { value: value, sizePx: PREVIEW_SIZE_PX })] }));
+}
+/**
+ * Live preview thumbnail rendered as inline SVG.
+ *
+ * Shows the trim box (black outline) and the bleed margin (dashed
+ * red outline) scaled to fit `sizePx`. When `depthMm` is set, a
+ * proportional side panel renders to the right of the trim so users
+ * can see the 3D aspect at a glance. SVG (not Konva) keeps the
+ * preview lightweight, screenreader-accessible, and renderable in
+ * SSR contexts where a Konva Stage would need a browser canvas.
+ */
+function DielineParametersPreview({ value, sizePx, }) {
+    // Compute scale-to-fit so the longest outer dimension (trim +
+    // bleed on both sides, plus the depth flap if present) maps to
+    // `sizePx - 8` (leaving an 8px gutter for the preview frame).
+    const outerWidth = value.widthMm + 2 * value.bleedMm + (value.depthMm ?? 0);
+    const outerHeight = value.heightMm + 2 * value.bleedMm;
+    const longestMm = Math.max(outerWidth, outerHeight, 1);
+    const scale = (sizePx - 8) / longestMm;
+    const trimX = 4 + value.bleedMm * scale;
+    const trimY = 4 + value.bleedMm * scale;
+    const trimW = value.widthMm * scale;
+    const trimH = value.heightMm * scale;
+    const bleedX = 4;
+    const bleedY = 4;
+    const bleedW = (value.widthMm + 2 * value.bleedMm) * scale;
+    const bleedH = (value.heightMm + 2 * value.bleedMm) * scale;
+    const depthW = (value.depthMm ?? 0) * scale;
+    return (_jsx("div", { style: { marginTop: "0.5rem" }, children: _jsxs("svg", { "data-testid": "dieline-parameters-preview", width: sizePx, height: sizePx, viewBox: `0 0 ${sizePx} ${sizePx}`, role: "img", "aria-label": value.depthMm !== undefined
+                ? `Dieline preview: ${value.widthMm} × ${value.heightMm} × ${value.depthMm} mm with ${value.bleedMm} mm bleed`
+                : `Dieline preview: ${value.widthMm} × ${value.heightMm} mm with ${value.bleedMm} mm bleed`, style: { border: "1px solid #ddd", background: "#fafafa", borderRadius: 4 }, children: [value.bleedMm > 0 && (_jsx("rect", { x: bleedX, y: bleedY, width: bleedW, height: bleedH, fill: "none", stroke: "#d33", strokeDasharray: "2 2", strokeWidth: 1 })), _jsx("rect", { x: trimX, y: trimY, width: trimW, height: trimH, fill: "#fff", stroke: "#222", strokeWidth: 1 }), value.depthMm !== undefined && value.depthMm > 0 && (_jsx("rect", { x: trimX + trimW, y: trimY, width: depthW, height: trimH, fill: "#fff", stroke: "#222", strokeDasharray: "3 2", strokeWidth: 1 }))] }) }));
+}
+//# sourceMappingURL=DielineParametersPanel.js.map

package/dist/components/DielineParametersPanel.js.map

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

package/dist/components/DielinePreview.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Wave 4 S6 — lightweight dieline preview panel.
+ *
+ * Renders a small 2D thumbnail of the active page's dieline: every
+ * panel from `panelMetadata` is drawn as a rect (bbox-derived), and
+ * every fold edge from `foldConfig` is overlaid as a colored segment
+ * (mountain = blue, valley = red).
+ *
+ * Distinct from {@link FoldPreviewOverlay}, which spins up a Three.js
+ * WebGL scene for full 3D viewing. S6 is the cheap always-on chrome
+ * companion: SVG-only, no GPU, SSR-safe, ~zero bundle cost. Hosts
+ * typically dock it in the right rail next to {@link DielineParametersPanel}
+ * so a parametric edit + this preview update side-by-side.
+ *
+ * The component is fully controlled and props-driven — no internal
+ * state, no fold-angle math, no hover side effects. The host owns
+ * `activePanelId`; the preview just renders it. This keeps the panel
+ * useful in both Wave 4 contexts (host-driven hover affordance) and
+ * Wave 5+ contexts (host-driven panel-anchored object selection).
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * One panel of the dieline registry, structurally compatible with
+ * `@artworkpdf/document-model`'s `DielinePanel` and editor-side
+ * {@link FoldGeometryPanel}. The fields below are the subset we need
+ * for the 2D preview — `pathData` is intentionally omitted; the
+ * preview uses the axis-aligned `bbox` for speed and SSR-safety.
+ *
+ * @public
+ */
+export type DielinePreviewPanel = {
+    id: string;
+    name?: string;
+    bbox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    role?: string;
+};
+/**
+ * Panel registry input — structurally compatible with `PanelMetadata`
+ * on `@artworkpdf/document-model`'s `PageV3`.
+ *
+ * @public
+ */
+export type DielinePreviewPanelMetadata = {
+    panels: DielinePreviewPanel[];
+};
+/**
+ * One fold edge between two panels (Wave 2 S4 wire shape).
+ * Structurally compatible with `@artworkpdf/document-model`'s
+ * `FoldEdge`.
+ *
+ * @public
+ */
+export type DielinePreviewFoldEdge = {
+    id: string;
+    panelA: string;
+    panelB: string;
+    angleDeg: number;
+    direction?: "mountain" | "valley";
+};
+/**
+ * Fold-edge registry input — structurally compatible with `FoldConfig`
+ * on `@artworkpdf/document-model`'s `PageV3`.
+ *
+ * @public
+ */
+export type DielinePreviewFoldConfig = {
+    edges: DielinePreviewFoldEdge[];
+    defaultAngleDeg?: number;
+};
+/**
+ * @public
+ */
+export type DielinePreviewProps = {
+    /** Panel registry for the active page. `undefined` renders the
+     *  "no dieline loaded" empty state. */
+    panelMetadata: DielinePreviewPanelMetadata | undefined;
+    /** Fold-edge registry for the active page. `undefined` is fine —
+     *  panels render alone, no hinge lines appear. */
+    foldConfig?: DielinePreviewFoldConfig;
+    /** Optional template id surfaced in the panel header. Hosts that
+     *  carry `PageV3.dielineTemplateId` pass it here as a label hint. */
+    templateId?: string;
+    /** Preview viewport size in CSS pixels (square). Defaults to 160. */
+    sizePx?: number;
+    /** Id of a panel to render in the "active" style (host-controlled
+     *  hover / selection affordance). Absent → no highlight. */
+    activePanelId?: string;
+};
+/**
+ * Internal layout shape produced by {@link computeDielinePreviewLayout}.
+ *
+ * Exposed only via the helper's return type so tests can assert
+ * geometry without driving the SVG renderer.
+ */
+export type DielinePreviewLayout = {
+    panels: DielinePreviewLaidOutPanel[];
+    hinges: DielinePreviewLaidOutHinge[];
+    scale: number;
+};
+/**
+ * One panel projected into the preview viewport.
+ *
+ * @public
+ */
+export type DielinePreviewLaidOutPanel = {
+    id: string;
+    name?: string;
+    role?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * One hinge segment projected into the preview viewport.
+ *
+ * @public
+ */
+export type DielinePreviewLaidOutHinge = {
+    id: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    direction: "mountain" | "valley";
+};
+/**
+ * Pure geometry helper — projects the panel registry + fold config
+ * into the preview viewport at `sizePx` square. Exposed for tests
+ * and for hosts that want to drive their own SVG / canvas renderer
+ * over the same numbers.
+ *
+ * Returns an empty layout when `panels` is empty; collapses to a
+ * unit scale when every panel has zero extent (mid-edit guard).
+ *
+ * @public
+ */
+export declare function computeDielinePreviewLayout(panelMetadata: DielinePreviewPanelMetadata, foldConfig: DielinePreviewFoldConfig | undefined, sizePx: number): DielinePreviewLayout;
+/**
+ * @public
+ */
+export declare function DielinePreview({ panelMetadata, foldConfig, templateId, sizePx, activePanelId, }: DielinePreviewProps): ReactElement;
+//# sourceMappingURL=DielinePreview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DielinePreview.d.ts","sourceRoot":"","sources":["../../src/components/DielinePreview.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,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;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;2CACuC;IACvC,aAAa,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACvD;sDACkD;IAClD,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC;yEACqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;gEAC4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAgBF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACrC,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,2BAA2B,EAC1C,UAAU,EAAE,wBAAwB,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,GACb,oBAAoB,CAuDtB;AA4CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,UAAU,EACV,UAAU,EACV,MAAwB,EACxB,aAAa,GACd,EAAE,mBAAmB,GAAG,YAAY,CAwFpC"}