@progress/kendo-react-treeview 6.1.1 → 7.0.0-develop.2

package/dist/es/moveTreeViewItem.js

@@ -1,155 +0,0 @@
-import { addItem, removeItem, treeIdUtils } from '@progress/kendo-react-common';
-import { CHILDREN_FIELD } from './utils/consts';
-/**
- *  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
- * class App extends React.Component {
- *     dragClue;
- *     state = { tree };
- *
- *     render() {
- *         return (
- *             <div>
- *                 <TreeView data={this.state.tree} draggable={true}
- *                     onItemDragOver={this.onItemDragOver} onItemDragEnd={this.onItemDragEnd} />
- *                 <TreeViewDragClue ref={dragClue => this.dragClue = dragClue} />
- *             </div>
- *         );
- *     }
- *
- *     onItemDragOver = (event) => {
- *         this.dragClue.show(event.pageY + 10, event.pageX, event.item.text, this.getClueClassName(event));
- *     }
- *     onItemDragEnd = (event) => {
- *         this.dragClue.hide();
- *         const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
- *
- *         if (eventAnalyzer.isDropAllowed) {
- *             const updatedTree = moveTreeViewItem(
- *                 event.itemHierarchicalIndex,
- *                 this.state.tree,
- *                 eventAnalyzer.getDropOperation(),
- *                 eventAnalyzer.destinationMeta.itemHierarchicalIndex,
- *             );
- *
- *             this.setState({ tree: updatedTree });
- *         }
- *     }
- *     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, this.state.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';
- *     }
- * }
- *
- * function 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 SEPARATOR = '_';
- * const tree = [{
- *     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 }]
- * }];
- *
- * ReactDOM.render(<App />, document.querySelector('my-app'));
- * ```
- */
-export function moveTreeViewItem(sourceItemHierarchicalIndex, sourceData, operation, targetItemHierarchicalIndex, targetData, childrenField) {
-    var subItemsField = childrenField || CHILDREN_FIELD;
-    if (!validateInput()) {
-        return prepareInputDataForReturn();
-    }
-    var sourceItem = treeIdUtils.getItemById(sourceItemHierarchicalIndex, sourceData, subItemsField);
-    if (!sourceItem) {
-        return prepareInputDataForReturn();
-    }
-    // The source and the target tree are the same.
-    if (!targetData || targetData === sourceData) {
-        if (!validateNoCircularReference()) {
-            return prepareInputDataForReturn();
-        }
-        var updatedSourceData = removeItem(sourceItemHierarchicalIndex, subItemsField, sourceData);
-        var resultData = addItem(sourceItem, operation, subItemsField, treeIdUtils.getDecrementedItemIdAfterRemoval(sourceItemHierarchicalIndex, targetItemHierarchicalIndex), updatedSourceData);
-        // A simpler output is explicitly returned when the source and the target tree are
-        // the same, that is, the targetData argument is skipped.
-        return targetData ? { sourceData: resultData, targetData: resultData } : resultData;
-    }
-    else {
-        var updatedSource = removeItem(sourceItemHierarchicalIndex, subItemsField, sourceData);
-        var updatedTarget = addItem(sourceItem, operation, subItemsField, targetItemHierarchicalIndex, targetData);
-        return { sourceData: updatedSource, targetData: updatedTarget };
-    }
-    function prepareInputDataForReturn() {
-        return targetData ? { sourceData: sourceData, targetData: targetData } : sourceData;
-    }
-    function validateNoCircularReference() {
-        return !"".concat(targetItemHierarchicalIndex, "_").startsWith("".concat(sourceItemHierarchicalIndex, "_"));
-    }
-    function validateInput() {
-        if (!sourceData || !sourceData.length ||
-            !sourceItemHierarchicalIndex || !targetItemHierarchicalIndex) {
-            return false;
-        }
-        if (targetData && !targetData.length) {
-            // Dropping over an empty tree is not supported.
-            return false;
-        }
-        // Validate that the target item exists.
-        var data = !targetData || targetData === sourceData ? sourceData : targetData;
-        if (!treeIdUtils.getItemById(targetItemHierarchicalIndex, data, subItemsField)) {
-            return false;
-        }
-        return true;
-    }
-}

package/dist/es/package-metadata.d.ts

@@ -1,5 +0,0 @@
-import { PackageMetadata } from '@progress/kendo-licensing';
-/**
- * @hidden
- */
-export declare const packageMetadata: PackageMetadata;

package/dist/es/package-metadata.js

@@ -1,11 +0,0 @@
-/**
- * @hidden
- */
-export var packageMetadata = {
-    name: '@progress/kendo-react-treeview',
-    productName: 'KendoReact',
-    productCodes: ['KENDOUIREACT', 'KENDOUICOMPLETE'],
-    publishDate: 1700064084,
-    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/processTreeViewItems.js

@@ -1,163 +0,0 @@
-/* eslint-disable max-len */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-import { updateItem, resolveItemsIds, getNestedValue, isArray } from '@progress/kendo-react-common';
-import { EXPAND_FIELD, SELECT_FIELD, CHECK_FIELD, CHECK_INDETERMINATE_FIELD, CHILDREN_FIELD } from './utils/consts';
-/**
- * A helper function which applies the specified operation descriptors to the data.
- * * [Expanding and collapsing items]({% slug expansion_ways_treeview %}#toc-using-a-helper-function)
- * * [Selecting and deselecting items]({% slug selection_ways_treeview %}#toc-using-a-helper-function)
- * * [Checking and unchecking items]({% slug check_helper_funcs_treeview %})
- *
- * @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
- * class App extends React.Component {
- *     state = { items: tree, expand: [], select: [], check: [] };
- *     render() {
- *         const { expand, select, check } = this.state;
- *         return (
- *             <TreeView
- *                 data={processTreeViewItems(this.state.items, { expand, select, check })}
- *                 expandIcons={true} onExpandChange={this.onExpandChange} checkboxes={true}
- *                 onCheckChange={event => this.setState({ check: [ event.itemHierarchicalIndex ] })}
- *                 onItemClick={event => this.setState({ select: [ event.itemHierarchicalIndex ] })}
- *             />
- *         );
- *     }
- *     onExpandChange = (event) => {
- *         let expand = this.state.expand.slice();
- *         const index = expand.indexOf(event.itemHierarchicalIndex);
- *         index === -1 ? expand.push(event.itemHierarchicalIndex) : expand.splice(index, 1);
- *         this.setState({ expand });
- *     }
- * }
- *
- * 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'
- * }];
- *
- * ReactDOM.render(<App />, document.querySelector('my-app'));
- * ```
- */
-export function processTreeViewItems(data, operations) {
-    if (!data || !data.length) {
-        return [];
-    }
-    var result = data;
-    var cloneField = operations.cloneField || 'cloned';
-    var expandField = operations.expandField || EXPAND_FIELD;
-    var selectField = operations.selectField || SELECT_FIELD;
-    var checkField = operations.checkField || CHECK_FIELD;
-    var childrenField = operations.childrenField || CHILDREN_FIELD;
-    result = handleOperation(result, expandField, operations.expand, cloneField, childrenField);
-    result = handleOperation(result, selectField, operations.select, cloneField, childrenField);
-    result = handleOperation(result, checkField, operations.check, cloneField, childrenField);
-    applyCheckIndeterminate(result, childrenField, operations.check);
-    return result;
-}
-function handleOperation(items, defaultField, operation, cloneField, childrenField) {
-    if (operation) {
-        var _a = parseOperation(operation, defaultField), ids = _a.ids, field = _a.field;
-        var indices = !isArray(operation) && operation.idField ? resolveItemsIds(ids, operation.idField, items, childrenField) : ids;
-        return raiseFlags(items, indices, field, cloneField, childrenField);
-    }
-    else {
-        return items;
-    }
-}
-function parseOperation(operation, defaultField) {
-    var ids;
-    var field;
-    if (isArray(operation)) {
-        ids = operation;
-        field = defaultField;
-    }
-    else {
-        ids = operation.ids || [];
-        field = operation.operationField || defaultField;
-    }
-    return { ids: ids, field: field };
-}
-function raiseFlags(items, indices, field, cloneField, childrenField) {
-    var result = items;
-    indices.forEach(function (itemIndex) {
-        result = updateItem(result, itemIndex, function (item) { return raiseNestedFlag(field, item); }, cloneField, childrenField);
-    });
-    return result;
-}
-function raiseNestedFlag(fieldName, dataItem) {
-    var fields = (fieldName || '').split('.');
-    var item = dataItem;
-    for (var index = 0; index < fields.length; index++) {
-        var field = fields[index];
-        if (index === fields.length - 1) {
-            item[field] = true;
-        }
-        else if (item[field] !== undefined) {
-            item[field] = __assign({}, item[field]);
-            item = item[field];
-        }
-        else {
-            return;
-        }
-    }
-}
-function applyCheckIndeterminate(items, childrenField, check) {
-    if (check && !isArray(check) && check.applyCheckIndeterminate) {
-        var checkField = parseOperation(check, CHECK_FIELD).field;
-        var checkIndeterminateField = check.checkIndeterminateField || CHECK_INDETERMINATE_FIELD;
-        for (var i = 0; i < items.length; i++) {
-            var item = items[i];
-            var subItems = item[childrenField];
-            if (subItems) {
-                applyCheckIndeterminateHelper(subItems, getNestedValue(checkField, item) ? [] : [item], childrenField, checkField, checkIndeterminateField);
-            }
-        }
-    }
-}
-function applyCheckIndeterminateHelper(data, parents, childrenField, checkField, checkIndeterminateField) {
-    // The updates will be direct because the corresponding items
-    // are already cloned because of their checked children.
-    var parentsAlreadyUpdated = false;
-    for (var i = 0; i < data.length; i++) {
-        var item = data[i];
-        if (getNestedValue(checkField, item)) {
-            if (!parentsAlreadyUpdated) {
-                for (var j = 0; j < parents.length; j++) {
-                    raiseNestedFlag(checkIndeterminateField, parents[j]);
-                }
-            }
-            parentsAlreadyUpdated = true;
-            if (item[childrenField]) {
-                applyCheckIndeterminateHelper(item[childrenField], [], childrenField, checkField, checkIndeterminateField);
-            }
-        }
-        else {
-            if (item[childrenField]) {
-                applyCheckIndeterminateHelper(item[childrenField], parentsAlreadyUpdated ? [item] : parents.concat([item]), childrenField, checkField, checkIndeterminateField);
-            }
-        }
-    }
-}

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

@@ -1,40 +0,0 @@
-/**
- * @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 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/dist/es/utils/consts.js

@@ -1,40 +0,0 @@
-/**
- * @hidden
- */
-export var EXPAND_FIELD = 'expanded';
-/**
- * @hidden
- */
-export var TEXT_FIELD = 'text';
-/**
- * @hidden
- */
-export var DISABLED_FIELD = 'disabled';
-/**
- * @hidden
- */
-export var CHILDREN_FIELD = 'items';
-/**
- * @hidden
- */
-export var HAS_CHILDREN_FIELD = 'hasChildren';
-/**
- * @hidden
- */
-export var SELECT_FIELD = 'selected';
-/**
- * @hidden
- */
-export var CHECK_FIELD = 'checked';
-/**
- * @hidden
- */
-export var CHECK_INDETERMINATE_FIELD = 'checkIndeterminate';
-/**
- * @hidden
- */
-export var DOM_KENDO_ITEM_ID_FIELD = '_kendoItemId';
-/**
- * @hidden
- */
-export var DOM_KENDO_TREEVIEW_GUID_FIELD = '_kendoTreeViewGuid';

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

@@ -1,5 +0,0 @@
-import { TreeFieldsService } from '@progress/kendo-react-common';
-/**
- * @hidden
- */
-export default function getItemIdUponKeyboardNavigation(item: any, itemId: string, items: any[], keyCode: number, fieldsSvc: TreeFieldsService): any;

package/dist/es/utils/getItemIdUponKeyboardNavigation.js

@@ -1,76 +0,0 @@
-import { Keys } from '@progress/kendo-react-common';
-import { isItemExpandedAndWithChildren, isEnabledAndAllParentsEnabled, treeIdUtils } from '@progress/kendo-react-common';
-/**
- * @hidden
- */
-export default function getItemIdUponKeyboardNavigation(item, itemId, items, keyCode, fieldsSvc) {
-    switch (keyCode) {
-        case Keys.left:
-            return getIdUponLeftKey();
-        case Keys.right:
-            return getIdUponRightKey();
-        case Keys.up:
-            return getIdUponUpKey();
-        case Keys.down:
-            return getIdUponDownKey();
-        case Keys.home:
-            return treeIdUtils.ZERO_LEVEL_ZERO_NODE_ID;
-        case Keys.end:
-            return getIdUponEndKey();
-        default:
-            return itemId;
-    }
-    function getIdUponLeftKey() {
-        return treeIdUtils.isIdZeroLevel(itemId)
-            // For expanded disabled items, navigate directly to the parent.
-            // Collapse cannot happen because an event is not fired to the client.
-            || (fieldsSvc.expanded(item) && isEnabledAndAllParentsEnabled(itemId, items, fieldsSvc)) ?
-            itemId : treeIdUtils.getDirectParentId(itemId);
-    }
-    function getIdUponRightKey() {
-        return isItemExpandedAndWithChildren(item, fieldsSvc) ? treeIdUtils.getFirstChildId(itemId) : itemId;
-    }
-    function getIdUponUpKey() {
-        var index = Number(treeIdUtils.getShortId(itemId));
-        var parentId = treeIdUtils.getDirectParentId(itemId);
-        return index ? getLastNotOpenedChildId(treeIdUtils.createId(index - 1, parentId), items, fieldsSvc) :
-            treeIdUtils.isIdZeroLevel(itemId) ? itemId : parentId;
-    }
-    function getIdUponDownKey() {
-        if (isItemExpandedAndWithChildren(item, fieldsSvc)) {
-            return treeIdUtils.getFirstChildId(itemId);
-        }
-        else {
-            return getNextItemId(itemId, items, fieldsSvc) || itemId;
-        }
-    }
-    function getIdUponEndKey() {
-        var result = (items.length - 1).toString();
-        var currentItem = items[items.length - 1];
-        var children;
-        while (isItemExpandedAndWithChildren(currentItem, fieldsSvc)) {
-            children = currentItem[fieldsSvc.getChildrenField()];
-            result = treeIdUtils.createId(children.length - 1, result);
-            currentItem = children[children.length - 1];
-        }
-        return result;
-    }
-}
-function getNextItemId(itemId, items, fieldsSvc) {
-    var parentId = treeIdUtils.getDirectParentId(itemId);
-    var parent = parentId ? treeIdUtils.getItemById(parentId, items, fieldsSvc.getChildrenField()) : undefined;
-    var siblings = parent ? parent[fieldsSvc.getChildrenField()] : items;
-    var index = Number(treeIdUtils.getShortId(itemId));
-    return index < siblings.length - 1 ?
-        treeIdUtils.createId(index + 1, parentId) :
-        parent ? getNextItemId(parentId, items, fieldsSvc) : undefined;
-}
-function getLastNotOpenedChildId(itemId, items, fieldsSvc) {
-    var item = treeIdUtils.getItemById(itemId, items, fieldsSvc.getChildrenField());
-    if (isItemExpandedAndWithChildren(item, fieldsSvc)) {
-        return getLastNotOpenedChildId(treeIdUtils.createId(item[fieldsSvc.getChildrenField()].length - 1, itemId), items, fieldsSvc);
-    }
-    else {
-        return itemId;
-    }
-}

package/dist/npm/ItemRenderProps.d.ts

@@ -1,13 +0,0 @@
-/**
- * The props of the ItemRender component ([see example]({% slug rendering_treeview %})).
- */
-export interface ItemRenderProps {
-    /**
-     * The item that is rendered.
-     */
-    item: any;
-    /**
-     * The hierarchical index of the item. The indices are zero-based. The first root item has a `0` (zero) index. If the first root item has children, the first child acquires a `0_0` index and the second acquires a `0_1` index.
-     */
-    itemHierarchicalIndex: string;
-}

package/dist/npm/ItemRenderProps.js

@@ -1,3 +0,0 @@
-"use strict";
-/* eslint-disable max-len */
-Object.defineProperty(exports, "__esModule", { value: true });