@build-qube/papyra 0.5.0 → 0.7.0

package/dist/sheets.d.ts

@@ -0,0 +1,160 @@
+import type { Sheet as NativeSheet, 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 { 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;
+}
+/**
+ * What a {@link Sheet} reads: papyra's own addon, or another host holding the file —
+ * a Tauri app's, through `@build-qube/papyra-tauri`. `window` stays synchronous, so a
+ * remote host answers it from cells it already fetched.
+ */
+export type SheetSource = Pick<NativeSheet, 'name' | 'rows' | 'cols' | 'truncated' | 'merges' | 'styles' | 'layout' | 'window'>;
+/** What a {@link Workbook} reads, in the addon's shapes. See {@link SheetSource}. */
+export interface WorkbookSource extends Pick<NativeWorkbook, 'format' | 'sheets' | 'encoding' | 'delimiter'> {
+    /** Parse one sheet. */
+    sheet(index: number): Promise<SheetSource>;
+    /** Free the workbook where it is held. Absent where the garbage collector does. */
+    close?(): Promise<void>;
+}
+/**
+ * `openWorkbook` over any {@link WorkbookSource}: the bytes, the `.tsv` rule and the
+ * typed errors, whoever does the parsing.
+ *
+ * @internal For papyra's own `openWorkbook` and other hosts'.
+ */
+export declare function openWorkbookWith(load: (bytes: Uint8Array, options: WorkbookOptions) => Promise<WorkbookSource>, source: PdfSource, options?: WorkbookOptions): Promise<Workbook>;
+/** An opened spreadsheet. Get one from `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 `openWorkbook`. */
+    constructor(native: WorkbookSource);
+    /**
+     * 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>;
+    /**
+     * Free the workbook. 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. Sheets already read keep their cells.
+     */
+    close(): Promise<void>;
+}
+/**
+ * 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: SheetSource);
+    /**
+     * 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=sheets.d.ts.map

package/dist/sheets.d.ts.map

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

package/dist/sheets.js

@@ -0,0 +1,153 @@
+import { CellWindow, toMergedRanges } from './cells.js';
+import { rethrowLoadError } from './errors.js';
+import { toBytes } from './source.js';
+import { toCellStyle, toSheetLayout, } from './styles.js';
+/**
+ * `openWorkbook` over any {@link WorkbookSource}: the bytes, the `.tsv` rule and the
+ * typed errors, whoever does the parsing.
+ *
+ * @internal For papyra's own `openWorkbook` and other hosts'.
+ */
+export async function openWorkbookWith(load, source, options = {}) {
+    const bytes = await toBytes(source);
+    const format = options.format ?? formatFromName(source);
+    try {
+        return new Workbook(await load(bytes, { ...options, format }));
+    }
+    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 `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 `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;
+    }
+    /**
+     * Free the workbook. 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. Sheets already read keep their cells.
+     */
+    async close() {
+        await this.#native.close?.();
+    }
+}
+/**
+ * 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)));
+    }
+}
+//# sourceMappingURL=sheets.js.map

package/dist/sheets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.js","sourceRoot":"","sources":["../src/sheets.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAoB,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAGL,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AA4FrB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAG4B,EAC5B,MAAiB,EACjB,OAAO,GAAoB,EAAE;IAE7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,OAAO,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,MAAiB;IACvC,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAC;IACjD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,OAAO,QAAQ;IACnB,mCAAmC;IAC1B,MAAM,CAAiB;IAChC,sDAAsD;IAC7C,MAAM,CAAuB;IACtC;;;;OAIG;IACM,QAAQ,CAAqB;IACtC,yDAAyD;IAChD,SAAS,CAAqB;IAC9B,OAAO,CAAiB;IACxB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,gDAAgD;IAChD,YAAY,MAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAwB,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAiB;YACzB,UAAU,EAAE,CAAC,CAAC,UAA6B;SAC5C,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAsB;QAC1B,MAAM,KAAK,GACT,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACzE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,UAAU,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAC5D,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YACtE,gEAAgE;YAChE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IAChB,mCAAmC;IAC1B,IAAI,CAAS;IACtB,mEAAmE;IAC1D,IAAI,CAAS;IACtB;;;OAGG;IACM,SAAS,CAAU;IAC5B,sEAAsE;IAC7D,IAAI,CAAS;IACtB;;;;OAIG;IACM,MAAM,CAAyB;IACxC;;;OAGG;IACM,MAAM,CAAuB;IACtC;;;OAGG;IACM,MAAM,CAA0B;IAChC,OAAO,CAAc;IAE9B,wDAAwD;IACxD,YAAY,MAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAkB;QACvB,kFAAkF;QAClF,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,UAAU,CACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CACjB,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAClB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAChB,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,EACvB,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAC9B,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/tiff-image.d.ts

@@ -0,0 +1,97 @@
+import type { TiffRenderOptions as NativeTiffRenderOptions, TiffPageInfo } from '@build-qube/papyra-native';
+import type { PageBitmap, 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;
+/**
+ * What a {@link TiffImage} reads: papyra's own addon, or another host holding the
+ * file — a Tauri app's, through `@build-qube/papyra-tauri`.
+ */
+export interface TiffSource<P extends PageBitmap = RenderedPage> {
+    /** Every page, in the addon's shape. */
+    readonly pages: readonly TiffPageInfo[];
+    /** Decode one page at no more than the given size. */
+    renderPage(index: number, options?: NativeTiffRenderOptions): Promise<P>;
+    /** Free the file where it is held. Absent where the garbage collector does. */
+    close?(): Promise<void>;
+}
+/**
+ * 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 declare class TiffImage<P extends PageBitmap = RenderedPage> {
+    #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 `openTiff`. */
+    constructor(native: TiffSource<P>);
+    /** 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<P>;
+    /**
+     * 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.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=tiff-image.d.ts.map

package/dist/tiff-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiff-image.d.ts","sourceRoot":"","sources":["../src/tiff-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,IAAI,uBAAuB,EAC5C,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;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;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,YAAY;IAC7D,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,sDAAsD;IACtD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,+EAA+E;IAC/E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,UAAU,GAAG,YAAY;;IACxD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAGpC,4CAA4C;IAC5C,YAAY,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAWhC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAarE;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

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