@woosh/meep-engine 3.0.1 → 3.1.0

package/README.md

@@ -35,7 +35,12 @@ While other engines (like Unity) struggle with slow query times and documentatio
 ---
 
 ## ⚡ High-Performance Rendering
-Meep implements a Clustered Forward+ rendering pipeline, allowing for scenes that traditional web engines choke on.
+Meep 3 renders through **Shade**: a GPU-driven, visibility-buffer deferred renderer on **WebGPU**. Geometry is clustered into meshlets ahead of time and lives GPU-resident; culling runs on the GPU; lights are binned into froxels and applied deferred.
+
+**→ [The renderer contract](src/shade/RENDERER_CONTRACT.md)** — what it promises, how to put a model on the screen, and how to add your own work to the frame.
+**Coming from 2.x?** [Migration guide](MIGRATION_2_TO_3.md) · [Changelog](CHANGELOG.md).
+
+* **WebGPU only.** There is no WebGL fallback, no backend abstraction and no degradation tiers. Hardware below the device floor gets a clean failure message rather than a lesser picture.
 
 * **Unlimited Lighting:** Render thousands of point lights (muzzle flashes, explosions, torches) with clustered lighting.
 
@@ -43,7 +48,9 @@ Meep implements a Clustered Forward+ rendering pipeline, allowing for scenes tha
 
 * **Massive Terrain:** Chunk-based, auto-culled terrain system supporting up to 256 layers (vs Unity's 4).
 
-* **"Particular" Particle Engine:** A zero-allocation particle system with full lighting, soft particles, and automatic atlassing. Compiled into just 4 shaders to eliminate state-switching overhead.
+* **"Particular" Particle Engine:** A zero-allocation particle system with full lighting, soft particles, and automatic atlassing, drawn through the renderer's own billboard pipeline.
+
+* **Extensible frames:** Your own work goes into the frame as a *render extension* — a declared phase, declared ordering, and typed per-frame records — rather than as a patch to the pipeline.
 
 * **Path Tracing:** Includes a pure JS path tracer utilizing the engine's internal BVH.