@truecalc/core 0.4.19 → 0.5.0

package/package.json

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

package/truecalc_wasm.d.ts

@@ -15,6 +15,29 @@ export interface ValidateResult {
 export type EvalResult = { type: "number"; value: number } | { type: "text"; value: string } | { type: "bool"; value: boolean } | { type: "error"; error: string } | { type: "empty" };
 
 
+/**
+ * A stateful engine bound to a conformance target.
+ *
+ * Obtained via `createEngine('google-sheets')`.
+ */
+export class Engine {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Evaluate a formula using this engine's conformance target.
+     */
+    evaluate(formula: string, variables: any): EvalResult;
+}
+
+/**
+ * Create an engine for a specific conformance target.
+ *
+ * Supported targets: `"google-sheets"`.
+ * Returns an error for unknown targets.
+ */
+export function createEngine(target: string): Engine;
+
 /**
  * Evaluate a formula with named variables supplied as a JS object.
  *

package/truecalc_wasm.js

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

package/truecalc_wasm_bg.js

@@ -1,3 +1,67 @@
+/**
+ * A stateful engine bound to a conformance target.
+ *
+ * Obtained via `createEngine('google-sheets')`.
+ */
+export class Engine {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(Engine.prototype);
+        obj.__wbg_ptr = ptr;
+        EngineFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        EngineFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_engine_free(ptr, 0);
+    }
+    /**
+     * Evaluate a formula using this engine's conformance target.
+     * @param {string} formula
+     * @param {any} variables
+     * @returns {EvalResult}
+     */
+    evaluate(formula, variables) {
+        const ptr0 = passStringToWasm0(formula, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmengine_evaluate(this.__wbg_ptr, ptr0, len0, addHeapObject(variables));
+        return takeObject(ret);
+    }
+}
+if (Symbol.dispose) Engine.prototype[Symbol.dispose] = Engine.prototype.free;
+
+/**
+ * Create an engine for a specific conformance target.
+ *
+ * Supported targets: `"google-sheets"`.
+ * Returns an error for unknown targets.
+ * @param {string} target
+ * @returns {Engine}
+ */
+export function createEngine(target) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(target, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.createEngine(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return Engine.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Evaluate a formula with named variables supplied as a JS object.
  *
@@ -238,6 +302,10 @@ export function __wbindgen_object_clone_ref(arg0) {
 export function __wbindgen_object_drop_ref(arg0) {
     takeObject(arg0);
 }
+const EngineFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_engine_free(ptr >>> 0, 1));
+
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);
     const idx = heap_next;