@rive-app/canvas-advanced-single 2.37.7 → 2.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/canvas-advanced-single",
-  "version": "2.37.7",
+  "version": "2.38.0",
   "description": "Rive's lightweight low-level canvas based web api all in one js file.",
   "main": "canvas_advanced_single.mjs",
   "homepage": "https://rive.app",

package/rive_advanced.mjs.d.ts

@@ -755,6 +755,18 @@ export interface RiveEventCustomProperties {
   [key: string]: number | boolean | string;
 }
 
+/**
+ * Snapshot of the focus state returned by StateMachineInstance.focusState().
+ * Poll this each frame after advanceAndApply() to detect focus changes and
+ * determine whether a virtual keyboard should be shown or hidden.
+ */
+export interface FocusState {
+  /** True if any element currently holds focus in this state machine's active focus manager. */
+  hasFocus: boolean;
+  /** True if the focused element accepts keyboard input (e.g. a TextInput node). */
+  expectsKeyboardInput: boolean;
+}
+
 export declare class LinearAnimation {
   /**
    * The animation's loop type
@@ -877,6 +889,35 @@ export declare class StateMachineInstance {
    */
   pointerExit(x: number, y: number, id: number): void;
 
+  /**
+   * Returns true if this state machine has any focus nodes registered in its focus tree.
+   * Since the focus tree is unified across nested artboards, this covers the full scene.
+   * Use this to gate whether tab/focus traversal DOM listeners should be attached.
+   */
+  hasFocusNodes(): boolean;
+
+  /**
+   * Move focus to the next focusable node in the focus tree via the state machine's focus manager.
+   */
+  focusNext(): boolean;
+
+  /**
+   * Move focus to the previous focusable node in the focus tree via the state machine's focus manager.
+   */
+  focusPrevious(): boolean;
+
+  /**
+   * Clear focus from the Rive focus tree.
+   */
+  clearFocus(): void;
+
+  /**
+   * Returns metadata about current focus state:
+   *   1. Whether any node in the focus tree is currently focused
+   *   2. Whether the currently focused node expects keyboard input (i.e. keyboard/text input listener)
+   */
+  focusState(): FocusState;
+
   /**
    * Deletes the underlying instance created via the WASM. It's important to clean up this instance
    * when no longer in use