mathjs 10.6.2 → 11.0.0

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

@@ -72,12 +72,7 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       this.units = u.units;
       this.dimensions = u.dimensions;
     } else {
-      this.units = [{
-        unit: UNIT_NONE,
-        prefix: PREFIXES.NONE,
-        // link to a list with supported prefixes
-        power: 0
-      }];
+      this.units = [];
       this.dimensions = [];
 
       for (var i = 0; i < BASE_DIMENSIONS.length; i++) {
@@ -99,6 +94,10 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
    */
 
 
+  Object.defineProperty(Unit, 'name', {
+    value: 'Unit'
+  });
+  Unit.prototype.constructor = Unit;
   Unit.prototype.type = 'Unit';
   Unit.prototype.isUnit = true; // private variables and functions for the Unit parser
 
@@ -461,6 +460,17 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
 
     return unit;
   };
+  /**
+   * Return the type of the value of this unit
+   *
+   * @memberof Unit
+   * @ return {string} type of the value of the unit
+   */
+
+
+  Unit.prototype.valueType = function () {
+    return typeOf(this.value);
+  };
   /**
    * Return whether the unit is derived (such as m/s, or cm^2, but not N)
    * @memberof Unit
@@ -648,15 +658,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
     return this.equalBase(other) && equal(this.value, other.value);
   };
   /**
-   * Multiply this unit with another one
+   * Multiply this unit with another one or with a scalar
    * @memberof Unit
    * @param {Unit} other
    * @return {Unit} product of this unit and the other unit
    */
 
 
-  Unit.prototype.multiply = function (other) {
+  Unit.prototype.multiply = function (_other) {
     var res = this.clone();
+    var other = isUnit(_other) ? _other : new Unit(_other);
 
     for (var i = 0; i < BASE_DIMENSIONS.length; i++) {
       // Dimensions arrays may be of different lengths. Default to 0.
@@ -680,19 +691,35 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       res.value = null;
     }
 
-    res.skipAutomaticSimplification = false;
+    if (isUnit(_other)) {
+      res.skipAutomaticSimplification = false;
+    }
+
     return getNumericIfUnitless(res);
   };
+  /**
+   * Divide a number by this unit
+   *
+   * @memberof Unit
+   * @param {numeric} numerator
+   * @param {unit} result of dividing numerator by this unit
+   */
+
+
+  Unit.prototype.divideInto = function (numerator) {
+    return new Unit(numerator).divide(this);
+  };
   /**
    * Divide this unit by another one
    * @memberof Unit
-   * @param {Unit} other
+   * @param {Unit | numeric} other
    * @return {Unit} result of dividing this unit by the other unit
    */
 
 
-  Unit.prototype.divide = function (other) {
+  Unit.prototype.divide = function (_other) {
     var res = this.clone();
+    var other = isUnit(_other) ? _other : new Unit(_other);
 
     for (var i = 0; i < BASE_DIMENSIONS.length; i++) {
       // Dimensions arrays may be of different lengths. Default to 0.
@@ -718,7 +745,10 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       res.value = null;
     }
 
-    res.skipAutomaticSimplification = false;
+    if (isUnit(_other)) {
+      res.skipAutomaticSimplification = false;
+    }
+
     return getNumericIfUnitless(res);
   };
   /**
@@ -787,7 +817,7 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
         // To give the correct, but unexpected, results for units with an offset.
         // For example, abs(-283.15 degC) = -263.15 degC !!!
         // We must take the offset into consideration here
-        var convert = Unit._getNumberConverter(typeOf(ret.value)); // convert to Fraction or BigNumber if needed
+        var convert = ret._numberConverter(); // convert to Fraction or BigNumber if needed
 
 
         var unitValue = convert(ret.units[0].unit.value);
@@ -3627,6 +3657,23 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       return x;
     }
   };
+  /**
+   * Retrieve the right converter function corresponding with this unit's
+   * value
+   *
+   * @memberof Unit
+   * @return {Function}
+   */
+
+  Unit.prototype._numberConverter = function () {
+    var convert = Unit.typeConverters[this.valueType()];
+
+    if (convert) {
+      return convert;
+    }
+
+    throw new TypeError('Unsupported Unit value type "' + this.valueType() + '"');
+  };
   /**
    * Retrieve the right convertor function corresponding with the type
    * of provided exampleValue.
@@ -3636,6 +3683,7 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
    * @return {Function}
    */
 
+
   Unit._getNumberConverter = function (type) {
     if (!Unit.typeConverters[type]) {
       throw new TypeError('Unsupported type "' + type + '"');

package/lib/esm/type/unit/function/createUnit.js

@@ -34,9 +34,10 @@ export var createCreateUnit = /* #__PURE__ */factory(name, dependencies, _ref =>
    *     math.createUnit('foo')
    *     math.createUnit('knot', {definition: '0.514444444 m/s', aliases: ['knots', 'kt', 'kts']})
    *     math.createUnit('mph', '1 mile/hour')
+   *     math.createUnit('km', math.unit(1000, 'm'))
    *
    * @param {string} name      The name of the new unit. Must be unique. Example: 'knot'
-   * @param {string, Unit} definition      Definition of the unit in terms of existing units. For example, '0.514444444 m / s'.
+   * @param {string, UnitDefinition, Unit} definition      Definition of the unit in terms of existing units. For example, '0.514444444 m / s'.
    * @param {Object} options   (optional) An object containing any of the following properties:
    *     - `prefixes {string}` "none", "short", "long", "binary_short", or "binary_long". The default is "none".
    *     - `aliases {Array}` Array of strings. Example: ['knots', 'kt', 'kts']

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

@@ -48,8 +48,10 @@ export var createUnitFunction = /* #__PURE__ */factory(name, dependencies, _ref
     'number | BigNumber | Fraction | Complex, string': function numberBigNumberFractionComplexString(value, unit) {
       return new Unit(value, unit);
     },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
-    }
+    'number | BigNumber | Fraction': function numberBigNumberFraction(value) {
+      // dimensionless
+      return new Unit(value);
+    },
+    'Array | Matrix': typed.referToSelf(self => x => deepMap(x, self))
   });
 });

package/lib/esm/utils/is.js

@@ -111,6 +111,20 @@ export function isConditionalNode(x) {
 export function isConstantNode(x) {
   return x && x.isConstantNode === true && x.constructor.prototype.isNode === true || false;
 }
+/* Very specialized: returns true for those nodes which in the numerator of
+   a fraction means that the division in that fraction has precedence over implicit
+   multiplication, e.g. -2/3 x parses as (-2/3) x and 3/4 x parses as (3/4) x but
+   6!/8 x parses as 6! / (8x). It is located here because it is shared between
+   parse.js and OperatorNode.js (for parsing and printing, respectively).
+
+   This should *not* be exported from mathjs, unlike most of the tests here.
+   Its name does not start with 'is' to prevent utils/snapshot.js from thinking
+   it should be exported.
+*/
+
+export function rule2Node(node) {
+  return isConstantNode(node) || isOperatorNode(node) && node.args.length === 1 && isConstantNode(node.args[0]) && '-+~'.includes(node.op);
+}
 export function isFunctionAssignmentNode(x) {
   return x && x.isFunctionAssignmentNode === true && x.constructor.prototype.isNode === true || false;
 }
@@ -145,26 +159,12 @@ export function typeOf(x) {
   var t = typeof x;
 
   if (t === 'object') {
-    // JavaScript types
     if (x === null) return 'null';
-    if (Array.isArray(x)) return 'Array';
-    if (x instanceof Date) return 'Date';
-    if (x instanceof RegExp) return 'RegExp'; // math.js types
+    if (isBigNumber(x)) return 'BigNumber'; // Special: weird mashup with Decimal
 
-    if (isBigNumber(x)) return 'BigNumber';
-    if (isComplex(x)) return 'Complex';
-    if (isFraction(x)) return 'Fraction';
-    if (isMatrix(x)) return 'Matrix';
-    if (isUnit(x)) return 'Unit';
-    if (isIndex(x)) return 'Index';
-    if (isRange(x)) return 'Range';
-    if (isResultSet(x)) return 'ResultSet';
-    if (isNode(x)) return x.type;
-    if (isChain(x)) return 'Chain';
-    if (isHelp(x)) return 'Help';
-    return 'Object';
+    if (x.constructor && x.constructor.name) return x.constructor.name;
+    return 'Object'; // just in case
   }
 
-  if (t === 'function') return 'Function';
-  return t; // can be 'string', 'number', 'boolean', ...
+  return t; // can be 'string', 'number', 'boolean', 'function', 'bigint', ...
 }

package/lib/esm/utils/snapshot.js

@@ -16,6 +16,7 @@ import assert from 'assert';
 import * as allIsFunctions from './is.js';
 import { create } from '../core/create.js';
 import { endsWith } from './string.js';
+export var validateTypeOf = allIsFunctions.typeOf;
 export function validateBundle(expectedBundleStructure, bundle) {
   var originalWarn = console.warn;
 
@@ -110,21 +111,21 @@ export function createSnapshotFromFactories(factories) {
     var factory = factories[factoryName];
     var name = factory.fn;
     var isTransformFunction = factory.meta && factory.meta.isTransformFunction;
-    var isClass = !isLowerCase(name[0]) && validateTypeOf(math[name]) === 'Function';
+    var isClass = !isLowerCase(name[0]) && validateTypeOf(math[name]) === 'function';
     var dependenciesName = factory.fn + (isTransformFunction ? 'Transform' : '') + 'Dependencies';
-    allFactoryFunctions[factoryName] = 'Function';
+    allFactoryFunctions[factoryName] = 'function';
     allFunctionsConstantsClasses[name] = validateTypeOf(math[name]);
     allDependencyCollections[dependenciesName] = 'Object';
 
     if (isTransformFunction) {
-      allTransformFunctions[name] = 'Function';
+      allTransformFunctions[name] = 'function';
     }
 
     if (isClass) {
       if (endsWith(name, 'Node')) {
-        allNodeClasses[name] = 'Function';
+        allNodeClasses[name] = 'function';
       } else {
-        allClasses[name] = 'Function';
+        allClasses[name] = 'function';
       }
     } else {
       allFunctionsConstants[name] = validateTypeOf(math[name]);
@@ -144,37 +145,37 @@ export function createSnapshotFromFactories(factories) {
   var allTypeChecks = {};
   Object.keys(allIsFunctions).forEach(name => {
     if (name.indexOf('is') === 0) {
-      allTypeChecks[name] = 'Function';
+      allTypeChecks[name] = 'function';
     }
   });
   var allErrorClasses = {
-    ArgumentsError: 'Function',
-    DimensionError: 'Function',
-    IndexError: 'Function'
+    ArgumentsError: 'function',
+    DimensionError: 'function',
+    IndexError: 'function'
   };
 
   var expectedInstanceStructure = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, allFunctionsConstantsClasses), {}, {
-    on: 'Function',
-    off: 'Function',
-    once: 'Function',
-    emit: 'Function',
-    import: 'Function',
-    config: 'Function',
-    create: 'Function',
-    factory: 'Function'
+    on: 'function',
+    off: 'function',
+    once: 'function',
+    emit: 'function',
+    import: 'function',
+    config: 'function',
+    create: 'function',
+    factory: 'function'
   }, allTypeChecks), allErrorClasses), {}, {
     expression: {
       transform: _objectSpread({}, allTransformFunctions),
       mathWithTransform: _objectSpread(_objectSpread({}, exclude(allFunctionsConstants, ['chain'])), {}, {
-        config: 'Function'
+        config: 'function'
       })
     }
   });
 
   var expectedES6Structure = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, exclude(allFunctionsConstantsClasses, ['E', 'false', 'Infinity', 'NaN', 'null', 'PI', 'true'])), {}, {
-    create: 'Function',
-    config: 'Function',
-    factory: 'Function',
+    create: 'function',
+    config: 'function',
+    factory: 'function',
     _true: 'boolean',
     _false: 'boolean',
     _null: 'null',
@@ -189,33 +190,6 @@ export function createSnapshotFromFactories(factories) {
     expectedES6Structure
   };
 }
-export function validateTypeOf(x) {
-  if (x && x.type === 'Unit') {
-    return 'Unit';
-  }
-
-  if (x && x.type === 'Complex') {
-    return 'Complex';
-  }
-
-  if (Array.isArray(x)) {
-    return 'Array';
-  }
-
-  if (x === null) {
-    return 'null';
-  }
-
-  if (typeof x === 'function') {
-    return 'Function';
-  }
-
-  if (typeof x === 'object') {
-    return 'Object';
-  }
-
-  return typeof x;
-}
 
 function traverse(obj) {
   var callback = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : (value, path) => {};

package/lib/esm/version.js

@@ -1,2 +1,2 @@
-export var version = '10.6.2'; // Note: This file is automatically generated when building math.js.
+export var version = '11.0.0'; // 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": "10.6.2",
+  "version": "11.0.0",
   "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.18.3",
+    "@babel/runtime": "^7.18.9",
     "complex.js": "^2.1.1",
     "decimal.js": "^10.3.1",
     "escape-latex": "^1.2.0",
@@ -33,37 +33,37 @@
     "javascript-natural-sort": "^0.7.1",
     "seedrandom": "^3.0.5",
     "tiny-emitter": "^2.1.0",
-    "typed-function": "^2.1.0"
+    "typed-function": "^3.0.0"
   },
   "devDependencies": {
-    "@babel/core": "7.18.5",
-    "@babel/plugin-transform-object-assign": "7.16.7",
-    "@babel/plugin-transform-runtime": "7.18.5",
-    "@babel/preset-env": "7.18.2",
-    "@babel/register": "7.17.7",
+    "@babel/core": "7.18.9",
+    "@babel/plugin-transform-object-assign": "7.18.6",
+    "@babel/plugin-transform-runtime": "7.18.9",
+    "@babel/preset-env": "7.18.9",
+    "@babel/register": "7.18.9",
     "@types/assert": "1.5.6",
     "@types/mocha": "9.1.1",
-    "@typescript-eslint/eslint-plugin": "5.29.0",
-    "@typescript-eslint/parser": "5.29.0",
+    "@typescript-eslint/eslint-plugin": "5.30.7",
+    "@typescript-eslint/parser": "5.30.7",
     "assert": "2.0.0",
     "babel-loader": "8.2.5",
     "benchmark": "2.1.4",
     "codecov": "3.8.3",
-    "core-js": "3.23.2",
+    "core-js": "3.23.5",
     "del": "6.1.1",
     "dtslint": "4.2.1",
-    "eslint": "8.18.0",
+    "eslint": "8.20.0",
     "eslint-config-prettier": "8.5.0",
     "eslint-config-standard": "17.0.0",
     "eslint-plugin-import": "2.26.0",
-    "eslint-plugin-mocha": "10.0.5",
-    "eslint-plugin-n": "15.2.3",
-    "eslint-plugin-prettier": "4.0.0",
+    "eslint-plugin-mocha": "10.1.0",
+    "eslint-plugin-n": "15.2.4",
+    "eslint-plugin-prettier": "4.2.1",
     "eslint-plugin-promise": "6.0.0",
     "expect-type": "0.13.0",
     "expr-eval": "2.0.2",
     "fancy-log": "2.0.0",
-    "glob": "7.2.0",
+    "glob": "8.0.3",
     "gulp": "4.0.2",
     "gulp-babel": "8.0.0",
     "handlebars": "4.7.7",
@@ -74,10 +74,10 @@
     "karma-firefox-launcher": "2.1.2",
     "karma-mocha": "2.0.1",
     "karma-mocha-reporter": "2.2.5",
-    "karma-webpack": "4.0.2",
-    "math-expression-evaluator": "1.3.14",
+    "karma-webpack": "5.0.0",
+    "math-expression-evaluator": "1.4.0",
     "mkdirp": "1.0.4",
-    "mocha": "8.4.0",
+    "mocha": "10.0.0",
     "ndarray": "1.0.19",
     "ndarray-determinant": "1.0.0",
     "ndarray-gemm": "1.0.0",
@@ -89,9 +89,9 @@
     "prettier": "2.7.1",
     "process": "0.11.10",
     "sylvester": "0.0.21",
-    "ts-node": "10.8.1",
+    "ts-node": "10.9.1",
     "typescript": "4.7.4",
-    "webpack": "4.46.0",
+    "webpack": "5.73.0",
     "zeros": "1.0.0"
   },
   "type": "module",
@@ -176,8 +176,5 @@
   "bugs": {
     "url": "https://github.com/josdejong/mathjs/issues"
   },
-  "browserslist": [
-    "IE 11"
-  ],
   "sideEffects": false
 }