@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/lib/editor-config.js

@@ -1,4 +1,5 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
+import { isUnwired } from "./unwired";
 /**
  * Default flag set — every feature on. Hosts that want a minimal
  * embed (e.g. an inline `<EditorApp>` on a landing page) layer their
@@ -30,9 +31,55 @@ export const DEFAULT_EDITOR_CONFIG = {
     // Panels
     enable_layers_panel: true,
     enable_preflight_banner: true,
+    enable_palettes: true,
+    enable_separations: true,
+    enable_dieline_parameters: true,
+    enable_dieline_preview: true,
+    enable_inks_panel: true,
+    enable_swatches: true,
+    enable_white_underbase: true,
+    enable_streaming_render: true,
+    enable_panel_anchored_objects: true,
+    enable_compliance_panel: true,
+    enable_process_rules_panel: true,
+    enable_preflight_diff: true,
+    enable_brand_assets_panel: true,
+    enable_history: true,
+    enable_dieline_import: true,
+    enable_annotation_overlay: true,
+    enable_variant_matrix_versions: true,
+    enable_mark_library: true,
+    enable_slack_notify: true,
+    enable_preflight_autofix: true,
+    enable_smart_spot_match: true,
+    enable_design_suggestions: true,
+    enable_annotations_sidebar: true,
+    enable_brand_consistency: true,
+    enable_webhook_notify: true,
+    enable_email_notify: true,
+    enable_accessibility_hints: true,
+    enable_palette_to_spot: true,
+    // Job setup
+    enable_print_context: true,
     // Canvas
     enable_canvas_grid: true,
     enable_bleed_visualization: true,
+    enable_total_ink_coverage_live: true,
+    enable_trap_preview: true,
+    enable_trap_editor: true,
+    enable_impose: true,
+    enable_3d_fold_preview: true,
+    enable_fold_editor: true,
+    enable_mis_estimate: true,
+    enable_process_preflight: true,
+    enable_soft_proof: true,
+    enable_variant_matrix: true,
+    enable_barcode_generate: true,
+    enable_barcode_validation: true,
+    enable_gs1_digital_link: true,
+    enable_nutrition_panel: true,
+    enable_braille_panel: true,
+    enable_variable_data_merge: true,
 };
 /**
  * Basic-mode preset: hides the heavyweight pro panels and the source
@@ -61,4 +108,47 @@ export function resolveConfig(mode, instanceOverrides) {
     const modeOverrides = mode === "basic" ? BASIC_MODE_OVERRIDES : PRO_MODE_OVERRIDES;
     return { ...DEFAULT_EDITOR_CONFIG, ...modeOverrides, ...instanceOverrides };
 }
+/**
+ * Resolve whether a feature should be visible right now.
+ *
+ * Evaluates four gates and returns true iff *all* are open:
+ *   1. `enable_<f>` is not explicitly `false`.
+ *   2. `plan_gates[f]` is not explicitly `false` (absent = open).
+ *   3. `capabilities[f]` is not explicitly `false` (absent = open).
+ *   4. `f` hasn't been marked unwired via
+ *      {@link import("./unwired").markUnwired}.
+ *
+ * Use this at every render site that gates a feature; the four-layer
+ * separation lets hosts distinguish "we hid it" from "the plan
+ * doesn't include it" from "the backend can't do it right now" from
+ * "the editor build doesn't ship this UI yet" without losing the
+ * underlying boolean flag.
+ *
+ * @public
+ */
+export function showFeature(cfg, f) {
+    const enabled = cfg[`enable_${f}`] !== false;
+    const plan = cfg.plan_gates?.[f] !== false;
+    const capable = cfg.capabilities?.[f] !== false;
+    const wired = !isUnwired(f);
+    return enabled && plan && capable && wired;
+}
+/**
+ * Resolve whether a palette should render.
+ *
+ * Two gates:
+ *   1. `enable_palettes` is not explicitly `false`. When the
+ *      palettes feature is off, *all* palettes are forced visible —
+ *      the visibility map is a UI toggle, not a kill switch, so
+ *      hiding the toggle UI must not silently hide content.
+ *   2. `panelVisibility[id]` is not explicitly `false` (absent or
+ *      `true` means visible).
+ *
+ * @public
+ */
+export function isPanelVisible(cfg, id) {
+    if (cfg.enable_palettes === false)
+        return true;
+    return cfg.panelVisibility?.[id] !== false;
+}
 //# sourceMappingURL=editor-config.js.map

package/dist/lib/editor-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-config.js","sourceRoot":"","sources":["../../src/lib/editor-config.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAgD7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,SAAS;IACT,iBAAiB,EAAE,IAAI;IACvB,oBAAoB,EAAE,IAAI;IAC1B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,iBAAiB,EAAE,IAAI;IACvB,UAAU;IACV,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,IAAI;IAC1B,sBAAsB,EAAE,IAAI;IAC5B,kBAAkB,EAAE,IAAI;IACxB,SAAS;IACT,mBAAmB,EAAE,IAAI;IACzB,uBAAuB,EAAE,IAAI;IAC7B,SAAS;IACT,kBAAkB,EAAE,IAAI;IACxB,0BAA0B,EAAE,IAAI;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B,EAAE,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAqB,EACrB,iBAAyC;IAEzC,MAAM,aAAa,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACnF,OAAO,EAAE,GAAG,qBAAqB,EAAE,GAAG,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"editor-config.js","sourceRoot":"","sources":["../../src/lib/editor-config.ts"],"names":[],"mappings":"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"}

package/dist/lib/fold-geometry.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Editor-side structural mirror of `@artworkpdf/document-model`'s
+ * `FoldGeometryPanel`. Kept inline so the editor-app package stays
+ * consumable by hosts that don't pull document-model in — the wire
+ * shape is structurally compatible.
+ *
+ * @public
+ */
+export type FoldGeometryPanel = {
+    id: string;
+    pathData: string;
+    bbox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    role?: string;
+    name?: string;
+};
+/**
+ * Editor-side structural mirror of `@artworkpdf/document-model`'s
+ * `FoldGeometryPanelMetadata`.
+ *
+ * @public
+ */
+export type FoldGeometryPanelMetadata = {
+    panels: FoldGeometryPanel[];
+};
+/**
+ * Editor-side structural mirror of `@artworkpdf/document-model`'s
+ * `FoldGeometryEdge`.
+ *
+ * @public
+ */
+export type FoldGeometryEdge = {
+    id: string;
+    panelA: string;
+    panelB: string;
+    angleDeg: number;
+    direction?: "mountain" | "valley";
+};
+/**
+ * Editor-side structural mirror of `@artworkpdf/document-model`'s
+ * `FoldGeometryConfig`.
+ *
+ * @public
+ */
+export type FoldGeometryConfig = {
+    edges: FoldGeometryEdge[];
+    defaultAngleDeg?: number;
+};
+/**
+ * S4 — fold-geometry math.
+ *
+ * Pure functions that convert a {@link FoldGeometryPanelMetadata} + {@link FoldGeometryConfig}
+ * pair into the data a 3D renderer needs to draw a folded carton:
+ * per-panel quads in 3D space, and per-edge hinge axes.
+ *
+ * No Three.js / React / DOM imports — this file is the unit-testable
+ * core that the {@link import("../components/FoldPreviewOverlay").FoldPreviewOverlay}
+ * component drives. Hosts wanting an alternative renderer (Babylon,
+ * raw WebGL) can consume these helpers directly.
+ *
+ * Coordinate system
+ * -----------------
+ * - 2D inputs (`bbox.x`, `bbox.y`, `bbox.width`, `bbox.height`) are
+ *   in page-local units; the conventions match {@link PageV3.unit}.
+ * - 3D outputs are in the same units — no rescaling — with the page
+ *   plane as the XY plane (Z = 0 when fully unfolded) and Z+ pointing
+ *   up out of the page. Mountain folds bend Z+; valley folds bend Z-.
+ * - Angles are in degrees clockwise around the hinge axis (Z+ is the
+ *   handedness for the right-hand rule on the hinge direction).
+ *
+ * Wave 2 PR-3 scope: a flat layout (every panel at Z=0, no folding
+ * applied) plus the hinge metadata. PR-4 adds interactive angle
+ * scrubbing that drives `applyFolds()` over this scaffold.
+ */
+/**
+ * Output shape — one panel projected into 3D space as a four-corner
+ * quad. The quad is wound counter-clockwise viewed from +Z (the
+ * standard "front face" convention).
+ *
+ * @public
+ */
+export type FoldPanelQuad = {
+    /** Source {@link FoldGeometryPanel.id} this quad represents. */
+    panelId: string;
+    /** Four corners in world space. Order: top-left, top-right,
+     *  bottom-right, bottom-left when viewed from +Z. Each corner is
+     *  `[x, y, z]`. */
+    corners: readonly [
+        readonly [number, number, number],
+        readonly [number, number, number],
+        readonly [number, number, number],
+        readonly [number, number, number]
+    ];
+};
+/**
+ * Output shape — one hinge axis projected into 3D space.
+ *
+ * @public
+ */
+export type FoldHingeAxis = {
+    /** Source {@link FoldGeometryEdge.id} this axis represents. */
+    edgeId: string;
+    /** Hinge start in world space. */
+    from: readonly [number, number, number];
+    /** Hinge end in world space. */
+    to: readonly [number, number, number];
+    /** Mountain (Z+) or valley (Z-) bend handedness. */
+    direction: "mountain" | "valley";
+};
+/**
+ * Aggregate scene specification — everything a Three.js scene needs
+ * to draw the foldable artwork.
+ *
+ * @public
+ */
+export type FoldSceneSpec = {
+    panels: FoldPanelQuad[];
+    hinges: FoldHingeAxis[];
+    /** AABB of every projected panel; useful for camera framing. */
+    bounds: {
+        min: readonly [number, number, number];
+        max: readonly [number, number, number];
+    };
+};
+/**
+ * Build a {@link FoldSceneSpec} from a panel registry and (optional)
+ * fold config.
+ *
+ * PR-3 scope: emits a *flat* layout — every panel sits at Z=0 with
+ * its bbox-derived corners. The fold angles in `foldConfig` are
+ * carried through onto the hinge axes for downstream renderers but
+ * are not applied to panel positions here. PR-4 adds `applyFolds()`
+ * which mutates panel corners according to the angles.
+ *
+ * Returns an empty spec when `panels` is empty.
+ *
+ * @public
+ */
+export declare function buildFoldScene(panelMetadata: FoldGeometryPanelMetadata, foldConfig?: FoldGeometryConfig): FoldSceneSpec;
+//# sourceMappingURL=fold-geometry.d.ts.map

package/dist/lib/fold-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-geometry.d.ts","sourceRoot":"","sources":["../../src/lib/fold-geometry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;;uBAEmB;IACnB,OAAO,EAAE,SAAS;QAChB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gCAAgC;IAChC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oDAAoD;IACpD,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;CAClC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,gEAAgE;IAChE,MAAM,EAAE;QACN,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH,CAAC;AAOF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,yBAAyB,EACxC,UAAU,CAAC,EAAE,kBAAkB,GAC9B,aAAa,CASf"}

package/dist/lib/fold-geometry.js

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+const EMPTY_BOUNDS = {
+    min: [0, 0, 0],
+    max: [0, 0, 0],
+};
+/**
+ * Build a {@link FoldSceneSpec} from a panel registry and (optional)
+ * fold config.
+ *
+ * PR-3 scope: emits a *flat* layout — every panel sits at Z=0 with
+ * its bbox-derived corners. The fold angles in `foldConfig` are
+ * carried through onto the hinge axes for downstream renderers but
+ * are not applied to panel positions here. PR-4 adds `applyFolds()`
+ * which mutates panel corners according to the angles.
+ *
+ * Returns an empty spec when `panels` is empty.
+ *
+ * @public
+ */
+export function buildFoldScene(panelMetadata, foldConfig) {
+    const panels = panelMetadata.panels.map(panelToQuad);
+    const hinges = foldConfig ? foldConfig.edges.map((e) => edgeToHinge(e, panelMetadata)) : [];
+    const validHinges = hinges.filter((h) => h !== null);
+    return {
+        panels,
+        hinges: validHinges,
+        bounds: panels.length === 0 ? EMPTY_BOUNDS : computeBounds(panels),
+    };
+}
+/** Flip a 2D page-coord Y into 3D world Y. Normalizes IEEE-754
+ *  negative-zero (`-0`) to positive zero so test equality and JSON
+ *  serialization don't surprise consumers. */
+function flipY(y) {
+    const flipped = -y;
+    return flipped === 0 ? 0 : flipped;
+}
+function panelToQuad(panel) {
+    const { x, y, width, height } = panel.bbox;
+    // Wind counter-clockwise viewed from +Z; +Y points away from
+    // viewer in the page-coord convention, so we flip Y here so the
+    // 3D scene reads the same way as the canvas.
+    return {
+        panelId: panel.id,
+        corners: [
+            [x, flipY(y), 0],
+            [x + width, flipY(y), 0],
+            [x + width, flipY(y + height), 0],
+            [x, flipY(y + height), 0],
+        ],
+    };
+}
+function edgeToHinge(edge, panelMetadata) {
+    // The hinge is the shared edge between two panels. Find both, then
+    // use the closer pair of bbox edges as the hinge axis. Dangling
+    // edge refs (panelA/panelB ids not present) are skipped — the
+    // editor enforces referential integrity on save, but renderers
+    // should be defensive.
+    const a = panelMetadata.panels.find((p) => p.id === edge.panelA);
+    const b = panelMetadata.panels.find((p) => p.id === edge.panelB);
+    if (!a || !b)
+        return null;
+    const seam = sharedEdge(a, b);
+    if (!seam)
+        return null;
+    return {
+        edgeId: edge.id,
+        from: [seam.from[0], flipY(seam.from[1]), 0],
+        to: [seam.to[0], flipY(seam.to[1]), 0],
+        direction: edge.direction ?? "mountain",
+    };
+}
+/** Find the closest aligned pair of bbox edges between two panels.
+ *  Returns the seam in page-local 2D coords, or `null` when the
+ *  panels don't share an edge within a 0.5-unit tolerance. */
+function sharedEdge(a, b) {
+    const TOL = 0.5;
+    const ar = bboxRect(a.bbox);
+    const br = bboxRect(b.bbox);
+    // Vertical seam: a's right edge meets b's left, or vice versa.
+    if (Math.abs(ar.x + ar.w - br.x) < TOL) {
+        const y0 = Math.max(ar.y, br.y);
+        const y1 = Math.min(ar.y + ar.h, br.y + br.h);
+        if (y1 > y0)
+            return { from: [br.x, y0], to: [br.x, y1] };
+    }
+    if (Math.abs(br.x + br.w - ar.x) < TOL) {
+        const y0 = Math.max(ar.y, br.y);
+        const y1 = Math.min(ar.y + ar.h, br.y + br.h);
+        if (y1 > y0)
+            return { from: [ar.x, y0], to: [ar.x, y1] };
+    }
+    // Horizontal seam: a's bottom edge meets b's top, or vice versa.
+    if (Math.abs(ar.y + ar.h - br.y) < TOL) {
+        const x0 = Math.max(ar.x, br.x);
+        const x1 = Math.min(ar.x + ar.w, br.x + br.w);
+        if (x1 > x0)
+            return { from: [x0, br.y], to: [x1, br.y] };
+    }
+    if (Math.abs(br.y + br.h - ar.y) < TOL) {
+        const x0 = Math.max(ar.x, br.x);
+        const x1 = Math.min(ar.x + ar.w, br.x + br.w);
+        if (x1 > x0)
+            return { from: [x0, ar.y], to: [x1, ar.y] };
+    }
+    return null;
+}
+function bboxRect(bbox) {
+    return { x: bbox.x, y: bbox.y, w: bbox.width, h: bbox.height };
+}
+function computeBounds(panels) {
+    let minX = Number.POSITIVE_INFINITY;
+    let minY = Number.POSITIVE_INFINITY;
+    let minZ = Number.POSITIVE_INFINITY;
+    let maxX = Number.NEGATIVE_INFINITY;
+    let maxY = Number.NEGATIVE_INFINITY;
+    let maxZ = Number.NEGATIVE_INFINITY;
+    for (const p of panels) {
+        for (const [x, y, z] of p.corners) {
+            if (x < minX)
+                minX = x;
+            if (y < minY)
+                minY = y;
+            if (z < minZ)
+                minZ = z;
+            if (x > maxX)
+                maxX = x;
+            if (y > maxY)
+                maxY = y;
+            if (z > maxZ)
+                maxZ = z;
+        }
+    }
+    return {
+        min: [minX, minY, minZ],
+        max: [maxX, maxY, maxZ],
+    };
+}
+//# sourceMappingURL=fold-geometry.js.map

package/dist/lib/fold-geometry.js.map

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

package/dist/lib/merge-tokens.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Wave 3 V1 — Variable-data merge helpers.
+ *
+ * V1 ships the data-side hooks that turn a Wave 2 V2 variant matrix
+ * (rows of `{ tokenName: value }`) and a template string with
+ * `{{token}}` placeholders into an ordered list of per-variant
+ * rendered strings, ready for compose. The editor stays agnostic to
+ * the actual PDF render — these helpers run in the browser to power
+ * a preview, then the same logic runs server-side (or in compose)
+ * for the final merge.
+ *
+ * Tokens use double-curly delimiters (`{{firstName}}`). Whitespace
+ * inside the delimiters is tolerated (`{{ firstName }}`) — the
+ * extracted name is trimmed. Adjacent or nested delimiters are not
+ * supported (and would generate invalid PDF text anyway).
+ *
+ * @public
+ */
+/**
+ * One row in a variant matrix. Keyed by token name, valued by the
+ * substitute string. Mirrors the shape produced by Wave 2 V2's
+ * {@link import("../components/VariantMatrixPanel").VariantMatrixPanelVariant}.
+ *
+ * @public
+ */
+export type MergeRow = Record<string, string>;
+/**
+ * Result of validating a merge manifest. Empty arrays mean the
+ * manifest is valid for this row; `missingTokens` is the list of
+ * placeholders in the template that have no entry in the row;
+ * `unusedColumns` is the inverse — keys in the row that the template
+ * doesn't reference (useful for warning hosts about typos in
+ * column names).
+ *
+ * @public
+ */
+export type MergeValidationResult = {
+    missingTokens: string[];
+    unusedColumns: string[];
+};
+/**
+ * Extract every `{{token}}` name (deduplicated, in first-occurrence
+ * order) from a template string. Whitespace inside the delimiters
+ * is tolerated and the returned names are trimmed.
+ *
+ * @public
+ */
+export declare function extractMergeTokens(template: string): string[];
+/**
+ * Replace every `{{token}}` in `template` with the matching value
+ * from `row`. Tokens with no entry in the row are replaced with the
+ * empty string and surfaced via the second return value so the host
+ * can warn the user.
+ *
+ * @public
+ */
+export declare function mergeRow(template: string, row: MergeRow): {
+    merged: string;
+    missingTokens: string[];
+};
+/**
+ * Validate a row against a template — quick check before kicking
+ * off a compose-side merge. Returns the list of `missingTokens` the
+ * row lacks and the list of `unusedColumns` (row keys the template
+ * doesn't reference).
+ *
+ * @public
+ */
+export declare function validateMergeManifest(template: string, row: MergeRow): MergeValidationResult;
+/**
+ * Merge every row in a variant matrix against a template. Returns
+ * one merged string per row, plus a per-row missing-token list so
+ * the host can surface a "row N missing tokens X/Y" warning.
+ *
+ * @public
+ */
+export declare function mergeAllRows(template: string, rows: readonly MergeRow[]): {
+    merged: string;
+    missingTokens: string[];
+}[];
+//# sourceMappingURL=merge-tokens.d.ts.map

package/dist/lib/merge-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-tokens.d.ts","sourceRoot":"","sources":["../../src/lib/merge-tokens.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc7D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,QAAQ,GACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB7C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,qBAAqB,CAY5F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,QAAQ,EAAE,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAE/C"}

package/dist/lib/merge-tokens.js

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+const TOKEN_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
+/**
+ * Extract every `{{token}}` name (deduplicated, in first-occurrence
+ * order) from a template string. Whitespace inside the delimiters
+ * is tolerated and the returned names are trimmed.
+ *
+ * @public
+ */
+export function extractMergeTokens(template) {
+    const seen = new Set();
+    const order = [];
+    TOKEN_RE.lastIndex = 0;
+    let m = TOKEN_RE.exec(template);
+    while (m !== null) {
+        const name = m[1];
+        if (name !== undefined && !seen.has(name)) {
+            seen.add(name);
+            order.push(name);
+        }
+        m = TOKEN_RE.exec(template);
+    }
+    return order;
+}
+/**
+ * Replace every `{{token}}` in `template` with the matching value
+ * from `row`. Tokens with no entry in the row are replaced with the
+ * empty string and surfaced via the second return value so the host
+ * can warn the user.
+ *
+ * @public
+ */
+export function mergeRow(template, row) {
+    const missingSet = new Set();
+    // `String.prototype.replace` with a `/g` regex doesn't read
+    // `lastIndex`, but the same regex is reused by `extractMergeTokens`
+    // via `.exec`. Resetting up front decouples call ordering and avoids
+    // a class of stateful-regex bugs.
+    TOKEN_RE.lastIndex = 0;
+    const merged = template.replace(TOKEN_RE, (_match, rawName) => {
+        const name = rawName.trim();
+        // `Object.hasOwn` (not `name in row` / `row[name] !== undefined`)
+        // — otherwise tokens like `{{toString}}` resolve to the inherited
+        // `Object.prototype.toString` method and silently corrupt the
+        // merged output. `validateMergeManifest` already uses `Object.keys`
+        // (own enumerable keys), so this keeps the two helpers in sync.
+        if (!Object.hasOwn(row, name)) {
+            missingSet.add(name);
+            return "";
+        }
+        return row[name] ?? "";
+    });
+    return { merged, missingTokens: [...missingSet] };
+}
+/**
+ * Validate a row against a template — quick check before kicking
+ * off a compose-side merge. Returns the list of `missingTokens` the
+ * row lacks and the list of `unusedColumns` (row keys the template
+ * doesn't reference).
+ *
+ * @public
+ */
+export function validateMergeManifest(template, row) {
+    const tokens = new Set(extractMergeTokens(template));
+    const columns = new Set(Object.keys(row));
+    const missingTokens = [];
+    const unusedColumns = [];
+    for (const token of tokens) {
+        if (!columns.has(token))
+            missingTokens.push(token);
+    }
+    for (const column of columns) {
+        if (!tokens.has(column))
+            unusedColumns.push(column);
+    }
+    return { missingTokens, unusedColumns };
+}
+/**
+ * Merge every row in a variant matrix against a template. Returns
+ * one merged string per row, plus a per-row missing-token list so
+ * the host can surface a "row N missing tokens X/Y" warning.
+ *
+ * @public
+ */
+export function mergeAllRows(template, rows) {
+    return rows.map((row) => mergeRow(template, row));
+}
+//# sourceMappingURL=merge-tokens.js.map

package/dist/lib/merge-tokens.js.map

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

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

@@ -0,0 +1,40 @@
+import type { PaletteId } from "./editor-config";
+/**
+ * Static metadata for one entry in the palette registry.
+ *
+ * `slot` follows lens-pdf's `<vendor>.<area>.<feature>` convention —
+ * `panel.right` for right-rail panels, `panel.left` for left-rail,
+ * `panel.modal` for modal-style panels. The convention lets future
+ * host-side plugin systems route palettes to the right region
+ * without hard-coding ids.
+ *
+ * `label` is the human-readable name shown in the PaletteManager
+ * overflow and the mobile drawer "Panels" section.
+ *
+ * @public
+ */
+export type PaletteRegistryEntry = {
+    slot: string;
+    label: string;
+};
+/**
+ * The canonical map of every {@link PaletteId} the editor knows about,
+ * keyed for fast lookup by `PaletteManager` / `MobileToolDrawer`.
+ *
+ * `layers` and `preflight` are wired in the current EditorApp; the
+ * other ids are registered for forward compatibility — Wave 1+
+ * components will mount them and (where the flag exists but the UI
+ * doesn't yet) call `markUnwired(...)`.
+ *
+ * @public
+ */
+export declare const PALETTE_REGISTRY: Record<PaletteId, PaletteRegistryEntry>;
+/**
+ * Ordered list of every {@link PaletteId} — same order as the
+ * registry's declaration. Use for stable iteration in UI (the
+ * overflow menu, the mobile drawer).
+ *
+ * @public
+ */
+export declare const PALETTE_IDS: PaletteId[];
+//# sourceMappingURL=palette-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"palette-registry.d.ts","sourceRoot":"","sources":["../../src/lib/palette-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,oBAAoB,CA4BpE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,EAAiD,CAAC"}