handsontable 0.0.0-next-5a535ed-20240403 → 0.0.0-next-c2810a1-20240403

package/core/viewportScroll/scrollStrategies/focusScroll.mjs

@@ -0,0 +1,11 @@
+/**
+ * Scroll strategy for changed the focus position of the selection.
+ *
+ * @param {Core} hot Handsontable instance.
+ * @returns {function(): function(CellCoords): void}
+ */
+export function focusScrollStrategy(hot) {
+  return cellCoords => {
+    hot.scrollViewportTo(cellCoords.toObject());
+  };
+}

package/core.d.ts

@@ -3,6 +3,7 @@ import { Events } from './pluginHooks';
 import {
   CellValue,
   RowObject,
+  SimpleCellCoords,
 } from './common';
 import {
   GridSettings,
@@ -135,12 +136,12 @@ export default class Core {
   scrollViewportTo(options: { row?: number, col?: number, verticalSnap?: 'top' | 'bottom', horizontalSnap?: 'start' | 'end', considerHiddenIndexes?: boolean }): boolean;
   scrollViewportTo(row?: number, column?: number, snapToBottom?: boolean, snapToRight?: boolean, considerHiddenIndexes?: boolean): boolean;
   scrollToFocusedCell(callback?: () => void): void;
-  selectAll(includeRowHeaders?: boolean, includeColumnHeaders?: boolean, options?: { focusPosition?: { row: number, col: number }, disableHeadersHighlight?: boolean }): void;
+  selectAll(includeRowHeaders?: boolean, includeColumnHeaders?: boolean, options?: { focusPosition?: SimpleCellCoords | CellCoords, disableHeadersHighlight?: boolean }): void;
   selectCell(row: number, column: number, endRow?: number, endColumn?: number, scrollToCell?: boolean, changeListener?: boolean): boolean;
   selectCellByProp(row: number, prop: string, endRow?: number, endProp?: string, scrollToCell?: boolean): boolean;
   selectCells(coords: Array<[number, number | string, number, number | string]> | CellRange[], scrollToCell?: boolean, changeListener?: boolean): boolean;
-  selectColumns(startColumn: number | string, endColumn?: number | string, focusPosition?: number): boolean;
-  selectRows(startRow: number, endRow?: number, focusPosition?: number): boolean;
+  selectColumns(startColumn: number | string, endColumn?: number | string, focusPosition?: number | SimpleCellCoords | CellCoords): boolean;
+  selectRows(startRow: number, endRow?: number, focusPosition?: number | SimpleCellCoords | CellCoords): boolean;
   setCellMeta(row: number, column: number, key: string, val: any): void;
   setCellMeta<K extends keyof CellMeta>(row: number, column: number, key: K, val: CellMeta[K]): void;
   setCellMetaObject(row: number, column: number, prop: CellMeta): void;

package/core.js

@@ -2,8 +2,8 @@
 
 exports.__esModule = true;
 exports.default = Core;
-require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.array.push.js");
 require("core-js/modules/web.immediate.js");
 var _element = require("./helpers/dom/element");
 var _function = require("./helpers/function");
@@ -273,6 +273,26 @@ function Core(rootElement, userSettings) {
     renderableRow >= 0 ? instance.rowIndexMapper.getVisualFromRenderableIndex(renderableRow) : renderableRow, renderableColumn >= 0 ? instance.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn) : renderableColumn // eslint-disable-line max-len
     );
   };
+  const findFirstNonHiddenRenderableRow = (visualRowFrom, visualRowTo) => {
+    const dir = visualRowTo > visualRowFrom ? 1 : -1;
+    const minIndex = Math.min(visualRowFrom, visualRowTo);
+    const maxIndex = Math.max(visualRowFrom, visualRowTo);
+    const rowIndex = instance.rowIndexMapper.getNearestNotHiddenIndex(visualRowFrom, dir);
+    if (rowIndex === null || dir === 1 && rowIndex > maxIndex || dir === -1 && rowIndex < minIndex) {
+      return null;
+    }
+    return rowIndex >= 0 ? instance.rowIndexMapper.getRenderableFromVisualIndex(rowIndex) : rowIndex;
+  };
+  const findFirstNonHiddenRenderableColumn = (visualColumnFrom, visualColumnTo) => {
+    const dir = visualColumnTo > visualColumnFrom ? 1 : -1;
+    const minIndex = Math.min(visualColumnFrom, visualColumnTo);
+    const maxIndex = Math.max(visualColumnFrom, visualColumnTo);
+    const columnIndex = instance.columnIndexMapper.getNearestNotHiddenIndex(visualColumnFrom, dir);
+    if (columnIndex === null || dir === 1 && columnIndex > maxIndex || dir === -1 && columnIndex < minIndex) {
+      return null;
+    }
+    return columnIndex >= 0 ? instance.columnIndexMapper.getRenderableFromVisualIndex(columnIndex) : columnIndex;
+  };
   let selection = new _selection.Selection(tableMeta, {
     rowIndexMapper: instance.rowIndexMapper,
     columnIndexMapper: instance.columnIndexMapper,
@@ -284,11 +304,19 @@ function Core(rootElement, userSettings) {
     countRenderableRows: () => this.view.countRenderableRows(),
     countRowHeaders: () => this.countRowHeaders(),
     countColHeaders: () => this.countColHeaders(),
+    countRenderableRowsInRange: function () {
+      return _this.view.countRenderableRowsInRange(...arguments);
+    },
+    countRenderableColumnsInRange: function () {
+      return _this.view.countRenderableColumnsInRange(...arguments);
+    },
     getShortcutManager: () => instance.getShortcutManager(),
     createCellCoords: (row, column) => instance._createCellCoords(row, column),
     createCellRange: (highlight, from, to) => instance._createCellRange(highlight, from, to),
     visualToRenderableCoords,
     renderableToVisualCoords,
+    findFirstNonHiddenRenderableRow,
+    findFirstNonHiddenRenderableColumn,
     isDisabledCellSelection: (visualRow, visualColumn) => {
       if (visualRow < 0 || visualColumn < 0) {
         return instance.getSettings().disableVisualSelection;
@@ -339,6 +367,17 @@ function Core(rootElement, userSettings) {
     }
     this._refreshBorders(null);
   });
+  this.selection.addLocalHook('beforeSetFocus', cellCoords => {
+    this.runHooks('beforeSelectionFocusSet', cellCoords.row, cellCoords.col);
+  });
+  this.selection.addLocalHook('afterSetFocus', cellCoords => {
+    const preventScrolling = (0, _object.createObjectPropListener)(false);
+    this.runHooks('afterSelectionFocusSet', cellCoords.row, cellCoords.col, preventScrolling);
+    if (!preventScrolling.isTouched() || preventScrolling.isTouched() && !preventScrolling.value) {
+      viewportScroller.scrollTo(cellCoords);
+    }
+    this._refreshBorders(null);
+  });
   this.selection.addLocalHook('afterSelectionFinished', cellRanges => {
     const selectionLayerLevel = cellRanges.length - 1;
     const {
@@ -405,25 +444,35 @@ function Core(rootElement, userSettings) {
       args[_key9] = arguments[_key9];
     }
     return _this.runHooks('afterModifyTransformStart', ...args);
-  }).addLocalHook('beforeModifyTransformEnd', function () {
+  }).addLocalHook('beforeModifyTransformFocus', function () {
     for (var _len10 = arguments.length, args = new Array(_len10), _key10 = 0; _key10 < _len10; _key10++) {
       args[_key10] = arguments[_key10];
     }
-    return _this.runHooks('modifyTransformEnd', ...args);
-  }).addLocalHook('afterModifyTransformEnd', function () {
+    return _this.runHooks('modifyTransformFocus', ...args);
+  }).addLocalHook('afterModifyTransformFocus', function () {
     for (var _len11 = arguments.length, args = new Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
       args[_key11] = arguments[_key11];
     }
-    return _this.runHooks('afterModifyTransformEnd', ...args);
-  }).addLocalHook('beforeRowWrap', function () {
+    return _this.runHooks('afterModifyTransformFocus', ...args);
+  }).addLocalHook('beforeModifyTransformEnd', function () {
     for (var _len12 = arguments.length, args = new Array(_len12), _key12 = 0; _key12 < _len12; _key12++) {
       args[_key12] = arguments[_key12];
     }
-    return _this.runHooks('beforeRowWrap', ...args);
-  }).addLocalHook('beforeColumnWrap', function () {
+    return _this.runHooks('modifyTransformEnd', ...args);
+  }).addLocalHook('afterModifyTransformEnd', function () {
     for (var _len13 = arguments.length, args = new Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
       args[_key13] = arguments[_key13];
     }
+    return _this.runHooks('afterModifyTransformEnd', ...args);
+  }).addLocalHook('beforeRowWrap', function () {
+    for (var _len14 = arguments.length, args = new Array(_len14), _key14 = 0; _key14 < _len14; _key14++) {
+      args[_key14] = arguments[_key14];
+    }
+    return _this.runHooks('beforeRowWrap', ...args);
+  }).addLocalHook('beforeColumnWrap', function () {
+    for (var _len15 = arguments.length, args = new Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
+      args[_key15] = arguments[_key15];
+    }
     return _this.runHooks('beforeColumnWrap', ...args);
   }).addLocalHook('insertRowRequire', totalRows => this.alter('insert_row_above', totalRows, 1, 'auto')).addLocalHook('insertColRequire', totalCols => this.alter('insert_col_start', totalCols, 1, 'auto'));
   grid = {
@@ -1561,8 +1610,8 @@ function Core(rootElement, userSettings) {
    * @returns {Array} Returns removed portion of columns.
    */
   this.spliceCol = function (column, index, amount) {
-    for (var _len14 = arguments.length, elements = new Array(_len14 > 3 ? _len14 - 3 : 0), _key14 = 3; _key14 < _len14; _key14++) {
-      elements[_key14 - 3] = arguments[_key14];
+    for (var _len16 = arguments.length, elements = new Array(_len16 > 3 ? _len16 - 3 : 0), _key16 = 3; _key16 < _len16; _key16++) {
+      elements[_key16 - 3] = arguments[_key16];
     }
     return datamap.spliceCol(column, index, amount, ...elements);
   };
@@ -1579,8 +1628,8 @@ function Core(rootElement, userSettings) {
    * @returns {Array} Returns removed portion of rows.
    */
   this.spliceRow = function (row, index, amount) {
-    for (var _len15 = arguments.length, elements = new Array(_len15 > 3 ? _len15 - 3 : 0), _key15 = 3; _key15 < _len15; _key15++) {
-      elements[_key15 - 3] = arguments[_key15];
+    for (var _len17 = arguments.length, elements = new Array(_len17 > 3 ? _len17 - 3 : 0), _key17 = 3; _key17 < _len17; _key17++) {
+      elements[_key17 - 3] = arguments[_key17];
     }
     return datamap.spliceRow(row, index, amount, ...elements);
   };
@@ -2977,8 +3026,8 @@ function Core(rootElement, userSettings) {
    */
   this.spliceCellsMeta = function (visualIndex) {
     let deleteAmount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    for (var _len16 = arguments.length, cellMetaRows = new Array(_len16 > 2 ? _len16 - 2 : 0), _key16 = 2; _key16 < _len16; _key16++) {
-      cellMetaRows[_key16 - 2] = arguments[_key16];
+    for (var _len18 = arguments.length, cellMetaRows = new Array(_len18 > 2 ? _len18 - 2 : 0), _key18 = 2; _key18 < _len18; _key18++) {
+      cellMetaRows[_key18 - 2] = arguments[_key18];
     }
     if (cellMetaRows.length > 0 && !Array.isArray(cellMetaRows[0])) {
       throw new Error('The 3rd argument (cellMetaRows) has to be passed as an array of cell meta objects array.');
@@ -3900,6 +3949,8 @@ function Core(rootElement, userSettings) {
    * hot.selectColumns(1, 2, -1);
    * // Select range of columns using visual indexes and mark the second cell as highlighted.
    * hot.selectColumns(2, 1, 1);
+   * // Select range of columns using visual indexes and move the focus position somewhere in the middle of the range.
+   * hot.selectColumns(2, 5, { row: 2, col: 3 });
    * // Select range of columns using column properties.
    * hot.selectColumns('id', 'last_name');
    * ```
@@ -3909,10 +3960,11 @@ function Core(rootElement, userSettings) {
    * @function selectColumns
    * @param {number} startColumn The visual column index from which the selection starts.
    * @param {number} [endColumn=startColumn] The visual column index to which the selection finishes. If `endColumn`
-   *                                         is not defined the column defined by `startColumn` will be selected.
-   * @param {number} [focusPosition=0] The argument allows changing the cell/header focus position.
-   *                                   The value can take visual row index from -N to N, where negative values
-   *                                   point to the headers and positive values point to the cell range.
+   * is not defined the column defined by `startColumn` will be selected.
+   * @param {number | { row: number, col: number } | CellCoords} [focusPosition=0] The argument allows changing the cell/header focus
+   * position. The value can take visual row index from -N to N, where negative values point to the headers and positive
+   * values point to the cell range. An object with `row` and `col` properties also can be passed to change the focus
+   * position horizontally.
    * @returns {boolean} `true` if selection was successful, `false` otherwise.
    */
   this.selectColumns = function (startColumn) {
@@ -3934,6 +3986,8 @@ function Core(rootElement, userSettings) {
    * hot.selectRows(1, 2, -1);
    * // Select range of rows using visual indexes and mark the second cell as highlighted.
    * hot.selectRows(2, 1, 1);
+   * // Select range of rows using visual indexes and move the focus position somewhere in the middle of the range.
+   * hot.selectRows(2, 5, { row: 2, col: 3 });
    * ```
    *
    * @memberof Core#
@@ -3941,10 +3995,11 @@ function Core(rootElement, userSettings) {
    * @function selectRows
    * @param {number} startRow The visual row index from which the selection starts.
    * @param {number} [endRow=startRow] The visual row index to which the selection finishes. If `endRow`
-   *                                   is not defined the row defined by `startRow` will be selected.
-   * @param {number} [focusPosition=0] The argument allows changing the cell/header focus position.
-   *                                   The value can take visual column index from -N to N, where negative values
-   *                                   point to the headers and positive values point to the cell range.
+   * is not defined the row defined by `startRow` will be selected.
+   * @param {number | { row: number, col: number } | CellCoords} [focusPosition=0] The argument allows changing the cell/header focus
+   * position. The value can take visual row index from -N to N, where negative values point to the headers and positive
+   * values point to the cell range. An object with `row` and `col` properties also can be passed to change the focus
+   * position vertically.
    * @returns {boolean} `true` if selection was successful, `false` otherwise.
    */
   this.selectRows = function (startRow) {

package/core.mjs

@@ -1,5 +1,5 @@
-import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
+import "core-js/modules/es.array.push.js";
 import "core-js/modules/web.immediate.js";
 import { addClass, empty, observeVisibilityChangeOnce, removeClass } from "./helpers/dom/element.mjs";
 import { isFunction } from "./helpers/function.mjs";
@@ -268,6 +268,26 @@ export default function Core(rootElement, userSettings) {
     renderableRow >= 0 ? instance.rowIndexMapper.getVisualFromRenderableIndex(renderableRow) : renderableRow, renderableColumn >= 0 ? instance.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn) : renderableColumn // eslint-disable-line max-len
     );
   };
+  const findFirstNonHiddenRenderableRow = (visualRowFrom, visualRowTo) => {
+    const dir = visualRowTo > visualRowFrom ? 1 : -1;
+    const minIndex = Math.min(visualRowFrom, visualRowTo);
+    const maxIndex = Math.max(visualRowFrom, visualRowTo);
+    const rowIndex = instance.rowIndexMapper.getNearestNotHiddenIndex(visualRowFrom, dir);
+    if (rowIndex === null || dir === 1 && rowIndex > maxIndex || dir === -1 && rowIndex < minIndex) {
+      return null;
+    }
+    return rowIndex >= 0 ? instance.rowIndexMapper.getRenderableFromVisualIndex(rowIndex) : rowIndex;
+  };
+  const findFirstNonHiddenRenderableColumn = (visualColumnFrom, visualColumnTo) => {
+    const dir = visualColumnTo > visualColumnFrom ? 1 : -1;
+    const minIndex = Math.min(visualColumnFrom, visualColumnTo);
+    const maxIndex = Math.max(visualColumnFrom, visualColumnTo);
+    const columnIndex = instance.columnIndexMapper.getNearestNotHiddenIndex(visualColumnFrom, dir);
+    if (columnIndex === null || dir === 1 && columnIndex > maxIndex || dir === -1 && columnIndex < minIndex) {
+      return null;
+    }
+    return columnIndex >= 0 ? instance.columnIndexMapper.getRenderableFromVisualIndex(columnIndex) : columnIndex;
+  };
   let selection = new Selection(tableMeta, {
     rowIndexMapper: instance.rowIndexMapper,
     columnIndexMapper: instance.columnIndexMapper,
@@ -279,11 +299,19 @@ export default function Core(rootElement, userSettings) {
     countRenderableRows: () => this.view.countRenderableRows(),
     countRowHeaders: () => this.countRowHeaders(),
     countColHeaders: () => this.countColHeaders(),
+    countRenderableRowsInRange: function () {
+      return _this.view.countRenderableRowsInRange(...arguments);
+    },
+    countRenderableColumnsInRange: function () {
+      return _this.view.countRenderableColumnsInRange(...arguments);
+    },
     getShortcutManager: () => instance.getShortcutManager(),
     createCellCoords: (row, column) => instance._createCellCoords(row, column),
     createCellRange: (highlight, from, to) => instance._createCellRange(highlight, from, to),
     visualToRenderableCoords,
     renderableToVisualCoords,
+    findFirstNonHiddenRenderableRow,
+    findFirstNonHiddenRenderableColumn,
     isDisabledCellSelection: (visualRow, visualColumn) => {
       if (visualRow < 0 || visualColumn < 0) {
         return instance.getSettings().disableVisualSelection;
@@ -334,6 +362,17 @@ export default function Core(rootElement, userSettings) {
     }
     this._refreshBorders(null);
   });
+  this.selection.addLocalHook('beforeSetFocus', cellCoords => {
+    this.runHooks('beforeSelectionFocusSet', cellCoords.row, cellCoords.col);
+  });
+  this.selection.addLocalHook('afterSetFocus', cellCoords => {
+    const preventScrolling = createObjectPropListener(false);
+    this.runHooks('afterSelectionFocusSet', cellCoords.row, cellCoords.col, preventScrolling);
+    if (!preventScrolling.isTouched() || preventScrolling.isTouched() && !preventScrolling.value) {
+      viewportScroller.scrollTo(cellCoords);
+    }
+    this._refreshBorders(null);
+  });
   this.selection.addLocalHook('afterSelectionFinished', cellRanges => {
     const selectionLayerLevel = cellRanges.length - 1;
     const {
@@ -400,25 +439,35 @@ export default function Core(rootElement, userSettings) {
       args[_key9] = arguments[_key9];
     }
     return _this.runHooks('afterModifyTransformStart', ...args);
-  }).addLocalHook('beforeModifyTransformEnd', function () {
+  }).addLocalHook('beforeModifyTransformFocus', function () {
     for (var _len10 = arguments.length, args = new Array(_len10), _key10 = 0; _key10 < _len10; _key10++) {
       args[_key10] = arguments[_key10];
     }
-    return _this.runHooks('modifyTransformEnd', ...args);
-  }).addLocalHook('afterModifyTransformEnd', function () {
+    return _this.runHooks('modifyTransformFocus', ...args);
+  }).addLocalHook('afterModifyTransformFocus', function () {
     for (var _len11 = arguments.length, args = new Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
       args[_key11] = arguments[_key11];
     }
-    return _this.runHooks('afterModifyTransformEnd', ...args);
-  }).addLocalHook('beforeRowWrap', function () {
+    return _this.runHooks('afterModifyTransformFocus', ...args);
+  }).addLocalHook('beforeModifyTransformEnd', function () {
     for (var _len12 = arguments.length, args = new Array(_len12), _key12 = 0; _key12 < _len12; _key12++) {
       args[_key12] = arguments[_key12];
     }
-    return _this.runHooks('beforeRowWrap', ...args);
-  }).addLocalHook('beforeColumnWrap', function () {
+    return _this.runHooks('modifyTransformEnd', ...args);
+  }).addLocalHook('afterModifyTransformEnd', function () {
     for (var _len13 = arguments.length, args = new Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
       args[_key13] = arguments[_key13];
     }
+    return _this.runHooks('afterModifyTransformEnd', ...args);
+  }).addLocalHook('beforeRowWrap', function () {
+    for (var _len14 = arguments.length, args = new Array(_len14), _key14 = 0; _key14 < _len14; _key14++) {
+      args[_key14] = arguments[_key14];
+    }
+    return _this.runHooks('beforeRowWrap', ...args);
+  }).addLocalHook('beforeColumnWrap', function () {
+    for (var _len15 = arguments.length, args = new Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
+      args[_key15] = arguments[_key15];
+    }
     return _this.runHooks('beforeColumnWrap', ...args);
   }).addLocalHook('insertRowRequire', totalRows => this.alter('insert_row_above', totalRows, 1, 'auto')).addLocalHook('insertColRequire', totalCols => this.alter('insert_col_start', totalCols, 1, 'auto'));
   grid = {
@@ -1556,8 +1605,8 @@ export default function Core(rootElement, userSettings) {
    * @returns {Array} Returns removed portion of columns.
    */
   this.spliceCol = function (column, index, amount) {
-    for (var _len14 = arguments.length, elements = new Array(_len14 > 3 ? _len14 - 3 : 0), _key14 = 3; _key14 < _len14; _key14++) {
-      elements[_key14 - 3] = arguments[_key14];
+    for (var _len16 = arguments.length, elements = new Array(_len16 > 3 ? _len16 - 3 : 0), _key16 = 3; _key16 < _len16; _key16++) {
+      elements[_key16 - 3] = arguments[_key16];
     }
     return datamap.spliceCol(column, index, amount, ...elements);
   };
@@ -1574,8 +1623,8 @@ export default function Core(rootElement, userSettings) {
    * @returns {Array} Returns removed portion of rows.
    */
   this.spliceRow = function (row, index, amount) {
-    for (var _len15 = arguments.length, elements = new Array(_len15 > 3 ? _len15 - 3 : 0), _key15 = 3; _key15 < _len15; _key15++) {
-      elements[_key15 - 3] = arguments[_key15];
+    for (var _len17 = arguments.length, elements = new Array(_len17 > 3 ? _len17 - 3 : 0), _key17 = 3; _key17 < _len17; _key17++) {
+      elements[_key17 - 3] = arguments[_key17];
     }
     return datamap.spliceRow(row, index, amount, ...elements);
   };
@@ -2972,8 +3021,8 @@ export default function Core(rootElement, userSettings) {
    */
   this.spliceCellsMeta = function (visualIndex) {
     let deleteAmount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    for (var _len16 = arguments.length, cellMetaRows = new Array(_len16 > 2 ? _len16 - 2 : 0), _key16 = 2; _key16 < _len16; _key16++) {
-      cellMetaRows[_key16 - 2] = arguments[_key16];
+    for (var _len18 = arguments.length, cellMetaRows = new Array(_len18 > 2 ? _len18 - 2 : 0), _key18 = 2; _key18 < _len18; _key18++) {
+      cellMetaRows[_key18 - 2] = arguments[_key18];
     }
     if (cellMetaRows.length > 0 && !Array.isArray(cellMetaRows[0])) {
       throw new Error('The 3rd argument (cellMetaRows) has to be passed as an array of cell meta objects array.');
@@ -3895,6 +3944,8 @@ export default function Core(rootElement, userSettings) {
    * hot.selectColumns(1, 2, -1);
    * // Select range of columns using visual indexes and mark the second cell as highlighted.
    * hot.selectColumns(2, 1, 1);
+   * // Select range of columns using visual indexes and move the focus position somewhere in the middle of the range.
+   * hot.selectColumns(2, 5, { row: 2, col: 3 });
    * // Select range of columns using column properties.
    * hot.selectColumns('id', 'last_name');
    * ```
@@ -3904,10 +3955,11 @@ export default function Core(rootElement, userSettings) {
    * @function selectColumns
    * @param {number} startColumn The visual column index from which the selection starts.
    * @param {number} [endColumn=startColumn] The visual column index to which the selection finishes. If `endColumn`
-   *                                         is not defined the column defined by `startColumn` will be selected.
-   * @param {number} [focusPosition=0] The argument allows changing the cell/header focus position.
-   *                                   The value can take visual row index from -N to N, where negative values
-   *                                   point to the headers and positive values point to the cell range.
+   * is not defined the column defined by `startColumn` will be selected.
+   * @param {number | { row: number, col: number } | CellCoords} [focusPosition=0] The argument allows changing the cell/header focus
+   * position. The value can take visual row index from -N to N, where negative values point to the headers and positive
+   * values point to the cell range. An object with `row` and `col` properties also can be passed to change the focus
+   * position horizontally.
    * @returns {boolean} `true` if selection was successful, `false` otherwise.
    */
   this.selectColumns = function (startColumn) {
@@ -3929,6 +3981,8 @@ export default function Core(rootElement, userSettings) {
    * hot.selectRows(1, 2, -1);
    * // Select range of rows using visual indexes and mark the second cell as highlighted.
    * hot.selectRows(2, 1, 1);
+   * // Select range of rows using visual indexes and move the focus position somewhere in the middle of the range.
+   * hot.selectRows(2, 5, { row: 2, col: 3 });
    * ```
    *
    * @memberof Core#
@@ -3936,10 +3990,11 @@ export default function Core(rootElement, userSettings) {
    * @function selectRows
    * @param {number} startRow The visual row index from which the selection starts.
    * @param {number} [endRow=startRow] The visual row index to which the selection finishes. If `endRow`
-   *                                   is not defined the row defined by `startRow` will be selected.
-   * @param {number} [focusPosition=0] The argument allows changing the cell/header focus position.
-   *                                   The value can take visual column index from -N to N, where negative values
-   *                                   point to the headers and positive values point to the cell range.
+   * is not defined the row defined by `startRow` will be selected.
+   * @param {number | { row: number, col: number } | CellCoords} [focusPosition=0] The argument allows changing the cell/header focus
+   * position. The value can take visual row index from -N to N, where negative values point to the headers and positive
+   * values point to the cell range. An object with `row` and `col` properties also can be passed to change the focus
+   * position vertically.
    * @returns {boolean} `true` if selection was successful, `false` otherwise.
    */
   this.selectRows = function (startRow) {

package/dataMap/dataSource.js

@@ -1,8 +1,8 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.array.push.js");
 var _object = require("../helpers/object");
 var _data = require("../helpers/data");
 var _array = require("../helpers/array");

package/dataMap/dataSource.mjs

@@ -1,5 +1,5 @@
-import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
+import "core-js/modules/es.array.push.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }

package/dataMap/metaManager/metaLayers/cellMeta.js

@@ -1,8 +1,8 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.array.push.js");
 var _object = require("../../../helpers/object");
 var _utils = require("../utils");
 var _lazyFactoryMap = _interopRequireDefault(require("../lazyFactoryMap"));

package/dataMap/metaManager/metaLayers/cellMeta.mjs

@@ -1,5 +1,5 @@
-import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
+import "core-js/modules/es.array.push.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }

package/dataMap/metaManager/metaSchema.js

@@ -1759,7 +1759,7 @@ var _default = () => {
      *
      * // enable the `DropdownMenu` plugin
      * // and modify individual context menu options
-     * dropdownMenu: ['row_above', 'row_below', '---------', 'undo', 'redo'],
+     * dropdownMenu: ['---------', 'undo', 'redo'],
      *
      * // enable the `DropdownMenu` plugin
      * // and apply a custom dropdown menu configuration

package/dataMap/metaManager/metaSchema.mjs

@@ -1756,7 +1756,7 @@ export default (() => {
      *
      * // enable the `DropdownMenu` plugin
      * // and modify individual context menu options
-     * dropdownMenu: ['row_above', 'row_below', '---------', 'undo', 'redo'],
+     * dropdownMenu: ['---------', 'undo', 'redo'],
      *
      * // enable the `DropdownMenu` plugin
      * // and apply a custom dropdown menu configuration

package/dataMap/replaceData.js

@@ -2,8 +2,8 @@
 
 exports.__esModule = true;
 exports.replaceData = replaceData;
-require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.array.push.js");
 var _string = require("../helpers/string");
 var _function = require("../helpers/function");
 var _dataMap = _interopRequireDefault(require("./dataMap"));

package/dataMap/replaceData.mjs

@@ -1,5 +1,5 @@
-import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
+import "core-js/modules/es.array.push.js";
 import { toUpperCaseFirst } from "../helpers/string.mjs";
 import { isFunction } from "../helpers/function.mjs";
 import DataMap from "./dataMap.mjs";

package/dist/handsontable.css

@@ -25,8 +25,8 @@
  * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING FROM
  * USE OR INABILITY TO USE THIS SOFTWARE.
  *
- * Version: 0.0.0-next-5a535ed-20240403
- * Release date: 06/03/2024 (built at 03/04/2024 12:33:57)
+ * Version: 0.0.0-next-c2810a1-20240403
+ * Release date: 06/03/2024 (built at 03/04/2024 13:17:53)
  */
 /**
  * Fix for bootstrap styles
@@ -1708,7 +1708,7 @@ textarea.HandsontableCopyPaste {
   cursor: grab;
 }
 
-.handsontable.ht__manualColumnMove.on-moving--columns,
+.handsontable.ht__manualColumnMove.on-moving--columns *,
 .handsontable.ht__manualColumnMove.on-moving--columns thead th.ht__highlight {
   cursor: move;
   cursor: -moz-grabbing;
@@ -1759,7 +1759,7 @@ textarea.HandsontableCopyPaste {
   cursor: grab;
 }
 
-.handsontable.ht__manualRowMove.on-moving--rows,
+.handsontable.ht__manualRowMove.on-moving--rows *,
 .handsontable.ht__manualRowMove.on-moving--rows tbody th.ht__highlight {
   cursor: move;
   cursor: -moz-grabbing;

package/dist/handsontable.full.css

@@ -25,8 +25,8 @@
  * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING FROM
  * USE OR INABILITY TO USE THIS SOFTWARE.
  *
- * Version: 0.0.0-next-5a535ed-20240403
- * Release date: 06/03/2024 (built at 03/04/2024 12:33:57)
+ * Version: 0.0.0-next-c2810a1-20240403
+ * Release date: 06/03/2024 (built at 03/04/2024 13:17:53)
  */
 /**
  * Fix for bootstrap styles
@@ -1941,7 +1941,7 @@ textarea.HandsontableCopyPaste {
   cursor: grab;
 }
 
-.handsontable.ht__manualColumnMove.on-moving--columns,
+.handsontable.ht__manualColumnMove.on-moving--columns *,
 .handsontable.ht__manualColumnMove.on-moving--columns thead th.ht__highlight {
   cursor: move;
   cursor: -moz-grabbing;
@@ -1992,7 +1992,7 @@ textarea.HandsontableCopyPaste {
   cursor: grab;
 }
 
-.handsontable.ht__manualRowMove.on-moving--rows,
+.handsontable.ht__manualRowMove.on-moving--rows *,
 .handsontable.ht__manualRowMove.on-moving--rows tbody th.ht__highlight {
   cursor: move;
   cursor: -moz-grabbing;