handsontable 12.3.1-next-83e8a23-20230111 → 12.3.1-next-8792e1c-20230202

package/plugins/mergeCells/mergeCells.mjs

@@ -1,10 +1,14 @@
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 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 _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
@@ -24,6 +28,12 @@ import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.string.iterator.js";
 import "core-js/modules/es.weak-map.js";
 import "core-js/modules/web.dom-collections.iterator.js";
+import "core-js/modules/web.dom-collections.for-each.js";
+import "core-js/modules/es.set.js";
+import "core-js/modules/es.array.map.js";
+import "core-js/modules/es.function.name.js";
+import "core-js/modules/es.regexp.exec.js";
+import "core-js/modules/es.string.replace.js";
 import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.string.includes.js";
 import "core-js/modules/es.object.set-prototype-of.js";
@@ -37,10 +47,8 @@ import "core-js/modules/es.symbol.js";
 import "core-js/modules/es.symbol.description.js";
 import "core-js/modules/es.number.constructor.js";
 import "core-js/modules/es.symbol.iterator.js";
-import "core-js/modules/es.array.slice.js";
-import "core-js/modules/es.function.name.js";
 import "core-js/modules/es.array.from.js";
-import "core-js/modules/es.regexp.exec.js";
+import "core-js/modules/es.array.slice.js";
 import { BasePlugin } from "../base/index.mjs";
 import Hooks from "../../pluginHooks.mjs";
 import MergedCellsCollection from "./cellsCollection.mjs";
@@ -53,6 +61,8 @@ import { isObject, clone } from "../../helpers/object.mjs";
 import { warn } from "../../helpers/console.mjs";
 import { rangeEach } from "../../helpers/number.mjs";
 import { applySpanProperties } from "./utils.mjs";
+import { getStyle } from "../../helpers/dom/element.mjs";
+import { isChrome } from "../../helpers/browser.mjs";
 Hooks.getSingleton().register('beforeMergeCells');
 Hooks.getSingleton().register('afterMergeCells');
 Hooks.getSingleton().register('beforeUnmergeCells');
@@ -252,7 +262,8 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Updates the plugin's state.
      *
-     * This method is executed when [`updateSettings()`](@/api/core.md#updatesettings) is invoked with any of the following configuration options:
+     * This method is executed when [`updateSettings()`](@/api/core.md#updatesettings) is invoked with any of the
+     * following configuration options:
      *  - [`mergeCells`](@/api/options.md#mergecells)
      */
   }, {
@@ -265,6 +276,56 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
       _get(_getPrototypeOf(MergeCells.prototype), "updatePlugin", this).call(this);
     }
 
+    /**
+     * If the browser is recognized as Chrome, force an additional repaint to prevent showing the effects of a Chrome bug.
+     *
+     * Issue described in https://github.com/handsontable/dev-handsontable/issues/521.
+     *
+     * @private
+     */
+  }, {
+    key: "ifChromeForceRepaint",
+    value: function ifChromeForceRepaint() {
+      var _this3 = this;
+      if (!isChrome()) {
+        return;
+      }
+      var rowsToRefresh = [];
+      var rowIndexesToRefresh = [];
+      this.mergedCellsCollection.mergedCells.forEach(function (mergedCell) {
+        var row = mergedCell.row,
+          rowspan = mergedCell.rowspan;
+        for (var r = row + 1; r < row + rowspan; r++) {
+          rowIndexesToRefresh.push(r);
+        }
+      });
+
+      // Remove duplicates
+      rowIndexesToRefresh = _toConsumableArray(new Set(rowIndexesToRefresh));
+      rowIndexesToRefresh.forEach(function (rowIndex) {
+        var renderableRowIndex = _this3.hot.rowIndexMapper.getRenderableFromVisualIndex(rowIndex);
+        _this3.hot.view._wt.wtOverlays.getOverlays(true).map(function (overlay) {
+          return (overlay === null || overlay === void 0 ? void 0 : overlay.name) === 'master' ? overlay : overlay.clone.wtTable;
+        }).forEach(function (wtTableRef) {
+          var rowToRefresh = wtTableRef.getRow(renderableRowIndex);
+          if (rowToRefresh) {
+            // Modify the TR's `background` property to later modify it asynchronously.
+            // The background color is getting modified only with the alpha, so the change should not be visible (and is
+            // covered by the TDs' background color).
+            rowToRefresh.style.background = getStyle(rowToRefresh, 'backgroundColor').replace(')', ', 0.99)');
+            rowsToRefresh.push(rowToRefresh);
+          }
+        });
+      });
+
+      // Asynchronously revert the TRs' `background` property to force a fresh repaint.
+      this.hot._registerTimeout(function () {
+        rowsToRefresh.forEach(function (rowElement) {
+          rowElement.style.background = getStyle(rowElement, 'backgroundColor').replace(', 0.99)', ')');
+        });
+      }, 1);
+    }
+
     /**
      * Validates a single setting object, represented by a single merged cell information object.
      *
@@ -304,19 +365,19 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "generateFromSettings",
     value: function generateFromSettings(settings) {
-      var _this3 = this;
+      var _this4 = this;
       if (Array.isArray(settings)) {
         var populatedNulls = [];
         arrayEach(settings, function (setting) {
-          if (!_this3.validateSetting(setting)) {
+          if (!_this4.validateSetting(setting)) {
             return;
           }
-          var highlight = _this3.hot._createCellCoords(setting.row, setting.col);
-          var rangeEnd = _this3.hot._createCellCoords(setting.row + setting.rowspan - 1, setting.col + setting.colspan - 1);
-          var mergeRange = _this3.hot._createCellRange(highlight, highlight, rangeEnd);
+          var highlight = _this4.hot._createCellCoords(setting.row, setting.col);
+          var rangeEnd = _this4.hot._createCellCoords(setting.row + setting.rowspan - 1, setting.col + setting.colspan - 1);
+          var mergeRange = _this4.hot._createCellRange(highlight, highlight, rangeEnd);
 
           // Merging without data population.
-          _this3.mergeRange(mergeRange, true, true);
+          _this4.mergeRange(mergeRange, true, true);
           rangeEach(setting.row, setting.row + setting.rowspan - 1, function (rowIndex) {
             rangeEach(setting.col, setting.col + setting.colspan - 1, function (columnIndex) {
               // Not resetting a cell representing a merge area's value.
@@ -422,15 +483,17 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {CellRange} cellRange Cell range to merge.
      * @param {boolean} [auto=false] `true` if is called automatically, e.g. At initialization.
-     * @param {boolean} [preventPopulation=false] `true`, if the method should not run `populateFromArray` at the end, but rather return its arguments.
-     * @returns {Array|boolean} Returns an array of [row, column, dataUnderCollection] if preventPopulation is set to true. If the the merging process went successful, it returns `true`, otherwise - `false`.
+     * @param {boolean} [preventPopulation=false] `true`, if the method should not run `populateFromArray` at the end,
+     *   but rather return its arguments.
+     * @returns {Array|boolean} Returns an array of [row, column, dataUnderCollection] if preventPopulation is set to
+     *   true. If the the merging process went successful, it returns `true`, otherwise - `false`.
      * @fires Hooks#beforeMergeCells
      * @fires Hooks#afterMergeCells
      */
   }, {
     key: "mergeRange",
     value: function mergeRange(cellRange) {
-      var _this4 = this;
+      var _this5 = this;
       var auto = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
       var preventPopulation = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       var topStart = cellRange.getTopStartCorner();
@@ -454,9 +517,9 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
             clearedData[i] = [];
           }
           if (i === 0 && j === 0) {
-            clearedValue = _this4.hot.getSourceDataAtCell(_this4.hot.toPhysicalRow(mergeParent.row), _this4.hot.toPhysicalColumn(mergeParent.col));
+            clearedValue = _this5.hot.getSourceDataAtCell(_this5.hot.toPhysicalRow(mergeParent.row), _this5.hot.toPhysicalColumn(mergeParent.col));
           } else {
-            _this4.hot.setCellMeta(mergeParent.row + i, mergeParent.col + j, 'hidden', true);
+            _this5.hot.setCellMeta(mergeParent.row + i, mergeParent.col + j, 'hidden', true);
           }
           clearedData[i][j] = clearedValue;
         });
@@ -469,6 +532,9 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
         } else {
           this.hot.populateFromArray(mergeParent.row, mergeParent.col, clearedData, void 0, void 0, this.pluginName);
         }
+        if (!auto) {
+          this.ifChromeForceRepaint();
+        }
         this.hot.runHooks('afterMergeCells', cellRange, mergeParent, auto);
         return populationInfo;
       }
@@ -488,7 +554,7 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "unmergeRange",
     value: function unmergeRange(cellRange) {
-      var _this5 = this;
+      var _this6 = this;
       var auto = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
       var mergedCells = this.mergedCellsCollection.getWithinRange(cellRange);
       if (!mergedCells) {
@@ -496,13 +562,13 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
       }
       this.hot.runHooks('beforeUnmergeCells', cellRange, auto);
       arrayEach(mergedCells, function (currentCollection) {
-        _this5.mergedCellsCollection.remove(currentCollection.row, currentCollection.col);
+        _this6.mergedCellsCollection.remove(currentCollection.row, currentCollection.col);
         rangeEach(0, currentCollection.rowspan - 1, function (i) {
           rangeEach(0, currentCollection.colspan - 1, function (j) {
-            _this5.hot.removeCellMeta(currentCollection.row + i, currentCollection.col + j, 'hidden');
+            _this6.hot.removeCellMeta(currentCollection.row + i, currentCollection.col + j, 'hidden');
           });
         });
-        _this5.hot.removeCellMeta(currentCollection.row, currentCollection.col, 'spanned');
+        _this6.hot.removeCellMeta(currentCollection.row, currentCollection.col, 'spanned');
       });
       this.hot.runHooks('afterUnmergeCells', cellRange, auto);
       this.hot.render();
@@ -582,14 +648,14 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "registerShortcuts",
     value: function registerShortcuts() {
-      var _this6 = this;
+      var _this7 = this;
       var shortcutManager = this.hot.getShortcutManager();
       var gridContext = shortcutManager.getContext('grid');
       gridContext.addShortcut({
         keys: [['Control', 'm']],
         callback: function callback() {
-          _this6.toggleMerge(_this6.hot.getSelectedRangeLast());
-          _this6.hot.render();
+          _this7.toggleMerge(_this7.hot.getSelectedRangeLast());
+          _this7.hot.render();
         },
         runOnlyIf: function runOnlyIf(event) {
           return !event.altKey;
@@ -613,7 +679,8 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Modifies the information on whether the current selection contains multiple cells. The `afterIsMultipleSelection` hook callback.
+     * Modifies the information on whether the current selection contains multiple cells. The `afterIsMultipleSelection`
+     * hook callback.
      *
      * @private
      * @param {boolean} isMultiple Determines whether the current selection contains multiple cells.
@@ -709,7 +776,7 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onModifyTransformEnd",
     value: function onModifyTransformEnd(delta) {
-      var _this7 = this;
+      var _this8 = this;
       var currentSelectionRange = this.hot.getSelectedRangeLast();
       var newDelta = clone(delta);
       var newSelectionRange = this.selectionCalculations.getUpdatedSelectionRange(currentSelectionRange, delta);
@@ -719,7 +786,7 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
         tempDelta = clone(newDelta);
         this.selectionCalculations.getUpdatedSelectionRange(currentSelectionRange, newDelta);
         arrayEach(mergedCellsWithinRange, function (mergedCell) {
-          _this7.selectionCalculations.snapDelta(newDelta, currentSelectionRange, mergedCell);
+          _this8.selectionCalculations.snapDelta(newDelta, currentSelectionRange, mergedCell);
         });
       } while (newDelta.row !== tempDelta.row || newDelta.col !== tempDelta.col);
       delta.row = newDelta.row;
@@ -837,7 +904,8 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
 
     /**
      * `beforeSetRangeEnd` hook callback.
-     * While selecting cells with keyboard or mouse, make sure that rectangular area is expanded to the extent of the merged cell.
+     * While selecting cells with keyboard or mouse, make sure that rectangular area is expanded to the extent of the
+     * merged cell.
      *
      * Note: Please keep in mind that callback may modify both start and end range coordinates by the reference.
      *
@@ -1209,13 +1277,15 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * `afterModifyTransformStart` hook callback. Fixes a problem with navigating through merged cells at the edges of the table
-     * with the ENTER/SHIFT+ENTER/TAB/SHIFT+TAB keys.
+     * `afterModifyTransformStart` hook callback. Fixes a problem with navigating through merged cells at the edges of
+     * the table with the ENTER/SHIFT+ENTER/TAB/SHIFT+TAB keys.
      *
      * @private
      * @param {CellCoords} coords Coordinates of the to-be-selected cell.
-     * @param {number} rowTransformDir Row transformation direction (negative value = up, 0 = none, positive value = down).
-     * @param {number} colTransformDir Column transformation direction (negative value = up, 0 = none, positive value = down).
+     * @param {number} rowTransformDir Row transformation direction (negative value = up, 0 = none, positive value =
+     *   down).
+     * @param {number} colTransformDir Column transformation direction (negative value = up, 0 = none, positive value =
+     *   down).
      */
   }, {
     key: "onAfterModifyTransformStart",
@@ -1247,9 +1317,11 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {number} currentRow Visual row index of the currently processed cell.
      * @param {number} currentColumn Visual column index of the currently cell.
-     * @param {Array} cornersOfSelection Array of the current selection in a form of `[startRow, startColumn, endRow, endColumn]`.
+     * @param {Array} cornersOfSelection Array of the current selection in a form of `[startRow, startColumn, endRow,
+     *   endColumn]`.
      * @param {number|undefined} layerLevel Number indicating which layer of selection is currently processed.
-     * @returns {string|undefined} A `String`, which will act as an additional `className` to be added to the currently processed cell.
+     * @returns {string|undefined} A `String`, which will act as an additional `className` to be added to the currently
+     *   processed cell.
      */
   }, {
     key: "onAfterDrawSelection",
@@ -1265,7 +1337,8 @@ export var MergeCells = /*#__PURE__*/function (_BasePlugin) {
      * `beforeRemoveCellClassNames` hook callback. Used to remove additional class name from all cells in the table.
      *
      * @private
-     * @returns {string[]} An `Array` of `String`s. Each of these strings will act like class names to be removed from all the cells in the table.
+     * @returns {string[]} An `Array` of `String`s. Each of these strings will act like class names to be removed from
+     *   all the cells in the table.
      */
   }, {
     key: "onBeforeRemoveCellClassNames",

package/shortcuts/manager.js

@@ -151,6 +151,15 @@ var createShortcutManager = function createShortcutManager(_ref) {
     isCtrlPressed: function isCtrlPressed() {
       return !isCtrlKeySilenced && (keyRecorder.isPressed('control') || keyRecorder.isPressed('meta'));
     },
+    /**
+     * Release every previously pressed key.
+     *
+     * @type {Function}
+     * @memberof ShortcutManager#
+     */
+    releasePressedKeys: function releasePressedKeys() {
+      return keyRecorder.releasePressedKeys();
+    },
     /**
      * Destroy a context manager instance.
      *

package/shortcuts/manager.mjs

@@ -146,6 +146,15 @@ export var createShortcutManager = function createShortcutManager(_ref) {
     isCtrlPressed: function isCtrlPressed() {
       return !isCtrlKeySilenced && (keyRecorder.isPressed('control') || keyRecorder.isPressed('meta'));
     },
+    /**
+     * Release every previously pressed key.
+     *
+     * @type {Function}
+     * @memberof ShortcutManager#
+     */
+    releasePressedKeys: function releasePressedKeys() {
+      return keyRecorder.releasePressedKeys();
+    },
     /**
      * Destroy a context manager instance.
      *

package/shortcuts/recorder.js

@@ -160,6 +160,9 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
     unmount: unmount,
     isPressed: function isPressed(key) {
       return modifierKeysObserver.isPressed(key);
+    },
+    releasePressedKeys: function releasePressedKeys() {
+      return modifierKeysObserver.releaseAll();
     }
   };
 }

package/shortcuts/recorder.mjs

@@ -156,6 +156,9 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
     unmount: unmount,
     isPressed: function isPressed(key) {
       return modifierKeysObserver.isPressed(key);
+    },
+    releasePressedKeys: function releasePressedKeys() {
+      return modifierKeysObserver.releaseAll();
     }
   };
 }