@headless-tree/core 0.0.0-20230802230636

package/lib/esm/core/create-tree.js

@@ -0,0 +1,134 @@
+import { treeFeature } from "../features/tree/feature";
+const buildItemInstance = (features, tree, itemId) => {
+    var _a, _b;
+    const itemInstance = {};
+    for (const feature of features) {
+        Object.assign(itemInstance, (_b = (_a = feature.createItemInstance) === null || _a === void 0 ? void 0 : _a.call(feature, Object.assign({}, itemInstance), itemInstance, tree, itemId)) !== null && _b !== void 0 ? _b : {});
+    }
+    return itemInstance;
+};
+const verifyFeatures = (features) => {
+    var _a;
+    const loadedFeatures = features === null || features === void 0 ? void 0 : features.map((feature) => feature.key);
+    for (const feature of features !== null && features !== void 0 ? features : []) {
+        const missingDependency = (_a = feature.deps) === null || _a === void 0 ? void 0 : _a.find((dep) => !(loadedFeatures === null || loadedFeatures === void 0 ? void 0 : loadedFeatures.includes(dep)));
+        if (missingDependency) {
+            throw new Error(`${feature.key} needs ${missingDependency}`);
+        }
+    }
+};
+const compareFeatures = (feature1, feature2) => {
+    var _a;
+    if (feature2.key && ((_a = feature1.overwrites) === null || _a === void 0 ? void 0 : _a.includes(feature2.key))) {
+        return 1;
+    }
+    return -1;
+};
+const sortFeatures = (features = []) => features.sort(compareFeatures);
+export const createTree = (initialConfig) => {
+    var _a, _b, _c, _d, _e;
+    const treeInstance = {};
+    const additionalFeatures = [
+        treeFeature,
+        ...sortFeatures(initialConfig.features),
+    ];
+    verifyFeatures(additionalFeatures);
+    let state = additionalFeatures.reduce((acc, feature) => { var _a, _b; return (_b = (_a = feature.getInitialState) === null || _a === void 0 ? void 0 : _a.call(feature, acc, treeInstance)) !== null && _b !== void 0 ? _b : acc; }, (_b = (_a = initialConfig.initialState) !== null && _a !== void 0 ? _a : initialConfig.state) !== null && _b !== void 0 ? _b : {});
+    let config = additionalFeatures.reduce((acc, feature) => { var _a, _b; return (_b = (_a = feature.getDefaultConfig) === null || _a === void 0 ? void 0 : _a.call(feature, acc, treeInstance)) !== null && _b !== void 0 ? _b : acc; }, initialConfig);
+    const stateHandlerNames = additionalFeatures.reduce((acc, feature) => (Object.assign(Object.assign({}, acc), feature.stateHandlerNames)), {});
+    let treeElement;
+    const treeDataRef = { current: {} };
+    const itemInstancesMap = {};
+    let itemInstances = [];
+    const itemElementsMap = {};
+    const itemDataRefs = {};
+    let itemMetaMap = {};
+    const hotkeyPresets = {};
+    const rebuildItemMeta = (main) => {
+        // TODO can we find a way to only run this for the changed substructure?
+        itemInstances = [];
+        itemMetaMap = {};
+        const rootInstance = buildItemInstance([main, ...additionalFeatures], treeInstance, config.rootItemId);
+        itemInstancesMap[config.rootItemId] = rootInstance;
+        itemMetaMap[config.rootItemId] = {
+            itemId: config.rootItemId,
+            index: -1,
+            parentId: null,
+            level: -1,
+            posInSet: 0,
+            setSize: 1,
+        };
+        for (const item of treeInstance.getItemsMeta()) {
+            itemMetaMap[item.itemId] = item;
+            if (!itemInstancesMap[item.itemId]) {
+                const instance = buildItemInstance([main, ...additionalFeatures], treeInstance, item.itemId);
+                itemInstancesMap[item.itemId] = instance;
+                itemInstances.push(instance);
+            }
+            else {
+                itemInstances.push(itemInstancesMap[item.itemId]);
+            }
+        }
+        console.log("REBUILT");
+    };
+    const eachFeature = (fn) => {
+        for (const feature of additionalFeatures) {
+            fn(feature);
+        }
+    };
+    const mainFeature = {
+        key: "main",
+        createTreeInstance: (prev) => (Object.assign(Object.assign({}, prev), { getState: () => state, setState: (updater) => {
+                var _a;
+                // Not necessary, since I think the subupdate below keeps the state fresh anyways?
+                // state = typeof updater === "function" ? updater(state) : updater;
+                (_a = config.setState) === null || _a === void 0 ? void 0 : _a.call(config, state);
+            }, applySubStateUpdate: (stateName, updater) => {
+                state[stateName] =
+                    typeof updater === "function" ? updater(state[stateName]) : updater;
+                config[stateHandlerNames[stateName]](state[stateName]);
+            }, rebuildTree: () => {
+                var _a;
+                rebuildItemMeta(mainFeature);
+                (_a = config.setState) === null || _a === void 0 ? void 0 : _a.call(config, state);
+            }, getConfig: () => config, setConfig: (updater) => {
+                config = typeof updater === "function" ? updater(config) : updater;
+                if (config.state) {
+                    state = Object.assign(Object.assign({}, state), config.state);
+                }
+            }, getItemInstance: (itemId) => itemInstancesMap[itemId], getItems: () => itemInstances, registerElement: (element) => {
+                if (treeElement === element) {
+                    return;
+                }
+                if (treeElement && !element) {
+                    eachFeature((feature) => { var _a; return (_a = feature.onTreeUnmount) === null || _a === void 0 ? void 0 : _a.call(feature, treeInstance, treeElement); });
+                }
+                else if (!treeElement && element) {
+                    eachFeature((feature) => { var _a; return (_a = feature.onTreeMount) === null || _a === void 0 ? void 0 : _a.call(feature, treeInstance, element); });
+                }
+                treeElement = element;
+            }, getElement: () => treeElement, getDataRef: () => treeDataRef, getHotkeyPresets: () => hotkeyPresets })),
+        createItemInstance: (prev, instance, _, itemId) => (Object.assign(Object.assign({}, prev), { registerElement: (element) => {
+                if (itemElementsMap[itemId] === element) {
+                    return;
+                }
+                const oldElement = itemElementsMap[itemId];
+                if (oldElement && !element) {
+                    eachFeature((feature) => { var _a; return (_a = feature.onItemUnmount) === null || _a === void 0 ? void 0 : _a.call(feature, instance, oldElement, treeInstance); });
+                }
+                else if (!oldElement && element) {
+                    eachFeature((feature) => { var _a; return (_a = feature.onItemMount) === null || _a === void 0 ? void 0 : _a.call(feature, instance, element, treeInstance); });
+                }
+                itemElementsMap[itemId] = element;
+            }, getElement: () => itemElementsMap[itemId], 
+            // eslint-disable-next-line no-return-assign
+            getDataRef: () => { var _a; return ((_a = itemDataRefs[itemId]) !== null && _a !== void 0 ? _a : (itemDataRefs[itemId] = { current: {} })); }, getItemMeta: () => itemMetaMap[itemId] })),
+    };
+    const features = [mainFeature, ...additionalFeatures];
+    for (const feature of features) {
+        Object.assign(treeInstance, (_d = (_c = feature.createTreeInstance) === null || _c === void 0 ? void 0 : _c.call(feature, Object.assign({}, treeInstance), treeInstance)) !== null && _d !== void 0 ? _d : {});
+        Object.assign(hotkeyPresets, (_e = feature.hotkeys) !== null && _e !== void 0 ? _e : {});
+    }
+    rebuildItemMeta(mainFeature);
+    return treeInstance;
+};

package/lib/esm/features/async-data-loader/feature.d.ts

@@ -0,0 +1,5 @@
+import { FeatureImplementation } from "../../types/core";
+import { AsyncDataLoaderFeatureDef } from "./types";
+import { MainFeatureDef } from "../main/types";
+import { TreeFeatureDef } from "../tree/types";
+export declare const asyncDataLoaderFeature: FeatureImplementation<any, AsyncDataLoaderFeatureDef<any>, MainFeatureDef | TreeFeatureDef<any> | AsyncDataLoaderFeatureDef<any>>;

package/lib/esm/features/async-data-loader/feature.js

@@ -0,0 +1,85 @@
+import { makeStateUpdater } from "../../utils";
+export const asyncDataLoaderFeature = {
+    key: "async-data-loader",
+    getInitialState: (initialState) => (Object.assign({ loadingItems: [] }, initialState)),
+    getDefaultConfig: (defaultConfig, tree) => (Object.assign({ setLoadingItems: makeStateUpdater("loadingItems", tree) }, defaultConfig)),
+    stateHandlerNames: {
+        loadingItems: "setLoadingItems",
+    },
+    createTreeInstance: (prev, instance) => (Object.assign(Object.assign({}, prev), { retrieveItemData: (itemId) => {
+            var _a, _b, _c, _d, _e;
+            var _f, _g;
+            const config = instance.getConfig();
+            const dataRef = instance.getDataRef();
+            (_a = (_f = dataRef.current).itemData) !== null && _a !== void 0 ? _a : (_f.itemData = {});
+            (_b = (_g = dataRef.current).childrenIds) !== null && _b !== void 0 ? _b : (_g.childrenIds = {});
+            if (dataRef.current.itemData[itemId]) {
+                return dataRef.current.itemData[itemId];
+            }
+            if (!instance.getState().loadingItems.includes(itemId)) {
+                instance.applySubStateUpdate("loadingItems", (loadingItems) => [
+                    ...loadingItems,
+                    itemId,
+                ]);
+                (_c = config.asyncDataLoader) === null || _c === void 0 ? void 0 : _c.getItem(itemId).then((item) => {
+                    var _a;
+                    dataRef.current.itemData[itemId] = item;
+                    (_a = config.onLoadedItem) === null || _a === void 0 ? void 0 : _a.call(config, itemId, item);
+                    instance.applySubStateUpdate("loadingItems", (loadingItems) => loadingItems.filter((id) => id !== itemId));
+                });
+            }
+            return (_e = (_d = config.createLoadingItemData) === null || _d === void 0 ? void 0 : _d.call(config)) !== null && _e !== void 0 ? _e : null;
+        }, retrieveChildrenIds: (itemId) => {
+            var _a, _b, _c, _d, _e;
+            var _f, _g;
+            const config = instance.getConfig();
+            const dataRef = instance.getDataRef();
+            (_a = (_f = dataRef.current).itemData) !== null && _a !== void 0 ? _a : (_f.itemData = {});
+            (_b = (_g = dataRef.current).childrenIds) !== null && _b !== void 0 ? _b : (_g.childrenIds = {});
+            if (dataRef.current.childrenIds[itemId]) {
+                return dataRef.current.childrenIds[itemId];
+            }
+            if (instance.getState().loadingItems.includes(itemId)) {
+                return [];
+            }
+            instance.applySubStateUpdate("loadingItems", (loadingItems) => [
+                ...loadingItems,
+                itemId,
+            ]);
+            if ((_c = config.asyncDataLoader) === null || _c === void 0 ? void 0 : _c.getChildrenWithData) {
+                (_d = config.asyncDataLoader) === null || _d === void 0 ? void 0 : _d.getChildrenWithData(itemId).then((children) => {
+                    var _a, _b;
+                    for (const { id, data } of children) {
+                        dataRef.current.itemData[id] = data;
+                        (_a = config.onLoadedItem) === null || _a === void 0 ? void 0 : _a.call(config, id, data);
+                    }
+                    const childrenIds = children.map(({ id }) => id);
+                    dataRef.current.childrenIds[itemId] = childrenIds;
+                    (_b = config.onLoadedChildren) === null || _b === void 0 ? void 0 : _b.call(config, itemId, childrenIds);
+                    instance.applySubStateUpdate("loadingItems", (loadingItems) => loadingItems.filter((id) => id !== itemId));
+                    instance.rebuildTree();
+                });
+            }
+            else {
+                (_e = config.asyncDataLoader) === null || _e === void 0 ? void 0 : _e.getChildren(itemId).then((childrenIds) => {
+                    var _a;
+                    dataRef.current.childrenIds[itemId] = childrenIds;
+                    (_a = config.onLoadedChildren) === null || _a === void 0 ? void 0 : _a.call(config, itemId, childrenIds);
+                    instance.applySubStateUpdate("loadingItems", (loadingItems) => loadingItems.filter((id) => id !== itemId));
+                    instance.rebuildTree();
+                });
+            }
+            return [];
+        }, invalidateItemData: (itemId) => {
+            var _a;
+            const dataRef = instance.getDataRef();
+            (_a = dataRef.current.itemData) === null || _a === void 0 ? true : delete _a[itemId];
+            instance.retrieveItemData(itemId);
+        }, invalidateChildrenIds: (itemId) => {
+            var _a;
+            const dataRef = instance.getDataRef();
+            (_a = dataRef.current.childrenIds) === null || _a === void 0 ? true : delete _a[itemId];
+            instance.retrieveChildrenIds(itemId);
+        } })),
+    createItemInstance: (prev, item, tree) => (Object.assign(Object.assign({}, prev), { isLoading: () => tree.getState().loadingItems.includes(item.getItemMeta().itemId), invalidateItemData: () => tree.invalidateItemData(item.getItemMeta().itemId), invalidateChildrenIds: () => tree.invalidateChildrenIds(item.getItemMeta().itemId) })),
+};

package/lib/esm/features/async-data-loader/types.d.ts

@@ -0,0 +1,41 @@
+import { SetStateFn } from "../../types/core";
+import { SyncDataLoaderFeatureDef } from "../sync-data-loader/types";
+export type AsyncTreeDataLoader<T> = {
+    getItem: (itemId: string) => Promise<T>;
+    getChildren: (itemId: string) => Promise<string[]>;
+    getChildrenWithData?: (itemId: string) => Promise<{
+        id: string;
+        data: T;
+    }[]>;
+};
+export type AsyncDataLoaderRef<T = any> = {
+    itemData: Record<string, T>;
+    childrenIds: Record<string, string[]>;
+};
+/**
+ * @category Async Data Loader/General
+ * */
+export type AsyncDataLoaderFeatureDef<T> = {
+    state: {
+        loadingItems: string[];
+    };
+    config: {
+        rootItemId: string;
+        createLoadingItemData?: () => T;
+        setLoadingItems?: SetStateFn<string[]>;
+        onLoadedItem?: (itemId: string, item: T) => void;
+        onLoadedChildren?: (itemId: string, childrenIds: string[]) => void;
+        asyncDataLoader?: AsyncTreeDataLoader<T>;
+    };
+    treeInstance: SyncDataLoaderFeatureDef<T>["treeInstance"] & {
+        /** Invalidate fetched data for item, and triggers a refetch and subsequent rerender if the item is visible */
+        invalidateItemData: (itemId: string) => void;
+        invalidateChildrenIds: (itemId: string) => void;
+    };
+    itemInstance: SyncDataLoaderFeatureDef<T>["itemInstance"] & {
+        invalidateItemData: () => void;
+        invalidateChildrenIds: () => void;
+        isLoading: () => void;
+    };
+    hotkeys: SyncDataLoaderFeatureDef<T>["hotkeys"];
+};

package/lib/esm/features/async-data-loader/types.js

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

package/lib/esm/features/drag-and-drop/feature.d.ts

@@ -0,0 +1,3 @@
+import { FeatureDefs, FeatureImplementation } from "../../types/core";
+import { DragAndDropFeatureDef } from "./types";
+export declare const dragAndDropFeature: FeatureImplementation<any, DragAndDropFeatureDef<any>, FeatureDefs<any>>;

package/lib/esm/features/drag-and-drop/feature.js

@@ -0,0 +1,135 @@
+import { canDrop, getDragCode, getDropTarget } from "./utils";
+import { makeStateUpdater } from "../../utils";
+export const dragAndDropFeature = {
+    key: "dragAndDrop",
+    deps: ["selection"],
+    getDefaultConfig: (defaultConfig, tree) => (Object.assign({ canDrop: (_, target) => target.item.isFolder(), canDropForeignDragObject: () => false, setDndState: makeStateUpdater("dnd", tree) }, defaultConfig)),
+    stateHandlerNames: {
+        dnd: "setDndState",
+    },
+    createTreeInstance: (prev, tree) => (Object.assign(Object.assign({}, prev), { getDropTarget: () => {
+            var _a, _b;
+            return (_b = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.dragTarget) !== null && _b !== void 0 ? _b : null;
+        }, getDragLineData: () => {
+            var _a, _b, _c, _d, _e;
+            const target = tree.getDropTarget();
+            const intend = ((_a = target === null || target === void 0 ? void 0 : target.item.getItemMeta().level) !== null && _a !== void 0 ? _a : 0) + 1;
+            if (!target || target.childIndex === null)
+                return null;
+            const children = target.item.getChildren();
+            if (target.childIndex === children.length) {
+                const bb = (_c = (_b = children[target.childIndex - 1]) === null || _b === void 0 ? void 0 : _b.getElement()) === null || _c === void 0 ? void 0 : _c.getBoundingClientRect();
+                if (bb) {
+                    return {
+                        intend,
+                        top: bb.bottom,
+                        left: bb.left,
+                        right: bb.right,
+                    };
+                }
+            }
+            const bb = (_e = (_d = children[target.childIndex]) === null || _d === void 0 ? void 0 : _d.getElement()) === null || _e === void 0 ? void 0 : _e.getBoundingClientRect();
+            if (bb) {
+                return {
+                    intend,
+                    top: bb.top,
+                    left: bb.left,
+                    right: bb.right,
+                };
+            }
+            return null;
+        } })),
+    createItemInstance: (prev, item, tree) => (Object.assign(Object.assign({}, prev), { getProps: () => {
+            var _a, _b, _c;
+            return (Object.assign(Object.assign({}, prev.getProps()), { draggable: (_c = (_b = (_a = tree.getConfig()).isItemDraggable) === null || _b === void 0 ? void 0 : _b.call(_a, item)) !== null && _c !== void 0 ? _c : true, onDragStart: item.getMemoizedProp("dnd/onDragStart", () => (e) => {
+                    var _a, _b, _c;
+                    const selectedItems = tree.getSelectedItems();
+                    const items = selectedItems.includes(item) ? selectedItems : [item];
+                    const config = tree.getConfig();
+                    if (!selectedItems.includes(item)) {
+                        tree.setSelectedItems([item.getItemMeta().itemId]);
+                    }
+                    if (!((_b = (_a = config.canDrag) === null || _a === void 0 ? void 0 : _a.call(config, items)) !== null && _b !== void 0 ? _b : true)) {
+                        e.preventDefault();
+                        return;
+                    }
+                    if (config.createForeignDragObject) {
+                        const { format, data } = config.createForeignDragObject(items);
+                        (_c = e.dataTransfer) === null || _c === void 0 ? void 0 : _c.setData(format, data);
+                    }
+                    tree.applySubStateUpdate("dnd", {
+                        draggedItems: items,
+                        draggingOverItem: tree.getFocusedItem(),
+                    });
+                }), onDragOver: item.getMemoizedProp("dnd/onDragOver", () => (e) => {
+                    var _a, _b, _c;
+                    const target = getDropTarget(e, item, tree);
+                    const dataRef = tree.getDataRef();
+                    if (!((_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggedItems) &&
+                        !((_c = (_b = tree.getConfig()).canDropForeignDragObject) === null || _c === void 0 ? void 0 : _c.call(_b, e.dataTransfer, target))) {
+                        return;
+                    }
+                    if (!canDrop(e.dataTransfer, target, tree)) {
+                        return;
+                    }
+                    e.preventDefault();
+                    const nextDragCode = getDragCode(target);
+                    if (nextDragCode === dataRef.current.lastDragCode) {
+                        return;
+                    }
+                    dataRef.current.lastDragCode = nextDragCode;
+                    tree.applySubStateUpdate("dnd", (state) => (Object.assign(Object.assign({}, state), { dragTarget: target, draggingOverItem: item })));
+                }), onDragLeave: item.getMemoizedProp("dnd/onDragLeave", () => () => {
+                    const dataRef = tree.getDataRef();
+                    dataRef.current.lastDragCode = "no-drag";
+                    tree.applySubStateUpdate("dnd", (state) => (Object.assign(Object.assign({}, state), { draggingOverItem: undefined, dragTarget: undefined })));
+                }), onDragEnd: item.getMemoizedProp("dnd/onDragEnd", () => (e) => {
+                    var _a, _b, _c;
+                    const draggedItems = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggedItems;
+                    tree.applySubStateUpdate("dnd", null);
+                    if (e.dataTransfer.dropEffect === "none" || !draggedItems) {
+                        return;
+                    }
+                    (_c = (_b = tree.getConfig()).onCompleteForeignDrop) === null || _c === void 0 ? void 0 : _c.call(_b, draggedItems);
+                }), onDrop: item.getMemoizedProp("dnd/onDrop", () => (e) => {
+                    var _a, _b, _c;
+                    const dataRef = tree.getDataRef();
+                    const target = getDropTarget(e, item, tree);
+                    if (!canDrop(e.dataTransfer, target, tree)) {
+                        return;
+                    }
+                    e.preventDefault();
+                    const config = tree.getConfig();
+                    const draggedItems = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggedItems;
+                    dataRef.current.lastDragCode = undefined;
+                    tree.applySubStateUpdate("dnd", null);
+                    if (draggedItems) {
+                        (_b = config.onDrop) === null || _b === void 0 ? void 0 : _b.call(config, draggedItems, target);
+                    }
+                    else {
+                        (_c = config.onDropForeignDragObject) === null || _c === void 0 ? void 0 : _c.call(config, e.dataTransfer, target);
+                    }
+                    // TODO rebuild tree?
+                }) }));
+        }, isDropTarget: () => {
+            const target = tree.getDropTarget();
+            return target ? target.item.getId() === item.getId() : false;
+        }, isDropTargetAbove: () => {
+            const target = tree.getDropTarget();
+            if (!target ||
+                target.childIndex === null ||
+                target.item !== item.getParent())
+                return false;
+            return target.childIndex === item.getItemMeta().posInSet;
+        }, isDropTargetBelow: () => {
+            const target = tree.getDropTarget();
+            if (!target ||
+                target.childIndex === null ||
+                target.item !== item.getParent())
+                return false;
+            return target.childIndex - 1 === item.getItemMeta().posInSet;
+        }, isDraggingOver: () => {
+            var _a, _b;
+            return ((_b = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggingOverItem) === null || _b === void 0 ? void 0 : _b.getId()) === item.getId();
+        } })),
+};

package/lib/esm/features/drag-and-drop/types.d.ts

@@ -0,0 +1,69 @@
+import { ItemInstance, SetStateFn } from "../../types/core";
+export type DndDataRef = {
+    lastDragCode?: string;
+};
+export type DndState<T> = {
+    draggedItems?: ItemInstance<T>[];
+    draggingOverItem?: ItemInstance<T>;
+    dragTarget?: DropTarget<T>;
+};
+export type DragLineData = {
+    intend: number;
+    top: number;
+    left: number;
+    right: number;
+};
+export type DropTarget<T> = {
+    item: ItemInstance<T>;
+    childIndex: number;
+    insertionIndex: number;
+} | {
+    item: ItemInstance<T>;
+    childIndex: null;
+    insertionIndex: null;
+};
+export declare enum DropTargetPosition {
+    Top = "top",
+    Bottom = "bottom",
+    Item = "item"
+}
+export type DragAndDropFeatureDef<T> = {
+    state: {
+        dnd?: DndState<T> | null;
+    };
+    config: {
+        setDndState?: SetStateFn<DndState<T> | null>;
+        topLinePercentage?: number;
+        bottomLinePercentage?: number;
+        canDropInbetween?: boolean;
+        isItemDraggable?: (item: ItemInstance<T>) => boolean;
+        canDrag?: (items: ItemInstance<T>[]) => boolean;
+        canDrop?: (items: ItemInstance<T>[], target: DropTarget<T>) => boolean;
+        createForeignDragObject?: (items: ItemInstance<T>[]) => {
+            format: string;
+            data: any;
+        };
+        canDropForeignDragObject?: (dataTransfer: DataTransfer, target: DropTarget<T>) => boolean;
+        onDrop?: (items: ItemInstance<T>[], target: DropTarget<T>) => void;
+        onDropForeignDragObject?: (dataTransfer: DataTransfer, target: DropTarget<T>) => void;
+        /** Runs in the onDragEnd event, if `ev.dataTransfer.dropEffect` is not `none`, i.e. the drop
+         * was not aborted. No target is provided as parameter since the target may be a foreign drop target.
+         * This is useful to seperate out the logic to move dragged items out of their previous parents.
+         * Use `onDrop` to handle drop-related logic.
+         *
+         * This ignores the `canDrop` handler, since the drop target is unknown in this handler.
+         */
+        onCompleteForeignDrop?: (items: ItemInstance<T>[]) => void;
+    };
+    treeInstance: {
+        getDropTarget: () => DropTarget<T> | null;
+        getDragLineData: () => DragLineData | null;
+    };
+    itemInstance: {
+        isDropTarget: () => boolean;
+        isDropTargetAbove: () => boolean;
+        isDropTargetBelow: () => boolean;
+        isDraggingOver: () => boolean;
+    };
+    hotkeys: never;
+};

package/lib/esm/features/drag-and-drop/types.js

@@ -0,0 +1,6 @@
+export var DropTargetPosition;
+(function (DropTargetPosition) {
+    DropTargetPosition["Top"] = "top";
+    DropTargetPosition["Bottom"] = "bottom";
+    DropTargetPosition["Item"] = "item";
+})(DropTargetPosition || (DropTargetPosition = {}));

package/lib/esm/features/drag-and-drop/utils.d.ts

@@ -0,0 +1,6 @@
+import { ItemInstance, TreeInstance } from "../../types/core";
+import { DropTarget } from "./types";
+export declare const getDragCode: ({ item, childIndex }: DropTarget<any>) => string;
+export declare const getDropOffset: (e: any, item: ItemInstance<any>) => number;
+export declare const canDrop: (dataTransfer: DataTransfer | null, target: DropTarget<any>, tree: TreeInstance<any>) => boolean;
+export declare const getDropTarget: (e: any, item: ItemInstance<any>, tree: TreeInstance<any>, canDropInbetween?: boolean | undefined) => DropTarget<any>;

package/lib/esm/features/drag-and-drop/utils.js

@@ -0,0 +1,72 @@
+import { DropTargetPosition, } from "./types";
+export const getDragCode = ({ item, childIndex }) => `${item.getId()}__${childIndex !== null && childIndex !== void 0 ? childIndex : "none"}`;
+export const getDropOffset = (e, item) => {
+    var _a;
+    const bb = (_a = item.getElement()) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+    return bb ? (e.pageY - bb.top) / bb.height : 0.5;
+};
+export const canDrop = (dataTransfer, target, tree) => {
+    var _a, _b, _c, _d;
+    const draggedItems = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggedItems;
+    const config = tree.getConfig();
+    if (draggedItems && !((_c = (_b = config.canDrop) === null || _b === void 0 ? void 0 : _b.call(config, draggedItems, target)) !== null && _c !== void 0 ? _c : true)) {
+        return false;
+    }
+    if (!draggedItems &&
+        dataTransfer &&
+        !((_d = config.canDropForeignDragObject) === null || _d === void 0 ? void 0 : _d.call(config, dataTransfer, target))) {
+        return false;
+    }
+    return true;
+};
+const getDropTargetPosition = (offset, topLinePercentage, bottomLinePercentage) => {
+    if (offset < topLinePercentage) {
+        return DropTargetPosition.Top;
+    }
+    if (offset > bottomLinePercentage) {
+        return DropTargetPosition.Bottom;
+    }
+    return DropTargetPosition.Item;
+};
+export const getDropTarget = (e, item, tree, canDropInbetween = tree.getConfig().canDropInbetween) => {
+    var _a, _b, _c, _d;
+    const config = tree.getConfig();
+    const draggedItems = (_b = (_a = tree.getState().dnd) === null || _a === void 0 ? void 0 : _a.draggedItems) !== null && _b !== void 0 ? _b : [];
+    const itemTarget = { item, childIndex: null, insertionIndex: null };
+    const parentTarget = {
+        item: item.getParent(),
+        childIndex: null,
+        insertionIndex: null,
+    };
+    if (!canDropInbetween) {
+        if (!canDrop(e.dataTransfer, parentTarget, tree)) {
+            return getDropTarget(e, item.getParent(), tree, false);
+        }
+        return itemTarget;
+    }
+    const canDropInside = canDrop(e.dataTransfer, itemTarget, tree);
+    const offset = getDropOffset(e, item);
+    const pos = canDropInside
+        ? getDropTargetPosition(offset, (_c = config.topLinePercentage) !== null && _c !== void 0 ? _c : 0.3, (_d = config.bottomLinePercentage) !== null && _d !== void 0 ? _d : 0.7)
+        : getDropTargetPosition(offset, 0.5, 0.5);
+    if (pos === DropTargetPosition.Item) {
+        return itemTarget;
+    }
+    if (!canDrop(e.dataTransfer, parentTarget, tree)) {
+        return getDropTarget(e, item.getParent(), tree, false);
+    }
+    const childIndex = item.getIndexInParent() + (pos === DropTargetPosition.Top ? 0 : 1);
+    const numberOfDragItemsBeforeTarget = item
+        .getParent()
+        .getChildren()
+        .slice(0, childIndex)
+        .reduce((counter, child) => child && (draggedItems === null || draggedItems === void 0 ? void 0 : draggedItems.some((i) => i.getId() === child.getId()))
+        ? ++counter
+        : counter, 0);
+    return {
+        item: item.getParent(),
+        childIndex,
+        // TODO performance could be improved by computing this only when dragcode changed
+        insertionIndex: childIndex - numberOfDragItemsBeforeTarget,
+    };
+};

package/lib/esm/features/expand-all/feature.d.ts

@@ -0,0 +1,6 @@
+import { FeatureImplementation } from "../../types/core";
+import { ExpandAllFeatureDef } from "./types";
+import { MainFeatureDef } from "../main/types";
+import { TreeFeatureDef } from "../tree/types";
+import { SyncDataLoaderFeatureDef } from "../sync-data-loader/types";
+export declare const expandAllFeature: FeatureImplementation<any, ExpandAllFeatureDef, MainFeatureDef | TreeFeatureDef<any> | SyncDataLoaderFeatureDef<any> | ExpandAllFeatureDef>;

package/lib/esm/features/expand-all/feature.js

@@ -0,0 +1,38 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { poll } from "../../utils";
+export const expandAllFeature = {
+    key: "expand-all",
+    createTreeInstance: (prev, tree) => (Object.assign(Object.assign({}, prev), { expandAll: (cancelToken) => __awaiter(void 0, void 0, void 0, function* () {
+            yield Promise.all(tree.getItems().map((item) => item.expandAll(cancelToken)));
+        }), collapseAll: () => {
+            tree.applySubStateUpdate("expandedItems", []);
+            tree.rebuildTree();
+        } })),
+    createItemInstance: (prev, item, tree) => (Object.assign(Object.assign({}, prev), { expandAll: (cancelToken) => __awaiter(void 0, void 0, void 0, function* () {
+            if (cancelToken === null || cancelToken === void 0 ? void 0 : cancelToken.current) {
+                return;
+            }
+            if (!item.isFolder()) {
+                return;
+            }
+            item.expand();
+            yield poll(() => !tree.getState().loadingItems.includes(item.getId()));
+            yield Promise.all(item.getChildren().map((child) => __awaiter(void 0, void 0, void 0, function* () {
+                yield poll(() => !tree.getState().loadingItems.includes(child.getId()));
+                yield (child === null || child === void 0 ? void 0 : child.expandAll(cancelToken));
+            })));
+        }), collapseAll: () => {
+            for (const child of item.getChildren()) {
+                child === null || child === void 0 ? void 0 : child.collapseAll();
+            }
+            item.collapse();
+        } })),
+};

package/lib/esm/features/expand-all/types.d.ts

@@ -0,0 +1,17 @@
+export type ExpandAllFeatureDef = {
+    state: {};
+    config: {};
+    treeInstance: {
+        expandAll: (cancelToken?: {
+            current: boolean;
+        }) => Promise<void>;
+        collapseAll: () => void;
+    };
+    itemInstance: {
+        expandAll: (cancelToken?: {
+            current: boolean;
+        }) => Promise<void>;
+        collapseAll: () => void;
+    };
+    hotkeys: never;
+};

package/lib/esm/features/expand-all/types.js

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

package/lib/esm/features/hotkeys-core/feature.d.ts

@@ -0,0 +1,4 @@
+import { FeatureImplementation } from "../../types/core";
+import { HotkeysCoreFeatureDef } from "./types";
+import { MainFeatureDef } from "../main/types";
+export declare const hotkeysCoreFeature: FeatureImplementation<any, HotkeysCoreFeatureDef<any>, MainFeatureDef | HotkeysCoreFeatureDef<any>>;