dtable-utils 0.0.3-beta.1 → 0.0.4-beta.1

package/lib/cell-value-get/cell-value.js

@@ -21,24 +21,32 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var _defineProperty__default = /*#__PURE__*/_interopDefaultLegacy(_defineProperty);
 
 var ARRAY_VALUE_COLUMN_TYPES = [cellType.CellType.IMAGE, cellType.CellType.FILE, cellType.CellType.MULTIPLE_SELECT, cellType.CellType.COLLABORATOR];
+
+/**
+ * the helper of 'getCellValueStringResult'
+ * @param {any} cellValue
+ * @param {object} column
+ * @param {array} collaborators
+ * @param {bool} isArchiveView
+ * @returns formatted array cell value, string
+ */
 var _getArrayColumnCellValue = function _getArrayColumnCellValue(cellValue, column, _ref) {
   var collaborators = _ref.collaborators,
     isArchiveView = _ref.isArchiveView;
-  if (!cellValue || !Array.isArray(cellValue) || cellValue.length === 0) {
+  if (!Array.isArray(cellValue) || cellValue.length === 0 || !column.data) {
     return '';
   }
   var key = column.key,
     data = column.data;
-  var _ref2 = data || {},
-    array_type = _ref2.array_type,
-    array_data = _ref2.array_data;
+  var array_type = data.array_type,
+    array_data = data.array_data;
   var newColumn = {
     key: key,
     type: array_type,
     data: array_data
   };
   // cellValue itself is an array
-  if ([cellType.CellType.FILE, cellType.CellType.IMAGE, cellType.CellType.COLLABORATOR, cellType.CellType.MULTIPLE_SELECT].includes(array_type)) {
+  if (ARRAY_VALUE_COLUMN_TYPES.includes(array_type)) {
     return getCellValueStringResult(_defineProperty__default["default"]({}, key, cellValue), newColumn, {
       collaborators: collaborators
     });
@@ -134,16 +142,16 @@ var getFormulaDisplayString = function getFormulaDisplayString(cellValue, column
  * @returns formatted cell value, string|array
  */
 var getCellValueDisplayString = function getCellValueDisplayString(row, type, key) {
-  var _ref3 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {},
-    data = _ref3.data,
-    _ref3$formulaRows = _ref3.formulaRows,
-    formulaRows = _ref3$formulaRows === void 0 ? {} : _ref3$formulaRows,
-    _ref3$collaborators = _ref3.collaborators,
-    collaborators = _ref3$collaborators === void 0 ? [] : _ref3$collaborators,
-    _ref3$isBaiduMap = _ref3.isBaiduMap,
-    isBaiduMap = _ref3$isBaiduMap === void 0 ? true : _ref3$isBaiduMap,
-    _ref3$geolocationHyph = _ref3.geolocationHyphen,
-    geolocationHyphen = _ref3$geolocationHyph === void 0 ? '' : _ref3$geolocationHyph;
+  var _ref2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {},
+    data = _ref2.data,
+    _ref2$formulaRows = _ref2.formulaRows,
+    formulaRows = _ref2$formulaRows === void 0 ? {} : _ref2$formulaRows,
+    _ref2$collaborators = _ref2.collaborators,
+    collaborators = _ref2$collaborators === void 0 ? [] : _ref2$collaborators,
+    _ref2$isBaiduMap = _ref2.isBaiduMap,
+    isBaiduMap = _ref2$isBaiduMap === void 0 ? true : _ref2$isBaiduMap,
+    _ref2$geolocationHyph = _ref2.geolocationHyphen,
+    geolocationHyphen = _ref2$geolocationHyph === void 0 ? '' : _ref2$geolocationHyph;
   if (!row) return '';
   var cellValue = row[key];
   switch (type) {
@@ -180,9 +188,9 @@ var getCellValueDisplayString = function getCellValueDisplayString(row, type, ke
       }
     case cellType.CellType.DATE:
       {
-        var _ref4 = data || {},
-          _ref4$format = _ref4.format,
-          format = _ref4$format === void 0 ? column.DEFAULT_DATE_FORMAT : _ref4$format;
+        var _ref3 = data || {},
+          _ref3$format = _ref3.format,
+          format = _ref3$format === void 0 ? column.DEFAULT_DATE_FORMAT : _ref3$format;
         return date.getDateDisplayString(cellValue, format);
       }
     case cellType.CellType.CTIME:
@@ -202,7 +210,8 @@ var getCellValueDisplayString = function getCellValueDisplayString(row, type, ke
     case cellType.CellType.FORMULA:
     case cellType.CellType.LINK_FORMULA:
       {
-        var formulaRow = formulaRows[row._id] || {};
+        var formulaRow = formulaRows && formulaRows[row._id];
+        if (!formulaRow) return '';
         return getFormulaDisplayString(formulaRow[key], data);
       }
     case cellType.CellType.DIGITAL_SIGN:
@@ -218,18 +227,28 @@ var getCellValueDisplayString = function getCellValueDisplayString(row, type, ke
       }
   }
 };
+
+/**
+ * Format cell value to string
+ * @param {object} row { [column.key]: '', ... }
+ * @param {object} column
+ * @param {object} formulaRows formula results of rows. Default as "{}"
+ * @param {array} collaborators e.g. [{ email, name, ... }, ...]. Default as "[]"
+ * @param {bool} isArchiveView If is archive view, get original cell value from "row", otherwise get cell value from "formulaRows"
+ * @returns formatted cell value, string
+ */
 var getCellValueStringResult = function getCellValueStringResult(row, column$1) {
-  var _ref5 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {},
-    _ref5$formulaRows = _ref5.formulaRows,
-    formulaRows = _ref5$formulaRows === void 0 ? {} : _ref5$formulaRows,
-    _ref5$collaborators = _ref5.collaborators,
-    collaborators = _ref5$collaborators === void 0 ? [] : _ref5$collaborators,
-    _ref5$isArchiveView = _ref5.isArchiveView,
-    isArchiveView = _ref5$isArchiveView === void 0 ? false : _ref5$isArchiveView;
-  var _ref6 = column$1 || {},
-    key = _ref6.key,
-    type = _ref6.type,
-    data = _ref6.data;
+  var _ref4 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {},
+    _ref4$formulaRows = _ref4.formulaRows,
+    formulaRows = _ref4$formulaRows === void 0 ? {} : _ref4$formulaRows,
+    _ref4$collaborators = _ref4.collaborators,
+    collaborators = _ref4$collaborators === void 0 ? [] : _ref4$collaborators,
+    _ref4$isArchiveView = _ref4.isArchiveView,
+    isArchiveView = _ref4$isArchiveView === void 0 ? false : _ref4$isArchiveView;
+  if (!row || !column$1) return '';
+  var key = column$1.key,
+    type = column$1.type,
+    data = column$1.data;
   var cellValue = row[key];
   switch (type) {
     case cellType.CellType.TEXT:
@@ -276,20 +295,18 @@ var getCellValueStringResult = function getCellValueStringResult(row, column$1)
     case cellType.CellType.SINGLE_SELECT:
       {
         if (!data) return '';
-        var options = data.options;
-        return option.getOptionName(options, cellValue);
+        return option.getOptionName(data.options, cellValue);
       }
     case cellType.CellType.MULTIPLE_SELECT:
       {
         if (!data) return '';
-        var _options2 = data.options;
-        return option.getMultipleOptionName(_options2, cellValue);
+        return option.getMultipleOptionName(data.options, cellValue);
       }
     case cellType.CellType.DATE:
       {
-        var _ref7 = data || {},
-          _ref7$format = _ref7.format,
-          format = _ref7$format === void 0 ? column.DEFAULT_DATE_FORMAT : _ref7$format;
+        var _ref5 = data || {},
+          _ref5$format = _ref5.format,
+          format = _ref5$format === void 0 ? column.DEFAULT_DATE_FORMAT : _ref5$format;
         // patch: compatible with previous format
         var normalizedFormat = format === 'D/M/YYYY' ? format.replace(/D\/M\/YYYY/, 'DD/MM/YYYY') : format;
         return date.getDateDisplayString(cellValue, normalizedFormat);
@@ -310,63 +327,68 @@ var getCellValueStringResult = function getCellValueStringResult(row, column$1)
       }
     case cellType.CellType.LINK:
       {
+        var computedCellValue = cellValue;
         if (!isArchiveView) {
-          var formulaRow = formulaRows[row._id] || {};
-          cellValue = formulaRow[key];
+          var formulaRow = formulaRows && formulaRows[row._id];
+          computedCellValue = formulaRow && formulaRow[key];
         }
-        if (!cellValue || !Array.isArray(cellValue) || cellValue.length === 0) return '';
-        var newCellValue = cellValue.map(function (linked) {
+        if (!Array.isArray(computedCellValue) || computedCellValue.length === 0) {
+          return '';
+        }
+        var displayCellValue = computedCellValue.map(function (linked) {
           return linked.display_value;
         });
-        var isTwoDimensionalArray = newCellValue.some(function (item) {
+        var isTwoDimensionalArray = displayCellValue.some(function (item) {
           return Array.isArray(item);
         });
-        if (!isTwoDimensionalArray) {
-          return _getArrayColumnCellValue(newCellValue, column$1, {
-            collaborators: collaborators
+        if (isTwoDimensionalArray) {
+          var result = displayCellValue.map(function (item) {
+            return _getArrayColumnCellValue(item, column$1, {
+              collaborators: collaborators,
+              isArchiveView: isArchiveView
+            });
           });
+          return result.filter(Boolean).join(', ');
         }
-        var result = newCellValue.map(function (item) {
-          return _getArrayColumnCellValue(item, column$1, {
-            collaborators: collaborators,
-            isArchiveView: isArchiveView
-          });
+        return _getArrayColumnCellValue(displayCellValue, column$1, {
+          collaborators: collaborators
         });
-        return result.filter(Boolean).join(', ');
       }
     case cellType.CellType.FORMULA:
     case cellType.CellType.LINK_FORMULA:
       {
+        var _computedCellValue = cellValue;
         if (!isArchiveView) {
-          var _formulaRow = formulaRows[row._id] || {};
-          cellValue = _formulaRow[key];
+          var _formulaRow = formulaRows && formulaRows[row._id];
+          _computedCellValue = _formulaRow && _formulaRow[key];
         }
         var result_type = data.result_type;
         if (result_type === formula.FORMULA_RESULT_TYPE.STRING) {
-          return cellValue || '';
+          return _computedCellValue || '';
         }
         if (result_type === formula.FORMULA_RESULT_TYPE.BOOL) {
-          return [true, 'true'].includes(cellValue) ? 'true' : 'false';
+          if (typeof _computedCellValue === 'boolean') return String(_computedCellValue);
+          return _computedCellValue === 'true' ? 'true' : 'false';
         }
         if (result_type === formula.FORMULA_RESULT_TYPE.NUMBER) {
           // data is stored in the data of the current column
-          return number.getNumberDisplayString(cellValue, data);
+          return number.getNumberDisplayString(_computedCellValue, data);
         }
         if (result_type === formula.FORMULA_RESULT_TYPE.DATE) {
           // data is stored in the data of the current column
-          var _ref8 = data || {},
-            _format = _ref8.format;
-          return date.getDateDisplayString(cellValue, _format);
+          var _format = data.format;
+          return date.getDateDisplayString(_computedCellValue, _format);
         }
 
         // FORMULA_RESULT_TYPE.ARRAY
-        return _getArrayColumnCellValue(cellValue, column$1, {
+        return _getArrayColumnCellValue(_computedCellValue, column$1, {
           collaborators: collaborators,
           isArchiveView: isArchiveView
         });
       }
     case cellType.CellType.FILE:
     case cellType.CellType.IMAGE:
+    case cellType.CellType.DIGITAL_SIGN:
     case cellType.CellType.BUTTON:
       {
         return '';

package/lib/cell-value-get/collaborator.js

@@ -2,9 +2,16 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getCollaborator = function getCollaborator(collaborators, collaboratorEmail) {
+/**
+ * Get collaborator by email
+ * @param {array} collaborators e.g. [{ email, name, ... }, ...]
+ * @param {string} email
+ * @returns collaborator, object
+ */
+var getCollaborator = function getCollaborator(collaborators, email) {
+  if (!Array.isArray(collaborators) || !email) return null;
   return collaborators.find(function (collaborator) {
-    return collaborator.email === collaboratorEmail;
+    return collaborator.email === email;
   });
 };
 

package/lib/cell-value-get/duration.js

@@ -73,8 +73,8 @@ var getDurationDisplayString = function getDurationDisplayString(duration, forma
   }
   var decimalDigits = column.DURATION_DECIMAL_DIGITS[duration_format];
   var decimalSuffix = getDurationDecimalSuffix(duration_format, decimal);
-  var hours = parseInt(positiveValue / 3600, 10);
-  var minutes = parseInt((positiveValue - hours * 3600) / 60, 10);
+  var hours = parseInt(positiveValue / 3600);
+  var minutes = parseInt((positiveValue - hours * 3600) / 60);
   var displayString = duration < 0 ? '-' : '';
   if (duration_format === column.DURATION_FORMATS_MAP.H_MM) {
     displayString += "".concat(hours, ":").concat(minutes > 9 ? minutes : "0".concat(minutes));
@@ -87,4 +87,6 @@ var getDurationDisplayString = function getDurationDisplayString(duration, forma
   return displayString;
 };
 
+exports.getDurationDecimalSuffix = getDurationDecimalSuffix;
 exports.getDurationDisplayString = getDurationDisplayString;
+exports.getMathRoundedDuration = getMathRoundedDuration;

package/lib/cell-value-get/geolocation.js

@@ -19,67 +19,65 @@ var getGeolocationDisplayString = function getGeolocationDisplayString(loc, form
     isBaiduMap = _ref$isBaiduMap === void 0 ? true : _ref$isBaiduMap,
     _ref$hyphen = _ref.hyphen,
     hyphen = _ref$hyphen === void 0 ? '' : _ref$hyphen;
-  if (!loc) {
-    return '';
-  }
+  if (!loc) return '';
   var _ref2 = formats || {},
     geo_format = _ref2.geo_format;
   switch (geo_format) {
     case 'lng_lat':
       {
-        var _ref3 = loc || {},
-          lng = _ref3.lng,
-          lat = _ref3.lat;
+        var lng = loc.lng,
+          lat = loc.lat;
         if (!geolocation.isValidPosition(lng, lat)) return '';
         return isBaiduMap ? "".concat(lng, ", ").concat(lat) : "".concat(lat, ", ").concat(lng);
       }
     case 'country_region':
       {
-        var _ref4 = loc || {},
-          country_region = _ref4.country_region;
+        var country_region = loc.country_region;
         return country_region || '';
       }
     case 'province':
       {
-        var _ref5 = loc || {},
-          province = _ref5.province;
+        var province = loc.province;
         return province || '';
       }
     case 'province_city':
       {
-        var _ref6 = loc || {},
-          _province = _ref6.province,
-          city = _ref6.city;
+        var _province = loc.province,
+          city = loc.city;
         return "".concat(_province || '').concat(hyphen).concat(city || '').trim();
       }
     case 'province_city_district':
       {
-        var _ref7 = loc || {},
-          _province2 = _ref7.province,
-          _city = _ref7.city,
-          district = _ref7.district;
+        var _province2 = loc.province,
+          _city = loc.city,
+          district = loc.district;
         return "".concat(_province2 || '').concat(hyphen).concat(_city || '').concat(hyphen).concat(district || '').trim();
       }
     case 'map_selection':
       {
-        var _ref8 = loc || {},
-          address = _ref8.address,
-          title = _ref8.title;
+        var address = loc.address,
+          title = loc.title;
         return "".concat(address || '').concat(hyphen).concat(title || '').trim();
       }
     default:
       {
         // default as 'geolocation'
-        var _ref9 = loc || {},
-          _province3 = _ref9.province,
-          _city2 = _ref9.city,
-          _district = _ref9.district,
-          detail = _ref9.detail;
+        var _province3 = loc.province,
+          _city2 = loc.city,
+          _district = loc.district,
+          detail = loc.detail;
         if (!_province3 && !_city2 && !_district && !detail) return '';
         return "".concat(_province3 || '').concat(hyphen).concat(_city2 || '').concat(hyphen).concat(_district || '').concat(hyphen).concat(detail || '').trim();
       }
   }
 };
+
+/**
+ * Get geolocation by granularity
+ * @param {object} geolocation e.g. { province, ... }
+ * @param {string} granularity
+ * @returns geolocation string
+ */
 var getGeolocationByGranularity = function getGeolocationByGranularity(geolocation, granularity) {
   if (!geolocation) return '';
   var province = geolocation.province,

package/lib/cell-value-get/number.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var index = require('../helper/number-precision/index.js');
 var duration = require('./duration.js');
 var column = require('../constants/column.js');
+var formula = require('../constants/formula.js');
 
 var separatorMap = {
   comma: ',',
@@ -12,29 +13,36 @@ var separatorMap = {
   no: '',
   space: ' '
 };
-var _getDecimalDigits = function _getDecimalDigits(num) {
-  if (Number.isInteger(num)) {
+var _getDecimalDigits = function _getDecimalDigits(number) {
+  if (Number.isInteger(number)) {
     return 0;
   }
-  var valueArr = (num + '').split('.');
+  var valueArr = String(number).split('.');
   var digitsLength = valueArr[1] ? valueArr[1].length : 8;
   return digitsLength > 8 ? 8 : digitsLength;
 };
-var getPrecisionNumber = function getPrecisionNumber(num, formatData) {
-  var _ref = formatData || {},
+
+/**
+ * Get fixed number by precision
+ * @param {number} number
+ * @param {object} formats e.g. { enable_precision, precision, ... }
+ * @returns fixed number, string
+ */
+var getPrecisionNumber = function getPrecisionNumber(number, formats) {
+  var _ref = formats || {},
     _ref$precision = _ref.precision,
     precision = _ref$precision === void 0 ? 2 : _ref$precision,
     _ref$enable_precision = _ref.enable_precision,
     enable_precision = _ref$enable_precision === void 0 ? false : _ref$enable_precision;
-  var type = Object.prototype.toString.call(num);
+  var type = Object.prototype.toString.call(number);
   if (type !== '[object Number]') {
-    if (type === '[object String]' && DISPLAY_INTERNAL_ERRORS.includes(num)) {
-      return num;
+    if (type === '[object String]' && formula.DISPLAY_INTERNAL_ERRORS.includes(number)) {
+      return number;
     }
     return null;
   }
-  var decimalDigits = enable_precision ? precision : _getDecimalDigits(num);
-  return num.toFixed(decimalDigits);
+  var decimalDigits = enable_precision ? precision : _getDecimalDigits(number);
+  return number.toFixed(decimalDigits);
 };
 
 /**
@@ -93,7 +101,7 @@ var toThousands = function toThousands(number, _ref2) {
       }
       return numericString;
     }
-    return number;
+    return String(number);
   }
   var decimalString = separatorMap[decimal];
   var thousandsString = separatorMap[thousands];

package/lib/cell-value-get/option.js

@@ -4,15 +4,22 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var option = require('../column/option.js');
 
+/**
+ * Get option by id
+ * @param {array} options e.g. [{ id, name, ... }]
+ * @param {string} optionId
+ * @returns option, object
+ */
 var getOption = function getOption(options, optionId) {
-  return options.find(function (o) {
-    return o.id === optionId;
+  if (!Array.isArray(options) || !optionId) return null;
+  return options.find(function (option) {
+    return option.id === optionId;
   });
 };
 
 /**
  * Get option name of the given id
- * @param {array} options e.g. [ { id: '', color: '', name: '' } ]
+ * @param {array} options e.g. [ { id, color, name, ... } ]
  * @param {string} targetOptionId option id
  * @returns option name, string
  */
@@ -21,6 +28,13 @@ var getOptionName = function getOptionName(options, targetOptionId) {
   var targetOption = getOption(options, targetOptionId);
   return targetOption ? targetOption.name : '';
 };
+
+/**
+ * Get column option name by id
+ * @param {object} column e.g. { data: { options, ... }, ... }
+ * @param {string} optionId
+ * @returns option name, string
+ */
 var getColumnOptionNameById = function getColumnOptionNameById(column, optionId) {
   var options = option.getColumnOptions(column);
   return getOptionName(options, optionId);
@@ -28,7 +42,7 @@ var getColumnOptionNameById = function getColumnOptionNameById(column, optionId)
 
 /**
  * Get concatenated options names of given ids.
- * @param {array} options e.g. [ { id: '', color: '', name: '' }, ... ]
+ * @param {array} options e.g. [ { id, color, name, ... }, ... ]
  * @param {array} targetOptionsIds e.g. [ option.id, ... ]
  * @returns concatenated options names, string. e.g. 'name1, name2'
  */

package/lib/cell-value-get/rate.js

@@ -2,6 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+/**
+ * Get formatted rate
+ * @param {number} value
+ * @returns formatted rate
+ */
 var getRateDisplayString = function getRateDisplayString(value) {
   if (!value) return '';
   return String(value);

package/lib/cell-value-set/date.js

@@ -5,17 +5,23 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var date = require('../date.js');
 var number = require('./number.js');
 
+/**
+ * Parse string to date
+ * @param {string} text
+ * @param {string} format default as "YYYY-MM-DD"
+ * @returns date, string
+ */
 var formatTextToDate = function formatTextToDate(text) {
-  var dateFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY-MM-DD';
+  var format = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY-MM-DD';
   if (typeof text !== 'string' || !text.trim()) return null;
   var isAllNumber = /^[0-9]+$/.test(text);
   var dateObj = {};
   if (isAllNumber) {
     dateObj = new Date(number.getFloatNumber(text));
   } else {
-    dateObj = date.DateUtils.parseDateWithFormat(text, dateFormat);
+    dateObj = date.DateUtils.parseDateWithFormat(text, format);
   }
-  if (dateFormat.indexOf('HH:mm') < 0) {
+  if (format.indexOf('HH:mm') < 0) {
     return date.DateUtils.format(dateObj, 'YYYY-MM-DD') || null;
   }
   return date.DateUtils.format(dateObj, 'YYYY-MM-DD HH:MM') || null;

package/lib/{column/color.js → color/column-color.js}

@@ -7,12 +7,12 @@ var deepCopy = require('deep-copy');
 var core = require('../filter/core.js');
 var filterRow = require('../filter/filter-row.js');
 var filter = require('../validate/filter.js');
-var number = require('./number.js');
+var number = require('../column/number.js');
 var row = require('../table/row.js');
 var sortRow = require('../sort/sort-row.js');
 var core$1 = require('../row/core.js');
-var color = require('../row/color.js');
-var gradientColor = require('../color/gradient-color.js');
+var rowColor = require('./row-color.js');
+var gradientColor = require('./gradient-color.js');
 var cellType = require('../constants/cell-type.js');
 require('../constants/column.js');
 var index = require('../constants/filter/index.js');
@@ -184,7 +184,7 @@ var getFormattedColumn = function getFormattedColumn(column, view, table, value,
     var _ref4 = value || {},
       _ref4$collaborators = _ref4.collaborators,
       collaborators = _ref4$collaborators === void 0 ? [] : _ref4$collaborators;
-    var formattedColumn = color["default"].getFormattedDuplicateColumns([dupColumn], [duplicateColumnKey], {
+    var formattedColumn = rowColor["default"].getFormattedDuplicateColumns([dupColumn], [duplicateColumnKey], {
       collaborators: collaborators
     });
     var duplicate_rows_ids_map = {};
@@ -193,7 +193,7 @@ var getFormattedColumn = function getFormattedColumn(column, view, table, value,
       var row = rows[i];
       var rowId = row._id;
       var formulaRow = formulaRows && formulaRows[rowId];
-      var rowValue = color["default"].getDuplicateRowValue(row, formattedColumn, formulaRow);
+      var rowValue = rowColor["default"].getDuplicateRowValue(row, formattedColumn, formulaRow);
       if (!rowValue) continue;
       var rowIds = duplicate_rows_ids_map[rowValue];
       if (rowIds && rowIds.length > 0) {
@@ -251,6 +251,17 @@ var getFormattedColumn = function getFormattedColumn(column, view, table, value,
   dupColumn.gradientColorUtils = gradientColorUtils;
   return dupColumn;
 };
+
+/**
+ * Calculate column color
+ * @param {array} rows
+ * @param {object} view
+ * @param {object} table e.g. { id_row_map, ... }
+ * @param {object} value e.g. { tables, collaborators, ... }
+ * @param {string} username
+ * @param {userId} username
+ * @returns column color, object
+ */
 var getColumnColors = function getColumnColors(rows, view, table, value) {
   var _ref5 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref5$username = _ref5.username,
@@ -306,13 +317,13 @@ var getColumnColors = function getColumnColors(rows, view, table, value) {
           var colorRule = colorByRules[m];
           var filter_conjunction = colorRule.filter_conjunction,
             filters = colorRule.filters,
-            color$1 = colorRule.color;
+            color = colorRule.color;
           if (filterRow.filterRow(row, filter_conjunction, filters, {
             formulaRow: formulaRow,
             username: username,
             userId: userId
           })) {
-            column_color[columnKey] = color$1;
+            column_color[columnKey] = color;
             break;
           }
         }
@@ -322,10 +333,10 @@ var getColumnColors = function getColumnColors(rows, view, table, value) {
         var _ref6 = value || {},
           _ref6$collaborators = _ref6.collaborators,
           collaborators = _ref6$collaborators === void 0 ? [] : _ref6$collaborators;
-        var formattedColumn = color["default"].getFormattedDuplicateColumns([column], [duplicateColumnKey], {
+        var formattedColumn = rowColor["default"].getFormattedDuplicateColumns([column], [duplicateColumnKey], {
           collaborators: collaborators
         });
-        var rowValue = color["default"].getDuplicateRowValue(row, formattedColumn, formulaRow);
+        var rowValue = rowColor["default"].getDuplicateRowValue(row, formattedColumn, formulaRow);
         if (!rowValue) continue;
         var rowIds = duplicate_rows_ids_map[rowValue];
         if (rowIds && rowIds.length > 1) {
@@ -362,6 +373,17 @@ var getColumnColors = function getColumnColors(rows, view, table, value) {
   }
   return column_colors;
 };
+
+/**
+ * Update column color by updated rows.
+ * @param {array} rows updated rows | rows ids
+ * @param {object} view
+ * @param {object} table e.g. { id_row_map, ... }
+ * @param {object} value e.g. { tables, collaborators, ... }
+ * @param {string} username
+ * @param {userId} username
+ * @returns column color, object
+ */
 var updateColumnColorsByUpdateRows = function updateColumnColorsByUpdateRows(rows, view, table, value) {
   var _ref7 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref7$username = _ref7.username,

package/lib/{row/color.js → color/row-color.js}

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _defineProperty = require('@babel/runtime/helpers/defineProperty');
 var column = require('../table/column.js');
 var row = require('../table/row.js');
-var core$1 = require('./core.js');
+var core$1 = require('../row/core.js');
 var option = require('../column/option.js');
 var geolocation = require('../cell-value-get/geolocation.js');
 var filter = require('../validate/filter.js');
@@ -231,6 +231,17 @@ var getRowsColorByDuplicateValues = function getRowsColorByDuplicateValues(rows,
     duplicate_rows_ids_map: duplicate_rows_ids_map
   };
 };
+
+/**
+ * Calculate rows color.
+ * @param {array} rows
+ * @param {object} view
+ * @param {object} table e.g. { id_row_map, ... }
+ * @param {object} value e.g. { tables, collaborators, ... }
+ * @param {string} username
+ * @param {userId} username
+ * @returns rows color, object
+ */
 var getRowsColor = function getRowsColor(rows, view, table, value) {
   var _ref5 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     username = _ref5.username,