@nberlette/math 0.7.0

package/cjs/types/integer.d.ts

@@ -0,0 +1,147 @@
+/**
+ * This module provides branded nominal types for signed and unsigned integers
+ * of various precisions, as well as bigints for 64-bit integers.
+ *
+ * @module types/integer
+ */
+import type { P32, Precision } from "./precision.js";
+declare const Integer: unique symbol;
+declare const Unsigned: unique symbol;
+interface IsInt<N extends Precision = P32> {
+    readonly [Integer]: N;
+}
+interface IsUint<N extends Precision = P32> extends IsInt<N> {
+    readonly [Unsigned]: true;
+}
+/**
+ * Represents a signed/unsigned integer of a specific precision (default: 32).
+ *
+ * This type can be provided with a literal number for its first type argument,
+ * which will be checked at compile-time to ensure it is a valid integer.
+ *
+ * There is currently no realistic solution for checking that the value is
+ * within the range of the specified precision, so that part is left up to the
+ * runtime. This type will, however, brand the number with a unique symbol for
+ * the specified precision level `P`, preventing other numbers of different
+ * precisions from being assigned to the same variable/parameter.
+ *
+ * If you need to allow multiple precisions or multiple numbers, simply provide
+ * a union of the desired types to each of the type parameters.
+ *
+ * @category Types
+ * @tags integer, nominal
+ * @see {@linkcode Unsigned} for unsigned integers.
+ */
+export type Integer<N extends number = number, P extends Precision = P32> = number extends N ? number & IsInt<P> : `${N}` extends `${bigint}` ? N & IsInt<P> : never;
+/**
+ * Represents an unsigned integer of a specific precision (default: 32).
+ *
+ * This type can be provided with a literal number for its first type argument,
+ * which will be checked at compile-time to ensure it is a positive integer.
+ *
+ * There is currently no realistic solution for checking that the value is
+ * within the range of the specified precision, so that part is left up to the
+ * runtime. This type will, however, brand the number with a unique symbol for
+ * the specified precision level `P`, preventing other numbers of different
+ * precisions from being assigned to the same variable/parameter.
+ *
+ * If you need to allow multiple precisions or multiple numbers, simply provide
+ * a union of the desired types to each of the type parameters.
+ *
+ * @category Types
+ * @tags integer, nominal, unsigned
+ * @see {@linkcode Integer} for signed/unsigned integers.
+ */
+export type Unsigned<N extends number = number, P extends Precision = P32> = number extends N ? number & IsUint<P> : `${N}` extends `${bigint}` ? `${N}` extends `-${string}` ? never : N & IsUint<P> : never;
+/**
+ * Represents a signed/unsigned 8-bit integer. When given a number, this will
+ * verify it is an integer and brand it with the `Int8` symbol.
+ *
+ * @see {@linkcode Integer} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, int8
+ */
+export type Int8<N extends number = number> = N & IsInt<8>;
+/**
+ * Represents an unsigned 8-bit integer. When given a number, this will verify
+ * it is an integer and brand it with the `Uint8` symbol.
+ *
+ * @see {@linkcode Unsigned} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, unsigned, uint8
+ */
+export type Uint8<N extends number = number> = N & IsUint<8>;
+/**
+ * Represents a signed/unsigned 16-bit integer. When given a number, this will
+ * verify it is an integer and brand it with the `Int16` symbol.
+ *
+ * @see {@linkcode Integer} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, int16
+ */
+export type Int16<N extends number = number> = N & IsInt<16>;
+/**
+ * Represents an unsigned 16-bit integer. When given a number, this will verify
+ * it is an integer and brand it with the `Uint16` symbol.
+ *
+ * @see {@linkcode Unsigned} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, unsigned, uint16
+ */
+export type Uint16<N extends number = number> = N & IsUint<16>;
+/**
+ * Represents a signed/unsigned 32-bit integer. When given a number, this will
+ * verify it is an integer and brand it with the `Int32` symbol.
+ *
+ * @see {@linkcode Integer} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, int32
+ */
+export type Int32<N extends number = number> = N & IsInt<32>;
+/**
+ * Represents an unsigned 32-bit integer. When given a number, this will verify
+ * it is an integer and brand it with the `Uint32` symbol.
+ *
+ * @see {@linkcode Unsigned} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, unsigned, uint32
+ */
+export type Uint32<N extends number = number> = N & IsUint<32>;
+/**
+ * Represents a signed/unsigned 64-bit integer. When given a number, this will
+ * verify it is an integer and brand it with the `Int64` symbol.
+ *
+ * @see {@linkcode Integer} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, int64
+ */
+export type Int64<N extends number = number> = N & IsInt<64>;
+/**
+ * Represents an unsigned 64-bit integer. When given a number, this will verify
+ * it is an integer and brand it with the `Uint64` symbol.
+ *
+ * @see {@linkcode Unsigned} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, nominal, unsigned, uint64
+ */
+export type Uint64<N extends number = number> = N & IsUint<64>;
+/**
+ * Represents a signed/unsigned 64-bit bigint. This is like {@linkcode Int64},
+ * but for bigints instead of numbers.
+ *
+ * @see {@linkcode Integer} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, bigint, nominal
+ */
+export type BigInt64<I extends bigint = bigint> = I & IsInt<64>;
+/**
+ * Represents an unsigned 64-bit bigint. This is like {@linkcode Uint64}, but
+ * for bigints instead of numbers.
+ *
+ * @see {@linkcode Unsigned} for more information about how nominal types work.
+ * @category Types
+ * @tags integer, bigint, nominal, unsigned
+ */
+export type BigUint64<I extends bigint = bigint> = I & IsUint<64>;
+export {};
+//# sourceMappingURL=integer.d.ts.map

package/cjs/types/integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.d.ts","sourceRoot":"","sources":["../../src/types/integer.ts"],"names":[],"mappings":"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"}

package/cjs/types/integer.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Integer = Symbol("Integer");
+const Unsigned = Symbol("Unsigned");
+//# sourceMappingURL=integer.js.map

package/cjs/types/integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../src/types/integer.ts"],"names":[],"mappings":";;AAQA,MAAM,OAAO,GAAkB,MAAM,CAAC,SAAS,CAAC,CAAC;AACjD,MAAM,QAAQ,GAAkB,MAAM,CAAC,UAAU,CAAC,CAAC"}

package/cjs/types/precision.d.ts

@@ -0,0 +1,46 @@
+/**
+ * This module provides type aliases for various levels of precision, for use
+ * with floating-point or integer numbers.
+ *
+ * @module precision
+ */
+/**
+ * Represents 8 bits of precision.
+ * @category Types
+ * @tags Precision
+ */
+export type P8 = 8;
+/**
+ * Represents 16 bits of precision.
+ * @category Types
+ * @tags Precision
+ */
+export type P16 = 16;
+/**
+ * Represents 32 bits of precision.
+ * @category Types
+ * @tags Precision
+ */
+export type P32 = 32;
+/**
+ * Represents 64 bits of precision.
+ * @category Types
+ * @tags Precision
+ */
+export type P64 = 64;
+/**
+ * Represents 8, 16, 32, or 64 bits of precision. For floating point or integer
+ * numbers.
+ *
+ * @category Types
+ * @tags Precision
+ */
+export type Precision = P8 | P16 | P32 | P64;
+/**
+ * Represents 16, 32, or 64 bits of precision for floating-point numbers.
+ *
+ * @category Types
+ * @tags Precision
+ */
+export type FloatPrecision = P16 | P32 | P64;
+//# sourceMappingURL=precision.d.ts.map

package/cjs/types/precision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../src/types/precision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC;AAEnB;;;;GAIG;AACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC"}

package/cjs/types/precision.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * This module provides type aliases for various levels of precision, for use
+ * with floating-point or integer numbers.
+ *
+ * @module precision
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=precision.js.map

package/cjs/types/precision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision.js","sourceRoot":"","sources":["../../src/types/precision.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/cjs/types/safe_integer.d.ts

@@ -0,0 +1,17 @@
+declare const Safe_Integer: unique symbol;
+interface Safe_Integer {
+    readonly [Safe_Integer]: true;
+}
+/**
+ * Represents any finite integer that is within the range of `MIN_SAFE_INTEGER`
+ * (`-2^53 + 1`) and `MAX_SAFE_INTEGER` (`2^53 - 1`).
+ *
+ * This type is used by `isSafeInteger` to type-guard values as safe integers,
+ * providing an additional level of type safety for integer values.
+ *
+ * @category Types
+ * @tags Safe Integer, nominal
+ */
+export type SafeInteger<N extends number = number> = N & Safe_Integer;
+export {};
+//# sourceMappingURL=safe_integer.d.ts.map

package/cjs/types/safe_integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_integer.d.ts","sourceRoot":"","sources":["../../src/types/safe_integer.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,YAAY,EAAE,OAAO,MAA8B,CAAC;AAE1D,UAAU,YAAY;IACpB,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,YAAY,CAAC"}

package/cjs/types/safe_integer.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// deno-lint-ignore no-unused-vars
+const Safe_Integer = Symbol("SafeInteger");
+//# sourceMappingURL=safe_integer.js.map

package/cjs/types/safe_integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_integer.js","sourceRoot":"","sources":["../../src/types/safe_integer.ts"],"names":[],"mappings":";;AAAA,kCAAkC;AAClC,MAAM,YAAY,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/esm/abs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Performant local implementation of the `Math.abs` function.
+ *
+ * @module abs
+ */
+/**
+ * Performant local implementation of the `Math.abs` function.
+ *
+ * @param x The number to return the absolute value of (magnitude)
+ * @returns The absolute value of the provided number.
+ * @category Arithmetic
+ */
+export declare function abs(x: number): number;
+//# sourceMappingURL=abs.d.ts.map

package/esm/abs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abs.d.ts","sourceRoot":"","sources":["../src/abs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrC"}

package/esm/abs.js

@@ -0,0 +1,19 @@
+/**
+ * Performant local implementation of the `Math.abs` function.
+ *
+ * @module abs
+ */
+/**
+ * Performant local implementation of the `Math.abs` function.
+ *
+ * @param x The number to return the absolute value of (magnitude)
+ * @returns The absolute value of the provided number.
+ * @category Arithmetic
+ */
+export function abs(x) {
+    x = +x;
+    if (x === 0)
+        return 0;
+    return x < 0 ? -x : x;
+}
+//# sourceMappingURL=abs.js.map

package/esm/abs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abs.js","sourceRoot":"","sources":["../src/abs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,CAAC,GAAG,CAAC,CAAC,CAAC;IACP,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/esm/acos.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Calculates the arccosine (inverse cosine) of a number, returning a value in
+ * the range `[0, π]`.
+ *
+ * @module acos
+ */
+/**
+ * Calculates the arccosine (inverse cosine) of a number, returning a value in
+ * the range `[0, π]`.
+ *
+ * @param x The number whose arccosine is to be calculated (must be between -1
+ * and 1).
+ * @returns The arccosine of the provided number, in radians.
+ * @category Trigonometry
+ */
+export declare function acos(x: number): number;
+//# sourceMappingURL=acos.d.ts.map

package/esm/acos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acos.d.ts","sourceRoot":"","sources":["../src/acos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtC"}

package/esm/acos.js

@@ -0,0 +1,24 @@
+/**
+ * Calculates the arccosine (inverse cosine) of a number, returning a value in
+ * the range `[0, π]`.
+ *
+ * @module acos
+ */
+import { isNaN, NaN } from "./guards/nan.js";
+import { atan2 } from "./atan2.js";
+import { sqrt } from "./sqrt.js";
+/**
+ * Calculates the arccosine (inverse cosine) of a number, returning a value in
+ * the range `[0, π]`.
+ *
+ * @param x The number whose arccosine is to be calculated (must be between -1
+ * and 1).
+ * @returns The arccosine of the provided number, in radians.
+ * @category Trigonometry
+ */
+export function acos(x) {
+    if (isNaN(x) || x < -1 || x > 1)
+        return NaN;
+    return atan2(sqrt(1 - x * x), x);
+}
+//# sourceMappingURL=acos.js.map

package/esm/acos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acos.js","sourceRoot":"","sources":["../src/acos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/esm/acosh.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculates the inverse hyperbolic cosine of a number, returning a value in
+ * the range `[0, +Infinity]`.
+ *
+ * @param x The number whose inverse hyperbolic cosine is to be calculated
+ * (must be >= 1).
+ * @returns The inverse hyperbolic cosine of the provided number.
+ * @category Trigonometry
+ */
+export declare function acosh(x: number): number;
+//# sourceMappingURL=acosh.d.ts.map

package/esm/acosh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acosh.d.ts","sourceRoot":"","sources":["../src/acosh.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvC"}

package/esm/acosh.js

@@ -0,0 +1,32 @@
+/**
+ * Calculates the inverse hyperbolic cosine of a number, returning a value in
+ * the range `[0, +Infinity]`.
+ *
+ * @category Trigonometry
+ * @module acosh
+ */
+import { NAN } from "./constants/nan.js";
+import { POSITIVE_INFINITY } from "./constants/positive_infinity.js";
+import { log } from "./log.js";
+import { sqrt } from "./sqrt.js";
+/**
+ * Calculates the inverse hyperbolic cosine of a number, returning a value in
+ * the range `[0, +Infinity]`.
+ *
+ * @param x The number whose inverse hyperbolic cosine is to be calculated
+ * (must be >= 1).
+ * @returns The inverse hyperbolic cosine of the provided number.
+ * @category Trigonometry
+ */
+export function acosh(x) {
+    if (x !== x || x < 1)
+        return NAN;
+    if (x === 1)
+        return 0;
+    if (x === POSITIVE_INFINITY)
+        return x;
+    if (x > 1.0e+7)
+        return log(x) + Math.LN2;
+    return log(x + sqrt(x * x - 1));
+}
+//# sourceMappingURL=acosh.js.map

package/esm/acosh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acosh.js","sourceRoot":"","sources":["../src/acosh.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,iBAAiB;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACzC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/esm/asin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculates the arcsine (inverse sine) of a number, returning a value in the
+ * range `[-π/2, π/2]`.
+ *
+ * @param x The number whose arcsine is to be calculated (must be between -1
+ * and 1).
+ * @returns The arcsine of the provided number, in radians.
+ * @category Trigonometry
+ */
+export declare function asin(x: number): number;
+//# sourceMappingURL=asin.d.ts.map

package/esm/asin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asin.d.ts","sourceRoot":"","sources":["../src/asin.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtC"}

package/esm/asin.js

@@ -0,0 +1,25 @@
+/**
+ * Calculates the arcsine (inverse sine) of a number, returning a value in the
+ * range `[-π/2, π/2]`.
+ *
+ * @category Trigonometry
+ * @module asin
+ */
+import { NAN } from "./constants/nan.js";
+import { atan2 } from "./atan2.js";
+import { sqrt } from "./sqrt.js";
+/**
+ * Calculates the arcsine (inverse sine) of a number, returning a value in the
+ * range `[-π/2, π/2]`.
+ *
+ * @param x The number whose arcsine is to be calculated (must be between -1
+ * and 1).
+ * @returns The arcsine of the provided number, in radians.
+ * @category Trigonometry
+ */
+export function asin(x) {
+    if (x !== x || x < -1 || x > 1)
+        return NAN;
+    return atan2(x, sqrt(1 - x * x));
+}
+//# sourceMappingURL=asin.js.map

package/esm/asin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asin.js","sourceRoot":"","sources":["../src/asin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/esm/asinh.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Calculates the inverse hyperbolic sine of a number.
+ *
+ * @param x The number whose inverse hyperbolic sine is to be calculated.
+ * @returns The inverse hyperbolic sine of the provided number.
+ * @category Trigonometry
+ */
+export declare function asinh(x: number): number;
+//# sourceMappingURL=asinh.d.ts.map

package/esm/asinh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asinh.d.ts","sourceRoot":"","sources":["../src/asinh.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvC"}

package/esm/asinh.js

@@ -0,0 +1,23 @@
+/**
+ * Calculates the inverse hyperbolic sine of a number.
+ *
+ * @module asinh
+ */
+import { isFinite } from "./guards/finite.js";
+import { log } from "./log.js";
+import { sqrt } from "./sqrt.js";
+/**
+ * Calculates the inverse hyperbolic sine of a number.
+ *
+ * @param x The number whose inverse hyperbolic sine is to be calculated.
+ * @returns The inverse hyperbolic sine of the provided number.
+ * @category Trigonometry
+ */
+export function asinh(x) {
+    if (x === 0)
+        return x;
+    if (!isFinite(x))
+        return x;
+    return log(x + sqrt(x * x + 1));
+}
+//# sourceMappingURL=asinh.js.map

package/esm/asinh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asinh.js","sourceRoot":"","sources":["../src/asinh.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/esm/atan.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculates the arctangent (inverse tangent) of a number, returning a value
+ * in the range `[-π/2, π/2]`.
+ *
+ * @param x The number whose arctangent is to be calculated.
+ * @returns The arctangent of the provided number, in radians.
+ * @category Trigonometry
+ * @tags tangent, arctangent
+ */
+export declare function atan(x: number): number;
+//# sourceMappingURL=atan.d.ts.map

package/esm/atan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atan.d.ts","sourceRoot":"","sources":["../src/atan.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAyCtC"}

package/esm/atan.js

@@ -0,0 +1,62 @@
+/**
+ * Calculates the arctangent (inverse tangent) of a number, returning a value
+ * in the range `[-π/2, π/2]`.
+ *
+ * @module atan
+ */
+import { abs } from "./abs.js";
+import { NAN } from "./constants/nan.js";
+import { PI } from "./constants/pi.js";
+import { POSITIVE_INFINITY } from "./constants/positive_infinity.js";
+import { NEGATIVE_INFINITY } from "./constants/negative_infinity.js";
+import { EPSILON } from "./constants/epsilon.js";
+/**
+ * Calculates the arctangent (inverse tangent) of a number, returning a value
+ * in the range `[-π/2, π/2]`.
+ *
+ * @param x The number whose arctangent is to be calculated.
+ * @returns The arctangent of the provided number, in radians.
+ * @category Trigonometry
+ * @tags tangent, arctangent
+ */
+export function atan(x) {
+    const PI_OVER_2 = PI / 2, PI_OVER_4 = PI / 4;
+    if (isNaN(x))
+        return NAN;
+    if (x === POSITIVE_INFINITY)
+        return PI_OVER_2;
+    if (x === NEGATIVE_INFINITY)
+        return -PI_OVER_2;
+    if (x === 0)
+        return x; // Preserve -0
+    if (x < 0)
+        return -atan(-x);
+    // for large x, use the identity: arctan(x) = π/2 - arctan(1/x)
+    if (x > 1)
+        return PI_OVER_2 - atan(1 / x);
+    // for x near 1, use an alternative series expansion
+    if (x > 0.5) {
+        const a = (x - 1) / (x + 1), a2 = a * a;
+        let term = a, sum = term, n = 1;
+        // Use a convergence threshold appropriate for double-precision
+        // floating-point numbers
+        const MAX_ITERATIONS = 1000;
+        while (abs(term) > EPSILON && n < MAX_ITERATIONS) {
+            term *= -a2;
+            sum += term / (2 * n + 1);
+            n++;
+        }
+        return PI_OVER_4 + sum;
+    }
+    // for x <= 0.5, use the standard Taylor series expansion
+    const x2 = x * x;
+    let term = x, sum = x, n = 1;
+    const MAX_ITERATIONS = 1e5;
+    while (abs(term) > EPSILON && n < MAX_ITERATIONS) {
+        term *= -x2;
+        sum += term / (2 * n + 1);
+        n++;
+    }
+    return sum;
+}
+//# sourceMappingURL=atan.js.map

package/esm/atan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atan.js","sourceRoot":"","sources":["../src/atan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACzB,IAAI,CAAC,KAAK,iBAAiB;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,CAAC,KAAK,iBAAiB;QAAE,OAAO,CAAC,SAAS,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,cAAc;IACrC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5B,+DAA+D;IAC/D,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1C,oDAAoD;IACpD,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;QAEhC,+DAA+D;QAC/D,yBAAyB;QACzB,MAAM,cAAc,GAAG,IAAI,CAAC;QAC5B,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,EAAE,CAAC;YACZ,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;QACN,CAAC;QAED,OAAO,SAAS,GAAG,GAAG,CAAC;IACzB,CAAC;IAED,yDAAyD;IACzD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,GAAG,CAAC;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,EAAE,CAAC;QACZ,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/esm/atan2.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Calculates the arctangent of the quotient of its arguments, `y / x`,
+ * returning a value in the range `(-π, π]`.
+ *
+ * @param y The ordinate coordinate.
+ * @param x The abscissa coordinate.
+ * @returns The angle between the positive x-axis and point (x, y), in radians.
+ * @category Trigonometry
+ * @tags angle, arctangent
+ */
+export declare function atan2(y: number, x: number): number;
+//# sourceMappingURL=atan2.d.ts.map

package/esm/atan2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atan2.d.ts","sourceRoot":"","sources":["../src/atan2.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA+BlD"}