virtual-machine 0.3.6 → 0.3.8

package/build/index.d.ts

@@ -33,6 +33,25 @@ declare class WasmVm {
    * and the local UART buffer (for hart 0 output).
    */
   get_output(): number | undefined;
+  /**
+   * Enable D1 EMAC (Ethernet MAC) device for network hardware access.
+   *
+   * This initializes the D1 EMAC device so the kernel can probe and find
+   * network hardware during boot. Should be called before the kernel starts
+   * executing if network support is desired.
+   *
+   * Note: This only enables the EMAC hardware emulation. To actually connect
+   * to a network, use `connect_webtransport()` or `setup_external_network()`.
+   */
+  enable_emac(): void;
+  /**
+   * Enable D1 Audio Codec device for audio playback.
+   *
+   * The audio device allows the kernel to write audio samples which can
+   * then be played via WebAudio in the browser. Use `get_audio_samples()`
+   * to retrieve buffered samples for playback.
+   */
+  enable_audio(): void;
   /**
    * Enable VirtIO Input device for keyboard input.
    *
@@ -149,6 +168,16 @@ declare class WasmVm {
    * Returns true if the event was sent successfully.
    */
   send_touch_event(x: number, y: number, pressed: boolean): boolean;
+  /**
+   * Get buffered audio samples for playback.
+   *
+   * Returns a Float32Array of interleaved stereo samples (left, right, left, right, ...).
+   * Sample values are in the range [-1.0, 1.0].
+   *
+   * Call this periodically (e.g., from an AudioWorklet) to drain the audio buffer.
+   * Returns None if no audio device is enabled or no samples are available.
+   */
+  get_audio_samples(max_samples: number): Float32Array | undefined;
   /**
    * Get the total disk capacity from attached VirtIO block devices.
    * Returns total bytes across all block devices.
@@ -203,6 +232,12 @@ declare class WasmVm {
    * Returns None if SharedArrayBuffer is not available (single-threaded mode).
    */
   get_framebuffer_view(): Uint8Array | undefined;
+  /**
+   * Get audio sample rate.
+   *
+   * Returns the sample rate configured by the kernel (default: 48000 Hz).
+   */
+  get_audio_sample_rate(): number;
   /**
    * Get the current frame version from kernel memory.
    * Returns a u32 that increments each time the kernel flushes dirty pixels.
@@ -225,6 +260,13 @@ declare class WasmVm {
    * Returns the packet data or null if no packet is pending.
    */
   extract_network_packet(): Uint8Array | undefined;
+  /**
+   * Get current audio buffer fill level.
+   *
+   * Returns the number of sample pairs (stereo frames) currently buffered.
+   * Useful for monitoring buffer health in the JavaScript audio worklet.
+   */
+  get_audio_buffer_level(): number;
   /**
    * Set up an external network backend for packet bridging.
    * This is used by the Node.js CLI to bridge packets between the native
@@ -412,6 +454,8 @@ interface InitOutput {
   readonly wasmvm_allow_workers_to_start: (a: number) => void;
   readonly wasmvm_connect_webtransport: (a: number, b: number, c: number, d: number, e: number) => [number, number];
   readonly wasmvm_disconnect_network: (a: number) => void;
+  readonly wasmvm_enable_audio: (a: number) => void;
+  readonly wasmvm_enable_emac: (a: number) => void;
   readonly wasmvm_enable_gpu: (a: number, b: number, c: number) => void;
   readonly wasmvm_enable_input: (a: number) => void;
   readonly wasmvm_entry_pc: (a: number) => bigint;
@@ -419,6 +463,9 @@ interface InitOutput {
   readonly wasmvm_external_network_tx_pending: (a: number) => number;
   readonly wasmvm_extract_all_network_packets: (a: number) => any;
   readonly wasmvm_extract_network_packet: (a: number) => any;
+  readonly wasmvm_get_audio_buffer_level: (a: number) => number;
+  readonly wasmvm_get_audio_sample_rate: (a: number) => number;
+  readonly wasmvm_get_audio_samples: (a: number, b: number) => any;
   readonly wasmvm_get_cpu_count: (a: number) => number;
   readonly wasmvm_get_disk_capacity: (a: number) => bigint;
   readonly wasmvm_get_disk_usage: (a: number) => any;
@@ -466,12 +513,12 @@ interface InitOutput {
   readonly workerstate_step_batch: (a: number, b: number) => number;
   readonly workerstate_step_count: (a: number) => bigint;
   readonly worker_entry: (a: number, b: any, c: bigint) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h927a3e68f2df660d: (a: number, b: number) => void;
-  readonly wasm_bindgen__closure__destroy__hb58c972534bceec0: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h65568fa7dcc5b42c: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__hc5b8c13000acc255: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h1fe9f7c0c3fcba87: (a: number, b: number) => void;
   readonly wasm_bindgen__convert__closures_____invoke__h260170fb96639bcf: (a: number, b: number, c: any) => void;
   readonly wasm_bindgen__closure__destroy__h612f8e24953b61d5: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h6348bc2e0e4ff171: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h383863cda42dd205: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h68e5328ec502c4d7: (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;