@danielsimonjr/mathts-core 0.14.3 → 0.15.1

package/dist/types/bignumber.d.ts

@@ -0,0 +1,370 @@
+/**
+ * BigNumber (arbitrary precision decimal) implementation
+ * @module @danielsimonjr/mathts-core/types/bignumber
+ */
+import type { Scalar, MathTSValue } from './interfaces';
+/**
+ * Check if a value is a BigNumber
+ */
+export declare function isBigNumber(value: unknown): value is BigNumber;
+/**
+ * Configuration for BigNumber operations
+ */
+export interface BigNumberConfig {
+    /** Number of significant digits (default: 64) */
+    precision: number;
+    /** Rounding mode (default: 'halfUp') */
+    rounding: RoundingMode;
+    /** Minimum exponent (default: -1e9) */
+    minExponent: number;
+    /** Maximum exponent (default: 1e9) */
+    maxExponent: number;
+}
+/**
+ * Rounding mode of a BigNumber operation. The default configuration uses `'halfUp'`.
+ */
+export type RoundingMode = 'up' | 'down' | 'ceil' | 'floor' | 'halfUp' | 'halfDown' | 'halfEven' | 'halfCeil' | 'halfFloor';
+/**
+ * BigNumber class for arbitrary precision decimal arithmetic
+ *
+ * Internally stores: sign * coefficient * 10^exponent
+ * where coefficient is a bigint with the significant digits.
+ */
+export declare class BigNumber implements MathTSValue {
+    readonly type = "BigNumber";
+    /**
+     * Duck-typing marker for Decimal.js / mathjs formatter compatibility.
+     * Allows external code that checks `obj.isBigNumber === true` to identify
+     * this class without an `instanceof` check.
+     */
+    readonly isBigNumber = true;
+    private readonly _sign;
+    private readonly _coefficient;
+    private readonly _exponent;
+    private readonly _isNaN;
+    private readonly _isInfinite;
+    private constructor();
+    /**
+     * Create a BigNumber from a number
+     */
+    static fromNumber(n: number): BigNumber;
+    /**
+     * Create a BigNumber from a string
+     */
+    static parse(str: string): BigNumber;
+    /**
+     * Create from bigint
+     */
+    static fromBigInt(n: bigint): BigNumber;
+    /**
+     * Create a BigNumber from a JSON object
+     */
+    static fromJSON(json: {
+        value: string;
+    }): BigNumber;
+    /**
+     * Get/set global configuration
+     */
+    static config(newConfig?: Partial<BigNumberConfig>): BigNumberConfig;
+    /**
+     * Reset configuration to defaults
+     */
+    static resetConfig(): void;
+    /**
+     * Compare two BigNumbers
+     * @returns -1, 0, or 1
+     */
+    static compare(a: BigNumber, b: BigNumber): number;
+    private static compareMagnitude;
+    valueOf(): number;
+    /**
+     * Convert to a JS number.
+     * Alias for `valueOf()` — provided for Decimal.js / mathjs formatter
+     * duck-typing compatibility.
+     */
+    toNumber(): number;
+    toString(): string;
+    toJSON(): {
+        mathjs: string;
+        value: string;
+    };
+    /**
+     * Convert to fixed-point notation.
+     *
+     * When called with no argument (or `undefined`) returns the full fixed-point
+     * string representation without rounding — matching Decimal.js semantics where
+     * `toFixed()` is equivalent to a lossless fixed-point stringify.
+     * When called with a non-negative integer `decimalPlaces`, rounds and formats
+     * to exactly that many digits after the decimal point.
+     */
+    toFixed(decimalPlaces?: number): string;
+    private toFixedInternal;
+    /**
+     * Convert to exponential notation
+     */
+    toExponential(decimalPlaces?: number): string;
+    /**
+     * Convert to precision
+     */
+    toPrecision(significantDigits?: number): string;
+    /**
+     * Convert to bigint (truncated)
+     */
+    toBigInt(): bigint;
+    /**
+     * Binary string representation, e.g. `255 -> '0b11111111'`, `0.5 -> '0b0.1'`.
+     * Mirrors Decimal.js `toBinary()`. Negatives carry a leading `-`.
+     */
+    toBinary(): string;
+    /**
+     * Octal string representation, e.g. `8 -> '0o10'`.
+     * Mirrors Decimal.js `toOctal()`.
+     */
+    toOctal(): string;
+    /**
+     * Hexadecimal string representation, e.g. `255 -> '0xff'`, `10.5 -> '0xa.8'`.
+     * Mirrors Decimal.js `toHexadecimal()`.
+     */
+    toHexadecimal(): string;
+    /**
+     * Shared radix formatter for {@link toBinary}/{@link toOctal}/{@link toHexadecimal}.
+     * Integers and terminating fractions are exact; a non-terminating fraction is
+     * truncated at `maxFractionDigits` radix digits (a safety bound — the common
+     * use is integer formatting).
+     */
+    private toRadixString;
+    /**
+     * Addition
+     */
+    add(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Subtraction
+     */
+    subtract(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Alias for subtract — mathjs / Decimal.js compatibility.
+     */
+    sub(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Multiplication
+     */
+    multiply(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Alias for multiply — mathjs / Decimal.js compatibility.
+     */
+    mul(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Alias for multiply — Decimal.js calling convention (used by the Unit).
+     */
+    times(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Division
+     */
+    divide(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Alias for divide — Decimal.js calling convention (used by the Unit).
+     */
+    div(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Negation
+     */
+    negate(): BigNumber;
+    /**
+     * Absolute value
+     */
+    abs(): BigNumber;
+    /**
+     * Power (integer exponent)
+     */
+    pow(n: number | bigint): BigNumber;
+    /**
+     * Square root
+     */
+    sqrt(): BigNumber;
+    equals(other: BigNumber | number | string): boolean;
+    lessThan(other: BigNumber | number | string): boolean;
+    lessThanOrEqual(other: BigNumber | number | string): boolean;
+    greaterThan(other: BigNumber | number | string): boolean;
+    greaterThanOrEqual(other: BigNumber | number | string): boolean;
+    compareTo(other: BigNumber | number | string): number;
+    compare(other: BigNumber | number | string): number;
+    /**
+     * Returns true iff this > other.
+     * Accepts the same argument types as `add`/`multiply` (BigNumber, number, or string).
+     * Named `gt` for Decimal.js / mathjs formatter compatibility.
+     */
+    gt(other: BigNumber | number | string): boolean;
+    /**
+     * Round to specified decimal places
+     */
+    round(decimalPlaces?: number, mode?: RoundingMode): BigNumber;
+    private shouldRound;
+    /**
+     * Round to specified precision (significant digits)
+     */
+    roundToPrecision(precision: number, mode?: RoundingMode): BigNumber;
+    floor(): BigNumber;
+    ceil(): BigNumber;
+    trunc(): BigNumber;
+    /**
+     * Round to `n` significant decimal digits and return a new BigNumber.
+     * Delegates to `roundToPrecision`, using the global rounding mode unless
+     * an explicit `roundingMode` is supplied.
+     *
+     * Named `toSignificantDigits` for Decimal.js / mathjs formatter compatibility.
+     * When `n` is undefined the value is returned unchanged (no rounding).
+     */
+    toSignificantDigits(n?: number, roundingMode?: RoundingMode): BigNumber;
+    /**
+     * The decimal exponent of this number: `floor(log10(|x|))`.
+     *
+     * Matches Decimal.js semantics:
+     *   - `12345` → `4`   (5 digits → the most-significant place is 10^4)
+     *   - `0.0123` → `-2`  (first significant digit is at 10^-2)
+     *   - `100` → `2`
+     *   - `0.01` → `-2`
+     *   - `0` → `0`        (by convention; `isZero()` can be used to distinguish)
+     *
+     * For special values (NaN, ±Infinity) returns 0 — callers check
+     * `isFinite()` / `isNaN()` before using `.e`.
+     */
+    get e(): number;
+    /**
+     * Modulo (remainder after division)
+     * Result has the same sign as the dividend (this).
+     */
+    mod(other: Scalar | BigNumber | number | string): BigNumber;
+    /**
+     * Sine of this BigNumber (in radians)
+     * Uses Taylor series: sin(x) = x - x^3/3! + x^5/5! - ...
+     */
+    sin(): BigNumber;
+    /**
+     * Cosine of this BigNumber (in radians)
+     * Uses Taylor series: cos(x) = 1 - x^2/2! + x^4/4! - ...
+     */
+    cos(): BigNumber;
+    /**
+     * Tangent of this BigNumber (in radians)
+     * tan(x) = sin(x) / cos(x)
+     */
+    tan(): BigNumber;
+    /**
+     * Arcsine of this BigNumber
+     * Returns value in [-PI/2, PI/2]
+     */
+    asin(): BigNumber;
+    /**
+     * Arccosine of this BigNumber
+     * Returns value in [0, PI]
+     */
+    acos(): BigNumber;
+    /**
+     * Arctangent of this BigNumber
+     * Returns value in (-PI/2, PI/2)
+     * Uses Taylor series with argument reduction for convergence.
+     */
+    atan(): BigNumber;
+    /**
+     * Two-argument arctangent: atan2(y, x)
+     * this = y, argument = x
+     * Returns angle in (-PI, PI]
+     */
+    atan2(x: BigNumber): BigNumber;
+    /**
+     * Hyperbolic sine: sinh(x) = (e^x - e^(-x)) / 2
+     */
+    sinh(): BigNumber;
+    /**
+     * Hyperbolic cosine: cosh(x) = (e^x + e^(-x)) / 2
+     */
+    cosh(): BigNumber;
+    /**
+     * Hyperbolic tangent: tanh(x) = sinh(x) / cosh(x)
+     */
+    tanh(): BigNumber;
+    /**
+     * Inverse hyperbolic sine: asinh(x) = ln(x + sqrt(x^2 + 1))
+     */
+    asinh(): BigNumber;
+    /**
+     * Inverse hyperbolic cosine: acosh(x) = ln(x + sqrt(x^2 - 1))
+     * Domain: x >= 1
+     */
+    acosh(): BigNumber;
+    /**
+     * Inverse hyperbolic tangent: atanh(x) = 0.5 * ln((1+x)/(1-x))
+     * Domain: -1 < x < 1
+     */
+    atanh(): BigNumber;
+    /**
+     * Exponential function: e^x
+     * Uses Taylor series: e^x = 1 + x + x^2/2! + x^3/3! + ...
+     * With argument reduction: e^x = (e^(x/2^k))^(2^k) for faster convergence.
+     */
+    exp(): BigNumber;
+    /**
+     * Natural logarithm: ln(x)
+     * Uses the AGM (arithmetic-geometric mean) method for fast convergence.
+     * Fallback: series ln((1+y)/(1-y)) = 2*(y + y^3/3 + y^5/5 + ...) where y = (x-1)/(x+1)
+     */
+    ln(): BigNumber;
+    /**
+     * Base-10 logarithm: log10(x) = ln(x) / ln(10)
+     */
+    log10(): BigNumber;
+    /**
+     * Base-2 logarithm: log2(x) = ln(x) / ln(2)
+     */
+    log2(): BigNumber;
+    /**
+     * Cube root
+     * Uses Newton-Raphson iteration.
+     */
+    cbrt(): BigNumber;
+    /**
+     * e^x - 1 (more precise than exp(x) - 1 for small x)
+     * Uses Taylor series directly: expm1(x) = x + x^2/2! + x^3/3! + ...
+     */
+    expm1(): BigNumber;
+    /**
+     * ln(1 + x) (more precise than ln(1 + x) for small x)
+     */
+    log1p(): BigNumber;
+    /**
+     * Hypotenuse: sqrt(this^2 + other^2)
+     */
+    hypot(other: BigNumber): BigNumber;
+    /** Reduce angle to [-PI, PI] range */
+    private _reduceAngle;
+    /** Taylor series for sin(x), assumes x is in [-PI, PI] */
+    private _sinTaylor;
+    /** Taylor series for cos(x), assumes x is in [-PI, PI] */
+    private _cosTaylor;
+    /** Taylor series for atan(x), assumes |x| <= 0.5 */
+    private _atanTaylor;
+    isNaN(): boolean;
+    isFinite(): boolean;
+    isInfinite(): boolean;
+    isZero(): boolean;
+    isPositive(): boolean;
+    isNegative(): boolean;
+    isInteger(): boolean;
+    sign(): number;
+    clone(): BigNumber;
+    private ensureBigNumber;
+    private alignExponents;
+    private normalize;
+}
+/**
+ * Common BigNumber constants
+ */
+export declare const BIGNUMBER_ZERO: BigNumber;
+export declare const BIGNUMBER_ONE: BigNumber;
+export declare const BIGNUMBER_NEG_ONE: BigNumber;
+export declare const BIGNUMBER_TEN: BigNumber;
+export declare const BIGNUMBER_PI: BigNumber;
+export declare const BIGNUMBER_E: BigNumber;
+export declare const BIGNUMBER_LN2: BigNumber;
+export declare const BIGNUMBER_LN10: BigNumber;
+//# sourceMappingURL=bignumber.d.ts.map

package/dist/types/bignumber.d.ts.map

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

package/dist/types/complex.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Complex number implementation
+ * @module @danielsimonjr/mathts-core/types/complex
+ */
+import type { Scalar, IComplex } from './interfaces';
+/**
+ * Check if a value is a Complex number
+ */
+export declare function isComplex(value: unknown): value is Complex;
+/**
+ * Complex number class with full arithmetic support
+ * Implements the IComplex interface for type-safe complex number operations.
+ */
+export declare class Complex implements IComplex {
+    readonly type = "Complex";
+    readonly re: number;
+    readonly im: number;
+    constructor(re: number, im?: number);
+    /**
+     * Create a Complex from polar form (r, θ)
+     * @param r - magnitude (radius)
+     * @param theta - angle in radians
+     */
+    static fromPolar(r: number, theta: number): Complex;
+    /**
+     * Create a Complex from a real number
+     */
+    static fromNumber(n: number): Complex;
+    /**
+     * Create a Complex from a JSON object
+     */
+    static fromJSON(json: {
+        re: number;
+        im: number;
+    }): Complex;
+    /**
+     * Parse a complex number from a string
+     * Supports formats: "3+4i", "3-4i", "3", "4i", "-4i", "i", "-i"
+     */
+    static parse(str: string): Complex;
+    /**
+     * Compare two complex numbers lexicographically (re first, then im)
+     * @returns -1, 0, or 1
+     */
+    static compare(a: Complex, b: Complex): number;
+    valueOf(): number;
+    toString(): string;
+    toJSON(): {
+        mathjs: string;
+        re: number;
+        im: number;
+    };
+    /**
+     * Return polar representation
+     */
+    toPolar(): {
+        r: number;
+        phi: number;
+    };
+    /**
+     * Format with options (precision, notation, etc.)
+     */
+    format(options?: {
+        precision?: number;
+        notation?: 'fixed' | 'exponential' | 'auto';
+    }): string;
+    /**
+     * Complex conjugate (a + bi → a - bi)
+     */
+    conjugate(): Complex;
+    /**
+     * Magnitude (absolute value) |z| = √(re² + im²)
+     */
+    abs(): number;
+    /**
+     * Phase angle (argument) in radians, range (-π, π]
+     */
+    arg(): number;
+    /**
+     * Squared magnitude |z|² = re² + im²
+     * More efficient than abs() when you don't need the square root
+     */
+    abs2(): number;
+    /**
+     * Addition: (a + bi) + (c + di) = (a + c) + (b + d)i
+     */
+    add(other: Scalar): Complex;
+    /**
+     * Subtraction: (a + bi) - (c + di) = (a - c) + (b - d)i
+     */
+    subtract(other: Scalar): Complex;
+    /**
+     * Multiplication: (a + bi)(c + di) = (ac - bd) + (ad + bc)i
+     */
+    multiply(other: Scalar): Complex;
+    /**
+     * Division: (a + bi)/(c + di) = ((ac + bd) + (bc - ad)i) / (c² + d²)
+     */
+    divide(other: Scalar): Complex;
+    sub(other: Scalar): Complex;
+    mul(other: Scalar): Complex;
+    div(other: Scalar): Complex;
+    neg(): Complex;
+    /**
+     * Negation: -(a + bi) = -a - bi
+     */
+    negate(): Complex;
+    /**
+     * Multiplicative inverse: 1/z = z̄/|z|²
+     */
+    inverse(): Complex;
+    /**
+     * Square root using the principal branch (Re ≥ 0; Im has the sign of `this.im`).
+     *
+     * Algebraic form, not polar: one hypot + one sqrt instead of hypot + atan2 +
+     * cos + sin. Same branch cut as C99 / the previous polar implementation,
+     * including `sqrt(-x - 0i) = −√x · i`.
+     */
+    sqrt(): Complex;
+    /**
+     * n-th root (returns principal root)
+     */
+    nthRoot(n: number): Complex;
+    /**
+     * All n-th roots
+     */
+    nthRoots(n: number): Complex[];
+    /**
+     * Exponential: e^(a+bi) = e^a · (cos(b) + i·sin(b))
+     */
+    exp(): Complex;
+    /**
+     * Natural logarithm: ln(z) = ln|z| + i·arg(z)
+     */
+    log(): Complex;
+    /**
+     * Logarithm base 10
+     */
+    log10(): Complex;
+    /**
+     * Logarithm base 2
+     */
+    log2(): Complex;
+    /**
+     * Power: z^w = e^(w·ln(z))
+     */
+    pow(n: number | Complex): Complex;
+    /**
+     * Sine: sin(a + bi) = sin(a)cosh(b) + i·cos(a)sinh(b)
+     */
+    sin(): Complex;
+    /**
+     * Cosine: cos(a + bi) = cos(a)cosh(b) - i·sin(a)sinh(b)
+     */
+    cos(): Complex;
+    /**
+     * Tangent: tan(x+iy) = (sin 2x + i sinh 2y) / (cos 2x + cosh 2y)
+     *
+     * Closed form — no intermediate `sin`/`cos` Complex allocations.
+     */
+    tan(): Complex;
+    /**
+     * Cotangent: cot(x+iy) = (sin 2x − i sinh 2y) / (cosh 2y − cos 2x)
+     */
+    cot(): Complex;
+    /**
+     * Secant: sec(z) = 1 / cos(z)
+     */
+    sec(): Complex;
+    /**
+     * Cosecant: csc(z) = 1 / sin(z)
+     */
+    csc(): Complex;
+    /**
+     * Hyperbolic sine: sinh(z) = (e^z - e^(-z)) / 2
+     */
+    sinh(): Complex;
+    /**
+     * Hyperbolic cosine: cosh(z) = (e^z + e^(-z)) / 2
+     */
+    cosh(): Complex;
+    /**
+     * Hyperbolic tangent: tanh(x+iy) = (sinh 2x + i sin 2y) / (cosh 2x + cos 2y)
+     */
+    tanh(): Complex;
+    /**
+     * Hyperbolic cotangent: coth(x+iy) = (sinh 2x − i sin 2y) / (cosh 2x − cos 2y)
+     */
+    coth(): Complex;
+    /**
+     * Hyperbolic secant: sech(z) = 1 / cosh(z)
+     */
+    sech(): Complex;
+    /**
+     * Hyperbolic cosecant: csch(z) = 1 / sinh(z)
+     */
+    csch(): Complex;
+    /**
+     * Arc sine: asin(z) = -i·ln(iz + √(1 - z²))
+     */
+    asin(): Complex;
+    /**
+     * Arc cosine: acos(z) = π/2 - asin(z)
+     */
+    acos(): Complex;
+    /**
+     * Arc tangent: atan(z) = (i/2)·ln((i + z)/(i - z))
+     */
+    atan(): Complex;
+    /**
+     * Inverse hyperbolic sine: asinh(z) = ln(z + √(z² + 1))
+     */
+    asinh(): Complex;
+    /**
+     * Inverse hyperbolic cosine: acosh(z) = ln(z + √(z-1)·√(z+1))
+     *
+     * The principal value has non-negative real part (C99 Annex G / DLMF 4.37 /
+     * NumPy convention). Using the factored `√(z-1)·√(z+1)` rather than `√(z²-1)`
+     * selects the correct Riemann sheet for Re(z) < 0 and on the real-axis branch
+     * cuts (z < 1), where `√(z²-1)` lands on the wrong branch — the previous form
+     * returned a negative real part (e.g. acosh(-1+0.5i)) and the wrong sign of π
+     * on z < -1.
+     */
+    acosh(): Complex;
+    /**
+     * Inverse hyperbolic tangent: atanh(z) = (1/2)·ln((1 + z)/(1 - z))
+     */
+    atanh(): Complex;
+    /**
+     * Check equality within tolerance
+     */
+    equals(other: Complex, epsilon?: number): boolean;
+    /**
+     * Check if this is a real number (im ≈ 0)
+     */
+    isReal(epsilon?: number): boolean;
+    /**
+     * Check if this is purely imaginary (re ≈ 0, im ≠ 0)
+     */
+    isImaginary(epsilon?: number): boolean;
+    /**
+     * Check if this is zero
+     */
+    isZero(epsilon?: number): boolean;
+    /**
+     * Check if this is NaN
+     */
+    isNaN(): boolean;
+    /**
+     * Check if this is infinite
+     */
+    isInfinite(): boolean;
+    /**
+     * Clone this complex number
+     */
+    clone(): Complex;
+    /**
+     * Round real and imaginary parts to specified decimals
+     */
+    round(decimals?: number): Complex;
+    /**
+     * Floor real and imaginary parts
+     */
+    floor(): Complex;
+    /**
+     * Ceil real and imaginary parts
+     */
+    ceil(): Complex;
+    /**
+     * Sign function: z / |z| (unit complex number in same direction)
+     */
+    sign(): Complex;
+}
+/**
+ * Imaginary unit constant: i = √(-1)
+ */
+export declare const I: Complex;
+/**
+ * Common constants
+ */
+export declare const COMPLEX_ZERO: Complex;
+export declare const COMPLEX_ONE: Complex;
+export declare const COMPLEX_NEG_ONE: Complex;
+//# sourceMappingURL=complex.d.ts.map

package/dist/types/complex.d.ts.map

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