@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.4.0

package/dist/lib/dieline-template.js

@@ -1,3 +1,17 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+//
+// Dieline-template bundle + helpers for seeding the editor canvas.
+//
+// The shipped JSON library (`data/dielines.json`) gets loaded eagerly
+// so server components (Next.js RSC, Astro frontmatter) can pick a
+// template and produce initial Page state without touching the
+// browser-only editor bundle.
+//
+// `dielineToPage()` is the parallel ingress for user-supplied CF2 /
+// DDES / ARD files (parsed via `@artworkpdf/dieline-parser`'s
+// `parseCF2` / `parseDDES` / `parseARD`) — each parsed `Dieline`
+// becomes a single-page `Page` seeded with one locked path per
+// `DielinePath`.
 import library from "../data/dielines.json";
 const MM_TO_PT = 2.83465;
 /** Stroke color + display name for the dieline trim rect. The dieline
@@ -6,6 +20,15 @@ const MM_TO_PT = 2.83465;
 export const DIELINE_STROKE = "#fc5102";
 export const DIELINE_NAME = "Die Line";
 const LIBRARY = library;
+/**
+ * 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 const TEMPLATES = LIBRARY.templates;
 /**
  * Bundled multi-page template sets (e.g. carton front + back). Empty if
@@ -14,6 +37,13 @@ export const TEMPLATES = LIBRARY.templates;
  * @public
  */
 export const TEMPLATE_SETS = LIBRARY.templateSets ?? [];
+/**
+ * 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 function getDefaultTemplate() {
     const flagged = TEMPLATES.find((t) => t.isDefault);
     if (flagged)
@@ -23,6 +53,12 @@ export function getDefaultTemplate() {
         throw new Error("dielines.json contains no templates");
     return first;
 }
+/**
+ * Lookup by template id. Returns `undefined` (not throws) for
+ * unknown or missing ids so callers can fall back to a default.
+ *
+ * @public
+ */
 export function getTemplateById(id) {
     if (!id)
         return undefined;
@@ -85,6 +121,22 @@ export function templateToPage(template, bleedMmOverride, name) {
 export function templatesToPages(entries, bleedMmOverride) {
     return entries.map(({ template, name }) => templateToPage(template, bleedMmOverride, name));
 }
+/**
+ * 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 function templateToInitialState(template, bleedMmOverride) {
     const bleedMm = bleedMmOverride ?? template.bleedMm;
     const pageSize = {
@@ -111,4 +163,115 @@ export function templateToInitialState(template, bleedMmOverride) {
     };
     return { objects: [dielineObj], pageSize };
 }
+/**
+ * Stroke color per DielinePath type. Chosen to match the
+ * print-industry conventions our preview uses elsewhere:
+ *
+ * - cut    — orange (brand, same as bundled DIELINE_STROKE)
+ * - crease — blue (folding score)
+ * - perf   — red (perforation)
+ * - bleed  — cyan (bleed edge / safety boundary)
+ */
+const DIELINE_PATH_STROKES = {
+    cut: DIELINE_STROKE,
+    crease: "#1e90ff",
+    perf: "#ef4444",
+    bleed: "#0ea5e9",
+};
+/**
+ * Scale every coordinate in an SVG `d` string from millimeters to
+ * PDF points (multiply by `MM_TO_PT`).
+ *
+ * The dieline-parser emits absolute `M` / `L` / `A` commands in
+ * dieline-native millimeters. The editor's Konva Stage is configured
+ * in PDF points (the canvas / pageSize math is all in points), so
+ * the raw `d` string would render at ~35% of intended size if used
+ * directly. We pre-scale here so `pathData` matches the canvas unit
+ * system end-to-end (no Konva.Path `scaleX` / `scaleY` shenanigans
+ * that would also scale stroke width).
+ *
+ * Per-command coordinate slots:
+ * - `M x,y` / `L x,y` → both coordinates are positions; scale all.
+ * - `A rx,ry,xRot,largeArc,sweep,x,y` → rx and ry are radii (scale),
+ *   xRot is degrees (pass through), the two flags are 0/1 (pass
+ *   through), the trailing x,y are positions (scale).
+ *
+ * Unknown commands pass through unchanged. The parser's output only
+ * uses M / L / A so the full SVG-path alphabet doesn't need handling.
+ */
+function scalePathMmToPt(d) {
+    return d.replace(/([MLA])\s*([\d.,\s-]+)/g, (_, cmd, args) => {
+        const nums = args
+            .trim()
+            .split(/[\s,]+/)
+            .map(Number)
+            .filter((n) => !Number.isNaN(n));
+        if (cmd === "A") {
+            // Arc: rx, ry, xRot, largeArc, sweep, x, y — scale rx, ry, x, y; pass others.
+            const out = [];
+            for (let i = 0; i + 6 < nums.length; i += 7) {
+                out.push((nums[i] ?? 0) * MM_TO_PT, (nums[i + 1] ?? 0) * MM_TO_PT, nums[i + 2] ?? 0, nums[i + 3] ?? 0, nums[i + 4] ?? 0, (nums[i + 5] ?? 0) * MM_TO_PT, (nums[i + 6] ?? 0) * MM_TO_PT);
+            }
+            return `${cmd}${out.join(",")}`;
+        }
+        // M / L: alternating x,y pairs.
+        return `${cmd}${nums.map((n) => n * MM_TO_PT).join(",")}`;
+    });
+}
+/**
+ * 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 function dielineToPage(dieline, bleedMmOverride) {
+    const bleedMm = bleedMmOverride ?? 0;
+    const pageSize = {
+        width: (dieline.widthMm + bleedMm * 2) * MM_TO_PT,
+        height: (dieline.heightMm + bleedMm * 2) * MM_TO_PT,
+    };
+    const bleedOffsetPt = bleedMm * MM_TO_PT;
+    const objects = dieline.paths.map((p) => ({
+        id: `dieline-${dieline.format.toLowerCase()}-${p.id}`,
+        type: "path",
+        x: bleedOffsetPt,
+        y: bleedOffsetPt,
+        width: 0,
+        height: 0,
+        fill: "transparent",
+        stroke: DIELINE_PATH_STROKES[p.type],
+        strokeWidth: 1,
+        opacity: 1,
+        // Pre-scale mm → pt so pathData matches the canvas unit system.
+        pathData: scalePathMmToPt(p.d),
+        name: `${dieline.format} ${p.type}`,
+        locked: true,
+    }));
+    return {
+        id: `page-${dieline.format.toLowerCase()}-${Math.random().toString(36).slice(2, 8)}`,
+        objects,
+        pageSize,
+        bleedMm,
+    };
+}
 //# sourceMappingURL=dieline-template.js.map

package/dist/lib/dieline-template.js.map

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

package/dist/lib/editor-config.d.ts

@@ -1,3 +1,37 @@
+/**
+ * The palettes the editor can host. Each id maps to a registered
+ * panel via {@link import("./palette-registry").PALETTE_REGISTRY}.
+ * Visibility is controlled by `EditorConfig.panelVisibility` (an
+ * absent / `true` entry means "show"); the `PaletteManager`
+ * component renders an overflow toggle on desktop, and
+ * `MobileToolDrawer` renders the same toggles in a "Panels" section.
+ *
+ * `layers` and `preflight` are wired today. The remaining ids are
+ * registered for forward compatibility — Wave 1+ components will
+ * mount them.
+ *
+ * @public
+ */
+export type PaletteId = "layers" | "preflight" | "dieline-library" | "dieline-parameters" | "dieline-preview" | "swatches" | "inks" | "graphic-styles" | "history" | "fold-preview" | "variant-matrix" | "process-rules" | "preflight-diff" | "brand-assets" | "mark-library" | "slack-notify" | "preflight-autofix" | "smart-spot-match" | "design-suggestions" | "annotations-sidebar" | "brand-consistency" | "webhook-notify" | "email-notify" | "accessibility-hints" | "palette-to-spot" | "white-underbase" | "streaming-render";
+/**
+ * Helper type — only the boolean `enable_*` keys of {@link EditorConfig}
+ * (the optional gating-layer keys are filtered out).
+ */
+type EnableKey = Extract<keyof EditorConfig, `enable_${string}`>;
+/**
+ * Derived feature-key alphabet — every `enable_<feature>` flag becomes
+ * a `<feature>` key. Used as the *intended* shape for
+ * {@link EditorConfig}'s `capabilities` / `plan_gates` keys and as the
+ * parameter type for {@link showFeature}'s lookup.
+ *
+ * The maps below are typed `Record<string, boolean>` to break the
+ * circular type dependency (the keys-of-EditorConfig derivation
+ * referencing EditorConfig itself); hosts should still pass
+ * `FeatureKey`-shaped strings for compile-time-via-the-helper safety.
+ *
+ * @public
+ */
+export type FeatureKey = EnableKey extends `enable_${infer F}` ? F : never;
 /**
  * Programmer-facing feature-flag layer for the editor. Modeled on
  * `lens-pdf`'s `ViewerConfig`: every host-visible feature is a typed
@@ -10,6 +44,10 @@
  *      the `mode` argument)
  *   3. Per-instance overrides passed by the host
  *
+ * The `panelVisibility`, `capabilities`, and `plan_gates` layers are
+ * optional — absent entries preserve identity behaviour, so existing
+ * consumers don't have to set them.
+ *
  * @public
  */
 export interface EditorConfig {
@@ -33,8 +71,326 @@ export interface EditorConfig {
     enable_bleed_input: boolean;
     enable_layers_panel: boolean;
     enable_preflight_banner: boolean;
+    /** F0 — host-toggleable palette overflow menu (desktop) + mobile
+     *  drawer "Panels" section. When false, all palettes render
+     *  regardless of their per-id `panelVisibility` entry. */
+    enable_palettes: boolean;
+    /** F1 plumb — separation-aware UI surface. UI ships in Wave 1+;
+     *  flag prepares the surface so hosts can opt out preemptively. */
+    enable_separations: boolean;
+    /** S1 — parametric dieline parameter panel. When enabled, hosts can
+     *  surface a width/height/depth/bleed editor on top of a parametric
+     *  dieline template (CF2 or codex-pdf carton macro); the panel
+     *  emits new parameters via `onChange` and the host wires the
+     *  regen step. Disable for hosts that only ship the bundled
+     *  static library. */
+    enable_dieline_parameters: boolean;
+    /** S6 — lightweight 2D dieline preview panel. When enabled, hosts
+     *  can mount the {@link DielinePreview} thumbnail next to the
+     *  parametric editor so a width/height edit and the resulting
+     *  folded-layout preview update side by side. Distinct from
+     *  `enable_3d_fold_preview` (which spins up Three.js); this is the
+     *  cheap always-on chrome companion. */
+    enable_dieline_preview: boolean;
+    /** C1 — inks palette. Surfaces the live ink list extracted from the
+     *  most recently rendered PDF, alongside the existing swatches
+     *  palette (which still handles PANTONE search). Hosts can disable
+     *  to avoid the `/v1/separations/list` round-trip on every export. */
+    enable_inks_panel: boolean;
+    /** C3 — swatches palette / browseable PANTONE library picker. When
+     *  enabled, hosts mount {@link SwatchesPicker} on the right rail;
+     *  the panel hosts a debounced search input against compile-pdf's
+     *  `/v1/spots/search` endpoint with an optional library-filter
+     *  dropdown. Pairs with AI4's `registerSpot` to commit a chosen
+     *  swatch as a document spot. Hosts that don't run compile-pdf's
+     *  spots router opt out via this flag. */
+    enable_swatches: boolean;
+    /** C2 — white / underbase auto-generation panel. When enabled,
+     *  hosts mount {@link WhiteUnderbasePanel} to compute the union of
+     *  CMYK fill coverage on the active page and ask compile-pdf's
+     *  `white_underbase` producer to emit a new opaque-white
+     *  separation matching that union (optionally choked inward).
+     *  Hosts that don't run the white-underbase producer opt out via
+     *  this flag. */
+    enable_white_underbase: boolean;
+    /** O3 — streaming render progress panel. When enabled, hosts can
+     *  mount {@link StreamingRenderProgress} to surface live per-page
+     *  progress during long renders served by compile-pdf's
+     *  `POST /v1/compose/stream` SSE endpoint. Hosts that don't run
+     *  the streaming endpoint opt out via this flag. */
+    enable_streaming_render: boolean;
+    /** S3 — panel-anchored objects. When enabled, hosts can bind
+     *  artwork objects to a specific {@link DielinePanel} via
+     *  `anchorPanelId`; objects re-position with their parent panel
+     *  when the dieline is folded or regenerated. The flag controls
+     *  whether the editor surfaces the "Anchor to panel" affordance —
+     *  the wire model already carries `anchorPanelId` regardless. */
+    enable_panel_anchored_objects: boolean;
+    /** P3 — compliance findings panel. Surfaces substrate / market /
+     *  regulation findings from lint-pdf's `P3_compliance_v1` profile
+     *  separately from the existing generic preflight panel. Hosts
+     *  that don't run lint-pdf opt out via this flag. */
+    enable_compliance_panel: boolean;
+    /** P2 — process-specific preflight panel. Surfaces process-physics
+     *  findings (flexo white-knock, gravure max line freq, screen
+     *  halftone limit) separately from generic preflight and from the
+     *  P3 compliance panel. Hosts that don't run lint-pdf's
+     *  process-aware profile opt out via this flag. */
+    enable_process_rules_panel: boolean;
+    /** P4 — preflight-diff panel. Compares current preflight findings
+     *  against a previous {@link import("@artworkpdf/document-model").PreflightSnapshot}
+     *  from `DocumentV3.preflightHistory` and surfaces what changed
+     *  (cleared / still firing / new since baseline). Hosts that don't
+     *  carry preflight history opt out via this flag. */
+    enable_preflight_diff: boolean;
+    /** B1 — brand-assets registry panel. Surfaces
+     *  `DocumentV3.brandAssets` as a browsable list grouped by kind
+     *  (logo, swatch, typography, graphic-style, other). Pairs with
+     *  the Wave 4 B2 brand-consistency rule (lint-pdf side) — the rule
+     *  consults the same registry. Hosts that don't carry brand assets
+     *  opt out via this flag. */
+    enable_brand_assets_panel: boolean;
+    /** X2 — history scrubber panel. When enabled, hosts mount the
+     *  {@link HistoryPanel} on the right rail; the panel renders the
+     *  per-page snapshot stack from {@link EditorCanvas} as a clickable
+     *  list so users can revert to any prior commit. The panel + palette
+     *  id were registered in earlier waves; this flag formally gates the
+     *  surface. */
+    enable_history: boolean;
+    /** S2 — dieline import (CF2 / DDES / ARD file-drop). When enabled,
+     *  {@link FileDropZone} accepts the three legacy packaging-industry
+     *  formats and routes them through `@artworkpdf/dieline-parser` →
+     *  {@link dielineToPage}, bypassing the PDF preflight phase and
+     *  seeding the canvas directly. Disable for hosts that only ship
+     *  PDF artwork (the dropzone falls back to PDF-only). */
+    enable_dieline_import: boolean;
+    /** X3 — annotation overlay. When enabled, hosts mount the
+     *  {@link AnnotationOverlay} SVG layer over the canvas to surface
+     *  `PageV3.annotations` (point / area / text). The overlay is
+     *  read-only; mutation (add / resolve / delete) is a host concern.
+     *  Disable for view-only / print-preview surfaces where comments
+     *  shouldn't appear. */
+    enable_annotation_overlay: boolean;
+    /** V3 — versioned variant matrix diff viewer. When enabled, hosts
+     *  can mount the {@link VariantMatrixVersionPanel} to compare two
+     *  matrix snapshots from their persisted version history. Pairs
+     *  with the optional `version` field on `VariantMatrix` (Wave 4
+     *  PR-A). Disable for hosts that don't ship versioned variants. */
+    enable_variant_matrix_versions: boolean;
+    /** M1 — mark library picker panel. When enabled, hosts mount the
+     *  {@link MarkLibraryPanel} to browse a host-provided catalogue of
+     *  printer marks (crop, registration, color bar, slug, other) and
+     *  wire the selected entry into the active page's marks template.
+     *  Pairs with compile-pdf's marks producer; disable when no
+     *  catalogue source is wired. */
+    enable_mark_library: boolean;
+    /** I3 — Slack-notify panel. When enabled, hosts mount the
+     *  {@link SlackNotifyPanel} so users can emit a Slack notification
+     *  keyed to a typed editor event (preflight cleared, job submitted,
+     *  approval requested, …). Pairs with the synergy `slack.notify`
+     *  workflow node when one is deployed; disable when no Slack
+     *  bridge is wired. */
+    enable_slack_notify: boolean;
+    /** AI3 — Preflight auto-fix suggestions panel. When enabled, hosts
+     *  mount the {@link PreflightAutoFixPanel} alongside the preflight
+     *  panel; an AI / rules-engine loader resolves each finding to a
+     *  list of remediation suggestions the user can apply. Pairs with
+     *  the synergy `preflight.fix` workflow node when one is deployed;
+     *  disable when no fix-suggestion adapter is wired. */
+    enable_preflight_autofix: boolean;
+    /** AI2 — Smart spot-match panel. When enabled, hosts mount the
+     *  {@link SmartSpotMatchPanel} so users can resolve a picked CMYK
+     *  / Lab / hex color to ranked nearest-PANTONE candidates with ΔE
+     *  chips. Pairs with compile-pdf's `/v1/spots/match` endpoint or a
+     *  tenant-local ΔE engine; disable when no matcher is wired. */
+    enable_smart_spot_match: boolean;
+    /** AI1 — AI design-suggestions panel. When enabled, hosts mount
+     *  the {@link DesignSuggestionsPanel} alongside the canvas; a host
+     *  loader resolves a stream of proactive design hints (typography,
+     *  color, contrast, layout, imagery) the user can apply or
+     *  dismiss. Pairs with the synergy `design.suggest` node when one
+     *  is deployed; disable when no suggestion adapter is wired. */
+    enable_design_suggestions: boolean;
+    /** X1 — Annotations sidebar. Companion list view to the X3
+     *  {@link AnnotationOverlay}; surfaces the same annotation stream
+     *  as a scrollable, filterable list so reviewers can read the
+     *  thread without hunting for pins. Disable when the host doesn't
+     *  ship annotations (view-only surfaces, print-preview, …). */
+    enable_annotations_sidebar: boolean;
+    /** B2 — Brand-consistency findings panel. Companion to the B1
+     *  brand-assets panel; surfaces a host-loader-supplied list of
+     *  violations against the brand-asset registry (logo placed too
+     *  small, fill color outside the swatches set, typography pairing
+     *  off the brand kit, etc.). Pairs with lint-pdf's brand-consistency
+     *  profile when one is deployed; disable when no brand-consistency
+     *  loader is wired. */
+    enable_brand_consistency: boolean;
+    /** I1 — Generic webhook-notify panel. Companion to the I3
+     *  {@link SlackNotifyPanel}; emits a structured
+     *  {@link WebhookNotificationEvent} through a host adapter so any
+     *  outbound HTTP integration (Zapier, n8n, GitHub Actions
+     *  `repository_dispatch`, internal worker queues, custom tenant
+     *  endpoints) can subscribe to editor events without their own
+     *  panel. Pairs with the synergy `webhook.notify` workflow node when
+     *  one is deployed; disable when no webhook adapter is wired. */
+    enable_webhook_notify: boolean;
+    /** I2 — Email-notify panel. Third member of the Wave 4 integration
+     *  family (alongside I3 Slack and I1 webhook); emits a composed
+     *  subject + body through a host-supplied {@link EmailNotifyFn}
+     *  (SMTP relay, SendGrid, Postmark, AWS SES, internal Synergy node,
+     *  etc.). Pairs with the synergy `email.notify` workflow node when
+     *  one is deployed; disable when no email transport is wired. */
+    enable_email_notify: boolean;
+    /** AI4 — Palette → spot conversion panel. Closes the Wave 1 AI
+     *  family. AI2 {@link SmartSpotMatchPanel} matches a user-picked
+     *  color to PANTONE; AI4 takes the inverse direction — given the
+     *  document's existing palette (every distinct fill/stroke on the
+     *  active page), route each entry through the same matcher and let
+     *  the user commit the best match into the spot registry in one
+     *  click. Reuses AI2's {@link SpotMatchLoaderFn} so one host
+     *  adapter serves both panels. Disable when no matcher is wired. */
+    enable_palette_to_spot: boolean;
+    /** AI5 — Accessibility hints panel. Fifth member of the AI family
+     *  (alongside AI1 design-suggestions, AI2 smart spot-match, AI3
+     *  preflight auto-fix, AI4 palette-to-spot); surfaces a host-loader
+     *  -supplied list of accessibility findings (low contrast, missing
+     *  alt text, text-size
+     *  minimums, color-only signalling). Pairs with a tenant-deployed
+     *  lint-pdf accessibility profile or an in-house rules engine;
+     *  disable when no accessibility loader is wired. */
+    enable_accessibility_hints: boolean;
+    /** F2 — Print-context modal (process, substrate, ICC, TAC, target
+     *  markets). When false, hosts get a `printContext`-less wire model. */
+    enable_print_context: boolean;
     enable_canvas_grid: boolean;
     enable_bleed_visualization: boolean;
+    /** C4 — debounced rasterize-and-sample on every commit, surfaces a
+     *  red heatmap over pixels above the TAC threshold plus a chip with
+     *  `max / avg`. Hosts can disable on low-end devices where the
+     *  ~250 ms rasterize is too costly. */
+    enable_total_ink_coverage_live: boolean;
+    /** D1 — background trap-preview overlay. When enabled, the editor
+     *  posts trap policies to compile-pdf's `/v1/trap/preview` endpoint
+     *  and renders the predicted trap regions on top of the canvas.
+     *  Hosts can disable to avoid network chatter on every edit. */
+    enable_trap_preview: boolean;
+    /** D2 — interactive trap policy editor (modal panel). When
+     *  enabled, the editor surfaces width / mode controls that write
+     *  into the active page's `trapConfig`. Per-edge and per-color-pair
+     *  overrides will follow when the compile-pdf trap producer
+     *  exposes them. */
+    enable_trap_editor: boolean;
+    /** O1 — sheet-imposition builder (modal panel). When enabled, the
+     *  editor surfaces sheet size, rows × cols, gutter / margin in mm,
+     *  and registration / crop-mark toggles that flow into the
+     *  compile-pdf impose producer at submission. */
+    enable_impose: boolean;
+    /** S4 — 3D fold preview overlay. When enabled and the active page
+     *  carries `panelMetadata`, the editor mounts a Three.js scene
+     *  showing the dieline's panels in 3D with hinge lines along each
+     *  fold edge. Hosts on bandwidth-constrained networks can opt out;
+     *  the Three.js code path stays cold when the flag is `false`. */
+    enable_3d_fold_preview: boolean;
+    /** S4 (PR-4) — interactive fold editor panel. When enabled,
+     *  hosts surface an angle slider per fold edge that writes into
+     *  `document.pages[i].foldConfig`. The {@link FoldPreviewOverlay}
+     *  re-renders the 3D scene on every commit. Pairs with
+     *  `enable_3d_fold_preview` — hosts that only want the read-only
+     *  overlay (no editing) leave this `false`. */
+    enable_fold_editor: boolean;
+    /** O2 — "Send to MIS" emit. When enabled, hosts surface a button
+     *  that gathers the document's print-relevant metadata into a
+     *  manifest and POSTs it to the synergy `mis.estimate` workflow
+     *  node. Hosts that don't run a MIS bridge opt out via this flag. */
+    enable_mis_estimate: boolean;
+    /** P1 — process-aware preflight. Gating is at the *call site* —
+     *  hosts check this flag before mounting the substrate-class
+     *  dropdown and before forwarding the helper output to lint-pdf's
+     *  `/v1/preflight/process`. `preflightContextOf` itself is
+     *  unconditional (a pure projection), so the flag controls the UI
+     *  surface and the host's outbound wiring, not the helper. */
+    enable_process_preflight: boolean;
+    /** C5 — ICC soft-proof overlay. When enabled, hosts can mount the
+     *  {@link IccSoftProofOverlay} on top of the canvas; the overlay's
+     *  loader adapter resolves to a per-pixel delta-E map (typically
+     *  via compile-pdf's `/v1/soft-proof/apply`). Disable to skip the
+     *  rasterize + round-trip cost on devices where the overlay would
+     *  be too expensive. */
+    enable_soft_proof: boolean;
+    /** V2 — variant matrix UI for variable-data overrides. When
+     *  enabled, the editor surfaces a rows-times-columns table of
+     *  variants and token keys that writes into `document.variants`.
+     *  The actual merge pipeline (one rendered page-instance per
+     *  variant) lands in Wave 3 V1; this flag just gates the editing
+     *  surface. */
+    enable_variant_matrix: boolean;
+    /** G2g — barcode generator panel. When enabled, hosts can mount the
+     *  {@link BarcodeGeneratorPanel} on the canvas chrome; the panel's
+     *  renderer adapter resolves a format + payload to an ImageData
+     *  bitmap the host then places as a `CanvasObj`. Disable when the
+     *  host doesn't ship a barcode-rendering backend (no library wired,
+     *  no compile-pdf endpoint reachable) — surfacing the panel without
+     *  a working adapter would only frustrate users. */
+    enable_barcode_generate: boolean;
+    /** G2v — barcode validation preflight rule. When enabled, the
+     *  client-side `barcode_validation` preflight rule rasterizes the
+     *  active page, runs {@link scanBarcodes} over the resulting
+     *  ImageData, then validates each detection via
+     *  {@link validateBarcode} (EAN-13 check digit, UPC-A length,
+     *  GS1-128 AI sequence). Detected codes that fail their format's
+     *  validator surface as warn-severity findings. Disable when the
+     *  host doesn't ship barcode-bearing artwork (skips the
+     *  rasterize+scan round-trip on every preflight pass). */
+    enable_barcode_validation: boolean;
+    /** P5 — Braille layout panel (EN 15823 / Marburg Medium). When
+     *  enabled, hosts can mount the {@link BraillePanel} to compose
+     *  Grade 1 English Braille cells. Disable for hosts that don't
+     *  ship pharma-grade packaging or already wire a tenant-owned
+     *  Braille translator. */
+    enable_braille_panel: boolean;
+    /** V1 — variable-data merge helpers. When enabled, hosts can wire
+     *  `{{token}}` placeholders into Wave 2 V2's variant matrix and use
+     *  {@link mergeRow} / {@link mergeAllRows} to preview each rendered
+     *  variant before submitting to compose. Disable for hosts that
+     *  don't ship variable-data printing. */
+    enable_variable_data_merge: boolean;
+    /** G3 — GS1 Digital Link composer panel. When enabled, hosts can
+     *  mount the {@link Gs1DigitalLinkPanel} to assemble a GTIN + AIs
+     *  into a canonical GS1 Digital Link URL (optionally rendered as a
+     *  QR via the same renderer adapter the G2g panel uses). Disable
+     *  when the host's workflow doesn't ship GS1-encoded artwork. */
+    enable_gs1_digital_link: boolean;
+    /** G1 — FDA Nutrition Facts label data-entry panel. When enabled,
+     *  hosts can mount the {@link NutritionPanel} to compose a typed
+     *  {@link NutritionFacts} record into an ordered
+     *  {@link NutritionPanelSpec} the host renders onto the canvas.
+     *  Disable for hosts that don't deal with food / supplement
+     *  labelling. */
+    enable_nutrition_panel: boolean;
+    /**
+     * Per-palette visibility. Absent or `true` means visible; `false`
+     * hides without removing the toggle from the {@link PaletteId}
+     * registry. Hosts that want sticky visibility persist this object
+     * keyed by user + document.
+     */
+    panelVisibility?: Partial<Record<PaletteId, boolean>>;
+    /**
+     * Runtime capability declarations from the backend (e.g. "this
+     * tenant's compile-pdf instance has /v1/impose/apply enabled").
+     * Absent entry defaults to `true`. `false` hides the feature.
+     * Separate from `plan_gates` so the UI can distinguish "capability
+     * absent" from "plan doesn't include this".
+     *
+     * Keys are {@link FeatureKey}-shaped (typed `string` to break a
+     * circular dep — hosts should pass `FeatureKey` values).
+     */
+    capabilities?: Record<string, boolean>;
+    /**
+     * Plan-tier gating (e.g. "spot library is paid"). Same shape as
+     * `capabilities` but conceptually orthogonal — a feature can be
+     * capable + plan-gated, in which case both must be true.
+     */
+    plan_gates?: Record<string, boolean>;
 }
 /**
  * Default flag set — every feature on. Hosts that want a minimal
@@ -65,4 +421,38 @@ export declare const PRO_MODE_OVERRIDES: Partial<EditorConfig>;
  * @public
  */
 export declare function resolveConfig(mode: "basic" | "pro", instanceOverrides?: Partial<EditorConfig>): EditorConfig;
+/**
+ * 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 declare function showFeature(cfg: EditorConfig, f: FeatureKey): boolean;
+/**
+ * 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 declare function isPanelVisible(cfg: EditorConfig, id: PaletteId): boolean;
+export {};
 //# sourceMappingURL=editor-config.d.ts.map

package/dist/lib/editor-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-config.d.ts","sourceRoot":"","sources":["../../src/lib/editor-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAE3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAG3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAG5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IAGjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,YA2BnC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAGtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,YAAY,CAAM,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,GAAG,KAAK,EACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACxC,YAAY,CAGd"}
+{"version":3,"file":"editor-config.d.ts","sourceRoot":"","sources":["../../src/lib/editor-config.ts"],"names":[],"mappings":"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"}