@printwithsynergy/lens-pdf 0.3.0-beta.81

package/dist/host/pdfFallback.d.ts

@@ -0,0 +1,50 @@
+/**
+ * In-browser PDF fallback adapter built on pdf.js.
+ *
+ * Provides "minimum data" for the fallback-capable tools (PageCanvas,
+ * PageNavigator, MeasureTool, LayerPanel, ColorPickerTool) when a host
+ * hasn't wired richer services. Hosts pass the returned adapter as
+ * ``pdfFallback`` on the host context.
+ *
+ * pdf.js is loaded lazily via dynamic ``import("pdfjs-dist")`` so it
+ * stays out of the bundle for hosts that don't use this fallback. Add
+ * ``pdfjs-dist`` to your app's dependencies (it's an optional peer dep
+ * of ``@printwithsynergy/lens-pdf``).
+ *
+ * **Security**: this adapter fetches whatever URL the host hands it.
+ * Sign / scope / expire the URL the same way you would any other PDF
+ * download — the viewer is a pure renderer and trusts the host to
+ * enforce access control upstream.
+ *
+ * @public
+ */
+import type { PdfFallbackAdapter } from "../plugin/services";
+interface PdfJsFallbackOptions {
+    /** Raw PDF URL. Must be reachable from the user's browser. */
+    pdfUrl: string;
+    /**
+     * Optional override for the pdf.js worker URL. When omitted, the
+     * adapter assumes the bundler / host has already configured
+     * ``GlobalWorkerOptions.workerSrc``.
+     */
+    workerSrc?: string;
+}
+/**
+ * Build a {@link PdfFallbackAdapter} backed by pdf.js. The returned
+ * adapter caches the parsed document and per-page rasters so repeated
+ * calls don't re-parse or re-render.
+ *
+ * @deprecated Use ``createPdfJsFallback`` from
+ *   ``@printwithsynergy/lens-pdf/fallback-pdfjs`` instead. The
+ *   subpath imports pdfjs-dist statically so bundlers trace it
+ *   correctly without consumers having to side-effect-import the
+ *   dep. This `/host` export uses a dynamic ``await import("...")``
+ *   that bundlers don't trace; works at runtime only when
+ *   pdfjs-dist is also installed and resolvable from the consuming
+ *   app's module graph. New code should not use this entry point.
+ *
+ * @public
+ */
+export declare function createPdfJsFallback(opts: PdfJsFallbackOptions): PdfFallbackAdapter;
+export {};
+//# sourceMappingURL=pdfFallback.d.ts.map

package/dist/host/pdfFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfFallback.d.ts","sourceRoot":"","sources":["../../host/pdfFallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAwC7D,UAAU,oBAAoB;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAwHlF"}

package/dist/host/pdfFallback.js

@@ -0,0 +1,171 @@
+/**
+ * In-browser PDF fallback adapter built on pdf.js.
+ *
+ * Provides "minimum data" for the fallback-capable tools (PageCanvas,
+ * PageNavigator, MeasureTool, LayerPanel, ColorPickerTool) when a host
+ * hasn't wired richer services. Hosts pass the returned adapter as
+ * ``pdfFallback`` on the host context.
+ *
+ * pdf.js is loaded lazily via dynamic ``import("pdfjs-dist")`` so it
+ * stays out of the bundle for hosts that don't use this fallback. Add
+ * ``pdfjs-dist`` to your app's dependencies (it's an optional peer dep
+ * of ``@printwithsynergy/lens-pdf``).
+ *
+ * **Security**: this adapter fetches whatever URL the host hands it.
+ * Sign / scope / expire the URL the same way you would any other PDF
+ * download — the viewer is a pure renderer and trusts the host to
+ * enforce access control upstream.
+ *
+ * @public
+ */
+async function loadPdfJs() {
+    // Dynamic import keeps pdfjs-dist out of the bundle for hosts that
+    // don't use the fallback. The string literal is split so bundlers
+    // that try to statically resolve the spec don't fail loudly when
+    // pdfjs-dist isn't installed.
+    const spec = "pdfjs" + "-dist";
+    let mod;
+    try {
+        mod = (await import(/* @vite-ignore */ spec));
+    }
+    catch (err) {
+        throw new Error("[lens-pdf] createPdfJsFallback requires `pdfjs-dist` to be installed. " +
+            "Add it to your app's dependencies, or omit `pdfFallback` from the host context.", { cause: err });
+    }
+    const api = (mod.default ?? mod);
+    if (!api.getDocument) {
+        throw new Error("[lens-pdf] Loaded `pdfjs-dist` does not expose getDocument.");
+    }
+    return api;
+}
+/**
+ * Build a {@link PdfFallbackAdapter} backed by pdf.js. The returned
+ * adapter caches the parsed document and per-page rasters so repeated
+ * calls don't re-parse or re-render.
+ *
+ * @deprecated Use ``createPdfJsFallback`` from
+ *   ``@printwithsynergy/lens-pdf/fallback-pdfjs`` instead. The
+ *   subpath imports pdfjs-dist statically so bundlers trace it
+ *   correctly without consumers having to side-effect-import the
+ *   dep. This `/host` export uses a dynamic ``await import("...")``
+ *   that bundlers don't trace; works at runtime only when
+ *   pdfjs-dist is also installed and resolvable from the consuming
+ *   app's module graph. New code should not use this entry point.
+ *
+ * @public
+ */
+export function createPdfJsFallback(opts) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let docPromise = null;
+    const renderCache = new Map();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async function getDoc() {
+        if (!docPromise) {
+            docPromise = (async () => {
+                const api = await loadPdfJs();
+                if (opts.workerSrc)
+                    api.GlobalWorkerOptions.workerSrc = opts.workerSrc;
+                return api.getDocument({ url: opts.pdfUrl }).promise;
+            })();
+        }
+        return docPromise;
+    }
+    return {
+        async getPageCount() {
+            const doc = await getDoc();
+            return doc.numPages;
+        },
+        async getPageDimensions(pageNum) {
+            const doc = await getDoc();
+            const page = await doc.getPage(pageNum);
+            const viewport = page.getViewport({ scale: 1 });
+            return { widthPts: viewport.width, heightPts: viewport.height };
+        },
+        async renderPageToUrl({ pageNum, dpi }) {
+            const cacheKey = `${pageNum}@${dpi}`;
+            const cached = renderCache.get(cacheKey);
+            if (cached)
+                return cached;
+            const doc = await getDoc();
+            const page = await doc.getPage(pageNum);
+            const scale = dpi / 72;
+            const viewport = page.getViewport({ scale });
+            const canvas = document.createElement("canvas");
+            canvas.width = Math.ceil(viewport.width);
+            canvas.height = Math.ceil(viewport.height);
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                throw new Error("[lens-pdf] 2D context unavailable for fallback render.");
+            await page.render({ canvasContext: ctx, viewport }).promise;
+            const url = canvas.toDataURL("image/png");
+            renderCache.set(cacheKey, url);
+            return url;
+        },
+        async listLayers() {
+            const doc = await getDoc();
+            // pdf.js exposes OCGs through the OptionalContentConfig. Older
+            // versions / RGB-only PDFs simply have no groups → empty list.
+            let config;
+            try {
+                config = await doc.getOptionalContentConfig();
+            }
+            catch {
+                return [];
+            }
+            const groups = (config?.getGroups?.() ?? {});
+            const ids = Object.keys(groups);
+            return ids.map((id, index) => ({
+                name: groups[id]?.name ?? `Layer ${index + 1}`,
+                ocg_index: index,
+                default_on: config.isVisible(id) ?? true,
+            }));
+        },
+        async sampleColorAt({ pageNum, pdfX, pdfY, dpi = 150 }) {
+            const doc = await getDoc();
+            const page = await doc.getPage(pageNum);
+            const ptsToPx = dpi / 72;
+            const viewport = page.getViewport({ scale: ptsToPx });
+            // Render the whole page once per (page, dpi) and cache the
+            // canvas — repeated sampling is then a single getImageData call.
+            const canvasKey = `${pageNum}@${dpi}`;
+            let canvas = sampleCanvases.get(canvasKey);
+            if (!canvas) {
+                canvas = document.createElement("canvas");
+                canvas.width = Math.ceil(viewport.width);
+                canvas.height = Math.ceil(viewport.height);
+                const renderCtx = canvas.getContext("2d", { willReadFrequently: true });
+                if (!renderCtx)
+                    return null;
+                await page.render({ canvasContext: renderCtx, viewport }).promise;
+                sampleCanvases.set(canvasKey, canvas);
+            }
+            // pdfX/pdfY use PDF-point coords with origin lower-left; canvas
+            // pixels use origin upper-left.
+            const pageHeightPts = viewport.height / ptsToPx;
+            const pxX = Math.max(0, Math.min(canvas.width - 1, Math.round(pdfX * ptsToPx)));
+            const pxY = Math.max(0, Math.min(canvas.height - 1, Math.round((pageHeightPts - pdfY) * ptsToPx)));
+            const ctx = canvas.getContext("2d");
+            if (!ctx)
+                return null;
+            const data = ctx.getImageData(pxX, pxY, 1, 1).data;
+            const r = data[0] ?? 0;
+            const g = data[1] ?? 0;
+            const b = data[2] ?? 0;
+            const hex = "#" +
+                [r, g, b]
+                    .map((v) => v.toString(16).padStart(2, "0"))
+                    .join("");
+            const sample = {
+                x: pdfX,
+                y: pdfY,
+                rgb: [r, g, b],
+                hex,
+                // pdf.js renders to RGB only — no real ink coverage available.
+                tac: null,
+            };
+            return sample;
+        },
+    };
+}
+const sampleCanvases = new Map();
+//# sourceMappingURL=pdfFallback.js.map

package/dist/host/pdfFallback.js.map

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

package/dist/host/pdfValidation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Client-side PDF validation utilities.
+ *
+ * Provides quick checks (magic bytes, MIME type, file size) before
+ * handing a file to the viewer or pdf.js fallback. These run entirely
+ * in the browser — no server round-trip required.
+ *
+ * @public
+ */
+/** Result of a PDF validation check. */
+export interface PdfValidationResult {
+    /** Whether the file passed all checks. */
+    valid: boolean;
+    /** Human-readable error message when `valid` is false. */
+    error?: string;
+}
+/**
+ * Validate a `File` object before loading it into the viewer.
+ *
+ * Checks (in order):
+ * 1. MIME type is `application/pdf` (or empty — some browsers don't
+ *    populate it for drag-dropped files).
+ * 2. First 5 bytes match the PDF magic signature `%PDF-`.
+ * 3. File size is within the allowed limit.
+ *
+ * @param file - The `File` to validate.
+ * @param maxBytes - Maximum allowed size in bytes. Default: 50 MB.
+ * @returns A promise resolving to the validation result.
+ *
+ * @public
+ */
+export declare function validatePdfFile(file: File, maxBytes?: number): Promise<PdfValidationResult>;
+/**
+ * Validate a PDF URL string before loading it into the viewer.
+ *
+ * This is a **synchronous** surface-level check — it validates URL
+ * format only. It does not fetch the URL or inspect response headers.
+ *
+ * @param url - The URL string to validate.
+ * @returns The validation result.
+ *
+ * @public
+ */
+export declare function validatePdfUrl(url: string): PdfValidationResult;
+//# sourceMappingURL=pdfValidation.d.ts.map

package/dist/host/pdfValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfValidation.d.ts","sourceRoot":"","sources":["../../host/pdfValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAgB/D"}

package/dist/host/pdfValidation.js

@@ -0,0 +1,78 @@
+/**
+ * Client-side PDF validation utilities.
+ *
+ * Provides quick checks (magic bytes, MIME type, file size) before
+ * handing a file to the viewer or pdf.js fallback. These run entirely
+ * in the browser — no server round-trip required.
+ *
+ * @public
+ */
+/** Default maximum file size: 50 MB. */
+const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
+/** PDF magic bytes: `%PDF-` (hex 25 50 44 46 2D). */
+const PDF_MAGIC = new Uint8Array([0x25, 0x50, 0x44, 0x46, 0x2d]);
+/**
+ * Validate a `File` object before loading it into the viewer.
+ *
+ * Checks (in order):
+ * 1. MIME type is `application/pdf` (or empty — some browsers don't
+ *    populate it for drag-dropped files).
+ * 2. First 5 bytes match the PDF magic signature `%PDF-`.
+ * 3. File size is within the allowed limit.
+ *
+ * @param file - The `File` to validate.
+ * @param maxBytes - Maximum allowed size in bytes. Default: 50 MB.
+ * @returns A promise resolving to the validation result.
+ *
+ * @public
+ */
+export async function validatePdfFile(file, maxBytes = DEFAULT_MAX_BYTES) {
+    // MIME check (allow empty — some browsers omit MIME for drag-drop)
+    if (file.type && file.type !== "application/pdf") {
+        return { valid: false, error: "File is not a PDF. Expected MIME type application/pdf." };
+    }
+    // Size check
+    if (file.size > maxBytes) {
+        const maxMb = Math.round(maxBytes / (1024 * 1024));
+        return { valid: false, error: `File is too large. Maximum size is ${maxMb} MB.` };
+    }
+    // Magic bytes check
+    try {
+        const header = new Uint8Array(await file.slice(0, 5).arrayBuffer());
+        if (header.length < 5 || !PDF_MAGIC.every((b, i) => header[i] === b)) {
+            return { valid: false, error: "File does not appear to be a valid PDF (missing %PDF- header)." };
+        }
+    }
+    catch {
+        return { valid: false, error: "Could not read file header." };
+    }
+    return { valid: true };
+}
+/**
+ * Validate a PDF URL string before loading it into the viewer.
+ *
+ * This is a **synchronous** surface-level check — it validates URL
+ * format only. It does not fetch the URL or inspect response headers.
+ *
+ * @param url - The URL string to validate.
+ * @returns The validation result.
+ *
+ * @public
+ */
+export function validatePdfUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed) {
+        return { valid: false, error: "URL is empty." };
+    }
+    try {
+        const parsed = new URL(trimmed);
+        if (!["http:", "https:", "blob:"].includes(parsed.protocol)) {
+            return { valid: false, error: "URL must use http://, https://, or blob: protocol." };
+        }
+    }
+    catch {
+        return { valid: false, error: "Invalid URL format." };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=pdfValidation.js.map

package/dist/host/pdfValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfValidation.js","sourceRoot":"","sources":["../../host/pdfValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,wCAAwC;AACxC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,qDAAqD;AACrD,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAU,EACV,WAAmB,iBAAiB;IAEpC,mEAAmE;IACnE,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;IAC3F,CAAC;IAED,aAAa;IACb,IAAI,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sCAAsC,KAAK,MAAM,EAAE,CAAC;IACpF,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gEAAgE,EAAE,CAAC;QACnG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;QACvF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/host/shareLink.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shareable viewer link utilities.
+ *
+ * {@link generateShareLink} builds a URL that opens a LensPDF viewer
+ * with a specific PDF pre-loaded and settings applied.
+ * {@link parseShareParams} parses those query params back into props.
+ *
+ * URL format:
+ * ```
+ * https://lenspdf.com/demo?url=<encoded>&fullscreen=true&zoom=150&page=1&mode=single&theme=dark
+ * ```
+ *
+ * @public
+ */
+import type { ThemeTokens } from "../plugin/services";
+/** Options for {@link generateShareLink}. */
+export interface ShareLinkOptions {
+    /** Base URL of the host's demo/viewer page (e.g. `https://lenspdf.com/demo`). */
+    baseUrl: string;
+    /** PDF URL to pre-load. */
+    pdfUrl: string;
+    /** Open in fullscreen mode (no site chrome). Default: false. */
+    fullscreen?: boolean;
+    /** Initial zoom percentage. */
+    zoom?: number;
+    /** Initial page number. */
+    page?: number;
+    /** Viewer scroll mode. */
+    mode?: "scroll" | "single";
+    /** Tools to enable (encoded as comma-separated in URL). */
+    tools?: string[];
+    /** Theme: preset name or inline token overrides. */
+    theme?: "light" | "dark" | Partial<ThemeTokens>;
+}
+/**
+ * Build a shareable viewer URL with query params.
+ *
+ * ```ts
+ * const link = generateShareLink({
+ *   baseUrl: "https://lenspdf.com/demo",
+ *   pdfUrl: "https://cdn.example.com/proof.pdf",
+ *   fullscreen: true,
+ *   zoom: 150,
+ * });
+ * // → "https://lenspdf.com/demo?url=https%3A%2F%2Fcdn.example.com%2Fproof.pdf&fullscreen=true&zoom=150"
+ * ```
+ *
+ * @public
+ */
+export declare function generateShareLink(opts: ShareLinkOptions): string;
+/** Parsed share parameters returned by {@link parseShareParams}. */
+export interface ParsedShareParams {
+    /** PDF URL to pre-load, or undefined if not specified. */
+    pdfUrl?: string;
+    /** Whether to open in fullscreen mode. */
+    fullscreen: boolean;
+    /** Initial zoom percentage, or undefined. */
+    zoom?: number;
+    /** Initial page number, or undefined. */
+    page?: number;
+    /** Viewer mode, or undefined. */
+    mode?: "scroll" | "single";
+    /** Tools to enable, or undefined. */
+    tools?: string[];
+    /** Theme preset name or inline tokens, or undefined. */
+    theme?: "light" | "dark" | Partial<ThemeTokens>;
+}
+/**
+ * Parse query params from a shareable viewer URL back into props.
+ * Use this in the host's page component to read URL state:
+ *
+ * ```ts
+ * const params = parseShareParams(new URLSearchParams(window.location.search));
+ * <LensPDFDemo initialPdfUrl={params.pdfUrl} fullscreen={params.fullscreen} />
+ * ```
+ *
+ * @public
+ */
+export declare function parseShareParams(searchParams: URLSearchParams): ParsedShareParams;
+//# sourceMappingURL=shareLink.d.ts.map

package/dist/host/shareLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shareLink.d.ts","sourceRoot":"","sources":["../../host/shareLink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA8BhE;AAMD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,iBAAiB,CA2CjF"}

package/dist/host/shareLink.js

@@ -0,0 +1,114 @@
+/**
+ * Shareable viewer link utilities.
+ *
+ * {@link generateShareLink} builds a URL that opens a LensPDF viewer
+ * with a specific PDF pre-loaded and settings applied.
+ * {@link parseShareParams} parses those query params back into props.
+ *
+ * URL format:
+ * ```
+ * https://lenspdf.com/demo?url=<encoded>&fullscreen=true&zoom=150&page=1&mode=single&theme=dark
+ * ```
+ *
+ * @public
+ */
+/**
+ * Build a shareable viewer URL with query params.
+ *
+ * ```ts
+ * const link = generateShareLink({
+ *   baseUrl: "https://lenspdf.com/demo",
+ *   pdfUrl: "https://cdn.example.com/proof.pdf",
+ *   fullscreen: true,
+ *   zoom: 150,
+ * });
+ * // → "https://lenspdf.com/demo?url=https%3A%2F%2Fcdn.example.com%2Fproof.pdf&fullscreen=true&zoom=150"
+ * ```
+ *
+ * @public
+ */
+export function generateShareLink(opts) {
+    const url = new URL(opts.baseUrl);
+    url.searchParams.set("url", opts.pdfUrl);
+    if (opts.fullscreen) {
+        url.searchParams.set("fullscreen", "true");
+    }
+    if (opts.zoom !== undefined) {
+        url.searchParams.set("zoom", String(opts.zoom));
+    }
+    if (opts.page !== undefined) {
+        url.searchParams.set("page", String(opts.page));
+    }
+    if (opts.mode && opts.mode !== "scroll") {
+        url.searchParams.set("mode", opts.mode);
+    }
+    if (opts.tools && opts.tools.length > 0) {
+        url.searchParams.set("tools", opts.tools.join(","));
+    }
+    if (opts.theme) {
+        if (typeof opts.theme === "string") {
+            url.searchParams.set("theme", opts.theme);
+        }
+        else {
+            // Inline tokens are encoded as JSON.
+            url.searchParams.set("theme", JSON.stringify(opts.theme));
+        }
+    }
+    return url.toString();
+}
+/**
+ * Parse query params from a shareable viewer URL back into props.
+ * Use this in the host's page component to read URL state:
+ *
+ * ```ts
+ * const params = parseShareParams(new URLSearchParams(window.location.search));
+ * <LensPDFDemo initialPdfUrl={params.pdfUrl} fullscreen={params.fullscreen} />
+ * ```
+ *
+ * @public
+ */
+export function parseShareParams(searchParams) {
+    const result = {
+        fullscreen: false,
+    };
+    const url = searchParams.get("url");
+    if (url)
+        result.pdfUrl = url;
+    const fullscreen = searchParams.get("fullscreen");
+    if (fullscreen === "true" || fullscreen === "1")
+        result.fullscreen = true;
+    const zoom = searchParams.get("zoom");
+    if (zoom) {
+        const parsed = parseInt(zoom, 10);
+        if (!isNaN(parsed) && parsed > 0)
+            result.zoom = parsed;
+    }
+    const page = searchParams.get("page");
+    if (page) {
+        const parsed = parseInt(page, 10);
+        if (!isNaN(parsed) && parsed > 0)
+            result.page = parsed;
+    }
+    const mode = searchParams.get("mode");
+    if (mode === "scroll" || mode === "single")
+        result.mode = mode;
+    const tools = searchParams.get("tools");
+    if (tools)
+        result.tools = tools.split(",").filter(Boolean);
+    const theme = searchParams.get("theme");
+    if (theme) {
+        if (theme === "light" || theme === "dark") {
+            result.theme = theme;
+        }
+        else {
+            try {
+                result.theme = JSON.parse(theme);
+            }
+            catch {
+                // Invalid JSON — ignore.
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=shareLink.js.map

package/dist/host/shareLink.js.map

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

package/dist/host/useLensPDF.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `useLensPDF` — React hook that manages all viewer state.
+ *
+ * Returns everything a consumer needs to render a viewer: context
+ * values, fallback adapter, page/zoom/layer/tool state, and
+ * computed canvas dimensions. Pass the return value to
+ * {@link LensPDFProvider} (or spread into `<LensPDFViewer>`) and
+ * you're done — no manual context wiring required.
+ *
+ * @public
+ */
+import type { PdfFallbackAdapter, ThemeTokens, ViewerServices } from "../plugin/services";
+import type { PageInfo } from "../types";
+import type { ViewerHostContextValue } from "./index";
+/** Options for {@link useLensPDF}. */
+export interface UseLensPDFOptions {
+    /** Theme tokens. Merged onto defaults. */
+    tokens?: Partial<ThemeTokens>;
+    /** Partial wired services — unwired fields auto-filled with no-op defaults. */
+    services?: Partial<ViewerServices>;
+    /** Initial zoom percentage. Default 100. */
+    initialZoom?: number;
+    /** Viewer mode. Default "scroll". */
+    mode?: "scroll" | "single";
+    /** Override pdf.js worker URL. Uses CDN default when omitted. */
+    workerSrc?: string;
+    /** Initial page number (1-indexed). Default 1. */
+    initialPage?: number;
+}
+/** Full viewer state returned by {@link useLensPDF}. */
+export interface UseLensPDFReturn {
+    hostValue: ViewerHostContextValue;
+    servicesValue: ViewerServices;
+    fallback: PdfFallbackAdapter | undefined;
+    pageCount: number | null;
+    currentPage: number;
+    setCurrentPage: (n: number) => void;
+    currentPageInfo: PageInfo;
+    pages: PageInfo[];
+    pageDims: Map<number, {
+        widthPts: number;
+        heightPts: number;
+    }>;
+    zoom: number;
+    setZoom: (z: number) => void;
+    canvasWidth: number;
+    canvasHeight: number;
+    enabledLayers: Set<number>;
+    toggleLayer: (ocgIndex: number) => void;
+    setAllLayers: (enabled: boolean) => void;
+    hasLayers: boolean;
+    activeTool: "none" | "color-picker" | "measure";
+    setActiveTool: (t: "none" | "color-picker" | "measure") => void;
+    error: string | null;
+    setError: (e: string | null) => void;
+}
+/**
+ * Manages all LensPDF viewer state. Pair with `<LensPDFProvider>`
+ * or `<LensPDFViewer>` for rendering.
+ *
+ * ```tsx
+ * const viewer = useLensPDF("https://cdn.example.com/proof.pdf");
+ * return (
+ *   <LensPDFProvider value={viewer}>
+ *     <PageCanvas page={viewer.currentPageInfo} zoom={viewer.zoom} ... />
+ *   </LensPDFProvider>
+ * );
+ * ```
+ *
+ * @public
+ */
+export declare function useLensPDF(pdfUrl: string | undefined, opts?: UseLensPDFOptions): UseLensPDFReturn;
+//# sourceMappingURL=useLensPDF.d.ts.map

package/dist/host/useLensPDF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLensPDF.d.ts","sourceRoot":"","sources":["../../host/useLensPDF.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAMtD,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAE/B,SAAS,EAAE,sBAAsB,CAAC;IAClC,aAAa,EAAE,cAAc,CAAC;IAG9B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAGzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,eAAe,EAAE,QAAQ,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAG/D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IAGrB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IAGnB,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAChD,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IAGhE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACtC;AAcD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,GAAE,iBAAsB,GAC3B,gBAAgB,CAmMlB"}