@woosh/meep-engine 2.81.3 → 2.81.4

package/build/meep.cjs

@@ -75559,6 +75559,7 @@ function planeHash(plane) {
  * @template T
  * @param {T[]} array
  * @param {function(T):number} elementHashFunction
+ * @returns {number}
  */
 function computeHashArray(array, elementHashFunction) {
 

package/build/meep.module.js

@@ -75557,6 +75557,7 @@ function planeHash(plane) {
  * @template T
  * @param {T[]} array
  * @param {function(T):number} elementHashFunction
+ * @returns {number}
  */
 function computeHashArray(array, elementHashFunction) {
 

package/package.json

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

package/src/core/collection/array/computeHashArray.js

@@ -1,9 +1,14 @@
+import { assert } from "../../assert.js";
+
 /**
  * @template T
  * @param {T[]} array
  * @param {function(T):number} elementHashFunction
+ * @returns {number}
  */
 export function computeHashArray(array, elementHashFunction) {
+    assert.isArrayLike(array, 'array');
+    assert.isFunction(elementHashFunction, 'elementHashFunction');
 
     const numArguments = array.length;
     let hash = numArguments;

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

@@ -13,41 +13,43 @@ 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 = {
-    "uint8": "getUint8",
-    "uint16": "getUint16",
-    "uint32": "getUint32",
-    "uint64": "getUint64",
-
-    "int8": "getInt8",
-    "int16": "getInt16",
-    "int32": "getInt32",
-    "int64": "getInt64",
-
-    "float32": "getFloat32",
-    "float64": "getFloat64"
+    [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 = {
-    "uint8": "setUint8",
-    "uint16": "setUint16",
-    "uint32": "setUint32",
-    "uint64": "setUint64",
-
-    "int8": "setInt8",
-    "int16": "setInt16",
-    "int32": "setInt32",
-    "int64": "setInt64",
-
-    "float32": "setFloat32",
-    "float64": "setFloat64"
+    [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"
 };
 
 /**
@@ -67,10 +69,14 @@ function genRowReader(types, endianType = EndianType.BigEndian) {
 
         const type = types[i];
 
+        const reader_name = DataType2DataViewReaders[type];
+
+        assert.isString(reader_name, 'reader_name');
+
         const littleEndianFlag = endianType === EndianType.BigEndian ? 'false' : 'true';
 
         // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
-        lines.push(`result[${i}] = dataView.${DataType2DataViewReaders[type]}(${offset} + byteOffset, ${littleEndianFlag});`);
+        lines.push(`result[${i}] = dataView.${reader_name}(${offset} + byteOffset, ${littleEndianFlag});`);
 
         offset += DataTypeByteSizes[type];
 
@@ -100,10 +106,14 @@ function genRowWriter(types, endianType = EndianType.BigEndian) {
     for (let i = 0; i < numTypes; i++) {
         const type = types[i];
 
+        const writer_name = DataType2DataViewWriters[type];
+
+        assert.isString(writer_name, 'writer_name');
+
         const littleEndianFlag = endianType === EndianType.BigEndian ? 'false' : 'true';
 
         // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView
-        lines.push(`dataView.${DataType2DataViewWriters[type]}(${offset} + byteOffset, record[${i}], ${littleEndianFlag});`);
+        lines.push(`dataView.${writer_name}(${offset} + byteOffset, record[${i}], ${littleEndianFlag});`);
 
         offset += DataTypeByteSizes[type];
     }
@@ -267,7 +277,7 @@ export class RowFirstTableSpec {
     }
 
     /**
-     *
+     * Produces an immutable spec, either creates a new spec or retrieves a cached version
      * @param {BinaryDataType[]} types
      * @param {EndianType} [endianType]
      * @returns {RowFirstTableSpec}
@@ -276,21 +286,25 @@ export class RowFirstTableSpec {
         //compute hash
         const hash = types.join('.') + ':' + endianType;
 
-        const cachedValue = cache.get(hash);
+        const cachedValue = SPEC_CACHE.get(hash);
 
         if (cachedValue !== null) {
             return cachedValue;
         }
 
         const newValue = new RowFirstTableSpec(types);
-        cache.put(hash, newValue);
+        SPEC_CACHE.put(hash, newValue);
 
         return newValue;
     }
 }
 
 
-const cache = new Cache({
+/**
+ * @readonly
+ * @type {Cache<string,RowFirstTableSpec>}
+ */
+const SPEC_CACHE = new Cache({
     keyHashFunction: computeStringHash
 });