@rive-app/canvas-lite 2.31.6 → 2.32.0

package/package.json

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

package/rive.d.ts

@@ -112,9 +112,20 @@ export declare enum RiveEventType {
     General = 128,
     OpenUrl = 131
 }
-declare class Artboard {
+declare class BaseArtboard {
+    isBindableArtboard: boolean;
+    constructor(_isBindableArtboard: boolean);
+}
+declare class Artboard extends BaseArtboard {
     nativeArtboard: rc.Artboard;
-    constructor(artboard: rc.Artboard);
+    file: RiveFile;
+    constructor(artboard: rc.Artboard, _file: RiveFile);
+}
+declare class BindableArtboard extends BaseArtboard implements rc.FinalizableTarget {
+    selfUnref: boolean;
+    nativeArtboard: rc.BindableArtboard;
+    constructor(artboard: rc.BindableArtboard);
+    destroy(): void;
 }
 /**
  * Supported event types triggered in Rive
@@ -241,6 +252,14 @@ export interface RiveParameters {
      * Rive will look for a default view model and view model instance to bind to the artboard
      */
     autoBind?: boolean;
+    /**
+     * For Rive Listeners, dispatch a pointer exit when the pointer exits the canvas.
+     */
+    dispatchPointerExit?: boolean;
+    /**
+     * Enables multi touch support
+     */
+    enableMultiTouch?: boolean;
     onLoad?: EventCallback;
     onLoadError?: EventCallback;
     onPlay?: EventCallback;
@@ -319,8 +338,10 @@ export declare class RiveFile implements rc.FinalizableTarget {
     private referenceCount;
     private destroyed;
     selfUnref: boolean;
+    private bindableArtboards;
     constructor(params: RiveFileParameters);
     private releaseFile;
+    private releaseBindableArtboards;
     private initData;
     init(): Promise<void>;
     private fireLoadError;
@@ -346,7 +367,17 @@ export declare class RiveFile implements rc.FinalizableTarget {
     removeAllRiveEventListeners(type?: EventType): void;
     getInstance(): rc.File;
     destroyIfUnused(): void;
+    private createBindableArtboard;
+    /**
+     * @deprecated This function is deprecated. For better stability and memory management
+     * use `getBindableArtboard()` instead.
+     * @param {string} name - The name of the artboard.
+     * @returns {Artboard} The artboard to bind to.
+     */
     getArtboard(name: string): Artboard | null;
+    getBindableArtboard(name: string): BindableArtboard | null;
+    getDefaultBindableArtboard(): BindableArtboard | null;
+    internalBindableArtboardFromArtboard(artboard: rc.Artboard): BindableArtboard | null;
 }
 export declare class Rive {
     private readonly canvas;
@@ -378,6 +409,8 @@ export declare class Rive {
     private static readonly cleanupErrorMessage;
     private shouldDisableRiveListeners;
     private automaticallyHandleEvents;
+    private dispatchPointerExit;
+    private enableMultiTouch;
     private enableRiveAssetCDN;
     private _volume;
     private _artboardWidth;
@@ -732,7 +765,15 @@ export declare class Rive {
     viewModelByName(name: string): ViewModel | null;
     enums(): DataEnum[];
     defaultViewModel(): ViewModel | null;
+    /**
+     * @deprecated This function is deprecated. For better stability and memory management
+     * use `getBindableArtboard()` instead.
+     * @param {string} name - The name of the artboard.
+     * @returns {Artboard} The artboard to bind to.
+     */
     getArtboard(name: string): Artboard | null;
+    getBindableArtboard(name: string): BindableArtboard | null;
+    getDefaultBindableArtboard(): BindableArtboard | null;
 }
 export declare class ViewModel {
     private _viewModel;
@@ -759,8 +800,10 @@ export declare class ViewModelInstance {
     private _viewModelInstances;
     private _propertiesWithCallbacks;
     private _referenceCount;
+    selfUnref: boolean;
     constructor(runtimeInstance: rc.ViewModelInstance, parent: ViewModelInstance | null);
     get runtimeInstance(): rc.ViewModelInstance | null;
+    get nativeInstance(): rc.ViewModelInstance | null;
     handleCallbacks(): void;
     addParent(parent: ViewModelInstance): void;
     removeParent(parent: ViewModelInstance): void;
@@ -920,7 +963,7 @@ export declare class ViewModelInstanceAssetImage extends ViewModelInstanceValue
 }
 export declare class ViewModelInstanceArtboard extends ViewModelInstanceValue {
     constructor(instance: rc.ViewModelInstanceArtboard, root: ViewModelInstance);
-    set value(artboard: Artboard | null);
+    set value(artboard: BaseArtboard | null);
     internalHandleCallback(callback: Function): void;
 }
 /**