@pawells/math-extended 1.1.1 → 2.0.0

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
- * 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"}