handsontable 12.0.1 → 12.1.0

package/3rdparty/walkontable/src/viewport.mjs

@@ -131,7 +131,7 @@ var Viewport = /*#__PURE__*/function () {
   }, {
     key: "hasVerticalScroll",
     value: function hasVerticalScroll() {
-      return this.getWorkspaceActualHeight() > this.getWorkspaceHeight();
+      return this.wtTable.hider.offsetHeight > this.getWorkspaceHeight();
     }
     /**
      * Checks if viewport has horizontal scroll.
@@ -142,7 +142,7 @@ var Viewport = /*#__PURE__*/function () {
   }, {
     key: "hasHorizontalScroll",
     value: function hasHorizontalScroll() {
-      return this.getWorkspaceActualWidth() > this.getWorkspaceWidth();
+      return this.wtTable.hider.offsetWidth > this.getWorkspaceWidth();
     }
     /**
      * @param {number} from The visual column index from the width sum is start calculated.
@@ -197,24 +197,6 @@ var Viewport = /*#__PURE__*/function () {
      * @returns {number}
      */
 
-  }, {
-    key: "getWorkspaceActualHeight",
-    value: function getWorkspaceActualHeight() {
-      return outerHeight(this.wtTable.TABLE);
-    }
-    /**
-     * @returns {number}
-     */
-
-  }, {
-    key: "getWorkspaceActualWidth",
-    value: function getWorkspaceActualWidth() {
-      return outerWidth(this.wtTable.TABLE) || outerWidth(this.wtTable.TBODY) || outerWidth(this.wtTable.THEAD); // IE8 reports 0 as <table> offsetWidth;
-    }
-    /**
-     * @returns {number}
-     */
-
   }, {
     key: "getColumnHeaderHeight",
     value: function getColumnHeaderHeight() {
@@ -490,7 +472,12 @@ var Viewport = /*#__PURE__*/function () {
       }
 
       var startRow = proposedRowsVisibleCalculator.startRow,
-          endRow = proposedRowsVisibleCalculator.endRow;
+          endRow = proposedRowsVisibleCalculator.endRow; // if there are no fully visible rows at all, return false
+
+      if (startRow === null && endRow === null) {
+        return false;
+      }
+
       var _this$rowsRenderCalcu = this.rowsRenderCalculator,
           renderedStartRow = _this$rowsRenderCalcu.startRow,
           renderedEndRow = _this$rowsRenderCalcu.endRow;
@@ -520,7 +507,12 @@ var Viewport = /*#__PURE__*/function () {
       }
 
       var startColumn = proposedColumnsVisibleCalculator.startColumn,
-          endColumn = proposedColumnsVisibleCalculator.endColumn;
+          endColumn = proposedColumnsVisibleCalculator.endColumn; // if there are no fully visible columns at all, return false
+
+      if (startColumn === null && endColumn === null) {
+        return false;
+      }
+
       var _this$columnsRenderCa = this.columnsRenderCalculator,
           renderedStartColumn = _this$columnsRenderCa.startColumn,
           renderedEndColumn = _this$columnsRenderCa.endColumn;

package/CHANGELOG.md

@@ -8,6 +8,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- UNVERSIONED -->
 
+## [12.1.0] - 2022-06-28
+
+For more information on this release, see:
+- [Release notes](https://handsontable.com/docs/release-notes/#_12-1-0)
+- [Blog post](https://handsontable.com/blog/handsontable-12.1.0-data-grid-new-hooks-new-translations-and-rendering-improvements)
+
+### Added
+- Added smoother row and column moving when some row or columns are hidden. [#7613](https://github.com/handsontable/handsontable/issues/7613)
+- Added `getNearestNotHiddenIndex()`, a new method that finds the visual index of the nearest not-hidden row or column and works even with large numbers of hidden rows or columns. The previous method, `getFirstNotHiddenIndex()`, still works, but is marked as deprecated. [#9064](https://github.com/handsontable/handsontable/issues/9064)
+- Added a Czech translation. [#9343](https://github.com/handsontable/handsontable/issues/9343)
+- Added a Serbian translation. [#9469](https://github.com/handsontable/handsontable/issues/9469)
+- Added new hooks: `beforeColumnFreeze`, `afterColumnFreeze`, `beforeColumnUnfreeze`, and `afterColumnUnfreeze`. [#9248](https://github.com/handsontable/handsontable/issues/9248)
+
+### Changed
+- Replaced HTML entities appearing in Handsontable's license texts with canonical counterparts. [#9487](https://github.com/handsontable/handsontable/issues/9487)
+- Updated the Pikaday optional dependency to 1.8.2, to let Handsontable work with Parcel 2 without errors. [#9410](https://github.com/handsontable/handsontable/issues/9410)
+- *React:* Changed the wrapper's lifecycle methods, to let Handsontable work with React 17+ without warnings. [#8748](https://github.com/handsontable/handsontable/issues/8748)
+- *Angular:* Moved the `@angular/core` dependency to peer dependencies. [#9574](https://github.com/handsontable/handsontable/issues/9574)
+
+### Fixed
+- Fixed an issue where dropdown and autocomplete cell editors rendered incorrectly if the `preventOverflow` option was set to `'horizontal'`. [#3828](https://github.com/handsontable/handsontable/issues/3828)
+- Fixed an issue where frozen rows were getting duplicated. [#4454](https://github.com/handsontable/handsontable/issues/4454)
+- Fixed an issue where comments rendered outside the viewport. [#4785](https://github.com/handsontable/handsontable/issues/4785)
+- Fixed an issue where comments got positioned incorrectly when Handsontable ran within a scrollable element. [#6744](https://github.com/handsontable/handsontable/issues/6744)
+- Fixed an issue that occurred when Handsontable ran within an HTML `<form>`: pressing <kbd>Enter</kbd> inside another form's `<input>` could open Handsontable's dropdown menu. [#9295](https://github.com/handsontable/handsontable/issues/9295)
+- Fixed an issue where it was impossible to unmerge cells in the RTL layout direction. [#9362](https://github.com/handsontable/handsontable/issues/9362)
+- Fixed an issue where columns wider than the viewport's width and rows higher than the viewport's height didn't render correctly. [#9473](https://github.com/handsontable/handsontable/issues/9473)
+- Fixed an issue where dragging-to-scroll on mobile didn't work properly in the RTL layout direction. [#9475](https://github.com/handsontable/handsontable/issues/9475)
+- Fixed an issue where hiding columns with nested headers caused incorrect column width calculation (for the `stretchH: 'all'` option). [#9496](https://github.com/handsontable/handsontable/issues/9496)
+- Fixed an issue where `ShortcutManager` unnecessarily handled `keyup` events with no `key` defined. [#9562](https://github.com/handsontable/handsontable/issues/9562)
+
 ## [12.0.1] - 2022-05-16
 
 For more information on this release, see:
@@ -46,6 +77,7 @@ For more information on this release, see:
 - Changed two scripts of the main Handsontable workspace (`./`), to speed up the build process: now, the `npm run build` and `npm run test` scripts don't build or test the Handsontable examples (`./examples`). [#9412](https://github.com/handsontable/handsontable/issues/9412)
 - Changed the version of the Moment.js dependency from 2.24.0 to 2.29.3, in reaction to a recently-found Moment.js security vulnerability that did not directly affect Handsontable. [#9381](https://github.com/handsontable/handsontable/issues/9381)
 - Changed the version of the HyperFormula optional dependency from ^1.2.0 to ^2.0.0. [#9411](https://github.com/handsontable/handsontable/issues/9411)
+- Changed an internal property name, from `hot.view.wt` to `hot.view._wt`, where `hot` is the name of your Handsontable instance. The intention of this change is to make it clear that Walkontable (Handsontable's rendering engine) is not a part of Handsontable's public API. [#8760](https://github.com/handsontable/handsontable/issues/8760)
 
 ### Fixed
 - *React, Angular, Vue 2, Vue 3:* Fixed an issue where using `updateSettings()` caused problems for state managers. [#8372](https://github.com/handsontable/handsontable/issues/8372)

package/LICENSE.txt

@@ -18,7 +18,7 @@ license agreement.
 In any case, you must not make any such use of this software as to develop software which may be
 considered competitive with this software.
 
-UNLESS EXPRESSLY AGREED OTHERWISE, HANDSONCODE PROVIDES THIS SOFTWARE ON AN "AS IS"
+UNLESS EXPRESSLY AGREED OTHERWISE, HANDSONCODE PROVIDES THIS SOFTWARE ON AN "AS IS"
 BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, AND IN NO EVENT AND UNDER NO
 LEGAL THEORY, SHALL HANDSONCODE BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY DIRECT,
 INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING FROM

package/base.js

@@ -52,8 +52,8 @@ Handsontable.Core = function (rootElement) {
 Handsontable.DefaultSettings = (0, _dataMap.metaSchemaFactory)();
 Handsontable.hooks = _pluginHooks.default.getSingleton();
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "13/05/2022 13:49:59";
-Handsontable.version = "12.0.1";
+Handsontable.buildDate = "28/06/2022 12:07:10";
+Handsontable.version = "12.1.0";
 Handsontable.languages = {
   dictionaryKeys: _registry.dictionaryKeys,
   getLanguageDictionary: _registry.getLanguageDictionary,

package/base.mjs

@@ -37,8 +37,8 @@ Handsontable.Core = function (rootElement) {
 Handsontable.DefaultSettings = metaSchemaFactory();
 Handsontable.hooks = Hooks.getSingleton();
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "13/05/2022 13:50:15";
-Handsontable.version = "12.0.1";
+Handsontable.buildDate = "28/06/2022 12:07:22";
+Handsontable.version = "12.1.0";
 Handsontable.languages = {
   dictionaryKeys: dictionaryKeys,
   getLanguageDictionary: getLanguageDictionary,

package/core.js

@@ -333,6 +333,12 @@ function Core(rootElement, userSettings) {
   };
 
   var selection = new _selection.Selection(tableMeta, {
+    rowIndexMapper: function rowIndexMapper() {
+      return instance.rowIndexMapper;
+    },
+    columnIndexMapper: function columnIndexMapper() {
+      return instance.columnIndexMapper;
+    },
     countCols: function countCols() {
       return instance.countCols();
     },
@@ -2286,8 +2292,8 @@ function Core(rootElement, userSettings) {
    * To replace Handsontable's [`data`](@/api/options.md#data) and reset states, use the [`loadData()`](#loaddata) method.
    *
    * Read more:
-   * - [Binding to data →](@/guides/getting-started/binding-to-data.md)
-   * - [Saving data →](@/guides/getting-started/saving-data.md)
+   * - [Binding to data](@/guides/getting-started/binding-to-data.md)
+   * - [Saving data](@/guides/getting-started/saving-data.md)
    *
    * @memberof Core#
    * @function updateData
@@ -2330,8 +2336,8 @@ function Core(rootElement, userSettings) {
    * To replace Handsontable's [`data`](@/api/options.md#data) without resetting states, use the [`updateData()`](#updatedata) method.
    *
    * Read more:
-   * - [Binding to data →](@/guides/getting-started/binding-to-data.md)
-   * - [Saving data →](@/guides/getting-started/saving-data.md)
+   * - [Binding to data](@/guides/getting-started/binding-to-data.md)
+   * - [Saving data](@/guides/getting-started/saving-data.md)
    *
    * @memberof Core#
    * @function loadData
@@ -4243,7 +4249,7 @@ function Core(rootElement, userSettings) {
 
   var getIndexToScroll = function getIndexToScroll(indexMapper, visualIndex) {
     // Looking for a visual index on the right and then (when not found) on the left.
-    return indexMapper.getFirstNotHiddenIndex(visualIndex, 1, true);
+    return indexMapper.getNearestNotHiddenIndex(visualIndex, 1, true);
   };
   /**
    * Scroll viewport to coordinates specified by the `row` and `column` arguments.
@@ -4254,8 +4260,10 @@ function Core(rootElement, userSettings) {
    * we are using the index for numbering only this rows which may be rendered (we don't consider hidden rows).
    * @param {number} [column] Column index. If the last argument isn't defined we treat the index as a visual column index.
    * Otherwise, we are using the index for numbering only this columns which may be rendered (we don't consider hidden columns).
-   * @param {boolean} [snapToBottom=false] If `true`, viewport is scrolled to show the cell on the bottom of the table.
-   * @param {boolean} [snapToRight=false] If `true`, viewport is scrolled to show the cell on the right side of the table.
+   * @param {boolean} [snapToBottom=false] If `true`, the viewport is scrolled to show the cell at the bottom of the table.
+   * However, if the cell's height is greater than the table's viewport height, the cell is snapped to the top edge.
+   * @param {boolean} [snapToRight=false] If `true`, the viewport is scrolled to show the cell at the right side of the table.
+   * However, if the cell is wider than the table's viewport width, the cell is snapped to the left edge (or to the right edge, if the layout direction is set to `rtl`).
    * @param {boolean} [considerHiddenIndexes=true] If `true`, we handle visual indexes, otherwise we handle only indexes which
    * may be rendered when they are in the viewport (we don't consider hidden indexes as they aren't rendered).
    * @returns {boolean} `true` if scroll was successful, `false` otherwise.
@@ -4728,12 +4736,12 @@ function Core(rootElement, userSettings) {
   };
 
   var shortcutManager = (0, _shortcuts.createShortcutManager)({
+    handleEvent: function handleEvent(event) {
+      var isListening = instance.isListening();
+      var isKeyboardEventWithKey = (event === null || event === void 0 ? void 0 : event.key) !== void 0;
+      return isListening && isKeyboardEventWithKey;
+    },
     beforeKeyDown: function beforeKeyDown(event) {
-      if (_this.isListening() === false) {
-        // Performing action (executing a callback) and triggering hook only for listening Handsontable.
-        return false;
-      }
-
       return _this.runHooks('beforeKeyDown', event);
     },
     afterKeyDown: function afterKeyDown(event) {
@@ -4810,7 +4818,7 @@ function Core(rootElement, userSettings) {
     keys: [['ArrowUp', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getFirstNotHiddenIndex(0, 1), instance.getSelectedRangeLast().highlight.col));
+      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getNearestNotHiddenIndex(0, 1), instance.getSelectedRangeLast().highlight.col));
     }
   }, {
     keys: [['ArrowUp', 'Shift']],
@@ -4825,7 +4833,7 @@ function Core(rootElement, userSettings) {
           from = _instance$getSelected.from,
           to = _instance$getSelected.to;
 
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(0, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(0, 1);
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(row, to.col));
     },
@@ -4841,7 +4849,7 @@ function Core(rootElement, userSettings) {
     keys: [['ArrowDown', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - 1, -1), instance.getSelectedRangeLast().highlight.col));
+      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - 1, -1), instance.getSelectedRangeLast().highlight.col));
     }
   }, {
     keys: [['ArrowDown', 'Shift']],
@@ -4856,7 +4864,7 @@ function Core(rootElement, userSettings) {
           from = _instance$getSelected2.from,
           to = _instance$getSelected2.to;
 
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - 1, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - 1, -1);
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(row, to.col));
     },
@@ -4876,7 +4884,7 @@ function Core(rootElement, userSettings) {
 
       var row = instance.getSelectedRangeLast().highlight.row;
 
-      var column = (_instance$columnIndex = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
+      var column = (_instance$columnIndex = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
 
       selection.setRangeStart(instance._createCellCoords(row, column));
     }
@@ -4895,7 +4903,7 @@ function Core(rootElement, userSettings) {
           from = _instance$getSelected3.from,
           to = _instance$getSelected3.to;
 
-      var column = (_instance$columnIndex2 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex2, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
+      var column = (_instance$columnIndex2 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex2, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
 
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(to.row, column));
@@ -4916,7 +4924,7 @@ function Core(rootElement, userSettings) {
 
       var row = instance.getSelectedRangeLast().highlight.row;
 
-      var column = (_instance$columnIndex3 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex3, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
+      var column = (_instance$columnIndex3 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex3, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
 
       selection.setRangeStart(instance._createCellCoords(row, column));
     }
@@ -4935,7 +4943,7 @@ function Core(rootElement, userSettings) {
           from = _instance$getSelected4.from,
           to = _instance$getSelected4.to;
 
-      var column = (_instance$columnIndex4 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex4, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
+      var column = (_instance$columnIndex4 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex4, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
 
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(to.row, column));
@@ -4949,7 +4957,7 @@ function Core(rootElement, userSettings) {
     callback: function callback() {
       var fixedColumns = parseInt(instance.getSettings().fixedColumnsStart, 10);
       var row = instance.getSelectedRangeLast().highlight.row;
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(fixedColumns, 1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(fixedColumns, 1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -4958,7 +4966,7 @@ function Core(rootElement, userSettings) {
   }, {
     keys: [['Home', 'Shift']],
     callback: function callback() {
-      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getFirstNotHiddenIndex(0, 1)));
+      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getNearestNotHiddenIndex(0, 1)));
     }
   }, {
     keys: [['Home', 'Control/Meta']],
@@ -4966,8 +4974,8 @@ function Core(rootElement, userSettings) {
     callback: function callback() {
       var fixedRows = parseInt(instance.getSettings().fixedRowsTop, 10);
       var fixedColumns = parseInt(instance.getSettings().fixedColumnsStart, 10);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(fixedRows, 1);
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(fixedColumns, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(fixedRows, 1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(fixedColumns, 1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -4977,7 +4985,7 @@ function Core(rootElement, userSettings) {
     keys: [['End']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.getSelectedRangeLast().highlight.row, instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1)));
+      selection.setRangeStart(instance._createCellCoords(instance.getSelectedRangeLast().highlight.row, instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1)));
     },
     runOnlyIf: function runOnlyIf() {
       return instance.view.isMainTableNotFullyCoveredByOverlays();
@@ -4985,15 +4993,15 @@ function Core(rootElement, userSettings) {
   }, {
     keys: [['End', 'Shift']],
     callback: function callback() {
-      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1)));
+      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1)));
     }
   }, {
     keys: [['End', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
       var fixedRows = parseInt(instance.getSettings().fixedRowsBottom, 10);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - fixedRows - 1, -1);
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - fixedRows - 1, -1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -5011,7 +5019,7 @@ function Core(rootElement, userSettings) {
           to = _instance$getSelected5.to;
 
       var nextRowIndexToSelect = Math.max(to.row - instance.countVisibleRows(), 0);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(nextRowIndexToSelect, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(nextRowIndexToSelect, 1);
 
       if (row !== null) {
         var coords = instance._createCellCoords(row, to.col);
@@ -5034,7 +5042,7 @@ function Core(rootElement, userSettings) {
           to = _instance$getSelected6.to;
 
       var nextRowIndexToSelect = Math.min(to.row + instance.countVisibleRows(), instance.countRows() - 1);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(nextRowIndexToSelect, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(nextRowIndexToSelect, -1);
 
       if (row !== null) {
         var coords = instance._createCellCoords(row, to.col);

package/core.mjs

@@ -273,6 +273,12 @@ export default function Core(rootElement, userSettings) {
   };
 
   var selection = new Selection(tableMeta, {
+    rowIndexMapper: function rowIndexMapper() {
+      return instance.rowIndexMapper;
+    },
+    columnIndexMapper: function columnIndexMapper() {
+      return instance.columnIndexMapper;
+    },
     countCols: function countCols() {
       return instance.countCols();
     },
@@ -2226,8 +2232,8 @@ export default function Core(rootElement, userSettings) {
    * To replace Handsontable's [`data`](@/api/options.md#data) and reset states, use the [`loadData()`](#loaddata) method.
    *
    * Read more:
-   * - [Binding to data →](@/guides/getting-started/binding-to-data.md)
-   * - [Saving data →](@/guides/getting-started/saving-data.md)
+   * - [Binding to data](@/guides/getting-started/binding-to-data.md)
+   * - [Saving data](@/guides/getting-started/saving-data.md)
    *
    * @memberof Core#
    * @function updateData
@@ -2270,8 +2276,8 @@ export default function Core(rootElement, userSettings) {
    * To replace Handsontable's [`data`](@/api/options.md#data) without resetting states, use the [`updateData()`](#updatedata) method.
    *
    * Read more:
-   * - [Binding to data →](@/guides/getting-started/binding-to-data.md)
-   * - [Saving data →](@/guides/getting-started/saving-data.md)
+   * - [Binding to data](@/guides/getting-started/binding-to-data.md)
+   * - [Saving data](@/guides/getting-started/saving-data.md)
    *
    * @memberof Core#
    * @function loadData
@@ -4183,7 +4189,7 @@ export default function Core(rootElement, userSettings) {
 
   var getIndexToScroll = function getIndexToScroll(indexMapper, visualIndex) {
     // Looking for a visual index on the right and then (when not found) on the left.
-    return indexMapper.getFirstNotHiddenIndex(visualIndex, 1, true);
+    return indexMapper.getNearestNotHiddenIndex(visualIndex, 1, true);
   };
   /**
    * Scroll viewport to coordinates specified by the `row` and `column` arguments.
@@ -4194,8 +4200,10 @@ export default function Core(rootElement, userSettings) {
    * we are using the index for numbering only this rows which may be rendered (we don't consider hidden rows).
    * @param {number} [column] Column index. If the last argument isn't defined we treat the index as a visual column index.
    * Otherwise, we are using the index for numbering only this columns which may be rendered (we don't consider hidden columns).
-   * @param {boolean} [snapToBottom=false] If `true`, viewport is scrolled to show the cell on the bottom of the table.
-   * @param {boolean} [snapToRight=false] If `true`, viewport is scrolled to show the cell on the right side of the table.
+   * @param {boolean} [snapToBottom=false] If `true`, the viewport is scrolled to show the cell at the bottom of the table.
+   * However, if the cell's height is greater than the table's viewport height, the cell is snapped to the top edge.
+   * @param {boolean} [snapToRight=false] If `true`, the viewport is scrolled to show the cell at the right side of the table.
+   * However, if the cell is wider than the table's viewport width, the cell is snapped to the left edge (or to the right edge, if the layout direction is set to `rtl`).
    * @param {boolean} [considerHiddenIndexes=true] If `true`, we handle visual indexes, otherwise we handle only indexes which
    * may be rendered when they are in the viewport (we don't consider hidden indexes as they aren't rendered).
    * @returns {boolean} `true` if scroll was successful, `false` otherwise.
@@ -4666,12 +4674,12 @@ export default function Core(rootElement, userSettings) {
   };
 
   var shortcutManager = createShortcutManager({
+    handleEvent: function handleEvent(event) {
+      var isListening = instance.isListening();
+      var isKeyboardEventWithKey = (event === null || event === void 0 ? void 0 : event.key) !== void 0;
+      return isListening && isKeyboardEventWithKey;
+    },
     beforeKeyDown: function beforeKeyDown(event) {
-      if (_this.isListening() === false) {
-        // Performing action (executing a callback) and triggering hook only for listening Handsontable.
-        return false;
-      }
-
       return _this.runHooks('beforeKeyDown', event);
     },
     afterKeyDown: function afterKeyDown(event) {
@@ -4748,7 +4756,7 @@ export default function Core(rootElement, userSettings) {
     keys: [['ArrowUp', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getFirstNotHiddenIndex(0, 1), instance.getSelectedRangeLast().highlight.col));
+      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getNearestNotHiddenIndex(0, 1), instance.getSelectedRangeLast().highlight.col));
     }
   }, {
     keys: [['ArrowUp', 'Shift']],
@@ -4763,7 +4771,7 @@ export default function Core(rootElement, userSettings) {
           from = _instance$getSelected.from,
           to = _instance$getSelected.to;
 
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(0, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(0, 1);
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(row, to.col));
     },
@@ -4779,7 +4787,7 @@ export default function Core(rootElement, userSettings) {
     keys: [['ArrowDown', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - 1, -1), instance.getSelectedRangeLast().highlight.col));
+      selection.setRangeStart(instance._createCellCoords(instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - 1, -1), instance.getSelectedRangeLast().highlight.col));
     }
   }, {
     keys: [['ArrowDown', 'Shift']],
@@ -4794,7 +4802,7 @@ export default function Core(rootElement, userSettings) {
           from = _instance$getSelected2.from,
           to = _instance$getSelected2.to;
 
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - 1, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - 1, -1);
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(row, to.col));
     },
@@ -4814,7 +4822,7 @@ export default function Core(rootElement, userSettings) {
 
       var row = instance.getSelectedRangeLast().highlight.row;
 
-      var column = (_instance$columnIndex = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
+      var column = (_instance$columnIndex = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
 
       selection.setRangeStart(instance._createCellCoords(row, column));
     }
@@ -4833,7 +4841,7 @@ export default function Core(rootElement, userSettings) {
           from = _instance$getSelected3.from,
           to = _instance$getSelected3.to;
 
-      var column = (_instance$columnIndex2 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex2, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
+      var column = (_instance$columnIndex2 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex2, _toConsumableArray(instance.isRtl() ? [instance.countCols() - 1, -1] : [0, 1]));
 
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(to.row, column));
@@ -4854,7 +4862,7 @@ export default function Core(rootElement, userSettings) {
 
       var row = instance.getSelectedRangeLast().highlight.row;
 
-      var column = (_instance$columnIndex3 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex3, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
+      var column = (_instance$columnIndex3 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex3, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
 
       selection.setRangeStart(instance._createCellCoords(row, column));
     }
@@ -4873,7 +4881,7 @@ export default function Core(rootElement, userSettings) {
           from = _instance$getSelected4.from,
           to = _instance$getSelected4.to;
 
-      var column = (_instance$columnIndex4 = instance.columnIndexMapper).getFirstNotHiddenIndex.apply(_instance$columnIndex4, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
+      var column = (_instance$columnIndex4 = instance.columnIndexMapper).getNearestNotHiddenIndex.apply(_instance$columnIndex4, _toConsumableArray(instance.isRtl() ? [0, 1] : [instance.countCols() - 1, -1]));
 
       selection.setRangeStart(from.clone());
       selection.setRangeEnd(instance._createCellCoords(to.row, column));
@@ -4887,7 +4895,7 @@ export default function Core(rootElement, userSettings) {
     callback: function callback() {
       var fixedColumns = parseInt(instance.getSettings().fixedColumnsStart, 10);
       var row = instance.getSelectedRangeLast().highlight.row;
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(fixedColumns, 1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(fixedColumns, 1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -4896,7 +4904,7 @@ export default function Core(rootElement, userSettings) {
   }, {
     keys: [['Home', 'Shift']],
     callback: function callback() {
-      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getFirstNotHiddenIndex(0, 1)));
+      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getNearestNotHiddenIndex(0, 1)));
     }
   }, {
     keys: [['Home', 'Control/Meta']],
@@ -4904,8 +4912,8 @@ export default function Core(rootElement, userSettings) {
     callback: function callback() {
       var fixedRows = parseInt(instance.getSettings().fixedRowsTop, 10);
       var fixedColumns = parseInt(instance.getSettings().fixedColumnsStart, 10);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(fixedRows, 1);
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(fixedColumns, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(fixedRows, 1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(fixedColumns, 1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -4915,7 +4923,7 @@ export default function Core(rootElement, userSettings) {
     keys: [['End']],
     captureCtrl: true,
     callback: function callback() {
-      selection.setRangeStart(instance._createCellCoords(instance.getSelectedRangeLast().highlight.row, instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1)));
+      selection.setRangeStart(instance._createCellCoords(instance.getSelectedRangeLast().highlight.row, instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1)));
     },
     runOnlyIf: function runOnlyIf() {
       return instance.view.isMainTableNotFullyCoveredByOverlays();
@@ -4923,15 +4931,15 @@ export default function Core(rootElement, userSettings) {
   }, {
     keys: [['End', 'Shift']],
     callback: function callback() {
-      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1)));
+      selection.setRangeEnd(instance._createCellCoords(selection.selectedRange.current().from.row, instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1)));
     }
   }, {
     keys: [['End', 'Control/Meta']],
     captureCtrl: true,
     callback: function callback() {
       var fixedRows = parseInt(instance.getSettings().fixedRowsBottom, 10);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(instance.countRows() - fixedRows - 1, -1);
-      var column = instance.columnIndexMapper.getFirstNotHiddenIndex(instance.countCols() - 1, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(instance.countRows() - fixedRows - 1, -1);
+      var column = instance.columnIndexMapper.getNearestNotHiddenIndex(instance.countCols() - 1, -1);
       selection.setRangeStart(instance._createCellCoords(row, column));
     },
     runOnlyIf: function runOnlyIf() {
@@ -4949,7 +4957,7 @@ export default function Core(rootElement, userSettings) {
           to = _instance$getSelected5.to;
 
       var nextRowIndexToSelect = Math.max(to.row - instance.countVisibleRows(), 0);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(nextRowIndexToSelect, 1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(nextRowIndexToSelect, 1);
 
       if (row !== null) {
         var coords = instance._createCellCoords(row, to.col);
@@ -4972,7 +4980,7 @@ export default function Core(rootElement, userSettings) {
           to = _instance$getSelected6.to;
 
       var nextRowIndexToSelect = Math.min(to.row + instance.countVisibleRows(), instance.countRows() - 1);
-      var row = instance.rowIndexMapper.getFirstNotHiddenIndex(nextRowIndexToSelect, -1);
+      var row = instance.rowIndexMapper.getNearestNotHiddenIndex(nextRowIndexToSelect, -1);
 
       if (row !== null) {
         var coords = instance._createCellCoords(row, to.col);