virtual-machine 0.0.31 → 0.0.32

package/README.md

@@ -74,3 +74,4 @@ cargo build --release
 wasm-pack build --target web
 ```
 
+

package/build/{chunk-CP2XF74Q.mjs → chunk-PD2KO7C4.mjs}

@@ -206,18 +206,25 @@ if (!("encodeInto" in cachedTextEncoder)) {
   };
 }
 var WASM_VECTOR_LEN = 0;
-function wasm_bindgen__convert__closures_____invoke__h5a9b831ab69bf07a(arg0, arg1) {
-  wasm.wasm_bindgen__convert__closures_____invoke__h5a9b831ab69bf07a(arg0, arg1);
-}
-function wasm_bindgen__convert__closures_____invoke__hc493fd296d4613a9(arg0, arg1) {
-  wasm.wasm_bindgen__convert__closures_____invoke__hc493fd296d4613a9(arg0, arg1);
-}
 function wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765(arg0, arg1, arg2) {
   wasm.wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765(arg0, arg1, arg2);
 }
+function wasm_bindgen__convert__closures_____invoke__h67573e759d30b522(arg0, arg1) {
+  wasm.wasm_bindgen__convert__closures_____invoke__h67573e759d30b522(arg0, arg1);
+}
+function wasm_bindgen__convert__closures_____invoke__hb59a63b35a5a8674(arg0, arg1, arg2) {
+  wasm.wasm_bindgen__convert__closures_____invoke__hb59a63b35a5a8674(arg0, arg1, arg2);
+}
+function wasm_bindgen__convert__closures_____invoke__hf580618779cd5844(arg0, arg1) {
+  wasm.wasm_bindgen__convert__closures_____invoke__hf580618779cd5844(arg0, arg1);
+}
+var __wbindgen_enum_WorkerType = ["classic", "module"];
 var WasmVmFinalization = typeof FinalizationRegistry === "undefined" ? { register: () => {
 }, unregister: () => {
 } } : new FinalizationRegistry((ptr) => wasm.__wbg_wasmvm_free(ptr >>> 0, 1));
+var WorkerStateFinalization = typeof FinalizationRegistry === "undefined" ? { register: () => {
+}, unregister: () => {
+} } : new FinalizationRegistry((ptr) => wasm.__wbg_workerstate_free(ptr >>> 0, 1));
 var NetworkStatus = Object.freeze({
   Disconnected: 0,
   "0": "Disconnected",
@@ -228,7 +235,14 @@ var NetworkStatus = Object.freeze({
   Error: 3,
   "3": "Error"
 });
-var WasmVm = class {
+var WasmVm = class _WasmVm {
+  static __wrap(ptr) {
+    ptr = ptr >>> 0;
+    const obj = Object.create(_WasmVm.prototype);
+    obj.__wbg_ptr = ptr;
+    WasmVmFinalization.register(obj, obj.__wbg_ptr, obj);
+    return obj;
+  }
   __destroy_into_raw() {
     const ptr = this.__wbg_ptr;
     this.__wbg_ptr = 0;
@@ -241,6 +255,9 @@ var WasmVm = class {
   }
   /**
    * Get a byte from the UART output buffer, if available.
+   *
+   * In SMP mode, this checks both the shared UART output buffer (for worker output)
+   * and the local UART buffer (for hart 0 output).
    * @returns {number | undefined}
    */
   get_output() {
@@ -263,6 +280,24 @@ var WasmVm = class {
     const len0 = WASM_VECTOR_LEN;
     wasm.wasmvm_print_status(this.__wbg_ptr, ptr0, len0);
   }
+  /**
+   * Start worker threads for secondary harts (1..num_harts).
+   *
+   * Workers run in parallel with the main thread, sharing DRAM and CLINT
+   * via SharedArrayBuffer.
+   *
+   * # Arguments
+   * * `worker_url` - URL to the worker script (e.g., "/worker.js")
+   * @param {string} worker_url
+   */
+  start_workers(worker_url) {
+    const ptr0 = passStringToWasm0(worker_url, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.wasmvm_start_workers(this.__wbg_ptr, ptr0, len0);
+    if (ret[1]) {
+      throw takeFromExternrefTable0(ret[0]);
+    }
+  }
   /**
    * Get the current network connection status.
    * This checks the actual connection state by seeing if an IP was assigned.
@@ -272,6 +307,25 @@ var WasmVm = class {
     const ret = wasm.wasmvm_network_status(this.__wbg_ptr);
     return ret;
   }
+  /**
+   * Create a new VM instance with a specified number of harts.
+   *
+   * # Arguments
+   * * `kernel` - ELF kernel binary
+   * * `num_harts` - Number of harts (0 = auto-detect)
+   * @param {Uint8Array} kernel
+   * @param {number} num_harts
+   * @returns {WasmVm}
+   */
+  static new_with_harts(kernel, num_harts) {
+    const ptr0 = passArray8ToWasm0(kernel, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.wasmvm_new_with_harts(ptr0, len0, num_harts);
+    if (ret[2]) {
+      throw takeFromExternrefTable0(ret[1]);
+    }
+    return _WasmVm.__wrap(ret[0]);
+  }
   /**
    * Get current memory usage (DRAM size) in bytes.
    * @returns {bigint}
@@ -280,6 +334,21 @@ var WasmVm = class {
     const ret = wasm.wasmvm_get_memory_usage(this.__wbg_ptr);
     return BigInt.asUintN(64, ret);
   }
+  /**
+   * Get the SharedArrayBuffer for external worker management.
+   * Returns None if not in SMP mode.
+   * @returns {SharedArrayBuffer | undefined}
+   */
+  get_shared_buffer() {
+    const ret = wasm.wasmvm_get_shared_buffer(this.__wbg_ptr);
+    return ret;
+  }
+  /**
+   * Terminate all workers.
+   */
+  terminate_workers() {
+    wasm.wasmvm_terminate_workers(this.__wbg_ptr);
+  }
   /**
    * Disconnect from the network.
    */
@@ -313,6 +382,12 @@ var WasmVm = class {
   }
   /**
    * Create a new VM instance and load a kernel (ELF or raw binary).
+   *
+   * If SharedArrayBuffer is available, the VM will use true parallel
+   * execution with Web Workers. Otherwise, falls back to single-threaded mode.
+   *
+   * Hart count is auto-detected as half of hardware_concurrency.
+   * Use `new_with_harts()` to specify a custom hart count.
    * @param {Uint8Array} kernel
    */
   constructor(kernel) {
@@ -327,7 +402,11 @@ var WasmVm = class {
     return this;
   }
   /**
-   * Execute one instruction on each CPU (round-robin).
+   * Execute one instruction on hart 0 (primary hart).
+   *
+   * In SMP mode, secondary harts run in Web Workers and execute in parallel.
+   * This method only steps hart 0, which handles I/O coordination.
+   *
    * Returns true if the VM is still running, false if halted.
    * @returns {boolean}
    */
@@ -337,11 +416,20 @@ var WasmVm = class {
   }
   /**
    * Push an input byte to the UART.
+   * In SMP mode, this also writes to the shared input buffer so workers can receive it.
    * @param {number} byte
    */
   input(byte) {
     wasm.wasmvm_input(this.__wbg_ptr, byte);
   }
+  /**
+   * Check if running in SMP mode (with workers).
+   * @returns {boolean}
+   */
+  is_smp() {
+    const ret = wasm.wasmvm_is_smp(this.__wbg_ptr);
+    return ret !== 0;
+  }
   /**
    * Execute up to N instructions in a batch.
    * Returns the number of instructions actually executed.
@@ -381,8 +469,98 @@ var WasmVm = class {
     const len0 = WASM_VECTOR_LEN;
     wasm.wasmvm_load_disk(this.__wbg_ptr, ptr0, len0);
   }
+  /**
+   * Get the number of harts configured.
+   * @returns {number}
+   */
+  num_harts() {
+    const ret = wasm.wasmvm_num_harts(this.__wbg_ptr);
+    return ret >>> 0;
+  }
 };
 if (Symbol.dispose) WasmVm.prototype[Symbol.dispose] = WasmVm.prototype.free;
+var WorkerState = class {
+  __destroy_into_raw() {
+    const ptr = this.__wbg_ptr;
+    this.__wbg_ptr = 0;
+    WorkerStateFinalization.unregister(this);
+    return ptr;
+  }
+  free() {
+    const ptr = this.__destroy_into_raw();
+    wasm.__wbg_workerstate_free(ptr, 0);
+  }
+  /**
+   * Execute a batch of instructions and return.
+   *
+   * This is designed to be called repeatedly from JavaScript, allowing
+   * the event loop to yield between batches. This prevents the worker
+   * from blocking indefinitely and allows it to respond to messages.
+   *
+   * Returns a WorkerStepResult indicating whether to continue, halt, etc.
+   * @param {number} batch_size
+   * @returns {WorkerStepResult}
+   */
+  step_batch(batch_size) {
+    const ret = wasm.workerstate_step_batch(this.__wbg_ptr, batch_size);
+    return ret;
+  }
+  /**
+   * Get the total step count.
+   * @returns {bigint}
+   */
+  step_count() {
+    const ret = wasm.workerstate_step_count(this.__wbg_ptr);
+    return BigInt.asUintN(64, ret);
+  }
+  /**
+   * Create a new worker state for a secondary hart.
+   * @param {number} hart_id
+   * @param {any} shared_mem
+   * @param {bigint} entry_pc
+   */
+  constructor(hart_id, shared_mem, entry_pc) {
+    const ret = wasm.workerstate_new(hart_id, shared_mem, entry_pc);
+    this.__wbg_ptr = ret >>> 0;
+    WorkerStateFinalization.register(this, this.__wbg_ptr, this);
+    return this;
+  }
+  /**
+   * Get the hart ID.
+   * @returns {number}
+   */
+  hart_id() {
+    const ret = wasm.workerstate_hart_id(this.__wbg_ptr);
+    return ret >>> 0;
+  }
+};
+if (Symbol.dispose) WorkerState.prototype[Symbol.dispose] = WorkerState.prototype.free;
+var WorkerStepResult = Object.freeze({
+  /**
+   * Continue executing - call step_batch again
+   */
+  Continue: 0,
+  "0": "Continue",
+  /**
+   * Halt requested via control region
+   */
+  Halted: 1,
+  "1": "Halted",
+  /**
+   * Shutdown requested by guest (RequestedTrap)
+   */
+  Shutdown: 2,
+  "2": "Shutdown",
+  /**
+   * Fatal error occurred
+   */
+  Error: 3,
+  "3": "Error"
+});
+function worker_check_interrupts(hart_id, shared_mem) {
+  const ret = wasm.worker_check_interrupts(hart_id, shared_mem);
+  return BigInt.asUintN(64, ret);
+}
 function worker_entry(hart_id, shared_mem, entry_pc) {
   wasm.worker_entry(hart_id, shared_mem, entry_pc);
 }
@@ -441,12 +619,32 @@ function __wbg_get_imports() {
     getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
   };
+  imports.wbg.__wbg___wbindgen_string_get_a2a31e16edf96e42 = function(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof obj === "string" ? obj : void 0;
+    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+  };
   imports.wbg.__wbg___wbindgen_throw_dd24417ed36fc46e = function(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
   };
   imports.wbg.__wbg__wbg_cb_unref_87dfb5aaa0cbcea7 = function(arg0) {
     arg0._wbg_cb_unref();
   };
+  imports.wbg.__wbg_add_e0e7f4f1ce6560fb = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Atomics.add(arg0, arg1 >>> 0, arg2);
+      return ret;
+    }, arguments);
+  };
+  imports.wbg.__wbg_and_fa6c2f8f864f1aed = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Atomics.and(arg0, arg1 >>> 0, arg2);
+      return ret;
+    }, arguments);
+  };
   imports.wbg.__wbg_byteLength_05cd8538d8f5f592 = function(arg0) {
     const ret = arg0.byteLength;
     return ret;
@@ -469,6 +667,16 @@ function __wbg_get_imports() {
       return ret;
     }, arguments);
   };
+  imports.wbg.__wbg_compareExchange_a2a167681b69cf6f = function() {
+    return handleError(function(arg0, arg1, arg2, arg3) {
+      const ret = Atomics.compareExchange(arg0, arg1 >>> 0, arg2, arg3);
+      return ret;
+    }, arguments);
+  };
+  imports.wbg.__wbg_data_8bf4ae669a78a688 = function(arg0) {
+    const ret = arg0.data;
+    return ret;
+  };
   imports.wbg.__wbg_datagrams_05d12f8029dbc662 = function(arg0) {
     const ret = arg0.datagrams;
     return ret;
@@ -487,6 +695,12 @@ function __wbg_get_imports() {
   imports.wbg.__wbg_error_7bc7d576a6aaf855 = function(arg0) {
     console.error(arg0);
   };
+  imports.wbg.__wbg_exchange_898093407427f4fd = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Atomics.exchange(arg0, arg1 >>> 0, arg2);
+      return ret;
+    }, arguments);
+  };
   imports.wbg.__wbg_fill_508dd108a821ee20 = function(arg0, arg1, arg2, arg3) {
     const ret = arg0.fill(arg1, arg2 >>> 0, arg3 >>> 0);
     return ret;
@@ -499,10 +713,6 @@ function __wbg_get_imports() {
     const ret = arg0.getUint16(arg1 >>> 0, arg2 !== 0);
     return ret;
   };
-  imports.wbg.__wbg_getUint32_d3b8478c9340d38b = function(arg0, arg1, arg2) {
-    const ret = arg0.getUint32(arg1 >>> 0, arg2 !== 0);
-    return ret;
-  };
   imports.wbg.__wbg_getUint8_f42915a9262518eb = function(arg0, arg1) {
     const ret = arg0.getUint8(arg1 >>> 0);
     return ret;
@@ -519,6 +729,10 @@ function __wbg_get_imports() {
       return ret;
     }, arguments);
   };
+  imports.wbg.__wbg_get_index_4e7b3f629a0ab9cd = function(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+  };
   imports.wbg.__wbg_hardwareConcurrency_11023a850a093b20 = function(arg0) {
     const ret = arg0.hardwareConcurrency;
     return ret;
@@ -582,6 +796,16 @@ function __wbg_get_imports() {
     const ret = new Function(getStringFromWasm0(arg0, arg1));
     return ret;
   };
+  imports.wbg.__wbg_new_with_byte_offset_and_length_d85c3da1fd8df149 = function(arg0, arg1, arg2) {
+    const ret = new Uint8Array(arg0, arg1 >>> 0, arg2 >>> 0);
+    return ret;
+  };
+  imports.wbg.__wbg_new_with_options_2978557c2c268ef3 = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = new Worker(getStringFromWasm0(arg0, arg1), arg2);
+      return ret;
+    }, arguments);
+  };
   imports.wbg.__wbg_new_with_options_661ae023a99756d4 = function() {
     return handleError(function(arg0, arg1, arg2) {
       const ret = new WebTransport(getStringFromWasm0(arg0, arg1), arg2);
@@ -598,6 +822,17 @@ function __wbg_get_imports() {
       return ret;
     }, arguments);
   };
+  imports.wbg.__wbg_or_eb11de0669782b52 = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Atomics.or(arg0, arg1 >>> 0, arg2);
+      return ret;
+    }, arguments);
+  };
+  imports.wbg.__wbg_postMessage_07504dbe15265d5c = function() {
+    return handleError(function(arg0, arg1) {
+      arg0.postMessage(arg1);
+    }, arguments);
+  };
   imports.wbg.__wbg_prototypesetcall_dfe9b766cdc1f1fd = function(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
   };
@@ -635,21 +870,33 @@ function __wbg_get_imports() {
   imports.wbg.__wbg_setUint16_ff3205ca61800a91 = function(arg0, arg1, arg2, arg3) {
     arg0.setUint16(arg1 >>> 0, arg2, arg3 !== 0);
   };
-  imports.wbg.__wbg_setUint32_3590d6adecfd0c9a = function(arg0, arg1, arg2, arg3) {
-    arg0.setUint32(arg1 >>> 0, arg2 >>> 0, arg3 !== 0);
-  };
   imports.wbg.__wbg_setUint8_71dd48d3e18e4e40 = function(arg0, arg1, arg2) {
     arg0.setUint8(arg1 >>> 0, arg2);
   };
+  imports.wbg.__wbg_set_781438a03c0c3c81 = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Reflect.set(arg0, arg1, arg2);
+      return ret;
+    }, arguments);
+  };
   imports.wbg.__wbg_set_algorithm_f5b9d6dae15e63e3 = function(arg0, arg1, arg2) {
     arg0.algorithm = getStringFromWasm0(arg1, arg2);
   };
   imports.wbg.__wbg_set_bc3a432bdcd60886 = function(arg0, arg1, arg2) {
     arg0.set(arg1, arg2 >>> 0);
   };
+  imports.wbg.__wbg_set_index_04c4b93e64d08a52 = function(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
+  };
+  imports.wbg.__wbg_set_onmessage_deb94985de696ac7 = function(arg0, arg1) {
+    arg0.onmessage = arg1;
+  };
   imports.wbg.__wbg_set_server_certificate_hashes_d12c95e03a45bcd5 = function(arg0, arg1) {
     arg0.serverCertificateHashes = arg1;
   };
+  imports.wbg.__wbg_set_type_c2eb2929316959f4 = function(arg0, arg1) {
+    arg0.type = __wbindgen_enum_WorkerType[arg1];
+  };
   imports.wbg.__wbg_set_value_3371f9dc48a34104 = function(arg0, arg1) {
     arg0.value = arg1;
   };
@@ -682,6 +929,9 @@ function __wbg_get_imports() {
       return ret;
     }, arguments);
   };
+  imports.wbg.__wbg_terminate_08a1236dd2e69da0 = function(arg0) {
+    arg0.terminate();
+  };
   imports.wbg.__wbg_then_429f7caf1026411d = function(arg0, arg1, arg2) {
     const ret = arg0.then(arg1, arg2);
     return ret;
@@ -701,26 +951,36 @@ function __wbg_get_imports() {
     const ret = arg0.write(arg1);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_0268c24e8eb79d38 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h101a38767d457860, wasm_bindgen__convert__closures_____invoke__h5a9b831ab69bf07a);
-    return ret;
+  imports.wbg.__wbg_xor_5e9be92d2e01a692 = function() {
+    return handleError(function(arg0, arg1, arg2) {
+      const ret = Atomics.xor(arg0, arg1 >>> 0, arg2);
+      return ret;
+    }, arguments);
   };
-  imports.wbg.__wbindgen_cast_0de0c044529fd48a = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf225e18fc5ab9bc1, wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765);
+  imports.wbg.__wbindgen_cast_0268c24e8eb79d38 = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h1c929db64e64ab27, wasm_bindgen__convert__closures_____invoke__h67573e759d30b522);
     return ret;
   };
   imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_4ee4ae87c307a33c = function(arg0, arg1) {
-    const ret = makeClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h101a38767d457860, wasm_bindgen__convert__closures_____invoke__hc493fd296d4613a9);
+  imports.wbg.__wbindgen_cast_5b09fbeec74be75e = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf225e18fc5ab9bc1, wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765);
+    return ret;
+  };
+  imports.wbg.__wbindgen_cast_ce28d8b099adee02 = function(arg0, arg1) {
+    const ret = makeClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h1c929db64e64ab27, wasm_bindgen__convert__closures_____invoke__hf580618779cd5844);
     return ret;
   };
   imports.wbg.__wbindgen_cast_d6cd19b81560fd6e = function(arg0) {
     const ret = arg0;
     return ret;
   };
+  imports.wbg.__wbindgen_cast_eb80e707f2cdece7 = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h1c929db64e64ab27, wasm_bindgen__convert__closures_____invoke__hb59a63b35a5a8674);
+    return ret;
+  };
   imports.wbg.__wbindgen_init_externref_table = function() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);
@@ -777,6 +1037,9 @@ var riscv_vm_default = __wbg_init;
 export {
   NetworkStatus,
   WasmVm,
+  WorkerState,
+  WorkerStepResult,
+  worker_check_interrupts,
   worker_entry,
   initSync,
   riscv_vm_default