mathjs 12.3.0 → 12.3.2

package/lib/cjs/entry/configReadonly.js

@@ -9,7 +9,7 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 var _config = require("../core/config.js");
 var _config2 = require("../core/function/config.js");
 // create a read-only version of config
-var config = exports.config = /* #__PURE__ */function config(options) {
+var config = exports.config = function config(options) {
   if (options) {
     throw new Error('The global config is readonly. \n' + 'Please create a mathjs instance if you want to change the default configuration. \n' + 'Example:\n' + '\n' + '  import { create, all } from \'mathjs\';\n' + '  const mathjs = create(all);\n' + '  mathjs.config({ number: \'BigNumber\' });\n');
   }

package/lib/cjs/entry/dependenciesAny/dependenciesHelpClass.generated.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.HelpDependencies = void 0;
-var _dependenciesParseGenerated = require("./dependenciesParse.generated.js");
+var _dependenciesEvaluateGenerated = require("./dependenciesEvaluate.generated.js");
 var _factoriesAny = require("../../factoriesAny.js");
 /**
  * THIS FILE IS AUTO-GENERATED
@@ -12,6 +12,6 @@ var _factoriesAny = require("../../factoriesAny.js");
  */
 
 var HelpDependencies = exports.HelpDependencies = {
-  parseDependencies: _dependenciesParseGenerated.parseDependencies,
+  evaluateDependencies: _dependenciesEvaluateGenerated.evaluateDependencies,
   createHelpClass: _factoriesAny.createHelpClass
 };

package/lib/cjs/entry/dependenciesNumber/dependenciesHelpClass.generated.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.HelpDependencies = void 0;
-var _dependenciesParseGenerated = require("./dependenciesParse.generated.js");
+var _dependenciesEvaluateGenerated = require("./dependenciesEvaluate.generated.js");
 var _factoriesNumber = require("../../factoriesNumber.js");
 /**
  * THIS FILE IS AUTO-GENERATED
@@ -12,6 +12,6 @@ var _factoriesNumber = require("../../factoriesNumber.js");
  */
 
 var HelpDependencies = exports.HelpDependencies = {
-  parseDependencies: _dependenciesParseGenerated.parseDependencies,
+  evaluateDependencies: _dependenciesEvaluateGenerated.evaluateDependencies,
   createHelpClass: _factoriesNumber.createHelpClass
 };

package/lib/cjs/entry/impureFunctionsAny.generated.js

@@ -143,13 +143,6 @@ var compile = exports.compile = (0, _factoriesAny.createCompile)({
   parse: parse,
   typed: _pureFunctionsAnyGenerated.typed
 });
-var Help = exports.Help = (0, _factoriesAny.createHelpClass)({
-  parse: parse
-});
-var leafCount = exports.leafCount = (0, _factoriesAny.createLeafCount)({
-  parse: parse,
-  typed: _pureFunctionsAnyGenerated.typed
-});
 var simplifyCore = exports.simplifyCore = (0, _factoriesAny.createSimplifyCore)({
   AccessorNode: AccessorNode,
   ArrayNode: ArrayNode,
@@ -174,10 +167,8 @@ var evaluate = exports.evaluate = (0, _factoriesAny.createEvaluate)({
   parse: parse,
   typed: _pureFunctionsAnyGenerated.typed
 });
-var help = exports.help = (0, _factoriesAny.createHelp)({
-  Help: Help,
-  mathWithTransform: mathWithTransform,
-  typed: _pureFunctionsAnyGenerated.typed
+var Help = exports.Help = (0, _factoriesAny.createHelpClass)({
+  evaluate: evaluate
 });
 var Parser = exports.Parser = (0, _factoriesAny.createParserClass)({
   evaluate: evaluate
@@ -216,6 +207,10 @@ var symbolicEqual = exports.symbolicEqual = (0, _factoriesAny.createSymbolicEqua
   simplify: simplify,
   typed: _pureFunctionsAnyGenerated.typed
 });
+var leafCount = exports.leafCount = (0, _factoriesAny.createLeafCount)({
+  parse: parse,
+  typed: _pureFunctionsAnyGenerated.typed
+});
 var parser = exports.parser = (0, _factoriesAny.createParser)({
   Parser: Parser,
   typed: _pureFunctionsAnyGenerated.typed
@@ -262,6 +257,11 @@ var derivative = exports.derivative = (0, _factoriesAny.createDerivative)({
   simplify: simplify,
   typed: _pureFunctionsAnyGenerated.typed
 });
+var help = exports.help = (0, _factoriesAny.createHelp)({
+  Help: Help,
+  mathWithTransform: mathWithTransform,
+  typed: _pureFunctionsAnyGenerated.typed
+});
 (0, _extends2["default"])(math, {
   e: _pureFunctionsAnyGenerated.e,
   "false": _pureFunctionsAnyGenerated._false,
@@ -539,7 +539,7 @@ var derivative = exports.derivative = (0, _factoriesAny.createDerivative)({
   eigs: _pureFunctionsAnyGenerated.eigs,
   fermiCoupling: _pureFunctionsAnyGenerated.fermiCoupling,
   gasConstant: _pureFunctionsAnyGenerated.gasConstant,
-  leafCount: leafCount,
+  kldivergence: _pureFunctionsAnyGenerated.kldivergence,
   mean: _pureFunctionsAnyGenerated.mean,
   molarVolume: _pureFunctionsAnyGenerated.molarVolume,
   planckConstant: _pureFunctionsAnyGenerated.planckConstant,
@@ -548,12 +548,12 @@ var derivative = exports.derivative = (0, _factoriesAny.createDerivative)({
   variance: _pureFunctionsAnyGenerated.variance,
   classicalElectronRadius: _pureFunctionsAnyGenerated.classicalElectronRadius,
   evaluate: evaluate,
-  help: help,
   median: _pureFunctionsAnyGenerated.median,
   simplify: simplify,
   symbolicEqual: symbolicEqual,
   corr: _pureFunctionsAnyGenerated.corr,
   freqz: _pureFunctionsAnyGenerated.freqz,
+  leafCount: leafCount,
   mad: _pureFunctionsAnyGenerated.mad,
   parser: parser,
   rationalize: rationalize,
@@ -562,7 +562,7 @@ var derivative = exports.derivative = (0, _factoriesAny.createDerivative)({
   derivative: derivative,
   norm: _pureFunctionsAnyGenerated.norm,
   rotationMatrix: _pureFunctionsAnyGenerated.rotationMatrix,
-  kldivergence: _pureFunctionsAnyGenerated.kldivergence,
+  help: help,
   planckTime: _pureFunctionsAnyGenerated.planckTime,
   schur: _pureFunctionsAnyGenerated.schur,
   rotate: _pureFunctionsAnyGenerated.rotate,

package/lib/cjs/entry/impureFunctionsNumber.generated.js

@@ -165,7 +165,7 @@ var evaluate = exports.evaluate = (0, _factoriesNumber.createEvaluate)({
   typed: _pureFunctionsNumberGenerated.typed
 });
 var Help = exports.Help = (0, _factoriesNumber.createHelpClass)({
-  parse: parse
+  evaluate: evaluate
 });
 var Parser = exports.Parser = (0, _factoriesNumber.createParserClass)({
   evaluate: evaluate

package/lib/cjs/entry/pureFunctionsAny.generated.js

@@ -1610,6 +1610,17 @@ var gasConstant = exports.gasConstant = /* #__PURE__ */(0, _factoriesAny.createG
   Unit: Unit,
   config: _configReadonly.config
 });
+var kldivergence = exports.kldivergence = /* #__PURE__ */(0, _factoriesAny.createKldivergence)({
+  divide: divide,
+  dotDivide: dotDivide,
+  isNumeric: isNumeric,
+  log: log,
+  map: map,
+  matrix: matrix,
+  multiply: multiply,
+  sum: sum,
+  typed: typed
+});
 var mean = exports.mean = /* #__PURE__ */(0, _factoriesAny.createMean)({
   add: add,
   divide: divide,
@@ -1740,17 +1751,6 @@ var rotationMatrix = exports.rotationMatrix = /* #__PURE__ */(0, _factoriesAny.c
   typed: typed,
   unaryMinus: unaryMinus
 });
-var kldivergence = exports.kldivergence = /* #__PURE__ */(0, _factoriesAny.createKldivergence)({
-  divide: divide,
-  dotDivide: dotDivide,
-  isNumeric: isNumeric,
-  log: log,
-  map: map,
-  matrix: matrix,
-  multiply: multiply,
-  sum: sum,
-  typed: typed
-});
 var planckTime = exports.planckTime = /* #__PURE__ */(0, _factoriesAny.createPlanckTime)({
   BigNumber: BigNumber,
   Unit: Unit,

package/lib/cjs/expression/Help.js

@@ -9,9 +9,9 @@ var _object = require("../utils/object.js");
 var _string = require("../utils/string.js");
 var _factory = require("../utils/factory.js");
 var name = 'Help';
-var dependencies = ['parse'];
+var dependencies = ['evaluate'];
 var createHelpClass = exports.createHelpClass = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
-  var parse = _ref.parse;
+  var evaluate = _ref.evaluate;
   /**
    * Documentation object
    * @param {Object} doc  Object containing properties:
@@ -59,14 +59,26 @@ var createHelpClass = exports.createHelpClass = /* #__PURE__ */(0, _factory.fact
     }
     if (doc.examples) {
       desc += 'Examples:\n';
-      var scope = {};
+
+      // after evaluating the examples, we restore config in case the examples
+      // did change the config.
+      var configChanged = false;
+      var originalConfig = evaluate('config()');
+      var scope = {
+        config: function config(newConfig) {
+          configChanged = true;
+          return evaluate('config(newConfig)', {
+            newConfig: newConfig
+          });
+        }
+      };
       for (var i = 0; i < doc.examples.length; i++) {
         var expr = doc.examples[i];
         desc += '    ' + expr + '\n';
         var res = void 0;
         try {
           // note: res can be undefined when `expr` is an empty string
-          res = parse(expr).compile().evaluate(scope);
+          res = evaluate(expr, scope);
         } catch (e) {
           res = e;
         }
@@ -77,6 +89,11 @@ var createHelpClass = exports.createHelpClass = /* #__PURE__ */(0, _factory.fact
         }
       }
       desc += '\n';
+      if (configChanged) {
+        evaluate('config(originalConfig)', {
+          originalConfig: originalConfig
+        });
+      }
     }
     if (doc.mayThrow && doc.mayThrow.length) {
       desc += 'Throws: ' + doc.mayThrow.join(', ') + '\n\n';

package/lib/cjs/expression/node/OperatorNode.js

@@ -13,6 +13,7 @@ var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _is = require("../../utils/is.js");
 var _array = require("../../utils/array.js");
+var _scope = require("../../utils/scope.js");
 var _string = require("../../utils/string.js");
 var _customs = require("../../utils/customs.js");
 var _operators = require("../operators.js");
@@ -311,7 +312,7 @@ var createOperatorNode = exports.createOperatorNode = /* #__PURE__ */(0, _factor
           // "raw" evaluation
           var rawArgs = this.args;
           return function evalOperatorNode(scope, args, context) {
-            return fn(rawArgs, math, scope);
+            return fn(rawArgs, math, (0, _scope.createSubScope)(scope, args));
           };
         } else if (evalArgs.length === 1) {
           var evalArg0 = evalArgs[0];

package/lib/cjs/expression/transform/utils/compileInlineExpression.js

@@ -5,12 +5,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.compileInlineExpression = compileInlineExpression;
 var _is = require("../../../utils/is.js");
-var _scope = require("../../../utils/scope.js");
+var _map = require("../../../utils/map.js");
 /**
  * Compile an inline expression like "x > 0"
  * @param {Node} expression
  * @param {Object} math
- * @param {Object} scope
+ * @param {Map} scope
  * @return {function} Returns a function with one argument which fills in the
  *                    undefined variable (like "x") and evaluates the expression
  */
@@ -25,10 +25,11 @@ function compileInlineExpression(expression, math, scope) {
 
   // create a test function for this equation
   var name = symbol.name; // variable name
-  var subScope = (0, _scope.createSubScope)(scope);
+  var argsScope = new Map();
+  var subScope = new _map.PartitionedMap(scope, argsScope, new Set([name]));
   var eq = expression.compile();
   return function inlineExpression(x) {
-    subScope.set(name, x);
+    argsScope.set(name, x);
     return eq.evaluate(subScope);
   };
 }

package/lib/cjs/function/string/bin.js

@@ -25,8 +25,8 @@ var dependencies = ['typed', 'format'];
  *    oct
  *    hex
  *
- * @param {number} value    Value to be stringified
- * @param {number} wordSize Optional word size (see `format`)
+ * @param {number | BigNumber} value    Value to be stringified
+ * @param {number | BigNumber} wordSize Optional word size (see `format`)
  * @return {string}         The formatted value
  */
 var createBin = exports.createBin = (0, _factory.factory)(name, dependencies, function (_ref) {
@@ -38,7 +38,7 @@ var createBin = exports.createBin = (0, _factory.factory)(name, dependencies, fu
         notation: 'bin'
       });
     },
-    'number | BigNumber, number': function numberBigNumberNumber(n, wordSize) {
+    'number | BigNumber, number | BigNumber': function numberBigNumberNumberBigNumber(n, wordSize) {
       return format(n, {
         notation: 'bin',
         wordSize: wordSize

package/lib/cjs/function/string/format.js

@@ -46,7 +46,7 @@ var createFormat = exports.createFormat = /* #__PURE__ */(0, _factory.factory)(n
    *      - `'bin'`, `'oct'`, or `'hex'`
    *        Format the number using binary, octal, or hexadecimal notation.
    *        For example `'0b1101'` and `'0x10fe'`.
-   *    - `wordSize: number`
+   *    - `wordSize: number | BigNumber`
    *      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
@@ -54,7 +54,7 @@ var createFormat = exports.createFormat = /* #__PURE__ */(0, _factory.factory)(n
    *      size and the size suffix is appended to the output.
    *      For example `format(-1, {notation: 'hex', wordSize: 8}) === '0xffi8'`.
    *      Default value is undefined.
-   *    - `precision: number`
+   *    - `precision: number | BigNumber`
    *      Limit the number of digits of the formatted value.
    *      For regular numbers, must be a number between `0` and `16`.
    *      For bignumbers, the maximum depends on the configured precision,
@@ -130,6 +130,6 @@ var createFormat = exports.createFormat = /* #__PURE__ */(0, _factory.factory)(n
    */
   return typed(name, {
     any: _string.format,
-    'any, Object | function | number': _string.format
+    'any, Object | function | number | BigNumber': _string.format
   });
 });

package/lib/cjs/function/string/hex.js

@@ -24,8 +24,8 @@ var dependencies = ['typed', 'format'];
  *    oct
  *    bin
  *
- * @param {number} value    Value to be stringified
- * @param {number} wordSize Optional word size (see `format`)
+ * @param {number | BigNumber} value    Value to be stringified
+ * @param {number | BigNumber} wordSize Optional word size (see `format`)
  * @return {string}         The formatted value
  */
 var createHex = exports.createHex = (0, _factory.factory)(name, dependencies, function (_ref) {
@@ -37,7 +37,7 @@ var createHex = exports.createHex = (0, _factory.factory)(name, dependencies, fu
         notation: 'hex'
       });
     },
-    'number | BigNumber, number': function numberBigNumberNumber(n, wordSize) {
+    'number | BigNumber, number | BigNumber': function numberBigNumberNumberBigNumber(n, wordSize) {
       return format(n, {
         notation: 'hex',
         wordSize: wordSize

package/lib/cjs/function/string/oct.js

@@ -25,8 +25,8 @@ var dependencies = ['typed', 'format'];
  *    bin
  *    hex
  *
- * @param {number} value    Value to be stringified
- * @param {number} wordSize Optional word size (see `format`)
+ * @param {number | BigNumber} value    Value to be stringified
+ * @param {number | BigNumber} wordSize Optional word size (see `format`)
  * @return {string}         The formatted value
  */
 
@@ -39,7 +39,7 @@ var createOct = exports.createOct = (0, _factory.factory)(name, dependencies, fu
         notation: 'oct'
       });
     },
-    'number | BigNumber, number': function numberBigNumberNumber(n, wordSize) {
+    'number | BigNumber, number | BigNumber': function numberBigNumberNumberBigNumber(n, wordSize) {
       return format(n, {
         notation: 'oct',
         wordSize: wordSize

package/lib/cjs/header.js

@@ -6,8 +6,8 @@
  * It features real and complex numbers, units, matrices, a large set of
  * mathematical functions, and a flexible expression parser.
  *
- * @version 12.3.0
- * @date    2024-01-12
+ * @version 12.3.2
+ * @date    2024-02-08
  *
  * @license
  * Copyright (C) 2013-2024 Jos de Jong <wjosdejong@gmail.com>

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

@@ -49,7 +49,7 @@ var createAvogadro = exports.createAvogadro = /* #__PURE__ */unitFactory('avogad
 var createBoltzmann = exports.createBoltzmann = /* #__PURE__ */unitFactory('boltzmann', '1.380649e-23', 'J K^-1');
 var createFaraday = exports.createFaraday = /* #__PURE__ */unitFactory('faraday', '96485.33212331001', 'C mol^-1');
 var createFirstRadiation = exports.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
 var createLoschmidt = exports.createLoschmidt = /* #__PURE__ */unitFactory('loschmidt', '2.686780111798444e25', 'm^-3');
 var createGasConstant = exports.createGasConstant = /* #__PURE__ */unitFactory('gasConstant', '8.31446261815324', 'J K^-1 mol^-1');
 var createMolarPlanckConstant = exports.createMolarPlanckConstant = /* #__PURE__ */unitFactory('molarPlanckConstant', '3.990312712893431e-10', 'J s mol^-1');

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

@@ -7,6 +7,7 @@ exports.format = format;
 exports.toEngineering = toEngineering;
 exports.toExponential = toExponential;
 exports.toFixed = toFixed;
+var _is = require("../is.js");
 var _number = require("../number.js");
 /**
  * Formats a BigNumber in a given base
@@ -127,7 +128,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
  */
 function format(value, options) {
@@ -140,30 +141,10 @@ 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 _normalizeFormatOptio = (0, _number.normalizeFormatOptions)(options),
+    notation = _normalizeFormatOptio.notation,
+    precision = _normalizeFormatOptio.precision,
+    wordSize = _normalizeFormatOptio.wordSize;
 
   // handle the various notations
   switch (notation) {
@@ -183,8 +164,8 @@ 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';
@@ -257,4 +238,13 @@ function toExponential(value, precision) {
  */
 function toFixed(value, precision) {
   return value.toFixed(precision);
+}
+function _toNumberOrDefault(value, defaultValue) {
+  if ((0, _is.isNumber)(value)) {
+    return value;
+  } else if ((0, _is.isBigNumber)(value)) {
+    return value.toNumber();
+  } else {
+    return defaultValue;
+  }
 }