@payloadcms/tanstack-start 4.0.0-internal.293e026 → 4.0.0-internal.4c792ad

package/dist/utilities/loadAdminPage.js

@@ -0,0 +1,217 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { getRequestI18n } from './getRequestI18n.server.js';
+import { initReq } from './initReq.server.js';
+import { createPageRenderServerAdapter } from './serverAdapter.server.js';
+const resolveTitle = (title)=>{
+    if (!title) {
+        return undefined;
+    }
+    if (typeof title === 'string') {
+        return title;
+    }
+    if ('absolute' in title) {
+        return title.absolute;
+    }
+    return title.default;
+};
+/**
+ * Flattens the framework-agnostic `MetaConfig` (Next.js `Metadata` shape) into
+ * the plain, serializable `AdminPageMetadata` the route loader ships to the
+ * client. The full `MetaConfig` carries a `URL` `metadataBase`, functions and
+ * other non-serializable values that seroval cannot cross the wire, so only the
+ * fields `getAdminMeta` renders are extracted.
+ */ const toAdminPageMetadata = (meta)=>{
+    const og = meta.openGraph;
+    const rawImages = og?.images;
+    const imagesArray = rawImages ? Array.isArray(rawImages) ? rawImages : [
+        rawImages
+    ] : [];
+    const images = imagesArray.map((image)=>typeof image === 'string' ? {
+            url: image
+        } : image?.url ? {
+            alt: image.alt,
+            height: image.height,
+            url: String(image.url),
+            width: image.width
+        } : undefined).filter(Boolean);
+    const rawIcons = meta.icons;
+    const iconList = Array.isArray(rawIcons) ? rawIcons : rawIcons && typeof rawIcons === 'object' && Array.isArray(rawIcons.icon) ? rawIcons.icon : [];
+    const icons = iconList.map((icon)=>typeof icon === 'string' ? {
+            rel: 'icon',
+            url: icon
+        } : icon?.url ? {
+            type: icon.type,
+            media: icon.media,
+            rel: icon.rel ?? 'icon',
+            sizes: icon.sizes,
+            url: String(icon.url)
+        } : undefined).filter(Boolean);
+    const keywords = meta.keywords;
+    return {
+        description: typeof meta.description === 'string' ? meta.description : undefined,
+        icons: icons?.length ? icons : undefined,
+        keywords: typeof keywords === 'string' ? keywords : Array.isArray(keywords) ? keywords.join(', ') : undefined,
+        openGraph: og ? {
+            description: typeof og.description === 'string' ? og.description : undefined,
+            images: images?.length ? images : undefined,
+            siteName: typeof og.siteName === 'string' ? og.siteName : undefined,
+            title: typeof og.title === 'string' ? og.title : undefined
+        } : undefined,
+        robots: typeof meta.robots === 'string' ? meta.robots : undefined,
+        title: resolveTitle(meta.title)
+    };
+};
+/**
+ * Renders an admin page for TanStack Start and returns a serializable loader
+ * result. The framework adapter wraps this in a `createServerFn` that supplies
+ * the app's `config` and generated `importMap`.
+ *
+ *   1. Initializes the Payload request via the shared `renderRoot` orchestrator
+ *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected
+ *      page-render `ServerAdapter` records navigation intent and throws the
+ *      framework-agnostic error contract.
+ *   2. Pipes the resulting React server tree through `renderServerComponent`
+ *      to produce a Flight payload the client consumes directly.
+ *   3. Resolves page metadata via the same shared `generatePageMetadata`
+ *      Next.js uses, returning plain serializable strings for `head()`.
+ *
+ * Navigation surfaces two ways and both become a `_notFound` / `_redirect`
+ * sentinel the route loader re-throws as native TanStack nav:
+ * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught
+ *   by the try/catch below;
+ * - thrown deep inside a streamed view component (e.g. `DocumentView` access
+ *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,
+ *   so it's read from the `nav` holder after `renderServerComponent` resolves.
+ */ export async function loadAdminPage({ config, importMap, search, splat }) {
+    const { renderRoot } = await import('@payloadcms/ui/views/Root');
+    const { defaultAdminViews } = await import('@payloadcms/ui/views/Root/adminViews');
+    const { generatePageMetadata } = await import('@payloadcms/ui/views/Root/generatePageMetadata');
+    const splatSegments = splat ? splat.split('/').filter(Boolean) : [];
+    // Match Next's optional-catch-all behavior: the admin root (`/admin`) has no
+    // segments. Passing an empty array makes the shared `renderRoot` build
+    // `currentRoute` as `/admin/` (trailing slash), which no longer equals
+    // `adminRoute` and causes `handleAuthRedirect` to append `?redirect=/admin/`.
+    // Passing `undefined` yields `currentRoute = /admin`, so the unauthenticated
+    // redirect lands on a clean `/admin/login`.
+    const segments = splatSegments.length > 0 ? splatSegments : undefined;
+    const searchParams = search ?? {};
+    // Records navigation requested via `req.server.*` (including throws swallowed
+    // by RSC streaming deep inside view components). Read after the render.
+    const nav = {};
+    const pageServerAdapter = createPageRenderServerAdapter(nav);
+    // `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({
+            configPromise: args.configPromise,
+            importMap: args.importMap,
+            overrides: args.overrides,
+            serverAdapter: pageServerAdapter
+        });
+    const notFound = ()=>{
+        nav.type = 'notFound';
+        throw new Error('not-found');
+    };
+    const redirect = (url)=>{
+        nav.type = 'redirect';
+        nav.url = url;
+        throw new Error(`redirect:${url}`);
+    };
+    // Build the 404 result the route loader re-throws as TanStack `notFound()`.
+    //
+    // Throwing `notFound()` is the only way to set the SSR document status to 404
+    // (it's read from `router.stores.statusCode`, set by a not-found match — NOT
+    // from `setResponseStatus`, which only affects the RSC RPC response). But the
+    // matching `notFoundComponent` is a client component with no access to the
+    // Payload `req`, so it can't build the admin chrome on its own. To match Next
+    // (whose not-found route renders the full admin layout — nav sidebar, etc. —
+    // around the NotFound body, see `renderNotFoundPage`), we render that same
+    // shared `renderNotFoundPage` tree here, server-side, and ship its Flight
+    // payload through the `notFound()` error so the client renders it verbatim.
+    // For users without admin access `renderNotFoundPage` returns the bare
+    // `NotFoundClient`, preserving the access-denied behavior.
+    const renderNotFound = async ()=>{
+        const { renderNotFoundPage } = await import('@payloadcms/ui/views/NotFound/page');
+        const notFoundNode = await renderNotFoundPage({
+            config: Promise.resolve(config),
+            importMap,
+            initReq: (args)=>initReq({
+                    configPromise: args.configPromise,
+                    importMap: args.importMap,
+                    overrides: args.overrides
+                }),
+            params: Promise.resolve({
+                segments: splatSegments
+            }),
+            searchParams: Promise.resolve(searchParams)
+        });
+        const rscPayload = await renderServerComponent(notFoundNode);
+        return {
+            _notFound: true,
+            routeKey: splat ?? '',
+            rscPayload
+        };
+    };
+    try {
+        const node = await renderRoot({
+            adminViews: defaultAdminViews,
+            config: Promise.resolve(config),
+            importMap,
+            initReq: boundInitReq,
+            notFound,
+            // `segments` is intentionally `undefined` for the admin root (`/admin`),
+            // matching Next's optional catch-all; `renderRoot` handles it at runtime.
+            params: Promise.resolve({
+                segments
+            }),
+            redirect,
+            searchParams: Promise.resolve(searchParams)
+        });
+        const rscPayload = await renderServerComponent(node);
+        // 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,
+        // discarding the (broken) payload from the aborted render.
+        if (nav.type === 'redirect' && nav.url) {
+            return {
+                _redirect: nav.url
+            };
+        }
+        if (nav.type === 'notFound') {
+            return await renderNotFound();
+        }
+        // Resolve metadata through the same shared generator Next.js uses. Only
+        // plain strings cross the wire (the full `MetaConfig` carries a `URL`
+        // `metadataBase` and icons that seroval cannot serialize).
+        const i18n = await getRequestI18n({
+            config
+        });
+        const meta = await generatePageMetadata({
+            adminViews: defaultAdminViews,
+            config,
+            i18n,
+            params: {
+                segments
+            }
+        });
+        return {
+            metadata: toAdminPageMetadata(meta),
+            routeKey: splat ?? '',
+            rscPayload
+        };
+    } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (nav.type === 'notFound' || message === 'not-found') {
+            return await renderNotFound();
+        }
+        if (nav.type === 'redirect' || message.startsWith('redirect:')) {
+            return {
+                _redirect: nav.url ?? message.slice('redirect:'.length)
+            };
+        }
+        throw err;
+    }
+}
+
+//# sourceMappingURL=loadAdminPage.js.map

package/dist/utilities/loadAdminPage.js.map

@@ -0,0 +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\n/**\n * The serializable RSC handle returned by `renderServerComponent`, not raw\n * `React.ReactNode`. TanStack's `createServerFn` return-type guard recognizes\n * this handle as wire-serializable; widening it to `React.ReactNode` surfaces a\n * `SerializationError<\"JSX is not be serializable\">` at every consuming server\n * function.\n */\ntype RenderedRsc = Awaited<ReturnType<typeof renderServerComponent<React.ReactElement>>>\n\nexport type LoadAdminPageResult =\n  | { _notFound: true; routeKey?: string; rscPayload?: RenderedRsc }\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: RenderedRsc\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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"}

package/dist/utilities/loadLayoutData.d.ts

@@ -0,0 +1,41 @@
+import type { ImportMap, SanitizedConfig } from 'payload';
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { getLayoutData } from '../layouts/Root/getLayoutData.js';
+/** Plain JSON value. See `clientConfig` on {@link LoadLayoutDataResult}. */
+type JSONSerializable = {
+    [key: string]: JSONSerializable;
+} | boolean | JSONSerializable[] | null | number | string | undefined;
+/**
+ * The serializable RSC handle returned by `renderServerComponent`, recognized
+ * by TanStack's `createServerFn` return-type guard. See `loadAdminPage`.
+ */
+type RenderedRsc = Awaited<ReturnType<typeof renderServerComponent<React.ReactElement>>>;
+/**
+ * Serializable layout payload returned to the `/_payload` route loader. Mirrors
+ * `getLayoutData`'s result, with two fields re-typed so TanStack's serialization
+ * guard accepts the wrapping `createServerFn`:
+ * - `providers` is the rendered RSC handle, not the unrendered element tree.
+ * - `clientConfig` is surfaced as plain JSON. `ClientConfig`'s static type
+ *   carries deep `unknown`/function members (field schemas) that the guard
+ *   rejects even though `toSerializable` strips them at runtime. The layout
+ *   route reads it via loosely-typed `useLoaderData`, so the narrowing is inert.
+ */
+export type LoadLayoutDataResult = {
+    clientConfig: JSONSerializable;
+    providers?: RenderedRsc;
+} & Omit<Awaited<ReturnType<typeof getLayoutData>>, 'clientConfig' | 'providers'>;
+/**
+ * Resolves the admin layout data for TanStack Start and returns a serializable
+ * payload for the `/_payload` route loader. The framework adapter wraps this in
+ * a `createServerFn` that supplies the app's `config` and generated `importMap`.
+ *
+ * `toSerializable` strips React elements, so the custom-providers element tree
+ * (`config.admin.components.providers`) is rendered to an RSC payload separately
+ * and re-attached.
+ */
+export declare function loadLayoutData({ config, importMap, }: {
+    config: SanitizedConfig;
+    importMap: ImportMap;
+}): Promise<LoadLayoutDataResult>;
+export {};
+//# sourceMappingURL=loadLayoutData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadLayoutData.d.ts","sourceRoot":"","sources":["../../src/utilities/loadLayoutData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAGhE,4EAA4E;AAC5E,KAAK,gBAAgB,GACjB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,GACnC,OAAO,GACP,gBAAgB,EAAE,GAClB,IAAI,GACJ,MAAM,GACN,MAAM,GACN,SAAS,CAAA;AAEb;;;GAGG;AACH,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;AAExF;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,gBAAgB,CAAA;IAC9B,SAAS,CAAC,EAAE,WAAW,CAAA;CACxB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAA;AAEjF;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EACN,SAAS,GACV,EAAE;IACD,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;CACrB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAQhC"}

package/dist/utilities/loadLayoutData.js

@@ -0,0 +1,24 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { getLayoutData } from '../layouts/Root/getLayoutData.js';
+import { toSerializable } from './toSerializable.js';
+/**
+ * Resolves the admin layout data for TanStack Start and returns a serializable
+ * payload for the `/_payload` route loader. The framework adapter wraps this in
+ * a `createServerFn` that supplies the app's `config` and generated `importMap`.
+ *
+ * `toSerializable` strips React elements, so the custom-providers element tree
+ * (`config.admin.components.providers`) is rendered to an RSC payload separately
+ * and re-attached.
+ */ export async function loadLayoutData({ config, importMap }) {
+    const { providers, ...data } = await getLayoutData({
+        configPromise: config,
+        importMap
+    });
+    return {
+        ...toSerializable(data),
+        clientConfig: data.clientConfig,
+        providers: providers ? await renderServerComponent(providers) : undefined
+    };
+}
+
+//# sourceMappingURL=loadLayoutData.js.map

package/dist/utilities/loadLayoutData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/loadLayoutData.ts"],"sourcesContent":["import type { ImportMap, SanitizedConfig } from 'payload'\n\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\n\nimport { getLayoutData } from '../layouts/Root/getLayoutData.js'\nimport { toSerializable } from './toSerializable.js'\n\n/** Plain JSON value. See `clientConfig` on {@link LoadLayoutDataResult}. */\ntype JSONSerializable =\n  | { [key: string]: JSONSerializable }\n  | boolean\n  | JSONSerializable[]\n  | null\n  | number\n  | string\n  | undefined\n\n/**\n * The serializable RSC handle returned by `renderServerComponent`, recognized\n * by TanStack's `createServerFn` return-type guard. See `loadAdminPage`.\n */\ntype RenderedRsc = Awaited<ReturnType<typeof renderServerComponent<React.ReactElement>>>\n\n/**\n * Serializable layout payload returned to the `/_payload` route loader. Mirrors\n * `getLayoutData`'s result, with two fields re-typed so TanStack's serialization\n * guard accepts the wrapping `createServerFn`:\n * - `providers` is the rendered RSC handle, not the unrendered element tree.\n * - `clientConfig` is surfaced as plain JSON. `ClientConfig`'s static type\n *   carries deep `unknown`/function members (field schemas) that the guard\n *   rejects even though `toSerializable` strips them at runtime. The layout\n *   route reads it via loosely-typed `useLoaderData`, so the narrowing is inert.\n */\nexport type LoadLayoutDataResult = {\n  clientConfig: JSONSerializable\n  providers?: RenderedRsc\n} & Omit<Awaited<ReturnType<typeof getLayoutData>>, 'clientConfig' | 'providers'>\n\n/**\n * Resolves the admin layout data for TanStack Start and returns a serializable\n * payload for the `/_payload` route loader. The framework adapter wraps this in\n * a `createServerFn` that supplies the app's `config` and generated `importMap`.\n *\n * `toSerializable` strips React elements, so the custom-providers element tree\n * (`config.admin.components.providers`) is rendered to an RSC payload separately\n * and re-attached.\n */\nexport async function loadLayoutData({\n  config,\n  importMap,\n}: {\n  config: SanitizedConfig\n  importMap: ImportMap\n}): Promise<LoadLayoutDataResult> {\n  const { providers, ...data } = await getLayoutData({ configPromise: config, importMap })\n\n  return {\n    ...toSerializable(data),\n    clientConfig: data.clientConfig as unknown as JSONSerializable,\n    providers: providers ? await renderServerComponent(providers as any) : undefined,\n  }\n}\n"],"names":["renderServerComponent","getLayoutData","toSerializable","loadLayoutData","config","importMap","providers","data","configPromise","clientConfig","undefined"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,4BAA2B;AAEjE,SAASC,aAAa,QAAQ,mCAAkC;AAChE,SAASC,cAAc,QAAQ,sBAAqB;AAiCpD;;;;;;;;CAQC,GACD,OAAO,eAAeC,eAAe,EACnCC,MAAM,EACNC,SAAS,EAIV;IACC,MAAM,EAAEC,SAAS,EAAE,GAAGC,MAAM,GAAG,MAAMN,cAAc;QAAEO,eAAeJ;QAAQC;IAAU;IAEtF,OAAO;QACL,GAAGH,eAAeK,KAAK;QACvBE,cAAcF,KAAKE,YAAY;QAC/BH,WAAWA,YAAY,MAAMN,sBAAsBM,aAAoBI;IACzE;AACF"}

package/dist/utilities/serverFunctionClient.d.ts

@@ -0,0 +1,29 @@
+import type { ServerFunctionClient, ServerFunctionClientArgs } from 'payload';
+/**
+ * Builds the client-side `ServerFunctionClient` wired into
+ * `RootProvider.serverFunction`, given the app's `createServerFn`-based
+ * dispatcher (`runServerFn`).
+ *
+ * Strips functions / symbols / RegExps / React elements from the args before
+ * dispatching: the previous `fetch + JSON.stringify` pipeline silently dropped
+ * those, but TanStack Start's seroval-based wire format errors instead. We
+ * mirror the relaxed behaviour so existing callers (e.g. `getFormState` in
+ * `ServerFunctionsProvider`) that may pass the live form state — which can
+ * carry stray functions — keep working without each call site sanitising.
+ *
+ * Delegates to `runServerFn`, so the response (including any RSC handles for
+ * server-rendered custom components) is decoded by TanStack Start back into
+ * renderable React nodes on the client.
+ */
+export declare function createServerFunctionClient({ runServerFn, }: {
+    runServerFn: (input: {
+        data: ServerFunctionClientArgs;
+    }) => Promise<unknown>;
+}): ServerFunctionClient;
+/**
+ * Recursively removes values TanStack Start's seroval wire format cannot
+ * serialize (functions, symbols, RegExps, React elements, cyclic refs) and
+ * normalizes `Date` subclasses to plain `Date`.
+ */
+export declare function stripUnserializable(value: unknown, cache?: WeakMap<object, unknown>, ancestors?: WeakSet<object>): unknown;
+//# sourceMappingURL=serverFunctionClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverFunctionClient.d.ts","sourceRoot":"","sources":["../../src/utilities/serverFunctionClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,wBAAwB,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7E,GAAG,oBAAoB,CAKvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAiB,EAC/C,SAAS,GAAE,OAAO,CAAC,MAAM,CAAiB,GACzC,OAAO,CA4FT"}

package/dist/utilities/serverFunctionClient.js

@@ -0,0 +1,109 @@
+/**
+ * Builds the client-side `ServerFunctionClient` wired into
+ * `RootProvider.serverFunction`, given the app's `createServerFn`-based
+ * dispatcher (`runServerFn`).
+ *
+ * Strips functions / symbols / RegExps / React elements from the args before
+ * dispatching: the previous `fetch + JSON.stringify` pipeline silently dropped
+ * those, but TanStack Start's seroval-based wire format errors instead. We
+ * mirror the relaxed behaviour so existing callers (e.g. `getFormState` in
+ * `ServerFunctionsProvider`) that may pass the live form state — which can
+ * carry stray functions — keep working without each call site sanitising.
+ *
+ * Delegates to `runServerFn`, so the response (including any RSC handles for
+ * server-rendered custom components) is decoded by TanStack Start back into
+ * renderable React nodes on the client.
+ */ export function createServerFunctionClient({ runServerFn }) {
+    return async (args)=>{
+        const safeArgs = stripUnserializable(args);
+        return await runServerFn({
+            data: safeArgs
+        });
+    };
+}
+/**
+ * Recursively removes values TanStack Start's seroval wire format cannot
+ * serialize (functions, symbols, RegExps, React elements, cyclic refs) and
+ * normalizes `Date` subclasses to plain `Date`.
+ */ export function stripUnserializable(value, cache = new WeakMap(), ancestors = new WeakSet()) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    const t = typeof value;
+    if (t === 'function' || t === 'symbol') {
+        return undefined;
+    }
+    if (t !== 'object') {
+        return value;
+    }
+    const obj = value;
+    if (typeof obj.$$typeof === 'symbol') {
+        return undefined;
+    }
+    if (ancestors.has(obj)) {
+        return undefined;
+    }
+    if (cache.has(obj)) {
+        return cache.get(obj);
+    }
+    if (obj instanceof Date) {
+        // Normalize to a plain `Date`. Subclasses (e.g. `@date-fns/tz`'s `TZDate`,
+        // used by the schedule-publish drawer) are `instanceof Date` but have a
+        // different `constructor`, which TanStack Start's seroval serializer
+        // rejects with "The value [object Date] ... cannot be parsed/serialized".
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof RegExp) {
+        return undefined;
+    }
+    ancestors.add(obj);
+    if (obj instanceof Map) {
+        const cleaned = new Map();
+        cache.set(obj, cleaned);
+        for (const [k, v] of obj){
+            const cv = stripUnserializable(v, cache, ancestors);
+            if (cv !== undefined) {
+                cleaned.set(k, cv);
+            }
+        }
+        ancestors.delete(obj);
+        return cleaned;
+    }
+    if (obj instanceof Set) {
+        const cleaned = new Set();
+        cache.set(obj, cleaned);
+        for (const v of obj){
+            const cv = stripUnserializable(v, cache, ancestors);
+            if (cv !== undefined) {
+                cleaned.add(cv);
+            }
+        }
+        ancestors.delete(obj);
+        return cleaned;
+    }
+    if (Array.isArray(obj)) {
+        const arr = [];
+        cache.set(obj, arr);
+        for (const item of obj){
+            arr.push(stripUnserializable(item, cache, ancestors));
+        }
+        ancestors.delete(obj);
+        return arr;
+    }
+    if (ArrayBuffer.isView(obj)) {
+        ancestors.delete(obj);
+        return obj;
+    }
+    const result = {};
+    cache.set(obj, result);
+    for (const key of Object.keys(obj)){
+        const v = stripUnserializable(obj[key], cache, ancestors);
+        if (v !== undefined) {
+            result[key] = v;
+        }
+    }
+    ancestors.delete(obj);
+    return result;
+}
+
+//# sourceMappingURL=serverFunctionClient.js.map

package/dist/utilities/serverFunctionClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/serverFunctionClient.ts"],"sourcesContent":["import type { ServerFunctionClient, ServerFunctionClientArgs } from 'payload'\n\n/**\n * Builds the client-side `ServerFunctionClient` wired into\n * `RootProvider.serverFunction`, given the app's `createServerFn`-based\n * dispatcher (`runServerFn`).\n *\n * Strips functions / symbols / RegExps / React elements from the args before\n * dispatching: the previous `fetch + JSON.stringify` pipeline silently dropped\n * those, but TanStack Start's seroval-based wire format errors instead. We\n * mirror the relaxed behaviour so existing callers (e.g. `getFormState` in\n * `ServerFunctionsProvider`) that may pass the live form state — which can\n * carry stray functions — keep working without each call site sanitising.\n *\n * Delegates to `runServerFn`, so the response (including any RSC handles for\n * server-rendered custom components) is decoded by TanStack Start back into\n * renderable React nodes on the client.\n */\nexport function createServerFunctionClient({\n  runServerFn,\n}: {\n  runServerFn: (input: { data: ServerFunctionClientArgs }) => Promise<unknown>\n}): ServerFunctionClient {\n  return (async (args: ServerFunctionClientArgs) => {\n    const safeArgs = stripUnserializable(args) as ServerFunctionClientArgs\n    return await runServerFn({ data: safeArgs })\n  }) as ServerFunctionClient\n}\n\n/**\n * Recursively removes values TanStack Start's seroval wire format cannot\n * serialize (functions, symbols, RegExps, React elements, cyclic refs) and\n * normalizes `Date` subclasses to plain `Date`.\n */\nexport function stripUnserializable(\n  value: unknown,\n  cache: WeakMap<object, unknown> = new WeakMap(),\n  ancestors: WeakSet<object> = new WeakSet(),\n): unknown {\n  if (value === null || value === undefined) {\n    return value\n  }\n\n  const t = typeof value\n  if (t === 'function' || t === 'symbol') {\n    return undefined\n  }\n  if (t !== 'object') {\n    return value\n  }\n\n  const obj = value as Record<string, unknown>\n\n  if (typeof obj.$$typeof === 'symbol') {\n    return undefined\n  }\n\n  if (ancestors.has(obj)) {\n    return undefined\n  }\n\n  if (cache.has(obj)) {\n    return cache.get(obj)\n  }\n\n  if (obj instanceof Date) {\n    // Normalize to a plain `Date`. Subclasses (e.g. `@date-fns/tz`'s `TZDate`,\n    // used by the schedule-publish drawer) are `instanceof Date` but have a\n    // different `constructor`, which TanStack Start's seroval serializer\n    // rejects with \"The value [object Date] ... cannot be parsed/serialized\".\n    return new Date(obj.getTime())\n  }\n\n  if (obj instanceof RegExp) {\n    return undefined\n  }\n\n  ancestors.add(obj)\n\n  if (obj instanceof Map) {\n    const cleaned = new Map()\n    cache.set(obj, cleaned)\n    for (const [k, v] of obj) {\n      const cv = stripUnserializable(v, cache, ancestors)\n      if (cv !== undefined) {\n        cleaned.set(k, cv)\n      }\n    }\n    ancestors.delete(obj)\n    return cleaned\n  }\n\n  if (obj instanceof Set) {\n    const cleaned = new Set()\n    cache.set(obj, cleaned)\n    for (const v of obj) {\n      const cv = stripUnserializable(v, cache, ancestors)\n      if (cv !== undefined) {\n        cleaned.add(cv)\n      }\n    }\n    ancestors.delete(obj)\n    return cleaned\n  }\n\n  if (Array.isArray(obj)) {\n    const arr: unknown[] = []\n    cache.set(obj, arr)\n    for (const item of obj) {\n      arr.push(stripUnserializable(item, cache, ancestors))\n    }\n    ancestors.delete(obj)\n    return arr\n  }\n\n  if (ArrayBuffer.isView(obj)) {\n    ancestors.delete(obj)\n    return obj\n  }\n\n  const result: Record<string, unknown> = {}\n  cache.set(obj, result)\n  for (const key of Object.keys(obj)) {\n    const v = stripUnserializable(obj[key], cache, ancestors)\n    if (v !== undefined) {\n      result[key] = v\n    }\n  }\n  ancestors.delete(obj)\n  return result\n}\n"],"names":["createServerFunctionClient","runServerFn","args","safeArgs","stripUnserializable","data","value","cache","WeakMap","ancestors","WeakSet","undefined","t","obj","$$typeof","has","get","Date","getTime","RegExp","add","Map","cleaned","set","k","v","cv","delete","Set","Array","isArray","arr","item","push","ArrayBuffer","isView","result","key","Object","keys"],"mappings":"AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASA,2BAA2B,EACzCC,WAAW,EAGZ;IACC,OAAQ,OAAOC;QACb,MAAMC,WAAWC,oBAAoBF;QACrC,OAAO,MAAMD,YAAY;YAAEI,MAAMF;QAAS;IAC5C;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASC,oBACdE,KAAc,EACdC,QAAkC,IAAIC,SAAS,EAC/CC,YAA6B,IAAIC,SAAS;IAE1C,IAAIJ,UAAU,QAAQA,UAAUK,WAAW;QACzC,OAAOL;IACT;IAEA,MAAMM,IAAI,OAAON;IACjB,IAAIM,MAAM,cAAcA,MAAM,UAAU;QACtC,OAAOD;IACT;IACA,IAAIC,MAAM,UAAU;QAClB,OAAON;IACT;IAEA,MAAMO,MAAMP;IAEZ,IAAI,OAAOO,IAAIC,QAAQ,KAAK,UAAU;QACpC,OAAOH;IACT;IAEA,IAAIF,UAAUM,GAAG,CAACF,MAAM;QACtB,OAAOF;IACT;IAEA,IAAIJ,MAAMQ,GAAG,CAACF,MAAM;QAClB,OAAON,MAAMS,GAAG,CAACH;IACnB;IAEA,IAAIA,eAAeI,MAAM;QACvB,2EAA2E;QAC3E,wEAAwE;QACxE,qEAAqE;QACrE,0EAA0E;QAC1E,OAAO,IAAIA,KAAKJ,IAAIK,OAAO;IAC7B;IAEA,IAAIL,eAAeM,QAAQ;QACzB,OAAOR;IACT;IAEAF,UAAUW,GAAG,CAACP;IAEd,IAAIA,eAAeQ,KAAK;QACtB,MAAMC,UAAU,IAAID;QACpBd,MAAMgB,GAAG,CAACV,KAAKS;QACf,KAAK,MAAM,CAACE,GAAGC,EAAE,IAAIZ,IAAK;YACxB,MAAMa,KAAKtB,oBAAoBqB,GAAGlB,OAAOE;YACzC,IAAIiB,OAAOf,WAAW;gBACpBW,QAAQC,GAAG,CAACC,GAAGE;YACjB;QACF;QACAjB,UAAUkB,MAAM,CAACd;QACjB,OAAOS;IACT;IAEA,IAAIT,eAAee,KAAK;QACtB,MAAMN,UAAU,IAAIM;QACpBrB,MAAMgB,GAAG,CAACV,KAAKS;QACf,KAAK,MAAMG,KAAKZ,IAAK;YACnB,MAAMa,KAAKtB,oBAAoBqB,GAAGlB,OAAOE;YACzC,IAAIiB,OAAOf,WAAW;gBACpBW,QAAQF,GAAG,CAACM;YACd;QACF;QACAjB,UAAUkB,MAAM,CAACd;QACjB,OAAOS;IACT;IAEA,IAAIO,MAAMC,OAAO,CAACjB,MAAM;QACtB,MAAMkB,MAAiB,EAAE;QACzBxB,MAAMgB,GAAG,CAACV,KAAKkB;QACf,KAAK,MAAMC,QAAQnB,IAAK;YACtBkB,IAAIE,IAAI,CAAC7B,oBAAoB4B,MAAMzB,OAAOE;QAC5C;QACAA,UAAUkB,MAAM,CAACd;QACjB,OAAOkB;IACT;IAEA,IAAIG,YAAYC,MAAM,CAACtB,MAAM;QAC3BJ,UAAUkB,MAAM,CAACd;QACjB,OAAOA;IACT;IAEA,MAAMuB,SAAkC,CAAC;IACzC7B,MAAMgB,GAAG,CAACV,KAAKuB;IACf,KAAK,MAAMC,OAAOC,OAAOC,IAAI,CAAC1B,KAAM;QAClC,MAAMY,IAAIrB,oBAAoBS,GAAG,CAACwB,IAAI,EAAE9B,OAAOE;QAC/C,IAAIgB,MAAMd,WAAW;YACnByB,MAAM,CAACC,IAAI,GAAGZ;QAChB;IACF;IACAhB,UAAUkB,MAAM,CAACd;IACjB,OAAOuB;AACT"}

package/dist/vite/constants.d.ts

@@ -16,8 +16,13 @@ export declare const ssrExternalPackages: string[];
 export declare const payloadNoExternalPatterns: Array<RegExp | string>;
 /**
  * The subset of `payloadNoExternalPatterns` that needs to participate in the
- * RSC environment. The RSC graph is narrower — plugins and storage adapters
- * don't run in RSC, only the admin UI surface does.
+ * RSC environment. Plugins and storage adapters must be included: they register
+ * custom providers/components (e.g. `plugin-multi-tenant`'s `'use client'`
+ * `TenantSelectionProvider`) that render in the RSC graph via
+ * `RenderServerComponent`. If the package stays external to RSC, `plugin-rsc`
+ * never transforms its `'use client'` modules into client references, so the
+ * component executes server-side and crashes on the first hook
+ * (`Cannot read properties of null (reading 'useState')`).
  */
 export declare const payloadRscNoExternalPatterns: Array<RegExp | string>;
 /**

package/dist/vite/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/vite/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EA0BvC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAO5D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAK/D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAsB/C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAqC/C,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/vite/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EA0BvC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAO5D,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAO/D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAsB/C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EA8E/C,CAAA"}

package/dist/vite/constants.js

@@ -46,13 +46,20 @@
 ];
 /**
  * The subset of `payloadNoExternalPatterns` that needs to participate in the
- * RSC environment. The RSC graph is narrower — plugins and storage adapters
- * don't run in RSC, only the admin UI surface does.
+ * RSC environment. Plugins and storage adapters must be included: they register
+ * custom providers/components (e.g. `plugin-multi-tenant`'s `'use client'`
+ * `TenantSelectionProvider`) that render in the RSC graph via
+ * `RenderServerComponent`. If the package stays external to RSC, `plugin-rsc`
+ * never transforms its `'use client'` modules into client references, so the
+ * component executes server-side and crashes on the first hook
+ * (`Cannot read properties of null (reading 'useState')`).
  */ export const payloadRscNoExternalPatterns = [
     '@payloadcms/ui',
     '@payloadcms/translations',
     '@payloadcms/tanstack-start',
-    /^@payloadcms\/richtext-lexical/
+    /^@payloadcms\/richtext-lexical/,
+    /^@payloadcms\/plugin-/,
+    /^@payloadcms\/storage-/
 ];
 /**
  * Packages we know contain Node-only code or top-level side effects requiring
@@ -111,7 +118,20 @@
     '@payloadcms/ui > md5',
     'payload > deepmerge',
     'payload > pluralize',
-    'scheduler',
+    // `scheduler` is a transitive dep of `react-dom`, not a direct dependency of
+    // the app, so a bare `'scheduler'` specifier fails to resolve from an isolated
+    // install (`test/node_modules` built with `pnpm i --ignore-workspace`), where
+    // it isn't hoisted to the top level. Path it through `react-dom` so the
+    // optimizer resolves the exact copy the runtime loads.
+    'react-dom > scheduler',
+    // `@payloadcms/ui` (in `optimizeDeps.exclude`) ships compiled output that the
+    // React Compiler rewrote to `import { c } from 'react/compiler-runtime'`.
+    // Because its parent is excluded, the optimizer never crawls in to discover
+    // this entry, so Vite serves `react/compiler-runtime` raw. That file is
+    // CommonJS (`module.exports = require(...)`), so the named `c` export can't be
+    // statically extracted and every client component throws "does not provide an
+    // export named 'c'". Pre-bundling it lets esbuild synthesize the named export.
+    'react/compiler-runtime',
     // Transitive deps that Vite otherwise discovers *after* the initial crawl
     // (react-select pulls in @floating-ui at runtime; react-is is reached via
     // react-transition-group/prop-types; the default date-fns locale is loaded
@@ -123,7 +143,35 @@
     '@payloadcms/ui > react-select > @floating-ui/dom',
     '@payloadcms/ui > react-select > @floating-ui/dom > @floating-ui/core',
     '@payloadcms/ui > react-select > prop-types > react-is',
-    '@payloadcms/ui > date-fns/locale/en-US'
+    '@payloadcms/ui > date-fns/locale/en-US',
+    // Further late discoveries observed re-optimizing mid-run in CI cold starts
+    // (see CI logs: "✨ new dependencies optimized: @dnd-kit/modifiers / ajv /
+    // dequal/lite"). The modular dashboard pulls in `@dnd-kit/modifiers` on first
+    // render; form-state diffing reaches `dequal/lite` (a distinct entry point
+    // from the already-listed `dequal`); client-side field validation reaches
+    // `ajv` *through `payload`* — it is `ssrExternal` server-side but still
+    // bundled into the client, and must be pathed via `payload` so the optimizer
+    // pre-bundles the exact copy the runtime loads.
+    '@payloadcms/ui > @dnd-kit/modifiers',
+    '@payloadcms/ui > dequal/lite',
+    'payload > ajv',
+    // The storage client-upload suites (esp. vercel-blob) crawl part of the
+    // `payload` server runtime into the client bundle and discover these late,
+    // triggering several "optimized dependencies changed. reloading" waves that
+    // reload the page mid-test (the bulk-upload drawer's Create New button /
+    // dropzone vanish and the direct-to-bucket PUT never fires). Pre-bundle the
+    // whole observed set so the first pass is complete.
+    'payload > undici',
+    'payload > jose',
+    'payload > dataloader',
+    'payload > path-to-regexp',
+    'payload > console-table-printer',
+    'payload > ci-info',
+    'payload > image-size',
+    'payload > image-size/fromFile',
+    'payload > ipaddr.js',
+    'payload > range-parser',
+    'payload > sanitize-filename'
 ];
 
 //# sourceMappingURL=constants.js.map