payload 4.0.0-internal.d28e9fb → 4.0.0-internal.fa345ef

package/dist/hierarchy/sanitizeHierarchyCollection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hierarchy/sanitizeHierarchyCollection.ts"],"sourcesContent":["import type { CollectionConfig } from '../collections/config/types.js'\nimport type { Config } from '../config/types.js'\nimport type { SanitizedHierarchyConfig } from './types.js'\n\nimport { fieldAffectsData } from '../fields/config/types.js'\nimport { slugify as defaultSlugify } from '../utilities/slugify.js'\nimport { addHierarchyToCollection } from './addHierarchyToCollection.js'\nimport { buildParentField } from './buildParentField.js'\nimport {\n  DEFAULT_ALLOW_HAS_MANY,\n  DEFAULT_HIERARCHY_TREE_LIMIT,\n  getHierarchyFieldName,\n  HIERARCHY_SLUG_PATH_FIELD,\n  HIERARCHY_TITLE_PATH_FIELD,\n} from './constants.js'\nimport { ensureSafeCollectionsChange } from './hooks/ensureSafeCollectionsChange.js'\n\n/**\n * Sanitizes hierarchy configuration for a single collection.\n *\n * This is phase 1 of hierarchy setup, called during individual collection sanitization.\n * It normalizes the hierarchy config, creates the parent field if needed, adds hooks,\n * and sets up the sanitized config structure.\n *\n * Phase 2 (`resolveHierarchyCollections`) runs after all collections are sanitized\n * to establish cross-collection relationships.\n */\nexport const sanitizeHierarchyCollection = (\n  collectionConfig: CollectionConfig,\n  _config: Config,\n): void => {\n  if (!collectionConfig.hierarchy) {\n    collectionConfig.hierarchy = false\n    return\n  }\n\n  // Normalize boolean to object and apply parentFieldName default\n  const defaultParentFieldName = getHierarchyFieldName(collectionConfig.slug)\n\n  if (collectionConfig.hierarchy === true) {\n    collectionConfig.hierarchy = {\n      parentFieldName: defaultParentFieldName,\n    }\n  }\n\n  const parentFieldName = collectionConfig.hierarchy.parentFieldName ?? defaultParentFieldName\n\n  // Check if parent field already exists\n  const existingParentField = collectionConfig.fields.find(\n    (field) => fieldAffectsData(field) && field.name === parentFieldName,\n  )\n\n  if (existingParentField) {\n    // Validate existing parent field configuration\n    if (existingParentField.type !== 'relationship') {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" must be a relationship field`,\n      )\n    }\n\n    if (existingParentField.hasMany !== false) {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" must have hasMany set to false`,\n      )\n    }\n\n    if (existingParentField.localized === true) {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" cannot be localized. The parent relationship must be consistent across all locales.`,\n      )\n    }\n  } else {\n    // Auto-create parent field if it doesn't exist\n    // useHeaderButton defaults to true - parent selection via header button with miller columns\n    const useHeaderButton = collectionConfig.hierarchy.admin?.useHeaderButton ?? true\n\n    const parentField = buildParentField({\n      collectionSlug: collectionConfig.slug,\n      injectHeaderButton: useHeaderButton,\n      parentFieldName,\n    })\n\n    collectionConfig.fields.unshift(parentField)\n  }\n\n  // Apply defaults for optional fields\n  const slugPathFieldName =\n    collectionConfig.hierarchy.slugPathFieldName || HIERARCHY_SLUG_PATH_FIELD\n  const titlePathFieldName =\n    collectionConfig.hierarchy.titlePathFieldName || HIERARCHY_TITLE_PATH_FIELD\n  const allowHasMany = collectionConfig.hierarchy.allowHasMany ?? DEFAULT_ALLOW_HAS_MANY\n  const rawCollectionSpecific = collectionConfig.hierarchy.collectionSpecific\n  const collectionSpecific: { fieldName: string } | false =\n    rawCollectionSpecific === true\n      ? { fieldName: 'hierarchyType' }\n      : rawCollectionSpecific\n        ? { fieldName: rawCollectionSpecific.fieldName ?? 'hierarchyType' }\n        : false\n  const joinField = collectionConfig.hierarchy.joinField\n    ? collectionConfig.hierarchy.joinField\n    : undefined\n  const slugify =\n    collectionConfig.hierarchy.slugify ?? ((text: string) => defaultSlugify(text) ?? '')\n  const treeLimit = collectionConfig.hierarchy.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT\n  const iconComponent = collectionConfig.hierarchy.admin?.components?.Icon\n\n  const slugField = collectionConfig.hierarchy.slugField\n\n  // Apply hierarchy to collection (adds fields and hooks)\n  addHierarchyToCollection({\n    collectionConfig,\n    parentFieldName: collectionConfig.hierarchy.parentFieldName,\n    slugFieldName: slugField,\n    slugPathFieldName,\n    titlePathFieldName,\n  })\n\n  // If collectionSpecific, add beforeValidate hook to enforce scope inheritance\n  // (hierarchyType field is added in resolveHierarchyCollections after discovery)\n  if (collectionSpecific) {\n    // Use parentFieldName for both - backward compatible configs use the same field name everywhere\n    if (!collectionConfig.hooks) {\n      collectionConfig.hooks = {}\n    }\n    if (!collectionConfig.hooks.beforeValidate) {\n      collectionConfig.hooks.beforeValidate = []\n    }\n    collectionConfig.hooks.beforeValidate.push(\n      ensureSafeCollectionsChange({\n        folderFieldName: parentFieldName,\n        foldersSlug: collectionConfig.slug,\n        parentFieldName,\n        typeFieldName: collectionSpecific.fieldName,\n      }),\n    )\n  }\n\n  // Set sanitized hierarchy config (cast needed as we're transitioning from HierarchyConfig to SanitizedHierarchyConfig)\n  const useHeaderButton = collectionConfig.hierarchy.admin?.useHeaderButton ?? false\n  const injectSidebarTab = collectionConfig.hierarchy.admin?.injectSidebarTab ?? true\n\n  ;(collectionConfig as unknown as { hierarchy: SanitizedHierarchyConfig }).hierarchy = {\n    admin: {\n      components: {\n        Icon: iconComponent || '@payloadcms/ui#TagIcon',\n      },\n      injectSidebarTab,\n      treeLimit,\n      useHeaderButton,\n    },\n    allowHasMany,\n    collectionSpecific,\n    joinField,\n    parentFieldName,\n    relatedCollections: {},\n    slugField,\n    slugify,\n    slugPathFieldName,\n    titlePathFieldName,\n  }\n}\n"],"names":["fieldAffectsData","slugify","defaultSlugify","addHierarchyToCollection","buildParentField","DEFAULT_ALLOW_HAS_MANY","DEFAULT_HIERARCHY_TREE_LIMIT","getHierarchyFieldName","HIERARCHY_SLUG_PATH_FIELD","HIERARCHY_TITLE_PATH_FIELD","ensureSafeCollectionsChange","sanitizeHierarchyCollection","collectionConfig","_config","hierarchy","defaultParentFieldName","slug","parentFieldName","existingParentField","fields","find","field","name","type","Error","hasMany","localized","useHeaderButton","admin","parentField","collectionSlug","injectHeaderButton","unshift","slugPathFieldName","titlePathFieldName","allowHasMany","rawCollectionSpecific","collectionSpecific","fieldName","joinField","undefined","text","treeLimit","iconComponent","components","Icon","slugField","slugFieldName","hooks","beforeValidate","push","folderFieldName","foldersSlug","typeFieldName","injectSidebarTab","relatedCollections"],"mappings":"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"}
+{"version":3,"sources":["../../src/hierarchy/sanitizeHierarchyCollection.ts"],"sourcesContent":["import type { CollectionConfig } from '../collections/config/types.js'\nimport type { Config } from '../config/types.js'\nimport type { SanitizedHierarchyConfig } from './types.js'\n\nimport { fieldAffectsData } from '../fields/config/types.js'\nimport { slugify as defaultSlugify } from '../utilities/slugify.js'\nimport { addHierarchyToCollection } from './addHierarchyToCollection.js'\nimport { buildParentField } from './buildParentField.js'\nimport {\n  DEFAULT_ALLOW_HAS_MANY,\n  DEFAULT_HIERARCHY_TREE_LIMIT,\n  getHierarchyFieldName,\n  HIERARCHY_SLUG_PATH_FIELD,\n  HIERARCHY_TITLE_PATH_FIELD,\n} from './constants.js'\nimport { ensureSafeCollectionsChange } from './hooks/ensureSafeCollectionsChange.js'\n\n/**\n * Sanitizes hierarchy configuration for a single collection.\n *\n * This is phase 1 of hierarchy setup, called during individual collection sanitization.\n * It normalizes the hierarchy config, creates the parent field if needed, adds hooks,\n * and sets up the sanitized config structure.\n *\n * Phase 2 (`resolveHierarchyCollections`) runs after all collections are sanitized\n * to establish cross-collection relationships.\n */\nexport const sanitizeHierarchyCollection = (\n  collectionConfig: CollectionConfig,\n  _config: Config,\n): void => {\n  if (!collectionConfig.hierarchy) {\n    collectionConfig.hierarchy = false\n    return\n  }\n\n  // Normalize boolean to object and apply parentFieldName default\n  const defaultParentFieldName = getHierarchyFieldName(collectionConfig.slug)\n\n  if (collectionConfig.hierarchy === true) {\n    collectionConfig.hierarchy = {\n      parentFieldName: defaultParentFieldName,\n    }\n  }\n\n  const parentFieldName = collectionConfig.hierarchy.parentFieldName ?? defaultParentFieldName\n\n  // Check if parent field already exists\n  const existingParentField = collectionConfig.fields.find(\n    (field) => fieldAffectsData(field) && field.name === parentFieldName,\n  )\n\n  if (existingParentField) {\n    // Validate existing parent field configuration\n    if (existingParentField.type !== 'relationship') {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" must be a relationship field`,\n      )\n    }\n\n    if (existingParentField.hasMany !== false) {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" must have hasMany set to false`,\n      )\n    }\n\n    if (existingParentField.localized === true) {\n      throw new Error(\n        `Hierarchy parent field \"${parentFieldName}\" in collection \"${collectionConfig.slug}\" cannot be localized. The parent relationship must be consistent across all locales.`,\n      )\n    }\n  } else {\n    // Auto-create parent field if it doesn't exist\n    // useHeaderButton defaults to true - parent selection via header button with miller columns\n    const useHeaderButton = collectionConfig.hierarchy.admin?.useHeaderButton ?? true\n\n    const parentField = buildParentField({\n      collectionSlug: collectionConfig.slug,\n      injectHeaderButton: useHeaderButton,\n      parentFieldName,\n    })\n\n    collectionConfig.fields.unshift(parentField)\n  }\n\n  // Apply defaults for optional fields\n  const slugPathFieldName =\n    collectionConfig.hierarchy.slugPathFieldName || HIERARCHY_SLUG_PATH_FIELD\n  const titlePathFieldName =\n    collectionConfig.hierarchy.titlePathFieldName || HIERARCHY_TITLE_PATH_FIELD\n  const allowHasMany = collectionConfig.hierarchy.allowHasMany ?? DEFAULT_ALLOW_HAS_MANY\n  const rawCollectionSpecific = collectionConfig.hierarchy.collectionSpecific\n  const collectionSpecific: { fieldName: string } | false =\n    rawCollectionSpecific === true\n      ? { fieldName: 'hierarchyType' }\n      : rawCollectionSpecific\n        ? { fieldName: rawCollectionSpecific.fieldName ?? 'hierarchyType' }\n        : false\n  const joinField = collectionConfig.hierarchy.joinField\n    ? collectionConfig.hierarchy.joinField\n    : undefined\n  const slugify =\n    collectionConfig.hierarchy.slugify ?? ((text: string) => defaultSlugify(text) ?? '')\n  const treeLimit = collectionConfig.hierarchy.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT\n  const iconComponent = collectionConfig.hierarchy.admin?.components?.Icon\n  const smallIconComponent = collectionConfig.hierarchy.admin?.components?.SmallIcon\n\n  const slugField = collectionConfig.hierarchy.slugField\n\n  // Apply hierarchy to collection (adds fields and hooks)\n  addHierarchyToCollection({\n    collectionConfig,\n    parentFieldName: collectionConfig.hierarchy.parentFieldName,\n    slugFieldName: slugField,\n    slugPathFieldName,\n    titlePathFieldName,\n  })\n\n  // If collectionSpecific, add beforeValidate hook to enforce scope inheritance\n  // (hierarchyType field is added in resolveHierarchyCollections after discovery)\n  if (collectionSpecific) {\n    // Use parentFieldName for both - backward compatible configs use the same field name everywhere\n    if (!collectionConfig.hooks) {\n      collectionConfig.hooks = {}\n    }\n    if (!collectionConfig.hooks.beforeValidate) {\n      collectionConfig.hooks.beforeValidate = []\n    }\n    collectionConfig.hooks.beforeValidate.push(\n      ensureSafeCollectionsChange({\n        folderFieldName: parentFieldName,\n        foldersSlug: collectionConfig.slug,\n        parentFieldName,\n        typeFieldName: collectionSpecific.fieldName,\n      }),\n    )\n  }\n\n  // Set sanitized hierarchy config (cast needed as we're transitioning from HierarchyConfig to SanitizedHierarchyConfig)\n  const useHeaderButton = collectionConfig.hierarchy.admin?.useHeaderButton ?? false\n  const injectSidebarTab = collectionConfig.hierarchy.admin?.injectSidebarTab ?? true\n\n  ;(collectionConfig as unknown as { hierarchy: SanitizedHierarchyConfig }).hierarchy = {\n    admin: {\n      components: {\n        Icon: iconComponent || '@payloadcms/ui#TagIcon',\n        SmallIcon: smallIconComponent || iconComponent || '@payloadcms/ui#TagIcon',\n      },\n      injectSidebarTab,\n      treeLimit,\n      useHeaderButton,\n    },\n    allowHasMany,\n    collectionSpecific,\n    joinField,\n    parentFieldName,\n    relatedCollections: {},\n    slugField,\n    slugify,\n    slugPathFieldName,\n    titlePathFieldName,\n  }\n}\n"],"names":["fieldAffectsData","slugify","defaultSlugify","addHierarchyToCollection","buildParentField","DEFAULT_ALLOW_HAS_MANY","DEFAULT_HIERARCHY_TREE_LIMIT","getHierarchyFieldName","HIERARCHY_SLUG_PATH_FIELD","HIERARCHY_TITLE_PATH_FIELD","ensureSafeCollectionsChange","sanitizeHierarchyCollection","collectionConfig","_config","hierarchy","defaultParentFieldName","slug","parentFieldName","existingParentField","fields","find","field","name","type","Error","hasMany","localized","useHeaderButton","admin","parentField","collectionSlug","injectHeaderButton","unshift","slugPathFieldName","titlePathFieldName","allowHasMany","rawCollectionSpecific","collectionSpecific","fieldName","joinField","undefined","text","treeLimit","iconComponent","components","Icon","smallIconComponent","SmallIcon","slugField","slugFieldName","hooks","beforeValidate","push","folderFieldName","foldersSlug","typeFieldName","injectSidebarTab","relatedCollections"],"mappings":"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"}

package/dist/hierarchy/types.d.ts

@@ -23,9 +23,15 @@ export type HierarchyConfig = {
          */
         components?: {
             /**
-             * Custom icon component for hierarchy items
+             * Custom icon component for hierarchy items.
+             * - 24x24 size icon.
              */
             Icon?: PayloadComponent;
+            /**
+             * Small icon component for compact hierarchy contexts:
+             * - 16x16 size icon.
+             */
+            SmallIcon?: PayloadComponent;
         };
         /**
          * Whether to inject a sidebar tab for this hierarchy collection
@@ -107,6 +113,7 @@ export type SanitizedHierarchyConfig = {
     admin: {
         components: {
             Icon: PayloadComponent;
+            SmallIcon: PayloadComponent;
         };
         injectSidebarTab: boolean;
         treeLimit: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hierarchy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE;QACN;;WAEG;QACH,UAAU,CAAC,EAAE;YACX;;eAEG;YACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;SACxB,CAAA;QACD;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;IACD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,kBAAkB,CAAC,EACf;QACE;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GACD,OAAO,CAAA;IACX;;;;;OAKG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAA;IACpC;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE;QACL,UAAU,EAAE;YACV,IAAI,EAAE,gBAAgB,CAAA;SACvB,CAAA;QACD,gBAAgB,EAAE,OAAO,CAAA;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,eAAe,EAAE,OAAO,CAAA;KACzB,CAAA;IACD,YAAY,EAAE,OAAO,CAAA;IACrB,kBAAkB,EACd;QACE,SAAS,EAAE,MAAM,CAAA;KAClB,GACD,KAAK,CAAA;IACT;;OAEG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAA;IACpC,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAA;IACvE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hierarchy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE;QACN;;WAEG;QACH,UAAU,CAAC,EAAE;YACX;;;eAGG;YACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;YACvB;;;eAGG;YACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;SAC7B,CAAA;QACD;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;IACD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,kBAAkB,CAAC,EACf;QACE;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GACD,OAAO,CAAA;IACX;;;;;OAKG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAA;IACpC;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE;QACL,UAAU,EAAE;YACV,IAAI,EAAE,gBAAgB,CAAA;YACtB,SAAS,EAAE,gBAAgB,CAAA;SAC5B,CAAA;QACD,gBAAgB,EAAE,OAAO,CAAA;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,eAAe,EAAE,OAAO,CAAA;KACzB,CAAA;IACD,YAAY,EAAE,OAAO,CAAA;IACrB,kBAAkB,EACd;QACE,SAAS,EAAE,MAAM,CAAA;KAClB,GACD,KAAK,CAAA;IACT;;OAEG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAA;IACpC,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAA;IACvE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA"}

package/dist/hierarchy/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hierarchy/types.ts"],"sourcesContent":["import type { PayloadComponent } from '../config/types.js'\nimport type { JoinField } from '../fields/config/types.js'\n\n/**\n * User-configurable options for the hierarchy join field.\n * Excludes properties that are auto-generated: type, collection, on, hasMany\n */\nexport type HierarchyJoinFieldConfig = {\n  name: string\n} & Omit<Partial<JoinField>, 'collection' | 'hasMany' | 'name' | 'on' | 'type'>\n\n/**\n * Configuration options for hierarchy feature\n *\n * Hierarchies are always self-referential - documents can only nest under other documents\n * from the same collection.\n */\nexport type HierarchyConfig = {\n  /**\n   * UI configuration for hierarchy\n   */\n  admin?: {\n    /**\n     * Custom components for hierarchy UI\n     */\n    components?: {\n      /**\n       * Custom icon component for hierarchy items\n       */\n      Icon?: PayloadComponent\n    }\n    /**\n     * Whether to inject a sidebar tab for this hierarchy collection\n     * @default true\n     */\n    injectSidebarTab?: boolean\n    /**\n     * Maximum number of items to load in tree views\n     * @default 100\n     */\n    treeLimit?: number\n    /**\n     * Whether to use a header button for parent selection instead of inline field.\n     * When true, the parent field is hidden and a button is injected into the document header.\n     * @default true\n     */\n    useHeaderButton?: boolean\n  }\n  /**\n   * Whether related documents can have multiple values of this hierarchy\n   * Set to false for folder-like behavior (single parent), true for tag-like behavior (multiple)\n   * @default true\n   */\n  allowHasMany?: boolean\n  /**\n   * Whether this hierarchy is scoped to specific collections\n   * When true or an object, hierarchy items can be restricted to certain collections\n   * @default false\n   */\n  collectionSpecific?:\n    | {\n        /**\n         * Name of the select field for specifying allowed collections\n         * @default 'hierarchyType'\n         */\n        fieldName?: string\n      }\n    | boolean\n  /**\n   * Configure a join field to query all children (nested hierarchy items and related documents)\n   * If not set, no join field is created.\n   * You can pass additional JoinField options (admin, defaultLimit, defaultSort, etc.)\n   * that will be merged with the auto-generated config.\n   */\n  joinField?: HierarchyJoinFieldConfig\n  /**\n   * Name of the field that references the parent document\n   * Will automatically create this field if it does not exist\n   * @default '_h_${collectionSlug}' (e.g., '_h_folders' for a collection with slug 'folders')\n   */\n  parentFieldName: string\n  /**\n   * Name of the field to use for slug path generation.\n   * When set, uses this field's value directly instead of slugifying the title.\n   * Useful when you have a dedicated slug field (e.g., 'slug') separate from the title.\n   * @example 'slug' - uses the 'slug' field value as-is for path segments\n   */\n  slugField?: string\n  /**\n   * Custom function to slugify text for path generation\n   * Used by computeSlugPath() utility for generating slug-based breadcrumb paths\n   * Only used when slugField is not set.\n   * Defaults to internal slugify implementation\n   */\n  slugify?: (text: string) => string\n  /**\n   * Name of the virtual field that will contain the slug-based breadcrumb path\n   * @default HIERARCHY_SLUG_PATH_FIELD ('_h_slugPath')\n   */\n  slugPathFieldName?: string\n  /**\n   * Name of the virtual field that will contain the title-based breadcrumb path\n   * @default HIERARCHY_TITLE_PATH_FIELD ('_h_titlePath')\n   */\n  titlePathFieldName?: string\n}\n\n/**\n * Sanitized hierarchy configuration with all defaults applied\n */\nexport type SanitizedHierarchyConfig = {\n  admin: {\n    components: {\n      Icon: PayloadComponent\n    }\n    injectSidebarTab: boolean\n    treeLimit: number\n    useHeaderButton: boolean\n  }\n  allowHasMany: boolean\n  collectionSpecific:\n    | {\n        fieldName: string\n      }\n    | false\n  /**\n   * Join field configuration, or undefined if not enabled\n   */\n  joinField?: HierarchyJoinFieldConfig\n  parentFieldName: string\n  /**\n   * Auto-populated during validation - maps collection slug to field info\n   */\n  relatedCollections: Record<string, SanitizedHierarchyRelatedCollection>\n  /**\n   * Field name for slug values, or undefined to use slugified title\n   */\n  slugField?: string\n  slugify: (text: string) => string\n  slugPathFieldName: string\n  titlePathFieldName: string\n}\n\n/**\n * Information about how a collection relates to this hierarchy\n */\nexport type SanitizedHierarchyRelatedCollection = {\n  fieldName: string\n  hasMany: boolean\n}\n\n/**\n * Client-safe hierarchy configuration (excludes functions that can't cross server-client boundary)\n */\nexport type ClientHierarchyConfig = Omit<SanitizedHierarchyConfig, 'slugify'>\n\n/**\n * Breadcrumb item for folder hierarchies\n * @deprecated Use hierarchy breadcrumbs instead\n */\nexport type FolderBreadcrumb = {\n  id: number | string\n  name: string\n}\n"],"names":[],"mappings":"AA4JA;;;CAGC,GACD,WAGC"}
+{"version":3,"sources":["../../src/hierarchy/types.ts"],"sourcesContent":["import type { PayloadComponent } from '../config/types.js'\nimport type { JoinField } from '../fields/config/types.js'\n\n/**\n * User-configurable options for the hierarchy join field.\n * Excludes properties that are auto-generated: type, collection, on, hasMany\n */\nexport type HierarchyJoinFieldConfig = {\n  name: string\n} & Omit<Partial<JoinField>, 'collection' | 'hasMany' | 'name' | 'on' | 'type'>\n\n/**\n * Configuration options for hierarchy feature\n *\n * Hierarchies are always self-referential - documents can only nest under other documents\n * from the same collection.\n */\nexport type HierarchyConfig = {\n  /**\n   * UI configuration for hierarchy\n   */\n  admin?: {\n    /**\n     * Custom components for hierarchy UI\n     */\n    components?: {\n      /**\n       * Custom icon component for hierarchy items.\n       * - 24x24 size icon.\n       */\n      Icon?: PayloadComponent\n      /**\n       * Small icon component for compact hierarchy contexts:\n       * - 16x16 size icon.\n       */\n      SmallIcon?: PayloadComponent\n    }\n    /**\n     * Whether to inject a sidebar tab for this hierarchy collection\n     * @default true\n     */\n    injectSidebarTab?: boolean\n    /**\n     * Maximum number of items to load in tree views\n     * @default 100\n     */\n    treeLimit?: number\n    /**\n     * Whether to use a header button for parent selection instead of inline field.\n     * When true, the parent field is hidden and a button is injected into the document header.\n     * @default true\n     */\n    useHeaderButton?: boolean\n  }\n  /**\n   * Whether related documents can have multiple values of this hierarchy\n   * Set to false for folder-like behavior (single parent), true for tag-like behavior (multiple)\n   * @default true\n   */\n  allowHasMany?: boolean\n  /**\n   * Whether this hierarchy is scoped to specific collections\n   * When true or an object, hierarchy items can be restricted to certain collections\n   * @default false\n   */\n  collectionSpecific?:\n    | {\n        /**\n         * Name of the select field for specifying allowed collections\n         * @default 'hierarchyType'\n         */\n        fieldName?: string\n      }\n    | boolean\n  /**\n   * Configure a join field to query all children (nested hierarchy items and related documents)\n   * If not set, no join field is created.\n   * You can pass additional JoinField options (admin, defaultLimit, defaultSort, etc.)\n   * that will be merged with the auto-generated config.\n   */\n  joinField?: HierarchyJoinFieldConfig\n  /**\n   * Name of the field that references the parent document\n   * Will automatically create this field if it does not exist\n   * @default '_h_${collectionSlug}' (e.g., '_h_folders' for a collection with slug 'folders')\n   */\n  parentFieldName: string\n  /**\n   * Name of the field to use for slug path generation.\n   * When set, uses this field's value directly instead of slugifying the title.\n   * Useful when you have a dedicated slug field (e.g., 'slug') separate from the title.\n   * @example 'slug' - uses the 'slug' field value as-is for path segments\n   */\n  slugField?: string\n  /**\n   * Custom function to slugify text for path generation\n   * Used by computeSlugPath() utility for generating slug-based breadcrumb paths\n   * Only used when slugField is not set.\n   * Defaults to internal slugify implementation\n   */\n  slugify?: (text: string) => string\n  /**\n   * Name of the virtual field that will contain the slug-based breadcrumb path\n   * @default HIERARCHY_SLUG_PATH_FIELD ('_h_slugPath')\n   */\n  slugPathFieldName?: string\n  /**\n   * Name of the virtual field that will contain the title-based breadcrumb path\n   * @default HIERARCHY_TITLE_PATH_FIELD ('_h_titlePath')\n   */\n  titlePathFieldName?: string\n}\n\n/**\n * Sanitized hierarchy configuration with all defaults applied\n */\nexport type SanitizedHierarchyConfig = {\n  admin: {\n    components: {\n      Icon: PayloadComponent\n      SmallIcon: PayloadComponent\n    }\n    injectSidebarTab: boolean\n    treeLimit: number\n    useHeaderButton: boolean\n  }\n  allowHasMany: boolean\n  collectionSpecific:\n    | {\n        fieldName: string\n      }\n    | false\n  /**\n   * Join field configuration, or undefined if not enabled\n   */\n  joinField?: HierarchyJoinFieldConfig\n  parentFieldName: string\n  /**\n   * Auto-populated during validation - maps collection slug to field info\n   */\n  relatedCollections: Record<string, SanitizedHierarchyRelatedCollection>\n  /**\n   * Field name for slug values, or undefined to use slugified title\n   */\n  slugField?: string\n  slugify: (text: string) => string\n  slugPathFieldName: string\n  titlePathFieldName: string\n}\n\n/**\n * Information about how a collection relates to this hierarchy\n */\nexport type SanitizedHierarchyRelatedCollection = {\n  fieldName: string\n  hasMany: boolean\n}\n\n/**\n * Client-safe hierarchy configuration (excludes functions that can't cross server-client boundary)\n */\nexport type ClientHierarchyConfig = Omit<SanitizedHierarchyConfig, 'slugify'>\n\n/**\n * Breadcrumb item for folder hierarchies\n * @deprecated Use hierarchy breadcrumbs instead\n */\nexport type FolderBreadcrumb = {\n  id: number | string\n  name: string\n}\n"],"names":[],"mappings":"AAmKA;;;CAGC,GACD,WAGC"}