@woosh/meep-engine 3.31.0 → 3.33.0

package/package.json

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

package/src/core/collection/table/RowFirstTable.d.ts

@@ -70,7 +70,14 @@ export class RowFirstTable {
      */
     trim(): void;
     /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count: number): void;
@@ -178,6 +185,7 @@ export class RowFirstTable {
      * @returns {boolean}
      */
     equals(other: RowFirstTable): boolean;
+    #private;
 }
 export type RowFirstTableSpec = import("./RowFirstTableSpec.js").RowFirstTableSpec;
 import Signal from "../../events/signal/Signal.js";

package/src/core/collection/table/RowFirstTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;CACJ;gCAhnBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}
+{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAiDA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAaD;;;;;;;;;;OAUG;IACH,kBAFW,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;;CACJ;gCA7oBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}

package/src/core/collection/table/RowFirstTable.js

@@ -28,11 +28,25 @@ const ALLOCATION_GROW_FACTOR = 1.5;
 const ALLOCATION_GROW_MINIMUM_STEP = 32;
 
 /**
- * Must be less than 1 and greater than 0
+ * Must be less than 1 and greater than 0.
+ * A table shrinks once this fraction of its capacity would still exceed what a grow picks for the current row count,
+ * see {@link RowFirstTable#resize}
  * @type {number}
  */
 const ALLOCATION_SHRINK_FACTOR = 0.5;
 
+/**
+ * Capacity a grow picks for `row_count` rows, and the capacity a shrink lands on
+ * @param {number} row_count
+ * @returns {number}
+ */
+function capacity_for_row_count(row_count) {
+    return Math.max(
+        Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
+        row_count + ALLOCATION_GROW_MINIMUM_STEP
+    );
+}
+
 /**
  * Compact binary table storage.
  * Very efficient in terms of memory usage and allocation.
@@ -225,26 +239,41 @@ export class RowFirstTable {
     }
 
     /**
+     * Grow capacity to fit `row_count` rows if it does not already, never shrinks.
+     * What every operation that adds rows uses, so an append cannot undo a {@link setCapacity} reservation.
+     * @param {number} row_count
+     */
+    #grow_to_fit(row_count) {
+        if (this.capacity < row_count) {
+            this.setCapacity(capacity_for_row_count(row_count));
+        }
+    }
+
+    /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count) {
         assert.isNonNegativeInteger(row_count, 'row_count');
 
+        const fitted_capacity = capacity_for_row_count(row_count);
+
         if (this.capacity < row_count) {
 
             //grow
-            const new_size = Math.max(
-                Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
-                row_count + ALLOCATION_GROW_MINIMUM_STEP
-            );
-
-            this.setCapacity(new_size);
+            this.setCapacity(fitted_capacity);
 
-        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > row_count) {
+        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > fitted_capacity) {
 
             //shrink
-            this.setCapacity(row_count);
+            this.setCapacity(fitted_capacity);
 
         }
 
@@ -343,7 +372,7 @@ export class RowFirstTable {
 
         const future_length = this.length + row_count;
 
-        this.resize(future_length);
+        this.#grow_to_fit(future_length);
 
         const data = this.data;
 
@@ -370,7 +399,7 @@ export class RowFirstTable {
     createEmptyRow() {
         const newRowCount = this.length + 1;
 
-        this.resize(newRowCount);
+        this.#grow_to_fit(newRowCount);
 
         const rowIndex = this.length;
 

package/src/engine/graphics/ecs/sprite/Sprite.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @deprecated
+ */
 export class Sprite {
     size: number;
     url: string;

package/src/engine/graphics/ecs/sprite/Sprite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/Sprite.js"],"names":[],"mappings":"AAGA;IACI,aAAS;IACT,YAAS;IACT,iBAAyB;IACzB,aAA2B;CAC9B;;;;oBARmB,kCAAkC;sBAChC,iCAAiC"}
+{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/Sprite.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IACI,aAAS;IACT,YAAS;IACT,iBAAyB;IACzB,aAA2B;CAC9B;;;;oBAXmB,kCAAkC;sBAChC,iCAAiC"}

package/src/engine/graphics/ecs/sprite/Sprite.js

@@ -1,6 +1,9 @@
 import Vector1 from "../../../../core/geom/Vector1.js";
 import { Color } from "../../../../core/color/Color.js";
 
+/**
+ * @deprecated
+ */
 export class Sprite {
     size = 1;
     url = "";

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @deprecated
+ */
 export class SpriteSystemPE extends AbstractContextSystem<any> {
     constructor();
     dependencies: (typeof Transform64 | typeof Sprite)[];

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCAzIqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}
+{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;;GAEG;AACH;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCA5IqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.js

@@ -132,6 +132,9 @@ class Context extends SystemEntityContext {
     }
 }
 
+/**
+ * @deprecated
+ */
 export class SpriteSystemPE extends AbstractContextSystem {
     dependencies = [Sprite, Transform64];
 

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

@@ -1 +1 @@
-{"version":3,"file":"DebugDrawSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/DebugDrawSystem.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAkEI;;OAEG;IACH,sCAYC;IAhFD;;;;;;;;;OASG;IACH,YAFU,MAAM,CAED;IA8Cf;;;;OAIG;IACH,8BAEC;IAmBD,2CAMC;IAED,4CAYC;IAED;;OAEG;IACH,kCAwBC;;CACJ;AAED;;;;;;;;GAQG;AACH;IAYI;;OAEG;IACH,oBAFW,eAAe,EAMzB;IAED,yBAEC;;CACJ;uBApMsB,kBAAkB;iCADR,gDAAgD;gCAJjD,mDAAmD"}
+{"version":3,"file":"DebugDrawSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/DebugDrawSystem.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAkEI;;OAEG;IACH,sCAYC;IAhFD;;;;;;;;;OASG;IACH,YAFU,MAAM,CAED;IA8Cf;;;;OAIG;IACH,8BAEC;IAmBD,2CAMC;IAED,4CAYC;IAED;;OAEG;IACH,kCA4BC;;CACJ;AAED;;;;;;;;GAQG;AACH;IAYI;;OAEG;IACH,oBAFW,eAAe,EAMzB;IAED,yBAEC;;CACJ;uBAxMsB,kBAAkB;iCADR,gDAAgD;gCAJjD,mDAAmD"}

package/src/engine/graphics3/DebugDrawSystem.js

@@ -159,14 +159,18 @@ export class DebugDrawSystem extends System {
         }
 
         const scene = frame.get(SceneColor);
+        const view = frame.get(ViewTextures);
 
-        scene.color = this.#renderer.graph_draw({
+        const drawn = this.#renderer.graph_draw({
             graph: frame.graph,
             batch: this.#batch,
             color: scene.color,
-            depth: frame.get(ViewTextures).depth,
+            depth: view.depth,
             camera: frame.view.camera.buffer
         });
+
+        scene.color = drawn.color;
+        view.depth = drawn.depth;
     }
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"PathDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/PathDisplaySystem.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IA8CI;;OAEG;IACH,sCAMC;IAtDD,mDAAmC;IAoCnC;;;;OAIG;IACH,8BAEC;IAaD,2CAIC;IAED,4CAYC;IAED;;;;OAIG;IACH,cAJW,WAAW,QACX,IAAI,UACJ,MAAM,QAehB;IAED;;;;OAIG;IACH,gBAJW,WAAW,QACX,IAAI,UACJ,MAAM,QAkBhB;IAED,6BAgBC;IAsFD;;OAEG;IACH,kCAeC;;CACJ;AAED;;;GAGG;AACH;IAUI;;OAEG;IACH,oBAFW,iBAAiB,EAM3B;IAED,yBAEC;;CACJ;uBAzSsB,kBAAkB;iBAIxB,sCAAsC;4BAH3B,qCAAqC;iCAFhC,gDAAgD;gCAJjD,mDAAmD"}
+{"version":3,"file":"PathDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/PathDisplaySystem.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IA8CI;;OAEG;IACH,sCAMC;IAtDD,mDAAmC;IAoCnC;;;;OAIG;IACH,8BAEC;IAaD,2CAIC;IAED,4CAYC;IAED;;;;OAIG;IACH,cAJW,WAAW,QACX,IAAI,UACJ,MAAM,QAehB;IAED;;;;OAIG;IACH,gBAJW,WAAW,QACX,IAAI,UACJ,MAAM,QAkBhB;IAED,6BAgBC;IAsFD;;OAEG;IACH,kCAmBC;;CACJ;AAED;;;GAGG;AACH;IAUI;;OAEG;IACH,oBAFW,iBAAiB,EAM3B;IAED,yBAEC;;CACJ;uBA7SsB,kBAAkB;iBAIxB,sCAAsC;4BAH3B,qCAAqC;iCAFhC,gDAAgD;gCAJjD,mDAAmD"}