@rive-app/webgl2-threads 2.47.0 → 2.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/webgl2-threads",
-  "version": "2.47.0",
+  "version": "2.48.0",
   "description": "Rive's webgl2 based web api, with threads on cross origin isolated pages.",
   "main": "rive.js",
   "homepage": "https://rive.app",

package/rive.d.ts

@@ -58,6 +58,17 @@ export interface RiveFocusOptions {
      */
     allowFocusInterrupt: boolean;
 }
+export interface RiveGamepadOptions {
+    /**
+     * When true, button and stick input only reaches the graphic while DOM focus is
+     * on the canvas (or its accessibility overlay). While focus is elsewhere,
+     * controllers still report as connected, but their input is held at rest.
+     * Useful when several gamepad-driven graphics share a page.
+     *
+     * @default false
+     */
+    requireFocus?: boolean;
+}
 export interface LayoutParameters {
     fit?: Fit;
     alignment?: Alignment;
@@ -350,6 +361,10 @@ export interface RiveParameters {
      * Optional settings for focus behavior
      */
     focusOptions?: RiveFocusOptions;
+    /**
+     * Optional settings for gamepad input
+     */
+    gamepadOptions?: RiveGamepadOptions;
     /**
      * Allow the runtime to automatically load assets hosted in Rive's CDN.
      * enabled by default.
@@ -374,6 +389,11 @@ export interface RiveParameters {
      * will be attached to the <canvas> element
      */
     shouldDisableRiveListeners?: boolean;
+    /**
+     * Turn off sending gamepad input to Rive. Connected game controllers are not read and the
+     * state machine receives no gamepad events.
+     */
+    shouldDisableGamepad?: boolean;
     /**
      * For Rive Listeners, allows scrolling behavior to still occur on canvas elements
      * when a touch/drag action is performed on touch-enabled devices. Otherwise,
@@ -696,6 +716,7 @@ export declare class Rive {
     private artboard;
     private eventCleanup;
     private _keyboardInteractions;
+    private _gamepadInteractions;
     private file;
     private riveFile;
     private eventManager;
@@ -718,6 +739,8 @@ export declare class Rive {
     static get suppressDeprecationWarnings(): readonly DeprecationId[];
     static set suppressDeprecationWarnings(ids: readonly DeprecationId[]);
     private shouldDisableRiveListeners;
+    private shouldDisableGamepad;
+    private _gamepadOptions;
     private automaticallyHandleEvents;
     private dispatchPointerExit;
     private enableMultiTouch;
@@ -803,6 +826,9 @@ export declare class Rive {
     private wantsTextInputSession;
     private advanceAndDrainForPointer;
     private cleanupKeyboardInteractions;
+    private ensureGamepadInteractions;
+    private cleanupGamepadInteractions;
+    private isFocusWithinCanvas;
     /**
      * Remove Rive Listeners setup on the canvas
      */
@@ -833,6 +859,7 @@ export declare class Rive {
     /** Mirror Rive's hasFocus into the keyboard session state and, on opt-in, canvas focus. */
     private syncRiveFocus;
     private lastRenderTime;
+    private static batchStart;
     private frameRequestId;
     /**
      * Used be draw to track when a second of active rendering time has passed.
@@ -844,11 +871,12 @@ export declare class Rive {
      * due to state changes, view model property changes, etc.
      *
      * @param elapsedTime time to advance the state machine by
+     * @param frameTime the rAF timestamp; omitted by pointer drains, which skip gamepad polling.
      */
     private advanceAndReportChanges;
     /**
      * Draw rendering loop; renders animation frames at the correct time interval.
-     * @param time the time at which to render a frame
+     * @param time the rAF timestamp, or null to draw now without advancing
      */
     private draw;
     /**