@woosh/meep-engine 2.126.14 → 2.126.16

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

@@ -1,5 +1,8 @@
 /**
  * Defines how to serialize and deserialize an instance of a given class
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinaryClassSerializationAdapter {
     /**

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;;GAEG;AACH;IAEI;;;;OAIG;IACH,iBAFU,KAAK,CAEF;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,SAHa,CAAC,KACD,KAAK,CAAC,CAAC,CAAC,CAIpB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED,iCAEC;IAED;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,kBAHW,YAAY,oBAKtB;IAED;;;;OAIG;IACH,oBAHW,YAAY,oBAKtB;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;;;;;GAKG;AACH;IAEI;;;;OAIG;IACH,iBAFU,KAAK,CAEF;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,SAHa,CAAC,KACD,KAAK,CAAC,CAAC,CAAC,CAIpB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED,iCAEC;IAED;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,kBAHW,YAAY,oBAKtB;IAED;;;;OAIG;IACH,oBAHW,YAAY,oBAKtB;IAGL;;;OAGG;IACH,4CAFU,OAAO,CAE0D;CAN1E"}

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

@@ -1,5 +1,8 @@
 /**
  * Defines how to serialize and deserialize an instance of a given class
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinaryClassSerializationAdapter {
 

package/src/engine/ecs/storage/binary/BinaryClassUpgrader.d.ts

@@ -28,5 +28,10 @@ export class BinaryClassUpgrader {
      * @returns {void}
      */
     upgrade(source: BinaryBuffer, target: BinaryBuffer): void;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isBinaryClassUpgrader: boolean;
 }
 //# sourceMappingURL=BinaryClassUpgrader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BinaryClassUpgrader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassUpgrader.js"],"names":[],"mappings":"AAAA;IAEI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IACnB;;;;OAIG;IACH,2BAHU,MAAM,CAGI;IAEpB;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,gBAJW,YAAY,UACZ,YAAY,GACV,IAAI,CAIhB;CACJ"}
+{"version":3,"file":"BinaryClassUpgrader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassUpgrader.js"],"names":[],"mappings":"AAAA;IAEI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IACnB;;;;OAIG;IACH,2BAHU,MAAM,CAGI;IAEpB;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,gBAJW,YAAY,UACZ,YAAY,GACV,IAAI,CAIhB;IAGL;;;OAGG;IACH,gCAFU,OAAO,CAEkC;CANlD"}

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

@@ -39,3 +39,9 @@ export class BinaryClassUpgrader {
         throw new Error('Not Implemented');
     }
 }
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+BinaryClassUpgrader.prototype.isBinaryClassUpgrader = true;

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.d.ts

@@ -1,5 +1,8 @@
 /**
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinarySerializationRegistry {
     /**
@@ -21,17 +24,18 @@ export class BinarySerializationRegistry {
     registerAdapters(adapters: BinaryClassSerializationAdapter[]): void;
     /**
      *
-     * @param {string} [className]
      * @param {BinaryClassSerializationAdapter} adapter
-     * @returns {boolean}
+     * @param {string} [className] if not specified, will be taken from the {@link BinaryClassSerializationAdapter.klass.typeName}
+     * @returns {boolean} true if added, false if adapter already existed
+     * @throws {Error} if `className` could not be inferred
      */
     registerAdapter(adapter: BinaryClassSerializationAdapter, className?: string): boolean;
     /**
      *
      * @param {string} className
-     * @returns {BinaryClassSerializationAdapter}
+     * @returns {BinaryClassSerializationAdapter|undefined}
      */
-    removeAdapter(className: string): BinaryClassSerializationAdapter;
+    removeAdapter(className: string): BinaryClassSerializationAdapter | undefined;
     /**
      *
      * @param {string} className
@@ -42,7 +46,7 @@ export class BinarySerializationRegistry {
      *
      * @param {string} className
      * @param {BinaryClassUpgrader} upgrader
-     * @returns {boolean}
+     * @returns {boolean} true iff added, false if already exists
      */
     registerUpgrader(className: string, upgrader: BinaryClassUpgrader): boolean;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"BinarySerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinarySerializationRegistry.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAEI;;;;OAIG;IACH,2BAAsB;IACtB;;;;OAIG;IACH,6BAAwB;IAExB;;;OAGG;IACH,2BAFW,+BAA+B,EAAE,QAM3C;IAED;;;;;OAKG;IACH,yBAHW,+BAA+B,cAD/B,MAAM,GAEJ,OAAO,CA6BnB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,+BAA+B,CAU3C;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAIrD;IAED;;;;;OAKG;IACH,4BAJW,MAAM,YACN,mBAAmB,GACjB,OAAO,CAyCnB;IAED;;;;;;OAMG;IACH,6BALW,MAAM,gBACN,MAAM,eACN,MAAM,GACJ,mBAAmB,EAAE,GAAC,IAAI,CAsDtC;IAIL;;;OAGG;IACH,wCAFU,OAAO,CAEkD;CANlE"}
+{"version":3,"file":"BinarySerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinarySerializationRegistry.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAEI;;;;OAIG;IACH,2BAAsB;IACtB;;;;OAIG;IACH,6BAAwB;IAExB;;;OAGG;IACH,2BAFW,+BAA+B,EAAE,QAM3C;IAED;;;;;;OAMG;IACH,yBALW,+BAA+B,cAC/B,MAAM,GACJ,OAAO,CAkCnB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAYrD;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAMrD;IAED;;;;;OAKG;IACH,4BAJW,MAAM,YACN,mBAAmB,GACjB,OAAO,CA6CnB;IAED;;;;;;OAMG;IACH,6BALW,MAAM,gBACN,MAAM,eACN,MAAM,GACJ,mBAAmB,EAAE,GAAC,IAAI,CA0DtC;IAIL;;;OAGG;IACH,wCAFU,OAAO,CAEkD;CANlE"}

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

@@ -3,6 +3,9 @@ import { Graph } from "../../../../core/graph/v2/Graph.js";
 
 /**
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinarySerializationRegistry {
 
@@ -31,9 +34,10 @@ export class BinarySerializationRegistry {
 
     /**
      *
-     * @param {string} [className]
      * @param {BinaryClassSerializationAdapter} adapter
-     * @returns {boolean}
+     * @param {string} [className] if not specified, will be taken from the {@link BinaryClassSerializationAdapter.klass.typeName}
+     * @returns {boolean} true if added, false if adapter already existed
+     * @throws {Error} if `className` could not be inferred
      */
     registerAdapter(adapter, className) {
         assert.defined(adapter, 'adapter');
@@ -44,15 +48,19 @@ export class BinarySerializationRegistry {
         if (_className === undefined) {
             const klass = adapter.getClass();
 
-            if (typeof klass.typeName === "string") {
-                _className = klass.typeName;
+            const typeName = klass.typeName;
+
+            if (typeof typeName === "string") {
+                _className = typeName;
             } else {
                 throw new Error(`className not specified, could not infer class name from the class itself`);
             }
         }
 
+        assert.isString(_className, 'className');
+
         if (this.serializers.has(_className)) {
-            //a serializer already exists
+            // a serializer already exists
 
             console.warn(`Serializer for class '${_className}' already exists, ignoring request`);
 
@@ -67,9 +75,11 @@ export class BinarySerializationRegistry {
     /**
      *
      * @param {string} className
-     * @returns {BinaryClassSerializationAdapter}
+     * @returns {BinaryClassSerializationAdapter|undefined}
      */
     removeAdapter(className) {
+        assert.isString(className, 'className');
+
         const adapter = this.serializers.get(className);
 
         if (adapter !== undefined) {
@@ -85,6 +95,8 @@ export class BinarySerializationRegistry {
      * @returns {BinaryClassSerializationAdapter|undefined}
      */
     getAdapter(className) {
+        assert.isString(className, 'className');
+
         return this.serializers.get(className);
     }
 
@@ -92,9 +104,13 @@ export class BinarySerializationRegistry {
      *
      * @param {string} className
      * @param {BinaryClassUpgrader} upgrader
-     * @returns {boolean}
+     * @returns {boolean} true iff added, false if already exists
      */
     registerUpgrader(className, upgrader) {
+        assert.isString(className, 'className');
+        assert.defined(upgrader, 'upgrader');
+        assert.notNull(upgrader, 'upgrader');
+        assert.equal(upgrader.isBinaryClassUpgrader, true, 'upgrader.isBinaryClassUpgrader !== true');
 
         if (upgrader.getStartVersion() === upgrader.getTargetVersion()) {
             throw new Error(`Upgrader for '${className}' start(=${upgrader.getStartVersion()}) and target(=${upgrader.getTargetVersion()}) versions are the same, must be different`);
@@ -113,13 +129,13 @@ export class BinarySerializationRegistry {
         }
 
         if (classUpgraders.hasNode(upgrader)) {
-            //upgrader already registered
+            // upgrader already registered
             return false;
         }
 
         classUpgraders.addNode(upgrader);
 
-        //find other upgraders that would connect to this upgrader
+        // find other upgraders that would connect to this upgrader
         classUpgraders.traverseNodes(u => {
             if (u === upgrader) {
                 return;
@@ -143,6 +159,10 @@ export class BinarySerializationRegistry {
      * @returns {BinaryClassUpgrader[]|null} sequential shortest chain of upgraders or null if no valid chain exists
      */
     getUpgradersChain(className, startVersion, goalVersion) {
+        assert.isString(className, 'className');
+        assert.isNumber(startVersion, 'startVersion');
+        assert.isNumber(goalVersion, 'goalVersion');
+
         if (startVersion === goalVersion) {
             //already at the goal version
             return [];

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

@@ -1,3 +1,8 @@
+/**
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
 export class BinaryCollectionDeSerializer {
     /**
      * @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":"AAmBA;IAEQ;;;OAGG;IACH,iBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;;OAIG;IACH,4BAAgC;IAChC;;;;OAIG;IACH,0BAA8B;IAE9B;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,gBAAmB;IAEnB;;;OAGG;IACH,kBAAqB;IAErB;;;;OAIG;IACH,yBAA0C;IAC1C;;;;OAIG;IACH,yBAA0C;IAE1C;;;OAGG;IACH,cAA0B;IAI9B;;;OAGG;IACH,sBAFW,2BAA2B,QAOrC;IAED;;;OAGG;IACH,eAFa,2BAA2B,CAIvC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,KAAK,CAAC,CAAC,CAAC,GAAC,IAAI,CAUzB;IAED;;;OAGG;IACH,wCAFW,CAAS,IAAM,EAAN,MAAM,EAAC,IAAK,EAAL,KAAK,EAAE,IAA+B,EAA/B,+BAA+B,KAAE,EAAE,QAgFpE;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH,KAHa,CAAC,KACD;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CA8DnC;CAEJ;6BApV4B,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,sBAFW,2BAA2B,QAOrC;IAED;;;OAGG;IACH,eAFa,2BAA2B,CAIvC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,KAAK,CAAC,CAAC,CAAC,GAAC,IAAI,CAUzB;IAED;;;OAGG;IACH,wCAFW,CAAS,IAAM,EAAN,MAAM,EAAC,IAAK,EAAL,KAAK,EAAE,IAA+B,EAA/B,+BAA+B,KAAE,EAAE,QAgFpE;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH,KAHa,CAAC,KACD;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CA8DnC;CAEJ;6BAvV4B,4CAA4C"}

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

@@ -16,83 +16,86 @@ const State = {
     Ready: 1
 };
 
-
+/**
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
 export class BinaryCollectionDeSerializer {
-    constructor() {
-        /**
-         * @private
-         * @type {BinarySerializationRegistry}
-         */
-        this.registry = null;
-
-        /**
-         * @private
-         * @type {BinaryBuffer}
-         */
-        this.buffer = null;
-
-        /**
-         *
-         * @type {boolean}
-         * @private
-         */
-        this.__dictionaryEnabled = false;
-        /**
-         *
-         * @type {boolean}
-         * @private
-         */
-        this.__upgradeRequired = false;
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.elementCount = 0;
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.elementIndex = 0;
 
-        /**
-         * @private
-         * @type {number}
-         */
-        this.startAddress = 0;
-
-        /**
-         * @private
-         * @type {BinaryClassSerializationAdapter}
-         */
-        this.adapter = null;
-
-        /**
-         * @private
-         * @type {BinaryClassUpgrader[]}
-         */
-        this.upgraders = null;
-
-        /**
-         *
-         * @type {BinaryBuffer}
-         * @private
-         */
-        this.__upgradeBuffer0 = new BinaryBuffer();
-        /**
-         *
-         * @type {BinaryBuffer}
-         * @private
-         */
-        this.__upgradeBuffer1 = new BinaryBuffer();
-
-        /**
-         * @private
-         * @type {State}
-         */
-        this.state = State.Initial;
-    }
+    /**
+     * @private
+     * @type {BinarySerializationRegistry}
+     */
+    registry = null;
+
+    /**
+     * @private
+     * @type {BinaryBuffer}
+     */
+    buffer = null;
+
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    __dictionaryEnabled = false;
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    __upgradeRequired = false;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    elementCount = 0;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    elementIndex = 0;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    startAddress = 0;
+
+    /**
+     * @private
+     * @type {BinaryClassSerializationAdapter}
+     */
+    adapter = null;
+
+    /**
+     * @private
+     * @type {BinaryClassUpgrader[]}
+     */
+    upgraders = null;
+
+    /**
+     *
+     * @type {BinaryBuffer}
+     * @private
+     */
+    __upgradeBuffer0 = new BinaryBuffer();
+    /**
+     *
+     * @type {BinaryBuffer}
+     * @private
+     */
+    __upgradeBuffer1 = new BinaryBuffer();
+
+    /**
+     * @private
+     * @type {State}
+     */
+    state = State.Initial;
 
 
     /**

package/src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.d.ts

@@ -1,10 +1,10 @@
 /**
- * Upgrade binary data by executing a sequnece of upgraders on it
+ * Upgrade binary data by executing a sequence of upgraders on it
  * @param {BinaryClassUpgrader[]} upgraders
- * @param {BinaryBuffer} buffer
+ * @param {BinaryBuffer} buffer input data
  * @param {BinaryBuffer} tempBuffer0
  * @param {BinaryBuffer} tempBuffer1
- * @return {BinaryBuffer} new buffer with upgraded data
+ * @return {BinaryBuffer} buffer with upgraded data, this will be either {@link tempBuffer0} or {@link tempBuffer1}
  */
 export function executeBinaryClassUpgraderChain(upgraders: BinaryClassUpgrader[], buffer: BinaryBuffer, tempBuffer0: BinaryBuffer, tempBuffer1: BinaryBuffer): BinaryBuffer;
 //# sourceMappingURL=executeBinaryClassUpgraderChain.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"executeBinaryClassUpgraderChain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,2DANW,mBAAmB,EAAE,UACrB,YAAY,eACZ,YAAY,eACZ,YAAY,GACX,YAAY,CAqCvB"}
+{"version":3,"file":"executeBinaryClassUpgraderChain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,2DANW,mBAAmB,EAAE,UACrB,YAAY,eACZ,YAAY,eACZ,YAAY,GACX,YAAY,CA2CvB"}

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

@@ -1,16 +1,22 @@
 import { assert } from "../../../../core/assert.js";
 
 /**
- * Upgrade binary data by executing a sequnece of upgraders on it
+ * Upgrade binary data by executing a sequence of upgraders on it
  * @param {BinaryClassUpgrader[]} upgraders
- * @param {BinaryBuffer} buffer
+ * @param {BinaryBuffer} buffer input data
  * @param {BinaryBuffer} tempBuffer0
  * @param {BinaryBuffer} tempBuffer1
- * @return {BinaryBuffer} new buffer with upgraded data
+ * @return {BinaryBuffer} buffer with upgraded data, this will be either {@link tempBuffer0} or {@link tempBuffer1}
  */
-export function executeBinaryClassUpgraderChain(upgraders, buffer, tempBuffer0, tempBuffer1) {
-    assert.ok(Array.isArray(upgraders), 'upgraders must be an array, instead was something else');
-    assert.defined(buffer);
+export function executeBinaryClassUpgraderChain(
+    upgraders,
+    buffer,
+    tempBuffer0,
+    tempBuffer1
+) {
+    assert.isArray(upgraders, 'upgraders');
+    assert.defined(buffer, 'buffer');
+
     assert.defined(tempBuffer0);
     assert.defined(tempBuffer1);
 

package/src/engine/ecs/transform/Transform.d.ts

@@ -4,7 +4,6 @@
  * It has properties for position (like coordinates), rotation (how it's turned), and scale (how big it is).
  *
  * It also uses a "matrix" (a table of numbers) internally to efficiently store and calculate transformations, but you usually interact with the position, rotation, and scale directly.
- * @class
  */
 export class Transform {
     /**

package/src/engine/ecs/transform/Transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH;IA0QI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAiFD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IAjYD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;;;OAKG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;;;;;;;;;;;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;OAIG;IACH,gBAHW,SAAS,GACP,IAAI,CAIhB;IAED;;;;;OAKG;IACH,sBAJW,SAAS,KACT,SAAS,GACP,IAAI,CAShB;IAED;;;;OAIG;IACH,oBAHW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,GACxB,IAAI,CAkBhB;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBA/ZI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH;IA0QI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAiFD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IAjYD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;;;OAKG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;;;;;;;;;;;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;OAIG;IACH,gBAHW,SAAS,GACP,IAAI,CAIhB;IAED;;;;;OAKG;IACH,sBAJW,SAAS,KACT,SAAS,GACP,IAAI,CAShB;IAED;;;;OAIG;IACH,oBAHW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,GACxB,IAAI,CAkBhB;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBA9ZI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}

package/src/engine/ecs/transform/Transform.js

@@ -26,7 +26,6 @@ const FLAGS_DEFAULT = TransformFlags.AutomaticChangeDetection;
  * It has properties for position (like coordinates), rotation (how it's turned), and scale (how big it is).
  *
  * It also uses a "matrix" (a table of numbers) internally to efficiently store and calculate transformations, but you usually interact with the position, rotation, and scale directly.
- * @class
  */
 export class Transform {
 

package/src/engine/graphics/texture/sampler/Sampler2D.d.ts

@@ -2,6 +2,8 @@
  * Data Texture class, providing an abstraction around 2d numerical arrays, mostly for sampling purposes
  * Inspired by OpenGL's glsl sampler2d API
  * @class
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class Sampler2D {
     /**

package/src/engine/graphics/texture/sampler/Sampler2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sampler2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/sampler/Sampler2D.js"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH;IAi7BI;;;;;;OAMG;IACH,8BALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,uBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,wBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,wBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,sBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,uBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,uBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,yBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IAED;;;;;;OAMG;IACH,yBALW,GAAG,SACH,GAAG,UACH,GAAG,GACF,SAAS,CAKpB;IA1hCD;;;;;;;OAOG;IACH,mBANW,SAAS,CAAC,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,iBAAiB,GAAC,UAAU,GAAC,WAAW,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,GAAC,UAAU,GAAC,YAAY,GAAC,YAAY,aACzI,MAAM,UACN,MAAM,WACN,MAAM,EAmDhB;IA7BG;;;OAGG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,QAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,MAFU,MAAM,EAAE,GAAC,iBAAiB,GAAC,UAAU,GAAC,WAAW,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,GAAC,UAAU,GAAC,YAAY,GAAC,YAAY,CAEjH;IAEhB;;;OAGG;IACH,SAFU,MAAM,CAEA;IAGpB;;;;;OAKG;IACH,sBAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,QAQlB;IAED;;;;;;OAMG;IACH,6BALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CAOlB;IAED;;;;;;;OAOG;IACH,2BALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CA2DlB;IAED;;;;;OAKG;IACH,mBAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,QAQlB;IAED;;;;;;OAMG;IACH,iBALW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,QAUhB;IAED;;;;;;OAMG;IACH,0BALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CAOlB;IAED;;;;;;;OAOG;IACH,wBALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CAgFlB;IAED;;;;;;OAMG;IACH,oBALW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,GAAC,YAAY,kBACrB,MAAM,QAUhB;IAED;;;;;;OAMG;IACH,kBALW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,kBAClC,MAAM,QAWhB;IAED;;;;;;OAMG;IACH,2BALW,MAAM,KACN,MAAM,WACN,MAAM,GACL,MAAM,CAOjB;IAED;;;;;;OAMG;IACH,yBALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CAiFlB;IAED;;;;;OAKG;IACH,mBAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,GAAC,SAAS,CAAC,MAAM,CAAC,QAcpC;IAED;;;;;;OAMG;IACH,eALW,MAAM,KACN,MAAM,WACN,MAAM,GACJ,MAAM,CAalB;IAED;;;;;OAKG;IACH,QAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,QAalB;IAED;;;;;OAKG;IACH,SAJW,MAAM,KACN,MAAM,SACN,MAAM,EAAE,GAAC,SAAS,CAAC,MAAM,CAAC,QAepC;IAED;;;;;OAKG;IACH,eAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,mBAHW,MAAM,UACN,OAAO,QASjB;IAED;;;;;;;;;OASG;IACH,aARW,SAAS,qHAoDnB;IAGD;;;;;;;OAOG;IACH,oEA8BC;IAED;;;;OAIG;IACH,2BAHW,MAAM,SACN,MAAM,QAYhB;IAED;;;;;;;OAOG;IACH,QANW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,SACN,KAAK,CAAE,MAAM,CAAC,QAqCxB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,KACN,MAAM,WACN,MAAM,SACN,MAAM,QAqBhB;IAGD;;;;;;;OAOG;IACH,wBALW,MAAM,WACN,MAAM,UACN,MAAM,sBAyBhB;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,iBACN,OAAO,QAyDjB;IAED;;;OAGG;IACH,mBAFY,MAAM,CAejB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACR,OAAO,CAiBlB;IAED;;;OAGG;IACH,QAFY,MAAM,CAgCjB;IAGD;;OAEG;IACH,SAFa,SAAS,CAerB;IAED;;;;;;MAUC;IAED;;;;;;aAwBC;IAgHL;;;OAGG;IACH,sBAFU,OAAO,CAEc;CAN9B;;kBAUS,MAAM"}
+{"version":3,"file":"Sampler2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/sampler/Sampler2D.js"],"names":[],"mappings":"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"}

package/src/engine/graphics/texture/sampler/Sampler2D.js

@@ -23,6 +23,8 @@ import { computeHashFloat } from "../../../../core/primitives/numbers/computeHas
  * Data Texture class, providing an abstraction around 2d numerical arrays, mostly for sampling purposes
  * Inspired by OpenGL's glsl sampler2d API
  * @class
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class Sampler2D {
     /**

package/src/engine/input/devices/InputDeviceSwitch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputDeviceSwitch.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/InputDeviceSwitch.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IAEI;;;;OAIG;IACH,eAFU,MAAQ,CAEC;IAEnB;;;;OAIG;IACH,aAFU,MAAQ,CAED;IAEjB;;;;OAIG;IACH,SAFU,OAAO,CAEF;IAEf;;;OAGG;IACH,aAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;OAIG;IACH,gBAOC;CACJ;mBA/DkB,uCAAuC"}
+{"version":3,"file":"InputDeviceSwitch.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/InputDeviceSwitch.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH;IAEI;;;;OAIG;IACH,eAFU,MAAQ,CAEC;IAEnB;;;;OAIG;IACH,aAFU,MAAQ,CAED;IAEjB;;;;OAIG;IACH,SAFU,OAAO,CAEF;IAEf;;;OAGG;IACH,aAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;OAIG;IACH,gBAOC;CACJ;mBAlEkB,uCAAuC"}

package/src/engine/input/devices/InputDeviceSwitch.js

@@ -2,6 +2,9 @@ import Signal from "../../../core/events/signal/Signal.js";
 
 /**
  * Representation of an input device key/button
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class InputDeviceSwitch {
 

package/src/engine/input/devices/KeyboardDevice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyboardDevice.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/KeyboardDevice.js"],"names":[],"mappings":";AAYA;;;;GAIG;AACH;IA4BI;;;OAGG;IACH,wBAHW,WAAW,GAAC,OAAO,EAgC7B;IA3DD;;OAEG;IACH;QACI;;;WAGG;cADO,MAAM,CAAC,aAAa,CAAC;QAG/B;;;WAGG;YADO,MAAM,CAAC,aAAa,CAAC;MAGjC;IAEF;;;;;;;OAOG;IACH,mBAAU;IAkBN;;;OAGG;IACH,YAFU,WAAW,CAEO;IA8FhC;;;OAGG;IACH,SAFa,IAAI,CAMhB;IAED;;;OAGG;IACH,QAFa,IAAI,CAMhB;;CAEJ;mBAnLkB,uCAAuC"}
+{"version":3,"file":"KeyboardDevice.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/KeyboardDevice.js"],"names":[],"mappings":";AAYA;;;;;;;;GAQG;AACH;IA4BI;;;OAGG;IACH,wBAHW,WAAW,GAAC,OAAO,EAgC7B;IA3DD;;OAEG;IACH;QACI;;;WAGG;cADO,MAAM,CAAC,aAAa,CAAC;QAG/B;;;WAGG;YADO,MAAM,CAAC,aAAa,CAAC;MAGjC;IAEF;;;;;;;OAOG;IACH,mBAAU;IAkBN;;;OAGG;IACH,YAFU,WAAW,CAEO;IA8FhC;;;OAGG;IACH,SAFa,IAAI,CAMhB;IAED;;;OAGG;IACH,QAFa,IAAI,CAMhB;;CAEJ;mBAvLkB,uCAAuC"}

package/src/engine/input/devices/KeyboardDevice.js

@@ -13,7 +13,11 @@ const codeToKeyNameMap = [];
 /**
  * Provides keyboard input.
  * Listens for key events on a DOM element and provides signals and state for key presses.
- * NOTE: when losing focus of the application, any "pressed" keys will be automatically released. For example, if you hold "A" and click over into another application window - A will be forcibly released with appropriate signal
+ * NOTE: when losing focus of the application, any "pressed" keys will be automatically released.
+ * For example, if you hold "A" and click over into another application window - A will be forcibly released with appropriate signal.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 class KeyboardDevice {
 

package/src/engine/input/devices/PointerDevice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PointerDevice.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/PointerDevice.js"],"names":[],"mappings":"AA2LA;;;;;GAKG;AACH,mDAJW,OAAO,SACP,UAAU,GAAC,KAAK,WAChB,OAAO,QAejB;AAED;;GAEG;AACH;IAiFI;;;;OAIG;IACH,wBAHW,WAAW,EAsBrB;IAvGD;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;IAIzB;;OAEG;IACH;;;;QAII;;WAEG;aADO,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,GAAC,UAAU,CAAC,CAAC;;;;;;;;MAUpD;IAeF;;;OAGG;IACH,kBAAkB;IAElB;;;;OAIG;IACH,kBAFU,iBAAiB,EAAE,CAEL;IAExB;;;OAGG;IACH,uBAFa,iBAAiB,CAI7B;IAED;;;OAGG;IACH,wBAFa,iBAAiB,CAI7B;IAED;;;OAGG;IACH,yBAFa,iBAAiB,CAI7B;IAyGD;;;OAGG;IACH,oBAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,mBAFW,OAAO,EAwBjB;IAED,kBA1BW,OAAO,CA4BjB;IAED;;;;OAIG;IACH,qCAHW,OAAO,SACP,UAAU,GAAC,KAAK,QAI1B;IAED,cA6BC;IAED,aAsBC;;CACJ;oBAhfmB,+BAA+B;mBADhC,uCAAuC;kCAOxB,wBAAwB"}
+{"version":3,"file":"PointerDevice.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/PointerDevice.js"],"names":[],"mappings":"AA2LA;;;;;GAKG;AACH,mDAJW,OAAO,SACP,UAAU,GAAC,KAAK,WAChB,OAAO,QAejB;AAED;;;;;GAKG;AACH;IAiFI;;;;OAIG;IACH,wBAHW,WAAW,EAsBrB;IAvGD;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;IAIzB;;OAEG;IACH;;;;QAII;;WAEG;aADO,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,GAAC,UAAU,CAAC,CAAC;;;;;;;;MAUpD;IAeF;;;OAGG;IACH,kBAAkB;IAElB;;;;OAIG;IACH,kBAFU,iBAAiB,EAAE,CAEL;IAExB;;;OAGG;IACH,uBAFa,iBAAiB,CAI7B;IAED;;;OAGG;IACH,wBAFa,iBAAiB,CAI7B;IAED;;;OAGG;IACH,yBAFa,iBAAiB,CAI7B;IAyGD;;;OAGG;IACH,oBAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,mBAFW,OAAO,EAwBjB;IAED,kBA1BW,OAAO,CA4BjB;IAED;;;;OAIG;IACH,qCAHW,OAAO,SACP,UAAU,GAAC,KAAK,QAI1B;IAED,cA6BC;IAED,aAsBC;;CACJ;oBAnfmB,+BAA+B;mBADhC,uCAAuC;kCAOxB,wBAAwB"}

package/src/engine/input/devices/PointerDevice.js

@@ -208,6 +208,9 @@ export function readPositionFromMouseEvent(result, event, source = event.target)
 
 /**
  * Abstracts Mouse and Touch interfaces as single "pointer" device.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class PointerDevice {
 

package/src/engine/intelligence/behavior/Behavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Behavior.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/Behavior.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,sBAFa,GAAG;IAIZ;;;;OAIG;IACH,SAFU,GAAG,GAAC,IAAI,CAEH;IAEf;;;;OAIG;IACH,wBAFU,MAAM,CAAC,IAAI,EAAC,GAAG,CAAC,CAEG;IAE7B;;;;OAIG;IACH,sBAFU,MAAM,CAAC,IAAI,CAAC,CAEK;IAE3B;;;;OAIG;IACH,gBAHW,MAAM,GACJ,cAAc,CAI1B;IAED;;;;;OAKG;IACH,qBAFW,GAAG,QAKb;IAED;;;;OAIG;IACH,iBAGC;IAGL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B;;kBAYS,MAAM;;mBAxEG,uCAAuC;+BAD3B,qBAAqB"}
+{"version":3,"file":"Behavior.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/Behavior.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,sBAJa,GAAG;IAMZ;;;;OAIG;IACH,SAFU,GAAG,GAAC,IAAI,CAEH;IAEf;;;;OAIG;IACH,wBAFU,MAAM,CAAC,IAAI,EAAC,GAAG,CAAC,CAEG;IAE7B;;;;OAIG;IACH,sBAFU,MAAM,CAAC,IAAI,CAAC,CAEK;IAE3B;;;;OAIG;IACH,gBAHW,MAAM,GACJ,cAAc,CAI1B;IAED;;;;;OAKG;IACH,qBAFW,GAAG,QAKb;IAED;;;;OAIG;IACH,iBAGC;IAGL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B;;kBAYS,MAAM;;mBA3EG,uCAAuC;+BAC3B,qBAAqB"}

package/src/engine/intelligence/behavior/Behavior.js

@@ -1,11 +1,13 @@
-import { BehaviorStatus } from "./BehaviorStatus.js";
 import Signal from "../../../core/events/signal/Signal.js";
+import { BehaviorStatus } from "./BehaviorStatus.js";
 
 /**
  * Base class of behavior tree implementation
  * @see "The Behavior Tree Starter Kit" by Alex J. Champandard and Philip Dunstan
  * @see https://en.wikipedia.org/wiki/Behavior_tree_(artificial_intelligence,_robotics_and_control)
  * @template CTX
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class Behavior {
 

package/src/engine/intelligence/behavior/SelectorBehavior.d.ts

@@ -1,5 +1,7 @@
 /**
  * Will try every child behaviour in order until one succeeds or if all fail - the selector behavior will fail too
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class SelectorBehavior extends CompositeBehavior {
     /**

package/src/engine/intelligence/behavior/SelectorBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectorBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/SelectorBehavior.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IAmBI;;;;OAIG;IACH,sBAHW,QAAQ,EAAE,GACR,gBAAgB,CAU5B;IA5BG;;;;OAIG;IACH,2BAA8B;IAE9B;;;;OAIG;IACH,gCAAiC;IAkBrC,0BAgCC;IAWD,+BAoBC;CACJ;kCAvGiC,kCAAkC"}
+{"version":3,"file":"SelectorBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/SelectorBehavior.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IAmBI;;;;OAIG;IACH,sBAHW,QAAQ,EAAE,GACR,gBAAgB,CAU5B;IA5BG;;;;OAIG;IACH,2BAA8B;IAE9B;;;;OAIG;IACH,gCAAiC;IAkBrC,0BAgCC;IAWD,+BAoBC;CACJ;kCAzGiC,kCAAkC"}

package/src/engine/intelligence/behavior/SelectorBehavior.js

@@ -4,6 +4,8 @@ import { CompositeBehavior } from "./composite/CompositeBehavior.js";
 
 /**
  * Will try every child behaviour in order until one succeeds or if all fail - the selector behavior will fail too
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class SelectorBehavior extends CompositeBehavior {
     constructor() {

package/src/engine/intelligence/behavior/behavior_to_dot.d.ts

@@ -2,6 +2,10 @@
  * Produces a diagram of behavior tree in DOT format, useful for debugging and exploration of complex trees
  *
  * @see https://en.wikipedia.org/wiki/DOT_(graph_description_language)
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ *
  * @param {Behavior} behavior
  * @returns {string}
  */

package/src/engine/intelligence/behavior/behavior_to_dot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behavior_to_dot.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/behavior_to_dot.js"],"names":[],"mappings":"AAoOA;;;;;;GAMG;AACH,0DAFa,MAAM,CA2BlB;yBAnQwB,eAAe"}
+{"version":3,"file":"behavior_to_dot.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/behavior_to_dot.js"],"names":[],"mappings":"AAoOA;;;;;;;;;;GAUG;AACH,0DAFa,MAAM,CA2BlB;yBAvQwB,eAAe"}

package/src/engine/intelligence/behavior/behavior_to_dot.js

@@ -230,6 +230,10 @@ function parse_behavior(out, behavior, context) {
  * Produces a diagram of behavior tree in DOT format, useful for debugging and exploration of complex trees
  *
  * @see https://en.wikipedia.org/wiki/DOT_(graph_description_language)
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ *
  * @param {Behavior} behavior
  * @returns {string}
  */