@justanarthur/payload-www 0.1.2 → 0.2.0

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;

package/dist/server.js

@@ -364,20 +364,25 @@ var createPagesCollection = (blocks, options = {}) => {
     renderPath = PAGES_RENDER_PATH,
     slug: collectionSlug = PAGES_SLUG2,
     localePrefix,
-    defaultLocale
+    defaultLocale,
+    nested = false
   } = options;
+  const slugPattern = nested ? /^[a-z0-9_-]+$/ : /^[a-z0-9-]+$/;
   const slugField = {
     name: "slug",
     type: "text",
     required: true,
     unique: true,
     index: true,
-    admin: { position: "sidebar" },
+    admin: {
+      position: "sidebar",
+      ...nested ? { description: "Lowercase, hyphens for words. Use the `_` divider for nesting, e.g. `about_us` → `/about/us`." } : {}
+    },
     validate: (value) => {
       if (typeof value !== "string")
         return "Slug must be a string";
-      if (value !== "" && !/^[a-z0-9-]+$/.test(value)) {
-        return "Slug must be lowercase, with hyphens (no spaces or special characters)";
+      if (value !== "" && !slugPattern.test(value)) {
+        return nested ? "Slug must be lowercase, with hyphens or the `_` nesting divider (no spaces or other special characters)" : "Slug must be lowercase, with hyphens (no spaces or special characters)";
       }
       return true;
     }
@@ -589,7 +594,8 @@ var link = (options = {}) => {
     disableLabel = false,
     relationTo = [PAGES_SLUG],
     localized = false,
-    overrides = {}
+    overrides = {},
+    extraFields = []
   } = options;
   const result = {
     name: "link",
@@ -666,6 +672,9 @@ var link = (options = {}) => {
       options: opts
     });
   }
+  if (extraFields.length) {
+    result.fields.push(...extraFields);
+  }
   return { ...result, ...overrides };
 };
 
@@ -685,17 +694,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",
@@ -717,17 +731,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",
@@ -925,6 +944,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,
@@ -940,13 +960,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,
@@ -977,7 +998,7 @@ function createSitemapFile(options) {
 }
 // src/config/createWWWConfig.ts
 function createWWWConfig(options) {
-  const { locales, routing, blocks, linkRelationTo, registerPosts = true, defaultPlugins } = options;
+  const { locales, routing, blocks, linkRelationTo, registerPosts = true, nested = false, defaultPlugins } = options;
   const defaultLocale = routing?.defaultLocale ?? locales[0] ?? "";
   const localePrefixMode = (() => {
     const raw = routing?.localePrefix;
@@ -990,7 +1011,8 @@ function createWWWConfig(options) {
   }
   const buildPagesCollection = () => createPagesCollection(blocks, {
     localePrefix: localePrefixMode,
-    defaultLocale
+    defaultLocale,
+    nested
   });
   const buildPostsCollection = () => createPostsCollection({
     localePrefix: localePrefixMode,
@@ -1635,7 +1657,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;
@@ -1654,7 +1677,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)
@@ -1679,7 +1702,7 @@ function createCollectionPageExports({
       locale,
       urlPrefix: "",
       storedSlug,
-      nested: false,
+      nested,
       homeSlug: HOME_SLUG,
       defaultLocale,
       locales,
@@ -1704,7 +1727,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");
@@ -1727,7 +1750,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__ */ jsx7("script", {
@@ -1777,7 +1799,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 } };
@@ -1801,7 +1823,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" }];
@@ -1872,7 +1894,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/test.js

@@ -201,20 +201,25 @@ var createPagesCollection = (blocks, options = {}) => {
     renderPath = PAGES_RENDER_PATH,
     slug: collectionSlug = PAGES_SLUG2,
     localePrefix,
-    defaultLocale
+    defaultLocale,
+    nested = false
   } = options;
+  const slugPattern = nested ? /^[a-z0-9_-]+$/ : /^[a-z0-9-]+$/;
   const slugField = {
     name: "slug",
     type: "text",
     required: true,
     unique: true,
     index: true,
-    admin: { position: "sidebar" },
+    admin: {
+      position: "sidebar",
+      ...nested ? { description: "Lowercase, hyphens for words. Use the `_` divider for nesting, e.g. `about_us` → `/about/us`." } : {}
+    },
     validate: (value) => {
       if (typeof value !== "string")
         return "Slug must be a string";
-      if (value !== "" && !/^[a-z0-9-]+$/.test(value)) {
-        return "Slug must be lowercase, with hyphens (no spaces or special characters)";
+      if (value !== "" && !slugPattern.test(value)) {
+        return nested ? "Slug must be lowercase, with hyphens or the `_` nesting divider (no spaces or other special characters)" : "Slug must be lowercase, with hyphens (no spaces or special characters)";
       }
       return true;
     }
@@ -426,7 +431,8 @@ var link = (options = {}) => {
     disableLabel = false,
     relationTo = [PAGES_SLUG],
     localized = false,
-    overrides = {}
+    overrides = {},
+    extraFields = []
   } = options;
   const result = {
     name: "link",
@@ -503,6 +509,9 @@ var link = (options = {}) => {
       options: opts
     });
   }
+  if (extraFields.length) {
+    result.fields.push(...extraFields);
+  }
   return { ...result, ...overrides };
 };
 
@@ -522,17 +531,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",
@@ -554,17 +568,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",
@@ -762,6 +781,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,
@@ -777,13 +797,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,
@@ -814,7 +835,7 @@ function createSitemapFile(options) {
 }
 // src/config/createWWWConfig.ts
 function createWWWConfig(options) {
-  const { locales, routing, blocks, linkRelationTo, registerPosts = true, defaultPlugins } = options;
+  const { locales, routing, blocks, linkRelationTo, registerPosts = true, nested = false, defaultPlugins } = options;
   const defaultLocale = routing?.defaultLocale ?? locales[0] ?? "";
   const localePrefixMode = (() => {
     const raw = routing?.localePrefix;
@@ -827,7 +848,8 @@ function createWWWConfig(options) {
   }
   const buildPagesCollection = () => createPagesCollection(blocks, {
     localePrefix: localePrefixMode,
-    defaultLocale
+    defaultLocale,
+    nested
   });
   const buildPostsCollection = () => createPostsCollection({
     localePrefix: localePrefixMode,

package/dist/with-www-config.d.ts

@@ -58,6 +58,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

package/dist/with-www-config.js

@@ -195,20 +195,25 @@ var createPagesCollection = (blocks, options = {}) => {
     renderPath = PAGES_RENDER_PATH,
     slug: collectionSlug = PAGES_SLUG2,
     localePrefix,
-    defaultLocale
+    defaultLocale,
+    nested = false
   } = options;
+  const slugPattern = nested ? /^[a-z0-9_-]+$/ : /^[a-z0-9-]+$/;
   const slugField = {
     name: "slug",
     type: "text",
     required: true,
     unique: true,
     index: true,
-    admin: { position: "sidebar" },
+    admin: {
+      position: "sidebar",
+      ...nested ? { description: "Lowercase, hyphens for words. Use the `_` divider for nesting, e.g. `about_us` → `/about/us`." } : {}
+    },
     validate: (value) => {
       if (typeof value !== "string")
         return "Slug must be a string";
-      if (value !== "" && !/^[a-z0-9-]+$/.test(value)) {
-        return "Slug must be lowercase, with hyphens (no spaces or special characters)";
+      if (value !== "" && !slugPattern.test(value)) {
+        return nested ? "Slug must be lowercase, with hyphens or the `_` nesting divider (no spaces or other special characters)" : "Slug must be lowercase, with hyphens (no spaces or special characters)";
       }
       return true;
     }
@@ -420,7 +425,8 @@ var link = (options = {}) => {
     disableLabel = false,
     relationTo = [PAGES_SLUG],
     localized = false,
-    overrides = {}
+    overrides = {},
+    extraFields = []
   } = options;
   const result = {
     name: "link",
@@ -497,6 +503,9 @@ var link = (options = {}) => {
       options: opts
     });
   }
+  if (extraFields.length) {
+    result.fields.push(...extraFields);
+  }
   return { ...result, ...overrides };
 };
 
@@ -516,17 +525,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",
@@ -548,17 +562,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",
@@ -756,6 +775,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,
@@ -771,13 +791,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,
@@ -808,7 +829,7 @@ function createSitemapFile(options) {
 }
 // src/config/createWWWConfig.ts
 function createWWWConfig(options) {
-  const { locales, routing, blocks, linkRelationTo, registerPosts = true, defaultPlugins } = options;
+  const { locales, routing, blocks, linkRelationTo, registerPosts = true, nested = false, defaultPlugins } = options;
   const defaultLocale = routing?.defaultLocale ?? locales[0] ?? "";
   const localePrefixMode = (() => {
     const raw = routing?.localePrefix;
@@ -821,7 +842,8 @@ function createWWWConfig(options) {
   }
   const buildPagesCollection = () => createPagesCollection(blocks, {
     localePrefix: localePrefixMode,
-    defaultLocale
+    defaultLocale,
+    nested
   });
   const buildPostsCollection = () => createPostsCollection({
     localePrefix: localePrefixMode,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justanarthur/payload-www",
   "description": "Reusable Payload CMS website template — config builder, collections, globals, blocks, fields, access, hooks, metadata (JSON-LD, hreflang), page renderers, and test helpers.",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "private": false,
   "module": "./dist/index.js",