@woosh/meep-engine 2.110.2 → 2.110.4

package/build/meep.module.js

@@ -97939,9 +97939,22 @@ class ImmutableObjectPool {
 }
 
 /**
+ * Object Pool pattern implementation.
+ * Reuse objects instead of relying on garbage collector. Useful in cases where creating or destroying an object is costly, and objects are relatively short-lived
  * @template T
  */
 class ObjectPoolFactory {
+    /**
+     * @private
+     * @type {Array<T>}
+     */
+    pool = [];
+
+    /**
+     * @type {number}
+     */
+    maxSize = 256;
+
     /**
      * @param {function():T} creator
      * @param {function(T)} destroyer
@@ -97958,36 +97971,31 @@ class ObjectPoolFactory {
          * @type {function(): T}
          */
         this.creator = creator;
+
         /**
          * @private
          * @type {function(T)}
          */
         this.destroyer = destroyer;
+
         /**
          * @private
          * @type {function(T)}
          */
         this.resetter = resetter;
 
-        /**
-         * @private
-         * @type {Array<T>}
-         */
-        this.pool = [];
-
-        /**
-         * @type {number}
-         */
-        this.maxSize = 256;
     }
 
     /**
      *
      * @returns {T}
      */
-    create() {
-        if (this.pool.length > 0) {
-            const oldInstance = this.pool.pop();
+    get() {
+        const pool = this.pool;
+
+        if (pool.length > 0) {
+
+            const oldInstance = pool.pop();
 
             //reset the object
             this.resetter(oldInstance);
@@ -98010,7 +98018,9 @@ class ObjectPoolFactory {
      */
     release(object) {
 
-        if (this.pool.length >= this.maxSize) {
+        const pool = this.pool;
+
+        if (pool.length >= this.maxSize) {
             //pool is too large, destroy and discard the object
             if (this.destroyer !== noop) {
                 this.destroyer(object);
@@ -98020,11 +98030,18 @@ class ObjectPoolFactory {
         }
 
         //add it to the pool
-        this.pool.push(object);
+        pool.push(object);
 
         return true;
     }
-}
+}
+
+
+/**
+ * @deprecated use `get` instead
+ * @type {function(): T}
+ */
+ObjectPoolFactory.prototype.create = ObjectPoolFactory.prototype.get;
 
 /**
  * Will invoke A.equals(B) on members if such exists

package/package.json

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

package/src/core/model/object/ObjectPoolFactory.d.ts

@@ -1,4 +1,6 @@
 /**
+ * Object Pool pattern implementation.
+ * Reuse objects instead of relying on garbage collector. Useful in cases where creating or destroying an object is costly, and objects are relatively short-lived
  * @template T
  */
 export class ObjectPoolFactory<T> {
@@ -8,6 +10,15 @@ export class ObjectPoolFactory<T> {
      * @param {function(T)} resetter
      */
     constructor(creator: () => T, destroyer?: (arg0: T) => any, resetter?: (arg0: T) => any);
+    /**
+     * @private
+     * @type {Array<T>}
+     */
+    private pool;
+    /**
+     * @type {number}
+     */
+    maxSize: number;
     /**
      * @private
      * @type {function(): T}
@@ -23,25 +34,21 @@ export class ObjectPoolFactory<T> {
      * @type {function(T)}
      */
     private resetter;
-    /**
-     * @private
-     * @type {Array<T>}
-     */
-    private pool;
-    /**
-     * @type {number}
-     */
-    maxSize: number;
     /**
      *
      * @returns {T}
      */
-    create(): T;
+    get(): T;
     /**
      *
      * @param {T} object
      * @returns {boolean} true if object was added back to the pool, false if pool was full and object was destroyed instead
      */
     release(object: T): boolean;
+    /**
+     * @deprecated use `get` instead
+     * @type {function(): T}
+     */
+    create: () => T;
 }
 //# sourceMappingURL=ObjectPoolFactory.d.ts.map

package/src/core/model/object/ObjectPoolFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPoolFactory.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/ObjectPoolFactory.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IACI;;;;OAIG;IACH,2BAJsB,CAAC,qBACH,CAAC,4BACD,CAAC,UAqCpB;IA1BG;;;OAGG;IACH,gBAAsB;IACtB;;;OAGG;IACH,kBAA0B;IAC1B;;;OAGG;IACH,iBAAwB;IAExB;;;OAGG;IACH,aAAc;IAEd;;OAEG;IACH,SAFU,MAAM,CAEE;IAGtB;;;OAGG;IACH,UAFa,CAAC,CAwBb;IAED;;;;OAIG;IACH,gBAHW,CAAC,GACC,OAAO,CAqBnB;CACJ"}
+{"version":3,"file":"ObjectPoolFactory.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/ObjectPoolFactory.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IAYI;;;;OAIG;IACH,2BAJsB,CAAC,qBACH,CAAC,4BACD,CAAC,UA6BpB;IA3CD;;;OAGG;IACH,aAAU;IAEV;;OAEG;IACH,SAFU,MAAM,CAEF;IAgBV;;;OAGG;IACH,gBAAsB;IAEtB;;;OAGG;IACH,kBAA0B;IAE1B;;;OAGG;IACH,iBAAwB;IAI5B;;;OAGG;IACH,OAFa,CAAC,CA2Bb;IAED;;;;OAIG;IACH,gBAHW,CAAC,GACC,OAAO,CAuBnB;IAIL;;;OAGG;IACH,cAFsB,CAAC,CAEW;CAPjC"}

package/src/core/model/object/ObjectPoolFactory.js

@@ -3,9 +3,22 @@ import { assert } from "../../assert.js";
 import { noop } from "../../function/noop.js";
 
 /**
+ * Object Pool pattern implementation.
+ * Reuse objects instead of relying on garbage collector. Useful in cases where creating or destroying an object is costly, and objects are relatively short-lived
  * @template T
  */
 export class ObjectPoolFactory {
+    /**
+     * @private
+     * @type {Array<T>}
+     */
+    pool = [];
+
+    /**
+     * @type {number}
+     */
+    maxSize = 256;
+
     /**
      * @param {function():T} creator
      * @param {function(T)} destroyer
@@ -25,36 +38,31 @@ export class ObjectPoolFactory {
          * @type {function(): T}
          */
         this.creator = creator;
+
         /**
          * @private
          * @type {function(T)}
          */
         this.destroyer = destroyer;
+
         /**
          * @private
          * @type {function(T)}
          */
         this.resetter = resetter;
 
-        /**
-         * @private
-         * @type {Array<T>}
-         */
-        this.pool = [];
-
-        /**
-         * @type {number}
-         */
-        this.maxSize = 256;
     }
 
     /**
      *
      * @returns {T}
      */
-    create() {
-        if (this.pool.length > 0) {
-            const oldInstance = this.pool.pop();
+    get() {
+        const pool = this.pool;
+
+        if (pool.length > 0) {
+
+            const oldInstance = pool.pop();
 
             //reset the object
             this.resetter(oldInstance);
@@ -85,9 +93,11 @@ export class ObjectPoolFactory {
         assert.notNull(object, 'object');
         assert.defined(object, 'object');
 
-        assert.arrayHasNo(this.pool, object, `Pool already contains object that is being attempted to be release`);
+        const pool = this.pool;
 
-        if (this.pool.length >= this.maxSize) {
+        assert.arrayHasNo(pool, object, `Pool already contains object that is being attempted to be release`);
+
+        if (pool.length >= this.maxSize) {
             //pool is too large, destroy and discard the object
             if (this.destroyer !== noop) {
                 this.destroyer(object);
@@ -97,8 +107,15 @@ export class ObjectPoolFactory {
         }
 
         //add it to the pool
-        this.pool.push(object);
+        pool.push(object);
 
         return true;
     }
 }
+
+
+/**
+ * @deprecated use `get` instead
+ * @type {function(): T}
+ */
+ObjectPoolFactory.prototype.create = ObjectPoolFactory.prototype.get

package/src/engine/simulation/Ticker.d.ts

@@ -11,4 +11,13 @@ export default class Ticker {
 
     resume(): void
 
+    /**
+     * @deprecated
+     */
+    subscribe(callback: Function, thisArg?: any): void
+
+    /**
+     * @deprecated
+     */
+    unsubscribe(callback: Function, thisArg?: any): void
 }

package/src/core/model/object/SimpleObjectPoolFactory.d.ts

@@ -1,25 +0,0 @@
-/**
- * @template T
- */
-export class SimpleObjectPoolFactory<T> {
-    /**
-     * @template T
-     * @param {Function|Class<T>} type
-     * @param {number} size
-     */
-    constructor({ type, size }: Function | Class<T_1>);
-    Type: any;
-    /**
-     * @private
-     * @type {T}
-     */
-    private pool;
-    /**
-     * @private
-     * @type {number}
-     */
-    private maxSize;
-    get(): any;
-    release(o: any): void;
-}
-//# sourceMappingURL=SimpleObjectPoolFactory.d.ts.map

package/src/core/model/object/SimpleObjectPoolFactory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SimpleObjectPoolFactory.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/SimpleObjectPoolFactory.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IACI;;;;OAIG;IACH,4BAHW,qBAAiB,EAkB3B;IAbG,UAAgB;IAEhB;;;OAGG;IACH,aAAc;IAEd;;;OAGG;IACH,gBAAmB;IAGvB,WAMC;IAED,sBAMC;CACJ"}

package/src/core/model/object/SimpleObjectPoolFactory.js

@@ -1,42 +0,0 @@
-/**
- * @template T
- */
-export class SimpleObjectPoolFactory {
-    /**
-     * @template T
-     * @param {Function|Class<T>} type
-     * @param {number} size
-     */
-    constructor({ type, size = 256 }) {
-
-        this.Type = type;
-
-        /**
-         * @private
-         * @type {T}
-         */
-        this.pool = [];
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.maxSize = size;
-    }
-
-    get() {
-        if (this.pool.length > 0) {
-            return this.pool.pop();
-        } else {
-            return new this.Type();
-        }
-    }
-
-    release(o) {
-        if (this.pool.length < this.maxSize) {
-            this.pool.push(o);
-        } else {
-            // do nothing, just skip
-        }
-    }
-}