@viewscript/wasm 0.1.0-202605140732 → 0.1.0-20260514130715

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@viewscript/wasm",
   "type": "module",
-  "version": "0.1.0-202605140732",
+  "version": "0.1.0-20260514130715",
   "license": "MIT OR Apache-2.0",
   "files": [
     "vsc_wasm_bg.wasm",

package/vsc_wasm.d.ts

@@ -174,6 +174,38 @@ export class WasmViewScriptEngine {
      * A `Promise` that resolves to `WasmViewScriptEngine` or rejects with an error.
      */
     static create(canvas: HTMLCanvasElement, device_pixel_ratio: number): Promise<WasmViewScriptEngine>;
+    /**
+     * Load an FFI manifest generated by the Vite plugin.
+     *
+     * This method registers:
+     * - `bindings`: Q-dimension variables bound to JS functions
+     * - `triggers`: Post-solve conditions that fire FFI calls
+     *
+     * # Arguments
+     *
+     * * `manifest_json` - JSON string conforming to FfiManifest schema
+     *
+     * # Example
+     *
+     * ```json
+     * {
+     *   "version": 1,
+     *   "entity_map": { "button": 42, "cursor": 57 },
+     *   "bindings": [
+     *     { "ffi_id": 1, "bind_name": "mouse.x", "module_path": "./input.ts", "export_name": "getMouseX" }
+     *   ],
+     *   "triggers": [
+     *     {
+     *       "trigger_id": 100,
+     *       "ffi_id": 2,
+     *       "condition": { "kind": "bounds_overlap", "entity_a": 42, "entity_b": 57 },
+     *       "args": []
+     *     }
+     *   ]
+     * }
+     * ```
+     */
+    loadFfiManifest(manifest_json: string): void;
     /**
      * Register a static image texture.
      *
@@ -271,9 +303,11 @@ export class WasmViewScriptEngine {
      *
      * # Returns
      *
-     * `Ok(())` on success, or a JavaScript error on failure.
+     * JSON string with `TickResult`:
+     * - `{"pending_ffi_calls": []}` when no triggers fired
+     * - `{"pending_ffi_calls": [{"ffi_id": 2, "args": [...]}]}` when triggers fired
      */
-    tick(input_json: string): void;
+    tick(input_json: string): string;
     /**
      * Update texture pixel data.
      *
@@ -329,6 +363,7 @@ export interface InitOutput {
     readonly wasmviewscriptengine_add_component: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly wasmviewscriptengine_create: (a: number, b: number) => number;
     readonly wasmviewscriptengine_height: (a: number) => number;
+    readonly wasmviewscriptengine_loadFfiManifest: (a: number, b: number, c: number, d: number) => void;
     readonly wasmviewscriptengine_register_image_texture: (a: number, b: number, c: number, d: number, e: number) => bigint;
     readonly wasmviewscriptengine_register_video_texture: (a: number, b: number, c: number) => bigint;
     readonly wasmviewscriptengine_remove_texture: (a: number, b: bigint) => number;
@@ -338,10 +373,10 @@ export interface InitOutput {
     readonly wasmviewscriptengine_tick: (a: number, b: number, c: number, d: number) => void;
     readonly wasmviewscriptengine_update_texture_pixels: (a: number, b: bigint, c: number, d: number) => number;
     readonly wasmviewscriptengine_width: (a: number) => number;
-    readonly __wasm_bindgen_func_elem_3241: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_3263: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_1613: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_1613_2: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3646: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3668: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2018: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_2018_2: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/vsc_wasm.js

@@ -262,6 +262,53 @@ export class WasmViewScriptEngine {
         const ret = wasm.wasmviewscriptengine_height(this.__wbg_ptr);
         return ret >>> 0;
     }
+    /**
+     * Load an FFI manifest generated by the Vite plugin.
+     *
+     * This method registers:
+     * - `bindings`: Q-dimension variables bound to JS functions
+     * - `triggers`: Post-solve conditions that fire FFI calls
+     *
+     * # Arguments
+     *
+     * * `manifest_json` - JSON string conforming to FfiManifest schema
+     *
+     * # Example
+     *
+     * ```json
+     * {
+     *   "version": 1,
+     *   "entity_map": { "button": 42, "cursor": 57 },
+     *   "bindings": [
+     *     { "ffi_id": 1, "bind_name": "mouse.x", "module_path": "./input.ts", "export_name": "getMouseX" }
+     *   ],
+     *   "triggers": [
+     *     {
+     *       "trigger_id": 100,
+     *       "ffi_id": 2,
+     *       "condition": { "kind": "bounds_overlap", "entity_a": 42, "entity_b": 57 },
+     *       "args": []
+     *     }
+     *   ]
+     * }
+     * ```
+     * @param {string} manifest_json
+     */
+    loadFfiManifest(manifest_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(manifest_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmviewscriptengine_loadFfiManifest(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Register a static image texture.
      *
@@ -411,10 +458,15 @@ export class WasmViewScriptEngine {
      *
      * # Returns
      *
-     * `Ok(())` on success, or a JavaScript error on failure.
+     * JSON string with `TickResult`:
+     * - `{"pending_ffi_calls": []}` when no triggers fired
+     * - `{"pending_ffi_calls": [{"ffi_id": 2, "args": [...]}]}` when triggers fired
      * @param {string} input_json
+     * @returns {string}
      */
     tick(input_json) {
+        let deferred3_0;
+        let deferred3_1;
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             const ptr0 = passStringToWasm0(input_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
@@ -422,11 +474,20 @@ export class WasmViewScriptEngine {
             wasm.wasmviewscriptengine_tick(retptr, this.__wbg_ptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            if (r1) {
-                throw takeObject(r0);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr2 = r0;
+            var len2 = r1;
+            if (r3) {
+                ptr2 = 0; len2 = 0;
+                throw takeObject(r2);
             }
+            deferred3_0 = ptr2;
+            deferred3_1 = len2;
+            return getStringFromWasm0(ptr2, len2);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
         }
     }
     /**
@@ -1057,7 +1118,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_3263(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_3668(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -1292,18 +1353,18 @@ function __wbg_get_imports() {
             getObject(arg0).writeTexture(getObject(arg1), getObject(arg2), getObject(arg3), getObject(arg4));
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 151, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_1613);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 176, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_2018);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 370, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3241);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 395, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3646);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("GPUUncapturedErrorEvent")], shim_idx: 151, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_1613_2);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("GPUUncapturedErrorEvent")], shim_idx: 176, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_2018_2);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000004: function(arg0) {
@@ -1335,18 +1396,18 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_1613(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_1613(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_2018(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_2018(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_1613_2(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_1613_2(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_2018_2(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_2018_2(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3241(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_3646(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_3241(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_3646(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -1357,8 +1418,8 @@ function __wasm_bindgen_func_elem_3241(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_3263(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_3263(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_3668(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_3668(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }