logisheets 1.11.0 → 1.12.1

package/dist/src/api/workbook.d.ts

@@ -127,7 +127,17 @@ export declare class Workbook {
     batchGetCellCoordinateWithSheetById(ids: readonly SheetCellId[]): Result<readonly CellCoordinateWithSheet[]>;
     execTransaction(tx: Transaction): ActionEffect;
     load(buf: Uint8Array, bookName: string): ReturnCode;
-    save(data: string): SaveFileResult;
+    /**
+     * Serialize to .xlsx bytes.
+     *
+     * `resolveBlockRefs` writes 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 must recalculate needs the coordinates. One-way — a
+     * resolved `BLOCKREFS` becomes a plain range, which LogiSheets does not
+     * parse back when it straddles a block.
+     */
+    save(data: string, resolveBlockRefs?: boolean): SaveFileResult;
     getAppData(): readonly AppData[];
     /** Monotonic counter bumped on every committed write — snapshot it to
      *  detect concurrent modification (optimistic concurrency). */

package/dist/src/api/workbook.js

@@ -302,7 +302,7 @@ class Workbook {
         rpc('commitTempStatus', undefined, this._id);
     }
     cleanupTempStatus() {
-        rpc('cleanTempStatus', undefined, this._id);
+        rpc('cleanupTempStatus', undefined, this._id);
     }
     toggleStatus(useTemp) {
         rpc('toggleStatus', { useTemp }, this._id);
@@ -365,8 +365,18 @@ class Workbook {
     load(buf, bookName) {
         return rpc('loadWorkbook', { content: Array.from(buf), name: bookName }, this._id);
     }
-    save(data) {
-        return rpc('saveWorkbook', { appData: data }, this._id);
+    /**
+     * Serialize to .xlsx bytes.
+     *
+     * `resolveBlockRefs` writes 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 must recalculate needs the coordinates. One-way — a
+     * resolved `BLOCKREFS` becomes a plain range, which LogiSheets does not
+     * parse back when it straddles a block.
+     */
+    save(data, resolveBlockRefs = false) {
+        return rpc('saveWorkbook', { appData: data, resolveBlockRefs }, this._id);
     }
     getAppData() {
         return rpc('getAppData', undefined, this._id);

package/dist/src/bindings/action_effect.d.ts

@@ -17,6 +17,7 @@ export interface ActionEffect {
     colRemoved: readonly SheetColId[];
     colUpdated: readonly SheetColId[];
     headerUpdated: readonly number[];
+    errorMessage?: string;
 }
 export declare class ActionEffectBuilder {
     private _version;
@@ -32,6 +33,7 @@ export declare class ActionEffectBuilder {
     private _colRemoved;
     private _colUpdated;
     private _headerUpdated;
+    private _errorMessage?;
     version(value: number): this;
     asyncTasks(value: readonly Task[]): this;
     status(value: StatusCode): this;
@@ -45,6 +47,7 @@ export declare class ActionEffectBuilder {
     colRemoved(value: readonly SheetColId[]): this;
     colUpdated(value: readonly SheetColId[]): this;
     headerUpdated(value: readonly number[]): this;
+    errorMessage(value: string): this;
     build(): {
         version: number;
         asyncTasks: readonly Task[];
@@ -59,5 +62,6 @@ export declare class ActionEffectBuilder {
         colRemoved: readonly SheetColId[];
         colUpdated: readonly SheetColId[];
         headerUpdated: readonly number[];
+        errorMessage: string | undefined;
     };
 }

package/dist/src/bindings/action_effect.js

@@ -15,6 +15,7 @@ class ActionEffectBuilder {
     _colRemoved;
     _colUpdated;
     _headerUpdated;
+    _errorMessage;
     version(value) {
         this._version = value;
         return this;
@@ -67,6 +68,10 @@ class ActionEffectBuilder {
         this._headerUpdated = value;
         return this;
     }
+    errorMessage(value) {
+        this._errorMessage = value;
+        return this;
+    }
     build() {
         if (this._version === undefined)
             throw new Error('missing version');
@@ -94,7 +99,7 @@ class ActionEffectBuilder {
             throw new Error('missing colUpdated');
         if (this._headerUpdated === undefined)
             throw new Error('missing headerUpdated');
-        return { version: this._version, asyncTasks: this._asyncTasks, status: this._status, valueChanged: this._valueChanged, cellRemoved: this._cellRemoved, styleChanged: this._styleChanged, rowInserted: this._rowInserted, rowRemoved: this._rowRemoved, rowUpdated: this._rowUpdated, colInserted: this._colInserted, colRemoved: this._colRemoved, colUpdated: this._colUpdated, headerUpdated: this._headerUpdated };
+        return { version: this._version, asyncTasks: this._asyncTasks, status: this._status, valueChanged: this._valueChanged, cellRemoved: this._cellRemoved, styleChanged: this._styleChanged, rowInserted: this._rowInserted, rowRemoved: this._rowRemoved, rowUpdated: this._rowUpdated, colInserted: this._colInserted, colRemoved: this._colRemoved, colUpdated: this._colUpdated, headerUpdated: this._headerUpdated, errorMessage: this._errorMessage };
     }
 }
 exports.ActionEffectBuilder = ActionEffectBuilder;

package/dist/src/bindings/rpc_save_params.d.ts

@@ -1,3 +1,4 @@
 export interface SaveParams {
     appData: string;
+    resolveBlockRefs?: boolean;
 }

package/dist/wasm/logisheets_wasm_server.d.ts

@@ -1,20 +1,20 @@
 /* tslint:disable */
 /* eslint-disable */
-export function handle(msg: any, book_id?: number | null): any;
 /**
- * Render a number with an Excel number-format code, natively via `ssf-rs`
- * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
- * the `ssf` npm package. On an unsupported/invalid format it falls back to the
- * JavaScript `String(value)` representation, matching the previous behavior.
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
  */
-export function format_number(fmt: string, value: number): string;
+export function format_text(fmt: string, text: string): string;
 /**
  * Input: AsyncFuncResult
  * Output: ActionAffect
  */
 export function input_async_result(id: number, result: any): any;
 /**
- * Render a text value with an Excel number-format code (for the `@` text
- * section). Falls back to the text itself on an unsupported format.
+ * Render a number with an Excel number-format code, natively via `ssf-rs`
+ * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
+ * the `ssf` npm package. On an unsupported/invalid format it falls back to the
+ * JavaScript `String(value)` representation, matching the previous behavior.
  */
-export function format_text(fmt: string, text: string): string;
+export function format_number(fmt: string, value: number): string;
+export function handle(msg: any, book_id?: number | null): any;

package/dist/wasm/logisheets_wasm_server.js

@@ -171,36 +171,26 @@ function debugString(val) {
     return className;
 }
 /**
- * @param {any} msg
- * @param {number | null} [book_id]
- * @returns {any}
- */
-module.exports.handle = function(msg, book_id) {
-    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
-    return ret;
-};
-
-/**
- * Render a number with an Excel number-format code, natively via `ssf-rs`
- * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
- * the `ssf` npm package. On an unsupported/invalid format it falls back to the
- * JavaScript `String(value)` representation, matching the previous behavior.
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
  * @param {string} fmt
- * @param {number} value
+ * @param {string} text
  * @returns {string}
  */
-module.exports.format_number = function(fmt, value) {
-    let deferred2_0;
-    let deferred2_1;
+module.exports.format_text = function(fmt, text) {
+    let deferred3_0;
+    let deferred3_1;
     try {
         const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.format_number(ptr0, len0, value);
-        deferred2_0 = ret[0];
-        deferred2_1 = ret[1];
+        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
+        deferred3_0 = ret[0];
+        deferred3_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
     } finally {
-        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 };
 
@@ -217,29 +207,39 @@ module.exports.input_async_result = function(id, result) {
 };
 
 /**
- * Render a text value with an Excel number-format code (for the `@` text
- * section). Falls back to the text itself on an unsupported format.
+ * Render a number with an Excel number-format code, natively via `ssf-rs`
+ * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
+ * the `ssf` npm package. On an unsupported/invalid format it falls back to the
+ * JavaScript `String(value)` representation, matching the previous behavior.
  * @param {string} fmt
- * @param {string} text
+ * @param {number} value
  * @returns {string}
  */
-module.exports.format_text = function(fmt, text) {
-    let deferred3_0;
-    let deferred3_1;
+module.exports.format_number = function(fmt, value) {
+    let deferred2_0;
+    let deferred2_1;
     try {
         const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len1 = WASM_VECTOR_LEN;
-        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
-        deferred3_0 = ret[0];
-        deferred3_1 = ret[1];
+        const ret = wasm.format_number(ptr0, len0, value);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
     } finally {
-        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
     }
 };
 
+/**
+ * @param {any} msg
+ * @param {number | null} [book_id]
+ * @returns {any}
+ */
+module.exports.handle = function(msg, book_id) {
+    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+    return ret;
+};
+
 module.exports.__wbg_String_eecc4a11987127d6 = function(arg0, arg1) {
     const ret = String(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);

package/dist/wasm/logisheets_wasm_server_bg.wasm.d.ts

@@ -1,10 +1,10 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const handle: (a: any, b: number) => any;
 export const format_number: (a: number, b: number, c: number) => [number, number];
 export const format_text: (a: number, b: number, c: number, d: number) => [number, number];
 export const input_async_result: (a: number, b: any) => any;
+export const handle: (a: any, b: number) => any;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/dist/wasm/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "JeremyHe <yiliang.he@qq.com>"
   ],
-  "version": "1.11.0",
+  "version": "1.12.1",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logisheets",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "Node.js bindings for LogiSheets — a Rust + WebAssembly spreadsheet engine that reads, edits, and writes real .xlsx (Excel) files (formulas, styles, and structure preserved) with no browser required.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/wasm/logisheets_wasm_server.d.ts

@@ -1,20 +1,20 @@
 /* tslint:disable */
 /* eslint-disable */
-export function handle(msg: any, book_id?: number | null): any;
 /**
- * Render a number with an Excel number-format code, natively via `ssf-rs`
- * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
- * the `ssf` npm package. On an unsupported/invalid format it falls back to the
- * JavaScript `String(value)` representation, matching the previous behavior.
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
  */
-export function format_number(fmt: string, value: number): string;
+export function format_text(fmt: string, text: string): string;
 /**
  * Input: AsyncFuncResult
  * Output: ActionAffect
  */
 export function input_async_result(id: number, result: any): any;
 /**
- * Render a text value with an Excel number-format code (for the `@` text
- * section). Falls back to the text itself on an unsupported format.
+ * Render a number with an Excel number-format code, natively via `ssf-rs`
+ * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
+ * the `ssf` npm package. On an unsupported/invalid format it falls back to the
+ * JavaScript `String(value)` representation, matching the previous behavior.
  */
-export function format_text(fmt: string, text: string): string;
+export function format_number(fmt: string, value: number): string;
+export function handle(msg: any, book_id?: number | null): any;

package/wasm/logisheets_wasm_server.js

@@ -171,36 +171,26 @@ function debugString(val) {
     return className;
 }
 /**
- * @param {any} msg
- * @param {number | null} [book_id]
- * @returns {any}
- */
-module.exports.handle = function(msg, book_id) {
-    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
-    return ret;
-};
-
-/**
- * Render a number with an Excel number-format code, natively via `ssf-rs`
- * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
- * the `ssf` npm package. On an unsupported/invalid format it falls back to the
- * JavaScript `String(value)` representation, matching the previous behavior.
+ * Render a text value with an Excel number-format code (for the `@` text
+ * section). Falls back to the text itself on an unsupported format.
  * @param {string} fmt
- * @param {number} value
+ * @param {string} text
  * @returns {string}
  */
-module.exports.format_number = function(fmt, value) {
-    let deferred2_0;
-    let deferred2_1;
+module.exports.format_text = function(fmt, text) {
+    let deferred3_0;
+    let deferred3_1;
     try {
         const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.format_number(ptr0, len0, value);
-        deferred2_0 = ret[0];
-        deferred2_1 = ret[1];
+        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
+        deferred3_0 = ret[0];
+        deferred3_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
     } finally {
-        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 };
 
@@ -217,29 +207,39 @@ module.exports.input_async_result = function(id, result) {
 };
 
 /**
- * Render a text value with an Excel number-format code (for the `@` text
- * section). Falls back to the text itself on an unsupported format.
+ * Render a number with an Excel number-format code, natively via `ssf-rs`
+ * (the Rust port of SheetJS `ssf`). Replaces the browser's old dependency on
+ * the `ssf` npm package. On an unsupported/invalid format it falls back to the
+ * JavaScript `String(value)` representation, matching the previous behavior.
  * @param {string} fmt
- * @param {string} text
+ * @param {number} value
  * @returns {string}
  */
-module.exports.format_text = function(fmt, text) {
-    let deferred3_0;
-    let deferred3_1;
+module.exports.format_number = function(fmt, value) {
+    let deferred2_0;
+    let deferred2_1;
     try {
         const ptr0 = passStringToWasm0(fmt, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len1 = WASM_VECTOR_LEN;
-        const ret = wasm.format_text(ptr0, len0, ptr1, len1);
-        deferred3_0 = ret[0];
-        deferred3_1 = ret[1];
+        const ret = wasm.format_number(ptr0, len0, value);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
         return getStringFromWasm0(ret[0], ret[1]);
     } finally {
-        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
     }
 };
 
+/**
+ * @param {any} msg
+ * @param {number | null} [book_id]
+ * @returns {any}
+ */
+module.exports.handle = function(msg, book_id) {
+    const ret = wasm.handle(msg, isLikeNone(book_id) ? 0x100000001 : (book_id) >>> 0);
+    return ret;
+};
+
 module.exports.__wbg_String_eecc4a11987127d6 = function(arg0, arg1) {
     const ret = String(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);

package/wasm/logisheets_wasm_server_bg.wasm.d.ts

@@ -1,10 +1,10 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const handle: (a: any, b: number) => any;
 export const format_number: (a: number, b: number, c: number) => [number, number];
 export const format_text: (a: number, b: number, c: number, d: number) => [number, number];
 export const input_async_result: (a: number, b: any) => any;
+export const handle: (a: any, b: number) => any;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/wasm/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "JeremyHe <yiliang.he@qq.com>"
   ],
-  "version": "1.11.0",
+  "version": "1.12.1",
   "files": [
     "logisheets_wasm_server_bg.wasm",
     "logisheets_wasm_server.js",