@laminapdf/viewer 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/render/tiles.js

@@ -2,26 +2,78 @@
 const TILE_CSS = 512;
 /** The low-resolution pass: at most this many device px wide, and at most half the sharp scale. */
 const LOW_MAX_WIDTH = 256;
+/**
+ * The most device pixels a page's backdrop canvas holds: well below Safari's 16.7 MP per canvas,
+ * and small enough that the mounted pages share the pool. A page larger than this at the full
+ * pixel ratio keeps its backdrop at a lower one and gets a detail canvas over the part in view.
+ */
+export const BACKDROP_MAX_PIXELS = 8 * 1024 * 1024;
+/**
+ * Device px per CSS px of the backdrop of a page `css` CSS px in size: `dpr`, or less so that the
+ * whole page fits `maxPixels` ({@link BACKDROP_MAX_PIXELS} by default; less on touch devices).
+ */
+export function backdropRatio(dpr, css, maxPixels = BACKDROP_MAX_PIXELS) {
+    const pixels = css.width * dpr * css.height * dpr;
+    return pixels <= maxPixels ? dpr : dpr * Math.sqrt(maxPixels / pixels);
+}
+/** The smallest rectangle covering every one of `rects`; undefined when there are none. */
+export function bounds(rects) {
+    const [first] = rects;
+    if (first === undefined)
+        return undefined;
+    let [x0, y0, x1, y1] = [first.x, first.y, first.x + first.width, first.y + first.height];
+    for (const r of rects) {
+        x0 = Math.min(x0, r.x);
+        y0 = Math.min(y0, r.y);
+        x1 = Math.max(x1, r.x + r.width);
+        y1 = Math.max(y1, r.y + r.height);
+    }
+    return { x: x0, y: y0, width: x1 - x0, height: y1 - y0 };
+}
+/** Whether `outer` contains all of `inner`. */
+export function contains(outer, inner) {
+    return (inner.x >= outer.x &&
+        inner.y >= outer.y &&
+        inner.x + inner.width <= outer.x + outer.width &&
+        inner.y + inner.height <= outer.y + outer.height);
+}
 /** The render scale (output px per pt) of the low-resolution pass for a page `widthPt` wide. */
 export function lowScale(sharpScale, widthPt) {
     return Math.min(sharpScale * 0.5, LOW_MAX_WIDTH / Math.max(1, widthPt));
 }
+/**
+ * The sharp scale (device px per pt) of a page `css` CSS px in size at layout scale `layoutScale`:
+ * `layoutScale × dpr`, unless the canvas pool could only `fit` fewer pixels than `wanted`, the page
+ * in whole pixels at that scale (`pagePixels`); then lowered to what fits. The canvas is then
+ * `pagePixels` at this scale, which never exceeds `fitted` on either side.
+ *
+ * `wanted` is in whole pixels, as the pool fits them: comparing `fitted` with the fractional CSS
+ * size instead takes the pool's rounding (79.33 px to 79) for a cap, which lowers the scale a
+ * hair below the full one and sends every page asking for a detail canvas it doesn't need.
+ */
+export function sharpScale(layoutScale, dpr, css, fitted, wanted) {
+    if (fitted.width >= wanted.width && fitted.height >= wanted.height)
+        return layoutScale * dpr;
+    return layoutScale * Math.min(dpr, fitted.width / css.width, fitted.height / css.height);
+}
 /**
  * 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.
+ * part of the page in view in CSS px (x, y from the page's top-left), clamped to `page`: the
+ * whole page in device px, as the renderer sizes it (`pagePixels` of `@laminapdf/render`), so no
+ * tile reaches past it. `ratio` is device px per CSS px.
  */
-export function tilesFor(visible, pageCss, dpr) {
-    const pageW = Math.max(1, Math.floor(pageCss.width * dpr));
-    const pageH = Math.max(1, Math.floor(pageCss.height * dpr));
-    const side = Math.max(1, Math.round(TILE_CSS * dpr));
-    const x0 = Math.max(0, Math.floor((visible.x * dpr) / side) * side);
-    const y0 = Math.max(0, Math.floor((visible.y * dpr) / side) * side);
-    const x1 = Math.min(pageW, Math.ceil(((visible.x + visible.width) * dpr) / side) * side);
-    const y1 = Math.min(pageH, Math.ceil(((visible.y + visible.height) * dpr) / side) * side);
+export function tilesFor(visible, page, ratio) {
+    if (visible.width <= 0 || visible.height <= 0)
+        return [];
+    const side = Math.max(1, Math.round(TILE_CSS * ratio));
+    const x0 = Math.max(0, Math.floor((visible.x * ratio) / side) * side);
+    const y0 = Math.max(0, Math.floor((visible.y * ratio) / side) * side);
+    const x1 = Math.min(page.width, Math.ceil(((visible.x + visible.width) * ratio) / side) * side);
+    const y1 = Math.min(page.height, Math.ceil(((visible.y + visible.height) * ratio) / side) * side);
     const tiles = [];
     for (let y = y0; y < y1; y += side) {
         for (let x = x0; x < x1; x += side) {
-            tiles.push({ x, y, width: Math.min(side, pageW - x), height: Math.min(side, pageH - y) });
+            tiles.push({ x, y, width: Math.min(side, page.width - x), height: Math.min(side, page.height - y) });
         }
     }
     return tiles;

package/dist/render/tiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"tiles.js","sourceRoot":"","sources":["../../src/render/tiles.ts"],"names":[],"mappings":"AAKA,+EAA+E;AAC/E,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,mGAAmG;AACnG,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,gGAAgG;AAChG,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,OAAe;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAoG,EACpG,OAA4D,EAC5D,GAAW;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"tiles.js","sourceRoot":"","sources":["../../src/render/tiles.ts"],"names":[],"mappings":"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"}

package/dist/source/http-range.d.ts

@@ -0,0 +1,59 @@
+import type { ByteRange, RenderSource } from "@laminapdf/render";
+import { type RangeSource } from "@laminapdf/sdk";
+/** Options for {@link HttpRangeByteSource.open}. */
+export interface HttpRangeByteSourceOptions {
+    /** Requests are aligned to blocks of this many bytes (default 65 536). */
+    readonly blockSize?: number;
+    /** Whole blocks fetched after each range asked for (default 1). */
+    readonly readahead?: number;
+    /** The most bytes the cache keeps; the least recently used blocks go first (default 64 MiB). */
+    readonly cacheBytes?: number;
+    /**
+     * The largest file downloaded whole when the server ignores `Range` (default 256 MiB); above
+     * it the open fails with `source-budget-exceeded`.
+     */
+    readonly maxWholeBytes?: number;
+    /** Skip the browser's HTTP cache (default true). */
+    readonly noStore?: boolean;
+    /** Called after each fetch with the bytes received so far and the file's size. */
+    readonly onProgress?: (progress: {
+        readonly loaded: number;
+        readonly total: number;
+    }) => void;
+    /** Aborts the probe. */
+    readonly signal?: AbortSignal;
+    /** The `fetch` to use (default: the global one). */
+    readonly fetch?: typeof fetch;
+}
+/** A remote file as a `RangeSource` (for Lamina PDF) and a `RenderSource` (for the render backend). */
+export declare class HttpRangeByteSource implements RangeSource, RenderSource {
+    #private;
+    readonly size: number;
+    readonly blockSize: number;
+    private constructor();
+    /**
+     * Probes `url` (its last 64 KiB: the size, and the part a reader reads first) and returns the
+     * source. A server that ignores `Range` sends the whole file, which is kept.
+     *
+     * @throws LaminaPdfError `fetch-failed` (`data.reason` `network` covers a refused CORS check,
+     *   which the browser doesn't tell apart from being offline), `source-changed`,
+     *   `source-budget-exceeded`, or the signal's reason.
+     */
+    static open(url: string, options?: HttpRangeByteSourceOptions): Promise<HttpRangeByteSource>;
+    /** The whole file, when the server sent it whole (then every read is answered from it). */
+    get whole(): Uint8Array | undefined;
+    /** Bytes received from the network so far (the probe's included), re-fetches of evicted blocks too. */
+    get loaded(): number;
+    /** The `length` bytes at `offset` if every block is cached, else undefined (`RenderSource`). */
+    readSync(offset: number, length: number): Uint8Array | undefined;
+    /**
+     * Fetches the blocks `ranges` touch (and the readahead after each) that aren't cached: the
+     * ranges of a render backend's `data-pending`.
+     */
+    fill(ranges: readonly ByteRange[], signal?: AbortSignal): Promise<void>;
+    /** `RangeSource.read`: fills, then reads from the cache. */
+    read(offset: number, length: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+}
+//# sourceMappingURL=http-range.d.ts.map

package/dist/source/http-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-range.d.ts","sourceRoot":"","sources":["../../src/source/http-range.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIrG,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9F,wBAAwB;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAqED,uGAAuG;AACvG,qBAAa,mBAAoB,YAAW,WAAW,EAAE,YAAY;;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAc3B,OAAO,eAON;IAED;;;;;;;OAOG;IACH,OAAa,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+BrG;IAED,2FAA2F;IAC3F,IAAI,KAAK,IAAI,UAAU,GAAG,SAAS,CAElC;IAED,uGAAuG;IACvG,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAuB/D;IAED;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB5E;IAeD,4DAA4D;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAO3G;CA0DF"}

package/dist/source/http-range.js

@@ -0,0 +1,284 @@
+// A remote PDF read in the document worker with HTTP Range requests: `@laminapdf/sdk`'s
+// httpRangeSource (tail-first probe, If-Range and ETag checks, the 200 fallback) with what a
+// reader needs on top:
+//
+// - privacy: every request omits credentials and the referrer (ADR 0011 §3), and by default skips
+//   the HTTP cache, so the file is not kept on disk after the tab closes;
+// - a block cache that the render backend reads synchronously (`readSync`, `RenderSource`): PDFium
+//   asks for bytes while it draws, and a miss makes the render throw `data-pending`, after which
+//   the worker fills the ranges asked for and draws again;
+// - readahead, a byte budget (least recently used blocks go first) and progress;
+// - a cap on the whole download a server without range support makes, until large files can be
+//   streamed to OPFS.
+import { httpRangeSource, isLaminaPdfError, LaminaPdfError } from "@laminapdf/sdk";
+// Only docsUrl: the package has no side effects, so the explain pages stay out of the worker.
+import { docsUrl } from "@laminapdf/sdk/explain";
+const DEFAULTS = { blockSize: 65_536, readahead: 1, cacheBytes: 64 * 1024 * 1024, maxWholeBytes: 256 * 1024 * 1024 };
+/**
+ * The fetch every request of the source goes through: no cookies or credentials, no referrer, no
+ * HTTP cache unless asked, CORS mode. Each answer's body is counted as it arrives (the source's
+ * progress), and a full answer is cut off past `maxWholeBytes`, whether it says its length or not
+ * (chunked, or compressed so that its length isn't the file's).
+ */
+function privateFetch(base, noStore, maxWholeBytes, hooks) {
+    return async (input, init) => {
+        const response = await base(input, {
+            ...init,
+            credentials: "omit",
+            referrerPolicy: "no-referrer",
+            mode: "cors",
+            ...(noStore ? { cache: "no-store" } : {}),
+        });
+        const whole = response.status === 200;
+        if (whole) {
+            const length = Number(response.headers.get("Content-Length") ?? Number.NaN);
+            if (Number.isFinite(length) && length > maxWholeBytes) {
+                await response.body?.cancel();
+                throw tooLarge(length, maxWholeBytes);
+            }
+            hooks.whole();
+        }
+        if (response.body === null)
+            return response;
+        let total = 0;
+        const counted = response.body.pipeThrough(new TransformStream({
+            transform(chunk, controller) {
+                total += chunk.length;
+                if (whole && total > maxWholeBytes) {
+                    controller.error(tooLarge(total, maxWholeBytes));
+                    return;
+                }
+                hooks.received(chunk.length);
+                controller.enqueue(chunk);
+            },
+        }));
+        const { status, statusText, headers } = response;
+        return new Response(counted, { status, statusText, headers });
+    };
+}
+function tooLarge(size, budget) {
+    return new LaminaPdfError({
+        code: "source-budget-exceeded",
+        kind: "limit",
+        message: "the server doesn't send parts of the file, and the whole file is larger than the reader downloads",
+        data: { reason: "whole-download", size, budget },
+        docsUrl: docsUrl("source-budget-exceeded"),
+    });
+}
+/** httpRangeSource reports a throwing fetch as `fetch-failed`; the cap's own error is its cause. */
+function unwrapCap(e) {
+    return isLaminaPdfError(e, "fetch-failed") && isLaminaPdfError(e.cause, "source-budget-exceeded") ? e.cause : e;
+}
+/** A remote file as a `RangeSource` (for Lamina PDF) and a `RenderSource` (for the render backend). */
+export class HttpRangeByteSource {
+    size;
+    blockSize;
+    #inner;
+    #readahead;
+    #cacheBytes;
+    #onProgress;
+    /** Cached blocks by index, least recently used first (a Map keeps insertion order). */
+    #blocks = new Map();
+    #cached = 0;
+    /** Blocks being fetched, so two fills never fetch one block twice. */
+    #inFlight = new Map();
+    /** The whole file, when the server sent it whole. */
+    #whole;
+    #loaded = 0;
+    constructor(inner, options) {
+        this.#inner = inner;
+        this.size = inner.size;
+        this.blockSize = Math.max(1, Math.floor(options.blockSize ?? DEFAULTS.blockSize));
+        this.#readahead = Math.max(0, Math.floor(options.readahead ?? DEFAULTS.readahead));
+        this.#cacheBytes = options.cacheBytes ?? DEFAULTS.cacheBytes;
+        this.#onProgress = options.onProgress;
+    }
+    /**
+     * Probes `url` (its last 64 KiB: the size, and the part a reader reads first) and returns the
+     * source. A server that ignores `Range` sends the whole file, which is kept.
+     *
+     * @throws LaminaPdfError `fetch-failed` (`data.reason` `network` covers a refused CORS check,
+     *   which the browser doesn't tell apart from being offline), `source-changed`,
+     *   `source-budget-exceeded`, or the signal's reason.
+     */
+    static async open(url, options = {}) {
+        let whole = false;
+        let received = 0;
+        let source;
+        const fetcher = privateFetch(options.fetch ?? fetch, options.noStore ?? true, options.maxWholeBytes ?? DEFAULTS.maxWholeBytes, {
+            received: (bytes) => {
+                received += bytes;
+                if (source !== undefined)
+                    source.#loaded = received;
+            },
+            whole: () => {
+                whole = true;
+            },
+        });
+        const inner = await httpRangeSource(url, {
+            fetch: fetcher,
+            blockSize: options.blockSize ?? DEFAULTS.blockSize,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        }).catch((e) => {
+            throw unwrapCap(e);
+        });
+        source = new HttpRangeByteSource(inner, options);
+        source.#loaded = received;
+        // The probe's answer was the file: httpRangeSource holds it, and this reads it back once.
+        if (whole)
+            source.#whole = await inner.read(0, inner.size);
+        source.#progress();
+        return source;
+    }
+    /** The whole file, when the server sent it whole (then every read is answered from it). */
+    get whole() {
+        return this.#whole;
+    }
+    /** Bytes received from the network so far (the probe's included), re-fetches of evicted blocks too. */
+    get loaded() {
+        return this.#loaded;
+    }
+    /** The `length` bytes at `offset` if every block is cached, else undefined (`RenderSource`). */
+    readSync(offset, length) {
+        const end = Math.min(this.size, offset + length);
+        if (offset < 0 || end < offset)
+            return undefined;
+        if (this.#whole !== undefined)
+            return this.#whole.subarray(offset, end);
+        const first = Math.floor(offset / this.blockSize);
+        const last = Math.floor((end - 1) / this.blockSize);
+        if (end === offset)
+            return new Uint8Array();
+        if (first === last) {
+            const block = this.#touch(first);
+            if (block === undefined)
+                return undefined;
+            const at = first * this.blockSize;
+            return block.subarray(offset - at, end - at);
+        }
+        const out = new Uint8Array(end - offset);
+        for (let index = first; index <= last; index++) {
+            const block = this.#touch(index);
+            if (block === undefined)
+                return undefined;
+            const at = index * this.blockSize;
+            const from = Math.max(offset, at) - at;
+            const to = Math.min(end, at + block.length) - at;
+            out.set(block.subarray(from, to), at + from - offset);
+        }
+        return out;
+    }
+    /**
+     * Fetches the blocks `ranges` touch (and the readahead after each) that aren't cached: the
+     * ranges of a render backend's `data-pending`.
+     */
+    async fill(ranges, signal) {
+        if (this.#whole !== undefined)
+            return;
+        const wanted = this.#blocksFor(ranges);
+        const waits = [];
+        let run = [];
+        const flush = () => {
+            if (run.length > 0)
+                waits.push(this.#fetchRun(run, signal));
+            run = [];
+        };
+        for (const index of wanted) {
+            const pending = this.#inFlight.get(index);
+            if (pending !== undefined || this.#blocks.has(index)) {
+                flush();
+                if (pending !== undefined)
+                    waits.push(pending);
+                continue;
+            }
+            if (run.length > 0 && run[run.length - 1] !== index - 1)
+                flush();
+            run.push(index);
+        }
+        flush();
+        await Promise.all(waits);
+        // Keep what this fill asked for: evicting it now would make the caller miss again.
+        this.#evict(new Set(wanted));
+    }
+    /** The blocks `ranges` touch, with the readahead after each, in order and once each. */
+    #blocksFor(ranges) {
+        const wanted = new Set();
+        const lastBlock = Math.max(0, Math.ceil(this.size / this.blockSize) - 1);
+        for (const [offset, length] of ranges) {
+            if (length <= 0)
+                continue;
+            const first = Math.floor(offset / this.blockSize);
+            const last = Math.min(lastBlock, Math.floor((offset + length - 1) / this.blockSize) + this.#readahead);
+            for (let index = first; index <= last; index++)
+                wanted.add(index);
+        }
+        return [...wanted].sort((a, b) => a - b);
+    }
+    /** `RangeSource.read`: fills, then reads from the cache. */
+    async read(offset, length, options) {
+        const cached = this.readSync(offset, length);
+        if (cached !== undefined && cached.length === length)
+            return cached.slice();
+        await this.fill([[offset, length]], options?.signal);
+        const bytes = this.readSync(offset, length);
+        if (bytes === undefined)
+            throw new Error("a range read missed blocks it had just fetched");
+        return bytes.slice();
+    }
+    /** Fetches the consecutive blocks `run` in one request. */
+    #fetchRun(run, signal) {
+        const first = run[0] ?? 0;
+        const last = run[run.length - 1] ?? first;
+        const start = first * this.blockSize;
+        const end = Math.min(this.size, (last + 1) * this.blockSize);
+        const fetching = this.#inner.read(start, end - start, signal === undefined ? {} : { signal }).then((bytes) => {
+            for (const index of run) {
+                const at = index * this.blockSize - start;
+                this.#store(index, bytes.slice(at, Math.min(bytes.length, at + this.blockSize)));
+            }
+            this.#progress();
+        }, (e) => {
+            throw unwrapCap(e);
+        });
+        const done = fetching.finally(() => {
+            for (const index of run)
+                if (this.#inFlight.get(index) === done)
+                    this.#inFlight.delete(index);
+        });
+        for (const index of run)
+            this.#inFlight.set(index, done);
+        return done;
+    }
+    #store(index, block) {
+        const old = this.#blocks.get(index);
+        if (old !== undefined)
+            this.#cached -= old.length;
+        this.#blocks.delete(index);
+        this.#blocks.set(index, block);
+        this.#cached += block.length;
+    }
+    /** Block `index`, marked as used now; undefined when it isn't cached. */
+    #touch(index) {
+        const block = this.#blocks.get(index);
+        if (block !== undefined) {
+            this.#blocks.delete(index);
+            this.#blocks.set(index, block);
+        }
+        return block;
+    }
+    /** Drops the least recently used blocks over the budget, never one in `keep`. */
+    #evict(keep) {
+        for (const [index, block] of this.#blocks) {
+            if (this.#cached <= this.#cacheBytes)
+                return;
+            if (keep.has(index))
+                continue;
+            this.#blocks.delete(index);
+            this.#cached -= block.length;
+        }
+    }
+    #progress() {
+        this.#onProgress?.({ loaded: this.#loaded, total: this.size });
+    }
+}
+//# sourceMappingURL=http-range.js.map

package/dist/source/http-range.js.map

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

package/dist/source/opfs.d.ts

@@ -0,0 +1,35 @@
+import type { RenderSource } from "@laminapdf/render";
+import type { RangeSource } from "@laminapdf/sdk";
+/** The OPFS folder of document copies, which the app's "Clear recent files and cached documents" empties too. */
+export declare const CACHE_FOLDER = "documents";
+/** Files above this many bytes are read from a copy: 200 MiB. */
+export declare const COPY_ABOVE: number;
+/** The copy's name: its size, date and a hash of its name, so the same file finds its copy again. */
+export declare function copyName(file: Pick<File, "name" | "size" | "lastModified">): string;
+/** How a copy is made and kept. */
+export interface CopyOptions {
+    readonly signal: AbortSignal;
+    /** Told after each step of a copy being made. */
+    readonly onProgress?: ((loaded: number, total: number) => void) | undefined;
+    /** Keep the copy for next time once its document closes; false removes it then. */
+    readonly keep: boolean;
+}
+/** A copied file, read synchronously; both a RangeSource (Lamina PDF) and a RenderSource. */
+export declare class OpfsByteSource implements RangeSource, RenderSource {
+    #private;
+    readonly size: number;
+    private constructor();
+    /**
+     * `file` read from its OPFS copy, made now if it isn't there; `undefined` where the browser has
+     * no OPFS or the copy can't be made (no room, locked by another tab, a write that fails), so the
+     * caller reads it from memory. Rejects only when `options.signal` aborts.
+     */
+    static open(file: File, options: CopyOptions): Promise<OpfsByteSource | undefined>;
+    readSync(offset: number, length: number): Uint8Array | undefined;
+    read(offset: number, length: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+    /** Lets the copy go: kept in the folder for next time, or removed when it isn't to be kept. */
+    close(): void;
+}
+//# sourceMappingURL=opfs.d.ts.map

package/dist/source/opfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs.d.ts","sourceRoot":"","sources":["../../src/source/opfs.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,iHAAiH;AACjH,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,iEAAiE;AACjE,eAAO,MAAM,UAAU,QAAoB,CAAC;AAuB5C,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC,GAAG,MAAM,CAInF;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5E,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,6FAA6F;AAC7F,qBAAa,cAAe,YAAW,WAAW,EAAE,YAAY;;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAMtB,OAAO,eAMN;IAED;;;;OAIG;IACH,OAAa,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA2BvF;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAM/D;IAED,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAGrG;IAED,+FAA+F;IAC/F,KAAK,IAAI,IAAI,CAGZ;CACF"}