@woosh/meep-engine 3.39.0 → 3.40.0

package/src/shade/renderer/water/surface/WATER_SURFACE_VERTEX_STRUCT.js

@@ -1,27 +0,0 @@
-import { vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-
-/**
- * One vertex of a water surface: what every surface producer writes and the water draws read.
- *
- * This and a producer-owned index buffer are the whole surface interface
- * (WATER_OPTICS_PLAN_2026_10_02.md §7.2). A producer that is not a height field writes the same
- * record, so the draws never learn which producer ran.
- *
- * @type {WebGPUStruct}
- */
-export const WATER_SURFACE_VERTEX_STRUCT = WebGPUStruct.from({
-    /**
-     * World position in `xyz`. `w` is the slope variance of the waves this mesh does not resolve,
-     * which the shading adds to its roughness.
-     */
-    position: vec4f,
-    /**
-     * Last frame's world position in `xyz`, for motion vectors. `w` is unused.
-     */
-    previous: vec4f,
-    /**
-     * Unit world normal in `xyz`. `w` is unused.
-     */
-    normal: vec4f,
-}, "WaterSurfaceVertex");

package/src/shade/renderer/water/surface/WATER_WAVE_PARAMETERS_STRUCT.d.ts

@@ -1,14 +0,0 @@
-/**
- * Most impulses one body applies in one step.
- * @type {number}
- */
-export const WATER_WAVE_IMPULSE_LIMIT: number;
-/**
- * Per-body, per-step inputs of the primitive wave producer: its grid, the terrain it floods, the
- * step and the forcing.
- *
- * @type {WebGPUStruct}
- */
-export const WATER_WAVE_PARAMETERS_STRUCT: WebGPUStruct;
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-//# sourceMappingURL=WATER_WAVE_PARAMETERS_STRUCT.d.ts.map

package/src/shade/renderer/water/surface/WATER_WAVE_PARAMETERS_STRUCT.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WATER_WAVE_PARAMETERS_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/WATER_WAVE_PARAMETERS_STRUCT.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,uCAFU,MAAM,CAE2B;AAE3C;;;;;GAKG;AACH,2CAFU,YAAY,CAkCI;6BA9CG,mCAAmC"}

package/src/shade/renderer/water/surface/WATER_WAVE_PARAMETERS_STRUCT.js

@@ -1,49 +0,0 @@
-import { f32, u32, vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-
-/**
- * Most impulses one body applies in one step.
- * @type {number}
- */
-export const WATER_WAVE_IMPULSE_LIMIT = 16;
-
-/**
- * Per-body, per-step inputs of the primitive wave producer: its grid, the terrain it floods, the
- * step and the forcing.
- *
- * @type {WebGPUStruct}
- */
-export const WATER_WAVE_PARAMETERS_STRUCT = WebGPUStruct.from({
-    /** world-space grid rectangle: min x, min z, max x, max z */
-    extent: vec4f,
-    /** terrain height texture coordinates of the grid: `uv * zw + xy` */
-    height_uv: vec4f,
-    /** wind direction x, z (unit); forcing amplitude, m/s²; forcing drift speed, m/s */
-    forcing: vec4f,
-    /** queued impulses: world x, world z, radius m, velocity kick m/s */
-    impulses: WebGPUArray.from(vec4f, WATER_WAVE_IMPULSE_LIMIT),
-    /** rest height of the surface */
-    level: f32,
-    /** distance between neighbouring vertices, m */
-    spacing: f32,
-    /** step, s */
-    dt: f32,
-    /** simulated time, s */
-    time: f32,
-    /** damping rate everywhere, 1/s */
-    damping: f32,
-    /** border band of extra damping, vertices */
-    sponge_width: f32,
-    /** damping at the border, 1/s */
-    sponge_strength: f32,
-    /** largest celerity the step stays stable at, m/s */
-    celerity_limit: f32,
-    /** slope variance of the waves the grid does not resolve */
-    unresolved_variance: f32,
-    /** vertices along each side */
-    resolution: u32,
-    impulse_count: u32,
-    /** 1 on the first write after the body's buffers were created, so `previous` starts at `position` */
-    first_write: u32,
-}, "WaterWaveParameters");

package/src/shade/renderer/water/surface/chunk_water_wave_grid.d.ts

@@ -1,9 +0,0 @@
-/**
- * Grid addressing, terrain lookup and forcing of the primitive wave producer. Expects `params`
- * ({@link WATER_WAVE_PARAMETERS_STRUCT}), `terrain_height` and `height_sampler` bound.
- *
- * @type {CodeChunk}
- */
-export const chunk_water_wave_grid: CodeChunk;
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-//# sourceMappingURL=chunk_water_wave_grid.d.ts.map

package/src/shade/renderer/water/surface/chunk_water_wave_grid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk_water_wave_grid.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/chunk_water_wave_grid.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,oCAFU,SAAS,CAuCG;0BA9CI,oCAAoC"}

package/src/shade/renderer/water/surface/chunk_water_wave_grid.js

@@ -1,47 +0,0 @@
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { chunk_srdnoise2 } from "../../shader/chunk/noise/psrdnoise/chunk_srdnoise2.js";
-
-/**
- * Grid addressing, terrain lookup and forcing of the primitive wave producer. Expects `params`
- * ({@link WATER_WAVE_PARAMETERS_STRUCT}), `terrain_height` and `height_sampler` bound.
- *
- * @type {CodeChunk}
- */
-export const chunk_water_wave_grid = CodeChunk.from(/* language=WGSL */ `
-// Spatial scale of the wind's pressure pattern, m.
-const WATER_WAVE_FORCING_SCALE: f32 = 6.0;
-
-fn water_wave_grid_uv(cell: vec2<u32>) -> vec2<f32> {
-    return vec2<f32>(cell) / f32(params.resolution - 1u);
-}
-
-fn water_wave_world(cell: vec2<u32>) -> vec2<f32> {
-    return mix(params.extent.xy, params.extent.zw, water_wave_grid_uv(cell));
-}
-
-fn water_wave_terrain(cell: vec2<u32>) -> f32 {
-    let uv = water_wave_grid_uv(cell) * params.height_uv.zw + params.height_uv.xy;
-    return textureSampleLevel(terrain_height, height_sampler, uv, 0.0).r;
-}
-
-// Clamped at the grid's edge, which reflects; the sponge band absorbs before waves get there.
-fn water_wave_index(cell: vec2<i32>) -> u32 {
-    let n = i32(params.resolution);
-    let c = clamp(cell, vec2<i32>(0), vec2<i32>(n - 1));
-    return u32(c.y * n + c.x);
-}
-
-// Wind: a pressure pattern drifting downwind, plus this step's impulses as velocity kicks spread
-// over one step.
-fn water_wave_force(world: vec2<f32>) -> f32 {
-    let drift = params.forcing.xy * params.forcing.w * params.time;
-    var force = params.forcing.z * srdnoise2((world - drift) / WATER_WAVE_FORCING_SCALE, 0.0).x;
-    for (var i = 0u; i < params.impulse_count; i++) {
-        let impulse = params.impulses[i];
-        let r = max(impulse.z, 1e-3);
-        let d = world - impulse.xy;
-        force += impulse.w / params.dt * exp(-dot(d, d) / (r * r));
-    }
-    return force;
-}
-`, [chunk_srdnoise2]);

package/src/shade/renderer/water/surface/shader_water_surface_write.d.ts

@@ -1,10 +0,0 @@
-/**
- * Writes the surface interface from the primitive producer's heights: the vertex record every
- * water draw reads. A dry vertex sits at the rest level, under the terrain, where the opaque depth
- * hides it.
- *
- * @type {ComputeShader}
- */
-export const shader_water_surface_write: ComputeShader;
-import { ComputeShader } from "../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_water_surface_write.d.ts.map

package/src/shade/renderer/water/surface/shader_water_surface_write.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_water_surface_write.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/shader_water_surface_write.js"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,yCAFU,aAAa,CA2BpB;8BAlD2B,+BAA+B"}

package/src/shade/renderer/water/surface/shader_water_surface_write.js

@@ -1,51 +0,0 @@
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { f32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { chunk_water_wave } from "./chunk_water_wave.js";
-import { chunk_water_wave_grid } from "./chunk_water_wave_grid.js";
-import { WATER_SURFACE_VERTEX_STRUCT } from "./WATER_SURFACE_VERTEX_STRUCT.js";
-import { WATER_WAVE_PARAMETERS_STRUCT } from "./WATER_WAVE_PARAMETERS_STRUCT.js";
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("params", WATER_WAVE_PARAMETERS_STRUCT)
-    .addTexture("terrain_height", "float")
-    .addSampler("height_sampler")
-    .addStorageBuffer("state", WebGPUArray.from(f32), false)
-    .addStorageBuffer("vertices", WebGPUArray.from(WATER_SURFACE_VERTEX_STRUCT), true);
-
-/**
- * Writes the surface interface from the primitive producer's heights: the vertex record every
- * water draw reads. A dry vertex sits at the rest level, under the terrain, where the opaque depth
- * hides it.
- *
- * @type {ComputeShader}
- */
-export const shader_water_surface_write = ComputeShader.from({
-    label: "Water / surface write",
-    resources,
-    body: CodeChunk.from(/* language=WGSL */ `
-fn water_surface_height_at(cell: vec2<i32>) -> f32 {
-    return params.level + state[water_wave_index(cell)];
-}
-
-@compute @workgroup_size(8, 8)
-fn main(@builtin(global_invocation_id) id: vec3<u32>) {
-    let n = params.resolution;
-    if (any(id.xy >= vec2<u32>(n))) { return; }
-    let cell = vec2<i32>(id.xy);
-    let index = water_wave_index(cell);
-    let world = water_wave_world(id.xy);
-    let position = vec3<f32>(world.x, water_surface_height_at(cell), world.y);
-    let normal = water_wave_normal(
-        water_surface_height_at(cell - vec2<i32>(1, 0)), water_surface_height_at(cell + vec2<i32>(1, 0)),
-        water_surface_height_at(cell - vec2<i32>(0, 1)), water_surface_height_at(cell + vec2<i32>(0, 1)),
-        params.spacing);
-    let previous = select(vertices[index].position.xyz, position, params.first_write != 0u);
-    vertices[index] = WaterSurfaceVertex(vec4<f32>(position, params.unresolved_variance),
-        vec4<f32>(previous, 0.0), vec4<f32>(normal, 0.0));
-}
-`, [chunk_water_wave, chunk_water_wave_grid]),
-});

package/src/shade/renderer/water/surface/shader_water_wave_step.d.ts

@@ -1,12 +0,0 @@
-/**
- * One step of the primitive wave producer. Reads the current heights and overwrites the previous
- * ones with the next: each thread reads only its own previous height, so the two buffers alternate
- * roles step to step without a third.
- *
- * Dry vertices hold zero displacement, which makes the shore a reflecting boundary.
- *
- * @type {ComputeShader}
- */
-export const shader_water_wave_step: ComputeShader;
-import { ComputeShader } from "../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_water_wave_step.d.ts.map

package/src/shade/renderer/water/surface/shader_water_wave_step.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_water_wave_step.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/shader_water_wave_step.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,qCAFU,aAAa,CA6BpB;8BArD2B,+BAA+B"}

package/src/shade/renderer/water/surface/shader_water_wave_step.js

@@ -1,54 +0,0 @@
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { f32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { chunk_water_wave } from "./chunk_water_wave.js";
-import { chunk_water_wave_grid } from "./chunk_water_wave_grid.js";
-import { WATER_WAVE_PARAMETERS_STRUCT } from "./WATER_WAVE_PARAMETERS_STRUCT.js";
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("params", WATER_WAVE_PARAMETERS_STRUCT)
-    .addTexture("terrain_height", "float")
-    .addSampler("height_sampler")
-    .addStorageBuffer("state_current", WebGPUArray.from(f32), false)
-    .addStorageBuffer("state_previous", WebGPUArray.from(f32), true);
-
-/**
- * One step of the primitive wave producer. Reads the current heights and overwrites the previous
- * ones with the next: each thread reads only its own previous height, so the two buffers alternate
- * roles step to step without a third.
- *
- * Dry vertices hold zero displacement, which makes the shore a reflecting boundary.
- *
- * @type {ComputeShader}
- */
-export const shader_water_wave_step = ComputeShader.from({
-    label: "Water / wave step",
-    resources,
-    body: CodeChunk.from(/* language=WGSL */ `
-@compute @workgroup_size(8, 8)
-fn main(@builtin(global_invocation_id) id: vec3<u32>) {
-    let n = params.resolution;
-    if (any(id.xy >= vec2<u32>(n))) { return; }
-    let cell = vec2<i32>(id.xy);
-    let index = water_wave_index(cell);
-    let depth = params.level - water_wave_terrain(id.xy);
-    if (depth <= 0.0) {
-        state_previous[index] = 0.0;
-        return;
-    }
-    let h = state_current[index];
-    let neighbours = state_current[water_wave_index(cell + vec2<i32>(1, 0))]
-        + state_current[water_wave_index(cell - vec2<i32>(1, 0))]
-        + state_current[water_wave_index(cell + vec2<i32>(0, 1))]
-        + state_current[water_wave_index(cell - vec2<i32>(0, 1))];
-    let laplacian = (neighbours - 4.0 * h) / (params.spacing * params.spacing);
-    let damping = params.damping + water_wave_sponge(id.xy, n, params.sponge_width, params.sponge_strength);
-    state_previous[index] = water_wave_step(h, state_previous[index], laplacian,
-        water_wave_celerity2(depth, params.celerity_limit), damping,
-        water_wave_force(water_wave_world(id.xy)), params.dt);
-}
-`, [chunk_water_wave, chunk_water_wave_grid]),
-});

package/src/shade/renderer/water/surface/water_surface_grid_indices.d.ts

@@ -1,13 +0,0 @@
-/**
- * Triangle indices of a regular `resolution × resolution` vertex grid, vertices numbered row by
- * row (`index = y * resolution + x`). Two triangles a cell, split along the same diagonal
- * everywhere, so neighbouring cells share their edges exactly.
- *
- * @param {Object} options
- * @param {number} options.resolution vertices along each side, at least 2
- * @returns {Uint32Array} `(resolution - 1)² · 6` indices
- */
-export function water_surface_grid_indices({ resolution }: {
-    resolution: number;
-}): Uint32Array;
-//# sourceMappingURL=water_surface_grid_indices.d.ts.map

package/src/shade/renderer/water/surface/water_surface_grid_indices.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"water_surface_grid_indices.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/water/surface/water_surface_grid_indices.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH;IAH2B,UAAU,EAA1B,MAAM;IACJ,WAAW,CA6BvB"}

package/src/shade/renderer/water/surface/water_surface_grid_indices.js

@@ -1,39 +0,0 @@
-import { assert } from "../../../../core/assert.js";
-
-/**
- * Triangle indices of a regular `resolution × resolution` vertex grid, vertices numbered row by
- * row (`index = y * resolution + x`). Two triangles a cell, split along the same diagonal
- * everywhere, so neighbouring cells share their edges exactly.
- *
- * @param {Object} options
- * @param {number} options.resolution vertices along each side, at least 2
- * @returns {Uint32Array} `(resolution - 1)² · 6` indices
- */
-export function water_surface_grid_indices({ resolution }) {
-    assert.isInteger(resolution, 'resolution');
-    assert.greaterThanOrEqual(resolution, 2, 'resolution');
-
-    const cells = resolution - 1;
-    const indices = new Uint32Array(cells * cells * 6);
-
-    let cursor = 0;
-
-    for (let y = 0; y < cells; y++) {
-        for (let x = 0; x < cells; x++) {
-            const a = y * resolution + x;
-            const b = a + 1;
-            const c = a + resolution;
-            const d = c + 1;
-
-            indices[cursor++] = a;
-            indices[cursor++] = c;
-            indices[cursor++] = b;
-
-            indices[cursor++] = b;
-            indices[cursor++] = c;
-            indices[cursor++] = d;
-        }
-    }
-
-    return indices;
-}