@woosh/meep-engine 2.123.4 → 2.123.6

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.123.4",
+  "version": "2.123.6",
   "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/guid/UUID.d.ts

@@ -38,11 +38,12 @@ export class UUID {
     get data(): Uint8Array;
     /**
      * Generate Variant 1 UUID
-     *
+     * @returns {void}
      */
     v1(): void;
     /**
      * Generate Variant 4 UUID (fully random)
+     * @returns {void}
      */
     v4(): void;
     /***

package/src/engine/ecs/guid/UUID.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.js"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH;IAiHI;;;OAGG;IACH,aAFY,IAAI,CAQf;IAED;;;OAGG;IACH,aAFa,IAAI,CAQhB;IAED;;;;OAIG;IACH,iBAFY,MAAM,CAIjB;IAyCD;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,CAQf;IAjMD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,UAAU,GAAC,SAAS,CAAC,MAAM,CAAC,EAO/C;IAED;;;OAGG;IACH,YAFa,UAAU,CAItB;IAED;;;OAGG;IACH,WAsEC;IAED;;OAEG;IACH,WAUC;IAmCD;;;OAGG;IACH,cAFW,MAAM,QAmChB;IAeD;;;;;;OAMG;IACH,YAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,YAFW,IAAI,QAId;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAcnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAYlB;IAIL;;OAEG;IACH,uBA7EiB,MAAM,CA6EF;IAErB;;OAEG;IACH,4BAzIe,MAAM,UAyIE;IAQvB;;;OAGG;IACH,iBAFU,OAAO,CAEI;;CAtBpB;;kBAcS,MAAM"}
+{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.js"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH;IAkGI;;;OAGG;IACH,aAFY,IAAI,CAQf;IA2BD;;;OAGG;IACH,aAFa,IAAI,CAQhB;IAED;;;;OAIG;IACH,iBAFY,MAAM,CAIjB;IA6CD;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,CAQf;IA/MD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,UAAU,GAAC,SAAS,CAAC,MAAM,CAAC,EAO/C;IAED;;;OAGG;IACH,YAFa,UAAU,CAItB;IAED;;;OAGG;IACH,MAFa,IAAI,CAwEhB;IAcD;;;OAGG;IACH,MAFa,IAAI,CAqBhB;IAuBD;;;OAGG;IACH,cAFW,MAAM,QAuChB;IAeD;;;;;;OAMG;IACH,YAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,YAFW,IAAI,QAId;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAcnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAYlB;IAIL;;OAEG;IACH,uBA7EiB,MAAM,CA6EF;IAErB;;OAEG;IACH,4BA7Ie,MAAM,UA6IE;IAQvB;;;OAGG;IACH,iBAFU,OAAO,CAEI;;CAtBpB;;kBAcS,MAAM"}

package/src/engine/ecs/guid/UUID.js

@@ -52,7 +52,7 @@ export class UUID {
 
     /**
      * Generate Variant 1 UUID
-     *
+     * @returns {void}
      */
     v1() {
         // @see https://github.com/uuidjs/uuid/blob/8f028c4ea42ce41a9a9dc5fa634abe525b2e2066/src/v1.js#L17
@@ -126,31 +126,41 @@ export class UUID {
         }
     }
 
+    /**
+     *
+     * @return {UUID}
+     */
+    static v1() {
+        const uuid = new UUID();
+
+        uuid.v1();
+
+        return uuid;
+    }
+
     /**
      * Generate Variant 4 UUID (fully random)
+     * @returns {void}
      */
     v4() {
 
         const data = this.data;
 
-        randomBytes(data, 0, random, 16);
+        for (let i = 0; i < 16; i+=4) {
 
-        // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
-        data[6] = (data[6] & 0x0f) | 0x40;
-        data[8] = (data[8] & 0x3f) | 0x80;
+            const r = ( random() * 4294967296 ) >>> 0;
 
-    }
+            data[i] = r & 0xff;
+            data[i + 1] = (r >>> 8) & 0xff;
+            data[i + 2] = (r >>> 16) & 0xff;
+            data[i + 3] = (r >>> 24) & 0xff;
 
-    /**
-     *
-     * @return {UUID}
-     */
-    static v1() {
-        const uuid = new UUID();
+        }
 
-        uuid.v1();
+        // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
+        data[6] = (data[6] & 0x0f) | 0x40;
+        data[8] = (data[8] & 0x3f) | 0x80;
 
-        return uuid;
     }
 
     /**
@@ -182,35 +192,39 @@ export class UUID {
         assert.isString(string, 'string');
         assert.greaterThanOrEqual(string.length, 36, 'string.length');
 
-        let v;
         const arr = this.#data;
 
         // Parse ########-....-....-....-............
-        arr[0] = (v = hex2dec(string.slice(0, 8))) >>> 24;
-        arr[1] = (v >>> 16) & 0xff;
-        arr[2] = (v >>> 8) & 0xff;
-        arr[3] = v & 0xff;
+        const v0 = hex2dec(string.slice(0, 8));
+        arr[0] = (v0) >>> 24;
+        arr[1] = (v0 >>> 16) & 0xff;
+        arr[2] = (v0 >>> 8) & 0xff;
+        arr[3] = v0 & 0xff;
 
         // Parse ........-####-....-....-............
-        arr[4] = (v = hex2dec(string.slice(9, 13))) >>> 8;
-        arr[5] = v & 0xff;
+        const v1 = hex2dec(string.slice(9, 13));
+        arr[4] = (v1) >>> 8;
+        arr[5] = v1 & 0xff;
 
         // Parse ........-....-####-....-............
-        arr[6] = (v = hex2dec(string.slice(14, 18))) >>> 8;
-        arr[7] = v & 0xff;
+        const v2 = hex2dec(string.slice(14, 18));
+        arr[6] = (v2) >>> 8;
+        arr[7] = v2 & 0xff;
 
         // Parse ........-....-....-####-............
-        arr[8] = (v = hex2dec(string.slice(19, 23))) >>> 8;
-        arr[9] = v & 0xff;
+        const v3 = hex2dec(string.slice(19, 23));
+        arr[8] = (v3) >>> 8;
+        arr[9] = v3 & 0xff;
 
         // Parse ........-....-....-....-############
         // (Use "/" to avoid 32-bit truncation when bit-shifting high-order bytes)
-        arr[10] = ((v = hex2dec(string.slice(24, 36))) / 0x10000000000) & 0xff;
-        arr[11] = (v / 0x100000000) & 0xff;
-        arr[12] = (v >>> 24) & 0xff;
-        arr[13] = (v >>> 16) & 0xff;
-        arr[14] = (v >>> 8) & 0xff;
-        arr[15] = v & 0xff;
+        const v4 = hex2dec(string.slice(24, 36));
+        arr[10] = (v4 / 0x10000000000) & 0xff;
+        arr[11] = (v4 / 0x100000000) & 0xff;
+        arr[12] = (v4 >>> 24) & 0xff;
+        arr[13] = (v4 >>> 16) & 0xff;
+        arr[14] = (v4 >>> 8) & 0xff;
+        arr[15] = v4 & 0xff;
     }
 
     /**

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}
  */