@rive-app/webgl2-threads 2.47.1 → 2.48.0

package/rive_advanced.mjs.d.ts

@@ -1200,6 +1200,16 @@ export declare class StateMachineInstance {
    */
   textInput(text: string): boolean;
 
+  /**
+   * Submit one frame of gamepad input encoded in the v2 wire format
+   * (see rive-runtime/include/rive/input/gamepad_batch.hpp). Events route to the primary focus
+   * node and bubble up its ancestors; with nothing focused, only scripted drawables receive them.
+   * @param batch - little-endian v2 batch of connected/update/disconnected records
+   * @returns false if the batch was rejected (bad version, malformed record, unknown device,
+   *   or no focus manager)
+   */
+  submitGamepadsFromBuffer(batch: Uint8Array): boolean;
+
   /**
    * The selected text of the focused element, or an empty string when nothing with a
    * selection is focused. Used to fill the clipboard on copy/cut. An obscured field 

package/utils/gamepadBatchEncoder.d.ts

@@ -0,0 +1,51 @@
+/** Must match `rive::kGamepadBatchWireVersion` (runtime/include/rive/input/gamepad_batch.hpp). */
+export declare const GAMEPAD_BATCH_VERSION = 2;
+export declare const GAMEPAD_MAX_BUTTONS = 32;
+export declare const GAMEPAD_MAX_AXES = 16;
+/** C++ `rive::GamepadRecordType`. */
+export declare enum GamepadRecordType {
+    Connected = 0,
+    Update = 1,
+    Disconnected = 2
+}
+/** C++ `rive::GamepadInputChangeKind`. */
+export declare enum GamepadChangeKind {
+    Button = 0,
+    Axis = 1
+}
+/** C++ `rive::GamepadMappingKind`. */
+export declare enum GamepadMappingKind {
+    Standard = 0,
+    Unknown = 1
+}
+/**
+ * Builds buffer to send to the state machine for gamepad input connection/updates/disconnect.
+ *
+ * Each `update` record carries a single change: the core
+ * applies and dispatches records in order, so N single-change records in one batch behave like
+ * N separate submits.
+ *
+ * `end()` returns a view into a reused scratch buffer, valid until the next `begin()`.
+ */
+export declare class GamepadBatchEncoder {
+    private buffer;
+    private view;
+    private bytes;
+    private offset;
+    constructor(initialCapacity?: number);
+    begin(): void;
+    /** True when no records were written since `begin()`. */
+    get isEmpty(): boolean;
+    /** Set up buffer size/initialized values for a connected device */
+    connected(deviceId: number, mapping: GamepadMappingKind, buttonValues: ArrayLike<number>, axes: ArrayLike<number>): void;
+    /**  */
+    update(deviceId: number, kind: GamepadChangeKind, index: number, value: number): void;
+    disconnected(deviceId: number): void;
+    end(): Uint8Array;
+    /** ---------------- Helper/private methods ---------------- */
+    private writeU8;
+    private writeU32;
+    private writeI32;
+    private writeF32;
+    private ensure;
+}

package/utils/gamepadInteractions.d.ts

@@ -0,0 +1,25 @@
+import * as rc from "../rive_advanced.mjs";
+export interface GamepadInteractionsParams {
+    /** Hold button/axis input at rest unless DOM focus is within the canvas/overlay. Pads still connect. */
+    requireFocus: boolean;
+    isFocusWithin: () => boolean;
+}
+/**
+ * Per-Rive-instance gamepad bridge driving a single state machine. Tracks what that state
+ * machine has been sent and submits only the difference, so after a pause it catches up
+ * without duplicate connected events.
+ */
+export declare class GamepadInteractions {
+    private params;
+    private encoder;
+    private stateMachine;
+    private lastSentPads;
+    private submitFailures;
+    constructor(params: GamepadInteractionsParams);
+    /** Poll, diff and submit one batch. Call once per frame before advancing. */
+    handleGamepadInputs(time: number, stateMachine: rc.StateMachineInstance | undefined): void;
+    dispose(): void;
+    /** Writes records that bring `lastSentPads` up to `pads`, updating it as it goes. */
+    private encodeDiff;
+    private encodeChanges;
+}

package/utils/index.d.ts

@@ -1,6 +1,7 @@
 export { registerTouchInteractions } from "./registerTouchInteractions";
 export { KeyboardInteractions, FocusSessionState } from "./registerKeyboardInteractions";
 export type { KeyboardInteractionsParams } from "./registerKeyboardInteractions";
+export { GamepadInteractions } from "./gamepadInteractions";
 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";