@nberlette/math 0.7.0

package/esm/internal/ieee754.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Shared generic implementation for IEEE‑754 binary floating‑point
+ * encoding, decoding, and rounding.
+ *
+ * @module internal/ieee754
+ */
+/** Descriptor for an IEEE‑754 binary floating‑point format. */
+export interface BigIntFloatFormat extends Format {
+    /** Controls the output type of the bit pattern. @default {false} */
+    bigint: true;
+}
+/** Descriptor for an IEEE‑754 binary floating‑point format. */
+export interface FloatFormat extends Format {
+    /** Optional flag indicating the output type should be a number. */
+    bigint?: false | undefined;
+}
+interface Format {
+    /** Number of exponent bits (e.g. 8 for binary32). */
+    exponent: number;
+    /** Number of mantissa bits (e.g. 23 for binary32). */
+    mantissa: number;
+    /** Exponent bias (e.g. 127 for binary32). */
+    bias: number;
+    /** Encoded bit‑pattern for NaN. */
+    nan: number | bigint;
+    /** Encoded bit‑pattern for +∞. */
+    positive_infinity: number | bigint;
+    /** Encoded bit‑pattern for –∞. */
+    negative_infinity: number | bigint;
+    /** Encoded bit‑pattern for –0. */
+    negative_zero: number | bigint;
+    /** Encoded bit‑pattern for +0. */
+    positive_zero: number | bigint;
+    /** Optional flag indicating whether the output should be a bigint. */
+    bigint?: boolean | undefined;
+}
+/**
+ * Encode a JS number into an IEEE‑754 bit pattern (as a BigInt).
+ *
+ * @param value  The number to encode.
+ * @param fmt    Describes exponent/mantissa sizes, bias, and specials.
+ * @returns      The raw bits (as BigInt).
+ * @internal
+ */
+export declare function encode(value: number, fmt: BigIntFloatFormat): bigint;
+export declare function encode(value: number, fmt: FloatFormat): number;
+/**
+ * Decode an IEEE‑754 bit pattern back into a JavaScript number.
+ *
+ * @param bits   The raw bits (BigInt or number).
+ * @param fmt    Describes exponent/mantissa sizes, bias, and specials.
+ * @returns      The decoded JS number.
+ * @internal
+ */
+export declare function decode(bits: string | bigint | number, fmt: FloatFormat): number;
+/**
+ * Round a JS number to the nearest representable value in the given format.
+ *
+ * @param value  The number to round.
+ * @param fmt    Describes exponent/mantissa sizes, bias, and specials.
+ * @returns      The rounded JS number.
+ * @internal
+ */
+export declare function fround(value: number, fmt?: FloatFormat): number;
+/**
+ * Represents the IEEE-754 binary16 (half-precision) floating-point format.
+ *
+ * @internal
+ */
+export declare const float16: {
+    readonly exponent: 5;
+    readonly mantissa: 10;
+    readonly bias: 15;
+    readonly nan: 32256n;
+    readonly positive_infinity: 31744n;
+    readonly negative_infinity: 64512n;
+    readonly negative_zero: 32768n;
+    readonly positive_zero: 0n;
+};
+/**
+ * Represents the IEEE-754 binary32 (single-precision) floating-point format.
+ *
+ * @internal
+ */
+export declare const float32: {
+    readonly exponent: 8;
+    readonly mantissa: 23;
+    readonly bias: 127;
+    readonly nan: 2143289344n;
+    readonly positive_infinity: 2139095040n;
+    readonly negative_infinity: 4286578688n;
+    readonly negative_zero: 2147483648n;
+    readonly positive_zero: 0n;
+};
+/**
+ * Represents the IEEE-754 binary64 (double-precision) floating-point format.
+ *
+ * @internal
+ */
+export declare const float64: {
+    readonly exponent: 11;
+    readonly mantissa: 52;
+    readonly bias: 1023;
+    readonly nan: 9221120237041090560n;
+    readonly positive_infinity: 9218868437227405312n;
+    readonly negative_infinity: 18442240474082181120n;
+    readonly negative_zero: 9223372036854775808n;
+    readonly positive_zero: 0n;
+};
+/**
+ * Represents the IEEE-754 binary128 (quadruple-precision) floating-point
+ * format.
+ *
+ * @internal
+ */
+export declare const float128: {
+    readonly exponent: 15;
+    readonly mantissa: 112;
+    readonly bias: 16383;
+    readonly nan: 170138587312039964317873038467719495680n;
+    readonly positive_infinity: 170135991163610696904058773219554885632n;
+    readonly negative_infinity: 340277174624079928635746076935438991360n;
+    readonly negative_zero: 170141183460469231731687303715884105728n;
+    readonly positive_zero: 0n;
+};
+/**
+ * Represents all supported IEEE-754 floating-point formats.
+ *
+ * @internal
+ */
+export declare const formats: {
+    readonly float16: {
+        readonly exponent: 5;
+        readonly mantissa: 10;
+        readonly bias: 15;
+        readonly nan: 32256n;
+        readonly positive_infinity: 31744n;
+        readonly negative_infinity: 64512n;
+        readonly negative_zero: 32768n;
+        readonly positive_zero: 0n;
+    };
+    readonly float32: {
+        readonly exponent: 8;
+        readonly mantissa: 23;
+        readonly bias: 127;
+        readonly nan: 2143289344n;
+        readonly positive_infinity: 2139095040n;
+        readonly negative_infinity: 4286578688n;
+        readonly negative_zero: 2147483648n;
+        readonly positive_zero: 0n;
+    };
+    readonly float64: {
+        readonly exponent: 11;
+        readonly mantissa: 52;
+        readonly bias: 1023;
+        readonly nan: 9221120237041090560n;
+        readonly positive_infinity: 9218868437227405312n;
+        readonly negative_infinity: 18442240474082181120n;
+        readonly negative_zero: 9223372036854775808n;
+        readonly positive_zero: 0n;
+    };
+    readonly float128: {
+        readonly exponent: 15;
+        readonly mantissa: 112;
+        readonly bias: 16383;
+        readonly nan: 170138587312039964317873038467719495680n;
+        readonly positive_infinity: 170135991163610696904058773219554885632n;
+        readonly negative_infinity: 340277174624079928635746076935438991360n;
+        readonly negative_zero: 170141183460469231731687303715884105728n;
+        readonly positive_zero: 0n;
+    };
+};
+export {};
+//# sourceMappingURL=ieee754.d.ts.map

package/esm/internal/ieee754.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ieee754.d.ts","sourceRoot":"","sources":["../../src/internal/ieee754.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAoBH,+DAA+D;AAC/D,MAAM,WAAW,iBAAkB,SAAQ,MAAM;IAC/C,oEAAoE;IACpE,MAAM,EAAE,IAAI,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,mEAAmE;IACnE,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC5B;AAED,UAAU,MAAM;IACd,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,kCAAkC;IAClC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,kCAAkC;IAClC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC;AACtE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC;AAwDhE;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAC9B,GAAG,EAAE,WAAW,GACf,MAAM,CA6BR;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;CASY,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;CASY,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;CASY,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;CASW,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK4B,CAAC"}

package/esm/internal/ieee754.js

@@ -0,0 +1,194 @@
+// src/internal/ieee754.ts
+/**
+ * Shared generic implementation for IEEE‑754 binary floating‑point
+ * encoding, decoding, and rounding.
+ *
+ * @module internal/ieee754
+ */
+import { isPositiveInfinity, POSITIVE_INFINITY, } from "../guards/positive_infinity.js";
+import { isNegativeInfinity, NEGATIVE_INFINITY, } from "../guards/negative_infinity.js";
+import { isNaN, NAN } from "../guards/nan.js";
+import { isNegativeZero, NEGATIVE_ZERO } from "../guards/negative_zero.js";
+import { isPositiveZero, POSITIVE_ZERO } from "../guards/positive_zero.js";
+import { abs } from "../abs.js";
+import { floor } from "../floor.js";
+import { log2 } from "../log2.js";
+import { pow } from "../pow.js";
+import { round } from "../round.js";
+import { BigInt, Number } from "./primordials.js";
+export function encode(value, fmt) {
+    return (fmt.bigint ? BigInt : Number)(inner_encode(value, fmt));
+}
+function inner_encode(value, fmt) {
+    if (isNaN(value))
+        return fmt.nan;
+    if (isPositiveInfinity(value))
+        return fmt.positive_infinity;
+    if (isNegativeInfinity(value))
+        return fmt.negative_infinity;
+    if (isNegativeZero(value))
+        return fmt.negative_zero;
+    if (isPositiveZero(value))
+        return fmt.positive_zero;
+    const normal = 1 - fmt.bias;
+    // subnormal threshold = 2^(1-bias)
+    const cutoff = pow(2, normal);
+    const sign = BigInt(value < 0 ? 1 : 0);
+    const shift = BigInt(fmt.exponent + fmt.mantissa);
+    const absolute = abs(value);
+    if (absolute < cutoff) {
+        // subnormal
+        const scale = normal - fmt.mantissa;
+        const mant = BigInt(round(absolute / pow(2, scale)));
+        return (sign << shift) | mant;
+    }
+    // normal
+    let expo = floor(log2(absolute)), mant = absolute / pow(2, expo);
+    if (mant < 1) {
+        mant *= 2;
+        expo--;
+    }
+    else if (mant >= 2) {
+        mant /= 2;
+        expo++;
+    }
+    const mant_scale = pow(2, fmt.mantissa);
+    let mant_bits = round((mant - 1) * mant_scale);
+    if (mant_bits === mant_scale) {
+        mant_bits = 0;
+        expo++;
+    }
+    const biased = expo + fmt.bias;
+    if (biased >= (1 << fmt.exponent) - 1) {
+        return value < 0 ? fmt.negative_infinity : fmt.positive_infinity;
+    }
+    const e = BigInt(biased);
+    const m = BigInt(mant_bits);
+    return (sign << shift) | (e << BigInt(fmt.mantissa)) | m;
+}
+/**
+ * Decode an IEEE‑754 bit pattern back into a JavaScript number.
+ *
+ * @param bits   The raw bits (BigInt or number).
+ * @param fmt    Describes exponent/mantissa sizes, bias, and specials.
+ * @returns      The decoded JS number.
+ * @internal
+ */
+export function decode(bits, fmt) {
+    const b = BigInt(bits);
+    if (b === BigInt(fmt.nan))
+        return NAN;
+    if (b === BigInt(fmt.positive_infinity))
+        return POSITIVE_INFINITY;
+    if (b === BigInt(fmt.negative_infinity))
+        return NEGATIVE_INFINITY;
+    if (b === BigInt(fmt.negative_zero))
+        return NEGATIVE_ZERO;
+    if (b === BigInt(fmt.positive_zero))
+        return POSITIVE_ZERO;
+    const shift = fmt.exponent + fmt.mantissa;
+    const m = BigInt(fmt.mantissa), e = BigInt(fmt.exponent);
+    const mask_m = (1n << m) - 1n;
+    const mask_e = ((1n << e) - 1n) << m;
+    const sign = ((b >> BigInt(shift)) & 1n) === 1n ? -1 : 1;
+    const expo = (b & mask_e) >> m, mant = b & mask_m;
+    if (expo === 0n) {
+        // subnormal
+        const subx = 1 - fmt.bias;
+        return sign * Number(mant) * pow(2, subx - fmt.mantissa);
+    }
+    else if (expo === (1n << e) - 1n) {
+        if (mant)
+            return NAN;
+        if (sign > 0)
+            return POSITIVE_INFINITY;
+        return NEGATIVE_INFINITY;
+    }
+    const exp = Number(expo) - fmt.bias;
+    return sign * (1 + Number(mant) / pow(2, fmt.mantissa)) * pow(2, exp);
+}
+/**
+ * Round a JS number to the nearest representable value in the given format.
+ *
+ * @param value  The number to round.
+ * @param fmt    Describes exponent/mantissa sizes, bias, and specials.
+ * @returns      The rounded JS number.
+ * @internal
+ */
+export function fround(value, fmt) {
+    fmt ?? (fmt = float32);
+    return decode(encode(value, fmt), fmt);
+}
+/**
+ * Represents the IEEE-754 binary16 (half-precision) floating-point format.
+ *
+ * @internal
+ */
+export const float16 = {
+    exponent: 5,
+    mantissa: 10,
+    bias: 15,
+    nan: 0x7e00n,
+    positive_infinity: 0x7c00n,
+    negative_infinity: 0xfc00n,
+    negative_zero: 0x8000n,
+    positive_zero: 0n,
+};
+/**
+ * Represents the IEEE-754 binary32 (single-precision) floating-point format.
+ *
+ * @internal
+ */
+export const float32 = {
+    exponent: 8,
+    mantissa: 23,
+    bias: 127,
+    nan: 0x7fc00000n,
+    positive_infinity: 0x7f800000n,
+    negative_infinity: 0xff800000n,
+    negative_zero: 0x80000000n,
+    positive_zero: 0n,
+};
+/**
+ * Represents the IEEE-754 binary64 (double-precision) floating-point format.
+ *
+ * @internal
+ */
+export const float64 = {
+    exponent: 11,
+    mantissa: 52,
+    bias: 1023,
+    nan: 0x7ff8000000000000n,
+    positive_infinity: 0x7ff0000000000000n,
+    negative_infinity: 0xfff0000000000000n,
+    negative_zero: 0x8000000000000000n,
+    positive_zero: 0n,
+};
+/**
+ * Represents the IEEE-754 binary128 (quadruple-precision) floating-point
+ * format.
+ *
+ * @internal
+ */
+export const float128 = {
+    exponent: 15,
+    mantissa: 112,
+    bias: 16383,
+    nan: 0x7fff8000000000000000000000000000n,
+    positive_infinity: 0x7fff0000000000000000000000000000n,
+    negative_infinity: 0xffff0000000000000000000000000000n,
+    negative_zero: 0x80000000000000000000000000000000n,
+    positive_zero: 0n,
+};
+/**
+ * Represents all supported IEEE-754 floating-point formats.
+ *
+ * @internal
+ */
+export const formats = {
+    float16,
+    float32,
+    float64,
+    float128,
+};
+//# sourceMappingURL=ieee754.js.map

package/esm/internal/ieee754.js.map

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

package/esm/internal/primordials.d.ts

@@ -0,0 +1,30 @@
+export declare const Date: DateConstructor;
+export declare const DateNow: () => number;
+export declare const DateUTC: {
+    (year: number, monthIndex: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): number;
+    (year: number, monthIndex?: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): number;
+};
+export declare const DateParse: (s: string) => number;
+export declare const DatePrototype: Date;
+export declare const String: StringConstructor;
+export declare const StringPrototype: String;
+export declare const Number: NumberConstructor;
+export declare const NumberPrototype: Number;
+export declare const BigInt: BigIntConstructor;
+export declare const BigIntAsIntN: (bits: number, int: bigint) => bigint;
+export declare const BigIntAsUintN: (bits: number, int: bigint) => bigint;
+export declare const BigIntPrototype: BigInt;
+export declare const Object: ObjectConstructor;
+export declare const ObjectPrototype: Object;
+export declare const Array: ArrayConstructor;
+export declare const ArrayFrom: typeof Array.from;
+export declare const ArrayPrototype: any[];
+export declare const Function: FunctionConstructor;
+export declare const FunctionPrototype: Function;
+export declare const Symbol: SymbolConstructor;
+export declare const SymbolPrototype: typeof Symbol.prototype;
+export declare const SymbolFor: typeof Symbol.for;
+export declare const SymbolIterator: typeof Symbol.iterator;
+export declare const SymbolToStringTag: typeof Symbol.toStringTag;
+export declare const SymbolToPrimitive: typeof Symbol.toPrimitive;
+//# sourceMappingURL=primordials.d.ts.map

package/esm/internal/primordials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primordials.d.ts","sourceRoot":"","sources":["../../src/internal/primordials.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,EAAE,eAAiC,CAAC;AACrD,eAAO,MAAM,OAAO,cAAW,CAAC;AAChC,eAAO,MAAM,OAAO;;;CAAW,CAAC;AAChC,eAAO,MAAM,SAAS,uBAAa,CAAC;AACpC,eAAO,MAAM,aAAa,MAAiB,CAAC;AAE5C,eAAO,MAAM,MAAM,EAAE,iBAAqC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,eAAO,MAAM,MAAM,EAAE,iBAAqC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,eAAO,MAAM,MAAM,EAAE,iBAAqC,CAAC;AAC3D,eAAO,MAAM,YAAY,uCAA6B,CAAC;AACvD,eAAO,MAAM,aAAa,uCAA8B,CAAC;AACzD,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,eAAO,MAAM,MAAM,EAAE,iBAAqC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,eAAO,MAAM,KAAK,EAAE,gBAAmC,CAAC;AACxD,eAAO,MAAM,SAAS,EAAE,OAAO,KAAK,CAAC,IAA6B,CAAC;AACnE,eAAO,MAAM,cAAc,OAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,mBAAyC,CAAC;AACjE,eAAO,MAAM,iBAAiB,UAAqB,CAAC;AAEpD,eAAO,MAAM,MAAM,EAAE,iBAAqC,CAAC;AAC3D,eAAO,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC,SAA4B,CAAC;AACzE,eAAO,MAAM,SAAS,EAAE,OAAO,MAAM,CAAC,GAAgB,CAAC;AACvD,eAAO,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC,QAA0B,CAAC;AACtE,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAC,WAAgC,CAAC;AAC/E,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAC,WAAgC,CAAC"}

package/esm/internal/primordials.js

@@ -0,0 +1,27 @@
+export const Date = globalThis.Date;
+export const DateNow = Date.now;
+export const DateUTC = Date.UTC;
+export const DateParse = Date.parse;
+export const DatePrototype = Date.prototype;
+export const String = globalThis.String;
+export const StringPrototype = String.prototype;
+export const Number = globalThis.Number;
+export const NumberPrototype = Number.prototype;
+export const BigInt = globalThis.BigInt;
+export const BigIntAsIntN = BigInt.asIntN.bind(BigInt);
+export const BigIntAsUintN = BigInt.asUintN.bind(BigInt);
+export const BigIntPrototype = BigInt.prototype;
+export const Object = globalThis.Object;
+export const ObjectPrototype = Object.prototype;
+export const Array = globalThis.Array;
+export const ArrayFrom = Array.from.bind(Array);
+export const ArrayPrototype = Array.prototype;
+export const Function = globalThis.Function;
+export const FunctionPrototype = Function.prototype;
+export const Symbol = globalThis.Symbol;
+export const SymbolPrototype = Symbol.prototype;
+export const SymbolFor = Symbol.for;
+export const SymbolIterator = Symbol.iterator;
+export const SymbolToStringTag = Symbol.toStringTag;
+export const SymbolToPrimitive = Symbol.toPrimitive;
+//# sourceMappingURL=primordials.js.map

package/esm/internal/primordials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primordials.js","sourceRoot":"","sources":["../../src/internal/primordials.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAoB,UAAU,CAAC,IAAI,CAAC;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,KAAK,GAAqB,UAAU,CAAC,KAAK,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;AAE9C,MAAM,CAAC,MAAM,QAAQ,GAAwB,UAAU,CAAC,QAAQ,CAAC;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC;AAEpD,MAAM,CAAC,MAAM,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAA4B,MAAM,CAAC,SAAS,CAAC;AACzE,MAAM,CAAC,MAAM,SAAS,GAAsB,MAAM,CAAC,GAAG,CAAC;AACvD,MAAM,CAAC,MAAM,cAAc,GAA2B,MAAM,CAAC,QAAQ,CAAC;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAA8B,MAAM,CAAC,WAAW,CAAC;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAA8B,MAAM,CAAC,WAAW,CAAC"}

package/esm/log.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Calculates the natural logarithm of a number (logₑ).
+ *
+ * @param x The number to calculate the natural logarithm of (logₑ)
+ * @returns The natural logarithm of the provided number.
+ * @category Logarithmic
+ */
+export declare function log(x: number): number;
+//# sourceMappingURL=log.d.ts.map

package/esm/log.d.ts.map

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

package/esm/log.js

@@ -0,0 +1,43 @@
+/**
+ * Calculates the natural logarithm of a number (logₑ).
+ *
+ * @module log
+ */
+import { EPSILON } from "./constants/epsilon.js";
+import { LN2 } from "./constants/ln2.js";
+import { NAN } from "./constants/nan.js";
+import { POSITIVE_INFINITY } from "./constants/positive_infinity.js";
+import { NEGATIVE_INFINITY } from "./constants/negative_infinity.js";
+import { abs } from "./abs.js";
+/**
+ * Calculates the natural logarithm of a number (logₑ).
+ *
+ * @param x The number to calculate the natural logarithm of (logₑ)
+ * @returns The natural logarithm of the provided number.
+ * @category Logarithmic
+ */
+export function log(x) {
+    if ((x = +x) !== x || x < 0)
+        return NAN; // NaN for x < 0
+    if (x === 0)
+        return NEGATIVE_INFINITY; // -Infinity for x <= 0
+    if (x === 1)
+        return 0; // 0 for x = 1
+    if (x === POSITIVE_INFINITY)
+        return x; // Infinity for x = Infinity
+    const seriesEpsilon = EPSILON * 16;
+    let n = 0;
+    while (x > 2)
+        x /= 2, n++;
+    const z = (x - 1) / (x + 1), z2 = z * z;
+    let sum = 0, term = z, i = 1;
+    // series expansion for ln(1+z) converges faster when z is [-1, 1]
+    while (abs(term) >= seriesEpsilon) {
+        sum += term / i;
+        term *= z2;
+        i += 2;
+    }
+    // ln(x) + adjustment factor for original input
+    return 2 * sum + n * LN2;
+}
+//# sourceMappingURL=log.js.map

package/esm/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,gBAAgB;IACzD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC,CAAC,uBAAuB;IAC9D,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,cAAc;IACrC,IAAI,CAAC,KAAK,iBAAiB;QAAE,OAAO,CAAC,CAAC,CAAC,4BAA4B;IAEnE,MAAM,aAAa,GAAG,OAAO,GAAG,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC;QAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAE1B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAE7B,kEAAkE;IAClE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QAClC,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,EAAE,CAAC;QACX,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC3B,CAAC"}

package/esm/log10.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Calculates the base-10 logarithm of a number.
+ *
+ * @param x The number to calculate the base-10 logarithm of (log₁₀)
+ * @returns The base-10 logarithm of the provided number.
+ * @category Logarithmic
+ */
+export declare function log10(x: number): number;
+//# sourceMappingURL=log10.d.ts.map

package/esm/log10.d.ts.map

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

package/esm/log10.js

@@ -0,0 +1,18 @@
+/**
+ * Calculates the base-10 logarithm of a number.
+ *
+ * @module log10
+ */
+import { LOG10E } from "./constants/log10e.js";
+import { log } from "./log.js";
+/**
+ * Calculates the base-10 logarithm of a number.
+ *
+ * @param x The number to calculate the base-10 logarithm of (log₁₀)
+ * @returns The base-10 logarithm of the provided number.
+ * @category Logarithmic
+ */
+export function log10(x) {
+    return log(x) * LOG10E;
+}
+//# sourceMappingURL=log10.js.map

package/esm/log10.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log10.js","sourceRoot":"","sources":["../src/log10.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AACzB,CAAC"}

package/esm/log1p.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calculates the natural logarithm of 1 + x (`log(1 + x)`), accurately even
+ * for very small values of x.
+ *
+ * @param x The number whose logarithm of (1 + x) is to be calculated.
+ * @returns The natural logarithm of 1 + x.
+ * @category Logarithmic
+ */
+export declare function log1p(x: number): number;
+//# sourceMappingURL=log1p.d.ts.map

package/esm/log1p.d.ts.map

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

package/esm/log1p.js

@@ -0,0 +1,29 @@
+/**
+ * Calculates the natural logarithm of 1 + x (`log(1 + x)`), accurately even
+ * for very small values of x.
+ *
+ * @module log1p
+ */
+import { EPSILON } from "./constants/epsilon.js";
+import { NAN } from "./constants/nan.js";
+import { NEGATIVE_INFINITY } from "./constants/negative_infinity.js";
+import { abs } from "./abs.js";
+import { log } from "./log.js";
+/**
+ * Calculates the natural logarithm of 1 + x (`log(1 + x)`), accurately even
+ * for very small values of x.
+ *
+ * @param x The number whose logarithm of (1 + x) is to be calculated.
+ * @returns The natural logarithm of 1 + x.
+ * @category Logarithmic
+ */
+export function log1p(x) {
+    if (x === -1)
+        return NEGATIVE_INFINITY;
+    if (x < -1)
+        return NAN;
+    if (abs(x) < EPSILON)
+        return x;
+    return log(1 + x);
+}
+//# sourceMappingURL=log1p.js.map

package/esm/log1p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log1p.js","sourceRoot":"","sources":["../src/log1p.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,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,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACvC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACvB,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO;QAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/esm/log2.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Calculates the base-2 logarithm of a number (log₂).
+ *
+ * @param x The number to calculate the base-2 logarithm of (log₂)
+ * @returns The base-2 logarithm of the provided number.
+ * @category Logarithmic
+ * @see {@linkcode log} for the natural logarithm.
+ * @see {@linkcode log10} for the base-10 logarithm.
+ * @see {@linkcode LOG2E} for the base-2 logarithm of {@linkcode E}.
+ */
+export declare function log2(x: number): number;
+//# sourceMappingURL=log2.d.ts.map

package/esm/log2.d.ts.map

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

package/esm/log2.js

@@ -0,0 +1,21 @@
+/**
+ * Calculates the base-2 logarithm of a number (log₂).
+ *
+ * @module log2
+ */
+import { LOG2E } from "./constants/log2e.js";
+import { log } from "./log.js";
+/**
+ * Calculates the base-2 logarithm of a number (log₂).
+ *
+ * @param x The number to calculate the base-2 logarithm of (log₂)
+ * @returns The base-2 logarithm of the provided number.
+ * @category Logarithmic
+ * @see {@linkcode log} for the natural logarithm.
+ * @see {@linkcode log10} for the base-10 logarithm.
+ * @see {@linkcode LOG2E} for the base-2 logarithm of {@linkcode E}.
+ */
+export function log2(x) {
+    return log(x) * LOG2E;
+}
+//# sourceMappingURL=log2.js.map

package/esm/log2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log2.js","sourceRoot":"","sources":["../src/log2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACxB,CAAC"}