@pawells/math-extended 1.1.1 → 3.0.0

package/README.md

@@ -19,7 +19,7 @@ yarn add @pawells/math-extended
 
 ## Usage
 
-All exports are available as individual named imports for tree-shaking, or grouped via namespace imports for convenience.
+All exports are available as individual named imports for tree-shaking optimization.
 
 ### Direct Named Imports (Tree-Shaking Friendly)
 
@@ -43,29 +43,22 @@ const v = SmoothStep(0, 10, 0.5); // 5
 const rad = DegreesToRadians(180); // Math.PI
 ```
 
-### Namespace Imports (Grouped)
-
-Import related utilities together using namespace imports:
-
-```typescript
-import { VectorUtils, MatrixUtils, QuaternionUtils } from '@pawells/math-extended';
-
-// Access utilities via namespace
-VectorUtils.VectorAdd([1, 0, 0], [0, 1, 0]);
-MatrixUtils.MatrixMultiply(matA, matB);
-QuaternionUtils.QuaternionSLERP(q1, q2, 0.5);
-```
 
 ### Import Patterns
 
 | Pattern | Best For | Example |
 |---------|----------|---------|
 | **Direct named** | Tree-shaking, small imports | `import { VectorAdd } from '@pawells/math-extended'` |
-| **Namespace** | Grouping related functions | `import { VectorUtils } from '@pawells/math-extended'` |
-| **Mixed** | Flexibility | Both patterns together |
+| **Mixed** | Flexibility | Multiple imports together |
 
 ## API
 
+### Core
+
+| Export | Description |
+|--------|-------------|
+| `CubeRoot(value)` | Compute the cube root of a number |
+
 ### Angles
 
 | Export | Description |
@@ -106,7 +99,7 @@ All interpolation functions share the signature `(a, b, t)`. `t` is typically in
 | `CosineInterpolation` | Cosine interpolation |
 | `CatmullRomInterpolation` | Catmull-Rom spline `(p0, p1, p2, p3, t)` |
 | `HermiteInterpolation` | Hermite spline `(p0, p1, t0, t1, t)` |
-| `SphericalLinearInterpolation` | Shortest-arc scalar SLERP |
+| `SphericalLinearInterpolation` | **@deprecated** Identical to `LinearInterpolation`. Use `QuaternionSLERP` for true spherical interpolation. |
 | `StepInterpolation` | Step function with configurable threshold |
 | `QuadraticEaseIn/Out/InOut` | Quadratic easing |
 | `CubicEaseIn/Out/InOut` | Cubic easing |
@@ -172,11 +165,11 @@ Every scalar easing function has a `Vector*` counterpart (e.g., `VectorSmoothSte
 
 #### Assertions
 
-`AssertVector`, `AssertVector2`, `AssertVector3`, `AssertVector4`, `AssertVectorValue`, `AssertVectors`, `VectorError`
+`AssertVector`, `AssertVector2`, `AssertVector3`, `AssertVector4`, `AssertVectorNonZero`, `AssertVectorSameSize`, `ValidateVector`, `ValidateVector2`, `ValidateVector3`, `ValidateVector4`, `ValidateVectorSameSize`, `VectorError`
 
 ### Matrices
 
-Matrices are `number[][]` arrays (`IMatrix`, `IMatrix1`–`IMatrix4`). All operations return new matrices.
+Matrices are `number[][]` arrays (`TMatrix`, `TMatrix1`–`TMatrix4`). All operations return new matrices.
 
 #### Core
 
@@ -266,7 +259,7 @@ Matrices are `number[][]` arrays (`IMatrix`, `IMatrix1`–`IMatrix4`). All opera
 
 #### Assertions
 
-`AssertMatrix`, `AssertMatrix1`–`AssertMatrix4`, `AssertMatrixRow`, `AssertMatrixValue`, `AssertMatrices`, `MatrixError`
+`AssertMatrix`, `AssertMatrix1`–`AssertMatrix4`, `AssertMatrixSquare`, `AssertMatricesCompatible`, `ValidateMatrix`, `ValidateMatrix1`–`ValidateMatrix4`, `ValidateMatrixSquare`, `MatrixError`
 
 ### Quaternions
 
@@ -318,6 +311,7 @@ Quaternions are `[x, y, z, w]` tuples (`TQuaternion`).
 
 `AssertQuaternion`, `AssertQuaternions`, `AssertNormalizedQuaternion`, `AssertAxisAngle`, `AssertEulerAngles`, `AssertRotationMatrix`, `QuaternionError`
 
+
 ## Development
 
 ```bash
@@ -328,7 +322,7 @@ yarn watch          # Watch mode
 yarn typecheck      # Type check without building
 yarn lint           # ESLint
 yarn lint:fix       # ESLint with auto-fix
-yarn test           # Run tests (1080 tests)
+yarn test           # Run tests (1137 tests)
 yarn test:ui        # Interactive Vitest UI
 yarn test:coverage  # Tests with coverage report
 ```
@@ -339,4 +333,4 @@ yarn test:coverage  # Tests with coverage report
 
 ## License
 
-MIT — See [LICENSE](./LICENSE) for details.
+This project is licensed under the [MIT License](LICENSE).

package/build/angles.d.ts

@@ -4,9 +4,11 @@
  * @returns Angle in radians
  *
  * @example
- * DegreesToRadians(180)  // Math.PI
- * DegreesToRadians(90)   // Math.PI / 2
- * DegreesToRadians(0)    // 0
+     * ```typescript
+     * DegreesToRadians(180)  // Math.PI
+     * DegreesToRadians(90)   // Math.PI / 2
+     * DegreesToRadians(0)    // 0
+     * ```
  */
 export declare function DegreesToRadians(degrees: number): number;
 /**
@@ -15,9 +17,11 @@ export declare function DegreesToRadians(degrees: number): number;
  * @returns Angle in degrees
  *
  * @example
- * RadiansToDegrees(Math.PI)     // 180
- * RadiansToDegrees(Math.PI / 2) // 90
- * RadiansToDegrees(0)           // 0
+     * ```typescript
+     * RadiansToDegrees(Math.PI)     // 180
+     * RadiansToDegrees(Math.PI / 2) // 90
+     * RadiansToDegrees(0)           // 0
+     * ```
  */
 export declare function RadiansToDegrees(radians: number): number;
 /**
@@ -26,11 +30,13 @@ export declare function RadiansToDegrees(radians: number): number;
  * @returns String representation of the angle
  *
  * @example
- * FormatRadians(0)             // '0'
- * FormatRadians(Math.PI)       // 'π'
- * FormatRadians(Math.PI / 2)   // 'π/2'
- * FormatRadians(Math.PI / 4)   // 'π/4'
- * FormatRadians(-Math.PI)      // '-π'
+     * ```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;
 /**
@@ -39,9 +45,11 @@ export declare function FormatRadians(radians: number): string;
  * @returns Normalized angle in radians in the range [0, 2π)
  *
  * @example
- * NormalizeRadians(3 * Math.PI)  // Math.PI  (wraps around)
- * NormalizeRadians(-Math.PI)     // Math.PI  (negative angles normalized)
- * NormalizeRadians(0)            // 0
+     * ```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;
 /**
@@ -52,10 +60,12 @@ export declare function NormalizeRadians(radians: number): number;
  * @returns Normalized angle in degrees in the range [0°, 360°)
  *
  * @example
- * NormalizeDegrees(450)   // 90  (wraps around 360°)
- * NormalizeDegrees(-90)   // 270 (negative angles normalized)
- * NormalizeDegrees(0)     // 0
- * NormalizeDegrees(360 - 1e-11) // 0  (boundary epsilon snap)
+     * ```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":"AAMA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD"}
+{"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

@@ -9,9 +9,11 @@ const NORMALIZE_EPSILON = 1e-10; // Epsilon for floating-point boundary cleanup
  * @returns Angle in radians
  *
  * @example
- * DegreesToRadians(180)  // Math.PI
- * DegreesToRadians(90)   // Math.PI / 2
- * DegreesToRadians(0)    // 0
+     * ```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;
@@ -22,9 +24,11 @@ export function DegreesToRadians(degrees) {
  * @returns Angle in degrees
  *
  * @example
- * RadiansToDegrees(Math.PI)     // 180
- * RadiansToDegrees(Math.PI / 2) // 90
- * RadiansToDegrees(0)           // 0
+     * ```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;
@@ -35,11 +39,13 @@ export function RadiansToDegrees(radians) {
  * @returns String representation of the angle
  *
  * @example
- * FormatRadians(0)             // '0'
- * FormatRadians(Math.PI)       // 'π'
- * FormatRadians(Math.PI / 2)   // 'π/2'
- * FormatRadians(Math.PI / 4)   // 'π/4'
- * FormatRadians(-Math.PI)      // '-π'
+     * ```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;
@@ -72,9 +78,11 @@ export function FormatRadians(radians) {
  * @returns Normalized angle in radians in the range [0, 2π)
  *
  * @example
- * NormalizeRadians(3 * Math.PI)  // Math.PI  (wraps around)
- * NormalizeRadians(-Math.PI)     // Math.PI  (negative angles normalized)
- * NormalizeRadians(0)            // 0
+     * ```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;
@@ -92,10 +100,12 @@ export function NormalizeRadians(radians) {
  * @returns Normalized angle in degrees in the range [0°, 360°)
  *
  * @example
- * NormalizeDegrees(450)   // 90  (wraps around 360°)
- * NormalizeDegrees(-90)   // 270 (negative angles normalized)
- * NormalizeDegrees(0)     // 0
- * NormalizeDegrees(360 - 1e-11) // 0  (boundary epsilon snap)
+     * ```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) {
     const result = ((degrees % DEGREES_PER_FULL_REVOLUTION) + DEGREES_PER_FULL_REVOLUTION) % DEGREES_PER_FULL_REVOLUTION;

package/build/angles.js.map

@@ -1 +1 @@
-{"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;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,2BAA2B,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,OAAO,CAAC,OAAO,GAAG,2BAA2B,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;GAWG;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;;;;;;;;;GASG;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;;;;;;;;;;;;GAYG;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"}
+{"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
+ * ```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
+ * ```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"}

package/build/core.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Core mathematical utilities for pure numeric calculations.
+ * Provides foundational math operations with no domain coupling.
+ */
+/**
+ * Calculates the cube root of a number, preserving the sign of the input.
+ * Handles negative numbers correctly (unlike Math.cbrt in some contexts).
+ *
+ * @param value - The value to calculate the cube root of
+ * @returns The cube root of the value, with same sign as input
+ *
+ * @example
+ * ```typescript
+ * import { CubeRoot } from '@pawells/math-extended';
+ *
+ * CubeRoot(8); // 2
+ * CubeRoot(-8); // -2
+ * CubeRoot(27); // 3
+ * CubeRoot(0); // 0
+ * ```
+ */
+export declare function CubeRoot(value: number): number;
+//# sourceMappingURL=core.d.ts.map

package/build/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/build/core.js

@@ -0,0 +1,25 @@
+/**
+ * Core mathematical utilities for pure numeric calculations.
+ * Provides foundational math operations with no domain coupling.
+ */
+/**
+ * Calculates the cube root of a number, preserving the sign of the input.
+ * Handles negative numbers correctly (unlike Math.cbrt in some contexts).
+ *
+ * @param value - The value to calculate the cube root of
+ * @returns The cube root of the value, with same sign as input
+ *
+ * @example
+ * ```typescript
+ * import { CubeRoot } from '@pawells/math-extended';
+ *
+ * CubeRoot(8); // 2
+ * CubeRoot(-8); // -2
+ * CubeRoot(27); // 3
+ * CubeRoot(0); // 0
+ * ```
+ */
+export function CubeRoot(value) {
+    return Math.sign(value) * Math.pow(Math.abs(value), 1 / 3);
+}
+//# sourceMappingURL=core.js.map

package/build/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/build/index.d.ts

@@ -1,8 +1,5 @@
-export * as VectorUtils from './vectors/index.js';
-export * as MatrixUtils from './matrices/index.js';
-export * as QuaternionUtils from './quaternions/index.js';
-export * from './angles.js';
 export * from './clamp.js';
+export * from './core.js';
 export * from './interpolation.js';
 export * from './matrices/index.js';
 export * from './quaternions/index.js';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAG1D,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/build/index.js

@@ -1,10 +1,5 @@
-// Namespace exports for grouped imports
-export * as VectorUtils from './vectors/index.js';
-export * as MatrixUtils from './matrices/index.js';
-export * as QuaternionUtils from './quaternions/index.js';
-// Direct named exports for tree-shaking
-export * from './angles.js';
 export * from './clamp.js';
+export * from './core.js';
 export * from './interpolation.js';
 export * from './matrices/index.js';
 export * from './quaternions/index.js';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAE1D,wCAAwC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}