@rowsncolumns/rnc-yrs-store 0.9.19 → 0.10.1

package/dist/rnc_yrs_store.d.ts

@@ -99,6 +99,14 @@ export class SpreadsheetEngine {
      */
     filterColors(sheet_id: number, col: number, start_row: number, end_row: number): string;
     findAll(sheet_id: number, ranges_json: string, find: string, match_case: boolean, whole_word: boolean, use_regex: boolean): string;
+    /**
+     * Recompute and write back the formula results a remote merge may have left stale — the local
+     * dependents of merged cells — and return the `CommitResult` JSON. A local edit does this
+     * implicitly; call it on a peer that only reads (a viewer, a server-side export) so
+     * concurrent-edit divergence repairs without waiting for one. Never echoes: only a result that
+     * differs from the engine's is written.
+     */
+    flushRemoteDirty(): string;
     /**
      * Every HOST-OWNED formula cell on a sheet (registered custom-function calls + dot accessors)
      * as a `CellChange[]` JSON, row-major (`SpreadsheetEngineLike.hostOwnedCells`). The index-backed
@@ -217,6 +225,11 @@ export class SpreadsheetEngine {
      * Register a host (JS) custom-function name (`SpreadsheetEngineLike.registerCustomFunction`).
      */
     registerCustomFunction(name: string): void;
+    /**
+     * 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;
     /**
      * Per-sheet 1-based data extents as JSON `[{"sheetId", "maxRow", "maxCol"}]`.
      */
@@ -278,66 +291,68 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly __wbg_yrssheetdoc_free: (a: number, b: number) => void;
-    readonly yrssheetdoc_new: () => number;
-    readonly yrssheetdoc_setCell: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly yrssheetdoc_getCell: (a: number, b: number, c: number, d: number) => [number, number];
-    readonly yrssheetdoc_applyUpdate: (a: number, b: number, c: number) => [number, number];
-    readonly yrssheetdoc_encodeStateAsUpdate: (a: number) => [number, number];
     readonly __wbg_spreadsheetengine_free: (a: number, b: number) => void;
-    readonly spreadsheetengine_new: () => number;
+    readonly __wbg_yrssheetdoc_free: (a: number, b: number) => void;
     readonly spreadsheetengine_addSheet: (a: number, b: number, c: number, d: number) => void;
     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_blockCacheStats: (a: number) => [number, number];
+    readonly spreadsheetengine_canRedo: (a: number) => number;
+    readonly spreadsheetengine_canUndo: (a: number) => number;
+    readonly spreadsheetengine_clearHistory: (a: number) => void;
     readonly spreadsheetengine_dataEdge: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
-    readonly spreadsheetengine_documentFacets: (a: number) => [number, number];
-    readonly spreadsheetengine_sheets: (a: number) => [number, number];
-    readonly spreadsheetengine_sheetIds: (a: number) => [number, number];
-    readonly spreadsheetengine_pruneDanglingDefaultSeed: (a: number) => number;
-    readonly spreadsheetengine_loadDocument: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly spreadsheetengine_registerCustomFunction: (a: number, b: number, c: number) => void;
-    readonly spreadsheetengine_precedents: (a: number, b: number, c: number, d: 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];
+    readonly spreadsheetengine_encodeDiffV1: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_encodeStateAsUpdate: (a: number) => [number, number];
+    readonly spreadsheetengine_encodeStateVector: (a: number) => [number, number];
+    readonly spreadsheetengine_evalFormula: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly spreadsheetengine_exportCsv: (a: number, b: number) => [number, number];
+    readonly spreadsheetengine_exportXlsx: (a: number) => [number, number, number, number];
+    readonly spreadsheetengine_exportXlsxWithOptions: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_filterColors: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly spreadsheetengine_findAll: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
+    readonly spreadsheetengine_flushRemoteDirty: (a: number) => [number, number];
     readonly spreadsheetengine_hostOwnedCells: (a: number, b: number) => [number, number];
-    readonly spreadsheetengine_takeCappedFormulas: (a: number) => [number, number];
-    readonly spreadsheetengine_clearHistory: (a: number) => void;
-    readonly spreadsheetengine_undoDepth: (a: number) => number;
-    readonly spreadsheetengine_redoDepth: (a: number) => number;
+    readonly spreadsheetengine_importCsv: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly spreadsheetengine_importXlsx: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly spreadsheetengine_importXlsxWithPassword: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly spreadsheetengine_isEncryptedXlsx: (a: number, b: number, c: number) => number;
-    readonly spreadsheetengine_listXlsxSheets: (a: number, b: number, c: number) => [number, number, number, number];
     readonly spreadsheetengine_importXlsxSheet: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly spreadsheetengine_importXlsxSheetByName: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly spreadsheetengine_importXlsxWithPassword: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly spreadsheetengine_isEncryptedXlsx: (a: number, b: number, c: number) => number;
     readonly spreadsheetengine_lastImportRecalcSkipped: (a: number) => number;
-    readonly spreadsheetengine_rebuildAndRecalc: (a: number) => void;
-    readonly spreadsheetengine_exportCsv: (a: number, b: number) => [number, number];
-    readonly spreadsheetengine_exportXlsx: (a: number) => [number, number, number, number];
-    readonly spreadsheetengine_exportXlsxWithOptions: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_listXlsxSheets: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_loadDocument: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_loadFromUpdate: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_loadFromUpdateQuiet: (a: number, b: number, c: number) => [number, number];
+    readonly spreadsheetengine_new: () => number;
     readonly spreadsheetengine_parseCsv: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly spreadsheetengine_importCsv: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
-    readonly spreadsheetengine_undo: (a: number) => [number, number];
-    readonly spreadsheetengine_redo: (a: number) => [number, number];
-    readonly spreadsheetengine_canUndo: (a: number) => number;
-    readonly spreadsheetengine_canRedo: (a: number) => number;
+    readonly spreadsheetengine_precedents: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly spreadsheetengine_pruneDanglingDefaultSeed: (a: number) => number;
     readonly spreadsheetengine_readWindow: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly spreadsheetengine_evalFormula: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly spreadsheetengine_filterColors: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly spreadsheetengine_findAll: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
-    readonly spreadsheetengine_readWindowCommit: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly spreadsheetengine_readWindowCells: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly spreadsheetengine_readWindowCommit: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly spreadsheetengine_rebuildAndRecalc: (a: number) => void;
+    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_setTimezoneOffsetMinutes: (a: number, b: number) => number;
     readonly spreadsheetengine_sheetExtents: (a: number) => [number, number];
+    readonly spreadsheetengine_sheetIds: (a: number) => [number, number];
     readonly spreadsheetengine_sheetStats: (a: number) => [number, number];
-    readonly spreadsheetengine_blockCacheStats: (a: number) => [number, number];
-    readonly spreadsheetengine_applyUpdate: (a: number, b: number, c: number) => [number, number];
+    readonly spreadsheetengine_sheets: (a: number) => [number, number];
     readonly spreadsheetengine_syncRemote: (a: number) => [number, number];
-    readonly spreadsheetengine_loadFromUpdate: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly spreadsheetengine_loadFromUpdateQuiet: (a: number, b: number, c: number) => [number, number];
+    readonly spreadsheetengine_takeCappedFormulas: (a: number) => [number, number];
     readonly spreadsheetengine_takePendingUpdates: (a: number) => [number, number];
-    readonly spreadsheetengine_encodeStateAsUpdate: (a: number) => [number, number];
-    readonly spreadsheetengine_encodeStateVector: (a: number) => [number, number];
-    readonly spreadsheetengine_encodeDiffV1: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly spreadsheetengine_deferredRemoteUpdates: (a: number) => number;
+    readonly spreadsheetengine_undo: (a: number) => [number, number];
+    readonly spreadsheetengine_undoDepth: (a: number) => number;
+    readonly yrssheetdoc_applyUpdate: (a: number, b: number, c: number) => [number, number];
+    readonly yrssheetdoc_encodeStateAsUpdate: (a: number) => [number, number];
+    readonly yrssheetdoc_getCell: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly yrssheetdoc_new: () => number;
+    readonly yrssheetdoc_setCell: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly spreadsheetengine_stateAsUpdate: (a: number) => [number, number];
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_exn_store: (a: number) => void;

package/dist/rnc_yrs_store.js

@@ -338,6 +338,26 @@ export class SpreadsheetEngine {
             wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
         }
     }
+    /**
+     * Recompute and write back the formula results a remote merge may have left stale — the local
+     * dependents of merged cells — and return the `CommitResult` JSON. A local edit does this
+     * implicitly; call it on a peer that only reads (a viewer, a server-side export) so
+     * concurrent-edit divergence repairs without waiting for one. Never echoes: only a result that
+     * differs from the engine's is written.
+     * @returns {string}
+     */
+    flushRemoteDirty() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_flushRemoteDirty(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);
+        }
+    }
     /**
      * Every HOST-OWNED formula cell on a sheet (registered custom-function calls + dot accessors)
      * as a `CellChange[]` JSON, row-major (`SpreadsheetEngineLike.hostOwnedCells`). The index-backed
@@ -784,6 +804,16 @@ export class SpreadsheetEngine {
         const len0 = WASM_VECTOR_LEN;
         wasm.spreadsheetengine_registerCustomFunction(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * 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.
+     * @param {number | null} [minutes]
+     * @returns {boolean}
+     */
+    setTimezoneOffsetMinutes(minutes) {
+        const ret = wasm.spreadsheetengine_setTimezoneOffsetMinutes(this.__wbg_ptr, isLikeNone(minutes) ? Number.MAX_SAFE_INTEGER : (minutes) >> 0);
+        return ret !== 0;
+    }
     /**
      * 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.9.19",
+  "version": "0.10.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).",