@woosh/meep-engine 3.11.3 → 3.12.0

package/src/engine/graphics3/shade_node_to_entity_composition.js

@@ -1,84 +1,84 @@
-import { Name } from "../ecs/name/Name.js";
-import { EntityNode } from "../ecs/parent/EntityNode.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import { transform_copy_from_t64 } from "../ecs/transform/transform_copy_from_t64.js";
-import { DrawMode } from "../graphics/ecs/mesh-v2/DrawMode.js";
-import { ShadedGeometry } from "../graphics/ecs/mesh-v2/ShadedGeometry.js";
-
-/**
- * Turn a loaded model's node tree into entities.
- *
- * **This is what a hierarchy is in an ECS** (D47). meep has no scene graph to hand a model to: it
- * has entities, `EntityNode` to parent them, and `ShadedGeometry` for the ones that draw. A model
- * file is therefore not a thing an entity *holds* — it is a shape an entity's descendants take, and
- * this function is where the file stops being the renderer's tree and becomes the dataset's.
- *
- * It is `three_object_to_entity_composition` with the source swapped: the same output, built from
- * Shade's `Node3D`s instead of three's `Object3D`s. The two exist side by side for as long as both
- * renderers do.
- *
- * **Geometry and material are shared, not copied.** Two entities placing the same model name the
- * same `MeshletGeometry` and the same `ShadeMaterial`; what is per-entity is the row each one gets
- * in the scene, which is `ShadedGeometrySystem3`'s business. That is the whole reason a static model
- * needs no clone of the bundle at all.
- *
- * **A skinned mesh is not expanded, and that is a boundary rather than an omission.** Its vertices
- * are deformed against a skeleton the renderer owns and the GPU poses, and making those joints
- * entities is a design this program does not do (D47). A `SkinnedMesh` node therefore contributes
- * its transform and its name and no geometry, and whatever placed the model keeps drawing it the way
- * Phase 4 built.
- *
- * @param {Node3D} node
- * @returns {EntityNode}
- */
-export function shade_node_to_entity_composition(node) {
-    const result = new EntityNode();
-
-    // the hierarchy's own transform: what this node is, relative to its parent
-    transform_copy_from_t64(result.transform, node.transform_local);
-
-    const entity = result.entity;
-
-    entity.add(transform_copy_from_t64(new Transform(), node.transform_global));
-    entity.add(new Name(node.name));
-
-    if (node.isMesh === true && node.isSkinnedMesh !== true) {
-        entity.add(ShadedGeometry.from(node.geometry, node.material, DrawMode.Triangles));
-    }
-
-    const children = node.children;
-
-    for (let i = 0; i < children.length; i++) {
-        result.addChild(shade_node_to_entity_composition(children[i]));
-    }
-
-    return result;
-}
-
-/**
- * The same, for everything a loader produced.
- *
- * A bundle can carry more than one scene — glTF allows it — and the entity that placed the file owns
- * all of them, so they become children of one root rather than several compositions nobody joins.
- *
- * @param {SceneBundle} bundle
- * @returns {EntityNode}
- */
-export function shade_bundle_to_entity_composition(bundle) {
-    const scenes = bundle.scenes;
-
-    if (scenes.length === 1) {
-        return shade_node_to_entity_composition(scenes[0]);
-    }
-
-    const root = new EntityNode();
-
-    root.entity.add(new Transform());
-    root.entity.add(new Name(""));
-
-    for (let i = 0; i < scenes.length; i++) {
-        root.addChild(shade_node_to_entity_composition(scenes[i]));
-    }
-
-    return root;
-}
+import { Name } from "../ecs/name/Name.js";
+import { EntityNode } from "../ecs/parent/EntityNode.js";
+import { Transform } from "../ecs/transform/Transform.js";
+import { transform_copy_from_t64 } from "../ecs/transform/transform_copy_from_t64.js";
+import { DrawMode } from "../graphics/ecs/mesh-v2/DrawMode.js";
+import { ShadedGeometry } from "../graphics/ecs/mesh-v2/ShadedGeometry.js";
+
+/**
+ * Turn a loaded model's node tree into entities.
+ *
+ * **This is what a hierarchy is in an ECS** (D47). meep has no scene graph to hand a model to: it
+ * has entities, `EntityNode` to parent them, and `ShadedGeometry` for the ones that draw. A model
+ * file is therefore not a thing an entity *holds* — it is a shape an entity's descendants take, and
+ * this function is where the file stops being the renderer's tree and becomes the dataset's.
+ *
+ * It is `three_object_to_entity_composition` with the source swapped: the same output, built from
+ * Shade's `Node3D`s instead of three's `Object3D`s. The two exist side by side for as long as both
+ * renderers do.
+ *
+ * **Geometry and material are shared, not copied.** Two entities placing the same model name the
+ * same `MeshletGeometry` and the same `ShadeMaterial`; what is per-entity is the row each one gets
+ * in the scene, which is `ShadedGeometrySystem`'s business. That is the whole reason a static model
+ * needs no clone of the bundle at all.
+ *
+ * **A skinned mesh is not expanded, and that is a boundary rather than an omission.** Its vertices
+ * are deformed against a skeleton the renderer owns and the GPU poses, and making those joints
+ * entities is a design this program does not do (D47). A `SkinnedMesh` node therefore contributes
+ * its transform and its name and no geometry, and whatever placed the model keeps drawing it the way
+ * Phase 4 built.
+ *
+ * @param {Node3D} node
+ * @returns {EntityNode}
+ */
+export function shade_node_to_entity_composition(node) {
+    const result = new EntityNode();
+
+    // the hierarchy's own transform: what this node is, relative to its parent
+    transform_copy_from_t64(result.transform, node.transform_local);
+
+    const entity = result.entity;
+
+    entity.add(transform_copy_from_t64(new Transform(), node.transform_global));
+    entity.add(new Name(node.name));
+
+    if (node.isMesh === true && node.isSkinnedMesh !== true) {
+        entity.add(ShadedGeometry.from(node.geometry, node.material, DrawMode.Triangles));
+    }
+
+    const children = node.children;
+
+    for (let i = 0; i < children.length; i++) {
+        result.addChild(shade_node_to_entity_composition(children[i]));
+    }
+
+    return result;
+}
+
+/**
+ * The same, for everything a loader produced.
+ *
+ * A bundle can carry more than one scene — glTF allows it — and the entity that placed the file owns
+ * all of them, so they become children of one root rather than several compositions nobody joins.
+ *
+ * @param {SceneBundle} bundle
+ * @returns {EntityNode}
+ */
+export function shade_bundle_to_entity_composition(bundle) {
+    const scenes = bundle.scenes;
+
+    if (scenes.length === 1) {
+        return shade_node_to_entity_composition(scenes[0]);
+    }
+
+    const root = new EntityNode();
+
+    root.entity.add(new Transform());
+    root.entity.add(new Name(""));
+
+    for (let i = 0; i < scenes.length; i++) {
+        root.addChild(shade_node_to_entity_composition(scenes[i]));
+    }
+
+    return root;
+}

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_blas_audit_leaf_triangles.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.js"],"names":[],"mappings":"AAqBA,2CAA4C;AA4D5C;;;;;;;;;;;;;;;;GAgBG;AACH,+CAFU,aAAa,CAOpB;8BApG2B,wCAAwC"}
+{"version":3,"file":"shader_blas_audit_leaf_triangles.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.js"],"names":[],"mappings":"AAqBA,2CAA4C;AA4D5C;;;;;;;;;;;;;;;;GAgBG;AACH,+CAFU,aAAa,CAMpB;8BAnG2B,wCAAwC"}

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.js

@@ -100,5 +100,4 @@ export const shader_blas_audit_leaf_triangles = ComputeShader.from({
     label: "BLAS/AuditLeafTriangles",
     resources,
     body,
-    group_size: [BLAS_AUDIT_WORKGROUP_SIZE, 1, 1],
 });

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_points.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_blas_audit_points.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_points.js"],"names":[],"mappings":"AAkBA,4CAA6C;AAE7C;;GAEG;AACH,0CAFU,YAAY,CAOG;AA8CzB;;;;;;;;;;;;;GAaG;AACH,uCAFU,aAAa,CAOpB;6BA3F0B,4CAA4C;8BAE3C,wCAAwC"}
+{"version":3,"file":"shader_blas_audit_points.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_points.js"],"names":[],"mappings":"AAkBA,4CAA6C;AAE7C;;GAEG;AACH,0CAFU,YAAY,CAOG;AA8CzB;;;;;;;;;;;;;GAaG;AACH,uCAFU,aAAa,CAMpB;6BA1F0B,4CAA4C;8BAE3C,wCAAwC"}

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_points.js

@@ -90,5 +90,4 @@ export const shader_blas_audit_points = ComputeShader.from({
     label: "BLAS/AuditPoints",
     resources,
     body,
-    group_size: [BLAS_POINTS_WORKGROUP_SIZE, 1, 1],
 });

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_blas_audit_visibility.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.js"],"names":[],"mappings":"AAyBA,gDAAiD;AAEjD;;GAEG;AACH,8CAFU,YAAY,CASO;AA0E7B;;;;;;;;;;;;;;;;GAgBG;AACH,2CAFU,aAAa,CAOpB;6BAnI0B,4CAA4C;8BAE3C,wCAAwC"}
+{"version":3,"file":"shader_blas_audit_visibility.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.js"],"names":[],"mappings":"AAyBA,gDAAiD;AAEjD;;GAEG;AACH,8CAFU,YAAY,CASO;AA0E7B;;;;;;;;;;;;;;;;GAgBG;AACH,2CAFU,aAAa,CAMpB;6BAlI0B,4CAA4C;8BAE3C,wCAAwC"}

package/src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.js

@@ -1,134 +1,133 @@
-import { f32, u32, vec3f } from "../../renderer/shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../renderer/shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../renderer/shader/type/WebGPUStruct.js";
-import { CodeChunk } from "../../renderer/shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../renderer/shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../renderer/shader/resource/ShaderResourceSetDescriptor.js";
-import {
-    BVH_NODE_CHILD_2_WORD,
-    BVH_NODE_STRIDE_WORDS
-} from "../../renderer/gpu_primitive/bvh/BVH_BUFFER_LAYOUT.js";
-import { BVH2_NODE_STRUCT } from "../../renderer/shader/chunk/bvh/BVH2_NODE_STRUCT.js";
-import { BVH_TRAVERSAL_STACK_SIZE } from "../../renderer/shader/chunk/bvh/BVH_TRAVERSAL_STACK_SIZE.js";
-import {
-    chunk_ray_query_blas_nearest
-} from "../../renderer/shader/chunk/geometry/ray/chunk_ray_query_blas_nearest.js";
-import {
-    chunk_geometry_read_triangle_vertices
-} from "../../renderer/shader/chunk/geometry/format/chunk_geometry_read_triangle_vertices.js";
-import { RAY_STRUCT } from "../../renderer/shader/chunk/geometry/ray/RAY_STRUCT.js";
-import { GEOMETRY_METADATA_STRUCT } from "../../renderer/geometry/GEOMETRY_METADATA_STRUCT.js";
-import { GEOMETRY_ATTRIBUTE_DATA_TYPE } from "../../renderer/geometry/GEOMETRY_ATTRIBUTE_DATA_TYPE.js";
-import {
-    MESHLET_METADATA_STRUCT
-} from "../../renderer/geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
-
-export const BLAS_VISIBILITY_WORKGROUP_SIZE = 64;
-
-/**
- * @type {WebGPUStruct}
- */
-export const BLAS_VISIBILITY_SETTINGS_STRUCT = WebGPUStruct.from({
-    origin: vec3f,
-    leaf_count: u32,
-    node_word_offset: u32,
-    leaf_nodes_offset: u32,
-    geometry_index: u32,
-    tmax: f32,
-}, "BlasVisibilitySettings");
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("settings", BLAS_VISIBILITY_SETTINGS_STRUCT)
-    .addStorageBuffer("leaf_nodes", WebGPUArray.from(u32), false)
-    .addStorageBuffer("blas_lookup", WebGPUArray.from(u32), false)
-    .addStorageBuffer("blas_data", WebGPUArray.from(BVH2_NODE_STRUCT), false)
-    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT), false)
-    .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT), false)
-    .addStorageBuffer("meshlet_data", GEOMETRY_ATTRIBUTE_DATA_TYPE, false)
-    .addStorageBuffer("nodes", WebGPUArray.from(f32), false)
-    // per leaf: the parametric t the traversal came back with, negative for a miss
-    .addStorageBuffer("out_t", WebGPUArray.from(f32), true)
-    // per leaf: the triangle the traversal returned, or 0xFFFFFFFF
-    .addStorageBuffer("out_triangle", WebGPUArray.from(u32), true)
-    // per leaf: the distance to the point the ray was aimed at, which the answer cannot exceed
-    .addStorageBuffer("out_expected_t", WebGPUArray.from(f32), true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-const NODE_STRIDE = ${BVH_NODE_STRIDE_WORDS}u;
-const NODE_CHILD_2 = ${BVH_NODE_CHILD_2_WORD}u;
-
-@compute @workgroup_size(${BLAS_VISIBILITY_WORKGROUP_SIZE}, 1, 1)
-fn main(@builtin(global_invocation_id) gid: vec3<u32>) {
-    let i = gid.x;
-
-    if (i >= settings.leaf_count) {
-        return;
-    }
-
-    let leaf_node = leaf_nodes[settings.leaf_nodes_offset + i];
-
-    let node_word = settings.node_word_offset + leaf_node * NODE_STRIDE;
-
-    let meshlet_triangle_id = bitcast<u32>(nodes[node_word + NODE_CHILD_2]);
-
-    let triangle = geometry_read_triangle_vertices(
-        geometries[settings.geometry_index],
-        meshlet_triangle_id
-    );
-
-    // Aim at the triangle's own centroid, which is strictly inside it. The ray provably intersects
-    // this triangle, so the traversal has to come back with *something* — this one, or something
-    // occluding it. A miss is not a geometric possibility; it is the traversal failing to reach a
-    // leaf whose box, by construction, the ray passes through.
-    let centre = (triangle.a.position + triangle.b.position + triangle.c.position) / 3.0;
-
-    var ray: ${RAY_STRUCT.wgsl_ref};
-
-    ray.origin = settings.origin;
-    ray.direction = normalize(centre - settings.origin);
-    ray.tmax = settings.tmax;
-
-    var stack: array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
-
-    let hit = ray_query_blas_nearest(ray, settings.geometry_index, &stack, 0u);
-
-    out_t[i] = hit.t;
-    out_triangle[i] = select(0xFFFFFFFFu, hit.triangle, hit.t >= 0.0);
-
-    // The ray was aimed at a point on this triangle, so the nearest surface along it is at most
-    // this far. An answer beyond it is not an occlusion and not a miss — it is the traversal
-    // walking past a surface it was pointed at, which is what a hole in the traced image is.
-    out_expected_t[i] = length(centre - settings.origin);
-}
-`, [
-    RAY_STRUCT.declaration_chunk,
-    chunk_geometry_read_triangle_vertices,
-    chunk_ray_query_blas_nearest,
-]);
-
-/**
- * Ask the traversal, once per triangle, whether it can find that triangle.
- *
- * Every structural check on the tree has passed, which narrows the fault to the traversal itself —
- * and traversal is the one thing no readback of the tree can exercise. So this runs the real
- * `ray_query_blas_nearest`, the same function the path tracer calls, along a ray whose answer is
- * known in advance.
- *
- * The ray goes from the camera to a triangle's centroid. That point is inside the triangle, so the
- * ray intersects it, so the query must return a hit — this triangle if nothing is in front, some
- * other one if something is. Only a miss is impossible, and a miss is therefore a traversal that
- * failed to reach a leaf whose box it was inside.
- *
- * Which triangles miss, and where they are, is the whole diagnosis.
- *
- * @type {ComputeShader}
- */
-export const shader_blas_audit_visibility = ComputeShader.from({
-    label: "BLAS/AuditVisibility",
-    resources,
-    body,
-    group_size: [BLAS_VISIBILITY_WORKGROUP_SIZE, 1, 1],
-});
+import { f32, u32, vec3f } from "../../renderer/shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../renderer/shader/type/WebGPUArray.js";
+import { WebGPUStruct } from "../../renderer/shader/type/WebGPUStruct.js";
+import { CodeChunk } from "../../renderer/shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../renderer/shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../renderer/shader/resource/ShaderResourceSetDescriptor.js";
+import {
+    BVH_NODE_CHILD_2_WORD,
+    BVH_NODE_STRIDE_WORDS
+} from "../../renderer/gpu_primitive/bvh/BVH_BUFFER_LAYOUT.js";
+import { BVH2_NODE_STRUCT } from "../../renderer/shader/chunk/bvh/BVH2_NODE_STRUCT.js";
+import { BVH_TRAVERSAL_STACK_SIZE } from "../../renderer/shader/chunk/bvh/BVH_TRAVERSAL_STACK_SIZE.js";
+import {
+    chunk_ray_query_blas_nearest
+} from "../../renderer/shader/chunk/geometry/ray/chunk_ray_query_blas_nearest.js";
+import {
+    chunk_geometry_read_triangle_vertices
+} from "../../renderer/shader/chunk/geometry/format/chunk_geometry_read_triangle_vertices.js";
+import { RAY_STRUCT } from "../../renderer/shader/chunk/geometry/ray/RAY_STRUCT.js";
+import { GEOMETRY_METADATA_STRUCT } from "../../renderer/geometry/GEOMETRY_METADATA_STRUCT.js";
+import { GEOMETRY_ATTRIBUTE_DATA_TYPE } from "../../renderer/geometry/GEOMETRY_ATTRIBUTE_DATA_TYPE.js";
+import {
+    MESHLET_METADATA_STRUCT
+} from "../../renderer/geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
+
+export const BLAS_VISIBILITY_WORKGROUP_SIZE = 64;
+
+/**
+ * @type {WebGPUStruct}
+ */
+export const BLAS_VISIBILITY_SETTINGS_STRUCT = WebGPUStruct.from({
+    origin: vec3f,
+    leaf_count: u32,
+    node_word_offset: u32,
+    leaf_nodes_offset: u32,
+    geometry_index: u32,
+    tmax: f32,
+}, "BlasVisibilitySettings");
+
+const resources = new ShaderResourceSetDescriptor();
+resources.createGroup()
+    .addUniform("settings", BLAS_VISIBILITY_SETTINGS_STRUCT)
+    .addStorageBuffer("leaf_nodes", WebGPUArray.from(u32), false)
+    .addStorageBuffer("blas_lookup", WebGPUArray.from(u32), false)
+    .addStorageBuffer("blas_data", WebGPUArray.from(BVH2_NODE_STRUCT), false)
+    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT), false)
+    .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT), false)
+    .addStorageBuffer("meshlet_data", GEOMETRY_ATTRIBUTE_DATA_TYPE, false)
+    .addStorageBuffer("nodes", WebGPUArray.from(f32), false)
+    // per leaf: the parametric t the traversal came back with, negative for a miss
+    .addStorageBuffer("out_t", WebGPUArray.from(f32), true)
+    // per leaf: the triangle the traversal returned, or 0xFFFFFFFF
+    .addStorageBuffer("out_triangle", WebGPUArray.from(u32), true)
+    // per leaf: the distance to the point the ray was aimed at, which the answer cannot exceed
+    .addStorageBuffer("out_expected_t", WebGPUArray.from(f32), true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+const NODE_STRIDE = ${BVH_NODE_STRIDE_WORDS}u;
+const NODE_CHILD_2 = ${BVH_NODE_CHILD_2_WORD}u;
+
+@compute @workgroup_size(${BLAS_VISIBILITY_WORKGROUP_SIZE}, 1, 1)
+fn main(@builtin(global_invocation_id) gid: vec3<u32>) {
+    let i = gid.x;
+
+    if (i >= settings.leaf_count) {
+        return;
+    }
+
+    let leaf_node = leaf_nodes[settings.leaf_nodes_offset + i];
+
+    let node_word = settings.node_word_offset + leaf_node * NODE_STRIDE;
+
+    let meshlet_triangle_id = bitcast<u32>(nodes[node_word + NODE_CHILD_2]);
+
+    let triangle = geometry_read_triangle_vertices(
+        geometries[settings.geometry_index],
+        meshlet_triangle_id
+    );
+
+    // Aim at the triangle's own centroid, which is strictly inside it. The ray provably intersects
+    // this triangle, so the traversal has to come back with *something* — this one, or something
+    // occluding it. A miss is not a geometric possibility; it is the traversal failing to reach a
+    // leaf whose box, by construction, the ray passes through.
+    let centre = (triangle.a.position + triangle.b.position + triangle.c.position) / 3.0;
+
+    var ray: ${RAY_STRUCT.wgsl_ref};
+
+    ray.origin = settings.origin;
+    ray.direction = normalize(centre - settings.origin);
+    ray.tmax = settings.tmax;
+
+    var stack: array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
+
+    let hit = ray_query_blas_nearest(ray, settings.geometry_index, &stack, 0u);
+
+    out_t[i] = hit.t;
+    out_triangle[i] = select(0xFFFFFFFFu, hit.triangle, hit.t >= 0.0);
+
+    // The ray was aimed at a point on this triangle, so the nearest surface along it is at most
+    // this far. An answer beyond it is not an occlusion and not a miss — it is the traversal
+    // walking past a surface it was pointed at, which is what a hole in the traced image is.
+    out_expected_t[i] = length(centre - settings.origin);
+}
+`, [
+    RAY_STRUCT.declaration_chunk,
+    chunk_geometry_read_triangle_vertices,
+    chunk_ray_query_blas_nearest,
+]);
+
+/**
+ * Ask the traversal, once per triangle, whether it can find that triangle.
+ *
+ * Every structural check on the tree has passed, which narrows the fault to the traversal itself —
+ * and traversal is the one thing no readback of the tree can exercise. So this runs the real
+ * `ray_query_blas_nearest`, the same function the path tracer calls, along a ray whose answer is
+ * known in advance.
+ *
+ * The ray goes from the camera to a triangle's centroid. That point is inside the triangle, so the
+ * ray intersects it, so the query must return a hit — this triangle if nothing is in front, some
+ * other one if something is. Only a miss is impossible, and a miss is therefore a traversal that
+ * failed to reach a leaf whose box it was inside.
+ *
+ * Which triangles miss, and where they are, is the whole diagnosis.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_blas_audit_visibility = ComputeShader.from({
+    label: "BLAS/AuditVisibility",
+    resources,
+    body,
+});