@woosh/meep-engine 3.49.0 → 3.50.0

package/src/shade/renderer/shader/resource/ShaderResourceGroupDescriptor.js

@@ -2,13 +2,6 @@ import { assert } from "../../../../core/assert.js";
 import { objectKeyByValue } from "../../../../core/model/object/objectKeyByValue.js";
 import { string_compute_similarity } from "../../../../core/primitives/strings/string_compute_similarity.js";
 import { BindGroupLayoutDescriptor } from "../../../descriptor/binding/BindGroupLayoutDescriptor.js";
-import { BufferBindingLayout } from "../../../descriptor/binding/BufferBindingLayout.js";
-import { SamplerBindingLayout } from "../../../descriptor/binding/SamplerBindingLayout.js";
-import { StorageTextureBindingLayout } from "../../../descriptor/binding/StorageTextureBindingLayout.js";
-import { TextureBindingLayout } from "../../../descriptor/binding/TextureBindingLayout.js";
-import { parse_wgsl_type } from "../type/parse_wgsl_type.js";
-import { write_gpu_typed_buffer } from "../type/serde/write_gpu_typed_buffer.js";
-import { type_has_atomics } from "../type/type_has_atomics.js";
 import { ResourceType } from "./ResourceType.js";
 import { RX_VALID_NAME } from "./RX_VALID_NAME.js";
 import { ShaderResourceDescriptor } from "./ShaderResourceDescriptor.js";
@@ -83,6 +76,14 @@ export class ShaderResourceGroupDescriptor {
                 // binding is not present, check defaults
                 binding_value = resource.default_value;
 
+                if (binding_value === undefined && resource.transient_default) {
+                    // not an assert: binding by hand, there is nothing to fall back to
+                    throw new Error(
+                        `Storage buffer '${resource.name}' has a transient default, which only a frame graph pass`
+                        + ` can bind; generateBindings needs a buffer for it`
+                    );
+                }
+
                 if (binding_value === undefined) {
 
                     // format inputs for error
@@ -359,33 +360,19 @@ export class ShaderResourceGroupDescriptor {
     }
 
     /**
+     * Place `declaration` in this group, at the first free binding index. The group holds a copy, so
+     * the one declaration, exported beside the data it describes, can be placed in any number of groups.
      *
-     * @param {string} name
-     * @param {WebGPUType|string} type
-     * @returns {ShaderResourceDescriptor}
+     * @param {ShaderResourceDescriptor} declaration see {@link ShaderResourceDescriptor.uniform} and its siblings
+     * @returns {this}
      */
-    #createBuffer(name, type) {
-        assert.isString(name, 'name');
-        assert.defined(type, 'type');
-
-        const resource = new ShaderResourceDescriptor();
-
-        resource.name = name;
-        resource.type = ResourceType.Buffer;
+    add(declaration) {
+        assert.defined(declaration, 'declaration');
+        assert.equal(declaration.isShaderResourceDescriptor, true, 'declaration.isShaderResourceDescriptor !== true');
 
-        let _type = type;
+        this.#add(declaration.clone_declaration());
 
-        if (typeof type === "string") {
-            _type = parse_wgsl_type(type);
-        } else {
-
-            assert.equal(type.isWebGPUType, true, 'type.isWebGPUType !== true');
-
-        }
-
-        resource.buffer_type = _type;
-
-        return resource;
+        return this;
     }
 
     /**
@@ -396,38 +383,7 @@ export class ShaderResourceGroupDescriptor {
      * @returns {this}
      */
     addUniform(name, _type, default_value = undefined) {
-        assert.isString(name, 'name');
-
-        let type = _type;
-        if (typeof type === "string") {
-            type = parse_wgsl_type(type);
-        } else {
-            assert.equal(type.isWebGPUType, true, 'type.isWebGPUType !== true');
-        }
-
-        if (type.runtime_sized) {
-            // TODO check if this is true, I don't remember exact details from the spec
-            throw new Error(`Uniforms can not use runtime sized structures. Size must be defined ahead of time. name='${name}', type=${type}`);
-        }
-
-        // https://www.w3.org/TR/WGSL/#atomic-type
-        assert.equal(type_has_atomics(type), false, 'atomics are not allowed in uniforms');
-
-        const resource = this.#createBuffer(name, type);
-
-        resource.member_descriptor = BufferBindingLayout.uniform;
-
-        if (default_value !== undefined) {
-
-            const buffer = new ArrayBuffer(type.size);
-
-            write_gpu_typed_buffer(default_value, resource.buffer_type, buffer, 0);
-
-            resource.default_value = buffer;
-
-        }
-
-        this.#add(resource);
+        this.#add(ShaderResourceDescriptor.uniform(name, _type, default_value));
 
         return this;
     }
@@ -437,25 +393,17 @@ export class ShaderResourceGroupDescriptor {
      * @param {string} name
      * @param {WebGPUType} type
      * @param {boolean} [write_enabled]
+     * @param {boolean} [transient_default] when a frame graph pass is given nothing for this binding, it binds
+     *        a transient buffer of the type's minimum binding size in its place. The buffer comes from the
+     *        frame's pool, so its contents are whatever it last held: declare this only for a binding some
+     *        variants of the shader do not read, such as one shader switch value's resource in a union of
+     *        every value's bindings. A pass that binds by hand ({@link generateBindings}) gets no default.
      * @returns {this}
      */
-    addStorageBuffer(name, type, write_enabled = false) {
-        assert.defined(type, 'type');
-        assert.isBoolean(write_enabled, 'write_enabled');
-        assert.isObject(type, 'type');
-        assert.equal(type.isWebGPUType, true, 'type.isWebGPUType !== true');
-
-        // https://www.w3.org/TR/WGSL/#atomic-type
-        assert.equal(type_has_atomics(type) && !write_enabled, false, 'atomics are only allowed in write-access mode');
-
-        const resource = this.#createBuffer(name, type);
-
-        resource.member_descriptor = write_enabled ? BufferBindingLayout.storage : BufferBindingLayout.readOnlyStorage;
-
-        this.#add(resource);
+    addStorageBuffer(name, type, write_enabled = false, transient_default = false) {
+        this.#add(ShaderResourceDescriptor.storageBuffer(name, type, write_enabled, transient_default));
 
         return this;
-
     }
 
     /**
@@ -474,41 +422,7 @@ export class ShaderResourceGroupDescriptor {
         multisampled = false,
         default_value = undefined,
     ) {
-        assert.isString(name, 'name');
-        assert.isOneOf(type, [
-            "unfilterable-float",
-            "float",
-            "sint",
-            "uint",
-            "depth"
-        ], 'type');
-
-        assert.isOneOf(dimension, [
-            "1d",
-            "2d",
-            "2d-array",
-            "cube",
-            "cube-array",
-            "3d"
-        ], "dimension");
-
-        const resource = new ShaderResourceDescriptor();
-
-        resource.name = name;
-        resource.type = ResourceType.Texture;
-        resource.member_descriptor = TextureBindingLayout.fromJSON({
-            sampleType: type,
-            viewDimension: dimension,
-            multisampled
-        });
-
-        if (default_value !== undefined) {
-            assert.equal(default_value.isShadeTexture, true, 'default_value.isShadeTexture !== true');
-
-            resource.default_value = default_value;
-        }
-
-        this.#add(resource);
+        this.#add(ShaderResourceDescriptor.texture(name, type, dimension, multisampled, default_value));
 
         return this;
     }
@@ -527,21 +441,7 @@ export class ShaderResourceGroupDescriptor {
         dimension,
         access
     ) {
-
-        assert.isString(name, 'name');
-
-        const resource = new ShaderResourceDescriptor();
-
-        resource.name = name;
-        resource.type = ResourceType.StorageTexture;
-
-        resource.member_descriptor = StorageTextureBindingLayout.fromJSON({
-            format,
-            access,
-            viewDimension: dimension
-        });
-
-        this.#add(resource);
+        this.#add(ShaderResourceDescriptor.storageTexture(name, format, dimension, access));
 
         return this;
     }
@@ -554,29 +454,7 @@ export class ShaderResourceGroupDescriptor {
      * @returns {ShaderResourceGroupDescriptor}
      */
     addSampler(name, type = "filtering", default_value = undefined) {
-        assert.isString(name, 'name');
-        assert.isOneOf(type, ["filtering", "non-filtering", "comparison"])
-
-
-        const resource = new ShaderResourceDescriptor();
-
-        resource.name = name;
-        resource.type = ResourceType.Sampler;
-
-        resource.member_descriptor = SamplerBindingLayout.fromJSON({
-            type
-        });
-
-        if (default_value !== undefined) {
-            assert.isObject(default_value, 'default_value');
-            assert.equal(default_value.isSamplerDescriptor, true, 'default_value.isSamplerDescriptor !== true');
-
-            // TODO validate that type matches
-
-            resource.default_value = default_value;
-        }
-
-        this.#add(resource);
+        this.#add(ShaderResourceDescriptor.sampler(name, type, default_value));
 
         return this;
     }

package/src/shade/renderer/shader/resource/encoder_prepare_shader_bindings_defaults.d.ts

@@ -1,6 +1,11 @@
 /**
  * Given a set of bindings (the target), fill out the rest with defaults where applicable
  * Make sure that you run this at the end, once all the other bindings have been assigned
+ *
+ * A storage buffer declared with a transient default gets a transient buffer of its type's minimum
+ * binding size from the frame's pool, contents undefined; see
+ * {@link ShaderResourceGroupDescriptor#addStorageBuffer}.
+ *
  * @param {Object} target
  * @param {GraphicsExecutionContext} context
  * @param {ShaderResourceSetDescriptor} resources

package/src/shade/renderer/shader/resource/encoder_prepare_shader_bindings_defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoder_prepare_shader_bindings_defaults.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/encoder_prepare_shader_bindings_defaults.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,uJA0BC"}
+{"version":3,"file":"encoder_prepare_shader_bindings_defaults.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/encoder_prepare_shader_bindings_defaults.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,uJA+BC"}

package/src/shade/renderer/shader/resource/encoder_prepare_shader_bindings_defaults.js

@@ -3,6 +3,11 @@ import { encoder_prepare_shader_binding } from "./encoder_prepare_shader_binding
 /**
  * Given a set of bindings (the target), fill out the rest with defaults where applicable
  * Make sure that you run this at the end, once all the other bindings have been assigned
+ *
+ * A storage buffer declared with a transient default gets a transient buffer of its type's minimum
+ * binding size from the frame's pool, contents undefined; see
+ * {@link ShaderResourceGroupDescriptor#addStorageBuffer}.
+ *
  * @param {Object} target
  * @param {GraphicsExecutionContext} context
  * @param {ShaderResourceSetDescriptor} resources
@@ -30,7 +35,12 @@ export function encoder_prepare_shader_bindings_defaults(target, context, resour
                 const binding = encoder_prepare_shader_binding(context, resource.default_value, resource);
 
                 target[resource_name] = binding;
+            } else if (resource.transient_default) {
+                target[resource_name] = context.encoder.allocateTransientBuffer(
+                    GPUBufferUsage.STORAGE,
+                    resource.buffer_type.aligned_size
+                );
             }
         }
     }
-}
+}

package/src/shade/renderer/shadow/map/SHADOWMAP_RESOURCES.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The shadow map atlas the lights' shadow maps are drawn into.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SHADOWMAP_ATLAS_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The comparison sampler the atlas is filtered through.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SHADOWMAP_COMPARE_SAMPLER_RESOURCE: ShaderResourceDescriptor;
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+//# sourceMappingURL=SHADOWMAP_RESOURCES.d.ts.map

package/src/shade/renderer/shadow/map/SHADOWMAP_RESOURCES.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SHADOWMAP_RESOURCES.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/SHADOWMAP_RESOURCES.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,uCAFU,wBAAwB,CAEkE;AAEpG;;;GAGG;AACH,iDAFU,wBAAwB,CAEuH;yCAbhH,mDAAmD"}

package/src/shade/renderer/shadow/map/SHADOWMAP_RESOURCES.js

@@ -0,0 +1,14 @@
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+import { SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR } from "./SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR.js";
+
+/**
+ * The shadow map atlas the lights' shadow maps are drawn into.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SHADOWMAP_ATLAS_RESOURCE = ShaderResourceDescriptor.texture("shadowmapAtlas", "depth");
+
+/**
+ * The comparison sampler the atlas is filtered through.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SHADOWMAP_COMPARE_SAMPLER_RESOURCE = ShaderResourceDescriptor.sampler("sCompareLinear", "comparison", SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR);

package/src/shade/renderer/shadow/map/shader/chunk_sample_shadowmap_atlas_for_light.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sample_shadowmap_atlas_for_light.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_sample_shadowmap_atlas_for_light.js"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,qDAFU,SAAS,CAyFjB;0BAzGwB,uCAAuC"}
+{"version":3,"file":"chunk_sample_shadowmap_atlas_for_light.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_sample_shadowmap_atlas_for_light.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,qDAFU,SAAS,CAyFjB;0BA1GwB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_sample_shadowmap_atlas_for_light.js

@@ -5,6 +5,7 @@ import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { SHADOWMAP_FILTER_SIZE } from "../SHADOWMAP_FILTER_SIZE.js";
 import { chunk_get_shadow_offsets } from "./chunk_get_shadow_offsets.js";
 import { chunk_shadowmap_sample_5 } from "./chunk_shadowmap_sample_5.js";
+import { SHADOWMAP_ATLAS_RESOURCE } from "../SHADOWMAP_RESOURCES.js";
 
 /**
  * Samples the shadow atlas for a given light, using the supplied shadow projection matrix and
@@ -107,3 +108,5 @@ fn sample_shadowmap_atlas_with_texel(
         chunk_m4_projection_size,
     ]
 );
+
+chunk_sample_shadowmap_atlas_for_light.requireResource(SHADOWMAP_ATLAS_RESOURCE);

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_shadowmap_sample_filtered.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,8CAFU,SAAS,CAmBlB;AAED;;;;GAIG;AACH,iDAFU,SAAS,CA0BlB;0BAtDyB,uCAAuC"}
+{"version":3,"file":"chunk_shadowmap_sample_filtered.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,8CAFU,SAAS,CAmBlB;AAKD;;;;GAIG;AACH,iDAFU,SAAS,CA0BlB;0BA1DyB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js

@@ -1,5 +1,6 @@
 import { chunk_interpolate_bilinear_f32 } from "../../../shader/chunk/texture/sample/chunk_interpolate_bilinear_f32.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { SHADOWMAP_ATLAS_RESOURCE, SHADOWMAP_COMPARE_SAMPLER_RESOURCE } from "../SHADOWMAP_RESOURCES.js";
 
 /**
  * see {@link SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR}
@@ -24,6 +25,9 @@ fn shadowmap_sample_filtered(
     `
 )
 
+chunk_shadowmap_sample_filtered.requireResource(SHADOWMAP_COMPARE_SAMPLER_RESOURCE);
+chunk_shadowmap_sample_filtered.requireResource(SHADOWMAP_ATLAS_RESOURCE);
+
 /**
  * WebGPU requires uniform flow for `textureSampleCompare`, which is a major limitation. `textureGatherCompare` does not have such limitation, so we use it instead.
  * see {@link SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR}
@@ -53,4 +57,7 @@ fn shadowmap_sample_filtered(
     `, [
         chunk_interpolate_bilinear_f32,
     ]
-)
+)
+
+chunk_shadowmap_sample_filtered_v2.requireResource(SHADOWMAP_COMPARE_SAMPLER_RESOURCE);
+chunk_shadowmap_sample_filtered_v2.requireResource(SHADOWMAP_ATLAS_RESOURCE);

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAFU,SAAS,CAqGjB;0BA/HwB,uCAAuC"}
+{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAFU,SAAS,CAqGjB;0BAhIwB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js

@@ -11,6 +11,7 @@ import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { chunk_get_shadow_offsets } from "./chunk_get_shadow_offsets.js";
 import { chunk_contact_harden_pcf_kernel } from "./dpcf/chunk_contact_harden_pcf_kernel.js";
 import { chunk_max_penumbra_percentage } from "./dpcf/chunk_max_penumbra_percentage.js";
+import { SHADOWMAP_ATLAS_RESOURCE } from "../SHADOWMAP_RESOURCES.js";
 
 const SHADOW_POINT_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_point');
 
@@ -135,3 +136,5 @@ fn shadowmap_sample_point(
         chunk_random_vec2,
     ]
 );
+
+chunk_shadowmap_sample_point2.requireResource(SHADOWMAP_ATLAS_RESOURCE);

package/src/shade/renderer/shadow/ray/shader_screens_space_shadows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_screens_space_shadows.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_screens_space_shadows.js"],"names":[],"mappings":"AA6LA,uDAWG;4BAtKyB,6BAA6B"}
+{"version":3,"file":"shader_screens_space_shadows.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_screens_space_shadows.js"],"names":[],"mappings":"AAgMA,uDAWG;4BAzKyB,6BAA6B"}

package/src/shade/renderer/shadow/ray/shader_screens_space_shadows.js

@@ -36,6 +36,7 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { SCREEN_HZB_RESOURCE } from "../../shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
@@ -48,6 +49,8 @@ resources.createGroup()
     .addTexture("tNormal", "uint")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
     .addUniform("view", VIEW_UNIFORM_STRUCT)
+    // what chunk_ffx_sssr_load_depth reads above mip 0
+    .add(SCREEN_HZB_RESOURCE)
 ;
 
 const body = CodeChunk.from(

package/src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_geometry_sdf_query_distance.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js"],"names":[],"mappings":"AAaA,0DAmCO;AAGP;;;;GAIG;AACH,gDAFU,SAAS,CAkBjB;0BA9DwB,oCAAoC"}
+{"version":3,"file":"chunk_geometry_sdf_query_distance.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js"],"names":[],"mappings":"AAaA,0DAmCO;AAGP;;;;GAIG;AACH,gDAFU,SAAS,CAkBjB;0BA/DwB,oCAAoC"}

package/src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js

@@ -1,4 +1,3 @@
-import { chunk_sdf_slot_index_to_texture_offset } from "../../geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js";
 import { chunk_aabb3_distance_to_ray_v2 } from "../../shader/chunk/geometry/aabb3/chunk_aabb3_distance_to_ray_v2.js";
 import {
     chunk_aabb3_nearest_point_on_surface
@@ -9,6 +8,7 @@ import {
     chunk_sdf_texture_region_sample_linear_uv
 } from "../../shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { chunk_tile_atlas_slot_origin } from "../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 
 
 export const chunk_geometry_sdf_query_distance = CodeChunk.from(
@@ -34,14 +34,14 @@ fn geometry_sdf_query_distance( geometry_id:u32, position_local: vec3<f32>) -> f
         
         sdf_uv = clamped;
         
-        let offset = sdf_slot_index_to_texture_offset(geometry_id, settings.sdf_atlas_resolution) * settings.sdf_tile_resolution;
+        let offset = tile_atlas_slot_origin(geometry_id, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
         let geometry_distance = sdf_texture_region_sample_linear_uv(texture_sdf,  offset,  vec3(settings.sdf_tile_resolution), sdf_uv);
                 
         return geometry_distance + sign_not_zero(geometry_distance) * length(geometry_bounds_span * uv_distance_to_box);
 }
 `, [
         chunk_array_to_aabb3,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         chunk_sdf_texture_region_sample_linear_uv,
         chunk_aabb3_nearest_point_on_surface,
         chunk_aabb3_distance_to_ray_v2,

package/src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sdf_geometry_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js"],"names":[],"mappings":"AAYA,oDAwEE;0BA1EwB,oCAAoC"}
+{"version":3,"file":"chunk_sdf_geometry_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js"],"names":[],"mappings":"AAYA,oDAwEE;0BA3EwB,oCAAoC"}

package/src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js

@@ -1,4 +1,3 @@
-import { chunk_sdf_slot_index_to_texture_offset } from "../../geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js";
 import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
 import { chunk_mat4_compose_transform } from "../../shader/chunk/geometry/mat4/chunk_mat4_compose_transform.js";
 import { MAT4_IDENTITY_DEFINITION } from "../../shader/chunk/geometry/mat4/MAT4_IDENTITY_DEFINITION.js";
@@ -9,6 +8,7 @@ import { chunk_min_v3 } from "../../shader/chunk/geometry/vec3/chunk_min_v3.js";
 import { chunk_v3_matrix4_project } from "../../shader/chunk/geometry/vec3/chunk_v3_matrix4_project.js";
 import { chunk_sdf_texture_raycast } from "../../shader/chunk/sdf/chunk_sdf_texture_raycast.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { chunk_tile_atlas_slot_origin } from "../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 
 export const chunk_sdf_geometry_raymarch = CodeChunk.from(
     //language=WGSL
@@ -27,7 +27,7 @@ fn sdf_geometry_raymarch(ray:${RAY_STRUCT.wgsl_ref}, geometry_index: u32) -> vec
     
     var sdf_ray = ray_transform_m4(ray, sdf_transform_inverse);
     
-    let offset = sdf_slot_index_to_texture_offset(geometry_index, settings.sdf_atlas_resolution) * settings.sdf_tile_resolution;
+    let offset = tile_atlas_slot_origin(geometry_index, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
         
     const tolerance = 0.001;
         
@@ -74,7 +74,7 @@ fn sdf_geometry_raymarch(ray:${RAY_STRUCT.wgsl_ref}, geometry_index: u32) -> vec
         MAT4_IDENTITY_DEFINITION,
         RAY_HIT_INFO.declaration_chunk,
         RAY_STRUCT.declaration_chunk,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         chunk_sdf_texture_raycast,
         chunk_mat4_compose_transform,
         chunk_array_to_aabb3,

package/src/shade/renderer/shadow/vsm/VSMPageManager.d.ts

@@ -12,7 +12,8 @@
  * world units on a side, anchored to the world in light space. Each level keeps a window of
  * `pages_per_level²` pages around the camera ({@link update_windows}), and a page of the window sits
  * in cell `(x mod N, y mod N)` of the level — so a window that scrolls keeps every page still inside
- * it where it was, and gives back only the pages it left behind.
+ * it where it was, and gives back only the pages it left behind. The windows are a 2-D
+ * {@link ClipmapWindowSet}, and what a scroll leaves behind is {@link window_scroll_regions}'.
  *
  * **The pool** is a {@link VTPhysicalSlots}: VT's slot grid, least-recently-touched eviction outside
  * a protection window, and the finest page shed first on a tie.
@@ -138,7 +139,8 @@ export class VSMPageManager {
      */
     page_world_size(level: number): number;
     /**
-     * The page-table row, from the map's first, of a world page's cell.
+     * The page-table row, from the map's first, of a world page's cell: the window set's
+     * {@link ClipmapWindowSet#storage_cell}, with the window's power-of-two side taken as a mask.
      *
      * @param {number} level
      * @param {number} x world page
@@ -160,7 +162,7 @@ export class VSMPageManager {
      * @param {number} level
      * @param {number} x
      * @param {number} y
-     * @returns {boolean}
+     * @returns {boolean} whether the level's window is placed and holds the world page
      */
     window_contains(level: number, x: number, y: number): boolean;
     /**

package/src/shade/renderer/shadow/vsm/VSMPageManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VSMPageManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/vsm/VSMPageManager.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"VSMPageManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/vsm/VSMPageManager.js"],"names":[],"mappings":"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"}