handsontable 14.2.0 → 14.3.0-next-3fa6b18-20240410

package/plugins/mergeCells/mergeCells.js

@@ -1,8 +1,8 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.array.push.js");
 var _base = require("../base");
 var _pluginHooks = _interopRequireDefault(require("../../pluginHooks"));
 var _cellsCollection = _interopRequireDefault(require("./cellsCollection"));
@@ -17,19 +17,17 @@ var _number = require("../../helpers/number");
 var _utils = require("./utils");
 var _element = require("../../helpers/dom/element");
 var _browser = require("../../helpers/browser");
+var _focusOrder2 = require("./focusOrder");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
 function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
 function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function _classPrivateFieldSet(receiver, privateMap, value) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
-function _classApplyDescriptorSet(receiver, descriptor, value) { if (descriptor.set) { descriptor.set.call(receiver, value); } else { if (!descriptor.writable) { throw new TypeError("attempted to set read only private field"); } descriptor.value = value; } }
-function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
-function _classExtractFieldDescriptor(receiver, privateMap, action) { if (!privateMap.has(receiver)) { throw new TypeError("attempted to " + action + " private field on non-instance"); } return privateMap.get(receiver); }
-function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
-function _classPrivateMethodGet(receiver, privateSet, fn) { if (!privateSet.has(receiver)) { throw new TypeError("attempted to get private field on non-instance"); } return fn; }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
+function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
+function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 _pluginHooks.default.getSingleton().register('beforeMergeCells');
 _pluginHooks.default.getSingleton().register('afterMergeCells');
 _pluginHooks.default.getSingleton().register('beforeUnmergeCells');
@@ -75,207 +73,17 @@ const SHORTCUTS_GROUP = PLUGIN_KEY;
  * ```
  * :::
  */
-var _lastDesiredCoords = /*#__PURE__*/new WeakMap();
-var _onAfterInit = /*#__PURE__*/new WeakSet();
-var _onAfterIsMultipleSelection = /*#__PURE__*/new WeakSet();
-var _onModifyTransformStart = /*#__PURE__*/new WeakSet();
-var _onModifyTransformEnd = /*#__PURE__*/new WeakSet();
-var _onModifyGetCellCoords = /*#__PURE__*/new WeakSet();
-var _addMergeActionsToContextMenu = /*#__PURE__*/new WeakSet();
-var _onAfterRenderer = /*#__PURE__*/new WeakSet();
-var _onBeforeSetRangeStart = /*#__PURE__*/new WeakSet();
-var _onBeforeSetRangeEnd = /*#__PURE__*/new WeakSet();
-var _onAfterGetCellMeta = /*#__PURE__*/new WeakSet();
-var _onAfterViewportRowCalculatorOverride = /*#__PURE__*/new WeakSet();
-var _onAfterViewportColumnCalculatorOverride = /*#__PURE__*/new WeakSet();
-var _onModifyAutofillRange = /*#__PURE__*/new WeakSet();
-var _onAfterCreateCol = /*#__PURE__*/new WeakSet();
-var _onAfterRemoveCol = /*#__PURE__*/new WeakSet();
-var _onAfterCreateRow = /*#__PURE__*/new WeakSet();
-var _onAfterRemoveRow = /*#__PURE__*/new WeakSet();
-var _onAfterChange = /*#__PURE__*/new WeakSet();
-var _onBeforeDrawAreaBorders = /*#__PURE__*/new WeakSet();
-var _onAfterModifyTransformStart = /*#__PURE__*/new WeakSet();
-var _onAfterDrawSelection = /*#__PURE__*/new WeakSet();
-var _onBeforeRemoveCellClassNames = /*#__PURE__*/new WeakSet();
-var _onBeforeBeginEditing = /*#__PURE__*/new WeakSet();
+var _lastSelectedFocus = /*#__PURE__*/new WeakMap();
+var _lastFocusDelta = /*#__PURE__*/new WeakMap();
+var _focusOrder = /*#__PURE__*/new WeakMap();
+var _MergeCells_brand = /*#__PURE__*/new WeakSet();
 class MergeCells extends _base.BasePlugin {
   constructor() {
     super(...arguments);
-    /**
-     * Allows to prevent opening the editor while more than one merged cell is selected.
-     *
-     * @param {number} row Visual row index of the edited cell.
-     * @param {number} column Visual column index of the edited cell.
-     * @param {string | null} initialValue The initial editor value.
-     * @param {MouseEvent | KeyboardEvent} event The event which was responsible for opening the editor.
-     * @returns {boolean | undefined}
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeBeginEditing);
-    /**
-     * `beforeRemoveCellClassNames` hook callback. Used to remove additional class name from all 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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeRemoveCellClassNames);
-    /**
-     * `afterDrawSelection` hook callback. Used to add the additional class name for the entirely-selected merged cells.
-     *
-     * @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 {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.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterDrawSelection);
-    /**
-     * `afterModifyTransformStart` hook callback. Fixes a problem with navigating through merged cells at the edges of
-     * the table with the <kbd>**Enter**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Enter**</kbd>/<kbd>**Tab**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Tab**</kbd> keys.
-     *
-     * @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).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterModifyTransformStart);
-    /**
-     * `beforeDrawAreaBorders` hook callback.
-     *
-     * @param {Array} corners Visual coordinates of the area corners.
-     * @param {string} className Class name for the area.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeDrawAreaBorders);
-    /**
-     * `afterChange` hook callback. Used to propagate merged cells after using Autofill.
-     *
-     * @param {Array} changes The changes array.
-     * @param {string} source Determines the source of the change.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterChange);
-    /**
-     * `afterRemoveRow` hook callback.
-     *
-     * @param {number} row Row index.
-     * @param {number} count Number of removed rows.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterRemoveRow);
-    /**
-     * `afterCreateRow` hook callback.
-     *
-     * @param {number} row Row index.
-     * @param {number} count Number of created rows.
-     * @param {string} source Source of change.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterCreateRow);
-    /**
-     * `afterRemoveCol` hook callback.
-     *
-     * @param {number} column Column index.
-     * @param {number} count Number of removed columns.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterRemoveCol);
-    /**
-     * `afterCreateCol` hook callback.
-     *
-     * @param {number} column Column index.
-     * @param {number} count Number of created columns.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterCreateCol);
-    /**
-     * The `modifyAutofillRange` hook callback.
-     *
-     * @param {Array} drag The drag area coordinates.
-     * @param {Array} select The selection information.
-     * @returns {Array} The new drag area.
-     */
-    _classPrivateMethodInitSpec(this, _onModifyAutofillRange);
-    /**
-     * `afterViewportColumnCalculatorOverride` hook callback.
-     *
-     * @param {object} calc The column calculator object.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterViewportColumnCalculatorOverride);
-    /**
-     * `afterViewportRowCalculatorOverride` hook callback.
-     *
-     * @param {object} calc The row calculator object.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterViewportRowCalculatorOverride);
-    /**
-     * The `afterGetCellMeta` hook callback.
-     *
-     * @param {number} row Row index.
-     * @param {number} col Column index.
-     * @param {object} cellProperties The cell properties object.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterGetCellMeta);
-    /**
-     * `beforeSetRangeEnd` hook callback.
-     * 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.
-     *
-     * @param {object} coords Cell coords.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeSetRangeEnd);
-    /**
-     * `beforeSetRangeStart` and `beforeSetRangeStartOnly` hook callback.
-     * A selection within merge area should be rewritten to the start of merge area.
-     *
-     * @param {object} coords Cell coords.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeSetRangeStart);
-    /**
-     * `afterRenderer` hook callback.
-     *
-     * @param {HTMLElement} TD The cell to be modified.
-     * @param {number} row Row index.
-     * @param {number} col Visual column index.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterRenderer);
-    /**
-     * `afterContextMenuDefaultOptions` hook callback.
-     *
-     * @param {object} defaultOptions The default context menu options.
-     */
-    _classPrivateMethodInitSpec(this, _addMergeActionsToContextMenu);
-    /**
-     * `modifyGetCellCoords` hook callback. Swaps the `getCell` coords with the merged parent coords.
-     *
-     * @param {number} row Row index.
-     * @param {number} column Visual column index.
-     * @returns {Array|undefined} Visual coordinates of the merge.
-     */
-    _classPrivateMethodInitSpec(this, _onModifyGetCellCoords);
-    /**
-     * `modifyTransformEnd` hook callback. Needed to handle "jumping over" merged merged cells, while selecting.
-     *
-     * @param {object} delta The transformation delta.
-     */
-    _classPrivateMethodInitSpec(this, _onModifyTransformEnd);
-    /**
-     * `modifyTransformStart` hook callback.
-     *
-     * @param {object} delta The transformation delta.
-     */
-    _classPrivateMethodInitSpec(this, _onModifyTransformStart);
-    /**
-     * Modifies the information on whether the current selection contains multiple cells. The `afterIsMultipleSelection`
-     * hook callback.
-     *
-     * @param {boolean} isMultiple Determines whether the current selection contains multiple cells.
-     * @returns {boolean}
-     */
-    _classPrivateMethodInitSpec(this, _onAfterIsMultipleSelection);
     /**
      * `afterInit` hook callback.
      */
-    _classPrivateMethodInitSpec(this, _onAfterInit);
+    _classPrivateMethodInitSpec(this, _MergeCells_brand);
     /**
      * A container for all the merged cells.
      *
@@ -298,12 +106,32 @@ class MergeCells extends _base.BasePlugin {
      */
     _defineProperty(this, "selectionCalculations", null);
     /**
+     * The holder for the last selected focus coordinates. This allows keeping the correct coordinates in cases after the
+     * focus is moved out of the merged cell.
+     *
      * @type {CellCoords}
      */
-    _classPrivateFieldInitSpec(this, _lastDesiredCoords, {
-      writable: true,
-      value: null
+    _classPrivateFieldInitSpec(this, _lastSelectedFocus, null);
+    /**
+     * The last used transformation delta.
+     *
+     * @type {{ row: number, col: number }}
+     */
+    _classPrivateFieldInitSpec(this, _lastFocusDelta, {
+      row: 0,
+      col: 0
     });
+    /**
+     * The module responsible for providing the correct focus order (vertical and horizontal) within a selection that
+     * contains merged cells.
+     *
+     * @type {FocusOrder}
+     */
+    _classPrivateFieldInitSpec(this, _focusOrder, new _focusOrder2.FocusOrder({
+      mergedCellsGetter: (row, column) => this.mergedCellsCollection.get(row, column),
+      rowIndexMapper: this.hot.rowIndexMapper,
+      columnIndexMapper: this.hot.columnIndexMapper
+    }));
   }
   static get PLUGIN_KEY() {
     return PLUGIN_KEY;
@@ -336,145 +164,163 @@ class MergeCells extends _base.BasePlugin {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
         args[_key] = arguments[_key];
       }
-      return _classPrivateMethodGet(_this, _onAfterInit, _onAfterInit2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterInit).call(_this, ...args);
     });
-    this.addHook('modifyTransformStart', function () {
+    this.addHook('modifyTransformFocus', function () {
       for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
         args[_key2] = arguments[_key2];
       }
-      return _classPrivateMethodGet(_this, _onModifyTransformStart, _onModifyTransformStart2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onModifyTransformFocus).call(_this, ...args);
     });
-    this.addHook('afterModifyTransformStart', function () {
+    this.addHook('modifyTransformStart', function () {
       for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
         args[_key3] = arguments[_key3];
       }
-      return _classPrivateMethodGet(_this, _onAfterModifyTransformStart, _onAfterModifyTransformStart2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onModifyTransformStart).call(_this, ...args);
     });
     this.addHook('modifyTransformEnd', function () {
       for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
         args[_key4] = arguments[_key4];
       }
-      return _classPrivateMethodGet(_this, _onModifyTransformEnd, _onModifyTransformEnd2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onModifyTransformEnd).call(_this, ...args);
     });
-    this.addHook('modifyGetCellCoords', function () {
+    this.addHook('beforeSelectionHighlightSet', function () {
       for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
         args[_key5] = arguments[_key5];
       }
-      return _classPrivateMethodGet(_this, _onModifyGetCellCoords, _onModifyGetCellCoords2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeSelectionHighlightSet).call(_this, ...args);
     });
     this.addHook('beforeSetRangeStart', function () {
       for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
         args[_key6] = arguments[_key6];
       }
-      return _classPrivateMethodGet(_this, _onBeforeSetRangeStart, _onBeforeSetRangeStart2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeSetRangeStart).call(_this, ...args);
     });
     this.addHook('beforeSetRangeStartOnly', function () {
       for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
         args[_key7] = arguments[_key7];
       }
-      return _classPrivateMethodGet(_this, _onBeforeSetRangeStart, _onBeforeSetRangeStart2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeSetRangeStart).call(_this, ...args);
     });
-    this.addHook('beforeSetRangeEnd', function () {
+    this.addHook('beforeSelectionFocusSet', function () {
       for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
         args[_key8] = arguments[_key8];
       }
-      return _classPrivateMethodGet(_this, _onBeforeSetRangeEnd, _onBeforeSetRangeEnd2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeSelectionFocusSet).call(_this, ...args);
     });
-    this.addHook('afterIsMultipleSelection', function () {
+    this.addHook('afterSelectionFocusSet', function () {
       for (var _len9 = arguments.length, args = new Array(_len9), _key9 = 0; _key9 < _len9; _key9++) {
         args[_key9] = arguments[_key9];
       }
-      return _classPrivateMethodGet(_this, _onAfterIsMultipleSelection, _onAfterIsMultipleSelection2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterSelectionFocusSet).call(_this, ...args);
     });
-    this.addHook('afterRenderer', function () {
+    this.addHook('afterSelectionEnd', function () {
       for (var _len10 = arguments.length, args = new Array(_len10), _key10 = 0; _key10 < _len10; _key10++) {
         args[_key10] = arguments[_key10];
       }
-      return _classPrivateMethodGet(_this, _onAfterRenderer, _onAfterRenderer2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterSelectionEnd).call(_this, ...args);
     });
-    this.addHook('afterContextMenuDefaultOptions', function () {
+    this.addHook('modifyGetCellCoords', function () {
       for (var _len11 = arguments.length, args = new Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
         args[_key11] = arguments[_key11];
       }
-      return _classPrivateMethodGet(_this, _addMergeActionsToContextMenu, _addMergeActionsToContextMenu2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onModifyGetCellCoords).call(_this, ...args);
     });
-    this.addHook('afterGetCellMeta', function () {
+    this.addHook('afterIsMultipleSelection', function () {
       for (var _len12 = arguments.length, args = new Array(_len12), _key12 = 0; _key12 < _len12; _key12++) {
         args[_key12] = arguments[_key12];
       }
-      return _classPrivateMethodGet(_this, _onAfterGetCellMeta, _onAfterGetCellMeta2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterIsMultipleSelection).call(_this, ...args);
     });
-    this.addHook('afterViewportRowCalculatorOverride', function () {
+    this.addHook('afterRenderer', function () {
       for (var _len13 = arguments.length, args = new Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
         args[_key13] = arguments[_key13];
       }
-      return _classPrivateMethodGet(_this, _onAfterViewportRowCalculatorOverride, _onAfterViewportRowCalculatorOverride2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterRenderer).call(_this, ...args);
     });
-    this.addHook('afterViewportColumnCalculatorOverride', function () {
+    this.addHook('afterContextMenuDefaultOptions', function () {
       for (var _len14 = arguments.length, args = new Array(_len14), _key14 = 0; _key14 < _len14; _key14++) {
         args[_key14] = arguments[_key14];
       }
-      return _classPrivateMethodGet(_this, _onAfterViewportColumnCalculatorOverride, _onAfterViewportColumnCalculatorOverride2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _addMergeActionsToContextMenu).call(_this, ...args);
     });
-    this.addHook('modifyAutofillRange', function () {
+    this.addHook('afterGetCellMeta', function () {
       for (var _len15 = arguments.length, args = new Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
         args[_key15] = arguments[_key15];
       }
-      return _classPrivateMethodGet(_this, _onModifyAutofillRange, _onModifyAutofillRange2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterGetCellMeta).call(_this, ...args);
     });
-    this.addHook('afterCreateCol', function () {
+    this.addHook('afterViewportRowCalculatorOverride', function () {
       for (var _len16 = arguments.length, args = new Array(_len16), _key16 = 0; _key16 < _len16; _key16++) {
         args[_key16] = arguments[_key16];
       }
-      return _classPrivateMethodGet(_this, _onAfterCreateCol, _onAfterCreateCol2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterViewportRowCalculatorOverride).call(_this, ...args);
     });
-    this.addHook('afterRemoveCol', function () {
+    this.addHook('afterViewportColumnCalculatorOverride', function () {
       for (var _len17 = arguments.length, args = new Array(_len17), _key17 = 0; _key17 < _len17; _key17++) {
         args[_key17] = arguments[_key17];
       }
-      return _classPrivateMethodGet(_this, _onAfterRemoveCol, _onAfterRemoveCol2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterViewportColumnCalculatorOverride).call(_this, ...args);
     });
-    this.addHook('afterCreateRow', function () {
+    this.addHook('modifyAutofillRange', function () {
       for (var _len18 = arguments.length, args = new Array(_len18), _key18 = 0; _key18 < _len18; _key18++) {
         args[_key18] = arguments[_key18];
       }
-      return _classPrivateMethodGet(_this, _onAfterCreateRow, _onAfterCreateRow2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onModifyAutofillRange).call(_this, ...args);
     });
-    this.addHook('afterRemoveRow', function () {
+    this.addHook('afterCreateCol', function () {
       for (var _len19 = arguments.length, args = new Array(_len19), _key19 = 0; _key19 < _len19; _key19++) {
         args[_key19] = arguments[_key19];
       }
-      return _classPrivateMethodGet(_this, _onAfterRemoveRow, _onAfterRemoveRow2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterCreateCol).call(_this, ...args);
     });
-    this.addHook('afterChange', function () {
+    this.addHook('afterRemoveCol', function () {
       for (var _len20 = arguments.length, args = new Array(_len20), _key20 = 0; _key20 < _len20; _key20++) {
         args[_key20] = arguments[_key20];
       }
-      return _classPrivateMethodGet(_this, _onAfterChange, _onAfterChange2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterRemoveCol).call(_this, ...args);
     });
-    this.addHook('beforeDrawBorders', function () {
+    this.addHook('afterCreateRow', function () {
       for (var _len21 = arguments.length, args = new Array(_len21), _key21 = 0; _key21 < _len21; _key21++) {
         args[_key21] = arguments[_key21];
       }
-      return _classPrivateMethodGet(_this, _onBeforeDrawAreaBorders, _onBeforeDrawAreaBorders2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterCreateRow).call(_this, ...args);
     });
-    this.addHook('afterDrawSelection', function () {
+    this.addHook('afterRemoveRow', function () {
       for (var _len22 = arguments.length, args = new Array(_len22), _key22 = 0; _key22 < _len22; _key22++) {
         args[_key22] = arguments[_key22];
       }
-      return _classPrivateMethodGet(_this, _onAfterDrawSelection, _onAfterDrawSelection2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterRemoveRow).call(_this, ...args);
     });
-    this.addHook('beforeRemoveCellClassNames', function () {
+    this.addHook('afterChange', function () {
       for (var _len23 = arguments.length, args = new Array(_len23), _key23 = 0; _key23 < _len23; _key23++) {
         args[_key23] = arguments[_key23];
       }
-      return _classPrivateMethodGet(_this, _onBeforeRemoveCellClassNames, _onBeforeRemoveCellClassNames2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterChange).call(_this, ...args);
     });
-    this.addHook('beforeBeginEditing', function () {
+    this.addHook('beforeDrawBorders', function () {
       for (var _len24 = arguments.length, args = new Array(_len24), _key24 = 0; _key24 < _len24; _key24++) {
         args[_key24] = arguments[_key24];
       }
-      return _classPrivateMethodGet(_this, _onBeforeBeginEditing, _onBeforeBeginEditing2).call(_this, ...args);
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeDrawAreaBorders).call(_this, ...args);
+    });
+    this.addHook('afterDrawSelection', function () {
+      for (var _len25 = arguments.length, args = new Array(_len25), _key25 = 0; _key25 < _len25; _key25++) {
+        args[_key25] = arguments[_key25];
+      }
+      return _assertClassBrand(_MergeCells_brand, _this, _onAfterDrawSelection).call(_this, ...args);
+    });
+    this.addHook('beforeRemoveCellClassNames', function () {
+      for (var _len26 = arguments.length, args = new Array(_len26), _key26 = 0; _key26 < _len26; _key26++) {
+        args[_key26] = arguments[_key26];
+      }
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeRemoveCellClassNames).call(_this, ...args);
+    });
+    this.addHook('beforeBeginEditing', function () {
+      for (var _len27 = arguments.length, args = new Array(_len27), _key27 = 0; _key27 < _len27; _key27++) {
+        args[_key27] = arguments[_key27];
+      }
+      return _assertClassBrand(_MergeCells_brand, _this, _onBeforeBeginEditing).call(_this, ...args);
     });
     this.addHook('beforeUndoStackChange', (action, source) => {
       if (source === 'MergeCells') {
@@ -618,7 +464,9 @@ class MergeCells extends _base.BasePlugin {
       if (populatedNulls.length === 0) {
         return;
       }
-      this.hot.setDataAtCell(populatedNulls);
+
+      // TODO: Change the `source` argument to a more meaningful value, e.g. `${this.pluginName}.clearCells`.
+      this.hot.setDataAtCell(populatedNulls, undefined, undefined, this.pluginName);
     }
   }
 
@@ -642,25 +490,6 @@ class MergeCells extends _base.BasePlugin {
     return auto ? true : this.validateSetting(newMergedCellInfo);
   }
 
-  /**
-   * Merge or unmerge, based on last selected range.
-   *
-   * @private
-   */
-  toggleMergeOnSelection() {
-    const currentRange = this.hot.getSelectedRangeLast();
-    if (!currentRange) {
-      return;
-    }
-    currentRange.setDirection(this.hot.isRtl() ? 'NE-SW' : 'NW-SE');
-    const {
-      from,
-      to
-    } = currentRange;
-    this.toggleMerge(currentRange);
-    this.hot.selectCell(from.row, from.col, to.row, to.col, false);
-  }
-
   /**
    * Merges the selection provided as a cell range.
    *
@@ -749,6 +578,7 @@ class MergeCells extends _base.BasePlugin {
       if (preventPopulation) {
         populationInfo = [mergeParent.row, mergeParent.col, clearedData];
       } else {
+        // TODO: Change the `source` argument to a more meaningful value, e.g. `${this.pluginName}.clearCells`.
         this.hot.populateFromArray(mergeParent.row, mergeParent.col, clearedData, undefined, undefined, this.pluginName);
       }
       if (!auto) {
@@ -871,6 +701,15 @@ class MergeCells extends _base.BasePlugin {
     const gridContext = shortcutManager.getContext('grid');
     gridContext.removeShortcutsByGroup(SHORTCUTS_GROUP);
   }
+
+  /**
+   * Modifies the information on whether the current selection contains multiple cells. The `afterIsMultipleSelection`
+   * hook callback.
+   *
+   * @param {boolean} isMultiple Determines whether the current selection contains multiple cells.
+   * @returns {boolean}
+   */
+
   /**
    * Modify viewport start when needed. We extend viewport when merged cells aren't fully visible.
    *
@@ -927,6 +766,13 @@ class MergeCells extends _base.BasePlugin {
       }
     }
   }
+
+  /**
+   * `afterViewportColumnCalculatorOverride` hook callback.
+   *
+   * @param {object} calc The column calculator object.
+   */
+
   /**
    * Modify viewport start when needed. We extend viewport when merged cells aren't fully visible.
    *
@@ -1021,96 +867,218 @@ class MergeCells extends _base.BasePlugin {
     const renderableColumn = parentColumn >= 0 ? columnMapper.getRenderableFromVisualIndex(firstNonHiddenColumn) : parentColumn;
     return [renderableRow, renderableColumn];
   }
+
+  /**
+   * The `modifyAutofillRange` hook callback.
+   *
+   * @param {Array} drag The drag area coordinates.
+   * @param {Array} select The selection information.
+   * @returns {Array} The new drag area.
+   */
 }
 exports.MergeCells = MergeCells;
-function _onAfterInit2() {
+function _onAfterInit() {
   this.generateFromSettings(this.hot.getSettings()[PLUGIN_KEY]);
   this.hot.render();
 }
-function _onAfterIsMultipleSelection2(isMultiple) {
+function _onAfterIsMultipleSelection(isMultiple) {
   if (isMultiple) {
     const mergedCells = this.mergedCellsCollection.mergedCells;
     const selectionRange = this.hot.getSelectedRangeLast();
+    const topStartCoords = selectionRange.getTopStartCorner();
+    const bottomEndCoords = selectionRange.getBottomEndCorner();
     for (let group = 0; group < mergedCells.length; group += 1) {
-      if (selectionRange.from.row === mergedCells[group].row && selectionRange.from.col === mergedCells[group].col && selectionRange.to.row === mergedCells[group].row + mergedCells[group].rowspan - 1 && selectionRange.to.col === mergedCells[group].col + mergedCells[group].colspan - 1) {
+      if (topStartCoords.row === mergedCells[group].row && topStartCoords.col === mergedCells[group].col && bottomEndCoords.row === mergedCells[group].row + mergedCells[group].rowspan - 1 && bottomEndCoords.col === mergedCells[group].col + mergedCells[group].colspan - 1) {
         return false;
       }
     }
   }
   return isMultiple;
 }
-function _onModifyTransformStart2(delta) {
-  const currentlySelectedRange = this.hot.getSelectedRangeLast();
-  let newDelta = {
-    row: delta.row,
-    col: delta.col
+/**
+ * `modifyTransformFocus` hook callback.
+ *
+ * @param {object} delta The transformation delta.
+ */
+function _onModifyTransformFocus(delta) {
+  _classPrivateFieldGet(_lastFocusDelta, this).row = delta.row;
+  _classPrivateFieldGet(_lastFocusDelta, this).col = delta.col;
+}
+/**
+ * `modifyTransformStart` hook callback.
+ *
+ * @param {object} delta The transformation delta.
+ */
+function _onModifyTransformStart(delta) {
+  const selectedRange = this.hot.getSelectedRangeLast();
+  const {
+    highlight
+  } = selectedRange;
+  const {
+    columnIndexMapper,
+    rowIndexMapper
+  } = this.hot;
+  if (_classPrivateFieldGet(_lastSelectedFocus, this)) {
+    if (rowIndexMapper.getRenderableFromVisualIndex(_classPrivateFieldGet(_lastSelectedFocus, this).row) !== null) {
+      highlight.row = _classPrivateFieldGet(_lastSelectedFocus, this).row;
+    }
+    if (columnIndexMapper.getRenderableFromVisualIndex(_classPrivateFieldGet(_lastSelectedFocus, this).col) !== null) {
+      highlight.col = _classPrivateFieldGet(_lastSelectedFocus, this).col;
+    }
+    _classPrivateFieldSet(_lastSelectedFocus, this, null);
+  }
+  const mergedParent = this.mergedCellsCollection.get(highlight.row, highlight.col);
+  if (!mergedParent) {
+    return;
+  }
+  const visualColumnIndexStart = mergedParent.col;
+  const visualColumnIndexEnd = mergedParent.col + mergedParent.colspan - 1;
+  if (delta.col < 0) {
+    const nextColumn = highlight.col >= visualColumnIndexStart && highlight.col <= visualColumnIndexEnd ? visualColumnIndexStart - 1 : visualColumnIndexEnd;
+    const notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(nextColumn, -1);
+    if (notHiddenColumnIndex === null) {
+      // There are no visible columns anymore, so move the selection out of the table edge. This will
+      // be processed by the selection Transformer class as a move selection to the previous row (if autoWrapRow is enabled).
+      delta.col = -this.hot.view.countRenderableColumnsInRange(0, highlight.col);
+    } else {
+      delta.col = -Math.max(this.hot.view.countRenderableColumnsInRange(notHiddenColumnIndex, highlight.col) - 1, 1);
+    }
+  } else if (delta.col > 0) {
+    const nextColumn = highlight.col >= visualColumnIndexStart && highlight.col <= visualColumnIndexEnd ? visualColumnIndexEnd + 1 : visualColumnIndexStart;
+    const notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(nextColumn, 1);
+    if (notHiddenColumnIndex === null) {
+      // There are no visible columns anymore, so move the selection out of the table edge. This will
+      // be processed by the selection Transformer class as a move selection to the next row (if autoWrapRow is enabled).
+      delta.col = this.hot.view.countRenderableColumnsInRange(highlight.col, this.hot.countCols());
+    } else {
+      delta.col = Math.max(this.hot.view.countRenderableColumnsInRange(highlight.col, notHiddenColumnIndex) - 1, 1);
+    }
+  }
+  const visualRowIndexStart = mergedParent.row;
+  const visualRowIndexEnd = mergedParent.row + mergedParent.rowspan - 1;
+  if (delta.row < 0) {
+    const nextRow = highlight.row >= visualRowIndexStart && highlight.row <= visualRowIndexEnd ? visualRowIndexStart - 1 : visualRowIndexEnd;
+    const notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(nextRow, -1);
+    if (notHiddenRowIndex === null) {
+      // There are no visible rows anymore, so move the selection out of the table edge. This will
+      // be processed by the selection Transformer class as a move selection to the previous column (if autoWrapCol is enabled).
+      delta.row = -this.hot.view.countRenderableRowsInRange(0, highlight.row);
+    } else {
+      delta.row = -Math.max(this.hot.view.countRenderableRowsInRange(notHiddenRowIndex, highlight.row) - 1, 1);
+    }
+  } else if (delta.row > 0) {
+    const nextRow = highlight.row >= visualRowIndexStart && highlight.row <= visualRowIndexEnd ? visualRowIndexEnd + 1 : visualRowIndexStart;
+    const notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(nextRow, 1);
+    if (notHiddenRowIndex === null) {
+      // There are no visible rows anymore, so move the selection out of the table edge. This will
+      // be processed by the selection Transformer class as a move selection to the next column (if autoWrapCol is enabled).
+      delta.row = this.hot.view.countRenderableRowsInRange(highlight.row, this.hot.countRows());
+    } else {
+      delta.row = Math.max(this.hot.view.countRenderableRowsInRange(highlight.row, notHiddenRowIndex) - 1, 1);
+    }
+  }
+}
+/**
+ * The hook allows to modify the delta transformation object necessary for correct selection end transformations.
+ * The logic here handles "jumping over" merged merged cells, while selecting.
+ *
+ * @param {{ row: number, col: number }} delta The transformation delta.
+ */
+function _onModifyTransformEnd(delta) {
+  const selectedRange = this.hot.getSelectedRangeLast();
+  const cloneRange = selectedRange.clone();
+  const {
+    to
+  } = selectedRange;
+  const {
+    columnIndexMapper,
+    rowIndexMapper
+  } = this.hot;
+  const expandCloneRange = (row, col) => {
+    cloneRange.expand(this.hot._createCellCoords(row, col));
+    for (let i = 0; i < this.mergedCellsCollection.mergedCells.length; i += 1) {
+      cloneRange.expandByRange(this.mergedCellsCollection.mergedCells[i].getRange());
+    }
   };
-  let nextPosition = null;
-  const currentPosition = this.hot._createCellCoords(currentlySelectedRange.highlight.row, currentlySelectedRange.highlight.col);
-  const mergedParent = this.mergedCellsCollection.get(currentPosition.row, currentPosition.col);
-  if (!_classPrivateFieldGet(this, _lastDesiredCoords)) {
-    _classPrivateFieldSet(this, _lastDesiredCoords, this.hot._createCellCoords(null, null));
+  if (delta.col < 0) {
+    let nextColumn = this.mergedCellsCollection.getStartMostColumnIndex(selectedRange, to.col) + delta.col;
+    expandCloneRange(to.row, nextColumn);
+    if (selectedRange.getHorizontalDirection() === 'E-W' && cloneRange.getHorizontalDirection() === 'E-W') {
+      nextColumn = cloneRange.getTopStartCorner().col;
+    }
+    const notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(nextColumn, 1);
+    if (notHiddenColumnIndex !== null) {
+      delta.col = -Math.max(this.hot.view.countRenderableColumnsInRange(notHiddenColumnIndex, to.col) - 1, 1);
+    }
+  } else if (delta.col > 0) {
+    let nextColumn = this.mergedCellsCollection.getEndMostColumnIndex(selectedRange, to.col) + delta.col;
+    expandCloneRange(to.row, nextColumn);
+    if (selectedRange.getHorizontalDirection() === 'W-E' && cloneRange.getHorizontalDirection() === 'W-E') {
+      nextColumn = cloneRange.getBottomEndCorner().col;
+    }
+    const notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(nextColumn, -1);
+    if (notHiddenColumnIndex !== null) {
+      delta.col = Math.max(this.hot.view.countRenderableColumnsInRange(to.col, notHiddenColumnIndex) - 1, 1);
+    }
   }
-  if (mergedParent) {
-    // only merge selected
-    const mergeTopLeft = this.hot._createCellCoords(mergedParent.row, mergedParent.col);
-    const mergeBottomRight = this.hot._createCellCoords(mergedParent.row + mergedParent.rowspan - 1, mergedParent.col + mergedParent.colspan - 1);
-    const mergeRange = this.hot._createCellRange(mergeTopLeft, mergeTopLeft, mergeBottomRight);
-    if (!mergeRange.includes(_classPrivateFieldGet(this, _lastDesiredCoords))) {
-      _classPrivateFieldSet(this, _lastDesiredCoords, this.hot._createCellCoords(null, null)); // reset outdated version of lastDesiredCoords
+  if (delta.row < 0) {
+    let nextRow = this.mergedCellsCollection.getTopMostRowIndex(selectedRange, to.row) + delta.row;
+    expandCloneRange(nextRow, to.col);
+    if (selectedRange.getVerticalDirection() === 'S-N' && cloneRange.getVerticalDirection() === 'S-N') {
+      nextRow = cloneRange.getTopStartCorner().row;
     }
-    newDelta.row = _classPrivateFieldGet(this, _lastDesiredCoords).row ? _classPrivateFieldGet(this, _lastDesiredCoords).row - currentPosition.row : newDelta.row;
-    newDelta.col = _classPrivateFieldGet(this, _lastDesiredCoords).col ? _classPrivateFieldGet(this, _lastDesiredCoords).col - currentPosition.col : newDelta.col;
-    if (delta.row > 0) {
-      // moving down
-      newDelta.row = mergedParent.row + mergedParent.rowspan - 1 - currentPosition.row + delta.row;
-    } else if (delta.row < 0) {
-      // moving up
-      newDelta.row = currentPosition.row - mergedParent.row + delta.row;
+    const notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(nextRow, 1);
+    if (notHiddenRowIndex !== null) {
+      delta.row = -Math.max(this.hot.view.countRenderableRowsInRange(notHiddenRowIndex, to.row) - 1, 1);
     }
-    if (delta.col > 0) {
-      // moving right
-      newDelta.col = mergedParent.col + mergedParent.colspan - 1 - currentPosition.col + delta.col;
-    } else if (delta.col < 0) {
-      // moving left
-      newDelta.col = currentPosition.col - mergedParent.col + delta.col;
+  } else if (delta.row > 0) {
+    let nextRow = this.mergedCellsCollection.getBottomMostRowIndex(selectedRange, to.row) + delta.row;
+    expandCloneRange(nextRow, to.col);
+    if (selectedRange.getVerticalDirection() === 'N-S' && cloneRange.getVerticalDirection() === 'N-S') {
+      nextRow = cloneRange.getBottomStartCorner().row;
+    }
+    const notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(nextRow, -1);
+    if (notHiddenRowIndex !== null) {
+      delta.row = Math.max(this.hot.view.countRenderableRowsInRange(to.row, notHiddenRowIndex) - 1, 1);
     }
   }
-  nextPosition = this.hot._createCellCoords(currentlySelectedRange.highlight.row + newDelta.row, currentlySelectedRange.highlight.col + newDelta.col);
-  const nextPositionMergedCell = this.mergedCellsCollection.get(nextPosition.row, nextPosition.col);
-  if (nextPositionMergedCell) {
-    // skipping the invisible cells in the merge range
-    const firstRenderableCoords = this.mergedCellsCollection.getFirstRenderableCoords(nextPositionMergedCell.row, nextPositionMergedCell.col);
-    _classPrivateFieldSet(this, _lastDesiredCoords, nextPosition);
-    newDelta = {
-      row: firstRenderableCoords.row - currentPosition.row,
-      col: firstRenderableCoords.col - currentPosition.col
-    };
+}
+/**
+ * The hook corrects the range (before drawing it) after the selection was made on the merged cells.
+ * It expands the range to cover the entire area of the selected merged cells.
+ */
+function _onBeforeSelectionHighlightSet() {
+  const selectedRange = this.hot.getSelectedRangeLast();
+  const {
+    highlight
+  } = selectedRange;
+  if (this.hot.selection.isSelectedByColumnHeader() || this.hot.selection.isSelectedByRowHeader()) {
+    _classPrivateFieldSet(_lastSelectedFocus, this, highlight.clone());
+    return;
   }
-  if (newDelta.row !== 0) {
-    delta.row = newDelta.row;
+  for (let i = 0; i < this.mergedCellsCollection.mergedCells.length; i += 1) {
+    selectedRange.expandByRange(this.mergedCellsCollection.mergedCells[i].getRange(), false);
   }
-  if (newDelta.col !== 0) {
-    delta.col = newDelta.col;
+  // TODO: This is a workaround for an issue with the selection not being extended properly.
+  // In some cases when the merge cells are defined in random order the selection is not
+  // extended in that way that it covers all overlapped merge cells.
+  for (let i = 0; i < this.mergedCellsCollection.mergedCells.length; i += 1) {
+    selectedRange.expandByRange(this.mergedCellsCollection.mergedCells[i].getRange(), false);
+  }
+  const mergedParent = this.mergedCellsCollection.get(highlight.row, highlight.col);
+  _classPrivateFieldSet(_lastSelectedFocus, this, highlight.clone());
+  if (mergedParent) {
+    highlight.assign(mergedParent);
   }
 }
-function _onModifyTransformEnd2(delta) {
-  const currentSelectionRange = this.hot.getSelectedRangeLast();
-  const newDelta = (0, _object.clone)(delta);
-  const newSelectionRange = this.selectionCalculations.getUpdatedSelectionRange(currentSelectionRange, delta);
-  let tempDelta = (0, _object.clone)(newDelta);
-  const mergedCellsWithinRange = this.mergedCellsCollection.getWithinRange(newSelectionRange, true);
-  do {
-    tempDelta = (0, _object.clone)(newDelta);
-    this.selectionCalculations.getUpdatedSelectionRange(currentSelectionRange, newDelta);
-    (0, _array.arrayEach)(mergedCellsWithinRange, mergedCell => {
-      this.selectionCalculations.snapDelta(newDelta, currentSelectionRange, mergedCell);
-    });
-  } while (newDelta.row !== tempDelta.row || newDelta.col !== tempDelta.col);
-  delta.row = newDelta.row;
-  delta.col = newDelta.col;
-}
-function _onModifyGetCellCoords2(row, column) {
+/**
+ * `modifyGetCellCoords` hook callback. Swaps the `getCell` coords with the merged parent coords.
+ *
+ * @param {number} row Row index.
+ * @param {number} column Visual column index.
+ * @returns {Array|undefined} Visual coordinates of the merge.
+ */
+function _onModifyGetCellCoords(row, column) {
   if (row < 0 || column < 0) {
     return;
   }
@@ -1130,12 +1098,24 @@ function _onModifyGetCellCoords2(row, column) {
   // Most bottom-right merged cell coords.
   mergeRow + rowspan - 1, mergeColumn + colspan - 1];
 }
-function _addMergeActionsToContextMenu2(defaultOptions) {
+/**
+ * `afterContextMenuDefaultOptions` hook callback.
+ *
+ * @param {object} defaultOptions The default context menu options.
+ */
+function _addMergeActionsToContextMenu(defaultOptions) {
   defaultOptions.items.push({
     name: '---------'
   }, (0, _toggleMerge.default)(this));
 }
-function _onAfterRenderer2(TD, row, col) {
+/**
+ * `afterRenderer` hook callback.
+ *
+ * @param {HTMLElement} TD The cell to be modified.
+ * @param {number} row Row index.
+ * @param {number} col Visual column index.
+ */
+function _onAfterRenderer(TD, row, col) {
   const mergedCell = this.mergedCellsCollection.get(row, col);
   // We shouldn't override data in the collection.
   const mergedCellCopy = (0, _object.isObject)(mergedCell) ? (0, _object.clone)(mergedCell) : undefined;
@@ -1167,39 +1147,114 @@ function _onAfterRenderer2(TD, row, col) {
   }
   (0, _utils.applySpanProperties)(TD, mergedCellCopy, row, col);
 }
-function _onBeforeSetRangeStart2(coords) {
-  // TODO: It is a workaround, but probably this hook may be needed. Every selection on the merge area
-  // could set start point of the selection to the start of the merge area. However, logic inside `expandByRange` need
-  // an initial start point. Click on the merge cell when there are some hidden indexes break the logic in some cases.
-  // Please take a look at #7010 for more information. I'm not sure if selection directions are calculated properly
-  // and what was idea for flipping direction inside `expandByRange` method.
-  if (this.mergedCellsCollection.isFirstRenderableMergedCell(coords.row, coords.col)) {
-    const mergeParent = this.mergedCellsCollection.get(coords.row, coords.col);
-    [coords.row, coords.col] = [mergeParent.row, mergeParent.col];
-  }
+/**
+ * Clears the last selected coordinates before setting a new selection range.
+ */
+function _onBeforeSetRangeStart() {
+  _classPrivateFieldSet(_lastSelectedFocus, this, null);
 }
-function _onBeforeSetRangeEnd2(coords) {
-  const selRange = this.hot.getSelectedRangeLast();
-  selRange.highlight = this.hot._createCellCoords(selRange.highlight.row, selRange.highlight.col); // clone in case we will modify its reference
-  selRange.to = coords;
-  let rangeExpanded = false;
-  if (this.hot.selection.isSelectedByColumnHeader() || this.hot.selection.isSelectedByRowHeader()) {
+/**
+ * Detects if the last selected cell was a header cell if so update the order list active node for further
+ * computations.
+ */
+function _onBeforeSelectionFocusSet() {
+  if (_classPrivateFieldGet(_lastSelectedFocus, this).isCell()) {
     return;
   }
-  do {
-    rangeExpanded = false;
-    for (let i = 0; i < this.mergedCellsCollection.mergedCells.length; i += 1) {
-      const cellInfo = this.mergedCellsCollection.mergedCells[i];
-      const mergedCellRange = cellInfo.getRange();
-      if (selRange.expandByRange(mergedCellRange)) {
-        coords.row = selRange.to.row;
-        coords.col = selRange.to.col;
-        rangeExpanded = true;
-      }
+  const selectedRange = this.hot.getSelectedRangeLast();
+  const verticalDir = selectedRange.getVerticalDirection();
+  const horizontalDir = selectedRange.getHorizontalDirection();
+  const focusCoords = _classPrivateFieldGet(_lastSelectedFocus, this).clone().normalize();
+  _classPrivateFieldGet(_focusOrder, this).setActiveNode(focusCoords.row, focusCoords.col);
+  if (_classPrivateFieldGet(_lastFocusDelta, this).row > 0 || _classPrivateFieldGet(_lastFocusDelta, this).col > 0) {
+    _classPrivateFieldGet(_focusOrder, this).setPrevNodeAsActive();
+  } else if (horizontalDir === 'E-W' && _classPrivateFieldGet(_lastFocusDelta, this).col < 0 || verticalDir === 'S-N' && _classPrivateFieldGet(_lastFocusDelta, this).row < 0) {
+    _classPrivateFieldGet(_focusOrder, this).setNextNodeAsActive();
+  }
+}
+/**
+ * Changes the focus selection to the next or previous cell or merged cell position.
+ *
+ * @param {number} row The visual row index.
+ * @param {number} column The visual column index.
+ */
+function _onAfterSelectionFocusSet(row, column) {
+  const selectedRange = this.hot.getSelectedRangeLast();
+  const {
+    columnIndexMapper,
+    rowIndexMapper
+  } = this.hot;
+  let notHiddenRowIndex = null;
+  let notHiddenColumnIndex = null;
+  if (_classPrivateFieldGet(_lastFocusDelta, this).col < 0) {
+    const {
+      rowEnd,
+      colEnd
+    } = _classPrivateFieldGet(_focusOrder, this).getPrevHorizontalNode();
+    notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(colEnd, -1);
+    notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(rowEnd, -1);
+  } else if (_classPrivateFieldGet(_lastFocusDelta, this).col > 0) {
+    const {
+      rowStart,
+      colStart
+    } = _classPrivateFieldGet(_focusOrder, this).getNextHorizontalNode();
+    notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(colStart, 1);
+    notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(rowStart, 1);
+  } else if (_classPrivateFieldGet(_lastFocusDelta, this).row < 0) {
+    const {
+      rowEnd,
+      colEnd
+    } = _classPrivateFieldGet(_focusOrder, this).getPrevVerticalNode();
+    notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(colEnd, -1);
+    notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(rowEnd, -1);
+  } else if (_classPrivateFieldGet(_lastFocusDelta, this).row > 0) {
+    const {
+      rowStart,
+      colStart
+    } = _classPrivateFieldGet(_focusOrder, this).getNextVerticalNode();
+    notHiddenColumnIndex = columnIndexMapper.getNearestNotHiddenIndex(colStart, 1);
+    notHiddenRowIndex = rowIndexMapper.getNearestNotHiddenIndex(rowStart, 1);
+  }
+  if (notHiddenRowIndex !== null || notHiddenColumnIndex !== null) {
+    const coords = this.hot._createCellCoords(notHiddenRowIndex, notHiddenColumnIndex);
+    const mergeParent = this.mergedCellsCollection.get(coords.row, coords.col);
+    const focusHighlight = this.hot.selection.highlight.getFocus();
+    row = coords.row;
+    column = coords.col;
+    if (mergeParent) {
+      selectedRange.highlight.assign({
+        row: this.hot.rowIndexMapper.getNearestNotHiddenIndex(mergeParent.row, 1),
+        col: this.hot.columnIndexMapper.getNearestNotHiddenIndex(mergeParent.col, 1)
+      });
+    } else {
+      selectedRange.highlight.assign(coords);
     }
-  } while (rangeExpanded);
+    focusHighlight.clear();
+    focusHighlight.add(coords).commit();
+  }
+  _classPrivateFieldGet(_focusOrder, this).setActiveNode(row, column);
+  _classPrivateFieldSet(_lastFocusDelta, this, {
+    row: 0,
+    col: 0
+  });
 }
-function _onAfterGetCellMeta2(row, col, cellProperties) {
+/**
+ * Creates the horizontal and vertical cells order matrix (linked lists) for focused cell.
+ */
+function _onAfterSelectionEnd() {
+  const selection = this.hot.getSelectedRangeLast();
+  if (!selection.isHeader()) {
+    _classPrivateFieldGet(_focusOrder, this).buildFocusOrder(this.hot.getSelectedRangeLast());
+  }
+}
+/**
+ * The `afterGetCellMeta` hook callback.
+ *
+ * @param {number} row Row index.
+ * @param {number} col Column index.
+ * @param {object} cellProperties The cell properties object.
+ */
+function _onAfterGetCellMeta(row, col, cellProperties) {
   const mergeParent = this.mergedCellsCollection.get(row, col);
   if (mergeParent) {
     if (mergeParent.row !== row || mergeParent.col !== col) {
@@ -1210,17 +1265,22 @@ function _onAfterGetCellMeta2(row, col, cellProperties) {
     }
   }
 }
-function _onAfterViewportRowCalculatorOverride2(calc) {
+/**
+ * `afterViewportRowCalculatorOverride` hook callback.
+ *
+ * @param {object} calc The row calculator object.
+ */
+function _onAfterViewportRowCalculatorOverride(calc) {
   const nrOfColumns = this.hot.countCols();
   this.modifyViewportRowStart(calc, nrOfColumns);
   this.modifyViewportRowEnd(calc, nrOfColumns);
 }
-function _onAfterViewportColumnCalculatorOverride2(calc) {
+function _onAfterViewportColumnCalculatorOverride(calc) {
   const nrOfRows = this.hot.countRows();
   this.modifyViewportColumnStart(calc, nrOfRows);
   this.modifyViewportColumnEnd(calc, nrOfRows);
 }
-function _onModifyAutofillRange2(drag, select) {
+function _onModifyAutofillRange(drag, select) {
   this.autofillCalculations.correctSelectionAreaSize(select);
   const dragDirection = this.autofillCalculations.getDirection(select, drag);
   let dragArea = drag;
@@ -1244,28 +1304,65 @@ function _onModifyAutofillRange2(drag, select) {
   dragArea = this.autofillCalculations.snapDragArea(select, dragArea, dragDirection, mergedCellsWithinSelectionArea);
   return dragArea;
 }
-function _onAfterCreateCol2(column, count) {
+/**
+ * `afterCreateCol` hook callback.
+ *
+ * @param {number} column Column index.
+ * @param {number} count Number of created columns.
+ */
+function _onAfterCreateCol(column, count) {
   this.mergedCellsCollection.shiftCollections('right', column, count);
 }
-function _onAfterRemoveCol2(column, count) {
+/**
+ * `afterRemoveCol` hook callback.
+ *
+ * @param {number} column Column index.
+ * @param {number} count Number of removed columns.
+ */
+function _onAfterRemoveCol(column, count) {
   this.mergedCellsCollection.shiftCollections('left', column, count);
 }
-function _onAfterCreateRow2(row, count, source) {
+/**
+ * `afterCreateRow` hook callback.
+ *
+ * @param {number} row Row index.
+ * @param {number} count Number of created rows.
+ * @param {string} source Source of change.
+ */
+function _onAfterCreateRow(row, count, source) {
   if (source === 'auto') {
     return;
   }
   this.mergedCellsCollection.shiftCollections('down', row, count);
 }
-function _onAfterRemoveRow2(row, count) {
+/**
+ * `afterRemoveRow` hook callback.
+ *
+ * @param {number} row Row index.
+ * @param {number} count Number of removed rows.
+ */
+function _onAfterRemoveRow(row, count) {
   this.mergedCellsCollection.shiftCollections('up', row, count);
 }
-function _onAfterChange2(changes, source) {
+/**
+ * `afterChange` hook callback. Used to propagate merged cells after using Autofill.
+ *
+ * @param {Array} changes The changes array.
+ * @param {string} source Determines the source of the change.
+ */
+function _onAfterChange(changes, source) {
   if (source !== 'Autofill.fill') {
     return;
   }
   this.autofillCalculations.recreateAfterDataPopulation(changes);
 }
-function _onBeforeDrawAreaBorders2(corners, className) {
+/**
+ * `beforeDrawAreaBorders` hook callback.
+ *
+ * @param {Array} corners Visual coordinates of the area corners.
+ * @param {string} className Class name for the area.
+ */
+function _onBeforeDrawAreaBorders(corners, className) {
   if (className && className === 'area') {
     const selectedRange = this.hot.getSelectedRangeLast();
     const mergedCellsWithinRange = this.mergedCellsCollection.getWithinRange(selectedRange);
@@ -1277,38 +1374,43 @@ function _onBeforeDrawAreaBorders2(corners, className) {
     });
   }
 }
-function _onAfterModifyTransformStart2(coords, rowTransformDir, colTransformDir) {
-  if (!this.enabled) {
-    return;
-  }
-  const mergedCellAtCoords = this.mergedCellsCollection.get(coords.row, coords.col);
-  if (!mergedCellAtCoords) {
-    return;
-  }
-  const goingDown = rowTransformDir > 0;
-  const goingUp = rowTransformDir < 0;
-  const goingLeft = colTransformDir < 0;
-  const goingRight = colTransformDir > 0;
-  const mergedCellOnBottomEdge = mergedCellAtCoords.row + mergedCellAtCoords.rowspan - 1 === this.hot.countRows() - 1;
-  const mergedCellOnTopEdge = mergedCellAtCoords.row === 0;
-  const mergedCellOnRightEdge = mergedCellAtCoords.col + mergedCellAtCoords.colspan - 1 === this.hot.countCols() - 1;
-  const mergedCellOnLeftEdge = mergedCellAtCoords.col === 0;
-  if (goingDown && mergedCellOnBottomEdge || goingUp && mergedCellOnTopEdge || goingRight && mergedCellOnRightEdge || goingLeft && mergedCellOnLeftEdge) {
-    coords.row = mergedCellAtCoords.row;
-    coords.col = mergedCellAtCoords.col;
-  }
-}
-function _onAfterDrawSelection2(currentRow, currentColumn, cornersOfSelection, layerLevel) {
+/**
+ * `afterDrawSelection` hook callback. Used to add the additional class name for the entirely-selected merged cells.
+ *
+ * @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 {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.
+ */
+function _onAfterDrawSelection(currentRow, currentColumn, cornersOfSelection, layerLevel) {
   // Nothing's selected (hook might be triggered by the custom borders)
   if (!cornersOfSelection) {
     return;
   }
   return this.selectionCalculations.getSelectedMergedCellClassName(currentRow, currentColumn, cornersOfSelection, layerLevel);
 }
-function _onBeforeRemoveCellClassNames2() {
+/**
+ * `beforeRemoveCellClassNames` hook callback. Used to remove additional class name from all 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.
+ */
+function _onBeforeRemoveCellClassNames() {
   return this.selectionCalculations.getSelectedMergedCellClassNameToRemove();
 }
-function _onBeforeBeginEditing2(row, column, initialValue, event) {
+/**
+ * Allows to prevent opening the editor while more than one merged cell is selected.
+ *
+ * @param {number} row Visual row index of the edited cell.
+ * @param {number} column Visual column index of the edited cell.
+ * @param {string | null} initialValue The initial editor value.
+ * @param {MouseEvent | KeyboardEvent} event The event which was responsible for opening the editor.
+ * @returns {boolean | undefined}
+ */
+function _onBeforeBeginEditing(row, column, initialValue, event) {
   if (!(event instanceof MouseEvent)) {
     return;
   }