@justanarthur/payload-www 0.1.2 → 0.3.0

package/dist/globals.js

@@ -36,7 +36,8 @@ var link = (options = {}) => {
     disableLabel = false,
     relationTo = [PAGES_SLUG],
     localized = false,
-    overrides = {}
+    overrides = {},
+    extraFields = []
   } = options;
   const result = {
     name: "link",
@@ -113,6 +114,9 @@ var link = (options = {}) => {
       options: opts
     });
   }
+  if (extraFields.length) {
+    result.fields.push(...extraFields);
+  }
   return { ...result, ...overrides };
 };
 
@@ -157,17 +161,22 @@ function createRevalidateGlobalHook(slug) {
 
 // src/data/collections/globals/Header/config.ts
 var createHeaderGlobal = (options = {}) => {
-  const { renderPath = HEADER_RENDER_PATH, linkRelationTo = [PAGES_SLUG] } = options;
+  const {
+    renderPath = HEADER_RENDER_PATH,
+    linkRelationTo = [PAGES_SLUG],
+    navColumnLinkFields = [],
+    navItemLinkFields = []
+  } = options;
   const navColumnBlock = {
     slug: "navColumn",
     fields: [
       { name: "title", type: "text", required: true, localized: true },
-      { name: "links", type: "array", fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo })] }
+      { name: "links", type: "array", fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo, extraFields: navColumnLinkFields })] }
     ]
   };
   const navItemBlock = {
     slug: "navItem",
-    fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo })]
+    fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo, extraFields: navItemLinkFields })]
   };
   return {
     slug: "header",
@@ -189,17 +198,22 @@ var createHeaderGlobal = (options = {}) => {
 
 // src/data/collections/globals/Footer/config.ts
 var createFooterGlobal = (options = {}) => {
-  const { renderPath = FOOTER_RENDER_PATH, linkRelationTo = [PAGES_SLUG] } = options;
+  const {
+    renderPath = FOOTER_RENDER_PATH,
+    linkRelationTo = [PAGES_SLUG],
+    navColumnLinkFields = [],
+    navItemLinkFields = []
+  } = options;
   const navColumnBlock = {
     slug: "navColumn",
     fields: [
       { name: "title", type: "text", required: true, localized: true },
-      { name: "links", type: "array", fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo })] }
+      { name: "links", type: "array", fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo, extraFields: navColumnLinkFields })] }
     ]
   };
   const navItemBlock = {
     slug: "navItem",
-    fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo })]
+    fields: [link({ appearances: false, localized: true, relationTo: linkRelationTo, extraFields: navItemLinkFields })]
   };
   return {
     slug: "footer",

package/dist/metadata.js

@@ -262,7 +262,19 @@ var queryAllLocaleSlugs = cache(async function queryAllLocaleSlugs2({
   const doc = result.docs?.[0];
   if (!doc)
     return;
-  const fieldValue = doc?.[slugField];
+  let fieldValue = doc[slugField];
+  if (doc.id != null) {
+    const allLocales = await payload.findByID({
+      collection: collectionSlug,
+      id: doc.id,
+      locale: "all",
+      draft: false,
+      overrideAccess: false,
+      select: { [slugField]: true }
+    }).catch(() => null);
+    if (allLocales)
+      fieldValue = allLocales[slugField];
+  }
   if (fieldValue && typeof fieldValue === "object") {
     return fieldValue;
   }

package/dist/pages.d.ts

@@ -207,6 +207,19 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	* defined your own Server Component for the collection.
 	*/
 	renderPath?: string;
+	/**
+	* Enable nested (hierarchical) slugs. When `true`, the catch-all
+	* `[...slug]` segments are joined with the `_` divider to form the
+	* stored slug (URL `/about/us` ⇄ stored `about_us`), URL paths and
+	* hreflang alternates are expanded back to `/about/us`, and
+	* `generateStaticParams` emits multi-segment params. When `false`
+	* (the default) only the first URL segment is used — flat slugs.
+	*
+	* Pair with `createPagesCollection({ nested: true })` (or
+	* `createWWWConfig({ nested: true })`) so the collection's slug
+	* validation accepts the `_` divider.
+	*/
+	nested?: boolean;
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	/**
@@ -285,7 +298,7 @@ type CreateCollectionPageExportsDeps<S extends string> = {
 *   { generateMetadata, generateStaticParams }
 *   Page
 */
-declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath, nested }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
 	default: (props: {
 		params: Promise<{
 			locale?: string;

package/dist/pages.js

@@ -639,7 +639,19 @@ var queryAllLocaleSlugs = cache(async function queryAllLocaleSlugs2({
   const doc = result.docs?.[0];
   if (!doc)
     return;
-  const fieldValue = doc?.[slugField];
+  let fieldValue = doc[slugField];
+  if (doc.id != null) {
+    const allLocales = await payload.findByID({
+      collection: collectionSlug,
+      id: doc.id,
+      locale: "all",
+      draft: false,
+      overrideAccess: false,
+      select: { [slugField]: true }
+    }).catch(() => null);
+    if (allLocales)
+      fieldValue = allLocales[slugField];
+  }
   if (fieldValue && typeof fieldValue === "object") {
     return fieldValue;
   }
@@ -687,7 +699,8 @@ function createCollectionPageExports({
   config: configPromise,
   routing,
   importMap: importMapArg,
-  renderPath
+  renderPath,
+  nested = false
 }, deps, options = {}) {
   const importMap = importMapArg ?? {};
   const { jsonLd: jsonLdOption = true, changefreq = "weekly", priority = 0.5, websiteName } = options;
@@ -706,7 +719,7 @@ function createCollectionPageExports({
   const defaultRenderPath = slug === POSTS_SLUG ? POSTS_RENDER_PATH : PAGES_RENDER_PATH;
   const localePrefixMode = typeof routing.localePrefix === "string" ? routing.localePrefix : routing.localePrefix?.mode ?? "always";
   const buildLocalePath = (locale, storedSlug) => {
-    const urlPath = getUrlPath(storedSlug, false, HOME_SLUG);
+    const urlPath = getUrlPath(storedSlugToSegments(storedSlug, nested), nested, HOME_SLUG);
     if (localePrefixMode === "never")
       return urlPath;
     if (localePrefixMode === "as-needed" && locale === defaultLocale)
@@ -731,7 +744,7 @@ function createCollectionPageExports({
       locale,
       urlPrefix: "",
       storedSlug,
-      nested: false,
+      nested,
       homeSlug: HOME_SLUG,
       defaultLocale,
       locales,
@@ -756,7 +769,7 @@ function createCollectionPageExports({
     setRequestLocale(locale);
     const { draftMode } = await import("next/headers");
     const { isEnabled: draft } = await draftMode();
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const doc = await fetchDoc(locale, storedSlug, draft);
     if (!doc) {
       const { notFound } = await import("next/navigation");
@@ -779,7 +792,6 @@ function createCollectionPageExports({
     });
     const jsonLdNodes = doc ? await generateJsonLd(slugSegments, doc, locale) : [];
     const { alternates: hreflangAlternates, canonical } = await resolveHreflangAlternates(locale, storedSlug);
-    console.log("render", { render, doc });
     const inner = /* @__PURE__ */ jsxs5(Fragment6, {
       children: [
         jsonLdNodes.map(({ id, schema }) => /* @__PURE__ */ jsx8("script", {
@@ -829,7 +841,7 @@ function createCollectionPageExports({
     const locale = typeof incomingLocale === "string" ? incomingLocale : defaultLocale;
     if (!locales.includes(locale))
       return { title: "Not found", robots: { index: false, follow: false } };
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const doc = await fetchDoc(locale, storedSlug);
     if (!doc)
       return { title: "Not found", robots: { index: false, follow: false } };
@@ -853,7 +865,7 @@ function createCollectionPageExports({
     if (jsonLdOption === false || !doc)
       return [];
     const siteUrl = getServerSideURL();
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const urlPath = buildLocalePath(locale, storedSlug);
     const canonical = `${siteUrl}${urlPath}`;
     const entries = Array.isArray(jsonLdOption) ? jsonLdOption : metadataType === "article" ? [{ type: "article" }] : [{ type: "website" }];
@@ -924,7 +936,7 @@ function createCollectionPageExports({
         const slugVal = doc.slug;
         if (typeof slugVal !== "string" || slugVal === "")
           continue;
-        const segments = storedSlugToSegments(slugVal, false);
+        const segments = storedSlugToSegments(slugVal, nested);
         params.push({ slug: Array.isArray(segments) ? segments : [segments], locale });
       }
     }

package/dist/render-metadata.js

@@ -262,7 +262,19 @@ var queryAllLocaleSlugs = cache(async function queryAllLocaleSlugs2({
   const doc = result.docs?.[0];
   if (!doc)
     return;
-  const fieldValue = doc?.[slugField];
+  let fieldValue = doc[slugField];
+  if (doc.id != null) {
+    const allLocales = await payload.findByID({
+      collection: collectionSlug,
+      id: doc.id,
+      locale: "all",
+      draft: false,
+      overrideAccess: false,
+      select: { [slugField]: true }
+    }).catch(() => null);
+    if (allLocales)
+      fieldValue = allLocales[slugField];
+  }
   if (fieldValue && typeof fieldValue === "object") {
     return fieldValue;
   }

package/dist/render-pages.d.ts

@@ -130,6 +130,19 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	* defined your own Server Component for the collection.
 	*/
 	renderPath?: string;
+	/**
+	* Enable nested (hierarchical) slugs. When `true`, the catch-all
+	* `[...slug]` segments are joined with the `_` divider to form the
+	* stored slug (URL `/about/us` ⇄ stored `about_us`), URL paths and
+	* hreflang alternates are expanded back to `/about/us`, and
+	* `generateStaticParams` emits multi-segment params. When `false`
+	* (the default) only the first URL segment is used — flat slugs.
+	*
+	* Pair with `createPagesCollection({ nested: true })` (or
+	* `createWWWConfig({ nested: true })`) so the collection's slug
+	* validation accepts the `_` divider.
+	*/
+	nested?: boolean;
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	/**
@@ -208,7 +221,7 @@ type CreateCollectionPageExportsDeps<S extends string> = {
 *   { generateMetadata, generateStaticParams }
 *   Page
 */
-declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath, nested }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
 	default: (props: {
 		params: Promise<{
 			locale?: string;

package/dist/render-pages.js

@@ -460,7 +460,19 @@ var queryAllLocaleSlugs = cache(async function queryAllLocaleSlugs2({
   const doc = result.docs?.[0];
   if (!doc)
     return;
-  const fieldValue = doc?.[slugField];
+  let fieldValue = doc[slugField];
+  if (doc.id != null) {
+    const allLocales = await payload.findByID({
+      collection: collectionSlug,
+      id: doc.id,
+      locale: "all",
+      draft: false,
+      overrideAccess: false,
+      select: { [slugField]: true }
+    }).catch(() => null);
+    if (allLocales)
+      fieldValue = allLocales[slugField];
+  }
   if (fieldValue && typeof fieldValue === "object") {
     return fieldValue;
   }
@@ -571,7 +583,8 @@ function createCollectionPageExports({
   config: configPromise,
   routing,
   importMap: importMapArg,
-  renderPath
+  renderPath,
+  nested = false
 }, deps, options = {}) {
   const importMap = importMapArg ?? {};
   const { jsonLd: jsonLdOption = true, changefreq = "weekly", priority = 0.5, websiteName } = options;
@@ -590,7 +603,7 @@ function createCollectionPageExports({
   const defaultRenderPath = slug === POSTS_SLUG ? POSTS_RENDER_PATH : PAGES_RENDER_PATH;
   const localePrefixMode = typeof routing.localePrefix === "string" ? routing.localePrefix : routing.localePrefix?.mode ?? "always";
   const buildLocalePath = (locale, storedSlug) => {
-    const urlPath = getUrlPath(storedSlug, false, HOME_SLUG);
+    const urlPath = getUrlPath(storedSlugToSegments(storedSlug, nested), nested, HOME_SLUG);
     if (localePrefixMode === "never")
       return urlPath;
     if (localePrefixMode === "as-needed" && locale === defaultLocale)
@@ -615,7 +628,7 @@ function createCollectionPageExports({
       locale,
       urlPrefix: "",
       storedSlug,
-      nested: false,
+      nested,
       homeSlug: HOME_SLUG,
       defaultLocale,
       locales,
@@ -640,7 +653,7 @@ function createCollectionPageExports({
     setRequestLocale(locale);
     const { draftMode } = await import("next/headers");
     const { isEnabled: draft } = await draftMode();
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const doc = await fetchDoc(locale, storedSlug, draft);
     if (!doc) {
       const { notFound } = await import("next/navigation");
@@ -663,7 +676,6 @@ function createCollectionPageExports({
     });
     const jsonLdNodes = doc ? await generateJsonLd(slugSegments, doc, locale) : [];
     const { alternates: hreflangAlternates, canonical } = await resolveHreflangAlternates(locale, storedSlug);
-    console.log("render", { render, doc });
     const inner = /* @__PURE__ */ jsxs3(Fragment4, {
       children: [
         jsonLdNodes.map(({ id, schema }) => /* @__PURE__ */ jsx6("script", {
@@ -713,7 +725,7 @@ function createCollectionPageExports({
     const locale = typeof incomingLocale === "string" ? incomingLocale : defaultLocale;
     if (!locales.includes(locale))
       return { title: "Not found", robots: { index: false, follow: false } };
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const doc = await fetchDoc(locale, storedSlug);
     if (!doc)
       return { title: "Not found", robots: { index: false, follow: false } };
@@ -737,7 +749,7 @@ function createCollectionPageExports({
     if (jsonLdOption === false || !doc)
       return [];
     const siteUrl = getServerSideURL();
-    const storedSlug = segmentsToStoredSlug(slugSegments, false);
+    const storedSlug = segmentsToStoredSlug(slugSegments, nested);
     const urlPath = buildLocalePath(locale, storedSlug);
     const canonical = `${siteUrl}${urlPath}`;
     const entries = Array.isArray(jsonLdOption) ? jsonLdOption : metadataType === "article" ? [{ type: "article" }] : [{ type: "website" }];
@@ -808,7 +820,7 @@ function createCollectionPageExports({
         const slugVal = doc.slug;
         if (typeof slugVal !== "string" || slugVal === "")
           continue;
-        const segments = storedSlugToSegments(slugVal, false);
+        const segments = storedSlugToSegments(slugVal, nested);
         params.push({ slug: Array.isArray(segments) ? segments : [segments], locale });
       }
     }

package/dist/render-utils.d.ts

@@ -89,6 +89,14 @@ type CreateSitemapFileOptions = {
 		priority?: number;
 		changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
 	}>;
+	/**
+	* Per-collection nested-slug flag. When a collection is marked
+	* `true`, its stored `about_us` slug is expanded into the
+	* `/about/us` URL path (and hreflang alternates), matching a
+	* `createCollectionPageExports({ nested: true })` route. Defaults
+	* to `false` (flat slugs) for every collection.
+	*/
+	nested?: Record<string, boolean>;
 };
 /**
 * A Next.js sitemap function for the host's

package/dist/render-utils.js

@@ -226,7 +226,19 @@ var queryAllLocaleSlugs = cache(async function queryAllLocaleSlugs2({
   const doc = result.docs?.[0];
   if (!doc)
     return;
-  const fieldValue = doc?.[slugField];
+  let fieldValue = doc[slugField];
+  if (doc.id != null) {
+    const allLocales2 = await payload.findByID({
+      collection: collectionSlug,
+      id: doc.id,
+      locale: "all",
+      draft: false,
+      overrideAccess: false,
+      select: { [slugField]: true }
+    }).catch(() => null);
+    if (allLocales2)
+      fieldValue = allLocales2[slugField];
+  }
   if (fieldValue && typeof fieldValue === "object") {
     return fieldValue;
   }
@@ -279,6 +291,7 @@ function createSitemapFile(options) {
       const collectionDefaults = options.perCollection?.[collectionSlug] ?? {};
       const urlPrefix = (options.urlPrefixes?.[collectionSlug] ?? "").replace(/\/$/, "");
       const siteUrl = options.getServerSideURL().replace(/\/$/, "");
+      const isNested = options.nested?.[collectionSlug] ?? false;
       for (const locale of activeLocales) {
         const docs = await queryAllDocs({
           collectionSlug,
@@ -294,13 +307,14 @@ function createSitemapFile(options) {
           if (seen.has(dedupeKey))
             continue;
           seen.add(dedupeKey);
-          const url = `${siteUrl}${prefixFor(locale, defaultLocale, options.localePrefix ?? "always")}${urlPrefix}/${storedSlug}`;
+          const slugPath = isNested ? storedSlug.replaceAll("_", "/") : storedSlug;
+          const url = `${siteUrl}${prefixFor(locale, defaultLocale, options.localePrefix ?? "always")}${urlPrefix}/${slugPath}`;
           const languages = await buildHreflangAlternates({
             siteUrl,
             locale,
             urlPrefix,
             storedSlug,
-            nested: false,
+            nested: isNested,
             homeSlug: "",
             defaultLocale,
             locales: activeLocales,

package/dist/server.d.ts

@@ -156,6 +156,19 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	* defined your own Server Component for the collection.
 	*/
 	renderPath?: string;
+	/**
+	* Enable nested (hierarchical) slugs. When `true`, the catch-all
+	* `[...slug]` segments are joined with the `_` divider to form the
+	* stored slug (URL `/about/us` ⇄ stored `about_us`), URL paths and
+	* hreflang alternates are expanded back to `/about/us`, and
+	* `generateStaticParams` emits multi-segment params. When `false`
+	* (the default) only the first URL segment is used — flat slugs.
+	*
+	* Pair with `createPagesCollection({ nested: true })` (or
+	* `createWWWConfig({ nested: true })`) so the collection's slug
+	* validation accepts the `_` divider.
+	*/
+	nested?: boolean;
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	/**
@@ -234,7 +247,7 @@ type CreateCollectionPageExportsDeps<S extends string> = {
 *   { generateMetadata, generateStaticParams }
 *   Page
 */
-declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug, config: configPromise, routing, importMap: importMapArg, renderPath, nested }: CreateCollectionPageExportsArgs<S>, deps: CreateCollectionPageExportsDeps<S>, options?: MetadataOptions): {
 	default: (props: {
 		params: Promise<{
 			locale?: string;
@@ -382,6 +395,14 @@ type CreatePagesCollectionOptions = {
 	* when omitted.
 	*/
 	defaultLocale?: CreateRevalidateCollectionHookOptions["defaultLocale"];
+	/**
+	* Enable nested (hierarchical) slugs. When `true`, the slug field
+	* additionally accepts the `_` nesting divider (so `about_us`
+	* renders at `/about/us`) and the admin description documents the
+	* convention. Pair with `createCollectionPageExports({ nested: true })`
+	* on the matching route. Default: `false` (flat, hyphen-only slugs).
+	*/
+	nested?: boolean;
 };
 declare const createPagesCollection: (blocks: Block[], options?: Omit<CreatePagesCollectionOptions, "blocks">) => CollectionConfig;
 import { CollectionConfig as CollectionConfig2 } from "payload";
@@ -439,7 +460,7 @@ type CreateStaticPagesCollectionOptions = {
 	blocks: Block2[];
 };
 declare const createStaticPagesCollection: (blocks: Block2[]) => CollectionConfig3;
-import { GlobalConfig } from "payload";
+import { Field, GlobalConfig } from "payload";
 type CreateHeaderGlobalOptions = {
 	/**
 	* Optional override for the `custom.path` Payload uses to resolve
@@ -453,6 +474,17 @@ type CreateHeaderGlobalOptions = {
 	* different list when your host has additional linkable collections.
 	*/
 	linkRelationTo?: string[];
+	/**
+	* Extra fields appended to each `navColumn` link — e.g. a
+	* `description` text field or a `navHover` group for a mega-menu.
+	* Lets hosts enrich the column-link schema without redefining the
+	* whole nav.
+	*/
+	navColumnLinkFields?: Field[];
+	/**
+	* Extra fields appended to each top-level `navItem` link.
+	*/
+	navItemLinkFields?: Field[];
 };
 /**
 * Build the Header global. The lib's default shape: a `nav` blocks
@@ -460,7 +492,7 @@ type CreateHeaderGlobalOptions = {
 * and `navItem` (a single link).
 */
 declare const createHeaderGlobal: (options?: CreateHeaderGlobalOptions) => GlobalConfig;
-import { GlobalConfig as GlobalConfig2 } from "payload";
+import { Field as Field2, GlobalConfig as GlobalConfig2 } from "payload";
 type CreateFooterGlobalOptions = {
 	/**
 	* Optional override for the `custom.path` Payload uses to resolve
@@ -474,6 +506,16 @@ type CreateFooterGlobalOptions = {
 	* different list when your host has additional linkable collections.
 	*/
 	linkRelationTo?: string[];
+	/**
+	* Extra fields appended to each `navColumn` link — e.g. a
+	* `description` text field. Lets hosts enrich the column-link
+	* schema without redefining the whole nav.
+	*/
+	navColumnLinkFields?: Field2[];
+	/**
+	* Extra fields appended to each top-level `navItem` link.
+	*/
+	navItemLinkFields?: Field2[];
 };
 /**
 * Build the Footer global. The lib's default shape mirrors the
@@ -517,6 +559,14 @@ type WWWConfigOptions = {
 	*/
 	registerPosts?: boolean;
 	/**
+	* Enable nested (hierarchical) Pages slugs. When `true`, the lib's
+	* Pages collection accepts the `_` nesting divider in its slug
+	* (`about_us` → `/about/us`). Pass the same `nested: true` to
+	* `createCollectionPageExports` on the Pages route so URL building,
+	* hreflang, and static params expand the divider. Default: `false`.
+	*/
+	nested?: boolean;
+	/**
 	* Final say on the lib's default plugin list. Receives the
 	* `[seoPlugin, imageHashPlugin, translator]` array; return the
 	* list to apply. Common uses: drop the translator (no AI
@@ -575,7 +625,7 @@ import { GlobalAfterChangeHook } from "payload";
 * uses.
 */
 declare function createRevalidateGlobalHook(slug: string): GlobalAfterChangeHook;
-import { Field, GroupField } from "payload";
+import { Field as Field3, GroupField } from "payload";
 type LinkAppearances = "default" | "outline";
 declare const appearanceOptions: Record<LinkAppearances, {
 	label: string;
@@ -597,10 +647,18 @@ type LinkOptions = {
 	overrides?: Partial<GroupField>;
 	/** Legacy alias for the host's custom field overrides. */
 	linkOverrides?: Partial<GroupField>;
+	/**
+	* Extra fields appended to the link group — e.g. a `description`
+	* text field or a `navHover` group for a mega-menu. Lets hosts
+	* extend the nav link schema without re-implementing the whole
+	* `link` field. Appended after the standard type/label/appearance
+	* fields.
+	*/
+	extraFields?: Field3[];
 };
-declare const link: (options?: LinkOptions) => Field;
-import { Field as Field2 } from "payload";
-declare const linkGroup: (options?: LinkOptions) => Field2;
+declare const link: (options?: LinkOptions) => Field3;
+import { Field as Field4 } from "payload";
+declare const linkGroup: (options?: LinkOptions) => Field4;
 import { ImportMap as ImportMap2 } from "payload";
 declare function getFromImportMap(key: string, importMap: ImportMap2): any;
 declare function generateImportName(type: "block" | "page", slug: string): string;