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

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

@@ -13,24 +13,32 @@ import { COLLABORATOR_COLUMN_TYPES, DEFAULT_DATE_FORMAT } from '../constants/col
 import { FORMULA_RESULT_TYPE } from '../constants/formula.js';
 
 var ARRAY_VALUE_COLUMN_TYPES = [CellType.IMAGE, CellType.FILE, CellType.MULTIPLE_SELECT, 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.FILE, CellType.IMAGE, CellType.COLLABORATOR, CellType.MULTIPLE_SELECT].includes(array_type)) {
+  if (ARRAY_VALUE_COLUMN_TYPES.includes(array_type)) {
     return getCellValueStringResult(_defineProperty({}, key, cellValue), newColumn, {
       collaborators: collaborators
     });
@@ -126,16 +134,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) {
@@ -172,9 +180,9 @@ var getCellValueDisplayString = function getCellValueDisplayString(row, type, ke
       }
     case CellType.DATE:
       {
-        var _ref4 = data || {},
-          _ref4$format = _ref4.format,
-          format = _ref4$format === void 0 ? DEFAULT_DATE_FORMAT : _ref4$format;
+        var _ref3 = data || {},
+          _ref3$format = _ref3.format,
+          format = _ref3$format === void 0 ? DEFAULT_DATE_FORMAT : _ref3$format;
         return getDateDisplayString(cellValue, format);
       }
     case CellType.CTIME:
@@ -194,7 +202,8 @@ var getCellValueDisplayString = function getCellValueDisplayString(row, type, ke
     case CellType.FORMULA:
     case CellType.LINK_FORMULA:
       {
-        var formulaRow = formulaRows[row._id] || {};
+        var formulaRow = formulaRows && formulaRows[row._id];
+        if (!formulaRow) return '';
         return getFormulaDisplayString(formulaRow[key], data);
       }
     case CellType.DIGITAL_SIGN:
@@ -210,18 +219,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) {
-  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 || {},
-    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) return '';
+  var key = column.key,
+    type = column.type,
+    data = column.data;
   var cellValue = row[key];
   switch (type) {
     case CellType.TEXT:
@@ -268,20 +287,18 @@ var getCellValueStringResult = function getCellValueStringResult(row, column) {
     case CellType.SINGLE_SELECT:
       {
         if (!data) return '';
-        var options = data.options;
-        return getOptionName(options, cellValue);
+        return getOptionName(data.options, cellValue);
       }
     case CellType.MULTIPLE_SELECT:
       {
         if (!data) return '';
-        var _options2 = data.options;
-        return getMultipleOptionName(_options2, cellValue);
+        return getMultipleOptionName(data.options, cellValue);
       }
     case CellType.DATE:
       {
-        var _ref7 = data || {},
-          _ref7$format = _ref7.format,
-          format = _ref7$format === void 0 ? DEFAULT_DATE_FORMAT : _ref7$format;
+        var _ref5 = data || {},
+          _ref5$format = _ref5.format,
+          format = _ref5$format === void 0 ? 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 getDateDisplayString(cellValue, normalizedFormat);
@@ -302,63 +319,68 @@ var getCellValueStringResult = function getCellValueStringResult(row, column) {
       }
     case 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 (!Array.isArray(computedCellValue) || computedCellValue.length === 0) {
+          return '';
         }
-        if (!cellValue || !Array.isArray(cellValue) || cellValue.length === 0) return '';
-        var newCellValue = cellValue.map(function (linked) {
+        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, {
-            collaborators: collaborators
+        if (isTwoDimensionalArray) {
+          var result = displayCellValue.map(function (item) {
+            return _getArrayColumnCellValue(item, column, {
+              collaborators: collaborators,
+              isArchiveView: isArchiveView
+            });
           });
+          return result.filter(Boolean).join(', ');
         }
-        var result = newCellValue.map(function (item) {
-          return _getArrayColumnCellValue(item, column, {
-            collaborators: collaborators,
-            isArchiveView: isArchiveView
-          });
+        return _getArrayColumnCellValue(displayCellValue, column, {
+          collaborators: collaborators
         });
-        return result.filter(Boolean).join(', ');
       }
     case CellType.FORMULA:
     case 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_RESULT_TYPE.STRING) {
-          return cellValue || '';
+          return _computedCellValue || '';
         }
         if (result_type === 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_RESULT_TYPE.NUMBER) {
           // data is stored in the data of the current column
-          return getNumberDisplayString(cellValue, data);
+          return getNumberDisplayString(_computedCellValue, data);
         }
         if (result_type === FORMULA_RESULT_TYPE.DATE) {
           // data is stored in the data of the current column
-          var _ref8 = data || {},
-            _format = _ref8.format;
-          return getDateDisplayString(cellValue, _format);
+          var _format = data.format;
+          return getDateDisplayString(_computedCellValue, _format);
         }
 
         // FORMULA_RESULT_TYPE.ARRAY
-        return _getArrayColumnCellValue(cellValue, column, {
+        return _getArrayColumnCellValue(_computedCellValue, column, {
           collaborators: collaborators,
           isArchiveView: isArchiveView
         });
       }
     case CellType.FILE:
     case CellType.IMAGE:
+    case CellType.DIGITAL_SIGN:
     case CellType.BUTTON:
       {
         return '';

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

@@ -1,6 +1,13 @@
-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/es/cell-value-get/duration.js

@@ -69,8 +69,8 @@ var getDurationDisplayString = function getDurationDisplayString(duration, forma
   }
   var decimalDigits = 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 === DURATION_FORMATS_MAP.H_MM) {
     displayString += "".concat(hours, ":").concat(minutes > 9 ? minutes : "0".concat(minutes));
@@ -83,4 +83,4 @@ var getDurationDisplayString = function getDurationDisplayString(duration, forma
   return displayString;
 };
 
-export { getDurationDisplayString };
+export { getDurationDecimalSuffix, getDurationDisplayString, getMathRoundedDuration };

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

@@ -15,67 +15,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 (!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/es/cell-value-get/number.js

@@ -1,6 +1,7 @@
 import { NPminus as minus } from '../helper/number-precision/index.js';
 import { getDurationDisplayString } from './duration.js';
 import { DEFAULT_NUMBER_FORMAT } from '../constants/column.js';
+import { DISPLAY_INTERNAL_ERRORS } from '../constants/formula.js';
 
 var separatorMap = {
   comma: ',',
@@ -8,29 +9,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]' && 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);
 };
 
 /**
@@ -89,7 +97,7 @@ var toThousands = function toThousands(number, _ref2) {
       }
       return numericString;
     }
-    return number;
+    return String(number);
   }
   var decimalString = separatorMap[decimal];
   var thousandsString = separatorMap[thousands];

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

@@ -1,14 +1,21 @@
 import { getColumnOptions } from '../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
  */
@@ -17,6 +24,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 = getColumnOptions(column);
   return getOptionName(options, optionId);
@@ -24,7 +38,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/es/cell-value-get/rate.js

@@ -1,3 +1,8 @@
+/**
+ * Get formatted rate
+ * @param {number} value
+ * @returns formatted rate
+ */
 var getRateDisplayString = function getRateDisplayString(value) {
   if (!value) return '';
   return String(value);

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

@@ -1,17 +1,23 @@
 import { DateUtils } from '../date.js';
 import { getFloatNumber } from './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(getFloatNumber(text));
   } else {
-    dateObj = DateUtils.parseDateWithFormat(text, dateFormat);
+    dateObj = DateUtils.parseDateWithFormat(text, format);
   }
-  if (dateFormat.indexOf('HH:mm') < 0) {
+  if (format.indexOf('HH:mm') < 0) {
     return DateUtils.format(dateObj, 'YYYY-MM-DD') || null;
   }
   return DateUtils.format(dateObj, 'YYYY-MM-DD HH:MM') || null;

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

@@ -3,12 +3,12 @@ import deepCopy from 'deep-copy';
 import { deleteInvalidFilter, getFormattedFilters } from '../filter/core.js';
 import { filterRows, filterRow } from '../filter/filter-row.js';
 import { ValidateFilter } from '../validate/filter.js';
-import { isNumberColumn } from './number.js';
+import { isNumberColumn } from '../column/number.js';
 import { getRowsByIds } from '../table/row.js';
 import { sortTableRows } from '../sort/sort-row.js';
 import { isTableRows } from '../row/core.js';
-import RowColorUtils from '../row/color.js';
-import GradientColorUtils from '../color/gradient-color.js';
+import RowColorUtils from './row-color.js';
+import GradientColorUtils from './gradient-color.js';
 import { CellType } from '../constants/cell-type.js';
 import '../constants/column.js';
 import { FILTER_CONJUNCTION_TYPE } from '../constants/filter/index.js';
@@ -242,6 +242,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,
@@ -353,6 +364,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/es/{row/color.js → color/row-color.js}

@@ -1,7 +1,7 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import { getTableColumnByKey } from '../table/column.js';
 import { getRowsByIds } from '../table/row.js';
-import { isTableRows } from './core.js';
+import { isTableRows } from '../row/core.js';
 import { getColumnOptions } from '../column/option.js';
 import { getGeolocationDisplayString } from '../cell-value-get/geolocation.js';
 import { ValidateFilter } from '../validate/filter.js';
@@ -223,6 +223,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,