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

package/dist/index.d.ts

@@ -1,6 +1,2 @@
-export { TanStackComponentRenderer } from './elements/RenderComponent/index.js';
-export { TanStackRouterAdapter } from './elements/RouterAdapter/index.js';
-export { payloadApiHandlers } from './routes/apiRoute.js';
-export { viteDevReloadStrategy } from './utilities/devReloadStrategy.js';
-export { type AdminPageMetadata, getAdminMeta } from './utilities/meta.js';
+export { withPayload } from './withPayload/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,KAAK,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -1,7 +1,3 @@
-export { TanStackComponentRenderer } from './elements/RenderComponent/index.js';
-export { TanStackRouterAdapter } from './elements/RouterAdapter/index.js';
-export { payloadApiHandlers } from './routes/apiRoute.js';
-export { viteDevReloadStrategy } from './utilities/devReloadStrategy.js';
-export { getAdminMeta } from './utilities/meta.js';
+export { withPayload } from './withPayload/index.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { TanStackComponentRenderer } from './elements/RenderComponent/index.js'\nexport { TanStackRouterAdapter } from './elements/RouterAdapter/index.js'\nexport { payloadApiHandlers } from './routes/apiRoute.js'\nexport { viteDevReloadStrategy } from './utilities/devReloadStrategy.js'\nexport { type AdminPageMetadata, getAdminMeta } from './utilities/meta.js'\n"],"names":["TanStackComponentRenderer","TanStackRouterAdapter","payloadApiHandlers","viteDevReloadStrategy","getAdminMeta"],"mappings":"AAAA,SAASA,yBAAyB,QAAQ,sCAAqC;AAC/E,SAASC,qBAAqB,QAAQ,oCAAmC;AACzE,SAASC,kBAAkB,QAAQ,uBAAsB;AACzD,SAASC,qBAAqB,QAAQ,mCAAkC;AACxE,SAAiCC,YAAY,QAAQ,sBAAqB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { withPayload } from './withPayload/index.js'\n"],"names":["withPayload"],"mappings":"AAAA,SAASA,WAAW,QAAQ,yBAAwB"}

package/dist/layouts/Root/getLayoutData.d.ts

@@ -1,5 +1,27 @@
-import type { ImportMap, SanitizedConfig } from 'payload';
-import type { RootLayoutData } from './index.js';
+import type { I18nClient } from '@payloadcms/translations';
+import type { Theme } from '@payloadcms/ui';
+import type { ClientConfig, ImportMap, LanguageOptions, SanitizedConfig, SanitizedPermissions, User } from 'payload';
+export type RootLayoutData = {
+    clientConfig: ClientConfig;
+    dateFNSKey: I18nClient['dateFNSKey'];
+    fallbackLang: string;
+    isEmbedded: boolean;
+    isNavOpen: boolean;
+    languageCode: string;
+    languageOptions: LanguageOptions;
+    locale?: string;
+    permissions: SanitizedPermissions;
+    /**
+     * Custom admin provider tree (`config.admin.components.providers`) nested
+     * around the router `<Outlet />`. Built unrendered by `getLayoutData`; the
+     * layout server function renders it to an RSC payload before it reaches the
+     * client. `undefined` when no custom providers are configured.
+     */
+    providers?: React.ReactNode;
+    theme: Theme;
+    translations: I18nClient['translations'];
+    user: null | User;
+};
 export type GetLayoutDataArgs = {
     configPromise: Promise<SanitizedConfig> | SanitizedConfig;
     importMap: ImportMap;

package/dist/layouts/Root/getLayoutData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getLayoutData.d.ts","sourceRoot":"","sources":["../../../src/layouts/Root/getLayoutData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAmB,eAAe,EAAe,MAAM,SAAS,CAAA;AASvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,EAClC,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsF7C"}
+{"version":3,"file":"getLayoutData.d.ts","sourceRoot":"","sources":["../../../src/layouts/Root/getLayoutData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EACf,oBAAoB,EAEpB,IAAI,EACL,MAAM,SAAS,CAAA;AAahB,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,eAAe,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,oBAAoB,CAAA;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAA;IACxC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,EAClC,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwF7C"}

package/dist/layouts/Root/getLayoutData.js

@@ -1,10 +1,11 @@
 import { getNavPrefs } from '@payloadcms/ui/elements/Nav/getNavPrefs';
 import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent';
 import { getClientConfig } from '@payloadcms/ui/utilities/getClientConfig';
+import { getRequestEmbed } from '@payloadcms/ui/utilities/getRequestEmbed';
+import { getRequestTheme } from '@payloadcms/ui/utilities/getRequestTheme';
 import { Outlet } from '@tanstack/react-router';
 import { applyLocaleFiltering } from 'payload/shared';
 import { createElement } from 'react';
-import { getRequestTheme } from '../../utilities/getRequestTheme.js';
 import { initReq } from '../../utilities/initReq.server.js';
 /**
  * Fetches all data needed by the root admin layout.
@@ -19,6 +20,10 @@ import { initReq } from '../../utilities/initReq.server.js';
         cookies,
         headers
     });
+    const isEmbedded = getRequestEmbed({
+        config,
+        cookies
+    });
     const languageOptions = Object.entries(config.i18n.supportedLanguages || {}).reduce((acc, [language, languageConfig])=>{
         if (Object.keys(config.i18n.supportedLanguages).includes(language)) {
             acc.push({
@@ -76,6 +81,7 @@ import { initReq } from '../../utilities/initReq.server.js';
         clientConfig,
         dateFNSKey: req.i18n.dateFNSKey,
         fallbackLang: config.i18n.fallbackLanguage,
+        isEmbedded,
         isNavOpen: navPrefs?.open ?? true,
         languageCode,
         languageOptions,

package/dist/layouts/Root/getLayoutData.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/layouts/Root/getLayoutData.ts"],"sourcesContent":["import type { AcceptedLanguages } from '@payloadcms/translations'\nimport type { ImportMap, LanguageOptions, SanitizedConfig, ServerProps } from 'payload'\n\nimport { getNavPrefs } from '@payloadcms/ui/elements/Nav/getNavPrefs'\nimport { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'\nimport { getClientConfig } from '@payloadcms/ui/utilities/getClientConfig'\nimport { Outlet } from '@tanstack/react-router'\nimport { applyLocaleFiltering } from 'payload/shared'\nimport { createElement } from 'react'\n\nimport type { RootLayoutData } from './index.js'\n\nimport { getRequestTheme } from '../../utilities/getRequestTheme.js'\nimport { initReq } from '../../utilities/initReq.server.js'\n\nexport type GetLayoutDataArgs = {\n  configPromise: Promise<SanitizedConfig> | SanitizedConfig\n  importMap: ImportMap\n}\n\n/**\n * Fetches all data needed by the root admin layout.\n * Call this in your TanStack Start root route loader.\n */\nexport async function getLayoutData({\n  configPromise,\n  importMap,\n}: GetLayoutDataArgs): Promise<RootLayoutData> {\n  const {\n    cookies,\n    headers,\n    languageCode,\n    permissions,\n    req,\n    req: {\n      payload: { config },\n    },\n  } = await initReq({ configPromise, importMap })\n\n  const theme = getRequestTheme({ config, cookies, headers })\n\n  const languageOptions: LanguageOptions = Object.entries(\n    config.i18n.supportedLanguages || {},\n  ).reduce((acc, [language, languageConfig]) => {\n    if (Object.keys(config.i18n.supportedLanguages).includes(language)) {\n      acc.push({\n        label: languageConfig.translations.general.thisLanguage,\n        value: language as AcceptedLanguages,\n      })\n    }\n    return acc\n  }, [] as LanguageOptions)\n\n  const navPrefs = await getNavPrefs(req)\n\n  const clientConfig = getClientConfig({\n    config,\n    i18n: req.i18n,\n    importMap,\n    user: req.user ?? true,\n  })\n\n  await applyLocaleFiltering({ clientConfig, config, req })\n\n  // Build the custom admin provider tree (`config.admin.components.providers`)\n  // nested around the router `<Outlet />`, mirroring the Next adapter's\n  // `NestProviders`. Returned as an unrendered element; the caller's server\n  // function renders it to an RSC payload (so server-component providers run\n  // server-side and client providers wrap the live Outlet). `undefined` when\n  // no custom providers are configured — the caller falls back to `<Outlet />`.\n  const providerPaths = config.admin?.components?.providers\n  let providers: React.ReactNode = undefined\n  if (Array.isArray(providerPaths) && providerPaths.length > 0) {\n    const serverProps: ServerProps = {\n      i18n: req.i18n,\n      params: {},\n      payload: req.payload,\n      permissions,\n      searchParams: {},\n      server: req.server,\n      user: req.user ?? undefined,\n    }\n    // Mirror the Next adapter's `NestProviders`: render each configured provider\n    // via `RenderServerComponent` so the entry's own `clientProps`/`serverProps`\n    // (e.g. plugin-multi-tenant's `userHasAccessToAllTenants`) are merged in, and\n    // server components receive `serverProps` while client components get only\n    // `clientProps`. Nested around the router `<Outlet />` instead of `children`.\n    providers = providerPaths.reduceRight<React.ReactNode>(\n      (children, provider) =>\n        RenderServerComponent({\n          clientProps: { children },\n          Component: provider,\n          importMap,\n          serverProps,\n        }),\n      createElement(Outlet),\n    )\n  }\n\n  return {\n    clientConfig,\n    dateFNSKey: req.i18n.dateFNSKey,\n    fallbackLang: config.i18n.fallbackLanguage,\n    isNavOpen: navPrefs?.open ?? true,\n    languageCode,\n    languageOptions,\n    locale: req.locale ?? undefined,\n    permissions,\n    providers,\n    theme,\n    translations: req.i18n.translations,\n    user: req.user,\n  }\n}\n"],"names":["getNavPrefs","RenderServerComponent","getClientConfig","Outlet","applyLocaleFiltering","createElement","getRequestTheme","initReq","getLayoutData","configPromise","importMap","cookies","headers","languageCode","permissions","req","payload","config","theme","languageOptions","Object","entries","i18n","supportedLanguages","reduce","acc","language","languageConfig","keys","includes","push","label","translations","general","thisLanguage","value","navPrefs","clientConfig","user","providerPaths","admin","components","providers","undefined","Array","isArray","length","serverProps","params","searchParams","server","reduceRight","children","provider","clientProps","Component","dateFNSKey","fallbackLang","fallbackLanguage","isNavOpen","open","locale"],"mappings":"AAGA,SAASA,WAAW,QAAQ,0CAAyC;AACrE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,MAAM,QAAQ,yBAAwB;AAC/C,SAASC,oBAAoB,QAAQ,iBAAgB;AACrD,SAASC,aAAa,QAAQ,QAAO;AAIrC,SAASC,eAAe,QAAQ,qCAAoC;AACpE,SAASC,OAAO,QAAQ,oCAAmC;AAO3D;;;CAGC,GACD,OAAO,eAAeC,cAAc,EAClCC,aAAa,EACbC,SAAS,EACS;IAClB,MAAM,EACJC,OAAO,EACPC,OAAO,EACPC,YAAY,EACZC,WAAW,EACXC,GAAG,EACHA,KAAK,EACHC,SAAS,EAAEC,MAAM,EAAE,EACpB,EACF,GAAG,MAAMV,QAAQ;QAAEE;QAAeC;IAAU;IAE7C,MAAMQ,QAAQZ,gBAAgB;QAAEW;QAAQN;QAASC;IAAQ;IAEzD,MAAMO,kBAAmCC,OAAOC,OAAO,CACrDJ,OAAOK,IAAI,CAACC,kBAAkB,IAAI,CAAC,GACnCC,MAAM,CAAC,CAACC,KAAK,CAACC,UAAUC,eAAe;QACvC,IAAIP,OAAOQ,IAAI,CAACX,OAAOK,IAAI,CAACC,kBAAkB,EAAEM,QAAQ,CAACH,WAAW;YAClED,IAAIK,IAAI,CAAC;gBACPC,OAAOJ,eAAeK,YAAY,CAACC,OAAO,CAACC,YAAY;gBACvDC,OAAOT;YACT;QACF;QACA,OAAOD;IACT,GAAG,EAAE;IAEL,MAAMW,WAAW,MAAMpC,YAAYe;IAEnC,MAAMsB,eAAenC,gBAAgB;QACnCe;QACAK,MAAMP,IAAIO,IAAI;QACdZ;QACA4B,MAAMvB,IAAIuB,IAAI,IAAI;IACpB;IAEA,MAAMlC,qBAAqB;QAAEiC;QAAcpB;QAAQF;IAAI;IAEvD,6EAA6E;IAC7E,sEAAsE;IACtE,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAMwB,gBAAgBtB,OAAOuB,KAAK,EAAEC,YAAYC;IAChD,IAAIA,YAA6BC;IACjC,IAAIC,MAAMC,OAAO,CAACN,kBAAkBA,cAAcO,MAAM,GAAG,GAAG;QAC5D,MAAMC,cAA2B;YAC/BzB,MAAMP,IAAIO,IAAI;YACd0B,QAAQ,CAAC;YACThC,SAASD,IAAIC,OAAO;YACpBF;YACAmC,cAAc,CAAC;YACfC,QAAQnC,IAAImC,MAAM;YAClBZ,MAAMvB,IAAIuB,IAAI,IAAIK;QACpB;QACA,6EAA6E;QAC7E,6EAA6E;QAC7E,8EAA8E;QAC9E,2EAA2E;QAC3E,8EAA8E;QAC9ED,YAAYH,cAAcY,WAAW,CACnC,CAACC,UAAUC,WACTpD,sBAAsB;gBACpBqD,aAAa;oBAAEF;gBAAS;gBACxBG,WAAWF;gBACX3C;gBACAqC;YACF,IACF1C,cAAcF;IAElB;IAEA,OAAO;QACLkC;QACAmB,YAAYzC,IAAIO,IAAI,CAACkC,UAAU;QAC/BC,cAAcxC,OAAOK,IAAI,CAACoC,gBAAgB;QAC1CC,WAAWvB,UAAUwB,QAAQ;QAC7B/C;QACAM;QACA0C,QAAQ9C,IAAI8C,MAAM,IAAIlB;QACtB7B;QACA4B;QACAxB;QACAc,cAAcjB,IAAIO,IAAI,CAACU,YAAY;QACnCM,MAAMvB,IAAIuB,IAAI;IAChB;AACF"}
+{"version":3,"sources":["../../../src/layouts/Root/getLayoutData.ts"],"sourcesContent":["import type { AcceptedLanguages, I18nClient } from '@payloadcms/translations'\nimport type { Theme } from '@payloadcms/ui'\nimport type {\n  ClientConfig,\n  ImportMap,\n  LanguageOptions,\n  SanitizedConfig,\n  SanitizedPermissions,\n  ServerProps,\n  User,\n} from 'payload'\n\nimport { getNavPrefs } from '@payloadcms/ui/elements/Nav/getNavPrefs'\nimport { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'\nimport { getClientConfig } from '@payloadcms/ui/utilities/getClientConfig'\nimport { getRequestEmbed } from '@payloadcms/ui/utilities/getRequestEmbed'\nimport { getRequestTheme } from '@payloadcms/ui/utilities/getRequestTheme'\nimport { Outlet } from '@tanstack/react-router'\nimport { applyLocaleFiltering } from 'payload/shared'\nimport { createElement } from 'react'\n\nimport { initReq } from '../../utilities/initReq.server.js'\n\nexport type RootLayoutData = {\n  clientConfig: ClientConfig\n  dateFNSKey: I18nClient['dateFNSKey']\n  fallbackLang: string\n  isEmbedded: boolean\n  isNavOpen: boolean\n  languageCode: string\n  languageOptions: LanguageOptions\n  locale?: string\n  permissions: SanitizedPermissions\n  /**\n   * Custom admin provider tree (`config.admin.components.providers`) nested\n   * around the router `<Outlet />`. Built unrendered by `getLayoutData`; the\n   * layout server function renders it to an RSC payload before it reaches the\n   * client. `undefined` when no custom providers are configured.\n   */\n  providers?: React.ReactNode\n  theme: Theme\n  translations: I18nClient['translations']\n  user: null | User\n}\n\nexport type GetLayoutDataArgs = {\n  configPromise: Promise<SanitizedConfig> | SanitizedConfig\n  importMap: ImportMap\n}\n\n/**\n * Fetches all data needed by the root admin layout.\n * Call this in your TanStack Start root route loader.\n */\nexport async function getLayoutData({\n  configPromise,\n  importMap,\n}: GetLayoutDataArgs): Promise<RootLayoutData> {\n  const {\n    cookies,\n    headers,\n    languageCode,\n    permissions,\n    req,\n    req: {\n      payload: { config },\n    },\n  } = await initReq({ configPromise, importMap })\n\n  const theme = getRequestTheme({ config, cookies, headers })\n  const isEmbedded = getRequestEmbed({ config, cookies })\n\n  const languageOptions: LanguageOptions = Object.entries(\n    config.i18n.supportedLanguages || {},\n  ).reduce((acc, [language, languageConfig]) => {\n    if (Object.keys(config.i18n.supportedLanguages).includes(language)) {\n      acc.push({\n        label: languageConfig.translations.general.thisLanguage,\n        value: language as AcceptedLanguages,\n      })\n    }\n    return acc\n  }, [] as LanguageOptions)\n\n  const navPrefs = await getNavPrefs(req)\n\n  const clientConfig = getClientConfig({\n    config,\n    i18n: req.i18n,\n    importMap,\n    user: req.user ?? true,\n  })\n\n  await applyLocaleFiltering({ clientConfig, config, req })\n\n  // Build the custom admin provider tree (`config.admin.components.providers`)\n  // nested around the router `<Outlet />`, mirroring the Next adapter's\n  // `NestProviders`. Returned as an unrendered element; the caller's server\n  // function renders it to an RSC payload (so server-component providers run\n  // server-side and client providers wrap the live Outlet). `undefined` when\n  // no custom providers are configured — the caller falls back to `<Outlet />`.\n  const providerPaths = config.admin?.components?.providers\n  let providers: React.ReactNode = undefined\n  if (Array.isArray(providerPaths) && providerPaths.length > 0) {\n    const serverProps: ServerProps = {\n      i18n: req.i18n,\n      params: {},\n      payload: req.payload,\n      permissions,\n      searchParams: {},\n      server: req.server!,\n      user: req.user ?? undefined,\n    }\n    // Mirror the Next adapter's `NestProviders`: render each configured provider\n    // via `RenderServerComponent` so the entry's own `clientProps`/`serverProps`\n    // (e.g. plugin-multi-tenant's `userHasAccessToAllTenants`) are merged in, and\n    // server components receive `serverProps` while client components get only\n    // `clientProps`. Nested around the router `<Outlet />` instead of `children`.\n    providers = providerPaths.reduceRight<React.ReactNode>(\n      (children, provider) =>\n        RenderServerComponent({\n          clientProps: { children },\n          Component: provider,\n          importMap,\n          serverProps,\n        }),\n      createElement(Outlet),\n    )\n  }\n\n  return {\n    clientConfig,\n    dateFNSKey: req.i18n.dateFNSKey,\n    fallbackLang: config.i18n.fallbackLanguage,\n    isEmbedded,\n    isNavOpen: navPrefs?.open ?? true,\n    languageCode,\n    languageOptions,\n    locale: req.locale ?? undefined,\n    permissions,\n    providers,\n    theme,\n    translations: req.i18n.translations,\n    user: req.user,\n  }\n}\n"],"names":["getNavPrefs","RenderServerComponent","getClientConfig","getRequestEmbed","getRequestTheme","Outlet","applyLocaleFiltering","createElement","initReq","getLayoutData","configPromise","importMap","cookies","headers","languageCode","permissions","req","payload","config","theme","isEmbedded","languageOptions","Object","entries","i18n","supportedLanguages","reduce","acc","language","languageConfig","keys","includes","push","label","translations","general","thisLanguage","value","navPrefs","clientConfig","user","providerPaths","admin","components","providers","undefined","Array","isArray","length","serverProps","params","searchParams","server","reduceRight","children","provider","clientProps","Component","dateFNSKey","fallbackLang","fallbackLanguage","isNavOpen","open","locale"],"mappings":"AAYA,SAASA,WAAW,QAAQ,0CAAyC;AACrE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,MAAM,QAAQ,yBAAwB;AAC/C,SAASC,oBAAoB,QAAQ,iBAAgB;AACrD,SAASC,aAAa,QAAQ,QAAO;AAErC,SAASC,OAAO,QAAQ,oCAAmC;AA6B3D;;;CAGC,GACD,OAAO,eAAeC,cAAc,EAClCC,aAAa,EACbC,SAAS,EACS;IAClB,MAAM,EACJC,OAAO,EACPC,OAAO,EACPC,YAAY,EACZC,WAAW,EACXC,GAAG,EACHA,KAAK,EACHC,SAAS,EAAEC,MAAM,EAAE,EACpB,EACF,GAAG,MAAMV,QAAQ;QAAEE;QAAeC;IAAU;IAE7C,MAAMQ,QAAQf,gBAAgB;QAAEc;QAAQN;QAASC;IAAQ;IACzD,MAAMO,aAAajB,gBAAgB;QAAEe;QAAQN;IAAQ;IAErD,MAAMS,kBAAmCC,OAAOC,OAAO,CACrDL,OAAOM,IAAI,CAACC,kBAAkB,IAAI,CAAC,GACnCC,MAAM,CAAC,CAACC,KAAK,CAACC,UAAUC,eAAe;QACvC,IAAIP,OAAOQ,IAAI,CAACZ,OAAOM,IAAI,CAACC,kBAAkB,EAAEM,QAAQ,CAACH,WAAW;YAClED,IAAIK,IAAI,CAAC;gBACPC,OAAOJ,eAAeK,YAAY,CAACC,OAAO,CAACC,YAAY;gBACvDC,OAAOT;YACT;QACF;QACA,OAAOD;IACT,GAAG,EAAE;IAEL,MAAMW,WAAW,MAAMtC,YAAYgB;IAEnC,MAAMuB,eAAerC,gBAAgB;QACnCgB;QACAM,MAAMR,IAAIQ,IAAI;QACdb;QACA6B,MAAMxB,IAAIwB,IAAI,IAAI;IACpB;IAEA,MAAMlC,qBAAqB;QAAEiC;QAAcrB;QAAQF;IAAI;IAEvD,6EAA6E;IAC7E,sEAAsE;IACtE,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAMyB,gBAAgBvB,OAAOwB,KAAK,EAAEC,YAAYC;IAChD,IAAIA,YAA6BC;IACjC,IAAIC,MAAMC,OAAO,CAACN,kBAAkBA,cAAcO,MAAM,GAAG,GAAG;QAC5D,MAAMC,cAA2B;YAC/BzB,MAAMR,IAAIQ,IAAI;YACd0B,QAAQ,CAAC;YACTjC,SAASD,IAAIC,OAAO;YACpBF;YACAoC,cAAc,CAAC;YACfC,QAAQpC,IAAIoC,MAAM;YAClBZ,MAAMxB,IAAIwB,IAAI,IAAIK;QACpB;QACA,6EAA6E;QAC7E,6EAA6E;QAC7E,8EAA8E;QAC9E,2EAA2E;QAC3E,8EAA8E;QAC9ED,YAAYH,cAAcY,WAAW,CACnC,CAACC,UAAUC,WACTtD,sBAAsB;gBACpBuD,aAAa;oBAAEF;gBAAS;gBACxBG,WAAWF;gBACX5C;gBACAsC;YACF,IACF1C,cAAcF;IAElB;IAEA,OAAO;QACLkC;QACAmB,YAAY1C,IAAIQ,IAAI,CAACkC,UAAU;QAC/BC,cAAczC,OAAOM,IAAI,CAACoC,gBAAgB;QAC1CxC;QACAyC,WAAWvB,UAAUwB,QAAQ;QAC7BhD;QACAO;QACA0C,QAAQ/C,IAAI+C,MAAM,IAAIlB;QACtB9B;QACA6B;QACAzB;QACAe,cAAclB,IAAIQ,IAAI,CAACU,YAAY;QACnCM,MAAMxB,IAAIwB,IAAI;IAChB;AACF"}

package/dist/layouts/Root/withPayloadRoot.d.ts

@@ -1,36 +1,8 @@
 import React from 'react';
-/**
- * Builds the blocking inline script that sets `data-theme`, `lang`, and `dir`
- * on `<html>` synchronously, before first paint, from Payload's theme and
- * language cookies. This is the no-flash equivalent of what `RootProvider`'s
- * `ThemeProvider` does in a post-hydration effect, hoisted into the SSR'd
- * document head so the admin panel never flashes light mode (or LTR for RTL
- * locales) on the first render. Mirrors `detectTheme` in
- * `@payloadcms/ui`'s `ThemeProvider`.
- */
-export declare function buildThemeInitScript(cookiePrefix?: string): string;
-/**
- * The no-flash theme bootstrap script for the default (`payload`) cookie
- * prefix. Inline this in a `<script dangerouslySetInnerHTML>` inside the
- * document `<head>` to set `data-theme`/`lang`/`dir` before first paint.
- */
-export declare const THEME_INIT_SCRIPT: string;
 export type PayloadAdminShellProps = {
     readonly children: React.ReactNode;
-    /**
-     * The `config.cookiePrefix` used to read the theme/language cookies in the
-     * no-flash bootstrap script. Defaults to `'payload'`.
-     */
-    readonly cookiePrefix?: string;
 };
-/**
- * The `<html>` document shell for Payload admin routes — the TanStack Start
- * equivalent of `@payloadcms/next`'s root layout `<html>`. Owns the no-flash
- * theme script, the `@layer` ordering style, `@payloadcms/ui` styles,
- * `<HeadContent />`, and `<Scripts />`. Render `RootProvider` (and the rest of
- * the admin tree) as `children`.
- */
-export declare function PayloadAdminShell({ children, cookiePrefix }: PayloadAdminShellProps): React.JSX.Element;
+export declare function PayloadAdminShell({ children }: PayloadAdminShellProps): React.JSX.Element;
 export type WithPayloadRootOptions = {
     /**
      * Path prefix that mounts the Payload admin panel (`config.routes.admin`).
@@ -38,11 +10,6 @@ export type WithPayloadRootOptions = {
      * renders your own shell. Defaults to `'/admin'`.
      */
     adminRoute?: string;
-    /**
-     * The `config.cookiePrefix` used by the no-flash theme bootstrap script.
-     * Defaults to `'payload'`.
-     */
-    cookiePrefix?: string;
 };
 /**
  * Wraps your application's root document shell so Payload owns its own

package/dist/layouts/Root/withPayloadRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPayloadRoot.d.ts","sourceRoot":"","sources":["../../../src/layouts/Root/withPayloadRoot.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,GAAE,MAAkB,GAAG,MAAM,CAG7E;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAA+B,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,sBAAsB,qBAmBnF;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,EAC7D,OAAO,GAAE,sBAA2B,IAIH,cAAc;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,uBAc7E"}
+{"version":3,"file":"withPayloadRoot.d.ts","sourceRoot":"","sources":["../../../src/layouts/Root/withPayloadRoot.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACnC,CAAA;AAaD,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,qBAkDrE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,EAC7D,OAAO,GAAE,sBAA2B,kBAIW;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,uBAc7E"}

package/dist/layouts/Root/withPayloadRoot.js

@@ -1,46 +1,61 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { rtlLanguages } from '@payloadcms/translations';
+import { getLanguageDir } from '@payloadcms/ui/utilities/getLanguageDir';
 import { HeadContent, Scripts, useRouterState } from '@tanstack/react-router';
 import React from 'react';
-/**
- * Builds the blocking inline script that sets `data-theme`, `lang`, and `dir`
- * on `<html>` synchronously, before first paint, from Payload's theme and
- * language cookies. This is the no-flash equivalent of what `RootProvider`'s
- * `ThemeProvider` does in a post-hydration effect, hoisted into the SSR'd
- * document head so the admin panel never flashes light mode (or LTR for RTL
- * locales) on the first render. Mirrors `detectTheme` in
- * `@payloadcms/ui`'s `ThemeProvider`.
- */ export function buildThemeInitScript(cookiePrefix = 'payload') {
-    const rtl = JSON.stringify(rtlLanguages);
-    return `(function(){try{var d=document.documentElement;var c=document.cookie.split('; ');function r(n){var row=c.find(function(x){return x.indexOf(n+'=')===0});return row?row.split('=')[1]:null}var t=r('${cookiePrefix}-theme');if(t!=='light'&&t!=='dark'){t=window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light'}d.setAttribute('data-theme',t);var l=r('${cookiePrefix}-lng');if(l){d.setAttribute('lang',l);d.setAttribute('dir',${rtl}.indexOf(l)!==-1?'rtl':'ltr')}}catch(e){}})()`;
-}
-/**
- * The no-flash theme bootstrap script for the default (`payload`) cookie
- * prefix. Inline this in a `<script dangerouslySetInnerHTML>` inside the
- * document `<head>` to set `data-theme`/`lang`/`dir` before first paint.
- */ export const THEME_INIT_SCRIPT = buildThemeInitScript();
 /**
  * The `<html>` document shell for Payload admin routes — the TanStack Start
- * equivalent of `@payloadcms/next`'s root layout `<html>`. Owns the no-flash
- * theme script, the `@layer` ordering style, `@payloadcms/ui` styles,
- * `<HeadContent />`, and `<Scripts />`. Render `RootProvider` (and the rest of
- * the admin tree) as `children`.
- */ export function PayloadAdminShell({ children, cookiePrefix }) {
-    const themeInitScript = cookiePrefix ? buildThemeInitScript(cookiePrefix) : THEME_INIT_SCRIPT;
-    return(// `lang`/`dir` are set on `<html>` by `themeInitScript` before first paint
-    // from the `*-lng` cookie, so a static `lang` here would be incorrect.
-    // eslint-disable-next-line jsx-a11y/html-has-lang -- set dynamically by the inline bootstrap script
+ * equivalent of `@payloadcms/next`'s root layout `<html>`. Sets
+ * `data-theme`/`lang`/`dir` on `<html>` from the server-computed layout data
+ * (`getLayoutData`, exposed on the `/_payload` route loader), so the admin
+ * panel renders themed with the correct text direction on the first paint with no
+ * client bootstrap script — the same server-side path Next's `RootLayout`
+ * uses, sharing `getRequestTheme`/`getLanguageDir` from `@payloadcms/ui`.
+ */ const NO_LAYOUT_DATA = '|';
+export function PayloadAdminShell({ children }) {
+    // `select` has to return a primitive. `useRouterState` compares its result by reference, so
+    // returning an object literal yields a fresh value on every router state change, re-rendering
+    // `<html>` each time. On a production build that desynchronises `<html>` from the
+    // server-rendered markup during hydration, which React reports as error #418 and recovers from
+    // by discarding and regenerating the tree.
+    const encoded = useRouterState({
+        select: (state)=>{
+            for (const match of state.matches){
+                const data = match.loaderData;
+                if (data?.theme && data?.languageCode) {
+                    return `${data.theme}|${data.languageCode}`;
+                }
+            }
+            return NO_LAYOUT_DATA;
+        }
+    });
+    const htmlProps = React.useMemo(()=>{
+        const [theme, languageCode] = encoded.split('|');
+        // No layout data yet (fresh session before the loader resolves): default
+        // to `ltr` so the `[dir='ltr']`-scoped admin layout rules (e.g. the
+        // document sidebar divider) still match, matching Next's `ltr` default.
+        if (!theme || !languageCode) {
+            return {
+                dir: 'ltr'
+            };
+        }
+        return {
+            'data-theme': theme,
+            dir: getLanguageDir({
+                languageCode
+            }),
+            lang: languageCode
+        };
+    }, [
+        encoded
+    ]);
+    return(// eslint-disable-next-line jsx-a11y/html-has-lang -- `lang` is set from server-computed layout data when available
     /*#__PURE__*/ _jsxs("html", {
+        ...htmlProps,
         suppressHydrationWarning: true,
         children: [
             /*#__PURE__*/ _jsxs("head", {
                 children: [
-                    /*#__PURE__*/ _jsx("script", {
-                        dangerouslySetInnerHTML: {
-                            __html: themeInitScript
-                        }
-                    }),
                     /*#__PURE__*/ _jsx("style", {
                         children: `@layer payload-default, payload;`
                     }),
@@ -69,7 +84,7 @@ import React from 'react';
  * })
  * ```
  */ export function withPayloadRoot(RootShell, options = {}) {
-    const { adminRoute = '/admin', cookiePrefix } = options;
+    const { adminRoute = '/admin' } = options;
     return function PayloadRootShell({ children }) {
         const isAdminRoute = useRouterState({
             select: (s)=>{
@@ -79,7 +94,6 @@ import React from 'react';
         });
         if (isAdminRoute) {
             return /*#__PURE__*/ _jsx(PayloadAdminShell, {
-                cookiePrefix: cookiePrefix,
                 children: children
             });
         }

package/dist/layouts/Root/withPayloadRoot.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/layouts/Root/withPayloadRoot.tsx"],"sourcesContent":["'use client'\nimport { rtlLanguages } from '@payloadcms/translations'\nimport { HeadContent, Scripts, useRouterState } from '@tanstack/react-router'\nimport React from 'react'\n\n/**\n * Builds the blocking inline script that sets `data-theme`, `lang`, and `dir`\n * on `<html>` synchronously, before first paint, from Payload's theme and\n * language cookies. This is the no-flash equivalent of what `RootProvider`'s\n * `ThemeProvider` does in a post-hydration effect, hoisted into the SSR'd\n * document head so the admin panel never flashes light mode (or LTR for RTL\n * locales) on the first render. Mirrors `detectTheme` in\n * `@payloadcms/ui`'s `ThemeProvider`.\n */\nexport function buildThemeInitScript(cookiePrefix: string = 'payload'): string {\n  const rtl = JSON.stringify(rtlLanguages)\n  return `(function(){try{var d=document.documentElement;var c=document.cookie.split('; ');function r(n){var row=c.find(function(x){return x.indexOf(n+'=')===0});return row?row.split('=')[1]:null}var t=r('${cookiePrefix}-theme');if(t!=='light'&&t!=='dark'){t=window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light'}d.setAttribute('data-theme',t);var l=r('${cookiePrefix}-lng');if(l){d.setAttribute('lang',l);d.setAttribute('dir',${rtl}.indexOf(l)!==-1?'rtl':'ltr')}}catch(e){}})()`\n}\n\n/**\n * The no-flash theme bootstrap script for the default (`payload`) cookie\n * prefix. Inline this in a `<script dangerouslySetInnerHTML>` inside the\n * document `<head>` to set `data-theme`/`lang`/`dir` before first paint.\n */\nexport const THEME_INIT_SCRIPT: string = buildThemeInitScript()\n\nexport type PayloadAdminShellProps = {\n  readonly children: React.ReactNode\n  /**\n   * The `config.cookiePrefix` used to read the theme/language cookies in the\n   * no-flash bootstrap script. Defaults to `'payload'`.\n   */\n  readonly cookiePrefix?: string\n}\n\n/**\n * The `<html>` document shell for Payload admin routes — the TanStack Start\n * equivalent of `@payloadcms/next`'s root layout `<html>`. Owns the no-flash\n * theme script, the `@layer` ordering style, `@payloadcms/ui` styles,\n * `<HeadContent />`, and `<Scripts />`. Render `RootProvider` (and the rest of\n * the admin tree) as `children`.\n */\nexport function PayloadAdminShell({ children, cookiePrefix }: PayloadAdminShellProps) {\n  const themeInitScript = cookiePrefix ? buildThemeInitScript(cookiePrefix) : THEME_INIT_SCRIPT\n\n  return (\n    // `lang`/`dir` are set on `<html>` by `themeInitScript` before first paint\n    // from the `*-lng` cookie, so a static `lang` here would be incorrect.\n    // eslint-disable-next-line jsx-a11y/html-has-lang -- set dynamically by the inline bootstrap script\n    <html suppressHydrationWarning>\n      <head>\n        <script dangerouslySetInnerHTML={{ __html: themeInitScript }} />\n        <style>{`@layer payload-default, payload;`}</style>\n        <HeadContent />\n      </head>\n      <body>\n        {children}\n        <Scripts />\n      </body>\n    </html>\n  )\n}\n\nexport type WithPayloadRootOptions = {\n  /**\n   * Path prefix that mounts the Payload admin panel (`config.routes.admin`).\n   * Routes under it render the Payload admin document shell; everything else\n   * renders your own shell. Defaults to `'/admin'`.\n   */\n  adminRoute?: string\n  /**\n   * The `config.cookiePrefix` used by the no-flash theme bootstrap script.\n   * Defaults to `'payload'`.\n   */\n  cookiePrefix?: string\n}\n\n/**\n * Wraps your application's root document shell so Payload owns its own\n * `<html>` chrome on admin routes while your shell renders everywhere else.\n *\n * Attach the result to the root route's `shellComponent`; it is the single\n * integration touch point — no root loader and no manual data threading:\n *\n * ```tsx\n * export const Route = createRootRoute({\n *   shellComponent: withPayloadRoot(MarketingRoot),\n * })\n * ```\n */\nexport function withPayloadRoot(\n  RootShell: React.ComponentType<{ children: React.ReactNode }>,\n  options: WithPayloadRootOptions = {},\n) {\n  const { adminRoute = '/admin', cookiePrefix } = options\n\n  return function PayloadRootShell({ children }: { children: React.ReactNode }) {\n    const isAdminRoute = useRouterState({\n      select: (s) => {\n        const { pathname } = s.location\n        return pathname === adminRoute || pathname.startsWith(`${adminRoute}/`)\n      },\n    })\n\n    if (isAdminRoute) {\n      return <PayloadAdminShell cookiePrefix={cookiePrefix}>{children}</PayloadAdminShell>\n    }\n\n    return <RootShell>{children}</RootShell>\n  }\n}\n"],"names":["rtlLanguages","HeadContent","Scripts","useRouterState","React","buildThemeInitScript","cookiePrefix","rtl","JSON","stringify","THEME_INIT_SCRIPT","PayloadAdminShell","children","themeInitScript","html","suppressHydrationWarning","head","script","dangerouslySetInnerHTML","__html","style","body","withPayloadRoot","RootShell","options","adminRoute","PayloadRootShell","isAdminRoute","select","s","pathname","location","startsWith"],"mappings":"AAAA;;AACA,SAASA,YAAY,QAAQ,2BAA0B;AACvD,SAASC,WAAW,EAAEC,OAAO,EAAEC,cAAc,QAAQ,yBAAwB;AAC7E,OAAOC,WAAW,QAAO;AAEzB;;;;;;;;CAQC,GACD,OAAO,SAASC,qBAAqBC,eAAuB,SAAS;IACnE,MAAMC,MAAMC,KAAKC,SAAS,CAACT;IAC3B,OAAO,CAAC,mMAAmM,EAAEM,aAAa,2KAA2K,EAAEA,aAAa,2DAA2D,EAAEC,IAAI,6CAA6C,CAAC;AACrgB;AAEA;;;;CAIC,GACD,OAAO,MAAMG,oBAA4BL,uBAAsB;AAW/D;;;;;;CAMC,GACD,OAAO,SAASM,kBAAkB,EAAEC,QAAQ,EAAEN,YAAY,EAA0B;IAClF,MAAMO,kBAAkBP,eAAeD,qBAAqBC,gBAAgBI;IAE5E,OACE,2EAA2E;IAC3E,uEAAuE;IACvE,oGAAoG;kBACpG,MAACI;QAAKC,wBAAwB;;0BAC5B,MAACC;;kCACC,KAACC;wBAAOC,yBAAyB;4BAAEC,QAAQN;wBAAgB;;kCAC3D,KAACO;kCAAO,CAAC,gCAAgC,CAAC;;kCAC1C,KAACnB;;;0BAEH,MAACoB;;oBACET;kCACD,KAACV;;;;;AAIT;AAgBA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASoB,gBACdC,SAA6D,EAC7DC,UAAkC,CAAC,CAAC;IAEpC,MAAM,EAAEC,aAAa,QAAQ,EAAEnB,YAAY,EAAE,GAAGkB;IAEhD,OAAO,SAASE,iBAAiB,EAAEd,QAAQ,EAAiC;QAC1E,MAAMe,eAAexB,eAAe;YAClCyB,QAAQ,CAACC;gBACP,MAAM,EAAEC,QAAQ,EAAE,GAAGD,EAAEE,QAAQ;gBAC/B,OAAOD,aAAaL,cAAcK,SAASE,UAAU,CAAC,GAAGP,WAAW,CAAC,CAAC;YACxE;QACF;QAEA,IAAIE,cAAc;YAChB,qBAAO,KAAChB;gBAAkBL,cAAcA;0BAAeM;;QACzD;QAEA,qBAAO,KAACW;sBAAWX;;IACrB;AACF"}
+{"version":3,"sources":["../../../src/layouts/Root/withPayloadRoot.tsx"],"sourcesContent":["'use client'\nimport type { Theme } from '@payloadcms/ui'\n\nimport { getLanguageDir } from '@payloadcms/ui/utilities/getLanguageDir'\nimport { HeadContent, Scripts, useRouterState } from '@tanstack/react-router'\nimport React from 'react'\n\ntype AdminHTMLProps = {\n  'data-theme'?: Theme\n  dir: 'ltr' | 'rtl'\n  lang?: string\n}\n\nexport type PayloadAdminShellProps = {\n  readonly children: React.ReactNode\n}\n\n/**\n * The `<html>` document shell for Payload admin routes — the TanStack Start\n * equivalent of `@payloadcms/next`'s root layout `<html>`. Sets\n * `data-theme`/`lang`/`dir` on `<html>` from the server-computed layout data\n * (`getLayoutData`, exposed on the `/_payload` route loader), so the admin\n * panel renders themed with the correct text direction on the first paint with no\n * client bootstrap script — the same server-side path Next's `RootLayout`\n * uses, sharing `getRequestTheme`/`getLanguageDir` from `@payloadcms/ui`.\n */\nconst NO_LAYOUT_DATA = '|'\n\nexport function PayloadAdminShell({ children }: PayloadAdminShellProps) {\n  // `select` has to return a primitive. `useRouterState` compares its result by reference, so\n  // returning an object literal yields a fresh value on every router state change, re-rendering\n  // `<html>` each time. On a production build that desynchronises `<html>` from the\n  // server-rendered markup during hydration, which React reports as error #418 and recovers from\n  // by discarding and regenerating the tree.\n  const encoded = useRouterState({\n    select: (state): string => {\n      for (const match of state.matches) {\n        const data = match.loaderData as { languageCode?: string; theme?: Theme } | undefined\n\n        if (data?.theme && data?.languageCode) {\n          return `${data.theme}|${data.languageCode}`\n        }\n      }\n\n      return NO_LAYOUT_DATA\n    },\n  })\n\n  const htmlProps = React.useMemo((): AdminHTMLProps => {\n    const [theme, languageCode] = encoded.split('|')\n\n    // No layout data yet (fresh session before the loader resolves): default\n    // to `ltr` so the `[dir='ltr']`-scoped admin layout rules (e.g. the\n    // document sidebar divider) still match, matching Next's `ltr` default.\n    if (!theme || !languageCode) {\n      return { dir: 'ltr' }\n    }\n\n    return {\n      'data-theme': theme as Theme,\n      dir: getLanguageDir({ languageCode }),\n      lang: languageCode,\n    }\n  }, [encoded])\n\n  return (\n    // eslint-disable-next-line jsx-a11y/html-has-lang -- `lang` is set from server-computed layout data when available\n    <html {...htmlProps} suppressHydrationWarning>\n      <head>\n        <style>{`@layer payload-default, payload;`}</style>\n        <HeadContent />\n      </head>\n      <body>\n        {children}\n        <Scripts />\n      </body>\n    </html>\n  )\n}\n\nexport type WithPayloadRootOptions = {\n  /**\n   * Path prefix that mounts the Payload admin panel (`config.routes.admin`).\n   * Routes under it render the Payload admin document shell; everything else\n   * renders your own shell. Defaults to `'/admin'`.\n   */\n  adminRoute?: string\n}\n\n/**\n * Wraps your application's root document shell so Payload owns its own\n * `<html>` chrome on admin routes while your shell renders everywhere else.\n *\n * Attach the result to the root route's `shellComponent`; it is the single\n * integration touch point — no root loader and no manual data threading:\n *\n * ```tsx\n * export const Route = createRootRoute({\n *   shellComponent: withPayloadRoot(MarketingRoot),\n * })\n * ```\n */\nexport function withPayloadRoot(\n  RootShell: React.ComponentType<{ children: React.ReactNode }>,\n  options: WithPayloadRootOptions = {},\n) {\n  const { adminRoute = '/admin' } = options\n\n  return function PayloadRootShell({ children }: { children: React.ReactNode }) {\n    const isAdminRoute = useRouterState({\n      select: (s) => {\n        const { pathname } = s.location\n        return pathname === adminRoute || pathname.startsWith(`${adminRoute}/`)\n      },\n    })\n\n    if (isAdminRoute) {\n      return <PayloadAdminShell>{children}</PayloadAdminShell>\n    }\n\n    return <RootShell>{children}</RootShell>\n  }\n}\n"],"names":["getLanguageDir","HeadContent","Scripts","useRouterState","React","NO_LAYOUT_DATA","PayloadAdminShell","children","encoded","select","state","match","matches","data","loaderData","theme","languageCode","htmlProps","useMemo","split","dir","lang","html","suppressHydrationWarning","head","style","body","withPayloadRoot","RootShell","options","adminRoute","PayloadRootShell","isAdminRoute","s","pathname","location","startsWith"],"mappings":"AAAA;;AAGA,SAASA,cAAc,QAAQ,0CAAyC;AACxE,SAASC,WAAW,EAAEC,OAAO,EAAEC,cAAc,QAAQ,yBAAwB;AAC7E,OAAOC,WAAW,QAAO;AAYzB;;;;;;;;CAQC,GACD,MAAMC,iBAAiB;AAEvB,OAAO,SAASC,kBAAkB,EAAEC,QAAQ,EAA0B;IACpE,4FAA4F;IAC5F,8FAA8F;IAC9F,kFAAkF;IAClF,+FAA+F;IAC/F,2CAA2C;IAC3C,MAAMC,UAAUL,eAAe;QAC7BM,QAAQ,CAACC;YACP,KAAK,MAAMC,SAASD,MAAME,OAAO,CAAE;gBACjC,MAAMC,OAAOF,MAAMG,UAAU;gBAE7B,IAAID,MAAME,SAASF,MAAMG,cAAc;oBACrC,OAAO,GAAGH,KAAKE,KAAK,CAAC,CAAC,EAAEF,KAAKG,YAAY,EAAE;gBAC7C;YACF;YAEA,OAAOX;QACT;IACF;IAEA,MAAMY,YAAYb,MAAMc,OAAO,CAAC;QAC9B,MAAM,CAACH,OAAOC,aAAa,GAAGR,QAAQW,KAAK,CAAC;QAE5C,yEAAyE;QACzE,oEAAoE;QACpE,wEAAwE;QACxE,IAAI,CAACJ,SAAS,CAACC,cAAc;YAC3B,OAAO;gBAAEI,KAAK;YAAM;QACtB;QAEA,OAAO;YACL,cAAcL;YACdK,KAAKpB,eAAe;gBAAEgB;YAAa;YACnCK,MAAML;QACR;IACF,GAAG;QAACR;KAAQ;IAEZ,OACE,mHAAmH;kBACnH,MAACc;QAAM,GAAGL,SAAS;QAAEM,wBAAwB;;0BAC3C,MAACC;;kCACC,KAACC;kCAAO,CAAC,gCAAgC,CAAC;;kCAC1C,KAACxB;;;0BAEH,MAACyB;;oBACEnB;kCACD,KAACL;;;;;AAIT;AAWA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASyB,gBACdC,SAA6D,EAC7DC,UAAkC,CAAC,CAAC;IAEpC,MAAM,EAAEC,aAAa,QAAQ,EAAE,GAAGD;IAElC,OAAO,SAASE,iBAAiB,EAAExB,QAAQ,EAAiC;QAC1E,MAAMyB,eAAe7B,eAAe;YAClCM,QAAQ,CAACwB;gBACP,MAAM,EAAEC,QAAQ,EAAE,GAAGD,EAAEE,QAAQ;gBAC/B,OAAOD,aAAaJ,cAAcI,SAASE,UAAU,CAAC,GAAGN,WAAW,CAAC,CAAC;YACxE;QACF;QAEA,IAAIE,cAAc;YAChB,qBAAO,KAAC1B;0BAAmBC;;QAC7B;QAEA,qBAAO,KAACqB;sBAAWrB;;IACrB;AACF"}

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,17 +49,20 @@ 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>;
     }) => {
         searchKey: string;
     };
-    notFoundComponent: typeof AdminNotFound;
     validateSearch: (search: Record<string, unknown>) => Record<string, unknown>;
+    notFoundComponent: typeof AdminNotFound;
 };
 /**
  * Route options for the admin index route (`/_payload/admin/`). Same loader as the
@@ -91,9 +94,13 @@ export declare function payloadAdminIndexRoute({ load }: {
             title: string;
         })[];
     };
-    loader: ({ location }: {
-        location: any;
-    }) => Promise<any>;
+    loader: {
+        handler: ({ location, params }: {
+            location: any;
+            params: 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,gCAKjB;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;AA8CD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;;2BAlC3C;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;QAOzC,OAAO,yBAA+B;YAAE,QAAQ,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,GAAG,CAAA;SAAE;QAYpE,eAAe;;6BAGQ;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;QAC1D,SAAS;;6BAEc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAkBjD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;;2BAjD3C;QAAE,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;QAOzC,OAAO,yBAA+B;YAAE,QAAQ,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,GAAG,CAAA;SAAE;QAYpE,eAAe;;6BAGQ;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;QAC1D,SAAS;;6BAEc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA8BjD"}

package/dist/routes/adminRoutes.js

@@ -21,17 +21,14 @@ const runLoader = async (load, splat, searchStr)=>{
     return data;
 };
 function AdminPage() {
-    // RSC Flight payload — render directly. Key by the loader-derived `routeKey`
-    // (not `location.pathname`, which updates before `useLoaderData` during a
-    // transition and would remount with the previous payload) so navigating to a
-    // different admin page remounts the view, mirroring Next route-segment
-    // semantics. Search params are excluded so search-only changes reconcile in place.
+    // Note: React key intentionally omitted here so the persistent template (nav, header) doesn't remount and flash on navigation.
+    // The per-route view key is attached server-side to the view subtree instead, via `renderRoot`'s `key` in `loadAdminPage`.
     const data = useLoaderData({
         strict: false
     });
     return /*#__PURE__*/ _jsx(Fragment, {
         children: data?.rscPayload
-    }, data?.routeKey);
+    });
 }
 function AdminNotFound(props) {
     const rscPayload = props?.data?.rscPayload;
@@ -42,56 +39,60 @@ function AdminNotFound(props) {
         children: rscPayload
     }, props?.data?.routeKey);
 }
-/**
- * Route options for the admin splat route (`/_payload/admin/$`). Renders Payload's
- * server-built NotFound page (shipped via the `notFound()` error's
- * `data.rscPayload`) for unknown/access-denied routes, falling back to the bare
- * client view.
- */ export function payloadAdminSplatRoute({ load }) {
-    return {
+const adminRouteOptions = ({ forwardNotFoundPayload, load, resolveSplat })=>({
         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, resolveSplat(params), location.searchStr);
+                if (data?._notFound) {
+                    // eslint-disable-next-line @typescript-eslint/only-throw-error -- TanStack Router requires throwing notFound objects
+                    throw notFound(forwardNotFoundPayload ? {
+                        data: {
+                            routeKey: data.routeKey,
+                            rscPayload: data.rscPayload
+                        }
+                    } : undefined);
+                }
+                return data;
+            },
+            staleReloadMode: 'blocking'
         },
+        // Surface query params in `loaderDeps` so `?locale=es` re-runs the loader.
         loaderDeps: ({ search })=>({
                 searchKey: JSON.stringify(search)
             }),
-        notFoundComponent: AdminNotFound,
         validateSearch: (search)=>search
+    });
+/**
+ * Route options for the admin splat route (`/_payload/admin/$`). Renders Payload's
+ * server-built NotFound page (shipped via the `notFound()` error's
+ * `data.rscPayload`) for unknown/access-denied routes, falling back to the bare
+ * client view.
+ */ export function payloadAdminSplatRoute({ load }) {
+    return {
+        ...adminRouteOptions({
+            forwardNotFoundPayload: true,
+            load,
+            resolveSplat: (params)=>params._splat ?? ''
+        }),
+        notFoundComponent: AdminNotFound
     };
 }
 /**
  * Route options for the admin index route (`/_payload/admin/`). Same loader as the
  * splat route but throws a bare `notFound()` (no rscPayload) on miss.
  */ export function payloadAdminIndexRoute({ load }) {
-    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;
-        },
-        loaderDeps: ({ search })=>({
-                searchKey: JSON.stringify(search)
-            }),
-        validateSearch: (search)=>search
-    };
+    return adminRouteOptions({
+        forwardNotFoundPayload: false,
+        load,
+        resolveSplat: ()=>''
+    });
 }
 
 //# sourceMappingURL=adminRoutes.js.map