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

package/dist/protocol.d.ts

@@ -1,5 +1,5 @@
-import { type CloneableWasmSource, type RenderLimits, type RenderRequest } from "@laminapdf/render";
-import type { Limits, OutlineNode, PageInfo, StructureNode, Target } from "@laminapdf/sdk";
+import { type CloneableWasmSource, type PageAppearance, type RenderLimits, type RenderRequest } from "@laminapdf/render";
+import type { DocumentProperties, Limits, Op, OutlineNode, PageInfo, PageLink, Reflow, 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). */
@@ -26,6 +26,13 @@ export interface ViewerOpenOptions {
     readonly limits?: Partial<Limits>;
     /** The backend's render limits (ADR 0004). */
     readonly renderLimits?: Partial<RenderLimits>;
+    /**
+     * A local file larger than this many bytes is copied into the origin-private file system and
+     * read from there, not held in memory (default 200 MiB; tests lower it).
+     */
+    readonly copyAbove?: number;
+    /** Keep that copy once the document closes, for next time (default true); false removes it then. */
+    readonly keepCopy?: boolean;
 }
 /** An open document, as layout needs it up front. */
 export interface OpenedDocument {
@@ -36,13 +43,89 @@ export interface OpenedDocument {
     readonly pages: readonly PageInfo[];
     /** Whether the file can't be opened without its password, so a restarted worker must ask again. */
     readonly needsPassword: boolean;
+    /**
+     * A hash of the file's first revision (`"fp1:"` and a SHA-256 in hex): the same for a renamed
+     * copy and after an incremental update, so a reading position kept under it follows the file.
+     * Absent when it couldn't be computed (no Web Crypto, a failed read): the document still opens.
+     */
+    readonly fingerprint?: string;
     readonly backend: {
         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;
+    /**
+     * Whether the file is encrypted: it can't take an edit until saving can encrypt again (E11),
+     * since its edits are written into memory to be drawn, and that save is refused (`encrypted-base`).
+     */
+    readonly encrypted: boolean;
+}
+/**
+ * What an edit, an undo or a redo did, for the view to redraw (`applyEdit`, `undoEdit`,
+ * `redoEdit`, `goToStep`): the pages it touched, as they are after it, and the edit session's
+ * history now. Each page's size is its displayed size in points, so a quarter turn swaps its width
+ * and height. An edit that touched no page (the document's metadata) leaves `pages` empty.
+ */
+export interface EditResult {
+    readonly pages: readonly PageInfo[];
+    readonly history: EditHistory;
+    /** Each step an undo or redo took back or made again, in order, with how it went (none for an edit). */
+    readonly reverted?: readonly RevertedStep[];
+}
+/** The most steps an edit session keeps: the oldest go after this many (ADR 0006 §4). */
+export declare const HISTORY_DEPTH = 500;
+/** One step of an edit session: a transaction, as the history lists it. */
+export interface EditStep {
+    /** Unique in the session, and increasing. */
+    readonly id: number;
+    /** What it did, in the words its caller gave ("Rotate page 5"). */
+    readonly label: string;
+    /** The pages it touched (0-based), in order. */
+    readonly pages: readonly number[];
+    /** When it was made, in ms since the epoch. */
+    readonly at: number;
+    /**
+     * Its last undo (`"undo"`) or redo (`"redo"`) restored only part of it (`UndoOutcome::Partial`):
+     * a later change replaced some of what it changed, which keeps the later value.
+     */
+    readonly partial?: "undo" | "redo";
 }
+/**
+ * An edit session's history (the worker holds the op log; this is its summary): the steps kept,
+ * oldest first, of which the first `position` are done and the rest undone, ready to redo.
+ */
+export interface EditHistory {
+    readonly steps: readonly EditStep[];
+    readonly position: number;
+    /** How many of the oldest steps the depth limit dropped ({@link HISTORY_DEPTH}). */
+    readonly dropped: number;
+    /**
+     * Transactions between the document now and its last save, or as opened (ADR 0006 §7, the
+     * semantic level): 0 when they match, as after undoing every step since.
+     */
+    readonly unsaved: number;
+    /** An edit failed and couldn't be undone: nothing more can be edited until the document opens again. */
+    readonly diverged: boolean;
+}
+/** How an undo or redo of one step went. */
+export interface RevertedStep {
+    readonly step: EditStep;
+    readonly way: "undo" | "redo";
+    /**
+     * `partial`: some of it was left alone, because a later change replaced it; `skipped`: nothing
+     * could be restored, and the step is gone from the history.
+     */
+    readonly outcome: "applied" | "partial" | "skipped";
+}
+/** The ops of one step and its label, as a restarted worker replays them (`restoreEdits`). */
+export interface ReplayedStep {
+    readonly ops: readonly Op[];
+    readonly label: string;
+    readonly at: number;
+}
+/** An edit session with nothing in it. */
+export declare const EMPTY_HISTORY: EditHistory;
 /** A rendered tile on the page: an ImageBitmap transferred from the worker. Close it when done. */
 export interface RenderedBitmap {
     readonly bitmap: ImageBitmap;
@@ -66,14 +149,59 @@ export interface Methods {
             version: string;
         };
     };
+    /** `ticket`: the page's number for this open, which `currentDocument` gives back. */
     openDocument: {
-        params: [source: SourceInit, options: ViewerOpenOptions];
+        params: [source: SourceInit, options: ViewerOpenOptions, ticket?: number];
         result: OpenedDocument;
     };
+    /** The open document's answer and its open's ticket; asked after a cancelled open. */
+    currentDocument: {
+        params: [];
+        result: {
+            readonly document: OpenedDocument;
+            readonly ticket: number | undefined;
+        } | undefined;
+    };
     closeDocument: {
         params: [];
         result: undefined;
     };
+    /**
+     * Applies `ops` to document `document` as one transaction, then redraws from the result: the
+     * pages it touched are drawn from the edited file from then on.
+     */
+    applyEdit: {
+        params: [ops: readonly Op[], document: number, label?: string];
+        result: EditResult;
+    };
+    /** Undoes the newest done step of document `document`'s edit session, and redraws. */
+    undoEdit: {
+        params: [document: number];
+        result: EditResult;
+    };
+    /** Redoes the oldest undone step, and redraws. */
+    redoEdit: {
+        params: [document: number];
+        result: EditResult;
+    };
+    /** Undoes or redoes steps until `position` of them are done, and redraws once. */
+    goToStep: {
+        params: [position: number, document: number];
+        result: EditResult;
+    };
+    /** The edit session's history. */
+    editHistory: {
+        params: [document: number];
+        result: EditHistory;
+    };
+    /**
+     * A restarted worker's document takes the edits the old one had: `steps` applied again, one
+     * transaction each, then the newest `undone` of them undone, and drawn once.
+     */
+    restoreEdits: {
+        params: [steps: readonly ReplayedStep[], undone: number, document: number];
+        result: EditResult;
+    };
     pageInfo: {
         params: [index: number];
         result: PageInfo;
@@ -94,6 +222,10 @@ export interface Methods {
         params: [];
         result: StructureData;
     };
+    reflow: {
+        params: [];
+        result: Reflow;
+    };
     networkLog: {
         params: [];
         result: WorkerNetworkLog;
@@ -106,10 +238,58 @@ export interface Methods {
         params: [name: string];
         result: Target | undefined;
     };
+    pageLinks: {
+        params: [index: number];
+        result: readonly PageLink[];
+    };
+    properties: {
+        params: [];
+        result: DocumentProperties;
+    };
+    printPage: {
+        params: [index: number, options: PrintOptions];
+        result: PrintedPage;
+    };
+    fileBytes: {
+        params: [];
+        result: Uint8Array;
+    };
     find: {
         params: [query: string, options: FindOptions, pages: readonly number[]];
         result: FindPageResult[];
     };
+    readingOrder: {
+        params: [index: number];
+        result: ReadingBlock[];
+    };
+}
+/**
+ * One block of a page's text in reading order, as Lamina PDF's extraction finds it (ADR 0030):
+ * where it is, in page space (points from the displayed page's top-left, y down), and what kind
+ * of block it is. Copy as paragraph joins the selected text block by block in this order.
+ */
+export interface ReadingBlock {
+    /** Its box: `[x, y, width, height]`. */
+    readonly bbox: readonly [number, number, number, number];
+    /** `paragraph`, `heading`, `list-item`, `caption`, `footnote`, `table` or `other`. */
+    readonly type: string;
+}
+/** How a page is drawn for printing. */
+export interface PrintOptions {
+    /** Dots per inch: 150 (standard) or 300 (high). Lowered for a page too large to hold. */
+    readonly dpi: number;
+    /** Draw annotations as their print flags say (comments, highlights, stamps); off leaves them out. */
+    readonly annotations: boolean;
+}
+/** One page drawn for printing. */
+export interface PrintedPage {
+    /** The page as a PNG. */
+    readonly image: Blob;
+    /** Its displayed size in points (`/Rotate` applied), which the printed page takes. */
+    readonly width: number;
+    readonly height: number;
+    /** The resolution it was drawn at: below the one asked for when the page was too large. */
+    readonly dpi: number;
 }
 /** One page's find results: each match as its quads (8 numbers per run it touches), in page space. */
 export interface FindPageResult {
@@ -213,8 +393,20 @@ export interface RenderKeyFields {
 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).
+ * RenderRequest (page, scale, clip, rotation, flags, background and appearance), 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;
+/**
+ * The view's cache key of a render: its {@link renderKey}'s fields and the page's `revision`,
+ * which each edit of the page bumps, so a bitmap of the page before an edit never answers for it
+ * after. {@link renderKeyFields} reads both kinds of key.
+ */
+export declare function viewKey(request: RenderRequest, id: number, revision: number): string;
+/** The request field for `appearance`: none for the pages' own colours, as requests were before page appearances. */
+export declare function appearanceField(appearance: PageAppearance): {
+    appearance?: PageAppearance;
+};
+/** A page appearance as a string: equal for the same appearance, whatever the object. */
+export declare function appearanceKey(appearance: PageAppearance | undefined): string;
 //# sourceMappingURL=protocol.d.ts.map

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

package/dist/protocol.js

@@ -3,7 +3,11 @@
 // 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";
+import { flagsOf, } from "@laminapdf/render";
+/** The most steps an edit session keeps: the oldest go after this many (ADR 0006 §4). */
+export const HISTORY_DEPTH = 500;
+/** An edit session with nothing in it. */
+export const EMPTY_HISTORY = { steps: [], position: 0, dropped: 0, unsaved: 0, diverged: false };
 /** The worker queue's numbers for each priority (higher first). */
 export const PRIORITY = Object.freeze({
     document: 4,
@@ -18,12 +22,23 @@ export function renderKeyFields(key) {
 }
 /**
  * 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).
+ * RenderRequest (page, scale, clip, rotation, flags, background and appearance), 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([
+    return JSON.stringify(keyFields(request, id));
+}
+/**
+ * The view's cache key of a render: its {@link renderKey}'s fields and the page's `revision`,
+ * which each edit of the page bumps, so a bitmap of the page before an edit never answers for it
+ * after. {@link renderKeyFields} reads both kinds of key.
+ */
+export function viewKey(request, id, revision) {
+    return JSON.stringify([...keyFields(request, id), revision]);
+}
+function keyFields(request, id) {
+    const { page, scale, clip, rotation = 0, flags, background, appearance } = request;
+    return [
         id,
         page,
         scale,
@@ -31,6 +46,18 @@ export function renderKey(request, id) {
         rotation,
         flagsOf(flags),
         background === undefined ? "white" : background,
-    ]);
+        appearanceKey(appearance),
+    ];
+}
+/** The request field for `appearance`: none for the pages' own colours, as requests were before page appearances. */
+export function appearanceField(appearance) {
+    return appearance === "original" ? {} : { appearance };
+}
+/** A page appearance as a string: equal for the same appearance, whatever the object. */
+export function appearanceKey(appearance) {
+    if (appearance === undefined || typeof appearance === "string")
+        return appearance ?? "original";
+    const { ink: i, paper: p } = appearance;
+    return `high-contrast:${i.r},${i.g},${i.b},${i.a}:${p.r},${p.g},${p.b},${p.a}`;
 }
 //# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,wFAAwF;AACxF,iGAAiG;AACjG,8FAA8F;AAC9F,kBAAkB;AAElB,OAAO,EAEL,OAAO,GAIR,MAAM,mBAAmB,CAAC;AA0F3B,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAuDjC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAmM9G,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,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAsB,EAAE,EAAU,EAAE,QAAgB;IAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,SAAS,CAAC,OAAsB,EAAE,EAAU;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACnF,OAAO;QACL,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;QAC/C,aAAa,CAAC,UAAU,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,eAAe,CAAC,UAA0B;IACxD,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,UAAsC;IAClE,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,UAAU,IAAI,UAAU,CAAC;IAChG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC;IACxC,OAAO,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC"}

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

package/dist/source/opfs.js

@@ -0,0 +1,178 @@
+// A large local file read from the origin-private file system: copied there once, in the document
+// worker, then read through a synchronous access handle, so neither Lamina PDF nor the render
+// backend (PDFium reads synchronously) needs the whole file in memory. Copies live in one folder,
+// named by the file's size, date and name, so opening the same file again reads the copy already
+// there; when the folder would pass its budget, the copies used longest ago go first. OPFS is a
+// cache, never the only copy: a browser without it, a copy that doesn't fit or fails partway, or a
+// file another tab holds opens from memory, as before; only a cancel stops the open.
+/** The OPFS folder of document copies, which the app's "Clear recent files and cached documents" empties too. */
+export const CACHE_FOLDER = "documents";
+/** Files above this many bytes are read from a copy: 200 MiB. */
+export const COPY_ABOVE = 200 * 1024 * 1024;
+/** How much the copies may take, at most: 2 GiB, and never more than half the free quota. */
+const MAX_CACHE_BYTES = 2 * 1024 * 1024 * 1024;
+/** Copied in steps of 8 MiB, each a chance to stop and to report progress. */
+const CHUNK = 8 * 1024 * 1024;
+/** Beside each copy, a file holding when it was last opened (the copy's own date is when it was made). */
+const USED = ".used";
+/** The copy's name: its size, date and a hash of its name, so the same file finds its copy again. */
+export function copyName(file) {
+    let hash = 2166136261;
+    for (let i = 0; i < file.name.length; i++)
+        hash = Math.imul(hash ^ file.name.charCodeAt(i), 16777619);
+    return `${file.size}-${file.lastModified}-${(hash >>> 0).toString(16)}.pdf`;
+}
+/** A copied file, read synchronously; both a RangeSource (Lamina PDF) and a RenderSource. */
+export class OpfsByteSource {
+    size;
+    #handle;
+    #folder;
+    #name;
+    #keep;
+    constructor(handle, folder, name, keep) {
+        this.#handle = handle;
+        this.#folder = folder;
+        this.#name = name;
+        this.#keep = keep;
+        this.size = handle.getSize();
+    }
+    /**
+     * `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 async open(file, options) {
+        const folder = await cacheFolder();
+        if (folder === undefined)
+            return undefined;
+        const name = copyName(file);
+        let handle;
+        try {
+            const fileHandle = (await folder.getFileHandle(name, { create: true }));
+            handle = await fileHandle.createSyncAccessHandle();
+        }
+        catch {
+            // Locked by another tab's worker, or the browser refuses: read it from memory instead.
+            return undefined;
+        }
+        try {
+            if (handle.getSize() !== file.size) {
+                if (!(await makeRoom(folder, name, file.size)))
+                    throw new Error("no room for the copy");
+                await copyInto(handle, file, options);
+            }
+            // The use record is best effort: another tab may hold it, and the copy is good without it.
+            await touch(folder, name).catch(() => undefined);
+            return new OpfsByteSource(handle, folder, name, options.keep);
+        }
+        catch (error) {
+            // A copy cut short (a cancel, the disk full) is never left to look complete.
+            handle.close();
+            await removeCopy(folder, name);
+            if (options.signal.aborted)
+                throw error;
+            return undefined;
+        }
+    }
+    readSync(offset, length) {
+        const end = Math.min(this.size, offset + length);
+        if (offset < 0 || end < offset)
+            return undefined;
+        const out = new Uint8Array(end - offset);
+        this.#handle.read(out, { at: offset });
+        return out;
+    }
+    read(offset, length, options) {
+        options?.signal?.throwIfAborted();
+        return Promise.resolve(this.readSync(offset, length) ?? new Uint8Array());
+    }
+    /** Lets the copy go: kept in the folder for next time, or removed when it isn't to be kept. */
+    close() {
+        this.#handle.close();
+        if (!this.#keep)
+            void removeCopy(this.#folder, this.#name);
+    }
+}
+async function cacheFolder() {
+    try {
+        const root = await navigator.storage.getDirectory();
+        return await root.getDirectoryHandle(CACHE_FOLDER, { create: true });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Removes a copy and its use record; a copy another tab is reading stays (false). */
+async function removeCopy(folder, name) {
+    try {
+        await folder.removeEntry(name);
+    }
+    catch {
+        return false;
+    }
+    await folder.removeEntry(name + USED).catch(() => undefined);
+    return true;
+}
+/** Records that copy `name` was opened now. */
+async function touch(folder, name) {
+    const used = (await folder.getFileHandle(name + USED, { create: true }));
+    const handle = await used.createSyncAccessHandle();
+    try {
+        const stamp = new Uint8Array(8);
+        new DataView(stamp.buffer).setFloat64(0, Date.now());
+        handle.truncate(0);
+        handle.write(stamp, { at: 0 });
+        handle.flush();
+    }
+    finally {
+        handle.close();
+    }
+}
+/** When copy `name` was last opened, else when it was made. */
+async function lastUsed(folder, name, made) {
+    try {
+        const record = await (await folder.getFileHandle(name + USED)).getFile();
+        return new DataView(await record.arrayBuffer()).getFloat64(0);
+    }
+    catch {
+        return made;
+    }
+}
+/**
+ * Whether a copy of `size` bytes fits, making room by removing other copies, those used longest
+ * ago first. The copies together may take half of what is free for them (the quota's free space
+ * plus what the copies already hold), and never more than MAX_CACHE_BYTES.
+ */
+async function makeRoom(folder, keep, size) {
+    const copies = [];
+    for await (const [name, entry] of folder.entries()) {
+        if (name === keep || name.endsWith(USED) || entry.kind !== "file")
+            continue;
+        const copy = await entry.getFile().catch(() => undefined);
+        if (copy !== undefined)
+            copies.push({ name, size: copy.size, used: await lastUsed(folder, name, copy.lastModified) });
+    }
+    let held = copies.reduce((sum, c) => sum + c.size, 0);
+    const { quota = 0, usage = 0 } = await navigator.storage.estimate();
+    const budget = Math.min(MAX_CACHE_BYTES, (quota - usage + held) / 2);
+    if (size > budget)
+        return false;
+    for (const copy of copies.sort((a, b) => a.used - b.used)) {
+        if (held + size <= budget)
+            break;
+        if (await removeCopy(folder, copy.name))
+            held -= copy.size;
+    }
+    return held + size <= budget;
+}
+async function copyInto(handle, file, options) {
+    handle.truncate(0);
+    for (let at = 0; at < file.size; at += CHUNK) {
+        options.signal.throwIfAborted();
+        const bytes = new Uint8Array(await file.slice(at, Math.min(file.size, at + CHUNK)).arrayBuffer());
+        handle.write(bytes, { at });
+        options.onProgress?.(Math.min(file.size, at + CHUNK), file.size);
+    }
+    handle.flush();
+}
+//# sourceMappingURL=opfs.js.map

package/dist/source/opfs.js.map

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

package/dist/thumbnails/strip.d.ts

@@ -1,6 +1,6 @@
 import type { PageInfo } from "@laminapdf/sdk";
 import type { ViewerClient } from "../client.js";
-import type { OpenedDocument } from "../protocol.js";
+import { type OpenedDocument } from "../protocol.js";
 import type { Viewer } from "../view/viewer.js";
 /** How a strip looks and how much it keeps. */
 export interface ThumbnailStripOptions {

package/dist/thumbnails/strip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../src/thumbnails/strip.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxG,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,4GAA4G;AAC5G,qBAAa,cAAc;;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAoB9B,YAAY,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,EA4BpF;IAED,qCAAqC;IACrC,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAGlC;IAED,4DAA4D;IAC5D,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CASnC;IAED,4FAA4F;IAC5F,OAAO,IAAI,IAAI,CAMd;CAkNF"}
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../src/thumbnails/strip.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEjE,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxG,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,4GAA4G;AAC5G,qBAAa,cAAc;;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAqB9B,YAAY,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,EA6BpF;IAED,qCAAqC;IACrC,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAGlC;IAED,4DAA4D;IAC5D,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CASnC;IAED,4FAA4F;IAC5F,OAAO,IAAI,IAAI,CAMd;CA0PF"}