mathjs 12.0.0 → 12.1.0

package/lib/cjs/expression/embeddedDocs/function/arithmetic/round.js

@@ -7,8 +7,8 @@ exports.roundDocs = void 0;
 var roundDocs = exports.roundDocs = {
   name: 'round',
   category: 'Arithmetic',
-  syntax: ['round(x)', 'round(x, n)'],
+  syntax: ['round(x)', 'round(x, n)', 'round(unit, valuelessUnit)', 'round(unit, n, valuelessUnit)'],
   description: 'round a value towards the nearest integer.If x is complex, both real and imaginary part are rounded towards the nearest integer. When n is specified, the value is rounded to n decimals.',
-  examples: ['round(3.2)', 'round(3.8)', 'round(-4.2)', 'round(-4.8)', 'round(pi, 3)', 'round(123.45678, 2)'],
+  examples: ['round(3.2)', 'round(3.8)', 'round(-4.2)', 'round(-4.8)', 'round(pi, 3)', 'round(123.45678, 2)', 'round(3.241cm, 2, cm)', 'round([3.2, 3.8, -4.7])'],
   seealso: ['ceil', 'floor', 'fix']
 };

package/lib/cjs/function/algebra/derivative.js

@@ -212,9 +212,6 @@ var createDerivative = exports.createDerivative = /* #__PURE__ */(0, _factory.fa
       return _derivative(node.expr, constNodes);
     },
     'FunctionNode, Object': function FunctionNodeObject(node, constNodes) {
-      if (node.args.length !== 1) {
-        funcArgsCheck(node);
-      }
       if (constNodes[node] !== undefined) {
         return createConstantNode(0);
       }
@@ -263,9 +260,12 @@ var createDerivative = exports.createDerivative = /* #__PURE__ */(0, _factory.fa
           }
           break;
         case 'pow':
-          constNodes[arg1] = constNodes[node.args[1]];
-          // Pass to pow operator node parser
-          return _derivative(new OperatorNode('^', 'pow', [arg0, node.args[1]]), constNodes);
+          if (node.args.length === 2) {
+            constNodes[arg1] = constNodes[node.args[1]];
+            // Pass to pow operator node parser
+            return _derivative(new OperatorNode('^', 'pow', [arg0, node.args[1]]), constNodes);
+          }
+          break;
         case 'exp':
           // d/dx(e^x) = e^x
           funcDerivative = new FunctionNode('exp', [arg0.clone()]);
@@ -395,7 +395,7 @@ var createDerivative = exports.createDerivative = /* #__PURE__ */(0, _factory.fa
           break;
         case 'gamma': // Needs digamma function, d/dx(gamma(x)) = gamma(x)digamma(x)
         default:
-          throw new Error('Function "' + node.name + '" is not supported by derivative, or a wrong number of arguments is passed');
+          throw new Error('Cannot process function "' + node.name + '" in derivative: ' + 'the function is not supported, undefined, or the number of arguments passed to it are not supported');
       }
       var op, func;
       if (div) {
@@ -506,33 +506,10 @@ var createDerivative = exports.createDerivative = /* #__PURE__ */(0, _factory.fa
         // Functional Power Rule, d/dx(f^g) = f^g*[f'*(g/f) + g'ln(f)]
         return new OperatorNode('*', 'multiply', [new OperatorNode('^', 'pow', [_arg.clone(), _arg2.clone()]), new OperatorNode('+', 'add', [new OperatorNode('*', 'multiply', [_derivative(_arg, constNodes), new OperatorNode('/', 'divide', [_arg2.clone(), _arg.clone()])]), new OperatorNode('*', 'multiply', [_derivative(_arg2, constNodes), new FunctionNode('log', [_arg.clone()])])])]);
       }
-      throw new Error('Operator "' + node.op + '" is not supported by derivative, or a wrong number of arguments is passed');
+      throw new Error('Cannot process operator "' + node.op + '" in derivative: ' + 'the operator is not supported, undefined, or the number of arguments passed to it are not supported');
     }
   });
 
-  /**
-   * Ensures the number of arguments for a function are correct,
-   * and will throw an error otherwise.
-   *
-   * @param {FunctionNode} node
-   */
-  function funcArgsCheck(node) {
-    // TODO add min, max etc
-    if ((node.name === 'log' || node.name === 'nthRoot' || node.name === 'pow') && node.args.length === 2) {
-      return;
-    }
-
-    // There should be an incorrect number of arguments if we reach here
-
-    // Change all args to constants to avoid unidentified
-    // symbol error when compiling function
-    for (var i = 0; i < node.args.length; ++i) {
-      node.args[i] = createConstantNode(0);
-    }
-    node.compile().evaluate();
-    throw new Error('Function "' + node.name + '" is not supported by derivative, or a wrong number of arguments is passed');
-  }
-
   /**
    * Helper function to create a constant node with a specific type
    * (number, BigNumber, Fraction)

package/lib/cjs/function/arithmetic/gcd.js

@@ -25,7 +25,6 @@ function is1d(array) {
   });
 }
 var createGcd = exports.createGcd = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
-  var _typed;
   var typed = _ref.typed,
     matrix = _ref.matrix,
     config = _ref.config,
@@ -97,7 +96,7 @@ var createGcd = exports.createGcd = /* #__PURE__ */(0, _factory.factory)(name, d
     SS: matAlgo04xSidSid,
     DS: matAlgo01xDSid,
     Ss: matAlgo10xSids
-  }), (_typed = {}, (0, _defineProperty2["default"])(_typed, gcdManyTypesSignature, typed.referToSelf(function (self) {
+  }), (0, _defineProperty2["default"])((0, _defineProperty2["default"])((0, _defineProperty2["default"])({}, gcdManyTypesSignature, typed.referToSelf(function (self) {
     return function (a, b, args) {
       var res = self(a, b);
       for (var i = 0; i < args.length; i++) {
@@ -105,7 +104,7 @@ var createGcd = exports.createGcd = /* #__PURE__ */(0, _factory.factory)(name, d
       }
       return res;
     };
-  })), (0, _defineProperty2["default"])(_typed, "Array", typed.referToSelf(function (self) {
+  })), "Array", typed.referToSelf(function (self) {
     return function (array) {
       if (array.length === 1 && Array.isArray(array[0]) && is1d(array[0])) {
         return self.apply(void 0, (0, _toConsumableArray2["default"])(array[0]));
@@ -115,11 +114,11 @@ var createGcd = exports.createGcd = /* #__PURE__ */(0, _factory.factory)(name, d
       }
       throw new _ArgumentsError.ArgumentsError('gcd() supports only 1d matrices!');
     };
-  })), (0, _defineProperty2["default"])(_typed, "Matrix", typed.referToSelf(function (self) {
+  })), "Matrix", typed.referToSelf(function (self) {
     return function (matrix) {
       return self(matrix.toArray());
     };
-  })), _typed));
+  })));
 
   /**
   * Calculate gcd for numbers

package/lib/cjs/function/arithmetic/mod.js

@@ -95,17 +95,10 @@ var createMod = exports.createMod = /* #__PURE__ */(0, _factory.factory)(name, d
   return typed(name, {
     'number, number': _modNumber,
     'BigNumber, BigNumber': function BigNumberBigNumber(x, y) {
-      if (y.isNeg()) {
-        throw new Error('Cannot calculate mod for a negative divisor');
-      }
-      return y.isZero() ? x : x.mod(y);
+      return y.isZero() ? x : x.sub(y.mul(floor(x.div(y))));
     },
     'Fraction, Fraction': function FractionFraction(x, y) {
-      if (y.compare(0) < 0) {
-        throw new Error('Cannot calculate mod for a negative divisor');
-      }
-      // Workaround suggested in Fraction.js library to calculate correct modulo for negative dividend
-      return x.compare(0) >= 0 ? x.mod(y) : x.mod(y).add(y).mod(y);
+      return y.equals(0) ? x : x.sub(y.mul(floor(x.div(y))));
     }
   }, matrixAlgorithmSuite({
     SS: matAlgo05xSfSf,

package/lib/cjs/function/arithmetic/round.js

@@ -40,6 +40,8 @@ var createRound = exports.createRound = /* #__PURE__ */(0, _factory.factory)(nam
    *
    *    math.round(x)
    *    math.round(x, n)
+   *    math.round(unit, valuelessUnit)
+   *    math.round(unit, n, valuelessUnit)
    *
    * Examples:
    *
@@ -57,14 +59,21 @@ var createRound = exports.createRound = /* #__PURE__ */(0, _factory.factory)(nam
    *    const c = math.complex(3.2, -2.7)
    *    math.round(c)                // returns Complex 3 - 3i
    *
+   *    const unit = math.unit('3.241 cm')
+   *    const cm = math.unit('cm')
+   *    const mm = math.unit('mm')
+   *    math.round(unit, 1, cm)      // returns Unit 3.2 cm
+   *    math.round(unit, 1, mm)      // returns Unit 32.4 mm
+   *
    *    math.round([3.2, 3.8, -4.7]) // returns Array [3, 4, -5]
    *
    * See also:
    *
    *    ceil, fix, floor
    *
-   * @param  {number | BigNumber | Fraction | Complex | Array | Matrix} x  Number to be rounded
+   * @param  {number | BigNumber | Fraction | Complex | Unit | Array | Matrix} x  Value to be rounded
    * @param  {number | BigNumber | Array} [n=0]                            Number of decimals
+   * @param  {Unit} [valuelessUnit]                                        A valueless unit
    * @return {number | BigNumber | Fraction | Complex | Array | Matrix} Rounded value
    */
   return typed(name, {
@@ -116,52 +125,86 @@ var createRound = exports.createRound = /* #__PURE__ */(0, _factory.factory)(nam
       }
       return x.round(n.toNumber());
     },
-    // deep map collection, skip zeros since round(0) = 0
+    'Unit, number, Unit': typed.referToSelf(function (self) {
+      return function (x, n, unit) {
+        var valueless = x.toNumeric(unit);
+        return unit.multiply(self(valueless, n));
+      };
+    }),
+    'Unit, BigNumber, Unit': typed.referToSelf(function (self) {
+      return function (x, n, unit) {
+        return self(x, n.toNumber(), unit);
+      };
+    }),
+    'Unit, Unit': typed.referToSelf(function (self) {
+      return function (x, unit) {
+        return self(x, 0, unit);
+      };
+    }),
+    'Array | Matrix, number, Unit': typed.referToSelf(function (self) {
+      return function (x, n, unit) {
+        // deep map collection, skip zeros since round(0) = 0
+        return (0, _collection.deepMap)(x, function (value) {
+          return self(value, n, unit);
+        }, true);
+      };
+    }),
+    'Array | Matrix, BigNumber, Unit': typed.referToSelf(function (self) {
+      return function (x, n, unit) {
+        return self(x, n.toNumber(), unit);
+      };
+    }),
+    'Array | Matrix, Unit': typed.referToSelf(function (self) {
+      return function (x, unit) {
+        return self(x, 0, unit);
+      };
+    }),
     'Array | Matrix': typed.referToSelf(function (self) {
       return function (x) {
+        // deep map collection, skip zeros since round(0) = 0
         return (0, _collection.deepMap)(x, self, true);
       };
     }),
     'SparseMatrix, number | BigNumber': typed.referToSelf(function (self) {
-      return function (x, y) {
-        return matAlgo11xS0s(x, y, self, false);
+      return function (x, n) {
+        return matAlgo11xS0s(x, n, self, false);
       };
     }),
     'DenseMatrix, number | BigNumber': typed.referToSelf(function (self) {
-      return function (x, y) {
-        return matAlgo14xDs(x, y, self, false);
+      return function (x, n) {
+        return matAlgo14xDs(x, n, self, false);
       };
     }),
     'Array, number | BigNumber': typed.referToSelf(function (self) {
-      return function (x, y) {
+      return function (x, n) {
         // use matrix implementation
-        return matAlgo14xDs(matrix(x), y, self, false).valueOf();
+        return matAlgo14xDs(matrix(x), n, self, false).valueOf();
       };
     }),
     'number | Complex | BigNumber | Fraction, SparseMatrix': typed.referToSelf(function (self) {
-      return function (x, y) {
+      return function (x, n) {
         // check scalar is zero
         if (equalScalar(x, 0)) {
           // do not execute algorithm, result will be a zero matrix
-          return zeros(y.size(), y.storage());
+          return zeros(n.size(), n.storage());
         }
-        return matAlgo12xSfs(y, x, self, true);
+        return matAlgo12xSfs(n, x, self, true);
       };
     }),
     'number | Complex | BigNumber | Fraction, DenseMatrix': typed.referToSelf(function (self) {
-      return function (x, y) {
+      return function (x, n) {
         // check scalar is zero
         if (equalScalar(x, 0)) {
           // do not execute algorithm, result will be a zero matrix
-          return zeros(y.size(), y.storage());
+          return zeros(n.size(), n.storage());
         }
-        return matAlgo14xDs(y, x, self, true);
+        return matAlgo14xDs(n, x, self, true);
       };
     }),
     'number | Complex | BigNumber | Fraction, Array': typed.referToSelf(function (self) {
-      return function (x, y) {
+      return function (x, n) {
         // use matrix implementation
-        return matAlgo14xDs(matrix(y), x, self, true).valueOf();
+        return matAlgo14xDs(matrix(n), x, self, true).valueOf();
       };
     })
   });

package/lib/cjs/function/probability/pickRandom.js

@@ -56,8 +56,8 @@ var createPickRandom = exports.createPickRandom = /* #__PURE__ */(0, _factory.fa
    * @param {Array | Matrix} array     A one dimensional array
    * @param {Int} number               An int or float
    * @param {Array | Matrix} weights   An array of ints or floats
-   * @return {number | Array}          Returns a single random value from array when number is 1 or undefined.
-   *                                   Returns an array with the configured number of elements when number is > 1.
+   * @return {number | Array}          Returns a single random value from array when number is undefined.
+   *                                   Returns an array with the configured number of elements when number is defined.
    */
   return typed(name, {
     'Array | Matrix': function ArrayMatrix(possibles) {

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.0.0
- * @date    2023-10-26
+ * @version 12.1.0
+ * @date    2023-11-17
  *
  * @license
  * Copyright (C) 2013-2023 Jos de Jong <wjosdejong@gmail.com>

package/lib/cjs/type/number.js

@@ -49,7 +49,7 @@ function makeNumberFromNonDecimalParts(parts) {
   }
   var result = n + f;
   if (isNaN(result)) {
-    throw new SyntaxError('String "' + parts.input + '" is no valid number');
+    throw new SyntaxError('String "' + parts.input + '" is not a valid number');
   }
   return result;
 }
@@ -103,7 +103,7 @@ var createNumber = exports.createNumber = /* #__PURE__ */(0, _factory.factory)(n
       }
       var num = Number(x);
       if (isNaN(num)) {
-        throw new SyntaxError('String "' + x + '" is no valid number');
+        throw new SyntaxError('String "' + x + '" is not a valid number');
       }
       if (wordSizeSuffixMatch) {
         // x is a signed bin, oct, or hex literal

package/lib/cjs/utils/snapshot.js

@@ -18,12 +18,12 @@ function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /**
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          * This file contains helper methods to create expected snapshot structures
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          * of both instance and ES6 exports.
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          *
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          * The files are located here and not under /test or /tools so it's transpiled
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          * into ES5 code under /lib and can be used straight by node.js
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                          */
+ * This file contains helper methods to create expected snapshot structures
+ * of both instance and ES6 exports.
+ *
+ * The files are located here and not under /test or /tools so it's transpiled
+ * into ES5 code under /lib and can be used straight by node.js
+ */
 var validateTypeOf = exports.validateTypeOf = allIsFunctions.typeOf;
 function validateBundle(expectedBundleStructure, bundle) {
   var originalWarn = console.warn;

package/lib/cjs/version.js

@@ -4,6 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.version = void 0;
-var version = exports.version = '12.0.0';
+var version = exports.version = '12.1.0';
 // Note: This file is automatically generated when building math.js.
 // Changes made in this file will be overwritten.

package/lib/esm/expression/embeddedDocs/function/arithmetic/round.js

@@ -1,8 +1,8 @@
 export var roundDocs = {
   name: 'round',
   category: 'Arithmetic',
-  syntax: ['round(x)', 'round(x, n)'],
+  syntax: ['round(x)', 'round(x, n)', 'round(unit, valuelessUnit)', 'round(unit, n, valuelessUnit)'],
   description: 'round a value towards the nearest integer.If x is complex, both real and imaginary part are rounded towards the nearest integer. When n is specified, the value is rounded to n decimals.',
-  examples: ['round(3.2)', 'round(3.8)', 'round(-4.2)', 'round(-4.8)', 'round(pi, 3)', 'round(123.45678, 2)'],
+  examples: ['round(3.2)', 'round(3.8)', 'round(-4.2)', 'round(-4.8)', 'round(pi, 3)', 'round(123.45678, 2)', 'round(3.241cm, 2, cm)', 'round([3.2, 3.8, -4.7])'],
   seealso: ['ceil', 'floor', 'fix']
 };

package/lib/esm/function/algebra/derivative.js

@@ -208,9 +208,6 @@ export var createDerivative = /* #__PURE__ */factory(name, dependencies, _ref =>
       return _derivative(node.expr, constNodes);
     },
     'FunctionNode, Object': function FunctionNodeObject(node, constNodes) {
-      if (node.args.length !== 1) {
-        funcArgsCheck(node);
-      }
       if (constNodes[node] !== undefined) {
         return createConstantNode(0);
       }
@@ -259,9 +256,12 @@ export var createDerivative = /* #__PURE__ */factory(name, dependencies, _ref =>
           }
           break;
         case 'pow':
-          constNodes[arg1] = constNodes[node.args[1]];
-          // Pass to pow operator node parser
-          return _derivative(new OperatorNode('^', 'pow', [arg0, node.args[1]]), constNodes);
+          if (node.args.length === 2) {
+            constNodes[arg1] = constNodes[node.args[1]];
+            // Pass to pow operator node parser
+            return _derivative(new OperatorNode('^', 'pow', [arg0, node.args[1]]), constNodes);
+          }
+          break;
         case 'exp':
           // d/dx(e^x) = e^x
           funcDerivative = new FunctionNode('exp', [arg0.clone()]);
@@ -391,7 +391,7 @@ export var createDerivative = /* #__PURE__ */factory(name, dependencies, _ref =>
           break;
         case 'gamma': // Needs digamma function, d/dx(gamma(x)) = gamma(x)digamma(x)
         default:
-          throw new Error('Function "' + node.name + '" is not supported by derivative, or a wrong number of arguments is passed');
+          throw new Error('Cannot process function "' + node.name + '" in derivative: ' + 'the function is not supported, undefined, or the number of arguments passed to it are not supported');
       }
       var op, func;
       if (div) {
@@ -502,33 +502,10 @@ export var createDerivative = /* #__PURE__ */factory(name, dependencies, _ref =>
         // Functional Power Rule, d/dx(f^g) = f^g*[f'*(g/f) + g'ln(f)]
         return new OperatorNode('*', 'multiply', [new OperatorNode('^', 'pow', [_arg.clone(), _arg2.clone()]), new OperatorNode('+', 'add', [new OperatorNode('*', 'multiply', [_derivative(_arg, constNodes), new OperatorNode('/', 'divide', [_arg2.clone(), _arg.clone()])]), new OperatorNode('*', 'multiply', [_derivative(_arg2, constNodes), new FunctionNode('log', [_arg.clone()])])])]);
       }
-      throw new Error('Operator "' + node.op + '" is not supported by derivative, or a wrong number of arguments is passed');
+      throw new Error('Cannot process operator "' + node.op + '" in derivative: ' + 'the operator is not supported, undefined, or the number of arguments passed to it are not supported');
     }
   });
 
-  /**
-   * Ensures the number of arguments for a function are correct,
-   * and will throw an error otherwise.
-   *
-   * @param {FunctionNode} node
-   */
-  function funcArgsCheck(node) {
-    // TODO add min, max etc
-    if ((node.name === 'log' || node.name === 'nthRoot' || node.name === 'pow') && node.args.length === 2) {
-      return;
-    }
-
-    // There should be an incorrect number of arguments if we reach here
-
-    // Change all args to constants to avoid unidentified
-    // symbol error when compiling function
-    for (var i = 0; i < node.args.length; ++i) {
-      node.args[i] = createConstantNode(0);
-    }
-    node.compile().evaluate();
-    throw new Error('Function "' + node.name + '" is not supported by derivative, or a wrong number of arguments is passed');
-  }
-
   /**
    * Helper function to create a constant node with a specific type
    * (number, BigNumber, Fraction)

package/lib/esm/function/arithmetic/mod.js

@@ -91,17 +91,10 @@ export var createMod = /* #__PURE__ */factory(name, dependencies, _ref => {
   return typed(name, {
     'number, number': _modNumber,
     'BigNumber, BigNumber': function BigNumberBigNumber(x, y) {
-      if (y.isNeg()) {
-        throw new Error('Cannot calculate mod for a negative divisor');
-      }
-      return y.isZero() ? x : x.mod(y);
+      return y.isZero() ? x : x.sub(y.mul(floor(x.div(y))));
     },
     'Fraction, Fraction': function FractionFraction(x, y) {
-      if (y.compare(0) < 0) {
-        throw new Error('Cannot calculate mod for a negative divisor');
-      }
-      // Workaround suggested in Fraction.js library to calculate correct modulo for negative dividend
-      return x.compare(0) >= 0 ? x.mod(y) : x.mod(y).add(y).mod(y);
+      return y.equals(0) ? x : x.sub(y.mul(floor(x.div(y))));
     }
   }, matrixAlgorithmSuite({
     SS: matAlgo05xSfSf,

package/lib/esm/function/arithmetic/round.js

@@ -36,6 +36,8 @@ export var createRound = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    math.round(x)
    *    math.round(x, n)
+   *    math.round(unit, valuelessUnit)
+   *    math.round(unit, n, valuelessUnit)
    *
    * Examples:
    *
@@ -53,14 +55,21 @@ export var createRound = /* #__PURE__ */factory(name, dependencies, _ref => {
    *    const c = math.complex(3.2, -2.7)
    *    math.round(c)                // returns Complex 3 - 3i
    *
+   *    const unit = math.unit('3.241 cm')
+   *    const cm = math.unit('cm')
+   *    const mm = math.unit('mm')
+   *    math.round(unit, 1, cm)      // returns Unit 3.2 cm
+   *    math.round(unit, 1, mm)      // returns Unit 32.4 mm
+   *
    *    math.round([3.2, 3.8, -4.7]) // returns Array [3, 4, -5]
    *
    * See also:
    *
    *    ceil, fix, floor
    *
-   * @param  {number | BigNumber | Fraction | Complex | Array | Matrix} x  Number to be rounded
+   * @param  {number | BigNumber | Fraction | Complex | Unit | Array | Matrix} x  Value to be rounded
    * @param  {number | BigNumber | Array} [n=0]                            Number of decimals
+   * @param  {Unit} [valuelessUnit]                                        A valueless unit
    * @return {number | BigNumber | Fraction | Complex | Array | Matrix} Rounded value
    */
   return typed(name, {
@@ -112,37 +121,51 @@ export var createRound = /* #__PURE__ */factory(name, dependencies, _ref => {
       }
       return x.round(n.toNumber());
     },
-    // deep map collection, skip zeros since round(0) = 0
-    'Array | Matrix': typed.referToSelf(self => x => deepMap(x, self, true)),
-    'SparseMatrix, number | BigNumber': typed.referToSelf(self => (x, y) => {
-      return matAlgo11xS0s(x, y, self, false);
+    'Unit, number, Unit': typed.referToSelf(self => function (x, n, unit) {
+      var valueless = x.toNumeric(unit);
+      return unit.multiply(self(valueless, n));
+    }),
+    'Unit, BigNumber, Unit': typed.referToSelf(self => (x, n, unit) => self(x, n.toNumber(), unit)),
+    'Unit, Unit': typed.referToSelf(self => (x, unit) => self(x, 0, unit)),
+    'Array | Matrix, number, Unit': typed.referToSelf(self => (x, n, unit) => {
+      // deep map collection, skip zeros since round(0) = 0
+      return deepMap(x, value => self(value, n, unit), true);
+    }),
+    'Array | Matrix, BigNumber, Unit': typed.referToSelf(self => (x, n, unit) => self(x, n.toNumber(), unit)),
+    'Array | Matrix, Unit': typed.referToSelf(self => (x, unit) => self(x, 0, unit)),
+    'Array | Matrix': typed.referToSelf(self => x => {
+      // deep map collection, skip zeros since round(0) = 0
+      return deepMap(x, self, true);
+    }),
+    'SparseMatrix, number | BigNumber': typed.referToSelf(self => (x, n) => {
+      return matAlgo11xS0s(x, n, self, false);
     }),
-    'DenseMatrix, number | BigNumber': typed.referToSelf(self => (x, y) => {
-      return matAlgo14xDs(x, y, self, false);
+    'DenseMatrix, number | BigNumber': typed.referToSelf(self => (x, n) => {
+      return matAlgo14xDs(x, n, self, false);
     }),
-    'Array, number | BigNumber': typed.referToSelf(self => (x, y) => {
+    'Array, number | BigNumber': typed.referToSelf(self => (x, n) => {
       // use matrix implementation
-      return matAlgo14xDs(matrix(x), y, self, false).valueOf();
+      return matAlgo14xDs(matrix(x), n, self, false).valueOf();
     }),
-    'number | Complex | BigNumber | Fraction, SparseMatrix': typed.referToSelf(self => (x, y) => {
+    'number | Complex | BigNumber | Fraction, SparseMatrix': typed.referToSelf(self => (x, n) => {
       // check scalar is zero
       if (equalScalar(x, 0)) {
         // do not execute algorithm, result will be a zero matrix
-        return zeros(y.size(), y.storage());
+        return zeros(n.size(), n.storage());
       }
-      return matAlgo12xSfs(y, x, self, true);
+      return matAlgo12xSfs(n, x, self, true);
     }),
-    'number | Complex | BigNumber | Fraction, DenseMatrix': typed.referToSelf(self => (x, y) => {
+    'number | Complex | BigNumber | Fraction, DenseMatrix': typed.referToSelf(self => (x, n) => {
       // check scalar is zero
       if (equalScalar(x, 0)) {
         // do not execute algorithm, result will be a zero matrix
-        return zeros(y.size(), y.storage());
+        return zeros(n.size(), n.storage());
       }
-      return matAlgo14xDs(y, x, self, true);
+      return matAlgo14xDs(n, x, self, true);
     }),
-    'number | Complex | BigNumber | Fraction, Array': typed.referToSelf(self => (x, y) => {
+    'number | Complex | BigNumber | Fraction, Array': typed.referToSelf(self => (x, n) => {
       // use matrix implementation
-      return matAlgo14xDs(matrix(y), x, self, true).valueOf();
+      return matAlgo14xDs(matrix(n), x, self, true).valueOf();
     })
   });
 });

package/lib/esm/function/probability/pickRandom.js

@@ -52,8 +52,8 @@ export var createPickRandom = /* #__PURE__ */factory(name, dependencies, _ref =>
    * @param {Array | Matrix} array     A one dimensional array
    * @param {Int} number               An int or float
    * @param {Array | Matrix} weights   An array of ints or floats
-   * @return {number | Array}          Returns a single random value from array when number is 1 or undefined.
-   *                                   Returns an array with the configured number of elements when number is > 1.
+   * @return {number | Array}          Returns a single random value from array when number is undefined.
+   *                                   Returns an array with the configured number of elements when number is defined.
    */
   return typed(name, {
     'Array | Matrix': function ArrayMatrix(possibles) {

package/lib/esm/type/number.js

@@ -43,7 +43,7 @@ function makeNumberFromNonDecimalParts(parts) {
   }
   var result = n + f;
   if (isNaN(result)) {
-    throw new SyntaxError('String "' + parts.input + '" is no valid number');
+    throw new SyntaxError('String "' + parts.input + '" is not a valid number');
   }
   return result;
 }
@@ -99,7 +99,7 @@ export var createNumber = /* #__PURE__ */factory(name, dependencies, _ref => {
       }
       var num = Number(x);
       if (isNaN(num)) {
-        throw new SyntaxError('String "' + x + '" is no valid number');
+        throw new SyntaxError('String "' + x + '" is not a valid number');
       }
       if (wordSizeSuffixMatch) {
         // x is a signed bin, oct, or hex literal

package/lib/esm/version.js

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