mathjs 11.0.1 → 11.2.1

package/lib/cjs/core/create.js

@@ -122,6 +122,7 @@ function create(factories, config) {
     isOperatorNode: _is.isOperatorNode,
     isParenthesisNode: _is.isParenthesisNode,
     isRangeNode: _is.isRangeNode,
+    isRelationalNode: _is.isRelationalNode,
     isSymbolNode: _is.isSymbolNode,
     isChain: _is.isChain
   }); // load config function and apply provided config

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

@@ -197,6 +197,9 @@ var createTyped = /* #__PURE__ */(0, _factory.factory)('typed', dependencies, fu
   }, {
     name: 'RangeNode',
     test: _is.isRangeNode
+  }, {
+    name: 'RelationalNode',
+    test: _is.isRelationalNode
   }, {
     name: 'SymbolNode',
     test: _is.isSymbolNode

package/lib/cjs/entry/typeChecks.js

@@ -195,6 +195,12 @@ Object.defineProperty(exports, "isRegExp", {
     return _is.isRegExp;
   }
 });
+Object.defineProperty(exports, "isRelationalNode", {
+  enumerable: true,
+  get: function get() {
+    return _is.isRelationalNode;
+  }
+});
 Object.defineProperty(exports, "isResultSet", {
   enumerable: true,
   get: function get() {

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

@@ -9,7 +9,7 @@ var indexDocs = {
   category: 'Construction',
   syntax: ['[start]', '[start:end]', '[start:step:end]', '[start1, start 2, ...]', '[start1:end1, start2:end2, ...]', '[start1:step1:end1, start2:step2:end2, ...]'],
   description: 'Create an index to get or replace a subset of a matrix',
-  examples: ['[]', '[1, 2, 3]', 'A = [1, 2, 3; 4, 5, 6]', 'A[1, :]', 'A[1, 2] = 50', 'A[0:2, 0:2] = ones(2, 2)'],
+  examples: ['[1, 2, 3]', 'A = [1, 2, 3; 4, 5, 6]', 'A[1, :]', 'A[1, 2] = 50', 'A[1:2, 1:2] = ones(2, 2)'],
   seealso: ['bignumber', 'boolean', 'complex', 'matrix,', 'number', 'range', 'string', 'unit']
 };
 exports.indexDocs = indexDocs;

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 11.0.1
- * @date    2022-07-25
+ * @version 11.2.1
+ * @date    2022-09-13
  *
  * @license
  * Copyright (C) 2013-2022 Jos de Jong <wjosdejong@gmail.com>

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

@@ -9,10 +9,10 @@ exports.createUnitClass = void 0;
 
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 
-var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
 var _is = require("../../utils/is.js");
 
 var _factory = require("../../utils/factory.js");
@@ -53,8 +53,8 @@ var createUnitClass = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
   /**
    * A unit can be constructed in the following ways:
    *
-   *     const a = new Unit(value, name)
-   *     const b = new Unit(null, name)
+   *     const a = new Unit(value, valuelessUnit)
+   *     const b = new Unit(null, valuelessUnit)
    *     const c = Unit.parse(str)
    *
    * Example usage:
@@ -67,10 +67,10 @@ var createUnitClass = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
    * @class Unit
    * @constructor Unit
    * @param {number | BigNumber | Fraction | Complex | boolean} [value]  A value like 5.2
-   * @param {string} [name]   A unit name like "cm" or "inch", or a derived unit of the form: "u1[^ex1] [u2[^ex2] ...] [/ u3[^ex3] [u4[^ex4]]]", such as "kg m^2/s^2", where each unit appearing after the forward slash is taken to be in the denominator. "kg m^2 s^-2" is a synonym and is also acceptable. Any of the units can include a prefix.
+   * @param {string | Unit} valuelessUnit   A unit without value. Can have prefix, like "cm"
    */
 
-  function Unit(value, name) {
+  function Unit(value, valuelessUnit) {
     if (!(this instanceof Unit)) {
       throw new Error('Constructor must be called with the new operator');
     }
@@ -79,31 +79,36 @@ var createUnitClass = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
       throw new TypeError('First parameter in Unit constructor must be number, BigNumber, Fraction, Complex, or undefined');
     }
 
-    if (name !== undefined && (typeof name !== 'string' || name === '')) {
-      throw new TypeError('Second parameter in Unit constructor must be a string');
-    }
-
-    if (name !== undefined) {
-      var u = Unit.parse(name);
-      this.units = u.units;
-      this.dimensions = u.dimensions;
-    } else {
-      this.units = [];
-      this.dimensions = [];
-
-      for (var i = 0; i < BASE_DIMENSIONS.length; i++) {
-        this.dimensions[i] = 0;
-      }
-    }
-
-    this.value = value !== undefined && value !== null ? this._normalize(value) : null;
     this.fixPrefix = false; // if true, function format will not search for the
     // best prefix but leave it as initially provided.
     // fixPrefix is set true by the method Unit.to
     // The justification behind this is that if the constructor is explicitly called,
-    // the caller wishes the units to be returned exactly as he supplied.
+    // the caller wishes the units to be returned exactly as supplied.
 
     this.skipAutomaticSimplification = true;
+
+    if (valuelessUnit === undefined) {
+      this.units = [];
+      this.dimensions = BASE_DIMENSIONS.map(function (x) {
+        return 0;
+      });
+    } else if (typeof valuelessUnit === 'string') {
+      var u = Unit.parse(valuelessUnit);
+      this.units = u.units;
+      this.dimensions = u.dimensions;
+    } else if ((0, _is.isUnit)(valuelessUnit) && valuelessUnit.value === null) {
+      // clone from valuelessUnit
+      this.fixPrefix = valuelessUnit.fixPrefix;
+      this.skipAutomaticSimplification = valuelessUnit.skipAutomaticSimplification;
+      this.dimensions = valuelessUnit.dimensions.slice(0);
+      this.units = valuelessUnit.units.map(function (u) {
+        return (0, _extends2["default"])({}, u);
+      });
+    } else {
+      throw new TypeError('Second parameter in Unit constructor must be a string or valueless Unit');
+    }
+
+    this.value = this._normalize(value);
   }
   /**
    * Attach type information

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

@@ -24,10 +24,13 @@ var createUnitFunction = /* #__PURE__ */(0, _factory.factory)(name, dependencies
    * Syntax:
    *
    *     math.unit(unit : string)
-   *     math.unit(value : number, unit : string)
+   *     math.unit(value : number, valuelessUnit : Unit)
+   *     math.unit(value : number, valuelessUnit : string)
    *
    * Examples:
    *
+   *    const kph = math.unit('km/h')   // returns Unit km/h (valueless)
+   *    const v = math.unit(25, kph)    // returns Unit 25 km/h
    *    const a = math.unit(5, 'cm')    // returns Unit 50 mm
    *    const b = math.unit('23 kg')    // returns Unit 23 kg
    *    a.to('m')                       // returns Unit 0.05 m
@@ -52,7 +55,7 @@ var createUnitFunction = /* #__PURE__ */(0, _factory.factory)(name, dependencies
         allowNoUnits: true
       }); // a unit with value, like '5cm'
     },
-    'number | BigNumber | Fraction | Complex, string': function numberBigNumberFractionComplexString(value, unit) {
+    'number | BigNumber | Fraction | Complex, string | Unit': function numberBigNumberFractionComplexStringUnit(value, unit) {
       return new Unit(value, unit);
     },
     'number | BigNumber | Fraction': function numberBigNumberFraction(value) {

package/lib/cjs/utils/is.js

@@ -37,6 +37,7 @@ exports.isParenthesisNode = isParenthesisNode;
 exports.isRange = isRange;
 exports.isRangeNode = isRangeNode;
 exports.isRegExp = isRegExp;
+exports.isRelationalNode = isRelationalNode;
 exports.isResultSet = isResultSet;
 exports.isSparseMatrix = isSparseMatrix;
 exports.isString = isString;
@@ -237,6 +238,10 @@ function isRangeNode(x) {
   return x && x.isRangeNode === true && x.constructor.prototype.isNode === true || false;
 }
 
+function isRelationalNode(x) {
+  return x && x.isRelationalNode === true && x.constructor.prototype.isNode === true || false;
+}
+
 function isSymbolNode(x) {
   return x && x.isSymbolNode === true && x.constructor.prototype.isNode === true || false;
 }

package/lib/cjs/version.js

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

package/lib/esm/core/create.js

@@ -5,7 +5,7 @@ import * as emitter from './../utils/emitter.js';
 import { importFactory } from './function/import.js';
 import { configFactory } from './function/config.js';
 import { factory, isFactory } from '../utils/factory.js';
-import { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRegExp, isResultSet, isSparseMatrix, isString, isSymbolNode, isUndefined, isUnit } from '../utils/is.js';
+import { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRelationalNode, isRegExp, isResultSet, isSparseMatrix, isString, isSymbolNode, isUndefined, isUnit } from '../utils/is.js';
 import { ArgumentsError } from '../error/ArgumentsError.js';
 import { DimensionError } from '../error/DimensionError.js';
 import { IndexError } from '../error/IndexError.js';
@@ -97,6 +97,7 @@ export function create(factories, config) {
     isOperatorNode,
     isParenthesisNode,
     isRangeNode,
+    isRelationalNode,
     isSymbolNode,
     isChain
   }); // load config function and apply provided config

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

@@ -35,7 +35,7 @@
  * @param {Object<string, function>} signatures   Object with one or multiple function signatures
  * @returns {function} The created typed-function.
  */
-import { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRegExp, isResultSet, isSparseMatrix, isString, isSymbolNode, isUndefined, isUnit } from '../../utils/is.js';
+import { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRelationalNode, isRegExp, isResultSet, isSparseMatrix, isString, isSymbolNode, isUndefined, isUnit } from '../../utils/is.js';
 import typedFunction from 'typed-function';
 import { digits } from '../../utils/number.js';
 import { factory } from '../../utils/factory.js';
@@ -183,6 +183,9 @@ export var createTyped = /* #__PURE__ */factory('typed', dependencies, function
   }, {
     name: 'RangeNode',
     test: isRangeNode
+  }, {
+    name: 'RelationalNode',
+    test: isRelationalNode
   }, {
     name: 'SymbolNode',
     test: isSymbolNode

package/lib/esm/entry/typeChecks.js

@@ -1,2 +1,2 @@
 // util functions
-export { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isString, isUndefined, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRegExp, isResultSet, isSparseMatrix, isSymbolNode, isUnit } from '../utils/is.js';
+export { isAccessorNode, isArray, isArrayNode, isAssignmentNode, isBigNumber, isBlockNode, isBoolean, isChain, isCollection, isComplex, isConditionalNode, isConstantNode, isDate, isDenseMatrix, isFraction, isFunction, isFunctionAssignmentNode, isFunctionNode, isHelp, isIndex, isIndexNode, isMatrix, isNode, isNull, isNumber, isString, isUndefined, isObject, isObjectNode, isOperatorNode, isParenthesisNode, isRange, isRangeNode, isRelationalNode, isRegExp, isResultSet, isSparseMatrix, isSymbolNode, isUnit } from '../utils/is.js';

package/lib/esm/expression/embeddedDocs/construction/index.js

@@ -3,6 +3,6 @@ export var indexDocs = {
   category: 'Construction',
   syntax: ['[start]', '[start:end]', '[start:step:end]', '[start1, start 2, ...]', '[start1:end1, start2:end2, ...]', '[start1:step1:end1, start2:step2:end2, ...]'],
   description: 'Create an index to get or replace a subset of a matrix',
-  examples: ['[]', '[1, 2, 3]', 'A = [1, 2, 3; 4, 5, 6]', 'A[1, :]', 'A[1, 2] = 50', 'A[0:2, 0:2] = ones(2, 2)'],
+  examples: ['[1, 2, 3]', 'A = [1, 2, 3; 4, 5, 6]', 'A[1, :]', 'A[1, 2] = 50', 'A[1:2, 1:2] = ones(2, 2)'],
   seealso: ['bignumber', 'boolean', 'complex', 'matrix,', 'number', 'range', 'string', 'unit']
 };

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

@@ -1,5 +1,5 @@
-import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _extends from "@babel/runtime/helpers/extends";
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
@@ -37,8 +37,8 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
   /**
    * A unit can be constructed in the following ways:
    *
-   *     const a = new Unit(value, name)
-   *     const b = new Unit(null, name)
+   *     const a = new Unit(value, valuelessUnit)
+   *     const b = new Unit(null, valuelessUnit)
    *     const c = Unit.parse(str)
    *
    * Example usage:
@@ -51,10 +51,10 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
    * @class Unit
    * @constructor Unit
    * @param {number | BigNumber | Fraction | Complex | boolean} [value]  A value like 5.2
-   * @param {string} [name]   A unit name like "cm" or "inch", or a derived unit of the form: "u1[^ex1] [u2[^ex2] ...] [/ u3[^ex3] [u4[^ex4]]]", such as "kg m^2/s^2", where each unit appearing after the forward slash is taken to be in the denominator. "kg m^2 s^-2" is a synonym and is also acceptable. Any of the units can include a prefix.
+   * @param {string | Unit} valuelessUnit   A unit without value. Can have prefix, like "cm"
    */
 
-  function Unit(value, name) {
+  function Unit(value, valuelessUnit) {
     if (!(this instanceof Unit)) {
       throw new Error('Constructor must be called with the new operator');
     }
@@ -63,31 +63,32 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, _ref =>
       throw new TypeError('First parameter in Unit constructor must be number, BigNumber, Fraction, Complex, or undefined');
     }
 
-    if (name !== undefined && (typeof name !== 'string' || name === '')) {
-      throw new TypeError('Second parameter in Unit constructor must be a string');
-    }
-
-    if (name !== undefined) {
-      var u = Unit.parse(name);
-      this.units = u.units;
-      this.dimensions = u.dimensions;
-    } else {
-      this.units = [];
-      this.dimensions = [];
-
-      for (var i = 0; i < BASE_DIMENSIONS.length; i++) {
-        this.dimensions[i] = 0;
-      }
-    }
-
-    this.value = value !== undefined && value !== null ? this._normalize(value) : null;
     this.fixPrefix = false; // if true, function format will not search for the
     // best prefix but leave it as initially provided.
     // fixPrefix is set true by the method Unit.to
     // The justification behind this is that if the constructor is explicitly called,
-    // the caller wishes the units to be returned exactly as he supplied.
+    // the caller wishes the units to be returned exactly as supplied.
 
     this.skipAutomaticSimplification = true;
+
+    if (valuelessUnit === undefined) {
+      this.units = [];
+      this.dimensions = BASE_DIMENSIONS.map(x => 0);
+    } else if (typeof valuelessUnit === 'string') {
+      var u = Unit.parse(valuelessUnit);
+      this.units = u.units;
+      this.dimensions = u.dimensions;
+    } else if (isUnit(valuelessUnit) && valuelessUnit.value === null) {
+      // clone from valuelessUnit
+      this.fixPrefix = valuelessUnit.fixPrefix;
+      this.skipAutomaticSimplification = valuelessUnit.skipAutomaticSimplification;
+      this.dimensions = valuelessUnit.dimensions.slice(0);
+      this.units = valuelessUnit.units.map(u => _extends({}, u));
+    } else {
+      throw new TypeError('Second parameter in Unit constructor must be a string or valueless Unit');
+    }
+
+    this.value = this._normalize(value);
   }
   /**
    * Attach type information

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

@@ -17,10 +17,13 @@ export var createUnitFunction = /* #__PURE__ */factory(name, dependencies, _ref
    * Syntax:
    *
    *     math.unit(unit : string)
-   *     math.unit(value : number, unit : string)
+   *     math.unit(value : number, valuelessUnit : Unit)
+   *     math.unit(value : number, valuelessUnit : string)
    *
    * Examples:
    *
+   *    const kph = math.unit('km/h')   // returns Unit km/h (valueless)
+   *    const v = math.unit(25, kph)    // returns Unit 25 km/h
    *    const a = math.unit(5, 'cm')    // returns Unit 50 mm
    *    const b = math.unit('23 kg')    // returns Unit 23 kg
    *    a.to('m')                       // returns Unit 0.05 m
@@ -45,7 +48,7 @@ export var createUnitFunction = /* #__PURE__ */factory(name, dependencies, _ref
         allowNoUnits: true
       }); // a unit with value, like '5cm'
     },
-    'number | BigNumber | Fraction | Complex, string': function numberBigNumberFractionComplexString(value, unit) {
+    'number | BigNumber | Fraction | Complex, string | Unit': function numberBigNumberFractionComplexStringUnit(value, unit) {
       return new Unit(value, unit);
     },
     'number | BigNumber | Fraction': function numberBigNumberFraction(value) {

package/lib/esm/utils/is.js

@@ -149,6 +149,9 @@ export function isParenthesisNode(x) {
 export function isRangeNode(x) {
   return x && x.isRangeNode === true && x.constructor.prototype.isNode === true || false;
 }
+export function isRelationalNode(x) {
+  return x && x.isRelationalNode === true && x.constructor.prototype.isNode === true || false;
+}
 export function isSymbolNode(x) {
   return x && x.isSymbolNode === true && x.constructor.prototype.isNode === true || false;
 }

package/lib/esm/version.js

@@ -1,2 +1,2 @@
-export var version = '11.0.1'; // Note: This file is automatically generated when building math.js.
+export var version = '11.2.1'; // 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": "11.0.1",
+  "version": "11.2.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",
@@ -25,42 +25,42 @@
     "unit"
   ],
   "dependencies": {
-    "@babel/runtime": "^7.18.9",
+    "@babel/runtime": "^7.19.0",
     "complex.js": "^2.1.1",
-    "decimal.js": "^10.3.1",
+    "decimal.js": "^10.4.0",
     "escape-latex": "^1.2.0",
     "fraction.js": "^4.2.0",
     "javascript-natural-sort": "^0.7.1",
     "seedrandom": "^3.0.5",
     "tiny-emitter": "^2.1.0",
-    "typed-function": "^3.0.0"
+    "typed-function": "^4.1.0"
   },
   "devDependencies": {
-    "@babel/core": "7.18.9",
+    "@babel/core": "7.19.0",
     "@babel/plugin-transform-object-assign": "7.18.6",
-    "@babel/plugin-transform-runtime": "7.18.9",
-    "@babel/preset-env": "7.18.9",
+    "@babel/plugin-transform-runtime": "7.18.10",
+    "@babel/preset-env": "7.19.0",
     "@babel/register": "7.18.9",
     "@types/assert": "1.5.6",
     "@types/mocha": "9.1.1",
-    "@typescript-eslint/eslint-plugin": "5.30.7",
-    "@typescript-eslint/parser": "5.30.7",
+    "@typescript-eslint/eslint-plugin": "5.37.0",
+    "@typescript-eslint/parser": "5.37.0",
     "assert": "2.0.0",
     "babel-loader": "8.2.5",
     "benchmark": "2.1.4",
     "codecov": "3.8.3",
-    "core-js": "3.23.5",
+    "core-js": "3.25.1",
     "del": "6.1.1",
     "dtslint": "4.2.1",
-    "eslint": "8.20.0",
+    "eslint": "8.23.1",
     "eslint-config-prettier": "8.5.0",
     "eslint-config-standard": "17.0.0",
     "eslint-plugin-import": "2.26.0",
     "eslint-plugin-mocha": "10.1.0",
-    "eslint-plugin-n": "15.2.4",
+    "eslint-plugin-n": "15.2.5",
     "eslint-plugin-prettier": "4.2.1",
-    "eslint-plugin-promise": "6.0.0",
-    "expect-type": "0.13.0",
+    "eslint-plugin-promise": "6.0.1",
+    "expect-type": "0.14.2",
     "expr-eval": "2.0.2",
     "fancy-log": "2.0.0",
     "glob": "8.0.3",
@@ -90,8 +90,8 @@
     "process": "0.11.10",
     "sylvester": "0.0.21",
     "ts-node": "10.9.1",
-    "typescript": "4.7.4",
-    "webpack": "5.73.0",
+    "typescript": "4.8.3",
+    "webpack": "5.74.0",
     "zeros": "1.0.0"
   },
   "type": "module",
@@ -161,10 +161,9 @@
     "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:browserstack": "karma start test/browser-test-config/browserstack-karma.js",
-    "test:types": "cd types && node --loader ts-node/esm ./index.ts",
+    "test:types": "cd types && tsc -p ./tsconfig.json && node --loader ts-node/esm ./index.ts",
     "coverage": "nyc --reporter=lcov --reporter=text-summary mocha test/unit-tests && echo \"\nDetailed coverage report is available at ./coverage/lcov-report/index.html\"",
     "prepublishOnly": "npm run test:all && npm run lint",
-    "prepare": "npm run build",
     "update-authors": "node ./tools/update-authors.js"
   },
   "bin": {

package/types/index.d.ts

@@ -283,6 +283,7 @@ declare namespace math {
   type OperatorNodeMap = {
     xor: 'xor'
     and: 'and'
+    or: 'or'
     bitOr: '|'
     bitXor: '^|'
     bitAnd: '&'
@@ -291,6 +292,7 @@ declare namespace math {
     smaller: '<'
     larger: '>'
     smallerEq: '<='
+    largerEq: '>='
     leftShift: '<<'
     rightArithShift: '>>'
     rightLogShift: '>>>'
@@ -478,6 +480,12 @@ declare namespace math {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     reviver(): (key: any, value: any) => any
 
+    /**
+     * Returns replacer function that can be used as replacer in JSON.stringify function.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    replacer(): (key: any, value: any) => any
+
     /*************************************************************************
      * Core functions
      ************************************************************************/
@@ -2195,11 +2203,9 @@ declare namespace math {
      * undefined. Returns an array with the configured number of elements
      * when number is > 1.
      */
-    pickRandom(
-      array: number[],
-      number?: number,
-      weights?: number[]
-    ): number | number[]
+    pickRandom<T>(array: T[]): T
+    pickRandom<T>(array: T[], number: number): T[]
+    pickRandom<T>(array: T[], number: number, weights: number[]): T[]
 
     /**
      * Return a random number larger or equal to min and smaller than max
@@ -2570,9 +2576,9 @@ declare namespace math {
     median(...args: MathType[]): any
 
     /**
-     * Compute the maximum value of a matrix or a list of values. In case of
-     * a multi dimensional array, the maximum of the flattened array will be
-     * calculated. When dim is provided, the maximum over the selected
+     * Compute the minimum value of a matrix or a list of values. In case of
+     * a multi dimensional array, the minimun of the flattened array will be
+     * calculated. When dim is provided, the minimun over the selected
      * dimension will be calculated. Parameter dim is zero-based.
      * @param args A single matrix or or multiple scalar values
      * @returns The minimum value
@@ -3152,6 +3158,8 @@ declare namespace math {
 
     isRangeNode(x: unknown): x is RangeNode
 
+    isRelationalNode(x: unknown): x is RelationalNode
+
     isSymbolNode(x: unknown): x is SymbolNode
 
     isChain(x: unknown): x is MathJsChain<unknown>
@@ -5515,11 +5523,13 @@ declare namespace math {
      * @param number An int or float
      * @param weights An array of ints or floats
      */
-    pickRandom(
-      array: MathJsChain<number[]>,
-      number?: number,
-      weights?: number[]
-    ): MathJsChain<number | number[]>
+    pickRandom<T>(this: MathJsChain<T[]>): MathJsChain<T>
+    pickRandom<T>(this: MathJsChain<T[]>, number: number): MathJsChain<T[]>
+    pickRandom<T>(
+      this: MathJsChain<T[]>,
+      number: number,
+      weights: number[]
+    ): MathJsChain<T[]>
 
     /**
      * Return a random number larger or equal to min and smaller than max
@@ -5867,9 +5877,9 @@ declare namespace math {
     median(this: MathJsChain<MathCollection>, dim?: number): MathJsChain<any>
 
     /**
-     * Compute the maximum value of a matrix or a list of values. In case of
-     * a multi dimensional array, the maximum of the flattened array will be
-     * calculated. When dim is provided, the maximum over the selected
+     * Compute the minimum value of a matrix or a list of values. In case of
+     * a multi dimensional array, the minimum of the flattened array will be
+     * calculated. When dim is provided, the minimum over the selected
      * dimension will be calculated. Parameter dim is zero-based.
      * @param dim The minimum over the selected dimension
      */

package/types/index.ts

@@ -2076,6 +2076,7 @@ Factory Test
     math.isOperatorNode,
     math.isParenthesisNode,
     math.isRangeNode,
+    math.isRelationalNode,
     math.isSymbolNode,
     math.isChain,
   ]
@@ -2189,6 +2190,9 @@ Factory Test
   if (math.isRangeNode(x)) {
     expectTypeOf(x).toMatchTypeOf<RangeNode>()
   }
+  if (math.isRelationalNode(x)) {
+    expectTypeOf(x).toMatchTypeOf<math.RelationalNode>()
+  }
   if (math.isSymbolNode(x)) {
     expectTypeOf(x).toMatchTypeOf<SymbolNode>()
   }
@@ -2242,3 +2246,20 @@ Resolve examples
   ).toMatchTypeOf<MathNode[]>()
   expectTypeOf(math.resolve(math.matrix(['x', 'y']))).toMatchTypeOf<Matrix>()
 }
+
+/*
+Random examples
+*/
+{
+  const math = create(all, {})
+  expectTypeOf(math.pickRandom([1, 2, 3])).toMatchTypeOf<number>()
+  expectTypeOf(math.pickRandom(['a', { b: 10 }, 42])).toMatchTypeOf<
+    string | number | { b: number }
+  >()
+  expectTypeOf(math.pickRandom([1, 2, 3])).toMatchTypeOf<number>()
+  expectTypeOf(math.pickRandom([1, 2, 3], 2)).toMatchTypeOf<number[]>()
+
+  expectTypeOf(math.chain([1, 2, 3]).pickRandom(2)).toMatchTypeOf<
+    MathJsChain<number[]>
+  >()
+}

package/types/tsconfig.json

@@ -15,5 +15,8 @@
     "strictNullChecks": false,
     "strictFunctionTypes": true,
     "forceConsistentCasingInFileNames": true
-  }
+  },
+  "files": [
+    "./index.ts"
+  ],
 }