@leankylin-sheet/formula-parser 4.0.56 → 4.0.58

package/dist/index.esm.js

@@ -169,11 +169,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;
@@ -189,11 +189,11 @@ function toNumber(number) {
   return (_result = result) !== null && _result !== void 0 ? _result : 0;
 }
 
-/**
- * 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);
@@ -226,11 +226,11 @@ var ERROR_VALUE = 'VALUE';
 var errors_formula_map = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, ERROR, utils.errors.error), ERROR_DIV_ZERO, utils.errors.div0), ERROR_NAME, utils.errors.name), ERROR_NOT_AVAILABLE, utils.errors.na), ERROR_NULL, utils.errors.nil), ERROR_NUM, utils.errors.num), ERROR_REF, utils.errors.ref), ERROR_VALUE, utils.errors.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;
@@ -241,11 +241,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;
@@ -464,12 +464,12 @@ function func$9(first) {
 }
 func$9.SYMBOL = SYMBOL$9;
 
-/**
- * 解决js处理精度问题
- * 0.3 * 0.1 = 0.03
- * @param num1
- * @param num2
- * @returns
+/**
+ * 解决js处理精度问题
+ * 0.3 * 0.1 = 0.03
+ * @param num1
+ * @param num2
+ * @returns
  */
 var multiplyNumber = function multiplyNumber() {
   var num1 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
@@ -538,12 +538,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] : [];
@@ -554,11 +554,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)) {
@@ -1994,12 +1994,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;
@@ -2007,11 +2007,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);
@@ -2023,11 +2023,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 = "";
@@ -2039,11 +2039,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;
@@ -2057,11 +2057,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 = "";
@@ -2076,11 +2076,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)) {
@@ -2106,12 +2106,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);
@@ -2119,8 +2119,8 @@ function toLabel(row, column) {
   return columnLabel + rowLabel;
 }
 
-/**
- * @class Parser
+/**
+ * @class Parser
  */
 var Parser$1 = /*#__PURE__*/function (_Emitter) {
   function Parser$1() {
@@ -2156,13 +2156,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, [{
@@ -2198,12 +2198,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",
@@ -2216,11 +2216,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",
@@ -2228,12 +2228,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",
@@ -2250,12 +2250,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",
@@ -2264,11 +2264,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",
@@ -2276,13 +2276,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",
@@ -2301,12 +2301,12 @@ 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",
@@ -2336,13 +2336,13 @@ var Parser$1 = /*#__PURE__*/function (_Emitter) {
       return value;
     }
 
-    /**
-     * 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",
@@ -2387,12 +2387,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",