@woosh/meep-engine 3.49.0 → 3.51.0

package/src/shade/renderer/shader/chunk/physics/fluid/chunk_vortex_swirl.js

@@ -0,0 +1,39 @@
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+import { chunk_point_closest_on_line } from "../../geometry/chunk_point_closest_on_line.js";
+import { chunk_falloff_quadratic } from "../../math/chunk_falloff_quadratic.js";
+
+/**
+ * The tangential push about an axis, along a segment of it:
+ *
+ *     swirl(x) = strength · (27/4) · (â × r⊥)/R · (1 − d/R)²,   0 from d = R on
+ *
+ * The segment runs from `position` along the unit `axis` (`â`) for `segment_length`, ≥ 0.
+ * `r⊥ = x − c(x)`, `c(x)` the point on the segment closest to `x`, `d = ‖r⊥‖`, `R = radius`. Zero on
+ * the axis and at `R`; `strength` at `d = R/3` beside the segment; right-handed about the axis. The
+ * cross product turns only the part of `r⊥` across the axis, so a segment of no length is a point
+ * vortex about the axis line through `position`. `r⊥` is never normalised, so the swirl is finite
+ * everywhere for `R > 0`.
+ *
+ * The WGSL twin of `vortex_swirl` (`core/math/physics/fluid/vortex_swirl.js`), whose header has the
+ * derivation.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_vortex_swirl = CodeChunk.from(
+    //language=WGSL
+    `
+fn vortex_swirl(
+    x: vec3<f32>, position: vec3<f32>, axis: vec3<f32>, segment_length: f32, radius: f32, strength: f32
+) -> vec3<f32> {
+    let r_perp = x - point_closest_on_line(x, position, position + axis * segment_length);
+
+    let weight = falloff_quadratic(length(r_perp) / radius);
+
+    // 27/4 lifts the peak of s (1 - s)^2, which is 4/27 at s = 1/3, to 1
+    return cross(axis, r_perp) * (strength * (27.0 / 4.0) * weight / radius);
+}
+    `, [
+        chunk_point_closest_on_line,
+        chunk_falloff_quadratic,
+    ]
+);

package/src/shade/renderer/shader/chunk/physics/kinematics/chunk_rigid_velocity_at_point.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Velocity of a point `p` carried by a rigid body: `v + ω × (p − c)`. The body moves at
+ * `linear_velocity` at the point `origin` it turns about, and spins at `angular_velocity` radians per
+ * second about it.
+ *
+ * The WGSL twin of `rigid_velocity_at_point` (`core/math/physics/kinematics/rigid_velocity_at_point.js`).
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_rigid_velocity_at_point: CodeChunk;
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_rigid_velocity_at_point.d.ts.map

package/src/shade/renderer/shader/chunk/physics/kinematics/chunk_rigid_velocity_at_point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_rigid_velocity_at_point.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/physics/kinematics/chunk_rigid_velocity_at_point.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,4CAFU,SAAS,CAWjB;0BApBwB,gCAAgC"}

package/src/shade/renderer/shader/chunk/physics/kinematics/chunk_rigid_velocity_at_point.js

@@ -0,0 +1,21 @@
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+
+/**
+ * Velocity of a point `p` carried by a rigid body: `v + ω × (p − c)`. The body moves at
+ * `linear_velocity` at the point `origin` it turns about, and spins at `angular_velocity` radians per
+ * second about it.
+ *
+ * The WGSL twin of `rigid_velocity_at_point` (`core/math/physics/kinematics/rigid_velocity_at_point.js`).
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_rigid_velocity_at_point = CodeChunk.from(
+    //language=WGSL
+    `
+fn rigid_velocity_at_point(
+    linear_velocity: vec3<f32>, angular_velocity: vec3<f32>, origin: vec3<f32>, p: vec3<f32>
+) -> vec3<f32> {
+    return linear_velocity + cross(angular_velocity, p - origin);
+}
+    `
+);

package/src/shade/renderer/shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The scene's depth, as the screen-space marches read it.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_DEPTH_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The hierarchical Z buffer, starting at mip 1.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_HZB_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The scene's normals, encoded.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_NORMAL_RESOURCE: ShaderResourceDescriptor;
+import { ShaderResourceDescriptor } from "../../resource/ShaderResourceDescriptor.js";
+//# sourceMappingURL=SCREEN_SPACE_RESOURCES.d.ts.map

package/src/shade/renderer/shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SCREEN_SPACE_RESOURCES.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,oCAFU,wBAAwB,CAE8C;AAEhF;;;GAGG;AACH,kCAFU,wBAAwB,CAE0C;AAE5E;;;GAGG;AACH,qCAFU,wBAAwB,CAEwD;yCAlBjD,4CAA4C"}

package/src/shade/renderer/shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.js

@@ -0,0 +1,19 @@
+import { ShaderResourceDescriptor } from "../../resource/ShaderResourceDescriptor.js";
+
+/**
+ * The scene's depth, as the screen-space marches read it.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_DEPTH_RESOURCE = ShaderResourceDescriptor.texture("tDepth");
+
+/**
+ * The hierarchical Z buffer, starting at mip 1.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_HZB_RESOURCE = ShaderResourceDescriptor.texture("tHZB");
+
+/**
+ * The scene's normals, encoded.
+ * @type {ShaderResourceDescriptor}
+ */
+export const SCREEN_NORMAL_RESOURCE = ShaderResourceDescriptor.texture("tNormal", "uint");

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_depth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_load_depth.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_depth.js"],"names":[],"mappings":"AAEA,kDAYE;0BAdwB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_load_depth.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_depth.js"],"names":[],"mappings":"AAGA,kDAYE;0BAfwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_depth.js

@@ -1,4 +1,5 @@
 import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { SCREEN_DEPTH_RESOURCE, SCREEN_HZB_RESOURCE } from "./SCREEN_SPACE_RESOURCES.js";
 
 export const chunk_ffx_sssr_load_depth = CodeChunk.from(
 //language=WGSL
@@ -12,4 +13,7 @@ fn ffx_sssr_load_depth(pixel_coordinate:vec2<i32>, mip:i32) -> f32{
     }
 }
     `
-);
+);
+
+chunk_ffx_sssr_load_depth.requireResource(SCREEN_DEPTH_RESOURCE);
+chunk_ffx_sssr_load_depth.requireResource(SCREEN_HZB_RESOURCE);

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_world_space_normal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_load_world_space_normal.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_world_space_normal.js"],"names":[],"mappings":"AAGA,+DAUE;0BAbwB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_load_world_space_normal.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_world_space_normal.js"],"names":[],"mappings":"AAIA,+DAUE;0BAdwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_load_world_space_normal.js

@@ -1,5 +1,6 @@
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 import { chunk_decode_g_buffer_normal } from "../geometry/normal/chunk_decode_g_buffer_normal.js";
+import { SCREEN_NORMAL_RESOURCE } from "./SCREEN_SPACE_RESOURCES.js";
 
 export const chunk_ffx_sssr_load_world_space_normal = CodeChunk.from(
     //language=WGSL
@@ -11,4 +12,6 @@ fn ffx_sssr_load_world_space_normal(texel_coord: vec2<i32>)-> vec3<f32>{
     `, [
         chunk_decode_g_buffer_normal
     ]
-);
+);
+
+chunk_ffx_sssr_load_world_space_normal.requireResource(SCREEN_NORMAL_RESOURCE);

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_screen_space_to_view_space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_screen_space_to_view_space.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_screen_space_to_view_space.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wDAFU,SAAS,CAWlB;0BAhByB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_screen_space_to_view_space.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_screen_space_to_view_space.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wDAFU,SAAS,CAWlB;0BAjByB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_screen_space_to_view_space.js

@@ -1,5 +1,6 @@
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 import { chunk_inv_project_position } from "./chunk_inv_project_position.js";
+import { CAMERA_RESOURCE } from "../../../camera/CAMERA_RESOURCE.js";
 
 /**
  * TODO replace with {@link chunk_get_view_space_depth} / {@link chunk_get_view_space_position_uv}
@@ -14,4 +15,6 @@ fn ffx_sssr_screen_space_to_view_space(screen_space_position_uv: vec3<f32>) -> v
     `, [
         chunk_inv_project_position
     ]
-)
+)
+
+chunk_ffx_sssr_screen_space_to_view_space.requireResource(CAMERA_RESOURCE);

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_validate_hit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_validate_hit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_validate_hit.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH,gDAFU,SAAS,CAmBhB;AAEH,oEAoBC;AAGD;;;;;GAKG;AACH,gDAFU,SAAS,CAyDlB;AAED;;;;GAIG;AACH,0CAFU,SAAS,CAyBjB;0BA/IwB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_validate_hit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_validate_hit.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH,gDAFU,SAAS,CAmBhB;AAEH,oEAoBC;AAGD;;;;;GAKG;AACH,gDAFU,SAAS,CAyDlB;AAID;;;;GAIG;AACH,0CAFU,SAAS,CAyBjB;0BAlJwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_validate_hit.js

@@ -4,6 +4,7 @@ import { chunk_ffx_sssr_load_depth } from "./chunk_ffx_sssr_load_depth.js";
 import { chunk_ffx_sssr_load_world_space_normal } from "./chunk_ffx_sssr_load_world_space_normal.js";
 import { chunk_ffx_sssr_screen_space_to_view_space } from "./chunk_ffx_sssr_screen_space_to_view_space.js";
 import { chunk_uv_is_out_of_bounds } from "./chunk_uv_is_out_of_bounds.js";
+import { CAMERA_RESOURCE } from "../../../camera/CAMERA_RESOURCE.js";
 
 /**
  * @see https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK/blob/1bbe66e7ea0d358e84af4471a90aa9c35b583de0/samples/hybridreflections/shaders/ffx_sssr_intersect.h#L163
@@ -114,6 +115,8 @@ fn ffx_validate_screen_ray_hit(
     ]
 )
 
+chunk_ffx_validate_screen_ray_hit.requireResource(CAMERA_RESOURCE);
+
 /**
  * NOTE: default thickness from FFX is 0.015, see https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK/blob/1bbe66e7ea0d358e84af4471a90aa9c35b583de0/samples/sssr/sssrrendermodule.h#L72
  * @see https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK/blob/1bbe66e7ea0d358e84af4471a90aa9c35b583de0/samples/hybridreflections/shaders/ffx_sssr_intersect.h#L163

package/src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_scene_sdf_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js"],"names":[],"mappings":"AAoBA,iDAiGE;0BAjHwB,6BAA6B"}
+{"version":3,"file":"chunk_scene_sdf_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js"],"names":[],"mappings":"AAkBA,iDAiGE;0BAjHwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js

@@ -1,7 +1,5 @@
-import {
-        chunk_sdf_slot_index_to_texture_offset
-} from "../../../geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js";
 import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.js";
+import { chunk_tile_atlas_slot_origin } from "../../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 import { BVH_NULL_NODE_DEFINITION } from "../bvh/BVH_NULL_NODE_DEFINITION.js";
 import { BVH_TRAVERSAL_STACK_SIZE } from "../bvh/BVH_TRAVERSAL_STACK_SIZE.js";
@@ -75,7 +73,7 @@ fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
 
             // normalize position
 
-            let offset = sdf_slot_index_to_texture_offset(mesh.geometry, settings.sdf_atlas_resolution)*settings.sdf_tile_resolution;
+            let offset = tile_atlas_slot_origin(mesh.geometry, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
             let geometry_distance = sdf_raymarch(geometry_ray, texture_sdf,  offset,  vec3(settings.sdf_tile_resolution));
 
             // move point to world-space
@@ -107,7 +105,7 @@ fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
         chunk_mat4_inverse,
         chunk_aabb3_distance_to_ray,
         chunk_aabb3_unsigned_distance_to_point,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         chunk_sdf_texture_region_sample_linear_uv,
         chunk_array_to_aabb3,
         chunk_ray_transform_m4,

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_box.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Signed distance from a point to a box centred at the origin of its own frame, spanning
+ * `±half_extents` on each axis: negative inside. Inigo Quilez's exact box field, with
+ * `q = |p| − half_extents`:
+ *
+ *     d(p) = ‖max(q, 0)‖ + min(max(qx, qy, qz), 0)
+ *
+ * The WGSL twin of `sdf3_box` (`core/geom/3d/shape/sdf/sdf3_box.js`), same frame and same
+ * parameters. A box given by its corners re-centres first: `aabb3_signed_distance_to_point`.
+ *
+ * @see https://iquilezles.org/articles/distfunctions/
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_box: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sdf3_box.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sdf3_box.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf3_box.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,6BAFU,SAAS,CAajB;0BA3BwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_box.js

@@ -0,0 +1,28 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { chunk_max_v3 } from "../geometry/vec3/chunk_max_v3.js";
+
+/**
+ * Signed distance from a point to a box centred at the origin of its own frame, spanning
+ * `±half_extents` on each axis: negative inside. Inigo Quilez's exact box field, with
+ * `q = |p| − half_extents`:
+ *
+ *     d(p) = ‖max(q, 0)‖ + min(max(qx, qy, qz), 0)
+ *
+ * The WGSL twin of `sdf3_box` (`core/geom/3d/shape/sdf/sdf3_box.js`), same frame and same
+ * parameters. A box given by its corners re-centres first: `aabb3_signed_distance_to_point`.
+ *
+ * @see https://iquilezles.org/articles/distfunctions/
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_box = CodeChunk.from(
+    //language=WGSL
+    `
+fn sdf3_box(p: vec3<f32>, half_extents: vec3<f32>) -> f32 {
+    let q = abs(p) - half_extents;
+
+    return length(max(q, vec3(0.0))) + min(max_v3(q), 0.0);
+}
+    `, [
+        chunk_max_v3
+    ]
+);

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_capsule.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Signed distance from a point to a capsule about the **Y axis** of its own frame: negative inside.
+ * The capsule is a segment of length `height`, so `±height/2`, swept by a sphere of `radius`; its
+ * total extent along Y is `height + 2·radius`.
+ *
+ *     d(p) = ‖p − c(p)‖ − r,   c(p) = (0, clamp(y, −h/2, +h/2), 0)
+ *
+ * Collapsing Y onto the segment turns the capsule into a sphere about the nearest point on it, with
+ * no branch on which cap.
+ *
+ * The WGSL twin of `sdf3_capsule` (`core/geom/3d/shape/sdf/sdf3_capsule.js`), same frame and same
+ * parameters: `CapsuleShape3D`'s.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_capsule: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sdf3_capsule.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sdf3_capsule.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf3_capsule.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,iCAFU,SAAS,CAcjB;0BA7BwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_capsule.js

@@ -0,0 +1,30 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+
+/**
+ * Signed distance from a point to a capsule about the **Y axis** of its own frame: negative inside.
+ * The capsule is a segment of length `height`, so `±height/2`, swept by a sphere of `radius`; its
+ * total extent along Y is `height + 2·radius`.
+ *
+ *     d(p) = ‖p − c(p)‖ − r,   c(p) = (0, clamp(y, −h/2, +h/2), 0)
+ *
+ * Collapsing Y onto the segment turns the capsule into a sphere about the nearest point on it, with
+ * no branch on which cap.
+ *
+ * The WGSL twin of `sdf3_capsule` (`core/geom/3d/shape/sdf/sdf3_capsule.js`), same frame and same
+ * parameters: `CapsuleShape3D`'s.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_capsule = CodeChunk.from(
+    //language=WGSL
+    `
+fn sdf3_capsule(p: vec3<f32>, radius: f32, height: f32) -> f32 {
+    let half_height = height * 0.5;
+
+    // the offset from the nearest point on the segment: Y beyond the segment's end, if any
+    let offset = vec3(p.x, p.y - clamp(p.y, -half_height, half_height), p.z);
+
+    return length(offset) - radius;
+}
+    `
+);

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_cylinder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Signed distance from a point to a capped cylinder about the **Y axis** of its own frame: negative
+ * inside. `radius` across and `height` tall, so the flat caps sit at `±height/2`. Inigo Quilez's
+ * capped-cylinder field, with the radial and axial distances named:
+ *
+ *     dr = ‖(x, z)‖ − r          distance outside the infinite cylinder
+ *     da = |y| − h/2             distance outside the slab
+ *     d  = ‖max(dr, 0), max(da, 0)‖ + min(max(dr, da), 0)
+ *
+ * The WGSL twin of `sdf3_cylinder` (`core/geom/3d/shape/sdf/sdf3_cylinder.js`), same frame and same
+ * parameters.
+ *
+ * @see https://iquilezles.org/articles/distfunctions/
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_cylinder: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sdf3_cylinder.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_cylinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sdf3_cylinder.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf3_cylinder.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,kCAFU,SAAS,CAYjB;0BA3BwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_cylinder.js

@@ -0,0 +1,28 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+
+/**
+ * Signed distance from a point to a capped cylinder about the **Y axis** of its own frame: negative
+ * inside. `radius` across and `height` tall, so the flat caps sit at `±height/2`. Inigo Quilez's
+ * capped-cylinder field, with the radial and axial distances named:
+ *
+ *     dr = ‖(x, z)‖ − r          distance outside the infinite cylinder
+ *     da = |y| − h/2             distance outside the slab
+ *     d  = ‖max(dr, 0), max(da, 0)‖ + min(max(dr, da), 0)
+ *
+ * The WGSL twin of `sdf3_cylinder` (`core/geom/3d/shape/sdf/sdf3_cylinder.js`), same frame and same
+ * parameters.
+ *
+ * @see https://iquilezles.org/articles/distfunctions/
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_cylinder = CodeChunk.from(
+    //language=WGSL
+    `
+fn sdf3_cylinder(p: vec3<f32>, radius: f32, height: f32) -> f32 {
+    let radial = length(p.xz) - radius;
+    let axial = abs(p.y) - height * 0.5;
+
+    return length(max(vec2(radial, axial), vec2(0.0))) + min(max(radial, axial), 0.0);
+}
+    `
+);

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_sphere.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Signed distance from a point to a sphere of `radius` centred at the origin of its own frame:
+ * negative inside.
+ *
+ *     d(p) = ‖p‖ − r
+ *
+ * The WGSL twin of `sdf3_sphere` (`core/geom/3d/shape/sdf/sdf3_sphere.js`).
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_sphere: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sdf3_sphere.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_sphere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sdf3_sphere.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf3_sphere.js"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,gCAFU,SAAS,CASjB;0BAnBwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf3_sphere.js

@@ -0,0 +1,20 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+
+/**
+ * Signed distance from a point to a sphere of `radius` centred at the origin of its own frame:
+ * negative inside.
+ *
+ *     d(p) = ‖p‖ − r
+ *
+ * The WGSL twin of `sdf3_sphere` (`core/geom/3d/shape/sdf/sdf3_sphere.js`).
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sdf3_sphere = CodeChunk.from(
+    //language=WGSL
+    `
+fn sdf3_sphere(p: vec3<f32>, radius: f32) -> f32 {
+    return length(p) - radius;
+}
+    `
+);

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.d.ts

@@ -1,3 +1,10 @@
+/**
+ * A geometry's distance at uv in its tile of the SDF atlas: a corner-aligned trilinear tap, uv 0
+ * the centre of the tile's first texel and uv 1 the centre of its last. uv outside [0, 1] reads the
+ * tile's edge, so a caller that wants the distance past the tile adds its distance to the box after
+ * sampling. The far corner of the tap is clamped to the tile, so no read reaches a neighbour.
+ * @type {CodeChunk}
+ */
 export const chunk_sdf_texture_region_sample_linear_uv: CodeChunk;
 export const chunk_sdf_texture_region_sample_linear_uv_hardware: CodeChunk;
 import { CodeChunk } from "../../compiler/CodeChunk.js";

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sdf_texture_region_sample_linear_uv.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.js"],"names":[],"mappings":"AAKA,kEAmDE;AAGF,2EA0BE;0BArFwB,6BAA6B"}
+{"version":3,"file":"chunk_sdf_texture_region_sample_linear_uv.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.js"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wDAFU,SAAS,CAmBjB;AAGF,2EA0BE;0BA5DwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.js

@@ -1,8 +1,17 @@
 import { CodeChunk } from "../../compiler/CodeChunk.js";
-import { chunk_interpolate_bilinear_f32 } from "../texture/sample/chunk_interpolate_bilinear_f32.js";
-import { chunk_uv3_distance_to_bounds } from "./chunk_uv3_distance_to_bounds.js";
+import {
+    chunk_texture3d_trilinear_corners_corner_aligned,
+    chunk_texture3d_trilinear_interpolate
+} from "../texture/sample/chunk_texture3d_trilinear_corners.js";
 
 
+/**
+ * A geometry's distance at uv in its tile of the SDF atlas: a corner-aligned trilinear tap, uv 0
+ * the centre of the tile's first texel and uv 1 the centre of its last. uv outside [0, 1] reads the
+ * tile's edge, so a caller that wants the distance past the tile adds its distance to the box after
+ * sampling. The far corner of the tap is clamped to the tile, so no read reaches a neighbour.
+ * @type {CodeChunk}
+ */
 export const chunk_sdf_texture_region_sample_linear_uv = CodeChunk.from(
     //language=WGSL
     `
@@ -12,47 +21,13 @@ fn sdf_texture_region_sample_linear_uv(
     region_size: vec3<u32>,
     uv:vec3<f32>
 ) -> f32{
-    // UV might be outside of the sampling range of 0...1
-    // to get the correct result, we compute distance to the box bounds and then add it with the appropriate sign after sampling
-    
-    let uv_saturated = saturate(uv);
-
-    let max_texel = region_size - 1u;
-    
-    // get texel coordinates
-    let local_texel = uv_saturated * vec3<f32>(max_texel);
-    let texel_fraction = fract(local_texel);
-             
-    let p000 = vec3<u32>(local_texel);
-    let p100 = vec3(min(p000.x+1u, max_texel.x), p000.y, p000.z);
-    let p010 = vec3(p000.x, min(p000.y + 1u, max_texel.y), p000.z);
-    let p001 = vec3(p000.x, p000.y, min(p000.z + 1u, max_texel.z));
-    
-    let p110 = vec3(p100.x, p010.y, p000.z);
-    let p111 = vec3(p100.x, p010.y, p001.z);
-    let p101 = vec3(p100.x, p000.y, p001.z);
-    let p011 = vec3(p000.x, p010.y, p001.z);
-    
-    let t000 = textureLoad(texture_sdf, region_offset + p000, 0).r;
-    let t100 = textureLoad(texture_sdf, region_offset + p100, 0).r;
-    let t010 = textureLoad(texture_sdf, region_offset + p010, 0).r;
-    let t110 = textureLoad(texture_sdf, region_offset + p110, 0).r;
-    
-    let t001 = textureLoad(texture_sdf, region_offset + p001, 0).r;
-    let t101 = textureLoad(texture_sdf, region_offset + p101, 0).r;
-    let t011 = textureLoad(texture_sdf, region_offset + p011, 0).r;
-    let t111 = textureLoad(texture_sdf, region_offset + p111, 0).r;
-    
-    let z0 = interpolate_bilinear_f32(vec4(t000,t100, t010, t110), texel_fraction.xy);
-    let z1 = interpolate_bilinear_f32(vec4(t001,t101, t011, t111), texel_fraction.xy);
-    
-    let sampled_distance = mix(z0, z1, texel_fraction.z);
-    
-    return sampled_distance;
+    return texture3d_trilinear_interpolate(
+        texture3d_trilinear_corners_corner_aligned(texture_sdf, region_offset, region_size, uv)
+    );
 }
   `, [
-        chunk_interpolate_bilinear_f32,
-        chunk_uv3_distance_to_bounds,
+        chunk_texture3d_trilinear_corners_corner_aligned,
+        chunk_texture3d_trilinear_interpolate,
     ]
 );
 

package/src/shade/renderer/shader/chunk/sdf/chunk_shape_record_kind.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core's `ShapeRecordKind` values and `SHAPE_RECORD_HULL_PLANE_LIMIT` as WGSL constants, the one
+ * declaration every shape-record chunk shares (`chunk_shape_record_signed_distance`,
+ * `chunk_shape_record_local_bounds`), so a shader may include several of them.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shape_record_kind: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_shape_record_kind.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_shape_record_kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_shape_record_kind.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_shape_record_kind.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,sCAFU,SAAS,CAcjB;0BArBwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_shape_record_kind.js

@@ -0,0 +1,24 @@
+import { SHAPE_RECORD_HULL_PLANE_LIMIT } from "../../../../../core/geom/3d/shape/record/ShapeRecord.js";
+import { ShapeRecordKind } from "../../../../../core/geom/3d/shape/record/ShapeRecordKind.js";
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+
+/**
+ * Core's `ShapeRecordKind` values and `SHAPE_RECORD_HULL_PLANE_LIMIT` as WGSL constants, the one
+ * declaration every shape-record chunk shares (`chunk_shape_record_signed_distance`,
+ * `chunk_shape_record_local_bounds`), so a shader may include several of them.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shape_record_kind = CodeChunk.from(
+    //language=WGSL
+    `
+const SHAPE_RECORD_SPHERE: u32 = ${ShapeRecordKind.Sphere}u;
+const SHAPE_RECORD_CAPSULE: u32 = ${ShapeRecordKind.Capsule}u;
+const SHAPE_RECORD_BOX: u32 = ${ShapeRecordKind.Box}u;
+const SHAPE_RECORD_CYLINDER: u32 = ${ShapeRecordKind.Cylinder}u;
+const SHAPE_RECORD_PLANE: u32 = ${ShapeRecordKind.Plane}u;
+const SHAPE_RECORD_CONVEX_HULL: u32 = ${ShapeRecordKind.ConvexHull}u;
+
+const SHAPE_RECORD_HULL_PLANE_LIMIT: u32 = ${SHAPE_RECORD_HULL_PLANE_LIMIT}u;
+`
+);

package/src/shade/renderer/shader/chunk/sdf/chunk_shape_record_local_bounds.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A core shape record's box in its own local frame, ignoring pose: the WGSL twin of
+ * `shape_record_local_bounds` (`core/geom/3d/shape/record/`), branch for branch.
+ *
+ * - `shape_record_local_bounded(kind) -> bool`: whether the kind has a box at all. A plane has none:
+ *   its half-space is unbounded, and its caller bounds it some other way.
+ * - `shape_record_local_half_extents(kind, parameters) -> vec3<f32>`: the box's half extents; every
+ *   bounded kind's box is centred on the local origin. A sphere's radius on each axis; a capsule's
+ *   radius, and the radius plus half its segment along local Y; a box's half extents; a cylinder's
+ *   radius, and half its height along Y; a hull's bounding radius on each axis (the cube about the
+ *   sphere its record carries, since its planes alone do not say where its corners are). 0 for a
+ *   plane.
+ *
+ * `kind` is the record's `ShapeRecordKind` and `parameters` its `SHAPE_RECORD_PARAM_0..3`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shape_record_local_bounds: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_shape_record_local_bounds.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_shape_record_local_bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_shape_record_local_bounds.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_shape_record_local_bounds.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,8CAFU,SAAS,CAmCjB;0BArDwB,6BAA6B"}