@payloadcms/ui 3.80.0-internal.60d6f94 → 3.80.0-internal.8d9ec7c

package/dist/elements/HierarchyTree/TreeFocusContext.d.ts

@@ -0,0 +1,28 @@
+import type React from 'react';
+type FocusableItem = {
+    id: string;
+    ref: React.RefObject<HTMLElement>;
+    type: 'load-more' | 'node';
+};
+type TreeFocusContextType = {
+    focusedId: null | string;
+    moveFocus: (direction: 'down' | 'up') => void;
+    registerItem: (item: FocusableItem) => void;
+    setFocusedId: (id: null | string) => void;
+    unregisterItem: (id: string) => void;
+};
+export declare const TreeFocusProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const useTreeFocus: () => TreeFocusContextType;
+export declare const useFocusableItem: ({ id, type, ref, }: {
+    id: string;
+    ref: React.RefObject<HTMLElement>;
+    type: "load-more" | "node";
+}) => {
+    handleFocus: () => void;
+    isFocused: boolean;
+    tabIndex: number;
+};
+export {};
+//# sourceMappingURL=TreeFocusContext.d.ts.map

package/dist/elements/HierarchyTree/TreeFocusContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeFocusContext.d.ts","sourceRoot":"","sources":["../../../src/elements/HierarchyTree/TreeFocusContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;CAC3B,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;IACxB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IAC3C,YAAY,EAAE,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,CAAA;IACzC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC,CAAA;AAID,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAsErE,CAAA;AAED,eAAO,MAAM,YAAY,4BAMxB,CAAA;AAED,eAAO,MAAM,gBAAgB,uBAI1B;IACD,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;CAC3B;;;;CAwBA,CAAA"}

package/dist/elements/HierarchyTree/TreeFocusContext.js

@@ -0,0 +1,140 @@
+'use client';
+
+import { c as _c } from "react/compiler-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, use, useCallback, useEffect, useRef, useState } from 'react';
+const TreeFocusContext = /*#__PURE__*/createContext(undefined);
+export const TreeFocusProvider = ({
+  children
+}) => {
+  const [focusedId, setFocusedId] = useState(null);
+  const itemsRef = useRef(new Map());
+  const registerItem = useCallback(item => {
+    itemsRef.current.set(item.id, item);
+  }, []);
+  const unregisterItem = useCallback(id => {
+    itemsRef.current.delete(id);
+  }, []);
+  const moveFocus = useCallback(direction => {
+    const items = Array.from(itemsRef.current.values());
+    if (items.length === 0) {
+      return;
+    }
+    // Sort items by their DOM position to ensure correct navigation order
+    const sortedItems = items.filter(item_0 => item_0.ref.current).sort((a, b) => {
+      const aElement = a.ref.current;
+      const bElement = b.ref.current;
+      if (!aElement || !bElement) {
+        return 0;
+      }
+      const position = aElement.compareDocumentPosition(bElement);
+      if (position & Node.DOCUMENT_POSITION_FOLLOWING) {
+        return -1;
+      }
+      if (position & Node.DOCUMENT_POSITION_PRECEDING) {
+        return 1;
+      }
+      return 0;
+    });
+    const currentIndex = focusedId ? sortedItems.findIndex(item_1 => item_1.id === focusedId) : -1;
+    let nextIndex;
+    if (direction === 'down') {
+      nextIndex = currentIndex === -1 ? 0 : Math.min(currentIndex + 1, sortedItems.length - 1);
+    } else {
+      nextIndex = Math.max(currentIndex - 1, 0);
+    }
+    const nextItem = sortedItems[nextIndex];
+    if (nextItem && nextItem.ref.current) {
+      nextItem.ref.current.focus();
+      setFocusedId(nextItem.id);
+    }
+  }, [focusedId]);
+  return /*#__PURE__*/_jsx(TreeFocusContext, {
+    value: {
+      focusedId,
+      moveFocus,
+      registerItem,
+      setFocusedId,
+      unregisterItem
+    },
+    children: children
+  });
+};
+export const useTreeFocus = () => {
+  const context = use(TreeFocusContext);
+  if (!context) {
+    throw new Error('useTreeFocus must be used within TreeFocusProvider');
+  }
+  return context;
+};
+export const useFocusableItem = t0 => {
+  const $ = _c(14);
+  const {
+    id,
+    type,
+    ref
+  } = t0;
+  const {
+    focusedId,
+    registerItem,
+    setFocusedId,
+    unregisterItem
+  } = useTreeFocus();
+  const isFocused = focusedId === id;
+  const isFirstItemEver = focusedId === null;
+  let t1;
+  let t2;
+  if ($[0] !== id || $[1] !== ref || $[2] !== registerItem || $[3] !== type || $[4] !== unregisterItem) {
+    t1 = () => {
+      registerItem({
+        id,
+        type,
+        ref
+      });
+      return () => {
+        unregisterItem(id);
+      };
+    };
+    t2 = [id, ref, type, registerItem, unregisterItem];
+    $[0] = id;
+    $[1] = ref;
+    $[2] = registerItem;
+    $[3] = type;
+    $[4] = unregisterItem;
+    $[5] = t1;
+    $[6] = t2;
+  } else {
+    t1 = $[5];
+    t2 = $[6];
+  }
+  useEffect(t1, t2);
+  let t3;
+  if ($[7] !== id || $[8] !== setFocusedId) {
+    t3 = () => {
+      setFocusedId(id);
+    };
+    $[7] = id;
+    $[8] = setFocusedId;
+    $[9] = t3;
+  } else {
+    t3 = $[9];
+  }
+  const handleFocus = t3;
+  const tabIndex = isFocused ? 0 : isFirstItemEver ? 0 : -1;
+  let t4;
+  if ($[10] !== handleFocus || $[11] !== isFocused || $[12] !== tabIndex) {
+    t4 = {
+      handleFocus,
+      isFocused,
+      tabIndex
+    };
+    $[10] = handleFocus;
+    $[11] = isFocused;
+    $[12] = tabIndex;
+    $[13] = t4;
+  } else {
+    t4 = $[13];
+  }
+  return t4;
+};
+//# sourceMappingURL=TreeFocusContext.js.map

package/dist/elements/HierarchyTree/TreeFocusContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeFocusContext.js","names":["c","_c","createContext","use","useCallback","useEffect","useRef","useState","TreeFocusContext","undefined","TreeFocusProvider","children","focusedId","setFocusedId","itemsRef","Map","registerItem","item","current","set","id","unregisterItem","delete","moveFocus","direction","items","Array","from","values","length","sortedItems","filter","ref","sort","a","b","aElement","bElement","position","compareDocumentPosition","Node","DOCUMENT_POSITION_FOLLOWING","DOCUMENT_POSITION_PRECEDING","currentIndex","findIndex","nextIndex","Math","min","max","nextItem","focus","_jsx","value","useTreeFocus","context","Error","useFocusableItem","t0","$","type","isFocused","isFirstItemEver","t1","t2","t3","handleFocus","tabIndex","t4"],"sources":["../../../src/elements/HierarchyTree/TreeFocusContext.tsx"],"sourcesContent":["'use client'\n\nimport type React from 'react'\n\nimport { createContext, use, useCallback, useEffect, useRef, useState } from 'react'\n\ntype FocusableItem = {\n  id: string\n  ref: React.RefObject<HTMLElement>\n  type: 'load-more' | 'node'\n}\n\ntype TreeFocusContextType = {\n  focusedId: null | string\n  moveFocus: (direction: 'down' | 'up') => void\n  registerItem: (item: FocusableItem) => void\n  setFocusedId: (id: null | string) => void\n  unregisterItem: (id: string) => void\n}\n\nconst TreeFocusContext = createContext<TreeFocusContextType | undefined>(undefined)\n\nexport const TreeFocusProvider: React.FC<{ children: React.ReactNode }> = ({ children }) => {\n  const [focusedId, setFocusedId] = useState<null | string>(null)\n  const itemsRef = useRef<Map<string, FocusableItem>>(new Map())\n\n  const registerItem = useCallback((item: FocusableItem) => {\n    itemsRef.current.set(item.id, item)\n  }, [])\n\n  const unregisterItem = useCallback((id: string) => {\n    itemsRef.current.delete(id)\n  }, [])\n\n  const moveFocus = useCallback(\n    (direction: 'down' | 'up') => {\n      const items = Array.from(itemsRef.current.values())\n      if (items.length === 0) {\n        return\n      }\n\n      // Sort items by their DOM position to ensure correct navigation order\n      const sortedItems = items\n        .filter((item) => item.ref.current)\n        .sort((a, b) => {\n          const aElement = a.ref.current\n          const bElement = b.ref.current\n          if (!aElement || !bElement) {\n            return 0\n          }\n\n          const position = aElement.compareDocumentPosition(bElement)\n          if (position & Node.DOCUMENT_POSITION_FOLLOWING) {\n            return -1\n          }\n          if (position & Node.DOCUMENT_POSITION_PRECEDING) {\n            return 1\n          }\n          return 0\n        })\n\n      const currentIndex = focusedId ? sortedItems.findIndex((item) => item.id === focusedId) : -1\n\n      let nextIndex: number\n      if (direction === 'down') {\n        nextIndex = currentIndex === -1 ? 0 : Math.min(currentIndex + 1, sortedItems.length - 1)\n      } else {\n        nextIndex = Math.max(currentIndex - 1, 0)\n      }\n\n      const nextItem = sortedItems[nextIndex]\n      if (nextItem && nextItem.ref.current) {\n        nextItem.ref.current.focus()\n        setFocusedId(nextItem.id)\n      }\n    },\n    [focusedId],\n  )\n\n  return (\n    <TreeFocusContext\n      value={{\n        focusedId,\n        moveFocus,\n        registerItem,\n        setFocusedId,\n        unregisterItem,\n      }}\n    >\n      {children}\n    </TreeFocusContext>\n  )\n}\n\nexport const useTreeFocus = () => {\n  const context = use(TreeFocusContext)\n  if (!context) {\n    throw new Error('useTreeFocus must be used within TreeFocusProvider')\n  }\n  return context\n}\n\nexport const useFocusableItem = ({\n  id,\n  type,\n  ref,\n}: {\n  id: string\n  ref: React.RefObject<HTMLElement>\n  type: 'load-more' | 'node'\n}) => {\n  const { focusedId, registerItem, setFocusedId, unregisterItem } = useTreeFocus()\n  const isFocused = focusedId === id\n  const isFirstItemEver = focusedId === null\n\n  useEffect(() => {\n    registerItem({ id, type, ref })\n    return () => {\n      unregisterItem(id)\n    }\n  }, [id, ref, type, registerItem, unregisterItem])\n\n  const handleFocus = useCallback(() => {\n    setFocusedId(id)\n  }, [id, setFocusedId])\n\n  // Roving tabindex: focused item gets 0, first item (when nothing focused) gets 0, all others get -1\n  const tabIndex = isFocused ? 0 : isFirstItemEver ? 0 : -1\n\n  return {\n    handleFocus,\n    isFocused,\n    tabIndex,\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/HierarchyTree/TreeNode/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { TreeNodeProps } from '../types.js';
+import './index.scss';
+export declare const TreeNode: ({ cache, collectionSlug, depth, expandedNodes, limit, node, onSelect, onToggle, parentFieldName, selected, selectedNodeId, useAsTitle, }: TreeNodeProps) => React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/HierarchyTree/TreeNode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/HierarchyTree/TreeNode/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQhD,OAAO,cAAc,CAAA;AAmBrB,eAAO,MAAM,QAAQ,6IAalB,aAAa,sBA6Kf,CAAA"}

package/dist/elements/HierarchyTree/TreeNode/index.js

@@ -0,0 +1,201 @@
+'use client';
+
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { DEFAULT_HIERARCHY_TREE_LIMIT } from 'payload/shared';
+import React, { useCallback, useRef } from 'react';
+import { Spinner } from '../../../elements/Spinner/index.js';
+import { ChevronIcon } from '../../../icons/Chevron/index.js';
+import { useTranslation } from '../../../providers/Translation/index.js';
+import { LoadMore } from '../LoadMore/index.js';
+import { useFocusableItem, useTreeFocus } from '../TreeFocusContext.js';
+import { useChildren } from '../useChildren.js';
+import './index.scss';
+const baseClass = 'hierarchy-tree-node';
+const getDocumentTitle = (doc, useAsTitle) => {
+  const docId = doc.id;
+  const idStr = typeof docId === 'number' ? String(docId) : docId;
+  if (!useAsTitle) {
+    return idStr;
+  }
+  const value = doc[useAsTitle];
+  if (value && (typeof value === 'string' || typeof value === 'number')) {
+    return String(value);
+  }
+  return idStr;
+};
+export const TreeNode = ({
+  cache,
+  collectionSlug,
+  depth = 0,
+  expandedNodes,
+  limit = DEFAULT_HIERARCHY_TREE_LIMIT,
+  node,
+  onSelect,
+  onToggle,
+  parentFieldName,
+  selected,
+  selectedNodeId,
+  useAsTitle
+}) => {
+  const {
+    t
+  } = useTranslation();
+  const expanded = expandedNodes.has(node.id);
+  const nodeRef = useRef(null);
+  const contentRef = useRef(null);
+  const {
+    setFocusedId
+  } = useTreeFocus();
+  const {
+    children,
+    hasMore,
+    isLoading,
+    loadMore: loadMoreFromHook,
+    totalDocs
+  } = useChildren({
+    cache,
+    collectionSlug,
+    enabled: expanded,
+    limit,
+    parentFieldName,
+    parentId: node.id
+  });
+  const handleLoadMore = React.useCallback(async () => {
+    const newDocs = await loadMoreFromHook();
+    if (newDocs && newDocs.length > 0) {
+      const firstNewDoc = newDocs[0];
+      const docId = firstNewDoc.id;
+      setFocusedId(`node-${docId}`);
+    }
+  }, [loadMoreFromHook, setFocusedId]);
+  const {
+    handleFocus,
+    isFocused,
+    tabIndex
+  } = useFocusableItem({
+    id: `node-${node.id}`,
+    type: 'node',
+    ref: contentRef
+  });
+  // When focusedId points to this node, actually call .focus()
+  React.useEffect(() => {
+    if (isFocused && contentRef.current && document.activeElement !== contentRef.current) {
+      contentRef.current.focus();
+    }
+  }, [isFocused]);
+  // Determine if node has children:
+  // - If explicitly set in data, use that
+  // - If expanded and loaded, check the actual children
+  // - Otherwise, assume it might have children (show chevron until proven otherwise)
+  const hasChildren = node.hasChildren === true || (expanded && children !== null ? children.length > 0 : true);
+  const handleToggleClick = useCallback(e => {
+    e.stopPropagation();
+    onToggle({
+      id: node.id
+    });
+  }, [node.id, onToggle]);
+  const handleSelectClick = useCallback(() => {
+    onSelect({
+      id: node.id
+    });
+  }, [node.id, onSelect]);
+  const handleKeyDown = useCallback(e_0 => {
+    switch (e_0.key) {
+      case ' ':
+      case 'Enter':
+        e_0.preventDefault();
+        handleSelectClick();
+        break;
+      case 'ArrowLeft':
+        if (hasChildren && expanded) {
+          e_0.preventDefault();
+          onToggle({
+            id: node.id
+          });
+        }
+        break;
+      case 'ArrowRight':
+        if (hasChildren && !expanded) {
+          e_0.preventDefault();
+          onToggle({
+            id: node.id
+          });
+        }
+        break;
+    }
+  }, [hasChildren, expanded, handleSelectClick, onToggle, node.id]);
+  return /*#__PURE__*/_jsxs("div", {
+    className: baseClass,
+    ref: nodeRef,
+    style: {
+      '--hierarchy-tree-depth': depth
+    },
+    children: [/*#__PURE__*/_jsxs("div", {
+      className: [`${baseClass}__content`, selected && `${baseClass}__content--selected`].filter(Boolean).join(' '),
+      onClick: handleSelectClick,
+      onFocus: handleFocus,
+      onKeyDown: handleKeyDown,
+      ref: contentRef,
+      role: "button",
+      tabIndex: tabIndex,
+      children: [/*#__PURE__*/_jsx("div", {
+        className: `${baseClass}__indicator`
+      }), hasChildren ? /*#__PURE__*/_jsx("button", {
+        "aria-label": expanded ? t('general:collapse') : t('general:open'),
+        className: `${baseClass}__toggle`,
+        onClick: handleToggleClick,
+        tabIndex: -1,
+        type: "button",
+        children: /*#__PURE__*/_jsx(ChevronIcon, {
+          direction: expanded ? 'down' : 'right'
+        })
+      }) : /*#__PURE__*/_jsx("div", {
+        className: `${baseClass}__toggle-spacer`
+      }), /*#__PURE__*/_jsx("span", {
+        className: `${baseClass}__title`,
+        title: node.title,
+        children: node.title
+      }), isLoading && expanded && /*#__PURE__*/_jsx("span", {
+        className: `${baseClass}__loading`,
+        children: /*#__PURE__*/_jsx(Spinner, {
+          loadingText: null,
+          size: "small"
+        })
+      })]
+    }), expanded && children && children.length > 0 && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("div", {
+        className: `${baseClass}__children`,
+        children: children.map(child => {
+          const childData = child;
+          const childId = childData.id;
+          const childTitle = getDocumentTitle(child, useAsTitle);
+          return /*#__PURE__*/_jsx(TreeNode, {
+            cache: cache,
+            collectionSlug: collectionSlug,
+            depth: depth + 1,
+            expandedNodes: expandedNodes,
+            limit: limit,
+            node: {
+              id: childId,
+              hasChildren: true,
+              title: childTitle
+            },
+            onSelect: onSelect,
+            onToggle: onToggle,
+            parentFieldName: parentFieldName,
+            selected: String(childId) === String(selectedNodeId),
+            selectedNodeId: selectedNodeId,
+            useAsTitle: useAsTitle
+          }, String(childId));
+        })
+      }), hasMore && /*#__PURE__*/_jsx(LoadMore, {
+        currentCount: children.length,
+        depth: depth + 1,
+        id: `load-more-${node.id}`,
+        onLoadMore: handleLoadMore,
+        totalDocs: totalDocs
+      })]
+    })]
+  });
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/HierarchyTree/TreeNode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DEFAULT_HIERARCHY_TREE_LIMIT","React","useCallback","useRef","Spinner","ChevronIcon","useTranslation","LoadMore","useFocusableItem","useTreeFocus","useChildren","baseClass","getDocumentTitle","doc","useAsTitle","docId","id","idStr","String","value","TreeNode","cache","collectionSlug","depth","expandedNodes","limit","node","onSelect","onToggle","parentFieldName","selected","selectedNodeId","t","expanded","has","nodeRef","contentRef","setFocusedId","children","hasMore","isLoading","loadMore","loadMoreFromHook","totalDocs","enabled","parentId","handleLoadMore","newDocs","length","firstNewDoc","handleFocus","isFocused","tabIndex","type","ref","useEffect","current","document","activeElement","focus","hasChildren","handleToggleClick","e","stopPropagation","handleSelectClick","handleKeyDown","key","preventDefault","_jsxs","className","style","filter","Boolean","join","onClick","onFocus","onKeyDown","role","_jsx","direction","title","loadingText","size","_Fragment","map","child","childData","childId","childTitle","currentCount","onLoadMore"],"sources":["../../../../src/elements/HierarchyTree/TreeNode/index.tsx"],"sourcesContent":["'use client'\n\nimport { DEFAULT_HIERARCHY_TREE_LIMIT } from 'payload/shared'\nimport React, { useCallback, useRef } from 'react'\n\nimport type { TreeNodeProps } from '../types.js'\n\nimport { Spinner } from '../../../elements/Spinner/index.js'\nimport { ChevronIcon } from '../../../icons/Chevron/index.js'\nimport { useTranslation } from '../../../providers/Translation/index.js'\nimport { LoadMore } from '../LoadMore/index.js'\nimport { useFocusableItem, useTreeFocus } from '../TreeFocusContext.js'\nimport { useChildren } from '../useChildren.js'\nimport './index.scss'\n\nconst baseClass = 'hierarchy-tree-node'\n\nconst getDocumentTitle = (doc: Record<string, unknown>, useAsTitle: string | undefined): string => {\n  const docId: number | string = doc.id as number | string\n  const idStr = typeof docId === 'number' ? String(docId) : docId\n\n  if (!useAsTitle) {\n    return idStr\n  }\n\n  const value = doc[useAsTitle]\n  if (value && (typeof value === 'string' || typeof value === 'number')) {\n    return String(value)\n  }\n  return idStr\n}\n\nexport const TreeNode = ({\n  cache,\n  collectionSlug,\n  depth = 0,\n  expandedNodes,\n  limit = DEFAULT_HIERARCHY_TREE_LIMIT,\n  node,\n  onSelect,\n  onToggle,\n  parentFieldName,\n  selected,\n  selectedNodeId,\n  useAsTitle,\n}: TreeNodeProps) => {\n  const { t } = useTranslation()\n  const expanded = expandedNodes.has(node.id)\n  const nodeRef = useRef<HTMLDivElement>(null)\n  const contentRef = useRef<HTMLDivElement>(null)\n  const { setFocusedId } = useTreeFocus()\n\n  const {\n    children,\n    hasMore,\n    isLoading,\n    loadMore: loadMoreFromHook,\n    totalDocs,\n  } = useChildren({\n    cache,\n    collectionSlug,\n    enabled: expanded,\n    limit,\n    parentFieldName,\n    parentId: node.id,\n  })\n\n  const handleLoadMore = React.useCallback(async () => {\n    const newDocs = await loadMoreFromHook()\n\n    if (newDocs && newDocs.length > 0) {\n      const firstNewDoc = newDocs[0]\n      const docId: number | string = (firstNewDoc as { id: number | string }).id\n      setFocusedId(`node-${docId}`)\n    }\n  }, [loadMoreFromHook, setFocusedId])\n\n  const { handleFocus, isFocused, tabIndex } = useFocusableItem({\n    id: `node-${node.id}`,\n    type: 'node',\n    ref: contentRef,\n  })\n\n  // When focusedId points to this node, actually call .focus()\n  React.useEffect(() => {\n    if (isFocused && contentRef.current && document.activeElement !== contentRef.current) {\n      contentRef.current.focus()\n    }\n  }, [isFocused])\n\n  // Determine if node has children:\n  // - If explicitly set in data, use that\n  // - If expanded and loaded, check the actual children\n  // - Otherwise, assume it might have children (show chevron until proven otherwise)\n  const hasChildren =\n    node.hasChildren === true || (expanded && children !== null ? children.length > 0 : true)\n\n  const handleToggleClick = useCallback(\n    (e: React.MouseEvent) => {\n      e.stopPropagation()\n      onToggle({ id: node.id })\n    },\n    [node.id, onToggle],\n  )\n\n  const handleSelectClick = useCallback(() => {\n    onSelect({ id: node.id })\n  }, [node.id, onSelect])\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent) => {\n      switch (e.key) {\n        case ' ':\n        case 'Enter':\n          e.preventDefault()\n          handleSelectClick()\n          break\n        case 'ArrowLeft':\n          if (hasChildren && expanded) {\n            e.preventDefault()\n            onToggle({ id: node.id })\n          }\n          break\n        case 'ArrowRight':\n          if (hasChildren && !expanded) {\n            e.preventDefault()\n            onToggle({ id: node.id })\n          }\n          break\n      }\n    },\n    [hasChildren, expanded, handleSelectClick, onToggle, node.id],\n  )\n\n  return (\n    <div\n      className={baseClass}\n      ref={nodeRef}\n      style={{ '--hierarchy-tree-depth': depth } as React.CSSProperties}\n    >\n      <div\n        className={[`${baseClass}__content`, selected && `${baseClass}__content--selected`]\n          .filter(Boolean)\n          .join(' ')}\n        onClick={handleSelectClick}\n        onFocus={handleFocus}\n        onKeyDown={handleKeyDown}\n        ref={contentRef}\n        role=\"button\"\n        tabIndex={tabIndex}\n      >\n        <div className={`${baseClass}__indicator`} />\n        {hasChildren ? (\n          <button\n            aria-label={expanded ? t('general:collapse') : t('general:open')}\n            className={`${baseClass}__toggle`}\n            onClick={handleToggleClick}\n            tabIndex={-1}\n            type=\"button\"\n          >\n            <ChevronIcon direction={expanded ? 'down' : 'right'} />\n          </button>\n        ) : (\n          <div className={`${baseClass}__toggle-spacer`} />\n        )}\n        <span className={`${baseClass}__title`} title={node.title}>\n          {node.title}\n        </span>\n        {isLoading && expanded && (\n          <span className={`${baseClass}__loading`}>\n            <Spinner loadingText={null} size=\"small\" />\n          </span>\n        )}\n      </div>\n\n      {expanded && children && children.length > 0 && (\n        <>\n          <div className={`${baseClass}__children`}>\n            {children.map((child) => {\n              const childData = child as { id: number | string }\n              const childId = childData.id\n              const childTitle = getDocumentTitle(child, useAsTitle)\n              return (\n                <TreeNode\n                  cache={cache}\n                  collectionSlug={collectionSlug}\n                  depth={depth + 1}\n                  expandedNodes={expandedNodes}\n                  key={String(childId)}\n                  limit={limit}\n                  node={{\n                    id: childId,\n                    hasChildren: true,\n                    title: childTitle,\n                  }}\n                  onSelect={onSelect}\n                  onToggle={onToggle}\n                  parentFieldName={parentFieldName}\n                  selected={String(childId) === String(selectedNodeId)}\n                  selectedNodeId={selectedNodeId}\n                  useAsTitle={useAsTitle}\n                />\n              )\n            })}\n          </div>\n          {hasMore && (\n            <LoadMore\n              currentCount={children.length}\n              depth={depth + 1}\n              id={`load-more-${node.id}`}\n              onLoadMore={handleLoadMore}\n              totalDocs={totalDocs}\n            />\n          )}\n        </>\n      )}\n    </div>\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/HierarchyTree/TreeNode/index.scss

@@ -0,0 +1,99 @@
+@import '../../../scss/styles.scss';
+
+.hierarchy-tree-node {
+  margin-left: var(--nav-padding-inline-start);
+  margin-right: var(--nav-padding-inline-start);
+  .hierarchy-tree-node {
+    margin-left: 0;
+    margin-right: 0;
+  }
+  // Variables are inherited from parent .hierarchy-tree
+
+  &__indicator {
+    position: absolute;
+    left: 0;
+    top: 0;
+    width: 2px;
+    height: 16px;
+    background-color: transparent;
+    border-start-end-radius: 2px;
+    border-end-end-radius: 2px;
+    left: calc(var(--nav-padding-inline-start) * -1);
+    top: 50%;
+    bottom: 50%;
+    transform: translateY(-50%);
+  }
+
+  &__content--selected {
+    font-weight: 600;
+
+    & > .hierarchy-tree-node__indicator {
+      background-color: var(--theme-text);
+    }
+  }
+
+  &__content {
+    display: flex;
+    align-items: center;
+    padding: var(--hierarchy-tree-node-padding-y) 0px;
+    padding-left: calc(var(--hierarchy-tree-depth, 0) * var(--hierarchy-tree-indent));
+    user-select: none;
+    transition: background-color 100ms ease;
+    font-size: var(--hierarchy-tree-font-size);
+    line-height: var(--hierarchy-tree-node-content-height);
+    height: var(--hierarchy-tree-node-content-height);
+    position: relative;
+    margin-bottom: var(--hierarchy-tree-row-gap);
+    border-radius: var(--style-radius-s);
+  }
+
+  &__toggle {
+    background: none;
+    border: none;
+    padding: 0;
+    margin: 0;
+    margin-right: var(--hierarchy-tree-chevron-spacing);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: default;
+    color: var(--theme-elevation-400);
+    width: var(--hierarchy-tree-chevron-width);
+    height: var(--hierarchy-tree-chevron-width);
+    flex-shrink: 0;
+    border-radius: var(--style-radius-m);
+
+    &:hover {
+      border: 1px solid var(--theme-elevation-400);
+    }
+  }
+
+  &__toggle-spacer {
+    width: calc(var(--hierarchy-tree-chevron-width) + var(--hierarchy-tree-chevron-spacing));
+    flex-shrink: 0;
+  }
+
+  &__title {
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    font-size: var(--hierarchy-tree-font-size);
+    color: var(--theme-text);
+    cursor: pointer;
+    &:hover {
+      text-decoration: underline;
+    }
+  }
+
+  &__loading {
+    margin-left: 8px;
+    display: inline-flex;
+    align-items: center;
+  }
+
+  &__children {
+    /* Children are rendered with depth variable set */
+  }
+}

package/dist/elements/HierarchyTree/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { HierarchyTreeProps } from './types.js';
+export declare const HierarchyTree: React.FC<HierarchyTreeProps>;
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/HierarchyTree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/HierarchyTree/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA+B,MAAM,OAAO,CAAA;AAEnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAMpD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA0EtD,CAAA"}

package/dist/elements/HierarchyTree/index.js

@@ -0,0 +1,66 @@
+'use client';
+
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_HIERARCHY_TREE_LIMIT } from 'payload/shared';
+import React, { useCallback, useMemo } from 'react';
+import { useConfig } from '../../providers/Config/index.js';
+import { useHierarchy } from '../../providers/Hierarchy/index.js';
+import { Tree } from '../Tree/index.js';
+export const HierarchyTree = ({
+  baseFilter,
+  collectionSlug,
+  filterByCollections,
+  icon,
+  initialData: initialDataProp,
+  onNodeClick,
+  selectedNodeId,
+  useAsTitle: useAsTitleProp
+}) => {
+  const {
+    getExpandedNodesForCollection,
+    getTreeDataForCollection,
+    toggleNodeForCollection,
+    typeFieldName
+  } = useHierarchy();
+  // Get initialData from context (cleared on refresh, hydrated by HydrateHierarchyProvider)
+  // Falls back to prop for first render before hydration completes
+  const contextData = getTreeDataForCollection(collectionSlug);
+  const initialData = contextData ?? initialDataProp;
+  const {
+    getEntityConfig
+  } = useConfig();
+  const collectionConfig = getEntityConfig({
+    collectionSlug
+  });
+  const hierarchyConfig = collectionConfig.hierarchy && typeof collectionConfig.hierarchy === 'object' ? collectionConfig.hierarchy : undefined;
+  const parentFieldName = hierarchyConfig?.parentFieldName;
+  const treeLimit = hierarchyConfig?.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT;
+  const useAsTitle = useAsTitleProp ?? collectionConfig.admin?.useAsTitle;
+  // Get all possible type values from relatedCollections for filtering empty arrays
+  const allPossibleTypeValues = useMemo(() => hierarchyConfig?.relatedCollections ? Object.keys(hierarchyConfig.relatedCollections) : undefined, [hierarchyConfig?.relatedCollections]);
+  // Get expanded nodes for THIS collection specifically
+  const expandedNodes = useMemo(() => getExpandedNodesForCollection(collectionSlug), [collectionSlug, getExpandedNodesForCollection]);
+  // Toggle node for THIS collection specifically
+  const handleToggleNode = useCallback(({
+    id
+  }) => {
+    toggleNodeForCollection(collectionSlug, id);
+  }, [collectionSlug, toggleNodeForCollection]);
+  return /*#__PURE__*/_jsx(Tree, {
+    allPossibleTypeValues: allPossibleTypeValues,
+    baseFilter: baseFilter,
+    collectionSlug: collectionSlug,
+    expandedNodes: expandedNodes,
+    filterByCollections: filterByCollections,
+    icon: icon,
+    initialData: initialData,
+    onNodeClick: onNodeClick,
+    parentFieldName: parentFieldName,
+    selectedNodeId: selectedNodeId,
+    toggleNode: handleToggleNode,
+    treeLimit: treeLimit,
+    typeFieldName: typeFieldName,
+    useAsTitle: useAsTitle
+  });
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/HierarchyTree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DEFAULT_HIERARCHY_TREE_LIMIT","React","useCallback","useMemo","useConfig","useHierarchy","Tree","HierarchyTree","baseFilter","collectionSlug","filterByCollections","icon","initialData","initialDataProp","onNodeClick","selectedNodeId","useAsTitle","useAsTitleProp","getExpandedNodesForCollection","getTreeDataForCollection","toggleNodeForCollection","typeFieldName","contextData","getEntityConfig","collectionConfig","hierarchyConfig","hierarchy","undefined","parentFieldName","treeLimit","admin","allPossibleTypeValues","relatedCollections","Object","keys","expandedNodes","handleToggleNode","id","_jsx","toggleNode"],"sources":["../../../src/elements/HierarchyTree/index.tsx"],"sourcesContent":["'use client'\n\nimport { DEFAULT_HIERARCHY_TREE_LIMIT } from 'payload/shared'\nimport React, { useCallback, useMemo } from 'react'\n\nimport type { HierarchyTreeProps } from './types.js'\n\nimport { useConfig } from '../../providers/Config/index.js'\nimport { useHierarchy } from '../../providers/Hierarchy/index.js'\nimport { Tree } from '../Tree/index.js'\n\nexport const HierarchyTree: React.FC<HierarchyTreeProps> = ({\n  baseFilter,\n  collectionSlug,\n  filterByCollections,\n  icon,\n  initialData: initialDataProp,\n  onNodeClick,\n  selectedNodeId,\n  useAsTitle: useAsTitleProp,\n}) => {\n  const {\n    getExpandedNodesForCollection,\n    getTreeDataForCollection,\n    toggleNodeForCollection,\n    typeFieldName,\n  } = useHierarchy()\n\n  // Get initialData from context (cleared on refresh, hydrated by HydrateHierarchyProvider)\n  // Falls back to prop for first render before hydration completes\n  const contextData = getTreeDataForCollection(collectionSlug)\n  const initialData = contextData ?? initialDataProp\n\n  const { getEntityConfig } = useConfig()\n\n  const collectionConfig = getEntityConfig({ collectionSlug })\n  const hierarchyConfig =\n    collectionConfig.hierarchy && typeof collectionConfig.hierarchy === 'object'\n      ? collectionConfig.hierarchy\n      : undefined\n  const parentFieldName = hierarchyConfig?.parentFieldName\n  const treeLimit = hierarchyConfig?.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT\n  const useAsTitle = useAsTitleProp ?? collectionConfig.admin?.useAsTitle\n\n  // Get all possible type values from relatedCollections for filtering empty arrays\n  const allPossibleTypeValues = useMemo(\n    () =>\n      hierarchyConfig?.relatedCollections\n        ? Object.keys(hierarchyConfig.relatedCollections)\n        : undefined,\n    [hierarchyConfig?.relatedCollections],\n  )\n\n  // Get expanded nodes for THIS collection specifically\n  const expandedNodes = useMemo(\n    () => getExpandedNodesForCollection(collectionSlug),\n    [collectionSlug, getExpandedNodesForCollection],\n  )\n\n  // Toggle node for THIS collection specifically\n  const handleToggleNode = useCallback(\n    ({ id }: { id: number | string }) => {\n      toggleNodeForCollection(collectionSlug, id)\n    },\n    [collectionSlug, toggleNodeForCollection],\n  )\n\n  return (\n    <Tree\n      allPossibleTypeValues={allPossibleTypeValues}\n      baseFilter={baseFilter}\n      collectionSlug={collectionSlug}\n      expandedNodes={expandedNodes}\n      filterByCollections={filterByCollections}\n      icon={icon}\n      initialData={initialData}\n      onNodeClick={onNodeClick}\n      parentFieldName={parentFieldName}\n      selectedNodeId={selectedNodeId}\n      toggleNode={handleToggleNode}\n      treeLimit={treeLimit}\n      typeFieldName={typeFieldName}\n      useAsTitle={useAsTitle}\n    />\n  )\n}\n"],"mappings":"AAAA;;;AAEA,SAASA,4BAA4B,QAAQ;AAC7C,OAAOC,KAAA,IAASC,WAAW,EAAEC,OAAO,QAAQ;AAI5C,SAASC,SAAS,QAAQ;AAC1B,SAASC,YAAY,QAAQ;AAC7B,SAASC,IAAI,QAAQ;AAErB,OAAO,MAAMC,aAAA,GAA8CA,CAAC;EAC1DC,UAAU;EACVC,cAAc;EACdC,mBAAmB;EACnBC,IAAI;EACJC,WAAA,EAAaC,eAAe;EAC5BC,WAAW;EACXC,cAAc;EACdC,UAAA,EAAYC;AAAc,CAC3B;EACC,MAAM;IACJC,6BAA6B;IAC7BC,wBAAwB;IACxBC,uBAAuB;IACvBC;EAAa,CACd,GAAGhB,YAAA;EAEJ;EACA;EACA,MAAMiB,WAAA,GAAcH,wBAAA,CAAyBV,cAAA;EAC7C,MAAMG,WAAA,GAAcU,WAAA,IAAeT,eAAA;EAEnC,MAAM;IAAEU;EAAe,CAAE,GAAGnB,SAAA;EAE5B,MAAMoB,gBAAA,GAAmBD,eAAA,CAAgB;IAAEd;EAAe;EAC1D,MAAMgB,eAAA,GACJD,gBAAA,CAAiBE,SAAS,IAAI,OAAOF,gBAAA,CAAiBE,SAAS,KAAK,WAChEF,gBAAA,CAAiBE,SAAS,GAC1BC,SAAA;EACN,MAAMC,eAAA,GAAkBH,eAAA,EAAiBG,eAAA;EACzC,MAAMC,SAAA,GAAYJ,eAAA,EAAiBK,KAAA,EAAOD,SAAA,IAAa7B,4BAAA;EACvD,MAAMgB,UAAA,GAAaC,cAAA,IAAkBO,gBAAA,CAAiBM,KAAK,EAAEd,UAAA;EAE7D;EACA,MAAMe,qBAAA,GAAwB5B,OAAA,CAC5B,MACEsB,eAAA,EAAiBO,kBAAA,GACbC,MAAA,CAAOC,IAAI,CAACT,eAAA,CAAgBO,kBAAkB,IAC9CL,SAAA,EACN,CAACF,eAAA,EAAiBO,kBAAA,CAAmB;EAGvC;EACA,MAAMG,aAAA,GAAgBhC,OAAA,CACpB,MAAMe,6BAAA,CAA8BT,cAAA,GACpC,CAACA,cAAA,EAAgBS,6BAAA,CAA8B;EAGjD;EACA,MAAMkB,gBAAA,GAAmBlC,WAAA,CACvB,CAAC;IAAEmC;EAAE,CAA2B;IAC9BjB,uBAAA,CAAwBX,cAAA,EAAgB4B,EAAA;EAC1C,GACA,CAAC5B,cAAA,EAAgBW,uBAAA,CAAwB;EAG3C,oBACEkB,IAAA,CAAChC,IAAA;IACCyB,qBAAA,EAAuBA,qBAAA;IACvBvB,UAAA,EAAYA,UAAA;IACZC,cAAA,EAAgBA,cAAA;IAChB0B,aAAA,EAAeA,aAAA;IACfzB,mBAAA,EAAqBA,mBAAA;IACrBC,IAAA,EAAMA,IAAA;IACNC,WAAA,EAAaA,WAAA;IACbE,WAAA,EAAaA,WAAA;IACbc,eAAA,EAAiBA,eAAA;IACjBb,cAAA,EAAgBA,cAAA;IAChBwB,UAAA,EAAYH,gBAAA;IACZP,SAAA,EAAWA,SAAA;IACXR,aAAA,EAAeA,aAAA;IACfL,UAAA,EAAYA;;AAGlB","ignoreList":[]}

package/dist/elements/HierarchyTree/index.scss

@@ -0,0 +1,42 @@
+@import '../../scss/styles.scss';
+
+.hierarchy-sidebar-tab {
+  display: flex;
+  flex-direction: column;
+  padding: 0;
+  margin: 0;
+  overflow-y: auto;
+  height: 100%;
+  // pull width edge to edge of the nav-sidebar container
+  width: calc(100% + var(--nav-padding-inline-start) + var(--nav-padding-inline-end));
+  margin-inline: calc(var(--nav-padding-inline-start) * -1);
+}
+
+.hierarchy-tree {
+  // CSS variables for customization - defined once at the top level
+  --hierarchy-tree-indent: 20px;
+  --hierarchy-tree-chevron-width: 16px;
+  --hierarchy-tree-chevron-spacing: 8px;
+  --hierarchy-tree-node-padding-y: calc(var(--base) / 4); // 4px
+  --hierarchy-tree-node-content-height: 24px;
+  --hierarchy-tree-row-gap: 8px;
+  --hierarchy-tree-font-size: 13px;
+
+  padding: 0;
+  margin: 0;
+  margin-top: 2px; // account for accessibility outline
+
+  &__loading {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--base);
+    min-height: 100px;
+  }
+
+  &__empty {
+    padding: 12px 16px;
+    color: var(--theme-elevation-500);
+    font-size: var(--hierarchy-tree-font-size);
+  }
+}