@build-qube/papyra 0.3.0 → 0.4.0

package/dist/cells.d.ts

@@ -0,0 +1,148 @@
+import type { CellWindow as NativeCellWindow } from '@build-qube/papyra-native';
+/** What a cell holds. A formula cell reports the result Excel last computed. */
+export type CellKind = 'empty' | 'number' | 'text' | 'bool' | 'date' | 'duration' | 'error';
+/** A cell with nothing in it, or outside the sheet's used range. */
+export interface EmptyCell {
+    /** Always `'empty'`. */
+    kind: 'empty';
+    /** Always `''`. */
+    text: '';
+}
+/** A number, or in CSV a field that is unambiguously one. */
+export interface NumberCell {
+    /** Always `'number'`. */
+    kind: 'number';
+    /** The value. */
+    value: number;
+    /**
+     * Excel's General rendering for a workbook. For CSV, the field exactly as
+     * written: `2.50` stays `2.50`.
+     */
+    text: string;
+}
+/** A string. Every CSV field that is not a plain number is one. */
+export interface TextCell {
+    /** Always `'text'`. */
+    kind: 'text';
+    /** The string. */
+    text: string;
+}
+/** A boolean. */
+export interface BoolCell {
+    /** Always `'bool'`. */
+    kind: 'bool';
+    /** The value. */
+    value: boolean;
+    /** Excel's spelling, which is also what a CSV export of the cell contains. */
+    text: 'TRUE' | 'FALSE';
+}
+/** A date, a time, or both. */
+export interface DateCell {
+    /** Always `'date'`. */
+    kind: 'date';
+    /**
+     * The Excel date serial: days since 1899-12-30, time as the fraction. NaN for
+     * OpenDocument, which stores only the ISO form.
+     */
+    serial: number;
+    /** `2024-03-15`, `2024-03-15T13:30:00`, or `13:30:00` for a time alone. */
+    text: string;
+}
+/** A length of time. */
+export interface DurationCell {
+    /** Always `'duration'`. */
+    kind: 'duration';
+    /** Length in days. NaN for OpenDocument, which stores only the text form. */
+    days: number;
+    /** `[h]:mm:ss` — hours do not wrap at 24. */
+    text: string;
+}
+/** An error a formula evaluated to. */
+export interface ErrorCell {
+    /** Always `'error'`. */
+    kind: 'error';
+    /** Excel's code for it, e.g. `#DIV/0!`. */
+    text: string;
+}
+/**
+ * One cell's value, discriminated on `kind`.
+ *
+ * `text` is always what to display. Number formats are not applied yet, so a
+ * currency cell reads `1234.5` rather than `$1,234.50` and a date reads as ISO 8601
+ * — the raw value is beside it for anything that needs to compute.
+ */
+export type Cell = EmptyCell | NumberCell | TextCell | BoolCell | DateCell | DurationCell | ErrorCell;
+/**
+ * Cells merged into one, as a sheet reports them. Inclusive at both ends, like the
+ * `A4:B4` Excel would write — hence `lastRow` rather than an exclusive `rowEnd`.
+ */
+export interface MergedRange {
+    /** 0-based row of the top-left cell, which holds the value. */
+    row: number;
+    /** 0-based column of the top-left cell. */
+    col: number;
+    /** Last row covered, inclusive. */
+    lastRow: number;
+    /** Last column covered, inclusive. */
+    lastCol: number;
+}
+/**
+ * A rectangle of a sheet, read in one call and decoded on access.
+ *
+ * Cells cross from Rust as four flat buffers rather than an object each, because
+ * building thousands of objects costs more than parsing them did. Nothing is
+ * decoded until asked for, so a grid that only draws text never builds a {@link Cell}.
+ *
+ * Coordinates are the sheet's, not the window's: `text(10, 2)` is row 10 of the
+ * sheet whichever row the window starts on. Anything outside the window is empty.
+ */
+export declare class CellWindow {
+    #private;
+    /** First row held. */
+    readonly rowStart: number;
+    /** First column held. */
+    readonly colStart: number;
+    /** Rows held, which may be fewer than asked for at the sheet's edge. */
+    readonly rows: number;
+    /** Columns held. */
+    readonly cols: number;
+    /** @internal Use `Sheet.window`. */
+    constructor(native: NativeCellWindow);
+    /** One past the last row held. */
+    get rowEnd(): number;
+    /** One past the last column held. */
+    get colEnd(): number;
+    /** What the cell at `(row, col)` holds. Cheaper than {@link cell}. */
+    kind(row: number, col: number): CellKind;
+    /** The display text at `(row, col)` — all a plain grid needs. */
+    text(row: number, col: number): string;
+    /**
+     * The numeric value at `(row, col)`: a number, a bool as 0 or 1, a date's serial,
+     * a duration in days. NaN for anything else.
+     */
+    number(row: number, col: number): number;
+    /**
+     * The index of the cell's style in `Sheet.styles`. 0, the default, for a cell
+     * with none — and for every cell of a format that carries no styles.
+     */
+    style(row: number, col: number): number;
+    /**
+     * The colour the cell's number format chose, as `0xRRGGBB` — the `[Red]` in
+     * `#,##0;[Red](#,##0)`. It overrides the style's text colour, as in Excel.
+     */
+    color(row: number, col: number): number | undefined;
+    /** The cell at `(row, col)`, fully decoded. */
+    cell(row: number, col: number): Cell;
+}
+/** Unpack the bindings' flat merge quads. @internal */
+export declare function toMergedRanges(quads: Uint32Array): MergedRange[];
+/**
+ * The letters Excel heads a column with: 0 is `A`, 25 is `Z`, 26 is `AA`.
+ *
+ * @example
+ * ```ts
+ * columnName(27); // 'AB'
+ * ```
+ */
+export declare function columnName(index: number): string;
+//# sourceMappingURL=cells.d.ts.map

package/dist/cells.d.ts.map

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

package/dist/cells.js

@@ -0,0 +1,144 @@
+/** Indexed by the tag byte the bindings write. Keep in step with `CellKind` in Rust. */
+const KINDS = [
+    'empty',
+    'number',
+    'text',
+    'bool',
+    'date',
+    'duration',
+    'error',
+];
+/**
+ * A rectangle of a sheet, read in one call and decoded on access.
+ *
+ * Cells cross from Rust as four flat buffers rather than an object each, because
+ * building thousands of objects costs more than parsing them did. Nothing is
+ * decoded until asked for, so a grid that only draws text never builds a {@link Cell}.
+ *
+ * Coordinates are the sheet's, not the window's: `text(10, 2)` is row 10 of the
+ * sheet whichever row the window starts on. Anything outside the window is empty.
+ */
+export class CellWindow {
+    /** First row held. */
+    rowStart;
+    /** First column held. */
+    colStart;
+    /** Rows held, which may be fewer than asked for at the sheet's edge. */
+    rows;
+    /** Columns held. */
+    cols;
+    #native;
+    /** @internal Use `Sheet.window`. */
+    constructor(native) {
+        this.#native = native;
+        this.rowStart = native.rowStart;
+        this.colStart = native.colStart;
+        this.rows = native.rows;
+        this.cols = native.cols;
+    }
+    /** One past the last row held. */
+    get rowEnd() {
+        return this.rowStart + this.rows;
+    }
+    /** One past the last column held. */
+    get colEnd() {
+        return this.colStart + this.cols;
+    }
+    #index(row, col) {
+        const r = row - this.rowStart;
+        const c = col - this.colStart;
+        if (r < 0 || c < 0 || r >= this.rows || c >= this.cols)
+            return -1;
+        return r * this.cols + c;
+    }
+    /** What the cell at `(row, col)` holds. Cheaper than {@link cell}. */
+    kind(row, col) {
+        const i = this.#index(row, col);
+        return i < 0 ? 'empty' : (KINDS[this.#native.kinds[i] ?? 0] ?? 'empty');
+    }
+    /** The display text at `(row, col)` — all a plain grid needs. */
+    text(row, col) {
+        const i = this.#index(row, col);
+        if (i < 0)
+            return '';
+        const { offsets, text } = this.#native;
+        return text.slice(offsets[i], offsets[i + 1]);
+    }
+    /**
+     * The numeric value at `(row, col)`: a number, a bool as 0 or 1, a date's serial,
+     * a duration in days. NaN for anything else.
+     */
+    number(row, col) {
+        const i = this.#index(row, col);
+        return i < 0 ? Number.NaN : (this.#native.numbers[i] ?? Number.NaN);
+    }
+    /**
+     * The index of the cell's style in `Sheet.styles`. 0, the default, for a cell
+     * with none — and for every cell of a format that carries no styles.
+     */
+    style(row, col) {
+        const i = this.#index(row, col);
+        return i < 0 ? 0 : (this.#native.styles[i] ?? 0);
+    }
+    /**
+     * The colour the cell's number format chose, as `0xRRGGBB` — the `[Red]` in
+     * `#,##0;[Red](#,##0)`. It overrides the style's text colour, as in Excel.
+     */
+    color(row, col) {
+        const i = this.#index(row, col);
+        const c = i < 0 ? 0 : (this.#native.colors[i] ?? 0);
+        return c === 0 ? undefined : c & 0xffffff;
+    }
+    /** The cell at `(row, col)`, fully decoded. */
+    cell(row, col) {
+        const kind = this.kind(row, col);
+        const text = this.text(row, col);
+        const n = this.number(row, col);
+        switch (kind) {
+            case 'empty':
+                return { kind, text: '' };
+            case 'number':
+                return { kind, value: n, text };
+            case 'bool':
+                return n === 1
+                    ? { kind, value: true, text: 'TRUE' }
+                    : { kind, value: false, text: 'FALSE' };
+            case 'date':
+                return { kind, serial: n, text };
+            case 'duration':
+                return { kind, days: n, text };
+            case 'text':
+            case 'error':
+                return { kind, text };
+        }
+    }
+}
+/** Unpack the bindings' flat merge quads. @internal */
+export function toMergedRanges(quads) {
+    const out = [];
+    for (let i = 0; i + 3 < quads.length; i += 4) {
+        out.push({
+            row: quads[i] ?? 0,
+            col: quads[i + 1] ?? 0,
+            lastRow: quads[i + 2] ?? 0,
+            lastCol: quads[i + 3] ?? 0,
+        });
+    }
+    return out;
+}
+/**
+ * The letters Excel heads a column with: 0 is `A`, 25 is `Z`, 26 is `AA`.
+ *
+ * @example
+ * ```ts
+ * columnName(27); // 'AB'
+ * ```
+ */
+export function columnName(index) {
+    let name = '';
+    for (let n = Math.floor(index) + 1; n > 0; n = Math.floor((n - 1) / 26)) {
+        name = String.fromCharCode(65 + ((n - 1) % 26)) + name;
+    }
+    return name;
+}
+//# sourceMappingURL=cells.js.map

package/dist/cells.js.map

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

package/dist/errors.d.ts

@@ -36,6 +36,18 @@ export declare class IncorrectPasswordError extends PasswordError {
     readonly retry = true;
     constructor(message?: string);
 }
+/**
+ * A spreadsheet that is password-protected.
+ *
+ * Deliberately not a {@link PasswordError}: Excel encrypts the whole package, and
+ * there is no decryption here to hand a password to, so a dialog asking for one
+ * would only fail again. Show that the file is protected, and stop.
+ */
+export declare class EncryptedWorkbookError extends Error {
+    /** Always `'EncryptedWorkbookError'`. */
+    readonly name = "EncryptedWorkbookError";
+    constructor(message?: string);
+}
 /**
  * Rethrow a load failure as itself, or as the typed error it was tagged as.
  *

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAS;CACjC;AAED,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,wCAAwC;IACxC,SAAkB,IAAI,2BAA2B;IACjD,SAAkB,KAAK,SAAS;IAChC,YAAY,OAAO,SAAmC,EAErD;CACF;AAED,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,yCAAyC;IACzC,SAAkB,IAAI,4BAA4B;IAClD,SAAkB,KAAK,QAAQ;IAC/B,YAAY,OAAO,SAAuC,EAEzD;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQtD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAS;CACjC;AAED,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,wCAAwC;IACxC,SAAkB,IAAI,2BAA2B;IACjD,SAAkB,KAAK,SAAS;IAChC,YAAY,OAAO,SAAmC,EAErD;CACF;AAED,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,yCAAyC;IACzC,SAAkB,IAAI,4BAA4B;IAClD,SAAkB,KAAK,QAAQ;IAC/B,YAAY,OAAO,SAAuC,EAEzD;CACF;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,yCAAyC;IACzC,SAAkB,IAAI,4BAA4B;IAClD,YAAY,OAAO,SAAwC,EAE1D;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQtD"}

package/dist/errors.js

@@ -4,11 +4,13 @@
  * napi-rs gives every error it throws the same `code`, so the message is the only
  * channel a typed failure can travel through. These are stripped before the error
  * reaches a caller — keep them in step with `TAG_PASSWORD_REQUIRED` and
- * `TAG_INCORRECT_PASSWORD` in `packages/bindings/src/lib.rs`.
+ * `TAG_INCORRECT_PASSWORD` in `packages/bindings/src/lib.rs`, and `TAG_ENCRYPTED` in
+ * `packages/bindings/src/tables.rs`.
  */
 const TAGS = {
     'papyra/password-required': (message) => new PasswordRequiredError(message),
     'papyra/incorrect-password': (message) => new IncorrectPasswordError(message),
+    'papyra/encrypted-workbook': (message) => new EncryptedWorkbookError(message),
 };
 /**
  * A document that could not be opened because of its password.
@@ -52,6 +54,20 @@ export class IncorrectPasswordError extends PasswordError {
         super(message);
     }
 }
+/**
+ * A spreadsheet that is password-protected.
+ *
+ * Deliberately not a {@link PasswordError}: Excel encrypts the whole package, and
+ * there is no decryption here to hand a password to, so a dialog asking for one
+ * would only fail again. Show that the file is protected, and stop.
+ */
+export class EncryptedWorkbookError extends Error {
+    /** Always `'EncryptedWorkbookError'`. */
+    name = 'EncryptedWorkbookError';
+    constructor(message = 'this workbook is password-protected') {
+        super(message);
+    }
+}
 /**
  * Rethrow a load failure as itself, or as the typed error it was tagged as.
  *

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,IAAI,GAAG;IACX,0BAA0B,EAAE,CAAC,OAAe,EAAE,EAAE,CAC9C,IAAI,qBAAqB,CAAC,OAAO,CAAC;IACpC,2BAA2B,EAAE,CAAC,OAAe,EAAE,EAAE,CAC/C,IAAI,sBAAsB,CAAC,OAAO,CAAC;CAC7B,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;;;;OAIG;IACM,KAAK,GAAY,KAAK,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,wCAAwC;IACtB,IAAI,GAAG,uBAAuB,CAAC;IAC/B,KAAK,GAAG,KAAK,CAAC;IAChC,YAAY,OAAO,GAAG,gCAAgC;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,yCAAyC;IACvB,IAAI,GAAG,wBAAwB,CAAC;IAChC,KAAK,GAAG,IAAI,CAAC;IAC/B,YAAY,OAAO,GAAG,oCAAoC;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,IAAI,GAAG;IACX,0BAA0B,EAAE,CAAC,OAAe,EAAE,EAAE,CAC9C,IAAI,qBAAqB,CAAC,OAAO,CAAC;IACpC,2BAA2B,EAAE,CAAC,OAAe,EAAE,EAAE,CAC/C,IAAI,sBAAsB,CAAC,OAAO,CAAC;IACrC,2BAA2B,EAAE,CAAC,OAAe,EAAE,EAAE,CAC/C,IAAI,sBAAsB,CAAC,OAAO,CAAC;CAC7B,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;;;;OAIG;IACM,KAAK,GAAY,KAAK,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,wCAAwC;IACtB,IAAI,GAAG,uBAAuB,CAAC;IAC/B,KAAK,GAAG,KAAK,CAAC;IAChC,YAAY,OAAO,GAAG,gCAAgC;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,yCAAyC;IACvB,IAAI,GAAG,wBAAwB,CAAC;IAChC,KAAK,GAAG,IAAI,CAAC;IAC/B,YAAY,OAAO,GAAG,oCAAoC;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,yCAAyC;IACvB,IAAI,GAAG,wBAAwB,CAAC;IAClD,YAAY,OAAO,GAAG,qCAAqC;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * papyra — fast PDF rendering for Node and the browser.
+ * papyra — fast PDF rendering for Node and the browser, and spreadsheets and TIFF
+ * scans beside it.
  *
  * ```ts
  * import { open, paintToCanvas } from '@build-qube/papyra';
@@ -18,11 +19,13 @@ export { attachmentMediaType, isInvoiceAttachment, } from './attachments.js';
 export type { CacheStats } from './cache.js';
 export type { PaintOptions } from './canvas.js';
 export { paintToCanvas, toImageData } from './canvas.js';
+export type { BoolCell, Cell, CellKind, DateCell, DurationCell, EmptyCell, ErrorCell, MergedRange, NumberCell, TextCell, } from './cells.js';
+export { CellWindow, columnName } from './cells.js';
 export type { ImageHandle, RenderHandle, SvgHandle } from './document.js';
 export { Document, open } from './document.js';
 export type { EncodedFormat, EncodedImage, EncodeOptions, RasterFormat, SvgPage, } from './encode.js';
 export { encode, encodedImage, mimeType, PageImage, svgPage, } from './encode.js';
-export { IncorrectPasswordError, PasswordError, PasswordRequiredError, } from './errors.js';
+export { EncryptedWorkbookError, IncorrectPasswordError, PasswordError, PasswordRequiredError, } from './errors.js';
 export type { LinkTarget, PageLink } from './links.js';
 export type { DestinationKind, OutlineDestination, OutlineNode, } from './outline.js';
 export { buildOutlineTree, walkOutline } from './outline.js';
@@ -34,9 +37,15 @@ export type { MatchOptions, SearchMatch } from './search.js';
 export { findRanges, searchPageText } from './search.js';
 export type { MarkedContent, OrderedLine, StructNode, } from './structure.js';
 export { buildStructTree, readingOrder, structuredPageString, walkStructTree, } from './structure.js';
+export type { BorderEdge, BorderStyle, CellStyle, ColumnSpan, HorizontalAlign, RowSize, SheetLayout, VerticalAlign, } from './styles.js';
+export { cssColor } from './styles.js';
 export type { PageText, Quad, Rect, TextLine } from './text.js';
 export { lineQuad, pageString, quadBounds, scaleQuad, scaleRect, } from './text.js';
+export type { TiffCompression, TiffPage, TiffRenderOptions, } from './tiff.js';
+export { openTiff, TIFF_MAX_PIXELS, TiffImage } from './tiff.js';
 export type { DocumentMetadata, OpenOptions, PageSize, PdfSource, RenderedPage, RenderOptions, SearchOptions, StreamedPage, StreamOptions, SvgOptions, } from './types.js';
 export type { Rotation, Viewport, ViewportOptions } from './viewport.js';
 export { rotatePage, rotateSize, viewport, viewportQuad, viewportRect, } from './viewport.js';
+export type { SheetInfo, SheetKind, SheetVisibility, WindowRange, WorkbookFormat, WorkbookOptions, } from './workbook.js';
+export { openWorkbook, Sheet, Workbook } from './workbook.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,OAAO,EACP,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,eAAe,EACf,QAAQ,EACR,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 /**
- * papyra — fast PDF rendering for Node and the browser.
+ * papyra — fast PDF rendering for Node and the browser, and spreadsheets and TIFF
+ * scans beside it.
  *
  * ```ts
  * import { open, paintToCanvas } from '@build-qube/papyra';
@@ -15,14 +16,18 @@
  */
 export { attachmentMediaType, isInvoiceAttachment, } from './attachments.js';
 export { paintToCanvas, toImageData } from './canvas.js';
+export { CellWindow, columnName } from './cells.js';
 export { Document, open } from './document.js';
 export { encode, encodedImage, mimeType, PageImage, svgPage, } from './encode.js';
-export { IncorrectPasswordError, PasswordError, PasswordRequiredError, } from './errors.js';
+export { EncryptedWorkbookError, IncorrectPasswordError, PasswordError, PasswordRequiredError, } from './errors.js';
 export { buildOutlineTree, walkOutline } from './outline.js';
 export { backend, currentRuntime, hardwareConcurrency, init, } from './runtime.js';
 export { AbortError, DEFAULT_PRIORITY } from './scheduler.js';
 export { findRanges, searchPageText } from './search.js';
 export { buildStructTree, readingOrder, structuredPageString, walkStructTree, } from './structure.js';
+export { cssColor } from './styles.js';
 export { lineQuad, pageString, quadBounds, scaleQuad, scaleRect, } from './text.js';
+export { openTiff, TIFF_MAX_PIXELS, TiffImage } from './tiff.js';
 export { rotatePage, rotateSize, viewport, viewportQuad, viewportRect, } from './viewport.js';
+export { openWorkbook, Sheet, Workbook } from './workbook.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAQ/C,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMzD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AAcnB,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAazD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAQ/C,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMzD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AAMnB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAcjE,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/styles.d.ts

@@ -0,0 +1,96 @@
+import type { CellStyle as NativeCellStyle, SheetLayout as NativeSheetLayout } from '@build-qube/papyra-native';
+/** How one edge of a border is drawn. Dash-dot variants arrive as `'dashed'`. */
+export type BorderStyle = 'thin' | 'medium' | 'thick' | 'dashed' | 'dotted' | 'double' | 'hair';
+/** One edge of a cell's border. */
+export interface BorderEdge {
+    /** The line. */
+    style: BorderStyle;
+    /** `0xRRGGBB`. Absent means automatic, which Excel draws black. */
+    color?: number;
+}
+/** Horizontal alignment. Absent means Excel's default: text left, numbers right. */
+export type HorizontalAlign = 'left' | 'center' | 'right' | 'justify' | 'centerContinuous' | 'fill' | 'distributed';
+/** Vertical alignment. Absent means bottom. */
+export type VerticalAlign = 'top' | 'center' | 'bottom' | 'justify' | 'distributed';
+/**
+ * How a cell looks, apart from its number format — which is already applied to the
+ * text. Sheets share styles by index: see {@link CellWindow.style}.
+ *
+ * Colours are `0xRRGGBB` numbers; {@link cssColor} turns one into CSS. An absent
+ * colour means "automatic", which is the reader's to choose — black on white in
+ * Excel, but whatever the page's own text colour is in a dark theme.
+ */
+export interface CellStyle {
+    /** Bold text. */
+    bold: boolean;
+    /** Italic text. */
+    italic: boolean;
+    /** Underlined text. */
+    underline: boolean;
+    /** Struck-through text. */
+    strike: boolean;
+    /** Font size relative to the workbook's default font: 2 is twice the size. */
+    fontScale: number;
+    /** Text colour. Absent means automatic. */
+    color?: number;
+    /** Background. Absent means none. */
+    fill?: number;
+    /** Top border. */
+    borderTop?: BorderEdge;
+    /** Right border. */
+    borderRight?: BorderEdge;
+    /** Bottom border. */
+    borderBottom?: BorderEdge;
+    /** Left border. */
+    borderLeft?: BorderEdge;
+    /** Horizontal alignment. */
+    horizontal?: HorizontalAlign;
+    /** Vertical alignment. */
+    vertical?: VerticalAlign;
+    /** Wrap text onto further lines within the row's height. */
+    wrap: boolean;
+    /** Indent level. Excel draws each as roughly three characters. */
+    indent: number;
+}
+/** Columns sharing a width, inclusive at both ends. */
+export interface ColumnSpan {
+    /** First column, 0-based. */
+    first: number;
+    /** Last column, inclusive. Often 16383 — "to the end of the sheet". */
+    last: number;
+    /** Pixels at 96 DPI. 0 means hidden. */
+    width: number;
+}
+/** A row with a height of its own. */
+export interface RowSize {
+    /** The row, 0-based. */
+    row: number;
+    /** Pixels at 96 DPI. 0 means hidden. */
+    height: number;
+}
+/**
+ * Column widths and row heights as the author left them, in pixels at 96 DPI —
+ * Excel's own geometry, so a 64px default column is 64px here.
+ */
+export interface SheetLayout {
+    /** Width of a column with no span of its own. */
+    defaultColWidth: number;
+    /** Height of a row with no size of its own. */
+    defaultRowHeight: number;
+    /** Columns with their own width, in the file's order. */
+    columns: readonly ColumnSpan[];
+    /** Rows with their own height, in row order. */
+    rows: readonly RowSize[];
+    /**
+     * `false` when the author turned gridlines off — usually a report or a
+     * dashboard, drawn with borders where lines are meant to be.
+     */
+    showGridLines: boolean;
+}
+/** `0x1F4E79` → `'#1f4e79'`. */
+export declare function cssColor(rgb: number): string;
+/** @internal */
+export declare function toCellStyle(s: NativeCellStyle): CellStyle;
+/** @internal */
+export declare function toSheetLayout(l: NativeSheetLayout): SheetLayout;
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,IAAI,eAAe,EAC5B,WAAW,IAAI,iBAAiB,EACjC,MAAM,2BAA2B,CAAC;AAEnC,iFAAiF;AACjF,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,MAAM,GACN,aAAa,CAAC;AAElB,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,aAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,oBAAoB;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,qBAAqB;IACrB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,mBAAmB;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,4DAA4D;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,gDAAgD;IAChD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,gCAAgC;AAChC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AASD,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAyBzD;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAoB/D"}

package/dist/styles.js

@@ -0,0 +1,69 @@
+/** `0x1F4E79` → `'#1f4e79'`. */
+export function cssColor(rgb) {
+    return `#${(rgb & 0xffffff).toString(16).padStart(6, '0')}`;
+}
+function edge(e) {
+    if (!e)
+        return undefined;
+    return e.color === undefined || e.color === null
+        ? { style: e.style }
+        : { style: e.style, color: e.color };
+}
+/** @internal */
+export function toCellStyle(s) {
+    const out = {
+        bold: s.bold,
+        italic: s.italic,
+        underline: s.underline,
+        strike: s.strike,
+        fontScale: s.fontScale,
+        wrap: s.wrap,
+        indent: s.indent,
+    };
+    // Assigned only when present, so a style compares and spreads as the file meant
+    // it — `{ color: undefined }` and `{}` are different objects to a test.
+    if (s.color != null)
+        out.color = s.color;
+    if (s.fill != null)
+        out.fill = s.fill;
+    const top = edge(s.borderTop);
+    const right = edge(s.borderRight);
+    const bottom = edge(s.borderBottom);
+    const left = edge(s.borderLeft);
+    if (top)
+        out.borderTop = top;
+    if (right)
+        out.borderRight = right;
+    if (bottom)
+        out.borderBottom = bottom;
+    if (left)
+        out.borderLeft = left;
+    if (s.horizontal)
+        out.horizontal = s.horizontal;
+    if (s.vertical)
+        out.vertical = s.vertical;
+    return out;
+}
+/** @internal */
+export function toSheetLayout(l) {
+    const columns = [];
+    for (let i = 0; i + 2 < l.cols.length; i += 3) {
+        columns.push({
+            first: l.cols[i] ?? 0,
+            last: l.cols[i + 1] ?? 0,
+            width: l.cols[i + 2] ?? 0,
+        });
+    }
+    const rows = [];
+    for (let i = 0; i + 1 < l.rows.length; i += 2) {
+        rows.push({ row: l.rows[i] ?? 0, height: l.rows[i + 1] ?? 0 });
+    }
+    return {
+        defaultColWidth: l.defaultColWidth,
+        defaultRowHeight: l.defaultRowHeight,
+        columns,
+        rows,
+        showGridLines: l.showGridLines,
+    };
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

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

package/dist/tiff.d.ts

@@ -0,0 +1,95 @@
+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;
+/**
+ * Open a TIFF: single or multi-page, classic or BigTIFF.
+ *
+ * Reads fax-coded pages (CCITT Group 3 and Group 4, the usual case for a scanned
+ * drawing), and uncompressed, LZW, Deflate, PackBits and JPEG pages in grey, RGB or
+ * CMYK at 1 to 16 bits, in strips or tiles. Palette-colour and old-style JPEG pages
+ * are listed but fail to render.
+ *
+ * Only the directory is read here. Each page is decoded by
+ * {@link TiffImage.renderPage}, in Rust and off the JS thread, and straight to a
+ * reduced size — a page is never held at full resolution, so a 600-dpi colour scan of
+ * a sheet larger than the tab could allocate still opens.
+ *
+ * @example
+ * ```ts
+ * const tiff = await openTiff(file);
+ * const page = await tiff.renderPage(0, { maxWidth: 1600 });
+ * paintToCanvas(page, canvas);
+ * ```
+ */
+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

@@ -0,0 +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"}

package/dist/tiff.js

@@ -0,0 +1,78 @@
+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;
+/**
+ * Open a TIFF: single or multi-page, classic or BigTIFF.
+ *
+ * Reads fax-coded pages (CCITT Group 3 and Group 4, the usual case for a scanned
+ * drawing), and uncompressed, LZW, Deflate, PackBits and JPEG pages in grey, RGB or
+ * CMYK at 1 to 16 bits, in strips or tiles. Palette-colour and old-style JPEG pages
+ * are listed but fail to render.
+ *
+ * Only the directory is read here. Each page is decoded by
+ * {@link TiffImage.renderPage}, in Rust and off the JS thread, and straight to a
+ * reduced size — a page is never held at full resolution, so a 600-dpi colour scan of
+ * a sheet larger than the tab could allocate still opens.
+ *
+ * @example
+ * ```ts
+ * const tiff = await openTiff(file);
+ * const page = await tiff.renderPage(0, { maxWidth: 1600 });
+ * paintToCanvas(page, canvas);
+ * ```
+ */
+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)),
+        });
+    }
+}
+//# sourceMappingURL=tiff.js.map

package/dist/tiff.js.map

@@ -0,0 +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"}

package/dist/workbook.d.ts

@@ -0,0 +1,152 @@
+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 { 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.
+ *
+ * @example
+ * ```ts
+ * const book = await openWorkbook(file);
+ * const sheet = await book.sheet(0);
+ * const cells = sheet.window({ rowStart: 0, rowEnd: 50 });
+ * cells.text(0, 0); // 'Item'
+ * ```
+ *
+ * @throws {@link 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

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

package/dist/workbook.js

@@ -0,0 +1,158 @@
+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';
+/**
+ * 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.
+ *
+ * @example
+ * ```ts
+ * const book = await openWorkbook(file);
+ * const sheet = await book.sheet(0);
+ * const cells = sheet.window({ rowStart: 0, rowEnd: 50 });
+ * cells.text(0, 0); // 'Item'
+ * ```
+ *
+ * @throws {@link 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)));
+    }
+}
+//# sourceMappingURL=workbook.js.map

package/dist/workbook.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@build-qube/papyra",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Fast PDF rendering for Node and the browser, powered by Rust",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,7 @@
     "test:integration": "bun test test/integration"
   },
   "dependencies": {
-    "@build-qube/papyra-native": "0.3.0"
+    "@build-qube/papyra-native": "0.4.0"
   },
   "devDependencies": {
     "typescript": "^7.0.2"