logisheets-runtime 1.11.0 → 1.12.1

package/dist/index.d.ts

@@ -59,13 +59,19 @@ export declare class Workbook {
      * @param appData opaque per-document JSON the host owns (craft state and
      *                friends). It round-trips through the file; pass what the
      *                engine's `getAppData` gave you, or nothing.
+     * @param resolveBlockRefs write block formulas as ordinary A1 references
+     *                instead of `BLOCKREF(...)`. Off by default: the named form
+     *                is readable and reopens here intact, but no other
+     *                spreadsheet knows those functions, so a file Excel has to
+     *                recalculate needs coordinates. One-way — see the note on
+     *                the engine's `FormulaFormat`.
      */
-    save(appData?: string): Uint8Array;
+    save(appData?: string, resolveBlockRefs?: boolean): Uint8Array;
     /**
      * Serialize and write the workbook to `path`. Defaults to the path it was
      * loaded from, so a load -> edit -> `saveAs()` round-trip needs no argument.
      */
-    saveAs(path?: string, appData?: string): Promise<void>;
+    saveAs(path?: string, appData?: string, resolveBlockRefs?: boolean): Promise<void>;
     /** Undo the most recent transaction. Returns whether anything was undone. */
     undo(): Promise<boolean>;
     /** Redo the most recently undone transaction. Returns whether anything was redone. */

package/dist/index.js

@@ -108,9 +108,15 @@ export class Workbook {
      * @param appData opaque per-document JSON the host owns (craft state and
      *                friends). It round-trips through the file; pass what the
      *                engine's `getAppData` gave you, or nothing.
+     * @param resolveBlockRefs write block formulas as ordinary A1 references
+     *                instead of `BLOCKREF(...)`. Off by default: the named form
+     *                is readable and reopens here intact, but no other
+     *                spreadsheet knows those functions, so a file Excel has to
+     *                recalculate needs coordinates. One-way — see the note on
+     *                the engine's `FormulaFormat`.
      */
-    save(appData = '') {
-        const r = handle({ method: 'saveWorkbook', value: { appData } }, this.id);
+    save(appData = '', resolveBlockRefs = false) {
+        const r = handle({ method: 'saveWorkbook', value: { appData, resolveBlockRefs } }, this.id);
         if (r.code !== 0) {
             throw new Error(`failed to save workbook (code ${r.code})`);
         }
@@ -123,12 +129,12 @@ export class Workbook {
      * Serialize and write the workbook to `path`. Defaults to the path it was
      * loaded from, so a load -> edit -> `saveAs()` round-trip needs no argument.
      */
-    async saveAs(path, appData = '') {
+    async saveAs(path, appData = '', resolveBlockRefs = false) {
         const target = path ?? this.path;
         if (target === undefined) {
             throw new Error('saveAs: no path given and this workbook was not loaded from one');
         }
-        await writeFile(resolve(target), this.save(appData));
+        await writeFile(resolve(target), this.save(appData, resolveBlockRefs));
     }
     /** Undo the most recent transaction. Returns whether anything was undone. */
     async undo() {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "logisheets-runtime",
-    "version": "1.11.0",
+    "version": "1.12.1",
     "description": "Headless LogiSheets spreadsheet runtime for Node — logisheets-core wired to the Node WASM engine. The Node counterpart of the browser app.",
     "type": "module",
     "main": "./dist/index.js",
@@ -39,8 +39,8 @@
     },
     "homepage": "https://github.com/logisky/LogiSheets",
     "dependencies": {
-        "logisheets": "^1.11.0",
-        "logisheets-core": "^1.11.0"
+        "logisheets": "^1.12.1",
+        "logisheets-core": "^1.12.1"
     },
     "devDependencies": {
         "@types/node": "^18",