@woosh/meep-engine 2.120.1 → 2.120.2

package/package.json

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

package/src/core/geom/2d/circle/Circle.d.ts

@@ -1,11 +1,13 @@
 export default Circle;
+/**
+ * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
+ */
 declare class Circle {
     /**
-     * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
-     * @param {Number} [x=0]
-     * @param {Number} [y=0]
-     * @param {Number} [r=0] radius
-     * @constructor
+     *
+     * @param {number} [x=0]
+     * @param {number} [y=0]
+     * @param {number} [r=0] radius
      */
     constructor(x?: number, y?: number, r?: number);
     /**

package/src/core/geom/2d/circle/Circle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/circle/Circle.js"],"names":[],"mappings":";AAEA;IACI;;;;;;OAMG;IACH,gDAkBC;IAjBG;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAGd;;;OAGG;IACH,qBAFW,OAAO,QAIjB;IAED;;;;OAIG;IACH,2CAGC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAYnB;IAED;;;;OAIG;IACH,cAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;OAKG;IACH,OAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAIlB;CACJ"}
+{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/circle/Circle.js"],"names":[],"mappings":";AAEA;;GAEG;AACH;IACI;;;;;OAKG;IACH,gBAJW,MAAM,MACN,MAAM,MACN,MAAM,EAoBhB;IAjBG;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAEV;;;OAGG;IACH,UAAU;IAGd;;;OAGG;IACH,qBAFW,OAAO,QAIjB;IAED;;;;OAIG;IACH,2CAGC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAYnB;IAED;;;;OAIG;IACH,cAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;OAKG;IACH,OAJW,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,YAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAIlB;CACJ"}

package/src/core/geom/2d/circle/Circle.js

@@ -1,12 +1,14 @@
 import { circle_intersects_circle } from "./circle_intersects_circle.js";
 
+/**
+ * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
+ */
 class Circle {
     /**
-     * A circle or a 2-dimensional sphere. Represented as a position (x,y) and radius (r)
-     * @param {Number} [x=0]
-     * @param {Number} [y=0]
-     * @param {Number} [r=0] radius
-     * @constructor
+     *
+     * @param {number} [x=0]
+     * @param {number} [y=0]
+     * @param {number} [r=0] radius
      */
     constructor(x = 0, y = 0, r = 0) {
         /**

package/src/core/geom/2d/circle/circle_area.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A=πr2
+ * @param {number} radius
+ * @returns {number}
+ */
+export function circle_area(radius: number): number;
+//# sourceMappingURL=circle_area.d.ts.map

package/src/core/geom/2d/circle/circle_area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle_area.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/circle/circle_area.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAIlB"}

package/src/core/geom/2d/circle/circle_area.js

@@ -0,0 +1,8 @@
+/**
+ * A=πr2
+ * @param {number} radius
+ * @returns {number}
+ */
+export function circle_area(radius){
+    return Math.PI * radius * radius;
+}

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

@@ -19,6 +19,10 @@ const scratch_v3_c = new Vector3();
 const sin = Math.sin;
 const cos = Math.cos;
 
+/**
+ * Rotation representation in 3d space
+ * @see https://en.wikipedia.org/wiki/Quaternion
+ */
 class Quaternion {
     /**
      *
@@ -268,6 +272,8 @@ class Quaternion {
      * @param {number} angle
      */
     fromAxisAngle(axis, angle) {
+        assert.defined(axis,'axis');
+
         this._fromAxisAngle(axis.x, axis.y, axis.z, angle);
     }
 
@@ -384,6 +390,10 @@ class Quaternion {
         return rad;
     }
 
+    /**
+     *
+     * @returns {this}
+     */
     normalize() {
         let l = this.length();
 
@@ -395,12 +405,14 @@ class Quaternion {
             const m = 1 / l;
             this.multiplyScalar(m);
         }
+
+        return this;
     }
 
     /**
      *
      * @param {number} val
-     * @return {Quaternion}
+     * @return {this}
      */
     multiplyScalar(val) {
         return this.set(
@@ -413,15 +425,17 @@ class Quaternion {
 
     /**
      * @param {Quaternion} other
+     * @returns {this}
      */
     multiply(other) {
-        this.multiplyQuaternions(this, other);
+        return this.multiplyQuaternions(this, other);
     }
 
     /**
      *
      * @param {Quaternion} first
      * @param {Quaternion} second
+     * @returns {this}
      */
     multiplyQuaternions(first, second) {
         const aX = first.x;
@@ -434,7 +448,7 @@ class Quaternion {
         const bZ = second.z;
         const bW = second.w;
 
-        this._multiplyQuaternions(aX, aY, aZ, aW, bX, bY, bZ, bW)
+        return this._multiplyQuaternions(aX, aY, aZ, aW, bX, bY, bZ, bW)
     }
 
     /**
@@ -447,9 +461,12 @@ class Quaternion {
      * @param {number} by
      * @param {number} bz
      * @param {number} bw
-     * @return {Quaternion}
+     * @returns {this}
      */
-    _multiplyQuaternions(ax, ay, az, aw, bx, by, bz, bw) {
+    _multiplyQuaternions(
+        ax, ay, az, aw,
+        bx, by, bz, bw
+    ) {
 
         // see http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.htm
 
@@ -478,9 +495,12 @@ class Quaternion {
      *
      * @param {Quaternion} other
      * @param {number} max_delta in radians
+     * @returns {this}
      */
     rotateTowards(other, max_delta) {
         Quaternion.rotateTowards(this, this, other, max_delta);
+
+        return this;
     }
 
     /**
@@ -504,9 +524,11 @@ class Quaternion {
      * @param {function():number} random
      */
     setRandom(random) {
+        assert.isFunction(random,'random');
+
         this.set(random(), random(), random(), random());
 
-        this.normalize();
+        return this.normalize();
     }
 
     /**
@@ -655,6 +677,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesXYZ(x, y, z) {
         const half_x = x * 0.5;
@@ -674,7 +697,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 + s1 * s2 * c3;
         const _w = c1 * c2 * c3 - s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -685,6 +708,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesYXZ(x, y, z) {
         const scaled_x = x * 0.5;
@@ -704,7 +728,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 - s1 * s2 * c3;
         const _w = c1 * c2 * c3 + s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -715,6 +739,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesZXY(x, y, z) {
         const scaled_x = x * 0.5;
@@ -734,7 +759,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 + s1 * s2 * c3;
         const _w = c1 * c2 * c3 - s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -745,6 +770,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesZYX(x, y, z) {
         const scaled_x = x * 0.5;
@@ -764,7 +790,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 - s1 * s2 * c3;
         const _w = c1 * c2 * c3 + s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -775,6 +801,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesYZX(x, y, z) {
         const scaled_x = x * 0.5;
@@ -794,7 +821,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 - s1 * s2 * c3;
         const _w = c1 * c2 * c3 - s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -805,6 +832,7 @@ class Quaternion {
      * @param {number} x angle in X axis in radians
      * @param {number} y angle in Y axis in radians
      * @param {number} z angle in Z axis in radians
+     * @returns {this}
      */
     fromEulerAnglesXZY(x, y, z) {
         const scaled_x = x * 0.5;
@@ -824,7 +852,7 @@ class Quaternion {
         const _z = c1 * c2 * s3 + s1 * s2 * c3;
         const _w = c1 * c2 * c3 + s1 * s2 * s3;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
     /**
@@ -832,6 +860,7 @@ class Quaternion {
      * Based on blog post: http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors
      * @param {Vector3} from
      * @param {Vector3} to
+     * @returns {this}
      */
     fromUnitVectors(from, to) {
         assert.ok(from.isNormalized(), `from vector is not normalized, length = ${from.length()}`);
@@ -890,7 +919,7 @@ class Quaternion {
         const wZ = inv_m * crossZ;
 
 
-        this.set(
+        return this.set(
             wX,
             wY,
             wZ,
@@ -900,12 +929,13 @@ class Quaternion {
 
     /**
      * @param {number[]} m4x4
+     * @returns {this}
      */
     setFromRotationMatrix(m4x4) {
         assert.defined(m4x4, 'm4x4');
         assert.isArrayLike(m4x4, 'm4x4');
 
-        this.__setFromRotationMatrix(
+        return this.__setFromRotationMatrix(
             m4x4[0], m4x4[4], m4x4[8],
             m4x4[1], m4x4[5], m4x4[9],
             m4x4[2], m4x4[6], m4x4[10]
@@ -926,7 +956,7 @@ class Quaternion {
      * @param {number} m31
      * @param {number} m32
      * @param {number} m33
-     * @returns {Quaternion}
+     * @returns {this}
      */
     __setFromRotationMatrix(
         m11, m12, m13,
@@ -1008,18 +1038,21 @@ class Quaternion {
      * Linear interpolation
      * @param {Quaternion} other
      * @param {number} t fractional value between 0 and 1
+     * @returns {this}
      */
     lerp(other, t) {
 
-        this.lerpQuaternions(this, other, t);
+        return this.lerpQuaternions(this, other, t);
 
     }
 
     /**
-     *
+     * Linear interpolation of two quaternions
+     * Pretty good, not as good as slerp, but close enough for most application
      * @param {Quaternion} first
      * @param {Quaternion} second
      * @param {number} t
+     * @returns {this}
      */
     lerpQuaternions(first, second, t) {
 
@@ -1034,7 +1067,7 @@ class Quaternion {
         const w = lerp(first.w, second.w, t);
 
 
-        this.set(x, y, z, w);
+       return this.set(x, y, z, w);
     }
 
     /**
@@ -1042,6 +1075,7 @@ class Quaternion {
      * @param {Quaternion} from
      * @param {Quaternion} to
      * @param {number} t coefficient, how much between the input quats?
+     * @returns {this}
      */
     slerpQuaternions(from, to, t) {
         assert.isNumber(t, 't');
@@ -1095,7 +1129,7 @@ class Quaternion {
         const _z = scale0 * az + scale1 * bz;
         const _w = scale0 * aw + scale1 * bw;
 
-        this.set(_x, _y, _z, _w);
+        return this.set(_x, _y, _z, _w);
     }
 
 
@@ -1110,7 +1144,7 @@ class Quaternion {
 
     /**
      *
-     * @param {function} handler
+     * @param {function(x:number,y:number,z:number,w:number)} handler
      */
     process(handler) {
         handler(this.x, this.y, this.z, this.w);
@@ -1121,7 +1155,7 @@ class Quaternion {
     /**
      *
      * @param {Quaternion} other
-     * @returns {Quaternion}
+     * @returns {this}
      */
     copy(other) {
         return this.set(other.x, other.y, other.z, other.w);
@@ -1145,7 +1179,7 @@ class Quaternion {
      * @param {number} y
      * @param {number} z
      * @param {number} w
-     * @returns {Quaternion}
+     * @returns {this}
      */
     set(x, y, z, w) {
         assert.isNumber(x, 'x');
@@ -1180,7 +1214,7 @@ class Quaternion {
 
     /**
      *
-     * @returns {Quaternion}
+     * @returns {this}
      */
     conjugate() {
         return this.set(-this.x, -this.y, -this.z, this.w);

package/src/engine/ecs/Entity.js

@@ -68,7 +68,7 @@ class Entity {
     components = [];
 
     /**
-     *
+     * Listeners added before the entity is build live here
      * @type {{name:string,listener:(function|Function), context:*}[]}
      */
     #deferredListeners = [];
@@ -451,7 +451,7 @@ class Entity {
 
         r.dataset = dataset;
 
-        r.reference.bind(dataset,entity);
+        r.reference.bind(dataset, entity);
 
         return r;
     }

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

@@ -431,22 +431,29 @@ export class EntityComponentDataset {
 
     /**
      * Get all components associated with a given entity
-     * @returns {Array}
-     * @param {number} entityIndex
+     * @param {number} entity_id
+     * @returns {[]} all components attached to the entity, array is not compacted
      */
-    getAllComponents(entityIndex) {
-        assert.ok(this.entityExists(entityIndex), `Entity ${entityIndex} doesn't exist`);
+    getAllComponents(entity_id) {
+        assert.isNonNegativeInteger(entity_id, 'entity_id');
+        assert.ok(this.entityExists(entity_id), `Entity ${entity_id} doesn't exist`);
 
         const ret = [];
 
         const componentTypeCount = this.componentTypeCount;
-        const occupancyStart = componentTypeCount * entityIndex;
-        const occupancyEnd = occupancyStart + componentTypeCount;
+        const occupancy_start = componentTypeCount * entity_id;
+        const occupancy_end = occupancy_start + componentTypeCount;
 
-        for (let i = this.componentOccupancy.nextSetBit(occupancyStart); i < occupancyEnd && i !== -1; i = this.componentOccupancy.nextSetBit(i + 1)) {
+        const occupancy = this.componentOccupancy;
+
+        for (
+            let i = occupancy.nextSetBit(occupancy_start);
+            i < occupancy_end && i !== -1;
+            i = occupancy.nextSetBit(i + 1)
+        ) {
             const componentIndex = i % componentTypeCount;
 
-            ret[componentIndex] = this.components[componentIndex][entityIndex];
+            ret[componentIndex] = this.components[componentIndex][entity_id];
         }
 
         return ret;
@@ -968,7 +975,7 @@ export class EntityComponentDataset {
     }
 
     /**
-     * @template {T}
+     * @template T
      * @param {T} klass
      * @returns {number}
      */
@@ -1017,6 +1024,10 @@ export class EntityComponentDataset {
 
         assert.defined(componentInstance, "componentInstance");
 
+        /**
+         *
+         * @type {Class<C>}
+         */
         const klass = componentInstance.constructor;
 
         const componentTypeIndex = this.__type_to_index_map.get(klass);
@@ -1836,7 +1847,7 @@ export class EntityComponentDataset {
     }
 
     /**
-     * Tells whether or not dataset has any entities
+     * Tells if dataset has any entities
      * @returns {boolean}
      */
     isEmpty() {
@@ -1846,14 +1857,21 @@ export class EntityComponentDataset {
     /**
      *
      * @param {function(entityIndex:number)} visitor
+     * @param {*} [thisArg]
      */
-    traverseEntityIndices(visitor) {
+    traverseEntityIndices(visitor, thisArg) {
         let entityIndex;
 
         const occupancy = this.entityOccupancy;
 
-        for (entityIndex = occupancy.nextSetBit(0); entityIndex !== -1; entityIndex = occupancy.nextSetBit(entityIndex + 1)) {
-            visitor(entityIndex);
+        for (
+            entityIndex = occupancy.nextSetBit(0);
+            entityIndex !== -1;
+            entityIndex = occupancy.nextSetBit(entityIndex + 1)
+        ) {
+
+            visitor.call(thisArg, entityIndex);
+
         }
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":";;;wBAcU,MAAM;;;;;;iCAWN,MAAM;;;;;;;;;AAWhB;IAEI;;;OAGG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;OAGG;IACH,gCAFU,iCAAQ,CAES;IAE3B;;;OAGG;IACH,0BAFU,cAAc,EAAE,CAEL;IAErB;;OAEG;IACH;;;QAGI;;WAEG;qBADO,MAAM,iCAAQ;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;OAIG;IACH,gDAA2C;IAE3C;;;;OAIG;IACH,qBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;OAGG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;OAIG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BA8EC;IAED,sBAcC;IAED;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA0BhC;IAED;;;;OAIG;IACH,UAJa,CAAC,eACH,KAAK,CAAC,CAAC,CAAC,GACN,OAAO,CAInB;IAED;;;;OAIG;IACH,UAJa,CAAC,eACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,GAAC,IAAI,CAgBlB;IAED;;;;;OAKG;IACH,wBAJa,CAAC,aACH,MAAM,GACJ,IAAI,GAAC,KAAK,CAAC,CAAC,CAAC,CAezB;IAGD;;;OAGG;IACH,oBAFW,MAAM,QAkEhB;IAED;;;;;OAKG;IACH,iEA0EC;IAED;;;;OAIG;IACH,uDAFa,OAAO,CAAC,OAAO,CAAC,CAyC5B;IAED;;;;;OAKG;IACH,mBA6BC;IAED;;;;;OAKG;IACH,oBAwCC;IAED;;;;OAIG;IACH,gEAwEC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,OAAO,iCAAS,CA0B5B;IAED;;;;;OAKG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,OAAO,iCAAS,CAsB5B;IAED;;;;OAIG;IACH,iEAkEC;CACJ;uBApyBsD,aAAa;+BADrC,qBAAqB;mBALjC,oCAAoC"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":";;;wBAcU,MAAM;;;;;;iCAWN,MAAM;;;;;;;;;AAWhB;;;GAGG;AACH;IAEI;;;OAGG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;OAIG;IACH,uCAA2B;IAE3B;;;;OAIG;IACH,iCAAqB;IAErB;;OAEG;IACH;;;QAGI;;WAEG;qBADO,MAAM,iCAAQ;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;OAMG;IACH,gDAA2C;IAE3C;;;;OAIG;IACH,qBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;OAGG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BA8EC;IAED,sBAcC;IAED;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA0BhC;IAED;;;;OAIG;IACH,UAJa,CAAC,eACH,KAAK,CAAC,CAAC,CAAC,GACN,OAAO,CAInB;IAED;;;;OAIG;IACH,UAJa,CAAC,eACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,GAAC,IAAI,CAgBlB;IAED;;;;;OAKG;IACH,wBAJa,CAAC,aACH,MAAM,GACJ,IAAI,GAAC,KAAK,CAAC,CAAC,CAAC,CAezB;IAGD;;;OAGG;IACH,oBAFW,MAAM,QAkEhB;IAED;;;;;OAKG;IACH,iEA0EC;IAED;;;;OAIG;IACH,uDAFa,OAAO,CAAC,OAAO,CAAC,CAyC5B;IAED;;;;;OAKG;IACH,mBA6BC;IAED;;;;;OAKG;IACH,oBAwCC;IAED;;;;OAIG;IACH,gEAwEC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,OAAO,iCAAS,CA0B5B;IAED;;;;;OAKG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,OAAO,iCAAS,CAsB5B;IAED;;;;OAIG;IACH,iEAkEC;CACJ;uBA7yBsD,aAAa;mBANjD,oCAAoC"}

package/src/engine/ecs/EntityManager.js

@@ -34,6 +34,10 @@ export const EntityManagerState = {
     Stopped: 5
 };
 
+/**
+ * Brings together {@link System}s and an {@link EntityComponentDataset}
+ * Main entry point into the simulation process
+ */
 export class EntityManager {
 
     /**
@@ -44,12 +48,14 @@ export class EntityManager {
 
     /**
      * @readonly
+     * @private
      * @type {System[]}
      */
     systemsExecutionOrder = [];
 
     /**
      * @readonly
+     * @private
      * @type {EntityObserver[]}
      */
     systemObservers = [];
@@ -74,6 +80,8 @@ export class EntityManager {
     state = EntityManagerState.Initial;
 
     /**
+     * Track remainders of simulation time for fixed step
+     * Needed for accurate time keeping
      * @private
      * @readonly
      * @type {Map<System, number>}
@@ -102,7 +110,8 @@ export class EntityManager {
     dataset = null;
 
     /**
-     *
+     * Whenever a system is added or removed, optimal execution plan changes, this flag tells us to rebuild the current plan
+     * see {@link #systemsExecutionOrder}
      * @type {boolean}
      * @private
      */

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

@@ -1 +1 @@
-{"version":3,"file":"EntityObserver.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityObserver.js"],"names":[],"mappings":"AAWA;IAoBI;;;;;;;OAOG;IACH,oGAHW,GAAC,EA+CX;IAvED;;;OAGG;IACH,eAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,uBAFU,MAAM,EAAE,CAES;IAE3B;;;OAGG;IACH,SAFU,sBAAsB,GAAC,IAAI,CAEtB;IA0BX;;OAEG;IACH,oBAFU,MAAM,CAE2B;IAE3C;;;OAGG;IACH,kBAFU,CAAS,IAAK,eAAC,CAEgB;IAEzC;;;OAGG;IACH,gBAFU,CAAS,IAAK,eAAC,CAEW;IAEpC;;;OAGG;IACH,sBAAoC;IAEpC;;;OAGG;IACH,SAFU,GAAC,CAEW;IAG1B;;;OAGG;IACH,qCAqBC;IAED;;;OAGG;IACH,iBAFW,sBAAsB,QAIhC;IAED,mBAGC;CACJ;uBAnHsB,6BAA6B"}
+{"version":3,"file":"EntityObserver.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityObserver.js"],"names":[],"mappings":"AAGA;IAoBI;;;;;;;OAOG;IACH,0FAHW,GAAC,EA+CX;IAvED;;;OAGG;IACH,eAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,uBAFU,MAAM,EAAE,CAES;IAE3B;;;OAGG;IACH,SAFU,sBAAsB,GAAC,IAAI,CAEtB;IA0BX;;OAEG;IACH,oBAFU,MAAM,CAE2B;IAE3C;;;OAGG;IACH,kBAFU,CAAS,IAAK,eAAC,CAEgB;IAEzC;;;OAGG;IACH,gBAFU,CAAS,IAAK,eAAC,CAEW;IAEpC;;;OAGG;IACH,sBAAoC;IAEpC;;;OAGG;IACH,SAFU,GAAC,CAEW;IAG1B;;;OAGG;IACH,qCAqBC;IAED;;;OAGG;IACH,iBAFW,sBAAsB,QAIhC;IAED,mBAGC;CACJ;uBAnHsB,6BAA6B"}

package/src/engine/ecs/EntityObserver.js

@@ -1,11 +1,3 @@
-/**
- *
- * @param {Array} componentTypes
- * @param {function(components:Array)} completedCallback "this" parameter will be set to entity ID
- * @param {function(components:Array)} brokenCallback "this" parameter will be set to entity ID
- * @constructor
- * @class
- */
 import { assert } from "../../core/assert.js";
 import { BitSet } from "../../core/binary/BitSet.js";
 
@@ -32,8 +24,8 @@ export class EntityObserver {
     /**
      *
      * @param {Array} componentTypes
-     * @param {function} completedCallback
-     * @param {function} brokenCallback
+     * @param {function(components:Array)} completedCallback
+     * @param {function(components:Array)} brokenCallback
      * @param {*} [thisArg=undefined] will assume {@link this} value inside callbacks
      * @constructor
      */

package/src/engine/ecs/EntityReference.d.ts

@@ -10,6 +10,13 @@ export class EntityReference {
      * @return {EntityReference}
      */
     static from(id: number, generation: number): EntityReference;
+    /**
+     *
+     * @param {EntityComponentDataset} ecd
+     * @param {number} id
+     * @returns {EntityReference}
+     */
+    static bind(ecd: EntityComponentDataset, id: number): EntityReference;
     /**
      * Entity ID
      * When entity is live - this is the entity ID inside associated `EntityComponentDataset`, when the entity is not live - it's set to -1
@@ -50,9 +57,10 @@ export class EntityReference {
      */
     verify(ecd: EntityComponentDataset): boolean;
     /**
-     *
+     * Destroys entity bound to this reference
+     * If the reference is invalid for the given dataset - does nothing
      * @param {EntityComponentDataset} ecd
-     * @returns {boolean}
+     * @returns {boolean} true if entity was destroyed, false otherwise
      */
     destroy(ecd: EntityComponentDataset): boolean;
     /**