@progress/kendo-react-data-tools 5.20.0-dev.202310051816 → 5.20.0-dev.202310061256

package/dist/es/package-metadata.js

@@ -5,7 +5,7 @@ export var packageMetadata = {
     name: '@progress/kendo-react-data-tools',
     productName: 'KendoReact',
     productCodes: ['KENDOUIREACT', 'KENDOUICOMPLETE'],
-    publishDate: 1696527699,
+    publishDate: 1696595127,
     version: '',
     licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/my-license/?utm_medium=product&utm_source=kendoreact&utm_campaign=kendo-ui-react-purchase-license-keys-warning'
 };

package/dist/es/utils/DataItemWrapper.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @hidden
+ */
+export interface DataItemWrapper {
+    dataItem: any;
+    level: number[];
+    height: number;
+    offsetTop: number;
+    levelCount: number;
+}

package/dist/es/utils/DataItemWrapper.js

@@ -0,0 +1 @@
+export {};

package/dist/es/utils/data-operations.d.ts

@@ -1,4 +1,5 @@
 import { SortDescriptor, FilterDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
+import { DataItemWrapper } from './DataItemWrapper';
 /**
  * Orders the specified tree according to the provided sort descriptors.
  *
@@ -17,3 +18,77 @@ export declare function orderBy(data: any[], descriptors: SortDescriptor[], subI
  * @returns {T[]} - The filtered data.
  */
 export declare function filterBy(data: any[], descriptors: FilterDescriptor[] | CompositeFilterDescriptor[], subItemsField: string): any[];
+/**
+ * @hidden
+ */
+export declare function flatData(data: any[], getChildren: (dataItem: any) => any[], itemMap: (item: any) => any): DataItemWrapper[];
+/**
+ * Creates a flat data array from the passed tree dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {string} expandField - The field which points to the expanded value of each data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are in a flat structure.
+ */
+export declare const treeToFlat: (data: any[], expandField: string, subItemsField: string) => any[];
+/**
+ * Creates a tree from the passed dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {(item: object) => any} getId - A function which will return the id of the data item.
+ * @param {(item: object) => any} getParentId - A function which will return the data item id of its parent data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are structured in a tree.
+ */
+export declare const createDataTree: (dataset: any[], getId: (item: any) => any, getParentId: (item: any) => any, subItemsField: string) => any[];
+/**
+ * Similar to the `Object.assign` function. Additionally, creates a new array for the subitems.
+ *
+ * @param {object} item - The source data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {object} propsToExtend - The props with which the source data item will be extended.
+ * @returns {object} - The target data item.
+ */
+export declare const extendDataItem: (item: any, subItemsField: string, propsToExtend?: any) => any;
+/**
+ * Removes the items from the passed `data` which match the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item
+ * in the tree data and the items for which returns true will be removed.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const removeItems: (data: any[], subItemsField: string, condition: (item: any) => boolean) => any[];
+/**
+ * Changes the `subItems` collection of each data item which matches the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item and
+ * will return `true` for items that have to change the subitems collection.
+ * @param {(subItems: object[]) => object[]} change - A function which
+ * has as a parameter the subitems collection of the matched items and which will return the new subitems collection.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const modifySubItems: (data: any[], subItemsField: string, condition: (item: any) => boolean, change: (subItems: any[]) => any[]) => any[];
+/**
+ * Returns the data item path in the tree based on the level parameter.
+ *
+ * @param {any[]} tree - The data tree.
+ * @param {number[]} level - The level of the target tree item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The path of the data item.
+ */
+export declare const getItemPath: (tree: any[], level: number[], subItemsField?: string) => any[];
+/**
+ * Moves the targeted item in the tree to another position.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {number[]} target - The level of the target tree item which will be moved.
+ * @param {number[] | null} destination - The level of the destination tree item where the target item will be moved in.
+ * If it is null, the target item will be added at the root level.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const moveTreeItem: (data: any[], target: number[], destination: number[] | null, subItemsField: string) => any[];

package/dist/es/utils/data-operations.js

@@ -19,6 +19,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 import { orderBy as kendoDataQueryOrderBy, filterBy as kendoDataQueryFilterBy } from '@progress/kendo-data-query';
+import { mapTree, extendDataItem as extendDataItemCommon, getItemPath as getItemPathCommon, getNestedValue } from '@progress/kendo-react-common';
 // Gets and sets the children. Returns the children or the re-created item with the new children.
 function children(item, subItemsField, subItems) {
     var _a;
@@ -82,3 +83,183 @@ export function filterBy(data, descriptors, subItemsField) {
     filtered = filterChildren(filtered, descriptors, subItemsField);
     return filtered[subItemsField] || [];
 }
+/**
+ * @hidden
+ */
+export function flatData(data, getChildren, itemMap) {
+    var stack = [];
+    var flatted = [];
+    // we start from end as push() improves performance by up to 50%
+    for (var i = data.length - 1; i >= 0; i--) {
+        var root = data[i];
+        stack.push({
+            root: root,
+            data: getChildren(root),
+            level: [i],
+            levelCount: data.length
+        });
+    }
+    while (stack.length > 0) {
+        var stackItem = stack.pop();
+        flatted.push(__assign(__assign({ dataItem: stackItem.root, level: __spreadArray([], stackItem.level, true) }, itemMap(stackItem.root)), { levelCount: stackItem.levelCount }));
+        if (stackItem.data.length) {
+            for (var i = stackItem.data.length - 1; i >= 0; i--) {
+                var root = stackItem.data[i];
+                stack.push({
+                    root: root,
+                    data: getChildren(root),
+                    level: __spreadArray(__spreadArray([], stackItem.level, true), [i], false),
+                    levelCount: stackItem.data.length
+                });
+            }
+        }
+    }
+    return flatted;
+}
+/**
+ * Creates a flat data array from the passed tree dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {string} expandField - The field which points to the expanded value of each data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are in a flat structure.
+ */
+export var treeToFlat = function (data, expandField, subItemsField) {
+    var expanded = function (dataItem) { return Boolean(getNestedValue(expandField, dataItem)); };
+    var hasChildren = function (dataItem) { return Boolean(getNestedValue(subItemsField, dataItem)); };
+    var getChildren = function (dataItem) {
+        var items = [];
+        if (expanded(dataItem) && hasChildren(dataItem)) {
+            items.push.apply(items, getNestedValue(subItemsField, dataItem));
+        }
+        return items;
+    };
+    var flatItems = function (dataItem, flatted, level) {
+        flatted.push(__assign(__assign({}, dataItem), { level: level }));
+        getChildren(dataItem).forEach(function (root) { return flatItems(root, flatted, level + 1); });
+    };
+    var flattedData = [];
+    data.forEach(function (root) { return flatItems(root, flattedData, 0); });
+    return flattedData;
+};
+/**
+ * Creates a tree from the passed dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {(item: object) => any} getId - A function which will return the id of the data item.
+ * @param {(item: object) => any} getParentId - A function which will return the data item id of its parent data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are structured in a tree.
+ */
+export var createDataTree = function (dataset, getId, getParentId, subItemsField) {
+    var hashTable = {}, dataTree = [], parentItem;
+    dataset.forEach(function (dataItem) { return hashTable[getId(dataItem)] = __assign({}, dataItem); });
+    dataset.forEach(function (dataItem) {
+        parentItem = hashTable[getParentId(dataItem)];
+        if (parentItem) {
+            parentItem[subItemsField] = parentItem[subItemsField] || [];
+            parentItem[subItemsField].push(hashTable[getId(dataItem)]);
+        }
+        else {
+            dataTree.push(hashTable[getId(dataItem)]);
+        }
+    });
+    return dataTree;
+};
+/**
+ * Similar to the `Object.assign` function. Additionally, creates a new array for the subitems.
+ *
+ * @param {object} item - The source data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {object} propsToExtend - The props with which the source data item will be extended.
+ * @returns {object} - The target data item.
+ */
+export var extendDataItem = function (item, subItemsField, propsToExtend) {
+    return extendDataItemCommon(item, subItemsField, propsToExtend);
+};
+/**
+ * Removes the items from the passed `data` which match the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item
+ * in the tree data and the items for which returns true will be removed.
+ * @returns {any[]} - The new data tree.
+ */
+export var removeItems = function (data, subItemsField, condition) {
+    var _a;
+    var newData = mapTree([(_a = {}, _a[subItemsField] = __spreadArray([], data, true), _a)], subItemsField, function (item) { return removeChild(item, condition, subItemsField); });
+    return __spreadArray([], newData[0][subItemsField], true);
+};
+/**
+ * @hidden
+ */
+var removeChild = function (item, condition, subItemsField) {
+    var _a;
+    var subItems = item[subItemsField] || [];
+    var childIndex = subItems.findIndex(condition);
+    if (childIndex !== -1) {
+        var newChildren = __spreadArray([], subItems, true);
+        newChildren.splice(childIndex, 1);
+        return __assign(__assign({}, item), (_a = {}, _a[subItemsField] = newChildren, _a));
+    }
+    return item;
+};
+/**
+ * Changes the `subItems` collection of each data item which matches the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item and
+ * will return `true` for items that have to change the subitems collection.
+ * @param {(subItems: object[]) => object[]} change - A function which
+ * has as a parameter the subitems collection of the matched items and which will return the new subitems collection.
+ * @returns {any[]} - The new data tree.
+ */
+export var modifySubItems = function (data, subItemsField, condition, change) {
+    return mapTree(data, subItemsField, function (item) {
+        var _a;
+        return condition(item) ? __assign(__assign({}, item), (_a = {}, _a[subItemsField] = change(item[subItemsField] || []), _a)) :
+            item;
+    });
+};
+/**
+ * Returns the data item path in the tree based on the level parameter.
+ *
+ * @param {any[]} tree - The data tree.
+ * @param {number[]} level - The level of the target tree item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The path of the data item.
+ */
+export var getItemPath = function (tree, level, subItemsField) {
+    return getItemPathCommon(tree, level, subItemsField);
+};
+/**
+ * Moves the targeted item in the tree to another position.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {number[]} target - The level of the target tree item which will be moved.
+ * @param {number[] | null} destination - The level of the destination tree item where the target item will be moved in.
+ * If it is null, the target item will be added at the root level.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The new data tree.
+ */
+export var moveTreeItem = function (data, target, destination, subItemsField) {
+    var tree = __spreadArray([], data, true);
+    var targetItemPath = getItemPath(tree, target, subItemsField);
+    var targetItem = targetItemPath.pop();
+    var targetParent = targetItemPath.pop();
+    var targetItemIndex = target[target.length - 1];
+    if (destination) {
+        var destinationItemPath = getItemPath(tree, destination, subItemsField);
+        var destinationItem = destinationItemPath.pop();
+        (targetParent ? targetParent[subItemsField] : tree).splice(targetItemIndex, 1);
+        destinationItem[subItemsField] = destinationItem[subItemsField] || [];
+        destinationItem[subItemsField].push(targetItem);
+    }
+    else {
+        (targetParent ? targetParent[subItemsField] : tree).splice(targetItemIndex, 1);
+        tree.push(targetItem);
+    }
+    return tree;
+};

package/dist/npm/package-metadata.js

@@ -8,7 +8,7 @@ exports.packageMetadata = {
     name: '@progress/kendo-react-data-tools',
     productName: 'KendoReact',
     productCodes: ['KENDOUIREACT', 'KENDOUICOMPLETE'],
-    publishDate: 1696527699,
+    publishDate: 1696595127,
     version: '',
     licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/my-license/?utm_medium=product&utm_source=kendoreact&utm_campaign=kendo-ui-react-purchase-license-keys-warning'
 };

package/dist/npm/utils/DataItemWrapper.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @hidden
+ */
+export interface DataItemWrapper {
+    dataItem: any;
+    level: number[];
+    height: number;
+    offsetTop: number;
+    levelCount: number;
+}

package/dist/npm/utils/DataItemWrapper.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/npm/utils/data-operations.d.ts

@@ -1,4 +1,5 @@
 import { SortDescriptor, FilterDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
+import { DataItemWrapper } from './DataItemWrapper';
 /**
  * Orders the specified tree according to the provided sort descriptors.
  *
@@ -17,3 +18,77 @@ export declare function orderBy(data: any[], descriptors: SortDescriptor[], subI
  * @returns {T[]} - The filtered data.
  */
 export declare function filterBy(data: any[], descriptors: FilterDescriptor[] | CompositeFilterDescriptor[], subItemsField: string): any[];
+/**
+ * @hidden
+ */
+export declare function flatData(data: any[], getChildren: (dataItem: any) => any[], itemMap: (item: any) => any): DataItemWrapper[];
+/**
+ * Creates a flat data array from the passed tree dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {string} expandField - The field which points to the expanded value of each data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are in a flat structure.
+ */
+export declare const treeToFlat: (data: any[], expandField: string, subItemsField: string) => any[];
+/**
+ * Creates a tree from the passed dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {(item: object) => any} getId - A function which will return the id of the data item.
+ * @param {(item: object) => any} getParentId - A function which will return the data item id of its parent data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are structured in a tree.
+ */
+export declare const createDataTree: (dataset: any[], getId: (item: any) => any, getParentId: (item: any) => any, subItemsField: string) => any[];
+/**
+ * Similar to the `Object.assign` function. Additionally, creates a new array for the subitems.
+ *
+ * @param {object} item - The source data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {object} propsToExtend - The props with which the source data item will be extended.
+ * @returns {object} - The target data item.
+ */
+export declare const extendDataItem: (item: any, subItemsField: string, propsToExtend?: any) => any;
+/**
+ * Removes the items from the passed `data` which match the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item
+ * in the tree data and the items for which returns true will be removed.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const removeItems: (data: any[], subItemsField: string, condition: (item: any) => boolean) => any[];
+/**
+ * Changes the `subItems` collection of each data item which matches the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item and
+ * will return `true` for items that have to change the subitems collection.
+ * @param {(subItems: object[]) => object[]} change - A function which
+ * has as a parameter the subitems collection of the matched items and which will return the new subitems collection.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const modifySubItems: (data: any[], subItemsField: string, condition: (item: any) => boolean, change: (subItems: any[]) => any[]) => any[];
+/**
+ * Returns the data item path in the tree based on the level parameter.
+ *
+ * @param {any[]} tree - The data tree.
+ * @param {number[]} level - The level of the target tree item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The path of the data item.
+ */
+export declare const getItemPath: (tree: any[], level: number[], subItemsField?: string) => any[];
+/**
+ * Moves the targeted item in the tree to another position.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {number[]} target - The level of the target tree item which will be moved.
+ * @param {number[] | null} destination - The level of the destination tree item where the target item will be moved in.
+ * If it is null, the target item will be added at the root level.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The new data tree.
+ */
+export declare const moveTreeItem: (data: any[], target: number[], destination: number[] | null, subItemsField: string) => any[];

package/dist/npm/utils/data-operations.js

@@ -20,8 +20,9 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterBy = exports.orderBy = void 0;
+exports.moveTreeItem = exports.getItemPath = exports.modifySubItems = exports.removeItems = exports.extendDataItem = exports.createDataTree = exports.treeToFlat = exports.flatData = exports.filterBy = exports.orderBy = void 0;
 var kendo_data_query_1 = require("@progress/kendo-data-query");
+var kendo_react_common_1 = require("@progress/kendo-react-common");
 // Gets and sets the children. Returns the children or the re-created item with the new children.
 function children(item, subItemsField, subItems) {
     var _a;
@@ -87,3 +88,191 @@ function filterBy(data, descriptors, subItemsField) {
     return filtered[subItemsField] || [];
 }
 exports.filterBy = filterBy;
+/**
+ * @hidden
+ */
+function flatData(data, getChildren, itemMap) {
+    var stack = [];
+    var flatted = [];
+    // we start from end as push() improves performance by up to 50%
+    for (var i = data.length - 1; i >= 0; i--) {
+        var root = data[i];
+        stack.push({
+            root: root,
+            data: getChildren(root),
+            level: [i],
+            levelCount: data.length
+        });
+    }
+    while (stack.length > 0) {
+        var stackItem = stack.pop();
+        flatted.push(__assign(__assign({ dataItem: stackItem.root, level: __spreadArray([], stackItem.level, true) }, itemMap(stackItem.root)), { levelCount: stackItem.levelCount }));
+        if (stackItem.data.length) {
+            for (var i = stackItem.data.length - 1; i >= 0; i--) {
+                var root = stackItem.data[i];
+                stack.push({
+                    root: root,
+                    data: getChildren(root),
+                    level: __spreadArray(__spreadArray([], stackItem.level, true), [i], false),
+                    levelCount: stackItem.data.length
+                });
+            }
+        }
+    }
+    return flatted;
+}
+exports.flatData = flatData;
+/**
+ * Creates a flat data array from the passed tree dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {string} expandField - The field which points to the expanded value of each data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are in a flat structure.
+ */
+var treeToFlat = function (data, expandField, subItemsField) {
+    var expanded = function (dataItem) { return Boolean((0, kendo_react_common_1.getNestedValue)(expandField, dataItem)); };
+    var hasChildren = function (dataItem) { return Boolean((0, kendo_react_common_1.getNestedValue)(subItemsField, dataItem)); };
+    var getChildren = function (dataItem) {
+        var items = [];
+        if (expanded(dataItem) && hasChildren(dataItem)) {
+            items.push.apply(items, (0, kendo_react_common_1.getNestedValue)(subItemsField, dataItem));
+        }
+        return items;
+    };
+    var flatItems = function (dataItem, flatted, level) {
+        flatted.push(__assign(__assign({}, dataItem), { level: level }));
+        getChildren(dataItem).forEach(function (root) { return flatItems(root, flatted, level + 1); });
+    };
+    var flattedData = [];
+    data.forEach(function (root) { return flatItems(root, flattedData, 0); });
+    return flattedData;
+};
+exports.treeToFlat = treeToFlat;
+/**
+ * Creates a tree from the passed dataset.
+ *
+ * @param {object[]} dataset - The source dataset of data items.
+ * @param {(item: object) => any} getId - A function which will return the id of the data item.
+ * @param {(item: object) => any} getParentId - A function which will return the data item id of its parent data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {object[]} - A collection of the generated data items that are structured in a tree.
+ */
+var createDataTree = function (dataset, getId, getParentId, subItemsField) {
+    var hashTable = {}, dataTree = [], parentItem;
+    dataset.forEach(function (dataItem) { return hashTable[getId(dataItem)] = __assign({}, dataItem); });
+    dataset.forEach(function (dataItem) {
+        parentItem = hashTable[getParentId(dataItem)];
+        if (parentItem) {
+            parentItem[subItemsField] = parentItem[subItemsField] || [];
+            parentItem[subItemsField].push(hashTable[getId(dataItem)]);
+        }
+        else {
+            dataTree.push(hashTable[getId(dataItem)]);
+        }
+    });
+    return dataTree;
+};
+exports.createDataTree = createDataTree;
+/**
+ * Similar to the `Object.assign` function. Additionally, creates a new array for the subitems.
+ *
+ * @param {object} item - The source data item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {object} propsToExtend - The props with which the source data item will be extended.
+ * @returns {object} - The target data item.
+ */
+var extendDataItem = function (item, subItemsField, propsToExtend) {
+    return (0, kendo_react_common_1.extendDataItem)(item, subItemsField, propsToExtend);
+};
+exports.extendDataItem = extendDataItem;
+/**
+ * Removes the items from the passed `data` which match the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item
+ * in the tree data and the items for which returns true will be removed.
+ * @returns {any[]} - The new data tree.
+ */
+var removeItems = function (data, subItemsField, condition) {
+    var _a;
+    var newData = (0, kendo_react_common_1.mapTree)([(_a = {}, _a[subItemsField] = __spreadArray([], data, true), _a)], subItemsField, function (item) { return removeChild(item, condition, subItemsField); });
+    return __spreadArray([], newData[0][subItemsField], true);
+};
+exports.removeItems = removeItems;
+/**
+ * @hidden
+ */
+var removeChild = function (item, condition, subItemsField) {
+    var _a;
+    var subItems = item[subItemsField] || [];
+    var childIndex = subItems.findIndex(condition);
+    if (childIndex !== -1) {
+        var newChildren = __spreadArray([], subItems, true);
+        newChildren.splice(childIndex, 1);
+        return __assign(__assign({}, item), (_a = {}, _a[subItemsField] = newChildren, _a));
+    }
+    return item;
+};
+/**
+ * Changes the `subItems` collection of each data item which matches the passed `condition`.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @param {(item: object) => Boolean} condition - A function that will be executed for each data item and
+ * will return `true` for items that have to change the subitems collection.
+ * @param {(subItems: object[]) => object[]} change - A function which
+ * has as a parameter the subitems collection of the matched items and which will return the new subitems collection.
+ * @returns {any[]} - The new data tree.
+ */
+var modifySubItems = function (data, subItemsField, condition, change) {
+    return (0, kendo_react_common_1.mapTree)(data, subItemsField, function (item) {
+        var _a;
+        return condition(item) ? __assign(__assign({}, item), (_a = {}, _a[subItemsField] = change(item[subItemsField] || []), _a)) :
+            item;
+    });
+};
+exports.modifySubItems = modifySubItems;
+/**
+ * Returns the data item path in the tree based on the level parameter.
+ *
+ * @param {any[]} tree - The data tree.
+ * @param {number[]} level - The level of the target tree item.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The path of the data item.
+ */
+var getItemPath = function (tree, level, subItemsField) {
+    return (0, kendo_react_common_1.getItemPath)(tree, level, subItemsField);
+};
+exports.getItemPath = getItemPath;
+/**
+ * Moves the targeted item in the tree to another position.
+ *
+ * @param {any[]} data - The data tree.
+ * @param {number[]} target - The level of the target tree item which will be moved.
+ * @param {number[] | null} destination - The level of the destination tree item where the target item will be moved in.
+ * If it is null, the target item will be added at the root level.
+ * @param {string} subItemsField - The field which points to the subitems collection of each data item.
+ * @returns {any[]} - The new data tree.
+ */
+var moveTreeItem = function (data, target, destination, subItemsField) {
+    var tree = __spreadArray([], data, true);
+    var targetItemPath = (0, exports.getItemPath)(tree, target, subItemsField);
+    var targetItem = targetItemPath.pop();
+    var targetParent = targetItemPath.pop();
+    var targetItemIndex = target[target.length - 1];
+    if (destination) {
+        var destinationItemPath = (0, exports.getItemPath)(tree, destination, subItemsField);
+        var destinationItem = destinationItemPath.pop();
+        (targetParent ? targetParent[subItemsField] : tree).splice(targetItemIndex, 1);
+        destinationItem[subItemsField] = destinationItem[subItemsField] || [];
+        destinationItem[subItemsField].push(targetItem);
+    }
+    else {
+        (targetParent ? targetParent[subItemsField] : tree).splice(targetItemIndex, 1);
+        tree.push(targetItem);
+    }
+    return tree;
+};
+exports.moveTreeItem = moveTreeItem;