@chromatic-coherence/generative-engine 1.0.2 → 1.0.3

package/dist/world.d.ts

@@ -251,7 +251,14 @@ export declare class World {
     private drawPts;
     private drawRibbons;
     private renderFrame;
+    private frameFn;
+    private pausedByUser;
     start(): void;
+    /** Freeze the frame loop, keeping every GPU resource warm — the cheap way to park an
+     *  off-screen world. resume() picks the motion back up instantly; nothing rebuilds. */
+    pause(): void;
+    /** Wake a pause()d world — the loop continues from where the clock left off. */
+    resume(): void;
     /** Render one deterministic frame at time t (no loop) — stills, tests, screenshots. */
     settle(t: number): void;
     /** Stop the world. `releaseContext: true` also LOSES the GL context immediately —

package/dist/world.js

@@ -109,6 +109,8 @@ export class World {
         this.zNear = 24;
         this.zFar = 6000;
         this.inkCss = new Map();
+        this.frameFn = null;
+        this.pausedByUser = false;
         this.canvas = o.canvas;
         const gl = o.canvas.getContext("webgl2", { alpha: true, antialias: false, premultipliedAlpha: true });
         if (!gl)
@@ -738,9 +740,10 @@ export class World {
             this.renderFrame(t, dt);
             this.raf = !document.hidden ? requestAnimationFrame(frame) : 0;
         };
+        this.frameFn = frame;
         this.raf = requestAnimationFrame(frame);
         const onVis = () => {
-            if (!document.hidden && !this.raf && !this.disposed) {
+            if (!document.hidden && !this.raf && !this.disposed && !this.pausedByUser) {
                 this.tPrev = performance.now();
                 this.raf = requestAnimationFrame(frame);
             }
@@ -748,6 +751,25 @@ export class World {
         document.addEventListener("visibilitychange", onVis);
         this.cleanup.push(() => document.removeEventListener("visibilitychange", onVis));
     }
+    /** Freeze the frame loop, keeping every GPU resource warm — the cheap way to park an
+     *  off-screen world. resume() picks the motion back up instantly; nothing rebuilds. */
+    pause() {
+        this.pausedByUser = true;
+        if (this.raf) {
+            cancelAnimationFrame(this.raf);
+            this.raf = 0;
+        }
+    }
+    /** Wake a pause()d world — the loop continues from where the clock left off. */
+    resume() {
+        if (this.disposed || !this.pausedByUser)
+            return;
+        this.pausedByUser = false;
+        if (this.frameFn && !this.raf && !document.hidden) {
+            this.tPrev = performance.now();
+            this.raf = requestAnimationFrame(this.frameFn);
+        }
+    }
     /** Render one deterministic frame at time t (no loop) — stills, tests, screenshots. */
     settle(t) { this.renderFrame(t, 0); }
     /** Stop the world. `releaseContext: true` also LOSES the GL context immediately —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chromatic-coherence/generative-engine",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "THE THIRD ENGINE — a zero-dependency WebGL2 graphics engine grown from generative-charts-3d: HDR + bloom + SSAO post chain, hardware-PCF shadow maps, a geometry stdlib, ribbon strokes, group transforms and morph targets. The charts API rides on top unchanged.",
   "type": "module",
   "main": "./dist/index.js",