@woosh/meep-engine 2.121.4 → 2.121.6

package/package.json

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

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,10 @@
+/**
+ * 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
+ * @param {number} [offset_into_exponent]
+ * @returns {number} mantissa
+ */
+export function frexp(value: number, exponent: number[], offset_into_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;;;;;;;GAOG;AACH,6BALW,MAAM,YACN,MAAM,EAAE,yBACR,MAAM,GACJ,MAAM,CAqClB"}

package/src/core/math/frexp.js

@@ -0,0 +1,44 @@
+/**
+ * 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
+ * @param {number} [offset_into_exponent]
+ * @returns {number} mantissa
+ */
+export function frexp(value, exponent, offset_into_exponent = 0) {
+    if (value === 0 || Number.isFinite(value) === false) {
+        exponent[offset_into_exponent] = 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[offset_into_exponent] = exp;
+
+    return mantissa;
+}