@truecalc/core 2.0.1 → 3.0.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@truecalc/core",
   "type": "module",
   "description": "Spreadsheet formula engine for the browser — Google Sheets–compatible formula evaluator compiled to WebAssembly",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/truecalc_wasm.d.ts

@@ -31,6 +31,11 @@ export interface FunctionInfo {
     description: string;
 }
 
+export interface TranslateResult {
+    formula?: string;
+    error?: string;
+}
+
 export interface ValidateResult {
     valid: boolean;
     error?: string;
@@ -75,6 +80,15 @@ export function evaluate(formula: string, variables: any): EvalResult;
  */
 export function list_functions(): FunctionInfo[];
 
+/**
+ * Shift every relative cell/range reference in `formula` by `(d_row, d_col)`
+ * — the fill / copy-paste reference-adjustment transform. `$`-absolute axes
+ * are left unchanged; an out-of-bounds corner becomes literal `#REF!`.
+ *
+ * Sheets flavor only (issue #709 v1); Excel support is a follow-up.
+ */
+export function translate_formula(formula: string, d_row: number, d_col: number): TranslateResult;
+
 /**
  * Validate a formula string without evaluating it.
  *

package/truecalc_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./truecalc_wasm_bg.js";
 __wbg_set_wasm(wasm);
 
 export {
-    Engine, createEngine, evaluate, list_functions, validate
+    Engine, createEngine, evaluate, list_functions, translate_formula, validate
 } from "./truecalc_wasm_bg.js";

package/truecalc_wasm_bg.js

@@ -98,6 +98,24 @@ export function list_functions() {
     }
 }
 
+/**
+ * Shift every relative cell/range reference in `formula` by `(d_row, d_col)`
+ * — the fill / copy-paste reference-adjustment transform. `$`-absolute axes
+ * are left unchanged; an out-of-bounds corner becomes literal `#REF!`.
+ *
+ * Sheets flavor only (issue #709 v1); Excel support is a follow-up.
+ * @param {string} formula
+ * @param {number} d_row
+ * @param {number} d_col
+ * @returns {TranslateResult}
+ */
+export function translate_formula(formula, d_row, d_col) {
+    const ptr0 = passStringToWasm0(formula, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.translate_formula(ptr0, len0, d_row, d_col);
+    return takeObject(ret);
+}
+
 /**
  * Validate a formula string without evaluating it.
  *