@woosh/meep-engine 2.123.2 → 2.123.5

package/package.json

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

package/src/core/collection/RingBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RingBuffer.d.ts","sourceRoot":"","sources":["../../../../src/core/collection/RingBuffer.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAFa,CAAC;IAGV;;OAEG;IACH,kBAFW,MAAM,EAoChB;IA7BG;;;OAGG;IACH,MAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,MAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,MAFU,CAAC,EAAE,CAEc;IAG/B;;;OAGG;IACH,iBAFW,MAAM,QAsBhB;IAED;;;OAGG;IACH,WAFY,CAAC,CAIZ;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,CAAC,CAUb;IAED,cAIC;IAED;;;OAGG;IACH,cAFW,CAAC,QAuBX;IAED;;;OAGG;IACH,SAFa,CAAC,GAAC,SAAS,CAcvB;IAED;;;OAGG;IACH,4BAFW,MAAM,QA8BhB;IAED;;;;;OAKG;IACH,oBAJW,CAAS,IAAC,EAAD,CAAC,KAAE,OAAO,YACnB,GAAC,GACC,CAAC,GAAC,SAAS,CAoBvB;IAED;;;;OAIG;IACH,iBAHW,CAAS,IAAC,EAAD,CAAC,QAAC,YACX,GAAC,QAgBX;IAED;;;;OAIG;IACH,gBAHW,CAAC,GACC,OAAO,CAInB;CACJ"}
+{"version":3,"file":"RingBuffer.d.ts","sourceRoot":"","sources":["../../../../src/core/collection/RingBuffer.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAFa,CAAC;IAGV;;OAEG;IACH,kBAFW,MAAM,EAoChB;IA7BG;;;OAGG;IACH,MAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,MAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,MAFU,CAAC,EAAE,CAEc;IAG/B;;;OAGG;IACH,iBAFW,MAAM,QAwBhB;IAED;;;OAGG;IACH,WAFY,CAAC,CAIZ;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,CAAC,CAYb;IAED,cAIC;IAED;;;OAGG;IACH,cAFW,CAAC,QAuBX;IAED;;;OAGG;IACH,SAFa,CAAC,GAAC,SAAS,CAcvB;IAED;;;OAGG;IACH,4BAFW,MAAM,QA8BhB;IAED;;;;;OAKG;IACH,oBAJW,CAAS,IAAC,EAAD,CAAC,KAAE,OAAO,YACnB,GAAC,GACC,CAAC,GAAC,SAAS,CAsBvB;IAED;;;;OAIG;IACH,iBAHW,CAAS,IAAC,EAAD,CAAC,QAAC,YACX,GAAC,QAkBX;IAED;;;;OAIG;IACH,gBAHW,CAAC,GACC,OAAO,CAKnB;CACJ"}

package/src/core/collection/RingBuffer.js

@@ -52,6 +52,8 @@ export class RingBuffer {
      * @param {number} new_size
      */
     resize(new_size) {
+        assert.isNonNegativeInteger(new_size, 'new_size');
+        assert.greaterThan(new_size, 0, `new_size`);
 
         if (new_size === this.size) {
             // already the right size
@@ -87,6 +89,8 @@ export class RingBuffer {
      * @returns {V}
      */
     getFromHead(offset) {
+        assert.isNonNegativeInteger(offset, 'offset');
+
         let i = this.head - (offset + 1);
 
         while (i < 0) {
@@ -188,6 +192,8 @@ export class RingBuffer {
      * @returns {V|undefined}
      */
     removeIf(condition, thisArg) {
+        assert.isFunction(condition, 'condition');
+
         const count = this.count;
         const size = this.size;
 
@@ -213,6 +219,8 @@ export class RingBuffer {
      * @param {*} [thisArg]
      */
     forEach(visitor, thisArg) {
+        assert.isFunction(visitor, 'visitor');
+
         const count = this.count;
         const size = this.size;
 
@@ -234,6 +242,7 @@ export class RingBuffer {
      * @returns {boolean}
      */
     contains(value) {
+        // TODO do a bounds check
         return this.data.indexOf(value) !== -1;
     }
 }

package/src/core/geom/Quaternion.d.ts

@@ -73,13 +73,45 @@ export class Quaternion {
      * @type {Signal<number, number, number, number, number, number, number, number>}
      */
     readonly onChanged: Signal<number, number, number, number, number, number, number, number>;
+    /**
+     *
+     * @param {number} v
+     */
     set 0(v: number);
+    /**
+     *
+     * @return {number}
+     */
     get 0(): number;
+    /**
+     *
+     * @param {number} v
+     */
     set 1(v: number);
+    /**
+     *
+     * @return {number}
+     */
     get 1(): number;
+    /**
+     *
+     * @param {number} v
+     */
     set 2(v: number);
+    /**
+     *
+     * @return {number}
+     */
     get 2(): number;
+    /**
+     *
+     * @param {number} v
+     */
     set 3(v: number);
+    /**
+     *
+     * @return {number}
+     */
     get 3(): number;
     /**
      * Orient quaternion on a `forward` vector, with the spin matching `up` vector
@@ -90,8 +122,9 @@ export class Quaternion {
      * @param {number} ux up vector
      * @param {number} uy up vector
      * @param {number} uz up vector
+     * @returns {this}
      */
-    _lookRotation(fx: number, fy: number, fz: number, ux: number, uy: number, uz: number): void;
+    _lookRotation(fx: number, fy: number, fz: number, ux: number, uy: number, uz: number): this;
     /**
      *
      * @param {Vector3} forward
@@ -111,8 +144,9 @@ export class Quaternion {
     copyInverse(other: Quaternion): void;
     /**
      * Calculates the inverse
+     * @returns {this}
      */
-    invert(): void;
+    invert(): this;
     /**
      * Returns angle between this orientation and another
      * @param {Quaternion} other
@@ -402,7 +436,12 @@ export class Quaternion {
         z: number;
         w: number;
     };
-    fromJSON(obj: any): void;
+    /**
+     *
+     * @param obj
+     * @return {this}
+     */
+    fromJSON(obj: any): this;
     /**
      *
      * @param {BinaryBuffer} buffer
@@ -438,9 +477,10 @@ export class Quaternion {
     /**
      *
      * @param {number[]} array
-     * @param {number} offset
+     * @param {number} [offset]
+     * @returns {this}
      */
-    readFromArray(array: number[], offset?: number): void;
+    readFromArray(array: number[], offset?: number): this;
     /**
      *
      * @param {number[]} [array]
@@ -483,7 +523,7 @@ export class Quaternion {
      */
     random(random?: () => number): Quaternion;
     toString(): string;
-    fromArray: (array: number[], offset?: number) => void;
+    fromArray: (array: number[], offset?: number) => Quaternion;
     toArray: (array?: number[], offset?: number) => number[];
     asArray: (array?: number[], offset?: number) => number[];
     fromEulerAngles: (x: number, y: number, z: number) => Quaternion;
@@ -495,8 +535,9 @@ export class Quaternion {
     readonly isQuaternion: boolean;
     /**
      * Making quaternion iterable
+     * @returns {Generator<number>}
      */
-    [Symbol.iterator](): Generator<number, void, unknown>;
+    [Symbol.iterator](): Generator<number>;
 }
 export namespace Quaternion {
     let identity: Quaternion;

package/src/core/geom/Quaternion.d.ts.map

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

package/src/core/geom/Quaternion.js

@@ -72,40 +72,73 @@ export class Quaternion {
 
     // Making Quaternion comply to array interface
 
+    /**
+     *
+     * @return {number}
+     */
     get 0() {
         return this.x;
     }
 
+    /**
+     *
+     * @return {number}
+     */
     get 1() {
         return this.y;
     }
 
+    /**
+     *
+     * @return {number}
+     */
     get 2() {
         return this.z;
     }
 
+    /**
+     *
+     * @return {number}
+     */
     get 3() {
         return this.w;
     }
 
+    /**
+     *
+     * @param {number} v
+     */
     set 0(v) {
         this.x = v;
     }
 
+    /**
+     *
+     * @param {number} v
+     */
     set 1(v) {
         this.y = v;
     }
 
+    /**
+     *
+     * @param {number} v
+     */
     set 2(v) {
         this.z = v;
     }
 
+    /**
+     *
+     * @param {number} v
+     */
     set 3(v) {
         this.w = v;
     }
 
     /**
      * Making quaternion iterable
+     * @returns {Generator<number>}
      */
     * [Symbol.iterator]() {
 
@@ -126,6 +159,7 @@ export class Quaternion {
      * @param {number} ux up vector
      * @param {number} uy up vector
      * @param {number} uz up vector
+     * @returns {this}
      */
     _lookRotation(
         fx, fy, fz,
@@ -173,7 +207,7 @@ export class Quaternion {
         const m12 = scratch_v3_a.y;
         const m22 = scratch_v3_a.z;
 
-        this.__setFromRotationMatrix(
+       return this.__setFromRotationMatrix(
             m00, m01, m02,
             m10, m11, m12,
             m20, m21, m22
@@ -218,6 +252,7 @@ export class Quaternion {
 
     /**
      * Calculates the inverse
+     * @returns {this}
      */
     invert() {
         const x = this.x;
@@ -228,8 +263,8 @@ export class Quaternion {
         const length_sqr = x * x + y * y + z * z + w * w;
 
         if (length_sqr === 0) {
-            this.set(0, 0, 0, 1);
-            return;
+            // 0 magnitude, avoid division by 0 and set identity (arbitrage)
+            return this.set(0, 0, 0, 1);
         }
 
         const invDot = 1.0 / length_sqr;
@@ -239,7 +274,7 @@ export class Quaternion {
         const _z = -z * invDot;
         const _w = w * invDot;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -1259,8 +1294,13 @@ export class Quaternion {
         };
     }
 
+    /**
+     *
+     * @param obj
+     * @return {this}
+     */
     fromJSON(obj) {
-        this.set(obj.x, obj.y, obj.z, obj.w);
+        return this.set(obj.x, obj.y, obj.z, obj.w);
     }
 
     /**
@@ -1332,10 +1372,11 @@ export class Quaternion {
     /**
      *
      * @param {number[]} array
-     * @param {number} offset
+     * @param {number} [offset]
+     * @returns {this}
      */
     readFromArray(array, offset = 0) {
-        this.set(
+        return this.set(
             array[offset],
             array[offset + 1],
             array[offset + 2],

package/src/engine/development/performance/AbstractMetric.d.ts

@@ -15,6 +15,18 @@ export class AbstractMetric {
      * @returns {boolean} whether metric was successfully computed or not
      */
     computeStats(result: MetricStatistics): boolean;
+    /**
+     * Shortcut to {@link computeStats}
+     * Use the other one if you want to avoid memory allocation
+     * @return {MetricStatistics}
+     */
+    get stats(): MetricStatistics;
     clear(): void;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isMetric: boolean;
 }
+import { MetricStatistics } from "./MetricStatistics.js";
 //# sourceMappingURL=AbstractMetric.d.ts.map

package/src/engine/development/performance/AbstractMetric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractMetric.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/AbstractMetric.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,cAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;OAEG;IACH,iBAFa,MAAM,GAAC,SAAS,CAI5B;IAED;;;;OAIG;IACH,qBAHW,gBAAgB,GACd,OAAO,CAInB;IAED,cAEC;CACJ"}
+{"version":3,"file":"AbstractMetric.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/AbstractMetric.js"],"names":[],"mappings":"AAEA;IACI;;;;OAIG;IACH,cAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;OAEG;IACH,iBAFa,MAAM,GAAC,SAAS,CAI5B;IAED;;;;OAIG;IACH,qBAHW,gBAAgB,GACd,OAAO,CAInB;IAED;;;;OAIG;IACH,aAFY,gBAAgB,CAQ3B;IAED,cAEC;IAGL;;;OAGG;IACH,mBAFU,OAAO,CAEgB;CANhC;iCA5CgC,uBAAuB"}

package/src/engine/development/performance/AbstractMetric.js

@@ -1,3 +1,5 @@
+import { MetricStatistics } from "./MetricStatistics.js";
+
 export class AbstractMetric {
     /**
      *
@@ -24,7 +26,26 @@ export class AbstractMetric {
         throw new Error('Not implemented');
     }
 
+    /**
+     * Shortcut to {@link computeStats}
+     * Use the other one if you want to avoid memory allocation
+     * @return {MetricStatistics}
+     */
+    get stats() {
+        const stats = new MetricStatistics();
+
+        this.computeStats(stats);
+
+        return stats;
+    }
+
     clear() {
         throw new Error('Not implemented');
     }
 }
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+AbstractMetric.prototype.isMetric = true;

package/src/engine/development/performance/MetricCollection.d.ts

@@ -1,19 +1,43 @@
+/**
+ * A class for managing a collection of metrics where each metric can store data and be accessed by name.
+ * Provides functionality to add, retrieve, list, and clear metrics.
+ *
+ * @example
+ *   const metrics = new MetricCollection();
+ *   metrics.create({name: "execution time"});
+ *
+ *   // ... record metrics
+ *   const t0 = performance.now();
+ *   do_expensive_computation();
+ *   const t1 = performance.now();
+ *
+ *   metrics.get("execution time").record(t1 - t0);
+ *
+ *   // ... read stats
+ *   const stats = metrics.get("execution time").stats;
+ *
+ *   console.log(`Average execution time: ${stats.mean}`);
+ */
 export class MetricCollection {
     /**
      * @private
      * @type {Map<string, AbstractMetric>}
      */
     private data;
+    /**
+     * Clear all data records.
+     * Note: does not remove any metrics, just the data within them
+     */
     clear(): void;
     /**
-     *
+     * Get names of available metrics
      * @returns {string[]}
      */
     list(): string[];
     /**
      *
      * @param {string} name
-     * @param {number} [buffer_size]
+     * @param {number} [buffer_size] The larger this number is - the more detail metric can hold. If you plan to compute statistics, this is your sample size.
      * @returns {AbstractMetric}
      */
     create({ name, buffer_size }: string): AbstractMetric;

package/src/engine/development/performance/MetricCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricCollection.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/MetricCollection.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,aAAiB;IAEjB,cAIC;IAED;;;OAGG;IACH,QAFa,MAAM,EAAE,CAIpB;IAED;;;;;OAKG;IACH,8BAJW,MAAM,GAEJ,cAAc,CAQ1B;IAED;;;;OAIG;IACH,UAHW,MAAM,UACN,cAAc,QAMxB;IAED;;;;OAIG;IACH,UAHW,MAAM,GACJ,cAAc,GAAC,SAAS,CAIpC;CACJ"}
+{"version":3,"file":"MetricCollection.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/MetricCollection.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAEI;;;OAGG;IACH,aAAiB;IAEjB;;;OAGG;IACH,cAIC;IAED;;;OAGG;IACH,QAFa,MAAM,EAAE,CAIpB;IAED;;;;;OAKG;IACH,8BAJW,MAAM,GAEJ,cAAc,CAQ1B;IAED;;;;OAIG;IACH,UAHW,MAAM,UACN,cAAc,QASxB;IAED;;;;OAIG;IACH,UAHW,MAAM,GACJ,cAAc,GAAC,SAAS,CAMpC;CACJ"}

package/src/engine/development/performance/MetricCollection.js

@@ -1,6 +1,26 @@
 import { assert } from "../../../core/assert.js";
 import { RingBufferMetric } from "./RingBufferMetric.js";
 
+/**
+ * A class for managing a collection of metrics where each metric can store data and be accessed by name.
+ * Provides functionality to add, retrieve, list, and clear metrics.
+ *
+ * @example
+ *   const metrics = new MetricCollection();
+ *   metrics.create({name: "execution time"});
+ *
+ *   // ... record metrics
+ *   const t0 = performance.now();
+ *   do_expensive_computation();
+ *   const t1 = performance.now();
+ *
+ *   metrics.get("execution time").record(t1 - t0);
+ *
+ *   // ... read stats
+ *   const stats = metrics.get("execution time").stats;
+ *
+ *   console.log(`Average execution time: ${stats.mean}`);
+ */
 export class MetricCollection {
 
     /**
@@ -9,6 +29,10 @@ export class MetricCollection {
      */
     data = new Map();
 
+    /**
+     * Clear all data records.
+     * Note: does not remove any metrics, just the data within them
+     */
     clear() {
         this.data.forEach((value, key) => {
             value.clear();
@@ -16,7 +40,7 @@ export class MetricCollection {
     }
 
     /**
-     *
+     * Get names of available metrics
      * @returns {string[]}
      */
     list() {
@@ -26,10 +50,10 @@ export class MetricCollection {
     /**
      *
      * @param {string} name
-     * @param {number} [buffer_size]
+     * @param {number} [buffer_size] The larger this number is - the more detail metric can hold. If you plan to compute statistics, this is your sample size.
      * @returns {AbstractMetric}
      */
-    create({ name, buffer_size = 1000 }) {
+    create({ name, buffer_size = 128 }) {
         const metric = new RingBufferMetric(buffer_size);
 
         this.add(name, metric);
@@ -44,6 +68,9 @@ export class MetricCollection {
      */
     add(name, metric) {
         assert.isString(name, 'name');
+        assert.defined(metric, 'metric');
+        assert.isObject(metric, "metric");
+        assert.equal(metric.isMetric, true, "metric");
 
         this.data.set(name, metric);
     }
@@ -54,6 +81,8 @@ export class MetricCollection {
      * @returns {AbstractMetric|undefined}
      */
     get(name) {
+        assert.isString(name, 'name');
+
         return this.data.get(name);
     }
 }

package/src/engine/development/performance/MetricStatistics.js

@@ -5,6 +5,6 @@ export class MetricStatistics {
     min = 0;
 
     toString() {
-        return `{min:${this.min}, max:${this.max}, mean:${this.mean}, median:${this.median}`;
+        return `{ min:${this.min}, max:${this.max}, mean:${this.mean}, median:${this.median} }`;
     }
 }

package/src/engine/development/performance/RingBufferMetric.d.ts

@@ -1,4 +1,12 @@
+/**
+ * Metric container with a limited size and great performance characteristics.
+ * Does not allocate memory during usage.
+ */
 export class RingBufferMetric extends AbstractMetric {
+    /**
+     *
+     * @param {number} [size] how many records should the ring-buffer hold?
+     */
     constructor(size?: number);
     /**
      *
@@ -12,8 +20,13 @@ export class RingBufferMetric extends AbstractMetric {
      * @param {number} size
      */
     resize(size: number): void;
-    getLastRecord(): any;
     record(value: any): void;
+    /**
+     *
+     * @param {MetricStatistics} result
+     * @returns {boolean}
+     */
+    computeStats(result: MetricStatistics): boolean;
 }
 import { AbstractMetric } from "./AbstractMetric.js";
 //# sourceMappingURL=RingBufferMetric.d.ts.map

package/src/engine/development/performance/RingBufferMetric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RingBufferMetric.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/RingBufferMetric.js"],"names":[],"mappings":"AAOA;IACI,2BAUC;IAPG;;;;;OAKG;IACH,wBAAkC;IAGtC;;;OAGG;IACH,aAFW,MAAM,QAIhB;IAED,qBAEC;IAED,yBAEC;CAsCJ;+BAnE8B,qBAAqB"}
+{"version":3,"file":"RingBufferMetric.d.ts","sourceRoot":"","sources":["../../../../../src/engine/development/performance/RingBufferMetric.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH;IACI;;;OAGG;IACH,mBAFW,MAAM,EAYhB;IAPG;;;;;OAKG;IACH,wBAAkC;IAGtC;;;OAGG;IACH,aAFW,MAAM,QAIhB;IAcD,yBAEC;IAED;;;;OAIG;IACH,qBAHW,gBAAgB,GACd,OAAO,CA4BnB;CAKJ;+BAnF8B,qBAAqB"}

package/src/engine/development/performance/RingBufferMetric.js

@@ -5,8 +5,16 @@ import { computeStatisticalMean } from "../../../core/math/statistics/computeSta
 import { computeStatisticalPartialMedian } from "../../../core/math/statistics/computeStatisticalPartialMedian.js";
 import { AbstractMetric } from "./AbstractMetric.js";
 
+/**
+ * Metric container with a limited size and great performance characteristics.
+ * Does not allocate memory during usage.
+ */
 export class RingBufferMetric extends AbstractMetric {
-    constructor(size = 100) {
+    /**
+     *
+     * @param {number} [size] how many records should the ring-buffer hold?
+     */
+    constructor(size = 128) {
         super();
 
         /**
@@ -26,7 +34,15 @@ export class RingBufferMetric extends AbstractMetric {
         this.__data.resize(size);
     }
 
+    /**
+     * When metric has no records - this will produce 0
+     * @return {number}
+     */
     getLastRecord() {
+        if (this.__data.count === 0) {
+            return 0;
+        }
+
         return this.__data.getHead();
     }
 

package/src/engine/development/performance/monitor/MetricCollectionConsoleMonitor.d.ts

@@ -1,10 +1,19 @@
+/**
+ *
+ * @example
+ *  const metrics = new MetricCollection(); // get a metrics collection
+ *
+ *  // ...
+ *  MetricCollectionConsoleMonitor.from(metrics).start(); // from now on all metric stats will be printed in console every few seconds
+ */
 export class MetricCollectionConsoleMonitor {
     /**
      *
      * @param {MetricCollection} metrics
+     * @param {number} [timeout_seconds] how frequently should stats be printed? In seconds.
      * @returns {PeriodicConsolePrinter}
      */
-    static from(metrics: MetricCollection): PeriodicConsolePrinter;
+    static from(metrics: MetricCollection, timeout_seconds?: number): PeriodicConsolePrinter;
 }
 import { PeriodicConsolePrinter } from "./PeriodicConsolePrinter.js";
 //# sourceMappingURL=MetricCollectionConsoleMonitor.d.ts.map

package/src/engine/development/performance/monitor/MetricCollectionConsoleMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricCollectionConsoleMonitor.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/development/performance/monitor/MetricCollectionConsoleMonitor.js"],"names":[],"mappings":"AAGA;IAEI;;;;OAIG;IACH,qBAHW,gBAAgB,GACd,sBAAsB,CAYlC;CAEJ;uCArBsC,6BAA6B"}
+{"version":3,"file":"MetricCollectionConsoleMonitor.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/development/performance/monitor/MetricCollectionConsoleMonitor.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH;IAEI;;;;;OAKG;IACH,qBAJW,gBAAgB,oBAChB,MAAM,GACJ,sBAAsB,CAYlC;CAEJ;uCA9BsC,6BAA6B"}

package/src/engine/development/performance/monitor/MetricCollectionConsoleMonitor.js

@@ -1,18 +1,27 @@
 import { MetricStatistics } from "../MetricStatistics.js";
 import { PeriodicConsolePrinter } from "./PeriodicConsolePrinter.js";
 
-export class MetricCollectionConsoleMonitor{
+/**
+ *
+ * @example
+ *  const metrics = new MetricCollection(); // get a metrics collection
+ *
+ *  // ...
+ *  MetricCollectionConsoleMonitor.from(metrics).start(); // from now on all metric stats will be printed in console every few seconds
+ */
+export class MetricCollectionConsoleMonitor {
 
     /**
      *
      * @param {MetricCollection} metrics
+     * @param {number} [timeout_seconds] how frequently should stats be printed? In seconds.
      * @returns {PeriodicConsolePrinter}
      */
-    static from(metrics){
+    static from(metrics,timeout_seconds= 3) {
 
         const metric_stats = new MetricStatistics();
 
-        return new PeriodicConsolePrinter(3, () => metrics.list().map(m => {
+        return new PeriodicConsolePrinter(timeout_seconds, () => metrics.list().map(m => {
             metrics.get(m).computeStats(metric_stats);
 
             return `${m}: ${metric_stats}`;

package/src/engine/development/performance/monitor/PeriodicConsolePrinter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeriodicConsolePrinter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/development/performance/monitor/PeriodicConsolePrinter.js"],"names":[],"mappings":"AAAA;IACI;;;;;OAKG;IACH,qBAJW,MAAM,uCAEN,GAAC,EAWX;IARG,kBAAwB;IACxB,iBAAkB;IAElB,qBAIC;IAGL,cAOC;IAED,aAQC;CACJ"}
+{"version":3,"file":"PeriodicConsolePrinter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/development/performance/monitor/PeriodicConsolePrinter.js"],"names":[],"mappings":"AAEA;IACI;;;;;OAKG;IACH,qBAJW,MAAM,uCAEN,GAAC,EAcX;IARG,kBAAwB;IACxB,iBAAkB;IAElB,qBAIC;IAGL,cAOC;IAED,aAQC;CACJ"}

package/src/engine/development/performance/monitor/PeriodicConsolePrinter.js

@@ -1,3 +1,5 @@
+import { assert } from "../../../../core/assert.js";
+
 export class PeriodicConsolePrinter {
     /**
      *
@@ -6,6 +8,9 @@ export class PeriodicConsolePrinter {
      * @param {*} [thisArg]
      */
     constructor(timeout = 15, builderFunction, thisArg) {
+        assert.isNumber(timeout, "timeout");
+        assert.isFunction(builderFunction, "builderFunction");
+
         this.__timeout = timeout;
         this.__handle = -1;
 

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

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

package/src/engine/ecs/EntityComponentDataset.js

@@ -161,12 +161,20 @@ export class EntityComponentDataset {
     entityGeneration = new Uint32Array(0);
 
     /**
+     * Bit table, if a bit is set - that means component is present.
+     * The format is
+     *      entity_0: [component_0, component_1, ... component_n]
+     *      entity_1: [component_0, component_1, ... component_n]
+     *       ...
+     *      entity_n: [component_0, component_1, ... component_n]
      * @private
      * @type {BitSet}
      */
     componentOccupancy = new BitSet();
 
     /**
+     * Do not modify directly.
+     * Use {@link setComponentTypeMap} instead.
      * @private
      * @type {Class[]}
      */
@@ -425,7 +433,7 @@ export class EntityComponentDataset {
     /**
      * Convenience method for retrieving a collection of components for a given entity
      * @param {number} entity ID of the entity
-     * @param {Array} componentClasses Classes of components to extract
+     * @param {[]} componentClasses Classes of components to extract
      * @returns {Array}
      */
     getComponents(entity, componentClasses) {
@@ -495,6 +503,7 @@ export class EntityComponentDataset {
     /**
      * Modify dataset component mapping. Algorithm will attempt to mutate dataset even if entities exist, however, it will not remove component classes for which instances exist in the dataset.
      * @param {Class[]} map collection of component classes
+     * @returns {void}
      * @throws Error when attempting to remove component classes with live instances
      */
     setComponentTypeMap(map) {
@@ -598,6 +607,8 @@ export class EntityComponentDataset {
             for (i = 0, l = typesToAdd.length; i < l; i++) {
                 const type = typesToAdd[i];
 
+                assert.defined(type, 'type');
+
                 const newIndex = map.indexOf(type);
 
                 //initialize component store
@@ -683,10 +694,13 @@ export class EntityComponentDataset {
     /**
      *
      * @param {Class[]} types
-     * @returns {boolean}
+     * @returns {boolean} true if all types are present, false otherwise
      */
     areComponentTypesRegistered(types) {
-        for (let i = 0; i < types.length; i++) {
+        assert.isArray(types, 'types');
+
+        const count = types.length;
+        for (let i = 0; i < count; i++) {
             const type = types[i];
 
             if (!this.isComponentTypeRegistered(type)) {
@@ -704,6 +718,9 @@ export class EntityComponentDataset {
      * @return {boolean}
      */
     isComponentTypeRegistered(type) {
+        assert.defined(type, 'type');
+        assert.notNull(type, 'type');
+
         const componentTypeMap = this.getComponentTypeMap();
 
         return componentTypeMap.indexOf(type) !== -1;
@@ -762,7 +779,8 @@ export class EntityComponentDataset {
      * @returns {boolean} true iff component is removed, false if it was not registered
      */
     unregisterComponentType(type) {
-        if (this.isComponentTypeRegistered(type)) {
+
+        if (!this.isComponentTypeRegistered(type)) {
             // not registered
             return false;
         }
@@ -806,7 +824,7 @@ export class EntityComponentDataset {
      */
     getEntityGeneration(entity_id) {
         assert.isNonNegativeInteger(entity_id, 'entity_id');
-        assert.ok(this.entityExists(entity_id),`Entity ${entity_id} does not exist`);
+        assert.ok(this.entityExists(entity_id), `Entity ${entity_id} does not exist`);
 
         return this.entityGeneration[entity_id];
     }
@@ -1003,10 +1021,13 @@ export class EntityComponentDataset {
 
     /**
      *
-     * @param klass
+     * @param {Function|Class} klass
      * @returns {number}
      */
     computeComponentTypeIndex(klass) {
+        assert.defined(klass, "klass");
+        assert.notNull(klass, "klass");
+
         const idx = this.__type_to_index_map.get(klass);
 
         if (idx === undefined) {
@@ -1399,13 +1420,15 @@ export class EntityComponentDataset {
     traverseComponentsByIndex(componentTypeIndex, visitor, thisArg) {
 
         assert.isNumber(componentTypeIndex, "componentTypeIndex");
+        assert.isNonNegativeInteger(componentTypeIndex, "componentTypeIndex");
         assert.isFunction(visitor, "visitor");
 
         this.__traverseComponentsByIndex_via_property(componentTypeIndex, visitor, thisArg);
     }
 
     /**
-     *
+     * Alternative to {@link __traverseComponentsByIndex_via_property} as of 2020, appears to be significantly slower on Chrome with larger datasets
+     * @private
      * @param {number} componentTypeIndex
      * @param {function} visitor
      * @param {*} [thisArg]
@@ -1438,7 +1461,7 @@ export class EntityComponentDataset {
     }
 
     /**
-     *
+     * @private
      * @param {number} componentTypeIndex
      * @param {function} visitor
      * @param {*} [thisArg]
@@ -1574,6 +1597,9 @@ export class EntityComponentDataset {
      * @returns {boolean}
      */
     removeAnyEventListener(entity, listener, thisArg) {
+        assert.isNonNegativeInteger(entity, "entity");
+        assert.isFunction(listener, "listener");
+
         const evl = this.__entityAnyEventListeners;
 
         let handlers = evl[entity];
@@ -1609,7 +1635,7 @@ export class EntityComponentDataset {
      * @param {*} [thisArg]
      */
     addEntityEventListener(entity, eventName, listener, thisArg) {
-
+        assert.isNonNegativeInteger(entity, "entity");
         assert.isString(eventName, "eventName");
         assert.isFunction(listener, "listener");
 
@@ -1648,6 +1674,10 @@ export class EntityComponentDataset {
      * @returns {boolean}
      */
     removeEntityEventListener(entity, eventName, listener, thisArg) {
+        assert.isNonNegativeInteger(entity, "entity");
+        assert.isString(eventName, "eventName");
+        assert.isFunction(listener, "listener");
+
         const evl = this.__entityEventListeners;
 
         const hash = evl[entity];

package/src/engine/ecs/transform/Transform.d.ts

@@ -32,6 +32,8 @@ export class Transform {
      */
     readonly position: Vector3;
     /**
+     * Orientation represented as a quaternion.
+     * If Euler (XYZ) angles are required - consult {@link Quaternion} for relevant method
      * @type {Quaternion}
      * @readonly
      */
@@ -155,17 +157,25 @@ export class Transform {
      * @returns {number}
      */
     hash(): number;
+    /**
+     *
+     * @param {Transform} other
+     * @returns {this}
+     */
+    multiply(other: Transform): this;
     /**
      * Multiply two transforms, result it written into this one
      * @param {Transform} a
      * @param {Transform} b
+     * @returns {this}
      */
-    multiplyTransforms(a: Transform, b: Transform): void;
+    multiplyTransforms(a: Transform, b: Transform): this;
     /**
      *
      * @param {mat4|number[]|Float32Array} matrix
+     * @returns {this}
      */
-    fromMatrix4(matrix: mat4 | number[] | Float32Array): void;
+    fromMatrix4(matrix: mat4 | number[] | Float32Array): this;
     /**
      * Write out the current transform to a supplied container
      * @param {number[]|Float32Array} result

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":"AAsBA;;;;;;;GAOG;AACH;IAwQI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAiED;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IA/WD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;OAGG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;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;IA4BD;;;;OAIG;IACH,sBAHW,SAAS,KACT,SAAS,QAMnB;IAED;;;OAGG;IACH,oBAFW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,QAgBpC;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBA7YI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH;IA0QI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAiFD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IAjYD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;;;OAKG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;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;IA4BD;;;;OAIG;IACH,gBAHW,SAAS,GACP,IAAI,CAIhB;IAED;;;;;OAKG;IACH,sBAJW,SAAS,KACT,SAAS,GACP,IAAI,CAShB;IAED;;;;OAIG;IACH,oBAHW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,GACxB,IAAI,CAkBhB;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBA/ZI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}

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

@@ -37,6 +37,8 @@ export class Transform {
     position = new Vector3(0, 0, 0);
 
     /**
+     * Orientation represented as a quaternion.
+     * If Euler (XYZ) angles are required - consult {@link Quaternion} for relevant method
      * @type {Quaternion}
      * @readonly
      */
@@ -318,20 +320,34 @@ export class Transform {
         return result;
     }
 
+    /**
+     *
+     * @param {Transform} other
+     * @returns {this}
+     */
+    multiply(other) {
+        return this.multiplyTransforms(this, other);
+    }
+
     /**
      * Multiply two transforms, result it written into this one
      * @param {Transform} a
      * @param {Transform} b
+     * @returns {this}
      */
     multiplyTransforms(a, b) {
+        assert.defined(a, 'a');
+        assert.defined(b, 'b');
+
         m4_multiply(scratch_matrix, a.matrix, b.matrix);
 
-        this.fromMatrix4(scratch_matrix);
+        return this.fromMatrix4(scratch_matrix);
     }
 
     /**
      *
      * @param {mat4|number[]|Float32Array} matrix
+     * @returns {this}
      */
     fromMatrix4(matrix) {
         assert.isArrayLike(matrix, 'matrix');
@@ -347,6 +363,8 @@ export class Transform {
 
         // restore value of the flag
         this.writeFlag(TransformFlags.AutomaticChangeDetection, ad);
+
+        return this;
     }
 
     /**

package/src/engine/ecs/transform/TransformFlags.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Flags for {@link Transform} component
+ */
 export type TransformFlags = number;
 export namespace TransformFlags {
     let MatrixNeedsUpdate: number;

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

@@ -1 +1 @@
-{"version":3,"file":"TransformFlags.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/TransformFlags.js"],"names":[],"mappings":"6BAEU,MAAM"}
+{"version":3,"file":"TransformFlags.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/TransformFlags.js"],"names":[],"mappings":";;;6BAGU,MAAM"}

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

@@ -1,4 +1,5 @@
 /**
+ * Flags for {@link Transform} component
  * @readonly
  * @enum {number}
  */