@woosh/meep-engine 3.53.0 → 3.55.0

package/src/shade/RENDERER_CONTRACT.md

@@ -47,12 +47,15 @@ Three consequences that shape everything below:
 The renderer requires a WebGPU device that meets a fixed floor. There is no feature detection
 beyond it and no branch that produces a lesser frame.
 
-**Required features** — the adapter must have both, or startup fails:
+**Required features** — the adapter must have all three, or startup fails:
 
 - `indirect-first-instance` — indirect draw is used throughout
 - `float32-blendable` — the MBOIT transparency mode blends into 32-bit float targets. The default mode,
   AVBOIT, blends `rgba16float` only and does not need it. The feature stays on the floor while MBOIT is
   selectable at all; retiring it from the floor means retiring MBOIT.
+- `texture-formats-tier1` — the hierarchical Z buffer is reduced in compute into `rg16float` storage
+  textures, which core WebGPU cannot write. Without it the HZB texture and every HZB pipeline fail
+  validation, and occlusion culling, SSR, screen-space shadows and light culling all read the HZB.
 
 **Required limits:**
 
@@ -65,7 +68,7 @@ The required features and the two fixed limits are one definition, `device/SHADE
 All of it is checked against the adapter before a device is requested, so a refusal names every
 feature and limit the adapter lacks, with the value it offers, rather than the first one found.
 
-**Taken when offered, never required:** `timestamp-query`, `subgroups`, `texture-formats-tier1`.
+**Taken when offered, never required:** `timestamp-query`, `subgroups`.
 `timestamp-query` drives GPU timers and nothing else, and some browsers withhold it on hardware that
 is otherwise fine — so the timers go quiet when it is absent rather than the renderer refusing to
 start.

package/src/shade/device/SHADE_DEVICE_FLOOR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SHADE_DEVICE_FLOOR.d.ts","sourceRoot":"","sources":["../../../../src/shade/device/SHADE_DEVICE_FLOOR.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH;IACI;;OAEG;cADO,cAAc,mBAAmB,CAAC;IAS5C;;OAEG;YADO,SAAS,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;GAO3C;oCAjCiC,sCAAsC"}
+{"version":3,"file":"SHADE_DEVICE_FLOOR.d.ts","sourceRoot":"","sources":["../../../../src/shade/device/SHADE_DEVICE_FLOOR.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH;IACI;;OAEG;cADO,cAAc,mBAAmB,CAAC;IAW5C;;OAEG;YADO,SAAS,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;GAO3C;oCAnCiC,sCAAsC"}

package/src/shade/device/SHADE_DEVICE_FLOOR.js

@@ -21,6 +21,8 @@ export const SHADE_DEVICE_FLOOR = Object.freeze({
         WebGPUExtensionType.IndirectFirstInstance,
         // the MBOIT transparency mode blends into 32-bit float targets; stays while MBOIT is selectable
         WebGPUExtensionType.Float32Blendable,
+        // the HZB is reduced in compute into rg16float storage textures; core WebGPU has no rg16float storage
+        WebGPUExtensionType.TextureFormatsTier1,
     ]),
 
     /**

package/src/shade/playground/foliage_wind/foliage_world.d.ts

@@ -25,6 +25,7 @@ export function build_meadow_ground_geometry(half_extent?: number, subdivisions?
  * @param {string} [initial_options.preset="oak"]
  * @param {number} [initial_options.seed=1337]
  * @param {number} [initial_options.lod=0]
+ * @param {boolean} [initial_options.showLeaves=true]
  * @param {number} [initial_options.windSpeed=6.5]
  * @param {number} [initial_options.headingDeg=25]
  * @param {number} [initial_options.gustStrength=4.5]
@@ -37,6 +38,7 @@ export function createFoliageWindWorld(graphics: import("../../../engine/graphic
     preset?: string;
     seed?: number;
     lod?: number;
+    showLeaves?: boolean;
     windSpeed?: number;
     headingDeg?: number;
     gustStrength?: number;
@@ -51,6 +53,7 @@ export function createFoliageWindWorld(graphics: import("../../../engine/graphic
         preset: string;
         seed: number;
         lod: number;
+        showLeaves: boolean;
         windSpeed: number;
         headingDeg: number;
         gustStrength: number;
@@ -73,6 +76,7 @@ export function createFoliageWindWorld(graphics: import("../../../engine/graphic
         preset: string;
         seed: number;
         lod: number;
+        showLeaves: boolean;
         windSpeed: number;
         headingDeg: number;
         gustStrength: number;
@@ -84,6 +88,7 @@ export function createFoliageWindWorld(graphics: import("../../../engine/graphic
         preset: string;
         seed: number;
         lod: number;
+        showLeaves: boolean;
         windSpeed: number;
         headingDeg: number;
         gustStrength: number;
@@ -102,6 +107,7 @@ export function createFoliageWindWorld(graphics: import("../../../engine/graphic
         preset: string;
         seed: number;
         lod: number;
+        showLeaves: boolean;
         treeCount: number;
         totalJoints: number;
         totalVertices: number;

package/src/shade/playground/foliage_wind/foliage_world.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foliage_world.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/foliage_wind/foliage_world.js"],"names":[],"mappings":"AAoDA;;;;;;GAMG;AACH,2DAJW,MAAM,iBACN,MAAM,GACJ,OAAO,4CAA4C,EAAE,eAAe,CA4DhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iDAdW,OAAO,6CAA6C,EAAE,cAAc,SACpE,OAAO,+BAA+B,EAAE,KAAK;IAER,IAAI,GAAzC,UAAU,GAAC,OAAO;IACO,MAAM,GAA/B,MAAM;IACmB,IAAI,GAA7B,MAAM;IACmB,GAAG,GAA5B,MAAM;IACmB,SAAS,GAAlC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACmB,YAAY,GAArC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACoB,cAAc,GAAxC,OAAO;;;;;;;;;;;;;;;;cAmJS,MAAM;kBAAY,OAAO,oDAAoD,EAAE,cAAc;mBAAa,OAAO,mDAAmD,EAAE,YAAY;gBAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8J7L,QAAQ,GAAzB,MAAM;QACW,cAAc,GAA/B,MAAM;QACW,MAAM,GAAvB,MAAM;QACW,QAAQ,GAAzB,MAAM;;eAsCN,MAAM;;;;;;;;;;;;;;;;;GAuGpB;AA5iBD;;;GAGG;AACH,yCAFU,MAAM,EAAE,CAYhB;8BA3C4B,sCAAsC;uCAD7B,+CAA+C;oCAmBlD,+DAA+D;qCAC9D,gEAAgE;oCACjE,+DAA+D"}
+{"version":3,"file":"foliage_world.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/foliage_wind/foliage_world.js"],"names":[],"mappings":"AAoDA;;;;;;GAMG;AACH,2DAJW,MAAM,iBACN,MAAM,GACJ,OAAO,4CAA4C,EAAE,eAAe,CA4DhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,iDAfW,OAAO,6CAA6C,EAAE,cAAc,SACpE,OAAO,+BAA+B,EAAE,KAAK;IAER,IAAI,GAAzC,UAAU,GAAC,OAAO;IACO,MAAM,GAA/B,MAAM;IACmB,IAAI,GAA7B,MAAM;IACmB,GAAG,GAA5B,MAAM;IACoB,UAAU,GAApC,OAAO;IACkB,SAAS,GAAlC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACmB,YAAY,GAArC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACmB,UAAU,GAAnC,MAAM;IACoB,cAAc,GAAxC,OAAO;;;;;;;;;;;;;;;;;cAoJS,MAAM;kBAAY,OAAO,oDAAoD,EAAE,cAAc;mBAAa,OAAO,mDAAmD,EAAE,YAAY;gBAAU,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoK7L,QAAQ,GAAzB,MAAM;QACW,cAAc,GAA/B,MAAM;QACW,MAAM,GAAvB,MAAM;QACW,QAAQ,GAAzB,MAAM;;eAsCN,MAAM;;;;;;;;;;;;;;;;;;GAwGpB;AArjBD;;;GAGG;AACH,yCAFU,MAAM,EAAE,CAYhB;8BA3C4B,sCAAsC;uCAD7B,+CAA+C;oCAmBlD,+DAA+D;qCAC9D,gEAAgE;oCACjE,+DAA+D"}