@payloadcms/tanstack-start 4.0.0-internal.811e0a4 → 4.0.0-internal.8ba6b5b

package/dist/exports/vite.d.ts

@@ -1,13 +1,3 @@
-import { withPayload } from '../vite/index.js';
-export { withPayload } from '../vite/index.js';
-export type { WithPayloadOptions } from '../vite/index.js';
-/**
- * @deprecated Use `withPayload` instead. `payloadPlugin` is a backwards-compatible
- * alias and will be removed in a future release. Note that the React, RSC, and
- * TanStack Start plugins are now instantiated internally, so the `reactPlugin`,
- * `rscPlugin`, and `tanstackStart` options are no longer required.
- */
-export declare const payloadPlugin: typeof withPayload;
-/** @deprecated Use `WithPayloadOptions` instead. */
-export type { WithPayloadOptions as PayloadPluginOptions } from '../vite/index.js';
+export { payloadReactOptions, payloadRscOptions, payloadTanstackStartOptions, withPayload, } from '../vite/index.js';
+export type { PayloadPluginOptions, PayloadTanstackStartOptionsArgs, WithPayloadBuilder, WithPayloadBuilderContext, WithPayloadOptions, } from '../vite/index.js';
 //# sourceMappingURL=vite.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/exports/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,aAAa,oBAAc,CAAA;AAExC,oDAAoD;AACpD,YAAY,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/exports/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,WAAW,GACZ,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,oBAAoB,EACpB,+BAA+B,EAC/B,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/exports/vite.js

@@ -1,10 +1,3 @@
-import { withPayload } from '../vite/index.js';
-export { withPayload } from '../vite/index.js';
-/**
- * @deprecated Use `withPayload` instead. `payloadPlugin` is a backwards-compatible
- * alias and will be removed in a future release. Note that the React, RSC, and
- * TanStack Start plugins are now instantiated internally, so the `reactPlugin`,
- * `rscPlugin`, and `tanstackStart` options are no longer required.
- */ export const payloadPlugin = withPayload;
+export { payloadReactOptions, payloadRscOptions, payloadTanstackStartOptions, withPayload } from '../vite/index.js';
 
 //# sourceMappingURL=vite.js.map

package/dist/exports/vite.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exports/vite.ts"],"sourcesContent":["import { withPayload } from '../vite/index.js'\n\nexport { withPayload } from '../vite/index.js'\nexport type { WithPayloadOptions } from '../vite/index.js'\n\n/**\n * @deprecated Use `withPayload` instead. `payloadPlugin` is a backwards-compatible\n * alias and will be removed in a future release. Note that the React, RSC, and\n * TanStack Start plugins are now instantiated internally, so the `reactPlugin`,\n * `rscPlugin`, and `tanstackStart` options are no longer required.\n */\nexport const payloadPlugin = withPayload\n\n/** @deprecated Use `WithPayloadOptions` instead. */\nexport type { WithPayloadOptions as PayloadPluginOptions } from '../vite/index.js'\n"],"names":["withPayload","payloadPlugin"],"mappings":"AAAA,SAASA,WAAW,QAAQ,mBAAkB;AAE9C,SAASA,WAAW,QAAQ,mBAAkB;AAG9C;;;;;CAKC,GACD,OAAO,MAAMC,gBAAgBD,YAAW"}
+{"version":3,"sources":["../../src/exports/vite.ts"],"sourcesContent":["export {\n  payloadReactOptions,\n  payloadRscOptions,\n  payloadTanstackStartOptions,\n  withPayload,\n} from '../vite/index.js'\nexport type {\n  PayloadPluginOptions,\n  PayloadTanstackStartOptionsArgs,\n  WithPayloadBuilder,\n  WithPayloadBuilderContext,\n  WithPayloadOptions,\n} from '../vite/index.js'\n"],"names":["payloadReactOptions","payloadRscOptions","payloadTanstackStartOptions","withPayload"],"mappings":"AAAA,SACEA,mBAAmB,EACnBC,iBAAiB,EACjBC,2BAA2B,EAC3BC,WAAW,QACN,mBAAkB"}

package/dist/vite/index.d.ts

@@ -1,55 +1,97 @@
-import type { UserConfig, UserConfigFnObject } from 'vite';
+import type { ConfigEnv, UserConfig, UserConfigFnObject } from 'vite';
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import rsc from '@vitejs/plugin-rsc';
 export type WithPayloadOptions = {
-    /**
-     * Additional import-protection `ignoreImporters` patterns. This is a
-     * Payload-specific knob on the TanStack Start plugin, so it cannot be
-     * expressed through `vite` — pass it here.
-     */
+    /** Extra import-protection `ignoreImporters` patterns for the TanStack Start plugin. */
     additionalIgnoreImporters?: RegExp[];
+    /** Route id of Payload's admin layout, eager-loaded instead of code-split. Defaults to `'/_payload'`. */
+    adminRouteId?: string;
+    /** Extra globs exempted from the `.client.*` SSR denial (beyond the default node_modules exemption). */
+    clientDenialExcludeFiles?: string[];
     /** Path to the user's `payload.config.ts` (required) */
     payloadConfigPath: string;
     /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'` */
     routesDirectory?: string;
-    /**
-     * Silence Vite warnings about third-party dependency sourcemaps pointing to
-     * missing source files — noise Payload consumers can't act on. Defaults to
-     * `true`; set `false` to see them. Composes with a `vite.customLogger`.
-     */
+    /** Silence Vite warnings about third-party dependency sourcemaps. Defaults to `true`. */
     silenceDependencyWarnings?: boolean;
     /** TanStack source directory. Defaults to `'src'` */
     srcDirectory?: string;
-    /**
-     * Extra Vite config merged on top of the Payload defaults via Vite's own
-     * `mergeConfig`. Objects are deep-merged and arrays are appended, so this is
-     * the single hook for everything a consumer used to reach through separate
-     * options: extra `plugins`, `resolve.alias` entries, `optimizeDeps.include`,
-     * `ssr.external`, `server`, `build`, and so on.
-     *
-     * @example
-     * withPayload({
-     *   payloadConfigPath: './src/payload.config.ts',
-     *   vite: { server: { port: 4000 } },
-     * })
-     */
+    /** Extra Vite config deep-merged over the Payload defaults. Ignored in `build` mode. */
     vite?: UserConfig;
 };
+/** The options Payload's admin requires for each third-party plugin. */
+export type PayloadPluginOptions = {
+    react: NonNullable<Parameters<typeof viteReact>[0]>;
+    rsc: NonNullable<Parameters<typeof rsc>[0]>;
+    tanstackStart: NonNullable<Parameters<typeof tanstackStart>[0]>;
+};
+export type WithPayloadBuilderContext = {
+    /** Payload's base Vite config; `plugins` holds Payload's workaround plugins only. */
+    config: UserConfig;
+    env: ConfigEnv;
+    /** Options to pass to the `viteReact`/`rsc`/`tanstackStart` factories you import. */
+    pluginOptions: PayloadPluginOptions;
+};
+/** Assembles the final Vite config from Payload's base config and plugin options. */
+export type WithPayloadBuilder = (context: WithPayloadBuilderContext) => UserConfig;
 /**
- * Vite config helper for Payload + TanStack Start. The Vite-side counterpart to
- * `withPayload` for Next.js: it owns the whole Vite setup needed to run the
- * Payload admin — the RSC, React, and TanStack Start plugins plus a small set of
- * Payload-specific workarounds — so a consumer's `vite.config.ts` collapses to:
+ * Vite config helper for Payload + TanStack Start; the counterpart to Next.js'
+ * `withPayload`.
  *
- * ```ts
- * import { withPayload } from '@payloadcms/tanstack-start/vite'
+ * Zero-config — Payload instantiates the RSC, React, and TanStack Start plugins:
  *
- * export default withPayload({ payloadConfigPath: './src/payload.config.ts' })
+ * ```ts
+ * export default withPayload(undefined, { payloadConfigPath: './src/payload.config.ts' })
  * ```
  *
- * The React (`@vitejs/plugin-react`), RSC (`@vitejs/plugin-rsc`), and TanStack
- * Start plugins are instantiated internally with the settings the admin
- * requires — consumers no longer pass them in. Each remaining Payload
- * workaround lives in its own file under `./workarounds/` so it can be deleted
- * individually once the corresponding upstream fix lands.
+ * Guest mode — pass a `build` callback to instantiate them yourself (one copy of
+ * each; `@vitejs/plugin-rsc` is a hard singleton):
+ *
+ * ```ts
+ * export default withPayload(
+ *   ({ config, pluginOptions }) => ({
+ *     ...config,
+ *     plugins: [
+ *       ...config.plugins,
+ *       rsc(pluginOptions.rsc),
+ *       tanstackStart(pluginOptions.tanstackStart),
+ *       viteReact(pluginOptions.react),
+ *     ],
+ *   }),
+ *   { payloadConfigPath: './src/payload.config.ts' },
+ * )
+ * ```
+ */
+export declare function withPayload(build: undefined | WithPayloadBuilder, options: WithPayloadOptions): UserConfigFnObject;
+/** `@vitejs/plugin-rsc` options for Payload: `serverHandler: false` (TanStack owns the handler). */
+export declare function payloadRscOptions(): NonNullable<Parameters<typeof rsc>[0]>;
+/** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */
+export declare function payloadReactOptions(): NonNullable<Parameters<typeof viteReact>[0]>;
+export type PayloadTanstackStartOptionsArgs = {
+    /** Additional import-protection `ignoreImporters` patterns. */
+    additionalIgnoreImporters?: RegExp[];
+    /**
+     * Route id of Payload's admin layout route, eager-loaded (not code-split) so it
+     * hydrates on first paint. It and its children skip splitting; host routes keep
+     * TanStack's default. Defaults to `'/_payload'` (the `_payload.tsx` convention).
+     */
+    adminRouteId?: string;
+    /**
+     * Extra globs exempted from TanStack's `.client.*` SSR denial, on top of the
+     * default node_modules exemption. Needed only when Payload's own `.client.*`
+     * files resolve outside node_modules (e.g. the monorepo's `packages` sources).
+     */
+    clientDenialExcludeFiles?: string[];
+    /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'`. */
+    routesDirectory?: string;
+    /** TanStack source directory. Defaults to `'src'`. */
+    srcDirectory?: string;
+};
+/**
+ * The `tanstackStart` options Payload's admin requires (import-protection and
+ * code-splitting). TanStack Start is one-per-app, so a host that already runs it
+ * should merge these into its single `tanstackStart` call.
  */
-export declare function withPayload(options: WithPayloadOptions): UserConfigFnObject;
+export declare function payloadTanstackStartOptions(args?: PayloadTanstackStartOptionsArgs): NonNullable<Parameters<typeof tanstackStart>[0]>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,UAAU,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAsDlE,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAA;IACzB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAiJ3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAwB,UAAU,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAI3F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACjE,OAAO,SAAS,MAAM,sBAAsB,CAAA;AAC5C,OAAO,GAAG,MAAM,oBAAoB,CAAA;AA0DpC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wFAAwF;IACxF,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wGAAwG;IACxG,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAA;IACzB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yFAAyF;IACzF,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wFAAwF;IACxF,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnD,GAAG,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,aAAa,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;CAChE,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,qFAAqF;IACrF,MAAM,EAAE,UAAU,CAAA;IAClB,GAAG,EAAE,SAAS,CAAA;IACd,qFAAqF;IACrF,aAAa,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,UAAU,CAAA;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,GAAG,kBAAkB,EACrC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CAqGpB;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAE1E;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAElF;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,+DAA+D;IAC/D,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,wFAAwF;IACxF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,+BAAoC,GACzC,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAwClD"}

package/dist/vite/index.js

@@ -1,3 +1,5 @@
+// Optional peers, not deps: `plugin-rsc` is a singleton, so bundling our own copy
+// alongside the host's would load two instances and crash.
 import { tanstackStart } from '@tanstack/react-start/plugin/vite';
 import viteReact from '@vitejs/plugin-react';
 import rsc from '@vitejs/plugin-rsc';
@@ -41,26 +43,42 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
     };
     return logger;
 }
+/** Applies dependency-warning suppression to a config in place when enabled. */ function applyDependencyWarningSuppression(config, enabled) {
+    if (enabled) {
+        config.customLogger = withQuietedDependencyWarnings(config.customLogger);
+    }
+    return config;
+}
 /**
- * Vite config helper for Payload + TanStack Start. The Vite-side counterpart to
- * `withPayload` for Next.js: it owns the whole Vite setup needed to run the
- * Payload admin — the RSC, React, and TanStack Start plugins plus a small set of
- * Payload-specific workarounds — so a consumer's `vite.config.ts` collapses to:
+ * Vite config helper for Payload + TanStack Start; the counterpart to Next.js'
+ * `withPayload`.
  *
- * ```ts
- * import { withPayload } from '@payloadcms/tanstack-start/vite'
+ * Zero-config — Payload instantiates the RSC, React, and TanStack Start plugins:
  *
- * export default withPayload({ payloadConfigPath: './src/payload.config.ts' })
+ * ```ts
+ * export default withPayload(undefined, { payloadConfigPath: './src/payload.config.ts' })
  * ```
  *
- * The React (`@vitejs/plugin-react`), RSC (`@vitejs/plugin-rsc`), and TanStack
- * Start plugins are instantiated internally with the settings the admin
- * requires — consumers no longer pass them in. Each remaining Payload
- * workaround lives in its own file under `./workarounds/` so it can be deleted
- * individually once the corresponding upstream fix lands.
- */ export function withPayload(options) {
-    const { additionalIgnoreImporters = [], payloadConfigPath, routesDirectory = 'app', silenceDependencyWarnings = true, srcDirectory = 'src', vite } = options;
-    return (_env)=>{
+ * Guest mode — pass a `build` callback to instantiate them yourself (one copy of
+ * each; `@vitejs/plugin-rsc` is a hard singleton):
+ *
+ * ```ts
+ * export default withPayload(
+ *   ({ config, pluginOptions }) => ({
+ *     ...config,
+ *     plugins: [
+ *       ...config.plugins,
+ *       rsc(pluginOptions.rsc),
+ *       tanstackStart(pluginOptions.tanstackStart),
+ *       viteReact(pluginOptions.react),
+ *     ],
+ *   }),
+ *   { payloadConfigPath: './src/payload.config.ts' },
+ * )
+ * ```
+ */ export function withPayload(build, options) {
+    const { additionalIgnoreImporters = [], adminRouteId, clientDenialExcludeFiles = [], payloadConfigPath, routesDirectory = 'app', silenceDependencyWarnings = true, srcDirectory = 'src', vite } = options;
+    return (env)=>{
         const base = {
             build: {
                 cssMinify: 'esbuild'
@@ -105,100 +123,16 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
                 exclude: optimizeDepsExcludeDefaults,
                 include: optimizeDepsIncludeDefaults
             },
+            // Payload's internal workaround plugins only. The RSC, TanStack Start, and
+            // React plugins are appended below (default form) or by the consumer's
+            // `build` callback (guest form).
             plugins: [
                 clientModuleResolution(),
                 wrapCjsForClient(),
                 ssrStripDistStyleImports(),
                 reactDomServerInRsc(),
                 stubPrettierInClient(),
-                payloadDevTransforms(),
-                rsc({
-                    serverHandler: false
-                }),
-                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
-                }),
-                viteReact({
-                    exclude: [],
-                    include: /\.[jt]sx?$/
-                })
+                payloadDevTransforms()
             ],
             resolve: {
                 alias: [
@@ -230,11 +164,95 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
                 noExternal: payloadNoExternalPatterns
             }
         };
-        const merged = vite ? mergeConfig(base, vite) : base;
-        if (silenceDependencyWarnings) {
-            merged.customLogger = withQuietedDependencyWarnings(merged.customLogger);
+        const pluginOptions = {
+            react: payloadReactOptions(),
+            rsc: payloadRscOptions(),
+            tanstackStart: payloadTanstackStartOptions({
+                additionalIgnoreImporters,
+                adminRouteId,
+                clientDenialExcludeFiles,
+                routesDirectory,
+                srcDirectory
+            })
+        };
+        if (build) {
+            return applyDependencyWarningSuppression(build({
+                config: base,
+                env,
+                pluginOptions
+            }), silenceDependencyWarnings);
         }
-        return merged;
+        base.plugins = [
+            ...base.plugins,
+            rsc(pluginOptions.rsc),
+            tanstackStart(pluginOptions.tanstackStart),
+            viteReact(pluginOptions.react)
+        ];
+        const merged = vite ? mergeConfig(base, vite) : base;
+        return applyDependencyWarningSuppression(merged, silenceDependencyWarnings);
+    };
+}
+/** `@vitejs/plugin-rsc` options for Payload: `serverHandler: false` (TanStack owns the handler). */ export function payloadRscOptions() {
+    return {
+        serverHandler: false
+    };
+}
+/** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */ export function payloadReactOptions() {
+    return {
+        exclude: [],
+        include: /\.[jt]sx?$/
+    };
+}
+/**
+ * The `tanstackStart` options Payload's admin requires (import-protection and
+ * code-splitting). TanStack Start is one-per-app, so a host that already runs it
+ * should merge these into its single `tanstackStart` call.
+ */ export function payloadTanstackStartOptions(args = {}) {
+    const { additionalIgnoreImporters = [], adminRouteId = '/_payload', clientDenialExcludeFiles = [], routesDirectory = 'app', srcDirectory = 'src' } = args;
+    return {
+        importProtection: {
+            client: {
+                excludeFiles: [],
+                specifiers: serverOnlyClientSpecifiers
+            },
+            ignoreImporters: [
+                ...defaultImportProtectionIgnoreImporters,
+                ...additionalIgnoreImporters
+            ],
+            include: [
+                '**/*'
+            ],
+            mockAccess: 'warn',
+            onViolation: onImportProtectionViolation,
+            // Payload's `.client.*` components are React Client Components that must be
+            // server-rendered during SSR; TanStack's default `**/*.client.*` server
+            // denial would mock and crash them. All such files live in `@payloadcms/*`
+            // packages, so keep the denial (host `.client.*` files still get it) and
+            // just exempt Payload's — `node_modules` covers published installs.
+            server: {
+                excludeFiles: [
+                    '**/node_modules/**',
+                    ...clientDenialExcludeFiles
+                ]
+            }
+        },
+        router: {
+            codeSplittingOptions: {
+                // Eager-load only Payload's admin routes so they hydrate on first paint —
+                // a split admin renders but isn't interactive until its lazy `?tsr-split=`
+                // chunk lands. Returning `[]` disables splitting for a route; `undefined`
+                // lets host routes keep TanStack's default per-route splitting.
+                splitBehavior: ({ routeId })=>routeId === adminRouteId || routeId.startsWith(`${adminRouteId}/`) ? [] : undefined
+            },
+            // Ignore generated importMap files and colocated `*.functions.ts` modules
+            // (they define `createServerFn`s, not routes).
+            routeFileIgnorePattern: 'importMap\\.(?:js|server\\.ts)$|\\.functions\\.',
+            routesDirectory
+        },
+        rsc: {
+            enabled: true
+        },
+        srcDirectory
     };
 }
 

package/dist/vite/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vite/index.ts"],"sourcesContent":["import type { Logger, UserConfig, UserConfigFnObject } from 'vite'\n\nimport { tanstackStart } from '@tanstack/react-start/plugin/vite'\nimport viteReact from '@vitejs/plugin-react'\nimport rsc from '@vitejs/plugin-rsc'\nimport path from 'node:path'\nimport { createLogger, mergeConfig } from 'vite'\n\nimport { payloadNoExternalPatterns, ssrExternalPackages } from './config/external.js'\nimport { optimizeDepsExcludeDefaults, optimizeDepsIncludeDefaults } from './config/optimizeDeps.js'\nimport { payloadScssImporters } from './config/scss.js'\nimport {\n  defaultImportProtectionIgnoreImporters,\n  onImportProtectionViolation,\n  serverOnlyClientSpecifiers,\n} from './importProtection.js'\nimport { clientModuleResolution } from './workarounds/clientModuleResolution.js'\nimport { payloadDevTransforms } from './workarounds/devTransforms.js'\nimport { reactDomServerInRsc } from './workarounds/reactDomServerInRsc.js'\nimport { ssrStripDistStyleImports } from './workarounds/stripDistStyleImports.js'\nimport { stubPrettierInClient } from './workarounds/stubPrettierInClient.js'\nimport { wrapCjsForClient } from './workarounds/wrapCjsForClient.js'\n\n/**\n * Vite dependency warnings Payload consumers can't act on: third-party packages\n * ship sourcemaps whose original sources aren't published, so Vite warns on\n * every one. Suppressed by default (see `silenceDependencyWarnings`).\n */\nconst suppressibleWarningPatterns = ['points to missing source files', 'Sourcemap for']\n\n/**\n * Wraps a Vite logger so warnings matching {@link suppressibleWarningPatterns}\n * are dropped. Mutates and returns the given logger (or a fresh default one).\n */\nfunction withQuietedDependencyWarnings(existing?: Logger): Logger {\n  const logger = existing ?? createLogger()\n  const shouldSuppress = (msg: unknown): boolean =>\n    typeof msg === 'string' && suppressibleWarningPatterns.some((pattern) => msg.includes(pattern))\n\n  const baseWarn = logger.warn.bind(logger)\n  const baseWarnOnce = logger.warnOnce.bind(logger)\n  logger.warn = (msg, options) => {\n    if (!shouldSuppress(msg)) {\n      baseWarn(msg, options)\n    }\n  }\n  logger.warnOnce = (msg, options) => {\n    if (!shouldSuppress(msg)) {\n      baseWarnOnce(msg, options)\n    }\n  }\n  return logger\n}\n\nexport type WithPayloadOptions = {\n  /**\n   * Additional import-protection `ignoreImporters` patterns. This is a\n   * Payload-specific knob on the TanStack Start plugin, so it cannot be\n   * expressed through `vite` — pass it here.\n   */\n  additionalIgnoreImporters?: RegExp[]\n  /** Path to the user's `payload.config.ts` (required) */\n  payloadConfigPath: string\n  /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'` */\n  routesDirectory?: string\n  /**\n   * Silence Vite warnings about third-party dependency sourcemaps pointing to\n   * missing source files — noise Payload consumers can't act on. Defaults to\n   * `true`; set `false` to see them. Composes with a `vite.customLogger`.\n   */\n  silenceDependencyWarnings?: boolean\n  /** TanStack source directory. Defaults to `'src'` */\n  srcDirectory?: string\n  /**\n   * Extra Vite config merged on top of the Payload defaults via Vite's own\n   * `mergeConfig`. Objects are deep-merged and arrays are appended, so this is\n   * the single hook for everything a consumer used to reach through separate\n   * options: extra `plugins`, `resolve.alias` entries, `optimizeDeps.include`,\n   * `ssr.external`, `server`, `build`, and so on.\n   *\n   * @example\n   * withPayload({\n   *   payloadConfigPath: './src/payload.config.ts',\n   *   vite: { server: { port: 4000 } },\n   * })\n   */\n  vite?: UserConfig\n}\n\n/**\n * Vite config helper for Payload + TanStack Start. The Vite-side counterpart to\n * `withPayload` for Next.js: it owns the whole Vite setup needed to run the\n * Payload admin — the RSC, React, and TanStack Start plugins plus a small set of\n * Payload-specific workarounds — so a consumer's `vite.config.ts` collapses to:\n *\n * ```ts\n * import { withPayload } from '@payloadcms/tanstack-start/vite'\n *\n * export default withPayload({ payloadConfigPath: './src/payload.config.ts' })\n * ```\n *\n * The React (`@vitejs/plugin-react`), RSC (`@vitejs/plugin-rsc`), and TanStack\n * Start plugins are instantiated internally with the settings the admin\n * requires — consumers no longer pass them in. Each remaining Payload\n * workaround lives in its own file under `./workarounds/` so it can be deleted\n * individually once the corresponding upstream fix lands.\n */\nexport function withPayload(options: WithPayloadOptions): UserConfigFnObject {\n  const {\n    additionalIgnoreImporters = [],\n    payloadConfigPath,\n    routesDirectory = 'app',\n    silenceDependencyWarnings = true,\n    srcDirectory = 'src',\n    vite,\n  } = options\n\n  return (_env) => {\n    const base: UserConfig = {\n      build: {\n        cssMinify: 'esbuild',\n      },\n      css: {\n        preprocessorOptions: {\n          scss: {\n            importers: payloadScssImporters,\n            silenceDeprecations: ['import', 'global-builtin'],\n          } as any,\n        },\n      },\n      define: {\n        global: 'globalThis',\n      },\n      environments: {\n        rsc: {\n          build: { rollupOptions: { external: ssrExternalPackages } },\n          resolve: { noExternal: payloadNoExternalPatterns },\n        },\n        ssr: {\n          build: { rollupOptions: { external: ssrExternalPackages } },\n          resolve: { noExternal: payloadNoExternalPatterns },\n        },\n      } as any,\n      optimizeDeps: {\n        exclude: optimizeDepsExcludeDefaults,\n        include: optimizeDepsIncludeDefaults,\n      },\n      plugins: [\n        clientModuleResolution(),\n        wrapCjsForClient(),\n        ssrStripDistStyleImports(),\n        reactDomServerInRsc(),\n        stubPrettierInClient(),\n        payloadDevTransforms(),\n        rsc({ serverHandler: false }),\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        viteReact({ exclude: [], include: /\\.[jt]sx?$/ }),\n      ],\n      resolve: {\n        alias: [{ find: '@payload-config', replacement: path.resolve(payloadConfigPath) }],\n        dedupe: [\n          'react',\n          'react-dom',\n          'scheduler',\n          '@payloadcms/ui',\n          '@payloadcms/richtext-lexical',\n        ],\n        extensions: ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'],\n        tsconfigPaths: true,\n      } as any,\n      ssr: {\n        external: ssrExternalPackages,\n        noExternal: payloadNoExternalPatterns,\n      },\n    }\n\n    const merged = vite ? mergeConfig(base, vite) : base\n\n    if (silenceDependencyWarnings) {\n      merged.customLogger = withQuietedDependencyWarnings(merged.customLogger)\n    }\n\n    return merged\n  }\n}\n"],"names":["tanstackStart","viteReact","rsc","path","createLogger","mergeConfig","payloadNoExternalPatterns","ssrExternalPackages","optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults","payloadScssImporters","defaultImportProtectionIgnoreImporters","onImportProtectionViolation","serverOnlyClientSpecifiers","clientModuleResolution","payloadDevTransforms","reactDomServerInRsc","ssrStripDistStyleImports","stubPrettierInClient","wrapCjsForClient","suppressibleWarningPatterns","withQuietedDependencyWarnings","existing","logger","shouldSuppress","msg","some","pattern","includes","baseWarn","warn","bind","baseWarnOnce","warnOnce","options","withPayload","additionalIgnoreImporters","payloadConfigPath","routesDirectory","silenceDependencyWarnings","srcDirectory","vite","_env","base","build","cssMinify","css","preprocessorOptions","scss","importers","silenceDeprecations","define","global","environments","rollupOptions","external","resolve","noExternal","ssr","optimizeDeps","exclude","include","plugins","serverHandler","importProtection","client","excludeFiles","specifiers","ignoreImporters","mockAccess","onViolation","server","files","router","autoCodeSplitting","codeSplittingOptions","defaultBehavior","routeFileIgnorePattern","enabled","alias","find","replacement","dedupe","extensions","tsconfigPaths","merged","customLogger"],"mappings":"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"}
+{"version":3,"sources":["../../src/vite/index.ts"],"sourcesContent":["import type { ConfigEnv, Logger, PluginOption, UserConfig, UserConfigFnObject } from 'vite'\n\n// Optional peers, not deps: `plugin-rsc` is a singleton, so bundling our own copy\n// alongside the host's would load two instances and crash.\nimport { tanstackStart } from '@tanstack/react-start/plugin/vite'\nimport viteReact from '@vitejs/plugin-react'\nimport rsc from '@vitejs/plugin-rsc'\nimport path from 'node:path'\nimport { createLogger, mergeConfig } from 'vite'\n\nimport { payloadNoExternalPatterns, ssrExternalPackages } from './config/external.js'\nimport { optimizeDepsExcludeDefaults, optimizeDepsIncludeDefaults } from './config/optimizeDeps.js'\nimport { payloadScssImporters } from './config/scss.js'\nimport {\n  defaultImportProtectionIgnoreImporters,\n  onImportProtectionViolation,\n  serverOnlyClientSpecifiers,\n} from './importProtection.js'\nimport { clientModuleResolution } from './workarounds/clientModuleResolution.js'\nimport { payloadDevTransforms } from './workarounds/devTransforms.js'\nimport { reactDomServerInRsc } from './workarounds/reactDomServerInRsc.js'\nimport { ssrStripDistStyleImports } from './workarounds/stripDistStyleImports.js'\nimport { stubPrettierInClient } from './workarounds/stubPrettierInClient.js'\nimport { wrapCjsForClient } from './workarounds/wrapCjsForClient.js'\n\n/**\n * Vite dependency warnings Payload consumers can't act on: third-party packages\n * ship sourcemaps whose original sources aren't published, so Vite warns on\n * every one. Suppressed by default (see `silenceDependencyWarnings`).\n */\nconst suppressibleWarningPatterns = ['points to missing source files', 'Sourcemap for']\n\n/**\n * Wraps a Vite logger so warnings matching {@link suppressibleWarningPatterns}\n * are dropped. Mutates and returns the given logger (or a fresh default one).\n */\nfunction withQuietedDependencyWarnings(existing?: Logger): Logger {\n  const logger = existing ?? createLogger()\n  const shouldSuppress = (msg: unknown): boolean =>\n    typeof msg === 'string' && suppressibleWarningPatterns.some((pattern) => msg.includes(pattern))\n\n  const baseWarn = logger.warn.bind(logger)\n  const baseWarnOnce = logger.warnOnce.bind(logger)\n  logger.warn = (msg, options) => {\n    if (!shouldSuppress(msg)) {\n      baseWarn(msg, options)\n    }\n  }\n  logger.warnOnce = (msg, options) => {\n    if (!shouldSuppress(msg)) {\n      baseWarnOnce(msg, options)\n    }\n  }\n  return logger\n}\n\n/** Applies dependency-warning suppression to a config in place when enabled. */\nfunction applyDependencyWarningSuppression(config: UserConfig, enabled: boolean): UserConfig {\n  if (enabled) {\n    config.customLogger = withQuietedDependencyWarnings(config.customLogger)\n  }\n  return config\n}\n\nexport type WithPayloadOptions = {\n  /** Extra import-protection `ignoreImporters` patterns for the TanStack Start plugin. */\n  additionalIgnoreImporters?: RegExp[]\n  /** Route id of Payload's admin layout, eager-loaded instead of code-split. Defaults to `'/_payload'`. */\n  adminRouteId?: string\n  /** Extra globs exempted from the `.client.*` SSR denial (beyond the default node_modules exemption). */\n  clientDenialExcludeFiles?: string[]\n  /** Path to the user's `payload.config.ts` (required) */\n  payloadConfigPath: string\n  /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'` */\n  routesDirectory?: string\n  /** Silence Vite warnings about third-party dependency sourcemaps. Defaults to `true`. */\n  silenceDependencyWarnings?: boolean\n  /** TanStack source directory. Defaults to `'src'` */\n  srcDirectory?: string\n  /** Extra Vite config deep-merged over the Payload defaults. Ignored in `build` mode. */\n  vite?: UserConfig\n}\n\n/** The options Payload's admin requires for each third-party plugin. */\nexport type PayloadPluginOptions = {\n  react: NonNullable<Parameters<typeof viteReact>[0]>\n  rsc: NonNullable<Parameters<typeof rsc>[0]>\n  tanstackStart: NonNullable<Parameters<typeof tanstackStart>[0]>\n}\n\nexport type WithPayloadBuilderContext = {\n  /** Payload's base Vite config; `plugins` holds Payload's workaround plugins only. */\n  config: UserConfig\n  env: ConfigEnv\n  /** Options to pass to the `viteReact`/`rsc`/`tanstackStart` factories you import. */\n  pluginOptions: PayloadPluginOptions\n}\n\n/** Assembles the final Vite config from Payload's base config and plugin options. */\nexport type WithPayloadBuilder = (context: WithPayloadBuilderContext) => UserConfig\n\n/**\n * Vite config helper for Payload + TanStack Start; the counterpart to Next.js'\n * `withPayload`.\n *\n * Zero-config — Payload instantiates the RSC, React, and TanStack Start plugins:\n *\n * ```ts\n * export default withPayload(undefined, { payloadConfigPath: './src/payload.config.ts' })\n * ```\n *\n * Guest mode — pass a `build` callback to instantiate them yourself (one copy of\n * each; `@vitejs/plugin-rsc` is a hard singleton):\n *\n * ```ts\n * export default withPayload(\n *   ({ config, pluginOptions }) => ({\n *     ...config,\n *     plugins: [\n *       ...config.plugins,\n *       rsc(pluginOptions.rsc),\n *       tanstackStart(pluginOptions.tanstackStart),\n *       viteReact(pluginOptions.react),\n *     ],\n *   }),\n *   { payloadConfigPath: './src/payload.config.ts' },\n * )\n * ```\n */\nexport function withPayload(\n  build: undefined | WithPayloadBuilder,\n  options: WithPayloadOptions,\n): UserConfigFnObject {\n  const {\n    additionalIgnoreImporters = [],\n    adminRouteId,\n    clientDenialExcludeFiles = [],\n    payloadConfigPath,\n    routesDirectory = 'app',\n    silenceDependencyWarnings = true,\n    srcDirectory = 'src',\n    vite,\n  } = options\n\n  return (env) => {\n    const base: UserConfig = {\n      build: {\n        cssMinify: 'esbuild',\n      },\n      css: {\n        preprocessorOptions: {\n          scss: {\n            importers: payloadScssImporters,\n            silenceDeprecations: ['import', 'global-builtin'],\n          } as any,\n        },\n      },\n      define: {\n        global: 'globalThis',\n      },\n      environments: {\n        rsc: {\n          build: { rollupOptions: { external: ssrExternalPackages } },\n          resolve: { noExternal: payloadNoExternalPatterns },\n        },\n        ssr: {\n          build: { rollupOptions: { external: ssrExternalPackages } },\n          resolve: { noExternal: payloadNoExternalPatterns },\n        },\n      } as any,\n      optimizeDeps: {\n        exclude: optimizeDepsExcludeDefaults,\n        include: optimizeDepsIncludeDefaults,\n      },\n      // Payload's internal workaround plugins only. The RSC, TanStack Start, and\n      // React plugins are appended below (default form) or by the consumer's\n      // `build` callback (guest form).\n      plugins: [\n        clientModuleResolution(),\n        wrapCjsForClient(),\n        ssrStripDistStyleImports(),\n        reactDomServerInRsc(),\n        stubPrettierInClient(),\n        payloadDevTransforms(),\n      ],\n      resolve: {\n        alias: [{ find: '@payload-config', replacement: path.resolve(payloadConfigPath) }],\n        dedupe: [\n          'react',\n          'react-dom',\n          'scheduler',\n          '@payloadcms/ui',\n          '@payloadcms/richtext-lexical',\n        ],\n        extensions: ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'],\n        tsconfigPaths: true,\n      } as any,\n      ssr: {\n        external: ssrExternalPackages,\n        noExternal: payloadNoExternalPatterns,\n      },\n    }\n\n    const pluginOptions: PayloadPluginOptions = {\n      react: payloadReactOptions(),\n      rsc: payloadRscOptions(),\n      tanstackStart: payloadTanstackStartOptions({\n        additionalIgnoreImporters,\n        adminRouteId,\n        clientDenialExcludeFiles,\n        routesDirectory,\n        srcDirectory,\n      }),\n    }\n\n    if (build) {\n      return applyDependencyWarningSuppression(\n        build({ config: base, env, pluginOptions }),\n        silenceDependencyWarnings,\n      )\n    }\n\n    base.plugins = [\n      ...(base.plugins as PluginOption[]),\n      rsc(pluginOptions.rsc),\n      tanstackStart(pluginOptions.tanstackStart),\n      viteReact(pluginOptions.react),\n    ]\n\n    const merged = vite ? mergeConfig(base, vite) : base\n\n    return applyDependencyWarningSuppression(merged, silenceDependencyWarnings)\n  }\n}\n\n/** `@vitejs/plugin-rsc` options for Payload: `serverHandler: false` (TanStack owns the handler). */\nexport function payloadRscOptions(): NonNullable<Parameters<typeof rsc>[0]> {\n  return { serverHandler: false }\n}\n\n/** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */\nexport function payloadReactOptions(): NonNullable<Parameters<typeof viteReact>[0]> {\n  return { exclude: [], include: /\\.[jt]sx?$/ }\n}\n\nexport type PayloadTanstackStartOptionsArgs = {\n  /** Additional import-protection `ignoreImporters` patterns. */\n  additionalIgnoreImporters?: RegExp[]\n  /**\n   * Route id of Payload's admin layout route, eager-loaded (not code-split) so it\n   * hydrates on first paint. It and its children skip splitting; host routes keep\n   * TanStack's default. Defaults to `'/_payload'` (the `_payload.tsx` convention).\n   */\n  adminRouteId?: string\n  /**\n   * Extra globs exempted from TanStack's `.client.*` SSR denial, on top of the\n   * default node_modules exemption. Needed only when Payload's own `.client.*`\n   * files resolve outside node_modules (e.g. the monorepo's `packages` sources).\n   */\n  clientDenialExcludeFiles?: string[]\n  /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'`. */\n  routesDirectory?: string\n  /** TanStack source directory. Defaults to `'src'`. */\n  srcDirectory?: string\n}\n\n/**\n * The `tanstackStart` options Payload's admin requires (import-protection and\n * code-splitting). TanStack Start is one-per-app, so a host that already runs it\n * should merge these into its single `tanstackStart` call.\n */\nexport function payloadTanstackStartOptions(\n  args: PayloadTanstackStartOptionsArgs = {},\n): NonNullable<Parameters<typeof tanstackStart>[0]> {\n  const {\n    additionalIgnoreImporters = [],\n    adminRouteId = '/_payload',\n    clientDenialExcludeFiles = [],\n    routesDirectory = 'app',\n    srcDirectory = 'src',\n  } = args\n\n  return {\n    importProtection: {\n      client: { excludeFiles: [], specifiers: serverOnlyClientSpecifiers },\n      ignoreImporters: [...defaultImportProtectionIgnoreImporters, ...additionalIgnoreImporters],\n      include: ['**/*'],\n      mockAccess: 'warn',\n      onViolation: onImportProtectionViolation,\n      // Payload's `.client.*` components are React Client Components that must be\n      // server-rendered during SSR; TanStack's default `**/*.client.*` server\n      // denial would mock and crash them. All such files live in `@payloadcms/*`\n      // packages, so keep the denial (host `.client.*` files still get it) and\n      // just exempt Payload's — `node_modules` covers published installs.\n      server: { excludeFiles: ['**/node_modules/**', ...clientDenialExcludeFiles] },\n    },\n    router: {\n      codeSplittingOptions: {\n        // Eager-load only Payload's admin routes so they hydrate on first paint —\n        // a split admin renders but isn't interactive until its lazy `?tsr-split=`\n        // chunk lands. Returning `[]` disables splitting for a route; `undefined`\n        // lets host routes keep TanStack's default per-route splitting.\n        splitBehavior: ({ routeId }: { routeId: string }) =>\n          routeId === adminRouteId || routeId.startsWith(`${adminRouteId}/`) ? [] : undefined,\n      },\n      // Ignore generated importMap files and colocated `*.functions.ts` modules\n      // (they define `createServerFn`s, not routes).\n      routeFileIgnorePattern: 'importMap\\\\.(?:js|server\\\\.ts)$|\\\\.functions\\\\.',\n      routesDirectory,\n    } as any,\n    rsc: { enabled: true },\n    srcDirectory,\n  }\n}\n"],"names":["tanstackStart","viteReact","rsc","path","createLogger","mergeConfig","payloadNoExternalPatterns","ssrExternalPackages","optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults","payloadScssImporters","defaultImportProtectionIgnoreImporters","onImportProtectionViolation","serverOnlyClientSpecifiers","clientModuleResolution","payloadDevTransforms","reactDomServerInRsc","ssrStripDistStyleImports","stubPrettierInClient","wrapCjsForClient","suppressibleWarningPatterns","withQuietedDependencyWarnings","existing","logger","shouldSuppress","msg","some","pattern","includes","baseWarn","warn","bind","baseWarnOnce","warnOnce","options","applyDependencyWarningSuppression","config","enabled","customLogger","withPayload","build","additionalIgnoreImporters","adminRouteId","clientDenialExcludeFiles","payloadConfigPath","routesDirectory","silenceDependencyWarnings","srcDirectory","vite","env","base","cssMinify","css","preprocessorOptions","scss","importers","silenceDeprecations","define","global","environments","rollupOptions","external","resolve","noExternal","ssr","optimizeDeps","exclude","include","plugins","alias","find","replacement","dedupe","extensions","tsconfigPaths","pluginOptions","react","payloadReactOptions","payloadRscOptions","payloadTanstackStartOptions","merged","serverHandler","args","importProtection","client","excludeFiles","specifiers","ignoreImporters","mockAccess","onViolation","server","router","codeSplittingOptions","splitBehavior","routeId","startsWith","undefined","routeFileIgnorePattern"],"mappings":"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"}

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

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

package/dist/vite/workarounds/devTransforms.js

@@ -38,6 +38,11 @@ window.__vite_plugin_react_preamble_installed__ = true
                         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>`);

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/vite/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          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"}
+{"version":3,"sources":["../../../src/vite/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/vite/workarounds/stubPrettierInClient.d.ts

@@ -2,20 +2,12 @@ import type { PluginOption } from 'vite';
 /**
  * Stubs `prettier` in the CLIENT bundle only.
  *
- * `payload`'s barrel transitively pulls `configToJSONSchema` →
- * `json-schema-to-typescript` → `prettier` (CommonJS) into the client module
- * graph through re-export side effects. That path is type-generation only
- * (`payload generate:types`) and never runs in the browser, but the bundler
- * still drags `prettier`'s `index.cjs` in — where it fails to parse as ESM and
- * breaks the client build.
+ * `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.
  *
- * We redirect `prettier` to a no-op `format` stub in the client environment
- * only. SSR/RSC keep the real `prettier` (there `json-schema-to-typescript`
- * stays external and resolves it from `node_modules`), and the `prettier` CLI /
- * `payload generate:types` are unaffected.
- *
- * Delete this once `payload`'s barrel no longer reaches the type-gen path from
- * the client-reachable export graph.
+ * 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/vite/workarounds/stubPrettierInClient.d.ts.map

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

package/dist/vite/workarounds/stubPrettierInClient.js

@@ -1,20 +1,12 @@
 /**
  * Stubs `prettier` in the CLIENT bundle only.
  *
- * `payload`'s barrel transitively pulls `configToJSONSchema` →
- * `json-schema-to-typescript` → `prettier` (CommonJS) into the client module
- * graph through re-export side effects. That path is type-generation only
- * (`payload generate:types`) and never runs in the browser, but the bundler
- * still drags `prettier`'s `index.cjs` in — where it fails to parse as ESM and
- * breaks the client build.
+ * `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.
  *
- * We redirect `prettier` to a no-op `format` stub in the client environment
- * only. SSR/RSC keep the real `prettier` (there `json-schema-to-typescript`
- * stays external and resolves it from `node_modules`), and the `prettier` CLI /
- * `payload generate:types` are unaffected.
- *
- * Delete this once `payload`'s barrel no longer reaches the type-gen path from
- * the client-reachable export graph.
+ * 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 {
@@ -25,11 +17,12 @@
                 return 'export const format = (source) => source;\nexport default { format };';
             }
         },
-        resolveId (id, _importer, options) {
+        resolveId (id, importer, options) {
             if (options?.ssr) {
                 return;
             }
-            if (id === 'prettier') {
+            // 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;
             }
         }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/vite/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 `configToJSONSchema` →\n * `json-schema-to-typescript` → `prettier` (CommonJS) into the client module\n * graph through re-export side effects. That path is type-generation only\n * (`payload generate:types`) and never runs in the browser, but the bundler\n * still drags `prettier`'s `index.cjs` in — where it fails to parse as ESM and\n * breaks the client build.\n *\n * We redirect `prettier` to a no-op `format` stub in the client environment\n * only. SSR/RSC keep the real `prettier` (there `json-schema-to-typescript`\n * stays external and resolves it from `node_modules`), and the `prettier` CLI /\n * `payload generate:types` are unaffected.\n *\n * Delete this once `payload`'s barrel no longer reaches the type-gen path from\n * the client-reachable export 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      if (id === 'prettier') {\n        return RESOLVED_ID\n      }\n    },\n  }\n}\n"],"names":["stubPrettierInClient","RESOLVED_ID","name","enforce","load","id","resolveId","_importer","options","ssr"],"mappings":"AAEA;;;;;;;;;;;;;;;;;CAiBC,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,SAAS,EAAEC,OAAO;YAC9B,IAAIA,SAASC,KAAK;gBAChB;YACF;YACA,IAAIJ,OAAO,YAAY;gBACrB,OAAOJ;YACT;QACF;IACF;AACF"}
+{"version":3,"sources":["../../../src/vite/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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/tanstack-start",
-  "version": "4.0.0-internal.811e0a4",
+  "version": "4.0.0-internal.8ba6b5b",
   "description": "TanStack Start framework adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -57,32 +57,39 @@
     "dist"
   ],
   "dependencies": {
-    "@vitejs/plugin-react": "^6.0.0",
-    "@vitejs/plugin-rsc": "^0.5.21",
     "qs-esm": "^7.0.2",
-    "@payloadcms/translations": "4.0.0-internal.811e0a4",
-    "@payloadcms/ui": "4.0.0-internal.811e0a4"
+    "@payloadcms/translations": "4.0.0-internal.8ba6b5b",
+    "@payloadcms/ui": "4.0.0-internal.8ba6b5b"
   },
   "devDependencies": {
     "@tanstack/react-router": "^1.120.0",
     "@tanstack/react-start": "^1.168.26",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.0",
     "@vitejs/plugin-rsc": "^0.5.21",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": ">=8.0.0",
-    "payload": "4.0.0-internal.811e0a4"
+    "payload": "4.0.0-internal.8ba6b5b"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.120.0",
     "@tanstack/react-start": "^1.168.26",
+    "@vitejs/plugin-react": "^6.0.0",
+    "@vitejs/plugin-rsc": "^0.5.21",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": ">=8.0.0",
-    "payload": "4.0.0-internal.811e0a4"
+    "payload": "4.0.0-internal.8ba6b5b"
   },
   "peerDependenciesMeta": {
+    "@vitejs/plugin-react": {
+      "optional": true
+    },
+    "@vitejs/plugin-rsc": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }