handsontable 17.1.0 → 18.0.0-rc2

package/selection/selection.js

@@ -13,7 +13,6 @@ const _range = /*#__PURE__*/ _interop_require_default(require("./range"));
 const _object = require("./../helpers/object");
 const _mixed = require("./../helpers/mixed");
 const _number = require("./../helpers/number");
-const _array = require("./../helpers/array");
 const _localHooks = /*#__PURE__*/ _interop_require_default(require("./../mixins/localHooks"));
 const _transformation = require("./transformation");
 const _utils = require("./utils");
@@ -60,6 +59,16 @@ function _class_private_field_set(receiver, privateMap, value) {
     _class_apply_descriptor_set(receiver, descriptor, value);
     return value;
 }
+function _class_private_method_get(receiver, privateSet, fn) {
+    if (!privateSet.has(receiver)) {
+        throw new TypeError("attempted to get private field on non-instance");
+    }
+    return fn;
+}
+function _class_private_method_init(obj, privateSet) {
+    _check_private_redeclaration(obj, privateSet);
+    privateSet.add(obj);
+}
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -106,15 +115,33 @@ function _interop_require_wildcard(obj, nodeInterop) {
     }
     return newObj;
 }
-var /**
-   * The module for modifying coordinates of the start and end selection.
-   *
-   * @type {ExtenderTransformation}
-   */ _extenderTransformation = /*#__PURE__*/ new WeakMap(), /**
-   * The module for modifying coordinates of the focus selection.
-   *
-   * @type {FocusTransformation}
-   */ _focusTransformation = /*#__PURE__*/ new WeakMap(), /**
+/**
+ * Checks if the value is a focus-position object with integer `row` and `col` fields.
+ *
+ * @param {unknown} value The value to check.
+ * @returns {boolean}
+ */ function isFocusPositionObject(value) {
+    return typeof value === 'object' && value !== null && Number.isInteger(value.row) && Number.isInteger(value.col);
+}
+/**
+ * Snaps a shifted index to the nearest non-hidden index. Used after a selection shift so a
+ * single-line selection does not land on a hidden (non-rendered) row or column. Snapping is
+ * limited to single-line selections - a wider range legitimately keeps hidden indexes within its
+ * bounds (they stay part of copy/fill ranges), so its corners are returned unchanged. Headers
+ * (negative indexes) are returned unchanged as well.
+ *
+ * @param {IndexMapper} indexMapper The row or column index mapper to query for visibility.
+ * @param {number} index The shifted visual index to snap.
+ * @param {boolean} isSingleLine Whether the selection spans a single row/column on this axis.
+ * @returns {number}
+ */ function snapToNearestVisible(indexMapper, index, isSingleLine) {
+    if (!isSingleLine || index < 0) {
+        return index;
+    }
+    const nearestIndex = indexMapper.getNearestNotHiddenIndex(index, 1, true);
+    return nearestIndex === null ? index : nearestIndex;
+}
+var _extenderTransformation = /*#__PURE__*/ new WeakMap(), _focusTransformation = /*#__PURE__*/ new WeakMap(), /**
    * The flag which determines if the focus selection was changed.
    *
    * @type {boolean}
@@ -136,7 +163,20 @@ var /**
    * Focus highlight may jump between selection range layers.
    *
    * @type {number}
-   */ _activeSelectionLayer = /*#__PURE__*/ new WeakMap();
+   */ _activeSelectionLayer = /*#__PURE__*/ new WeakMap(), /**
+   * Applies header-type highlights for the given cell range.
+   *
+   * @param {CellRange} cellRange The cell range to highlight.
+   * @param {number} countRows The total number of rows.
+   * @param {number} countCols The total number of columns.
+   * @param {object | null | undefined} rowHeaderHighlight The row header highlight instance.
+   * @param {object | null | undefined} columnHeaderHighlight The column header highlight instance.
+   * @param {object | null | undefined} activeRowHeaderHighlight The active row header highlight instance.
+   * @param {object | null | undefined} activeColumnHeaderHighlight The active column header highlight instance.
+   * @param {object | null | undefined} activeCornerHeaderHighlight The active corner header highlight instance.
+   * @param {object | null | undefined} rowHighlight The row highlight instance.
+   * @param {object | null | undefined} columnHighlight The column highlight instance.
+   */ _applyHeaderHighlights = /*#__PURE__*/ new WeakSet();
 /**
  * @typedef {object} SelectionState
  * @property {CellRange[]} ranges The array of all ranges.
@@ -255,17 +295,17 @@ var /**
         this.runLocalHooks(`beforeSetRangeStart${fragment ? 'Only' : ''}`, coordsClone);
         if (!isMultipleMode || isMultipleMode && !isMultipleSelection && (0, _mixed.isUndefined)(multipleSelection)) {
             this.selectedRange.clear();
-            (0, _array.arrayEach)(this.highlight.getAreas(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getLayeredAreas(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getRowHeaders(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getColumnHeaders(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getActiveRowHeaders(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getActiveColumnHeaders(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getActiveCornerHeaders(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getRowHighlights(), (highlight)=>void highlight.clear());
-            (0, _array.arrayEach)(this.highlight.getColumnHighlights(), (highlight)=>void highlight.clear());
+            this.highlight.getAreas().forEach((highlight)=>highlight.clear());
+            this.highlight.getLayeredAreas().forEach((highlight)=>highlight.clear());
+            this.highlight.getRowHeaders().forEach((highlight)=>highlight.clear());
+            this.highlight.getColumnHeaders().forEach((highlight)=>highlight.clear());
+            this.highlight.getActiveRowHeaders().forEach((highlight)=>highlight.clear());
+            this.highlight.getActiveColumnHeaders().forEach((highlight)=>highlight.clear());
+            this.highlight.getActiveCornerHeaders().forEach((highlight)=>highlight.clear());
+            this.highlight.getRowHighlights().forEach((highlight)=>highlight.clear());
+            this.highlight.getColumnHighlights().forEach((highlight)=>highlight.clear());
         }
-        this.selectedRange.add(coordsClone).current().setHighlight(highlightCoords.clone());
+        this.selectedRange.add(coordsClone).current()?.setHighlight(highlightCoords.clone());
         if (this.getLayerLevel() === 0) {
             this.selectedByRowHeader.clear();
             this.selectedByColumnHeader.clear();
@@ -298,15 +338,18 @@ var /**
         const coordsClone = coords.clone();
         const countRows = this.tableProps.countRows();
         const countCols = this.tableProps.countCols();
-        const isSingle = this.getActiveSelectedRange().clone().setTo(coords).isSingleHeader();
+        const isSingle = this.getActiveSelectedRange()?.clone().setTo(coords).isSingleHeader();
         // Ignore processing the end range when the header selection starts overlapping the corner and
         // the selection is not a single header highlight.
-        if ((countRows > 0 || countCols > 0) && (countRows === 0 && coordsClone.col < 0 && !isSingle || countCols === 0 && coordsClone.row < 0 && !isSingle)) {
+        if ((countRows > 0 || countCols > 0) && (countRows === 0 && (coordsClone.col ?? 0) < 0 && !isSingle || countCols === 0 && (coordsClone.row ?? 0) < 0 && !isSingle)) {
             return;
         }
         this.runLocalHooks('beforeSetRangeEnd', coordsClone);
         this.begin();
         const cellRange = this.getActiveSelectedRange();
+        if (!cellRange) {
+            return;
+        }
         if (!this.settings.navigableHeaders) {
             cellRange.highlight.normalize();
         }
@@ -320,12 +363,12 @@ var /**
             cellRange.setTo(coordsClone);
             if (isMultiple && (horizontalDir !== cellRange.getHorizontalDirection() || cellRange.getWidth() === 1 && !cellRange.includes(cellRange.highlight))) {
                 cellRange.from.assign({
-                    col: cellRange.highlight.col
+                    col: cellRange.highlight.col ?? undefined
                 });
             }
             if (isMultiple && (verticalDir !== cellRange.getVerticalDirection() || cellRange.getHeight() === 1 && !cellRange.includes(cellRange.highlight))) {
                 cellRange.from.assign({
-                    row: cellRange.highlight.row
+                    row: cellRange.highlight.row ?? undefined
                 });
             }
         }
@@ -336,8 +379,8 @@ var /**
             }
         }
         this.runLocalHooks('beforeHighlightSet');
-        this.setRangeFocus(this.getActiveSelectedRange().highlight, layerIndex);
-        this.applyAndCommit(this.getActiveSelectedRange(), layerIndex);
+        this.setRangeFocus(this.getActiveSelectedRange()?.highlight ?? cellRange.highlight, layerIndex);
+        this.applyAndCommit(this.getActiveSelectedRange() ?? cellRange, layerIndex);
         const isLastLayer = _class_private_field_get(this, _expectedLayersCount) === -1 || this.selectedRange.size() === _class_private_field_get(this, _expectedLayersCount);
         this.runLocalHooks('afterSetRangeEnd', coords, isLastLayer);
     }
@@ -348,6 +391,9 @@ var /**
    * @param {CellRange} [cellRange] The cell range to apply. If not provided, the current selection is used.
    * @param {number} [layerLevel] The layer level to apply. If not provided, the current layer level is used.
    */ applyAndCommit(cellRange = this.getActiveSelectedRange(), layerLevel = this.getLayerLevel()) {
+        if (!cellRange) {
+            return;
+        }
         const countRows = this.tableProps.countRows();
         const countCols = this.tableProps.countCols();
         this.highlight.useLayerLevel(layerLevel);
@@ -360,60 +406,33 @@ var /**
         const activeCornerHeaderHighlight = this.highlight.createActiveCornerHeader();
         const rowHighlight = this.highlight.createRowHighlight();
         const columnHighlight = this.highlight.createColumnHighlight();
-        areaHighlight.clear();
-        layeredAreaHighlight.clear();
-        rowHeaderHighlight.clear();
-        columnHeaderHighlight.clear();
-        activeRowHeaderHighlight.clear();
-        activeColumnHeaderHighlight.clear();
-        activeCornerHeaderHighlight.clear();
-        rowHighlight.clear();
-        columnHighlight.clear();
+        areaHighlight?.clear();
+        layeredAreaHighlight?.clear();
+        rowHeaderHighlight?.clear();
+        columnHeaderHighlight?.clear();
+        activeRowHeaderHighlight?.clear();
+        activeColumnHeaderHighlight?.clear();
+        activeCornerHeaderHighlight?.clear();
+        rowHighlight?.clear();
+        columnHighlight?.clear();
         if (this.highlight.isEnabledFor(_highlight.AREA_TYPE, cellRange.highlight) && (this.isMultiple() || layerLevel >= 1)) {
-            areaHighlight.add(cellRange.from).add(cellRange.to).commit();
-            layeredAreaHighlight.add(cellRange.from).add(cellRange.to).commit();
+            areaHighlight?.add(cellRange.from).add(cellRange.to).commit();
+            layeredAreaHighlight?.add(cellRange.from).add(cellRange.to).commit();
             if (layerLevel === 1) {
                 // For single cell selection in the same layer, we do not create area selection to prevent blue background.
                 // When non-consecutive selection is performed we have to add that missing area selection to the previous layer
                 // based on previous coordinates. It only occurs when the previous selection wasn't select multiple cells.
                 const previousRange = this.selectedRange.peekByIndex(layerLevel - 1);
-                this.highlight.useLayerLevel(layerLevel - 1);
-                this.highlight.createArea().add(previousRange.from).commit()// Range may start with hidden indexes. Commit would not found start point (as we add just the `from` coords).
-                .syncWith(previousRange);
-                this.highlight.createLayeredArea().add(previousRange.from).commit()// Range may start with hidden indexes. Commit would not found start point (as we add just the `from` coords).
-                .syncWith(previousRange);
-                this.highlight.useLayerLevel(layerLevel);
+                if (previousRange) {
+                    this.highlight.useLayerLevel(layerLevel - 1);
+                    this.highlight.createArea()?.add(previousRange.from).commit().syncWith(previousRange);
+                    this.highlight.createLayeredArea()?.add(previousRange.from).commit().syncWith(previousRange);
+                    this.highlight.useLayerLevel(layerLevel);
+                }
             }
         }
         if (this.highlight.isEnabledFor(_highlight.HEADER_TYPE, cellRange.highlight)) {
-            if (!cellRange.isSingleHeader()) {
-                const rowCoordsFrom = this.tableProps.createCellCoords(Math.max(cellRange.from.row, 0), -1);
-                const rowCoordsTo = this.tableProps.createCellCoords(cellRange.to.row, -1);
-                const columnCoordsFrom = this.tableProps.createCellCoords(-1, Math.max(cellRange.from.col, 0));
-                const columnCoordsTo = this.tableProps.createCellCoords(-1, cellRange.to.col);
-                if (this.settings.selectionMode === 'single') {
-                    rowHeaderHighlight.add(rowCoordsFrom).commit();
-                    columnHeaderHighlight.add(columnCoordsFrom).commit();
-                    rowHighlight.add(rowCoordsFrom).commit();
-                    columnHighlight.add(columnCoordsFrom).commit();
-                } else {
-                    rowHeaderHighlight.add(rowCoordsFrom).add(rowCoordsTo).commit();
-                    columnHeaderHighlight.add(columnCoordsFrom).add(columnCoordsTo).commit();
-                    rowHighlight.add(rowCoordsFrom).add(rowCoordsTo).commit();
-                    columnHighlight.add(columnCoordsFrom).add(columnCoordsTo).commit();
-                }
-            }
-            const highlightRowHeaders = !_class_private_field_get(this, _disableHeadersHighlight) && this.isEntireRowSelected() && (countCols > 0 && countCols === cellRange.getWidth() || countCols === 0 && this.isSelectedByRowHeader());
-            const highlightColumnHeaders = !_class_private_field_get(this, _disableHeadersHighlight) && this.isEntireColumnSelected() && (countRows > 0 && countRows === cellRange.getHeight() || countRows === 0 && this.isSelectedByColumnHeader());
-            if (highlightRowHeaders) {
-                activeRowHeaderHighlight.add(this.tableProps.createCellCoords(Math.max(cellRange.from.row, 0), Math.min(-this.tableProps.countRowHeaders(), -1))).add(this.tableProps.createCellCoords(Math.max(cellRange.to.row, 0), -1)).commit();
-            }
-            if (highlightColumnHeaders) {
-                activeColumnHeaderHighlight.add(this.tableProps.createCellCoords(Math.min(-this.tableProps.countColHeaders(), -1), Math.max(cellRange.from.col, 0))).add(this.tableProps.createCellCoords(-1, Math.max(cellRange.to.col, 0))).commit();
-            }
-            if (highlightRowHeaders && highlightColumnHeaders) {
-                activeCornerHeaderHighlight.add(this.tableProps.createCellCoords(-this.tableProps.countColHeaders(), -this.tableProps.countRowHeaders())).add(this.tableProps.createCellCoords(-1, -1)).commit();
-            }
+            _class_private_method_get(this, _applyHeaderHighlights, applyHeaderHighlights).call(this, cellRange, countRows, countCols, rowHeaderHighlight, columnHeaderHighlight, activeRowHeaderHighlight, activeColumnHeaderHighlight, activeCornerHeaderHighlight, rowHighlight, columnHighlight);
         }
     }
     /**
@@ -432,6 +451,9 @@ var /**
         if (!this.inProgress) {
             this.runLocalHooks('beforeSetFocus', coords);
         }
+        if (!cellRange) {
+            return;
+        }
         const focusHighlight = this.highlight.getFocus();
         focusHighlight.clear();
         cellRange.setHighlight(coords);
@@ -458,7 +480,7 @@ var /**
             return;
         }
         const { visualCoords } = _class_private_field_get(this, _extenderTransformation).transformStart(rowDelta, colDelta, createMissingRecords);
-        this.setRangeStart(visualCoords);
+        this.setRangeStart(visualCoords, undefined, false, visualCoords);
     }
     /**
    * Sets selection end cell relative to the current selection end cell (if possible).
@@ -498,21 +520,26 @@ var /**
             this.selectAll(true, true, {
                 disableHeadersHighlight: true
             });
-        } else if (this.isSelectedByColumnHeader() || range.getOuterTopStartCorner().row >= visualRowIndex) {
+        } else if (range && (this.isSelectedByColumnHeader() || (range.getOuterTopStartCorner().row ?? 0) >= visualRowIndex)) {
             const { from, to, highlight } = range;
             const countRows = this.tableProps.countRows();
             const isSelectedByRowHeader = this.isSelectedByRowHeader();
             const isSelectedByColumnHeader = this.isSelectedByColumnHeader();
             const minRow = isSelectedByColumnHeader ? -1 : 0;
             const coordsStartAmount = isSelectedByColumnHeader ? 0 : amount;
+            // After shifting, a single-row selection can land on a row that is hidden (e.g. removing a
+            // row next to a hidden one), leaving the highlight on a non-rendered row. Snap it to the
+            // nearest visible row (see snapToNearestVisible for the single-line scoping rationale).
+            const isSingleRow = from.row === to.row;
+            const clampToVisibleRow = (visualRow)=>snapToNearestVisible(this.tableProps.rowIndexMapper, visualRow, isSingleRow);
             // Remove from the stack the last added selection as that selection below will be
             // replaced by new transformed selection.
             this.getSelectedRange().pop();
-            const coordsStart = this.tableProps.createCellCoords((0, _number.clamp)(from.row + coordsStartAmount, minRow, countRows - 1), from.col);
-            const coordsEnd = this.tableProps.createCellCoords((0, _number.clamp)(to.row + amount, minRow, countRows - 1), to.col);
+            const coordsStart = this.tableProps.createCellCoords(clampToVisibleRow((0, _number.clamp)((from.row ?? 0) + coordsStartAmount, minRow, countRows - 1)), from.col ?? 0);
+            const coordsEnd = this.tableProps.createCellCoords(clampToVisibleRow((0, _number.clamp)((to.row ?? 0) + amount, minRow, countRows - 1)), to.col ?? 0);
             this.markSource('shift');
-            if (highlight.row >= visualRowIndex) {
-                this.setRangeStartOnly(coordsStart, true, this.tableProps.createCellCoords((0, _number.clamp)(highlight.row + amount, 0, countRows - 1), highlight.col));
+            if ((highlight.row ?? 0) >= visualRowIndex) {
+                this.setRangeStartOnly(coordsStart, true, this.tableProps.createCellCoords(clampToVisibleRow((0, _number.clamp)((highlight.row ?? 0) + amount, 0, countRows - 1)), highlight.col ?? 0));
             } else {
                 this.setRangeStartOnly(coordsStart, true);
             }
@@ -540,21 +567,26 @@ var /**
             this.selectAll(true, true, {
                 disableHeadersHighlight: true
             });
-        } else if (this.isSelectedByRowHeader() || range.getOuterTopStartCorner().col >= visualColumnIndex) {
+        } else if (range && (this.isSelectedByRowHeader() || (range.getOuterTopStartCorner().col ?? 0) >= visualColumnIndex)) {
             const { from, to, highlight } = range;
             const countCols = this.tableProps.countCols();
             const isSelectedByRowHeader = this.isSelectedByRowHeader();
             const isSelectedByColumnHeader = this.isSelectedByColumnHeader();
             const minColumn = isSelectedByRowHeader ? -1 : 0;
             const coordsStartAmount = isSelectedByRowHeader ? 0 : amount;
+            // After shifting, a single-column selection can land on a column that is hidden (e.g. removing
+            // a column next to a hidden one), leaving the highlight on a non-rendered column. Snap it to
+            // the nearest visible column (see snapToNearestVisible for the single-line scoping rationale).
+            const isSingleColumn = from.col === to.col;
+            const clampToVisibleColumn = (visualColumn)=>snapToNearestVisible(this.tableProps.columnIndexMapper, visualColumn, isSingleColumn);
             // Remove from the stack the last added selection as that selection below will be
             // replaced by new transformed selection.
             this.getSelectedRange().pop();
-            const coordsStart = this.tableProps.createCellCoords(from.row, (0, _number.clamp)(from.col + coordsStartAmount, minColumn, countCols - 1));
-            const coordsEnd = this.tableProps.createCellCoords(to.row, (0, _number.clamp)(to.col + amount, minColumn, countCols - 1));
+            const coordsStart = this.tableProps.createCellCoords(from.row ?? 0, clampToVisibleColumn((0, _number.clamp)((from.col ?? 0) + coordsStartAmount, minColumn, countCols - 1)));
+            const coordsEnd = this.tableProps.createCellCoords(to.row ?? 0, clampToVisibleColumn((0, _number.clamp)((to.col ?? 0) + amount, minColumn, countCols - 1)));
             this.markSource('shift');
-            if (highlight.col >= visualColumnIndex) {
-                this.setRangeStartOnly(coordsStart, true, this.tableProps.createCellCoords(highlight.row, (0, _number.clamp)(highlight.col + amount, 0, countCols - 1)));
+            if ((highlight.col ?? 0) >= visualColumnIndex) {
+                this.setRangeStartOnly(coordsStart, true, this.tableProps.createCellCoords(highlight.row ?? 0, clampToVisibleColumn((0, _number.clamp)((highlight.col ?? 0) + amount, 0, countCols - 1))));
             } else {
                 this.setRangeStartOnly(coordsStart, true);
             }
@@ -589,7 +621,7 @@ var /**
    * @param {CellRange} [cellRange] The cell range to check. If not provided, the latest selection layer is used.
    * @returns {boolean}
    */ isMultiple(cellRange = this.getActiveSelectedRange()) {
-        if (!this.isSelected()) {
+        if (!this.isSelected() || !cellRange) {
             return false;
         }
         const isMultipleListener = (0, _object.createObjectPropListener)(!cellRange.isSingle());
@@ -611,7 +643,7 @@ var /**
    * @param {number} [layerLevel=this.getLayerLevel()] Selection layer level to check.
    * @returns {boolean}
    */ isSelectedByRowHeader(layerLevel = this.getLayerLevel()) {
-        return !this.isSelectedByCorner(layerLevel) && (layerLevel === -1 ? this.selectedByRowHeader.size > 0 : this.selectedByRowHeader.has(layerLevel));
+        return !this.isSelectedByCorner() && (layerLevel === -1 ? this.selectedByRowHeader.size > 0 : this.selectedByRowHeader.has(layerLevel));
     }
     /**
    * Returns `true` if the selection consists of entire rows (including their headers). If the `layerLevel`
@@ -624,7 +656,7 @@ var /**
             const { col } = range.getOuterTopStartCorner();
             const rowHeaders = this.tableProps.countRowHeaders();
             const countCols = this.tableProps.countCols();
-            return (rowHeaders > 0 && col < 0 || rowHeaders === 0) && range.getWidth() === countCols;
+            return (rowHeaders > 0 && (col ?? 0) < 0 || rowHeaders === 0) && range.getWidth() === countCols;
         };
         if (layerLevel === -1) {
             return Array.from(this.selectedRange).some((range)=>tester(range));
@@ -653,7 +685,7 @@ var /**
             const { row } = range.getOuterTopStartCorner();
             const colHeaders = this.tableProps.countColHeaders();
             const countRows = this.tableProps.countRows();
-            return (colHeaders > 0 && row < 0 || colHeaders === 0) && range.getHeight() === countRows;
+            return (colHeaders > 0 && (row ?? 0) < 0 || colHeaders === 0) && range.getHeight() === countRows;
         };
         if (layerLevel === -1) {
             return Array.from(this.selectedRange).some((range)=>tester(range));
@@ -760,7 +792,7 @@ var /**
         }
         let highlight = this.getActiveSelectedRange()?.highlight;
         const { focusPosition, disableHeadersHighlight } = options;
-        if (focusPosition && Number.isInteger(focusPosition?.row) && Number.isInteger(focusPosition?.col)) {
+        if (isFocusPositionObject(focusPosition)) {
             highlight = this.tableProps.createCellCoords((0, _number.clamp)(focusPosition.row, rowFrom, nrOfRows - 1), (0, _number.clamp)(focusPosition.col, columnFrom, nrOfColumns - 1));
         }
         const startCoords = this.tableProps.createCellCoords(rowFrom, columnFrom);
@@ -768,7 +800,7 @@ var /**
         this.clear();
         this.runLocalHooks('beforeSelectAll', startCoords, endCoords, highlight);
         this.setRangeStartOnly(startCoords, undefined, highlight);
-        _class_private_field_set(this, _disableHeadersHighlight, disableHeadersHighlight);
+        _class_private_field_set(this, _disableHeadersHighlight, disableHeadersHighlight ?? false);
         if (columnFrom < 0) {
             this.selectedByRowHeader.add(this.getLayerLevel());
         }
@@ -818,7 +850,7 @@ var /**
         if (isValid) {
             this.clear();
             this.setExpectedLayers(selectionRanges.length);
-            (0, _array.arrayEach)(selectionRanges, (selection)=>{
+            selectionRanges.forEach((selection)=>{
                 const { from, to } = selectionSchemaNormalizer(selection);
                 this.setRangeStartOnly(from.clone(), false);
                 this.setRangeEnd(to.clone());
@@ -856,15 +888,15 @@ var /**
         if (isValid) {
             let highlightRow = 0;
             let highlightColumn = 0;
-            if (Number.isInteger(focusPosition?.row) && Number.isInteger(focusPosition?.col)) {
-                highlightRow = (0, _number.clamp)(focusPosition.row, columnHeaderLastIndex, countRows - 1);
-                highlightColumn = (0, _number.clamp)(focusPosition.col, Math.min(start, end), Math.max(start, end));
+            if (isFocusPositionObject(focusPosition)) {
+                highlightRow = (0, _number.clamp)(focusPosition.row ?? 0, columnHeaderLastIndex, countRows - 1);
+                highlightColumn = (0, _number.clamp)(focusPosition.col ?? 0, Math.min(start, end), Math.max(start, end));
             } else {
-                highlightRow = (0, _number.clamp)(focusPosition, columnHeaderLastIndex, countRows - 1);
+                highlightRow = (0, _number.clamp)(typeof focusPosition === 'number' ? focusPosition : 0, columnHeaderLastIndex, countRows - 1);
                 highlightColumn = start;
             }
             const highlight = this.tableProps.createCellCoords(highlightRow, highlightColumn);
-            const fromRow = countColHeaders === 0 ? 0 : (0, _number.clamp)(highlight.row, columnHeaderLastIndex, -1);
+            const fromRow = countColHeaders === 0 ? 0 : (0, _number.clamp)(highlight.row ?? 0, columnHeaderLastIndex, -1);
             const toRow = countRows - 1;
             const from = this.tableProps.createCellCoords(fromRow, start);
             const to = this.tableProps.createCellCoords(toRow, end);
@@ -903,15 +935,15 @@ var /**
         if (isValid) {
             let highlightRow = 0;
             let highlightColumn = 0;
-            if (Number.isInteger(focusPosition?.row) && Number.isInteger(focusPosition?.col)) {
-                highlightRow = (0, _number.clamp)(focusPosition.row, Math.min(startRow, endRow), Math.max(startRow, endRow));
-                highlightColumn = (0, _number.clamp)(focusPosition.col, rowHeaderLastIndex, countCols - 1);
+            if (isFocusPositionObject(focusPosition)) {
+                highlightRow = (0, _number.clamp)(focusPosition.row ?? 0, Math.min(startRow, endRow), Math.max(startRow, endRow));
+                highlightColumn = (0, _number.clamp)(focusPosition.col ?? 0, rowHeaderLastIndex, countCols - 1);
             } else {
                 highlightRow = startRow;
-                highlightColumn = (0, _number.clamp)(focusPosition, rowHeaderLastIndex, countCols - 1);
+                highlightColumn = (0, _number.clamp)(typeof focusPosition === 'number' ? focusPosition : 0, rowHeaderLastIndex, countCols - 1);
             }
             const highlight = this.tableProps.createCellCoords(highlightRow, highlightColumn);
-            const fromColumn = countRowHeaders === 0 ? 0 : (0, _number.clamp)(highlight.col, rowHeaderLastIndex, -1);
+            const fromColumn = countRowHeaders === 0 ? 0 : (0, _number.clamp)(highlight.col ?? 0, rowHeaderLastIndex, -1);
             const toColumn = countCols - 1;
             const from = this.tableProps.createCellCoords(startRow, fromColumn);
             const to = this.tableProps.createCellCoords(endRow, toColumn);
@@ -992,16 +1024,16 @@ var /**
             const maxRows = countRows - 1;
             const maxColumns = countColumns - 1;
             highlight.assign({
-                row: (0, _number.clamp)(highlight.row, this.settings.navigableHeaders ? -Infinity : 0, maxRows),
-                col: (0, _number.clamp)(highlight.col, this.settings.navigableHeaders ? -Infinity : 0, maxColumns)
+                row: (0, _number.clamp)(highlight.row ?? 0, this.settings.navigableHeaders ? -Infinity : 0, maxRows),
+                col: (0, _number.clamp)(highlight.col ?? 0, this.settings.navigableHeaders ? -Infinity : 0, maxColumns)
             });
             from.assign({
-                row: (0, _number.clamp)(from.row, -Infinity, maxRows),
-                col: (0, _number.clamp)(from.col, -Infinity, maxColumns)
+                row: (0, _number.clamp)(from.row ?? 0, -Infinity, maxRows),
+                col: (0, _number.clamp)(from.col ?? 0, -Infinity, maxColumns)
             });
             to.assign({
-                row: (0, _number.clamp)(to.row, -Infinity, maxRows),
-                col: (0, _number.clamp)(to.col, -Infinity, maxColumns)
+                row: (0, _number.clamp)(to.row ?? 0, -Infinity, maxRows),
+                col: (0, _number.clamp)(to.col ?? 0, -Infinity, maxColumns)
             });
             this.setRangeStartOnly(from, true, highlight);
             this.setRangeEnd(to);
@@ -1026,7 +1058,7 @@ var /**
         }
         const currentLayer = this.getLayerLevel();
         const cellRange = this.getActiveSelectedRange();
-        if (this.highlight.isEnabledFor(_highlight.FOCUS_TYPE, cellRange.highlight)) {
+        if (cellRange && this.highlight.isEnabledFor(_highlight.FOCUS_TYPE, cellRange.highlight)) {
             this.highlight.getFocus().commit().syncWith(cellRange);
         }
         // Rewriting rendered ranges going through all layers.
@@ -1041,25 +1073,36 @@ var /**
             const activeCornerHeaderHighlight = this.highlight.createActiveCornerHeader();
             const rowHighlight = this.highlight.createRowHighlight();
             const columnHighlight = this.highlight.createColumnHighlight();
-            areaHighlight.commit();
-            areaLayeredHighlight.commit();
-            rowHeaderHighlight.commit();
-            columnHeaderHighlight.commit();
-            activeRowHeaderHighlight.commit();
-            activeColumnHeaderHighlight.commit();
-            activeCornerHeaderHighlight.commit();
-            rowHighlight.commit();
-            columnHighlight.commit();
+            areaHighlight?.commit();
+            areaLayeredHighlight?.commit();
+            rowHeaderHighlight?.commit();
+            columnHeaderHighlight?.commit();
+            activeRowHeaderHighlight?.commit();
+            activeColumnHeaderHighlight?.commit();
+            activeCornerHeaderHighlight?.commit();
+            rowHighlight?.commit();
+            columnHighlight?.commit();
         }
         // Reverting starting layer for the Highlight.
         this.highlight.useLayerLevel(currentLayer);
     }
-    constructor(settings, tableProps){
-        _class_private_field_init(this, _extenderTransformation, {
+    /**
+   * Initializes the Selection manager with grid settings and table API references, and sets up transformation modules and highlight layers.
+   */ constructor(settings, tableProps){
+        _class_private_method_init(this, _applyHeaderHighlights);
+        /**
+   * The module for modifying coordinates of the start and end selection.
+   *
+   * @type {ExtenderTransformation}
+   */ _class_private_field_init(this, _extenderTransformation, {
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _focusTransformation, {
+        /**
+   * The module for modifying coordinates of the focus selection.
+   *
+   * @type {FocusTransformation}
+   */ _class_private_field_init(this, _focusTransformation, {
             writable: true,
             value: void 0
         });
@@ -1125,8 +1168,8 @@ var /**
             rowIndexMapper: this.tableProps.rowIndexMapper,
             columnIndexMapper: this.tableProps.columnIndexMapper,
             disabledCellSelection: (row, column)=>this.tableProps.isDisabledCellSelection(row, column),
-            cellCornerVisible: (...args)=>this.isCellCornerVisible(...args),
-            areaCornerVisible: (...args)=>this.isAreaCornerVisible(...args),
+            cellCornerVisible: ()=>this.isCellCornerVisible(),
+            areaCornerVisible: (layerLevel)=>this.isAreaCornerVisible(layerLevel),
             visualToRenderableCoords: (coords)=>this.tableProps.visualToRenderableCoords(coords),
             renderableToVisualCoords: (coords)=>this.tableProps.renderableToVisualCoords(coords),
             createCellCoords: (row, column)=>this.tableProps.createCellCoords(row, column),
@@ -1134,16 +1177,16 @@ var /**
         });
         _class_private_field_set(this, _extenderTransformation, new _transformation.ExtenderTransformation(this.selectedRange, {
             ...this.tableProps,
-            navigableHeaders: ()=>settings.navigableHeaders,
-            fixedRowsBottom: ()=>settings.fixedRowsBottom,
-            minSpareRows: ()=>settings.minSpareRows,
-            minSpareCols: ()=>settings.minSpareCols,
-            autoWrapRow: ()=>settings.autoWrapRow,
-            autoWrapCol: ()=>settings.autoWrapCol
+            navigableHeaders: ()=>!!settings.navigableHeaders,
+            fixedRowsBottom: ()=>Number(settings.fixedRowsBottom),
+            minSpareRows: ()=>Number(settings.minSpareRows),
+            minSpareCols: ()=>Number(settings.minSpareCols),
+            autoWrapRow: ()=>!!settings.autoWrapRow,
+            autoWrapCol: ()=>!!settings.autoWrapCol
         }));
         _class_private_field_set(this, _focusTransformation, new _transformation.FocusTransformation(this.selectedRange, {
             ...this.tableProps,
-            navigableHeaders: ()=>settings.navigableHeaders,
+            navigableHeaders: ()=>!!settings.navigableHeaders,
             fixedRowsBottom: ()=>0,
             minSpareRows: ()=>0,
             minSpareCols: ()=>0,
@@ -1162,5 +1205,35 @@ var /**
         _class_private_field_get(this, _focusTransformation).addLocalHook('afterTransformStart', (...args)=>this.runLocalHooks('afterModifyTransformFocus', ...args));
     }
 }
+function applyHeaderHighlights(cellRange, countRows, countCols, rowHeaderHighlight, columnHeaderHighlight, activeRowHeaderHighlight, activeColumnHeaderHighlight, activeCornerHeaderHighlight, rowHighlight, columnHighlight) {
+    if (!cellRange.isSingleHeader()) {
+        const rowCoordsFrom = this.tableProps.createCellCoords(Math.max(cellRange.from.row ?? 0, 0), -1);
+        const rowCoordsTo = this.tableProps.createCellCoords(cellRange.to.row ?? 0, -1);
+        const columnCoordsFrom = this.tableProps.createCellCoords(-1, Math.max(cellRange.from.col ?? 0, 0));
+        const columnCoordsTo = this.tableProps.createCellCoords(-1, cellRange.to.col ?? 0);
+        if (this.settings.selectionMode === 'single') {
+            rowHeaderHighlight?.add(rowCoordsFrom).commit();
+            columnHeaderHighlight?.add(columnCoordsFrom).commit();
+            rowHighlight?.add(rowCoordsFrom).commit();
+            columnHighlight?.add(columnCoordsFrom).commit();
+        } else {
+            rowHeaderHighlight?.add(rowCoordsFrom).add(rowCoordsTo).commit();
+            columnHeaderHighlight?.add(columnCoordsFrom).add(columnCoordsTo).commit();
+            rowHighlight?.add(rowCoordsFrom).add(rowCoordsTo).commit();
+            columnHighlight?.add(columnCoordsFrom).add(columnCoordsTo).commit();
+        }
+    }
+    const highlightRowHeaders = !_class_private_field_get(this, _disableHeadersHighlight) && this.isEntireRowSelected() && (countCols > 0 && countCols === cellRange.getWidth() || countCols === 0 && this.isSelectedByRowHeader());
+    const highlightColumnHeaders = !_class_private_field_get(this, _disableHeadersHighlight) && this.isEntireColumnSelected() && (countRows > 0 && countRows === cellRange.getHeight() || countRows === 0 && this.isSelectedByColumnHeader());
+    if (highlightRowHeaders) {
+        activeRowHeaderHighlight?.add(this.tableProps.createCellCoords(Math.max(cellRange.from.row ?? 0, 0), Math.min(-this.tableProps.countRowHeaders(), -1))).add(this.tableProps.createCellCoords(Math.max(cellRange.to.row ?? 0, 0), -1)).commit();
+    }
+    if (highlightColumnHeaders) {
+        activeColumnHeaderHighlight?.add(this.tableProps.createCellCoords(Math.min(-this.tableProps.countColHeaders(), -1), Math.max(cellRange.from.col ?? 0, 0))).add(this.tableProps.createCellCoords(-1, Math.max(cellRange.to.col ?? 0, 0))).commit();
+    }
+    if (highlightRowHeaders && highlightColumnHeaders) {
+        activeCornerHeaderHighlight?.add(this.tableProps.createCellCoords(-this.tableProps.countColHeaders(), -this.tableProps.countRowHeaders())).add(this.tableProps.createCellCoords(-1, -1)).commit();
+    }
+}
 (0, _object.mixin)(Selection, _localHooks.default);
 const _default = Selection;