@justanarthur/payload-www 2.2.7 → 2.2.9

package/README.md

@@ -144,6 +144,7 @@ const { default: PostPage, generateMetadata, generateStaticParams } = createColl
 | `routing` | `RoutingConfig` | required | `{ locales, defaultLocale, localePrefix, labels? }` from `next-intl/routing`'s `defineRouting` |
 | `slug` | `string` | `'pages'` | collection slug to query |
 | `slugShape` | `'single' \| 'catch-all'` | `'single'` | drives `generateStaticParams` + slug segmentation |
+| `depth` | `number` | `2` | relationship / upload hops populated on the rendered document. `0` hands every media and relationship field to the render component as a bare id. Enumeration (`generateStaticParams`, `generateSitemap`) stays at `0` regardless. |
 
 ### `createCollectionPageExports(args, deps)` — deps
 
@@ -171,6 +172,7 @@ const { default: PostPage, generateMetadata, generateStaticParams } = createColl
 | `config` | `Promise<SanitizedConfig>` | required |
 | `importMap` | `ImportMap` | required |
 | `routing` | `RoutingConfig` | required |
+| `depth` | `number` | relationship / upload hops populated on the `header` + `footer` globals. Defaults to `2`. |
 
 | dep | type | notes |
 |---|---|---|

package/dist/collections.d.ts

@@ -20,6 +20,7 @@ type QueryDocArgs = ({
 	globalSlug: string;
 	locale: string;
 	draft?: boolean;
+	depth?: number;
 }) | ({
 	collectionSlug: string;
 	slug: string;

package/dist/collections.js

@@ -86,6 +86,32 @@ import { createCacheHelpers } from "@pro-laico/payload-revalidate/cache";
 import { tagsFor } from "@pro-laico/payload-revalidate";
 import { cacheLife } from "next/cache";
 import { getPayload } from "payload";
+
+// src/render/metadata/slug.ts
+var SLUG_NESTED_DIVIDER = "_";
+function paramsSlugToSlug(slug, _shape) {
+  if (!slug)
+    return "";
+  return (Array.isArray(slug) ? slug : [slug]).join(SLUG_NESTED_DIVIDER);
+}
+function slugToParamsSlug(slug, shape) {
+  if (!slug)
+    return shape === "catch-all" ? [] : "";
+  return shape === "catch-all" ? slug.split(SLUG_NESTED_DIVIDER) : slug;
+}
+function isIndexSlug(slug) {
+  return !slug;
+}
+function shapeHasIndexPath(shape) {
+  return shape === "catch-all";
+}
+function slugToPath(slug) {
+  if (!slug)
+    return "";
+  return slug.split(SLUG_NESTED_DIVIDER).join("/");
+}
+
+// src/render/metadata/query.ts
 var _helpers = null;
 var _seedPromise = null;
 function seedPayloadCache({ config }) {
@@ -106,19 +132,22 @@ async function requireCacheHelpers() {
   }
   throw new Error("[payload-www] seedPayloadCache({ config }) must be called before any query getter. " + "Call it from createCollectionPageExports / createRootLayoutExports factory, or in your root layout.");
 }
+var RENDER_DEPTH = 2;
 async function queryDocBySlug(args) {
   "use cache";
   cacheLife("weeks");
   const { findDoc } = await requireCacheHelpers();
   const slugField = args.slugField ?? "slug";
-  const result = await findDoc(args.collectionSlug, {
-    where: { [slugField]: { equals: args.slug } },
+  const find = (slug) => findDoc(args.collectionSlug, {
+    where: { [slugField]: { equals: slug } },
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
-  return result ?? null;
+  const result = await find(args.slug);
+  const doc = result ?? (isIndexSlug(args.slug) ? await find(null) : null);
+  return doc ?? null;
 }
 async function queryGlobal(args) {
   "use cache";
@@ -128,7 +157,7 @@ async function queryGlobal(args) {
     const result = await findGlobal(args.globalSlug, {
       locale: args.locale,
       draft: args.draft ?? false,
-      depth: args.depth
+      depth: args.depth ?? RENDER_DEPTH
     });
     return result ?? null;
   } catch (error) {
@@ -144,7 +173,7 @@ async function queryAllDocs(args) {
   const { ids } = await findIds(collection, { locale: args.locale, pagination: false, overrideAccess: false });
   if (ids.length === 0)
     return [];
-  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false })));
+  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false, depth: 0 })));
   return docs.filter((d) => d !== null);
 }
 async function queryDoc(args) {
@@ -171,7 +200,7 @@ async function queryDocByID(args) {
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
 }
 

package/dist/metadata.d.ts

@@ -20,6 +20,8 @@ import { BuildOrganizationLdOptions, BuildProductLdOptions, BuildRootJsonLdOptio
 type SlugShape = "single" | "catch-all";
 declare function paramsSlugToSlug(slug: string | string[] | undefined, _shape: SlugShape): string;
 declare function slugToParamsSlug(slug: string, shape: SlugShape): string | string[];
+declare function isIndexSlug(slug: string | null | undefined): boolean;
+declare function shapeHasIndexPath(shape: SlugShape): boolean;
 import { DataFromCollectionSlug, DataFromGlobalSlug, SanitizedConfig } from "payload";
 import { tagsFor } from "@pro-laico/payload-revalidate";
 type SeedPayloadCacheArgs = {
@@ -76,7 +78,9 @@ declare const metadata: {
 	queryAllLocaleSlugs: typeof queryAllLocaleSlugs;
 	paramsSlugToSlug: typeof paramsSlugToSlug;
 	slugToParamsSlug: typeof slugToParamsSlug;
+	isIndexSlug: typeof isIndexSlug;
+	shapeHasIndexPath: typeof shapeHasIndexPath;
 	seedPayloadCache: typeof seedPayloadCache;
 	tagsFor: (payload: Payload_eipjla) => Tags_1jpdl;
 };
-export { ArticleLdOptions, BreadcrumbItem, BuildOrganizationLdOptions, BuildProductLdOptions, BuildRootJsonLdOptions, BuildWebSiteLdOptions, SeedPayloadCacheArgs, SlugShape, buildArticleLd, buildBreadcrumbsLd, buildOrganizationLd, buildProductLd, buildRootJsonLd, buildWebSiteLd, metadata as default, paramsSlugToSlug, queryAllDocs, queryAllLocaleSlugs, queryDocByID, queryDocBySlug, queryGlobal, seedPayloadCache, slugToParamsSlug, tagsFor };
+export { ArticleLdOptions, BreadcrumbItem, BuildOrganizationLdOptions, BuildProductLdOptions, BuildRootJsonLdOptions, BuildWebSiteLdOptions, SeedPayloadCacheArgs, SlugShape, buildArticleLd, buildBreadcrumbsLd, buildOrganizationLd, buildProductLd, buildRootJsonLd, buildWebSiteLd, metadata as default, isIndexSlug, paramsSlugToSlug, queryAllDocs, queryAllLocaleSlugs, queryDocByID, queryDocBySlug, queryGlobal, seedPayloadCache, shapeHasIndexPath, slugToParamsSlug, tagsFor };

package/dist/metadata.js

@@ -103,6 +103,12 @@ function slugToParamsSlug(slug, shape) {
     return shape === "catch-all" ? [] : "";
   return shape === "catch-all" ? slug.split(SLUG_NESTED_DIVIDER) : slug;
 }
+function isIndexSlug(slug) {
+  return !slug;
+}
+function shapeHasIndexPath(shape) {
+  return shape === "catch-all";
+}
 function slugToPath(slug) {
   if (!slug)
     return "";
@@ -134,19 +140,22 @@ async function requireCacheHelpers() {
   }
   throw new Error("[payload-www] seedPayloadCache({ config }) must be called before any query getter. " + "Call it from createCollectionPageExports / createRootLayoutExports factory, or in your root layout.");
 }
+var RENDER_DEPTH = 2;
 async function queryDocBySlug(args) {
   "use cache";
   cacheLife("weeks");
   const { findDoc } = await requireCacheHelpers();
   const slugField = args.slugField ?? "slug";
-  const result = await findDoc(args.collectionSlug, {
-    where: { [slugField]: { equals: args.slug } },
+  const find = (slug) => findDoc(args.collectionSlug, {
+    where: { [slugField]: { equals: slug } },
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
-  return result ?? null;
+  const result = await find(args.slug);
+  const doc = result ?? (isIndexSlug(args.slug) ? await find(null) : null);
+  return doc ?? null;
 }
 async function queryGlobal(args) {
   "use cache";
@@ -156,7 +165,7 @@ async function queryGlobal(args) {
     const result = await findGlobal(args.globalSlug, {
       locale: args.locale,
       draft: args.draft ?? false,
-      depth: args.depth
+      depth: args.depth ?? RENDER_DEPTH
     });
     return result ?? null;
   } catch (error) {
@@ -172,7 +181,7 @@ async function queryAllDocs(args) {
   const { ids } = await findIds(collection, { locale: args.locale, pagination: false, overrideAccess: false });
   if (ids.length === 0)
     return [];
-  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false })));
+  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false, depth: 0 })));
   return docs.filter((d) => d !== null);
 }
 async function queryDoc(args) {
@@ -199,7 +208,7 @@ async function queryDocByID(args) {
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
 }
 
@@ -218,6 +227,8 @@ var metadata = {
   queryAllLocaleSlugs,
   paramsSlugToSlug,
   slugToParamsSlug,
+  isIndexSlug,
+  shapeHasIndexPath,
   seedPayloadCache,
   tagsFor
 };
@@ -230,6 +241,7 @@ export {
   buildRootJsonLd,
   buildWebSiteLd,
   metadata_default as default,
+  isIndexSlug,
   paramsSlugToSlug,
   queryAllDocs,
   queryAllLocaleSlugs,
@@ -237,6 +249,7 @@ export {
   queryDocBySlug,
   queryGlobal,
   seedPayloadCache,
+  shapeHasIndexPath,
   slugToParamsSlug,
   tagsFor
 };

package/dist/pages.d.ts

@@ -39,6 +39,8 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	importMap: ImportMap3;
 	routing: RoutingConfig;
 	slugShape?: SlugShape;
+	/** Relationship / upload hops populated on the rendered document. `0` renders them as bare ids. */
+	depth?: number;
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	getServerSideURL: () => string;
@@ -46,7 +48,7 @@ type CreateCollectionPageExportsDeps<S extends string> = {
 	/** Rendered while the document streams. Defaults to nothing. */
 	fallback?: ReactNode2;
 };
-declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape, depth }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
 	default: (props: NextPageProps) => Promise<ReactNode2>;
 	generateMetadata: (props: NextPageProps) => Promise<Metadata>;
 	generateStaticParams: (props: GenerateStaticParamsProps) => Promise<{

package/dist/pages.js

@@ -188,6 +188,12 @@ function slugToParamsSlug(slug, shape) {
     return shape === "catch-all" ? [] : "";
   return shape === "catch-all" ? slug.split(SLUG_NESTED_DIVIDER) : slug;
 }
+function isIndexSlug(slug) {
+  return !slug;
+}
+function shapeHasIndexPath(shape) {
+  return shape === "catch-all";
+}
 function slugToPath(slug) {
   if (!slug)
     return "";
@@ -219,19 +225,22 @@ async function requireCacheHelpers() {
   }
   throw new Error("[payload-www] seedPayloadCache({ config }) must be called before any query getter. " + "Call it from createCollectionPageExports / createRootLayoutExports factory, or in your root layout.");
 }
+var RENDER_DEPTH = 2;
 async function queryDocBySlug(args) {
   "use cache";
   cacheLife("weeks");
   const { findDoc } = await requireCacheHelpers();
   const slugField = args.slugField ?? "slug";
-  const result = await findDoc(args.collectionSlug, {
-    where: { [slugField]: { equals: args.slug } },
+  const find = (slug) => findDoc(args.collectionSlug, {
+    where: { [slugField]: { equals: slug } },
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
-  return result ?? null;
+  const result = await find(args.slug);
+  const doc = result ?? (isIndexSlug(args.slug) ? await find(null) : null);
+  return doc ?? null;
 }
 async function queryGlobal(args) {
   "use cache";
@@ -241,7 +250,7 @@ async function queryGlobal(args) {
     const result = await findGlobal(args.globalSlug, {
       locale: args.locale,
       draft: args.draft ?? false,
-      depth: args.depth
+      depth: args.depth ?? RENDER_DEPTH
     });
     return result ?? null;
   } catch (error) {
@@ -257,7 +266,7 @@ async function queryAllDocs(args) {
   const { ids } = await findIds(collection, { locale: args.locale, pagination: false, overrideAccess: false });
   if (ids.length === 0)
     return [];
-  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false })));
+  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false, depth: 0 })));
   return docs.filter((d) => d !== null);
 }
 async function queryDoc(args) {
@@ -284,7 +293,7 @@ async function queryDocByID(args) {
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
 }
 
@@ -360,7 +369,8 @@ function createCollectionPageExports({
   _payloadConfig,
   importMap,
   routing,
-  slugShape = "single"
+  slugShape = "single",
+  depth = RENDER_DEPTH
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -372,6 +382,7 @@ function createCollectionPageExports({
     return queryDoc({
       slug,
       locale,
+      depth,
       collectionSlug
     });
   }
@@ -428,7 +439,10 @@ function createCollectionPageExports({
     await props.params;
     const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
-      return docs.filter((doc) => typeof doc.slug === "string" && doc.slug.length > 0).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))
+        entries.push({ locale, slug: slugToParamsSlug("", slugShape) });
+      return entries;
     }));
     return perLocaleEntries.flat();
   }

package/dist/render-pages.d.ts

@@ -48,6 +48,8 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	importMap: ImportMap3;
 	routing: RoutingConfig;
 	slugShape?: SlugShape;
+	/** Relationship / upload hops populated on the rendered document. `0` renders them as bare ids. */
+	depth?: number;
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	getServerSideURL: () => string;
@@ -55,7 +57,7 @@ type CreateCollectionPageExportsDeps<S extends string> = {
 	/** Rendered while the document streams. Defaults to nothing. */
 	fallback?: ReactNode2;
 };
-declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape, depth }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
 	default: (props: NextPageProps) => Promise<ReactNode2>;
 	generateMetadata: (props: NextPageProps) => Promise<Metadata>;
 	generateStaticParams: (props: GenerateStaticParamsProps) => Promise<{
@@ -75,6 +77,8 @@ type CreateRootLayoutExportsArgs = {
 	_payloadConfig: Promise<SanitizedConfig3>;
 	importMap: ImportMap4;
 	routing: RoutingConfig;
+	/** Relationship / upload hops populated on the header and footer globals. `0` renders them as bare ids. */
+	depth?: number;
 };
 type CreateRootLayoutProvidersArgs = {
 	children: ReactNode3;
@@ -86,7 +90,7 @@ type CreateRootLayoutExportsDeps = {
 	getServerSideURL?: () => string;
 };
 type Element_12xgc2 = JSX_1kxb2["Element"];
-declare function createRootLayoutExports({ _payloadConfig, importMap, routing }: CreateRootLayoutExportsArgs, { providers, htmlAttrs, getServerSideURL }?: CreateRootLayoutExportsDeps): {
+declare function createRootLayoutExports({ _payloadConfig, importMap, routing, depth }: CreateRootLayoutExportsArgs, { providers, htmlAttrs, getServerSideURL }?: CreateRootLayoutExportsDeps): {
 	default: (props: NextLayoutProps) => Promise<Element_12xgc2>;
 	generateStaticParams: () => {
 		locale: string;

package/dist/render-pages.js

@@ -218,6 +218,12 @@ function slugToParamsSlug(slug, shape) {
     return shape === "catch-all" ? [] : "";
   return shape === "catch-all" ? slug.split(SLUG_NESTED_DIVIDER) : slug;
 }
+function isIndexSlug(slug) {
+  return !slug;
+}
+function shapeHasIndexPath(shape) {
+  return shape === "catch-all";
+}
 function slugToPath(slug) {
   if (!slug)
     return "";
@@ -249,19 +255,22 @@ async function requireCacheHelpers() {
   }
   throw new Error("[payload-www] seedPayloadCache({ config }) must be called before any query getter. " + "Call it from createCollectionPageExports / createRootLayoutExports factory, or in your root layout.");
 }
+var RENDER_DEPTH = 2;
 async function queryDocBySlug(args) {
   "use cache";
   cacheLife("weeks");
   const { findDoc } = await requireCacheHelpers();
   const slugField = args.slugField ?? "slug";
-  const result = await findDoc(args.collectionSlug, {
-    where: { [slugField]: { equals: args.slug } },
+  const find = (slug) => findDoc(args.collectionSlug, {
+    where: { [slugField]: { equals: slug } },
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
-  return result ?? null;
+  const result = await find(args.slug);
+  const doc = result ?? (isIndexSlug(args.slug) ? await find(null) : null);
+  return doc ?? null;
 }
 async function queryGlobal(args) {
   "use cache";
@@ -271,7 +280,7 @@ async function queryGlobal(args) {
     const result = await findGlobal(args.globalSlug, {
       locale: args.locale,
       draft: args.draft ?? false,
-      depth: args.depth
+      depth: args.depth ?? RENDER_DEPTH
     });
     return result ?? null;
   } catch (error) {
@@ -287,7 +296,7 @@ async function queryAllDocs(args) {
   const { ids } = await findIds(collection, { locale: args.locale, pagination: false, overrideAccess: false });
   if (ids.length === 0)
     return [];
-  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false })));
+  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false, depth: 0 })));
   return docs.filter((d) => d !== null);
 }
 async function queryDoc(args) {
@@ -314,7 +323,7 @@ async function queryDocByID(args) {
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
 }
 
@@ -390,7 +399,8 @@ function createCollectionPageExports({
   _payloadConfig,
   importMap,
   routing,
-  slugShape = "single"
+  slugShape = "single",
+  depth = RENDER_DEPTH
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -402,6 +412,7 @@ function createCollectionPageExports({
     return queryDoc({
       slug,
       locale,
+      depth,
       collectionSlug
     });
   }
@@ -458,7 +469,10 @@ function createCollectionPageExports({
     await props.params;
     const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
-      return docs.filter((doc) => typeof doc.slug === "string" && doc.slug.length > 0).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))
+        entries.push({ locale, slug: slugToParamsSlug("", slugShape) });
+      return entries;
     }));
     return perLocaleEntries.flat();
   }
@@ -524,7 +538,8 @@ async function resolveLocale(props) {
 function createRootLayoutExports({
   _payloadConfig,
   importMap,
-  routing
+  routing,
+  depth = RENDER_DEPTH
 }, {
   providers,
   htmlAttrs,
@@ -542,8 +557,8 @@ function createRootLayoutExports({
       header,
       footer
     ] = await Promise.all([
-      queryDoc({ globalSlug: "header", locale }),
-      queryDoc({ globalSlug: "footer", locale })
+      queryDoc({ globalSlug: "header", locale, depth }),
+      queryDoc({ globalSlug: "footer", locale, depth })
     ]);
     const renderedHeader = renderWWWDataModule(header, { collectionSlug: "header", configPath: "globals", config: _payloadConfig, importMap }, { ...props, locale }), renderedFooter = renderWWWDataModule(footer, { collectionSlug: "footer", configPath: "globals", config: _payloadConfig, importMap }, { ...props, locale });
     const mergedHtmlAttrs = {

package/dist/sitemap.js

@@ -13,6 +13,12 @@ function slugToParamsSlug(slug, shape) {
     return shape === "catch-all" ? [] : "";
   return shape === "catch-all" ? slug.split(SLUG_NESTED_DIVIDER) : slug;
 }
+function isIndexSlug(slug) {
+  return !slug;
+}
+function shapeHasIndexPath(shape) {
+  return shape === "catch-all";
+}
 function slugToPath(slug) {
   if (!slug)
     return "";
@@ -44,19 +50,22 @@ async function requireCacheHelpers() {
   }
   throw new Error("[payload-www] seedPayloadCache({ config }) must be called before any query getter. " + "Call it from createCollectionPageExports / createRootLayoutExports factory, or in your root layout.");
 }
+var RENDER_DEPTH = 2;
 async function queryDocBySlug(args) {
   "use cache";
   cacheLife("weeks");
   const { findDoc } = await requireCacheHelpers();
   const slugField = args.slugField ?? "slug";
-  const result = await findDoc(args.collectionSlug, {
-    where: { [slugField]: { equals: args.slug } },
+  const find = (slug) => findDoc(args.collectionSlug, {
+    where: { [slugField]: { equals: slug } },
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
-  return result ?? null;
+  const result = await find(args.slug);
+  const doc = result ?? (isIndexSlug(args.slug) ? await find(null) : null);
+  return doc ?? null;
 }
 async function queryGlobal(args) {
   "use cache";
@@ -66,7 +75,7 @@ async function queryGlobal(args) {
     const result = await findGlobal(args.globalSlug, {
       locale: args.locale,
       draft: args.draft ?? false,
-      depth: args.depth
+      depth: args.depth ?? RENDER_DEPTH
     });
     return result ?? null;
   } catch (error) {
@@ -82,7 +91,7 @@ async function queryAllDocs(args) {
   const { ids } = await findIds(collection, { locale: args.locale, pagination: false, overrideAccess: false });
   if (ids.length === 0)
     return [];
-  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false })));
+  const docs = await Promise.all(ids.map((id) => findDocByID(collection, id, { locale: args.locale, overrideAccess: false, depth: 0 })));
   return docs.filter((d) => d !== null);
 }
 async function queryDoc(args) {
@@ -109,7 +118,7 @@ async function queryDocByID(args) {
     locale: args.locale,
     draft: args.draft ?? false,
     overrideAccess: args.draft ?? false,
-    depth: args.depth
+    depth: args.depth ?? RENDER_DEPTH
   });
 }
 
@@ -206,7 +215,8 @@ function createCollectionPageExports({
   _payloadConfig,
   importMap,
   routing,
-  slugShape = "single"
+  slugShape = "single",
+  depth = RENDER_DEPTH
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -218,6 +228,7 @@ function createCollectionPageExports({
     return queryDoc({
       slug,
       locale,
+      depth,
       collectionSlug
     });
   }
@@ -274,7 +285,10 @@ function createCollectionPageExports({
     await props.params;
     const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
-      return docs.filter((doc) => typeof doc.slug === "string" && doc.slug.length > 0).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
+      if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))
+        entries.push({ locale, slug: slugToParamsSlug("", slugShape) });
+      return entries;
     }));
     return perLocaleEntries.flat();
   }

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": "2.2.7",
+  "version": "2.2.9",
   "type": "module",
   "private": false,
   "files": [