@pawells/math-extended 1.0.5 → 2.0.0

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/v/@pawells/math-extended)](https://www.npmjs.com/package/@pawells/math-extended)
 [![GitHub Release](https://img.shields.io/github/v/release/PhillipAWells/math-extended)](https://github.com/PhillipAWells/math-extended/releases)
 [![CI](https://github.com/PhillipAWells/math-extended/actions/workflows/ci.yml/badge.svg)](https://github.com/PhillipAWells/math-extended/actions/workflows/ci.yml)
-[![Node](https://img.shields.io/badge/node-%3E%3D24-brightgreen)](https://nodejs.org)
+[![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/PhillipAWells?style=social)](https://github.com/sponsors/PhillipAWells)
 
@@ -88,7 +88,7 @@ QuaternionUtils.QuaternionSLERP(q1, q2, 0.5);
 |--------|-------------|
 | `RandomInt(min, max)` | Random integer in `[min, max]` |
 | `RandomFloat(min, max)` | Random float in `[min, max)` |
-| `RandomBool(probability?)` | Random boolean with optional probability |
+| `RandomBool(probability?)` | Random boolean with optional probability; throws `RangeError` if probability is outside `[0, 1]` |
 | `RandomNormal(mean?, stdDev?)` | Normal-distributed random number |
 | `RandomChoice(array)` | Random element from an array |
 | `RandomSample(array, count)` | `count` unique random elements |
@@ -226,7 +226,7 @@ Matrices are `number[][]` arrays (`IMatrix`, `IMatrix1`–`IMatrix4`). All opera
 
 | Export | Description |
 |--------|-------------|
-| `MatrixLU(m)` | LU decomposition `{ L, U }` |
+| `MatrixLU(m)` | LU decomposition with partial pivoting `{ L, U, P }` |
 | `MatrixQR(m)` | QR decomposition `{ Q, R }` |
 | `MatrixCholesky(m)` | Cholesky decomposition `L` |
 | `MatrixEigen(m)` | Eigenvalue decomposition `{ eigenvalues, eigenvectors }` |
@@ -328,14 +328,14 @@ yarn watch          # Watch mode
 yarn typecheck      # Type check without building
 yarn lint           # ESLint
 yarn lint:fix       # ESLint with auto-fix
-yarn test           # Run tests (1077 tests)
+yarn test           # Run tests (1080 tests)
 yarn test:ui        # Interactive Vitest UI
 yarn test:coverage  # Tests with coverage report
 ```
 
 ## Requirements
 
-- Node.js >= 24.0.0
+- Node.js >= 22.0.0
 
 ## License
 

package/build/angles.d.ts

@@ -2,30 +2,70 @@
  * Converts degrees to radians
  * @param degrees - Angle in degrees
  * @returns Angle in radians
+ *
+ * @example
+     * ```typescript
+     * DegreesToRadians(180)  // Math.PI
+     * DegreesToRadians(90)   // Math.PI / 2
+     * DegreesToRadians(0)    // 0
+     * ```
  */
 export declare function DegreesToRadians(degrees: number): number;
 /**
  * Converts radians to degrees
  * @param radians - Angle in radians
  * @returns Angle in degrees
+ *
+ * @example
+     * ```typescript
+     * RadiansToDegrees(Math.PI)     // 180
+     * RadiansToDegrees(Math.PI / 2) // 90
+     * RadiansToDegrees(0)           // 0
+     * ```
  */
 export declare function RadiansToDegrees(radians: number): number;
 /**
  * Formats an angle in radians to a string representation in terms of π
  * @param radians - Angle in radians
  * @returns String representation of the angle
+ *
+ * @example
+     * ```typescript
+     * FormatRadians(0)             // '0'
+     * FormatRadians(Math.PI)       // 'π'
+     * FormatRadians(Math.PI / 2)   // 'π/2'
+     * FormatRadians(Math.PI / 4)   // 'π/4'
+     * FormatRadians(-Math.PI)      // '-π'
+     * ```
  */
 export declare function FormatRadians(radians: number): string;
 /**
  * Normalizes an angle in radians to be between 0 and 2π
  * @param radians - Angle in radians
- * @returns Normalized angle in radians (0 to 2π)
+ * @returns Normalized angle in radians in the range [0, 2π)
+ *
+ * @example
+     * ```typescript
+     * NormalizeRadians(3 * Math.PI)  // Math.PI  (wraps around)
+     * NormalizeRadians(-Math.PI)     // Math.PI  (negative angles normalized)
+     * NormalizeRadians(0)            // 0
+     * ```
  */
 export declare function NormalizeRadians(radians: number): number;
 /**
- * Normalizes an angle in degrees to be between 0 and 360
+ * Normalizes an angle in degrees to be between 0 and 360.
+ * Applies a floating-point epsilon cleanup so values within `1e-10` of 0 or 360
+ * are snapped to exactly 0, matching the behaviour of `NormalizeRadians`.
  * @param degrees - Angle in degrees
- * @returns Normalized angle in degrees (0 to 360)
+ * @returns Normalized angle in degrees in the range [0°, 360°)
+ *
+ * @example
+     * ```typescript
+     * NormalizeDegrees(450)   // 90  (wraps around 360°)
+     * NormalizeDegrees(-90)   // 270 (negative angles normalized)
+     * NormalizeDegrees(0)     // 0
+     * NormalizeDegrees(360 - 1e-11) // 0  (boundary epsilon snap)
+     * ```
  */
 export declare function NormalizeDegrees(degrees: number): number;
 //# sourceMappingURL=angles.d.ts.map

package/build/angles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"angles.d.ts","sourceRoot":"","sources":["../src/angles.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsCrD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}
+{"version":3,"file":"angles.d.ts","sourceRoot":"","sources":["../src/angles.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/build/angles.js

@@ -1,9 +1,5 @@
 const DEGREES_PER_HALF_REVOLUTION = 180;
 const DEGREES_PER_FULL_REVOLUTION = 360;
-const ANGLE_FRACTION_DENOMINATOR_3 = 3;
-const ANGLE_FRACTION_DENOMINATOR_6 = 6;
-const ANGLE_FRACTION_QUARTER = 0.25;
-const ANGLE_FRACTION_THREE_QUARTERS = 0.75;
 const ANGLE_FRACTION_TOLERANCE = 0.0001;
 const ANGLE_MAX_DENOMINATOR = 12;
 const NORMALIZE_EPSILON = 1e-10; // Epsilon for floating-point boundary cleanup
@@ -11,6 +7,13 @@ const NORMALIZE_EPSILON = 1e-10; // Epsilon for floating-point boundary cleanup
  * Converts degrees to radians
  * @param degrees - Angle in degrees
  * @returns Angle in radians
+ *
+ * @example
+     * ```typescript
+     * DegreesToRadians(180)  // Math.PI
+     * DegreesToRadians(90)   // Math.PI / 2
+     * DegreesToRadians(0)    // 0
+     * ```
  */
 export function DegreesToRadians(degrees) {
     return (degrees * Math.PI) / DEGREES_PER_HALF_REVOLUTION;
@@ -19,6 +22,13 @@ export function DegreesToRadians(degrees) {
  * Converts radians to degrees
  * @param radians - Angle in radians
  * @returns Angle in degrees
+ *
+ * @example
+     * ```typescript
+     * RadiansToDegrees(Math.PI)     // 180
+     * RadiansToDegrees(Math.PI / 2) // 90
+     * RadiansToDegrees(0)           // 0
+     * ```
  */
 export function RadiansToDegrees(radians) {
     return (radians * DEGREES_PER_HALF_REVOLUTION) / Math.PI;
@@ -27,6 +37,15 @@ export function RadiansToDegrees(radians) {
  * Formats an angle in radians to a string representation in terms of π
  * @param radians - Angle in radians
  * @returns String representation of the angle
+ *
+ * @example
+     * ```typescript
+     * FormatRadians(0)             // '0'
+     * FormatRadians(Math.PI)       // 'π'
+     * FormatRadians(Math.PI / 2)   // 'π/2'
+     * FormatRadians(Math.PI / 4)   // 'π/4'
+     * FormatRadians(-Math.PI)      // '-π'
+     * ```
  */
 export function FormatRadians(radians) {
     const r = radians / Math.PI;
@@ -36,32 +55,19 @@ export function FormatRadians(radians) {
         return 'π';
     if (r === -1)
         return '-π';
-    // Handle common fractions of π
-    const fractions = [
-        { value: 1 / 2, str: 'π/2' },
-        { value: ANGLE_FRACTION_QUARTER, str: 'π/4' },
-        { value: ANGLE_FRACTION_THREE_QUARTERS, str: '3π/4' },
-        { value: 1 / ANGLE_FRACTION_DENOMINATOR_6, str: 'π/6' },
-        { value: 1 / ANGLE_FRACTION_DENOMINATOR_3, str: 'π/3' },
-        { value: 2 / ANGLE_FRACTION_DENOMINATOR_3, str: '2π/3' },
-    ];
-    for (const fraction of fractions) {
-        if (Math.abs(r - fraction.value) < ANGLE_FRACTION_TOLERANCE)
-            return fraction.str;
-        if (Math.abs(r + fraction.value) < ANGLE_FRACTION_TOLERANCE)
-            return '-' + fraction.str;
-    }
-    // Try to find a simple fraction representation
-    const tolerance = ANGLE_FRACTION_TOLERANCE;
-    for (let denominator = 2; denominator <= ANGLE_MAX_DENOMINATOR; denominator++) {
-        for (let numerator = 1; numerator < denominator; numerator++) {
-            const frac = numerator / denominator;
-            if (Math.abs(r - frac) < tolerance) {
-                return `${numerator === 1 ? '' : numerator}π/${denominator}`;
-            }
-            if (Math.abs(r + frac) < tolerance) {
-                return `-${numerator === 1 ? '' : numerator}π/${denominator}`;
-            }
+    const absR = Math.abs(r);
+    const sign = r < 0 ? '-' : '';
+    // Try to express |r| as n/d for d in [2, ANGLE_MAX_DENOMINATOR].
+    // Iterating from the smallest denominator first ensures reduced fractions
+    // are returned (e.g., π/2 is found at d=2 before 2π/4 would be at d=4).
+    for (let d = 2; d <= ANGLE_MAX_DENOMINATOR; d++) {
+        const n = Math.round(absR * d);
+        if (n === 0)
+            continue; // zero already handled
+        if (n % d === 0)
+            continue; // integer multiple of π — fall through to fallback
+        if (Math.abs(absR - n / d) < ANGLE_FRACTION_TOLERANCE) {
+            return n === 1 ? `${sign}π/${d}` : `${sign}${n}π/${d}`;
         }
     }
     return `${r}π`;
@@ -69,7 +75,14 @@ export function FormatRadians(radians) {
 /**
  * Normalizes an angle in radians to be between 0 and 2π
  * @param radians - Angle in radians
- * @returns Normalized angle in radians (0 to 2π)
+ * @returns Normalized angle in radians in the range [0, 2π)
+ *
+ * @example
+     * ```typescript
+     * NormalizeRadians(3 * Math.PI)  // Math.PI  (wraps around)
+     * NormalizeRadians(-Math.PI)     // Math.PI  (negative angles normalized)
+     * NormalizeRadians(0)            // 0
+     * ```
  */
 export function NormalizeRadians(radians) {
     const twoPi = 2 * Math.PI;
@@ -80,11 +93,25 @@ export function NormalizeRadians(radians) {
     return result;
 }
 /**
- * Normalizes an angle in degrees to be between 0 and 360
+ * Normalizes an angle in degrees to be between 0 and 360.
+ * Applies a floating-point epsilon cleanup so values within `1e-10` of 0 or 360
+ * are snapped to exactly 0, matching the behaviour of `NormalizeRadians`.
  * @param degrees - Angle in degrees
- * @returns Normalized angle in degrees (0 to 360)
+ * @returns Normalized angle in degrees in the range [0°, 360°)
+ *
+ * @example
+     * ```typescript
+     * NormalizeDegrees(450)   // 90  (wraps around 360°)
+     * NormalizeDegrees(-90)   // 270 (negative angles normalized)
+     * NormalizeDegrees(0)     // 0
+     * NormalizeDegrees(360 - 1e-11) // 0  (boundary epsilon snap)
+     * ```
  */
 export function NormalizeDegrees(degrees) {
-    return ((degrees % DEGREES_PER_FULL_REVOLUTION) + DEGREES_PER_FULL_REVOLUTION) % DEGREES_PER_FULL_REVOLUTION;
+    const result = ((degrees % DEGREES_PER_FULL_REVOLUTION) + DEGREES_PER_FULL_REVOLUTION) % DEGREES_PER_FULL_REVOLUTION;
+    // Epsilon cleanup for floating-point precision at boundaries (mirrors NormalizeRadians)
+    if (result < NORMALIZE_EPSILON || result > DEGREES_PER_FULL_REVOLUTION - NORMALIZE_EPSILON)
+        return 0;
+    return result;
 }
 //# sourceMappingURL=angles.js.map

package/build/angles.js.map

@@ -1 +1 @@
-{"version":3,"file":"angles.js","sourceRoot":"","sources":["../src/angles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"angles.js","sourceRoot":"","sources":["../src/angles.ts"],"names":[],"mappings":"AAAA,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,8CAA8C;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,2BAA2B,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,OAAO,CAAC,OAAO,GAAG,2BAA2B,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC5C,MAAM,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAE5B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9B,iEAAiE;IACjE,0EAA0E;IAC1E,wEAAwE;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS,CAAQ,uBAAuB;QACrD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS,CAAI,mDAAmD;QACjF,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,wBAAwB,EAAE,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAC,GAAG,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IACnD,6DAA6D;IAC7D,IAAI,MAAM,GAAG,iBAAiB,IAAI,MAAM,GAAG,KAAK,GAAG,iBAAiB;QAAE,OAAO,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,GAAG,2BAA2B,CAAC,GAAG,2BAA2B,CAAC,GAAG,2BAA2B,CAAC;IACrH,wFAAwF;IACxF,IAAI,MAAM,GAAG,iBAAiB,IAAI,MAAM,GAAG,2BAA2B,GAAG,iBAAiB;QAAE,OAAO,CAAC,CAAC;IACrG,OAAO,MAAM,CAAC;AACf,CAAC"}

package/build/clamp.d.ts

@@ -9,9 +9,11 @@
  * @returns The clamped value in the range [min, max]
  *
  * @example
- * Clamp(5, 0, 10)   // 5 (within range)
- * Clamp(-3, 0, 10)  // 0 (below min)
- * Clamp(15, 0, 10)  // 10 (above max)
+     * ```typescript
+     * Clamp(5, 0, 10)   // 5 (within range)
+     * Clamp(-3, 0, 10)  // 0 (below min)
+     * Clamp(15, 0, 10)  // 10 (above max)
+     * ```
  */
 export declare function Clamp(x: number, min: number, max: number): number;
 //# sourceMappingURL=clamp.d.ts.map

package/build/clamp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../src/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../src/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/build/clamp.js

@@ -9,9 +9,11 @@
  * @returns The clamped value in the range [min, max]
  *
  * @example
- * Clamp(5, 0, 10)   // 5 (within range)
- * Clamp(-3, 0, 10)  // 0 (below min)
- * Clamp(15, 0, 10)  // 10 (above max)
+     * ```typescript
+     * Clamp(5, 0, 10)   // 5 (within range)
+     * Clamp(-3, 0, 10)  // 0 (below min)
+     * Clamp(15, 0, 10)  // 10 (above max)
+     * ```
  */
 export function Clamp(x, min, max) {
     return Math.max(min, Math.min(x, max));

package/build/clamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../src/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../src/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC"}