@laminapdf/viewer 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/protocol.d.ts

@@ -1,5 +1,7 @@
 import { type CloneableWasmSource, type RenderLimits, type RenderRequest } from "@laminapdf/render";
-import type { Limits, PageInfo } from "@laminapdf/sdk";
+import type { Limits, OutlineNode, PageInfo, StructureNode, Target } from "@laminapdf/sdk";
+import type { FindOptions } from "./find/fold.js";
+import type { FindSnippet } from "./find/page.js";
 /** 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. */
@@ -8,8 +10,15 @@ export interface BackendInit {
     /** The engine's `.wasm`: required for PDFium (its URL from your bundler); hayro finds its own. */
     readonly wasm?: CloneableWasmSource;
 }
+/**
+ * A remote file the worker fetches itself, with HTTP Range requests (`HttpRangeByteSource`): its
+ * bytes never pass through the page.
+ */
+export interface RemoteSource {
+    readonly url: string;
+}
 /** What a document is opened from: sent to the worker, which reads it there. */
-export type SourceInit = Blob | ArrayBuffer | Uint8Array;
+export type SourceInit = Blob | ArrayBuffer | Uint8Array | RemoteSource;
 /** `open`'s options. The password crosses to the worker once and is kept only there. */
 export interface ViewerOpenOptions {
     readonly password?: string;
@@ -31,6 +40,8 @@ export interface OpenedDocument {
         readonly name: BackendName;
         readonly version: string;
     };
+    /** The title in the file's metadata, for the window's title; absent when the file has none. */
+    readonly title?: string;
 }
 /** A rendered tile on the page: an ImageBitmap transferred from the worker. Close it when done. */
 export interface RenderedBitmap {
@@ -38,6 +49,14 @@ export interface RenderedBitmap {
     readonly width: number;
     readonly height: number;
 }
+/**
+ * The bytes of the worker's WebAssembly memories: the render backend's and Lamina PDF's (every
+ * module loaded). Memories only grow, so this is also their peak.
+ */
+export interface WorkerMemory {
+    readonly backend: number;
+    readonly sdk: number;
+}
 /** The viewer's methods: params and result per method. `client.call` is typed by it. */
 export interface Methods {
     initBackend: {
@@ -63,6 +82,112 @@ export interface Methods {
         params: [request: RenderRequest, document: number];
         result: RenderedBitmap;
     };
+    memory: {
+        params: [];
+        result: WorkerMemory;
+    };
+    pageText: {
+        params: [index: number];
+        result: PageTextData;
+    };
+    structure: {
+        params: [];
+        result: StructureData;
+    };
+    networkLog: {
+        params: [];
+        result: WorkerNetworkLog;
+    };
+    outline: {
+        params: [];
+        result: OutlineNode[];
+    };
+    namedDestination: {
+        params: [name: string];
+        result: Target | undefined;
+    };
+    find: {
+        params: [query: string, options: FindOptions, pages: readonly number[]];
+        result: FindPageResult[];
+    };
+}
+/** One page's find results: each match as its quads (8 numbers per run it touches), in page space. */
+export interface FindPageResult {
+    readonly page: number;
+    readonly matches: readonly (readonly number[])[];
+    /** Each match in its line, in the same order. */
+    readonly snippets: readonly FindSnippet[];
+    /** The page has no text to search (a scan without an OCR layer). */
+    readonly noText?: true;
+}
+/** One text run of a page: glyphs of one font, size and direction on one baseline, in logical order. */
+export interface TextRunData {
+    /** Its text in logical order (document text; an `/ActualText` replacement when `actualText`). */
+    readonly text: string;
+    /** Font size in points, the text matrix applied. */
+    readonly size: number;
+    /** Vertical writing. */
+    readonly vertical: boolean;
+    /** The text replaces its glyphs (`/ActualText`). */
+    readonly actualText: boolean;
+    /** Drawn invisibly (`Tr` 3 or 7: an OCR layer, hidden text); selectable all the same. */
+    readonly invisible: boolean;
+    /** Its glyphs: `[start, end)` into `quads` (8 numbers each), as the SDK's `PageTextRun.glyphRange`. */
+    readonly glyphRange: readonly [number, number];
+    /** The marked-content ID it is in, which links it to the structure tree. */
+    readonly mcid?: number;
+}
+/**
+ * A page's text: its runs, and every glyph's quad as 8 numbers (bottom-left, bottom-right,
+ * top-right, top-left, each `x, y`) in page space (ADR 0027: points from the displayed page's
+ * top-left, y down).
+ */
+export interface PageTextData {
+    readonly runs: readonly TextRunData[];
+    readonly quads: Float32Array;
+}
+/** Whether the document says it is tagged, and its structure tree when it has one. */
+export interface StructureData {
+    readonly tagged: boolean;
+    readonly tree?: readonly StructureNode[];
+}
+/** Which JavaScript context made a request: the page, or the document worker. */
+export type NetworkSource = "page" | "worker";
+/** One network request a context made, as `watchNetwork` reports it. */
+export interface NetworkRecord {
+    readonly url: string;
+    readonly method: string;
+    /**
+     * What made it: `fetch`, `xmlhttprequest`, `websocket` and `beacon` for wrapped calls, else the
+     * Resource Timing `initiatorType` (`script`, `link`, `css`, `img`, `navigation` …).
+     */
+    readonly initiator: string;
+    /** Bytes received, when known (0 otherwise). */
+    readonly bytes: number;
+    /** The call failed or was refused (a CORS refusal, a network error, a beacon not queued). */
+    readonly failed: boolean;
+    readonly source: NetworkSource;
+    /** `Date.now()` when it was reported. */
+    readonly at: number;
+}
+/** A request the Content Security Policy blocked: nothing was sent. */
+export interface PolicyViolation {
+    readonly directive: string;
+    readonly blockedUri: string;
+    readonly source: NetworkSource;
+    readonly at: number;
+}
+/** The document worker's network log: every request and blocked request since it started. */
+export interface WorkerNetworkLog {
+    /** Different for each worker the client starts, so a restarted worker's records stay apart. */
+    readonly worker: string;
+    readonly requests: readonly NetworkRecord[];
+    readonly violations: readonly PolicyViolation[];
+}
+/** How much of a remote file the worker has read: the `progress` event. */
+export interface LoadProgress {
+    readonly loaded: number;
+    readonly total: number;
 }
 /** A viewer method's name. */
 export type MethodName = keyof Methods;

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,mBAAmB,EAAW,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAExE,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,mGAAmG;IACnG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wFAAwF;AACxF,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE;QAAE,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,IAAI,EAAE,WAAW,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACvF,YAAY,EAAE;QAAE,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC;IACnG,aAAa,EAAE;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IACjD,QAAQ,EAAE;QAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAE,CAAC;IACxD,MAAM,EAAE;QAAE,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC;IACvF,MAAM,EAAE;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE;QAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAC5D,SAAS,EAAE;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC;IACjD,UAAU,EAAE;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAC/C,gBAAgB,EAAE;QAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACzE,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;CAC7G;AAED,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACjD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACxB;AAED,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9C,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC;AACvC,+BAA+B;AAC/B,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAChE,2BAA2B;AAC3B,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,QAAQ,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,MAAM;CAKpE,CAAC;AAEH,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAWpE"}

package/dist/protocol.js

@@ -1,5 +1,5 @@
-// 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
+// The viewer's methods on the document worker (ADR 0009 §3). They extend `@laminapdf/sdk/worker`:
+// 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.

package/dist/protocol.js.map

@@ -1 +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"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,wFAAwF;AACxF,iGAAiG;AACjG,8FAA8F;AAC9F,kBAAkB;AAElB,OAAO,EAA4B,OAAO,EAAyC,MAAM,mBAAmB,CAAC;AAqL7G,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

@@ -1,17 +1,57 @@
 import type { PixelRect } from "@laminapdf/render";
+/**
+ * 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 declare const BACKDROP_MAX_PIXELS: number;
+/**
+ * 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 declare function backdropRatio(dpr: number, css: {
+    readonly width: number;
+    readonly height: number;
+}, maxPixels?: number): number;
+/** The smallest rectangle covering every one of `rects`; undefined when there are none. */
+export declare function bounds(rects: readonly PixelRect[]): PixelRect | undefined;
+/** Whether `outer` contains all of `inner`. */
+export declare function contains(outer: PixelRect, inner: PixelRect): boolean;
 /** 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 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 declare function sharpScale(layoutScale: number, dpr: number, css: {
+    readonly width: number;
+    readonly height: number;
+}, fitted: {
+    readonly width: number;
+    readonly height: number;
+}, wanted: {
+    readonly width: number;
+    readonly height: 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.
+ * 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 declare function tilesFor(visible: {
     readonly x: number;
     readonly y: number;
     readonly width: number;
     readonly height: number;
-}, pageCss: {
+}, page: {
     readonly width: number;
     readonly height: number;
-}, dpr: number): PixelRect[];
+}, ratio: number): PixelRect[];
 //# sourceMappingURL=tiles.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/render/tiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxD,SAAS,SAAsB,GAC9B,MAAM,CAGR;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,CAWzE;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAOpE;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3D,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D,MAAM,CAGR;AAED;;;;;GAKG;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,IAAI,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,KAAK,EAAE,MAAM,GACZ,SAAS,EAAE,CAcb"}

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"}