@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

package/dist/components/MarkLibraryPanel.js

@@ -0,0 +1,184 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+/**
+ * Canonical order mark categories render in. Crop is the
+ * highest-priority press concern; "other" is the escape hatch at
+ * the end.
+ *
+ * @public
+ */
+export const MARK_CATEGORY_ORDER = [
+    "crop",
+    "registration",
+    "color-bar",
+    "slug",
+    "other",
+];
+const CATEGORY_LABELS = {
+    crop: "Crop marks",
+    registration: "Registration",
+    "color-bar": "Color bars",
+    slug: "Slug info",
+    other: "Other",
+};
+/**
+ * Group marks by category in {@link MARK_CATEGORY_ORDER}. Returns a
+ * stable five-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 groupMarksByCategory(marks) {
+    const buckets = new Map(MARK_CATEGORY_ORDER.map((c) => [c, []]));
+    for (const m of marks) {
+        const bucket = buckets.get(m.category) ?? buckets.get("other");
+        bucket?.push(m);
+    }
+    return MARK_CATEGORY_ORDER.map((category) => ({
+        category,
+        marks: buckets.get(category) ?? [],
+    }));
+}
+/**
+ * Filter marks by category / name substring. Returns a new array;
+ * preserves input order. Pure function.
+ *
+ * @public
+ */
+export function filterMarks(marks, filter) {
+    const trimmedQuery = filter.query?.trim().toLowerCase() ?? "";
+    return marks.filter((m) => {
+        if (filter.category && m.category !== filter.category)
+            return false;
+        if (trimmedQuery && !m.name.toLowerCase().includes(trimmedQuery))
+            return false;
+        return true;
+    });
+}
+/**
+ * Stateful picker that loads the host-supplied catalogue, exposes a
+ * live name search, and emits the selected entry. Handles loading /
+ * error / empty states inline (matches `ComplianceFindingsPanel`'s
+ * adapter pattern).
+ *
+ * @public
+ */
+export function MarkLibraryPanel({ loader, filterCategory, activeMarkId, onSelect, }) {
+    const [marks, setMarks] = useState(null);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [query, setQuery] = useState("");
+    useEffect(() => {
+        let disposed = false;
+        setLoading(true);
+        setError(null);
+        setMarks(null);
+        void (async () => {
+            try {
+                const next = await loader();
+                if (disposed)
+                    return;
+                setMarks(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 (!marks)
+            return null;
+        const filtered = filterMarks(marks, {
+            ...(filterCategory && { category: filterCategory }),
+            query,
+        });
+        return groupMarksByCategory(filtered);
+    }, [marks, filterCategory, query]);
+    if (loading) {
+        return (_jsx("div", { "data-testid": "mark-library-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "Loading mark library\u2026" }));
+    }
+    if (error) {
+        return (_jsxs("div", { "data-testid": "mark-library-panel", role: "alert", style: { padding: "0.5rem", color: "#a00" }, children: ["Couldn't load mark library: ", error] }));
+    }
+    if (!visibleGroups)
+        return _jsx("div", { "data-testid": "mark-library-panel" });
+    const totalVisible = visibleGroups.reduce((s, g) => s + g.marks.length, 0);
+    return (_jsxs("div", { "data-testid": "mark-library-panel", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: { display: "flex", gap: "0.5rem", marginBottom: "0.5rem" }, children: [_jsxs("h3", { style: { margin: 0, fontSize: "0.875rem", flex: 1 }, children: ["Marks (", totalVisible, ")"] }), _jsx("input", { type: "search", placeholder: "Search marks", value: query, onChange: (e) => setQuery(e.target.value), "aria-label": "Search marks", style: { fontSize: "0.75rem", padding: "0.125rem 0.25rem" } })] }), totalVisible === 0 && (_jsx("div", { "data-testid": "mark-library-panel-empty", style: { opacity: 0.6, fontSize: "0.875rem" }, children: "No marks match the current filter." })), visibleGroups.map((group) => {
+                if (group.marks.length === 0)
+                    return null;
+                return (_jsxs("section", { "data-testid": `mark-library-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.marks.length, ")"] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: group.marks.map((mark) => (_jsx(MarkLibraryRow, { mark: mark, isActive: mark.id === activeMarkId, onSelect: onSelect }, mark.id))) })] }, group.category));
+            })] }));
+}
+/**
+ * Renders one mark row. Switches between a `<button>` (when
+ * `onSelect` is wired) and a static `<div>` so screen readers don't
+ * announce a non-functional control. The thumbnail, when present, is
+ * `aria-hidden` because the row's `aria-label` already names the
+ * mark.
+ *
+ * Intra-package helper.
+ */
+function MarkLibraryRow({ mark, isActive, onSelect, }) {
+    const rowStyle = {
+        display: "flex",
+        alignItems: "center",
+        gap: "0.5rem",
+        width: "100%",
+        padding: "0.25rem 0.5rem",
+        background: isActive ? "#e0ecff" : "transparent",
+        border: isActive ? "1px solid #2563eb" : "1px solid transparent",
+        borderRadius: 4,
+    };
+    const contents = (_jsxs(_Fragment, { children: [mark.thumbnailDataUrl && (_jsx("img", { src: mark.thumbnailDataUrl, alt: "", "aria-hidden": "true", style: {
+                    width: 24,
+                    height: 24,
+                    objectFit: "contain",
+                    background: "#fff",
+                    border: "1px solid #ddd",
+                    borderRadius: 2,
+                    flexShrink: 0,
+                } })), _jsx("span", { style: { flex: 1, fontSize: "0.8125rem" }, children: mark.name })] }));
+    // Visually-hidden description, referenced by `aria-describedby` so
+    // screen readers announce the mark's name first and the longer
+    // description as a separate supporting detail (rather than fused
+    // into a single mash-up label). Hosts that disable verbose
+    // announcements then still get a short button name.
+    const describedById = mark.description ? `mark-${mark.id}-description` : undefined;
+    return (_jsx("li", { children: onSelect ? (_jsxs("button", { type: "button", onClick: () => onSelect(mark), "aria-label": mark.name, "aria-describedby": describedById, title: mark.description, style: {
+                ...rowStyle,
+                cursor: "pointer",
+                textAlign: "left",
+            }, children: [contents, mark.description && (_jsx("span", { id: describedById, style: {
+                        position: "absolute",
+                        width: 1,
+                        height: 1,
+                        padding: 0,
+                        margin: -1,
+                        overflow: "hidden",
+                        clip: "rect(0 0 0 0)",
+                        whiteSpace: "nowrap",
+                        border: 0,
+                    }, children: mark.description }))] })) : (_jsx("div", { style: rowStyle, title: mark.description, children: contents })) }));
+}
+//# sourceMappingURL=MarkLibraryPanel.js.map

package/dist/components/MarkLibraryPanel.js.map

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

package/dist/components/MisEstimateButton.d.ts

@@ -0,0 +1,73 @@
+import type { PrintProcess } from "./JobSetupPanel";
+/**
+ * Manifest payload — the shape the synergy `mis.estimate` node
+ * consumes. All fields except `documentId` and `processClass` are
+ * optional so partial submissions still validate (hosts that don't
+ * yet collect a due date can omit it).
+ *
+ * @public
+ */
+export type MisEstimateManifest = {
+    /** Stable identifier the host uses to correlate this submission
+     *  with the underlying document (e.g. a CMS row id). */
+    documentId: string;
+    /** Matches `PrintContext.process` from the document-model (re-using
+     *  `JobSetupPanel`'s `PrintProcess` to keep the two in lockstep) so
+     *  the MIS can route to the right press cell. */
+    processClass: PrintProcess;
+    /** Ordered ink list at submission time — typically the live ink
+     *  list from PR-5's InksPanel. Names mirror the wire shape, not
+     *  the human display string. */
+    separations?: ReadonlyArray<{
+        name: string;
+        colorSpace: "Separation" | "DeviceN";
+    }>;
+    /** Substrate / coverage hints the MIS uses to estimate
+     *  consumables. Free shape — different MIS vendors collect
+     *  different fields. */
+    materialEstimate?: Record<string, unknown>;
+    /** ISO 8601 (date-only) string. Hosts that surface a date picker
+     *  pass `value.toISOString().slice(0, 10)`. */
+    dueDate?: string;
+    /** Tenant-specific extras (`po_number`, `cost_center`, …). The
+     *  synergy node copies the bag verbatim into the workflow
+     *  payload. */
+    extras?: Record<string, unknown>;
+};
+/**
+ * Host adapter — POSTs the manifest to the synergy queue (or
+ * whatever MIS bridge the host runs). Resolves with the workflow
+ * id the synergy node assigned; rejects on transport / validation
+ * errors and the button surfaces the message inline.
+ *
+ * @public
+ */
+export type MisSubmitFn = (manifest: MisEstimateManifest) => Promise<{
+    workflowId: string;
+}>;
+/**
+ * @public
+ */
+export type MisEstimateButtonProps = {
+    /** The current manifest. When `undefined` the button is disabled
+     *  — hosts wire this to "we have enough data to submit". */
+    manifest: MisEstimateManifest | undefined;
+    /** Host adapter, see {@link MisSubmitFn}. */
+    submit: MisSubmitFn;
+    /** Optional button label override. Defaults to "Send to MIS". */
+    label?: string;
+    /** Optional callback fired on successful submission with the
+     *  workflow id so the host can show a confirmation / link. */
+    onSuccess?: (workflowId: string) => void;
+    /** Optional mapper that turns a submit error into a user-facing
+     *  message. The default (`"Couldn't send to MIS."`) avoids leaking
+     *  internal `Error.message` strings; hosts that want richer
+     *  surfaces (e.g. validation-error toasts) pass their own mapper.
+     *  The original error is still passed in so hosts can log it. */
+    errorMessage?: (err: unknown) => string;
+};
+/**
+ * @public
+ */
+export declare function MisEstimateButton({ manifest, submit, label, onSuccess, errorMessage, }: MisEstimateButtonProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MisEstimateButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MisEstimateButton.d.ts","sourceRoot":"","sources":["../../src/components/MisEstimateButton.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;4DACwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB;;qDAEiD;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B;;oCAEgC;IAChC,WAAW,CAAC,EAAE,aAAa,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC;KACtC,CAAC,CAAC;IACH;;4BAEwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C;mDAC+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;mBAEe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;gEAC4D;IAC5D,QAAQ,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,6CAA6C;IAC7C,MAAM,EAAE,WAAW,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;kEAC8D;IAC9D,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC;;;;qEAIiE;IACjE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,YAAY,GACb,EAAE,sBAAsB,2CAgExB"}

package/dist/components/MisEstimateButton.js

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Wave 2 O2 — Send-to-MIS manifest emitter.
+ *
+ * A small button that gathers the current document's print-relevant
+ * metadata (separations, material estimate, process class, due date)
+ * into a structured manifest and hands it to a host-supplied
+ * submitter. The host wires the submitter to the synergy queue's
+ * `mis.estimate` node (`POST /synergy/workflows/<id>/submit` in the
+ * canonical deploy); the editor stays runtime-free of the synergy
+ * client.
+ *
+ * Designed around the host-adapter pattern that the rest of the
+ * editor uses (see `SpotSearchFn`, `TrapPreviewFn`, `InksLoaderFn`).
+ *
+ * @public
+ */
+import { useEffect, useRef, useState } from "react";
+/**
+ * @public
+ */
+export function MisEstimateButton({ manifest, submit, label, onSuccess, errorMessage, }) {
+    const [state, setState] = useState({ kind: "idle" });
+    // Clear any lingering success/error chip when the host swaps in a
+    // new manifest — the previous submission's outcome doesn't apply to
+    // a different payload. Identity comparison only; hosts that mutate
+    // the same object reference get the chip preserved (rare; almost
+    // every host returns a new object on each edit).
+    const lastManifestRef = useRef(manifest);
+    useEffect(() => {
+        if (lastManifestRef.current !== manifest) {
+            lastManifestRef.current = manifest;
+            setState((prev) => (prev.kind === "submitting" ? prev : { kind: "idle" }));
+        }
+    }, [manifest]);
+    const disabled = !manifest || state.kind === "submitting";
+    const onClick = async () => {
+        if (!manifest)
+            return;
+        setState({ kind: "submitting" });
+        try {
+            const { workflowId } = await submit(manifest);
+            setState({ kind: "ok", workflowId });
+            onSuccess?.(workflowId);
+        }
+        catch (err) {
+            setState({
+                kind: "error",
+                message: errorMessage ? errorMessage(err) : "Couldn't send to MIS.",
+            });
+        }
+    };
+    return (_jsxs("div", { "data-testid": "mis-estimate-button", style: { display: "inline-flex", gap: "0.5rem", alignItems: "center" }, children: [_jsx("button", { type: "button", onClick: onClick, disabled: disabled, "aria-busy": state.kind === "submitting", "aria-label": label ?? "Send to MIS", children: state.kind === "submitting" ? "Sending…" : (label ?? "Send to MIS") }), state.kind === "ok" && (_jsxs("small", { style: { color: "#080", opacity: 0.8 }, role: "status", children: ["Submitted (", state.workflowId, ")"] })), state.kind === "error" && (_jsx("small", { style: { color: "#a00", opacity: 0.8 }, role: "alert", children: state.message }))] }));
+}
+//# sourceMappingURL=MisEstimateButton.js.map

package/dist/components/MisEstimateButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MisEstimateButton.js","sourceRoot":"","sources":["../../src/components/MisEstimateButton.tsx"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAuEpD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,YAAY,GACW;IACvB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAKhC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAEpB,kEAAkE;IAClE,oEAAoE;IACpE,mEAAmE;IACnE,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,eAAe,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzC,eAAe,CAAC,OAAO,GAAG,QAAQ,CAAC;YACnC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;IAE1D,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9C,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC;gBACP,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,8BACc,qBAAqB,EACjC,KAAK,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,aAEtE,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,eACP,KAAK,CAAC,IAAI,KAAK,YAAY,gBAC1B,KAAK,IAAI,aAAa,YAEjC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,GAC7D,EACR,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,CACtB,iBAAO,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAC,QAAQ,4BAC9C,KAAK,CAAC,UAAU,SACtB,CACT,EACA,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CACzB,gBAAO,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAC,OAAO,YACxD,KAAK,CAAC,OAAO,GACR,CACT,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/components/NutritionPanel.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Typed Nutrition Facts data. All fields are per serving except
+ * `servingSize` (human-readable, e.g. `"2/3 cup (55g)"`) and
+ * `servingsPerContainer`. Numeric fields are in the units the FDA
+ * panel declares (grams for macronutrients, milligrams for sodium /
+ * cholesterol, micrograms for vitamin D).
+ *
+ * Optional fields are omitted from the rendered output entirely
+ * (different from `0`, which renders as "0g" / "0%").
+ *
+ * @public
+ */
+export type NutritionFacts = {
+    servingSize: string;
+    servingsPerContainer: number;
+    calories: number;
+    totalFatG: number;
+    saturatedFatG: number;
+    transFatG: number;
+    cholesterolMg: number;
+    sodiumMg: number;
+    totalCarbohydrateG: number;
+    dietaryFiberG: number;
+    totalSugarsG: number;
+    addedSugarsG?: number;
+    proteinG: number;
+    vitaminDMcg?: number;
+    calciumMg?: number;
+    ironMg?: number;
+    potassiumMg?: number;
+};
+/**
+ * 2016 FDA Daily Reference Values (DRV) and Reference Daily Intakes
+ * (RDI) used to compute the % Daily Value column. Public-domain
+ * regulatory data — re-exported so server renderers can use the
+ * same constants and stay in sync.
+ *
+ * @public
+ */
+export declare const FDA_DAILY_VALUES: {
+    readonly totalFatG: 78;
+    readonly saturatedFatG: 20;
+    readonly cholesterolMg: 300;
+    readonly sodiumMg: 2300;
+    readonly totalCarbohydrateG: 275;
+    readonly dietaryFiberG: 28;
+    readonly addedSugarsG: 50;
+    readonly vitaminDMcg: 20;
+    readonly calciumMg: 1300;
+    readonly ironMg: 18;
+    readonly potassiumMg: 4700;
+};
+/**
+ * One row in the composed nutrition panel spec. `indent` ≥ 1 means
+ * the row is a sub-nutrient (e.g. saturated fat under total fat) —
+ * hosts typically render indented and not bold. `bold` matches the
+ * FDA layout: panel header, "Calories", and section-leading nutrient
+ * names are bold.
+ *
+ * @public
+ */
+export type NutritionRow = {
+    label: string;
+    amount: string;
+    dvPct?: number;
+    indent: 0 | 1;
+    bold: boolean;
+};
+/**
+ * Output of {@link composeNutritionFacts}. `rows` is the ordered
+ * list the host renders top-to-bottom; `caloriesLine` is surfaced
+ * separately because the FDA layout sets calories at ~22 pt while
+ * everything else is at body-text size.
+ *
+ * @public
+ */
+export type NutritionPanelSpec = {
+    servingSize: string;
+    servingsLine: string;
+    caloriesLine: string;
+    rows: NutritionRow[];
+};
+/**
+ * Compose the ordered row list for an FDA-style Nutrition Facts
+ * panel from a {@link NutritionFacts} record. Pure function —
+ * exported so RSC / Astro-frontmatter callers can pre-compute the
+ * spec without bundling the panel.
+ *
+ * Row order matches §101.9(c) exactly: Total Fat, Saturated Fat,
+ * Trans Fat, Cholesterol, Sodium, Total Carbohydrate, Dietary
+ * Fiber, Total Sugars, Added Sugars, Protein, then the
+ * micronutrient block (Vitamin D, Calcium, Iron, Potassium).
+ *
+ * @public
+ */
+export declare function composeNutritionFacts(facts: NutritionFacts): NutritionPanelSpec;
+/**
+ * @public
+ */
+export type NutritionPanelProps = {
+    /** Initial values seeded into the form. Defaults to the
+     *  illustrative FDA-example values. */
+    initialFacts?: Partial<NutritionFacts>;
+    /** Fired when the user clicks "Compose" with the spec built from
+     *  the current form state. The host places it on the canvas as a
+     *  text block. */
+    onCompose: (spec: NutritionPanelSpec) => void;
+};
+/**
+ * Nutrition Facts data-entry panel. Surfaces the FDA panel's
+ * mandatory fields (serving size, servings, calories, macros) plus
+ * the optional micronutrient block. Click **Compose** and the host
+ * receives the resolved {@link NutritionPanelSpec} via `onCompose`.
+ *
+ * @public
+ */
+export declare function NutritionPanel({ initialFacts, onCompose }: NutritionPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NutritionPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NutritionPanel.d.ts","sourceRoot":"","sources":["../../src/components/NutritionPanel.tsx"],"names":[],"mappings":"AAwBA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB,CAAC;AA0BF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAiG/E;AA8BD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;2CACuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC;;sBAEkB;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,mBAAmB,2CA8E9E"}

package/dist/components/NutritionPanel.js

@@ -0,0 +1,169 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Wave 3 G1 — Nutrition Facts label generator.
+ *
+ * The FDA Nutrition Facts label (21 CFR §101.9, 2016 revision) has a
+ * highly-regulated layout: serving size + servings per container at
+ * the top, Calories in 22-pt bold, then a fixed-order list of
+ * nutrients with their amounts + % Daily Value. The panel handles
+ * data entry; the {@link composeNutritionFacts} helper turns the
+ * typed data into an ordered list of rows the host renders into the
+ * canvas (text + bold flags + indentation level) — keeping the
+ * editor free of any specific PDF text-layout backend and letting
+ * server renderers (compile-pdf, codex-pdf) own the canonical typesetting.
+ *
+ * Daily Value % is computed from the 2016 FDA Reference Daily Intake
+ * (RDI) / Daily Reference Value (DRV) tables; values are widely
+ * published and trademark-free.
+ *
+ * @public
+ */
+import { useState } from "react";
+/**
+ * 2016 FDA Daily Reference Values (DRV) and Reference Daily Intakes
+ * (RDI) used to compute the % Daily Value column. Public-domain
+ * regulatory data — re-exported so server renderers can use the
+ * same constants and stay in sync.
+ *
+ * @public
+ */
+export const FDA_DAILY_VALUES = {
+    totalFatG: 78,
+    saturatedFatG: 20,
+    cholesterolMg: 300,
+    sodiumMg: 2300,
+    totalCarbohydrateG: 275,
+    dietaryFiberG: 28,
+    addedSugarsG: 50,
+    vitaminDMcg: 20,
+    calciumMg: 1300,
+    ironMg: 18,
+    potassiumMg: 4700,
+};
+function dvPct(amount, dv) {
+    if (dv === undefined || dv <= 0)
+        return undefined;
+    return Math.round((amount / dv) * 100);
+}
+/**
+ * Build a {@link NutritionRow}, omitting the `dvPct` key entirely
+ * when no DV is defined. Required because `dvPct` is declared as an
+ * optional property under `exactOptionalPropertyTypes`; assigning
+ * `dvPct: undefined` does not satisfy the type, so the helper
+ * branches the object shape.
+ */
+function row(label, amount, pct, indent, bold) {
+    return pct !== undefined
+        ? { label, amount, dvPct: pct, indent, bold }
+        : { label, amount, indent, bold };
+}
+/**
+ * Compose the ordered row list for an FDA-style Nutrition Facts
+ * panel from a {@link NutritionFacts} record. Pure function —
+ * exported so RSC / Astro-frontmatter callers can pre-compute the
+ * spec without bundling the panel.
+ *
+ * Row order matches §101.9(c) exactly: Total Fat, Saturated Fat,
+ * Trans Fat, Cholesterol, Sodium, Total Carbohydrate, Dietary
+ * Fiber, Total Sugars, Added Sugars, Protein, then the
+ * micronutrient block (Vitamin D, Calcium, Iron, Potassium).
+ *
+ * @public
+ */
+export function composeNutritionFacts(facts) {
+    const rows = [
+        row("Total Fat", `${facts.totalFatG}g`, dvPct(facts.totalFatG, FDA_DAILY_VALUES.totalFatG), 0, true),
+        row("Saturated Fat", `${facts.saturatedFatG}g`, dvPct(facts.saturatedFatG, FDA_DAILY_VALUES.saturatedFatG), 1, false),
+        row("Trans Fat", `${facts.transFatG}g`, undefined, 1, false),
+        row("Cholesterol", `${facts.cholesterolMg}mg`, dvPct(facts.cholesterolMg, FDA_DAILY_VALUES.cholesterolMg), 0, true),
+        row("Sodium", `${facts.sodiumMg}mg`, dvPct(facts.sodiumMg, FDA_DAILY_VALUES.sodiumMg), 0, true),
+        row("Total Carbohydrate", `${facts.totalCarbohydrateG}g`, dvPct(facts.totalCarbohydrateG, FDA_DAILY_VALUES.totalCarbohydrateG), 0, true),
+        row("Dietary Fiber", `${facts.dietaryFiberG}g`, dvPct(facts.dietaryFiberG, FDA_DAILY_VALUES.dietaryFiberG), 1, false),
+        row("Total Sugars", `${facts.totalSugarsG}g`, undefined, 1, false),
+    ];
+    if (facts.addedSugarsG !== undefined) {
+        rows.push(row("Includes Added Sugars", `${facts.addedSugarsG}g`, dvPct(facts.addedSugarsG, FDA_DAILY_VALUES.addedSugarsG), 1, false));
+    }
+    rows.push(row("Protein", `${facts.proteinG}g`, undefined, 0, true));
+    if (facts.vitaminDMcg !== undefined) {
+        rows.push(row("Vitamin D", `${facts.vitaminDMcg}mcg`, dvPct(facts.vitaminDMcg, FDA_DAILY_VALUES.vitaminDMcg), 0, false));
+    }
+    if (facts.calciumMg !== undefined) {
+        rows.push(row("Calcium", `${facts.calciumMg}mg`, dvPct(facts.calciumMg, FDA_DAILY_VALUES.calciumMg), 0, false));
+    }
+    if (facts.ironMg !== undefined) {
+        rows.push(row("Iron", `${facts.ironMg}mg`, dvPct(facts.ironMg, FDA_DAILY_VALUES.ironMg), 0, false));
+    }
+    if (facts.potassiumMg !== undefined) {
+        rows.push(row("Potassium", `${facts.potassiumMg}mg`, dvPct(facts.potassiumMg, FDA_DAILY_VALUES.potassiumMg), 0, false));
+    }
+    return {
+        servingSize: facts.servingSize,
+        servingsLine: `${facts.servingsPerContainer} servings per container`,
+        caloriesLine: `Calories ${facts.calories}`,
+        rows,
+    };
+}
+// Required-field defaults only. Optional nutrients (Added Sugars,
+// Vitamin D, Calcium, Iron, Potassium) are intentionally left absent
+// so hosts that don't want those rows aren't forced to pass
+// `undefined` overrides — `composeNutritionFacts` already omits any
+// optional field that's not set.
+const DEFAULT_FACTS = {
+    servingSize: "1 cup (240g)",
+    servingsPerContainer: 4,
+    calories: 230,
+    totalFatG: 8,
+    saturatedFatG: 1,
+    transFatG: 0,
+    cholesterolMg: 0,
+    sodiumMg: 160,
+    totalCarbohydrateG: 37,
+    dietaryFiberG: 4,
+    totalSugarsG: 12,
+    proteinG: 3,
+};
+const OPTIONAL_NUTRITION_KEYS = new Set([
+    "addedSugarsG",
+    "vitaminDMcg",
+    "calciumMg",
+    "ironMg",
+    "potassiumMg",
+]);
+/**
+ * Nutrition Facts data-entry panel. Surfaces the FDA panel's
+ * mandatory fields (serving size, servings, calories, macros) plus
+ * the optional micronutrient block. Click **Compose** and the host
+ * receives the resolved {@link NutritionPanelSpec} via `onCompose`.
+ *
+ * @public
+ */
+export function NutritionPanel({ initialFacts, onCompose }) {
+    const [facts, setFacts] = useState({ ...DEFAULT_FACTS, ...initialFacts });
+    function setNum(key, value) {
+        setFacts((f) => ({ ...f, [key]: value }));
+    }
+    function clearOptional(key) {
+        setFacts((f) => {
+            const { [key]: _dropped, ...rest } = f;
+            return rest;
+        });
+    }
+    function numInput(label, key, unit) {
+        const isOptional = OPTIONAL_NUTRITION_KEYS.has(key);
+        const current = facts[key];
+        return (_jsxs("label", { style: { display: "block", marginBottom: "0.25rem" }, children: [label, _jsx("input", { type: "number", value: current ?? "", onChange: (e) => {
+                        const raw = e.target.value;
+                        if (isOptional && raw === "") {
+                            clearOptional(key);
+                            return;
+                        }
+                        const v = Number(raw);
+                        setNum(key, (Number.isNaN(v) ? 0 : v));
+                    }, "aria-label": label, style: { marginLeft: "0.5rem", width: "5em" } }), " ", unit] }));
+    }
+    return (_jsxs("div", { "data-testid": "nutrition-panel", style: { padding: "0.5rem", maxWidth: "24em" }, children: [_jsx("h3", { style: { margin: "0 0 0.5rem 0" }, children: "Nutrition Facts" }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Serving size", _jsx("input", { type: "text", value: facts.servingSize, onChange: (e) => setFacts((f) => ({ ...f, servingSize: e.target.value })), "aria-label": "Serving size", style: { marginLeft: "0.5rem", width: "14em" } })] }), numInput("Servings per container", "servingsPerContainer", ""), numInput("Calories", "calories", "kcal"), numInput("Total Fat", "totalFatG", "g"), numInput("Saturated Fat", "saturatedFatG", "g"), numInput("Trans Fat", "transFatG", "g"), numInput("Cholesterol", "cholesterolMg", "mg"), numInput("Sodium", "sodiumMg", "mg"), numInput("Total Carbohydrate", "totalCarbohydrateG", "g"), numInput("Dietary Fiber", "dietaryFiberG", "g"), numInput("Total Sugars", "totalSugarsG", "g"), numInput("Added Sugars (optional, leave blank to omit)", "addedSugarsG", "g"), numInput("Protein", "proteinG", "g"), numInput("Vitamin D (optional)", "vitaminDMcg", "mcg"), numInput("Calcium (optional)", "calciumMg", "mg"), numInput("Iron (optional)", "ironMg", "mg"), numInput("Potassium (optional)", "potassiumMg", "mg"), _jsx("button", { type: "button", onClick: () => onCompose(composeNutritionFacts(facts)), style: { padding: "0.4rem 0.8rem", marginTop: "0.5rem" }, children: "Compose" })] }));
+}
+//# sourceMappingURL=NutritionPanel.js.map

package/dist/components/NutritionPanel.js.map

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