@woosh/meep-engine 3.25.0 → 3.27.0

package/src/shade/renderer/geometry/virtual/runtime/vgeo_frontier_words.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Words of frontier one view keeps: one bit per page row of the tier it cuts against.
+ *
+ * The frontier is the set of pages a view's cut is standing on, and it is a **bitmask over page
+ * rows** rather than a list of groups because that is the granularity everything else in the cut
+ * already speaks: a page is what `vg_claim_page` claims, what a page visit evaluates whole, and what
+ * both directions of the traversal cross. A reseed hands the descent those pages instead of node 0
+ * of the root, and CUT_PLAN_2026_09_14 §7.5's coarsen path carries it the rest of the way.
+ *
+ * It is small. A 4,096-row tier is 128 words — half a kilobyte a view — against the 120–160 KB §5
+ * sizes a group-level frontier at, and it needs no allocator, no compaction and no entry format.
+ * What it gives up is per-instance keying (§1.1): two instances of one geometry at different
+ * distances share one page set, which is a superset of each one's own and therefore correct, but
+ * costs the closer instance a few page visits it did not need.
+ *
+ * @param {number} page_row_capacity
+ * @returns {number} words
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_frontier_words(page_row_capacity: number): number;
+//# sourceMappingURL=vgeo_frontier_words.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/vgeo_frontier_words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vgeo_frontier_words.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_frontier_words.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uDANW,MAAM,GACJ,MAAM,CASlB"}

package/src/shade/renderer/geometry/virtual/runtime/vgeo_frontier_words.js

@@ -0,0 +1,28 @@
+import { assert } from "../../../../../core/assert.js";
+
+/**
+ * Words of frontier one view keeps: one bit per page row of the tier it cuts against.
+ *
+ * The frontier is the set of pages a view's cut is standing on, and it is a **bitmask over page
+ * rows** rather than a list of groups because that is the granularity everything else in the cut
+ * already speaks: a page is what `vg_claim_page` claims, what a page visit evaluates whole, and what
+ * both directions of the traversal cross. A reseed hands the descent those pages instead of node 0
+ * of the root, and CUT_PLAN_2026_09_14 §7.5's coarsen path carries it the rest of the way.
+ *
+ * It is small. A 4,096-row tier is 128 words — half a kilobyte a view — against the 120–160 KB §5
+ * sizes a group-level frontier at, and it needs no allocator, no compaction and no entry format.
+ * What it gives up is per-instance keying (§1.1): two instances of one geometry at different
+ * distances share one page set, which is a superset of each one's own and therefore correct, but
+ * costs the closer instance a few page visits it did not need.
+ *
+ * @param {number} page_row_capacity
+ * @returns {number} words
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_frontier_words(page_row_capacity) {
+    assert.isNonNegativeInteger(page_row_capacity, 'page_row_capacity');
+
+    return Math.ceil(page_row_capacity / 32);
+}

package/src/shade/renderer/geometry/virtual/runtime/vgeo_page.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vgeo_page.worker.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/vgeo_page.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vgeo_page.worker.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_page.worker.js"],"names":[],"mappings":""}

package/src/shade/renderer/geometry/virtual/runtime/vgeo_page.worker.js

@@ -0,0 +1,13 @@
+import { vgeo_page_worker_serve } from "../format/read/vgeo_page_worker_serve.js";
+
+/**
+ * The page-fetch worker: reads, verifies and decodes pages off the main thread.
+ *
+ * Nothing here but the serve call; the protocol lives with the core in `format/read/` so a spec can
+ * run it over a loopback, and this file exists so that {@link make_vgeo_page_worker} has a module
+ * to point a `Worker` at.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+vgeo_page_worker_serve(self);

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_page_block_words.d.ts

@@ -1,18 +1,23 @@
 /**
  * How many arena words one page's block runs to.
  *
- * A page is **one allocation** — `[node rows][group rows][cluster rows]`, back to back — so this is
- * the whole of what installing it costs the arena and the whole of what evicting it returns. Every
- * base inside the block is a count away from the block's own start, which is why a page row carries
- * three counts and one offset and nothing can move inside a resident page.
+ * A page is **one allocation** — `[node rows][group rows][cluster rows][parent rows]`, back to
+ * back — so this is the whole of what installing it costs the arena and the whole of what evicting
+ * it returns. Every base inside the block is a count away from the block's own start, which is why
+ * a page row carries the counts and nothing can move inside a resident page.
+ *
+ * The parent rows are last because they are the section a page may not have: a container written
+ * before `format_version` 4 carries no upward edge, `parent_entry_count` is zero, and the block is
+ * exactly what it was.
  *
  * @param {number} node_count
  * @param {number} group_count
  * @param {number} cluster_count
+ * @param {number} [parent_entry_count]
  * @returns {number} words
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
  */
-export function vgeo_runtime_page_block_words(node_count: number, group_count: number, cluster_count: number): number;
+export function vgeo_runtime_page_block_words(node_count: number, group_count: number, cluster_count: number, parent_entry_count?: number): number;
 //# sourceMappingURL=vgeo_runtime_page_block_words.d.ts.map

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_page_block_words.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_runtime_page_block_words.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_page_block_words.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,0DARW,MAAM,eACN,MAAM,iBACN,MAAM,GACJ,MAAM,CASlB"}
+{"version":3,"file":"vgeo_runtime_page_block_words.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_page_block_words.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,0DATW,MAAM,eACN,MAAM,iBACN,MAAM,uBACN,MAAM,GACJ,MAAM,CAYlB"}

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_page_block_words.js

@@ -1,25 +1,34 @@
 import { VGEO_CLUSTER_ROW_WORDS } from "./layout/VGEO_CLUSTER_ROW_WORDS.js";
 import { VGEO_GROUP_ROW_WORDS } from "./layout/VGEO_GROUP_ROW_WORDS.js";
 import { VGEO_NODE_ROW_WORDS } from "./layout/VGEO_NODE_ROW_WORDS.js";
+import { VGEO_PARENT_ROW_WORDS } from "./layout/VGEO_PARENT_ROW_WORDS.js";
 
 /**
  * How many arena words one page's block runs to.
  *
- * A page is **one allocation** — `[node rows][group rows][cluster rows]`, back to back — so this is
- * the whole of what installing it costs the arena and the whole of what evicting it returns. Every
- * base inside the block is a count away from the block's own start, which is why a page row carries
- * three counts and one offset and nothing can move inside a resident page.
+ * A page is **one allocation** — `[node rows][group rows][cluster rows][parent rows]`, back to
+ * back — so this is the whole of what installing it costs the arena and the whole of what evicting
+ * it returns. Every base inside the block is a count away from the block's own start, which is why
+ * a page row carries the counts and nothing can move inside a resident page.
+ *
+ * The parent rows are last because they are the section a page may not have: a container written
+ * before `format_version` 4 carries no upward edge, `parent_entry_count` is zero, and the block is
+ * exactly what it was.
  *
  * @param {number} node_count
  * @param {number} group_count
  * @param {number} cluster_count
+ * @param {number} [parent_entry_count]
  * @returns {number} words
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
  */
-export function vgeo_runtime_page_block_words(node_count, group_count, cluster_count) {
+export function vgeo_runtime_page_block_words(
+    node_count, group_count, cluster_count, parent_entry_count = 0
+) {
     return node_count * VGEO_NODE_ROW_WORDS
         + group_count * VGEO_GROUP_ROW_WORDS
-        + cluster_count * VGEO_CLUSTER_ROW_WORDS;
+        + cluster_count * VGEO_CLUSTER_ROW_WORDS
+        + parent_entry_count * VGEO_PARENT_ROW_WORDS;
 }

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_write_page_block.d.ts

@@ -1,5 +1,5 @@
 /**
- * Lay one decoded page's node, group and cluster rows into the arena.
+ * Lay one decoded page's node, group, cluster and parent rows into the arena.
  *
  * This is the whole of what a page install writes besides its payload, and it is deliberately a
  * free function over two views rather than a method: the pool calls it against a mapped GPU upload
@@ -14,6 +14,11 @@
  * resolves to a page that is trivially resident — itself — and falls straight through to the
  * selectability question, which is the only one it was ever really asking.
  *
+ * The parent rows (format §6.3) get the same treatment for the same reason, off the page's own
+ * parent-page table rather than its child table. A page from a container written before
+ * `format_version` 4 has no such table, so the section is empty and the page row's
+ * `PARENT_ENTRY_COUNT` says zero — which is what a kernel checks, rather than asking a version.
+ *
  * Group selectability is **not** written here. It changes after install, as the reader's activation
  * cascades run, and it is the one field of a resident page that moves.
  *

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_write_page_block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_runtime_write_page_block.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_write_page_block.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qDAXW,WAAW,UACX,YAAY,QAEZ,MAAM,mBAEJ,MAAM,CAoGlB"}
+{"version":3,"file":"vgeo_runtime_write_page_block.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_write_page_block.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qDAXW,WAAW,UACX,YAAY,QAEZ,MAAM,mBAEJ,MAAM,CAkIlB"}

package/src/shade/renderer/geometry/virtual/runtime/vgeo_runtime_write_page_block.js

@@ -10,9 +10,11 @@ import { VGEO_NODE_ROW_LEAF_BIT } from "./layout/VGEO_NODE_ROW_LEAF_BIT.js";
 import { VGEO_NODE_ROW_OFFSET } from "./layout/VGEO_NODE_ROW_OFFSET.js";
 import { VGEO_NODE_ROW_WORDS } from "./layout/VGEO_NODE_ROW_WORDS.js";
 import { VGEO_NO_CHILD_PAGE } from "./layout/VGEO_NO_CHILD_PAGE.js";
+import { VGEO_PARENT_ROW_OFFSET } from "./layout/VGEO_PARENT_ROW_OFFSET.js";
+import { VGEO_PARENT_ROW_WORDS } from "./layout/VGEO_PARENT_ROW_WORDS.js";
 
 /**
- * Lay one decoded page's node, group and cluster rows into the arena.
+ * Lay one decoded page's node, group, cluster and parent rows into the arena.
  *
  * This is the whole of what a page install writes besides its payload, and it is deliberately a
  * free function over two views rather than a method: the pool calls it against a mapped GPU upload
@@ -27,6 +29,11 @@ import { VGEO_NO_CHILD_PAGE } from "./layout/VGEO_NO_CHILD_PAGE.js";
  * resolves to a page that is trivially resident — itself — and falls straight through to the
  * selectability question, which is the only one it was ever really asking.
  *
+ * The parent rows (format §6.3) get the same treatment for the same reason, off the page's own
+ * parent-page table rather than its child table. A page from a container written before
+ * `format_version` 4 has no such table, so the section is empty and the page row's
+ * `PARENT_ENTRY_COUNT` says zero — which is what a kernel checks, rather than asking a version.
+ *
  * Group selectability is **not** written here. It changes after install, as the reader's activation
  * cascades run, and it is the one field of a resident page that moves.
  *
@@ -51,6 +58,7 @@ export function vgeo_runtime_write_page_block(words, floats, base, page) {
 
     const group_base = base + node_count * VGEO_NODE_ROW_WORDS;
     const cluster_base = group_base + group_count * VGEO_GROUP_ROW_WORDS;
+    const parent_base = cluster_base + cluster_count * VGEO_CLUSTER_ROW_WORDS;
 
     let broken_child_refs = 0;
 
@@ -84,6 +92,7 @@ export function vgeo_runtime_write_page_block(words, floats, base, page) {
          tier's answer costs.
          */
         words[row + VGEO_GROUP_ROW_OFFSET.PARENT_COUNT] = page.group_parent_count[group];
+        words[row + VGEO_GROUP_ROW_OFFSET.PARENT_FIRST] = page.group_parent_first[group] ?? 0;
 
         // not selectable until activation says so; a page installs drawing nothing. Any other
         // default draws a group before the ancestors it hangs off have arrived.
@@ -134,5 +143,33 @@ export function vgeo_runtime_write_page_block(words, floats, base, page) {
         words[row + VGEO_CLUSTER_ROW_OFFSET.CHILD_REF] = child_ref;
     }
 
+    for (let entry = 0; entry < page.parent_ref.length; entry++) {
+        const row = parent_base + entry * VGEO_PARENT_ROW_WORDS;
+
+        const parent_ref = page.parent_ref[entry];
+
+        /*
+         A parent_ref outside the page's parent-page table is the upward twin of a broken child_ref
+         and is counted with it: format §11.16 forbids it, validation is off by default, and the
+         cluster it would have named does not exist. Pointing it at this page would be worse than
+         admitting there is nothing there — VGEO_NO_CHILD_PAGE never resolves, so a walk up stops
+         and the fallback re-descends, which is correct rather than merely safe.
+        */
+        let parent_page_index;
+
+        if (parent_ref === VGEO_SAME_PAGE) {
+            parent_page_index = page.index;
+        } else if (parent_ref < page.parent_page_index.length) {
+            parent_page_index = page.parent_page_index[parent_ref];
+        } else {
+            parent_page_index = VGEO_NO_CHILD_PAGE;
+
+            broken_child_refs++;
+        }
+
+        words[row + VGEO_PARENT_ROW_OFFSET.PAGE_INDEX] = parent_page_index;
+        words[row + VGEO_PARENT_ROW_OFFSET.CLUSTER] = page.parent_cluster[entry];
+    }
+
     return broken_child_refs;
 }

package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_sharc_evict.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.js"],"names":[],"mappings":"AAkGA,+CAIG;8BAlG2B,kCAAkC"}
+{"version":3,"file":"shader_sharc_evict.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.js"],"names":[],"mappings":"AAmGA,+CAIG;8BAnG2B,kCAAkC"}

package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.js

@@ -26,10 +26,11 @@ const PUSH_CONSTANTS = WebGPUStruct.from({
     capacity: u32,
 });
 
-// per-dispatch, eight bytes, read-only: immediate data rather than a uniform buffer
-resources.setImmediate("settings", PUSH_CONSTANTS);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads garbage. The graph pass turns the plain
+//      value into a transient uniform, so no call site changes.
 resources.createGroup()
+    .addUniform("settings", PUSH_CONSTANTS)
     .addStorageBuffer('hashMapData', HASH_MAP_DATA_STRUCT, true)
     .addStorageBuffer("voxelData", WebGPUArray.from(vec4u))
     .addStorageBuffer('evictionRequests', EVICTION_STRUCT);

package/src/shade/renderer/loader/gltf/tiny-gltf.d.ts

@@ -13,7 +13,7 @@ export class TinyGltf {
      * @readonly
      * @type {TextureFormat}
      */
-    static readonly "__#240@#UNCOMPRESSED_TARGET": TextureFormat;
+    static readonly "__#247@#UNCOMPRESSED_TARGET": TextureFormat;
     /**
      * @param {AssetManager} assetManager
      * @param {AssetRequestScope} [scope]

package/src/shade/renderer/particles/shaders/shader_particle_emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_particle_emit.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_emit.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,kDAA8E;AAE9E;;;;;;;;GAQG;AACH,4BAFU,YAAY,CAOK;AAoD3B,iDAIG;6BAxG0B,mCAAmC;8BAGlC,+BAA+B"}
+{"version":3,"file":"shader_particle_emit.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_emit.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,kDAA8E;AAE9E;;;;;;;;GAQG;AACH,4BAFU,YAAY,CAOK;AAuD3B,iDAIG;6BA3G0B,mCAAmC;8BAGlC,+BAA+B"}

package/src/shade/renderer/particles/shaders/shader_particle_emit.js

@@ -52,8 +52,9 @@ export const EMIT_SETTINGS = WebGPUStruct.from({
 
 const resources = new ShaderResourceSetDescriptor();
 
-resources.setImmediate('settings', EMIT_SETTINGS);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads garbage. The graph pass turns the plain
+//      value into a transient uniform, so no call site changes.
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.u32, false)
     .addStorageBuffer("emitter_database", WebGPUArray.u32, false)
@@ -62,7 +63,9 @@ resources.createGroup()
     .addStorageBuffer("pool", WebGPUArray.u32, true)
     .addStorageBuffer("alive_out", WebGPUArray.u32, true)
     .addStorageBuffer("dead", WebGPUArray.u32, true)
-    .addStorageBuffer("counters", WebGPUArray.from(atomic_u32), true);
+    .addStorageBuffer("counters", WebGPUArray.from(atomic_u32), true)
+    // last in the group, so the storage bindings keep the indices the specs read by
+    .addUniform('settings', EMIT_SETTINGS);
 
 const body = CodeChunk.from(
     /* language=wgsl */

package/src/shade/renderer/particles/shaders/shader_particle_simulate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_particle_simulate.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_simulate.js"],"names":[],"mappings":";AAuDA;;;;;GAKG;AACH,gCAFU,YAAY,CAMS;AAsD/B,qDAIG;iDApH8C,yBAAyB;6BAJ7C,mCAAmC;8BAClC,+BAA+B"}
+{"version":3,"file":"shader_particle_simulate.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/shaders/shader_particle_simulate.js"],"names":[],"mappings":";AAuDA;;;;;GAKG;AACH,gCAFU,YAAY,CAMS;AAyD/B,qDAIG;iDAvH8C,yBAAyB;6BAJ7C,mCAAmC;8BAClC,+BAA+B"}

package/src/shade/renderer/particles/shaders/shader_particle_simulate.js

@@ -67,8 +67,9 @@ export const SIMULATE_SETTINGS = WebGPUStruct.from({
 
 const resources = new ShaderResourceSetDescriptor();
 
-resources.setImmediate('settings', SIMULATE_SETTINGS);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads garbage. The graph pass turns the plain
+//      value into a transient uniform, so no call site changes.
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.u32, false)
     .addStorageBuffer("emitter_database", WebGPUArray.u32, false)
@@ -77,7 +78,9 @@ resources.createGroup()
     .addStorageBuffer("sim_list", WebGPUArray.u32, false)
     .addStorageBuffer("alive_out", WebGPUArray.u32, true)
     .addStorageBuffer("dead", WebGPUArray.u32, true)
-    .addStorageBuffer("counters", WebGPUArray.from(atomic_u32), true);
+    .addStorageBuffer("counters", WebGPUArray.from(atomic_u32), true)
+    // last in the group, so the storage bindings keep the indices the specs read by
+    .addUniform('settings', SIMULATE_SETTINGS);
 
 
 const body = CodeChunk.from(/* language=wgsl */ `

package/src/shade/renderer/postprocess/nss/NSS.d.ts

@@ -53,7 +53,7 @@ export class NSS {
      * @returns {number}
      */
     static recommended_jitter_sequence_size(upscale_ratio: number): number;
-    static "__#173@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
+    static "__#180@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
     /**
      * @param {GraphicsContext} graphics
      */

package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare_meshlet_draw_commands_by_material.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.js"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;GAeG;AACH,uKAJa;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,wBAAwB,EAAE,MAAM,CAAA;CAAC,CAgUnH"}
+{"version":3,"file":"prepare_meshlet_draw_commands_by_material.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.js"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;GAeG;AACH,uKAJa;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,wBAAwB,EAAE,MAAM,CAAA;CAAC,CAwUnH"}

package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.js

@@ -2,7 +2,7 @@ import { assert } from "../../../../core/assert.js";
 import { ceilPowerOfTwo } from "../../../../core/binary/operations/ceilPowerOfTwo.js";
 import { round_up } from "../../../../core/math/round_up.js";
 import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { u32, vec2u } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { STRUCT_UNINDEXED_DRAW_COMMAND } from "../../gpu_primitive/indirect/STRUCT_UNINDEXED_DRAW_COMMAND.js";
 import { cpu_build_hash_table } from "../../gpu_primitive/hash_table/cpu_build_hash_table.js";
 import { graph_prefix_scan_csdldf } from "../../gpu_primitive/prefix_sum/v1/graph_prefix_scan_csdldf.js";
@@ -22,7 +22,7 @@ import { shader_count_meshlets_by_material } from "./shader_count_meshlets_by_ma
 import {
     shader_make_meshlet_indirect_draw_commands_by_material
 } from "./shader_make_meshlet_indirect_draw_commands_by_material.js";
-import { shader_read_out_bucket } from "./shader_read_out_bucket.js";
+import { PUSH_CONSTANTS, shader_read_out_bucket } from "./shader_read_out_bucket.js";
 import { shader_sort_meshlets_by_material } from "./shader_sort_meshlets_by_material.js";
 
 /**
@@ -83,11 +83,16 @@ export function graph_prepare_meshlet_draw_commands_by_material({
             0
         );
 
+        // TODO(chrome-153): transient uniform, not an immediate value — see the shader.
+        const u_settings = encoder.allocateTransientValueBuffer(PUSH_CONSTANTS, {
+            bucket_id,
+        });
+
         shader_read_out_bucket.dispatchIndirect({
             encoder,
             command,
             bindings: {
-                settings: { bucket_id },
+                settings: u_settings,
                 input: buckets_buffer,
                 output,
             }
@@ -160,12 +165,15 @@ export function graph_prepare_meshlet_draw_commands_by_material({
             const hzb = resources.get(data.texture_hzb);
             const command = resources.get(data.command);
 
+            // TODO(chrome-153): transient uniform, not an immediate value — see the shader.
+            const u_resolution = encoder.allocateTransientValueBuffer(vec2u, resolution);
+
             shader_hzb_meshlet_filter_1way_full.dispatchIndirect({
                 encoder,
                 command,
                 bindings: {
                     camera: camera_state,
-                    resolution,
+                    resolution: u_resolution,
                     scene_database: scene.scene_database_buffer,
                     meshlet_metadata: scene.geometries.meshlets.buffer_metadata,
                     texture_hzb: hzb.obtainView(),

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.d.ts

@@ -1,3 +1,5 @@
+export const PUSH_CONSTANTS: WebGPUStruct;
 export const shader_read_out_bucket: ComputeShader;
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 //# sourceMappingURL=shader_read_out_bucket.d.ts.map

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_read_out_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js"],"names":[],"mappings":"AAqDA,mDAIE;8BApD4B,+BAA+B"}
+{"version":3,"file":"shader_read_out_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js"],"names":[],"mappings":"AAcA,0CAEG;AAsCH,mDAIE;6BAzD2B,mCAAmC;8BAIlC,+BAA+B"}

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js

@@ -1,58 +1,59 @@
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import {
-    RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ
-} from "../expand/bucket/RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ.js";
-
-
-const resources = new ShaderResourceSetDescriptor();
-
-const PUSH_CONSTANTS = WebGPUStruct.from({
-    bucket_id: u32,
-});
-
-// per-dispatch, four bytes, read-only: immediate data rather than a pooled buffer, a staging copy
-// and a bind group of its own
-resources.setImmediate("settings", PUSH_CONSTANTS);
-
-resources.createGroup()
-    .addStorageBuffer("input", RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ)
-    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
-fn main(@builtin(global_invocation_id) global_id : vec3<u32>){
-
-    let input_index = global_id.x;
-    
-    let bucket_header = input.headers[settings.bucket_id];
-    let bucket_size = bucket_header.count;
-    
-    if(input_index == 0){
-        output.count = bucket_size;
-    }
-    
-    if(input_index >= bucket_size){
-        return;
-    }
-    
-    // just copy
-    let mesh_index = input.elements[input_index + bucket_header.offset];
-    
-    output.elements[input_index] = mesh_index;
-}
-    `
-);
-
-export const shader_read_out_bucket = ComputeShader.from({
-    label: 'Read out bucket',
-    resources,
-    body,
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import {
+    RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ
+} from "../expand/bucket/RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ.js";
+
+
+const resources = new ShaderResourceSetDescriptor();
+
+export const PUSH_CONSTANTS = WebGPUStruct.from({
+    bucket_id: u32,
+});
+
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads 65535 and culls everything. Revert 7c9700b87.
+resources.createGroup()
+    .addUniform("settings", PUSH_CONSTANTS);
+
+resources.createGroup()
+    .addStorageBuffer("input", RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ)
+    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
+fn main(@builtin(global_invocation_id) global_id : vec3<u32>){
+
+    let input_index = global_id.x;
+    
+    let bucket_header = input.headers[settings.bucket_id];
+    let bucket_size = bucket_header.count;
+    
+    if(input_index == 0){
+        output.count = bucket_size;
+    }
+    
+    if(input_index >= bucket_size){
+        return;
+    }
+    
+    // just copy
+    let mesh_index = input.elements[input_index + bucket_header.offset];
+    
+    output.elements[input_index] = mesh_index;
+}
+    `
+);
+
+export const shader_read_out_bucket = ComputeShader.from({
+    label: 'Read out bucket',
+    resources,
+    body,
 })

package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_hzb_mesh_filter_2way.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.js"],"names":[],"mappings":"AA8GA,wDAIG;8BAjG2B,kCAAkC"}
+{"version":3,"file":"shader_hzb_mesh_filter_2way.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.js"],"names":[],"mappings":"AA4GA,wDAIG;8BA/F2B,kCAAkC"}

package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.js

@@ -21,12 +21,10 @@ import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderReso
 
 const resources = new ShaderResourceSetDescriptor();
 
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the same
-// shape shader_read_out_bucket already uses. camera_previous stays a uniform: it is a scene buffer,
-// not a per-dispatch value.
-resources.setImmediate("bucket_index", U32_CONTAINER_STRUCT);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads 65535 and culls everything. Revert 22893f0a7.
 resources.createGroup()
+    .addUniform("bucket_index", U32_CONTAINER_STRUCT)
     .addStorageBuffer("bucket_data", RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ)
 
 resources.createGroup()

package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_hzb_meshlet_filter_1way_full.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.js"],"names":[],"mappings":"AA8GA;;;GAGG;AACH,kDAFU,aAAa,CAMpB;8BApG2B,kCAAkC"}
+{"version":3,"file":"shader_hzb_meshlet_filter_1way_full.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.js"],"names":[],"mappings":"AA6GA;;;GAGG;AACH,kDAFU,aAAa,CAMpB;8BAnG2B,kCAAkC"}

package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.js

@@ -23,12 +23,11 @@ import { MESHLET_COLLECTION_WRITE_STRUCT } from "../../MESHLET_COLLECTION_WRITE_
 
 const resources = new ShaderResourceSetDescriptor();
 
-// per-dispatch, eight bytes, read-only: immediate data rather than a uniform buffer. camera stays
-// a uniform — it is a scene buffer, not a per-dispatch value.
-resources.setImmediate("resolution", vec2u);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads 65535 and culls everything. Revert 22893f0a7.
 resources.createGroup()
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+    .addUniform("resolution", vec2u)
     .addStorageBuffer("scene_database", WebGPUArray.from(u32))
     .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT))
     .addTexture("texture_hzb")

package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_meshlets_extract_bucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js"],"names":[],"mappings":"AAiEA,2DAIG;8BA/D2B,qCAAqC"}
+{"version":3,"file":"shader_meshlets_extract_bucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js"],"names":[],"mappings":"AAgEA,2DAIG;8BA9D2B,qCAAqC"}

package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js

@@ -13,11 +13,10 @@ import {
 
 const resources = new ShaderResourceSetDescriptor();
 
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the same
-// shape shader_read_out_bucket already uses
-resources.setImmediate("bucket_index", U32_CONTAINER_STRUCT);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads 65535 and culls everything. Revert 22893f0a7.
 resources.createGroup()
+    .addUniform("bucket_index", U32_CONTAINER_STRUCT)
     .addStorageBuffer("bucket_data", WebGPUStruct.from({
         headers: RASTERIZATION_BUCKET_SORT_OUTPUT_HEADER_STRUCT_READ,
         elements: WebGPUArray.from(MESHLET_DEFINITION_STRUCT)

package/src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pass_mesh_cull.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.js"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH,qCAJW,qBAAqB,0EAoD/B;AAvED;IACI,yBAAqB;IACrB,4BAAwB;IAExB,YAAQ;IAER;;OAEG;IACH,yBAAQ;IAER,qBAAiB;IACjB,gBAAY;IAEZ,gBAAY;CACf"}
+{"version":3,"file":"pass_mesh_cull.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.js"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,qCAJW,qBAAqB,0EAmD/B;AAtED;IACI,yBAAqB;IACrB,4BAAwB;IAExB,YAAQ;IAER;;OAEG;IACH,yBAAQ;IAER,qBAAiB;IACjB,gBAAY;IAEZ,gBAAY;CACf"}