@payloadcms/ui 4.0.0-internal.5b1e7cd → 4.0.0-internal.c2b57ce

package/dist/elements/Hierarchy/Search/useHierarchySearch.js

@@ -0,0 +1,122 @@
+'use client';
+
+import { formatAdminURL } from 'payload/shared';
+import * as qs from 'qs-esm';
+import { useCallback, useState } from 'react';
+import { useConfig } from '../../../providers/Config/index.js';
+import { useLocale } from '../../../providers/Locale/index.js';
+export const useHierarchySearch = ({
+  collectionSlug,
+  limit = 15,
+  parentFieldName = 'parent',
+  titleField,
+  titlePathField = '_h_titlePath'
+}) => {
+  const [results, setResults] = useState([]);
+  const [isLoading, setIsLoading] = useState(false);
+  const [hasNextPage, setHasNextPage] = useState(false);
+  const [totalDocs, setTotalDocs] = useState(0);
+  const [page, setPage] = useState(1);
+  const [currentQuery, setCurrentQuery] = useState('');
+  const {
+    config: {
+      routes: {
+        api
+      },
+      serverURL
+    }
+  } = useConfig();
+  const {
+    code: locale
+  } = useLocale();
+  const fetchResults = useCallback(async ({
+    append,
+    pageToFetch,
+    query
+  }) => {
+    setIsLoading(true);
+    try {
+      const queryString = qs.stringify({
+        computeHierarchyPaths: true,
+        limit,
+        locale,
+        page: pageToFetch,
+        select: {
+          [parentFieldName]: true,
+          [titleField]: true,
+          [titlePathField]: true
+        },
+        where: {
+          [titleField]: {
+            contains: query
+          }
+        }
+      }, {
+        addQueryPrefix: true
+      });
+      const url = formatAdminURL({
+        apiRoute: api,
+        path: `/${collectionSlug}${queryString}`,
+        serverURL
+      });
+      const response = await fetch(url, {
+        credentials: 'include'
+      });
+      if (!response.ok) {
+        throw new Error('Search failed');
+      }
+      const data = await response.json();
+      const docs = (data.docs || []).map(doc => ({
+        ...doc,
+        path: doc[titlePathField] || ''
+      }));
+      setResults(append ? prev => [...prev, ...docs] : docs);
+      setHasNextPage(data.hasNextPage || false);
+      setTotalDocs(data.totalDocs || 0);
+      setPage(pageToFetch);
+      setCurrentQuery(query);
+    } catch {
+      if (!append) {
+        setResults([]);
+        setHasNextPage(false);
+        setTotalDocs(0);
+      }
+    } finally {
+      setIsLoading(false);
+    }
+  }, [api, collectionSlug, limit, locale, parentFieldName, serverURL, titleField, titlePathField]);
+  const search = useCallback(async query_0 => {
+    await fetchResults({
+      append: false,
+      pageToFetch: 1,
+      query: query_0
+    });
+  }, [fetchResults]);
+  const loadMore = useCallback(async () => {
+    if (isLoading || !hasNextPage || !currentQuery) {
+      return;
+    }
+    await fetchResults({
+      append: true,
+      pageToFetch: page + 1,
+      query: currentQuery
+    });
+  }, [isLoading, hasNextPage, currentQuery, page, fetchResults]);
+  const clearResults = useCallback(() => {
+    setResults([]);
+    setHasNextPage(false);
+    setTotalDocs(0);
+    setPage(1);
+    setCurrentQuery('');
+  }, []);
+  return {
+    clearResults,
+    hasNextPage,
+    isLoading,
+    loadMore,
+    results,
+    search,
+    totalDocs
+  };
+};
+//# sourceMappingURL=useHierarchySearch.js.map

package/dist/elements/Hierarchy/Search/useHierarchySearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHierarchySearch.js","names":["formatAdminURL","qs","useCallback","useState","useConfig","useLocale","useHierarchySearch","collectionSlug","limit","parentFieldName","titleField","titlePathField","results","setResults","isLoading","setIsLoading","hasNextPage","setHasNextPage","totalDocs","setTotalDocs","page","setPage","currentQuery","setCurrentQuery","config","routes","api","serverURL","code","locale","fetchResults","append","pageToFetch","query","queryString","stringify","computeHierarchyPaths","select","where","contains","addQueryPrefix","url","apiRoute","path","response","fetch","credentials","ok","Error","data","json","docs","map","doc","prev","search","loadMore","clearResults"],"sources":["../../../../src/elements/Hierarchy/Search/useHierarchySearch.ts"],"sourcesContent":["'use client'\n\nimport { formatAdminURL } from 'payload/shared'\nimport * as qs from 'qs-esm'\nimport { useCallback, useState } from 'react'\n\nimport type { SearchResult } from './types.js'\n\nimport { useConfig } from '../../../providers/Config/index.js'\nimport { useLocale } from '../../../providers/Locale/index.js'\n\ntype UseHierarchySearchArgs = {\n  collectionSlug: string\n  limit?: number\n  parentFieldName?: string\n  titleField: string\n  titlePathField?: string\n}\n\ntype UseHierarchySearchReturn = {\n  clearResults: () => void\n  hasNextPage: boolean\n  isLoading: boolean\n  loadMore: () => Promise<void>\n  results: SearchResult[]\n  search: (query: string) => Promise<void>\n  totalDocs: number\n}\n\nexport const useHierarchySearch = ({\n  collectionSlug,\n  limit = 15,\n  parentFieldName = 'parent',\n  titleField,\n  titlePathField = '_h_titlePath',\n}: UseHierarchySearchArgs): UseHierarchySearchReturn => {\n  const [results, setResults] = useState<SearchResult[]>([])\n  const [isLoading, setIsLoading] = useState(false)\n  const [hasNextPage, setHasNextPage] = useState(false)\n  const [totalDocs, setTotalDocs] = useState(0)\n  const [page, setPage] = useState(1)\n  const [currentQuery, setCurrentQuery] = useState('')\n\n  const {\n    config: {\n      routes: { api },\n      serverURL,\n    },\n  } = useConfig()\n  const { code: locale } = useLocale()\n\n  const fetchResults = useCallback(\n    async ({\n      append,\n      pageToFetch,\n      query,\n    }: {\n      append: boolean\n      pageToFetch: number\n      query: string\n    }) => {\n      setIsLoading(true)\n\n      try {\n        const queryString = qs.stringify(\n          {\n            computeHierarchyPaths: true,\n            limit,\n            locale,\n            page: pageToFetch,\n            select: {\n              [parentFieldName]: true,\n              [titleField]: true,\n              [titlePathField]: true,\n            },\n            where: {\n              [titleField]: { contains: query },\n            },\n          },\n          { addQueryPrefix: true },\n        )\n\n        const url = formatAdminURL({\n          apiRoute: api,\n          path: `/${collectionSlug}${queryString}`,\n          serverURL,\n        })\n\n        const response = await fetch(url, { credentials: 'include' })\n\n        if (!response.ok) {\n          throw new Error('Search failed')\n        }\n\n        const data = await response.json()\n        const docs: SearchResult[] = (data.docs || []).map((doc: Record<string, unknown>) => ({\n          ...doc,\n          path: doc[titlePathField] || '',\n        }))\n\n        setResults(append ? (prev) => [...prev, ...docs] : docs)\n        setHasNextPage(data.hasNextPage || false)\n        setTotalDocs(data.totalDocs || 0)\n        setPage(pageToFetch)\n        setCurrentQuery(query)\n      } catch {\n        if (!append) {\n          setResults([])\n          setHasNextPage(false)\n          setTotalDocs(0)\n        }\n      } finally {\n        setIsLoading(false)\n      }\n    },\n    [api, collectionSlug, limit, locale, parentFieldName, serverURL, titleField, titlePathField],\n  )\n\n  const search = useCallback(\n    async (query: string) => {\n      await fetchResults({ append: false, pageToFetch: 1, query })\n    },\n    [fetchResults],\n  )\n\n  const loadMore = useCallback(async () => {\n    if (isLoading || !hasNextPage || !currentQuery) {\n      return\n    }\n\n    await fetchResults({ append: true, pageToFetch: page + 1, query: currentQuery })\n  }, [isLoading, hasNextPage, currentQuery, page, fetchResults])\n\n  const clearResults = useCallback(() => {\n    setResults([])\n    setHasNextPage(false)\n    setTotalDocs(0)\n    setPage(1)\n    setCurrentQuery('')\n  }, [])\n\n  return {\n    clearResults,\n    hasNextPage,\n    isLoading,\n    loadMore,\n    results,\n    search,\n    totalDocs,\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.d.ts

@@ -0,0 +1,21 @@
+import type { SidebarTabClientProps } from 'payload';
+import React from 'react';
+import type { HierarchyInitialData } from './types.js';
+export declare const HierarchySidebarTab: React.FC<{
+    baseFilter?: Record<string, unknown>;
+    collectionSpecificOptions?: {
+        label: string;
+        value: string;
+    }[];
+    hierarchyCollectionSlug: string;
+    icon?: React.ReactNode;
+    initialData?: HierarchyInitialData | null;
+    initialExpandedNodes?: (number | string)[];
+    initialSelectedFilters?: string[];
+    parentFieldName?: string;
+    selectedNodeId?: null | string;
+    treeLimit?: number;
+    typeFieldName?: string;
+    useAsTitle?: string;
+} & SidebarTabClientProps>;
+//# sourceMappingURL=HierarchySidebarTab.d.ts.map

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySidebarTab.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/Tree/HierarchySidebarTab.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAGpD,OAAO,KAAmD,MAAM,OAAO,CAAA;AAEvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAWtD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CACxC;IACE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,yBAAyB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC9D,uBAAuB,EAAE,MAAM,CAAA;IAC/B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACzC,oBAAoB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC1C,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,qBAAqB,CAgH1B,CAAA"}

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.js

@@ -0,0 +1,196 @@
+'use client';
+
+import { c as _c } from "react/compiler-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { formatAdminURL } from 'payload/shared';
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+import { useConfig } from '../../../providers/Config/index.js';
+import { useHierarchy } from '../../../providers/Hierarchy/index.js';
+import { useRouter, useSearchParams } from '../../../providers/RouterAdapter/index.js';
+import { useRouteTransition } from '../../../providers/RouteTransition/index.js';
+import { useSidebarTabs } from '../../../providers/SidebarTabs/index.js';
+import { HydrateHierarchyProvider } from '../HydrateProvider/index.js';
+import { HierarchySearch } from '../Search/index.js';
+import { HierarchyTree } from './index.js';
+export const HierarchySidebarTab = t0 => {
+  const $ = _c(40);
+  const {
+    baseFilter,
+    collectionSpecificOptions,
+    hierarchyCollectionSlug,
+    icon,
+    initialData,
+    initialExpandedNodes,
+    initialSelectedFilters,
+    parentFieldName,
+    selectedNodeId: selectedNodeIdFromServer,
+    treeLimit,
+    typeFieldName,
+    useAsTitle
+  } = t0;
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const {
+    startRouteTransition
+  } = useRouteTransition();
+  const {
+    config: t1
+  } = useConfig();
+  const {
+    routes: t2
+  } = t1;
+  const {
+    admin: adminRoute
+  } = t2;
+  const [isSearchActive, setIsSearchActive] = useState(false);
+  let t3;
+  if ($[0] !== initialSelectedFilters) {
+    t3 = initialSelectedFilters ?? [];
+    $[0] = initialSelectedFilters;
+    $[1] = t3;
+  } else {
+    t3 = $[1];
+  }
+  const [selectedFilters, setSelectedFiltersLocal] = useState(t3);
+  const {
+    setSelectedFilters: setSelectedFiltersContext,
+    treeRefreshKeys
+  } = useHierarchy();
+  const sidebarTabs = useSidebarTabs();
+  const tabSlug = `hierarchy-${hierarchyCollectionSlug}`;
+  let t4;
+  if ($[2] !== hierarchyCollectionSlug || $[3] !== treeRefreshKeys) {
+    t4 = treeRefreshKeys.get(hierarchyCollectionSlug) ?? 0;
+    $[2] = hierarchyCollectionSlug;
+    $[3] = treeRefreshKeys;
+    $[4] = t4;
+  } else {
+    t4 = $[4];
+  }
+  const treeRefreshKey = t4;
+  const prevTreeRefreshKeyRef = useRef(treeRefreshKey);
+  let t5;
+  let t6;
+  if ($[5] !== sidebarTabs || $[6] !== tabSlug || $[7] !== treeRefreshKey) {
+    t5 = () => {
+      if (prevTreeRefreshKeyRef.current !== treeRefreshKey) {
+        prevTreeRefreshKeyRef.current = treeRefreshKey;
+        sidebarTabs?.reloadTabContent(tabSlug);
+      }
+    };
+    t6 = [treeRefreshKey, sidebarTabs, tabSlug];
+    $[5] = sidebarTabs;
+    $[6] = tabSlug;
+    $[7] = treeRefreshKey;
+    $[8] = t5;
+    $[9] = t6;
+  } else {
+    t5 = $[8];
+    t6 = $[9];
+  }
+  useEffect(t5, t6);
+  let t7;
+  if ($[10] !== adminRoute || $[11] !== baseFilter || $[12] !== collectionSpecificOptions || $[13] !== hierarchyCollectionSlug || $[14] !== icon || $[15] !== initialData || $[16] !== initialExpandedNodes || $[17] !== initialSelectedFilters || $[18] !== isSearchActive || $[19] !== parentFieldName || $[20] !== router || $[21] !== searchParams || $[22] !== selectedFilters || $[23] !== selectedNodeIdFromServer || $[24] !== setSelectedFiltersContext || $[25] !== sidebarTabs?.activeTabSlug || $[26] !== startRouteTransition || $[27] !== tabSlug || $[28] !== treeLimit || $[29] !== typeFieldName || $[30] !== useAsTitle) {
+    const parentParam = searchParams.get(parentFieldName ?? "parent");
+    const isActiveTab = sidebarTabs?.activeTabSlug === tabSlug;
+    const selectedNodeId = isActiveTab ? parentParam ?? selectedNodeIdFromServer ?? undefined : undefined;
+    const baseFilterKey = baseFilter ? JSON.stringify(baseFilter) : "";
+    let t8;
+    if ($[32] !== setSelectedFiltersContext) {
+      t8 = filters => {
+        setSelectedFiltersLocal(filters);
+        setSelectedFiltersContext(filters);
+      };
+      $[32] = setSelectedFiltersContext;
+      $[33] = t8;
+    } else {
+      t8 = $[33];
+    }
+    const handleFilterChange = t8;
+    let t9;
+    if ($[34] !== adminRoute || $[35] !== hierarchyCollectionSlug || $[36] !== parentFieldName || $[37] !== router || $[38] !== startRouteTransition) {
+      t9 = t10 => {
+        const {
+          id
+        } = t10;
+        const queryParam = parentFieldName ?? "parent";
+        const url = formatAdminURL({
+          adminRoute,
+          path: `/collections/${hierarchyCollectionSlug}/hierarchy?${queryParam}=${id}`
+        });
+        startRouteTransition(() => {
+          router.push(url);
+          router.refresh();
+        });
+      };
+      $[34] = adminRoute;
+      $[35] = hierarchyCollectionSlug;
+      $[36] = parentFieldName;
+      $[37] = router;
+      $[38] = startRouteTransition;
+      $[39] = t9;
+    } else {
+      t9 = $[39];
+    }
+    const handleNavigateToParent = t9;
+    t7 = _jsxs(_Fragment, {
+      children: [_jsx(HydrateHierarchyProvider, {
+        baseFilter,
+        collectionSlug: hierarchyCollectionSlug,
+        expandedNodes: initialExpandedNodes,
+        parentFieldName,
+        selectedFilters: initialSelectedFilters,
+        treeData: initialData,
+        treeLimit,
+        typeFieldName
+      }), _jsxs("div", {
+        className: "hierarchy-sidebar-tab",
+        children: [_jsx(HierarchySearch, {
+          collectionSlug: hierarchyCollectionSlug,
+          collectionSpecificOptions,
+          isActive: isSearchActive,
+          onActiveChange: setIsSearchActive,
+          onFilterChange: handleFilterChange,
+          onSelect: handleNavigateToParent,
+          selectedFilters
+        }), !isSearchActive && _jsx(HierarchyTree, {
+          baseFilter,
+          collectionSlug: hierarchyCollectionSlug,
+          filterByCollections: selectedFilters.length > 0 ? selectedFilters : undefined,
+          icon,
+          initialData,
+          initialExpandedNodes,
+          onNodeClick: handleNavigateToParent,
+          selectedNodeId,
+          useAsTitle
+        }, `${hierarchyCollectionSlug}-${baseFilterKey}`)]
+      })]
+    });
+    $[10] = adminRoute;
+    $[11] = baseFilter;
+    $[12] = collectionSpecificOptions;
+    $[13] = hierarchyCollectionSlug;
+    $[14] = icon;
+    $[15] = initialData;
+    $[16] = initialExpandedNodes;
+    $[17] = initialSelectedFilters;
+    $[18] = isSearchActive;
+    $[19] = parentFieldName;
+    $[20] = router;
+    $[21] = searchParams;
+    $[22] = selectedFilters;
+    $[23] = selectedNodeIdFromServer;
+    $[24] = setSelectedFiltersContext;
+    $[25] = sidebarTabs?.activeTabSlug;
+    $[26] = startRouteTransition;
+    $[27] = tabSlug;
+    $[28] = treeLimit;
+    $[29] = typeFieldName;
+    $[30] = useAsTitle;
+    $[31] = t7;
+  } else {
+    t7 = $[31];
+  }
+  return t7;
+};
+//# sourceMappingURL=HierarchySidebarTab.js.map

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySidebarTab.js","names":["c","_c","formatAdminURL","React","useCallback","useEffect","useRef","useState","useConfig","useHierarchy","useRouter","useSearchParams","useRouteTransition","useSidebarTabs","HydrateHierarchyProvider","HierarchySearch","HierarchyTree","HierarchySidebarTab","t0","$","baseFilter","collectionSpecificOptions","hierarchyCollectionSlug","icon","initialData","initialExpandedNodes","initialSelectedFilters","parentFieldName","selectedNodeId","selectedNodeIdFromServer","treeLimit","typeFieldName","useAsTitle","router","searchParams","startRouteTransition","config","t1","routes","t2","admin","adminRoute","isSearchActive","setIsSearchActive","t3","selectedFilters","setSelectedFiltersLocal","setSelectedFilters","setSelectedFiltersContext","treeRefreshKeys","sidebarTabs","tabSlug","t4","get","treeRefreshKey","prevTreeRefreshKeyRef","t5","t6","current","reloadTabContent","t7","activeTabSlug","parentParam","isActiveTab","undefined","baseFilterKey","JSON","stringify","t8","filters","handleFilterChange","t9","t10","id","queryParam","url","path","push","refresh","handleNavigateToParent","_jsxs","_Fragment","children","_jsx","collectionSlug","expandedNodes","treeData","className","isActive","onActiveChange","onFilterChange","onSelect","filterByCollections","length","onNodeClick"],"sources":["../../../../src/elements/Hierarchy/Tree/HierarchySidebarTab.tsx"],"sourcesContent":["'use client'\n\nimport type { SidebarTabClientProps } from 'payload'\n\nimport { formatAdminURL } from 'payload/shared'\nimport React, { useCallback, useEffect, useRef, useState } from 'react'\n\nimport type { HierarchyInitialData } from './types.js'\n\nimport { useConfig } from '../../../providers/Config/index.js'\nimport { useHierarchy } from '../../../providers/Hierarchy/index.js'\nimport { useRouter, useSearchParams } from '../../../providers/RouterAdapter/index.js'\nimport { useRouteTransition } from '../../../providers/RouteTransition/index.js'\nimport { useSidebarTabs } from '../../../providers/SidebarTabs/index.js'\nimport { HydrateHierarchyProvider } from '../HydrateProvider/index.js'\nimport { HierarchySearch } from '../Search/index.js'\nimport { HierarchyTree } from './index.js'\n\nexport const HierarchySidebarTab: React.FC<\n  {\n    baseFilter?: Record<string, unknown>\n    collectionSpecificOptions?: { label: string; value: string }[]\n    hierarchyCollectionSlug: string\n    icon?: React.ReactNode\n    initialData?: HierarchyInitialData | null\n    initialExpandedNodes?: (number | string)[]\n    initialSelectedFilters?: string[]\n    parentFieldName?: string\n    selectedNodeId?: null | string\n    treeLimit?: number\n    typeFieldName?: string\n    useAsTitle?: string\n  } & SidebarTabClientProps\n> = ({\n  baseFilter,\n  collectionSpecificOptions,\n  hierarchyCollectionSlug,\n  icon,\n  initialData,\n  initialExpandedNodes,\n  initialSelectedFilters,\n  parentFieldName,\n  selectedNodeId: selectedNodeIdFromServer,\n  treeLimit,\n  typeFieldName,\n  useAsTitle,\n}) => {\n  const router = useRouter()\n  const searchParams = useSearchParams()\n  const { startRouteTransition } = useRouteTransition()\n  const {\n    config: {\n      routes: { admin: adminRoute },\n    },\n  } = useConfig()\n  const [isSearchActive, setIsSearchActive] = useState(false)\n  const [selectedFilters, setSelectedFiltersLocal] = useState<string[]>(\n    initialSelectedFilters ?? [],\n  )\n  const { setSelectedFilters: setSelectedFiltersContext, treeRefreshKeys } = useHierarchy()\n  const sidebarTabs = useSidebarTabs()\n\n  // When refreshTree(slug) is called from the list view (e.g. after mutations), reload this tab.\n  // Always reload regardless of active state so inactive tabs are fresh when switched to.\n  const tabSlug = `hierarchy-${hierarchyCollectionSlug}`\n  const treeRefreshKey = treeRefreshKeys.get(hierarchyCollectionSlug) ?? 0\n  const prevTreeRefreshKeyRef = useRef(treeRefreshKey)\n  useEffect(() => {\n    if (prevTreeRefreshKeyRef.current !== treeRefreshKey) {\n      prevTreeRefreshKeyRef.current = treeRefreshKey\n      sidebarTabs?.reloadTabContent(tabSlug)\n    }\n  }, [treeRefreshKey, sidebarTabs, tabSlug])\n\n  // Only highlight selected node when this tab is active\n  const parentParam = searchParams.get(parentFieldName ?? 'parent')\n  const isActiveTab = sidebarTabs?.activeTabSlug === tabSlug\n  const selectedNodeId = isActiveTab\n    ? (parentParam ?? selectedNodeIdFromServer ?? undefined)\n    : undefined\n\n  const baseFilterKey = baseFilter ? JSON.stringify(baseFilter) : ''\n\n  const handleFilterChange = useCallback(\n    (filters: string[]) => {\n      setSelectedFiltersLocal(filters)\n      setSelectedFiltersContext(filters)\n    },\n    [setSelectedFiltersContext],\n  )\n\n  const handleNavigateToParent = useCallback(\n    ({ id }: { id: number | string }) => {\n      const queryParam = parentFieldName ?? 'parent'\n      const url = formatAdminURL({\n        adminRoute,\n        path: `/collections/${hierarchyCollectionSlug}/hierarchy?${queryParam}=${id}`,\n      })\n      startRouteTransition(() => {\n        router.push(url)\n        router.refresh()\n      })\n    },\n    [adminRoute, hierarchyCollectionSlug, parentFieldName, router, startRouteTransition],\n  )\n  return (\n    <>\n      <HydrateHierarchyProvider\n        baseFilter={baseFilter}\n        collectionSlug={hierarchyCollectionSlug}\n        expandedNodes={initialExpandedNodes}\n        parentFieldName={parentFieldName}\n        selectedFilters={initialSelectedFilters}\n        treeData={initialData}\n        treeLimit={treeLimit}\n        typeFieldName={typeFieldName}\n      />\n      <div className=\"hierarchy-sidebar-tab\">\n        <HierarchySearch\n          collectionSlug={hierarchyCollectionSlug}\n          collectionSpecificOptions={collectionSpecificOptions}\n          isActive={isSearchActive}\n          onActiveChange={setIsSearchActive}\n          onFilterChange={handleFilterChange}\n          onSelect={handleNavigateToParent}\n          selectedFilters={selectedFilters}\n        />\n        {!isSearchActive && (\n          <HierarchyTree\n            baseFilter={baseFilter}\n            collectionSlug={hierarchyCollectionSlug}\n            filterByCollections={selectedFilters.length > 0 ? selectedFilters : undefined}\n            icon={icon}\n            initialData={initialData}\n            initialExpandedNodes={initialExpandedNodes}\n            key={`${hierarchyCollectionSlug}-${baseFilterKey}`}\n            onNodeClick={handleNavigateToParent}\n            selectedNodeId={selectedNodeId}\n            useAsTitle={useAsTitle}\n          />\n        )}\n      </div>\n    </>\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.server.d.ts

@@ -0,0 +1,7 @@
+import type { SidebarTabServerProps } from 'payload';
+import React from 'react';
+export type HierarchySidebarTabServerProps = {
+    hierarchyCollectionSlug: string;
+} & SidebarTabServerProps;
+export declare const HierarchySidebarTabServer: React.FC<HierarchySidebarTabServerProps>;
+//# sourceMappingURL=HierarchySidebarTab.server.d.ts.map

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySidebarTab.server.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/Tree/HierarchySidebarTab.server.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAS,MAAM,SAAS,CAAA;AAK3D,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,MAAM,MAAM,8BAA8B,GAAG;IAC3C,uBAAuB,EAAE,MAAM,CAAA;CAChC,GAAG,qBAAqB,CAAA;AAEzB,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CA4L9E,CAAA"}

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.server.js

@@ -0,0 +1,177 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getTranslation } from '@payloadcms/translations';
+import { DEFAULT_HIERARCHY_TREE_LIMIT, getInitialTreeData } from 'payload';
+import { PREFERENCE_KEYS } from 'payload/shared';
+import React from 'react';
+// eslint-disable-next-line payload/no-imports-from-exports-dir -- Server component must reference exports dir for proper client boundary
+import { HierarchySidebarTab } from '../../../exports/client/index.js';
+import { TagIcon } from '../../../icons/Tag/index.js';
+import { RenderServerComponent } from '../../RenderServerComponent/index.js';
+export const HierarchySidebarTabServer = async ({
+  hierarchyCollectionSlug,
+  i18n,
+  payload,
+  req,
+  searchParams,
+  user
+}) => {
+  if (!user) {
+    return null;
+  }
+  let initialData = null;
+  let initialExpandedNodes = [];
+  let initialSelectedFilters = [];
+  let selectedNodeId = null;
+  let parentFieldName = 'parent';
+  let treeLimit;
+  let typeFieldName;
+  let useAsTitle;
+  let collectionSpecificOptions = [];
+  let baseFilter = null;
+  // Get collection config and render icon (outside try block - doesn't need async)
+  const collectionConfig = payload.collections[hierarchyCollectionSlug]?.config;
+  const hierarchyConfig = collectionConfig?.hierarchy && typeof collectionConfig.hierarchy === 'object' ? collectionConfig.hierarchy : undefined;
+  const IconComponent = hierarchyConfig?.admin?.components?.Icon;
+  const icon = IconComponent ? RenderServerComponent({
+    Component: IconComponent,
+    importMap: payload.importMap,
+    key: `hierarchy-sidebar-icon-${hierarchyCollectionSlug}`
+  }) : /*#__PURE__*/_jsx(TagIcon, {});
+  try {
+    // Get parentFieldName from config first (needed for URL parsing)
+    parentFieldName = hierarchyConfig?.parentFieldName ?? 'parent';
+    // Get selected node from URL (?<parentFieldName>=<id>)
+    const selectedNodeParam = searchParams?.[parentFieldName];
+    selectedNodeId = selectedNodeParam ? String(selectedNodeParam) : null;
+    // STEP 1: Load user's expanded node preferences
+    const preferenceKey = `${PREFERENCE_KEYS.HIERARCHY_TREE}-${hierarchyCollectionSlug}`;
+    const {
+      docs: preferenceDocs
+    } = await payload.find({
+      collection: 'payload-preferences',
+      limit: 1,
+      overrideAccess: false,
+      user,
+      where: {
+        and: [{
+          key: {
+            equals: preferenceKey
+          }
+        }, {
+          'user.value': {
+            equals: user.id
+          }
+        }, {
+          'user.relationTo': {
+            equals: user.collection
+          }
+        }]
+      }
+    });
+    const preferences = preferenceDocs[0];
+    if (preferences?.value?.expandedNodes) {
+      initialExpandedNodes = preferences.value.expandedNodes;
+    }
+    if (preferences?.value?.selectedFilters) {
+      initialSelectedFilters = preferences.value.selectedFilters;
+    }
+    // STEP 2: Get remaining config values
+    treeLimit = hierarchyConfig?.admin?.treeLimit;
+    typeFieldName = hierarchyConfig?.collectionSpecific && typeof hierarchyConfig.collectionSpecific === 'object' ? hierarchyConfig.collectionSpecific.fieldName : undefined;
+    useAsTitle = collectionConfig?.admin?.useAsTitle;
+    // STEP 2.5: Build collection-specific options from related collections
+    if (hierarchyConfig.collectionSpecific && hierarchyConfig?.relatedCollections) {
+      collectionSpecificOptions = Object.keys(hierarchyConfig.relatedCollections).map(slug => {
+        const relatedConfig = payload.collections[slug]?.config;
+        const label = relatedConfig?.labels?.plural ?? slug;
+        return {
+          label: getTranslation(label, i18n),
+          value: slug
+        };
+      }).sort((a, b) => a.label.localeCompare(b.label));
+    }
+    // Track the immediate parent of the selected node (for ensuring siblings are loaded)
+    let selectedNodeParentId = null;
+    // If there's a selected node, ensure its ancestor chain is expanded
+    if (selectedNodeId) {
+      // Walk up the parent chain to root
+      const ancestorIds = [];
+      let currentNodeId = selectedNodeId;
+      let isFirstIteration = true;
+      while (currentNodeId) {
+        try {
+          const node = await payload.findByID({
+            id: currentNodeId,
+            collection: hierarchyCollectionSlug,
+            depth: 0,
+            overrideAccess: false,
+            user
+          });
+          const parentId = node?.[parentFieldName];
+          // Capture the immediate parent of the selected node
+          if (isFirstIteration) {
+            selectedNodeParentId = parentId ?? null;
+            isFirstIteration = false;
+          }
+          if (parentId) {
+            ancestorIds.push(parentId);
+            currentNodeId = parentId;
+          } else {
+            currentNodeId = null;
+          }
+        } catch {
+          break;
+        }
+      }
+      // Merge ancestor IDs with existing expanded nodes
+      const expandedSet = new Set(initialExpandedNodes);
+      ancestorIds.forEach(id => expandedSet.add(id));
+      initialExpandedNodes = Array.from(expandedSet);
+    }
+    const baseFilterFn = collectionConfig?.admin?.baseFilter ?? collectionConfig?.admin?.baseListFilter;
+    if (baseFilterFn && req) {
+      baseFilter = (await baseFilterFn({
+        limit: DEFAULT_HIERARCHY_TREE_LIMIT,
+        page: 1,
+        req,
+        sort: 'id'
+      })) ?? null;
+    }
+    initialData = await getInitialTreeData({
+      baseFilter,
+      collectionSlug: hierarchyCollectionSlug,
+      expandedNodeIds: initialExpandedNodes,
+      ...(initialSelectedFilters.length > 0 && {
+        filterByCollections: initialSelectedFilters
+      }),
+      ...(treeLimit !== undefined && {
+        limit: treeLimit
+      }),
+      payload,
+      selectedNodeId,
+      selectedNodeParentId,
+      user: req.user
+    });
+  } catch (error) {
+    payload.logger.warn({
+      err: error,
+      msg: `Failed to fetch hierarchy data for ${hierarchyCollectionSlug}`
+    });
+    // Fall back to client-side fetching if server fetch fails
+  }
+  return /*#__PURE__*/_jsx(HierarchySidebarTab, {
+    baseFilter: baseFilter,
+    collectionSpecificOptions: collectionSpecificOptions,
+    hierarchyCollectionSlug: hierarchyCollectionSlug,
+    icon: icon,
+    initialData: initialData,
+    initialExpandedNodes: initialExpandedNodes,
+    initialSelectedFilters: initialSelectedFilters,
+    parentFieldName: parentFieldName,
+    selectedNodeId: selectedNodeId,
+    treeLimit: treeLimit,
+    typeFieldName: typeFieldName,
+    useAsTitle: useAsTitle
+  });
+};
+//# sourceMappingURL=HierarchySidebarTab.server.js.map

package/dist/elements/Hierarchy/Tree/HierarchySidebarTab.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchySidebarTab.server.js","names":["getTranslation","DEFAULT_HIERARCHY_TREE_LIMIT","getInitialTreeData","PREFERENCE_KEYS","React","HierarchySidebarTab","TagIcon","RenderServerComponent","HierarchySidebarTabServer","hierarchyCollectionSlug","i18n","payload","req","searchParams","user","initialData","initialExpandedNodes","initialSelectedFilters","selectedNodeId","parentFieldName","treeLimit","typeFieldName","useAsTitle","collectionSpecificOptions","baseFilter","collectionConfig","collections","config","hierarchyConfig","hierarchy","undefined","IconComponent","admin","components","Icon","icon","Component","importMap","key","_jsx","selectedNodeParam","String","preferenceKey","HIERARCHY_TREE","docs","preferenceDocs","find","collection","limit","overrideAccess","where","and","equals","id","preferences","value","expandedNodes","selectedFilters","collectionSpecific","fieldName","relatedCollections","Object","keys","map","slug","relatedConfig","label","labels","plural","sort","a","b","localeCompare","selectedNodeParentId","ancestorIds","currentNodeId","isFirstIteration","node","findByID","depth","parentId","push","expandedSet","Set","forEach","add","Array","from","baseFilterFn","baseListFilter","page","collectionSlug","expandedNodeIds","length","filterByCollections","error","logger","warn","err","msg"],"sources":["../../../../src/elements/Hierarchy/Tree/HierarchySidebarTab.server.tsx"],"sourcesContent":["import type { SidebarTabServerProps, Where } from 'payload'\n\nimport { getTranslation } from '@payloadcms/translations'\nimport { DEFAULT_HIERARCHY_TREE_LIMIT, getInitialTreeData } from 'payload'\nimport { PREFERENCE_KEYS } from 'payload/shared'\nimport React from 'react'\n\n// eslint-disable-next-line payload/no-imports-from-exports-dir -- Server component must reference exports dir for proper client boundary\nimport { HierarchySidebarTab } from '../../../exports/client/index.js'\nimport { TagIcon } from '../../../icons/Tag/index.js'\nimport { RenderServerComponent } from '../../RenderServerComponent/index.js'\n\nexport type HierarchySidebarTabServerProps = {\n  hierarchyCollectionSlug: string\n} & SidebarTabServerProps\n\nexport const HierarchySidebarTabServer: React.FC<HierarchySidebarTabServerProps> = async ({\n  hierarchyCollectionSlug,\n  i18n,\n  payload,\n  req,\n  searchParams,\n  user,\n}) => {\n  if (!user) {\n    return null\n  }\n\n  let initialData = null\n  let initialExpandedNodes: (number | string)[] = []\n  let initialSelectedFilters: string[] = []\n  let selectedNodeId: null | string = null\n  let parentFieldName = 'parent'\n  let treeLimit: number | undefined\n  let typeFieldName: string | undefined\n  let useAsTitle: string | undefined\n  let collectionSpecificOptions: { label: string; value: string }[] = []\n  let baseFilter: null | Where = null\n\n  // Get collection config and render icon (outside try block - doesn't need async)\n  const collectionConfig = payload.collections[hierarchyCollectionSlug]?.config\n  const hierarchyConfig =\n    collectionConfig?.hierarchy && typeof collectionConfig.hierarchy === 'object'\n      ? collectionConfig.hierarchy\n      : undefined\n\n  const IconComponent = hierarchyConfig?.admin?.components?.Icon\n  const icon = IconComponent ? (\n    RenderServerComponent({\n      Component: IconComponent,\n      importMap: payload.importMap,\n      key: `hierarchy-sidebar-icon-${hierarchyCollectionSlug}`,\n    })\n  ) : (\n    <TagIcon />\n  )\n\n  try {\n    // Get parentFieldName from config first (needed for URL parsing)\n    parentFieldName = hierarchyConfig?.parentFieldName ?? 'parent'\n\n    // Get selected node from URL (?<parentFieldName>=<id>)\n    const selectedNodeParam = searchParams?.[parentFieldName]\n    selectedNodeId = selectedNodeParam ? String(selectedNodeParam) : null\n\n    // STEP 1: Load user's expanded node preferences\n    const preferenceKey = `${PREFERENCE_KEYS.HIERARCHY_TREE}-${hierarchyCollectionSlug}`\n\n    const { docs: preferenceDocs } = await payload.find({\n      collection: 'payload-preferences',\n      limit: 1,\n      overrideAccess: false,\n      user,\n      where: {\n        and: [\n          { key: { equals: preferenceKey } },\n          { 'user.value': { equals: user.id } },\n          { 'user.relationTo': { equals: user.collection } },\n        ],\n      },\n    })\n\n    const preferences = preferenceDocs[0]\n\n    if (preferences?.value?.expandedNodes) {\n      initialExpandedNodes = preferences.value.expandedNodes\n    }\n\n    if (preferences?.value?.selectedFilters) {\n      initialSelectedFilters = preferences.value.selectedFilters\n    }\n\n    // STEP 2: Get remaining config values\n    treeLimit = hierarchyConfig?.admin?.treeLimit\n    typeFieldName =\n      hierarchyConfig?.collectionSpecific && typeof hierarchyConfig.collectionSpecific === 'object'\n        ? hierarchyConfig.collectionSpecific.fieldName\n        : undefined\n    useAsTitle = collectionConfig?.admin?.useAsTitle\n\n    // STEP 2.5: Build collection-specific options from related collections\n    if (hierarchyConfig.collectionSpecific && hierarchyConfig?.relatedCollections) {\n      collectionSpecificOptions = Object.keys(hierarchyConfig.relatedCollections)\n        .map((slug) => {\n          const relatedConfig = payload.collections[slug]?.config\n          const label = relatedConfig?.labels?.plural ?? slug\n\n          return {\n            label: getTranslation(label, i18n),\n            value: slug,\n          }\n        })\n        .sort((a, b) => a.label.localeCompare(b.label))\n    }\n\n    // Track the immediate parent of the selected node (for ensuring siblings are loaded)\n    let selectedNodeParentId: null | number | string = null\n\n    // If there's a selected node, ensure its ancestor chain is expanded\n    if (selectedNodeId) {\n      // Walk up the parent chain to root\n      const ancestorIds: (number | string)[] = []\n      let currentNodeId: null | number | string = selectedNodeId\n      let isFirstIteration = true\n\n      while (currentNodeId) {\n        try {\n          const node = await payload.findByID({\n            id: currentNodeId,\n            collection: hierarchyCollectionSlug,\n            depth: 0,\n            overrideAccess: false,\n            user,\n          })\n\n          const parentId = node?.[parentFieldName]\n\n          // Capture the immediate parent of the selected node\n          if (isFirstIteration) {\n            selectedNodeParentId = parentId ?? null\n            isFirstIteration = false\n          }\n\n          if (parentId) {\n            ancestorIds.push(parentId)\n            currentNodeId = parentId\n          } else {\n            currentNodeId = null\n          }\n        } catch {\n          // Node not found or access denied\n          break\n        }\n      }\n\n      // Merge ancestor IDs with existing expanded nodes\n      const expandedSet = new Set(initialExpandedNodes)\n      ancestorIds.forEach((id) => expandedSet.add(id))\n      initialExpandedNodes = Array.from(expandedSet)\n    }\n\n    const baseFilterFn =\n      collectionConfig?.admin?.baseFilter ?? collectionConfig?.admin?.baseListFilter\n    if (baseFilterFn && req) {\n      baseFilter =\n        (await baseFilterFn({ limit: DEFAULT_HIERARCHY_TREE_LIMIT, page: 1, req, sort: 'id' })) ??\n        null\n    }\n\n    initialData = await getInitialTreeData({\n      baseFilter,\n      collectionSlug: hierarchyCollectionSlug,\n      expandedNodeIds: initialExpandedNodes,\n      ...(initialSelectedFilters.length > 0 && { filterByCollections: initialSelectedFilters }),\n      ...(treeLimit !== undefined && { limit: treeLimit }),\n      payload,\n      selectedNodeId,\n      selectedNodeParentId,\n      user: req.user,\n    })\n  } catch (error) {\n    payload.logger.warn({\n      err: error,\n      msg: `Failed to fetch hierarchy data for ${hierarchyCollectionSlug}`,\n    })\n    // Fall back to client-side fetching if server fetch fails\n  }\n\n  return (\n    <HierarchySidebarTab\n      baseFilter={baseFilter}\n      collectionSpecificOptions={collectionSpecificOptions}\n      hierarchyCollectionSlug={hierarchyCollectionSlug}\n      icon={icon}\n      initialData={initialData}\n      initialExpandedNodes={initialExpandedNodes}\n      initialSelectedFilters={initialSelectedFilters}\n      parentFieldName={parentFieldName}\n      selectedNodeId={selectedNodeId}\n      treeLimit={treeLimit}\n      typeFieldName={typeFieldName}\n      useAsTitle={useAsTitle}\n    />\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/Hierarchy/Tree/LoadMore/LoadMoreButton.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+type LoadMoreButtonProps = {
+    id: string;
+    onLoadMore: (() => Promise<void>) | (() => void);
+};
+export declare const LoadMoreButton: React.FC<LoadMoreButtonProps>;
+export {};
+//# sourceMappingURL=LoadMoreButton.d.ts.map

package/dist/elements/Hierarchy/Tree/LoadMore/LoadMoreButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadMoreButton.d.ts","sourceRoot":"","sources":["../../../../../src/elements/Hierarchy/Tree/LoadMore/LoadMoreButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAKlD,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyBxD,CAAA"}

package/dist/elements/Hierarchy/Tree/LoadMore/LoadMoreButton.js

@@ -0,0 +1,36 @@
+'use client';
+
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useCallback, useRef } from 'react';
+import { useTranslation } from '../../../../providers/Translation/index.js';
+import { useFocusableItem } from '../TreeFocusContext.js';
+export const LoadMoreButton = ({
+  id,
+  onLoadMore
+}) => {
+  const {
+    t
+  } = useTranslation();
+  const buttonRef = useRef(null);
+  const {
+    handleFocus,
+    tabIndex
+  } = useFocusableItem({
+    id,
+    type: 'load-more',
+    ref: buttonRef
+  });
+  const handleClick = useCallback(async () => {
+    await onLoadMore();
+  }, [onLoadMore]);
+  return /*#__PURE__*/_jsx("button", {
+    className: "tree__load-more-button",
+    onClick: handleClick,
+    onFocus: handleFocus,
+    ref: buttonRef,
+    tabIndex: tabIndex,
+    type: "button",
+    children: t('general:loadMore')
+  });
+};
+//# sourceMappingURL=LoadMoreButton.js.map