mathjs 12.2.1 → 12.3.1

package/lib/esm/type/unit/Unit.js

@@ -731,7 +731,7 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
   Unit.prototype.abs = function () {
     var ret = this.clone();
     if (ret.value !== null) {
-      if (ret._isDerived() || ret.units[0].unit.offset === 0) {
+      if (ret._isDerived() || ret.units.length === 0 || ret.units[0].unit.offset === 0) {
         ret.value = abs(ret.value);
       } else {
         // To give the correct, but unexpected, results for units with an offset.
@@ -774,7 +774,7 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
     if (other.value !== null) {
       throw new Error('Cannot convert to a unit with a value');
     }
-    if (this.value === null || this._isDerived() || this.units[0].unit.offset === other.units[0].unit.offset) {
+    if (this.value === null || this._isDerived() || this.units.length === 0 || other.units.length === 0 || this.units[0].unit.offset === other.units[0].unit.offset) {
       other.value = clone(value);
     } else {
       /* Need to adjust value by difference in offset to convert */
@@ -962,6 +962,10 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
     ret.units = proposedUnitList;
     ret.fixPrefix = true;
     ret.skipAutomaticSimplification = true;
+    if (this.value !== null) {
+      ret.value = null;
+      return this.to(ret);
+    }
     return ret;
   };
 
@@ -1242,6 +1246,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         value: 1e24,
         scientific: true
       },
+      R: {
+        name: 'R',
+        value: 1e27,
+        scientific: true
+      },
+      Q: {
+        name: 'Q',
+        value: 1e30,
+        scientific: true
+      },
       d: {
         name: 'd',
         value: 1e-1,
@@ -1291,6 +1305,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         name: 'y',
         value: 1e-24,
         scientific: true
+      },
+      r: {
+        name: 'r',
+        value: 1e-27,
+        scientific: true
+      },
+      q: {
+        name: 'q',
+        value: 1e-30,
+        scientific: true
       }
     },
     LONG: {
@@ -1349,6 +1373,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         value: 1e24,
         scientific: true
       },
+      ronna: {
+        name: 'ronna',
+        value: 1e27,
+        scientific: true
+      },
+      quetta: {
+        name: 'quetta',
+        value: 1e30,
+        scientific: true
+      },
       deci: {
         name: 'deci',
         value: 1e-1,
@@ -1398,6 +1432,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         name: 'yocto',
         value: 1e-24,
         scientific: true
+      },
+      ronto: {
+        name: 'ronto',
+        value: 1e-27,
+        scientific: true
+      },
+      quecto: {
+        name: 'quecto',
+        value: 1e-30,
+        scientific: true
       }
     },
     SQUARED: {
@@ -1456,6 +1500,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         value: 1e48,
         scientific: true
       },
+      R: {
+        name: 'R',
+        value: 1e54,
+        scientific: true
+      },
+      Q: {
+        name: 'Q',
+        value: 1e60,
+        scientific: true
+      },
       d: {
         name: 'd',
         value: 1e-2,
@@ -1505,6 +1559,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         name: 'y',
         value: 1e-48,
         scientific: true
+      },
+      r: {
+        name: 'r',
+        value: 1e-54,
+        scientific: true
+      },
+      q: {
+        name: 'q',
+        value: 1e-60,
+        scientific: true
       }
     },
     CUBIC: {
@@ -1563,6 +1627,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         value: 1e72,
         scientific: true
       },
+      R: {
+        name: 'R',
+        value: 1e81,
+        scientific: true
+      },
+      Q: {
+        name: 'Q',
+        value: 1e90,
+        scientific: true
+      },
       d: {
         name: 'd',
         value: 1e-3,
@@ -1612,6 +1686,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         name: 'y',
         value: 1e-72,
         scientific: true
+      },
+      r: {
+        name: 'r',
+        value: 1e-81,
+        scientific: true
+      },
+      q: {
+        name: 'q',
+        value: 1e-90,
+        scientific: true
       }
     },
     BINARY_SHORT_SI: {

package/lib/esm/type/unit/physicalConstants.js

@@ -44,7 +44,7 @@ export var createAvogadro = /* #__PURE__ */unitFactory('avogadro', '6.02214076e2
 export var createBoltzmann = /* #__PURE__ */unitFactory('boltzmann', '1.380649e-23', 'J K^-1');
 export var createFaraday = /* #__PURE__ */unitFactory('faraday', '96485.33212331001', 'C mol^-1');
 export var createFirstRadiation = /* #__PURE__ */unitFactory('firstRadiation', '3.7417718521927573e-16', 'W m^2');
-// export const createSpectralRadiance = /* #__PURE__ */ unitFactory('spectralRadiance', '1.1910429723971881e-16', 'W m^2 sr^-1') // TODO spectralRadiance
+// TODO spectralRadiance = 1.1910429723971881e-16 W m^2 sr^-1
 export var createLoschmidt = /* #__PURE__ */unitFactory('loschmidt', '2.686780111798444e25', 'm^-3');
 export var createGasConstant = /* #__PURE__ */unitFactory('gasConstant', '8.31446261815324', 'J K^-1 mol^-1');
 export var createMolarPlanckConstant = /* #__PURE__ */unitFactory('molarPlanckConstant', '3.990312712893431e-10', 'J s mol^-1');

package/lib/esm/utils/bignumber/formatter.js

@@ -1,4 +1,5 @@
-import { isInteger } from '../number.js';
+import { isBigNumber, isNumber } from '../is.js';
+import { isInteger, normalizeFormatOptions } from '../number.js';
 
 /**
  * Formats a BigNumber in a given base
@@ -119,7 +120,7 @@ function formatBigNumberToBase(n, base, size) {
  *    format(12400,  {notation: 'engineering'})          // returns '12.400e+3'
  *
  * @param {BigNumber} value
- * @param {Object | Function | number} [options]
+ * @param {Object | Function | number | BigNumber} [options]
  * @return {string} str The formatted value
  */
 export function format(value, options) {
@@ -132,30 +133,11 @@ export function format(value, options) {
   if (!value.isFinite()) {
     return value.isNaN() ? 'NaN' : value.gt(0) ? 'Infinity' : '-Infinity';
   }
-
-  // default values for options
-  var notation = 'auto';
-  var precision;
-  var wordSize;
-  if (options !== undefined) {
-    // determine notation from options
-    if (options.notation) {
-      notation = options.notation;
-    }
-
-    // determine precision from options
-    if (typeof options === 'number') {
-      precision = options;
-    } else if (options.precision !== undefined) {
-      precision = options.precision;
-    }
-    if (options.wordSize) {
-      wordSize = options.wordSize;
-      if (typeof wordSize !== 'number') {
-        throw new Error('Option "wordSize" must be a number');
-      }
-    }
-  }
+  var {
+    notation,
+    precision,
+    wordSize
+  } = normalizeFormatOptions(options);
 
   // handle the various notations
   switch (notation) {
@@ -175,8 +157,8 @@ export function format(value, options) {
       {
         // determine lower and upper bound for exponential notation.
         // TODO: implement support for upper and lower to be BigNumbers themselves
-        var lowerExp = options && options.lowerExp !== undefined ? options.lowerExp : -3;
-        var upperExp = options && options.upperExp !== undefined ? options.upperExp : 5;
+        var lowerExp = _toNumberOrDefault(options === null || options === void 0 ? void 0 : options.lowerExp, -3);
+        var upperExp = _toNumberOrDefault(options === null || options === void 0 ? void 0 : options.upperExp, 5);
 
         // handle special case zero
         if (value.isZero()) return '0';
@@ -249,4 +231,13 @@ export function toExponential(value, precision) {
  */
 export function toFixed(value, precision) {
   return value.toFixed(precision);
+}
+function _toNumberOrDefault(value, defaultValue) {
+  if (isNumber(value)) {
+    return value;
+  } else if (isBigNumber(value)) {
+    return value.toNumber();
+  } else {
+    return defaultValue;
+  }
 }

package/lib/esm/utils/number.js

@@ -1,4 +1,4 @@
-import { isNumber } from './is.js';
+import { isBigNumber, isNumber, isObject } from './is.js';
 
 /**
  * @typedef {{sign: '+' | '-' | '', coefficients: number[], exponent: number}} SplitValue
@@ -21,7 +21,7 @@ export function isInteger(value) {
  * @param {number} x
  * @returns {number}
  */
-export var sign = /* #__PURE__ */Math.sign || function (x) {
+export var sign = Math.sign || function (x) {
   if (x > 0) {
     return 1;
   } else if (x < 0) {
@@ -36,7 +36,7 @@ export var sign = /* #__PURE__ */Math.sign || function (x) {
  * @param {number} x
  * @returns {number}
  */
-export var log2 = /* #__PURE__ */Math.log2 || function log2(x) {
+export var log2 = Math.log2 || function log2(x) {
   return Math.log(x) / Math.LN2;
 };
 
@@ -45,7 +45,7 @@ export var log2 = /* #__PURE__ */Math.log2 || function log2(x) {
  * @param {number} x
  * @returns {number}
  */
-export var log10 = /* #__PURE__ */Math.log10 || function log10(x) {
+export var log10 = Math.log10 || function log10(x) {
   return Math.log(x) / Math.LN10;
 };
 
@@ -54,7 +54,7 @@ export var log10 = /* #__PURE__ */Math.log10 || function log10(x) {
  * @param {number} x
  * @returns {number}
  */
-export var log1p = /* #__PURE__ */Math.log1p || function (x) {
+export var log1p = Math.log1p || function (x) {
   return Math.log(x + 1);
 };
 
@@ -67,7 +67,7 @@ export var log1p = /* #__PURE__ */Math.log1p || function (x) {
  * @param {number} x
  * @returns {number} Returns the cubic root of x
  */
-export var cbrt = /* #__PURE__ */Math.cbrt || function cbrt(x) {
+export var cbrt = Math.cbrt || function cbrt(x) {
   if (x === 0) {
     return x;
   }
@@ -91,7 +91,7 @@ export var cbrt = /* #__PURE__ */Math.cbrt || function cbrt(x) {
  * @param {number} x
  * @return {number} res
  */
-export var expm1 = /* #__PURE__ */Math.expm1 || function expm1(x) {
+export var expm1 = Math.expm1 || function expm1(x) {
   return x >= 2e-4 || x <= -2e-4 ? Math.exp(x) - 1 : x + x * x / 2 + x * x * x / 6;
 };
 
@@ -234,30 +234,11 @@ export function format(value, options) {
   } else if (isNaN(value)) {
     return 'NaN';
   }
-
-  // default values for options
-  var notation = 'auto';
-  var precision;
-  var wordSize;
-  if (options) {
-    // determine notation from options
-    if (options.notation) {
-      notation = options.notation;
-    }
-
-    // determine precision from options
-    if (isNumber(options)) {
-      precision = options;
-    } else if (isNumber(options.precision)) {
-      precision = options.precision;
-    }
-    if (options.wordSize) {
-      wordSize = options.wordSize;
-      if (typeof wordSize !== 'number') {
-        throw new Error('Option "wordSize" must be a number');
-      }
-    }
-  }
+  var {
+    notation,
+    precision,
+    wordSize
+  } = normalizeFormatOptions(options);
 
   // handle the various notations
   switch (notation) {
@@ -275,7 +256,7 @@ export function format(value, options) {
       return formatNumberToBase(value, 16, wordSize);
     case 'auto':
       // remove trailing zeros after the decimal point
-      return toPrecision(value, precision, options && options).replace(/((\.\d*?)(0+))($|e)/, function () {
+      return toPrecision(value, precision, options).replace(/((\.\d*?)(0+))($|e)/, function () {
         var digits = arguments[2];
         var e = arguments[4];
         return digits !== '.' ? digits + e : e;
@@ -285,6 +266,49 @@ export function format(value, options) {
   }
 }
 
+/**
+ * Normalize format options into an object:
+ *   {
+ *     notation: string,
+ *     precision: number | undefined,
+ *     wordSize: number | undefined
+ *   }
+ */
+export function normalizeFormatOptions(options) {
+  // default values for options
+  var notation = 'auto';
+  var precision;
+  var wordSize;
+  if (options !== undefined) {
+    if (isNumber(options)) {
+      precision = options;
+    } else if (isBigNumber(options)) {
+      precision = options.toNumber();
+    } else if (isObject(options)) {
+      if (options.precision !== undefined) {
+        precision = _toNumberOrThrow(options.precision, () => {
+          throw new Error('Option "precision" must be a number or BigNumber');
+        });
+      }
+      if (options.wordSize !== undefined) {
+        wordSize = _toNumberOrThrow(options.wordSize, () => {
+          throw new Error('Option "wordSize" must be a number or BigNumber');
+        });
+      }
+      if (options.notation) {
+        notation = options.notation;
+      }
+    } else {
+      throw new Error('Unsupported type of options, number, BigNumber, or object expected');
+    }
+  }
+  return {
+    notation,
+    precision,
+    wordSize
+  };
+}
+
 /**
  * Split a number into sign, coefficients, and exponent
  * @param {number | string} value
@@ -448,8 +472,8 @@ export function toPrecision(value, precision, options) {
   }
 
   // determine lower and upper bound for exponential notation.
-  var lowerExp = options && options.lowerExp !== undefined ? options.lowerExp : -3;
-  var upperExp = options && options.upperExp !== undefined ? options.upperExp : 5;
+  var lowerExp = _toNumberOrDefault(options === null || options === void 0 ? void 0 : options.lowerExp, -3);
+  var upperExp = _toNumberOrDefault(options === null || options === void 0 ? void 0 : options.upperExp, 5);
   var split = splitNumber(value);
   var rounded = precision ? roundDigits(split, precision) : split;
   if (rounded.exponent < lowerExp || rounded.exponent >= upperExp) {
@@ -654,4 +678,22 @@ export function copysign(x, y) {
   var signx = x > 0 ? true : x < 0 ? false : 1 / x === Infinity;
   var signy = y > 0 ? true : y < 0 ? false : 1 / y === Infinity;
   return signx ^ signy ? -x : x;
+}
+function _toNumberOrThrow(value, onError) {
+  if (isNumber(value)) {
+    return value;
+  } else if (isBigNumber(value)) {
+    return value.toNumber();
+  } else {
+    onError();
+  }
+}
+function _toNumberOrDefault(value, defaultValue) {
+  if (isNumber(value)) {
+    return value;
+  } else if (isBigNumber(value)) {
+    return value.toNumber();
+  } else {
+    return defaultValue;
+  }
 }

package/lib/esm/version.js

@@ -1,3 +1,3 @@
-export var version = '12.2.1';
+export var version = '12.3.1';
 // Note: This file is automatically generated when building math.js.
 // Changes made in this file will be overwritten.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mathjs",
-  "version": "12.2.1",
+  "version": "12.3.1",
   "description": "Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser with support for symbolic computation, comes with a large set of built-in functions and constants, and offers an integrated solution to work with different data types like numbers, big numbers, complex numbers, fractions, units, and matrices.",
   "author": "Jos de Jong <wjosdejong@gmail.com> (https://github.com/josdejong)",
   "homepage": "https://mathjs.org",
@@ -25,7 +25,7 @@
     "unit"
   ],
   "dependencies": {
-    "@babel/runtime": "^7.23.6",
+    "@babel/runtime": "^7.23.9",
     "complex.js": "^2.1.1",
     "decimal.js": "^10.4.3",
     "escape-latex": "^1.2.0",
@@ -36,21 +36,21 @@
     "typed-function": "^4.1.1"
   },
   "devDependencies": {
-    "@babel/core": "7.23.6",
+    "@babel/core": "7.23.9",
     "@babel/plugin-transform-object-assign": "7.23.3",
-    "@babel/plugin-transform-runtime": "7.23.6",
-    "@babel/preset-env": "7.23.6",
-    "@babel/register": "7.22.15",
+    "@babel/plugin-transform-runtime": "7.23.9",
+    "@babel/preset-env": "7.23.9",
+    "@babel/register": "7.23.7",
     "@types/assert": "1.5.10",
     "@types/mocha": "10.0.6",
-    "@typescript-eslint/eslint-plugin": "6.15.0",
-    "@typescript-eslint/parser": "6.15.0",
+    "@typescript-eslint/eslint-plugin": "6.20.0",
+    "@typescript-eslint/parser": "6.20.0",
     "assert": "2.1.0",
     "babel-loader": "9.1.3",
     "benchmark": "2.1.4",
-    "c8": "8.0.1",
+    "c8": "9.1.0",
     "codecov": "3.8.3",
-    "core-js": "3.34.0",
+    "core-js": "3.35.1",
     "del": "6.1.1",
     "dtslint": "4.2.1",
     "eslint": "8.56.0",
@@ -58,8 +58,8 @@
     "eslint-config-standard": "17.1.0",
     "eslint-plugin-import": "2.29.1",
     "eslint-plugin-mocha": "10.2.0",
-    "eslint-plugin-n": "16.5.0",
-    "eslint-plugin-prettier": "5.1.0",
+    "eslint-plugin-n": "16.6.2",
+    "eslint-plugin-prettier": "5.1.3",
     "eslint-plugin-promise": "6.1.1",
     "expect-type": "0.17.3",
     "expr-eval": "2.0.2",
@@ -85,12 +85,12 @@
     "ndarray-pack": "1.2.1",
     "numericjs": "1.2.6",
     "pad-right": "0.2.2",
-    "prettier": "3.1.1",
+    "prettier": "3.2.4",
     "process": "0.11.10",
     "sylvester": "0.0.21",
     "ts-node": "10.9.2",
     "typescript": "5.3.3",
-    "webpack": "5.89.0",
+    "webpack": "5.90.0",
     "zeros": "1.0.0"
   },
   "type": "module",

package/types/index.d.ts

@@ -183,11 +183,11 @@ export interface ArrayNode<TItems extends MathNode[] = MathNode[]>
   extends MathNode {
   type: 'ArrayNode'
   isArrayNode: true
-  items: TItems
+  items: [...TItems]
 }
 export interface ArrayNodeCtor {
   new <TItems extends MathNode[] = MathNode[]>(
-    items: MathNode[]
+    items: [...TItems]
   ): ArrayNode<TItems>
 }
 
@@ -283,12 +283,12 @@ export interface FunctionNode<
   type: 'FunctionNode'
   isFunctionNode: true
   fn: TFn
-  args: TArgs
+  args: [...TArgs]
 }
 export interface FunctionNodeCtor {
   new <TFn = SymbolNode, TArgs extends MathNode[] = MathNode[]>(
     fn: TFn,
-    args: TArgs
+    args: [...TArgs]
   ): FunctionNode<TFn, TArgs>
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   onUndefinedFunction: (name: string) => any
@@ -298,13 +298,13 @@ export interface IndexNode<TDims extends MathNode[] = MathNode[]>
   extends MathNode {
   type: 'IndexNode'
   isIndexNode: true
-  dimensions: TDims
+  dimensions: [...TDims]
   dotNotation: boolean
 }
 export interface IndexNodeCtor {
-  new <TDims extends MathNode[] = MathNode[]>(dimensions: TDims): IndexNode
+  new <TDims extends MathNode[] = MathNode[]>(dimensions: [...TDims]): IndexNode
   new <TDims extends MathNode[] = MathNode[]>(
-    dimensions: TDims,
+    dimensions: [...TDims],
     dotNotation: boolean
   ): IndexNode<TDims>
 }
@@ -367,7 +367,7 @@ export interface OperatorNode<
   isOperatorNode: true
   op: TOp
   fn: TFn
-  args: TArgs
+  args: [...TArgs]
   implicit: boolean
   isUnary(): boolean
   isBinary(): boolean
@@ -381,7 +381,7 @@ export interface OperatorNodeCtor extends MathNode {
   >(
     op: TOp,
     fn: TFn,
-    args: TArgs,
+    args: [...TArgs],
     implicit?: boolean
   ): OperatorNode<TOp, TFn, TArgs>
 }
@@ -423,12 +423,12 @@ export interface RelationalNode<TParams extends MathNode[] = MathNode[]>
   type: 'RelationalNode'
   isRelationalNode: true
   conditionals: string[]
-  params: TParams
+  params: [...TParams]
 }
 export interface RelationalNodeCtor {
   new <TParams extends MathNode[] = MathNode[]>(
     conditionals: string[],
-    params: TParams
+    params: [...TParams]
   ): RelationalNode<TParams>
 }
 
@@ -1200,7 +1200,8 @@ export interface MathJsInstance extends MathJsFactory {
    * whole matrix.
    * @returns Returns the hypothenuse of the input values.
    */
-  hypot<T extends (number | BigNumber)[]>(...args: T[]): T
+  hypot<T extends number | BigNumber>(...args: T[]): T
+  hypot<T extends number | BigNumber>(args: T[]): T
 
   /**
    * Calculate the least common multiple for two or more values or arrays.
@@ -3012,7 +3013,7 @@ export interface MathJsInstance extends MathJsFactory {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     value: any,
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    options?: FormatOptions | number | ((item: any) => string),
+    options?: FormatOptions | number | BigNumber | ((item: any) => string),
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     callback?: (value: any) => string
   ): string
@@ -3860,8 +3861,10 @@ export interface Matrix {
   ): void
   toArray(): MathArray
   valueOf(): MathArray
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  format(options?: FormatOptions | number | ((value: any) => string)): string
+  format(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    options?: FormatOptions | number | BigNumber | ((value: any) => string)
+  ): string
   toString(): string
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   toJSON(): any
@@ -4252,19 +4255,19 @@ export interface FormatOptions {
    * case of notation 'fixed', precision defines the number of significant
    * digits after the decimal point, and is 0 by default.
    */
-  precision?: number
+  precision?: number | BigNumber
 
   /**
    * Exponent determining the lower boundary for formatting a value with
    * an exponent when notation='auto. Default value is -3.
    */
-  lowerExp?: number
+  lowerExp?: number | BigNumber
 
   /**
    * Exponent determining the upper boundary for formatting a value with
    * an exponent when notation='auto. Default value is 5.
    */
-  upperExp?: number
+  upperExp?: number | BigNumber
 
   /**
    * Available values: 'ratio' (default) or 'decimal'. For example
@@ -4272,6 +4275,15 @@ export interface FormatOptions {
    * and will output 0.(3) when 'decimal' is configured.
    */
   fraction?: string
+
+  /**
+   * The word size in bits to use for formatting in binary, octal, or
+   * hexadecimal notation. To be used only with `'bin'`, `'oct'`, or `'hex'`
+   * values for `notation` option. When this option is defined the value
+   * is formatted as a signed twos complement integer of the given word
+   * size and the size suffix is appended to the output.
+   */
+  wordSize?: number | BigNumber
 }
 
 export interface Help {