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

package/moveTreeViewItem.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ *  A helper function which moves a TreeView item in an immutable way.
+ *
+ * @param sourceItemHierarchicalIndex - The hierarchical index of the item that will be moved.
+ * @param sourceData - The tree which contains the item that will be moved.
+ * @param operation - The specific move operation.
+ *
+ * The available options are:
+ *  * `before`—Indicates that the source item will become the previous sibling of the target item.
+ *  * `after`—Indicates that the source item will become the next sibling of the target item.
+ *  * `child`—Indicates that the source item will become a child of the target item.
+ * @param targetItemHierarchicalIndex - The hierarchical index of the item next to which the source item will be moved.
+ * @param targetData - The tree which contains the target item.
+ * If the argument is skipped, then the move operation will be executed within the same tree.
+ * Setting the `sourceData` and `targetData` arguments to the same tree is also supported.
+ * @param childrenField - The field that points to the dataItem sub items. Defaults to `items`.
+ * @returns - The updated copies of the `sourceData` and `targetData` input arguments.
+ * If `targetData` is not passed, then only the updated copy of the `sourceData` will be returned.
+ *
+ * @example
+ * ```jsx
+ * const App = () => {
+ *     const dragClueRef = React.useRef(null);
+ *     const [tree, setTree] = React.useState([{
+ *         text: 'Furniture', expanded: true, items: [
+ *             { text: 'Tables & Chairs', expanded: true },
+ *             { text: 'Sofas', expanded: true },
+ *             { text: 'Occasional Furniture', expanded: true }]
+ *     }, {
+ *         text: 'Decor', expanded: true, items: [
+ *             { text: 'Bed Linen', expanded: true },
+ *             { text: 'Curtains & Blinds', expanded: true },
+ *             { text: 'Carpets', expanded: true }]
+ *     }]);
+ *
+ *     const SEPARATOR = '_';
+ *
+ *     const getSiblings = (itemIndex, data) => {
+ *         let result = data;
+ *         const indices = itemIndex.split(SEPARATOR).map(index => Number(index));
+ *         for (let i = 0; i < indices.length - 1; i++) {
+ *             result = result[indices[i]].items;
+ *         }
+ *         return result;
+ *     };
+ *
+ *     const getClueClassName = (event) => {
+ *         const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
+ *         const itemIndex = eventAnalyzer.destinationMeta.itemHierarchicalIndex;
+ *
+ *         if (eventAnalyzer.isDropAllowed) {
+ *             switch (eventAnalyzer.getDropOperation()) {
+ *                 case 'child':
+ *                     return 'k-i-plus';
+ *                 case 'before':
+ *                     return itemIndex === '0' || itemIndex.endsWith(`${SEPARATOR}0`) ?
+ *                         'k-i-insert-up' : 'k-i-insert-middle';
+ *                 case 'after':
+ *                     const siblings = getSiblings(itemIndex, tree);
+ *                     const lastIndex = Number(itemIndex.split(SEPARATOR).pop());
+ *
+ *                     return lastIndex < siblings.length - 1 ? 'k-i-insert-middle' : 'k-i-insert-down';
+ *                 default:
+ *                     break;
+ *             }
+ *         }
+ *
+ *         return 'k-i-cancel';
+ *     };
+ *
+ *     const onItemDragOver = (event) => {
+ *         dragClueRef.current.show(event.pageY + 10, event.pageX, event.item.text, getClueClassName(event));
+ *     };
+ *
+ *     const onItemDragEnd = (event) => {
+ *         dragClueRef.current.hide();
+ *         const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
+ *
+ *         if (eventAnalyzer.isDropAllowed) {
+ *             const updatedTree = moveTreeViewItem(
+ *                 event.itemHierarchicalIndex,
+ *                 tree,
+ *                 eventAnalyzer.getDropOperation(),
+ *                 eventAnalyzer.destinationMeta.itemHierarchicalIndex,
+ *             );
+ *
+ *             setTree(updatedTree);
+ *         }
+ *     };
+ *
+ *     return (
+ *         <div>
+ *             <TreeView data={tree} draggable={true}
+ *                 onItemDragOver={onItemDragOver} onItemDragEnd={onItemDragEnd} />
+ *             <TreeViewDragClue ref={dragClueRef} />
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+export declare function moveTreeViewItem(sourceItemHierarchicalIndex: string, sourceData: any[] | null | undefined, operation: 'before' | 'after' | 'child', targetItemHierarchicalIndex: string, targetData?: any[] | null, childrenField?: string): any[] | {
+    sourceData: any[] | null | undefined;
+    targetData: any[];
+} | null | undefined;

package/package-metadata.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { PackageMetadata } from '@progress/kendo-licensing';
+/**
+ * @hidden
+ */
+export declare const packageMetadata: PackageMetadata;

package/package-metadata.js

@@ -5,4 +5,4 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-treeview",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1768549938,version:"13.3.0",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-treeview",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1770218797,version:"13.4.0-develop.1",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;

package/package-metadata.mjs

@@ -1,19 +1,13 @@
+// Generated file. DO NOT EDIT.
 /**
- * @license
- *-------------------------------------------------------------------------------------------
- * Copyright © 2026 Progress Software Corporation. All rights reserved.
- * Licensed under commercial license. See LICENSE.md in the package root for more information
- *-------------------------------------------------------------------------------------------
+ * @hidden
  */
-const e = Object.freeze({
-  name: "@progress/kendo-react-treeview",
-  productName: "KendoReact",
-  productCode: "KENDOUIREACT",
-  productCodes: ["KENDOUIREACT"],
-  publishDate: 1768549938,
-  version: "13.3.0",
-  licensingDocsUrl: "https://www.telerik.com/kendo-react-ui/components/my-license/"
+export const packageMetadata = Object.freeze({
+    name: '@progress/kendo-react-treeview',
+    productName: 'KendoReact',
+    productCode: 'KENDOUIREACT',
+    productCodes: ['KENDOUIREACT'],
+    publishDate: 0,
+    version: '13.4.0-develop.1',
+    licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/components/my-license/'
 });
-export {
-  e as packageMetadata
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-treeview",
-  "version": "13.3.0",
+  "version": "13.4.0-develop.1",
   "description": "React TreeView displays hierarchical data in a traditional tree structure, supports user interaction. KendoReact TreeView package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -26,8 +26,8 @@
   "sideEffects": false,
   "peerDependencies": {
     "@progress/kendo-licensing": "^1.7.2",
-    "@progress/kendo-react-animation": "13.3.0",
-    "@progress/kendo-react-common": "13.3.0",
+    "@progress/kendo-react-animation": "13.4.0-develop.1",
+    "@progress/kendo-react-common": "13.4.0-develop.1",
     "@progress/kendo-svg-icons": "^4.0.0",
     "react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
     "react-dom": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
@@ -53,7 +53,7 @@
     "package": {
       "productName": "KendoReact",
       "productCode": "KENDOUIREACT",
-      "publishDate": 1768549938,
+      "publishDate": 1770218797,
       "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
     }
   },

package/processTreeViewItems.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { TreeViewOperationDescriptors } from './TreeViewOperationDescriptors.js';
+/**
+ * A helper function which applies the specified operation descriptors to the data.
+ * * [Expanding and collapsing items](https://www.telerik.com/kendo-react-ui/components/treeview/expansion/update-expanded-items#toc-using-a-helper-function)
+ * * [Selecting and deselecting items](https://www.telerik.com/kendo-react-ui/components/treeview/selection/update-selected-items#toc-using-a-helper-function)
+ * * [Checking and unchecking items](https://www.telerik.com/kendo-react-ui/components/treeview/checkboxes/helper-functions)
+ *
+ * @param data - The data that will be processed.
+ * @param operations - The operation descriptors that will be applied to the data.
+ * @returns - The processed copy of the input data.
+ *
+ * @example
+ * ```jsx
+ * const App = () => {
+ *     const [items] = React.useState(tree);
+ *     const [expand, setExpand] = React.useState([]);
+ *     const [select, setSelect] = React.useState([]);
+ *     const [check, setCheck] = React.useState([]);
+ *
+ *     const onExpandChange = (event) => {
+ *         let newExpand = expand.slice();
+ *         const index = newExpand.indexOf(event.itemHierarchicalIndex);
+ *         index === -1 ? newExpand.push(event.itemHierarchicalIndex) : newExpand.splice(index, 1);
+ *         setExpand(newExpand);
+ *     }
+ *
+ *     return (
+ *         <TreeView
+ *             data={processTreeViewItems(items, { expand, select, check })}
+ *             expandIcons={true} onExpandChange={onExpandChange} checkboxes={true}
+ *             onCheckChange={event => setCheck([ event.itemHierarchicalIndex ])}
+ *             onItemClick={event => setSelect([ event.itemHierarchicalIndex ])}
+ *         />
+ *     );
+ * }
+ *
+ * const tree = [{
+ *     text: 'Item1',
+ *     items: [
+ *         { text: 'Item1.1' },
+ *         { text: 'Item1.2' },
+ *         { text: 'Item1.3', items: [{ text: 'Item1.3.1' }] }]
+ * }, {
+ *     text: 'Item2', disabled: true,
+ *     items: [{ text: 'Item2.1' }, { text: 'Item2.2' }, { text: 'Item2.3' }]
+ * }, {
+ *     text: 'Item3'
+ * }];
+ * ```
+ */
+export declare function processTreeViewItems(data: any[] | null | undefined, operations: TreeViewOperationDescriptors): any[];

package/processTreeViewItems.mjs

@@ -5,7 +5,7 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-import { isArray as I, resolveItemsIds as g, updateItem as C, getNestedValue as E } from "@progress/kendo-react-common";
+import { isArray as I, resolveItemsIds as g, getNestedValue as E, updateItem as C } from "@progress/kendo-react-common";
 import { EXPAND_FIELD as D, SELECT_FIELD as L, CHECK_FIELD as o, CHILDREN_FIELD as N, CHECK_INDETERMINATE_FIELD as _ } from "./utils/consts.mjs";
 function A(n, t) {
   if (!n || !n.length)

package/utils/consts.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 EXPAND_FIELD = "expanded";
+/**
+ * @hidden
+ */
+export declare const TEXT_FIELD = "text";
+/**
+ * @hidden
+ */
+export declare const DISABLED_FIELD = "disabled";
+/**
+ * @hidden
+ */
+export declare const CHILDREN_FIELD = "items";
+/**
+ * @hidden
+ */
+export declare const HAS_CHILDREN_FIELD = "hasChildren";
+/**
+ * @hidden
+ */
+export declare const SELECT_FIELD = "selected";
+/**
+ * @hidden
+ */
+export declare const ICON_FIELD = "svgIcon";
+/**
+ * @hidden
+ */
+export declare const CHECK_FIELD = "checked";
+/**
+ * @hidden
+ */
+export declare const CHECK_INDETERMINATE_FIELD = "checkIndeterminate";
+/**
+ * @hidden
+ */
+export declare const DOM_KENDO_ITEM_ID_FIELD = "_kendoItemId";
+/**
+ * @hidden
+ */
+export declare const DOM_KENDO_TREEVIEW_GUID_FIELD = "_kendoTreeViewGuid";

package/utils/getItemIdUponKeyboardNavigation.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { TreeFieldsService } from '@progress/kendo-react-common';
+/**
+ * @hidden
+ */
+export default function getItemIdUponKeyboardNavigation(item: any, itemId: string, items: any[], keyCode: number, fieldsSvc: TreeFieldsService): any;

package/utils/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ * Calculate the position of the node in the TreeView. The result is used in the node rendering classes.
+ */
+declare const getNodePosition: (index: number, data: object[]) => "top" | "mid" | "bot";
+export { getNodePosition };