handsontable 16.1.1-next-895fbb8-20250923 → 16.2.0-next-216dbd0-20251112

package/dist/languages/zh-TW.min.js

@@ -1 +1 @@
-!function(E,T){if("object"==typeof exports&&"object"==typeof module)module.exports=T(require("handsontable"));else if("function"==typeof define&&define.amd)define(["handsontable"],T);else{var _="object"==typeof exports?T(require("handsontable")):T(E.Handsontable);for(var N in _)("object"==typeof exports?exports:E)[N]=_[N]}}("undefined"!=typeof self?self:this,E=>(()=>{var T={238:E=>{E.exports=function(E){return E&&E.__esModule?E:{default:E}},E.exports.__esModule=!0,E.exports.default=E.exports},330:T=>{"use strict";T.exports=E}},_={};function N(E){var I=_[E];if(void 0!==I)return I.exports;var O=_[E]={exports:{}};return T[E](O,O.exports,N),O.exports}var I={};return(()=>{"use strict";var E=N(238)(N(330));const T=E.default.languages.dictionaryKeys,_={languageCode:"zh-TW",[T.CONTEXTMENU_ITEMS_ROW_ABOVE]:"上方插入列",[T.CONTEXTMENU_ITEMS_ROW_BELOW]:"下方插入列",[T.CONTEXTMENU_ITEMS_INSERT_LEFT]:"左方插入欄",[T.CONTEXTMENU_ITEMS_INSERT_RIGHT]:"右方插入欄",[T.CONTEXTMENU_ITEMS_REMOVE_ROW]:["移除該列","移除多列"],[T.CONTEXTMENU_ITEMS_REMOVE_COLUMN]:["移除該欄","移除多欄"],[T.CONTEXTMENU_ITEMS_UNDO]:"復原",[T.CONTEXTMENU_ITEMS_REDO]:"取消復原",[T.CONTEXTMENU_ITEMS_READ_ONLY]:"唯讀",[T.CONTEXTMENU_ITEMS_CLEAR_COLUMN]:"清空該欄",[T.CONTEXTMENU_ITEMS_ALIGNMENT]:"對齊",[T.CONTEXTMENU_ITEMS_ALIGNMENT_LEFT]:"靠左",[T.CONTEXTMENU_ITEMS_ALIGNMENT_CENTER]:"水平置中",[T.CONTEXTMENU_ITEMS_ALIGNMENT_RIGHT]:"靠右",[T.CONTEXTMENU_ITEMS_ALIGNMENT_JUSTIFY]:"左右對齊",[T.CONTEXTMENU_ITEMS_ALIGNMENT_TOP]:"靠上",[T.CONTEXTMENU_ITEMS_ALIGNMENT_MIDDLE]:"垂直置中",[T.CONTEXTMENU_ITEMS_ALIGNMENT_BOTTOM]:"靠下",[T.CONTEXTMENU_ITEMS_FREEZE_COLUMN]:"凍結欄位",[T.CONTEXTMENU_ITEMS_UNFREEZE_COLUMN]:"取消凍結欄位",[T.CONTEXTMENU_ITEMS_BORDERS]:"邊界",[T.CONTEXTMENU_ITEMS_BORDERS_TOP]:"上",[T.CONTEXTMENU_ITEMS_BORDERS_RIGHT]:"右",[T.CONTEXTMENU_ITEMS_BORDERS_BOTTOM]:"下",[T.CONTEXTMENU_ITEMS_BORDERS_LEFT]:"左",[T.CONTEXTMENU_ITEMS_REMOVE_BORDERS]:"移除邊界",[T.CONTEXTMENU_ITEMS_ADD_COMMENT]:"加入評論",[T.CONTEXTMENU_ITEMS_EDIT_COMMENT]:"編輯評論",[T.CONTEXTMENU_ITEMS_REMOVE_COMMENT]:"刪除評論",[T.CONTEXTMENU_ITEMS_READ_ONLY_COMMENT]:"唯讀評論",[T.CONTEXTMENU_ITEMS_MERGE_CELLS]:"合併欄位",[T.CONTEXTMENU_ITEMS_UNMERGE_CELLS]:"取消合併欄位",[T.CONTEXTMENU_ITEMS_COPY]:"複製",[T.CONTEXTMENU_ITEMS_CUT]:"剪下",[T.CONTEXTMENU_ITEMS_NESTED_ROWS_INSERT_CHILD]:"插入子列",[T.CONTEXTMENU_ITEMS_NESTED_ROWS_DETACH_CHILD]:"與母列分離",[T.CONTEXTMENU_ITEMS_HIDE_COLUMN]:["隱藏該欄","隱藏多欄"],[T.CONTEXTMENU_ITEMS_SHOW_COLUMN]:["顯示該欄","顯示多欄"],[T.CONTEXTMENU_ITEMS_HIDE_ROW]:["隱藏該列","隱藏多列"],[T.CONTEXTMENU_ITEMS_SHOW_ROW]:["顯示該列","顯示多列"],[T.FILTERS_CONDITIONS_NONE]:"無",[T.FILTERS_CONDITIONS_EMPTY]:"為空",[T.FILTERS_CONDITIONS_NOT_EMPTY]:"不為空",[T.FILTERS_CONDITIONS_EQUAL]:"等於",[T.FILTERS_CONDITIONS_NOT_EQUAL]:"不等於",[T.FILTERS_CONDITIONS_BEGINS_WITH]:"開頭是",[T.FILTERS_CONDITIONS_ENDS_WITH]:"結尾是",[T.FILTERS_CONDITIONS_CONTAINS]:"包含",[T.FILTERS_CONDITIONS_NOT_CONTAIN]:"不包含",[T.FILTERS_CONDITIONS_GREATER_THAN]:"大於",[T.FILTERS_CONDITIONS_GREATER_THAN_OR_EQUAL]:"大於或等於",[T.FILTERS_CONDITIONS_LESS_THAN]:"小於",[T.FILTERS_CONDITIONS_LESS_THAN_OR_EQUAL]:"小於或等於",[T.FILTERS_CONDITIONS_BETWEEN]:"在此範圍",[T.FILTERS_CONDITIONS_NOT_BETWEEN]:"不在此範圍",[T.FILTERS_CONDITIONS_AFTER]:"之後",[T.FILTERS_CONDITIONS_BEFORE]:"之前",[T.FILTERS_CONDITIONS_TODAY]:"今天",[T.FILTERS_CONDITIONS_TOMORROW]:"明天",[T.FILTERS_CONDITIONS_YESTERDAY]:"昨天",[T.FILTERS_VALUES_BLANK_CELLS]:"空白格",[T.FILTERS_DIVS_FILTER_BY_CONDITION]:"依條件過濾",[T.FILTERS_DIVS_FILTER_BY_VALUE]:"依值過濾",[T.FILTERS_LABELS_CONJUNCTION]:"且",[T.FILTERS_LABELS_DISJUNCTION]:"或",[T.FILTERS_BUTTONS_SELECT_ALL]:"全選",[T.FILTERS_BUTTONS_CLEAR]:"清除",[T.FILTERS_BUTTONS_OK]:"確認",[T.FILTERS_BUTTONS_CANCEL]:"取消",[T.FILTERS_BUTTONS_PLACEHOLDER_SEARCH]:"搜尋",[T.FILTERS_BUTTONS_PLACEHOLDER_VALUE]:"值",[T.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]:"第二值",[T.PAGINATION_SECTION]:"分頁",[T.PAGINATION_PAGE_SIZE_SECTION]:"每頁行數",[T.PAGINATION_PAGE_SIZE_AUTO]:"自動",[T.PAGINATION_COUNTER_SECTION]:"[start] - [end] 共 [total]",[T.PAGINATION_NAV_SECTION]:"第 [currentPage] 頁，共 [totalPages] 頁",[T.PAGINATION_FIRST_PAGE]:"轉到第一頁",[T.PAGINATION_PREV_PAGE]:"轉到上一頁",[T.PAGINATION_NEXT_PAGE]:"轉到下一頁",[T.PAGINATION_LAST_PAGE]:"轉到最後一頁",[T.LOADING_TITLE]:"載入中..."};E.default.languages.registerLanguageDictionary(_)})(),I=I.___})());
+!function(T,E){if("object"==typeof exports&&"object"==typeof module)module.exports=E(require("handsontable"));else if("function"==typeof define&&define.amd)define(["handsontable"],E);else{var _="object"==typeof exports?E(require("handsontable")):E(T.Handsontable);for(var N in _)("object"==typeof exports?exports:T)[N]=_[N]}}("undefined"!=typeof self?self:this,T=>(()=>{var E={238:T=>{T.exports=function(T){return T&&T.__esModule?T:{default:T}},T.exports.__esModule=!0,T.exports.default=T.exports},330:E=>{"use strict";E.exports=T}},_={};function N(T){var I=_[T];if(void 0!==I)return I.exports;var O=_[T]={exports:{}};return E[T](O,O.exports,N),O.exports}var I={};return(()=>{"use strict";var T=N(238)(N(330));const E=T.default.languages.dictionaryKeys,_={languageCode:"zh-TW",[E.OK]:"確認",[E.CANCEL]:"取消",[E.CONTEXTMENU_ITEMS_ROW_ABOVE]:"上方插入列",[E.CONTEXTMENU_ITEMS_ROW_BELOW]:"下方插入列",[E.CONTEXTMENU_ITEMS_INSERT_LEFT]:"左方插入欄",[E.CONTEXTMENU_ITEMS_INSERT_RIGHT]:"右方插入欄",[E.CONTEXTMENU_ITEMS_REMOVE_ROW]:["移除該列","移除多列"],[E.CONTEXTMENU_ITEMS_REMOVE_COLUMN]:["移除該欄","移除多欄"],[E.CONTEXTMENU_ITEMS_UNDO]:"復原",[E.CONTEXTMENU_ITEMS_REDO]:"取消復原",[E.CONTEXTMENU_ITEMS_READ_ONLY]:"唯讀",[E.CONTEXTMENU_ITEMS_CLEAR_COLUMN]:"清空該欄",[E.CONTEXTMENU_ITEMS_ALIGNMENT]:"對齊",[E.CONTEXTMENU_ITEMS_ALIGNMENT_LEFT]:"靠左",[E.CONTEXTMENU_ITEMS_ALIGNMENT_CENTER]:"水平置中",[E.CONTEXTMENU_ITEMS_ALIGNMENT_RIGHT]:"靠右",[E.CONTEXTMENU_ITEMS_ALIGNMENT_JUSTIFY]:"左右對齊",[E.CONTEXTMENU_ITEMS_ALIGNMENT_TOP]:"靠上",[E.CONTEXTMENU_ITEMS_ALIGNMENT_MIDDLE]:"垂直置中",[E.CONTEXTMENU_ITEMS_ALIGNMENT_BOTTOM]:"靠下",[E.CONTEXTMENU_ITEMS_FREEZE_COLUMN]:"凍結欄位",[E.CONTEXTMENU_ITEMS_UNFREEZE_COLUMN]:"取消凍結欄位",[E.CONTEXTMENU_ITEMS_BORDERS]:"邊界",[E.CONTEXTMENU_ITEMS_BORDERS_TOP]:"上",[E.CONTEXTMENU_ITEMS_BORDERS_RIGHT]:"右",[E.CONTEXTMENU_ITEMS_BORDERS_BOTTOM]:"下",[E.CONTEXTMENU_ITEMS_BORDERS_LEFT]:"左",[E.CONTEXTMENU_ITEMS_REMOVE_BORDERS]:"移除邊界",[E.CONTEXTMENU_ITEMS_ADD_COMMENT]:"加入評論",[E.CONTEXTMENU_ITEMS_EDIT_COMMENT]:"編輯評論",[E.CONTEXTMENU_ITEMS_REMOVE_COMMENT]:"刪除評論",[E.CONTEXTMENU_ITEMS_READ_ONLY_COMMENT]:"唯讀評論",[E.CONTEXTMENU_ITEMS_MERGE_CELLS]:"合併欄位",[E.CONTEXTMENU_ITEMS_UNMERGE_CELLS]:"取消合併欄位",[E.CONTEXTMENU_ITEMS_COPY]:"複製",[E.CONTEXTMENU_ITEMS_CUT]:"剪下",[E.CONTEXTMENU_ITEMS_NESTED_ROWS_INSERT_CHILD]:"插入子列",[E.CONTEXTMENU_ITEMS_NESTED_ROWS_DETACH_CHILD]:"與母列分離",[E.CONTEXTMENU_ITEMS_HIDE_COLUMN]:["隱藏該欄","隱藏多欄"],[E.CONTEXTMENU_ITEMS_SHOW_COLUMN]:["顯示該欄","顯示多欄"],[E.CONTEXTMENU_ITEMS_HIDE_ROW]:["隱藏該列","隱藏多列"],[E.CONTEXTMENU_ITEMS_SHOW_ROW]:["顯示該列","顯示多列"],[E.FILTERS_CONDITIONS_NONE]:"無",[E.FILTERS_CONDITIONS_EMPTY]:"為空",[E.FILTERS_CONDITIONS_NOT_EMPTY]:"不為空",[E.FILTERS_CONDITIONS_EQUAL]:"等於",[E.FILTERS_CONDITIONS_NOT_EQUAL]:"不等於",[E.FILTERS_CONDITIONS_BEGINS_WITH]:"開頭是",[E.FILTERS_CONDITIONS_ENDS_WITH]:"結尾是",[E.FILTERS_CONDITIONS_CONTAINS]:"包含",[E.FILTERS_CONDITIONS_NOT_CONTAIN]:"不包含",[E.FILTERS_CONDITIONS_GREATER_THAN]:"大於",[E.FILTERS_CONDITIONS_GREATER_THAN_OR_EQUAL]:"大於或等於",[E.FILTERS_CONDITIONS_LESS_THAN]:"小於",[E.FILTERS_CONDITIONS_LESS_THAN_OR_EQUAL]:"小於或等於",[E.FILTERS_CONDITIONS_BETWEEN]:"在此範圍",[E.FILTERS_CONDITIONS_NOT_BETWEEN]:"不在此範圍",[E.FILTERS_CONDITIONS_AFTER]:"之後",[E.FILTERS_CONDITIONS_BEFORE]:"之前",[E.FILTERS_CONDITIONS_TODAY]:"今天",[E.FILTERS_CONDITIONS_TOMORROW]:"明天",[E.FILTERS_CONDITIONS_YESTERDAY]:"昨天",[E.FILTERS_VALUES_BLANK_CELLS]:"空白格",[E.FILTERS_DIVS_FILTER_BY_CONDITION]:"依條件過濾",[E.FILTERS_DIVS_FILTER_BY_VALUE]:"依值過濾",[E.FILTERS_LABELS_CONJUNCTION]:"且",[E.FILTERS_LABELS_DISJUNCTION]:"或",[E.FILTERS_BUTTONS_SELECT_ALL]:"全選",[E.FILTERS_BUTTONS_CLEAR]:"清除",[E.FILTERS_BUTTONS_OK]:"確認",[E.FILTERS_BUTTONS_CANCEL]:"取消",[E.FILTERS_BUTTONS_PLACEHOLDER_SEARCH]:"搜尋",[E.FILTERS_BUTTONS_PLACEHOLDER_VALUE]:"值",[E.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]:"第二值",[E.PAGINATION_SECTION]:"分頁",[E.PAGINATION_PAGE_SIZE_SECTION]:"每頁行數",[E.PAGINATION_PAGE_SIZE_AUTO]:"自動",[E.PAGINATION_COUNTER_SECTION]:"[start] - [end] 共 [total]",[E.PAGINATION_NAV_SECTION]:"第 [currentPage] 頁，共 [totalPages] 頁",[E.PAGINATION_FIRST_PAGE]:"轉到第一頁",[E.PAGINATION_PREV_PAGE]:"轉到上一頁",[E.PAGINATION_NEXT_PAGE]:"轉到下一頁",[E.PAGINATION_LAST_PAGE]:"轉到最後一頁",[E.LOADING_TITLE]:"載入中...",[E.EMPTY_DATA_STATE_TITLE]:"暫無資料",[E.EMPTY_DATA_STATE_DESCRIPTION]:"暫無內容可顯示。",[E.EMPTY_DATA_STATE_TITLE_FILTERS]:"未找到結果",[E.EMPTY_DATA_STATE_DESCRIPTION_FILTERS]:"看起來您目前的過濾器隱藏了所有結果。",[E.EMPTY_DATA_STATE_BUTTONS_FILTERS_RESET]:"重設過濾器"};T.default.languages.registerLanguageDictionary(_)})(),I=I.___})());

package/editors/autocompleteEditor/autocompleteEditor.js

@@ -225,6 +225,24 @@ class AutocompleteEditor extends _handsontableEditor.HandsontableEditor {
     this.hot.view.render();
   }
 
+  /**
+   * Finishes editing and start saving or restoring process for editing cell.
+   *
+   * @param {boolean} restoreOriginalValue If true, then closes editor without saving value from the editor into a cell.
+   * @param {boolean} ctrlDown If true, then saveValue will save editor's value to each cell in the last selected range.
+   * @param {Function} callback The callback function, fired after editor closing.
+   */
+  finishEditing(restoreOriginalValue, ctrlDown, callback) {
+    if (this.isOpened()) {
+      const lastSelectedRange = this.hot.getSelectedRangeActive();
+      if ((0, _mixed.isUndefined)(lastSelectedRange) || (0, _mixed.isDefined)(lastSelectedRange) && !lastSelectedRange.includes(this.hot._createCellCoords(this.row, this.col))) {
+        // Method was triggered by selecting a different cell or deselecting cells.
+        restoreOriginalValue = true;
+      }
+    }
+    super.finishEditing(restoreOriginalValue, ctrlDown, callback);
+  }
+
   /**
    * Prepares choices list based on applied argument.
    *
@@ -279,7 +297,9 @@ class AutocompleteEditor extends _handsontableEditor.HandsontableEditor {
       }
     }
     if (filterSetting === false) {
-      highlightIndex = filteredChoiceIndexes[0];
+      if (value.length > 0) {
+        highlightIndex = filteredChoiceIndexes[0];
+      }
     } else {
       choices = filteredChoiceIndexes.map(index => choices[index]);
       highlightIndex = choices.indexOf(valueToMatch) > -1 ? choices.indexOf(valueToMatch) : 0;

package/editors/autocompleteEditor/autocompleteEditor.mjs

@@ -19,7 +19,7 @@ import { HandsontableEditor } from "../handsontableEditor/index.mjs";
 import { pivot } from "../../helpers/array.mjs";
 import { isObject } from "../../helpers/object.mjs";
 import { addClass, getCaretPosition, getFractionalScalingCompensation, getScrollbarWidth, getSelectionEndPosition, outerWidth, setAttribute, setCaretPosition } from "../../helpers/dom/element.mjs";
-import { isDefined, stringify } from "../../helpers/mixed.mjs";
+import { isUndefined, isDefined, stringify } from "../../helpers/mixed.mjs";
 import { stripTags } from "../../helpers/string.mjs";
 import { KEY_CODES, isPrintableChar } from "../../helpers/unicode.mjs";
 import { textRenderer } from "../../renderers/textRenderer/index.mjs";
@@ -222,6 +222,24 @@ export class AutocompleteEditor extends HandsontableEditor {
     this.hot.view.render();
   }
 
+  /**
+   * Finishes editing and start saving or restoring process for editing cell.
+   *
+   * @param {boolean} restoreOriginalValue If true, then closes editor without saving value from the editor into a cell.
+   * @param {boolean} ctrlDown If true, then saveValue will save editor's value to each cell in the last selected range.
+   * @param {Function} callback The callback function, fired after editor closing.
+   */
+  finishEditing(restoreOriginalValue, ctrlDown, callback) {
+    if (this.isOpened()) {
+      const lastSelectedRange = this.hot.getSelectedRangeActive();
+      if (isUndefined(lastSelectedRange) || isDefined(lastSelectedRange) && !lastSelectedRange.includes(this.hot._createCellCoords(this.row, this.col))) {
+        // Method was triggered by selecting a different cell or deselecting cells.
+        restoreOriginalValue = true;
+      }
+    }
+    super.finishEditing(restoreOriginalValue, ctrlDown, callback);
+  }
+
   /**
    * Prepares choices list based on applied argument.
    *
@@ -276,7 +294,9 @@ export class AutocompleteEditor extends HandsontableEditor {
       }
     }
     if (filterSetting === false) {
-      highlightIndex = filteredChoiceIndexes[0];
+      if (value.length > 0) {
+        highlightIndex = filteredChoiceIndexes[0];
+      }
     } else {
       choices = filteredChoiceIndexes.map(index => choices[index]);
       highlightIndex = choices.indexOf(valueToMatch) > -1 ? choices.indexOf(valueToMatch) : 0;

package/focusManager/constants.js

@@ -0,0 +1,25 @@
+"use strict";
+
+exports.__esModule = true;
+/**
+ * Focus scope types.
+ */
+const SCOPE_TYPES = exports.SCOPE_TYPES = Object.freeze({
+  INLINE: 'inline',
+  MODAL: 'modal'
+});
+
+/**
+ * Focus activation sources.
+ */
+const FOCUS_SOURCES = exports.FOCUS_SOURCES = Object.freeze({
+  UNKNOWN: 'unknown',
+  CLICK: 'click',
+  TAB_FROM_ABOVE: 'tab_from_above',
+  TAB_FROM_BELOW: 'tab_from_below'
+});
+
+/**
+ * Default shortcuts context name.
+ */
+const DEFAULT_SHORTCUTS_CONTEXT = exports.DEFAULT_SHORTCUTS_CONTEXT = 'grid';

package/focusManager/constants.mjs

@@ -0,0 +1,22 @@
+/**
+ * Focus scope types.
+ */
+export const SCOPE_TYPES = Object.freeze({
+  INLINE: 'inline',
+  MODAL: 'modal'
+});
+
+/**
+ * Focus activation sources.
+ */
+export const FOCUS_SOURCES = Object.freeze({
+  UNKNOWN: 'unknown',
+  CLICK: 'click',
+  TAB_FROM_ABOVE: 'tab_from_above',
+  TAB_FROM_BELOW: 'tab_from_below'
+});
+
+/**
+ * Default shortcuts context name.
+ */
+export const DEFAULT_SHORTCUTS_CONTEXT = 'grid';

package/focusManager/eventListener.js

@@ -0,0 +1,107 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useEventListener = useEventListener;
+var _element = require("../helpers/dom/element");
+/**
+ * An event listener, used for tracking focus-related and click events necessary for focus management.
+ *
+ * @param {Window} ownerWindow Current window object.
+ * @param {object} hooks A callback functions.
+ * @param {function(Event)} hooks.onFocus A callback function for focusin events.
+ * @param {function(Event)} hooks.onClick A callback function for click events.
+ * @param {function(Event)} hooks.onTabKeyDown A callback function for tab key down events.
+ * @returns {{mount: function(), unmount: function()}}
+ */
+function useEventListener(ownerWindow) {
+  let hooks = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  let mouseDown = false;
+
+  /**
+   * A callback function for focusin events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleFocus(event) {
+    if (!mouseDown) {
+      var _hooks$onFocus;
+      (_hooks$onFocus = hooks.onFocus) === null || _hooks$onFocus === void 0 || _hooks$onFocus.call(hooks, event);
+    }
+  }
+
+  /**
+   * A callback function for click events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleClick(event) {
+    var _hooks$onClick;
+    (_hooks$onClick = hooks.onClick) === null || _hooks$onClick === void 0 || _hooks$onClick.call(hooks, event);
+  }
+
+  /**
+   * A callback function for tab key down events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleKeyDown(event) {
+    if (event.key === 'Tab') {
+      var _hooks$onTabKeyDown;
+      (_hooks$onTabKeyDown = hooks.onTabKeyDown) === null || _hooks$onTabKeyDown === void 0 || _hooks$onTabKeyDown.call(hooks, event);
+    }
+  }
+
+  /**
+   * A callback function for mouse down events.
+   */
+  function handleMouseDown() {
+    mouseDown = true;
+  }
+
+  /**
+   * A callback function for mouse up events.
+   */
+  function handleMouseUp() {
+    mouseDown = false;
+  }
+
+  /**
+   * Adds event listeners to the starting window and its parents' windows.
+   */
+  const mount = () => {
+    let frameWindow = ownerWindow;
+    while (frameWindow) {
+      const {
+        documentElement
+      } = frameWindow.document;
+      documentElement.addEventListener('focusin', handleFocus);
+      documentElement.addEventListener('click', handleClick);
+      documentElement.addEventListener('keydown', handleKeyDown);
+      documentElement.addEventListener('mousedown', handleMouseDown);
+      documentElement.addEventListener('mouseup', handleMouseUp);
+      frameWindow = (0, _element.getParentWindow)(frameWindow);
+    }
+  };
+
+  /**
+   * Removes event listeners from the starting window and its parents' windows.
+   */
+  const unmount = () => {
+    let frameWindow = ownerWindow;
+    while (frameWindow) {
+      const {
+        documentElement
+      } = frameWindow.document;
+      documentElement.removeEventListener('focusin', handleFocus);
+      documentElement.removeEventListener('click', handleClick);
+      documentElement.removeEventListener('keydown', handleKeyDown);
+      documentElement.removeEventListener('mousedown', handleMouseDown);
+      documentElement.removeEventListener('mouseup', handleMouseUp);
+      frameWindow = (0, _element.getParentWindow)(frameWindow);
+    }
+  };
+  return {
+    mount,
+    unmount
+  };
+}

package/focusManager/eventListener.mjs

@@ -0,0 +1,103 @@
+import { getParentWindow } from "../helpers/dom/element.mjs";
+/**
+ * An event listener, used for tracking focus-related and click events necessary for focus management.
+ *
+ * @param {Window} ownerWindow Current window object.
+ * @param {object} hooks A callback functions.
+ * @param {function(Event)} hooks.onFocus A callback function for focusin events.
+ * @param {function(Event)} hooks.onClick A callback function for click events.
+ * @param {function(Event)} hooks.onTabKeyDown A callback function for tab key down events.
+ * @returns {{mount: function(), unmount: function()}}
+ */
+export function useEventListener(ownerWindow) {
+  let hooks = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  let mouseDown = false;
+
+  /**
+   * A callback function for focusin events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleFocus(event) {
+    if (!mouseDown) {
+      var _hooks$onFocus;
+      (_hooks$onFocus = hooks.onFocus) === null || _hooks$onFocus === void 0 || _hooks$onFocus.call(hooks, event);
+    }
+  }
+
+  /**
+   * A callback function for click events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleClick(event) {
+    var _hooks$onClick;
+    (_hooks$onClick = hooks.onClick) === null || _hooks$onClick === void 0 || _hooks$onClick.call(hooks, event);
+  }
+
+  /**
+   * A callback function for tab key down events.
+   *
+   * @param {Event} event The event object.
+   */
+  function handleKeyDown(event) {
+    if (event.key === 'Tab') {
+      var _hooks$onTabKeyDown;
+      (_hooks$onTabKeyDown = hooks.onTabKeyDown) === null || _hooks$onTabKeyDown === void 0 || _hooks$onTabKeyDown.call(hooks, event);
+    }
+  }
+
+  /**
+   * A callback function for mouse down events.
+   */
+  function handleMouseDown() {
+    mouseDown = true;
+  }
+
+  /**
+   * A callback function for mouse up events.
+   */
+  function handleMouseUp() {
+    mouseDown = false;
+  }
+
+  /**
+   * Adds event listeners to the starting window and its parents' windows.
+   */
+  const mount = () => {
+    let frameWindow = ownerWindow;
+    while (frameWindow) {
+      const {
+        documentElement
+      } = frameWindow.document;
+      documentElement.addEventListener('focusin', handleFocus);
+      documentElement.addEventListener('click', handleClick);
+      documentElement.addEventListener('keydown', handleKeyDown);
+      documentElement.addEventListener('mousedown', handleMouseDown);
+      documentElement.addEventListener('mouseup', handleMouseUp);
+      frameWindow = getParentWindow(frameWindow);
+    }
+  };
+
+  /**
+   * Removes event listeners from the starting window and its parents' windows.
+   */
+  const unmount = () => {
+    let frameWindow = ownerWindow;
+    while (frameWindow) {
+      const {
+        documentElement
+      } = frameWindow.document;
+      documentElement.removeEventListener('focusin', handleFocus);
+      documentElement.removeEventListener('click', handleClick);
+      documentElement.removeEventListener('keydown', handleKeyDown);
+      documentElement.removeEventListener('mousedown', handleMouseDown);
+      documentElement.removeEventListener('mouseup', handleMouseUp);
+      frameWindow = getParentWindow(frameWindow);
+    }
+  };
+  return {
+    mount,
+    unmount
+  };
+}

package/{focusManager.d.ts → focusManager/grid.d.ts}

@@ -1,6 +1,6 @@
 type FocusMode = 'cell' | 'mixed';
 
-export interface FocusManager {
+export interface GridFocusManager {
   getFocusMode(): FocusMode;
   setFocusMode(focusMode: FocusMode): void;
   getRefocusDelay(): number;

package/{focusManager.js → focusManager/grid.js}

@@ -2,9 +2,9 @@
 
 exports.__esModule = true;
 require("core-js/modules/es.error.cause.js");
-var _console = require("./helpers/console");
-var _element = require("./helpers/dom/element");
-var _function = require("./helpers/function");
+var _console = require("../helpers/console");
+var _element = require("../helpers/dom/element");
+var _function = require("../helpers/function");
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
 function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
@@ -25,23 +25,24 @@ const FOCUS_MODES = Object.freeze({
 });
 
 /**
- * Manages the browser's focus in the table.
+ * Manages the browser's focus in the table to achieve correct behavior for screen readers and
+ * IME editors.
  */
 var _hot = /*#__PURE__*/new WeakMap();
 var _focusMode = /*#__PURE__*/new WeakMap();
 var _refocusDelay = /*#__PURE__*/new WeakMap();
 var _refocusElementGetter = /*#__PURE__*/new WeakMap();
 var _debouncedSelect = /*#__PURE__*/new WeakMap();
-var _FocusManager_brand = /*#__PURE__*/new WeakSet();
-class FocusManager {
+var _hasSelectionChange = /*#__PURE__*/new WeakMap();
+var _FocusGridManager_brand = /*#__PURE__*/new WeakSet();
+class FocusGridManager {
   constructor(hotInstance) {
-    var _this = this;
     /**
      * Get and return the currently selected and highlighted cell/header element.
      *
      * @param {Function} callback Callback function to be called after the cell element is retrieved.
      */
-    _classPrivateMethodInitSpec(this, _FocusManager_brand);
+    _classPrivateMethodInitSpec(this, _FocusGridManager_brand);
     /**
      * The Handsontable instance.
      */
@@ -77,32 +78,47 @@ class FocusManager {
      * @type {Map<number, Function>}
      */
     _classPrivateFieldInitSpec(this, _debouncedSelect, new Map());
-    const hotSettings = hotInstance.getSettings();
+    /**
+     * Flag to indicate if the selection has changed.
+     *
+     * @type {boolean}
+     */
+    _classPrivateFieldInitSpec(this, _hasSelectionChange, false);
     _classPrivateFieldSet(_hot, this, hotInstance);
+  }
+  init() {
+    var _this = this;
+    const hotSettings = _classPrivateFieldGet(_hot, this).getSettings();
     _classPrivateFieldSet(_focusMode, this, hotSettings.imeFastEdit ? FOCUS_MODES.MIXED : FOCUS_MODES.CELL);
     _classPrivateFieldGet(_hot, this).addHook('afterUpdateSettings', function () {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
         args[_key] = arguments[_key];
       }
-      return _assertClassBrand(_FocusManager_brand, _this, _onUpdateSettings).call(_this, ...args);
+      return _assertClassBrand(_FocusGridManager_brand, _this, _onUpdateSettings).call(_this, ...args);
     });
     _classPrivateFieldGet(_hot, this).addHook('afterSelection', function () {
       for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
         args[_key2] = arguments[_key2];
       }
-      return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
+      return _assertClassBrand(_FocusGridManager_brand, _this, _onAfterSelectionChange).call(_this, ...args);
     });
     _classPrivateFieldGet(_hot, this).addHook('afterSelectionFocusSet', function () {
       for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
         args[_key3] = arguments[_key3];
       }
-      return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
+      return _assertClassBrand(_FocusGridManager_brand, _this, _onAfterSelectionChange).call(_this, ...args);
     });
     _classPrivateFieldGet(_hot, this).addHook('afterSelectionEnd', function () {
       for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
         args[_key4] = arguments[_key4];
       }
-      return _assertClassBrand(_FocusManager_brand, _this, _focusEditorElement).call(_this, ...args);
+      return _assertClassBrand(_FocusGridManager_brand, _this, _focusEditorElement).call(_this, ...args);
+    });
+    _classPrivateFieldGet(_hot, this).addHook('afterRender', function () {
+      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
+        args[_key5] = arguments[_key5];
+      }
+      return _assertClassBrand(_FocusGridManager_brand, _this, _onAfterRender).call(_this, ...args);
     });
   }
 
@@ -195,7 +211,7 @@ class FocusManager {
     if (selectedCell) {
       focusElement(selectedCell);
     } else {
-      _assertClassBrand(_FocusManager_brand, this, _getSelectedCell).call(this, element => focusElement(element));
+      _assertClassBrand(_FocusGridManager_brand, this, _getSelectedCell).call(this, element => focusElement(element));
     }
   }
 
@@ -224,7 +240,7 @@ class FocusManager {
     }
   }
 }
-exports.FocusManager = FocusManager;
+exports.FocusGridManager = FocusGridManager;
 function _getSelectedCell(callback) {
   var _classPrivateFieldGet8;
   const highlight = (_classPrivateFieldGet8 = _classPrivateFieldGet(_hot, this).getSelectedRangeActive()) === null || _classPrivateFieldGet8 === void 0 ? void 0 : _classPrivateFieldGet8.highlight;
@@ -245,7 +261,7 @@ function _getSelectedCell(callback) {
  * Manage the browser's focus after each cell selection change.
  */
 function _focusCell() {
-  _assertClassBrand(_FocusManager_brand, this, _getSelectedCell).call(this, selectedCell => {
+  _assertClassBrand(_FocusGridManager_brand, this, _getSelectedCell).call(this, selectedCell => {
     const {
       activeElement
     } = _classPrivateFieldGet(_hot, this).rootDocument;
@@ -264,12 +280,27 @@ function _focusCell() {
  * Manage the browser's focus after cell selection end.
  */
 function _focusEditorElement() {
-  _assertClassBrand(_FocusManager_brand, this, _getSelectedCell).call(this, selectedCell => {
+  _assertClassBrand(_FocusGridManager_brand, this, _getSelectedCell).call(this, selectedCell => {
     if (this.getFocusMode() === FOCUS_MODES.MIXED && (selectedCell === null || selectedCell === void 0 ? void 0 : selectedCell.nodeName) === 'TD') {
       this.refocusToEditorTextarea();
     }
   });
 }
+/**
+ * Handle the after selection change event.
+ */
+function _onAfterSelectionChange() {
+  _classPrivateFieldSet(_hasSelectionChange, this, true);
+}
+/**
+ * Focuses the cell after the render event when the selection has changed.
+ */
+function _onAfterRender() {
+  if (_classPrivateFieldGet(_hasSelectionChange, this)) {
+    _classPrivateFieldSet(_hasSelectionChange, this, false);
+    _assertClassBrand(_FocusGridManager_brand, this, _focusCell).call(this);
+  }
+}
 /**
  * Update the manager configuration after calling `updateSettings`.
  *