@build-qube/papyra 0.5.0 → 0.7.0

package/dist/tiff.js.map

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

package/dist/types.d.ts

@@ -124,6 +124,21 @@ export interface StreamedPage<P extends PageBitmap = RenderedPage> {
     /** The rendered pixels. */
     readonly bitmap: P;
 }
+/**
+ * One window of a page's render, in its output pixels: the corner's offset from the
+ * page's top-left and the window's size. For showing a page too large to render
+ * whole; see {@link PagedEngine.renderTile}.
+ */
+export interface Tile {
+    /** Pixels from the page's left edge. */
+    readonly x: number;
+    /** Pixels from the page's top edge. */
+    readonly y: number;
+    /** Width in pixels, 1 to 65535. */
+    readonly width: number;
+    /** Height in pixels, 1 to 65535. */
+    readonly height: number;
+}
 /** Page dimensions in PDF points (1/72 inch). */
 export interface PageSize {
     /** Width in points, with rotation and the crop box already applied. */

package/dist/types.d.ts.map

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

package/dist/workbook.d.ts

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

package/dist/workbook.d.ts.map

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

package/dist/workbook.js

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

package/dist/workbook.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@build-qube/papyra",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Fast PDF rendering for Node and the browser, powered by Rust",
   "license": "MIT",
   "repository": {
@@ -52,14 +52,14 @@
     "test:integration": "bun test test/integration"
   },
   "dependencies": {
-    "@build-qube/papyra-native": "0.5.0"
+    "@build-qube/papyra-native": "0.7.0"
   },
   "devDependencies": {
     "typescript": "^7.0.2",
     "@build-qube/papyra-office-native": "workspace:*"
   },
   "peerDependencies": {
-    "@build-qube/papyra-office-native": "0.5.0"
+    "@build-qube/papyra-office-native": "0.7.0"
   },
   "peerDependenciesMeta": {
     "@build-qube/papyra-office-native": {