@woosh/meep-engine 2.124.8 → 2.124.11

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.11",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/math/spline/spline_hermite3.d.ts

@@ -7,6 +7,9 @@
  * @param {number} m0 first tangent (tangent exiting from first value)
  * @param {number} m1 second tangent (tangent entering into second value)
  * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3(t: number, p0: number, p1: number, m0: number, m1: number): number;
 //# sourceMappingURL=spline_hermite3.d.ts.map

package/src/core/math/spline/spline_hermite3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spline_hermite3.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,mCAPW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACL,MAAM,CAajB"}
+{"version":3,"file":"spline_hermite3.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline_hermite3.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,mCAVW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACL,MAAM,CAgBjB"}

package/src/core/math/spline/spline_hermite3.js

@@ -7,6 +7,9 @@
  * @param {number} m0 first tangent (tangent exiting from first value)
  * @param {number} m1 second tangent (tangent entering into second value)
  * @return {number}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function spline_hermite3(t, p0, p1, m0, m1) {
 

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/animation/curve/AnimationCurve.d.ts

@@ -1,6 +1,10 @@
 /**
- * Describes change of a numeric value over time. Values are stored in {@link Keyframe}s, interpolation is defined by tangents on keyframes
- * Inspired by unity's AnimationCurve, see https://docs.unity3d.com/ScriptReference/AnimationCurve.html
+ * Describes change of a numeric value over time.
+ * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
+ * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class AnimationCurve {
     /**
@@ -81,6 +85,12 @@ export class AnimationCurve {
      * @returns {number}
      */
     get duration(): number;
+    /**
+     * Returns index of a key that is just before or at the time specified.
+     * @param {number} time
+     * @returns {number} index of the key
+     */
+    getKeyIndexByTime(time: number): number;
     /**
      *
      * @param {number} time time in seconds

package/src/engine/animation/curve/AnimationCurve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAqBA;;;GAGG;AACH;IAkFI;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IA0ND;;;;;;;OAOG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAYzB;IAxWD;;;OAGG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;OAIG;IACH,SAHW,QAAQ,GACN,MAAM,CAgClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAeD;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAYlB;IAED;;;OAGG;IACH,gBAFY,MAAM,CAYjB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAelB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAiCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QA+BhB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAeC;CAqDJ;yBA1XwB,eAAe"}
+{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH;IAkFI;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IAgRD;;;;;;;OAOG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAYzB;IA9ZD;;;OAGG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;OAIG;IACH,SAHW,QAAQ,GACN,MAAM,CAgClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAeD;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAYlB;IAED;;;OAGG;IACH,gBAFY,MAAM,CAYjB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAelB;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACJ,MAAM,CA0ClB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAoCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAmChB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAeC;CAqDJ;yBApbwB,eAAe"}

package/src/engine/animation/curve/AnimationCurve.js

@@ -20,8 +20,12 @@ function compareKeyframeToTime(time, keyframe) {
 }
 
 /**
- * Describes change of a numeric value over time. Values are stored in {@link Keyframe}s, interpolation is defined by tangents on keyframes
- * Inspired by unity's AnimationCurve, see https://docs.unity3d.com/ScriptReference/AnimationCurve.html
+ * Describes change of a numeric value over time.
+ * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
+ * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class AnimationCurve {
     /**
@@ -177,6 +181,53 @@ export class AnimationCurve {
         return last.time - first.time;
     }
 
+    /**
+     * Returns index of a key that is just before or at the time specified.
+     * @param {number} time
+     * @returns {number} index of the key
+     */
+    getKeyIndexByTime(time) {
+        const keys = this.keys;
+        const key_count = keys.length;
+
+        let i0 = 0;
+        let i1 = key_count - 1;
+
+        if (time <= keys[0].time) {
+            // before start
+            return 0;
+        }
+
+        // binary search
+        while (i0 <= i1) {
+            const pivot = (i0 + i1) >>> 1;
+
+            const key = keys[pivot];
+            const key_time = key.time;
+
+            if (key_time < time) {
+                i0 = pivot + 1;
+            } else if (key_time > time) {
+                i1 = pivot - 1;
+            } else {
+                i0 = pivot;
+                break;
+            }
+        }
+
+        if (i0 > i1) {
+            // swap
+            i0 = i1;
+        }
+
+        // fast-forward to last matching frame if there are multiple matches
+        while (i0 + 1 < key_count - 1 && keys[i0 + 1].time === time) {
+            i0++;
+        }
+
+        return i0;
+    }
+
     /**
      *
      * @param {number} time time in seconds
@@ -189,30 +240,33 @@ export class AnimationCurve {
         const key_count = keys.length;
 
         if (key_count === 0) {
+            // no keys, produce arbitrary value
             return 0;
         }
 
         if (key_count === 1) {
+            // only have one key
             return keys[0].value;
         }
 
-        if (time <= keys[0].time) {
-            // before start
-            return keys[0].value;
-        }
+        const i = this.getKeyIndexByTime(time);
 
-        for (let i = 1; i < key_count; i++) {
-            const keyframe1 = keys[i];
+        if (i >= key_count - 1) {
+            // past last keyframe
+            return keys[key_count - 1].value;
+        }
 
-            if (time < keyframe1.time) {
-                const keyframe0 = keys[i - 1];
+        const keyframe0 = keys[i];
 
-                return evaluate_two_key_curve(time, keyframe0, keyframe1);
-            }
+        if (keyframe0.time >= time) {
+            // on or past the keyframe
+            return keyframe0.value;
         }
 
-        // past end
-        return keys[key_count - 1].value;
+        const keyframe1 = keys[i + 1];
+
+        return evaluate_two_key_curve(time, keyframe0, keyframe1);
+
     }
 
     /**
@@ -230,6 +284,11 @@ export class AnimationCurve {
         const key_main = keys[index];
 
         const has_previous = index > 0;
+
+        const has_next = index < last_index;
+
+        // TODO check out https://github.com/MonoGame/MonoGame/blob/f6ce4cbbe3ca5a93f0d1926f58ed501217a04069/MonoGame.Framework/Curve.cs#L232
+
         if (has_previous) {
             const key_previous = keys[index - 1];
 
@@ -239,7 +298,6 @@ export class AnimationCurve {
             key_main.inTangent = value_span / time_span;
         }
 
-        const has_next = index < last_index;
 
         if (has_next) {
             const key_next = keys[index + 1];

package/src/engine/animation/curve/Keyframe.d.ts

@@ -1,5 +1,8 @@
 /**
  * Single keyframe of {@link AnimationCurve}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class Keyframe {
     /**

package/src/engine/animation/curve/Keyframe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B"}
+{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B"}

package/src/engine/animation/curve/Keyframe.js

@@ -3,6 +3,9 @@ import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFl
 
 /**
  * Single keyframe of {@link AnimationCurve}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class Keyframe {
     /**

package/src/engine/animation/curve/animation_curve_optimize.d.ts

@@ -3,6 +3,9 @@
  * Intended to reduce complexity of a curve to improve performance and lower memory usage
  * @param {AnimationCurve} curve
  * @param {number} [error_tolerance] how much of a loss to accept, this is relative to normalized value bounds of the curve
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function animation_curve_optimize(curve: AnimationCurve, error_tolerance?: number): void;
 //# sourceMappingURL=animation_curve_optimize.d.ts.map

package/src/engine/animation/curve/animation_curve_optimize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AA0CA;;;;;GAKG;AACH,gDAHW,cAAc,oBACd,MAAM,QA0ChB"}
+{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AAkDA;;;;;;;;GAQG;AACH,gDANW,cAAc,oBACd,MAAM,QA6ChB"}

package/src/engine/animation/curve/animation_curve_optimize.js

@@ -12,9 +12,17 @@ const NORMALIZED_CHECK_DISTANCE = 0.07;
  * @param {Keyframe} key_middle
  * @param {Keyframe} key_previous
  * @param {Keyframe} key_next
- * @return {number} value delta if the middle frame is removed
+ * @return {number} value delta if the middle frame is removed, the higher this value - the more important the middle keyframe is
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
-function compute_keyframe_value_effect(key_middle, key_previous, key_next) {
+function compute_keyframe_value_effect(
+    key_middle,
+    key_previous,
+    key_next
+) {
+
     // check if this key contributes to the shape
     const v1_actual = evaluate_two_key_curve(key_middle.time, key_previous, key_next);
     const v1_expected = key_middle.value;
@@ -45,6 +53,9 @@ function compute_keyframe_value_effect(key_middle, key_previous, key_next) {
  * Intended to reduce complexity of a curve to improve performance and lower memory usage
  * @param {AnimationCurve} curve
  * @param {number} [error_tolerance] how much of a loss to accept, this is relative to normalized value bounds of the curve
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export function animation_curve_optimize(curve, error_tolerance = 1e-3) {
     assert.lessThan(error_tolerance, 1, 'error_tolerance must be less than 1');

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;