payload 3.91.0-internal.c1569dc → 4.0.0-beta.0

package/dist/globals/operations/validate.js

@@ -0,0 +1,133 @@
+import { executeAccess } from '../../auth/executeAccess.js';
+import { hasWhereAccessResult } from '../../auth/types.js';
+import { Forbidden } from '../../errors/index.js';
+import { afterRead } from '../../fields/hooks/afterRead/index.js';
+import { deepCopyObjectSimple } from '../../utilities/deepCopyObject.js';
+import { flattenDataByLocale } from '../../utilities/flattenDataByLocale.js';
+import { runValidationLifecycle } from '../../utilities/runValidationLifecycle.js';
+import { findDraftVersion, getDocumentFromDraftVersion } from '../../versions/drafts/replaceWithDraftIfAvailable.js';
+export async function validateOperation(args) {
+    const previousOperation = args.req.operation;
+    args.req.operation = args.validationOperation ?? 'validate';
+    try {
+        return await validateOperationWithScopedRequest(args);
+    } finally{
+        args.req.operation = previousOperation;
+    }
+}
+async function validateOperationWithScopedRequest({ slug, data: incomingData, draft, globalConfig, onValidationData, overrideAccess, req, skipAccessControl = false, skipMutationHooks = false, sourceData, validationOperation = 'validate' }) {
+    const accessResult = !skipAccessControl && !overrideAccess ? await executeAccess({
+        slug,
+        data: incomingData,
+        req
+    }, globalConfig.access.validate) : true;
+    const storedGlobal = sourceData ? sourceData.docWithLocales : await resolveValidationGlobalSource({
+        slug,
+        accessResult,
+        draft,
+        globalConfig,
+        overrideAccess,
+        req
+    });
+    const docWithLocales = deepCopyObjectSimple(storedGlobal);
+    if (docWithLocales._id) {
+        delete docWithLocales._id;
+    }
+    const originalDoc = sourceData ? req.locale === sourceData.originalLocale ? deepCopyObjectSimple(sourceData.originalDoc) : flattenDataByLocale({
+        configBlockReferences: req.payload.config.blocks,
+        docWithLocales,
+        fields: globalConfig.fields,
+        locale: req.locale
+    }) : await afterRead({
+        collection: null,
+        context: req.context,
+        depth: 0,
+        doc: deepCopyObjectSimple(docWithLocales),
+        draft,
+        fallbackLocale: req.fallbackLocale,
+        global: globalConfig,
+        locale: req.locale,
+        overrideAccess: true,
+        req,
+        showHiddenFields: true
+    });
+    return runValidationLifecycle({
+        collection: null,
+        docWithLocales,
+        global: globalConfig,
+        incomingData: incomingData,
+        onValidationData,
+        originalDoc,
+        overrideAccess,
+        req,
+        skipMutationHooks,
+        validationOperation
+    });
+}
+/**
+ * Selects the newest stored source before it applies a `where` access policy. This prevents an
+ * older accessible draft from replacing a newer restricted draft. If no draft exists, the main
+ * global remains the validation source.
+ */ async function resolveValidationGlobalSource({ slug, accessResult, draft, globalConfig, overrideAccess, req }) {
+    const main = await req.payload.db.findGlobal({
+        slug,
+        locale: req.locale,
+        req
+    });
+    const hasMain = hasGlobalSource(main);
+    const base = hasMain ? main : {
+        globalType: slug
+    };
+    if (draft && globalConfig.versions?.drafts) {
+        const newestDraft = await findDraftVersion({
+            accessResult: true,
+            doc: base,
+            entity: globalConfig,
+            entityType: 'global',
+            overrideAccess: true,
+            req
+        });
+        if (newestDraft) {
+            if (hasWhereAccessResult(accessResult)) {
+                const accessibleDraft = await findDraftVersion({
+                    accessResult,
+                    doc: base,
+                    draftVersionID: newestDraft.id,
+                    entity: globalConfig,
+                    entityType: 'global',
+                    overrideAccess,
+                    req
+                });
+                if (!accessibleDraft) {
+                    throw new Forbidden(req.t);
+                }
+            }
+            return getDocumentFromDraftVersion({
+                doc: base,
+                draftVersion: newestDraft,
+                entityType: 'global'
+            });
+        }
+    }
+    if (!hasMain) {
+        return {};
+    }
+    if (!hasWhereAccessResult(accessResult)) {
+        return main;
+    }
+    const accessibleMain = await req.payload.db.findGlobal({
+        slug,
+        locale: req.locale,
+        req,
+        where: accessResult
+    });
+    if (!hasGlobalSource(accessibleMain)) {
+        throw new Forbidden(req.t);
+    }
+    return accessibleMain;
+}
+function hasGlobalSource(source) {
+    return Boolean(source && Object.keys(source).length > 0);
+}
+
+//# sourceMappingURL=validate.js.map

package/dist/globals/operations/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/globals/operations/validate.ts"],"sourcesContent":["import type { DeepPartial } from 'ts-essentials'\n\nimport type { TypeWithID } from '../../collections/config/types.js'\nimport type { AccessResult } from '../../config/types.js'\nimport type { GlobalSlug, JsonObject } from '../../index.js'\nimport type { PayloadRequest } from '../../types/index.js'\nimport type { ValidationResult } from '../../types/validation.js'\nimport type { ValidationSourceData } from '../../utilities/runValidationLifecycle.js'\nimport type { DataFromGlobalSlug, SanitizedGlobalConfig } from '../config/types.js'\n\nimport { executeAccess } from '../../auth/executeAccess.js'\nimport { hasWhereAccessResult } from '../../auth/types.js'\nimport { Forbidden } from '../../errors/index.js'\nimport { afterRead } from '../../fields/hooks/afterRead/index.js'\nimport { deepCopyObjectSimple } from '../../utilities/deepCopyObject.js'\nimport { flattenDataByLocale } from '../../utilities/flattenDataByLocale.js'\nimport { runValidationLifecycle } from '../../utilities/runValidationLifecycle.js'\nimport {\n  findDraftVersion,\n  getDocumentFromDraftVersion,\n} from '../../versions/drafts/replaceWithDraftIfAvailable.js'\n\nexport type Arguments<TSlug extends GlobalSlug> = {\n  data?: DeepPartial<Omit<DataFromGlobalSlug<TSlug>, 'id'>>\n  draft: boolean\n  globalConfig: SanitizedGlobalConfig\n  onValidationData?: (data: JsonObject) => void\n  overrideAccess: boolean\n  req: PayloadRequest\n  skipAccessControl?: boolean\n  skipMutationHooks?: boolean\n  slug: string\n  sourceData?: ValidationSourceData\n  validationOperation?: 'update' | 'validate'\n}\n\nexport async function validateOperation<TSlug extends GlobalSlug>(\n  args: Arguments<TSlug>,\n): Promise<ValidationResult> {\n  const previousOperation = args.req.operation\n  args.req.operation = args.validationOperation ?? 'validate'\n\n  try {\n    return await validateOperationWithScopedRequest(args)\n  } finally {\n    args.req.operation = previousOperation\n  }\n}\n\nasync function validateOperationWithScopedRequest<TSlug extends GlobalSlug>({\n  slug,\n  data: incomingData,\n  draft,\n  globalConfig,\n  onValidationData,\n  overrideAccess,\n  req,\n  skipAccessControl = false,\n  skipMutationHooks = false,\n  sourceData,\n  validationOperation = 'validate',\n}: Arguments<TSlug>): Promise<ValidationResult> {\n  const accessResult =\n    !skipAccessControl && !overrideAccess\n      ? await executeAccess({ slug, data: incomingData, req }, globalConfig.access.validate)\n      : true\n  const storedGlobal = sourceData\n    ? sourceData.docWithLocales\n    : await resolveValidationGlobalSource({\n        slug,\n        accessResult,\n        draft,\n        globalConfig,\n        overrideAccess,\n        req,\n      })\n\n  const docWithLocales: JsonObject = deepCopyObjectSimple(storedGlobal)\n\n  if (docWithLocales._id) {\n    delete docWithLocales._id\n  }\n\n  const originalDoc = sourceData\n    ? req.locale === sourceData.originalLocale\n      ? deepCopyObjectSimple(sourceData.originalDoc)\n      : flattenDataByLocale({\n          configBlockReferences: req.payload.config.blocks,\n          docWithLocales,\n          fields: globalConfig.fields,\n          locale: req.locale!,\n        })\n    : await afterRead({\n        collection: null,\n        context: req.context,\n        depth: 0,\n        doc: deepCopyObjectSimple(docWithLocales),\n        draft,\n        fallbackLocale: req.fallbackLocale!,\n        global: globalConfig,\n        locale: req.locale!,\n        overrideAccess: true,\n        req,\n        showHiddenFields: true,\n      })\n\n  return runValidationLifecycle({\n    collection: null,\n    docWithLocales,\n    global: globalConfig,\n    incomingData: incomingData as JsonObject | undefined,\n    onValidationData,\n    originalDoc,\n    overrideAccess,\n    req,\n    skipMutationHooks,\n    validationOperation,\n  })\n}\n\n/**\n * Selects the newest stored source before it applies a `where` access policy. This prevents an\n * older accessible draft from replacing a newer restricted draft. If no draft exists, the main\n * global remains the validation source.\n */\nasync function resolveValidationGlobalSource({\n  slug,\n  accessResult,\n  draft,\n  globalConfig,\n  overrideAccess,\n  req,\n}: {\n  accessResult: AccessResult\n  draft: boolean\n  globalConfig: SanitizedGlobalConfig\n  overrideAccess: boolean\n  req: PayloadRequest\n  slug: string\n}): Promise<JsonObject> {\n  const main = await req.payload.db.findGlobal({\n    slug,\n    locale: req.locale!,\n    req,\n  })\n  const hasMain = hasGlobalSource(main)\n  const base = (hasMain ? main : { globalType: slug }) as JsonObject & TypeWithID\n\n  if (draft && globalConfig.versions?.drafts) {\n    const newestDraft = await findDraftVersion({\n      accessResult: true,\n      doc: base,\n      entity: globalConfig,\n      entityType: 'global',\n      overrideAccess: true,\n      req,\n    })\n\n    if (newestDraft) {\n      if (hasWhereAccessResult(accessResult)) {\n        const accessibleDraft = await findDraftVersion({\n          accessResult,\n          doc: base,\n          draftVersionID: newestDraft.id,\n          entity: globalConfig,\n          entityType: 'global',\n          overrideAccess,\n          req,\n        })\n\n        if (!accessibleDraft) {\n          throw new Forbidden(req.t)\n        }\n      }\n\n      return getDocumentFromDraftVersion({\n        doc: base,\n        draftVersion: newestDraft,\n        entityType: 'global',\n      })\n    }\n  }\n\n  if (!hasMain) {\n    return {}\n  }\n\n  if (!hasWhereAccessResult(accessResult)) {\n    return main\n  }\n\n  const accessibleMain = await req.payload.db.findGlobal({\n    slug,\n    locale: req.locale!,\n    req,\n    where: accessResult,\n  })\n\n  if (!hasGlobalSource(accessibleMain)) {\n    throw new Forbidden(req.t)\n  }\n\n  return accessibleMain\n}\n\nfunction hasGlobalSource(source: JsonObject | null | undefined): source is JsonObject {\n  return Boolean(source && Object.keys(source).length > 0)\n}\n"],"names":["executeAccess","hasWhereAccessResult","Forbidden","afterRead","deepCopyObjectSimple","flattenDataByLocale","runValidationLifecycle","findDraftVersion","getDocumentFromDraftVersion","validateOperation","args","previousOperation","req","operation","validationOperation","validateOperationWithScopedRequest","slug","data","incomingData","draft","globalConfig","onValidationData","overrideAccess","skipAccessControl","skipMutationHooks","sourceData","accessResult","access","validate","storedGlobal","docWithLocales","resolveValidationGlobalSource","_id","originalDoc","locale","originalLocale","configBlockReferences","payload","config","blocks","fields","collection","context","depth","doc","fallbackLocale","global","showHiddenFields","main","db","findGlobal","hasMain","hasGlobalSource","base","globalType","versions","drafts","newestDraft","entity","entityType","accessibleDraft","draftVersionID","id","t","draftVersion","accessibleMain","where","source","Boolean","Object","keys","length"],"mappings":"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"}

package/dist/hierarchy/addHierarchyToCollection.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionConfig } from '../collections/config/types.js';
+export declare const addHierarchyToCollection: ({ collectionConfig, parentFieldName, slugFieldName, slugPathFieldName, titlePathFieldName, }: {
+    collectionConfig: CollectionConfig;
+    parentFieldName: string;
+    slugFieldName?: string;
+    slugPathFieldName: string;
+    titlePathFieldName: string;
+}) => void;
+//# sourceMappingURL=addHierarchyToCollection.d.ts.map

package/dist/hierarchy/addHierarchyToCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addHierarchyToCollection.d.ts","sourceRoot":"","sources":["../../src/hierarchy/addHierarchyToCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAQtE,eAAO,MAAM,wBAAwB,iGAMlC;IACD,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,SAkEA,CAAA"}

package/dist/hierarchy/addHierarchyToCollection.js

@@ -0,0 +1,78 @@
+import { hierarchyCollectionAfterRead } from './hooks/collectionAfterRead.js';
+import { hierarchyCollectionBeforeChange } from './hooks/collectionBeforeChange.js';
+import { hierarchyCollectionBeforeDelete } from './hooks/collectionBeforeDelete.js';
+import { hierarchyCollectionBeforeOperation } from './hooks/collectionBeforeOperation.js';
+import { findFieldByName, findUseAsTitleField } from './utils/findUseAsTitle.js';
+export const addHierarchyToCollection = ({ collectionConfig, parentFieldName, slugFieldName, slugPathFieldName, titlePathFieldName })=>{
+    const { titleFieldName } = findUseAsTitleField(collectionConfig);
+    // Verify slug field exists if configured
+    const slugFieldInfo = slugFieldName ? findFieldByName(collectionConfig, slugFieldName) : undefined;
+    const validatedSlugFieldName = slugFieldInfo ? slugFieldName : undefined;
+    // Add virtual path fields (computed in afterRead)
+    collectionConfig.fields.push({
+        name: slugPathFieldName,
+        type: 'text',
+        admin: {
+            hidden: true,
+            readOnly: true
+        },
+        index: true,
+        label: 'Slug Path',
+        virtual: true
+    }, {
+        name: titlePathFieldName,
+        type: 'text',
+        admin: {
+            hidden: true,
+            readOnly: true
+        },
+        index: true,
+        label: 'Title Path',
+        virtual: true
+    });
+    if (!collectionConfig.admin) {
+        collectionConfig.admin = {};
+    }
+    if (!collectionConfig.admin.listSearchableFields) {
+        collectionConfig.admin.listSearchableFields = [
+            titleFieldName
+        ];
+    } else if (!collectionConfig.admin.listSearchableFields.includes(titleFieldName)) {
+        collectionConfig.admin.listSearchableFields.push(titleFieldName);
+    }
+    collectionConfig.hooks = {
+        ...collectionConfig.hooks || {},
+        afterRead: [
+            ...collectionConfig.hooks?.afterRead || [],
+            hierarchyCollectionAfterRead({
+                parentFieldName,
+                slugPathFieldName,
+                titlePathFieldName
+            })
+        ],
+        beforeChange: [
+            ...collectionConfig.hooks?.beforeChange || [],
+            hierarchyCollectionBeforeChange({
+                parentFieldName
+            })
+        ],
+        beforeDelete: [
+            ...collectionConfig.hooks?.beforeDelete || [],
+            hierarchyCollectionBeforeDelete({
+                parentFieldName
+            })
+        ],
+        beforeOperation: [
+            ...collectionConfig.hooks?.beforeOperation || [],
+            hierarchyCollectionBeforeOperation({
+                parentFieldName,
+                slugFieldName: validatedSlugFieldName,
+                slugPathFieldName,
+                titleFieldName,
+                titlePathFieldName
+            })
+        ]
+    };
+};
+
+//# sourceMappingURL=addHierarchyToCollection.js.map

package/dist/hierarchy/addHierarchyToCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/addHierarchyToCollection.ts"],"sourcesContent":["import type { CollectionConfig } from '../collections/config/types.js'\n\nimport { hierarchyCollectionAfterRead } from './hooks/collectionAfterRead.js'\nimport { hierarchyCollectionBeforeChange } from './hooks/collectionBeforeChange.js'\nimport { hierarchyCollectionBeforeDelete } from './hooks/collectionBeforeDelete.js'\nimport { hierarchyCollectionBeforeOperation } from './hooks/collectionBeforeOperation.js'\nimport { findFieldByName, findUseAsTitleField } from './utils/findUseAsTitle.js'\n\nexport const addHierarchyToCollection = ({\n  collectionConfig,\n  parentFieldName,\n  slugFieldName,\n  slugPathFieldName,\n  titlePathFieldName,\n}: {\n  collectionConfig: CollectionConfig\n  parentFieldName: string\n  slugFieldName?: string\n  slugPathFieldName: string\n  titlePathFieldName: string\n}) => {\n  const { titleFieldName } = findUseAsTitleField(collectionConfig)\n  // Verify slug field exists if configured\n  const slugFieldInfo = slugFieldName ? findFieldByName(collectionConfig, slugFieldName) : undefined\n  const validatedSlugFieldName = slugFieldInfo ? slugFieldName : undefined\n\n  // Add virtual path fields (computed in afterRead)\n  collectionConfig.fields.push(\n    {\n      name: slugPathFieldName,\n      type: 'text',\n      admin: {\n        hidden: true,\n        readOnly: true,\n      },\n      index: true,\n      label: 'Slug Path',\n      virtual: true,\n    },\n    {\n      name: titlePathFieldName,\n      type: 'text',\n      admin: {\n        hidden: true,\n        readOnly: true,\n      },\n      index: true,\n      label: 'Title Path',\n      virtual: true,\n    },\n  )\n\n  if (!collectionConfig.admin) {\n    collectionConfig.admin = {}\n  }\n  if (!collectionConfig.admin.listSearchableFields) {\n    collectionConfig.admin.listSearchableFields = [titleFieldName]\n  } else if (!collectionConfig.admin.listSearchableFields.includes(titleFieldName)) {\n    collectionConfig.admin.listSearchableFields.push(titleFieldName)\n  }\n\n  collectionConfig.hooks = {\n    ...(collectionConfig.hooks || {}),\n    afterRead: [\n      ...(collectionConfig.hooks?.afterRead || []),\n      hierarchyCollectionAfterRead({ parentFieldName, slugPathFieldName, titlePathFieldName }),\n    ],\n    beforeChange: [\n      ...(collectionConfig.hooks?.beforeChange || []),\n      hierarchyCollectionBeforeChange({ parentFieldName }),\n    ],\n    beforeDelete: [\n      ...(collectionConfig.hooks?.beforeDelete || []),\n      hierarchyCollectionBeforeDelete({ parentFieldName }),\n    ],\n    beforeOperation: [\n      ...(collectionConfig.hooks?.beforeOperation || []),\n      hierarchyCollectionBeforeOperation({\n        parentFieldName,\n        slugFieldName: validatedSlugFieldName,\n        slugPathFieldName,\n        titleFieldName,\n        titlePathFieldName,\n      }),\n    ],\n  }\n}\n"],"names":["hierarchyCollectionAfterRead","hierarchyCollectionBeforeChange","hierarchyCollectionBeforeDelete","hierarchyCollectionBeforeOperation","findFieldByName","findUseAsTitleField","addHierarchyToCollection","collectionConfig","parentFieldName","slugFieldName","slugPathFieldName","titlePathFieldName","titleFieldName","slugFieldInfo","undefined","validatedSlugFieldName","fields","push","name","type","admin","hidden","readOnly","index","label","virtual","listSearchableFields","includes","hooks","afterRead","beforeChange","beforeDelete","beforeOperation"],"mappings":"AAEA,SAASA,4BAA4B,QAAQ,iCAAgC;AAC7E,SAASC,+BAA+B,QAAQ,oCAAmC;AACnF,SAASC,+BAA+B,QAAQ,oCAAmC;AACnF,SAASC,kCAAkC,QAAQ,uCAAsC;AACzF,SAASC,eAAe,EAAEC,mBAAmB,QAAQ,4BAA2B;AAEhF,OAAO,MAAMC,2BAA2B,CAAC,EACvCC,gBAAgB,EAChBC,eAAe,EACfC,aAAa,EACbC,iBAAiB,EACjBC,kBAAkB,EAOnB;IACC,MAAM,EAAEC,cAAc,EAAE,GAAGP,oBAAoBE;IAC/C,yCAAyC;IACzC,MAAMM,gBAAgBJ,gBAAgBL,gBAAgBG,kBAAkBE,iBAAiBK;IACzF,MAAMC,yBAAyBF,gBAAgBJ,gBAAgBK;IAE/D,kDAAkD;IAClDP,iBAAiBS,MAAM,CAACC,IAAI,CAC1B;QACEC,MAAMR;QACNS,MAAM;QACNC,OAAO;YACLC,QAAQ;YACRC,UAAU;QACZ;QACAC,OAAO;QACPC,OAAO;QACPC,SAAS;IACX,GACA;QACEP,MAAMP;QACNQ,MAAM;QACNC,OAAO;YACLC,QAAQ;YACRC,UAAU;QACZ;QACAC,OAAO;QACPC,OAAO;QACPC,SAAS;IACX;IAGF,IAAI,CAAClB,iBAAiBa,KAAK,EAAE;QAC3Bb,iBAAiBa,KAAK,GAAG,CAAC;IAC5B;IACA,IAAI,CAACb,iBAAiBa,KAAK,CAACM,oBAAoB,EAAE;QAChDnB,iBAAiBa,KAAK,CAACM,oBAAoB,GAAG;YAACd;SAAe;IAChE,OAAO,IAAI,CAACL,iBAAiBa,KAAK,CAACM,oBAAoB,CAACC,QAAQ,CAACf,iBAAiB;QAChFL,iBAAiBa,KAAK,CAACM,oBAAoB,CAACT,IAAI,CAACL;IACnD;IAEAL,iBAAiBqB,KAAK,GAAG;QACvB,GAAIrB,iBAAiBqB,KAAK,IAAI,CAAC,CAAC;QAChCC,WAAW;eACLtB,iBAAiBqB,KAAK,EAAEC,aAAa,EAAE;YAC3C7B,6BAA6B;gBAAEQ;gBAAiBE;gBAAmBC;YAAmB;SACvF;QACDmB,cAAc;eACRvB,iBAAiBqB,KAAK,EAAEE,gBAAgB,EAAE;YAC9C7B,gCAAgC;gBAAEO;YAAgB;SACnD;QACDuB,cAAc;eACRxB,iBAAiBqB,KAAK,EAAEG,gBAAgB,EAAE;YAC9C7B,gCAAgC;gBAAEM;YAAgB;SACnD;QACDwB,iBAAiB;eACXzB,iBAAiBqB,KAAK,EAAEI,mBAAmB,EAAE;YACjD7B,mCAAmC;gBACjCK;gBACAC,eAAeM;gBACfL;gBACAE;gBACAD;YACF;SACD;IACH;AACF,EAAC"}

package/dist/hierarchy/buildParentField.d.ts

@@ -0,0 +1,11 @@
+import type { SingleRelationshipField } from '../fields/config/types.js';
+export declare const buildParentField: ({ collectionSlug, injectHeaderButton, overrides, parentFieldName, }: {
+    collectionSlug: string;
+    /**
+     * When true, uses NullField and injects a header button for parent selection
+     */
+    injectHeaderButton?: boolean;
+    overrides?: Partial<SingleRelationshipField>;
+    parentFieldName: string;
+}) => SingleRelationshipField;
+//# sourceMappingURL=buildParentField.d.ts.map

package/dist/hierarchy/buildParentField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildParentField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/buildParentField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE,eAAO,MAAM,gBAAgB,wEAK1B;IACD,cAAc,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC5C,eAAe,EAAE,MAAM,CAAA;CACxB,KAAG,uBA0CH,CAAA"}

package/dist/hierarchy/buildParentField.js

@@ -0,0 +1,42 @@
+export const buildParentField = ({ collectionSlug, injectHeaderButton = false, overrides = {}, parentFieldName })=>{
+    const field = {
+        name: parentFieldName,
+        type: 'relationship',
+        admin: {
+            ...injectHeaderButton && {
+                components: {
+                    Field: '@payloadcms/ui#NullField'
+                }
+            },
+            position: 'sidebar'
+        },
+        hasMany: false,
+        index: true,
+        label: 'Parent',
+        localized: false,
+        relationTo: collectionSlug,
+        ...injectHeaderButton && {
+            custom: {
+                hierarchy: {
+                    // Inform hierarchy UI to inject the header button for this parent field
+                    injectHeaderButton: true
+                }
+            }
+        }
+    };
+    if (overrides?.admin) {
+        field.admin = {
+            ...field.admin || {},
+            ...overrides.admin
+        };
+        if (overrides.admin.components && field.admin) {
+            field.admin.components = {
+                ...field.admin.components || {},
+                ...overrides.admin.components
+            };
+        }
+    }
+    return field;
+};
+
+//# sourceMappingURL=buildParentField.js.map

package/dist/hierarchy/buildParentField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/buildParentField.ts"],"sourcesContent":["import type { SingleRelationshipField } from '../fields/config/types.js'\n\nexport const buildParentField = ({\n  collectionSlug,\n  injectHeaderButton = false,\n  overrides = {},\n  parentFieldName,\n}: {\n  collectionSlug: string\n  /**\n   * When true, uses NullField and injects a header button for parent selection\n   */\n  injectHeaderButton?: boolean\n  overrides?: Partial<SingleRelationshipField>\n  parentFieldName: string\n}): SingleRelationshipField => {\n  const field: SingleRelationshipField = {\n    name: parentFieldName,\n    type: 'relationship',\n    admin: {\n      ...(injectHeaderButton && {\n        components: {\n          Field: '@payloadcms/ui#NullField',\n        },\n      }),\n      position: 'sidebar',\n    },\n    hasMany: false,\n    index: true,\n    label: 'Parent',\n    localized: false,\n    relationTo: collectionSlug, // Always self-referential\n    ...(injectHeaderButton && {\n      custom: {\n        hierarchy: {\n          // Inform hierarchy UI to inject the header button for this parent field\n          injectHeaderButton: true,\n        },\n      },\n    }),\n  }\n\n  if (overrides?.admin) {\n    field.admin = {\n      ...(field.admin || {}),\n      ...overrides.admin,\n    }\n\n    if (overrides.admin.components && field.admin) {\n      field.admin.components = {\n        ...(field.admin.components || {}),\n        ...overrides.admin.components,\n      }\n    }\n  }\n\n  return field\n}\n"],"names":["buildParentField","collectionSlug","injectHeaderButton","overrides","parentFieldName","field","name","type","admin","components","Field","position","hasMany","index","label","localized","relationTo","custom","hierarchy"],"mappings":"AAEA,OAAO,MAAMA,mBAAmB,CAAC,EAC/BC,cAAc,EACdC,qBAAqB,KAAK,EAC1BC,YAAY,CAAC,CAAC,EACdC,eAAe,EAShB;IACC,MAAMC,QAAiC;QACrCC,MAAMF;QACNG,MAAM;QACNC,OAAO;YACL,GAAIN,sBAAsB;gBACxBO,YAAY;oBACVC,OAAO;gBACT;YACF,CAAC;YACDC,UAAU;QACZ;QACAC,SAAS;QACTC,OAAO;QACPC,OAAO;QACPC,WAAW;QACXC,YAAYf;QACZ,GAAIC,sBAAsB;YACxBe,QAAQ;gBACNC,WAAW;oBACT,wEAAwE;oBACxEhB,oBAAoB;gBACtB;YACF;QACF,CAAC;IACH;IAEA,IAAIC,WAAWK,OAAO;QACpBH,MAAMG,KAAK,GAAG;YACZ,GAAIH,MAAMG,KAAK,IAAI,CAAC,CAAC;YACrB,GAAGL,UAAUK,KAAK;QACpB;QAEA,IAAIL,UAAUK,KAAK,CAACC,UAAU,IAAIJ,MAAMG,KAAK,EAAE;YAC7CH,MAAMG,KAAK,CAACC,UAAU,GAAG;gBACvB,GAAIJ,MAAMG,KAAK,CAACC,UAAU,IAAI,CAAC,CAAC;gBAChC,GAAGN,UAAUK,KAAK,CAACC,UAAU;YAC/B;QACF;IACF;IAEA,OAAOJ;AACT,EAAC"}

package/dist/hierarchy/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */
+export declare const HIERARCHY_SLUG_PATH_FIELD = "_h_slugPath";
+export declare const HIERARCHY_TITLE_PATH_FIELD = "_h_titlePath";
+export declare const HIERARCHY_DEFAULT_LOCALE = "en";
+/** Default limit for hierarchy tree queries */
+export declare const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */
+export declare const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */
+export declare const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */
+export declare const getHierarchyFieldName: (hierarchySlug: string) => string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/hierarchy/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/hierarchy/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AACtD,eAAO,MAAM,0BAA0B,iBAAiB,CAAA;AACxD,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAE5C,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,kBAAmB,MAAM,KAAG,MAA+B,CAAA"}

package/dist/hierarchy/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */ export const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath';
+export const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath';
+export const HIERARCHY_DEFAULT_LOCALE = 'en';
+/** Default limit for hierarchy tree queries */ export const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */ export const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */ export const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */ export const getHierarchyFieldName = (hierarchySlug)=>`_h_${hierarchySlug}`;
+
+//# sourceMappingURL=constants.js.map

package/dist/hierarchy/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/constants.ts"],"sourcesContent":["/**\n * Default field names and constants for hierarchy feature\n */\n\nexport const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath'\nexport const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath'\nexport const HIERARCHY_DEFAULT_LOCALE = 'en'\n\n/** Default limit for hierarchy tree queries */\nexport const DEFAULT_HIERARCHY_TREE_LIMIT = 100\n\n/** Default limit for hierarchy list view table queries */\nexport const DEFAULT_HIERARCHY_LIST_LIMIT = 25\n\n/** Default value for allowing hasMany on hierarchy fields */\nexport const DEFAULT_ALLOW_HAS_MANY = true\n\n/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */\nexport const getHierarchyFieldName = (hierarchySlug: string): string => `_h_${hierarchySlug}`\n"],"names":["HIERARCHY_SLUG_PATH_FIELD","HIERARCHY_TITLE_PATH_FIELD","HIERARCHY_DEFAULT_LOCALE","DEFAULT_HIERARCHY_TREE_LIMIT","DEFAULT_HIERARCHY_LIST_LIMIT","DEFAULT_ALLOW_HAS_MANY","getHierarchyFieldName","hierarchySlug"],"mappings":"AAAA;;CAEC,GAED,OAAO,MAAMA,4BAA4B,cAAa;AACtD,OAAO,MAAMC,6BAA6B,eAAc;AACxD,OAAO,MAAMC,2BAA2B,KAAI;AAE5C,6CAA6C,GAC7C,OAAO,MAAMC,+BAA+B,IAAG;AAE/C,wDAAwD,GACxD,OAAO,MAAMC,+BAA+B,GAAE;AAE9C,2DAA2D,GAC3D,OAAO,MAAMC,yBAAyB,KAAI;AAE1C,4FAA4F,GAC5F,OAAO,MAAMC,wBAAwB,CAACC,gBAAkC,CAAC,GAAG,EAAEA,eAAe,CAAA"}

package/dist/hierarchy/createFolderField.d.ts

@@ -0,0 +1,39 @@
+import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a folder relationship field.
+ * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany
+ * which are managed by the folder system.
+ */
+export type CreateFolderFieldOptions = {
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'folders')
+     */
+    relationTo: string;
+} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createFolderField(options: CreateFolderFieldOptions): RelationshipField;
+//# sourceMappingURL=createFolderField.d.ts.map

package/dist/hierarchy/createFolderField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFolderField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createFolderField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAI3F;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA2BtF"}

package/dist/hierarchy/createFolderField.js

@@ -0,0 +1,54 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */ export function createFolderField(options) {
+    const { admin: adminOverrides, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                // NullField renders nothing - the header button handles the UI
+                Field: '@payloadcms/ui#NullField',
+                ...componentOverrides
+            }
+        },
+        custom: {
+            hierarchy: {
+                injectHeaderButton: true
+            }
+        },
+        hasMany: false,
+        index: true,
+        label: label ?? 'Folder',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createFolderField.js.map

package/dist/hierarchy/createFolderField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createFolderField.ts"],"sourcesContent":["import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a folder relationship field.\n * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany\n * which are managed by the folder system.\n */\nexport type CreateFolderFieldOptions = {\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'folders')\n   */\n  relationTo: string\n} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for folder-style hierarchies (single-select).\n *\n * This field:\n * - Has hasMany:false (single folder selection)\n * - Uses NullField to render nothing in the form (no DOM output)\n * - Injects a header button for folder selection via miller columns UI\n *\n * Use this in your collection's fields array to add a folder relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createFolderField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createFolderField({\n *       relationTo: 'folders',\n *       label: 'Folder',\n *     }),\n *   ],\n * }\n */\nexport function createFolderField(options: CreateFolderFieldOptions): RelationshipField {\n  const { admin: adminOverrides, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        // NullField renders nothing - the header button handles the UI\n        Field: '@payloadcms/ui#NullField',\n        ...componentOverrides,\n      },\n    },\n    custom: {\n      hierarchy: {\n        injectHeaderButton: true,\n      },\n    },\n    hasMany: false,\n    index: true,\n    label: label ?? 'Folder',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createFolderField","options","admin","adminOverrides","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","custom","hierarchy","injectHeaderButton","hasMany","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AActD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,kBAAkBC,OAAiC;IACjE,MAAM,EAAEC,OAAOC,cAAc,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGL;IACrE,MAAM,EAAEM,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGN,kBAAkB,CAAC;IAErF,OAAO;QACLO,MAAMX,sBAAsBM;QAC5BM,MAAM;QACNT,OAAO;YACLU,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACV,+DAA+D;gBAC/DM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAM,QAAQ;YACNC,WAAW;gBACTC,oBAAoB;YACtB;QACF;QACAC,SAAS;QACTC,OAAO;QACPd,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/createTagField.d.ts

@@ -0,0 +1,44 @@
+import type { RelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a tag relationship field.
+ * All RelationshipFieldMany properties are available except name, type, and relationTo
+ * which are managed by the tag system.
+ */
+export type CreateTagFieldOptions = {
+    /**
+     * Whether to allow multiple tags (defaults to true)
+     * @default true
+     */
+    hasMany?: boolean;
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'tags')
+     */
+    relationTo: string;
+} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createTagField(options: CreateTagFieldOptions): RelationshipField;
+//# sourceMappingURL=createTagField.d.ts.map

package/dist/hierarchy/createTagField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTagField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createTagField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAqBhF"}

package/dist/hierarchy/createTagField.js

@@ -0,0 +1,48 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */ export function createTagField(options) {
+    const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                Field: '@payloadcms/ui/rsc#HierarchyField',
+                ...componentOverrides
+            }
+        },
+        hasMany,
+        index: true,
+        label: label ?? 'Tags',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createTagField.js.map

package/dist/hierarchy/createTagField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createTagField.ts"],"sourcesContent":["import type { RelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a tag relationship field.\n * All RelationshipFieldMany properties are available except name, type, and relationTo\n * which are managed by the tag system.\n */\nexport type CreateTagFieldOptions = {\n  /**\n   * Whether to allow multiple tags (defaults to true)\n   * @default true\n   */\n  hasMany?: boolean\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'tags')\n   */\n  relationTo: string\n} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for tag-style hierarchies (multi-select by default).\n *\n * This field:\n * - Has hasMany:true by default (multiple tag selection)\n * - Is positioned in the sidebar by default\n * - Does NOT inject a header button (tags use standard relationship UI)\n *\n * Use this in your collection's fields array to add a tag relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createTagField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createTagField({\n *       relationTo: 'tags',\n *       label: 'Tags',\n *     }),\n *   ],\n * }\n */\nexport function createTagField(options: CreateTagFieldOptions): RelationshipField {\n  const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        Field: '@payloadcms/ui/rsc#HierarchyField',\n        ...componentOverrides,\n      },\n    },\n    hasMany,\n    index: true,\n    label: label ?? 'Tags',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createTagField","options","admin","adminOverrides","hasMany","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AAmBtD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,eAAeC,OAA8B;IAC3D,MAAM,EAAEC,OAAOC,cAAc,EAAEC,UAAU,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGN;IACrF,MAAM,EAAEO,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGP,kBAAkB,CAAC;IAErF,OAAO;QACLQ,MAAMZ,sBAAsBO;QAC5BM,MAAM;QACNV,OAAO;YACLW,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACVM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAL;QACAW,OAAO;QACPV,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/getInitialTreeData.d.ts

@@ -0,0 +1,27 @@
+import type { TypeWithID } from '../collections/config/types.js';
+import type { PayloadRequest, Where } from '../types/index.js';
+export type GetInitialTreeDataArgs = {
+    /** Base filter to apply to all queries (e.g., tenant filter) */
+    baseFilter?: null | Where;
+    collectionSlug: string;
+    expandedNodeIds?: (number | string)[];
+    /** Filter tree to only show folders that allow these collection types (or are unrestricted) */
+    filterByCollections?: string[];
+    limit?: number;
+    payload: PayloadRequest['payload'];
+    /** The currently selected node ID. When provided, ensures siblings are loaded to include this node. */
+    selectedNodeId?: null | number | string;
+    /** The parent ID of the selected node. Required when selectedNodeId is provided. */
+    selectedNodeParentId?: null | number | string;
+    user: PayloadRequest['user'];
+};
+export type InitialTreeData = {
+    docs: TypeWithID[];
+    loadedParents: Record<string, {
+        hasMore: boolean;
+        loadedCount?: number;
+        totalDocs: number;
+    }>;
+};
+export declare const getInitialTreeData: ({ baseFilter, collectionSlug, expandedNodeIds, filterByCollections, limit, payload, selectedNodeId, selectedNodeParentId, user, }: GetInitialTreeDataArgs) => Promise<InitialTreeData>;
+//# sourceMappingURL=getInitialTreeData.d.ts.map

package/dist/hierarchy/getInitialTreeData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInitialTreeData.d.ts","sourceRoot":"","sources":["../../src/hierarchy/getInitialTreeData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAI9D,MAAM,MAAM,sBAAsB,GAAG;IACnC,gEAAgE;IAChE,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACrC,+FAA+F;IAC/F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAClC,uGAAuG;IACvG,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IACvC,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAA;IAElB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7F,CAAA;AAED,eAAO,MAAM,kBAAkB,sIAU5B,sBAAsB,KAAG,OAAO,CAAC,eAAe,CA0IlD,CAAA"}