@woosh/meep-engine 3.47.0 → 3.50.0

package/src/engine/physics/cloth/wind/ClothAmbientWind.js

@@ -1,185 +0,0 @@
-import { AbstractClothWind } from "./AbstractClothWind.js";
-
-/**
- * # The air everywhere a fluid simulation is not
- *
- * §10's fallback: "a `GlobalFluidEffector`-shaped ambient term — a constant
- * `wind` vector plus a small band-limited noise for gusting". The shape is
- * deliberate. `GlobalFluidEffector` with a `wind` and a `drag` makes every fluid
- * field relax *toward* `wind`, so a field with one in the scene already reads
- * `wind` away from whatever is disturbing it — which means this is not an
- * approximation of the simulation, it is **the same far field the simulation
- * has**, evaluated where no simulation exists. A cloth walking out of a fluid
- * volume walks into the volume's own ambient rather than into still air.
- *
- * ## The gust is three sinusoids, not a noise function
- *
- * "Band-limited" is exactly what a sum of sinusoids is, and the three properties
- * that matters for here are all free: it is bounded (so `gust` is a real
- * amplitude rather than a scale factor over an unbounded tail), it is smooth
- * (so a settled banner is lifted rather than kicked), and it carries **no
- * state** — `g(t)` is a pure function of the cloth world's own fixed-step clock,
- * which is what lets two systems sharing this source produce bit-identical
- * cloth. A value-noise lattice would need a seed and an interpolation rule to
- * buy the same three.
- *
- * The three components sit at 1, 2.41 and 5.83 times the base frequency, which
- * are mutually irrational enough that the pattern does not visibly repeat, and
- * the three axes are offset in phase so the gust turns as well as pulses. It is
- * the cheapest thing that reads as weather; it is not turbulence, and a scene
- * that wants turbulence has a fluid simulator.
- *
- * The clock `g(t)` reads is the **asking cloth's own age**, handed in per
- * sample, not a clock this object holds — see {@link AbstractClothWind} for the
- * parity argument. The visible consequence is that two garments spawned a second
- * apart are a second apart in the gust rather than in phase with it, which for a
- * bounded sum of sinusoids is indistinguishable from weather and is the reason
- * this costs nothing to make true.
- *
- * ## Uniform in space, and that is the interesting limit
- *
- * {@link varies} is always `false`, so a whole garment costs **one** sample —
- * which is what makes the no-simulation case essentially free on the main thread
- * regardless of particle count (`MEASUREMENTS.md` §47). The cost is that the
- * whole cloth is lifted together and a long banner does not see a gust arrive at
- * one end before the other. Spatial structure is the thing a fluid field has and
- * this does not, and §10's argument is that building a second, worse one here
- * would be the duplication the design exists to avoid.
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export class ClothAmbientWind extends AbstractClothWind {
-
-    /**
-     * Prevailing wind, world-space metres per second. The same quantity and the
-     * same units as `GlobalFluidEffector#wind`.
-     * @type {Float64Array}
-     */
-    wind = new Float64Array(3);
-
-    /**
-     * Peak gust speed on top of {@link wind}, metres per second. The gust is
-     * bounded by exactly this — the component amplitudes below sum to one — so
-     * the air's speed never leaves `|wind| ± gust`.
-     * @type {number}
-     */
-    gust = 0;
-
-    /**
-     * Period of the gust's slowest component, seconds. Four is a breeze that
-     * arrives and leaves a few times a minute; a fraction of a second is a
-     * flutter.
-     * @type {number}
-     */
-    period = 4;
-
-    /**
-     * @param {number} time
-     * @param {EntityComponentDataset} [ecd]
-     * @returns {void}
-     */
-    begin(time, ecd) {
-        // Nothing to refresh: the gust is a pure function of the time each
-        // sample is taken at, and there is no scene to walk.
-    }
-
-    /**
-     * Always `false`: the ambient is one vector for the whole world at any
-     * instant, so one sample describes a garment exactly rather than
-     * approximately.
-     *
-     * @returns {boolean}
-     */
-    varies() {
-        return false;
-    }
-
-    /**
-     * @param {Float64Array|number[]} out
-     * @param {number} x unused — the ambient has no spatial structure
-     * @param {number} y
-     * @param {number} z
-     * @param {number} time seconds the asking cloth has stepped
-     * @returns {Float64Array|number[]}
-     */
-    sample(out, x, y, z, time) {
-        const wind = this.wind;
-
-        out[0] = wind[0];
-        out[1] = wind[1];
-        out[2] = wind[2];
-
-        const gust = this.gust;
-
-        if (gust === 0) {
-            return out;
-        }
-
-        const period = this.period > 0 ? this.period : 1;
-
-        const w = 2 * Math.PI * time / period;
-
-        for (let axis = 0; axis < 3; axis++) {
-            const phase = PHASE[axis];
-
-            out[axis] += gust * (
-                AMPLITUDE_0 * Math.sin(w * RATE_0 + phase)
-                + AMPLITUDE_1 * Math.sin(w * RATE_1 + phase * 2)
-                + AMPLITUDE_2 * Math.sin(w * RATE_2 + phase * 3)
-            );
-        }
-
-        return out;
-    }
-}
-
-/**
- * Component rates, as multiples of the base frequency. Mutually irrational
- * enough that the sum's own period is far longer than anyone watches.
- * @type {number}
- * @private
- */
-const RATE_0 = 1;
-
-/**
- * @type {number}
- * @private
- */
-const RATE_1 = 2.41;
-
-/**
- * @type {number}
- * @private
- */
-const RATE_2 = 5.83;
-
-/**
- * Component amplitudes. They sum to exactly one, which is what makes
- * {@link ClothAmbientWind#gust} a bound rather than a scale — a pink-ish
- * `1 : 1/2 : 1/4` normalised by its own total.
- * @type {number}
- * @private
- */
-const AMPLITUDE_0 = 4 / 7;
-
-/**
- * @type {number}
- * @private
- */
-const AMPLITUDE_1 = 2 / 7;
-
-/**
- * @type {number}
- * @private
- */
-const AMPLITUDE_2 = 1 / 7;
-
-/**
- * Per-axis phase offsets, so the three axes are not a single pulse along the
- * diagonal. Thirds of a turn, scaled per component so the axes stay apart at
- * every rate rather than only at the slowest.
- * @type {number[]}
- * @private
- */
-const PHASE = [0, 2 * Math.PI / 3, 4 * Math.PI / 3];

package/src/shade/renderer/geometry/sdf/chunk_sdf_slot_index_to_texture_offset.d.ts

@@ -1,7 +0,0 @@
-/**
- * TODO align with {@link chunk_index_to_grid3d}
- * @type {CodeChunk}
- */
-export const chunk_sdf_slot_index_to_texture_offset: CodeChunk;
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-//# sourceMappingURL=chunk_sdf_slot_index_to_texture_offset.d.ts.map

package/src/shade/renderer/geometry/sdf/chunk_sdf_slot_index_to_texture_offset.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk_sdf_slot_index_to_texture_offset.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qDAFU,SAAS,CAmBjB;0BAxBwB,oCAAoC"}

package/src/shade/renderer/geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js

@@ -1,25 +0,0 @@
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-
-
-/**
- * TODO align with {@link chunk_index_to_grid3d}
- * @type {CodeChunk}
- */
-export const chunk_sdf_slot_index_to_texture_offset = CodeChunk.from(
-    //language=WGSL
-    `
-fn sdf_slot_index_to_texture_offset(slot_index:u32, texture_slot_resolution:vec3<u32>) -> vec3<u32>{
-
-    let slice_size = texture_slot_resolution.x * texture_slot_resolution.y;
-    
-    let slot_offset_z = slot_index / slice_size;
-    
-    let index_in_slice = slot_index - slot_offset_z*slice_size;
-    
-    let slot_offset_y = index_in_slice / texture_slot_resolution.x;
-    let slot_offset_x = slot_index % texture_slot_resolution.x;
-    
-    return vec3(slot_offset_x, slot_offset_y, slot_offset_z);
-}
-    `
-);

package/src/shade/renderer/global_illumination/clipmap/GPUClipMap3D.d.ts

@@ -1,43 +0,0 @@
-export class GPUClipMap3D {
-    /**
-     *
-     * @param {GPUDevice} device
-     */
-    constructor(device: GPUDevice);
-    /**
-     *
-     * @return {GPUTextureContext}
-     */
-    get texture(): GPUTextureContext;
-    /**
-     *
-     * @return {GPUTypedBuffer}
-     */
-    get metadata(): GPUTypedBuffer;
-    update(): void;
-    /**
-     *
-     * @param {number} v
-     */
-    set cascade_resolution(v: number);
-    /**
-     *
-     * @return {number}
-     */
-    get cascade_resolution(): number;
-    /**
-     *
-     * @param {number} v
-     */
-    set cascade_count(v: number);
-    /**
-     *
-     * @return {number}
-     */
-    get cascade_count(): number;
-    destroy(): void;
-    #private;
-}
-import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
-import { GPUTypedBuffer } from "../../buffer/GPUTypedBuffer.js";
-//# sourceMappingURL=GPUClipMap3D.d.ts.map

package/src/shade/renderer/global_illumination/clipmap/GPUClipMap3D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GPUClipMap3D.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/GPUClipMap3D.js"],"names":[],"mappings":"AAMA;IA4DI;;;OAGG;IACH,+BAiCC;IA/DD;;;OAGG;IACH,iCAIC;IAQD;;;OAGG;IACH,+BAIC;IAyCD,eAOC;IAuCD;;;OAGG;IACH,kCAWC;IAED;;;OAGG;IACH,iCAEC;IAED;;;OAGG;IACH,6BAYC;IAED;;;OAGG;IACH,4BAEC;IAED,gBAGC;;CACJ;kCA3MiC,oCAAoC;+BADvC,gCAAgC"}

package/src/shade/renderer/global_illumination/clipmap/GPUClipMap3D.js

@@ -1,207 +0,0 @@
-import { assert } from "../../../../core/assert.js";
-import { queue_typed_buffer_update } from "../../shader/type/queue_typed_buffer_update.js";
-import { GPUTypedBuffer } from "../../buffer/GPUTypedBuffer.js";
-import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
-import { CLIPMAP_MAX_CASCADES, CLIPMAP_METADATA } from "./CLIPMAP_METADATA.js";
-
-export class GPUClipMap3D {
-    /**
-     * Size of an individual voxel in cascade 0, in world units
-     * @type {number}
-     */
-    #initial_voxel_size = 0.5;
-    /**
-     *
-     * @type {number}
-     */
-    #cascade_resolution = 4;
-
-    /**
-     *
-     * @type {number}
-     */
-    #cascade_count = 16;
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #clipmap_texture;
-
-    /**
-     * @type {GPUDevice}
-     */
-    #device;
-
-    /**
-     *
-     * @type {boolean}
-     */
-    #needs_update = false;
-
-    /**
-     *
-     * @return {GPUTextureContext}
-     */
-    get texture() {
-        this.update();
-
-        return this.#clipmap_texture;
-    }
-
-
-    /**
-     * @type {GPUTypedBuffer}
-     */
-    #metadata
-
-    /**
-     *
-     * @return {GPUTypedBuffer}
-     */
-    get metadata() {
-        this.update();
-
-        return this.#metadata;
-    }
-
-    /**
-     *
-     * @param {GPUDevice} device
-     */
-    constructor(device) {
-        assert.defined(device, 'device');
-
-        this.#device = device;
-
-        const texture = new GPUTextureContext(device);
-        this.#clipmap_texture = texture;
-
-        const td = texture.descriptor;
-        td.dimension = "3d";
-        td.usage =
-            GPUTextureUsage.TEXTURE_BINDING
-            | GPUTextureUsage.STORAGE_BINDING
-            | GPUTextureUsage.COPY_DST
-        ;
-        td.format = "r32uint"; // indirection ID
-
-
-        /**
-         * static number of cascades to avoid having to re-compile shaders, and to be able to use Uniform storage
-         * @type {GPUTypedBuffer}
-         */
-        this.#metadata = GPUTypedBuffer.create({
-            label: "Clipmap / Cascade metadata",
-            type: CLIPMAP_METADATA,
-            device: this.#device,
-            usage: GPUBufferUsage.COPY_SRC
-                | GPUBufferUsage.UNIFORM
-                | GPUBufferUsage.STORAGE
-                | GPUBufferUsage.COPY_DST,
-        });
-
-        this.#needs_update = true;
-    }
-
-    update() {
-        if (!this.#needs_update) {
-            return;
-        }
-
-        this.#needs_update = false;
-        this.#rebuild();
-    }
-
-
-    #rebuild() {
-
-        const r = this.#cascade_resolution;
-        this.#clipmap_texture.resize(
-            r, r, r * this.#cascade_count,
-            false // data would not be valid, so no point in attempting to preserve it
-        );
-
-        const metadata = {
-            cascades: [],
-            cascade_count: this.#cascade_count,
-            cascade_resolution: this.#cascade_resolution,
-        };
-
-        for (let i = 0; i < CLIPMAP_MAX_CASCADES; i++) {
-            metadata.cascades.push({
-                index: i,
-                voxel_size: Math.pow(2, i) * this.#initial_voxel_size
-            });
-        }
-
-        metadata.cascades[0].offset = [-1, 0, 6];
-
-        queue_typed_buffer_update(
-            this.#device.queue,
-            this.#metadata,
-            metadata,
-        );
-
-        // inspect_gpu_buffer_typed({
-        //     buffer: this.#metadata.buffer,
-        //     device: this.#device,
-        //     type: this.#metadata.type,
-        // }).then(console.warn);
-    }
-
-    /**
-     *
-     * @param {number} v
-     */
-    set cascade_resolution(v) {
-        assert.isNonNegativeInteger(v, 'v');
-        assert.greaterThan(v, 0);
-
-        if (this.#cascade_resolution === v) {
-            // no change
-            return;
-        }
-
-        this.#cascade_resolution = v;
-        this.#needs_update = true;
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    get cascade_resolution() {
-        return this.#cascade_resolution;
-    }
-
-    /**
-     *
-     * @param {number} v
-     */
-    set cascade_count(v) {
-        assert.isNonNegativeInteger(v, 'v');
-        assert.greaterThan(v, 0);
-
-        if (this.#cascade_count === v) {
-            // no change
-            return;
-        }
-
-        this.#cascade_count = v;
-
-        this.#needs_update = true;
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    get cascade_count() {
-        return this.#cascade_count;
-    }
-
-    destroy() {
-        this.#clipmap_texture.destroy();
-        this.#metadata.destroy();
-    }
-}

package/src/shade/renderer/global_illumination/clipmap/RadianceField.d.ts

@@ -1,21 +0,0 @@
-/**
- * 3d Clipmaps of probes
- * Probes spawned on request and reside in an atlas
- */
-export class GPURadianceField {
-    /**
-     *
-     * @param {GPUDevice} device
-     */
-    constructor(device: GPUDevice);
-    /**
-     *
-     * @return {GPUClipMap3D}
-     */
-    get clipmap(): GPUClipMap3D;
-    destroy(): void;
-    update(): void;
-    #private;
-}
-import { GPUClipMap3D } from "./GPUClipMap3D.js";
-//# sourceMappingURL=RadianceField.d.ts.map

package/src/shade/renderer/global_illumination/clipmap/RadianceField.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RadianceField.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/RadianceField.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAeI;;;OAGG;IACH,+BAIC;IAhBD;;;OAGG;IACH,4BAEC;IAYD,gBAEC;IAGD,eAEC;;CACJ;6BAvC4B,mBAAmB"}

package/src/shade/renderer/global_illumination/clipmap/RadianceField.js

@@ -1,40 +0,0 @@
-import { GPUClipMap3D } from "./GPUClipMap3D.js";
-
-/**
- * 3d Clipmaps of probes
- * Probes spawned on request and reside in an atlas
- */
-export class GPURadianceField {
-
-    /**
-     * @type {GPUClipMap3D}
-     */
-    #clipmap;
-
-    /**
-     *
-     * @return {GPUClipMap3D}
-     */
-    get clipmap() {
-        return this.#clipmap;
-    }
-
-    /**
-     *
-     * @param {GPUDevice} device
-     */
-    constructor(device) {
-        this.#clipmap = new GPUClipMap3D(device);
-
-        this.#clipmap.update();
-    }
-
-    destroy() {
-        this.#clipmap.destroy();
-    }
-
-
-    update() {
-
-    }
-}

package/src/shade/renderer/global_illumination/clipmap/chunk_clip_cascade_wrap_coord.d.ts

@@ -1,13 +0,0 @@
-/**
- * NOTE: resolution must be power of two
- * coord_ws is discretized world-space position in voxels
- * @type {CodeChunk}
- */
-export const chunk_clip_cascade_coord_encode: CodeChunk;
-/**
- *
- * @type {CodeChunk}
- */
-export const chunk_clip_cascade_decode: CodeChunk;
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-//# sourceMappingURL=chunk_clip_cascade_wrap_coord.d.ts.map

package/src/shade/renderer/global_illumination/clipmap/chunk_clip_cascade_wrap_coord.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk_clip_cascade_wrap_coord.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/chunk_clip_cascade_wrap_coord.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,8CAFU,SAAS,CAoBjB;AAEF;;;GAGG;AACH,wCAFU,SAAS,CAgBjB;0BA7CwB,oCAAoC"}

package/src/shade/renderer/global_illumination/clipmap/chunk_clip_cascade_wrap_coord.js

@@ -1,47 +0,0 @@
-import { chunk_mod_v3i } from "../../shader/chunk/geometry/vec3/chunk_mod_v3i.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-
-/**
- * NOTE: resolution must be power of two
- * coord_ws is discretized world-space position in voxels
- * @type {CodeChunk}
- */
-export const chunk_clip_cascade_coord_encode = CodeChunk.from(
-    //language=WGSL
-    `
-fn clip_cascade_coord_encode(
-    coord_ws: vec3<i32>,
-    resolution: u32,
-    world_offset: vec3<i32>
-) -> vec3<u32> {
-    
-    let scrolled = mod_v3i(world_offset + coord_ws, vec3(i32(resolution)));
-    
-    let centered = vec3u(scrolled) + ( resolution >> 1);
-    
-    return centered;
-}
-    `, [
-        chunk_mod_v3i
-    ]
-);
-
-/**
- *
- * @type {CodeChunk}
- */
-export const chunk_clip_cascade_decode = CodeChunk.from(
-//language=WGSL
-    `
-fn clip_cascade_coord_decode(
-    voxel_coord: vec3<u32>,
-    resolution: u32,
-    world_offset: vec3<i32>
-) -> vec3<i32>{
-
-
-}
-    `, [
-        chunk_mod_v3i
-    ]
-);

package/src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.d.ts

@@ -1,7 +0,0 @@
-/**
- * Update cascade offset, and clear out any voxels that scroll out
- * @type {ComputeShader}
- */
-export const shader_update_clipmap_cascade: ComputeShader;
-import { ComputeShader } from "../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_update_clipmap_cascade.d.ts.map

package/src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shader_update_clipmap_cascade.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.js"],"names":[],"mappings":"AA0GA;;;GAGG;AACH,4CAFU,aAAa,CAMpB;8BA/G2B,+BAA+B"}