@printwithsynergy/lens-pdf 0.3.0-beta.81

package/dist/plugin/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Viewer plugin protocol — slot types + plugin shape.
+ *
+ * Plugins extend the viewer without modifying core. Each plugin
+ * declares the slot it mounts into; the registry resolves slot
+ * lookups in order.
+ *
+ * Slots map to where a plugin's `mount()` return value renders:
+ * - `overlay.canvas` — absolutely-positioned over the page canvas;
+ *   draws annotation/finding overlays.
+ * - `panel.right`, `panel.left`, `panel.bottom` — side/bottom panels.
+ * - `toolbar.top`, `toolbar.left`, `toolbar.bottom` — toolbar pills.
+ * - `annotation.source` — non-visual; supplies annotation data via
+ *   `AnnotationSourceProvider`.
+ * - `dialog.modal` — modal dialog launched from another plugin.
+ *
+ * Anything host- or domain-shaped (host-specific findings,
+ * brand-spec violations, audit verdicts) belongs in a plugin pack,
+ * not core.
+ *
+ * @public
+ */
+import type { ReactNode } from "react";
+import type { ViewerContext } from "./context";
+/**
+ * Slot identifiers a plugin can mount into.
+ *
+ * @public
+ */
+export type ViewerSlot = "overlay.canvas" | "panel.right" | "panel.left" | "panel.bottom" | "toolbar.top" | "toolbar.left" | "toolbar.bottom" | "annotation.source" | "dialog.modal";
+/**
+ * Common manifest shared by every plugin shape.
+ *
+ * @public
+ */
+export interface ViewerPluginManifest {
+    /** Stable plugin id. Convention: `<vendor>.<area>.<feature>`. */
+    id: string;
+    /** SemVer string — bump on protocol-affecting changes. */
+    version: string;
+    /** Slot the plugin mounts into. */
+    slot: ViewerSlot;
+    /**
+     * Optional opt-in override: when set, this plugin **replaces** the
+     * plugin with the given id in slot lookups. The replaced plugin
+     * stays registered (callers can still inspect it via `listAll()`),
+     * but `getPluginsForSlot()` returns this one instead.
+     *
+     * Use case: a third-party plugin pack ships its own findings panel
+     * by registering a `PanelPlugin` with
+     * `replaces: "vendor.findings.default"`. The viewer mounts the
+     * third-party panel; the original stays out of the slot.
+     *
+     * Constraints:
+     * - The replacement must declare the same `slot` as the target.
+     *   Cross-slot overrides are not supported (panels can't replace
+     *   overlays, etc.).
+     * - At most one plugin can claim a given `replaces` target. A
+     *   second registration that targets the same id throws.
+     * - The target id does not need to be registered yet — the
+     *   override registers cleanly even before the target loads, and
+     *   starts shadowing as soon as the target appears.
+     */
+    replaces?: string;
+}
+/**
+ * A plugin that draws on the page-overlay canvas. The mount function
+ * returns React nodes positioned within the page overlay layer.
+ *
+ * @public
+ */
+export interface OverlayPlugin extends ViewerPluginManifest {
+    slot: "overlay.canvas";
+    mount(ctx: ViewerContext): ReactNode;
+}
+/**
+ * A plugin that renders into a side or bottom panel.
+ *
+ * @public
+ */
+export interface PanelPlugin extends ViewerPluginManifest {
+    slot: "panel.right" | "panel.left" | "panel.bottom";
+    /** Display title for the panel header / tab. */
+    title: string;
+    /** Sort order within the panel slot — lower renders first. */
+    order?: number;
+    mount(ctx: ViewerContext): ReactNode;
+}
+/**
+ * A plugin that contributes a toolbar control (icon button, dropdown,
+ * or arbitrary widget).
+ *
+ * @public
+ */
+export interface ToolbarPlugin extends ViewerPluginManifest {
+    slot: "toolbar.top" | "toolbar.left" | "toolbar.bottom";
+    /** Sort order within the toolbar — lower renders first. */
+    order?: number;
+    mount(ctx: ViewerContext): ReactNode;
+}
+/**
+ * A non-visual plugin that supplies annotation data to the viewer.
+ *
+ * The viewer subscribes to `subscribe(callback)`; the provider invokes
+ * the callback with the current annotation list and on every change.
+ *
+ * @public
+ */
+export interface AnnotationSourceProvider extends ViewerPluginManifest {
+    slot: "annotation.source";
+    /** Called on mount; returns an unsubscribe function. */
+    subscribe(ctx: ViewerContext, onChange: (annotations: ReadonlyArray<unknown>) => void): () => void;
+}
+/**
+ * A plugin that can launch a modal dialog.
+ *
+ * @public
+ */
+export interface DialogPlugin extends ViewerPluginManifest {
+    slot: "dialog.modal";
+    mount(ctx: ViewerContext): ReactNode;
+}
+/**
+ * Discriminated union of every plugin shape. Use this when the slot
+ * is unknown at compile time.
+ *
+ * @public
+ */
+export type ViewerPlugin = OverlayPlugin | PanelPlugin | ToolbarPlugin | AnnotationSourceProvider | DialogPlugin;
+/**
+ * Measurement-unit plugin — pluggable unit definition for the
+ * `MeasureTool` core component. The viewer ships millimetre, inch,
+ * point, pica, and agate by default (see `units/`); hosts can
+ * extend with their own.
+ *
+ * @public
+ */
+export interface MeasurementUnit {
+    /** Stable id (e.g., `"mm"`, `"in"`). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Conversion from PDF points (1 pt = 1/72 inch) to this unit. */
+    fromPoints(points: number): number;
+    /** Inverse conversion. */
+    toPoints(value: number): number;
+}
+/**
+ * Generic overlay item rendered on top of a page canvas.
+ *
+ * Plugins and host adapters translate their domain types (findings,
+ * annotations, brand-spec violations, etc.) into `OverlayItem`s
+ * before handing them to a core component. The shape is
+ * deliberately minimal — anything richer that callers need to
+ * round-trip (per-finding metadata, click handlers, hover tooltips)
+ * goes through ``data: Record<string, unknown>``.
+ *
+ * @public
+ */
+export interface OverlayItem {
+    /** Stable identifier for selection / hover / dedupe. */
+    readonly id: string;
+    /** 1-indexed page number this item belongs to. */
+    readonly page: number;
+    /**
+     * Optional bounding box in PDF points: ``[x0, y0, x1, y1]``. When
+     * absent, the item applies to the whole page (the renderer may
+     * draw a page-level indicator instead of a bbox).
+     */
+    readonly bbox?: readonly [number, number, number, number];
+    /**
+     * Severity-like tier the renderer maps to a colour. Hosts can
+     * supply their own palette via ``ViewerServices.tokens``; the
+     * default mapping treats ``"error"`` as red, ``"warning"`` as
+     * amber, ``"advisory"`` as blue.
+     */
+    readonly tier?: "error" | "warning" | "advisory" | "info" | "neutral";
+    /** Optional CSS hex colour override (e.g., ``"#ff5722"``). */
+    readonly color?: string;
+    /** Optional short label rendered alongside the bbox. */
+    readonly label?: string;
+    /**
+     * Optional longer description used by tooltip-style renderers.
+     * The host adapter is responsible for any domain-specific
+     * cleanup before populating this field (e.g., stripping long
+     * PDF object references that would blow out the tooltip).
+     */
+    readonly description?: string;
+    /**
+     * Optional short identifier code rendered alongside the tier
+     * (e.g., a vendor-specific check id like ``"PRINT_001"``).
+     * Renderers typically display this in a code badge in tooltips.
+     */
+    readonly code?: string;
+    /** Free-form payload for round-tripping host-specific data. */
+    readonly data?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugin/types.d.ts.map

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

package/dist/plugin/types.js

@@ -0,0 +1,24 @@
+/**
+ * Viewer plugin protocol — slot types + plugin shape.
+ *
+ * Plugins extend the viewer without modifying core. Each plugin
+ * declares the slot it mounts into; the registry resolves slot
+ * lookups in order.
+ *
+ * Slots map to where a plugin's `mount()` return value renders:
+ * - `overlay.canvas` — absolutely-positioned over the page canvas;
+ *   draws annotation/finding overlays.
+ * - `panel.right`, `panel.left`, `panel.bottom` — side/bottom panels.
+ * - `toolbar.top`, `toolbar.left`, `toolbar.bottom` — toolbar pills.
+ * - `annotation.source` — non-visual; supplies annotation data via
+ *   `AnnotationSourceProvider`.
+ * - `dialog.modal` — modal dialog launched from another plugin.
+ *
+ * Anything host- or domain-shaped (host-specific findings,
+ * brand-spec violations, audit verdicts) belongs in a plugin pack,
+ * not core.
+ *
+ * @public
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../plugin/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/types/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Core viewer types — generic PDF/canvas shapes consumed by the
+ * components in `components/`.
+ *
+ * The shapes here are deliberately host-neutral: page geometry,
+ * sampling-result records, layer entries, and a `ViewerConfig`
+ * surface for feature flags + branding. Anything domain-shaped
+ * (findings, audit verdicts, brand-spec violations, art-size
+ * metadata) lives in plugin packs, not here.
+ *
+ * @public
+ */
+/** PDF box in PDF points: lower-left + upper-right corners. */
+export interface PageBox {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+}
+/** Per-page metadata returned by the engine. */
+export interface PageInfo {
+    page_num: number;
+    width_pts: number;
+    height_pts: number;
+    media_box: PageBox;
+    crop_box: PageBox | null;
+    trim_box: PageBox | null;
+    bleed_box: PageBox | null;
+    rotation: number;
+}
+/**
+ * Build a {@link PageInfo} from just the page number and PDF-point
+ * dimensions returned by a fallback adapter's ``getPageDimensions``.
+ * Sets ``media_box`` to the full page rectangle and leaves optional
+ * boxes null — matching what pdf.js exposes.
+ *
+ * @public
+ */
+export declare function pageInfoFromDimensions(pageNum: number, widthPts: number, heightPts: number): PageInfo;
+/**
+ * Dieline detection verdict. `source`:
+ * - `"name"`     — name-match heuristic (CutContour, Dieline, etc.)
+ * - `"vision"`   — vision-model spatial-reasoning fallback
+ * - `"missing"`  — no dieline found
+ */
+export interface DielineResult {
+    source: "name" | "vision" | "missing";
+    polylines: number[][][];
+    spot_name: string | null;
+    confidence: number;
+    /** Per-artwork bboxes extracted from dieline strokes. */
+    regions?: Array<{
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+        width_mm: number;
+        height_mm: number;
+    }>;
+    /** True when the dieline layer paints in more than one colour. */
+    multi_color?: boolean;
+}
+/** Optional Content Group entry surfaced by the layer panel. */
+export interface LayerInfo {
+    name: string;
+    ocg_index: number;
+    default_on: boolean;
+    /**
+     * True when this row is synthesized by the UI rather than sourced from
+     * PDF `/OCProperties` OCG data (e.g. flat PDFs with no optional content
+     * groups still get a single "Artwork" row so Layers mode doesn't look
+     * broken to non-technical users).
+     */
+    synthetic?: boolean;
+    /**
+     * Layer-row provenance:
+     * - `ocg`               — real optional-content group from the PDF
+     * - `flattened-artwork` — synthetic fallback row for flat PDFs
+     */
+    kind?: "ocg" | "flattened-artwork";
+}
+export interface ColorSample {
+    x: number;
+    y: number;
+    rgb: [number, number, number];
+    hex: string;
+    tac: number | null;
+    /** Optional per-ink breakdown — process CMYK + any spot inks the
+     *  service was able to detect at this point. Hosts that don't surface
+     *  spot data leave this undefined. */
+    inks?: ColorSampleInk[];
+}
+export interface ColorSampleInk {
+    name: string;
+    percent: number;
+    type: "process" | "spot";
+}
+export interface DensitometerChannel {
+    name: string;
+    percent: number;
+}
+export interface DensitometerSample {
+    x: number;
+    y: number;
+    dpi: number;
+    channels: DensitometerChannel[];
+    tac: number;
+    tac_limit: number;
+    limit_exceeded: boolean;
+}
+/**
+ * Capabilities the viewer can request data for. Hosts unaware of a
+ * key can leave it unset; the viewer treats absence as "not
+ * available".
+ */
+export type ViewerCapabilityKey = "findings" | "separations" | "tac" | "tac_runs" | "tiles_warmed" | "layers" | "fonts" | "images" | "thumbnails" | "metadata";
+/** How the host produced the findings list backing this viewer
+ *  session. The viewer never reads this — it's plumbed through so
+ *  hosts that mount their own panels can show provenance ("findings
+ *  generated by our engine", "imported from an external pipeline",
+ *  etc.). Hosts free to ignore or extend the union. */
+export type FindingsSourceMode = "engine" | "external" | "minimal";
+export interface ViewerConfig {
+    enable_separations: boolean;
+    enable_tac_heatmap: boolean;
+    enable_annotations: boolean;
+    /** Public share-link only: whether anonymous visitors may create annotations. */
+    allow_annotations?: boolean;
+    enable_measurement: boolean;
+    enable_comparison: boolean;
+    enable_layers: boolean;
+    enable_findings_panel: boolean;
+    enable_page_thumbnails: boolean;
+    enable_zoom: boolean;
+    enable_download: boolean;
+    enable_html_report_link: boolean;
+    verdict_mode: "auto" | "manual" | "disabled";
+    default_zoom: number;
+    default_dpi: number;
+    default_tac_limit: number;
+    viewer_logo_url: string | null;
+    viewer_accent_color: string | null;
+    toolbar_position: "top" | "bottom";
+    dark_mode: boolean;
+    /** Resolved branding — null fields when `anonymous` is true. */
+    brand_name: string | null;
+    brand_logo_url: string | null;
+    brand_primary_color: string | null;
+    brand_accent_color: string | null;
+    /** True when the viewer must hide all tenant + host chrome. */
+    anonymous: boolean;
+    tenant_name: string | null;
+    support_email: string | null;
+    /** How findings were produced for this job. See {@link FindingsSourceMode}. */
+    findings_source: FindingsSourceMode;
+    /** Per-capability availability map (true = backed by data). */
+    capabilities: Partial<Record<ViewerCapabilityKey, boolean>>;
+    /** Plan-gate: false means the tenant may not invoke on-demand
+     *  capability fill-in. */
+    capability_fillin_enabled: boolean;
+    /** Plan-gate: false means the viewer must hide annotation toolbar. */
+    annotations_enabled: boolean;
+    /** Plan-gate: empty means report downloads are not available. */
+    allowed_report_formats: string[];
+    tile_cdn_base: string | null;
+}
+export declare const DEFAULT_VIEWER_CONFIG: ViewerConfig;
+/**
+ * Severity-keyed fill/stroke palette. The keys mirror
+ * `OverlayItem["tier"]`'s `error` / `warning` / `advisory` values
+ * so canvas renderers can index in directly.
+ */
+export declare const SEVERITY_COLORS: {
+    readonly error: {
+        readonly fill: "rgba(239, 68, 68, 0.15)";
+        readonly stroke: "#ef4444";
+    };
+    readonly warning: {
+        readonly fill: "rgba(245, 158, 11, 0.15)";
+        readonly stroke: "#f59e0b";
+    };
+    readonly advisory: {
+        readonly fill: "rgba(59, 130, 246, 0.15)";
+        readonly stroke: "#3b82f6";
+    };
+};
+/** Default render DPI for canvas-backed page tiles. */
+export declare const DEFAULT_DPI = 150;
+/** Default DPI for thumbnail/page-navigator tiles. */
+export declare const THUMBNAIL_DPI = 72;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,95 @@
+/**
+ * Core viewer types — generic PDF/canvas shapes consumed by the
+ * components in `components/`.
+ *
+ * The shapes here are deliberately host-neutral: page geometry,
+ * sampling-result records, layer entries, and a `ViewerConfig`
+ * surface for feature flags + branding. Anything domain-shaped
+ * (findings, audit verdicts, brand-spec violations, art-size
+ * metadata) lives in plugin packs, not here.
+ *
+ * @public
+ */
+/**
+ * Build a {@link PageInfo} from just the page number and PDF-point
+ * dimensions returned by a fallback adapter's ``getPageDimensions``.
+ * Sets ``media_box`` to the full page rectangle and leaves optional
+ * boxes null — matching what pdf.js exposes.
+ *
+ * @public
+ */
+export function pageInfoFromDimensions(pageNum, widthPts, heightPts) {
+    return {
+        page_num: pageNum,
+        width_pts: widthPts,
+        height_pts: heightPts,
+        media_box: { x0: 0, y0: 0, x1: widthPts, y1: heightPts },
+        crop_box: null,
+        trim_box: null,
+        bleed_box: null,
+        rotation: 0,
+    };
+}
+export const DEFAULT_VIEWER_CONFIG = {
+    enable_separations: true,
+    enable_tac_heatmap: true,
+    enable_annotations: true,
+    enable_measurement: true,
+    enable_comparison: true,
+    enable_layers: true,
+    enable_findings_panel: true,
+    enable_page_thumbnails: true,
+    enable_zoom: true,
+    enable_download: true,
+    enable_html_report_link: true,
+    verdict_mode: "auto",
+    default_zoom: 100,
+    default_dpi: 150,
+    default_tac_limit: 300,
+    viewer_logo_url: null,
+    viewer_accent_color: null,
+    toolbar_position: "top",
+    dark_mode: false,
+    brand_name: null,
+    brand_logo_url: null,
+    brand_primary_color: "#1a3a7a",
+    brand_accent_color: "#2563eb",
+    anonymous: false,
+    tenant_name: null,
+    support_email: null,
+    findings_source: "engine",
+    capabilities: {
+        findings: true,
+        separations: true,
+        tac: true,
+        tac_runs: true,
+        tiles_warmed: false,
+        layers: true,
+        fonts: true,
+        images: true,
+        thumbnails: true,
+        metadata: true,
+    },
+    capability_fillin_enabled: true,
+    annotations_enabled: true,
+    allowed_report_formats: ["json", "html", "pdf", "xml"],
+    tile_cdn_base: null,
+};
+// ---------------------------------------------------------------------------
+// Render constants
+// ---------------------------------------------------------------------------
+/**
+ * Severity-keyed fill/stroke palette. The keys mirror
+ * `OverlayItem["tier"]`'s `error` / `warning` / `advisory` values
+ * so canvas renderers can index in directly.
+ */
+export const SEVERITY_COLORS = {
+    error: { fill: "rgba(239, 68, 68, 0.15)", stroke: "#ef4444" },
+    warning: { fill: "rgba(245, 158, 11, 0.15)", stroke: "#f59e0b" },
+    advisory: { fill: "rgba(59, 130, 246, 0.15)", stroke: "#3b82f6" },
+};
+/** Default render DPI for canvas-backed page tiles. */
+export const DEFAULT_DPI = 150;
+/** Default DPI for thumbnail/page-navigator tiles. */
+export const THUMBNAIL_DPI = 72;
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA0BH;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,QAAgB,EAChB,SAAiB;IAEjB,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE;QACxD,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAgKD,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,IAAI;IACnB,qBAAqB,EAAE,IAAI;IAC3B,sBAAsB,EAAE,IAAI;IAC5B,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI;IACrB,uBAAuB,EAAE,IAAI;IAC7B,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,GAAG;IACjB,WAAW,EAAE,GAAG;IAChB,iBAAiB,EAAE,GAAG;IACtB,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,KAAK;IACvB,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,SAAS;IAC9B,kBAAkB,EAAE,SAAS;IAC7B,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,QAAQ;IACzB,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI;QACjB,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,KAAK;QACnB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf;IACD,yBAAyB,EAAE,IAAI;IAC/B,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IACtD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,SAAS,EAAE;IAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,MAAM,EAAE,SAAS,EAAE;IAChE,QAAQ,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,MAAM,EAAE,SAAS,EAAE;CACzD,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAE/B,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC"}

package/dist/units/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Built-in measurement units shipped with the viewer.
+ *
+ * Five units are wired by default: millimetre, inch, point, pica,
+ * agate. Hosts can pass any subset (or extend with their own custom
+ * units) via the `units` prop on `MeasureTool`.
+ *
+ * Conversions are anchored to PDF points (1 pt = 1/72 inch). The
+ * inch is exact (25.4 mm), so all derived units are deterministic.
+ *
+ * @public
+ */
+import type { MeasurementUnit } from "../plugin/types";
+/**
+ * Millimetre. The metric default for print workflows.
+ *
+ * @public
+ */
+export declare const mmUnit: MeasurementUnit;
+/**
+ * Inch. The U.S. print standard.
+ *
+ * @public
+ */
+export declare const inchUnit: MeasurementUnit;
+/**
+ * Point. The PDF coordinate-space native unit (1 pt = 1/72 inch).
+ *
+ * @public
+ */
+export declare const pointUnit: MeasurementUnit;
+/**
+ * Pica. Twelve points. Used in classical typography for body
+ * widths and column gutters.
+ *
+ * @public
+ */
+export declare const picaUnit: MeasurementUnit;
+/**
+ * Agate. 5.5 points. Historical newspaper measurement for column
+ * inches in classified ads.
+ *
+ * @public
+ */
+export declare const agateUnit: MeasurementUnit;
+/**
+ * The five built-in units in display order: mm, in, pt, pica,
+ * agate. `MeasureTool` defaults to a subset (`defaultMeasurementUnits`)
+ * for readability; consumers that want all five pass this array.
+ *
+ * @public
+ */
+export declare const allMeasurementUnits: ReadonlyArray<MeasurementUnit>;
+/**
+ * Default units shown by `MeasureTool` when no `units` prop is
+ * supplied: mm, in, pt. The two old-school print units (pica,
+ * agate) are available as opt-ins via `allMeasurementUnits` or
+ * by passing them explicitly — the readout would otherwise get
+ * cluttered for the common case.
+ *
+ * @public
+ */
+export declare const defaultMeasurementUnits: ReadonlyArray<MeasurementUnit>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../units/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,eAKpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,eAKtB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,eAKvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,eAKtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,eAKvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,eAAe,CAM9D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,eAAe,CAIlE,CAAC"}