@woosh/meep-engine 3.41.0 → 3.42.0

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

@@ -80,6 +80,8 @@ import {
     HighlightSerializationUpgrader_0_1
 } from "../../graphics/ecs/highlight/HighlightSerializationUpgrader_0_1.js";
 import { LightSerializationAdapter } from "../../graphics/ecs/light/LightSerializationAdapter.js";
+import { Light } from "../../graphics/ecs/light/Light.js";
+import { LightSerializationUpgrader_0_1 } from "../../graphics/ecs/light/LightSerializationUpgrader_0_1.js";
 import {
     SGMeshSerializationAdapter
 } from "../../graphics/ecs/mesh-v2/aggregate/serialization/SGMeshSerializationAdapter.js";
@@ -89,8 +91,11 @@ import { WaterSerializationUpgrader_0_1 } from "../../graphics/ecs/water/WaterSe
 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 { WaterSerializationUpgrader_4_5 } from "../../graphics/ecs/water/WaterSerializationUpgrader_4_5.js";
 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 WaterWaves from "../../graphics/ecs/water/WaterWaves.js";
 import { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
 import {
     GridPosition2TransformSerializationAdapter
@@ -271,6 +276,7 @@ export function populateEngineSerializationRegistry(registry) {
     registry.registerUpgrader(FogOfWar.typeName, new FogOfWarSerializationUpdater_0_1());
 
     registry.registerUpgrader(Camera.typeName, new CameraSerializationUpgrader_0_1());
+    registry.registerUpgrader(Light.typeName, new LightSerializationUpgrader_0_1());
 
     registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_0_1());
     registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_1_2());
@@ -288,6 +294,8 @@ export function populateEngineSerializationRegistry(registry) {
     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(Water.typeName, new WaterSerializationUpgrader_4_5());
+    registry.registerUpgrader(WaterWaves.typeName, new WaterWavesSerializationUpgrader_0_1());
 
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());

package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClingToTerrainSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js"],"names":[],"mappings":"AA8MA;;;;;;;GAOG;AACH,wCANW,UAAU,aACV,OAAO,gBACP,MAAM,yCA4ChB;;uBA3PsB,wCAAwC;oBAE3C,qCAAqC;AAyCzD;;IAGI,6DAA6C;IAG7C,mHAGE;IAEF;;;OAGG;IACH,aAFU,MAAM,MAAM,CAAC,CAEG;IAE1B,YAAU;IAEV;;;OAGG;IACH,kBAFU,MAAM,CAEwB;IAExC;;;OAGG;IACH,sBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,YAHW,cAAc,aADd,WAAW,YAEX,MAAM,QAyBhB;IAED;;;;;OAKG;IACH,cAHW,cAAc,aADd,WAAW,YAEX,MAAM,QAgBhB;IAED,6BAiDC;CACJ;uBA9KsB,oBAAoB;4BACf,mCAAmC;2BAIpC,qBAAqB;4CANJ,0DAA0D;oBAIlF,eAAe;sBAbb,+CAA+C"}
+{"version":3,"file":"ClingToTerrainSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js"],"names":[],"mappings":"AA+MA;;;;;;;GAOG;AACH,wCANW,UAAU,aACV,OAAO,gBACP,MAAM,yCA4ChB;;uBA5PsB,wCAAwC;oBAE3C,qCAAqC;AAyCzD;;IAGI,6DAA6C;IAG7C,mHAGE;IAEF;;;OAGG;IACH,aAFU,MAAM,MAAM,CAAC,CAEG;IAE1B,YAAU;IAEV;;;OAGG;IACH,kBAFU,MAAM,CAEwB;IAExC;;;OAGG;IACH,sBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,YAHW,cAAc,aADd,WAAW,YAEX,MAAM,QA0BhB;IAED;;;;;OAKG;IACH,cAHW,cAAc,aADd,WAAW,YAEX,MAAM,QAgBhB;IAED,6BAiDC;CACJ;uBA/KsB,oBAAoB;4BACf,mCAAmC;2BAIpC,qBAAqB;4CANJ,0DAA0D;oBAIlF,eAAe;sBAbb,+CAA+C"}

package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js

@@ -103,7 +103,8 @@ class ClingToTerrainSystem extends System {
             transform,
             component: cling,
             ecd,
-            entity: entityId
+            entity: entityId,
+            hasProcessedSurface: false
         };
 
         ecd.addEntityEventListener(entityId, TRANSFORM64_EVENT_CHANGE, update);
@@ -368,7 +369,8 @@ function doCling(el, terrain, timeDelta) {
     t64_read_rotation(scratch_rotation, t);
 
     if (
-        cling.__lastPosition.roughlyEquals(scratch_position, 0.001)
+        el.hasProcessedSurface
+        && cling.__lastPosition.roughlyEquals(scratch_position, 0.001)
         && cling.__lastRotation.roughlyEquals(scratch_rotation, 0.0001)
     ) {
         //do nothing, cached position matches with existing position
@@ -385,6 +387,7 @@ function doCling(el, terrain, timeDelta) {
     }
 
     processRaycastHit(temp_sp.position, t, temp_sp.normal, cling, timeDelta, el);
+    el.hasProcessedSurface = true;
 
     // The pose now matches the terrain. If `processRaycastHit` moved anything it announced the
     // change, and that announcement re-queues the entity through the system's own listener; if it

package/src/engine/ecs/terrain/ecs/layers/TerrainLayers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainLayers.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/layers/TerrainLayers.js"],"names":[],"mappings":"AAkGA;IACI;;;OAGG;IACH,QAFU,KAAK,YAAY,CAAC,CAER;IAEpB;;;OAGG;IACH,YAFU,OAAO,CAEgD;IAG7D;;;;;;;;OAQG;IACH,SAFU,cAAc,CAEuB;IAG/C;;;;;OAKG;IACH,QAFU,SAAS,CAEsB;IAG7C;;;;;;MAKC;IAED;;;aAGC;IAED;;;;OAIG;IACH,gCAHW,MAAM,iBACN,MAAM,QA6BhB;IAED;;;;OAIG;IACH,2GAyBC;IAED,sCAIC;IAED;;;;OAIG;IACH,WAHW,MAAM,GACL,YAAY,CAIvB;IAED;;;;OAIG;IACH,oCAHW,uBAAuB,GACrB,MAAM,CAqBlB;IAED;;;;OAIG;IACH,kCAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,SAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,gBAHW,YAAY,GACV,MAAM,CAWlB;IAED;;;;OAIG;IACH,mBAHW,YAAY,GACX,OAAO,CAIlB;IAED;;;;;;OAMG;IACH,0CAqCC;IAED;;;OAGG;IACH,iCAFW,MAAM,QA6BhB;IAED,cAEC;IAGD,qBAuCC;CACJ;sCAhZY,OAAO,4DAA4D,EAAE,uBAAuB;;iBAjBxF,6CAA6C;6BAcjC,mBAAmB;oBAb5B,qCAAqC;+BAM1B,wDAAwD;0BAD7D,mDAAmD"}
+{"version":3,"file":"TerrainLayers.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/layers/TerrainLayers.js"],"names":[],"mappings":"AAkGA;IACI;;;OAGG;IACH,QAFU,KAAK,YAAY,CAAC,CAER;IAEpB;;;OAGG;IACH,YAFU,OAAO,CAEgD;IAG7D;;;;;;;;OAQG;IACH,SAFU,cAAc,CAEuB;IAG/C;;;;;OAKG;IACH,QAFU,SAAS,CAEsB;IAG7C;;;;;;MAKC;IAED;;;aAGC;IAED;;;;OAIG;IACH,gCAHW,MAAM,iBACN,MAAM,QA6BhB;IAED;;;;OAIG;IACH,2GA4BC;IAED,sCAIC;IAED;;;;OAIG;IACH,WAHW,MAAM,GACL,YAAY,CAIvB;IAED;;;;OAIG;IACH,oCAHW,uBAAuB,GACrB,MAAM,CAqBlB;IAED;;;;OAIG;IACH,kCAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,SAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,gBAHW,YAAY,GACV,MAAM,CAWlB;IAED;;;;OAIG;IACH,mBAHW,YAAY,GACX,OAAO,CAIlB;IAED;;;;;;OAMG;IACH,0CAqCC;IAED;;;OAGG;IACH,iCAFW,MAAM,QA6BhB;IAED,cAEC;IAGD,qBAuCC;CACJ;sCAnZY,OAAO,4DAA4D,EAAE,uBAAuB;;iBAjBxF,6CAA6C;6BAcjC,mBAAmB;oBAb5B,qCAAqC;+BAM1B,wDAAwD;0BAD7D,mDAAmD"}

package/src/engine/ecs/terrain/ecs/layers/TerrainLayers.js

@@ -196,6 +196,9 @@ export class TerrainLayers {
 
             promise.then(
                 () => {
+                    if (this.get(layerIndex) !== layer) {
+                        return;
+                    }
                     this.writeLayerDataIntoTexture(layerIndex);
                 },
                 (reason) => {

package/src/engine/ecs/terrain/ecs/splat/SplatMapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SplatMapping.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/splat/SplatMapping.js"],"names":[],"mappings":"AAYA;;GAEG;AAGH;;GAEG;AACH;IACI;;;OAGG;IACH,OAFU,MAAM,CAEN;IAGN;;;OAGG;IACH,MAFU,OAAO,CAEY;IAO7B;;;OAGG;IACH,SAFU,cAAc,CAEgC;IAG5D;;;;;;;MAQC;IAED;;;;;;;aA6BC;IAED;;;;;OAKG;IACH,8BAJW,SAAS,SACT,MAAM,YACN,MAAM,QAkDhB;IAED;;;;;OAKG;IACH,gCAJW,SAAS,SACT,MAAM,YACN,MAAM,QA2BhB;IAED;;;;;;;OAOG;IACH,wBANW,UAAU,gBACV,MAAM,gBACN,MAAM,eACN,MAAM,gBACN,MAAM,QA2ChB;IAED;;;;;;;OAOG;IACH,4BANW,UAAU,WACV,MAAM,WACN,MAAM,SACN,MAAM,UACN,MAAM,QAuChB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,KACN,MAAM,iBACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,SAAS,CAcrB;IAED;;OAEG;IACH,iDAEC;IAED;;;OAGG;IACH,mDAEC;IAED;;;OAGG;IACH,iCAEC;IAED;;;;OAIG;IACH,gCAHW,UAAU,GACR,IAAI,CAmDhB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAgCnB;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAqBhB;IAED,uBAiBC;IAED;;;;;;OAMG;IACH,cALW,MAAM,UACN,MAAM,SACN,MAAM,cACN,OAAO,QAwDjB;CACJ;mBAngBY,OAAO,0CAA0C,EAAE,IAAI;oBAThD,qCAAqC;+BAM1B,wDAAwD;0BAD7D,mDAAmD"}
+{"version":3,"file":"SplatMapping.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/splat/SplatMapping.js"],"names":[],"mappings":"AAYA;;GAEG;AAGH;;GAEG;AACH;IACI;;;OAGG;IACH,OAFU,MAAM,CAEN;IAGN;;;OAGG;IACH,MAFU,OAAO,CAEY;IAO7B;;;OAGG;IACH,SAFU,cAAc,CAEgC;IAG5D;;;;;;;MAQC;IAED;;;;;;;aA6BC;IAED;;;;;OAKG;IACH,8BAJW,SAAS,SACT,MAAM,YACN,MAAM,QAkDhB;IAED;;;;;OAKG;IACH,gCAJW,SAAS,SACT,MAAM,YACN,MAAM,QA2BhB;IAED;;;;;;;OAOG;IACH,wBANW,UAAU,gBACV,MAAM,gBACN,MAAM,eACN,MAAM,gBACN,MAAM,QA4ChB;IAED;;;;;;;OAOG;IACH,4BANW,UAAU,WACV,MAAM,WACN,MAAM,SACN,MAAM,UACN,MAAM,QAuChB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,KACN,MAAM,iBACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,SAAS,CAcrB;IAED;;OAEG;IACH,iDAEC;IAED;;;OAGG;IACH,mDAEC;IAED;;;OAGG;IACH,iCAEC;IAED;;;;OAIG;IACH,gCAHW,UAAU,GACR,IAAI,CAmDhB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAgCnB;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAqBhB;IAED,uBAiBC;IAED;;;;;;OAMG;IACH,cALW,MAAM,UACN,MAAM,SACN,MAAM,cACN,OAAO,QAwDjB;CACJ;mBApgBY,OAAO,0CAA0C,EAAE,IAAI;oBAThD,qCAAqC;+BAM1B,wDAAwD;0BAD7D,mDAAmD"}

package/src/engine/ecs/terrain/ecs/splat/SplatMapping.js

@@ -223,6 +223,7 @@ export class SplatMapping {
             }
 
         }
+        this.weights.invalidate();
     }
 
     /**

package/src/engine/ecs/terrain/overlay/TerrainOverlay.js

@@ -295,7 +295,7 @@ export class TerrainOverlay {
         const scaled_source = Sampler2D.uint8(4, dWidth, dHeight);
         sampler2d_scale(source, scaled_source);
 
-        sampler2d_paint(this, scaled_source, 0, 0, dx, dy, dWidth, dHeight);
+        sampler2d_paint(this.sampler, scaled_source, 0, 0, dx, dy, dWidth, dHeight);
 
     }
 }

package/src/engine/ecs/terrain/tiles/TerrainTile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainTile.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/tiles/TerrainTile.js"],"names":[],"mappings":";AAwBA;;GAEG;AACH;IACI,sBAA6B;IAC7B,eAA0B;IAC1B,cAAyB;IACzB,kBAAyB;IACzB,4BAAoC;IAUpC;;;;;;;;;;;OAWG;IACH,UAFU,YAAY,GAAC,IAAI,CAEX;IAEhB;;OAEG;IACH,SAFU,YAAY,GAAC,IAAI,CAEZ;IAEf;;OAEG;IACH,KAFU,YAAY,GAAC,IAAI,CAEhB;IAEX;;OAEG;IACH,SAFU,WAAW,GAAC,WAAW,GAAC,IAAI,CAEvB;IAEf;;;OAGG;IACH,WAFU,OAAO,CAEA;IAEjB;;;OAGG;IACH,cAFU,SAAS,CAEY;IAE/B;;;OAGG;IACH,KAFU,eAAe,CAEd;IAEX;;;OAGG;IACH,SAFU,OAAO,CAED;IAChB;;;OAGG;IACH,mBAFU,OAAO,CAES;IAC1B,uBAAmB;IAEnB;;;;;;;;;OASG;IACH,eAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,aAAuB;IACvB,oBAA2B;IAE3B;;;;OAIG;IACH,kBAWE;IAEF;;;;;OAKG;IACH,+BAAiG;IAEjG;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAUZ;;;OAGG;IACH,gCAGC;IAfD;;;OAGG;IACH,8BAEC;IAWD;;;;;;;;;;OAUG;IACH,yBATW,aAAa,WACb,MAAM,WACN,MAAM,WACN,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACL,OAAO,CA8ClB;IAED,+CAKC;IAED,8CAOC;IAED;;;;;;;;;;OAUG;IACH,mBATW,WAAW,GAAC,SAAS,UACrB,WAAW,GAAC,SAAS,QACrB,WAAW,GAAC,SAAS,SACrB,WAAW,GAAC,SAAS,WACrB,WAAW,GAAC,SAAS,YACrB,WAAW,GAAC,SAAS,cACrB,WAAW,GAAC,SAAS,eACrB,WAAW,GAAC,SAAS,QA4M/B;IAED,2BAoDC;IAED;;;;OAIG;IACH,mCAHW,MAAM,cACN,MAAM,QAIhB;IAED,gBAoBC;IA6BD;;;;;OAKG;IACH,gBAFW;QAAC,QAAQ,EAAE;YAAC,QAAQ,EAAE,YAAY,CAAC;YAAC,OAAO,EAAE,YAAY,CAAC;YAAC,GAAG,EAAE,YAAY,CAAC;YAAC,OAAO,EAAE,WAAW,GAAC,WAAW,CAAA;SAAC,CAAC;QAAC,GAAG,CAAC,EAAC;YAAC,UAAU,EAAC,MAAM,CAAC;YAAC,IAAI,EAAC,WAAW,CAAA;SAAC,CAAA;KAAC,QA0BtK;;CACJ;oBA7kBmB,kCAAkC;4BAG1B,2CAA2C;0BAZ7C,yCAAyC;gCADnC,mDAAmD;mBAGhE,0CAA0C;8BAM/B,2CAA2C"}
+{"version":3,"file":"TerrainTile.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/tiles/TerrainTile.js"],"names":[],"mappings":";AAwBA;;GAEG;AACH;IACI,sBAA6B;IAC7B,eAA0B;IAC1B,cAAyB;IACzB,kBAAyB;IACzB,4BAAoC;IAUpC;;;;;;;;;;;OAWG;IACH,UAFU,YAAY,GAAC,IAAI,CAEX;IAEhB;;OAEG;IACH,SAFU,YAAY,GAAC,IAAI,CAEZ;IAEf;;OAEG;IACH,KAFU,YAAY,GAAC,IAAI,CAEhB;IAEX;;OAEG;IACH,SAFU,WAAW,GAAC,WAAW,GAAC,IAAI,CAEvB;IAEf;;;OAGG;IACH,WAFU,OAAO,CAEA;IAEjB;;;OAGG;IACH,cAFU,SAAS,CAEY;IAE/B;;;OAGG;IACH,KAFU,eAAe,CAEd;IAEX;;;OAGG;IACH,SAFU,OAAO,CAED;IAChB;;;OAGG;IACH,mBAFU,OAAO,CAES;IAC1B,uBAAmB;IAEnB;;;;;;;;;OASG;IACH,eAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,aAAuB;IACvB,oBAA2B;IAE3B;;;;OAIG;IACH,kBAWE;IAEF;;;;;OAKG;IACH,+BAAiG;IAEjG;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAUZ;;;OAGG;IACH,gCAGC;IAfD;;;OAGG;IACH,8BAEC;IAWD;;;;;;;;;;OAUG;IACH,yBATW,aAAa,WACb,MAAM,WACN,MAAM,WACN,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACL,OAAO,CA0DlB;IAED,+CAKC;IAED,8CAOC;IAED;;;;;;;;;;OAUG;IACH,mBATW,WAAW,GAAC,SAAS,UACrB,WAAW,GAAC,SAAS,QACrB,WAAW,GAAC,SAAS,SACrB,WAAW,GAAC,SAAS,WACrB,WAAW,GAAC,SAAS,YACrB,WAAW,GAAC,SAAS,cACrB,WAAW,GAAC,SAAS,eACrB,WAAW,GAAC,SAAS,QA4M/B;IAED,2BAoDC;IAED;;;;OAIG;IACH,mCAHW,MAAM,cACN,MAAM,QAIhB;IAED,gBAoBC;IA6BD;;;;;OAKG;IACH,gBAFW;QAAC,QAAQ,EAAE;YAAC,QAAQ,EAAE,YAAY,CAAC;YAAC,OAAO,EAAE,YAAY,CAAC;YAAC,GAAG,EAAE,YAAY,CAAC;YAAC,OAAO,EAAE,WAAW,GAAC,WAAW,CAAA;SAAC,CAAC;QAAC,GAAG,CAAC,EAAC;YAAC,UAAU,EAAC,MAAM,CAAC;YAAC,IAAI,EAAC,WAAW,CAAA;SAAC,CAAA;KAAC,QA0BtK;;CACJ;oBAzlBmB,kCAAkC;4BAG1B,2CAA2C;0BAZ7C,yCAAyC;gCADnC,mDAAmD;mBAGhE,0CAA0C;8BAM/B,2CAA2C"}

package/src/engine/ecs/terrain/tiles/TerrainTile.js

@@ -215,7 +215,19 @@ class TerrainTile {
         );
 
         if (hit_found) {
-            result.applyMatrix4(m4);
+            result.position.applyMatrix4(m4);
+
+            // Normals use the inverse transpose; the ray already computed this inverse.
+            const normal = result.normal;
+            const normal_x = normal.x;
+            const normal_y = normal.y;
+            const normal_z = normal.z;
+
+            normal.set(
+                m4_tmp[0] * normal_x + m4_tmp[1] * normal_y + m4_tmp[2] * normal_z,
+                m4_tmp[4] * normal_x + m4_tmp[5] * normal_y + m4_tmp[6] * normal_z,
+                m4_tmp[8] * normal_x + m4_tmp[9] * normal_y + m4_tmp[10] * normal_z
+            );
 
             // make sure to pull normal to magnitude of 1
             result.normal.normalize();

package/src/engine/ecs/terrain/tiles/TerrainTileManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainTileManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/tiles/TerrainTileManager.js"],"names":[],"mappings":";0BAoBa,OAAO,gDAAgD,EAAE,OAAO;AA4B7E;IA2FI;;;;;;;OAOG;IACH;QAFgC,WAAW,EAAhC,WAAW;OAYrB;IA5GD;;;OAGG;IACH,OAFU,WAAW,EAAE,CAEZ;IAEX;;;MAGE;IAEF;;;;;;;;;;OAUG;IACH,aAFU,OAAO,CAEiB;IAElC;;;;;;;;;;;;OAYG;IACH,oBAFU,MAAM,CAEW;IAE3B;;;OAGG;IACH,WAFU,OAAO,CAEa;IAC9B;;;OAGG;IACH,YAFU,eAAe,CAEW;IAEpC;;;OAGG;IACH,OAFU,OAAO,CAES;IAG1B;;;;OAIG;IACH,oBAAmC;IAEnC;;;OAGG;IACH,cAFU,GAAG,CAEG;IAEhB;;;OAGG;IACH,aAFU,eAAe,CAEe;IAExC;;;;;;;;;;;OAWG;IACH,eAFU,MAAM,CAEG;IAef;;;OAGG;IACH,aAFU,WAAW,CAES;IAGlC,gCAWC;IAED,8BAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,0BAFW,MAAM,QAuBhB;IAED;;;;OAIG;IACH,2BAHW,MAAM,cACN,MAAM,QAiChB;IAED,mBAIC;IAED;;;;OAIG;IACH,mBAHW,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,uBAYrC;IAED,qBAqBC;IAED;;OAEG;IACH,gBAIC;IAED;;;;;;OAMG;IACH,qBALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAuBhB;IAGD;;;;;;;OAOG;IACH,oCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,WAAW,EAAE,CAgCzB;IAED,wBA0CC;IAED;;;;;OAKG;IACH,oBAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;;;;;;;;;OAcG;IACH,wBAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;;;;OAMG;IACH,wBAEC;IAED;;;OAGG;IACH,yBAEC;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,GACJ,WAAW,GAAC,SAAS,CAiBjC;IAED;;;;;OAKG;IACH,wBAJW,MAAM,KACN,MAAM,GACJ,WAAW,CAavB;IAED;;;;;OAKG;IACH,4BAJW,MAAM,KACN,MAAM,GACL,WAAW,GAAC,SAAS,CAoBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,KACN,MAAM,GACJ,QAAQ,WAAW,CAAC,CAYhC;IAED;;;;;;OAMG;IACH,UALW,MAAM,KACN,MAAM,GACJ,QAAQ,WAAW,CAAC,CA4BhC;IAED;;;OAGG;IACH,cAFW,WAAW,QAcrB;IAED,gBAMC;IAED;;;;;;OAMG;IACH,cAJW,MAAM,KACN,MAAM,QACN,WAAW,QAUrB;IAED;;;;;;;;;;;;OAYG;IACH,yBAJW,MAAM,KACN,MAAM;YACG,MAAM,GAAC,WAAW,GAAC,SAAS;MAkD/C;IAED;;;;;;;;;;OAUG;IACH,yBATW,aAAa,WACb,MAAM,WACN,MAAM,WACN,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,OAAO,CAuDnB;IAED;;;;;;OAMG;IACH,kCALW,aAAa,KACb,MAAM,KACN,MAAM,GACL,OAAO,CAOlB;IAED;;;;;;OAMG;IACH,SALW,MAAM,KACN,MAAM,WACN,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,UAC3B,CAAC,MAAM,KAAG,KAAK,IAAI,QAiG7B;CACJ;wBA72BuB,kBAAkB;mBATvB,0CAA0C;oBAGzC,kCAAkC;4BAI1B,2CAA2C;oBAVnD,mCAAmC;gCAOvB,mDAAmD;8BAFrD,2CAA2C"}
+{"version":3,"file":"TerrainTileManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/tiles/TerrainTileManager.js"],"names":[],"mappings":";0BAoBa,OAAO,gDAAgD,EAAE,OAAO;AA4B7E;IA2FI;;;;;;;OAOG;IACH;QAFgC,WAAW,EAAhC,WAAW;OAYrB;IA5GD;;;OAGG;IACH,OAFU,WAAW,EAAE,CAEZ;IAEX;;;MAGE;IAEF;;;;;;;;;;OAUG;IACH,aAFU,OAAO,CAEiB;IAElC;;;;;;;;;;;;OAYG;IACH,oBAFU,MAAM,CAEW;IAE3B;;;OAGG;IACH,WAFU,OAAO,CAEa;IAC9B;;;OAGG;IACH,YAFU,eAAe,CAEW;IAEpC;;;OAGG;IACH,OAFU,OAAO,CAES;IAG1B;;;;OAIG;IACH,oBAAmC;IAEnC;;;OAGG;IACH,cAFU,GAAG,CAEG;IAEhB;;;OAGG;IACH,aAFU,eAAe,CAEe;IAExC;;;;;;;;;;;OAWG;IACH,eAFU,MAAM,CAEG;IAef;;;OAGG;IACH,aAFU,WAAW,CAES;IAGlC,gCAWC;IAED,8BAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,0BAFW,MAAM,QAuBhB;IAED;;;;OAIG;IACH,2BAHW,MAAM,cACN,MAAM,QAiChB;IAED,mBAIC;IAED;;;;OAIG;IACH,mBAHW,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,uBAYrC;IAED,qBAqBC;IAED;;OAEG;IACH,gBAIC;IAED;;;;;;OAMG;IACH,qBALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAuBhB;IAGD;;;;;;;OAOG;IACH,oCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,WAAW,EAAE,CAgCzB;IAED,wBA0CC;IAED;;;;;OAKG;IACH,oBAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;;;;;;;;;OAcG;IACH,wBAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;;;;OAMG;IACH,wBAEC;IAED;;;OAGG;IACH,yBAEC;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,GACJ,WAAW,GAAC,SAAS,CAkBjC;IAED;;;;;OAKG;IACH,wBAJW,MAAM,KACN,MAAM,GACJ,WAAW,CAavB;IAED;;;;;OAKG;IACH,4BAJW,MAAM,KACN,MAAM,GACL,WAAW,GAAC,SAAS,CAoBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,KACN,MAAM,GACJ,QAAQ,WAAW,CAAC,CAYhC;IAED;;;;;;OAMG;IACH,UALW,MAAM,KACN,MAAM,GACJ,QAAQ,WAAW,CAAC,CA4BhC;IAED;;;OAGG;IACH,cAFW,WAAW,QAcrB;IAED,gBAMC;IAED;;;;;;OAMG;IACH,cAJW,MAAM,KACN,MAAM,QACN,WAAW,QAUrB;IAED;;;;;;;;;;;;OAYG;IACH,yBAJW,MAAM,KACN,MAAM;YACG,MAAM,GAAC,WAAW,GAAC,SAAS;MAkD/C;IAED;;;;;;;;;;OAUG;IACH,yBATW,aAAa,WACb,MAAM,WACN,MAAM,WACN,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,OAAO,CAuDnB;IAED;;;;;;OAMG;IACH,kCALW,aAAa,KACb,MAAM,KACN,MAAM,GACL,OAAO,CAOlB;IAED;;;;;;OAMG;IACH,SALW,MAAM,KACN,MAAM,WACN,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,UAC3B,CAAC,MAAM,KAAG,KAAK,IAAI,QAiG7B;CACJ;wBA92BuB,kBAAkB;mBATvB,0CAA0C;oBAGzC,kCAAkC;4BAI1B,2CAA2C;oBAVnD,mCAAmC;gCAOvB,mDAAmD;8BAFrD,2CAA2C"}

package/src/engine/ecs/terrain/tiles/TerrainTileManager.js

@@ -494,6 +494,7 @@ class TerrainTileManager {
             x < 0
             || x >= this.gridWidth
             || y < 0
+            || y >= this.gridHeight
         ) {
             return undefined;
         }

package/src/engine/graphics/ecs/light/LightSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LightSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/light/LightSerializationAdapter.js"],"names":[],"mappings":"AAIA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,8BAFW,KAAK,QAcf;IAED;;;;OAIG;IACH,gCAFW,KAAK,QAcf;CACJ;gDA9C+C,gEAAgE;sBAE1F,YAAY"}
+{"version":3,"file":"LightSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/light/LightSerializationAdapter.js"],"names":[],"mappings":"AAIA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,8BAFW,KAAK,QAoBf;IAED;;;;OAIG;IACH,gCAFW,KAAK,QAoBf;CACJ;gDA1D+C,gEAAgE;sBAE1F,YAAY"}

package/src/engine/graphics/ecs/light/LightSerializationAdapter.js

@@ -5,7 +5,7 @@ import { Light } from "./Light.js";
 export class LightSerializationAdapter extends BinaryClassSerializationAdapter {
 
     klass = Light;
-    version = 0;
+    version = 1;
 
     /**
      *
@@ -24,6 +24,12 @@ export class LightSerializationAdapter extends BinaryClassSerializationAdapter {
             value.penumbra.toBinaryBuffer(buffer);
             value.distance.toBinaryBuffer(buffer);
         }
+
+        value.radius.toBinaryBuffer(buffer);
+
+        if (value.type.getValue() === LightType.POINT) {
+            value.distance.toBinaryBuffer(buffer);
+        }
     }
 
     /**
@@ -43,5 +49,11 @@ export class LightSerializationAdapter extends BinaryClassSerializationAdapter {
             value.penumbra.fromBinaryBuffer(buffer);
             value.distance.fromBinaryBuffer(buffer);
         }
+
+        value.radius.fromBinaryBuffer(buffer);
+
+        if (value.type.getValue() === LightType.POINT) {
+            value.distance.fromBinaryBuffer(buffer);
+        }
     }
 }

package/src/engine/graphics/ecs/light/LightSerializationUpgrader_0_1.d.ts

@@ -0,0 +1,5 @@
+export class LightSerializationUpgrader_0_1 extends BinaryClassUpgrader {
+    upgrade(source: any, target: any): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=LightSerializationUpgrader_0_1.d.ts.map

package/src/engine/graphics/ecs/light/LightSerializationUpgrader_0_1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightSerializationUpgrader_0_1.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/light/LightSerializationUpgrader_0_1.js"],"names":[],"mappings":"AAGA;IAII,wCAkBC;CACJ;oCA1BmC,oDAAoD"}

package/src/engine/graphics/ecs/light/LightSerializationUpgrader_0_1.js

@@ -0,0 +1,27 @@
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+import { LightType } from "./LightType.js";
+
+export class LightSerializationUpgrader_0_1 extends BinaryClassUpgrader {
+    __startVersion = 0;
+    __targetVersion = 1;
+
+    upgrade(source, target) {
+        const type = source.readUint8();
+        target.writeUint8(type);
+        target.writeUint32(source.readUint32());
+        target.writeFloat64(source.readFloat64());
+        target.writeUint8(source.readUint8());
+
+        if (type === LightType.SPOT) {
+            target.writeFloat64(source.readFloat64());
+            target.writeFloat64(source.readFloat64());
+            target.writeFloat64(source.readFloat64());
+        }
+
+        target.writeFloat64(0);
+
+        if (type === LightType.POINT) {
+            target.writeFloat64(1);
+        }
+    }
+}

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

@@ -28,6 +28,15 @@ declare class Water {
      * @type {Vector1}
      */
     roughness: Vector1;
+    /**
+     * Whether the body's surface keeps moving while no view sees it. Off (the default), a hidden body is paused:
+     * its wave particles stand still and its wind turn holds until it comes back into view, and it costs one
+     * culling test a frame. On, it is simulated every frame wherever the camera looks, at the cost of a visible
+     * body's simulation — for water whose ripples must have travelled on when the camera turns back.
+     * Ambient waves follow time, not state: they are current either way.
+     * @type {ObservedBoolean}
+     */
+    simulateWhenHidden: ObservedBoolean;
     /** Optical edits queue a scene row update. */
     onChanged: Signal;
     /** @param {ParticipatingMedium} value */
@@ -42,6 +51,7 @@ declare class Water {
     toJSON(): {
         ior: number;
         roughness: number;
+        simulateWhenHidden: boolean;
         medium: any;
     };
     #private;
@@ -50,6 +60,7 @@ declare namespace Water {
     let typeName: string;
 }
 import Vector1 from "../../../../core/geom/Vector1.js";
+import ObservedBoolean from "../../../../core/model/ObservedBoolean.js";
 import Signal from "../../../../core/events/signal/Signal.js";
 import { ParticipatingMedium } from "../../../../shade/renderer/medium/ParticipatingMedium.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":";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"}
+{"version":3,"file":"Water.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/Water.js"],"names":[],"mappings":";AAUA;;;;;;;;;;;;;;;GAeG;AACH;IA6CI,0BASC;IArDD;;;OAGG;IACH,KAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,WAFU,OAAO,CAEa;IAE9B;;;;;;;OAOG;IACH,oBAFU,eAAe,CAEuB;IAEhD,8CAA8C;IAC9C,kBAAyB;IAWzB,yCAAyC;IACzC,uCAMC;IAbD;;;;OAIG;IACH,kCAAqC;IAqBrC,0BAoBC;IAED;;;;;MAOC;;CACJ;;;;oBA/GmB,kCAAkC;4BAC1B,2CAA2C;mBAFpD,0CAA0C;oCAGzB,0DAA0D"}

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

@@ -1,5 +1,6 @@
 import Signal from "../../../../core/events/signal/Signal.js";
 import Vector1 from "../../../../core/geom/Vector1.js";
+import ObservedBoolean from "../../../../core/model/ObservedBoolean.js";
 import { ParticipatingMedium } from "../../../../shade/renderer/medium/ParticipatingMedium.js";
 import {
     participating_medium_from_json,
@@ -37,6 +38,16 @@ class Water {
      */
     roughness = new Vector1(0.02);
 
+    /**
+     * Whether the body's surface keeps moving while no view sees it. Off (the default), a hidden body is paused:
+     * its wave particles stand still and its wind turn holds until it comes back into view, and it costs one
+     * culling test a frame. On, it is simulated every frame wherever the camera looks, at the cost of a visible
+     * body's simulation — for water whose ripples must have travelled on when the camera turns back.
+     * Ambient waves follow time, not state: they are current either way.
+     * @type {ObservedBoolean}
+     */
+    simulateWhenHidden = new ObservedBoolean(false);
+
     /** Optical edits queue a scene row update. */
     onChanged = new Signal();
     /** @type {ParticipatingMedium|null} */
@@ -61,6 +72,7 @@ class Water {
     constructor(options) {
         this.ior.onChanged.add(this.#changed);
         this.roughness.onChanged.add(this.#changed);
+        this.simulateWhenHidden.onChanged.add(this.#changed);
         this.medium = water_medium_default();
         if (options !== undefined) {
             console.error('Constructor options are deprecated');
@@ -81,6 +93,10 @@ class Water {
             this.roughness.fromJSON(json.roughness);
         }
 
+        if (typeof json.simulateWhenHidden === 'boolean') {
+            this.simulateWhenHidden.fromJSON(json.simulateWhenHidden);
+        }
+
         if (json.medium !== null && typeof json.medium === 'object') {
             participating_medium_from_json(this.medium, json.medium);
         }
@@ -90,6 +106,7 @@ class Water {
         return {
             ior: this.ior.toJSON(),
             roughness: this.roughness.toJSON(),
+            simulateWhenHidden: this.simulateWhenHidden.toJSON(),
             medium: participating_medium_to_json(this.medium),
         };
     }

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,QAOf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QAOf;CACJ;gDAnC+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,QAQf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QAQf;CACJ;gDArC+C,gEAAgE;kBAK9F,YAAY"}

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

@@ -8,7 +8,7 @@ import Water from "./Water.js";
 export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
 
     klass = Water;
-    version = 4;
+    version = 5;
 
     /**
      *
@@ -20,6 +20,7 @@ export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
         buffer.writeFloat32(value.roughness.getValue());
 
         serialize_participating_medium(buffer, value.medium);
+        value.simulateWhenHidden.toBinaryBuffer(buffer);
     }
 
     /**
@@ -32,5 +33,6 @@ export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
         value.roughness.set(buffer.readFloat32());
 
         deserialize_participating_medium(buffer, value.medium);
+        value.simulateWhenHidden.fromBinaryBuffer(buffer);
     }
 }

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

@@ -0,0 +1,9 @@
+/**
+ * Keep version 4's optics and append `simulateWhenHidden` as version 5 introduced it: off, so a body saved before
+ * pauses while hidden, like every body by default.
+ */
+export class WaterSerializationUpgrader_4_5 extends BinaryClassUpgrader {
+    upgrade(source: any, target: any): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=WaterSerializationUpgrader_4_5.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WaterSerializationUpgrader_4_5.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationUpgrader_4_5.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH;IAII,wCAOC;CACJ;oCAvBmC,oDAAoD"}

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

@@ -0,0 +1,24 @@
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+import {
+    deserialize_participating_medium,
+    serialize_participating_medium
+} from "../../../../shade/renderer/medium/participating_medium_serialization.js";
+import { water_medium_default } from "../../../../shade/renderer/medium/water/water_presets.js";
+
+/**
+ * Keep version 4's optics and append `simulateWhenHidden` as version 5 introduced it: off, so a body saved before
+ * pauses while hidden, like every body by default.
+ */
+export class WaterSerializationUpgrader_4_5 extends BinaryClassUpgrader {
+    __startVersion = 4;
+    __targetVersion = 5;
+
+    upgrade(source, target) {
+        target.writeFloat32(source.readFloat32());
+        target.writeFloat32(source.readFloat32());
+        const medium = water_medium_default();
+        deserialize_participating_medium(source, medium);
+        serialize_participating_medium(target, medium);
+        target.writeUint8(0);
+    }
+}

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

@@ -1,29 +1,50 @@
+/** Amplitude reflection coefficient of a water body's outline when nothing says otherwise. */
+export const WATER_WAVES_SHORE_REFLECTION_DEFAULT: 0.5;
 export default WaterWaves;
 /**
- * What drives the waves of the {@link Water} on the same entity, for the primitive wave
- * simulation.
+ * 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).
  *
- * 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.
+ * 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.
+ *
+ * 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.
  */
 declare 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).
+     * Wind speed at 10 m, m/s.
      * @type {Vector1}
      */
     windSpeed: Vector1;
     /**
-     * Direction the wind blows towards, radians in the mesh's local xz plane, measured from +x towards +z.
+     * 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
+     * (a fully developed sea at 10 m/s needs about 170 km).
+     * @type {Vector1}
+     */
+    upwindFetch: Vector1;
+    /**
+     * Amplitude reflection coefficient of the mesh's outline for wave particles: 0 a beach that absorbs
+     * them, 1 a wall that returns them whole.
+     * @type {Vector1}
+     */
+    shoreReflection: Vector1;
     fromJSON(json: any): void;
     toJSON(): {
         windSpeed: number;
         windDirection: number;
+        upwindFetch: number;
+        shoreReflection: number;
     };
 }
 declare namespace WaterWaves {

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;;;;;;;;GAQG;AACH;IACI;;;;OAIG;IACH,WAFU,OAAO,CAEU;IAE3B;;;OAGG;IACH,eAFU,OAAO,CAEc;IAE/B,0BAQC;IAED;;;MAKC;CACJ;;;;oBAzCmB,kCAAkC"}
+{"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"}

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

@@ -1,28 +1,50 @@
 import Vector1 from "../../../../core/geom/Vector1.js";
 
+/** Amplitude reflection coefficient of a water body's outline when nothing says otherwise. */
+export const WATER_WAVES_SHORE_REFLECTION_DEFAULT = 0.5;
+
 /**
- * What drives the waves of the {@link Water} on the same entity, for the primitive wave
- * simulation.
+ * 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).
+ *
+ * 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.
  *
- * 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.
+ * 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.
  */
 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).
+     * Wind speed at 10 m, m/s.
      * @type {Vector1}
      */
     windSpeed = new Vector1(3);
 
     /**
-     * Direction the wind blows towards, radians in the mesh's local xz plane, measured from +x towards +z.
+     * 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 = new Vector1(0);
 
+    /**
+     * 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
+     * (a fully developed sea at 10 m/s needs about 170 km).
+     * @type {Vector1}
+     */
+    upwindFetch = new Vector1(0);
+
+    /**
+     * Amplitude reflection coefficient of the mesh's outline for wave particles: 0 a beach that absorbs
+     * them, 1 a wall that returns them whole.
+     * @type {Vector1}
+     */
+    shoreReflection = new Vector1(WATER_WAVES_SHORE_REFLECTION_DEFAULT);
+
     fromJSON(json) {
         if (typeof json.windSpeed === 'number') {
             this.windSpeed.fromJSON(json.windSpeed);
@@ -31,12 +53,22 @@ class WaterWaves {
         if (typeof json.windDirection === 'number') {
             this.windDirection.fromJSON(json.windDirection);
         }
+
+        if (typeof json.upwindFetch === 'number') {
+            this.upwindFetch.fromJSON(json.upwindFetch);
+        }
+
+        if (typeof json.shoreReflection === 'number') {
+            this.shoreReflection.fromJSON(json.shoreReflection);
+        }
     }
 
     toJSON() {
         return {
             windSpeed: this.windSpeed.toJSON(),
             windDirection: this.windDirection.toJSON(),
+            upwindFetch: this.upwindFetch.toJSON(),
+            shoreReflection: this.shoreReflection.toJSON(),
         };
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"WaterWavesSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterWavesSerializationAdapter.js"],"names":[],"mappings":"AAGA;;IAEI,yBAAmB;IAGnB;;;OAGG;IACH,uCAFW,UAAU,QAKpB;IAED;;;OAGG;IACH,yCAFW,UAAU,QAKpB;CACJ;gDAzB+C,gEAAgE;uBACzF,iBAAiB"}
+{"version":3,"file":"WaterWavesSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterWavesSerializationAdapter.js"],"names":[],"mappings":"AAGA;;IAEI,yBAAmB;IAGnB;;;OAGG;IACH,uCAFW,UAAU,QAOpB;IAED;;;OAGG;IACH,yCAFW,UAAU,QAOpB;CACJ;gDA7B+C,gEAAgE;uBACzF,iBAAiB"}

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

@@ -1,26 +1,30 @@
-import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
-import WaterWaves from "./WaterWaves.js";
-
-export class WaterWavesSerializationAdapter extends BinaryClassSerializationAdapter {
-
-    klass = WaterWaves;
-    version = 0;
-
-    /**
-     * @param {BinaryBuffer} buffer
-     * @param {WaterWaves} value
-     */
-    serialize(buffer, value) {
-        buffer.writeFloat32(value.windSpeed.getValue());
-        buffer.writeFloat32(value.windDirection.getValue());
-    }
-
-    /**
-     * @param {BinaryBuffer} buffer
-     * @param {WaterWaves} value
-     */
-    deserialize(buffer, value) {
-        value.windSpeed.set(buffer.readFloat32());
-        value.windDirection.set(buffer.readFloat32());
-    }
-}
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import WaterWaves from "./WaterWaves.js";
+
+export class WaterWavesSerializationAdapter extends BinaryClassSerializationAdapter {
+
+    klass = WaterWaves;
+    version = 1;
+
+    /**
+     * @param {BinaryBuffer} buffer
+     * @param {WaterWaves} value
+     */
+    serialize(buffer, value) {
+        buffer.writeFloat32(value.windSpeed.getValue());
+        buffer.writeFloat32(value.windDirection.getValue());
+        buffer.writeFloat32(value.upwindFetch.getValue());
+        buffer.writeFloat32(value.shoreReflection.getValue());
+    }
+
+    /**
+     * @param {BinaryBuffer} buffer
+     * @param {WaterWaves} value
+     */
+    deserialize(buffer, value) {
+        value.windSpeed.set(buffer.readFloat32());
+        value.windDirection.set(buffer.readFloat32());
+        value.upwindFetch.set(buffer.readFloat32());
+        value.shoreReflection.set(buffer.readFloat32());
+    }
+}

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

@@ -0,0 +1,6 @@
+/** Keep version 0's wind and append the version-1 defaults. */
+export class WaterWavesSerializationUpgrader_0_1 extends BinaryClassUpgrader {
+    upgrade(source: any, target: any): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=WaterWavesSerializationUpgrader_0_1.d.ts.map