@woosh/meep-engine 2.121.3 → 2.121.5

package/package.json

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

package/src/core/geom/3d/aabb/aabb3_array_size.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculates the size of an axis-aligned bounding box (AABB) in 3D space and stores the result in the output array.
+ *
+ * @param {Float32Array} output - The array where the computed size values will be stored.
+ * @param {number} output_offset - The starting index in the output array where the size values will be written.
+ * @param {Float32Array} data - The array containing the AABB coordinates. Must contain six consecutive values: [minX, minY, minZ, maxX, maxY, maxZ].
+ * @param {number} offset - The starting index in the data array where the AABB coordinates begin.
+ * @return {void} This function does not return a value; it writes the calculated size values directly into the output array.
+ */
+export function aabb3_array_size(output: Float32Array, output_offset: number, data: Float32Array, offset: number): void;
+//# sourceMappingURL=aabb3_array_size.d.ts.map

package/src/core/geom/3d/aabb/aabb3_array_size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aabb3_array_size.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_array_size.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,yCANW,YAAY,iBACZ,MAAM,QACN,YAAY,UACZ,MAAM,GACL,IAAI,CAUf"}

package/src/core/geom/3d/aabb/aabb3_array_size.js

@@ -0,0 +1,18 @@
+/**
+ * Calculates the size of an axis-aligned bounding box (AABB) in 3D space and stores the result in the output array.
+ *
+ * @param {Float32Array} output - The array where the computed size values will be stored.
+ * @param {number} output_offset - The starting index in the output array where the size values will be written.
+ * @param {Float32Array} data - The array containing the AABB coordinates. Must contain six consecutive values: [minX, minY, minZ, maxX, maxY, maxZ].
+ * @param {number} offset - The starting index in the data array where the AABB coordinates begin.
+ * @return {void} This function does not return a value; it writes the calculated size values directly into the output array.
+ */
+export function aabb3_array_size(output, output_offset, data, offset) {
+    const x_size = data[offset + 3] - data[offset];
+    const y_size = data[offset + 4] - data[offset + 1];
+    const z_size = data[offset + 5] - data[offset + 2];
+
+    output[output_offset] = x_size;
+    output[output_offset + 1] = y_size;
+    output[output_offset + 2] = z_size;
+}

package/src/core/geom/vec2/v2_angle_between.d.ts

@@ -1,10 +1,10 @@
 /**
  *
- * @param {number} x0
- * @param {number} y0
- * @param {number} x1
- * @param {number} y1
- * @returns {number}
+ * @param {number} x0 first vector X
+ * @param {number} y0 first vector Y
+ * @param {number} x1 second vector X
+ * @param {number} y1 second vector Y
+ * @returns {number} in radians
  */
 export function v2_angle_between(x0: number, y0: number, x1: number, y1: number): number;
 //# sourceMappingURL=v2_angle_between.d.ts.map

package/src/core/geom/vec2/v2_angle_between.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2_angle_between.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec2/v2_angle_between.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CASlB"}
+{"version":3,"file":"v2_angle_between.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec2/v2_angle_between.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAkBlB"}

package/src/core/geom/vec2/v2_angle_between.js

@@ -4,15 +4,24 @@ import { v2_length } from "./v2_length.js";
 
 /**
  *
- * @param {number} x0
- * @param {number} y0
- * @param {number} x1
- * @param {number} y1
- * @returns {number}
+ * @param {number} x0 first vector X
+ * @param {number} y0 first vector Y
+ * @param {number} x1 second vector X
+ * @param {number} y1 second vector Y
+ * @returns {number} in radians
  */
 export function v2_angle_between(x0, y0, x1, y1) {
     const d = v2_dot(x0, y0, x1, y1);
-    const l = v2_length(x0, y0) * v2_length(x1, y1);
+
+    const magnitude_0 = v2_length(x0, y0);
+    const magnitude_1 = v2_length(x1, y1);
+
+    const l = magnitude_0 * magnitude_1;
+
+    if (l === 0) {
+        // collective magnitude is 0, provide arbitrary result to avoid division by 0
+        return 0;
+    }
 
     const theta = clamp(d / l, -1, 1);
 

package/src/core/geom/vec2/v2_dot.d.ts

@@ -1,5 +1,5 @@
 /**
- *
+ * Vector DOT product in 2D
  * @param {number} x0
  * @param {number} y0
  * @param {number} x1

package/src/core/geom/vec2/v2_dot.js

@@ -1,7 +1,7 @@
 import { assert } from "../../assert.js";
 
 /**
- *
+ * Vector DOT product in 2D
  * @param {number} x0
  * @param {number} y0
  * @param {number} x1

package/src/core/math/frexp.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decomposes a floating-point number into a normalized fraction and an integer power of 2.
+ * Similar to C's frexp function.
+ * @param {number} value - The floating-point number to decompose
+ * @param {number[]} exponent where to write exponent to
+ * @returns {number} mantissa
+ */
+export function frexp(value: number, exponent: number[]): number;
+//# sourceMappingURL=frexp.d.ts.map

package/src/core/math/frexp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frexp.d.ts","sourceRoot":"","sources":["../../../../src/core/math/frexp.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,6BAJW,MAAM,YACN,MAAM,EAAE,GACN,MAAM,CAqClB"}

package/src/core/math/frexp.js

@@ -0,0 +1,43 @@
+/**
+ * Decomposes a floating-point number into a normalized fraction and an integer power of 2.
+ * Similar to C's frexp function.
+ * @param {number} value - The floating-point number to decompose
+ * @param {number[]} exponent where to write exponent to
+ * @returns {number} mantissa
+ */
+export function frexp(value, exponent) {
+    if (value === 0 || Number.isFinite(value) === false) {
+        exponent[0] = 0;
+        return value;
+    }
+
+    let abs_value = Math.abs(value);
+
+    // Get the exponent using Math.log2 and floor it
+    let exp = Math.max(
+        -1023,
+        Math.floor(Math.log2(abs_value)) + 1
+    );
+
+    // Calculate the mantissa by dividing by 2^exp
+    let mantissa = abs_value * Math.pow(2, -exp);
+
+    // These while loops compensate for rounding errors that sometimes occur because of ECMAScript's Math.log2's undefined precision
+    // and also works around the issue of Math.pow(2, -exp) === Infinity when exp <= -1024
+    while (mantissa < 0.5) {
+        mantissa *= 2;
+        exp--;
+    }
+    while (mantissa >= 1) {
+        mantissa *= 0.5;
+        exp++;
+    }
+
+    if (value < 0) {
+        mantissa = -mantissa;
+    }
+
+    exponent[0] = exp;
+
+    return mantissa;
+}

package/src/core/science/units/memory/GIGABYTE.d.ts

@@ -1,5 +1,6 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Gigabyte
+ *
  * NOTE: Single gigabyte value takes up 30 bits, maximum addressable 32 bit value is 4Gb(-1)
  * @type {number}
  * @example

package/src/core/science/units/memory/GIGABYTE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GIGABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/GIGABYTE.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,uBAJU,MAAM,CAI2B"}
+{"version":3,"file":"GIGABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/GIGABYTE.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,uBAJU,MAAM,CAI2B"}

package/src/core/science/units/memory/GIGABYTE.js

@@ -1,5 +1,6 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Gigabyte
+ *
  * NOTE: Single gigabyte value takes up 30 bits, maximum addressable 32 bit value is 4Gb(-1)
  * @type {number}
  * @example

package/src/core/science/units/memory/KILOBYTE.d.ts

@@ -1,5 +1,5 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Kilobyte
  * @type {number}
  * @example
  *  100 * KILOBYTE // 100 Kb

package/src/core/science/units/memory/KILOBYTE.js

@@ -1,5 +1,5 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Kilobyte
  * @type {number}
  * @example
  *  100 * KILOBYTE // 100 Kb

package/src/core/science/units/memory/MEGABYTE.d.ts

@@ -1,5 +1,5 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Megabyte
  * @type {number}
  * @example
  *  100 * MEGABYTE // 100 Mb

package/src/core/science/units/memory/MEGABYTE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MEGABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/MEGABYTE.js"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,uBAJU,MAAM,CAIoB"}
+{"version":3,"file":"MEGABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/MEGABYTE.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,uBAJU,MAAM,CAIoB"}

package/src/core/science/units/memory/MEGABYTE.js

@@ -1,6 +1,5 @@
-
 /**
- * Useful shortcut
+ * Number of bytes in a single Megabyte
  * @type {number}
  * @example
  *  100 * MEGABYTE // 100 Mb

package/src/core/science/units/memory/TERABYTE.d.ts

@@ -1,5 +1,6 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Terabyte.
+ *
  * NOTE: this number does not fit in a 32bit integer. A single Tb requires 40 bits to express
  * @type {number}
  * @example

package/src/core/science/units/memory/TERABYTE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TERABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/TERABYTE.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,uBAJU,MAAM,CAIkC"}
+{"version":3,"file":"TERABYTE.d.ts","sourceRoot":"","sources":["../../../../../../src/core/science/units/memory/TERABYTE.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,uBAJU,MAAM,CAIkC"}

package/src/core/science/units/memory/TERABYTE.js

@@ -1,5 +1,6 @@
 /**
- * Useful shortcut
+ * Number of bytes in a single Terabyte.
+ *
  * NOTE: this number does not fit in a 32bit integer. A single Tb requires 40 bits to express
  * @type {number}
  * @example