@payloadcms/tanstack-start 4.0.0-beta.0

package/dist/withPayload/workarounds/clientModuleResolution.d.ts

@@ -0,0 +1,14 @@
+import type { PluginOption } from 'vite';
+/**
+ * Client-side module resolution:
+ * 1. Stubs RSC modules (`@payloadcms/.../rsc`) with no-op components so the
+ *    Vite optimizer never tries to bundle their server implementations.
+ * 2. Redirects bare `payload` imports made from user code (outside of
+ *    `node_modules` and our own packages) to `payload/shared`. The main
+ *    `payload` entry has top-level side effects requiring Node.js APIs.
+ * 3. Resolves `/client` subpath exports for `@payloadcms/plugin-*` and
+ *    `@payloadcms/storage-*` packages when normal Vite resolution fails in
+ *    monorepo dev (no `dist/` built yet).
+ */
+export declare function clientModuleResolution(): PluginOption;
+//# sourceMappingURL=clientModuleResolution.d.ts.map

package/dist/withPayload/workarounds/clientModuleResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientModuleResolution.d.ts","sourceRoot":"","sources":["../../../src/withPayload/workarounds/clientModuleResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAKxC;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CA+ErD"}

package/dist/withPayload/workarounds/clientModuleResolution.js

@@ -0,0 +1,98 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Client-side module resolution:
+ * 1. Stubs RSC modules (`@payloadcms/.../rsc`) with no-op components so the
+ *    Vite optimizer never tries to bundle their server implementations.
+ * 2. Redirects bare `payload` imports made from user code (outside of
+ *    `node_modules` and our own packages) to `payload/shared`. The main
+ *    `payload` entry has top-level side effects requiring Node.js APIs.
+ * 3. Resolves `/client` subpath exports for `@payloadcms/plugin-*` and
+ *    `@payloadcms/storage-*` packages when normal Vite resolution fails in
+ *    monorepo dev (no `dist/` built yet).
+ */ export function clientModuleResolution() {
+    const stubPrefix = '\0payload:server-stub:';
+    const serverOnlyPatterns = [
+        /^@payloadcms\/richtext-lexical\/rsc$/,
+        /^@payloadcms\/richtext-slate\/rsc$/,
+        /^@payloadcms\/next\/rsc$/,
+        /^@payloadcms\/tanstack-start\/rsc$/
+    ];
+    const serverOnlyExports = {
+        '@payloadcms/next/rsc': [
+            'CollectionCards',
+            'HierarchyTypeFieldServer'
+        ],
+        '@payloadcms/richtext-lexical/rsc': [
+            'RscEntryLexicalCell',
+            'RscEntryLexicalField',
+            'LexicalDiffComponent'
+        ],
+        '@payloadcms/tanstack-start/rsc': [
+            'CollectionCards',
+            'HierarchyTypeFieldServer',
+            'renderPayloadComponentOnServer'
+        ]
+    };
+    return {
+        name: 'payload:client-module-resolution',
+        enforce: 'pre',
+        load (id) {
+            if (!id.startsWith(stubPrefix)) {
+                return;
+            }
+            const specifier = id.slice(stubPrefix.length);
+            const exports = serverOnlyExports[specifier];
+            if (exports) {
+                return exports.map((name)=>`export const ${name} = () => null;`).join('\n');
+            }
+            return `export default null;`;
+        },
+        async resolveId (id, importer, options) {
+            if (options?.ssr) {
+                return;
+            }
+            if (serverOnlyPatterns.some((p)=>p.test(id))) {
+                return stubPrefix + id;
+            }
+            if (id === 'payload' && importer && !importer.includes('/node_modules/')) {
+                const isPayloadPackage = /\/packages\/(?:payload|ui|richtext-|tanstack-start|next)\//.test(importer);
+                if (!isPayloadPackage) {
+                    return this.resolve('payload/shared', importer, {
+                        ...options,
+                        skipSelf: true
+                    });
+                }
+            }
+            if (/^@payloadcms\/(?:plugin|storage)-[^/]+\/client$/.test(id)) {
+                const resolved = await this.resolve(id, importer, {
+                    ...options,
+                    skipSelf: true
+                });
+                if (resolved) {
+                    return resolved;
+                }
+                const pkgName = id.replace(/\/client$/, '');
+                const pkgResolved = await this.resolve(pkgName, importer, {
+                    ...options,
+                    skipSelf: true
+                });
+                if (pkgResolved) {
+                    const pkgDir = path.dirname(pkgResolved.id);
+                    const candidates = [
+                        path.resolve(pkgDir, 'src', 'exports', 'client.ts'),
+                        path.resolve(pkgDir, 'src', 'exports', 'client.js'),
+                        path.resolve(pkgDir, 'dist', 'exports', 'client.js')
+                    ];
+                    for (const candidate of candidates){
+                        if (fs.existsSync(candidate)) {
+                            return candidate;
+                        }
+                    }
+                }
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=clientModuleResolution.js.map

package/dist/withPayload/workarounds/clientModuleResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/withPayload/workarounds/clientModuleResolution.ts"],"sourcesContent":["import type { PluginOption } from 'vite'\n\nimport fs from 'node:fs'\nimport path from 'node:path'\n\n/**\n * Client-side module resolution:\n * 1. Stubs RSC modules (`@payloadcms/.../rsc`) with no-op components so the\n *    Vite optimizer never tries to bundle their server implementations.\n * 2. Redirects bare `payload` imports made from user code (outside of\n *    `node_modules` and our own packages) to `payload/shared`. The main\n *    `payload` entry has top-level side effects requiring Node.js APIs.\n * 3. Resolves `/client` subpath exports for `@payloadcms/plugin-*` and\n *    `@payloadcms/storage-*` packages when normal Vite resolution fails in\n *    monorepo dev (no `dist/` built yet).\n */\nexport function clientModuleResolution(): PluginOption {\n  const stubPrefix = '\\0payload:server-stub:'\n\n  const serverOnlyPatterns: RegExp[] = [\n    /^@payloadcms\\/richtext-lexical\\/rsc$/,\n    /^@payloadcms\\/richtext-slate\\/rsc$/,\n    /^@payloadcms\\/next\\/rsc$/,\n    /^@payloadcms\\/tanstack-start\\/rsc$/,\n  ]\n\n  const serverOnlyExports: Record<string, string[]> = {\n    '@payloadcms/next/rsc': ['CollectionCards', 'HierarchyTypeFieldServer'],\n    '@payloadcms/richtext-lexical/rsc': [\n      'RscEntryLexicalCell',\n      'RscEntryLexicalField',\n      'LexicalDiffComponent',\n    ],\n    '@payloadcms/tanstack-start/rsc': [\n      'CollectionCards',\n      'HierarchyTypeFieldServer',\n      'renderPayloadComponentOnServer',\n    ],\n  }\n\n  return {\n    name: 'payload:client-module-resolution',\n    enforce: 'pre',\n    load(id) {\n      if (!id.startsWith(stubPrefix)) {\n        return\n      }\n      const specifier = id.slice(stubPrefix.length)\n      const exports = serverOnlyExports[specifier]\n      if (exports) {\n        return exports.map((name) => `export const ${name} = () => null;`).join('\\n')\n      }\n      return `export default null;`\n    },\n    async resolveId(id, importer, options) {\n      if (options?.ssr) {\n        return\n      }\n\n      if (serverOnlyPatterns.some((p) => p.test(id))) {\n        return stubPrefix + id\n      }\n\n      if (id === 'payload' && importer && !importer.includes('/node_modules/')) {\n        const isPayloadPackage = /\\/packages\\/(?:payload|ui|richtext-|tanstack-start|next)\\//.test(\n          importer,\n        )\n        if (!isPayloadPackage) {\n          return this.resolve('payload/shared', importer, { ...options, skipSelf: true })\n        }\n      }\n\n      if (/^@payloadcms\\/(?:plugin|storage)-[^/]+\\/client$/.test(id)) {\n        const resolved = await this.resolve(id, importer, { ...options, skipSelf: true })\n        if (resolved) {\n          return resolved\n        }\n        const pkgName = id.replace(/\\/client$/, '')\n        const pkgResolved = await this.resolve(pkgName, importer, { ...options, skipSelf: true })\n        if (pkgResolved) {\n          const pkgDir = path.dirname(pkgResolved.id)\n          const candidates = [\n            path.resolve(pkgDir, 'src', 'exports', 'client.ts'),\n            path.resolve(pkgDir, 'src', 'exports', 'client.js'),\n            path.resolve(pkgDir, 'dist', 'exports', 'client.js'),\n          ]\n          for (const candidate of candidates) {\n            if (fs.existsSync(candidate)) {\n              return candidate\n            }\n          }\n        }\n      }\n    },\n  }\n}\n"],"names":["fs","path","clientModuleResolution","stubPrefix","serverOnlyPatterns","serverOnlyExports","name","enforce","load","id","startsWith","specifier","slice","length","exports","map","join","resolveId","importer","options","ssr","some","p","test","includes","isPayloadPackage","resolve","skipSelf","resolved","pkgName","replace","pkgResolved","pkgDir","dirname","candidates","candidate","existsSync"],"mappings":"AAEA,OAAOA,QAAQ,UAAS;AACxB,OAAOC,UAAU,YAAW;AAE5B;;;;;;;;;;CAUC,GACD,OAAO,SAASC;IACd,MAAMC,aAAa;IAEnB,MAAMC,qBAA+B;QACnC;QACA;QACA;QACA;KACD;IAED,MAAMC,oBAA8C;QAClD,wBAAwB;YAAC;YAAmB;SAA2B;QACvE,oCAAoC;YAClC;YACA;YACA;SACD;QACD,kCAAkC;YAChC;YACA;YACA;SACD;IACH;IAEA,OAAO;QACLC,MAAM;QACNC,SAAS;QACTC,MAAKC,EAAE;YACL,IAAI,CAACA,GAAGC,UAAU,CAACP,aAAa;gBAC9B;YACF;YACA,MAAMQ,YAAYF,GAAGG,KAAK,CAACT,WAAWU,MAAM;YAC5C,MAAMC,UAAUT,iBAAiB,CAACM,UAAU;YAC5C,IAAIG,SAAS;gBACX,OAAOA,QAAQC,GAAG,CAAC,CAACT,OAAS,CAAC,aAAa,EAAEA,KAAK,cAAc,CAAC,EAAEU,IAAI,CAAC;YAC1E;YACA,OAAO,CAAC,oBAAoB,CAAC;QAC/B;QACA,MAAMC,WAAUR,EAAE,EAAES,QAAQ,EAAEC,OAAO;YACnC,IAAIA,SAASC,KAAK;gBAChB;YACF;YAEA,IAAIhB,mBAAmBiB,IAAI,CAAC,CAACC,IAAMA,EAAEC,IAAI,CAACd,MAAM;gBAC9C,OAAON,aAAaM;YACtB;YAEA,IAAIA,OAAO,aAAaS,YAAY,CAACA,SAASM,QAAQ,CAAC,mBAAmB;gBACxE,MAAMC,mBAAmB,6DAA6DF,IAAI,CACxFL;gBAEF,IAAI,CAACO,kBAAkB;oBACrB,OAAO,IAAI,CAACC,OAAO,CAAC,kBAAkBR,UAAU;wBAAE,GAAGC,OAAO;wBAAEQ,UAAU;oBAAK;gBAC/E;YACF;YAEA,IAAI,kDAAkDJ,IAAI,CAACd,KAAK;gBAC9D,MAAMmB,WAAW,MAAM,IAAI,CAACF,OAAO,CAACjB,IAAIS,UAAU;oBAAE,GAAGC,OAAO;oBAAEQ,UAAU;gBAAK;gBAC/E,IAAIC,UAAU;oBACZ,OAAOA;gBACT;gBACA,MAAMC,UAAUpB,GAAGqB,OAAO,CAAC,aAAa;gBACxC,MAAMC,cAAc,MAAM,IAAI,CAACL,OAAO,CAACG,SAASX,UAAU;oBAAE,GAAGC,OAAO;oBAAEQ,UAAU;gBAAK;gBACvF,IAAII,aAAa;oBACf,MAAMC,SAAS/B,KAAKgC,OAAO,CAACF,YAAYtB,EAAE;oBAC1C,MAAMyB,aAAa;wBACjBjC,KAAKyB,OAAO,CAACM,QAAQ,OAAO,WAAW;wBACvC/B,KAAKyB,OAAO,CAACM,QAAQ,OAAO,WAAW;wBACvC/B,KAAKyB,OAAO,CAACM,QAAQ,QAAQ,WAAW;qBACzC;oBACD,KAAK,MAAMG,aAAaD,WAAY;wBAClC,IAAIlC,GAAGoC,UAAU,CAACD,YAAY;4BAC5B,OAAOA;wBACT;oBACF;gBACF;YACF;QACF;IACF;AACF"}

package/dist/withPayload/workarounds/devTransforms.d.ts

@@ -0,0 +1,19 @@
+import type { PluginOption } from 'vite';
+/**
+ * Dev-time transforms:
+ * - Replaces `process.cwd()` with `"/"` in client code (non-SSR, non-prebundled)
+ * - Injects Vite HMR + React Refresh preamble into SSR-rendered HTML (dev only)
+ *
+ * The preamble is injected just before `</head>`, *after* everything React
+ * renders into the head. React 19 treats `<meta>`/`<link>`/`<style>`/`<title>`
+ * as hoistable resources it matches by key (position-tolerant), but a
+ * non-hoistable inline `<script type="module">` placed *before* React's first
+ * rendered head node makes hydration position-match that script against a
+ * `<style>`/`<meta>` and throw — discarding the whole tree client-side, which
+ * aborts in-flight server-function fetches and intermittently breaks drawers,
+ * forms, and navigation. Appending after React's head content keeps the
+ * preamble out of that positional comparison while still running before the
+ * body's app-entry module.
+ */
+export declare function payloadDevTransforms(): PluginOption;
+//# sourceMappingURL=devTransforms.d.ts.map

package/dist/withPayload/workarounds/devTransforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devTransforms.d.ts","sourceRoot":"","sources":["../../../src/withPayload/workarounds/devTransforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAgEnD"}

package/dist/withPayload/workarounds/devTransforms.js

@@ -0,0 +1,72 @@
+/**
+ * Dev-time transforms:
+ * - Replaces `process.cwd()` with `"/"` in client code (non-SSR, non-prebundled)
+ * - Injects Vite HMR + React Refresh preamble into SSR-rendered HTML (dev only)
+ *
+ * The preamble is injected just before `</head>`, *after* everything React
+ * renders into the head. React 19 treats `<meta>`/`<link>`/`<style>`/`<title>`
+ * as hoistable resources it matches by key (position-tolerant), but a
+ * non-hoistable inline `<script type="module">` placed *before* React's first
+ * rendered head node makes hydration position-match that script against a
+ * `<style>`/`<meta>` and throw — discarding the whole tree client-side, which
+ * aborts in-flight server-function fetches and intermittently breaks drawers,
+ * forms, and navigation. Appending after React's head content keeps the
+ * preamble out of that positional comparison while still running before the
+ * body's app-entry module.
+ */ export function payloadDevTransforms() {
+    const devScripts = `<script type="module" src="/@vite/client"></script>
+<script type="module">
+import RefreshRuntime from "/@react-refresh"
+RefreshRuntime.injectIntoGlobalHook(window)
+window.$RefreshReg$ = () => {}
+window.$RefreshSig$ = () => (type) => type
+window.__vite_plugin_react_preamble_installed__ = true
+</script>`;
+    return {
+        name: 'payload:dev-transforms',
+        configureServer (server) {
+            server.middlewares.use((_req, res, next)=>{
+                let injected = false;
+                const origWrite = res.write;
+                const origEnd = res.end;
+                function tryInject(chunk) {
+                    if (injected || chunk == null) {
+                        return chunk;
+                    }
+                    const ct = res.getHeader('content-type');
+                    if (typeof ct !== 'string' || !ct.includes('text/html')) {
+                        return chunk;
+                    }
+                    const str = typeof chunk === 'string' ? chunk : Buffer.isBuffer(chunk) ? chunk.toString() : chunk instanceof Uint8Array ? Buffer.from(chunk).toString() : null;
+                    // Skip if a host already injected the preamble — a second copy breaks HMR.
+                    if (str && str.includes('__vite_plugin_react_preamble_installed__')) {
+                        injected = true;
+                        return chunk;
+                    }
+                    if (str && str.includes('</head>')) {
+                        injected = true;
+                        return str.replace('</head>', `${devScripts}</head>`);
+                    }
+                    return chunk;
+                }
+                res.write = function(chunk, encodingOrCb, cb) {
+                    return origWrite.call(this, tryInject(chunk), encodingOrCb, cb);
+                };
+                res.end = function(chunk, encodingOrCb, cb) {
+                    return origEnd.call(this, tryInject(chunk), encodingOrCb, cb);
+                };
+                next();
+            });
+        },
+        transform (code, id, options) {
+            if (options?.ssr) {
+                return;
+            }
+            if (code.includes('process.cwd') && !id.includes('node_modules/.vite')) {
+                return code.replace(/process\.cwd\(\)/g, '"/"');
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=devTransforms.js.map

package/dist/withPayload/workarounds/devTransforms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/withPayload/workarounds/devTransforms.ts"],"sourcesContent":["import type { PluginOption } from 'vite'\n\n/**\n * Dev-time transforms:\n * - Replaces `process.cwd()` with `\"/\"` in client code (non-SSR, non-prebundled)\n * - Injects Vite HMR + React Refresh preamble into SSR-rendered HTML (dev only)\n *\n * The preamble is injected just before `</head>`, *after* everything React\n * renders into the head. React 19 treats `<meta>`/`<link>`/`<style>`/`<title>`\n * as hoistable resources it matches by key (position-tolerant), but a\n * non-hoistable inline `<script type=\"module\">` placed *before* React's first\n * rendered head node makes hydration position-match that script against a\n * `<style>`/`<meta>` and throw — discarding the whole tree client-side, which\n * aborts in-flight server-function fetches and intermittently breaks drawers,\n * forms, and navigation. Appending after React's head content keeps the\n * preamble out of that positional comparison while still running before the\n * body's app-entry module.\n */\nexport function payloadDevTransforms(): PluginOption {\n  const devScripts = `<script type=\"module\" src=\"/@vite/client\"></script>\n<script type=\"module\">\nimport RefreshRuntime from \"/@react-refresh\"\nRefreshRuntime.injectIntoGlobalHook(window)\nwindow.$RefreshReg$ = () => {}\nwindow.$RefreshSig$ = () => (type) => type\nwindow.__vite_plugin_react_preamble_installed__ = true\n</script>`\n\n  return {\n    name: 'payload:dev-transforms',\n    configureServer(server) {\n      server.middlewares.use((_req, res, next) => {\n        let injected = false\n        const origWrite = res.write\n        const origEnd = res.end\n\n        function tryInject(chunk: any): any {\n          if (injected || chunk == null) {\n            return chunk\n          }\n          const ct = res.getHeader('content-type')\n          if (typeof ct !== 'string' || !ct.includes('text/html')) {\n            return chunk\n          }\n          const str =\n            typeof chunk === 'string'\n              ? chunk\n              : Buffer.isBuffer(chunk)\n                ? chunk.toString()\n                : chunk instanceof Uint8Array\n                  ? Buffer.from(chunk).toString()\n                  : null\n          // Skip if a host already injected the preamble — a second copy breaks HMR.\n          if (str && str.includes('__vite_plugin_react_preamble_installed__')) {\n            injected = true\n            return chunk\n          }\n          if (str && str.includes('</head>')) {\n            injected = true\n            return str.replace('</head>', `${devScripts}</head>`)\n          }\n          return chunk\n        }\n\n        res.write = function (this: any, chunk: any, encodingOrCb?: any, cb?: any) {\n          return origWrite.call(this, tryInject(chunk), encodingOrCb, cb)\n        } as typeof res.write\n        res.end = function (this: any, chunk?: any, encodingOrCb?: any, cb?: any) {\n          return origEnd.call(this, tryInject(chunk), encodingOrCb, cb)\n        } as typeof res.end\n        next()\n      })\n    },\n    transform(code, id, options) {\n      if (options?.ssr) {\n        return\n      }\n      if (code.includes('process.cwd') && !id.includes('node_modules/.vite')) {\n        return code.replace(/process\\.cwd\\(\\)/g, '\"/\"')\n      }\n    },\n  }\n}\n"],"names":["payloadDevTransforms","devScripts","name","configureServer","server","middlewares","use","_req","res","next","injected","origWrite","write","origEnd","end","tryInject","chunk","ct","getHeader","includes","str","Buffer","isBuffer","toString","Uint8Array","from","replace","encodingOrCb","cb","call","transform","code","id","options","ssr"],"mappings":"AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASA;IACd,MAAMC,aAAa,CAAC;;;;;;;SAOb,CAAC;IAER,OAAO;QACLC,MAAM;QACNC,iBAAgBC,MAAM;YACpBA,OAAOC,WAAW,CAACC,GAAG,CAAC,CAACC,MAAMC,KAAKC;gBACjC,IAAIC,WAAW;gBACf,MAAMC,YAAYH,IAAII,KAAK;gBAC3B,MAAMC,UAAUL,IAAIM,GAAG;gBAEvB,SAASC,UAAUC,KAAU;oBAC3B,IAAIN,YAAYM,SAAS,MAAM;wBAC7B,OAAOA;oBACT;oBACA,MAAMC,KAAKT,IAAIU,SAAS,CAAC;oBACzB,IAAI,OAAOD,OAAO,YAAY,CAACA,GAAGE,QAAQ,CAAC,cAAc;wBACvD,OAAOH;oBACT;oBACA,MAAMI,MACJ,OAAOJ,UAAU,WACbA,QACAK,OAAOC,QAAQ,CAACN,SACdA,MAAMO,QAAQ,KACdP,iBAAiBQ,aACfH,OAAOI,IAAI,CAACT,OAAOO,QAAQ,KAC3B;oBACV,2EAA2E;oBAC3E,IAAIH,OAAOA,IAAID,QAAQ,CAAC,6CAA6C;wBACnET,WAAW;wBACX,OAAOM;oBACT;oBACA,IAAII,OAAOA,IAAID,QAAQ,CAAC,YAAY;wBAClCT,WAAW;wBACX,OAAOU,IAAIM,OAAO,CAAC,WAAW,GAAGzB,WAAW,OAAO,CAAC;oBACtD;oBACA,OAAOe;gBACT;gBAEAR,IAAII,KAAK,GAAG,SAAqBI,KAAU,EAAEW,YAAkB,EAAEC,EAAQ;oBACvE,OAAOjB,UAAUkB,IAAI,CAAC,IAAI,EAAEd,UAAUC,QAAQW,cAAcC;gBAC9D;gBACApB,IAAIM,GAAG,GAAG,SAAqBE,KAAW,EAAEW,YAAkB,EAAEC,EAAQ;oBACtE,OAAOf,QAAQgB,IAAI,CAAC,IAAI,EAAEd,UAAUC,QAAQW,cAAcC;gBAC5D;gBACAnB;YACF;QACF;QACAqB,WAAUC,IAAI,EAAEC,EAAE,EAAEC,OAAO;YACzB,IAAIA,SAASC,KAAK;gBAChB;YACF;YACA,IAAIH,KAAKZ,QAAQ,CAAC,kBAAkB,CAACa,GAAGb,QAAQ,CAAC,uBAAuB;gBACtE,OAAOY,KAAKL,OAAO,CAAC,qBAAqB;YAC3C;QACF;IACF;AACF"}

package/dist/withPayload/workarounds/reactDomServerInRsc.d.ts

@@ -0,0 +1,27 @@
+import type { PluginOption } from 'vite';
+/**
+ * Provides a working `react-dom/server` inside the RSC environment.
+ *
+ * Payload's version-diff converters (`@payloadcms/richtext-lexical`'s
+ * `field/Diff/converters/*` and `@payloadcms/ui`'s `Version/RenderFieldsToDiff`)
+ * call `renderToStaticMarkup` while rendering a Server Component. In the RSC
+ * environment Vite activates the `react-server` export condition, under which
+ * every `react-dom/server*` subpath resolves to `server.react-server.js` — a
+ * stub that throws `react-dom/server is not supported in React Server
+ * Components`. Force-resolving past the condition isn't enough either: the
+ * static renderer reads the *client* React internals
+ * (`__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE`), which
+ * the `react-server` build of `react` doesn't expose.
+ *
+ * So we pre-bundle a self-contained `react-dom/server` with client React
+ * inlined (esbuild, deliberately WITHOUT the `react-server` condition) and
+ * redirect `react-dom/server` to it in the RSC graph only. The bundle is fully
+ * self-contained, so the RSC environment's `react-server` condition can't
+ * reach into it. JSX elements created by the RSC-graph React stay renderable
+ * because React identifies elements via a process-global `Symbol.for(...)`.
+ *
+ * Delete this once `react-dom/server` (or an equivalent static renderer) is
+ * usable from the `react-server` condition without a separate bundle.
+ */
+export declare function reactDomServerInRsc(): PluginOption;
+//# sourceMappingURL=reactDomServerInRsc.d.ts.map

package/dist/withPayload/workarounds/reactDomServerInRsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactDomServerInRsc.d.ts","sourceRoot":"","sources":["../../../src/withPayload/workarounds/reactDomServerInRsc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAQxC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAyDlD"}

package/dist/withPayload/workarounds/reactDomServerInRsc.js

@@ -0,0 +1,90 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const REACT_DOM_SERVER_RE = /^react-dom\/server(?:\.(?:edge|node|browser))?$/;
+/**
+ * Provides a working `react-dom/server` inside the RSC environment.
+ *
+ * Payload's version-diff converters (`@payloadcms/richtext-lexical`'s
+ * `field/Diff/converters/*` and `@payloadcms/ui`'s `Version/RenderFieldsToDiff`)
+ * call `renderToStaticMarkup` while rendering a Server Component. In the RSC
+ * environment Vite activates the `react-server` export condition, under which
+ * every `react-dom/server*` subpath resolves to `server.react-server.js` — a
+ * stub that throws `react-dom/server is not supported in React Server
+ * Components`. Force-resolving past the condition isn't enough either: the
+ * static renderer reads the *client* React internals
+ * (`__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE`), which
+ * the `react-server` build of `react` doesn't expose.
+ *
+ * So we pre-bundle a self-contained `react-dom/server` with client React
+ * inlined (esbuild, deliberately WITHOUT the `react-server` condition) and
+ * redirect `react-dom/server` to it in the RSC graph only. The bundle is fully
+ * self-contained, so the RSC environment's `react-server` condition can't
+ * reach into it. JSX elements created by the RSC-graph React stay renderable
+ * because React identifies elements via a process-global `Symbol.for(...)`.
+ *
+ * Delete this once `react-dom/server` (or an equivalent static renderer) is
+ * usable from the `react-server` condition without a separate bundle.
+ */ export function reactDomServerInRsc() {
+    const RESOLVED_ID = '\0payload:react-dom-server-rsc';
+    let bundledCode;
+    const buildBundle = ()=>{
+        if (bundledCode !== undefined) {
+            return bundledCode;
+        }
+        // esbuild is always present as a Vite dependency. Typed loosely because it
+        // isn't a direct dependency of this package.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const esbuild = require('esbuild');
+        const result = esbuild.buildSync({
+            banner: {
+                // The bundled CJS React DOM server build does `require('util')` etc.
+                // esbuild's ESM output otherwise emits a stub that throws "Dynamic
+                // require of ... is not supported" inside Vite's module runner, so wire
+                // up a real `require` for Node built-ins.
+                js: "import { createRequire as __pl_cr } from 'node:module';const require = __pl_cr(import.meta.url);"
+            },
+            bundle: true,
+            // Resolve react/react-dom to their CLIENT builds — NOT the `react-server`
+            // condition the RSC environment would otherwise apply.
+            conditions: [
+                'node',
+                'import',
+                'default'
+            ],
+            define: {
+                'process.env.NODE_ENV': JSON.stringify('production')
+            },
+            format: 'esm',
+            platform: 'node',
+            stdin: {
+                contents: [
+                    "import * as ReactDOMServer from 'react-dom/server'",
+                    "export * from 'react-dom/server'",
+                    'export default ReactDOMServer'
+                ].join('\n'),
+                loader: 'js',
+                resolveDir: process.cwd()
+            },
+            write: false
+        });
+        const code = result.outputFiles[0].text;
+        bundledCode = code;
+        return code;
+    };
+    return {
+        name: 'payload:react-dom-server-in-rsc',
+        enforce: 'pre',
+        load (id) {
+            if (id === RESOLVED_ID) {
+                return buildBundle();
+            }
+        },
+        resolveId (id) {
+            if (this.environment?.name === 'rsc' && REACT_DOM_SERVER_RE.test(id)) {
+                return RESOLVED_ID;
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=reactDomServerInRsc.js.map

package/dist/withPayload/workarounds/reactDomServerInRsc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/withPayload/workarounds/reactDomServerInRsc.ts"],"sourcesContent":["import type { PluginOption } from 'vite'\n\nimport { createRequire } from 'node:module'\n\nconst require = createRequire(import.meta.url)\n\nconst REACT_DOM_SERVER_RE = /^react-dom\\/server(?:\\.(?:edge|node|browser))?$/\n\n/**\n * Provides a working `react-dom/server` inside the RSC environment.\n *\n * Payload's version-diff converters (`@payloadcms/richtext-lexical`'s\n * `field/Diff/converters/*` and `@payloadcms/ui`'s `Version/RenderFieldsToDiff`)\n * call `renderToStaticMarkup` while rendering a Server Component. In the RSC\n * environment Vite activates the `react-server` export condition, under which\n * every `react-dom/server*` subpath resolves to `server.react-server.js` — a\n * stub that throws `react-dom/server is not supported in React Server\n * Components`. Force-resolving past the condition isn't enough either: the\n * static renderer reads the *client* React internals\n * (`__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE`), which\n * the `react-server` build of `react` doesn't expose.\n *\n * So we pre-bundle a self-contained `react-dom/server` with client React\n * inlined (esbuild, deliberately WITHOUT the `react-server` condition) and\n * redirect `react-dom/server` to it in the RSC graph only. The bundle is fully\n * self-contained, so the RSC environment's `react-server` condition can't\n * reach into it. JSX elements created by the RSC-graph React stay renderable\n * because React identifies elements via a process-global `Symbol.for(...)`.\n *\n * Delete this once `react-dom/server` (or an equivalent static renderer) is\n * usable from the `react-server` condition without a separate bundle.\n */\nexport function reactDomServerInRsc(): PluginOption {\n  const RESOLVED_ID = '\\0payload:react-dom-server-rsc'\n  let bundledCode: string | undefined\n\n  const buildBundle = (): string => {\n    if (bundledCode !== undefined) {\n      return bundledCode\n    }\n    // esbuild is always present as a Vite dependency. Typed loosely because it\n    // isn't a direct dependency of this package.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const esbuild: any = require('esbuild')\n    const result = esbuild.buildSync({\n      banner: {\n        // The bundled CJS React DOM server build does `require('util')` etc.\n        // esbuild's ESM output otherwise emits a stub that throws \"Dynamic\n        // require of ... is not supported\" inside Vite's module runner, so wire\n        // up a real `require` for Node built-ins.\n        js: \"import { createRequire as __pl_cr } from 'node:module';const require = __pl_cr(import.meta.url);\",\n      },\n      bundle: true,\n      // Resolve react/react-dom to their CLIENT builds — NOT the `react-server`\n      // condition the RSC environment would otherwise apply.\n      conditions: ['node', 'import', 'default'],\n      define: { 'process.env.NODE_ENV': JSON.stringify('production') },\n      format: 'esm',\n      platform: 'node',\n      stdin: {\n        contents: [\n          \"import * as ReactDOMServer from 'react-dom/server'\",\n          \"export * from 'react-dom/server'\",\n          'export default ReactDOMServer',\n        ].join('\\n'),\n        loader: 'js',\n        resolveDir: process.cwd(),\n      },\n      write: false,\n    })\n    const code = result.outputFiles[0].text as string\n    bundledCode = code\n    return code\n  }\n\n  return {\n    name: 'payload:react-dom-server-in-rsc',\n    enforce: 'pre',\n    load(id) {\n      if (id === RESOLVED_ID) {\n        return buildBundle()\n      }\n    },\n    resolveId(id) {\n      if ((this as any).environment?.name === 'rsc' && REACT_DOM_SERVER_RE.test(id)) {\n        return RESOLVED_ID\n      }\n    },\n  }\n}\n"],"names":["createRequire","require","url","REACT_DOM_SERVER_RE","reactDomServerInRsc","RESOLVED_ID","bundledCode","buildBundle","undefined","esbuild","result","buildSync","banner","js","bundle","conditions","define","JSON","stringify","format","platform","stdin","contents","join","loader","resolveDir","process","cwd","write","code","outputFiles","text","name","enforce","load","id","resolveId","environment","test"],"mappings":"AAEA,SAASA,aAAa,QAAQ,cAAa;AAE3C,MAAMC,UAAUD,cAAc,YAAYE,GAAG;AAE7C,MAAMC,sBAAsB;AAE5B;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GACD,OAAO,SAASC;IACd,MAAMC,cAAc;IACpB,IAAIC;IAEJ,MAAMC,cAAc;QAClB,IAAID,gBAAgBE,WAAW;YAC7B,OAAOF;QACT;QACA,2EAA2E;QAC3E,6CAA6C;QAC7C,8DAA8D;QAC9D,MAAMG,UAAeR,QAAQ;QAC7B,MAAMS,SAASD,QAAQE,SAAS,CAAC;YAC/BC,QAAQ;gBACN,qEAAqE;gBACrE,mEAAmE;gBACnE,wEAAwE;gBACxE,0CAA0C;gBAC1CC,IAAI;YACN;YACAC,QAAQ;YACR,0EAA0E;YAC1E,uDAAuD;YACvDC,YAAY;gBAAC;gBAAQ;gBAAU;aAAU;YACzCC,QAAQ;gBAAE,wBAAwBC,KAAKC,SAAS,CAAC;YAAc;YAC/DC,QAAQ;YACRC,UAAU;YACVC,OAAO;gBACLC,UAAU;oBACR;oBACA;oBACA;iBACD,CAACC,IAAI,CAAC;gBACPC,QAAQ;gBACRC,YAAYC,QAAQC,GAAG;YACzB;YACAC,OAAO;QACT;QACA,MAAMC,OAAOnB,OAAOoB,WAAW,CAAC,EAAE,CAACC,IAAI;QACvCzB,cAAcuB;QACd,OAAOA;IACT;IAEA,OAAO;QACLG,MAAM;QACNC,SAAS;QACTC,MAAKC,EAAE;YACL,IAAIA,OAAO9B,aAAa;gBACtB,OAAOE;YACT;QACF;QACA6B,WAAUD,EAAE;YACV,IAAI,AAAC,IAAI,CAASE,WAAW,EAAEL,SAAS,SAAS7B,oBAAoBmC,IAAI,CAACH,KAAK;gBAC7E,OAAO9B;YACT;QACF;IACF;AACF"}

package/dist/withPayload/workarounds/stripDistStyleImports.d.ts

@@ -0,0 +1,21 @@
+import type { PluginOption } from 'vite';
+/**
+ * Stops Vite (and the underlying Node ESM loader) from trying to load
+ * SCSS/CSS/LESS during SSR/RSC when the importer lives inside a built
+ * `dist/` directory or when the specifier is a bare package name.
+ *
+ * We do this two ways, because either layer can fail:
+ *
+ * 1. `resolveId` redirects style specifiers to a virtual empty module —
+ *    handles cases where Vite asks us to resolve them.
+ * 2. `transform` strips top-level `import './x.css'` statements out of any
+ *    JS/TS file living under `node_modules/.../dist/` for non-client envs.
+ *    This is the bulletproof path for prod-packed `@payloadcms/ui` (and
+ *    similar) dependencies that get pre-bundled by Vite's SSR/RSC dep
+ *    optimizer (esbuild). Esbuild preserves `.css` import statements as-is,
+ *    and Node's native ESM loader then crashes with
+ *    `Unknown file extension ".css"`. Removing them at the source avoids
+ *    that entirely.
+ */
+export declare function ssrStripDistStyleImports(): PluginOption;
+//# sourceMappingURL=stripDistStyleImports.d.ts.map

package/dist/withPayload/workarounds/stripDistStyleImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripDistStyleImports.d.ts","sourceRoot":"","sources":["../../../src/withPayload/workarounds/stripDistStyleImports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAsDxC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CAyEvD"}

package/dist/withPayload/workarounds/stripDistStyleImports.js

@@ -0,0 +1,140 @@
+const STYLE_EXTENSION_RE = /\.(?:s?css|less)$/i;
+/**
+ * Static `import './foo.css'` (or .scss/.less) — top-level only.
+ * Captures the entire statement so we can replace it with an empty line.
+ *
+ * Matches:
+ *   import './foo.css';
+ *   import "../bar.scss"
+ *   import   './baz.less' ;
+ */ const STATIC_STYLE_IMPORT_RE = /^[ \t]*import\s+['"][^'"]+\.(?:s?css|less)['"]\s*(?:;[ \t]*)?$/gm;
+/**
+ * Monorepo Payload package source, e.g. `…/packages/ui/src/…`. In the
+ * core-dev / test setup Payload packages resolve to their workspace `src`
+ * (not a published `dist`), so the `dist/` rule below doesn't cover them and
+ * their `.css` side-effect imports survive into the SSR/RSC graph.
+ */ const PAYLOAD_PKG_SRC_RE = /\/packages\/[^/]+\/src\//;
+/**
+ * The version-diff component trees — matched in either published `dist/` or
+ * workspace `src/` form. The `.css` side-effect imports of these must be
+ * stripped in the RSC env (the rest of `@payloadcms/ui` must NOT be — see the
+ * note in `resolveId`/`transform` below), for two reasons rooted in the same
+ * `@vitejs/plugin-rsc` behaviour: it wraps every exported CSS-importing
+ * component with an async CSS-collector child
+ * (`__vite_rsc_wrap_css__` → `await import('virtual:vite-rsc/css?…')`).
+ *
+ * 1. Correctness: the diff converters render `CheckIcon` (`icons/*`) and `File`
+ *    (`graphics/*`) through the SYNCHRONOUS `renderToStaticMarkup` (see
+ *    `reactDomServerInRsc`). The async wrapper suspends, crashing that render
+ *    with "A component suspended while responding to synchronous input" and
+ *    taking down the entire field-diffs tree.
+ * 2. Performance: the diff view (`views/Version/*` — `RenderFieldsToDiff` and
+ *    its per-field components, `DiffCollapser`, `SelectComparison`, the
+ *    `Default` template — plus the `HTMLDiff`/`FieldDiffContainer`/
+ *    `FieldDiffLabel` elements and lexical's `field/Diff/*`) renders dozens of
+ *    these wrapped components in the Flight stream. Each async CSS import
+ *    serializes a round-trip, ballooning the render from ~3s to ~25s and
+ *    blowing past the e2e waits. Stripping them collapses it back to ~3s.
+ *
+ * Safe because every one of these components' styles also ship in the global
+ * `@payloadcms/ui/css/app.css` the admin imports, so dropping the per-module
+ * RSC collection here changes nothing visually (verified: diff + Nav stay
+ * styled). The admin `Nav` etc. are deliberately excluded — they rely on the
+ * RSC collection and a broad strip leaves them unstyled.
+ */ const DIFF_VIEW_COMPONENT_RE = /@payloadcms\/ui\/(?:dist|src)\/(?:icons|graphics|views\/Version|elements\/(?:HTMLDiff|FieldDiffContainer|FieldDiffLabel))\/|@payloadcms\/richtext-lexical\/(?:dist|src)\/field\/Diff\//;
+/**
+ * Stops Vite (and the underlying Node ESM loader) from trying to load
+ * SCSS/CSS/LESS during SSR/RSC when the importer lives inside a built
+ * `dist/` directory or when the specifier is a bare package name.
+ *
+ * We do this two ways, because either layer can fail:
+ *
+ * 1. `resolveId` redirects style specifiers to a virtual empty module —
+ *    handles cases where Vite asks us to resolve them.
+ * 2. `transform` strips top-level `import './x.css'` statements out of any
+ *    JS/TS file living under `node_modules/.../dist/` for non-client envs.
+ *    This is the bulletproof path for prod-packed `@payloadcms/ui` (and
+ *    similar) dependencies that get pre-bundled by Vite's SSR/RSC dep
+ *    optimizer (esbuild). Esbuild preserves `.css` import statements as-is,
+ *    and Node's native ESM loader then crashes with
+ *    `Unknown file extension ".css"`. Removing them at the source avoids
+ *    that entirely.
+ */ export function ssrStripDistStyleImports() {
+    return {
+        name: 'payload:ssr-strip-dist-style-imports',
+        enforce: 'pre',
+        load (id) {
+            if (id === '\0ssr-empty-style') {
+                return '';
+            }
+        },
+        resolveId (id, importer, options) {
+            const envName = this.environment?.name;
+            const isServerEnv = options?.ssr || envName && envName !== 'client';
+            if (!isServerEnv) {
+                return;
+            }
+            // Do NOT strip in the RSC environment. Server components (e.g. the admin
+            // `Nav`, a non-'use client' component that `import './index.css'`) render
+            // in the RSC graph, and `@vitejs/plugin-rsc` must SEE their `.css` imports
+            // there to collect them as client stylesheets. Stripping them here means
+            // their CSS is never emitted and the admin renders unstyled (broken nav
+            // scroll/layout, etc.). The Node-side `.css` no-op is handled by
+            // the test dev server's asset loader and by Vite's CSS extraction (build), so the
+            // crash this plugin guards against does not require touching the RSC env.
+            if (envName === 'rsc') {
+                return;
+            }
+            if (!STYLE_EXTENSION_RE.test(id)) {
+                return;
+            }
+            if (importer && (/\/dist\//.test(importer) || PAYLOAD_PKG_SRC_RE.test(importer))) {
+                return '\0ssr-empty-style';
+            }
+            if (/^@?[a-z]/.test(id) && !id.startsWith('.') && !id.startsWith('/')) {
+                return '\0ssr-empty-style';
+            }
+        },
+        transform (code, id) {
+            const envName = this.environment?.name;
+            const isServerEnv = envName && envName !== 'client';
+            if (!isServerEnv) {
+                return;
+            }
+            // In the RSC env, only strip from the version-diff component trees (see
+            // `DIFF_VIEW_COMPONENT_RE`). Every other server component (the admin
+            // `Nav`, etc.) must keep its `.css` import so plugin-rsc can collect it —
+            // see the matching note in `resolveId` above.
+            if (envName === 'rsc' && !DIFF_VIEW_COMPONENT_RE.test(id)) {
+                return;
+            }
+            // Only touch Payload dependency files: published `node_modules/.../dist/`
+            // builds, or workspace `…/packages/<pkg>/src/…` sources in the core-dev /
+            // test setup. Don't strip from the consumer's own app source — devs may
+            // legitimately want SSR-rendered <link>s from their own CSS imports.
+            const isPayloadDistFile = /\/node_modules\//.test(id) && /\/dist\//.test(id);
+            const isPayloadSrcFile = PAYLOAD_PKG_SRC_RE.test(id);
+            if (!isPayloadDistFile && !isPayloadSrcFile) {
+                return;
+            }
+            // Allow a trailing query (`?v=…`, `?t=…`): Vite appends version/timestamp
+            // queries to module ids, especially in the RSC graph, so a strict `$`
+            // anchor would skip e.g. `icons/Check/index.js?v=83de8543`.
+            if (!/\.[mc]?[jt]sx?(?:$|\?)/.test(id)) {
+                return;
+            }
+            if (!STATIC_STYLE_IMPORT_RE.test(code)) {
+                STATIC_STYLE_IMPORT_RE.lastIndex = 0;
+                return;
+            }
+            STATIC_STYLE_IMPORT_RE.lastIndex = 0;
+            const stripped = code.replace(STATIC_STYLE_IMPORT_RE, '');
+            return {
+                code: stripped,
+                map: null
+            };
+        }
+    };
+}
+
+//# sourceMappingURL=stripDistStyleImports.js.map

package/dist/withPayload/workarounds/stripDistStyleImports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/withPayload/workarounds/stripDistStyleImports.ts"],"sourcesContent":["import type { PluginOption } from 'vite'\n\nconst STYLE_EXTENSION_RE = /\\.(?:s?css|less)$/i\n\n/**\n * Static `import './foo.css'` (or .scss/.less) — top-level only.\n * Captures the entire statement so we can replace it with an empty line.\n *\n * Matches:\n *   import './foo.css';\n *   import \"../bar.scss\"\n *   import   './baz.less' ;\n */\nconst STATIC_STYLE_IMPORT_RE = /^[ \\t]*import\\s+['\"][^'\"]+\\.(?:s?css|less)['\"]\\s*(?:;[ \\t]*)?$/gm\n\n/**\n * Monorepo Payload package source, e.g. `…/packages/ui/src/…`. In the\n * core-dev / test setup Payload packages resolve to their workspace `src`\n * (not a published `dist`), so the `dist/` rule below doesn't cover them and\n * their `.css` side-effect imports survive into the SSR/RSC graph.\n */\nconst PAYLOAD_PKG_SRC_RE = /\\/packages\\/[^/]+\\/src\\//\n\n/**\n * The version-diff component trees — matched in either published `dist/` or\n * workspace `src/` form. The `.css` side-effect imports of these must be\n * stripped in the RSC env (the rest of `@payloadcms/ui` must NOT be — see the\n * note in `resolveId`/`transform` below), for two reasons rooted in the same\n * `@vitejs/plugin-rsc` behaviour: it wraps every exported CSS-importing\n * component with an async CSS-collector child\n * (`__vite_rsc_wrap_css__` → `await import('virtual:vite-rsc/css?…')`).\n *\n * 1. Correctness: the diff converters render `CheckIcon` (`icons/*`) and `File`\n *    (`graphics/*`) through the SYNCHRONOUS `renderToStaticMarkup` (see\n *    `reactDomServerInRsc`). The async wrapper suspends, crashing that render\n *    with \"A component suspended while responding to synchronous input\" and\n *    taking down the entire field-diffs tree.\n * 2. Performance: the diff view (`views/Version/*` — `RenderFieldsToDiff` and\n *    its per-field components, `DiffCollapser`, `SelectComparison`, the\n *    `Default` template — plus the `HTMLDiff`/`FieldDiffContainer`/\n *    `FieldDiffLabel` elements and lexical's `field/Diff/*`) renders dozens of\n *    these wrapped components in the Flight stream. Each async CSS import\n *    serializes a round-trip, ballooning the render from ~3s to ~25s and\n *    blowing past the e2e waits. Stripping them collapses it back to ~3s.\n *\n * Safe because every one of these components' styles also ship in the global\n * `@payloadcms/ui/css/app.css` the admin imports, so dropping the per-module\n * RSC collection here changes nothing visually (verified: diff + Nav stay\n * styled). The admin `Nav` etc. are deliberately excluded — they rely on the\n * RSC collection and a broad strip leaves them unstyled.\n */\nconst DIFF_VIEW_COMPONENT_RE =\n  /@payloadcms\\/ui\\/(?:dist|src)\\/(?:icons|graphics|views\\/Version|elements\\/(?:HTMLDiff|FieldDiffContainer|FieldDiffLabel))\\/|@payloadcms\\/richtext-lexical\\/(?:dist|src)\\/field\\/Diff\\//\n\n/**\n * Stops Vite (and the underlying Node ESM loader) from trying to load\n * SCSS/CSS/LESS during SSR/RSC when the importer lives inside a built\n * `dist/` directory or when the specifier is a bare package name.\n *\n * We do this two ways, because either layer can fail:\n *\n * 1. `resolveId` redirects style specifiers to a virtual empty module —\n *    handles cases where Vite asks us to resolve them.\n * 2. `transform` strips top-level `import './x.css'` statements out of any\n *    JS/TS file living under `node_modules/.../dist/` for non-client envs.\n *    This is the bulletproof path for prod-packed `@payloadcms/ui` (and\n *    similar) dependencies that get pre-bundled by Vite's SSR/RSC dep\n *    optimizer (esbuild). Esbuild preserves `.css` import statements as-is,\n *    and Node's native ESM loader then crashes with\n *    `Unknown file extension \".css\"`. Removing them at the source avoids\n *    that entirely.\n */\nexport function ssrStripDistStyleImports(): PluginOption {\n  return {\n    name: 'payload:ssr-strip-dist-style-imports',\n    enforce: 'pre',\n    load(id) {\n      if (id === '\\0ssr-empty-style') {\n        return ''\n      }\n    },\n    resolveId(id, importer, options) {\n      const envName = (this as any).environment?.name as string | undefined\n      const isServerEnv = options?.ssr || (envName && envName !== 'client')\n      if (!isServerEnv) {\n        return\n      }\n      // Do NOT strip in the RSC environment. Server components (e.g. the admin\n      // `Nav`, a non-'use client' component that `import './index.css'`) render\n      // in the RSC graph, and `@vitejs/plugin-rsc` must SEE their `.css` imports\n      // there to collect them as client stylesheets. Stripping them here means\n      // their CSS is never emitted and the admin renders unstyled (broken nav\n      // scroll/layout, etc.). The Node-side `.css` no-op is handled by\n      // the test dev server's asset loader and by Vite's CSS extraction (build), so the\n      // crash this plugin guards against does not require touching the RSC env.\n      if (envName === 'rsc') {\n        return\n      }\n      if (!STYLE_EXTENSION_RE.test(id)) {\n        return\n      }\n      if (importer && (/\\/dist\\//.test(importer) || PAYLOAD_PKG_SRC_RE.test(importer))) {\n        return '\\0ssr-empty-style'\n      }\n      if (/^@?[a-z]/.test(id) && !id.startsWith('.') && !id.startsWith('/')) {\n        return '\\0ssr-empty-style'\n      }\n    },\n    transform(code, id) {\n      const envName = (this as any).environment?.name as string | undefined\n      const isServerEnv = envName && envName !== 'client'\n      if (!isServerEnv) {\n        return\n      }\n      // In the RSC env, only strip from the version-diff component trees (see\n      // `DIFF_VIEW_COMPONENT_RE`). Every other server component (the admin\n      // `Nav`, etc.) must keep its `.css` import so plugin-rsc can collect it —\n      // see the matching note in `resolveId` above.\n      if (envName === 'rsc' && !DIFF_VIEW_COMPONENT_RE.test(id)) {\n        return\n      }\n      // Only touch Payload dependency files: published `node_modules/.../dist/`\n      // builds, or workspace `…/packages/<pkg>/src/…` sources in the core-dev /\n      // test setup. Don't strip from the consumer's own app source — devs may\n      // legitimately want SSR-rendered <link>s from their own CSS imports.\n      const isPayloadDistFile = /\\/node_modules\\//.test(id) && /\\/dist\\//.test(id)\n      const isPayloadSrcFile = PAYLOAD_PKG_SRC_RE.test(id)\n      if (!isPayloadDistFile && !isPayloadSrcFile) {\n        return\n      }\n      // Allow a trailing query (`?v=…`, `?t=…`): Vite appends version/timestamp\n      // queries to module ids, especially in the RSC graph, so a strict `$`\n      // anchor would skip e.g. `icons/Check/index.js?v=83de8543`.\n      if (!/\\.[mc]?[jt]sx?(?:$|\\?)/.test(id)) {\n        return\n      }\n      if (!STATIC_STYLE_IMPORT_RE.test(code)) {\n        STATIC_STYLE_IMPORT_RE.lastIndex = 0\n        return\n      }\n      STATIC_STYLE_IMPORT_RE.lastIndex = 0\n      const stripped = code.replace(STATIC_STYLE_IMPORT_RE, '')\n      return { code: stripped, map: null }\n    },\n  }\n}\n"],"names":["STYLE_EXTENSION_RE","STATIC_STYLE_IMPORT_RE","PAYLOAD_PKG_SRC_RE","DIFF_VIEW_COMPONENT_RE","ssrStripDistStyleImports","name","enforce","load","id","resolveId","importer","options","envName","environment","isServerEnv","ssr","test","startsWith","transform","code","isPayloadDistFile","isPayloadSrcFile","lastIndex","stripped","replace","map"],"mappings":"AAEA,MAAMA,qBAAqB;AAE3B;;;;;;;;CAQC,GACD,MAAMC,yBAAyB;AAE/B;;;;;CAKC,GACD,MAAMC,qBAAqB;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,MAAMC,yBACJ;AAEF;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASC;IACd,OAAO;QACLC,MAAM;QACNC,SAAS;QACTC,MAAKC,EAAE;YACL,IAAIA,OAAO,qBAAqB;gBAC9B,OAAO;YACT;QACF;QACAC,WAAUD,EAAE,EAAEE,QAAQ,EAAEC,OAAO;YAC7B,MAAMC,UAAU,AAAC,IAAI,CAASC,WAAW,EAAER;YAC3C,MAAMS,cAAcH,SAASI,OAAQH,WAAWA,YAAY;YAC5D,IAAI,CAACE,aAAa;gBAChB;YACF;YACA,yEAAyE;YACzE,0EAA0E;YAC1E,2EAA2E;YAC3E,yEAAyE;YACzE,wEAAwE;YACxE,iEAAiE;YACjE,kFAAkF;YAClF,0EAA0E;YAC1E,IAAIF,YAAY,OAAO;gBACrB;YACF;YACA,IAAI,CAACZ,mBAAmBgB,IAAI,CAACR,KAAK;gBAChC;YACF;YACA,IAAIE,YAAa,CAAA,WAAWM,IAAI,CAACN,aAAaR,mBAAmBc,IAAI,CAACN,SAAQ,GAAI;gBAChF,OAAO;YACT;YACA,IAAI,WAAWM,IAAI,CAACR,OAAO,CAACA,GAAGS,UAAU,CAAC,QAAQ,CAACT,GAAGS,UAAU,CAAC,MAAM;gBACrE,OAAO;YACT;QACF;QACAC,WAAUC,IAAI,EAAEX,EAAE;YAChB,MAAMI,UAAU,AAAC,IAAI,CAASC,WAAW,EAAER;YAC3C,MAAMS,cAAcF,WAAWA,YAAY;YAC3C,IAAI,CAACE,aAAa;gBAChB;YACF;YACA,wEAAwE;YACxE,qEAAqE;YACrE,0EAA0E;YAC1E,8CAA8C;YAC9C,IAAIF,YAAY,SAAS,CAACT,uBAAuBa,IAAI,CAACR,KAAK;gBACzD;YACF;YACA,0EAA0E;YAC1E,0EAA0E;YAC1E,wEAAwE;YACxE,qEAAqE;YACrE,MAAMY,oBAAoB,mBAAmBJ,IAAI,CAACR,OAAO,WAAWQ,IAAI,CAACR;YACzE,MAAMa,mBAAmBnB,mBAAmBc,IAAI,CAACR;YACjD,IAAI,CAACY,qBAAqB,CAACC,kBAAkB;gBAC3C;YACF;YACA,0EAA0E;YAC1E,sEAAsE;YACtE,4DAA4D;YAC5D,IAAI,CAAC,yBAAyBL,IAAI,CAACR,KAAK;gBACtC;YACF;YACA,IAAI,CAACP,uBAAuBe,IAAI,CAACG,OAAO;gBACtClB,uBAAuBqB,SAAS,GAAG;gBACnC;YACF;YACArB,uBAAuBqB,SAAS,GAAG;YACnC,MAAMC,WAAWJ,KAAKK,OAAO,CAACvB,wBAAwB;YACtD,OAAO;gBAAEkB,MAAMI;gBAAUE,KAAK;YAAK;QACrC;IACF;AACF"}

package/dist/withPayload/workarounds/stubPrettierInClient.d.ts

@@ -0,0 +1,13 @@
+import type { PluginOption } from 'vite';
+/**
+ * Stubs `prettier` in the CLIENT bundle only.
+ *
+ * `payload`'s barrel transitively pulls `json-schema-to-typescript` → `prettier`
+ * (CommonJS) into the client graph. That path is type-gen only and never runs in
+ * the browser, but the bundler still drags in `prettier`'s `index.cjs`, which
+ * fails to parse as ESM and breaks the client build. SSR/RSC keep real prettier.
+ *
+ * Delete once `payload`'s barrel no longer reaches type-gen from the client graph.
+ */
+export declare function stubPrettierInClient(): PluginOption;
+//# sourceMappingURL=stubPrettierInClient.d.ts.map

package/dist/withPayload/workarounds/stubPrettierInClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubPrettierInClient.d.ts","sourceRoot":"","sources":["../../../src/withPayload/workarounds/stubPrettierInClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAqBnD"}

package/dist/withPayload/workarounds/stubPrettierInClient.js

@@ -0,0 +1,32 @@
+/**
+ * Stubs `prettier` in the CLIENT bundle only.
+ *
+ * `payload`'s barrel transitively pulls `json-schema-to-typescript` → `prettier`
+ * (CommonJS) into the client graph. That path is type-gen only and never runs in
+ * the browser, but the bundler still drags in `prettier`'s `index.cjs`, which
+ * fails to parse as ESM and breaks the client build. SSR/RSC keep real prettier.
+ *
+ * Delete once `payload`'s barrel no longer reaches type-gen from the client graph.
+ */ export function stubPrettierInClient() {
+    const RESOLVED_ID = '\0payload:prettier-client-stub';
+    return {
+        name: 'payload:stub-prettier-in-client',
+        enforce: 'pre',
+        load (id) {
+            if (id === RESOLVED_ID) {
+                return 'export const format = (source) => source;\nexport default { format };';
+            }
+        },
+        resolveId (id, importer, options) {
+            if (options?.ssr) {
+                return;
+            }
+            // Only stub the type-gen import; leave a host's own client `prettier` alone.
+            if (id === 'prettier' && importer?.includes('json-schema-to-typescript')) {
+                return RESOLVED_ID;
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=stubPrettierInClient.js.map

package/dist/withPayload/workarounds/stubPrettierInClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/withPayload/workarounds/stubPrettierInClient.ts"],"sourcesContent":["import type { PluginOption } from 'vite'\n\n/**\n * Stubs `prettier` in the CLIENT bundle only.\n *\n * `payload`'s barrel transitively pulls `json-schema-to-typescript` → `prettier`\n * (CommonJS) into the client graph. That path is type-gen only and never runs in\n * the browser, but the bundler still drags in `prettier`'s `index.cjs`, which\n * fails to parse as ESM and breaks the client build. SSR/RSC keep real prettier.\n *\n * Delete once `payload`'s barrel no longer reaches type-gen from the client graph.\n */\nexport function stubPrettierInClient(): PluginOption {\n  const RESOLVED_ID = '\\0payload:prettier-client-stub'\n\n  return {\n    name: 'payload:stub-prettier-in-client',\n    enforce: 'pre',\n    load(id) {\n      if (id === RESOLVED_ID) {\n        return 'export const format = (source) => source;\\nexport default { format };'\n      }\n    },\n    resolveId(id, importer, options) {\n      if (options?.ssr) {\n        return\n      }\n      // Only stub the type-gen import; leave a host's own client `prettier` alone.\n      if (id === 'prettier' && importer?.includes('json-schema-to-typescript')) {\n        return RESOLVED_ID\n      }\n    },\n  }\n}\n"],"names":["stubPrettierInClient","RESOLVED_ID","name","enforce","load","id","resolveId","importer","options","ssr","includes"],"mappings":"AAEA;;;;;;;;;CASC,GACD,OAAO,SAASA;IACd,MAAMC,cAAc;IAEpB,OAAO;QACLC,MAAM;QACNC,SAAS;QACTC,MAAKC,EAAE;YACL,IAAIA,OAAOJ,aAAa;gBACtB,OAAO;YACT;QACF;QACAK,WAAUD,EAAE,EAAEE,QAAQ,EAAEC,OAAO;YAC7B,IAAIA,SAASC,KAAK;gBAChB;YACF;YACA,6EAA6E;YAC7E,IAAIJ,OAAO,cAAcE,UAAUG,SAAS,8BAA8B;gBACxE,OAAOT;YACT;QACF;IACF;AACF"}