mathjs 11.0.0 → 11.2.0

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/function/algebra/derivative.js

@@ -42,9 +42,9 @@ var createDerivative = /* #__PURE__ */(0, _factory.factory)(name, dependencies,
    *
    * Examples:
    *
-   *     math.derivative('x^2', 'x')                     // Node {2 * x}
-   *     math.derivative('x^2', 'x', {simplify: false})  // Node {2 * 1 * x ^ (2 - 1)
-   *     math.derivative('sin(2x)', 'x'))                // Node {2 * cos(2 * x)}
+   *     math.derivative('x^2', 'x')                     // Node '2 * x'
+   *     math.derivative('x^2', 'x', {simplify: false})  // Node '2 * 1 * x ^ (2 - 1)'
+   *     math.derivative('sin(2x)', 'x'))                // Node '2 * cos(2 * x)'
    *     math.derivative('2*x', 'x').evaluate()          // number 2
    *     math.derivative('x^2', 'x').evaluate({x: 4})    // number 8
    *     const f = math.parse('x^2')

package/lib/cjs/function/algebra/simplify.js

@@ -167,8 +167,10 @@ var createSimplify = /* #__PURE__ */(0, _factory.factory)(name, dependencies, fu
    *
    * @param {Node | string} expr
    *            The expression to be simplified
-   * @param {Array<{l:string, r: string} | string | function>} [rules]
+   * @param {SimplifyRule[]} [rules]
    *            Optional list with custom rules
+   * @param {Object} [scope] Optional scope with variables
+   * @param {SimplifyOptions} [options] Optional configuration settings
    * @return {Node} Returns the simplified form of `expr`
    */
 

package/lib/cjs/function/algebra/symbolicEqual.js

@@ -38,12 +38,11 @@ var createSymbolicEqual = /* #__PURE__ */(0, _factory.factory)(name, dependencie
    *
    * Examples:
    *
-   *    symbolicEqual('x*y', 'y*x') // true
-   *    symbolicEqual('x*y', 'y*x', {context: {multiply: {commutative: false}}})
-   *        //false
-   *    symbolicEqual('x/y', '(y*x^(-1))^(-1)') // true
-   *    symbolicEqual('abs(x)','x') // false
-   *    symbolicEqual('abs(x)','x', simplify.positiveContext) // true
+   *    symbolicEqual('x*y', 'y*x') // Returns true
+   *    symbolicEqual('x*y', 'y*x', {context: {multiply: {commutative: false}}}) // Returns false
+   *    symbolicEqual('x/y', '(y*x^(-1))^(-1)') // Returns true
+   *    symbolicEqual('abs(x)','x') // Returns false
+   *    symbolicEqual('abs(x)','x', simplify.positiveContext) // Returns true
    *
    * See also:
    *

package/lib/cjs/function/arithmetic/fix.js

@@ -73,7 +73,7 @@ var createFix = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functio
    *
    *    const c = math.complex(3.22, -2.78)
    *    math.fix(c)                  // returns Complex 3 - 2i
-   *    math.fix(c, 1)               // returns Complex 3.2 - 2.7i
+   *    math.fix(c, 1)               // returns Complex 3.2 -2.7i
    *
    *    math.fix([3.2, 3.8, -4.7])      // returns Array [3, 3, -4]
    *    math.fix([3.2, 3.8, -4.7], 1)   // returns Array [3.2, 3.8, -4.7]

package/lib/cjs/function/arithmetic/floor.js

@@ -109,7 +109,7 @@ var createFloor = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
    *
    *    const c = math.complex(3.24, -2.71)
    *    math.floor(c)                 // returns Complex 3 - 3i
-   *    math.floor(c, 1)              // returns Complex 3.2 - 2.8i
+   *    math.floor(c, 1)              // returns Complex 3.2 -2.8i
    *
    *    math.floor([3.2, 3.8, -4.7])       // returns Array [3, 3, -5]
    *    math.floor([3.21, 3.82, -4.71], 1)  // returns Array [3.2, 3.8, -4.8]

package/lib/cjs/function/arithmetic/invmod.js

@@ -35,7 +35,7 @@ var createInvmod = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
    * Examples:
    *
    *    math.invmod(8, 12)             // returns NaN
-   *    math.invmod(7, 13)             // return 2
+   *    math.invmod(7, 13)             // returns 2
    *    math.invmod(15151, 15122)      // returns 10429
    *
    * See also:

package/lib/cjs/function/arithmetic/nthRoot.js

@@ -61,9 +61,9 @@ var createNthRoot = /* #__PURE__ */(0, _factory.factory)(name, dependencies, fun
    *
    * Examples:
    *
-   *     math.nthRoot(9, 2)    // returns 3, as 3^2 == 9
-   *     math.sqrt(9)          // returns 3, as 3^2 == 9
-   *     math.nthRoot(64, 3)   // returns 4, as 4^3 == 64
+   *     math.nthRoot(9, 2)    // returns 3 (since 3^2 == 9)
+   *     math.sqrt(9)          // returns 3 (since 3^2 == 9)
+   *     math.nthRoot(64, 3)   // returns 4 (since 4^3 == 64)
    *
    * See also:
    *

package/lib/cjs/function/arithmetic/nthRoots.js

@@ -98,12 +98,12 @@ var createNthRoots = /* #__PURE__ */(0, _factory.factory)(name, dependencies, fu
    *    //   {re: 1, im: 0},
    *    //   {re: -1, im: 0}
    *    // ]
-   *    nthRoots(1, 3)
+   *    math.nthRoots(1, 3)
    *    // returns [
    *    //   { re: 1, im: 0 },
    *    //   { re: -0.4999999999999998, im: 0.8660254037844387 },
    *    //   { re: -0.5000000000000004, im: -0.8660254037844385 }
-   *    ]
+   *    // ]
    *
    * See also:
    *

package/lib/cjs/function/bitwise/bitNot.js

@@ -31,7 +31,7 @@ var createBitNot = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
    *
    *    math.bitNot(1)               // returns number -2
    *
-   *    math.bitNot([2, -3, 4])      // returns Array [-3, 2, 5]
+   *    math.bitNot([2, -3, 4])      // returns Array [-3, 2, -5]
    *
    * See also:
    *

package/lib/cjs/function/bitwise/leftShift.js

@@ -78,7 +78,7 @@ var createLeftShift = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
    *
    *    math.leftShift(1, 2)               // returns number 4
    *
-   *    math.leftShift([1, 2, 3], 4)       // returns Array [16, 32, 64]
+   *    math.leftShift([1, 2, 4], 4)       // returns Array [16, 32, 64]
    *
    * See also:
    *

package/lib/cjs/function/bitwise/rightArithShift.js

@@ -78,7 +78,7 @@ var createRightArithShift = /* #__PURE__ */(0, _factory.factory)(name, dependenc
    *
    *    math.rightArithShift(4, 2)               // returns number 1
    *
-   *    math.rightArithShift([16, -32, 64], 4)   // returns Array [1, -2, 3]
+   *    math.rightArithShift([16, -32, 64], 4)   // returns Array [1, -2, 4]
    *
    * See also:
    *

package/lib/cjs/function/bitwise/rightLogShift.js

@@ -76,7 +76,7 @@ var createRightLogShift = /* #__PURE__ */(0, _factory.factory)(name, dependencie
    *
    *    math.rightLogShift(4, 2)               // returns number 1
    *
-   *    math.rightLogShift([16, -32, 64], 4)   // returns Array [1, 2, 3]
+   *    math.rightLogShift([16, 32, 64], 4)    // returns Array [1, 2, 4]
    *
    * See also:
    *

package/lib/cjs/function/geometry/distance.js

@@ -48,11 +48,11 @@ var createDistance = /* #__PURE__ */(0, _factory.factory)(name, dependencies, fu
     *    math.distance({pointX: 2, pointY: 5, pointZ: 9}, {x0: 4, y0: 6, z0: 3, a: 4, b: 2, c: 0})
     *
     * Examples:
-    *    math.distance([0,0], [4,4])                     // Returns 5.6569
+    *    math.distance([0,0], [4,4])                     // Returns 5.656854249492381
     *    math.distance(
     *     {pointOneX: 0, pointOneY: 0},
     *     {pointTwoX: 10, pointTwoY: 10})                // Returns 14.142135623730951
-    *    math.distance([1, 0, 1], [4, -2, 2])            // Returns 3.74166
+    *    math.distance([1, 0, 1], [4, -2, 2])            // Returns 3.7416573867739413
     *    math.distance(
     *     {pointOneX: 4, pointOneY: 5, pointOneZ: 8},
     *     {pointTwoX: 2, pointTwoY: 7, pointTwoZ: 9})    // Returns 3

package/lib/cjs/function/matrix/diff.js

@@ -37,7 +37,7 @@ var createDiff = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    *
    *     const arr = [1, 2, 4, 7, 0]
    *     math.diff(arr) // returns [1, 2, 3, -7] (no dimension passed so 0 is assumed)
-   *     math.diff(math.matrix(arr)) // returns math.matrix([1, 2, 3, -7])
+   *     math.diff(math.matrix(arr)) // returns Matrix [1, 2, 3, -7]
    *
    *     const arr = [[1, 2, 3, 4, 5], [1, 2, 3, 4, 5], [9, 8, 7, 6, 4]]
    *     math.diff(arr) // returns [[0, 0, 0, 0, 0], [8, 6, 4, 2, -1]]

package/lib/cjs/function/matrix/rotate.js

@@ -27,13 +27,13 @@ var createRotate = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
      *
      * Examples:
      *
-     *    math.rotate([11, 12], math.pi / 2)                           // returns matrix([-12, 11])
-     *    math.rotate(matrix([11, 12]), math.pi / 2)                   // returns matrix([-12, 11])
+     *    math.rotate([11, 12], math.pi / 2)                           // returns [-12, 11]
+     *    math.rotate(matrix([11, 12]), math.pi / 2)                   // returns [-12, 11]
      *
-     *    math.rotate([1, 0, 0], unit('90deg'), [0, 0, 1])             // returns matrix([0, 1, 0])
-     *    math.rotate(matrix([1, 0, 0]), unit('90deg'), [0, 0, 1])     // returns matrix([0, 1, 0])
+     *    math.rotate([1, 0, 0], unit('90deg'), [0, 0, 1])             // returns [0, 1, 0]
+     *    math.rotate(matrix([1, 0, 0]), unit('90deg'), [0, 0, 1])     // returns Matrix [0, 1, 0]
      *
-     *    math.rotate([1, 0], math.complex(1 + i))                     // returns matrix([cos(1 + i) - sin(1 + i), sin(1 + i) + cos(1 + i)])
+     *    math.rotate([1, 0], math.complex(1 + i))                     // returns [cos(1 + i) - sin(1 + i), sin(1 + i) + cos(1 + i)]
      *
      * See also:
      *

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

@@ -105,14 +105,14 @@ var createFormat = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
    * Examples:
    *
    *    math.format(6.4)                                        // returns '6.4'
-   *    math.format(1240000)                                    // returns '1.24e6'
+   *    math.format(1240000)                                    // returns '1.24e+6'
    *    math.format(1/3)                                        // returns '0.3333333333333333'
    *    math.format(1/3, 3)                                     // returns '0.333'
    *    math.format(21385, 2)                                   // returns '21000'
    *    math.format(12e8, {notation: 'fixed'})                  // returns '1200000000'
    *    math.format(2.3,  {notation: 'fixed', precision: 4})    // returns '2.3000'
    *    math.format(52.8, {notation: 'exponential'})            // returns '5.28e+1'
-   *    math.format(12400,{notation: 'engineering'})            // returns '12.400e+3'
+   *    math.format(12400, {notation: 'engineering'})           // returns '12.4e+3'
    *    math.format(2000, {lowerExp: -2, upperExp: 2})          // returns '2e+3'
    *
    *    function formatCurrency(value) {

package/lib/cjs/function/string/hex.js

@@ -18,8 +18,7 @@ var dependencies = ['typed', 'format'];
  *
  * Examples:
  *
- *    //the following outputs "0xF0"
- *    math.hex(240)
+ *    math.hex(240) // returns "0xF0"
  *
  * See also:
  *

package/lib/cjs/function/trigonometry/acot.js

@@ -27,11 +27,10 @@ var createAcot = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    *
    * Examples:
    *
-   *    math.acot(0.5)           // returns number 0.4636476090008061
+   *    math.acot(0.5)           // returns number 1.1071487177940904
+   *    math.acot(2)             // returns number 0.4636476090008061
    *    math.acot(math.cot(1.5)) // returns number 1.5
    *
-   *    math.acot(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
-   *
    * See also:
    *
    *    cot, atan

package/lib/cjs/function/trigonometry/acsc.js

@@ -29,11 +29,10 @@ var createAcsc = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    *
    * Examples:
    *
-   *    math.acsc(0.5)           // returns number 0.5235987755982989
+   *    math.acsc(2)             // returns 0.5235987755982989
+   *    math.acsc(0.5)           // returns Complex 1.5707963267948966 -1.3169578969248166i
    *    math.acsc(math.csc(1.5)) // returns number ~1.5
    *
-   *    math.acsc(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
-   *
    * See also:
    *
    *    csc, asin, asec

package/lib/cjs/function/trigonometry/asec.js

@@ -29,10 +29,10 @@ var createAsec = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    *
    * Examples:
    *
-   *    math.asec(0.5)           // returns 1.0471975511965979
+   *    math.asec(2)             // returns 1.0471975511965979
    *    math.asec(math.sec(1.5)) // returns 1.5
    *
-   *    math.asec(2)             // returns 0 + 1.3169578969248166 i
+   *    math.asec(0.5)           // returns Complex 0 + 1.3169578969248166i
    *
    * See also:
    *

package/lib/cjs/function/trigonometry/asin.js

@@ -29,7 +29,7 @@ var createAsin = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    *    math.asin(0.5)           // returns number 0.5235987755982989
    *    math.asin(math.sin(1.5)) // returns number ~1.5
    *
-   *    math.asin(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
+   *    math.asin(2)             // returns Complex 1.5707963267948966 -1.3169578969248166i
    *
    * See also:
    *

package/lib/cjs/function/trigonometry/atan.js

@@ -25,10 +25,9 @@ var createAtan = /* #__PURE__ */(0, _factory.factory)(name, dependencies, functi
    * Examples:
    *
    *    math.atan(0.5)           // returns number 0.4636476090008061
+   *    math.atan(2)             // returns number 1.1071487177940904
    *    math.atan(math.tan(1.5)) // returns number 1.5
    *
-   *    math.atan(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
-   *
    * See also:
    *
    *    tan, asin, acos

package/lib/cjs/function/trigonometry/atan2.js

@@ -69,7 +69,7 @@ var createAtan2 = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
    *    const x = math.cos(angle)
    *    const y = math.sin(angle)
    *
-   *    math.atan(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
+   *    math.atan(2)             // returns number 1.1071487177940904
    *
    * See also:
    *

package/lib/cjs/function/utils/clone.js

@@ -24,7 +24,7 @@ var createClone = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
    * Examples:
    *
    *    math.clone(3.5)                   // returns number 3.5
-   *    math.clone(math.complex('2-4i') // returns Complex 2 - 4i
+   *    math.clone(math.complex('2-4i'))  // returns Complex 2 - 4i
    *    math.clone(math.unit(45, 'deg'))  // returns Unit 45 deg
    *    math.clone([[1, 2], [3, 4]])      // returns Array [[1, 2], [3, 4]]
    *    math.clone("hello world")         // returns string "hello world"

package/lib/cjs/function/utils/hasNumericValue.js

@@ -30,7 +30,7 @@ var createHasNumericValue = /* #__PURE__ */(0, _factory.factory)(name, dependenc
    *    math.hasNumericValue(0)                     // returns true
    *    math.hasNumericValue(math.bignumber(500))   // returns true
    *    math.hasNumericValue(math.fraction(4))      // returns true
-   *    math.hasNumericValue(math.complex('2-4i')   // returns false
+   *    math.hasNumericValue(math.complex('2-4i'))  // returns false
    *    math.hasNumericValue(false)                 // returns true
    *    math.hasNumericValue([2.3, 'foo', false])   // returns [true, false, true]
    *

package/lib/cjs/function/utils/isInteger.js

@@ -35,7 +35,7 @@ var createIsInteger = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
    *    math.isInteger(math.fraction(4))      // returns true
    *    math.isInteger('3')                   // returns true
    *    math.isInteger([3, 0.5, -2])          // returns [true, false, true]
-   *    math.isInteger(math.complex('2-4i')   // throws an error
+   *    math.isInteger(math.complex('2-4i'))  // throws an error
    *
    * See also:
    *

package/lib/cjs/function/utils/isNaN.js

@@ -35,7 +35,7 @@ var createIsNaN = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
    *    math.isNaN(math.bignumber(0))     // returns false
    *    math.isNaN(math.fraction(-2, 5))  // returns false
    *    math.isNaN('-2')                  // returns false
-   *    math.isNaN([2, 0, -3, NaN]')      // returns [false, false, false, true]
+   *    math.isNaN([2, 0, -3, NaN])       // returns [false, false, false, true]
    *
    * See also:
    *

package/lib/cjs/function/utils/isNegative.js

@@ -35,7 +35,7 @@ var createIsNegative = /* #__PURE__ */(0, _factory.factory)(name, dependencies,
    *    math.isNegative(math.bignumber(2))     // returns false
    *    math.isNegative(math.fraction(-2, 5))  // returns true
    *    math.isNegative('-2')                  // returns true
-   *    math.isNegative([2, 0, -3]')           // returns [false, false, true]
+   *    math.isNegative([2, 0, -3])            // returns [false, false, true]
    *
    * See also:
    *

package/lib/cjs/function/utils/isNumeric.js

@@ -31,7 +31,7 @@ var createIsNumeric = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
    *    math.isNumeric(0)                     // returns true
    *    math.isNumeric(math.bignumber(500))   // returns true
    *    math.isNumeric(math.fraction(4))      // returns true
-   *    math.isNumeric(math.complex('2-4i')   // returns false
+   *    math.isNumeric(math.complex('2-4i'))  // returns false
    *    math.isNumeric([2.3, 'foo', false])   // returns [true, false, true]
    *
    * See also:

package/lib/cjs/function/utils/isPositive.js

@@ -35,7 +35,7 @@ var createIsPositive = /* #__PURE__ */(0, _factory.factory)(name, dependencies,
    *    math.isPositive(0.5)                   // returns true
    *    math.isPositive(math.bignumber(2))     // returns true
    *    math.isPositive(math.fraction(-2, 5))  // returns false
-   *    math.isPositive(math.fraction(1,3))    // returns false
+   *    math.isPositive(math.fraction(1, 3))   // returns true
    *    math.isPositive('2')                   // returns true
    *    math.isPositive([2, 0, -3])            // returns [true, false, false]
    *

package/lib/cjs/function/utils/isZero.js

@@ -29,17 +29,17 @@ var createIsZero = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
    *
    * Examples:
    *
-   *    math.isZero(0)                     // returns true
-   *    math.isZero(2)                     // returns false
-   *    math.isZero(0.5)                   // returns false
-   *    math.isZero(math.bignumber(0))     // returns true
-   *    math.isZero(math.fraction(0))      // returns true
-   *    math.isZero(math.fraction(1,3))    // returns false
-   *    math.isZero(math.complex('2 - 4i') // returns false
-   *    math.isZero(math.complex('0i')     // returns true
-   *    math.isZero('0')                   // returns true
-   *    math.isZero('2')                   // returns false
-   *    math.isZero([2, 0, -3]')           // returns [false, true, false]
+   *    math.isZero(0)                      // returns true
+   *    math.isZero(2)                      // returns false
+   *    math.isZero(0.5)                    // returns false
+   *    math.isZero(math.bignumber(0))      // returns true
+   *    math.isZero(math.fraction(0))       // returns true
+   *    math.isZero(math.fraction(1,3))     // returns false
+   *    math.isZero(math.complex('2 - 4i')) // returns false
+   *    math.isZero(math.complex('0i'))     // returns true
+   *    math.isZero('0')                    // returns true
+   *    math.isZero('2')                    // returns false
+   *    math.isZero([2, 0, -3])             // returns [false, true, false]
    *
    * See also:
    *

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.0
- * @date    2022-07-23
+ * @version 11.2.0
+ * @date    2022-09-12
  *
  * @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.0'; // Note: This file is automatically generated when building math.js.
+var version = '11.2.0'; // 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