@payloadcms/tanstack-start 4.0.0-internal.dee5eab → 4.0.0-internal.e38d3ac

package/dist/withPayload/config/optimizeDeps.js

@@ -25,6 +25,9 @@
     // server-only APIs (e.g. `BlobSASPermissions`), which crashes the dev
     // server with a `MISSING_EXPORT` error before any test runs.
     '@azure/storage-blob',
+    // Preserve RSC client boundaries on storage admin upload handlers.
+    '@payloadcms/storage-azure',
+    '@payloadcms/storage-vercel-blob',
     '@aws-sdk/client-s3',
     '@aws-sdk/s3-request-presigner',
     '@google-cloud/storage'
@@ -113,11 +116,12 @@
     'payload > path-to-regexp',
     'payload > console-table-printer',
     'payload > ci-info',
-    'payload > image-size',
-    'payload > image-size/fromFile',
+    'payload > image-dimensions',
     'payload > ipaddr.js',
     'payload > range-parser',
-    'payload > sanitize-filename'
+    'payload > sanitize-filename',
+    // `@azure/storage-blob` is excluded, so pre-bundle its CommonJS browser dependency explicitly.
+    '@azure/storage-blob > events'
 ];
 
 //# sourceMappingURL=optimizeDeps.js.map

package/dist/withPayload/config/optimizeDeps.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/withPayload/config/optimizeDeps.ts"],"sourcesContent":["/**\n * Client dep-optimizer config used by `withPayload`. Kept separate from the\n * SSR/RSC externalization config (`./external.ts`) so each concern stays small.\n */\n\n/**\n * Packages we know contain Node-only code or top-level side effects requiring\n * Node APIs. Excluding them from the client optimizer prevents Vite from\n * walking into their main entries and trying to bundle server-only imports\n * for the browser.\n */\nexport const optimizeDepsExcludeDefaults: string[] = [\n  'sharp',\n  '@payloadcms/ui',\n  '@payloadcms/tanstack-start',\n  'payload',\n  'pino',\n  'pino-pretty',\n  'busboy',\n  'get-tsconfig',\n  'ws',\n  'croner',\n  'prompts',\n  'file-type',\n  // Server-only SDKs used by `@payloadcms/storage-*` adapters. Vite\n  // sometimes walks these from the main package entry while scanning\n  // workspace deps, and the browser sub-bundles do not expose the\n  // server-only APIs (e.g. `BlobSASPermissions`), which crashes the dev\n  // server with a `MISSING_EXPORT` error before any test runs.\n  '@azure/storage-blob',\n  '@aws-sdk/client-s3',\n  '@aws-sdk/s3-request-presigner',\n  '@google-cloud/storage',\n]\n\n/**\n * Transitive dependencies of `@payloadcms/ui` and `payload` that need to be\n * pre-bundled for the client. Vite's auto-discovery doesn't reliably pick\n * these up because their parent packages are in `optimizeDeps.exclude`, so we\n * list them explicitly using the `parent > child` syntax.\n *\n * Each entry below fixes a specific late-discovery re-optimization: without it,\n * Vite discovers the dep *after* its initial crawl, forcing a full dep\n * re-optimization mid-session that 404s in-flight `.vite/deps/*` chunks and\n * remounts the admin (dropping client state). This is why the list can't simply\n * be deleted — it is the \"complete first pass\" for the admin's dep graph.\n */\nexport const optimizeDepsIncludeDefaults: string[] = [\n  '@payloadcms/ui > sonner',\n  '@payloadcms/ui > @faceless-ui/modal',\n  '@payloadcms/ui > @faceless-ui/window-info',\n  '@payloadcms/ui > @faceless-ui/scroll-info',\n  '@payloadcms/ui > @dnd-kit/core',\n  '@payloadcms/ui > @dnd-kit/sortable',\n  '@payloadcms/ui > @dnd-kit/utilities',\n  '@payloadcms/ui > react-datepicker',\n  '@payloadcms/ui > react-select',\n  '@payloadcms/ui > react-select/creatable',\n  '@payloadcms/ui > react-image-crop',\n  '@payloadcms/ui > @monaco-editor/react',\n  '@payloadcms/ui > date-fns',\n  '@payloadcms/ui > date-fns/transpose',\n  '@payloadcms/ui > @date-fns/tz/date/mini',\n  '@payloadcms/ui > uuid',\n  '@payloadcms/ui > use-context-selector',\n  '@payloadcms/ui > bson-objectid',\n  '@payloadcms/ui > dequal',\n  '@payloadcms/ui > object-to-formdata',\n  '@payloadcms/ui > md5',\n  'payload > deepmerge',\n  'payload > pluralize',\n  // `scheduler` is a transitive dep of `react-dom`, not a direct dependency of\n  // the app, so a bare `'scheduler'` specifier fails to resolve from an isolated\n  // install (`test/node_modules` built with `pnpm i --ignore-workspace`), where\n  // it isn't hoisted to the top level. Path it through `react-dom` so the\n  // optimizer resolves the exact copy the runtime loads.\n  'react-dom > scheduler',\n  // `@payloadcms/ui` (in `optimizeDeps.exclude`) ships compiled output that the\n  // React Compiler rewrote to `import { c } from 'react/compiler-runtime'`.\n  // Because its parent is excluded, the optimizer never crawls in to discover\n  // this entry, so Vite serves `react/compiler-runtime` raw. That file is\n  // CommonJS (`module.exports = require(...)`), so the named `c` export can't be\n  // statically extracted and every client component throws \"does not provide an\n  // export named 'c'\". Pre-bundling it lets esbuild synthesize the named export.\n  'react/compiler-runtime',\n  // Transitive deps that Vite otherwise discovers *after* the initial crawl\n  // (react-select pulls in @floating-ui at runtime; react-is is reached via\n  // react-transition-group/prop-types; the default date-fns locale is loaded\n  // through a dynamic `date-fns/locale/${key}` import). A late discovery forces\n  // a full dep re-optimization mid-session, which 404s every in-flight\n  // `.vite/deps/*` chunk (\"Pre-transform error: file does not exist in the\n  // optimize deps directory\") and breaks the admin UI in CI cold starts.\n  // Pre-bundling them keeps the first optimization pass complete.\n  '@payloadcms/ui > react-select > @floating-ui/dom',\n  '@payloadcms/ui > react-select > @floating-ui/dom > @floating-ui/core',\n  '@payloadcms/ui > react-select > prop-types > react-is',\n  '@payloadcms/ui > date-fns/locale/en-US',\n  // Further late discoveries observed re-optimizing mid-run in CI cold starts\n  // (see CI logs: \"✨ new dependencies optimized: @dnd-kit/modifiers / ajv /\n  // dequal/lite\"). The modular dashboard pulls in `@dnd-kit/modifiers` on first\n  // render; form-state diffing reaches `dequal/lite` (a distinct entry point\n  // from the already-listed `dequal`); client-side field validation reaches\n  // `ajv` *through `payload`* — it is `ssrExternal` server-side but still\n  // bundled into the client, and must be pathed via `payload` so the optimizer\n  // pre-bundles the exact copy the runtime loads.\n  '@payloadcms/ui > @dnd-kit/modifiers',\n  '@payloadcms/ui > dequal/lite',\n  'payload > ajv',\n  // The storage client-upload suites (esp. vercel-blob) crawl part of the\n  // `payload` server runtime into the client bundle and discover these late,\n  // triggering several \"optimized dependencies changed. reloading\" waves that\n  // reload the page mid-test (the bulk-upload drawer's Create New button /\n  // dropzone vanish and the direct-to-bucket PUT never fires). Pre-bundle the\n  // whole observed set so the first pass is complete.\n  'payload > undici',\n  'payload > jose',\n  'payload > dataloader',\n  'payload > path-to-regexp',\n  'payload > console-table-printer',\n  'payload > ci-info',\n  'payload > image-size',\n  'payload > image-size/fromFile',\n  'payload > ipaddr.js',\n  'payload > range-parser',\n  'payload > sanitize-filename',\n]\n"],"names":["optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults"],"mappings":"AAAA;;;CAGC,GAED;;;;;CAKC,GACD,OAAO,MAAMA,8BAAwC;IACnD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,kEAAkE;IAClE,mEAAmE;IACnE,gEAAgE;IAChE,sEAAsE;IACtE,6DAA6D;IAC7D;IACA;IACA;IACA;CACD,CAAA;AAED;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,8BAAwC;IACnD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,6EAA6E;IAC7E,+EAA+E;IAC/E,8EAA8E;IAC9E,wEAAwE;IACxE,uDAAuD;IACvD;IACA,8EAA8E;IAC9E,0EAA0E;IAC1E,4EAA4E;IAC5E,wEAAwE;IACxE,+EAA+E;IAC/E,8EAA8E;IAC9E,+EAA+E;IAC/E;IACA,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,8EAA8E;IAC9E,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,gEAAgE;IAChE;IACA;IACA;IACA;IACA,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,6EAA6E;IAC7E,gDAAgD;IAChD;IACA;IACA;IACA,wEAAwE;IACxE,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,oDAAoD;IACpD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA"}
+{"version":3,"sources":["../../../src/withPayload/config/optimizeDeps.ts"],"sourcesContent":["/**\n * Client dep-optimizer config used by `withPayload`. Kept separate from the\n * SSR/RSC externalization config (`./external.ts`) so each concern stays small.\n */\n\n/**\n * Packages we know contain Node-only code or top-level side effects requiring\n * Node APIs. Excluding them from the client optimizer prevents Vite from\n * walking into their main entries and trying to bundle server-only imports\n * for the browser.\n */\nexport const optimizeDepsExcludeDefaults: string[] = [\n  'sharp',\n  '@payloadcms/ui',\n  '@payloadcms/tanstack-start',\n  'payload',\n  'pino',\n  'pino-pretty',\n  'busboy',\n  'get-tsconfig',\n  'ws',\n  'croner',\n  'prompts',\n  'file-type',\n  // Server-only SDKs used by `@payloadcms/storage-*` adapters. Vite\n  // sometimes walks these from the main package entry while scanning\n  // workspace deps, and the browser sub-bundles do not expose the\n  // server-only APIs (e.g. `BlobSASPermissions`), which crashes the dev\n  // server with a `MISSING_EXPORT` error before any test runs.\n  '@azure/storage-blob',\n  // Preserve RSC client boundaries on storage admin upload handlers.\n  '@payloadcms/storage-azure',\n  '@payloadcms/storage-vercel-blob',\n  '@aws-sdk/client-s3',\n  '@aws-sdk/s3-request-presigner',\n  '@google-cloud/storage',\n]\n\n/**\n * Transitive dependencies of `@payloadcms/ui` and `payload` that need to be\n * pre-bundled for the client. Vite's auto-discovery doesn't reliably pick\n * these up because their parent packages are in `optimizeDeps.exclude`, so we\n * list them explicitly using the `parent > child` syntax.\n *\n * Each entry below fixes a specific late-discovery re-optimization: without it,\n * Vite discovers the dep *after* its initial crawl, forcing a full dep\n * re-optimization mid-session that 404s in-flight `.vite/deps/*` chunks and\n * remounts the admin (dropping client state). This is why the list can't simply\n * be deleted — it is the \"complete first pass\" for the admin's dep graph.\n */\nexport const optimizeDepsIncludeDefaults: string[] = [\n  '@payloadcms/ui > sonner',\n  '@payloadcms/ui > @faceless-ui/modal',\n  '@payloadcms/ui > @faceless-ui/window-info',\n  '@payloadcms/ui > @faceless-ui/scroll-info',\n  '@payloadcms/ui > @dnd-kit/core',\n  '@payloadcms/ui > @dnd-kit/sortable',\n  '@payloadcms/ui > @dnd-kit/utilities',\n  '@payloadcms/ui > react-datepicker',\n  '@payloadcms/ui > react-select',\n  '@payloadcms/ui > react-select/creatable',\n  '@payloadcms/ui > react-image-crop',\n  '@payloadcms/ui > @monaco-editor/react',\n  '@payloadcms/ui > date-fns',\n  '@payloadcms/ui > date-fns/transpose',\n  '@payloadcms/ui > @date-fns/tz/date/mini',\n  '@payloadcms/ui > uuid',\n  '@payloadcms/ui > use-context-selector',\n  '@payloadcms/ui > bson-objectid',\n  '@payloadcms/ui > dequal',\n  '@payloadcms/ui > object-to-formdata',\n  '@payloadcms/ui > md5',\n  'payload > deepmerge',\n  'payload > pluralize',\n  // `scheduler` is a transitive dep of `react-dom`, not a direct dependency of\n  // the app, so a bare `'scheduler'` specifier fails to resolve from an isolated\n  // install (`test/node_modules` built with `pnpm i --ignore-workspace`), where\n  // it isn't hoisted to the top level. Path it through `react-dom` so the\n  // optimizer resolves the exact copy the runtime loads.\n  'react-dom > scheduler',\n  // `@payloadcms/ui` (in `optimizeDeps.exclude`) ships compiled output that the\n  // React Compiler rewrote to `import { c } from 'react/compiler-runtime'`.\n  // Because its parent is excluded, the optimizer never crawls in to discover\n  // this entry, so Vite serves `react/compiler-runtime` raw. That file is\n  // CommonJS (`module.exports = require(...)`), so the named `c` export can't be\n  // statically extracted and every client component throws \"does not provide an\n  // export named 'c'\". Pre-bundling it lets esbuild synthesize the named export.\n  'react/compiler-runtime',\n  // Transitive deps that Vite otherwise discovers *after* the initial crawl\n  // (react-select pulls in @floating-ui at runtime; react-is is reached via\n  // react-transition-group/prop-types; the default date-fns locale is loaded\n  // through a dynamic `date-fns/locale/${key}` import). A late discovery forces\n  // a full dep re-optimization mid-session, which 404s every in-flight\n  // `.vite/deps/*` chunk (\"Pre-transform error: file does not exist in the\n  // optimize deps directory\") and breaks the admin UI in CI cold starts.\n  // Pre-bundling them keeps the first optimization pass complete.\n  '@payloadcms/ui > react-select > @floating-ui/dom',\n  '@payloadcms/ui > react-select > @floating-ui/dom > @floating-ui/core',\n  '@payloadcms/ui > react-select > prop-types > react-is',\n  '@payloadcms/ui > date-fns/locale/en-US',\n  // Further late discoveries observed re-optimizing mid-run in CI cold starts\n  // (see CI logs: \"✨ new dependencies optimized: @dnd-kit/modifiers / ajv /\n  // dequal/lite\"). The modular dashboard pulls in `@dnd-kit/modifiers` on first\n  // render; form-state diffing reaches `dequal/lite` (a distinct entry point\n  // from the already-listed `dequal`); client-side field validation reaches\n  // `ajv` *through `payload`* — it is `ssrExternal` server-side but still\n  // bundled into the client, and must be pathed via `payload` so the optimizer\n  // pre-bundles the exact copy the runtime loads.\n  '@payloadcms/ui > @dnd-kit/modifiers',\n  '@payloadcms/ui > dequal/lite',\n  'payload > ajv',\n  // The storage client-upload suites (esp. vercel-blob) crawl part of the\n  // `payload` server runtime into the client bundle and discover these late,\n  // triggering several \"optimized dependencies changed. reloading\" waves that\n  // reload the page mid-test (the bulk-upload drawer's Create New button /\n  // dropzone vanish and the direct-to-bucket PUT never fires). Pre-bundle the\n  // whole observed set so the first pass is complete.\n  'payload > undici',\n  'payload > jose',\n  'payload > dataloader',\n  'payload > path-to-regexp',\n  'payload > console-table-printer',\n  'payload > ci-info',\n  'payload > image-dimensions',\n  'payload > ipaddr.js',\n  'payload > range-parser',\n  'payload > sanitize-filename',\n  // `@azure/storage-blob` is excluded, so pre-bundle its CommonJS browser dependency explicitly.\n  '@azure/storage-blob > events',\n]\n"],"names":["optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults"],"mappings":"AAAA;;;CAGC,GAED;;;;;CAKC,GACD,OAAO,MAAMA,8BAAwC;IACnD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,kEAAkE;IAClE,mEAAmE;IACnE,gEAAgE;IAChE,sEAAsE;IACtE,6DAA6D;IAC7D;IACA,mEAAmE;IACnE;IACA;IACA;IACA;IACA;CACD,CAAA;AAED;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,8BAAwC;IACnD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,6EAA6E;IAC7E,+EAA+E;IAC/E,8EAA8E;IAC9E,wEAAwE;IACxE,uDAAuD;IACvD;IACA,8EAA8E;IAC9E,0EAA0E;IAC1E,4EAA4E;IAC5E,wEAAwE;IACxE,+EAA+E;IAC/E,8EAA8E;IAC9E,+EAA+E;IAC/E;IACA,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,8EAA8E;IAC9E,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,gEAAgE;IAChE;IACA;IACA;IACA;IACA,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,6EAA6E;IAC7E,gDAAgD;IAChD;IACA;IACA;IACA,wEAAwE;IACxE,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,oDAAoD;IACpD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,+FAA+F;IAC/F;CACD,CAAA"}

package/dist/withPayload/devConfigReload.d.ts

@@ -0,0 +1,14 @@
+import type { PluginOption } from 'vite';
+/**
+ * Reloads Payload when `payload.config.ts`, or anything it imports, changes.
+ *
+ * Vite re-evaluates the config module on its own, but `getPayload` keeps
+ * serving its cached instance until a `DevReloadStrategy` marks it stale. This
+ * plugin only broadcasts the change; `devConfigReload.server.ts` subscribes
+ * from inside the server runtime and marks the instance, which `getPayload`
+ * then reloads on its next call.
+ */
+export declare function payloadDevConfigReload({ payloadConfigPath, }: {
+    payloadConfigPath: string;
+}): PluginOption;
+//# sourceMappingURL=devConfigReload.d.ts.map

package/dist/withPayload/devConfigReload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devConfigReload.d.ts","sourceRoot":"","sources":["../../src/withPayload/devConfigReload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,YAAY,EAAiB,MAAM,MAAM,CAAA;AAO9E;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,iBAAiB,GAClB,EAAE;IACD,iBAAiB,EAAE,MAAM,CAAA;CAC1B,GAAG,YAAY,CA+Cf"}

package/dist/withPayload/devConfigReload.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { normalizePath } from 'vite';
+import { PAYLOAD_CONFIG_CHANGED_EVENT } from '../utilities/devConfigReloadEvent.js';
+/**
+ * Reloads Payload when `payload.config.ts`, or anything it imports, changes.
+ *
+ * Vite re-evaluates the config module on its own, but `getPayload` keeps
+ * serving its cached instance until a `DevReloadStrategy` marks it stale. This
+ * plugin only broadcasts the change; `devConfigReload.server.ts` subscribes
+ * from inside the server runtime and marks the instance, which `getPayload`
+ * then reloads on its next call.
+ */ export function payloadDevConfigReload({ payloadConfigPath }) {
+    const configFile = normalizePath(path.resolve(payloadConfigPath));
+    let server;
+    // Vite runs `hotUpdate` once per environment (client, ssr, rsc) per change,
+    // sharing one timestamp; without this the notice prints three times.
+    let lastHandled = '';
+    return {
+        name: 'payload:dev-config-reload',
+        apply: 'serve',
+        configureServer (devServer) {
+            server = devServer;
+        },
+        hotUpdate ({ file, modules, timestamp }) {
+            if (!server) {
+                return;
+            }
+            const changeKey = `${file}:${timestamp}`;
+            if (changeKey === lastHandled) {
+                return;
+            }
+            if (!affectsPayloadConfig({
+                configFile,
+                file,
+                modules
+            })) {
+                return;
+            }
+            lastHandled = changeKey;
+            server.config.logger.info(`payload config changed, reloading Payload (${path.basename(file)})`, {
+                timestamp: true
+            });
+            // Broadcast to every environment rather than just `this.environment`: the
+            // changed module may only be in the graph of the environment that saw it,
+            // while the Payload instance was built in another. Each environment's
+            // runtime subscribes with its own copy of `payload`, and environments with
+            // no subscriber (e.g. `client`) simply ignore the event.
+            for (const environment of Object.values(server.environments)){
+                environment.hot.send({
+                    type: 'custom',
+                    event: PAYLOAD_CONFIG_CHANGED_EVENT
+                });
+            }
+        }
+    };
+}
+/**
+ * Whether `file` is the Payload config or something it imports. Walks *up*
+ * through importers, since the config sits at the root of that subtree.
+ */ function affectsPayloadConfig({ configFile, file, modules }) {
+    if (normalizePath(file) === configFile) {
+        return true;
+    }
+    const seen = new Set();
+    const queue = [
+        ...modules
+    ];
+    while(queue.length > 0){
+        const mod = queue.pop();
+        if (seen.has(mod)) {
+            continue;
+        }
+        seen.add(mod);
+        if (mod.file && normalizePath(mod.file) === configFile) {
+            return true;
+        }
+        for (const importer of mod.importers){
+            queue.push(importer);
+        }
+    }
+    return false;
+}
+
+//# sourceMappingURL=devConfigReload.js.map

package/dist/withPayload/devConfigReload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/withPayload/devConfigReload.ts"],"sourcesContent":["import type { EnvironmentModuleNode, PluginOption, ViteDevServer } from 'vite'\n\nimport path from 'node:path'\nimport { normalizePath } from 'vite'\n\nimport { PAYLOAD_CONFIG_CHANGED_EVENT } from '../utilities/devConfigReloadEvent.js'\n\n/**\n * Reloads Payload when `payload.config.ts`, or anything it imports, changes.\n *\n * Vite re-evaluates the config module on its own, but `getPayload` keeps\n * serving its cached instance until a `DevReloadStrategy` marks it stale. This\n * plugin only broadcasts the change; `devConfigReload.server.ts` subscribes\n * from inside the server runtime and marks the instance, which `getPayload`\n * then reloads on its next call.\n */\nexport function payloadDevConfigReload({\n  payloadConfigPath,\n}: {\n  payloadConfigPath: string\n}): PluginOption {\n  const configFile = normalizePath(path.resolve(payloadConfigPath))\n\n  let server: undefined | ViteDevServer\n\n  // Vite runs `hotUpdate` once per environment (client, ssr, rsc) per change,\n  // sharing one timestamp; without this the notice prints three times.\n  let lastHandled = ''\n\n  return {\n    name: 'payload:dev-config-reload',\n    apply: 'serve',\n    configureServer(devServer) {\n      server = devServer\n    },\n    hotUpdate({ file, modules, timestamp }) {\n      if (!server) {\n        return\n      }\n\n      const changeKey = `${file}:${timestamp}`\n\n      if (changeKey === lastHandled) {\n        return\n      }\n\n      if (!affectsPayloadConfig({ configFile, file, modules })) {\n        return\n      }\n\n      lastHandled = changeKey\n\n      server.config.logger.info(\n        `payload config changed, reloading Payload (${path.basename(file)})`,\n        { timestamp: true },\n      )\n\n      // Broadcast to every environment rather than just `this.environment`: the\n      // changed module may only be in the graph of the environment that saw it,\n      // while the Payload instance was built in another. Each environment's\n      // runtime subscribes with its own copy of `payload`, and environments with\n      // no subscriber (e.g. `client`) simply ignore the event.\n      for (const environment of Object.values(server.environments)) {\n        environment.hot.send({ type: 'custom', event: PAYLOAD_CONFIG_CHANGED_EVENT })\n      }\n    },\n  }\n}\n\n/**\n * Whether `file` is the Payload config or something it imports. Walks *up*\n * through importers, since the config sits at the root of that subtree.\n */\nfunction affectsPayloadConfig({\n  configFile,\n  file,\n  modules,\n}: {\n  configFile: string\n  file: string\n  modules: EnvironmentModuleNode[]\n}): boolean {\n  if (normalizePath(file) === configFile) {\n    return true\n  }\n\n  const seen = new Set<EnvironmentModuleNode>()\n  const queue = [...modules]\n\n  while (queue.length > 0) {\n    const mod = queue.pop()!\n\n    if (seen.has(mod)) {\n      continue\n    }\n    seen.add(mod)\n\n    if (mod.file && normalizePath(mod.file) === configFile) {\n      return true\n    }\n\n    for (const importer of mod.importers) {\n      queue.push(importer)\n    }\n  }\n\n  return false\n}\n"],"names":["path","normalizePath","PAYLOAD_CONFIG_CHANGED_EVENT","payloadDevConfigReload","payloadConfigPath","configFile","resolve","server","lastHandled","name","apply","configureServer","devServer","hotUpdate","file","modules","timestamp","changeKey","affectsPayloadConfig","config","logger","info","basename","environment","Object","values","environments","hot","send","type","event","seen","Set","queue","length","mod","pop","has","add","importer","importers","push"],"mappings":"AAEA,OAAOA,UAAU,YAAW;AAC5B,SAASC,aAAa,QAAQ,OAAM;AAEpC,SAASC,4BAA4B,QAAQ,uCAAsC;AAEnF;;;;;;;;CAQC,GACD,OAAO,SAASC,uBAAuB,EACrCC,iBAAiB,EAGlB;IACC,MAAMC,aAAaJ,cAAcD,KAAKM,OAAO,CAACF;IAE9C,IAAIG;IAEJ,4EAA4E;IAC5E,qEAAqE;IACrE,IAAIC,cAAc;IAElB,OAAO;QACLC,MAAM;QACNC,OAAO;QACPC,iBAAgBC,SAAS;YACvBL,SAASK;QACX;QACAC,WAAU,EAAEC,IAAI,EAAEC,OAAO,EAAEC,SAAS,EAAE;YACpC,IAAI,CAACT,QAAQ;gBACX;YACF;YAEA,MAAMU,YAAY,GAAGH,KAAK,CAAC,EAAEE,WAAW;YAExC,IAAIC,cAAcT,aAAa;gBAC7B;YACF;YAEA,IAAI,CAACU,qBAAqB;gBAAEb;gBAAYS;gBAAMC;YAAQ,IAAI;gBACxD;YACF;YAEAP,cAAcS;YAEdV,OAAOY,MAAM,CAACC,MAAM,CAACC,IAAI,CACvB,CAAC,2CAA2C,EAAErB,KAAKsB,QAAQ,CAACR,MAAM,CAAC,CAAC,EACpE;gBAAEE,WAAW;YAAK;YAGpB,0EAA0E;YAC1E,0EAA0E;YAC1E,sEAAsE;YACtE,2EAA2E;YAC3E,yDAAyD;YACzD,KAAK,MAAMO,eAAeC,OAAOC,MAAM,CAAClB,OAAOmB,YAAY,EAAG;gBAC5DH,YAAYI,GAAG,CAACC,IAAI,CAAC;oBAAEC,MAAM;oBAAUC,OAAO5B;gBAA6B;YAC7E;QACF;IACF;AACF;AAEA;;;CAGC,GACD,SAASgB,qBAAqB,EAC5Bb,UAAU,EACVS,IAAI,EACJC,OAAO,EAKR;IACC,IAAId,cAAca,UAAUT,YAAY;QACtC,OAAO;IACT;IAEA,MAAM0B,OAAO,IAAIC;IACjB,MAAMC,QAAQ;WAAIlB;KAAQ;IAE1B,MAAOkB,MAAMC,MAAM,GAAG,EAAG;QACvB,MAAMC,MAAMF,MAAMG,GAAG;QAErB,IAAIL,KAAKM,GAAG,CAACF,MAAM;YACjB;QACF;QACAJ,KAAKO,GAAG,CAACH;QAET,IAAIA,IAAIrB,IAAI,IAAIb,cAAckC,IAAIrB,IAAI,MAAMT,YAAY;YACtD,OAAO;QACT;QAEA,KAAK,MAAMkC,YAAYJ,IAAIK,SAAS,CAAE;YACpCP,MAAMQ,IAAI,CAACF;QACb;IACF;IAEA,OAAO;AACT"}

package/dist/withPayload/importProtection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importProtection.d.ts","sourceRoot":"","sources":["../../src/withPayload/importProtection.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAoB7D,CAAA;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAoC9E;AAED,eAAO,MAAM,sCAAsC,EAAE,MAAM,EAAsC,CAAA"}
+{"version":3,"file":"importProtection.d.ts","sourceRoot":"","sources":["../../src/withPayload/importProtection.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAoB7D,CAAA;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAmC9E;AAED,eAAO,MAAM,sCAAsC,EAAE,MAAM,EAAsC,CAAA"}

package/dist/withPayload/importProtection.js

@@ -11,7 +11,7 @@ import { builtinModules } from 'node:module';
     /^@payloadcms\/richtext-lexical\/rsc/,
     /^@payloadcms\/richtext-slate\/rsc/,
     '@payloadcms/ui/server',
-    /^@payloadcms\/tanstack-start\/(layouts|rsc|server|views\/server)/,
+    /^@payloadcms\/tanstack-start\/(layouts|rsc|server)/,
     'sharp',
     'busboy',
     'croner',
@@ -30,7 +30,7 @@ import { builtinModules } from 'node:module';
  * 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\//;
+    const allowedClientFileImporters = /\/richtext-lexical\/.*\/exports\/client\/|\/ui\//;
     if (info.envType === 'server' && info.resolved?.includes('.client.') && allowedClientFileImporters.test(info.importer)) {
         return false;
     }

package/dist/withPayload/importProtection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/withPayload/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"}
+{"version":3,"sources":["../../src/withPayload/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)/,\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 = /\\/richtext-lexical\\/.*\\/exports\\/client\\/|\\/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,6BAA6B;IAEnC,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/withPayload/index.d.ts

@@ -20,8 +20,13 @@ export type WithPayloadOptions = {
     /** Extra Vite config deep-merged over the Payload defaults. Ignored in `build` mode. */
     vite?: UserConfig;
 };
+/** The `nitro()` options Payload's server build requires. Typed structurally — `nitro` is the host's dependency, not Payload's. */
+export type PayloadNitroOptions = {
+    traceDeps: string[];
+};
 /** The options Payload's admin requires for each third-party plugin. */
 export type PayloadPluginOptions = {
+    nitro: PayloadNitroOptions;
     react: NonNullable<Parameters<typeof viteReact>[0]>;
     rsc: NonNullable<Parameters<typeof rsc>[0]>;
     tanstackStart: NonNullable<Parameters<typeof tanstackStart>[0]>;
@@ -58,6 +63,7 @@ export type WithPayloadBuilder = (context: WithPayloadBuilderContext) => UserCon
  *       rsc(pluginOptions.rsc),
  *       tanstackStart(pluginOptions.tanstackStart),
  *       viteReact(pluginOptions.react),
+ *       nitro(pluginOptions.nitro), // only if the app deploys through Nitro
  *     ],
  *     // ...other config options
  *   }),
@@ -68,6 +74,13 @@ export type WithPayloadBuilder = (context: WithPayloadBuilderContext) => UserCon
 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]>;
+/**
+ * `nitro/vite` options for Payload's server build. `tslib*` full-traces `tslib`
+ * so an externalized dep's `tslib/modules/index.js` import (its `import.node`
+ * export condition) ships — otherwise the build is green and the server 500s
+ * with `ERR_MODULE_NOT_FOUND` on the first request.
+ */
+export declare function payloadNitroOptions(): PayloadNitroOptions;
 /** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */
 export declare function payloadReactOptions(): NonNullable<Parameters<typeof viteReact>[0]>;
 export type PayloadTanstackStartOptionsArgs = {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/withPayload/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;AA8DpC,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,GAAG,EAAE,SAAS,CAAA;IACd,qFAAqF;IACrF,aAAa,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,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,CAwHpB;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/withPayload/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;AAyEpC,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,mIAAmI;AACnI,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,mBAAmB,CAAA;IAC1B,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,GAAG,EAAE,SAAS,CAAA;IACd,qFAAqF;IACrF,aAAa,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,UAAU,CAAA;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,GAAG,kBAAkB,EACrC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CA0HpB;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAEzD;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/withPayload/index.js

@@ -8,6 +8,7 @@ import { createLogger, mergeConfig } from 'vite';
 import { buildExternalPackages, payloadNoExternalPatterns, ssrExternalPackages } from './config/external.js';
 import { optimizeDepsExcludeDefaults, optimizeDepsIncludeDefaults } from './config/optimizeDeps.js';
 import { payloadScssImporters } from './config/scss.js';
+import { payloadDevConfigReload } from './devConfigReload.js';
 import { defaultImportProtectionIgnoreImporters, onImportProtectionViolation, serverOnlyClientSpecifiers } from './importProtection.js';
 import { clientModuleResolution } from './workarounds/clientModuleResolution.js';
 import { payloadDevTransforms } from './workarounds/devTransforms.js';
@@ -19,9 +20,16 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
  * Vite dependency warnings Payload consumers can't act on: third-party packages
  * ship sourcemaps whose original sources aren't published, so Vite warns on
  * every one. Suppressed by default (see `silenceDependencyWarnings`).
+ *
+ * `Failed to load source map` covers deps that ship a `sourceMappingURL` comment
+ * without the `.map` file it points at (e.g. `undici`'s `lib/llhttp/*.js`, pulled
+ * in via `@vercel/blob`). Vite appends the underlying `ENOENT` stack to that one,
+ * so each occurrence is a ~10-line block that buries real log output.
  */ const suppressibleWarningPatterns = [
     'points to missing source files',
-    'Sourcemap for'
+    'Sourcemap for',
+    'Failed to load source map',
+    'references a map file outside its package'
 ];
 /**
  * Wraps a Vite logger so warnings matching {@link suppressibleWarningPatterns}
@@ -70,6 +78,7 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
  *       rsc(pluginOptions.rsc),
  *       tanstackStart(pluginOptions.tanstackStart),
  *       viteReact(pluginOptions.react),
+ *       nitro(pluginOptions.nitro), // only if the app deploys through Nitro
  *     ],
  *     // ...other config options
  *   }),
@@ -151,7 +160,10 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
                 ssrStripDistStyleImports(),
                 reactDomServerInRsc(),
                 stubPrettierInClient(),
-                payloadDevTransforms()
+                payloadDevTransforms(),
+                payloadDevConfigReload({
+                    payloadConfigPath
+                })
             ],
             resolve: {
                 alias: [
@@ -184,6 +196,7 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
             }
         };
         const pluginOptions = {
+            nitro: payloadNitroOptions(),
             react: payloadReactOptions(),
             rsc: payloadRscOptions(),
             tanstackStart: payloadTanstackStartOptions({
@@ -215,6 +228,18 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
         serverHandler: false
     };
 }
+/**
+ * `nitro/vite` options for Payload's server build. `tslib*` full-traces `tslib`
+ * so an externalized dep's `tslib/modules/index.js` import (its `import.node`
+ * export condition) ships — otherwise the build is green and the server 500s
+ * with `ERR_MODULE_NOT_FOUND` on the first request.
+ */ export function payloadNitroOptions() {
+    return {
+        traceDeps: [
+            'tslib*'
+        ]
+    };
+}
 /** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */ export function payloadReactOptions() {
     return {
         exclude: [],
@@ -264,7 +289,7 @@ import { wrapCjsForClient } from './workarounds/wrapCjsForClient.js';
             },
             // Ignore generated importMap files and colocated `*.functions.ts` modules
             // (they define `createServerFn`s, not routes).
-            routeFileIgnorePattern: 'importMap\\.(?:js|server\\.ts)$|\\.functions\\.',
+            routeFileIgnorePattern: 'importMap\\.(?:d\\.ts|js|server\\.ts)$|\\.functions\\.',
             routesDirectory
         },
         rsc: {

package/dist/withPayload/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/withPayload/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 {\n  buildExternalPackages,\n  payloadNoExternalPatterns,\n  ssrExternalPackages,\n} 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  env: ConfigEnv\n  /** Options to pass to the `viteReact`/`rsc`/`tanstackStart` factories you import. */\n  pluginOptions: PayloadPluginOptions\n}\n\n/**\n * Returns the extra Vite config — the plugins you instantiate plus any overrides.\n * `withPayload` deep-merges it onto Payload's base config, so you don't spread or\n * merge the base yourself.\n */\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). Return only your additions;\n * `withPayload` deep-merges them onto Payload's base config:\n *\n * ```ts\n * export default withPayload(\n *   ({ pluginOptions }) => ({\n *     plugins: [\n *       rsc(pluginOptions.rsc),\n *       tanstackStart(pluginOptions.tanstackStart),\n *       viteReact(pluginOptions.react),\n *     ],\n *     // ...other config options\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    // `pluralize` ships a UMD wrapper that throws when run through Vite's dev SSR\n    // transform, so dev serve keeps it external and lets Node require it.\n    // The production build must bundle it instead: it is reached from the\n    // force-bundled `@payloadcms/ui` / `@payloadcms/translations`, and Vite would\n    // otherwise externalize it into a client chunk as a bare specifier that pnpm\n    // can't resolve from `dist/` at runtime. Dropping it from the externals list\n    // isn't enough — Vite externalizes deps of `noExternal` packages by default,\n    // so it must be forced back in via `noExternal`.\n    const isBuild = env.command === 'build'\n    const noExternalPatterns = isBuild\n      ? [...payloadNoExternalPatterns, 'pluralize']\n      : payloadNoExternalPatterns\n    // Dev serve externalizes the server-only Node packages (including `pluralize`,\n    // whose UMD wrapper breaks under Vite's SSR transform). The prod build instead\n    // externalizes the package boundaries (`buildExternalPackages`) and drops\n    // `pluralize` so it bundles — leaving it in `ssr.external` here would win over\n    // `noExternal` and re-emit the bare specifier.\n    const ssrExternal = isBuild ? buildExternalPackages : ssrExternalPackages\n\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: buildExternalPackages } },\n          resolve: { noExternal: noExternalPatterns },\n        },\n        ssr: {\n          build: { rollupOptions: { external: buildExternalPackages } },\n          resolve: { noExternal: noExternalPatterns },\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: ssrExternal,\n        noExternal: noExternalPatterns,\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        mergeConfig(base, build({ 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","buildExternalPackages","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","isBuild","command","noExternalPatterns","ssrExternal","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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"}
+{"version":3,"sources":["../../src/withPayload/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 {\n  buildExternalPackages,\n  payloadNoExternalPatterns,\n  ssrExternalPackages,\n} from './config/external.js'\nimport { optimizeDepsExcludeDefaults, optimizeDepsIncludeDefaults } from './config/optimizeDeps.js'\nimport { payloadScssImporters } from './config/scss.js'\nimport { payloadDevConfigReload } from './devConfigReload.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 *\n * `Failed to load source map` covers deps that ship a `sourceMappingURL` comment\n * without the `.map` file it points at (e.g. `undici`'s `lib/llhttp/*.js`, pulled\n * in via `@vercel/blob`). Vite appends the underlying `ENOENT` stack to that one,\n * so each occurrence is a ~10-line block that buries real log output.\n */\nconst suppressibleWarningPatterns = [\n  'points to missing source files',\n  'Sourcemap for',\n  'Failed to load source map',\n  'references a map file outside its package',\n]\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 `nitro()` options Payload's server build requires. Typed structurally — `nitro` is the host's dependency, not Payload's. */\nexport type PayloadNitroOptions = {\n  traceDeps: string[]\n}\n\n/** The options Payload's admin requires for each third-party plugin. */\nexport type PayloadPluginOptions = {\n  nitro: PayloadNitroOptions\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  env: ConfigEnv\n  /** Options to pass to the `viteReact`/`rsc`/`tanstackStart` factories you import. */\n  pluginOptions: PayloadPluginOptions\n}\n\n/**\n * Returns the extra Vite config — the plugins you instantiate plus any overrides.\n * `withPayload` deep-merges it onto Payload's base config, so you don't spread or\n * merge the base yourself.\n */\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). Return only your additions;\n * `withPayload` deep-merges them onto Payload's base config:\n *\n * ```ts\n * export default withPayload(\n *   ({ pluginOptions }) => ({\n *     plugins: [\n *       rsc(pluginOptions.rsc),\n *       tanstackStart(pluginOptions.tanstackStart),\n *       viteReact(pluginOptions.react),\n *       nitro(pluginOptions.nitro), // only if the app deploys through Nitro\n *     ],\n *     // ...other config options\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    // `pluralize` ships a UMD wrapper that throws when run through Vite's dev SSR\n    // transform, so dev serve keeps it external and lets Node require it.\n    // The production build must bundle it instead: it is reached from the\n    // force-bundled `@payloadcms/ui` / `@payloadcms/translations`, and Vite would\n    // otherwise externalize it into a client chunk as a bare specifier that pnpm\n    // can't resolve from `dist/` at runtime. Dropping it from the externals list\n    // isn't enough — Vite externalizes deps of `noExternal` packages by default,\n    // so it must be forced back in via `noExternal`.\n    const isBuild = env.command === 'build'\n    const noExternalPatterns = isBuild\n      ? [...payloadNoExternalPatterns, 'pluralize']\n      : payloadNoExternalPatterns\n    // Dev serve externalizes the server-only Node packages (including `pluralize`,\n    // whose UMD wrapper breaks under Vite's SSR transform). The prod build instead\n    // externalizes the package boundaries (`buildExternalPackages`) and drops\n    // `pluralize` so it bundles — leaving it in `ssr.external` here would win over\n    // `noExternal` and re-emit the bare specifier.\n    const ssrExternal = isBuild ? buildExternalPackages : ssrExternalPackages\n\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: buildExternalPackages } },\n          resolve: { noExternal: noExternalPatterns },\n        },\n        ssr: {\n          build: { rollupOptions: { external: buildExternalPackages } },\n          resolve: { noExternal: noExternalPatterns },\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        payloadDevConfigReload({ payloadConfigPath }),\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: ssrExternal,\n        noExternal: noExternalPatterns,\n      },\n    }\n\n    const pluginOptions: PayloadPluginOptions = {\n      nitro: payloadNitroOptions(),\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        mergeConfig(base, build({ 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/**\n * `nitro/vite` options for Payload's server build. `tslib*` full-traces `tslib`\n * so an externalized dep's `tslib/modules/index.js` import (its `import.node`\n * export condition) ships — otherwise the build is green and the server 500s\n * with `ERR_MODULE_NOT_FOUND` on the first request.\n */\nexport function payloadNitroOptions(): PayloadNitroOptions {\n  return { traceDeps: ['tslib*'] }\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\\\\.(?:d\\\\.ts|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","buildExternalPackages","payloadNoExternalPatterns","ssrExternalPackages","optimizeDepsExcludeDefaults","optimizeDepsIncludeDefaults","payloadScssImporters","payloadDevConfigReload","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","isBuild","command","noExternalPatterns","ssrExternal","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","nitro","payloadNitroOptions","react","payloadReactOptions","payloadRscOptions","payloadTanstackStartOptions","merged","serverHandler","traceDeps","args","importProtection","client","excludeFiles","specifiers","ignoreImporters","mockAccess","onViolation","server","router","codeSplittingOptions","splitBehavior","routeId","startsWith","undefined","routeFileIgnorePattern"],"mappings":"AAEA,kFAAkF;AAClF,2DAA2D;AAC3D,SAASA,aAAa,QAAQ,oCAAmC;AACjE,OAAOC,eAAe,uBAAsB;AAC5C,OAAOC,SAAS,qBAAoB;AACpC,OAAOC,UAAU,YAAW;AAC5B,SAASC,YAAY,EAAEC,WAAW,QAAQ,OAAM;AAEhD,SACEC,qBAAqB,EACrBC,yBAAyB,EACzBC,mBAAmB,QACd,uBAAsB;AAC7B,SAASC,2BAA2B,EAAEC,2BAA2B,QAAQ,2BAA0B;AACnG,SAASC,oBAAoB,QAAQ,mBAAkB;AACvD,SAASC,sBAAsB,QAAQ,uBAAsB;AAC7D,SACEC,sCAAsC,EACtCC,2BAA2B,EAC3BC,0BAA0B,QACrB,wBAAuB;AAC9B,SAASC,sBAAsB,QAAQ,0CAAyC;AAChF,SAASC,oBAAoB,QAAQ,iCAAgC;AACrE,SAASC,mBAAmB,QAAQ,uCAAsC;AAC1E,SAASC,wBAAwB,QAAQ,yCAAwC;AACjF,SAASC,oBAAoB,QAAQ,wCAAuC;AAC5E,SAASC,gBAAgB,QAAQ,oCAAmC;AAEpE;;;;;;;;;CASC,GACD,MAAMC,8BAA8B;IAClC;IACA;IACA;IACA;CACD;AAED;;;CAGC,GACD,SAASC,8BAA8BC,QAAiB;IACtD,MAAMC,SAASD,YAAYpB;IAC3B,MAAMsB,iBAAiB,CAACC,MACtB,OAAOA,QAAQ,YAAYL,4BAA4BM,IAAI,CAAC,CAACC,UAAYF,IAAIG,QAAQ,CAACD;IAExF,MAAME,WAAWN,OAAOO,IAAI,CAACC,IAAI,CAACR;IAClC,MAAMS,eAAeT,OAAOU,QAAQ,CAACF,IAAI,CAACR;IAC1CA,OAAOO,IAAI,GAAG,CAACL,KAAKS;QAClB,IAAI,CAACV,eAAeC,MAAM;YACxBI,SAASJ,KAAKS;QAChB;IACF;IACAX,OAAOU,QAAQ,GAAG,CAACR,KAAKS;QACtB,IAAI,CAACV,eAAeC,MAAM;YACxBO,aAAaP,KAAKS;QACpB;IACF;IACA,OAAOX;AACT;AAEA,8EAA8E,GAC9E,SAASY,kCAAkCC,MAAkB,EAAEC,OAAgB;IAC7E,IAAIA,SAAS;QACXD,OAAOE,YAAY,GAAGjB,8BAA8Be,OAAOE,YAAY;IACzE;IACA,OAAOF;AACT;AA+CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BC,GACD,OAAO,SAASG,YACdC,KAAqC,EACrCN,OAA2B;IAE3B,MAAM,EACJO,4BAA4B,EAAE,EAC9BC,YAAY,EACZC,2BAA2B,EAAE,EAC7BC,iBAAiB,EACjBC,kBAAkB,KAAK,EACvBC,4BAA4B,IAAI,EAChCC,eAAe,KAAK,EACpBC,IAAI,EACL,GAAGd;IAEJ,OAAO,CAACe;QACN,8EAA8E;QAC9E,sEAAsE;QACtE,sEAAsE;QACtE,8EAA8E;QAC9E,6EAA6E;QAC7E,6EAA6E;QAC7E,6EAA6E;QAC7E,iDAAiD;QACjD,MAAMC,UAAUD,IAAIE,OAAO,KAAK;QAChC,MAAMC,qBAAqBF,UACvB;eAAI7C;YAA2B;SAAY,GAC3CA;QACJ,+EAA+E;QAC/E,+EAA+E;QAC/E,0EAA0E;QAC1E,+EAA+E;QAC/E,+CAA+C;QAC/C,MAAMgD,cAAcH,UAAU9C,wBAAwBE;QAEtD,MAAMgD,OAAmB;YACvBd,OAAO;gBACLe,WAAW;YACb;YACAC,KAAK;gBACHC,qBAAqB;oBACnBC,MAAM;wBACJC,WAAWlD;wBACXmD,qBAAqB;4BAAC;4BAAU;yBAAiB;oBACnD;gBACF;YACF;YACAC,QAAQ;gBACNC,QAAQ;YACV;YACAC,cAAc;gBACZ/D,KAAK;oBACHwC,OAAO;wBAAEwB,eAAe;4BAAEC,UAAU7D;wBAAsB;oBAAE;oBAC5D8D,SAAS;wBAAEC,YAAYf;oBAAmB;gBAC5C;gBACAgB,KAAK;oBACH5B,OAAO;wBAAEwB,eAAe;4BAAEC,UAAU7D;wBAAsB;oBAAE;oBAC5D8D,SAAS;wBAAEC,YAAYf;oBAAmB;gBAC5C;YACF;YACAiB,cAAc;gBACZC,SAAS/D;gBACTgE,SAAS/D;YACX;YACA,2EAA2E;YAC3E,uEAAuE;YACvE,iCAAiC;YACjCgE,SAAS;gBACP1D;gBACAK;gBACAF;gBACAD;gBACAE;gBACAH;gBACAL,uBAAuB;oBAAEkC;gBAAkB;aAC5C;YACDsB,SAAS;gBACPO,OAAO;oBAAC;wBAAEC,MAAM;wBAAmBC,aAAa1E,KAAKiE,OAAO,CAACtB;oBAAmB;iBAAE;gBAClFgC,QAAQ;oBACN;oBACA;oBACA;oBACA;oBACA;iBACD;gBACDC,YAAY;oBAAC;oBAAQ;oBAAO;oBAAQ;oBAAO;oBAAQ;oBAAQ;iBAAQ;gBACnEC,eAAe;YACjB;YACAV,KAAK;gBACHH,UAAUZ;gBACVc,YAAYf;YACd;QACF;QAEA,MAAM2B,gBAAsC;YAC1CC,OAAOC;YACPC,OAAOC;YACPnF,KAAKoF;YACLtF,eAAeuF,4BAA4B;gBACzC5C;gBACAC;gBACAC;gBACAE;gBACAE;YACF;QACF;QAEA,IAAIP,OAAO;YACT,OAAOL,kCACLhC,YAAYmD,MAAMd,MAAM;gBAAES;gBAAK8B;YAAc,KAC7CjC;QAEJ;QAEAQ,KAAKkB,OAAO,GAAG;eACTlB,KAAKkB,OAAO;YAChBxE,IAAI+E,cAAc/E,GAAG;YACrBF,cAAciF,cAAcjF,aAAa;YACzCC,UAAUgF,cAAcG,KAAK;SAC9B;QAED,MAAMI,SAAStC,OAAO7C,YAAYmD,MAAMN,QAAQM;QAEhD,OAAOnB,kCAAkCmD,QAAQxC;IACnD;AACF;AAEA,kGAAkG,GAClG,OAAO,SAASsC;IACd,OAAO;QAAEG,eAAe;IAAM;AAChC;AAEA;;;;;CAKC,GACD,OAAO,SAASN;IACd,OAAO;QAAEO,WAAW;YAAC;SAAS;IAAC;AACjC;AAEA,iFAAiF,GACjF,OAAO,SAASL;IACd,OAAO;QAAEb,SAAS,EAAE;QAAEC,SAAS;IAAa;AAC9C;AAuBA;;;;CAIC,GACD,OAAO,SAASc,4BACdI,OAAwC,CAAC,CAAC;IAE1C,MAAM,EACJhD,4BAA4B,EAAE,EAC9BC,eAAe,WAAW,EAC1BC,2BAA2B,EAAE,EAC7BE,kBAAkB,KAAK,EACvBE,eAAe,KAAK,EACrB,GAAG0C;IAEJ,OAAO;QACLC,kBAAkB;YAChBC,QAAQ;gBAAEC,cAAc,EAAE;gBAAEC,YAAYhF;YAA2B;YACnEiF,iBAAiB;mBAAInF;mBAA2C8B;aAA0B;YAC1F8B,SAAS;gBAAC;aAAO;YACjBwB,YAAY;YACZC,aAAapF;YACb,4EAA4E;YAC5E,wEAAwE;YACxE,2EAA2E;YAC3E,yEAAyE;YACzE,oEAAoE;YACpEqF,QAAQ;gBAAEL,cAAc;oBAAC;uBAAyBjD;iBAAyB;YAAC;QAC9E;QACAuD,QAAQ;YACNC,sBAAsB;gBACpB,0EAA0E;gBAC1E,2EAA2E;gBAC3E,0EAA0E;gBAC1E,gEAAgE;gBAChEC,eAAe,CAAC,EAAEC,OAAO,EAAuB,GAC9CA,YAAY3D,gBAAgB2D,QAAQC,UAAU,CAAC,GAAG5D,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG6D;YAC9E;YACA,0EAA0E;YAC1E,+CAA+C;YAC/CC,wBAAwB;YACxB3D;QACF;QACA7C,KAAK;YAAEqC,SAAS;QAAK;QACrBU;IACF;AACF"}

package/dist/withPayload/workarounds/stripDistStyleImports.js

@@ -37,7 +37,7 @@ const STYLE_EXTENSION_RE = /\.(?:s?css|less)$/i;
  *    blowing past the e2e waits. Stripping them collapses it back to ~3s.
  *
  * Safe because every one of these components' styles also ship in the global
- * `@payloadcms/ui/scss/app.scss` the admin imports, so dropping the per-module
+ * `@payloadcms/ui/css/app.css` the admin imports, so dropping the per-module
  * RSC collection here changes nothing visually (verified: diff + Nav stay
  * styled). The admin `Nav` etc. are deliberately excluded — they rely on the
  * RSC collection and a broad strip leaves them unstyled.

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/tanstack-start",
-  "version": "4.0.0-internal.dee5eab",
+  "version": "4.0.0-internal.e38d3ac",
   "description": "TanStack Start framework adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -58,8 +58,8 @@
   ],
   "dependencies": {
     "qs-esm": "^7.0.2",
-    "@payloadcms/translations": "4.0.0-internal.dee5eab",
-    "@payloadcms/ui": "4.0.0-internal.dee5eab"
+    "@payloadcms/translations": "4.0.0-internal.e38d3ac",
+    "@payloadcms/ui": "4.0.0-internal.e38d3ac"
   },
   "devDependencies": {
     "@tanstack/react-router": "^1.120.0",
@@ -71,7 +71,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": ">=8.0.0",
-    "payload": "4.0.0-internal.dee5eab"
+    "payload": "4.0.0-internal.e38d3ac"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.120.0",
@@ -81,7 +81,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": ">=8.0.0",
-    "payload": "4.0.0-internal.dee5eab"
+    "payload": "4.0.0-internal.e38d3ac"
   },
   "peerDependenciesMeta": {
     "@vitejs/plugin-react": {
@@ -98,7 +98,7 @@
     "node": "^18.20.2 || >=20.9.0"
   },
   "scripts": {
-    "build": "pnpm build:types && pnpm build:swc && pnpm build:copy-mjs",
+    "build": "pnpm build:types && pnpm test:types && pnpm build:swc && pnpm build:copy-mjs",
     "build:clean": "find . \\( -type d \\( -name build -o -name dist -o -name .cache \\) -o -type f -name tsconfig.tsbuildinfo \\) -exec rm -rf {} + && pnpm build",
     "build:copy-mjs": "node ./scripts/copyMjs.mjs",
     "build:debug": "pnpm build",
@@ -106,6 +106,7 @@
     "build:types": "tsc --emitDeclarationOnly --outDir dist",
     "clean": "rimraf {dist,*.tsbuildinfo}",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "test:types": "tsc --project test/tsconfig.json"
   }
 }

package/dist/elements/DocumentHeaderClient/index.d.ts

@@ -1,16 +0,0 @@
-import type { ImportMap } from 'payload';
-import '@payloadcms/ui/elements/DocumentHeader/index.scss';
-import '@payloadcms/ui/elements/DocumentHeader/Tabs/index.scss';
-import '@payloadcms/ui/elements/DocumentHeader/Tabs/Tab/index.scss';
-import React from 'react';
-/**
- * Client-only DocumentHeader for non-RSC adapters.
- * Uses hooks to obtain config, permissions, and i18n instead of requiring `req`.
- */
-export declare function DocumentHeaderClient({ collectionSlug, globalSlug, hideTabs, importMap, }: {
-    collectionSlug?: string;
-    globalSlug?: string;
-    hideTabs?: boolean;
-    importMap: ImportMap;
-}): React.JSX.Element;
-//# sourceMappingURL=index.d.ts.map

package/dist/elements/DocumentHeaderClient/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/DocumentHeaderClient/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,SAAS,CAAA;AAG3D,OAAO,mDAAmD,CAAA;AAC1D,OAAO,wDAAwD,CAAA;AAC/D,OAAO,4DAA4D,CAAA;AAKnE,OAAO,KAAmB,MAAM,OAAO,CAAA;AAKvC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACV,EAAE;IACD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;CACrB,qBAsGA"}