@yodaos-pkg/ink 0.11.0 → 0.12.0

package/README.md

@@ -208,6 +208,53 @@ Binds common DOM events to the current `InkView`.
   - Returns a cleanup function
   - Calling it removes every listener created by this binding call
 
+### `view.dispatchVoiceWakeup(keyword, timestamp?)`
+
+Dispatches a host voice wakeup event to the current Ink app/page.
+
+**Parameters**
+
+- `keyword: string`
+  - Required
+  - The wakeup keyword exposed to Ink as `event.keyword`
+- `timestamp?: number`
+  - Optional
+  - Event timestamp in milliseconds
+  - Defaults to `Date.now()`
+
+**What it does**
+
+- Forwards a cancelable `voice.wakeup` event into the Ink runtime
+- Reaches app/page listeners as `voicewakeup` / `onVoiceWakeup`
+- Automatically triggers a render request
+
+**Returns**
+
+- `boolean`
+  - `true` when the event is not canceled
+  - `false` when Ink handles the event and calls `preventDefault()`
+
+### `view.dispatchConnectivityEvent(status)`
+
+Dispatches a host connectivity update to the current Ink app/page.
+
+**Parameters**
+
+- `status: 'online' | 'offline'`
+  - Required
+  - The connectivity state exposed to Ink as a `networkstatus` event
+
+**What it does**
+
+- Forwards a host connectivity update into the Ink runtime
+- Reaches app/page listeners as `networkstatus` / `onNetworkStatus`
+- Automatically triggers a render request
+
+**Returns**
+
+- `InkView`
+  - Returns the current instance so it can be chained
+
 ### `view.dispatchMessageEvent(dataOrJson, origin?, lastEventId?)`
 
 Dispatches a one-shot host message to the current Ink page.

package/index.d.ts

@@ -69,6 +69,9 @@ export interface CreateInkViewOptions {
 /** Cross-platform layout mode exposed by browser hosts. */
 export type InkLayoutMode = 'bounded' | 'width-constrained-auto-height';
 
+/** Connectivity states accepted by {@link InkView.dispatchConnectivityEvent}. */
+export type InkConnectivityStatus = 'online' | 'offline';
+
 /**
  * Optional resize-time overrides applied atomically with the new viewport size.
  *
@@ -736,6 +739,22 @@ export declare class InkView {
   /** Forwards a keyboard/input event directly into the current Ink view. */
   dispatchInput(eventType: string, code: string, timestamp?: number): this;
 
+  /**
+   * Dispatches a host voice wakeup event into the current Ink app/page.
+   *
+   * Returns `true` when the event is not canceled, including when the runtime
+   * skips dispatch because the view is non-interactive. Returns `false` when a
+   * dispatched cancelable event is prevented inside Ink.
+   */
+  dispatchVoiceWakeup(keyword: string, timestamp?: number): boolean;
+
+  /**
+   * Dispatches a host connectivity state change to the current Ink app/page.
+   *
+   * Ink maps this into `networkstatus` / `onNetworkStatus` listeners.
+   */
+  dispatchConnectivityEvent(status: InkConnectivityStatus): this;
+
   /**
    * Dispatches a one-shot host message to the current Ink page.
    *

package/index.js

@@ -326,6 +326,17 @@ function normalizeHostMessageMetadata(origin, lastEventId) {
   return { origin, lastEventId };
 }
 
+function normalizeConnectivityStatus(status) {
+  if (typeof status !== 'string') {
+    throw new TypeError('`status` must be a string.');
+  }
+  const normalized = status.trim().toLowerCase();
+  if (normalized !== 'online' && normalized !== 'offline') {
+    throw new TypeError('`status` must be either `online` or `offline`.');
+  }
+  return normalized;
+}
+
 function normalizeHostMessagePayload(dataOrJson) {
   if (typeof dataOrJson === 'string') {
     try {
@@ -1711,6 +1722,21 @@ export class InkView {
     return this;
   }
 
+  dispatchVoiceWakeup(keyword, timestamp = Date.now()) {
+    if (typeof keyword !== 'string' || !keyword.trim()) {
+      throw new TypeError('`keyword` must be a non-empty string.');
+    }
+    const handled = this.#rawView.dispatchVoiceWakeup(keyword, Number(timestamp));
+    this.requestRender();
+    return handled !== false;
+  }
+
+  dispatchConnectivityEvent(status) {
+    this.#rawView.dispatchConnectivityEvent(normalizeConnectivityStatus(status));
+    this.requestRender();
+    return this;
+  }
+
   dispatchMessageEvent(dataOrJson, origin = 'host', lastEventId = '') {
     const metadata = normalizeHostMessageMetadata(origin, lastEventId);
     this.#rawView.dispatchMessageEvent(

package/package.json

@@ -10,7 +10,7 @@
     "access": "public",
     "registry": "https://registry.npmjs.com/"
   },
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/pkg/ink_web.d.ts

@@ -24,10 +24,12 @@ export class InkWebView {
     currentContentHeight(): number;
     currentContentWidth(): number;
     destroy(): void;
+    dispatchConnectivityEvent(status: string): void;
     dispatchHostCapabilityEvent(event_json: string): void;
     dispatchInput(event_type: string, code: string, timestamp: number): void;
     dispatchMessageEvent(payload_json: string, origin: string, last_event_id: string): void;
     dispatchPointer(event_type: string, x: number, y: number, id: number, button: number, delta_x: number, delta_y: number): void;
+    dispatchVoiceWakeup(keyword: string, timestamp: number): boolean;
     focus(): void;
     isInteractive(): boolean;
     isRunning(): boolean;
@@ -68,10 +70,12 @@ export interface InitOutput {
     readonly inkwebview_currentContentHeight: (a: number) => number;
     readonly inkwebview_currentContentWidth: (a: number) => number;
     readonly inkwebview_destroy: (a: number) => void;
+    readonly inkwebview_dispatchConnectivityEvent: (a: number, b: number, c: number, d: number) => void;
     readonly inkwebview_dispatchHostCapabilityEvent: (a: number, b: number, c: number, d: number) => void;
     readonly inkwebview_dispatchInput: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly inkwebview_dispatchMessageEvent: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly inkwebview_dispatchPointer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly inkwebview_dispatchVoiceWakeup: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly inkwebview_focus: (a: number) => void;
     readonly inkwebview_isInteractive: (a: number) => number;
     readonly inkwebview_isRunning: (a: number) => number;
@@ -86,11 +90,11 @@ export interface InitOutput {
     readonly inkwebview_setLayoutMode: (a: number, b: number, c: number) => void;
     readonly inkwebview_setViewport: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly start: () => void;
-    readonly __wasm_bindgen_func_elem_10696: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_14706: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_10674: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_14707: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_10675: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_10267: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_14723: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_10386: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_14724: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_10385: (a: number, b: 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/pkg/ink_web.js

@@ -164,6 +164,24 @@ export class InkWebView {
     destroy() {
         wasm.inkwebview_destroy(this.__wbg_ptr);
     }
+    /**
+     * @param {string} status
+     */
+    dispatchConnectivityEvent(status) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(status, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.inkwebview_dispatchConnectivityEvent(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);
+        }
+    }
     /**
      * @param {string} event_json
      */
@@ -252,6 +270,28 @@ export class InkWebView {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * @param {string} keyword
+     * @param {number} timestamp
+     * @returns {boolean}
+     */
+    dispatchVoiceWakeup(keyword, timestamp) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(keyword, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.inkwebview_dispatchVoiceWakeup(retptr, this.__wbg_ptr, ptr0, len0, timestamp);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return r0 !== 0;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     focus() {
         wasm.inkwebview_focus(this.__wbg_ptr);
     }
@@ -1233,28 +1273,28 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 2675, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 2678, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10696, __wasm_bindgen_func_elem_10674);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2719, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 2695, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10267, __wasm_bindgen_func_elem_10386);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 2675, function: Function { arguments: [NamedExternref("Event")], shim_idx: 2678, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10696, __wasm_bindgen_func_elem_10674);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2719, function: Function { arguments: [NamedExternref("Event")], shim_idx: 2695, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10267, __wasm_bindgen_func_elem_10386);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 2675, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 2678, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10696, __wasm_bindgen_func_elem_10674);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2719, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 2695, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10267, __wasm_bindgen_func_elem_10386);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 2675, function: Function { arguments: [], shim_idx: 2676, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10696, __wasm_bindgen_func_elem_10675);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 2719, function: Function { arguments: [], shim_idx: 2720, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_10267, __wasm_bindgen_func_elem_10385);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 3626, function: Function { arguments: [Externref], shim_idx: 3627, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_14706, __wasm_bindgen_func_elem_14707);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 3639, function: Function { arguments: [Externref], shim_idx: 3640, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_14723, __wasm_bindgen_func_elem_14724);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000006: function(arg0) {
@@ -1311,16 +1351,16 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_10675(arg0, arg1) {
-    wasm.__wasm_bindgen_func_elem_10675(arg0, arg1);
+function __wasm_bindgen_func_elem_10385(arg0, arg1) {
+    wasm.__wasm_bindgen_func_elem_10385(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_10674(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_10674(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_10386(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_10386(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_14707(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_14707(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_14724(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_14724(arg0, arg1, addHeapObject(arg2));
 }
 
 

package/pkg/ink_web_bg.wasm.d.ts

@@ -18,10 +18,12 @@ export const inkwebview_currentClosedSource: (a: number, b: number) => void;
 export const inkwebview_currentContentHeight: (a: number) => number;
 export const inkwebview_currentContentWidth: (a: number) => number;
 export const inkwebview_destroy: (a: number) => void;
+export const inkwebview_dispatchConnectivityEvent: (a: number, b: number, c: number, d: number) => void;
 export const inkwebview_dispatchHostCapabilityEvent: (a: number, b: number, c: number, d: number) => void;
 export const inkwebview_dispatchInput: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const inkwebview_dispatchMessageEvent: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const inkwebview_dispatchPointer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const inkwebview_dispatchVoiceWakeup: (a: number, b: number, c: number, d: number, e: number) => void;
 export const inkwebview_focus: (a: number) => void;
 export const inkwebview_isInteractive: (a: number) => number;
 export const inkwebview_isRunning: (a: number) => number;
@@ -36,11 +38,11 @@ export const inkwebview_setInteractive: (a: number, b: number) => void;
 export const inkwebview_setLayoutMode: (a: number, b: number, c: number) => void;
 export const inkwebview_setViewport: (a: number, b: number, c: number, d: number, e: number) => void;
 export const start: () => void;
-export const __wasm_bindgen_func_elem_10696: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_14706: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_10674: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_14707: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_10675: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_10267: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_14723: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_10386: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_14724: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_10385: (a: number, b: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;