@woosh/meep-engine 2.124.8 → 2.124.10

package/LICENSE

@@ -7,6 +7,7 @@ For illustration purposes, this means that unless you have obtained a license, a
     * You are NOT permitted to re-distribute this package
     * You are NOT permitted to extend the code from this package
     * You are NOT permitted to make use of this package for any purpose, commercial or otherwise
+    * You are NOT permitted to copy any parts of the source code
 
 If you would like to use this package in any context, please contact me via email so we can arrange a license:
 

package/package.json

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

package/src/core/model/ObservedBoolean.d.ts

@@ -43,9 +43,11 @@ declare class ObservedBoolean extends Boolean {
     hashCode(): number;
     /**
      *
-     * @param {function(boolean)} f
+     * @param {function(boolean,boolean)} f
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(f: (arg0: boolean) => any): void;
+    process(f: (arg0: boolean, arg1: boolean) => any, thisArg?: any): this;
     /**
      *
      * @returns {Boolean}

package/src/core/model/ObservedBoolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedBoolean.js"],"names":[],"mappings":";AAGA;IAQI;;;;OAIG;IACH,mBAHW,OAAO,EAcjB;IAtBD;;;OAGG;IACH,oBAFU,MAAM,CAAC,OAAO,EAAC,OAAO,CAAC,CAER;IAYrB;;;;OAIG;IACH,gBAAoB;IAmBxB;;;;OAIG;IACH,WAHW,OAAO,GACL,eAAe,CAa3B;IAED,gBAEC;IAED,iBAEC;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFY,MAAM,CAIjB;IAED;;;OAGG;IACH,WAFW,CAAS,IAAO,EAAP,OAAO,QAAC,QAK3B;IAED;;;OAGG;IACH,oBAEC;IAED;;OAEG;IACH,eAEC;IAED,kBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAeL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAlB1C;;eAIS,eAAe;cAMf,eAAe;;mBAzJN,4BAA4B"}
+{"version":3,"file":"ObservedBoolean.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedBoolean.js"],"names":[],"mappings":";AAGA;IAQI;;;;OAIG;IACH,mBAHW,OAAO,EAcjB;IAtBD;;;OAGG;IACH,oBAFU,MAAM,CAAC,OAAO,EAAC,OAAO,CAAC,CAER;IAYrB;;;;OAIG;IACH,gBAAoB;IAmBxB;;;;OAIG;IACH,WAHW,OAAO,GACL,eAAe,CAa3B;IAED,gBAEC;IAED,iBAEC;IAED;;;OAGG;IACH,YAFW,eAAe,QAIzB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFY,MAAM,CAIjB;IAED;;;;;OAKG;IACH,WAJW,CAAS,IAAO,EAAP,OAAO,EAAC,IAAO,EAAP,OAAO,QAAC,YACzB,GAAC,GACC,IAAI,CAWhB;IAED;;;OAGG;IACH,oBAEC;IAED;;OAEG;IACH,eAEC;IAED,kBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAKtB;IAeL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAlB1C;;eAIS,eAAe;cAMf,eAAe;;mBAjKN,4BAA4B"}

package/src/core/model/ObservedBoolean.js

@@ -96,11 +96,19 @@ class ObservedBoolean extends Boolean {
 
     /**
      *
-     * @param {function(boolean)} f
+     * @param {function(boolean,boolean)} f
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(f) {
-        f(this.__value);
-        this.onChanged.add(f);
+    process(f, thisArg) {
+
+        this.onChanged.add(f, thisArg);
+
+        const v = this.__value;
+
+        f.call(thisArg, v, v);
+
+        return this;
     }
 
     /**

package/src/core/model/ObservedEnum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedEnum.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedEnum.js"],"names":[],"mappings":";AAGA;IACI;;;;;OAKG;IACH,mBAJW,CAAC;;OAiBX;IATG;;;;OAIG;IACH,gBAAoB;IACpB;;MAA0B;IAE1B,0DAA6B;IAGjC;;;OAGG;IACH;;MAEC;IAED;;;;OAIG;IACH,WAHW,CAAC,GACC,YAAY,CAYxB;IAED;;;;OAIG;IACH,OAJa,CAAC,SACH,YAAY,CAAC,CAAC,CAAC,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFW,YAAY,QAItB;IAED;;;OAGG;IACH,YAFa,CAAC,CAIb;IAED,eAEC;IAED;;;OAGG;IACH,mBAFW,CAAS,IAAC,EAAD,CAAC,EAAC,IAAC,EAAD,CAAC,QAAC,QAMvB;IAED,YAEC;IAED,yBAEC;CACJ;mBA/FkB,4BAA4B"}
+{"version":3,"file":"ObservedEnum.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedEnum.js"],"names":[],"mappings":";AAGA;IACI;;;;;OAKG;IACH,mBAJW,CAAC;;OAiBX;IATG;;;;OAIG;IACH,gBAAoB;IACpB;;MAA0B;IAE1B,0DAA6B;IAGjC;;;OAGG;IACH;;MAEC;IAED;;;;OAIG;IACH,WAHW,CAAC,GACC,YAAY,CAYxB;IAED;;;;OAIG;IACH,OAJa,CAAC,SACH,YAAY,CAAC,CAAC,CAAC,GACb,OAAO,CAInB;IAED;;;OAGG;IACH,YAFW,YAAY,QAItB;IAED;;;OAGG;IACH,YAFa,CAAC,CAIb;IAED,eAEC;IAED;;;;;OAKG;IACH,mBAJW,CAAS,IAAC,EAAD,CAAC,EAAC,IAAC,EAAD,CAAC,QAAC,YACb,GAAC,GACC,IAAI,CAUhB;IAED,YAEC;IAED,yBAEC;CACJ;mBArGkB,4BAA4B"}

package/src/core/model/ObservedEnum.js

@@ -80,11 +80,17 @@ class ObservedEnum {
     /**
      *
      * @param {function(T,T)} processor
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(processor) {
-        this.onChanged.add(processor);
+    process(processor, thisArg) {
+        this.onChanged.add(processor, thisArg);
 
-        processor(this.__value, this.__value);
+        const v = this.__value;
+
+        processor.call(thisArg, v, v);
+
+        return this;
     }
 
     toJSON() {

package/src/core/model/ObservedString.d.ts

@@ -1,5 +1,14 @@
 export default ObservedString;
 /**
+ * Observable string container.
+ * Signals change via {@link onChanged}.
+ *
+ * @example
+ *  const name = new ObservedString("Alice")
+ *  name.onChanged((new_name, old_name) => console.log(`Name changed from ${old_name} to ${new_name}!`));
+ *  ...
+ *  name.set("Barbara"); // will print "Name changed from Alice to Barbara!" in console
+ *  name.getValue() === "Barbara"
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
@@ -7,20 +16,23 @@ export default ObservedString;
 declare class ObservedString extends String {
     /**
      *
-     * @param {string} [value]
-     * @constructor
+     * @param {string} [value=""]
      */
     constructor(value?: string);
     /**
      *
-     * @type {String}
+     * @type {string}
      * @private
      */
     private __value;
-    onChanged: Signal<any, any, any, any, any, any, any, any>;
     /**
      *
-     * @param {String} value
+     * @type {Signal<string,string>}
+     */
+    onChanged: Signal<string, string>;
+    /**
+     *
+     * @param {string} value
      * @returns {ObservedString}
      */
     set(value: string): ObservedString;
@@ -30,33 +42,41 @@ declare class ObservedString extends String {
      */
     copy(other: ObservedString): void;
     /**
-     *
-     * @param {ObservedString} other
-     * @returns {boolean}
+     * @return {ObservedString}
      */
-    equals(other: ObservedString): boolean;
+    clone(): ObservedString;
     /**
      *
-     * @returns {String}
+     * @returns {string}
      */
     getValue(): string;
     /**
      *
-     * @param {function} f
+     * @param {function(string,string)} f
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(f: Function): void;
-    toJSON(): string;
-    fromJSON(obj: any): void;
+    process(f: (arg0: string, arg1: string) => any, thisArg?: any): this;
     /**
-     *
+     * @deprecated use {@link buffer.writeUTF8String} directly instead
      * @param {BinaryBuffer} buffer
      */
     toBinaryBuffer(buffer: BinaryBuffer): void;
     /**
-     *
+     * @deprecated use {@link buffer.readUTF8String} directly instead
      * @param {BinaryBuffer} buffer
      */
     fromBinaryBuffer(buffer: BinaryBuffer): void;
+    /**
+     *
+     * @param {ObservedString} other
+     * @returns {boolean}
+     */
+    equals(other: ObservedString): boolean;
+    /**
+     *
+     * @return {number}
+     */
     hash(): number;
     /**
      * Used for optimized "instanceof" check
@@ -64,6 +84,11 @@ declare class ObservedString extends String {
      * @type {boolean}
      */
     readonly isObservedString: boolean;
+    toJSON: () => string;
+    fromJSON: (value: string) => ObservedString;
+}
+declare namespace ObservedString {
+    let typeName: string;
 }
 import Signal from "../events/signal/Signal.js";
 //# sourceMappingURL=ObservedString.d.ts.map

package/src/core/model/ObservedString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedString.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedString.js"],"names":[],"mappings":";AAIA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,oBAHW,MAAM,EAgBhB;IARG;;;;OAIG;IACH,gBAAoB;IAEpB,0DAA6B;IAmBjC;;;;OAIG;IACH,oBAFa,cAAc,CAa1B;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAInB;IAED;;;OAGG;IACH,mBAEC;IAED;;;OAGG;IACH,2BAIC;IAED,iBAEC;IAED,yBAEC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAMtB;IAED,eAEC;IAGL;;;;OAIG;IACH,2BAFU,OAAO,CAEwB;CAPxC;mBA/HkB,4BAA4B"}
+{"version":3,"file":"ObservedString.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedString.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;GAaG;AACH;IACI;;;OAGG;IACH,oBAFW,MAAM,EAmBhB;IAZG;;;;OAIG;IACH,gBAAoB;IAEpB;;;OAGG;IACH,WAFU,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAEF;IAmBjC;;;;OAIG;IACH,WAHW,MAAM,GACJ,cAAc,CAa1B;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;OAEG;IACH,SAFY,cAAc,CAQzB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,WAJW,CAAS,IAAM,EAAN,MAAM,EAAC,IAAM,EAAN,MAAM,QAAC,YACvB,GAAC,GACC,IAAI,CAUhB;IAED;;;OAGG;IACH,uBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAMtB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAGL;;;;OAIG;IACH,2BAFU,OAAO,CAEwB;IAUzC,cAtHiB,MAAM,CAsHQ;IAC/B,kBA/Ge,MAAM,KACJ,cAAc,CA8GE;CAlBhC;;kBAWS,MAAM;;mBAnKG,4BAA4B"}

package/src/core/model/ObservedString.js

@@ -3,6 +3,15 @@ import Signal from "../events/signal/Signal.js";
 import { computeStringHash } from "../primitives/strings/computeStringHash.js";
 
 /**
+ * Observable string container.
+ * Signals change via {@link onChanged}.
+ *
+ * @example
+ *  const name = new ObservedString("Alice")
+ *  name.onChanged((new_name, old_name) => console.log(`Name changed from ${old_name} to ${new_name}!`));
+ *  ...
+ *  name.set("Barbara"); // will print "Name changed from Alice to Barbara!" in console
+ *  name.getValue() === "Barbara"
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
@@ -10,8 +19,7 @@ import { computeStringHash } from "../primitives/strings/computeStringHash.js";
 class ObservedString extends String {
     /**
      *
-     * @param {string} [value]
-     * @constructor
+     * @param {string} [value=""]
      */
     constructor(value = "") {
         super();
@@ -20,17 +28,21 @@ class ObservedString extends String {
 
         /**
          *
-         * @type {String}
+         * @type {string}
          * @private
          */
         this.__value = value;
 
+        /**
+         *
+         * @type {Signal<string,string>}
+         */
         this.onChanged = new Signal();
     }
 
     /**
      *
-     * @returns {String}
+     * @returns {string}
      */
     valueOf() {
         return this.__value;
@@ -38,7 +50,7 @@ class ObservedString extends String {
 
     /**
      *
-     * @returns {String}
+     * @returns {string}
      */
     toString() {
         return this.__value;
@@ -46,7 +58,7 @@ class ObservedString extends String {
 
     /**
      *
-     * @param {String} value
+     * @param {string} value
      * @returns {ObservedString}
      */
     set(value) {
@@ -71,17 +83,19 @@ class ObservedString extends String {
     }
 
     /**
-     *
-     * @param {ObservedString} other
-     * @returns {boolean}
+     * @return {ObservedString}
      */
-    equals(other) {
-        return this.__value === other.__value;
+    clone() {
+        const r = new this.constructor();
+
+        r.copy(this);
+
+        return r;
     }
 
     /**
      *
-     * @returns {String}
+     * @returns {string}
      */
     getValue() {
         return this.__value;
@@ -89,24 +103,22 @@ class ObservedString extends String {
 
     /**
      *
-     * @param {function} f
+     * @param {function(string,string)} f
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(f) {
-        f(this.getValue());
+    process(f, thisArg) {
+        this.onChanged.add(f, thisArg);
 
-        this.onChanged.add(f);
-    }
+        const v = this.getValue();
 
-    toJSON() {
-        return this.__value;
-    }
+        f.call(thisArg, v, v);
 
-    fromJSON(obj) {
-        this.set(obj);
+        return this;
     }
 
     /**
-     *
+     * @deprecated use {@link buffer.writeUTF8String} directly instead
      * @param {BinaryBuffer} buffer
      */
     toBinaryBuffer(buffer) {
@@ -114,7 +126,7 @@ class ObservedString extends String {
     }
 
     /**
-     *
+     * @deprecated use {@link buffer.readUTF8String} directly instead
      * @param {BinaryBuffer} buffer
      */
     fromBinaryBuffer(buffer) {
@@ -123,6 +135,19 @@ class ObservedString extends String {
         this.set(value);
     }
 
+    /**
+     *
+     * @param {ObservedString} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.__value === other.__value;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
     hash() {
         return computeStringHash(this.__value);
     }
@@ -135,4 +160,15 @@ class ObservedString extends String {
  */
 ObservedString.prototype.isObservedString = true;
 
+/**
+ * @readonly
+ * @type {string}
+ */
+ObservedString.typeName = "ObservedString";
+
+// JSON methods
+
+ObservedString.prototype.toJSON = ObservedString.prototype.toString;
+ObservedString.prototype.fromJSON = ObservedString.prototype.set;
+
 export default ObservedString;

package/src/core/model/ObservedValue.d.ts

@@ -49,9 +49,10 @@ declare class ObservedValue {
     /**
      * Convenience method, invoked given function with current value and registers onChanged callback
      * @param {function} processor
+     * @param {*} [thisArg]
      * @returns {ObservedValue.<T>}
      */
-    process(processor: Function): ObservedValue<T>;
+    process(processor: Function, thisArg?: any): ObservedValue<T>;
     toString(): string;
     toJSON(): T;
     fromJSON(value: any): void;

package/src/core/model/ObservedValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedValue.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedValue.js"],"names":[],"mappings":";AAEA;IACI;;;;;OAKG;IACH,eAHW,CAAC,EAWX;IAPG,0DAA6B;IAC7B,WAAgB;IAChB;;;OAGG;IACH,UAFU,CAAC,MAAY,CAAC,CAAC,CAEkB;IAG/C;;;OAGG;IACH,WAFW,CAAC,QAQX;IAED;;;;OAIG;IACH,iBAHW,CAAC,QAKX;IAED;;;OAGG;IACH,OAFa,CAAC,CAIb;IAED;;;OAGG;IACH,YAFW,aAAa,QAIvB;IAED;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,aAAa,CAAE,CAAC,CAAC,CAI7B;IAED;;;;OAIG;IACH,8BAFa,aAAa,CAAE,CAAC,CAAC,CAM7B;IAED,mBAIC;IAED,YAEC;IAED,2BAEC;CACJ;mBAjGkB,4BAA4B"}
+{"version":3,"file":"ObservedValue.d.ts","sourceRoot":"","sources":["../../../../src/core/model/ObservedValue.js"],"names":[],"mappings":";AAEA;IACI;;;;;OAKG;IACH,eAHW,CAAC,EAWX;IAPG,0DAA6B;IAC7B,WAAgB;IAChB;;;OAGG;IACH,UAFU,CAAC,MAAY,CAAC,CAAC,CAEkB;IAG/C;;;OAGG;IACH,WAFW,CAAC,QAQX;IAED;;;;OAIG;IACH,iBAHW,CAAC,QAKX;IAED;;;OAGG;IACH,OAFa,CAAC,CAIb;IAED;;;OAGG;IACH,YAFW,aAAa,QAIvB;IAED;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,aAAa,CAAE,CAAC,CAAC,CAI7B;IAED;;;;;OAKG;IACH,uCAHW,GAAC,GACC,aAAa,CAAE,CAAC,CAAC,CAU7B;IAED,mBAIC;IAED,YAEC;IAED,2BAEC;CACJ;mBAtGkB,4BAA4B"}

package/src/core/model/ObservedValue.js

@@ -74,11 +74,16 @@ class ObservedValue {
     /**
      * Convenience method, invoked given function with current value and registers onChanged callback
      * @param {function} processor
+     * @param {*} [thisArg]
      * @returns {ObservedValue.<T>}
      */
-    process(processor) {
-        processor(this.__value);
-        this.onChanged.add(processor);
+    process(processor, thisArg) {
+        this.onChanged.add(processor, thisArg);
+
+        const v = this.__value;
+
+        processor.call(thisArg, v, v);
+
         return this;
     }
 

package/src/core/model/reactive/model/ReactiveExpression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactiveExpression.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/reactive/model/ReactiveExpression.js"],"names":[],"mappings":"AAIA;;GAEG;AACH,gCAFa,CAAC;IAIN,0DAA6B;IAGjC,uBAEC;IAED,cAEC;IAED;;;;OAIG;IACH,wCAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;OAEG;IACH,YAFa,CAAC,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAInC;IAED;;;;OAIG;IACH,iCAFW,GAAC,QAIX;IAED;;;OAGG;IACH,mBAFY,MAAM,CAQjB;IAED;;;OAGG;IACH,iCAIC;IAED;;;;OAIG;IACH,sBAFa,OAAO,GAAC,MAAM,GAAC,MAAM,CAIjC;IAGL,cAAqC;IAErC;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CARhD;mBA/FkB,kCAAkC"}
+{"version":3,"file":"ReactiveExpression.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/reactive/model/ReactiveExpression.js"],"names":[],"mappings":"AAIA;;GAEG;AACH,gCAFa,CAAC;IAIV;;;OAGG;IACH,oBAFU,MAAM,CAAC,CAAC,EAAC,CAAC,CAAC,CAEI;IAGzB,uBAEC;IAED,cAEC;IAED;;;;OAIG;IACH,wCAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;OAEG;IACH,YAFa,CAAC,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAInC;IAED;;;;OAIG;IACH,iCAFW,GAAC,QAIX;IAED;;;OAGG;IACH,mBAFY,MAAM,CAQjB;IAED;;;;;OAKG;IACH,iBAJW,CAAS,IAAC,EAAD,CAAC,EAAC,IAAC,EAAD,CAAC,QAAC,YACb,GAAC,GACC,IAAI,CAUhB;IAED;;;;OAIG;IACH,sBAFa,OAAO,GAAC,MAAM,GAAC,MAAM,CAIjC;IAGL,cAAqC;IAErC;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CARhD;mBAzGkB,kCAAkC"}

package/src/core/model/reactive/model/ReactiveExpression.js

@@ -6,9 +6,13 @@ import { computeStringHash } from "../../../primitives/strings/computeStringHash
  * @template T
  */
 export class ReactiveExpression {
-    constructor() {
-        this.onChanged = new Signal();
-    }
+
+    /**
+     * @readonly
+     * @type {Signal<T,T>}
+     */
+    onChanged = new Signal();
+
 
     copy(other) {
         throw new Error('Not Implemented');
@@ -77,12 +81,18 @@ export class ReactiveExpression {
 
     /**
      *
-     * @param {function} handler
+     * @param {function(T,T)} handler
+     * @param {*} [thisArg]
+     * @returns {this}
      */
-    process(handler) {
-        handler(this.getValue());
+    process(handler, thisArg) {
+        this.onChanged.add(handler, thisArg);
+
+        const v = this.getValue();
+
+        handler.call(thisArg, v, v);
 
-        this.onChanged.add(handler);
+        return this;
     }
 
     /**

package/src/core/path/PATH_SEPARATOR.d.ts

@@ -1,2 +1,6 @@
-export const PATH_SEPARATOR: "/";
+/**
+ * Separator used for file paths and URLs
+ * @type {string}
+ */
+export const PATH_SEPARATOR: string;
 //# sourceMappingURL=PATH_SEPARATOR.d.ts.map

package/src/core/path/PATH_SEPARATOR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PATH_SEPARATOR.d.ts","sourceRoot":"","sources":["../../../../src/core/path/PATH_SEPARATOR.js"],"names":[],"mappings":"AAAA,6BAA8B,GAAG,CAAC"}
+{"version":3,"file":"PATH_SEPARATOR.d.ts","sourceRoot":"","sources":["../../../../src/core/path/PATH_SEPARATOR.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,6BAFU,MAAM,CAEkB"}

package/src/core/path/PATH_SEPARATOR.js

@@ -1 +1,5 @@
+/**
+ * Separator used for file paths and URLs
+ * @type {string}
+ */
 export const PATH_SEPARATOR = '/';

package/src/engine/ecs/guid/UUID.d.ts

@@ -15,7 +15,9 @@
  *  const id_b = UUID.v1();
  *
  *  id_a.equals(id_b); // false
-
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class UUID {
     /**

package/src/engine/ecs/guid/UUID.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IA2HI;;;OAGG;IACH,aAFY,IAAI,CAQf;IA2BD;;;OAGG;IACH,aAFa,IAAI,CAQhB;IAED;;;;OAIG;IACH,iBAFY,MAAM,CAIjB;IA6CD;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,CAQf;IAxOD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,UAAU,GAAC,SAAS,CAAC,MAAM,CAAC,EAO/C;IAED;;;OAGG;IACH,YAFa,UAAU,CAItB;IAED;;;;;;;;OAQG;IACH,eALY,MAAM,CAUjB;IAED;;;;OAIG;IACH,OAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,MAFa,IAAI,CAwEhB;IAcD;;;OAGG;IACH,MAFa,IAAI,CAqBhB;IAuBD;;;OAGG;IACH,cAFW,MAAM,QAuChB;IAeD;;;;;;OAMG;IACH,YAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,YAFW,IAAI,QAId;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAcnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAYlB;IAIL;;OAEG;IACH,uBA7EiB,MAAM,CA6EF;IAErB;;OAEG;IACH,4BA7Ie,MAAM,UA6IE;IAQvB;;;OAGG;IACH,iBAFU,OAAO,CAEI;;CAtBpB;;kBAcS,MAAM"}
+{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IA2HI;;;OAGG;IACH,aAFY,IAAI,CAQf;IA2BD;;;OAGG;IACH,aAFa,IAAI,CAQhB;IAED;;;;OAIG;IACH,iBAFY,MAAM,CAIjB;IA6CD;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,CAQf;IAxOD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,UAAU,GAAC,SAAS,CAAC,MAAM,CAAC,EAO/C;IAED;;;OAGG;IACH,YAFa,UAAU,CAItB;IAED;;;;;;;;OAQG;IACH,eALY,MAAM,CAUjB;IAED;;;;OAIG;IACH,OAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,MAFa,IAAI,CAwEhB;IAcD;;;OAGG;IACH,MAFa,IAAI,CAqBhB;IAuBD;;;OAGG;IACH,cAFW,MAAM,QAuChB;IAeD;;;;;;OAMG;IACH,YAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,YAFW,IAAI,QAId;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAcnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAYlB;IAIL;;OAEG;IACH,uBA7EiB,MAAM,CA6EF;IAErB;;OAEG;IACH,4BA7Ie,MAAM,UA6IE;IAQvB;;;OAGG;IACH,iBAFU,OAAO,CAEI;;CAtBpB;;kBAcS,MAAM"}

package/src/engine/ecs/guid/UUID.js

@@ -7,21 +7,21 @@ import { randomUint8 } from "../../../core/math/random/randomUint8.js";
 import { seededRandom } from "../../../core/math/random/seededRandom.js";
 
 // Previous uuid creation time
-let _lastMSecs = 0;
-let _lastNSecs = 0;
+let _last_milliseconds = 0;
+let _last_nanoseconds = 0;
 
 // seed random with current time to lower potential correlation
 const random = seededRandom(Date.now());
 
 // node and clockseq need to be initialized to random values.
-const _nodeId = new Uint8Array(6);
+const _node_id = new Uint8Array(6);
 
 // Per 4.5, create and 48-bit node id, (47 random bits + multicast bit = 1)
-randomBytes(_nodeId, 0, random, 6);
-_nodeId[0] |= 0x01;
+randomBytes(_node_id, 0, random, 6);
+_node_id[0] |= 0x01;
 
 // Per 4.2.2, randomize (14 bit) clockseq
-let _clockseq = ((randomUint8(random) << 8) | randomUint8(random)) & 0x3fff;
+let _clock_seq = ((randomUint8(random) << 8) | randomUint8(random)) & 0x3fff;
 
 /**
  * Universally Unique Identifier (UUID), a 128 bit label used to uniquely identify resources.
@@ -40,7 +40,9 @@ let _clockseq = ((randomUint8(random) << 8) | randomUint8(random)) & 0x3fff;
  *  const id_b = UUID.v1();
  *
  *  id_a.equals(id_b); // false
-
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class UUID {
     #data = new Uint8Array(16);
@@ -98,7 +100,7 @@ export class UUID {
 
         const b = this.#data;
 
-        let clockseq = _clockseq;
+        let clock_seq = _clock_seq;
 
         // UUID timestamps are 100 nano-second units since the Gregorian epoch,
         // (1582-10-15 00:00).  JSNumbers aren't precise enough for this, so
@@ -108,37 +110,37 @@ export class UUID {
 
         // Per 4.2.1.2, use count of uuid's generated during the current clock
         // cycle to simulate higher resolution clock
-        let nsecs = _lastNSecs + 1;
+        let nanoseconds = _last_nanoseconds + 1;
 
         // Time since last uuid creation (in msecs)
-        const dt = msecs - _lastMSecs + (nsecs - _lastNSecs) / 10000;
+        const dt = msecs - _last_milliseconds + (nanoseconds - _last_nanoseconds) / 10000;
 
         // Per 4.2.1.2, Bump clockseq on clock regression
         if (dt < 0) {
-            clockseq = (clockseq + 1) & 0x3fff;
+            clock_seq = (clock_seq + 1) & 0x3fff;
         }
 
         // Reset nsecs if clock regresses (new clockseq) or we've moved onto a new
         // time interval
-        if ((dt < 0 || msecs > _lastMSecs)) {
-            nsecs = 0;
+        if ((dt < 0 || msecs > _last_milliseconds)) {
+            nanoseconds = 0;
         }
 
         // Per 4.2.1.2 Throw error if too many uuids are requested
-        if (nsecs >= 10000) {
+        if (nanoseconds >= 10000) {
             throw new Error(".v1(): Can't create more than 10M uuids/sec");
         }
 
-        _lastMSecs = msecs;
-        _lastNSecs = nsecs;
-        _clockseq = clockseq;
+        _last_milliseconds = msecs;
+        _last_nanoseconds = nanoseconds;
+        _clock_seq = clock_seq;
 
         // Per 4.1.4 - Convert from unix epoch to Gregorian epoch
         msecs += 12219292800000;
 
         let i = 0
         // `time_low`
-        const tl = ((msecs & 0xfffffff) * 10000 + nsecs) % 0x100000000;
+        const tl = ((msecs & 0xfffffff) * 10000 + nanoseconds) % 0x100000000;
         b[i++] = (tl >>> 24) & 0xff;
         b[i++] = (tl >>> 16) & 0xff;
         b[i++] = (tl >>> 8) & 0xff;
@@ -154,14 +156,14 @@ export class UUID {
         b[i++] = (tmh >>> 16) & 0xff;
 
         // `clock_seq_hi_and_reserved` (Per 4.2.2 - include variant)
-        b[i++] = (clockseq >>> 8) | 0x80;
+        b[i++] = (clock_seq >>> 8) | 0x80;
 
         // `clock_seq_low`
-        b[i++] = clockseq & 0xff;
+        b[i++] = clock_seq & 0xff;
 
         // `node`
         for (let n = 0; n < 6; ++n) {
-            b[i + n] = _nodeId[n];
+            b[i + n] = _node_id[n];
         }
     }
 

package/src/engine/ecs/name/Name.d.ts

@@ -1,20 +1,13 @@
-export default Name;
-declare class Name extends ObservedString {
-    /**
-     *
-     * @returns {string}
-     */
-    getLocalizationKey(): string;
+export class Name extends ObservedString {
     /**
-     *
-     * @param {Localization} localization
-     * @returns {string}
+     * @readonly
+     * @type {boolean}
      */
-    getLocalizedValue(localization: Localization): string;
-    clone(): Name;
+    readonly isName: boolean;
 }
-declare namespace Name {
+export namespace Name {
     let typeName: string;
 }
+export default Name;
 import ObservedString from "../../../core/model/ObservedString.js";
 //# sourceMappingURL=Name.d.ts.map

package/src/engine/ecs/name/Name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Name.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/name/Name.js"],"names":[],"mappings":";AAEA;IASI;;;OAGG;IACH,sBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,gCAHW,YAAY,GACV,MAAM,CAIlB;IAED,cAMC;CACJ;;;;2BAnC0B,uCAAuC"}
+{"version":3,"file":"Name.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/name/Name.js"],"names":[],"mappings":"AAEA;IAiBA;;;OAGG;IACH,iBAFU,OAAO,CAEI;CAZpB;;kBAIS,MAAM;;;2BAfW,uCAAuC"}

package/src/engine/ecs/name/Name.js

@@ -1,6 +1,6 @@
 import ObservedString from "../../../core/model/ObservedString.js";
 
-class Name extends ObservedString {
+export class Name extends ObservedString {
     /**
      *
      * @param {string} [value]
@@ -9,34 +9,20 @@ class Name extends ObservedString {
         super(value);
     }
 
-    /**
-     *
-     * @returns {string}
-     */
-    getLocalizationKey() {
-        return `component.name.${this.getValue()}`;
-    }
-
-    /**
-     *
-     * @param {Localization} localization
-     * @returns {string}
-     */
-    getLocalizedValue(localization) {
-        return localization.getString(this.getLocalizationKey());
-    }
-
-    clone() {
-        const clone = new Name();
-
-        clone.copy(this);
-
-        return clone;
-    }
 }
 
+/**
+ * @readonly
+ * @type {string}
+ */
 Name.typeName = "Name";
 
+/**
+ * @readonly
+ * @type {boolean}
+ */
+Name.prototype.isName = true;
 
+// prefer named import instead
 export default Name;