@printwithsynergy/lens-pdf 0.3.0-beta.85 → 0.3.0-beta.88

package/dist/adapters/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Adapters — pure TypeScript, no React. Map raw engine outputs
+ * (codex, lint-pdf, callas, pitstop) to the types lens-pdf accepts
+ * as props. Import from `@printwithsynergy/lens-pdf/adapters`.
+ *
+ * Zero custom glue code needed in demos: pass raw engine responses
+ * to `<LensPDF dataConfig={...}>` and lens handles the mapping.
+ */
+import type { OverlayItem } from "../plugin/types";
+import type { DielineResult } from "../types";
+/**
+ * Raw engine outputs. Pass to `<LensPDF dataConfig={...}>` and lens
+ * maps them internally — no host-side adapter code required.
+ *
+ * @public
+ */
+export interface LensPDFDataConfig {
+    /** Raw codex `ExtractResponse.summary` object. */
+    codexSummary?: Record<string, unknown> | null;
+    /** Raw codex `ExtractResponse.findings` array. */
+    codexFindings?: ReadonlyArray<Record<string, unknown>> | null;
+    /** Raw lint-pdf engine findings array. */
+    lintFindings?: ReadonlyArray<Record<string, unknown>> | null;
+    /** Raw callas PDF Toolbox / pdfaPilot hits array. */
+    callasFindings?: ReadonlyArray<Record<string, unknown>> | null;
+    /** Raw Enfocus PitStop results array. */
+    pitstopFindings?: ReadonlyArray<Record<string, unknown>> | null;
+    /** Raw artwork-pdf preflight issues array. */
+    artworkFindings?: ReadonlyArray<Record<string, unknown>> | null;
+}
+/**
+ * Map a raw codex `summary` object to a lens dieline result and spot
+ * palette. Backward-compatible: falls back to `(0, 0)` origin when the
+ * codex version predates the `x0_pt` / `y0_pt` fields.
+ *
+ * @public
+ */
+export declare function fromCodexSummary(summary: Record<string, unknown>): {
+    dieline: DielineResult | null;
+    spotPalette: Record<string, string> | undefined;
+};
+/**
+ * Map raw codex `findings[]` to `OverlayItem[]`. Codex findings are
+ * already 1-indexed and use the same severity vocabulary as lens tiers,
+ * so this is a direct mapping.
+ *
+ * @public
+ */
+export declare function fromCodexFindings(findings: ReadonlyArray<Record<string, unknown>>): OverlayItem[];
+/**
+ * Map raw lint-pdf engine findings to `OverlayItem[]`. Lint engine
+ * emits 0-indexed `page_num`; OverlayItem expects 1-indexed.
+ *
+ * @public
+ */
+export declare function fromLintFindings(findings: ReadonlyArray<Record<string, unknown>>): OverlayItem[];
+/**
+ * Map raw callas PDF Toolbox / pdfaPilot hit objects to `OverlayItem[]`.
+ * Callas shape: `{ severity, message, page, rule, ... }` per hit.
+ *
+ * @public
+ */
+export declare function fromCallasFindings(findings: ReadonlyArray<Record<string, unknown>>): OverlayItem[];
+/**
+ * Map raw Enfocus PitStop result objects to `OverlayItem[]`.
+ * PitStop shape: `{ level, description, pageNumber, checkName, ... }`.
+ *
+ * @public
+ */
+export declare function fromPitstopFindings(findings: ReadonlyArray<Record<string, unknown>>): OverlayItem[];
+/**
+ * Map raw artwork-pdf `PreflightIssue[]` to `OverlayItem[]`.
+ * Remaps legacy severity vocab: `"block"` → `"error"`, `"warn"` →
+ * `"warning"`. Handles missing bbox gracefully (no canvas overlay).
+ *
+ * @public
+ */
+export declare function fromArtworkFindings(findings: ReadonlyArray<Record<string, unknown>>): OverlayItem[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,kDAAkD;IAClD,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9D,0CAA0C;IAC1C,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7D,qDAAqD;IACrD,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,yCAAyC;IACzC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAChE,8CAA8C;IAC9C,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CACjE;AAmCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAClE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACjD,CAiFA;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,WAAW,EAAE,CAyBf;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,WAAW,EAAE,CAoCf;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,WAAW,EAAE,CA8Bf;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,WAAW,EAAE,CAgCf;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,WAAW,EAAE,CAsCf"}

package/dist/adapters/index.js

@@ -0,0 +1,307 @@
+/**
+ * Adapters — pure TypeScript, no React. Map raw engine outputs
+ * (codex, lint-pdf, callas, pitstop) to the types lens-pdf accepts
+ * as props. Import from `@printwithsynergy/lens-pdf/adapters`.
+ *
+ * Zero custom glue code needed in demos: pass raw engine responses
+ * to `<LensPDF dataConfig={...}>` and lens handles the mapping.
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const KNOWN_TIERS = new Set(["error", "warning", "advisory", "info", "neutral"]);
+function pickTier(severity) {
+    const v = (typeof severity === "string" ? severity : "").toLowerCase();
+    if (KNOWN_TIERS.has(v))
+        return v;
+    if (v === "fail" || v === "blocker" || v === "critical")
+        return "error";
+    if (v === "warn")
+        return "warning";
+    return "info";
+}
+function truncate(s, n) {
+    return s.length > n ? `${s.slice(0, n - 1).trimEnd()}…` : s;
+}
+function asBbox(v) {
+    if (Array.isArray(v) &&
+        v.length === 4 &&
+        v.every((x) => typeof x === "number")) {
+        return [v[0], v[1], v[2], v[3]];
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// fromCodexSummary
+// ---------------------------------------------------------------------------
+/**
+ * Map a raw codex `summary` object to a lens dieline result and spot
+ * palette. Backward-compatible: falls back to `(0, 0)` origin when the
+ * codex version predates the `x0_pt` / `y0_pt` fields.
+ *
+ * @public
+ */
+export function fromCodexSummary(summary) {
+    // --- dieline ---
+    let dieline = null;
+    const die = summary.dieline;
+    if (die && typeof die === "object") {
+        const d = die;
+        const size = d.size && typeof d.size === "object"
+            ? d.size
+            : null;
+        if (size && size.available === true) {
+            const widthPt = typeof size.width_pt === "number" ? size.width_pt : 0;
+            const heightPt = typeof size.height_pt === "number" ? size.height_pt : 0;
+            const x0 = typeof size.x0_pt === "number" ? size.x0_pt : 0;
+            const y0 = typeof size.y0_pt === "number" ? size.y0_pt : 0;
+            const widthMm = typeof size.width_mm === "number"
+                ? size.width_mm
+                : (widthPt * 25.4) / 72;
+            const heightMm = typeof size.height_mm === "number"
+                ? size.height_mm
+                : (heightPt * 25.4) / 72;
+            const candidates = Array.isArray(d.candidates) ? d.candidates : [];
+            const firstNamed = candidates
+                .filter((c) => Boolean(c && typeof c === "object"))
+                .find((c) => typeof c.name === "string" &&
+                c.source !== "analysis_stroke_bbox");
+            const overallConf = typeof d.overall_confidence === "number" ? d.overall_confidence : 0;
+            const sizeConf = typeof size.confidence === "number" ? size.confidence : 0;
+            dieline = {
+                source: firstNamed ? "name" : "vision",
+                polylines: [],
+                spot_name: firstNamed && typeof firstNamed.name === "string"
+                    ? firstNamed.name
+                    : null,
+                confidence: Math.max(0, Math.min(1, overallConf || sizeConf)),
+                regions: [
+                    {
+                        x0,
+                        y0,
+                        x1: x0 + widthPt,
+                        y1: y0 + heightPt,
+                        width_mm: widthMm,
+                        height_mm: heightMm,
+                    },
+                ],
+                multi_color: false,
+            };
+        }
+    }
+    // --- spot palette ---
+    let spotPalette;
+    const sc = summary.spot_colors;
+    if (sc && typeof sc === "object") {
+        const colors = sc.colors;
+        if (Array.isArray(colors) && colors.length > 0) {
+            const out = {};
+            for (const entry of colors) {
+                if (!entry || typeof entry !== "object")
+                    continue;
+                const e = entry;
+                const name = typeof e.name === "string" ? e.name.trim() : "";
+                const hex = typeof e.swatch_hex === "string" ? e.swatch_hex.trim() : "";
+                if (name && hex)
+                    out[name] = hex;
+            }
+            if (Object.keys(out).length > 0)
+                spotPalette = out;
+        }
+    }
+    return { dieline, spotPalette };
+}
+// ---------------------------------------------------------------------------
+// fromCodexFindings
+// ---------------------------------------------------------------------------
+/**
+ * Map raw codex `findings[]` to `OverlayItem[]`. Codex findings are
+ * already 1-indexed and use the same severity vocabulary as lens tiers,
+ * so this is a direct mapping.
+ *
+ * @public
+ */
+export function fromCodexFindings(findings) {
+    return findings.map((f, i) => {
+        const id = typeof f.id === "string" && f.id
+            ? `codex-${f.id}`
+            : `codex-finding-${i}`;
+        const tier = pickTier(f.severity);
+        const page = typeof f.page === "number" && f.page > 0 ? f.page : 1;
+        const bbox = asBbox(f.bbox);
+        const message = typeof f.message === "string" && f.message
+            ? f.message
+            : String(f.type ?? "finding");
+        const code = typeof f.type === "string" ? f.type : undefined;
+        return {
+            id,
+            page,
+            bbox,
+            tier,
+            code,
+            label: truncate(message, 80),
+            description: message,
+            data: f,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// fromLintFindings
+// ---------------------------------------------------------------------------
+/**
+ * Map raw lint-pdf engine findings to `OverlayItem[]`. Lint engine
+ * emits 0-indexed `page_num`; OverlayItem expects 1-indexed.
+ *
+ * @public
+ */
+export function fromLintFindings(findings) {
+    return findings.map((f, i) => {
+        const code = (typeof f.inspection_id === "string" && f.inspection_id) ||
+            (typeof f.rule_id === "string" && f.rule_id) ||
+            (typeof f.code === "string" && f.code) ||
+            "lintpdf";
+        const message = (typeof f.message === "string" && f.message) ||
+            (typeof f.description === "string" && f.description) ||
+            code;
+        const id = typeof f.id === "string" && f.id ? f.id : `lintpdf-${code}-${i}`;
+        const tier = pickTier((f.severity ?? f.level));
+        const page = typeof f.page_num === "number"
+            ? f.page_num + 1
+            : typeof f.page === "number"
+                ? f.page > 0
+                    ? f.page
+                    : 1
+                : 1;
+        const bbox = asBbox(f.bbox);
+        return {
+            id,
+            page,
+            bbox,
+            tier,
+            code,
+            label: truncate(message, 80),
+            description: message,
+            data: f,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// fromCallasFindings
+// ---------------------------------------------------------------------------
+/**
+ * Map raw callas PDF Toolbox / pdfaPilot hit objects to `OverlayItem[]`.
+ * Callas shape: `{ severity, message, page, rule, ... }` per hit.
+ *
+ * @public
+ */
+export function fromCallasFindings(findings) {
+    return findings.map((f, i) => {
+        const severity = f.severity ?? f.level ?? f.type;
+        const tier = pickTier(severity);
+        const message = (typeof f.message === "string" && f.message) ||
+            (typeof f.description === "string" && f.description) ||
+            (typeof f.rule === "string" && f.rule) ||
+            `callas-${i}`;
+        const code = (typeof f.rule === "string" && f.rule) ||
+            (typeof f.checkName === "string" && f.checkName) ||
+            undefined;
+        const rawPage = f.page ?? f.pageNumber ?? f.page_num;
+        const page = typeof rawPage === "number" ? (rawPage > 0 ? rawPage : 1) : 1;
+        const id = typeof f.id === "string" && f.id ? f.id : `callas-${code ?? i}-${i}`;
+        const bbox = asBbox(f.bbox ?? f.rect);
+        return {
+            id,
+            page,
+            bbox,
+            tier,
+            code,
+            label: truncate(message, 80),
+            description: message,
+            data: f,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// fromPitstopFindings
+// ---------------------------------------------------------------------------
+/**
+ * Map raw Enfocus PitStop result objects to `OverlayItem[]`.
+ * PitStop shape: `{ level, description, pageNumber, checkName, ... }`.
+ *
+ * @public
+ */
+export function fromPitstopFindings(findings) {
+    return findings.map((f, i) => {
+        const severity = f.level ?? f.severity ?? f.type;
+        const tier = pickTier(severity);
+        const message = (typeof f.description === "string" && f.description) ||
+            (typeof f.message === "string" && f.message) ||
+            (typeof f.checkName === "string" && f.checkName) ||
+            `pitstop-${i}`;
+        const code = (typeof f.checkName === "string" && f.checkName) ||
+            (typeof f.rule === "string" && f.rule) ||
+            undefined;
+        const rawPage = f.pageNumber ?? f.page_num ?? f.page;
+        const page = typeof rawPage === "number" ? (rawPage > 0 ? rawPage : 1) : 1;
+        const id = typeof f.id === "string" && f.id
+            ? f.id
+            : `pitstop-${code ?? i}-${i}`;
+        const bbox = asBbox(f.bbox ?? f.rect);
+        return {
+            id,
+            page,
+            bbox,
+            tier,
+            code,
+            label: truncate(message, 80),
+            description: message,
+            data: f,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// fromArtworkFindings
+// ---------------------------------------------------------------------------
+/**
+ * Map raw artwork-pdf `PreflightIssue[]` to `OverlayItem[]`.
+ * Remaps legacy severity vocab: `"block"` → `"error"`, `"warn"` →
+ * `"warning"`. Handles missing bbox gracefully (no canvas overlay).
+ *
+ * @public
+ */
+export function fromArtworkFindings(findings) {
+    return findings.flatMap((f, i) => {
+        const rawSev = typeof f.severity === "string" ? f.severity : "";
+        const tier = rawSev === "block"
+            ? "error"
+            : rawSev === "warn"
+                ? "warning"
+                : (["error", "warning", "advisory", "info"].includes(rawSev)
+                    ? rawSev
+                    : "advisory");
+        const page = typeof f.page === "number" && f.page > 0 ? f.page : 1;
+        const bbox = asBbox(f.bbox);
+        const message = (typeof f.message === "string" && f.message) ||
+            (typeof f.checkName === "string" && f.checkName) ||
+            `artwork-${i}`;
+        const code = (typeof f.checkName === "string" && f.checkName) ||
+            (typeof f.type === "string" && f.type) ||
+            undefined;
+        const id = typeof f.id === "string" && f.id
+            ? f.id
+            : `artwork-${code ?? i}-${i}`;
+        return [
+            {
+                id,
+                page,
+                bbox,
+                tier,
+                code,
+                label: truncate(message, 80),
+                description: message,
+                data: f,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

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

package/dist/components/LensPDF.d.ts

@@ -1,61 +1,171 @@
+import type { ReactNode } from "react";
+import { type MinimalCodexClient } from "../browser";
+import type { ThemeTokens, ViewerServices } from "../plugin/services";
+import type { OverlayItem } from "../plugin/types";
+import type { DielineResult } from "../types";
+import { type LensPDFPresetKind } from "./presets";
+import { type LensPDFShellPlugin } from "./shellPlugins";
+import type { LensPDFDataConfig } from "../adapters";
 /**
- * `<LensPDF>` — drop-in production viewer.
- *
- * One mount, every viewer-only feature wired by default:
- *
- * ```tsx
- * import { LensPDF } from "@printwithsynergy/lens-pdf";
- * import pdfWorkerSrc from "pdfjs-dist/build/pdf.worker.mjs?url";
- *
- * <LensPDF pdfUrl="/proofs/abc.pdf" workerSrc={pdfWorkerSrc} />
- * ```
- *
- * Production hosts can plug in their own preflight engine without
- * forking the viewer:
- *
- * ```tsx
- * <LensPDF
- *   pdfUrl="/proofs/abc.pdf"
- *   workerSrc={pdfWorkerSrc}
- *   items={findings}            // OverlayItem[] from your engine
- *   selectedItem={selected}
- *   onItemSelect={setSelected}
- *   dieline={dielineForCurrentPage}
- *   showBoxOverlays              // trim / bleed / crop popovers
- *   tools={["color-picker", "annotate", "tac-heatmap", "separations"]}
- *   onPageChange={setCurrentPage}
- *   tokens={{ accent: "#e50c6a" }}
- * />
- * ```
- *
- * Identical to {@link LensPDFDemo} except the upload chrome (URL bar,
- * file picker, drag-and-drop, empty state) is hidden — `pdfUrl` is the
- * single required prop, and changing it swaps the loaded document.
+ * Tool ids the viewer's sidebar can show. The `tools` prop accepts any
+ * subset; default is every tool. Passing `[]` hides the entire tool
+ * column, giving consumers a "viewer only" mount.
  *
  * @public
  */
-import { type LensPDFDemoProps } from "./LensPDFDemo";
+export type LensPDFTool = "color-picker" | "densitometer" | "measure" | "annotate" | "tac-heatmap" | "separations" | "layers";
 /**
- * Props for {@link LensPDF}. Identical to {@link LensPDFDemoProps}
- * except `pdfUrl` is required (replaces `initialPdfUrl`) and the
- * upload-chrome props (`maxFileSize`) are hidden.
+ * Props for {@link LensPDF}.
  *
  * @public
  */
-export interface LensPDFProps extends Omit<LensPDFDemoProps, "embedded" | "initialPdfUrl" | "maxFileSize"> {
+export interface LensPDFProps {
     /**
-     * URL of the PDF to load. Any URL the browser can fetch — your
-     * own CDN, a signed link, a `blob:` URL from a `File` your app
-     * uploaded, etc. Changing this swaps the document and resets to
-     * `initialPage`.
+     * URL of the PDF to load. Any URL the browser can fetch — your own
+     * CDN, a signed link, a `blob:` URL from a `File` your app uploaded.
+     * Changing this swaps the document and resets to `initialPage`.
      */
     pdfUrl: string;
+    /** Theme tokens. Defaults to {@link darkThemeTokens}. */
+    tokens?: Partial<ThemeTokens>;
+    /** Brand label shown in the viewer footer. Default: "LensPDF". */
+    brand?: string;
+    /**
+     * Brand logo URL. Consumed by {@link LensPDFDemo}'s upload header;
+     * accepted here for prop parity so a shared config object can be
+     * spread onto either component.
+     */
+    brandLogoUrl?: string;
+    /** Optional className on the outermost div. */
+    className?: string;
+    /** Tools to show in the sidebar. Default: every tool. */
+    tools?: ReadonlyArray<LensPDFTool>;
+    /** Initial zoom percentage. Default: 80. */
+    initialZoom?: number;
+    /** TAC limit for the heatmap + densitometer. Default: 300. */
+    tacLimit?: number;
+    /** Override pdf.js worker URL (unpkg by default). */
+    workerSrc?: string;
+    /**
+     * Pre-built services. When provided, Lens uses them where wired and
+     * automatically falls back to in-browser RGB/pdf.js services for any
+     * unwired capability. This keeps LintPDF/backends optional.
+     */
+    services?: ViewerServices;
+    /** Optional footer content below the viewer. */
+    footer?: ReactNode;
+    /** When true, renders full-viewport with fixed positioning. */
+    fullscreen?: boolean;
+    /** Initial page number (1-indexed). Default: 1. */
+    initialPage?: number;
+    /**
+     * Findings to flag on the page raster. Hosts convert their domain
+     * records (engine findings, brand-spec violations, etc.) into
+     * `OverlayItem`s. PageCanvas draws the bbox tinted by `tier`,
+     * PageNavigator badges errors / warnings per page.
+     */
+    items?: readonly OverlayItem[];
+    /**
+     * Force the Inspection / Findings side-panel slot visible even when
+     * ``items`` is empty. Renders an empty "no findings yet" state so
+     * the slot stays in the layout. Defaults to ``false`` — hosts
+     * without preflight data don't see a placeholder panel.
+     *
+     * Useful for:
+     * - Demos that want the panel discoverable from the first frame.
+     * - Hosts with an in-flight preflight call (stable layout while it
+     *   loads).
+     * - Adapters where the user explicitly toggles preflight on/off in
+     *   the UI and you want to keep the slot mounted across that toggle.
+     */
+    forceInspectionPanel?: boolean;
+    /**
+     * Spot-color palette keyed by spot name (case insensitive). Wins
+     * over the Pantone Gold library + the PDF's ``altRgb`` fallback in
+     * the separations panel swatch render. Hosts that have richer
+     * sources of truth (codex's ``summary.spot_colors.colors[].swatch_hex``,
+     * a callas / PitStop / Acrobat preflight report, an internal
+     * swatch DB) pass values here.
+     *
+     * Example: ``{ "PANTONE 225 C": "#c6168d", "PANTONE 236 C": "#da1884" }``.
+     */
+    spotPalette?: Record<string, string>;
+    /** Currently-selected finding (controlled). Drives the canvas
+     *  highlight + tooltip. */
+    selectedItem?: OverlayItem | null;
+    /** Fires when the user clicks a finding's bbox or the page background
+     *  (in which case the argument is `null`). */
+    onItemSelect?: (item: OverlayItem | null) => void;
+    /**
+     * Dieline payload for the current page. When non-null, mounts
+     * `<DielineOverlay>` so each detected artwork region gets a
+     * size-popover info chip at its centroid (mm + inches).
+     */
+    dieline?: DielineResult | null;
+    /**
+     * When true, mounts `<BoxOverlay>` so trim / bleed / crop boxes
+     * defined in the PDF render with size popovers. Hosts that don't
+     * carry box geometry can leave this off (default).
+     */
+    showBoxOverlays?: boolean;
+    /**
+     * When true, the canvas is clipped to the page's TrimBox (falls
+     * back to BleedBox, then CropBox). Hides the white bleed strip
+     * outside the trim line. Default false.
+     */
+    cropToTrim?: boolean;
+    /** Fires after the active page changes (1-indexed). */
+    onPageChange?: (page: number) => void;
+    /** Fires after the zoom level changes (percentage). */
+    onZoomChange?: (zoom: number) => void;
+    /** Fires when the viewer raises a recoverable error. */
+    onError?: (message: string) => void;
+    /** First-party plugin preset used as the base composition. */
+    preset?: LensPDFPresetKind;
+    /**
+     * Additional shell plugins (or replacements) for panels and toolbar
+     * slots. Use `replaces` on your plugin to override a built-in one.
+     */
+    plugins?: ReadonlyArray<LensPDFShellPlugin>;
+    /**
+     * Zero-glue data config. Pass raw engine outputs here — lens maps
+     * them internally. Findings from all sources are shown together in
+     * the Inspection panel; dieline and spot palette from codex fill in
+     * as defaults when the explicit `dieline` / `spotPalette` props are
+     * absent.
+     *
+     * Supported engines: codex (`codexSummary` + `codexFindings`),
+     * lint-pdf (`lintFindings`), callas (`callasFindings`), PitStop
+     * (`pitstopFindings`).
+     */
+    dataConfig?: LensPDFDataConfig;
+    /**
+     * Optional codex client. When provided, `<LensPDFDemo>` fires
+     * `extractStream` in the background after each PDF loads. As codex
+     * events arrive the viewer silently upgrades:
+     *
+     * - `colorWorld` → separations panel shows pikepdf-accurate ink list
+     *   (including spots inside compressed streams that the browser's
+     *   regex parser misses).
+     * - `phase2_complete` → separations, TAC heatmap, and layers switch
+     *   to Ghostscript-rendered plates (higher fidelity than the
+     *   pdfjs RGB-approximated versions).
+     *
+     * Tools remain fully active on pdfjs throughout — there is no loading
+     * state or disabled period. Codex is a silent quality upgrade.
+     *
+     * Accepts any object satisfying {@link MinimalCodexClient} —
+     * including `HttpClient` from `@printwithsynergy/codex-client`.
+     */
+    codex?: MinimalCodexClient;
 }
 /**
- * Drop-in production viewer. See {@link LensPDFProps} for the full
- * prop surface.
+ * The complete interactive LensPDF viewer — sidebar controls, theming,
+ * optional fullscreen mode. All viewer-only features (color picker,
+ * densitometer, measure, separations, TAC heatmap, layers, annotations)
+ * are wired out of the box. Pass a `pdfUrl` and you have a viewer.
  *
  * @public
  */
-export declare function LensPDF({ pdfUrl, ...rest }: LensPDFProps): import("react/jsx-runtime").JSX.Element;
+export declare function LensPDF({ pdfUrl, tokens: tokenOverrides, brand, className, tools, initialZoom, tacLimit, workerSrc, services: serviceOverrides, footer, fullscreen: initialFullscreen, initialPage, items, forceInspectionPanel, spotPalette, selectedItem, onItemSelect, dieline, showBoxOverlays, cropToTrim, onPageChange: onPageChangeProp, onZoomChange: onZoomChangeProp, onError: onErrorProp, preset, plugins: customPlugins, codex, dataConfig, }: LensPDFProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=LensPDF.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"LensPDF.d.ts","sourceRoot":"","sources":["../../components/LensPDF.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;IAC5E;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,YAAY,2CAExD"}
+{"version":3,"file":"LensPDF.d.ts","sourceRoot":"","sources":["../../components/LensPDF.tsx"],"names":[],"mappings":"AA+DA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EASL,KAAK,kBAAkB,EAExB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,UAAU,CAAC;AA8BxD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAIL,KAAK,kBAAkB,EAGxB,MAAM,gBAAgB,CAAC;AASxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMrD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,cAAc,GACd,SAAS,GACT,UAAU,GACV,aAAa,GACb,aAAa,GACb,QAAQ,CAAC;AAYb;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;+BAC2B;IAC3B,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC;kDAC8C;IAC9C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,wDAAwD;IACxD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAmBD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EACtB,MAAM,EACN,MAAM,EAAE,cAAc,EACtB,KAAK,EACL,SAAS,EACT,KAAqB,EACrB,WAAgB,EAChB,QAAc,EACd,SAAS,EACT,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EACN,UAAU,EAAE,iBAAyB,EACrC,WAAe,EACf,KAAK,EACL,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,eAAuB,EACvB,UAAkB,EAClB,YAAY,EAAE,gBAAgB,EAC9B,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,MAAe,EACf,OAAO,EAAE,aAAkB,EAC3B,KAAK,EACL,UAAU,GACX,EAAE,YAAY,2CAmoCd"}