@woosh/meep-engine 2.169.6 → 2.170.0

package/src/engine/ecs/terrain/ecs/makeTerrainWorkerProxy.js

@@ -60,9 +60,11 @@ export function makeTerrainWorkerProxy() {
                 try {
                     const geometry = Lib.BufferedGeometryArraysBuilder.build(sampler, position, size, scale, totalSize, resolution);
 
-                    // console.time("Optimizing UVs");
+                    // The builder lays UVs down as a planar projection, which stretches texels over
+                    // every slope. Relaxing them against 3D edge length trades that for near-uniform
+                    // texel density across the actual surface. Interior vertices only -- the tile
+                    // outline stays pinned, so neighbouring tiles keep matching UVs along the seam.
                     Lib.tensionOptimizeUV(geometry.vertices, geometry.uvs, geometry.indices, 21);
-                    // console.timeEnd("Optimizing UVs");
 
                     // var timerName = 'building bvh '+(geometry.indices.length/3);
                     // console.time(timerName);

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

@@ -2,16 +2,16 @@
  * Represents how various materials are mixed across the terrain
  */
 export class SplatMapping {
-    /**
-     * How large is the map
-     * @type {Vector2}
-     */
-    size: Vector2;
     /**
      * number of layers
      * @type {number}
      */
     depth: number;
+    /**
+     * How large is the map
+     * @type {Vector2}
+     */
+    size: Vector2;
     /**
      * Weights of materials identified by material texture. Larger weight causes material to appear more prominently
      * @type {DataTexture2DArray}

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":"AAaA;;GAEG;AACH;IAEQ;;;OAGG;IACH,MAFU,OAAO,CAEY;IAE7B;;;OAGG;IACH,OAFU,MAAM,CAEF;IAOd;;;OAGG;IACH,eAFU,kBAAkB,CAEiE;IAUjG;;;;;;;MAQC;IAED;;;;;;;aA6BC;IAED;;;;;OAKG;IACH,8BAJW,SAAS,SACT,MAAM,YACN,MAAM,QAmDhB;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,QAoDpB;IAED,gBAEC;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAuCnB;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAqBhB;IAED,uBAiBC;IAED;;;;;;OAMG;IACH,cALW,MAAM,UACN,MAAM,SACN,MAAM,cACN,OAAO,QA6DjB;CACJ;oBA/hBmB,qCAAqC;mCALoC,OAAO;0BAU1E,mDAAmD"}
+{"version":3,"file":"SplatMapping.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/splat/SplatMapping.js"],"names":[],"mappings":"AAaA;;GAEG;AACH;IACI;;;OAGG;IACH,OAFU,MAAM,CAEN;IAGN;;;OAGG;IACH,MAFU,OAAO,CAEY;IAO7B;;;OAGG;IACH,eAFU,kBAAkB,CAEiE;IASjG;;;;;;;MAQC;IAED;;;;;;;aA6BC;IAED;;;;;OAKG;IACH,8BAJW,SAAS,SACT,MAAM,YACN,MAAM,QAmDhB;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,QAoDpB;IAED,gBAEC;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAuCnB;IAED;;;;OAIG;IACH,8BAHW,MAAM,SACN,MAAM,QAqBhB;IAED,uBAiBC;IAED;;;;;;OAMG;IACH,cALW,MAAM,UACN,MAAM,SACN,MAAM,cACN,OAAO,QA6DjB;CACJ;oBA9hBmB,qCAAqC;mCALoC,OAAO;0BAU1E,mDAAmD"}

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

@@ -15,6 +15,12 @@ import { Sampler2D } from "../../../../graphics/texture/sampler/Sampler2D.js";
  * Represents how various materials are mixed across the terrain
  */
 export class SplatMapping {
+    /**
+     * number of layers
+     * @type {number}
+     */
+    depth = 1;
+
     constructor() {
         /**
          * How large is the map
@@ -22,12 +28,6 @@ export class SplatMapping {
          */
         this.size = new Vector2(1, 1);
 
-        /**
-         * number of layers
-         * @type {number}
-         */
-        this.depth = 1;
-
         const size = this.size;
 
         const width = size.x;
@@ -44,7 +44,6 @@ export class SplatMapping {
         this.weightTexture.magFilter = LinearFilter;
         this.weightTexture.minFilter = NearestFilter;
         this.weightTexture.needsUpdate = true;
-
     }
 
     toJSON() {

package/src/engine/ecs/terrain/overlay/TerrainOverlay.d.ts

@@ -11,6 +11,11 @@ export class TerrainOverlay {
      * @readonly
      */
     readonly borderWidth: Vector1;
+    /**
+     *
+     * @type {Context[]}
+     */
+    stack: Context[];
     /**
      *
      * @type {Vector2}
@@ -28,11 +33,6 @@ export class TerrainOverlay {
      */
     sampler: Sampler2D;
     texture: DataTexture;
-    /**
-     *
-     * @type {Context[]}
-     */
-    stack: Context[];
     /**
      *
      * @param {string} v
@@ -109,10 +109,6 @@ export class TerrainOverlay {
     paintSampler(source: Sampler2D, dx: number, dy: number, dWidth: number, dHeight: number): void;
 }
 import Vector1 from "../../../../core/geom/Vector1.js";
-import Vector2 from "../../../../core/geom/Vector2.js";
-import ObservedString from "../../../../core/model/ObservedString.js";
-import { Sampler2D } from "../../../graphics/texture/sampler/Sampler2D.js";
-import { DataTexture } from "three";
 declare class Context {
     /**
      *
@@ -138,6 +134,10 @@ declare class Context {
      */
     tileImage: string;
 }
+import Vector2 from "../../../../core/geom/Vector2.js";
+import ObservedString from "../../../../core/model/ObservedString.js";
+import { Sampler2D } from "../../../graphics/texture/sampler/Sampler2D.js";
+import { DataTexture } from "three";
 import Vector4 from '../../../../core/geom/Vector4.js';
 export {};
 //# sourceMappingURL=TerrainOverlay.d.ts.map

package/src/engine/ecs/terrain/overlay/TerrainOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainOverlay.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/overlay/TerrainOverlay.js"],"names":[],"mappings":"AA+CA;IACI;;;;OAIG;IACH,kBAHW,OAAO,EAkEjB;IA9DG;;;;OAIG;IACH,sBAHU,OAAO,CAGkB;IACnC;;;;OAIG;IACH,eAHU,OAAO,CAGsB;IAEvC;;;OAGG;IACH,WAFU,cAAc,CAEiC;IAEzD;;;OAGG;IACH,SAFU,SAAS,CAE8B;IAEjC,qBAIf;IAiBD;;;OAGG;IACH,OAFU,OAAO,EAAE,CAEJ;IAsBnB;;;OAGG;IACH,+BAIC;IAhBD;;;OAGG;IACH,4BAEC;IAYD;;OAEG;IACH,gCAEC;IAED;;OAEG;IACH,aAaC;IAED;;OAEG;IACH,YAuBC;IAED,cAMC;IAED,eAEC;IAED;;;;;OAKG;IACH,aAJW,MAAM,KACN,MAAM,UACN,OAAO,QAQjB;IAED;;;;;OAKG;IACH,wBAJW,MAAM,KACN,MAAM,QACN,OAAO,QAmBjB;IAED;;;;OAIG;IACH,cAHW,MAAM,KACN,MAAM,QAIhB;IAED;;;;;OAKG;IACH,cAJW,MAAM,KACN,MAAM,QACN,OAAO,QAUjB;IAED;;;OAGG;IACH,gBAFW,UAAU,GAAC,MAAM,EAAE,QAuB7B;IAED;;;;;;;OAOG;IACH,kBANW,iBAAiB,MACjB,MAAM,MACN,MAAM,WACN,MAAM,YACN,MAAM,QAMhB;IAED;;;;;;;OAOG;IACH,qBANW,SAAS,MACT,MAAM,MACN,MAAM,UACN,MAAM,WACN,MAAM,QAWhB;CACJ;oBA9TmB,kCAAkC;oBAClC,kCAAkC;2BAE3B,0CAA0C;0BAG3C,gDAAgD;4BAZV,OAAO;AAgBvE;IACI;;;;;;OAMG;IACH,qBALW,SAAS,eACT,MAAM,aACN,MAAM,EAqBhB;IAjBG;;;OAGG;IACH,SAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEc;IAE9B;;;OAGG;IACH,WAFU,MAAM,CAEU;CAEjC;oBAnCmB,kCAAkC"}
+{"version":3,"file":"TerrainOverlay.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/overlay/TerrainOverlay.js"],"names":[],"mappings":"AA+CA;IAcI;;;;OAIG;IACH,kBAHW,OAAO,EAsDjB;IArED;;;;OAIG;IACH,sBAHU,OAAO,CAGc;IAE/B;;;OAGG;IACH,OAFU,OAAO,EAAE,CAER;IAQP;;;;OAIG;IACH,eAHU,OAAO,CAGsB;IAEvC;;;OAGG;IACH,WAFU,cAAc,CAEiC;IAEzD;;;OAGG;IACH,SAFU,SAAS,CAE8B;IAEjC,qBAIf;IAqCL;;;OAGG;IACH,+BAIC;IAhBD;;;OAGG;IACH,4BAEC;IAYD;;OAEG;IACH,gCAEC;IAED;;OAEG;IACH,aAaC;IAED;;OAEG;IACH,YAuBC;IAED,cAMC;IAED,eAEC;IAED;;;;;OAKG;IACH,aAJW,MAAM,KACN,MAAM,UACN,OAAO,QAQjB;IAED;;;;;OAKG;IACH,wBAJW,MAAM,KACN,MAAM,QACN,OAAO,QAmBjB;IAED;;;;OAIG;IACH,cAHW,MAAM,KACN,MAAM,QAIhB;IAED;;;;;OAKG;IACH,cAJW,MAAM,KACN,MAAM,QACN,OAAO,QAUjB;IAED;;;OAGG;IACH,gBAFW,UAAU,GAAC,MAAM,EAAE,QAuB7B;IAED;;;;;;;OAOG;IACH,kBANW,iBAAiB,MACjB,MAAM,MACN,MAAM,WACN,MAAM,YACN,MAAM,QAMhB;IAED;;;;;;;OAOG;IACH,qBANW,SAAS,MACT,MAAM,MACN,MAAM,UACN,MAAM,WACN,MAAM,QAWhB;CACJ;oBA/TmB,kCAAkC;AAUtD;IACI;;;;;;OAMG;IACH,qBALW,SAAS,eACT,MAAM,aACN,MAAM,EAqBhB;IAjBG;;;OAGG;IACH,SAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEc;IAE9B;;;OAGG;IACH,WAFU,MAAM,CAEU;CAEjC;oBApCmB,kCAAkC;2BAE3B,0CAA0C;0BAG3C,gDAAgD;4BAZV,OAAO;oBAQnD,kCAAkC"}

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

@@ -46,18 +46,25 @@ class Context {
 const COLOR_UINT_8_TRANSPARENT = [0, 0, 0, 0];
 
 export class TerrainOverlay {
+    /**
+     * width is in fraction between 0 and 1, for example: 0.1 represents 10% border between tiles
+     * @type {Vector1}
+     * @readonly
+     */
+    borderWidth = new Vector1(0.1);
+
+    /**
+     *
+     * @type {Context[]}
+     */
+    stack = [];
+
     /**
      *
      * @param {Vector2} size
      * @constructor
      */
     constructor(size) {
-        /**
-         * width is in fraction between 0 and 1, for example: 0.1 represents 10% border between tiles
-         * @type {Vector1}
-         * @readonly
-         */
-        this.borderWidth = new Vector1(0.1);
         /**
          *
          * @type {Vector2}
@@ -98,12 +105,6 @@ export class TerrainOverlay {
         texture.needsUpdate = true;
         texture.generateMipmaps = false;
 
-        /**
-         *
-         * @type {Context[]}
-         */
-        this.stack = [];
-
         this.size.onChanged.add((x, y) => {
             this.sampler.resize(x, y);
 

package/src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_0_1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSerializationUpgrader_0_1.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_0_1.js"],"names":[],"mappings":"AAEA;IAQI,wCAgFC;CACJ;oCA3FmC,6CAA6C"}
+{"version":3,"file":"TerrainSerializationUpgrader_0_1.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_0_1.js"],"names":[],"mappings":"AAEA;IAII,wCAgFC;CACJ;oCAvFmC,6CAA6C"}

package/src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_0_1.js

@@ -1,12 +1,8 @@
 import { BinaryClassUpgrader } from "../../storage/binary/BinaryClassUpgrader.js";
 
 export class TerrainSerializationUpgrader_0_1 extends BinaryClassUpgrader {
-    constructor() {
-        super();
-
-        this.__targetVersion = 1;
-        this.__startVersion = 0;
-    }
+    __targetVersion = 1;
+    __startVersion = 0;
 
     upgrade(source, target) {
 

package/src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_1_2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSerializationUpgrader_1_2.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_1_2.js"],"names":[],"mappings":"AAGA;IASI,wCAmEC;CACJ;oCAhFmC,6CAA6C"}
+{"version":3,"file":"TerrainSerializationUpgrader_1_2.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_1_2.js"],"names":[],"mappings":"AAGA;IAKI,wCAmEC;CACJ;oCA5EmC,6CAA6C"}

package/src/engine/ecs/terrain/serialization/TerrainSerializationUpgrader_1_2.js

@@ -3,12 +3,8 @@ import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
 
 export class TerrainSerializationUpgrader_1_2 extends BinaryClassUpgrader {
 
-    constructor() {
-        super();
-
-        this.__targetVersion = 2;
-        this.__startVersion = 1;
-    }
+    __targetVersion = 2;
+    __startVersion = 1;
 
     upgrade(source, target) {
         const size_x = source.readUint32();

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

@@ -2,14 +2,13 @@ export default TerrainTileManager;
 declare class TerrainTileManager {
     /**
      *
-     * @param {Vector2} [tileSize]
      * @param {Material} [material]
      * @param {Material} [depthMaterial] applied to each tile mesh as
      *   `customDepthMaterial` so the shadow caster pass picks it up.
      *   Omit (null) to let three.js fall back to its default depth material.
      * @param {WorkerProxy} buildWorker
      */
-    constructor({ material, depthMaterial, buildWorker }?: Vector2);
+    constructor({ material, depthMaterial, buildWorker }?: Material);
     /**
      *
      * @type {TerrainTile[]}
@@ -20,10 +19,31 @@ declare class TerrainTileManager {
         tileDestroyed: Signal;
     };
     /**
+     * Largest tile edge, in grid cells. Tiles are the unit of frustum culling, seam stitching and
+     * rebuild-on-paint, so a coarse value is preferable -- but only up to the point where a single
+     * tile's geometry stops fitting {@link TerrainTileManager#maxTileVertexCount}, past which tiles
+     * are subdivided further. See {@link TerrainTileManager#tileEdgeX}.
+     *
+     * The last row and column of the grid are whatever is left over, so this is an upper bound and
+     * not a divisor of {@link TerrainTileManager#totalSize}.
      *
      * @type {Vector2}
      */
-    tileSize: Vector2;
+    maxTileSize: Vector2;
+    /**
+     * Upper bound on the number of vertices in a single tile.
+     *
+     * A tile is built in one shot -- the whole grid is allocated, sampled, normal-fitted and fed to
+     * a BVH build with no chunking anywhere -- so an unbounded tile is an unbounded allocation. At
+     * a resolution of 64 a 32x32 terrain would otherwise land in a single 4.19M-vertex tile, which
+     * costs upwards of 800MB to build and kills the renderer process outright.
+     *
+     * 65536 is the largest count that keeps the index array 16-bit
+     * (see {@link UintArrayForCount}), which caps a built tile at roughly 9MB of geometry and BVH.
+     *
+     * @type {number}
+     */
+    maxTileVertexCount: number;
     /**
      *
      * @type {Vector2}
@@ -124,6 +144,27 @@ declare class TerrainTileManager {
      * @returns {number}
      */
     computeTileIndex(x: number, y: number): number;
+    /**
+     * Tile edge along X, in grid cells. Derived rather than stored so that it always reflects the
+     * current {@link TerrainTileManager#resolution}; a terrain rebuilt at a coarser resolution goes
+     * back to coarser tiles.
+     *
+     * PRECONDITION, shared by {@link TerrainTileManager#gridWidth},
+     * {@link TerrainTileManager#gridHeight} and {@link TerrainTileManager#getRawTileByPosition}:
+     * these describe the grid the *current configuration* asks for, which is the grid held in
+     * {@link TerrainTileManager#tiles} only for as long as that configuration is unchanged. Writing
+     * `totalSize`, `maxTileSize`, `resolution` or `maxTileVertexCount` after tiles exist leaves the
+     * two disagreeing, and a tile lookup then reads the wrong index. Follow any such write with
+     * {@link TerrainTileManager#rebuild}.
+     *
+     * @returns {number}
+     */
+    get tileEdgeX(): number;
+    /**
+     * Tile edge along Y, in grid cells.
+     * @returns {number}
+     */
+    get tileEdgeY(): number;
     /**
      * Number of tiles along X. A terrain whose size is not a whole multiple of
      * the tile size ends in a partial tile, and that tile is real, so this

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":";AA6BA;IA6DI;;;;;;;;OAQG;IACH,uDAPW,OAAO,EA2CjB;IAzGD;;;OAGG;IACH,OAFU,WAAW,EAAE,CAEZ;IAEX;;;MAGE;IAEF;;;OAGG;IACH,UAFU,OAAO,CAEc;IAE/B;;;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;;;OAGG;IACH,yBAFU,OAAO,CAEe;IAyB5B,wBAA2C;IAE3C;;;;;;OAMG;IACH,eAFU,WAAS,IAAI,CAEW;IAGlC;;;OAGG;IACH,yBAA8B;IAQlC,iCAWC;IAED,8BAEC;IAED;;;;OAIG;IACH,2BAHW,MAAM,cACN,MAAM,QAiChB;IAED,mBAIC;IAED;;;OAGG;IACH,yBAFW,WAAW,QAuBrB;IAED;;;;OAIG;IACH,0BAHkB,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,wBAgDC;IAED;;;;;OAKG;IACH,oBAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAYlB;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,gBASC;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,kBACC,WAAW,KAAK,IAAI,2BACZ,IAAI,QAqF7B;CACJ;wBA3yBuB,kBAAkB;mBAVvB,0CAA0C;oBAGzC,kCAAkC;4BAG1B,2CAA2C;oBAVnD,mCAAmC;gCAQvB,mDAAmD;0BAGzD,yCAAyC;8BALrC,2CAA2C"}
+{"version":3,"file":"TerrainTileManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/tiles/TerrainTileManager.js"],"names":[],"mappings":";AAiDA;IAmFI;;;;;;;OAOG;IACH,iEAoCC;IA9HD;;;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;;;OAGG;IACH,yBAFU,OAAO,CAEe;IAwB5B,wBAA2C;IAE3C;;;;;;OAMG;IACH,eAFU,WAAS,IAAI,CAEW;IAGlC;;;OAGG;IACH,yBAA8B;IAQlC,iCAWC;IAED,8BAEC;IAED;;;;OAIG;IACH,2BAHW,MAAM,cACN,MAAM,QAiChB;IAED,mBAIC;IAED;;;OAGG;IACH,yBAFW,WAAW,QAuBrB;IAED;;;;OAIG;IACH,0BAHkB,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,wBA4CC;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,gBASC;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,kBACC,WAAW,KAAK,IAAI,2BACZ,IAAI,QAqF7B;CACJ;wBAz2BuB,kBAAkB;mBAZvB,0CAA0C;oBAGzC,kCAAkC;4BAK1B,2CAA2C;oBAZnD,mCAAmC;gCAQvB,mDAAmD;0BAKzD,yCAAyC;8BAPrC,2CAA2C"}

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

@@ -13,6 +13,8 @@ import { aabb2_intersects_aabb2 } from "../../../../core/geom/2d/aabb/aabb2_inte
 import { SurfacePoint3 } from "../../../../core/geom/3d/SurfacePoint3.js";
 import Vector2 from '../../../../core/geom/Vector2.js';
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
+import { max2 } from "../../../../core/math/max2.js";
+import { min2 } from "../../../../core/math/min2.js";
 import { randomFloatBetween } from "../../../../core/math/random/randomFloatBetween.js";
 import ObservedInteger from "../../../../core/model/ObservedInteger.js";
 import ObservedValue from '../../../../core/model/ObservedValue.js';
@@ -27,6 +29,24 @@ import TerrainTile from './TerrainTile.js';
 const scratch_array = [];
 const scratch_contact = new SurfacePoint3();
 
+/**
+ * Largest whole number of grid cells that fits inside a per-tile vertex budget along one tile edge,
+ * never more than the requested edge and never less than a single cell.
+ *
+ * A single grid cell is the smallest tile there is, so a resolution fine enough that one cell alone
+ * blows the budget cannot be honoured and the budget is exceeded.
+ *
+ * @param {number} max_edge largest acceptable edge, in grid cells
+ * @param {number} resolution vertices per grid cell along one axis
+ * @param {number} max_vertex_count budget for the whole tile
+ * @returns {number} edge length in grid cells
+ */
+function tile_edge(max_edge, resolution, max_vertex_count) {
+    const budget_edge = Math.floor(Math.sqrt(max_vertex_count) / resolution);
+
+    return max2(1, min2(max_edge, budget_edge));
+}
+
 class TerrainTileManager {
     /**
      *
@@ -40,10 +60,32 @@ class TerrainTileManager {
     };
 
     /**
+     * Largest tile edge, in grid cells. Tiles are the unit of frustum culling, seam stitching and
+     * rebuild-on-paint, so a coarse value is preferable -- but only up to the point where a single
+     * tile's geometry stops fitting {@link TerrainTileManager#maxTileVertexCount}, past which tiles
+     * are subdivided further. See {@link TerrainTileManager#tileEdgeX}.
+     *
+     * The last row and column of the grid are whatever is left over, so this is an upper bound and
+     * not a divisor of {@link TerrainTileManager#totalSize}.
      *
      * @type {Vector2}
      */
-    tileSize = new Vector2(10, 10);
+    maxTileSize = new Vector2(10, 10);
+
+    /**
+     * Upper bound on the number of vertices in a single tile.
+     *
+     * A tile is built in one shot -- the whole grid is allocated, sampled, normal-fitted and fed to
+     * a BVH build with no chunking anywhere -- so an unbounded tile is an unbounded allocation. At
+     * a resolution of 64 a 32x32 terrain would otherwise land in a single 4.19M-vertex tile, which
+     * costs upwards of 800MB to build and kills the renderer process outright.
+     *
+     * 65536 is the largest count that keeps the index array 16-bit
+     * (see {@link UintArrayForCount}), which caps a built tile at roughly 9MB of geometry and BVH.
+     *
+     * @type {number}
+     */
+    maxTileVertexCount = 65536;
 
     /**
      *
@@ -90,7 +132,6 @@ class TerrainTileManager {
 
     /**
      *
-     * @param {Vector2} [tileSize]
      * @param {Material} [material]
      * @param {Material} [depthMaterial] applied to each tile mesh as
      *   `customDepthMaterial` so the shadow caster pass picks it up.
@@ -345,12 +386,8 @@ class TerrainTileManager {
     initializeTiles() {
         const total_size = this.totalSize;
 
-        const gridSize = total_size.clone();
-
-        const time_size = this.tileSize;
-
-        gridSize.divide(time_size);
-        gridSize.ceil();
+        const tile_size_x = this.tileEdgeX;
+        const tile_size_y = this.tileEdgeY;
 
         const tiles = this.tiles;
 
@@ -359,16 +396,16 @@ class TerrainTileManager {
         }
 
         //populate tiles
-        const tile_resolution_y = gridSize.y;
-        const tile_resolution_x = gridSize.x;
+        const tile_resolution_y = this.gridHeight;
+        const tile_resolution_x = this.gridWidth;
 
         for (let y = 0; y < tile_resolution_y; y++) {
 
-            const tY = y < tile_resolution_y - 1 ? time_size.y : (total_size.y - time_size.y * y);
+            const tY = y < tile_resolution_y - 1 ? tile_size_y : (total_size.y - tile_size_y * y);
 
             for (let x = 0; x < tile_resolution_x; x++) {
 
-                const tX = x < tile_resolution_x - 1 ? time_size.x : (total_size.x - time_size.x * x);
+                const tX = x < tile_resolution_x - 1 ? tile_size_x : (total_size.x - tile_size_x * x);
 
                 const tile = new TerrainTile();
                 const index = y * tile_resolution_x + x;
@@ -379,7 +416,7 @@ class TerrainTileManager {
                 tile.gridPosition.set(x, y);
 
                 tile.size.set(tX, tY);
-                tile.position.set(time_size.x * x, time_size.y * y);
+                tile.position.set(tile_size_x * x, tile_size_y * y);
                 tile.scale.copy(this.scale);
                 tile.resolution.copy(this.resolution);
 
@@ -410,6 +447,33 @@ class TerrainTileManager {
         return y * w + x;
     }
 
+    /**
+     * Tile edge along X, in grid cells. Derived rather than stored so that it always reflects the
+     * current {@link TerrainTileManager#resolution}; a terrain rebuilt at a coarser resolution goes
+     * back to coarser tiles.
+     *
+     * PRECONDITION, shared by {@link TerrainTileManager#gridWidth},
+     * {@link TerrainTileManager#gridHeight} and {@link TerrainTileManager#getRawTileByPosition}:
+     * these describe the grid the *current configuration* asks for, which is the grid held in
+     * {@link TerrainTileManager#tiles} only for as long as that configuration is unchanged. Writing
+     * `totalSize`, `maxTileSize`, `resolution` or `maxTileVertexCount` after tiles exist leaves the
+     * two disagreeing, and a tile lookup then reads the wrong index. Follow any such write with
+     * {@link TerrainTileManager#rebuild}.
+     *
+     * @returns {number}
+     */
+    get tileEdgeX() {
+        return tile_edge(this.maxTileSize.x, this.resolution.getValue(), this.maxTileVertexCount);
+    }
+
+    /**
+     * Tile edge along Y, in grid cells.
+     * @returns {number}
+     */
+    get tileEdgeY() {
+        return tile_edge(this.maxTileSize.y, this.resolution.getValue(), this.maxTileVertexCount);
+    }
+
     /**
      * Number of tiles along X. A terrain whose size is not a whole multiple of
      * the tile size ends in a partial tile, and that tile is real, so this
@@ -418,7 +482,7 @@ class TerrainTileManager {
      * @returns {number}
      */
     get gridWidth() {
-        return Math.ceil(this.totalSize.x / this.tileSize.x);
+        return Math.ceil(this.totalSize.x / this.tileEdgeX);
     }
 
     /**
@@ -426,7 +490,7 @@ class TerrainTileManager {
      * @returns {number}
      */
     get gridHeight() {
-        return Math.ceil(this.totalSize.y / this.tileSize.y);
+        return Math.ceil(this.totalSize.y / this.tileEdgeY);
     }
 
     /**
@@ -465,8 +529,8 @@ class TerrainTileManager {
         assert.isNumber(y, 'y');
         assert.notNaN(y, 'y');
 
-        const tileX = Math.floor(x / this.tileSize.x);
-        const tileY = Math.floor(y / this.tileSize.y);
+        const tileX = Math.floor(x / this.tileEdgeX);
+        const tileY = Math.floor(y / this.tileEdgeY);
 
         return this.getRaw(tileX, tileY);
     }

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

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

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

@@ -16,7 +16,9 @@ export function obtainTerrain(ecd, callback=noop) {
 
     const terrain = object.component;
 
+    if (terrain !== null) {
         callback(terrain, object.entity);
+    }
 
     return terrain;
 }

package/src/engine/ecs/tooltip/TooltipComponentSystem.d.ts

@@ -9,26 +9,6 @@ export class TooltipComponentSystem extends System<any> {
     constructor({ graphics, tooltips, pointer, localization }: GraphicsEngine);
     dependencies: (typeof TooltipComponent)[];
     components_used: ResourceAccessSpecification<typeof Mesh>[];
-    /**
-     *
-     * @type {GraphicsEngine}
-     */
-    graphics: GraphicsEngine;
-    /**
-     *
-     * @type {TooltipManager}
-     */
-    tooltips: TooltipManager;
-    /**
-     *
-     * @type {PointerDevice}
-     */
-    pointer: PointerDevice;
-    /**
-     *
-     * @type {Localization}
-     */
-    localization: Localization;
     /**
      *
      * @type {number}
@@ -55,6 +35,26 @@ export class TooltipComponentSystem extends System<any> {
      * @private
      */
     private __current_tip_entity;
+    /**
+     *
+     * @type {GraphicsEngine}
+     */
+    graphics: GraphicsEngine;
+    /**
+     *
+     * @type {TooltipManager}
+     */
+    tooltips: TooltipManager;
+    /**
+     *
+     * @type {PointerDevice}
+     */
+    pointer: PointerDevice;
+    /**
+     *
+     * @type {Localization}
+     */
+    localization: Localization;
     __clearTip(): void;
     __updateActiveBounds(): void;
     __updateTipTargetBounds(): void;

package/src/engine/ecs/tooltip/TooltipComponentSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TooltipComponentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/tooltip/TooltipComponentSystem.js"],"names":[],"mappings":"AAiBA;IACI;;;;;;OAMG;IACH,2EAgEC;IA7DG,0CAAsC;IAEtC,4DAEC;IAED;;;OAGG;IACH,yBAAwB;IAExB;;;OAGG;IACH,yBAAwB;IAExB;;;OAGG;IACH,uBAAsB;IAEtB;;;OAGG;IACH,2BAAgC;IAEhC;;;OAGG;IACH,4BAFU,MAAM,CAEmB;IAEnC;;;OAGG;IACH,eAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,QAFU,SAAS,CAEU;IAE7B;;;OAGG;IACH,KAFU,SAAS,CAEJ;IAGf;;;;OAIG;IACH,6BAA8B;IAIlC,mBAQC;IAED,6BAYC;IAED,gCAKC;IAED;;;;OAIG;IACH,2BAEC;IAED,iCAsCC;IAED,2CAIC;IAED,4CAIC;IAED,6BAqDC;CACJ;uBArOsB,cAAc;iCACJ,uBAAuB;iBAJvC,iCAAiC;4CAFN,oDAAoD;sBAJ1E,oCAAoC;0BAKhC,oCAAoC"}
+{"version":3,"file":"TooltipComponentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/tooltip/TooltipComponentSystem.js"],"names":[],"mappings":"AAiBA;IAqCI;;;;;;OAMG;IACH,2EA0BC;IArED,0CAAkC;IAClC,4DAEE;IAEF;;;OAGG;IACH,4BAFU,MAAM,CAEe;IAE/B;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,QAFU,SAAS,CAEM;IAEzB;;;OAGG;IACH,KAFU,SAAS,CAER;IAEX;;;;OAIG;IACH,6BAA0B;IAYtB;;;OAGG;IACH,yBAAwB;IAExB;;;OAGG;IACH,yBAAwB;IAExB;;;OAGG;IACH,uBAAsB;IAEtB;;;OAGG;IACH,2BAAgC;IAIpC,mBAQC;IAED,6BAYC;IAED,gCAKC;IAED;;;;OAIG;IACH,2BAEC;IAED,iCAsCC;IAED,2CAIC;IAED,4CAIC;IAED,6BAqDC;CACJ;uBAnOsB,cAAc;iCACJ,uBAAuB;iBAJvC,iCAAiC;4CAFN,oDAAoD;sBAJ1E,oCAAoC;0BAKhC,oCAAoC"}

package/src/engine/ecs/tooltip/TooltipComponentSystem.js

@@ -16,6 +16,42 @@ const ray_direction = new Vector3();
 const hit = new SurfacePoint3();
 
 export class TooltipComponentSystem extends System {
+    dependencies = [TooltipComponent];
+    components_used = [
+        ResourceAccessSpecification.from(Mesh, ResourceAccessKind.Read)
+    ];
+
+    /**
+     *
+     * @type {number}
+     */
+    time_since_position_update = 0;
+
+    /**
+     * Delay before tooltip appears, in seconds
+     * @type {number}
+     */
+    display_delay = 0.2;
+
+    /**
+     * Screen-space rectangle, used by the tooltip system as the anchor to point to
+     * @type {Rectangle}
+     */
+    target = new Rectangle();
+
+    /**
+     *
+     * @type {VisualTip}
+     */
+    tip = null;
+
+    /**
+     *
+     * @type {number}
+     * @private
+     */
+    __current_tip_entity = -1;
+
     /**
      *
      * @param {GraphicsEngine} graphics
@@ -26,12 +62,6 @@ export class TooltipComponentSystem extends System {
     constructor({ graphics, tooltips, pointer, localization }) {
         super();
 
-        this.dependencies = [TooltipComponent];
-
-        this.components_used = [
-            ResourceAccessSpecification.from(Mesh, ResourceAccessKind.Read)
-        ];
-
         /**
          *
          * @type {GraphicsEngine}
@@ -55,38 +85,6 @@ export class TooltipComponentSystem extends System {
          * @type {Localization}
          */
         this.localization = localization;
-
-        /**
-         *
-         * @type {number}
-         */
-        this.time_since_position_update = 0;
-
-        /**
-         * Delay before tooltip appears, in seconds
-         * @type {number}
-         */
-        this.display_delay = 0.2;
-
-        /**
-         * Screen-space rectangle, used by the tooltip system as the anchor to point to
-         * @type {Rectangle}
-         */
-        this.target = new Rectangle();
-
-        /**
-         *
-         * @type {VisualTip}
-         */
-        this.tip = null;
-
-
-        /**
-         *
-         * @type {number}
-         * @private
-         */
-        this.__current_tip_entity = -1;
     }
 
 

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

@@ -1 +1 @@
-{"version":3,"file":"TransformSerializationUpgrader_0_1.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/TransformSerializationUpgrader_0_1.js"],"names":[],"mappings":"AAEA;IAQI,wCAyDC;CACJ;oCApEmC,0CAA0C"}
+{"version":3,"file":"TransformSerializationUpgrader_0_1.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/TransformSerializationUpgrader_0_1.js"],"names":[],"mappings":"AAEA;IAII,wCAyDC;CACJ;oCAhEmC,0CAA0C"}