@woosh/meep-engine 3.61.1 → 3.61.3

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_capture.js

@@ -1,301 +0,0 @@
-import { INDIRECT_MATERIAL_ARRAY_TYPE } from "../../../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
-import {
-    RESIDENT_MATERIAL_TEXTURE_LEVEL_COUNT,
-    RESIDENT_MATERIAL_TEXTURE_RESOLUTION
-} from "../../../material/resident/RESIDENT_MATERIAL_TEXTURE_LAYOUT.js";
-import { chunk_sample_material_alpha, chunk_sample_material_data } from "../../../path_tracer/shader/chunk_sample_material_data.js";
-import { INDIRECT_TEXTURE_FILTER } from "../../../path_tracer/shader/INDIRECT_TEXTURE_FILTER.js";
-import { IndirectTextureFilter } from "../../../path_tracer/shader/IndirectTextureFilter.js";
-import { BVH_TRAVERSAL_STACK_SIZE } from "../../../shader/chunk/bvh/BVH_TRAVERSAL_STACK_SIZE.js";
-import { chunk_geometry_read_triangle_vertices } from "../../../shader/chunk/geometry/format/chunk_geometry_read_triangle_vertices.js";
-import { MAT4_IDENTITY_DEFINITION } from "../../../shader/chunk/geometry/mat4/MAT4_IDENTITY_DEFINITION.js";
-import { chunk_ray_query_blas_nearest } from "../../../shader/chunk/geometry/ray/chunk_ray_query_blas_nearest.js";
-import { RAY_STRUCT } from "../../../shader/chunk/geometry/ray/RAY_STRUCT.js";
-import { chunk_index_to_grid2d } from "../../../shader/chunk/grid/chunk_index_to_grid2d.js";
-import { chunk_random } from "../../../shader/chunk/random/chunk_random.js";
-import { chunk_random_initialize } from "../../../shader/chunk/random/chunk_random_initialize.js";
-import { TRIANGLE_VERTICES_STRUCT } from "../../../shader/chunk/geometry/triangle/TRIANGLE_VERTICES_STRUCT.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ShaderSwitchSet } from "../../../shader/compiler/ShaderSwitchSet.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { u32, vec4u } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { mesh_sdf_add_blas_resources } from "../bake/shader_mesh_sdf_classify.js";
-import { MESH_SDF_BAKE_WORKGROUP_SIZE } from "../bake/MESH_SDF_BAKE.js";
-import { MESH_SDF_HEADERS_RESOURCE, MESH_SDF_INDIRECTION_RESOURCE } from "../MESH_SDF_RESOURCES.js";
-import { chunk_mesh_cards } from "./chunk_mesh_cards.js";
-import { MESH_CARD_SET_STRUCT } from "./MESH_CARD_SET_STRUCT.js";
-
-/**
- * Transparent hits a capture ray steps past, at most, before the texel is empty.
- * @type {number}
- */
-export const MESH_CARD_ALPHA_CONTINUATIONS = 4;
-
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_CAPTURE_SETTINGS = WebGPUStruct.from({
-    /** runs in `mesh_card_runs`, a stretch of one card set's pages each */
-    run_count: u32,
-    /** texels over every run: the threads that do work */
-    thread_count: u32,
-    /** workgroups along x, the rest folded into y */
-    groups_x: u32,
-}, "MeshCardsCaptureSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate("settings", MESH_CARDS_CAPTURE_SETTINGS);
-
-resources.createGroup()
-    .add(MESH_SDF_HEADERS_RESOURCE)
-    .add(MESH_SDF_INDIRECTION_RESOURCE)
-    .addStorageBuffer("mesh_card_sets", WebGPUArray.from(MESH_CARD_SET_STRUCT))
-    // (first thread, card set, first page, 0)
-    .addStorageBuffer("mesh_card_runs", WebGPUArray.from(vec4u))
-    .addStorageTexture("mesh_card_albedo", "rgba8unorm", "2d", "write-only")
-    .addStorageTexture("mesh_card_emissive", "rgba8unorm", "2d", "write-only");
-
-resources.createGroup({ label: "materials" })
-    .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
-    .addTexture("textures", "unfilterable-float", "2d-array", false);
-
-mesh_sdf_add_blas_resources(resources.createGroup());
-
-/**
- * Card capture (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.5): a thread a texel of each page captured
- * this frame, the frame's pages being stretches of card sets, a run each in `mesh_card_runs`.
- *
- * 1. A ray in the geometry's local space starts on the card's near face, at the texel — the corner
- *    lattice of the bricks' faces, as a brick's texels sit on its voxels — and runs along the card's
- *    direction through its slab, t ≤ the slab's depth, by `ray_query_blas_nearest`.
- * 2. A hit is opaque with probability its opacity (`sample_material_alpha`), as the path tracer takes
- *    alpha. A transparent draw steps the ray past the hit, MESH_CARD_ALPHA_CONTINUATIONS times at
- *    most; past that the texel is empty.
- * 3. At the opaque hit, `sample_material_data` with the material's resident row and an identity
- *    transform, the card being in local space.
- *
- * Both read the material's textures at the texel's footprint (`mesh_card_texture_level`), filtered
- * exactly ({@link IndirectTextureFilter.Exact}): nothing averages a card texel after it is stored, so a
- * single tap would be kept as the texel, and a tap landing on a thin feature of the texture would put
- * it in one row of texels and not the next.
- *
- * The random state is seeded from the card set and the texel, which fixes every draw: the alpha's and
- * the material's dither. A recapture of an unchanged material therefore writes the same bytes.
- *
- * The albedo plane holds √(albedo × (1 − metalness)), Lumen's diffuse colour as UE stores it, and
- * the hit's depth through the slab mapped onto [1/255, 1]. The emissive plane holds emissive / s_e.
- * A texel whose ray found nothing stores 0 throughout.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_capture = ComputeShader.from({
-    label: "Mesh Cards Capture",
-    resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-// The texture level a card texel reads a triangle's material at: its footprint, the card's texel steps
-// carried along the card's direction onto the triangle's plane and through the triangle's uv per
-// position, in texels of a slot's level 0. For a step s, direction d and normal n that is
-// s - d (n·s)/(n·d) on the plane, taken here times n·d, so a triangle turning edge-on, whose footprint
-// grows without bound, reaches the last level with nothing divided by 0, as a raster's would.
-fn mesh_card_texture_level(
-    triangle: ${TRIANGLE_VERTICES_STRUCT.wgsl_ref},
-    along: vec3<f32>,
-    step_u: vec3<f32>,
-    step_v: vec3<f32>,
-) -> f32 {
-    let edge_1 = triangle.b.position - triangle.a.position;
-    let edge_2 = triangle.c.position - triangle.a.position;
-    let normal = cross(edge_1, edge_2);
-
-    // an offset in the plane is a·edge_1 + b·edge_2, a and b its dots with these
-    let dual_1 = cross(edge_2, normal) / dot(normal, normal);
-    let dual_2 = cross(normal, edge_1) / dot(normal, normal);
-
-    let uv_1 = triangle.b.uv - triangle.a.uv;
-    let uv_2 = triangle.c.uv - triangle.a.uv;
-
-    let facing = dot(normal, along);
-
-    let on_plane_u = facing * step_u - along * dot(normal, step_u);
-    let on_plane_v = facing * step_v - along * dot(normal, step_v);
-
-    let uv_step_u = dot(on_plane_u, dual_1) * uv_1 + dot(on_plane_u, dual_2) * uv_2;
-    let uv_step_v = dot(on_plane_v, dual_1) * uv_1 + dot(on_plane_v, dual_2) * uv_2;
-
-    let span = ${RESIDENT_MATERIAL_TEXTURE_RESOLUTION}.0 * max(length(uv_step_u), length(uv_step_v));
-    let reach = abs(facing);
-
-    // a footprint of a slot or more, edge-on included, is the last level
-    return select(
-        ${RESIDENT_MATERIAL_TEXTURE_LEVEL_COUNT - 1}.0,
-        log2(max(span, reach) / reach),
-        span < ${RESIDENT_MATERIAL_TEXTURE_RESOLUTION}.0 * reach
-    );
-}
-
-@compute @workgroup_size(${MESH_SDF_BAKE_WORKGROUP_SIZE})
-fn main(
-    @builtin(workgroup_id) workgroup_id: vec3<u32>,
-    @builtin(local_invocation_index) lane: u32,
-) {
-    let thread = (workgroup_id.y * settings.groups_x + workgroup_id.x) * ${MESH_SDF_BAKE_WORKGROUP_SIZE}u + lane;
-
-    if (thread >= settings.thread_count) {
-        return;
-    }
-
-    // the run the thread falls in: the last whose first thread is at or below it
-    var low = 0u;
-    var high = settings.run_count;
-
-    while (high - low > 1u) {
-        let middle = (low + high) / 2u;
-
-        if (mesh_card_runs[middle].x <= thread) {
-            low = middle;
-        } else {
-            high = middle;
-        }
-    }
-
-    let run = mesh_card_runs[low];
-    let card_set = mesh_card_sets[run.y];
-
-    let page_texels = MESH_CARD_PAGE_TEXELS * MESH_CARD_PAGE_TEXELS;
-    let within = thread - run.x;
-    let page = run.z + within / page_texels;
-    let texel = vec2<u32>(within % MESH_CARD_PAGE_TEXELS, (within / MESH_CARD_PAGE_TEXELS) % MESH_CARD_PAGE_TEXELS);
-
-    let geometry = card_set.geometry;
-    let header = mesh_sdf_headers[geometry];
-    let columns = mesh_sdf_indirection[header.cards + MESH_CARD_LAYOUT_COLUMN_COUNT];
-
-    // the page list follows the tables
-    let listed = mesh_sdf_indirection[header.cards + MESH_CARD_LAYOUT_TABLES + columns + page];
-    let card = listed >> 16u;
-    let column = vec2<u32>(listed & 0xffu, (listed >> 8u) & 0xffu);
-
-    let record = header.cards + MESH_CARD_LAYOUT_RECORDS + card * MESH_CARD_RECORD_WORDS;
-    let direction = mesh_sdf_indirection[record + MESH_CARD_RECORD_DIRECTION];
-    let near = mesh_sdf_indirection[record + MESH_CARD_RECORD_NEAR];
-    let far = mesh_sdf_indirection[record + MESH_CARD_RECORD_FAR];
-
-    let axes = mesh_card_axes(direction);
-    let toward_plus = (direction & 1u) == 0u;
-    let brick_span = f32(MESH_SDF_BRICK_VOXELS) * header.voxel;
-
-    // the texel on the card's near face: layer 'near' counts from the grid's +axis end for an odd direction
-    var start = header.origin;
-
-    start[axes.y] += f32(column.x * MESH_SDF_BRICK_VOXELS + texel.x) * header.voxel;
-    start[axes.z] += f32(column.y * MESH_SDF_BRICK_VOXELS + texel.y) * header.voxel;
-    start[axes.x] += select(f32(header.bricks[axes.x] - near), f32(near), toward_plus) * brick_span;
-
-    var along = vec3<f32>(0.0);
-
-    along[axes.x] = select(-1.0, 1.0, toward_plus);
-
-    // the card's texel steps, a voxel each
-    var step_u = vec3<f32>(0.0);
-    var step_v = vec3<f32>(0.0);
-
-    step_u[axes.y] = header.voxel;
-    step_v[axes.z] = header.voxel;
-
-    let depth = f32(far - near) * brick_span;
-
-    random_initialize(vec3<u32>(page, texel), vec3<u32>(run.y, geometry, 0u));
-
-    var ray: ${RAY_STRUCT.wgsl_ref};
-
-    ray.origin = start;
-    ray.direction = along;
-    ray.tmax = depth;
-
-    let material = materials[card_set.material];
-
-    var stack: array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
-
-    var found = false;
-    var travelled = 0.0;
-    var hit_t = 0.0;
-    var lambda = vec3<f32>(0.0);
-    var triangle_index = 0u;
-    var texture_level = 0.0;
-
-    for (var step = 0u; step <= ${MESH_CARD_ALPHA_CONTINUATIONS}u; step++) {
-        let hit = ray_query_blas_nearest(ray, geometry, &stack, 0u);
-
-        if (hit.t < 0.0) {
-            break;
-        }
-
-        let triangle = geometry_read_triangle_vertices(geometries[geometry], hit.triangle);
-        let at = vec3<f32>(1.0 - hit.barycentrics.x - hit.barycentrics.y, hit.barycentrics.x, hit.barycentrics.y);
-        let level = mesh_card_texture_level(triangle, along, step_u, step_v);
-        let surface = sample_material_alpha(material, triangle, at, MAT4_IDENTITY, ray.direction, level);
-
-        if (random() < surface.opacity) {
-            found = true;
-            hit_t = travelled + hit.t;
-            lambda = at;
-            triangle_index = hit.triangle;
-            texture_level = level;
-            break;
-        }
-
-        // past the transparent hit, by a sliver of a voxel
-        let skip = hit.t + 1e-3 * header.voxel;
-
-        ray.origin += ray.direction * skip;
-        ray.tmax -= skip;
-        travelled += skip;
-
-        if (ray.tmax <= 0.0) {
-            break;
-        }
-    }
-
-    var albedo_plane = vec4<f32>(0.0);
-    var emissive_plane = vec4<f32>(0.0);
-
-    if (found) {
-        let triangle = geometry_read_triangle_vertices(geometries[geometry], triangle_index);
-        let data = sample_material_data(ray, material, triangle, lambda, MAT4_IDENTITY, texture_level);
-
-        let diffuse = data.albedo * (1.0 - data.metalness);
-
-        albedo_plane = vec4<f32>(sqrt(max(diffuse, vec3<f32>(0.0))), (1.0 + 254.0 * saturate(hit_t / depth)) / 255.0);
-
-        if (card_set.emissive_scale > 0.0) {
-            emissive_plane = vec4<f32>(data.emissive / card_set.emissive_scale, 0.0);
-        }
-    }
-
-    let tiles_per_row = textureDimensions(mesh_card_albedo).x / MESH_CARD_PAGE_TEXELS;
-    let origin = index_to_grid2d(card_set.page_base + page, tiles_per_row) * MESH_CARD_PAGE_TEXELS + texel;
-
-    textureStore(mesh_card_albedo, origin, albedo_plane);
-    textureStore(mesh_card_emissive, origin, emissive_plane);
-}
-`, [
-            MAT4_IDENTITY_DEFINITION,
-            RAY_STRUCT.declaration_chunk,
-            TRIANGLE_VERTICES_STRUCT.declaration_chunk,
-            MESH_CARD_SET_STRUCT.declaration_chunk,
-            chunk_mesh_cards,
-            chunk_index_to_grid2d,
-            chunk_random,
-            chunk_random_initialize,
-            chunk_ray_query_blas_nearest,
-            chunk_geometry_read_triangle_vertices,
-            chunk_sample_material_alpha,
-            chunk_sample_material_data,
-        ]),
-}).variant(ShaderSwitchSet.EMPTY.with(INDIRECT_TEXTURE_FILTER, IndirectTextureFilter.Exact));

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_compact.d.ts

@@ -1,19 +0,0 @@
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_COMPACT_SETTINGS: WebGPUStruct;
-/**
- * A placed card layout moved into the range that fits it (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md
- * §6.5), a thread a word.
- *
- * Placement runs in a range sized for what any layout of the geometry's grid could be; only once its
- * log record is read back does the host know the columns and pages it took, and give the geometry a
- * range of that size. The two ranges never overlap: the source is held until the frame after this
- * pass runs.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_compact: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_mesh_cards_compact.d.ts.map

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_compact.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_mesh_cards_compact.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_compact.js"],"names":[],"mappings":"AAQA;;GAEG;AACH,0CAFU,YAAY,CAWS;AAS/B;;;;;;;;;;GAUG;AACH,wCAFU,aAAa,CAsBpB;6BAxD0B,sCAAsC;8BAHrC,kCAAkC"}

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_compact.js

@@ -1,61 +0,0 @@
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { MESH_SDF_BAKE_WORKGROUP_SIZE } from "../bake/MESH_SDF_BAKE.js";
-import { MESH_SDF_ARENA_RESOURCE } from "../bake/chunk_mesh_sdf_bake.js";
-
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_COMPACT_SETTINGS = WebGPUStruct.from({
-    /** the placed layout's first word, in the range placement had */
-    source: u32,
-    /** its first word in the range it keeps */
-    destination: u32,
-    /** its words: the header, the records, the column tables and the page list */
-    count: u32,
-    /** workgroups along x, the rest folded into y */
-    groups_x: u32,
-}, "MeshCardsCompactSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate("settings", MESH_CARDS_COMPACT_SETTINGS);
-
-resources.createGroup()
-    .add(MESH_SDF_ARENA_RESOURCE);
-
-/**
- * A placed card layout moved into the range that fits it (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md
- * §6.5), a thread a word.
- *
- * Placement runs in a range sized for what any layout of the geometry's grid could be; only once its
- * log record is read back does the host know the columns and pages it took, and give the geometry a
- * range of that size. The two ranges never overlap: the source is held until the frame after this
- * pass runs.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_compact = ComputeShader.from({
-    label: "Mesh Cards Compact",
-    resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-@compute @workgroup_size(${MESH_SDF_BAKE_WORKGROUP_SIZE})
-fn main(
-    @builtin(workgroup_id) workgroup_id: vec3<u32>,
-    @builtin(local_invocation_index) lane: u32,
-) {
-    let word = (workgroup_id.y * settings.groups_x + workgroup_id.x) * ${MESH_SDF_BAKE_WORKGROUP_SIZE}u + lane;
-
-    if (word >= settings.count) {
-        return;
-    }
-
-    atomicStore(&mesh_sdf_indirection[settings.destination + word], atomicLoad(&mesh_sdf_indirection[settings.source + word]));
-}
-`),
-});

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_histogram.d.ts

@@ -1,18 +0,0 @@
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_HISTOGRAM_SETTINGS: WebGPUStruct;
-/**
- * Card placement, step 1 (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.5): a thread a column of each of the
- * six directions, over a resident geometry's level-0 occupancy — a brick is occupied when its entry
- * holds a slot. Walking its column along the direction, a thread finds every run start: an occupied
- * brick at layer z whose predecessor is empty or outside the grid. A run start's m is the layer after
- * the previous run's end, or 0 for the first. The thread counts each run start into
- * its direction's histogram by (m, z), which the layout's scratch holds cleared.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_histogram: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_mesh_cards_histogram.d.ts.map

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_histogram.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_mesh_cards_histogram.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_histogram.js"],"names":[],"mappings":"AAUA;;GAEG;AACH,4CAFU,YAAY,CAOW;AAUjC;;;;;;;;;GASG;AACH,0CAFU,aAAa,CAiEpB;6BAjG0B,sCAAsC;8BAHrC,kCAAkC"}

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_histogram.js

@@ -1,102 +0,0 @@
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { chunk_mesh_sdf_bake, MESH_SDF_ARENA_RESOURCE } from "../bake/chunk_mesh_sdf_bake.js";
-import { MESH_SDF_BAKE_WORKGROUP_SIZE } from "../bake/MESH_SDF_BAKE.js";
-import { MESH_SDF_HEADERS_RESOURCE } from "../MESH_SDF_RESOURCES.js";
-import { chunk_mesh_cards } from "./chunk_mesh_cards.js";
-
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_HISTOGRAM_SETTINGS = WebGPUStruct.from({
-    /** the geometry whose cards are placed */
-    geometry: u32,
-    /** columns over the six directions: the threads that do work */
-    columns: u32,
-}, "MeshCardsHistogramSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate("settings", MESH_CARDS_HISTOGRAM_SETTINGS);
-
-resources.createGroup()
-    .add(MESH_SDF_HEADERS_RESOURCE)
-    .add(MESH_SDF_ARENA_RESOURCE);
-
-/**
- * Card placement, step 1 (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.5): a thread a column of each of the
- * six directions, over a resident geometry's level-0 occupancy — a brick is occupied when its entry
- * holds a slot. Walking its column along the direction, a thread finds every run start: an occupied
- * brick at layer z whose predecessor is empty or outside the grid. A run start's m is the layer after
- * the previous run's end, or 0 for the first. The thread counts each run start into
- * its direction's histogram by (m, z), which the layout's scratch holds cleared.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_histogram = ComputeShader.from({
-    label: "Mesh Cards Histogram",
-    resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-@compute @workgroup_size(${MESH_SDF_BAKE_WORKGROUP_SIZE})
-fn main(@builtin(global_invocation_id) id: vec3<u32>) {
-    let thread = id.x;
-
-    if (thread >= settings.columns) {
-        return;
-    }
-
-    let header = mesh_sdf_headers[settings.geometry];
-    let bricks = header.bricks;
-    let parts = mesh_card_placement_of(bricks);
-
-    // the direction whose columns the thread is among: six runs, a direction's columns each
-    var direction = 0u;
-    var first = 0u;
-
-    for (; direction + 1u < MESH_CARD_DIRECTIONS; direction++) {
-        let extent = mesh_card_extent(bricks, direction);
-        let count = extent.y * extent.z;
-
-        if (thread < first + count) {
-            break;
-        }
-
-        first += count;
-    }
-
-    let extent = mesh_card_extent(bricks, direction);
-    let index = thread - first;
-    let column = vec2<u32>(index % extent.y, index / extent.y);
-
-    let histogram = header.cards + parts.histograms + direction * parts.layers * parts.layers;
-
-    var run_from = 0u;
-    var inside = false;
-
-    for (var layer = 0u; layer < extent.x; layer++) {
-        let brick = mesh_card_brick(bricks, direction, column, layer);
-        let entry = atomicLoad(&mesh_sdf_indirection[header.indirection + brick.x + bricks.x * (brick.y + bricks.y * brick.z)]);
-        let occupied = mesh_sdf_entry_holds_slot(entry);
-
-        if (occupied && !inside) {
-            atomicAdd(&mesh_sdf_indirection[histogram + run_from * parts.layers + layer], 1u);
-        }
-
-        if (!occupied && inside) {
-            // the next run's m: the layer after this one's end
-            run_from = layer;
-        }
-
-        inside = occupied;
-    }
-}
-`, [
-            chunk_mesh_sdf_bake,
-            chunk_mesh_cards,
-        ]),
-});

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_log.d.ts

@@ -1,15 +0,0 @@
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_LOG_SETTINGS: WebGPUStruct;
-/**
- * Card placement, step 5: one thread, a dispatch after the pages, so every page the threads took is
- * counted. Logs the geometry placed, as `(geometry | MESH_SDF_LOG_PLACED, generation, columns, pages)`,
- * for the host, which gives the layout a range of that size and its pairs' pages by that count.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_log: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_mesh_cards_log.d.ts.map

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_log.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_mesh_cards_log.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_log.js"],"names":[],"mappings":"AAUA;;GAEG;AACH,sCAFU,YAAY,CASK;AAU3B;;;;;;GAMG;AACH,oCAFU,aAAa,CA6BpB;6BA5D0B,sCAAsC;8BAHrC,kCAAkC"}

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_log.js

@@ -1,65 +0,0 @@
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { chunk_mesh_sdf_bake, MESH_SDF_ARENA_RESOURCE } from "../bake/chunk_mesh_sdf_bake.js";
-import { MESH_SDF_LOG_PLACED } from "../bake/MESH_SDF_BAKE.js";
-import { MESH_SDF_HEADERS_RESOURCE } from "../MESH_SDF_RESOURCES.js";
-import { chunk_mesh_cards } from "./chunk_mesh_cards.js";
-
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_LOG_SETTINGS = WebGPUStruct.from({
-    /** the geometry whose cards were placed */
-    geometry: u32,
-    /** where the frame's log starts in the arena */
-    log_offset: u32,
-    /** records the log holds */
-    log_capacity: u32,
-}, "MeshCardsLogSettings");
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.setImmediate("settings", MESH_CARDS_LOG_SETTINGS);
-
-resources.createGroup()
-    .add(MESH_SDF_HEADERS_RESOURCE)
-    .add(MESH_SDF_ARENA_RESOURCE);
-
-/**
- * Card placement, step 5: one thread, a dispatch after the pages, so every page the threads took is
- * counted. Logs the geometry placed, as `(geometry | MESH_SDF_LOG_PLACED, generation, columns, pages)`,
- * for the host, which gives the layout a range of that size and its pairs' pages by that count.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_log = ComputeShader.from({
-    label: "Mesh Cards Log",
-    resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-@compute @workgroup_size(1)
-fn main() {
-    let header = mesh_sdf_headers[settings.geometry];
-
-    let record = atomicAdd(&mesh_sdf_indirection[settings.log_offset + MESH_SDF_LOG_COMPLETIONS], 1u);
-
-    if (record >= settings.log_capacity) {
-        return;
-    }
-
-    let word = settings.log_offset + MESH_SDF_LOG_HEADER_WORDS + record * MESH_SDF_LOG_RECORD_WORDS;
-
-    atomicStore(&mesh_sdf_indirection[word], settings.geometry | ${MESH_SDF_LOG_PLACED}u);
-    atomicStore(&mesh_sdf_indirection[word + 1u], header.generation);
-    atomicStore(&mesh_sdf_indirection[word + 2u], atomicLoad(&mesh_sdf_indirection[header.cards + MESH_CARD_LAYOUT_COLUMN_COUNT]));
-    atomicStore(&mesh_sdf_indirection[word + 3u], atomicLoad(&mesh_sdf_indirection[header.cards + MESH_CARD_LAYOUT_PAGE_COUNT]));
-}
-`, [
-            chunk_mesh_sdf_bake,
-            chunk_mesh_cards,
-        ]),
-});

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_merge.d.ts

@@ -1,22 +0,0 @@
-/**
- * @type {WebGPUStruct}
- */
-export const MESH_CARDS_MERGE_SETTINGS: WebGPUStruct;
-/**
- * Card placement, step 3 (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.5): one thread. The six directions'
- * splits are taken in order of gain, as the greedy search over all six would take them, until the
- * gains run out or the geometry has MESH_CARD_MAX cards. Every run start is then covered, or the
- * ceiling has left some uncovered, which read the material mean.
- *
- * The cards are written direction by direction, each direction's cards by their near layer. Each
- * card records its direction, its slab, and where its column table starts: a word for each column of
- * its direction, laid out card after card. The layout's header gets the card count, each direction's
- * first card, and the columns over every card. The page pass's dispatch goes to `mesh_sdf_take`: a
- * thread a column.
- *
- * @type {ComputeShader}
- */
-export const shader_mesh_cards_merge: ComputeShader;
-import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_mesh_cards_merge.d.ts.map

package/src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_merge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_mesh_cards_merge.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/sdf/cards/shader_mesh_cards_merge.js"],"names":[],"mappings":"AAYA;;GAEG;AACH,wCAFU,YAAY,CAOO;AAW7B;;;;;;;;;;;;;GAaG;AACH,sCAFU,aAAa,CA4FpB;6BAlI0B,sCAAsC;8BAJrC,kCAAkC"}