@woosh/meep-engine 3.0.0 → 3.0.2

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.d.ts

@@ -5,27 +5,28 @@
 export class ShadedGeometry {
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
+     * @param {MeshletGeometry|BufferGeometry} geometry
+     * @param {ShadeMaterial|Material} material
      * @param {DrawMode} [draw_mode]
      * @return {ShadedGeometry}
      */
-    static from(geometry: THREE.BufferGeometry, material: THREE.Material, draw_mode?: DrawMode): ShadedGeometry;
+    static from(geometry: MeshletGeometry | BufferGeometry, material: ShadeMaterial | Material, draw_mode?: DrawMode): ShadedGeometry;
     /**
-     *
-     * @type {THREE.BufferGeometry|null}
+     * Whatever the running renderer draws geometry from — a `MeshletGeometry` under Shade, and a
+     * `Geometry` where the primitive was built rather than loaded.
+     * @type {MeshletGeometry|Geometry|BufferGeometry|null}
      */
-    geometry: THREE.BufferGeometry | null;
+    geometry: MeshletGeometry | Geometry | BufferGeometry | null;
     /**
      *
-     * @type {THREE.Material|null}
+     * @type {ShadeMaterial|Material|null}
      */
-    material: THREE.Material | null;
+    material: ShadeMaterial | Material | null;
     /**
      * Optional extra material used for shadowmaps
-     * @type {THREE.Material|null}
+     * @type {ShadeMaterial|Material|null}
      */
-    depth_material: THREE.Material | null;
+    depth_material: ShadeMaterial | Material | null;
     __bvh_leaf: BvhClient;
     /**
      * Transient, assigned in the system
@@ -151,11 +152,11 @@ export class ShadedGeometry {
     getBoundingBox(destination: AABB3): void;
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
+     * @param {MeshletGeometry|BufferGeometry} geometry
+     * @param {ShadeMaterial|Material} material
      * @param {DrawMode} [draw_mode]
      */
-    from(geometry: THREE.BufferGeometry, material: THREE.Material, draw_mode?: DrawMode): void;
+    from(geometry: MeshletGeometry | BufferGeometry, material: ShadeMaterial | Material, draw_mode?: DrawMode): void;
     /**
      * Change handler subscribed to the entity's {@link Transform} while the component is
      * linked; see {@link ShadedGeometrySystem.link}.
@@ -164,6 +165,14 @@ export class ShadedGeometry {
     updateTransform(): void;
     update_bounds(): void;
     /**
+     * Raycast this primitive's own triangles on the CPU.
+     *
+     * **Requires a {@link Geometry}** — the vertex arrays themselves. A `MeshletGeometry` keeps its
+     * triangles quantized inside meshlet pages, so a `ShadedGeometry` placed by
+     * `shade_node_to_entity_composition` cannot be asked this; `geometry_build_from_meshlet_geometry`
+     * decodes one, and holding that decode is the caller's business rather than this method's.
+     * Picking a whole scene goes through the renderer's own `pick` instead (I-9) — this answers with
+     * a surface point on one primitive.
      *
      * @param {SurfacePoint3} contact if found, contact is written here
      * @param {ArrayLike<number>|number[]|Float32Array} ray 6-tuple: [origin_x, origin_y, origin_z, direction_x, direction_y, direction_z]

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShadedGeometry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js"],"names":[],"mappings":"AAwCA;;;GAGG;AACH;IAuRI;;;;;;OAMG;IACH,sBALW,MAAM,cAAc,YACpB,MAAM,QAAQ,cACd,QAAQ,GACP,cAAc,CAQzB;IAnRD;;;OAGG;IACH,UAFU,MAAM,cAAc,GAAC,IAAI,CAEnB;IAEhB;;;OAGG;IACH,UAFU,MAAM,QAAQ,GAAC,IAAI,CAEb;IAEhB;;;OAGG;IACH,gBAFU,MAAM,QAAQ,GAAC,IAAI,CAEP;IAEtB,sBAA6B;IAE7B;;;;OAIG;IACH,iBAAc;IAEd;;;;OAIG;IACH,sBAAqB;IAErB;;;;;;;;;;OAUG;IACH,MAFU,OAAK,IAAI,CAEP;IAEZ;;;OAGG;IACH,MAFU,QAAQ,GAAC,MAAM,CAEC;IAE1B;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,SAC1B,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CASjB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAUnB;IAED;;;OAGG;IACH,YAFW,cAAc,QASxB;IAED;;;OAGG;IACH,SAFa,cAAc,CAQ1B;IAED;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,0BAEC;IAED;;;;;OAKG;IACH,6CAFa,IAAI,CAMhB;IAED;;;;;OAKG;IACH,qBAFa,IAAI,CAKhB;IAED;;;;;;OAMG;IACH,6BAFa,OAAO,CAcnB;IAED;;;OAGG;IACH,4BAFW,KAAK,QAsBf;IAED;;;;;OAKG;IACH,eAJW,MAAM,cAAc,YACpB,MAAM,QAAQ,cACd,QAAQ,QAWlB;IAiBD;;;;OAIG;IACH,mBAFa,IAAI,CAgBhB;IAED,sBAMC;IAED;;;;;;OAMG;IACH,mDAJW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,qBACvC,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,GACrC,OAAO,CA4BnB;;CACJ;;kBAIS,MAAM;sBAON,OAAO;;0BA1ZS,yCAAyC;yBAM1C,eAAe;oCACJ,0BAA0B;sBANxC,wCAAwC"}
+{"version":3,"file":"ShadedGeometry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js"],"names":[],"mappings":"AAwCA;;;GAGG;AACH;IAmRI;;;;;;OAMG;IACH,sBALW,gCAA8B,YAC9B,wBAAsB,cACtB,QAAQ,GACP,cAAc,CAQzB;IA/QD;;;;OAIG;IACH,UAFU,8CAAwC,IAAI,CAEtC;IAEhB;;;OAGG;IACH,UAFU,2BAAuB,IAAI,CAErB;IAEhB;;;OAGG;IACH,gBAFU,2BAAuB,IAAI,CAEf;IAEtB,sBAA6B;IAE7B;;;;OAIG;IACH,iBAAc;IAEd;;;;OAIG;IACH,sBAAqB;IAErB;;;;;;;;;;OAUG;IACH,MAFU,OAAK,IAAI,CAEP;IAEZ;;;OAGG;IACH,MAFU,QAAQ,GAAC,MAAM,CAEC;IAE1B;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,SAC1B,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CASjB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAUnB;IAED;;;OAGG;IACH,YAFW,cAAc,QASxB;IAED;;;OAGG;IACH,SAFa,cAAc,CAQ1B;IAED;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,0BAEC;IAED;;;;;OAKG;IACH,6CAFa,IAAI,CAMhB;IAED;;;;;OAKG;IACH,qBAFa,IAAI,CAKhB;IAED;;;;;;OAMG;IACH,6BAFa,OAAO,CAcnB;IAED;;;OAGG;IACH,4BAFW,KAAK,QAsBf;IAED;;;;;OAKG;IACH,eAJW,gCAA8B,YAC9B,wBAAsB,cACtB,QAAQ,QAMlB;IAiBD;;;;OAIG;IACH,mBAFa,IAAI,CAgBhB;IAED,sBAeC;IAED;;;;;;;;;;;;;;OAcG;IACH,mDAJW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,qBACvC,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,GACrC,OAAO,CA4BnB;;CACJ;;kBAIS,MAAM;sBAON,OAAO;;0BAtaS,yCAAyC;yBAK1C,eAAe;oCACJ,0BAA0B;sBALxC,wCAAwC"}

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js

@@ -1,8 +1,8 @@
 import { m4_invert } from "../../../../core/geom/3d/mat4/m4_invert.js";
 import { assert } from "../../../../core/assert.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
 import { AABB3 } from "../../../../core/geom/3d/aabb/AABB3.js";
-import { aabb3_from_three_geometry } from "../../../../core/geom/3d/aabb/aabb3_from_three_geometry.js";
 import { aabb3_matrix4_project } from "../../../../core/geom/3d/aabb/aabb3_matrix4_project.js";
 import { ray3_array_apply_matrix4 } from "../../../../core/geom/3d/ray/ray3_array_apply_matrix4.js";
 import { GeometrySpatialQueryAccelerator } from "../../geometry/buffered/query/GeometrySpatialQueryAccelerator.js";
@@ -60,20 +60,21 @@ export class ShadedGeometry {
     #bounds_queue = null;
 
     /**
-     *
-     * @type {THREE.BufferGeometry|null}
+     * Whatever the running renderer draws geometry from — a `MeshletGeometry` under Shade, and a
+     * `Geometry` where the primitive was built rather than loaded.
+     * @type {MeshletGeometry|Geometry|BufferGeometry|null}
      */
     geometry = null;
 
     /**
      *
-     * @type {THREE.Material|null}
+     * @type {ShadeMaterial|Material|null}
      */
     material = null;
 
     /**
      * Optional extra material used for shadowmaps
-     * @type {THREE.Material|null}
+     * @type {ShadeMaterial|Material|null}
      */
     depth_material = null;
 
@@ -306,25 +307,20 @@ export class ShadedGeometry {
 
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
+     * @param {MeshletGeometry|BufferGeometry} geometry
+     * @param {ShadeMaterial|Material} material
      * @param {DrawMode} [draw_mode]
      */
     from(geometry, material, draw_mode = DrawMode.Triangles) {
         this.geometry = geometry;
         this.material = material;
         this.mode = draw_mode;
-
-        // ensure that geometry has a bounding box
-        if (geometry.boundingBox === null) {
-            geometry.computeBoundingBox();
-        }
     }
 
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
+     * @param {MeshletGeometry|BufferGeometry} geometry
+     * @param {ShadeMaterial|Material} material
      * @param {DrawMode} [draw_mode]
      * @return {ShadedGeometry}
      */
@@ -358,14 +354,31 @@ export class ShadedGeometry {
     }
 
     update_bounds() {
-        // update bounds
-        aabb3_from_three_geometry(scratch_aabb3_array, this.geometry);
+        const geometry = this.geometry;
+
+        /*
+         The box comes off the geometry's own, which is why this is only reachable for a `Geometry`:
+         it computes one on demand and remembers it, which is the whole of what
+         `GeometryFlags.BoundsNeedUpdate` is for. A `MeshletGeometry` carries its box from the build
+         and is read through {@link #node} instead — see `getBoundingBox`.
+        */
+        geometry.ensureBounds();
+
+        array_copy(geometry.bounding_box, 0, scratch_aabb3_array, 0, 6);
 
         // transform
         aabb3_matrix4_project(this.__bvh_leaf.bounds, scratch_aabb3_array, this.transform);
     }
 
     /**
+     * Raycast this primitive's own triangles on the CPU.
+     *
+     * **Requires a {@link Geometry}** — the vertex arrays themselves. A `MeshletGeometry` keeps its
+     * triangles quantized inside meshlet pages, so a `ShadedGeometry` placed by
+     * `shade_node_to_entity_composition` cannot be asked this; `geometry_build_from_meshlet_geometry`
+     * decodes one, and holding that decode is the caller's business rather than this method's.
+     * Picking a whole scene goes through the renderer's own `pick` instead (I-9) — this answers with
+     * a surface point on one primitive.
      *
      * @param {SurfacePoint3} contact if found, contact is written here
      * @param {ArrayLike<number>|number[]|Float32Array} ray 6-tuple: [origin_x, origin_y, origin_z, direction_x, direction_y, direction_z]

package/src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.d.ts

@@ -52,7 +52,7 @@ export class AbstractRenderAdapter {
     /**
      * @returns {THREE.Object3D[]}
      */
-    get objects(): import("three").Object3D<import("three").Event>[];
+    get objects(): THREE.Object3D[];
     /**
      * @returns {number}
      */

package/src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractRenderAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.js"],"names":[],"mappings":"AA4BA;IACI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IAEnB;;;;OAIG;IACH,qBAHU,MAAM,QAAQ,EAAE,CAGX;IAEf;;OAEG;IACH,yBAEC;IAED;;;;;;OAMG;IACH,gBALW,MAAM,cAAc,YACpB,MAAM,QAAQ,kBACd,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,yBAFa,IAAI,CAIhB;IAGD;;;;OAIG;IACH,sBAHW,MAAM,aAAa,0BAK7B;IAED,kBAEC;IAED,cAEC;IAED;;;;OAIG;IACH,YAFY,SAAS,CAIpB;IAED;;OAEG;IACH,iEAEC;IAED;;OAEG;IACH,2BAEC;IAED,gBAEC;IAGL;;;OAGG;IACH,wCAFU,OAAO,CAE4C;CAN5D"}
+{"version":3,"file":"AbstractRenderAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.js"],"names":[],"mappings":"AA4BA;IACI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IAEnB;;;;OAIG;IACH,qBAHU,gBAAgB,CAGX;IAEf;;OAEG;IACH,yBAEC;IAED;;;;;;OAMG;IACH,gFAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,yBAFa,IAAI,CAIhB;IAGD;;;;OAIG;IACH,mEAEC;IAED,kBAEC;IAED,cAEC;IAED;;;;OAIG;IACH,YAFY,SAAS,CAIpB;IAED;;OAEG;IACH,gCAEC;IAED;;OAEG;IACH,2BAEC;IAED,gBAEC;IAGL;;;OAGG;IACH,wCAFU,OAAO,CAE4C;CAN5D"}

package/src/engine/graphics/ecs/mesh-v2/three_object_to_entity_composition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three_object_to_entity_composition.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/three_object_to_entity_composition.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,yDAHW,MAAM,QAAQ,GACZ,UAAU,CA6CtB;2BArD0B,mCAAmC"}
+{"version":3,"file":"three_object_to_entity_composition.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/three_object_to_entity_composition.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,0EAFa,UAAU,CA6CtB;2BArD0B,mCAAmC"}

package/src/engine/graphics/ecs/render_layers_compute_depth_range.d.ts

@@ -5,7 +5,7 @@
  *
  * WHY THIS EXISTS
  *
- * `auto_set_camera_clipping_planes` and `extend_shadow_camera_near_for_casters`
+ * `extend_shadow_camera_near_for_casters` and the camera auto-clipping pass that has since gone
  * each restated two things verbatim:
  *
  *  - the three.js matrix-layout invariant that a camera's view direction is the

package/src/engine/graphics/ecs/render_layers_compute_depth_range.js

@@ -5,7 +5,7 @@
  *
  * WHY THIS EXISTS
  *
- * `auto_set_camera_clipping_planes` and `extend_shadow_camera_near_for_casters`
+ * `extend_shadow_camera_near_for_casters` and the camera auto-clipping pass that has since gone
  * each restated two things verbatim:
  *
  *  - the three.js matrix-layout invariant that a camera's view direction is the

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

@@ -1,4 +1,10 @@
 export default Water;
+/**
+ * A body of water flooding the level, as authored data and nothing else.
+ *
+ * The component holds no renderer state: `WaterSystem3` reads these values every frame onto the
+ * surface its pass draws, which is why an edit needs no notification to be picked up.
+ */
 declare class Water {
     constructor(options: any);
     level: Vector1;
@@ -38,26 +44,7 @@ declare class Water {
      */
     scattering: Vector1;
     bvh: BvhClient;
-    /**
-     *
-     * @type {ShaderMaterial}
-     */
-    __shader: ShaderMaterial;
-    /**
-     *
-     * @type {Object3D}
-     * @private
-     */
-    private __threeObject;
-    updateTransform(): void;
     updateBounds(): void;
-    /**
-     *
-     * @param {Terrain} terrain
-     * @param {number} waterSize
-     */
-    updateShaderForTerrain(terrain: Terrain, waterSize: number): void;
-    writeShaderUniforms(): void;
     fromJSON(json: any): void;
     toJSON(): {
         level: number;

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":";AAQA;IAgDI,0BA6BC;IA5ED,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;IAUlB;;;OAGG;IACH,yBAAoB;IAEpB;;;;OAIG;IACH,sBAAyB;IAY7B,wBAiBC;IAED,qBAcC;IAED;;;;OAIG;IACH,oDAFW,MAAM,QAoChB;IAED,4BA6BC;IAED,0BAOC;IAED;;;;;;;;MAKC;CACJ;;;;oBA9MmB,kCAAkC;sBADhC,iCAAiC;gCAEvB,mDAAmD;0BAHzD,yCAAyC"}
+{"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"}

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

@@ -1,215 +1,104 @@
-import { ClampToEdgeWrapping, DataTexture, FloatType, LinearFilter, RedFormat } from "three";
-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 { threeUpdateTransform } from "../../util/threeUpdateTransform.js";
-import { WATER_SIZE } from "./WATER_SIZE.js";
-
-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);
-        }
-
-
-        /**
-         *
-         * @type {ShaderMaterial}
-         */
-        this.__shader = null;
-
-        /**
-         *
-         * @type {Object3D}
-         * @private
-         */
-        this.__threeObject = null;
-
-        // monitor changes
-        this.color.onChanged.add(this.writeShaderUniforms, this);
-        this.shoreDepthTransition.onChanged.add(this.writeShaderUniforms, this);
-        this.shoreColor.onChanged.add(this.writeShaderUniforms, this);
-        this.waveSpeed.onChanged.add(this.writeShaderUniforms, this);
-        this.waveAmplitude.onChanged.add(this.writeShaderUniforms, this);
-        this.waveFrequency.onChanged.add(this.writeShaderUniforms, this);
-        this.scattering.onChanged.add(this.writeShaderUniforms, this);
-    }
-
-    updateTransform() {
-        const width = WATER_SIZE;
-        const height = WATER_SIZE;
-
-        const mesh = this.__threeObject;
-
-        if (mesh !== null) {
-
-            mesh.rotation.x = Math.PI * 0.5;
-            mesh.position.x = width / 4;
-            mesh.position.z = height / 4;
-            mesh.position.y = this.level.getValue();
-
-            threeUpdateTransform(mesh);
-        }
-
-        this.updateBounds();
-    }
-
-    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)
-        );
-    }
-
-    /**
-     *
-     * @param {Terrain} terrain
-     * @param {number} waterSize
-     */
-    updateShaderForTerrain(terrain, waterSize) {
-        const shader = this.__shader;
-
-        if (shader === null) {
-            return;
-        }
-
-        const tW = terrain.size.x * terrain.gridScale;
-        const tH = terrain.size.y * terrain.gridScale;
-
-        const heightTexture = new DataTexture(terrain.samplerHeight.data, terrain.samplerHeight.width, terrain.samplerHeight.height, RedFormat, FloatType);
-
-        heightTexture.wrapS = ClampToEdgeWrapping;
-        heightTexture.wrapT = ClampToEdgeWrapping;
-
-        heightTexture.generateMipmaps = false;
-
-        heightTexture.minFilter = LinearFilter;
-        heightTexture.magFilter = LinearFilter;
-
-        heightTexture.flipY = false;
-
-        heightTexture.internalFormat = 'R32F';
-
-        shader.uniforms.tHeightTexture.value = heightTexture;
-
-        shader.uniforms.vHeightUv.value.set(
-            -0.25,
-            -0.25,
-            (waterSize / tW),
-            (waterSize / tH)
-        );
-
-        shader.uniforms.vHeightTextureResolution.value.set(terrain.samplerHeight.width, terrain.samplerHeight.height);
-    }
-
-    writeShaderUniforms() {
-
-        /**
-         *
-         * @type {ShaderMaterial}
-         */
-        const shader = this.__shader;
-
-        if (shader === null) {
-            //no shader attached
-            return;
-        }
-
-        const uniforms = shader.uniforms;
-
-        uniforms.waterColor.value.setRGB(this.color.r, this.color.g, this.color.b);
-        uniforms.shoreColor.value.setRGB(this.shoreColor.r, this.shoreColor.g, this.shoreColor.b);
-
-        uniforms.fWaveSpeed.value = this.waveSpeed.getValue();
-
-        uniforms.fWaveAmplitude.value = this.waveAmplitude.getValue();
-
-        uniforms.fWaveFrequency.value = this.waveFrequency.getValue();
-
-        uniforms.fScattering.value = this.scattering.getValue();
-
-        uniforms.vShoreDepthTransition.value.set(this.shoreDepthTransition.min, this.shoreDepthTransition.max);
-
-
-    }
-
-    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 { 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: `WaterSystem3` 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;

package/src/engine/graphics/geometry/AttributeData.d.ts

@@ -0,0 +1,52 @@
+/**
+ * An {@link AttributeSpec} and the elements stored under it.
+ *
+ * The spec says what one item is — how many components, in what type, whether integer values are
+ * read back normalized — and the array holds `count` of them end to end. Nothing here knows about a
+ * renderer: uploading is the business of whoever is drawing, and a consumer that re-reads the array
+ * every frame has nothing to be told.
+ */
+export class AttributeData {
+    /**
+     * Allocate storage for `count` items of `spec`.
+     *
+     * @param {AttributeSpec} spec
+     * @param {number} count
+     * @returns {AttributeData}
+     */
+    static allocate(spec: AttributeSpec, count: number): AttributeData;
+    /**
+     * @param {AttributeSpec} spec
+     * @param {Float32Array|Float64Array|Uint8Array|Uint16Array|Uint32Array|Int8Array|Int16Array|Int32Array} array
+     */
+    constructor(spec: AttributeSpec, array: Float32Array | Float64Array | Uint8Array | Uint16Array | Uint32Array | Int8Array | Int16Array | Int32Array);
+    /**
+     * @type {AttributeSpec}
+     */
+    spec: AttributeSpec;
+    /**
+     * `count * spec.itemSize` elements, item-major.
+     *
+     * @type {Float32Array|Float64Array|Uint8Array|Uint16Array|Uint32Array|Int8Array|Int16Array|Int32Array}
+     */
+    array: Float32Array | Float64Array | Uint8Array | Uint16Array | Uint32Array | Int8Array | Int16Array | Int32Array;
+    /**
+     * @returns {string}
+     */
+    get name(): string;
+    /**
+     * @returns {number}
+     */
+    get itemSize(): number;
+    /**
+     * @returns {boolean}
+     */
+    get normalized(): boolean;
+    /**
+     * How many items the array has room for.
+     *
+     * @returns {number}
+     */
+    get count(): number;
+}
+//# sourceMappingURL=AttributeData.d.ts.map

package/src/engine/graphics/geometry/AttributeData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeData.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/geometry/AttributeData.js"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH;IAuDI;;;;;;OAMG;IACH,4CAHW,MAAM,GACJ,aAAa,CASzB;IAxDD;;;OAGG;IACH,wCAFW,YAAY,GAAC,YAAY,GAAC,UAAU,GAAC,WAAW,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,GAAC,UAAU,EAQtG;IAtBD;;OAEG;IACH,oBAAK;IAEL;;;;OAIG;IACH,OAFU,YAAY,GAAC,YAAY,GAAC,UAAU,GAAC,WAAW,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,GAAC,UAAU,CAEhG;IAcN;;OAEG;IACH,mBAEC;IAED;;OAEG;IACH,uBAEC;IAED;;OAEG;IACH,0BAEC;IAED;;;;OAIG;IACH,oBAEC;CAiBJ"}