@woosh/meep-engine 2.124.6 → 2.124.10

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/model/stat/Stat.d.ts

@@ -1,29 +1,163 @@
-import Signal from "../../events/signal/Signal";
-import LinearModifier from "./LinearModifier";
-
-export default class Stat extends Number {
-    constructor(base_value: number)
-
-    public readonly onModifierAdded: Signal<LinearModifier>
-    public readonly onModifierRemoved: Signal<LinearModifier>
-    public readonly onChanged: Signal<number, number>
-
-    getValue(): number
-
-    getBaseValue(): number
-
-    setBaseValue(v: number): void
-
-    addModifier(mod: LinearModifier): void
-
-    removeModifier(mod: LinearModifier): boolean
-
-    equals(other: Stat): boolean
-
-    copy(other: Stat): void
-
-    toJSON(): any
-
-    fromJSON(json: any): void
-
-}
+export default Stat;
+/**
+ * Modifiable statistic.
+ * Allows non-destructive linear arithmetic.
+ * Useful when we wish to be able to reverse part or the whole of the computation
+ *
+ * Main purpose of the class is to facilitate implementation of RPG-like stats, such as maximum health, or armor.
+ * These stats can then be modified by various skills, equipment and effects. Each such modification will be added as a separate {@link LinearModifier} and can be reversed by removing the modifier.
+ */
+declare class Stat extends Number {
+    /**
+     *
+     * @param {number} input
+     * @param {List<LinearModifier>}modifiers
+     * @returns {number}
+     */
+    static applyModifiers(input: number, modifiers: List<LinearModifier>): number;
+    /**
+     * @param {number} [value]
+     * @constructor
+     */
+    constructor(value?: number);
+    /**
+     * Unique identifier of a stat, such a health, armor etc.
+     * @type {number}
+     */
+    id: number;
+    /**
+     * List of modifiers.
+     * Order has no influence on final computed value
+     * @private
+     * @readonly
+     * @type {List<LinearModifier>}
+     */
+    private readonly __modifiers;
+    /**
+     *
+     * @type {function(number): number}
+     */
+    postprocess: (arg0: number) => number;
+    /**
+     * Base value that will be affected by modifiers
+     * @type {Vector1}
+     */
+    base: Vector1;
+    /**
+     * Final computed value. Do not modify this directly
+     * @type {Vector1}
+     */
+    value: Vector1;
+    /**
+     *
+     * @returns {Signal<LinearModifier>}
+     */
+    get onModifierAdded(): Signal<LinearModifier>;
+    /**
+     *
+     * @returns {Signal<LinearModifier>}
+     */
+    get onModifierRemoved(): Signal<LinearModifier>;
+    /**
+     * Remove all modifiers from the stat
+     */
+    resetModifiers(): void;
+    /**
+     *
+     * @returns {string}
+     */
+    toString(): string;
+    /**
+     *
+     * @returns {number}
+     */
+    getValue(): number;
+    updateValue(): void;
+    /**
+     *
+     * @returns {number}
+     */
+    getBaseValue(): number;
+    /**
+     *
+     * @param {number} v
+     */
+    setBaseValue(v: number): void;
+    /**
+     * NOTE: do not modify result
+     * @return {LinearModifier[]}
+     */
+    getModifiers(): LinearModifier[];
+    /**
+     *
+     * @param {LinearModifier} mod
+     */
+    addModifier(mod: LinearModifier): void;
+    /**
+     *
+     * @param {LinearModifier} mod
+     * @return {boolean}
+     */
+    hasModifier(mod: LinearModifier): boolean;
+    /**
+     *
+     * @param {LinearModifier} mod
+     * @returns {boolean}
+     */
+    removeModifier(mod: LinearModifier): boolean;
+    /**
+     *
+     * @param {Stat} other
+     * @returns {boolean}
+     */
+    equals(other: Stat): boolean;
+    /**
+     *
+     * @param {Stat} other
+     */
+    copy(other: Stat): void;
+    /**
+     * Copy base value from another stat
+     * @param {Stat} other
+     */
+    copyBase(other: Stat): void;
+    /**
+     *
+     * @param {function(number):number} f
+     * @param {number} v
+     */
+    setBaseFromParametricFunction(f: (arg0: number) => number, v: number): void;
+    /**
+     * @param {Stat} other
+     */
+    addNonTransientModifiersFromStat(other: Stat): void;
+    toJSON(): {
+        base: number;
+        modifiers: any;
+    };
+    fromJSON(json: any): void;
+    /**
+     *
+     * @returns {Signal}
+     */
+    get onChanged(): Signal;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isStat: boolean;
+}
+declare namespace Stat {
+    namespace Process {
+        export function ROUND_DOWN(v: number): number;
+        export function NONE(v: any): any;
+        export function clampMin(value: number): (arg0: number) => number;
+        export function clampMax(value: number): (arg0: number) => number;
+        export { chain };
+    }
+}
+import Vector1 from "../../geom/Vector1.js";
+import LinearModifier from "./LinearModifier.js";
+import List from "../../collection/list/List.js";
+import { chain } from "../../function/chain.js";
+//# sourceMappingURL=Stat.d.ts.map

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/core/primitives/numbers/computeHashFloat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computeHashFloat.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/numbers/computeHashFloat.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAclB"}
+{"version":3,"file":"computeHashFloat.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/numbers/computeHashFloat.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAiBlB"}

package/src/core/primitives/numbers/computeHashFloat.js

@@ -13,8 +13,11 @@ export function computeHashFloat(v) {
 
     // fractional part is scaled up into uint32 range,
     // this inexact method, as it will produce 0 hash for values below a certain threshold, but it's fast
-    const fractionHash = fraction * UINT32_MAX;
+    const fraction_hash = ((fraction) * UINT32_MAX) >>> 0;
+
+    // we flip the order, tiny fractions will result in higher bits of the final hash, leads to better dispersion
+    const fraction_hash_inverse = UINT32_MAX - fraction_hash;
 
     // take XOR of both parts
-    return fractionHash ^ whole;
+    return fraction_hash_inverse ^ whole;
 }

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

@@ -1,7 +1,23 @@
 /**
- * Universally Unique Identifier
- * The default is Nil UUID, where all bits are set to 0
- * @see IETF RFC 4122
+ * Universally Unique Identifier (UUID), a 128 bit label used to uniquely identify resources.
+ * The default is Nil UUID, where all bits are set to 0, see {@link UUID.nil}.
+ * Also known as GUID ( Globally Unique IDentifier).
+ *
+ * @see IETF RFC 4122 - https://datatracker.ietf.org/doc/html/rfc4122
+ * @example
+ *  class Student{
+ *      id: UUID
+ *      name: string
+ *      age: number
+ *  }
+ * @example
+ *  const id_a = UUID.v1();
+ *  const id_b = UUID.v1();
+ *
+ *  id_a.equals(id_b); // false
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class UUID {
     /**
@@ -36,6 +52,22 @@ export class UUID {
      * @returns {Uint8Array}
      */
     get data(): Uint8Array;
+    /**
+     * The version number is in the most significant 4 bits of the timestamp (bits 4 through 7 of the time_hi_and_version field).
+     *
+     * @see https://datatracker.ietf.org/doc/html/rfc4122#section-4.1.3
+     * @return {number}
+     * @example
+     *  UUID.v1().version === 1
+     *  UUID.v4().version === 4
+     */
+    get version(): number;
+    /**
+     * The nil UUID is special form of UUID that is specified to have all 128 bits set to zero.
+     * Clears all bits of this UUID.
+     * @returns {void}
+     */
+    nil(): void;
     /**
      * Generate Variant 1 UUID
      * @returns {void}

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;;;;GAIG;AACH;IAkGI;;;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;IA/MD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,UAAU,GAAC,SAAS,CAAC,MAAM,CAAC,EAO/C;IAED;;;OAGG;IACH,YAFa,UAAU,CAItB;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"}