Merge branch 'develop' into broadcasting-functions

Author: dvd101x

AUTHORS

@@ -282,7 +282,7 @@ Richard Taylor <richard.taylor@claconnect.com>
 NilsDietrich <61544566+NilsDietrich@users.noreply.github.com>
 anslem chibuike <144047596+AnslemHack@users.noreply.github.com>
 Ayomide Bamigbade <iamtryve@gmail.com>
-Dheemanth07 <dheemanth1007@gmail.com>
 Anadian <willanad@yandex.com>
+Dheemanth D <165369664+Dheemanth07@users.noreply.github.com>
 
 # Generated by tools/update-authors.js

HISTORY.md

@@ -1,15 +1,16 @@
 # History
 
-# unreleased changes since 15.1.0
+# 2026-02-10, 15.1.1
 
 - Fix: #3631 Handle bigints in `compareNatural` (#3632). Thanks @Dheemanth07.
-- Docs: Correct several arithmetic and relational documentation examples
-  and add History (#3630). Thanks @Anadian.
 - Fix: #3578 interpret empty true-expr of conditional as error (#3581).
   Thanks @gwhitney.
 - Fix: #3597 added nullish type definitions (#3601). Thanks @Ayo1984.
+- Docs: Correct several arithmetic and relational documentation examples
+  and add History (#3630). Thanks @Anadian.
 - Docs: fix #3565, update Matrix documentation (#3591). Thanks @orelbn.
 - Docs: #3341 add per-function HISTORY sections (#3606). Thanks @gwhitney.
+- Docs: describe that `setDistinct` sorts the elements (see #3602).
 
 # 2025-11-05, 15.1.0
 

README.md

@@ -191,9 +191,9 @@ To see the coverage results, open the generated report in your browser:
 
 ### Continuous integration testing
 
-Continuous integration tests are run on [GitHub Actions](https://github.com/josdejong/mathjs/actions) and [TestMu AI](https://www.testmu.ai) (formerly LambdaTest) every time a commit is pushed to GitHub. GitHub Actions runs the tests for different versions of node.js, and TestMu AI runs the tests on all major browsers.
+Continuous integration tests are run on [GitHub Actions](https://github.com/josdejong/mathjs/actions) and [TestMu AI](https://www.testmuai.com/?utm_medium=sponsor&utm_source=mathjs) (formerly LambdaTest) every time a commit is pushed to GitHub. GitHub Actions runs the tests for different versions of node.js, and TestMu AI runs the tests on all major browsers.
 
-[![TestMu AI](https://raw.github.com/josdejong/mathjs/develop/misc/testmu-ai.svg)](https://www.testmu.ai)
+[![TestMu AI](https://raw.github.com/josdejong/mathjs/develop/misc/testmu-ai.svg)](https://www.testmuai.com/?utm_medium=sponsor&utm_source=mathjs)
 
 Thanks, GitHub Actions and TestMu AI for the generous free hosting of this open source project!
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "mathjs",
-  "version": "15.1.0",
+  "version": "15.1.1",
   "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,23 +36,23 @@
     "typed-function": "^4.2.1"
   },
   "devDependencies": {
-    "@babel/core": "7.28.5",
+    "@babel/core": "7.29.0",
     "@babel/plugin-transform-object-assign": "7.27.1",
-    "@babel/plugin-transform-optional-catch-binding": "7.27.1",
-    "@babel/plugin-transform-runtime": "7.28.5",
-    "@babel/preset-env": "7.28.5",
-    "@babel/register": "7.28.3",
+    "@babel/plugin-transform-optional-catch-binding": "7.28.6",
+    "@babel/plugin-transform-runtime": "7.29.0",
+    "@babel/preset-env": "7.29.0",
+    "@babel/register": "7.28.6",
     "@types/assert": "1.5.11",
     "@types/mocha": "10.0.10",
-    "@typescript-eslint/eslint-plugin": "8.46.3",
-    "@typescript-eslint/parser": "8.46.3",
+    "@typescript-eslint/eslint-plugin": "8.55.0",
+    "@typescript-eslint/parser": "8.55.0",
     "assert": "2.1.0",
     "babel-loader": "10.0.0",
     "c8": "10.1.3",
     "codecov": "3.8.3",
     "del": "8.0.1",
     "eigen": "0.2.2",
-    "es-check": "9.4.4",
+    "es-check": "9.5.4",
     "eslint": "8.57.1",
     "eslint-config-prettier": "9.1.0",
     "eslint-config-standard": "17.1.0",
@@ -61,7 +61,7 @@
     "eslint-plugin-n": "16.6.2",
     "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-promise": "6.6.0",
-    "expect-type": "1.2.2",
+    "expect-type": "1.3.0",
     "expr-eval": "2.0.2",
     "fancy-log": "2.0.0",
     "glob": "11.0.3",
@@ -85,14 +85,14 @@
     "ndarray-ops": "1.2.2",
     "ndarray-pack": "1.2.1",
     "numericjs": "1.2.6",
-    "prettier": "3.6.2",
+    "prettier": "3.8.1",
     "process": "0.11.10",
-    "sinon": "21.0.0",
+    "sinon": "21.0.1",
     "sylvester": "0.0.21",
-    "tinybench": "5.1.0",
+    "tinybench": "6.0.0",
     "ts-node": "10.9.2",
     "typescript": "5.9.3",
-    "webpack": "5.102.1",
+    "webpack": "5.105.0",
     "zeros": "1.0.0"
   },
   "type": "module",

package.json

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

src/version.js

@@ -0,0 +1,30 @@
+// test performance of plain JS functions vs custom functions defined via the expression parser
+
+import assert from 'node:assert'
+import { Bench } from 'tinybench'
+import { all, create } from '../../lib/esm/index.js'
+import { formatTaskResult } from './utils/formatTaskResult.js'
+
+const math = create(all)
+
+const cubeJsPlain = (x) => x * x * x
+const cubeJsWithMathjsFn = (x) => math.multiply(x, math.multiply(x, x))
+const cubeMathjsCustomFn = math.evaluate('f(x) = x * x * x')
+
+assert.strictEqual(cubeJsPlain(3), 27)
+assert.strictEqual(cubeJsWithMathjsFn(3), 27)
+assert.strictEqual(cubeMathjsCustomFn(3), 27)
+
+const bench = new Bench({ time: 100, iterations: 1000 })
+  .add('cubeJsPlain', function () {
+    cubeJsPlain(3)
+  })
+  .add('cubeJsWithMathjsFn', function () {
+    cubeJsWithMathjsFn(3)
+  })
+  .add('cubeMathjsCustomFn', function () {
+    cubeMathjsCustomFn(3)
+  })
+
+bench.addEventListener('cycle', (event) => console.log(formatTaskResult(bench, event.task, 3)))
+await bench.run()

test/benchmark/expression_parser_functions.js

@@ -5,15 +5,16 @@ const varianceWidth = 8
  * Format a result like "Task name   2.30 µs ±0.79%"
  * @param {import('tinybench').Bench} bench
  * @param {import('tinybench').Task} task
+ * @param {number} [digits]
  * @return {string}
  */
-export function formatTaskResult (bench, task) {
+export function formatTaskResult (bench, task, digits = 2) {
   const nameWidth = Math.max(...bench.tasks.map(task => task.name.length)) + 1
 
   const name = task.name
   const { variance, mean } = task.result.latency
 
-  const meanStr = `${(mean * 1000).toFixed(2)} \u00b5s`
+  const meanStr = `${(mean * 1000).toFixed(digits)} \u00b5s`
   const varianceStr = `±${((variance / mean) * 100).toFixed(2)}%`
   return `${padRight(name, nameWidth)} ${padLeft(meanStr, durationWidth)} ${padLeft(varianceStr, varianceWidth)}`
 }

test/benchmark/utils/formatTaskResult.js

@@ -178,8 +178,9 @@ export interface NodeCtor {
   new (): MathNode
 }
 
-export interface AccessorNode<TObject extends MathNode = MathNode>
-  extends MathNode {
+export interface AccessorNode<
+  TObject extends MathNode = MathNode
+> extends MathNode {
   type: 'AccessorNode'
   isAccessorNode: true
   object: TObject
@@ -195,8 +196,9 @@ export interface AccessorNodeCtor {
   ): AccessorNode<TObject>
 }
 
-export interface ArrayNode<TItems extends MathNode[] = MathNode[]>
-  extends MathNode {
+export interface ArrayNode<
+  TItems extends MathNode[] = MathNode[]
+> extends MathNode {
   type: 'ArrayNode'
   isArrayNode: true
   items: [...TItems]
@@ -207,8 +209,9 @@ export interface ArrayNodeCtor {
   ): ArrayNode<TItems>
 }
 
-export interface AssignmentNode<TValue extends MathNode = MathNode>
-  extends MathNode {
+export interface AssignmentNode<
+  TValue extends MathNode = MathNode
+> extends MathNode {
   type: 'AssignmentNode'
   isAssignmentNode: true
   object: SymbolNode | AccessorNode
@@ -295,8 +298,9 @@ export interface ConstantNodeCtor {
   ): ConstantNode<TValue>
 }
 
-export interface FunctionAssignmentNode<TExpr extends MathNode = MathNode>
-  extends MathNode {
+export interface FunctionAssignmentNode<
+  TExpr extends MathNode = MathNode
+> extends MathNode {
   type: 'FunctionAssignmentNode'
   isFunctionAssignmentNode: true
   name: string
@@ -329,8 +333,9 @@ export interface FunctionNodeCtor {
   onUndefinedFunction: (name: string) => any
 }
 
-export interface IndexNode<TDims extends MathNode[] = MathNode[]>
-  extends MathNode {
+export interface IndexNode<
+  TDims extends MathNode[] = MathNode[]
+> extends MathNode {
   type: 'IndexNode'
   isIndexNode: true
   dimensions: [...TDims]
@@ -420,8 +425,9 @@ export interface OperatorNodeCtor extends MathNode {
     implicit?: boolean
   ): OperatorNode<TOp, TFn, TArgs>
 }
-export interface ParenthesisNode<TContent extends MathNode = MathNode>
-  extends MathNode {
+export interface ParenthesisNode<
+  TContent extends MathNode = MathNode
+> extends MathNode {
   type: 'ParenthesisNode'
   isParenthesisNode: true
   content: TContent
@@ -453,8 +459,9 @@ export interface RangeNodeCtor {
   ): RangeNode<TStart, TEnd, TStep>
 }
 
-export interface RelationalNode<TParams extends MathNode[] = MathNode[]>
-  extends MathNode {
+export interface RelationalNode<
+  TParams extends MathNode[] = MathNode[]
+> extends MathNode {
   type: 'RelationalNode'
   isRelationalNode: true
   conditionals: string[]