@woosh/meep-engine 2.126.63 → 2.126.65

package/package.json

@@ -5,7 +5,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.126.63",
+  "version": "2.126.65",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/collection/list/List.d.ts

@@ -4,8 +4,9 @@ export default class List<T> {
     get length(): number
 
     on: {
-        added: Signal<T>,
-        removed: Signal<T, number>
+        added: Signal<T, number>,
+        removed: Signal<T, number>,
+        changed: Signal<void>,
     }
 
     constructor(elements?: T[])

package/src/core/collection/list/List.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/List.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/List.js"],"names":[],"mappings":"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"}

package/src/core/collection/list/List.js

@@ -28,9 +28,36 @@ class List {
          * @readonly
          * @type {Signal<T,number>}
          */
-        removed: new Signal()
+        removed: new Signal(),
+
+        /**
+         * Captures both {@link #on.added} and {@link #on.removed} signals.
+         * Useful shortcut if you don't care about actual modifications, just the fact that something has changed.
+         * @readonly
+         * @type {Signal<>}
+         */
+        get changed() {
+            // lazily initialization, don't want to create the signal and capture events if we don't need it
+
+            const signal = new Signal();
+
+            // pipe changes to an aggregate signal
+            this.added.add(signal.send0, signal);
+            this.removed.add(signal.send0, signal);
+
+            // rewrite the property to return the aggregate signal
+            Object.defineProperty(this, 'changed', {
+                value: signal,
+                writable: false,
+                enumerable: true,
+                configurable: false
+            });
+
+            return signal;
+        }
     };
 
+
     /**
      * @readonly
      * @type {T[]}
@@ -58,6 +85,7 @@ class List {
          * @type {number}
          */
         this.length = this.data.length;
+
     }
 
     /**

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":"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"}
+{"version":3,"file":"AABB2.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/aabb/AABB2.js"],"names":[],"mappings":"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"}

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

@@ -477,16 +477,15 @@ class AABB2 {
      * @return {number}
      */
     get centerY() {
-
         return (this.y0 + this.y1) * 0.5
     }
 
     /**
-     *
+     * @deprecated prefer to use {@link width} property instead
      * @returns {number}
      */
     getWidth() {
-        return this.x1 - this.x0;
+        return this.width;
     }
 
     /**
@@ -494,15 +493,16 @@ class AABB2 {
      * @return {number}
      */
     get width() {
-        return this.getWidth();
+        return this.x1 - this.x0;
     }
 
     /**
      *
+     * @deprecated prefer to use {@link height} property instead
      * @returns {number}
      */
     getHeight() {
-        return this.y1 - this.y0;
+        return this.height;
     }
 
     /**
@@ -510,7 +510,7 @@ class AABB2 {
      * @return {number}
      */
     get height() {
-        return this.getHeight();
+        return this.y1 - this.y0;
     }
 
     /**
@@ -520,6 +520,8 @@ class AABB2 {
      * @param {Number} x1
      * @param {Number} y1
      * @returns {this}
+     *
+     * @see setBoundsUnordered
      */
     set(x0, y0, x1, y1) {
         assert.isNumber(x0, `x0`);
@@ -546,8 +548,8 @@ class AABB2 {
      * @param {number} y
      */
     setPosition(x, y) {
-        const width = this.getWidth();
-        const height = this.getHeight();
+        const width = this.width;
+        const height = this.height;
 
         this.set(x, y, x + width, y + height);
     }
@@ -598,7 +600,7 @@ class AABB2 {
      *
      * @return {number}
      */
-    hash(){
+    hash() {
         let h = 0; // Initial hash value
 
         // Prime numbers for mixing. These are often chosen to be large and coprime.
@@ -750,8 +752,13 @@ AABB2.prototype.isAABB2 = true;
 AABB2.computeLineBetweenTwoBoxes = computeLineBetweenTwoBoxes;
 
 /**
+ * Useful singleton with bounds 0,0,0,0.
  * @readonly
  * @type {AABB2}
+ * @example
+ *  const box = new AABB();
+ *  // ...
+ *  box.copy(AABB.zero); // zero out
  */
 AABB2.zero = Object.freeze(new AABB2(0, 0, 0, 0));
 

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

@@ -5,6 +5,11 @@
  * @param {number} b
  * @param {number} fraction value between 0 and 1
  * @return {number}
+ *
+ * @example
+ *    lerp(1, 2, 0.5) === 1.5
+ *    lerp(1, 2, 0) === 1
+ *    lerp(1, 2, 1) === 2
  */
 export function lerp(a: number, b: number, fraction: number): number;
 //# sourceMappingURL=lerp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lerp.d.ts","sourceRoot":"","sources":["../../../../src/core/math/lerp.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBALW,MAAM,KACN,MAAM,YACN,MAAM,GACL,MAAM,CAKjB"}
+{"version":3,"file":"lerp.d.ts","sourceRoot":"","sources":["../../../../src/core/math/lerp.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAVW,MAAM,KACN,MAAM,YACN,MAAM,GACL,MAAM,CAUjB"}

package/src/core/math/lerp.js

@@ -5,6 +5,11 @@
  * @param {number} b
  * @param {number} fraction value between 0 and 1
  * @return {number}
+ *
+ * @example
+ *    lerp(1, 2, 0.5) === 1.5
+ *    lerp(1, 2, 0) === 1
+ *    lerp(1, 2, 1) === 2
  */
 export function lerp(a, b, fraction) {
     const span = b - a;

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

@@ -1,7 +1,7 @@
 /**
  * @see https://www.w3.org/TR/WGSL/#roundup
  * @param {number} x what to round
- * @param {number} divisor divisor
+ * @param {number} divisor divisor positive integer
  * @return {number}
  *
  * @example

package/src/core/math/round_up.js

@@ -3,7 +3,7 @@ import { assert } from "@woosh/meep-engine/src/core/assert";
 /**
  * @see https://www.w3.org/TR/WGSL/#roundup
  * @param {number} x what to round
- * @param {number} divisor divisor
+ * @param {number} divisor divisor positive integer
  * @return {number}
  *
  * @example

package/src/core/math/spline/spline3_hermite.js

@@ -19,7 +19,7 @@ export function spline3_hermite(t, p0, p1, m0, m1) {
     const a = 2 * t3 - 3 * t2 + 1;
     const b = t3 - 2 * t2 + t;
     const c = t3 - t2;
-    const d = -2 * t3 + 3 * t2;
+    const d = 3 * t2 - 2 * t3;
 
     return a * p0 + b * m0 + c * m1 + d * p1;
 }

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

@@ -2,6 +2,9 @@
  * Square input (x^2)
  * @param {number} x
  * @returns {number}
+ * @example
+ *      sqr(2) === 4
+ *      sqr(4) === 16
  */
 export function sqr(x: number): number;
 //# sourceMappingURL=sqr.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sqr.d.ts","sourceRoot":"","sources":["../../../../src/core/math/sqr.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,uBAHW,MAAM,GACJ,MAAM,CAIlB"}
+{"version":3,"file":"sqr.d.ts","sourceRoot":"","sources":["../../../../src/core/math/sqr.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,uBANW,MAAM,GACJ,MAAM,CAOlB"}

package/src/core/math/sqr.js

@@ -2,6 +2,9 @@
  * Square input (x^2)
  * @param {number} x
  * @returns {number}
+ * @example
+ *      sqr(2) === 4
+ *      sqr(4) === 16
  */
 export function sqr(x) {
     return x * x;

package/src/engine/animation/curve/Keyframe.js

@@ -120,7 +120,7 @@ export class Keyframe {
      */
     hash() {
         return computeHashFloat(this.time)
-            ^ computeHashFloat(this.value);
+            ^ (computeHashFloat(this.value) * 31);
     }
 
     toJSON() {

package/src/engine/animation/curve/animation_curve_subdivide.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Subdivide a curve segment by introducing a new keyframe at a given normalized time.
+ * Subdivision does not alter the curve shape in any way, it is intended primarily for editing purposes.
+ * @param {Keyframe} out keyframe to be added at the point of subdivision, its tangents, time and value will be overwritten
+ * @param {Keyframe} key0
+ * @param {Keyframe} key1
+ * @param {number} t normalized time in [0..1] between key0 and key1 where new frame is to be inserted
+ * @returns {Keyframe} `out`, for convenience
+ * @see AnimationCurve
+ * @example
+ *  const new_frame = animation_curve_subdivide(new Keyframe(), key0, key1, 0.5);
+ *  curve.add(new_frame);
+ */
+export function animation_curve_subdivide(out: Keyframe, key0: Keyframe, key1: Keyframe, t: number): Keyframe;
+//# sourceMappingURL=animation_curve_subdivide.d.ts.map

package/src/engine/animation/curve/animation_curve_subdivide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation_curve_subdivide.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_subdivide.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,+CAVW,QAAQ,QACR,QAAQ,QACR,QAAQ,KACR,MAAM,GACJ,QAAQ,CA2CpB"}

package/src/engine/animation/curve/animation_curve_subdivide.js

@@ -0,0 +1,55 @@
+import { lerp } from "../../../core/math/lerp.js";
+import { spline3_hermite } from "../../../core/math/spline/spline3_hermite.js";
+import { spline3_hermite_derivative } from "../../../core/math/spline/spline3_hermite_derivative.js";
+
+/**
+ * Subdivide a curve segment by introducing a new keyframe at a given normalized time.
+ * Subdivision does not alter the curve shape in any way, it is intended primarily for editing purposes.
+ * @param {Keyframe} out keyframe to be added at the point of subdivision, its tangents, time and value will be overwritten
+ * @param {Keyframe} key0
+ * @param {Keyframe} key1
+ * @param {number} t normalized time in [0..1] between key0 and key1 where new frame is to be inserted
+ * @returns {Keyframe} `out`, for convenience
+ * @see AnimationCurve
+ * @example
+ *  const new_frame = animation_curve_subdivide(new Keyframe(), key0, key1, 0.5);
+ *  curve.add(new_frame);
+ */
+export function animation_curve_subdivide(
+    out,
+    key0,
+    key1,
+    t
+) {
+
+    const v0 = key0.value;
+    const v1 = key1.value;
+
+    const time_span = key1.time - key0.time;
+
+    // Note that Keyframe tangents are normalized, so we denomalize them before using them
+    const m0 = key0.outTangent * time_span;
+    const m1 = key1.inTangent * time_span;
+
+    const xm = spline3_hermite(
+        t,
+        v0, v1,
+        m0, m1
+    );
+    const vm = spline3_hermite_derivative(
+        t,
+        v0, v1,
+        m0, m1
+    );
+
+    out.time = lerp(key0.time, key1.time, t);
+    out.value = xm;
+
+    // re-normalize tangent
+    const new_tangent = vm / time_span;
+
+    out.inTangent = new_tangent;
+    out.outTangent = new_tangent;
+
+    return out;
+}