@nberlette/math 0.7.0

package/cjs/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/cjs/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/cjs/internal/ieee754.js

@@ -0,0 +1,200 @@
+"use strict";
+// src/internal/ieee754.ts
+/**
+ * Shared generic implementation for IEEE‑754 binary floating‑point
+ * encoding, decoding, and rounding.
+ *
+ * @module internal/ieee754
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formats = exports.float128 = exports.float64 = exports.float32 = exports.float16 = void 0;
+exports.encode = encode;
+exports.decode = decode;
+exports.fround = fround;
+const positive_infinity_js_1 = require("../guards/positive_infinity.js");
+const negative_infinity_js_1 = require("../guards/negative_infinity.js");
+const nan_js_1 = require("../guards/nan.js");
+const negative_zero_js_1 = require("../guards/negative_zero.js");
+const positive_zero_js_1 = require("../guards/positive_zero.js");
+const abs_js_1 = require("../abs.js");
+const floor_js_1 = require("../floor.js");
+const log2_js_1 = require("../log2.js");
+const pow_js_1 = require("../pow.js");
+const round_js_1 = require("../round.js");
+const primordials_js_1 = require("./primordials.js");
+function encode(value, fmt) {
+    return (fmt.bigint ? primordials_js_1.BigInt : primordials_js_1.Number)(inner_encode(value, fmt));
+}
+function inner_encode(value, fmt) {
+    if ((0, nan_js_1.isNaN)(value))
+        return fmt.nan;
+    if ((0, positive_infinity_js_1.isPositiveInfinity)(value))
+        return fmt.positive_infinity;
+    if ((0, negative_infinity_js_1.isNegativeInfinity)(value))
+        return fmt.negative_infinity;
+    if ((0, negative_zero_js_1.isNegativeZero)(value))
+        return fmt.negative_zero;
+    if ((0, positive_zero_js_1.isPositiveZero)(value))
+        return fmt.positive_zero;
+    const normal = 1 - fmt.bias;
+    // subnormal threshold = 2^(1-bias)
+    const cutoff = (0, pow_js_1.pow)(2, normal);
+    const sign = (0, primordials_js_1.BigInt)(value < 0 ? 1 : 0);
+    const shift = (0, primordials_js_1.BigInt)(fmt.exponent + fmt.mantissa);
+    const absolute = (0, abs_js_1.abs)(value);
+    if (absolute < cutoff) {
+        // subnormal
+        const scale = normal - fmt.mantissa;
+        const mant = (0, primordials_js_1.BigInt)((0, round_js_1.round)(absolute / (0, pow_js_1.pow)(2, scale)));
+        return (sign << shift) | mant;
+    }
+    // normal
+    let expo = (0, floor_js_1.floor)((0, log2_js_1.log2)(absolute)), mant = absolute / (0, pow_js_1.pow)(2, expo);
+    if (mant < 1) {
+        mant *= 2;
+        expo--;
+    }
+    else if (mant >= 2) {
+        mant /= 2;
+        expo++;
+    }
+    const mant_scale = (0, pow_js_1.pow)(2, fmt.mantissa);
+    let mant_bits = (0, round_js_1.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 = (0, primordials_js_1.BigInt)(biased);
+    const m = (0, primordials_js_1.BigInt)(mant_bits);
+    return (sign << shift) | (e << (0, primordials_js_1.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
+ */
+function decode(bits, fmt) {
+    const b = (0, primordials_js_1.BigInt)(bits);
+    if (b === (0, primordials_js_1.BigInt)(fmt.nan))
+        return nan_js_1.NAN;
+    if (b === (0, primordials_js_1.BigInt)(fmt.positive_infinity))
+        return positive_infinity_js_1.POSITIVE_INFINITY;
+    if (b === (0, primordials_js_1.BigInt)(fmt.negative_infinity))
+        return negative_infinity_js_1.NEGATIVE_INFINITY;
+    if (b === (0, primordials_js_1.BigInt)(fmt.negative_zero))
+        return negative_zero_js_1.NEGATIVE_ZERO;
+    if (b === (0, primordials_js_1.BigInt)(fmt.positive_zero))
+        return positive_zero_js_1.POSITIVE_ZERO;
+    const shift = fmt.exponent + fmt.mantissa;
+    const m = (0, primordials_js_1.BigInt)(fmt.mantissa), e = (0, primordials_js_1.BigInt)(fmt.exponent);
+    const mask_m = (1n << m) - 1n;
+    const mask_e = ((1n << e) - 1n) << m;
+    const sign = ((b >> (0, primordials_js_1.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 * (0, primordials_js_1.Number)(mant) * (0, pow_js_1.pow)(2, subx - fmt.mantissa);
+    }
+    else if (expo === (1n << e) - 1n) {
+        if (mant)
+            return nan_js_1.NAN;
+        if (sign > 0)
+            return positive_infinity_js_1.POSITIVE_INFINITY;
+        return negative_infinity_js_1.NEGATIVE_INFINITY;
+    }
+    const exp = (0, primordials_js_1.Number)(expo) - fmt.bias;
+    return sign * (1 + (0, primordials_js_1.Number)(mant) / (0, pow_js_1.pow)(2, fmt.mantissa)) * (0, pow_js_1.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
+ */
+function fround(value, fmt) {
+    fmt ?? (fmt = exports.float32);
+    return decode(encode(value, fmt), fmt);
+}
+/**
+ * Represents the IEEE-754 binary16 (half-precision) floating-point format.
+ *
+ * @internal
+ */
+exports.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
+ */
+exports.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
+ */
+exports.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
+ */
+exports.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
+ */
+exports.formats = {
+    float16: exports.float16,
+    float32: exports.float32,
+    float64: exports.float64,
+    float128: exports.float128,
+};
+//# sourceMappingURL=ieee754.js.map

package/cjs/internal/ieee754.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ieee754.js","sourceRoot":"","sources":["../../src/internal/ieee754.ts"],"names":[],"mappings":";AAAA,0BAA0B;AAC1B;;;;;GAKG;;;AA+DH,wBAKC;AA0DD,wBAgCC;AAUD,wBAGC;AAzKD,yEAGwC;AACxC,yEAGwC;AACxC,6CAA8C;AAC9C,iEAA2E;AAC3E,iEAA2E;AAC3E,sCAAgC;AAChC,0CAAoC;AACpC,wCAAkC;AAClC,sCAAgC;AAChC,0CAAoC;AACpC,qDAAkD;AA6ClD,SAAgB,MAAM,CACpB,KAAa,EACb,GAAoC;IAEpC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAM,CAAC,CAAC,CAAC,uBAAM,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,GAAW;IAC9C,IAAI,IAAA,cAAK,EAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IACjC,IAAI,IAAA,yCAAkB,EAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC5D,IAAI,IAAA,yCAAkB,EAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC5D,IAAI,IAAA,iCAAc,EAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,aAAa,CAAC;IACpD,IAAI,IAAA,iCAAc,EAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,aAAa,CAAC;IAEpD,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IAC5B,mCAAmC;IACnC,MAAM,MAAM,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,IAAA,uBAAM,EAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAA,uBAAM,EAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAA,YAAG,EAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,QAAQ,GAAG,MAAM,EAAE,CAAC;QACtB,YAAY;QACZ,MAAM,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;QACpC,MAAM,IAAI,GAAG,IAAA,uBAAM,EAAC,IAAA,gBAAK,EAAC,QAAQ,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,SAAS;IACT,IAAI,IAAI,GAAG,IAAA,gBAAK,EAAC,IAAA,cAAI,EAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,CAAC;QACV,IAAI,EAAE,CAAC;IACT,CAAC;SAAM,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,CAAC;QACV,IAAI,EAAE,CAAC;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,SAAS,GAAG,IAAA,gBAAK,EAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,SAAS,GAAG,CAAC,CAAC;QACd,IAAI,EAAE,CAAC;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAC/B,IAAI,MAAM,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,GAAG,IAAA,uBAAM,EAAC,MAAM,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,IAAA,uBAAM,EAAC,SAAS,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,IAAA,uBAAM,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CACpB,IAA8B,EAC9B,GAAgB;IAEhB,MAAM,CAAC,GAAG,IAAA,uBAAM,EAAC,IAAI,CAAC,CAAC;IAEvB,IAAI,CAAC,KAAK,IAAA,uBAAM,EAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,YAAG,CAAC;IACtC,IAAI,CAAC,KAAK,IAAA,uBAAM,EAAC,GAAG,CAAC,iBAAiB,CAAC;QAAE,OAAO,wCAAiB,CAAC;IAClE,IAAI,CAAC,KAAK,IAAA,uBAAM,EAAC,GAAG,CAAC,iBAAiB,CAAC;QAAE,OAAO,wCAAiB,CAAC;IAClE,IAAI,CAAC,KAAK,IAAA,uBAAM,EAAC,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO,gCAAa,CAAC;IAC1D,IAAI,CAAC,KAAK,IAAA,uBAAM,EAAC,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO,gCAAa,CAAC;IAE1D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAA,uBAAM,EAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAA,uBAAM,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAA,uBAAM,EAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC;IAElD,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,YAAY;QACZ,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;QAC1B,OAAO,IAAI,GAAG,IAAA,uBAAM,EAAC,IAAI,CAAC,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI;YAAE,OAAO,YAAG,CAAC;QACrB,IAAI,IAAI,GAAG,CAAC;YAAE,OAAO,wCAAiB,CAAC;QACvC,OAAO,wCAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,uBAAM,EAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACpC,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,IAAA,uBAAM,EAAC,IAAI,CAAC,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAA,YAAG,EAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAC,KAAa,EAAE,GAAiB;IACrD,GAAG,KAAH,GAAG,GAAK,eAAO,EAAC;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,OAAO;IACZ,iBAAiB,EAAE,OAAO;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,OAAO;IACtB,aAAa,EAAE,EAAE;CACa,CAAC;AAEjC;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,GAAG;IACT,GAAG,EAAE,WAAW;IAChB,iBAAiB,EAAE,WAAW;IAC9B,iBAAiB,EAAE,WAAW;IAC9B,aAAa,EAAE,WAAW;IAC1B,aAAa,EAAE,EAAE;CACa,CAAC;AAEjC;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,mBAAmB;IACxB,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,mBAAmB;IAClC,aAAa,EAAE,EAAE;CACa,CAAC;AAEjC;;;;;GAKG;AACU,QAAA,QAAQ,GAAG;IACtB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,mCAAmC;IACxC,iBAAiB,EAAE,mCAAmC;IACtD,iBAAiB,EAAE,mCAAmC;IACtD,aAAa,EAAE,mCAAmC;IAClD,aAAa,EAAE,EAAE;CACa,CAAC;AAEjC;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,OAAO,EAAP,eAAO;IACP,OAAO,EAAP,eAAO;IACP,OAAO,EAAP,eAAO;IACP,QAAQ,EAAR,gBAAQ;CACsC,CAAC"}

package/cjs/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/cjs/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/cjs/internal/primordials.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SymbolToPrimitive = exports.SymbolToStringTag = exports.SymbolIterator = exports.SymbolFor = exports.SymbolPrototype = exports.Symbol = exports.FunctionPrototype = exports.Function = exports.ArrayPrototype = exports.ArrayFrom = exports.Array = exports.ObjectPrototype = exports.Object = exports.BigIntPrototype = exports.BigIntAsUintN = exports.BigIntAsIntN = exports.BigInt = exports.NumberPrototype = exports.Number = exports.StringPrototype = exports.String = exports.DatePrototype = exports.DateParse = exports.DateUTC = exports.DateNow = exports.Date = void 0;
+exports.Date = globalThis.Date;
+exports.DateNow = exports.Date.now;
+exports.DateUTC = exports.Date.UTC;
+exports.DateParse = exports.Date.parse;
+exports.DatePrototype = exports.Date.prototype;
+exports.String = globalThis.String;
+exports.StringPrototype = exports.String.prototype;
+exports.Number = globalThis.Number;
+exports.NumberPrototype = exports.Number.prototype;
+exports.BigInt = globalThis.BigInt;
+exports.BigIntAsIntN = exports.BigInt.asIntN.bind(exports.BigInt);
+exports.BigIntAsUintN = exports.BigInt.asUintN.bind(exports.BigInt);
+exports.BigIntPrototype = exports.BigInt.prototype;
+exports.Object = globalThis.Object;
+exports.ObjectPrototype = exports.Object.prototype;
+exports.Array = globalThis.Array;
+exports.ArrayFrom = exports.Array.from.bind(exports.Array);
+exports.ArrayPrototype = exports.Array.prototype;
+exports.Function = globalThis.Function;
+exports.FunctionPrototype = exports.Function.prototype;
+exports.Symbol = globalThis.Symbol;
+exports.SymbolPrototype = exports.Symbol.prototype;
+exports.SymbolFor = exports.Symbol.for;
+exports.SymbolIterator = exports.Symbol.iterator;
+exports.SymbolToStringTag = exports.Symbol.toStringTag;
+exports.SymbolToPrimitive = exports.Symbol.toPrimitive;
+//# sourceMappingURL=primordials.js.map

package/cjs/internal/primordials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primordials.js","sourceRoot":"","sources":["../../src/internal/primordials.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAoB,UAAU,CAAC,IAAI,CAAC;AACxC,QAAA,OAAO,GAAG,YAAI,CAAC,GAAG,CAAC;AACnB,QAAA,OAAO,GAAG,YAAI,CAAC,GAAG,CAAC;AACnB,QAAA,SAAS,GAAG,YAAI,CAAC,KAAK,CAAC;AACvB,QAAA,aAAa,GAAG,YAAI,CAAC,SAAS,CAAC;AAE/B,QAAA,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC9C,QAAA,eAAe,GAAG,cAAM,CAAC,SAAS,CAAC;AAEnC,QAAA,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC9C,QAAA,eAAe,GAAG,cAAM,CAAC,SAAS,CAAC;AAEnC,QAAA,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC9C,QAAA,YAAY,GAAG,cAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,CAAC;AAC1C,QAAA,aAAa,GAAG,cAAM,CAAC,OAAO,CAAC,IAAI,CAAC,cAAM,CAAC,CAAC;AAC5C,QAAA,eAAe,GAAG,cAAM,CAAC,SAAS,CAAC;AAEnC,QAAA,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC9C,QAAA,eAAe,GAAG,cAAM,CAAC,SAAS,CAAC;AAEnC,QAAA,KAAK,GAAqB,UAAU,CAAC,KAAK,CAAC;AAC3C,QAAA,SAAS,GAAsB,aAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAK,CAAC,CAAC;AACtD,QAAA,cAAc,GAAG,aAAK,CAAC,SAAS,CAAC;AAEjC,QAAA,QAAQ,GAAwB,UAAU,CAAC,QAAQ,CAAC;AACpD,QAAA,iBAAiB,GAAG,gBAAQ,CAAC,SAAS,CAAC;AAEvC,QAAA,MAAM,GAAsB,UAAU,CAAC,MAAM,CAAC;AAC9C,QAAA,eAAe,GAA4B,cAAM,CAAC,SAAS,CAAC;AAC5D,QAAA,SAAS,GAAsB,cAAM,CAAC,GAAG,CAAC;AAC1C,QAAA,cAAc,GAA2B,cAAM,CAAC,QAAQ,CAAC;AACzD,QAAA,iBAAiB,GAA8B,cAAM,CAAC,WAAW,CAAC;AAClE,QAAA,iBAAiB,GAA8B,cAAM,CAAC,WAAW,CAAC"}

package/cjs/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/cjs/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/cjs/log.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+/**
+ * Calculates the natural logarithm of a number (logₑ).
+ *
+ * @module log
+ */
+const epsilon_js_1 = require("./constants/epsilon.js");
+const ln2_js_1 = require("./constants/ln2.js");
+const nan_js_1 = require("./constants/nan.js");
+const positive_infinity_js_1 = require("./constants/positive_infinity.js");
+const negative_infinity_js_1 = require("./constants/negative_infinity.js");
+const abs_js_1 = require("./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
+ */
+function log(x) {
+    if ((x = +x) !== x || x < 0)
+        return nan_js_1.NAN; // NaN for x < 0
+    if (x === 0)
+        return negative_infinity_js_1.NEGATIVE_INFINITY; // -Infinity for x <= 0
+    if (x === 1)
+        return 0; // 0 for x = 1
+    if (x === positive_infinity_js_1.POSITIVE_INFINITY)
+        return x; // Infinity for x = Infinity
+    const seriesEpsilon = epsilon_js_1.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 ((0, abs_js_1.abs)(term) >= seriesEpsilon) {
+        sum += term / i;
+        term *= z2;
+        i += 2;
+    }
+    // ln(x) + adjustment factor for original input
+    return 2 * sum + n * ln2_js_1.LN2;
+}
+//# sourceMappingURL=log.js.map

package/cjs/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":";;AAmBA,kBAsBC;AAzCD;;;;GAIG;AACH,uDAAiD;AACjD,+CAAyC;AACzC,+CAAyC;AACzC,2EAAqE;AACrE,2EAAqE;AACrE,qCAA+B;AAE/B;;;;;;GAMG;AACH,SAAgB,GAAG,CAAC,CAAS;IAC3B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,YAAG,CAAC,CAAC,gBAAgB;IACzD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,wCAAiB,CAAC,CAAC,uBAAuB;IAC9D,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,cAAc;IACrC,IAAI,CAAC,KAAK,wCAAiB;QAAE,OAAO,CAAC,CAAC,CAAC,4BAA4B;IAEnE,MAAM,aAAa,GAAG,oBAAO,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,IAAA,YAAG,EAAC,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,YAAG,CAAC;AAC3B,CAAC"}

package/cjs/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/cjs/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/cjs/log10.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log10 = log10;
+/**
+ * Calculates the base-10 logarithm of a number.
+ *
+ * @module log10
+ */
+const log10e_js_1 = require("./constants/log10e.js");
+const log_js_1 = require("./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
+ */
+function log10(x) {
+    return (0, log_js_1.log)(x) * log10e_js_1.LOG10E;
+}
+//# sourceMappingURL=log10.js.map

package/cjs/log10.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log10.js","sourceRoot":"","sources":["../src/log10.ts"],"names":[],"mappings":";;AAeA,sBAEC;AAjBD;;;;GAIG;AACH,qDAA+C;AAC/C,qCAA+B;AAE/B;;;;;;GAMG;AACH,SAAgB,KAAK,CAAC,CAAS;IAC7B,OAAO,IAAA,YAAG,EAAC,CAAC,CAAC,GAAG,kBAAM,CAAC;AACzB,CAAC"}

package/cjs/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/cjs/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/cjs/log1p.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log1p = log1p;
+/**
+ * Calculates the natural logarithm of 1 + x (`log(1 + x)`), accurately even
+ * for very small values of x.
+ *
+ * @module log1p
+ */
+const epsilon_js_1 = require("./constants/epsilon.js");
+const nan_js_1 = require("./constants/nan.js");
+const negative_infinity_js_1 = require("./constants/negative_infinity.js");
+const abs_js_1 = require("./abs.js");
+const log_js_1 = require("./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
+ */
+function log1p(x) {
+    if (x === -1)
+        return negative_infinity_js_1.NEGATIVE_INFINITY;
+    if (x < -1)
+        return nan_js_1.NAN;
+    if ((0, abs_js_1.abs)(x) < epsilon_js_1.EPSILON)
+        return x;
+    return (0, log_js_1.log)(1 + x);
+}
+//# sourceMappingURL=log1p.js.map

package/cjs/log1p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log1p.js","sourceRoot":"","sources":["../src/log1p.ts"],"names":[],"mappings":";;AAoBA,sBAKC;AAzBD;;;;;GAKG;AACH,uDAAiD;AACjD,+CAAyC;AACzC,2EAAqE;AACrE,qCAA+B;AAC/B,qCAA+B;AAE/B;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,wCAAiB,CAAC;IACvC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,YAAG,CAAC;IACvB,IAAI,IAAA,YAAG,EAAC,CAAC,CAAC,GAAG,oBAAO;QAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,IAAA,YAAG,EAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/cjs/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/cjs/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/cjs/log2.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log2 = log2;
+/**
+ * Calculates the base-2 logarithm of a number (log₂).
+ *
+ * @module log2
+ */
+const log2e_js_1 = require("./constants/log2e.js");
+const log_js_1 = require("./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}.
+ */
+function log2(x) {
+    return (0, log_js_1.log)(x) * log2e_js_1.LOG2E;
+}
+//# sourceMappingURL=log2.js.map