mathjs 15.1.0 → 15.2.0

package/lib/esm/function/set/setDistinct.js

@@ -14,6 +14,7 @@ export var createSetDistinct = /* #__PURE__ */factory(name, dependencies, _ref =
   /**
    * Collect the distinct elements of a multiset.
    * A multi-dimension array will be converted to a single-dimension array before the operation.
+   * The items of the returned array will be sorted in natural order.
    *
    * Syntax:
    *
@@ -28,7 +29,7 @@ export var createSetDistinct = /* #__PURE__ */factory(name, dependencies, _ref =
    *    setMultiplicity
    *
    * @param {Array | Matrix}    a  A multiset
-   * @return {Array | Matrix}    A set containing the distinc elements of the multiset
+   * @return {Array | Matrix}    A set containing the distinct elements of the multiset
    */
   return typed(name, {
     'Array | Matrix': function Array__Matrix(a) {

package/lib/esm/function/string/format.js

@@ -120,6 +120,15 @@ export var createFormat = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    print
    *
+   * History:
+   *
+   *    v0.4     Created
+   *    v0.7     Round to a consistent number of digits (rather than decimals)
+   *    v0.15    Added multiple number notations and configurable precision
+   *    v3       Added support for JSON objects
+   *    v9       Added binary, hexadecimal, and octal notations
+   *    v10.4.2  Add `truncate` option
+   *
    * @param {*} value                               Value to be stringified
    * @param {Object | Function | number} [options]  Formatting options
    * @return {string} The formatted value

package/lib/esm/function/utils/isFinite.js

@@ -34,8 +34,15 @@ export var createIsFinite = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    isBounded isNumeric, isPositive, isNegative, isNaN
    *
-   * @param {number | BigNumber | bigint | Complex | Fraction | Unit | Array | Matrix} x       Value to be tested
+   * History:
+   *
+   *    v15.1   Created
+   *
+   * @param {number | BigNumber | bigint | Complex | Fraction | Unit | Array | Matrix} x
+   *     Value to be tested
    * @return {boolean | Array | Matrix}
+   *     Whether the value, or its entries, are finite, as appropriate
+   *     to its type
    */
   return typed(name, {
     'Array | Matrix': A => map(A, isBounded),

package/lib/esm/function/utils/numeric.js

@@ -46,6 +46,12 @@ export var createNumeric = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    number, fraction, bignumber, bigint, string, format
    *
+   * History:
+   *
+   *    v6       Created
+   *    v13      Added `bigint` support
+   *    v14.2.1  Prefer mathjs `bigint()` to built-in `BigInt()`
+   *
    * @param {string | number | BigNumber | bigint | Fraction } value
    *              A numeric value or a string containing a numeric value
    * @param {string} outputType

package/lib/esm/header.js

@@ -10,7 +10,7 @@
  * @date    @@date
  *
  * @license
- * Copyright (C) 2013-2025 Jos de Jong <wjosdejong@gmail.com>
+ * Copyright (C) 2013-2026 Jos de Jong <wjosdejong@gmail.com>
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy

package/lib/esm/type/bigint.js

@@ -25,6 +25,11 @@ export var createBigint = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    number, bignumber, boolean, complex, index, matrix, string, unit
    *
+   * History:
+   *
+   *    v13      Created
+   *    v14.2.1  Added conversion options
+   *
    * @param {string | number | BigNumber | bigint | Fraction | boolean | Array | Matrix | null} [value]  Value to be converted
    * @return {bigint | Array | Matrix} The created bigint
    */

package/lib/esm/type/boolean.js

@@ -30,6 +30,12 @@ export var createBoolean = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, complex, index, matrix, string, unit
    *
+   * History:
+   *
+   *    v0.11    Created
+   *    v0.16    Added conversion from BigNumber
+   *    v14.2.1  Added conversion from bigint
+   *
    * @param {string | number | boolean | Array | Matrix | null} value  A value of any type
    * @return {boolean | Array | Matrix} The boolean value
    */

package/lib/esm/type/complex/function/complex.js

@@ -41,6 +41,12 @@ export var createComplex = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, boolean, index, matrix, number, string, unit
    *
+   * History:
+   *
+   *    v0.5   Created
+   *    v0.16  Added conversion from BigNumber
+   *    v6     Added conversion from Fraction
+   *
    * @param {* | Array | Matrix} [args]
    *            Arguments specifying the real and imaginary part of the complex number
    * @return {Complex | Array | Matrix} Returns a complex value

package/lib/esm/type/fraction/function/fraction.js

@@ -39,6 +39,14 @@ export var createFraction = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, number, string, unit
    *
+   * History:
+   *
+   *    v2     Created
+   *    v3     Added conversion from BigNumber
+   *    v11.8  Added conversion from Unit
+   *    v13    Added conversion from bigint
+   *    v14    Move to bigint-based fraction.js@5; construct from two bigints
+   *
    * @param {number | string | Fraction | BigNumber | bigint | Unit | Array | Matrix} [args]
    *            Arguments specifying the value, or numerator and denominator of
    *            the fraction

package/lib/esm/type/matrix/function/index.js

@@ -39,6 +39,14 @@ export var createIndex = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, boolean, complex, matrix, number, string, unit
    *
+   * History:
+   *
+   *    v?      Created
+   *    v2      Dropped support for `[start, end, step]` arguments in favor
+   *            of lists of arbitrary values; added support for Range
+   *            objects.
+   *    v11.10  Added support for arrays of booleans as indices.
+   *
    * @param {...*} ranges   Zero or more ranges or numbers.
    * @return {Index}        Returns the created index
    */

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

@@ -35,6 +35,12 @@ export var createMatrix = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, boolean, complex, index, number, string, unit, sparse
    *
+   * History:
+   *
+   *    v0.5  Created
+   *    v1.5  Support dense or sparse Matrix types; allow construction
+   *          from string, Array, or another Matrix.
+   *
    * @param {Array | Matrix} [data]    A multi dimensional array
    * @param {string} [format]          The Matrix storage format, either `'dense'` or `'sparse'`
    * @param {string} [datatype]        Type of the values

package/lib/esm/type/matrix/function/sparse.js

@@ -35,6 +35,10 @@ export var createSparse = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, boolean, complex, index, number, string, unit, matrix
    *
+   * History:
+   *
+   *    v1.5  Created
+   *
    * @param {Array | Matrix} [data]    A two dimensional array
    *
    * @return {Matrix} The created matrix

package/lib/esm/type/string.js

@@ -29,6 +29,10 @@ export var createString = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    bignumber, boolean, complex, index, matrix, number, unit
    *
+   * History:
+   *
+   *    v0.9  Created
+   *
    * @param {* | Array | Matrix | null} [value]  A value to convert to a string
    * @return {string | Array | Matrix} The created string
    */

package/lib/esm/type/unit/Unit.js

@@ -3159,6 +3159,13 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       value: 1,
       offset: 0
     },
+    Ah: {
+      name: 'Ah',
+      base: BASE_UNITS.ELECTRIC_CHARGE,
+      prefixes: PREFIXES.SHORT,
+      value: 3600,
+      offset: 0
+    },
     // Electric capacitance
     farad: {
       name: 'farad',

package/lib/esm/type/unit/function/unit.js

@@ -32,6 +32,14 @@ export var createUnitFunction = /* #__PURE__ */factory(name, dependencies, _ref
    *
    *    bignumber, boolean, complex, index, matrix, number, string, createUnit
    *
+   * History:
+   *
+   *    v0.5   Created
+   *    v0.16  Support conversion from BigNumber
+   *    v2.5   Support BigNumber and Fraction values in units
+   *    v2.6   Support Complex values in units
+   *    v11.1  Allow the type of unit to be specifed by a unit (not just string)
+   *
    * @param {* | Array | Matrix} args   A number and unit.
    * @return {Unit | Array | Matrix}    The created unit
    */

package/lib/esm/utils/array.js

@@ -820,6 +820,9 @@ export function get(array, index) {
   if (!Array.isArray(array)) {
     throw new Error('Array expected');
   }
+  if (!Array.isArray(index)) {
+    throw new Error('Array expected for index');
+  }
   var size = arraySize(array);
   if (index.length !== size.length) {
     throw new DimensionError(index.length, size.length);

package/lib/esm/utils/customs.js

@@ -1,26 +1,28 @@
 import { hasOwnProperty } from './object.js';
 
 /**
- * Get a property of a plain object
+ * Get a property of a plain object or array
  * Throws an error in case the object is not a plain object or the
  * property is not defined on the object itself
  * @param {Object} object
  * @param {string} prop
  * @return {*} Returns the property value when safe
  */
-function getSafeProperty(object, prop) {
-  // only allow getting safe properties of a plain object
-  if (isSafeProperty(object, prop)) {
+export function getSafeProperty(object, prop) {
+  if (isSafeObjectProperty(object, prop) || isSafeArrayProperty(object, prop)) {
     return object[prop];
   }
-  if (typeof object[prop] === 'function' && isSafeMethod(object, prop)) {
-    throw new Error('Cannot access method "' + prop + '" as a property');
+  if (isSafeMethod(object, prop)) {
+    throw new Error("Cannot access method \"".concat(prop, "\" as a property"));
+  }
+  if (object === null || object === undefined) {
+    throw new TypeError("Cannot access property \"".concat(prop, "\": object is ").concat(object));
   }
   throw new Error('No access to property "' + prop + '"');
 }
 
 /**
- * Set a property on a plain object.
+ * Set a property on a plain object or array.
  * Throws an error in case the object is not a plain object or the
  * property would override an inherited property like .constructor or .toString
  * @param {Object} object
@@ -28,49 +30,43 @@ function getSafeProperty(object, prop) {
  * @param {*} value
  * @return {*} Returns the value
  */
-// TODO: merge this function into access.js?
-function setSafeProperty(object, prop, value) {
-  // only allow setting safe properties of a plain object
-  if (isSafeProperty(object, prop)) {
+export function setSafeProperty(object, prop, value) {
+  if (isSafeObjectProperty(object, prop) || isSafeArrayProperty(object, prop)) {
     object[prop] = value;
     return value;
   }
-  throw new Error('No access to property "' + prop + '"');
+  throw new Error("No access to property \"".concat(prop, "\""));
 }
 
 /**
- * Test whether a property is safe to use on an object or Array.
- * For example .toString and .constructor are not safe
- * @param {Object | Array} object
+ * Test whether a property is safe for reading and writing on an object
+ * For example .constructor and .__proto__ are not safe
+ * @param {Object} object
  * @param {string} prop
  * @return {boolean} Returns true when safe
  */
-function isSafeProperty(object, prop) {
-  if (!isPlainObject(object) && !Array.isArray(object)) {
+export function isSafeObjectProperty(object, prop) {
+  if (!isPlainObject(object)) {
     return false;
   }
-  // SAFE: whitelisted
-  // e.g length
-  if (hasOwnProperty(safeNativeProperties, prop)) {
-    return true;
-  }
-  // UNSAFE: inherited from Object prototype
-  // e.g constructor
-  if (prop in Object.prototype) {
-    // 'in' is used instead of hasOwnProperty for nodejs v0.10
-    // which is inconsistent on root prototypes. It is safe
-    // here because Object.prototype is a root object
-    return false;
-  }
-  // UNSAFE: inherited from Function prototype
-  // e.g call, apply
-  if (prop in Function.prototype) {
-    // 'in' is used instead of hasOwnProperty for nodejs v0.10
-    // which is inconsistent on root prototypes. It is safe
-    // here because Function.prototype is a root object
+  return !(prop in Object.prototype);
+}
+
+/**
+ * Test whether a property is safe for reading and writing on an Array
+ * For example .__proto__ and .constructor are not safe
+ * @param {unknown} array
+ * @param {string | number} prop
+ * @return {boolean} Returns true when safe
+ */
+export function isSafeArrayProperty(array, prop) {
+  if (!Array.isArray(array)) {
     return false;
   }
-  return true;
+  return typeof prop === 'number' || typeof prop === 'string' && isInteger(prop) || prop === 'length';
+}
+function isInteger(prop) {
+  return /^\d+$/.test(prop);
 }
 
 /**
@@ -80,7 +76,7 @@ function isSafeProperty(object, prop) {
  * @param {string} method
  * @return {function} Returns the method when valid
  */
-function getSafeMethod(object, method) {
+export function getSafeMethod(object, method) {
   if (!isSafeMethod(object, method)) {
     throw new Error('No access to method "' + method + '"');
   }
@@ -94,21 +90,24 @@ function getSafeMethod(object, method) {
  * @param {string} method
  * @return {boolean} Returns true when safe, false otherwise
  */
-function isSafeMethod(object, method) {
+export function isSafeMethod(object, method) {
   if (object === null || object === undefined || typeof object[method] !== 'function') {
     return false;
   }
+
   // UNSAFE: ghosted
   // e.g overridden toString
   // Note that IE10 doesn't support __proto__ and we can't do this check there.
   if (hasOwnProperty(object, method) && Object.getPrototypeOf && method in Object.getPrototypeOf(object)) {
     return false;
   }
+
   // SAFE: whitelisted
   // e.g toString
-  if (hasOwnProperty(safeNativeMethods, method)) {
+  if (safeNativeMethods.has(method)) {
     return true;
   }
+
   // UNSAFE: inherited from Object prototype
   // e.g constructor
   if (method in Object.prototype) {
@@ -117,6 +116,7 @@ function isSafeMethod(object, method) {
     // here because Object.prototype is a root object
     return false;
   }
+
   // UNSAFE: inherited from Function prototype
   // e.g call, apply
   if (method in Function.prototype) {
@@ -127,21 +127,7 @@ function isSafeMethod(object, method) {
   }
   return true;
 }
-function isPlainObject(object) {
+export function isPlainObject(object) {
   return typeof object === 'object' && object && object.constructor === Object;
 }
-var safeNativeProperties = {
-  length: true,
-  name: true
-};
-var safeNativeMethods = {
-  toString: true,
-  valueOf: true,
-  toLocaleString: true
-};
-export { getSafeProperty };
-export { setSafeProperty };
-export { isSafeProperty };
-export { getSafeMethod };
-export { isSafeMethod };
-export { isPlainObject };
+var safeNativeMethods = new Set(['toString', 'valueOf', 'toLocaleString']);

package/lib/esm/utils/map.js

@@ -1,4 +1,4 @@
-import { getSafeProperty, isSafeProperty, setSafeProperty } from './customs.js';
+import { getSafeProperty, isSafeObjectProperty, setSafeProperty } from './customs.js';
 import { isMap, isObject } from './is.js';
 
 /**
@@ -25,7 +25,7 @@ export class ObjectWrappingMap {
     return this;
   }
   has(key) {
-    return isSafeProperty(this.wrappedObject, key) && key in this.wrappedObject;
+    return isSafeObjectProperty(this.wrappedObject, key) && key in this.wrappedObject;
   }
   entries() {
     return mapIterator(this.keys(), key => [key, this.get(key)]);
@@ -36,7 +36,7 @@ export class ObjectWrappingMap {
     }
   }
   delete(key) {
-    if (isSafeProperty(this.wrappedObject, key)) {
+    if (isSafeObjectProperty(this.wrappedObject, key)) {
       delete this.wrappedObject[key];
     }
   }

package/lib/esm/version.js

@@ -1,3 +1,3 @@
-export var version = '15.1.0';
+export var version = '15.2.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": "15.1.0",
+  "version": "15.2.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,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",