mathjs 14.5.3 → 14.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mathjs",
-  "version": "14.5.3",
+  "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,33 +36,32 @@
     "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.35.1",
-    "@typescript-eslint/parser": "8.35.1",
+    "@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.43.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.1",
+    "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-promise": "6.6.0",
-    "expect-type": "1.2.1",
+    "expect-type": "1.2.2",
     "expr-eval": "2.0.2",
     "fancy-log": "2.0.0",
     "glob": "11.0.3",
@@ -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.99.9",
+    "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.
@@ -3488,6 +3496,18 @@ export interface MathJsInstance extends MathJsFactory {
    */
   to(x: Unit | MathCollection, unit: Unit | string): Unit | MathCollection
 
+  /**
+   * Converts a unit to the most appropriate display unit.
+   * When no preferred units are provided, the function automatically find the best prefix.
+   * When preferred units are provided, it converts to
+   * the unit that gives a value closest to 1.
+   * @param preferredUnits - Optional preferred target units
+   * @param options - Optional options object
+   * @returns Unit with optimized prefix/unit
+   */
+  toBest(): Unit
+  toBest(units: string[] | Unit[], options: object): Unit
+
   /*************************************************************************
    * Utils
    ************************************************************************/
@@ -3834,6 +3854,7 @@ export const {
   formatDependencies,
   printDependencies,
   toDependencies,
+  toBestDependencies,
   isPrimeDependencies,
   numericDependencies,
   divideScalarDependencies,
@@ -4066,7 +4087,8 @@ export const {
   concatTransformDependencies,
   stdTransformDependencies,
   sumTransformDependencies,
-  varianceTransformDependencies
+  varianceTransformDependencies,
+  printTransformDependencies
 }: Record<string, FactoryFunctionMap>
 
 export interface Matrix<T = MathGeneric> {
@@ -4177,6 +4199,8 @@ export interface Unit {
   pow(unit: Unit): Unit
   abs(unit: Unit): Unit
   to(unit: string | Unit): Unit
+  toBest(): Unit
+  toBest(units?: string[] | Unit[], options?: object): Unit
   toNumber(unit?: string): number
   toNumeric(unit?: string): number | Fraction | BigNumber
   toSI(): Unit
@@ -5790,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.
    */
@@ -6991,6 +7024,21 @@ export interface MathJsChain<TValue> {
     unit: Unit | string
   ): MathJsChain<Unit | MathCollection>
 
+  /**
+   * Converts a unit to the most appropriate display unit.
+   * When no preferred units are provided, the function automatically find the best prefix.
+   * When preferred units are provided, it converts to
+   * the unit that gives a value closest to 1.
+   * @param preferredUnits - Optional preferred target units
+   * @param options - Optional options object
+   */
+  toBest(this: MathJsChain<Unit>): MathJsChain<Unit>
+  toBest(
+    this: MathJsChain<Unit>,
+    units: string[] | Unit[],
+    options: object
+  ): MathJsChain<Unit>
+
   /*************************************************************************
    * Utils functions
    ************************************************************************/
@@ -7380,6 +7428,7 @@ export const {
 
   // unit functions
   to,
+  toBest,
 
   // util functions
   isNumber,

package/types/tslint.json

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