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

package/core/focusCatcher/index.mjs

@@ -1,127 +0,0 @@
-import { GRID_GROUP } from "../../shortcutContexts/index.mjs";
-import { installFocusDetector } from "../../utils/focusDetector.mjs";
-import { normalizeCoordsIfNeeded } from "./utils.mjs";
-import { getMostTopStartPosition, getMostBottomEndPosition } from "../../helpers/mixed.mjs";
-/**
- * Installs a focus catcher module. The module observes when the table is focused and depending on
- * from the which side it was focused on it selects a specified cell or releases the TAB navigation
- * to the browser.
- *
- * @param {Core} hot The Handsontable instance.
- */
-export function installFocusCatcher(hot) {
-  const clampCoordsIfNeeded = normalizeCoordsIfNeeded(hot);
-  let recentlyAddedFocusCoords;
-  const {
-    activate,
-    deactivate
-  } = installFocusDetector(hot, hot.rootGridElement, {
-    onFocus(from) {
-      if (from === 'from_above') {
-        var _clampCoordsIfNeeded;
-        const mostTopStartCoords = (_clampCoordsIfNeeded = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded !== void 0 ? _clampCoordsIfNeeded : getMostTopStartPosition(hot);
-        const result = hot.runHooks('modifyFocusOnTabNavigation', 'from_above', mostTopStartCoords);
-        if (mostTopStartCoords && result !== false) {
-          hot.selectCell(mostTopStartCoords.row, mostTopStartCoords.col);
-        }
-      } else {
-        var _clampCoordsIfNeeded2;
-        const mostBottomEndCoords = (_clampCoordsIfNeeded2 = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded2 !== void 0 ? _clampCoordsIfNeeded2 : getMostBottomEndPosition(hot);
-        const result = hot.runHooks('modifyFocusOnTabNavigation', 'from_below', mostBottomEndCoords);
-        if (mostBottomEndCoords && result !== false) {
-          hot.selectCell(mostBottomEndCoords.row, mostBottomEndCoords.col);
-        }
-      }
-      hot.listen();
-    }
-  });
-  const rowWrapState = {
-    wrapped: false,
-    flipped: false
-  };
-  let isSavingCoordsEnabled = true;
-  let isTabOrShiftTabPressed = false;
-  let preventViewportScroll = false;
-  hot.addHook('afterListen', () => {
-    const activeContextName = hot.getShortcutManager().getActiveContextName();
-    const activeContext = hot.getShortcutManager().getContext(activeContextName);
-    if ((activeContext === null || activeContext === void 0 ? void 0 : activeContext.scope) === 'table') {
-      deactivate();
-    }
-  });
-  hot.addHook('afterUnlisten', () => {
-    const activeContextName = hot.getShortcutManager().getActiveContextName();
-    const activeContext = hot.getShortcutManager().getContext(activeContextName);
-    if ((activeContext === null || activeContext === void 0 ? void 0 : activeContext.scope) === 'table') {
-      activate();
-    }
-  });
-  hot.addHook('afterSelection', (row, column, row2, column2, preventScrolling) => {
-    if (isTabOrShiftTabPressed && (rowWrapState.wrapped && rowWrapState.flipped || preventViewportScroll)) {
-      preventViewportScroll = false;
-      preventScrolling.value = true;
-    }
-    if (isSavingCoordsEnabled) {
-      var _hot$getSelectedRange;
-      recentlyAddedFocusCoords = (_hot$getSelectedRange = hot.getSelectedRangeActive()) === null || _hot$getSelectedRange === void 0 ? void 0 : _hot$getSelectedRange.highlight;
-    }
-  });
-  hot.addHook('beforeRowWrap', (interruptedByAutoInsertMode, newCoords, isFlipped) => {
-    rowWrapState.wrapped = true;
-    rowWrapState.flipped = isFlipped;
-  });
-
-  /**
-   * Unselects the cell and deactivates the table.
-   */
-  function deactivateTable() {
-    rowWrapState.wrapped = false;
-    rowWrapState.flipped = false;
-    hot.deselectCell();
-    hot.unlisten();
-  }
-  const shortcutOptions = {
-    keys: [['Tab'], ['Shift', 'Tab']],
-    preventDefault: false,
-    stopPropagation: false,
-    relativeToGroup: GRID_GROUP,
-    group: 'focusCatcher'
-  };
-  hot.getShortcutManager().getContext('grid').addShortcuts([{
-    ...shortcutOptions,
-    callback: () => {
-      const {
-        tabNavigation
-      } = hot.getSettings();
-      isTabOrShiftTabPressed = true;
-      if (hot.getSelectedRangeActive() && !tabNavigation) {
-        isSavingCoordsEnabled = false;
-      }
-      if (!tabNavigation) {
-        preventViewportScroll = true;
-      }
-    },
-    position: 'before'
-  }, {
-    ...shortcutOptions,
-    callback: event => {
-      const {
-        tabNavigation,
-        autoWrapRow
-      } = hot.getSettings();
-      isTabOrShiftTabPressed = false;
-      isSavingCoordsEnabled = true;
-      if (!tabNavigation || !hot.selection.isSelected() || autoWrapRow && rowWrapState.wrapped && rowWrapState.flipped || !autoWrapRow && rowWrapState.wrapped) {
-        if (autoWrapRow && rowWrapState.wrapped && rowWrapState.flipped) {
-          recentlyAddedFocusCoords = event.shiftKey ? getMostTopStartPosition(hot) : getMostBottomEndPosition(hot);
-        }
-        deactivateTable();
-        return false;
-      }
-
-      // if the selection is still within the table's range then prevent default action
-      event.preventDefault();
-    },
-    position: 'after'
-  }]);
-}

package/core/focusCatcher/utils.js

@@ -1,31 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.normalizeCoordsIfNeeded = normalizeCoordsIfNeeded;
-var _number = require("../../helpers/number");
-var _mixed = require("../../helpers/mixed");
-/**
- * Normalizes the coordinates (clamps to nearest visible cell position within dataset range).
- *
- * @param {Core} hot The Handsontable instance.
- * @returns {function(Coords | undefined): Coords | null}
- */
-function normalizeCoordsIfNeeded(hot) {
-  return coords => {
-    if (!coords) {
-      return null;
-    }
-    const {
-      rowIndexMapper,
-      columnIndexMapper
-    } = hot;
-    if (rowIndexMapper.isHidden(coords.row) || columnIndexMapper.isHidden(coords.col)) {
-      return null;
-    }
-    const mostTopStartCoords = (0, _mixed.getMostTopStartPosition)(hot);
-    const mostBottomEndCoords = (0, _mixed.getMostBottomEndPosition)(hot);
-    coords.row = (0, _number.clamp)(coords.row, mostTopStartCoords.row, mostBottomEndCoords.row);
-    coords.col = (0, _number.clamp)(coords.col, mostTopStartCoords.col, mostBottomEndCoords.col);
-    return coords;
-  };
-}

package/core/focusCatcher/utils.mjs

@@ -1,27 +0,0 @@
-import { clamp } from "../../helpers/number.mjs";
-import { getMostTopStartPosition, getMostBottomEndPosition } from "../../helpers/mixed.mjs";
-/**
- * Normalizes the coordinates (clamps to nearest visible cell position within dataset range).
- *
- * @param {Core} hot The Handsontable instance.
- * @returns {function(Coords | undefined): Coords | null}
- */
-export function normalizeCoordsIfNeeded(hot) {
-  return coords => {
-    if (!coords) {
-      return null;
-    }
-    const {
-      rowIndexMapper,
-      columnIndexMapper
-    } = hot;
-    if (rowIndexMapper.isHidden(coords.row) || columnIndexMapper.isHidden(coords.col)) {
-      return null;
-    }
-    const mostTopStartCoords = getMostTopStartPosition(hot);
-    const mostBottomEndCoords = getMostBottomEndPosition(hot);
-    coords.row = clamp(coords.row, mostTopStartCoords.row, mostBottomEndCoords.row);
-    coords.col = clamp(coords.col, mostTopStartCoords.col, mostBottomEndCoords.col);
-    return coords;
-  };
-}

package/plugins/pagination/focusController.js

@@ -1,27 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.createPaginationFocusController = createPaginationFocusController;
-var _paginator = require("../../utils/paginator");
-/**
- * Creates a pagination focus controller instance.
- *
- * @private
- * @param {object} options The options for the pagination focus controller.
- * @param {HTMLElement[]} options.focusableElements The focusable elements.
- * @returns {PaginationController} The pagination controller instance.
- */
-function createPaginationFocusController(_ref) {
-  let {
-    focusableElements
-  } = _ref;
-  const navigator = (0, _paginator.createPaginator)({
-    initialPage: 0,
-    size: () => focusableElements().length,
-    onItemSelect: currentIndex => {
-      const elements = focusableElements();
-      elements[currentIndex].focus();
-    }
-  });
-  return navigator;
-}

package/plugins/pagination/focusController.mjs

@@ -1,23 +0,0 @@
-import { createPaginator } from "../../utils/paginator.mjs";
-/**
- * Creates a pagination focus controller instance.
- *
- * @private
- * @param {object} options The options for the pagination focus controller.
- * @param {HTMLElement[]} options.focusableElements The focusable elements.
- * @returns {PaginationController} The pagination controller instance.
- */
-export function createPaginationFocusController(_ref) {
-  let {
-    focusableElements
-  } = _ref;
-  const navigator = createPaginator({
-    initialPage: 0,
-    size: () => focusableElements().length,
-    onItemSelect: currentIndex => {
-      const elements = focusableElements();
-      elements[currentIndex].focus();
-    }
-  });
-  return navigator;
-}