@rive-app/canvas-lite 2.37.7 → 2.37.8

package/rive_advanced.mjs.d.ts

@@ -877,6 +877,23 @@ 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;
+
   /**
    * Deletes the underlying instance created via the WASM. It's important to clean up this instance
    * when no longer in use

package/utils/index.d.ts

@@ -1,4 +1,6 @@
 export { registerTouchInteractions } from "./registerTouchInteractions";
+export { registerKeyboardInteractions } from "./registerKeyboardInteractions";
+export type { KeyboardInteractionsParams } from "./registerKeyboardInteractions";
 export { BLANK_URL, sanitizeUrl } from "./sanitizeUrl";
 export { Finalizable, ImageWrapper, AudioWrapper, FontWrapper, FileAssetWrapper, ImageAssetWrapper, AudioAssetWrapper, FontAssetWrapper, finalizationRegistry, CustomFileAssetLoaderWrapper, AssetLoadCallbackWrapper, FileFinalizer, createFinalization, } from "./finalizationRegistry";
 export { RiveFont } from "./riveFont";

package/utils/registerKeyboardInteractions.d.ts

@@ -0,0 +1,22 @@
+import * as rc from "../rive_advanced.mjs";
+export interface KeyboardInteractionsParams {
+    canvas: HTMLCanvasElement;
+    stateMachine: rc.StateMachineInstance;
+    rive: rc.RiveCanvas;
+    /**
+     * Whether this canvas has focus nodes that should participate in tab traversal.
+     * When true, Tab/Shift+Tab will be intercepted and routed to the Rive focus manager.
+     * focusNext() returning false means no more traversable nodes — tab is released to the page.
+     */
+    hasFocusNodes: boolean;
+}
+/**
+ * Registers focus and tab-traversal event handlers on the canvas to route
+ * Tab/Shift+Tab to the active Rive state machine's focus manager.
+ *
+ * Mirrors registerTouchInteractions for pointer events.
+ *
+ * Returns a cleanup function that removes all registered event listeners,
+ * or null if the setup conditions are not met.
+ */
+export declare const registerKeyboardInteractions: ({ canvas, stateMachine, rive, hasFocusNodes, }: KeyboardInteractionsParams) => (() => void) | null;