@woosh/meep-engine 2.110.8 → 2.110.9

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

@@ -0,0 +1,8 @@
+/**
+ * Will remove keyframes that do not affect shape of the curve significantly. The significance degree is determined by the error tolerance
+ * 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
+ */
+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

@@ -0,0 +1 @@
+{"version":3,"file":"animation_curve_optimize.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.js"],"names":[],"mappings":"AA0CA;;;;;GAKG;AACH,kFAFW,MAAM,QA0ChB"}

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

@@ -0,0 +1,89 @@
+import { assert } from "../../../core/assert.js";
+import AABB2 from "../../../core/geom/2d/aabb/AABB2.js";
+import { animation_curve_compute_aabb } from "./animation_curve_compute_aabb.js";
+import { evaluate_two_key_curve } from "./evaluate_two_key_curve.js";
+
+const bounds = new AABB2();
+
+const NORMALIZED_CHECK_DISTANCE = 0.07;
+
+/**
+ * Compute value difference in the curve if the `middle` key between `previous` and `next` is removed
+ * @param {Keyframe} key_middle
+ * @param {Keyframe} key_previous
+ * @param {Keyframe} key_next
+ * @return {number} value delta if the middle frame is removed
+ */
+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;
+
+    const v1_error = Math.abs(v1_actual - v1_expected);
+
+    // sample just before the current frame
+    const v0_time = key_middle.time - (key_middle.time - key_previous.time) * NORMALIZED_CHECK_DISTANCE;
+
+    const v0_actual = evaluate_two_key_curve(v0_time, key_previous, key_next);
+    const v0_expected = evaluate_two_key_curve(v0_time, key_previous, key_middle);
+
+    const v0_error = Math.abs(v0_actual - v0_expected);
+
+    // sample just after the current frame
+    const v2_time = key_middle.time + (key_next.time - key_middle.time) * NORMALIZED_CHECK_DISTANCE;
+
+    const v2_actual = evaluate_two_key_curve(v2_time, key_previous, key_next);
+    const v2_expected = evaluate_two_key_curve(v2_time, key_middle, key_next);
+
+    const v2_error = Math.abs(v2_actual - v2_expected);
+
+    return Math.max(v0_error, v1_error, v2_error);
+}
+
+/**
+ * Will remove keyframes that do not affect shape of the curve significantly. The significance degree is determined by the error tolerance
+ * 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
+ */
+export function animation_curve_optimize(curve, error_tolerance = 1e-3) {
+    assert.lessThan(error_tolerance, 1, 'error_tolerance must be less than 1');
+
+    animation_curve_compute_aabb(bounds, curve);
+
+    const absolute_error_tolerance = bounds.height * error_tolerance;
+
+    let key_count = curve.length;
+
+    const keyframes = curve.keys;
+
+    for (let i = 1; i < key_count; i++) {
+        const key_previous = keyframes[i - 1];
+        const key_current = keyframes[i];
+
+        let should_remove = false;
+
+        if (key_current.equals(key_previous)) {
+            // adds no semantic value
+            should_remove = true;
+        }
+
+        if (!should_remove && i < key_count - 1) {
+            const key_next = keyframes[i + 1];
+
+            const max_error = compute_keyframe_value_effect(key_current, key_previous, key_next);
+
+            if (max_error <= absolute_error_tolerance) {
+                // does not significantly affect the curve shape
+                should_remove = true;
+            }
+        }
+
+
+        if (should_remove) {
+            curve.remove(key_current);
+            i--;
+            key_count--;
+        }
+    }
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=animation_curve_optimize.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation_curve_optimize.spec.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/animation_curve_optimize.spec.js"],"names":[],"mappings":""}

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

@@ -0,0 +1,50 @@
+import { animation_curve_optimize } from "./animation_curve_optimize.js";
+import { AnimationCurve } from "./AnimationCurve.js";
+import { Keyframe } from "./Keyframe.js";
+
+test("single key", () => {
+
+    const curve = AnimationCurve.from([
+        Keyframe.from(1, -2, 3, -5)
+    ]);
+
+    animation_curve_optimize(curve);
+
+    expect(curve.keys.length).toBe(1);
+});
+
+test("repeated key", () => {
+
+    const curve = AnimationCurve.from([
+        Keyframe.from(1, -2, 3, -5),
+        Keyframe.from(1, -2, 3, -5),
+        Keyframe.from(1, -2, 3, -5)
+    ]);
+
+    animation_curve_optimize(curve);
+
+    expect(curve.equals(
+        AnimationCurve.from([
+            Keyframe.from(1, -2, 3, -5)
+        ])
+    )).toBe(true);
+});
+
+test("linear curve", () => {
+
+    const curve = AnimationCurve.from([
+        Keyframe.from(0, 0, 1, 1),
+        Keyframe.from(1, 1, 1, 1),
+        Keyframe.from(2, 2, 1, 1),
+    ])
+
+    animation_curve_optimize(curve);
+
+    expect(curve.equals(
+        AnimationCurve.from([
+            Keyframe.from(0, 0, 1, 1),
+            Keyframe.from(2, 2, 1, 1)
+        ])
+    )).toBe(true);
+
+});

package/src/engine/animation/curve/draw/build_curve_editor.js

@@ -11,8 +11,8 @@ import { canvas2d_plot_data_line } from "../../../graphics/canvas/canvas2d_plot_
 import { MouseEvents } from "../../../input/devices/events/MouseEvents.js";
 import { readPositionFromMouseEvent } from "../../../input/devices/PointerDevice.js";
 import { DraggableAspect } from "../../../ui/DraggableAspect.js";
+import { animation_curve_compute_aabb } from "../animation_curve_compute_aabb.js";
 import { sample_animation_curve_to_float_array } from "../compression/sample_animation_curve_to_float_array.js";
-import { compute_curve_aabb } from "../compute_curve_aabb.js";
 import { Keyframe } from "../Keyframe.js";
 
 /**
@@ -106,7 +106,7 @@ export function build_curve_editor({
     });
 
     function handle_curve_update() {
-        compute_curve_aabb(frame, curve);
+        animation_curve_compute_aabb(frame, curve);
 
         frame_updated.send0();
 

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

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {number} time
+ * @param {Keyframe} keyframe0
+ * @param {Keyframe} keyframe1
+ * @return {number}
+ */
+export function evaluate_two_key_curve(time: number, keyframe0: Keyframe, keyframe1: Keyframe): number;
+//# sourceMappingURL=evaluate_two_key_curve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate_two_key_curve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/evaluate_two_key_curve.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,6CALW,MAAM,aACN,QAAQ,aACR,QAAQ,GACP,MAAM,CAcjB"}

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

@@ -0,0 +1,23 @@
+import { inverseLerp } from "../../../core/math/inverseLerp.js";
+import { spline_hermite3 } from "../../../core/math/spline/spline_hermite3.js";
+
+/**
+ *
+ * @param {number} time
+ * @param {Keyframe} keyframe0
+ * @param {Keyframe} keyframe1
+ * @return {number}
+ */
+export function evaluate_two_key_curve(time, keyframe0, keyframe1) {
+    // convert to 0..1 region
+    const normalized_time = inverseLerp(keyframe0.time, keyframe1.time, time);
+
+    const time_distance = keyframe1.time - keyframe0.time;
+
+    return spline_hermite3(
+        normalized_time,
+        keyframe0.value, keyframe1.value,
+        keyframe0.outTangent * time_distance,
+        keyframe1.inTangent * time_distance
+    );
+}

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

@@ -38,17 +38,17 @@ async function main(engine) {
         yaw: 3.123185307179593,
     });
     //
-    // make_sample('data/models/samples/InterpolationTest.glb',[
-    //     'Step Scale',
-    //     'Linear Scale',
-    //     'CubicSpline Scale',
-    //     'Step Rotation',
-    //     'CubicSpline Rotation',
-    //     'Linear Rotation',
-    //     'Step Translation',
-    //     'CubicSpline Translation',
-    //     'Linear Translation'
-    // ],engine.entityManager.dataset);
+    make_sample('data/models/samples/InterpolationTest.glb',[
+        'Step Scale',
+        'Linear Scale',
+        'CubicSpline Scale',
+        'Step Rotation',
+        'CubicSpline Rotation',
+        'Linear Rotation',
+        'Step Translation',
+        'CubicSpline Translation',
+        'Linear Translation'
+    ],engine.entityManager.dataset);
 
     // make_sample('data/models/samples/BoxAnimated.glb',[
     //    'animation_0'
@@ -61,9 +61,9 @@ async function main(engine) {
     // make_sample('moicon/Separated_Cardboard-Box-800x600x400_Roughness0/V1 Cardboard B.gltf', [
     //     'All Animations'
     // ], engine.entityManager.dataset);
-    make_sample('moicon/v26/v26.gltf', [
-        'All Animations'
-    ], engine.entityManager.dataset);
+    // make_sample('moicon/v26/v26.gltf', [
+    //     'All Animations'
+    // ], engine.entityManager.dataset);
 }
 
 /**

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.d.ts

@@ -1,5 +1,9 @@
 export class DynamicRuleDescription {
-    id: number;
+    /**
+     *
+     * @type {UUID}
+     */
+    id: UUID;
     /**
      *
      * @type {ReactiveExpression}
@@ -51,5 +55,6 @@ export class DynamicRuleDescription {
         priority?: number;
     }): void;
 }
+import { UUID } from "../../guid/UUID.js";
 import { DynamicRuleCooldownDescription } from "./DynamicRuleCooldownDescription.js";
 //# sourceMappingURL=DynamicRuleDescription.d.ts.map

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicRuleDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.js"],"names":[],"mappings":"AAQA;IACI,WAAO;IACP;;;OAGG;IACH,8BAAiB;IACjB;;;OAGG;IACH,kCAAc;IACd;;;OAGG;IACH,YAFU,mBAAmB,CAEb;IAChB;;;OAGG;IACH,UAFU,MAAM,CAEH;IACb;;;OAGG;IACH,6BAAyB;IACzB;;;OAGG;IACH,kBAFU,8BAA8B,EAAE,CAEpB;IAEtB;;;;OAIG;IACH,cAHW,sBAAsB,GACpB,OAAO,CAInB;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,yCAEC;IAED,cA+BC;IAED;;;;;;aA2BC;CACJ;+CArH8C,qCAAqC"}
+{"version":3,"file":"DynamicRuleDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.js"],"names":[],"mappings":"AAQA;IACI;;;OAGG;IACH,IAFU,IAAI,CAEC;IAEf;;;OAGG;IACH,8BAAiB;IACjB;;;OAGG;IACH,kCAAc;IACd;;;OAGG;IACH,YAFU,mBAAmB,CAEb;IAChB;;;OAGG;IACH,UAFU,MAAM,CAEH;IACb;;;OAGG;IACH,6BAAyB;IACzB;;;OAGG;IACH,kBAFU,8BAA8B,EAAE,CAEpB;IAEtB;;;;OAIG;IACH,cAHW,sBAAsB,GACpB,OAAO,CAInB;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,yCAEC;IAED,cA+BC;IAED;;;;;;aA2BC;CACJ;qBA5HoB,oBAAoB;+CAEM,qCAAqC"}

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.js

@@ -1,13 +1,18 @@
-import UUID from "../../../../core/UUID.js";
 import { assert } from "../../../../core/assert.js";
+import { compileReactiveExpression } from "../../../../core/lang/reactive/compileReactiveExpression.js";
 import { inferReactiveExpressionTypes } from "../../../../core/model/reactive/transform/ReactiveTypeInferrence.js";
 import DataType from "../../../../core/parser/simple/DataType.js";
-import { compileReactiveExpression } from "../../../../core/lang/reactive/compileReactiveExpression.js";
+import { UUID } from "../../guid/UUID.js";
 import { deserializeActionFromJSON } from "../actions/definition/deserializeActionFromJSON.js";
 import { DynamicRuleCooldownDescription } from "./DynamicRuleCooldownDescription.js";
 
 export class DynamicRuleDescription {
-    id = 0;
+    /**
+     *
+     * @type {UUID}
+     */
+    id = UUID.v1();
+
     /**
      *
      * @type {ReactiveExpression}
@@ -45,7 +50,7 @@ export class DynamicRuleDescription {
      * @returns {boolean}
      */
     equals(other) {
-        return this.id === other.id;
+        return this.id.equals(other.id);
     }
 
     /**
@@ -94,7 +99,7 @@ export class DynamicRuleDescription {
     }
 
     fromJSON({
-                 id = UUID.generate(),
+                 id = UUID.v1().toString(),
                  condition,
                  action,
                  global_cooldowns = [],
@@ -113,7 +118,7 @@ export class DynamicRuleDescription {
 
         this.action = deserializeActionFromJSON(action);
 
-        this.id = id;
+        this.id.parse(id);
 
         this.priority = priority;
 

package/src/engine/ecs/guid/GUIDSerializationAdapter.spec.js

@@ -1,19 +1,19 @@
-import { GUID } from "./GUID.js";
-import { GUIDSerializationAdapter } from "./GUIDSerializationAdapter.js";
 import { BinaryBuffer } from "../../../core/binary/BinaryBuffer.js";
+import { UUID } from "./UUID.js";
+import { UUIDSerializationAdapter } from "./UUIDSerializationAdapter.js";
 
 test("to/from consistency", () => {
 
-    const source = GUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
+    const source = UUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
 
-    const adapter = new GUIDSerializationAdapter();
+    const adapter = new UUIDSerializationAdapter();
 
     const buffer = new BinaryBuffer();
 
     adapter.serialize(buffer, source);
     buffer.position = 0; // rewind
 
-    const destination = new GUID();
+    const destination = new UUID();
 
     adapter.deserialize(buffer, destination);
 

package/src/engine/ecs/guid/{GUID.d.ts → UUID.d.ts}

@@ -2,18 +2,19 @@
  * Globally unique identifier
  * @class
  */
-export class GUID {
+export class UUID {
     /**
      *
-     * @return {GUID}
+     * @return {UUID}
      */
-    static v1(): GUID;
+    static v1(): UUID;
+    static v4(): UUID;
     /**
      *
      * @param {string} string
-     * @return {GUID}
+     * @return {UUID}
      */
-    static parse(string: string): GUID;
+    static parse(string: string): UUID;
     /**
      *
      * @param {number[]|Uint8Array|ArrayLike<number>} bytes
@@ -29,6 +30,10 @@ export class GUID {
      * @see https://github.com/uuidjs/uuid/blob/8f028c4ea42ce41a9a9dc5fa634abe525b2e2066/src/v1.js#L17
      */
     v1(): void;
+    /**
+     * Generate Variant 4 UUID (fully random)
+     */
+    v4(): void;
     /***
      * String in UUID format
      * @see https://github.com/uuidjs/uuid/blob/8f028c4ea42ce41a9a9dc5fa634abe525b2e2066/src/parse.js#L3
@@ -42,15 +47,15 @@ export class GUID {
     toString(): string;
     /**
      *
-     * @param {GUID} other
+     * @param {UUID} other
      */
-    copy(other: GUID): void;
+    copy(other: UUID): void;
     /**
      *
-     * @param {GUID} other
+     * @param {UUID} other
      * @returns {boolean}
      */
-    equals(other: GUID): boolean;
+    equals(other: UUID): boolean;
     /**
      * @returns {number}
      */
@@ -61,10 +66,10 @@ export class GUID {
      * @readonly
      * @type {boolean}
      */
-    readonly isGUID: boolean;
+    readonly isUUID: boolean;
     #private;
 }
-export namespace GUID {
+export namespace UUID {
     let typeName: string;
 }
-//# sourceMappingURL=GUID.d.ts.map
+//# sourceMappingURL=UUID.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UUID.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.js"],"names":[],"mappings":"AAuBA;;;GAGG;AACH;IAgHI;;;OAGG;IACH,aAFY,IAAI,CAQf;IAED,kBAMC;IA0CD;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,CAQf;IApLD;;;OAGG;IACH,0BAKC;IAED;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,WAqEC;IAED;;OAEG;IACH,WAUC;IAsBD;;;;OAIG;IACH,cAFW,MAAM,QAmChB;IAeD;;;OAGG;IACH,YAFa,MAAM,CA2BlB;IAED;;;OAGG;IACH,YAFW,IAAI,QAId;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAanB;IAED;;OAEG;IACH,QAFa,MAAM,CAWlB;IAED,iBAEC;IAED,uBAEC;IASL;;;OAGG;IACH,iBAFU,OAAO,CAEI;;CAZpB;;kBAIS,MAAM"}

package/src/engine/ecs/guid/{GUID.js → UUID.js}

@@ -1,9 +1,9 @@
-import { seededRandom } from "../../../core/math/random/seededRandom.js";
-import { randomUint8 } from "../../../core/math/random/randomUint8.js";
+import { assert } from "../../../core/assert.js";
 import { dec2hex } from "../../../core/binary/dec2hex.js";
 import { array_copy } from "../../../core/collection/array/array_copy.js";
 import { randomBytes } from "../../../core/math/random/randomBytes.js";
-import { assert } from "../../../core/assert.js";
+import { randomUint8 } from "../../../core/math/random/randomUint8.js";
+import { seededRandom } from "../../../core/math/random/seededRandom.js";
 
 // Previous uuid creation time
 let _lastMSecs = 0;
@@ -25,7 +25,7 @@ let _clockseq = ((randomUint8(random) << 8) | randomUint8(random)) & 0x3fff;
  * Globally unique identifier
  * @class
  */
-export class GUID {
+export class UUID {
     #data = new Uint8Array(16);
 
     /**
@@ -122,18 +122,41 @@ export class GUID {
         }
     }
 
+    /**
+     * Generate Variant 4 UUID (fully random)
+     */
+    v4() {
+
+        const data = this.data;
+
+        randomBytes(data, 0, random, 16);
+
+        // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
+        data[6] = (data[6] & 0x0f) | 0x40;
+        data[8] = (data[8] & 0x3f) | 0x80;
+
+    }
+
     /**
      *
-     * @return {GUID}
+     * @return {UUID}
      */
     static v1() {
-        const uuid = new GUID();
+        const uuid = new UUID();
 
         uuid.v1();
 
         return uuid;
     }
 
+    static v4() {
+        const r = new UUID();
+
+        r.v4();
+
+        return r;
+    }
+
     /***
      * String in UUID format
      * @see https://github.com/uuidjs/uuid/blob/8f028c4ea42ce41a9a9dc5fa634abe525b2e2066/src/parse.js#L3
@@ -177,10 +200,10 @@ export class GUID {
     /**
      *
      * @param {string} string
-     * @return {GUID}
+     * @return {UUID}
      */
     static parse(string) {
-        const r = new GUID();
+        const r = new UUID();
 
         r.parse(string);
 
@@ -220,7 +243,7 @@ export class GUID {
 
     /**
      *
-     * @param {GUID} other
+     * @param {UUID} other
      */
     copy(other) {
         this.#data.set(other.#data);
@@ -228,7 +251,7 @@ export class GUID {
 
     /**
      *
-     * @param {GUID} other
+     * @param {UUID} other
      * @returns {boolean}
      */
     equals(other) {
@@ -271,10 +294,10 @@ export class GUID {
  * @readonly
  * @type {string}
  */
-GUID.typeName = "GUID";
+UUID.typeName = "UUID";
 
 /**
  * @readonly
  * @type {boolean}
  */
-GUID.prototype.isGUID = true;
+UUID.prototype.isUUID = true;

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UUID.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UUID.spec.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUID.spec.js"],"names":[],"mappings":""}

package/src/engine/ecs/guid/{GUID.spec.js → UUID.spec.js}

@@ -1,15 +1,15 @@
-import { GUID } from "./GUID.js";
+import { UUID } from "./UUID.js";
 
 test("uniqueness out of 2", () => {
-    const a = GUID.v1();
-    const b = GUID.v1();
+    const a = UUID.v1();
+    const b = UUID.v1();
 
     expect(a.equals(b)).toBe(false);
 });
 
 test("equality", () => {
-    const a = GUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
-    const b = GUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
+    const a = UUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
+    const b = UUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
 
     expect(a.equals(b)).toBe(true);
 
@@ -19,16 +19,16 @@ test("equality", () => {
 });
 
 test("hash stability", () => {
-    const guid = new GUID();
+    const guid = new UUID();
 
     expect(guid.hash()).toBe(guid.hash());
 });
 
 test("copy", () => {
-    const a = GUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
+    const a = UUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
     const a_string = a.toString();
 
-    const b = GUID.parse("bb75b300-c89f-11ed-afa1-0242ac120002");
+    const b = UUID.parse("bb75b300-c89f-11ed-afa1-0242ac120002");
 
     expect(a.equals(b)).toBe(false);
 
@@ -41,9 +41,9 @@ test("copy", () => {
 });
 
 test("to/from JSON consistency", () => {
-    const a = GUID.parse("bb75b300-c89f-11ed-afa1-0242ac120002");
+    const a = UUID.parse("bb75b300-c89f-11ed-afa1-0242ac120002");
 
-    const b = new GUID();
+    const b = new UUID();
 
     b.fromJSON(a.toJSON());
 
@@ -51,7 +51,7 @@ test("to/from JSON consistency", () => {
 });
 
 test(".data setter performs a copy instead of assignment", () => {
-    const id = new GUID();
+    const id = new UUID();
 
     const data = new Uint8Array(16);
 
@@ -61,7 +61,7 @@ test(".data setter performs a copy instead of assignment", () => {
 });
 
 test(".data set/get", () => {
-    const a = new GUID();
+    const a = new UUID();
 
     const sample_0 = [
         0xFF, 0xFF, 0xFF, 0xFF,
@@ -85,3 +85,9 @@ test(".data set/get", () => {
 
     expect(Array.from(a.data)).toEqual(sample_1);
 });
+
+test("version bits in v4", () => {
+    const uuid = UUID.v4();
+
+    expect((uuid.data[6] >> 4) & 0xF).toEqual(4);
+});

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

@@ -0,0 +1,18 @@
+export class UUIDSerializationAdapter extends BinaryClassSerializationAdapter {
+    klass: typeof UUID;
+    /**
+     *
+     * @param buffer
+     * @param {UUID} value
+     */
+    serialize(buffer: any, value: UUID): void;
+    /**
+     *
+     * @param buffer
+     * @param {UUID} value
+     */
+    deserialize(buffer: any, value: UUID): void;
+}
+import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
+import { UUID } from "./UUID.js";
+//# sourceMappingURL=UUIDSerializationAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/guid/UUIDSerializationAdapter.js"],"names":[],"mappings":"AAGA;IACI,mBAAY;IAGZ;;;;OAIG;IACH,8BAFW,IAAI,QAId;IAED;;;;OAIG;IACH,gCAFW,IAAI,QAId;CACJ;gDAxB+C,sDAAsD;qBACjF,WAAW"}