@woosh/meep-engine 2.127.1 → 2.128.1

package/package.json

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

package/src/core/geom/packing/miniball/Miniball.d.ts

@@ -1,6 +1,7 @@
 /**
  * Computes the miniball of the given point set.
  *
+ * Based on paper "Fast Smallest-Enclosing-Ball Computation in High Dimensions" by "Kaspar Fischer" et. al.
  * @copyright Company Named Limited (c) 2025
  */
 export class Miniball {
@@ -152,16 +153,17 @@ export class Miniball {
      *
      * Iteratively, we compute the point in support that is closest to the current center and then
      * walk towards this target as far as we can, i.e., we move until some new point touches the
-     * boundary of the ball and must thus be inserted into support. In each of these two alternating
-     * phases, we always have to check whether some point must be dropped from support, which is the
-     * case when the center lies in <i>aff(support)</i>. If such an attempt to drop fails, we are
-     * done; because then the center lies even <i>conv(support)</i>.
+     * boundary of the ball and must thus be inserted into support.
+     *
+     * In each of these two alternating phases, we always have to check whether some point must be dropped from support,
+     * which is the case when the center lies in <i>aff(support)</i>.
+     * If such an attempt to drop fails, we are done; because then the center lies even <i>conv(support)</i>.
      * @private
      */
     private compute;
     /**
      * If center doesn't already lie in <i>conv(support)</i> and is thus not optimal yet,
-     * {@link #successfulDrop()} elects a suitable point <i>k</i> to be removed from the support and
+     * {@link successfulDrop()} elects a suitable point <i>k</i> to be removed from the support and
      * returns true. If the center lies in the convex hull, however, false is returned (and the
      * support remains unaltered).
      *
@@ -171,16 +173,16 @@ export class Miniball {
     successfulDrop(): boolean;
     /**
      * Given the center of the current enclosing ball and the walking direction `centerToAff`,
-     * determine how much we can walk into this direction without losing a point from <i>S</i>. The
-     * (positive) factor by which we can walk along `centerToAff` is returned. Further,
-     * `stopper` is set to the index of the most restricting point and to -1 if no such point
-     * was found.
+     * determine how much we can walk into this direction without losing a point from <i>S</i>.
+     *
+     * The (positive) factor by which we can walk along `centerToAff` is returned.
+     * Further, `stopper` is set to the index of the most restricting point and to -1 if no such point was found.
      * @return {number}
      * @private
      */
     private findStopFraction;
     /**
-     * Outputs information about the miniball
+     * Outputs information about the Miniball
      * @return {string}
      */
     toString(): string;

package/src/core/geom/packing/miniball/Miniball.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Miniball.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/packing/miniball/Miniball.js"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH;IACI;;;;;OAKG;IACH,8BAkGC;IA/FG;;;OAGG;IACH,WAFU,MAAM,CAEE;IAClB;;;OAGG;IACH,WAFU,MAAM,CAEE;IAClB;;;OAGG;IACH,iBAFU,MAAM,CAEQ;IACxB;;;;;;;;;;OAUG;IACH,wBAAwB;IACxB;;;;OAIG;IACH,iBAAiB;IACjB;;;OAGG;IACH,SAFU,MAAM,CAEA;IAEhB;;OAEG;IACH,YAAe;IAEf;;;;OAIG;IACH,eAA2B;IAI3B;;;OAGG;IACH,KAFU,MAAM,CAEU;IAM1B;;;;OAIG;IACH,iBAA4D;IAE5D;;;OAGG;IACH,aAFU,MAAM,EAAE,GAAC,YAAY,CAEkD;IAEjF;;;OAGG;IACH,eAFU,MAAM,EAAE,GAAC,YAAY,CAEwD;IAEvF;;;OAGG;IACH,SAFU,MAAM,EAAE,GAAC,YAAY,CAEsD;IAErF;;;;OAIG;IACH,kBAAgC;IAIpC;;;;;;;OAOG;IACH,WAFY,OAAO,CAIlB;IAED;;;;;;OAMG;IACH,UAFY,MAAM,CAIjB;IAED;;;;;;OAMG;IACH,UAFY,MAAM,EAAE,CAInB;IAED;;;OAGG;IACH,uBAEC;IAED;;;;;;OAMG;IACH,QAJY,MAAM,CAMjB;IAED;;;;;;;;OAQG;IACH,iBAkCC;IAED;;OAEG;IACH,yBAGC;IAED;;OAEG;IACH,qBAcC;IAED;;;;;;;;;;OAUG;IACH,gBA4CC;IAED;;;;;;;;OAQG;IACH,kBAFY,OAAO,CA4BlB;IAED;;;;;;;;OAQG;IACH,yBAyDC;IAGD;;;OAGG;IACH,YAFY,MAAM,CAkBjB;CACJ;wBAnbuB,cAAc"}
+{"version":3,"file":"Miniball.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/packing/miniball/Miniball.js"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH;IA8CI;;;;;OAKG;IACH,8BA4DC;IA9GD;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;;;;;;;;OAUG;IACH,wBAAoB;IAEpB;;;;OAIG;IACH,iBAAa;IAEb;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAYR;;OAEG;IACH,YAAe;IAEf;;;;OAIG;IACH,eAA2B;IAI3B;;;OAGG;IACH,KAFU,MAAM,CAEU;IAM1B;;;;OAIG;IACH,iBAA4D;IAE5D;;;OAGG;IACH,aAFU,MAAM,EAAE,GAAC,YAAY,CAEkD;IAEjF;;;OAGG;IACH,eAFU,MAAM,EAAE,GAAC,YAAY,CAEwD;IAEvF;;;OAGG;IACH,SAFU,MAAM,EAAE,GAAC,YAAY,CAEsD;IAErF;;;;OAIG;IACH,kBAAgC;IAIpC;;;;;;;OAOG;IACH,WAFY,OAAO,CAIlB;IAED;;;;;;OAMG;IACH,UAFY,MAAM,CAIjB;IAED;;;;;;OAMG;IACH,UAFY,MAAM,EAAE,CAInB;IAED;;;OAGG;IACH,uBAEC;IAED;;;;;;OAMG;IACH,QAJY,MAAM,CAMjB;IAED;;;;;;;;OAQG;IACH,iBAkCC;IAED;;OAEG;IACH,yBAGC;IAED;;OAEG;IACH,qBAcC;IAED;;;;;;;;;;;OAWG;IACH,gBA4CC;IAED;;;;;;;;OAQG;IACH,kBAFY,OAAO,CA4BlB;IAED;;;;;;;;OAQG;IACH,yBA8DC;IAGD;;;OAGG;IACH,YAFY,MAAM,CA0BjB;CACJ;wBAzcuB,cAAc"}

package/src/core/geom/packing/miniball/Miniball.js

@@ -14,10 +14,10 @@ import { Subspan } from "./Subspan.js";
  * Small number
  * @type {number}
  */
-const Epsilon = 1.0E-14;
+const Epsilon = 1e-14;
 
 /**
- * Limit to how many iterations algorithm is allowed to perform, this is to cover poorly converging cases
+ * Limit to how many iterations the algorithm is allowed to perform, this is to cover poorly converging cases
  * @type {number}
  */
 const MAX_ITERATIONS = 10000;
@@ -25,9 +25,55 @@ const MAX_ITERATIONS = 10000;
 /**
  * Computes the miniball of the given point set.
  *
+ * Based on paper "Fast Smallest-Enclosing-Ball Computation in High Dimensions" by "Kaspar Fischer" et. al.
  * @copyright Company Named Limited (c) 2025
  */
 export class Miniball {
+
+    /**
+     *
+     * @type {number}
+     */
+    iteration = 0;
+
+    /**
+     *
+     * @type {number}
+     */
+    distToAff = 0;
+
+    /**
+     *
+     * @type {number}
+     */
+    distToAffSquare = 0;
+
+    /**
+     *
+     * The squared radius of the miniball.
+     *
+     * This is equivalent to `radius() * radius()`.
+     *
+     * Precondition: `!isEmpty()`
+     *
+     * @type {number}
+     * @private
+     */
+    __squaredRadius = 0;
+
+    /**
+     *
+     * @type {number}
+     * @private
+     */
+    __radius = 0;
+
+    /**
+     *
+     * @type {number}
+     */
+    stopper = 0;
+
     /**
      * Notice that the point set `points` is assumed to be immutable during the computation.
      * That is, if you add, remove, or change points in the point set, you have to create a new instance of {@link Miniball}.
@@ -37,44 +83,6 @@ export class Miniball {
     constructor(points) {
         assert.defined(points, 'points');
 
-        /**
-         *
-         * @type {number}
-         */
-        this.iteration = 0;
-        /**
-         *
-         * @type {number}
-         */
-        this.distToAff = 0;
-        /**
-         *
-         * @type {number}
-         */
-        this.distToAffSquare = 0;
-        /**
-         *
-         * The squared radius of the miniball.
-         *
-         * This is equivalent to `radius() * radius()`.
-         *
-         * Precondition: `!isEmpty()`
-         *
-         * @type {number}
-         * @private
-         */
-        this.__squaredRadius = 0;
-        /**
-         *
-         * @type {number}
-         * @private
-         */
-        this.__radius = 0;
-        /**
-         *
-         * @type {number}
-         */
-        this.stopper = 0;
 
         /**
          * @type {PointSet}
@@ -264,10 +272,11 @@ export class Miniball {
      *
      * Iteratively, we compute the point in support that is closest to the current center and then
      * walk towards this target as far as we can, i.e., we move until some new point touches the
-     * boundary of the ball and must thus be inserted into support. In each of these two alternating
-     * phases, we always have to check whether some point must be dropped from support, which is the
-     * case when the center lies in <i>aff(support)</i>. If such an attempt to drop fails, we are
-     * done; because then the center lies even <i>conv(support)</i>.
+     * boundary of the ball and must thus be inserted into support.
+     *
+     * In each of these two alternating phases, we always have to check whether some point must be dropped from support,
+     * which is the case when the center lies in <i>aff(support)</i>.
+     * If such an attempt to drop fails, we are done; because then the center lies even <i>conv(support)</i>.
      * @private
      */
     compute() {
@@ -318,7 +327,7 @@ export class Miniball {
 
     /**
      * If center doesn't already lie in <i>conv(support)</i> and is thus not optimal yet,
-     * {@link #successfulDrop()} elects a suitable point <i>k</i> to be removed from the support and
+     * {@link successfulDrop()} elects a suitable point <i>k</i> to be removed from the support and
      * returns true. If the center lies in the convex hull, however, false is returned (and the
      * support remains unaltered).
      *
@@ -355,10 +364,10 @@ export class Miniball {
 
     /**
      * Given the center of the current enclosing ball and the walking direction `centerToAff`,
-     * determine how much we can walk into this direction without losing a point from <i>S</i>. The
-     * (positive) factor by which we can walk along `centerToAff` is returned. Further,
-     * `stopper` is set to the index of the most restricting point and to -1 if no such point
-     * was found.
+     * determine how much we can walk into this direction without losing a point from <i>S</i>.
+     *
+     * The (positive) factor by which we can walk along `centerToAff` is returned.
+     * Further, `stopper` is set to the index of the most restricting point and to -1 if no such point was found.
      * @return {number}
      * @private
      */
@@ -379,7 +388,11 @@ export class Miniball {
         const centerToPoint = this.centerToPoint;
         const centerToAff = this.centerToAff;
 
+        const distToAffSquare = this.distToAffSquare;
+        const squaredRadius = this.__squaredRadius;
+
         const size = this.__size;
+        const distance_error = Epsilon * this.__radius * this.distToAff;
 
         for (j = 0; j < size; ++j) {
 
@@ -388,6 +401,7 @@ export class Miniball {
             }
 
             for (i = 0; i < dim; ++i) {
+                // read out a single point, offset by center
                 centerToPoint[i] = pointSet.coord(j, i) - center[i];
             }
 
@@ -397,7 +411,7 @@ export class Miniball {
                 dirPointProd += centerToAff[i] * centerToPoint[i];
             }
 
-            if ((this.distToAffSquare - dirPointProd) < (Epsilon * this.__radius * this.distToAff)) {
+            if ((distToAffSquare - dirPointProd) < distance_error) {
                 continue;
             }
 
@@ -407,7 +421,7 @@ export class Miniball {
                 bound += centerToPoint[i] * centerToPoint[i];
             }
 
-            bound = (this.__squaredRadius - bound) / 2 / (this.distToAffSquare - dirPointProd);
+            bound = (squaredRadius - bound) / 2 / (distToAffSquare - dirPointProd);
 
             if (bound > 0 && bound < scale) {
                 //if (com.dreizak.miniball.highdim.Logging.log)
@@ -423,15 +437,20 @@ export class Miniball {
 
 
     /**
-     * Outputs information about the miniball
+     * Outputs information about the Miniball
      * @return {string}
      */
     toString() {
         let s = "Miniball [";
+
         if (this.isEmpty()) {
-            s += ("isEmpty=true");
+
+            s += "isEmpty=true";
+
         } else {
-            s += ("center=(");
+
+            s += "center=(";
+
             for (let i = 0; i < this.dim; ++i) {
                 s += (this.__center[i]);
                 if (i < this.dim - 1)
@@ -439,8 +458,11 @@ export class Miniball {
             }
 
             s += `), radius=${this.__radius}, squaredRadius=${this.__squaredRadius}`;
+
         }
+
         s += "]";
+
         return s;
     }
 }

package/src/engine/Clock.d.ts

@@ -31,8 +31,9 @@ declare class Clock {
      * Allows us to slow down or speed up flow of time via modifiers, see {@link Stat} for details
      * Default speed is x1, i.e. - unmodified
      * @type {Stat}
+     * @readonly
      */
-    speed: Stat;
+    readonly speed: Stat;
     /**
      *
      * @param {number} v

package/src/engine/Clock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/engine/Clock.js"],"names":[],"mappings":";AAcA;;GAEG;AACH;IAEI;;;;OAIG;IACH,0BAAsB;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;OAIG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;OAIG;IACH,oBAAoB;IAGpB;;;;;OAKG;IACH,OAFU,IAAI,CAEM;IAMpB;;;OAGG;IACH,4BAEC;IAED;;;OAGG;IACH,yBAEC;IAED,cAIC;IAED,aAEC;IAED,cAIC;IAED;;;OAGG;IACH,YAFa,MAAM,CAOlB;IAED;;;OAGG;IACH,qBAFa,MAAM,CAOlB;IAED;;;;OAIG;IACH,kBAFY,MAAM,CAIjB;IAED,cAGC;CACJ;iBA9HgB,4BAA4B"}
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/engine/Clock.js"],"names":[],"mappings":";AAcA;;GAEG;AACH;IAEI;;;;OAIG;IACH,0BAAsB;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;OAIG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;OAIG;IACH,oBAAoB;IAGpB;;;;;;OAMG;IACH,gBAHU,IAAI,CAGM;IAMpB;;;OAGG;IACH,4BAEC;IAED;;;OAGG;IACH,yBAEC;IAED,cAIC;IAED,aAEC;IAED,cAIC;IAED;;;OAGG;IACH,YAFa,MAAM,CAOlB;IAED;;;OAGG;IACH,qBAFa,MAAM,CAOlB;IAED;;;;OAIG;IACH,kBAFY,MAAM,CAIjB;IAED,cAGC;CACJ;iBA/HgB,4BAA4B"}

package/src/engine/Clock.js

@@ -50,6 +50,7 @@ class Clock {
      * Allows us to slow down or speed up flow of time via modifiers, see {@link Stat} for details
      * Default speed is x1, i.e. - unmodified
      * @type {Stat}
+     * @readonly
      */
     speed = new Stat(1);
 

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

@@ -1 +1 @@
-{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/Entity.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAsbI;;;;;;;;;;;;OAYG;IACH,+BAJW,MAAM,oCAEJ,MAAM,CAqBlB;IApdD;;;;;OAKG;IACH,oBAFU,eAAe,CAES;IAGlC;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,yBAEC;IAED;;;;OAIG;IACH,2BAAgB;IAShB;;;;;;OAMG;IACH,gCAAe;IAEf;;;OAGG;IACH,OAFU,WAAW,GAAC,MAAM,CAEN;IAEtB;;;;OAIG;IACH,yBAAgB;IAEhB;;OAEG;IACH;QACI;;WAEG;;MAEL;IAUF;;;OAGG;IACH,eAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,WAAW,GAChB,OAAO,CAMnB;IAED;;;OAGG;IACH,gBAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;;;;OAOG;IACH,gCAEC;IAED;;OAEG;IACH,4BAQC;IAED;;;OAGG;IACH,oBAEC;IAED;;;;;;OAMG;IACH,+BAFa,MAAM,CAsBlB;IAED;;;;;OAKG;IACH,+BAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,0CAYC;IAED;;;;;OAKG;IACH,8CAQC;IAED;;;;OAIG;IACH,kCAFa,MAAE,IAAI,CA0BlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,qBAShB;IAED;;;OAGG;IACH,wBAFW,MAAM,gBAiBhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,sCAGJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,+BALW,MAAM,sCAGJ,MAAM,CAyBlB;IAED;;;;;;OAMG;IACH,WAJa,OAAO,CA0BnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,wCANa,MAAM,CA+DlB;IAqCL;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;;gCAhgB+B,sBAAsB;4BAD1B,kBAAkB;mBAF3B,oCAAoC"}
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/Entity.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAkcI;;;;;;;;;;;;OAYG;IACH,+BAJW,MAAM,oCAEJ,MAAM,CAmBlB;IA9dD;;;;;OAKG;IACH,oBAFU,eAAe,CAES;IAGlC;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,yBAEC;IAED;;;;OAIG;IACH,2BAAgB;IAShB;;;;;;OAMG;IACH,gCAAe;IAEf;;;OAGG;IACH,OAFU,WAAW,GAAC,MAAM,CAEN;IAEtB;;;;OAIG;IACH,yBAAgB;IAEhB;;OAEG;IACH;QACI;;WAEG;;MAEL;IAUF;;;OAGG;IACH,eAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,WAAW,GAChB,OAAO,CAMnB;IAED;;;OAGG;IACH,gBAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;;;;OAOG;IACH,gCAEC;IAED;;OAEG;IACH,4BAUC;IAED;;;OAGG;IACH,oBAEC;IAED;;;;;;OAMG;IACH,+BAFa,MAAM,CAsBlB;IAED;;;;;OAKG;IACH,+BAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,0CAYC;IAED;;;;;OAKG;IACH,8CAQC;IAED;;;;OAIG;IACH,kCAFa,MAAE,IAAI,CA0BlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,qBAWhB;IAED;;;OAGG;IACH,wBAFW,MAAM,gBAmBhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,sCAGJ,MAAM,CAgBlB;IAED;;;;;;OAMG;IACH,+BALW,MAAM,sCAGJ,MAAM,CA4BlB;IAED;;;;;;OAMG;IACH,WAJa,OAAO,CA0BnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,wCANa,MAAM,CA+DlB;IAmCL;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;;gCA1gB+B,sBAAsB;4BAD1B,kBAAkB;mBAD3B,oCAAoC"}

package/src/engine/ecs/Entity.js

@@ -1,6 +1,5 @@
 import { assert } from "../../core/assert.js";
 import Signal from "../../core/events/signal/Signal.js";
-import { isDefined } from "../../core/process/matcher/isDefined.js";
 import { EntityFlags } from "./EntityFlags.js";
 import { EntityReference } from "./EntityReference.js";
 import { EventType } from "./EventType.js";
@@ -172,7 +171,9 @@ export class Entity {
         for (let i = n - 1; i >= 0; i--) {
             const component = elements[i];
 
-            this.removeComponent(Object.getPrototypeOf(component).constructor);
+            const ComponentClass = Object.getPrototypeOf(component).constructor;
+
+            this.removeComponent(ComponentClass);
         }
     }
 
@@ -295,6 +296,8 @@ export class Entity {
      * @param {*} [event]
      */
     sendEvent(eventName, event) {
+        assert.isString(eventName, "eventName");
+
         if (this.getFlag(EntityFlags.Built)) {
             this.dataset.sendEvent(this.reference.id, eventName, event);
         } else {
@@ -307,6 +310,8 @@ export class Entity {
      * @param {string} eventName
      */
     promiseEvent(eventName) {
+        assert.isString(eventName, "eventName");
+
         return new Promise((resolve, reject) => {
 
             const handle_event = () => {
@@ -331,6 +336,9 @@ export class Entity {
      * @returns {Entity}
      */
     addEventListener(eventName, listener, context) {
+        assert.isString(eventName, "eventName");
+        assert.isFunction(listener, "listener");
+
         if (this.getFlag(EntityFlags.Built)) {
             this.dataset.addEntityEventListener(this.reference.id, eventName, listener, context);
         } else {
@@ -351,6 +359,9 @@ export class Entity {
      * @returns {Entity}
      */
     removeEventListener(eventName, listener, context) {
+        assert.isString(eventName, "eventName");
+        assert.isFunction(listener, "listener");
+
         if (this.getFlag(EntityFlags.Built)) {
             this.dataset.removeEntityEventListener(this.reference.id, eventName, listener, context);
         } else {
@@ -502,9 +513,7 @@ export class Entity {
 
         const r = new Entity();
 
-        dataset.getAllComponents(entity)
-            .filter(isDefined)
-            .forEach(r.add, r);
+        dataset.readEntityComponents(r.components, 0, entity);
 
         r.setFlag(EntityFlags.Built);
 

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

@@ -476,11 +476,56 @@ export class EntityComponentDataset {
         return result;
     }
 
+    /**
+     *
+     * @param {[]} output
+     * @param {number} output_offset
+     * @param {number} entity_id
+     * @returns {number} how many components were written to the output
+     * @see getAllComponents
+     */
+    readEntityComponents(
+        output,
+        output_offset,
+        entity_id
+    ) {
+
+        assert.isNonNegativeInteger(entity_id, 'entity_id');
+        assert.ok(this.entityExists(entity_id), `Entity ${entity_id} doesn't exist`);
+        assert.isArray(output, "output");
+        assert.isNonNegativeInteger(output_offset, 'output_offset');
+
+        const componentTypeCount = this.componentTypeCount;
+        const occupancy_start = componentTypeCount * entity_id;
+        const occupancy_end = occupancy_start + componentTypeCount;
+
+        const occupancy = this.componentOccupancy;
+
+        let offset = output_offset;
+
+        for (
+            let i = occupancy.nextSetBit(occupancy_start);
+            i < occupancy_end && i !== -1;
+            i = occupancy.nextSetBit(i + 1)
+        ) {
+            const componentIndex = i % componentTypeCount;
+
+            const component = this.components[componentIndex][entity_id];
+
+            output[offset++] = component;
+
+        }
+
+        return offset - output_offset;
+    }
+
     /**
      * Get all components associated with a given entity.
      * Note that this method allocates. If performance is important - prefer alternatives.
+     * Prefer to use {@link readEntityComponents} for performance reasons.
      * @param {number} entity_id
      * @returns {[]} all components attached to the entity, array is not compacted
+     * @see readEntityComponents
      */
     getAllComponents(entity_id) {
         assert.isNonNegativeInteger(entity_id, 'entity_id');
@@ -1775,8 +1820,8 @@ export class EntityComponentDataset {
 
     /**
      * Notifies every component of specified entity with given event
-     * @param {Number} entity
-     * @param {String} name event name
+     * @param {number} entity
+     * @param {string} name event name
      * @param {Object} [event=undefined]
      * @returns {void}
      * @see addEntityEventListener
@@ -1785,6 +1830,7 @@ export class EntityComponentDataset {
         // console.log("sendEvent", entity, name, event);
 
         assert.isString(name, "name");
+        assert.isNonNegativeInteger(entity, "entity");
 
         dispatchEntityEventListeners(this.__entityEventListeners, entity, name, event);
 

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

@@ -141,7 +141,7 @@ export class EntityManager {
     /**
      * If the {@link EntityManager} is already started, the system will be started automatically before being added
      * @param {System} system
-     * @returns {Promise}
+     * @returns {Promise} resolution depends on {@link EntityManager}'s state, if running - promise resolves after system startup. Otherwise, the promise will be resolved immediately.
      * @throws {IllegalStateException}
      */
     addSystem(system: System<any, any, any, any, any>): Promise<any>;
@@ -166,8 +166,8 @@ export class EntityManager {
      */
     private startSystem;
     /**
-     * This method is asynchronous by nature, it has to wait for each individual system to finish its own statup.
-     * Make sure to register callback in order to be notified when the startup has finished
+     * This method is asynchronous by nature, it has to wait for each system to finish its own startup.
+     * Make sure to register callback to be notified when the startup has finished
      * @param {function} [readyCallback] executed once entity manager successfully completes startup
      * @param {function} [errorCallback] executed if entity manager encounters an error during startup
      */
@@ -179,17 +179,16 @@ export class EntityManager {
      */
     promiseSystem(systemClass: Class): Promise<System<any, any, any, any, any>>;
     /**
-     *
      * @param {Class} systemClass
      * @param {SystemState} state
      * @returns {Promise.<System>}
      */
     promiseSystemInState(systemClass: Class, state: SystemState): Promise<System<any, any, any, any, any>>;
     /**
-     * This method is asynchronous by nature, it will not be done until each individual system has finished its shutdown
+     * This method is asynchronous by nature, it will not be done until each system has finished its shutdown
      * Make sure to use callback to be notified when the shutdown has completed
      * @param {function} [readyCallback] Called when shutdown finishes successfully. defaults to no-operation
-     * @param {function} [errorCallback] Called when an error occurs during shutdown process. defaults to console error output
+     * @param {function} [errorCallback] Called when an error occurs during the shutdown process. defaults to console error output
      */
     shutdown(readyCallback?: Function, errorCallback?: Function): void;
     /**

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":"iCAgBU,MAAM;;;;;;;;;AAWhB;;;;;;GAMG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;OAMG;IACH,gDAA2C;IAE3C;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,oBAFW,MAAM,QAoEhB;IAED;;;;;OAKG;IACH,iEAoEC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBA6BC;IAED;;;;;OAKG;IACH,oBA0DC;IAED;;;;;OAKG;IACH,kEAwEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;;OAKG;IACH,8DAFa,wCAAgB,CAsB5B;IAED;;;;;OAKG;IACH,mEAsEC;IAGL;;OAEG;IACH,yBAhpBe,sBAAsB,UAgpBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBAl3BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAgBU,MAAM;;;;;;;;;AAiBhB;;;;;;GAMG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;OAMG;IACH,gDAA2C;IAE3C;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,oBAFW,MAAM,QAoEhB;IAED;;;;;OAKG;IACH,iEA6DC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAmCC;IAED;;;;;OAKG;IACH,oBAqFC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;OAIG;IACH,8DAFa,wCAAgB,CAsB5B;IAED;;;;;OAKG;IACH,mEAoFC;IAGL;;OAEG;IACH,yBAxrBe,sBAAsB,UAwrBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBAh6BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}