@payloadcms/tanstack-start 4.0.0-internal.bc5cf8c → 4.0.0-internal.c7d5de4

package/dist/utilities/meta.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/meta.ts"],"sourcesContent":["type MetaEntry =\n  | { charSet: string }\n  | { content: string; name: string }\n  | { content: string; property: string }\n  | { title: string }\n\ntype LinkEntry = {\n  href: string\n  media?: string\n  rel: string\n  sizes?: string\n  type?: string\n}\n\ntype AdminPageIcon = {\n  media?: string\n  rel?: string\n  sizes?: string\n  type?: string\n  url: string\n}\n\ntype AdminPageOGImage = {\n  alt?: string\n  height?: number\n  url: string\n  width?: number\n}\n\n/**\n * Resolved admin-page metadata produced by the admin-page server function.\n *\n * The server function resolves the framework-agnostic `MetaConfig` (via the\n * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable\n * values, so the route loader can ship it across the wire and feed it to\n * `getAdminMeta` in `head()`.\n */\nexport type AdminPageMetadata = {\n  description?: string\n  icons?: AdminPageIcon[]\n  keywords?: string\n  openGraph?: {\n    description?: string\n    images?: AdminPageOGImage[]\n    siteName?: string\n    title?: string\n  }\n  robots?: string\n  title?: string\n}\n\n/**\n * Builds TanStack Router `head()` `meta` + `links` entries for an admin page\n * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders\n * natively from the same `MetaConfig` (title, description, robots, keywords,\n * OpenGraph, Twitter — derived from OpenGraph — and icon links).\n *\n * ```ts\n * export const Route = createFileRoute('/admin/$')({\n *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),\n * })\n * ```\n */\nexport function getAdminMeta(metadata?: AdminPageMetadata): {\n  links: LinkEntry[]\n  meta: MetaEntry[]\n} {\n  const meta: MetaEntry[] = [\n    { charSet: 'utf-8' },\n    { name: 'viewport', content: 'width=device-width, initial-scale=1' },\n  ]\n  const links: LinkEntry[] = []\n\n  if (!metadata) {\n    return { links, meta }\n  }\n\n  if (metadata.title) {\n    meta.push({ title: metadata.title })\n  }\n  if (metadata.description) {\n    meta.push({ name: 'description', content: metadata.description })\n  }\n  if (metadata.keywords) {\n    meta.push({ name: 'keywords', content: metadata.keywords })\n  }\n  if (metadata.robots) {\n    meta.push({ name: 'robots', content: metadata.robots })\n  }\n\n  const og = metadata.openGraph\n  if (og) {\n    if (og.title) {\n      meta.push({ content: og.title, property: 'og:title' })\n    }\n    if (og.description) {\n      meta.push({ content: og.description, property: 'og:description' })\n    }\n    if (og.siteName) {\n      meta.push({ content: og.siteName, property: 'og:site_name' })\n    }\n\n    for (const image of og.images ?? []) {\n      meta.push({ content: image.url, property: 'og:image' })\n      if (image.width) {\n        meta.push({ content: String(image.width), property: 'og:image:width' })\n      }\n      if (image.height) {\n        meta.push({ content: String(image.height), property: 'og:image:height' })\n      }\n      if (image.alt) {\n        meta.push({ content: image.alt, property: 'og:image:alt' })\n      }\n    }\n\n    // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).\n    const firstImage = og.images?.[0]\n    if (firstImage) {\n      meta.push({ name: 'twitter:card', content: 'summary_large_image' })\n      meta.push({ name: 'twitter:image', content: firstImage.url })\n    }\n    if (og.title) {\n      meta.push({ name: 'twitter:title', content: og.title })\n    }\n    if (og.description) {\n      meta.push({ name: 'twitter:description', content: og.description })\n    }\n  }\n\n  for (const icon of metadata.icons ?? []) {\n    links.push({\n      href: icon.url,\n      rel: icon.rel ?? 'icon',\n      ...(icon.media ? { media: icon.media } : {}),\n      ...(icon.sizes ? { sizes: icon.sizes } : {}),\n      ...(icon.type ? { type: icon.type } : {}),\n    })\n  }\n\n  return { links, meta }\n}\n"],"names":["getAdminMeta","metadata","meta","charSet","name","content","links","title","push","description","keywords","robots","og","openGraph","property","siteName","image","images","url","width","String","height","alt","firstImage","icon","icons","href","rel","media","sizes","type"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/meta.ts"],"sourcesContent":["import { getViewportContent } from '@payloadcms/ui/shared'\n\ntype MetaEntry =\n  | { charSet: string }\n  | { content: string; name: string }\n  | { content: string; property: string }\n  | { title: string }\n\ntype LinkEntry = {\n  href: string\n  media?: string\n  rel: string\n  sizes?: string\n  type?: string\n}\n\ntype AdminPageIcon = {\n  media?: string\n  rel?: string\n  sizes?: string\n  type?: string\n  url: string\n}\n\ntype AdminPageOGImage = {\n  alt?: string\n  height?: number\n  url: string\n  width?: number\n}\n\n/**\n * Resolved admin-page metadata produced by the admin-page server function.\n *\n * The server function resolves the framework-agnostic `MetaConfig` (via the\n * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable\n * values, so the route loader can ship it across the wire and feed it to\n * `getAdminMeta` in `head()`.\n */\nexport type AdminPageMetadata = {\n  description?: string\n  icons?: AdminPageIcon[]\n  keywords?: string\n  openGraph?: {\n    description?: string\n    images?: AdminPageOGImage[]\n    siteName?: string\n    title?: string\n  }\n  robots?: string\n  title?: string\n  viewport?: string\n}\n\n/**\n * Builds TanStack Router `head()` `meta` + `links` entries for an admin page\n * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders\n * natively from the same `MetaConfig` (title, description, robots, keywords,\n * OpenGraph, Twitter — derived from OpenGraph — and icon links).\n *\n * ```ts\n * export const Route = createFileRoute('/admin/$')({\n *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),\n * })\n * ```\n */\nexport function getAdminMeta(metadata?: AdminPageMetadata): {\n  links: LinkEntry[]\n  meta: MetaEntry[]\n} {\n  const meta: MetaEntry[] = [\n    { charSet: 'utf-8' },\n    { name: 'viewport', content: metadata?.viewport ?? getViewportContent() },\n  ]\n  const links: LinkEntry[] = []\n\n  if (!metadata) {\n    return { links, meta }\n  }\n\n  if (metadata.title) {\n    meta.push({ title: metadata.title })\n  }\n  if (metadata.description) {\n    meta.push({ name: 'description', content: metadata.description })\n  }\n  if (metadata.keywords) {\n    meta.push({ name: 'keywords', content: metadata.keywords })\n  }\n  if (metadata.robots) {\n    meta.push({ name: 'robots', content: metadata.robots })\n  }\n\n  const og = metadata.openGraph\n  if (og) {\n    if (og.title) {\n      meta.push({ content: og.title, property: 'og:title' })\n    }\n    if (og.description) {\n      meta.push({ content: og.description, property: 'og:description' })\n    }\n    if (og.siteName) {\n      meta.push({ content: og.siteName, property: 'og:site_name' })\n    }\n\n    for (const image of og.images ?? []) {\n      meta.push({ content: image.url, property: 'og:image' })\n      if (image.width) {\n        meta.push({ content: String(image.width), property: 'og:image:width' })\n      }\n      if (image.height) {\n        meta.push({ content: String(image.height), property: 'og:image:height' })\n      }\n      if (image.alt) {\n        meta.push({ content: image.alt, property: 'og:image:alt' })\n      }\n    }\n\n    // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).\n    const firstImage = og.images?.[0]\n    if (firstImage) {\n      meta.push({ name: 'twitter:card', content: 'summary_large_image' })\n      meta.push({ name: 'twitter:image', content: firstImage.url })\n    }\n    if (og.title) {\n      meta.push({ name: 'twitter:title', content: og.title })\n    }\n    if (og.description) {\n      meta.push({ name: 'twitter:description', content: og.description })\n    }\n  }\n\n  for (const icon of metadata.icons ?? []) {\n    links.push({\n      href: icon.url,\n      rel: icon.rel ?? 'icon',\n      ...(icon.media ? { media: icon.media } : {}),\n      ...(icon.sizes ? { sizes: icon.sizes } : {}),\n      ...(icon.type ? { type: icon.type } : {}),\n    })\n  }\n\n  return { links, meta }\n}\n"],"names":["getViewportContent","getAdminMeta","metadata","meta","charSet","name","content","viewport","links","title","push","description","keywords","robots","og","openGraph","property","siteName","image","images","url","width","String","height","alt","firstImage","icon","icons","href","rel","media","sizes","type"],"mappings":"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"}

package/dist/utilities/routerSearch.d.ts

@@ -0,0 +1,40 @@
+import * as qs from 'qs-esm';
+/**
+ * `parseSearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadStringifySearch}.
+ *
+ * Payload serializes query state (notably the list-view `where` filter) with
+ * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack
+ * Router's default serializer treats each bracketed string as a flat key and
+ * JSON-encodes values, so it never round-trips Payload's nested query: every
+ * navigation re-encodes the already-encoded value, exponentially nesting it
+ * (`[true,"[true,\"[true…"]`) until the filter is unusable. Parsing and
+ * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps
+ * the URL idempotent and the nested `where` intact across navigations.
+ *
+ * This is a router-global serializer: it applies to every route, not just
+ * `/admin`. On your own routes, search values arrive as strings (qs does no
+ * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where
+ * you need numbers or booleans.
+ *
+ * @example
+ * ```ts
+ * import { createRouter } from '@tanstack/react-router'
+ * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'
+ *
+ * export function getRouter() {
+ *   return createRouter({
+ *     parseSearch: payloadParseSearch,
+ *     routeTree,
+ *     stringifySearch: payloadStringifySearch,
+ *   })
+ * }
+ * ```
+ */
+export declare const payloadParseSearch: (searchStr: string) => qs.ParsedQs;
+/**
+ * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.
+ */
+export declare const payloadStringifySearch: (search: Record<string, unknown>) => string;
+//# sourceMappingURL=routerSearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routerSearch.d.ts","sourceRoot":"","sources":["../../src/utilities/routerSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,QAAQ,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kBAAkB,cAAe,MAAM,gBACS,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,WAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAGrE,CAAA"}

package/dist/utilities/routerSearch.js

@@ -0,0 +1,45 @@
+import * as qs from 'qs-esm';
+/**
+ * `parseSearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadStringifySearch}.
+ *
+ * Payload serializes query state (notably the list-view `where` filter) with
+ * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack
+ * Router's default serializer treats each bracketed string as a flat key and
+ * JSON-encodes values, so it never round-trips Payload's nested query: every
+ * navigation re-encodes the already-encoded value, exponentially nesting it
+ * (`[true,"[true,\"[true…"]`) until the filter is unusable. Parsing and
+ * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps
+ * the URL idempotent and the nested `where` intact across navigations.
+ *
+ * This is a router-global serializer: it applies to every route, not just
+ * `/admin`. On your own routes, search values arrive as strings (qs does no
+ * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where
+ * you need numbers or booleans.
+ *
+ * @example
+ * ```ts
+ * import { createRouter } from '@tanstack/react-router'
+ * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'
+ *
+ * export function getRouter() {
+ *   return createRouter({
+ *     parseSearch: payloadParseSearch,
+ *     routeTree,
+ *     stringifySearch: payloadStringifySearch,
+ *   })
+ * }
+ * ```
+ */ export const payloadParseSearch = (searchStr)=>qs.parse(searchStr, {
+        depth: 10,
+        ignoreQueryPrefix: true
+    });
+/**
+ * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's
+ * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.
+ */ export const payloadStringifySearch = (search)=>{
+    const searchStr = qs.stringify(search);
+    return searchStr ? `?${searchStr}` : '';
+};
+
+//# sourceMappingURL=routerSearch.js.map

package/dist/utilities/routerSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/routerSearch.ts"],"sourcesContent":["import * as qs from 'qs-esm'\n\n/**\n * `parseSearch` for TanStack Router's `createRouter`, required for Payload's\n * admin UI. Pair with {@link payloadStringifySearch}.\n *\n * Payload serializes query state (notably the list-view `where` filter) with\n * `qs` bracket notation — e.g. `?where[or][0][and][0][x][equals]=y`. TanStack\n * Router's default serializer treats each bracketed string as a flat key and\n * JSON-encodes values, so it never round-trips Payload's nested query: every\n * navigation re-encodes the already-encoded value, exponentially nesting it\n * (`[true,\"[true,\\\"[true…\"]`) until the filter is unusable. Parsing and\n * stringifying with `qs` (same options as `payload`/`@payloadcms/ui`) keeps\n * the URL idempotent and the nested `where` intact across navigations.\n *\n * This is a router-global serializer: it applies to every route, not just\n * `/admin`. On your own routes, search values arrive as strings (qs does no\n * JSON type-coercion), so coerce in `validateSearch` (e.g. `Number(...)`) where\n * you need numbers or booleans.\n *\n * @example\n * ```ts\n * import { createRouter } from '@tanstack/react-router'\n * import { payloadParseSearch, payloadStringifySearch } from '@payloadcms/tanstack-start'\n *\n * export function getRouter() {\n *   return createRouter({\n *     parseSearch: payloadParseSearch,\n *     routeTree,\n *     stringifySearch: payloadStringifySearch,\n *   })\n * }\n * ```\n */\nexport const payloadParseSearch = (searchStr: string) =>\n  qs.parse(searchStr, { depth: 10, ignoreQueryPrefix: true })\n\n/**\n * `stringifySearch` for TanStack Router's `createRouter`, required for Payload's\n * admin UI. Pair with {@link payloadParseSearch}; see it for the full rationale.\n */\nexport const payloadStringifySearch = (search: Record<string, unknown>) => {\n  const searchStr = qs.stringify(search)\n  return searchStr ? `?${searchStr}` : ''\n}\n"],"names":["qs","payloadParseSearch","searchStr","parse","depth","ignoreQueryPrefix","payloadStringifySearch","search","stringify"],"mappings":"AAAA,YAAYA,QAAQ,SAAQ;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BC,GACD,OAAO,MAAMC,qBAAqB,CAACC,YACjCF,GAAGG,KAAK,CAACD,WAAW;QAAEE,OAAO;QAAIC,mBAAmB;IAAK,GAAE;AAE7D;;;CAGC,GACD,OAAO,MAAMC,yBAAyB,CAACC;IACrC,MAAML,YAAYF,GAAGQ,SAAS,CAACD;IAC/B,OAAOL,YAAY,CAAC,CAAC,EAAEA,WAAW,GAAG;AACvC,EAAC"}

package/dist/utilities/serverAdapter.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serverAdapter.server.d.ts","sourceRoot":"","sources":["../../src/utilities/serverAdapter.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,SAAS,CAAA;AAsDxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA8CnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,GAAI,KAAK,aAAa,KAAG,aAgBjE,CAAA"}
+{"version":3,"file":"serverAdapter.server.d.ts","sourceRoot":"","sources":["../../src/utilities/serverAdapter.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,SAAS,CAAA;AAsDxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA8CnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,QAAS,aAAa,KAAG,aAgBjE,CAAA"}

package/dist/vite/config/external.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SSR/RSC externalization config used by `withPayload`. Kept separate from the
+ * client optimizer config (`./optimizeDeps.ts`) so each concern stays small.
+ */
+/**
+ * Server-only packages (Node-only or only ever used by the server bundle).
+ * These are the Vite equivalent of Next.js's `serverExternalPackages`.
+ */
+export declare const ssrExternalPackages: string[];
+/**
+ * External packages for the production `vite build` only (not dev serve).
+ *
+ * Externalizes the `@payloadcms/*` package boundaries — plus `payload` — so each
+ * resolves its own transitive Node deps (`pino`, `drizzle-orm`, `libsql`, …) from
+ * its own `node_modules` at runtime. Externalizing only the leaf deps breaks under
+ * pnpm: a leaf imported by bundled code becomes an unresolvable bare specifier from
+ * `dist/`, since pnpm does not hoist it.
+ *
+ * Kept out of dev's `ssr.external` on purpose: the monorepo resolves these to
+ * TypeScript source (`.ts` imported via `.js` specifiers), which only Vite's
+ * transform can resolve — an externalized copy would hit Node's raw resolver and
+ * fail on the `.js`→`.ts` mismatch.
+ */
+export declare const buildExternalPackages: string[];
+export declare const payloadNoExternalPatterns: Array<RegExp | string>;
+//# sourceMappingURL=external.d.ts.map

package/dist/vite/config/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/vite/config/external.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EA+BvC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAUzC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAO5D,CAAA"}

package/dist/vite/config/external.js

@@ -0,0 +1,72 @@
+/**
+ * SSR/RSC externalization config used by `withPayload`. Kept separate from the
+ * client optimizer config (`./optimizeDeps.ts`) so each concern stays small.
+ */ /**
+ * Server-only packages (Node-only or only ever used by the server bundle).
+ * These are the Vite equivalent of Next.js's `serverExternalPackages`.
+ */ export const ssrExternalPackages = [
+    'ajv',
+    'fast-uri',
+    'drizzle-kit',
+    'drizzle-kit/api',
+    'drizzle-orm',
+    'sharp',
+    'require-in-the-middle',
+    'json-schema-to-typescript',
+    'pino',
+    'pino-pretty',
+    'graphql',
+    'nodemailer',
+    'aws4',
+    'pluralize',
+    'console-table-printer',
+    '@azure/storage-blob',
+    '@aws-sdk/client-s3',
+    '@aws-sdk/s3-request-presigner',
+    '@google-cloud/storage',
+    // Database drivers + their lazily-required companions, one group per adapter.
+    // Postgres (`@payloadcms/db-postgres`, `@payloadcms/db-vercel-postgres`)
+    'pg',
+    'pg-native',
+    'pg-cloudflare',
+    // SQLite (`@payloadcms/db-sqlite`)
+    'better-sqlite3',
+    'libsql',
+    // Mongo (`@payloadcms/db-mongodb`)
+    'mongodb',
+    'mongoose'
+];
+/**
+ * External packages for the production `vite build` only (not dev serve).
+ *
+ * Externalizes the `@payloadcms/*` package boundaries — plus `payload` — so each
+ * resolves its own transitive Node deps (`pino`, `drizzle-orm`, `libsql`, …) from
+ * its own `node_modules` at runtime. Externalizing only the leaf deps breaks under
+ * pnpm: a leaf imported by bundled code becomes an unresolvable bare specifier from
+ * `dist/`, since pnpm does not hoist it.
+ *
+ * Kept out of dev's `ssr.external` on purpose: the monorepo resolves these to
+ * TypeScript source (`.ts` imported via `.js` specifiers), which only Vite's
+ * transform can resolve — an externalized copy would hit Node's raw resolver and
+ * fail on the `.js`→`.ts` mismatch.
+ */ export const buildExternalPackages = [
+    'payload',
+    'payload/node',
+    '@payloadcms/drizzle',
+    '@payloadcms/db-mongodb',
+    '@payloadcms/db-postgres',
+    '@payloadcms/db-vercel-postgres',
+    '@payloadcms/db-sqlite',
+    '@payloadcms/db-d1-sqlite',
+    ...ssrExternalPackages
+];
+export const payloadNoExternalPatterns = [
+    '@payloadcms/ui',
+    '@payloadcms/translations',
+    '@payloadcms/tanstack-start',
+    /^@payloadcms\/richtext-lexical/,
+    /^@payloadcms\/plugin-/,
+    /^@payloadcms\/storage-/
+];
+
+//# sourceMappingURL=external.js.map

package/dist/vite/config/external.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/vite/config/external.ts"],"sourcesContent":["/**\n * SSR/RSC externalization config used by `withPayload`. Kept separate from the\n * client optimizer config (`./optimizeDeps.ts`) so each concern stays small.\n */\n\n/**\n * Server-only packages (Node-only or only ever used by the server bundle).\n * These are the Vite equivalent of Next.js's `serverExternalPackages`.\n */\nexport const ssrExternalPackages: string[] = [\n  'ajv',\n  'fast-uri',\n  'drizzle-kit',\n  'drizzle-kit/api',\n  'drizzle-orm',\n  'sharp',\n  'require-in-the-middle',\n  'json-schema-to-typescript',\n  'pino',\n  'pino-pretty',\n  'graphql',\n  'nodemailer',\n  'aws4',\n  'pluralize',\n  'console-table-printer',\n  '@azure/storage-blob',\n  '@aws-sdk/client-s3',\n  '@aws-sdk/s3-request-presigner',\n  '@google-cloud/storage',\n  // Database drivers + their lazily-required companions, one group per adapter.\n  // Postgres (`@payloadcms/db-postgres`, `@payloadcms/db-vercel-postgres`)\n  'pg',\n  'pg-native',\n  'pg-cloudflare',\n  // SQLite (`@payloadcms/db-sqlite`)\n  'better-sqlite3',\n  'libsql',\n  // Mongo (`@payloadcms/db-mongodb`)\n  'mongodb',\n  'mongoose',\n]\n\n/**\n * External packages for the production `vite build` only (not dev serve).\n *\n * Externalizes the `@payloadcms/*` package boundaries — plus `payload` — so each\n * resolves its own transitive Node deps (`pino`, `drizzle-orm`, `libsql`, …) from\n * its own `node_modules` at runtime. Externalizing only the leaf deps breaks under\n * pnpm: a leaf imported by bundled code becomes an unresolvable bare specifier from\n * `dist/`, since pnpm does not hoist it.\n *\n * Kept out of dev's `ssr.external` on purpose: the monorepo resolves these to\n * TypeScript source (`.ts` imported via `.js` specifiers), which only Vite's\n * transform can resolve — an externalized copy would hit Node's raw resolver and\n * fail on the `.js`→`.ts` mismatch.\n */\nexport const buildExternalPackages: string[] = [\n  'payload',\n  'payload/node',\n  '@payloadcms/drizzle',\n  '@payloadcms/db-mongodb',\n  '@payloadcms/db-postgres',\n  '@payloadcms/db-vercel-postgres',\n  '@payloadcms/db-sqlite',\n  '@payloadcms/db-d1-sqlite',\n  ...ssrExternalPackages,\n]\n\nexport const payloadNoExternalPatterns: Array<RegExp | string> = [\n  '@payloadcms/ui',\n  '@payloadcms/translations',\n  '@payloadcms/tanstack-start',\n  /^@payloadcms\\/richtext-lexical/,\n  /^@payloadcms\\/plugin-/,\n  /^@payloadcms\\/storage-/,\n]\n"],"names":["ssrExternalPackages","buildExternalPackages","payloadNoExternalPatterns"],"mappings":"AAAA;;;CAGC,GAED;;;CAGC,GACD,OAAO,MAAMA,sBAAgC;IAC3C;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,8EAA8E;IAC9E,yEAAyE;IACzE;IACA;IACA;IACA,mCAAmC;IACnC;IACA;IACA,mCAAmC;IACnC;IACA;CACD,CAAA;AAED;;;;;;;;;;;;;CAaC,GACD,OAAO,MAAMC,wBAAkC;IAC7C;IACA;IACA;IACA;IACA;IACA;IACA;IACA;OACGD;CACJ,CAAA;AAED,OAAO,MAAME,4BAAoD;IAC/D;IACA;IACA;IACA;IACA;IACA;CACD,CAAA"}

package/dist/vite/config/optimizeDeps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Client dep-optimizer config used by `withPayload`. Kept separate from the
+ * SSR/RSC externalization config (`./external.ts`) so each concern stays small.
+ */
+/**
+ * Packages we know contain Node-only code or top-level side effects requiring
+ * Node APIs. Excluding them from the client optimizer prevents Vite from
+ * walking into their main entries and trying to bundle server-only imports
+ * for the browser.
+ */
+export declare const optimizeDepsExcludeDefaults: string[];
+/**
+ * Transitive dependencies of `@payloadcms/ui` and `payload` that need to be
+ * pre-bundled for the client. Vite's auto-discovery doesn't reliably pick
+ * these up because their parent packages are in `optimizeDeps.exclude`, so we
+ * list them explicitly using the `parent > child` syntax.
+ *
+ * Each entry below fixes a specific late-discovery re-optimization: without it,
+ * Vite discovers the dep *after* its initial crawl, forcing a full dep
+ * re-optimization mid-session that 404s in-flight `.vite/deps/*` chunks and
+ * remounts the admin (dropping client state). This is why the list can't simply
+ * be deleted — it is the "complete first pass" for the admin's dep graph.
+ */
+export declare const optimizeDepsIncludeDefaults: string[];
+//# sourceMappingURL=optimizeDeps.d.ts.map

package/dist/vite/config/optimizeDeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizeDeps.d.ts","sourceRoot":"","sources":["../../../src/vite/config/optimizeDeps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAsB/C,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EA8E/C,CAAA"}

package/dist/vite/{constants.js → config/optimizeDeps.js}

@@ -1,67 +1,7 @@
 /**
- * Vite-level configuration constants used by `payloadPlugin`. Kept separate so
- * `plugin.ts` stays focused on wiring.
+ * Client dep-optimizer config used by `withPayload`. Kept separate from the
+ * SSR/RSC externalization config (`./external.ts`) so each concern stays small.
  */ /**
- * Server-only packages (Node-only or only ever used by the server bundle).
- * These are the Vite equivalent of Next.js's `serverExternalPackages`.
- */ export const ssrExternalPackages = [
-    'ajv',
-    'fast-uri',
-    'drizzle-kit',
-    'drizzle-kit/api',
-    'drizzle-orm',
-    'sharp',
-    'libsql',
-    'require-in-the-middle',
-    'json-schema-to-typescript',
-    'pino',
-    'pino-pretty',
-    'graphql',
-    'mongodb',
-    'mongoose',
-    'better-sqlite3',
-    'pg',
-    'pg-native',
-    'nodemailer',
-    'aws4',
-    'pluralize',
-    'console-table-printer',
-    '@azure/storage-blob',
-    '@aws-sdk/client-s3',
-    '@aws-sdk/s3-request-presigner',
-    '@google-cloud/storage'
-];
-/**
- * Payload packages whose source must be processed by Vite even on the server
- * (because they are workspace `.ts` files in dev). Server-only adapters
- * (`@payloadcms/db-*`, `@payloadcms/email-*`, `@payloadcms/next`, etc.) are
- * intentionally not included — those should stay external on the SSR side.
- */ export const payloadNoExternalPatterns = [
-    '@payloadcms/ui',
-    '@payloadcms/translations',
-    '@payloadcms/tanstack-start',
-    /^@payloadcms\/richtext-lexical/,
-    /^@payloadcms\/plugin-/,
-    /^@payloadcms\/storage-/
-];
-/**
- * The subset of `payloadNoExternalPatterns` that needs to participate in the
- * RSC environment. Plugins and storage adapters must be included: they register
- * custom providers/components (e.g. `plugin-multi-tenant`'s `'use client'`
- * `TenantSelectionProvider`) that render in the RSC graph via
- * `RenderServerComponent`. If the package stays external to RSC, `plugin-rsc`
- * never transforms its `'use client'` modules into client references, so the
- * component executes server-side and crashes on the first hook
- * (`Cannot read properties of null (reading 'useState')`).
- */ export const payloadRscNoExternalPatterns = [
-    '@payloadcms/ui',
-    '@payloadcms/translations',
-    '@payloadcms/tanstack-start',
-    /^@payloadcms\/richtext-lexical/,
-    /^@payloadcms\/plugin-/,
-    /^@payloadcms\/storage-/
-];
-/**
  * Packages we know contain Node-only code or top-level side effects requiring
  * Node APIs. Excluding them from the client optimizer prevents Vite from
  * walking into their main entries and trying to bundle server-only imports
@@ -94,6 +34,12 @@
  * pre-bundled for the client. Vite's auto-discovery doesn't reliably pick
  * these up because their parent packages are in `optimizeDeps.exclude`, so we
  * list them explicitly using the `parent > child` syntax.
+ *
+ * Each entry below fixes a specific late-discovery re-optimization: without it,
+ * Vite discovers the dep *after* its initial crawl, forcing a full dep
+ * re-optimization mid-session that 404s in-flight `.vite/deps/*` chunks and
+ * remounts the admin (dropping client state). This is why the list can't simply
+ * be deleted — it is the "complete first pass" for the admin's dep graph.
  */ export const optimizeDepsIncludeDefaults = [
     '@payloadcms/ui > sonner',
     '@payloadcms/ui > @faceless-ui/modal',
@@ -174,4 +120,4 @@
     'payload > sanitize-filename'
 ];
 
-//# sourceMappingURL=constants.js.map
+//# sourceMappingURL=optimizeDeps.js.map

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

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

package/dist/vite/config/scss.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SCSS `@import`/`@use` importers applied for every Payload consumer.
+ *
+ * Resolves webpack-style `~@payloadcms/...` tilde specifiers (emitted by
+ * first-party Payload package styles, e.g. `@payloadcms/richtext-slate`) to the
+ * installed package via Node resolution. Because it goes through the package's
+ * `exports` map, it picks the workspace `src` scss in the monorepo and the
+ * published `dist` scss in a consumer install automatically — no per-app
+ * `findFileUrl` shim needed.
+ */
+export declare const payloadScssImporters: {
+    findFileUrl(url: string): null | URL;
+}[];
+//# sourceMappingURL=scss.d.ts.map

package/dist/vite/config/scss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scss.d.ts","sourceRoot":"","sources":["../../../src/vite/config/scss.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;qBAEZ,MAAM,GAAG,IAAI,GAAG,GAAG;GAWvC,CAAA"}

package/dist/vite/config/scss.js

@@ -0,0 +1,28 @@
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+const require = createRequire(import.meta.url);
+/**
+ * SCSS `@import`/`@use` importers applied for every Payload consumer.
+ *
+ * Resolves webpack-style `~@payloadcms/...` tilde specifiers (emitted by
+ * first-party Payload package styles, e.g. `@payloadcms/richtext-slate`) to the
+ * installed package via Node resolution. Because it goes through the package's
+ * `exports` map, it picks the workspace `src` scss in the monorepo and the
+ * published `dist` scss in a consumer install automatically — no per-app
+ * `findFileUrl` shim needed.
+ */ export const payloadScssImporters = [
+    {
+        findFileUrl (url) {
+            if (!url.startsWith('~@payloadcms/')) {
+                return null;
+            }
+            try {
+                return pathToFileURL(require.resolve(url.slice(1)));
+            } catch  {
+                return null;
+            }
+        }
+    }
+];
+
+//# sourceMappingURL=scss.js.map

package/dist/vite/config/scss.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/vite/config/scss.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { pathToFileURL } from 'node:url'\n\nconst require = createRequire(import.meta.url)\n\n/**\n * SCSS `@import`/`@use` importers applied for every Payload consumer.\n *\n * Resolves webpack-style `~@payloadcms/...` tilde specifiers (emitted by\n * first-party Payload package styles, e.g. `@payloadcms/richtext-slate`) to the\n * installed package via Node resolution. Because it goes through the package's\n * `exports` map, it picks the workspace `src` scss in the monorepo and the\n * published `dist` scss in a consumer install automatically — no per-app\n * `findFileUrl` shim needed.\n */\nexport const payloadScssImporters = [\n  {\n    findFileUrl(url: string): null | URL {\n      if (!url.startsWith('~@payloadcms/')) {\n        return null\n      }\n      try {\n        return pathToFileURL(require.resolve(url.slice(1)))\n      } catch {\n        return null\n      }\n    },\n  },\n]\n"],"names":["createRequire","pathToFileURL","require","url","payloadScssImporters","findFileUrl","startsWith","resolve","slice"],"mappings":"AAAA,SAASA,aAAa,QAAQ,cAAa;AAC3C,SAASC,aAAa,QAAQ,WAAU;AAExC,MAAMC,UAAUF,cAAc,YAAYG,GAAG;AAE7C;;;;;;;;;CASC,GACD,OAAO,MAAMC,uBAAuB;IAClC;QACEC,aAAYF,GAAW;YACrB,IAAI,CAACA,IAAIG,UAAU,CAAC,kBAAkB;gBACpC,OAAO;YACT;YACA,IAAI;gBACF,OAAOL,cAAcC,QAAQK,OAAO,CAACJ,IAAIK,KAAK,CAAC;YACjD,EAAE,OAAM;gBACN,OAAO;YACT;QACF;IACF;CACD,CAAA"}

package/dist/vite/index.d.ts

@@ -0,0 +1,99 @@
+import type { ConfigEnv, UserConfig, UserConfigFnObject } from 'vite';
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import rsc from '@vitejs/plugin-rsc';
+export type WithPayloadOptions = {
+    /** Extra import-protection `ignoreImporters` patterns for the TanStack Start plugin. */
+    additionalIgnoreImporters?: RegExp[];
+    /** Route id of Payload's admin layout, eager-loaded instead of code-split. Defaults to `'/_payload'`. */
+    adminRouteId?: string;
+    /** Extra globs exempted from the `.client.*` SSR denial (beyond the default node_modules exemption). */
+    clientDenialExcludeFiles?: string[];
+    /** Path to the user's `payload.config.ts` (required) */
+    payloadConfigPath: string;
+    /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'` */
+    routesDirectory?: string;
+    /** Silence Vite warnings about third-party dependency sourcemaps. Defaults to `true`. */
+    silenceDependencyWarnings?: boolean;
+    /** TanStack source directory. Defaults to `'src'` */
+    srcDirectory?: string;
+    /** Extra Vite config deep-merged over the Payload defaults. Ignored in `build` mode. */
+    vite?: UserConfig;
+};
+/** The options Payload's admin requires for each third-party plugin. */
+export type PayloadPluginOptions = {
+    react: NonNullable<Parameters<typeof viteReact>[0]>;
+    rsc: NonNullable<Parameters<typeof rsc>[0]>;
+    tanstackStart: NonNullable<Parameters<typeof tanstackStart>[0]>;
+};
+export type WithPayloadBuilderContext = {
+    env: ConfigEnv;
+    /** Options to pass to the `viteReact`/`rsc`/`tanstackStart` factories you import. */
+    pluginOptions: PayloadPluginOptions;
+};
+/**
+ * Returns the extra Vite config — the plugins you instantiate plus any overrides.
+ * `withPayload` deep-merges it onto Payload's base config, so you don't spread or
+ * merge the base yourself.
+ */
+export type WithPayloadBuilder = (context: WithPayloadBuilderContext) => UserConfig;
+/**
+ * Vite config helper for Payload + TanStack Start; the counterpart to Next.js'
+ * `withPayload`.
+ *
+ * Zero-config — Payload instantiates the RSC, React, and TanStack Start plugins:
+ *
+ * ```ts
+ * export default withPayload(undefined, { payloadConfigPath: './src/payload.config.ts' })
+ * ```
+ *
+ * Guest mode — pass a `build` callback to instantiate them yourself (one copy of
+ * each; `@vitejs/plugin-rsc` is a hard singleton). Return only your additions;
+ * `withPayload` deep-merges them onto Payload's base config:
+ *
+ * ```ts
+ * export default withPayload(
+ *   ({ pluginOptions }) => ({
+ *     plugins: [
+ *       rsc(pluginOptions.rsc),
+ *       tanstackStart(pluginOptions.tanstackStart),
+ *       viteReact(pluginOptions.react),
+ *     ],
+ *     // ...other config options
+ *   }),
+ *   { payloadConfigPath: './src/payload.config.ts' },
+ * )
+ * ```
+ */
+export declare function withPayload(build: undefined | WithPayloadBuilder, options: WithPayloadOptions): UserConfigFnObject;
+/** `@vitejs/plugin-rsc` options for Payload: `serverHandler: false` (TanStack owns the handler). */
+export declare function payloadRscOptions(): NonNullable<Parameters<typeof rsc>[0]>;
+/** `@vitejs/plugin-react` options for Payload: transform every `.[jt]sx?` file. */
+export declare function payloadReactOptions(): NonNullable<Parameters<typeof viteReact>[0]>;
+export type PayloadTanstackStartOptionsArgs = {
+    /** Additional import-protection `ignoreImporters` patterns. */
+    additionalIgnoreImporters?: RegExp[];
+    /**
+     * Route id of Payload's admin layout route, eager-loaded (not code-split) so it
+     * hydrates on first paint. It and its children skip splitting; host routes keep
+     * TanStack's default. Defaults to `'/_payload'` (the `_payload.tsx` convention).
+     */
+    adminRouteId?: string;
+    /**
+     * Extra globs exempted from TanStack's `.client.*` SSR denial, on top of the
+     * default node_modules exemption. Needed only when Payload's own `.client.*`
+     * files resolve outside node_modules (e.g. the monorepo's `packages` sources).
+     */
+    clientDenialExcludeFiles?: string[];
+    /** TanStack router routes directory relative to `srcDirectory`. Defaults to `'app'`. */
+    routesDirectory?: string;
+    /** TanStack source directory. Defaults to `'src'`. */
+    srcDirectory?: string;
+};
+/**
+ * The `tanstackStart` options Payload's admin requires (import-protection and
+ * code-splitting). TanStack Start is one-per-app, so a host that already runs it
+ * should merge these into its single `tanstackStart` call.
+ */
+export declare function payloadTanstackStartOptions(args?: PayloadTanstackStartOptionsArgs): NonNullable<Parameters<typeof tanstackStart>[0]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAwB,UAAU,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAI3F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACjE,OAAO,SAAS,MAAM,sBAAsB,CAAA;AAC5C,OAAO,GAAG,MAAM,oBAAoB,CAAA;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,CAqGpB;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAE1E;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAElF;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,+DAA+D;IAC/D,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,wFAAwF;IACxF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,+BAAoC,GACzC,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAwClD"}