@rive-app/webgl-single 2.35.4 → 2.37.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/webgl-single",
-  "version": "2.35.4",
+  "version": "2.37.0",
   "description": "Rive's webgl based web api with bundled wasm.",
   "main": "rive.js",
   "homepage": "https://rive.app",

package/rive.d.ts

@@ -1,5 +1,8 @@
 import * as rc from "./rive_advanced.mjs";
+import { RuntimeLoader, type RuntimeCallback } from "./runtimeLoader";
+import { ImageWrapper, AudioWrapper, FontWrapper, RiveFont as RiveFontClassUtil } from "./utils";
 export type AssetLoadCallback = (asset: rc.FileAsset, bytes: Uint8Array) => Boolean;
+export { RiveFontClassUtil as RiveFont };
 export type { FileAsset, AudioAsset, FontAsset, ImageAsset, } from "./rive_advanced.mjs";
 /**
  * Generic type for a parameterless void callback
@@ -65,20 +68,7 @@ export declare class Layout {
     runtimeFit(rive: rc.RiveCanvas): rc.Fit;
     runtimeAlignment(rive: rc.RiveCanvas): rc.Alignment;
 }
-export type RuntimeCallback = (rive: rc.RiveCanvas) => void;
-export declare class RuntimeLoader {
-    private static runtime;
-    private static isLoading;
-    private static callBackQueue;
-    private static rive;
-    private static wasmURL;
-    private constructor();
-    private static loadRuntime;
-    static getInstance(callback: RuntimeCallback): void;
-    static awaitInstance(): Promise<rc.RiveCanvas>;
-    static setWasmUrl(url: string): void;
-    static getWasmUrl(): string;
-}
+export { RuntimeLoader, type RuntimeCallback };
 export declare enum StateMachineInputType {
     Number = 56,
     Trigger = 58,
@@ -270,6 +260,13 @@ export interface RiveParameters {
      * Enum with drawing options for optimizations
      */
     drawingOptions?: DrawOptimizationOptions;
+    /**
+     * Emit performance.mark / performance.measure entries for load lifecycle
+     * events and the first 3 render frames. Useful for profiling Rive's
+     * contribution to load and render time in browser devtools.
+     * False by default.
+     */
+    enablePerfMarks?: boolean;
     onLoad?: EventCallback;
     onLoadError?: EventCallback;
     onPlay?: EventCallback;
@@ -334,6 +331,11 @@ export interface RiveFileParameters {
     enableRiveAssetCDN?: boolean;
     onLoad?: EventCallback;
     onLoadError?: EventCallback;
+    /**
+     * Emit performance.mark / performance.measure entries for load lifecycle
+     * events. False by default.
+     */
+    enablePerfMarks?: boolean;
 }
 export declare class RiveFile implements rc.FinalizableTarget {
     private static readonly missingErrorMessage;
@@ -344,6 +346,7 @@ export declare class RiveFile implements rc.FinalizableTarget {
     private file;
     private assetLoader;
     private enableRiveAssetCDN;
+    private enablePerfMarks;
     private eventManager;
     private referenceCount;
     private destroyed;
@@ -353,6 +356,8 @@ export declare class RiveFile implements rc.FinalizableTarget {
     private releaseFile;
     private releaseBindableArtboards;
     private initData;
+    private loadRiveFileBytes;
+    private loadRuntime;
     init(): Promise<void>;
     private fireLoadError;
     /**
@@ -436,6 +441,7 @@ export declare class Rive {
     private _viewModelInstance;
     private _dataEnums;
     private drawOptimization;
+    private enablePerfMarks;
     durations: number[];
     frameTimes: number[];
     frameCount: number;
@@ -918,6 +924,10 @@ export declare class ViewModelInstance {
     incrementReferenceCount(): void;
     decrementReferenceCount(): void;
     get properties(): rc.ViewModelProperty[];
+    /**
+     * Get the name of the ViewModel definition this instance was created from.
+     */
+    get viewModelName(): string;
     internalIncrementReferenceCount(): void;
     cleanup(): void;
 }
@@ -1037,18 +1047,18 @@ export declare const Testing: {
  * Be sure to call `.unref()` on the audio once it is no longer needed. This
  * allows the engine to clean it up when it is not used by any more animations.
  */
-export declare const decodeAudio: (bytes: Uint8Array) => Promise<rc.Audio>;
+export declare const decodeAudio: (bytes: Uint8Array) => Promise<AudioWrapper>;
 /**
  * Decodes bytes into an image.
  *
  * Be sure to call `.unref()` on the image once it is no longer needed. This
  * allows the engine to clean it up when it is not used by any more animations.
  */
-export declare const decodeImage: (bytes: Uint8Array) => Promise<rc.Image>;
+export declare const decodeImage: (bytes: Uint8Array) => Promise<ImageWrapper>;
 /**
  * Decodes bytes into a font.
  *
  * Be sure to call `.unref()` on the font once it is no longer needed. This
  * allows the engine to clean it up when it is not used by any more animations.
  */
-export declare const decodeFont: (bytes: Uint8Array) => Promise<rc.Font>;
+export declare const decodeFont: (bytes: Uint8Array) => Promise<FontWrapper>;