@headless-tree/core 0.0.10 → 0.0.12

package/lib/cjs/test-utils/test-tree-do.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestTreeDo = void 0;
+const vitest_1 = require("vitest");
+const test_tree_1 = require("./test-tree");
+class TestTreeDo {
+    itemInstance(itemId) {
+        return this.tree.instance.getItemInstance(itemId);
+    }
+    itemProps(itemId) {
+        return this.itemInstance(itemId).getProps();
+    }
+    constructor(tree) {
+        this.tree = tree;
+    }
+    selectItem(id) {
+        this.itemProps(id).onClick({});
+    }
+    shiftSelectItem(id) {
+        this.itemProps(id).onClick({ shiftKey: true });
+    }
+    ctrlSelectItem(id) {
+        this.itemProps(id).onClick({ ctrlKey: true });
+    }
+    ctrlShiftSelectItem(id) {
+        this.itemProps(id).onClick({ shiftKey: true, ctrlKey: true });
+    }
+    selectMultiple(...ids) {
+        ids.forEach((id) => this.ctrlSelectItem(id));
+    }
+    hotkey(hotkey, e = {}) {
+        var _a, _b;
+        const hotkeyConfig = Object.assign(Object.assign({}, this.tree.instance.getHotkeyPresets()[hotkey]), (_a = this.tree.instance.getConfig().hotkeys) === null || _a === void 0 ? void 0 : _a[hotkey]);
+        if (hotkeyConfig.isEnabled &&
+            !((_b = hotkeyConfig.isEnabled) === null || _b === void 0 ? void 0 : _b.call(hotkeyConfig, this.tree.instance))) {
+            throw new Error(`Hotkey "${hotkey}" is disabled`);
+        }
+        if (!hotkeyConfig.handler) {
+            throw new Error(`Hotkey "${hotkey}" has no handler`);
+        }
+        hotkeyConfig.handler(Object.assign(Object.assign({}, e), { stopPropagation: () => { }, preventDefault: () => { } }), this.tree.instance);
+    }
+    startDrag(itemId, event) {
+        if (!this.itemProps(itemId).draggable) {
+            throw new Error(`Can't drag item ${itemId}, has attribute draggable=false`);
+        }
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        this.itemProps(itemId).onDragStart(e);
+        return e;
+    }
+    dragOver(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        e.preventDefault.mockClear();
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        (0, vitest_1.expect)(e.preventDefault).toBeCalledTimes(3);
+        this.consistentCalls(e.preventDefault);
+        this.consistentCalls(e.stopPropagation);
+        return e;
+    }
+    dragOverNotAllowed(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        e.preventDefault.mockClear();
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        (0, vitest_1.expect)(e.preventDefault).toBeCalledTimes(0);
+        this.consistentCalls(e.preventDefault);
+        this.consistentCalls(e.stopPropagation);
+        return e;
+    }
+    dragLeave(itemId) {
+        this.itemProps(itemId).onDragLeave({});
+    }
+    dragEnd(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        this.itemProps(itemId).onDragEnd(e);
+        return e;
+    }
+    drop(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        this.itemProps(itemId).onDrop(e);
+        return e;
+    }
+    dragOverAndDrop(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        this.dragOver(itemId, e);
+        return this.drop(itemId, e);
+    }
+    consistentCalls(fn) {
+        if (!vitest_1.vi.isMockFunction(fn)) {
+            throw new Error("fn is not a mock");
+        }
+        (0, vitest_1.expect)(fn.mock.calls.length, "function called inconsistent times").toBeOneOf([0, 3]);
+        (0, vitest_1.expect)(new Set(fn.mock.calls.map((call) => call.join("__"))).size, "function called with inconsistent parameters").toBeOneOf([0, 1]);
+    }
+}
+exports.TestTreeDo = TestTreeDo;

package/lib/cjs/test-utils/test-tree-expect.d.ts

@@ -0,0 +1,15 @@
+import { DragEvent } from "react";
+import { TestTree } from "./test-tree";
+import { DropTarget } from "../features/drag-and-drop/types";
+export declare class TestTreeExpect<T> {
+    private tree;
+    protected itemInstance(itemId: string): import("..").ItemInstance<T>;
+    protected itemProps(itemId: string): Record<string, any>;
+    constructor(tree: TestTree<T>);
+    foldersExpanded(...itemIds: string[]): void;
+    foldersCollapsed(...itemIds: string[]): void;
+    hasChildren(itemId: string, children: string[]): void;
+    dropped(draggedItems: string[], target: DropTarget<any>): void;
+    dragOverNotAllowed(itemId: string, event?: DragEvent): DragEvent<Element>;
+    defaultDragLineProps(indent?: number): void;
+}

package/lib/cjs/test-utils/test-tree-expect.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestTreeExpect = void 0;
+/* eslint-disable import/no-extraneous-dependencies */
+const vitest_1 = require("vitest");
+const test_tree_1 = require("./test-tree");
+class TestTreeExpect {
+    itemInstance(itemId) {
+        return this.tree.instance.getItemInstance(itemId);
+    }
+    itemProps(itemId) {
+        return this.itemInstance(itemId).getProps();
+    }
+    constructor(tree) {
+        this.tree = tree;
+    }
+    foldersExpanded(...itemIds) {
+        for (const itemId of itemIds) {
+            (0, vitest_1.expect)(this.tree.instance.getItemInstance(itemId).isExpanded(), `Expected ${itemId} to be expanded`).toBe(true);
+        }
+    }
+    foldersCollapsed(...itemIds) {
+        for (const itemId of itemIds) {
+            (0, vitest_1.expect)(this.tree.instance.getItemInstance(itemId).isExpanded(), `Expected ${itemId} to be collapsed`).toBe(false);
+        }
+    }
+    hasChildren(itemId, children) {
+        const item = this.tree.instance.getItemInstance(itemId);
+        const itemChildren = item.getChildren().map((child) => child.getId());
+        (0, vitest_1.expect)(itemChildren).toEqual(children);
+    }
+    dropped(draggedItems, target) {
+        (0, vitest_1.expect)(this.tree.instance.getConfig().onDrop).toBeCalledWith(draggedItems.map((id) => this.tree.item(id)), target);
+    }
+    dragOverNotAllowed(itemId, event) {
+        const e = event !== null && event !== void 0 ? event : test_tree_1.TestTree.dragEvent();
+        e.preventDefault.mockClear();
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        this.itemProps(itemId).onDragOver(e);
+        (0, vitest_1.expect)(e.preventDefault, "onDragOver shouldn't call e.preventDefault if drag is not allowed").not.toBeCalled();
+        this.itemProps(itemId).onDrop(e);
+        (0, vitest_1.expect)(e.preventDefault, "onDrop shouldn't call e.preventDefault if drag is not allowed").not.toBeCalled();
+        (0, vitest_1.expect)(this.tree.instance.getConfig().onDrop, "onDrop handler shouldn't be called if drag is not allowed").not.toBeCalled();
+        return e;
+    }
+    defaultDragLineProps(indent = 0) {
+        (0, vitest_1.expect)(this.tree.instance.getDragLineData()).toEqual({
+            indent,
+            left: indent * 20,
+            width: 100 - indent * 20,
+            top: 0,
+        });
+        (0, vitest_1.expect)(this.tree.instance.getDragLineStyle(0, 0)).toEqual({
+            left: `${indent * 20}px`,
+            pointerEvents: "none",
+            top: "0px",
+            width: `${100 - indent * 20}px`,
+        });
+    }
+}
+exports.TestTreeExpect = TestTreeExpect;

package/lib/cjs/test-utils/test-tree.d.ts

@@ -0,0 +1,47 @@
+import { DragEvent } from "react";
+import { TreeConfig, TreeInstance } from "../types/core";
+import { TestTreeDo } from "./test-tree-do";
+import { TestTreeExpect } from "./test-tree-expect";
+export declare class TestTree<T = string> {
+    private config;
+    readonly do: TestTreeDo<T>;
+    readonly expect: TestTreeExpect<T>;
+    private treeInstance;
+    private static asyncLoaderResolvers;
+    suits: {
+        sync: () => {
+            tree: TestTree<T>;
+            title: string;
+        };
+        async: () => {
+            tree: TestTree<T>;
+            title: string;
+        };
+        proxifiedSync: () => {
+            tree: TestTree<T>;
+            title: string;
+        };
+        proxifiedAsync: () => {
+            tree: TestTree<T>;
+            title: string;
+        };
+    };
+    forSuits(runSuite: (tree: TestTree<T>) => void): void;
+    get instance(): TreeInstance<T>;
+    private constructor();
+    static resolveAsyncLoaders(): Promise<void>;
+    resolveAsyncVisibleItems(): Promise<void>;
+    static default(config: Partial<TreeConfig<string>>): TestTree<string>;
+    with(config: Partial<TreeConfig<T>>): TestTree<T>;
+    resetBeforeEach(): void;
+    createTestCaseTree(): Promise<this>;
+    withFeatures(...features: any): TestTree<T>;
+    mockedHandler(handlerName: keyof TreeConfig<T>): import("vitest").Mock<(...args: any[]) => any>;
+    item(itemId: string): import("../types/core").ItemInstance<T>;
+    reset(): void;
+    debug(): void;
+    setElementBoundingBox(itemId: string, bb?: Partial<DOMRect>): void;
+    static dragEvent(pageX?: number, pageY?: number): DragEvent;
+    createTopDragEvent(indent?: number): DragEvent<Element>;
+    createBottomDragEvent(indent?: number): DragEvent<Element>;
+}

package/lib/cjs/test-utils/test-tree.js

@@ -0,0 +1,203 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestTree = void 0;
+/* eslint-disable import/no-extraneous-dependencies */
+const vitest_1 = require("vitest");
+const create_tree_1 = require("../core/create-tree");
+const test_tree_do_1 = require("./test-tree-do");
+const test_tree_expect_1 = require("./test-tree-expect");
+const feature_1 = require("../features/sync-data-loader/feature");
+const feature_2 = require("../features/async-data-loader/feature");
+const build_proxified_instance_1 = require("../core/build-proxified-instance");
+vitest_1.vi.useFakeTimers({ shouldAdvanceTime: true });
+class TestTree {
+    forSuits(runSuite) {
+        vitest_1.describe.for([
+            this.suits.sync(),
+            this.suits.async(),
+            this.suits.proxifiedSync(),
+            this.suits.proxifiedAsync(),
+        ])("$title", ({ tree }) => {
+            tree.resetBeforeEach();
+            runSuite(tree);
+        });
+    }
+    get instance() {
+        if (!this.treeInstance) {
+            this.treeInstance = (0, create_tree_1.createTree)(this.config);
+        }
+        return this.treeInstance;
+    }
+    constructor(config) {
+        this.config = config;
+        this.do = new test_tree_do_1.TestTreeDo(this);
+        this.expect = new test_tree_expect_1.TestTreeExpect(this);
+        this.treeInstance = null;
+        this.suits = {
+            sync: () => ({
+                tree: this.withFeatures(feature_1.syncDataLoaderFeature),
+                title: "Synchronous Data Loader",
+            }),
+            async: () => ({
+                tree: this.withFeatures(feature_2.asyncDataLoaderFeature),
+                title: "Asynchronous Data Loader",
+            }),
+            proxifiedSync: () => ({
+                tree: this.withFeatures(feature_1.syncDataLoaderFeature).with({
+                    instanceBuilder: build_proxified_instance_1.buildProxiedInstance,
+                }),
+                title: "Proxified Synchronous Data Loader",
+            }),
+            proxifiedAsync: () => ({
+                tree: this.withFeatures(feature_2.asyncDataLoaderFeature).with({
+                    instanceBuilder: build_proxified_instance_1.buildProxiedInstance,
+                }),
+                title: "Proxified Asynchronous Data Loader",
+            }),
+        };
+    }
+    static resolveAsyncLoaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            while (TestTree.asyncLoaderResolvers.length) {
+                (_a = TestTree.asyncLoaderResolvers.shift()) === null || _a === void 0 ? void 0 : _a();
+                yield new Promise((r) => {
+                    setTimeout(r);
+                });
+            }
+        });
+    }
+    resolveAsyncVisibleItems() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.instance.getItems();
+            yield TestTree.resolveAsyncLoaders();
+            this.instance.getItems().forEach((i) => i.getItemName());
+            yield TestTree.resolveAsyncLoaders();
+        });
+    }
+    static default(config) {
+        return new TestTree(Object.assign({ rootItemId: "x", createLoadingItemData: () => "loading", dataLoader: {
+                getItem: (id) => id,
+                getChildren: (id) => [`${id}1`, `${id}2`, `${id}3`, `${id}4`],
+            }, asyncDataLoader: {
+                getItem: (id) => __awaiter(this, void 0, void 0, function* () {
+                    yield new Promise((r) => {
+                        r.debugName = `Loading getItem ${id}`;
+                        TestTree.asyncLoaderResolvers.push(r);
+                    });
+                    return id;
+                }),
+                getChildren: (id) => __awaiter(this, void 0, void 0, function* () {
+                    yield new Promise((r) => {
+                        r.debugName = `Loading getChildren ${id}`;
+                        TestTree.asyncLoaderResolvers.push(r);
+                    });
+                    return [`${id}1`, `${id}2`, `${id}3`, `${id}4`];
+                }),
+            }, getItemName: (item) => item.getItemData(), indent: 20, isItemFolder: (item) => item.getItemMeta().level < 2, initialState: {
+                expandedItems: ["x1", "x11"],
+            }, features: [] }, config));
+    }
+    with(config) {
+        return new TestTree(Object.assign(Object.assign({}, this.config), config));
+    }
+    resetBeforeEach() {
+        (0, vitest_1.beforeEach)(() => __awaiter(this, void 0, void 0, function* () {
+            yield this.createTestCaseTree();
+        }));
+    }
+    createTestCaseTree() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.reset();
+            vitest_1.vi.clearAllMocks();
+            // trigger instance creation
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            this.instance;
+            yield this.resolveAsyncVisibleItems();
+            return this;
+        });
+    }
+    withFeatures(...features) {
+        var _a;
+        return this.with({
+            features: [...((_a = this.config.features) !== null && _a !== void 0 ? _a : []), ...features],
+        });
+    }
+    mockedHandler(handlerName) {
+        var _a;
+        const mock = vitest_1.vi.fn();
+        if (this.treeInstance) {
+            (_a = this.treeInstance) === null || _a === void 0 ? void 0 : _a.setConfig((prev) => (Object.assign(Object.assign({}, prev), { [handlerName]: mock })));
+        }
+        else {
+            this.config[handlerName] = mock;
+        }
+        return mock;
+    }
+    item(itemId) {
+        return this.instance.getItemInstance(itemId);
+    }
+    reset() {
+        this.treeInstance = null;
+        TestTree.asyncLoaderResolvers = [];
+    }
+    debug() {
+        console.log(this.instance
+            .getItems()
+            .map((item) => [
+            "  ".repeat(item.getItemMeta().level),
+            '"',
+            item.getItemName(),
+            '"',
+        ].join(""))
+            .join("\n"));
+    }
+    setElementBoundingBox(itemId, bb = {
+        left: 0,
+        width: 100,
+        top: 0,
+        height: 20,
+    }) {
+        this.instance.registerElement({
+            getBoundingClientRect: () => ({
+                left: 0,
+                width: 100,
+                top: 0,
+                height: 10000,
+            }),
+        });
+        this.instance.getItemInstance(itemId).registerElement({
+            getBoundingClientRect: () => bb,
+        });
+    }
+    static dragEvent(pageX = 1000, pageY = 0) {
+        return {
+            preventDefault: vitest_1.vi.fn(),
+            stopPropagation: vitest_1.vi.fn(),
+            dataTransfer: {
+                setData: vitest_1.vi.fn(),
+                getData: vitest_1.vi.fn(),
+                dropEffect: "unchaged-from-test",
+            },
+            pageX,
+            pageY,
+        };
+    }
+    createTopDragEvent(indent = 0) {
+        return TestTree.dragEvent(indent * 20, 1);
+    }
+    createBottomDragEvent(indent = 0) {
+        return TestTree.dragEvent(indent * 20, 19);
+    }
+}
+exports.TestTree = TestTree;
+TestTree.asyncLoaderResolvers = [];

package/lib/cjs/types/core.d.ts

@@ -8,13 +8,14 @@ import { AsyncDataLoaderFeatureDef } from "../features/async-data-loader/types";
 import { SearchFeatureDef } from "../features/search/types";
 import { RenamingFeatureDef } from "../features/renaming/types";
 import { ExpandAllFeatureDef } from "../features/expand-all/types";
+import { PropMemoizationFeatureDef } from "../features/prop-memoization/types";
 export type Updater<T> = T | ((old: T) => T);
 export type SetStateFn<T> = (updaterOrValue: Updater<T>) => void;
 export type FeatureDef = {
-    state: object;
-    config: object;
-    treeInstance: object;
-    itemInstance: object;
+    state: any;
+    config: any;
+    treeInstance: any;
+    itemInstance: any;
     hotkeys: string;
 };
 export type EmptyFeatureDef = {
@@ -25,8 +26,6 @@ export type EmptyFeatureDef = {
     hotkeys: never;
 };
 type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends (x: infer R) => any ? R : never;
-export type DefaultFeatures<T> = MainFeatureDef | TreeFeatureDef<T>;
-export type FeatureDefs<T> = MainFeatureDef | TreeFeatureDef<T> | SelectionFeatureDef<T> | DragAndDropFeatureDef<T> | HotkeysCoreFeatureDef<T> | SyncDataLoaderFeatureDef<T> | AsyncDataLoaderFeatureDef<T> | SearchFeatureDef<T> | RenamingFeatureDef<T> | ExpandAllFeatureDef;
 type MergedFeatures<F extends FeatureDef> = {
     state: UnionToIntersection<F["state"]>;
     config: UnionToIntersection<F["config"]>;
@@ -34,34 +33,50 @@ type MergedFeatures<F extends FeatureDef> = {
     itemInstance: UnionToIntersection<F["itemInstance"]>;
     hotkeys: F["hotkeys"];
 };
-type TreeStateType<T> = MainFeatureDef["state"] & TreeFeatureDef<T>["state"] & SelectionFeatureDef<T>["state"] & DragAndDropFeatureDef<T>["state"] & HotkeysCoreFeatureDef<T>["state"] & SyncDataLoaderFeatureDef<T>["state"] & AsyncDataLoaderFeatureDef<T>["state"] & SearchFeatureDef<T>["state"] & RenamingFeatureDef<T>["state"] & ExpandAllFeatureDef["state"];
+export type RegisteredFeatures<T> = MainFeatureDef<T> | TreeFeatureDef<T> | SelectionFeatureDef<T> | DragAndDropFeatureDef<T> | HotkeysCoreFeatureDef<T> | SyncDataLoaderFeatureDef<T> | AsyncDataLoaderFeatureDef<T> | SearchFeatureDef<T> | RenamingFeatureDef<T> | ExpandAllFeatureDef | PropMemoizationFeatureDef;
+type TreeStateType<T> = MergedFeatures<RegisteredFeatures<T>>["state"];
 export interface TreeState<T> extends TreeStateType<T> {
 }
-type TreeConfigType<T> = MainFeatureDef["config"] & TreeFeatureDef<T>["config"] & SelectionFeatureDef<T>["config"] & DragAndDropFeatureDef<T>["config"] & HotkeysCoreFeatureDef<T>["config"] & SyncDataLoaderFeatureDef<T>["config"] & AsyncDataLoaderFeatureDef<T>["config"] & SearchFeatureDef<T>["config"] & RenamingFeatureDef<T>["config"] & ExpandAllFeatureDef["config"];
+type TreeConfigType<T> = MergedFeatures<RegisteredFeatures<T>>["config"];
 export interface TreeConfig<T> extends TreeConfigType<T> {
 }
-type TreeInstanceType<T> = MainFeatureDef["treeInstance"] & TreeFeatureDef<T>["treeInstance"] & SelectionFeatureDef<T>["treeInstance"] & DragAndDropFeatureDef<T>["treeInstance"] & HotkeysCoreFeatureDef<T>["treeInstance"] & SyncDataLoaderFeatureDef<T>["treeInstance"] & AsyncDataLoaderFeatureDef<T>["treeInstance"] & SearchFeatureDef<T>["treeInstance"] & RenamingFeatureDef<T>["treeInstance"] & ExpandAllFeatureDef["treeInstance"];
+type TreeInstanceType<T> = MergedFeatures<RegisteredFeatures<T>>["treeInstance"];
 export interface TreeInstance<T> extends TreeInstanceType<T> {
 }
-type ItemInstanceType<T> = MainFeatureDef["itemInstance"] & TreeFeatureDef<T>["itemInstance"] & SelectionFeatureDef<T>["itemInstance"] & DragAndDropFeatureDef<T>["itemInstance"] & HotkeysCoreFeatureDef<T>["itemInstance"] & SyncDataLoaderFeatureDef<T>["itemInstance"] & AsyncDataLoaderFeatureDef<T>["itemInstance"] & SearchFeatureDef<T>["itemInstance"] & RenamingFeatureDef<T>["itemInstance"] & ExpandAllFeatureDef["itemInstance"];
+type ItemInstanceType<T> = MergedFeatures<RegisteredFeatures<T>>["itemInstance"];
 export interface ItemInstance<T> extends ItemInstanceType<T> {
 }
-export type HotkeyName<F extends FeatureDef = FeatureDefs<any>> = MergedFeatures<F>["hotkeys"];
-export type HotkeysConfig<T, F extends FeatureDef = FeatureDefs<T>> = Record<HotkeyName<F>, HotkeyConfig<T>>;
-export type CustomHotkeysConfig<T, F extends FeatureDef = FeatureDefs<T>> = Partial<Record<HotkeyName<F> | `custom${string}`, Partial<HotkeyConfig<T>>>>;
-export type FeatureImplementation<T = any, D extends FeatureDef = any, F extends FeatureDef = EmptyFeatureDef> = {
+export type HotkeyName = MergedFeatures<RegisteredFeatures<any>>["hotkeys"];
+export type HotkeysConfig<T> = Record<HotkeyName, HotkeyConfig<T>>;
+export type CustomHotkeysConfig<T> = Partial<Record<HotkeyName | `custom${string}`, Partial<HotkeyConfig<T>>>>;
+type MayReturnNull<T extends (...x: any[]) => any> = (...args: Parameters<T>) => ReturnType<T> | null;
+export type ItemInstanceOpts<Key extends keyof ItemInstance<any>> = {
+    item: ItemInstance<any>;
+    tree: TreeInstance<any>;
+    itemId: string;
+    prev?: MayReturnNull<ItemInstance<any>[Key]>;
+};
+export type TreeInstanceOpts<Key extends keyof TreeInstance<any>> = {
+    tree: TreeInstance<any>;
+    prev?: MayReturnNull<TreeInstance<any>[Key]>;
+};
+export type FeatureImplementation<T = any> = {
     key?: string;
     deps?: string[];
     overwrites?: string[];
-    stateHandlerNames?: Partial<Record<keyof MergedFeatures<F>["state"], keyof MergedFeatures<F>["config"]>>;
-    getInitialState?: (initialState: Partial<MergedFeatures<F>["state"]>, tree: MergedFeatures<F>["treeInstance"]) => Partial<D["state"] & MergedFeatures<F>["state"]>;
-    getDefaultConfig?: (defaultConfig: Partial<MergedFeatures<F>["config"]>, tree: MergedFeatures<F>["treeInstance"]) => Partial<D["config"] & MergedFeatures<F>["config"]>;
-    createTreeInstance?: (prev: MergedFeatures<F>["treeInstance"], instance: MergedFeatures<F>["treeInstance"]) => D["treeInstance"] & MergedFeatures<F>["treeInstance"];
-    createItemInstance?: (prev: MergedFeatures<F>["itemInstance"], item: MergedFeatures<F>["itemInstance"], tree: MergedFeatures<F>["treeInstance"], itemId: string) => D["itemInstance"] & MergedFeatures<F>["itemInstance"];
-    onTreeMount?: (instance: MergedFeatures<F>["treeInstance"], treeElement: HTMLElement) => void;
-    onTreeUnmount?: (instance: MergedFeatures<F>["treeInstance"], treeElement: HTMLElement) => void;
-    onItemMount?: (instance: MergedFeatures<F>["itemInstance"], itemElement: HTMLElement, tree: MergedFeatures<F>["treeInstance"]) => void;
-    onItemUnmount?: (instance: MergedFeatures<F>["itemInstance"], itemElement: HTMLElement, tree: MergedFeatures<F>["treeInstance"]) => void;
-    hotkeys?: HotkeysConfig<T, D>;
+    stateHandlerNames?: Partial<Record<keyof TreeState<T>, keyof TreeConfig<T>>>;
+    getInitialState?: (initialState: Partial<TreeState<T>>, tree: TreeInstance<T>) => Partial<TreeState<T>>;
+    getDefaultConfig?: (defaultConfig: Partial<TreeConfig<T>>, tree: TreeInstance<T>) => Partial<TreeConfig<T>>;
+    treeInstance?: {
+        [key in keyof TreeInstance<T>]?: (opts: TreeInstanceOpts<key>, ...args: Parameters<TreeInstance<T>[key]>) => void;
+    };
+    itemInstance?: {
+        [key in keyof ItemInstance<T>]?: (opts: ItemInstanceOpts<key>, ...args: Parameters<ItemInstance<T>[key]>) => void;
+    };
+    onTreeMount?: (instance: TreeInstance<T>, treeElement: HTMLElement) => void;
+    onTreeUnmount?: (instance: TreeInstance<T>, treeElement: HTMLElement) => void;
+    onItemMount?: (instance: ItemInstance<T>, itemElement: HTMLElement, tree: TreeInstance<T>) => void;
+    onItemUnmount?: (instance: ItemInstance<T>, itemElement: HTMLElement, tree: TreeInstance<T>) => void;
+    hotkeys?: Partial<HotkeysConfig<T>>;
 };
 export {};

package/lib/cjs/utilities/errors.d.ts

@@ -0,0 +1 @@
+export declare const throwError: (message: string) => Error;

package/lib/cjs/utilities/errors.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwError = void 0;
+const throwError = (message) => Error(`Headless Tree: ${message}`);
+exports.throwError = throwError;

package/lib/cjs/utilities/insert-items-at-target.js

@@ -4,11 +4,15 @@ exports.insertItemsAtTarget = void 0;
 const insertItemsAtTarget = (itemIds, target, onChangeChildren) => {
     // add moved items to new common parent, if dropped onto parent
     if (target.childIndex === null) {
-        onChangeChildren(target.item, [
+        const newChildren = [
             ...target.item.getChildren().map((item) => item.getId()),
             ...itemIds,
-        ]);
-        // TODO items[0].getTree().rebuildTree();
+        ];
+        onChangeChildren(target.item, newChildren);
+        if (target.item && "updateCachedChildrenIds" in target.item) {
+            target.item.updateCachedChildrenIds(newChildren);
+        }
+        target.item.getTree().rebuildTree();
         return;
     }
     // add moved items to new common parent, if dropped between siblings
@@ -19,6 +23,9 @@ const insertItemsAtTarget = (itemIds, target, onChangeChildren) => {
         ...oldChildren.slice(target.insertionIndex).map((item) => item.getId()),
     ];
     onChangeChildren(target.item, newChildren);
+    if (target.item && "updateCachedChildrenIds" in target.item) {
+        target.item.updateCachedChildrenIds(newChildren);
+    }
     target.item.getTree().rebuildTree();
 };
 exports.insertItemsAtTarget = insertItemsAtTarget;

package/lib/cjs/utilities/remove-items-from-parents.js

@@ -2,14 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeItemsFromParents = void 0;
 const removeItemsFromParents = (movedItems, onChangeChildren) => {
-    var _a;
-    // TODO bulk sibling changes together
-    for (const item of movedItems) {
-        const siblings = (_a = item.getParent()) === null || _a === void 0 ? void 0 : _a.getChildren();
-        if (siblings) {
-            onChangeChildren(item.getParent(), siblings
-                .filter((sibling) => sibling.getId() !== item.getId())
-                .map((i) => i.getId()));
+    const movedItemsIds = movedItems.map((item) => item.getId());
+    const uniqueParents = [
+        ...new Set(movedItems.map((item) => item.getParent())),
+    ];
+    for (const parent of uniqueParents) {
+        const siblings = parent === null || parent === void 0 ? void 0 : parent.getChildren();
+        if (siblings && parent) {
+            const newChildren = siblings
+                .filter((sibling) => !movedItemsIds.includes(sibling.getId()))
+                .map((i) => i.getId());
+            onChangeChildren(parent, newChildren);
+            if (parent && "updateCachedChildrenIds" in parent) {
+                parent === null || parent === void 0 ? void 0 : parent.updateCachedChildrenIds(newChildren);
+            }
         }
     }
     movedItems[0].getTree().rebuildTree();

package/lib/cjs/utils.d.ts

@@ -1,6 +1,6 @@
-import { TreeState, Updater } from "./types/core";
+import { SetStateFn, TreeState, Updater } from "./types/core";
 export type NoInfer<T> = [T][T extends any ? 0 : never];
-export declare const memo: <D extends readonly any[], R>(fn: (...args_0: D) => R, deps: () => [...D]) => () => R;
+export declare const memo: <D extends readonly any[], P extends readonly any[], R>(deps: (...args: [...P]) => [...D], fn: (...args: [...D]) => R) => (...a: P) => R;
 export declare function functionalUpdate<T>(updater: Updater<T>, input: T): T;
-export declare function makeStateUpdater<K extends keyof TreeState<any>>(key: K, instance: unknown): (updater: Updater<TreeState<any>[K]>) => void;
+export declare function makeStateUpdater<K extends keyof TreeState<any>>(key: K, instance: unknown): SetStateFn<TreeState<any>[K]>;
 export declare const poll: (fn: () => boolean, interval?: number, timeout?: number) => Promise<void>;

package/lib/cjs/utils.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.poll = exports.makeStateUpdater = exports.functionalUpdate = exports.memo = void 0;
-const memo = (fn, deps) => {
+exports.poll = exports.memo = void 0;
+exports.functionalUpdate = functionalUpdate;
+exports.makeStateUpdater = makeStateUpdater;
+const memo = (deps, fn) => {
     let value;
     let oldDeps = null;
-    return () => {
-        const newDeps = deps();
+    return (...a) => {
+        const newDeps = deps(...a);
         if (!value) {
             value = fn(...newDeps);
             oldDeps = newDeps;
@@ -28,7 +30,6 @@ function functionalUpdate(updater, input) {
         ? updater(input)
         : updater;
 }
-exports.functionalUpdate = functionalUpdate;
 function makeStateUpdater(key, instance) {
     return (updater) => {
         instance.setState((old) => {
@@ -36,7 +37,6 @@ function makeStateUpdater(key, instance) {
         });
     };
 }
-exports.makeStateUpdater = makeStateUpdater;
 const poll = (fn, interval = 100, timeout = 1000) => new Promise((resolve) => {
     let clear;
     const i = setInterval(() => {

package/lib/esm/core/build-proxified-instance.d.ts

@@ -0,0 +1,2 @@
+import { InstanceBuilder } from "../features/main/types";
+export declare const buildProxiedInstance: InstanceBuilder;