@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/lib/separations-registry.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Per-page registry of named spot inks the editor has identified.
+ *
+ * AI4 ("palette → spot") feeds this registry every time the user
+ * marks a fill or stroke color as a spot ink. The list rides on the
+ * page (see `Page.separations` in `dieline-template.ts`) and gets
+ * threaded through to compile-pdf via the
+ * `JobSubmitRequest.separationsOverride` field — bypassing the
+ * renderer's inference of separations from the document content.
+ *
+ * Wave 1 PR-7 (C3 SwatchesPicker) adds a "from library" flow that
+ * pre-fills `pantone` + `lab` via the compile-pdf spots endpoint.
+ * For now, the registry handles ad-hoc registration with whatever
+ * metadata the user has (a name, optionally a Pantone code).
+ *
+ * The helpers in this file are pure — they take an array and return
+ * a new array. State is owned by the caller (Page / EditorApp).
+ */
+/**
+ * Editor-side mirror of `@artworkpdf/document-model`'s `Separation`.
+ *
+ * Kept structural (not an import from document-model) so the
+ * editor-app package stays consumable by hosts that don't pull
+ * document-model in. The wire serialization is structurally
+ * compatible — when the export builder populates
+ * `separationsOverride` on the job request, an `EditorSeparation[]`
+ * satisfies the document-model `Separation[]` shape.
+ *
+ * @public
+ */
+export type EditorSeparation = {
+    /** Display name and the channel identity (e.g. `"PANTONE 185 C"`). */
+    name: string;
+    /** PDF color space. Spots use `"Spot"`; process inks use `"CMYK"`. */
+    colorSpace: "CMYK" | "Spot" | "DeviceN" | "RGB" | "Gray";
+    /** The source hex this spot was registered from (`#fc5102`). */
+    hex: string;
+    /** Canonical Pantone reference name, when known. */
+    pantone?: string;
+    /** Measured Lab triplet, when known (filled by C3's SwatchesPicker). */
+    lab?: {
+        L: number;
+        a: number;
+        b: number;
+    };
+    /** Channel type — informs the renderer's downstream handling. */
+    type?: "ink" | "varnish" | "foil" | "emboss" | "white";
+};
+/**
+ * Options accepted by {@link registerSpot} beyond the required name.
+ *
+ * @public
+ */
+export type RegisterSpotOptions = {
+    pantone?: string;
+    lab?: {
+        L: number;
+        a: number;
+        b: number;
+    };
+    type?: EditorSeparation["type"];
+    colorSpace?: EditorSeparation["colorSpace"];
+};
+/**
+ * Add (or replace) a spot keyed by `hex`. Idempotent — registering
+ * the same hex twice updates the existing entry rather than
+ * appending a duplicate. Comparison is case-insensitive.
+ *
+ * @returns A new array with the spot present. The input is not
+ *   mutated.
+ *
+ * @public
+ */
+export declare function registerSpot(seps: readonly EditorSeparation[], hex: string, name: string, opts?: RegisterSpotOptions): EditorSeparation[];
+/**
+ * Remove a spot by hex. No-op if absent.
+ *
+ * @returns A new array with the matching entry removed.
+ *
+ * @public
+ */
+export declare function unregisterSpot(seps: readonly EditorSeparation[], hex: string): EditorSeparation[];
+/**
+ * Lookup a registered spot by hex. Case-insensitive.
+ *
+ * @returns The matching `EditorSeparation` or `undefined`.
+ *
+ * @public
+ */
+export declare function findSpotByColor(seps: readonly EditorSeparation[], hex: string): EditorSeparation | undefined;
+/**
+ * Identity helper — returns the list as-is for symmetry with the
+ * other registry verbs. Use this at the export site to thread the
+ * page's spots into `JobSubmitRequest.separationsOverride`.
+ *
+ * @public
+ */
+export declare function listSpots(seps: readonly EditorSeparation[]): EditorSeparation[];
+//# sourceMappingURL=separations-registry.d.ts.map

package/dist/lib/separations-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"separations-registry.d.ts","sourceRoot":"","sources":["../../src/lib/separations-registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IACzD,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,iEAAiE;IACjE,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACxD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,mBAAwB,GAC7B,gBAAgB,EAAE,CAapB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,GAAG,EAAE,MAAM,GACV,gBAAgB,EAAE,CAGpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,GAAG,EAAE,MAAM,GACV,gBAAgB,GAAG,SAAS,CAG9B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAE/E"}

package/dist/lib/separations-registry.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * Add (or replace) a spot keyed by `hex`. Idempotent — registering
+ * the same hex twice updates the existing entry rather than
+ * appending a duplicate. Comparison is case-insensitive.
+ *
+ * @returns A new array with the spot present. The input is not
+ *   mutated.
+ *
+ * @public
+ */
+export function registerSpot(seps, hex, name, opts = {}) {
+    const normalized = hex.toLowerCase();
+    const next = {
+        name,
+        colorSpace: opts.colorSpace ?? "Spot",
+        hex: normalized,
+        ...(opts.pantone !== undefined ? { pantone: opts.pantone } : {}),
+        ...(opts.lab !== undefined ? { lab: opts.lab } : {}),
+        ...(opts.type !== undefined ? { type: opts.type } : {}),
+    };
+    const existingIdx = seps.findIndex((s) => s.hex.toLowerCase() === normalized);
+    if (existingIdx === -1)
+        return [...seps, next];
+    return seps.map((s, i) => (i === existingIdx ? next : s));
+}
+/**
+ * Remove a spot by hex. No-op if absent.
+ *
+ * @returns A new array with the matching entry removed.
+ *
+ * @public
+ */
+export function unregisterSpot(seps, hex) {
+    const normalized = hex.toLowerCase();
+    return seps.filter((s) => s.hex.toLowerCase() !== normalized);
+}
+/**
+ * Lookup a registered spot by hex. Case-insensitive.
+ *
+ * @returns The matching `EditorSeparation` or `undefined`.
+ *
+ * @public
+ */
+export function findSpotByColor(seps, hex) {
+    const normalized = hex.toLowerCase();
+    return seps.find((s) => s.hex.toLowerCase() === normalized);
+}
+/**
+ * Identity helper — returns the list as-is for symmetry with the
+ * other registry verbs. Use this at the export site to thread the
+ * page's spots into `JobSubmitRequest.separationsOverride`.
+ *
+ * @public
+ */
+export function listSpots(seps) {
+    return [...seps];
+}
+//# sourceMappingURL=separations-registry.js.map

package/dist/lib/separations-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"separations-registry.js","sourceRoot":"","sources":["../../src/lib/separations-registry.ts"],"names":[],"mappings":"AAAA,6CAA6C;AA4D7C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAiC,EACjC,GAAW,EACX,IAAY,EACZ,OAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAqB;QAC7B,IAAI;QACJ,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM;QACrC,GAAG,EAAE,UAAU;QACf,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IAC9E,IAAI,WAAW,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAiC,EACjC,GAAW;IAEX,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAiC,EACjC,GAAW;IAEX,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAiC;IACzD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/lib/streaming-render.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Wave 3 O3 — Streaming render: shared types + pure helpers.
+ *
+ * The compile-pdf side ships a `POST /v1/compose/stream` SSE
+ * endpoint that emits one event per page-start, page-done,
+ * output-chunk (chunked PDF bytes for progressive download), and a
+ * terminal `done` or `error`. The editor side wires an
+ * EventSource-style adapter (or a mock for tests) and surfaces
+ * progress.
+ *
+ * This module owns:
+ * - The discriminated-union event shape.
+ * - `parseStreamingRenderEvent` — pure parser. Returns null on
+ *   malformed input rather than throwing; the consumer is free to
+ *   drop unrecognised events.
+ * - `summarizeStreamingProgress` — folds an event sequence into a
+ *   summary suitable for a progress bar.
+ *
+ * @public
+ */
+/**
+ * Per-event payload shapes emitted by the streaming compose
+ * endpoint. The discriminator is `kind`. `event` exists on the SSE
+ * envelope; we lift it onto the parsed type for ergonomics.
+ *
+ * @public
+ */
+export type StreamingRenderEvent = {
+    kind: "page-start";
+    pageIndex: number;
+    totalPages: number;
+} | {
+    kind: "page-done";
+    pageIndex: number;
+    totalPages: number;
+    /** Wall-clock duration of the page render, in milliseconds. */
+    ms: number;
+} | {
+    kind: "output-chunk";
+    /** Base64-encoded PDF bytes for this chunk. The consumer
+     *  concatenates chunks to form the final PDF. */
+    chunkB64: string;
+    /** Cumulative bytes emitted so far (sum of decoded chunks). */
+    bytesEmitted: number;
+} | {
+    kind: "done";
+    pdfSha256: string;
+    cacheKey: string;
+} | {
+    kind: "error";
+    message: string;
+    code: string;
+};
+/**
+ * Pure parser — converts one SSE event (raw `event` field name +
+ * raw `data` JSON string) into a typed {@link StreamingRenderEvent}.
+ * Returns `null` for malformed input (bad JSON, unknown event kind,
+ * missing required fields). The consumer is free to drop nulls
+ * rather than abort the stream.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export declare function parseStreamingRenderEvent(eventName: string, data: string): StreamingRenderEvent | null;
+/**
+ * Aggregate progress summary computed from an event sequence.
+ * Suitable for driving a progress bar, percentage chip, or
+ * per-page badge list.
+ *
+ * @public
+ */
+export type StreamingProgress = {
+    /** 0..100. 100 when status is "done". */
+    percent: number;
+    completedPages: number;
+    totalPages: number;
+    /** Index of the page currently in-flight, or null when none. */
+    currentPage: number | null;
+    /** Cumulative decoded bytes received. */
+    receivedBytes: number;
+    status: "running" | "done" | "error";
+    /** Populated when status is "error". */
+    errorMessage?: string;
+    /** Set of `pageIndex` values that have landed `page-done` —
+     *  exposed so per-page badge renderers can do O(1) "is page N
+     *  done?" lookups instead of re-scanning the raw event list. */
+    completedPageIndices: ReadonlySet<number>;
+};
+/**
+ * Pure helper — folds an event sequence into a single
+ * {@link StreamingProgress}. Idempotent and order-tolerant beyond
+ * the obvious page-start-before-page-done constraint.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export declare function summarizeStreamingProgress(events: readonly StreamingRenderEvent[]): StreamingProgress;
+//# sourceMappingURL=streaming-render.d.ts.map

package/dist/lib/streaming-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-render.d.ts","sourceRoot":"","sources":["../../src/lib/streaming-render.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB;qDACiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,oBAAoB,GAAG,IAAI,CA6C7B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;oEAEgE;IAChE,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GACtC,iBAAiB,CA0DnB"}

package/dist/lib/streaming-render.js

@@ -0,0 +1,132 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * Pure parser — converts one SSE event (raw `event` field name +
+ * raw `data` JSON string) into a typed {@link StreamingRenderEvent}.
+ * Returns `null` for malformed input (bad JSON, unknown event kind,
+ * missing required fields). The consumer is free to drop nulls
+ * rather than abort the stream.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export function parseStreamingRenderEvent(eventName, data) {
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const p = parsed;
+    switch (eventName) {
+        case "page-start": {
+            const pageIndex = p.pageIndex;
+            const totalPages = p.totalPages;
+            if (typeof pageIndex !== "number" || typeof totalPages !== "number")
+                return null;
+            return { kind: "page-start", pageIndex, totalPages };
+        }
+        case "page-done": {
+            const pageIndex = p.pageIndex;
+            const totalPages = p.totalPages;
+            const ms = p.ms;
+            if (typeof pageIndex !== "number" || typeof totalPages !== "number")
+                return null;
+            if (typeof ms !== "number")
+                return null;
+            return { kind: "page-done", pageIndex, totalPages, ms };
+        }
+        case "output-chunk": {
+            const chunkB64 = p.chunkB64;
+            const bytesEmitted = p.bytesEmitted;
+            if (typeof chunkB64 !== "string" || typeof bytesEmitted !== "number")
+                return null;
+            return { kind: "output-chunk", chunkB64, bytesEmitted };
+        }
+        case "done": {
+            const pdfSha256 = p.pdf_sha256 ?? p.pdfSha256;
+            const cacheKey = p.cache_key ?? p.cacheKey;
+            if (typeof pdfSha256 !== "string" || typeof cacheKey !== "string")
+                return null;
+            return { kind: "done", pdfSha256, cacheKey };
+        }
+        case "error": {
+            const message = p.message;
+            const code = p.code;
+            if (typeof message !== "string" || typeof code !== "string")
+                return null;
+            return { kind: "error", message, code };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Pure helper — folds an event sequence into a single
+ * {@link StreamingProgress}. Idempotent and order-tolerant beyond
+ * the obvious page-start-before-page-done constraint.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export function summarizeStreamingProgress(events) {
+    // Track completion per page index so a duplicate `page-done`
+    // (backend retry, replay, etc.) doesn't double-count and push
+    // the percent above 100.
+    const completed = new Set();
+    let totalPages = 0;
+    let currentPage = null;
+    let receivedBytes = 0;
+    let status = "running";
+    let errorMessage;
+    for (const ev of events) {
+        switch (ev.kind) {
+            case "page-start":
+                totalPages = Math.max(totalPages, ev.totalPages);
+                currentPage = ev.pageIndex;
+                break;
+            case "page-done":
+                totalPages = Math.max(totalPages, ev.totalPages);
+                completed.add(ev.pageIndex);
+                if (currentPage === ev.pageIndex)
+                    currentPage = null;
+                break;
+            case "output-chunk":
+                receivedBytes = Math.max(receivedBytes, ev.bytesEmitted);
+                break;
+            case "done":
+                status = "done";
+                currentPage = null;
+                break;
+            case "error":
+                status = "error";
+                errorMessage = ev.message;
+                currentPage = null;
+                break;
+        }
+    }
+    const completedPages = completed.size;
+    const percent = status === "done"
+        ? 100
+        : totalPages > 0
+            ? Math.min(100, Math.round((completedPages / totalPages) * 100))
+            : 0;
+    return {
+        percent,
+        completedPages,
+        totalPages,
+        currentPage,
+        receivedBytes,
+        status,
+        ...(errorMessage !== undefined && { errorMessage }),
+        /** Set of pageIndex values that have landed `page-done`.
+         *  Exposed for consumers that render per-page badges so they
+         *  don't have to re-scan the raw event list. */
+        completedPageIndices: completed,
+    };
+}
+//# sourceMappingURL=streaming-render.js.map

package/dist/lib/streaming-render.js.map

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

package/dist/lib/unwired.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mark a feature as "flag exists but UI not shipped". Idempotent.
+ *
+ * Typical call site is at the bottom of the module that *would*
+ * render the UI when wired:
+ *
+ * ```ts
+ * // packages/editor-app/src/components/SeparationsPanel.tsx
+ * import { markUnwired } from "../lib/unwired";
+ * markUnwired("separations"); // wire-up lands in Wave 1
+ * ```
+ *
+ * @public
+ */
+export declare function markUnwired(feature: string): void;
+/**
+ * Test whether a feature has been marked unwired. Used by
+ * {@link import("./editor-config").showFeature}; hosts generally
+ * don't need to call this directly.
+ *
+ * @public
+ */
+export declare function isUnwired(feature: string): boolean;
+/**
+ * Test-only — clear the unwired set. Not exported through the
+ * public barrel.
+ */
+export declare function _resetUnwiredForTests(): void;
+//# sourceMappingURL=unwired.d.ts.map

package/dist/lib/unwired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwired.d.ts","sourceRoot":"","sources":["../../src/lib/unwired.ts"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/lib/unwired.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/**
+ * Unwired-feature registry.
+ *
+ * A feature is "unwired" when the *flag* exists in {@link EditorConfig}
+ * but the corresponding *UI* isn't shipped in this build yet (typical
+ * for forward-compatibility plumb-throughs like `enable_separations`
+ * — flag preps the surface; component lands in a later wave).
+ *
+ * Mirrors the pattern from `lens-pdf`. The set is module-scoped and
+ * in-memory only — there's no persistence. Components / packages
+ * call {@link markUnwired} at module-init time; {@link showFeature}
+ * reads via {@link isUnwired} to suppress UI for features whose flag
+ * is on but whose implementation hasn't landed.
+ *
+ * **The registry itself is the source of truth.** When no module
+ * calls `markUnwired(...)`, every flagged feature ships live;
+ * adding plumb-only flags in future waves means landing a
+ * `markUnwired("<feature>")` call alongside the flag and removing
+ * it when the UI ships. `grep -rn 'markUnwired(' packages/editor-app/src`
+ * reports the current set without doc maintenance.
+ */
+const UNWIRED = new Set();
+/**
+ * Mark a feature as "flag exists but UI not shipped". Idempotent.
+ *
+ * Typical call site is at the bottom of the module that *would*
+ * render the UI when wired:
+ *
+ * ```ts
+ * // packages/editor-app/src/components/SeparationsPanel.tsx
+ * import { markUnwired } from "../lib/unwired";
+ * markUnwired("separations"); // wire-up lands in Wave 1
+ * ```
+ *
+ * @public
+ */
+export function markUnwired(feature) {
+    UNWIRED.add(feature);
+}
+/**
+ * Test whether a feature has been marked unwired. Used by
+ * {@link import("./editor-config").showFeature}; hosts generally
+ * don't need to call this directly.
+ *
+ * @public
+ */
+export function isUnwired(feature) {
+    return UNWIRED.has(feature);
+}
+/**
+ * Test-only — clear the unwired set. Not exported through the
+ * public barrel.
+ */
+export function _resetUnwiredForTests() {
+    UNWIRED.clear();
+}
+//# sourceMappingURL=unwired.js.map

package/dist/lib/unwired.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwired.js","sourceRoot":"","sources":["../../src/lib/unwired.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@printwithsynergy/artwork-pdf-editor",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "artworkPDF WYSIWYG editor as a host-customizable React component. Drop-in mountable in Next.js, Astro, Remix, etc.",
   "license": "AGPL-3.0-or-later",
   "type": "module",
@@ -16,15 +16,16 @@
       "import": "./dist/lens/index.js"
     }
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "sideEffects": false,
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests"
-  },
   "dependencies": {
-    "pdf-lib": "^1.17.1"
+    "pdf-lib": "^1.17.1",
+    "three": "^0.170.0",
+    "@artworkpdf/dieline-parser": "0.1.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -34,20 +35,28 @@
     "@printwithsynergy/lens-pdf": "^0.4.0-beta.17"
   },
   "peerDependenciesMeta": {
-    "@printwithsynergy/lens-pdf": { "optional": true }
+    "@printwithsynergy/lens-pdf": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@printwithsynergy/lens-pdf": "^0.4.0-beta.17",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@types/three": "^0.170.0",
     "konva": "^10.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-konva": "^19.0.0",
     "typescript": "^5.7.0",
-    "vitest": "^3.2.0"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
   }
-}
+}

package/dist/components/SeparationsPanel.d.ts

@@ -1,9 +0,0 @@
-import type { CanvasObj } from "./EditorCanvas";
-type Props = {
-    objects: CanvasObj[];
-    hidden: Set<string>;
-    onToggle: (color: string) => void;
-};
-export declare function SeparationsPanel({ objects, hidden, onToggle }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=SeparationsPanel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SeparationsPanel.d.ts","sourceRoot":"","sources":["../../src/components/SeparationsPanel.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AA6HF,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,2CAuGpE"}