@progress/kendo-react-data-tools 13.3.0 → 13.4.0-develop.1

package/navigation/constants.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_LEVEL = "data-keyboardnavlevel";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_SCOPE = "data-keyboardnavscope";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_HEADER = "data-keyboardnavheader";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_BODY = "data-keyboardnavbody";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_ID = "data-keyboardnavid";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_DATA_ZONE = "data-keyboardnavzone";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_FILTER_COL_SUFFIX = "_filter";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_CANCEL_BUTTON_CLASS = "k-grid-cancel-command";
+/**
+ * @hidden
+ */
+export declare const KEYBOARD_NAV_EDIT_BUTTON_CLASS = "k-grid-edit-command";
+/**
+ * @hidden
+ */
+export declare const tableKeyboardNavigationScopeAttributes: {
+    "data-keyboardnavscope": boolean;
+};
+/**
+ * @hidden
+ */
+export declare const tableKeyboardNavigationHeaderAttributes: {
+    "data-keyboardnavheader": boolean;
+};
+/**
+ * @hidden
+ */
+export declare const tableKeyboardNavigationBodyAttributes: {
+    "data-keyboardnavbody": boolean;
+};

package/navigation/hooks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare const useTableKeyboardNavigation: (elementId: string, navigatable?: boolean) => {
+    tabIndex?: undefined;
+    "data-keyboardnavlevel"?: undefined;
+    "data-keyboardnavid"?: undefined;
+} | {
+    tabIndex: number;
+    "data-keyboardnavlevel": number;
+    "data-keyboardnavid": string;
+};

package/navigation/hooks.mjs

@@ -7,14 +7,14 @@
  */
 "use client";
 import * as e from "react";
-import { KEYBOARD_NAV_DATA_LEVEL as r, KEYBOARD_NAV_DATA_ID as i } from "./constants.mjs";
+import { KEYBOARD_NAV_DATA_ID as r, KEYBOARD_NAV_DATA_LEVEL as i } from "./constants.mjs";
 import { TableKeyboardNavigationContext as n } from "./TableKeyboardNavigationContext.mjs";
 const v = (o, a) => {
   const t = e.useContext(n);
   return !t || !o || a === !1 ? {} : {
     tabIndex: t && t.activeId && t.activeId === o ? 0 : -1,
-    [r]: t.level,
-    [i]: o
+    [i]: t.level,
+    [r]: o
   };
 };
 export {

package/navigation/stackedKeyboardNavigation.d.ts

@@ -0,0 +1,217 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Keyboard navigation utilities for stacked layout cells.
+ *
+ * Implements the navigation pattern specified in STACKED_LAYOUT_KEYBOARD_NAVIGATION.md:
+ *
+ * ## Key Behaviors
+ *
+ * 1. **Tab Navigation** - PRIMARY mechanism for navigating between stacked cells:
+ *    - Tab: Move to next stacked cell in the row
+ *    - Shift+Tab: Move to previous stacked cell in the row
+ *    - Focus is TRAPPED within the row card (stopPropagation at boundaries)
+ *
+ * 2. **Enter/F2 Keys** - Transition from Cursor mode to Content mode:
+ *    - Focuses the first focusable element within the cell
+ *    - Enables interaction with cell content (inputs, buttons, etc.)
+ *
+ * 3. **Escape Key** - Exit Content mode, return to Cursor mode:
+ *    - Returns focus to the row-level container
+ *    - Resets cell entered state
+ *
+ * ## Navigation Modes
+ *
+ * - **Cursor Mode**: Cell wrapper is focused, user can navigate rows with arrow keys
+ * - **Content Mode**: Focusable element inside cell is focused, user can interact with content
+ *
+ * ## Critical Notes
+ *
+ * - Horizontal (Left/Right) arrow navigation is DISABLED in stacked mode
+ * - Vertical (Up/Down) arrow navigation moves between rows, not cells
+ * - Tab/Shift+Tab stops at row boundaries (prevents leaving the row)
+ * - Each row card is treated as a single navigable unit
+ *
+ * @module stackedKeyboardNavigation
+ * @see STACKED_LAYOUT_KEYBOARD_NAVIGATION.md for complete specification
+ *
+ * @hidden
+ */
+/**
+ * Options for handling stacked cell keyboard navigation.
+ *
+ * @hidden
+ */
+export interface StackedKeyboardNavigationOptions {
+    /**
+     * The keyboard event to handle.
+     */
+    event: React.KeyboardEvent<HTMLElement>;
+    /**
+     * The cell element (the stacked cell wrapper div).
+     */
+    cellElement: HTMLElement;
+    /**
+     * Optional callback to invoke after handling the keyboard event.
+     */
+    onKeyDown?: (event: React.KeyboardEvent<HTMLElement>) => void;
+    /**
+     * Optional callback to invoke when Escape is pressed (to update row entered state).
+     */
+    onEscape?: () => void;
+    /**
+     * Optional callback to invoke when exiting edit mode (e.g., on Escape in incell mode).
+     * This should trigger the Grid's onEditChange to update the edit descriptor.
+     */
+    onExitEdit?: () => void;
+    /**
+     * Optional callback to invoke when Tab is pressed in incell edit mode.
+     * Called with the direction (1 for Tab, -1 for Shift+Tab) to move to next/previous cell.
+     * Should handle transitioning edit state from current cell to next/previous cell.
+     */
+    onTabToNextCell?: (direction: number) => void;
+    /**
+     * Whether the cell is currently in edit mode.
+     * When true, applies edit mode keyboard navigation rules.
+     */
+    isInEdit?: boolean;
+    /**
+     * The edit mode of the grid: 'incell', 'inline', or 'dialog'.
+     * Determines which keyboard navigation rules apply during editing.
+     */
+    editMode?: 'incell' | 'inline' | 'dialog';
+}
+/**
+ * Handles Tab key navigation within a stacked cell row.
+ * Implements focus trap pattern to keep navigation within the current row card.
+ * Tab/Shift+Tab navigates between stacked cells, stopping at row boundaries.
+ *
+ * Edit Mode Behaviors (EDIT_MODE_KEYBOARD_NAVIGATION.md):
+ * - **Incell**: Tab saves current cell and moves to next editable cell
+ * - **Inline**: Tab navigates between fields within the editing row
+ * - **Not editing**: Standard stacked cell navigation with focus trap
+ *
+ * Based on specification: "Tab is THE mechanism for navigating between stacked cells within a row"
+ * and "Trap focus within the current row card: Prevent Tab from leaving the row at boundaries"
+ *
+ * @param event - The keyboard event
+ * @param cellElement - The stacked cell wrapper element
+ * @param target - The event target element
+ * @param isInEdit - Whether the cell/row is in edit mode
+ * @param editMode - The edit mode ('incell', 'inline', or 'dialog')
+ * @returns true if the event was handled and should stop propagation
+ *
+ * @hidden
+ */
+export declare const handleStackedCellTabNavigation: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, target: HTMLElement, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog', onTabToNextCell?: ((direction: number) => void) | undefined) => boolean;
+/**
+ * Handles Enter key press on a stacked cell.
+ * Behavior varies based on edit mode.
+ *
+ * Edit Mode Behaviors (EDIT_MODE_KEYBOARD_NAVIGATION.md):
+ * - **Incell**: Enter confirms edit, saves changes, and closes cell
+ * - **Inline**: Enter moves to next field (does NOT save)
+ * - **Not editing**: Transitions from Cursor mode to Content mode
+ *
+ * Based on specification: "Enter or F2 while in Cursor Mode: Activates Content mode for the current cell"
+ *
+ * @param event - The keyboard event
+ * @param cellElement - The stacked cell wrapper element
+ * @param target - The event target element
+ * @param isInEdit - Whether the cell/row is in edit mode
+ * @param editMode - The edit mode ('incell', 'inline', or 'dialog')
+ * @returns true if the event was handled
+ *
+ * @hidden
+ */
+export declare const handleStackedCellEnterKey: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, target: HTMLElement, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+/**
+ * Handles Escape key press on a stacked cell.
+ * Behavior varies based on edit mode.
+ *
+ * Edit Mode Behaviors (EDIT_MODE_KEYBOARD_NAVIGATION.md):
+ * - **Incell**: Escape cancels edit, discards changes, and closes cell
+ * - **Inline**: Escape cancels editing, closes row, and discards changes
+ * - **Not editing**: Exits Content mode and returns to Cursor mode
+ *
+ * Based on specification: "Escape Key: Exits Content mode and returns to Cursor mode"
+ *
+ * @param event - The keyboard event
+ * @param cellElement - The stacked cell wrapper element
+ * @param onEscape - Optional callback to invoke when Escape is handled (resets cell entered state)
+ * @param isInEdit - Whether the cell/row is in edit mode
+ * @param editMode - The edit mode ('incell', 'inline', or 'dialog')
+ * @returns true if the event was handled
+ *
+ * @hidden
+ */
+export declare const handleStackedCellEscapeKey: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, onEscape?: () => void, onExitEdit?: () => void, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+/**
+ * Handles navigation keys (arrows, PageUp/Down, Home/End) during editing.
+ * Blocks ALL navigation keys during incell editing per specification.
+ *
+ * Edit Mode Behaviors (EDIT_MODE_KEYBOARD_NAVIGATION.md):
+ * - **Incell**: ALL navigation keys are BLOCKED
+ * - **Inline**: Arrow Up/Down are blocked (can't navigate to other rows)
+ * - **Not editing**: Navigation keys work normally
+ *
+ * Based on specification: "ALL navigation keys are blocked when cell is editing"
+ *
+ * @param event - The keyboard event
+ * @param isInEdit - Whether the cell/row is in edit mode
+ * @param editMode - The edit mode ('incell', 'inline', or 'dialog')
+ * @returns true if the event was blocked
+ *
+ * @hidden
+ */
+export declare const handleNavigationKeysInEditMode: (event: React.KeyboardEvent<HTMLElement>, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+/**
+ * Main handler for stacked cell keyboard navigation.
+ * Implements the navigation pattern described in the specifications:
+ *
+ * Specifications:
+ * - STACKED_LAYOUT_KEYBOARD_NAVIGATION.md: Navigation modes and focus trap
+ * - EDIT_MODE_KEYBOARD_NAVIGATION.md: Edit mode behaviors
+ *
+ * Navigation Flow:
+ * - Tab/Shift+Tab: Navigate between stacked cells within the row (focus trapped)
+ * - Enter/F2: Transition from Cursor mode to Content mode (focus first element)
+ * - Escape: Exit Content mode, return to Cursor mode (focus row container)
+ *
+ * Mode Transitions:
+ * - Cursor Mode: Cell wrapper is focused, arrow keys navigate rows
+ * - Content Mode: Focusable element inside cell is focused, Tab navigates cells
+ *
+ * Focus Trap:
+ * Tab navigation is trapped within the current row card. At boundaries:
+ * - First cell + Shift+Tab: Stay on first cell (stopPropagation)
+ * - Last cell + Tab: Stay on last cell (stopPropagation)
+ *
+ * Edit Mode Behaviors:
+ * - **Incell**: All navigation keys blocked, Tab saves and moves, Enter saves, Escape cancels
+ * - **Inline**: Up/Down blocked, Tab between fields, Enter to next field, Escape cancels
+ * - **Not editing**: Normal navigation
+ *
+ * @param options - Navigation options
+ *
+ * @hidden
+ */
+export declare const handleStackedKeyboardNavigation: (options: StackedKeyboardNavigationOptions) => void;
+/**
+ * Exported stacked keyboard navigation utilities.
+ *
+ * @hidden
+ */
+export declare const stackedKeyboardNavigationTools: {
+    handleStackedKeyboardNavigation: (options: StackedKeyboardNavigationOptions) => void;
+    handleStackedCellTabNavigation: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, target: HTMLElement, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog', onTabToNextCell?: ((direction: number) => void) | undefined) => boolean;
+    handleStackedCellEnterKey: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, target: HTMLElement, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+    handleStackedCellEscapeKey: (event: React.KeyboardEvent<HTMLElement>, cellElement: HTMLElement, onEscape?: () => void, onExitEdit?: () => void, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+    handleNavigationKeysInEditMode: (event: React.KeyboardEvent<HTMLElement>, isInEdit?: boolean, editMode?: 'incell' | 'inline' | 'dialog') => boolean;
+    isNavigationKey: (key: string) => boolean;
+};

package/navigation/utils.d.ts

@@ -0,0 +1,329 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { TableKeyboardNavigationContextType } from './TableKeyboardNavigationContextType.js';
+import { TableKeyboardNavigationStateType } from './TableKeyboardNavigationStateType.js';
+/**
+ * @hidden
+ */
+export declare const generateNavigatableId: (navigationId: string, idPrefix: string, type?: 'column' | 'cell' | 'group' | 'expand' | 'nodata') => string;
+/**
+ * @hidden
+ */
+export declare const getNavigatableLevel: (element: Element | null) => number | undefined;
+/**
+ * @hidden
+ */
+export declare const getNavigatableId: (element: Element | null) => string | undefined;
+/**
+ * @hidden
+ */
+export declare const isNavigatable: (element: Element | null) => boolean;
+/**
+ * @hidden
+ */
+export declare const getNavigatableElement: (scope: HTMLElement, options?: {
+    level: number;
+}) => HTMLElement;
+/**
+ * @hidden
+ */
+export declare const getClosestNavigatableElement: (target: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getActiveNavDataElement: (scope: HTMLElement, activeId?: string) => HTMLElement;
+/**
+ * @hidden
+ */
+export declare const getClosestScope: (target: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getClosestCancelButton: (target: HTMLElement) => Element | null | undefined;
+/**
+ * @hidden
+ */
+export declare const getRemoveButtonByAriaRowIndex: (ariaRowIndex: number) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getTableCellByKeyboardNavId: (navId: string) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getRowAriaRowIndex: (target: HTMLElement) => undefined;
+/**
+ * @hidden
+ */
+declare function waitForElementToBeVisible(selector: string, parentElement: Element | null, timeout?: number): Promise<boolean | Element>;
+/**
+ * @hidden
+ */
+export declare const getClosestEditButton: (target: HTMLElement) => Promise<boolean | Element>;
+/**
+ * @hidden
+ */
+export declare const getParentCell: (target: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getHeaderElement: (scope: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getBodyElement: (scope: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const getNoRecordsElement: (scope: HTMLElement) => Element | null;
+/**
+ * @hidden
+ */
+export declare const focusFirstEditor: (newEditableRow: Element) => void;
+/**
+ * @hidden
+ */
+export declare const focusFirstDataElement: (options: {
+    scope?: HTMLElement;
+    contextStateRef: {
+        current?: TableKeyboardNavigationContextType;
+    };
+    navigationStateRef: {
+        current?: TableKeyboardNavigationStateType;
+    };
+}, event?: any) => void;
+/**
+ * @hidden
+ */
+export declare const getFocusableElements: (scope: HTMLElement, options?: {
+    focusable: boolean;
+}) => Element[];
+/**
+ * @hidden
+ */
+export declare const getNavigatableElements: (scope: HTMLElement | null, options?: {
+    level: number;
+}) => any[];
+/**
+ * @hidden
+ */
+export declare const filterNavigatableElements: (options?: {
+    level: number;
+}) => (element: HTMLElement) => boolean;
+/**
+ * @hidden
+ */
+export declare const focusElement: (options: {
+    elementForFocus: HTMLElement;
+    prevElement?: HTMLElement;
+    contextStateRef: {
+        current?: TableKeyboardNavigationContextType;
+    };
+    event?: any;
+}) => void;
+/**
+ * @hidden
+ */
+export declare const getIdPrefix: (navigationStateRef: {
+    current?: TableKeyboardNavigationStateType;
+}) => string;
+/**
+ * @hidden
+ */
+export declare const findNextIdByRowIndex: (initialRowIndex: number, cellIndex: number, elementId: string | undefined, matrix: string[][], isReverse: boolean) => [
+    string,
+    [
+        number,
+        number
+    ]
+] | [
+];
+/**
+ * @hidden
+ */
+export declare const findNextIdByCellIndex: (rowIndex: number, initialCellIndex: number, elementId: string | undefined, matrix: string[][], isReverse: boolean) => [
+    string,
+    [
+        number,
+        number
+    ]
+] | [
+];
+/**
+ * @hidden
+ */
+export declare const findId: (navigationMatrix: string[][], cellId?: string) => number[] | undefined;
+/**
+ * @hidden
+ */
+export declare const getPrevEditableCell: (currentIdIndexes: number[], columns: any[], elementId: string | undefined, matrix: string[][]) => {
+    prevCell: "" | Element | null | undefined;
+    elementToFocus: string | null | undefined;
+};
+/**
+ * @hidden
+ */
+export declare const getNextEditableCell: (currentIdIndexes: number[], columns: any[], elementId: string | undefined, matrix: string[][]) => {
+    nextCell: "" | Element | null | undefined;
+    elementToFocus: string | null | undefined;
+};
+/**
+ * @hidden
+ */
+export declare const getNextNavigationIndex: (navigationStateRef: {
+    current?: TableKeyboardNavigationStateType;
+}) => number;
+/**
+ * @hidden
+ */
+export declare const getFirstDataCell: (navigationMatrix: string[][]) => string | undefined;
+/**
+ * @hidden
+ */
+export declare const getLastDataCell: (navigationMatrix: string[][]) => string | undefined;
+/**
+ * @hidden
+ */
+export declare const getFirstRowDataCell: (navigationMatrix: string[][], rowIndex: number) => string;
+/**
+ * @hidden
+ */
+export declare const getLastRowDataCell: (navigationMatrix: string[][], rowIndex: number) => string;
+/**
+ * @hidden
+ */
+export declare const getFilterColumnId: (columnId: string) => string;
+/**
+ * @hidden
+ */
+export declare const getCurrentIdIndexes: (navigationStateRef: {
+    current?: TableKeyboardNavigationStateType | undefined;
+}, matrix: string[][], elementId: string | undefined) => number[] | undefined;
+/**
+ * @hidden
+ */
+export declare const getClosestCellNavId: (element: HTMLElement) => string | null;
+/**
+ * Gets the parent stacked cell wrapper element.
+ *
+ * @hidden
+ */
+export declare const getStackedCellWrapper: (target: HTMLElement) => HTMLElement | null;
+/**
+ * Gets all focusable elements within a stacked cell.
+ *
+ * @hidden
+ */
+export declare const getStackedCellFocusableElements: (cellElement: HTMLElement) => HTMLElement[];
+/**
+ * Finds the next stacked cell sibling in the specified direction.
+ *
+ * @hidden
+ */
+export declare const getNextStackedCell: (currentCell: HTMLElement, direction: 'next' | 'prev') => HTMLElement | null;
+/**
+ * Gets the table cell (td) that contains the stacked cells.
+ *
+ * @hidden
+ */
+export declare const getStackedCellContainer: (stackedCell: HTMLElement) => HTMLElement | null;
+/**
+ * Focuses an element within a stacked cell, or the cell itself if no focusable found.
+ *
+ * @hidden
+ */
+export declare const focusStackedCellElement: (cellElement: HTMLElement, preferredIndex?: number) => void;
+/**
+ * @hidden
+ */
+export declare const tableKeyboardNavigationTools: {
+    generateNavigatableId: (navigationId: string, idPrefix: string, type?: 'column' | 'cell' | 'group' | 'expand' | 'nodata') => string;
+    getNavigatableId: (element: Element | null) => string | undefined;
+    getNavigatableLevel: (element: Element | null) => number | undefined;
+    getNavigatableElement: (scope: HTMLElement, options?: {
+        level: number;
+    }) => HTMLElement;
+    getClosestNavigatableElement: (target: HTMLElement) => Element | null;
+    getActiveNavDataElement: (scope: HTMLElement, activeId?: string) => HTMLElement;
+    getClosestScope: (target: HTMLElement) => Element | null;
+    getHeaderElement: (scope: HTMLElement) => Element | null;
+    getBodyElement: (scope: HTMLElement) => Element | null;
+    getFocusableElements: (scope: HTMLElement, options?: {
+        focusable: boolean;
+    }) => Element[];
+    getNavigatableElements: (scope: HTMLElement | null, options?: {
+        level: number;
+    }) => any[];
+    filterNavigatableElements: (options?: {
+        level: number;
+    }) => (element: HTMLElement) => boolean;
+    focusElement: (options: {
+        elementForFocus: HTMLElement;
+        prevElement?: HTMLElement;
+        contextStateRef: {
+            current?: TableKeyboardNavigationContextType;
+        };
+        event?: any;
+    }) => void;
+    getIdPrefix: (navigationStateRef: {
+        current?: TableKeyboardNavigationStateType;
+    }) => string;
+    isNavigatable: (element: Element | null) => boolean;
+    findNextIdByRowIndex: (initialRowIndex: number, cellIndex: number, elementId: string | undefined, matrix: string[][], isReverse: boolean) => [
+        string,
+        [
+            number,
+            number
+        ]
+    ] | [
+    ];
+    findNextIdByCellIndex: (rowIndex: number, initialCellIndex: number, elementId: string | undefined, matrix: string[][], isReverse: boolean) => [
+        string,
+        [
+            number,
+            number
+        ]
+    ] | [
+    ];
+    findId: (navigationMatrix: string[][], cellId?: string) => number[] | undefined;
+    getNextNavigationIndex: (navigationStateRef: {
+        current?: TableKeyboardNavigationStateType;
+    }) => number;
+    getFilterColumnId: (columnId: string) => string;
+    focusFirstDataElement: (options: {
+        scope?: HTMLElement;
+        contextStateRef: {
+            current?: TableKeyboardNavigationContextType;
+        };
+        navigationStateRef: {
+            current?: TableKeyboardNavigationStateType;
+        };
+    }, event?: any) => void;
+    getClosestCancelButton: (target: HTMLElement) => Element | null | undefined;
+    getClosestEditButton: (target: HTMLElement) => Promise<boolean | Element>;
+    getRowAriaRowIndex: (target: HTMLElement) => undefined;
+    getRemoveButtonByAriaRowIndex: (ariaRowIndex: number) => Element | null;
+    getTableCellByKeyboardNavId: (navId: string) => Element | null;
+    getParentCell: (target: HTMLElement) => Element | null;
+    waitForElementToBeVisible: typeof waitForElementToBeVisible;
+    getNextEditableCell: (currentIdIndexes: number[], columns: any[], elementId: string | undefined, matrix: string[][]) => {
+        nextCell: "" | Element | null | undefined;
+        elementToFocus: string | null | undefined;
+    };
+    getPrevEditableCell: (currentIdIndexes: number[], columns: any[], elementId: string | undefined, matrix: string[][]) => {
+        prevCell: "" | Element | null | undefined;
+        elementToFocus: string | null | undefined;
+    };
+    getClosestCellNavId: (element: HTMLElement) => string | null;
+    getStackedCellWrapper: (target: HTMLElement) => HTMLElement | null;
+    getStackedCellFocusableElements: (cellElement: HTMLElement) => HTMLElement[];
+    getNextStackedCell: (currentCell: HTMLElement, direction: 'next' | 'prev') => HTMLElement | null;
+    getStackedCellContainer: (stackedCell: HTMLElement) => HTMLElement | null;
+    focusStackedCellElement: (cellElement: HTMLElement, preferredIndex?: number) => void;
+};
+export {};

package/navigation/utils.mjs

@@ -6,7 +6,7 @@
  *-------------------------------------------------------------------------------------------
  */
 import { FOCUSABLE_ELEMENTS as A, TABBABLE_ELEMENTS as k } from "@progress/kendo-react-common";
-import { KEYBOARD_NAV_DATA_LEVEL as f, KEYBOARD_NAV_DATA_ID as g, KEYBOARD_NAV_DATA_SCOPE as D, KEYBOARD_NAV_CANCEL_BUTTON_CLASS as B, KEYBOARD_NAV_EDIT_BUTTON_CLASS as w, KEYBOARD_NAV_DATA_HEADER as h, KEYBOARD_NAV_DATA_BODY as T, KEYBOARD_NAV_FILTER_COL_SUFFIX as $ } from "./constants.mjs";
+import { KEYBOARD_NAV_EDIT_BUTTON_CLASS as D, KEYBOARD_NAV_CANCEL_BUTTON_CLASS as B, KEYBOARD_NAV_FILTER_COL_SUFFIX as w, KEYBOARD_NAV_DATA_ID as g, KEYBOARD_NAV_DATA_LEVEL as f, KEYBOARD_NAV_DATA_BODY as h, KEYBOARD_NAV_DATA_HEADER as T, KEYBOARD_NAV_DATA_SCOPE as $ } from "./constants.mjs";
 const F = (e, t, r = "cell") => `${t}_${e}_${r}`, q = (e) => {
   if (e)
     return parseInt(e.getAttribute(f) || "", 10);
@@ -15,7 +15,7 @@ const F = (e, t, r = "cell") => `${t}_${e}_${r}`, q = (e) => {
     return;
   const t = e.getAttribute(g);
   return t || void 0;
-}, E = (e) => e ? !!e.getAttribute(g) : !1, L = (e, t = { level: 0 }) => e.querySelector(`[${f}='${t.level}']`), x = (e) => e && e.parentElement && e.parentElement.closest(`[${f}]`), I = (e, t) => e.querySelector(`[${g}='${t}']`), O = (e) => e && e.parentElement && e.parentElement.closest(`[${D}]`), R = (e) => {
+}, E = (e) => e ? !!e.getAttribute(g) : !1, L = (e, t = { level: 0 }) => e.querySelector(`[${f}='${t.level}']`), x = (e) => e && e.parentElement && e.parentElement.closest(`[${f}]`), I = (e, t) => e.querySelector(`[${g}='${t}']`), O = (e) => e && e.parentElement && e.parentElement.closest(`[${$}]`), R = (e) => {
   var r;
   const t = ((r = e == null ? void 0 : e.parentElement) == null ? void 0 : r.closest(".k-grid-edit-row")) || null;
   return t == null ? void 0 : t.querySelector("." + B);
@@ -47,8 +47,8 @@ async function p(e, t, r = 5e3) {
 const Y = async (e) => {
   var n;
   const t = ((n = e == null ? void 0 : e.parentElement) == null ? void 0 : n.closest(".k-grid-edit-row")) || null;
-  return await p("." + w, t);
-}, P = (e) => (e == null ? void 0 : e.closest(".k-table-td")) || null, U = (e) => e.querySelector(`[${h}]`), W = (e) => e.querySelector(`[${T}]`), ue = (e) => e.querySelector(".k-grid-norecords"), ae = (e) => {
+  return await p("." + D, t);
+}, P = (e) => (e == null ? void 0 : e.closest(".k-table-td")) || null, U = (e) => e.querySelector(`[${T}]`), W = (e) => e.querySelector(`[${h}]`), ue = (e) => e.querySelector(".k-grid-norecords"), ae = (e) => {
   const t = e.querySelector(".k-grid-edit-cell"), r = t == null ? void 0 : t.querySelector("input");
   r ? r.focus() : t && t.firstChild.focus();
 }, j = (e, t) => {
@@ -140,7 +140,7 @@ const Y = async (e) => {
     nextCell: l && l[0] && a(l[0]),
     elementToFocus: l && l[0] && ((o = a(l[0])) == null ? void 0 : o.getAttribute("role"))
   };
-}, Q = (e) => e.current ? e.current.navigationMatrix.length : 0, Z = (e) => e.flat().find((t) => t.endsWith("cell")), de = (e) => e.flat().reverse().find((t) => t.endsWith("cell")), fe = (e, t) => e[t][0], Ee = (e, t) => Array.from(e[t]).reverse()[0], ee = (e) => e ? `${e}${$}` : "", be = (e, t, r) => {
+}, Q = (e) => e.current ? e.current.navigationMatrix.length : 0, Z = (e) => e.flat().find((t) => t.endsWith("cell")), de = (e) => e.flat().reverse().find((t) => t.endsWith("cell")), fe = (e, t) => e[t][0], Ee = (e, t) => Array.from(e[t]).reverse()[0], ee = (e) => e ? `${e}${w}` : "", be = (e, t, r) => {
   var l;
   let n;
   if ((l = e.current) != null && l.prevNavigationIndexes) {