@woosh/meep-engine 3.56.0 → 3.58.0

package/src/shade/renderer/light/environment/octahedral_uv_to_direction.d.ts

@@ -1,8 +0,0 @@
-/**
- * @deprecated Renamed to {@link octahedral_z_pole_uv_to_direction}, because the name collided with
- * `core/geom/3d/octahedra/octahedral_uv_to_direction` — a different pole *and* a different signature.
- * This re-export is kept for backward compatibility (meep is a library; old names are public surface).
- */
-export const octahedral_uv_to_direction: typeof octahedral_z_pole_uv_to_direction;
-import { octahedral_z_pole_uv_to_direction } from "./octahedral_z_pole_uv_to_direction.js";
-//# sourceMappingURL=octahedral_uv_to_direction.d.ts.map

package/src/shade/renderer/light/environment/octahedral_uv_to_direction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"octahedral_uv_to_direction.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/octahedral_uv_to_direction.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,kFAA4E;kDAPrE,wCAAwC"}

package/src/shade/renderer/light/environment/octahedral_uv_to_direction.js

@@ -1,10 +0,0 @@
-import {
-    octahedral_z_pole_uv_to_direction
-} from "./octahedral_z_pole_uv_to_direction.js";
-
-/**
- * @deprecated Renamed to {@link octahedral_z_pole_uv_to_direction}, because the name collided with
- * `core/geom/3d/octahedra/octahedral_uv_to_direction` — a different pole *and* a different signature.
- * This re-export is kept for backward compatibility (meep is a library; old names are public surface).
- */
-export const octahedral_uv_to_direction = octahedral_z_pole_uv_to_direction;

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

@@ -1,62 +0,0 @@
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-
-/**
- * The free list as a fresh pool leaves it: every slot free, `dead[i] = i`, bottom to top.
- *
- * It is a stack of slot indices — the emit pass pops `dead[--DEAD]` — so the order within it is
- * arbitrary and identity is simply the cheapest arrangement to write. What matters is that every
- * slot appears exactly once: a repeat hands two particles one record, and a gap strands a slot for
- * the lifetime of the system.
- *
- * ## Why this is a pass and not a host write
- *
- * Zero is not a valid free list — `dead[i] = 0` for every `i` is the same slot half a million times
- * over — so the buffer WebGPU hands back has to be written before the first emit. Writing it from
- * the host means a typed array the size of the list (2 MiB at the default capacity), a loop over
- * every element of it, and a staged upload, all on the frame the system is constructed. Here it is
- * one store per slot with no host memory involved at all, and it leaves the free list `STORAGE`
- * only: nothing else ever writes it from the host, so it needs no `COPY_DST` and stays off the
- * driver's upload-friendly — and slower — path.
- *
- * ## Bounded launch, strided loop
- *
- * The pool capacity belongs to whoever constructs the system, and `capacity / workgroup_size` can
- * pass `maxComputeWorkgroupsPerDimension` — a validation error for a direct dispatch, and worse
- * than that for the indirect ones elsewhere in the engine, which simply do not run. So the caller
- * clamps the launch and every lane strides through the list by the whole grid: the fill covers any
- * capacity, and a grid that happens to cover it in one pass costs one comparison to find out.
- */
-
-/** Lanes per workgroup. One store each, so this is sized for occupancy and nothing else. */
-export const PARTICLE_INIT_FREE_LIST_WORKGROUP_SIZE = 256;
-
-const resources = new ShaderResourceSetDescriptor();
-
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer holding one u32
-resources.setImmediate("u_capacity", u32);
-resources.createGroup().addStorageBuffer("dead", WebGPUArray.u32, true);
-
-export const shader_particle_init_free_list = ComputeShader.from({
-    label: "Particle Init Free List",
-    resources,
-    body: CodeChunk.from(
-        /* language=wgsl */
-        `
-@compute @workgroup_size(${PARTICLE_INIT_FREE_LIST_WORKGROUP_SIZE}, 1, 1)
-fn main(
-    @builtin(global_invocation_id) global_id : vec3<u32>,
-    @builtin(num_workgroups) group_count : vec3<u32>,
-) {
-    // The grid may be smaller than the list; every lane keeps taking the next slot a whole grid on.
-    let stride = group_count.x * ${PARTICLE_INIT_FREE_LIST_WORKGROUP_SIZE}u;
-
-    for (var slot = global_id.x; slot < u_capacity; slot += stride) {
-        dead[slot] = slot;
-    }
-}
-`),
-});

package/src/shade/renderer/shadow/vsm/VSMMoverTracker.js

@@ -1,153 +0,0 @@
-import { assert } from "../../../../core/assert.js";
-import { GPU_DATABASE_NULL } from "../../buffer/table/GPU_DATABASE_NULL.js";
-import {
-    VSM_EMPTY_BOUND,
-    VSM_LAST_SEEN_GEOMETRY,
-    VSM_LAST_SEEN_MATERIAL,
-    VSM_LAST_SEEN_WORDS
-} from "./VSM_MOVER_LAYOUT.js";
-
-/**
- * The scene's memory of where its casters were and what they were: {@link VSM_LAST_SEEN_WORDS} per
- * row of the `meshes` table — the world box {@link shader_vsm_movers} saw each row with last frame,
- * and its geometry and material — empty for a row that held nothing. Comparing against it is how the
- * mover pass sees a row appear, leave, change shape or change mesh, which no per-row fact of the
- * scene database says.
- *
- * Covers every row the table has ever had — a high-water mark, so a page of rows that was freed
- * still gets compared once more and its casters' old shadows found. Grows by doubling; a grown
- * buffer starts empty and takes the old one's rows by a copy recorded in the next mover pass, in
- * order with the rest of the frame.
- */
-export class VSMMoverTracker {
-
-    /**
-     * @type {GPUDevice}
-     */
-    #device;
-
-    /**
-     * @type {GPUBuffer|null}
-     */
-    #buffer = null;
-
-    /**
-     * Rows {@link #buffer} covers.
-     * @type {number}
-     */
-    #rows = 0;
-
-    /**
-     * The buffer before the last growth, until the next pass has copied it over.
-     * @type {GPUBuffer|null}
-     */
-    #retired = null;
-
-    /**
-     * @param {GPUDevice} device
-     */
-    constructor(device) {
-        assert.defined(device, 'device');
-
-        this.#device = device;
-    }
-
-    /**
-     * @returns {GPUBuffer|null}
-     */
-    get buffer() {
-        return this.#buffer;
-    }
-
-    /**
-     * @returns {number} rows the buffer covers
-     */
-    get row_count() {
-        return this.#rows;
-    }
-
-    /**
-     * Cover at least `rows` rows.
-     *
-     * @param {number} rows
-     */
-    ensure(rows) {
-        assert.isNonNegativeInteger(rows, 'rows');
-
-        if (rows <= this.#rows) {
-            return;
-        }
-
-        const capacity = Math.max(rows, this.#rows * 2);
-
-        const buffer = this.#device.createBuffer({
-            label: 'VSM / casters last seen',
-            size: capacity * VSM_LAST_SEEN_WORDS * Uint32Array.BYTES_PER_ELEMENT,
-            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
-            mappedAtCreation: true,
-        });
-
-        const range = buffer.getMappedRange();
-        const floats = new Float32Array(range);
-        const words = new Uint32Array(range);
-
-        for (let i = 0; i < capacity; i++) {
-            const base = i * VSM_LAST_SEEN_WORDS;
-
-            floats[base] = VSM_EMPTY_BOUND;
-            floats[base + 1] = VSM_EMPTY_BOUND;
-            floats[base + 2] = VSM_EMPTY_BOUND;
-            floats[base + 3] = -VSM_EMPTY_BOUND;
-            floats[base + 4] = -VSM_EMPTY_BOUND;
-            floats[base + 5] = -VSM_EMPTY_BOUND;
-            words[base + VSM_LAST_SEEN_GEOMETRY] = GPU_DATABASE_NULL;
-            words[base + VSM_LAST_SEEN_MATERIAL] = GPU_DATABASE_NULL;
-        }
-
-        buffer.unmap();
-
-        if (this.#retired !== null) {
-            // grown twice before a pass ran: the older copy never landed, and the newer one holds
-            // nothing yet either — take the rows from the oldest
-            this.#buffer.destroy();
-        } else {
-            this.#retired = this.#buffer;
-        }
-
-        this.#buffer = buffer;
-        this.#rows = capacity;
-    }
-
-    /**
-     * Record the copy of the rows the buffer had before it grew, if it did since the last call, and
-     * let the old buffer go once the frame is done with it.
-     *
-     * @param {ShadeGPUCommandContext} encoder
-     */
-    encode_growth(encoder) {
-        const retired = this.#retired;
-
-        if (retired === null) {
-            return;
-        }
-
-        this.#retired = null;
-
-        encoder.copyBufferToBuffer(retired, 0, this.#buffer, 0, retired.size);
-        encoder.onFinished.addOne(() => retired.destroy());
-    }
-
-    destroy() {
-        if (this.#retired !== null) {
-            this.#retired.destroy();
-            this.#retired = null;
-        }
-
-        if (this.#buffer !== null) {
-            this.#buffer.destroy();
-            this.#buffer = null;
-        }
-
-        this.#rows = 0;
-    }
-}

package/src/shade/renderer/shadow/vsm/VSM_MOVER_LAYOUT.js

@@ -1,75 +0,0 @@
-import { FLOAT32_MAX } from "../../../../core/binary/FLOAT32_MAX.js";
-import { atomic_u32, u32, vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-
-/**
- * Movers a frame lists at most: casters whose bounds or transform changed since the last frame, each
- * with the world box it covers now and covered then. Past this many, every occupied page of every
- * virtual shadow map is taken to be stale for the frame, and the overflow is counted.
- *
- * @type {number}
- */
-export const VSM_MOVER_CAPACITY = 4096;
-
-/**
- * The scene's mover list, written by the mover passes and read by every map's stale pass.
- *
- * `count` is the atomic the movers appended with, so a count past {@link VSM_MOVER_CAPACITY} says the
- * list overflowed. `boxes` holds two vec4s per mover: the world box's min and max corners in `xyz`.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_STRUCT = WebGPUStruct.from({
-    count: atomic_u32,
-    pad_0: u32,
-    pad_1: u32,
-    pad_2: u32,
-    boxes: WebGPUArray.from(vec4f),
-}, "VSMMovers");
-
-/**
- * The same buffer as the stale pass reads it: the count as a plain word.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_READ_STRUCT = WebGPUStruct.from({
-    count: u32,
-    pad_0: u32,
-    pad_1: u32,
-    pad_2: u32,
-    boxes: WebGPUArray.from(vec4f),
-}, "VSMMoversRead");
-
-/**
- * Bytes of the mover list at {@link VSM_MOVER_CAPACITY}.
- *
- * @type {number}
- */
-export const VSM_MOVERS_BYTE_SIZE = 16 + VSM_MOVER_CAPACITY * 2 * 16;
-
-/**
- * What a world box holds when it holds nothing: min past max on every axis, so that `min` and `max`
- * against it return the other box unchanged. The largest finite f32, since WGSL will not fold an
- * infinity.
- *
- * @type {number}
- */
-export const VSM_EMPTY_BOUND = FLOAT32_MAX;
-
-/**
- * Words the mover pass remembers a `meshes` row by, from one frame to the next: the world box it saw
- * the row with — six f32s, by their bits, empty for a row that held nothing — then the row's
- * geometry and material, {@link GPU_DATABASE_NULL} for a row that held nothing.
- *
- * @type {number}
- */
-export const VSM_LAST_SEEN_WORDS = 8;
-
-/**
- * Where a row's geometry and material sit among its {@link VSM_LAST_SEEN_WORDS}.
- *
- * @type {number}
- */
-export const VSM_LAST_SEEN_GEOMETRY = 6;
-export const VSM_LAST_SEEN_MATERIAL = 7;

package/src/shade/renderer/shadow/vsm/shader/chunk_vsm_append_mover.js

@@ -1,32 +0,0 @@
-import {
-    chunk_subgroup_append_slot,
-    SUBGROUP_APPEND_NONE
-} from "../../../shader/chunk/subgroup/chunk_subgroup_append_slot.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-
-/**
- * Append a lane's mover to the scene's mover list — `movers`, a `VSMMovers` the including shader
- * binds read-write — through {@link chunk_subgroup_append_slot}: one atomic per subgroup, and the
- * mover's box written into the slot it was given.
- *
- * Every lane of the subgroup must call it, mover or not, from uniform control flow. Past `capacity`
- * the count still rises — that is how the stale pass knows the list overflowed — but nothing is
- * written.
- *
- * @type {CodeChunk}
- */
-export const chunk_vsm_append_mover = CodeChunk.from(
-    //language=WGSL
-    `
-fn vsm_append_mover(is_mover: bool, box_min: vec3f, box_max: vec3f, capacity: u32) {
-    let slot = subgroup_append_slot(&movers.count, is_mover, capacity);
-
-    if (slot != ${SUBGROUP_APPEND_NONE}u) {
-        movers.boxes[slot * 2u] = vec4f(box_min, 0.0);
-        movers.boxes[slot * 2u + 1u] = vec4f(box_max, 0.0);
-    }
-}
-`, [
-        chunk_subgroup_append_slot,
-    ]
-);

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_movers.js

@@ -1,184 +0,0 @@
-import { WebGPUExtensionType } from "../../../../descriptor/WebGPUExtensionType.js";
-import { chunk_scene_database_access, MESHES_TABLE } from "../../../scene/chunk_scene_database_access.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { GPU_DATABASE_NULL } from "../../../buffer/table/GPU_DATABASE_NULL.js";
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import {
-    VSM_EMPTY_BOUND,
-    VSM_LAST_SEEN_GEOMETRY,
-    VSM_LAST_SEEN_MATERIAL,
-    VSM_LAST_SEEN_WORDS,
-    VSM_MOVERS_STRUCT
-} from "../VSM_MOVER_LAYOUT.js";
-import { chunk_vsm_append_mover } from "./chunk_vsm_append_mover.js";
-
-export const VSM_MOVERS_WORKGROUP_SIZE = COMPUTE_SHADER_DEFAULT_GROUP_SIZE;
-
-/**
- * What the mover pass runs with: how many rows the "last seen" buffer covers, how many movers the
- * list holds, and the dispatch's shape — `group_count` workgroups folded into rows of `groups_x`,
- * since a table's pages can take more than one dimension of a dispatch holds.
- *
- * @type {WebGPUStruct}
- */
-export const VSM_MOVERS_SETTINGS_STRUCT = WebGPUStruct.from({
-    row_count: u32,
-    capacity: u32,
-    groups_x: u32,
-    group_count: u32,
-}, "VSMMoversSettings");
-
-const WG = VSM_MOVERS_WORKGROUP_SIZE;
-const PG = MESHES_TABLE.page_iterator_symbol_prefix(WG);
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate('settings', VSM_MOVERS_SETTINGS_STRUCT);
-
-resources.createGroup()
-    .addStorageBuffer('scene_database', WebGPUArray.from(u32), false)
-    // per mesh row, what the pass saw it as last frame: its world box by the bits of its floats,
-    // then its geometry and material — empty and NULL for a row that held nothing
-    .addStorageBuffer('last_seen', WebGPUArray.from(u32), true)
-    .addStorageBuffer('movers', VSM_MOVERS_STRUCT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-const EMPTY = ${VSM_EMPTY_BOUND};
-const NO_MESH = ${GPU_DATABASE_NULL}u;
-const WORDS = ${VSM_LAST_SEEN_WORDS}u;
-
-@compute @workgroup_size(${WG},1,1)
-fn main(
-    @builtin(workgroup_id) wg_id: vec3<u32>,
-    @builtin(local_invocation_index) local_id: u32,
-) {
-    // the dispatch's workgroups, folded into rows; the last row's tail past the count has nothing to
-    // walk, and leaves whole
-    let group_index = wg_id.x + wg_id.y * settings.groups_x;
-
-    if (group_index >= settings.group_count) {
-        return;
-    }
-
-    // the page iterator's own arithmetic, done here too: a page that has been freed is still walked,
-    // since the rows it held may have been casters a moment ago
-    let page_index = group_index / ${PG}_GROUPS_PER_PAGE;
-    let page_group = group_index % ${PG}_GROUPS_PER_PAGE;
-    let slot = page_group * ${WG}u + local_id;
-    let row = page_index * ${PG}_ELEMENTS_PER_PAGE + slot;
-
-    let tracked = slot < ${PG}_ELEMENTS_PER_PAGE && row < settings.row_count;
-
-    // the page address is uniform across the workgroup, so this is too
-    let allocated = ${PG}_setup(&scene_database, group_index, local_id);
-
-    var occupied = false;
-
-    if (allocated && slot < ${PG}_ELEMENTS_PER_PAGE) {
-        occupied = ${PG}_is_occupied(slot);
-    }
-
-    var now_min = vec3f(EMPTY);
-    var now_max = vec3f(-EMPTY);
-    var now_geometry = NO_MESH;
-    var now_material = NO_MESH;
-    var turned = false;
-
-    if (occupied) {
-        let mesh = ${PG}_read(&scene_database, slot);
-
-        now_geometry = mesh.geometry;
-        now_material = mesh.material;
-
-        now_min = vec3f(mesh.bounding_box[0], mesh.bounding_box[1], mesh.bounding_box[2]);
-        now_max = vec3f(mesh.bounding_box[3], mesh.bounding_box[4], mesh.bounding_box[5]);
-
-        // the hierarchy pass keeps last frame's world matrix beside this frame's: any change of the
-        // transform, including a turn that leaves the box where it was
-        let node = scene_read_node(&scene_database, mesh.node);
-
-        turned = any(node.global[0] != node.prev_global[0])
-            || any(node.global[1] != node.prev_global[1])
-            || any(node.global[2] != node.prev_global[2])
-            || any(node.global[3] != node.prev_global[3]);
-    }
-
-    var is_mover = false;
-    var box_min = now_min;
-    var box_max = now_max;
-
-    if (tracked) {
-        let base = row * WORDS;
-
-        let then_min = vec3f(
-            bitcast<f32>(last_seen[base]),
-            bitcast<f32>(last_seen[base + 1u]),
-            bitcast<f32>(last_seen[base + 2u]),
-        );
-        let then_max = vec3f(
-            bitcast<f32>(last_seen[base + 3u]),
-            bitcast<f32>(last_seen[base + 4u]),
-            bitcast<f32>(last_seen[base + 5u]),
-        );
-
-        // a row that appeared, left or changed shape has a box it did not have before; one given
-        // another mesh may keep its box, but not its geometry or material
-        let changed = any(now_min != then_min) || any(now_max != then_max)
-            || now_geometry != last_seen[base + ${VSM_LAST_SEEN_GEOMETRY}u]
-            || now_material != last_seen[base + ${VSM_LAST_SEEN_MATERIAL}u];
-
-        // where it is and where it was; an empty box is the identity of both
-        box_min = min(now_min, then_min);
-        box_max = max(now_max, then_max);
-
-        is_mover = (changed || turned) && all(box_min <= box_max);
-
-        last_seen[base] = bitcast<u32>(now_min.x);
-        last_seen[base + 1u] = bitcast<u32>(now_min.y);
-        last_seen[base + 2u] = bitcast<u32>(now_min.z);
-        last_seen[base + 3u] = bitcast<u32>(now_max.x);
-        last_seen[base + 4u] = bitcast<u32>(now_max.y);
-        last_seen[base + 5u] = bitcast<u32>(now_max.z);
-        last_seen[base + ${VSM_LAST_SEEN_GEOMETRY}u] = now_geometry;
-        last_seen[base + ${VSM_LAST_SEEN_MATERIAL}u] = now_material;
-    }
-
-    vsm_append_mover(is_mover, box_min, box_max, settings.capacity);
-}
-`, [
-    MESHES_TABLE.chunk_iterate(WG),
-    chunk_scene_database_access,
-    chunk_vsm_append_mover,
-]);
-
-body.addExtension(WebGPUExtensionType.Subgroups);
-
-/**
- * List the casters that moved since the last frame, for every virtual shadow map's stale pass.
- *
- * One thread per slot of the `meshes` table, freed pages included, against a buffer of what each
- * row was when the pass last saw it ({@link VSM_LAST_SEEN_WORDS}). A row moved when its world matrix
- * differs from the one the hierarchy pass kept from last frame, or when its world box, geometry or
- * material differs from the one the pass saw — which is also how a row that appeared or left shows.
- * A change to a material's parameters, the same material, is not seen. Nothing about a row is
- * declared; what changed is observed. A mover is listed with the union of its box now and then:
- * every page either one covers may hold its old shadow, or lack its new one.
- *
- * Dispatch with as many workgroups as the "last seen" buffer's rows need at
- * {@link VSM_MOVERS_WORKGROUP_SIZE} — the table's pages, times its groups per page — folded into rows
- * of at most a dispatch dimension's limit, and once per frame, before the stale passes.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_movers = ComputeShader.from({
-    label: "VSM/Movers",
-    body,
-    resources,
-});

package/src/shade/renderer/shadow/vsm/shader/shader_vsm_skinned_movers.js

@@ -1,109 +0,0 @@
-import { WebGPUExtensionType } from "../../../../descriptor/WebGPUExtensionType.js";
-import { SKINNING_BINDING_STRUCT } from "../../../animation/skinning/SKINNING_BINDING_STRUCT.js";
-import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { mat4x4f, u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { VSM_MOVERS_STRUCT } from "../VSM_MOVER_LAYOUT.js";
-import { chunk_vsm_append_mover } from "./chunk_vsm_append_mover.js";
-
-export const VSM_SKINNED_MOVERS_WORKGROUP_SIZE = 64;
-
-/**
- * @type {WebGPUStruct}
- */
-export const VSM_SKINNED_MOVERS_SETTINGS_STRUCT = WebGPUStruct.from({
-    binding_count: u32,
-    capacity: u32,
-}, "VSMSkinnedMoversSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate('settings', VSM_SKINNED_MOVERS_SETTINGS_STRUCT);
-
-resources.createGroup()
-    .addStorageBuffer('scene_database', WebGPUArray.from(u32), false)
-    .addStorageBuffer('bindings', WebGPUArray.from(SKINNING_BINDING_STRUCT), false)
-    .addStorageBuffer('skin_matrices', WebGPUArray.from(mat4x4f), false)
-    .addStorageBuffer('prev_skin_matrices', WebGPUArray.from(mat4x4f), false)
-    .addStorageBuffer('movers', VSM_MOVERS_STRUCT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-const LANES = ${VSM_SKINNED_MOVERS_WORKGROUP_SIZE}u;
-
-// set by the first lane to find a joint that moved: that lane alone lists the mesh
-var<workgroup> claimed: atomic<u32>;
-
-fn vsm_matrix_differs(a: mat4x4f, b: mat4x4f) -> bool {
-    return any(a[0] != b[0]) || any(a[1] != b[1]) || any(a[2] != b[2]) || any(a[3] != b[3]);
-}
-
-@compute @workgroup_size(${VSM_SKINNED_MOVERS_WORKGROUP_SIZE},1,1)
-fn main(
-    @builtin(workgroup_id) workgroup_id: vec3<u32>,
-    @builtin(local_invocation_index) lane: u32,
-) {
-    let index = workgroup_id.x;
-
-    // the whole workgroup's binding, so the whole workgroup leaves
-    if (index >= settings.binding_count) {
-        return;
-    }
-
-    let binding = bindings[index];
-
-    // a lane's joints, a workgroup's width apart: as many as the skin has, over the lanes
-    var moved = false;
-
-    for (var j = lane; j < binding.skin_matrix_count; j += LANES) {
-        let row = binding.skin_matrix_offset + j;
-
-        moved = moved || vsm_matrix_differs(skin_matrices[row], prev_skin_matrices[row]);
-    }
-
-    let first = moved && atomicExchange(&claimed, 1u) == 0u;
-
-    var box_min = vec3f(0.0);
-    var box_max = vec3f(0.0);
-
-    if (first) {
-        let mesh = scene_read_mesh(&scene_database, binding.mesh_instance_index);
-
-        box_min = vec3f(mesh.bounding_box[0], mesh.bounding_box[1], mesh.bounding_box[2]);
-        box_max = vec3f(mesh.bounding_box[3], mesh.bounding_box[4], mesh.bounding_box[5]);
-    }
-
-    vsm_append_mover(first && all(box_min <= box_max), box_min, box_max, settings.capacity);
-}
-`, [
-    SKINNING_BINDING_STRUCT.declaration_chunk,
-    chunk_scene_database_access,
-    chunk_vsm_append_mover,
-]);
-
-body.addExtension(WebGPUExtensionType.Subgroups);
-
-/**
- * List every skinned mesh whose pose changed since last frame: a joint's skin matrix differs from
- * the one the animation manager kept from the frame before. A pose can change inside bounds that
- * stay put — an arm swinging inside the box its feet and head set — which neither the row's
- * transform nor its box would show; a skin held still is no mover.
- *
- * The mesh's box is this frame's, after the bounds refresh: a pose that changed it is also caught by
- * {@link shader_vsm_movers}, with where the mesh was.
- *
- * One workgroup per skinning binding, its lanes over the skin's joints, after
- * {@link shader_vsm_movers} into the same list.
- *
- * @type {ComputeShader}
- */
-export const shader_vsm_skinned_movers = ComputeShader.from({
-    label: "VSM/SkinnedMovers",
-    body,
-    resources,
-});