@woosh/meep-engine 3.49.0 → 3.50.0

package/src/core/math/physics/fluid/vortex_swirl.js

@@ -0,0 +1,91 @@
+import { assert } from "../../../assert.js";
+import { line3_compute_segment_closest_point_t } from "../../../geom/3d/line/line3_compute_segment_closest_point_t.js";
+import { v3_length } from "../../../geom/vec3/v3_length.js";
+import { falloff_quadratic } from "../../falloff_quadratic.js";
+
+/**
+ * Lifts the peak of `s·(1 − s)²`, which is 4/27 at `s = 1/3`, to 1.
+ * @type {number}
+ */
+const PEAK_NORMALISATION = 27 / 4;
+
+/**
+ * # Vortex swirl: 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)`,
+ * where `c(x)` is the point on the segment closest to `x`; `d = ‖r⊥‖`; `R` is `radius`.
+ *
+ * Beside the segment `r⊥` is perpendicular to `â`, and the speed is `strength·(27/4)·s·(1 − s)²` with
+ * `s = d/R`:
+ * - zero on the axis;
+ * - `strength` at `d = R/3`, its peak;
+ * - zero at `R`, with zero slope.
+ *
+ * Past an end `r⊥` leans along `â`, and the cross product turns only its part across the axis. A
+ * segment of no length is therefore a point vortex about the axis line through `position`. The swirl
+ * is right-handed about `â`, and flipping the axis reverses it.
+ *
+ * `r⊥` is never normalised: the cross product carries its length, so the swirl vanishes on the axis
+ * instead of dividing by zero there. Finite everywhere for `R > 0`.
+ *
+ * The WGSL twin is `vortex_swirl` (`chunk_vortex_swirl`).
+ *
+ * @param {number[]|Float32Array|Float64Array} out receives the swirl velocity at `out_offset`
+ * @param {number} out_offset
+ * @param {number} x_x the point the swirl is asked at
+ * @param {number} x_y
+ * @param {number} x_z
+ * @param {number} position_x where the segment starts, on the axis
+ * @param {number} position_y
+ * @param {number} position_z
+ * @param {number} axis_x `â`, the axis the swirl turns about, unit length
+ * @param {number} axis_y
+ * @param {number} axis_z
+ * @param {number} segment_length how far the segment runs along the axis, ≥ 0
+ * @param {number} radius `R`, the swirl's reach from the segment, > 0
+ * @param {number} strength the peak speed, at `R/3`
+ */
+export function vortex_swirl(
+    out, out_offset,
+    x_x, x_y, x_z,
+    position_x, position_y, position_z,
+    axis_x, axis_y, axis_z,
+    segment_length,
+    radius, strength
+) {
+    assert.greaterThanOrEqual(segment_length, 0, 'segment_length');
+    assert.greaterThan(radius, 0, 'radius');
+
+    const end_x = position_x + axis_x * segment_length;
+    const end_y = position_y + axis_y * segment_length;
+    const end_z = position_z + axis_z * segment_length;
+
+    const t = line3_compute_segment_closest_point_t(
+        position_x, position_y, position_z,
+        end_x, end_y, end_z,
+        x_x, x_y, x_z
+    );
+
+    // r⊥, from the closest point on the segment
+    const r_x = x_x - ((end_x - position_x) * t + position_x);
+    const r_y = x_y - ((end_y - position_y) * t + position_y);
+    const r_z = x_z - ((end_z - position_z) * t + position_z);
+
+    const weight = falloff_quadratic(v3_length(r_x, r_y, r_z) / radius);
+
+    if (weight === 0) {
+        out[out_offset] = 0;
+        out[out_offset + 1] = 0;
+        out[out_offset + 2] = 0;
+
+        return;
+    }
+
+    const scale = strength * PEAK_NORMALISATION * weight / radius;
+
+    out[out_offset] = (axis_y * r_z - axis_z * r_y) * scale;
+    out[out_offset + 1] = (axis_z * r_x - axis_x * r_z) * scale;
+    out[out_offset + 2] = (axis_x * r_y - axis_y * r_x) * scale;
+}

package/src/core/math/physics/kinematics/rigid_velocity_at_point.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Velocity of a point carried by a rigid body: `v + ω × (x − c)`.
+ *
+ * The body moves at `v` at the point `c` it turns about (its centre of mass, or a node's
+ * translation), and spins at `ω` radians per second about `c`. A collider's wall velocity, where the
+ * fluid meets it, is this at the wall.
+ *
+ * The WGSL twin is `rigid_velocity_at_point` (`chunk_rigid_velocity_at_point`). The physics solver
+ * still writes this inline at its own sites.
+ *
+ * @param {number[]|Float32Array|Float64Array} out receives the point's velocity at `out_offset`
+ * @param {number} out_offset
+ * @param {number} linear_x `v`, the body's velocity at `c`
+ * @param {number} linear_y
+ * @param {number} linear_z
+ * @param {number} angular_x `ω`, radians per second about `c`
+ * @param {number} angular_y
+ * @param {number} angular_z
+ * @param {number} origin_x `c`, the point the body turns about
+ * @param {number} origin_y
+ * @param {number} origin_z
+ * @param {number} point_x `x`, the point carried by the body
+ * @param {number} point_y
+ * @param {number} point_z
+ */
+export function rigid_velocity_at_point(out: number[] | Float32Array | Float64Array, out_offset: number, linear_x: number, linear_y: number, linear_z: number, angular_x: number, angular_y: number, angular_z: number, origin_x: number, origin_y: number, origin_z: number, point_x: number, point_y: number, point_z: number): void;
+//# sourceMappingURL=rigid_velocity_at_point.d.ts.map

package/src/core/math/physics/kinematics/rigid_velocity_at_point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rigid_velocity_at_point.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/kinematics/rigid_velocity_at_point.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,6CAfW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,YACN,MAAM,YACN,MAAM,YACN,MAAM,aACN,MAAM,aACN,MAAM,aACN,MAAM,YACN,MAAM,YACN,MAAM,YACN,MAAM,WACN,MAAM,WACN,MAAM,WACN,MAAM,QAgBhB"}

package/src/core/math/physics/kinematics/rigid_velocity_at_point.js

@@ -0,0 +1,40 @@
+/**
+ * Velocity of a point carried by a rigid body: `v + ω × (x − c)`.
+ *
+ * The body moves at `v` at the point `c` it turns about (its centre of mass, or a node's
+ * translation), and spins at `ω` radians per second about `c`. A collider's wall velocity, where the
+ * fluid meets it, is this at the wall.
+ *
+ * The WGSL twin is `rigid_velocity_at_point` (`chunk_rigid_velocity_at_point`). The physics solver
+ * still writes this inline at its own sites.
+ *
+ * @param {number[]|Float32Array|Float64Array} out receives the point's velocity at `out_offset`
+ * @param {number} out_offset
+ * @param {number} linear_x `v`, the body's velocity at `c`
+ * @param {number} linear_y
+ * @param {number} linear_z
+ * @param {number} angular_x `ω`, radians per second about `c`
+ * @param {number} angular_y
+ * @param {number} angular_z
+ * @param {number} origin_x `c`, the point the body turns about
+ * @param {number} origin_y
+ * @param {number} origin_z
+ * @param {number} point_x `x`, the point carried by the body
+ * @param {number} point_y
+ * @param {number} point_z
+ */
+export function rigid_velocity_at_point(
+    out, out_offset,
+    linear_x, linear_y, linear_z,
+    angular_x, angular_y, angular_z,
+    origin_x, origin_y, origin_z,
+    point_x, point_y, point_z
+) {
+    const r_x = point_x - origin_x;
+    const r_y = point_y - origin_y;
+    const r_z = point_z - origin_z;
+
+    out[out_offset] = linear_x + angular_y * r_z - angular_z * r_y;
+    out[out_offset + 1] = linear_y + angular_z * r_x - angular_x * r_z;
+    out[out_offset + 2] = linear_z + angular_x * r_y - angular_y * r_x;
+}

package/src/engine/EngineHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAmFA;IAmBI;;;;;OAKG;IACH;QAHmE,aAAa,GAArE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5C,QAAQ,MAAM,CAAC,CAM1B;IAED;;;;;;;;;OASG;IACH,0BAHW,MAAM,GACJ,KAAK,CAYjB;IAED;;;;;;;;;OASG;IACH,6BAHW,MAAM,GACJ,aAAa,CAQzB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACN,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH;QApB0B,MAAM,EAArB,MAAM;QACgC,KAAK,GAA3C;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAA;SAAC;QACrB,SAAS;QACT,WAAW;QACF,KAAK,GAArB,MAAM;QACU,GAAG,GAAnB,MAAM;QACU,QAAQ,GAAxB,MAAM;QACwB,WAAW,GAAzC;YAAC,CAAC,EAAC,MAAM,CAAC;YAAC,CAAC,EAAC,MAAM,CAAA;SAAC;QACJ,iBAAiB,GAAjC,MAAM;QACW,WAAW,GAA5B,OAAO;QACU,aAAa,GAA9B,OAAO;QACU,YAAY,GAA7B,OAAO;QACU,aAAa,GAA9B,OAAO;QACS,iBAAiB,GAAjC,MAAM;QACU,iBAAiB,GAAjC,MAAM;QACW,gBAAgB,GAAjC,OAAO;QACU,cAAc,GAA/B,OAAO;QACS,mBAAmB,GAAnC,MAAM;QACW,OAAO,GAAxB,OAAO;sBA0EjB;IAGD;;;;;;;;;;;;OAYG;IACH;QAXyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACP,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;QACO,GAAG,GAAjB,KAAK;QACU,YAAY,GAA3B,MAAM;QACU,YAAY,GAA5B,OAAO;QACO,OAAO,GAArB,KAAK;QACU,gBAAgB,GAA/B,MAAM;QACS,iBAAiB,GAAhC,MAAM;sBA2DhB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACpB,QAAQ,MAAM,CAAC,CA6C3B;IAGD;;;;;;;;;;OAUG;IACH;QAR2B,MAAM,EAAtB,MAAM;QACY,IAAI,GAAtB,OAAO;QACU,QAAQ;QACR,UAAU,GAA3B,MAAM;QACW,UAAU,GAA3B,MAAM;QACY,WAAW,GAA7B,OAAO;QACL,OAAO,CAmEnB;IA9fD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAEb;IAGL;;;OAGG;IACH,QAFU,MAAM,CAEiC;IA2DrD;;;;;OAKG;IACH;QAJkE,aAAa,GAApE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5B,mBAAmB,GAApC,OAAO;QACL,QAAQ,MAAM,CAAC,CA0D3B;CA2XJ;;IAID;;;OAGG;IACH,uCAMC;;qCAtjBY,OAAO,iCAAiC,EAAE,sBAAsB;mBA5B1D,aAAa;oCACI,0BAA0B;sBAOxC,kCAAkC;8BAjB1B,mCAAmC;oBAD7C,yBAAyB;mBAK1B,iBAAiB;sBATd,wBAAwB;oBAG1B,yBAAyB;oBAQzB,8BAA8B"}
+{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAoFA;IAmBI;;;;;OAKG;IACH;QAHmE,aAAa,GAArE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5C,QAAQ,MAAM,CAAC,CAM1B;IAED;;;;;;;;;OASG;IACH,0BAHW,MAAM,GACJ,KAAK,CAYjB;IAED;;;;;;;;;OASG;IACH,6BAHW,MAAM,GACJ,aAAa,CAQzB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACN,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH;QApB0B,MAAM,EAArB,MAAM;QACgC,KAAK,GAA3C;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAA;SAAC;QACrB,SAAS;QACT,WAAW;QACF,KAAK,GAArB,MAAM;QACU,GAAG,GAAnB,MAAM;QACU,QAAQ,GAAxB,MAAM;QACwB,WAAW,GAAzC;YAAC,CAAC,EAAC,MAAM,CAAC;YAAC,CAAC,EAAC,MAAM,CAAA;SAAC;QACJ,iBAAiB,GAAjC,MAAM;QACW,WAAW,GAA5B,OAAO;QACU,aAAa,GAA9B,OAAO;QACU,YAAY,GAA7B,OAAO;QACU,aAAa,GAA9B,OAAO;QACS,iBAAiB,GAAjC,MAAM;QACU,iBAAiB,GAAjC,MAAM;QACW,gBAAgB,GAAjC,OAAO;QACU,cAAc,GAA/B,OAAO;QACS,mBAAmB,GAAnC,MAAM;QACW,OAAO,GAAxB,OAAO;sBA0EjB;IAGD;;;;;;;;;;;;OAYG;IACH;QAXyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACP,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;QACO,GAAG,GAAjB,KAAK;QACU,YAAY,GAA3B,MAAM;QACU,YAAY,GAA5B,OAAO;QACO,OAAO,GAArB,KAAK;QACU,gBAAgB,GAA/B,MAAM;QACS,iBAAiB,GAAhC,MAAM;sBA2DhB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACpB,QAAQ,MAAM,CAAC,CA6C3B;IAGD;;;;;;;;;;OAUG;IACH;QAR2B,MAAM,EAAtB,MAAM;QACY,IAAI,GAAtB,OAAO;QACU,QAAQ;QACR,UAAU,GAA3B,MAAM;QACW,UAAU,GAA3B,MAAM;QACY,WAAW,GAA7B,OAAO;QACL,OAAO,CAwEnB;IAngBD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAEb;IAGL;;;OAGG;IACH,QAFU,MAAM,CAEiC;IA2DrD;;;;;OAKG;IACH;QAJkE,aAAa,GAApE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5B,mBAAmB,GAApC,OAAO;QACL,QAAQ,MAAM,CAAC,CA0D3B;CAgYJ;;IAID;;;OAGG;IACH,uCAMC;;qCA3jBY,OAAO,iCAAiC,EAAE,sBAAsB;mBA7B1D,aAAa;oCACI,0BAA0B;sBAQxC,kCAAkC;8BAlB1B,mCAAmC;oBAD7C,yBAAyB;mBAK1B,iBAAiB;sBATd,wBAAwB;oBAG1B,yBAAyB;oBAQzB,8BAA8B"}

package/src/engine/EngineHarness.js

@@ -21,6 +21,7 @@ import { CameraSystem } from "./graphics3/CameraSystem.js";
 import { LightSystem } from "./graphics3/LightSystem.js";
 import { TerrainSystem } from "./graphics3/TerrainSystem.js";
 import { WaterSystem } from "./graphics3/WaterSystem.js";
+import { GPUFluidSystem } from "./graphics3/GPUFluidSystem.js";
 import { Scene } from "../shade/renderer/scene/Scene.js";
 import TopDownCameraController from "./graphics/ecs/camera/topdown/TopDownCameraController.js";
 import TopDownCameraControllerSystem from "./graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js";
@@ -572,6 +573,11 @@ export class EngineHarness {
                 em.addSystem(new WaterSystem(engine.graphics, EngineHarness.shadeScene(engine)));
             }
 
+            // the scene's wind: a GPUFluidComponent on an entity steps it, and the far field fills it without one
+            if (em.getSystem(GPUFluidSystem) === null) {
+                em.addSystem(new GPUFluidSystem(engine.graphics, EngineHarness.shadeScene(engine)));
+            }
+
             const water = new Water();
 
             await MeshoptClusterizer.ready;

package/src/engine/ecs/EntityComponentDataset.d.ts

@@ -79,6 +79,23 @@ export class EntityComponentDataset implements Iterable<number> {
      * @type {Object[][]}
      */
     private components;
+    /**
+     * Per component type index, the lowest entity id holding an instance of that type: what
+     * {@link getAnyComponentInstance} and {@link getAnyComponent} answer with. {@link ANY_HOLDER_NONE}
+     * when no entity holds one, {@link ANY_HOLDER_UNKNOWN} when the holder it named has let go and
+     * nobody has asked since.
+     *
+     * Kept as components come and go — a lower id taking the type over in
+     * {@link addComponentToEntityByIndex}, the holder letting go in
+     * {@link removeComponentFromEntityByIndex_Unchecked} — so that asking for a singleton is an
+     * array read rather than a walk of the type's store. The store is a sparse array, and walking it
+     * either allocates (`for…in` builds its key list) or, by index, crawls through every hole below
+     * the holder: 82 µs for a holder at entity 5,000, 1.8 ms at 100,000, in Node 24.
+     *
+     * @private
+     * @type {Int32Array}
+     */
+    private __any_holder;
     /**
      * Current number of entities
      * @private
@@ -313,9 +330,16 @@ export class EntityComponentDataset implements Iterable<number> {
      */
     computeComponentCount<T_1>(klass: T_1): number;
     /**
-     * Retrieves any instance of a given component.
+     * Retrieves any instance of a given component, with the entity holding it.
      * If no component instances exist - component will be `null` and entity will be `-1`.
      * Useful for singleton components such as a camera or an audio listener.
+     *
+     * When several entities hold the type, the lowest entity id wins — the same one
+     * {@link getAnyComponentInstance} answers with.
+     *
+     * Allocates the result. A caller that needs only the component uses
+     * {@link getAnyComponentInstance}, which does not.
+     *
      * @template T
      * @param {Class<T>} component_type
      * @returns {{entity:number, component:T}}
@@ -324,6 +348,26 @@ export class EntityComponentDataset implements Iterable<number> {
         entity: number;
         component: T_2;
     };
+    /**
+     * The instance of a component type held by the lowest entity id that holds one, or `null` when
+     * no entity does or the type is not registered. For singletons — a camera, an audio listener, a
+     * terrain — looked up every tick: it allocates nothing, and is an array read except for the first
+     * ask after the type's holder let go of it, which walks the live entities below the next holder.
+     *
+     * When several entities hold the type, the lowest entity id wins. That is the order
+     * {@link getAnyComponent} always answered in, when it walked the type's store with `for…in`.
+     *
+     * @template T
+     * @param {Class<T>} component_type
+     * @returns {T|null}
+     */
+    getAnyComponentInstance<T_3>(component_type: import("../../core/primitives/Class.js").Class<T_3>): T_3;
+    /**
+     * @private
+     * @param {number} component_index
+     * @returns {number} the lowest entity id holding the type, or {@link ANY_HOLDER_NONE}
+     */
+    private __lowest_holder;
     /**
      *
      * Associate a component with a particular entity.
@@ -364,7 +408,7 @@ export class EntityComponentDataset implements Iterable<number> {
      * @param {Class<T>} klass
      * @returns {T|undefined}
      */
-    getComponent<T_3>(entity_id: number, klass: import("../../core/primitives/Class.js").Class<T_3>): T_3;
+    getComponent<T_4>(entity_id: number, klass: import("../../core/primitives/Class.js").Class<T_4>): T_4;
     /**
      * Always returns non-null value, if the component is not found - an error is thrown instead
      * @template C
@@ -418,7 +462,7 @@ export class EntityComponentDataset implements Iterable<number> {
      * @param {*} [thisArg=undefined] optional `this` argument for the visitor callback
      * @returns {void}
      */
-    traverseComponents<T_4>(klass: import("../../core/primitives/Class.js").Class<T_4>, visitor: (instance: T_4, entity: number) => void, thisArg?: any): void;
+    traverseComponents<T_5>(klass: import("../../core/primitives/Class.js").Class<T_5>, visitor: (instance: T_5, entity: number) => void, thisArg?: any): void;
     /**
      *
      * @param {number} component_index
@@ -537,7 +581,7 @@ export class EntityComponentDataset implements Iterable<number> {
      * @param {string} class_name
      * @returns {null|function|Class<T>}
      */
-    getComponentClassByName<T_5>(class_name: string): Function | import("../../core/primitives/Class.js").Class<T_5>;
+    getComponentClassByName<T_6>(class_name: string): Function | import("../../core/primitives/Class.js").Class<T_6>;
     /**
      * Copy entities from a supplied input dataset. Only components present in the mask are copied
      * @param {Array} component_classes

package/src/engine/ecs/EntityComponentDataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityComponentDataset.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityComponentDataset.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityComponentDataset.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityComponentDataset.js"],"names":[],"mappings":"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"}

package/src/engine/ecs/EntityComponentDataset.js

@@ -74,6 +74,19 @@ function validateIndexValue(index, name) {
     return true;
 }
 
+/**
+ * What {@link EntityComponentDataset#__any_holder} holds for a component type no entity has.
+ * @type {number}
+ */
+const ANY_HOLDER_NONE = -1;
+
+/**
+ * What {@link EntityComponentDataset#__any_holder} holds for a component type whose lowest holder
+ * let go of it, until somebody asks who holds it now.
+ * @type {number}
+ */
+const ANY_HOLDER_UNKNOWN = -2;
+
 /**
  * Matches a supplies component mask against a larger set
  * @param {BitSet} componentOccupancy
@@ -210,6 +223,24 @@ export class EntityComponentDataset {
      */
     components = [];
 
+    /**
+     * Per component type index, the lowest entity id holding an instance of that type: what
+     * {@link getAnyComponentInstance} and {@link getAnyComponent} answer with. {@link ANY_HOLDER_NONE}
+     * when no entity holds one, {@link ANY_HOLDER_UNKNOWN} when the holder it named has let go and
+     * nobody has asked since.
+     *
+     * Kept as components come and go — a lower id taking the type over in
+     * {@link addComponentToEntityByIndex}, the holder letting go in
+     * {@link removeComponentFromEntityByIndex_Unchecked} — so that asking for a singleton is an
+     * array read rather than a walk of the type's store. The store is a sparse array, and walking it
+     * either allocates (`for…in` builds its key list) or, by index, crawls through every hole below
+     * the holder: 82 µs for a holder at entity 5,000, 1.8 ms at 100,000, in Node 24.
+     *
+     * @private
+     * @type {Int32Array}
+     */
+    __any_holder = new Int32Array(0);
+
     /**
      * Current number of entities
      * @private
@@ -807,6 +838,9 @@ export class EntityComponentDataset {
             this.__type_to_index_map.set(map[i], i);
         }
 
+        // indices moved; each type's holder is found again when it is next asked for
+        this.__any_holder = new Int32Array(newComponentTypeCount).fill(ANY_HOLDER_UNKNOWN);
+
         this.componentTypeCount = newComponentTypeCount;
     }
 
@@ -1141,6 +1175,11 @@ export class EntityComponentDataset {
         //clear occupancy bit
         this.componentOccupancy.clear(component_occupancy_index);
 
+        if (this.__any_holder[component_index] === entity_id) {
+            // the next holder up is found when it is asked for, not on every removal
+            this.__any_holder[component_index] = ANY_HOLDER_UNKNOWN;
+        }
+
         //dispatch events
         const componentClass = this.componentTypeMap[component_index];
 
@@ -1182,9 +1221,16 @@ export class EntityComponentDataset {
     }
 
     /**
-     * Retrieves any instance of a given component.
+     * Retrieves any instance of a given component, with the entity holding it.
      * If no component instances exist - component will be `null` and entity will be `-1`.
      * Useful for singleton components such as a camera or an audio listener.
+     *
+     * When several entities hold the type, the lowest entity id wins — the same one
+     * {@link getAnyComponentInstance} answers with.
+     *
+     * Allocates the result. A caller that needs only the component uses
+     * {@link getAnyComponentInstance}, which does not.
+     *
      * @template T
      * @param {Class<T>} component_type
      * @returns {{entity:number, component:T}}
@@ -1196,17 +1242,10 @@ export class EntityComponentDataset {
         const index = this.computeComponentTypeIndex(component_type);
 
         if (index !== -1) {
+            entity = this.__lowest_holder(index);
 
-            const components = this.components[index];
-            for (const entity_key in components) {
-                const c = components[entity_key];
-
-                if (c !== undefined) {
-                    entity = Number(entity_key);
-                    component = c;
-                    break;
-                }
-
+            if (entity !== ANY_HOLDER_NONE) {
+                component = this.components[index][entity];
             }
         }
 
@@ -1216,6 +1255,67 @@ export class EntityComponentDataset {
         };
     }
 
+    /**
+     * The instance of a component type held by the lowest entity id that holds one, or `null` when
+     * no entity does or the type is not registered. For singletons — a camera, an audio listener, a
+     * terrain — looked up every tick: it allocates nothing, and is an array read except for the first
+     * ask after the type's holder let go of it, which walks the live entities below the next holder.
+     *
+     * When several entities hold the type, the lowest entity id wins. That is the order
+     * {@link getAnyComponent} always answered in, when it walked the type's store with `for…in`.
+     *
+     * @template T
+     * @param {Class<T>} component_type
+     * @returns {T|null}
+     */
+    getAnyComponentInstance(component_type) {
+        const index = this.computeComponentTypeIndex(component_type);
+
+        if (index === -1) {
+            return null;
+        }
+
+        const entity = this.__lowest_holder(index);
+
+        if (entity === ANY_HOLDER_NONE) {
+            return null;
+        }
+
+        return this.components[index][entity];
+    }
+
+    /**
+     * @private
+     * @param {number} component_index
+     * @returns {number} the lowest entity id holding the type, or {@link ANY_HOLDER_NONE}
+     */
+    __lowest_holder(component_index) {
+        const holders = this.__any_holder;
+        const known = holders[component_index];
+
+        if (known !== ANY_HOLDER_UNKNOWN) {
+            return known;
+        }
+
+        // the holder it named let go: find the next one up, once, and remember it
+        const entity_occupancy = this.entityOccupancy;
+        const component_occupancy = this.componentOccupancy;
+        const type_count = this.componentTypeCount;
+
+        let found = ANY_HOLDER_NONE;
+
+        for (let entity = entity_occupancy.nextSetBit(0); entity !== -1; entity = entity_occupancy.nextSetBit(entity + 1)) {
+            if (component_occupancy.get(entity * type_count + component_index)) {
+                found = entity;
+                break;
+            }
+        }
+
+        holders[component_index] = found;
+
+        return found;
+    }
+
     /**
      *
      * Associate a component with a particular entity.
@@ -1273,6 +1373,13 @@ export class EntityComponentDataset {
         //inset component instance into component dataset
         this.components[component_index][entity_id] = component_instance;
 
+        const holder = this.__any_holder[component_index];
+
+        if (holder === ANY_HOLDER_NONE || entity_id < holder) {
+            // a lower id takes the type over; an unknown holder stays unknown until asked for
+            this.__any_holder[component_index] = entity_id;
+        }
+
         //dispatch events
         const componentClass = this.componentTypeMap[component_index];
 
@@ -1967,6 +2074,8 @@ export class EntityComponentDataset {
         this.componentOccupancy.reset();
         this.entityOccupancy.reset();
 
+        this.__any_holder.fill(ANY_HOLDER_NONE);
+
         this.entityCount = 0;
 
         this.__entityEventListeners = [];

package/src/engine/ecs/fow/FogOfWarVisibilityPredicate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FogOfWarVisibilityPredicate.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/fow/FogOfWarVisibilityPredicate.js"],"names":[],"mappings":"AAEA;IACI;;;OAGG;IACH,KAFU,QAAQ,CAEP;IAEX;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,8CAIC;IAED;;;;;;OAMG;IACH,QALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,OAAO,CAYnB;IAED,iBAEC;CACJ;yBA/CwB,eAAe"}
+{"version":3,"file":"FogOfWarVisibilityPredicate.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/fow/FogOfWarVisibilityPredicate.js"],"names":[],"mappings":"AAEA;IACI;;;OAGG;IACH,KAFU,QAAQ,CAEP;IAEX;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,8CAEC;IAED;;;;;;OAMG;IACH,QALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,OAAO,CAYnB;IAED,iBAEC;CACJ;yBA7CwB,eAAe"}

package/src/engine/ecs/fow/FogOfWarVisibilityPredicate.js

@@ -18,9 +18,7 @@ export class FogOfWarVisibilityPredicate {
      * @param {EntityComponentDataset} ecd
      */
     initialize(ecd) {
-        const fow = ecd.getAnyComponent(FogOfWar);
-
-        this.fow = fow.component;
+        this.fow = ecd.getAnyComponentInstance(FogOfWar);
     }
 
     /**

package/src/engine/ecs/storage/populateEngineSerializationRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAsMA;;;;;;;;GAQG;AACH,iGAwHC"}
+{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAuMA;;;;;;;;GAQG;AACH,iGAyHC"}

package/src/engine/ecs/storage/populateEngineSerializationRegistry.js

@@ -103,6 +103,7 @@ import { WaterSerializationUpgrader_4_5 } from "../../graphics/ecs/water/WaterSe
 import { MeshletGeometrySerializationAdapter } from "../../../shade/renderer/geometry/MeshletGeometrySerializationAdapter.js";
 import { WaterWavesSerializationAdapter } from "../../graphics/ecs/water/WaterWavesSerializationAdapter.js";
 import { WaterWavesSerializationUpgrader_0_1 } from "../../graphics/ecs/water/WaterWavesSerializationUpgrader_0_1.js";
+import { WaterWavesSerializationUpgrader_1_2 } from "../../graphics/ecs/water/WaterWavesSerializationUpgrader_1_2.js";
 import WaterWaves from "../../graphics/ecs/water/WaterWaves.js";
 import { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
 import {
@@ -313,6 +314,7 @@ export function populateEngineSerializationRegistry(registry) {
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_3_4());
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_4_5());
     registry.registerUpgrader(WaterWaves.typeName, new WaterWavesSerializationUpgrader_0_1());
+    registry.registerUpgrader(WaterWaves.typeName, new WaterWavesSerializationUpgrader_1_2());
 
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());

package/src/engine/ecs/terrain/util/obtainTerrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"obtainTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/util/obtainTerrain.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,sEAHW,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,GAAC,IAAI,CAexB;oBArBmB,mBAAmB"}
+{"version":3,"file":"obtainTerrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/util/obtainTerrain.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,sEAHW,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,GAAC,IAAI,CAoBxB;oBA1BmB,mBAAmB"}

package/src/engine/ecs/terrain/util/obtainTerrain.js

@@ -12,6 +12,11 @@ export function obtainTerrain(ecd, callback=noop) {
     assert.notEqual(ecd, null, 'ecd is null');
     assert.notEqual(ecd, undefined, 'ecd is undefined');
 
+    if (callback === noop) {
+        // called per tick by placement systems; only the callback needs the entity
+        return ecd.getAnyComponentInstance(Terrain);
+    }
+
     const object = ecd.getAnyComponent(Terrain);
 
     const terrain = object.component;

package/src/engine/graphics/ecs/water/WaterWaves.d.ts

@@ -2,30 +2,19 @@
 export const WATER_WAVES_SHORE_REFLECTION_DEFAULT: 0.5;
 export default WaterWaves;
 /**
- * The waves of the {@link Water} on the same entity: the wind that raises them and how the body's outline
- * treats them (WATER_SURFACE_SIMULATION_PLAN_2026_10_06.md §6.1).
+ * The waves of the {@link Water} on the same entity: the open water beyond its mesh that the wind crosses, and
+ * how the body's outline treats them (WATER_SURFACE_SIMULATION_PLAN_2026_10_06.md §6.1).
  *
  * Kept apart from `Water`, which describes the body and its optics and says nothing about how the surface
- * moves. A body without this component is calm, and its outline reflects wave particles (from
- * `WaterSystem.splash`) at the default coefficient.
+ * moves. A body without this component has no water upwind of its mesh, and its outline reflects wave particles
+ * (from `WaterSystem.splash`) at the default coefficient.
  *
- * The wind's waves follow from physics: a fetch-limited JONSWAP sea of this wind speed over the water upwind
- * — the body's own extent along the wind plus {@link upwindFetch} — so the same wind raises centimetre ripples
- * on a puddle and swell on an open sea.
+ * The wind is not here: it is the scene's (GPU_FLUID_CASCADES_PROPOSAL_2026_10_16.md §6), the published wind field
+ * 10 m above the body's origin, low-passed on the GPU. The waves follow from physics: a fetch-limited JONSWAP sea
+ * of that wind over the water upwind — the body's own extent along the wind plus {@link upwindFetch} — so the same
+ * wind raises centimetre ripples on a puddle and swell on an open sea.
  */
 declare class WaterWaves {
-    /**
-     * Wind speed at 10 m, m/s.
-     * @type {Vector1}
-     */
-    windSpeed: Vector1;
-    /**
-     * Direction the wind blows towards, radians in the body's local xz plane, measured from +x towards +z.
-     * The angle turns with the body's rotation and is not skewed by its scale. A change turns the waves over
-     * a few seconds.
-     * @type {Vector1}
-     */
-    windDirection: Vector1;
     /**
      * Open water upwind of the mesh, metres, added to the mesh's own extent along the wind. Zero for a body
      * that is all the water there is (a pool, a lake); an open sea states the distance to its far shore
@@ -41,8 +30,6 @@ declare class WaterWaves {
     shoreReflection: Vector1;
     fromJSON(json: any): void;
     toJSON(): {
-        windSpeed: number;
-        windDirection: number;
         upwindFetch: number;
         shoreReflection: number;
     };

package/src/engine/graphics/ecs/water/WaterWaves.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaterWaves.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterWaves.js"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,uDAAwD;;AAExD;;;;;;;;;;;GAWG;AACH;IACI;;;OAGG;IACH,WAFU,OAAO,CAEU;IAE3B;;;;;OAKG;IACH,eAFU,OAAO,CAEc;IAE/B;;;;;OAKG;IACH,aAFU,OAAO,CAEY;IAE7B;;;;OAIG;IACH,iBAFU,OAAO,CAEmD;IAEpE,0BAgBC;IAED;;;;;MAOC;CACJ;;;;oBAzEmB,kCAAkC"}
+{"version":3,"file":"WaterWaves.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterWaves.js"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,uDAAwD;;AAExD;;;;;;;;;;;;GAYG;AACH;IACI;;;;;OAKG;IACH,aAFU,OAAO,CAEY;IAE7B;;;;OAIG;IACH,iBAFU,OAAO,CAEmD;IAEpE,0BAQC;IAED;;;MAKC;CACJ;;;;oBAlDmB,kCAAkC"}