handsontable 0.0.0-next-85c3085-20230713 → 0.0.0-next-08765b9-20230714

package/editorManager.js

@@ -2,16 +2,14 @@
 
 exports.__esModule = true;
 var _unicode = require("./helpers/unicode");
-var _event = require("./helpers/dom/event");
 var _element = require("./helpers/dom/element");
+var _event = require("./helpers/dom/event");
 var _registry = require("./editors/registry");
 var _eventManager = _interopRequireDefault(require("./eventManager"));
 var _mixed = require("./helpers/mixed");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const SHORTCUTS_GROUP_NAVIGATION = 'editorManager.navigation';
 exports.SHORTCUTS_GROUP_NAVIGATION = SHORTCUTS_GROUP_NAVIGATION;
-const SHORTCUTS_GROUP_EDITOR = 'editorManager.handlingEditor';
-exports.SHORTCUTS_GROUP_EDITOR = SHORTCUTS_GROUP_EDITOR;
 class EditorManager {
   /**
    * @param {Core} instance The Handsontable instance.
@@ -74,9 +72,6 @@ class EditorManager {
      * @type {object}
      */
     this.cellProperties = void 0;
-    const shortcutManager = this.instance.getShortcutManager();
-    shortcutManager.addContext('editor');
-    this.registerShortcuts();
     this.instance.addHook('afterDocumentKeyDown', event => this.onAfterDocumentKeyDown(event));
 
     // Open editor when text composition is started (IME editor)
@@ -88,62 +83,6 @@ class EditorManager {
     this.instance.view._wt.update('onCellDblClick', (event, coords, elem) => this.onCellDblClick(event, coords, elem));
   }
 
-  /**
-   * Register shortcuts responsible for handling some actions related to an editor.
-   *
-   * @private
-   */
-  registerShortcuts() {
-    const shortcutManager = this.instance.getShortcutManager();
-    const gridContext = shortcutManager.getContext('grid');
-    const editorContext = shortcutManager.getContext('editor');
-    const config = {
-      group: SHORTCUTS_GROUP_EDITOR
-    };
-    editorContext.addShortcuts([{
-      keys: [['Enter'], ['Enter', 'Shift'], ['Enter', 'Control/Meta'], ['Enter', 'Control/Meta', 'Shift']],
-      callback: (event, keys) => {
-        this.closeEditorAndSaveChanges(shortcutManager.isCtrlPressed());
-        this.moveSelectionAfterEnter(keys.includes('shift'));
-      }
-    }, {
-      keys: [['Escape'], ['Escape', 'Control/Meta']],
-      callback: () => {
-        this.closeEditorAndRestoreOriginalValue(shortcutManager.isCtrlPressed());
-        this.activeEditor.focus();
-      }
-    }], config);
-    gridContext.addShortcuts([{
-      keys: [['F2']],
-      callback: event => {
-        this.openEditor(null, event, true);
-      }
-    }, {
-      keys: [['Backspace'], ['Delete']],
-      callback: () => {
-        this.instance.emptySelectedCells();
-        this.prepareEditor();
-      }
-    }, {
-      keys: [['Enter'], ['Enter', 'Shift']],
-      callback: (event, keys) => {
-        if (this.instance.getSettings().enterBeginsEditing) {
-          if (this.cellProperties.readOnly) {
-            this.moveSelectionAfterEnter();
-          } else {
-            this.openEditor(null, event, true);
-          }
-        } else {
-          this.moveSelectionAfterEnter(keys.includes('shift'));
-        }
-        (0, _event.stopImmediatePropagation)(event); // required by HandsontableEditor
-      }
-    }], {
-      ...config,
-      runOnlyIf: () => (0, _mixed.isDefined)(this.instance.getSelected())
-    });
-  }
-
   /**
    * Lock the editor from being prepared and closed. Locking the editor prevents its closing and
    * reinitialized after selecting the new cell. This feature is necessary for a mobile editor.
@@ -196,10 +135,16 @@ class EditorManager {
       });
       return;
     }
+    const {
+      highlight
+    } = this.instance.getSelectedRangeLast();
+    if (highlight.isHeader()) {
+      return;
+    }
     const {
       row,
       col
-    } = this.instance.getSelectedRangeLast().highlight;
+    } = highlight;
     const modifiedCellCoords = this.instance.runHooks('modifyGetCellCoords', row, col);
     let visualRowToCheck = row;
     let visualColumnToCheck = col;
@@ -263,14 +208,7 @@ class EditorManager {
       return;
     }
     if (!this.activeEditor) {
-      const {
-        row,
-        col
-      } = this.instance.getSelectedRangeLast().highlight;
-      const renderableRowIndex = this.instance.rowIndexMapper.getRenderableFromVisualIndex(row);
-      const renderableColumnIndex = this.instance.columnIndexMapper.getRenderableFromVisualIndex(col);
-      this.instance.view.scrollViewport(this.instance._createCellCoords(renderableRowIndex, renderableColumnIndex));
-      this.instance.view.render();
+      this.instance.scrollToFocusedCell();
       this.prepareEditor();
     }
     if (this.activeEditor) {
@@ -374,15 +312,13 @@ class EditorManager {
    * @param {KeyboardEvent} event The keyboard event object.
    */
   onAfterDocumentKeyDown(event) {
-    if (!this.instance.isListening()) {
+    const selection = this.instance.getSelectedRangeLast();
+    if (!this.instance.isListening() || !selection || selection.highlight.isHeader() || (0, _event.isImmediatePropagationStopped)(event)) {
       return;
     }
     const {
       keyCode
     } = event;
-    if (!this.selection.isSelected()) {
-      return;
-    }
 
     // catch CTRL but not right ALT (which in some systems triggers ALT+CTRL)
     const isCtrlPressed = (event.ctrlKey || event.metaKey) && !event.altKey;

package/editorManager.mjs

@@ -1,11 +1,10 @@
 import { isFunctionKey, isCtrlMetaKey } from "./helpers/unicode.mjs";
-import { stopImmediatePropagation } from "./helpers/dom/event.mjs";
 import { isOutsideInput } from "./helpers/dom/element.mjs";
+import { isImmediatePropagationStopped } from "./helpers/dom/event.mjs";
 import { getEditorInstance } from "./editors/registry.mjs";
 import EventManager from "./eventManager.mjs";
 import { isDefined } from "./helpers/mixed.mjs";
 export const SHORTCUTS_GROUP_NAVIGATION = 'editorManager.navigation';
-export const SHORTCUTS_GROUP_EDITOR = 'editorManager.handlingEditor';
 class EditorManager {
   /**
    * @param {Core} instance The Handsontable instance.
@@ -68,9 +67,6 @@ class EditorManager {
      * @type {object}
      */
     this.cellProperties = void 0;
-    const shortcutManager = this.instance.getShortcutManager();
-    shortcutManager.addContext('editor');
-    this.registerShortcuts();
     this.instance.addHook('afterDocumentKeyDown', event => this.onAfterDocumentKeyDown(event));
 
     // Open editor when text composition is started (IME editor)
@@ -82,62 +78,6 @@ class EditorManager {
     this.instance.view._wt.update('onCellDblClick', (event, coords, elem) => this.onCellDblClick(event, coords, elem));
   }
 
-  /**
-   * Register shortcuts responsible for handling some actions related to an editor.
-   *
-   * @private
-   */
-  registerShortcuts() {
-    const shortcutManager = this.instance.getShortcutManager();
-    const gridContext = shortcutManager.getContext('grid');
-    const editorContext = shortcutManager.getContext('editor');
-    const config = {
-      group: SHORTCUTS_GROUP_EDITOR
-    };
-    editorContext.addShortcuts([{
-      keys: [['Enter'], ['Enter', 'Shift'], ['Enter', 'Control/Meta'], ['Enter', 'Control/Meta', 'Shift']],
-      callback: (event, keys) => {
-        this.closeEditorAndSaveChanges(shortcutManager.isCtrlPressed());
-        this.moveSelectionAfterEnter(keys.includes('shift'));
-      }
-    }, {
-      keys: [['Escape'], ['Escape', 'Control/Meta']],
-      callback: () => {
-        this.closeEditorAndRestoreOriginalValue(shortcutManager.isCtrlPressed());
-        this.activeEditor.focus();
-      }
-    }], config);
-    gridContext.addShortcuts([{
-      keys: [['F2']],
-      callback: event => {
-        this.openEditor(null, event, true);
-      }
-    }, {
-      keys: [['Backspace'], ['Delete']],
-      callback: () => {
-        this.instance.emptySelectedCells();
-        this.prepareEditor();
-      }
-    }, {
-      keys: [['Enter'], ['Enter', 'Shift']],
-      callback: (event, keys) => {
-        if (this.instance.getSettings().enterBeginsEditing) {
-          if (this.cellProperties.readOnly) {
-            this.moveSelectionAfterEnter();
-          } else {
-            this.openEditor(null, event, true);
-          }
-        } else {
-          this.moveSelectionAfterEnter(keys.includes('shift'));
-        }
-        stopImmediatePropagation(event); // required by HandsontableEditor
-      }
-    }], {
-      ...config,
-      runOnlyIf: () => isDefined(this.instance.getSelected())
-    });
-  }
-
   /**
    * Lock the editor from being prepared and closed. Locking the editor prevents its closing and
    * reinitialized after selecting the new cell. This feature is necessary for a mobile editor.
@@ -190,10 +130,16 @@ class EditorManager {
       });
       return;
     }
+    const {
+      highlight
+    } = this.instance.getSelectedRangeLast();
+    if (highlight.isHeader()) {
+      return;
+    }
     const {
       row,
       col
-    } = this.instance.getSelectedRangeLast().highlight;
+    } = highlight;
     const modifiedCellCoords = this.instance.runHooks('modifyGetCellCoords', row, col);
     let visualRowToCheck = row;
     let visualColumnToCheck = col;
@@ -257,14 +203,7 @@ class EditorManager {
       return;
     }
     if (!this.activeEditor) {
-      const {
-        row,
-        col
-      } = this.instance.getSelectedRangeLast().highlight;
-      const renderableRowIndex = this.instance.rowIndexMapper.getRenderableFromVisualIndex(row);
-      const renderableColumnIndex = this.instance.columnIndexMapper.getRenderableFromVisualIndex(col);
-      this.instance.view.scrollViewport(this.instance._createCellCoords(renderableRowIndex, renderableColumnIndex));
-      this.instance.view.render();
+      this.instance.scrollToFocusedCell();
       this.prepareEditor();
     }
     if (this.activeEditor) {
@@ -368,15 +307,13 @@ class EditorManager {
    * @param {KeyboardEvent} event The keyboard event object.
    */
   onAfterDocumentKeyDown(event) {
-    if (!this.instance.isListening()) {
+    const selection = this.instance.getSelectedRangeLast();
+    if (!this.instance.isListening() || !selection || selection.highlight.isHeader() || isImmediatePropagationStopped(event)) {
       return;
     }
     const {
       keyCode
     } = event;
-    if (!this.selection.isSelected()) {
-      return;
-    }
 
     // catch CTRL but not right ALT (which in some systems triggers ALT+CTRL)
     const isCtrlPressed = (event.ctrlKey || event.metaKey) && !event.altKey;

package/editors/textEditor/textEditor.js

@@ -416,9 +416,7 @@ class TextEditor extends _baseEditor.BaseEditor {
       runOnlyIf: event => !this.hot.selection.isMultiple() &&
       // We trigger a data population for multiple selection.
       // catch CTRL but not right ALT (which in some systems triggers ALT+CTRL)
-      !event.altKey,
-      relativeToGroup: _editorManager.SHORTCUTS_GROUP_EDITOR,
-      position: 'before'
+      !event.altKey
     }, {
       keys: [['Meta', 'Enter']],
       callback: () => {
@@ -426,19 +424,13 @@ class TextEditor extends _baseEditor.BaseEditor {
         return false; // Will block closing editor.
       },
 
-      runOnlyIf: () => !this.hot.selection.isMultiple(),
-      // We trigger a data population for multiple selection.
-      relativeToGroup: _editorManager.SHORTCUTS_GROUP_EDITOR,
-      position: 'before'
+      runOnlyIf: () => !this.hot.selection.isMultiple() // We trigger a data population for multiple selection.
     }, {
       keys: [['Alt', 'Enter']],
       callback: () => {
         insertNewLine();
         return false; // Will block closing editor.
-      },
-
-      relativeToGroup: _editorManager.SHORTCUTS_GROUP_EDITOR,
-      position: 'before'
+      }
     }, {
       // TODO: Duplicated part of code (callback to shortcut)
       keys: [['PageUp']],

package/editors/textEditor/textEditor.mjs

@@ -6,7 +6,7 @@ import { rangeEach } from "../../helpers/number.mjs";
 import { KEY_CODES } from "../../helpers/unicode.mjs";
 import { autoResize } from "../../3rdparty/autoResize/index.mjs";
 import { isDefined } from "../../helpers/mixed.mjs";
-import { SHORTCUTS_GROUP_NAVIGATION, SHORTCUTS_GROUP_EDITOR as EDITOR_MANAGER_GROUP } from "../../editorManager.mjs";
+import { SHORTCUTS_GROUP_NAVIGATION } from "../../editorManager.mjs";
 import { SHORTCUTS_GROUP_EDITOR } from "../baseEditor/baseEditor.mjs";
 import { updateCaretPosition } from "./caretPositioner.mjs";
 const EDITOR_VISIBLE_CLASS_NAME = 'ht_editor_visible';
@@ -411,9 +411,7 @@ export class TextEditor extends BaseEditor {
       runOnlyIf: event => !this.hot.selection.isMultiple() &&
       // We trigger a data population for multiple selection.
       // catch CTRL but not right ALT (which in some systems triggers ALT+CTRL)
-      !event.altKey,
-      relativeToGroup: EDITOR_MANAGER_GROUP,
-      position: 'before'
+      !event.altKey
     }, {
       keys: [['Meta', 'Enter']],
       callback: () => {
@@ -421,19 +419,13 @@ export class TextEditor extends BaseEditor {
         return false; // Will block closing editor.
       },
 
-      runOnlyIf: () => !this.hot.selection.isMultiple(),
-      // We trigger a data population for multiple selection.
-      relativeToGroup: EDITOR_MANAGER_GROUP,
-      position: 'before'
+      runOnlyIf: () => !this.hot.selection.isMultiple() // We trigger a data population for multiple selection.
     }, {
       keys: [['Alt', 'Enter']],
       callback: () => {
         insertNewLine();
         return false; // Will block closing editor.
-      },
-
-      relativeToGroup: EDITOR_MANAGER_GROUP,
-      position: 'before'
+      }
     }, {
       // TODO: Duplicated part of code (callback to shortcut)
       keys: [['PageUp']],

package/helpers/mixed.js

@@ -134,7 +134,7 @@ const domMessages = {
 function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-85c3085-20230713";
+  const hotVersion = "0.0.0-next-08765b9-20230714";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/helpers/mixed.mjs

@@ -124,7 +124,7 @@ const domMessages = {
 export function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-85c3085-20230713";
+  const hotVersion = "0.0.0-next-08765b9-20230714";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/helpers/number.d.ts

@@ -3,3 +3,4 @@ export function isNumericLike(value: any): boolean;
 export function rangeEach(rangeFrom: number, rangeTo: number, iteratee: (index: number) => void): void;
 export function rangeEachReverse(rangeFrom: number, rangeTo: number, iteratee: (index: number) => void): void;
 export function valueAccordingPercent(value: number, percent: string | number): number;
+export function clamp(value: number, minValue: number, maxValue: number): number;

package/helpers/number.js

@@ -1,6 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.clamp = clamp;
 exports.isNumeric = isNumeric;
 exports.isNumericLike = isNumericLike;
 exports.rangeEach = rangeEach;
@@ -111,4 +112,21 @@ function valueAccordingPercent(value, percent) {
   percent = parseInt(percent.toString().replace('%', ''), 10);
   percent = isNaN(percent) ? 0 : percent;
   return parseInt(value * percent / 100, 10);
+}
+
+/**
+ * Clamps the value between min and max.
+ *
+ * @param {number} value The base number value.
+ * @param {number} minValue The max number value.
+ * @param {number} maxValue The min number value.
+ * @returns {number}
+ */
+function clamp(value, minValue, maxValue) {
+  if (Math.min(value, minValue) === value) {
+    return minValue;
+  } else if (Math.max(value, maxValue) === value) {
+    return maxValue;
+  }
+  return value;
 }

package/helpers/number.mjs

@@ -103,4 +103,21 @@ export function valueAccordingPercent(value, percent) {
   percent = parseInt(percent.toString().replace('%', ''), 10);
   percent = isNaN(percent) ? 0 : percent;
   return parseInt(value * percent / 100, 10);
+}
+
+/**
+ * Clamps the value between min and max.
+ *
+ * @param {number} value The base number value.
+ * @param {number} minValue The max number value.
+ * @param {number} maxValue The min number value.
+ * @returns {number}
+ */
+export function clamp(value, minValue, maxValue) {
+  if (Math.min(value, minValue) === value) {
+    return minValue;
+  } else if (Math.max(value, maxValue) === value) {
+    return maxValue;
+  }
+  return value;
 }

package/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/handsontable/handsontable/issues"
   },
   "author": "Handsoncode <hello@handsontable.com>",
-  "version": "0.0.0-next-85c3085-20230713",
+  "version": "0.0.0-next-08765b9-20230714",
   "main": "index",
   "module": "index.mjs",
   "jsnext:main": "index.mjs",

package/pluginHooks.d.ts

@@ -110,8 +110,8 @@ export interface Events {
   afterOnCellCornerDblClick?: (event: MouseEvent) => void;
   afterOnCellCornerMouseDown?: (event: MouseEvent) => void;
   afterOnCellMouseDown?: (event: MouseEvent, coords: CellCoords, TD: HTMLTableCellElement) => void;
-  afterOnCellMouseOver?: (event: MouseEvent, coords: CellCoords, TD: HTMLTableCellElement) => void;
   afterOnCellMouseOut?: (event: MouseEvent, coords: CellCoords, TD: HTMLTableCellElement) => void;
+  afterOnCellMouseOver?: (event: MouseEvent, coords: CellCoords, TD: HTMLTableCellElement) => void;
   afterOnCellMouseUp?: (event: MouseEvent, coords: CellCoords, TD: HTMLTableCellElement) => void;
   afterPaste?: (data: CellValue[][], coords: RangeType[]) => void;
   afterPluginsInitialized?: () => void;
@@ -128,10 +128,13 @@ export interface Events {
   afterRowSequenceChange?: (source: 'init' | 'move' | 'insert' | 'remove' | 'update') => void;
   afterScrollHorizontally?: () => void;
   afterScrollVertically?: () => void;
+  afterScroll?: () => void;
+  afterSelectColumns?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
   afterSelection?: (row: number, column: number, row2: number, column2: number, preventScrolling: { value: boolean }, selectionLayerLevel: number) => void;
   afterSelectionByProp?: (row: number, prop: string, row2: number, prop2: string, preventScrolling: { value: boolean }, selectionLayerLevel: number) => void;
   afterSelectionEnd?: (row: number, column: number, row2: number, column2: number, selectionLayerLevel: number) => void;
   afterSelectionEndByProp?: (row: number, prop: string, row2: number, prop2: string, selectionLayerLevel: number) => void;
+  afterSelectRows?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
   afterSetCellMeta?: (row: number, column: number, key: string, value: any) => void;
   afterSetDataAtCell?: (changes: CellChange[], source?: ChangeSource) => void;
   afterSetDataAtRowProp?: (changes: CellChange[], source?: ChangeSource) => void;
@@ -205,6 +208,8 @@ export interface Events {
   beforeRenderer?: (TD: HTMLTableCellElement, row: number, column: number, prop: string | number, value: CellValue, cellProperties: CellProperties) => void;
   beforeRowMove?: (movedRows: number[], finalIndex: number, dropIndex: number | undefined, movePossible: boolean) => void;
   beforeRowResize?: (newSize: number, row: number, isDoubleClick: boolean) => number | void;
+  beforeSelectColumns?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
+  beforeSelectRows?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
   beforeSetCellMeta?: (row: number, col: number, key: string, value: any) => boolean | void;
   beforeSetRangeEnd?: (coords: CellCoords) => void;
   beforeSetRangeStart?: (coords: CellCoords) => void;
@@ -232,6 +237,7 @@ export interface Events {
   modifyColWidth?: (width: number, column: number) => void;
   modifyCopyableRange?: (copyableRanges: RangeType[]) => void;
   modifyData?: (row: number, column: number, valueHolder: { value: CellValue }, ioMode: 'get' | 'set') => void;
+  modifyFocusOnTabNavigation?: (tabActivationDir: 'from_above' | 'from_below', visualCoords: CellCoords) => void;
   modifyGetCellCoords?: (row: number, column: number, topmost: boolean) => void | [number, number] | [number, number, number, number];
   modifyRowData?: (row: number) => void;
   modifyRowHeader?: (row: number) => void;

package/pluginHooks.js

@@ -554,6 +554,13 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @event Hooks#afterScrollVertically
  */
 'afterScrollVertically',
+/**
+ * Fired after the vertical or horizontal scroll event.
+ *
+ * @since 14.0.0
+ * @event Hooks#afterScroll
+ */
+'afterScroll',
 /**
  * Fired after one or more cells are selected (e.g. During mouse move).
  *
@@ -657,6 +664,94 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {number} selectionLayerLevel The number which indicates what selection layer is currently modified.
  */
 'afterSelectionEndByProp',
+/**
+ * Fired before one or more columns are selected (e.g. During mouse header click or {@link Core#selectColumns} API call).
+ *
+ * @since 14.0.0
+ * @event Hooks#beforeSelectColumns
+ * @param {CellCoords} from Selection start coords object.
+ * @param {CellCoords} to Selection end coords object.
+ * @param {CellCoords} highlight Selection cell focus coords object.
+ * @example
+ * ::: only-for javascript
+ * ```js
+ * new Handsontable(element, {
+ *   beforeSelectColumns: (from, to, highlight) => {
+ *     // Extend the column selection by one column left and one column right.
+ *     from.col = Math.max(from.col - 1, 0);
+ *     to.col = Math.min(to.col + 1, this.countCols() - 1);
+ *   }
+ * })
+ * ```
+ * :::
+ *
+ * ::: only-for react
+ * ```jsx
+ * <HotTable
+ *   beforeSelectColumns={(from, to, highlight) => {
+ *     // Extend the column selection by one column left and one column right.
+ *     from.col = Math.max(from.col - 1, 0);
+ *     to.col = Math.min(to.col + 1, this.countCols() - 1);
+ *   }}
+ * />
+ * ```
+ * :::
+ */
+'beforeSelectColumns',
+/**
+ * Fired after one or more columns are selected (e.g. During mouse header click or {@link Core#selectColumns} API call).
+ *
+ * @since 14.0.0
+ * @event Hooks#afterSelectColumns
+ * @param {CellCoords} from Selection start coords object.
+ * @param {CellCoords} to Selection end coords object.
+ * @param {CellCoords} highlight Selection cell focus coords object.
+ */
+'afterSelectColumns',
+/**
+ * Fired before one or more rows are selected (e.g. During mouse header click or {@link Core#selectRows} API call).
+ *
+ * @since 14.0.0
+ * @event Hooks#beforeSelectRows
+ * @param {CellCoords} from Selection start coords object.
+ * @param {CellCoords} to Selection end coords object.
+ * @param {CellCoords} highlight Selection cell focus coords object.
+ * @example
+ * ::: only-for javascript
+ * ```js
+ * new Handsontable(element, {
+ *   beforeSelectRows: (from, to, highlight) => {
+ *     // Extend the row selection by one row up and one row bottom more.
+ *     from.row = Math.max(from.row - 1, 0);
+ *     to.row = Math.min(to.row + 1, this.countRows() - 1);
+ *   }
+ * })
+ * ```
+ * :::
+ *
+ * ::: only-for react
+ * ```jsx
+ * <HotTable
+ *   beforeSelectRows={(from, to, highlight) => {
+ *     // Extend the row selection by one row up and one row bottom more.
+ *     from.row = Math.max(from.row - 1, 0);
+ *     to.row = Math.min(to.row + 1, this.countRows() - 1);
+ *   }}
+ * />
+ * ```
+ * :::
+ */
+'beforeSelectRows',
+/**
+ * Fired after one or more rows are selected (e.g. During mouse header click or {@link Core#selectRows} API call).
+ *
+ * @since 14.0.0
+ * @event Hooks#afterSelectRows
+ * @param {CellCoords} from Selection start coords object.
+ * @param {CellCoords} to Selection end coords object.
+ * @param {CellCoords} highlight Selection cell focus coords object.
+ */
+'afterSelectRows',
 /**
  * Fired after cell meta is changed.
  *
@@ -1225,6 +1320,16 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @returns {undefined|number[]}
  */
 'modifyGetCellCoords',
+/**
+ * Used to modify the cell coordinates when the table is activated (going into the listen mode).
+ *
+ * @event Hooks#modifyFocusOnTabNavigation
+ * @since 14.0.0
+ * @param {'from_above' | 'from_below'} tabActivationDir The browsers Tab navigation direction. Depending on
+ * whether the user activated the table from the element above or below, another cell can be selected.
+ * @param {CellCoords} visualCoords The coords that will be used to select a cell.
+ */
+'modifyFocusOnTabNavigation',
 /**
  * Allows modify the visual row index that is used to retrieve the row header element (TH) before it's
  * highlighted (proper CSS class names are added). Modifying the visual row index allows building a custom
@@ -2382,7 +2487,7 @@ const REMOVED_HOOKS = new Map([['modifyRow', '8.0.0'], ['modifyCol', '8.0.0'], [
  * @type {Map<string, string>}
  */
 /* eslint-enable jsdoc/require-description-complete-sentence */
-const DEPRECATED_HOOKS = new Map([]);
+const DEPRECATED_HOOKS = new Map([['beforeRemoveCellClassNames', 'The hook "beforeRemoveCellClassNames" is deprecated and will be removed in the next major release.']]);
 class Hooks {
   static getSingleton() {
     return getGlobalSingleton();