@woosh/meep-engine 3.58.0 → 3.59.0

package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw.js

@@ -4,6 +4,7 @@ import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js"
 import { SHADING_LIGHT_RESOURCE_GROUP } from "../../../deferred/SHADING_LIGHT_RESOURCE_GROUP.js";
 import { DEPTH_BACKGROUND_VALUE } from "../../../depth/DEPTH_BACKGROUND_VALUE.js";
 import { BRICK4_DATA_STRUCT } from "../../../global_illumination/brick4/gpu/BRICK4_DATA_STRUCT.js";
+import { PROBE_CLIPMAP_SAMPLING_GROUP } from "../../../global_illumination/probe_clipmap/probe/chunk_probe_clipmap_pick.js";
 import { STANDARD_MATERIAL_TEMPLATE } from "../../../material/standard/STANDARD_MATERIAL_TEMPLATE.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { RenderPassColorAttachmentDescriptor } from "../../../shader/pass/RenderPassColorAttachmentDescriptor.js";
@@ -31,7 +32,8 @@ import {
 
 /**
  * The draw's own group, group 2: the view, the AVBOIT volume, and what every indirect lighting mode
- * reads (`brick4`; `tEnvironment` is the lights'). The orchestrator binds it by name.
+ * reads (`brick4`, the probe clipmap's probes; `tEnvironment` is the lights'). The orchestrator binds it
+ * by name.
  *
  * @type {ShaderResourceGroupDescriptor}
  */
@@ -52,12 +54,26 @@ AVBOIT_DRAW_VIEW_GROUP
     .addTexture("tVolumetrics", "float", "3d")
     .addTexture("tSTBN_vec3", "float", "3d")
 
+// the probes, read under the probe clipmap's indirect lighting; their owner binds them in every mode
+for (const declaration of PROBE_CLIPMAP_SAMPLING_GROUP.resources) {
+    AVBOIT_DRAW_VIEW_GROUP.add(declaration);
+}
+
 const pass_groups = [AVBOIT_DRAW_VIEW_GROUP, SHADING_LIGHT_RESOURCE_GROUP];
 
 // the view group keeps the visibility the orchestrator builds its bind group for, as the vertex stage
-// reads the camera from it; the lights are the fragment stage's alone
+// reads the camera from it, but for the probes; they and the lights are the fragment stage's alone, which
+// keeps the vertex stage at 8 storage buffers of the 10 a device is asked for
+const view_layout = AVBOIT_DRAW_VIEW_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT);
+
+for (const declaration of PROBE_CLIPMAP_SAMPLING_GROUP.resources) {
+    const binding = AVBOIT_DRAW_VIEW_GROUP.get(declaration.name).binding_index;
+
+    view_layout.entries.find(entry => entry.binding === binding).visibility = GPUShaderStage.FRAGMENT;
+}
+
 const pass_layouts = [
-    AVBOIT_DRAW_VIEW_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
+    view_layout,
     FORWARD_LIGHT_LAYOUT,
 ];
 

package/src/shade/renderer/rasterize/native/graph_rasterize_meshes_alpha_tested.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_meshes_alpha_tested.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/native/graph_rasterize_meshes_alpha_tested.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;GAgBG;AACH;IAd+B,KAAK;IACT,OAAO,EAAvB,MAAM;IACkB,QAAQ;IACd,YAAY,GAA9B,OAAO;IACiB,IAAI,GAA5B,aAAa;IACmC,WAAW,GAA3D,SAAS,OAAO,MAAM,cAAc,CAAC;IACrB,KAAK,EAArB,MAAM;IACU,GAAG,EAAnB,MAAM;IACY,oBAAoB,EAAtC,MAAM,EAAE;IACqB,MAAM;IAChB,QAAQ,GAA3B,MAAM,EAAE;IACwB,sBAAsB;IACpD;IAAC,QAAQ,EAAC,OAAO,CAAC;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CAuPpE;8BA3R6B,iCAAiC"}
+{"version":3,"file":"graph_rasterize_meshes_alpha_tested.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/native/graph_rasterize_meshes_alpha_tested.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;GAgBG;AACH;IAd+B,KAAK;IACT,OAAO,EAAvB,MAAM;IACkB,QAAQ;IACd,YAAY,GAA9B,OAAO;IACiB,IAAI,GAA5B,aAAa;IACmC,WAAW,GAA3D,SAAS,OAAO,MAAM,cAAc,CAAC;IACrB,KAAK,EAArB,MAAM;IACU,GAAG,EAAnB,MAAM;IACY,oBAAoB,EAAtC,MAAM,EAAE;IACqB,MAAM;IAChB,QAAQ,GAA3B,MAAM,EAAE;IACwB,sBAAsB;IACpD;IAAC,QAAQ,EAAC,OAAO,CAAC;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CAyPpE;8BA7R6B,iCAAiC"}

package/src/shade/renderer/rasterize/native/graph_rasterize_meshes_alpha_tested.js

@@ -140,7 +140,9 @@ export function graph_rasterize_meshes_alpha_tested({
         const partial_clear_needed = !is_viewport_unrestricted && clear_target;
 
         if (partial_clear_needed) {
-            // TODO clear color targets
+            for (let i = 0; i < color_targets.length; i++) {
+                texture_fill_rectangle(encoder, color_targets[i], viewport, render_pass_descriptor.colorAttachments[i].clearValue);
+            }
             texture_fill_rectangle(encoder, depth_texture, viewport, [render_pass_descriptor.depthStencilAttachment.depthClearValue]);
         }
 
@@ -149,7 +151,7 @@ export function graph_rasterize_meshes_alpha_tested({
         const gpu_pass_descriptor = render_pass_descriptor.toGPU({
             colorTargets: color_targets,
             depthTarget: depth_texture,
-            loadOp: clear_target ? "clear" : "load",
+            loadOp: !partial_clear_needed && clear_target ? "clear" : "load",
         });
 
         const pass_encoder = encoder.beginRenderPass(gpu_pass_descriptor);

package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.d.ts

@@ -14,7 +14,9 @@
  * @param {number} shadowmap_atlas
  * @param {ShaderSwitchSet} [shader_switches] the renderer's; the resolve's pipelines are built for them, and
  *   the set is all the resolve needs to know of the indirect lighting mode
+ * @param {import("../../../global_illumination/probe_clipmap/GPUProbeClipmapGI.js").GPUProbeClipmapGI} probes
+ *   the renderer's probe clipmap GI, whose probes the resolve binds in every mode
  * @returns {number} resource ID of modified color texture
  */
-export function graph_rasterize_meshes_transparent_oit({ graph, buckets, view_ctx, viewport, depth_texture, color_texture, limits, light_cluster_parameters, light_cluster_lookup, light_cluster_data, shadowmap_atlas, volumetrics_lut, volumetrics_metadata, shader_switches, }: FrameGraph): number;
+export function graph_rasterize_meshes_transparent_oit({ graph, buckets, view_ctx, viewport, depth_texture, color_texture, limits, light_cluster_parameters, light_cluster_lookup, light_cluster_data, shadowmap_atlas, volumetrics_lut, volumetrics_metadata, shader_switches, probes, }: FrameGraph): number;
 //# sourceMappingURL=graph_rasterize_meshes_transparent_oit.d.ts.map

package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_meshes_transparent_oit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js"],"names":[],"mappings":"AA0YA;;;;;;;;;;;;;;;;;GAiBG;AACH,gSAFa,MAAM,CAyOlB"}
+{"version":3,"file":"graph_rasterize_meshes_transparent_oit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js"],"names":[],"mappings":"AAiZA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wSAFa,MAAM,CA6OlB"}

package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js

@@ -50,6 +50,8 @@ import { SHADING_SCENE_LAYOUT } from "../../forward/SHADING_SCENE_RESOURCE_GROUP
  * @param {number} output
  * @param {PrimitiveState} primitive
  * @param {ShaderSwitchSet} shader_switches the renderer's; the resolve's pipelines are built for them
+ * @param {import("../../../global_illumination/probe_clipmap/GPUProbeClipmapGI.js").GPUProbeClipmapGI} probes
+ *   the renderer's probe clipmap GI, whose probes the resolve binds in every mode
  * @return {number}
  */
 function graph_oit_resolve_moments({
@@ -75,8 +77,10 @@ function graph_oit_resolve_moments({
 
                                        output = -1,
                                        shader_switches = ShaderSwitchSet.EMPTY,
+                                       probes,
                                    }) {
 
+    assert.defined(probes, 'probes');
     assert.isNonNegativeInteger(material_count, 'material_count');
     assert.isNonNegativeInteger(draw_commands, 'draw_commands');
     assert.isNonNegativeInteger(meshlets, 'meshlets');
@@ -169,22 +173,24 @@ function graph_oit_resolve_moments({
 
         const stbn_vec3 = graphics.textures.obtain(STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec3);
 
-        // by name: every indirect lighting mode's resources, whichever the pipeline's variant reads
+        // by name: every indirect lighting mode's resources, whichever the pipeline's variant reads; the
+        // probes, a clipmap of no cascade while the probe clipmap has none
+        const view_inputs = data.probes.write_sampling_bindings({
+            camera: view_ctx.camera.buffer.buffer,
+            view: view_ctx.uniform_buffer.buffer,
+            moments: t_moments,
+            optical_depth: t_optical_depth,
+            brick4: view_ctx.scene.volumetric_light_map.buffer,
+            tSplitSum: t_split_sum_lut,
+            sLinear: sampler_linear,
+            // volumetrics
+            volumetrics_metadata,
+            tVolumetrics: t_volumetrics_lut,
+            tSTBN_vec3: stbn_vec3,
+        });
         const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
             render_pass_descriptor.pipeline_layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
-            OIT_RESOLVE_VIEW_GROUP.generateBindings({
-                camera: view_ctx.camera.buffer.buffer,
-                view: view_ctx.uniform_buffer.buffer,
-                moments: t_moments,
-                optical_depth: t_optical_depth,
-                brick4: view_ctx.scene.volumetric_light_map.buffer,
-                tSplitSum: t_split_sum_lut,
-                sLinear: sampler_linear,
-                // volumetrics
-                volumetrics_metadata,
-                tVolumetrics: t_volumetrics_lut,
-                tSTBN_vec3: stbn_vec3,
-            }, encoder)
+            OIT_RESOLVE_VIEW_GROUP.generateBindings(view_inputs, encoder)
         ));
 
         pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_VIEW, view_bindings);
@@ -206,6 +212,7 @@ function graph_oit_resolve_moments({
 
     const pass_data = {
         shader_switches,
+        probes,
     };
     const pass = graph.add("MBOIT/resolve moments", pass_data, execute);
 
@@ -408,6 +415,8 @@ function graph_oit_generate_moments({
  * @param {number} shadowmap_atlas
  * @param {ShaderSwitchSet} [shader_switches] the renderer's; the resolve's pipelines are built for them, and
  *   the set is all the resolve needs to know of the indirect lighting mode
+ * @param {import("../../../global_illumination/probe_clipmap/GPUProbeClipmapGI.js").GPUProbeClipmapGI} probes
+ *   the renderer's probe clipmap GI, whose probes the resolve binds in every mode
  * @returns {number} resource ID of modified color texture
  */
 export function graph_rasterize_meshes_transparent_oit({
@@ -428,10 +437,12 @@ export function graph_rasterize_meshes_transparent_oit({
                                                            volumetrics_metadata,
 
                                                            shader_switches = ShaderSwitchSet.EMPTY,
+                                                           probes,
                                                        }) {
 
 
     assert.isNonNegativeInteger(buckets, 'buckets');
+    assert.defined(probes, 'probes');
 
     assert.isNonNegativeInteger(light_cluster_parameters, 'light_cluster_parameters');
     assert.isNonNegativeInteger(light_cluster_lookup, 'light_cluster_lookup');
@@ -598,6 +609,7 @@ export function graph_rasterize_meshes_transparent_oit({
         volumetrics_metadata,
 
         shader_switches,
+        probes,
     });
 
     resolved = graph_oit_resolve_moments({
@@ -625,6 +637,7 @@ export function graph_rasterize_meshes_transparent_oit({
         volumetrics_metadata,
 
         shader_switches,
+        probes,
     });
 
     const [blended] = graph_image_pass({

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.d.ts

@@ -1,6 +1,7 @@
 /**
  * The resolve's own group, group 2: the view, the moments, and what every indirect lighting mode
- * reads (`brick4`; `tEnvironment` is the lights'). The orchestrator binds it by name.
+ * reads (`brick4`, the probe clipmap's probes; `tEnvironment` is the lights'). The orchestrator binds it
+ * by name.
  *
  * @type {ShaderResourceGroupDescriptor}
  */

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_oit_resolve_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,qCAFU,6BAA6B,CAEmC;AA+B1E;;;;;;GAMG;AACH,yCAFU,sBAAsB,CAmC7B;8CA5F2C,2DAA2D;uCAIlE,iCAAiC"}
+{"version":3,"file":"shader_oit_resolve_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,qCAFU,6BAA6B,CAEmC;AA6C1E;;;;;;GAMG;AACH,yCAFU,sBAAsB,CAmC7B;8CA3G2C,2DAA2D;uCAIlE,iCAAiC"}

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js

@@ -4,6 +4,7 @@ import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js"
 import { SHADING_LIGHT_RESOURCE_GROUP } from "../../../deferred/SHADING_LIGHT_RESOURCE_GROUP.js";
 import { DEPTH_BACKGROUND_VALUE } from "../../../depth/DEPTH_BACKGROUND_VALUE.js";
 import { BRICK4_DATA_STRUCT } from "../../../global_illumination/brick4/gpu/BRICK4_DATA_STRUCT.js";
+import { PROBE_CLIPMAP_SAMPLING_GROUP } from "../../../global_illumination/probe_clipmap/probe/chunk_probe_clipmap_pick.js";
 import { STANDARD_MATERIAL_TEMPLATE } from "../../../material/standard/STANDARD_MATERIAL_TEMPLATE.js";
 import { VOLUMETRICS_METADATA_STRUCT } from "../../../volumetrics/VOLUMETRICS_METADATA_STRUCT.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
@@ -30,7 +31,8 @@ import { vertex_shader_chunk } from "../../forward/vertex_shader_chunk.js";
 
 /**
  * The resolve's own group, group 2: the view, the moments, and what every indirect lighting mode
- * reads (`brick4`; `tEnvironment` is the lights'). The orchestrator binds it by name.
+ * reads (`brick4`, the probe clipmap's probes; `tEnvironment` is the lights'). The orchestrator binds it
+ * by name.
  *
  * @type {ShaderResourceGroupDescriptor}
  */
@@ -50,12 +52,26 @@ OIT_RESOLVE_VIEW_GROUP
     .addTexture("tVolumetrics", "float", "3d")
     .addTexture("tSTBN_vec3", "float", "3d")
 
+// the probes, read under the probe clipmap's indirect lighting; their owner binds them in every mode
+for (const declaration of PROBE_CLIPMAP_SAMPLING_GROUP.resources) {
+    OIT_RESOLVE_VIEW_GROUP.add(declaration);
+}
+
 const pass_groups = [OIT_RESOLVE_VIEW_GROUP, SHADING_LIGHT_RESOURCE_GROUP];
 
 // the view group keeps the visibility the orchestrator builds its bind group for, as the vertex stage
-// reads the camera from it; the lights are the fragment stage's alone
+// reads the camera from it, but for the probes; they and the lights are the fragment stage's alone, as
+// the AVBOIT draw keeps them
+const view_layout = OIT_RESOLVE_VIEW_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT);
+
+for (const declaration of PROBE_CLIPMAP_SAMPLING_GROUP.resources) {
+    const binding = OIT_RESOLVE_VIEW_GROUP.get(declaration.name).binding_index;
+
+    view_layout.entries.find(entry => entry.binding === binding).visibility = GPUShaderStage.FRAGMENT;
+}
+
 const pass_layouts = [
-    OIT_RESOLVE_VIEW_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
+    view_layout,
     FORWARD_LIGHT_LAYOUT,
 ];
 

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_bounds.d.ts

@@ -1,12 +1,6 @@
 /**
- * The AABB of one triangle of a meshlet, from positions alone.
- *
- * {@link chunk_read_meshlet_triangle_vertices} answers the same addressing question and then decodes
- * every attribute a shaded hit needs — normal, tangent, two UV sets, colour. A bounds pass wants
- * none of that, and runs over every triangle of a deformed mesh every frame, so it reads the three
- * positions and stops. The index addressing, the attribute-section offset and the vertex clamp are
- * the shared chunks either way, which is where a disagreement between the two would actually hurt:
- * bounds that do not contain the triangle the ray query goes on to intersect.
+ * The AABB of one triangle of a meshlet, from positions alone ({@link chunk_read_meshlet_triangle_positions}): a
+ * bounds pass runs over every triangle of a deformed mesh every frame, and decodes no other attribute.
  *
  * @type {CodeChunk}
  */

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_bounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_read_meshlet_triangle_bounds.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_bounds.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,iDAFU,SAAS,CAkChB;0BAjDuB,gCAAgC"}
+{"version":3,"file":"chunk_read_meshlet_triangle_bounds.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_bounds.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,iDAFU,SAAS,CAgBhB;0BAvBuB,gCAAgC"}

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_bounds.js

@@ -1,52 +1,25 @@
-import { AABB3_STRUCT } from "../aabb3/AABB3_STRUCT.js";
-import { MESHLET_METADATA_STRUCT } from "../../../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
-import { CodeChunk } from "../../../compiler/CodeChunk.js";
-import { chunk_meshlet_compute_attribute_section_offset } from "./chunk_meshlet_compute_attribute_section_offset.js";
-import { chunk_read_meshlet_attribute_vec3f } from "./chunk_read_meshlet_attribute_vec3f.js";
-import { chunk_read_meshlet_resolved_index } from "./chunk_read_meshlet_resolved_index.js";
-
-/**
- * The AABB of one triangle of a meshlet, from positions alone.
- *
- * {@link chunk_read_meshlet_triangle_vertices} answers the same addressing question and then decodes
- * every attribute a shaded hit needs — normal, tangent, two UV sets, colour. A bounds pass wants
- * none of that, and runs over every triangle of a deformed mesh every frame, so it reads the three
- * positions and stops. The index addressing, the attribute-section offset and the vertex clamp are
- * the shared chunks either way, which is where a disagreement between the two would actually hurt:
- * bounds that do not contain the triangle the ray query goes on to intersect.
- *
- * @type {CodeChunk}
- */
-export const chunk_read_meshlet_triangle_bounds = CodeChunk.from(
-    //language=WGSL
-    `
-fn read_meshlet_triangle_bounds(
-    meshlet_id: u32,
-    triangle_id: u32
-) -> ${AABB3_STRUCT.wgsl_ref} {
-    let header = meshlet_metadata[meshlet_id];
-
-    let attribute_offset = meshlet_compute_attribute_section_offset(header);
-
-    let index_offset = triangle_id * 3u;
-
-    // position is the first attribute of the section, three floats per vertex
-    let a = read_meshlet_attribute_vec3f(
-        attribute_offset + min(read_meshlet_resolved_index(header, index_offset), header.vertex_count - 1u) * 3u
-    );
-    let b = read_meshlet_attribute_vec3f(
-        attribute_offset + min(read_meshlet_resolved_index(header, index_offset + 1u), header.vertex_count - 1u) * 3u
-    );
-    let c = read_meshlet_attribute_vec3f(
-        attribute_offset + min(read_meshlet_resolved_index(header, index_offset + 2u), header.vertex_count - 1u) * 3u
-    );
-
-    return ${AABB3_STRUCT.wgsl_ref}(min(min(a, b), c), max(max(a, b), c));
-}
-`, [
-    AABB3_STRUCT.declaration_chunk,
-    MESHLET_METADATA_STRUCT.declaration_chunk,
-    chunk_meshlet_compute_attribute_section_offset,
-    chunk_read_meshlet_attribute_vec3f,
-    chunk_read_meshlet_resolved_index,
-]);
+import { AABB3_STRUCT } from "../aabb3/AABB3_STRUCT.js";
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+import { chunk_read_meshlet_triangle_positions } from "./chunk_read_meshlet_triangle_positions.js";
+
+/**
+ * The AABB of one triangle of a meshlet, from positions alone ({@link chunk_read_meshlet_triangle_positions}): a
+ * bounds pass runs over every triangle of a deformed mesh every frame, and decodes no other attribute.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_read_meshlet_triangle_bounds = CodeChunk.from(
+    //language=WGSL
+    `
+fn read_meshlet_triangle_bounds(
+    meshlet_id: u32,
+    triangle_id: u32
+) -> ${AABB3_STRUCT.wgsl_ref} {
+    let t = read_meshlet_triangle_positions(meshlet_id, triangle_id);
+
+    return ${AABB3_STRUCT.wgsl_ref}(min(min(t.a, t.b), t.c), max(max(t.a, t.b), t.c));
+}
+`, [
+    AABB3_STRUCT.declaration_chunk,
+    chunk_read_meshlet_triangle_positions,
+]);

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_positions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The three positions of one triangle of a meshlet, and nothing else.
+ *
+ * {@link chunk_read_meshlet_triangle_vertices} answers the same addressing question and then decodes
+ * every attribute a shaded hit needs — normal, tangent, two UV sets, colour. A pass that wants the
+ * shape alone (a triangle's bounds, its distance from a point) reads the three positions and stops.
+ * The index addressing, the attribute-section offset and the vertex clamp are the shared chunks either
+ * way, which is where a disagreement between the two would actually hurt: a shape that is not the
+ * triangle a ray query goes on to intersect.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_read_meshlet_triangle_positions: CodeChunk;
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_read_meshlet_triangle_positions.d.ts.map

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_read_meshlet_triangle_positions.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_positions.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,oDAFU,SAAS,CAkChB;0BAlDuB,gCAAgC"}

package/src/shade/renderer/shader/chunk/geometry/meshlet/chunk_read_meshlet_triangle_positions.js

@@ -0,0 +1,52 @@
+import { MESHLET_METADATA_STRUCT } from "../../../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+import { TRIANGLE_POSITIONS_STRUCT } from "../triangle/TRIANGLE_POSITIONS_STRUCT.js";
+import { chunk_meshlet_compute_attribute_section_offset } from "./chunk_meshlet_compute_attribute_section_offset.js";
+import { chunk_read_meshlet_attribute_vec3f } from "./chunk_read_meshlet_attribute_vec3f.js";
+import { chunk_read_meshlet_resolved_index } from "./chunk_read_meshlet_resolved_index.js";
+
+/**
+ * The three positions of one triangle of a meshlet, and nothing else.
+ *
+ * {@link chunk_read_meshlet_triangle_vertices} answers the same addressing question and then decodes
+ * every attribute a shaded hit needs — normal, tangent, two UV sets, colour. A pass that wants the
+ * shape alone (a triangle's bounds, its distance from a point) reads the three positions and stops.
+ * The index addressing, the attribute-section offset and the vertex clamp are the shared chunks either
+ * way, which is where a disagreement between the two would actually hurt: a shape that is not the
+ * triangle a ray query goes on to intersect.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_read_meshlet_triangle_positions = CodeChunk.from(
+    //language=WGSL
+    `
+fn read_meshlet_triangle_positions(
+    meshlet_id: u32,
+    triangle_id: u32
+) -> ${TRIANGLE_POSITIONS_STRUCT.wgsl_ref} {
+    let header = meshlet_metadata[meshlet_id];
+
+    let attribute_offset = meshlet_compute_attribute_section_offset(header);
+
+    let index_offset = triangle_id * 3u;
+
+    // position is the first attribute of the section, three floats per vertex
+    return ${TRIANGLE_POSITIONS_STRUCT.wgsl_ref}(
+        read_meshlet_attribute_vec3f(
+            attribute_offset + min(read_meshlet_resolved_index(header, index_offset), header.vertex_count - 1u) * 3u
+        ),
+        read_meshlet_attribute_vec3f(
+            attribute_offset + min(read_meshlet_resolved_index(header, index_offset + 1u), header.vertex_count - 1u) * 3u
+        ),
+        read_meshlet_attribute_vec3f(
+            attribute_offset + min(read_meshlet_resolved_index(header, index_offset + 2u), header.vertex_count - 1u) * 3u
+        ),
+    );
+}
+`, [
+    TRIANGLE_POSITIONS_STRUCT.declaration_chunk,
+    MESHLET_METADATA_STRUCT.declaration_chunk,
+    chunk_meshlet_compute_attribute_section_offset,
+    chunk_read_meshlet_attribute_vec3f,
+    chunk_read_meshlet_resolved_index,
+]);

package/src/shade/renderer/shader/chunk/geometry/triangle/TRIANGLE_POSITIONS_STRUCT.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A triangle's three corners, positions alone.
+ * @type {WebGPUStruct}
+ */
+export const TRIANGLE_POSITIONS_STRUCT: WebGPUStruct;
+import { WebGPUStruct } from "../../../type/WebGPUStruct.js";
+//# sourceMappingURL=TRIANGLE_POSITIONS_STRUCT.d.ts.map

package/src/shade/renderer/shader/chunk/geometry/triangle/TRIANGLE_POSITIONS_STRUCT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TRIANGLE_POSITIONS_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/geometry/triangle/TRIANGLE_POSITIONS_STRUCT.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wCAFU,YAAY,CAME;6BAVK,+BAA+B"}

package/src/shade/renderer/shader/chunk/geometry/triangle/TRIANGLE_POSITIONS_STRUCT.js

@@ -0,0 +1,12 @@
+import { vec3f } from "../../../type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../../type/WebGPUStruct.js";
+
+/**
+ * A triangle's three corners, positions alone.
+ * @type {WebGPUStruct}
+ */
+export const TRIANGLE_POSITIONS_STRUCT = WebGPUStruct.from({
+    a: vec3f,
+    b: vec3f,
+    c: vec3f,
+}, 'TrianglePositions');

package/src/shade/renderer/shader/chunk/grid/chunk_index_to_grid2d_reciprocal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `index_to_grid2d` without an integer division or remainder: the row from the index times the width's
+ * reciprocal, put right by the remainder where it is one off.
+ *
+ * ```wgsl
+ * fn index_to_grid2d_reciprocal(index: u32, width: u32, reciprocal: f32) -> vec2<u32>
+ * ```
+ *
+ * `reciprocal` is 1/width rounded to f32, as `Math.fround(1 / width)` makes it on the host. The product is then
+ * the same on every device, since WGSL rounds an f32 multiplication correctly, and within one of the row for every
+ * index below 2^24. It is one under at exact multiples where the reciprocal rounds down (41 in a row of 41) and
+ * one over near the top of the range (12,583,937 in a row of 3), and the remainder's sign and size say which.
+ *
+ * Integer division and remainder by a value the compiler cannot see are emulated on AMD's RDNA2, about 12 times
+ * a float operation (measured 2026-10-17). The probe clipmap's pick addresses a depth tile a corner this way: 7%
+ * off the pass on the RDNA2 iGPU and 5.6% on an RTX 4090, the image the same to the bit.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_index_to_grid2d_reciprocal: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_index_to_grid2d_reciprocal.d.ts.map

package/src/shade/renderer/shader/chunk/grid/chunk_index_to_grid2d_reciprocal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_index_to_grid2d_reciprocal.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/grid/chunk_index_to_grid2d_reciprocal.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,+CAFU,SAAS,CAiBhB;0BApCuB,6BAA6B"}

package/src/shade/renderer/shader/chunk/grid/chunk_index_to_grid2d_reciprocal.js

@@ -0,0 +1,37 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+
+/**
+ * `index_to_grid2d` without an integer division or remainder: the row from the index times the width's
+ * reciprocal, put right by the remainder where it is one off.
+ *
+ * ```wgsl
+ * fn index_to_grid2d_reciprocal(index: u32, width: u32, reciprocal: f32) -> vec2<u32>
+ * ```
+ *
+ * `reciprocal` is 1/width rounded to f32, as `Math.fround(1 / width)` makes it on the host. The product is then
+ * the same on every device, since WGSL rounds an f32 multiplication correctly, and within one of the row for every
+ * index below 2^24. It is one under at exact multiples where the reciprocal rounds down (41 in a row of 41) and
+ * one over near the top of the range (12,583,937 in a row of 3), and the remainder's sign and size say which.
+ *
+ * Integer division and remainder by a value the compiler cannot see are emulated on AMD's RDNA2, about 12 times
+ * a float operation (measured 2026-10-17). The probe clipmap's pick addresses a depth tile a corner this way: 7%
+ * off the pass on the RDNA2 iGPU and 5.6% on an RTX 4090, the image the same to the bit.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_index_to_grid2d_reciprocal = CodeChunk.from(
+    //language=WGSL
+    `
+fn index_to_grid2d_reciprocal(index: u32, width: u32, reciprocal: f32) -> vec2<u32> {
+    let estimate = u32(f32(index) * reciprocal);
+    let rest = i32(index) - i32(estimate * width);
+
+    let under = rest >= i32(width);
+    let over = rest < 0;
+
+    let x = rest - select(0, i32(width), under) + select(0, i32(width), over);
+    let y = estimate + select(0u, 1u, under) - select(0u, 1u, over);
+
+    return vec2<u32>(u32(x), y);
+}
+`);

package/src/shade/renderer/shader/chunk/light/lpv/depth/chunk_lpv_mask_weights_by_visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_lpv_mask_weights_by_visibility.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/depth/chunk_lpv_mask_weights_by_visibility.js"],"names":[],"mappings":"AAOA,6DAqGO;AAKP,sEA+EO;0BA7LmB,mCAAmC"}
+{"version":3,"file":"chunk_lpv_mask_weights_by_visibility.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/depth/chunk_lpv_mask_weights_by_visibility.js"],"names":[],"mappings":"AAQA,6DAkEO;AAKP,sEA+EO;0BA3JmB,mCAAmC"}