virtual-machine 0.4.1 → 0.5.0

package/build/index.d.ts

@@ -73,6 +73,22 @@ declare class WasmVm {
    * Print a status message to UART output (visible in browser).
    */
   print_status(message: string): void;
+  /**
+   * Send a typed character to the D1 input device.
+   *
+   * This is the preferred way to send text input because it respects
+   * keyboard layouts. For example, Shift+7 produces '/' on German keyboards,
+   * and this method sends the actual '/' character.
+   *
+   * Use this for printable characters typed by the user.
+   * Use send_d1_key_event for special keys like Enter, Backspace, arrows.
+   *
+   * # Arguments
+   * * `char_code` - ASCII/Unicode code point (e.g., 47 for '/')
+   *
+   * Returns true if the character was sent successfully.
+   */
+  send_d1_char(char_code: number): boolean;
   /**
    * Get CPU count (from kernel-reported value).
    */
@@ -188,6 +204,19 @@ declare class WasmVm {
    * Returns None if not in SMP mode.
    */
   get_shared_buffer(): SharedArrayBuffer | undefined;
+  /**
+   * Send a keyboard event to the D1 input device.
+   *
+   * This is the primary way to send keyboard input to the VM when using
+   * the D1 touch/input device (as opposed to VirtIO input).
+   *
+   * # Arguments
+   * * `js_key_code` - JavaScript keyCode (e.g., 65 for 'A', 13 for Enter)
+   * * `pressed` - true for key press, false for key release
+   *
+   * Returns true if the event was sent successfully.
+   */
+  send_d1_key_event(js_key_code: number, pressed: boolean): boolean;
   /**
    * Send a mouse button event to the guest.
    *
@@ -337,6 +366,23 @@ declare class WasmVm {
    * This is the address where secondary harts should start executing.
    */
   entry_pc(): bigint;
+  /**
+   * Enable VirtIO 9P device for host directory mounting.
+   *
+   * This exposes a host directory to the guest kernel at the specified
+   * mount point. The JavaScript side must provide a `window.p9Host` object
+   * with the following methods:
+   * - `read(path)` - Returns Uint8Array of file contents
+   * - `write(path, data)` - Writes data to file, returns boolean
+   * - `readdir(path)` - Returns array of `{name, isDir}` objects
+   * - `exists(path)` - Returns boolean
+   * - `isDir(path)` - Returns boolean
+   *
+   * # Arguments
+   * * `host_path` - Path prefix for the host directory
+   * * `mount_tag` - Mount tag for guest to identify the mount
+   */
+  enable_9p(host_path: string, mount_tag: string): void;
   /**
    * Get the halt code if the VM has halted.
    * Code 0x5555 typically means successful shutdown (PASS).
@@ -454,6 +500,7 @@ 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_9p: (a: number, b: number, c: number, d: number, e: 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;
@@ -493,6 +540,8 @@ interface InitOutput {
   readonly wasmvm_num_harts: (a: number) => number;
   readonly wasmvm_print_banner: (a: number) => void;
   readonly wasmvm_print_status: (a: number, b: number, c: number) => void;
+  readonly wasmvm_send_d1_char: (a: number, b: number) => number;
+  readonly wasmvm_send_d1_key_event: (a: number, b: number, c: number) => number;
   readonly wasmvm_send_key_event: (a: number, b: number, c: number) => number;
   readonly wasmvm_send_mouse_button: (a: number, b: number, c: number) => number;
   readonly wasmvm_send_mouse_event: (a: number, b: number, c: number, d: number) => number;
@@ -513,10 +562,10 @@ 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__hf82ace793514c4bf: (a: number, b: number) => void;
-  readonly wasm_bindgen__closure__destroy__h36a9954ef104e71a: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__hc52153a78090318a: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h8c01b902d0cec50b: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__hb64b0e492ba30db3: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h75e3a518a3f3beb0: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h18739833ac56d704: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__hba8efd9a01e74992: (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 __wbindgen_malloc: (a: number, b: number) => number;