mathjs 12.0.0 → 12.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mathjs",
-  "version": "12.0.0",
+  "version": "12.1.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,29 +36,29 @@
     "typed-function": "^4.1.1"
   },
   "devDependencies": {
-    "@babel/core": "7.23.2",
-    "@babel/plugin-transform-object-assign": "7.22.5",
-    "@babel/plugin-transform-runtime": "7.23.2",
-    "@babel/preset-env": "7.23.2",
+    "@babel/core": "7.23.3",
+    "@babel/plugin-transform-object-assign": "7.23.3",
+    "@babel/plugin-transform-runtime": "7.23.3",
+    "@babel/preset-env": "7.23.3",
     "@babel/register": "7.22.15",
-    "@types/assert": "1.5.8",
-    "@types/mocha": "10.0.3",
-    "@typescript-eslint/eslint-plugin": "6.9.0",
-    "@typescript-eslint/parser": "6.9.0",
+    "@types/assert": "1.5.9",
+    "@types/mocha": "10.0.4",
+    "@typescript-eslint/eslint-plugin": "6.11.0",
+    "@typescript-eslint/parser": "6.11.0",
     "assert": "2.1.0",
     "babel-loader": "9.1.3",
     "benchmark": "2.1.4",
     "c8": "8.0.1",
     "codecov": "3.8.3",
-    "core-js": "3.33.1",
+    "core-js": "3.33.2",
     "del": "6.1.1",
     "dtslint": "4.2.1",
-    "eslint": "8.52.0",
+    "eslint": "8.53.0",
     "eslint-config-prettier": "9.0.0",
     "eslint-config-standard": "17.1.0",
     "eslint-plugin-import": "2.29.0",
     "eslint-plugin-mocha": "10.2.0",
-    "eslint-plugin-n": "16.2.0",
+    "eslint-plugin-n": "16.3.1",
     "eslint-plugin-prettier": "5.0.1",
     "eslint-plugin-promise": "6.1.1",
     "expect-type": "0.17.3",
@@ -85,7 +85,7 @@
     "ndarray-pack": "1.2.1",
     "numericjs": "1.2.6",
     "pad-right": "0.2.2",
-    "prettier": "3.0.3",
+    "prettier": "3.1.0",
     "process": "0.11.10",
     "sylvester": "0.0.21",
     "ts-node": "10.9.1",

package/types/index.d.ts

@@ -5,10 +5,10 @@ export as namespace math
 export type NoLiteralType<T> = T extends number
   ? number
   : T extends string
-  ? string
-  : T extends boolean
-  ? boolean
-  : T
+    ? string
+    : T extends boolean
+      ? boolean
+      : T
 
 // TODO: introduce generics for MathCollection, MathMatrix, and MathArray
 export type MathNumericType = number | BigNumber | Fraction | Complex
@@ -1104,6 +1104,10 @@ export interface MathJsInstance extends MathJsFactory {
     n?: number | BigNumber
   ): NoLiteralType<T>
   round<U extends MathCollection>(x: MathNumericType, n: U): U
+  round<U extends MathCollection>(x: U, unit: Unit): U
+  round(x: Unit, unit: Unit): Unit
+  round(x: Unit, n: number | BigNumber, unit: Unit): Unit
+  round<U extends MathCollection>(x: U, n: number | BigNumber, unit: Unit): U
 
   // End of group of rounding functions
 
@@ -2275,9 +2279,8 @@ export interface MathJsInstance extends MathJsFactory {
    * @param array A one dimensional array
    * @param number An int or float
    * @param weights An array of ints or floats
-   * @returns Returns a single random value from array when number is 1 or
-   * undefined. Returns an array with the configured number of elements
-   * when number is > 1.
+   * @returns Returns a single random value from array when number is undefined.
+   * Returns an array with the configured number of elements when number is defined.
    */
   pickRandom<T>(array: T[]): T
   pickRandom<T>(array: T[], number: number): T[]
@@ -4741,6 +4744,25 @@ export interface MathJsChain<TValue> {
     this: MathJsChain<T>,
     n?: number | BigNumber | MathCollection
   ): MathJsChain<T>
+  round<U extends MathCollection>(
+    this: MathJsChain<MathNumericType | U>,
+    n: U
+  ): MathJsChain<U>
+  round(this: MathJsChain<Unit>, unit: Unit): MathJsChain<Unit>
+  round<U extends MathCollection>(
+    this: MathJsChain<U>,
+    unit: Unit
+  ): MathJsChain<U>
+  round(
+    this: MathJsChain<Unit>,
+    n: number | BigNumber,
+    unit: Unit
+  ): MathJsChain<Unit>
+  round<U extends MathCollection>(
+    this: MathJsChain<U>,
+    n: number | BigNumber,
+    unit: Unit
+  ): MathJsChain<U>
 
   // End of rounding group