@woosh/meep-engine 3.11.3 → 3.13.0

package/src/shade/renderer/restir/di/graph_restir_di_denoise.js

@@ -1,5 +1,4 @@
 import { TextureResourceDescriptor } from "../../../device/graph/TextureResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { shader_restir_di_denoise } from "./shader_restir_di_denoise.js";
 
 /**
@@ -51,7 +50,7 @@ export function graph_restir_di_denoise({
                         gBufferNormal: resources.get(data.normal).obtainView(),
                         output: resources.get(data.output).obtainView(),
                         camera: view.camera.buffer,
-                        step_size: context.encoder.allocateTransientValueBuffer(u32, step_size),
+                        step_size: step_size,
                     }
                 });
             }

package/src/shade/renderer/restir/di/shader_restir_di_denoise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_restir_di_denoise.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_denoise.js"],"names":[],"mappings":"AAmIA,qDAKG;8BAhI2B,+BAA+B"}
+{"version":3,"file":"shader_restir_di_denoise.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_denoise.js"],"names":[],"mappings":"AAsIA,qDAIG;8BAlI2B,+BAA+B"}

package/src/shade/renderer/restir/di/shader_restir_di_denoise.js

@@ -35,13 +35,16 @@ import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourc
 
 const resources = new ShaderResourceSetDescriptor();
 
+// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer. The a-trous
+// denoise runs one dispatch per step, so the buffer was allocated per iteration.
+resources.setImmediate("step_size", u32);
+
 resources.createGroup()
     .addTexture("tInput")
     .addTexture("gBufferDepth")
     .addTexture("gBufferNormal", "uint")
     .addStorageTexture("output", "rgba16float", "2d", "write-only")
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("step_size", u32);
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT);
 
 const body = CodeChunk.from(
     //language=WGSL
@@ -133,5 +136,4 @@ export const shader_restir_di_denoise = ComputeShader.from({
     label: "ReSTIR DI Denoise",
     resources,
     body,
-    group_size: [8, 8, 1],
 });

package/src/shade/renderer/restir/di/shader_restir_di_resample.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_restir_di_resample.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resample.js"],"names":[],"mappings":"AA4HA,sDAKG;8BAtH2B,+BAA+B"}
+{"version":3,"file":"shader_restir_di_resample.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resample.js"],"names":[],"mappings":"AA8HA,sDAIG;8BAvH2B,+BAA+B"}

package/src/shade/renderer/restir/di/shader_restir_di_resample.js

@@ -36,6 +36,9 @@ import { chunk_restir_temporal_reuse } from "./chunk_restir_temporal_reuse.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
+// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer
+resources.setImmediate("m_initial", u32);
+
 // G-buffer + reprojection inputs + uniforms (no storage buffers in this group).
 resources.createGroup()
     .addTexture("gBufferDepth")
@@ -47,8 +50,7 @@ resources.createGroup()
     .addTexture("tOcclusionClip")
     .addTexture("tSTBN_vec2", "unfilterable-float", "3d")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT)
-    .addUniform("m_initial", u32);
+    .addUniform("view", VIEW_UNIFORM_STRUCT);
 
 // Local lights + froxel clusters (the screen-space tile candidate set).
 const RESTIR_DI_LIGHT_GROUP = new ShaderResourceGroupDescriptor();
@@ -126,5 +128,4 @@ export const shader_restir_di_resample = ComputeShader.from({
     label: "ReSTIR DI Resample",
     resources,
     body,
-    group_size: [8, 8, 1],
 });

package/src/shade/renderer/restir/di/shader_restir_di_resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_restir_di_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resolve.js"],"names":[],"mappings":"AA8FA,qDAKG;8BA7F2B,+BAA+B"}
+{"version":3,"file":"shader_restir_di_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resolve.js"],"names":[],"mappings":"AAgGA,qDAIG;8BA9F2B,+BAA+B"}

package/src/shade/renderer/restir/di/shader_restir_di_resolve.js

@@ -28,6 +28,9 @@ import { chunk_restir_resolve } from "./chunk_restir_resolve.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
+// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer
+resources.setImmediate("use_screen_space_shadow", u32);
+
 // G-buffer + radiance output + uniforms.
 resources.createGroup()
     .addTexture("gBufferDepth")
@@ -40,8 +43,7 @@ resources.createGroup()
     .addTexture("tHZB")
     .addStorageTexture("output", "rgba16float", "2d", "write-only")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT)
-    .addUniform("use_screen_space_shadow", u32);
+    .addUniform("view", VIEW_UNIFORM_STRUCT);
 
 // Local light tables (resolve re-evaluates the selected light; no clusters needed).
 const RESTIR_DI_RESOLVE_LIGHT_GROUP = new ShaderResourceGroupDescriptor();
@@ -96,5 +98,4 @@ export const shader_restir_di_resolve = ComputeShader.from({
     label: "ReSTIR DI Resolve",
     resources,
     body,
-    group_size: [8, 8, 1],
 });

package/src/shade/renderer/restir/di/shader_restir_di_spatial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_restir_di_spatial.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_spatial.js"],"names":[],"mappings":"AA+GA,qDAKG;8BA3G2B,+BAA+B"}
+{"version":3,"file":"shader_restir_di_spatial.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_spatial.js"],"names":[],"mappings":"AA+GA,qDAIG;8BA1G2B,+BAA+B"}

package/src/shade/renderer/restir/di/shader_restir_di_spatial.js

@@ -1,117 +1,116 @@
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { chunk_rtxdi_pack_reservoir } from "../reservoir/chunk_rtxdi_pack_reservoir.js";
-import { chunk_rtxdi_unpack_reservoir } from "../reservoir/chunk_rtxdi_unpack_reservoir.js";
-import { RTXDI_PackedReservoir } from "../reservoir/RTXDI_PackedReservoir.js";
-import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { chunk_stbn_sample_vec2 } from "../../shader/chunk/noise/chunk_stbn_sample_vec2.js";
-import { chunk_random } from "../../shader/chunk/random/chunk_random.js";
-import { chunk_random_initialize } from "../../shader/chunk/random/chunk_random_initialize.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
-import { chunk_restir_reconstruct_surface } from "./chunk_restir_reconstruct_surface.js";
-import { chunk_restir_reservoir_address } from "./chunk_restir_reservoir_address.js";
-import { chunk_restir_spatial_reuse } from "./chunk_restir_spatial_reuse.js";
-
-/**
- * ReSTIR DI — spatial pass (between resample and resolve).
- *
- * Reads the resample pass's reservoir for the pixel and its neighbours
- * (`reservoir_input`), combines them with geometric rejection, and writes the
- * spatiotemporal result to `reservoir_output` — which the resolve pass shades and
- * which becomes next frame's temporal history.
- *
- * Holds light_data + the two reservoir buffers = 3 storage buffers (no ray
- * tracing, no clusters), well within maxStorageBuffersPerShaderStage.
- *
- * @type {ComputeShader}
- */
-
-const resources = new ShaderResourceSetDescriptor();
-
-// G-buffer (surface reconstruct + neighbour rejection) + uniforms.
-resources.createGroup()
-    .addTexture("gBufferDepth")
-    .addTexture("gBufferPBR")
-    .addTexture("gBufferNormal", "uint")
-    .addTexture("gBufferAlbedo")
-    .addTexture("gBufferEmissive", "uint")
-    .addTexture("tSTBN_vec2", "unfilterable-float", "3d")
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT);
-
-// Local light tables (recompute neighbour target functions; no clusters needed).
-const RESTIR_DI_SPATIAL_LIGHT_GROUP = new ShaderResourceGroupDescriptor();
-RESTIR_DI_SPATIAL_LIGHT_GROUP.label = "restir-di/spatial-lights";
-RESTIR_DI_SPATIAL_LIGHT_GROUP.addStorageBuffer("light_data", WebGPUArray.u32);
-resources.addGroup(RESTIR_DI_SPATIAL_LIGHT_GROUP);
-
-// Input = resample output (read, incl. neighbours), output = spatiotemporal final.
-const RESTIR_DI_SPATIAL_RESERVOIR_GROUP = new ShaderResourceGroupDescriptor();
-RESTIR_DI_SPATIAL_RESERVOIR_GROUP.label = "restir-di/spatial-reservoirs";
-RESTIR_DI_SPATIAL_RESERVOIR_GROUP
-    .addStorageBuffer("reservoir_input", WebGPUArray.from(RTXDI_PackedReservoir), false)
-    .addStorageBuffer("reservoir_output", WebGPUArray.from(RTXDI_PackedReservoir), true);
-resources.addGroup(RESTIR_DI_SPATIAL_RESERVOIR_GROUP);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(8, 8, 1)
-fn main(
-    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
-) {
-    let i_coord = global_invocation_id.xy;
-    let texture_size = textureDimensions(gBufferDepth);
-
-    if (!all(i_coord < texture_size)) {
-        return;
-    }
-
-    // Distinct seed from the resample pass so the tap rotation decorrelates.
-    random_initialize(vec3<u32>(i_coord, view.frame_index), vec3<u32>(0x68E31DA4u, 0xB5297A4Du, 0x1B56C4E9u));
-
-    let address = restir_reservoir_address(i_coord, texture_size.x);
-    let self_reservoir = rtxdi_unpack_reservoir(reservoir_input[address]);
-
-    var result = self_reservoir;
-
-    let surface = restir_reconstruct_surface(i_coord, texture_size);
-    if (surface.is_valid) {
-        // Blue-noise rotation for the neighbour tap pattern. Offset the STBN
-        // temporal slice so it decorrelates from the resample pass's STBN use.
-        let rotation_random = stbn_sample_vec2(vec3<u32>(i_coord, view.frame_index + 32u)).x;
-
-        result = restir_spatial_reuse(
-            self_reservoir,
-            surface.geometry,
-            surface.material,
-            surface.view_depth,
-            i_coord,
-            texture_size,
-            rotation_random,
-        );
-    }
-
-    reservoir_output[address] = rtxdi_pack_reservoir(result);
-}
-    `, [
-        chunk_restir_reconstruct_surface,
-        chunk_restir_spatial_reuse,
-        chunk_stbn_sample_vec2,
-        chunk_rtxdi_unpack_reservoir,
-        chunk_rtxdi_pack_reservoir,
-        chunk_restir_reservoir_address,
-        chunk_random,
-        chunk_random_initialize,
-    ]
-);
-
-export const shader_restir_di_spatial = ComputeShader.from({
-    label: "ReSTIR DI Spatial",
-    resources,
-    body,
-    group_size: [8, 8, 1],
-});
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { chunk_rtxdi_pack_reservoir } from "../reservoir/chunk_rtxdi_pack_reservoir.js";
+import { chunk_rtxdi_unpack_reservoir } from "../reservoir/chunk_rtxdi_unpack_reservoir.js";
+import { RTXDI_PackedReservoir } from "../reservoir/RTXDI_PackedReservoir.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { chunk_stbn_sample_vec2 } from "../../shader/chunk/noise/chunk_stbn_sample_vec2.js";
+import { chunk_random } from "../../shader/chunk/random/chunk_random.js";
+import { chunk_random_initialize } from "../../shader/chunk/random/chunk_random_initialize.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { chunk_restir_reconstruct_surface } from "./chunk_restir_reconstruct_surface.js";
+import { chunk_restir_reservoir_address } from "./chunk_restir_reservoir_address.js";
+import { chunk_restir_spatial_reuse } from "./chunk_restir_spatial_reuse.js";
+
+/**
+ * ReSTIR DI — spatial pass (between resample and resolve).
+ *
+ * Reads the resample pass's reservoir for the pixel and its neighbours
+ * (`reservoir_input`), combines them with geometric rejection, and writes the
+ * spatiotemporal result to `reservoir_output` — which the resolve pass shades and
+ * which becomes next frame's temporal history.
+ *
+ * Holds light_data + the two reservoir buffers = 3 storage buffers (no ray
+ * tracing, no clusters), well within maxStorageBuffersPerShaderStage.
+ *
+ * @type {ComputeShader}
+ */
+
+const resources = new ShaderResourceSetDescriptor();
+
+// G-buffer (surface reconstruct + neighbour rejection) + uniforms.
+resources.createGroup()
+    .addTexture("gBufferDepth")
+    .addTexture("gBufferPBR")
+    .addTexture("gBufferNormal", "uint")
+    .addTexture("gBufferAlbedo")
+    .addTexture("gBufferEmissive", "uint")
+    .addTexture("tSTBN_vec2", "unfilterable-float", "3d")
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+    .addUniform("view", VIEW_UNIFORM_STRUCT);
+
+// Local light tables (recompute neighbour target functions; no clusters needed).
+const RESTIR_DI_SPATIAL_LIGHT_GROUP = new ShaderResourceGroupDescriptor();
+RESTIR_DI_SPATIAL_LIGHT_GROUP.label = "restir-di/spatial-lights";
+RESTIR_DI_SPATIAL_LIGHT_GROUP.addStorageBuffer("light_data", WebGPUArray.u32);
+resources.addGroup(RESTIR_DI_SPATIAL_LIGHT_GROUP);
+
+// Input = resample output (read, incl. neighbours), output = spatiotemporal final.
+const RESTIR_DI_SPATIAL_RESERVOIR_GROUP = new ShaderResourceGroupDescriptor();
+RESTIR_DI_SPATIAL_RESERVOIR_GROUP.label = "restir-di/spatial-reservoirs";
+RESTIR_DI_SPATIAL_RESERVOIR_GROUP
+    .addStorageBuffer("reservoir_input", WebGPUArray.from(RTXDI_PackedReservoir), false)
+    .addStorageBuffer("reservoir_output", WebGPUArray.from(RTXDI_PackedReservoir), true);
+resources.addGroup(RESTIR_DI_SPATIAL_RESERVOIR_GROUP);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(8, 8, 1)
+fn main(
+    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
+) {
+    let i_coord = global_invocation_id.xy;
+    let texture_size = textureDimensions(gBufferDepth);
+
+    if (!all(i_coord < texture_size)) {
+        return;
+    }
+
+    // Distinct seed from the resample pass so the tap rotation decorrelates.
+    random_initialize(vec3<u32>(i_coord, view.frame_index), vec3<u32>(0x68E31DA4u, 0xB5297A4Du, 0x1B56C4E9u));
+
+    let address = restir_reservoir_address(i_coord, texture_size.x);
+    let self_reservoir = rtxdi_unpack_reservoir(reservoir_input[address]);
+
+    var result = self_reservoir;
+
+    let surface = restir_reconstruct_surface(i_coord, texture_size);
+    if (surface.is_valid) {
+        // Blue-noise rotation for the neighbour tap pattern. Offset the STBN
+        // temporal slice so it decorrelates from the resample pass's STBN use.
+        let rotation_random = stbn_sample_vec2(vec3<u32>(i_coord, view.frame_index + 32u)).x;
+
+        result = restir_spatial_reuse(
+            self_reservoir,
+            surface.geometry,
+            surface.material,
+            surface.view_depth,
+            i_coord,
+            texture_size,
+            rotation_random,
+        );
+    }
+
+    reservoir_output[address] = rtxdi_pack_reservoir(result);
+}
+    `, [
+        chunk_restir_reconstruct_surface,
+        chunk_restir_spatial_reuse,
+        chunk_stbn_sample_vec2,
+        chunk_rtxdi_unpack_reservoir,
+        chunk_rtxdi_pack_reservoir,
+        chunk_restir_reservoir_address,
+        chunk_random,
+        chunk_random_initialize,
+    ]
+);
+
+export const shader_restir_di_spatial = ComputeShader.from({
+    label: "ReSTIR DI Spatial",
+    resources,
+    body,
+});

package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUInstancesAccelerationStructure.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/GPUInstancesAccelerationStructure.js"],"names":[],"mappings":"AAgCA;;GAEG;AACH;IA2EI;;;OAGG;IACH,uCAcC;IA/ED;;;;;OAKG;IACH,eAEC;IAED,cAKC;IAOD;;;OAGG;IACH,wBAEC;IA2DD;;;;OAIG;IACH,oBAHW,MAAM,wBAmBhB;IAED;;;;;;OAMG;IACH,uBAFW,MAAM,QAkBhB;IAED;;;;OAIG;IACH,uBAHW,MAAM,wBAYhB;IAuID;;OAEG;IACH,oDAIC;IAED;;OAEG;IACH,+CAMC;;CACJ;oBA/VmB,gCAAgC"}
+{"version":3,"file":"GPUInstancesAccelerationStructure.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/GPUInstancesAccelerationStructure.js"],"names":[],"mappings":"AA+BA;;GAEG;AACH;IA2EI;;;OAGG;IACH,uCAcC;IA/ED;;;;;OAKG;IACH,eAEC;IAED,cAKC;IAOD;;;OAGG;IACH,wBAEC;IA2DD;;;;OAIG;IACH,oBAHW,MAAM,wBAmBhB;IAED;;;;;;OAMG;IACH,uBAFW,MAAM,QAkBhB;IAED;;;;OAIG;IACH,uBAHW,MAAM,wBAYhB;IAuID;;OAEG;IACH,oDAIC;IAED;;OAEG;IACH,+CAMC;;CACJ;oBA9VmB,gCAAgC"}

package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.js

@@ -4,7 +4,6 @@ import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGra
 import { BufferResourceDescriptor } from "../../device/graph/BufferResourceDescriptor.js";
 import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
 import { ensure_buffer_capacity } from "../geometry/make_temp_gpu_buffer.js";
-import { BVH_BUILD_SETTINGS_STRUCT } from "../gpu_primitive/bvh/BVH_BUILD_SETTINGS_STRUCT.js";
 import { bvh_buffer_size } from "../gpu_primitive/bvh/BVH_BUFFER_LAYOUT.js";
 import { graph_bvh_build_lbvh } from "../gpu_primitive/bvh/graph_bvh_build_lbvh.js";
 import { shader_bvh_extract_instance_leaves } from "./shader_bvh_extract_instance_leaves.js";
@@ -365,14 +364,11 @@ function extract_execute(pass_data, resources, context) {
     // Seeded rather than cleared: the merge is a min/max, and zero is not an identity for either.
     encoder.writeBuffer(scene_bounds, 0, SCENE_BOUNDS_SEED.buffer, 0, SCENE_BOUNDS_SEED.byteLength);
 
-    shader_bvh_extract_instance_leaves.dispatchLinear({
+    shader_bvh_extract_instance_leaves.dispatchThreads({
         encoder,
-        element_count: pass_data.element_count,
+        thread_count_x: pass_data.element_count,
         bindings: {
-            settings: encoder.allocateTransientValueBuffer(
-                BVH_BUILD_SETTINGS_STRUCT,
-                { element_count: pass_data.element_count }
-            ),
+            settings: { element_count: pass_data.element_count },
             rows: resources.get(pass_data.rows),
             scene_database: resources.get(pass_data.scene_database),
             leaf_bounds: resources.get(pass_data.leaf_bounds),

package/src/shade/renderer/scene/hierarchy/graph_scene_update_transform_hierarchy_naive.js

@@ -1,123 +1,123 @@
-import { assert } from "../../../../core/assert.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 { graph_import_buffer } from "../../shader/graph/graph_import_buffer.js";
-import {
-    shader_nodes_update_transform_hierarchy_naive
-} from "./shader_nodes_update_transform_hierarchy_naive.js";
-
-/**
- * High-level wrapper for the brute-force transform-hierarchy update.
- *
- * Drop-in alternative to {@link graph_scene_update_transform_hierarchy}
- * that drives the simple "every thread walks its own parent chain"
- * shader instead of the CSDLDF lookback variant. Same input shape
- * (full `[0, node_count)` sweep), same output (writes `node.global`),
- * same return contract — swap the import in the caller and nothing
- * else changes.
- *
- * Useful as a known-correct reference: when the CSDLDF variant
- * misbehaves, run the naive one in its place and see if the symptom
- * persists. If it does, the bug is upstream of the propagation
- * (apply pass, build, scene_database upload). If it doesn't, the
- * bug is in CSDLDF's lookback / fallback / spine logic.
- *
- * @param {object}              args
- * @param {FrameGraph}          args.graph
- * @param {GPUSceneContext}     args.scene
- * @param {number}             [args.scene_database] optional graph
- *      resource handle to chain off if the database was already
- *      written by an earlier pass this frame. Omit for a standalone
- *      import.
- *
- * @returns {{ scene_database: number }}
- */
-export function graph_scene_update_transform_hierarchy_naive({
-                                                                 graph,
-                                                                 scene,
-                                                                 scene_database,
-                                                             }) {
-    assert.defined(graph, 'graph');
-    assert.defined(scene, 'scene');
-    assert.equal(scene.isGPUSceneContext, true, 'scene must be a GPUSceneContext');
-
-    // Live rows, which is not the same as the highest row in use: removal frees a row and leaves a
-    // hole, so the ids are taken from the table's occupancy below rather than counted up.
-    const transforms_table = scene.scene_database.get('transforms');
-    const node_count = transforms_table.count;
-
-    const gr_scene_database = scene_database !== undefined
-        ? scene_database
-        : graph_import_buffer(graph, scene.scene_database_buffer, "scene_database");
-
-    if (node_count === 0) {
-        return { scene_database: gr_scene_database };
-    }
-
-    // ── Pass 1: assemble the input buffer ───────────────────────────
-    // Same layout as the CSDLDF wrapper: u32 count + 12 bytes of
-    // alignment padding + `array<u32>` of node ids.
-
-    const HEADER_BYTES = 16;
-    const HEADER_U32S = HEADER_BYTES / u32.size;
-    const buffer_byte_size = round_up(HEADER_BYTES + node_count * u32.size, 16);
-
-    const build_data = {};
-
-    function build_execute(data, resources, context) {
-        const buffer = resources.get(data.buffer);
-        const encoder = context.encoder;
-
-        const flat = new Uint32Array(HEADER_U32S + node_count);
-        flat[0] = transforms_table.write_occupied_element_ids(flat, HEADER_U32S);
-
-        encoder.writeBuffer(
-            buffer, 0,
-            flat.buffer, flat.byteOffset,
-            flat.byteLength,
-        );
-    }
-
-    const build_pass = graph.add(
-        "scene-graph naive / build node id list",
-        build_data,
-        build_execute,
-    );
-    build_data.buffer = build_pass.create(
-        "node id list (naive)",
-        BufferResourceDescriptor.from(
-            buffer_byte_size,
-            GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
-        ),
-    );
-
-    // ── Pass 2: dispatch the brute-force update ────────────────────
-
-    const update_data = {};
-
-    function update_execute(data, resources, context) {
-        shader_nodes_update_transform_hierarchy_naive.dispatchLinear({
-            encoder: context.encoder,
-            element_count: node_count,
-            bindings: {
-                input: resources.get(data.input),
-                scene_database: resources.get(data.scene_database),
-            },
-        });
-    }
-
-    const update_pass = graph.add(
-        "scene-graph naive / propagate",
-        update_data,
-        update_execute,
-    );
-    update_data.input = update_pass.read(build_data.buffer);
-    update_data.scene_database = update_pass.write(
-        update_pass.read(gr_scene_database)
-    );
-
-    return {
-        scene_database: update_data.scene_database,
-    };
-}
+import { assert } from "../../../../core/assert.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 { graph_import_buffer } from "../../shader/graph/graph_import_buffer.js";
+import {
+    shader_nodes_update_transform_hierarchy_naive
+} from "./shader_nodes_update_transform_hierarchy_naive.js";
+
+/**
+ * High-level wrapper for the brute-force transform-hierarchy update.
+ *
+ * Drop-in alternative to {@link graph_scene_update_transform_hierarchy}
+ * that drives the simple "every thread walks its own parent chain"
+ * shader instead of the CSDLDF lookback variant. Same input shape
+ * (full `[0, node_count)` sweep), same output (writes `node.global`),
+ * same return contract — swap the import in the caller and nothing
+ * else changes.
+ *
+ * Useful as a known-correct reference: when the CSDLDF variant
+ * misbehaves, run the naive one in its place and see if the symptom
+ * persists. If it does, the bug is upstream of the propagation
+ * (apply pass, build, scene_database upload). If it doesn't, the
+ * bug is in CSDLDF's lookback / fallback / spine logic.
+ *
+ * @param {object}              args
+ * @param {FrameGraph}          args.graph
+ * @param {GPUSceneContext}     args.scene
+ * @param {number}             [args.scene_database] optional graph
+ *      resource handle to chain off if the database was already
+ *      written by an earlier pass this frame. Omit for a standalone
+ *      import.
+ *
+ * @returns {{ scene_database: number }}
+ */
+export function graph_scene_update_transform_hierarchy_naive({
+                                                                 graph,
+                                                                 scene,
+                                                                 scene_database,
+                                                             }) {
+    assert.defined(graph, 'graph');
+    assert.defined(scene, 'scene');
+    assert.equal(scene.isGPUSceneContext, true, 'scene must be a GPUSceneContext');
+
+    // Live rows, which is not the same as the highest row in use: removal frees a row and leaves a
+    // hole, so the ids are taken from the table's occupancy below rather than counted up.
+    const transforms_table = scene.scene_database.get('transforms');
+    const node_count = transforms_table.count;
+
+    const gr_scene_database = scene_database !== undefined
+        ? scene_database
+        : graph_import_buffer(graph, scene.scene_database_buffer, "scene_database");
+
+    if (node_count === 0) {
+        return { scene_database: gr_scene_database };
+    }
+
+    // ── Pass 1: assemble the input buffer ───────────────────────────
+    // Same layout as the CSDLDF wrapper: u32 count + 12 bytes of
+    // alignment padding + `array<u32>` of node ids.
+
+    const HEADER_BYTES = 16;
+    const HEADER_U32S = HEADER_BYTES / u32.size;
+    const buffer_byte_size = round_up(HEADER_BYTES + node_count * u32.size, 16);
+
+    const build_data = {};
+
+    function build_execute(data, resources, context) {
+        const buffer = resources.get(data.buffer);
+        const encoder = context.encoder;
+
+        const flat = new Uint32Array(HEADER_U32S + node_count);
+        flat[0] = transforms_table.write_occupied_element_ids(flat, HEADER_U32S);
+
+        encoder.writeBuffer(
+            buffer, 0,
+            flat.buffer, flat.byteOffset,
+            flat.byteLength,
+        );
+    }
+
+    const build_pass = graph.add(
+        "scene-graph naive / build node id list",
+        build_data,
+        build_execute,
+    );
+    build_data.buffer = build_pass.create(
+        "node id list (naive)",
+        BufferResourceDescriptor.from(
+            buffer_byte_size,
+            GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+        ),
+    );
+
+    // ── Pass 2: dispatch the brute-force update ────────────────────
+
+    const update_data = {};
+
+    function update_execute(data, resources, context) {
+        shader_nodes_update_transform_hierarchy_naive.dispatchThreads({
+            encoder: context.encoder,
+            thread_count_x: node_count,
+            bindings: {
+                input: resources.get(data.input),
+                scene_database: resources.get(data.scene_database),
+            },
+        });
+    }
+
+    const update_pass = graph.add(
+        "scene-graph naive / propagate",
+        update_data,
+        update_execute,
+    );
+    update_data.input = update_pass.read(build_data.buffer);
+    update_data.scene_database = update_pass.write(
+        update_pass.read(gr_scene_database)
+    );
+
+    return {
+        scene_database: update_data.scene_database,
+    };
+}

package/src/shade/renderer/scene/hierarchy/shader_nodes_record_input_positions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_nodes_record_input_positions.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/scene/hierarchy/shader_nodes_record_input_positions.js"],"names":[],"mappings":"AAwDA;;GAEG;AACH,kDAFU,aAAa,CAOpB;8BA5D2B,+BAA+B"}
+{"version":3,"file":"shader_nodes_record_input_positions.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/scene/hierarchy/shader_nodes_record_input_positions.js"],"names":[],"mappings":"AAwDA;;GAEG;AACH,kDAFU,aAAa,CAMpB;8BA3D2B,+BAA+B"}