@payloadcms/tanstack-start 4.0.0-internal.bc5cf8c → 4.0.0-internal.ccea85d

package/dist/node/cssLoader.d.mts

@@ -1,3 +1,25 @@
-export function resolve(specifier: any, context: any, nextResolve: any): Promise<any>;
-export function load(url: any, context: any, nextLoad: any): Promise<any>;
+/**
+ * Node ESM loader hook that swallows static asset imports (CSS/SCSS/LESS,
+ * images, fonts, audio, video, etc.) encountered while running the dev
+ * server.
+ *
+ * Vite is supposed to intercept asset imports during SSR/RSC by treating
+ * the package as `noExternal`, but that resolution path silently breaks down
+ * when a dependency is installed from a packed tarball under
+ * `node_modules/.pnpm/<pkg>@file+packed+...`. In that scenario Vite hands the
+ * import to Node's native ESM loader, which has no opinion about `.css` /
+ * `.svg` / `.png` files and throws `ERR_UNKNOWN_FILE_EXTENSION`. That single
+ * throw cascades into every admin route showing "Something went wrong!"
+ * because the SSR tree dies inside `<MatchInnerImpl>`.
+ *
+ * Registering this loader (with `--import` or `register()`) makes Node treat
+ * any asset specifier as an empty ES module, which is exactly what we
+ * already do client-side for SSR.
+ *
+ * The loader is intentionally minimal and side-effect free; it only kicks in
+ * for asset specifiers and falls through to the default loader for
+ * everything else.
+ */
+export declare function resolve(specifier: any, context: any, nextResolve: any): Promise<any>;
+export declare function load(url: any, context: any, nextLoad: any): Promise<any>;
 //# sourceMappingURL=cssLoader.d.mts.map

package/dist/node/cssLoader.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cssLoader.d.mts","sourceRoot":"","sources":["../../src/node/cssLoader.mjs"],"names":[],"mappings":"AAsDA,sFASC;AAED,0EASC"}
+{"version":3,"file":"cssLoader.d.mts","sourceRoot":"","sources":["../../src/node/cssLoader.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiCH,wBAAsB,OAAO,CAAC,SAAS,KAAA,EAAE,OAAO,KAAA,EAAE,WAAW,KAAA,gBAS5D;AAED,wBAAsB,IAAI,CAAC,GAAG,KAAA,EAAE,OAAO,KAAA,EAAE,QAAQ,KAAA,gBAShD"}

package/dist/routes/adminRoutes.d.ts

@@ -49,10 +49,13 @@ export declare function payloadAdminSplatRoute({ load }: {
             title: string;
         })[];
     };
-    loader: ({ location, params }: {
-        location: any;
-        params: any;
-    }) => Promise<any>;
+    loader: {
+        handler: ({ location, params }: {
+            location: any;
+            params: any;
+        }) => Promise<any>;
+        staleReloadMode: string;
+    };
     loaderDeps: ({ search }: {
         search: Record<string, unknown>;
     }) => {
@@ -91,9 +94,12 @@ export declare function payloadAdminIndexRoute({ load }: {
             title: string;
         })[];
     };
-    loader: ({ location }: {
-        location: any;
-    }) => Promise<any>;
+    loader: {
+        handler: ({ location }: {
+            location: any;
+        }) => Promise<any>;
+        staleReloadMode: string;
+    };
     loaderDeps: ({ search }: {
         search: Record<string, unknown>;
     }) => {

package/dist/routes/adminRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminRoutes.d.ts","sourceRoot":"","sources":["../../src/routes/adminRoutes.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIhD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;KAAE,CAAA;CACpE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;AAclB,iBAAS,SAAS,gCAQjB;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,+BAMrF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;;2BAGzC;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;mCAEN;QAAE,QAAQ,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE;6BAQ1C;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;;;;6BAInC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAEnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;;2BAGzC;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;2BACd;QAAE,QAAQ,EAAE,GAAG,CAAA;KAAE;6BAQrB;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;;;6BAGnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAEnD"}
+{"version":3,"file":"adminRoutes.d.ts","sourceRoot":"","sources":["../../src/routes/adminRoutes.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIhD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;KAAE,CAAA;CACpE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;AAclB,iBAAS,SAAS,gCAQjB;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,+BAMrF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;IAEhE,SAAS;IACT,IAAI,mBAAmB;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;IAM3C,MAAM;QACJ,OAAO,yBAA+B;YAAE,QAAQ,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,GAAG,CAAA;SAAE;QAQpE,eAAe;;IAGjB,UAAU,eAAe;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;QAC1D,SAAS;;IAEX,iBAAiB;IACjB,cAAc,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAEnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;IAEhE,SAAS;IACT,IAAI,mBAAmB;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;IAC3C,MAAM;QACJ,OAAO,iBAAuB;YAAE,QAAQ,EAAE,GAAG,CAAA;SAAE;QAQ/C,eAAe;;IAEjB,UAAU,eAAe;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;QAC1D,SAAS;;IAEX,cAAc,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAEnD"}

package/dist/routes/adminRoutes.js

@@ -51,20 +51,28 @@ function AdminNotFound(props) {
     return {
         component: AdminPage,
         head: ({ loaderData })=>getAdminMeta(loaderData?.metadata),
-        // Surface query params in `loaderDeps` so `?locale=es` re-runs the loader.
-        loader: async ({ location, params })=>{
-            const data = await runLoader(load, params._splat ?? '', location.searchStr);
-            if (data?._notFound) {
-                // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects
-                throw notFound({
-                    data: {
-                        routeKey: data.routeKey,
-                        rscPayload: data.rscPayload
-                    }
-                });
-            }
-            return data;
+        // `staleReloadMode: 'blocking'` (a property of the loader *object*, not a
+        // sibling route option — router-core only reads it off a non-function loader)
+        // makes stale-match revalidation await the fresh loader before committing,
+        // instead of the default background SWR that flashes the pre-navigation list
+        // (e.g. a just-created doc missing) until the reload lands.
+        loader: {
+            handler: async ({ location, params })=>{
+                const data = await runLoader(load, params._splat ?? '', location.searchStr);
+                if (data?._notFound) {
+                    // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects
+                    throw notFound({
+                        data: {
+                            routeKey: data.routeKey,
+                            rscPayload: data.rscPayload
+                        }
+                    });
+                }
+                return data;
+            },
+            staleReloadMode: 'blocking'
         },
+        // Surface query params in `loaderDeps` so `?locale=es` re-runs the loader.
         loaderDeps: ({ search })=>({
                 searchKey: JSON.stringify(search)
             }),
@@ -79,13 +87,16 @@ function AdminNotFound(props) {
     return {
         component: AdminPage,
         head: ({ loaderData })=>getAdminMeta(loaderData?.metadata),
-        loader: async ({ location })=>{
-            const data = await runLoader(load, '', location.searchStr);
-            if (data?._notFound) {
-                // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects
-                throw notFound();
-            }
-            return data;
+        loader: {
+            handler: async ({ location })=>{
+                const data = await runLoader(load, '', location.searchStr);
+                if (data?._notFound) {
+                    // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects
+                    throw notFound();
+                }
+                return data;
+            },
+            staleReloadMode: 'blocking'
         },
         loaderDeps: ({ search })=>({
                 searchKey: JSON.stringify(search)

package/dist/routes/adminRoutes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/routes/adminRoutes.tsx"],"sourcesContent":["'use client'\n\nimport { NotFoundClient } from '@payloadcms/ui'\nimport { notFound, redirect, useLoaderData } from '@tanstack/react-router'\nimport { Fragment, type ReactNode } from 'react'\n\nimport { getAdminMeta } from '../utilities/meta.js'\n\n/**\n * Loader supplied by the app — a TanStack Start `createServerFn` that delegates\n * to `loadAdminPage`. Typed loosely because the server-fn's call signature is\n * generated by the Start compiler.\n */\nexport type AdminLoad = (opts: {\n  data: { _splat: string; search: Record<string, string | string[]> }\n}) => Promise<any>\n\nconst searchToRecord = (searchStr: string): Record<string, string | string[]> =>\n  Object.fromEntries(new URLSearchParams(searchStr)) as Record<string, string | string[]>\n\nconst runLoader = async (load: AdminLoad, splat: string, searchStr: string) => {\n  const data = await load({ data: { _splat: splat, search: searchToRecord(searchStr) } })\n  if (data?._redirect) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing redirect objects\n    throw redirect({ to: data._redirect })\n  }\n  return data\n}\n\nfunction AdminPage() {\n  // RSC Flight payload — render directly. Key by the loader-derived `routeKey`\n  // (not `location.pathname`, which updates before `useLoaderData` during a\n  // transition and would remount with the previous payload) so navigating to a\n  // different admin page remounts the view, mirroring Next route-segment\n  // semantics. Search params are excluded so search-only changes reconcile in place.\n  const data = useLoaderData({ strict: false })\n  return <Fragment key={data?.routeKey}>{data?.rscPayload}</Fragment>\n}\n\nfunction AdminNotFound(props: { data?: { routeKey?: string; rscPayload?: ReactNode } }) {\n  const rscPayload = props?.data?.rscPayload\n  if (!rscPayload) {\n    return <NotFoundClient />\n  }\n  return <Fragment key={props?.data?.routeKey}>{rscPayload}</Fragment>\n}\n\n/**\n * Route options for the admin splat route (`/_payload/admin/$`). Renders Payload's\n * server-built NotFound page (shipped via the `notFound()` error's\n * `data.rscPayload`) for unknown/access-denied routes, falling back to the bare\n * client view.\n */\nexport function payloadAdminSplatRoute({ load }: { load: AdminLoad }) {\n  return {\n    component: AdminPage,\n    head: ({ loaderData }: { loaderData?: any }) => getAdminMeta(loaderData?.metadata),\n    // Surface query params in `loaderDeps` so `?locale=es` re-runs the loader.\n    loader: async ({ location, params }: { location: any; params: any }) => {\n      const data = await runLoader(load, params._splat ?? '', location.searchStr)\n      if (data?._notFound) {\n        // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects\n        throw notFound({ data: { routeKey: data.routeKey, rscPayload: data.rscPayload } })\n      }\n      return data\n    },\n    loaderDeps: ({ search }: { search: Record<string, unknown> }) => ({\n      searchKey: JSON.stringify(search),\n    }),\n    notFoundComponent: AdminNotFound,\n    validateSearch: (search: Record<string, unknown>) => search,\n  }\n}\n\n/**\n * Route options for the admin index route (`/_payload/admin/`). Same loader as the\n * splat route but throws a bare `notFound()` (no rscPayload) on miss.\n */\nexport function payloadAdminIndexRoute({ load }: { load: AdminLoad }) {\n  return {\n    component: AdminPage,\n    head: ({ loaderData }: { loaderData?: any }) => getAdminMeta(loaderData?.metadata),\n    loader: async ({ location }: { location: any }) => {\n      const data = await runLoader(load, '', location.searchStr)\n      if (data?._notFound) {\n        // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects\n        throw notFound()\n      }\n      return data\n    },\n    loaderDeps: ({ search }: { search: Record<string, unknown> }) => ({\n      searchKey: JSON.stringify(search),\n    }),\n    validateSearch: (search: Record<string, unknown>) => search,\n  }\n}\n"],"names":["NotFoundClient","notFound","redirect","useLoaderData","Fragment","getAdminMeta","searchToRecord","searchStr","Object","fromEntries","URLSearchParams","runLoader","load","splat","data","_splat","search","_redirect","to","AdminPage","strict","rscPayload","routeKey","AdminNotFound","props","payloadAdminSplatRoute","component","head","loaderData","metadata","loader","location","params","_notFound","loaderDeps","searchKey","JSON","stringify","notFoundComponent","validateSearch","payloadAdminIndexRoute"],"mappings":"AAAA;;AAEA,SAASA,cAAc,QAAQ,iBAAgB;AAC/C,SAASC,QAAQ,EAAEC,QAAQ,EAAEC,aAAa,QAAQ,yBAAwB;AAC1E,SAASC,QAAQ,QAAwB,QAAO;AAEhD,SAASC,YAAY,QAAQ,uBAAsB;AAWnD,MAAMC,iBAAiB,CAACC,YACtBC,OAAOC,WAAW,CAAC,IAAIC,gBAAgBH;AAEzC,MAAMI,YAAY,OAAOC,MAAiBC,OAAeN;IACvD,MAAMO,OAAO,MAAMF,KAAK;QAAEE,MAAM;YAAEC,QAAQF;YAAOG,QAAQV,eAAeC;QAAW;IAAE;IACrF,IAAIO,MAAMG,WAAW;QACnB,qHAAqH;QACrH,MAAMf,SAAS;YAAEgB,IAAIJ,KAAKG,SAAS;QAAC;IACtC;IACA,OAAOH;AACT;AAEA,SAASK;IACP,6EAA6E;IAC7E,0EAA0E;IAC1E,6EAA6E;IAC7E,uEAAuE;IACvE,mFAAmF;IACnF,MAAML,OAAOX,cAAc;QAAEiB,QAAQ;IAAM;IAC3C,qBAAO,KAAChB;kBAA+BU,MAAMO;OAAvBP,MAAMQ;AAC9B;AAEA,SAASC,cAAcC,KAA+D;IACpF,MAAMH,aAAaG,OAAOV,MAAMO;IAChC,IAAI,CAACA,YAAY;QACf,qBAAO,KAACrB;IACV;IACA,qBAAO,KAACI;kBAAsCiB;OAAxBG,OAAOV,MAAMQ;AACrC;AAEA;;;;;CAKC,GACD,OAAO,SAASG,uBAAuB,EAAEb,IAAI,EAAuB;IAClE,OAAO;QACLc,WAAWP;QACXQ,MAAM,CAAC,EAAEC,UAAU,EAAwB,GAAKvB,aAAauB,YAAYC;QACzE,2EAA2E;QAC3EC,QAAQ,OAAO,EAAEC,QAAQ,EAAEC,MAAM,EAAkC;YACjE,MAAMlB,OAAO,MAAMH,UAAUC,MAAMoB,OAAOjB,MAAM,IAAI,IAAIgB,SAASxB,SAAS;YAC1E,IAAIO,MAAMmB,WAAW;gBACnB,qHAAqH;gBACrH,MAAMhC,SAAS;oBAAEa,MAAM;wBAAEQ,UAAUR,KAAKQ,QAAQ;wBAAED,YAAYP,KAAKO,UAAU;oBAAC;gBAAE;YAClF;YACA,OAAOP;QACT;QACAoB,YAAY,CAAC,EAAElB,MAAM,EAAuC,GAAM,CAAA;gBAChEmB,WAAWC,KAAKC,SAAS,CAACrB;YAC5B,CAAA;QACAsB,mBAAmBf;QACnBgB,gBAAgB,CAACvB,SAAoCA;IACvD;AACF;AAEA;;;CAGC,GACD,OAAO,SAASwB,uBAAuB,EAAE5B,IAAI,EAAuB;IAClE,OAAO;QACLc,WAAWP;QACXQ,MAAM,CAAC,EAAEC,UAAU,EAAwB,GAAKvB,aAAauB,YAAYC;QACzEC,QAAQ,OAAO,EAAEC,QAAQ,EAAqB;YAC5C,MAAMjB,OAAO,MAAMH,UAAUC,MAAM,IAAImB,SAASxB,SAAS;YACzD,IAAIO,MAAMmB,WAAW;gBACnB,qHAAqH;gBACrH,MAAMhC;YACR;YACA,OAAOa;QACT;QACAoB,YAAY,CAAC,EAAElB,MAAM,EAAuC,GAAM,CAAA;gBAChEmB,WAAWC,KAAKC,SAAS,CAACrB;YAC5B,CAAA;QACAuB,gBAAgB,CAACvB,SAAoCA;IACvD;AACF"}
+{"version":3,"sources":["../../src/routes/adminRoutes.tsx"],"sourcesContent":["'use client'\n\nimport { NotFoundClient } from '@payloadcms/ui'\nimport { notFound, redirect, useLoaderData } from '@tanstack/react-router'\nimport { Fragment, type ReactNode } from 'react'\n\nimport { getAdminMeta } from '../utilities/meta.js'\n\n/**\n * Loader supplied by the app — a TanStack Start `createServerFn` that delegates\n * to `loadAdminPage`. Typed loosely because the server-fn's call signature is\n * generated by the Start compiler.\n */\nexport type AdminLoad = (opts: {\n  data: { _splat: string; search: Record<string, string | string[]> }\n}) => Promise<any>\n\nconst searchToRecord = (searchStr: string): Record<string, string | string[]> =>\n  Object.fromEntries(new URLSearchParams(searchStr)) as Record<string, string | string[]>\n\nconst runLoader = async (load: AdminLoad, splat: string, searchStr: string) => {\n  const data = await load({ data: { _splat: splat, search: searchToRecord(searchStr) } })\n  if (data?._redirect) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing redirect objects\n    throw redirect({ to: data._redirect })\n  }\n  return data\n}\n\nfunction AdminPage() {\n  // RSC Flight payload — render directly. Key by the loader-derived `routeKey`\n  // (not `location.pathname`, which updates before `useLoaderData` during a\n  // transition and would remount with the previous payload) so navigating to a\n  // different admin page remounts the view, mirroring Next route-segment\n  // semantics. Search params are excluded so search-only changes reconcile in place.\n  const data = useLoaderData({ strict: false })\n  return <Fragment key={data?.routeKey}>{data?.rscPayload}</Fragment>\n}\n\nfunction AdminNotFound(props: { data?: { routeKey?: string; rscPayload?: ReactNode } }) {\n  const rscPayload = props?.data?.rscPayload\n  if (!rscPayload) {\n    return <NotFoundClient />\n  }\n  return <Fragment key={props?.data?.routeKey}>{rscPayload}</Fragment>\n}\n\n/**\n * Route options for the admin splat route (`/_payload/admin/$`). Renders Payload's\n * server-built NotFound page (shipped via the `notFound()` error's\n * `data.rscPayload`) for unknown/access-denied routes, falling back to the bare\n * client view.\n */\nexport function payloadAdminSplatRoute({ load }: { load: AdminLoad }) {\n  return {\n    component: AdminPage,\n    head: ({ loaderData }: { loaderData?: any }) => getAdminMeta(loaderData?.metadata),\n    // `staleReloadMode: 'blocking'` (a property of the loader *object*, not a\n    // sibling route option — router-core only reads it off a non-function loader)\n    // makes stale-match revalidation await the fresh loader before committing,\n    // instead of the default background SWR that flashes the pre-navigation list\n    // (e.g. a just-created doc missing) until the reload lands.\n    loader: {\n      handler: async ({ location, params }: { location: any; params: any }) => {\n        const data = await runLoader(load, params._splat ?? '', location.searchStr)\n        if (data?._notFound) {\n          // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects\n          throw notFound({ data: { routeKey: data.routeKey, rscPayload: data.rscPayload } })\n        }\n        return data\n      },\n      staleReloadMode: 'blocking',\n    },\n    // Surface query params in `loaderDeps` so `?locale=es` re-runs the loader.\n    loaderDeps: ({ search }: { search: Record<string, unknown> }) => ({\n      searchKey: JSON.stringify(search),\n    }),\n    notFoundComponent: AdminNotFound,\n    validateSearch: (search: Record<string, unknown>) => search,\n  }\n}\n\n/**\n * Route options for the admin index route (`/_payload/admin/`). Same loader as the\n * splat route but throws a bare `notFound()` (no rscPayload) on miss.\n */\nexport function payloadAdminIndexRoute({ load }: { load: AdminLoad }) {\n  return {\n    component: AdminPage,\n    head: ({ loaderData }: { loaderData?: any }) => getAdminMeta(loaderData?.metadata),\n    loader: {\n      handler: async ({ location }: { location: any }) => {\n        const data = await runLoader(load, '', location.searchStr)\n        if (data?._notFound) {\n          // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects\n          throw notFound()\n        }\n        return data\n      },\n      staleReloadMode: 'blocking',\n    },\n    loaderDeps: ({ search }: { search: Record<string, unknown> }) => ({\n      searchKey: JSON.stringify(search),\n    }),\n    validateSearch: (search: Record<string, unknown>) => search,\n  }\n}\n"],"names":["NotFoundClient","notFound","redirect","useLoaderData","Fragment","getAdminMeta","searchToRecord","searchStr","Object","fromEntries","URLSearchParams","runLoader","load","splat","data","_splat","search","_redirect","to","AdminPage","strict","rscPayload","routeKey","AdminNotFound","props","payloadAdminSplatRoute","component","head","loaderData","metadata","loader","handler","location","params","_notFound","staleReloadMode","loaderDeps","searchKey","JSON","stringify","notFoundComponent","validateSearch","payloadAdminIndexRoute"],"mappings":"AAAA;;AAEA,SAASA,cAAc,QAAQ,iBAAgB;AAC/C,SAASC,QAAQ,EAAEC,QAAQ,EAAEC,aAAa,QAAQ,yBAAwB;AAC1E,SAASC,QAAQ,QAAwB,QAAO;AAEhD,SAASC,YAAY,QAAQ,uBAAsB;AAWnD,MAAMC,iBAAiB,CAACC,YACtBC,OAAOC,WAAW,CAAC,IAAIC,gBAAgBH;AAEzC,MAAMI,YAAY,OAAOC,MAAiBC,OAAeN;IACvD,MAAMO,OAAO,MAAMF,KAAK;QAAEE,MAAM;YAAEC,QAAQF;YAAOG,QAAQV,eAAeC;QAAW;IAAE;IACrF,IAAIO,MAAMG,WAAW;QACnB,qHAAqH;QACrH,MAAMf,SAAS;YAAEgB,IAAIJ,KAAKG,SAAS;QAAC;IACtC;IACA,OAAOH;AACT;AAEA,SAASK;IACP,6EAA6E;IAC7E,0EAA0E;IAC1E,6EAA6E;IAC7E,uEAAuE;IACvE,mFAAmF;IACnF,MAAML,OAAOX,cAAc;QAAEiB,QAAQ;IAAM;IAC3C,qBAAO,KAAChB;kBAA+BU,MAAMO;OAAvBP,MAAMQ;AAC9B;AAEA,SAASC,cAAcC,KAA+D;IACpF,MAAMH,aAAaG,OAAOV,MAAMO;IAChC,IAAI,CAACA,YAAY;QACf,qBAAO,KAACrB;IACV;IACA,qBAAO,KAACI;kBAAsCiB;OAAxBG,OAAOV,MAAMQ;AACrC;AAEA;;;;;CAKC,GACD,OAAO,SAASG,uBAAuB,EAAEb,IAAI,EAAuB;IAClE,OAAO;QACLc,WAAWP;QACXQ,MAAM,CAAC,EAAEC,UAAU,EAAwB,GAAKvB,aAAauB,YAAYC;QACzE,0EAA0E;QAC1E,8EAA8E;QAC9E,2EAA2E;QAC3E,6EAA6E;QAC7E,4DAA4D;QAC5DC,QAAQ;YACNC,SAAS,OAAO,EAAEC,QAAQ,EAAEC,MAAM,EAAkC;gBAClE,MAAMnB,OAAO,MAAMH,UAAUC,MAAMqB,OAAOlB,MAAM,IAAI,IAAIiB,SAASzB,SAAS;gBAC1E,IAAIO,MAAMoB,WAAW;oBACnB,qHAAqH;oBACrH,MAAMjC,SAAS;wBAAEa,MAAM;4BAAEQ,UAAUR,KAAKQ,QAAQ;4BAAED,YAAYP,KAAKO,UAAU;wBAAC;oBAAE;gBAClF;gBACA,OAAOP;YACT;YACAqB,iBAAiB;QACnB;QACA,2EAA2E;QAC3EC,YAAY,CAAC,EAAEpB,MAAM,EAAuC,GAAM,CAAA;gBAChEqB,WAAWC,KAAKC,SAAS,CAACvB;YAC5B,CAAA;QACAwB,mBAAmBjB;QACnBkB,gBAAgB,CAACzB,SAAoCA;IACvD;AACF;AAEA;;;CAGC,GACD,OAAO,SAAS0B,uBAAuB,EAAE9B,IAAI,EAAuB;IAClE,OAAO;QACLc,WAAWP;QACXQ,MAAM,CAAC,EAAEC,UAAU,EAAwB,GAAKvB,aAAauB,YAAYC;QACzEC,QAAQ;YACNC,SAAS,OAAO,EAAEC,QAAQ,EAAqB;gBAC7C,MAAMlB,OAAO,MAAMH,UAAUC,MAAM,IAAIoB,SAASzB,SAAS;gBACzD,IAAIO,MAAMoB,WAAW;oBACnB,qHAAqH;oBACrH,MAAMjC;gBACR;gBACA,OAAOa;YACT;YACAqB,iBAAiB;QACnB;QACAC,YAAY,CAAC,EAAEpB,MAAM,EAAuC,GAAM,CAAA;gBAChEqB,WAAWC,KAAKC,SAAS,CAACvB;YAC5B,CAAA;QACAyB,gBAAgB,CAACzB,SAAoCA;IACvD;AACF"}

package/dist/routes/layoutRoute.d.ts

@@ -18,6 +18,9 @@ export declare function payloadLayoutRoute({ load, serverFunction, }: {
     serverFunction: ComponentProps<typeof RootProvider>['serverFunction'];
 }): {
     component: () => import("react").JSX.Element;
-    loader: () => Promise<Record<string, unknown>>;
+    loader: {
+        handler: () => Promise<Record<string, unknown>>;
+        staleReloadMode: string;
+    };
 };
 //# sourceMappingURL=layoutRoute.d.ts.map

package/dist/routes/layoutRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layoutRoute.d.ts","sourceRoot":"","sources":["../../src/routes/layoutRoute.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAe,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAK1D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,cAAc,GACf,EAAE;IACD,IAAI,EAAE,UAAU,CAAA;IAChB,cAAc,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,gBAAgB,CAAC,CAAA;CACtE;;;EAkCA"}
+{"version":3,"file":"layoutRoute.d.ts","sourceRoot":"","sources":["../../src/routes/layoutRoute.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAe,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAK1D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,cAAc,GACf,EAAE;IACD,IAAI,EAAE,UAAU,CAAA;IAChB,cAAc,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,gBAAgB,CAAC,CAAA;CACtE;IAqCG,SAAS;IACT,MAAM;QAAI,OAAO;QAAgB,eAAe;;EAEnD"}

package/dist/routes/layoutRoute.js

@@ -42,9 +42,15 @@ import { TanStackRouterAdapter } from '../elements/RouterAdapter/index.js';
             ]
         });
     }
+    // `staleReloadMode` lives on the loader *object* — router-core only reads it
+    // off a non-function loader — so stale-match revalidation blocks on the fresh
+    // loader instead of flashing stale layout data via the default background SWR.
     return {
         component: PayloadLayout,
-        loader: ()=>load()
+        loader: {
+            handler: ()=>load(),
+            staleReloadMode: 'blocking'
+        }
     };
 }
 

package/dist/routes/layoutRoute.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/routes/layoutRoute.tsx"],"sourcesContent":["'use client'\n\nimport type { ComponentProps } from 'react'\n\nimport { ProgressBar, RootProvider } from '@payloadcms/ui'\nimport { Outlet, useLoaderData } from '@tanstack/react-router'\n\nimport { TanStackRouterAdapter } from '../elements/RouterAdapter/index.js'\n\n/**\n * Loader supplied by the app — a TanStack Start `createServerFn` that delegates\n * to `loadLayoutData`. Typed loosely because the server-fn's call signature is\n * generated by the Start compiler.\n */\nexport type LayoutLoad = () => Promise<Record<string, unknown>>\n\n/**\n * Route options for the Payload admin layout (`/_payload`). Maps the layout\n * loader data onto `RootProvider` and renders the admin chrome (progress bar,\n * custom-provider tree or router `<Outlet />`, portal mount). The app supplies\n * `load` (the layout-data server fn) and `serverFunction` (the server-function\n * client wired into `RootProvider`); everything else is adapter-owned.\n */\nexport function payloadLayoutRoute({\n  load,\n  serverFunction,\n}: {\n  load: LayoutLoad\n  serverFunction: ComponentProps<typeof RootProvider>['serverFunction']\n}) {\n  function PayloadLayout() {\n    const data = useLoaderData({ strict: false })\n\n    return (\n      <>\n        <RootProvider\n          config={data.clientConfig}\n          dateFNSKey={data.dateFNSKey}\n          fallbackLang={data.fallbackLang}\n          highContrastMode={false}\n          isNavOpen={data.isNavOpen}\n          languageCode={data.languageCode}\n          languageOptions={data.languageOptions}\n          locale={data.locale}\n          permissions={data.user ? data.permissions : null}\n          RouterAdapter={TanStackRouterAdapter}\n          serverFunction={serverFunction}\n          theme={data.theme}\n          translations={data.translations}\n          user={data.user}\n        >\n          <ProgressBar />\n          {/* `data.providers` is the custom-provider tree (config.admin.components.providers)\n              already wrapping the router <Outlet />; falls back to a bare <Outlet /> when\n              no custom providers are configured. */}\n          {data.providers ?? <Outlet />}\n        </RootProvider>\n        <div id=\"portal\" />\n      </>\n    )\n  }\n\n  return { component: PayloadLayout, loader: () => load() }\n}\n"],"names":["ProgressBar","RootProvider","Outlet","useLoaderData","TanStackRouterAdapter","payloadLayoutRoute","load","serverFunction","PayloadLayout","data","strict","config","clientConfig","dateFNSKey","fallbackLang","highContrastMode","isNavOpen","languageCode","languageOptions","locale","permissions","user","RouterAdapter","theme","translations","providers","div","id","component","loader"],"mappings":"AAAA;;AAIA,SAASA,WAAW,EAAEC,YAAY,QAAQ,iBAAgB;AAC1D,SAASC,MAAM,EAAEC,aAAa,QAAQ,yBAAwB;AAE9D,SAASC,qBAAqB,QAAQ,qCAAoC;AAS1E;;;;;;CAMC,GACD,OAAO,SAASC,mBAAmB,EACjCC,IAAI,EACJC,cAAc,EAIf;IACC,SAASC;QACP,MAAMC,OAAON,cAAc;YAAEO,QAAQ;QAAM;QAE3C,qBACE;;8BACE,MAACT;oBACCU,QAAQF,KAAKG,YAAY;oBACzBC,YAAYJ,KAAKI,UAAU;oBAC3BC,cAAcL,KAAKK,YAAY;oBAC/BC,kBAAkB;oBAClBC,WAAWP,KAAKO,SAAS;oBACzBC,cAAcR,KAAKQ,YAAY;oBAC/BC,iBAAiBT,KAAKS,eAAe;oBACrCC,QAAQV,KAAKU,MAAM;oBACnBC,aAAaX,KAAKY,IAAI,GAAGZ,KAAKW,WAAW,GAAG;oBAC5CE,eAAelB;oBACfG,gBAAgBA;oBAChBgB,OAAOd,KAAKc,KAAK;oBACjBC,cAAcf,KAAKe,YAAY;oBAC/BH,MAAMZ,KAAKY,IAAI;;sCAEf,KAACrB;wBAIAS,KAAKgB,SAAS,kBAAI,KAACvB;;;8BAEtB,KAACwB;oBAAIC,IAAG;;;;IAGd;IAEA,OAAO;QAAEC,WAAWpB;QAAeqB,QAAQ,IAAMvB;IAAO;AAC1D"}
+{"version":3,"sources":["../../src/routes/layoutRoute.tsx"],"sourcesContent":["'use client'\n\nimport type { ComponentProps } from 'react'\n\nimport { ProgressBar, RootProvider } from '@payloadcms/ui'\nimport { Outlet, useLoaderData } from '@tanstack/react-router'\n\nimport { TanStackRouterAdapter } from '../elements/RouterAdapter/index.js'\n\n/**\n * Loader supplied by the app — a TanStack Start `createServerFn` that delegates\n * to `loadLayoutData`. Typed loosely because the server-fn's call signature is\n * generated by the Start compiler.\n */\nexport type LayoutLoad = () => Promise<Record<string, unknown>>\n\n/**\n * Route options for the Payload admin layout (`/_payload`). Maps the layout\n * loader data onto `RootProvider` and renders the admin chrome (progress bar,\n * custom-provider tree or router `<Outlet />`, portal mount). The app supplies\n * `load` (the layout-data server fn) and `serverFunction` (the server-function\n * client wired into `RootProvider`); everything else is adapter-owned.\n */\nexport function payloadLayoutRoute({\n  load,\n  serverFunction,\n}: {\n  load: LayoutLoad\n  serverFunction: ComponentProps<typeof RootProvider>['serverFunction']\n}) {\n  function PayloadLayout() {\n    const data = useLoaderData({ strict: false })\n\n    return (\n      <>\n        <RootProvider\n          config={data.clientConfig}\n          dateFNSKey={data.dateFNSKey}\n          fallbackLang={data.fallbackLang}\n          highContrastMode={false}\n          isNavOpen={data.isNavOpen}\n          languageCode={data.languageCode}\n          languageOptions={data.languageOptions}\n          locale={data.locale}\n          permissions={data.user ? data.permissions : null}\n          RouterAdapter={TanStackRouterAdapter}\n          serverFunction={serverFunction}\n          theme={data.theme}\n          translations={data.translations}\n          user={data.user}\n        >\n          <ProgressBar />\n          {/* `data.providers` is the custom-provider tree (config.admin.components.providers)\n              already wrapping the router <Outlet />; falls back to a bare <Outlet /> when\n              no custom providers are configured. */}\n          {data.providers ?? <Outlet />}\n        </RootProvider>\n        <div id=\"portal\" />\n      </>\n    )\n  }\n\n  // `staleReloadMode` lives on the loader *object* — router-core only reads it\n  // off a non-function loader — so stale-match revalidation blocks on the fresh\n  // loader instead of flashing stale layout data via the default background SWR.\n  return {\n    component: PayloadLayout,\n    loader: { handler: () => load(), staleReloadMode: 'blocking' },\n  }\n}\n"],"names":["ProgressBar","RootProvider","Outlet","useLoaderData","TanStackRouterAdapter","payloadLayoutRoute","load","serverFunction","PayloadLayout","data","strict","config","clientConfig","dateFNSKey","fallbackLang","highContrastMode","isNavOpen","languageCode","languageOptions","locale","permissions","user","RouterAdapter","theme","translations","providers","div","id","component","loader","handler","staleReloadMode"],"mappings":"AAAA;;AAIA,SAASA,WAAW,EAAEC,YAAY,QAAQ,iBAAgB;AAC1D,SAASC,MAAM,EAAEC,aAAa,QAAQ,yBAAwB;AAE9D,SAASC,qBAAqB,QAAQ,qCAAoC;AAS1E;;;;;;CAMC,GACD,OAAO,SAASC,mBAAmB,EACjCC,IAAI,EACJC,cAAc,EAIf;IACC,SAASC;QACP,MAAMC,OAAON,cAAc;YAAEO,QAAQ;QAAM;QAE3C,qBACE;;8BACE,MAACT;oBACCU,QAAQF,KAAKG,YAAY;oBACzBC,YAAYJ,KAAKI,UAAU;oBAC3BC,cAAcL,KAAKK,YAAY;oBAC/BC,kBAAkB;oBAClBC,WAAWP,KAAKO,SAAS;oBACzBC,cAAcR,KAAKQ,YAAY;oBAC/BC,iBAAiBT,KAAKS,eAAe;oBACrCC,QAAQV,KAAKU,MAAM;oBACnBC,aAAaX,KAAKY,IAAI,GAAGZ,KAAKW,WAAW,GAAG;oBAC5CE,eAAelB;oBACfG,gBAAgBA;oBAChBgB,OAAOd,KAAKc,KAAK;oBACjBC,cAAcf,KAAKe,YAAY;oBAC/BH,MAAMZ,KAAKY,IAAI;;sCAEf,KAACrB;wBAIAS,KAAKgB,SAAS,kBAAI,KAACvB;;;8BAEtB,KAACwB;oBAAIC,IAAG;;;;IAGd;IAEA,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,OAAO;QACLC,WAAWpB;QACXqB,QAAQ;YAAEC,SAAS,IAAMxB;YAAQyB,iBAAiB;QAAW;IAC/D;AACF"}

package/dist/utilities/graphqlHandler.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphqlHandler.server.d.ts","sourceRoot":"","sources":["../../src/utilities/graphqlHandler.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,eAAe,EAAE,MAAM,SAAS,CAAA;AAyFvE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAU,sBAGjC;IACD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IAClD,OAAO,EAAE,OAAO,CAAA;CACjB,KAAG,OAAO,CAAC,QAAQ,CA2DnB,CAAA"}
+{"version":3,"file":"graphqlHandler.server.d.ts","sourceRoot":"","sources":["../../src/utilities/graphqlHandler.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,eAAe,EAAE,MAAM,SAAS,CAAA;AAyFvE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yBAGvB;IACD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IAClD,OAAO,EAAE,OAAO,CAAA;CACjB,KAAG,OAAO,CAAC,QAAQ,CA2DnB,CAAA"}

package/dist/utilities/loadAdminPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadAdminPage.d.ts","sourceRoot":"","sources":["../../src/utilities/loadAdminPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,eAAe,EAAE,MAAM,SAAS,CAAA;AAIrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAMlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GACpE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrB;IACE,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B,CAAA;AA0FL;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,EAClC,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,GACN,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiIlD"}
+{"version":3,"file":"loadAdminPage.d.ts","sourceRoot":"","sources":["../../src/utilities/loadAdminPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,eAAe,EAAE,MAAM,SAAS,CAAA;AAKrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAMlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GACpE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrB;IACE,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B,CAAA;AA0FL;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,EAClC,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,GACN,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2JlD"}

package/dist/utilities/loadAdminPage.js

@@ -1,3 +1,4 @@
+import { getViewportContent } from '@payloadcms/ui/layouts';
 import { renderServerComponent } from '@tanstack/react-start/rsc';
 import { getRequestI18n } from './getRequestI18n.server.js';
 import { initReq } from './initReq.server.js';
@@ -99,16 +100,21 @@ const resolveTitle = (title)=>{
     // by RSC streaming deep inside view components). Read after the render.
     const nav = {};
     const pageServerAdapter = createPageRenderServerAdapter(nav);
+    let userAgent;
     // `renderRoot` calls `initReq` itself with its own overrides (query
     // re-nesting, `urlSuffix`, `fallbackLocale`). Forward them, injecting the
     // page-render `ServerAdapter` so `req.server.redirect()` / `.notFound()`
     // is recorded + thrown rather than escaping as raw TanStack nav.
-    const boundInitReq = (args)=>initReq({
+    const boundInitReq = async (args)=>{
+        const result = await initReq({
             configPromise: args.configPromise,
             importMap: args.importMap,
             overrides: args.overrides,
             serverAdapter: pageServerAdapter
         });
+        userAgent = result.headers.get('user-agent') ?? undefined;
+        return result;
+    };
     const notFound = ()=>{
         nav.type = 'notFound';
         throw new Error('not-found');
@@ -169,6 +175,19 @@ const resolveTitle = (title)=>{
             searchParams: Promise.resolve(searchParams)
         });
         const rscPayload = await renderServerComponent(node);
+        // The server-function (client-nav RPC) path returns the flight stream unread —
+        // unlike the router/SSR path, which awaits a decode that drives the render to
+        // completion. So streamed side effects (e.g. DocumentView's autosave-create
+        // `server.redirect()`) haven't run yet and `nav` is empty. Buffer the stream to
+        // completion to force the render (populating `nav`), then hand the client a fresh
+        // replayable stream from that buffer.
+        if (!nav.type) {
+            const wrapper = rscPayload[Symbol.for('tanstack.rsc.stream')];
+            if (typeof wrapper?.createReplayStream === 'function') {
+                const buffer = await new Response(wrapper.createReplayStream()).arrayBuffer();
+                wrapper.createReplayStream = ()=>new Response(buffer).body;
+            }
+        }
         // Navigation thrown deep inside a streamed view component (e.g. access
         // denied → notFound, already-authenticated → redirect) is swallowed into
         // the RSC stream and never rejects the render. Honor it from the holder,
@@ -196,7 +215,10 @@ const resolveTitle = (title)=>{
             }
         });
         return {
-            metadata: toAdminPageMetadata(meta),
+            metadata: {
+                ...toAdminPageMetadata(meta),
+                viewport: getViewportContent(userAgent)
+            },
             routeKey: splat ?? '',
             rscPayload
         };

package/dist/utilities/loadAdminPage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/loadAdminPage.tsx"],"sourcesContent":["import type { ImportMap, MetaConfig, SanitizedConfig } from 'payload'\n\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\n\nimport type { AdminPageMetadata } from './meta.js'\n\nimport { getRequestI18n } from './getRequestI18n.server.js'\nimport { initReq } from './initReq.server.js'\nimport { createPageRenderServerAdapter } from './serverAdapter.server.js'\n\nexport type LoadAdminPageArgs = {\n  config: SanitizedConfig\n  importMap: ImportMap\n  search?: Record<string, string | string[]>\n  splat?: string\n}\n\nexport type LoadAdminPageResult =\n  | { _notFound: true; routeKey?: string; rscPayload?: React.ReactNode }\n  | { _redirect: string }\n  | {\n      metadata: AdminPageMetadata\n      /**\n       * Stable identity for this rendered route (the splat, i.e. the path\n       * after `/admin/`). The client keys the rendered subtree by this so the\n       * view remounts exactly when a new payload arrives. Keying by\n       * `location.pathname` instead races: the pathname updates before\n       * `useLoaderData()` during a transition, so the subtree would remount\n       * with the *previous* payload and then reconcile the fresh payload in\n       * place — leaving client providers (DocumentInfo, etc.) holding stale\n       * `useState` values from the prior document. Search params are excluded\n       * so search-only changes (e.g. list-view filtering) reconcile in place.\n       */\n      routeKey: string\n      rscPayload: React.ReactNode\n    }\n\nconst resolveTitle = (title: MetaConfig['title']): string | undefined => {\n  if (!title) {\n    return undefined\n  }\n  if (typeof title === 'string') {\n    return title\n  }\n  if ('absolute' in title) {\n    return title.absolute\n  }\n  return title.default\n}\n\n/**\n * Flattens the framework-agnostic `MetaConfig` (Next.js `Metadata` shape) into\n * the plain, serializable `AdminPageMetadata` the route loader ships to the\n * client. The full `MetaConfig` carries a `URL` `metadataBase`, functions and\n * other non-serializable values that seroval cannot cross the wire, so only the\n * fields `getAdminMeta` renders are extracted.\n */\nconst toAdminPageMetadata = (meta: MetaConfig): AdminPageMetadata => {\n  const og = meta.openGraph as\n    | {\n        description?: unknown\n        images?: unknown\n        siteName?: unknown\n        title?: unknown\n      }\n    | undefined\n\n  const rawImages = og?.images\n  const imagesArray = rawImages ? (Array.isArray(rawImages) ? rawImages : [rawImages]) : []\n  const images = imagesArray\n    .map((image: any) =>\n      typeof image === 'string'\n        ? { url: image }\n        : image?.url\n          ? { alt: image.alt, height: image.height, url: String(image.url), width: image.width }\n          : undefined,\n    )\n    .filter(Boolean) as NonNullable<AdminPageMetadata['openGraph']>['images']\n\n  const rawIcons = meta.icons as any\n  const iconList = Array.isArray(rawIcons)\n    ? rawIcons\n    : rawIcons && typeof rawIcons === 'object' && Array.isArray(rawIcons.icon)\n      ? rawIcons.icon\n      : []\n  const icons = iconList\n    .map((icon: any) =>\n      typeof icon === 'string'\n        ? { rel: 'icon', url: icon }\n        : icon?.url\n          ? {\n              type: icon.type,\n              media: icon.media,\n              rel: icon.rel ?? 'icon',\n              sizes: icon.sizes,\n              url: String(icon.url),\n            }\n          : undefined,\n    )\n    .filter(Boolean) as AdminPageMetadata['icons']\n\n  const keywords = meta.keywords\n\n  return {\n    description: typeof meta.description === 'string' ? meta.description : undefined,\n    icons: icons?.length ? icons : undefined,\n    keywords:\n      typeof keywords === 'string'\n        ? keywords\n        : Array.isArray(keywords)\n          ? keywords.join(', ')\n          : undefined,\n    openGraph: og\n      ? {\n          description: typeof og.description === 'string' ? og.description : undefined,\n          images: images?.length ? images : undefined,\n          siteName: typeof og.siteName === 'string' ? og.siteName : undefined,\n          title: typeof og.title === 'string' ? og.title : undefined,\n        }\n      : undefined,\n    robots: typeof meta.robots === 'string' ? meta.robots : undefined,\n    title: resolveTitle(meta.title),\n  }\n}\n\n/**\n * Renders an admin page for TanStack Start and returns a serializable loader\n * result. The framework adapter wraps this in a `createServerFn` that supplies\n * the app's `config` and generated `importMap`.\n *\n *   1. Initializes the Payload request via the shared `renderRoot` orchestrator\n *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected\n *      page-render `ServerAdapter` records navigation intent and throws the\n *      framework-agnostic error contract.\n *   2. Pipes the resulting React server tree through `renderServerComponent`\n *      to produce a Flight payload the client consumes directly.\n *   3. Resolves page metadata via the same shared `generatePageMetadata`\n *      Next.js uses, returning plain serializable strings for `head()`.\n *\n * Navigation surfaces two ways and both become a `_notFound` / `_redirect`\n * sentinel the route loader re-throws as native TanStack nav:\n * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught\n *   by the try/catch below;\n * - thrown deep inside a streamed view component (e.g. `DocumentView` access\n *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,\n *   so it's read from the `nav` holder after `renderServerComponent` resolves.\n */\nexport async function loadAdminPage({\n  config,\n  importMap,\n  search,\n  splat,\n}: LoadAdminPageArgs): Promise<LoadAdminPageResult> {\n  const { renderRoot } = await import('@payloadcms/ui/views/Root')\n  const { defaultAdminViews } = await import('@payloadcms/ui/views/Root/adminViews')\n  const { generatePageMetadata } = await import('@payloadcms/ui/views/Root/generatePageMetadata')\n\n  const splatSegments = splat ? splat.split('/').filter(Boolean) : []\n  // Match Next's optional-catch-all behavior: the admin root (`/admin`) has no\n  // segments. Passing an empty array makes the shared `renderRoot` build\n  // `currentRoute` as `/admin/` (trailing slash), which no longer equals\n  // `adminRoute` and causes `handleAuthRedirect` to append `?redirect=/admin/`.\n  // Passing `undefined` yields `currentRoute = /admin`, so the unauthenticated\n  // redirect lands on a clean `/admin/login`.\n  const segments = splatSegments.length > 0 ? splatSegments : undefined\n  const searchParams = search ?? {}\n\n  // Records navigation requested via `req.server.*` (including throws swallowed\n  // by RSC streaming deep inside view components). Read after the render.\n  const nav: { type?: 'notFound' | 'redirect'; url?: string } = {}\n  const pageServerAdapter = createPageRenderServerAdapter(nav)\n\n  // `renderRoot` calls `initReq` itself with its own overrides (query\n  // re-nesting, `urlSuffix`, `fallbackLocale`). Forward them, injecting the\n  // page-render `ServerAdapter` so `req.server.redirect()` / `.notFound()`\n  // is recorded + thrown rather than escaping as raw TanStack nav.\n  const boundInitReq: Parameters<typeof renderRoot>[0]['initReq'] = (args) =>\n    initReq({\n      configPromise: args.configPromise,\n      importMap: args.importMap,\n      overrides: args.overrides,\n      serverAdapter: pageServerAdapter,\n    })\n\n  const notFound = (): never => {\n    nav.type = 'notFound'\n    throw new Error('not-found')\n  }\n  const redirect = (url: string): never => {\n    nav.type = 'redirect'\n    nav.url = url\n    throw new Error(`redirect:${url}`)\n  }\n\n  // Build the 404 result the route loader re-throws as TanStack `notFound()`.\n  //\n  // Throwing `notFound()` is the only way to set the SSR document status to 404\n  // (it's read from `router.stores.statusCode`, set by a not-found match — NOT\n  // from `setResponseStatus`, which only affects the RSC RPC response). But the\n  // matching `notFoundComponent` is a client component with no access to the\n  // Payload `req`, so it can't build the admin chrome on its own. To match Next\n  // (whose not-found route renders the full admin layout — nav sidebar, etc. —\n  // around the NotFound body, see `renderNotFoundPage`), we render that same\n  // shared `renderNotFoundPage` tree here, server-side, and ship its Flight\n  // payload through the `notFound()` error so the client renders it verbatim.\n  // For users without admin access `renderNotFoundPage` returns the bare\n  // `NotFoundClient`, preserving the access-denied behavior.\n  const renderNotFound = async (): Promise<LoadAdminPageResult> => {\n    const { renderNotFoundPage } = await import('@payloadcms/ui/views/NotFound/page')\n\n    const notFoundNode = await renderNotFoundPage({\n      config: Promise.resolve(config),\n      importMap,\n      initReq: (args) =>\n        initReq({\n          configPromise: args.configPromise,\n          importMap: args.importMap,\n          overrides: args.overrides,\n        }),\n      params: Promise.resolve({ segments: splatSegments }),\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(notFoundNode as React.ReactElement)\n\n    return { _notFound: true, routeKey: splat ?? '', rscPayload }\n  }\n\n  try {\n    const node = await renderRoot({\n      adminViews: defaultAdminViews,\n      config: Promise.resolve(config),\n      importMap,\n      initReq: boundInitReq,\n      notFound,\n      // `segments` is intentionally `undefined` for the admin root (`/admin`),\n      // matching Next's optional catch-all; `renderRoot` handles it at runtime.\n      params: Promise.resolve({ segments }) as Parameters<typeof renderRoot>[0]['params'],\n      redirect,\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(node as React.ReactElement)\n\n    // Navigation thrown deep inside a streamed view component (e.g. access\n    // denied → notFound, already-authenticated → redirect) is swallowed into\n    // the RSC stream and never rejects the render. Honor it from the holder,\n    // discarding the (broken) payload from the aborted render.\n    if (nav.type === 'redirect' && nav.url) {\n      return { _redirect: nav.url }\n    }\n    if (nav.type === 'notFound') {\n      return await renderNotFound()\n    }\n\n    // Resolve metadata through the same shared generator Next.js uses. Only\n    // plain strings cross the wire (the full `MetaConfig` carries a `URL`\n    // `metadataBase` and icons that seroval cannot serialize).\n    const i18n = await getRequestI18n({ config })\n    const meta = await generatePageMetadata({\n      adminViews: defaultAdminViews as Parameters<typeof generatePageMetadata>[0]['adminViews'],\n      config,\n      i18n,\n      params: { segments },\n    })\n\n    return {\n      metadata: toAdminPageMetadata(meta),\n      routeKey: splat ?? '',\n      rscPayload,\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    if (nav.type === 'notFound' || message === 'not-found') {\n      return await renderNotFound()\n    }\n    if (nav.type === 'redirect' || message.startsWith('redirect:')) {\n      return { _redirect: nav.url ?? message.slice('redirect:'.length) }\n    }\n    throw err\n  }\n}\n"],"names":["renderServerComponent","getRequestI18n","initReq","createPageRenderServerAdapter","resolveTitle","title","undefined","absolute","default","toAdminPageMetadata","meta","og","openGraph","rawImages","images","imagesArray","Array","isArray","map","image","url","alt","height","String","width","filter","Boolean","rawIcons","icons","iconList","icon","rel","type","media","sizes","keywords","description","length","join","siteName","robots","loadAdminPage","config","importMap","search","splat","renderRoot","defaultAdminViews","generatePageMetadata","splatSegments","split","segments","searchParams","nav","pageServerAdapter","boundInitReq","args","configPromise","overrides","serverAdapter","notFound","Error","redirect","renderNotFound","renderNotFoundPage","notFoundNode","Promise","resolve","params","rscPayload","_notFound","routeKey","node","adminViews","_redirect","i18n","metadata","err","message","startsWith","slice"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/loadAdminPage.tsx"],"sourcesContent":["import type { ImportMap, MetaConfig, SanitizedConfig } from 'payload'\n\nimport { getViewportContent } from '@payloadcms/ui/layouts'\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\n\nimport type { AdminPageMetadata } from './meta.js'\n\nimport { getRequestI18n } from './getRequestI18n.server.js'\nimport { initReq } from './initReq.server.js'\nimport { createPageRenderServerAdapter } from './serverAdapter.server.js'\n\nexport type LoadAdminPageArgs = {\n  config: SanitizedConfig\n  importMap: ImportMap\n  search?: Record<string, string | string[]>\n  splat?: string\n}\n\nexport type LoadAdminPageResult =\n  | { _notFound: true; routeKey?: string; rscPayload?: React.ReactNode }\n  | { _redirect: string }\n  | {\n      metadata: AdminPageMetadata\n      /**\n       * Stable identity for this rendered route (the splat, i.e. the path\n       * after `/admin/`). The client keys the rendered subtree by this so the\n       * view remounts exactly when a new payload arrives. Keying by\n       * `location.pathname` instead races: the pathname updates before\n       * `useLoaderData()` during a transition, so the subtree would remount\n       * with the *previous* payload and then reconcile the fresh payload in\n       * place — leaving client providers (DocumentInfo, etc.) holding stale\n       * `useState` values from the prior document. Search params are excluded\n       * so search-only changes (e.g. list-view filtering) reconcile in place.\n       */\n      routeKey: string\n      rscPayload: React.ReactNode\n    }\n\nconst resolveTitle = (title: MetaConfig['title']): string | undefined => {\n  if (!title) {\n    return undefined\n  }\n  if (typeof title === 'string') {\n    return title\n  }\n  if ('absolute' in title) {\n    return title.absolute\n  }\n  return title.default\n}\n\n/**\n * Flattens the framework-agnostic `MetaConfig` (Next.js `Metadata` shape) into\n * the plain, serializable `AdminPageMetadata` the route loader ships to the\n * client. The full `MetaConfig` carries a `URL` `metadataBase`, functions and\n * other non-serializable values that seroval cannot cross the wire, so only the\n * fields `getAdminMeta` renders are extracted.\n */\nconst toAdminPageMetadata = (meta: MetaConfig): AdminPageMetadata => {\n  const og = meta.openGraph as\n    | {\n        description?: unknown\n        images?: unknown\n        siteName?: unknown\n        title?: unknown\n      }\n    | undefined\n\n  const rawImages = og?.images\n  const imagesArray = rawImages ? (Array.isArray(rawImages) ? rawImages : [rawImages]) : []\n  const images = imagesArray\n    .map((image: any) =>\n      typeof image === 'string'\n        ? { url: image }\n        : image?.url\n          ? { alt: image.alt, height: image.height, url: String(image.url), width: image.width }\n          : undefined,\n    )\n    .filter(Boolean) as NonNullable<AdminPageMetadata['openGraph']>['images']\n\n  const rawIcons = meta.icons as any\n  const iconList = Array.isArray(rawIcons)\n    ? rawIcons\n    : rawIcons && typeof rawIcons === 'object' && Array.isArray(rawIcons.icon)\n      ? rawIcons.icon\n      : []\n  const icons = iconList\n    .map((icon: any) =>\n      typeof icon === 'string'\n        ? { rel: 'icon', url: icon }\n        : icon?.url\n          ? {\n              type: icon.type,\n              media: icon.media,\n              rel: icon.rel ?? 'icon',\n              sizes: icon.sizes,\n              url: String(icon.url),\n            }\n          : undefined,\n    )\n    .filter(Boolean) as AdminPageMetadata['icons']\n\n  const keywords = meta.keywords\n\n  return {\n    description: typeof meta.description === 'string' ? meta.description : undefined,\n    icons: icons?.length ? icons : undefined,\n    keywords:\n      typeof keywords === 'string'\n        ? keywords\n        : Array.isArray(keywords)\n          ? keywords.join(', ')\n          : undefined,\n    openGraph: og\n      ? {\n          description: typeof og.description === 'string' ? og.description : undefined,\n          images: images?.length ? images : undefined,\n          siteName: typeof og.siteName === 'string' ? og.siteName : undefined,\n          title: typeof og.title === 'string' ? og.title : undefined,\n        }\n      : undefined,\n    robots: typeof meta.robots === 'string' ? meta.robots : undefined,\n    title: resolveTitle(meta.title),\n  }\n}\n\n/**\n * Renders an admin page for TanStack Start and returns a serializable loader\n * result. The framework adapter wraps this in a `createServerFn` that supplies\n * the app's `config` and generated `importMap`.\n *\n *   1. Initializes the Payload request via the shared `renderRoot` orchestrator\n *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected\n *      page-render `ServerAdapter` records navigation intent and throws the\n *      framework-agnostic error contract.\n *   2. Pipes the resulting React server tree through `renderServerComponent`\n *      to produce a Flight payload the client consumes directly.\n *   3. Resolves page metadata via the same shared `generatePageMetadata`\n *      Next.js uses, returning plain serializable strings for `head()`.\n *\n * Navigation surfaces two ways and both become a `_notFound` / `_redirect`\n * sentinel the route loader re-throws as native TanStack nav:\n * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught\n *   by the try/catch below;\n * - thrown deep inside a streamed view component (e.g. `DocumentView` access\n *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,\n *   so it's read from the `nav` holder after `renderServerComponent` resolves.\n */\nexport async function loadAdminPage({\n  config,\n  importMap,\n  search,\n  splat,\n}: LoadAdminPageArgs): Promise<LoadAdminPageResult> {\n  const { renderRoot } = await import('@payloadcms/ui/views/Root')\n  const { defaultAdminViews } = await import('@payloadcms/ui/views/Root/adminViews')\n  const { generatePageMetadata } = await import('@payloadcms/ui/views/Root/generatePageMetadata')\n\n  const splatSegments = splat ? splat.split('/').filter(Boolean) : []\n  // Match Next's optional-catch-all behavior: the admin root (`/admin`) has no\n  // segments. Passing an empty array makes the shared `renderRoot` build\n  // `currentRoute` as `/admin/` (trailing slash), which no longer equals\n  // `adminRoute` and causes `handleAuthRedirect` to append `?redirect=/admin/`.\n  // Passing `undefined` yields `currentRoute = /admin`, so the unauthenticated\n  // redirect lands on a clean `/admin/login`.\n  const segments = splatSegments.length > 0 ? splatSegments : undefined\n  const searchParams = search ?? {}\n\n  // Records navigation requested via `req.server.*` (including throws swallowed\n  // by RSC streaming deep inside view components). Read after the render.\n  const nav: { type?: 'notFound' | 'redirect'; url?: string } = {}\n  const pageServerAdapter = createPageRenderServerAdapter(nav)\n  let userAgent: string | undefined\n\n  // `renderRoot` calls `initReq` itself with its own overrides (query\n  // re-nesting, `urlSuffix`, `fallbackLocale`). Forward them, injecting the\n  // page-render `ServerAdapter` so `req.server.redirect()` / `.notFound()`\n  // is recorded + thrown rather than escaping as raw TanStack nav.\n  const boundInitReq: Parameters<typeof renderRoot>[0]['initReq'] = async (args) => {\n    const result = await initReq({\n      configPromise: args.configPromise,\n      importMap: args.importMap,\n      overrides: args.overrides,\n      serverAdapter: pageServerAdapter,\n    })\n    userAgent = result.headers.get('user-agent') ?? undefined\n    return result\n  }\n\n  const notFound = (): never => {\n    nav.type = 'notFound'\n    throw new Error('not-found')\n  }\n  const redirect = (url: string): never => {\n    nav.type = 'redirect'\n    nav.url = url\n    throw new Error(`redirect:${url}`)\n  }\n\n  // Build the 404 result the route loader re-throws as TanStack `notFound()`.\n  //\n  // Throwing `notFound()` is the only way to set the SSR document status to 404\n  // (it's read from `router.stores.statusCode`, set by a not-found match — NOT\n  // from `setResponseStatus`, which only affects the RSC RPC response). But the\n  // matching `notFoundComponent` is a client component with no access to the\n  // Payload `req`, so it can't build the admin chrome on its own. To match Next\n  // (whose not-found route renders the full admin layout — nav sidebar, etc. —\n  // around the NotFound body, see `renderNotFoundPage`), we render that same\n  // shared `renderNotFoundPage` tree here, server-side, and ship its Flight\n  // payload through the `notFound()` error so the client renders it verbatim.\n  // For users without admin access `renderNotFoundPage` returns the bare\n  // `NotFoundClient`, preserving the access-denied behavior.\n  const renderNotFound = async (): Promise<LoadAdminPageResult> => {\n    const { renderNotFoundPage } = await import('@payloadcms/ui/views/NotFound/page')\n\n    const notFoundNode = await renderNotFoundPage({\n      config: Promise.resolve(config),\n      importMap,\n      initReq: (args) =>\n        initReq({\n          configPromise: args.configPromise,\n          importMap: args.importMap,\n          overrides: args.overrides,\n        }),\n      params: Promise.resolve({ segments: splatSegments }),\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(notFoundNode as React.ReactElement)\n\n    return { _notFound: true, routeKey: splat ?? '', rscPayload }\n  }\n\n  try {\n    const node = await renderRoot({\n      adminViews: defaultAdminViews,\n      config: Promise.resolve(config),\n      importMap,\n      initReq: boundInitReq,\n      notFound,\n      // `segments` is intentionally `undefined` for the admin root (`/admin`),\n      // matching Next's optional catch-all; `renderRoot` handles it at runtime.\n      params: Promise.resolve({ segments }) as Parameters<typeof renderRoot>[0]['params'],\n      redirect,\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(node as React.ReactElement)\n\n    // The server-function (client-nav RPC) path returns the flight stream unread —\n    // unlike the router/SSR path, which awaits a decode that drives the render to\n    // completion. So streamed side effects (e.g. DocumentView's autosave-create\n    // `server.redirect()`) haven't run yet and `nav` is empty. Buffer the stream to\n    // completion to force the render (populating `nav`), then hand the client a fresh\n    // replayable stream from that buffer.\n    if (!nav.type) {\n      const wrapper = (\n        rscPayload as unknown as Record<\n          symbol,\n          { createReplayStream?: () => ReadableStream<Uint8Array> } | undefined\n        >\n      )[Symbol.for('tanstack.rsc.stream')]\n      if (typeof wrapper?.createReplayStream === 'function') {\n        const buffer = await new Response(wrapper.createReplayStream()).arrayBuffer()\n        wrapper.createReplayStream = () => new Response(buffer).body as ReadableStream<Uint8Array>\n      }\n    }\n\n    // Navigation thrown deep inside a streamed view component (e.g. access\n    // denied → notFound, already-authenticated → redirect) is swallowed into\n    // the RSC stream and never rejects the render. Honor it from the holder,\n    // discarding the (broken) payload from the aborted render.\n    if (nav.type === 'redirect' && nav.url) {\n      return { _redirect: nav.url }\n    }\n    if (nav.type === 'notFound') {\n      return await renderNotFound()\n    }\n\n    // Resolve metadata through the same shared generator Next.js uses. Only\n    // plain strings cross the wire (the full `MetaConfig` carries a `URL`\n    // `metadataBase` and icons that seroval cannot serialize).\n    const i18n = await getRequestI18n({ config })\n    const meta = await generatePageMetadata({\n      adminViews: defaultAdminViews as Parameters<typeof generatePageMetadata>[0]['adminViews'],\n      config,\n      i18n,\n      params: { segments },\n    })\n\n    return {\n      metadata: {\n        ...toAdminPageMetadata(meta),\n        viewport: getViewportContent(userAgent),\n      },\n      routeKey: splat ?? '',\n      rscPayload,\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    if (nav.type === 'notFound' || message === 'not-found') {\n      return await renderNotFound()\n    }\n    if (nav.type === 'redirect' || message.startsWith('redirect:')) {\n      return { _redirect: nav.url ?? message.slice('redirect:'.length) }\n    }\n    throw err\n  }\n}\n"],"names":["getViewportContent","renderServerComponent","getRequestI18n","initReq","createPageRenderServerAdapter","resolveTitle","title","undefined","absolute","default","toAdminPageMetadata","meta","og","openGraph","rawImages","images","imagesArray","Array","isArray","map","image","url","alt","height","String","width","filter","Boolean","rawIcons","icons","iconList","icon","rel","type","media","sizes","keywords","description","length","join","siteName","robots","loadAdminPage","config","importMap","search","splat","renderRoot","defaultAdminViews","generatePageMetadata","splatSegments","split","segments","searchParams","nav","pageServerAdapter","userAgent","boundInitReq","args","result","configPromise","overrides","serverAdapter","headers","get","notFound","Error","redirect","renderNotFound","renderNotFoundPage","notFoundNode","Promise","resolve","params","rscPayload","_notFound","routeKey","node","adminViews","wrapper","Symbol","for","createReplayStream","buffer","Response","arrayBuffer","body","_redirect","i18n","metadata","viewport","err","message","startsWith","slice"],"mappings":"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"}

package/dist/utilities/meta.d.ts

@@ -49,6 +49,7 @@ export type AdminPageMetadata = {
     };
     robots?: string;
     title?: string;
+    viewport?: string;
 };
 /**
  * Builds TanStack Router `head()` `meta` + `links` entries for an admin page

package/dist/utilities/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/utilities/meta.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GACV;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErB,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG;IAC1D,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,IAAI,EAAE,SAAS,EAAE,CAAA;CAClB,CA0EA"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/utilities/meta.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GACV;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErB,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG;IAC1D,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,IAAI,EAAE,SAAS,EAAE,CAAA;CAClB,CA0EA"}

package/dist/utilities/meta.js

@@ -1,3 +1,4 @@
+import { getViewportContent } from '@payloadcms/ui/layouts';
 /**
  * Builds TanStack Router `head()` `meta` + `links` entries for an admin page
  * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders
@@ -16,7 +17,7 @@
         },
         {
             name: 'viewport',
-            content: 'width=device-width, initial-scale=1'
+            content: metadata?.viewport ?? getViewportContent()
         }
     ];
     const links = [];

package/dist/utilities/meta.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/meta.ts"],"sourcesContent":["type MetaEntry =\n  | { charSet: string }\n  | { content: string; name: string }\n  | { content: string; property: string }\n  | { title: string }\n\ntype LinkEntry = {\n  href: string\n  media?: string\n  rel: string\n  sizes?: string\n  type?: string\n}\n\ntype AdminPageIcon = {\n  media?: string\n  rel?: string\n  sizes?: string\n  type?: string\n  url: string\n}\n\ntype AdminPageOGImage = {\n  alt?: string\n  height?: number\n  url: string\n  width?: number\n}\n\n/**\n * Resolved admin-page metadata produced by the admin-page server function.\n *\n * The server function resolves the framework-agnostic `MetaConfig` (via the\n * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable\n * values, so the route loader can ship it across the wire and feed it to\n * `getAdminMeta` in `head()`.\n */\nexport type AdminPageMetadata = {\n  description?: string\n  icons?: AdminPageIcon[]\n  keywords?: string\n  openGraph?: {\n    description?: string\n    images?: AdminPageOGImage[]\n    siteName?: string\n    title?: string\n  }\n  robots?: string\n  title?: string\n}\n\n/**\n * Builds TanStack Router `head()` `meta` + `links` entries for an admin page\n * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders\n * natively from the same `MetaConfig` (title, description, robots, keywords,\n * OpenGraph, Twitter — derived from OpenGraph — and icon links).\n *\n * ```ts\n * export const Route = createFileRoute('/admin/$')({\n *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),\n * })\n * ```\n */\nexport function getAdminMeta(metadata?: AdminPageMetadata): {\n  links: LinkEntry[]\n  meta: MetaEntry[]\n} {\n  const meta: MetaEntry[] = [\n    { charSet: 'utf-8' },\n    { name: 'viewport', content: 'width=device-width, initial-scale=1' },\n  ]\n  const links: LinkEntry[] = []\n\n  if (!metadata) {\n    return { links, meta }\n  }\n\n  if (metadata.title) {\n    meta.push({ title: metadata.title })\n  }\n  if (metadata.description) {\n    meta.push({ name: 'description', content: metadata.description })\n  }\n  if (metadata.keywords) {\n    meta.push({ name: 'keywords', content: metadata.keywords })\n  }\n  if (metadata.robots) {\n    meta.push({ name: 'robots', content: metadata.robots })\n  }\n\n  const og = metadata.openGraph\n  if (og) {\n    if (og.title) {\n      meta.push({ content: og.title, property: 'og:title' })\n    }\n    if (og.description) {\n      meta.push({ content: og.description, property: 'og:description' })\n    }\n    if (og.siteName) {\n      meta.push({ content: og.siteName, property: 'og:site_name' })\n    }\n\n    for (const image of og.images ?? []) {\n      meta.push({ content: image.url, property: 'og:image' })\n      if (image.width) {\n        meta.push({ content: String(image.width), property: 'og:image:width' })\n      }\n      if (image.height) {\n        meta.push({ content: String(image.height), property: 'og:image:height' })\n      }\n      if (image.alt) {\n        meta.push({ content: image.alt, property: 'og:image:alt' })\n      }\n    }\n\n    // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).\n    const firstImage = og.images?.[0]\n    if (firstImage) {\n      meta.push({ name: 'twitter:card', content: 'summary_large_image' })\n      meta.push({ name: 'twitter:image', content: firstImage.url })\n    }\n    if (og.title) {\n      meta.push({ name: 'twitter:title', content: og.title })\n    }\n    if (og.description) {\n      meta.push({ name: 'twitter:description', content: og.description })\n    }\n  }\n\n  for (const icon of metadata.icons ?? []) {\n    links.push({\n      href: icon.url,\n      rel: icon.rel ?? 'icon',\n      ...(icon.media ? { media: icon.media } : {}),\n      ...(icon.sizes ? { sizes: icon.sizes } : {}),\n      ...(icon.type ? { type: icon.type } : {}),\n    })\n  }\n\n  return { links, meta }\n}\n"],"names":["getAdminMeta","metadata","meta","charSet","name","content","links","title","push","description","keywords","robots","og","openGraph","property","siteName","image","images","url","width","String","height","alt","firstImage","icon","icons","href","rel","media","sizes","type"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/meta.ts"],"sourcesContent":["import { getViewportContent } from '@payloadcms/ui/layouts'\n\ntype MetaEntry =\n  | { charSet: string }\n  | { content: string; name: string }\n  | { content: string; property: string }\n  | { title: string }\n\ntype LinkEntry = {\n  href: string\n  media?: string\n  rel: string\n  sizes?: string\n  type?: string\n}\n\ntype AdminPageIcon = {\n  media?: string\n  rel?: string\n  sizes?: string\n  type?: string\n  url: string\n}\n\ntype AdminPageOGImage = {\n  alt?: string\n  height?: number\n  url: string\n  width?: number\n}\n\n/**\n * Resolved admin-page metadata produced by the admin-page server function.\n *\n * The server function resolves the framework-agnostic `MetaConfig` (via the\n * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable\n * values, so the route loader can ship it across the wire and feed it to\n * `getAdminMeta` in `head()`.\n */\nexport type AdminPageMetadata = {\n  description?: string\n  icons?: AdminPageIcon[]\n  keywords?: string\n  openGraph?: {\n    description?: string\n    images?: AdminPageOGImage[]\n    siteName?: string\n    title?: string\n  }\n  robots?: string\n  title?: string\n  viewport?: string\n}\n\n/**\n * Builds TanStack Router `head()` `meta` + `links` entries for an admin page\n * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders\n * natively from the same `MetaConfig` (title, description, robots, keywords,\n * OpenGraph, Twitter — derived from OpenGraph — and icon links).\n *\n * ```ts\n * export const Route = createFileRoute('/admin/$')({\n *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),\n * })\n * ```\n */\nexport function getAdminMeta(metadata?: AdminPageMetadata): {\n  links: LinkEntry[]\n  meta: MetaEntry[]\n} {\n  const meta: MetaEntry[] = [\n    { charSet: 'utf-8' },\n    { name: 'viewport', content: metadata?.viewport ?? getViewportContent() },\n  ]\n  const links: LinkEntry[] = []\n\n  if (!metadata) {\n    return { links, meta }\n  }\n\n  if (metadata.title) {\n    meta.push({ title: metadata.title })\n  }\n  if (metadata.description) {\n    meta.push({ name: 'description', content: metadata.description })\n  }\n  if (metadata.keywords) {\n    meta.push({ name: 'keywords', content: metadata.keywords })\n  }\n  if (metadata.robots) {\n    meta.push({ name: 'robots', content: metadata.robots })\n  }\n\n  const og = metadata.openGraph\n  if (og) {\n    if (og.title) {\n      meta.push({ content: og.title, property: 'og:title' })\n    }\n    if (og.description) {\n      meta.push({ content: og.description, property: 'og:description' })\n    }\n    if (og.siteName) {\n      meta.push({ content: og.siteName, property: 'og:site_name' })\n    }\n\n    for (const image of og.images ?? []) {\n      meta.push({ content: image.url, property: 'og:image' })\n      if (image.width) {\n        meta.push({ content: String(image.width), property: 'og:image:width' })\n      }\n      if (image.height) {\n        meta.push({ content: String(image.height), property: 'og:image:height' })\n      }\n      if (image.alt) {\n        meta.push({ content: image.alt, property: 'og:image:alt' })\n      }\n    }\n\n    // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).\n    const firstImage = og.images?.[0]\n    if (firstImage) {\n      meta.push({ name: 'twitter:card', content: 'summary_large_image' })\n      meta.push({ name: 'twitter:image', content: firstImage.url })\n    }\n    if (og.title) {\n      meta.push({ name: 'twitter:title', content: og.title })\n    }\n    if (og.description) {\n      meta.push({ name: 'twitter:description', content: og.description })\n    }\n  }\n\n  for (const icon of metadata.icons ?? []) {\n    links.push({\n      href: icon.url,\n      rel: icon.rel ?? 'icon',\n      ...(icon.media ? { media: icon.media } : {}),\n      ...(icon.sizes ? { sizes: icon.sizes } : {}),\n      ...(icon.type ? { type: icon.type } : {}),\n    })\n  }\n\n  return { links, meta }\n}\n"],"names":["getViewportContent","getAdminMeta","metadata","meta","charSet","name","content","viewport","links","title","push","description","keywords","robots","og","openGraph","property","siteName","image","images","url","width","String","height","alt","firstImage","icon","icons","href","rel","media","sizes","type"],"mappings":"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"}

package/dist/utilities/routerSearch.d.ts

@@ -0,0 +1,40 @@
+import * as qs from 'qs-esm';
+/**
+ * `parseSearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadStringifySearch}.
+ *
+ * Payload serializes query state (notably the list-view `where` filter) with
+ * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack
+ * Router's default serializer treats each bracketed string as a flat key and
+ * JSON-encodes values, so it never round-trips Payload's nested query: every
+ * navigation re-encodes the already-encoded value, exponentially nesting it
+ * (`[true,"[true,\"[true…"]`) until the filter is unusable. Parsing and
+ * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps
+ * the URL idempotent and the nested `where` intact across navigations.
+ *
+ * This is a router-global serializer: it applies to every route, not just
+ * `/admin`. On your own routes, search values arrive as strings (qs does no
+ * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where
+ * you need numbers or booleans.
+ *
+ * @example
+ * ```ts
+ * import { createRouter } from '@tanstack/react-router'
+ * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'
+ *
+ * export function getRouter() {
+ *   return createRouter({
+ *     parseSearch: payloadParseSearch,
+ *     routeTree,
+ *     stringifySearch: payloadStringifySearch,
+ *   })
+ * }
+ * ```
+ */
+export declare const payloadParseSearch: (searchStr: string) => qs.ParsedQs;
+/**
+ * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.
+ */
+export declare const payloadStringifySearch: (search: Record<string, unknown>) => string;
+//# sourceMappingURL=routerSearch.d.ts.map

package/dist/utilities/routerSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routerSearch.d.ts","sourceRoot":"","sources":["../../src/utilities/routerSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,QAAQ,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kBAAkB,cAAe,MAAM,gBACS,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,WAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAGrE,CAAA"}

package/dist/utilities/routerSearch.js

@@ -0,0 +1,45 @@
+import * as qs from 'qs-esm';
+/**
+ * `parseSearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadStringifySearch}.
+ *
+ * Payload serializes query state (notably the list-view `where` filter) with
+ * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack
+ * Router's default serializer treats each bracketed string as a flat key and
+ * JSON-encodes values, so it never round-trips Payload's nested query: every
+ * navigation re-encodes the already-encoded value, exponentially nesting it
+ * (`[true,"[true,\"[true…"]`) until the filter is unusable. Parsing and
+ * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps
+ * the URL idempotent and the nested `where` intact across navigations.
+ *
+ * This is a router-global serializer: it applies to every route, not just
+ * `/admin`. On your own routes, search values arrive as strings (qs does no
+ * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where
+ * you need numbers or booleans.
+ *
+ * @example
+ * ```ts
+ * import { createRouter } from '@tanstack/react-router'
+ * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'
+ *
+ * export function getRouter() {
+ *   return createRouter({
+ *     parseSearch: payloadParseSearch,
+ *     routeTree,
+ *     stringifySearch: payloadStringifySearch,
+ *   })
+ * }
+ * ```
+ */ export const payloadParseSearch = (searchStr)=>qs.parse(searchStr, {
+        depth: 10,
+        ignoreQueryPrefix: true
+    });
+/**
+ * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.
+ */ export const payloadStringifySearch = (search)=>{
+    const searchStr = qs.stringify(search);
+    return searchStr ? `?${searchStr}` : '';
+};
+
+//# sourceMappingURL=routerSearch.js.map

package/dist/utilities/routerSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/routerSearch.ts"],"sourcesContent":["import * as qs from 'qs-esm'\n\n/**\n * `parseSearch` for TanStack Router's `createRouter`, required for Payload's\n * admin UI. Pair with {@link payloadStringifySearch}.\n *\n * Payload serializes query state (notably the list-view `where` filter) with\n * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack\n * Router's default serializer treats each bracketed string as a flat key and\n * JSON-encodes values, so it never round-trips Payload's nested query: every\n * navigation re-encodes the already-encoded value, exponentially nesting it\n * (`[true,\"[true,\\\"[true…\"]`) until the filter is unusable. Parsing and\n * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps\n * the URL idempotent and the nested `where` intact across navigations.\n *\n * This is a router-global serializer: it applies to every route, not just\n * `/admin`. On your own routes, search values arrive as strings (qs does no\n * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where\n * you need numbers or booleans.\n *\n * @example\n * ```ts\n * import { createRouter } from '@tanstack/react-router'\n * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'\n *\n * export function getRouter() {\n *   return createRouter({\n *     parseSearch: payloadParseSearch,\n *     routeTree,\n *     stringifySearch: payloadStringifySearch,\n *   })\n * }\n * ```\n */\nexport const payloadParseSearch = (searchStr: string) =>\n  qs.parse(searchStr, { depth: 10, ignoreQueryPrefix: true })\n\n/**\n * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's\n * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.\n */\nexport const payloadStringifySearch = (search: Record<string, unknown>) => {\n  const searchStr = qs.stringify(search)\n  return searchStr ? `?${searchStr}` : ''\n}\n"],"names":["qs","payloadParseSearch","searchStr","parse","depth","ignoreQueryPrefix","payloadStringifySearch","search","stringify"],"mappings":"AAAA,YAAYA,QAAQ,SAAQ;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BC,GACD,OAAO,MAAMC,qBAAqB,CAACC,YACjCF,GAAGG,KAAK,CAACD,WAAW;QAAEE,OAAO;QAAIC,mBAAmB;IAAK,GAAE;AAE7D;;;CAGC,GACD,OAAO,MAAMC,yBAAyB,CAACC;IACrC,MAAML,YAAYF,GAAGQ,SAAS,CAACD;IAC/B,OAAOL,YAAY,CAAC,CAAC,EAAEA,WAAW,GAAG;AACvC,EAAC"}

package/dist/utilities/serverAdapter.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serverAdapter.server.d.ts","sourceRoot":"","sources":["../../src/utilities/serverAdapter.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,SAAS,CAAA;AAsDxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA8CnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,GAAI,KAAK,aAAa,KAAG,aAgBjE,CAAA"}
+{"version":3,"file":"serverAdapter.server.d.ts","sourceRoot":"","sources":["../../src/utilities/serverAdapter.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,SAAS,CAAA;AAsDxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA8CnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,QAAS,aAAa,KAAG,aAgBjE,CAAA"}

package/dist/vite/config/external.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SSR/RSC externalization config used by `withPayload`. Kept separate from the
+ * client optimizer config (`./optimizeDeps.ts`) so each concern stays small.
+ */
+/**
+ * Server-only packages (Node-only or only ever used by the server bundle).
+ * These are the Vite equivalent of Next.js's `serverExternalPackages`.
+ */
+export declare const ssrExternalPackages: string[];
+export declare const payloadNoExternalPatterns: Array<RegExp | string>;
+//# sourceMappingURL=external.d.ts.map

package/dist/vite/config/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/vite/config/external.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EA+BvC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAO5D,CAAA"}