@rowsncolumns/rnc-yrs-store 0.14.2 → 0.15.1

package/dist/rnc_yrs_store.d.ts

@@ -23,10 +23,27 @@ export class SpreadsheetEngine {
      * inner engine still does both in one call for the older bespoke/worker path.)
      */
     applyUpdate(bytes: Uint8Array): void;
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell, as JSON
+     * `{"range":{startRowIndex,endRowIndex,startColumnIndex,endColumnIndex},"formula":"=…"}`, or
+     * `null` — the same shape as `rnc-engine`'s `SpreadsheetEngine.arrayFormulaAt`, which the
+     * `@rowsncolumns/rnc-engine` wrapper feature-detects (formula-bar `{…}` display, re-entry
+     * range, part-of-array checks in the editor).
+     */
+    arrayFormulaAt(sheet_id: number, row: number, col: number): string;
     /**
      * Cold-block body cache diagnostics as JSON `{"hits", "misses", "bytes"}`.
      */
     blockCacheStats(): string;
+    /**
+     * The workbook calculation mode: `"auto"`, `"autoNoTable"` or `"manual"`. Set it with the
+     * `set-calculation-mode` command.
+     */
+    calculationMode(): string;
+    /**
+     * Manual mode: formulas may be out of date — show "Calculate" in the status bar.
+     */
+    calculationPending(): boolean;
     canRedo(): boolean;
     canUndo(): boolean;
     /**
@@ -75,6 +92,11 @@ export class SpreadsheetEngine {
      * its own region.
      */
     dataRegion(sheet_id: number, row: number, col: number): string;
+    /**
+     * The workbook's What-If data tables as a `DataTable[]` JSON — `{ sheetId, range,
+     * rowInputCell?, columnInputCell? }`, `range` being the body (`{=TABLE(row, column)}` cells).
+     */
+    dataTables(): string;
     /**
      * How many inbound updates are deferred on a causal gap (a dropped/reordered transport
      * drain). Zero in a healthy stream; persistently non-zero means the host should run a
@@ -266,11 +288,25 @@ export class SpreadsheetEngine {
      * Register a host (JS) custom-function name (`SpreadsheetEngineLike.registerCustomFunction`).
      */
     registerCustomFunction(name: string): void;
+    /**
+     * The workbook's scenarios as a `SheetScenarios[]` JSON — `{ sheetId, scenarios: [{ name,
+     * cells: [{ rowIndex, columnIndex, value }], comment?, user?, locked, hidden }], current?,
+     * show?, resultCells? }` (Data ▸ What-If Analysis ▸ Scenario Manager).
+     */
+    scenarios(): string;
     /**
      * Pin the evaluation timezone for `TODAY()` / `NOW()` as minutes east of UTC (`null` /
      * `undefined` restores the default `Local` clock). Returns `false` for an offset outside ±24h.
      */
     setTimezoneOffsetMinutes(minutes?: number | null): boolean;
+    /**
+     * Where the workbook lives, for `CELL("filename")` — `{directory}[{fileName}]{sheet}`, so the
+     * `MID(CELL("filename"),FIND("]",…)+1,…)` sheet-name idiom works — and `INFO("directory")`.
+     * Hosts pass the asset's title as `fileName` (e.g. `Budget.xlsx`) and may pass a folder path or
+     * URL ending in `/` as `directory`. An empty `fileName` means unsaved (`""`). The next recalc
+     * refreshes the cells that read it.
+     */
+    setWorkbookIdentity(directory: string, file_name: string): void;
     /**
      * Per-sheet 1-based data extents as JSON `[{"sheetId", "maxRow", "maxCol"}]`.
      */
@@ -372,7 +408,10 @@ export interface InitOutput {
     readonly spreadsheetengine_applyCommand: (a: number, b: number, c: number) => [number, number, number, number];
     readonly spreadsheetengine_applyCommandQuiet: (a: number, b: number, c: number) => [number, number];
     readonly spreadsheetengine_applyUpdate: (a: number, b: number, c: number) => [number, number];
+    readonly spreadsheetengine_arrayFormulaAt: (a: number, b: number, c: number, d: number) => [number, number];
     readonly spreadsheetengine_blockCacheStats: (a: number) => [number, number];
+    readonly spreadsheetengine_calculationMode: (a: number) => [number, number];
+    readonly spreadsheetengine_calculationPending: (a: number) => number;
     readonly spreadsheetengine_canRedo: (a: number) => number;
     readonly spreadsheetengine_canUndo: (a: number) => number;
     readonly spreadsheetengine_clearHistory: (a: number) => void;
@@ -380,6 +419,7 @@ export interface InitOutput {
     readonly spreadsheetengine_conditionalFormatRuleStats: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly spreadsheetengine_dataEdge: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly spreadsheetengine_dataRegion: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly spreadsheetengine_dataTables: (a: number) => [number, number];
     readonly spreadsheetengine_deferredRemoteUpdates: (a: number) => number;
     readonly spreadsheetengine_dependents: (a: number, b: number, c: number, d: number) => [number, number];
     readonly spreadsheetengine_documentFacets: (a: number) => [number, number];
@@ -418,7 +458,9 @@ export interface InitOutput {
     readonly spreadsheetengine_redo: (a: number) => [number, number];
     readonly spreadsheetengine_redoDepth: (a: number) => number;
     readonly spreadsheetengine_registerCustomFunction: (a: number, b: number, c: number) => void;
+    readonly spreadsheetengine_scenarios: (a: number) => [number, number];
     readonly spreadsheetengine_setTimezoneOffsetMinutes: (a: number, b: number) => number;
+    readonly spreadsheetengine_setWorkbookIdentity: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly spreadsheetengine_sheetExtents: (a: number) => [number, number];
     readonly spreadsheetengine_sheetIds: (a: number) => [number, number];
     readonly spreadsheetengine_sheetStats: (a: number) => [number, number];

package/dist/rnc_yrs_store.js

@@ -77,6 +77,29 @@ export class SpreadsheetEngine {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell, as JSON
+     * `{"range":{startRowIndex,endRowIndex,startColumnIndex,endColumnIndex},"formula":"=…"}`, or
+     * `null` — the same shape as `rnc-engine`'s `SpreadsheetEngine.arrayFormulaAt`, which the
+     * `@rowsncolumns/rnc-engine` wrapper feature-detects (formula-bar `{…}` display, re-entry
+     * range, part-of-array checks in the editor).
+     * @param {number} sheet_id
+     * @param {number} row
+     * @param {number} col
+     * @returns {string}
+     */
+    arrayFormulaAt(sheet_id, row, col) {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_arrayFormulaAt(this.__wbg_ptr, sheet_id, row, col);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Cold-block body cache diagnostics as JSON `{"hits", "misses", "bytes"}`.
      * @returns {string}
@@ -93,6 +116,31 @@ export class SpreadsheetEngine {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * The workbook calculation mode: `"auto"`, `"autoNoTable"` or `"manual"`. Set it with the
+     * `set-calculation-mode` command.
+     * @returns {string}
+     */
+    calculationMode() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_calculationMode(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Manual mode: formulas may be out of date — show "Calculate" in the status bar.
+     * @returns {boolean}
+     */
+    calculationPending() {
+        const ret = wasm.spreadsheetengine_calculationPending(this.__wbg_ptr);
+        return ret !== 0;
+    }
     /**
      * @returns {boolean}
      */
@@ -211,6 +259,23 @@ export class SpreadsheetEngine {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * The workbook's What-If data tables as a `DataTable[]` JSON — `{ sheetId, range,
+     * rowInputCell?, columnInputCell? }`, `range` being the body (`{=TABLE(row, column)}` cells).
+     * @returns {string}
+     */
+    dataTables() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_dataTables(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * How many inbound updates are deferred on a causal gap (a dropped/reordered transport
      * drain). Zero in a healthy stream; persistently non-zero means the host should run a
@@ -922,6 +987,24 @@ export class SpreadsheetEngine {
         const len0 = WASM_VECTOR_LEN;
         wasm.spreadsheetengine_registerCustomFunction(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * The workbook's scenarios as a `SheetScenarios[]` JSON — `{ sheetId, scenarios: [{ name,
+     * cells: [{ rowIndex, columnIndex, value }], comment?, user?, locked, hidden }], current?,
+     * show?, resultCells? }` (Data ▸ What-If Analysis ▸ Scenario Manager).
+     * @returns {string}
+     */
+    scenarios() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_scenarios(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Pin the evaluation timezone for `TODAY()` / `NOW()` as minutes east of UTC (`null` /
      * `undefined` restores the default `Local` clock). Returns `false` for an offset outside ±24h.
@@ -932,6 +1015,22 @@ export class SpreadsheetEngine {
         const ret = wasm.spreadsheetengine_setTimezoneOffsetMinutes(this.__wbg_ptr, isLikeNone(minutes) ? Number.MAX_SAFE_INTEGER : (minutes) >> 0);
         return ret !== 0;
     }
+    /**
+     * Where the workbook lives, for `CELL("filename")` — `{directory}[{fileName}]{sheet}`, so the
+     * `MID(CELL("filename"),FIND("]",…)+1,…)` sheet-name idiom works — and `INFO("directory")`.
+     * Hosts pass the asset's title as `fileName` (e.g. `Budget.xlsx`) and may pass a folder path or
+     * URL ending in `/` as `directory`. An empty `fileName` means unsaved (`""`). The next recalc
+     * refreshes the cells that read it.
+     * @param {string} directory
+     * @param {string} file_name
+     */
+    setWorkbookIdentity(directory, file_name) {
+        const ptr0 = passStringToWasm0(directory, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(file_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.spreadsheetengine_setWorkbookIdentity(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+    }
     /**
      * Per-sheet 1-based data extents as JSON `[{"sheetId", "maxRow", "maxCol"}]`.
      * @returns {string}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/rnc-yrs-store",
-  "version": "0.14.2",
+  "version": "0.15.1",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "description": "Document-backed Rust→WASM spreadsheet calc engine (yrs/CRDT, canonical sheetDataV3). Ships the `SpreadsheetEngine` (a `Store<YrsStore>`): applyCommand / undo / redo / canUndo + the Yjs collaboration surface (applyUpdate / takePendingUpdates / loadFromUpdate / stateAsUpdate) the Keryx update-pump binds to. This is the 1,000,000-row engine the demo-app ships today — previously vendored, now a versioned package. The PREBUILT wasm is included (consumers need NO Rust/wasm toolchain); the glue's default init REQUIRES an explicit `module_or_path` — pass the URL of the served `rnc_yrs_store_bg.wasm` (webpack/Turbopack statically resolve a bundled `new URL`, which would 404 from this package, so the inline-default branch is intentionally a throw).",