@viji-dev/core 0.8.3 → 0.8.4

package/dist/index.d.ts

@@ -2654,7 +2654,7 @@ declare type TrackingState = 'TRACKING' | 'LOCKED' | 'BREAKDOWN' | 'LOST';
 /** Returned by `on*` listener registration calls; invoke to unsubscribe. */
 export declare type Unsubscribe = () => void;
 
-export declare const VERSION = "0.8.2";
+export declare const VERSION = "0.8.3";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3067,6 +3067,7 @@ export declare class VijiCore {
     private performanceSnapshotListeners;
     private capabilityTransitionListeners;
     private capabilityReportingEnabled;
+    private renderLoopPaused;
     constructor(config: VijiCoreConfig);
     /**
      * Capture current scene frame
@@ -3811,6 +3812,33 @@ export declare class VijiCore {
      * Gets current performance statistics
      */
     getStats(): PerformanceStats;
+    /**
+     * Pauses the scene render loop — stops the worker from rendering. Intended to
+     * be driven from the host on `document.hidden`, so a hidden tab doesn't keep
+     * rasterizing a heavy scene (which otherwise pegs the GPU and causes a freeze
+     * on return).
+     *
+     * Only the rendering stops. The scene clock keeps running on real wall-clock,
+     * and audio analysis, video/audio streams, CV, parameters and all scene state
+     * keep running too — so audio you can still hear is still analyzed. On
+     * {@link resumeRenderLoop}, `viji.time` reflects the **real** elapsed time
+     * (including the hidden duration) and the first frame's `viji.deltaTime` is the
+     * **real** time-away gap. (That gap can be large; the scene sees true time, not
+     * a frozen clock.) Idempotent.
+     *
+     * For a live compositor *source* feeding a visible mixer, do NOT pause it
+     * while its own tab is hidden — it must keep rendering. Pause is per-core and
+     * host-controlled.
+     */
+    pauseRenderLoop(): void;
+    /**
+     * Resumes the scene render loop after {@link pauseRenderLoop} (e.g. on the tab
+     * becoming visible). The scene resumes on real wall-clock time, so the first
+     * frame's `viji.deltaTime` is the elapsed time-away gap. Idempotent.
+     */
+    resumeRenderLoop(): void;
+    /** Whether the render loop is currently paused (see {@link pauseRenderLoop}). */
+    isRenderLoopPaused(): boolean;
     /**
      * Runs an on-demand fenced benchmark: the worker renders `frameCount` frames,
      * fencing each to capture fence-accurate CPU + GPU time per frame, and

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as a, V as i, a as s, b as e } from "./index-BzW31blh.js";
+import { A as a, V as i, a as s, b as e } from "./index-DF_IFS3A.js";
 export {
   a as AudioSystem,
   i as VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viji-dev/core",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",