mathjs 11.8.0 → 11.8.2

package/lib/cjs/utils/applyCallback.js

@@ -0,0 +1,73 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyCallback = applyCallback;
+var _typedFunction = _interopRequireDefault(require("typed-function"));
+var _is = require("./is.js");
+/**
+ * Invoke a callback for functions like map and filter with a matching number of arguments
+ * @param {function} callback
+ * @param {any} value
+ * @param {number | number[]} index
+ * @param {Array} array
+ * @param {string} mappingFnName   The name of the function that is invoking these callbacks, for example "map" or "filter"
+ * @returns {*}
+ */
+function applyCallback(callback, value, index, array, mappingFnName) {
+  if (_typedFunction["default"].isTypedFunction(callback)) {
+    // invoke the typed callback function with the matching number of arguments only
+
+    var args3 = [value, index, array];
+    var signature3 = _typedFunction["default"].resolve(callback, args3);
+    if (signature3) {
+      return tryWithArgs(signature3.implementation, args3);
+    }
+    var args2 = [value, index];
+    var signature2 = _typedFunction["default"].resolve(callback, args2);
+    if (signature2) {
+      return tryWithArgs(signature2.implementation, args2);
+    }
+    var args1 = [value];
+    var signature1 = _typedFunction["default"].resolve(callback, args1);
+    if (signature1) {
+      return tryWithArgs(signature1.implementation, args1);
+    }
+
+    // fallback (will throw an exception)
+    return tryWithArgs(callback, args3);
+  } else {
+    // A regular JavaScript function
+    return callback(value, index, array);
+  }
+
+  /**
+   * @param {function} signature The selected signature of the typed-function
+   * @param {Array} args List with arguments to apply to the selected signature
+   * @returns {*} Returns the return value of the invoked signature
+   * @throws {TypeError} Throws an error when no matching signature was found
+   */
+  function tryWithArgs(signature, args) {
+    try {
+      return signature.apply(signature, args);
+    } catch (err) {
+      var _err$data;
+      // Enrich the error message so the user understands that it took place inside the callback function
+      if (err instanceof TypeError && ((_err$data = err.data) === null || _err$data === void 0 ? void 0 : _err$data.category) === 'wrongType') {
+        var argsDesc = [];
+        argsDesc.push("value: ".concat((0, _is.typeOf)(value)));
+        if (args.length >= 2) {
+          argsDesc.push("index: ".concat((0, _is.typeOf)(index)));
+        }
+        if (args.length >= 3) {
+          argsDesc.push("array: ".concat((0, _is.typeOf)(array)));
+        }
+        throw new TypeError("Function ".concat(mappingFnName, " cannot apply callback arguments ") + "".concat(callback.name, "(").concat(argsDesc.join(', '), ") at index ").concat(JSON.stringify(index)));
+      } else {
+        throw new TypeError("Function ".concat(mappingFnName, " cannot apply callback arguments ") + "to function ".concat(callback.name, ": ").concat(err.message));
+      }
+    }
+  }
+}

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

@@ -154,7 +154,7 @@ function format(value, options) {
     // determine precision from options
     if (typeof options === 'number') {
       precision = options;
-    } else if (options.precision) {
+    } else if (options.precision !== undefined) {
       precision = options.precision;
     }
     if (options.wordSize) {
@@ -215,7 +215,7 @@ function format(value, options) {
 
 /**
  * Format a BigNumber in engineering notation. Like '1.23e+6', '2.3e+0', '3.500e-3'
- * @param {BigNumber | string} value
+ * @param {BigNumber} value
  * @param {number} [precision]        Optional number of significant figures to return.
  */
 function toEngineering(value, precision) {
@@ -227,7 +227,8 @@ function toEngineering(value, precision) {
   var valueWithoutExp = value.mul(Math.pow(10, -newExp));
   var valueStr = valueWithoutExp.toPrecision(precision);
   if (valueStr.indexOf('e') !== -1) {
-    valueStr = valueWithoutExp.toString();
+    var BigNumber = value.constructor;
+    valueStr = new BigNumber(valueStr).toFixed();
   }
   return valueStr + 'e' + (e >= 0 ? '+' : '') + newExp.toString();
 }

package/lib/cjs/version.js

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

package/lib/esm/entry/dependenciesAny/dependenciesDistance.generated.js

@@ -4,21 +4,21 @@
  */
 import { absDependencies } from './dependenciesAbs.generated.js';
 import { addScalarDependencies } from './dependenciesAddScalar.generated.js';
+import { deepEqualDependencies } from './dependenciesDeepEqual.generated.js';
 import { divideScalarDependencies } from './dependenciesDivideScalar.generated.js';
 import { multiplyScalarDependencies } from './dependenciesMultiplyScalar.generated.js';
 import { sqrtDependencies } from './dependenciesSqrt.generated.js';
 import { subtractDependencies } from './dependenciesSubtract.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
-import { unaryMinusDependencies } from './dependenciesUnaryMinus.generated.js';
 import { createDistance } from '../../factoriesAny.js';
 export var distanceDependencies = {
   absDependencies,
   addScalarDependencies,
+  deepEqualDependencies,
   divideScalarDependencies,
   multiplyScalarDependencies,
   sqrtDependencies,
   subtractDependencies,
   typedDependencies,
-  unaryMinusDependencies,
   createDistance
 };

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

@@ -875,12 +875,12 @@ export var diff = /* #__PURE__ */createDiff({
 export var distance = /* #__PURE__ */createDistance({
   abs,
   addScalar,
+  deepEqual,
   divideScalar,
   multiplyScalar,
   sqrt,
   subtract,
-  typed,
-  unaryMinus
+  typed
 });
 export var dotMultiply = /* #__PURE__ */createDotMultiply({
   concat,

package/lib/esm/expression/Parser.js

@@ -40,7 +40,7 @@ export var createParserClass = /* #__PURE__ */factory(name, dependencies, _ref =
    *    parser.evaluate('f(2, 3)')                // 8
    *
    *    // get and set variables and functions
-   *    const x = parser.get('x')                 // 7
+   *    const x = parser.get('x')                 // 3.5
    *    const f = parser.get('f')                 // function
    *    const g = f(3, 2)                         // 9
    *    parser.set('h', 500)

package/lib/esm/expression/function/parser.js

@@ -30,7 +30,7 @@ export var createParser = /* #__PURE__ */factory(name, dependencies, _ref => {
    *     parser.evaluate('f(2, 3)')               // 8
    *
    *     // get and set variables and functions
-   *     const x = parser.get('x')                // 7
+   *     const x = parser.get('x')                // 3.5
    *     const f = parser.get('f')                // function
    *     const g = f(3, 2)                        // 9
    *     parser.set('h', 500)

package/lib/esm/expression/transform/filter.transform.js

@@ -1,8 +1,8 @@
-import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
+import { applyCallback } from '../../utils/applyCallback.js';
 import { filter, filterRegExp } from '../../utils/array.js';
-import { maxArgumentCount } from '../../utils/function.js';
-import { compileInlineExpression } from './utils/compileInlineExpression.js';
 import { factory } from '../../utils/factory.js';
+import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
+import { compileInlineExpression } from './utils/compileInlineExpression.js';
 var name = 'filter';
 var dependencies = ['typed'];
 export var createFilterTransform = /* #__PURE__ */factory(name, dependencies, _ref => {
@@ -61,17 +61,8 @@ export var createFilterTransform = /* #__PURE__ */factory(name, dependencies, _r
  * @private
  */
 function _filter(x, callback) {
-  // figure out what number of arguments the callback function expects
-  var args = maxArgumentCount(callback);
   return filter(x, function (value, index, array) {
     // invoke the callback function with the right number of arguments
-    if (args === 1) {
-      return callback(value);
-    } else if (args === 2) {
-      return callback(value, [index + 1]);
-    } else {
-      // 3 or -1
-      return callback(value, [index + 1], array);
-    }
+    return applyCallback(callback, value, [index + 1], array, 'filter');
   });
 }

package/lib/esm/expression/transform/forEach.transform.js

@@ -1,7 +1,7 @@
-import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
-import { maxArgumentCount } from '../../utils/function.js';
+import { applyCallback } from '../../utils/applyCallback.js';
 import { forEach } from '../../utils/array.js';
 import { factory } from '../../utils/factory.js';
+import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
 import { compileInlineExpression } from './utils/compileInlineExpression.js';
 var name = 'forEach';
 var dependencies = ['typed'];
@@ -36,8 +36,6 @@ export var createForEachTransform = /* #__PURE__ */factory(name, dependencies, _
   // one-based version of forEach
   var _forEach = typed('forEach', {
     'Array | Matrix, function': function ArrayMatrixFunction(array, callback) {
-      // figure out what number of arguments the callback function expects
-      var args = maxArgumentCount(callback);
       var recurse = function recurse(value, index) {
         if (Array.isArray(value)) {
           forEach(value, function (child, i) {
@@ -46,14 +44,7 @@ export var createForEachTransform = /* #__PURE__ */factory(name, dependencies, _
           });
         } else {
           // invoke the callback function with the right number of arguments
-          if (args === 1) {
-            callback(value);
-          } else if (args === 2) {
-            callback(value, index);
-          } else {
-            // 3 or -1
-            callback(value, index, array);
-          }
+          return applyCallback(callback, value, index, array, 'forEach');
         }
       };
       recurse(array.valueOf(), []); // pass Array

package/lib/esm/expression/transform/map.transform.js

@@ -1,7 +1,7 @@
-import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
-import { maxArgumentCount } from '../../utils/function.js';
+import { applyCallback } from '../../utils/applyCallback.js';
 import { map } from '../../utils/array.js';
 import { factory } from '../../utils/factory.js';
+import { isFunctionAssignmentNode, isSymbolNode } from '../../utils/is.js';
 import { compileInlineExpression } from './utils/compileInlineExpression.js';
 var name = 'map';
 var dependencies = ['typed'];
@@ -48,7 +48,7 @@ export var createMapTransform = /* #__PURE__ */factory(name, dependencies, _ref
 });
 
 /**
- * Map for a multi dimensional array. One-based indexes
+ * Map for a multidimensional array. One-based indexes
  * @param {Array} array
  * @param {function} callback
  * @param {Array} orig
@@ -56,8 +56,6 @@ export var createMapTransform = /* #__PURE__ */factory(name, dependencies, _ref
  * @private
  */
 function _map(array, callback, orig) {
-  // figure out what number of arguments the callback function expects
-  var argsCount = maxArgumentCount(callback);
   function recurse(value, index) {
     if (Array.isArray(value)) {
       return map(value, function (child, i) {
@@ -66,14 +64,7 @@ function _map(array, callback, orig) {
       });
     } else {
       // invoke the (typed) callback function with the right number of arguments
-      if (argsCount === 1) {
-        return callback(value);
-      } else if (argsCount === 2) {
-        return callback(value, index);
-      } else {
-        // 3 or -1
-        return callback(value, index, orig);
-      }
+      return applyCallback(callback, value, index, orig, 'map');
     }
   }
   return recurse(array, []);

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

@@ -29,8 +29,8 @@ export var createDerivative = /* #__PURE__ */factory(name, dependencies, _ref =>
    *
    * Syntax:
    *
-   *     derivative(expr, variable)
-   *     derivative(expr, variable, options)
+   *     math.derivative(expr, variable)
+   *     math.derivative(expr, variable, options)
    *
    * Examples:
    *

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

@@ -29,7 +29,7 @@ export var createLeafCount = /* #__PURE__ */factory(name, dependencies, _ref =>
    *
    * Syntax:
    *
-   *     leafCount(expr)
+   *     math.leafCount(expr)
    *
    * Examples:
    *

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

@@ -24,7 +24,7 @@ export var createPolynomialRoot = /* #__PURE__ */factory(name, dependencies, _re
    *
    * Syntax:
    *
-   *     polynomialRoot(constant, linearCoeff, quadraticCoeff, cubicCoeff)
+   *     math.polynomialRoot(constant, linearCoeff, quadraticCoeff, cubicCoeff)
    *
    * Examples:
    *     // linear

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

@@ -39,10 +39,10 @@ export var createRationalize = /* #__PURE__ */factory(name, dependencies, _ref =
    *
    * Syntax:
    *
-   *     rationalize(expr)
-   *     rationalize(expr, detailed)
-   *     rationalize(expr, scope)
-   *     rationalize(expr, scope, detailed)
+   *     math.rationalize(expr)
+   *     math.rationalize(expr, detailed)
+   *     math.rationalize(expr, scope)
+   *     math.rationalize(expr, scope, detailed)
    *
    * Examples:
    *

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

@@ -17,7 +17,7 @@ export var createResolve = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Syntax:
    *
-   *     resolve(expr, scope)
+   *     math.resolve(expr, scope)
    *
    * Examples:
    *

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

@@ -138,13 +138,13 @@ export var createSimplify = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Syntax:
    *
-   *     simplify(expr)
-   *     simplify(expr, rules)
-   *     simplify(expr, rules)
-   *     simplify(expr, rules, scope)
-   *     simplify(expr, rules, scope, options)
-   *     simplify(expr, scope)
-   *     simplify(expr, scope, options)
+   *     math.simplify(expr)
+   *     math.simplify(expr, rules)
+   *     math.simplify(expr, rules)
+   *     math.simplify(expr, rules, scope)
+   *     math.simplify(expr, rules, scope, options)
+   *     math.simplify(expr, scope)
+   *     math.simplify(expr, scope, options)
    *
    * Examples:
    *

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

@@ -40,8 +40,8 @@ export var createSimplifyConstant = /* #__PURE__ */factory(name, dependencies, _
    *
    * Syntax:
    *
-   *     simplifyConstant(expr)
-   *     simplifyConstant(expr, options)
+   *     math.simplifyConstant(expr)
+   *     math.simplifyConstant(expr, options)
    *
    * Examples:
    *

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

@@ -67,8 +67,8 @@ export var createSimplifyCore = /* #__PURE__ */factory(name, dependencies, _ref
    *
    * Syntax:
    *
-   *     simplifyCore(expr)
-   *     simplifyCore(expr, options)
+   *     math.simplifyCore(expr)
+   *     math.simplifyCore(expr, options)
    *
    * Examples:
    *

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

@@ -25,20 +25,20 @@ export var createSymbolicEqual = /* #__PURE__ */factory(name, dependencies, _ref
    *
    * Syntax:
    *
-   *    symbolicEqual(expr1, expr2)
-   *    symbolicEqual(expr1, expr2, options)
+   *     math.symbolicEqual(expr1, expr2)
+   *     math.symbolicEqual(expr1, expr2, options)
    *
    * Examples:
    *
-   *    symbolicEqual('x*y', 'y*x') // Returns true
-   *    symbolicEqual('x*y', 'y*x', {context: {multiply: {commutative: false}}}) // Returns false
-   *    symbolicEqual('x/y', '(y*x^(-1))^(-1)') // Returns true
-   *    symbolicEqual('abs(x)','x') // Returns false
-   *    symbolicEqual('abs(x)','x', simplify.positiveContext) // Returns true
+   *     math.symbolicEqual('x*y', 'y*x') // Returns true
+   *     math.symbolicEqual('x*y', 'y*x', {context: {multiply: {commutative: false}}}) // Returns false
+   *     math.symbolicEqual('x/y', '(y*x^(-1))^(-1)') // Returns true
+   *     math.symbolicEqual('abs(x)','x') // Returns false
+   *     math.symbolicEqual('abs(x)','x', simplify.positiveContext) // Returns true
    *
    * See also:
    *
-   *    simplify, evaluate
+   *     simplify, evaluate
    *
    * @param {Node|string} expr1  The first expression to compare
    * @param {Node|string} expr2  The second expression to compare

package/lib/esm/function/geometry/distance.js

@@ -1,7 +1,7 @@
 import { isBigNumber } from '../../utils/is.js';
 import { factory } from '../../utils/factory.js';
 var name = 'distance';
-var dependencies = ['typed', 'addScalar', 'subtract', 'divideScalar', 'multiplyScalar', 'unaryMinus', 'sqrt', 'abs'];
+var dependencies = ['typed', 'addScalar', 'subtract', 'divideScalar', 'multiplyScalar', 'deepEqual', 'sqrt', 'abs'];
 export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
   var {
     typed,
@@ -9,7 +9,7 @@ export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
     subtract,
     multiplyScalar,
     divideScalar,
-    unaryMinus,
+    deepEqual,
     sqrt,
     abs
   } = _ref;
@@ -31,10 +31,10 @@ export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
     *    math.distance([x1,y1,z1,a1], [x2,y2,z2,a2])
     *    math.distance([[x1,y1], [x2,y2], [x3,y3]])
     *    math.distance([[x1,y1,z1], [x2,y2,z2], [x3,y3,z3]])
-    *    math.distance([x1,y1], [x2,y2,z2])
-    *    math.distance([x1,y1], [x2,y2], [x3,y3])
+    *    math.distance([pointX,pointY], [a,b,c])
+    *    math.distance([pointX,pointY], [lineOnePtX,lineOnePtY], [lineTwoPtX,lineTwoPtY])
     *    math.distance({pointX, pointY}, {lineOnePtX, lineOnePtY}, {lineTwoPtX, lineTwoPtY})
-    *    math.distance([x1,y1,z1], [x0, y0, z0, a, b, c])
+    *    math.distance([pointX,pointY,pointZ], [x0, y0, z0, a, b, c])
     *    math.distance({pointX, pointY, pointZ}, {x0, y0, z0, a, b, c})
     *
     * Examples:
@@ -50,11 +50,11 @@ export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
     *    math.distance([[1, 2], [1, 2], [1, 3]])         // Returns [0, 1, 1]
     *    math.distance([[1,2,4], [1,2,6], [8,1,3]])      // Returns [2, 7.14142842854285, 7.681145747868608]
     *    math.distance([10, 10], [8, 1, 3])              // Returns 11.535230316796387
-    *    math.distance([10, 10], [2, 3], [-8, 0])        // Returns 8.759953130362847
+    *    math.distance([0, 0], [3, 0], [0, 4])        // Returns 2.4
     *    math.distance(
-    *     {pointX: 1, pointY: 4},
-    *     {lineOnePtX: 6, lineOnePtY: 3},
-    *     {lineTwoPtX: 2, lineTwoPtY: 8})                // Returns 2.720549372624744
+    *     {pointX: 0, pointY: 0},
+    *     {lineOnePtX: 3, lineOnePtY: 0},
+    *     {lineTwoPtX: 0, lineTwoPtY: 4})                // Returns 2.4
     *    math.distance([2, 3, 1], [1, 1, 2, 5, 0, 1])    // Returns 2.3204774044612857
     *    math.distance(
     *     {pointX: 2, pointY: 3, pointZ: 1},
@@ -77,10 +77,12 @@ export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
         if (!_2d(z)) {
           throw new TypeError('Array with 2 numbers or BigNumbers expected for third argument');
         }
-        var m = divideScalar(subtract(z[1], z[0]), subtract(y[1], y[0]));
-        var xCoeff = multiplyScalar(multiplyScalar(m, m), y[0]);
-        var yCoeff = unaryMinus(multiplyScalar(m, y[0]));
-        var constant = x[1];
+        if (deepEqual(y, z)) {
+          throw new TypeError('LinePoint1 should not be same with LinePoint2');
+        }
+        var xCoeff = subtract(z[1], y[1]);
+        var yCoeff = subtract(y[0], z[0]);
+        var constant = subtract(multiplyScalar(z[0], y[1]), multiplyScalar(y[0], z[1]));
         return _distancePointLine2D(x[0], x[1], xCoeff, yCoeff, constant);
       } else {
         throw new TypeError('Invalid Arguments: Try again');
@@ -97,11 +99,13 @@ export var createDistance = /* #__PURE__ */factory(name, dependencies, _ref => {
         if (!_2d(z)) {
           throw new TypeError('Values of lineTwoPtX and lineTwoPtY should be numbers or BigNumbers');
         }
+        if (deepEqual(_objectToArray(y), _objectToArray(z))) {
+          throw new TypeError('LinePoint1 should not be same with LinePoint2');
+        }
         if ('pointX' in x && 'pointY' in x && 'lineOnePtX' in y && 'lineOnePtY' in y && 'lineTwoPtX' in z && 'lineTwoPtY' in z) {
-          var m = divideScalar(subtract(z.lineTwoPtY, z.lineTwoPtX), subtract(y.lineOnePtY, y.lineOnePtX));
-          var xCoeff = multiplyScalar(multiplyScalar(m, m), y.lineOnePtX);
-          var yCoeff = unaryMinus(multiplyScalar(m, y.lineOnePtX));
-          var constant = x.pointX;
+          var xCoeff = subtract(z.lineTwoPtY, y.lineOnePtY);
+          var yCoeff = subtract(y.lineOnePtX, z.lineTwoPtX);
+          var constant = subtract(multiplyScalar(z.lineTwoPtX, y.lineOnePtY), multiplyScalar(y.lineOnePtX, z.lineTwoPtY));
           return _distancePointLine2D(x.pointX, x.pointY, xCoeff, yCoeff, constant);
         } else {
           throw new TypeError('Key names do not match');

package/lib/esm/function/matrix/filter.js

@@ -1,5 +1,5 @@
+import { applyCallback } from '../../utils/applyCallback.js';
 import { filter, filterRegExp } from '../../utils/array.js';
-import { maxArgumentCount } from '../../utils/function.js';
 import { factory } from '../../utils/factory.js';
 var name = 'filter';
 var dependencies = ['typed'];
@@ -56,17 +56,8 @@ export var createFilter = /* #__PURE__ */factory(name, dependencies, _ref => {
  * @private
  */
 function _filterCallback(x, callback) {
-  // figure out what number of arguments the callback function expects
-  var args = maxArgumentCount(callback);
   return filter(x, function (value, index, array) {
     // invoke the callback function with the right number of arguments
-    if (args === 1) {
-      return callback(value);
-    } else if (args === 2) {
-      return callback(value, [index]);
-    } else {
-      // 3 or -1
-      return callback(value, [index], array);
-    }
+    return applyCallback(callback, value, [index], array, 'filter');
   });
 }

package/lib/esm/function/matrix/forEach.js

@@ -1,4 +1,4 @@
-import { maxArgumentCount } from '../../utils/function.js';
+import { applyCallback } from '../../utils/applyCallback.js';
 import { forEach as forEachArray } from '../../utils/array.js';
 import { factory } from '../../utils/factory.js';
 var name = 'forEach';
@@ -39,14 +39,12 @@ export var createForEach = /* #__PURE__ */factory(name, dependencies, _ref => {
 });
 
 /**
- * forEach for a multi dimensional array
+ * forEach for a multidimensional array
  * @param {Array} array
  * @param {Function} callback
  * @private
  */
 function _forEach(array, callback) {
-  // figure out what number of arguments the callback function expects
-  var args = maxArgumentCount(callback);
   var recurse = function recurse(value, index) {
     if (Array.isArray(value)) {
       forEachArray(value, function (child, i) {
@@ -55,14 +53,7 @@ function _forEach(array, callback) {
       });
     } else {
       // invoke the callback function with the right number of arguments
-      if (args === 1) {
-        callback(value);
-      } else if (args === 2) {
-        callback(value, index);
-      } else {
-        // 3 or -1
-        callback(value, index, array);
-      }
+      return applyCallback(callback, value, index, array, 'forEach');
     }
   };
   recurse(array, []);

package/lib/esm/function/matrix/map.js

@@ -1,4 +1,4 @@
-import { maxArgumentCount } from '../../utils/function.js';
+import { applyCallback } from '../../utils/applyCallback.js';
 import { factory } from '../../utils/factory.js';
 var name = 'map';
 var dependencies = ['typed'];
@@ -27,14 +27,9 @@ export var createMap = /* #__PURE__ */factory(name, dependencies, _ref => {
    *      return value * value
    *    })  // returns [1, 4, 9]
    *
-   *    // The calling convention for the callback can cause subtleties:
-   *    math.map([1, 2, 3], math.format)
-   *    // throws TypeError: map attempted to call 'format(1,[0])' but argument 2 of type Array does not match expected type number or function or Object or string or boolean
-   *    // [This happens because `format` _can_ take a second argument,
-   *    // but its semantics don't match that of the 2nd argument `map` provides]
-   *
-   *    // To avoid this error, use a function that takes exactly the
-   *    // desired arguments:
+   *    // The callback is normally called with three arguments:
+   *    //    callback(value, index, Array)
+   *    // If you want to call with only one argument, use:
    *    math.map([1, 2, 3], x => math.format(x)) // returns ['1', '2', '3']
    *
    * See also:
@@ -63,8 +58,6 @@ export var createMap = /* #__PURE__ */factory(name, dependencies, _ref => {
  * @private
  */
 function _map(array, callback) {
-  // figure out what number of arguments the callback function expects
-  var args = maxArgumentCount(callback);
   var recurse = function recurse(value, index) {
     if (Array.isArray(value)) {
       return value.map(function (child, i) {
@@ -72,33 +65,8 @@ function _map(array, callback) {
         return recurse(child, index.concat(i));
       });
     } else {
-      try {
-        // invoke the callback function with the right number of arguments
-        if (args === 1) {
-          return callback(value);
-        } else if (args === 2) {
-          return callback(value, index);
-        } else {
-          // 3 or -1
-          return callback(value, index, array);
-        }
-      } catch (err) {
-        // But maybe the arguments still weren't right
-        if (err instanceof TypeError && 'data' in err && err.data.category === 'wrongType') {
-          var newmsg = "map attempted to call '".concat(err.data.fn, "(").concat(value);
-          var indexString = JSON.stringify(index);
-          if (args === 2) {
-            newmsg += ',' + indexString;
-          } else if (args !== 1) {
-            newmsg += ",".concat(indexString, ",").concat(array);
-          }
-          newmsg += ")' but argument ".concat(err.data.index + 1, " of type ");
-          newmsg += "".concat(err.data.actual, " does not match expected type ");
-          newmsg += err.data.expected.join(' or ');
-          throw new TypeError(newmsg);
-        }
-        throw err;
-      }
+      // invoke the callback function with the right number of arguments
+      return applyCallback(callback, value, index, array, 'map');
     }
   };
   return recurse(array, []);

package/lib/esm/function/matrix/sqrtm.js

@@ -55,7 +55,7 @@ export var createSqrtm = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Syntax:
    *
-   *     X = math.sqrtm(A)
+   *     math.sqrtm(A)
    *
    * Examples:
    *