handsontable 0.0.0-next-08765b9-20230714 → 0.0.0-next-f8ea07b-20230714

package/selection/transformation.mjs

@@ -1,298 +1,156 @@
-import "core-js/modules/es.error.cause.js";
-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 _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
-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(receiver, privateMap, value) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
-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 _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; } }
 import { mixin } from "../helpers/object.mjs";
 import localHooks from "./../mixins/localHooks.mjs";
 /**
  * The Transformation class implements algorithms for transforming coordinates based on current settings
- * passed to the Handsontable. The class performs the calculations based on the renderable indexes.
+ * passed to the Handsontable.
  *
  * Transformation is always applied relative to the current selection.
  *
- * The class operates on a table size defined by the renderable indexes. If the `navigableHeaders`
- * option is enabled, the table size is increased by the number of row and/or column headers.
- * Because the headers are treated as cells as part of the table size (indexes always go from 0 to N),
- * the algorithm can be written as simply as possible (without new if's that distinguish the headers
- * logic).
- *
  * @class Transformation
  * @util
  */
-var _range = /*#__PURE__*/new WeakMap();
-var _options = /*#__PURE__*/new WeakMap();
-var _offset = /*#__PURE__*/new WeakMap();
-var _setOffsetSize = /*#__PURE__*/new WeakSet();
-var _clampCoords = /*#__PURE__*/new WeakSet();
-var _getTableSize = /*#__PURE__*/new WeakSet();
-var _visualToZeroBasedCoords = /*#__PURE__*/new WeakSet();
-var _zeroBasedToVisualCoords = /*#__PURE__*/new WeakSet();
 class Transformation {
   constructor(range, options) {
-    /**
-     * Translates the zero-based coordinates to visual ones.
-     *
-     * @param {CellCoords} zeroBasedCoords The coordinates to process.
-     * @returns {CellCoords}
-     */
-    _classPrivateMethodInitSpec(this, _zeroBasedToVisualCoords);
-    /**
-     * Translates the visual coordinates to zero-based ones.
-     *
-     * @param {CellCoords} visualCoords The visual coords to process.
-     * @returns {{x: number, y: number}}
-     */
-    _classPrivateMethodInitSpec(this, _visualToZeroBasedCoords);
-    /**
-     * Gets the table size in number of rows with headers as "height" and number of columns with
-     * headers as "width".
-     *
-     * @returns {{width: number, height: number}}
-     */
-    _classPrivateMethodInitSpec(this, _getTableSize);
-    /**
-     * Clamps the coords to make sure they points to the cell (or header) in the table range.
-     *
-     * @param {CellCoords} zeroBasedCoords The coords object to clamp.
-     * @returns {{rowDir: 1|0|-1, colDir: 1|0|-1}}
-     */
-    _classPrivateMethodInitSpec(this, _clampCoords);
-    /**
-     * Sets the additional offset in table size that may occur when the `navigableHeaders` option
-     * is enabled.
-     *
-     * @param {{x: number, y: number}} offset Offset as x and y properties.
-     */
-    _classPrivateMethodInitSpec(this, _setOffsetSize);
     /**
      * Instance of the SelectionRange, holder for visual coordinates applied to the table.
      *
      * @type {SelectionRange}
      */
-    _classPrivateFieldInitSpec(this, _range, {
-      writable: true,
-      value: void 0
-    });
+    this.range = range;
     /**
      * Additional options which define the state of the settings which can infer transformation and
      * give the possibility to translate indexes.
      *
      * @type {object}
      */
-    _classPrivateFieldInitSpec(this, _options, {
-      writable: true,
-      value: void 0
-    });
-    /**
-     * Increases the table size by applying the offsets. The option is used by the `navigableHeaders`
-     * option.
-     *
-     * @type {{ x: number, y: number }}
-     */
-    _classPrivateFieldInitSpec(this, _offset, {
-      writable: true,
-      value: {
-        x: 0,
-        y: 0
-      }
-    });
-    _classPrivateFieldSet(this, _range, range);
-    _classPrivateFieldSet(this, _options, options);
+    this.options = options;
   }
 
   /**
-   * Selects cell relative to the current cell (if possible).
+   * Selects cell relative to current cell (if possible).
    *
    * @param {number} rowDelta Rows number to move, value can be passed as negative number.
    * @param {number} colDelta Columns number to move, value can be passed as negative number.
-   * @param {boolean} [createMissingRecords=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
+   * @param {boolean} [force=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
    *                        be created according to `minSpareRows/minSpareCols` settings of Handsontable.
    * @returns {CellCoords} Visual coordinates after transformation.
    */
   transformStart(rowDelta, colDelta) {
-    let createMissingRecords = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-    _classPrivateMethodGet(this, _setOffsetSize, _setOffsetSize2).call(this, {
-      x: _classPrivateFieldGet(this, _options).navigableHeaders() ? _classPrivateFieldGet(this, _options).countRowHeaders() : 0,
-      y: _classPrivateFieldGet(this, _options).navigableHeaders() ? _classPrivateFieldGet(this, _options).countColHeaders() : 0
-    });
-    const delta = _classPrivateFieldGet(this, _options).createCellCoords(rowDelta, colDelta);
-    let visualCoords = _classPrivateFieldGet(this, _range).current().highlight;
-    const highlightRenderableCoords = _classPrivateFieldGet(this, _options).visualToRenderableCoords(visualCoords);
+    let force = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    const delta = this.options.createCellCoords(rowDelta, colDelta);
+    const highlightCoords = this.range.current().highlight;
+    const {
+      row: renderableRow,
+      col: renderableColumn
+    } = this.options.visualToRenderableCoords(highlightCoords);
+    let visualCoords = highlightCoords;
     let rowTransformDir = 0;
     let colTransformDir = 0;
     this.runLocalHooks('beforeTransformStart', delta);
-    if (highlightRenderableCoords.row !== null && highlightRenderableCoords.col !== null) {
-      const {
-        width,
-        height
-      } = _classPrivateMethodGet(this, _getTableSize, _getTableSize2).call(this);
-      const {
-        x,
-        y
-      } = _classPrivateMethodGet(this, _visualToZeroBasedCoords, _visualToZeroBasedCoords2).call(this, visualCoords);
-      const fixedRowsBottom = _classPrivateFieldGet(this, _options).fixedRowsBottom();
-      const minSpareRows = _classPrivateFieldGet(this, _options).minSpareRows();
-      const minSpareCols = _classPrivateFieldGet(this, _options).minSpareCols();
-      const autoWrapRow = _classPrivateFieldGet(this, _options).autoWrapRow();
-      const autoWrapCol = _classPrivateFieldGet(this, _options).autoWrapCol();
-      const rawCoords = {
-        row: y + delta.row,
-        col: x + delta.col
-      };
-      if (rawCoords.row >= height) {
-        if (createMissingRecords && minSpareRows > 0 && fixedRowsBottom === 0) {
-          this.runLocalHooks('insertRowRequire', _classPrivateFieldGet(this, _options).countRenderableRows());
+    if (renderableRow !== null && renderableColumn !== null) {
+      let totalRows = this.options.countRows();
+      let totalCols = this.options.countCols();
+      const fixedRowsBottom = this.options.fixedRowsBottom();
+      const minSpareRows = this.options.minSpareRows();
+      const minSpareCols = this.options.minSpareCols();
+      const autoWrapRow = this.options.autoWrapRow();
+      const autoWrapCol = this.options.autoWrapCol();
+      if (renderableRow + rowDelta > totalRows - 1) {
+        if (force && minSpareRows > 0 && !(fixedRowsBottom && renderableRow >= totalRows - fixedRowsBottom - 1)) {
+          this.runLocalHooks('insertRowRequire', totalRows);
+          totalRows = this.options.countRows();
         } else if (autoWrapCol) {
-          const nextColumn = rawCoords.col + 1;
-          rawCoords.row = rawCoords.row - height;
-          rawCoords.col = nextColumn >= width ? nextColumn - width : nextColumn;
-        }
-      } else if (rawCoords.row < 0) {
-        if (autoWrapCol) {
-          const previousColumn = rawCoords.col - 1;
-          rawCoords.row = height + rawCoords.row;
-          rawCoords.col = previousColumn < 0 ? width + previousColumn : previousColumn;
+          delta.row = 1 - totalRows;
+          delta.col = renderableColumn + delta.col === totalCols - 1 ? 1 - totalCols : 1;
         }
+      } else if (autoWrapCol && renderableRow + delta.row < 0 && renderableColumn + delta.col >= 0) {
+        delta.row = totalRows - 1;
+        delta.col = renderableColumn + delta.col === 0 ? totalCols - 1 : -1;
       }
-      if (rawCoords.col >= width) {
-        if (createMissingRecords && minSpareCols > 0) {
-          this.runLocalHooks('insertColRequire', _classPrivateFieldGet(this, _options).countRenderableColumns());
+      if (renderableColumn + delta.col > totalCols - 1) {
+        if (force && minSpareCols > 0) {
+          this.runLocalHooks('insertColRequire', totalCols);
+          totalCols = this.options.countCols();
         } else if (autoWrapRow) {
-          const nextRow = rawCoords.row + 1;
-          rawCoords.row = nextRow >= height ? nextRow - height : nextRow;
-          rawCoords.col = rawCoords.col - width;
-        }
-      } else if (rawCoords.col < 0) {
-        if (autoWrapRow) {
-          const previousRow = rawCoords.row - 1;
-          rawCoords.row = previousRow < 0 ? height + previousRow : previousRow;
-          rawCoords.col = width + rawCoords.col;
+          delta.row = renderableRow + delta.row === totalRows - 1 ? 1 - totalRows : 1;
+          delta.col = 1 - totalCols;
         }
+      } else if (autoWrapRow && renderableColumn + delta.col < 0 && renderableRow + delta.row >= 0) {
+        delta.row = renderableRow + delta.row === 0 ? totalRows - 1 : -1;
+        delta.col = totalCols - 1;
       }
-      const coords = _classPrivateFieldGet(this, _options).createCellCoords(rawCoords.row, rawCoords.col);
-      const {
-        rowDir,
-        colDir
-      } = _classPrivateMethodGet(this, _clampCoords, _clampCoords2).call(this, coords);
-      rowTransformDir = rowDir;
-      colTransformDir = colDir;
-      visualCoords = _classPrivateMethodGet(this, _zeroBasedToVisualCoords, _zeroBasedToVisualCoords2).call(this, coords);
+      const coords = this.options.createCellCoords(renderableRow + delta.row, renderableColumn + delta.col);
+      rowTransformDir = 0;
+      colTransformDir = 0;
+      if (coords.row < 0) {
+        rowTransformDir = -1;
+        coords.row = 0;
+      } else if (coords.row > 0 && coords.row >= totalRows) {
+        rowTransformDir = 1;
+        coords.row = totalRows - 1;
+      }
+      if (coords.col < 0) {
+        colTransformDir = -1;
+        coords.col = 0;
+      } else if (coords.col > 0 && coords.col >= totalCols) {
+        colTransformDir = 1;
+        coords.col = totalCols - 1;
+      }
+      visualCoords = this.options.renderableToVisualCoords(coords);
     }
     this.runLocalHooks('afterTransformStart', visualCoords, rowTransformDir, colTransformDir);
     return visualCoords;
   }
 
   /**
-   * Sets selection end cell relative to the current selection end cell (if possible).
+   * Sets selection end cell relative to current selection end cell (if possible).
    *
    * @param {number} rowDelta Rows number to move, value can be passed as negative number.
    * @param {number} colDelta Columns number to move, value can be passed as negative number.
    * @returns {CellCoords} Visual coordinates after transformation.
    */
   transformEnd(rowDelta, colDelta) {
-    _classPrivateMethodGet(this, _setOffsetSize, _setOffsetSize2).call(this, {
-      x: _classPrivateFieldGet(this, _options).navigableHeaders() ? _classPrivateFieldGet(this, _options).countRowHeaders() : 0,
-      y: _classPrivateFieldGet(this, _options).navigableHeaders() ? _classPrivateFieldGet(this, _options).countColHeaders() : 0
-    });
-    const delta = _classPrivateFieldGet(this, _options).createCellCoords(rowDelta, colDelta);
-    const cellRange = _classPrivateFieldGet(this, _range).current();
-    const highlightRenderableCoords = _classPrivateFieldGet(this, _options).visualToRenderableCoords(cellRange.highlight);
-    const visualCoords = cellRange.to.clone();
+    const delta = this.options.createCellCoords(rowDelta, colDelta);
+    const cellRange = this.range.current();
+    let visualCoords = cellRange.to;
     let rowTransformDir = 0;
     let colTransformDir = 0;
     this.runLocalHooks('beforeTransformEnd', delta);
-    if (highlightRenderableCoords.row !== null && highlightRenderableCoords.col !== null) {
-      const {
-        x,
-        y
-      } = _classPrivateMethodGet(this, _visualToZeroBasedCoords, _visualToZeroBasedCoords2).call(this, cellRange.to);
-      const rawCoords = {
-        row: y + delta.row,
-        col: x + delta.col
-      };
-      const coords = _classPrivateFieldGet(this, _options).createCellCoords(rawCoords.row, rawCoords.col);
+    const {
+      row: rowHighlight,
+      col: colHighlight
+    } = this.options.visualToRenderableCoords(cellRange.highlight);
+
+    // We have highlight (start point for the selection).
+    if (rowHighlight !== null && colHighlight !== null) {
+      const totalRows = this.options.countRows();
+      const totalCols = this.options.countCols();
       const {
-        rowDir,
-        colDir
-      } = _classPrivateMethodGet(this, _clampCoords, _clampCoords2).call(this, coords);
-      rowTransformDir = rowDir;
-      colTransformDir = colDir;
-      const newVisualCoords = _classPrivateMethodGet(this, _zeroBasedToVisualCoords, _zeroBasedToVisualCoords2).call(this, coords);
-      if (delta.row === 0 && delta.col !== 0) {
-        visualCoords.col = newVisualCoords.col;
-      } else if (delta.row !== 0 && delta.col === 0) {
-        visualCoords.row = newVisualCoords.row;
-      } else {
-        visualCoords.row = newVisualCoords.row;
-        visualCoords.col = newVisualCoords.col;
+        row: rowTo,
+        col: colTo
+      } = this.options.visualToRenderableCoords(cellRange.to);
+      const coords = this.options.createCellCoords(rowTo + delta.row, colTo + delta.col);
+      rowTransformDir = 0;
+      colTransformDir = 0;
+      if (coords.row < 0) {
+        rowTransformDir = -1;
+        coords.row = 0;
+      } else if (coords.row > 0 && coords.row >= totalRows) {
+        rowTransformDir = 1;
+        coords.row = totalRows - 1;
+      }
+      if (coords.col < 0) {
+        colTransformDir = -1;
+        coords.col = 0;
+      } else if (coords.col > 0 && coords.col >= totalCols) {
+        colTransformDir = 1;
+        coords.col = totalCols - 1;
       }
+      visualCoords = this.options.renderableToVisualCoords(coords);
     }
     this.runLocalHooks('afterTransformEnd', visualCoords, rowTransformDir, colTransformDir);
     return visualCoords;
   }
 }
-function _setOffsetSize2(_ref) {
-  let {
-    x,
-    y
-  } = _ref;
-  _classPrivateFieldSet(this, _offset, {
-    x,
-    y
-  });
-}
-function _clampCoords2(zeroBasedCoords) {
-  const {
-    width,
-    height
-  } = _classPrivateMethodGet(this, _getTableSize, _getTableSize2).call(this);
-  let rowDir = 0;
-  let colDir = 0;
-  if (zeroBasedCoords.row < 0) {
-    rowDir = -1;
-    zeroBasedCoords.row = 0;
-  } else if (zeroBasedCoords.row > 0 && zeroBasedCoords.row >= height) {
-    rowDir = 1;
-    zeroBasedCoords.row = height - 1;
-  }
-  if (zeroBasedCoords.col < 0) {
-    colDir = -1;
-    zeroBasedCoords.col = 0;
-  } else if (zeroBasedCoords.col > 0 && zeroBasedCoords.col >= width) {
-    colDir = 1;
-    zeroBasedCoords.col = width - 1;
-  }
-  return {
-    rowDir,
-    colDir
-  };
-}
-function _getTableSize2() {
-  return {
-    width: _classPrivateFieldGet(this, _offset).x + _classPrivateFieldGet(this, _options).countRenderableColumns(),
-    height: _classPrivateFieldGet(this, _offset).y + _classPrivateFieldGet(this, _options).countRenderableRows()
-  };
-}
-function _visualToZeroBasedCoords2(visualCoords) {
-  const {
-    row,
-    col
-  } = _classPrivateFieldGet(this, _options).visualToRenderableCoords(visualCoords);
-  return {
-    x: _classPrivateFieldGet(this, _offset).x + col,
-    y: _classPrivateFieldGet(this, _offset).y + row
-  };
-}
-function _zeroBasedToVisualCoords2(zeroBasedCoords) {
-  zeroBasedCoords.col = zeroBasedCoords.col - _classPrivateFieldGet(this, _offset).x;
-  zeroBasedCoords.row = zeroBasedCoords.row - _classPrivateFieldGet(this, _offset).y;
-  return _classPrivateFieldGet(this, _options).renderableToVisualCoords(zeroBasedCoords);
-}
 mixin(Transformation, localHooks);
 export default Transformation;

package/selection/utils.js

@@ -2,6 +2,7 @@
 
 exports.__esModule = true;
 exports.detectSelectionType = detectSelectionType;
+exports.isValidCoord = isValidCoord;
 exports.normalizeSelectionFactory = normalizeSelectionFactory;
 exports.transformSelectionToColumnDistance = transformSelectionToColumnDistance;
 exports.transformSelectionToRowDistance = transformSelectionToRowDistance;
@@ -110,9 +111,7 @@ function normalizeSelectionFactory(type) {
       rowEnd = Math.max(origRowStart, origRowEnd);
       columnEnd = Math.max(origColumnStart, origColumnEnd);
     }
-    const from = new _src.CellCoords(rowStart, columnStart);
-    const to = new _src.CellCoords(rowEnd, columnEnd);
-    return new _src.CellRange(from, from, to);
+    return [rowStart, columnStart, rowEnd, columnEnd];
   };
 }
 
@@ -138,12 +137,9 @@ function transformSelectionToColumnDistance(selectionRanges) {
 
   // Iterate through all ranges and collect all column indexes which are not saved yet.
   (0, _array.arrayEach)(selectionRanges, selection => {
-    const {
-      from,
-      to
-    } = selectionSchemaNormalizer(selection);
-    const columnNonHeaderStart = Math.max(from.col, 0);
-    const amount = to.col - columnNonHeaderStart + 1;
+    const [, columnStart,, columnEnd] = selectionSchemaNormalizer(selection);
+    const columnNonHeaderStart = Math.max(columnStart, 0);
+    const amount = columnEnd - columnNonHeaderStart + 1;
     (0, _array.arrayEach)(Array.from(new Array(amount), (_, i) => columnNonHeaderStart + i), index => {
       if (!unorderedIndexes.has(index)) {
         unorderedIndexes.add(index);
@@ -186,12 +182,9 @@ function transformSelectionToRowDistance(selectionRanges) {
 
   // Iterate through all ranges and collect all column indexes which are not saved yet.
   (0, _array.arrayEach)(selectionRanges, selection => {
-    const {
-      from,
-      to
-    } = selectionSchemaNormalizer(selection);
-    const rowNonHeaderStart = Math.max(from.row, 0);
-    const amount = to.row - rowNonHeaderStart + 1;
+    const [rowStart,, rowEnd] = selectionSchemaNormalizer(selection);
+    const rowNonHeaderStart = Math.max(rowStart, 0);
+    const amount = rowEnd - rowNonHeaderStart + 1;
     (0, _array.arrayEach)(Array.from(new Array(amount), (_, i) => rowNonHeaderStart + i), index => {
       if (!unorderedIndexes.has(index)) {
         unorderedIndexes.add(index);
@@ -210,4 +203,17 @@ function transformSelectionToRowDistance(selectionRanges) {
     return acc;
   }, []);
   return normalizedRowRanges;
+}
+
+/**
+ * Check if passed value can be treated as valid cell coordinate. The second argument is
+ * used to check if the value doesn't exceed the defined max table rows/columns count.
+ *
+ * @param {number} coord The coordinate to validate (row index or column index).
+ * @param {number} maxTableItemsCount The value that declares the maximum coordinate that is still validatable.
+ * @returns {boolean}
+ */
+function isValidCoord(coord) {
+  let maxTableItemsCount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : Infinity;
+  return typeof coord === 'number' && coord >= 0 && coord < maxTableItemsCount;
 }

package/selection/utils.mjs

@@ -1,6 +1,6 @@
 import "core-js/modules/es.error.cause.js";
 import "core-js/modules/es.array.push.js";
-import { CellRange, CellCoords } from "./../3rdparty/walkontable/src/index.mjs";
+import { CellRange } from "./../3rdparty/walkontable/src/index.mjs";
 import { arrayEach, arrayReduce } from "./../helpers/array.mjs";
 import { isUndefined } from "./../helpers/mixed.mjs";
 export const SELECTION_TYPE_UNRECOGNIZED = 0;
@@ -98,9 +98,7 @@ export function normalizeSelectionFactory(type) {
       rowEnd = Math.max(origRowStart, origRowEnd);
       columnEnd = Math.max(origColumnStart, origColumnEnd);
     }
-    const from = new CellCoords(rowStart, columnStart);
-    const to = new CellCoords(rowEnd, columnEnd);
-    return new CellRange(from, from, to);
+    return [rowStart, columnStart, rowEnd, columnEnd];
   };
 }
 
@@ -126,12 +124,9 @@ export function transformSelectionToColumnDistance(selectionRanges) {
 
   // Iterate through all ranges and collect all column indexes which are not saved yet.
   arrayEach(selectionRanges, selection => {
-    const {
-      from,
-      to
-    } = selectionSchemaNormalizer(selection);
-    const columnNonHeaderStart = Math.max(from.col, 0);
-    const amount = to.col - columnNonHeaderStart + 1;
+    const [, columnStart,, columnEnd] = selectionSchemaNormalizer(selection);
+    const columnNonHeaderStart = Math.max(columnStart, 0);
+    const amount = columnEnd - columnNonHeaderStart + 1;
     arrayEach(Array.from(new Array(amount), (_, i) => columnNonHeaderStart + i), index => {
       if (!unorderedIndexes.has(index)) {
         unorderedIndexes.add(index);
@@ -174,12 +169,9 @@ export function transformSelectionToRowDistance(selectionRanges) {
 
   // Iterate through all ranges and collect all column indexes which are not saved yet.
   arrayEach(selectionRanges, selection => {
-    const {
-      from,
-      to
-    } = selectionSchemaNormalizer(selection);
-    const rowNonHeaderStart = Math.max(from.row, 0);
-    const amount = to.row - rowNonHeaderStart + 1;
+    const [rowStart,, rowEnd] = selectionSchemaNormalizer(selection);
+    const rowNonHeaderStart = Math.max(rowStart, 0);
+    const amount = rowEnd - rowNonHeaderStart + 1;
     arrayEach(Array.from(new Array(amount), (_, i) => rowNonHeaderStart + i), index => {
       if (!unorderedIndexes.has(index)) {
         unorderedIndexes.add(index);
@@ -198,4 +190,17 @@ export function transformSelectionToRowDistance(selectionRanges) {
     return acc;
   }, []);
   return normalizedRowRanges;
+}
+
+/**
+ * Check if passed value can be treated as valid cell coordinate. The second argument is
+ * used to check if the value doesn't exceed the defined max table rows/columns count.
+ *
+ * @param {number} coord The coordinate to validate (row index or column index).
+ * @param {number} maxTableItemsCount The value that declares the maximum coordinate that is still validatable.
+ * @returns {boolean}
+ */
+export function isValidCoord(coord) {
+  let maxTableItemsCount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : Infinity;
+  return typeof coord === 'number' && coord >= 0 && coord < maxTableItemsCount;
 }

package/settings.d.ts

@@ -124,7 +124,6 @@ export interface GridSettings extends Events {
   dateFormat?: string;
   datePickerConfig?: PikadayOptions;
   defaultDate?: string;
-  disableTabNavigation?: boolean;
   disableVisualSelection?: boolean | 'current' | 'area' | 'header' | Array<'current' | 'area' | 'header'>;
   dragToScroll?: boolean;
   dropdownMenu?: DropdownMenuSettings;
@@ -165,7 +164,6 @@ export interface GridSettings extends Events {
   minSpareCols?: number;
   minSpareRows?: number;
   multiColumnSorting?: MultiColumnSortingSettings;
-  navigableHeaders?: boolean;
   nestedHeaders?: NestedHeadersSettings;
   nestedRows?: boolean;
   noWordWrapClassName?: string;

package/shortcuts/manager.js

@@ -2,7 +2,6 @@
 
 exports.__esModule = true;
 var _uniqueMap = require("../utils/dataStructures/uniqueMap");
-var _event = require("../helpers/dom/event");
 var _context = require("./context");
 var _recorder = require("./recorder");
 /* eslint-disable jsdoc/require-description-complete-sentence */
@@ -127,7 +126,6 @@ const createShortcutManager = _ref => {
           event.preventDefault();
         }
         if (stopPropagation) {
-          (0, _event.stopImmediatePropagation)(event);
           event.stopPropagation();
         }
         if (isExecutionCancelled) {

package/shortcuts/manager.mjs

@@ -1,5 +1,4 @@
 import { createUniqueMap } from "../utils/dataStructures/uniqueMap.mjs";
-import { stopImmediatePropagation } from "../helpers/dom/event.mjs";
 import { createContext } from "./context.mjs";
 import { useRecorder } from "./recorder.mjs";
 /* eslint-disable jsdoc/require-description-complete-sentence */
@@ -123,7 +122,6 @@ export const createShortcutManager = _ref => {
           event.preventDefault();
         }
         if (stopPropagation) {
-          stopImmediatePropagation(event);
           event.stopPropagation();
         }
         if (isExecutionCancelled) {

package/shortcuts/recorder.js

@@ -86,7 +86,7 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
     if (event.keyCode === 229 || result === false || (0, _event.isImmediatePropagationStopped)(event)) {
       return;
     }
-    const pressedKey = (0, _utils.normalizeEventKey)(event);
+    const pressedKey = (0, _utils.normalizeEventKey)(event.key);
     let extraModifierKeys = [];
     if (isModifierKey(pressedKey)) {
       modifierKeysObserver.press(pressedKey);
@@ -112,7 +112,7 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
     if (handleEvent(event) === false) {
       return;
     }
-    const pressedKey = (0, _utils.normalizeEventKey)(event);
+    const pressedKey = (0, _utils.normalizeEventKey)(event.key);
     if (isModifierKey(pressedKey) === false) {
       return;
     }

package/shortcuts/recorder.mjs

@@ -82,7 +82,7 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
     if (event.keyCode === 229 || result === false || isImmediatePropagationStopped(event)) {
       return;
     }
-    const pressedKey = normalizeEventKey(event);
+    const pressedKey = normalizeEventKey(event.key);
     let extraModifierKeys = [];
     if (isModifierKey(pressedKey)) {
       modifierKeysObserver.press(pressedKey);
@@ -108,7 +108,7 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
     if (handleEvent(event) === false) {
       return;
     }
-    const pressedKey = normalizeEventKey(event);
+    const pressedKey = normalizeEventKey(event.key);
     if (isModifierKey(pressedKey) === false) {
       return;
     }

package/shortcuts/utils.js

@@ -37,27 +37,13 @@ const getKeysList = normalizedKeys => {
 };
 
 /**
- * The regex tests if the event.code matches to the pattern and it's used to extract letters and digits from
- * the string.
- */
-exports.getKeysList = getKeysList;
-const codeToKeyRegExp = new RegExp('^(?:Key|Digit)([A-Z0-9])$');
-
-/**
- * Normalizes a keyboard event key value to a key before its modification. When the keyboard event
- * is triggered with Alt, Control or Shift keys the `key` property contains modified key e.g. for Alt+L
- * it will be `ł`. But that value is only valid for polish keyboard layout. To fix that limitations, for
- * letters and digits the value is taken from the `code` property which holds original value before
- * transformation.
+ * Normalize a `KeyboardEvent.key` property, to use it for keyboard shortcuts.
  *
- * @param {Event} event The KeyboardEvent object.
+ * @param {string} key KeyboardEvent's key property.
  * @returns {string}
  */
-const normalizeEventKey = _ref => {
-  let {
-    key,
-    code
-  } = _ref;
-  return (codeToKeyRegExp.test(code) ? code.replace(codeToKeyRegExp, '$1') : key).toLowerCase();
+exports.getKeysList = getKeysList;
+const normalizeEventKey = key => {
+  return key.toLowerCase();
 };
 exports.normalizeEventKey = normalizeEventKey;