@rive-app/canvas-lite 2.37.8 → 2.38.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/canvas-lite",
-  "version": "2.37.8",
+  "version": "2.38.1",
   "description": "A lite version of Rive's canvas based web api.",
   "main": "rive.js",
   "homepage": "https://rive.app",

package/rive.d.ts

@@ -40,6 +40,21 @@ export declare enum DrawOptimizationOptions {
     AlwaysDraw = "alwaysDraw",
     DrawOnChanged = "drawOnChanged"
 }
+export interface RiveFocusOptions {
+    /**
+     * When true, allows Rive to interrupt browser focus and programmatically
+     * set/release focus on the canvas when the state machine reports focus
+     * changes in Rive. This allows apps to direct focus to/from the canvas or
+     * related elements as needed if not currently focused, which can happen at
+     * any point in the Rive render loop.
+     *
+     * Note: Nodes in the Rive graphic may still receive/release focus respecting
+     * any focus rules defined in the state machine.
+     *
+     * @default false to prevent unwanted focus interruptions
+     */
+    allowFocusInterrupt: boolean;
+}
 export interface LayoutParameters {
     fit?: Fit;
     alignment?: Alignment;
@@ -219,6 +234,10 @@ export interface RiveParameters {
      * Optional tab index to set for the canvas element if there are any Focus nodes within the graphic
      */
     tabIndex?: number;
+    /**
+     * Optional settings for focus behavior
+     */
+    focusOptions?: RiveFocusOptions;
     /**
      * Allow the runtime to automatically load assets hosted in Rive's CDN.
      * enabled by default.
@@ -420,7 +439,7 @@ export declare class Rive {
     private runtime;
     private artboard;
     private eventCleanup;
-    private keyboardEventCleanup;
+    private _keyboardInteractions;
     private file;
     private riveFile;
     private eventManager;
@@ -449,6 +468,8 @@ export declare class Rive {
     private _viewModelInstance;
     private _dataEnums;
     private _tabIndex;
+    private _prevHasFocus;
+    private _focusOptions;
     private drawOptimization;
     private enablePerfMarks;
     durations: number[];
@@ -468,6 +489,7 @@ export declare class Rive {
      * i.e. { isTouchScrollEnabled: true }
      */
     setupRiveListeners(riveListenerOptions?: SetupRiveListenersOptions): void;
+    private cleanupKeyboardInteractions;
     /**
      * Remove Rive Listeners setup on the canvas
      */
@@ -482,6 +504,11 @@ export declare class Rive {
     private initArtboard;
     drawFrame(): void;
     private _canvasSizeChanged;
+    /**
+     * Poll focus state each frame to see if we should focus/blur the canvas in case
+     * Rive internally updated focus outside of user interaction (e.g., via listener action)
+     */
+    private pollFocusState;
     private lastRenderTime;
     private frameRequestId;
     /**
@@ -489,6 +516,13 @@ export declare class Rive {
      * Used for debugging purposes
      */
     private renderSecondTimer;
+    /**
+     * Handles important sequence of reporting Rive events, advancing the state machine or animation, and invoking various callbacks
+     * due to state changes, view model property changes, etc.
+     *
+     * @param elapsedTime time to advance the state machine by
+     */
+    private advanceAndReportChanges;
     /**
      * Draw rendering loop; renders animation frames at the correct time interval.
      * @param time the time at which to render a frame
@@ -813,6 +847,11 @@ export declare class Rive {
     getArtboard(name: string): Artboard | null;
     getBindableArtboard(name: string): BindableArtboard | null;
     getDefaultBindableArtboard(): BindableArtboard | null;
+    /**
+     * Clear focus applicable to active state machines with focus nodes. Useful if users want to
+     * reset focus state and behavior within the Rive graphic at any point (i.e. blurring off the canvas)
+     */
+    clearFocus(): void;
 }
 export declare enum DataType {
     none = "none",