@chromatic-coherence/generative-charts-3d 0.12.0 → 0.12.2

package/README.md

@@ -1,37 +1,51 @@
-# @chromatic-coherence/generative-charts-3d
+<div align="center">
 
-**The second generative-charts engine.** The same API as
-[generative-charts-2d](https://chromaticcoherence.ai/generative-charts) — `createWorld`, `line`,
-`glow`, `face`, `grow`, the `draw*` living verbs, `cam`, `light`, `lights`, `pick` — rendered on
-WebGL. Zero dependencies; the browser is still the whole runtime.
+# generative-charts-3d
 
-> **Status: v0.12.0 — the GPU edition, alpha.** What the GPU gives that canvas could not:
-> a **real depth buffer** — occlusion is exact and always on, for solids *and* for light
-> (a lamp behind a hill is hidden, no flags needed) — and **per-pixel light**: Lambert +
-> point-light falloff evaluated in the fragment shader, so light sweeps smoothly ACROSS a
-> face instead of flat-shading it. Deferred honestly: shadow maps, mirrors, `fade()` groups.
-> Labels ride a synced 2D overlay (never occluded, as in 2d). Browser-only.
+### The **3D · GPU** engine behind [Generative Charts](https://chromaticcoherence.ai/generative-charts) — the same API, on WebGL.
 
-## Usage
+[![npm](https://img.shields.io/npm/v/@chromatic-coherence/generative-charts-3d?color=2ec4b6)](https://www.npmjs.com/package/@chromatic-coherence/generative-charts-3d)
+[![licence: source-available](https://img.shields.io/badge/licence-source--available-1e88e5)](./LICENSE)
+[![zero dependencies](https://img.shields.io/badge/dependencies-0-success)](#)
+
+**[Live demo →](https://chromaticcoherence.ai/generative-charts)** · **[API docs →](https://chromaticcoherence.ai/documents/generative-charts-api)** · **[2D · CPU edition →](https://github.com/chromaticcoherence/generative-charts-2d)**
+
+</div>
+
+---
+
+One JSON payload in, a gorgeous animated chart out — rendered on WebGL with a real depth buffer and per-pixel light. The **same API** as the [2D · CPU edition](https://www.npmjs.com/package/@chromatic-coherence/generative-charts-2d), so one recipe runs on both.
+
+```bash
+npm install @chromatic-coherence/generative-charts-3d
+```
 
 ```ts
 import { createWorld, v3 } from "@chromatic-coherence/generative-charts-3d";
 
 const w = createWorld({ canvas, controls: true });
-w.light.signed = true;
 w.lights.push({ p: v3(0, 150, 0), intensity: 0.9, falloff: 300 });
 w.face(v3(-100, 0, -100), v3(100, 0, -100), v3(0, 0, 100), { hue: 265, sat: 40, light: 32 });
-w.grow((t, dt, world) => world.drawGlow(v3(Math.cos(t) * 80, 30, Math.sin(t) * 80), 40, 12, 0.9));
+w.grow((t) => w.drawGlow(v3(Math.cos(t) * 80, 30, Math.sin(t) * 80), 40, 12, 0.9));
 w.start();
 ```
 
-Scenes written for generative-charts-2d largely run unchanged — same camera, same verbs, same payloads.
+**Why it's different:** real depth — occlusion exact, always on — and per-pixel Lambert + point lights in the fragment shader. No charting library, no third-party graphics. Zero dependencies; the browser is the only runtime.
+
+> **Alpha (v0.12).** The GPU edition is early. For production today, the [2D · CPU edition](https://www.npmjs.com/package/@chromatic-coherence/generative-charts-2d) is feature-complete.
 
 ## Licence
 
 **Source-available, not open source.** Free for individuals, charities and small businesses
 (fewer than 25 people and under £1M annual revenue); a one-off **£100** covers any larger
 organisation. Install and use it as-is, embedded in your app — you may not modify it or
-redistribute it on its own. Full terms: [LICENSE](./LICENSE).
+redistribute it on its own. Full terms in [LICENSE](./LICENSE); commercial licensing:
+[hello@chromaticcoherence.ai](mailto:hello@chromaticcoherence.ai).
+
+> The engine source ships compiled on npm; this repository is the package's home page.
+
+---
 
-© 2026 Chromatic Coherence. All rights reserved.
+<div align="center">
+<sub>© 2026 Chromatic Coherence. All rights reserved.</sub>
+</div>

package/dist/index.js

@@ -766,6 +766,11 @@ export class World {
             c();
         this.cleanup = [];
         this.overlay.remove();
+        // Release the GL context NOW — browsers cap live WebGL contexts per page (~16) and only
+        // reclaim them at GC, so a page that builds and disposes many worlds otherwise exhausts
+        // the pool and every later createWorld fails. A lost context is permanently dead on its
+        // canvas: mount a fresh canvas to build again.
+        this.gl.getExtension("WEBGL_lose_context")?.loseContext();
     }
 }
 export function createWorld(o) { return new World(o); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chromatic-coherence/generative-charts-3d",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "The second generative-charts engine — the same API as generative-charts-2d, rendered on WebGL: a real depth buffer (occlusion exact, always on, for solids and light) and per-pixel Lambert + point lights. Zero dependencies.",
   "type": "module",
   "main": "./dist/index.js",