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

package/es/filter/filter-column/digital-sign.js

@@ -1,20 +1,23 @@
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var digitalSignFilter = function digitalSignFilter(cellValue, _ref) {
+/**
+ * Filter digital signature
+ * @param {object} digitalSignature e.g. { username, sign_time, sign_image_url, ...  }
+ * @param {string} filter_predicate
+ * @returns bool
+ */
+var digitalSignFilter = function digitalSignFilter(digitalSignature, _ref) {
   var filter_predicate = _ref.filter_predicate;
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        if (!cellValue) return true;
-        return !cellValue.username || !cellValue.sign_time || !cellValue.sign_image_url;
+        if (!digitalSignature) return true;
+        return !digitalSignature.username || !digitalSignature.sign_time || !digitalSignature.sign_image_url;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        if (!cellValue) return false;
-        return cellValue.username && cellValue.sign_time && cellValue.sign_image_url ? true : false;
+        if (!digitalSignature) return false;
+        return !!(digitalSignature.username && digitalSignature.sign_time && digitalSignature.sign_image_url);
       }
     default:
       {

package/es/filter/filter-column/file.js

@@ -1,18 +1,21 @@
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var fileFilter = function fileFilter(cellValue, _ref) {
+/**
+ * Filter file
+ * @param {array} files e.g. [{ name, type, url, ... }] | [ url1, ... ]
+ * @param {string} filter_predicate
+ * @returns bool
+ */
+var fileFilter = function fileFilter(files, _ref) {
   var filter_predicate = _ref.filter_predicate;
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return cellValue && cellValue.length > 0 ? false : true;
+        return !(files && files.length > 0);
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return cellValue && cellValue.length > 0 ? true : false;
+        return !!(files && files.length > 0);
       }
     default:
       {

package/es/filter/filter-column/formula.js

@@ -6,7 +6,15 @@ import { filterByArrayType } from './array.js';
 import { getFormulaDisplayString } from '../../cell-value-get/cell-value.js';
 import { FORMULA_RESULT_TYPE } from '../../constants/formula.js';
 
-var formulaFilter = function formulaFilter(cellValue, filter, _ref) {
+/**
+ * Filter formula
+ * @param {any} computedValue cell value from formulaRow
+ * @param {object} filter e.g. { filter_predicate, column, ... }
+ * @param {string} username
+ * @param {string} userId
+ * @returns bool
+ */
+var formulaFilter = function formulaFilter(computedValue, filter, _ref) {
   var username = _ref.username,
     userId = _ref.userId;
   var data = filter.column.data;
@@ -15,25 +23,25 @@ var formulaFilter = function formulaFilter(cellValue, filter, _ref) {
   switch (result_type) {
     case FORMULA_RESULT_TYPE.NUMBER:
       {
-        return numberFilter(cellValue, filter);
+        return numberFilter(computedValue, filter);
       }
     case FORMULA_RESULT_TYPE.DATE:
       {
-        return dateFilter(cellValue, filter);
+        return dateFilter(computedValue, filter);
       }
     case FORMULA_RESULT_TYPE.BOOL:
       {
-        var normalizedCellValue = cellValue;
-        if (cellValue === 'true') {
+        var normalizedCellValue = computedValue;
+        if (computedValue === 'true') {
           normalizedCellValue = true;
-        } else if (cellValue === 'false') {
+        } else if (computedValue === 'false') {
           normalizedCellValue = false;
         }
         return checkboxFilter(normalizedCellValue, filter);
       }
     case FORMULA_RESULT_TYPE.ARRAY:
       {
-        return filterByArrayType(cellValue, filter, {
+        return filterByArrayType(computedValue, filter, {
           username: username,
           userId: userId
         });
@@ -41,7 +49,7 @@ var formulaFilter = function formulaFilter(cellValue, filter, _ref) {
     default:
       {
         // FORMULA_RESULT_TYPE.STRING
-        return textFilter(getFormulaDisplayString(cellValue, data) || '', filter, userId);
+        return textFilter(getFormulaDisplayString(computedValue, data) || '', filter, userId);
       }
   }
 };

package/es/filter/filter-column/geolocation.js

@@ -1,14 +1,19 @@
 import { getGeolocationDisplayString } from '../../cell-value-get/geolocation.js';
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var geolocationFilter = function geolocationFilter(cellValue, _ref) {
+/**
+ * Filter geolocation
+ * @param {object} location  e.g. { province, ... }
+ * @param {string} filter_predicate
+ * @param {string} filter_term
+ * @param {object} column e.g. { type, data: { geo_format, ... }, ... }
+ * @returns bool
+ */
+var geolocationFilter = function geolocationFilter(location, _ref) {
   var filter_predicate = _ref.filter_predicate,
     filter_term = _ref.filter_term,
     column = _ref.column;
-  var geolocation = getGeolocationDisplayString(cellValue, column.data);
+  var geolocation = getGeolocationDisplayString(location, column.data);
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.CONTAINS:
       {
@@ -37,11 +42,11 @@ var geolocationFilter = function geolocationFilter(cellValue, _ref) {
       }
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return geolocation ? false : true;
+        return !geolocation;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return geolocation ? true : false;
+        return !!geolocation;
       }
     default:
       {

package/es/filter/filter-column/link.js

@@ -1,9 +1,17 @@
 import { filterByArrayType } from './array.js';
 
-var linkFilter = function linkFilter(cellValue, filter, _ref) {
+/**
+ * Filter link
+ * @param {array} linkedCellValues e.g. [ displayCellValue, ... ]
+ * @param {object} filter e.g. { filter_predicate, column, ... }
+ * @param {string} username
+ * @param {string} userId
+ * @returns bool
+ */
+var linkFilter = function linkFilter(linkedCellValues, filter, _ref) {
   var username = _ref.username,
     userId = _ref.userId;
-  return filterByArrayType(cellValue, filter, {
+  return filterByArrayType(linkedCellValues, filter, {
     username: username,
     userId: userId
   });

package/es/filter/filter-column/long-text.js

@@ -1,19 +1,22 @@
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var longTextFilter = function longTextFilter(cellValue, _ref) {
+/**
+ * Filter long-text
+ * @param {object} longText e.g. { text, ... }
+ * @param {string} filter_predicate
+ * @returns bool
+ */
+var longTextFilter = function longTextFilter(longText, _ref) {
   var filter_predicate = _ref.filter_predicate;
-  var text = cellValue ? cellValue.text : null;
+  var text = longText ? longText.text : null;
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return text ? false : true;
+        return !text;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return text ? true : false;
+        return !!text;
       }
     default:
       {

package/es/filter/filter-column/multiple-select.js

@@ -1,32 +1,36 @@
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var multipleSelectFilter = function multipleSelectFilter(cellValue, _ref) {
+/**
+ * Filter multiple-select
+ * @param {array} optionIds e.g. [ option.id, ... ]
+ * @param {string} filter_predicate
+ * @param {array} filter_term option ids
+ * @returns bool
+ */
+var multipleSelectFilter = function multipleSelectFilter(optionIds, _ref) {
   var filter_predicate = _ref.filter_predicate,
     filter_term = _ref.filter_term;
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.HAS_ANY_OF:
       {
-        return filter_term.length === 0 || Array.isArray(cellValue) && cellValue.some(function (optionId) {
+        return filter_term.length === 0 || Array.isArray(optionIds) && optionIds.some(function (optionId) {
           return filter_term.includes(optionId);
         });
       }
     case FILTER_PREDICATE_TYPE.HAS_ALL_OF:
       {
-        return filter_term.length === 0 || Array.isArray(cellValue) && filter_term.every(function (optionId) {
-          return cellValue.includes(optionId);
+        return filter_term.length === 0 || Array.isArray(optionIds) && filter_term.every(function (optionId) {
+          return optionIds.includes(optionId);
         });
       }
     case FILTER_PREDICATE_TYPE.HAS_NONE_OF:
       {
-        if (filter_term.length === 0 || !Array.isArray(cellValue) || cellValue.length === 0) {
+        if (filter_term.length === 0 || !Array.isArray(optionIds) || optionIds.length === 0) {
           return true;
         }
         return filter_term.every(function (optionId) {
-          return cellValue.indexOf(optionId) < 0;
+          return optionIds.indexOf(optionId) < 0;
         });
       }
     case FILTER_PREDICATE_TYPE.IS_EXACTLY:
@@ -34,21 +38,21 @@ var multipleSelectFilter = function multipleSelectFilter(cellValue, _ref) {
         if (filter_term.length === 0) {
           return true;
         }
-        if (!Array.isArray(cellValue)) {
+        if (!Array.isArray(optionIds)) {
           return false;
         }
         var uniqueArr = function uniqueArr(arr) {
           return _toConsumableArray(new Set(arr)).sort();
         };
-        return uniqueArr(cellValue).toString() === uniqueArr(filter_term).toString();
+        return uniqueArr(optionIds).toString() === uniqueArr(filter_term).toString();
       }
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return !Array.isArray(cellValue) || cellValue.length === 0;
+        return !Array.isArray(optionIds) || optionIds.length === 0;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return Array.isArray(cellValue) && cellValue.length > 0;
+        return Array.isArray(optionIds) && optionIds.length > 0;
       }
     default:
       {

package/es/filter/filter-column/number.js

@@ -1,10 +1,14 @@
 import { isNumberEqual } from '../../number.js';
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var numberFilter = function numberFilter(cellValue, _ref) {
+/**
+ * Filter number
+ * @param {number} number
+ * @param {string} filter_predicate
+ * @param {number} filter_term
+ * @returns bool
+ */
+var numberFilter = function numberFilter(number, _ref) {
   var filter_predicate = _ref.filter_predicate,
     filter_term = _ref.filter_term;
   switch (filter_predicate) {
@@ -13,75 +17,75 @@ var numberFilter = function numberFilter(cellValue, _ref) {
         if (!filter_term && filter_term !== 0) {
           return true;
         }
-        if (!cellValue && cellValue !== 0) {
+        if (!number && number !== 0) {
           return false;
         }
-        return isNumberEqual(filter_term, cellValue);
+        return isNumberEqual(filter_term, number);
       }
     case FILTER_PREDICATE_TYPE.NOT_EQUAL:
       {
-        if (!filter_term && filter_term !== 0 || !cellValue && cellValue !== 0) {
+        if (!filter_term && filter_term !== 0 || !number && number !== 0) {
           return true;
         }
-        return !isNumberEqual(filter_term, cellValue);
+        return !isNumberEqual(filter_term, number);
       }
     case FILTER_PREDICATE_TYPE.LESS:
       {
         if (!filter_term && filter_term !== 0) {
           return true;
         }
-        if (!cellValue && cellValue !== 0 || isNumberEqual(cellValue, filter_term)) {
+        if (!number && number !== 0 || isNumberEqual(number, filter_term)) {
           return false;
         }
-        return cellValue < filter_term;
+        return number < filter_term;
       }
     case FILTER_PREDICATE_TYPE.GREATER:
       {
         if (!filter_term && filter_term !== 0) {
           return true;
         }
-        if (!cellValue && cellValue !== 0 || isNumberEqual(cellValue, filter_term)) {
+        if (!number && number !== 0 || isNumberEqual(number, filter_term)) {
           return false;
         }
-        return cellValue > filter_term;
+        return number > filter_term;
       }
     case FILTER_PREDICATE_TYPE.LESS_OR_EQUAL:
       {
         if (!filter_term && filter_term !== 0) {
           return true;
         }
-        if (!cellValue && cellValue !== 0) {
+        if (!number && number !== 0) {
           return false;
         }
-        if (isNumberEqual(cellValue, filter_term)) {
+        if (isNumberEqual(number, filter_term)) {
           return true;
         }
-        return cellValue < filter_term;
+        return number < filter_term;
       }
     case FILTER_PREDICATE_TYPE.GREATER_OR_EQUAL:
       {
         if (!filter_term && filter_term !== 0) {
           return true;
         }
-        if (!cellValue && cellValue !== 0) {
+        if (!number && number !== 0) {
           return false;
         }
-        return isNumberEqual(cellValue, filter_term) || cellValue > filter_term;
+        return isNumberEqual(number, filter_term) || number > filter_term;
       }
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        if (cellValue === 0) {
+        if (number === 0) {
           return false;
         }
-        return !cellValue || typeof cellValue !== 'number';
+        return !number || typeof number !== 'number';
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
         // must be a number
-        if (cellValue === 0) {
+        if (number === 0) {
           return true;
         }
-        return cellValue && typeof cellValue === 'number' ? true : false;
+        return !!(number && typeof number === 'number');
       }
     default:
       {

package/es/filter/filter-column/single-select.js

@@ -1,35 +1,39 @@
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var singleSelectFilter = function singleSelectFilter(cellValue, _ref) {
+/**
+ * Filter single-select
+ * @param {string} optionId
+ * @param {string} filter_predicate
+ * @param {string|array} filter_term option id or option ids
+ * @returns bool
+ */
+var singleSelectFilter = function singleSelectFilter(optionId, _ref) {
   var filter_predicate = _ref.filter_predicate,
     filter_term = _ref.filter_term;
   switch (filter_predicate) {
     case FILTER_PREDICATE_TYPE.IS:
       {
-        return !filter_term || cellValue === filter_term;
+        return !filter_term || optionId === filter_term;
       }
     case FILTER_PREDICATE_TYPE.IS_NOT:
       {
-        return !filter_term || cellValue !== filter_term;
+        return !filter_term || optionId !== filter_term;
       }
     case FILTER_PREDICATE_TYPE.IS_ANY_OF:
       {
-        return filter_term.length === 0 || filter_term.includes(cellValue);
+        return filter_term.length === 0 || filter_term.includes(optionId);
       }
     case FILTER_PREDICATE_TYPE.IS_NONE_OF:
       {
-        return filter_term.length === 0 || filter_term.indexOf(cellValue) < 0;
+        return filter_term.length === 0 || filter_term.indexOf(optionId) < 0;
       }
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return cellValue ? false : true;
+        return !optionId;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return cellValue ? true : false;
+        return !!optionId;
       }
     default:
       {

package/es/filter/filter-column/text.js

@@ -1,9 +1,14 @@
-import '../../constants/filter/filter-column-options.js';
-import '../../constants/filter/filter-modifier.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
-import '../../constants/filter/filter-is-within.js';
 
-var textFilter = function textFilter(cellValue, _ref, userId) {
+/**
+ * Filter text
+ * @param {string} text
+ * @param {string} filter_predicate
+ * @param {string} filter_term
+ * @param {string} userId
+ * @returns bool
+ */
+var textFilter = function textFilter(text, _ref, userId) {
   var filter_predicate = _ref.filter_predicate,
     filter_term = _ref.filter_term;
   switch (filter_predicate) {
@@ -12,38 +17,38 @@ var textFilter = function textFilter(cellValue, _ref, userId) {
         if (!filter_term) {
           return true;
         }
-        if (!cellValue) {
+        if (!text) {
           return false;
         }
-        return cellValue.toString().toLowerCase().indexOf(filter_term.toLowerCase()) > -1;
+        return text.toString().toLowerCase().indexOf(filter_term.toLowerCase()) > -1;
       }
     case FILTER_PREDICATE_TYPE.NOT_CONTAIN:
       {
-        if (!filter_term || !cellValue) {
+        if (!filter_term || !text) {
           return true;
         }
-        return cellValue.toString().toLowerCase().indexOf(filter_term.toLowerCase()) < 0;
+        return text.toString().toLowerCase().indexOf(filter_term.toLowerCase()) < 0;
       }
     case FILTER_PREDICATE_TYPE.IS:
       {
-        return !filter_term || cellValue === filter_term;
+        return !filter_term || text === filter_term;
       }
     case FILTER_PREDICATE_TYPE.IS_NOT:
       {
-        return !filter_term || cellValue !== filter_term;
+        return !filter_term || text !== filter_term;
       }
     case FILTER_PREDICATE_TYPE.EMPTY:
       {
-        return cellValue ? false : true;
+        return !text;
       }
     case FILTER_PREDICATE_TYPE.NOT_EMPTY:
       {
-        return cellValue ? true : false;
+        return !!text;
       }
     case FILTER_PREDICATE_TYPE.IS_CURRENT_USER_ID:
       {
         if (!userId) return false;
-        return cellValue === userId;
+        return text === userId;
       }
     default:
       {

package/es/filter/filter-row.js

@@ -113,6 +113,17 @@ var getFilterResult = function getFilterResult(row, filter, _ref) {
       }
   }
 };
+
+/**
+ * Filter row
+ * @param {object} row e.g. { _id, .... }
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {object} formulaRow
+ * @param {string} username
+ * @param {string} userId
+ * @returns filter result, bool
+ */
 var filterRow = function filterRow(row, filterConjunction, filters) {
   var _ref2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {},
     _ref2$formulaRow = _ref2.formulaRow,
@@ -140,6 +151,17 @@ var filterRow = function filterRow(row, filterConjunction, filters) {
   }
   return false;
 };
+
+/**
+ * Filter rows
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {array} rows e.g. [{ _id, .... }, ...]
+ * @param {object} formulaRows
+ * @param {string} username
+ * @param {userId} username
+ * @returns filtered rows ids, array
+ */
 var filterRows = function filterRows(filterConjunction, filters, rows, _ref3) {
   var formulaRows = _ref3.formulaRows,
     username = _ref3.username,
@@ -159,6 +181,19 @@ var filterRows = function filterRows(filterConjunction, filters, rows, _ref3) {
   });
   return filteredRows;
 };
+
+/**
+ * Filter rows without formula calculation
+ * The "formulaRows" need to be provided if you want to filter formula, link columns etc.
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {array} rows e.g. [{ _id, .... }, ...]
+ * @param {object} table e.g. { columns, ... }
+ * @param {object} formulaRows
+ * @param {string} username
+ * @param {userId} username
+ * @returns filtered rows: row_ids and error message: error_message, object
+ */
 var getFilteredRowsWithoutFormulaCalculation = function getFilteredRowsWithoutFormulaCalculation(filterConjunction, filters, rows, table) {
   var _ref4 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref4$formulaRows = _ref4.formulaRows,

package/es/group/core.js

@@ -10,10 +10,10 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 /**
- * check is valid groupby
- * @param {object} groupby { column_key: '', count_type: '', sort_type: '' }
+ * Check is valid groupby
+ * @param {object} groupby e.g. { column_key, count_type, sort_type, ... }
  * @param {array} columns
- * @returns boolean
+ * @returns bool
  */
 var isValidGroupby = function isValidGroupby(groupby, columns) {
   if (!groupby || !Array.isArray(columns)) return false;
@@ -28,10 +28,10 @@ var isValidGroupby = function isValidGroupby(groupby, columns) {
 };
 
 /**
- * get valid groupbys
- * @param {array} groupbys
+ * Get valid groupbys
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
  * @param {array} columns
- * @returns array
+ * @returns valid groupbys, array
  */
 var getValidGroupbys = function getValidGroupbys(groupbys, columns) {
   if (!Array.isArray(groupbys) || !Array.isArray(columns)) {
@@ -41,6 +41,15 @@ var getValidGroupbys = function getValidGroupbys(groupbys, columns) {
     return isValidGroupby(groupby, columns);
   });
 };
+
+/**
+ * Get valid and formatted groupbys
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
+ * @param {array} columns
+ * @param {object} currentTable e.g. { _id, ... }
+ * @param {object} value e.g. { tables, collaborators }
+ * @returns valid and formatted groupbys
+ */
 var deleteInvalidGroupby = function deleteInvalidGroupby(groupbys, columns, currentTable, value) {
   var validGroupbys = getValidGroupbys(groupbys, columns);
   var cleanGroupbys = [];

package/es/group/group-row.js

@@ -311,6 +311,17 @@ var groupRowsWithMultipleGroupbys = function groupRowsWithMultipleGroupbys(group
   groups = getSortedGroups(groups, validGroupbys, value, 0);
   return groups;
 };
+
+/**
+ * Group table rows
+ * @param {array} groupbys e.g. [{ column_key, count_type, column, ... }, ...]
+ * @param {array} rows e.g. [{ _id, ... }, ...]
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
 var groupTableRows = function groupTableRows(groupbys, rows, formulaRows, value) {
   if (groupbys.length === 0) {
     return [];
@@ -347,13 +358,38 @@ var groupTableRows = function groupTableRows(groupbys, rows, formulaRows, value)
   groups = getSortedGroups(groups, groupbys, value, 0);
   return groups;
 };
-var groupViewRows = function groupViewRows(groupbys, table, rows, formulaRows, value) {
-  if (rows.length === 0) {
+
+/**
+ * Group view rows
+ * @param {array} groupbys e.g. [{ column_key, count_type, column, ... }, ...]
+ * @param {object} table e.g. { id_row_map, ... }
+ * @param {array} rowsIds e.g. [ row._id, ...]
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
+var groupViewRows = function groupViewRows(groupbys, table, rowsIds, formulaRows, value) {
+  if (rowsIds.length === 0) {
     return [];
   }
-  var rowsData = getRowsByIds(table, rows);
+  var rowsData = getRowsByIds(table, rowsIds);
   return groupTableRows(groupbys, rowsData, formulaRows, value);
 };
+
+/**
+ * Group rows
+ * The "formulaRows" must be supplied if you want group rows by formula/link-formula/link columns
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
+ * @param {array} rows e.g. table rows: [{ _id, ... }, ...] | view rows: [ row._id, ...]
+ * @param {object} table e.g. { id_row_map, columns, ... }
+ * @param {object} value e.g. { collaborators, ... }
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
 var getGroupedRowsWithoutFormulaCalculation = function getGroupedRowsWithoutFormulaCalculation(groupbys, rows, table, value) {
   var _ref3 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref3$formulaRows = _ref3.formulaRows,