@happyvertical/smrt-ui 0.57.20 → 0.57.21

package/dist/components/display/document-viewer-logic.js

@@ -0,0 +1,56 @@
+/**
+ * Pure helpers for `DocumentViewer` (smrt#3463): zoom stepping, pinch
+ * clamping, page bounds, and the canvas render scale. Svelte-free.
+ */
+/** The zoom steps, as multiples of "Fit" (the sheet's width). */
+export const ZOOM_STEPS = [1, 1.5, 2, 3, 4, 5];
+/** The smallest and largest zoom. */
+export const MIN_ZOOM = ZOOM_STEPS[0];
+export const MAX_ZOOM = ZOOM_STEPS[ZOOM_STEPS.length - 1];
+/** The biggest canvas drawn, in device pixels; zooming past it enlarges on screen instead. */
+export const MAX_CANVAS_PIXELS = 4096 * 4096;
+const EPSILON = 0.01;
+/**
+ * The next zoom step above (`direction` 1) or below (-1) `zoom`. A zoom between
+ * steps (left by a pinch) moves to the nearest step in that direction; at an
+ * end it stays put.
+ */
+export function stepZoom(zoom, direction) {
+    if (direction > 0) {
+        return ZOOM_STEPS.find((step) => step > zoom + EPSILON) ?? MAX_ZOOM;
+    }
+    return ([...ZOOM_STEPS].reverse().find((step) => step < zoom - EPSILON) ?? MIN_ZOOM);
+}
+/** Clamp a zoom to the supported range. */
+export function clampZoom(zoom) {
+    return Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, zoom));
+}
+/** The live pinch scale, bounded so `zoom * scale` stays within the zoom range. */
+export function clampPinchScale(zoom, scale) {
+    return Math.min(MAX_ZOOM / zoom, Math.max(MIN_ZOOM / zoom, scale));
+}
+/** The zoom a finished pinch commits: `zoom * scale`, to 0.1, within range. */
+export function commitPinchZoom(zoom, scale) {
+    return clampZoom(Math.round(zoom * scale * 10) / 10);
+}
+/** `page + delta` kept within `1..pages`. */
+export function clampPage(page, delta, pages) {
+    return Math.min(Math.max(1, pages), Math.max(1, page + delta));
+}
+/**
+ * The pdf.js scale that draws a page `cssWidth` wide at `ratio` device pixels
+ * per CSS pixel, reduced when the canvas would exceed `MAX_CANVAS_PIXELS`.
+ */
+export function renderScale(pageWidth, pageHeight, cssWidth, ratio, maxPixels = MAX_CANVAS_PIXELS) {
+    const scale = (cssWidth / pageWidth) * ratio;
+    const pixels = pageWidth * scale * pageHeight * scale;
+    return pixels > maxPixels ? scale * Math.sqrt(maxPixels / pixels) : scale;
+}
+/** Whether a MIME type is a PDF. */
+export function isPdfType(mimeType) {
+    return mimeType.split(';')[0]?.trim().toLowerCase() === 'application/pdf';
+}
+/** Whether a MIME type is an image the browser can show. */
+export function isImageType(mimeType) {
+    return mimeType.trim().toLowerCase().startsWith('image/');
+}

package/dist/components/display/index.d.ts

@@ -4,9 +4,13 @@
 export { default as ConfidenceBadge } from './ConfidenceBadge.svelte';
 export { default as CurrencyDisplay } from './CurrencyDisplay.svelte';
 export { default as DateDisplay } from './DateDisplay.svelte';
+export { default as DocumentViewer } from './DocumentViewer.svelte';
 export { default as Icon } from './Icon.svelte';
 export { default as StatusBadge } from './StatusBadge.svelte';
 export type { IconPathMap } from './icons.svelte.js';
 export { registerIcons } from './icons.svelte.js';
-export type { StatusTone, StatusType } from './types.js';
+export { createPdfJsOpener, type PdfJsLike, type PdfJsOpenerOptions, } from './pdf-opener.js';
+export type { OpenPdf, PdfDocument } from './pdf-types.js';
+export { PdfEngineUnavailableError } from './pdf-types.js';
+export type { DocumentViewerLabels, StatusTone, StatusType } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/display/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/display/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAM9D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/display/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAM9D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EACL,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/display/index.js

@@ -5,6 +5,10 @@
 export { default as ConfidenceBadge } from './ConfidenceBadge.svelte';
 export { default as CurrencyDisplay } from './CurrencyDisplay.svelte';
 export { default as DateDisplay } from './DateDisplay.svelte';
+export { default as DocumentViewer } from './DocumentViewer.svelte';
 export { default as Icon } from './Icon.svelte';
 export { default as StatusBadge } from './StatusBadge.svelte';
 export { registerIcons } from './icons.svelte.js';
+// Re-export types from types file
+export { createPdfJsOpener, } from './pdf-opener.js';
+export { PdfEngineUnavailableError } from './pdf-types.js';

package/dist/components/display/pdf-opener.d.ts

@@ -0,0 +1,44 @@
+import { MAX_CANVAS_PIXELS, renderScale } from './document-viewer-logic.js';
+import { type OpenPdf } from './pdf-types.js';
+export { MAX_CANVAS_PIXELS, renderScale };
+/** The slice of pdf.js this opener uses, so consumers need no pdf.js types. */
+export interface PdfJsLike {
+    GlobalWorkerOptions: {
+        workerSrc: string;
+    };
+    getDocument(source: {
+        data: Uint8Array;
+        enableXfa?: boolean;
+    }): {
+        promise: Promise<PdfJsDocumentLike>;
+        destroy(): Promise<void>;
+    };
+}
+interface PdfJsDocumentLike {
+    numPages: number;
+    getPage(page: number): Promise<{
+        getViewport(options: {
+            scale: number;
+        }): {
+            width: number;
+            height: number;
+        };
+        render(options: {
+            canvas: HTMLCanvasElement;
+            viewport: unknown;
+        }): {
+            promise: Promise<void>;
+            cancel(): void;
+        };
+    }>;
+}
+/** Options for `createPdfJsOpener`. */
+export interface PdfJsOpenerOptions {
+    /** URL of `pdf.worker.min.mjs`; omitted, the worker runs on the main thread. */
+    workerSrc?: string | URL;
+    /** Supplies pdf.js; defaults to a dynamic `import('pdfjs-dist/legacy/build/pdf.mjs')`. */
+    loadLibrary?: () => Promise<PdfJsLike>;
+}
+/** Build an `OpenPdf` backed by pdf.js; the library loads on first use. */
+export declare function createPdfJsOpener(options?: PdfJsOpenerOptions): OpenPdf;
+//# sourceMappingURL=pdf-opener.d.ts.map

package/dist/components/display/pdf-opener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-opener.d.ts","sourceRoot":"","sources":["../../../src/components/display/pdf-opener.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,mBAAmB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QAC9D,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,WAAW,CAAC,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,MAAM,CAAC,OAAO,EAAE;YAAE,MAAM,EAAE,iBAAiB,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,GAAG;YACjE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,MAAM,IAAI,IAAI,CAAC;SAChB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACzB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;CACxC;AAcD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAyF3E"}

package/dist/components/display/pdf-opener.js

@@ -0,0 +1,121 @@
+/**
+ * The default PDF opener for `DocumentViewer`, on pdf.js (smrt#3463).
+ *
+ * `pdfjs-dist` is an OPTIONAL peer dependency: this module is only loaded
+ * (dynamically, by the viewer) when a PDF is shown without an injected
+ * `openPdf`, and it imports pdf.js dynamically too. The legacy build is used
+ * because it supports the widest range of WebViews. pdf.js never fetches
+ * anything itself: the bytes come from the caller.
+ *
+ * The default imports use a variable specifier (`importOptional`), so a
+ * consumer's bundler never resolves them: an app WITHOUT pdfjs-dist still
+ * builds, and the missing engine surfaces at runtime. The cost is that pdf.js is
+ * not bundled by default. An app that wants it bundled passes `loadLibrary`
+ * (a function holding its own literal `import('pdfjs-dist/legacy/build/pdf.mjs')`)
+ * and `workerSrc`.
+ *
+ * Worker: pass `workerSrc` (for Vite,
+ * `import url from 'pdfjs-dist/legacy/build/pdf.worker.min.mjs?url'`) to render
+ * off the main thread. Without it the worker module is imported and run on the
+ * main thread (pdf.js's "fake worker"), which needs no bundler URL handling
+ * and works under svelte-package and any bundler, at the cost of a busier UI
+ * thread while a page draws.
+ */
+import { importOptional } from '../../utils/import-optional.js';
+import { MAX_CANVAS_PIXELS, renderScale } from './document-viewer-logic.js';
+import { PdfEngineUnavailableError } from './pdf-types.js';
+export { MAX_CANVAS_PIXELS, renderScale };
+async function importPdfJs() {
+    return importOptional('pdfjs-dist/legacy/build/pdf.mjs');
+}
+async function useMainThreadWorker() {
+    const target = globalThis;
+    if (target.pdfjsWorker)
+        return;
+    target.pdfjsWorker = await importOptional('pdfjs-dist/legacy/build/pdf.worker.min.mjs');
+}
+/** Build an `OpenPdf` backed by pdf.js; the library loads on first use. */
+export function createPdfJsOpener(options = {}) {
+    let library = null;
+    function load() {
+        library ??= (async () => {
+            try {
+                const lib = await (options.loadLibrary ?? importPdfJs)();
+                if (options.workerSrc !== undefined) {
+                    lib.GlobalWorkerOptions.workerSrc = String(options.workerSrc);
+                }
+                else if (!lib.GlobalWorkerOptions.workerSrc) {
+                    await useMainThreadWorker();
+                }
+                return lib;
+            }
+            catch (error) {
+                // pdf.js is an optional peer: not installed (or not loadable) means
+                // the viewer cannot show PDFs, not that this file is broken.
+                throw new PdfEngineUnavailableError(error instanceof Error ? error.message : undefined);
+            }
+        })();
+        // A failed load (pdf.js not installed) may be retried.
+        library.catch(() => {
+            library = null;
+        });
+        return library;
+    }
+    return async (bytes) => {
+        const lib = await load();
+        // pdf.js takes ownership of the buffer it is given; hand it a copy.
+        const loading = lib.getDocument({ data: bytes.slice(), enableXfa: false });
+        const document = await loading.promise;
+        // One page is drawn at a time: a newer request cancels the one drawing,
+        // and a request superseded while awaiting getPage never draws.
+        let drawing = null;
+        let generation = 0;
+        const stopDrawing = () => {
+            drawing?.cancel();
+            drawing = null;
+        };
+        return {
+            pages: document.numPages,
+            async renderPage(page, canvas, cssWidth) {
+                const ticket = ++generation;
+                stopDrawing();
+                const proxy = await document.getPage(page);
+                if (ticket !== generation)
+                    return { width: 0, height: 0 };
+                stopDrawing();
+                const base = proxy.getViewport({ scale: 1 });
+                const ratio = typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1;
+                const viewport = proxy.getViewport({
+                    scale: renderScale(base.width, base.height, Math.max(cssWidth, 1), ratio),
+                });
+                canvas.width = Math.floor(viewport.width);
+                canvas.height = Math.floor(viewport.height);
+                canvas.style.width = `${Math.round(cssWidth)}px`;
+                canvas.style.height = `${Math.round((cssWidth * base.height) / base.width)}px`;
+                const task = proxy.render({ canvas, viewport });
+                drawing = task;
+                try {
+                    await task.promise;
+                }
+                catch (error) {
+                    // Superseded by a newer page or zoom: that one draws instead.
+                    if (error?.name ===
+                        'RenderingCancelledException') {
+                        return { width: base.width, height: base.height };
+                    }
+                    throw error;
+                }
+                finally {
+                    if (drawing === task)
+                        drawing = null;
+                }
+                return { width: base.width, height: base.height };
+            },
+            async destroy() {
+                generation += 1;
+                drawing?.cancel();
+                await loading.destroy();
+            },
+        };
+    };
+}

package/dist/components/display/pdf-types.d.ts

@@ -0,0 +1,19 @@
+/** One opened PDF. Pages are numbered from 1. */
+export interface PdfDocument {
+    /** Page count. */
+    pages: number;
+    /** Draw a page onto `canvas`, `cssWidth` CSS pixels wide (sharp on a dense screen). */
+    renderPage(page: number, canvas: HTMLCanvasElement, cssWidth: number): Promise<{
+        width: number;
+        height: number;
+    }>;
+    /** Release the document and any worker. */
+    destroy(): Promise<void>;
+}
+/** Opens PDF bytes. Inject one to use a PDF engine other than pdf.js. */
+export type OpenPdf = (bytes: Uint8Array) => Promise<PdfDocument>;
+/** Thrown by an opener whose PDF engine is not installed; the viewer shows "unsupported". */
+export declare class PdfEngineUnavailableError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=pdf-types.d.ts.map

package/dist/components/display/pdf-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-types.d.ts","sourceRoot":"","sources":["../../../src/components/display/pdf-types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,2CAA2C;IAC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,yEAAyE;AACzE,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAElE,6FAA6F;AAC7F,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAAkD;CAItE"}

package/dist/components/display/pdf-types.js

@@ -0,0 +1,7 @@
+/** Thrown by an opener whose PDF engine is not installed; the viewer shows "unsupported". */
+export class PdfEngineUnavailableError extends Error {
+    constructor(message = 'The PDF engine (pdfjs-dist) is not available.') {
+        super(message);
+        this.name = 'PdfEngineUnavailableError';
+    }
+}

package/dist/components/display/types.d.ts

@@ -4,4 +4,23 @@
 export type StatusType = 'default' | 'invoice' | 'project' | 'expense' | 'time' | 'compliance' | 'estimate';
 /** Semantic tone for custom status vocabulary. */
 export type StatusTone = 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+/** Text overrides for `DocumentViewer`; defaults come from the `ui` i18n catalog. */
+export interface DocumentViewerLabels {
+    region: string;
+    pages: string;
+    zoom: string;
+    previousPage: string;
+    nextPage: string;
+    /** Template with `{page}` and `{pages}`. */
+    pageOf: string;
+    /** Template with `{label}` and `{page}`; names the PDF page canvas. */
+    pageLabel: string;
+    zoomOut: string;
+    zoomIn: string;
+    fit: string;
+    loading: string;
+    failed: string;
+    retry: string;
+    unsupported: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/components/display/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/display/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,YAAY,GACZ,UAAU,CAAC;AAEf,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/display/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,YAAY,GACZ,UAAU,CAAC;AAEf,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB"}