mathjs 15.1.1 → 15.2.0

package/lib/cjs/expression/embeddedDocs/embeddedDocs.js

@@ -94,6 +94,8 @@ var _subtract = require("./function/arithmetic/subtract.js");
 var _unaryMinus = require("./function/arithmetic/unaryMinus.js");
 var _unaryPlus = require("./function/arithmetic/unaryPlus.js");
 var _xgcd = require("./function/arithmetic/xgcd.js");
+var _num = require("./function/fraction/num.js");
+var _den = require("./function/fraction/den.js");
 var _bitAnd = require("./function/bitwise/bitAnd.js");
 var _bitNot = require("./function/bitwise/bitNot.js");
 var _bitOr = require("./function/bitwise/bitOr.js");
@@ -557,6 +559,8 @@ const embeddedDocs = exports.embeddedDocs = {
   unaryPlus: _unaryPlus.unaryPlusDocs,
   xgcd: _xgcd.xgcdDocs,
   invmod: _invmod.invmodDocs,
+  num: _num.numDocs,
+  den: _den.denDocs,
   // functions - bitwise
   bitAnd: _bitAnd.bitAndDocs,
   bitNot: _bitNot.bitNotDocs,

package/lib/cjs/expression/embeddedDocs/function/fraction/den.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.denDocs = void 0;
+const denDocs = exports.denDocs = {
+  name: 'den',
+  category: 'Fraction',
+  syntax: ['den(x)'],
+  description: 'Get the denominator of a fraction.',
+  examples: ['den(fraction(2, 3))', 'den(fraction(5, 8))'],
+  seealso: ['num', 'fraction']
+};

package/lib/cjs/expression/embeddedDocs/function/fraction/num.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.numDocs = void 0;
+const numDocs = exports.numDocs = {
+  name: 'num',
+  category: 'Fraction',
+  syntax: ['num(x)'],
+  description: 'Get the numerator of a fraction.',
+  examples: ['num(fraction(2, 3))', 'num(fraction(5, 8))'],
+  seealso: ['den', 'fraction']
+};

package/lib/cjs/factoriesAny.js

@@ -495,6 +495,12 @@ Object.defineProperty(exports, "createDeepEqual", {
     return _deepEqual.createDeepEqual;
   }
 });
+Object.defineProperty(exports, "createDen", {
+  enumerable: true,
+  get: function () {
+    return _den.createDen;
+  }
+});
 Object.defineProperty(exports, "createDenseMatrixClass", {
   enumerable: true,
   get: function () {
@@ -1371,6 +1377,12 @@ Object.defineProperty(exports, "createNullishTransform", {
     return _nullishTransform.createNullishTransform;
   }
 });
+Object.defineProperty(exports, "createNum", {
+  enumerable: true,
+  get: function () {
+    return _num.createNum;
+  }
+});
 Object.defineProperty(exports, "createNumber", {
   enumerable: true,
   get: function () {
@@ -2517,4 +2529,6 @@ var _andTransform = require("./expression/transform/and.transform.js");
 var _orTransform = require("./expression/transform/or.transform.js");
 var _nullishTransform = require("./expression/transform/nullish.transform.js");
 var _bitAndTransform = require("./expression/transform/bitAnd.transform.js");
-var _bitOrTransform = require("./expression/transform/bitOr.transform.js");
+var _bitOrTransform = require("./expression/transform/bitOr.transform.js");
+var _num = require("./function/fraction/num.js");
+var _den = require("./function/fraction/den.js");

package/lib/cjs/function/fraction/den.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createDen = void 0;
+var _factory = require("../../utils/factory.js");
+var _collection = require("../../utils/collection.js");
+const name = 'den';
+const dependencies = ['typed', 'fraction'];
+const createDen = exports.createDen = /* #__PURE__ */(0, _factory.factory)(name, dependencies, _ref => {
+  let {
+    typed,
+    fraction
+  } = _ref;
+  /**
+   * Get the denominator of a fraction.
+   * For a fraction `a/b`, the function returns `b`.
+   *
+   * The result is always in lowest terms. For example, `den(fraction(8, 6))`
+   * returns `3n` because 8/6 simplifies to 4/3.
+   *
+   * For negative fractions like `-a/b` or `a/-b`, the denominator is
+   * always returned as a positive bigint. The sign is stored in the
+   * numerator. So `den(fraction(-2, 3))` and `den(fraction(2, -3))`
+   * both return `3n`.
+   *
+   * For matrices, the function is evaluated element wise.
+   *
+   * Syntax:
+   *
+   *    math.den(x)
+   *
+   * Examples:
+   *
+   *    math.den(math.fraction(2, 3))   // returns 3n
+   *    math.den(math.fraction(8, 6))   // returns 3n
+   *    math.den(math.fraction('5/8'))  // returns 8n
+   *    math.den(math.fraction(-2, 3))  // returns 3n
+   *    math.den(math.fraction(2, -3))  // returns 3n
+   *    math.den(math.bignumber('0.5'))  // returns 2n
+   *
+   * See also:
+   *
+   *    num, fraction
+   *
+   * History:
+   *
+   *    v15.2.0      Created
+   *
+   * @param {Fraction | BigNumber | Array | Matrix} x
+   *            A fraction, BigNumber, or array with fractions
+   * @return {bigint | Array | Matrix} The denominator of x (in lowest terms)
+   */
+  return typed(name, {
+    Fraction: x => x.d,
+    BigNumber: x => fraction(x).d,
+    'Array | Matrix': typed.referToSelf(self => x => (0, _collection.deepMap)(x, self))
+  });
+});

package/lib/cjs/function/fraction/num.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createNum = void 0;
+var _factory = require("../../utils/factory.js");
+var _collection = require("../../utils/collection.js");
+const name = 'num';
+const dependencies = ['typed', 'fraction'];
+const createNum = exports.createNum = /* #__PURE__ */(0, _factory.factory)(name, dependencies, _ref => {
+  let {
+    typed,
+    fraction
+  } = _ref;
+  /**
+   * Get the numerator of a fraction.
+   * For a fraction `a/b`, the function returns `a`.
+   *
+   * The result is always in lowest terms. For example, `num(fraction(8, 6))`
+   * returns `4n` because 8/6 simplifies to 4/3.
+   *
+   * For negative fractions like `-a/b` or `a/-b`, the sign is always
+   * included in the numerator. Both forms are normalized internally, so
+   * `num(fraction(-2, 3))` and `num(fraction(2, -3))` both return `-2`.
+   *
+   * For matrices, the function is evaluated element wise.
+   *
+   * Syntax:
+   *
+   *    math.num(x)
+   *
+   * Examples:
+   *
+   *    math.num(math.fraction(2, 3))   // returns 2n
+   *    math.num(math.fraction(8, 6))   // returns 4n
+   *    math.num(math.fraction('5/8'))  // returns 5n
+   *    math.num(math.fraction(-2, 3))  // returns -2n
+   *    math.num(math.fraction(2, -3))  // returns -2n
+   *    math.num(math.bignumber('0.5'))  // returns 1n
+   *
+   * See also:
+   *
+   *    den, fraction
+   *
+   * History:
+   *
+   *    v15.2.0      Created
+   *
+   * @param {Fraction | BigNumber | Array | Matrix} x
+   *            A fraction, BigNumber, or array with fractions
+   * @return {bigint | Array | Matrix} The numerator of x (in lowest terms)
+   */
+  return typed(name, {
+    Fraction: x => x.s * x.n,
+    BigNumber: x => {
+      const f = fraction(x);
+      return f.s * f.n;
+    },
+    'Array | Matrix': typed.referToSelf(self => x => (0, _collection.deepMap)(x, self))
+  });
+});

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 15.1.1
- * @date    2026-02-10
+ * @version 15.2.0
+ * @date    2026-04-07
  *
  * @license
  * Copyright (C) 2013-2026 Jos de Jong <wjosdejong@gmail.com>

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

@@ -3166,6 +3166,13 @@ const createUnitClass = exports.createUnitClass = /* #__PURE__ */(0, _factory.fa
       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/cjs/utils/array.js

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

package/lib/cjs/utils/customs.js

@@ -6,12 +6,13 @@ Object.defineProperty(exports, "__esModule", {
 exports.getSafeMethod = getSafeMethod;
 exports.getSafeProperty = getSafeProperty;
 exports.isPlainObject = isPlainObject;
+exports.isSafeArrayProperty = isSafeArrayProperty;
 exports.isSafeMethod = isSafeMethod;
-exports.isSafeProperty = isSafeProperty;
+exports.isSafeObjectProperty = isSafeObjectProperty;
 exports.setSafeProperty = setSafeProperty;
 var _object = require("./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
@@ -19,18 +20,20 @@ var _object = require("./object.js");
  * @return {*} Returns the property value when safe
  */
 function getSafeProperty(object, prop) {
-  // only allow getting safe properties of a plain object
-  if (isSafeProperty(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 "${prop}" as a property`);
+  }
+  if (object === null || object === undefined) {
+    throw new TypeError(`Cannot access property "${prop}": object is ${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
@@ -38,49 +41,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)) {
+  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 "${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)) {
+function isSafeObjectProperty(object, prop) {
+  if (!isPlainObject(object)) {
     return false;
   }
-  // SAFE: whitelisted
-  // e.g length
-  if ((0, _object.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
+ */
+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);
 }
 
 /**
@@ -108,17 +105,20 @@ 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 ((0, _object.hasOwnProperty)(object, method) && Object.getPrototypeOf && method in Object.getPrototypeOf(object)) {
     return false;
   }
+
   // SAFE: whitelisted
   // e.g toString
-  if ((0, _object.hasOwnProperty)(safeNativeMethods, method)) {
+  if (safeNativeMethods.has(method)) {
     return true;
   }
+
   // UNSAFE: inherited from Object prototype
   // e.g constructor
   if (method in Object.prototype) {
@@ -127,6 +127,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) {
@@ -140,12 +141,4 @@ function isSafeMethod(object, method) {
 function isPlainObject(object) {
   return typeof object === 'object' && object && object.constructor === Object;
 }
-const safeNativeProperties = {
-  length: true,
-  name: true
-};
-const safeNativeMethods = {
-  toString: true,
-  valueOf: true,
-  toLocaleString: true
-};
+const safeNativeMethods = new Set(['toString', 'valueOf', 'toLocaleString']);

package/lib/cjs/utils/map.js

@@ -34,7 +34,7 @@ class ObjectWrappingMap {
     return this;
   }
   has(key) {
-    return (0, _customs.isSafeProperty)(this.wrappedObject, key) && key in this.wrappedObject;
+    return (0, _customs.isSafeObjectProperty)(this.wrappedObject, key) && key in this.wrappedObject;
   }
   entries() {
     return mapIterator(this.keys(), key => [key, this.get(key)]);
@@ -45,7 +45,7 @@ class ObjectWrappingMap {
     }
   }
   delete(key) {
-    if ((0, _customs.isSafeProperty)(this.wrappedObject, key)) {
+    if ((0, _customs.isSafeObjectProperty)(this.wrappedObject, key)) {
       delete this.wrappedObject[key];
     }
   }

package/lib/cjs/version.js

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

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

@@ -0,0 +1,12 @@
+/**
+ * THIS FILE IS AUTO-GENERATED
+ * DON'T MAKE CHANGES HERE
+ */
+import { fractionDependencies } from './dependenciesFraction.generated.js';
+import { typedDependencies } from './dependenciesTyped.generated.js';
+import { createDen } from '../../factoriesAny.js';
+export var denDependencies = {
+  fractionDependencies,
+  typedDependencies,
+  createDen
+};

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

@@ -0,0 +1,12 @@
+/**
+ * THIS FILE IS AUTO-GENERATED
+ * DON'T MAKE CHANGES HERE
+ */
+import { fractionDependencies } from './dependenciesFraction.generated.js';
+import { typedDependencies } from './dependenciesTyped.generated.js';
+import { createNum } from '../../factoriesAny.js';
+export var numDependencies = {
+  fractionDependencies,
+  typedDependencies,
+  createNum
+};

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

@@ -84,6 +84,7 @@ export { cubeDependencies } from './dependenciesAny/dependenciesCube.generated.j
 export { cumsumDependencies } from './dependenciesAny/dependenciesCumSum.generated.js';
 export { cumsumTransformDependencies } from './dependenciesAny/dependenciesCumSumTransform.generated.js';
 export { deepEqualDependencies } from './dependenciesAny/dependenciesDeepEqual.generated.js';
+export { denDependencies } from './dependenciesAny/dependenciesDen.generated.js';
 export { DenseMatrixDependencies } from './dependenciesAny/dependenciesDenseMatrixClass.generated.js';
 export { derivativeDependencies } from './dependenciesAny/dependenciesDerivative.generated.js';
 export { detDependencies } from './dependenciesAny/dependenciesDet.generated.js';
@@ -230,6 +231,7 @@ export { nuclearMagnetonDependencies } from './dependenciesAny/dependenciesNucle
 export { nullDependencies } from './dependenciesAny/dependenciesNull.generated.js';
 export { nullishDependencies } from './dependenciesAny/dependenciesNullish.generated.js';
 export { nullishTransformDependencies } from './dependenciesAny/dependenciesNullishTransform.generated.js';
+export { numDependencies } from './dependenciesAny/dependenciesNum.generated.js';
 export { numberDependencies } from './dependenciesAny/dependenciesNumber.generated.js';
 export { numericDependencies } from './dependenciesAny/dependenciesNumeric.generated.js';
 export { ObjectNodeDependencies } from './dependenciesAny/dependenciesObjectNode.generated.js';