mathjs 14.6.0 → 14.7.0

package/lib/cjs/core/function/config.js

@@ -23,7 +23,6 @@ function configFactory(config, emit) {
    *
    * Examples:
    *
-   *
    *     import { create, all } from 'mathjs'
    *
    *     // create a mathjs instance

package/lib/cjs/expression/Parser.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.createParserClass = void 0;
 var _factory = require("../utils/factory.js");
+var _is = require("../utils/is.js");
 var _map = require("../utils/map.js");
 const name = 'Parser';
 const dependencies = ['evaluate', 'parse'];
@@ -160,7 +161,40 @@ const createParserClass = exports.createParserClass = /* #__PURE__ */(0, _factor
   Parser.prototype.clear = function () {
     this.scope.clear();
   };
+  Parser.prototype.toJSON = function () {
+    const json = {
+      mathjs: 'Parser',
+      variables: {},
+      functions: {}
+    };
+    for (const [name, value] of this.scope) {
+      if ((0, _is.isFunction)(value)) {
+        if (!isExpressionFunction(value)) {
+          throw new Error(`Cannot serialize external function ${name}`);
+        }
+        json.functions[name] = `${value.syntax} = ${value.expr}`;
+      } else {
+        json.variables[name] = value;
+      }
+    }
+    return json;
+  };
+  Parser.fromJSON = function (json) {
+    const parser = new Parser();
+    Object.entries(json.variables).forEach(_ref2 => {
+      let [name, value] = _ref2;
+      return parser.set(name, value);
+    });
+    Object.entries(json.functions).forEach(_ref3 => {
+      let [_name, fn] = _ref3;
+      return parser.evaluate(fn);
+    });
+    return parser;
+  };
   return Parser;
 }, {
   isClass: true
-});
+});
+function isExpressionFunction(value) {
+  return typeof value === 'function' && typeof value.syntax === 'string' && typeof value.expr === 'string';
+}

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

@@ -105,7 +105,8 @@ const createFunctionAssignmentNode = exports.createFunctionAssignmentNode = /* #
       });
 
       // compile the function expression with the child args
-      const evalExpr = this.expr._compile(math, childArgNames);
+      const expr = this.expr;
+      const evalExpr = expr._compile(math, childArgNames);
       const name = this.name;
       const params = this.params;
       const signature = (0, _array.join)(this.types, ',');
@@ -121,6 +122,7 @@ const createFunctionAssignmentNode = exports.createFunctionAssignmentNode = /* #
         };
         const fn = typed(name, signatures);
         fn.syntax = syntax;
+        fn.expr = expr.toString();
         scope.set(name, fn);
         return fn;
       };

package/lib/cjs/expression/parse.js

@@ -54,7 +54,7 @@ const createParse = exports.createParse = /* #__PURE__ */(0, _factory.factory)(n
    *     node1.compile().evaluate() // 5
    *
    *     let scope = {a:3, b:4}
-   *     const node2 = math.parse('a * b') // 12
+   *     const node2 = math.parse('a * b')
    *     node2.evaluate(scope) // 12
    *     const code2 = node2.compile()
    *     code2.evaluate(scope) // 12

package/lib/cjs/function/matrix/range.js

@@ -22,7 +22,7 @@ const createRange = exports.createRange = /* #__PURE__ */(0, _factory.factory)(n
     isPositive
   } = _ref;
   /**
-   * Create an array from a range.
+   * Create a matrix or array containing a range of values.
    * By default, the range end is excluded. This can be customized by providing
    * an extra parameter `includeEnd`.
    *
@@ -50,10 +50,12 @@ const createRange = exports.createRange = /* #__PURE__ */(0, _factory.factory)(n
    * - `includeEnd: boolean`
    *   Option to specify whether to include the end or not. False by default.
    *
-   * Note that the return type of the range is taken from the type of
-   * the start/end. If only one these is a built-in `number` type, it will
-   * be promoted to the type of the other endpoint. However, in the case of
-   * Unit values, both endpoints must have compatible units, and the return
+   * The function returns a `DenseMatrix` when the library is configured with
+   * `config = { matrix: 'Matrix' }, and returns an Array otherwise.
+   * Note that the type of the returned values is taken from the type of the
+   * provided start/end value. If only one of these is a built-in `number` type,
+   * it will be promoted to the type of the other endpoint. However, in the case
+   * of Unit values, both endpoints must have compatible units, and the return
    * value will have compatible units as well.
    *
    * Examples:

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 14.6.0
- * @date    2025-07-25
+ * @version 14.7.0
+ * @date    2025-09-05
  *
  * @license
  * Copyright (C) 2013-2025 Jos de Jong <wjosdejong@gmail.com>

package/lib/cjs/type/matrix/DenseMatrix.js

@@ -679,24 +679,28 @@ const createDenseMatrixClass = exports.createDenseMatrixClass = /* #__PURE__ */(
       }
       return;
     }
-    const index = [];
-    const recurse = function* (value, depth) {
-      if (depth < maxDepth) {
-        for (let i = 0; i < value.length; i++) {
-          index[depth] = i;
-          yield* recurse(value[i], depth + 1);
-        }
-      } else {
-        for (let i = 0; i < value.length; i++) {
-          index[depth] = i;
-          yield {
-            value: value[i],
-            index: index.slice()
-          };
-        }
+
+    // Multi-dimensional matrix: iterate over all elements
+    const index = Array(maxDepth + 1).fill(0);
+    const totalElements = this._size.reduce((a, b) => a * b, 1);
+    for (let count = 0; count < totalElements; count++) {
+      // Traverse to the current element using indices
+      let current = this._data;
+      for (let d = 0; d < maxDepth; d++) {
+        current = current[index[d]];
       }
-    };
-    yield* recurse(this._data, 0);
+      yield {
+        value: current[index[maxDepth]],
+        index: index.slice()
+      };
+
+      // Increment indices for next element
+      for (let d = maxDepth; d >= 0; d--) {
+        index[d]++;
+        if (index[d] < this._size[d]) break;
+        index[d] = 0;
+      }
+    }
   };
 
   /**

package/lib/cjs/type/string.js

@@ -23,13 +23,13 @@ const createString = exports.createString = /* #__PURE__ */(0, _factory.factory)
    *
    * Examples:
    *
-   *    math.string(4.2)               // returns string '4.2'
-   *    math.string(math.complex(3, 2) // returns string '3 + 2i'
+   *    math.string(4.2)                // returns string '4.2'
+   *    math.string(math.complex(3, 2)) // returns string '3 + 2i'
    *
    *    const u = math.unit(5, 'km')
-   *    math.string(u.to('m'))         // returns string '5000 m'
+   *    math.string(u.to('m'))          // returns string '5000 m'
    *
-   *    math.string([true, false])     // returns ['true', 'false']
+   *    math.string([true, false])      // returns ['true', 'false']
    *
    * See also:
    *

package/lib/cjs/version.js

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

package/lib/esm/core/function/config.js

@@ -16,7 +16,6 @@ export function configFactory(config, emit) {
    *
    * Examples:
    *
-   *
    *     import { create, all } from 'mathjs'
    *
    *     // create a mathjs instance

package/lib/esm/expression/Parser.js

@@ -1,4 +1,5 @@
 import { factory } from '../utils/factory.js';
+import { isFunction } from '../utils/is.js';
 import { createEmptyMap, toObject } from '../utils/map.js';
 var name = 'Parser';
 var dependencies = ['evaluate', 'parse'];
@@ -154,7 +155,40 @@ export var createParserClass = /* #__PURE__ */factory(name, dependencies, _ref =
   Parser.prototype.clear = function () {
     this.scope.clear();
   };
+  Parser.prototype.toJSON = function () {
+    var json = {
+      mathjs: 'Parser',
+      variables: {},
+      functions: {}
+    };
+    for (var [_name2, value] of this.scope) {
+      if (isFunction(value)) {
+        if (!isExpressionFunction(value)) {
+          throw new Error("Cannot serialize external function ".concat(_name2));
+        }
+        json.functions[_name2] = "".concat(value.syntax, " = ").concat(value.expr);
+      } else {
+        json.variables[_name2] = value;
+      }
+    }
+    return json;
+  };
+  Parser.fromJSON = function (json) {
+    var parser = new Parser();
+    Object.entries(json.variables).forEach(_ref2 => {
+      var [name, value] = _ref2;
+      return parser.set(name, value);
+    });
+    Object.entries(json.functions).forEach(_ref3 => {
+      var [_name, fn] = _ref3;
+      return parser.evaluate(fn);
+    });
+    return parser;
+  };
   return Parser;
 }, {
   isClass: true
-});
+});
+function isExpressionFunction(value) {
+  return typeof value === 'function' && typeof value.syntax === 'string' && typeof value.expr === 'string';
+}

package/lib/esm/expression/node/FunctionAssignmentNode.js

@@ -98,7 +98,8 @@ export var createFunctionAssignmentNode = /* #__PURE__ */factory(name, dependenc
       });
 
       // compile the function expression with the child args
-      var evalExpr = this.expr._compile(math, childArgNames);
+      var expr = this.expr;
+      var evalExpr = expr._compile(math, childArgNames);
       var name = this.name;
       var params = this.params;
       var signature = join(this.types, ',');
@@ -114,6 +115,7 @@ export var createFunctionAssignmentNode = /* #__PURE__ */factory(name, dependenc
         };
         var fn = typed(name, signatures);
         fn.syntax = syntax;
+        fn.expr = expr.toString();
         scope.set(name, fn);
         return fn;
       };

package/lib/esm/expression/parse.js

@@ -47,7 +47,7 @@ export var createParse = /* #__PURE__ */factory(name, dependencies, _ref => {
    *     node1.compile().evaluate() // 5
    *
    *     let scope = {a:3, b:4}
-   *     const node2 = math.parse('a * b') // 12
+   *     const node2 = math.parse('a * b')
    *     node2.evaluate(scope) // 12
    *     const code2 = node2.compile()
    *     code2.evaluate(scope) // 12

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

@@ -16,7 +16,7 @@ export var createRange = /* #__PURE__ */factory(name, dependencies, _ref => {
     isPositive
   } = _ref;
   /**
-   * Create an array from a range.
+   * Create a matrix or array containing a range of values.
    * By default, the range end is excluded. This can be customized by providing
    * an extra parameter `includeEnd`.
    *
@@ -44,10 +44,12 @@ export var createRange = /* #__PURE__ */factory(name, dependencies, _ref => {
    * - `includeEnd: boolean`
    *   Option to specify whether to include the end or not. False by default.
    *
-   * Note that the return type of the range is taken from the type of
-   * the start/end. If only one these is a built-in `number` type, it will
-   * be promoted to the type of the other endpoint. However, in the case of
-   * Unit values, both endpoints must have compatible units, and the return
+   * The function returns a `DenseMatrix` when the library is configured with
+   * `config = { matrix: 'Matrix' }, and returns an Array otherwise.
+   * Note that the type of the returned values is taken from the type of the
+   * provided start/end value. If only one of these is a built-in `number` type,
+   * it will be promoted to the type of the other endpoint. However, in the case
+   * of Unit values, both endpoints must have compatible units, and the return
    * value will have compatible units as well.
    *
    * Examples:

package/lib/esm/type/matrix/DenseMatrix.js

@@ -672,24 +672,28 @@ export var createDenseMatrixClass = /* #__PURE__ */factory(name, dependencies, _
       }
       return;
     }
-    var index = [];
-    var _recurse = function* recurse(value, depth) {
-      if (depth < maxDepth) {
-        for (var _i9 = 0; _i9 < value.length; _i9++) {
-          index[depth] = _i9;
-          yield* _recurse(value[_i9], depth + 1);
-        }
-      } else {
-        for (var _i0 = 0; _i0 < value.length; _i0++) {
-          index[depth] = _i0;
-          yield {
-            value: value[_i0],
-            index: index.slice()
-          };
-        }
+
+    // Multi-dimensional matrix: iterate over all elements
+    var index = Array(maxDepth + 1).fill(0);
+    var totalElements = this._size.reduce((a, b) => a * b, 1);
+    for (var count = 0; count < totalElements; count++) {
+      // Traverse to the current element using indices
+      var current = this._data;
+      for (var d = 0; d < maxDepth; d++) {
+        current = current[index[d]];
       }
-    };
-    yield* _recurse(this._data, 0);
+      yield {
+        value: current[index[maxDepth]],
+        index: index.slice()
+      };
+
+      // Increment indices for next element
+      for (var _d = maxDepth; _d >= 0; _d--) {
+        index[_d]++;
+        if (index[_d] < this._size[_d]) break;
+        index[_d] = 0;
+      }
+    }
   };
 
   /**

package/lib/esm/type/string.js

@@ -17,13 +17,13 @@ export var createString = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Examples:
    *
-   *    math.string(4.2)               // returns string '4.2'
-   *    math.string(math.complex(3, 2) // returns string '3 + 2i'
+   *    math.string(4.2)                // returns string '4.2'
+   *    math.string(math.complex(3, 2)) // returns string '3 + 2i'
    *
    *    const u = math.unit(5, 'km')
-   *    math.string(u.to('m'))         // returns string '5000 m'
+   *    math.string(u.to('m'))          // returns string '5000 m'
    *
-   *    math.string([true, false])     // returns ['true', 'false']
+   *    math.string([true, false])      // returns ['true', 'false']
    *
    * See also:
    *

package/lib/esm/version.js

@@ -1,3 +1,3 @@
-export var version = '14.6.0';
+export var version = '14.7.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": "14.6.0",
+  "version": "14.7.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",
@@ -36,31 +36,30 @@
     "typed-function": "^4.2.1"
   },
   "devDependencies": {
-    "@babel/core": "7.28.0",
+    "@babel/core": "7.28.3",
     "@babel/plugin-transform-object-assign": "7.27.1",
     "@babel/plugin-transform-optional-catch-binding": "7.27.1",
-    "@babel/plugin-transform-runtime": "7.28.0",
-    "@babel/preset-env": "7.28.0",
-    "@babel/register": "7.27.1",
+    "@babel/plugin-transform-runtime": "7.28.3",
+    "@babel/preset-env": "7.28.3",
+    "@babel/register": "7.28.3",
     "@types/assert": "1.5.11",
     "@types/mocha": "10.0.10",
-    "@typescript-eslint/eslint-plugin": "8.38.0",
-    "@typescript-eslint/parser": "8.38.0",
+    "@typescript-eslint/eslint-plugin": "8.42.0",
+    "@typescript-eslint/parser": "8.42.0",
     "assert": "2.1.0",
     "babel-loader": "10.0.0",
     "c8": "10.1.3",
     "codecov": "3.8.3",
-    "core-js": "3.44.0",
     "del": "8.0.0",
-    "dtslint": "4.2.1",
     "eigen": "0.2.2",
+    "es-check": "9.3.1",
     "eslint": "8.57.1",
     "eslint-config-prettier": "9.1.0",
     "eslint-config-standard": "17.1.0",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-mocha": "10.5.0",
     "eslint-plugin-n": "16.6.2",
-    "eslint-plugin-prettier": "5.5.3",
+    "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-promise": "6.6.0",
     "expect-type": "1.2.2",
     "expr-eval": "2.0.2",
@@ -78,7 +77,7 @@
     "karma-webdriver-launcher": "1.0.8",
     "karma-webpack": "5.0.1",
     "mkdirp": "3.0.1",
-    "mocha": "11.7.1",
+    "mocha": "11.7.2",
     "mocha-junit-reporter": "2.2.1",
     "ndarray": "1.0.19",
     "ndarray-determinant": "1.0.0",
@@ -90,10 +89,10 @@
     "process": "0.11.10",
     "sinon": "21.0.0",
     "sylvester": "0.0.21",
-    "tinybench": "4.0.1",
+    "tinybench": "5.0.1",
     "ts-node": "10.9.2",
-    "typescript": "5.8.3",
-    "webpack": "5.100.2",
+    "typescript": "5.9.2",
+    "webpack": "5.101.3",
     "zeros": "1.0.0"
   },
   "type": "module",
@@ -149,7 +148,7 @@
     "test": "npm run test:src && npm run lint",
     "test:src": "mocha test/unit-tests",
     "test:generated": "mocha test/generated-code-tests",
-    "test:node": "mocha test/node-tests/*.test.js test/node-tests/**/*.test.js",
+    "test:node": "mocha test/node-tests/*.test.{js,cjs,mjs} test/node-tests/**/*.test.{js,cjs,mjs}",
     "test:all": "npm run test:src && npm run test:generated && npm run test:node && npm run test:types",
     "test:browser": "karma start test/browser-test-config/local-karma.js",
     "test:lambdatest": "karma start test/browser-test-config/lambdatest-karma.js",

package/types/index.d.ts

@@ -1904,6 +1904,14 @@ export interface MathJsInstance extends MathJsFactory {
    */
   det(x: MathCollection): number
 
+  /**
+   * Calculate the difference between adjacent elements of a matrix or array.
+   * @param x A matrix or array
+   * @param dim The dimension to apply the difference on.
+   * @returns A matrix or array containing the differences
+   */
+  diff<T extends MathCollection>(x: T, dim?: number | BigNumber): T
+
   /**
    * Create a diagonal matrix or retrieve the diagonal of a matrix. When x
    * is a vector, a matrix with vector x on the diagonal will be returned.
@@ -4079,7 +4087,8 @@ export const {
   concatTransformDependencies,
   stdTransformDependencies,
   sumTransformDependencies,
-  varianceTransformDependencies
+  varianceTransformDependencies,
+  printTransformDependencies
 }: Record<string, FactoryFunctionMap>
 
 export interface Matrix<T = MathGeneric> {
@@ -5805,6 +5814,15 @@ export interface MathJsChain<TValue> {
     y: MathCollection
   ): MathJsChain<MathCollection>
 
+  /**
+   * Calculate the difference between adjacent elements of the chained matrix or array.
+   * @param dim The dimension to apply the difference on.
+   */
+  diff<T extends MathCollection>(
+    this: MathJsChain<T>,
+    dim?: number | BigNumber
+  ): MathJsChain<T>
+
   /**
    * Calculate the determinant of a matrix.
    */

package/types/tslint.json

@@ -1,6 +0,0 @@
-{
-  "extends": "dtslint/dtslint.json",
-  "rules": {
-    "no-redundant-jsdoc": false
-  }
-}