@woosh/meep-engine 2.126.66 → 2.126.68

package/README.md

@@ -13,7 +13,7 @@ To help get you started, various samples are provided under `/samples` folder. F
 
 ## Quality
 
-Meep is covered by 2,753 handwritten unit tests
+Meep is covered by 2,790 handwritten unit tests
 
 The aim is to [ensure quality](https://about.codecov.io/blog/the-case-against-100-code-coverage/). As a result, the tests are written to cover complex code first and to exhaustively validate critical algorithms.
 Most of the test code is significantly larger than the code that is being tested.

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.66",
+  "version": "2.126.68",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/geom/3d/aabb/aabb3_array_combine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aabb3_array_combine.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_array_combine.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,4CAPW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,iBACvC,MAAM,KACN,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,YACvC,MAAM,KACN,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,YACvC,MAAM,QAgDhB"}
+{"version":3,"file":"aabb3_array_combine.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_array_combine.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,4CAPW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,iBACvC,MAAM,KACN,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,YACvC,MAAM,KACN,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,YACvC,MAAM,QA8ChB"}

package/src/core/geom/3d/aabb/aabb3_array_combine.js

@@ -22,12 +22,10 @@ export function aabb3_array_combine(
     assert.isNumber(a_offset,'a_offset');
     assert.notNaN(a_offset,'a_offset');
     assert.isNonNegativeInteger(a_offset, 'a_offset');
-    assert.lessThanOrEqual(a_offset, a.length - 6, 'a_offset array overflow');
 
     assert.isNumber(b_offset,'b_offset');
     assert.notNaN(a_offset,'b_offset');
     assert.isNonNegativeInteger(b_offset, 'b_offset');
-    assert.lessThanOrEqual(b_offset, b.length - 6, 'b_offset array overflow');
 
     const ax0 = a[a_offset + 0];
     const ay0 = a[a_offset + 1];

package/src/core/geom/3d/aabb/aabb3_array_set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aabb3_array_set.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_array_set.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wCATW,UAAU,MAAM,CAAC,GAAC,YAAY,GAAC,MAAM,EAAE,iBACvC,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAiBhB"}
+{"version":3,"file":"aabb3_array_set.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_array_set.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wCATW,UAAU,MAAM,CAAC,GAAC,YAAY,GAAC,MAAM,EAAE,iBACvC,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAsBhB"}

package/src/core/geom/3d/aabb/aabb3_array_set.js

@@ -16,8 +16,13 @@ export function aabb3_array_set(
     x0, y0, z0,
     x1, y1, z1
 ) {
-
-    assert.lessThanOrEqual(result_offset, result.length - 6, 'result_offset overflow')
+    assert.isNonNegativeInteger(result_offset, 'result_offset');
+    assert.isNumber(x0, 'x0');
+    assert.isNumber(y0, 'y0');
+    assert.isNumber(z0, 'z0');
+    assert.isNumber(x1, 'x1');
+    assert.isNumber(y1, 'y1');
+    assert.isNumber(z1, 'z1');
 
     result[result_offset] = x0;
     result[result_offset + 1] = y0;

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

@@ -1,5 +1,5 @@
 /**
- * Returns lowest value out of 2 supplied
+ * Returns the lowest value out of 2 supplied
  * @param {number} a
  * @param {number} b
  * @returns {number}

package/src/core/math/min2.js

@@ -1,5 +1,5 @@
 /**
- * Returns lowest value out of 2 supplied
+ * Returns the lowest value out of 2 supplied
  * @param {number} a
  * @param {number} b
  * @returns {number}

package/src/core/math/spline/spline3_hermite_nearest_point.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spline3_hermite_nearest_point.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_nearest_point.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;GAYG;AACH,qDARW,MAAM,SACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAuFlB"}
+{"version":3,"file":"spline3_hermite_nearest_point.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_nearest_point.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;GAYG;AACH,qDARW,MAAM,SACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAyFlB"}

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

@@ -90,6 +90,8 @@ export function spline3_hermite_nearest_point(
         for (let j = NEWTON_STEPS; j > 0; j--) {
 
             const f_t = polyval(quintic_coeffs, t, 6);
+
+            // derivative of the polynomial we are finding the root of
             const fp_t = polyval(quartic_coeffs, t, 5);
 
             if (Math.abs(fp_t) < tolerance) {

package/src/core/model/DebouncedObservedBoolean.d.ts

@@ -17,7 +17,7 @@ export class DebouncedObservedBoolean extends ObservedBoolean {
     constructor(source: ObservedBoolean, time: number, mode?: DebouncedObservedBooleanMode | number);
     __source: ObservedBoolean;
     time: number;
-    __timeout: NodeJS.Timer;
+    __timeout_ms: any;
     mode: number;
     link(): void;
     unlink(): void;
@@ -26,6 +26,7 @@ export class DebouncedObservedBoolean extends ObservedBoolean {
      * @private
      */
     private __clearTimeout;
+    __timeout: NodeJS.Timer;
     /**
      *
      */

package/src/core/model/DebouncedObservedBoolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebouncedObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/DebouncedObservedBoolean.js"],"names":[],"mappings":"2CAYU,MAAM;;;;;;AAQhB;;GAEG;AACH;IACI;;;;;OAKG;IACH,oBAJW,eAAe,QACf,MAAM,SACN,4BAA4B,GAAC,MAAM,EAY7C;IAPG,0BAAsB;IAEtB,aAAgB;IAEhB,wBAAqB;IAErB,aAAgB;IAGpB,aAGC;IAED,eAGC;IAGD;;;OAGG;IACH,uBAKC;IAED;;OAEG;IACH,0BAOC;IAED;;;OAGG;IACH,OAFW,OAAO,QAYjB;IAED;;;;;OAKG;IACH,6BAYC;CAMJ;4BAhH2B,sBAAsB"}
+{"version":3,"file":"DebouncedObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/DebouncedObservedBoolean.js"],"names":[],"mappings":"2CAYU,MAAM;;;;;;AAQhB;;GAEG;AACH;IACI;;;;;OAKG;IACH,oBAJW,eAAe,QACf,MAAM,SACN,4BAA4B,GAAC,MAAM,EAY7C;IAPG,0BAAsB;IAEtB,aAAgB;IAEhB,kBAAwB;IAExB,aAAgB;IAGpB,aAGC;IAED,eAGC;IAGD;;;OAGG;IACH,uBAKC;IAFO,wBAAqB;IAI7B;;OAEG;IACH,0BAOC;IAED;;;OAGG;IACH,OAFW,OAAO,QAYjB;IAED;;;;;OAKG;IACH,6BAYC;CAMJ;4BAhH2B,sBAAsB"}

package/src/core/model/DebouncedObservedBoolean.js

@@ -35,7 +35,7 @@ export class DebouncedObservedBoolean extends ObservedBoolean {
 
         this.time = time;
 
-        this.__timeout = null;
+        this.__timeout_ms = null;
 
         this.mode = mode;
     }

package/src/core/process/worker/OnDemandWorkerManager.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Worker manager that will terminate the worker after a timeout if it is idle.
+ *
+ */
 export class OnDemandWorkerManager {
     /**
      *
@@ -16,7 +20,7 @@ export class OnDemandWorkerManager {
      * @type {number}
      * @private
      */
-    private __timeout;
+    private __timeout_ms;
     /**
      * ID of the timer set via setTimeout
      * @type {number}
@@ -28,7 +32,9 @@ export class OnDemandWorkerManager {
      */
     worker: WorkerProxy;
     /**
-     * Configure how long to wait after processing a request until deciding to shut down the worker
+     * Configure how long to wait after processing a request until deciding to shut down the worker.
+     * The browser limits the number of workers we can have open at once, so releasing them when not in use is critical.
+     *
      * @param {number} delay_ms In milliseconds
      */
     setTimeout(delay_ms: number): void;
@@ -54,7 +60,7 @@ export class OnDemandWorkerManager {
      */
     private increment;
     /**
-     * Submit request to the worker
+     * Submit a request to the worker
      * @template T
      * @param {string} name
      * @param {Array} [parameters]

package/src/core/process/worker/OnDemandWorkerManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OnDemandWorkerManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/OnDemandWorkerManager.js"],"names":[],"mappings":"AAEA;IAwBI;;;OAGG;IACH,iCAKC;IA/BD;;;;OAIG;IACH,wBAAoB;IAEpB;;;;;OAKG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,8BAA2B;IAOvB;;OAEG;IACH,oBAAoB;IAGxB;;;OAGG;IACH,qBAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAKC;IAED;;OAEG;IACH,mCASC;IAED;;;OAGG;IACH,6BAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAMC;IAED;;OAEG;IACH,kBAiBC;IAGD;;;;;;OAMG;IACH,iBAJW,MAAM,kCAahB;CACJ"}
+{"version":3,"file":"OnDemandWorkerManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/OnDemandWorkerManager.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAwBI;;;OAGG;IACH,iCAOC;IAjCD;;;;OAIG;IACH,wBAAoB;IAEpB;;;;;OAKG;IACH,qBAAoB;IAEpB;;;;OAIG;IACH,8BAA2B;IASvB;;OAEG;IACH,oBAAoB;IAGxB;;;;;OAKG;IACH,qBAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAKC;IAED;;OAEG;IACH,mCASC;IAED;;;OAGG;IACH,6BAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAMC;IAED;;OAEG;IACH,kBAeC;IAGD;;;;;;OAMG;IACH,iBAJW,MAAM,kCAahB;CACJ"}

package/src/core/process/worker/OnDemandWorkerManager.js

@@ -1,5 +1,9 @@
 import { assert } from "../../assert.js";
 
+/**
+ * Worker manager that will terminate the worker after a timeout if it is idle.
+ *
+ */
 export class OnDemandWorkerManager {
 
     /**
@@ -15,7 +19,7 @@ export class OnDemandWorkerManager {
      * @type {number}
      * @private
      */
-    __timeout = 1000;
+    __timeout_ms = 1000;
 
     /**
      * ID of the timer set via setTimeout
@@ -29,6 +33,8 @@ export class OnDemandWorkerManager {
      * @param {WorkerProxy} worker
      */
     constructor(worker) {
+        assert.defined(worker, 'worker');
+
         /**
          * @type {WorkerProxy}
          */
@@ -36,13 +42,15 @@ export class OnDemandWorkerManager {
     }
 
     /**
-     * Configure how long to wait after processing a request until deciding to shut down the worker
+     * Configure how long to wait after processing a request until deciding to shut down the worker.
+     * The browser limits the number of workers we can have open at once, so releasing them when not in use is critical.
+     *
      * @param {number} delay_ms In milliseconds
      */
     setTimeout(delay_ms) {
-        assert.isNonNegativeInteger(delay_ms, 'v');
+        assert.isNonNegativeInteger(delay_ms, 'delay_ms');
 
-        this.__timeout = delay_ms;
+        this.__timeout_ms = delay_ms;
     }
 
     /**
@@ -60,13 +68,13 @@ export class OnDemandWorkerManager {
      */
     cancelScheduledTermination() {
 
-        if (this.__pending_termination >= 0) {
-
-            clearInterval(this.__pending_termination);
-
-            this.__pending_termination = -1;
-
+        if (this.__pending_termination < 0) {
+            // no pending termination
+            return;
         }
+
+        clearInterval(this.__pending_termination);
+        this.__pending_termination = -1;
     }
 
     /**
@@ -86,7 +94,7 @@ export class OnDemandWorkerManager {
         this.__request_count--;
 
         if (this.__request_count <= 0 && this.worker.isRunning()) {
-            this.scheduleTermination(this.__timeout);
+            this.scheduleTermination(this.__timeout_ms);
         }
     }
 
@@ -102,19 +110,17 @@ export class OnDemandWorkerManager {
 
             this.worker.start();
 
-        } else if (this.__pending_termination >= 0) {
-
-            // worker is up, but we're in the termination timeout period, lets clear that
+        } else {
 
-            clearInterval(this.__pending_termination);
-            this.__pending_termination = -1;
+            // worker is up, ensure we're not waiting for it to terminate
+            this.cancelScheduledTermination();
 
         }
     }
 
 
     /**
-     * Submit request to the worker
+     * Submit a request to the worker
      * @template T
      * @param {string} name
      * @param {Array} [parameters]

package/src/core/process/worker/WorkerProxy.d.ts

@@ -8,7 +8,7 @@ declare class WorkerProxy {
     constructor(url: string, methods: any);
     /**
      *
-     * @type {{}}
+     * @type {Object<Array<{id:number, parameters:[], resolve: function, reject:function}>>}
      * @private
      */
     private __pending;
@@ -60,6 +60,10 @@ declare class WorkerProxy {
      */
     private __handleMessage;
     isRunning(): boolean;
+    /**
+     * Stop the worker.
+     * If the worker is not running, this method does nothing.
+     */
     stop(): void;
     /**
      *
@@ -69,6 +73,13 @@ declare class WorkerProxy {
      */
     cancelRequest(id: number, method_name: string): boolean;
     sendPendingRequests(): void;
+    /**
+     * Start the worker.
+     * Any requests made while the worker is not running will be queued and sent once the worker is started.
+     *
+     * If the worker is already running, this method does nothing.
+     *
+     */
     start(): void;
 }
 //# sourceMappingURL=WorkerProxy.d.ts.map

package/src/core/process/worker/WorkerProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerProxy.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/WorkerProxy.js"],"names":[],"mappings":";AAqCA;IAiCI;;;;OAIG;IACH,iBAHW,MAAM,gBAQhB;IAzCD;;;;OAIG;IACH,kBAAe;IAEf,qBAAoB;IAEpB;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,qBAAiB;IAEjB;;;;;OAKG;IACH,eAAiB;IAQb,YAAc;IACd,aAAsB;IAK1B;;;;;;OAMG;IACH,wBAJW,MAAM,2BAmDhB;IAED;;;;OAIG;IACH,qBAeC;IAED;;;OAGG;IACH,sBAQC;IAED;;;;OAIG;IACH,wBAqCC;IAED,qBAEC;IAED,aAOC;IAED;;;;;OAKG;IACH,kBAJW,MAAM,eACN,MAAM,GACJ,OAAO,CAkCnB;IAED,4BAmBC;IAED,cAmBC;CACJ"}
+{"version":3,"file":"WorkerProxy.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/WorkerProxy.js"],"names":[],"mappings":";AAsCA;IAiCI;;;;OAIG;IACH,iBAHW,MAAM,gBAQhB;IAzCD;;;;OAIG;IACH,kBAAe;IAEf,qBAAoB;IAEpB;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,qBAAiB;IAEjB;;;;;OAKG;IACH,eAAiB;IAQb,YAAc;IACd,aAAsB;IAK1B;;;;;;OAMG;IACH,wBAJW,MAAM,2BAkDhB;IAED;;;;OAIG;IACH,qBAgBC;IAED;;;OAGG;IACH,sBAQC;IAED;;;;OAIG;IACH,wBAqCC;IAED,qBAEC;IAED;;;OAGG;IACH,aAOC;IAED;;;;;OAKG;IACH,kBAJW,MAAM,eACN,MAAM,GACJ,OAAO,CAkCnB;IAED,4BAmBC;IAED;;;;;;OAMG;IACH,cAoBC;CACJ"}

package/src/core/process/worker/WorkerProxy.js

@@ -1,4 +1,5 @@
 import { assert } from "../../assert.js";
+import { array_remove_first } from "../../collection/array/array_remove_first.js";
 
 /**
  *
@@ -39,7 +40,7 @@ class WorkerProxy {
 
     /**
      *
-     * @type {{}}
+     * @type {Object<Array<{id:number, parameters:[], resolve: function, reject:function}>>}
      * @private
      */
     __pending = {};
@@ -127,10 +128,9 @@ class WorkerProxy {
                 };
 
                 if (!trySendMessage(this.__worker, message)) {
-                    //failed to send message
-                    //drop pending request
-                    const i = pending.indexOf(request);
-                    pending.splice(i, 1);
+                    // failed to send the message
+                    // drop the pending request
+                    array_remove_first(pending, request);
                 }
             }
         });
@@ -148,12 +148,13 @@ class WorkerProxy {
             throw new Error(`Method '${name}' already defined`);
         }
 
+        // initialize the pending request queue for this method
         this.__pending[name] = [];
 
         const proxy = this;
 
-        this[name] = function () {
-            return proxy.$submitRequest(name, arguments);
+        this[name] = function (...args) {
+            return proxy.$submitRequest(name, args);
         };
 
     }
@@ -220,6 +221,10 @@ class WorkerProxy {
         return this.__isRunning;
     }
 
+    /**
+     * Stop the worker.
+     * If the worker is not running, this method does nothing.
+     */
     stop() {
         if (!this.__isRunning) {
             //not running
@@ -254,14 +259,14 @@ class WorkerProxy {
 
 
                 if (!this.__isRunning) {
-                    //not running, simply cut from the queue
+                    // not running, simply cut from the queue
 
                     requestQueue.splice(i, 1);
 
                     return true;
                 } else {
-                    //worker is running, send termination request for this ID
-                    throw new Error('Ability to cancel pending requests while worker is running is not implemented yet');
+                    // worker is running, send a termination request for this ID
+                    throw new Error('Ability to cancel pending requests while worker is running is not implemented');
                 }
 
             }
@@ -290,6 +295,13 @@ class WorkerProxy {
         }
     }
 
+    /**
+     * Start the worker.
+     * Any requests made while the worker is not running will be queued and sent once the worker is started.
+     *
+     * If the worker is already running, this method does nothing.
+     *
+     */
     start() {
         if (this.__isRunning) {
             //already running
@@ -299,6 +311,7 @@ class WorkerProxy {
         this.__worker = new Worker(this.url,{
             name: this.__name
         });
+
         this.__worker.onmessage = this.__handleMessage;
 
         // TODO attach proper error handler

package/src/engine/asset/AssetManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAgII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IA7ID;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IAyB5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFAsCC;IAED;;;;;OAKG;IACH,aAJW,MAAM,QACN,MAAM,sBAehB;IA2QD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;OAIG;IACH,+BAHW,MAAM,4CAqBhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,+CAyBhB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;OAMG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;;OAKG;IACH,eAJW,MAAM,QACN,MAAM,GACJ,OAAO,CAMnB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BA/2B2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}
+{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAgII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IA7ID;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IAyB5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFAsCC;IAED;;;;;OAKG;IACH,aAJW,MAAM,QACN,MAAM,sBAmBhB;IA2QD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;OAIG;IACH,+BAHW,MAAM,4CAqBhB;IAED;;;;OAIG;IACH,iCAHW,MAAM,+CAyBhB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;OAMG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;;OAKG;IACH,eAJW,MAAM,QACN,MAAM,GACJ,OAAO,CAMnB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BAn3B2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}

package/src/engine/asset/AssetManager.js

@@ -323,6 +323,10 @@ export class AssetManager {
      * @param {Asset} asset
      */
     insert(path, type, asset) {
+        assert.isString(path, 'path');
+        assert.isString(type, 'type');
+        assert.isObject(asset, 'asset');
+
         const assetDescription = new AssetDescription(path, type);
 
         const existing_resource = this.assets.get(assetDescription);

package/src/engine/asset/loaders/image/ImageRGBADataLoader.d.ts

@@ -4,7 +4,17 @@ export class ImageRGBADataLoader extends AssetLoader<any, any> {
      * @param {string} [worker_path] Path to decoder worker, allows flexibility in deployment
      */
     constructor({ worker_path }?: string);
-    decoder: CodecWithFallback;
+    /**
+     *
+     * @type {CodecWithFallback<{data, width:number, height:number, itemSize:number, bitDepth:number}>}
+     */
+    decoder: CodecWithFallback<{
+        data;
+        width: number;
+        height: number;
+        itemSize: number;
+        bitDepth: number;
+    }>;
     link(assetManager: any, engine: any): Promise<void>;
     /**
      *

package/src/engine/asset/loaders/image/ImageRGBADataLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageRGBADataLoader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/image/ImageRGBADataLoader.js"],"names":[],"mappings":"AAYA;IACI;;;OAGG;IACH,8BAFW,MAAM,EAWhB;IAJG,2BAGC;IAGL,oDAOC;IAED;;;;;;OAMG;IACH,4BASC;IAED;;;;;;OAMG;IACH,mBAoBC;IAED,6EAiCC;CACJ;4BAlH2B,mBAAmB;kCACb,8BAA8B"}
+{"version":3,"file":"ImageRGBADataLoader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/image/ImageRGBADataLoader.js"],"names":[],"mappings":"AAYA;IACI;;;OAGG;IACH,8BAFW,MAAM,EAehB;IARG;;;OAGG;IACH,SAFU,kBAAkB;QAAC,IAAI,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,QAAQ,EAAC,MAAM,CAAC;QAAC,QAAQ,EAAC,MAAM,CAAA;KAAC,CAAC,CAKjG;IAGL,oDAOC;IAED;;;;;;OAMG;IACH,4BASC;IAED;;;;;;OAMG;IACH,mBAoBC;IAED,6EAiCC;CACJ;4BAtH2B,mBAAmB;kCACb,8BAA8B"}

package/src/engine/asset/loaders/image/ImageRGBADataLoader.js

@@ -20,6 +20,10 @@ export class ImageRGBADataLoader extends AssetLoader {
                 } = {}) {
         super();
 
+        /**
+         *
+         * @type {CodecWithFallback<{data, width:number, height:number, itemSize:number, bitDepth:number}>}
+         */
         this.decoder = new CodecWithFallback(
             new ThreadedImageDecoder({ worker_path }),
             new NativeImageDecoder()

package/src/engine/asset/loaders/image/codec/Codec.d.ts

@@ -1,14 +1,15 @@
-export class Codec {
+/**
+ * This is an abstract class, must be implemented by subclasses
+ *
+ * @template T
+ */
+export class Codec<T> {
     /**
      *
      * @param {Uint8Array} data
-     * @returns {Promise<{data:Uint8Array, width:number, height:number}>}
+     * @returns {Promise<T>}
      */
-    decode(data: Uint8Array): Promise<{
-        data: Uint8Array;
-        width: number;
-        height: number;
-    }>;
+    decode(data: Uint8Array): Promise<T>;
     /**
      * Whether codec is able to decode this data, typically checks headers in the data
      * @param {Uint8Array} data

package/src/engine/asset/loaders/image/codec/Codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Codec.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/Codec.js"],"names":[],"mappings":"AAAA;IACI;;;;OAIG;IACH,aAHW,UAAU,GACR,QAAQ;QAAC,IAAI,EAAC,UAAU,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,MAAM,EAAC,MAAM,CAAA;KAAC,CAAC,CAInE;IAED;;;;OAIG;IACH,WAHW,UAAU,GACT,QAAQ,OAAO,CAAC,CAI3B;CACJ"}
+{"version":3,"file":"Codec.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/Codec.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,aAHW,UAAU,GACR,QAAQ,CAAC,CAAC,CAKtB;IAED;;;;OAIG;IACH,WAHW,UAAU,GACT,QAAQ,OAAO,CAAC,CAI3B;CACJ"}

package/src/engine/asset/loaders/image/codec/Codec.js

@@ -1,10 +1,16 @@
+/**
+ * This is an abstract class, must be implemented by subclasses
+ *
+ * @template T
+ */
 export class Codec {
     /**
      *
      * @param {Uint8Array} data
-     * @returns {Promise<{data:Uint8Array, width:number, height:number}>}
+     * @returns {Promise<T>}
      */
     async decode(data) {
+        // need to implement in the subclass
         throw  new Error('Unsupported Operation');
     }
 

package/src/engine/asset/loaders/image/codec/CodecWithFallback.d.ts

@@ -1,12 +1,23 @@
-export class CodecWithFallback extends Codec {
+/**
+ * Codec that tries to decode data with multiple codecs in order.
+ *
+ * @template T
+ * @extends {Codec<T>}
+ */
+export class CodecWithFallback<T> extends Codec<T> {
     /**
      *
-     * @param {Codec} codecs
+     * @param {Codec<T>} codecs
      */
-    constructor(...codecs: Codec);
-    children: any;
+    constructor(...codecs: Codec<T>);
+    /**
+     *
+     * @type {Codec<T>[]}
+     */
+    children: Codec<T>[];
     test(data: any): Promise<boolean>;
-    decode(data: any): Promise<any>;
+    decode(data: any): Promise<T>;
+    #private;
 }
 import { Codec } from "./Codec.js";
 //# sourceMappingURL=CodecWithFallback.d.ts.map

package/src/engine/asset/loaders/image/codec/CodecWithFallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodecWithFallback.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/CodecWithFallback.js"],"names":[],"mappings":"AAEA;IACI;;;OAGG;IACH,uBAFW,KAAK,EAUf;IALG,cAA8B;IAOlC,kCAeC;IAED,gCAqCC;CACJ;sBAxEqB,YAAY"}
+{"version":3,"file":"CodecWithFallback.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/CodecWithFallback.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IAOI;;;OAGG;IACH,uBAFW,MAAM,CAAC,CAAC,EAclB;IAtBD;;;OAGG;IACH,UAFU,MAAM,CAAC,CAAC,EAAE,CAEP;IAgCb,kCAeC;IAED,8BAuCC;;CACJ;sBAtGqB,YAAY"}

package/src/engine/asset/loaders/image/codec/CodecWithFallback.js

@@ -1,20 +1,50 @@
+import { assert } from "../../../../../core/assert.js";
+import { array_push_if_unique } from "../../../../../core/collection/array/array_push_if_unique.js";
 import { Codec } from "./Codec.js";
 
+/**
+ * Codec that tries to decode data with multiple codecs in order.
+ *
+ * @template T
+ * @extends {Codec<T>}
+ */
 export class CodecWithFallback extends Codec {
     /**
      *
-     * @param {Codec} codecs
+     * @type {Codec<T>[]}
+     */
+    children = []
+
+    /**
+     *
+     * @param {Codec<T>} codecs
      */
     constructor(...codecs) {
         super();
 
-        this.children = codecs.slice();
+        assert.isArray(codecs, 'codecs');
+
+        for (const codec of codecs) {
+            this.#add(codec);
+        }
 
         if (this.children.length < 1) {
             throw new Error('At least one codec must be provided');
         }
     }
 
+    /**
+     *
+     * @param {Codec<T>} codec
+     */
+    #add(codec) {
+        assert.defined(codec, 'codec');
+        assert.isObject(codec, 'codec');
+        assert.isInstanceOf(codec, Codec, 'codec', 'Codec');
+
+        return array_push_if_unique(this.children, codec);
+    }
+
     async test(data) {
         const codecs = this.children;
         const codec_count = codecs.length;
@@ -47,9 +77,11 @@ export class CodecWithFallback extends Codec {
             const codec_supports_data = await codec.test(data);
 
             if (!codec_supports_data) {
+
                 errors.push({
                     index: i, error: "Codec doesn't support this data"
                 });
+
                 continue;
             }
 

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.d.ts

@@ -1,4 +1,8 @@
-export class NativeImageDecoder extends Codec {
+/**
+ * Uses the browser's native image decoder
+ */
+export class NativeImageDecoder extends Codec<any> {
+    constructor();
     decode(data: any): Promise<{
         data: Uint8Array;
         width: number;

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/NativeImageDecoder.js"],"names":[],"mappings":"AA0BA;IACI;;;;;;OA2BC;CACJ;sBAvDqB,YAAY"}
+{"version":3,"file":"NativeImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/NativeImageDecoder.js"],"names":[],"mappings":"AA0BA;;GAEG;AACH;;IACI;;;;;;OA2BC;CACJ;sBA1DqB,YAAY"}

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.js

@@ -6,24 +6,27 @@ import { Codec } from "./Codec.js";
  * @returns {Uint8Array}
  */
 function decode(img) {
-    const imgWidth = img.width;
-    const imgHeight = img.height;
+    const width = img.width;
+    const height = img.height;
 
     //
     const canvas = document.createElement('canvas');
 
-    canvas.width = imgWidth;
-    canvas.height = imgHeight;
+    canvas.width = width;
+    canvas.height = height;
 
     const context = canvas.getContext('2d');
 
-    context.drawImage(img, 0, 0, imgWidth, imgHeight);
+    context.drawImage(img, 0, 0, width, height);
 
-    const imgd = context.getImageData(0, 0, imgWidth, imgHeight);
+    const image_data = context.getImageData(0, 0, width, height);
 
-    return imgd.data;
+    return image_data.data;
 }
 
+/**
+ * Uses the browser's native image decoder
+ */
 export class NativeImageDecoder extends Codec {
     async decode(data) {
         const image = new Image();
@@ -34,7 +37,7 @@ export class NativeImageDecoder extends Codec {
 
         image.src = url;
 
-        // give browser a chance to decode image in async
+        // give the browser a chance to decode image in async
         await image.decode();
 
         const rgba_data = decode(image);

package/src/engine/asset/loaders/image/codec/ThreadedImageDecoder.d.ts

@@ -1,4 +1,4 @@
-export class ThreadedImageDecoder extends Codec {
+export class ThreadedImageDecoder extends Codec<any> {
     /**
      *
      * @param {string} [worker_path]

package/src/engine/asset/loaders/image/codec/ThreadedImageDecoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadedImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/ThreadedImageDecoder.js"],"names":[],"mappings":"AAKA;IACI;;;OAGG;IACH,8BAFW,MAAM,EAuBhB;IAPG;;;OAGG;IACH,QAFU,qBAAqB,CAE+B;IAKlE,kCASC;IAED,gCAEC;CACJ;sBA5CqB,YAAY;sCAHI,6DAA6D"}
+{"version":3,"file":"ThreadedImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/ThreadedImageDecoder.js"],"names":[],"mappings":"AAMA;IACI;;;OAGG;IACH,8BAFW,MAAM,EAwBhB;IARG;;;OAGG;IACH,QAFU,qBAAqB,CAE+B;IAMlE,kCAaC;IAED,gCAEC;CACJ;sBAjDqB,YAAY;sCAHI,6DAA6D"}

package/src/engine/asset/loaders/image/codec/ThreadedImageDecoder.js

@@ -1,3 +1,4 @@
+import { assert } from "../../../../../core/assert.js";
 import { OnDemandWorkerManager } from "../../../../../core/process/worker/OnDemandWorkerManager.js";
 import WorkerBuilder from "../../../../../core/process/worker/WorkerBuilder.js";
 import { PNG_HEADER_BYTES } from "../png/PNG_HEADER_BYTES.js";
@@ -10,7 +11,7 @@ export class ThreadedImageDecoder extends Codec {
      */
     constructor({
                     worker_path = 'bundle-worker-image-decoder.js'
-                }={}) {
+                } = {}) {
 
         super();
 
@@ -28,13 +29,18 @@ export class ThreadedImageDecoder extends Codec {
          */
         this.worker = new OnDemandWorkerManager(workerBuilder.build());
 
+        // shut down worker if it's not used for a while
         this.worker.setTimeout(1200);
     }
 
     async test(data) {
+        assert.defined(data, 'data');
+        assert.notNull(data, 'data');
+        assert.isInstanceOf(data, Uint8Array, 'data', 'Uint8Array');
 
         for (let i = 0; i < PNG_HEADER_BYTES.length; i++) {
             if (data[i] !== PNG_HEADER_BYTES[i]) {
+                // only supports PNG
                 return false;
             }
         }

package/src/engine/graphics/geometry/skining/meshFromSkinnedMesh.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Rebuild skinned mesh as a regular mesh applying skinning in the process
+ * @param {SkinnedMesh} skinned
+ * @returns {Mesh}
+ */
+export function meshFromSkinnedMesh(skinned: SkinnedMesh): Mesh;
+import { Mesh } from "three";
+//# sourceMappingURL=meshFromSkinnedMesh.d.ts.map

package/src/engine/graphics/geometry/skining/meshFromSkinnedMesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshFromSkinnedMesh.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/skining/meshFromSkinnedMesh.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,2DAFa,IAAI,CAgChB;qBAtCoB,OAAO"}

package/src/engine/graphics/geometry/skining/meshFromSkinnedMesh.js

@@ -0,0 +1,39 @@
+import { Mesh } from "three";
+import { computeSkinnedMeshVertices } from "./computeSkinnedMeshVertices.js";
+
+/**
+ * Rebuild skinned mesh as a regular mesh applying skinning in the process
+ * @param {SkinnedMesh} skinned
+ * @returns {Mesh}
+ */
+export function meshFromSkinnedMesh(skinned) {
+
+    const geometry = skinned.geometry;
+
+    const bakedGeometry = geometry.clone();
+
+    delete bakedGeometry.attributes.skinIndex;
+    delete bakedGeometry.attributes.skinWeight;
+
+    const positionAttribute = bakedGeometry.getAttribute("position");
+    const vertices = positionAttribute.array;
+
+    computeSkinnedMeshVertices(vertices, skinned);
+
+    const mesh = new Mesh(bakedGeometry, skinned.material);
+
+    mesh.position.copy(skinned.position);
+    mesh.rotation.copy(skinned.rotation);
+    mesh.scale.copy(skinned.scale);
+
+    //apply transform to each vertex
+    skinned.updateMatrix();
+    skinned.updateMatrixWorld(true);
+
+    const m4 = skinned.matrixWorld.clone();
+    m4.invert();
+
+    positionAttribute.applyMatrix4(m4);
+
+    return mesh;
+}

package/src/engine/logging/elastic/ElasticSearchLogger.d.ts

@@ -38,7 +38,7 @@ export class ElasticSearchLogger extends LoggerBackend {
      * @type {number}
      * @private
      */
-    private __timeout;
+    private __timeout_ms;
     /**
      *
      * @type {any}
@@ -46,6 +46,7 @@ export class ElasticSearchLogger extends LoggerBackend {
      */
     private __bound_flush;
     flush(): void;
+    __timeout: number | NodeJS.Timer;
     __prod(): void;
     log(level: any, message: any): void;
 }

package/src/engine/logging/elastic/ElasticSearchLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElasticSearchLogger.d.ts","sourceRoot":"","sources":["../../../../../src/engine/logging/elastic/ElasticSearchLogger.js"],"names":[],"mappings":"AAmCA;IACI;;;OAqDC;IA/CG;;;;OAIG;IACH,iBAA2B;IAE3B;;;;OAIG;IACH,qBAAuB;IACvB;;;;OAIG;IACH,wBAA2B;IAE3B;;;;OAIG;IACH,cAAgB;IAEhB;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,kBAAmB;IAEnB;;;;OAIG;IACH,sBAA0C;IAG9C,cAuCC;IAED,eAOC;IAED,oCAUC;CACJ;8BAxJ6B,qBAAqB"}
+{"version":3,"file":"ElasticSearchLogger.d.ts","sourceRoot":"","sources":["../../../../../src/engine/logging/elastic/ElasticSearchLogger.js"],"names":[],"mappings":"AAmCA;IACI;;;OAqDC;IA/CG;;;;OAIG;IACH,iBAA2B;IAE3B;;;;OAIG;IACH,qBAAuB;IACvB;;;;OAIG;IACH,wBAA2B;IAE3B;;;;OAIG;IACH,cAAgB;IAEhB;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,qBAAsB;IAEtB;;;;OAIG;IACH,sBAA0C;IAG9C,cAuCC;IAlCO,iCAAmB;IAoC3B,eAOC;IAED,oCAUC;CACJ;8BAvJ6B,qBAAqB"}

package/src/engine/logging/elastic/ElasticSearchLogger.js

@@ -1,5 +1,5 @@
-import { LoggerBackend } from "../LoggerBackend.js";
 import { Deque } from "../../../core/collection/queue/Deque.js";
+import { LoggerBackend } from "../LoggerBackend.js";
 
 /**
  Transformer function to transform log data as provided by winston into
@@ -79,7 +79,7 @@ export class ElasticSearchLogger extends LoggerBackend {
          * @type {number}
          * @private
          */
-        this.__timeout = -1;
+        this.__timeout_ms = -1;
 
         /**
          *