mathjs 12.4.2 → 13.0.0

package/types/index.d.ts

@@ -11,7 +11,7 @@ export type NoLiteralType<T> = T extends number
       : T
 
 // TODO: introduce generics for MathCollection, MathMatrix, and MathArray
-export type MathNumericType = number | BigNumber | Fraction | Complex
+export type MathNumericType = number | BigNumber | bigint | Fraction | Complex
 export type MathScalarType = MathNumericType | Unit
 export type MathArray = MathNumericType[] | MathNumericType[][] // TODO: MathArray can also contain Unit
 export type MathCollection = MathArray | Matrix
@@ -544,7 +544,9 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Set configuration options for math.js, and get current options. Will
    * emit a ‘config’ event, with arguments (curr, prev, changes).
-   * @param options Available options: {number} epsilon Minimum relative
+   * @param options Available options: {number} relTol Minimum relative
+   * difference between two compared values, used by all comparison
+   * functions. {number} absTol Minimum absolute
    * difference between two compared values, used by all comparison
    * functions. {string} matrix A string ‘Matrix’ (default) or ‘Array’.
    * {string} number A string ‘number’ (default), ‘BigNumber’, or
@@ -585,10 +587,22 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns The created bignumber
    */
   bignumber(
-    x?: number | string | Fraction | BigNumber | Unit | boolean | null
+    x?: number | string | Fraction | BigNumber | bigint | Unit | boolean | null
   ): BigNumber
   bignumber<T extends MathCollection>(x: T): T
 
+  /**
+   * Create a bigint, which can store integers with arbitrary precision.
+   * When a matrix is provided, all elements will be converted to
+   * bigint.
+   * @param x Value for the integer, 0 by default.
+   * @returns The created bigint
+   */
+  bigint(
+    x?: number | string | Fraction | BigNumber | bigint | boolean | null
+  ): bigint
+  bigint<T extends MathCollection>(x: T): T
+
   /**
    * Create a boolean or convert a string or number to a boolean. In case
    * of a number, true is returned for non-zero numbers, and false in case
@@ -669,7 +683,14 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns Returns a fraction
    */
   fraction(
-    value: number | string | BigNumber | Unit | Fraction | FractionDefinition
+    value:
+      | number
+      | string
+      | BigNumber
+      | bigint
+      | Unit
+      | Fraction
+      | FractionDefinition
   ): Fraction
   fraction(values: MathCollection): MathCollection
   /**
@@ -718,7 +739,15 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns The created number
    */
   number(
-    value?: string | number | BigNumber | Fraction | boolean | Unit | null
+    value?:
+      | string
+      | number
+      | BigNumber
+      | bigint
+      | Fraction
+      | boolean
+      | Unit
+      | null
   ): number
   number(value?: MathCollection): number | MathCollection
   /**
@@ -729,6 +758,28 @@ export interface MathJsInstance extends MathJsFactory {
    */
   number(unit: Unit, valuelessUnit: Unit | string): number
 
+  /**
+   * Convert a numeric input to a specific numeric type: number, BigNumber, bigint, or Fraction.
+   * @param value The value to be converted
+   * @param outputType The desired numeric output type
+   */
+  numeric(
+    value: string | number | BigNumber | bigint | Fraction,
+    outputType: 'number'
+  ): number
+  numeric(
+    value: string | number | BigNumber | bigint | Fraction,
+    outputType: 'BigNumber'
+  ): BigNumber
+  numeric(
+    value: string | number | BigNumber | bigint | Fraction,
+    outputType: 'bigint'
+  ): bigint
+  numeric(
+    value: string | number | BigNumber | bigint | Fraction,
+    outputType: 'Fraction'
+  ): Fraction
+
   /**
    * Create a Sparse Matrix. The function creates a new math.type.Matrix
    * object from an Array. A Matrix has utility functions to manipulate
@@ -1263,9 +1314,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Divisor
    * @returns Returns the remainder of x divided by y
    */
-  mod<T extends number | BigNumber | Fraction | MathCollection>(
+  mod<T extends number | BigNumber | bigint | Fraction | MathCollection>(
     x: T,
-    y: number | BigNumber | Fraction | MathCollection
+    y: number | BigNumber | bigint | Fraction | MathCollection
   ): NoLiteralType<T>
 
   /**
@@ -1322,7 +1373,7 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y The exponent
    * @returns x to the power y
    */
-  pow(x: MathType, y: number | BigNumber | Complex): MathType
+  pow(x: MathType, y: number | BigNumber | bigint | Complex): MathType
 
   /**
    * Compute the sign of a value. The sign of a value x is: 1 when x > 1
@@ -1401,9 +1452,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Second value to and
    * @returns AND of x and y
    */
-  bitAnd<T extends number | BigNumber | MathCollection>(
+  bitAnd<T extends number | BigNumber | bigint | MathCollection>(
     x: T,
-    y: number | BigNumber | MathCollection
+    y: number | BigNumber | bigint | MathCollection
   ): NoLiteralType<T>
 
   /**
@@ -1413,7 +1464,7 @@ export interface MathJsInstance extends MathJsFactory {
    * @param x Value to not
    * @returns NOT of x
    */
-  bitNot<T extends number | BigNumber | MathCollection>(x: T): T
+  bitNot<T extends number | BigNumber | bigint | MathCollection>(x: T): T
 
   /**
    * Bitwise OR two values, x | y. For matrices, the function is evaluated
@@ -1423,7 +1474,7 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Second value to or
    * @returns OR of x and y
    */
-  bitOr<T extends number | BigNumber | MathCollection>(x: T, y: T): T
+  bitOr<T extends number | BigNumber | bigint | MathCollection>(x: T, y: T): T
 
   /**
    * Bitwise XOR two values, x ^ y. For matrices, the function is
@@ -1432,9 +1483,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Second value to xor
    * @returns XOR of x and y
    */
-  bitXor<T extends number | BigNumber | MathCollection>(
+  bitXor<T extends number | BigNumber | bigint | MathCollection>(
     x: T,
-    y: number | BigNumber | MathCollection
+    y: number | BigNumber | bigint | MathCollection
   ): NoLiteralType<T>
 
   /**
@@ -1445,9 +1496,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Amount of shifts
    * @returns x shifted left y times
    */
-  leftShift<T extends number | BigNumber | MathCollection>(
+  leftShift<T extends number | BigNumber | bigint | MathCollection>(
     x: T,
-    y: number | BigNumber
+    y: number | BigNumber | bigint
   ): NoLiteralType<T>
 
   /**
@@ -1458,9 +1509,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @param y Amount of shifts
    * @returns x sign-filled shifted right y times
    */
-  rightArithShift<T extends number | BigNumber | MathCollection>(
+  rightArithShift<T extends number | BigNumber | bigint | MathCollection>(
     x: T,
-    y: number | BigNumber
+    y: number | BigNumber | bigint
   ): NoLiteralType<T>
 
   /**
@@ -1631,8 +1682,8 @@ export interface MathJsInstance extends MathJsFactory {
    * nonzero/nonempty value.
    */
   and(
-    x: number | BigNumber | Complex | Unit | MathCollection,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    x: number | BigNumber | bigint | Complex | Unit | MathCollection,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): boolean | MathCollection
 
   /**
@@ -1642,7 +1693,7 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns Returns true when input is a zero or empty value.
    */
   not(
-    x: number | BigNumber | Complex | Unit | MathCollection
+    x: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): boolean | MathCollection
 
   /**
@@ -1655,8 +1706,8 @@ export interface MathJsInstance extends MathJsFactory {
    * nonzero/nonempty value.
    */
   or(
-    x: number | BigNumber | Complex | Unit | MathCollection,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    x: number | BigNumber | bigint | Complex | Unit | MathCollection,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): boolean | MathCollection
 
   /**
@@ -1669,8 +1720,8 @@ export interface MathJsInstance extends MathJsFactory {
    * nonzero/nonempty value.
    */
   xor(
-    x: number | BigNumber | Complex | Unit | MathCollection,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    x: number | BigNumber | bigint | Complex | Unit | MathCollection,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): boolean | MathCollection
 
   /*************************************************************************
@@ -2322,7 +2373,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x
    * == y. x and y are considered equal when the relative difference
-   * between x and y is smaller than the configured epsilon. The function
+   * between x and y is smaller than the configured relTol and absTol. The function
    * cannot be used to compare values smaller than approximately 2.22e-16.
    * For matrices, the function is evaluated element wise.
    * @param x First value to compare
@@ -2376,7 +2427,7 @@ export interface MathJsInstance extends MathJsFactory {
    * Test whether two values are equal.
    *
    * The function tests whether the relative difference between x and y is
-   * smaller than the configured epsilon. The function cannot be used to
+   * smaller than the configured relTol and absTol. The function cannot be used to
    * compare values smaller than approximately 2.22e-16. For matrices, the
    * function is evaluated element wise. In case of complex numbers, x.re
    * must equal y.re, and x.im must equal y.im. Values null and undefined
@@ -2404,7 +2455,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Test whether value x is larger than y. The function returns true when
    * x is larger than y and the relative difference between x and y is
-   * larger than the configured epsilon. The function cannot be used to
+   * larger than the configured relTol and absTol. The function cannot be used to
    * compare values smaller than approximately 2.22e-16. For matrices, the
    * function is evaluated element wise.
    * @param x First value to compare
@@ -2416,7 +2467,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Test whether value x is larger or equal to y. The function returns
    * true when x is larger than y or the relative difference between x and
-   * y is smaller than the configured epsilon. The function cannot be used
+   * y is smaller than the configured relTol and absTol. The function cannot be used
    * to compare values smaller than approximately 2.22e-16. For matrices,
    * the function is evaluated element wise.
    * @param x First value to compare
@@ -2429,7 +2480,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Test whether value x is smaller than y. The function returns true
    * when x is smaller than y and the relative difference between x and y
-   * is smaller than the configured epsilon. The function cannot be used
+   * is smaller than the configured relTol and absTol. The function cannot be used
    * to compare values smaller than approximately 2.22e-16. For matrices,
    * the function is evaluated element wise.
    * @param x First value to compare
@@ -2441,7 +2492,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Test whether value x is smaller or equal to y. The function returns
    * true when x is smaller than y or the relative difference between x
-   * and y is smaller than the configured epsilon. The function cannot be
+   * and y is smaller than the configured relTol and absTol. The function cannot be
    * used to compare values smaller than approximately 2.22e-16. For
    * matrices, the function is evaluated element wise.
    * @param x First value to compare
@@ -2472,7 +2523,7 @@ export interface MathJsInstance extends MathJsFactory {
   /**
    * Test whether two values are unequal. The function tests whether the
    * relative difference between x and y is larger than the configured
-   * epsilon. The function cannot be used to compare values smaller than
+   * relTol and absTol. The function cannot be used to compare values smaller than
    * approximately 2.22e-16. For matrices, the function is evaluated
    * element wise. In case of complex numbers, x.re must unequal y.re, or
    * x.im must unequal y.im. Values null and undefined are compared
@@ -2805,6 +2856,19 @@ export interface MathJsInstance extends MathJsFactory {
    */
   prod(A: MathCollection): MathScalarType
 
+  /**
+   * @param A A single matrix
+   * @param probOrN prob is the order of the quantile, while N is the
+   * amount of evenly distributed steps of probabilities; only one of
+   * these options can be provided
+   * @param sorted =false is data sorted in ascending order
+   * @returns Quantile(s)
+   */
+  quantileSeq<T extends MathScalarType>(
+    A: T[] | T[][],
+    prob: number | BigNumber | MathArray,
+    sorted?: boolean
+  ): T
   /**
    * Compute the prob order quantile of a matrix or a list with values.
    * The sequence is sorted and the middle value is returned. Supported
@@ -2823,7 +2887,7 @@ export interface MathJsInstance extends MathJsFactory {
     A: MathCollection,
     prob: number | BigNumber | MathArray,
     sorted?: boolean
-  ): number | BigNumber | Unit | MathArray
+  ): MathScalarType | MathArray
 
   /**
    * Compute the standard deviation of a matrix or a list with values. The
@@ -3277,6 +3341,8 @@ export interface MathJsInstance extends MathJsFactory {
 
   isBigNumber(x: unknown): x is BigNumber
 
+  isBigInt(x: unknown): x is bigint
+
   isComplex(x: unknown): x is Complex
 
   isFraction(x: unknown): x is Fraction
@@ -3368,7 +3434,7 @@ export interface MathJsInstance extends MathJsFactory {
    * Test whether a value is an numeric value. In case of a string,
    *  true is returned if the string contains a numeric value.
    * @param x Value to be tested
-   * @returns Returns true when x is a number, BigNumber, Fraction, Boolean, or a String containing number.
+   * @returns Returns true when x is a number, BigNumber, bigint, Fraction, Boolean, or a String containing number.
    * Returns false for other types.
    * Throws an error in case of unknown types.
    */
@@ -3393,7 +3459,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns Returns true when x is NaN. Throws an error in case of an
    * unknown data type.
    */
-  isNaN(x: number | BigNumber | Fraction | MathCollection | Unit): boolean
+  isNaN(
+    x: number | BigNumber | bigint | Fraction | MathCollection | Unit
+  ): boolean
 
   /**
    * Test whether a value is negative: smaller than zero. The function
@@ -3403,18 +3471,20 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns Returns true when x is larger than zero. Throws an error in
    * case of an unknown data type.
    */
-  isNegative(x: number | BigNumber | Fraction | MathCollection | Unit): boolean
+  isNegative(
+    x: number | BigNumber | bigint | Fraction | MathCollection | Unit
+  ): boolean
 
   /**
    * Test whether a value is an numeric value. The function is evaluated
    * element-wise in case of Array or Matrix input.
    * @param x Value to be tested
-   * @returns Returns true when x is a number, BigNumber, Fraction, or
+   * @returns Returns true when x is a number, BigNumber, bigint, Fraction, or
    * boolean. Returns false for other types. Throws an error in case of
    * unknown types.
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  isNumeric(x: any): x is number | BigNumber | Fraction | boolean
+  isNumeric(x: any): x is number | BigNumber | bigint | Fraction | boolean
 
   /**
    * Test whether a value is positive: larger than zero. The function
@@ -3424,7 +3494,9 @@ export interface MathJsInstance extends MathJsFactory {
    * @returns Returns true when x is larger than zero. Throws an error in
    * case of an unknown data type.
    */
-  isPositive(x: number | BigNumber | Fraction | MathCollection | Unit): boolean
+  isPositive(
+    x: number | BigNumber | bigint | Fraction | MathCollection | Unit
+  ): boolean
 
   /**
    * Test whether a value is prime: has no divisors other than itself and
@@ -4296,9 +4368,15 @@ export interface Help {
 }
 
 export interface ConfigOptions {
+  relTol?: number
+  absTol?: number
+  /**
+   * @deprecated Use `relTol` and `absTol` instead
+   */
   epsilon?: number
   matrix?: 'Matrix' | 'Array'
-  number?: 'number' | 'BigNumber' | 'Fraction'
+  number?: 'number' | 'BigNumber' | 'bigint' | 'Fraction'
+  numberFallback?: 'number' | 'BigNumber'
   precision?: number
   predictable?: boolean
   randomSeed?: string | null
@@ -4319,11 +4397,22 @@ export interface MathJsChain<TValue> {
    */
   bignumber(
     this: MathJsChain<
-      number | string | Fraction | BigNumber | Unit | boolean | null
+      number | string | Fraction | BigNumber | bigint | Unit | boolean | null
     >
   ): MathJsChain<BigNumber>
   bignumber<T extends MathCollection>(this: MathJsChain<T>): MathJsChain<T>
 
+  /**
+   * Create a bigint, which can store integers with arbitrary precision.
+   * When a matrix is provided, all elements will be converted to bigint.
+   */
+  bigint(
+    this: MathJsChain<
+      number | string | Fraction | BigNumber | bigint | boolean | null
+    >
+  ): MathJsChain<bigint>
+  bigint<T extends MathCollection>(this: MathJsChain<T>): MathJsChain<T>
+
   /**
    * Create a boolean or convert a string or number to a boolean. In case
    * of a number, true is returned for non-zero numbers, and false in case
@@ -4385,7 +4474,13 @@ export interface MathJsChain<TValue> {
    */
   fraction(
     this: MathJsChain<
-      number | string | BigNumber | Unit | Fraction | FractionDefinition
+      | number
+      | string
+      | BigNumber
+      | bigint
+      | Unit
+      | Fraction
+      | FractionDefinition
     >,
     denominator?: number
   ): MathJsChain<Fraction>
@@ -4419,7 +4514,7 @@ export interface MathJsChain<TValue> {
    */
   number(
     this: MathJsChain<
-      string | number | BigNumber | Fraction | boolean | Unit | null
+      string | number | BigNumber | bigint | Fraction | boolean | Unit | null
     >,
     valuelessUnit?: Unit | string
   ): MathJsChain<number>
@@ -4428,6 +4523,27 @@ export interface MathJsChain<TValue> {
     valuelessUnit?: Unit | string
   ): MathJsChain<MathCollection>
 
+  /**
+   * Convert a numeric input to a specific numeric type: number, BigNumber, bigint, or Fraction.
+   * @param outputType The desired numeric output type
+   */
+  numeric(
+    this: MathJsChain<string | number | BigNumber | bigint | Fraction>,
+    outputType: 'number'
+  ): MathJsChain<number>
+  numeric(
+    this: MathJsChain<string | number | BigNumber | bigint | Fraction>,
+    outputType: 'BigNumber'
+  ): MathJsChain<BigNumber>
+  numeric(
+    this: MathJsChain<string | number | BigNumber | bigint | Fraction>,
+    outputType: 'bigint'
+  ): MathJsChain<bigint>
+  numeric(
+    this: MathJsChain<string | number | BigNumber | bigint | Fraction>,
+    outputType: 'Fraction'
+  ): MathJsChain<Fraction>
+
   /**
    * Create a Sparse Matrix. The function creates a new math.type.Matrix
    * object from an Array. A Matrix has utility functions to manipulate
@@ -4949,9 +5065,9 @@ export interface MathJsChain<TValue> {
    * @see http://en.wikipedia.org/wiki/Modulo_operation.
    * @param y Divisor
    */
-  mod<T extends number | BigNumber | Fraction | MathCollection>(
+  mod<T extends number | BigNumber | bigint | Fraction | MathCollection>(
     this: MathJsChain<T>,
-    y: number | BigNumber | Fraction | MathCollection
+    y: number | BigNumber | bigint | Fraction | MathCollection
   ): MathJsChain<NoLiteralType<T>>
 
   /**
@@ -4997,7 +5113,7 @@ export interface MathJsChain<TValue> {
    */
   pow(
     this: MathJsChain<MathType>,
-    y: number | BigNumber | Complex
+    y: number | BigNumber | bigint | Complex
   ): MathJsChain<MathType>
 
   /**
@@ -5083,9 +5199,9 @@ export interface MathJsChain<TValue> {
    * evaluated element wise.
    * @param y Second value to and
    */
-  bitAnd<T extends number | BigNumber | MathCollection>(
+  bitAnd<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>,
-    y: number | BigNumber | MathCollection
+    y: number | BigNumber | bigint | MathCollection
   ): MathJsChain<NoLiteralType<T>>
 
   /**
@@ -5094,7 +5210,7 @@ export interface MathJsChain<TValue> {
    * base.
    */
 
-  bitNot<T extends number | BigNumber | MathCollection>(
+  bitNot<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>
   ): MathJsChain<T>
 
@@ -5104,7 +5220,7 @@ export interface MathJsChain<TValue> {
    * print base.
    * @param y Second value to or
    */
-  bitOr<T extends number | BigNumber | MathCollection>(
+  bitOr<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>,
     y: T
   ): MathJsChain<T>
@@ -5114,9 +5230,9 @@ export interface MathJsChain<TValue> {
    * evaluated element wise.
    * @param y Second value to xor
    */
-  bitXor<T extends number | BigNumber | MathCollection>(
+  bitXor<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>,
-    y: number | BigNumber | MathCollection
+    y: number | BigNumber | bigint | MathCollection
   ): MathJsChain<NoLiteralType<T>>
 
   /**
@@ -5125,9 +5241,9 @@ export interface MathJsChain<TValue> {
    * function is evaluated on the best prefix base.
    * @param y Amount of shifts
    */
-  leftShift<T extends number | BigNumber | MathCollection>(
+  leftShift<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>,
-    y: number | BigNumber
+    y: number | BigNumber | bigint
   ): MathJsChain<NoLiteralType<T>>
 
   /**
@@ -5136,9 +5252,9 @@ export interface MathJsChain<TValue> {
    * the function is evaluated on the best prefix base.
    * @param y Amount of shifts
    */
-  rightArithShift<T extends number | BigNumber | MathCollection>(
+  rightArithShift<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>,
-    y: number | BigNumber
+    y: number | BigNumber | bigint
   ): MathJsChain<NoLiteralType<T>>
 
   /**
@@ -5290,8 +5406,10 @@ export interface MathJsChain<TValue> {
    * @param y Second value to and
    */
   and(
-    this: MathJsChain<number | BigNumber | Complex | Unit | MathCollection>,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    this: MathJsChain<
+      number | BigNumber | bigint | Complex | Unit | MathCollection
+    >,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): MathJsChain<boolean | MathCollection>
 
   /**
@@ -5299,7 +5417,9 @@ export interface MathJsChain<TValue> {
    * the function is evaluated element wise.
    */
   not(
-    this: MathJsChain<number | BigNumber | Complex | Unit | MathCollection>
+    this: MathJsChain<
+      number | BigNumber | bigint | Complex | Unit | MathCollection
+    >
   ): MathJsChain<boolean | MathCollection>
 
   /**
@@ -5309,8 +5429,10 @@ export interface MathJsChain<TValue> {
    * @param y Second value to or
    */
   or(
-    this: MathJsChain<number | BigNumber | Complex | Unit | MathCollection>,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    this: MathJsChain<
+      number | BigNumber | bigint | Complex | Unit | MathCollection
+    >,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): MathJsChain<boolean | MathCollection>
 
   /**
@@ -5320,8 +5442,10 @@ export interface MathJsChain<TValue> {
    * @param y Second value to xor
    */
   xor(
-    this: MathJsChain<number | BigNumber | Complex | Unit | MathCollection>,
-    y: number | BigNumber | Complex | Unit | MathCollection
+    this: MathJsChain<
+      number | BigNumber | bigint | Complex | Unit | MathCollection
+    >,
+    y: number | BigNumber | bigint | Complex | Unit | MathCollection
   ): MathJsChain<boolean | MathCollection>
 
   /*************************************************************************
@@ -5767,7 +5891,7 @@ export interface MathJsChain<TValue> {
   /**
    * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x
    * == y. x and y are considered equal when the relative difference
-   * between x and y is smaller than the configured epsilon. The function
+   * between x and y is smaller than the configured relTol and absTol. The function
    * cannot be used to compare values smaller than approximately 2.22e-16.
    * For matrices, the function is evaluated element wise.
    * @param y Second value to compare
@@ -5809,7 +5933,7 @@ export interface MathJsChain<TValue> {
    * Test whether two values are equal.
    *
    * The function tests whether the relative difference between x and y is
-   * smaller than the configured epsilon. The function cannot be used to
+   * smaller than the configured relTol and absTol. The function cannot be used to
    * compare values smaller than approximately 2.22e-16. For matrices, the
    * function is evaluated element wise. In case of complex numbers, x.re
    * must equal y.re, and x.im must equal y.im. Values null and undefined
@@ -5835,7 +5959,7 @@ export interface MathJsChain<TValue> {
   /**
    * Test whether value x is larger than y. The function returns true when
    * x is larger than y and the relative difference between x and y is
-   * larger than the configured epsilon. The function cannot be used to
+   * larger than the configured relTol and absTol. The function cannot be used to
    * compare values smaller than approximately 2.22e-16. For matrices, the
    * function is evaluated element wise.
    * @param y Second value to compare
@@ -5848,7 +5972,7 @@ export interface MathJsChain<TValue> {
   /**
    * Test whether value x is larger or equal to y. The function returns
    * true when x is larger than y or the relative difference between x and
-   * y is smaller than the configured epsilon. The function cannot be used
+   * y is smaller than the configured relTol and absTol. The function cannot be used
    * to compare values smaller than approximately 2.22e-16. For matrices,
    * the function is evaluated element wise.
    * @param y Second value to vcompare
@@ -5861,7 +5985,7 @@ export interface MathJsChain<TValue> {
   /**
    * Test whether value x is smaller than y. The function returns true
    * when x is smaller than y and the relative difference between x and y
-   * is smaller than the configured epsilon. The function cannot be used
+   * is smaller than the configured relTol and absTol. The function cannot be used
    * to compare values smaller than approximately 2.22e-16. For matrices,
    * the function is evaluated element wise.
    * @param y Second value to vcompare
@@ -5874,7 +5998,7 @@ export interface MathJsChain<TValue> {
   /**
    * Test whether value x is smaller or equal to y. The function returns
    * true when x is smaller than y or the relative difference between x
-   * and y is smaller than the configured epsilon. The function cannot be
+   * and y is smaller than the configured relTol and absTol. The function cannot be
    * used to compare values smaller than approximately 2.22e-16. For
    * matrices, the function is evaluated element wise.
    * @param y Second value to compare
@@ -5902,7 +6026,7 @@ export interface MathJsChain<TValue> {
   /**
    * Test whether two values are unequal. The function tests whether the
    * relative difference between x and y is larger than the configured
-   * epsilon. The function cannot be used to compare values smaller than
+   * relTol and absTol. The function cannot be used to compare values smaller than
    * approximately 2.22e-16. For matrices, the function is evaluated
    * element wise. In case of complex numbers, x.re must unequal y.re, or
    * x.im must unequal y.im. Values null and undefined are compared
@@ -6571,7 +6695,7 @@ export interface MathJsChain<TValue> {
    */
 
   isInteger(
-    this: MathJsChain<number | BigNumber | Fraction | MathCollection>
+    this: MathJsChain<number | BigNumber | bigint | Fraction | MathCollection>
   ): MathJsChain<boolean>
 
   /**
@@ -6595,7 +6719,7 @@ export interface MathJsChain<TValue> {
   ): MathJsChain<boolean>
 
   /**
-   * Test whether a value is an numeric value. The function is evaluated
+   * Test whether a value is a numeric value. The function is evaluated
    * element-wise in case of Array or Matrix input.
    */
 
@@ -6609,7 +6733,9 @@ export interface MathJsChain<TValue> {
    */
 
   isPositive(
-    this: MathJsChain<number | BigNumber | Fraction | MathCollection | Unit>
+    this: MathJsChain<
+      number | BigNumber | bigint | Fraction | MathCollection | Unit
+    >
   ): MathJsChain<boolean>
 
   /**
@@ -6619,7 +6745,7 @@ export interface MathJsChain<TValue> {
    */
 
   isPrime(
-    this: MathJsChain<number | BigNumber | MathCollection>
+    this: MathJsChain<number | BigNumber | bigint | MathCollection>
   ): MathJsChain<boolean>
 
   /**