mathjs 12.4.3 → 13.0.1

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
@@ -3290,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
@@ -3381,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.
    */
@@ -3406,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
@@ -3416,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
@@ -3437,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
@@ -4233,14 +4292,44 @@ export interface MathNode {
 }
 
 export interface Parser {
+  /**
+   * Evaluate an expression. Returns the result of the expression.
+   * @param expr The expression to evaluate
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   evaluate(expr: string | string[]): any
+  /**
+   * Retrieve a variable or function from the parser’s scope.
+   * @param name The name of the variable or function to be retrieved
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  get(variable: string): any
+  get(name: string): any
+  /**
+   * Retrieve an object with all defined variables in the parser’s scope.
+   * @returns An object with all defined variables
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   getAll(): { [key: string]: any }
+  /**
+   * Retrieve a map with all defined variables in the parser’s scope.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  getAllAsMap(): Map<string, any>
+  /**
+   * Set a variable or function in the parser’s scope.
+   * @param name The name of the variable or function to be set
+   * @param value The value of the variable or function to be set
+   */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  set: (variable: string, value: any) => void
+  set: (name: string, value: any) => void
+  /**
+   * Remove a variable or function from the parser’s scope.
+   * @param name The name of the variable or function to be removed
+   */
+  remove: (name: string) => void
+  /**
+   * Completely clear the parser’s scope.
+   */
   clear: () => void
 }
 
@@ -4309,9 +4398,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
@@ -4332,11 +4427,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
@@ -4398,7 +4504,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>
@@ -4432,7 +4544,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>
@@ -4441,6 +4553,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
@@ -4962,9 +5095,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>>
 
   /**
@@ -5010,7 +5143,7 @@ export interface MathJsChain<TValue> {
    */
   pow(
     this: MathJsChain<MathType>,
-    y: number | BigNumber | Complex
+    y: number | BigNumber | bigint | Complex
   ): MathJsChain<MathType>
 
   /**
@@ -5096,9 +5229,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>>
 
   /**
@@ -5107,7 +5240,7 @@ export interface MathJsChain<TValue> {
    * base.
    */
 
-  bitNot<T extends number | BigNumber | MathCollection>(
+  bitNot<T extends number | BigNumber | bigint | MathCollection>(
     this: MathJsChain<T>
   ): MathJsChain<T>
 
@@ -5117,7 +5250,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>
@@ -5127,9 +5260,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>>
 
   /**
@@ -5138,9 +5271,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>>
 
   /**
@@ -5149,9 +5282,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>>
 
   /**
@@ -5303,8 +5436,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>
 
   /**
@@ -5312,7 +5447,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>
 
   /**
@@ -5322,8 +5459,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>
 
   /**
@@ -5333,8 +5472,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>
 
   /*************************************************************************
@@ -5780,7 +5921,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
@@ -5822,7 +5963,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
@@ -5848,7 +5989,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
@@ -5861,7 +6002,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
@@ -5874,7 +6015,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
@@ -5887,7 +6028,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
@@ -5915,7 +6056,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
@@ -6584,7 +6725,7 @@ export interface MathJsChain<TValue> {
    */
 
   isInteger(
-    this: MathJsChain<number | BigNumber | Fraction | MathCollection>
+    this: MathJsChain<number | BigNumber | bigint | Fraction | MathCollection>
   ): MathJsChain<boolean>
 
   /**
@@ -6608,7 +6749,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.
    */
 
@@ -6622,7 +6763,9 @@ export interface MathJsChain<TValue> {
    */
 
   isPositive(
-    this: MathJsChain<number | BigNumber | Fraction | MathCollection | Unit>
+    this: MathJsChain<
+      number | BigNumber | bigint | Fraction | MathCollection | Unit
+    >
   ): MathJsChain<boolean>
 
   /**
@@ -6632,7 +6775,7 @@ export interface MathJsChain<TValue> {
    */
 
   isPrime(
-    this: MathJsChain<number | BigNumber | MathCollection>
+    this: MathJsChain<number | BigNumber | bigint | MathCollection>
   ): MathJsChain<boolean>
 
   /**