@headless-tree/core 0.0.0-20250912163308 → 0.0.0-20250916205935

package/CHANGELOG.md

@@ -1,10 +1,12 @@
 # @headless-tree/core
 
-## 0.0.0-20250912163308
+## 0.0.0-20250916205935
 
 ### Patch Changes
 
 - 72e714b: all NPM deployments will now publish with provenance
+- 6693986: fixed an issue where async data loaders cause calling `item.getItemData()` outside of the component calling `useTree()` to cause a React warning log (#158)
+- 7a7424f: fixed incorrect exports definition in package.json for require/cjs imports (#161)
 - 215ab4b: add a new symbol that can be used in hotkey configurations "metaorcontrol" that will trigger if either any windows control key or mac meta key is pressed (#141)
 - 51b0dea: Added `isUnorderedDragTarget` as alternative to `isDragTarget` for easier detection of drag type
 - cf845d7: Added new state variable `loadingCheckPropagationItems` to indicate if, in async trees with checkboxes and state propagation enabled, data loading operations are currently loading due to a checkbox propagation taking place

package/dist/index.d.mts

@@ -182,6 +182,8 @@ type MainFeatureDef<T = any> = {
         };
         getHotkeyPresets: () => HotkeysConfig<T>;
         rebuildTree: () => void;
+        /** @deprecated Experimental feature, might get removed or changed in the future. */
+        scheduleRebuildTree: () => void;
     };
     itemInstance: {
         registerElement: (element: HTMLElement | null) => void;

package/dist/index.d.ts

@@ -182,6 +182,8 @@ type MainFeatureDef<T = any> = {
         };
         getHotkeyPresets: () => HotkeysConfig<T>;
         rebuildTree: () => void;
+        /** @deprecated Experimental feature, might get removed or changed in the future. */
+        scheduleRebuildTree: () => void;
     };
     itemInstance: {
         registerElement: (element: HTMLElement | null) => void;

package/dist/index.js

@@ -485,6 +485,7 @@ var createTree = (initialConfig) => {
   );
   let treeElement;
   const treeDataRef = { current: {} };
+  let rebuildScheduled = false;
   const itemInstancesMap = {};
   let itemInstances = [];
   const itemElementsMap = {};
@@ -528,6 +529,7 @@ var createTree = (initialConfig) => {
         itemInstances.push(itemInstancesMap[item.itemId]);
       }
     }
+    rebuildScheduled = false;
   };
   const eachFeature = (fn) => {
     for (const feature of additionalFeatures) {
@@ -553,6 +555,9 @@ var createTree = (initialConfig) => {
         rebuildItemMeta();
         (_a2 = config.setState) == null ? void 0 : _a2.call(config, state);
       },
+      scheduleRebuildTree: () => {
+        rebuildScheduled = true;
+      },
       getConfig: () => config,
       setConfig: (_, updater) => {
         var _a2, _b2, _c2;
@@ -584,7 +589,10 @@ var createTree = (initialConfig) => {
         }
         return existingInstance;
       },
-      getItems: () => itemInstances,
+      getItems: () => {
+        if (rebuildScheduled) rebuildItemMeta();
+        return itemInstances;
+      },
       registerElement: ({}, element) => {
         if (treeElement === element) {
           return;
@@ -1161,7 +1169,7 @@ var asyncDataLoaderFeature = {
         return dataRef.current.itemData[itemId];
       }
       if (!tree.getState().loadingItemData.includes(itemId) && !skipFetch) {
-        loadItemData(tree, itemId);
+        setTimeout(() => loadItemData(tree, itemId));
       }
       return (_b = (_a = config.createLoadingItemData) == null ? void 0 : _a.call(config)) != null ? _b : null;
     },
@@ -1173,7 +1181,7 @@ var asyncDataLoaderFeature = {
       if (tree.getState().loadingItemChildrens.includes(itemId) || skipFetch) {
         return [];
       }
-      loadChildrenIds(tree, itemId);
+      setTimeout(() => loadChildrenIds(tree, itemId));
       return [];
     }
   },

package/dist/index.mjs

@@ -441,6 +441,7 @@ var createTree = (initialConfig) => {
   );
   let treeElement;
   const treeDataRef = { current: {} };
+  let rebuildScheduled = false;
   const itemInstancesMap = {};
   let itemInstances = [];
   const itemElementsMap = {};
@@ -484,6 +485,7 @@ var createTree = (initialConfig) => {
         itemInstances.push(itemInstancesMap[item.itemId]);
       }
     }
+    rebuildScheduled = false;
   };
   const eachFeature = (fn) => {
     for (const feature of additionalFeatures) {
@@ -509,6 +511,9 @@ var createTree = (initialConfig) => {
         rebuildItemMeta();
         (_a2 = config.setState) == null ? void 0 : _a2.call(config, state);
       },
+      scheduleRebuildTree: () => {
+        rebuildScheduled = true;
+      },
       getConfig: () => config,
       setConfig: (_, updater) => {
         var _a2, _b2, _c2;
@@ -540,7 +545,10 @@ var createTree = (initialConfig) => {
         }
         return existingInstance;
       },
-      getItems: () => itemInstances,
+      getItems: () => {
+        if (rebuildScheduled) rebuildItemMeta();
+        return itemInstances;
+      },
       registerElement: ({}, element) => {
         if (treeElement === element) {
           return;
@@ -1117,7 +1125,7 @@ var asyncDataLoaderFeature = {
         return dataRef.current.itemData[itemId];
       }
       if (!tree.getState().loadingItemData.includes(itemId) && !skipFetch) {
-        loadItemData(tree, itemId);
+        setTimeout(() => loadItemData(tree, itemId));
       }
       return (_b = (_a = config.createLoadingItemData) == null ? void 0 : _a.call(config)) != null ? _b : null;
     },
@@ -1129,7 +1137,7 @@ var asyncDataLoaderFeature = {
       if (tree.getState().loadingItemChildrens.includes(itemId) || skipFetch) {
         return [];
       }
-      loadChildrenIds(tree, itemId);
+      setTimeout(() => loadChildrenIds(tree, itemId));
       return [];
     }
   },

package/package.json

@@ -13,7 +13,7 @@
     "checkbox",
     "hook"
   ],
-  "version": "0.0.0-20250912163308",
+  "version": "0.0.0-20250916205935",
   "main": "dist/index.d.ts",
   "module": "dist/index.mjs",
   "types": "dist/index.d.mts",
@@ -24,8 +24,8 @@
         "default": "./dist/index.mjs"
       },
       "require": {
-        "types": "./dist/index.js",
-        "default": "./dist/index.d.ts"
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
       }
     },
     "./package.json": "./package.json"

package/src/core/create-tree.ts

@@ -92,6 +92,7 @@ export const createTree = <T>(
   let treeElement: HTMLElement | undefined | null;
   const treeDataRef: { current: any } = { current: {} };
 
+  let rebuildScheduled = false;
   const itemInstancesMap: Record<string, ItemInstance<T>> = {};
   let itemInstances: ItemInstance<T>[] = [];
   const itemElementsMap: Record<string, HTMLElement | undefined | null> = {};
@@ -140,6 +141,8 @@ export const createTree = <T>(
         itemInstances.push(itemInstancesMap[item.itemId]);
       }
     }
+
+    rebuildScheduled = false;
   };
 
   const eachFeature = (fn: (feature: FeatureImplementation<any>) => void) => {
@@ -175,6 +178,9 @@ export const createTree = <T>(
         rebuildItemMeta();
         config.setState?.(state);
       },
+      scheduleRebuildTree: () => {
+        rebuildScheduled = true;
+      },
       getConfig: () => config,
       setConfig: (_, updater) => {
         const newConfig =
@@ -210,7 +216,10 @@ export const createTree = <T>(
         }
         return existingInstance;
       },
-      getItems: () => itemInstances,
+      getItems: () => {
+        if (rebuildScheduled) rebuildItemMeta();
+        return itemInstances;
+      },
       registerElement: ({}, element) => {
         if (treeElement === element) {
           return;

package/src/features/async-data-loader/async-data-loader.spec.ts

@@ -46,6 +46,7 @@ describe("core-feature/selections", () => {
       );
       const setLoadingItemData = tree.mockedHandler("setLoadingItemData");
       tree.do.selectItem("x12");
+      await tree.do.awaitNextTick();
       expect(setLoadingItemChildrens).toHaveBeenCalledWith(["x12"]);
       expect(setLoadingItemData).not.toHaveBeenCalled();
       await tree.resolveAsyncVisibleItems();

package/src/features/async-data-loader/feature.ts

@@ -118,7 +118,7 @@ export const asyncDataLoaderFeature: FeatureImplementation = {
       }
 
       if (!tree.getState().loadingItemData.includes(itemId) && !skipFetch) {
-        loadItemData(tree, itemId);
+        setTimeout(() => loadItemData(tree, itemId));
       }
 
       return config.createLoadingItemData?.() ?? null;
@@ -134,7 +134,7 @@ export const asyncDataLoaderFeature: FeatureImplementation = {
         return [];
       }
 
-      loadChildrenIds(tree, itemId);
+      setTimeout(() => loadChildrenIds(tree, itemId));
 
       return [];
     },

package/src/features/main/types.ts

@@ -49,6 +49,8 @@ export type MainFeatureDef<T = any> = {
     /* @internal */
     getHotkeyPresets: () => HotkeysConfig<T>;
     rebuildTree: () => void;
+    /** @deprecated Experimental feature, might get removed or changed in the future. */
+    scheduleRebuildTree: () => void;
   };
   itemInstance: {
     registerElement: (element: HTMLElement | null) => void;

package/src/test-utils/test-tree-do.ts

@@ -135,4 +135,10 @@ export class TestTreeDo<T> {
       "function called with inconsistent parameters",
     ).toBeOneOf([0, 1]);
   }
+
+  async awaitNextTick() {
+    await new Promise((r) => {
+      setTimeout(r);
+    });
+  }
 }

package/src/test-utils/test-tree.ts

@@ -87,10 +87,9 @@ export class TestTree<T = string> {
 
   static async resolveAsyncLoaders() {
     do {
+      await vi.advanceTimersToNextTimerAsync();
       TestTree.asyncLoaderResolvers.shift()?.();
-      await new Promise<void>((r) => {
-        setTimeout(r);
-      });
+      await vi.advanceTimersToNextTimerAsync();
     } while (TestTree.asyncLoaderResolvers.length);
   }