@woosh/meep-engine 3.14.5 → 3.15.0

package/src/shade/renderer/particles/sort/shader_particle_sort.js

@@ -4,6 +4,7 @@ import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { PREFIX_SCAN_CSDLDF_HEADER_WORDS } from "../../gpu_primitive/prefix_sum/v1/shader_prefix_scan_csdldf.js";
 import { PARTICLE_RECORD_HEADER_EMITTER, PARTICLE_RECORD_WORD_COUNT } from "../ParticleConstants.js";
 import { EMITTER_ATTRIBUTE_ABSENT } from "../data/PARTICLE_EMITTER_LAYOUT.js";
 import { chunk_particle_emitter } from "../data/chunk_particle_emitter.js";
@@ -11,10 +12,11 @@ import { chunk_particle_emitter } from "../data/chunk_particle_emitter.js";
 /**
  * Depth-sort shaders. Three passes bracket a `csdldf` prefix scan:
  *
- * 0. {@link shader_particle_sort_reset} — every frame, write the histogram's `{count}` field
- *    (= bucket count, which the csdldf scan reads to size itself) and zero the histogram bins and
- *    the scatter cursor. Without this the scan consumes garbage counts and the scatter compounds
- *    last frame's ranks — the buffers are only zeroed by WebGPU on CREATION, not per frame.
+ * 0. {@link shader_particle_sort_reset} — every frame, write the histogram's `{count, elements}`
+ *    header (the bucket count the csdldf scan sizes itself from), clear the header padding and the
+ *    bins, and zero the scatter cursor. Without this the scan consumes garbage counts and the
+ *    scatter compounds last frame's ranks — the buffers are only zeroed by WebGPU on CREATION, not
+ *    per frame.
  * 1. {@link shader_particle_sort_histogram} — per alive particle, project its render position into
  *    view space, quantise the depth into a back-to-front bucket (far first), store the bucket in
  *    `keys`, and atomically bump the per-bucket `histogram`.
@@ -23,11 +25,33 @@ import { chunk_particle_emitter } from "../data/chunk_particle_emitter.js";
  *    offset from the scanned histogram and an atomic per-bucket rank, and write the particle's slot
  *    into `sorted` at that position.
  *
+ * ## The buffer the four passes share
+ *
+ * The histogram IS the scan's `{count: u32, elements: array<vec4u>}`, bound flat here as
+ * `array<atomic<u32>>` because these passes need atomics on it. `elements` is `@align(16)`, so bin
+ * `b` is word {@link PREFIX_SCAN_CSDLDF_HEADER_WORDS}` + b` and words 1..3 are padding the scan
+ * never reads. Every pass below steps over that header by hand; the reset clears whole vec4s of
+ * bins, because whole vec4s is what the scan loads.
+ *
+ * ## This is the render order
+ *
+ * The camera-dependent back-to-front list the billboard draw consumes. `../coherence/` produces the
+ * simulation order from the same three-phase shape — different buffers, different passes, different
+ * counter slots (`PARTICLE_COUNTER.SORTED` against `PARTICLE_COUNTER.SIM_PADDED`), on purpose.
+ *
  * The `csdldf` scan uses subgroup ops and isn't runnable under the emulator; the reset, histogram
  * and scatter passes are, and the CPU reference {@link ./particle_counting_sort.js} pins the
  * algorithm.
  */
 
+/** @type {number} words of `{count, elements}` header in front of the scan's bins */
+const HEADER = PREFIX_SCAN_CSDLDF_HEADER_WORDS;
+
+/** The header stride every pass in this file interpolates. */
+const COMMON = /* wgsl */ `
+const SORT_HEADER_WORDS : u32 = ${HEADER}u;
+`;
+
 export const PARTICLE_SORT_WORKGROUP_SIZE = 64;
 
 // --- reset pass ---
@@ -48,20 +72,42 @@ reset_resources.createGroup()
     .addStorageBuffer("histogram", WebGPUArray.from(atomic_u32), true)
     .addStorageBuffer("cursor", WebGPUArray.from(atomic_u32), true);
 const reset_body = CodeChunk.from(/* wgsl */ `
+${COMMON}
+
 @compute @workgroup_size(${PARTICLE_SORT_WORKGROUP_SIZE}, 1, 1)
 fn main(@builtin(global_invocation_id) gid : vec3<u32>) {
     let i = gid.x;
+
     if (i == 0u) {
         // The {count, elements} header the csdldf scan sizes itself from.
         atomicStore(&histogram[0], settings.u_bucket_count);
     }
+
+    // Header padding: never read by the scan, but it shares the buffer and the pool may have left
+    // something in it.
+    if (i > 0u && i < SORT_HEADER_WORDS) {
+        atomicStore(&histogram[i], 0u);
+    }
+
+    // The scan reads whole vec4s, so the bins are cleared up to the vec4 the last one lands in.
+    if (i < ((settings.u_bucket_count + 3u) & 0xfffffffcu)) {
+        atomicStore(&histogram[SORT_HEADER_WORDS + i], 0u);
+    }
+
     if (i < settings.u_bucket_count) {
-        atomicStore(&histogram[1u + i], 0u);
         atomicStore(&cursor[i], 0u);
     }
 }
 `);
 
+/**
+ * Dispatch this over `PREFIX_SCAN_CSDLDF_HEADER_WORDS + round_up_4(bucket_count)` threads, not over
+ * `bucket_count`: its widest loop is the scan header plus the bins rounded up to the whole vec4 the
+ * last bin lands in. Under-dispatching leaves the tail of that vec4 holding last frame's counts,
+ * and the scan adds them in.
+ *
+ * @type {ComputeShader}
+ */
 export const shader_particle_sort_reset = ComputeShader.from({
     label: "Particle Sort Reset",
     resources: reset_resources,
@@ -105,6 +151,7 @@ histogram_resources.createGroup()
     .addStorageBuffer("keys", WebGPUArray.u32, true)
     .addStorageBuffer("histogram", WebGPUArray.from(atomic_u32), true);
 const histogram_body = CodeChunk.from(/* wgsl */ `
+${COMMON}
 const PARTICLE_RECORD_WORDS : u32 = ${PARTICLE_RECORD_WORD_COUNT}u;
 const PARTICLE_HEADER_EMITTER : u32 = ${PARTICLE_RECORD_HEADER_EMITTER}u;
 const PARTICLE_ATTRIBUTE_ABSENT : u32 = ${EMITTER_ATTRIBUTE_ABSENT}u;
@@ -135,7 +182,7 @@ fn main(@builtin(global_invocation_id) gid : vec3<u32>) {
     let bucket = min(u32(clamped * f32(settings.u_bucket_count)), settings.u_bucket_count - 1u);
 
     keys[i] = bucket;
-    atomicAdd(&histogram[1u + bucket], 1u);
+    atomicAdd(&histogram[SORT_HEADER_WORDS + bucket], 1u);
 }
 `, [chunk_particle_emitter]);
 
@@ -166,15 +213,19 @@ scatter_resources.createGroup()
     .addStorageBuffer("cursor", WebGPUArray.from(atomic_u32), true)
     .addStorageBuffer("sorted", WebGPUArray.u32, true);
 const scatter_body = CodeChunk.from(/* wgsl */ `
+${COMMON}
+
 @compute @workgroup_size(${PARTICLE_SORT_WORKGROUP_SIZE}, 1, 1)
 fn main(@builtin(global_invocation_id) gid : vec3<u32>) {
     let i = gid.x;
     if (i >= settings.u_count) { return; }
 
     let bucket = keys[i];
-    // Exclusive offset = inclusive prefix sum up to bucket-1. With the count field at index 0 the
-    // scanned inclusive value for bucket b lives at index (1+b), so bucket b-1 is at index b.
-    let exclusive = select(0u, scanned[bucket], bucket > 0u);
+
+    // The scan is inclusive, so bucket b's exclusive offset is bucket b-1's inclusive value, one
+    // word earlier. For bucket 0 the index lands on the last header word — in bounds, and unused,
+    // because select() takes the 0 branch there.
+    let exclusive = select(0u, scanned[SORT_HEADER_WORDS + bucket - 1u], bucket > 0u);
     let rank = atomicAdd(&cursor[bucket], 1u);
     sorted[exclusive + rank] = alive[i];
 }

package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.d.ts

@@ -37,6 +37,15 @@ export class AccumulatingPathTracer {
      * @type {boolean}
      */
     clear_history: boolean;
+    /**
+     * Samples accumulated by the tile that has had the fewest — the floor on how converged the
+     * image is anywhere. Zero right after a reset or before the first frame. A page presenting the
+     * traced image as a reference reads this to say how settled it is, rather than guessing from
+     * frames elapsed (a frame advances one tile, not the whole image).
+     *
+     * @returns {number}
+     */
+    get min_sample_count(): number;
     /**
      * Render one tile worth of new samples and blend it into the accumulation buffer.
      *

package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccumulatingPathTracer.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH;IA8EI;;;OAGG;IACH,uCAgBC;IAhGD;;;;OAIG;IACH,kBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,wBAFU,MAAM,CAEc;IAE9B;;;;OAIG;IACH,eAFU,OAAO,CAEK;IA+NtB;;;;;;OAMG;IACH,yCAFa,MAAM,CAyJlB;;CACJ"}
+{"version":3,"file":"AccumulatingPathTracer.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH;IA8EI;;;OAGG;IACH,uCAgBC;IAhGD;;;;OAIG;IACH,kBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,wBAFU,MAAM,CAEc;IAE9B;;;;OAIG;IACH,eAFU,OAAO,CAEK;IA+NtB;;;;;;;OAOG;IACH,+BAgBC;IAED;;;;;;OAMG;IACH,yCAFa,MAAM,CAyJlB;;CACJ"}

package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.js

@@ -269,6 +269,32 @@ export class AccumulatingPathTracer {
         }
     }
 
+    /**
+     * Samples accumulated by the tile that has had the fewest — the floor on how converged the
+     * image is anywhere. Zero right after a reset or before the first frame. A page presenting the
+     * traced image as a reference reads this to say how settled it is, rather than guessing from
+     * frames elapsed (a frame advances one tile, not the whole image).
+     *
+     * @returns {number}
+     */
+    get min_sample_count() {
+        const counts = this.#tile_sample_counts;
+
+        if (counts.length === 0) {
+            return 0;
+        }
+
+        let min = counts[0];
+
+        for (let i = 1; i < counts.length; i++) {
+            if (counts[i] < min) {
+                min = counts[i];
+            }
+        }
+
+        return min;
+    }
+
     /**
      * Render one tile worth of new samples and blend it into the accumulation buffer.
      *

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

@@ -10,9 +10,14 @@
  * @param {number[]} resolution
  * @param {string} [label] used for debug
  * @param {GPUSceneContext} scene
+ * @returns {{meshlets: number, draw_commands: number, meshlet_collection: number, meshlet_iterator_command: number}}
+ *   resource IDs: the material-sorted meshlet array the draws consume, one indirect draw command per
+ *   material, the HZB-filtered collection with its count header, and the dispatch command over it
  */
 export function graph_prepare_meshlet_draw_commands_by_material({ graph, materials, bucket_id, limits, buckets, hzb, camera, scene, resolution, label, }: FrameGraph): {
-    meshlets: any;
-    draw_commands: any;
+    meshlets: number;
+    draw_commands: number;
+    meshlet_collection: number;
+    meshlet_iterator_command: number;
 };
 //# sourceMappingURL=prepare_meshlet_draw_commands_by_material.d.ts.map

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;;;;;;;;;;;;GAYG;AACH;;;EA2SC"}
+{"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;cAJwB,MAAM;mBAAiB,MAAM;wBAAsB,MAAM;8BAA4B,MAAM;EAuTlH"}

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

@@ -37,6 +37,9 @@ import { shader_sort_meshlets_by_material } from "./shader_sort_meshlets_by_mate
  * @param {number[]} resolution
  * @param {string} [label] used for debug
  * @param {GPUSceneContext} scene
+ * @returns {{meshlets: number, draw_commands: number, meshlet_collection: number, meshlet_iterator_command: number}}
+ *   resource IDs: the material-sorted meshlet array the draws consume, one indirect draw command per
+ *   material, the HZB-filtered collection with its count header, and the dispatch command over it
  */
 export function graph_prepare_meshlet_draw_commands_by_material({
                                                                     graph,
@@ -335,6 +338,14 @@ export function graph_prepare_meshlet_draw_commands_by_material({
 
     return {
         meshlets: sort_meshlets_by_material_data.output,
-        draw_commands: draw_commands_data.commands
+        draw_commands: draw_commands_data.commands,
+        /*
+         The HZB-filtered collection *before* material sorting — the one with a `count` header — and
+         the indirect dispatch command that iterates it. The sorted buffer above is a bare array whose
+         extent only the draw commands know, so a pass that wants one thread per surviving meshlet
+         (the AVBOIT occupancy prepass) takes these two instead.
+        */
+        meshlet_collection: meshlets,
+        meshlet_iterator_command,
     }
 }

package/src/shade/renderer/rasterize/expand/shader_filter_triangle_by_material_side.js

@@ -15,7 +15,7 @@ import { ComputeShader } from "../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { GEOMETRY_METADATA_STRUCT } from "../../geometry/GEOMETRY_METADATA_STRUCT.js";
 import { MESH_TRIANGLE_REFERENCE_STRUCT } from "../../geometry/meshlet/MESH_TRIANGLE_REFERENCE_STRUCT.js";
-import { chunk_material_side_should_draw } from "../native/oit/chunk_material_side_should_draw.js";
+import { chunk_material_side_should_draw } from "../forward/chunk_material_side_should_draw.js";
 
 const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()

package/src/shade/renderer/rasterize/forward/FORWARD_VERTEX_SHADER_STRUCT.d.ts

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

package/src/shade/renderer/rasterize/forward/FORWARD_VERTEX_SHADER_STRUCT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FORWARD_VERTEX_SHADER_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/FORWARD_VERTEX_SHADER_STRUCT.js"],"names":[],"mappings":"AAKA,wDAOE;6BAX2B,mCAAmC"}

package/src/shade/renderer/rasterize/{native/oit → forward}/FORWARD_VERTEX_SHADER_STRUCT.js

@@ -1,7 +1,7 @@
-import { vec2f, vec3f, vec4f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { WGSLAttribute } from "../../../shader/type/WGSLAttribute.js";
-import { WGSLStructField } from "../../../shader/type/WGSLStructField.js";
+import { vec2f, vec3f, vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { WGSLAttribute } from "../../shader/type/WGSLAttribute.js";
+import { WGSLStructField } from "../../shader/type/WGSLStructField.js";
 
 export const FORWARD_VERTEX_SHADER_STRUCT = WebGPUStruct.fromFields(
     WGSLStructField.from('position', vec4f, WGSLAttribute.from('builtin', 'position')),

package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.d.ts

@@ -0,0 +1,3 @@
+export const SHADING_SCENE_RESOURCE_GROUP: ShaderResourceGroupDescriptor;
+import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
+//# sourceMappingURL=SHADING_SCENE_RESOURCE_GROUP.d.ts.map

package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SHADING_SCENE_RESOURCE_GROUP.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.js"],"names":[],"mappings":"AAQA,yEAAgF;8CANlC,wDAAwD"}

package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.js

@@ -0,0 +1,17 @@
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
+import { GEOMETRY_ATTRIBUTE_DATA_TYPE } from "../../geometry/GEOMETRY_ATTRIBUTE_DATA_TYPE.js";
+import { GEOMETRY_METADATA_STRUCT } from "../../geometry/GEOMETRY_METADATA_STRUCT.js";
+import { MESHLET_DEFINITION_STRUCT } from "../../geometry/meshlet/encoding/MESHLET_DEFINITION_STRUCT.js";
+import { MESHLET_METADATA_STRUCT } from "../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
+
+export const SHADING_SCENE_RESOURCE_GROUP = new ShaderResourceGroupDescriptor();
+
+SHADING_SCENE_RESOURCE_GROUP
+    .addStorageBuffer("meshlets", WebGPUArray.from(MESHLET_DEFINITION_STRUCT))
+    .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT))
+    .addStorageBuffer("meshlet_data", GEOMETRY_ATTRIBUTE_DATA_TYPE)
+    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
+    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_brick4.d.ts

@@ -1,3 +1,3 @@
 export const chunk_forward_shade_standard_fragment_brick4: CodeChunk;
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_forward_shade_standard_fragment_brick4.d.ts.map

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_forward_shade_standard_fragment_brick4.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js"],"names":[],"mappings":"AA4BA,qEAwJC;0BA3JyB,oCAAoC"}

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_brick4.js

@@ -1,29 +1,29 @@
-import { chunk_shade_standard_material_direct } from "../../../deferred/chunk_shade_standard_material_direct.js";
-import { chunk_decode_tangent_normal } from "../../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
-import { INDIRECT_LIGHT_INTENSITY } from "../../../deferred/INDIRECT_LIGHT_INTENSITY.js";
+import { chunk_shade_standard_material_direct } from "../../deferred/chunk_shade_standard_material_direct.js";
+import { chunk_decode_tangent_normal } from "../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
+import { INDIRECT_LIGHT_INTENSITY } from "../../deferred/INDIRECT_LIGHT_INTENSITY.js";
 import {
     chunk_brick4_sample_forward_indirect
-} from "../../../global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.js";
-import { BSDF_ROUGHNESS_MINIMUM } from "../../../light/environment/DEFINES.js";
-import { chunk_compute_specular_occlusion } from "../../../shader/chunk/brdf/chunk_compute_specular_occlusion.js";
-import { chunk_F_Hauber } from "../../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
-import { chunk_get_view_space_depth } from "../../../shader/chunk/depth/chunk_get_view_space_depth.js";
-import { chunk_mat4_extract_position } from "../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+} from "../../global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.js";
+import { BSDF_ROUGHNESS_MINIMUM } from "../../light/environment/DEFINES.js";
+import { chunk_compute_specular_occlusion } from "../../shader/chunk/brdf/chunk_compute_specular_occlusion.js";
+import { chunk_F_Hauber } from "../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
+import { chunk_get_view_space_depth } from "../../shader/chunk/depth/chunk_get_view_space_depth.js";
+import { chunk_mat4_extract_position } from "../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import {
     chunk_anti_alias_roughness_kaplanyan
-} from "../../../shader/chunk/geometry/normal/chunk_anti_alias_roughness_kaplanyan.js";
+} from "../../shader/chunk/geometry/normal/chunk_anti_alias_roughness_kaplanyan.js";
 import {
     chunk_build_orthonormal_matrix_nt
-} from "../../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_nt.js";
+} from "../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_nt.js";
 import {
     chunk_compute_indirect_specular
-} from "../../../shader/chunk/material/chunk_compute_indirect_specular.js";
+} from "../../shader/chunk/material/chunk_compute_indirect_specular.js";
 import {
     chunk_dielectric_specular_color
-} from "../../../shader/chunk/material/chunk_dielectric_specular_color.js";
-import { GEOMETRIC_SHADING_INFO_STRUCT } from "../../../shader/chunk/material/GEOMETRIC_SHADING_INFO_STRUCT.js";
-import { MATERIAL_SHADING_INFO_STRUCT } from "../../../shader/chunk/material/MATERIAL_SHADING_INFO_STRUCT.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+} from "../../shader/chunk/material/chunk_dielectric_specular_color.js";
+import { GEOMETRIC_SHADING_INFO_STRUCT } from "../../shader/chunk/material/GEOMETRIC_SHADING_INFO_STRUCT.js";
+import { MATERIAL_SHADING_INFO_STRUCT } from "../../shader/chunk/material/MATERIAL_SHADING_INFO_STRUCT.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { FORWARD_VERTEX_SHADER_STRUCT } from "./FORWARD_VERTEX_SHADER_STRUCT.js";
 
 export const chunk_forward_shade_standard_fragment_brick4 = CodeChunk.from(

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_ibl.d.ts

@@ -3,5 +3,5 @@
  * Uses environment map sampling for indirect lighting instead of Brick4 probes.
  */
 export const chunk_forward_shade_standard_fragment_ibl: CodeChunk;
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_forward_shade_standard_fragment_ibl.d.ts.map

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_forward_shade_standard_fragment_ibl.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,kEA6IC;0BApJyB,oCAAoC"}

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_ibl.js

@@ -1,28 +1,28 @@
-import { chunk_shade_standard_material_direct } from "../../../deferred/chunk_shade_standard_material_direct.js";
-import { chunk_decode_tangent_normal } from "../../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
-import { chunk_get_ibl_irradiance } from "../../../deferred/indirect/chunk_get_ibl_irradiance.js";
-import { chunk_get_ibl_radiance } from "../../../deferred/indirect/chunk_get_ibl_radiance.js";
-import { INDIRECT_LIGHT_INTENSITY } from "../../../deferred/INDIRECT_LIGHT_INTENSITY.js";
-import { BSDF_ROUGHNESS_MINIMUM } from "../../../light/environment/DEFINES.js";
-import { chunk_compute_specular_occlusion } from "../../../shader/chunk/brdf/chunk_compute_specular_occlusion.js";
-import { chunk_F_Hauber } from "../../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
-import { chunk_get_view_space_depth } from "../../../shader/chunk/depth/chunk_get_view_space_depth.js";
-import { chunk_mat4_extract_position } from "../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+import { chunk_shade_standard_material_direct } from "../../deferred/chunk_shade_standard_material_direct.js";
+import { chunk_decode_tangent_normal } from "../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
+import { chunk_get_ibl_irradiance } from "../../deferred/indirect/chunk_get_ibl_irradiance.js";
+import { chunk_get_ibl_radiance } from "../../deferred/indirect/chunk_get_ibl_radiance.js";
+import { INDIRECT_LIGHT_INTENSITY } from "../../deferred/INDIRECT_LIGHT_INTENSITY.js";
+import { BSDF_ROUGHNESS_MINIMUM } from "../../light/environment/DEFINES.js";
+import { chunk_compute_specular_occlusion } from "../../shader/chunk/brdf/chunk_compute_specular_occlusion.js";
+import { chunk_F_Hauber } from "../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
+import { chunk_get_view_space_depth } from "../../shader/chunk/depth/chunk_get_view_space_depth.js";
+import { chunk_mat4_extract_position } from "../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import {
     chunk_anti_alias_roughness_kaplanyan
-} from "../../../shader/chunk/geometry/normal/chunk_anti_alias_roughness_kaplanyan.js";
+} from "../../shader/chunk/geometry/normal/chunk_anti_alias_roughness_kaplanyan.js";
 import {
     chunk_build_orthonormal_matrix_nt
-} from "../../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_nt.js";
+} from "../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_nt.js";
 import {
     chunk_compute_indirect_specular
-} from "../../../shader/chunk/material/chunk_compute_indirect_specular.js";
+} from "../../shader/chunk/material/chunk_compute_indirect_specular.js";
 import {
     chunk_dielectric_specular_color
-} from "../../../shader/chunk/material/chunk_dielectric_specular_color.js";
-import { GEOMETRIC_SHADING_INFO_STRUCT } from "../../../shader/chunk/material/GEOMETRIC_SHADING_INFO_STRUCT.js";
-import { MATERIAL_SHADING_INFO_STRUCT } from "../../../shader/chunk/material/MATERIAL_SHADING_INFO_STRUCT.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+} from "../../shader/chunk/material/chunk_dielectric_specular_color.js";
+import { GEOMETRIC_SHADING_INFO_STRUCT } from "../../shader/chunk/material/GEOMETRIC_SHADING_INFO_STRUCT.js";
+import { MATERIAL_SHADING_INFO_STRUCT } from "../../shader/chunk/material/MATERIAL_SHADING_INFO_STRUCT.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { FORWARD_VERTEX_SHADER_STRUCT } from "./FORWARD_VERTEX_SHADER_STRUCT.js";
 
 /**

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_material_side_should_draw.d.ts

@@ -4,5 +4,5 @@
  * @type {CodeChunk}
  */
 export const chunk_material_side_should_draw: CodeChunk;
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_material_side_should_draw.d.ts.map

package/src/shade/renderer/rasterize/forward/chunk_material_side_should_draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_material_side_should_draw.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_material_side_should_draw.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,8CAFU,SAAS,CAmBlB;0BAxByB,oCAAoC"}

package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_material_side_should_draw.js

@@ -1,5 +1,5 @@
-import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { ShadeDrawSide } from "../../material/ShadeDrawSide.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 
 /**
  * NOTE: draw_side is a {@link ShadeDrawSide} enum value, not a bitmask.

package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.d.ts

@@ -0,0 +1,3 @@
+export const vertex_shader_chunk: CodeChunk;
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=vertex_shader_chunk.d.ts.map

package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex_shader_chunk.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/vertex_shader_chunk.js"],"names":[],"mappings":"AAUA,4CAoDE;0BAvDwB,oCAAoC"}

package/src/shade/renderer/rasterize/{native/oit → forward}/vertex_shader_chunk.js

@@ -1,11 +1,11 @@
-import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.js";
+import { chunk_scene_database_access } from "../../scene/chunk_scene_database_access.js";
 import {
     chunk_compute_normal_matrix_from_m4
-} from "../../../shader/chunk/geometry/mat4/chunk_compute_normal_matrix_from_m4.js";
+} from "../../shader/chunk/geometry/mat4/chunk_compute_normal_matrix_from_m4.js";
 import {
     chunk_read_meshlet_vertex_by_draw_index
-} from "../../../shader/chunk/geometry/meshlet/chunk_read_meshlet_vertex_by_draw_index.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+} from "../../shader/chunk/geometry/meshlet/chunk_read_meshlet_vertex_by_draw_index.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { FORWARD_VERTEX_SHADER_STRUCT } from "./FORWARD_VERTEX_SHADER_STRUCT.js";
 
 export const vertex_shader_chunk = CodeChunk.from(

package/src/shade/renderer/rasterize/native/avboit/AVBOITSettings.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Per-renderer settings of the AVBOIT transparency mode, held on `Renderer.avboit` the way the
+ * other sub-systems hold theirs (`dof`, `nss`, `path_tracer`). Read every frame by the orchestrator
+ * and carried into the warp header, so the splat and the draw see the same value for one frame.
+ *
+ * The compile-time tunables (slice counts, downscale, curve, bias) stay in `AVBOIT_CONSTANTS.js`;
+ * what lives here is the one thing that changes what a material *means*, which has to be a
+ * runtime decision the page can flip.
+ */
+export class AVBOITSettings {
+    /**
+     * Filter the light a transmissive surface lets through by its base colour, per channel, with
+     * `transmission_factor` as the weight — glTF's transmission semantics, where a red base colour
+     * on `transmission = 1` is red glass.
+     *
+     * Off by default because it is not what the rest of the engine does: the material model has no
+     * transmission colour today, the forward shader and the path tracer treat transmitted light as
+     * untinted, and the contract promises that flipping `transparency_mode` does not change what an
+     * asset looks like. On, the RGB extinction path does what the deck built it for; off, a
+     * transmissive surface lands where MBOIT and the tracer put it, and the per-channel plumbing
+     * costs nothing while it waits for a real transmission colour on the material.
+     *
+     * @type {boolean}
+     */
+    transmission_tint_from_base_color: boolean;
+}
+//# sourceMappingURL=AVBOITSettings.d.ts.map

package/src/shade/renderer/rasterize/native/avboit/AVBOITSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AVBOITSettings.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/avboit/AVBOITSettings.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH;IAEI;;;;;;;;;;;;;OAaG;IACH,mCAFU,OAAO,CAEyB;CAC7C"}

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

@@ -0,0 +1,27 @@
+/**
+ * Per-renderer settings of the AVBOIT transparency mode, held on `Renderer.avboit` the way the
+ * other sub-systems hold theirs (`dof`, `nss`, `path_tracer`). Read every frame by the orchestrator
+ * and carried into the warp header, so the splat and the draw see the same value for one frame.
+ *
+ * The compile-time tunables (slice counts, downscale, curve, bias) stay in `AVBOIT_CONSTANTS.js`;
+ * what lives here is the one thing that changes what a material *means*, which has to be a
+ * runtime decision the page can flip.
+ */
+export class AVBOITSettings {
+
+    /**
+     * Filter the light a transmissive surface lets through by its base colour, per channel, with
+     * `transmission_factor` as the weight — glTF's transmission semantics, where a red base colour
+     * on `transmission = 1` is red glass.
+     *
+     * Off by default because it is not what the rest of the engine does: the material model has no
+     * transmission colour today, the forward shader and the path tracer treat transmitted light as
+     * untinted, and the contract promises that flipping `transparency_mode` does not change what an
+     * asset looks like. On, the RGB extinction path does what the deck built it for; off, a
+     * transmissive surface lands where MBOIT and the tracer put it, and the per-channel plumbing
+     * costs nothing while it waits for a real transmission colour on the material.
+     *
+     * @type {boolean}
+     */
+    transmission_tint_from_base_color = false;
+}