@woosh/meep-engine 3.39.0 → 3.40.0

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.39.0",
+  "version": "3.40.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

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

@@ -1 +1 @@
-{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AA+EA;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,CA0DnB;IArfD;;;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;CAkXJ;;IAID;;;OAGG;IACH,uCAMC;;qCA7iBY,OAAO,iCAAiC,EAAE,sBAAsB;mBAxB1D,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":"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"}

package/src/engine/EngineHarness.js

@@ -26,6 +26,10 @@ import TopDownCameraController from "./graphics/ecs/camera/topdown/TopDownCamera
 import TopDownCameraControllerSystem from "./graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js";
 import { Light } from "./graphics/ecs/light/Light.js";
 import Water from "./graphics/ecs/water/Water.js";
+import { make_plane_geometry } from "../shade/renderer/geometry/primitives/make_plane_geometry.js";
+import { meshlet_geometry_build_from_geometry } from "../shade/renderer/geometry/meshlet_geometry_build_from_geometry.js";
+import { MeshoptClusterizer } from "../shade/renderer/geometry/meshlet/build/meshoptimizer/meshopt_clusterizer.js";
+import { StandardAttributes } from "../shade/renderer/geometry/StandardAttributes.js";
 import { MouseEvents } from "./input/devices/events/MouseEvents.js";
 import KeyboardCameraController from "./input/ecs/controllers/KeyboardCameraController.js";
 import InputControllerSystem from "./input/ecs/systems/InputControllerSystem.js";
@@ -565,14 +569,23 @@ export class EngineHarness {
         if (enableWater) {
 
             if (em.getSystem(WaterSystem) === null) {
-                em.addSystem(new WaterSystem(engine.graphics));
+                em.addSystem(new WaterSystem(engine.graphics, EngineHarness.shadeScene(engine)));
             }
 
             const water = new Water();
 
-            water.level.set(waterLevel);
-
-            eb.add(water);
+            await MeshoptClusterizer.ready;
+            const plane = make_plane_geometry(size.x * 2, size.y * 2);
+            const positions = plane.getAttribute(StandardAttributes.Position).data;
+            const normals = plane.getAttribute(StandardAttributes.Normal).data;
+            for (let i = 0; i < positions.length; i += 3) {
+                positions[i + 2] = -positions[i + 1]; positions[i + 1] = 0;
+                normals[i] = 0; normals[i + 1] = 1; normals[i + 2] = 0;
+            }
+            const geometry = meshlet_geometry_build_from_geometry(plane);
+            const placement = new Transform64();
+            placement.setTranslation(size.x, waterLevel, size.y);
+            new Entity().add(water).add(geometry).add(placement).build(engine.entityManager.dataset);
         }
 
         eb.build(engine.entityManager.dataset);

package/src/engine/asset/loaders/image/avif/threaded_image_encoder.js

@@ -229,7 +229,7 @@ export class ThreadedImageEncoder {
             width: sampler2d.width,
             height: sampler2d.height,
             item_size: sampler2d.itemSize,
-            is_hdr: data instanceof Uint16Array,
+            is_hdr: data instanceof Float16Array || data instanceof Uint16Array,
             quality,
             speed
         };

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":"AAkLA;;;;;;;;GAQG;AACH,iGA4GC"}
+{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAoLA;;;;;;;;GAQG;AACH,iGA8GC"}

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

@@ -89,6 +89,8 @@ import { WaterSerializationAdapter } from "../../graphics/ecs/water/WaterSeriali
 import { WaterSerializationUpgrader_0_1 } from "../../graphics/ecs/water/WaterSerializationUpgrader_0_1.js";
 import { WaterSerializationUpgrader_1_2 } from "../../graphics/ecs/water/WaterSerializationUpgrader_1_2.js";
 import { WaterSerializationUpgrader_2_3 } from "../../graphics/ecs/water/WaterSerializationUpgrader_2_3.js";
+import { WaterSerializationUpgrader_3_4 } from "../../graphics/ecs/water/WaterSerializationUpgrader_3_4.js";
+import { MeshletGeometrySerializationAdapter } from "../../../shade/renderer/geometry/MeshletGeometrySerializationAdapter.js";
 import { WaterWavesSerializationAdapter } from "../../graphics/ecs/water/WaterWavesSerializationAdapter.js";
 import { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
 import {
@@ -218,6 +220,7 @@ export function populateEngineSerializationRegistry(registry) {
         new ClingToTerrainSerializationAdapter(),
         new TerrainSerializationAdapter(),
         new WaterSerializationAdapter(),
+        new MeshletGeometrySerializationAdapter(),
         new WaterWavesSerializationAdapter(),
         new GridPosition2TransformSerializationAdapter(),
         new GridObstacleSerializationAdapter(),
@@ -286,6 +289,7 @@ export function populateEngineSerializationRegistry(registry) {
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_0_1());
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_1_2());
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_2_3());
+    registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_3_4());
 
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());

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

@@ -1,6 +1,7 @@
 export default Water;
 /**
- * A body of water flooding the level, as authored data and nothing else.
+ * Optical properties of an authored water surface. MeshletGeometry supplies its shape and
+ * Transform64 supplies its placement.
  *
  * Everything optical here is physical and in SI units (WATER_OPTICS_PLAN_2026_10_02.md §7.1): the
  * index of refraction, the micro-roughness of the surface, and what fills the body — a
@@ -11,16 +12,11 @@ export default Water;
  * How the surface moves is not here: the surface producer and its own component (`WaterWaves`)
  * own that.
  *
- * The component holds no renderer state: `WaterSystem` reads these values every frame onto the
- * surface its passes draw, which is why an edit needs no notification to be picked up.
+ * The component holds no renderer state. Optical edits notify WaterSystem, which updates the
+ * persistent scene row without scanning water bodies each frame.
  */
 declare class Water {
     constructor(options: any);
-    /**
-     * Rest height of the surface, m.
-     * @type {Vector1}
-     */
-    level: Vector1;
     /**
      * Index of refraction of the water relative to the air above it.
      * @type {Vector1}
@@ -32,27 +28,28 @@ declare class Water {
      * @type {Vector1}
      */
     roughness: Vector1;
+    /** Optical edits queue a scene row update. */
+    onChanged: Signal;
+    /** @param {ParticipatingMedium} value */
+    set medium(value: ParticipatingMedium);
     /**
-     * What fills the body: absorption and scattering lobes, RGB in 1/m. Clear open ocean
-     * (chlorophyll 0.3 mg/m³, the `open_ocean` preset) unless told otherwise. After editing its fields in place, set
-     * `medium.needsUpdate = true`.
-     * @type {ParticipatingMedium}
+     * Absorption and scattering lobes, RGB in 1/m. Defaults to open ocean.
+     * After editing fields in place, set `medium.needsUpdate = true`.
+     * @returns {ParticipatingMedium}
      */
-    medium: ParticipatingMedium;
-    bvh: BvhClient;
-    updateBounds(): void;
+    get medium(): ParticipatingMedium;
     fromJSON(json: any): void;
     toJSON(): {
-        level: number;
         ior: number;
         roughness: number;
         medium: any;
     };
+    #private;
 }
 declare namespace Water {
     let typeName: string;
 }
 import Vector1 from "../../../../core/geom/Vector1.js";
+import Signal from "../../../../core/events/signal/Signal.js";
 import { ParticipatingMedium } from "../../../../shade/renderer/medium/ParticipatingMedium.js";
-import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
 //# sourceMappingURL=Water.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Water.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/Water.js"],"names":[],"mappings":";AAUA;;;;;;;;;;;;;;GAcG;AACH;IA8BI,0BAMC;IAnCD;;;OAGG;IACH,OAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,KAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,WAFU,OAAO,CAEa;IAE9B;;;;;OAKG;IACH,QAFU,mBAAmB,CAEG;IAEhC,eAAsB;IAUtB,qBAcC;IAED,0BAgBC;IAED;;;;;MAOC;CACJ;;;;oBAxGmB,kCAAkC;oCAClB,0DAA0D;0BAFpE,yCAAyC"}
+{"version":3,"file":"Water.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/Water.js"],"names":[],"mappings":";AASA;;;;;;;;;;;;;;;GAeG;AACH;IAmCI,0BAQC;IA1CD;;;OAGG;IACH,KAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,WAFU,OAAO,CAEa;IAE9B,8CAA8C;IAC9C,kBAAyB;IAWzB,yCAAyC;IACzC,uCAMC;IAbD;;;;OAIG;IACH,kCAAqC;IAoBrC,0BAgBC;IAED;;;;MAMC;;CACJ;;;;oBA9FmB,kCAAkC;mBADnC,0CAA0C;oCAEzB,0DAA0D"}

package/src/engine/graphics/ecs/water/Water.js

@@ -1,110 +1,100 @@
-import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
-import Vector1 from "../../../../core/geom/Vector1.js";
-import { ParticipatingMedium } from "../../../../shade/renderer/medium/ParticipatingMedium.js";
-import {
-    participating_medium_from_json,
-    participating_medium_to_json
-} from "../../../../shade/renderer/medium/participating_medium_serialization.js";
-import { water_medium_default } from "../../../../shade/renderer/medium/water/water_presets.js";
-import { WATER_SIZE } from "./WATER_SIZE.js";
-
-/**
- * A body of water flooding the level, as authored data and nothing else.
- *
- * Everything optical here is physical and in SI units (WATER_OPTICS_PLAN_2026_10_02.md §7.1): the
- * index of refraction, the micro-roughness of the surface, and what fills the body — a
- * {@link ParticipatingMedium}, the same description the path tracer, fog and glass read. Presets
- * and the constituent and appearance tools in `shade/renderer/medium/water/` build that medium;
- * the component stores only the result.
- *
- * How the surface moves is not here: the surface producer and its own component (`WaterWaves`)
- * own that.
- *
- * The component holds no renderer state: `WaterSystem` reads these values every frame onto the
- * surface its passes draw, which is why an edit needs no notification to be picked up.
- */
-class Water {
-    /**
-     * Rest height of the surface, m.
-     * @type {Vector1}
-     */
-    level = new Vector1(0);
-
-    /**
-     * Index of refraction of the water relative to the air above it.
-     * @type {Vector1}
-     */
-    ior = new Vector1(1.333);
-
-    /**
-     * Perceptual roughness of the surface for the waves too small for the surface's mesh, before
-     * the slope variance the surface producer reports is added.
-     * @type {Vector1}
-     */
-    roughness = new Vector1(0.02);
-
-    /**
-     * What fills the body: absorption and scattering lobes, RGB in 1/m. Clear open ocean
-     * (chlorophyll 0.3 mg/m³, the `open_ocean` preset) unless told otherwise. After editing its fields in place, set
-     * `medium.needsUpdate = true`.
-     * @type {ParticipatingMedium}
-     */
-    medium = water_medium_default();
-
-    bvh = new BvhClient();
-
-    constructor(options) {
-
-        if (options !== undefined) {
-            console.error('Constructor options are deprecated');
-            this.fromJSON(options);
-        }
-    }
-
-    updateBounds() {
-        const width = WATER_SIZE;
-        const height = WATER_SIZE;
-
-        const level = this.level.getValue();
-
-        this.bvh.resize(
-            -width / 4,
-            level,
-            -height / 4,
-            width * (3 / 4),
-            level,
-            height * (3 / 4)
-        );
-    }
-
-    fromJSON(json) {
-        if (typeof json.level === 'number') {
-            this.level.fromJSON(json.level);
-        }
-
-        if (typeof json.ior === 'number') {
-            this.ior.fromJSON(json.ior);
-        }
-
-        if (typeof json.roughness === 'number') {
-            this.roughness.fromJSON(json.roughness);
-        }
-
-        if (json.medium !== null && typeof json.medium === 'object') {
-            participating_medium_from_json(this.medium, json.medium);
-        }
-    }
-
-    toJSON() {
-        return {
-            level: this.level.toJSON(),
-            ior: this.ior.toJSON(),
-            roughness: this.roughness.toJSON(),
-            medium: participating_medium_to_json(this.medium),
-        };
-    }
-}
-
-Water.typeName = "Water";
-
-export default Water;
+import Signal from "../../../../core/events/signal/Signal.js";
+import Vector1 from "../../../../core/geom/Vector1.js";
+import { ParticipatingMedium } from "../../../../shade/renderer/medium/ParticipatingMedium.js";
+import {
+    participating_medium_from_json,
+    participating_medium_to_json
+} from "../../../../shade/renderer/medium/participating_medium_serialization.js";
+import { water_medium_default } from "../../../../shade/renderer/medium/water/water_presets.js";
+
+/**
+ * Optical properties of an authored water surface. MeshletGeometry supplies its shape and
+ * Transform64 supplies its placement.
+ *
+ * Everything optical here is physical and in SI units (WATER_OPTICS_PLAN_2026_10_02.md §7.1): the
+ * index of refraction, the micro-roughness of the surface, and what fills the body — a
+ * {@link ParticipatingMedium}, the same description the path tracer, fog and glass read. Presets
+ * and the constituent and appearance tools in `shade/renderer/medium/water/` build that medium;
+ * the component stores only the result.
+ *
+ * How the surface moves is not here: the surface producer and its own component (`WaterWaves`)
+ * own that.
+ *
+ * The component holds no renderer state. Optical edits notify WaterSystem, which updates the
+ * persistent scene row without scanning water bodies each frame.
+ */
+class Water {
+    /**
+     * Index of refraction of the water relative to the air above it.
+     * @type {Vector1}
+     */
+    ior = new Vector1(1.333);
+
+    /**
+     * Perceptual roughness of the surface for the waves too small for the surface's mesh, before
+     * the slope variance the surface producer reports is added.
+     * @type {Vector1}
+     */
+    roughness = new Vector1(0.02);
+
+    /** Optical edits queue a scene row update. */
+    onChanged = new Signal();
+    /** @type {ParticipatingMedium|null} */
+    #medium = null;
+    #changed = () => this.onChanged.dispatch();
+
+    /**
+     * Absorption and scattering lobes, RGB in 1/m. Defaults to open ocean.
+     * After editing fields in place, set `medium.needsUpdate = true`.
+     * @returns {ParticipatingMedium}
+     */
+    get medium() { return this.#medium; }
+    /** @param {ParticipatingMedium} value */
+    set medium(value) {
+        if (value === this.#medium) { return; }
+        this.#medium?.onChanged.remove(this.#changed);
+        this.#medium = value;
+        value.onChanged.add(this.#changed);
+        this.#changed();
+    }
+
+    constructor(options) {
+        this.ior.onChanged.add(this.#changed);
+        this.roughness.onChanged.add(this.#changed);
+        this.medium = water_medium_default();
+        if (options !== undefined) {
+            console.error('Constructor options are deprecated');
+            this.fromJSON(options);
+        }
+    }
+
+    fromJSON(json) {
+        if (json.level !== undefined || json.size !== undefined) {
+            throw new Error('Legacy Water placement must be migrated to MeshletGeometry and Transform64 before loading');
+        }
+
+        if (typeof json.ior === 'number') {
+            this.ior.fromJSON(json.ior);
+        }
+
+        if (typeof json.roughness === 'number') {
+            this.roughness.fromJSON(json.roughness);
+        }
+
+        if (json.medium !== null && typeof json.medium === 'object') {
+            participating_medium_from_json(this.medium, json.medium);
+        }
+    }
+
+    toJSON() {
+        return {
+            ior: this.ior.toJSON(),
+            roughness: this.roughness.toJSON(),
+            medium: participating_medium_to_json(this.medium),
+        };
+    }
+}
+
+Water.typeName = "Water";
+
+export default Water;

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

@@ -1 +1 @@
-{"version":3,"file":"WaterSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationAdapter.js"],"names":[],"mappings":"AAOA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,uCAFW,KAAK,QAQf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QAQf;CACJ;gDArC+C,gEAAgE;kBAK9F,YAAY"}
+{"version":3,"file":"WaterSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationAdapter.js"],"names":[],"mappings":"AAOA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,uCAFW,KAAK,QAOf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QAOf;CACJ;gDAnC+C,gEAAgE;kBAK9F,YAAY"}

package/src/engine/graphics/ecs/water/WaterSerializationAdapter.js

@@ -1,38 +1,36 @@
-import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
-import {
-    deserialize_participating_medium,
-    serialize_participating_medium
-} from "../../../../shade/renderer/medium/participating_medium_serialization.js";
-import Water from "./Water.js";
-
-export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
-
-    klass = Water;
-    version = 3;
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {Water} value
-     */
-    serialize(buffer, value) {
-        buffer.writeFloat64(value.level.getValue());
-        buffer.writeFloat32(value.ior.getValue());
-        buffer.writeFloat32(value.roughness.getValue());
-
-        serialize_participating_medium(buffer, value.medium);
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {Water} value
-     */
-    deserialize(buffer, value) {
-        value.level.set(buffer.readFloat64());
-        value.ior.set(buffer.readFloat32());
-        value.roughness.set(buffer.readFloat32());
-
-        deserialize_participating_medium(buffer, value.medium);
-    }
-}
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import {
+    deserialize_participating_medium,
+    serialize_participating_medium
+} from "../../../../shade/renderer/medium/participating_medium_serialization.js";
+import Water from "./Water.js";
+
+export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
+
+    klass = Water;
+    version = 4;
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {Water} value
+     */
+    serialize(buffer, value) {
+        buffer.writeFloat32(value.ior.getValue());
+        buffer.writeFloat32(value.roughness.getValue());
+
+        serialize_participating_medium(buffer, value.medium);
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {Water} value
+     */
+    deserialize(buffer, value) {
+        value.ior.set(buffer.readFloat32());
+        value.roughness.set(buffer.readFloat32());
+
+        deserialize_participating_medium(buffer, value.medium);
+    }
+}

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

@@ -0,0 +1,6 @@
+/** A component upgrader cannot create the geometry and transform needed to retain old placement. */
+export class WaterSerializationUpgrader_3_4 extends BinaryClassUpgrader {
+    upgrade(): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=WaterSerializationUpgrader_3_4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WaterSerializationUpgrader_3_4.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationUpgrader_3_4.js"],"names":[],"mappings":"AAEA,oGAAoG;AACpG;IAGI,gBAEC;CACJ;oCATmC,oDAAoD"}

package/src/engine/graphics/ecs/water/WaterSerializationUpgrader_3_4.js

@@ -0,0 +1,10 @@
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+
+/** A component upgrader cannot create the geometry and transform needed to retain old placement. */
+export class WaterSerializationUpgrader_3_4 extends BinaryClassUpgrader {
+    __startVersion = 3;
+    __targetVersion = 4;
+    upgrade() {
+        throw new Error('Legacy Water placement must be migrated to MeshletGeometry and Transform64 before loading');
+    }
+}

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

@@ -5,8 +5,8 @@ export default WaterWaves;
  *
  * Kept apart from `Water` on purpose: `Water` describes the body and its optics, and says nothing
  * about how the surface moves. The production surface simulation replaces this component, its
- * system and its producer together, and `Water` stays as it is. A body without this component is
- * simulated with no forcing, which is calm water — not a separate flat-water path.
+ * system and its producer together, and `Water` stays as it is. A body without this component
+ * tessellates its authored rest surface and allocates no wave grid until a splash is queued.
  */
 declare class WaterWaves {
     /**
@@ -16,7 +16,7 @@ declare class WaterWaves {
      */
     windSpeed: Vector1;
     /**
-     * Direction the wind blows towards, radians in the xz plane, measured from +x towards +z.
+     * Direction the wind blows towards, radians in the mesh's local xz plane, measured from +x towards +z.
      * @type {Vector1}
      */
     windDirection: Vector1;

package/src/engine/graphics/ecs/water/WaterWaves.js

@@ -1,46 +1,46 @@
-import Vector1 from "../../../../core/geom/Vector1.js";
-
-/**
- * What drives the waves of the {@link Water} on the same entity, for the primitive wave
- * simulation.
- *
- * Kept apart from `Water` on purpose: `Water` describes the body and its optics, and says nothing
- * about how the surface moves. The production surface simulation replaces this component, its
- * system and its producer together, and `Water` stays as it is. A body without this component is
- * simulated with no forcing, which is calm water — not a separate flat-water path.
- */
-class WaterWaves {
-    /**
-     * Wind speed at 10 m, m/s. Sets the forcing, which grows as its square, and the slope variance
-     * of the waves the simulation's grid does not resolve (Cox-Munk).
-     * @type {Vector1}
-     */
-    windSpeed = new Vector1(3);
-
-    /**
-     * Direction the wind blows towards, radians in the xz plane, measured from +x towards +z.
-     * @type {Vector1}
-     */
-    windDirection = new Vector1(0);
-
-    fromJSON(json) {
-        if (typeof json.windSpeed === 'number') {
-            this.windSpeed.fromJSON(json.windSpeed);
-        }
-
-        if (typeof json.windDirection === 'number') {
-            this.windDirection.fromJSON(json.windDirection);
-        }
-    }
-
-    toJSON() {
-        return {
-            windSpeed: this.windSpeed.toJSON(),
-            windDirection: this.windDirection.toJSON(),
-        };
-    }
-}
-
-WaterWaves.typeName = "WaterWaves";
-
-export default WaterWaves;
+import Vector1 from "../../../../core/geom/Vector1.js";
+
+/**
+ * What drives the waves of the {@link Water} on the same entity, for the primitive wave
+ * simulation.
+ *
+ * Kept apart from `Water` on purpose: `Water` describes the body and its optics, and says nothing
+ * about how the surface moves. The production surface simulation replaces this component, its
+ * system and its producer together, and `Water` stays as it is. A body without this component
+ * tessellates its authored rest surface and allocates no wave grid until a splash is queued.
+ */
+class WaterWaves {
+    /**
+     * Wind speed at 10 m, m/s. Sets the forcing, which grows as its square, and the slope variance
+     * of the waves the simulation's grid does not resolve (Cox-Munk).
+     * @type {Vector1}
+     */
+    windSpeed = new Vector1(3);
+
+    /**
+     * Direction the wind blows towards, radians in the mesh's local xz plane, measured from +x towards +z.
+     * @type {Vector1}
+     */
+    windDirection = new Vector1(0);
+
+    fromJSON(json) {
+        if (typeof json.windSpeed === 'number') {
+            this.windSpeed.fromJSON(json.windSpeed);
+        }
+
+        if (typeof json.windDirection === 'number') {
+            this.windDirection.fromJSON(json.windDirection);
+        }
+    }
+
+    toJSON() {
+        return {
+            windSpeed: this.windSpeed.toJSON(),
+            windDirection: this.windDirection.toJSON(),
+        };
+    }
+}
+
+WaterWaves.typeName = "WaterWaves";
+
+export default WaterWaves;

package/src/engine/graphics/texture/sampler/sampler2d_to_avif.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sampler2d_to_avif.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/sampler/sampler2d_to_avif.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gEARW,MAAM,YACN,MAAM,+BAEJ,UAAU,CAmCtB"}
+{"version":3,"file":"sampler2d_to_avif.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/sampler/sampler2d_to_avif.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gEARW,MAAM,YACN,MAAM,+BAEJ,UAAU,CAmCtB"}