@build-qube/papyra 0.4.0 → 0.6.0

package/dist/tiff-image.js

@@ -0,0 +1,65 @@
+/**
+ * The default {@link TiffRenderOptions.maxPixels}: 4096 × 4096.
+ *
+ * It is iOS Safari's canvas limit, and 64 MB of RGBA. A 300-dpi E-size sheet comes out
+ * at about 100 dpi under it — readable, with hairlines in grey.
+ */
+export const TIFF_MAX_PIXELS = 4096 * 4096;
+/**
+ * An opened TIFF. Get one from `openTiff`.
+ *
+ * `P` is what a page decodes to: RGBA from papyra's own addon, and an `ImageBitmap`
+ * too from a host that sends pages as PNG.
+ */
+export class TiffImage {
+    /**
+     * Every page, in file order. A reduced-resolution copy of a page — a thumbnail, a
+     * pyramid level — is not a page and is left out.
+     */
+    pages;
+    #native;
+    /** @internal — construct via `openTiff`. */
+    constructor(native) {
+        this.#native = native;
+        this.pages = native.pages.map((p) => ({
+            width: p.width,
+            height: p.height,
+            dpi: p.xDpi != null ? { x: p.xDpi, y: p.yDpi ?? p.xDpi } : undefined,
+            compression: p.compression,
+            bitsPerSample: p.bitsPerSample,
+            samplesPerPixel: p.samplesPerPixel,
+            orientation: p.orientation,
+        }));
+    }
+    /** How many pages there are. */
+    get pageCount() {
+        return this.pages.length;
+    }
+    /**
+     * Decode one page to RGBA, upright, at no more than `options` allows.
+     *
+     * Paint the result with `paintToCanvas`, or encode it with `encode`, exactly as a
+     * rendered PDF page. Each call decodes the page again; keep the result if it will
+     * be shown again.
+     */
+    renderPage(index, options = {}) {
+        if (!Number.isInteger(index) || index < 0 || index >= this.pages.length) {
+            return Promise.reject(new RangeError(`papyra: no TIFF page ${JSON.stringify(index)}`));
+        }
+        return this.#native.renderPage(index, {
+            maxPixels: options.maxPixels,
+            maxWidth: options.maxWidth === undefined
+                ? undefined
+                : Math.max(1, Math.floor(options.maxWidth)),
+        });
+    }
+    /**
+     * Free the file. A no-op for papyra's own, which the garbage collector frees; a
+     * host holding it — a Tauri app's — frees it now, and would otherwise keep it until
+     * the page reloads.
+     */
+    async close() {
+        await this.#native.close?.();
+    }
+}
+//# sourceMappingURL=tiff-image.js.map

package/dist/tiff-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiff-image.js","sourceRoot":"","sources":["../src/tiff-image.ts"],"names":[],"mappings":"AAgEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAe3C;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACpB;;;OAGG;IACM,KAAK,CAAsB;IAC3B,OAAO,CAAgB;IAEhC,4CAA4C;IAC5C,YAAY,MAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YACpE,WAAW,EAAE,CAAC,CAAC,WAA8B;YAC7C,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAa,EAAE,OAAO,GAAsB,EAAE;QACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACxE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,UAAU,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EACN,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/tiff.d.ts

@@ -1,55 +1,5 @@
-import { type TiffImage as NativeTiffImage } from '@build-qube/papyra-native';
-import type { PdfSource, RenderedPage } from './types.js';
-/**
- * How a TIFF page's pixels are stored.
- *
- * The three `ccitt-*` values are fax coding — `ccitt-g4` is what nearly every scanned
- * drawing uses. `old-jpeg` is listed so a page can say what it is, but cannot be
- * rendered.
- */
-export type TiffCompression = 'none' | 'ccitt-rle' | 'ccitt-g3' | 'ccitt-g4' | 'lzw' | 'old-jpeg' | 'jpeg' | 'deflate' | 'packbits' | 'other';
-/** One page of a TIFF, as it is shown: the file's `Orientation` is already applied. */
-export interface TiffPage {
-    /** Width in pixels, at full resolution. */
-    readonly width: number;
-    /** Height in pixels, at full resolution. */
-    readonly height: number;
-    /**
-     * Resolution in dots per inch, when the file states one. Fax pages are typically
-     * 204 by 196, so the two can differ.
-     */
-    readonly dpi: {
-        /** Horizontal dots per inch. */
-        readonly x: number;
-        /** Vertical dots per inch. */
-        readonly y: number;
-    } | undefined;
-    /** How the pixels are stored. */
-    readonly compression: TiffCompression;
-    /** Bits per sample: 1 for a bilevel scan, 8 for most others. */
-    readonly bitsPerSample: number;
-    /** Samples per pixel: 1 for grey, 3 for RGB, 4 with alpha or for CMYK. */
-    readonly samplesPerPixel: number;
-    /** TIFF `Orientation`, 1–8. 1 is upright; 6 and 8 are a quarter turn. */
-    readonly orientation: number;
-}
-/**
- * Size limits for {@link TiffImage.renderPage}. The page keeps its aspect ratio and
- * is never enlarged.
- */
-export interface TiffRenderOptions {
-    /** The most pixels the result may have. Defaults to {@link TIFF_MAX_PIXELS}. */
-    maxPixels?: number;
-    /** The widest the result may be, in pixels. */
-    maxWidth?: number;
-}
-/**
- * The default {@link TiffRenderOptions.maxPixels}: 4096 × 4096.
- *
- * It is iOS Safari's canvas limit, and 64 MB of RGBA. A 300-dpi E-size sheet comes out
- * at about 100 dpi under it — readable, with hairlines in grey.
- */
-export declare const TIFF_MAX_PIXELS: number;
+import { TiffImage } from './tiff-image.js';
+import type { PdfSource } from './types.js';
 /**
  * Open a TIFF: single or multi-page, classic or BigTIFF.
  *
@@ -71,25 +21,4 @@ export declare const TIFF_MAX_PIXELS: number;
  * ```
  */
 export declare function openTiff(source: PdfSource): Promise<TiffImage>;
-/** An opened TIFF. Get one from {@link openTiff}. */
-export declare class TiffImage {
-    #private;
-    /**
-     * Every page, in file order. A reduced-resolution copy of a page — a thumbnail, a
-     * pyramid level — is not a page and is left out.
-     */
-    readonly pages: readonly TiffPage[];
-    /** @internal — construct via {@link openTiff}. */
-    constructor(native: NativeTiffImage);
-    /** How many pages there are. */
-    get pageCount(): number;
-    /**
-     * Decode one page to RGBA, upright, at no more than `options` allows.
-     *
-     * Paint the result with `paintToCanvas`, or encode it with `encode`, exactly as a
-     * rendered PDF page. Each call decodes the page again; keep the result if it will
-     * be shown again.
-     */
-    renderPage(index: number, options?: TiffRenderOptions): Promise<RenderedPage>;
-}
 //# sourceMappingURL=tiff.d.ts.map

package/dist/tiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tiff.d.ts","sourceRoot":"","sources":["../src/tiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,IAAI,eAAe,EAClC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,GACV,KAAK,GACL,UAAU,GACV,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EACR;QACE,gCAAgC;QAChC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,8BAA8B;QAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACpB,GACD,SAAS,CAAC;IACd,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAc,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAGpE;AAED,qDAAqD;AACrD,qBAAa,SAAS;;IACpB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAGpC,kDAAkD;IAClD,YAAY,MAAM,EAAE,eAAe,EAWlC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAavB;CACF"}
+{"version":3,"file":"tiff.d.ts","sourceRoot":"","sources":["../src/tiff.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAIpE"}

package/dist/tiff.js

@@ -1,12 +1,6 @@
-import { loadTiff, } from '@build-qube/papyra-native';
+import { loadTiff } from '@build-qube/papyra-native';
 import { toBytes } from './source.js';
-/**
- * The default {@link TiffRenderOptions.maxPixels}: 4096 × 4096.
- *
- * It is iOS Safari's canvas limit, and 64 MB of RGBA. A 300-dpi E-size sheet comes out
- * at about 100 dpi under it — readable, with hairlines in grey.
- */
-export const TIFF_MAX_PIXELS = 4096 * 4096;
+import { TiffImage } from './tiff-image.js';
 /**
  * Open a TIFF: single or multi-page, classic or BigTIFF.
  *
@@ -29,50 +23,7 @@ export const TIFF_MAX_PIXELS = 4096 * 4096;
  */
 export async function openTiff(source) {
     const bytes = await toBytes(source);
-    return new TiffImage(await loadTiff(bytes));
-}
-/** An opened TIFF. Get one from {@link openTiff}. */
-export class TiffImage {
-    /**
-     * Every page, in file order. A reduced-resolution copy of a page — a thumbnail, a
-     * pyramid level — is not a page and is left out.
-     */
-    pages;
-    #native;
-    /** @internal — construct via {@link openTiff}. */
-    constructor(native) {
-        this.#native = native;
-        this.pages = native.pages.map((p) => ({
-            width: p.width,
-            height: p.height,
-            dpi: p.xDpi != null ? { x: p.xDpi, y: p.yDpi ?? p.xDpi } : undefined,
-            compression: p.compression,
-            bitsPerSample: p.bitsPerSample,
-            samplesPerPixel: p.samplesPerPixel,
-            orientation: p.orientation,
-        }));
-    }
-    /** How many pages there are. */
-    get pageCount() {
-        return this.pages.length;
-    }
-    /**
-     * Decode one page to RGBA, upright, at no more than `options` allows.
-     *
-     * Paint the result with `paintToCanvas`, or encode it with `encode`, exactly as a
-     * rendered PDF page. Each call decodes the page again; keep the result if it will
-     * be shown again.
-     */
-    renderPage(index, options = {}) {
-        if (!Number.isInteger(index) || index < 0 || index >= this.pages.length) {
-            return Promise.reject(new RangeError(`papyra: no TIFF page ${JSON.stringify(index)}`));
-        }
-        return this.#native.renderPage(index, {
-            maxPixels: options.maxPixels,
-            maxWidth: options.maxWidth === undefined
-                ? undefined
-                : Math.max(1, Math.floor(options.maxWidth)),
-        });
-    }
+    // The addon's `RenderedPage` is papyra's, typed by napi as a looser object.
+    return new TiffImage((await loadTiff(bytes)));
 }
 //# sourceMappingURL=tiff.js.map

package/dist/tiff.js.map

@@ -1 +1 @@
-{"version":3,"file":"tiff.js","sourceRoot":"","sources":["../src/tiff.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAET,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA6DtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAiB;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,IAAI,SAAS,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,qDAAqD;AACrD,MAAM,OAAO,SAAS;IACpB;;;OAGG;IACM,KAAK,CAAsB;IAC3B,OAAO,CAAkB;IAElC,kDAAkD;IAClD,YAAY,MAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YACpE,WAAW,EAAE,CAAC,CAAC,WAA8B;YAC7C,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CACR,KAAa,EACb,OAAO,GAAsB,EAAE;QAE/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACxE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,UAAU,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EACN,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SAChD,CAA0B,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"tiff.js","sourceRoot":"","sources":["../src/tiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAiB;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,4EAA4E;IAC5E,OAAO,IAAI,SAAS,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAe,CAAC,CAAC;AAC9D,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { JobHandle } from './scheduler.js';
 import type { MatchOptions } from './search.js';
 /** Anything we can turn into PDF bytes. `File` is a `Blob`, so it is covered. */
 export type PdfSource = Uint8Array | ArrayBuffer | ArrayBufferView | Blob;
@@ -107,12 +108,21 @@ export interface RenderedPage {
      */
     readonly data: Uint8Array;
 }
+/**
+ * A rendered page in whichever form its engine produces it.
+ *
+ * papyra's own engine hands back {@link RenderedPage} — RGBA bytes, painted with
+ * `putImageData`. An engine that rasterises somewhere else (pdf.js on an
+ * `OffscreenCanvas`, a host process serving images) hands back an `ImageBitmap`,
+ * which a canvas draws without a copy. {@link paintToCanvas} takes either.
+ */
+export type PageBitmap = RenderedPage | ImageBitmap;
 /** One result from {@link Document.stream}, tagged with the page it came from. */
-export interface StreamedPage {
+export interface StreamedPage<P extends PageBitmap = RenderedPage> {
     /** Index of the page in the document. */
     readonly page: number;
     /** The rendered pixels. */
-    readonly bitmap: RenderedPage;
+    readonly bitmap: P;
 }
 /** Page dimensions in PDF points (1/72 inch). */
 export interface PageSize {
@@ -209,4 +219,14 @@ export interface SearchOptions extends MatchOptions {
     /** Abort the search. Pages already being extracted are left to finish. */
     signal?: AbortSignal;
 }
+/** A queued render, plus whether it was served from cache without rendering at all. */
+export interface RenderHandle<P extends PageBitmap = RenderedPage> extends JobHandle<P> {
+    /**
+     * The page was already in the cache and nothing was queued.
+     *
+     * `promise` still resolves normally, so this only matters for instrumentation —
+     * a cache hit costs none of the ~93ms floor a real render does.
+     */
+    readonly cached: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/workbook.d.ts

@@ -1,70 +1,11 @@
-import { type Sheet as NativeSheet, type Workbook as NativeWorkbook } from '@build-qube/papyra-native';
-import { CellWindow, type MergedRange } from './cells.js';
-import { type CellStyle, type SheetLayout } from './styles.js';
+import { type Workbook, type WorkbookOptions } from './sheets.js';
 import type { PdfSource } from './types.js';
-/**
- * The container a workbook was read from.
- *
- * Macro-enabled and template variants read as their base format: an `.xlsm` is
- * `'xlsx'` here, because to a reader that is what it is.
- */
-export type WorkbookFormat = 'xlsx' | 'xlsb' | 'xls' | 'ods' | 'csv' | 'tsv';
-/** How to read a workbook. Everything is sniffed when left out. */
-export interface WorkbookOptions {
-    /**
-     * Skip sniffing. Only needed to read a file as TSV that was not named `.tsv` —
-     * the binary formats identify themselves, and text is sniffed for its delimiter.
-     * `'xlsm'` is accepted and reads as `'xlsx'`.
-     */
-    format?: WorkbookFormat | 'xlsm';
-    /** CSV and TSV only: the delimiter, a single ASCII character such as `';'`. */
-    delimiter?: string;
-    /**
-     * CSV and TSV only: a WHATWG encoding label, e.g. `'windows-1252'` or
-     * `'shift_jis'`. Without one, a byte-order mark decides, then valid UTF-8, then a
-     * statistical guess.
-     */
-    encoding?: string;
-    /**
-     * Cells to hold per sheet before truncating it to its first whole rows. Defaults
-     * to 8 million — about 400 MB, which a browser tab survives. A sheet that hits it
-     * reports {@link Sheet.truncated}.
-     */
-    maxCells?: number;
-}
-/** Whether a sheet shows in the application's tab bar. */
-export type SheetVisibility = 'visible' | 'hidden' | 'veryHidden';
-/** What a sheet holds. Only worksheets have cells worth showing. */
-export type SheetKind = 'worksheet' | 'chartsheet' | 'dialog' | 'macro' | 'vba';
-/** A sheet's entry in the workbook, known without reading its cells. */
-export interface SheetInfo {
-    /** The name on the sheet's tab. CSV and TSV have one sheet, named `Sheet1`. */
-    name: string;
-    /** What the sheet holds. */
-    kind: SheetKind;
-    /**
-     * `'hidden'` sheets can be unhidden by the user; `'veryHidden'` ones only by a
-     * macro. A viewer usually lists the first and omits the second.
-     */
-    visibility: SheetVisibility;
-}
-/** Rows and columns to read, half-open like `Array.prototype.slice`. */
-export interface WindowRange {
-    /** First row, 0-based. */
-    rowStart: number;
-    /** One past the last row. Clamped to the sheet. */
-    rowEnd: number;
-    /** First column. Defaults to 0. */
-    colStart?: number;
-    /** One past the last column. Defaults to every column. */
-    colEnd?: number;
-}
 /**
  * Open a spreadsheet: Excel (`.xlsx`, `.xlsm`, `.xlsb`, `.xls`), OpenDocument
  * (`.ods`), or delimited text (`.csv`, `.tsv`).
  *
  * Parsing happens in Rust and off the JS thread, and only sheet names are read up
- * front: a sheet's cells are read the first time {@link Workbook.sheet} asks for it.
+ * front: a sheet's cells are read the first time `Workbook.sheet` asks for it.
  *
  * @example
  * ```ts
@@ -74,79 +15,7 @@ export interface WindowRange {
  * cells.text(0, 0); // 'Item'
  * ```
  *
- * @throws {@link EncryptedWorkbookError} when the workbook is password-protected.
+ * @throws `EncryptedWorkbookError` when the workbook is password-protected.
  */
 export declare function openWorkbook(source: PdfSource, options?: WorkbookOptions): Promise<Workbook>;
-/** An opened spreadsheet. Get one from {@link openWorkbook}. */
-export declare class Workbook {
-    #private;
-    /** The container actually read. */
-    readonly format: WorkbookFormat;
-    /** Every sheet in tab order, hidden ones included. */
-    readonly sheets: readonly SheetInfo[];
-    /**
-     * CSV and TSV only: the encoding the text was decoded from, e.g.
-     * `'windows-1252'`. Worth showing when it was guessed — a wrong guess reads as
-     * mojibake, and {@link WorkbookOptions.encoding} is the fix.
-     */
-    readonly encoding: string | undefined;
-    /** CSV and TSV only: the delimiter, given or sniffed. */
-    readonly delimiter: string | undefined;
-    /** @internal — construct via {@link openWorkbook}. */
-    constructor(native: NativeWorkbook);
-    /**
-     * Read one sheet, by index or by name.
-     *
-     * The first call parses the sheet, off the JS thread; later calls for the same
-     * sheet share that result.
-     */
-    sheet(which: number | string): Promise<Sheet>;
-}
-/**
- * One sheet, parsed and held in Rust. Read it a window at a time.
- *
- * Coordinates are the sheet's own and 0-based: row 0 is the row Excel labels 1, and
- * a sheet whose data starts at F10 still reports ten rows and six columns, so a grid
- * draws the data where its author put it.
- */
-export declare class Sheet {
-    #private;
-    /** The name on the sheet's tab. */
-    readonly name: string;
-    /** One past the last row holding a value or covered by a merge. */
-    readonly rows: number;
-    /**
-     * The sheet held more cells than {@link WorkbookOptions.maxCells}, and this is
-     * its first whole rows. Worth saying on screen: the rest of the file is not here.
-     */
-    readonly truncated: boolean;
-    /** One past the last column holding a value or covered by a merge. */
-    readonly cols: number;
-    /**
-     * Merged regions. The value lives in each one's top-left cell; the others are
-     * empty. Always empty for `.xlsb` and `.ods`, which calamine does not read
-     * merges from.
-     */
-    readonly merges: readonly MergedRange[];
-    /**
-     * The styles {@link CellWindow.style} indexes into, with the default at 0.
-     * xlsx only: empty for every other format, whose cells all read as style 0.
-     */
-    readonly styles: readonly CellStyle[];
-    /**
-     * Column widths and row heights as the author set them. xlsx only; for anything
-     * else a grid sizes columns itself.
-     */
-    readonly layout: SheetLayout | undefined;
-    /** @internal — construct via {@link Workbook.sheet}. */
-    constructor(native: NativeSheet);
-    /**
-     * Read a rectangle of cells, clamped to the sheet.
-     *
-     * Synchronous, because the sheet is already parsed and the cost is the size of
-     * the window. Ask for what is on screen plus some overscan, not the whole sheet:
-     * a screenful is a few thousand cells and well under a millisecond.
-     */
-    window(range: WindowRange): CellWindow;
-}
 //# sourceMappingURL=workbook.d.ts.map

package/dist/workbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbook.d.ts","sourceRoot":"","sources":["../src/workbook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workbook.d.ts","sourceRoot":"","sources":["../src/workbook.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAEnB"}

package/dist/workbook.js

@@ -1,14 +1,11 @@
-import { loadWorkbook, } from '@build-qube/papyra-native';
-import { CellWindow, toMergedRanges } from './cells.js';
-import { rethrowLoadError } from './errors.js';
-import { toBytes } from './source.js';
-import { toCellStyle, toSheetLayout, } from './styles.js';
+import { loadWorkbook } from '@build-qube/papyra-native';
+import { openWorkbookWith, } from './sheets.js';
 /**
  * Open a spreadsheet: Excel (`.xlsx`, `.xlsm`, `.xlsb`, `.xls`), OpenDocument
  * (`.ods`), or delimited text (`.csv`, `.tsv`).
  *
  * Parsing happens in Rust and off the JS thread, and only sheet names are read up
- * front: a sheet's cells are read the first time {@link Workbook.sheet} asks for it.
+ * front: a sheet's cells are read the first time `Workbook.sheet` asks for it.
  *
  * @example
  * ```ts
@@ -18,141 +15,9 @@ import { toCellStyle, toSheetLayout, } from './styles.js';
  * cells.text(0, 0); // 'Item'
  * ```
  *
- * @throws {@link EncryptedWorkbookError} when the workbook is password-protected.
+ * @throws `EncryptedWorkbookError` when the workbook is password-protected.
  */
-export async function openWorkbook(source, options = {}) {
-    const bytes = await toBytes(source);
-    const format = options.format ?? formatFromName(source);
-    try {
-        const native = await loadWorkbook(bytes, { ...options, format });
-        return new Workbook(native);
-    }
-    catch (error) {
-        rethrowLoadError(error);
-    }
-}
-/**
- * A `File` named `.tsv` is TSV whatever its contents sniff as.
- *
- * Only that one extension is trusted. The binary formats announce themselves in
- * their first bytes, and a `.xls` downloaded from a web app is as often an HTML
- * table or a CSV as it is BIFF — believing the name would refuse a readable file.
- */
-function formatFromName(source) {
-    const name = source.name;
-    return typeof name === 'string' && /\.(tsv|tab)$/i.test(name)
-        ? 'tsv'
-        : undefined;
-}
-/** An opened spreadsheet. Get one from {@link openWorkbook}. */
-export class Workbook {
-    /** The container actually read. */
-    format;
-    /** Every sheet in tab order, hidden ones included. */
-    sheets;
-    /**
-     * CSV and TSV only: the encoding the text was decoded from, e.g.
-     * `'windows-1252'`. Worth showing when it was guessed — a wrong guess reads as
-     * mojibake, and {@link WorkbookOptions.encoding} is the fix.
-     */
-    encoding;
-    /** CSV and TSV only: the delimiter, given or sniffed. */
-    delimiter;
-    #native;
-    #sheets = new Map();
-    /** @internal — construct via {@link openWorkbook}. */
-    constructor(native) {
-        this.#native = native;
-        this.format = native.format;
-        this.sheets = native.sheets.map((s) => ({
-            name: s.name,
-            kind: s.kind,
-            visibility: s.visibility,
-        }));
-        this.encoding = native.encoding ?? undefined;
-        this.delimiter = native.delimiter ?? undefined;
-    }
-    /**
-     * Read one sheet, by index or by name.
-     *
-     * The first call parses the sheet, off the JS thread; later calls for the same
-     * sheet share that result.
-     */
-    sheet(which) {
-        const index = typeof which === 'number'
-            ? which
-            : this.sheets.findIndex((s) => s.name === which);
-        if (!Number.isInteger(index) || index < 0 || index >= this.sheets.length) {
-            return Promise.reject(new RangeError(`papyra: no sheet ${JSON.stringify(which)}`));
-        }
-        let sheet = this.#sheets.get(index);
-        if (!sheet) {
-            sheet = this.#native.sheet(index).then((native) => new Sheet(native));
-            // A failed read is not cached, so a retry gets a fresh attempt.
-            sheet.catch(() => this.#sheets.delete(index));
-            this.#sheets.set(index, sheet);
-        }
-        return sheet;
-    }
-}
-/**
- * One sheet, parsed and held in Rust. Read it a window at a time.
- *
- * Coordinates are the sheet's own and 0-based: row 0 is the row Excel labels 1, and
- * a sheet whose data starts at F10 still reports ten rows and six columns, so a grid
- * draws the data where its author put it.
- */
-export class Sheet {
-    /** The name on the sheet's tab. */
-    name;
-    /** One past the last row holding a value or covered by a merge. */
-    rows;
-    /**
-     * The sheet held more cells than {@link WorkbookOptions.maxCells}, and this is
-     * its first whole rows. Worth saying on screen: the rest of the file is not here.
-     */
-    truncated;
-    /** One past the last column holding a value or covered by a merge. */
-    cols;
-    /**
-     * Merged regions. The value lives in each one's top-left cell; the others are
-     * empty. Always empty for `.xlsb` and `.ods`, which calamine does not read
-     * merges from.
-     */
-    merges;
-    /**
-     * The styles {@link CellWindow.style} indexes into, with the default at 0.
-     * xlsx only: empty for every other format, whose cells all read as style 0.
-     */
-    styles;
-    /**
-     * Column widths and row heights as the author set them. xlsx only; for anything
-     * else a grid sizes columns itself.
-     */
-    layout;
-    #native;
-    /** @internal — construct via {@link Workbook.sheet}. */
-    constructor(native) {
-        this.#native = native;
-        this.name = native.name;
-        this.rows = native.rows;
-        this.truncated = native.truncated;
-        this.cols = native.cols;
-        this.merges = toMergedRanges(native.merges);
-        this.styles = native.styles.map(toCellStyle);
-        this.layout = native.layout ? toSheetLayout(native.layout) : undefined;
-    }
-    /**
-     * Read a rectangle of cells, clamped to the sheet.
-     *
-     * Synchronous, because the sheet is already parsed and the cost is the size of
-     * the window. Ask for what is on screen plus some overscan, not the whole sheet:
-     * a screenful is a few thousand cells and well under a millisecond.
-     */
-    window(range) {
-        // The bindings take u32s, which a negative overscan would wrap rather than clamp.
-        const at = (n) => Math.max(0, Math.floor(n));
-        return new CellWindow(this.#native.window(at(range.rowStart), at(range.rowEnd), at(range.colStart ?? 0), at(range.colEnd ?? this.cols)));
-    }
+export function openWorkbook(source, options = {}) {
+    return openWorkbookWith(loadWorkbook, source, options);
 }
 //# sourceMappingURL=workbook.js.map

package/dist/workbook.js.map

@@ -1 +1 @@
-{"version":3,"file":"workbook.js","sourceRoot":"","sources":["../src/workbook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workbook.js","sourceRoot":"","sources":["../src/workbook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,OAAO,GAAoB,EAAE;IAE7B,OAAO,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}