virtual-machine 0.0.28 → 0.0.29

package/build/index.d.ts

@@ -1,3 +1,5 @@
+export { WorkerErrorMessage, WorkerHaltedMessage, WorkerInitMessage, WorkerOutboundMessage, WorkerReadyMessage } from './worker.js';
+
 /* tslint:disable */
 /* eslint-disable */
 
@@ -55,7 +57,7 @@ declare class WasmVm {
    */
   constructor(kernel: Uint8Array);
   /**
-   * Execute a single instruction.
+   * Execute one instruction on each CPU (round-robin).
    * Returns true if the VM is still running, false if halted.
    */
   step(): boolean;
@@ -86,6 +88,16 @@ declare class WasmVm {
   load_disk(disk_image: Uint8Array): void;
 }
 
+/**
+ * Worker entry point, called from JavaScript.
+ *
+ * # Arguments
+ * * `hart_id` - This worker's hart ID (1, 2, 3, ...)
+ * * `shared_mem` - SharedArrayBuffer containing DRAM
+ * * `entry_pc` - Kernel entry point address
+ */
+declare function worker_entry(hart_id: number, shared_mem: any, entry_pc: bigint): void;
+
 type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 interface InitOutput {
@@ -106,11 +118,12 @@ interface InitOutput {
   readonly wasmvm_step: (a: number) => number;
   readonly wasmvm_step_n: (a: number, b: number) => number;
   readonly wasmvm_uart_output_pending: (a: number) => number;
-  readonly wasm_bindgen__convert__closures_____invoke__haab0aa5fef68b647: (a: number, b: number) => void;
-  readonly wasm_bindgen__closure__destroy__hcbebb3eac6bc054d: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__hd4872e8b3188af0e: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h6709295d3f31b919: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__closure__destroy__hb099e2ae98169675: (a: number, b: number) => void;
+  readonly worker_entry: (a: number, b: any, c: bigint) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__hd26ce43761bab283: (a: number, b: number) => void;
+  readonly wasm_bindgen__closure__destroy__h04a8b4d76d4f17bc: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h05c4944ac285ac35: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__hf225e18fc5ab9bc1: (a: number, b: number) => void;
   readonly __wbindgen_malloc: (a: number, b: number) => number;
   readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_exn_store: (a: number) => void;
@@ -151,10 +164,52 @@ type __pkg_riscv_vm_SyncInitInput = SyncInitInput;
 type __pkg_riscv_vm_WasmVm = WasmVm;
 declare const __pkg_riscv_vm_WasmVm: typeof WasmVm;
 declare const __pkg_riscv_vm_initSync: typeof initSync;
+declare const __pkg_riscv_vm_worker_entry: typeof worker_entry;
 declare namespace __pkg_riscv_vm {
-  export { type __pkg_riscv_vm_InitInput as InitInput, type __pkg_riscv_vm_InitOutput as InitOutput, __pkg_riscv_vm_NetworkStatus as NetworkStatus, type __pkg_riscv_vm_SyncInitInput as SyncInitInput, __pkg_riscv_vm_WasmVm as WasmVm, __wbg_init as default, __pkg_riscv_vm_initSync as initSync };
+  export { type __pkg_riscv_vm_InitInput as InitInput, type __pkg_riscv_vm_InitOutput as InitOutput, __pkg_riscv_vm_NetworkStatus as NetworkStatus, type __pkg_riscv_vm_SyncInitInput as SyncInitInput, __pkg_riscv_vm_WasmVm as WasmVm, __wbg_init as default, __pkg_riscv_vm_initSync as initSync, __pkg_riscv_vm_worker_entry as worker_entry };
 }
 
 declare function WasmInternal(): Promise<typeof __pkg_riscv_vm>;
 
-export { NetworkStatus, WasmInternal, WasmVm };
+interface VmOptions {
+    /** Number of harts (auto-detected if not specified) */
+    harts?: number;
+    /** Path to worker script (default: '/worker.js') */
+    workerScript?: string;
+}
+/**
+ * Create a VM instance and optionally start workers for multi-hart execution.
+ *
+ * @param kernelData - ELF kernel binary
+ * @param options - VM configuration options
+ * @returns WasmVm instance
+ */
+declare function createVM(kernelData: Uint8Array, options?: VmOptions): Promise<WasmVm>;
+/**
+ * Run the VM with an output callback for UART data.
+ *
+ * @param vm - WasmVm instance
+ * @param onOutput - Callback for each character output
+ * @param options - Run options
+ * @returns Stop function to halt execution
+ */
+declare function runVM(vm: WasmVm, onOutput: (char: string) => void, options?: {
+    stepsPerFrame?: number;
+}): () => void;
+interface SharedMemorySupport {
+    supported: boolean;
+    message: string;
+}
+/**
+ * Check if SharedArrayBuffer is available for multi-threaded execution.
+ *
+ * SharedArrayBuffer requires Cross-Origin Isolation (COOP/COEP headers).
+ * If not available, the VM will run in single-threaded mode.
+ */
+declare function checkSharedMemorySupport(): SharedMemorySupport;
+/**
+ * Check if the page is cross-origin isolated (required for SharedArrayBuffer).
+ */
+declare function isCrossOriginIsolated(): boolean;
+
+export { NetworkStatus, type SharedMemorySupport, type VmOptions, WasmInternal, WasmVm, checkSharedMemorySupport, createVM, isCrossOriginIsolated, runVM };