@laminapdf/viewer 0.0.0-stage → 0.2.0-alpha.2

package/dist/client.js

@@ -0,0 +1,236 @@
+// The page side of the document worker (C3a, ADR 0009 §3): a ViewerClient owns one worker for one
+// document, through `@laminapdf/sdk/worker`'s client (`request` with a priority and a coalescing
+// key). On top of it:
+//
+// - typed calls (`call(method, params)`, checked against `Methods`), and `open`/`render`/…;
+// - cancellation that rejects with an `AbortError` at once; a late answer's bitmap is closed by
+//   the worker client, so a cancelled render never paints;
+// - render timers on the page, started when the worker reports it began drawing (a render waiting
+//   in the queue isn't slow) and kept on the page because a worker stuck in a synchronous render
+//   can't post: `render-slow` after the soft timeout, and after the hard cap either a restart
+//   (`hard-timeout`) or, for an encrypted document, `render-stuck` and a restart only on `stop()`;
+// - restart after a crash (the worker's error, messageerror or a reported trap; never silence):
+//   pending calls reject with `worker-crashed`, a new worker reopens the document from the same
+//   source, but the call that was running is never re-sent (the UI offers Retry). An encrypted
+//   document isn't reopened: the password lived only in the dead worker, so `password-required`
+//   fires and the caller opens again with the password.
+import { isLaminaPdfError } from "@laminapdf/sdk";
+import { connect, Emitter, } from "@laminapdf/sdk/worker";
+import { PRIORITY, renderKey, } from "./protocol.js";
+/** Default render timeouts (ADR 0009 §3.7), in ms. */
+const DEFAULT_TIMEOUTS = Object.freeze({ soft: 10_000, hard: 120_000 });
+function workerFactory() {
+    return new Worker(new URL("./worker/entry.js", import.meta.url), { type: "module", name: "lamina-viewer" });
+}
+function abortError(e) {
+    return isLaminaPdfError(e, "cancelled") ? new DOMException("the call was cancelled", "AbortError") : e;
+}
+/** One document worker and the typed RPC to it. */
+export class ViewerClient {
+    #pdf;
+    #backend;
+    #timeouts;
+    #events = new Emitter();
+    /** What to reopen after a restart: the source and the options without the password. */
+    #reopen;
+    #document;
+    #recovering;
+    #nextRender = 1;
+    /** Renders waiting to start, by coalescing key: their timers start on `render-start`. */
+    #waiting = new Map();
+    /** The key the worker is drawing now: a render that joins it starts its timers at once. */
+    #drawing;
+    constructor(pdf, options) {
+        this.#pdf = pdf;
+        this.#backend = options.backend;
+        this.#timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
+        pdf.on("event", (name, data) => {
+            if (name === "warning")
+                this.#events.emit("warning", data);
+            else if (name === "render-start") {
+                const started = data;
+                this.#drawing = started.key;
+                for (const start of this.#waiting.get(started.key) ?? [])
+                    start();
+                this.#waiting.delete(started.key);
+                this.#events.emit("render-start", started);
+            }
+        });
+        pdf.on("crashed", (reason) => {
+            this.#events.emit("crashed", { reason });
+            this.#recover(reason).catch((error) => this.#events.emit("restart-failed", { reason: reason, error }));
+        });
+    }
+    /**
+     * Starts the document worker and loads the backend at once, so the WebAssembly downloads while
+     * the user picks a file.
+     */
+    static async create(options) {
+        const pdf = await connect({
+            worker: options.worker ?? workerFactory,
+            // A late answer to an aborted render: its bitmap is closed, never painted.
+            onDiscard: (value) => {
+                const bitmap = value?.bitmap;
+                if (bitmap instanceof ImageBitmap)
+                    bitmap.close();
+            },
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            ...(options.lamina === undefined ? {} : { init: options.lamina }),
+        });
+        const client = new ViewerClient(pdf, options);
+        try {
+            await pdf.request("initBackend", [options.backend], { priority: PRIORITY.document });
+        }
+        catch (e) {
+            // Nobody will hold this client: end its worker.
+            pdf.terminate();
+            throw e;
+        }
+        return client;
+    }
+    /** Listens for `event`; returns a function that stops listening. */
+    on(event, listener) {
+        return this.#events.on(event, listener);
+    }
+    /** A typed call: `method` and `params` are checked against `Methods`. */
+    async call(method, params, options = {}) {
+        if (this.#recovering !== undefined)
+            await this.#recovering.catch(() => { });
+        const { signal, priority, key } = options;
+        const level = method === "render" ? PRIORITY[priority ?? "visible"] : PRIORITY.document;
+        try {
+            return (await this.#pdf.request(method, params, {
+                priority: level,
+                ...(signal === undefined ? {} : { signal }),
+                ...(key === undefined ? {} : { key }),
+            }));
+        }
+        catch (e) {
+            throw abortError(e);
+        }
+    }
+    /**
+     * Opens `source` in the worker (Lamina PDF and the backend, from the same bytes). The password is
+     * sent once and kept only in the worker; a Blob is sent by reference, bytes are copied (and
+     * kept here, so a restarted worker can reopen them).
+     */
+    async open(source, options = {}, call = {}) {
+        const { password: _, ...rest } = options;
+        const opened = await this.call("openDocument", [source, options], call);
+        this.#reopen = { source, options: rest };
+        this.#document = opened;
+        return opened;
+    }
+    /** The open document, if any. */
+    get document() {
+        return this.#document;
+    }
+    /** Closes the document in the worker (the worker stays, ready for another `open`). */
+    async close() {
+        this.#reopen = undefined;
+        this.#document = undefined;
+        await this.call("closeDocument", []);
+    }
+    /** Page `index`'s size, rotation, ID and label. */
+    pageInfo(index, options) {
+        return this.call("pageInfo", [index], options);
+    }
+    /**
+     * Renders `request` as an ImageBitmap (close it when done). Identical requests in flight are
+     * drawn once. An aborted render rejects with `AbortError` and never paints.
+     */
+    async render(request, options = {}) {
+        const id = this.#nextRender++;
+        // A restarted worker numbers its documents again: read the ID once it serves.
+        if (this.#recovering !== undefined)
+            await this.#recovering.catch(() => { });
+        // 0 names no document: the worker answers `disposed`.
+        const documentId = this.#document?.id ?? 0;
+        const needsPassword = this.#document?.needsPassword === true;
+        const key = renderKey(request, documentId);
+        let soft;
+        let hard;
+        const start = () => {
+            soft = setTimeout(() => this.#events.emit("render-slow", { id, page: request.page }), this.#timeouts.soft);
+            hard = setTimeout(() => {
+                if (needsPassword)
+                    this.#events.emit("render-stuck", { id, page: request.page, needsPassword: true });
+                else
+                    this.stop("hard-timeout").catch((error) => this.#events.emit("restart-failed", { reason: "hard-timeout", error }));
+            }, this.#timeouts.hard);
+        };
+        let waiting = this.#waiting.get(key);
+        if (waiting === undefined) {
+            waiting = new Set();
+            this.#waiting.set(key, waiting);
+        }
+        // Joining a render already being drawn: its render-start has passed.
+        if (this.#drawing === key)
+            start();
+        else
+            waiting.add(start);
+        try {
+            return await this.call("render", [request, documentId], { ...options, key });
+        }
+        finally {
+            const set = this.#waiting.get(key);
+            set?.delete(start);
+            if (set?.size === 0)
+                this.#waiting.delete(key);
+            if (this.#drawing === key)
+                this.#drawing = undefined;
+            clearTimeout(soft);
+            clearTimeout(hard);
+        }
+    }
+    /**
+     * Stops whatever the worker is doing by terminating it (the user's Stop, or the hard cap), then
+     * restarts it as after a crash: pending calls reject, the running one isn't re-sent, and an
+     * encrypted document asks for its password again.
+     */
+    stop(reason = "cancelled") {
+        // A restart already under way serves: a second would end the worker it is starting.
+        if (this.#recovering !== undefined)
+            return this.#recovering;
+        this.#pdf.terminate();
+        return this.#recover(reason);
+    }
+    /** Ends the worker for good. */
+    terminate() {
+        this.#reopen = undefined;
+        this.#document = undefined;
+        this.#pdf.terminate();
+    }
+    #recover(reason) {
+        if (this.#recovering !== undefined)
+            return this.#recovering;
+        const recovering = (async () => {
+            await this.#pdf.restart();
+            await this.#pdf.request("initBackend", [this.#backend], { priority: PRIORITY.document });
+            let reopened = false;
+            const reopen = this.#reopen;
+            if (reopen !== undefined) {
+                if (this.#document?.needsPassword === true) {
+                    // The password died with the worker; it is never kept on the page.
+                    this.#reopen = undefined;
+                    this.#document = undefined;
+                    this.#events.emit("password-required", {});
+                }
+                else {
+                    this.#document = (await this.#pdf.request("openDocument", [reopen.source, reopen.options], {
+                        priority: PRIORITY.document,
+                    }));
+                    reopened = true;
+                }
+            }
+            this.#events.emit("restarted", { reason, reopened });
+        })();
+        const tracked = recovering.finally(() => {
+            if (this.#recovering === tracked)
+                this.#recovering = undefined;
+        });
+        this.#recovering = tracked;
+        return tracked;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { CanvasPoolOptions } from "./canvas/pool.js";
+export type { RestartReason, ViewerCallOptions, ViewerEvent, ViewerEvents, ViewerOptions } from "./client.js";
+export { ViewerClient } from "./client.js";
+export type { Rotation } from "./layout/page-layout.js";
+export type { BackendInit, BackendName, MethodName, Methods, OpenedDocument, Params, Priority, RenderedBitmap, Result, SourceInit, ViewerOpenOptions, } from "./protocol.js";
+export type { CreateViewerOptions, PageLayer, PageRenderState, RenderStats, ViewerEventMap, ViewState, } from "./view/viewer.js";
+export { createViewer, Viewer } from "./view/viewer.js";
+export type { DocumentPoint, Point, Zoom, ZoomMode } from "./zoom/zoom.js";
+export { MAX_ZOOM, MIN_ZOOM } from "./zoom/zoom.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,cAAc,EACd,MAAM,EACN,QAAQ,EACR,cAAc,EACd,MAAM,EACN,UAAU,EACV,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// `@laminapdf/viewer` (ADR 0009): the web reader's viewer core: the document worker and its typed
+// RPC (ViewerClient), and the viewer over them (createViewer). The parts inside (the layout, the
+// canvas pool, the bitmap cache, the tile and zoom maths) are not exported: the README describes
+// them, and their unit tests import them by path within the package.
+export { ViewerClient } from "./client.js";
+export { createViewer, Viewer } from "./view/viewer.js";
+export { MAX_ZOOM, MIN_ZOOM } from "./zoom/zoom.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AACjG,iGAAiG;AACjG,qEAAqE;AAIrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuB3C,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/layout/page-layout.d.ts

@@ -0,0 +1,58 @@
+import { type ViewRotation } from "@laminapdf/render";
+/** A page's displayed size in points. */
+export interface PageSize {
+    readonly width: number;
+    readonly height: number;
+}
+/** View rotation, clockwise, on top of the page's own `/Rotate`: the render backends' own type. */
+export type Rotation = ViewRotation;
+/** CSS pixels per point at 100 % ("actual size"): 96 CSS px per inch, 72 pt per inch. */
+export declare const CSS_PX_PER_PT: number;
+/** `size` as displayed after a view rotation: width and height swap at 90° and 270°. */
+export declare function rotated(size: PageSize, rotation: Rotation): PageSize;
+/** Whether `value` is a view rotation (0, 90, 180 or 270). */
+export declare function isRotation(value: number): value is Rotation;
+/** How to lay pages out: the zoom as CSS px per point, the view rotation and the gap. */
+export interface LayoutOptions {
+    /** CSS pixels per point (100 % is {@link CSS_PX_PER_PT}). */
+    readonly scale: number;
+    readonly rotation?: Rotation;
+    /** CSS pixels between pages, and above the first and below the last. */
+    readonly gap?: number;
+}
+/** Page geometry in CSS pixels for one zoom and rotation. */
+export declare class PageLayout {
+    readonly scale: number;
+    readonly rotation: Rotation;
+    readonly gap: number;
+    /** Each page's box width and height in CSS px. */
+    readonly widths: Float64Array;
+    readonly heights: Float64Array;
+    /** `tops[i]` is page i's top edge; `tops[n]` is the bottom of the last gap (the content height). */
+    readonly tops: Float64Array;
+    readonly maxWidth: number;
+    /** Elementary steps the last build and searches took (tests assert the cost by count, not time). */
+    operations: number;
+    constructor(sizes: readonly PageSize[], options: LayoutOptions);
+    /** How many pages the layout holds. */
+    get pageCount(): number;
+    /** The content height in CSS px (every page and gap). */
+    get height(): number;
+    /** Page `index`'s top edge in CSS px. */
+    offsetOf(index: number): number;
+    /**
+     * The page at content offset `y`: the last page whose top is at or above `y` (a gap belongs to
+     * the page above it), clamped to the first and last page. -1 for an empty document.
+     */
+    pageAt(y: number): number;
+    /** The pages any part of which lies in `[top, bottom)`, as an inclusive range. */
+    rangeIn(top: number, bottom: number): {
+        readonly first: number;
+        readonly last: number;
+    };
+    /** Page `index`'s left edge in CSS px when pages are centred in a viewport `viewportWidth` wide. */
+    leftOf(index: number, viewportWidth: number): number;
+    /** The content width in CSS px for a viewport `viewportWidth` wide. */
+    contentWidth(viewportWidth: number): number;
+}
+//# sourceMappingURL=page-layout.d.ts.map

package/dist/layout/page-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout.d.ts","sourceRoot":"","sources":["../../src/layout/page-layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,mGAAmG;AACnG,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC,yFAAyF;AACzF,eAAO,MAAM,aAAa,QAAU,CAAC;AAErC,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAEpE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6DAA6D;AAC7D,qBAAa,UAAU;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,UAAU,SAAK;IAEf,YAAY,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,EAAE,aAAa,EAyB7D;IAED,uCAAuC;IACvC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,yDAAyD;IACzD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9B;IAED;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAYxB;IAED,kFAAkF;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAMtF;IAED,oGAAoG;IACpG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnD;IAED,uEAAuE;IACvE,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE1C;CACF"}

package/dist/layout/page-layout.js

@@ -0,0 +1,110 @@
+// The viewer's page layout: one continuous column of pages, each sized from its displayed
+// size in points (ADR 0027: `/Rotate` applied) times the zoom, turned by the view rotation, with a
+// gap between pages. Offsets are prefix sums, so finding the page at a scroll position is a binary
+// search and a zoom or rotation change costs one O(n) pass. No DOM: the view reads it.
+import { isQuarterTurn } from "@laminapdf/render";
+/** CSS pixels per point at 100 % ("actual size"): 96 CSS px per inch, 72 pt per inch. */
+export const CSS_PX_PER_PT = 96 / 72;
+/** `size` as displayed after a view rotation: width and height swap at 90° and 270°. */
+export function rotated(size, rotation) {
+    return isQuarterTurn(rotation) ? { width: size.height, height: size.width } : size;
+}
+/** Whether `value` is a view rotation (0, 90, 180 or 270). */
+export function isRotation(value) {
+    return value === 0 || value === 90 || value === 180 || value === 270;
+}
+/** Page geometry in CSS pixels for one zoom and rotation. */
+export class PageLayout {
+    scale;
+    rotation;
+    gap;
+    /** Each page's box width and height in CSS px. */
+    widths;
+    heights;
+    /** `tops[i]` is page i's top edge; `tops[n]` is the bottom of the last gap (the content height). */
+    tops;
+    maxWidth;
+    /** Elementary steps the last build and searches took (tests assert the cost by count, not time). */
+    operations = 0;
+    constructor(sizes, options) {
+        const { scale, rotation = 0, gap = 16 } = options;
+        if (!(scale > 0) || !Number.isFinite(scale))
+            throw new RangeError(`scale must be positive, got ${scale}`);
+        this.scale = scale;
+        this.rotation = rotation;
+        this.gap = gap;
+        const n = sizes.length;
+        this.widths = new Float64Array(n);
+        this.heights = new Float64Array(n);
+        this.tops = new Float64Array(n + 1);
+        let y = gap;
+        let max = 0;
+        for (let i = 0; i < n; i++) {
+            const shown = rotated(sizes[i], rotation);
+            const w = shown.width * scale;
+            const h = shown.height * scale;
+            this.widths[i] = w;
+            this.heights[i] = h;
+            this.tops[i] = y;
+            y += h + gap;
+            if (w > max)
+                max = w;
+            this.operations++;
+        }
+        this.tops[n] = y;
+        this.maxWidth = max;
+    }
+    /** How many pages the layout holds. */
+    get pageCount() {
+        return this.widths.length;
+    }
+    /** The content height in CSS px (every page and gap). */
+    get height() {
+        return this.tops[this.pageCount] ?? 0;
+    }
+    /** Page `index`'s top edge in CSS px. */
+    offsetOf(index) {
+        if (!Number.isInteger(index) || index < 0 || index >= this.pageCount) {
+            throw new RangeError(`page ${index} is outside 0..${this.pageCount - 1}`);
+        }
+        return this.tops[index];
+    }
+    /**
+     * The page at content offset `y`: the last page whose top is at or above `y` (a gap belongs to
+     * the page above it), clamped to the first and last page. -1 for an empty document.
+     */
+    pageAt(y) {
+        const n = this.pageCount;
+        if (n === 0)
+            return -1;
+        let lo = 0;
+        let hi = n - 1;
+        while (lo < hi) {
+            this.operations++;
+            const mid = (lo + hi + 1) >> 1;
+            if (this.tops[mid] <= y)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return lo;
+    }
+    /** The pages any part of which lies in `[top, bottom)`, as an inclusive range. */
+    rangeIn(top, bottom) {
+        const first = this.pageAt(top);
+        let last = this.pageAt(Math.max(top, bottom - 1e-6));
+        // `pageAt` puts a gap with the page above; a range that ends in a gap ends at that page.
+        if (last < first)
+            last = first;
+        return { first, last };
+    }
+    /** Page `index`'s left edge in CSS px when pages are centred in a viewport `viewportWidth` wide. */
+    leftOf(index, viewportWidth) {
+        return (this.contentWidth(viewportWidth) - this.widths[index]) / 2;
+    }
+    /** The content width in CSS px for a viewport `viewportWidth` wide. */
+    contentWidth(viewportWidth) {
+        return Math.max(viewportWidth, this.maxWidth + 2 * this.gap);
+    }
+}
+//# sourceMappingURL=page-layout.js.map

package/dist/layout/page-layout.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,95 @@
+import { type CloneableWasmSource, type RenderLimits, type RenderRequest } from "@laminapdf/render";
+import type { Limits, PageInfo } from "@laminapdf/sdk";
+/** Which engine draws the pages (ADR 0004: PDFium by default, hayro the CI oracle). */
+export type BackendName = "pdfium" | "hayro";
+/** What the worker loads a backend from. */
+export interface BackendInit {
+    readonly backend: BackendName;
+    /** The engine's `.wasm`: required for PDFium (its URL from your bundler); hayro finds its own. */
+    readonly wasm?: CloneableWasmSource;
+}
+/** What a document is opened from: sent to the worker, which reads it there. */
+export type SourceInit = Blob | ArrayBuffer | Uint8Array;
+/** `open`'s options. The password crosses to the worker once and is kept only there. */
+export interface ViewerOpenOptions {
+    readonly password?: string;
+    /** Lamina PDF's reading limits (ADR 0003). */
+    readonly limits?: Partial<Limits>;
+    /** The backend's render limits (ADR 0004). */
+    readonly renderLimits?: Partial<RenderLimits>;
+}
+/** An open document, as layout needs it up front. */
+export interface OpenedDocument {
+    /** Which open of this worker it is: renders name it, so one queued for a replaced document fails. */
+    readonly id: number;
+    readonly pageCount: number;
+    /** Every page's displayed size in points (`/Rotate` applied), rotation, ID and label. */
+    readonly pages: readonly PageInfo[];
+    /** Whether the file can't be opened without its password, so a restarted worker must ask again. */
+    readonly needsPassword: boolean;
+    readonly backend: {
+        readonly name: BackendName;
+        readonly version: string;
+    };
+}
+/** A rendered tile on the page: an ImageBitmap transferred from the worker. Close it when done. */
+export interface RenderedBitmap {
+    readonly bitmap: ImageBitmap;
+    readonly width: number;
+    readonly height: number;
+}
+/** The viewer's methods: params and result per method. `client.call` is typed by it. */
+export interface Methods {
+    initBackend: {
+        params: [BackendInit];
+        result: {
+            name: BackendName;
+            version: string;
+        };
+    };
+    openDocument: {
+        params: [source: SourceInit, options: ViewerOpenOptions];
+        result: OpenedDocument;
+    };
+    closeDocument: {
+        params: [];
+        result: undefined;
+    };
+    pageInfo: {
+        params: [index: number];
+        result: PageInfo;
+    };
+    render: {
+        params: [request: RenderRequest, document: number];
+        result: RenderedBitmap;
+    };
+}
+/** A viewer method's name. */
+export type MethodName = keyof Methods;
+/** Method `M`'s parameters. */
+export type Params<M extends MethodName> = Methods[M]["params"];
+/** Method `M`'s result. */
+export type Result<M extends MethodName> = Methods[M]["result"];
+/**
+ * Who is waiting (ADR 0009 §3.3): `visible` tiles first, then `prefetch` (just off screen), then
+ * `background` (thumbnails, search, text). Document calls run above all three.
+ */
+export type Priority = "visible" | "prefetch" | "background";
+/** The worker queue's numbers for each priority (higher first). */
+export declare const PRIORITY: {
+    readonly [P in Priority | "document"]: number;
+};
+/** The fields of a render key that say which pixels it holds (see {@link renderKey}). */
+export interface RenderKeyFields {
+    readonly scale: number;
+    readonly rotation: number;
+}
+/** Reads back the scale and rotation from a {@link renderKey}. */
+export declare function renderKeyFields(key: string): RenderKeyFields;
+/**
+ * The coalescing key of a render on document `id`: the document and the whole normalised
+ * RenderRequest (page, scale, clip, rotation, flags and background), so two requests share a run
+ * only when their pixels are the same (ADR 0009 §3.3).
+ */
+export declare function renderKey(request: RenderRequest, id: number): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,36 @@
+// The viewer's methods on the document worker (C3a, ADR 0009 §3). They extend `@laminapdf/sdk/worker`
+// (L2a): one protocol, one queue and one cancellation path for both, with the viewer's methods
+// added through `serve({ methods })` in the worker and `client.request` on the page. This module
+// holds what both sides agree on: the method map (params and results), the priorities and the
+// coalescing key.
+import { flagsOf } from "@laminapdf/render";
+/** The worker queue's numbers for each priority (higher first). */
+export const PRIORITY = Object.freeze({
+    document: 4,
+    visible: 3,
+    prefetch: 2,
+    background: 1,
+});
+/** Reads back the scale and rotation from a {@link renderKey}. */
+export function renderKeyFields(key) {
+    const fields = JSON.parse(key);
+    return { scale: fields[2], rotation: fields[4] };
+}
+/**
+ * The coalescing key of a render on document `id`: the document and the whole normalised
+ * RenderRequest (page, scale, clip, rotation, flags and background), so two requests share a run
+ * only when their pixels are the same (ADR 0009 §3.3).
+ */
+export function renderKey(request, id) {
+    const { page, scale, clip, rotation = 0, flags, background } = request;
+    return JSON.stringify([
+        id,
+        page,
+        scale,
+        clip === undefined ? null : [clip.x, clip.y, clip.width, clip.height],
+        rotation,
+        flagsOf(flags),
+        background === undefined ? "white" : background,
+    ]);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,+FAA+F;AAC/F,iGAAiG;AACjG,8FAA8F;AAC9F,kBAAkB;AAElB,OAAO,EAA4B,OAAO,EAAyC,MAAM,mBAAmB,CAAC;AAkE7G,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAsD,MAAM,CAAC,MAAM,CAAC;IACvF,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;CACd,CAAC,CAAC;AAQH,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAW,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,OAAsB,EAAE,EAAU;IAC1D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE;QACF,IAAI;QACJ,KAAK;QACL,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QACrE,QAAQ;QACR,OAAO,CAAC,KAAK,CAAC;QACd,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/render/tiles.d.ts

@@ -0,0 +1,17 @@
+import type { PixelRect } from "@laminapdf/render";
+/** The render scale (output px per pt) of the low-resolution pass for a page `widthPt` wide. */
+export declare function lowScale(sharpScale: number, widthPt: number): number;
+/**
+ * The tiles (device px, in the page's pixel space at the sharp scale) covering `visible`, the
+ * part of the page in view in CSS px (x, y from the page's top-left), clamped to the page.
+ */
+export declare function tilesFor(visible: {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}, pageCss: {
+    readonly width: number;
+    readonly height: number;
+}, dpr: number): PixelRect[];
+//# sourceMappingURL=tiles.d.ts.map

package/dist/render/tiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/render/tiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnD,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACpG,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,MAAM,GACV,SAAS,EAAE,CAeb"}