@woosh/meep-engine 3.36.0 → 3.38.0

package/package.json

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

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

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

@@ -87,6 +87,7 @@ import {
 import Water from "../../graphics/ecs/water/Water.js";
 import { WaterSerializationAdapter } from "../../graphics/ecs/water/WaterSerializationAdapter.js";
 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 { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
 import {
     GridPosition2TransformSerializationAdapter
@@ -280,6 +281,7 @@ export function populateEngineSerializationRegistry(registry) {
     registry.registerUpgrader(Terrain.typeName, new TerrainSerializationUpgrader_1_2());
     registry.registerUpgrader(Highlight.typeName, new HighlightSerializationUpgrader_0_1());
     registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_0_1());
+    registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_1_2());
 
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
     registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());

package/src/engine/ecs/transform/TRANSFORM64_EVENT_PLACED.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An explicit placement/teleport, after the new world pose has been published
+ * with TRANSFORM64_EVENT_CHANGE. Motion consumers must reset their previous
+ * pose instead of sweeping from the old location. TransformAttachmentSystem
+ * forwards this event down the spatial hierarchy, including GPU-owned links.
+ *
+ * No payload; listeners read the transform on the entity they subscribed to.
+ * @type {string}
+ */
+export const TRANSFORM64_EVENT_PLACED: string;
+//# sourceMappingURL=TRANSFORM64_EVENT_PLACED.d.ts.map

package/src/engine/ecs/transform/TRANSFORM64_EVENT_PLACED.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TRANSFORM64_EVENT_PLACED.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/TRANSFORM64_EVENT_PLACED.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,uCAFU,MAAM,CAE8C"}

package/src/engine/ecs/transform/TRANSFORM64_EVENT_PLACED.js

@@ -0,0 +1,10 @@
+/**
+ * An explicit placement/teleport, after the new world pose has been published
+ * with TRANSFORM64_EVENT_CHANGE. Motion consumers must reset their previous
+ * pose instead of sweeping from the old location. TransformAttachmentSystem
+ * forwards this event down the spatial hierarchy, including GPU-owned links.
+ *
+ * No payload; listeners read the transform on the entity they subscribed to.
+ * @type {string}
+ */
+export const TRANSFORM64_EVENT_PLACED = "@transform64/placed";

package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransformAttachmentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform-attachment/TransformAttachmentSystem.js"],"names":[],"mappings":"AAiMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH;;IAEI;;;;OAIG;IACH,mBAAgB;IAEhB;;;;;OAKG;IACH,mBAAoC;IAEpC;;;;OAIG;IACH,gBAAa;IACb,qBAAiB;IACjB,uBAAmB;IAEnB,kEAAkD;IAClD,+HAGE;IAEF;;;;OAIG;IACH,wBAsBC;IAED;;;;OAIG;IACH,kBAEC;IAED;;;;;OAKG;IACH,yBAYC;IAED;;;;;;;;OAQG;IACH,uBALW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,wBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,iBAJW,mBAAmB,aACnB,WAAW,UACX,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,mBAJW,mBAAmB,aACnB,WAAW,UACX,MAAM,QAkBhB;IAED,6BAoBC;CACJ;uBAvZsB,cAAc;4BAET,6BAA6B;oCAEK,0BAA0B;4CAX5C,oDAAoD"}
+{"version":3,"file":"TransformAttachmentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform-attachment/TransformAttachmentSystem.js"],"names":[],"mappings":"AAiNA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH;;IAEI;;;;OAIG;IACH,mBAAgB;IAEhB;;;;;OAKG;IACH,mBAAoC;IAEpC;;;;OAIG;IACH,gBAAa;IACb,qBAAiB;IACjB,uBAAmB;IAEnB,kEAAkD;IAClD,+HAGE;IAEF;;;;OAIG;IACH,wBAsBC;IAED;;;;OAIG;IACH,kBAEC;IAED;;;;;OAKG;IACH,yBAYC;IAED;;;;;;;;OAQG;IACH,uBALW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,wBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,iBAJW,mBAAmB,aACnB,WAAW,UACX,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,mBAJW,mBAAmB,aACnB,WAAW,UACX,MAAM,QAkBhB;IAED,6BAoBC;CACJ;uBAvasB,cAAc;4BAGT,6BAA6B;oCAEK,0BAA0B;4CAZ5C,oDAAoD"}

package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.js

@@ -9,6 +9,7 @@ import { gpu_authority_has } from "../gpu/gpu_authority_has.js";
 import { EntityChildIndex } from "../hierarchy/EntityChildIndex.js";
 import { System } from "../System.js";
 import { TRANSFORM64_EVENT_CHANGE } from "../transform/TRANSFORM64_EVENT_CHANGE.js";
+import { TRANSFORM64_EVENT_PLACED } from "../transform/TRANSFORM64_EVENT_PLACED.js";
 import { Transform64 } from "../transform/Transform64.js";
 import { TRANSFORM_ATTACHMENT_EVENT_CHANGE } from "./TRANSFORM_ATTACHMENT_EVENT_CHANGE.js";
 import { TransformAttachment, TransformAttachmentFlags } from "./TransformAttachment.js";
@@ -128,7 +129,18 @@ class UpdateContext {
         this.ecd.removeComponentFromEntity(this.entity, TransformAttachment);
     }
 
+    handle_parent_placement() {
+        if (this.#linked) {
+            // The preceding change announcement already composed CPU worlds.
+            // Forward intent even through links whose worlds belong to the GPU.
+            this.ecd.sendEvent(this.entity, TRANSFORM64_EVENT_PLACED);
+        }
+    }
+
     link() {
+        this.ecd.addEntityEventListener(
+            this.attachment.parent, TRANSFORM64_EVENT_PLACED, this.handle_parent_placement, this
+        );
         // Neither transform carries signals any more, so both announcements come through the
         // dataset, on the channel belonging to the thing that moved. The parent's pose arrives as
         // TRANSFORM64_EVENT_CHANGE on the parent - whether it is a root somebody moved or a link
@@ -168,6 +180,10 @@ class UpdateContext {
 
         this.#linked = false;
 
+        this.ecd.removeEntityEventListener(
+            this.attachment.parent, TRANSFORM64_EVENT_PLACED, this.handle_parent_placement, this
+        );
+
         this.ecd.removeEntityEventListener(
             this.attachment.parent,
             TRANSFORM64_EVENT_CHANGE,

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

@@ -43,6 +43,12 @@ declare class Water {
      * @type {Vector1}
      */
     scattering: Vector1;
+    /** Air-to-water optical properties; scattering scales the authored RGB extinction. */
+    ior: Vector1;
+    opticalNormalStrength: Vector1;
+    opticalNormalScale: Vector1;
+    extinction: Vector3;
+    reflectionRoughness: Vector1;
     bvh: BvhClient;
     updateBounds(): void;
     fromJSON(json: any): void;
@@ -54,6 +60,29 @@ declare class Water {
             b: number;
             a: number;
         };
+        shoreColor: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        shoreDepthTransition: {
+            min: number;
+            max: number;
+        };
+        waveSpeed: number;
+        waveAmplitude: number;
+        waveFrequency: number;
+        scattering: number;
+        ior: number;
+        opticalNormalStrength: number;
+        opticalNormalScale: number;
+        extinction: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        reflectionRoughness: number;
     };
 }
 declare namespace Water {
@@ -62,5 +91,6 @@ declare namespace Water {
 import Vector1 from "../../../../core/geom/Vector1.js";
 import { Color } from "../../../../core/color/Color.js";
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
+import Vector3 from "../../../../core/geom/Vector3.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":";AAMA;;;;;GAKG;AACH;IAgDI,0BAMC;IArDD,eAAuB;IACvB;;;OAGG;IACH,OAFU,KAAK,CAEgB;IAG/B;;;OAGG;IACH,sBAFU,eAAe,CAE0B;IAGnD;;;OAGG;IACH,YAFU,KAAK,CAE6B;IAE5C;;;OAGG;IACH,WAFU,OAAO,CAEY;IAE7B;;;OAGG;IACH,eAFU,OAAO,CAEgB;IAEjC;;;OAGG;IACH,eAFU,OAAO,CAEc;IAE/B;;;OAGG;IACH,YAFU,OAAO,CAEa;IAE9B,eAAsB;IAUtB,qBAcC;IAED,0BAOC;IAED;;;;;;;;MAKC;CACJ;;;;oBAjGmB,kCAAkC;sBADhC,iCAAiC;gCAEvB,mDAAmD;0BAHzD,yCAAyC"}
+{"version":3,"file":"Water.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/Water.js"],"names":[],"mappings":";AAOA;;;;;GAKG;AACH;IAuDI,0BAMC;IA5DD,eAAuB;IACvB;;;OAGG;IACH,OAFU,KAAK,CAEgB;IAG/B;;;OAGG;IACH,sBAFU,eAAe,CAE0B;IAGnD;;;OAGG;IACH,YAFU,KAAK,CAE6B;IAE5C;;;OAGG;IACH,WAFU,OAAO,CAEY;IAE7B;;;OAGG;IACH,eAFU,OAAO,CAEgB;IAEjC;;;OAGG;IACH,eAFU,OAAO,CAEc;IAE/B;;;OAGG;IACH,YAFU,OAAO,CAEa;IAE9B,sFAAsF;IACtF,aAAwB;IACxB,+BAA0C;IAC1C,4BAAoC;IACpC,oBAA4C;IAC5C,6BAAwC;IAExC,eAAsB;IAUtB,qBAcC;IAED,0BAcC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAWC;CACJ;;;;oBAtHmB,kCAAkC;sBADhC,iCAAiC;gCAGvB,mDAAmD;oBAD/D,kCAAkC;0BAH5B,yCAAyC"}

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

@@ -1,104 +1,125 @@
-import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
-import { Color } from "../../../../core/color/Color.js";
-import Vector1 from "../../../../core/geom/Vector1.js";
-import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
-import { WATER_SIZE } from "./WATER_SIZE.js";
-
-/**
- * A body of water flooding the level, as authored data and nothing else.
- *
- * The component holds no renderer state: `WaterSystem` reads these values every frame onto the
- * surface its pass draws, which is why an edit needs no notification to be picked up.
- */
-class Water {
-    level = new Vector1(0);
-    /**
-     *
-     * @type {Color}
-     */
-    color = new Color(0, 0.3, 0.5);
-
-
-    /**
-     * Defines what is considered as shore as well as how long is the transition between shore and deep water
-     * @type {NumericInterval}
-     */
-    shoreDepthTransition = new NumericInterval(0.7, 2);
-
-
-    /**
-     * Color of the water at the shore
-     * @type {Color}
-     */
-    shoreColor = new Color(0.584, 0.792, 0.850);
-
-    /**
-     *
-     * @type {Vector1}
-     */
-    waveSpeed = new Vector1(1.8);
-
-    /**
-     *
-     * @type {Vector1}
-     */
-    waveAmplitude = new Vector1(0.3);
-
-    /**
-     *
-     * @type {Vector1}
-     */
-    waveFrequency = new Vector1(1);
-
-    /**
-     * Scattering of light, the higher this value is - the more opaque water will become
-     * @type {Vector1}
-     */
-    scattering = new Vector1(1.2);
-
-    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.color === 'object') {
-            this.color.fromJSON(json.color);
-        }
-    }
-
-    toJSON() {
-        return {
-            level: this.level.toJSON(),
-            color: this.color.toJSON()
-        };
-    }
-}
-
-Water.typeName = "Water";
-
-export default Water;
+import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
+import { Color } from "../../../../core/color/Color.js";
+import Vector1 from "../../../../core/geom/Vector1.js";
+import Vector3 from "../../../../core/geom/Vector3.js";
+import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
+import { WATER_SIZE } from "./WATER_SIZE.js";
+
+/**
+ * A body of water flooding the level, as authored data and nothing else.
+ *
+ * The component holds no renderer state: `WaterSystem` reads these values every frame onto the
+ * surface its pass draws, which is why an edit needs no notification to be picked up.
+ */
+class Water {
+    level = new Vector1(0);
+    /**
+     *
+     * @type {Color}
+     */
+    color = new Color(0, 0.3, 0.5);
+
+
+    /**
+     * Defines what is considered as shore as well as how long is the transition between shore and deep water
+     * @type {NumericInterval}
+     */
+    shoreDepthTransition = new NumericInterval(0.7, 2);
+
+
+    /**
+     * Color of the water at the shore
+     * @type {Color}
+     */
+    shoreColor = new Color(0.584, 0.792, 0.850);
+
+    /**
+     *
+     * @type {Vector1}
+     */
+    waveSpeed = new Vector1(1.8);
+
+    /**
+     *
+     * @type {Vector1}
+     */
+    waveAmplitude = new Vector1(0.3);
+
+    /**
+     *
+     * @type {Vector1}
+     */
+    waveFrequency = new Vector1(1);
+
+    /**
+     * Scattering of light, the higher this value is - the more opaque water will become
+     * @type {Vector1}
+     */
+    scattering = new Vector1(1.2);
+
+    /** Air-to-water optical properties; scattering scales the authored RGB extinction. */
+    ior = new Vector1(1.33);
+    opticalNormalStrength = new Vector1(0.08);
+    opticalNormalScale = new Vector1(3);
+    extinction = new Vector3(0.12, 0.035, 0.02);
+    reflectionRoughness = new Vector1(0.08);
+
+    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.color === 'object') {
+            this.color.fromJSON(json.color);
+        }
+        for (const key of ['waveSpeed', 'waveAmplitude', 'waveFrequency', 'scattering', 'ior',
+            'opticalNormalStrength', 'opticalNormalScale', 'reflectionRoughness']) {
+            if (typeof json[key] === 'number') { this[key].fromJSON(json[key]); }
+        }
+        for (const key of ['shoreColor', 'shoreDepthTransition', 'extinction']) {
+            if (json[key] !== null && typeof json[key] === 'object') { this[key].fromJSON(json[key]); }
+        }
+    }
+
+    toJSON() {
+        return {
+            level: this.level.toJSON(),
+            color: this.color.toJSON(),
+            shoreColor: this.shoreColor.toJSON(), shoreDepthTransition: this.shoreDepthTransition.toJSON(),
+            waveSpeed: this.waveSpeed.toJSON(), waveAmplitude: this.waveAmplitude.toJSON(),
+            waveFrequency: this.waveFrequency.toJSON(), scattering: this.scattering.toJSON(),
+            ior: this.ior.toJSON(), opticalNormalStrength: this.opticalNormalStrength.toJSON(),
+            opticalNormalScale: this.opticalNormalScale.toJSON(), extinction: this.extinction.toJSON(),
+            reflectionRoughness: this.reflectionRoughness.toJSON(),
+        };
+    }
+}
+
+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":"AAGA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,uCAFW,KAAK,QAmBf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QAyBf;CACJ;gDA7D+C,gEAAgE;kBAC9F,YAAY"}
+{"version":3,"file":"WaterSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationAdapter.js"],"names":[],"mappings":"AAGA;;IAEI,oBAAc;IAGd;;;;OAIG;IACH,uCAFW,KAAK,QA0Bf;IAED;;;;OAIG;IACH,yCAFW,KAAK,QA8Bf;CACJ;gDAzE+C,gEAAgE;kBAC9F,YAAY"}

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

@@ -4,7 +4,7 @@ import Water from "./Water.js";
 export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
 
     klass = Water;
-    version = 1;
+    version = 2;
 
     /**
      *
@@ -28,6 +28,13 @@ export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
         buffer.writeFloat32(value.waveFrequency.getValue());
 
         buffer.writeFloat32(value.scattering.getValue());
+        buffer.writeFloat32(value.ior.getValue());
+        buffer.writeFloat32(value.opticalNormalStrength.getValue());
+        buffer.writeFloat32(value.opticalNormalScale.getValue());
+        buffer.writeFloat32(value.reflectionRoughness.getValue());
+        buffer.writeFloat32(value.extinction.x);
+        buffer.writeFloat32(value.extinction.y);
+        buffer.writeFloat32(value.extinction.z);
     }
 
     /**
@@ -58,5 +65,10 @@ export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
         value.waveAmplitude.set(waveAmplitude);
         value.waveFrequency.set(waveFrequency);
         value.scattering.set(scattering);
+        value.ior.set(buffer.readFloat32());
+        value.opticalNormalStrength.set(buffer.readFloat32());
+        value.opticalNormalScale.set(buffer.readFloat32());
+        value.reflectionRoughness.set(buffer.readFloat32());
+        value.extinction.set(buffer.readFloat32(), buffer.readFloat32(), buffer.readFloat32());
     }
 }

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

@@ -0,0 +1,6 @@
+/** Preserve the version-1 appearance record and append the new component defaults. */
+export class WaterSerializationUpgrader_1_2 extends BinaryClassUpgrader {
+    upgrade(source: any, target: any): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=WaterSerializationUpgrader_1_2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WaterSerializationUpgrader_1_2.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/water/WaterSerializationUpgrader_1_2.js"],"names":[],"mappings":"AAGA,sFAAsF;AACtF;IAII,wCAQC;CACJ;oCAjBmC,oDAAoD"}

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

@@ -0,0 +1,18 @@
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+import Water from "./Water.js";
+
+/** Preserve the version-1 appearance record and append the new component defaults. */
+export class WaterSerializationUpgrader_1_2 extends BinaryClassUpgrader {
+    __startVersion = 1;
+    __targetVersion = 2;
+
+    upgrade(source, target) {
+        const old = new Uint8Array(38);
+        source.readBytes(old, 0, old.length);
+        target.writeBytes(old, 0, old.length);
+        const defaults = new Water();
+        for (const value of [defaults.ior.getValue(), defaults.opticalNormalStrength.getValue(),
+            defaults.opticalNormalScale.getValue(), defaults.reflectionRoughness.getValue(),
+            defaults.extinction.x, defaults.extinction.y, defaults.extinction.z]) { target.writeFloat32(value); }
+    }
+}

package/src/engine/graphics3/WaterSystem.d.ts

@@ -1,9 +1,8 @@
 /**
  * Draws the level's water under Shade.
  *
- * **Water is a transparent pass on top of opaque**, so this system owns an extension rather than putting
- * anything in the scene: it registers once at startup against {@link FramePhase.AfterLighting} —
- * opaque lit and composited, transparency not yet run — and keeps a list of surfaces the pass draws.
+ * Water is a shared AVBOIT side channel. The extension is debug presentation only; normal frames
+ * composite water exactly once alongside particles, meshlets and trails in AVBOIT's resolve.
  *
  * Registration does not wait for a device. `GraphicsEngine` holds extensions and applies them
  * to the renderer when one exists and again after a restart (E9, §4.8).
@@ -14,6 +13,23 @@ export class WaterSystem extends System<any> {
      */
     constructor(graphics: GraphicsEngine);
     dependencies: (typeof Water)[];
+    get settings(): {
+        enabled: boolean;
+        max_distance: number;
+        distance_tolerance: number;
+        max_updates: number;
+        fallback_steps: number;
+        mode: number; /**
+         * @type {GPUWaterRenderer}
+         */
+        reflections: number;
+        debug_view: number;
+    };
+    /** The registered channel, for diagnostics such as testing registration order. */
+    get transparency_channel(): GPUWaterRenderer;
+    request_probe(uv: any): Promise<any>;
+    set time(seconds: number);
+    get time(): number;
     /**
      * What the pass draws. Read-only — the surfaces follow the entities, and a harness that wants
      * one gone takes its component off.
@@ -41,9 +57,8 @@ export class WaterSystem extends System<any> {
     #private;
 }
 /**
- * Water is a transparent surface over the lit opaque scene, so it draws at
- * {@link FramePhase.AfterLighting} — opaque lit and composited, transparency not yet run, so what
- * transparency draws afterwards blends over the water rather than under it.
+ * Opt-in water inspection after temporal processing. Kept under the exported name
+ * for compatibility; this never records a water color overlay in normal rendering.
  */
 export class WaterExtension extends RenderExtension {
     /**
@@ -55,5 +70,6 @@ export class WaterExtension extends RenderExtension {
 }
 import { System } from "../ecs/System.js";
 import Water from "../graphics/ecs/water/Water.js";
+import { GPUWaterRenderer } from "../../shade/renderer/water/GPUWaterRenderer.js";
 import { RenderExtension } from "../../shade/renderer/extension/RenderExtension.js";
 //# sourceMappingURL=WaterSystem.d.ts.map

package/src/engine/graphics3/WaterSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/WaterSystem.js"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH;IA+CI;;OAEG;IACH,sCAMC;IAvDD,+BAAuB;IAoCvB;;;;;OAKG;IACH,+BAEC;IAaD,2CAIC;IAED,4CASC;IAED;;OAEG;IACH,kCAeC;IAED;;;OAGG;IACH,YAHW,KAAK,UACL,MAAM,QA6BhB;IAED;;;OAGG;IACH,cAHW,KAAK,UACL,MAAM,QAgBhB;IAED,6BAaC;;CAgFJ;AAED;;;;GAIG;AACH;IAUI;;OAEG;IACH,oBAFW,WAAW,EAMrB;IAED,yBAEC;;CACJ;uBAhSsB,kBAAkB;kBAHvB,gCAAgC;gCAOlB,mDAAmD"}
+{"version":3,"file":"WaterSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/WaterSystem.js"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH;IA6DI;;OAEG;IACH,sCAMC;IArED,+BAAuB;IA6BvB;;;;;;sBAtBA;;WAEG;;;MAoB+C;IAElD,kFAAkF;IAClF,6CAAqD;IAErD,qCAA8D;IAG9D,0BAIC;IALD,mBAAiC;IAcjC;;;;;OAKG;IACH,+BAEC;IAaD,2CAMC;IAED,4CAWC;IAED;;OAEG;IACH,kCAGC;IAED;;;OAGG;IACH,YAHW,KAAK,UACL,MAAM,QA+BhB;IAED;;;OAGG;IACH,cAHW,KAAK,UACL,MAAM,QAgBhB;IAED,6BAgBC;;CA4FJ;AAED;;;GAGG;AACH;IAWI;;OAEG;IACH,oBAFW,WAAW,EAMrB;IAED,yBAEC;;CACJ;uBArTsB,kBAAkB;kBAHvB,gCAAgC;iCAIjB,gDAAgD;gCAGjD,mDAAmD"}