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

package/dist/elements/Tree/index.scss

@@ -0,0 +1,63 @@
+@import '../../scss/styles.scss';
+
+.tree {
+  // CSS variables for customization - defined once at the top level
+  --tree-indent: 20px;
+  --tree-chevron-width: 16px;
+  --tree-chevron-spacing: 8px;
+  --tree-node-padding-y: calc(var(--base) / 4); // 4px
+  --tree-node-content-height: 24px;
+  --tree-row-gap: 8px;
+  --tree-font-size: 13px;
+
+  padding: 0;
+  margin: 0;
+  margin-top: 2px; // account for accessibility outline
+
+  &__all-option {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: var(--tree-node-padding-y) 0;
+    font-size: var(--tree-font-size);
+    line-height: var(--tree-node-content-height);
+    height: var(--tree-node-content-height);
+    margin-bottom: var(--tree-row-gap);
+    cursor: pointer;
+    user-select: none;
+    color: var(--theme-text);
+    border-radius: var(--style-radius-s);
+
+    &:hover {
+      text-decoration: underline;
+    }
+
+    &:focus-visible {
+      outline: var(--accessibility-outline);
+    }
+
+    &--selected {
+      font-weight: 600;
+    }
+
+    svg {
+      width: 16px;
+      height: 16px;
+      flex-shrink: 0;
+    }
+  }
+
+  &__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(--tree-font-size);
+  }
+}

package/dist/elements/Tree/types.d.ts

@@ -0,0 +1,70 @@
+import type { Where } from 'payload';
+import type { MutableRefObject, ReactNode } from 'react';
+export type TreeDocument = {
+    [key: string]: unknown;
+    id: number | string;
+};
+export type TreeNodeData = {
+    hasChildren: boolean;
+    id: number | string;
+    title: string;
+};
+export type CachedChildren = {
+    children: TreeDocument[];
+    hasMore: boolean;
+    page: number;
+    totalDocs: number;
+};
+export type TreeCache = MutableRefObject<Map<string, CachedChildren>>;
+export type TreeInitialData = {
+    docs: TreeDocument[];
+    loadedParents: Record<string, {
+        hasMore: boolean;
+        loadedCount?: number;
+        totalDocs: number;
+    }>;
+};
+export type TreeProps = {
+    allPossibleTypeValues?: string[];
+    baseFilter?: null | Where;
+    collectionSlug: string;
+    expandedNodes: Set<number | string>;
+    filterByCollections?: string[];
+    icon?: ReactNode;
+    initialData?: null | TreeInitialData;
+    onNodeClick?: ({ id }: {
+        id: null | number | string;
+    }) => void;
+    parentFieldName: string;
+    selectedNodeId?: null | number | string;
+    showAllOption?: boolean;
+    toggleNode: ({ id }: {
+        id: number | string;
+    }) => void;
+    treeLimit?: number;
+    typeFieldName?: string;
+    useAsTitle?: string;
+};
+export type TreeNodeProps = {
+    allPossibleTypeValues?: string[];
+    baseFilter?: null | Where;
+    cache: TreeCache;
+    collectionSlug: string;
+    depth: number;
+    expandedNodes: Set<number | string>;
+    filterByCollections?: string[];
+    limit: number;
+    node: TreeNodeData;
+    onSelect?: ({ id }: {
+        id: number | string;
+    }) => void;
+    onToggle: ({ id }: {
+        id: number | string;
+    }) => void;
+    parentFieldName: string;
+    selected?: boolean;
+    selectedNodeId?: number | string;
+    typeFieldName?: null | string;
+    useAsTitle?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/Tree/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/elements/Tree/types.ts"],"names":[],"mappings":"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"}

package/dist/elements/Tree/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/elements/Tree/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/elements/Tree/types.ts"],"sourcesContent":["import type { Where } from 'payload'\nimport type { MutableRefObject, ReactNode } from 'react'\n\nexport type TreeDocument = {\n  [key: string]: unknown\n  id: number | string\n}\n\nexport type TreeNodeData = {\n  hasChildren: boolean\n  id: number | string\n  title: string\n}\n\nexport type CachedChildren = {\n  children: TreeDocument[]\n  hasMore: boolean\n  page: number\n  totalDocs: number\n}\n\nexport type TreeCache = MutableRefObject<Map<string, CachedChildren>>\n\nexport type TreeInitialData = {\n  docs: TreeDocument[]\n  loadedParents: Record<string, { hasMore: boolean; loadedCount?: number; totalDocs: number }>\n}\n\nexport type TreeProps = {\n  allPossibleTypeValues?: string[]\n  baseFilter?: null | Where\n  collectionSlug: string\n  expandedNodes: Set<number | string>\n  filterByCollections?: string[]\n  icon?: ReactNode\n  initialData?: null | TreeInitialData\n  onNodeClick?: ({ id }: { id: null | number | string }) => void\n  parentFieldName: string\n  selectedNodeId?: null | number | string\n  showAllOption?: boolean\n  toggleNode: ({ id }: { id: number | string }) => void\n  treeLimit?: number\n  typeFieldName?: string\n  useAsTitle?: string\n}\n\nexport type TreeNodeProps = {\n  allPossibleTypeValues?: string[]\n  baseFilter?: null | Where\n  cache: TreeCache\n  collectionSlug: string\n  depth: number\n  expandedNodes: Set<number | string>\n  filterByCollections?: string[]\n  limit: number\n  node: TreeNodeData\n  onSelect?: ({ id }: { id: number | string }) => void\n  onToggle: ({ id }: { id: number | string }) => void\n  parentFieldName: string\n  selected?: boolean\n  selectedNodeId?: number | string\n  typeFieldName?: null | string\n  useAsTitle?: string\n}\n"],"mappings":"AA8CA","ignoreList":[]}

package/dist/elements/Tree/useChildren.d.ts

@@ -0,0 +1,28 @@
+import type { Where } from 'payload';
+import type { TreeCache, TreeDocument, TreeInitialData } from './types.js';
+type UseChildrenArgs = {
+    allPossibleTypeValues?: string[];
+    /** Base filter to apply to all queries (e.g., tenant filter) */
+    baseFilter?: null | Where;
+    cache?: TreeCache;
+    collectionSlug: string;
+    enabled?: boolean;
+    filterByCollections?: string[];
+    initialData?: null | TreeInitialData;
+    limit?: number;
+    parentFieldName: string;
+    parentId: number | string;
+    typeFieldName?: null | string;
+    useAsTitle?: string;
+};
+type UseChildrenReturn = {
+    children: null | TreeDocument[];
+    hasMore: boolean;
+    isLoading: boolean;
+    loadMore: () => Promise<TreeDocument[]>;
+    refresh: () => Promise<TreeDocument[]>;
+    totalDocs: number;
+};
+export declare const useChildren: ({ allPossibleTypeValues, baseFilter, cache, collectionSlug, enabled, filterByCollections, initialData, limit, parentFieldName, parentId, typeFieldName, useAsTitle, }: UseChildrenArgs) => UseChildrenReturn;
+export {};
+//# sourceMappingURL=useChildren.d.ts.map

package/dist/elements/Tree/useChildren.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChildren.d.ts","sourceRoot":"","sources":["../../../src/elements/Tree/useChildren.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAMpC,OAAO,KAAK,EAAkB,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAK1F,KAAK,eAAe,GAAG;IACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;IACzB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,WAAW,CAAC,EAAE,IAAI,GAAG,eAAe,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,IAAI,GAAG,YAAY,EAAE,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACvC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,WAAW,0KAarB,eAAe,KAAG,iBAuOpB,CAAA"}

package/dist/elements/Tree/useChildren.js

@@ -0,0 +1,213 @@
+import { combineWhereConstraints, formatAdminURL } from 'payload/shared';
+import * as qs from 'qs-esm';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useConfig } from '../../providers/Config/index.js';
+import { isSuperset } from '../../utilities/isSuperset.js';
+export const useChildren = ({
+  allPossibleTypeValues,
+  baseFilter,
+  cache,
+  collectionSlug,
+  enabled = true,
+  filterByCollections,
+  initialData,
+  limit = 2,
+  parentFieldName,
+  parentId,
+  typeFieldName,
+  useAsTitle
+}) => {
+  const filterKey = filterByCollections?.length ? filterByCollections.slice().sort().join(',') : '';
+  const baseFilterKey = baseFilter ? JSON.stringify(baseFilter) : '';
+  const cacheKey = `${collectionSlug}-${parentId}-${filterKey}-${baseFilterKey}`;
+  const cachedData = cache?.current.get(cacheKey);
+  // Check if we have initial data for this specific parent
+  const parentKey = parentId === 'null' ? 'null' : String(parentId);
+  const parentMeta = initialData?.loadedParents?.[parentKey];
+  const hasInitialData = !!parentMeta;
+  // Extract docs for this parent from initialData if available
+  // Apply same superset filter as fetchPage for consistency
+  const initialDocsForParent = hasInitialData ? initialData.docs.filter(doc => {
+    const docParent = doc[parentFieldName] || 'null';
+    if (String(docParent) !== parentKey) {
+      return false;
+    }
+    if (filterByCollections?.length && typeFieldName) {
+      return isSuperset(doc[typeFieldName], filterByCollections);
+    }
+    return true;
+  }) : null;
+  const [children, setChildren] = useState(initialDocsForParent || cachedData?.children || null);
+  const [isLoading, setIsLoading] = useState(!hasInitialData && !cachedData && enabled);
+  const [page, setPage] = useState(cachedData?.page || 1);
+  const [totalDocs, setTotalDocs] = useState(parentMeta?.totalDocs || cachedData?.totalDocs || 0);
+  const [hasMore, setHasMore] = useState(parentMeta?.hasMore || cachedData?.hasMore || false);
+  const initializedRef = useRef(!!hasInitialData);
+  const {
+    config: {
+      routes: {
+        api
+      },
+      serverURL
+    }
+  } = useConfig();
+  const fetchPage = useCallback(async (pageToFetch, currentChildren) => {
+    setIsLoading(true);
+    try {
+      const parentCondition = parentId === 'null' || parentId === null ? {
+        or: [{
+          [parentFieldName]: {
+            exists: false
+          }
+        }, {
+          [parentFieldName]: {
+            equals: null
+          }
+        }]
+      } : {
+        [parentFieldName]: {
+          equals: parentId
+        }
+      };
+      // Build filter condition for collection type filtering
+      // Matches items that:
+      // - allow ANY of the selected collections, OR
+      // - are unrestricted (type field doesn't exist), OR
+      // - have empty allowedTypes array (unrestricted)
+      const filterCondition = filterByCollections?.length && typeFieldName ? {
+        or: [{
+          [typeFieldName]: {
+            in: filterByCollections
+          }
+        }, {
+          [typeFieldName]: {
+            exists: false
+          }
+        },
+        // Using not_in with all possible values matches empty arrays in both MongoDB and Postgres
+        ...(allPossibleTypeValues?.length ? [{
+          [typeFieldName]: {
+            not_in: allPossibleTypeValues
+          }
+        }] : [])]
+      } : undefined;
+      // Combine conditions: parent + filter + baseFilter
+      const where = combineWhereConstraints([parentCondition, filterCondition, baseFilter]);
+      const queryParams = {
+        limit,
+        page: pageToFetch,
+        sort: useAsTitle ?? 'id',
+        where
+      };
+      const queryString = qs.stringify(queryParams, {
+        addQueryPrefix: true
+      });
+      const url = formatAdminURL({
+        apiRoute: api,
+        path: `/${collectionSlug}${queryString}`,
+        serverURL
+      });
+      const response = await fetch(url, {
+        credentials: 'include'
+      });
+      if (!response.ok) {
+        throw new Error('Failed to fetch children');
+      }
+      const data = await response.json();
+      const allDocs = data.docs || [];
+      // Client-side filter: only show items that are a superset of required collections
+      // Server query uses ANY (due to PG limitations), but we want ALL (superset)
+      const newDocs = filterByCollections?.length && typeFieldName ? allDocs.filter(doc => isSuperset(doc[typeFieldName], filterByCollections)) : allDocs;
+      const newChildren = pageToFetch === 1 ? newDocs : [...(currentChildren || []), ...newDocs];
+      setChildren(newChildren);
+      setTotalDocs(data.totalDocs || 0);
+      setHasMore(data.hasNextPage || false);
+      setPage(pageToFetch);
+      if (cache) {
+        cache.current.set(cacheKey, {
+          children: newChildren,
+          hasMore: data.hasNextPage || false,
+          page: pageToFetch,
+          totalDocs: data.totalDocs || 0
+        });
+      }
+      return newDocs;
+    } catch {
+      if (pageToFetch === 1) {
+        const emptyChildren = [];
+        setChildren(emptyChildren);
+        setHasMore(false);
+        if (cache) {
+          cache.current.set(cacheKey, {
+            children: emptyChildren,
+            hasMore: false,
+            page: 1,
+            totalDocs: 0
+          });
+        }
+      }
+      return [];
+    } finally {
+      setIsLoading(false);
+    }
+  }, [allPossibleTypeValues, baseFilter, parentId, filterKey, parentFieldName, filterByCollections, typeFieldName, limit, useAsTitle, api, collectionSlug, serverURL, cache, cacheKey]);
+  // Reset state when filter changes
+  const prevFilterKeyRef = useRef(filterKey);
+  useEffect(() => {
+    if (prevFilterKeyRef.current !== filterKey) {
+      prevFilterKeyRef.current = filterKey;
+      setChildren(null);
+      setPage(1);
+      setTotalDocs(0);
+      setHasMore(false);
+    }
+  }, [filterKey]);
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    // Skip initial fetch if we have initialData
+    if (initializedRef.current && children !== null) {
+      initializedRef.current = false;
+      return;
+    }
+    // Restore from cache if children was reset (e.g., filter changed)
+    if (cachedData && children === null) {
+      setChildren(cachedData.children);
+      setPage(cachedData.page);
+      setTotalDocs(cachedData.totalDocs);
+      setHasMore(cachedData.hasMore);
+      return;
+    }
+    if (cachedData && page === cachedData.page) {
+      return;
+    }
+    void fetchPage(page, children);
+  }, [enabled, page, cachedData, fetchPage, children]);
+  const loadMore = useCallback(async () => {
+    if (isLoading || !hasMore) {
+      return [];
+    }
+    // If we have fewer items than our limit, the cached data was fetched with a smaller limit
+    // We need to re-fetch page 1 with our limit to get the full first page
+    const shouldRefetchPage1 = children && children.length < limit;
+    return fetchPage(shouldRefetchPage1 ? 1 : page + 1, children);
+  }, [isLoading, hasMore, page, children, fetchPage, limit]);
+  const refresh = useCallback(async () => {
+    if (cache) {
+      cache.current.delete(cacheKey);
+    }
+    setChildren(null);
+    setPage(1);
+    return fetchPage(1, null);
+  }, [cache, cacheKey, fetchPage]);
+  return {
+    children,
+    hasMore,
+    isLoading,
+    loadMore,
+    refresh,
+    totalDocs
+  };
+};
+//# sourceMappingURL=useChildren.js.map

package/dist/elements/Tree/useChildren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChildren.js","names":["combineWhereConstraints","formatAdminURL","qs","useCallback","useEffect","useRef","useState","useConfig","isSuperset","useChildren","allPossibleTypeValues","baseFilter","cache","collectionSlug","enabled","filterByCollections","initialData","limit","parentFieldName","parentId","typeFieldName","useAsTitle","filterKey","length","slice","sort","join","baseFilterKey","JSON","stringify","cacheKey","cachedData","current","get","parentKey","String","parentMeta","loadedParents","hasInitialData","initialDocsForParent","docs","filter","doc","docParent","children","setChildren","isLoading","setIsLoading","page","setPage","totalDocs","setTotalDocs","hasMore","setHasMore","initializedRef","config","routes","api","serverURL","fetchPage","pageToFetch","currentChildren","parentCondition","or","exists","equals","filterCondition","in","not_in","undefined","where","queryParams","queryString","addQueryPrefix","url","apiRoute","path","response","fetch","credentials","ok","Error","data","json","allDocs","newDocs","newChildren","hasNextPage","set","emptyChildren","prevFilterKeyRef","loadMore","shouldRefetchPage1","refresh","delete"],"sources":["../../../src/elements/Tree/useChildren.tsx"],"sourcesContent":["import type { Where } from 'payload'\n\nimport { combineWhereConstraints, formatAdminURL } from 'payload/shared'\nimport * as qs from 'qs-esm'\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nimport type { CachedChildren, TreeCache, TreeDocument, TreeInitialData } from './types.js'\n\nimport { useConfig } from '../../providers/Config/index.js'\nimport { isSuperset } from '../../utilities/isSuperset.js'\n\ntype UseChildrenArgs = {\n  allPossibleTypeValues?: string[]\n  /** Base filter to apply to all queries (e.g., tenant filter) */\n  baseFilter?: null | Where\n  cache?: TreeCache\n  collectionSlug: string\n  enabled?: boolean\n  filterByCollections?: string[]\n  initialData?: null | TreeInitialData\n  limit?: number\n  parentFieldName: string\n  parentId: number | string\n  typeFieldName?: null | string\n  useAsTitle?: string\n}\n\ntype UseChildrenReturn = {\n  children: null | TreeDocument[]\n  hasMore: boolean\n  isLoading: boolean\n  loadMore: () => Promise<TreeDocument[]>\n  refresh: () => Promise<TreeDocument[]>\n  totalDocs: number\n}\n\nexport const useChildren = ({\n  allPossibleTypeValues,\n  baseFilter,\n  cache,\n  collectionSlug,\n  enabled = true,\n  filterByCollections,\n  initialData,\n  limit = 2,\n  parentFieldName,\n  parentId,\n  typeFieldName,\n  useAsTitle,\n}: UseChildrenArgs): UseChildrenReturn => {\n  const filterKey = filterByCollections?.length ? filterByCollections.slice().sort().join(',') : ''\n  const baseFilterKey = baseFilter ? JSON.stringify(baseFilter) : ''\n  const cacheKey = `${collectionSlug}-${parentId}-${filterKey}-${baseFilterKey}`\n  const cachedData = cache?.current.get(cacheKey)\n\n  // Check if we have initial data for this specific parent\n  const parentKey = parentId === 'null' ? 'null' : String(parentId)\n  const parentMeta = initialData?.loadedParents?.[parentKey]\n  const hasInitialData = !!parentMeta\n\n  // Extract docs for this parent from initialData if available\n  // Apply same superset filter as fetchPage for consistency\n  const initialDocsForParent = hasInitialData\n    ? initialData.docs.filter((doc) => {\n        const docParent = doc[parentFieldName] || 'null'\n        if (String(docParent) !== parentKey) {\n          return false\n        }\n        if (filterByCollections?.length && typeFieldName) {\n          return isSuperset(doc[typeFieldName] as string[] | undefined, filterByCollections)\n        }\n        return true\n      })\n    : null\n\n  const [children, setChildren] = useState<null | TreeDocument[]>(\n    initialDocsForParent || cachedData?.children || null,\n  )\n  const [isLoading, setIsLoading] = useState(!hasInitialData && !cachedData && enabled)\n  const [page, setPage] = useState(cachedData?.page || 1)\n  const [totalDocs, setTotalDocs] = useState(parentMeta?.totalDocs || cachedData?.totalDocs || 0)\n  const [hasMore, setHasMore] = useState(parentMeta?.hasMore || cachedData?.hasMore || false)\n  const initializedRef = useRef(!!hasInitialData)\n  const {\n    config: {\n      routes: { api },\n      serverURL,\n    },\n  } = useConfig()\n\n  const fetchPage = useCallback(\n    async (\n      pageToFetch: number,\n      currentChildren: null | TreeDocument[],\n    ): Promise<TreeDocument[]> => {\n      setIsLoading(true)\n\n      try {\n        const parentCondition =\n          parentId === 'null' || parentId === null\n            ? {\n                or: [\n                  { [parentFieldName]: { exists: false } },\n                  { [parentFieldName]: { equals: null } },\n                ],\n              }\n            : { [parentFieldName]: { equals: parentId } }\n\n        // Build filter condition for collection type filtering\n        // Matches items that:\n        // - allow ANY of the selected collections, OR\n        // - are unrestricted (type field doesn't exist), OR\n        // - have empty allowedTypes array (unrestricted)\n        const filterCondition: undefined | Where =\n          filterByCollections?.length && typeFieldName\n            ? {\n                or: [\n                  { [typeFieldName]: { in: filterByCollections } },\n                  { [typeFieldName]: { exists: false } },\n                  // Using not_in with all possible values matches empty arrays in both MongoDB and Postgres\n                  ...(allPossibleTypeValues?.length\n                    ? [{ [typeFieldName]: { not_in: allPossibleTypeValues } }]\n                    : []),\n                ],\n              }\n            : undefined\n\n        // Combine conditions: parent + filter + baseFilter\n        const where = combineWhereConstraints([parentCondition, filterCondition, baseFilter])\n\n        const queryParams: Record<string, unknown> = {\n          limit,\n          page: pageToFetch,\n          sort: useAsTitle ?? 'id',\n          where,\n        }\n\n        const queryString = qs.stringify(queryParams, { addQueryPrefix: true })\n        const url = formatAdminURL({\n          apiRoute: api,\n          path: `/${collectionSlug}${queryString}`,\n          serverURL,\n        })\n        const response = await fetch(url, {\n          credentials: 'include',\n        })\n\n        if (!response.ok) {\n          throw new Error('Failed to fetch children')\n        }\n\n        const data = await response.json()\n        const allDocs: TreeDocument[] = data.docs || []\n\n        // Client-side filter: only show items that are a superset of required collections\n        // Server query uses ANY (due to PG limitations), but we want ALL (superset)\n        const newDocs =\n          filterByCollections?.length && typeFieldName\n            ? allDocs.filter((doc) =>\n                isSuperset(doc[typeFieldName] as string[] | undefined, filterByCollections),\n              )\n            : allDocs\n\n        const newChildren = pageToFetch === 1 ? newDocs : [...(currentChildren || []), ...newDocs]\n\n        setChildren(newChildren)\n        setTotalDocs(data.totalDocs || 0)\n        setHasMore(data.hasNextPage || false)\n        setPage(pageToFetch)\n\n        if (cache) {\n          cache.current.set(cacheKey, {\n            children: newChildren,\n            hasMore: data.hasNextPage || false,\n            page: pageToFetch,\n            totalDocs: data.totalDocs || 0,\n          })\n        }\n\n        return newDocs\n      } catch {\n        if (pageToFetch === 1) {\n          const emptyChildren: TreeDocument[] = []\n          setChildren(emptyChildren)\n          setHasMore(false)\n\n          if (cache) {\n            cache.current.set(cacheKey, {\n              children: emptyChildren,\n              hasMore: false,\n              page: 1,\n              totalDocs: 0,\n            })\n          }\n        }\n\n        return []\n      } finally {\n        setIsLoading(false)\n      }\n    },\n    [\n      allPossibleTypeValues,\n      baseFilter,\n      parentId,\n      filterKey,\n      parentFieldName,\n      filterByCollections,\n      typeFieldName,\n      limit,\n      useAsTitle,\n      api,\n      collectionSlug,\n      serverURL,\n      cache,\n      cacheKey,\n    ],\n  )\n\n  // Reset state when filter changes\n  const prevFilterKeyRef = useRef(filterKey)\n  useEffect(() => {\n    if (prevFilterKeyRef.current !== filterKey) {\n      prevFilterKeyRef.current = filterKey\n      setChildren(null)\n      setPage(1)\n      setTotalDocs(0)\n      setHasMore(false)\n    }\n  }, [filterKey])\n\n  useEffect(() => {\n    if (!enabled) {\n      return\n    }\n\n    // Skip initial fetch if we have initialData\n    if (initializedRef.current && children !== null) {\n      initializedRef.current = false\n      return\n    }\n\n    // Restore from cache if children was reset (e.g., filter changed)\n    if (cachedData && children === null) {\n      setChildren(cachedData.children)\n      setPage(cachedData.page)\n      setTotalDocs(cachedData.totalDocs)\n      setHasMore(cachedData.hasMore)\n      return\n    }\n\n    if (cachedData && page === cachedData.page) {\n      return\n    }\n\n    void fetchPage(page, children)\n  }, [enabled, page, cachedData, fetchPage, children])\n\n  const loadMore = useCallback(async (): Promise<TreeDocument[]> => {\n    if (isLoading || !hasMore) {\n      return []\n    }\n\n    // If we have fewer items than our limit, the cached data was fetched with a smaller limit\n    // We need to re-fetch page 1 with our limit to get the full first page\n    const shouldRefetchPage1 = children && children.length < limit\n\n    return fetchPage(shouldRefetchPage1 ? 1 : page + 1, children)\n  }, [isLoading, hasMore, page, children, fetchPage, limit])\n\n  const refresh = useCallback(async (): Promise<TreeDocument[]> => {\n    if (cache) {\n      cache.current.delete(cacheKey)\n    }\n    setChildren(null)\n    setPage(1)\n    return fetchPage(1, null)\n  }, [cache, cacheKey, fetchPage])\n\n  return { children, hasMore, isLoading, loadMore, refresh, totalDocs }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -8,7 +8,7 @@ import React from 'react';
  * rendering the original component.
  *
  * @example
- * const PredefinedComponent = withMergedProps({
+ * const PredefinedComponent = getMergedPropsComponent({
  *   Component: OriginalComponent,
  *   toMergeIntoProps: { someExtraValue: 5 }
  * });

package/dist/elements/withMergedProps/index.js

@@ -10,7 +10,7 @@ import React from 'react';
  * rendering the original component.
  *
  * @example
- * const PredefinedComponent = withMergedProps({
+ * const PredefinedComponent = getMergedPropsComponent({
  *   Component: OriginalComponent,
  *   toMergeIntoProps: { someExtraValue: 5 }
  * });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["isReactServerComponentOrFunction","serverProps","React","withMergedProps","Component","sanitizeServerOnlyProps","toMergeIntoProps","undefined","MergedPropsComponent","passedProps","mergedProps","simpleMergeProps","forEach","prop","_jsx","props","toMerge"],"sources":["../../../src/elements/withMergedProps/index.tsx"],"sourcesContent":["import { isReactServerComponentOrFunction, serverProps } from 'payload/shared'\nimport React from 'react'\n\n/**\n * Creates a higher-order component (HOC) that merges predefined properties (`toMergeIntoProps`)\n * with any properties passed to the resulting component.\n *\n * Use this when you want to pre-specify some props for a component, while also allowing users to\n * pass in their own props. The HOC ensures the passed props and predefined props are combined before\n * rendering the original component.\n *\n * @example\n * const PredefinedComponent = withMergedProps({\n *   Component: OriginalComponent,\n *   toMergeIntoProps: { someExtraValue: 5 }\n * });\n * // Using <PredefinedComponent customProp=\"value\" /> will result in\n * // <OriginalComponent customProp=\"value\" someExtraValue={5} />\n *\n * @returns A higher-order component with combined properties.\n *\n * @param Component - The original component to wrap.\n * @param sanitizeServerOnlyProps - If true, server-only props will be removed from the merged props. @default true if the component is not a server component, false otherwise.\n * @param toMergeIntoProps - The properties to merge into the passed props.\n */\nexport function withMergedProps<ToMergeIntoProps, CompleteReturnProps>({\n  Component,\n  sanitizeServerOnlyProps,\n  toMergeIntoProps,\n}: {\n  Component: React.FC<CompleteReturnProps>\n  sanitizeServerOnlyProps?: boolean\n  toMergeIntoProps: ToMergeIntoProps\n}): React.FC<CompleteReturnProps> {\n  if (sanitizeServerOnlyProps === undefined) {\n    sanitizeServerOnlyProps = !isReactServerComponentOrFunction(Component)\n  }\n  // A wrapper around the args.Component to inject the args.toMergeArgs as props, which are merged with the passed props\n  const MergedPropsComponent: React.FC<CompleteReturnProps> = (passedProps) => {\n    const mergedProps = simpleMergeProps(passedProps, toMergeIntoProps) as CompleteReturnProps\n\n    if (sanitizeServerOnlyProps) {\n      serverProps.forEach((prop) => {\n        delete mergedProps[prop]\n      })\n    }\n\n    return <Component {...mergedProps} />\n  }\n\n  return MergedPropsComponent\n}\n\nfunction simpleMergeProps(props, toMerge) {\n  return { ...props, ...toMerge }\n}\n"],"mappings":";AAAA,SAASA,gCAAgC,EAAEC,WAAW,QAAQ;AAC9D,OAAOC,KAAA,MAAW;AAElB;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAO,SAASC,gBAAuD;EACrEC,SAAS;EACTC,uBAAuB;EACvBC;AAAgB,CAKjB;EACC,IAAID,uBAAA,KAA4BE,SAAA,EAAW;IACzCF,uBAAA,GAA0B,CAACL,gCAAA,CAAiCI,SAAA;EAC9D;EACA;EACA,MAAMI,oBAAA,GAAuDC,WAAA;IAC3D,MAAMC,WAAA,GAAcC,gBAAA,CAAiBF,WAAA,EAAaH,gBAAA;IAElD,IAAID,uBAAA,EAAyB;MAC3BJ,WAAA,CAAYW,OAAO,CAAEC,IAAA;QACnB,OAAOH,WAAW,CAACG,IAAA,CAAK;MAC1B;IACF;IAEA,oBAAOC,IAAA,CAACV,SAAA;MAAW,GAAGM;;EACxB;EAEA,OAAOF,oBAAA;AACT;AAEA,SAASG,iBAAiBI,KAAK,EAAEC,OAAO;EACtC,OAAO;IAAE,GAAGD,KAAK;IAAE,GAAGC;EAAQ;AAChC","ignoreList":[]}
+{"version":3,"file":"index.js","names":["isReactServerComponentOrFunction","serverProps","React","withMergedProps","Component","sanitizeServerOnlyProps","toMergeIntoProps","undefined","MergedPropsComponent","passedProps","mergedProps","simpleMergeProps","forEach","prop","_jsx","props","toMerge"],"sources":["../../../src/elements/withMergedProps/index.tsx"],"sourcesContent":["import { isReactServerComponentOrFunction, serverProps } from 'payload/shared'\nimport React from 'react'\n\n/**\n * Creates a higher-order component (HOC) that merges predefined properties (`toMergeIntoProps`)\n * with any properties passed to the resulting component.\n *\n * Use this when you want to pre-specify some props for a component, while also allowing users to\n * pass in their own props. The HOC ensures the passed props and predefined props are combined before\n * rendering the original component.\n *\n * @example\n * const PredefinedComponent = getMergedPropsComponent({\n *   Component: OriginalComponent,\n *   toMergeIntoProps: { someExtraValue: 5 }\n * });\n * // Using <PredefinedComponent customProp=\"value\" /> will result in\n * // <OriginalComponent customProp=\"value\" someExtraValue={5} />\n *\n * @returns A higher-order component with combined properties.\n *\n * @param Component - The original component to wrap.\n * @param sanitizeServerOnlyProps - If true, server-only props will be removed from the merged props. @default true if the component is not a server component, false otherwise.\n * @param toMergeIntoProps - The properties to merge into the passed props.\n */\nexport function withMergedProps<ToMergeIntoProps, CompleteReturnProps>({\n  Component,\n  sanitizeServerOnlyProps,\n  toMergeIntoProps,\n}: {\n  Component: React.FC<CompleteReturnProps>\n  sanitizeServerOnlyProps?: boolean\n  toMergeIntoProps: ToMergeIntoProps\n}): React.FC<CompleteReturnProps> {\n  if (sanitizeServerOnlyProps === undefined) {\n    sanitizeServerOnlyProps = !isReactServerComponentOrFunction(Component)\n  }\n  // A wrapper around the args.Component to inject the args.toMergeArgs as props, which are merged with the passed props\n  const MergedPropsComponent: React.FC<CompleteReturnProps> = (passedProps) => {\n    const mergedProps = simpleMergeProps(passedProps, toMergeIntoProps) as CompleteReturnProps\n\n    if (sanitizeServerOnlyProps) {\n      serverProps.forEach((prop) => {\n        delete mergedProps[prop]\n      })\n    }\n\n    return <Component {...mergedProps} />\n  }\n\n  return MergedPropsComponent\n}\n\nfunction simpleMergeProps(props, toMerge) {\n  return { ...props, ...toMerge }\n}\n"],"mappings":";AAAA,SAASA,gCAAgC,EAAEC,WAAW,QAAQ;AAC9D,OAAOC,KAAA,MAAW;AAElB;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAO,SAASC,gBAAuD;EACrEC,SAAS;EACTC,uBAAuB;EACvBC;AAAgB,CAKjB;EACC,IAAID,uBAAA,KAA4BE,SAAA,EAAW;IACzCF,uBAAA,GAA0B,CAACL,gCAAA,CAAiCI,SAAA;EAC9D;EACA;EACA,MAAMI,oBAAA,GAAuDC,WAAA;IAC3D,MAAMC,WAAA,GAAcC,gBAAA,CAAiBF,WAAA,EAAaH,gBAAA;IAElD,IAAID,uBAAA,EAAyB;MAC3BJ,WAAA,CAAYW,OAAO,CAAEC,IAAA;QACnB,OAAOH,WAAW,CAACG,IAAA,CAAK;MAC1B;IACF;IAEA,oBAAOC,IAAA,CAACV,SAAA;MAAW,GAAGM;;EACxB;EAEA,OAAOF,oBAAA;AACT;AAEA,SAASG,iBAAiBI,KAAK,EAAEC,OAAO;EACtC,OAAO;IAAE,GAAGD,KAAK;IAAE,GAAGC;EAAQ;AAChC","ignoreList":[]}

package/dist/exports/client/index.d.ts

@@ -46,6 +46,7 @@ export { AnimateHeight } from '../../elements/AnimateHeight/index.js';
 export { PillSelector, type SelectablePill } from '../../elements/PillSelector/index.js';
 export { Card } from '../../elements/Card/index.js';
 export { Collapsible, useCollapsible } from '../../elements/Collapsible/index.js';
+export { HierarchySidebarTab } from '../../elements/HierarchyTree/HierarchySidebarTab.js';
 export { CopyLocaleData } from '../../elements/CopyLocaleData/index.js';
 export { CopyToClipboard } from '../../elements/CopyToClipboard/index.js';
 export { DeleteMany } from '../../elements/DeleteMany/index.js';
@@ -67,10 +68,24 @@ export { GenerateConfirmation } from '../../elements/GenerateConfirmation/index.
 export { Gutter } from '../../elements/Gutter/index.js';
 export { Hamburger } from '../../elements/Hamburger/index.js';
 export { HydrateAuthProvider } from '../../elements/HydrateAuthProvider/index.js';
+export { HydrateHierarchyProvider } from '../../elements/HydrateHierarchyProvider/index.js';
+export { Tree } from '../../elements/Tree/index.js';
+export { LoadMore } from '../../elements/Tree/LoadMore/index.js';
+export { TreeConnector } from '../../elements/Tree/TreeConnector.js';
+export { TreeFocusProvider, useTreeFocus } from '../../elements/Tree/TreeFocusContext.js';
+export { TreeNode } from '../../elements/Tree/TreeNode/index.js';
+export type { CachedChildren, TreeCache, TreeDocument, TreeInitialData, TreeNodeData, TreeNodeProps, TreeProps, } from '../../elements/Tree/types.js';
+export { useChildren } from '../../elements/Tree/useChildren.js';
 export { Locked } from '../../elements/Locked/index.js';
 export { ListControls } from '../../elements/ListControls/index.js';
 export { useListDrawer } from '../../elements/ListDrawer/index.js';
 export type { ListDrawerProps, ListTogglerProps, RenderListServerFnArgs, RenderListServerFnReturnType, UseListDrawer, } from '../../elements/ListDrawer/types.js';
+export { HierarchyButtonClient } from '../../elements/HierarchyButton/index.js';
+export type { HierarchyButtonClientProps } from '../../elements/HierarchyButton/index.js';
+export { HierarchyFieldClient } from '../../elements/HierarchyField/index.client.js';
+export type { HierarchyFieldClientProps } from '../../elements/HierarchyField/index.client.js';
+export { formatHierarchyDrawerSlug, HierarchyDrawerToggler, useHierarchyDrawer, } from '../../elements/HierarchyDrawer/index.js';
+export type { HierarchyDrawerProps, HierarchyDrawerTogglerProps, SelectionWithPath, UseHierarchyDrawer, UseHierarchyDrawerArgs, } from '../../elements/HierarchyDrawer/types.js';
 export { ListSelection } from '../../views/List/ListSelection/index.js';
 export { CollectionListHeader as ListHeader } from '../../views/List/ListHeader/index.js';
 export { GroupByHeader } from '../../views/List/GroupByHeader/index.js';
@@ -80,6 +95,10 @@ export { GroupByPageControls } from '../../elements/PageControls/GroupByPageCont
 export { LoadingOverlayToggle } from '../../elements/Loading/index.js';
 export { FormLoadingOverlayToggle } from '../../elements/Loading/index.js';
 export { LoadingOverlay } from '../../elements/Loading/index.js';
+export { Spinner } from '../../elements/Spinner/index.js';
+export type { SpinnerProps } from '../../elements/Spinner/index.js';
+export { DelayedSpinner } from '../../elements/DelayedSpinner/index.js';
+export type { DelayedSpinnerProps } from '../../elements/DelayedSpinner/index.js';
 export { Logout } from '../../elements/Logout/index.js';
 export { Modal, useModal } from '../../elements/Modal/index.js';
 export { NavToggler } from '../../elements/Nav/NavToggler/index.js';
@@ -98,13 +117,9 @@ export { PublishButton } from '../../elements/PublishButton/index.js';
 export { SaveButton } from '../../elements/SaveButton/index.js';
 export { SaveDraftButton } from '../../elements/SaveDraftButton/index.js';
 export { UnpublishButton } from '../../elements/UnpublishButton/index.js';
-export { FolderProvider, useFolder } from '../../providers/Folders/index.js';
-export { BrowseByFolderButton } from '../../elements/FolderView/BrowseByFolderButton/index.js';
-export { FolderTypeField } from '../../elements/FolderView/FolderTypeField/index.js';
-export { FolderFileTable } from '../../elements/FolderView/FolderFileTable/index.js';
-export { ItemCardGrid } from '../../elements/FolderView/ItemCardGrid/index.js';
 export { type Option as ReactSelectOption, ReactSelect } from '../../elements/ReactSelect/index.js';
 export { ReactSelect as Select } from '../../elements/ReactSelect/index.js';
+export type { ReactSelectAdapterProps } from '../../elements/ReactSelect/types.js';
 export { RenderTitle } from '../../elements/RenderTitle/index.js';
 export { ShimmerEffect } from '../../elements/ShimmerEffect/index.js';
 export { StaggeredShimmers } from '../../elements/ShimmerEffect/index.js';
@@ -135,12 +150,12 @@ export { PreviewSizes } from '../../elements/PreviewSizes/index.js';
 export { PreviewButton } from '../../elements/PreviewButton/index.js';
 export { RelationshipTable } from '../../elements/RelationshipTable/index.js';
 export { TimezonePicker } from '../../elements/TimezonePicker/index.js';
-export { MoveDocToFolder, MoveDocToFolderButton, } from '../../elements/FolderView/MoveDocToFolder/index.js';
 export { BlocksDrawer } from '../../fields/Blocks/BlocksDrawer/index.js';
 export { BlockSelector } from '../../fields/Blocks/BlockSelector/index.js';
 export { SectionTitle } from '../../fields/Blocks/SectionTitle/index.js';
 export { ItemsDrawer } from '../../elements/ItemsDrawer/index.js';
 export { HiddenField } from '../../fields/Hidden/index.js';
+export { NullField } from '../../fields/Null/index.js';
 export { ArrayField } from '../../fields/Array/index.js';
 export { BlocksField } from '../../fields/Blocks/index.js';
 export { CheckboxField, CheckboxInput } from '../../fields/Checkbox/index.js';
@@ -163,7 +178,7 @@ export { RadioGroupField } from '../../fields/RadioGroup/index.js';
 export { RelationshipField, RelationshipInput } from '../../fields/Relationship/index.js';
 export { RichTextField } from '../../fields/RichText/index.js';
 export { RowField } from '../../fields/Row/index.js';
-export { SelectField, SelectInput } from '../../fields/Select/index.js';
+export { formatOptions, SelectField, SelectInput } from '../../fields/Select/index.js';
 export { TabsField, TabsProvider } from '../../fields/Tabs/index.js';
 export { TabComponent } from '../../fields/Tabs/Tab/index.js';
 export { SlugField } from '../../fields/Slug/index.js';
@@ -177,6 +192,7 @@ export { UIField } from '../../fields/UI/index.js';
 export { UploadField, UploadInput } from '../../fields/Upload/index.js';
 export type { UploadInputProps } from '../../fields/Upload/index.js';
 export { fieldBaseClass } from '../../fields/shared/index.js';
+export { mergeFieldStyles } from '../../fields/mergeFieldStyles.js';
 export { useAllFormFields, useDocumentForm, useForm, useFormBackgroundProcessing, useFormFields, useFormInitializing, useFormModified, useFormProcessing, useFormSubmitted, useWatchForm, } from '../../forms/Form/context.js';
 export { Form, type FormProps } from '../../forms/Form/index.js';
 export type { FieldAction } from '../../forms/Form/types.js';
@@ -214,6 +230,7 @@ export { PlusIcon } from '../../icons/Plus/index.js';
 export { SearchIcon } from '../../icons/Search/index.js';
 export { SwapIcon } from '../../icons/Swap/index.js';
 export { XIcon } from '../../icons/X/index.js';
+export { FilterIcon } from '../../icons/Filter/index.js';
 export { FolderIcon } from '../../icons/Folder/index.js';
 export { GearIcon } from '../../icons/Gear/index.js';
 export { DocumentIcon } from '../../icons/Document/index.js';
@@ -224,6 +241,7 @@ export { Error as ErrorIcon } from '../../providers/ToastContainer/icons/Error.j
 export { Info as InfoIcon } from '../../providers/ToastContainer/icons/Info.js';
 export { Success as SuccessIcon } from '../../providers/ToastContainer/icons/Success.js';
 export { Warning as WarningIcon } from '../../providers/ToastContainer/icons/Warning.js';
+export { TagIcon } from '../../icons/Tag/index.js';
 export { type RenderDocumentResult, type RenderDocumentServerFunction, ServerFunctionsContext, type ServerFunctionsContextType, ServerFunctionsProvider, useServerFunctions, } from '../../providers/ServerFunctions/index.js';
 export { ActionsProvider, useActions } from '../../providers/Actions/index.js';
 export { AuthProvider, useAuth } from '../../providers/Auth/index.js';
@@ -253,6 +271,10 @@ export { RouteCache as RouteCacheProvider, useRouteCache, } from '../../provider
 export { ScrollInfoProvider, useScrollInfo } from '../../providers/ScrollInfo/index.js';
 export { SearchParamsProvider, useSearchParams } from '../../providers/SearchParams/index.js';
 export { SelectionProvider, useSelection } from '../../providers/Selection/index.js';
+export { DocumentSelectionProvider, useDocumentSelection, } from '../../providers/DocumentSelection/index.js';
+export type { CollectionData, DocumentSelectionContextValue, SelectableDocument, } from '../../providers/DocumentSelection/types.js';
+export { HierarchyProvider, useHierarchy } from '../../providers/Hierarchy/index.js';
+export type { AllowedCollection } from '../../providers/Hierarchy/types.js';
 export { UploadHandlersProvider, useUploadHandlers } from '../../providers/UploadHandlers/index.js';
 export type { UploadHandlersContext } from '../../providers/UploadHandlers/index.js';
 export { defaultTheme, type Theme, ThemeProvider, useTheme } from '../../providers/Theme/index.js';
@@ -269,8 +291,7 @@ export { SelectAll } from '../../elements/SelectAll/index.js';
 export { SelectRow } from '../../elements/SelectRow/index.js';
 export { SelectMany } from '../../elements/SelectMany/index.js';
 export { DefaultListView } from '../../views/List/index.js';
-export { DefaultCollectionFolderView } from '../../views/CollectionFolder/index.js';
-export { DefaultBrowseByFolderView } from '../../views/BrowseByFolder/index.js';
+export { HierarchyListView } from '../../views/HierarchyList/index.js';
 export type { 
 /**
  * @deprecated