@printwithsynergy/artwork-pdf-editor 0.1.6 → 0.3.0

package/dist/lib/barcode-scan.js

@@ -0,0 +1,152 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * Canonical list of every {@link BarcodeFormat} the module supports.
+ * Exported so UI surfaces ({@link import("../components/BarcodeGeneratorPanel").BarcodeGeneratorPanel}
+ * default dropdown, host-supplied filters, contract tests) don't have
+ * to redeclare the list and drift out of sync when a new format is
+ * added to the union.
+ *
+ * @public
+ */
+export const ALL_BARCODE_FORMATS = [
+    "EAN-13",
+    "UPC-A",
+    "GS1-128",
+    "QR",
+];
+/**
+ * EAN-13 check-digit validation.
+ *
+ * EAN-13 is 13 digits; the 13th is a mod-10 checksum over the first
+ * 12 with alternating weights (1, 3, 1, 3, …). Returns `true` iff the
+ * input is exactly 13 ASCII digits and the checksum matches.
+ *
+ * @public
+ */
+export function validateEAN13(code) {
+    if (!/^[0-9]{13}$/.test(code))
+        return false;
+    let sum = 0;
+    for (let i = 0; i < 12; i++) {
+        const d = code.charCodeAt(i) - 48;
+        // Odd-positioned digits (1-indexed) get weight 1; even get 3.
+        sum += i % 2 === 0 ? d : d * 3;
+    }
+    const check = (10 - (sum % 10)) % 10;
+    return check === code.charCodeAt(12) - 48;
+}
+/**
+ * UPC-A check-digit validation.
+ *
+ * UPC-A is 12 digits; the 12th is a mod-10 checksum over the first
+ * 11 with weights (3, 1, 3, 1, …). Returns `true` iff the input is
+ * exactly 12 ASCII digits and the checksum matches.
+ *
+ * @public
+ */
+export function validateUPCA(code) {
+    if (!/^[0-9]{12}$/.test(code))
+        return false;
+    let sum = 0;
+    for (let i = 0; i < 11; i++) {
+        const d = code.charCodeAt(i) - 48;
+        // Odd-positioned digits (1-indexed) get weight 3; even get 1 —
+        // mirror image of EAN-13's weight pattern.
+        sum += i % 2 === 0 ? d * 3 : d;
+    }
+    const check = (10 - (sum % 10)) % 10;
+    return check === code.charCodeAt(11) - 48;
+}
+/**
+ * GS1-128 structural validation.
+ *
+ * GS1-128 (formerly UCC/EAN-128) encodes structured data using
+ * Application Identifiers — each AI is 2–4 digits followed by a
+ * data field of AI-dependent length. A full validator would require
+ * the AI table; the shippable approximation here checks that:
+ *
+ *   - The payload contains only printable ASCII (no control chars
+ *     other than the `<GS>` `0x1D` separator used between
+ *     variable-length data fields).
+ *   - The payload starts with at least two digits (the first AI).
+ *   - The payload is non-empty and ≤ 48 chars (real-world
+ *     GS1-128 codes rarely exceed this).
+ *
+ * Returns `true` for plausibly-structured payloads. False positives
+ * are intentional — preflight is a sanity check, not a parser.
+ *
+ * @public
+ */
+export function validateGS1128(code) {
+    if (code.length === 0 || code.length > 48)
+        return false;
+    if (!/^[0-9]{2}/.test(code))
+        return false;
+    // 0x1D is the GS separator GS1-128 uses; everything else must be
+    // printable ASCII so we don't accept binary garbage.
+    for (let i = 0; i < code.length; i++) {
+        const c = code.charCodeAt(i);
+        if (c === 0x1d)
+            continue;
+        if (c < 0x20 || c > 0x7e)
+            return false;
+    }
+    return true;
+}
+/**
+ * Format-aware validator that dispatches to the right per-format
+ * check. QR codes pass when the payload is non-empty (the symbol
+ * itself carries a Reed-Solomon checksum the detector already
+ * verified before emitting the {@link BarcodeDetection}).
+ *
+ * @public
+ */
+export function validateBarcode(detection) {
+    switch (detection.format) {
+        case "EAN-13":
+            return validateEAN13(detection.code)
+                ? { valid: true }
+                : { valid: false, reason: "EAN-13 check digit failed or wrong length (need 13 digits)" };
+        case "UPC-A":
+            return validateUPCA(detection.code)
+                ? { valid: true }
+                : { valid: false, reason: "UPC-A check digit failed or wrong length (need 12 digits)" };
+        case "GS1-128":
+            return validateGS1128(detection.code)
+                ? { valid: true }
+                : {
+                    valid: false,
+                    reason: "GS1-128 payload is empty, too long, or contains non-printable chars",
+                };
+        case "QR":
+            return detection.code.length > 0
+                ? { valid: true }
+                : { valid: false, reason: "QR payload is empty" };
+        default:
+            // Defensive: detectors that return formats outside our union
+            // (e.g. a future library reporting "Code128" before we add it
+            // to BarcodeFormat) would otherwise return undefined.
+            return { valid: false, reason: "Unsupported barcode format" };
+    }
+}
+/**
+ * Visual barcode detection from a rasterized image.
+ *
+ * Currently a stub: returns an empty array regardless of input. The
+ * real implementation lands in a follow-up that adds a barcode
+ * detection library (likely `jsqr` for QR + `quagga2` for linear).
+ * Until then, callers see no false positives, and the
+ * {@link validateBarcode} surface stays usable for codes the user
+ * (or G2g, Wave 3) declares directly on the canvas.
+ *
+ * The async signature is forward-compatible — most barcode
+ * detectors are async (decoder workers, WASM init), so callers
+ * don't need to refactor when the real detector lands.
+ *
+ * @public
+ */
+export async function scanBarcodes(_imageData) {
+    // TODO(wave-1 follow-up): integrate jsqr + a linear scanner.
+    return [];
+}
+//# sourceMappingURL=barcode-scan.js.map

package/dist/lib/barcode-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-scan.js","sourceRoot":"","sources":["../../src/lib/barcode-scan.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAwC7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC3D,QAAQ;IACR,OAAO;IACP,SAAS;IACT,IAAI;CACI,CAAC;AAoCX;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAClC,8DAA8D;QAC9D,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,OAAO,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAClC,+DAA+D;QAC/D,2CAA2C;QAC3C,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,OAAO,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,iEAAiE;IACjE,qDAAqD;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QACzB,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,SAA2B;IACzD,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC;gBAClC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;gBACjB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,4DAA4D,EAAE,CAAC;QAC7F,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;gBACjB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,2DAA2D,EAAE,CAAC;QAC5F,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC;gBACnC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;gBACjB,CAAC,CAAC;oBACE,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,qEAAqE;iBAC9E,CAAC;QACR,KAAK,IAAI;YACP,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;gBACjB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QACtD;YACE,6DAA6D;YAC7D,8DAA8D;YAC9D,sDAAsD;YACtD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAqB;IACtD,6DAA6D;IAC7D,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/color-math.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Tiny color-math helpers used by the C4 live-TAC sampler.
+ *
+ * Intentionally simple — the editor's TAC heatmap is a sanity check,
+ * not a colorimetric proof. Production color management lives
+ * server-side in compile-pdf (`codex_pdf.color`'s ICC-profile-aware
+ * conversion). These helpers do the cheap browser-side math so the
+ * editor can flag obviously over-inked regions without round-tripping
+ * to the server.
+ *
+ * Lab → CMYK is **not** here on purpose — that conversion is profile-
+ * dependent and codex owns it. The editor's spots (`EditorSeparation`)
+ * carry an optional `lab` for display, but TAC sampling uses the hex
+ * source color (via {@link hexToCmyk}) for browser-side speed.
+ */
+/**
+ * Subtractive RGB → CMYK with auto black extraction (the "K" channel
+ * is the minimum of the inverted RGB values; C/M/Y rescale once K is
+ * pulled).
+ *
+ * Each output channel is in the `[0, 1]` range — multiply by 100 for
+ * a percentage. Inputs that fall outside `0..1` are clamped (defensive
+ * against bad string parsing).
+ *
+ * @public
+ */
+export declare function rgbToCmyk(r: number, g: number, b: number): {
+    c: number;
+    m: number;
+    y: number;
+    k: number;
+};
+/**
+ * Parse a `#rrggbb` (or `rrggbb`) hex string into `[r, g, b]` floats
+ * in the `[0, 1]` range. Returns `null` for malformed input — callers
+ * fall back to whatever default they prefer.
+ *
+ * Accepts a leading `#` or not; case-insensitive. Short-form `#rgb`
+ * is **not** supported — the editor canonicalizes to long form at
+ * registration time (see `separations-registry.ts`'s lowercase
+ * normalization).
+ *
+ * @public
+ */
+export declare function parseHex(hex: string): [number, number, number] | null;
+/**
+ * Convert a `#rrggbb` hex string into CMYK fractions.
+ *
+ * Returns `null` for malformed input (delegates parsing to
+ * {@link parseHex}). Use the `.c + .m + .y + .k` sum × 100 for a
+ * total-area-coverage estimate on the pixel.
+ *
+ * @public
+ */
+export declare function hexToCmyk(hex: string): {
+    c: number;
+    m: number;
+    y: number;
+    k: number;
+} | null;
+/**
+ * Total area coverage of a single CMYK quadruple, in percent (0-400).
+ *
+ * Sum of all four ink channels — the standard print-industry TAC
+ * metric. The TAC limit on coated stock is usually 280-320%; on
+ * newsprint, 240%. The editor's preflight default is 300%.
+ *
+ * @public
+ */
+export declare function tacPercent(cmyk: {
+    c: number;
+    m: number;
+    y: number;
+    k: number;
+}): number;
+//# sourceMappingURL=color-math.d.ts.map

package/dist/lib/color-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-math.d.ts","sourceRoot":"","sources":["../../src/lib/color-math.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CASrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI5F;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvF"}

package/dist/lib/color-math.js

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * Tiny color-math helpers used by the C4 live-TAC sampler.
+ *
+ * Intentionally simple — the editor's TAC heatmap is a sanity check,
+ * not a colorimetric proof. Production color management lives
+ * server-side in compile-pdf (`codex_pdf.color`'s ICC-profile-aware
+ * conversion). These helpers do the cheap browser-side math so the
+ * editor can flag obviously over-inked regions without round-tripping
+ * to the server.
+ *
+ * Lab → CMYK is **not** here on purpose — that conversion is profile-
+ * dependent and codex owns it. The editor's spots (`EditorSeparation`)
+ * carry an optional `lab` for display, but TAC sampling uses the hex
+ * source color (via {@link hexToCmyk}) for browser-side speed.
+ */
+/**
+ * Subtractive RGB → CMYK with auto black extraction (the "K" channel
+ * is the minimum of the inverted RGB values; C/M/Y rescale once K is
+ * pulled).
+ *
+ * Each output channel is in the `[0, 1]` range — multiply by 100 for
+ * a percentage. Inputs that fall outside `0..1` are clamped (defensive
+ * against bad string parsing).
+ *
+ * @public
+ */
+export function rgbToCmyk(r, g, b) {
+    const R = Math.max(0, Math.min(1, r));
+    const G = Math.max(0, Math.min(1, g));
+    const B = Math.max(0, Math.min(1, b));
+    const k = 1 - Math.max(R, G, B);
+    if (k >= 1) {
+        // Pure black — no chroma channels, all ink in K.
+        return { c: 0, m: 0, y: 0, k: 1 };
+    }
+    const scale = 1 - k;
+    return {
+        c: (1 - R - k) / scale,
+        m: (1 - G - k) / scale,
+        y: (1 - B - k) / scale,
+        k,
+    };
+}
+/**
+ * Parse a `#rrggbb` (or `rrggbb`) hex string into `[r, g, b]` floats
+ * in the `[0, 1]` range. Returns `null` for malformed input — callers
+ * fall back to whatever default they prefer.
+ *
+ * Accepts a leading `#` or not; case-insensitive. Short-form `#rgb`
+ * is **not** supported — the editor canonicalizes to long form at
+ * registration time (see `separations-registry.ts`'s lowercase
+ * normalization).
+ *
+ * @public
+ */
+export function parseHex(hex) {
+    const trimmed = hex.trim();
+    const body = trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
+    if (body.length !== 6)
+        return null;
+    if (!/^[0-9a-fA-F]{6}$/.test(body))
+        return null;
+    const r = Number.parseInt(body.slice(0, 2), 16) / 255;
+    const g = Number.parseInt(body.slice(2, 4), 16) / 255;
+    const b = Number.parseInt(body.slice(4, 6), 16) / 255;
+    return [r, g, b];
+}
+/**
+ * Convert a `#rrggbb` hex string into CMYK fractions.
+ *
+ * Returns `null` for malformed input (delegates parsing to
+ * {@link parseHex}). Use the `.c + .m + .y + .k` sum × 100 for a
+ * total-area-coverage estimate on the pixel.
+ *
+ * @public
+ */
+export function hexToCmyk(hex) {
+    const rgb = parseHex(hex);
+    if (rgb === null)
+        return null;
+    return rgbToCmyk(rgb[0], rgb[1], rgb[2]);
+}
+/**
+ * Total area coverage of a single CMYK quadruple, in percent (0-400).
+ *
+ * Sum of all four ink channels — the standard print-industry TAC
+ * metric. The TAC limit on coated stock is usually 280-320%; on
+ * newsprint, 240%. The editor's preflight default is 300%.
+ *
+ * @public
+ */
+export function tacPercent(cmyk) {
+    return (cmyk.c + cmyk.m + cmyk.y + cmyk.k) * 100;
+}
+//# sourceMappingURL=color-math.js.map

package/dist/lib/color-math.js.map

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

package/dist/lib/dieline-template.d.ts

@@ -1,4 +1,21 @@
+import type { Dieline } from "@artworkpdf/dieline-parser";
 import type { CanvasObj } from "../components/EditorCanvas";
+import type { EditorSeparation } from "./separations-registry";
+/**
+ * One packaging structure — geometry + metadata for a known dieline
+ * (pouch, bottle wrap, carton, etc.).
+ *
+ * `dimensions` is the *trim* size in mm; `bleedMm` is the per-side
+ * bleed extension; `trimBox` is the trim rect in mm relative to the
+ * full bleed-included page. `previewSvg` is an inline string suitable
+ * for thumbnail rendering in the template-picker UI.
+ *
+ * Distinct from `@artworkpdf/document-model`'s `DielineTemplate`: the
+ * shape here is a published, self-contained type so the editor
+ * package doesn't force the document-model dep on hosts.
+ *
+ * @public
+ */
 export type DielineTemplate = {
     id: string;
     name: string;
@@ -25,9 +42,134 @@ export type DielineTemplate = {
  *  rather than being lumped in with artwork spot inks. */
 export declare const DIELINE_STROKE = "#fc5102";
 export declare const DIELINE_NAME = "Die Line";
+/**
+ * A multi-page dieline set — an ordered list of {@link DielineTemplate}
+ * ids that compose a single multi-page artwork document (e.g. a carton's
+ * front + back, or pouch front + back).
+ *
+ * @public
+ */
+export type TemplateSet = {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    pages: Array<{
+        templateId: string;
+        name?: string;
+    }>;
+    tags: string[];
+    isDefault?: boolean;
+};
+/**
+ * All bundled dieline templates, in library declaration order.
+ *
+ * Mirrors the shape of `data/dielines.json`. Hosts that want a
+ * filtered or ordered subset should derive from this array rather
+ * than reloading the JSON file.
+ *
+ * @public
+ */
 export declare const TEMPLATES: DielineTemplate[];
+/**
+ * Bundled multi-page template sets (e.g. carton front + back). Empty if
+ * the library has none.
+ *
+ * @public
+ */
+export declare const TEMPLATE_SETS: TemplateSet[];
+/**
+ * Return the library's default template (`isDefault: true`), falling
+ * back to the first entry. Throws if the library is empty — that
+ * would indicate a packaging defect, not a runtime condition.
+ *
+ * @public
+ */
 export declare function getDefaultTemplate(): DielineTemplate;
+/**
+ * Lookup by template id. Returns `undefined` (not throws) for
+ * unknown or missing ids so callers can fall back to a default.
+ *
+ * @public
+ */
 export declare function getTemplateById(id: string | undefined): DielineTemplate | undefined;
+/**
+ * Lookup a multi-page template set by id (e.g. `"carton-6x4x2-set"`).
+ * Returns `undefined` for unknown / missing.
+ *
+ * @public
+ */
+export declare function getTemplateSetById(id: string | undefined): TemplateSet | undefined;
+/**
+ * Expand a {@link TemplateSet} into an ordered list of {@link Page}s.
+ * Each set entry resolves to its `DielineTemplate`; unknown ids are
+ * skipped (so callers always get a non-throwing result they can fall
+ * back from).
+ *
+ * @public
+ */
+export declare function templateSetToPages(set: TemplateSet, bleedMmOverride?: number): Page[];
+/**
+ * One page of a multi-page artwork document. Carries the dieline rect
+ * + any user-drawn objects, plus the per-page geometry (pageSize, bleed).
+ * Used as the array element of {@link EditorAppProps.initialPages}.
+ *
+ * @public
+ */
+export type Page = {
+    /** Stable id (e.g. `uuid()` or ``page-${i}``) — used as a React key. */
+    id: string;
+    objects: CanvasObj[];
+    pageSize: {
+        width: number;
+        height: number;
+    };
+    bleedMm: number;
+    /** Source template id, when this page was seeded from a known dieline. */
+    templateId?: string;
+    /** Human label shown in the page navigator (e.g. "Front", "Back"). */
+    name?: string;
+    /** AI4 separations registry — spot inks the user has registered
+     *  on this page. Threads through to compile-pdf via the
+     *  job request's `separationsOverride`. Absent → no overrides;
+     *  empty array → explicit composite-only render. */
+    separations?: EditorSeparation[];
+};
+/**
+ * Build a {@link Page} from a {@link DielineTemplate}. Mirrors the
+ * single-page {@link templateToInitialState} output but in the new
+ * multi-page shape. Use this to seed `EditorAppProps.initialPages`.
+ *
+ * @public
+ */
+export declare function templateToPage(template: DielineTemplate, bleedMmOverride?: number, name?: string): Page;
+/**
+ * Build a list of {@link Page}s from an ordered set of templates +
+ * per-page names. Convenience for multi-page document sets (e.g. a
+ * carton's front / back / spine).
+ *
+ * @public
+ */
+export declare function templatesToPages(entries: ReadonlyArray<{
+    template: DielineTemplate;
+    name?: string;
+}>, bleedMmOverride?: number): Page[];
+/**
+ * Build the initial canvas state for a single template — the dieline
+ * trim rect (locked, non-interactive) plus the page size including
+ * bleed on all sides.
+ *
+ * Pass `bleedMmOverride` to use a host-supplied bleed instead of the
+ * template's bundled value (e.g. when the user picks a custom bleed
+ * in the URL or UI). Returned coordinates are in PDF points
+ * (1 mm = 2.83465 pt).
+ *
+ * Use this for single-page seeds; for multi-page documents use
+ * {@link templateToPage} or {@link templatesToPages} which wrap the
+ * result in a {@link Page}.
+ *
+ * @public
+ */
 export declare function templateToInitialState(template: DielineTemplate, bleedMmOverride?: number): {
     objects: CanvasObj[];
     pageSize: {
@@ -35,4 +177,31 @@ export declare function templateToInitialState(template: DielineTemplate, bleedM
         height: number;
     };
 };
+/**
+ * Build a {@link Page} from a parsed {@link Dieline} (CF2 / DDES /
+ * ARD import).
+ *
+ * Each `DielinePath` becomes one locked `CanvasObj` of type `"path"`
+ * rendered as a Konva `Path` (the `Path` import was added to
+ * `EditorCanvas` for this case). Type-specific stroke colors come
+ * from {@link DIELINE_PATH_STROKES}. The whole page is locked so
+ * users can't accidentally drag the structural reference geometry —
+ * same invariant as the bundled-template dieline rect.
+ *
+ * Coordinate units: the parser emits SVG path `d` strings in
+ * **dieline-native millimeters** (Y-down). We position each path
+ * object at `(bleedMm * MM_TO_PT, bleedMm * MM_TO_PT)` so the dieline
+ * trim sits inside the bleed margin. The path data itself is in
+ * mm — Konva renders it without further conversion because the
+ * containing Stage is configured in points and the relative offsets
+ * align (the Stage's own scale handles the mm→pt for display).
+ *
+ * `bleedMmOverride`: pass a host-supplied bleed (URL param, UI
+ * input) instead of the default. Defaults to 0 for parsed dielines —
+ * the source files don't carry their own bleed convention and the
+ * caller is the right place to decide.
+ *
+ * @public
+ */
+export declare function dielineToPage(dieline: Dieline, bleedMmOverride?: number): Page;
 //# sourceMappingURL=dieline-template.d.ts.map

package/dist/lib/dieline-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dieline-template.d.ts","sourceRoot":"","sources":["../../src/lib/dieline-template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAIF;;0DAE0D;AAC1D,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,eAAO,MAAM,SAAS,EAAE,eAAe,EAA4D,CAAC;AAEpG,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAGnF;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,eAAe,CAAC,EAAE,MAAM,GACvB;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,CAyBA"}
+{"version":3,"file":"dieline-template.d.ts","sourceRoot":"","sources":["../../src/lib/dieline-template.ts"],"names":[],"mappings":"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"}