@payloadcms/tanstack-start 4.0.0-canary.8

package/dist/vite/importProtection.js

@@ -0,0 +1,54 @@
+import { builtinModules } from 'node:module';
+/**
+ * Specifiers that must never appear in the client module graph. These are the
+ * server-only Payload entry points plus Node.js built-ins and a handful of
+ * Node-only npm packages that Payload pulls in transitively.
+ */ export const serverOnlyClientSpecifiers = [
+    /^node:/,
+    new RegExp(`^(${builtinModules.join('|')})(\\/|$)`),
+    '@payload-config',
+    /^@payloadcms\/next\/rsc/,
+    /^@payloadcms\/richtext-lexical\/rsc/,
+    /^@payloadcms\/richtext-slate\/rsc/,
+    '@payloadcms/ui/server',
+    /^@payloadcms\/tanstack-start\/(layouts|rsc|server|views\/server)/,
+    'sharp',
+    'busboy',
+    'croner',
+    'pino',
+    'pino-pretty',
+    'prompts',
+    'ws',
+    'undici',
+    'get-tsconfig',
+    /^file-type/,
+    /^react-dom\/server/
+];
+/**
+ * Allowlist callback for the `tanstackStart` plugin's import-protection. These
+ * are the legitimate cross-environment imports in our monorepo that we want
+ * to permit even when they appear to cross a server/client boundary.
+ */ export function onImportProtectionViolation(violation) {
+    const info = violation;
+    const allowedClientFileImporters = /\/richtext-lexical\/.*\/exports\/client\/|\/tanstack-start\/.*\/views\/AdminView|\/ui\//;
+    if (info.envType === 'server' && info.resolved?.includes('.client.') && allowedClientFileImporters.test(info.importer)) {
+        return false;
+    }
+    if (info.importer.includes('/richtext-lexical/') && info.importer.includes('/field/Diff/')) {
+        return false;
+    }
+    if (info.importer.includes('/packages/payload/') || info.importer.includes('/payload/dist/')) {
+        return false;
+    }
+    if (info.importer.includes('@payloadcms/ui') && (info.importer.includes('/exports/rsc/') || info.importer.includes('/rsc/index'))) {
+        return false;
+    }
+    if (info.envType === 'server' && info.importer.includes('vite-rsc/client-references')) {
+        return false;
+    }
+}
+export const defaultImportProtectionIgnoreImporters = [
+    /^src\/importMap\.js(?:\?.*)?$/
+];
+
+//# sourceMappingURL=importProtection.js.map

package/dist/vite/importProtection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/importProtection.ts"],"sourcesContent":["import { builtinModules } from 'node:module'\n\n/**\n * Specifiers that must never appear in the client module graph. These are the\n * server-only Payload entry points plus Node.js built-ins and a handful of\n * Node-only npm packages that Payload pulls in transitively.\n */\nexport const serverOnlyClientSpecifiers: Array<RegExp | string> = [\n  /^node:/,\n  new RegExp(`^(${builtinModules.join('|')})(\\\\/|$)`),\n  '@payload-config',\n  /^@payloadcms\\/next\\/rsc/,\n  /^@payloadcms\\/richtext-lexical\\/rsc/,\n  /^@payloadcms\\/richtext-slate\\/rsc/,\n  '@payloadcms/ui/server',\n  /^@payloadcms\\/tanstack-start\\/(layouts|rsc|server|views\\/server)/,\n  'sharp',\n  'busboy',\n  'croner',\n  'pino',\n  'pino-pretty',\n  'prompts',\n  'ws',\n  'undici',\n  'get-tsconfig',\n  /^file-type/,\n  /^react-dom\\/server/,\n]\n\n/**\n * Allowlist callback for the `tanstackStart` plugin's import-protection. These\n * are the legitimate cross-environment imports in our monorepo that we want\n * to permit even when they appear to cross a server/client boundary.\n */\nexport function onImportProtectionViolation(violation: unknown): boolean | void {\n  const info = violation as {\n    envType: 'client' | 'server'\n    importer: string\n    resolved?: string\n  }\n\n  const allowedClientFileImporters =\n    /\\/richtext-lexical\\/.*\\/exports\\/client\\/|\\/tanstack-start\\/.*\\/views\\/AdminView|\\/ui\\//\n\n  if (\n    info.envType === 'server' &&\n    info.resolved?.includes('.client.') &&\n    allowedClientFileImporters.test(info.importer)\n  ) {\n    return false\n  }\n\n  if (info.importer.includes('/richtext-lexical/') && info.importer.includes('/field/Diff/')) {\n    return false\n  }\n\n  if (info.importer.includes('/packages/payload/') || info.importer.includes('/payload/dist/')) {\n    return false\n  }\n\n  if (\n    info.importer.includes('@payloadcms/ui') &&\n    (info.importer.includes('/exports/rsc/') || info.importer.includes('/rsc/index'))\n  ) {\n    return false\n  }\n\n  if (info.envType === 'server' && info.importer.includes('vite-rsc/client-references')) {\n    return false\n  }\n}\n\nexport const defaultImportProtectionIgnoreImporters: RegExp[] = [/^src\\/importMap\\.js(?:\\?.*)?$/]\n"],"names":["builtinModules","serverOnlyClientSpecifiers","RegExp","join","onImportProtectionViolation","violation","info","allowedClientFileImporters","envType","resolved","includes","test","importer","defaultImportProtectionIgnoreImporters"],"mappings":"AAAA,SAASA,cAAc,QAAQ,cAAa;AAE5C;;;;CAIC,GACD,OAAO,MAAMC,6BAAqD;IAChE;IACA,IAAIC,OAAO,CAAC,EAAE,EAAEF,eAAeG,IAAI,CAAC,KAAK,QAAQ,CAAC;IAClD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED;;;;CAIC,GACD,OAAO,SAASC,4BAA4BC,SAAkB;IAC5D,MAAMC,OAAOD;IAMb,MAAME,6BACJ;IAEF,IACED,KAAKE,OAAO,KAAK,YACjBF,KAAKG,QAAQ,EAAEC,SAAS,eACxBH,2BAA2BI,IAAI,CAACL,KAAKM,QAAQ,GAC7C;QACA,OAAO;IACT;IAEA,IAAIN,KAAKM,QAAQ,CAACF,QAAQ,CAAC,yBAAyBJ,KAAKM,QAAQ,CAACF,QAAQ,CAAC,iBAAiB;QAC1F,OAAO;IACT;IAEA,IAAIJ,KAAKM,QAAQ,CAACF,QAAQ,CAAC,yBAAyBJ,KAAKM,QAAQ,CAACF,QAAQ,CAAC,mBAAmB;QAC5F,OAAO;IACT;IAEA,IACEJ,KAAKM,QAAQ,CAACF,QAAQ,CAAC,qBACtBJ,CAAAA,KAAKM,QAAQ,CAACF,QAAQ,CAAC,oBAAoBJ,KAAKM,QAAQ,CAACF,QAAQ,CAAC,aAAY,GAC/E;QACA,OAAO;IACT;IAEA,IAAIJ,KAAKE,OAAO,KAAK,YAAYF,KAAKM,QAAQ,CAACF,QAAQ,CAAC,+BAA+B;QACrF,OAAO;IACT;AACF;AAEA,OAAO,MAAMG,yCAAmD;IAAC;CAAgC,CAAA"}

package/dist/vite/plugin.d.ts

@@ -0,0 +1,38 @@
+import type { PluginOption, UserConfigFnObject } from 'vite';
+export interface PayloadPluginOptions {
+    /** Additional resolve aliases */
+    additionalAliases?: Array<{
+        find: RegExp | string;
+        replacement: string;
+    }>;
+    /** Additional import protection ignoreImporters patterns */
+    additionalIgnoreImporters?: RegExp[];
+    /** Extra optimizeDeps.include entries */
+    additionalOptimizeDepsInclude?: string[];
+    /** Extra ssr.external entries */
+    additionalSsrExternal?: string[];
+    /** Path to the user's payload.config.ts (required) */
+    payloadConfigPath: string;
+    /** Extra Vite plugins to include */
+    plugins?: PluginOption[];
+    /** @vitejs/plugin-react instance — must be passed by consumer to ensure correct resolution */
+    reactPlugin: PluginOption;
+    /** TanStack router routes directory relative to srcDirectory. Defaults to 'app' */
+    routesDirectory?: string;
+    /** @vitejs/plugin-rsc instance — required for RSC support, must be passed by consumer */
+    rscPlugin: PluginOption;
+    /** TanStack source directory. Defaults to 'src' */
+    srcDirectory?: string;
+    /** tanstackStart from '@tanstack/react-start/plugin/vite' — must be passed by consumer to ensure correct resolution */
+    tanstackStart: typeof import('@tanstack/react-start/plugin/vite').tanstackStart;
+}
+/**
+ * Vite plugin for Payload + TanStack Start. The Vite-side counterpart to
+ * `withPayload` for Next.js: it configures the Vite environment so the Payload
+ * admin can run, then composes the TanStack Start plugin with two small
+ * Payload-specific workarounds (dev HMR injection, SSR style stripping). Each
+ * remaining workaround lives in its own file under `./plugins/` so it can be
+ * deleted individually once the corresponding upstream fix lands.
+ */
+export declare function payloadPlugin(options: PayloadPluginOptions): UserConfigFnObject;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/vite/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAsB5D,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzE,4DAA4D;IAC5D,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC,yCAAyC;IACzC,6BAA6B,CAAC,EAAE,MAAM,EAAE,CAAA;IACxC,iCAAiC;IACjC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;IAChC,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAA;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,8FAA8F;IAC9F,WAAW,EAAE,YAAY,CAAA;IACzB,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yFAAyF;IACzF,SAAS,EAAE,YAAY,CAAA;IACvB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uHAAuH;IACvH,aAAa,EAAE,cAAc,mCAAmC,EAAE,aAAa,CAAA;CAChF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,CA+H/E"}

package/dist/vite/plugin.js

@@ -0,0 +1,177 @@
+import path from 'node:path';
+import { optimizeDepsExcludeDefaults, optimizeDepsIncludeDefaults, payloadNoExternalPatterns, payloadRscNoExternalPatterns, ssrExternalPackages } from './constants.js';
+import { defaultImportProtectionIgnoreImporters, onImportProtectionViolation, serverOnlyClientSpecifiers } from './importProtection.js';
+import { clientModuleResolution } from './plugins/clientModuleResolution.js';
+import { payloadDevTransforms } from './plugins/devTransforms.js';
+import { reactDomServerInRsc } from './plugins/reactDomServerInRsc.js';
+import { ssrStripDistStyleImports } from './plugins/stripDistStyleImports.js';
+import { wrapCjsForClient } from './plugins/wrapCjsForClient.js';
+/**
+ * Vite plugin for Payload + TanStack Start. The Vite-side counterpart to
+ * `withPayload` for Next.js: it configures the Vite environment so the Payload
+ * admin can run, then composes the TanStack Start plugin with two small
+ * Payload-specific workarounds (dev HMR injection, SSR style stripping). Each
+ * remaining workaround lives in its own file under `./plugins/` so it can be
+ * deleted individually once the corresponding upstream fix lands.
+ */ export function payloadPlugin(options) {
+    const { additionalAliases = [], additionalIgnoreImporters = [], additionalOptimizeDepsInclude = [], additionalSsrExternal = [], payloadConfigPath, plugins: extraPlugins = [], reactPlugin, routesDirectory = 'app', rscPlugin, srcDirectory = 'src', tanstackStart } = options;
+    return (_env)=>({
+            css: {
+                preprocessorOptions: {
+                    scss: {
+                        silenceDeprecations: [
+                            'import',
+                            'global-builtin'
+                        ]
+                    }
+                }
+            },
+            define: {
+                global: 'globalThis'
+            },
+            environments: {
+                rsc: {
+                    resolve: {
+                        noExternal: payloadRscNoExternalPatterns
+                    }
+                },
+                ssr: {
+                    resolve: {
+                        noExternal: payloadNoExternalPatterns
+                    }
+                }
+            },
+            optimizeDeps: {
+                exclude: optimizeDepsExcludeDefaults,
+                include: [
+                    ...optimizeDepsIncludeDefaults,
+                    ...additionalOptimizeDepsInclude
+                ]
+            },
+            plugins: [
+                clientModuleResolution(),
+                wrapCjsForClient(),
+                ssrStripDistStyleImports(),
+                reactDomServerInRsc(),
+                payloadDevTransforms(),
+                rscPlugin,
+                tanstackStart({
+                    importProtection: {
+                        client: {
+                            excludeFiles: [],
+                            specifiers: serverOnlyClientSpecifiers
+                        },
+                        ignoreImporters: [
+                            ...defaultImportProtectionIgnoreImporters,
+                            ...additionalIgnoreImporters
+                        ],
+                        include: [
+                            '**/*'
+                        ],
+                        mockAccess: 'warn',
+                        onViolation: onImportProtectionViolation,
+                        // Disable TanStack Start's default `**/*.client.*` file-based denial in
+                        // the SSR environment. Payload uses the `.client.tsx` filename suffix
+                        // for React Client Components (with a `'use client'` directive) that
+                        // MUST be server-rendered to HTML during SSR. The default rule would
+                        // otherwise replace those files with an `import-protection mock` Proxy
+                        // during SSR, which crashes React (TypeError: Cannot convert object to
+                        // primitive value) the moment React tries to format a warning that
+                        // mentions one of these components.
+                        server: {
+                            files: []
+                        }
+                    },
+                    // Disable TanStack Router's automatic per-route code-splitting.
+                    //
+                    // With splitting enabled each route's `component` is fetched lazily
+                    // via `?tsr-split=component` after the initial SSR HTML is streamed.
+                    // Until that lazy chunk lands the rendered admin tree has no client
+                    // React attached, so any button clicks (e.g. the
+                    // `#toggle-list-filters` chevron in `<ListControls />`) hit a static
+                    // DOM, the click is dropped, and once the chunk finally loads the
+                    // component re-mounts with its initial `useState` instead of the
+                    // toggled value. That single behaviour was the root cause of the
+                    // "page renders but nothing is interactive" tanstack-start E2E
+                    // failures (`#list-controls-where`, `[data-lexical-editor]`, etc.) -
+                    // playwright traces show "Download the React DevTools" landing
+                    // *after* the playwright click, confirming late hydration.
+                    //
+                    // We pass BOTH knobs because `tanstackStart`'s schema silently
+                    // strips the user-supplied `autoCodeSplitting` (its `tsrConfig`
+                    // does `configSchema.omit({ autoCodeSplitting: true, target: true
+                    // })`) and then leaves the value `undefined` — which is fine for
+                    // the conditional inside `unpluginRouterComposedFactory`, but the
+                    // TanStack Start vite plugin *unconditionally* installs the router
+                    // code-splitter via `tanStackRouterCodeSplitter(...)` regardless.
+                    // The only knob that survives all of that and is honoured by the
+                    // splitter is `router.codeSplittingOptions.defaultBehavior` — set
+                    // to an empty array, the splitter still walks each `createFileRoute`
+                    // file but produces no virtual `?tsr-split=...` modules, so every
+                    // route component ships in the initial bundle and hydration starts
+                    // immediately on first paint. We keep `autoCodeSplitting: false` as
+                    // a belt-and-braces signal in case the start plugin ever stops
+                    // dropping it.
+                    //
+                    // Eager-loading routes ships a slightly larger initial bundle but
+                    // makes the admin actually interactive on first paint.
+                    router: {
+                        autoCodeSplitting: false,
+                        codeSplittingOptions: {
+                            defaultBehavior: []
+                        },
+                        // Exclude generated importMap files and colocated server-function
+                        // modules (`*.functions.ts`). Admin form saves are dispatched via
+                        // `runPayloadServerFn` (a TanStack Start `createServerFn`) rather than
+                        // a hand-rolled route, so there is no longer an `api.server-function.ts`
+                        // to special-case here. The `*.functions.ts` shims live next to the
+                        // routes that use them (e.g. `app/_payload/*.functions.ts`); they
+                        // define `createServerFn`s, not routes, so they must not be scanned.
+                        routeFileIgnorePattern: 'importMap\\.(?:js|server\\.ts)$|\\.functions\\.',
+                        routesDirectory
+                    },
+                    rsc: {
+                        enabled: true
+                    },
+                    srcDirectory
+                }),
+                reactPlugin,
+                ...extraPlugins
+            ],
+            resolve: {
+                alias: [
+                    {
+                        find: '@payload-config',
+                        replacement: path.resolve(payloadConfigPath)
+                    },
+                    ...additionalAliases
+                ],
+                dedupe: [
+                    'react',
+                    'react-dom',
+                    'scheduler',
+                    '@payloadcms/ui',
+                    '@payloadcms/richtext-lexical'
+                ],
+                extensions: [
+                    '.mjs',
+                    '.js',
+                    '.mts',
+                    '.ts',
+                    '.jsx',
+                    '.tsx',
+                    '.json'
+                ],
+                tsconfigPaths: true
+            },
+            ssr: {
+                external: [
+                    ...ssrExternalPackages,
+                    ...additionalSsrExternal
+                ],
+                noExternal: payloadNoExternalPatterns
+            }
+        });
+}
+
+//# sourceMappingURL=plugin.js.map

package/dist/vite/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/plugin.ts"],"sourcesContent":["import type { PluginOption, UserConfigFnObject } from 'vite'\n\nimport path from 'node:path'\n\nimport {\n  optimizeDepsExcludeDefaults,\n  optimizeDepsIncludeDefaults,\n  payloadNoExternalPatterns,\n  payloadRscNoExternalPatterns,\n  ssrExternalPackages,\n} from './constants.js'\nimport {\n  defaultImportProtectionIgnoreImporters,\n  onImportProtectionViolation,\n  serverOnlyClientSpecifiers,\n} from './importProtection.js'\nimport { clientModuleResolution } from './plugins/clientModuleResolution.js'\nimport { payloadDevTransforms } from './plugins/devTransforms.js'\nimport { reactDomServerInRsc } from './plugins/reactDomServerInRsc.js'\nimport { ssrStripDistStyleImports } from './plugins/stripDistStyleImports.js'\nimport { wrapCjsForClient } from './plugins/wrapCjsForClient.js'\n\nexport interface PayloadPluginOptions {\n  /** Additional resolve aliases */\n  additionalAliases?: Array<{ find: RegExp | string; replacement: string }>\n  /** Additional import protection ignoreImporters patterns */\n  additionalIgnoreImporters?: RegExp[]\n  /** Extra optimizeDeps.include entries */\n  additionalOptimizeDepsInclude?: string[]\n  /** Extra ssr.external entries */\n  additionalSsrExternal?: string[]\n  /** Path to the user's payload.config.ts (required) */\n  payloadConfigPath: string\n  /** Extra Vite plugins to include */\n  plugins?: PluginOption[]\n  /** @vitejs/plugin-react instance — must be passed by consumer to ensure correct resolution */\n  reactPlugin: PluginOption\n  /** TanStack router routes directory relative to srcDirectory. Defaults to 'app' */\n  routesDirectory?: string\n  /** @vitejs/plugin-rsc instance — required for RSC support, must be passed by consumer */\n  rscPlugin: PluginOption\n  /** TanStack source directory. Defaults to 'src' */\n  srcDirectory?: string\n  /** tanstackStart from '@tanstack/react-start/plugin/vite' — must be passed by consumer to ensure correct resolution */\n  tanstackStart: typeof import('@tanstack/react-start/plugin/vite').tanstackStart\n}\n\n/**\n * Vite plugin for Payload + TanStack Start. The Vite-side counterpart to\n * `withPayload` for Next.js: it configures the Vite environment so the Payload\n * admin can run, then composes the TanStack Start plugin with two small\n * Payload-specific workarounds (dev HMR injection, SSR style stripping). Each\n * remaining workaround lives in its own file under `./plugins/` so it can be\n * deleted individually once the corresponding upstream fix lands.\n */\nexport function payloadPlugin(options: PayloadPluginOptions): UserConfigFnObject {\n  const {\n    additionalAliases = [],\n    additionalIgnoreImporters = [],\n    additionalOptimizeDepsInclude = [],\n    additionalSsrExternal = [],\n    payloadConfigPath,\n    plugins: extraPlugins = [],\n    reactPlugin,\n    routesDirectory = 'app',\n    rscPlugin,\n    srcDirectory = 'src',\n    tanstackStart,\n  } = options\n\n  return (_env) => ({\n    css: {\n      preprocessorOptions: {\n        scss: {\n          silenceDeprecations: ['import', 'global-builtin'],\n        } as any,\n      },\n    },\n    define: {\n      global: 'globalThis',\n    },\n    environments: {\n      rsc: { resolve: { noExternal: payloadRscNoExternalPatterns } },\n      ssr: { resolve: { noExternal: payloadNoExternalPatterns } },\n    } as any,\n    optimizeDeps: {\n      exclude: optimizeDepsExcludeDefaults,\n      include: [...optimizeDepsIncludeDefaults, ...additionalOptimizeDepsInclude],\n    },\n    plugins: [\n      clientModuleResolution(),\n      wrapCjsForClient(),\n      ssrStripDistStyleImports(),\n      reactDomServerInRsc(),\n      payloadDevTransforms(),\n      rscPlugin,\n      tanstackStart({\n        importProtection: {\n          client: { excludeFiles: [], specifiers: serverOnlyClientSpecifiers },\n          ignoreImporters: [\n            ...defaultImportProtectionIgnoreImporters,\n            ...additionalIgnoreImporters,\n          ],\n          include: ['**/*'],\n          mockAccess: 'warn',\n          onViolation: onImportProtectionViolation,\n          // Disable TanStack Start's default `**/*.client.*` file-based denial in\n          // the SSR environment. Payload uses the `.client.tsx` filename suffix\n          // for React Client Components (with a `'use client'` directive) that\n          // MUST be server-rendered to HTML during SSR. The default rule would\n          // otherwise replace those files with an `import-protection mock` Proxy\n          // during SSR, which crashes React (TypeError: Cannot convert object to\n          // primitive value) the moment React tries to format a warning that\n          // mentions one of these components.\n          server: { files: [] },\n        },\n        // Disable TanStack Router's automatic per-route code-splitting.\n        //\n        // With splitting enabled each route's `component` is fetched lazily\n        // via `?tsr-split=component` after the initial SSR HTML is streamed.\n        // Until that lazy chunk lands the rendered admin tree has no client\n        // React attached, so any button clicks (e.g. the\n        // `#toggle-list-filters` chevron in `<ListControls />`) hit a static\n        // DOM, the click is dropped, and once the chunk finally loads the\n        // component re-mounts with its initial `useState` instead of the\n        // toggled value. That single behaviour was the root cause of the\n        // \"page renders but nothing is interactive\" tanstack-start E2E\n        // failures (`#list-controls-where`, `[data-lexical-editor]`, etc.) -\n        // playwright traces show \"Download the React DevTools\" landing\n        // *after* the playwright click, confirming late hydration.\n        //\n        // We pass BOTH knobs because `tanstackStart`'s schema silently\n        // strips the user-supplied `autoCodeSplitting` (its `tsrConfig`\n        // does `configSchema.omit({ autoCodeSplitting: true, target: true\n        // })`) and then leaves the value `undefined` — which is fine for\n        // the conditional inside `unpluginRouterComposedFactory`, but the\n        // TanStack Start vite plugin *unconditionally* installs the router\n        // code-splitter via `tanStackRouterCodeSplitter(...)` regardless.\n        // The only knob that survives all of that and is honoured by the\n        // splitter is `router.codeSplittingOptions.defaultBehavior` — set\n        // to an empty array, the splitter still walks each `createFileRoute`\n        // file but produces no virtual `?tsr-split=...` modules, so every\n        // route component ships in the initial bundle and hydration starts\n        // immediately on first paint. We keep `autoCodeSplitting: false` as\n        // a belt-and-braces signal in case the start plugin ever stops\n        // dropping it.\n        //\n        // Eager-loading routes ships a slightly larger initial bundle but\n        // makes the admin actually interactive on first paint.\n        router: {\n          autoCodeSplitting: false,\n          codeSplittingOptions: { defaultBehavior: [] },\n          // Exclude generated importMap files and colocated server-function\n          // modules (`*.functions.ts`). Admin form saves are dispatched via\n          // `runPayloadServerFn` (a TanStack Start `createServerFn`) rather than\n          // a hand-rolled route, so there is no longer an `api.server-function.ts`\n          // to special-case here. The `*.functions.ts` shims live next to the\n          // routes that use them (e.g. `app/_payload/*.functions.ts`); they\n          // define `createServerFn`s, not routes, so they must not be scanned.\n          routeFileIgnorePattern: 'importMap\\\\.(?:js|server\\\\.ts)$|\\\\.functions\\\\.',\n          routesDirectory,\n        } as any,\n        rsc: { enabled: true },\n        srcDirectory,\n      }),\n      reactPlugin,\n      ...extraPlugins,\n    ],\n    resolve: {\n      alias: [\n        { find: '@payload-config', replacement: path.resolve(payloadConfigPath) },\n        ...additionalAliases,\n      ],\n      dedupe: ['react', 'react-dom', 'scheduler', '@payloadcms/ui', '@payloadcms/richtext-lexical'],\n      extensions: ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'],\n      tsconfigPaths: true,\n    } as any,\n    ssr: {\n      external: [...ssrExternalPackages, ...additionalSsrExternal],\n      noExternal: payloadNoExternalPatterns,\n    },\n  })\n}\n"],"names":["path","optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults","payloadNoExternalPatterns","payloadRscNoExternalPatterns","ssrExternalPackages","defaultImportProtectionIgnoreImporters","onImportProtectionViolation","serverOnlyClientSpecifiers","clientModuleResolution","payloadDevTransforms","reactDomServerInRsc","ssrStripDistStyleImports","wrapCjsForClient","payloadPlugin","options","additionalAliases","additionalIgnoreImporters","additionalOptimizeDepsInclude","additionalSsrExternal","payloadConfigPath","plugins","extraPlugins","reactPlugin","routesDirectory","rscPlugin","srcDirectory","tanstackStart","_env","css","preprocessorOptions","scss","silenceDeprecations","define","global","environments","rsc","resolve","noExternal","ssr","optimizeDeps","exclude","include","importProtection","client","excludeFiles","specifiers","ignoreImporters","mockAccess","onViolation","server","files","router","autoCodeSplitting","codeSplittingOptions","defaultBehavior","routeFileIgnorePattern","enabled","alias","find","replacement","dedupe","extensions","tsconfigPaths","external"],"mappings":"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"}

package/dist/vite/plugins/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/vite/plugins/clientModuleResolution.d.ts.map

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

package/dist/vite/plugins/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/vite/plugins/clientModuleResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/vite/plugins/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/vite/plugins/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/vite/plugins/devTransforms.d.ts.map

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

package/dist/vite/plugins/devTransforms.js

@@ -0,0 +1,67 @@
+/**
+ * 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;
+                    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/vite/plugins/devTransforms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/vite/plugins/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          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,IAAIH,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/vite/plugins/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/vite/plugins/reactDomServerInRsc.d.ts.map

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