@woosh/meep-engine 2.94.4 → 2.94.5

package/build/meep.module.js

@@ -1720,7 +1720,7 @@ function dispatchViaProxy(handlers, args) {
 }
 
 /**
- * Clamps a given value to the specified min/max range
+ * Constrain a value to lie between specified min/max values
  * @param {number} value
  * @param {number} min
  * @param {number} max
@@ -68377,6 +68377,12 @@ class System {
 
 }
 
+/**
+ * @readonly
+ * @type {boolean}
+ */
+System.prototype.isSystem = true;
+
 /**
  * Fixed update function, every step happens with the same exact time increment
  * useful for systems that must have a fixed time step to be predictable and stable, such as physics
@@ -74307,7 +74313,10 @@ function returnTrue() {
  * @param {number} z1
  * @returns {number}
  */
-function v3_distance_sqr(x0, y0, z0, x1, y1, z1) {
+function v3_distance_sqr(
+    x0, y0, z0,
+    x1, y1, z1
+) {
     const x = x0 - x1;
     const y = y0 - y1;
     const z = z0 - z1;
@@ -79723,10 +79732,24 @@ class AABB2 {
      * @param {Vector2} result
      */
     getCenter(result) {
-        result.set(
-            (this.x0 + this.x1) / 2,
-            (this.y0 + this.y1) / 2
-        );
+        result.set(this.centerX, this.centerY);
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    get centerX() {
+        return (this.x0 + this.x1) * 0.5;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    get centerY() {
+
+        return (this.y0 + this.y1) * 0.5
     }
 
     /**
@@ -79737,6 +79760,14 @@ class AABB2 {
         return this.x1 - this.x0;
     }
 
+    /**
+     *
+     * @return {number}
+     */
+    get width() {
+        return this.getWidth();
+    }
+
     /**
      *
      * @returns {number}
@@ -79745,6 +79776,14 @@ class AABB2 {
         return this.y1 - this.y0;
     }
 
+    /**
+     *
+     * @return {number}
+     */
+    get height() {
+        return this.getHeight();
+    }
+
     /**
      *
      * @param {Number} x0
@@ -103935,6 +103974,7 @@ class EngineConfiguration {
      * @returns {boolean}
      */
     addSystem(system) {
+
         this.systems.push(system);
 
         return true;
@@ -103944,6 +103984,7 @@ class EngineConfiguration {
      * @param {System} systems
      */
     addManySystems(...systems) {
+
         systems.forEach(s => this.addSystem(s));
     }
 
@@ -115303,9 +115344,6 @@ class EngineHarness {
         terrain.splat.resize(1, 1, 1);
         terrain.splat.fillLayerWeights(0, 255);
 
-        terrain.build(engine.assetManager);
-
-
         const eb = new Entity();
 
         eb.add(new Transform());

package/editor/ecs/component/editors/ecs/Trail2DEditor.js

@@ -1,5 +1,5 @@
+import { Trail2DFlags } from "../../../../../src/engine/graphics/ecs/trail2d/Trail2DFlags.js";
 import { BitFlagsEditor } from "../common/BitFlagsEditor.js";
-import { Trail2DFlags } from "../../../../../src/engine/graphics/ecs/trail2d/Trail2D.js";
 import { ObjectEditor } from "../primitive/ObjectEditor.js";
 
 export class Trail2DEditor extends ObjectEditor {

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.94.4",
+  "version": "2.94.5",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/binary/BitSet.spec.js

@@ -432,7 +432,18 @@ test('copy with only bit 33 set', () => {
     expect(b.size()).toBe(34);
 });
 
-test('performance, next set from 0', () => {
+test('shift right by 1', () => {
+    const s = new BitSet();
+
+    s.set(0, true);
+
+    s.shift_right(1, 0, 1);
+
+    expect(s.get(0)).toBe(true);
+    expect(s.get(1)).toBe(true);
+});
+
+test.skip('performance, next set from 0', () => {
     const s = new BitSet();
 
     s.set(1024, true);
@@ -441,7 +452,8 @@ test('performance, next set from 0', () => {
         const v = s.nextSetBit(0);
     }
 });
-test('performance, next clear from 0', () => {
+
+test.skip('performance, next clear from 0', () => {
     const s = new BitSet();
 
     for (let i = 0; i < 1024; i++) {
@@ -454,13 +466,3 @@ test('performance, next clear from 0', () => {
 });
 
 
-test('shift right by 1', () => {
-    const s = new BitSet();
-
-    s.set(0, true);
-
-    s.shift_right(1, 0, 1);
-
-    expect(s.get(0)).toBe(true);
-    expect(s.get(1)).toBe(true);
-});

package/src/core/geom/2d/aabb/AABB2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AABB2.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/aabb/AABB2.js"],"names":[],"mappings":";AAkBA;;;GAGG;AACH;IACI;;;;;;OAMG;IACH,gEA+BC;IApBG;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IAGhB;;;OAGG;IACH,WAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,aAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,gBAFW,MAAM,EAAE,QA8BlB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAShB;IAED;;;;;OAKG;IACH,sBAJW,KAAK,UACL,KAAK,GACH,OAAO,CAcnB;IAED;;;;OAIG;IACH,qBAHW,KAAK,GACH,OAAO,CAcnB;IAED;;;;;;;OAOG;IACH,0EAMC;IAED;;;;OAIG;IACH,qBAHW,MAAM,KACN,MAAM,QAKhB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,0BALW,OAAO,MACP,OAAO,UACP,OAAO,GACL,OAAO,CA0BnB;IAED;;;;OAIG;IACH,kCAHW,OAAO,UACP,OAAO,QAmBjB;IAED;;;;OAIG;IACH,wBAHW,KAAK,GACH,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,sBANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;OAGG;IACH,eAFa,MAAM,CASlB;IAED;;;OAGG;IACH,sBAFY,MAAM,CAYjB;IAED;;;;;OAKG;IACH,iBAJW,MAAM,KACN,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,mBAFW,KAAK,QAIf;IAED;;;OAGG;IACH,kBAFW,OAAO,QAOjB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,aAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,0DAiBC;IAED;;;;OAIG;IACH,eAHW,MAAM,KACN,MAAM,QAOhB;IAED;;;;OAIG;IACH,aAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,KAAK,CAIjB;IAED;;;;OAIG;IACH,YAHW,KAAK,GACH,KAAK,CAIjB;IAED;;;;OAIG;IACH,cAHW,KAAK,GACH,OAAO,CAOnB;IAED;;;;;;OAMG;IACH,UALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAQhB;IAED;;;;;;OAMG;IACH,uBALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAsBhB;IAED;;OAEG;IACH,oCAEC;IAED,mBAEC;IAED;;;;;MAOC;IAED,0BAEC;CACJ;;;qBAqCS,KAAK;qBAML,KAAK;;oBAhjBK,kBAAkB;AAwgBtC;;;;;;;GAOG;AACH,gDANW,KAAK,MACL,KAAK,MACL,OAAO,MACP,OAAO,GACL,OAAO,CAsBnB"}
+{"version":3,"file":"AABB2.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/aabb/AABB2.js"],"names":[],"mappings":";AAkBA;;;GAGG;AACH;IACI;;;;;;OAMG;IACH,gEA+BC;IApBG;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IACZ;;;OAGG;IACH,WAAY;IAGhB;;;OAGG;IACH,WAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,aAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,gBAFW,MAAM,EAAE,QA8BlB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAShB;IAED;;;;;OAKG;IACH,sBAJW,KAAK,UACL,KAAK,GACH,OAAO,CAcnB;IAED;;;;OAIG;IACH,qBAHW,KAAK,GACH,OAAO,CAcnB;IAED;;;;;;;OAOG;IACH,0EAMC;IAED;;;;OAIG;IACH,qBAHW,MAAM,KACN,MAAM,QAKhB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,0BALW,OAAO,MACP,OAAO,UACP,OAAO,GACL,OAAO,CA0BnB;IAED;;;;OAIG;IACH,kCAHW,OAAO,UACP,OAAO,QAmBjB;IAED;;;;OAIG;IACH,wBAHW,KAAK,GACH,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,sBANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CA4BlB;IAED;;;OAGG;IACH,eAFa,MAAM,CASlB;IAED;;;OAGG;IACH,sBAFY,MAAM,CAYjB;IAED;;;;;OAKG;IACH,iBAJW,MAAM,KACN,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,mBAFW,KAAK,QAIf;IAED;;;OAGG;IACH,kBAFW,OAAO,QAIjB;IAED;;;OAGG;IACH,sBAEC;IAED;;;OAGG;IACH,sBAGC;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,aAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,qBAEC;IAED;;;;;;;OAOG;IACH,0DAiBC;IAED;;;;OAIG;IACH,eAHW,MAAM,KACN,MAAM,QAOhB;IAED;;;;OAIG;IACH,aAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,KAAK,CAIjB;IAED;;;;OAIG;IACH,YAHW,KAAK,GACH,KAAK,CAIjB;IAED;;;;OAIG;IACH,cAHW,KAAK,GACH,OAAO,CAOnB;IAED;;;;;;OAMG;IACH,UALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAQhB;IAED;;;;;;OAMG;IACH,uBALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAsBhB;IAED;;OAEG;IACH,oCAEC;IAED,mBAEC;IAED;;;;;MAOC;IAED,0BAEC;CACJ;;;qBAqCS,KAAK;qBAML,KAAK;;oBA9kBK,kBAAkB;AAsiBtC;;;;;;;GAOG;AACH,gDANW,KAAK,MACL,KAAK,MACL,OAAO,MACP,OAAO,GACL,OAAO,CAsBnB"}

package/src/core/geom/2d/aabb/AABB2.js

@@ -359,10 +359,24 @@ class AABB2 {
      * @param {Vector2} result
      */
     getCenter(result) {
-        result.set(
-            (this.x0 + this.x1) / 2,
-            (this.y0 + this.y1) / 2
-        );
+        result.set(this.centerX, this.centerY);
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    get centerX() {
+        return (this.x0 + this.x1) * 0.5;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    get centerY() {
+
+        return (this.y0 + this.y1) * 0.5
     }
 
     /**
@@ -373,6 +387,14 @@ class AABB2 {
         return this.x1 - this.x0;
     }
 
+    /**
+     *
+     * @return {number}
+     */
+    get width() {
+        return this.getWidth();
+    }
+
     /**
      *
      * @returns {number}
@@ -381,6 +403,14 @@ class AABB2 {
         return this.y1 - this.y0;
     }
 
+    /**
+     *
+     * @return {number}
+     */
+    get height() {
+        return this.getHeight();
+    }
+
     /**
      *
      * @param {Number} x0

package/src/core/geom/3d/util/make_justified_point_grid.d.ts

@@ -4,6 +4,7 @@
  * @param {AABB3} aabb3
  * @param {number} spacing
  * @param {function(x:number,y:number,z:number)} callback
+ * @returns {number} total number of points placed
  */
-export function make_justified_point_grid(aabb3: AABB3, spacing: number, callback: any): void;
+export function make_justified_point_grid(aabb3: AABB3, spacing: number, callback: any): number;
 //# sourceMappingURL=make_justified_point_grid.d.ts.map

package/src/core/geom/3d/util/make_justified_point_grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_justified_point_grid.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/util/make_justified_point_grid.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iEAHW,MAAM,uBAwBhB"}
+{"version":3,"file":"make_justified_point_grid.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/util/make_justified_point_grid.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,iEAJW,MAAM,kBAEJ,MAAM,CAyBlB"}

package/src/core/geom/3d/util/make_justified_point_grid.js

@@ -6,12 +6,13 @@ import { max2 } from "../../../math/max2.js";
  * @param {AABB3} aabb3
  * @param {number} spacing
  * @param {function(x:number,y:number,z:number)} callback
+ * @returns {number} total number of points placed
  */
 export function make_justified_point_grid(aabb3, spacing, callback) {
 
-    const steps_x = Math.ceil(aabb3.getExtentsX() / spacing);
-    const steps_y = Math.ceil(aabb3.getExtentsY() / spacing);
-    const steps_z = Math.ceil(aabb3.getExtentsZ() / spacing);
+    const steps_x = max2(1, Math.ceil(aabb3.getExtentsX() / spacing));
+    const steps_y = max2(1, Math.ceil(aabb3.getExtentsY() / spacing));
+    const steps_z = max2(1, Math.ceil(aabb3.getExtentsZ() / spacing));
 
     const spacing_x = aabb3.getExtentsX() / max2(1, steps_x - 1);
     const spacing_y = aabb3.getExtentsY() / max2(1, steps_y - 1);
@@ -28,4 +29,6 @@ export function make_justified_point_grid(aabb3, spacing, callback) {
             }
         }
     }
+
+    return steps_x * steps_y * steps_z;
 }

package/src/core/geom/vec3/v3_distance_sqr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_distance_sqr.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_distance_sqr.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,oCARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAQlB"}
+{"version":3,"file":"v3_distance_sqr.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_distance_sqr.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,oCARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAWlB"}

package/src/core/geom/vec3/v3_distance_sqr.js

@@ -8,7 +8,10 @@
  * @param {number} z1
  * @returns {number}
  */
-export function v3_distance_sqr(x0, y0, z0, x1, y1, z1) {
+export function v3_distance_sqr(
+    x0, y0, z0,
+    x1, y1, z1
+) {
     const x = x0 - x1;
     const y = y0 - y1;
     const z = z0 - z1;

package/src/core/math/clamp.js

@@ -1,5 +1,5 @@
 /**
- * Clamps a given value to the specified min/max range
+ * Constrain a value to lie between specified min/max values
  * @param {number} value
  * @param {number} min
  * @param {number} max

package/src/core/math/clamp01.d.ts

@@ -6,4 +6,9 @@
  * @returns {number}
  */
 export function clamp01(value: number): number;
+/**
+ * Shortcut following GLSL naming, see {@link clamp01}
+ * @type {function(number): number}
+ */
+export const saturate: (arg0: number) => number;
 //# sourceMappingURL=clamp01.d.ts.map

package/src/core/math/clamp01.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clamp01.d.ts","sourceRoot":"","sources":["../../../../src/core/math/clamp01.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,+BAHW,MAAM,GACJ,MAAM,CAUlB"}
+{"version":3,"file":"clamp01.d.ts","sourceRoot":"","sources":["../../../../src/core/math/clamp01.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,+BAHW,MAAM,GACJ,MAAM,CAUlB;AAED;;;GAGG;AACH,8BAFmB,MAAM,KAAG,MAAM,CAEF"}

package/src/core/math/clamp01.js

@@ -14,3 +14,9 @@ export function clamp01(value) {
         return value;
     }
 }
+
+/**
+ * Shortcut following GLSL naming, see {@link clamp01}
+ * @type {function(number): number}
+ */
+export const saturate = clamp01;

package/src/engine/EngineConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineConfiguration.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineConfiguration.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,kBAAe;IAEf;;;OAGG;IACH,SAFU,IAAI,MAAM,mBAAkB,CAElB;IAEpB;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAHW,MAAM,mCAWhB;IAED;;;;OAIG;IACH,wBAHW,MAAM,oBAWhB;IAED;;;;OAIG;IACH,wCAFa,OAAO,CAQnB;IAED;;;;OAIG;IACH,2BAFa,OAAO,CAMnB;IAED;;OAEG;IACH,yCAEC;IAED;;;;OAIG;IACH,yDAFa,OAAO,CAMnB;IAED;;;OAGG;IACH,qCAmDC;CACJ"}
+{"version":3,"file":"EngineConfiguration.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineConfiguration.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,kBAAe;IAEf;;;OAGG;IACH,SAFU,IAAI,MAAM,mBAAkB,CAElB;IAEpB;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAHW,MAAM,mCAWhB;IAED;;;;OAIG;IACH,wBAHW,MAAM,oBAWhB;IAED;;;;OAIG;IACH,wCAFa,OAAO,CAQnB;IAED;;;;OAIG;IACH,2BAFa,OAAO,CAUnB;IAED;;OAEG;IACH,yCAKC;IAED;;;;OAIG;IACH,yDAFa,OAAO,CAMnB;IAED;;;OAGG;IACH,qCAmDC;CACJ"}

package/src/engine/EngineConfiguration.js

@@ -85,6 +85,10 @@ export class EngineConfiguration {
      * @returns {boolean}
      */
     addSystem(system) {
+        assert.defined(system, 'system');
+        assert.notNull(system, 'system');
+        assert.equal(system.isSystem, true, "system.isSystem !== true");
+
         this.systems.push(system);
 
         return true;
@@ -94,6 +98,9 @@ export class EngineConfiguration {
      * @param {System} systems
      */
     addManySystems(...systems) {
+        assert.defined(systems, "systems");
+        assert.isArray(systems, "systems");
+
         systems.forEach(s => this.addSystem(s));
     }
 

package/src/engine/EngineHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAsDA;IAmBI;;;OAGG;IACH,6BAFW,MAAM,QAYhB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG;QAClB,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oQAnBW,MAAM,iBAmFhB;IAGD;;;;;;OAMG;IACH;QALyB,MAAM,EAApB,MAAM;QACyB,GAAG;QACnB,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;sBAqDjB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG;QAChC,MAAM,CA2ClB;IAGD;;;;;;;;;;;OAWG;IACH,mGAVW,MAAM,GAQJ,OAAO,CA0DnB;IA1bG;;;OAGG;IACH,QAFU,MAAM,CAEiC;IAMjD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAET;IAmBjB;;;;OAIG;IACH,8DAJmB,mBAAmB,UAAQ,MAAM,WAEvC,QAAQ,MAAM,CAAC,CA2D3B;CA4VJ;;IAID;;;OAGG;IACH,uCAMC;;mBAnfkB,aAAa;oCACI,0BAA0B;oBAX1C,yBAAyB;mBAK1B,iBAAiB;oBAEhB,8BAA8B"}
+{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AAsDA;IAmBI;;;OAGG;IACH,6BAFW,MAAM,QAYhB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG;QAClB,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,oQAnBW,MAAM,iBAmFhB;IAGD;;;;;;OAMG;IACH;QALyB,MAAM,EAApB,MAAM;QACyB,GAAG;QACnB,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;sBAqDjB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG;QAChC,MAAM,CA2ClB;IAGD;;;;;;;;;;;OAWG;IACH,mGAVW,MAAM,GAQJ,OAAO,CAuDnB;IAvbG;;;OAGG;IACH,QAFU,MAAM,CAEiC;IAMjD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAET;IAmBjB;;;;OAIG;IACH,8DAJmB,mBAAmB,UAAQ,MAAM,WAEvC,QAAQ,MAAM,CAAC,CA2D3B;CAyVJ;;IAID;;;OAGG;IACH,uCAMC;;mBAhfkB,aAAa;oCACI,0BAA0B;oBAX1C,yBAAyB;mBAK1B,iBAAiB;oBAEhB,8BAA8B"}

package/src/engine/EngineHarness.js

@@ -471,9 +471,6 @@ export class EngineHarness {
         terrain.splat.resize(1, 1, 1);
         terrain.splat.fillLayerWeights(0, 255);
 
-        terrain.build(engine.assetManager);
-
-
         const eb = new Entity();
 
         eb.add(new Transform())

package/src/engine/animation/AnimationUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;GAKG;AACH,yDAJW,MAAM,6CA6DhB;AAGD;;;;;GAKG;AACH,gDAJW,MAAM,6CAmChB;AAED;;;;;;;;GAQG;AACH;;;;;;iBAoFC"}
+{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;GAKG;AACH,yDAJW,MAAM,6CA6DhB;AAGD;;;;;GAKG;AACH,gDAJW,MAAM,6CAmChB;AAED;;;;;;;;GAQG;AACH;;;;;;iBAoFC"}

package/src/engine/animation/AnimationUtils.js

@@ -6,7 +6,8 @@ import { Transform } from "../ecs/transform/Transform.js";
 import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
 import { createSound, createTimer } from "../EntityCreator.js";
 import Mesh from "../graphics/ecs/mesh/Mesh.js";
-import Trail2D, { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2D.js";
+import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
+import { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2DFlags.js";
 import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
 import { ParticleEmitterFlag } from "../graphics/particles/particular/engine/emitter/ParticleEmitterFlag.js";
 import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";

package/src/engine/ecs/System.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"0BA2JU,MAAM;;;;;;;;AAhJhB;;;GAGG;AACH;IAEI;;;OAGG;IACH,uCAAqB;IAErB;;;OAGG;IACH,gBAFU,cAAe,WAAW,CAAC,CAEU;IAE/C;;;OAGG;IACH,oBAAkB;IAElB;;;;;;;;OAQG;IACH,iBAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;OAIG;IACH,oCAFY,MAAM,CA8BjB;IAED,0EAGC;IAED,2EAEC;IAED,wCAEC;IAED,0CAEC;IAIL;;;;OAIG;IACH,yBAA4B;IAG5B;;;OAGG;IACH,oBAAuB;CAdtB;;;;AAqDD;;;;GAIG;AACH,wDAFa,MAAM,CAKlB;0BA3KyB,mCAAmC;qBADxC,6BAA6B"}
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"0BAiKU,MAAM;;;;;;;;AAtJhB;;;GAGG;AACH;IAEI;;;OAGG;IACH,uCAAqB;IAErB;;;OAGG;IACH,gBAFU,cAAe,WAAW,CAAC,CAEU;IAE/C;;;OAGG;IACH,oBAAkB;IAElB;;;;;;;;OAQG;IACH,iBAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;OAIG;IACH,oCAFY,MAAM,CA8BjB;IAED,0EAGC;IAED,2EAEC;IAED,wCAEC;IAED,0CAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,yBAA4B;IAG5B;;;OAGG;IACH,oBAAuB;CApBtB;;;;AA2DD;;;;GAIG;AACH,wDAFa,MAAM,CAKlB;0BAjLyB,mCAAmC;qBADxC,6BAA6B"}

package/src/engine/ecs/System.js

@@ -118,6 +118,12 @@ class System {
 
 }
 
+/**
+ * @readonly
+ * @type {boolean}
+ */
+System.prototype.isSystem = true;
+
 /**
  * Fixed update function, every step happens with the same exact time increment
  * useful for systems that must have a fixed time step to be predictable and stable, such as physics

package/src/engine/ecs/util/hideEntityGracefully.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hideEntityGracefully.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/util/hideEntityGracefully.js"],"names":[],"mappings":"AAiKA;;;;;;GAMG;AACH,8GAFY,MAAM,CAmCjB"}
+{"version":3,"file":"hideEntityGracefully.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/util/hideEntityGracefully.js"],"names":[],"mappings":"AAkKA;;;;;;GAMG;AACH,8GAFY,MAAM,CAmCjB"}

package/src/engine/ecs/util/hideEntityGracefully.js

@@ -1,21 +1,22 @@
+import {
+    TransitionPropertyVectorXBehavior
+} from "../../../../../model/game/story/behaviors/generic/TransitionPropertyVectorXBehavior.js";
+import { TweenVector1Behavior } from "../../../../../model/game/util/behavior/TweenVector1Behavior.js";
+import { TweenVector3Behavior } from "../../../../../model/game/util/behavior/TweenVector3Behavior.js";
 import { max2 } from "../../../core/math/max2.js";
 import { min2 } from "../../../core/math/min2.js";
+import { Light } from "../../graphics/ecs/light/Light.js";
+import Mesh, { MeshFlags } from "../../graphics/ecs/mesh/Mesh.js";
+import Trail2D from "../../graphics/ecs/trail2d/Trail2D.js";
+import { Trail2DFlags } from "../../graphics/ecs/trail2d/Trail2DFlags.js";
 import { ParticleEmitter } from "../../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
 import { ParticleEmitterFlag } from "../../graphics/particles/particular/engine/emitter/ParticleEmitterFlag.js";
-import Trail2D, { Trail2DFlags } from "../../graphics/ecs/trail2d/Trail2D.js";
-import { Transform } from "../transform/Transform.js";
-import Mesh, { MeshFlags } from "../../graphics/ecs/mesh/Mesh.js";
-import { TweenVector3Behavior } from "../../../../../model/game/util/behavior/TweenVector3Behavior.js";
-import { BehaviorComponent } from "../../intelligence/behavior/ecs/BehaviorComponent.js";
 import { SequenceBehavior } from "../../intelligence/behavior/composite/SequenceBehavior.js";
+import { BehaviorComponent } from "../../intelligence/behavior/ecs/BehaviorComponent.js";
 import { DieBehavior } from "../../intelligence/behavior/ecs/DieBehavior.js";
-import { SoundEmitter } from "../../sound/ecs/emitter/SoundEmitter.js";
-import { TweenVector1Behavior } from "../../../../../model/game/util/behavior/TweenVector1Behavior.js";
 import { DelayBehavior } from "../../intelligence/behavior/util/DelayBehavior.js";
-import { Light } from "../../graphics/ecs/light/Light.js";
-import {
-    TransitionPropertyVectorXBehavior
-} from "../../../../../model/game/story/behaviors/generic/TransitionPropertyVectorXBehavior.js";
+import { SoundEmitter } from "../../sound/ecs/emitter/SoundEmitter.js";
+import { Transform } from "../transform/Transform.js";
 
 /**
  * @readonly

package/src/engine/graphics/ecs/trail2d/Trail2D.d.ts

@@ -1,9 +1,3 @@
-export type Trail2DFlags = number;
-export namespace Trail2DFlags {
-    let Spawning: number;
-    let Aging: number;
-    let Built: number;
-}
 export default Trail2D;
 declare class Trail2D {
     static fromJSON(json: any): Trail2D;
@@ -120,6 +114,15 @@ declare class Trail2D {
      * @param {Trail2D} other
      */
     equals(other: Trail2D): boolean;
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     * @param {number} z
+     * @param {number} head_age
+     * @returns {boolean}
+     */
+    updateHead(x: number, y: number, z: number, head_age: number): boolean;
 }
 declare namespace Trail2D {
     export let typeName: string;
@@ -131,5 +134,6 @@ import Vector3 from "../../../../core/geom/Vector3.js";
 import { RibbonX } from "../../trail/x/RibbonX.js";
 import { RibbonXMaterialSpec } from "../../trail/x/RibbonXMaterialSpec.js";
 import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
+import { Trail2DFlags } from "./Trail2DFlags.js";
 import { makeGradientTrail } from "./makeGradientTrail.js";
 //# sourceMappingURL=Trail2D.d.ts.map

package/src/engine/graphics/ecs/trail2d/Trail2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2D.js"],"names":[],"mappings":"2BAeU,MAAM;;;;;;;AAchB;IA8II,oCAMC;IAlJD;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,gBAFU,OAAO,CAEe;IAEhC;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,QAFU,OAAO,GAAC,IAAI,CAER;IAEd;;;OAGG;IACH,UAFU,mBAAmB,CAEQ;IAErC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAIC;IAMD,4BAEC;IAND,yBAEC;IAMD;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;;OAGG;IACH,qBAFW,MAAM,QAehB;IADG,kHAAgB;IAWpB;;;;;;;;;;;aAcC;IAGD;;;;;;MAQC;IAED;;;OAGG;IACH,cAFW,OAAO,WASjB;CAGJ;;;;;;oBArNmB,kCAAkC;oBADlC,kCAAkC;wBAG9B,0BAA0B;oCACd,sCAAsC;0BALhD,yCAAyC;kCAMjC,wBAAwB"}
+{"version":3,"file":"Trail2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2D.js"],"names":[],"mappings":";AAwBA;IAkJI,oCAMC;IAtJD;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,gBAFU,OAAO,CAEe;IAEhC;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,QAFU,OAAO,GAAC,IAAI,CAER;IAEd;;;OAGG;IACH,UAFU,mBAAmB,CAEQ;IAErC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAQC;IAMD,4BAEC;IAND,yBAEC;IAMD;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;;OAGG;IACH,qBAFW,MAAM,QAehB;IADG,kHAAgB;IAWpB;;;;;;;;;;;aAcC;IAGD;;;;;;MAQC;IAED;;;OAGG;IACH,cAFW,OAAO,WASjB;IAED;;;;;;;OAOG;IACH,cANW,MAAM,KACN,MAAM,KACN,MAAM,YACN,MAAM,GACJ,OAAO,CA0CnB;CAEJ;;;;;;oBArQmB,kCAAkC;oBADlC,kCAAkC;wBAK9B,0BAA0B;oCACd,sCAAsC;0BAPhD,yCAAyC;6BAStC,mBAAmB;kCADd,wBAAwB"}

package/src/engine/graphics/ecs/trail2d/Trail2D.js

@@ -6,27 +6,22 @@
 import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
 import Vector3 from "../../../../core/geom/Vector3.js";
 import Vector4 from "../../../../core/geom/Vector4.js";
+import { clamp01 } from "../../../../core/math/clamp01.js";
 import ThreeFactory from "../../three/ThreeFactory.js";
+import { RIBBON_ATTRIBUTE_ADDRESS_AGE } from "../../trail/x/ribbon_attributes_spec.js";
 import { RibbonX } from "../../trail/x/RibbonX.js";
 import { RibbonXMaterialSpec } from "../../trail/x/RibbonXMaterialSpec.js";
 import { makeGradientTrail } from "./makeGradientTrail.js";
+import { Trail2DFlags } from "./Trail2DFlags.js";
 
-/**
- * @readonly
- * @enum {number}
- */
-export const Trail2DFlags = {
-    Spawning: 1,
-    Aging: 2,
-    Built: 4,
-};
-
-const DEFAULT_FLAGS = Trail2DFlags.Spawning | Trail2DFlags.Aging;
+const DEFAULT_FLAGS = Trail2DFlags.Spawning | Trail2DFlags.Aging | Trail2DFlags.BoundsNeedUpdate;
 
 const DEFAULT_MAX_AGE = 5;
 
 const DEFAULT_WIDTH = 1;
 
+const v3_array = new Float32Array(3);
+
 class Trail2D {
 
     /**
@@ -97,9 +92,13 @@ class Trail2D {
     flags = DEFAULT_FLAGS;
 
     dispose() {
-        if (this.ribbon !== null) {
-            this.ribbon.dispose();
+        if (this.ribbon === null) {
+            // nothing to dispose
+            return;
         }
+
+        this.ribbon.dispose();
+        this.ribbon = null;
     }
 
     get textureURL() {
@@ -217,6 +216,55 @@ class Trail2D {
             ;
     }
 
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     * @param {number} z
+     * @param {number} head_age
+     * @returns {boolean}
+     */
+    updateHead(x, y, z, head_age) {
+        const ribbon = this.ribbon;
+
+        const maxAge = this.maxAge;
+
+        const refitTimeDelta = maxAge / ribbon.getCount();
+
+        let head_index = ribbon.getHeadIndex();
+        ribbon.getPointPosition(v3_array, head_index);
+
+        const head_position_changed = x !== v3_array[0]
+            || y !== v3_array[1]
+            || z !== v3_array[2];
+
+        if (this.timeSinceLastUpdate >= refitTimeDelta) {
+
+            if (
+                head_position_changed
+            ) {
+                // make sure that this is a new position before rotating new segment
+                this.timeSinceLastUpdate = 0;
+
+                // rotating segment
+                ribbon.rotate();
+
+                head_index = ribbon.getHeadIndex();
+            }
+        }
+
+        if (head_position_changed) {
+            ribbon.setPointPosition(head_index, x, y, z);
+
+            this.setFlag(Trail2DFlags.BoundsNeedUpdate);
+        }
+
+        // set head to fresh value
+        ribbon.setPointAttribute_Scalar(head_index, RIBBON_ATTRIBUTE_ADDRESS_AGE, head_age);
+        ribbon.setPointAlpha(head_index, clamp01(head_age / maxAge));
+
+        return head_position_changed;
+    }
 
 }
 

package/src/engine/graphics/ecs/trail2d/Trail2DFlags.d.ts

@@ -0,0 +1,8 @@
+export type Trail2DFlags = number;
+export namespace Trail2DFlags {
+    let Spawning: number;
+    let Aging: number;
+    let Built: number;
+    let BoundsNeedUpdate: number;
+}
+//# sourceMappingURL=Trail2DFlags.d.ts.map

package/src/engine/graphics/ecs/trail2d/Trail2DFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trail2DFlags.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2DFlags.js"],"names":[],"mappings":"2BAEU,MAAM"}

package/src/engine/graphics/ecs/trail2d/Trail2DFlags.js

@@ -0,0 +1,10 @@
+/**
+ * @readonly
+ * @enum {number}
+ */
+export const Trail2DFlags = {
+    Spawning: 1,
+    Aging: 2,
+    Built: 4,
+    BoundsNeedUpdate: 8
+};

package/src/engine/graphics/ecs/trail2d/Trail2DSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail2DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2DSystem.js"],"names":[],"mappings":";AA+BA;IAkCI;;;OAGG;IACH,4BA4BC;IAjED,oDAAoC;IAEpC,+DAEE;IAEF;;;OAGG;IACH,WAFU,4BAA4B,CAES;IAE/C;;;;OAIG;IACH,wBAAiC;IAGjC;;;;OAIG;IACH,oBAAgB;IAEhB;;;OAGG;IACH,YAAgB;IAcZ;;;;OAIG;IACH,iBAAsB;IAEtB;;;OAGG;IACH,UAFU,cAAc,CAEO;IAE/B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAK3B,mFAgBC;IAED,2EAMC;IAED;;;;;OAKG;IACH,sBAoDC;IAED;;;;;OAKG;IACH,YAHW,OAAO,aADP,SAAS,YAET,MAAM,QAahB;IAED;;;;;OAKG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAShB;IAED;;;;OAIG;IACH,yBAHW,OAAO,aACP,SAAS,QAsDnB;IAED,6BAWC;CACJ;uBAtRsB,wBAAwB;0BACrB,qCAAqC;oBAYzB,cAAc;4CAdR,uDAAuD;6CAYtD,yDAAyD;+BARvE,yBAAyB"}
+{"version":3,"file":"Trail2DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2DSystem.js"],"names":[],"mappings":";AA8BA;IAkCI;;;OAGG;IACH,4BA4BC;IAjED,oDAAoC;IAEpC,+DAEE;IAEF;;;OAGG;IACH,WAFU,4BAA4B,CAES;IAE/C;;;;OAIG;IACH,wBAAiC;IAGjC;;;;OAIG;IACH,oBAAgB;IAEhB;;;OAGG;IACH,YAAgB;IAcZ;;;;OAIG;IACH,iBAAsB;IAEtB;;;OAGG;IACH,UAFU,cAAc,CAEO;IAE/B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAK3B,mFAgBC;IAED,2EAMC;IAED;;;;;OAKG;IACH,sBAoDC;IAED;;;;;OAKG;IACH,YAHW,OAAO,aADP,SAAS,YAET,MAAM,QAahB;IAED;;;;;OAKG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAShB;IAED;;;;OAIG;IACH,yBAHW,OAAO,aACP,SAAS,QAoCnB;IAED,6BAWC;CACJ;uBAnQsB,wBAAwB;0BACrB,qCAAqC;oBAY3C,cAAc;4CAdU,uDAAuD;6CAYtD,yDAAyD;+BARvE,yBAAyB"}