@progress/kendo-react-common 13.3.0-develop.9 → 13.4.0-develop.1

package/keys.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @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 Keys: {
+    backspace: number;
+    tab: number;
+    enter: number;
+    shift: number;
+    esc: number;
+    space: number;
+    pageUp: number;
+    pageDown: number;
+    end: number;
+    home: number;
+    left: number;
+    up: number;
+    right: number;
+    down: number;
+    delete: number;
+};
+/**
+ * @hidden
+ */
+export declare const KEYS: {
+    backspace: string;
+    tab: string;
+    enter: string;
+    shift: string;
+    esc: string;
+    space: string;
+    pageUp: string;
+    pageDown: string;
+    end: string;
+    home: string;
+    left: string;
+    up: string;
+    right: string;
+    down: string;
+    delete: string;
+};

package/memoize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+type EqualityFn<TFunc extends (...args: any[]) => any> = (newArgs: Parameters<TFunc>, lastArgs: Parameters<TFunc>) => boolean;
+type MemoizedFn<TFunc extends (this: any, ...args: any[]) => any> = {
+    clear: () => void;
+    (this: ThisParameterType<TFunc>, ...args: Parameters<TFunc>): ReturnType<TFunc>;
+};
+/**
+ * @hidden
+ */
+export declare function memoizeOne<TFunc extends (this: any, ...newArgs: any[]) => any>(resultFn: TFunc, isEqualFn?: EqualityFn<TFunc>): MemoizedFn<TFunc>;
+export {};

package/models/auto-scroll-options.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents additional configuration options for the `autoScroll` options of the `useDraggable` hook and `Draggable` component.
+ */
+export interface AutoScrollOptions {
+    /**
+     * Set to `false` to disable the `autoScroll` feature.
+     */
+    enabled?: boolean;
+    /**
+     * Allows the user to toggle `autoScroll` in a specific direction.
+     */
+    direction?: {
+        horizontal: boolean;
+        vertical: boolean;
+    };
+    /**
+     * Overrides the calculated element used for boundary detection, used to calculate the `autoScroll` velocity.
+     */
+    boundaryElementRef?: React.RefObject<HTMLElement | null | {
+        element: HTMLElement | null;
+    }> | null;
+}

package/models/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+export * from './mouse.js';
+export * from './touch.js';
+export * from './pointer.js';
+export * from './auto-scroll-options.js';
+export * from './kendoReactComponentBaseProps.js';

package/models/kendoReactComponentBaseProps.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ *
+ * Represents the base properties of a KendoReact component.
+ */
+export interface KendoReactComponentBaseProps {
+    /**
+     * Sets the `id` property of the top div element of the component.
+     */
+    id?: string;
+    /**
+     * Determines the children nodes.
+     */
+    children?: React.ReactNode;
+    /**
+     * Sets additional classes to the component.
+     */
+    className?: string;
+    /**
+     * Sets additional CSS styles to the component.
+     */
+    style?: React.CSSProperties;
+}

package/models/mouse.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as React from 'react';
+export interface KendoMouse<T, E extends HTMLElement> {
+    /**
+     * Fired when the mouse button is pressed down on the element.
+     */
+    onMouseDown?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse button is released over the element.
+     */
+    onMouseUp?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the element is clicked.
+     */
+    onClick?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the element is double-clicked.
+     */
+    onDoubleClick?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse pointer enters the element.
+     */
+    onMouseEnter?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse pointer leaves the element.
+     */
+    onMouseLeave?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse pointer moves over the element.
+     */
+    onMouseMove?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse pointer leaves the element or any of its child elements.
+     */
+    onMouseOut?: (args: KendoMouseEvent<T, E>) => void;
+    /**
+     * Fired when the mouse pointer moves over the element or any of its child elements.
+     */
+    onMouseOver?: (args: KendoMouseEvent<T, E>) => void;
+}
+export interface KendoMouseEvent<T, E extends HTMLElement = HTMLElement> {
+    /**
+     * The React synthetic mouse event that triggered the action.
+     */
+    syntheticEvent: React.MouseEvent<E>;
+    /**
+     * The target object that is associated with the event.
+     */
+    target: T;
+}

package/models/pointer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as React from 'react';
+/**
+ * @hidden
+ */
+export interface KendoPointer<T, E extends HTMLElement> {
+    onPointerDown?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerMove?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerUp?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerCancel?: (args: KendoPointerEvent<T, E>) => void;
+    onGotPointerCapture?: (args: KendoPointerEvent<T, E>) => void;
+    onLostPointerCapture?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerEnter?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerOver?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerLeave?: (args: KendoPointerEvent<T, E>) => void;
+    onPointerOut?: (args: KendoPointerEvent<T, E>) => void;
+}
+/**
+ * @hidden
+ */
+export interface KendoPointerEvent<T, E extends HTMLElement = HTMLElement> {
+    syntheticEvent: React.PointerEvent<E>;
+    target: T;
+}

package/models/touch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import * as React from 'react';
+/**
+ * @hidden
+ */
+export interface KendoTouch<T, E extends HTMLElement> {
+    onTouchStart?: (args: KendoTouchEvent<T, E>) => void;
+    onTouchMove?: (args: KendoTouchEvent<T, E>) => void;
+    onTouchEnd?: (args: KendoTouchEvent<T, E>) => void;
+    onTouchCancel?: (args: KendoTouchEvent<T, E>) => void;
+}
+/**
+ * @hidden
+ */
+export interface KendoTouchEvent<T, E extends HTMLElement = HTMLElement> {
+    syntheticEvent: React.TouchEvent<E>;
+    target: T;
+}

package/navigation.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the [Navigation](https://www.telerik.com/kendo-react-ui/components/common/api/navigation) options object.
+ *
+ */
+export interface NavigationOptions {
+    /**
+     * Sets the tabIndex used by the [Navigation](https://www.telerik.com/kendo-react-ui/components/common/api/navigation).
+     */
+    tabIndex: number;
+    /**
+     * Sets the root DOM element used by the [Navigation](https://www.telerik.com/kendo-react-ui/components/common/api/navigation).
+     */
+    root: React.RefObject<HTMLElement | null>;
+    /**
+     * Sets the CSS selectors used by the [Navigation](https://www.telerik.com/kendo-react-ui/components/common/api/navigation). The navigation DOM elements will be queried using the selectors.
+     * Make sure their order matches the navigating order.
+     */
+    selectors: string[] | string[][];
+    /**
+     * Configures if the roving tabIndex technique will be used in the [Navigation](https://www.telerik.com/kendo-react-ui/components/common/api/navigation). Defaults to `true`.
+     */
+    rovingTabIndex?: boolean;
+    /**
+     * Sets the options of the focus methods that is used. Defaults to `{ preventScroll: true }`.
+     */
+    focusOptions?: FocusOptions;
+    /**
+     * Sets the mouse events handlers.
+     */
+    mouseEvents?: {
+        [type: string]: (target: HTMLElement, nav: Navigation, ev: React.MouseEvent<HTMLElement>) => void;
+    };
+    /**
+     * Sets the keyboard events handlers.
+     */
+    keyboardEvents?: {
+        [type: string]: {
+            [key: string]: (target: HTMLElement, nav: Navigation, ev: React.KeyboardEvent<HTMLElement>) => void;
+        };
+    };
+    /**
+     * Sets a class to the current focused element.
+     */
+    focusClass?: string;
+}
+/**
+ * Represents the [KendoReact Navigation functionality](https://www.telerik.com/kendo-react-ui/components/common/navigation).
+ * It handles the navigation through a collection of DOM elements.
+ */
+export declare class Navigation {
+    /**
+     * @hidden
+     */
+    selectors: string[] | string[][];
+    /**
+     * @hidden
+     */
+    mouseEvents: {
+        [type: string]: (target: HTMLElement, nav: Navigation, ev: React.MouseEvent<HTMLElement>) => void;
+    };
+    /**
+     * @hidden
+     */
+    keyboardEvents: {
+        [type: string]: {
+            [key: string]: (target: HTMLElement, nav: Navigation, ev: React.KeyboardEvent<HTMLElement>, options?: any) => void;
+        };
+    };
+    /**
+     * @hidden
+     */
+    tabIndex: number;
+    /**
+     * @hidden
+     */
+    focusOptions: FocusOptions;
+    /**
+     * @hidden
+     */
+    root: React.RefObject<HTMLElement | null>;
+    /**
+     * @hidden
+     */
+    rovingTabIndex?: boolean;
+    /**
+     * @hidden
+     */
+    focusClass?: string;
+    /**
+     * @hidden
+     */
+    lastFocused: HTMLElement | null;
+    constructor(options: NavigationOptions);
+    /**
+     * Returns the collection of DOM elements which the module will navigate in.
+     */
+    get elements(): HTMLElement[];
+    /**
+     * Returns the first navigation DOM element.
+     */
+    get first(): HTMLElement | null;
+    /**
+     * Returns the last navigation DOM element.
+     */
+    get last(): HTMLElement | null;
+    /**
+     * Returns the focused DOM element from the navigation collection of DOM elements.
+     */
+    get current(): HTMLElement | null;
+    /**
+     * Returns the next DOM element from the navigation collection of DOM elements.
+     */
+    next(target: HTMLElement, selectors?: string[] | string[][]): HTMLElement;
+    /**
+     * Returns the previous DOM element from the navigation collection of DOM elements.
+     */
+    previous(target: HTMLElement, selectors?: string[] | string[][]): HTMLElement;
+    /**
+     * Focuses the next element from the navigation collection of DOM elements.
+     */
+    focusNext(target: HTMLElement, selectors?: string[] | string[][]): HTMLElement;
+    /**
+     * Focuses the previous element from the navigation collection of DOM elements.
+     */
+    focusPrevious(target: HTMLElement, selectors?: string[] | string[][]): HTMLElement;
+    /**
+     * The keyboard events handler.
+     */
+    triggerKeyboardEvent(ev: React.KeyboardEvent<HTMLElement>, options?: any): void;
+    /**
+     * The mouse events handler.
+     */
+    triggerMouseEvent(ev: React.MouseEvent<HTMLElement>): void;
+    /**
+     * Focuses the passed element from the navigation collection of DOM elements.
+     */
+    focusElement(element: HTMLElement | null, previous?: HTMLElement | null): void;
+    /**
+     * Set the first element tabIndex to `1` and `-1` for the rest.
+     */
+    initializeRovingTab(itemIndex?: number): void;
+    /**
+     * Remove a focus listener.
+     */
+    removeFocusListener(): void;
+    /**
+     * Remove a focus class.
+     */
+    removeFocusClass(target: HTMLElement): void;
+    /**
+     * @hidden
+     */
+    update: () => void;
+    private setFocusClass;
+    private disableTabindexForRest;
+    private focusNextIndex;
+    private customElements;
+    private target;
+}

package/noop.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @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 noop: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-common",
-  "version": "13.3.0-develop.9",
+  "version": "13.4.0-develop.1",
   "description": "React Common package delivers common utilities that can be used with the KendoReact UI components. KendoReact Common Utilities package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",

package/rowHeightService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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 interface DataItemWrapper {
+    dataItem: any;
+    rowType: any;
+    level: number;
+    expanded: boolean;
+    dataIndex: number;
+}
+/**
+ * @hidden
+ */
+export declare class RowHeightService {
+    private total;
+    private offsets;
+    private heights;
+    constructor(total: number, rowHeight: number);
+    height(rowIndex: number): number;
+    index(position: number): number;
+    offset(rowIndex: number): number;
+    totalHeight(): number;
+    update(startIndex: number, rowHeights: Array<number>): void;
+}

package/scrollbarWidth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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 getScrollbarWidth: () => number | false;
+/**
+ * @hidden
+ */
+export declare const setScrollbarWidth: (width?: number) => false | undefined;

package/setter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Can be used for setting value to object using field path. For example `users[index].name`.
+ *
+ * @example
+ * ```jsx-no-run
+ * const values = {users:[{lastName: 'Doe'}]};
+ * const firstUserFirstName = setter('user[0].firstName');
+ *
+ * firstUserFirstName(values, 'John');
+ *
+ * console.log(values)
+ *
+ * // result: {users:[{firstName: 'John', lastName: 'Doe'}]}
+ * ```
+ */
+export declare function setter(field: string): any;

package/theme.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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 interface KendoThemeMaps {
+    sizeMap: Record<Exclude<any, null>, string>;
+    roundedMap: Record<Exclude<any, null>, string>;
+    orientationMap: Record<Exclude<any, null>, string>;
+}
+/** @hidden */
+export declare const kendoThemeMaps: KendoThemeMaps;

package/trappedFocus.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @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 focusableChildren: (element: HTMLElement, elementsSelectors?: string[]) => HTMLElement[] | [
+];
+/**
+ * @hidden
+ */
+export declare const firstFocusableChild: (element: HTMLElement, elementsSelectors?: string[]) => HTMLElement | undefined;
+/**
+ * @hidden
+ */
+export declare const lastFocusableChild: (element: HTMLElement, elementsSelectors?: string[]) => HTMLElement | undefined;
+/**
+ * @hidden
+ */
+export declare const focusFirstFocusableChild: (element: HTMLElement, elementsSelectors?: string[]) => void;
+/**
+ * @hidden
+ */
+export declare const focusLastFocusableChild: (element: HTMLElement, elementsSelectors?: string[]) => void;
+/**
+ * @hidden
+ */
+export declare const keepFocusInContainer: (e: React.KeyboardEvent, containerElement?: HTMLElement | null, elementsSelectors?: string[]) => void;
+/**
+ * @hidden
+ */
+export declare const applyTrappedFocus: (e: React.KeyboardEvent, containerElement: HTMLElement, updateFocusedState?: ((isContainerFocused: boolean) => void) | undefined, elementsSelectors?: string[]) => void;
+/**
+ * @hidden
+ */
+export declare const enableNavigatableContainer: (containerElement: HTMLElement, elementsSelectors?: string[]) => void;
+/**
+ * @hidden
+ */
+export declare const disableNavigatableContainer: (containerElement: HTMLElement, elementsSelectors?: string[]) => void;

package/tree-utils/FieldsService.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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 class TreeFieldsService {
+    focusIdField: string | undefined;
+    private expandField;
+    private selectField;
+    private childrenField;
+    private hasChildrenField;
+    private textField;
+    private disableField;
+    private checkField;
+    private checkIndeterminateField;
+    constructor(treeViewProps: any);
+    expanded(item: any): boolean | undefined;
+    selected(item: any): boolean | undefined;
+    text(item: any): string | undefined;
+    disabled(item: any): boolean | undefined;
+    hasChildren(item: any): boolean | undefined;
+    children(item: any): any[];
+    checked(item: any): boolean | undefined;
+    checkIndeterminate(item: any): boolean | undefined;
+    focusId(item: any): any;
+    getChildrenField(): string;
+}

package/tree-utils/SortedPublicItemIds.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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 class SortedPublicItemIds {
+    private objects;
+    init(publicItemIds: any[]): void;
+    hasId(publicItemId: any): boolean;
+}