handsontable 9.0.1 → 11.0.1

package/core.js

@@ -4,16 +4,12 @@ require("core-js/modules/es.symbol.js");
 
 require("core-js/modules/es.symbol.description.js");
 
-require("core-js/modules/es.object.to-string.js");
-
 require("core-js/modules/es.symbol.iterator.js");
 
 require("core-js/modules/es.array.iterator.js");
 
 require("core-js/modules/web.dom-collections.iterator.js");
 
-require("core-js/modules/es.array.slice.js");
-
 require("core-js/modules/es.function.name.js");
 
 exports.__esModule = true;
@@ -27,12 +23,18 @@ require("core-js/modules/es.number.is-integer.js");
 
 require("core-js/modules/es.number.constructor.js");
 
+require("core-js/modules/es.array.slice.js");
+
+require("core-js/modules/es.array.concat.js");
+
+require("core-js/modules/es.array.fill.js");
+
+require("core-js/modules/es.array.map.js");
+
 require("core-js/modules/es.regexp.exec.js");
 
 require("core-js/modules/es.string.replace.js");
 
-require("core-js/modules/es.array.concat.js");
-
 require("core-js/modules/es.array.from.js");
 
 require("core-js/modules/es.string.iterator.js");
@@ -41,6 +43,8 @@ require("core-js/modules/es.array.index-of.js");
 
 require("core-js/modules/es.array.reverse.js");
 
+require("core-js/modules/es.object.to-string.js");
+
 require("core-js/modules/web.dom-collections.for-each.js");
 
 require("core-js/modules/web.timers.js");
@@ -97,7 +101,7 @@ var _keyStateObserver = require("./utils/keyStateObserver");
 
 var _selection = require("./selection");
 
-var _index = require("./dataMap/index");
+var _dataMap = require("./dataMap");
 
 var _uniqueMap = require("./utils/dataStructures/uniqueMap");
 
@@ -109,7 +113,7 @@ function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArra
 
 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."); }
 
-function _iterableToArrayLimit(arr, i) { var _i = arr && (typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]); if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
@@ -134,25 +138,19 @@ var activeGuid = null;
  * @core
  * @class Core
  * @description
- * After Handsontable is constructed, you can modify the grid behavior using the available public methods.
  *
- * ## How to call methods.
+ * The `Handsontable` class to which we refer as to `Core`, allows you to modify the grid's behavior by using one of the available public methods.
  *
- * These are 2 equal ways to call a Handsontable method:
+ * ## How to call a method
  *
  * ```js
- * // all following examples assume that you constructed Handsontable like this
- * const hot = new Handsontable(document.getElementById('example1'), options);
+ * // First, let's contruct Handsontable
+ * const hot = new Handsontable(document.getElementById('example'), options);
  *
- * // now, to use setDataAtCell method, you can either:
+ * // Then, let's use the setDataAtCell method
  * hot.setDataAtCell(0, 0, 'new value');
  * ```
  *
- * Alternatively, you can call the method using jQuery wrapper (__obsolete__, requires initialization using our jQuery guide
- * ```js
- * $('#example1').handsontable('setDataAtCell', 0, 0, 'new value');
- * ```
- *
  * @param {HTMLElement} rootElement The element to which the Handsontable instance is injected.
  * @param {object} userSettings The user defined options.
  * @param {boolean} [rootInstanceSymbol=false] Indicates if the instance is root of all later instances created.
@@ -171,7 +169,7 @@ function Core(rootElement, userSettings) {
   var editorManager;
   var firstRun = true;
   userSettings.language = (0, _registry4.getValidLanguageCode)(userSettings.language);
-  var metaManager = new _index.MetaManager(userSettings);
+  var metaManager = new _dataMap.MetaManager(instance, userSettings, [_dataMap.DynamicCellMetaMod]);
   var tableMeta = metaManager.getTableMeta();
   var globalMeta = metaManager.getGlobalMeta();
   var pluginsRegistry = (0, _uniqueMap.createUniqueMap)();
@@ -456,8 +454,6 @@ function Core(rootElement, userSettings) {
     /**
      * Inserts or removes rows and columns.
      *
-     * @memberof Core#
-     * @function alter
      * @private
      * @param {string} action Possible values: "insert_row", "insert_col", "remove_row", "remove_col".
      * @param {number|Array} index Row or column visual index which from the alter action will be triggered.
@@ -736,6 +732,8 @@ function Core(rootElement, userSettings) {
 
     /**
      * Makes sure there are empty rows at the bottom of the table.
+     *
+     * @private
      */
     adjustRowsAndCols: function adjustRowsAndCols() {
       var minRows = tableMeta.minRows;
@@ -876,72 +874,91 @@ function Core(rootElement, userSettings) {
       var clen;
       var setData = [];
       var current = {};
+      var newDataByColumns = [];
+      var startRow = start.row;
+      var startColumn = start.col;
       rlen = input.length;
 
       if (rlen === 0) {
         return false;
       }
 
-      var repeatCol;
-      var repeatRow;
-      var cmax;
-      var rmax;
-      /* eslint-disable no-case-declarations */
-      // insert data with specified pasteMode method
+      var columnsPopulationEnd = 0;
+      var rowsPopulationEnd = 0;
+
+      if ((0, _object.isObject)(end)) {
+        columnsPopulationEnd = end.col - startColumn + 1;
+        rowsPopulationEnd = end.row - startRow + 1;
+      } // insert data with specified pasteMode method
+
 
       switch (method) {
         case 'shift_down':
-          repeatCol = end ? end.col - start.col + 1 : 0;
-          repeatRow = end ? end.row - start.row + 1 : 0; // eslint-disable-next-line no-param-reassign
+          // translate data from a list of rows to a list of columns
+          var populatedDataByColumns = (0, _array.pivot)(input);
+          var numberOfDataColumns = populatedDataByColumns.length; // method's argument can extend the range of data population (data would be repeated)
 
-          input = (0, _data.translateRowsToColumns)(input);
+          var numberOfColumnsToPopulate = Math.max(numberOfDataColumns, columnsPopulationEnd);
+          var pushedDownDataByRows = instance.getData().slice(startRow); // translate data from a list of rows to a list of columns
 
-          for (c = 0, clen = input.length, cmax = Math.max(clen, repeatCol); c < cmax; c++) {
-            if (c < clen) {
-              var _instance;
+          var pushedDownDataByColumns = (0, _array.pivot)(pushedDownDataByRows).slice(startColumn, startColumn + numberOfColumnsToPopulate);
 
-              for (r = 0, rlen = input[c].length; r < repeatRow - rlen; r++) {
-                input[c].push(input[c][r % rlen]);
+          for (c = 0; c < numberOfColumnsToPopulate; c += 1) {
+            if (c < numberOfDataColumns) {
+              for (r = 0, rlen = populatedDataByColumns[c].length; r < rowsPopulationEnd - rlen; r += 1) {
+                // repeating data for rows
+                populatedDataByColumns[c].push(populatedDataByColumns[c][r % rlen]);
               }
 
-              input[c].unshift(start.col + c, start.row, 0);
-
-              (_instance = instance).spliceCol.apply(_instance, _toConsumableArray(input[c]));
+              if (c < pushedDownDataByColumns.length) {
+                newDataByColumns.push(populatedDataByColumns[c].concat(pushedDownDataByColumns[c]));
+              } else {
+                // if before data population, there was no data in the column
+                // we fill the required rows' newly-created cells with `null` values
+                newDataByColumns.push(populatedDataByColumns[c].concat(new Array(pushedDownDataByRows.length).fill(null)));
+              }
             } else {
-              var _instance2;
-
-              input[c % clen][0] = start.col + c;
-
-              (_instance2 = instance).spliceCol.apply(_instance2, _toConsumableArray(input[c % clen]));
+              // Repeating data for columns.
+              newDataByColumns.push(populatedDataByColumns[c % numberOfDataColumns].concat(pushedDownDataByColumns[c]));
             }
           }
 
+          instance.populateFromArray(startRow, startColumn, (0, _array.pivot)(newDataByColumns));
           break;
 
         case 'shift_right':
-          repeatCol = end ? end.col - start.col + 1 : 0;
-          repeatRow = end ? end.row - start.row + 1 : 0;
+          var numberOfDataRows = input.length; // method's argument can extend the range of data population (data would be repeated)
 
-          for (r = 0, rlen = input.length, rmax = Math.max(rlen, repeatRow); r < rmax; r++) {
-            if (r < rlen) {
-              var _instance3;
+          var numberOfRowsToPopulate = Math.max(numberOfDataRows, rowsPopulationEnd);
+          var pushedRightDataByRows = instance.getData().slice(startRow).map(function (rowData) {
+            return rowData.slice(startColumn);
+          });
 
-              for (c = 0, clen = input[r].length; c < repeatCol - clen; c++) {
+          for (r = 0; r < numberOfRowsToPopulate; r += 1) {
+            if (r < numberOfDataRows) {
+              for (c = 0, clen = input[r].length; c < columnsPopulationEnd - clen; c += 1) {
+                // repeating data for rows
                 input[r].push(input[r][c % clen]);
               }
 
-              input[r].unshift(start.row + r, start.col, 0);
+              if (r < pushedRightDataByRows.length) {
+                for (var i = 0; i < pushedRightDataByRows[r].length; i += 1) {
+                  input[r].push(pushedRightDataByRows[r][i]);
+                }
+              } else {
+                var _input$r;
 
-              (_instance3 = instance).spliceRow.apply(_instance3, _toConsumableArray(input[r]));
+                // if before data population, there was no data in the row
+                // we fill the required columns' newly-created cells with `null` values
+                (_input$r = input[r]).push.apply(_input$r, _toConsumableArray(new Array(pushedRightDataByRows[0].length).fill(null)));
+              }
             } else {
-              var _instance4;
-
-              input[r % rlen][0] = start.row + r;
-
-              (_instance4 = instance).spliceRow.apply(_instance4, _toConsumableArray(input[r % rlen]));
+              // Repeating data for columns.
+              input.push(input[r % rlen].slice(0, numberOfRowsToPopulate).concat(pushedRightDataByRows[r]));
             }
           }
 
+          instance.populateFromArray(startRow, startColumn, input);
           break;
 
         case 'overwrite':
@@ -1243,10 +1260,6 @@ function Core(rootElement, userSettings) {
 
     var waitingForValidator = new ValidatorsQueue();
 
-    var isNumericData = function isNumericData(value) {
-      return value.length > 0 && /^\s*[+-.]?\s*(?:(?:\d+(?:(\.|,)\d+)?(?:e[+-]?\d+)?)|(?:0x[a-f\d]+))\s*$/.test(value);
-    };
-
     waitingForValidator.onQueueEmpty = function (isValid) {
       if (activeEditor && shouldBeCanceled) {
         activeEditor.cancelChanges();
@@ -1267,7 +1280,7 @@ function Core(rootElement, userSettings) {
         var col = datamap.propToCol(prop);
         var cellProperties = instance.getCellMeta(row, col);
 
-        if (cellProperties.type === 'numeric' && typeof newValue === 'string' && isNumericData(newValue)) {
+        if (cellProperties.type === 'numeric' && typeof newValue === 'string' && (0, _number.isNumericLike)(newValue)) {
           changes[i][3] = getParsedNumber(newValue);
         }
         /* eslint-disable no-loop-func */
@@ -1391,6 +1404,8 @@ function Core(rootElement, userSettings) {
   /**
    * Validate a single cell.
    *
+   * @memberof Core#
+   * @function validateCell
    * @param {string|number} value The value to validate.
    * @param {object} cellProperties The cell meta which corresponds with the value.
    * @param {Function} callback The callback function.
@@ -1402,6 +1417,8 @@ function Core(rootElement, userSettings) {
     var validator = instance.getCellValidator(cellProperties); // the `canBeValidated = false` argument suggests, that the cell passes validation by default.
 
     /**
+     * @private
+     * @function done
      * @param {boolean} valid Indicates if the validation was successful.
      * @param {boolean} [canBeValidated=true] Flag which controls the validation process.
      */
@@ -1651,7 +1668,7 @@ function Core(rootElement, userSettings) {
     return grid.populateFromArray(new _src.CellCoords(row, column), input, c, source, method, direction, deltas);
   };
   /**
-   * Adds/removes data from the column. This method works the same as Array.splice for arrays (see {@link DataMap#spliceCol}).
+   * Adds/removes data from the column. This method works the same as Array.splice for arrays.
    *
    * @memberof Core#
    * @function spliceCol
@@ -1673,7 +1690,7 @@ function Core(rootElement, userSettings) {
     return (_datamap = datamap).spliceCol.apply(_datamap, [column, index, amount].concat(elements));
   };
   /**
-   * Adds/removes data from the row. This method works the same as Array.splice for arrays (see {@link DataMap#spliceRow}).
+   * Adds/removes data from the row. This method works the same as Array.splice for arrays.
    *
    * @memberof Core#
    * @function spliceRow
@@ -2200,7 +2217,7 @@ function Core(rootElement, userSettings) {
     }
 
     data = instance.runHooks('beforeLoadData', data, firstRun, source);
-    datamap = new _index.DataMap(instance, data, tableMeta);
+    datamap = new _dataMap.DataMap(instance, data, tableMeta);
 
     if (_typeof(data) === 'object' && data !== null) {
       if (!(data.push && data.splice)) {
@@ -2336,7 +2353,7 @@ function Core(rootElement, userSettings) {
   };
   /**
    * Returns a string value of the selected range. Each column is separated by tab, each row is separated by a new
-   * line character (see {@link DataMap#getCopyableText}).
+   * line character.
    *
    * @memberof Core#
    * @function getCopyableText
@@ -2352,7 +2369,7 @@ function Core(rootElement, userSettings) {
     return datamap.getCopyableText(new _src.CellCoords(startRow, startCol), new _src.CellCoords(endRow, endCol));
   };
   /**
-   * Returns the data's copyable value at specified `row` and `column` index (see {@link DataMap#getCopyable}).
+   * Returns the data's copyable value at specified `row` and `column` index.
    *
    * @memberof Core#
    * @function getCopyableData
@@ -2556,6 +2573,7 @@ function Core(rootElement, userSettings) {
 
       instance._refreshBorders(null);
 
+      instance.view.wt.wtOverlays.adjustElementsSize();
       editorManager.unlockEditor();
     }
 
@@ -2616,10 +2634,12 @@ function Core(rootElement, userSettings) {
    * @memberof Core#
    * @function alter
    * @param {string} action Possible alter operations:
-   *  * `'insert_row'`
-   *  * `'insert_col'`
-   *  * `'remove_row'`
-   *  * `'remove_col'`.
+   *  <ul>
+   *    <li> `'insert_row'` </li>
+   *    <li> `'insert_col'` </li>
+   *    <li> `'remove_row'` </li>
+   *    <li> `'remove_col'` </li>
+   * </ul>.
    * @param {number|number[]} index Visual index of the row/column before which the new row/column will be
    *                                inserted/removed or an array of arrays in format `[[index, amount],...]`.
    * @param {number} [amount=1] Amount of rows/columns to be inserted or removed.
@@ -2722,7 +2742,7 @@ function Core(rootElement, userSettings) {
     return new _src.CellCoords(visualRow, visualColumn);
   };
   /**
-   * Returns the property name that corresponds with the given column index (see {@link DataMap#colToProp}).
+   * Returns the property name that corresponds with the given column index.
    * If the data source is an array of arrays, it returns the columns index.
    *
    * @memberof Core#
@@ -2736,7 +2756,7 @@ function Core(rootElement, userSettings) {
     return datamap.colToProp(column);
   };
   /**
-   * Returns column index that corresponds with the given property (see {@link DataMap#propToCol}).
+   * Returns column index that corresponds with the given property.
    *
    * @memberof Core#
    * @function propToCol
@@ -2830,7 +2850,7 @@ function Core(rootElement, userSettings) {
     return datamap.get(row, datamap.colToProp(column));
   };
   /**
-   * Returns value at visual `row` and `prop` indexes (see {@link DataMap#get}).
+   * Returns value at visual `row` and `prop` indexes.
    *
    * __Note__: If data is reordered, sorted or trimmed, the currently visible order will be used.
    *
@@ -3056,7 +3076,7 @@ function Core(rootElement, userSettings) {
   };
   /**
    * @description
-   * Returns a data type defined in the Handsontable settings under the `type` key ([Options#type](https://handsontable.com/docs/Options.html#type)).
+   * Returns a data type defined in the Handsontable settings under the `type` key ({@link Options#type}).
    * If there are cells with different types in the selected range, it returns `'mixed'`.
    *
    * __Note__: If data is reordered, sorted or trimmed, the currently visible order will be used.
@@ -3128,7 +3148,7 @@ function Core(rootElement, userSettings) {
     var _ref19 = [this.toPhysicalRow(row), this.toPhysicalColumn(column)],
         physicalRow = _ref19[0],
         physicalColumn = _ref19[1];
-    var cachedValue = metaManager.getCellMeta(physicalRow, physicalColumn, key);
+    var cachedValue = metaManager.getCellMetaKeyValue(physicalRow, physicalColumn, key);
     var hookResult = instance.runHooks('beforeRemoveCellMeta', row, column, key, cachedValue);
 
     if (hookResult !== false) {
@@ -3175,6 +3195,8 @@ function Core(rootElement, userSettings) {
         });
       });
     }
+
+    instance.render();
   };
   /**
    * Set cell meta data object defined by `prop` to the corresponding params `row` and `column`.
@@ -3268,33 +3290,10 @@ function Core(rootElement, userSettings) {
       physicalColumn = column;
     }
 
-    var prop = datamap.colToProp(column);
-    var cellProperties = metaManager.getCellMeta(physicalRow, physicalColumn); // TODO(perf): Add assigning this props and executing below code only once per table render cycle.
-
-    cellProperties.row = physicalRow;
-    cellProperties.col = physicalColumn;
-    cellProperties.visualRow = row;
-    cellProperties.visualCol = column;
-    cellProperties.prop = prop;
-    cellProperties.instance = instance;
-    instance.runHooks('beforeGetCellMeta', row, column, cellProperties); // for `type` added or changed in beforeGetCellMeta
-
-    if (instance.hasHook('beforeGetCellMeta') && (0, _object.hasOwnProperty)(cellProperties, 'type')) {
-      metaManager.updateCellMeta(physicalRow, physicalColumn, {
-        type: cellProperties.type
-      });
-    }
-
-    if (cellProperties.cells) {
-      var settings = cellProperties.cells(physicalRow, physicalColumn, prop);
-
-      if (settings) {
-        metaManager.updateCellMeta(physicalRow, physicalColumn, settings);
-      }
-    }
-
-    instance.runHooks('afterGetCellMeta', row, column, cellProperties);
-    return cellProperties;
+    return metaManager.getCellMeta(physicalRow, physicalColumn, {
+      visualRow: row,
+      visualColumn: column
+    });
   };
   /**
    * Returns an array of cell meta objects for specified physical row index.
@@ -3768,6 +3767,8 @@ function Core(rootElement, userSettings) {
   /**
    * Returns the row height.
    *
+   * Mind that this method is different from the [AutoRowSize](@/api/autoRowSize.md) plugin's [`getRowHeight()`](@/api/autoRowSize.md#getrowheight) method.
+   *
    * @memberof Core#
    * @function getRowHeight
    * @param {number} row Visual row index.
@@ -4584,6 +4585,45 @@ function Core(rootElement, userSettings) {
       editorManager.prepareEditor();
     }
   };
+  /**
+   * Check if currently it is RTL direction.
+   *
+   * @private
+   * @memberof Core#
+   * @function isRtl
+   * @returns {boolean} True if RTL.
+   */
+
+
+  this.isRtl = function () {
+    return instance.rootWindow.getComputedStyle(instance.rootElement).direction === 'rtl';
+  };
+  /**
+   * Check if currently it is LTR direction.
+   *
+   * @private
+   * @memberof Core#
+   * @function isLtr
+   * @returns {boolean} True if LTR.
+   */
+
+
+  this.isLtr = function () {
+    return !instance.isRtl();
+  };
+  /**
+   * Returns 1 for LTR; -1 for RTL. Useful for calculations.
+   *
+   * @private
+   * @memberof Core#
+   * @function getDirectionFactor
+   * @returns {number} Returns 1 for LTR; -1 for RTL.
+   */
+
+
+  this.getDirectionFactor = function () {
+    return instance.isLtr() ? 1 : -1;
+  };
 
   (0, _registry.getPluginsNames)().forEach(function (pluginName) {
     var PluginClass = (0, _registry.getPlugin)(pluginName);