@rowsncolumns/rnc-engine 0.10.132

package/dist/esm/index.d.ts

@@ -0,0 +1,620 @@
+/**
+ * `@rowsncolumns/rnc-engine` — typed JS/TS interop for the Rust→WASM spreadsheet calc engine.
+ *
+ * Wraps the wasm-bindgen-generated `rnc-wasm` surface (JSON strings in/out) with ergonomic, typed
+ * methods that speak the exact `rnc-model` / `commands.ts` shapes:
+ *
+ *   - `applyCommand(command)` → `CommitResult`   (a `commands.ts` command → value/style change-set)
+ *   - `readWindow(...)`       → `WindowSnapshot`  (windowed render data + consolidated styles)
+ *   - `RncEngine.toStyleMap(styles)` → `Map<"sheetId!A1", CellFormat>`
+ *
+ * The interop layer itself is GENERATED by wasm-bindgen (no hand-written FFI) — this package is the
+ * thin idiomatic layer on top. The prebuilt wasm is VENDORED in `./wasm` (shipped in `dist/esm/wasm`),
+ * so consumers need no Rust/wasm toolchain. Rebuild it after Rust changes with `yarn build:wasm`
+ * (nightly Rust — the `--features collab` engine pulls yrs 0.27).
+ */
+import type { CellData, CellFormat, CellInterface, Citation, DataValidationRule, ExtendedValue, SheetCoordinate, SheetRange } from "@rowsncolumns/common-types";
+import type { BandedRange, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, FilterView, NamedRange, PivotTable, ProtectedRange, Sheet, Slicer, TableView } from "@rowsncolumns/spreadsheet";
+import type { Command, CommandOf, CommandType } from "@rowsncolumns/spreadsheet-state";
+import { CollabSpreadsheetEngine } from "./wasm/rnc_wasm.js";
+export type { Command, CommandOf, CommandType };
+/**
+ * The wire types reuse the EXACT canonical contract types — no reinvented coordinate shapes.
+ * On the Rust side these are `#[serde(flatten)]`-embedded `CellInterface` / `SheetCoordinate` /
+ * `SheetRange`, so the JSON carries `rowIndex` / `columnIndex` / `sheetId` / `startRowIndex` / …
+ */
+/** One cell in a window — the value side the UI renders. Mirrors rnc-store `WindowCell`. */
+export type WindowCell = CellInterface & {
+    formatted: string;
+    number: number | null;
+    isFormula: boolean;
+    /** The formula SOURCE (`=SUM(A1:A2)`) for a formula cell, so the lean-window reconstruction can put
+     * it on `ue.fv` (formula bar / editor). Absent for literals. */
+    formula?: string;
+    /** The cell VERBATIM (`ue`/formula source, `ev`, hyperlink, note, …) — present when the engine
+     * exposes the lossless `readWindowCommit`. The windowed render uses it AS-IS instead of
+     * reconstructing a lossy `CellData` from the lean fields above (which drops `ue.fv` etc.). */
+    cell?: CellData;
+};
+/** One consolidated style for a cell — the UI folds these into `Map<"sheetId!A1", CellFormat>`.
+ * `format: null` means the cell's style was **cleared** (drop it from the map). */
+export type StyleEntry = SheetCoordinate & {
+    format: CellFormat | null;
+};
+/** A rectangular window streamed to the UI. Mirrors rnc-store `WindowSnapshot`. */
+export type WindowSnapshot = SheetRange & {
+    cells: WindowCell[];
+    styles: StyleEntry[];
+    /** Render-only DERIVED number formats for the window's formula cells (`=SUM($a,$b)` → currency),
+     * layered UNDER the user's style in `getEffectiveFormat`. Absent when none — see `CommitResult`. */
+    derivedFormats?: StyleEntry[];
+};
+/** Selection statistics over a range — what the status bar shows. Mirrors rnc-store `RangeStats`,
+ * which mirrors the legacy `SELECTION_STATUS` formula. Computed in Rust over the stored cells (no
+ * value round-trip to JS), so it's cheap even on a million-cell selection — the bug this fixes: the
+ * JS status-bar path refused selections over ~200k cells.
+ *
+ * - `count` — non-empty cells (COUNTA): any cell with a value, numeric OR text.
+ * - `numericalCount` — cells holding a NUMBER (COUNT); `sum`/`average`/`min`/`max` are over these.
+ * - `sum`/`average`/`min`/`max` — `null` when the range holds no numbers (so the UI hides them). */
+export interface RangeStats {
+    sum: number | null;
+    count: number;
+    average: number | null;
+    min: number | null;
+    max: number | null;
+    numericalCount: number;
+}
+/** One changed (or `removed`) cell — the delta streamed after a command. Mirrors `CellChange`. */
+export type CellChange = SheetCoordinate & {
+    /** The cell VERBATIM — its `ue` (input / formula source), `ev` (computed value incl. `ev.ev` =
+     * errorValue), `fv` (formatted), hyperlink, … — assigned straight into `sheetData`. `null` = the
+     * cell was cleared. JS is view-only: it never reconstructs values, classifies inputs, or detects
+     * errors. (Styles ride the separate `styleChanges` channel, so they're NOT on this cell.) */
+    cell: CellData | null;
+};
+/** One row's / column's metadata delta — mirrors rnc-store `DimensionChange`. A resize/hide doesn't
+ * change any cell VALUE, so it streams here (not in `changes`). The UI assigns the props into
+ * `rowMetadata[index]` (from `rowChanges`) or `columnMetadata[index]` (from `columnChanges`). */
+export interface DimensionChange {
+    sheetId: number;
+    index: number;
+    size?: number;
+    resizedByUser?: boolean;
+    customHeight?: boolean;
+    hiddenByUser?: boolean;
+    hiddenByFilter?: boolean;
+    hiddenByGroup?: boolean;
+    outlineLevel?: number;
+    collapsed?: boolean;
+}
+/** One merge-region delta — mirrors rnc-store `MergeChange`. `removed:true` = the region was
+ * unmerged (drop it from `sheet.merges`); otherwise it was merged (add it). The keep-upper-left cell
+ * clearing rides the `changes` channel, so the UI applies that automatically. */
+export interface MergeChange {
+    sheetId: number;
+    startRowIndex: number;
+    endRowIndex: number;
+    startColumnIndex: number;
+    endColumnIndex: number;
+    removed: boolean;
+}
+/** What `applyCommand` returns. Mirrors rnc-store `CommitResult` — one typed channel per document
+ * facet: cell values (`changes`, incl. cross-sheet formula dependents), cell styles
+ * (`styleChanges`), row/column metadata (`rowChanges`/`columnChanges`), and merge regions
+ * (`merges`). The engine owns structural results; the UI applies these channels. */
+export interface CommitResult {
+    changes: CellChange[];
+    styleChanges: StyleEntry[];
+    /** Render-only DERIVED number-format deltas: a formula cell's INHERITED format (`=SUM($a,$b)` →
+     * currency), layered UNDER the user's own style in `getEffectiveFormat` (`format: null` clears a
+     * prior one). NEVER persisted — distinct from `styleChanges`. Absent when no formula cell changed. */
+    derivedFormatChanges?: StyleEntry[];
+    rowChanges: DimensionChange[];
+    columnChanges: DimensionChange[];
+    merges: MergeChange[];
+    /** Data-validation results — folded ONTO each cell's `dataValidationResult` (`valid:false` = the
+     * value violates a rule). There is NO conditional-style channel: conditional formatting is rendered
+     * by CanvasGrid from the rules (`useConditionalFormatting`); the engine doesn't derive CF styles. */
+    validations: ValidationStatus[];
+    /** Per-cell note (annotation) deltas — `note: null` = the note was cleared. */
+    noteChanges: NoteEntry[];
+    /** Chart spec deltas — `chart: null` = deleted. UI → `onChangeCharts`. */
+    chartChanges: ChartChange[];
+    /** Pivot spec deltas — `pivotTable: null` = deleted. UI → `onChangePivotTables`. (Aggregation is
+     * deferred to `rnc-pivot`; the engine stores the spec + streams spec changes.) */
+    pivotChanges: PivotChange[];
+    /** HOST custom-function eval requests captured this recalc — a `=AOP(A1,…)` cell (a JS-registered
+     * function) records its cell + resolved args here. The hook runs the registered JS impl and answers
+     * via `setEffectiveValue`. See {@link useEngineCore}'s `registerCustomFunction`. */
+    customEvals: CustomEval[];
+    /** HOST custom-function calls whose cell no longer holds the formula after this commit — cleared,
+     * overwritten, filled/pasted over, undone, or removed with its row/column. The hook drops the
+     * matching in-flight eval's answer; hosts can additionally observe these via the
+     * `onCustomEvalCancel` option to abort whatever the call started (e.g. a backend run). Absent
+     * when nothing was cancelled. */
+    customCancels?: CustomCancel[];
+    fullResyncSheets: number[];
+    /** Conditional-format RULE set after a CF command (create/update/delete) — the full current list, so
+     * an `onChanges` / collaboration consumer observes rule changes here. Per-cell CF RESULTS still ride
+     * `changes` on the cell (`conditionalFormattingResultById`). Empty `[]` when no CF command ran this
+     * commit; also emitted on `load`. */
+    conditionalFormats: ConditionalFormatRule[];
+    /** Data-validation RULE set after a DV command — the full current list (per-cell validity still rides
+     * the `validations` channel). Empty `[]` when no DV command ran this commit; emitted on `load`. */
+    dataValidations: DataValidationEntry[];
+    /** Citation collection after a citation command (create/update/delete/remove-from-cell) — the full
+     * current list (a cell's `citationId` link still rides `changes`). Empty `[]` when no citation command
+     * ran this commit; emitted on `load`. */
+    citations: Citation[];
+}
+/** A pending host custom-function evaluation — the cell, the function name, and the RESOLVED argument
+ * values (e.g. `A1`'s value). Mirrors rnc-store `CustomEval`. */
+export type CustomEval = SheetCoordinate & {
+    name: string;
+    args: unknown[];
+};
+/** A cancelled host custom-function call — the cell that held `=NAME(…)` and the (upper-cased)
+ * function name. Mirrors rnc-store `CustomCancel`. */
+export type CustomCancel = SheetCoordinate & {
+    name: string;
+};
+/** One cell's data-validation result — mirrors rnc-store `ValidationStatus`. */
+export type ValidationStatus = SheetCoordinate & {
+    valid: boolean;
+};
+/** One cell's note delta — mirrors rnc-store `NoteEntry`. `note: null` = cleared. */
+export type NoteEntry = SheetCoordinate & {
+    note: string | null;
+};
+/** One chart's spec delta — mirrors rnc-store `ChartChange`. `chart: null` = deleted. The engine
+ * round-trips the canonical `EmbeddedChart` spec losslessly. */
+export interface ChartChange {
+    chartId: EmbeddedChart["chartId"];
+    chart: EmbeddedChart | null;
+}
+/** One pivot table's spec delta — mirrors rnc-store `PivotChange`. `pivotTable: null` = deleted.
+ * (Aggregation is deferred to `rnc-pivot`; this carries the canonical `PivotTable` spec for sync.) */
+export interface PivotChange {
+    pivotId: PivotTable["pivotId"];
+    pivotTable: PivotTable | null;
+}
+/** A sheet to register up-front (`id` → display name). */
+export interface SheetInit {
+    sheetId: number;
+    title: string;
+}
+/** One sheet's authoritative identity/order as the engine reports it from {@link RncEngine.sheets} —
+ * the lifecycle facets (id / title / tab order, plus hidden / tab color) the engine owns. Dimension /
+ * merge metadata is NOT here (it rides the per-commit channels); this is the tab-list source of truth. */
+export interface EngineSheet {
+    sheetId: number;
+    title: string;
+    /** 0-based tab order. */
+    index: number;
+    hidden?: boolean;
+    tabColor?: Sheet["tabColor"];
+    /** Sheet-view toggles + zoom (from the imported `<sheetView>`); absent = renderer default. */
+    showGridLines?: boolean;
+    showRowColHeaders?: boolean;
+    showZeros?: boolean;
+    zoomScale?: number;
+    /** `<sheetView rightToLeft>` — the sheet displays right-to-left. Round-tripped and queryable;
+     * the grid does NOT mirror yet (rendering is a follow-up). Absent = LTR. */
+    rightToLeft?: boolean;
+    /** Sheet default row height in px (from the imported `<sheetFormatPr defaultRowHeight>`): what a
+     * row with no `rowMetadata` entry renders at. Absent = renderer default. */
+    defaultRowHeight?: number;
+}
+/** Initial document to hydrate the engine from (e.g. an API response / saved snapshot). */
+export interface LoadDocument {
+    sheets?: Array<{
+        sheetId: number;
+        title?: string;
+    }>;
+    /** `rnc-model` SheetData: `Record<sheetId, (RowData | null)[]>`. Short OR long cell keys both load
+     * (`ue`/`userEnteredValue`, `uf`/`userEnteredFormat`, …); a numeric `ss` is coerced to its string. */
+    sheetData?: Record<string | number, unknown>;
+    /** Optional explicit consolidated styles (alternative to per-cell `uf`). */
+    styles?: Array<SheetCoordinate & {
+        format: CellFormat;
+    }>;
+    /** Document facets to hydrate alongside the cells (evaluated/streamed on load). */
+    conditionalFormats?: ConditionalFormatRule[];
+    /** Input rules (`{ id, ranges, condition }`); the engine resolves a cell's rule by range membership.
+     * `id` may be a number at the type level — the engine coerces it to a string key. */
+    dataValidations?: DataValidationRuleRecord[];
+    charts?: EmbeddedChart[];
+    pivotTables?: PivotTable[];
+    tables?: TableView[];
+    namedRanges?: NamedRange[];
+    embeds?: EmbeddedObject[];
+    slicers?: Slicer[];
+    bandedRanges?: BandedRange[];
+    citations?: Citation[];
+}
+/** One stored data-validation rule + the ranges it covers — the hook resolves a cell's rule by
+ * testing membership in `ranges` (`getDataValidation(sheetId,row,col)`). Mirrors rnc-store `DvDef`. */
+export interface DataValidationEntry {
+    id: string;
+    ranges: SheetRange[];
+    condition?: DataValidationRule["condition"];
+    /** `"plain"` suppresses the in-cell dropdown arrow (imported from OOXML `showDropDown="1"`,
+     * whose polarity is inverted); absent/`"arrow"` renders the default arrow. */
+    displayStyle?: DataValidationRule["displayStyle"];
+    allowBlank?: DataValidationRule["allowBlank"];
+}
+/** The document-level facets the renderer draws — the CanvasGrid props that aren't cells or styles.
+ * Read in one shot from the engine via {@link RncEngine.documentFacets} after each commit (small +
+ * change rarely, so they ride a getter, not a per-facet diff). Conditional-format rules and the
+ * lossless object facets (embeds / slicers / banded / protected ranges) are verbatim; named ranges
+ * and tables are reconstructed canonically from the engine's stored definitions. */
+export interface DocumentFacets {
+    conditionalFormats: ConditionalFormatRule[];
+    dataValidations: DataValidationEntry[];
+    namedRanges: NamedRange[];
+    tables: TableView[];
+    embeds: EmbeddedObject[];
+    slicers: Slicer[];
+    bandedRanges: BandedRange[];
+    protectedRanges: ProtectedRange[];
+    basicFilters: Array<{
+        sheetId: number;
+        filter: FilterView;
+    }>;
+    citations: Citation[];
+    /**
+     * Body rows hidden by any active filter (basic OR table-column), keyed by sheetId, as compact
+     * `[start, end]` 1-based inclusive ranges. The host derives `visibleRowRanges` from these.
+     */
+    hiddenRowRanges?: Record<string, [number, number][]>;
+}
+/** A subscriber notified with each change-set the engine produces. */
+export type ChangeListener = (commit: CommitResult) => void;
+/**
+ * The minimal wasm-engine surface {@link RncEngine} drives — the JS side of the port plan's storage
+ * seam. The built-in single-user {@link SpreadsheetEngine} and the collaborative
+ * {@link CollabSpreadsheetEngine} both satisfy it, and so can a THIRD-PARTY Rust store compiled to
+ * wasm. Switching backends = passing a different one to {@link RncEngine.create}
+ * (`createEngine` on the hook options).
+ *
+ * `initGrid` / `stream*` are optional capabilities: only positional/CRDT stores need `initGrid`
+ * (pre-sizing); only the huge-workbook NDJSON path needs `stream*`. A store may omit either.
+ */
+export interface SpreadsheetEngineLike {
+    addSheet(sheetId: number, name: string): void;
+    /** Pre-size a sheet's grid. Required by positional/CRDT stores (e.g. the collab engine) before
+     * cells are written; absent on stores that grow on demand. */
+    initGrid?(sheetId: number, rows: number, cols: number): void;
+    loadDocument(documentJson: string): string;
+    applyCommand(commandJson: string): string;
+    /** Declare WINDOWED rendering. When on, every commit this engine serializes (`applyCommand` /
+     * `undo` / `redo` / `loadDocument`) omits the O(cells) channels (`changes`, `styleChanges`,
+     * `derivedFormatChanges`, `validations`, `noteChanges`) — the windowed host re-reads visible cells
+     * via `readWindow` and discards those channels anyway, so on a 1M-row sheet this avoids building,
+     * shipping, and `JSON.parse`ing a multi-MB string the host throws away. Optional: a store may omit
+     * it (the host then receives full commits, which the windowed fold still correctly ignores — just
+     * without the transfer saving). See {@link useEngineCore}'s `windowed` option. */
+    setWindowed?(on: boolean): void;
+    readWindow(sheetId: number, startRow: number, startCol: number, endRow: number, endCol: number): string;
+    /** Lossless full-cell window read — each cell VERBATIM as a `CommitResult` JSON (`changes` carry the
+     * whole `CellData`: `ue`/formula source, `ev`, hyperlink, note). Preferred over the lean `readWindow`
+     * so the windowed render doesn't drop those fields. Absent on engines that only ship the lean read. */
+    readWindowCommit?(sheetId: number, startRow: number, startCol: number, endRow: number, endCol: number): string;
+    /** Selection statistics over a 1-indexed inclusive range as `RangeStats` JSON. Optional: a store
+     * may omit it (the host then falls back to its own — necessarily capped — JS computation). */
+    rangeStats?(sheetId: number, startRow: number, startCol: number, endRow: number, endCol: number): string;
+    /** Off-window search: JSON `SheetCoordinate[]` (row-major) of every cell on `sheetId` whose display
+     * text matches `find`. `rangesJson` is a JSON `SheetRange[]` (`""` = whole sheet). The windowed UI
+     * can only scan the loaded viewport in JS, so finding matches OUTSIDE it must go through the engine
+     * (which holds the whole document). Matching honors match-case / whole-word (`\b`) / regex, mirroring
+     * the JS `buildSearchRegex`. Optional: a store may omit it (the host then falls back to JS search,
+     * which only finds within loaded data). */
+    findAll?(sheetId: number, rangesJson: string, find: string, matchCase: boolean, wholeWord: boolean, useRegex: boolean): string;
+    /** Scratch-evaluate a formula at a cell — `ExtendedValue` JSON or `"null"`. Read-only (no
+     * install / commit / dirty marks); powers the cell editor's live result preview
+     * (`onRequestCalculate`). Optional: a store may omit it (the host then shows no preview). */
+    evalFormula?(sheetId: number, row: number, col: number, formula: string): string;
+    /** Distinct fill/font colors + CF icons in one column's body rows — JSON
+     * `{cellColors, fontColors, icons: [{iconSet, iconId}]}`. Powers the FilterBox
+     * "Filter by color" picker on windowed hosts (the JS per-row scan is disabled there).
+     * Optional: a store may omit it (the picker then stays hidden). */
+    filterColors?(sheetId: number, col: number, startRow: number, endRow: number): string;
+    sheetIds(): Int32Array | number[];
+    /** Remove the host-seeded default `Sheet1` (sheetId 1) when a collab merge showed the workbook's
+     * real sheets live under other ids. Call right after merging the collab doc, and ONLY when the
+     * persisted doc's sheet registry is non-empty and contains no sheetId 1 — the one fact the store
+     * cannot know. The store guards the rest (exact seed title, zero populated cells, ≥1 other
+     * sheet). Optional: only CRDT stores carry a construction seed that can dangle. Returns whether
+     * the seed was pruned. */
+    pruneDanglingDefaultSeed?(): boolean;
+    /** Per-sheet 1-based data extent as JSON `[[sheetId, rowCount, colCount], …]`. A windowed renderer
+     * sizes the grid's scroll extent to this so it can hold only the visible viewport in JS yet scroll
+     * the full sheet. Optional: present on the single-user + collab engines; a store may omit it (the
+     * windowed hook then falls back to the seeded sheet counts). */
+    sheetExtents?(): string;
+    /** Export a sheet's display values as RFC-4180 CSV. Optional capability. */
+    exportCsv?(sheetId: number): string;
+    /** Export the whole workbook to in-memory XLSX bytes (the engine reads the full document — values,
+     * formats, merges, frozen panes, tables, named ranges — and writes via the Rust exporter). Optional
+     * capability: only engines built with export support expose it. */
+    exportXlsx?(): Uint8Array;
+    /** Import an `.xlsx` workbook with the native Rust reader (`rnc-import`) and hydrate the engine from
+     * it, returning the full `CommitResult` JSON (same shape as `loadDocument`). Optional capability:
+     * only engines built with import support expose it (the yrs-store engine returns a sheet-summary
+     * instead; the {@link RncEngine.importXlsx} wrapper handles the single-engine commit shape). */
+    importXlsx?(bytes: Uint8Array): string;
+    documentFacets(): string;
+    /** The workbook's sheets in tab order as JSON `[{sheetId, title, index, hidden?, tabColor?}]` —
+     * the engine's authoritative sheet identity/order/titles. A thin UI reconciles its tab list from
+     * this after each commit. Optional: a store may omit it (the hook then keeps its seeded sheets). */
+    sheets?(): string;
+    registerCustomFunction(name: string): void;
+    precedents(sheetId: number, row: number, col: number): string;
+    dependents(sheetId: number, row: number, col: number): string;
+    clearHistory(): void;
+    undo(): string;
+    redo(): string;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    undoDepth(): number;
+    redoDepth(): number;
+    /** Streaming hydration for 100 MB+ workbooks (NDJSON). Optional — collab docs hydrate from the
+     * CRDT update stream (`applyUpdate`) instead. */
+    streamBegin?(): void;
+    streamWrite?(chunk: Uint8Array): void;
+    streamEnd?(): void;
+    free(): void;
+}
+/**
+ * The extra Yjs sync surface a COLLABORATIVE engine implements so the host can bridge it to a
+ * `Y.Doc` (Keryx / yhub). {@link CollabSpreadsheetEngine} implements this; the single-user
+ * {@link SpreadsheetEngine} does not. {@link RncEngine} exposes these through
+ * {@link RncEngine.applyRemoteUpdate} / {@link RncEngine.encodeStateAsUpdate} / … when the injected
+ * engine is collaborative.
+ */
+export interface CollabSync {
+    /** Merge a remote Yjs v1 update into the CRDT doc. Follow with `syncRemote()` to fold the result. */
+    applyUpdate(update: Uint8Array): void;
+    /** Rebuild the calc engine after `applyUpdate` and return a `CommitResult` JSON for the UI. */
+    syncRemote(): string;
+    /** Full document state as a Yjs v1 update (initial sync / persistence). */
+    encodeStateAsUpdate(): Uint8Array;
+    /** This peer's Yjs state vector (what it has seen). */
+    encodeStateVector(): Uint8Array;
+    /** The diff the remote (by its state vector) is missing — send via the transport's `applyUpdate`. */
+    encodeDiffV1(remoteStateVector: Uint8Array): Uint8Array;
+}
+/** Options for {@link RncEngine.create}. */
+export interface CreateEngineOptions {
+    /** Inject the backing wasm engine instead of the default single-user {@link SpreadsheetEngine}.
+     * Pass `() => new CollabSpreadsheetEngine()` for yhub/collab, or your own store. */
+    engine?: SpreadsheetEngineLike;
+    /** Initial grid size for stores that implement `initGrid` (collab/positional). Ignored otherwise. */
+    gridRows?: number;
+    gridCols?: number;
+}
+/** Initialize the wasm module (idempotent). Called by {@link RncEngine.create}; exported for control. */
+export declare function initEngine(): Promise<unknown>;
+/**
+ * Ergonomic, typed handle to a standalone in-memory spreadsheet engine.
+ * Commands go in; value/style change-sets and windowed reads come out — all using the exact
+ * `rnc-model` shapes the rest of the app already speaks.
+ */
+export declare class RncEngine {
+    private readonly inner;
+    private readonly listeners;
+    private constructor();
+    /**
+     * Initialize wasm (idempotent) and create an engine with the given sheets registered.
+     *
+     * By default the backend is the single-user {@link SpreadsheetEngine}. Pass `options.engine` to
+     * inject a different store — e.g. `new CollabSpreadsheetEngine()` (yhub/collab) or your own wasm
+     * store implementing {@link SpreadsheetEngineLike}. When the store implements `initGrid`
+     * (positional/CRDT), each registered sheet is pre-sized to `gridRows`×`gridCols`.
+     */
+    static create(sheets?: SheetInit[], options?: CreateEngineOptions): Promise<RncEngine>;
+    /**
+     * Wrap an ALREADY-INITIALIZED backing engine — skips {@link initEngine} (the caller owns wasm
+     * init). Use this when the wasm module is loaded by a different path than the vendored
+     * `--target web` build: a `--target nodejs` engine in tests/SSR, a `CollabSpreadsheetEngine` you
+     * constructed yourself, or any custom {@link SpreadsheetEngineLike} store. Registers `sheets` (and
+     * pre-sizes the grid via `initGrid` when the store supports it) exactly like {@link create}.
+     */
+    static fromEngine(inner: SpreadsheetEngineLike, sheets?: SheetInit[], options?: Pick<CreateEngineOptions, "gridRows" | "gridCols">): RncEngine;
+    /** Whether the backing engine is collaborative (implements the Yjs {@link CollabSync} surface). */
+    get isCollab(): boolean;
+    private collab;
+    /** Pre-size a sheet's grid on a positional/CRDT store. No-op for stores without `initGrid`. */
+    initGrid(sheetId: number, rows: number, cols: number): void;
+    /** Register a sheet (`id` → display name). */
+    addSheet(sheetId: number, name: string): void;
+    /** Begin a streaming hydration. Feed NDJSON byte chunks with {@link streamWrite}, then {@link streamEnd}. */
+    streamBegin(): void;
+    /** Ingest one NDJSON byte chunk (boundaries may fall anywhere — partial lines are buffered). */
+    streamWrite(chunk: Uint8Array): void;
+    /** Finish hydration: ingest the trailing line and recompute once. Read the viewport via `readWindow`. */
+    streamEnd(): void;
+    /**
+     * Hydrate from a byte stream of NDJSON records — e.g. `(await fetch(url)).body`. The 100 MB+
+     * workbook flows network → wasm in chunks and is never held whole in JS. Records are
+     * `{"t":"sheet"|"cell"|"style", …}` (see the Rust `StreamRecord`). Nothing is returned; call
+     * `readWindow` for the visible area once this resolves.
+     */
+    hydrateFromStream(stream: ReadableStream<Uint8Array>): Promise<void>;
+    /**
+     * Hydrate the engine from an initial document (sheets + cells + styles, the shape your API
+     * returns). Recomputes formulas and delivers the full change-set to {@link onChanges} subscribers
+     * — so initial load uses the exact same path as every other change. Returns it inline too.
+     */
+    load(document: LoadDocument): CommitResult;
+    /**
+     * Apply a `commands.ts` command. The resulting change-set is delivered to every
+     * {@link onChanges} subscriber; it's also returned for callers that want it inline.
+     */
+    applyCommand(command: Command): CommitResult;
+    /**
+     * Declare whether the host renders WINDOWED, so the backing engine can omit the per-cell commit
+     * channels the windowed render discards (it re-reads the viewport via {@link readWindow}). Forwarded
+     * to the injected engine's `setWindowed` when it implements it; a no-op otherwise (the windowed fold
+     * still ignores those channels correctly — it just pays to transfer them). Called once by the
+     * windowed hook after engine creation. See {@link SpreadsheetEngineLike.setWindowed}.
+     */
+    setWindowed(on: boolean): void;
+    /**
+     * Subscribe to the change-sets the engine produces. Returns an unsubscribe function.
+     *
+     * Today this fires synchronously after each {@link applyCommand}. The same API is the seam for
+     * out-of-band changes later — volatile recalc ticks, or Worker `postMessage` when calc moves off
+     * the main thread — without the UI's subscribe code changing.
+     */
+    onChanges(listener: ChangeListener): () => void;
+    /**
+     * Undo / redo the last document mutation in the engine. The resulting change-set (reverted input
+     * AND recomputed values, across any sheets touched) is delivered to {@link onChanges} subscribers.
+     */
+    undo(): CommitResult;
+    redo(): CommitResult;
+    /** Whether an undo / redo is currently available (for enabling toolbar buttons). */
+    canUndo(): boolean;
+    canRedo(): boolean;
+    /** Drop the entire undo/redo history (the document is unchanged). Backs `onClearHistory`. */
+    clearHistory(): void;
+    /** Undo / redo stack depth. A UI that keeps parallel per-edit state (cursor, selection, active
+     * sheet) watches these to push/pop its own snapshots in lockstep — a command that recorded an undo
+     * entry bumps `undoDepth`, so the UI knows whether to snapshot (and skips no-op-inverse commands). */
+    undoDepth(): number;
+    redoDepth(): number;
+    /** Read a 1-indexed, inclusive window of cells + consolidated styles. Prefers the LOSSLESS full-cell
+     * read (`readWindowCommit`): each cell is carried VERBATIM (`ue`/formula source, hyperlink, note, full
+     * `ev`) under `cell`, so the windowed render uses it as-is rather than reconstructing a lossy cell
+     * from a lean formatted/number/isFormula projection (which dropped `ue.fv` — the formula bar then
+     * showed the computed value, not `=SUM(4,4)`). Falls back to the lean `readWindow` for engines without
+     * it. The window is only viewport-sized, so carrying whole cells costs nothing. */
+    readWindow(sheetId: number, startRow: number, startCol: number, endRow: number, endCol: number): WindowSnapshot;
+    /**
+     * Selection statistics (sum / count / numericalCount / average / min / max) over a 1-indexed
+     * inclusive {@link SheetRange} — what the status bar shows for a selection. Computed in Rust over
+     * the stored cells, so it stays cheap even on a million-cell selection (no value round-trip to JS,
+     * no main-thread iteration — the reason the old JS path refused selections over ~200k cells).
+     *
+     * Returns `null` if the backing engine doesn't expose `rangeStats` (the host then falls back to
+     * its own JS computation). Numeric fields are `null` when the range holds no numbers.
+     */
+    rangeStats(range: SheetRange): RangeStats | null;
+    /** Off-window search: every cell on `sheetId` whose display text matches `find`, returned row-major
+     * (the order next/prev navigation walks). The windowed UI's JS search only sees the loaded viewport,
+     * so matches OUTSIDE it must come from the engine, which holds the whole document. `ranges` restricts
+     * the scope (whole sheet when omitted). Match-case / whole-word (`\b`) / regex mirror the JS search.
+     * Returns `[]` if the find is empty or the backing engine can't search. */
+    findAll(sheetId: number, find: string, options?: {
+        matchCase?: boolean;
+        wholeWord?: boolean;
+        useRegex?: boolean;
+    }, ranges?: SheetRange[]): SheetCoordinate[];
+    /** Scratch-evaluate `formula` at `(rowIndex, columnIndex)` on `sheetId` — the cell editor's live
+     * result preview. Read-only: nothing is installed or committed, no dirty marks; a host
+     * custom-function call (`=AOP(...)`) evaluates to `#NAME?` with NO `customEvals` request (host
+     * calls are recognised at set-value time only), so previewing can never fire one. Returns the
+     * result as an `ExtendedValue`, or `undefined` when the backing engine can't evaluate it (no
+     * capability, parse failure, unknown sheet, unpopulated engine). */
+    evalFormula(sheetId: number, rowIndex: number, columnIndex: number, formula: string): ExtendedValue | undefined;
+    /** Distinct fill/font colors + CF icons present in one column's body rows — the FilterBox
+     * "Filter by color" swatches, computed engine-side in ONE column scan (the windowed
+     * alternative to the JS per-row `getEffectiveFormat` scan). `undefined` when the backing
+     * engine doesn't expose it. */
+    filterColors(sheetId: number, columnIndex: number, startRow: number, endRow: number): {
+        cellColors: string[];
+        fontColors: string[];
+        icons: {
+            iconSet: string;
+            iconId: number;
+        }[];
+    } | undefined;
+    /** Sheet ids, in order. */
+    sheetIds(): number[];
+    /**
+     * Remove the host-seeded default `Sheet1` (sheetId 1) once a collab merge showed the workbook's
+     * real sheets live under other ids — without it, the seed's live structs ship with every outbound
+     * flush, materializing an empty ghost `Sheet1` tab for every collaborator (and re-materializing
+     * it after a peer's explicit delete-sheet). Call right after merging the collab doc, and ONLY
+     * when the persisted doc's sheet registry is non-empty and contains no sheetId 1; the store
+     * guards the rest (exact seed title, zero populated cells, ≥1 other sheet) and removes the seed
+     * WITHOUT a commit fan-out — the tombstones ride the next flushed update. No-op (returns false)
+     * on stores without a construction seed.
+     */
+    pruneDanglingDefaultSeed(): boolean;
+    /** The workbook's sheets in tab order — the engine's AUTHORITATIVE identity/order/titles (it
+     * generates ids for `create-sheet`, rewrites titles on rename, reorders on move). A thin UI
+     * reconciles its tab list from this after each commit. Returns `[]` if the backing engine doesn't
+     * expose it (the hook then keeps its seeded sheet list). */
+    sheets(): EngineSheet[];
+    /** Per-sheet 1-based data extent: `[sheetId, rowCount, columnCount][]`. A windowed renderer sizes
+     * the grid's scroll extent to this (so it holds only the visible viewport in JS yet scrolls the
+     * full sheet). Returns `[]` if the backing engine doesn't expose extents. */
+    sheetExtents(): Array<[number, number, number]>;
+    /** A sheet's display values as RFC-4180 CSV. Empty string if the backing engine can't export. */
+    exportCsv(sheetId: number): string;
+    /** The whole workbook as in-memory XLSX bytes (a `Uint8Array`), or `undefined` if the backing
+     * engine wasn't built with export support. Reads the full document inside the engine (works even in
+     * windowed mode, where the JS side holds only the viewport). */
+    exportXlsx(): Uint8Array | undefined;
+    /**
+     * Import an `.xlsx` workbook with the native Rust reader (`rnc-import`), REPLACING the engine's
+     * document, and return the full {@link CommitResult} (every cell + style + structural change — the
+     * same shape as {@link load}). Returns `undefined` if the backend has no import capability.
+     *
+     * NOTE: unlike {@link load}, this does NOT notify {@link onChanges} subscribers — because import is a
+     * full replace, the caller must reset its render state and fold this commit onto sheets seeded from
+     * {@link sheets} (merges/dimensions fold only onto pre-existing sheet objects). The windowed hook's
+     * `importXlsx` does exactly that. Only backends whose commit shape matches {@link CommitResult}
+     * (rnc-engine's built-in engine) are driven here; the collab (yrs-store) engine imports via its delta.
+     */
+    importXlsx(bytes: Uint8Array): CommitResult | undefined;
+    /** Raw JSON of {@link documentFacets} — the hook diffs this string against the previous commit's to
+     * skip a no-op facet update (so a pure cell edit doesn't churn the facet props and re-render the grid). */
+    documentFacetsJson(): string;
+    /** The document-level facets the renderer draws (CF rules, tables, named/protected ranges, embeds,
+     * slicers, banded ranges, basic filters, DV rules) in their canonical shapes. Cheap and re-read by
+     * the thin hook once per commit — they're small and change rarely, so they ride this getter rather
+     * than a per-facet `CommitResult` channel. */
+    documentFacets(): DocumentFacets;
+    /** Register a host (JS) custom-function NAME so `=NAME(…)` resolves (deps tracked) instead of
+     * `#NAME?`. On recalc the engine emits a `customEvals` request the host answers via
+     * `setEffectiveValue`. (The function body itself lives in JS — see the hook's
+     * `registerCustomFunction`, which pairs this with the resolve loop.) */
+    registerCustomFunction(name: string): void;
+    /** The PRECEDENTS of a cell — the cells + ranges its formula references (engine-parsed, exact). The
+     * engine owns the dependency data, so `getPrecedents` is backed by real graph data, not a stub. */
+    precedents(sheetId: number, rowIndex: number, columnIndex: number): {
+        cells: SheetCoordinate[];
+        ranges: SheetRange[];
+    };
+    /** The DEPENDENTS of a cell — every formula cell that references it (directly or within a range). */
+    dependents(sheetId: number, rowIndex: number, columnIndex: number): SheetCoordinate[];
+    /** Apply a remote Yjs v1 update (a peer's / yhub's delta) into the CRDT doc, rebuild, and fold the
+     * resulting change-set to {@link onChanges} subscribers. Returns it inline too. Throws if the
+     * backing engine isn't collaborative ({@link isCollab}). */
+    applyRemoteUpdate(update: Uint8Array): CommitResult;
+    /** Encode the full document state as a Yjs v1 update (initial sync to a peer / persistence). */
+    encodeStateAsUpdate(): Uint8Array;
+    /** Encode this peer's Yjs state vector (a compact summary of what it has seen). */
+    encodeStateVector(): Uint8Array;
+    /** Encode the diff a remote peer (identified by its state vector) is missing — apply the result to
+     * the transport doc (`Y.applyUpdate`) to propagate local edits. */
+    encodeDiffV1(remoteStateVector: Uint8Array): Uint8Array;
+    /** Release the underlying wasm memory. */
+    free(): void;
+    /** Fold `StyleEntry[]` into the consolidated `Map<"sheetId!A1", CellFormat>` the UI consumes.
+     * A `null` format clears the entry. */
+    static toStyleMap(styles: StyleEntry[]): Map<string, CellFormat>;
+}
+export { CollabSpreadsheetEngine };
+export { cellKey, columnLabel, parseCellKey } from "./keys";
+export * from "./fold";
+export { useEngineCore, type CustomFunctionContext, type CustomFunctionImpl, type EngineSpreadsheet, type UseEngineSpreadsheetOptions, } from "./use-engine-core";
+export { useSpreadsheetUI, type SpreadsheetUI, type DialogName, } from "./use-spreadsheet-ui";
+export { useSpreadsheetEngine, type SpreadsheetEngine, } from "./use-spreadsheet-engine";
+export { useEnginePivotEditor, VALUES_PIVOT_FIELD, type EnginePivotField, type UseEnginePivotEditorParams, } from "./use-engine-pivot-editor";
+export { parseWorkbook, importXlsx, importOds, importCsv, streamWorkbookInto, exportXlsx, exportOds, exportCsv, type ParsedWorkbook, type ImportOptions, } from "./io";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

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