@woosh/meep-engine 2.92.0 → 2.92.4

package/build/meep.module.js

@@ -101296,6 +101296,11 @@ function easeInOutQuad(t) {
  * @returns {boolean}
  */
 function objectDeepEquals(a, b) {
+    if (a === b) {
+        // identity shortcut
+        return true;
+    }
+
     const tA = typeof a;
     const tB = typeof b;
 
@@ -101303,7 +101308,16 @@ function objectDeepEquals(a, b) {
         return false;
     }
 
-    if (tA === "object") {
+    if (tA !== "object") {
+        // primitive types, identity equality already checked
+        return false;
+    } else {
+
+        if (a === null || b === null) {
+            // we know that A and B are not the same, so if one of them is a null - there is no possible equality
+            return false;
+        }
+
         if (Array.isArray(a)) {
             // special fast path for arrays
             if (!Array.isArray(b)) {
@@ -101333,8 +101347,6 @@ function objectDeepEquals(a, b) {
 
         return true;
 
-    } else {
-        return a === b;
     }
 }
 

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.92.0",
+  "version": "2.92.4",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/binary/data_view/DataType2DataViewReaders.d.ts

@@ -0,0 +1,14 @@
+export type DataType2DataViewReaders = string;
+export namespace DataType2DataViewReaders {
+    let uint8: string;
+    let uint16: string;
+    let uint32: string;
+    let uint64: string;
+    let int8: string;
+    let int16: string;
+    let int32: string;
+    let int64: string;
+    let float32: string;
+    let float64: string;
+}
+//# sourceMappingURL=DataType2DataViewReaders.d.ts.map

package/src/core/binary/data_view/DataType2DataViewReaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataType2DataViewReaders.d.ts","sourceRoot":"","sources":["../../../../../src/core/binary/data_view/DataType2DataViewReaders.js"],"names":[],"mappings":"uCAKU,MAAM"}

package/src/core/binary/data_view/DataType2DataViewReaders.js

@@ -0,0 +1,21 @@
+import { BinaryDataType } from "../type/BinaryDataType.js";
+
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
+ * @readonly
+ * @enum {string}
+ */
+export const DataType2DataViewReaders = {
+    [BinaryDataType.Uint8]: "getUint8",
+    [BinaryDataType.Uint16]: "getUint16",
+    [BinaryDataType.Uint32]: "getUint32",
+    [BinaryDataType.Uint64]: "getUint64",
+
+    [BinaryDataType.Int8]: "getInt8",
+    [BinaryDataType.Int16]: "getInt16",
+    [BinaryDataType.Int32]: "getInt32",
+    [BinaryDataType.Int64]: "getInt64",
+
+    [BinaryDataType.Float32]: "getFloat32",
+    [BinaryDataType.Float64]: "getFloat64"
+};

package/src/core/binary/data_view/DataType2DataViewWriters.d.ts

@@ -0,0 +1,14 @@
+export type DataType2DataViewWriters = string;
+export namespace DataType2DataViewWriters {
+    let uint8: string;
+    let uint16: string;
+    let uint32: string;
+    let uint64: string;
+    let int8: string;
+    let int16: string;
+    let int32: string;
+    let int64: string;
+    let float32: string;
+    let float64: string;
+}
+//# sourceMappingURL=DataType2DataViewWriters.d.ts.map

package/src/core/binary/data_view/DataType2DataViewWriters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataType2DataViewWriters.d.ts","sourceRoot":"","sources":["../../../../../src/core/binary/data_view/DataType2DataViewWriters.js"],"names":[],"mappings":"uCAKU,MAAM"}

package/src/core/binary/data_view/DataType2DataViewWriters.js

@@ -0,0 +1,21 @@
+import { BinaryDataType } from "../type/BinaryDataType.js";
+
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
+ * @readonly
+ * @enum {string}
+ */
+export const DataType2DataViewWriters = {
+    [BinaryDataType.Uint8]: "setUint8",
+    [BinaryDataType.Uint16]: "setUint16",
+    [BinaryDataType.Uint32]: "setUint32",
+    [BinaryDataType.Uint64]: "setUint64",
+
+    [BinaryDataType.Int8]: "setInt8",
+    [BinaryDataType.Int16]: "setInt16",
+    [BinaryDataType.Int32]: "setInt32",
+    [BinaryDataType.Int64]: "setInt64",
+
+    [BinaryDataType.Float32]: "setFloat32",
+    [BinaryDataType.Float64]: "setFloat64"
+};

package/src/core/binary/data_view/DataViewStructAccessor.d.ts

@@ -0,0 +1,17 @@
+import {BinaryDataType} from "../type/BinaryDataType";
+
+interface IBinarySchema {
+    [k: string]: BinaryDataType
+}
+
+
+export class DataViewStructAccessor<T extends IBinarySchema> {
+
+    constructor(type: T, little_endian?: boolean)
+
+    this: { [prop in keyof T]: number }
+
+    bind(view: DataView, offset: number): void
+
+    bind_by_index(view: DataView, index: number): void
+}

package/src/core/binary/data_view/DataViewStructAccessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewStructAccessor.d.ts","sourceRoot":"","sources":["../../../../../src/core/binary/data_view/DataViewStructAccessor.js"],"names":[],"mappings":"AAOA;IAiBI;;;;OAIG;IACH,yCAFW,OAAO,EAiCjB;IApDD;;OAEG;IACH,OAFU,QAAQ,CAEZ;IAEN;;OAEG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,4BAFU,MAAM,CAEM;IAwCtB;;;;OAIG;IACH,gBAHW,QAAQ,eACR,MAAM,QAKhB;IAED;;;;OAIG;IACH,yBAHW,QAAQ,SACR,MAAM,QAKhB;CACJ"}

package/src/core/binary/data_view/DataViewStructAccessor.js

@@ -0,0 +1,82 @@
+import { assert } from "../../assert.js";
+import { FunctionCompiler } from "../../function/FunctionCompiler.js";
+import { BinaryDataType } from "../type/BinaryDataType.js";
+import { DataTypeByteSizes } from "../type/DataTypeByteSizes.js";
+import { DataType2DataViewReaders } from "./DataType2DataViewReaders.js";
+import { DataType2DataViewWriters } from "./DataType2DataViewWriters.js";
+
+export class DataViewStructAccessor {
+    /**
+     * @type {DataView}
+     */
+    $data;
+
+    /**
+     * @type {number}
+     */
+    $offset = 0;
+
+    /**
+     * @readonly
+     * @type {number}
+     */
+    $record_byte_size = 0;
+
+    /**
+     *
+     * @param {Object<BinaryDataType>} schema
+     * @param {boolean} [little_endian]
+     */
+    constructor(schema, little_endian = false) {
+        assert.defined(schema, 'schema');
+        assert.isBoolean(little_endian, 'little_endian');
+
+        const props = Object.keys(schema);
+        const property_count = props.length;
+
+        let offset = 0;
+        for (let i = 0; i < property_count; i++) {
+            const property = props[i];
+            const type = schema[property];
+
+            assert.enum(type, BinaryDataType, "type");
+
+            assert.arrayHasNo(["bind", "$data", "$offset", "this", "constructor"], property, `Illegal property name ${property}`);
+
+            //
+            Object.defineProperty(this, property, {
+                get: FunctionCompiler.INSTANCE.compile({
+                    code: `return this.$data.${DataType2DataViewReaders[type]}(this.$offset + ${offset}, ${little_endian})`
+                }),
+                set: FunctionCompiler.INSTANCE.compile({
+                    args: ["value"],
+                    code: `this.$data.${DataType2DataViewWriters[type]}(this.$offset + ${offset}, value, ${little_endian})`
+                })
+            })
+
+            offset += DataTypeByteSizes[type];
+        }
+
+        this.$record_byte_size = offset;
+    }
+
+    /**
+     *
+     * @param {DataView} data_view
+     * @param {number} byte_offset
+     */
+    bind(data_view, byte_offset) {
+        this.$data = data_view;
+        this.$offset = byte_offset;
+    }
+
+    /**
+     *
+     * @param {DataView} data_view
+     * @param {number} index
+     */
+    bind_by_index(data_view, index) {
+        this.$data = data_view;
+        this.$offset = index * this.$record_byte_size;
+    }
+}

package/src/core/binary/data_view/DataViewStructAccessor.spec.d.ts

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

package/src/core/binary/data_view/DataViewStructAccessor.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewStructAccessor.spec.d.ts","sourceRoot":"","sources":["../../../../../src/core/binary/data_view/DataViewStructAccessor.spec.js"],"names":[],"mappings":""}

package/src/core/binary/data_view/DataViewStructAccessor.spec.js

@@ -0,0 +1,20 @@
+import { BinaryDataType } from "../type/BinaryDataType.js";
+import { DataViewStructAccessor } from "./DataViewStructAccessor.js";
+
+test("2 field schema", () => {
+    const accessor = new DataViewStructAccessor({
+        alice: BinaryDataType.Float32,
+        bob: BinaryDataType.Uint8
+    });
+
+    const buffer = new ArrayBuffer(1024);
+    const dataView = new DataView(buffer);
+
+    accessor.bind(dataView, 1);
+
+    accessor.alice = -3.7;
+    accessor.bob = 7;
+
+    expect(dataView.getFloat32(1)).toBeCloseTo(-3.7);
+    expect(dataView.getUint8(5)).toBe(7);
+});

package/src/core/collection/table/RowFirstTableSpec.d.ts

@@ -1,39 +1,3 @@
-export type DataType2DataViewReaders = string;
-export namespace DataType2DataViewReaders {
-    let uint8: string;
-    let uint16: string;
-    let uint32: string;
-    let uint64: string;
-    let int8: string;
-    let int16: string;
-    let int32: string;
-    let int64: string;
-    let float32: string;
-    let float64: string;
-}
-export type DataType2DataViewWriters = string;
-export namespace DataType2DataViewWriters {
-    let uint8_1: string;
-    export { uint8_1 as uint8 };
-    let uint16_1: string;
-    export { uint16_1 as uint16 };
-    let uint32_1: string;
-    export { uint32_1 as uint32 };
-    let uint64_1: string;
-    export { uint64_1 as uint64 };
-    let int8_1: string;
-    export { int8_1 as int8 };
-    let int16_1: string;
-    export { int16_1 as int16 };
-    let int32_1: string;
-    export { int32_1 as int32 };
-    let int64_1: string;
-    export { int64_1 as int64 };
-    let float32_1: string;
-    export { float32_1 as float32 };
-    let float64_1: string;
-    export { float64_1 as float64 };
-}
 /**
  * This is a schema class for binary data tables of class {@link RowFirstTable}
  * @class

package/src/core/collection/table/RowFirstTableSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowFirstTableSpec.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTableSpec.js"],"names":[],"mappings":"uCAiBU,MAAM;;;;;;;;;;;;;uCAoBN,MAAM;;;;;;;;;;;;;;;;;;;;;;;AAgIhB;;;GAGG;AACH;IA6GI;;;;;OAKG;IACH,kBAJW,cAAc,EAAE,eAChB,UAAU,GACR,iBAAiB,CAgB7B;IAhID;;;;;OAKG;IACH,mBAJW,cAAc,EAAE,eAChB,UAAU,EAsEpB;IA9DG;;;OAGG;IACH,gBAFU,cAAc,EAAE,CAER;IAElB;;;OAGG;IACH,qBAFU,UAAU,CAEQ;IAE5B;;;OAGG;IACH,wBAFU,WAAW,CAEyB;IAc9C;;;OAGG;IACH,yBAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,+BAFmB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAEA;IAEpD;;;OAGG;IACH,gCAFmB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAEC;IAIrD,mBAAsC;IACtC,mBAAsC;IAMtC;;;OAGG;IACH,8BAFU,OAAO,CAEc;IAGnC;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;OAGG;IACH,QAFY,MAAM,CAQjB;IAED;;;;OAIG;IACH,cAHW,iBAAiB,GACf,OAAO,CAQnB;CAuBJ;+BArS8B,qCAAqC;2BADzC,4BAA4B"}
+{"version":3,"file":"RowFirstTableSpec.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTableSpec.js"],"names":[],"mappings":"AA+HA;;;GAGG;AACH;IA6GI;;;;;OAKG;IACH,kBAJW,cAAc,EAAE,eAChB,UAAU,GACR,iBAAiB,CAgB7B;IAhID;;;;;OAKG;IACH,mBAJW,cAAc,EAAE,eAChB,UAAU,EAsEpB;IA9DG;;;OAGG;IACH,gBAFU,cAAc,EAAE,CAER;IAElB;;;OAGG;IACH,qBAFU,UAAU,CAEQ;IAE5B;;;OAGG;IACH,wBAFU,WAAW,CAEyB;IAc9C;;;OAGG;IACH,yBAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,+BAFmB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAEA;IAEpD;;;OAGG;IACH,gCAFmB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAEC;IAIrD,mBAAsC;IACtC,mBAAsC;IAMtC;;;OAGG;IACH,8BAFU,OAAO,CAEc;IAGnC;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;OAGG;IACH,QAFY,MAAM,CAQjB;IAED;;;;OAIG;IACH,cAHW,iBAAiB,GACf,OAAO,CAQnB;CAuBJ;+BA7P8B,qCAAqC;2BADzC,4BAA4B"}

package/src/core/collection/table/RowFirstTableSpec.js

@@ -3,6 +3,8 @@
  * @enum {string}
  */
 import { assert } from "../../assert.js";
+import { DataType2DataViewReaders } from "../../binary/data_view/DataType2DataViewReaders.js";
+import { DataType2DataViewWriters } from "../../binary/data_view/DataType2DataViewWriters.js";
 import { EndianType } from "../../binary/EndianType.js";
 import { BinaryDataType } from "../../binary/type/BinaryDataType.js";
 import { DataTypeByteSizes } from "../../binary/type/DataTypeByteSizes.js";
@@ -12,46 +14,6 @@ import { computeStringHash } from "../../primitives/strings/computeStringHash.js
 import { computeHashArray } from "../array/computeHashArray.js";
 import { isArrayEqualStrict } from "../array/isArrayEqualStrict.js";
 
-/**
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
- * @readonly
- * @enum {string}
- */
-export const DataType2DataViewReaders = {
-    [BinaryDataType.Uint8]: "getUint8",
-    [BinaryDataType.Uint16]: "getUint16",
-    [BinaryDataType.Uint32]: "getUint32",
-    [BinaryDataType.Uint64]: "getUint64",
-
-    [BinaryDataType.Int8]: "getInt8",
-    [BinaryDataType.Int16]: "getInt16",
-    [BinaryDataType.Int32]: "getInt32",
-    [BinaryDataType.Int64]: "getInt64",
-
-    [BinaryDataType.Float32]: "getFloat32",
-    [BinaryDataType.Float64]: "getFloat64"
-};
-
-/**
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
- * @readonly
- * @enum {string}
- */
-export const DataType2DataViewWriters = {
-    [BinaryDataType.Uint8]: "setUint8",
-    [BinaryDataType.Uint16]: "setUint16",
-    [BinaryDataType.Uint32]: "setUint32",
-    [BinaryDataType.Uint64]: "setUint64",
-
-    [BinaryDataType.Int8]: "setInt8",
-    [BinaryDataType.Int16]: "setInt16",
-    [BinaryDataType.Int32]: "setInt32",
-    [BinaryDataType.Int64]: "setInt64",
-
-    [BinaryDataType.Float32]: "setFloat32",
-    [BinaryDataType.Float64]: "setFloat64"
-};
-
 /**
  *
  * @param {BinaryDataType[]} types
@@ -134,7 +96,7 @@ function genRowWriter(types, endianType = EndianType.BigEndian) {
  * @param {EndianType} [endianType]
  * @returns {function(data_view:DataView, byte_offset:number, value:number):void}
  */
-function genCellWriter(type, offset, endianType = EndianType.BigEndian) {
+function compileDataViewValueWriter(type, offset, endianType = EndianType.BigEndian) {
     const writeMethod = DataType2DataViewWriters[type];
 
     const littleEndianFlag = endianType === EndianType.BigEndian ? 'false' : 'true';
@@ -152,7 +114,7 @@ function genCellWriter(type, offset, endianType = EndianType.BigEndian) {
  * @param {EndianType} [endianType]
  * @returns {function(data_view:DataView, byte_offset:number):number}
  */
-function genCellReader(type, offset, endianType = EndianType.BigEndian) {
+function compileDataViewValueReader(type, offset, endianType = EndianType.BigEndian) {
     const readMethod = DataType2DataViewReaders[type];
 
     const littleEndianFlag = endianType === EndianType.BigEndian ? 'false' : 'true';
@@ -233,8 +195,8 @@ export class RowFirstTableSpec {
         this.cellReaders = new Array(numTypes);
 
         for (let i = 0; i < numTypes; i++) {
-            this.cellReaders[i] = genCellReader(types[i], this.columnOffsets[i], endianType);
-            this.cellWriters[i] = genCellWriter(types[i], this.columnOffsets[i], endianType);
+            this.cellReaders[i] = compileDataViewValueReader(types[i], this.columnOffsets[i], endianType);
+            this.cellWriters[i] = compileDataViewValueWriter(types[i], this.columnOffsets[i], endianType);
         }
         /**
          * @readonly

package/src/core/model/object/objectDeepEquals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectDeepEquals.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/objectDeepEquals.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,oDAFa,OAAO,CA2CnB"}
+{"version":3,"file":"objectDeepEquals.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/objectDeepEquals.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,oDAFa,OAAO,CAuDnB"}

package/src/core/model/object/objectDeepEquals.js

@@ -1,5 +1,5 @@
-import { isArraysEqualWithComparator } from "../../collection/array/isArraysEqualWithComparator.js";
 import { isArrayEqualStrict } from "../../collection/array/isArrayEqualStrict.js";
+import { isArraysEqualWithComparator } from "../../collection/array/isArraysEqualWithComparator.js";
 
 /**
  * @template A,B
@@ -8,6 +8,11 @@ import { isArrayEqualStrict } from "../../collection/array/isArrayEqualStrict.js
  * @returns {boolean}
  */
 export function objectDeepEquals(a, b) {
+    if (a === b) {
+        // identity shortcut
+        return true;
+    }
+
     const tA = typeof a;
     const tB = typeof b;
 
@@ -15,7 +20,16 @@ export function objectDeepEquals(a, b) {
         return false;
     }
 
-    if (tA === "object") {
+    if (tA !== "object") {
+        // primitive types, identity equality already checked
+        return false;
+    } else {
+
+        if (a === null || b === null) {
+            // we know that A and B are not the same, so if one of them is a null - there is no possible equality
+            return false;
+        }
+
         if (Array.isArray(a)) {
             // special fast path for arrays
             if (!Array.isArray(b)) {
@@ -45,7 +59,5 @@ export function objectDeepEquals(a, b) {
 
         return true;
 
-    } else {
-        return a === b;
     }
 }

package/src/core/model/object/objectDeepEquals.spec.js

@@ -12,3 +12,43 @@ test('objectDeepEquals', () => {
 
     expect(objectDeepEquals({ a: 1 }, { a: 1, b: "cat" })).toBe(false);
 });
+
+test("null values", () => {
+    expect(objectDeepEquals(null, null)).toBe(true);
+    expect(objectDeepEquals(null, {})).toBe(false);
+    expect(objectDeepEquals({}, null)).toBe(false);
+});
+
+test("same-type primitives", () => {
+    expect(objectDeepEquals(1, 1)).toBe(true);
+    expect(objectDeepEquals(-1, 1)).toBe(false);
+    expect(objectDeepEquals(-1, -1)).toBe(true);
+    expect(objectDeepEquals(-1, -3)).toBe(false);
+
+    expect(objectDeepEquals("cat", "cat")).toBe(true);
+    expect(objectDeepEquals("cat", "")).toBe(false);
+    expect(objectDeepEquals("", "cat")).toBe(false);
+    expect(objectDeepEquals("sat", "cat")).toBe(false);
+    expect(objectDeepEquals("cat", "sat")).toBe(false);
+
+    expect(objectDeepEquals(true, false)).toBe(false);
+    expect(objectDeepEquals(false, true)).toBe(false);
+    expect(objectDeepEquals(true, true)).toBe(true);
+    expect(objectDeepEquals(false, false)).toBe(true);
+
+    expect(objectDeepEquals(undefined, undefined)).toBe(true);
+});
+
+test("mixed primitives", () => {
+    expect(objectDeepEquals(1, undefined)).toBe(false);
+    expect(objectDeepEquals(undefined, 1)).toBe(false);
+
+    expect(objectDeepEquals("cat", 1)).toBe(false);
+    expect(objectDeepEquals(1, "cat")).toBe(false);
+
+    expect(objectDeepEquals(1, true)).toBe(false);
+    expect(objectDeepEquals(true, 1)).toBe(false);
+
+    expect(objectDeepEquals("cat", undefined)).toBe(false);
+    expect(objectDeepEquals(undefined, "cat")).toBe(false);
+});