@progress/kendo-vue-treeview 3.2.2-dev.202204181420

package/dist/es/utils/consts.js

@@ -0,0 +1,40 @@
+/**
+ * @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

@@ -0,0 +1,5 @@
+import FieldsService from './FieldsService';
+/**
+ * @hidden
+ */
+export default function getItemIdUponKeyboardNavigation(item: any, itemId: string, items: any[], keyCode: number, fieldsSvc: FieldsService): any;

package/dist/es/utils/getItemIdUponKeyboardNavigation.js

@@ -0,0 +1,77 @@
+import { Keys } from '@progress/kendo-vue-common';
+import * as idUtils from './itemIdUtils';
+import { isItemExpandedAndWithChildren, isEnabledAndAllParentsEnabled } from './itemUtils';
+/**
+ * @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 idUtils.ZERO_LEVEL_ZERO_NODE_ID;
+        case Keys.end:
+            return getIdUponEndKey();
+        default:
+            return itemId;
+    }
+    function getIdUponLeftKey() {
+        return idUtils.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 : idUtils.getDirectParentId(itemId);
+    }
+    function getIdUponRightKey() {
+        return isItemExpandedAndWithChildren(item, fieldsSvc) ? idUtils.getFirstChildId(itemId) : itemId;
+    }
+    function getIdUponUpKey() {
+        var index = Number(idUtils.getShortId(itemId));
+        var parentId = idUtils.getDirectParentId(itemId);
+        return index ? getLastNotOpenedChildId(idUtils.createId(index - 1, parentId), items, fieldsSvc) :
+            idUtils.isIdZeroLevel(itemId) ? itemId : parentId;
+    }
+    function getIdUponDownKey() {
+        if (isItemExpandedAndWithChildren(item, fieldsSvc)) {
+            return idUtils.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 = idUtils.createId(children.length - 1, result);
+            currentItem = children[children.length - 1];
+        }
+        return result;
+    }
+}
+function getNextItemId(itemId, items, fieldsSvc) {
+    var parentId = idUtils.getDirectParentId(itemId);
+    var parent = parentId ? idUtils.getItemById(parentId, items, fieldsSvc.getChildrenField()) : undefined;
+    var siblings = parent ? parent[fieldsSvc.getChildrenField()] : items;
+    var index = Number(idUtils.getShortId(itemId));
+    return index < siblings.length - 1 ?
+        idUtils.createId(index + 1, parentId) :
+        parent ? getNextItemId(parentId, items, fieldsSvc) : undefined;
+}
+function getLastNotOpenedChildId(itemId, items, fieldsSvc) {
+    var item = idUtils.getItemById(itemId, items, fieldsSvc.getChildrenField());
+    if (isItemExpandedAndWithChildren(item, fieldsSvc)) {
+        return getLastNotOpenedChildId(idUtils.createId(item[fieldsSvc.getChildrenField()].length - 1, itemId), items, fieldsSvc);
+    }
+    else {
+        return itemId;
+    }
+}

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

@@ -0,0 +1,60 @@
+/**
+ * @hidden
+ */
+export declare const EMPTY_ID = "";
+/**
+ * @hidden
+ */
+export declare const ZERO_LEVEL_ZERO_NODE_ID = "0";
+/**
+ * @hidden
+ */
+export declare const SEPARATOR = "_";
+/**
+ * @hidden
+ */
+export declare function getItemById(itemId: string, items: any, childrenField: string): any;
+/**
+ * @hidden
+ */
+export declare function getRootParentId(itemId: string): string;
+/**
+ * @hidden
+ */
+export declare function getIdWithoutRootParentId(itemId: string): string;
+/**
+ * @hidden
+ */
+export declare function getFirstChildId(itemId: string): string;
+/**
+ * @hidden
+ */
+export declare function createId(childId: string | number, parentId?: string): string;
+/**
+ * @hidden
+ */
+export declare function getDirectParentId(itemId: string): string;
+/**
+ * @hidden
+ */
+export declare function isIdEmptyOrZeroLevel(itemId: string): boolean;
+/**
+ * @hidden
+ */
+export declare function isIdZeroLevel(itemId: string): boolean;
+/**
+ * @hidden
+ */
+export declare function getAllShortIds(itemId: string): string[];
+/**
+ * @hidden
+ */
+export declare function getShortId(itemId: string): string;
+/**
+ * @hidden
+ */
+export declare function isItemFirstFromSiblings(itemId: string): boolean;
+/**
+ * @hidden
+ */
+export declare function getDecrementedItemIdAfterRemoval(removedItemId: string, itemId: string): string;

package/dist/es/utils/itemIdUtils.js

@@ -0,0 +1,117 @@
+/**
+ * @hidden
+ */
+export var EMPTY_ID = '';
+/**
+ * @hidden
+ */
+export var ZERO_LEVEL_ZERO_NODE_ID = '0';
+/**
+ * @hidden
+ */
+export var SEPARATOR = '_';
+/**
+ * @hidden
+ */
+export function getItemById(itemId, items, childrenField) {
+    if (isIdZeroLevel(itemId)) {
+        return items[Number(itemId)];
+    }
+    else {
+        var rootParentItem = items[Number(getRootParentId(itemId))];
+        var subItems = (rootParentItem && rootParentItem[childrenField]) || [];
+        return subItems.length ?
+            getItemById(getIdWithoutRootParentId(itemId), subItems, childrenField) : undefined;
+    }
+}
+/**
+ * @hidden
+ */
+export function getRootParentId(itemId) {
+    return isIdEmptyOrZeroLevel(itemId) ? itemId : itemId.split(SEPARATOR)[0];
+}
+/**
+ * @hidden
+ */
+export function getIdWithoutRootParentId(itemId) {
+    if (isIdEmptyOrZeroLevel(itemId)) {
+        return itemId;
+    }
+    else {
+        var firstSeparatorIndex = itemId.indexOf(SEPARATOR);
+        return itemId.substring(firstSeparatorIndex + 1);
+    }
+}
+/**
+ * @hidden
+ */
+export function getFirstChildId(itemId) {
+    return createId('0', itemId);
+}
+/**
+ * @hidden
+ */
+export function createId(childId, parentId) {
+    childId = childId.toString();
+    return parentId ? parentId + SEPARATOR + childId : childId;
+}
+/**
+ * @hidden
+ */
+export function getDirectParentId(itemId) {
+    var lastSeparatorIndex = itemId.lastIndexOf(SEPARATOR);
+    return lastSeparatorIndex < 0 ? EMPTY_ID : itemId.substring(0, lastSeparatorIndex);
+}
+/**
+ * @hidden
+ */
+export function isIdEmptyOrZeroLevel(itemId) {
+    return itemId === EMPTY_ID || itemId.indexOf(SEPARATOR) < 0;
+}
+/**
+ * @hidden
+ */
+export function isIdZeroLevel(itemId) {
+    return itemId !== EMPTY_ID && itemId.indexOf(SEPARATOR) < 0;
+}
+/**
+ * @hidden
+ */
+export function getAllShortIds(itemId) {
+    return itemId.split(SEPARATOR);
+}
+/**
+ * @hidden
+ */
+export function getShortId(itemId) {
+    var lastSeparatorIndex = itemId.lastIndexOf(SEPARATOR);
+    return lastSeparatorIndex < 0 ? itemId : itemId.substring(lastSeparatorIndex + 1);
+}
+/**
+ * @hidden
+ */
+export function isItemFirstFromSiblings(itemId) {
+    return getShortId(itemId) === ZERO_LEVEL_ZERO_NODE_ID;
+}
+/**
+ * @hidden
+ */
+export function getDecrementedItemIdAfterRemoval(removedItemId, itemId) {
+    var preservedItemId = itemId;
+    removedItemId = 'r' + SEPARATOR + removedItemId;
+    itemId = 'r' + SEPARATOR + itemId;
+    var itemSharedPath = getDirectParentId(removedItemId) + SEPARATOR;
+    if (itemId.startsWith(itemSharedPath)) {
+        var itemNotSharedPath = itemId.substring(itemSharedPath.length);
+        if (itemNotSharedPath) {
+            var siblingShortId = getRootParentId(itemNotSharedPath);
+            if (Number(getShortId(removedItemId)) < Number(siblingShortId)) {
+                var decrementedId = itemSharedPath +
+                    (Number(siblingShortId) - 1).toString() +
+                    itemNotSharedPath.substring(siblingShortId.length);
+                return getIdWithoutRootParentId(decrementedId);
+            }
+        }
+    }
+    return preservedItemId;
+}

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

@@ -0,0 +1,45 @@
+import FieldsService from './FieldsService';
+/**
+ * @hidden
+ */
+export declare function hasChildren(item: any, childrenField: string): boolean;
+/**
+ * @hidden
+ */
+export declare function isItemExpandedAndWithChildren(item: any, fieldsSvc: FieldsService): boolean;
+/**
+ * @hidden
+ */
+export declare function resolveItemId(publicId: any, idField: string, items: any[], childrenField: string): string;
+/**
+ * @hidden
+ */
+export declare function resolveItemsIds(publicIds: any[], idField: string, items: any[], childrenField: string): string[];
+/**
+ * @hidden
+ */
+export declare function updateItem(items: any[], itemId: string, update: (item: any) => void, cloneField: string, childrenField: string): any[];
+/**
+ * @hidden
+ */
+export declare function isEnabledAndAllParentsEnabled(itemId: string, items: any, fieldsSvc: FieldsService): any;
+/**
+ * @hidden
+ */
+export declare function getAllDirectIndirectChildrenIds(item: any, itemId: string, childrenField: string, idField: string | undefined): any[];
+/**
+ * @hidden
+ */
+export declare function areAllDirectChildrenChecked(item: any, itemId: any, idField: string | undefined, childrenField: string, check: string[]): any;
+/**
+ * @hidden
+ */
+export declare function getAllParents(itemId: string, childrenField: string, items: any[]): any[];
+/**
+ * @hidden
+ */
+export declare function removeItem(itemId: string, childrenField: string, items: any[]): any[];
+/**
+ * @hidden
+ */
+export declare function addItem(item: any, operation: 'before' | 'after' | 'child', childrenField: string, targetItemId: string, items: any[]): any[];

package/dist/es/utils/itemUtils.js

@@ -0,0 +1,191 @@
+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 { EMPTY_ID, isIdZeroLevel, createId, getRootParentId, getIdWithoutRootParentId, getAllShortIds } from './itemIdUtils';
+import SortedPublicItemIds from './SortedPublicItemIds';
+import { getNestedValue } from './misc';
+/**
+ * @hidden
+ */
+export function hasChildren(item, childrenField) {
+    var children = getNestedValue(childrenField, item);
+    return Boolean(children && children.length);
+}
+/**
+ * @hidden
+ */
+export function isItemExpandedAndWithChildren(item, fieldsSvc) {
+    return fieldsSvc.expanded(item) && hasChildren(item, fieldsSvc.getChildrenField());
+}
+/**
+ * @hidden
+ */
+export function resolveItemId(publicId, idField, items, childrenField) {
+    var resolvedIds = resolveItemsIds([publicId], idField, items, childrenField);
+    return resolvedIds.length ? resolvedIds[0] : undefined;
+}
+/**
+ * @hidden
+ */
+export function resolveItemsIds(publicIds, idField, items, childrenField) {
+    var result = [];
+    var sortedIds = new SortedPublicItemIds();
+    sortedIds.init(publicIds);
+    resolveItemsIdsHelper(sortedIds, idField, items, EMPTY_ID, result, childrenField);
+    return result;
+}
+/**
+ * @hidden
+ */
+export function updateItem(items, itemId, update, cloneField, childrenField) {
+    var _a;
+    var itemIndex = Number(getRootParentId(itemId));
+    if (itemIndex >= items.length) {
+        return items;
+    }
+    var result = items;
+    var item = items[itemIndex];
+    // Clone the item before updating it.
+    if (!item[cloneField]) {
+        result = items.slice();
+        item = result[itemIndex] = Object.assign({}, item, (_a = {}, _a[cloneField] = true, _a));
+    }
+    // Directly update the item.
+    if (isIdZeroLevel(itemId)) {
+        update(item);
+    }
+    else if (item[childrenField]) {
+        item[childrenField] = updateItem(item[childrenField], getIdWithoutRootParentId(itemId), update, cloneField, childrenField);
+    }
+    return result;
+}
+/**
+ * @hidden
+ */
+export function isEnabledAndAllParentsEnabled(itemId, items, fieldsSvc) {
+    var ids = getAllShortIds(itemId);
+    var currentItems = items;
+    for (var i = 0; i < ids.length; i++) {
+        var currentItem = currentItems[Number(ids[i])];
+        if (fieldsSvc.disabled(currentItem)) {
+            return false;
+        }
+        else {
+            currentItems = currentItem[fieldsSvc.getChildrenField()];
+        }
+    }
+    return true;
+}
+/**
+ * @hidden
+ */
+export function getAllDirectIndirectChildrenIds(item, itemId, childrenField, idField) {
+    return idField ? getChildrenPublicIds(item) : getChildrenHierarchicalIndices(item, itemId);
+    function getChildrenHierarchicalIndices(startItem, startItemId) {
+        var result = [];
+        var children = startItem[childrenField] || [];
+        for (var i = 0; i < children.length; i++) {
+            var id = createId(i, startItemId);
+            result.push(id);
+            result = result.concat(getChildrenHierarchicalIndices(children[i], id));
+        }
+        return result;
+    }
+    function getChildrenPublicIds(startItem) {
+        var result = [];
+        var children = startItem[childrenField] || [];
+        for (var i = 0; i < children.length; i++) {
+            result.push(getNestedValue(idField, children[i]));
+            result = result.concat(getChildrenPublicIds(children[i]));
+        }
+        return result;
+    }
+}
+/**
+ * @hidden
+ */
+export function areAllDirectChildrenChecked(item, itemId, idField, childrenField, check) {
+    var children = item[childrenField] || [];
+    return children.every(function (child, index) {
+        return check.indexOf(idField ? getNestedValue(idField, child) : createId(index, itemId)) > -1;
+    });
+}
+/**
+ * @hidden
+ */
+export function getAllParents(itemId, childrenField, items) {
+    var result = [];
+    var ids = getAllShortIds(itemId);
+    var currentItems = items;
+    for (var i = 0; i < ids.length - 1; i++) {
+        if (!currentItems) {
+            break;
+        }
+        var currentItem = currentItems[Number(ids[i])];
+        result.push(currentItem);
+        currentItems = currentItem[childrenField];
+    }
+    return result;
+}
+/**
+ * @hidden
+ */
+export function removeItem(itemId, childrenField, items) {
+    var result = items.slice();
+    if (isIdZeroLevel(itemId)) {
+        result.splice(Number(itemId), 1);
+    }
+    else {
+        var rootParentIndex = Number(getRootParentId(itemId));
+        var rootParent = result[rootParentIndex] = __assign({}, result[rootParentIndex]);
+        rootParent[childrenField] = removeItem(getIdWithoutRootParentId(itemId), childrenField, rootParent[childrenField]);
+    }
+    return result;
+}
+/**
+ * @hidden
+ */
+export function addItem(item, operation, childrenField, targetItemId, items) {
+    var result = items.slice();
+    if (isIdZeroLevel(targetItemId)) {
+        if (operation === 'child') {
+            var targetItem = result[Number(targetItemId)] = __assign({}, result[Number(targetItemId)]);
+            if (targetItem[childrenField]) {
+                targetItem[childrenField] = targetItem[childrenField].slice();
+                targetItem[childrenField].push(item);
+            }
+            else {
+                targetItem[childrenField] = [item];
+            }
+        }
+        else {
+            result.splice(Number(targetItemId) + (operation === 'after' ? 1 : 0), 0, item);
+        }
+    }
+    else {
+        var rootParentIndex = Number(getRootParentId(targetItemId));
+        var rootParent = result[rootParentIndex] = __assign({}, result[rootParentIndex]);
+        rootParent[childrenField] = addItem(item, operation, childrenField, getIdWithoutRootParentId(targetItemId), rootParent[childrenField]);
+    }
+    return result;
+}
+function resolveItemsIdsHelper(publicItemIds, idField, items, parentItemId, resolvedIds, childrenField) {
+    for (var i = 0; i < items.length; i++) {
+        var item = items[i];
+        var id = createId(i, parentItemId);
+        if (publicItemIds.hasId(getNestedValue(idField, item))) {
+            resolvedIds.push(id);
+        }
+        if (hasChildren(item, childrenField)) {
+            resolveItemsIdsHelper(publicItemIds, idField, getNestedValue(childrenField, item), id, resolvedIds, childrenField);
+        }
+    }
+}

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

@@ -0,0 +1,9 @@
+import { TreeViewOperationDescriptor } from '../TreeViewOperationDescriptors';
+/**
+ * @hidden
+ */
+export declare function getNestedValue(fieldName: string | undefined, dataItem: any): any;
+/**
+ * @hidden
+ */
+export declare function isArray(operation: string[] | TreeViewOperationDescriptor): operation is any[];

package/dist/es/utils/misc.js

@@ -0,0 +1,17 @@
+/**
+ * @hidden
+ */
+export function getNestedValue(fieldName, dataItem) {
+    var path = (fieldName || '').split('.');
+    var data = dataItem;
+    path.forEach(function (p) {
+        data = data ? data[p] : undefined;
+    });
+    return data;
+}
+/**
+ * @hidden
+ */
+export function isArray(operation) {
+    return operation.length !== undefined;
+}

package/dist/npm/ItemRenderProps.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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

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

package/dist/npm/TreeView.d.ts

@@ -0,0 +1,45 @@
+import { DefineComponent } from './additionalTypes';
+import { RecordPropsDefinition, ComponentOptions } from 'vue/types/options';
+declare type DefaultData<V> = object | ((this: V) => {});
+declare type DefaultMethods<V> = {
+    [key: string]: (this: V, ...args: any[]) => any;
+};
+import { TreeViewProps } from './TreeViewProps';
+import FieldsService from './utils/FieldsService';
+/**
+ * @hidden
+ */
+export interface TreeViewState {
+    blurRequest: any;
+    fieldsSvc: FieldsService;
+    treeGuid: string;
+    allowExplicitFocus: boolean;
+}
+/**
+ * @hidden
+ */
+export interface TreeViewComputed {
+    [key: string]: any;
+}
+/**
+ * @hidden
+ */
+export interface TreeViewMethods {
+    [key: string]: any;
+}
+/**
+ * @hidden
+ */
+export interface TreeViewData {
+    focusedItemId?: string;
+    focusedItemPublicId?: any;
+    tabbableItemId?: string;
+}
+/**
+ * @hidden
+ */
+export interface TreeViewAll extends Vue, TreeViewMethods, TreeViewData, TreeViewComputed, TreeViewState {
+}
+declare let TreeViewVue2: ComponentOptions<TreeViewAll, DefaultData<TreeViewData>, DefaultMethods<TreeViewAll>, TreeViewComputed, RecordPropsDefinition<TreeViewProps>>;
+declare const TreeView: DefineComponent<TreeViewProps, any, TreeViewData, TreeViewComputed, TreeViewMethods, {}, {}, {}, string, TreeViewProps, TreeViewProps, {}>;
+export { TreeView, TreeViewVue2 };