@rive-app/webgl2-threads 2.49.0 → 2.49.2

package/rive_advanced.mjs.d.ts

@@ -85,6 +85,14 @@ export interface RiveCanvas {
    */
   enableReplayWorker?(): boolean;
 
+  /**
+   * @internal Settles once the replay worker's device caps reach the page, so
+   * scripts read truthful features before any canvas reaches the worker.
+   *
+   * @returns undefined when nothing replays on the worker
+   */
+  awaitReplayCaps?(): Promise<void> | undefined;
+
   /**
    * Loads a Rive file for the runtime and returns a Rive-specific File class
    *
@@ -311,6 +319,11 @@ export declare class RendererWrapper {
    * is as many frames behind as it queues. Skip the frame rather than record it.
    */
   acceptsFrame?(): boolean;
+  /**
+   * @experimental How long the replay worker's recent frames took to finish,
+   * in milliseconds, or 0 before its first.
+   */
+  replayMs?(): number;
   /**
    * @experimental True once the replay worker's context was lost and restored.
    * What it held is gone, so the renderer and the file's session must be

package/runtimeLoader.d.ts

@@ -12,6 +12,8 @@ export declare class RuntimeLoader {
     private static triedThreads;
     private static parallelParts;
     private static replayWorker;
+    private static replayCapsArrived;
+    private static readonly replayCapsTimeoutMs;
     private static errorCallbackQueue;
     private constructor();
     /**
@@ -25,6 +27,12 @@ export declare class RuntimeLoader {
     private static loadUnthreaded;
     static getInstance(callback: RuntimeCallback, onError?: (error: Error) => void): void;
     static awaitInstance(): Promise<rc.RiveCanvas>;
+    /**
+     * @internal Resolves once the replay worker's device caps reach the page,
+     * so scripts init against them. Null when there is nothing left to wait
+     * for, which keeps every later instance's load synchronous.
+     */
+    static awaitReplayCaps(): Promise<void> | null;
     static setWasmUrl(url: string): void;
     static getWasmUrl(): string;
     /**

package/utils/index.d.ts

@@ -5,3 +5,4 @@ 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";
+export { ReplayPacer } from "./replayPacer";

package/utils/replayPacer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Paces recording to a replay worker slower than the display. Recording as
+ * soon as its queue frees sends frames in bursts, so instead they go out every
+ * N refreshes, with N following the worker's recent replay time.
+ */
+export declare class ReplayPacer {
+    private lastTime;
+    private lastRecord;
+    private intervals;
+    private divisor;
+    private settle;
+    private nextProbe;
+    private probing;
+    private probeAfter;
+    private backedUp;
+    private recentBackups;
+    /**
+     * Called on every animation frame. Returns whether this one should record,
+     * given the worker's replay time and whether its queue has room.
+     */
+    shouldRecord(time: number, replayMs: number, accepts: boolean): boolean;
+    private adapt;
+    private setDivisor;
+}