handsontable 14.0.0-next-b112557-20231129 → 14.0.0-next-ecaa005-20231130

package/focusManager.js

@@ -209,7 +209,7 @@ class FocusManager {
     const focusElement = element => {
       var _classPrivateFieldGet3, _classPrivateFieldGet4;
       const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(this, _hot).getSelectedRangeLast()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
-      if (!currentHighlightCoords || !element) {
+      if (!currentHighlightCoords) {
         return;
       }
       let elementToBeFocused = _classPrivateFieldGet(this, _hot).runHooks('modifyFocusedElement', currentHighlightCoords.row, currentHighlightCoords.col, element);
@@ -255,7 +255,7 @@ exports.FocusManager = FocusManager;
 function _getSelectedCell2(callback) {
   var _classPrivateFieldGet6;
   const highlight = (_classPrivateFieldGet6 = _classPrivateFieldGet(this, _hot).getSelectedRangeLast()) === null || _classPrivateFieldGet6 === void 0 ? void 0 : _classPrivateFieldGet6.highlight;
-  if (!highlight) {
+  if (!highlight || !_classPrivateFieldGet(this, _hot).selection.isCellVisible(highlight)) {
     callback(null);
     return;
   }

package/focusManager.mjs

@@ -206,7 +206,7 @@ export class FocusManager {
     const focusElement = element => {
       var _classPrivateFieldGet3, _classPrivateFieldGet4;
       const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(this, _hot).getSelectedRangeLast()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
-      if (!currentHighlightCoords || !element) {
+      if (!currentHighlightCoords) {
         return;
       }
       let elementToBeFocused = _classPrivateFieldGet(this, _hot).runHooks('modifyFocusedElement', currentHighlightCoords.row, currentHighlightCoords.col, element);
@@ -251,7 +251,7 @@ export class FocusManager {
 function _getSelectedCell2(callback) {
   var _classPrivateFieldGet6;
   const highlight = (_classPrivateFieldGet6 = _classPrivateFieldGet(this, _hot).getSelectedRangeLast()) === null || _classPrivateFieldGet6 === void 0 ? void 0 : _classPrivateFieldGet6.highlight;
-  if (!highlight) {
+  if (!highlight || !_classPrivateFieldGet(this, _hot).selection.isCellVisible(highlight)) {
     callback(null);
     return;
   }

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 = "14.0.0-next-b112557-20231129";
+  const hotVersion = "14.0.0-next-ecaa005-20231130";
   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 = "14.0.0-next-b112557-20231129";
+  const hotVersion = "14.0.0-next-ecaa005-20231130";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/handsontable/handsontable/issues"
   },
   "author": "Handsoncode <hello@handsontable.com>",
-  "version": "14.0.0-next-b112557-20231129",
+  "version": "14.0.0-next-ecaa005-20231130",
   "main": "index",
   "module": "index.mjs",
   "jsnext:main": "index.mjs",

package/pluginHooks.js

@@ -1217,7 +1217,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * This is due to the priority of other options that may block the feature.
  * For example, when the {@link Options#minSpareCols} is defined, the {@link Options#autoWrapRow} option is not checked.
  * Thus, row wrapping is off.
- * @param {CellCoords} newCoords The new focus position.
+ * @param {CellCoords} newCoords The new focus position. It is an object with keys `row` and `col`, where a value of `-1` indicates a header.
  * @param {boolean} isFlipped `true` if the row index was flipped, `false` otherwise.
  * Flipped index means that the user reached the last row and the focus is moved to the first row or vice versa.
  */
@@ -1233,7 +1233,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * This is due to the priority of other options that may block the feature.
  * For example, when the {@link Options#minSpareRows} is defined, the {@link Options#autoWrapCol} option is not checked.
  * Thus, column wrapping is off.
- * @param {CellCoords} newCoords The new focus position.
+ * @param {CellCoords} newCoords The new focus position. It is an object with keys `row` and `col`, where a value of `-1` indicates a header.
  * @param {boolean} isFlipped `true` if the column index was flipped, `false` otherwise.
  * Flipped index means that the user reached the last column and the focus is moved to the first column or vice versa.
  */
@@ -1273,6 +1273,8 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'beforeSetRangeEnd',
 /**
  * Fired before applying selection coordinates to the renderable coordinates for Walkontable (rendering engine).
+ * It occurs even when cell coordinates remain unchanged and activates during cell selection and drag selection.
+ * The behavior of Shift+Tab differs from Arrow Left when there's no further movement possible.
  *
  * @since 14.0.0
  * @event Hooks#beforeSelectionHighlightSet
@@ -1342,7 +1344,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @event Hooks#modifyFocusedElement
  * @param {number} row Row index.
  * @param {number} column Column index.
- * @param {HTMLElement|undefined} focusedElement The element to be focused.
+ * @param {HTMLElement|undefined} focusedElement The element to be focused. `null` for focusedElement is intended when focused cell is hidden.
  */
 'modifyFocusedElement',
 /**

package/pluginHooks.mjs

@@ -1215,7 +1215,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * This is due to the priority of other options that may block the feature.
  * For example, when the {@link Options#minSpareCols} is defined, the {@link Options#autoWrapRow} option is not checked.
  * Thus, row wrapping is off.
- * @param {CellCoords} newCoords The new focus position.
+ * @param {CellCoords} newCoords The new focus position. It is an object with keys `row` and `col`, where a value of `-1` indicates a header.
  * @param {boolean} isFlipped `true` if the row index was flipped, `false` otherwise.
  * Flipped index means that the user reached the last row and the focus is moved to the first row or vice versa.
  */
@@ -1231,7 +1231,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * This is due to the priority of other options that may block the feature.
  * For example, when the {@link Options#minSpareRows} is defined, the {@link Options#autoWrapCol} option is not checked.
  * Thus, column wrapping is off.
- * @param {CellCoords} newCoords The new focus position.
+ * @param {CellCoords} newCoords The new focus position. It is an object with keys `row` and `col`, where a value of `-1` indicates a header.
  * @param {boolean} isFlipped `true` if the column index was flipped, `false` otherwise.
  * Flipped index means that the user reached the last column and the focus is moved to the first column or vice versa.
  */
@@ -1271,6 +1271,8 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'beforeSetRangeEnd',
 /**
  * Fired before applying selection coordinates to the renderable coordinates for Walkontable (rendering engine).
+ * It occurs even when cell coordinates remain unchanged and activates during cell selection and drag selection.
+ * The behavior of Shift+Tab differs from Arrow Left when there's no further movement possible.
  *
  * @since 14.0.0
  * @event Hooks#beforeSelectionHighlightSet
@@ -1340,7 +1342,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @event Hooks#modifyFocusedElement
  * @param {number} row Row index.
  * @param {number} column Column index.
- * @param {HTMLElement|undefined} focusedElement The element to be focused.
+ * @param {HTMLElement|undefined} focusedElement The element to be focused. `null` for focusedElement is intended when focused cell is hidden.
  */
 'modifyFocusedElement',
 /**

package/plugins/contextMenu/contextMenu.js

@@ -205,6 +205,9 @@ class ContextMenu extends _base.BasePlugin {
           left: rect.width,
           above: -rect.height
         });
+        // Make sure the first item is selected (role=menuitem). Otherwise, screen readers
+        // will block the Esc key for the whole menu.
+        this.menu.getNavigator().toFirstItem();
       },
       runOnlyIf: () => {
         var _this$hot$getSelected;

package/plugins/contextMenu/contextMenu.mjs

@@ -201,6 +201,9 @@ export class ContextMenu extends BasePlugin {
           left: rect.width,
           above: -rect.height
         });
+        // Make sure the first item is selected (role=menuitem). Otherwise, screen readers
+        // will block the Esc key for the whole menu.
+        this.menu.getNavigator().toFirstItem();
       },
       runOnlyIf: () => {
         var _this$hot$getSelected;

package/plugins/dropdownMenu/dropdownMenu.js

@@ -296,6 +296,9 @@ class DropdownMenu extends _base.BasePlugin {
         }, {
           left: rect.width
         });
+        // Make sure the first item is selected (role=menuitem). Otherwise, screen readers
+        // will block the Esc key for the whole menu.
+        this.menu.getNavigator().toFirstItem();
       }
     };
     gridContext.addShortcuts([{

package/plugins/dropdownMenu/dropdownMenu.mjs

@@ -292,6 +292,9 @@ export class DropdownMenu extends BasePlugin {
         }, {
           left: rect.width
         });
+        // Make sure the first item is selected (role=menuitem). Otherwise, screen readers
+        // will block the Esc key for the whole menu.
+        this.menu.getNavigator().toFirstItem();
       }
     };
     gridContext.addShortcuts([{

package/plugins/mergeCells/mergeCells.js

@@ -122,7 +122,7 @@ class MergeCells extends _base.BasePlugin {
     _classPrivateMethodInitSpec(this, _onAfterDrawSelection);
     /**
      * `afterModifyTransformStart` hook callback. Fixes a problem with navigating through merged cells at the edges of
-     * the table with the ENTER/SHIFT+ENTER/TAB/SHIFT+TAB keys.
+     * the table with the <kbd>**Enter**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Enter**</kbd>/<kbd>**Tab**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Tab**</kbd> keys.
      *
      * @param {CellCoords} coords Coordinates of the to-be-selected cell.
      * @param {number} rowTransformDir Row transformation direction (negative value = up, 0 = none, positive value =

package/plugins/mergeCells/mergeCells.mjs

@@ -118,7 +118,7 @@ export class MergeCells extends BasePlugin {
     _classPrivateMethodInitSpec(this, _onAfterDrawSelection);
     /**
      * `afterModifyTransformStart` hook callback. Fixes a problem with navigating through merged cells at the edges of
-     * the table with the ENTER/SHIFT+ENTER/TAB/SHIFT+TAB keys.
+     * the table with the <kbd>**Enter**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Enter**</kbd>/<kbd>**Tab**</kbd>/<kbd>**Shift**</kbd>+<kbd>**Tab**</kbd> keys.
      *
      * @param {CellCoords} coords Coordinates of the to-be-selected cell.
      * @param {number} rowTransformDir Row transformation direction (negative value = up, 0 = none, positive value =

package/shortcuts/context.js

@@ -24,7 +24,7 @@ function isContextObject(objectToCheck) {
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
- * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/accessories-and-menus/keyboard-shortcuts.md) in a given [context](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts).
+ * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/navigation/keyboard-shortcuts.md) in a given [context](@/guides/navigation/keyboard-shortcuts.md#keyboard-shortcut-contexts).
  *
  * Each `ShortcutContext` object stores and manages its own set of keyboard shortcuts.
  *

package/shortcuts/context.mjs

@@ -20,7 +20,7 @@ export function isContextObject(objectToCheck) {
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
- * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/accessories-and-menus/keyboard-shortcuts.md) in a given [context](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts).
+ * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/navigation/keyboard-shortcuts.md) in a given [context](@/guides/navigation/keyboard-shortcuts.md#keyboard-shortcut-contexts).
  *
  * Each `ShortcutContext` object stores and manages its own set of keyboard shortcuts.
  *

package/shortcuts/manager.js

@@ -9,7 +9,7 @@ var _recorder = require("./recorder");
 var _templateLiteralTag = require("../helpers/templateLiteralTag");
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
- * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
+ * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/navigation/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
  *
  * Each `ShortcutManager` object:
  * - Stores and manages its own set of keyboard shortcut contexts.
@@ -20,7 +20,7 @@ var _templateLiteralTag = require("../helpers/templateLiteralTag");
  * @param {object} options The manager's options
  * @param {EventTarget} options.ownerWindow A starting `window` element
  * @param {Function} options.handleEvent A condition on which `event` is handled.
- * @param {Function} options.beforeKeyDown A hook fired before the `keydown` event is handled. You can use it to [block a keyboard shortcut's actions](@/guides/accessories-and-menus/keyboard-shortcuts.md#block-a-keyboard-shortcut-s-actions).
+ * @param {Function} options.beforeKeyDown A hook fired before the `keydown` event is handled. You can use it to [block a keyboard shortcut's actions](@/guides/navigation/keyboard-shortcuts.md#block-a-keyboard-shortcut-s-actions).
  * @param {Function} options.afterKeyDown A hook fired after the `keydown` event is handled
  */
 const createShortcutManager = _ref => {

package/shortcuts/manager.mjs

@@ -6,7 +6,7 @@ import { useRecorder } from "./recorder.mjs";
 import { toSingleLine } from "../helpers/templateLiteralTag.mjs";
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
- * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
+ * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/navigation/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
  *
  * Each `ShortcutManager` object:
  * - Stores and manages its own set of keyboard shortcut contexts.
@@ -17,7 +17,7 @@ import { toSingleLine } from "../helpers/templateLiteralTag.mjs";
  * @param {object} options The manager's options
  * @param {EventTarget} options.ownerWindow A starting `window` element
  * @param {Function} options.handleEvent A condition on which `event` is handled.
- * @param {Function} options.beforeKeyDown A hook fired before the `keydown` event is handled. You can use it to [block a keyboard shortcut's actions](@/guides/accessories-and-menus/keyboard-shortcuts.md#block-a-keyboard-shortcut-s-actions).
+ * @param {Function} options.beforeKeyDown A hook fired before the `keydown` event is handled. You can use it to [block a keyboard shortcut's actions](@/guides/navigation/keyboard-shortcuts.md#block-a-keyboard-shortcut-s-actions).
  * @param {Function} options.afterKeyDown A hook fired after the `keydown` event is handled
  */
 export const createShortcutManager = _ref => {