@payloadcms/ui 4.0.0-internal.e55ccef → 4.0.0-internal.e7d4ebc

package/dist/utilities/handleServerFunctions.d.ts

@@ -1,11 +1,35 @@
-import type { ServerAdapter, ServerFunctionHandler } from 'payload';
+import type { ImportMap, InitReqResult, SanitizedConfig, ServerFunction, ServerFunctionHandler } from 'payload';
+type InitReq = (args: {
+    configPromise: Promise<SanitizedConfig> | SanitizedConfig;
+    importMap: ImportMap;
+}) => Promise<InitReqResult>;
+type CreateServerFunctionHandlerArgs = {
+    /**
+     * Framework-specific request initialization. The adapter closes over its own
+     * `ServerAdapter` / request source (Next.js: `initReq` + `nextServerAdapter`;
+     * TanStack Start: its `getRequest()`-based `initReq`).
+     */
+    initReq: InitReq;
+    /**
+     * Additional handlers registered alongside `sharedServerFunctions`. Reserved
+     * for adapter-specific functions; today both adapters run the shared set only.
+     */
+    serverFunctions?: Record<string, ServerFunction<any, any>>;
+    /**
+     * Post-processes each handler's return value before it goes over the wire.
+     * The TanStack Start adapter passes `serializeForRsc` to convert React
+     * elements into RSC handles; Next.js ships them natively and omits this.
+     */
+    transformResult?: (result: unknown) => Promise<unknown> | unknown;
+};
 /**
- * Factory for the framework-agnostic `handleServerFunctions` entry point. The
- * caller (a framework adapter, e.g. `@payloadcms/next`) supplies the
- * `ServerAdapter` once, and the returned handler can be wired directly into
- * the framework's server-action dispatcher.
+ * Factory for the framework-agnostic `handleServerFunctions` entry point.
+ *
+ * All adapters dispatch from the shared registry (`sharedServerFunctions`) and
+ * differ only in the two injected hooks below — `initReq` and `transformResult`
+ * — so there is a single dispatch implementation and the handler sets cannot
+ * drift between frameworks.
  */
-export declare const createServerFunctionHandler: ({ serverAdapter, }: {
-    serverAdapter: ServerAdapter;
-}) => ServerFunctionHandler;
+export declare const createServerFunctionHandler: ({ initReq, serverFunctions, transformResult, }: CreateServerFunctionHandlerArgs) => ServerFunctionHandler;
+export {};
 //# sourceMappingURL=handleServerFunctions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handleServerFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/handleServerFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAEb,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAgChB;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,uBAErC;IACD,aAAa,EAAE,aAAa,CAAA;CAC7B,KAAG,qBAkCH,CAAA"}
+{"version":3,"file":"handleServerFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/handleServerFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAIhB,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE;IACpB,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;CACrB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;AAE5B,KAAK,+BAA+B,GAAG;IACrC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;IAC1D;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CAClE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,mDAIrC,+BAA+B,KAAG,qBAmCpC,CAAA"}

package/dist/utilities/handleServerFunctions.js

@@ -1,40 +1,21 @@
-import { renderTabHandler } from '../elements/Nav/SidebarTabs/renderTabServerFn.js';
-import { _internal_renderFieldHandler } from '../forms/fieldSchemasToFormState/serverFunctions/renderFieldServerFn.js';
-import { getDefaultLayoutHandler, renderWidgetHandler } from '../views/Dashboard/serverFunctions.js';
-import { renderDocumentHandler } from '../views/Document/handleServerFunction.js';
-import { renderDocumentSlotsHandler } from '../views/Document/renderDocumentSlots.js';
-import { renderListHandler } from '../views/List/handleServerFunction.js';
-import { buildFormStateHandler } from './buildFormState.js';
-import { buildTableStateHandler } from './buildTableState.js';
-import { copyDataFromLocaleHandler } from './copyDataFromLocale.js';
-import { initReq } from './initReq.js';
-import { schedulePublishHandler } from './schedulePublishHandler.js';
-import { slugifyHandler } from './slugify.js';
-import { switchLanguageHandler } from './switchLanguageHandler.js';
-const baseServerFunctions = {
-  'copy-data-from-locale': copyDataFromLocaleHandler,
-  'form-state': buildFormStateHandler,
-  'get-default-layout': getDefaultLayoutHandler,
-  'render-document': renderDocumentHandler,
-  'render-document-slots': renderDocumentSlotsHandler,
-  'render-field': _internal_renderFieldHandler,
-  'render-list': renderListHandler,
-  'render-tab': renderTabHandler,
-  'render-widget': renderWidgetHandler,
-  'schedule-publish': schedulePublishHandler,
-  slugify: slugifyHandler,
-  'switch-language': switchLanguageHandler,
-  'table-state': buildTableStateHandler
-};
+import { sharedServerFunctions } from './serverFunctionRegistry.js';
 /**
- * Factory for the framework-agnostic `handleServerFunctions` entry point. The
- * caller (a framework adapter, e.g. `@payloadcms/next`) supplies the
- * `ServerAdapter` once, and the returned handler can be wired directly into
- * the framework's server-action dispatcher.
+ * Factory for the framework-agnostic `handleServerFunctions` entry point.
+ *
+ * All adapters dispatch from the shared registry (`sharedServerFunctions`) and
+ * differ only in the two injected hooks below — `initReq` and `transformResult`
+ * — so there is a single dispatch implementation and the handler sets cannot
+ * drift between frameworks.
  */
 export const createServerFunctionHandler = ({
-  serverAdapter
+  initReq,
+  serverFunctions,
+  transformResult
 }) => {
+  const baseServerFunctions = serverFunctions ? {
+    ...sharedServerFunctions,
+    ...serverFunctions
+  } : sharedServerFunctions;
   return async args => {
     const {
       name: fnKey,
@@ -50,9 +31,7 @@ export const createServerFunctionHandler = ({
       req
     } = await initReq({
       configPromise,
-      importMap,
-      key: 'RootLayout',
-      serverAdapter
+      importMap
     });
     const augmentedArgs = {
       ...fnArgs,
@@ -66,7 +45,8 @@ export const createServerFunctionHandler = ({
     if (!fn) {
       throw new Error(`Unknown Server Function: ${fnKey}`);
     }
-    return fn(augmentedArgs);
+    const result = await fn(augmentedArgs);
+    return transformResult ? await transformResult(result) : result;
   };
 };
 //# sourceMappingURL=handleServerFunctions.js.map

package/dist/utilities/handleServerFunctions.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleServerFunctions.js","names":["renderTabHandler","_internal_renderFieldHandler","getDefaultLayoutHandler","renderWidgetHandler","renderDocumentHandler","renderDocumentSlotsHandler","renderListHandler","buildFormStateHandler","buildTableStateHandler","copyDataFromLocaleHandler","initReq","schedulePublishHandler","slugifyHandler","switchLanguageHandler","baseServerFunctions","slugify","createServerFunctionHandler","serverAdapter","args","name","fnKey","fnArgs","config","configPromise","importMap","serverFunctions","extraServerFunctions","cookies","locale","permissions","req","key","augmentedArgs","fn","Error"],"sources":["../../src/utilities/handleServerFunctions.ts"],"sourcesContent":["import type {\n  DefaultServerFunctionArgs,\n  ServerAdapter,\n  ServerFunction,\n  ServerFunctionHandler,\n} from 'payload'\n\nimport { renderTabHandler } from '../elements/Nav/SidebarTabs/renderTabServerFn.js'\nimport { _internal_renderFieldHandler } from '../forms/fieldSchemasToFormState/serverFunctions/renderFieldServerFn.js'\nimport { getDefaultLayoutHandler, renderWidgetHandler } from '../views/Dashboard/serverFunctions.js'\nimport { renderDocumentHandler } from '../views/Document/handleServerFunction.js'\nimport { renderDocumentSlotsHandler } from '../views/Document/renderDocumentSlots.js'\nimport { renderListHandler } from '../views/List/handleServerFunction.js'\nimport { buildFormStateHandler } from './buildFormState.js'\nimport { buildTableStateHandler } from './buildTableState.js'\nimport { copyDataFromLocaleHandler } from './copyDataFromLocale.js'\nimport { initReq } from './initReq.js'\nimport { schedulePublishHandler } from './schedulePublishHandler.js'\nimport { slugifyHandler } from './slugify.js'\nimport { switchLanguageHandler } from './switchLanguageHandler.js'\n\nconst baseServerFunctions: Record<string, ServerFunction<any, any>> = {\n  'copy-data-from-locale': copyDataFromLocaleHandler,\n  'form-state': buildFormStateHandler,\n  'get-default-layout': getDefaultLayoutHandler,\n  'render-document': renderDocumentHandler,\n  'render-document-slots': renderDocumentSlotsHandler,\n  'render-field': _internal_renderFieldHandler,\n  'render-list': renderListHandler,\n  'render-tab': renderTabHandler,\n  'render-widget': renderWidgetHandler,\n  'schedule-publish': schedulePublishHandler,\n  slugify: slugifyHandler,\n  'switch-language': switchLanguageHandler,\n  'table-state': buildTableStateHandler,\n}\n\n/**\n * Factory for the framework-agnostic `handleServerFunctions` entry point. The\n * caller (a framework adapter, e.g. `@payloadcms/next`) supplies the\n * `ServerAdapter` once, and the returned handler can be wired directly into\n * the framework's server-action dispatcher.\n */\nexport const createServerFunctionHandler = ({\n  serverAdapter,\n}: {\n  serverAdapter: ServerAdapter\n}): ServerFunctionHandler => {\n  return async (args) => {\n    const {\n      name: fnKey,\n      args: fnArgs,\n      config: configPromise,\n      importMap,\n      serverFunctions: extraServerFunctions,\n    } = args\n\n    const { cookies, locale, permissions, req } = await initReq({\n      configPromise,\n      importMap,\n      key: 'RootLayout',\n      serverAdapter,\n    })\n\n    const augmentedArgs: DefaultServerFunctionArgs = {\n      ...fnArgs,\n      cookies,\n      importMap,\n      locale,\n      permissions,\n      req,\n    }\n\n    const fn = extraServerFunctions?.[fnKey] || baseServerFunctions[fnKey]\n\n    if (!fn) {\n      throw new Error(`Unknown Server Function: ${fnKey}`)\n    }\n\n    return fn(augmentedArgs)\n  }\n}\n"],"mappings":"AAOA,SAASA,gBAAgB,QAAQ;AACjC,SAASC,4BAA4B,QAAQ;AAC7C,SAASC,uBAAuB,EAAEC,mBAAmB,QAAQ;AAC7D,SAASC,qBAAqB,QAAQ;AACtC,SAASC,0BAA0B,QAAQ;AAC3C,SAASC,iBAAiB,QAAQ;AAClC,SAASC,qBAAqB,QAAQ;AACtC,SAASC,sBAAsB,QAAQ;AACvC,SAASC,yBAAyB,QAAQ;AAC1C,SAASC,OAAO,QAAQ;AACxB,SAASC,sBAAsB,QAAQ;AACvC,SAASC,cAAc,QAAQ;AAC/B,SAASC,qBAAqB,QAAQ;AAEtC,MAAMC,mBAAA,GAAgE;EACpE,yBAAyBL,yBAAA;EACzB,cAAcF,qBAAA;EACd,sBAAsBL,uBAAA;EACtB,mBAAmBE,qBAAA;EACnB,yBAAyBC,0BAAA;EACzB,gBAAgBJ,4BAAA;EAChB,eAAeK,iBAAA;EACf,cAAcN,gBAAA;EACd,iBAAiBG,mBAAA;EACjB,oBAAoBQ,sBAAA;EACpBI,OAAA,EAASH,cAAA;EACT,mBAAmBC,qBAAA;EACnB,eAAeL;AACjB;AAEA;;;;;;AAMA,OAAO,MAAMQ,2BAAA,GAA8BA,CAAC;EAC1CC;AAAa,CAGd;EACC,OAAO,MAAOC,IAAA;IACZ,MAAM;MACJC,IAAA,EAAMC,KAAK;MACXF,IAAA,EAAMG,MAAM;MACZC,MAAA,EAAQC,aAAa;MACrBC,SAAS;MACTC,eAAA,EAAiBC;IAAoB,CACtC,GAAGR,IAAA;IAEJ,MAAM;MAAES,OAAO;MAAEC,MAAM;MAAEC,WAAW;MAAEC;IAAG,CAAE,GAAG,MAAMpB,OAAA,CAAQ;MAC1Da,aAAA;MACAC,SAAA;MACAO,GAAA,EAAK;MACLd;IACF;IAEA,MAAMe,aAAA,GAA2C;MAC/C,GAAGX,MAAM;MACTM,OAAA;MACAH,SAAA;MACAI,MAAA;MACAC,WAAA;MACAC;IACF;IAEA,MAAMG,EAAA,GAAKP,oBAAA,GAAuBN,KAAA,CAAM,IAAIN,mBAAmB,CAACM,KAAA,CAAM;IAEtE,IAAI,CAACa,EAAA,EAAI;MACP,MAAM,IAAIC,KAAA,CAAM,4BAA4Bd,KAAA,EAAO;IACrD;IAEA,OAAOa,EAAA,CAAGD,aAAA;EACZ;AACF","ignoreList":[]}
+{"version":3,"file":"handleServerFunctions.js","names":["sharedServerFunctions","createServerFunctionHandler","initReq","serverFunctions","transformResult","baseServerFunctions","args","name","fnKey","fnArgs","config","configPromise","importMap","extraServerFunctions","cookies","locale","permissions","req","augmentedArgs","fn","Error","result"],"sources":["../../src/utilities/handleServerFunctions.ts"],"sourcesContent":["import type {\n  DefaultServerFunctionArgs,\n  ImportMap,\n  InitReqResult,\n  SanitizedConfig,\n  ServerFunction,\n  ServerFunctionHandler,\n} from 'payload'\n\nimport { sharedServerFunctions } from './serverFunctionRegistry.js'\n\ntype InitReq = (args: {\n  configPromise: Promise<SanitizedConfig> | SanitizedConfig\n  importMap: ImportMap\n}) => Promise<InitReqResult>\n\ntype CreateServerFunctionHandlerArgs = {\n  /**\n   * Framework-specific request initialization. The adapter closes over its own\n   * `ServerAdapter` / request source (Next.js: `initReq` + `nextServerAdapter`;\n   * TanStack Start: its `getRequest()`-based `initReq`).\n   */\n  initReq: InitReq\n  /**\n   * Additional handlers registered alongside `sharedServerFunctions`. Reserved\n   * for adapter-specific functions; today both adapters run the shared set only.\n   */\n  serverFunctions?: Record<string, ServerFunction<any, any>>\n  /**\n   * Post-processes each handler's return value before it goes over the wire.\n   * The TanStack Start adapter passes `serializeForRsc` to convert React\n   * elements into RSC handles; Next.js ships them natively and omits this.\n   */\n  transformResult?: (result: unknown) => Promise<unknown> | unknown\n}\n\n/**\n * Factory for the framework-agnostic `handleServerFunctions` entry point.\n *\n * All adapters dispatch from the shared registry (`sharedServerFunctions`) and\n * differ only in the two injected hooks below — `initReq` and `transformResult`\n * — so there is a single dispatch implementation and the handler sets cannot\n * drift between frameworks.\n */\nexport const createServerFunctionHandler = ({\n  initReq,\n  serverFunctions,\n  transformResult,\n}: CreateServerFunctionHandlerArgs): ServerFunctionHandler => {\n  const baseServerFunctions: Record<string, ServerFunction<any, any>> = serverFunctions\n    ? { ...sharedServerFunctions, ...serverFunctions }\n    : sharedServerFunctions\n\n  return async (args) => {\n    const {\n      name: fnKey,\n      args: fnArgs,\n      config: configPromise,\n      importMap,\n      serverFunctions: extraServerFunctions,\n    } = args\n\n    const { cookies, locale, permissions, req } = await initReq({ configPromise, importMap })\n\n    const augmentedArgs: DefaultServerFunctionArgs = {\n      ...fnArgs,\n      cookies,\n      importMap,\n      locale,\n      permissions,\n      req,\n    }\n\n    const fn = extraServerFunctions?.[fnKey] || baseServerFunctions[fnKey]\n\n    if (!fn) {\n      throw new Error(`Unknown Server Function: ${fnKey}`)\n    }\n\n    const result = await fn(augmentedArgs)\n\n    return transformResult ? await transformResult(result) : result\n  }\n}\n"],"mappings":"AASA,SAASA,qBAAqB,QAAQ;AA2BtC;;;;;;;;AAQA,OAAO,MAAMC,2BAAA,GAA8BA,CAAC;EAC1CC,OAAO;EACPC,eAAe;EACfC;AAAe,CACiB;EAChC,MAAMC,mBAAA,GAAgEF,eAAA,GAClE;IAAE,GAAGH,qBAAqB;IAAE,GAAGG;EAAgB,IAC/CH,qBAAA;EAEJ,OAAO,MAAOM,IAAA;IACZ,MAAM;MACJC,IAAA,EAAMC,KAAK;MACXF,IAAA,EAAMG,MAAM;MACZC,MAAA,EAAQC,aAAa;MACrBC,SAAS;MACTT,eAAA,EAAiBU;IAAoB,CACtC,GAAGP,IAAA;IAEJ,MAAM;MAAEQ,OAAO;MAAEC,MAAM;MAAEC,WAAW;MAAEC;IAAG,CAAE,GAAG,MAAMf,OAAA,CAAQ;MAAES,aAAA;MAAeC;IAAU;IAEvF,MAAMM,aAAA,GAA2C;MAC/C,GAAGT,MAAM;MACTK,OAAA;MACAF,SAAA;MACAG,MAAA;MACAC,WAAA;MACAC;IACF;IAEA,MAAME,EAAA,GAAKN,oBAAA,GAAuBL,KAAA,CAAM,IAAIH,mBAAmB,CAACG,KAAA,CAAM;IAEtE,IAAI,CAACW,EAAA,EAAI;MACP,MAAM,IAAIC,KAAA,CAAM,4BAA4BZ,KAAA,EAAO;IACrD;IAEA,MAAMa,MAAA,GAAS,MAAMF,EAAA,CAAGD,aAAA;IAExB,OAAOd,eAAA,GAAkB,MAAMA,eAAA,CAAgBiB,MAAA,IAAUA,MAAA;EAC3D;AACF","ignoreList":[]}

package/dist/utilities/serverFunctionRegistry.d.ts

@@ -1,13 +1,18 @@
 import type { ServerFunction } from 'payload';
 /**
- * Framework-agnostic server function handlers shared across all adapters.
+ * The complete, framework-agnostic set of Payload server functions.
  *
- * Each handler returns a value that may contain React elements (e.g.
- * `customComponents` inside form state, the `Document` / `List` nodes returned
- * by render-document / render-list). Adapters are expected to ship those over
- * the wire as RSC payloads — Next.js's runtime does this natively, while the
- * TanStack Start adapter pipes the result through `serializeForRsc` to convert
- * elements into `renderServerComponent` handles.
+ * Every adapter (`@payloadcms/next`, `@payloadcms/tanstack-start`) dispatches
+ * from this single registry via `createServerFunctionHandler`, so a handler
+ * added here reaches every framework and the adapter lists can't drift.
+ *
+ * Handlers may return values containing React elements (e.g. `customComponents`
+ * inside form state, the `Document` / `List` nodes from render-document /
+ * render-list, the render-field / render-widget output). Adapters ship those
+ * over the wire as RSC payloads: Next.js does this natively, while the TanStack
+ * Start adapter passes a `transformResult` (`serializeForRsc`) to
+ * `createServerFunctionHandler` that converts elements into
+ * `renderServerComponent` handles.
  */
 export declare const sharedServerFunctions: Record<string, ServerFunction<any, any>>;
 //# sourceMappingURL=serverFunctionRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serverFunctionRegistry.d.ts","sourceRoot":"","sources":["../../src/utilities/serverFunctionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAS7C;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAO1E,CAAA"}
+{"version":3,"file":"serverFunctionRegistry.d.ts","sourceRoot":"","sources":["../../src/utilities/serverFunctionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAe7C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAc1E,CAAA"}

package/dist/utilities/serverFunctionRegistry.js

@@ -1,25 +1,43 @@
+import { renderTabHandler } from '../elements/Nav/SidebarTabs/renderTabServerFn.js';
+import { _internal_renderFieldHandler } from '../forms/fieldSchemasToFormState/serverFunctions/renderFieldServerFn.js';
+import { getDefaultLayoutHandler, renderWidgetHandler } from '../views/Dashboard/serverFunctions.js';
 import { renderDocumentHandler } from '../views/Document/handleServerFunction.js';
+import { renderDocumentSlotsHandler } from '../views/Document/renderDocumentSlots.js';
 import { renderListHandler } from '../views/List/handleServerFunction.js';
 import { buildFormStateHandler } from './buildFormState.js';
 import { buildTableStateHandler } from './buildTableState.js';
 import { copyDataFromLocaleHandler } from './copyDataFromLocale.js';
 import { schedulePublishHandler } from './schedulePublishHandler.js';
+import { slugifyHandler } from './slugify.js';
+import { switchLanguageHandler } from './switchLanguageHandler.js';
 /**
- * Framework-agnostic server function handlers shared across all adapters.
+ * The complete, framework-agnostic set of Payload server functions.
  *
- * Each handler returns a value that may contain React elements (e.g.
- * `customComponents` inside form state, the `Document` / `List` nodes returned
- * by render-document / render-list). Adapters are expected to ship those over
- * the wire as RSC payloads — Next.js's runtime does this natively, while the
- * TanStack Start adapter pipes the result through `serializeForRsc` to convert
- * elements into `renderServerComponent` handles.
+ * Every adapter (`@payloadcms/next`, `@payloadcms/tanstack-start`) dispatches
+ * from this single registry via `createServerFunctionHandler`, so a handler
+ * added here reaches every framework and the adapter lists can't drift.
+ *
+ * Handlers may return values containing React elements (e.g. `customComponents`
+ * inside form state, the `Document` / `List` nodes from render-document /
+ * render-list, the render-field / render-widget output). Adapters ship those
+ * over the wire as RSC payloads: Next.js does this natively, while the TanStack
+ * Start adapter passes a `transformResult` (`serializeForRsc`) to
+ * `createServerFunctionHandler` that converts elements into
+ * `renderServerComponent` handles.
  */
 export const sharedServerFunctions = {
   'copy-data-from-locale': copyDataFromLocaleHandler,
   'form-state': buildFormStateHandler,
+  'get-default-layout': getDefaultLayoutHandler,
   'render-document': renderDocumentHandler,
+  'render-document-slots': renderDocumentSlotsHandler,
+  'render-field': _internal_renderFieldHandler,
   'render-list': renderListHandler,
+  'render-tab': renderTabHandler,
+  'render-widget': renderWidgetHandler,
   'schedule-publish': schedulePublishHandler,
+  slugify: slugifyHandler,
+  'switch-language': switchLanguageHandler,
   'table-state': buildTableStateHandler
 };
 //# sourceMappingURL=serverFunctionRegistry.js.map

package/dist/utilities/serverFunctionRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"serverFunctionRegistry.js","names":["renderDocumentHandler","renderListHandler","buildFormStateHandler","buildTableStateHandler","copyDataFromLocaleHandler","schedulePublishHandler","sharedServerFunctions"],"sources":["../../src/utilities/serverFunctionRegistry.ts"],"sourcesContent":["import type { ServerFunction } from 'payload'\n\nimport { renderDocumentHandler } from '../views/Document/handleServerFunction.js'\nimport { renderListHandler } from '../views/List/handleServerFunction.js'\nimport { buildFormStateHandler } from './buildFormState.js'\nimport { buildTableStateHandler } from './buildTableState.js'\nimport { copyDataFromLocaleHandler } from './copyDataFromLocale.js'\nimport { schedulePublishHandler } from './schedulePublishHandler.js'\n\n/**\n * Framework-agnostic server function handlers shared across all adapters.\n *\n * Each handler returns a value that may contain React elements (e.g.\n * `customComponents` inside form state, the `Document` / `List` nodes returned\n * by render-document / render-list). Adapters are expected to ship those over\n * the wire as RSC payloads — Next.js's runtime does this natively, while the\n * TanStack Start adapter pipes the result through `serializeForRsc` to convert\n * elements into `renderServerComponent` handles.\n */\nexport const sharedServerFunctions: Record<string, ServerFunction<any, any>> = {\n  'copy-data-from-locale': copyDataFromLocaleHandler,\n  'form-state': buildFormStateHandler,\n  'render-document': renderDocumentHandler,\n  'render-list': renderListHandler,\n  'schedule-publish': schedulePublishHandler,\n  'table-state': buildTableStateHandler,\n}\n"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ;AACtC,SAASC,iBAAiB,QAAQ;AAClC,SAASC,qBAAqB,QAAQ;AACtC,SAASC,sBAAsB,QAAQ;AACvC,SAASC,yBAAyB,QAAQ;AAC1C,SAASC,sBAAsB,QAAQ;AAEvC;;;;;;;;;;AAUA,OAAO,MAAMC,qBAAA,GAAkE;EAC7E,yBAAyBF,yBAAA;EACzB,cAAcF,qBAAA;EACd,mBAAmBF,qBAAA;EACnB,eAAeC,iBAAA;EACf,oBAAoBI,sBAAA;EACpB,eAAeF;AACjB","ignoreList":[]}
+{"version":3,"file":"serverFunctionRegistry.js","names":["renderTabHandler","_internal_renderFieldHandler","getDefaultLayoutHandler","renderWidgetHandler","renderDocumentHandler","renderDocumentSlotsHandler","renderListHandler","buildFormStateHandler","buildTableStateHandler","copyDataFromLocaleHandler","schedulePublishHandler","slugifyHandler","switchLanguageHandler","sharedServerFunctions","slugify"],"sources":["../../src/utilities/serverFunctionRegistry.ts"],"sourcesContent":["import type { ServerFunction } from 'payload'\n\nimport { renderTabHandler } from '../elements/Nav/SidebarTabs/renderTabServerFn.js'\nimport { _internal_renderFieldHandler } from '../forms/fieldSchemasToFormState/serverFunctions/renderFieldServerFn.js'\nimport { getDefaultLayoutHandler, renderWidgetHandler } from '../views/Dashboard/serverFunctions.js'\nimport { renderDocumentHandler } from '../views/Document/handleServerFunction.js'\nimport { renderDocumentSlotsHandler } from '../views/Document/renderDocumentSlots.js'\nimport { renderListHandler } from '../views/List/handleServerFunction.js'\nimport { buildFormStateHandler } from './buildFormState.js'\nimport { buildTableStateHandler } from './buildTableState.js'\nimport { copyDataFromLocaleHandler } from './copyDataFromLocale.js'\nimport { schedulePublishHandler } from './schedulePublishHandler.js'\nimport { slugifyHandler } from './slugify.js'\nimport { switchLanguageHandler } from './switchLanguageHandler.js'\n\n/**\n * The complete, framework-agnostic set of Payload server functions.\n *\n * Every adapter (`@payloadcms/next`, `@payloadcms/tanstack-start`) dispatches\n * from this single registry via `createServerFunctionHandler`, so a handler\n * added here reaches every framework and the adapter lists can't drift.\n *\n * Handlers may return values containing React elements (e.g. `customComponents`\n * inside form state, the `Document` / `List` nodes from render-document /\n * render-list, the render-field / render-widget output). Adapters ship those\n * over the wire as RSC payloads: Next.js does this natively, while the TanStack\n * Start adapter passes a `transformResult` (`serializeForRsc`) to\n * `createServerFunctionHandler` that converts elements into\n * `renderServerComponent` handles.\n */\nexport const sharedServerFunctions: Record<string, ServerFunction<any, any>> = {\n  'copy-data-from-locale': copyDataFromLocaleHandler,\n  'form-state': buildFormStateHandler,\n  'get-default-layout': getDefaultLayoutHandler,\n  'render-document': renderDocumentHandler,\n  'render-document-slots': renderDocumentSlotsHandler,\n  'render-field': _internal_renderFieldHandler,\n  'render-list': renderListHandler,\n  'render-tab': renderTabHandler,\n  'render-widget': renderWidgetHandler,\n  'schedule-publish': schedulePublishHandler,\n  slugify: slugifyHandler,\n  'switch-language': switchLanguageHandler,\n  'table-state': buildTableStateHandler,\n}\n"],"mappings":"AAEA,SAASA,gBAAgB,QAAQ;AACjC,SAASC,4BAA4B,QAAQ;AAC7C,SAASC,uBAAuB,EAAEC,mBAAmB,QAAQ;AAC7D,SAASC,qBAAqB,QAAQ;AACtC,SAASC,0BAA0B,QAAQ;AAC3C,SAASC,iBAAiB,QAAQ;AAClC,SAASC,qBAAqB,QAAQ;AACtC,SAASC,sBAAsB,QAAQ;AACvC,SAASC,yBAAyB,QAAQ;AAC1C,SAASC,sBAAsB,QAAQ;AACvC,SAASC,cAAc,QAAQ;AAC/B,SAASC,qBAAqB,QAAQ;AAEtC;;;;;;;;;;;;;;;AAeA,OAAO,MAAMC,qBAAA,GAAkE;EAC7E,yBAAyBJ,yBAAA;EACzB,cAAcF,qBAAA;EACd,sBAAsBL,uBAAA;EACtB,mBAAmBE,qBAAA;EACnB,yBAAyBC,0BAAA;EACzB,gBAAgBJ,4BAAA;EAChB,eAAeK,iBAAA;EACf,cAAcN,gBAAA;EACd,iBAAiBG,mBAAA;EACjB,oBAAoBO,sBAAA;EACpBI,OAAA,EAASH,cAAA;EACT,mBAAmBC,qBAAA;EACnB,eAAeJ;AACjB","ignoreList":[]}

package/dist/views/Edit/index.css

@@ -12,35 +12,32 @@
   }
 
   .collection-edit__main-wrapper--scroll-fields-only {
-    height: calc(
-      100dvh - var(--app-header-height, 0px) - var(--doc-controls-height, 0px) -
-        var(--doc-header-height, 0px)
-    );
-    overflow: hidden;
+    height: auto;
+    overflow: visible;
 
     .collection-edit__main {
-      min-height: 0;
-      overflow: hidden;
+      min-height: initial;
+      overflow: visible;
     }
 
     .document-fields {
-      height: 100%;
-      min-height: 0;
+      height: auto;
+      min-height: initial;
     }
 
     .document-fields--force-sidebar-wrap {
-      overflow-y: auto;
-      overscroll-behavior: contain;
-      scrollbar-width: thin;
-      scrollbar-color: var(--scrollbar-color) transparent;
+      overflow-y: visible;
+      overscroll-behavior: auto;
+      scrollbar-width: auto;
+      scrollbar-color: auto;
     }
 
     .document-fields:not(.document-fields--force-sidebar-wrap) .document-fields__main {
-      min-height: 0;
-      overflow-y: auto;
-      overscroll-behavior: contain;
-      scrollbar-width: thin;
-      scrollbar-color: var(--scrollbar-color) transparent;
+      min-height: initial;
+      overflow-y: visible;
+      overscroll-behavior: auto;
+      scrollbar-width: auto;
+      scrollbar-color: auto;
     }
 
     .document-fields--force-sidebar-wrap .document-fields__main {
@@ -51,9 +48,9 @@
     }
 
     .document-fields__sidebar {
-      overscroll-behavior: contain;
-      scrollbar-width: thin;
-      scrollbar-color: var(--scrollbar-color) transparent;
+      overscroll-behavior: auto;
+      scrollbar-width: auto;
+      scrollbar-color: auto;
     }
 
     .document-fields__sidebar-wrap {
@@ -63,8 +60,8 @@
   }
 
   .template-default__wrap:has(.collection-edit__main-wrapper--scroll-fields-only) {
-    height: 100dvh;
-    overflow: hidden;
+    height: auto;
+    overflow: visible;
   }
 
   .collection-edit__main {
@@ -76,12 +73,22 @@
   }
 
   .collection-edit__main-wrapper--has-upload-panel {
+    flex-direction: column-reverse;
+    gap: var(--spacer-5);
+
     .collection-edit__main {
       flex: 1;
     }
+
     .file-manager {
-      flex: 2;
-      border-inline-start: var(--stroke-width-small) solid var(--color-border);
+      order: 0;
+      /* Stacked — no vertical divider; the file manager's own bottom border separates it. */
+      border-inline-start: 0;
+    }
+
+    .document-fields {
+      flex: 0 0 auto;
+      width: 100%;
     }
 
     .collection-edit__main:not(:has(.field-type)) {
@@ -95,61 +102,62 @@
 
   /* Container query (not viewport) so the layout stacks based on the space actually available
      to the edit view — e.g. inside a narrow document drawer it uses the stacked mobile layout. */
-  @container edit-main (max-width: 1024px) {
+  @container edit-main (min-width: 1024px) {
     .collection-edit__main-wrapper--scroll-fields-only {
-      height: auto;
-      overflow: visible;
+      height: calc(
+        100dvh - var(--app-header-height, 0px) - var(--doc-controls-height, 0px) -
+          var(--doc-header-height, 0px)
+      );
+      overflow: hidden;
 
       .collection-edit__main {
-        min-height: initial;
-        overflow: visible;
+        min-height: 0;
+        overflow: hidden;
       }
 
       .document-fields {
-        height: auto;
-        min-height: initial;
+        height: 100%;
+        min-height: 0;
       }
 
       .document-fields--force-sidebar-wrap {
-        overflow-y: visible;
-        overscroll-behavior: auto;
-        scrollbar-width: auto;
-        scrollbar-color: auto;
+        overflow-y: auto;
+        overscroll-behavior: contain;
+        scrollbar-width: thin;
+        scrollbar-color: var(--scrollbar-color) transparent;
       }
 
       .document-fields:not(.document-fields--force-sidebar-wrap) .document-fields__main {
-        min-height: initial;
-        overflow-y: visible;
-        overscroll-behavior: auto;
-        scrollbar-width: auto;
-        scrollbar-color: auto;
+        min-height: 0;
+        overflow-y: auto;
+        overscroll-behavior: contain;
+        scrollbar-width: thin;
+        scrollbar-color: var(--scrollbar-color) transparent;
       }
 
       .document-fields__sidebar {
-        overscroll-behavior: auto;
-        scrollbar-width: auto;
-        scrollbar-color: auto;
+        overscroll-behavior: contain;
+        scrollbar-width: thin;
+        scrollbar-color: var(--scrollbar-color) transparent;
       }
     }
 
     .template-default__wrap:has(.collection-edit__main-wrapper--scroll-fields-only) {
-      height: auto;
-      overflow: visible;
+      height: 100dvh;
+      overflow: hidden;
     }
 
     .collection-edit__main-wrapper--has-upload-panel {
-      flex-direction: column-reverse;
-      gap: var(--spacer-5);
+      flex-direction: row;
+      gap: 0;
 
       .file-manager {
-        order: 0;
-        flex: 1 0 0;
-        /* Stacked — no vertical divider; the file manager's own bottom border separates it. */
-        border-inline-start: 0;
+        flex: 2;
+        border-inline-start: var(--stroke-width-small) solid var(--color-border);
       }
 
       .document-fields {
-        flex: 0 0 auto;
+        flex: initial;
         width: 100%;
       }
     }

package/dist/views/Root/index.d.ts

@@ -12,6 +12,17 @@ export type RenderRootArgs = {
     config: Promise<SanitizedConfig>;
     importMap: ImportMap;
     initReq: InitReqFn;
+    /**
+     * Optional React `key` applied to the rendered view (not the surrounding admin
+     * template/nav). Adapters whose router reconciles a single RSC payload in place
+     * across navigations (e.g. TanStack Start) pass a per-route key here so the
+     * *view* remounts on route change — resetting view-scoped client providers like
+     * `DocumentInfoProvider` that hold uncontrolled `useState` from the prior
+     * document — while the persistent nav/template reconciles in place (no flash).
+     * Left `undefined` by Next.js, whose App Router already remounts the page
+     * segment while its layout (nav) persists.
+     */
+    key?: string;
     /** Framework notFound implementation (e.g. next/navigation notFound). Called before req is available. */
     notFound: () => never;
     params: Promise<{
@@ -23,6 +34,6 @@ export type RenderRootArgs = {
         [key: string]: string | string[];
     }>;
 };
-export declare const renderRoot: ({ adminViews, config: configPromise, importMap, initReq, notFound, params: paramsPromise, redirect, searchParams: searchParamsPromise, }: RenderRootArgs) => Promise<React.JSX.Element>;
+export declare const renderRoot: ({ adminViews, config: configPromise, importMap, initReq, key, notFound, params: paramsPromise, redirect, searchParams: searchParamsPromise, }: RenderRootArgs) => Promise<React.JSX.Element>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/views/Root/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/views/Root/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAIhB,cAAc,EACd,SAAS,EACT,aAAa,EAEb,eAAe,EAEhB,MAAM,SAAS,CAAA;AAIhB,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;CACjD,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IAChC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,yGAAyG;IACzG,QAAQ,EAAE,MAAM,KAAK,CAAA;IACrB,MAAM,EAAE,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvC,yGAAyG;IACzG,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAA;IAChC,YAAY,EAAE,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAC5D,CAAA;AAED,eAAO,MAAM,UAAU,6IASpB,cAAc,+BAqThB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/views/Root/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAIhB,cAAc,EACd,SAAS,EACT,aAAa,EAEb,eAAe,EAEhB,MAAM,SAAS,CAAA;AAIhB,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;CACjD,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IAChC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yGAAyG;IACzG,QAAQ,EAAE,MAAM,KAAK,CAAA;IACrB,MAAM,EAAE,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvC,yGAAyG;IACzG,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAA;IAChC,YAAY,EAAE,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAC5D,CAAA;AAED,eAAO,MAAM,UAAU,kJAUpB,cAAc,+BA0ThB,CAAA"}

package/dist/views/Root/index.js

@@ -22,6 +22,7 @@ export const renderRoot = async ({
   config: configPromise,
   importMap,
   initReq,
+  key,
   notFound,
   params: paramsPromise,
   redirect,
@@ -269,13 +270,19 @@ export const renderRoot = async ({
       viewActions
     }
   });
+  // Wrap the view in a keyed boundary so it remounts on route change while the
+  // surrounding template/nav reconciles in place. `key={undefined}` (Next.js) is
+  // a no-op, preserving prior behavior.
+  const KeyedView = /*#__PURE__*/_jsx(React.Fragment, {
+    children: RenderedView
+  }, key);
   return /*#__PURE__*/_jsxs(PageConfigProvider, {
     config: clientConfig,
     children: [!templateType && /*#__PURE__*/_jsx(React.Fragment, {
-      children: RenderedView
+      children: KeyedView
     }), templateType === 'minimal' && /*#__PURE__*/_jsx(MinimalTemplate, {
       className: templateClassName,
-      children: RenderedView
+      children: KeyedView
     }), templateType === 'default' && /*#__PURE__*/_jsx(DefaultTemplate, {
       collectionSlug: collectionConfig?.slug,
       docID: routeParams.id,
@@ -297,7 +304,7 @@ export const renderRoot = async ({
         collections: visibleEntities?.collections,
         globals: visibleEntities?.globals
       },
-      children: RenderedView
+      children: KeyedView
     })]
   });
 };