@chromatic-coherence/generative-engine 1.0.1 → 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)
@@ -161,17 +163,23 @@ export class World {
             this.shadowSoft = o.shadows.softness ?? 1.6;
             this.shadowBias = o.shadows.bias ?? 0.0035;
         }
-        if (this.shadowsOn) {
-            // a REAL depth texture with hardware comparison — LINEAR gives free 2x2 PCF per tap
+        {
+            // the shadow sampler must ALWAYS have a complete depth-comparable texture bound:
+            // an unbound sampler2DShadow invalidates the face program on some drivers and
+            // every solid silently vanishes. Shadows off => a 1x1 dummy depth texture.
+            // (Shadows on: a REAL depth texture — LINEAR gives free 2x2 hardware PCF per tap.)
+            const size = this.shadowsOn ? this.shadowSize : 1;
             this.shadowTex = gl.createTexture();
             gl.bindTexture(gl.TEXTURE_2D, this.shadowTex);
-            gl.texImage2D(gl.TEXTURE_2D, 0, gl.DEPTH_COMPONENT24, this.shadowSize, this.shadowSize, 0, gl.DEPTH_COMPONENT, gl.UNSIGNED_INT, null);
+            gl.texImage2D(gl.TEXTURE_2D, 0, gl.DEPTH_COMPONENT24, size, size, 0, gl.DEPTH_COMPONENT, gl.UNSIGNED_INT, null);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_COMPARE_MODE, gl.COMPARE_REF_TO_TEXTURE);
             gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_COMPARE_FUNC, gl.LEQUAL);
+        }
+        if (this.shadowsOn) {
             this.shadowFBO = gl.createFramebuffer();
             gl.bindFramebuffer(gl.FRAMEBUFFER, this.shadowFBO);
             gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.TEXTURE_2D, this.shadowTex, 0);
@@ -732,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);
             }
@@ -742,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.1",
+  "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",