@headless-tree/core 0.0.0-20250514161759 → 0.0.0-20250611124731

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 # @headless-tree/core
 
-## 0.0.0-20250514161759
+## 0.0.0-20250611124731
+
+### Minor Changes
+
+- e2faf37: Fixed an issue async data loaders that resolve data before the tree is mounted can cause the tree to not render at all
+
+  Note: When using the `createTree()` API directly instead of going through the React `useTree` API, an additional call
+  to `tree.rebuildItems()` afterwards will be necessary. This change is marked as minor release regardless, since `createTree` is
+  currently not a publically documented feature.
+
+### Patch Changes
+
+- 727c982: export makeStateUpdater from core package
+- 2887b0c: Added a `item.getKey()` utility method to use for generating React keys. For now, this just returns the item id, so no migration is needed from using `item.getId()` as React keys.
+
+## 1.1.0
 
 ### Minor Changes
 

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

@@ -165,7 +165,6 @@ const createTree = (initialConfig) => {
         Object.assign(hotkeyPresets, (_d = feature.hotkeys) !== null && _d !== void 0 ? _d : {});
     }
     finalizeTree();
-    rebuildItemMeta();
     return treeInstance;
 };
 exports.createTree = createTree;

package/lib/cjs/features/tree/feature.js

@@ -100,6 +100,7 @@ exports.treeFeature = {
             (_d = item.getElement()) === null || _d === void 0 ? void 0 : _d.scrollIntoView(scrollIntoViewArg);
         }),
         getId: ({ itemId }) => itemId,
+        getKey: ({ itemId }) => itemId, // TODO apply to all stories to use
         getProps: ({ item, prev }) => {
             const itemMeta = item.getItemMeta();
             return Object.assign(Object.assign({}, prev === null || prev === void 0 ? void 0 : prev()), { ref: item.registerElement, role: "treeitem", "aria-setsize": itemMeta.setSize, "aria-posinset": itemMeta.posInSet, "aria-selected": "false", "aria-label": item.getItemName(), "aria-level": itemMeta.level, tabIndex: item.isFocused() ? 0 : -1, onClick: (e) => {

package/lib/cjs/features/tree/types.d.ts

@@ -37,6 +37,7 @@ export type TreeFeatureDef<T> = {
     };
     itemInstance: {
         getId: () => string;
+        getKey: () => string;
         getProps: () => Record<string, any>;
         getItemName: () => string;
         getItemData: () => T;

package/lib/cjs/index.d.ts

@@ -27,3 +27,4 @@ export * from "./utilities/insert-items-at-target";
 export * from "./utilities/remove-items-from-parents";
 export * from "./core/build-proxified-instance";
 export * from "./core/build-static-instance";
+export { makeStateUpdater } from "./utils";

package/lib/cjs/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeStateUpdater = void 0;
 __exportStar(require("./types/core"), exports);
 __exportStar(require("./core/create-tree"), exports);
 __exportStar(require("./features/tree/types"), exports);
@@ -42,3 +43,5 @@ __exportStar(require("./utilities/insert-items-at-target"), exports);
 __exportStar(require("./utilities/remove-items-from-parents"), exports);
 __exportStar(require("./core/build-proxified-instance"), exports);
 __exportStar(require("./core/build-static-instance"), exports);
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "makeStateUpdater", { enumerable: true, get: function () { return utils_1.makeStateUpdater; } });

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

@@ -34,6 +34,7 @@ class TestTree {
     get instance() {
         if (!this.treeInstance) {
             this.treeInstance = (0, create_tree_1.createTree)(this.config);
+            this.treeInstance.rebuildTree();
         }
         return this.treeInstance;
     }

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

@@ -162,6 +162,5 @@ export const createTree = (initialConfig) => {
         Object.assign(hotkeyPresets, (_d = feature.hotkeys) !== null && _d !== void 0 ? _d : {});
     }
     finalizeTree();
-    rebuildItemMeta();
     return treeInstance;
 };

package/lib/esm/features/tree/feature.js

@@ -97,6 +97,7 @@ export const treeFeature = {
             (_d = item.getElement()) === null || _d === void 0 ? void 0 : _d.scrollIntoView(scrollIntoViewArg);
         }),
         getId: ({ itemId }) => itemId,
+        getKey: ({ itemId }) => itemId, // TODO apply to all stories to use
         getProps: ({ item, prev }) => {
             const itemMeta = item.getItemMeta();
             return Object.assign(Object.assign({}, prev === null || prev === void 0 ? void 0 : prev()), { ref: item.registerElement, role: "treeitem", "aria-setsize": itemMeta.setSize, "aria-posinset": itemMeta.posInSet, "aria-selected": "false", "aria-label": item.getItemName(), "aria-level": itemMeta.level, tabIndex: item.isFocused() ? 0 : -1, onClick: (e) => {

package/lib/esm/features/tree/types.d.ts

@@ -37,6 +37,7 @@ export type TreeFeatureDef<T> = {
     };
     itemInstance: {
         getId: () => string;
+        getKey: () => string;
         getProps: () => Record<string, any>;
         getItemName: () => string;
         getItemData: () => T;

package/lib/esm/index.d.ts

@@ -27,3 +27,4 @@ export * from "./utilities/insert-items-at-target";
 export * from "./utilities/remove-items-from-parents";
 export * from "./core/build-proxified-instance";
 export * from "./core/build-static-instance";
+export { makeStateUpdater } from "./utils";

package/lib/esm/index.js

@@ -26,3 +26,4 @@ export * from "./utilities/insert-items-at-target";
 export * from "./utilities/remove-items-from-parents";
 export * from "./core/build-proxified-instance";
 export * from "./core/build-static-instance";
+export { makeStateUpdater } from "./utils";

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

@@ -31,6 +31,7 @@ export class TestTree {
     get instance() {
         if (!this.treeInstance) {
             this.treeInstance = createTree(this.config);
+            this.treeInstance.rebuildTree();
         }
         return this.treeInstance;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-tree/core",
-  "version": "0.0.0-20250514161759",
+  "version": "0.0.0-20250611124731",
   "type": "module",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.js",

package/src/core/create-tree.ts

@@ -228,7 +228,6 @@ export const createTree = <T>(
   }
 
   finalizeTree();
-  rebuildItemMeta();
 
   return treeInstance;
 };

package/src/features/tree/feature.ts

@@ -126,6 +126,7 @@ export const treeFeature: FeatureImplementation<any> = {
       item.getElement()?.scrollIntoView(scrollIntoViewArg);
     },
     getId: ({ itemId }) => itemId,
+    getKey: ({ itemId }) => itemId, // TODO apply to all stories to use
     getProps: ({ item, prev }) => {
       const itemMeta = item.getItemMeta();
       return {

package/src/features/tree/types.ts

@@ -44,6 +44,7 @@ export type TreeFeatureDef<T> = {
   };
   itemInstance: {
     getId: () => string;
+    getKey: () => string;
     getProps: () => Record<string, any>;
     getItemName: () => string;
     getItemData: () => T;

package/src/index.ts

@@ -31,3 +31,5 @@ export * from "./utilities/remove-items-from-parents";
 
 export * from "./core/build-proxified-instance";
 export * from "./core/build-static-instance";
+
+export { makeStateUpdater } from "./utils";

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

@@ -78,6 +78,7 @@ export class TestTree<T = string> {
   get instance() {
     if (!this.treeInstance) {
       this.treeInstance = createTree(this.config);
+      this.treeInstance.rebuildTree();
     }
     return this.treeInstance;
   }