@woosh/meep-engine 2.129.4 → 2.130.0

package/package.json

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

package/src/core/collection/queue/Deque.d.ts

@@ -19,6 +19,8 @@ export class Deque<T> {
 
     getLast(): T | undefined
 
+    getElementByIndex(index: number): T | undefined
+
     pop(): T
 
     add(e: T): void
@@ -30,4 +32,6 @@ export class Deque<T> {
     addLast(e: T): void
 
     removeLast(): T
+
+    toArray(result?:T[], result_offset?:number):T[]
 }

package/src/core/model/node-graph/node/NodeInstancePortReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeInstancePortReference.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/node/NodeInstancePortReference.js"],"names":[],"mappings":"AASA;;GAEG;AACH;IAgFI;;;;;OAKG;IACH,iDAFa,yBAAyB,CAUrC;IA5FD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,gCAAgB;IAEhB;;;OAGG;IACH,oBAAY;IAEZ;;;;;OAKG;IACH,sBAFU,YAAY,CAEL;IAEjB;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH,kCAEC;IAED;;;OAGG;IACH,kBAFY,OAAO,CAIlB;IAED;;;;;OAKG;IACH,oCAHW,MAAM,GACJ,OAAO,CAqBnB;IAmBD;;;;OAIG;IACH,8CAWC;IAED;;;OAGG;IACH,QAFY,MAAM,CAOjB;IAED;;;;OAIG;IACH,cAHW,yBAAyB,GACvB,OAAO,CAMnB;IAED,mBAEC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D"}
+{"version":3,"file":"NodeInstancePortReference.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/node/NodeInstancePortReference.js"],"names":[],"mappings":"AASA;;GAEG;AACH;IAkFI;;;;;OAKG;IACH,iDAFa,yBAAyB,CAUrC;IA9FD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,gCAAgB;IAEhB;;;OAGG;IACH,oBAAY;IAEZ;;;;;OAKG;IACH,sBAFU,YAAY,CAEL;IAEjB;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH,kCAEC;IAED;;;;;OAKG;IACH,kBAFY,OAAO,CAIlB;IAED;;;;;OAKG;IACH,oCAHW,MAAM,GACJ,OAAO,CAqBnB;IAmBD;;;;OAIG;IACH,8CAWC;IAED;;;OAGG;IACH,QAFY,MAAM,CAOjB;IAED;;;;OAIG;IACH,cAHW,yBAAyB,GACvB,OAAO,CAMnB;IAED,mBAEC;IAGL;;;OAGG;IACH,sCAFU,OAAO,CAE8C;CAN9D"}

package/src/core/model/node-graph/node/NodeInstancePortReference.js

@@ -55,6 +55,8 @@ export class NodeInstancePortReference {
     }
 
     /**
+     * Is anything connected to this endpoint?
+     * Shortcut for `connections.length > 0`
      *
      * @return {boolean}
      */

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryClassSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH;IAEI;;;;OAIG;IACH,0BAAa;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,iCAEC;IAED;;;;;OAKG;IACH,iBAEC;IAED;;;;;;OAMG;IACH,uCAFW,CAAC,QAIX;IAED;;;;;;OAMG;IACH,yCAFW,CAAC,QAIX;IAGL;;;OAGG;IACH,4CAFU,OAAO,CAE0D;CAN1E"}
+{"version":3,"file":"BinaryClassSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;IAEI;;;;;;;OAOG;IACH,0BAAa;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,iCAEC;IAED;;;;;OAKG;IACH,iBAEC;IAED;;;;;;OAMG;IACH,uCAFW,CAAC,QAIX;IAED;;;;;;OAMG;IACH,yCAFW,CAAC,QAIX;IAGL;;;OAGG;IACH,4CAFU,OAAO,CAE0D;CAN1E"}

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js

@@ -1,15 +1,41 @@
 /**
- * Defines how to serialize and deserialize an instance of a given class
+ * Defines how to serialize and deserialize an instance of a given class.
+ * This class is intended to be overridden.
  *
  * @template T
  *
+ * @example
+ *      class BookSerializer extends BinaryClassSerializationAdapter{
+ *          klass = Book
+ *          version = 0
+ *
+ *          serialize(buffer: BinaryBuffer, book: Book){
+ *
+ *              buffer.writeUTF8String(book.title);
+ *              buffer.writeUint32(book.page_count);
+ *              buffer.writeUTF8String(book.text);
+ *
+ *          }
+ *
+ *          deserialize(buffer: BinaryBuffer, book: Book){
+ *
+ *              book.title = buffer.readUTF8String();
+ *              book.page_count = buffer.readUint32();
+ *              book.text = buffer.readUTF8String();
+ *
+ *          }
+ *      }
+ *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */
 export class BinaryClassSerializationAdapter {
 
     /**
-     * Class that this adapter handles
+     * Class that this adapter handles.
+     * NOTE: misspelling of the word "class" is intentional, in JavaScript "class" is a reserved word.
+     * @example
+     *    klass = Vector3
      * @protected
      * @type {Class<T>}
      */
@@ -24,23 +50,6 @@ export class BinaryClassSerializationAdapter {
      */
     version = 0;
 
-    /**
-     * @deprecated use {@link this.klass}
-     * @returns {Class<T>}
-     */
-    getClass() {
-        return this.klass;
-    }
-
-    /**
-     * @deprecated use {@link this.version}
-     *
-     * @returns {number}
-     */
-    getVersion() {
-        return this.version;
-    }
-
     /**
      * Invoked externally as part of the serialization lifecycle.
      * Guaranteed to be invoked before the first usage of the adapter.

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.js

@@ -46,7 +46,7 @@ export class BinarySerializationRegistry {
         let _className = className;
 
         if (_className === undefined) {
-            const klass = adapter.getClass();
+            const klass = adapter.klass;
 
             const typeName = klass.typeName;
 

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts

@@ -100,9 +100,9 @@ export class BinaryCollectionDeSerializer {
     getElementClass(): Class<T> | null;
     /**
      *
-     * @param {function(string,Class, BinaryClassSerializationAdapter):[]} [adapterOptionsSupplier]
+     * @param {function(name:string, klass: Class, adapter:BinaryClassSerializationAdapter):[]} [adapterOptionsSupplier]
      */
-    initialize({ adapterOptionsSupplier }?: (arg0: string, arg1: Class, arg2: BinaryClassSerializationAdapter) => []): void;
+    initialize({ adapterOptionsSupplier }?: (arg0: void) => string): void;
     finalize(): void;
     /**
      * @private

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH;IAEI;;;OAGG;IACH,iBAAgB;IAEhB;;;OAGG;IACH,eAAc;IAEd;;;;OAIG;IACH,4BAA4B;IAC5B;;;;OAIG;IACH,0BAA0B;IAE1B;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,yBAAsC;IACtC;;;;OAIG;IACH,yBAAsC;IAEtC;;;OAGG;IACH,cAAsB;IAGtB;;;OAGG;IACH,yDAKC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,WAAS,IAAI,CAUzB;IAED;;;OAGG;IACH,+CAFoB,MAAM,yDAAyC,EAAE,QAgFpE;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH;;aAF6B,MAAM;MA8DlC;CAEJ;6BAvV4B,4CAA4C"}
+{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH;IAEI;;;OAGG;IACH,iBAAgB;IAEhB;;;OAGG;IACH,eAAc;IAEd;;;;OAIG;IACH,4BAA4B;IAC5B;;;;OAIG;IACH,0BAA0B;IAE1B;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,yBAAsC;IACtC;;;;OAIG;IACH,yBAAsC;IAEtC;;;OAGG;IACH,cAAsB;IAGtB;;;OAGG;IACH,yDAKC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,WAAS,IAAI,CAUzB;IAED;;;OAGG;IACH,wDAFyB,MAAM,QAgF9B;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH;;aAF6B,MAAM;MA8DlC;CAEJ;6BAvV4B,4CAA4C"}

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js

@@ -155,12 +155,12 @@ export class BinaryCollectionDeSerializer {
             return null;
         }
 
-        return adapter.getClass();
+        return adapter.klass;
     }
 
     /**
      *
-     * @param {function(string,Class, BinaryClassSerializationAdapter):[]} [adapterOptionsSupplier]
+     * @param {function(name:string, klass: Class, adapter:BinaryClassSerializationAdapter):[]} [adapterOptionsSupplier]
      */
     initialize({ adapterOptionsSupplier = returnEmptyArray } = {}) {
         assert.isFunction(adapterOptionsSupplier, 'adapterOptionsSupplier');
@@ -186,7 +186,7 @@ export class BinaryCollectionDeSerializer {
 
         this.adapter = adapter;
 
-        const adapterOptions = adapterOptionsSupplier(className, adapter.getClass(), adapter);
+        const adapterOptions = adapterOptionsSupplier(className, adapter.klass, adapter);
 
         assert.isArray(adapterOptions, 'adapterOptions');
 
@@ -212,18 +212,18 @@ export class BinaryCollectionDeSerializer {
         this.elementIndex = 0;
 
         //check if data needs to be upgraded
-        if (version > adapter.getVersion()) {
-            throw new Error(`${className} data version is ${version}, which is greater than the registered serialization adapter version(=${adapter.getVersion()})`);
+        if (version > adapter.version) {
+            throw new Error(`${className} data version is ${version}, which is greater than the registered serialization adapter version(=${(adapter.version)})`);
         }
 
-        if (version < adapter.getVersion()) {
+        if (version < adapter.version) {
             this.__upgradeRequired = true;
 
             //data needs to be upgraded
-            const upgradersChain = registry.getUpgradersChain(className, version, adapter.getVersion());
+            const upgradersChain = registry.getUpgradersChain(className, version, adapter.version);
 
             if (upgradersChain === null) {
-                throw new Error(`No upgrade chain exists for class '${className}' from version ${version} to current adapter version ${adapter.getVersion()}`);
+                throw new Error(`No upgrade chain exists for class '${className}' from version ${version} to current adapter version ${(adapter.version)}`);
             }
 
             this.upgraders = upgradersChain;
@@ -267,7 +267,7 @@ export class BinaryCollectionDeSerializer {
             buffer = executeBinaryClassUpgraderChain(this.upgraders, buffer, this.__upgradeBuffer0, this.__upgradeBuffer1);
         }
 
-        const Klass = this.adapter.getClass();
+        const Klass = this.adapter.klass;
 
         const value = new Klass();
 

package/src/engine/ecs/storage/binary/collection/BinaryCollectionSerializer.js

@@ -135,7 +135,7 @@ export class BinaryCollectionSerializer {
 
         this.adapter = adapter;
 
-        const adapterOptions = adapterOptionsSupplier(className, adapter.getClass(), adapter);
+        const adapterOptions = adapterOptionsSupplier(className, adapter.klass, adapter);
 
         assert.isArray(adapterOptions, 'adapterOptions');
 
@@ -160,7 +160,7 @@ export class BinaryCollectionSerializer {
 
         this.startAddress = buffer.position;
 
-        const componentType = adapter.getClass();
+        const componentType = adapter.klass;
 
         //determine if dictionary can be used
         this.__dictionaryEnabled = typeof componentType.prototype.hash === "function"
@@ -182,7 +182,7 @@ export class BinaryCollectionSerializer {
         const headerValues = [];
 
         headerValues[BinaryCollectionHeaderLayout.Dictionary] = this.__dictionaryEnabled ? 1 : 0;
-        headerValues[BinaryCollectionHeaderLayout.Version] = this.adapter.getVersion();
+        headerValues[BinaryCollectionHeaderLayout.Version] = this.adapter.version;
 
         const header = BinaryCollectionHeaderCodec.encode.apply(null, headerValues);
 

package/src/engine/ecs/storage/binary/object/BinaryObjectSerializationAdapter.js

@@ -74,7 +74,7 @@ export class BinaryObjectSerializationAdapter {
         }
 
         buffer.writeUTF8String(className);
-        buffer.writeUintVar(adapter.getVersion());
+        buffer.writeUintVar(adapter.version);
 
         adapter.initialize(this);
 
@@ -103,7 +103,7 @@ export class BinaryObjectSerializationAdapter {
         //serialization format version
         const version = buffer.readUintVar();
 
-        const adapterVersion = adapter.getVersion();
+        const adapterVersion = adapter.version;
 
         if (version !== adapterVersion) {
             //upgrade is required
@@ -117,7 +117,7 @@ export class BinaryObjectSerializationAdapter {
             buffer = executeBinaryClassUpgraderChain(upgradersChain, buffer, this.__upgradeBuffer0, this.__upgradeBuffer1);
         }
 
-        const Klass = adapter.getClass();
+        const Klass = adapter.klass;
 
         const value = new Klass();