@leankylin-sheet/formula-parser 4.0.18 → 4.0.20

package/README.md

@@ -1,246 +1,246 @@
-:warning: This repository is deprecated. We've released new and improved [HyperFormula](https://github.com/handsontable/hyperformula/) engine.
-
-
-<details>
-
-Formula Parser [![Build Status](https://travis-ci.org/handsontable/formula-parser.png?branch=master)](https://travis-ci.org/handsontable/formula-parser) [![Test Coverage](https://codeclimate.com/github/handsontable/formula-parser/badges/coverage.svg)](https://codeclimate.com/github/handsontable/formula-parser/coverage) [![hot-formula-parser](https://img.shields.io/npm/v/hot-formula-parser.svg)](https://www.npmjs.com/package/hot-formula-parser)
-==========
-Library provides a `Parser` class that evaluates excel and mathematical formulas.
-
-- - -
-
-## Install
-
-A recommended way to install Formula Parser is through [NPM](https://www.npmjs.com/) using the following command:
-
-```sh
-$ npm install hot-formula-parser --save
-```
-
-Node.js:
-```js
-var FormulaParser = require('hot-formula-parser').Parser;
-var parser = new FormulaParser();
-
-parser.parse('SUM(1, 6, 7)'); // It returns `Object {error: null, result: 14}`
-```
-
-Browser:
-```html
-<script src="/node_modules/hot-formula-parser/dist/formula-parser.min.js"></script>
-<script>
-var parser = new formulaParser.Parser();
-
-parser.parse('SUM(1, 6, 7)'); // It returns `Object {error: null, result: 14}`
-</script>
-```
-## Features
-
-It supports:
-
- * Any numbers, negative and positive as float or integer;
- * Arithmetic operations like `+`, `-`, `/`, `*`, `%`, `^`;
- * Logical operations like `AND()`, `OR()`, `NOT()`, `XOR()`;
- * Comparison operations like `=`, `>`, `>=`, `<`, `<=`, `<>`;
- * All JavaScript Math constants like `PI()`, `E()`, `LN10()`, `LN2()`, `LOG10E()`, `LOG2E()`, `SQRT1_2()`, `SQRT2()`;
- * String operations like `&` (concatenation eq. `parser.parse('-(2&5)');` will return `-25`);
- * All excel formulas defined in [formula.js](https://github.com/handsontable/formula.js);
- * Relative and absolute cell coordinates like `A1`, `$A1`, `A$1`, `$A$1`;
- * Build-in variables like `TRUE`, `FALSE`, `NULL`
- * Custom variables;
- * Custom functions/formulas;
- * Node and Browser environment.
-
-## API (methods)
-
-```js
-var parser = new formulaParser.Parser();
-```
-
-### .parse(expression)
-
-Parses and evaluates provided expression. It always returns an object with `result` and `error` properties. `result` property
-always keep evaluated value. If error occurs `error` property will be set as:
- * `#ERROR!` General error;
- * `#DIV/0!` Divide by zero error;
- * `#NAME?` Not recognised function name or variable name;
- * `#N/A` Indicates that a value is not available to a formula;
- * `#NUM!` Occurs when formula encounters an invalid number;
- * `#VALUE!` Occurs when one of formula arguments is of the wrong type.
-
-```js
-parser.parse('(1 + 5 + (5 * 10)) / 10'); // returns `Object {error: null, result: 5.6}`
-parser.parse('SUM(MY_VAR)'); // returns `Object {error: "#NAME?", result: null}`
-parser.parse('1;;1'); // returns `Object {error: "#ERROR!", result: null}`
-```
-
-### .setVariable(name, value)
-
-Set predefined variable name which can be visible while parsing formula expression.
-
-```js
-parser.setVariable('MY_VARIABLE', 5);
-parser.setVariable('fooBar', 10);
-
-parser.parse('(1 + MY_VARIABLE + (5 * fooBar)) / fooBar'); // returns `5.6`
-```
-
-### .getVariable(name)
-
-Get variable name.
-
-```js
-parser.setVariable('fooBar', 10);
-
-parser.getVariable('fooBar'); // returns `10`
-```
-
-### .setFunction(name, fn)
-
-Set custom function which can be visible while parsing formula expression.
-
-```js
-parser.setFunction('ADD_5', function(params) {
-  return params[0] + 5;
-});
-parser.setFunction('GET_LETTER', function(params) {
-  var string = params[0];
-  var index = params[1] - 1;
-
-  return string.charAt(index);
-});
-
-parser.parse('SUM(4, ADD_5(1))'); // returns `10`
-parser.parse('GET_LETTER("Some string", 3)'); // returns `m`
-```
-
-### .getFunction(name)
-
-Get custom function.
-
-```js
-parser.setFunction('ADD_5', function(params) {
-  return params[0] + 5;
-});
-
-parser.getFunction('ADD_5')([1]); // returns `6`
-```
-
-### .SUPPORTED_FORMULAS
-
-List of all supported formulas function.
-
-```js
-require('hot-formula-parser').SUPPORTED_FORMULAS; // An array of formula names
-```
-
-## API (hooks)
-
-### 'callVariable' (name, done)
-
-Fired while retrieving variable. If variable was defined earlier using `setVariable` you can overwrite it by this hook.
-
-```js
-parser.on('callVariable', function(name, done) {
-  if (name === 'foo') {
-    done(Math.PI / 2);
-  }
-});
-
-parser.parse('SUM(SIN(foo), COS(foo))'); // returns `1`
-```
-
-### 'callFunction' (name, params, done)
-
-Fired while calling function. If function was defined earlier using `setFunction` you can overwrite it's result by this hook.
-You can also use this to override result of build-in formulas.
-
-```js
-parser.on('callFunction', function(name, params, done) {
-  if (name === 'ADD_5') {
-    done(params[0] + 5);
-  }
-});
-
-parser.parse('ADD_5(3)'); // returns `8`
-```
-
-### 'callCellValue' (cellCoord, done)
-
-Fired while retrieving cell value by its label (eq: `B3`, `B$3`, `B$3`, `$B$3`).
-
-```js
-parser.on('callCellValue', function(cellCoord, done) {
-  // using label
-  if (cellCoord.label === 'B$6') {
-    done('hello');
-  }
-  // or using indexes
-  if (cellCoord.row.index === 5 && cellCoord.row.isAbsolute && cellCoord.column.index === 1 && !cellCoord.column.isAbsolute) {
-    done('hello');
-  }
-
-  if (cellCoord.label === 'C6') {
-    done(0.75);
-  }
-});
-
-parser.parse('B$6'); // returns `"hello"`
-parser.parse('B$6&" world"'); // returns `"hello world"`
-parser.parse('FISHER(C6)'); // returns `0.9729550745276566`
-```
-
-### 'callRangeValue' (startCellCoord, endCellCoord, done)
-
-Fired while retrieving cells range value (eq: `A1:B3`, `$A1:B$3`, `A$1:B$3`, `$A$1:$B$3`).
-
-```js
-parser.on('callRangeValue', function(startCellCoord, endCellCoord, done) {
-  var data = [
-    [1, 2, 3, 4, 5],
-    [6, 7, 8, 9, 10],
-    [11, 12, 13, 14, 15],
-    [16, 17, 18, 19, 20],
-  ];
-  var fragment = [];
-
-  for (var row = startCellCoord.row.index; row <= endCellCoord.row.index; row++) {
-    var rowData = data[row];
-    var colFragment = [];
-
-    for (var col = startCellCoord.column.index; col <= endCellCoord.column.index; col++) {
-      colFragment.push(rowData[col]);
-    }
-    fragment.push(colFragment);
-  }
-
-  if (fragment) {
-    done(fragment);
-  }
-});
-
-parser.parse('JOIN(A1:E2)'); // returns `"1,2,3,4,5,6,7,8,9,10"`
-parser.parse('COLUMNS(A1:E2)'); // returns `5`
-parser.parse('ROWS(A1:E2)'); // returns `2`
-parser.parse('COUNT(A1:E2)'); // returns `10`
-parser.parse('COUNTIF(A1:E2, ">5")'); // returns `5`
-```
-
-### Want to help?
-
-Please see [CONTRIBUTING.md](CONTRIBUTING.md).
-
-### Changelog
-
-To see the list of recent changes, see [Releases section](https://github.com/handsontable/formula-parser/releases).
-
-### License
-
-The MIT License (see the [LICENSE](https://github.com/handsontable/formula-parser/blob/master/LICENSE) file for the full text).
-
-### Contact
-
-You can contact us at hello@handsontable.com.
-  
-</details>
-
+:warning: This repository is deprecated. We've released new and improved [HyperFormula](https://github.com/handsontable/hyperformula/) engine.
+
+
+<details>
+
+Formula Parser [![Build Status](https://travis-ci.org/handsontable/formula-parser.png?branch=master)](https://travis-ci.org/handsontable/formula-parser) [![Test Coverage](https://codeclimate.com/github/handsontable/formula-parser/badges/coverage.svg)](https://codeclimate.com/github/handsontable/formula-parser/coverage) [![hot-formula-parser](https://img.shields.io/npm/v/hot-formula-parser.svg)](https://www.npmjs.com/package/hot-formula-parser)
+==========
+Library provides a `Parser` class that evaluates excel and mathematical formulas.
+
+- - -
+
+## Install
+
+A recommended way to install Formula Parser is through [NPM](https://www.npmjs.com/) using the following command:
+
+```sh
+$ npm install hot-formula-parser --save
+```
+
+Node.js:
+```js
+var FormulaParser = require('hot-formula-parser').Parser;
+var parser = new FormulaParser();
+
+parser.parse('SUM(1, 6, 7)'); // It returns `Object {error: null, result: 14}`
+```
+
+Browser:
+```html
+<script src="/node_modules/hot-formula-parser/dist/formula-parser.min.js"></script>
+<script>
+var parser = new formulaParser.Parser();
+
+parser.parse('SUM(1, 6, 7)'); // It returns `Object {error: null, result: 14}`
+</script>
+```
+## Features
+
+It supports:
+
+ * Any numbers, negative and positive as float or integer;
+ * Arithmetic operations like `+`, `-`, `/`, `*`, `%`, `^`;
+ * Logical operations like `AND()`, `OR()`, `NOT()`, `XOR()`;
+ * Comparison operations like `=`, `>`, `>=`, `<`, `<=`, `<>`;
+ * All JavaScript Math constants like `PI()`, `E()`, `LN10()`, `LN2()`, `LOG10E()`, `LOG2E()`, `SQRT1_2()`, `SQRT2()`;
+ * String operations like `&` (concatenation eq. `parser.parse('-(2&5)');` will return `-25`);
+ * All excel formulas defined in [formula.js](https://github.com/handsontable/formula.js);
+ * Relative and absolute cell coordinates like `A1`, `$A1`, `A$1`, `$A$1`;
+ * Build-in variables like `TRUE`, `FALSE`, `NULL`
+ * Custom variables;
+ * Custom functions/formulas;
+ * Node and Browser environment.
+
+## API (methods)
+
+```js
+var parser = new formulaParser.Parser();
+```
+
+### .parse(expression)
+
+Parses and evaluates provided expression. It always returns an object with `result` and `error` properties. `result` property
+always keep evaluated value. If error occurs `error` property will be set as:
+ * `#ERROR!` General error;
+ * `#DIV/0!` Divide by zero error;
+ * `#NAME?` Not recognised function name or variable name;
+ * `#N/A` Indicates that a value is not available to a formula;
+ * `#NUM!` Occurs when formula encounters an invalid number;
+ * `#VALUE!` Occurs when one of formula arguments is of the wrong type.
+
+```js
+parser.parse('(1 + 5 + (5 * 10)) / 10'); // returns `Object {error: null, result: 5.6}`
+parser.parse('SUM(MY_VAR)'); // returns `Object {error: "#NAME?", result: null}`
+parser.parse('1;;1'); // returns `Object {error: "#ERROR!", result: null}`
+```
+
+### .setVariable(name, value)
+
+Set predefined variable name which can be visible while parsing formula expression.
+
+```js
+parser.setVariable('MY_VARIABLE', 5);
+parser.setVariable('fooBar', 10);
+
+parser.parse('(1 + MY_VARIABLE + (5 * fooBar)) / fooBar'); // returns `5.6`
+```
+
+### .getVariable(name)
+
+Get variable name.
+
+```js
+parser.setVariable('fooBar', 10);
+
+parser.getVariable('fooBar'); // returns `10`
+```
+
+### .setFunction(name, fn)
+
+Set custom function which can be visible while parsing formula expression.
+
+```js
+parser.setFunction('ADD_5', function(params) {
+  return params[0] + 5;
+});
+parser.setFunction('GET_LETTER', function(params) {
+  var string = params[0];
+  var index = params[1] - 1;
+
+  return string.charAt(index);
+});
+
+parser.parse('SUM(4, ADD_5(1))'); // returns `10`
+parser.parse('GET_LETTER("Some string", 3)'); // returns `m`
+```
+
+### .getFunction(name)
+
+Get custom function.
+
+```js
+parser.setFunction('ADD_5', function(params) {
+  return params[0] + 5;
+});
+
+parser.getFunction('ADD_5')([1]); // returns `6`
+```
+
+### .SUPPORTED_FORMULAS
+
+List of all supported formulas function.
+
+```js
+require('hot-formula-parser').SUPPORTED_FORMULAS; // An array of formula names
+```
+
+## API (hooks)
+
+### 'callVariable' (name, done)
+
+Fired while retrieving variable. If variable was defined earlier using `setVariable` you can overwrite it by this hook.
+
+```js
+parser.on('callVariable', function(name, done) {
+  if (name === 'foo') {
+    done(Math.PI / 2);
+  }
+});
+
+parser.parse('SUM(SIN(foo), COS(foo))'); // returns `1`
+```
+
+### 'callFunction' (name, params, done)
+
+Fired while calling function. If function was defined earlier using `setFunction` you can overwrite it's result by this hook.
+You can also use this to override result of build-in formulas.
+
+```js
+parser.on('callFunction', function(name, params, done) {
+  if (name === 'ADD_5') {
+    done(params[0] + 5);
+  }
+});
+
+parser.parse('ADD_5(3)'); // returns `8`
+```
+
+### 'callCellValue' (cellCoord, done)
+
+Fired while retrieving cell value by its label (eq: `B3`, `B$3`, `B$3`, `$B$3`).
+
+```js
+parser.on('callCellValue', function(cellCoord, done) {
+  // using label
+  if (cellCoord.label === 'B$6') {
+    done('hello');
+  }
+  // or using indexes
+  if (cellCoord.row.index === 5 && cellCoord.row.isAbsolute && cellCoord.column.index === 1 && !cellCoord.column.isAbsolute) {
+    done('hello');
+  }
+
+  if (cellCoord.label === 'C6') {
+    done(0.75);
+  }
+});
+
+parser.parse('B$6'); // returns `"hello"`
+parser.parse('B$6&" world"'); // returns `"hello world"`
+parser.parse('FISHER(C6)'); // returns `0.9729550745276566`
+```
+
+### 'callRangeValue' (startCellCoord, endCellCoord, done)
+
+Fired while retrieving cells range value (eq: `A1:B3`, `$A1:B$3`, `A$1:B$3`, `$A$1:$B$3`).
+
+```js
+parser.on('callRangeValue', function(startCellCoord, endCellCoord, done) {
+  var data = [
+    [1, 2, 3, 4, 5],
+    [6, 7, 8, 9, 10],
+    [11, 12, 13, 14, 15],
+    [16, 17, 18, 19, 20],
+  ];
+  var fragment = [];
+
+  for (var row = startCellCoord.row.index; row <= endCellCoord.row.index; row++) {
+    var rowData = data[row];
+    var colFragment = [];
+
+    for (var col = startCellCoord.column.index; col <= endCellCoord.column.index; col++) {
+      colFragment.push(rowData[col]);
+    }
+    fragment.push(colFragment);
+  }
+
+  if (fragment) {
+    done(fragment);
+  }
+});
+
+parser.parse('JOIN(A1:E2)'); // returns `"1,2,3,4,5,6,7,8,9,10"`
+parser.parse('COLUMNS(A1:E2)'); // returns `5`
+parser.parse('ROWS(A1:E2)'); // returns `2`
+parser.parse('COUNT(A1:E2)'); // returns `10`
+parser.parse('COUNTIF(A1:E2, ">5")'); // returns `5`
+```
+
+### Want to help?
+
+Please see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+### Changelog
+
+To see the list of recent changes, see [Releases section](https://github.com/handsontable/formula-parser/releases).
+
+### License
+
+The MIT License (see the [LICENSE](https://github.com/handsontable/formula-parser/blob/master/LICENSE) file for the full text).
+
+### Contact
+
+You can contact us at hello@handsontable.com.
+  
+</details>
+

package/dist/index.esm.js

@@ -167,11 +167,11 @@ function _nonIterableRest() {
   throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 
-/**
- * Convert value into number.
- *
- * @param {String|Number} number
- * @returns {*}
+/**
+ * Convert value into number.
+ *
+ * @param {String|Number} number
+ * @returns {*}
  */
 function toNumber(number) {
   var result;
@@ -183,11 +183,11 @@ function toNumber(number) {
   return result;
 }
 
-/**
- * Invert provided number.
- *
- * @param {Number} number
- * @returns {Number} Returns inverted number.
+/**
+ * Invert provided number.
+ *
+ * @param {Number} number
+ * @returns {Number} Returns inverted number.
  */
 function invertNumber(number) {
   return -1 * toNumber(number);
@@ -203,11 +203,11 @@ var ERROR_REF = 'REF';
 var ERROR_VALUE = 'VALUE';
 var errors = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, ERROR, '#ERROR!'), ERROR_DIV_ZERO, '#DIV/0!'), ERROR_NAME, '#NAME?'), ERROR_NOT_AVAILABLE, '#N/A'), ERROR_NULL, '#NULL!'), ERROR_NUM, '#NUM!'), ERROR_REF, '#REF!'), ERROR_VALUE, '#VALUE!');
 
-/**
- * Return error type based on provided error id.
- *
- * @param {String} type Error type.
- * @returns {String|null} Returns error id.
+/**
+ * Return error type based on provided error id.
+ *
+ * @param {String} type Error type.
+ * @returns {String|null} Returns error id.
  */
 function error(type) {
   var result;
@@ -218,11 +218,11 @@ function error(type) {
   return result ? result : null;
 }
 
-/**
- * Check if error type is strict valid with knows errors.
- *
- * @param {String} Error type.
- * @return {Boolean}
+/**
+ * Check if error type is strict valid with knows errors.
+ *
+ * @param {String} Error type.
+ * @return {Boolean}
  */
 function isValidStrict(type) {
   var valid = false;
@@ -399,12 +399,12 @@ func$c.SYMBOL = SYMBOL$c;
 
 var availableOperators = Object.create(null);
 
-/**
- * Evaluate values by operator id.git
- *
- * @param {String} operator Operator id.
- * @param {Array} [params=[]] Arguments to evaluate.
- * @returns {*}
+/**
+ * Evaluate values by operator id.git
+ *
+ * @param {String} operator Operator id.
+ * @param {Array} [params=[]] Arguments to evaluate.
+ * @returns {*}
  */
 function evaluateByOperator(operator) {
   var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
@@ -415,11 +415,11 @@ function evaluateByOperator(operator) {
   return availableOperators[operator].apply(availableOperators, _toConsumableArray(params));
 }
 
-/**
- * Register operator.
- *
- * @param {String|Array} symbol Symbol to register.
- * @param {Function} func Logic to register for this symbol.
+/**
+ * Register operator.
+ *
+ * @param {String|Array} symbol Symbol to register.
+ * @param {Function} func Logic to register for this symbol.
  */
 function registerOperation(symbol, func) {
   if (!Array.isArray(symbol)) {
@@ -1855,12 +1855,12 @@ Parser.prototype = parser;
 parser.Parser = Parser;
 
 /* eslint-disable import/prefer-default-export */
-/**
- * Trim value by cutting character starting from the beginning and ending at the same time.
- *
- * @param {String} string String to trimming.
- * @param {Number} [margin=1] Number of character to cut.
- * @returns {String}
+/**
+ * Trim value by cutting character starting from the beginning and ending at the same time.
+ *
+ * @param {String} string String to trimming.
+ * @param {Number} [margin=1] Number of character to cut.
+ * @returns {String}
  */
 function trimEdges(string) {
   var margin = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
@@ -1868,11 +1868,11 @@ function trimEdges(string) {
   return string;
 }
 
-/**
- * Convert row label to index.
- *
- * @param {String} label Row label (eq. '1', '5')
- * @returns {Number} Returns -1 if label is not recognized otherwise proper row index.
+/**
+ * Convert row label to index.
+ *
+ * @param {String} label Row label (eq. '1', '5')
+ * @returns {Number} Returns -1 if label is not recognized otherwise proper row index.
  */
 function rowLabelToIndex(label) {
   var result = parseInt(label, 10);
@@ -1884,11 +1884,11 @@ function rowLabelToIndex(label) {
   return result;
 }
 
-/**
- * Convert row index to label.
- *
- * @param {Number} row Row index.
- * @returns {String} Returns row label (eq. '1', '7').
+/**
+ * Convert row index to label.
+ *
+ * @param {Number} row Row index.
+ * @returns {String} Returns row label (eq. '1', '7').
  */
 function rowIndexToLabel(row) {
   var result = "";
@@ -1900,11 +1900,11 @@ function rowIndexToLabel(row) {
 var COLUMN_LABEL_BASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 var COLUMN_LABEL_BASE_LENGTH = COLUMN_LABEL_BASE.length;
 
-/**
- * Convert column label to index.
- *
- * @param {String} label Column label (eq. 'ABB', 'CNQ')
- * @returns {Number} Returns -1 if label is not recognized otherwise proper column index.
+/**
+ * Convert column label to index.
+ *
+ * @param {String} label Column label (eq. 'ABB', 'CNQ')
+ * @returns {Number} Returns -1 if label is not recognized otherwise proper column index.
  */
 function columnLabelToIndex(label) {
   var result = 0;
@@ -1918,11 +1918,11 @@ function columnLabelToIndex(label) {
   return result;
 }
 
-/**
- * Convert column index to label.
- *
- * @param {Number} column Column index.
- * @returns {String} Returns column label (eq. 'ABB', 'CNQ').
+/**
+ * Convert column index to label.
+ *
+ * @param {Number} column Column index.
+ * @returns {String} Returns column label (eq. 'ABB', 'CNQ').
  */
 function columnIndexToLabel(column) {
   var result = "";
@@ -1937,11 +1937,11 @@ var quotedSheetName$1 = "'(?:(?!').|'')*'";
 var sheetNameRegexp$1 = "(".concat(simpleSheetName$1, "|").concat(quotedSheetName$1, ")!");
 var LABEL_EXTRACT_REGEXP = new RegExp("^(?:".concat(sheetNameRegexp$1, ")?([$])?([A-Za-z]*)([$])?([0-9]*)$"));
 
-/**
- * Extract cell coordinates.
- *
- * @param {String} label Cell coordinates (eq. 'A1', '$B6', '$N$98').
- * @returns {Array} Returns an array of objects.
+/**
+ * Extract cell coordinates.
+ *
+ * @param {String} label Cell coordinates (eq. 'A1', '$B6', '$N$98').
+ * @returns {Array} Returns an array of objects.
  */
 function extractLabel(label) {
   if (typeof label !== "string" || !LABEL_EXTRACT_REGEXP.test(label)) {
@@ -1967,12 +1967,12 @@ function extractLabel(label) {
   }, sheetName];
 }
 
-/**
- * Convert row and column indexes into cell label.
- *
- * @param {Object} row Object with `index` and `isAbsolute` properties.
- * @param {Object} column Object with `index` and `isAbsolute` properties.
- * @returns {String} Returns cell label.
+/**
+ * Convert row and column indexes into cell label.
+ *
+ * @param {Object} row Object with `index` and `isAbsolute` properties.
+ * @param {Object} column Object with `index` and `isAbsolute` properties.
+ * @returns {String} Returns cell label.
  */
 function toLabel(row, column) {
   var rowLabel = (row.isAbsolute ? "$" : "") + rowIndexToLabel(row.index);
@@ -1980,8 +1980,8 @@ function toLabel(row, column) {
   return columnLabel + rowLabel;
 }
 
-/**
- * @class Parser
+/**
+ * @class Parser
  */
 var Parser$1 = /*#__PURE__*/function (_Emitter) {
   function Parser$1() {
@@ -2017,13 +2017,13 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
     return _this;
   }
 
-  /**
-   * Parse formula expression.
-   *
-   * @param {string} expression to parse.
-   * @param {object} options additional params.
-   * @param {string} options.sheetId id of sheet which the formula expression belongs to.
-   * @return {*} Returns an object with tow properties `error` and `result`.
+  /**
+   * Parse formula expression.
+   *
+   * @param {string} expression to parse.
+   * @param {object} options additional params.
+   * @param {string} options.sheetId id of sheet which the formula expression belongs to.
+   * @return {*} Returns an object with tow properties `error` and `result`.
    */
   _inherits(Parser$1, _Emitter);
   return _createClass(Parser$1, [{
@@ -2056,12 +2056,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       };
     }
 
-    /**
-     * Set predefined variable name which can be visible while parsing formula expression.
-     *
-     * @param {String} name Variable name.
-     * @param {*} value Variable value.
-     * @returns {Parser}
+    /**
+     * Set predefined variable name which can be visible while parsing formula expression.
+     *
+     * @param {String} name Variable name.
+     * @param {*} value Variable value.
+     * @returns {Parser}
      */
   }, {
     key: "setVariable",
@@ -2074,11 +2074,11 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
     value: function replaceVariables(variables) {
       this.variables = variables;
     }
-    /**
-     * Get variable name.
-     *
-     * @param {String} name Variable name.
-     * @returns {*}
+    /**
+     * Get variable name.
+     *
+     * @param {String} name Variable name.
+     * @returns {*}
      */
   }, {
     key: "getVariable",
@@ -2086,12 +2086,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this.variables[name];
     }
 
-    /**
-     * Retrieve variable value by its name.
-     *
-     * @param name Variable name.
-     * @returns {*}
-     * @private
+    /**
+     * Retrieve variable value by its name.
+     *
+     * @param name Variable name.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callVariable",
@@ -2108,12 +2108,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value;
     }
 
-    /**
-     * Set custom function which can be visible while parsing formula expression.
-     *
-     * @param {String} name Custom function name.
-     * @param {Function} fn Custom function.
-     * @returns {Parser}
+    /**
+     * Set custom function which can be visible while parsing formula expression.
+     *
+     * @param {String} name Custom function name.
+     * @param {Function} fn Custom function.
+     * @returns {Parser}
      */
   }, {
     key: "setFunction",
@@ -2122,11 +2122,11 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this;
     }
 
-    /**
-     * Get custom function.
-     *
-     * @param {String} name Custom function name.
-     * @returns {*}
+    /**
+     * Get custom function.
+     *
+     * @param {String} name Custom function name.
+     * @returns {*}
      */
   }, {
     key: "getFunction",
@@ -2134,13 +2134,13 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this.functions[name];
     }
 
-    /**
-     * Call function with provided params.
-     *
-     * @param name Function name.
-     * @param params Function params.
-     * @returns {*}
-     * @private
+    /**
+     * Call function with provided params.
+     *
+     * @param name Function name.
+     * @param params Function params.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callFunction",
@@ -2159,16 +2159,17 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value === void 0 ? evaluateByOperator(name, params) : value;
     }
 
-    /**
-     * Retrieve value by its label (`B3`, `B$3`, `B$3`, `$B$3`).
-     *
-     * @param {String} label Coordinates.
-     * @returns {*}
-     * @private
+    /**
+     * Retrieve value by its label (`B3`, `B$3`, `B$3`, `$B$3`).
+     *
+     * @param {String} label Coordinates.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callCellValue",
     value: function _callCellValue(label) {
+      var _value2;
       var _extractLabel = extractLabel(label),
         _extractLabel2 = _slicedToArray(_extractLabel, 3),
         row = _extractLabel2[0],
@@ -2191,16 +2192,16 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       }, this.options, function (_value) {
         value = _value;
       });
-      return value;
+      return (_value2 = value) !== null && _value2 !== void 0 ? _value2 : 0;
     }
 
-    /**
-     * Retrieve value by its label (`B3:A1`, `B$3:A1`, `B$3:$A1`, `$B$3:A$1`).
-     *
-     * @param {String} startLabel Coordinates of the first cell.
-     * @param {String} endLabel Coordinates of the last cell.
-     * @returns {Array} Returns an array of mixed values.
-     * @private
+    /**
+     * Retrieve value by its label (`B3:A1`, `B$3:A1`, `B$3:$A1`, `$B$3:A$1`).
+     *
+     * @param {String} startLabel Coordinates of the first cell.
+     * @param {String} endLabel Coordinates of the last cell.
+     * @returns {Array} Returns an array of mixed values.
+     * @private
      */
   }, {
     key: "_callRangeValue",
@@ -2245,12 +2246,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value;
     }
 
-    /**
-     * Try to throw error by its name.
-     *
-     * @param {String} errorName Error name.
-     * @returns {String}
-     * @private
+    /**
+     * Try to throw error by its name.
+     *
+     * @param {String} errorName Error name.
+     * @returns {String}
+     * @private
      */
   }, {
     key: "_throwError",

package/dist/index.js

@@ -196,11 +196,11 @@ function _nonIterableRest() {
   throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 
-/**
- * Convert value into number.
- *
- * @param {String|Number} number
- * @returns {*}
+/**
+ * Convert value into number.
+ *
+ * @param {String|Number} number
+ * @returns {*}
  */
 function toNumber(number) {
   var result;
@@ -212,11 +212,11 @@ function toNumber(number) {
   return result;
 }
 
-/**
- * Invert provided number.
- *
- * @param {Number} number
- * @returns {Number} Returns inverted number.
+/**
+ * Invert provided number.
+ *
+ * @param {Number} number
+ * @returns {Number} Returns inverted number.
  */
 function invertNumber(number) {
   return -1 * toNumber(number);
@@ -232,11 +232,11 @@ var ERROR_REF = 'REF';
 var ERROR_VALUE = 'VALUE';
 var errors = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, ERROR, '#ERROR!'), ERROR_DIV_ZERO, '#DIV/0!'), ERROR_NAME, '#NAME?'), ERROR_NOT_AVAILABLE, '#N/A'), ERROR_NULL, '#NULL!'), ERROR_NUM, '#NUM!'), ERROR_REF, '#REF!'), ERROR_VALUE, '#VALUE!');
 
-/**
- * Return error type based on provided error id.
- *
- * @param {String} type Error type.
- * @returns {String|null} Returns error id.
+/**
+ * Return error type based on provided error id.
+ *
+ * @param {String} type Error type.
+ * @returns {String|null} Returns error id.
  */
 function error(type) {
   var result;
@@ -247,11 +247,11 @@ function error(type) {
   return result ? result : null;
 }
 
-/**
- * Check if error type is strict valid with knows errors.
- *
- * @param {String} Error type.
- * @return {Boolean}
+/**
+ * Check if error type is strict valid with knows errors.
+ *
+ * @param {String} Error type.
+ * @return {Boolean}
  */
 function isValidStrict(type) {
   var valid = false;
@@ -428,12 +428,12 @@ func$c.SYMBOL = SYMBOL$c;
 
 var availableOperators = Object.create(null);
 
-/**
- * Evaluate values by operator id.git
- *
- * @param {String} operator Operator id.
- * @param {Array} [params=[]] Arguments to evaluate.
- * @returns {*}
+/**
+ * Evaluate values by operator id.git
+ *
+ * @param {String} operator Operator id.
+ * @param {Array} [params=[]] Arguments to evaluate.
+ * @returns {*}
  */
 function evaluateByOperator(operator) {
   var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
@@ -444,11 +444,11 @@ function evaluateByOperator(operator) {
   return availableOperators[operator].apply(availableOperators, _toConsumableArray(params));
 }
 
-/**
- * Register operator.
- *
- * @param {String|Array} symbol Symbol to register.
- * @param {Function} func Logic to register for this symbol.
+/**
+ * Register operator.
+ *
+ * @param {String|Array} symbol Symbol to register.
+ * @param {Function} func Logic to register for this symbol.
  */
 function registerOperation(symbol, func) {
   if (!Array.isArray(symbol)) {
@@ -1884,12 +1884,12 @@ Parser.prototype = parser;
 parser.Parser = Parser;
 
 /* eslint-disable import/prefer-default-export */
-/**
- * Trim value by cutting character starting from the beginning and ending at the same time.
- *
- * @param {String} string String to trimming.
- * @param {Number} [margin=1] Number of character to cut.
- * @returns {String}
+/**
+ * Trim value by cutting character starting from the beginning and ending at the same time.
+ *
+ * @param {String} string String to trimming.
+ * @param {Number} [margin=1] Number of character to cut.
+ * @returns {String}
  */
 function trimEdges(string) {
   var margin = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
@@ -1897,11 +1897,11 @@ function trimEdges(string) {
   return string;
 }
 
-/**
- * Convert row label to index.
- *
- * @param {String} label Row label (eq. '1', '5')
- * @returns {Number} Returns -1 if label is not recognized otherwise proper row index.
+/**
+ * Convert row label to index.
+ *
+ * @param {String} label Row label (eq. '1', '5')
+ * @returns {Number} Returns -1 if label is not recognized otherwise proper row index.
  */
 function rowLabelToIndex(label) {
   var result = parseInt(label, 10);
@@ -1913,11 +1913,11 @@ function rowLabelToIndex(label) {
   return result;
 }
 
-/**
- * Convert row index to label.
- *
- * @param {Number} row Row index.
- * @returns {String} Returns row label (eq. '1', '7').
+/**
+ * Convert row index to label.
+ *
+ * @param {Number} row Row index.
+ * @returns {String} Returns row label (eq. '1', '7').
  */
 function rowIndexToLabel(row) {
   var result = "";
@@ -1929,11 +1929,11 @@ function rowIndexToLabel(row) {
 var COLUMN_LABEL_BASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 var COLUMN_LABEL_BASE_LENGTH = COLUMN_LABEL_BASE.length;
 
-/**
- * Convert column label to index.
- *
- * @param {String} label Column label (eq. 'ABB', 'CNQ')
- * @returns {Number} Returns -1 if label is not recognized otherwise proper column index.
+/**
+ * Convert column label to index.
+ *
+ * @param {String} label Column label (eq. 'ABB', 'CNQ')
+ * @returns {Number} Returns -1 if label is not recognized otherwise proper column index.
  */
 function columnLabelToIndex(label) {
   var result = 0;
@@ -1947,11 +1947,11 @@ function columnLabelToIndex(label) {
   return result;
 }
 
-/**
- * Convert column index to label.
- *
- * @param {Number} column Column index.
- * @returns {String} Returns column label (eq. 'ABB', 'CNQ').
+/**
+ * Convert column index to label.
+ *
+ * @param {Number} column Column index.
+ * @returns {String} Returns column label (eq. 'ABB', 'CNQ').
  */
 function columnIndexToLabel(column) {
   var result = "";
@@ -1966,11 +1966,11 @@ var quotedSheetName$1 = "'(?:(?!').|'')*'";
 var sheetNameRegexp$1 = "(".concat(simpleSheetName$1, "|").concat(quotedSheetName$1, ")!");
 var LABEL_EXTRACT_REGEXP = new RegExp("^(?:".concat(sheetNameRegexp$1, ")?([$])?([A-Za-z]*)([$])?([0-9]*)$"));
 
-/**
- * Extract cell coordinates.
- *
- * @param {String} label Cell coordinates (eq. 'A1', '$B6', '$N$98').
- * @returns {Array} Returns an array of objects.
+/**
+ * Extract cell coordinates.
+ *
+ * @param {String} label Cell coordinates (eq. 'A1', '$B6', '$N$98').
+ * @returns {Array} Returns an array of objects.
  */
 function extractLabel(label) {
   if (typeof label !== "string" || !LABEL_EXTRACT_REGEXP.test(label)) {
@@ -1996,12 +1996,12 @@ function extractLabel(label) {
   }, sheetName];
 }
 
-/**
- * Convert row and column indexes into cell label.
- *
- * @param {Object} row Object with `index` and `isAbsolute` properties.
- * @param {Object} column Object with `index` and `isAbsolute` properties.
- * @returns {String} Returns cell label.
+/**
+ * Convert row and column indexes into cell label.
+ *
+ * @param {Object} row Object with `index` and `isAbsolute` properties.
+ * @param {Object} column Object with `index` and `isAbsolute` properties.
+ * @returns {String} Returns cell label.
  */
 function toLabel(row, column) {
   var rowLabel = (row.isAbsolute ? "$" : "") + rowIndexToLabel(row.index);
@@ -2009,8 +2009,8 @@ function toLabel(row, column) {
   return columnLabel + rowLabel;
 }
 
-/**
- * @class Parser
+/**
+ * @class Parser
  */
 var Parser$1 = /*#__PURE__*/function (_Emitter) {
   function Parser$1() {
@@ -2046,13 +2046,13 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
     return _this;
   }
 
-  /**
-   * Parse formula expression.
-   *
-   * @param {string} expression to parse.
-   * @param {object} options additional params.
-   * @param {string} options.sheetId id of sheet which the formula expression belongs to.
-   * @return {*} Returns an object with tow properties `error` and `result`.
+  /**
+   * Parse formula expression.
+   *
+   * @param {string} expression to parse.
+   * @param {object} options additional params.
+   * @param {string} options.sheetId id of sheet which the formula expression belongs to.
+   * @return {*} Returns an object with tow properties `error` and `result`.
    */
   _inherits(Parser$1, _Emitter);
   return _createClass(Parser$1, [{
@@ -2085,12 +2085,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       };
     }
 
-    /**
-     * Set predefined variable name which can be visible while parsing formula expression.
-     *
-     * @param {String} name Variable name.
-     * @param {*} value Variable value.
-     * @returns {Parser}
+    /**
+     * Set predefined variable name which can be visible while parsing formula expression.
+     *
+     * @param {String} name Variable name.
+     * @param {*} value Variable value.
+     * @returns {Parser}
      */
   }, {
     key: "setVariable",
@@ -2103,11 +2103,11 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
     value: function replaceVariables(variables) {
       this.variables = variables;
     }
-    /**
-     * Get variable name.
-     *
-     * @param {String} name Variable name.
-     * @returns {*}
+    /**
+     * Get variable name.
+     *
+     * @param {String} name Variable name.
+     * @returns {*}
      */
   }, {
     key: "getVariable",
@@ -2115,12 +2115,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this.variables[name];
     }
 
-    /**
-     * Retrieve variable value by its name.
-     *
-     * @param name Variable name.
-     * @returns {*}
-     * @private
+    /**
+     * Retrieve variable value by its name.
+     *
+     * @param name Variable name.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callVariable",
@@ -2137,12 +2137,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value;
     }
 
-    /**
-     * Set custom function which can be visible while parsing formula expression.
-     *
-     * @param {String} name Custom function name.
-     * @param {Function} fn Custom function.
-     * @returns {Parser}
+    /**
+     * Set custom function which can be visible while parsing formula expression.
+     *
+     * @param {String} name Custom function name.
+     * @param {Function} fn Custom function.
+     * @returns {Parser}
      */
   }, {
     key: "setFunction",
@@ -2151,11 +2151,11 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this;
     }
 
-    /**
-     * Get custom function.
-     *
-     * @param {String} name Custom function name.
-     * @returns {*}
+    /**
+     * Get custom function.
+     *
+     * @param {String} name Custom function name.
+     * @returns {*}
      */
   }, {
     key: "getFunction",
@@ -2163,13 +2163,13 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return this.functions[name];
     }
 
-    /**
-     * Call function with provided params.
-     *
-     * @param name Function name.
-     * @param params Function params.
-     * @returns {*}
-     * @private
+    /**
+     * Call function with provided params.
+     *
+     * @param name Function name.
+     * @param params Function params.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callFunction",
@@ -2188,16 +2188,17 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value === void 0 ? evaluateByOperator(name, params) : value;
     }
 
-    /**
-     * Retrieve value by its label (`B3`, `B$3`, `B$3`, `$B$3`).
-     *
-     * @param {String} label Coordinates.
-     * @returns {*}
-     * @private
+    /**
+     * Retrieve value by its label (`B3`, `B$3`, `B$3`, `$B$3`).
+     *
+     * @param {String} label Coordinates.
+     * @returns {*}
+     * @private
      */
   }, {
     key: "_callCellValue",
     value: function _callCellValue(label) {
+      var _value2;
       var _extractLabel = extractLabel(label),
         _extractLabel2 = _slicedToArray(_extractLabel, 3),
         row = _extractLabel2[0],
@@ -2220,16 +2221,16 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       }, this.options, function (_value) {
         value = _value;
       });
-      return value;
+      return (_value2 = value) !== null && _value2 !== void 0 ? _value2 : 0;
     }
 
-    /**
-     * Retrieve value by its label (`B3:A1`, `B$3:A1`, `B$3:$A1`, `$B$3:A$1`).
-     *
-     * @param {String} startLabel Coordinates of the first cell.
-     * @param {String} endLabel Coordinates of the last cell.
-     * @returns {Array} Returns an array of mixed values.
-     * @private
+    /**
+     * Retrieve value by its label (`B3:A1`, `B$3:A1`, `B$3:$A1`, `$B$3:A$1`).
+     *
+     * @param {String} startLabel Coordinates of the first cell.
+     * @param {String} endLabel Coordinates of the last cell.
+     * @returns {Array} Returns an array of mixed values.
+     * @private
      */
   }, {
     key: "_callRangeValue",
@@ -2274,12 +2275,12 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value;
     }
 
-    /**
-     * Try to throw error by its name.
-     *
-     * @param {String} errorName Error name.
-     * @returns {String}
-     * @private
+    /**
+     * Try to throw error by its name.
+     *
+     * @param {String} errorName Error name.
+     * @returns {String}
+     * @private
      */
   }, {
     key: "_throwError",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leankylin-sheet/formula-parser",
-  "version": "4.0.18",
+  "version": "4.0.20",
   "description": "Formula parser",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",