@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/components/AnnotationOverlay.js.map

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

package/dist/components/AnnotationsSidebar.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Wave 4 X1 — Annotations sidebar.
+ *
+ * Companion list view to the X3 {@link AnnotationOverlay} (Wave 4
+ * PR-7). The overlay renders annotation anchors on top of the canvas;
+ * this sidebar surfaces the same {@link AnnotationOverlayAnnotation}
+ * stream as a scrollable, filterable list so reviewers can read the
+ * thread without hunting for pins.
+ *
+ * Controlled component: hosts pass `annotations` + the active id (the
+ * same one wired into the overlay's `activeAnnotationId`), the sidebar
+ * emits selection / resolve / delete callbacks. The host is the source
+ * of truth — the sidebar never mutates the array.
+ *
+ * Two pure helpers ship alongside:
+ * - {@link filterAnnotationsForSidebar} — status / author predicates.
+ * - {@link sortAnnotationsByDate} — chronological / reverse-chronological.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import type { AnnotationOverlayAnnotation } from "./AnnotationOverlay";
+/**
+ * Status filter the sidebar pivots on. `"all"` shows both open and
+ * resolved annotations; the other two narrow to a single set.
+ *
+ * @public
+ */
+export type AnnotationStatusFilter = "open" | "resolved" | "all";
+/**
+ * Filter spec accepted by {@link filterAnnotationsForSidebar}.
+ *
+ * @public
+ */
+export type AnnotationsSidebarFilter = {
+    /** Status to keep — see {@link AnnotationStatusFilter}. Absent →
+     *  treated as `"all"`. */
+    status?: AnnotationStatusFilter;
+    /** Case-insensitive substring filter on `author`. Whitespace-only
+     *  values are treated as absent so a stray space doesn't blank the
+     *  list. */
+    author?: string;
+};
+/**
+ * Configuration for the {@link AnnotationsSidebar}. The host owns
+ * the annotation store and the active-id state; the sidebar only
+ * renders and emits user intents (select / resolve-toggle / delete)
+ * through the optional callbacks. The `annotations` array is treated
+ * as immutable — the sidebar never writes back to it.
+ *
+ * @public
+ */
+export type AnnotationsSidebarProps = {
+    /** Annotations to render. Typically `PageV3.annotations ?? []`. The
+     *  sidebar never mutates this array. */
+    annotations: readonly AnnotationOverlayAnnotation[];
+    /** Id of the active annotation — the matching row renders in the
+     *  "active" style. Hosts typically wire this from the overlay's
+     *  `activeAnnotationId` so the two surfaces stay in lockstep. */
+    activeAnnotationId?: string;
+    /** Optional initial status filter. Defaults to `"open"` so the
+     *  sidebar opens on actionable comments. */
+    defaultStatus?: AnnotationStatusFilter;
+    /** Fired when the user clicks a row. */
+    onSelect?: (annotation: AnnotationOverlayAnnotation) => void;
+    /** Fired when the user clicks the "Resolve" / "Reopen" toggle on
+     *  a row. The host writes the flipped `resolved` flag back to its
+     *  annotation store. */
+    onToggleResolved?: (annotation: AnnotationOverlayAnnotation) => void;
+    /** Fired when the user clicks the "Delete" affordance. The host
+     *  decides whether to remove the annotation or move it to a trash
+     *  bucket. */
+    onDelete?: (annotation: AnnotationOverlayAnnotation) => void;
+};
+/**
+ * Pure helper — filters annotations by status / author. Returns a
+ * new array; preserves input order. Pure function.
+ *
+ * @public
+ */
+export declare function filterAnnotationsForSidebar(annotations: readonly AnnotationOverlayAnnotation[], filter: AnnotationsSidebarFilter): readonly AnnotationOverlayAnnotation[];
+/**
+ * Pure helper — sorts annotations by `createdAt` (ISO 8601 strings
+ * compare lexicographically). Returns a new array; non-mutating.
+ * `"desc"` (newest first) is the convention for review surfaces.
+ *
+ * @public
+ */
+export declare function sortAnnotationsByDate(annotations: readonly AnnotationOverlayAnnotation[], direction?: "asc" | "desc"): readonly AnnotationOverlayAnnotation[];
+/**
+ * Stateful panel — surfaces a status dropdown + an author search and
+ * renders the filtered, date-sorted annotation list. Emits the host
+ * callbacks on row select / resolve-toggle / delete.
+ *
+ * @public
+ */
+export declare function AnnotationsSidebar({ annotations, activeAnnotationId, defaultStatus, onSelect, onToggleResolved, onDelete, }: AnnotationsSidebarProps): ReactElement;
+//# sourceMappingURL=AnnotationsSidebar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationsSidebar.d.ts","sourceRoot":"","sources":["../../src/components/AnnotationsSidebar.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAGvE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;8BAC0B;IAC1B,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;gBAEY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;4CACwC;IACxC,WAAW,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACpD;;qEAEiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;gDAC4C;IAC5C,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAC7D;;4BAEwB;IACxB,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACrE;;kBAEc;IACd,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,2BAA2B,EAAE,EACnD,MAAM,EAAE,wBAAwB,GAC/B,SAAS,2BAA2B,EAAE,CAYxC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,SAAS,2BAA2B,EAAE,EACnD,SAAS,GAAE,KAAK,GAAG,MAAe,GACjC,SAAS,2BAA2B,EAAE,CAsBxC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,EAAE,uBAAuB,GAAG,YAAY,CA4DxC"}

package/dist/components/AnnotationsSidebar.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { describeAnnotation } from "./AnnotationOverlay";
+/**
+ * Pure helper — filters annotations by status / author. Returns a
+ * new array; preserves input order. Pure function.
+ *
+ * @public
+ */
+export function filterAnnotationsForSidebar(annotations, filter) {
+    const status = filter.status ?? "all";
+    const trimmedAuthor = filter.author?.trim().toLowerCase() ?? "";
+    return annotations.filter((a) => {
+        if (status === "open" && a.resolved === true)
+            return false;
+        if (status === "resolved" && a.resolved !== true)
+            return false;
+        if (trimmedAuthor) {
+            const author = (a.author ?? "").toLowerCase();
+            if (!author.includes(trimmedAuthor))
+                return false;
+        }
+        return true;
+    });
+}
+/**
+ * Pure helper — sorts annotations by `createdAt` (ISO 8601 strings
+ * compare lexicographically). Returns a new array; non-mutating.
+ * `"desc"` (newest first) is the convention for review surfaces.
+ *
+ * @public
+ */
+export function sortAnnotationsByDate(annotations, direction = "desc") {
+    // Empty / missing createdAt is treated as sorting *after* anything
+    // valid in descending mode (and *before* anything valid in ascending
+    // mode) so a malformed entry surfaces at the tail of the review
+    // pile rather than silently breaking the sort.
+    const out = [...annotations];
+    out.sort((a, b) => {
+        const aHas = typeof a.createdAt === "string" && a.createdAt.length > 0;
+        const bHas = typeof b.createdAt === "string" && b.createdAt.length > 0;
+        if (!aHas && !bHas)
+            return 0;
+        if (!aHas)
+            return direction === "desc" ? 1 : -1;
+        if (!bHas)
+            return direction === "desc" ? -1 : 1;
+        if (a.createdAt === b.createdAt)
+            return 0;
+        return direction === "desc"
+            ? a.createdAt < b.createdAt
+                ? 1
+                : -1
+            : a.createdAt < b.createdAt
+                ? -1
+                : 1;
+    });
+    return out;
+}
+/**
+ * Stateful panel — surfaces a status dropdown + an author search and
+ * renders the filtered, date-sorted annotation list. Emits the host
+ * callbacks on row select / resolve-toggle / delete.
+ *
+ * @public
+ */
+export function AnnotationsSidebar({ annotations, activeAnnotationId, defaultStatus, onSelect, onToggleResolved, onDelete, }) {
+    const [status, setStatus] = useState(defaultStatus ?? "open");
+    const [authorQuery, setAuthorQuery] = useState("");
+    const visible = useMemo(() => {
+        const filtered = filterAnnotationsForSidebar(annotations, {
+            status,
+            author: authorQuery,
+        });
+        return sortAnnotationsByDate(filtered, "desc");
+    }, [annotations, status, authorQuery]);
+    return (_jsxs("div", { "data-testid": "annotations-sidebar", style: { padding: "0.5rem" }, children: [_jsxs("header", { style: { marginBottom: "0.5rem" }, children: [_jsxs("h3", { style: { margin: 0, fontSize: "0.875rem" }, children: ["Annotations (", visible.length, ")"] }), _jsxs("div", { style: { display: "flex", gap: "0.5rem", marginTop: "0.25rem", alignItems: "center" }, children: [_jsxs("label", { style: { fontSize: "0.75rem" }, children: ["Status", _jsxs("select", { "aria-label": "Status", value: status, onChange: (e) => setStatus(e.target.value), style: { marginLeft: "0.25rem", fontSize: "0.75rem" }, children: [_jsx("option", { value: "open", children: "Open" }), _jsx("option", { value: "resolved", children: "Resolved" }), _jsx("option", { value: "all", children: "All" })] })] }), _jsx("input", { type: "search", "aria-label": "Author", placeholder: "Filter by author", value: authorQuery, onChange: (e) => setAuthorQuery(e.target.value), style: { flex: 1, fontSize: "0.75rem", padding: "0.125rem 0.25rem" } })] })] }), visible.length === 0 ? (_jsx("div", { "data-testid": "annotations-sidebar-empty", style: { opacity: 0.6, fontSize: "0.875rem" }, children: "No annotations match the current filter." })) : (_jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: visible.map((annotation) => (_jsx(AnnotationRow, { annotation: annotation, isActive: annotation.id === activeAnnotationId, onSelect: onSelect, onToggleResolved: onToggleResolved, onDelete: onDelete }, annotation.id))) }))] }));
+}
+/**
+ * Renders one annotation row. Intra-package helper — the row's
+ * surface (kind badge + author + body + resolve / delete buttons) is
+ * intentionally minimal so {@link AnnotationsSidebar} can swap it
+ * without downstream consumers depending on the shape.
+ */
+function AnnotationRow({ annotation, isActive, onSelect, onToggleResolved, onDelete, }) {
+    const resolved = annotation.resolved === true;
+    return (_jsx("li", { "data-testid": `annotations-sidebar-row-${annotation.id}`, style: {
+            padding: "0.375rem 0.5rem",
+            border: `1px solid ${isActive ? "#2563eb" : "#ddd"}`,
+            borderRadius: 4,
+            background: isActive ? "#e0ecff" : "transparent",
+            marginBottom: "0.25rem",
+            opacity: resolved ? 0.6 : 1,
+        }, children: _jsxs("div", { style: { display: "flex", gap: "0.5rem", alignItems: "flex-start" }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: { fontSize: "0.8125rem", fontWeight: 500 }, children: describeAnnotation(annotation) }), _jsx("div", { style: { fontSize: "0.6875rem", color: "#595959", marginTop: "0.125rem" }, children: annotation.author
+                                ? `${annotation.author} · ${annotation.createdAt}`
+                                : annotation.createdAt })] }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "0.125rem" }, children: [onSelect && (_jsx("button", { type: "button", onClick: () => onSelect(annotation), style: { fontSize: "0.6875rem", padding: "0.0625rem 0.375rem" }, children: "Focus" })), onToggleResolved && (_jsx("button", { type: "button", onClick: () => onToggleResolved(annotation), style: { fontSize: "0.6875rem", padding: "0.0625rem 0.375rem" }, children: resolved ? "Reopen" : "Resolve" })), onDelete && (_jsx("button", { type: "button", onClick: () => onDelete(annotation), style: { fontSize: "0.6875rem", padding: "0.0625rem 0.375rem", color: "#a00" }, children: "Delete" }))] })] }) }));
+}
+//# sourceMappingURL=AnnotationsSidebar.js.map

package/dist/components/AnnotationsSidebar.js.map

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

package/dist/components/BarcodeGeneratorPanel.d.ts

@@ -0,0 +1,58 @@
+import { type BarcodeFormat } from "../lib/barcode-scan";
+/**
+ * Result returned by a {@link BarcodeRenderFn}. `bitmap` is an
+ * ImageData the host paints onto the canvas; `widthMm` / `heightMm`
+ * tell the host how big to place it.
+ *
+ * @public
+ */
+export type BarcodeRenderResult = {
+    bitmap: ImageData;
+    widthMm: number;
+    heightMm: number;
+};
+/**
+ * Host-supplied renderer. Takes a format + payload + optional
+ * sizing hints and returns the bitmap. Rejects on invalid payload
+ * (host-side check-digit / GS1 AI sequence validation) or
+ * transport errors when the renderer is server-backed; the panel
+ * surfaces the message inline.
+ *
+ * **Identity matters.** The panel does not memoize `renderer`; if
+ * the host builds the adapter inline it should wrap with
+ * `useCallback` so the panel doesn't refire the renderer on every
+ * parent re-render.
+ *
+ * @public
+ */
+export type BarcodeRenderFn = (input: {
+    format: BarcodeFormat;
+    payload: string;
+    widthMm?: number;
+    heightMm?: number;
+}) => Promise<BarcodeRenderResult>;
+/**
+ * @public
+ */
+export type BarcodeGeneratorPanelProps = {
+    /** Renderer the panel calls on "Generate". */
+    renderer: BarcodeRenderFn;
+    /** Fired with the rendered bitmap so the host can place it on the canvas. */
+    onRendered: (result: BarcodeRenderResult) => void;
+    /** Restrict the format dropdown to a subset; defaults to every
+     *  format supported by {@link BarcodeFormat}. */
+    allowedFormats?: readonly BarcodeFormat[];
+};
+/**
+ * Interactive barcode generation panel. Users pick a format from the
+ * dropdown, type the payload, optionally constrain the physical
+ * dimensions in millimetres, and click **Generate**. The panel calls
+ * the host-supplied `renderer` adapter and emits the resulting
+ * bitmap via `onRendered`; the host then places it on the canvas as
+ * a `CanvasObj`. Renderer rejections surface inline in an `alert`
+ * region — the panel never throws to the host.
+ *
+ * @public
+ */
+export declare function BarcodeGeneratorPanel({ renderer, onRendered, allowedFormats, }: BarcodeGeneratorPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BarcodeGeneratorPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BarcodeGeneratorPanel.d.ts","sourceRoot":"","sources":["../../src/components/BarcodeGeneratorPanel.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,8CAA8C;IAC9C,QAAQ,EAAE,eAAe,CAAC;IAC1B,6EAA6E;IAC7E,UAAU,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD;qDACiD;IACjD,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,UAAU,EACV,cAAc,GACf,EAAE,0BAA0B,2CAqH5B"}

package/dist/components/BarcodeGeneratorPanel.js

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Wave 3 G2g — Barcode generator panel.
+ *
+ * Companion to the Wave 1 G2v {@link import("../lib/barcode-scan").scanBarcodes}
+ * + {@link import("../lib/barcode-scan").validateBarcode} surface. G2v
+ * inspects barcodes the user has already placed on the canvas; G2g
+ * lets the user *generate* a new one — they pick a format, type the
+ * payload, and the host's `renderer` adapter resolves the bitmap.
+ * The panel emits the rendered bitmap via `onRendered` so the host
+ * places it as a `CanvasObj`.
+ *
+ * Adapter pattern (matches Wave 2 PR-6 / PR-8 components): hosts
+ * wire the rendering backend themselves. This keeps the editor
+ * package free of a runtime dep on a specific barcode library and
+ * lets server-side renderers (compile-pdf, codex-pdf) be the
+ * canonical source of truth when the host prefers PDF/X-4 exact
+ * vector output over a client-rendered raster.
+ *
+ * @public
+ */
+import { useState } from "react";
+import { ALL_BARCODE_FORMATS } from "../lib/barcode-scan";
+/**
+ * Interactive barcode generation panel. Users pick a format from the
+ * dropdown, type the payload, optionally constrain the physical
+ * dimensions in millimetres, and click **Generate**. The panel calls
+ * the host-supplied `renderer` adapter and emits the resulting
+ * bitmap via `onRendered`; the host then places it on the canvas as
+ * a `CanvasObj`. Renderer rejections surface inline in an `alert`
+ * region — the panel never throws to the host.
+ *
+ * @public
+ */
+export function BarcodeGeneratorPanel({ renderer, onRendered, allowedFormats, }) {
+    // Fall back to the full format list when the host passes `undefined`
+    // *or* an empty array. An empty array would otherwise render a
+    // select with no options against a still-valid `format` state, which
+    // confuses both keyboard users and the host's `onRendered` flow.
+    const formats = allowedFormats && allowedFormats.length > 0 ? allowedFormats : ALL_BARCODE_FORMATS;
+    const [format, setFormat] = useState(formats[0] ?? "EAN-13");
+    const [payload, setPayload] = useState("");
+    const [widthMm, setWidthMm] = useState(undefined);
+    const [heightMm, setHeightMm] = useState(undefined);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    async function handleGenerate() {
+        if (!payload.trim()) {
+            setError("Payload is required.");
+            return;
+        }
+        setBusy(true);
+        setError(null);
+        try {
+            const result = await renderer({
+                format,
+                payload: payload.trim(),
+                ...(widthMm !== undefined && { widthMm }),
+                ...(heightMm !== undefined && { heightMm }),
+            });
+            onRendered(result);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    return (_jsxs("div", { "data-testid": "barcode-generator-panel", style: { padding: "0.5rem" }, children: [_jsx("h3", { style: { margin: "0 0 0.5rem 0" }, children: "Generate barcode" }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Format", _jsx("select", { value: format, onChange: (e) => setFormat(e.target.value), style: { marginLeft: "0.5rem" }, children: formats.map((f) => (_jsx("option", { value: f, children: f }, f))) })] }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Payload", _jsx("input", { type: "text", value: payload, onChange: (e) => setPayload(e.target.value), "aria-label": "Barcode payload", style: { marginLeft: "0.5rem", width: "20em" } })] }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Width (mm, optional)", _jsx("input", { type: "number", min: "0", step: "0.1", value: widthMm ?? "", onChange: (e) => {
+                            // Empty input clears the hint — the renderer falls back
+                            // to its default sizing, which is format-dependent (EAN-13
+                            // = 37.29 × 25.93 mm at 100% magnification, GS1-128 is
+                            // payload-length-dependent, etc.). Don't pin a number
+                            // here because the panel doesn't know which renderer
+                            // backend is wired. The NaN guard catches paste / a11y
+                            // tool / programmatic-DOM cases where `type="number"`
+                            // browser validation is bypassed and a non-numeric string
+                            // reaches `Number()`.
+                            const v = e.target.value;
+                            const num = Number(v);
+                            setWidthMm(v === "" || Number.isNaN(num) ? undefined : num);
+                        }, style: { marginLeft: "0.5rem" } })] }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Height (mm, optional)", _jsx("input", { type: "number", min: "0", step: "0.1", value: heightMm ?? "", onChange: (e) => {
+                            const v = e.target.value;
+                            const num = Number(v);
+                            setHeightMm(v === "" || Number.isNaN(num) ? undefined : num);
+                        }, style: { marginLeft: "0.5rem" } })] }), _jsx("button", { type: "button", onClick: handleGenerate, disabled: busy, style: { padding: "0.4rem 0.8rem" }, children: busy ? "Generating…" : "Generate" }), error && (_jsx("div", { role: "alert", style: { marginTop: "0.5rem", color: "#a00" }, children: error }))] }));
+}
+//# sourceMappingURL=BarcodeGeneratorPanel.js.map

package/dist/components/BarcodeGeneratorPanel.js.map

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

package/dist/components/BraillePanel.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Marburg Medium dot-geometry defaults (EN 15823). Re-exported so
+ * server-side renderers can use the same constants for compliance
+ * checks. Values are in millimetres.
+ *
+ * @public
+ */
+export declare const MARBURG_MEDIUM: {
+    readonly dotHeightMm: 0.2;
+    readonly dotBaseDiameterMm: 1.44;
+    readonly dotSpacingMm: 2.5;
+    readonly cellWidthMm: 6;
+    readonly charSpacingMm: 5;
+    readonly lineSpacingMm: 10;
+};
+/**
+ * One Braille cell — six (or eight) dot booleans plus its x/y
+ * position in millimetres (relative to the panel's origin). Hosts
+ * render each dot as a vector ellipse / dome at the configured
+ * height + base diameter.
+ *
+ * Dot indices follow the canonical numbering:
+ * ```
+ * 1 4
+ * 2 5
+ * 3 6
+ * ```
+ *
+ * @public
+ */
+export type BrailleCell = {
+    char: string;
+    xMm: number;
+    yMm: number;
+    dots: readonly [boolean, boolean, boolean, boolean, boolean, boolean];
+};
+/**
+ * Result returned by {@link composeBraille}. `cells` is the placed
+ * cell list; `unicode` is the equivalent Unicode Braille string
+ * (U+28xx codepoints), useful for accessibility tools that already
+ * speak Braille; `unsupportedChars` lists any source characters the
+ * transliterator dropped so the host can warn the user.
+ *
+ * @public
+ */
+export type BrailleComposeResult = {
+    cells: BrailleCell[];
+    unicode: string;
+    unsupportedChars: string[];
+};
+/**
+ * Transliterate a Grade 1 English string into placed Braille cells.
+ * The function only covers letters, digits, and a small set of
+ * common punctuation; unsupported characters are dropped and
+ * surfaced via `unsupportedChars` so the host can warn the user.
+ *
+ * Cells are laid out left-to-right at `charSpacingMm` intervals on
+ * a single line, all at `y = 0`. Multi-line layout is the host's
+ * responsibility (it can chunk the input on `\n` and translate each
+ * line separately).
+ *
+ * Pure function — exported so RSC / Astro-frontmatter callers can
+ * pre-compute placement.
+ *
+ * @public
+ */
+export declare function composeBraille(input: {
+    text: string;
+    charSpacingMm?: number;
+}): BrailleComposeResult;
+/**
+ * @public
+ */
+export type BraillePanelProps = {
+    /** Fired when the user clicks "Compose" with the placed cells +
+     *  Unicode + unsupported-char report. The host renders the cells
+     *  as vector ellipses on the canvas. */
+    onCompose: (result: BrailleComposeResult) => void;
+    /** Initial text seeded into the form. Defaults to the empty
+     *  string. */
+    initialText?: string;
+    /** Initial character-spacing override; defaults to the Marburg
+     *  Medium constant. */
+    initialCharSpacingMm?: number;
+};
+/**
+ * Braille layout panel. The user types the source text, optionally
+ * tweaks character spacing for non-standard substrates, and clicks
+ * **Compose**; the host receives the placed cells.
+ *
+ * The panel does not render the Braille itself — preview is the
+ * host's responsibility because the dot geometry (ellipse vs.
+ * spherical dome) and the production process (foil-emboss vs. ink
+ * + spot-UV) drive how it should be visualised.
+ *
+ * @public
+ */
+export declare function BraillePanel({ onCompose, initialText, initialCharSpacingMm, }: BraillePanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BraillePanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BraillePanel.d.ts","sourceRoot":"","sources":["../../src/components/BraillePanel.tsx"],"names":[],"mappings":"AAwBA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAoFF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,oBAAoB,CAkEvB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;4CAEwC;IACxC,SAAS,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD;kBACc;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;2BACuB;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,WAAgB,EAChB,oBAAmD,GACpD,EAAE,iBAAiB,2CAsDnB"}