@payloadcms/ui 3.84.1 → 4.0.0-internal.d28e9fb

package/dist/elements/Hierarchy/ColumnBrowser/index.scss

@@ -0,0 +1,20 @@
+.hierarchy-column-browser {
+  display: flex;
+  flex: 1;
+  overflow-x: auto;
+  // scroll-snap-type: x proximity;
+
+  &__column-wrapper {
+    // scroll-snap-align: start;
+    flex-shrink: 0;
+
+    &:first-child {
+      margin-left: var(--gutter-h);
+      border-left: 1px solid var(--theme-elevation-100);
+    }
+  }
+
+  &__column-wrapper--loading {
+    padding: calc(var(--base) * 0.8) var(--base);
+  }
+}

package/dist/elements/Hierarchy/ColumnBrowser/types.d.ts

@@ -0,0 +1,106 @@
+import type { Where } from 'payload';
+export type ColumnItemData = {
+    /** For folders with collectionSpecific config, the allowed collection slugs */
+    allowedCollections?: string[];
+    hasChildren: boolean;
+    id: number | string;
+    title: string;
+};
+export type PathSegment = {
+    id: number | string;
+    title: string;
+};
+export type ColumnItemProps = {
+    disabled?: boolean;
+    /** Required collections that the folder must allow (for superset check) */
+    filterByCollection?: string[];
+    hasSelectedDescendants: boolean;
+    isExpanded: boolean;
+    isSelected: boolean;
+    item: ColumnItemData;
+    onExpand: (params: {
+        id: number | string;
+    }) => void;
+    onSelect: (params: {
+        id: number | string;
+    }) => void;
+};
+export type ColumnProps = {
+    ancestorsWithSelections: Set<number | string>;
+    /** Whether user can create new documents */
+    canCreate: boolean;
+    /** Label for the collection (e.g., "Folder") */
+    collectionLabel: string;
+    disabled?: boolean;
+    /** IDs that should be disabled (e.g., items being moved can't be selected as destination) */
+    disabledIds?: Set<number | string>;
+    expandedId: null | number | string;
+    /** Required collections for superset check (passed to ColumnItem) */
+    filterByCollection?: string[];
+    hasNextPage: boolean;
+    isLoading: boolean;
+    items: ColumnItemData[];
+    /** Called when user clicks "New" button - parent should open drawer with parentId */
+    onCreateNew: (params: {
+        parentId: null | number | string;
+    }) => void;
+    onExpand: (params: {
+        id: number | string;
+    }) => void;
+    onLoadMore: () => void;
+    onSelect: (params: {
+        id: number | string;
+        path: PathSegment[];
+    }) => void;
+    parentId: null | number | string;
+    parentTitle?: string;
+    pathToColumn: PathSegment[];
+    selectedIds: Set<number | string>;
+    totalDocs: number;
+};
+export type ColumnState = {
+    hasNextPage: boolean;
+    isLoading: boolean;
+    items: ColumnItemData[];
+    page: number;
+    parentId: null | number | string;
+    parentTitle?: string;
+    totalDocs: number;
+};
+export type HierarchyColumnBrowserRef = {
+    /** Refetch a specific column by parentId */
+    refreshColumn: (parentId: null | number | string) => Promise<void>;
+};
+export type HierarchyColumnBrowserProps = {
+    ancestorsWithSelections: Set<number | string>;
+    /** Base filter constraint (e.g., tenant filter) to apply to all queries */
+    baseFilter?: null | Where;
+    /** IDs that should be disabled (e.g., items being moved can't be selected as destination) */
+    disabledIds?: Set<number | string>;
+    /**
+     * Filters hierarchy items based on collection type restrictions:
+     * - `undefined`: No filtering, show all folders
+     * - `[]` (empty array): No filtering, show all folders (no constraints)
+     * - `['posts', ...]`: Show folders accepting ANY of these collections OR unrestricted folders
+     *
+     * Note: Query uses ANY semantics due to PG hasMany enum limitations.
+     * Client-side enforcement can disable selection of folders that don't allow ALL required collections.
+     */
+    filterByCollection?: string[];
+    hierarchyCollectionSlug: string;
+    initialExpandedPath?: (number | string)[];
+    /** Whether the initial expanded path is still being loaded */
+    isLoadingPath?: boolean;
+    /** Called when user clicks "New" button to create a new item */
+    onCreateNew?: (params: {
+        parentId: null | number | string;
+    }) => void;
+    onSelect: (params: {
+        id: number | string;
+        path: PathSegment[];
+    }) => void;
+    parentFieldName: string;
+    selectedIds: Set<number | string>;
+    useAsTitle?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/Hierarchy/ColumnBrowser/types.d.ts.map

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

package/dist/elements/Hierarchy/ColumnBrowser/types.js

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

package/dist/elements/Hierarchy/ColumnBrowser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/elements/Hierarchy/ColumnBrowser/types.ts"],"sourcesContent":["import type { Where } from 'payload'\nimport type React from 'react'\n\nexport type ColumnItemData = {\n  /** For folders with collectionSpecific config, the allowed collection slugs */\n  allowedCollections?: string[]\n  hasChildren: boolean\n  id: number | string\n  title: string\n}\n\nexport type PathSegment = {\n  id: number | string\n  title: string\n}\n\nexport type ColumnItemProps = {\n  disabled?: boolean\n  /** Required collections that the folder must allow (for superset check) */\n  filterByCollection?: string[]\n  hasSelectedDescendants: boolean\n  isExpanded: boolean\n  isSelected: boolean\n  item: ColumnItemData\n  onExpand: (params: { id: number | string }) => void\n  onSelect: (params: { id: number | string }) => void\n}\n\nexport type ColumnProps = {\n  ancestorsWithSelections: Set<number | string>\n  /** Whether user can create new documents */\n  canCreate: boolean\n  /** Label for the collection (e.g., \"Folder\") */\n  collectionLabel: string\n  disabled?: boolean\n  /** IDs that should be disabled (e.g., items being moved can't be selected as destination) */\n  disabledIds?: Set<number | string>\n  expandedId: null | number | string\n  /** Required collections for superset check (passed to ColumnItem) */\n  filterByCollection?: string[]\n  hasNextPage: boolean\n  isLoading: boolean\n  items: ColumnItemData[]\n  /** Called when user clicks \"New\" button - parent should open drawer with parentId */\n  onCreateNew: (params: { parentId: null | number | string }) => void\n  onExpand: (params: { id: number | string }) => void\n  onLoadMore: () => void\n  onSelect: (params: { id: number | string; path: PathSegment[] }) => void\n  parentId: null | number | string\n  parentTitle?: string\n  pathToColumn: PathSegment[]\n  selectedIds: Set<number | string>\n  totalDocs: number\n}\n\nexport type ColumnState = {\n  hasNextPage: boolean\n  isLoading: boolean\n  items: ColumnItemData[]\n  page: number\n  parentId: null | number | string\n  parentTitle?: string\n  totalDocs: number\n}\n\nexport type HierarchyColumnBrowserRef = {\n  /** Refetch a specific column by parentId */\n  refreshColumn: (parentId: null | number | string) => Promise<void>\n}\n\nexport type HierarchyColumnBrowserProps = {\n  ancestorsWithSelections: Set<number | string>\n  /** Base filter constraint (e.g., tenant filter) to apply to all queries */\n  baseFilter?: null | Where\n  /** IDs that should be disabled (e.g., items being moved can't be selected as destination) */\n  disabledIds?: Set<number | string>\n  /**\n   * Filters hierarchy items based on collection type restrictions:\n   * - `undefined`: No filtering, show all folders\n   * - `[]` (empty array): No filtering, show all folders (no constraints)\n   * - `['posts', ...]`: Show folders accepting ANY of these collections OR unrestricted folders\n   *\n   * Note: Query uses ANY semantics due to PG hasMany enum limitations.\n   * Client-side enforcement can disable selection of folders that don't allow ALL required collections.\n   */\n  filterByCollection?: string[]\n  hierarchyCollectionSlug: string\n  initialExpandedPath?: (number | string)[]\n  /** Whether the initial expanded path is still being loaded */\n  isLoadingPath?: boolean\n  /** Called when user clicks \"New\" button to create a new item */\n  onCreateNew?: (params: { parentId: null | number | string }) => void\n  onSelect: (params: { id: number | string; path: PathSegment[] }) => void\n  parentFieldName: string\n  selectedIds: Set<number | string>\n  useAsTitle?: string\n}\n"],"mappings":"AAsEA","ignoreList":[]}

package/dist/elements/Hierarchy/DocHeaderButton/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import './index.scss';
+export type HierarchyButtonClientProps = {
+    fieldName: string;
+    hasMany?: boolean;
+    hierarchyCollectionSlug: string;
+    Icon?: React.ReactNode;
+    readOnly?: boolean;
+};
+export declare const HierarchyButtonClient: React.FC<HierarchyButtonClientProps>;
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Hierarchy/DocHeaderButton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/DocHeaderButton/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoD,MAAM,OAAO,CAAA;AAUxE,OAAO,cAAc,CAAA;AAIrB,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CA+HtE,CAAA"}

package/dist/elements/Hierarchy/DocHeaderButton/index.js

@@ -0,0 +1,126 @@
+'use client';
+
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { formatAdminURL } from 'payload/shared';
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import { useForm, useFormFields } from '../../../forms/Form/context.js';
+import { useConfig } from '../../../providers/Config/index.js';
+import { useDocumentInfo } from '../../../providers/DocumentInfo/index.js';
+import { useTranslation } from '../../../providers/Translation/index.js';
+import { Button } from '../../Button/index.js';
+import { useHierarchyDrawer } from '../Drawer/useHierarchyDrawer.js';
+import './index.scss';
+const baseClass = 'hierarchy-button';
+export const HierarchyButtonClient = ({
+  fieldName,
+  hasMany = false,
+  hierarchyCollectionSlug,
+  Icon,
+  readOnly
+}) => {
+  const {
+    t
+  } = useTranslation();
+  const {
+    config,
+    getEntityConfig
+  } = useConfig();
+  const {
+    collectionSlug: documentCollectionSlug
+  } = useDocumentInfo();
+  const {
+    setModified
+  } = useForm();
+  const dispatchField = useFormFields(([_, dispatch]) => dispatch);
+  const currentFieldValue = useFormFields(([fields]) => fields && fields?.[fieldName] || null);
+  const currentId = currentFieldValue?.value;
+  const [displayName, setDisplayName] = useState('');
+  const [isLoading, setIsLoading] = useState(true);
+  const collectionConfig = getEntityConfig({
+    collectionSlug: hierarchyCollectionSlug
+  });
+  const useAsTitle = collectionConfig?.admin?.useAsTitle || 'name';
+  const isHierarchyCollection = documentCollectionSlug === hierarchyCollectionSlug;
+  // When in hierarchy collection, let the drawer use allowedCollections from context
+  // When in other collections, filter by that collection's slug
+  // Memoize to prevent new array references on every render
+  const filterByCollection = useMemo(() => isHierarchyCollection || !documentCollectionSlug ? undefined : [documentCollectionSlug], [isHierarchyCollection, documentCollectionSlug]);
+  const [HierarchyDrawer,, {
+    openDrawer
+  }] = useHierarchyDrawer({
+    filterByCollection,
+    hierarchyCollectionSlug,
+    Icon
+  });
+  // Fetch item name when currentId changes
+  useEffect(() => {
+    const fetchItemName = async () => {
+      if (currentId && (typeof currentId === 'string' || typeof currentId === 'number')) {
+        setIsLoading(true);
+        try {
+          const response = await fetch(formatAdminURL({
+            apiRoute: config.routes.api,
+            path: `/${hierarchyCollectionSlug}/${currentId}`,
+            serverURL: config.serverURL
+          }), {
+            credentials: 'include'
+          });
+          if (response.ok) {
+            const itemData = await response.json();
+            const title = itemData?.[useAsTitle] || itemData?.name || itemData?.id;
+            setDisplayName(String(title));
+          } else {
+            setDisplayName(t('general:none'));
+          }
+        } catch {
+          setDisplayName(t('general:none'));
+        } finally {
+          setIsLoading(false);
+        }
+      } else {
+        setDisplayName(t('general:none'));
+        setIsLoading(false);
+      }
+    };
+    void fetchItemName();
+  }, [currentId, hierarchyCollectionSlug, config.routes.api, config.serverURL, useAsTitle, t]);
+  const handleDrawerSave = useCallback(({
+    closeDrawer,
+    selections
+  }) => {
+    const ids = Array.from(selections.keys());
+    const newValue = hasMany ? ids : ids[0] ?? null;
+    if (currentFieldValue?.value !== newValue) {
+      dispatchField({
+        type: 'UPDATE',
+        path: fieldName,
+        value: newValue
+      });
+      setModified(true);
+    }
+    closeDrawer();
+  }, [currentFieldValue?.value, dispatchField, fieldName, hasMany, setModified]);
+  const handleClick = useCallback(() => {
+    if (!readOnly) {
+      openDrawer();
+    }
+  }, [openDrawer, readOnly]);
+  const label = isLoading ? `${t('general:loading')}...` : displayName;
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(Button, {
+      buttonStyle: "subtle",
+      className: [baseClass, readOnly && `${baseClass}--read-only`].filter(Boolean).join(' '),
+      disabled: readOnly,
+      icon: Icon,
+      iconPosition: "left",
+      margin: false,
+      onClick: handleClick,
+      children: label
+    }), /*#__PURE__*/_jsx(HierarchyDrawer, {
+      hasMany: hasMany,
+      initialSelections: currentId ? [currentId] : undefined,
+      onSave: handleDrawerSave
+    })]
+  });
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/Hierarchy/DocHeaderButton/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["formatAdminURL","React","useCallback","useEffect","useMemo","useState","useForm","useFormFields","useConfig","useDocumentInfo","useTranslation","Button","useHierarchyDrawer","baseClass","HierarchyButtonClient","fieldName","hasMany","hierarchyCollectionSlug","Icon","readOnly","t","config","getEntityConfig","collectionSlug","documentCollectionSlug","setModified","dispatchField","_","dispatch","currentFieldValue","fields","currentId","value","displayName","setDisplayName","isLoading","setIsLoading","collectionConfig","useAsTitle","admin","isHierarchyCollection","filterByCollection","undefined","HierarchyDrawer","openDrawer","fetchItemName","response","fetch","apiRoute","routes","api","path","serverURL","credentials","ok","itemData","json","title","name","id","String","handleDrawerSave","closeDrawer","selections","ids","Array","from","keys","newValue","type","handleClick","label","_jsxs","_Fragment","_jsx","buttonStyle","className","filter","Boolean","join","disabled","icon","iconPosition","margin","onClick","initialSelections","onSave"],"sources":["../../../../src/elements/Hierarchy/DocHeaderButton/index.tsx"],"sourcesContent":["'use client'\nimport { formatAdminURL } from 'payload/shared'\nimport React, { useCallback, useEffect, useMemo, useState } from 'react'\n\nimport type { SelectionWithPath } from '../Drawer/types.js'\n\nimport { useForm, useFormFields } from '../../../forms/Form/context.js'\nimport { useConfig } from '../../../providers/Config/index.js'\nimport { useDocumentInfo } from '../../../providers/DocumentInfo/index.js'\nimport { useTranslation } from '../../../providers/Translation/index.js'\nimport { Button } from '../../Button/index.js'\nimport { useHierarchyDrawer } from '../Drawer/useHierarchyDrawer.js'\nimport './index.scss'\n\nconst baseClass = 'hierarchy-button'\n\nexport type HierarchyButtonClientProps = {\n  fieldName: string\n  hasMany?: boolean\n  hierarchyCollectionSlug: string\n  Icon?: React.ReactNode\n  readOnly?: boolean\n}\n\nexport const HierarchyButtonClient: React.FC<HierarchyButtonClientProps> = ({\n  fieldName,\n  hasMany = false,\n  hierarchyCollectionSlug,\n  Icon,\n  readOnly,\n}) => {\n  const { t } = useTranslation()\n  const { config, getEntityConfig } = useConfig()\n  const { collectionSlug: documentCollectionSlug } = useDocumentInfo()\n  const { setModified } = useForm()\n  const dispatchField = useFormFields(([_, dispatch]) => dispatch)\n\n  const currentFieldValue = useFormFields(([fields]) => (fields && fields?.[fieldName]) || null)\n  const currentId = currentFieldValue?.value as null | number | string\n\n  const [displayName, setDisplayName] = useState<string>('')\n  const [isLoading, setIsLoading] = useState(true)\n\n  const collectionConfig = getEntityConfig({ collectionSlug: hierarchyCollectionSlug })\n  const useAsTitle = collectionConfig?.admin?.useAsTitle || 'name'\n\n  const isHierarchyCollection = documentCollectionSlug === hierarchyCollectionSlug\n\n  // When in hierarchy collection, let the drawer use allowedCollections from context\n  // When in other collections, filter by that collection's slug\n  // Memoize to prevent new array references on every render\n  const filterByCollection = useMemo(\n    () => (isHierarchyCollection || !documentCollectionSlug ? undefined : [documentCollectionSlug]),\n    [isHierarchyCollection, documentCollectionSlug],\n  )\n\n  const [HierarchyDrawer, , { openDrawer }] = useHierarchyDrawer({\n    filterByCollection,\n    hierarchyCollectionSlug,\n    Icon,\n  })\n\n  // Fetch item name when currentId changes\n  useEffect(() => {\n    const fetchItemName = async () => {\n      if (currentId && (typeof currentId === 'string' || typeof currentId === 'number')) {\n        setIsLoading(true)\n        try {\n          const response = await fetch(\n            formatAdminURL({\n              apiRoute: config.routes.api,\n              path: `/${hierarchyCollectionSlug}/${currentId}`,\n              serverURL: config.serverURL,\n            }),\n            { credentials: 'include' },\n          )\n\n          if (response.ok) {\n            const itemData = await response.json()\n            const title = itemData?.[useAsTitle] || itemData?.name || itemData?.id\n\n            setDisplayName(String(title))\n          } else {\n            setDisplayName(t('general:none'))\n          }\n        } catch {\n          setDisplayName(t('general:none'))\n        } finally {\n          setIsLoading(false)\n        }\n      } else {\n        setDisplayName(t('general:none'))\n        setIsLoading(false)\n      }\n    }\n\n    void fetchItemName()\n  }, [currentId, hierarchyCollectionSlug, config.routes.api, config.serverURL, useAsTitle, t])\n\n  const handleDrawerSave = useCallback(\n    ({\n      closeDrawer,\n      selections,\n    }: {\n      closeDrawer: () => void\n      selections: Map<number | string, SelectionWithPath>\n    }) => {\n      const ids = Array.from(selections.keys())\n      const newValue = hasMany ? ids : (ids[0] ?? null)\n\n      if (currentFieldValue?.value !== newValue) {\n        dispatchField({\n          type: 'UPDATE',\n          path: fieldName,\n          value: newValue,\n        })\n        setModified(true)\n      }\n      closeDrawer()\n    },\n    [currentFieldValue?.value, dispatchField, fieldName, hasMany, setModified],\n  )\n\n  const handleClick = useCallback(() => {\n    if (!readOnly) {\n      openDrawer()\n    }\n  }, [openDrawer, readOnly])\n\n  const label = isLoading ? `${t('general:loading')}...` : displayName\n\n  return (\n    <>\n      <Button\n        buttonStyle=\"subtle\"\n        className={[baseClass, readOnly && `${baseClass}--read-only`].filter(Boolean).join(' ')}\n        disabled={readOnly}\n        icon={Icon}\n        iconPosition=\"left\"\n        margin={false}\n        onClick={handleClick}\n      >\n        {label}\n      </Button>\n      <HierarchyDrawer\n        hasMany={hasMany}\n        initialSelections={currentId ? [currentId] : undefined}\n        onSave={handleDrawerSave}\n      />\n    </>\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/{FolderView/MoveDocToFolder → Hierarchy/DocHeaderButton}/index.scss

@@ -1,6 +1,7 @@
 @layer payload-default {
-  .move-doc-to-folder {
+  .hierarchy-button {
     margin: 0;
+
     .btn__icon {
       color: var(--theme-elevation-300);
     }
@@ -8,5 +9,10 @@
     .btn__label {
       font-weight: 600;
     }
+
+    &--read-only {
+      cursor: default;
+      opacity: 0.7;
+    }
   }
 }

package/dist/elements/Hierarchy/DocHeaderButton/index.server.d.ts

@@ -0,0 +1,10 @@
+import type { Payload } from 'payload';
+import React from 'react';
+export type HierarchyButtonServerProps = {
+    fieldName: string;
+    hasMany?: boolean;
+    hierarchyCollectionSlug: string;
+    payload: Payload;
+};
+export declare const HierarchyButton: React.FC<HierarchyButtonServerProps>;
+//# sourceMappingURL=index.server.d.ts.map

package/dist/elements/Hierarchy/DocHeaderButton/index.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.server.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/DocHeaderButton/index.server.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAqChE,CAAA"}

package/dist/elements/Hierarchy/DocHeaderButton/index.server.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { FolderIcon } from '../../../icons/Folder/index.js';
+import { RenderServerComponent } from '../../RenderServerComponent/index.js';
+// eslint-disable-next-line payload/no-imports-from-exports-dir -- Server component must reference exports dir for proper client boundary
+import { HierarchyButtonClient } from '../../../exports/client/index.js';
+export const HierarchyButton = ({
+  fieldName,
+  hasMany,
+  hierarchyCollectionSlug,
+  payload
+}) => {
+  const hierarchyCollectionConfig = payload.config.collections.find(c => c.slug === hierarchyCollectionSlug);
+  const hierarchyConfig = hierarchyCollectionConfig?.hierarchy && typeof hierarchyCollectionConfig.hierarchy === 'object' ? hierarchyCollectionConfig.hierarchy : undefined;
+  const IconComponent = hierarchyConfig?.admin.components.Icon;
+  // Render the custom icon if provided, otherwise use FolderIcon directly
+  // Important: Must render the icon here on server to avoid hydration mismatch
+  // For default FolderIcon path, render directly to avoid import map requirement
+  const isDefaultFolderIcon = !IconComponent || IconComponent === '@payloadcms/ui#FolderIcon';
+  const renderedIcon = isDefaultFolderIcon ? /*#__PURE__*/_jsx(FolderIcon, {
+    color: "muted"
+  }) : RenderServerComponent({
+    Component: IconComponent,
+    importMap: payload.importMap,
+    key: `hierarchy-button-icon-${hierarchyCollectionSlug}`
+  });
+  return /*#__PURE__*/_jsx(HierarchyButtonClient, {
+    fieldName: fieldName,
+    hasMany: hasMany,
+    hierarchyCollectionSlug: hierarchyCollectionSlug,
+    Icon: renderedIcon
+  });
+};
+//# sourceMappingURL=index.server.js.map

package/dist/elements/Hierarchy/DocHeaderButton/index.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.server.js","names":["React","FolderIcon","RenderServerComponent","HierarchyButtonClient","HierarchyButton","fieldName","hasMany","hierarchyCollectionSlug","payload","hierarchyCollectionConfig","config","collections","find","c","slug","hierarchyConfig","hierarchy","undefined","IconComponent","admin","components","Icon","isDefaultFolderIcon","renderedIcon","_jsx","color","Component","importMap","key"],"sources":["../../../../src/elements/Hierarchy/DocHeaderButton/index.server.tsx"],"sourcesContent":["import type { Payload } from 'payload'\n\nimport React from 'react'\n\nimport { FolderIcon } from '../../../icons/Folder/index.js'\nimport { RenderServerComponent } from '../../RenderServerComponent/index.js'\n// eslint-disable-next-line payload/no-imports-from-exports-dir -- Server component must reference exports dir for proper client boundary\nimport { HierarchyButtonClient } from '../../../exports/client/index.js'\n\nexport type HierarchyButtonServerProps = {\n  fieldName: string\n  hasMany?: boolean\n  hierarchyCollectionSlug: string\n  payload: Payload\n}\n\nexport const HierarchyButton: React.FC<HierarchyButtonServerProps> = ({\n  fieldName,\n  hasMany,\n  hierarchyCollectionSlug,\n  payload,\n}) => {\n  const hierarchyCollectionConfig = payload.config.collections.find(\n    (c) => c.slug === hierarchyCollectionSlug,\n  )\n  const hierarchyConfig =\n    hierarchyCollectionConfig?.hierarchy && typeof hierarchyCollectionConfig.hierarchy === 'object'\n      ? hierarchyCollectionConfig.hierarchy\n      : undefined\n  const IconComponent = hierarchyConfig?.admin.components.Icon\n\n  // Render the custom icon if provided, otherwise use FolderIcon directly\n  // Important: Must render the icon here on server to avoid hydration mismatch\n  // For default FolderIcon path, render directly to avoid import map requirement\n  const isDefaultFolderIcon = !IconComponent || IconComponent === '@payloadcms/ui#FolderIcon'\n  const renderedIcon = isDefaultFolderIcon ? (\n    <FolderIcon color=\"muted\" />\n  ) : (\n    RenderServerComponent({\n      Component: IconComponent,\n      importMap: payload.importMap,\n      key: `hierarchy-button-icon-${hierarchyCollectionSlug}`,\n    })\n  )\n\n  return (\n    <HierarchyButtonClient\n      fieldName={fieldName}\n      hasMany={hasMany}\n      hierarchyCollectionSlug={hierarchyCollectionSlug}\n      Icon={renderedIcon}\n    />\n  )\n}\n"],"mappings":";AAEA,OAAOA,KAAA,MAAW;AAElB,SAASC,UAAU,QAAQ;AAC3B,SAASC,qBAAqB,QAAQ;AACtC;AACA,SAASC,qBAAqB,QAAQ;AAStC,OAAO,MAAMC,eAAA,GAAwDA,CAAC;EACpEC,SAAS;EACTC,OAAO;EACPC,uBAAuB;EACvBC;AAAO,CACR;EACC,MAAMC,yBAAA,GAA4BD,OAAA,CAAQE,MAAM,CAACC,WAAW,CAACC,IAAI,CAC9DC,CAAA,IAAMA,CAAA,CAAEC,IAAI,KAAKP,uBAAA;EAEpB,MAAMQ,eAAA,GACJN,yBAAA,EAA2BO,SAAA,IAAa,OAAOP,yBAAA,CAA0BO,SAAS,KAAK,WACnFP,yBAAA,CAA0BO,SAAS,GACnCC,SAAA;EACN,MAAMC,aAAA,GAAgBH,eAAA,EAAiBI,KAAA,CAAMC,UAAA,CAAWC,IAAA;EAExD;EACA;EACA;EACA,MAAMC,mBAAA,GAAsB,CAACJ,aAAA,IAAiBA,aAAA,KAAkB;EAChE,MAAMK,YAAA,GAAeD,mBAAA,gBACnBE,IAAA,CAACvB,UAAA;IAAWwB,KAAA,EAAM;OAElBvB,qBAAA,CAAsB;IACpBwB,SAAA,EAAWR,aAAA;IACXS,SAAA,EAAWnB,OAAA,CAAQmB,SAAS;IAC5BC,GAAA,EAAK,yBAAyBrB,uBAAA;EAChC;EAGF,oBACEiB,IAAA,CAACrB,qBAAA;IACCE,SAAA,EAAWA,SAAA;IACXC,OAAA,EAASA,OAAA;IACTC,uBAAA,EAAyBA,uBAAA;IACzBc,IAAA,EAAME;;AAGZ","ignoreList":[]}

package/dist/elements/Hierarchy/Drawer/fetchAncestorPath.d.ts

@@ -0,0 +1,15 @@
+type FetchAncestorPathArgs = {
+    api: string;
+    collectionSlug: string;
+    itemId: number | string;
+    parentFieldName: string;
+    serverURL: string;
+};
+/**
+ * Fetches the ancestor path for an item using a single API call with depth.
+ * Returns array of ancestor IDs from root to item's parent.
+ * Example: item at level 3 returns [grandparentId, parentId]
+ */
+export declare function fetchAncestorPath({ api, collectionSlug, itemId, parentFieldName, serverURL, }: FetchAncestorPathArgs): Promise<(number | string)[]>;
+export {};
+//# sourceMappingURL=fetchAncestorPath.d.ts.map

package/dist/elements/Hierarchy/Drawer/fetchAncestorPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAncestorPath.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/Drawer/fetchAncestorPath.ts"],"names":[],"mappings":"AAGA,KAAK,qBAAqB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAID;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,GAAG,EACH,cAAc,EACd,MAAM,EACN,eAAe,EACf,SAAS,GACV,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CA+CtD"}

package/dist/elements/Hierarchy/Drawer/fetchAncestorPath.js

@@ -0,0 +1,60 @@
+import { formatAdminURL } from 'payload/shared';
+import * as qs from 'qs-esm';
+const MAX_HIERARCHY_DEPTH = 20;
+/**
+ * Fetches the ancestor path for an item using a single API call with depth.
+ * Returns array of ancestor IDs from root to item's parent.
+ * Example: item at level 3 returns [grandparentId, parentId]
+ */
+export async function fetchAncestorPath({
+  api,
+  collectionSlug,
+  itemId,
+  parentFieldName,
+  serverURL
+}) {
+  const queryString = qs.stringify({
+    depth: MAX_HIERARCHY_DEPTH,
+    limit: 1,
+    select: {
+      [parentFieldName]: true
+    },
+    where: {
+      id: {
+        equals: itemId
+      }
+    }
+  }, {
+    addQueryPrefix: true
+  });
+  const url = formatAdminURL({
+    apiRoute: api,
+    path: `/${collectionSlug}${queryString}`,
+    serverURL
+  });
+  const response = await fetch(url, {
+    credentials: 'include'
+  });
+  if (!response.ok) {
+    return [];
+  }
+  const data = await response.json();
+  const doc = data.docs?.[0];
+  if (!doc) {
+    return [];
+  }
+  // Walk the nested parent chain to build path from root to immediate parent
+  const path = [];
+  let current = doc[parentFieldName];
+  while (current !== null && current !== undefined) {
+    // Parent could be an ID (number/string) or a populated object
+    const parentId = typeof current === 'object' ? current.id : current;
+    if (parentId !== null && parentId !== undefined) {
+      path.unshift(parentId);
+    }
+    // Move to next parent (only if current is populated object)
+    current = typeof current === 'object' ? current[parentFieldName] : null;
+  }
+  return path;
+}
+//# sourceMappingURL=fetchAncestorPath.js.map

package/dist/elements/Hierarchy/Drawer/fetchAncestorPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAncestorPath.js","names":["formatAdminURL","qs","MAX_HIERARCHY_DEPTH","fetchAncestorPath","api","collectionSlug","itemId","parentFieldName","serverURL","queryString","stringify","depth","limit","select","where","id","equals","addQueryPrefix","url","apiRoute","path","response","fetch","credentials","ok","data","json","doc","docs","current","undefined","parentId","unshift"],"sources":["../../../../src/elements/Hierarchy/Drawer/fetchAncestorPath.ts"],"sourcesContent":["import { formatAdminURL } from 'payload/shared'\nimport * as qs from 'qs-esm'\n\ntype FetchAncestorPathArgs = {\n  api: string\n  collectionSlug: string\n  itemId: number | string\n  parentFieldName: string\n  serverURL: string\n}\n\nconst MAX_HIERARCHY_DEPTH = 20\n\n/**\n * Fetches the ancestor path for an item using a single API call with depth.\n * Returns array of ancestor IDs from root to item's parent.\n * Example: item at level 3 returns [grandparentId, parentId]\n */\nexport async function fetchAncestorPath({\n  api,\n  collectionSlug,\n  itemId,\n  parentFieldName,\n  serverURL,\n}: FetchAncestorPathArgs): Promise<(number | string)[]> {\n  const queryString = qs.stringify(\n    {\n      depth: MAX_HIERARCHY_DEPTH,\n      limit: 1,\n      select: { [parentFieldName]: true },\n      where: { id: { equals: itemId } },\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    return []\n  }\n\n  const data = await response.json()\n  const doc = data.docs?.[0]\n\n  if (!doc) {\n    return []\n  }\n\n  // Walk the nested parent chain to build path from root to immediate parent\n  const path: (number | string)[] = []\n  let current = doc[parentFieldName]\n\n  while (current !== null && current !== undefined) {\n    // Parent could be an ID (number/string) or a populated object\n    const parentId = typeof current === 'object' ? current.id : current\n\n    if (parentId !== null && parentId !== undefined) {\n      path.unshift(parentId)\n    }\n\n    // Move to next parent (only if current is populated object)\n    current = typeof current === 'object' ? current[parentFieldName] : null\n  }\n\n  return path\n}\n"],"mappings":"AAAA,SAASA,cAAc,QAAQ;AAC/B,YAAYC,EAAA,MAAQ;AAUpB,MAAMC,mBAAA,GAAsB;AAE5B;;;;;AAKA,OAAO,eAAeC,kBAAkB;EACtCC,GAAG;EACHC,cAAc;EACdC,MAAM;EACNC,eAAe;EACfC;AAAS,CACa;EACtB,MAAMC,WAAA,GAAcR,EAAA,CAAGS,SAAS,CAC9B;IACEC,KAAA,EAAOT,mBAAA;IACPU,KAAA,EAAO;IACPC,MAAA,EAAQ;MAAE,CAACN,eAAA,GAAkB;IAAK;IAClCO,KAAA,EAAO;MAAEC,EAAA,EAAI;QAAEC,MAAA,EAAQV;MAAO;IAAE;EAClC,GACA;IAAEW,cAAA,EAAgB;EAAK;EAGzB,MAAMC,GAAA,GAAMlB,cAAA,CAAe;IACzBmB,QAAA,EAAUf,GAAA;IACVgB,IAAA,EAAM,IAAIf,cAAA,GAAiBI,WAAA,EAAa;IACxCD;EACF;EAEA,MAAMa,QAAA,GAAW,MAAMC,KAAA,CAAMJ,GAAA,EAAK;IAAEK,WAAA,EAAa;EAAU;EAE3D,IAAI,CAACF,QAAA,CAASG,EAAE,EAAE;IAChB,OAAO,EAAE;EACX;EAEA,MAAMC,IAAA,GAAO,MAAMJ,QAAA,CAASK,IAAI;EAChC,MAAMC,GAAA,GAAMF,IAAA,CAAKG,IAAI,GAAG,EAAE;EAE1B,IAAI,CAACD,GAAA,EAAK;IACR,OAAO,EAAE;EACX;EAEA;EACA,MAAMP,IAAA,GAA4B,EAAE;EACpC,IAAIS,OAAA,GAAUF,GAAG,CAACpB,eAAA,CAAgB;EAElC,OAAOsB,OAAA,KAAY,QAAQA,OAAA,KAAYC,SAAA,EAAW;IAChD;IACA,MAAMC,QAAA,GAAW,OAAOF,OAAA,KAAY,WAAWA,OAAA,CAAQd,EAAE,GAAGc,OAAA;IAE5D,IAAIE,QAAA,KAAa,QAAQA,QAAA,KAAaD,SAAA,EAAW;MAC/CV,IAAA,CAAKY,OAAO,CAACD,QAAA;IACf;IAEA;IACAF,OAAA,GAAU,OAAOA,OAAA,KAAY,WAAWA,OAAO,CAACtB,eAAA,CAAgB,GAAG;EACrE;EAEA,OAAOa,IAAA;AACT","ignoreList":[]}

package/dist/elements/Hierarchy/Drawer/index.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { HierarchyColumnBrowserRef } from '../ColumnBrowser/index.js';
+import type { HierarchyDrawerInternalProps } from './types.js';
+import './index.scss';
+export declare const baseClass = "hierarchy-drawer";
+type HierarchyDrawerContentProps = {
+    columnBrowserRef?: React.RefObject<HierarchyColumnBrowserRef | null>;
+    onCreateNew?: (params: {
+        parentId: null | number | string;
+    }) => void;
+} & HierarchyDrawerInternalProps;
+export type HierarchyDrawerContentRef = {
+    selectItem: (id: number | string) => void;
+};
+export declare const HierarchyDrawerContent: ({ baseFilter, closeDrawer, columnBrowserRef, disabledIds, filterByCollection, hasMany, hierarchyCollectionSlug, Icon, initialSelections, onCreateNew, onMoveToRoot, onSave, parentFieldName, ref, showMoveToRoot, useAsTitle, }: {
+    ref?: React.RefObject<HierarchyDrawerContentRef | null>;
+} & HierarchyDrawerContentProps) => React.JSX.Element;
+export declare const HierarchyDrawer: React.FC<HierarchyDrawerInternalProps>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Hierarchy/Drawer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/Hierarchy/Drawer/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAON,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAC1E,OAAO,KAAK,EAAE,4BAA4B,EAAqB,MAAM,YAAY,CAAA;AAYjF,OAAO,cAAc,CAAA;AAErB,eAAO,MAAM,SAAS,qBAAqB,CAAA;AAE3C,KAAK,2BAA2B,GAAG;IACjC,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IACpE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACrE,GAAG,4BAA4B,CAAA;AAEhC,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;CAC1C,CAAA;AAED,eAAO,MAAM,sBAAsB,oOAiBhC;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CAAE,GAAG,2BAA2B,sBAwL3F,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8FlE,CAAA"}