@justanarthur/payload-www 2.4.0 → 2.5.0

package/README.md

@@ -124,6 +124,11 @@ done. `export const instant = false` tells Next's dev-time instant validation th
 blocks on purpose. With `partialPrefetching: true`, Next streams the layout shell for slugs it did
 not prerender, so those slugs still get a soft 404.
 
+`prerenderLocales` limits which locales' documents `generateStaticParams` prerenders at build;
+the rest render on their first request and are cached from there. A large multilingual
+collection can prerender only its main locale, e.g. `prerenderLocales: ['en']` for posts, to keep
+the build short. It defaults to every locale.
+
 `slugShape` is `'single'` (default) or `'catch-all'`. Use `'catch-all'` if your route segment is
 `[[...slug]]` (Pages-style), `'single'` for `[slug]` (Posts-style — file convention).
 

package/dist/pages.d.ts

@@ -41,6 +41,8 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	slugShape?: SlugShape;
 	/** Relationship / upload hops populated on the rendered document. `0` renders them as bare ids. */
 	depth?: number;
+	/** Locales whose documents prerender at build. The rest render on their first request and cache from there. Defaults to every locale. */
+	prerenderLocales?: string[];
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	getServerSideURL: () => string;
@@ -48,7 +50,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, depth }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape, depth, prerenderLocales }: 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

@@ -415,7 +415,8 @@ function createCollectionPageExports({
   importMap,
   routing,
   slugShape = "single",
-  depth = RENDER_DEPTH
+  depth = RENDER_DEPTH,
+  prerenderLocales = routing.locales
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -482,7 +483,7 @@ function createCollectionPageExports({
   }
   async function generateStaticParams(props) {
     await props.params;
-    const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
+    const perLocaleEntries = await Promise.all(prerenderLocales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
       const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
       if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))

package/dist/render-pages.d.ts

@@ -50,6 +50,8 @@ type CreateCollectionPageExportsArgs<S extends string = "pages"> = {
 	slugShape?: SlugShape;
 	/** Relationship / upload hops populated on the rendered document. `0` renders them as bare ids. */
 	depth?: number;
+	/** Locales whose documents prerender at build. The rest render on their first request and cache from there. Defaults to every locale. */
+	prerenderLocales?: string[];
 };
 type CreateCollectionPageExportsDeps<S extends string> = {
 	getServerSideURL: () => string;
@@ -57,7 +59,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, depth }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
+declare function createCollectionPageExports<S extends string = "pages">({ slug: collectionSlug, _payloadConfig, importMap, routing, slugShape, depth, prerenderLocales }: CreateCollectionPageExportsArgs<S>, { getServerSideURL, pagePathPrefix, fallback }: CreateCollectionPageExportsDeps<S>): {
 	default: (props: NextPageProps) => Promise<ReactNode2>;
 	generateMetadata: (props: NextPageProps) => Promise<Metadata>;
 	generateStaticParams: (props: GenerateStaticParamsProps) => Promise<{

package/dist/render-pages.js

@@ -445,7 +445,8 @@ function createCollectionPageExports({
   importMap,
   routing,
   slugShape = "single",
-  depth = RENDER_DEPTH
+  depth = RENDER_DEPTH,
+  prerenderLocales = routing.locales
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -512,7 +513,7 @@ function createCollectionPageExports({
   }
   async function generateStaticParams(props) {
     await props.params;
-    const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
+    const perLocaleEntries = await Promise.all(prerenderLocales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
       const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
       if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))

package/dist/sitemap.js

@@ -261,7 +261,8 @@ function createCollectionPageExports({
   importMap,
   routing,
   slugShape = "single",
-  depth = RENDER_DEPTH
+  depth = RENDER_DEPTH,
+  prerenderLocales = routing.locales
 }, {
   getServerSideURL,
   pagePathPrefix,
@@ -328,7 +329,7 @@ function createCollectionPageExports({
   }
   async function generateStaticParams(props) {
     await props.params;
-    const perLocaleEntries = await Promise.all(routing.locales.map(async (locale) => {
+    const perLocaleEntries = await Promise.all(prerenderLocales.map(async (locale) => {
       const docs = await queryAllDocs({ locale, collectionSlug });
       const entries = docs.filter((doc) => !isIndexSlug(doc.slug)).map((doc) => ({ locale, slug: slugToParamsSlug(doc.slug, slugShape) }));
       if (shapeHasIndexPath(slugShape) && await fetchDoc(locale, ""))

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.4.0",
+  "version": "2.5.0",
   "license": "MIT",
   "type": "module",
   "private": false,