@woosh/meep-engine 2.94.2 → 2.94.5

package/src/core/geom/Quaternion.js

@@ -6,10 +6,10 @@
 import { assert } from "../assert.js";
 import Signal from "../events/signal/Signal.js";
 import { clamp } from "../math/clamp.js";
+import { clamp01 } from "../math/clamp01.js";
 import { EPSILON } from "../math/EPSILON.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
 import { lerp } from "../math/lerp.js";
-import { min2 } from "../math/min2.js";
 import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import { quat_decode_from_uint32 } from "./3d/quaternion/quat_decode_from_uint32.js";
 import { quat_encode_to_uint32 } from "./3d/quaternion/quat_encode_to_uint32.js";
@@ -1152,24 +1152,24 @@ class Quaternion {
         this.set(x, y, z, w);
     }
 
-
     /**
-     * @see https://github.com/toji/gl-matrix/blob/master/src/gl-matrix/quat.js
-     * @param {Quaternion} other
+     *
+     * @param {Quaternion} from
+     * @param {Quaternion} to
      * @param {number} t
      */
-    slerp(other, t) {
+    slerpQuaternions(from, to, t) {
         assert.isNumber(t, 't');
 
-        const ax = this.x,
-            ay = this.y,
-            az = this.z,
-            aw = this.w;
+        const ax = from.x,
+            ay = from.y,
+            az = from.z,
+            aw = from.w;
 
-        let bx = other.x,
-            by = other.y,
-            bz = other.z,
-            bw = other.w;
+        let bx = to.x,
+            by = to.y,
+            bz = to.z,
+            bw = to.w;
 
         let omega, cosom, sinom, scale0, scale1;
 
@@ -1207,6 +1207,16 @@ class Quaternion {
         this.set(_x, _y, _z, _w);
     }
 
+
+    /**
+     * @see https://github.com/toji/gl-matrix/blob/master/src/gl-matrix/quat.js
+     * @param {Quaternion} other
+     * @param {number} t
+     */
+    slerp(other, t) {
+        this.slerpQuaternions(this, other, t);
+    }
+
     /**
      * @see https://github.com/gareth-cross/quat/blob/master/include/quaternion.hpp
      * TODO implement
@@ -1497,9 +1507,9 @@ class Quaternion {
 
     /**
      *
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @param {number} x in radians
+     * @param {number} y in radians
+     * @param {number} z in radians
      * @returns {Quaternion}
      */
     static fromEulerAngles(x, y, z) {
@@ -1519,6 +1529,7 @@ class Quaternion {
      */
     static rotateTowards(result, from, to, max_delta) {
         assert.isNumber(max_delta, 'max_delta');
+        assert.notNaN(max_delta, 'max_delta');
 
         const angle = from.angleTo(to);
 
@@ -1527,9 +1538,9 @@ class Quaternion {
             result.copy(to);
         } else {
             // clamp to 1, to make sure we don't overshoot
-            const t = min2(1, max_delta / angle);
+            const t = clamp01(max_delta / angle);
 
-            from.slerp(to, t);
+            result.slerpQuaternions(from, to, t);
         }
 
     }

package/src/core/geom/Quaternion.spec.js

@@ -1,6 +1,7 @@
+import { DEG_TO_RAD } from "../math/DEG_TO_RAD.js";
+import { decode_octahedron_to_unit } from "./3d/normal/octahedron/decode_octahedron_to_unit.js";
 import Quaternion from "./Quaternion.js";
 import Vector3 from "./Vector3.js";
-import { decode_octahedron_to_unit } from "./3d/normal/octahedron/decode_octahedron_to_unit.js";
 
 /**
  *
@@ -401,3 +402,28 @@ test("angleTo between identical quaternions should be 0", () => {
 
     expect(a.angleTo(b)).toBeCloseTo(0);
 });
+
+
+test("rotateTowards", () => {
+
+    const a = Quaternion.fromEulerAngles(30 * DEG_TO_RAD, 0, 0);
+    const b = Quaternion.fromEulerAngles(60 * DEG_TO_RAD, 0, 0);
+
+    const result = new Quaternion();
+
+    Quaternion.rotateTowards(result, a, b, 9 * DEG_TO_RAD);
+
+    expect(result.angleTo(a)).toBeCloseTo(9 * DEG_TO_RAD);
+
+    Quaternion.rotateTowards(result, a, b, 0);
+
+    expect(result.equals(a)).toBe(true);
+
+    Quaternion.rotateTowards(result, a, b, Infinity);
+
+    expect(result.equals(b)).toBe(true);
+
+    Quaternion.rotateTowards(result, a, b, -10);
+
+    expect(result.roughlyEquals(a)).toBe(true);
+});

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/json/resolvePath.d.ts

@@ -1,7 +1,7 @@
 /**
  *
  * @param {object} object
- * @param {string} path
+ * @param {string} path separated with forward slash "/"
  * @param {function} [missingPropertyHandler] Allows custom handling of missing properties
  * @returns {*}
  * @throws {Error} if a path can not be resolved

package/src/core/json/resolvePath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvePath.d.ts","sourceRoot":"","sources":["../../../../src/core/json/resolvePath.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,oCANW,MAAM,QACN,MAAM,0CAShB"}
+{"version":3,"file":"resolvePath.d.ts","sourceRoot":"","sources":["../../../../src/core/json/resolvePath.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,oCANW,MAAM,QACN,MAAM,0CAYhB"}

package/src/core/json/resolvePath.js

@@ -1,15 +1,19 @@
+import { assert } from "../assert.js";
 import { resolvePathByArray } from "./resolvePathByArray.js";
 
 
 /**
  *
  * @param {object} object
- * @param {string} path
+ * @param {string} path separated with forward slash "/"
  * @param {function} [missingPropertyHandler] Allows custom handling of missing properties
  * @returns {*}
  * @throws {Error} if a path can not be resolved
  */
 export function resolvePath(object, path, missingPropertyHandler) {
+    assert.isString(path, 'path');
+    assert.isObject(object, "object");
+
     const parts = path.split("/");
 
     return resolvePathByArray(object, parts, missingPropertyHandler);

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/core/math/iabs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Branchless fast integer Absolute value function.
+ * Same as Math.abs(x) but for integer values only.
+ * Only valid for integers up to and including 32 bit.
+ * @param {number} x
+ * @return {number}
+ */
+export function iabs(x: number): number;
+//# sourceMappingURL=iabs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iabs.d.ts","sourceRoot":"","sources":["../../../../src/core/math/iabs.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAHW,MAAM,GACL,MAAM,CAOjB"}

package/src/core/math/iabs.js

@@ -0,0 +1,15 @@
+import { assert } from "../assert.js";
+
+/**
+ * Branchless fast integer Absolute value function.
+ * Same as Math.abs(x) but for integer values only.
+ * Only valid for integers up to and including 32 bit.
+ * @param {number} x
+ * @return {number}
+ */
+export function iabs(x) {
+    // adapted from https://graphics.stanford.edu/~seander/bithacks.html
+    assert.isInteger(x, 'x');
+
+    return (x ^ (x >> 31)) - (x >> 31);
+}

package/src/core/math/iabs.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=iabs.spec.d.ts.map

package/src/core/math/iabs.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iabs.spec.d.ts","sourceRoot":"","sources":["../../../../src/core/math/iabs.spec.js"],"names":[],"mappings":""}

package/src/core/math/iabs.spec.js

@@ -0,0 +1,9 @@
+import { iabs } from "./iabs.js";
+
+test("basics", () => {
+    expect(iabs(0)).toBe(0);
+    expect(iabs(1)).toBe(1);
+    expect(iabs(1023)).toBe(1023);
+    expect(iabs(-1)).toBe(1);
+    expect(iabs(-1023)).toBe(1023);
+});

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/transform/Transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AA0BA;;;GAGG;AACH;IAwQI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAjRD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;OAGG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEW;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,uBAMC;IAED;;;OAGG;IACH,kBAMC;IAED;;;OAGG;IACH,qBAMC;IAED;;;;OAIG;IACH,kDAIC;IAED;;;;OAIG;IACH,oDAIC;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IAeD;;;;OAIG;IACH,sBAHW,SAAS,KACT,SAAS,QAMnB;IAED;;;OAGG;IACH,eAFW,OAAK,MAAM,EAAE,GAAC,YAAY,QAcpC;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED,mBAEC;IASL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;IAWhB;;;;;OAKG;IACH,mGAMC;;oBArXmB,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AA0BA;;;GAGG;AACH;IAwQI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAqDD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IAtVD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;OAGG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEW;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,uBAMC;IAED;;;OAGG;IACH,kBAMC;IAED;;;OAGG;IACH,qBAMC;IAED;;;;OAIG;IACH,kDAIC;IAED;;;;OAIG;IACH,oDAIC;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IAeD;;;;OAIG;IACH,sBAHW,SAAS,KACT,SAAS,QAMnB;IAED;;;OAGG;IACH,eAFW,OAAK,MAAM,EAAE,GAAC,YAAY,QAcpC;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBAhXI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}

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

@@ -355,6 +355,24 @@ export class Transform {
     toString() {
         return `{ position: ${this.position}, rotation: ${this.rotation}, scale: ${this.scale} }`;
     }
+
+    /**
+     * @deprecated use {@link Quaternion.rotateTowards} instead
+     * @param {Quaternion} sourceQuaternion
+     * @param {Vector3} targetVector
+     * @param {Number} limit
+     */
+    static adjustRotation(
+        sourceQuaternion,
+        targetVector,
+        limit = Infinity
+    ) {
+        const q = new Quaternion();
+
+        q.lookRotation(targetVector);
+
+        sourceQuaternion.rotateTowards(q, limit);
+    }
 }
 
 /**
@@ -370,17 +388,4 @@ Transform.typeName = "Transform";
 Transform.prototype.isTransform = true;
 
 
-/**
- * @deprecated use {@link Quaternion.rotateTowards} instead
- * @param {Quaternion} sourceQuaternion
- * @param {Vector3} targetVector
- * @param {Number} limit
- */
-Transform.adjustRotation = function (sourceQuaternion, targetVector, limit = Infinity) {
-    const q = new Quaternion();
-
-    q.lookRotation(targetVector);
-
-    sourceQuaternion.rotateTowards(q, limit);
-};
 

package/src/engine/ecs/transform/Transform.spec.js

@@ -1,9 +1,24 @@
+import { jest } from "@jest/globals";
 import { MATRIX_4_IDENTITY } from "../../../core/geom/3d/mat4/MATRIX_4_IDENTITY.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { Transform } from "./Transform.js";
 import { TransformFlags } from "./TransformFlags.js";
 
+/**
+ *
+ * @return {Transform}
+ */
+function sample_a() {
+    const a = new Transform();
+
+    a.position.set(1, 2, 3);
+    a.rotation.set(5, -7, 11, -13);
+    a.scale.set(17, -23, 29);
+
+    return a;
+}
+
 test("constructor does not throw", () => {
 
     expect(() => new Transform()).not.toThrow();
@@ -46,19 +61,43 @@ test("position changes propagate to matrix", () => {
     expect(t.matrix[14]).toBe(-7);
 });
 
-/**
- *
- * @return {Transform}
- */
-function sample_a() {
-    const a = new Transform();
+test("subscribe/unsubscribe", () => {
+    const mock = jest.fn();
 
-    a.position.set(1, 2, 3);
-    a.rotation.set(5, -7, 11, -13);
-    a.scale.set(17, -23, 29);
+    const t = sample_a();
 
-    return a;
-}
+    t.subscribe(mock);
+
+    expect(mock).not.toHaveBeenCalled();
+
+    t.position._add(1, 0, 0);
+
+    expect(mock).toHaveBeenCalledTimes(1);
+
+    t.scale._add(0, 1, 0);
+
+    expect(mock).toHaveBeenCalledTimes(2);
+
+    t.rotation.set(-1, 3, -5, -t.rotation.w);
+
+    expect(mock).toHaveBeenCalledTimes(3);
+
+    t.unsubscribe(mock);
+
+    expect(mock).toHaveBeenCalledTimes(3);
+
+    t.position._add(1, 0, 0);
+
+    expect(mock).toHaveBeenCalledTimes(3);
+
+    t.scale._add(0, 1, 0);
+
+    expect(mock).toHaveBeenCalledTimes(3);
+
+    t.rotation.set(-1, 3, -5, -t.rotation.w);
+
+    expect(mock).toHaveBeenCalledTimes(3);
+});
 
 test("to/fromJSON consistency", () => {
     const a = sample_a();

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"}