@tanstack/start-plugin-core 1.167.17 → 1.167.19

package/dist/esm/vite/schema.js

@@ -0,0 +1,12 @@
+import { parseStartConfig as parseStartConfig$1, tanstackStartOptionsObjectSchema } from "../schema.js";
+import { z } from "zod";
+//#region src/vite/schema.ts
+var tanstackStartViteOptionsSchema = tanstackStartOptionsObjectSchema.extend({ vite: z.object({ installDevServerMiddleware: z.boolean().optional() }).optional() }).optional().default({});
+function parseStartConfig(opts, corePluginOpts, root) {
+	const { vite: _vite, ...coreOptions } = tanstackStartViteOptionsSchema.parse(opts);
+	return parseStartConfig$1(coreOptions, corePluginOpts, root);
+}
+//#endregion
+export { parseStartConfig };
+
+//# sourceMappingURL=schema.js.map

package/dist/esm/vite/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/vite/schema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  parseStartConfig as parseCoreStartConfig,\n  tanstackStartOptionsObjectSchema,\n} from '../schema'\nimport type { CompileStartFrameworkOptions } from '../types'\n\nexport const tanstackStartViteOptionsSchema = tanstackStartOptionsObjectSchema\n  .extend({\n    vite: z\n      .object({ installDevServerMiddleware: z.boolean().optional() })\n      .optional(),\n  })\n  .optional()\n  .default({})\n\nexport function parseStartConfig(\n  opts: z.input<typeof tanstackStartViteOptionsSchema>,\n  corePluginOpts: { framework: CompileStartFrameworkOptions },\n  root: string,\n) {\n  const { vite: _vite, ...coreOptions } =\n    tanstackStartViteOptionsSchema.parse(opts)\n\n  return parseCoreStartConfig(coreOptions, corePluginOpts, root)\n}\n\nexport type TanStackStartViteInputConfig = z.input<\n  typeof tanstackStartViteOptionsSchema\n>\n"],"mappings":";;;AAOA,IAAa,iCAAiC,iCAC3C,OAAO,EACN,MAAM,EACH,OAAO,EAAE,4BAA4B,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAC9D,UAAU,EACd,CAAC,CACD,UAAU,CACV,QAAQ,EAAE,CAAC;AAEd,SAAgB,iBACd,MACA,gBACA,MACA;CACA,MAAM,EAAE,MAAM,OAAO,GAAG,gBACtB,+BAA+B,MAAM,KAAK;AAE5C,QAAO,mBAAqB,aAAa,gBAAgB,KAAK"}

package/dist/esm/vite/serialization-adapters-plugin.d.ts

@@ -0,0 +1,5 @@
+import { SerializationAdapterConfig } from '../types.js';
+import { PluginOption } from 'vite';
+export declare function serializationAdaptersPlugin(opts: {
+    adapters: Array<SerializationAdapterConfig> | undefined;
+}): PluginOption;

package/dist/esm/vite/serialization-adapters-plugin.js

@@ -0,0 +1,42 @@
+import { START_ENVIRONMENT_NAMES } from "../constants.js";
+import { resolveViteId } from "../utils.js";
+import { EMPTY_SERIALIZATION_ADAPTERS_MODULE, generateSerializationAdaptersModule } from "../serialization-adapters-module.js";
+import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
+//#region src/vite/serialization-adapters-plugin.ts
+var resolvedModuleId = resolveViteId(VIRTUAL_MODULES.pluginAdapters.replace("#", "%23"));
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\#]/g, "\\$&");
+}
+function serializationAdaptersPlugin(opts) {
+	return {
+		name: "tanstack-start:plugin-adapters",
+		enforce: "pre",
+		resolveId: {
+			filter: { id: new RegExp(escapeRegex(VIRTUAL_MODULES.pluginAdapters)) },
+			handler(id) {
+				if (id === VIRTUAL_MODULES.pluginAdapters) return resolvedModuleId;
+			}
+		},
+		load: {
+			filter: { id: new RegExp(escapeRegex(resolvedModuleId)) },
+			handler(id) {
+				if (id !== resolvedModuleId) return;
+				const adapters = opts.adapters;
+				if (!adapters || adapters.length === 0) return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
+				if (this.environment.name === START_ENVIRONMENT_NAMES.client) return generateSerializationAdaptersModule({
+					adapters,
+					runtime: "client"
+				});
+				if (this.environment.name === START_ENVIRONMENT_NAMES.server) return generateSerializationAdaptersModule({
+					adapters,
+					runtime: "server"
+				});
+				return EMPTY_SERIALIZATION_ADAPTERS_MODULE;
+			}
+		}
+	};
+}
+//#endregion
+export { serializationAdaptersPlugin };
+
+//# sourceMappingURL=serialization-adapters-plugin.js.map

package/dist/esm/vite/serialization-adapters-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-adapters-plugin.js","names":[],"sources":["../../../src/vite/serialization-adapters-plugin.ts"],"sourcesContent":["import { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport {\n  EMPTY_SERIALIZATION_ADAPTERS_MODULE,\n  generateSerializationAdaptersModule,\n} from '../serialization-adapters-module'\nimport { START_ENVIRONMENT_NAMES } from '../constants'\nimport { resolveViteId } from '../utils'\nimport type { SerializationAdapterConfig } from '../types'\nimport type { PluginOption } from 'vite'\n\n// Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment.\n// The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of\n// /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #).\nconst resolvedModuleId = resolveViteId(\n  VIRTUAL_MODULES.pluginAdapters.replace('#', '%23'),\n)\n\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\#]/g, '\\\\$&')\n}\n\nexport function serializationAdaptersPlugin(opts: {\n  adapters: Array<SerializationAdapterConfig> | undefined\n}): PluginOption {\n  return {\n    name: 'tanstack-start:plugin-adapters',\n    enforce: 'pre',\n    resolveId: {\n      filter: { id: new RegExp(escapeRegex(VIRTUAL_MODULES.pluginAdapters)) },\n      handler(id: string) {\n        if (id === VIRTUAL_MODULES.pluginAdapters) {\n          return resolvedModuleId\n        }\n        return undefined\n      },\n    },\n    load: {\n      filter: {\n        id: new RegExp(escapeRegex(resolvedModuleId)),\n      },\n      handler(this: { environment: { name: string } }, id: string) {\n        if (id !== resolvedModuleId) {\n          return undefined\n        }\n\n        const adapters = opts.adapters\n        if (!adapters || adapters.length === 0) {\n          return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n        }\n\n        if (this.environment.name === START_ENVIRONMENT_NAMES.client) {\n          return generateSerializationAdaptersModule({\n            adapters,\n            runtime: 'client',\n          })\n        }\n\n        if (this.environment.name === START_ENVIRONMENT_NAMES.server) {\n          return generateSerializationAdaptersModule({\n            adapters,\n            runtime: 'server',\n          })\n        }\n\n        return EMPTY_SERIALIZATION_ADAPTERS_MODULE\n      },\n    },\n  }\n}\n"],"mappings":";;;;;AAaA,IAAM,mBAAmB,cACvB,gBAAgB,eAAe,QAAQ,KAAK,MAAM,CACnD;AAED,SAAS,YAAY,KAAqB;AACxC,QAAO,IAAI,QAAQ,wBAAwB,OAAO;;AAGpD,SAAgB,4BAA4B,MAE3B;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;GACT,QAAQ,EAAE,IAAI,IAAI,OAAO,YAAY,gBAAgB,eAAe,CAAC,EAAE;GACvE,QAAQ,IAAY;AAClB,QAAI,OAAO,gBAAgB,eACzB,QAAO;;GAIZ;EACD,MAAM;GACJ,QAAQ,EACN,IAAI,IAAI,OAAO,YAAY,iBAAiB,CAAC,EAC9C;GACD,QAAiD,IAAY;AAC3D,QAAI,OAAO,iBACT;IAGF,MAAM,WAAW,KAAK;AACtB,QAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;AAGT,QAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;KACzC;KACA,SAAS;KACV,CAAC;AAGJ,QAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,oCAAoC;KACzC;KACA,SAAS;KACV,CAAC;AAGJ,WAAO;;GAEV;EACF"}

package/dist/esm/vite/start-compiler-plugin/module-specifier.d.ts

@@ -0,0 +1,3 @@
+import { DevServerFnModuleSpecifierEncoder } from '../../start-compiler/types.js';
+export declare function createViteDevServerFnModuleSpecifierEncoder(root: string): DevServerFnModuleSpecifierEncoder;
+export declare function decodeViteDevServerModuleSpecifier(moduleSpecifier: string): string;

package/dist/esm/vite/start-compiler-plugin/module-specifier.js

@@ -0,0 +1,19 @@
+//#region src/vite/start-compiler-plugin/module-specifier.ts
+function createViteDevServerFnModuleSpecifierEncoder(root) {
+	const rootWithTrailingSlash = root.endsWith("/") ? root : `${root}/`;
+	return ({ extractedFilename }) => {
+		let file = extractedFilename;
+		if (file.startsWith(rootWithTrailingSlash)) file = file.slice(rootWithTrailingSlash.length);
+		return `/@id/${file}`;
+	};
+}
+function decodeViteDevServerModuleSpecifier(moduleSpecifier) {
+	let sourceFile = moduleSpecifier;
+	if (sourceFile.startsWith("/@id/")) sourceFile = sourceFile.slice(5);
+	const queryIndex = sourceFile.indexOf("?");
+	return queryIndex === -1 ? sourceFile : sourceFile.slice(0, queryIndex);
+}
+//#endregion
+export { createViteDevServerFnModuleSpecifierEncoder, decodeViteDevServerModuleSpecifier };
+
+//# sourceMappingURL=module-specifier.js.map

package/dist/esm/vite/start-compiler-plugin/module-specifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-specifier.js","names":[],"sources":["../../../../src/vite/start-compiler-plugin/module-specifier.ts"],"sourcesContent":["import type { DevServerFnModuleSpecifierEncoder } from '../../start-compiler/types'\n\nexport function createViteDevServerFnModuleSpecifierEncoder(\n  root: string,\n): DevServerFnModuleSpecifierEncoder {\n  const rootWithTrailingSlash = root.endsWith('/') ? root : `${root}/`\n\n  return ({ extractedFilename }) => {\n    let file = extractedFilename\n\n    if (file.startsWith(rootWithTrailingSlash)) {\n      file = file.slice(rootWithTrailingSlash.length)\n    }\n\n    return `/@id/${file}`\n  }\n}\n\nexport function decodeViteDevServerModuleSpecifier(\n  moduleSpecifier: string,\n): string {\n  let sourceFile = moduleSpecifier\n\n  if (sourceFile.startsWith('/@id/')) {\n    sourceFile = sourceFile.slice('/@id/'.length)\n  }\n\n  const queryIndex = sourceFile.indexOf('?')\n\n  return queryIndex === -1 ? sourceFile : sourceFile.slice(0, queryIndex)\n}\n"],"mappings":";AAEA,SAAgB,4CACd,MACmC;CACnC,MAAM,wBAAwB,KAAK,SAAS,IAAI,GAAG,OAAO,GAAG,KAAK;AAElE,SAAQ,EAAE,wBAAwB;EAChC,IAAI,OAAO;AAEX,MAAI,KAAK,WAAW,sBAAsB,CACxC,QAAO,KAAK,MAAM,sBAAsB,OAAO;AAGjD,SAAO,QAAQ;;;AAInB,SAAgB,mCACd,iBACQ;CACR,IAAI,aAAa;AAEjB,KAAI,WAAW,WAAW,QAAQ,CAChC,cAAa,WAAW,MAAM,EAAe;CAG/C,MAAM,aAAa,WAAW,QAAQ,IAAI;AAE1C,QAAO,eAAe,KAAK,aAAa,WAAW,MAAM,GAAG,WAAW"}

package/dist/esm/{start-compiler-plugin → vite/start-compiler-plugin}/plugin.d.ts

@@ -1,6 +1,6 @@
-import { SERVER_FN_LOOKUP } from '../constants.js';
-import { CompileStartFrameworkOptions } from '../types.js';
-import { GenerateFunctionIdFnOptional } from './types.js';
+import { SERVER_FN_LOOKUP } from '../../constants.js';
+import { CompileStartFrameworkOptions } from '../../types.js';
+import { GenerateFunctionIdFnOptional } from '../../start-compiler/types.js';
 import { PluginOption } from 'vite';
 export { SERVER_FN_LOOKUP };
 export interface StartCompilerPluginOptions {
@@ -8,6 +8,7 @@ export interface StartCompilerPluginOptions {
     environments: Array<{
         name: string;
         type: 'client' | 'server';
+        getServerFnById?: string;
     }>;
     /**
      * Custom function ID generator (optional).

package/dist/esm/vite/start-compiler-plugin/plugin.js

@@ -0,0 +1,202 @@
+import { SERVER_FN_LOOKUP, TRANSFORM_ID_REGEX, VITE_ENVIRONMENT_NAMES } from "../../constants.js";
+import { cleanId } from "../../start-compiler/utils.js";
+import { detectKindsInCode } from "../../start-compiler/compiler.js";
+import { getTransformCodeFilterForEnv } from "../../start-compiler/config.js";
+import { createStartCompiler, mergeServerFnsById } from "../../start-compiler/host.js";
+import { loadModuleForViteCompiler } from "../../start-compiler/load-module.js";
+import { generateServerFnResolverModule } from "../../start-compiler/server-fn-resolver-module.js";
+import { createViteDevServerFnModuleSpecifierEncoder, decodeViteDevServerModuleSpecifier } from "./module-specifier.js";
+import { resolve } from "pathe";
+import assert from "node:assert";
+import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
+//#region src/vite/start-compiler-plugin/plugin.ts
+function resolveViteId(id) {
+	return `\0${id}`;
+}
+var validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`;
+function getDevServerFnValidatorModule() {
+	return `
+export async function getServerFnById(id, _access) {
+  const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id
+  await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport)
+  const decoded = Buffer.from(id, 'base64url').toString('utf8')
+  const devServerFn = JSON.parse(decoded)
+  const mod = await import(/* @vite-ignore */ devServerFn.file)
+  return mod[devServerFn.export]
+}
+`;
+}
+function parseIdQuery(id) {
+	if (!id.includes("?")) return {
+		filename: id,
+		query: {}
+	};
+	const [filename, rawQuery] = id.split(`?`, 2);
+	return {
+		filename,
+		query: Object.fromEntries(new URLSearchParams(rawQuery))
+	};
+}
+function startCompilerPlugin(opts) {
+	const compilers = /* @__PURE__ */ new Map();
+	const serverFnsById = {};
+	const onServerFnsById = (d) => {
+		mergeServerFnsById(serverFnsById, d);
+	};
+	let root = process.cwd();
+	const resolvedResolverVirtualImportId = resolveViteId(VIRTUAL_MODULES.serverFnResolver);
+	const ssrEnvName = VITE_ENVIRONMENT_NAMES.server;
+	const ssrIsProvider = opts.providerEnvName === ssrEnvName;
+	const appliedResolverEnvironments = new Set(ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName]);
+	function perEnvServerFnPlugin(environment) {
+		const transformCodeFilter = getTransformCodeFilterForEnv(environment.type);
+		return {
+			name: `tanstack-start-core::server-fn:${environment.name}`,
+			enforce: "pre",
+			applyToEnvironment(env) {
+				return env.name === environment.name;
+			},
+			configResolved(config) {
+				root = config.root;
+			},
+			transform: {
+				filter: {
+					id: {
+						exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),
+						include: TRANSFORM_ID_REGEX
+					},
+					code: { include: transformCodeFilter }
+				},
+				async handler(code, id) {
+					let compiler = compilers.get(this.environment.name);
+					if (!compiler) {
+						const mode = this.environment.mode === "build" ? "build" : "dev";
+						compiler = createStartCompiler({
+							env: environment.type,
+							envName: environment.name,
+							root,
+							mode,
+							framework: opts.framework,
+							providerEnvName: opts.providerEnvName,
+							generateFunctionId: opts.generateFunctionId,
+							onServerFnsById,
+							getKnownServerFns: () => serverFnsById,
+							encodeModuleSpecifierInDev: mode === "dev" ? createViteDevServerFnModuleSpecifierEncoder(root) : void 0,
+							loadModule: async (id) => {
+								await loadModuleForViteCompiler({
+									compiler,
+									mode: this.environment.mode,
+									fetchModule: this.environment.mode === "dev" ? this.environment.fetchModule.bind(this.environment) : void 0,
+									loadModule: this.load.bind(this),
+									id
+								});
+							},
+							resolveId: async (source, importer) => {
+								const r = await this.resolve(source, importer);
+								if (r) {
+									if (!r.external) return cleanId(r.id);
+								}
+								return null;
+							}
+						});
+						compilers.set(this.environment.name, compiler);
+					}
+					const detectedKinds = detectKindsInCode(code, environment.type);
+					return await compiler.compile({
+						id,
+						code,
+						detectedKinds
+					});
+				}
+			},
+			hotUpdate(ctx) {
+				const compiler = compilers.get(this.environment.name);
+				ctx.modules.forEach((m) => {
+					if (m.id) {
+						if (compiler?.invalidateModule(m.id)) m.importers.forEach((importer) => {
+							if (importer.id) compiler?.invalidateModule(importer.id);
+						});
+					}
+				});
+			}
+		};
+	}
+	return [
+		...opts.environments.map(perEnvServerFnPlugin),
+		{
+			name: "tanstack-start-core:capture-server-fn-module-lookup",
+			apply: "serve",
+			applyToEnvironment(env) {
+				return !!opts.environments.find((e) => e.name === env.name);
+			},
+			transform: {
+				filter: { id: new RegExp(`${SERVER_FN_LOOKUP}$`) },
+				handler(code, id) {
+					compilers.get(this.environment.name)?.ingestModule({
+						code,
+						id: cleanId(id)
+					});
+				}
+			}
+		},
+		{
+			name: "tanstack-start-core:validate-server-fn-id",
+			apply: "serve",
+			load: {
+				filter: { id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)) },
+				async handler(id) {
+					const fnId = parseIdQuery(id).query.id;
+					if (fnId && serverFnsById[fnId]) return `export {}`;
+					if (fnId) try {
+						const decoded = JSON.parse(Buffer.from(fnId, "base64url").toString("utf8"));
+						if (typeof decoded.file === "string" && typeof decoded.export === "string") {
+							const sourceFile = decodeViteDevServerModuleSpecifier(decoded.file);
+							if (sourceFile) {
+								const absPath = resolve(root, sourceFile);
+								assert(this.environment.mode === "dev");
+								await this.environment.fetchModule(absPath);
+								if (serverFnsById[fnId]) return `export {}`;
+							}
+						}
+					} catch {}
+					this.error(`Invalid server function ID: ${fnId}`);
+				}
+			}
+		},
+		{
+			name: "tanstack-start-core:server-fn-resolver",
+			enforce: "pre",
+			applyToEnvironment: (env) => {
+				return appliedResolverEnvironments.has(env.name);
+			},
+			configResolved(config) {
+				root = config.root;
+			},
+			resolveId: {
+				filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },
+				handler() {
+					return resolvedResolverVirtualImportId;
+				}
+			},
+			load: {
+				filter: { id: new RegExp(resolvedResolverVirtualImportId) },
+				handler() {
+					if (this.environment.name !== opts.providerEnvName) {
+						const mod = opts.environments.find((e) => e.name === this.environment.name)?.getServerFnById;
+						if (mod) return mod;
+						else this.error(`No getServerFnById implementation found for caller environment: ${this.environment.name}`);
+					}
+					if (this.environment.mode !== "build") return getDevServerFnValidatorModule();
+					return generateServerFnResolverModule({
+						serverFnsById,
+						includeClientReferencedCheck: !ssrIsProvider
+					});
+				}
+			}
+		}
+	];
+}
+//#endregion
+export { startCompilerPlugin };
+
+//# sourceMappingURL=plugin.js.map

package/dist/esm/vite/start-compiler-plugin/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-compiler-plugin/plugin.ts"],"sourcesContent":["import assert from 'node:assert'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { resolve as resolvePath } from 'pathe'\nimport {\n  SERVER_FN_LOOKUP,\n  TRANSFORM_ID_REGEX,\n  VITE_ENVIRONMENT_NAMES,\n} from '../../constants'\nimport { detectKindsInCode } from '../../start-compiler/compiler'\nimport { getTransformCodeFilterForEnv } from '../../start-compiler/config'\nimport {\n  createStartCompiler,\n  mergeServerFnsById,\n} from '../../start-compiler/host'\nimport { loadModuleForViteCompiler } from '../../start-compiler/load-module'\nimport { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module'\nimport { cleanId } from '../../start-compiler/utils'\nimport {\n  createViteDevServerFnModuleSpecifierEncoder,\n  decodeViteDevServerModuleSpecifier,\n} from './module-specifier'\nimport type { CompileStartFrameworkOptions } from '../../types'\nimport type {\n  GenerateFunctionIdFnOptional,\n  ServerFn,\n} from '../../start-compiler/types'\nimport type { PluginOption } from 'vite'\n\n// Re-export from shared constants for backwards compatibility\nexport { SERVER_FN_LOOKUP }\n\nfunction resolveViteId(id: string) {\n  return `\\0${id}`\n}\n\nconst validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`\n\nfunction getDevServerFnValidatorModule(): string {\n  return `\nexport async function getServerFnById(id, _access) {\n  const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id\n  await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport)\n  const decoded = Buffer.from(id, 'base64url').toString('utf8')\n  const devServerFn = JSON.parse(decoded)\n  const mod = await import(/* @vite-ignore */ devServerFn.file)\n  return mod[devServerFn.export]\n}\n`\n}\n\nfunction parseIdQuery(id: string): {\n  filename: string\n  query: {\n    [k: string]: string\n  }\n} {\n  if (!id.includes('?')) return { filename: id, query: {} }\n  const [filename, rawQuery] = id.split(`?`, 2) as [string, string]\n  const query = Object.fromEntries(new URLSearchParams(rawQuery))\n  return { filename, query }\n}\n\nexport interface StartCompilerPluginOptions {\n  framework: CompileStartFrameworkOptions\n  environments: Array<{\n    name: string\n    type: 'client' | 'server'\n    getServerFnById?: string\n  }>\n  /**\n   * Custom function ID generator (optional).\n   */\n  generateFunctionId?: GenerateFunctionIdFnOptional\n  /**\n   * The Vite environment name for the server function provider.\n   */\n  providerEnvName: string\n}\n\nexport function startCompilerPlugin(\n  opts: StartCompilerPluginOptions,\n): PluginOption {\n  const compilers = new Map<string, ReturnType<typeof createStartCompiler>>()\n\n  // Shared registry of server functions across all environments\n  const serverFnsById: Record<string, ServerFn> = {}\n\n  const onServerFnsById = (d: Record<string, ServerFn>) => {\n    mergeServerFnsById(serverFnsById, d)\n  }\n\n  let root = process.cwd()\n  const resolvedResolverVirtualImportId = resolveViteId(\n    VIRTUAL_MODULES.serverFnResolver,\n  )\n\n  // Determine which environments need the resolver (getServerFnById)\n  // SSR environment always needs the resolver for server-side calls\n  // Provider environment needs it for the actual implementation\n  const ssrEnvName = VITE_ENVIRONMENT_NAMES.server\n\n  // SSR is the provider when the provider environment is the default server environment\n  const ssrIsProvider = opts.providerEnvName === ssrEnvName\n\n  // Environments that need the resolver: SSR (for server calls) and provider (for implementation)\n  const appliedResolverEnvironments = new Set(\n    ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName],\n  )\n\n  function perEnvServerFnPlugin(environment: {\n    name: string\n    type: 'client' | 'server'\n  }): PluginOption {\n    // Derive transform code filter from KindDetectionPatterns (single source of truth)\n    const transformCodeFilter = getTransformCodeFilterForEnv(environment.type)\n    return {\n      name: `tanstack-start-core::server-fn:${environment.name}`,\n      enforce: 'pre',\n      applyToEnvironment(env) {\n        return env.name === environment.name\n      },\n      configResolved(config) {\n        root = config.root\n      },\n      transform: {\n        filter: {\n          id: {\n            exclude: new RegExp(`${SERVER_FN_LOOKUP}$`),\n            include: TRANSFORM_ID_REGEX,\n          },\n          code: {\n            include: transformCodeFilter,\n          },\n        },\n        async handler(code, id) {\n          let compiler = compilers.get(this.environment.name)\n\n          if (!compiler) {\n            // Default to 'dev' mode for unknown environments (conservative: no caching)\n            const mode = this.environment.mode === 'build' ? 'build' : 'dev'\n\n            compiler = createStartCompiler({\n              env: environment.type,\n              envName: environment.name,\n              root,\n              mode,\n              framework: opts.framework,\n              providerEnvName: opts.providerEnvName,\n              generateFunctionId: opts.generateFunctionId,\n              onServerFnsById,\n              getKnownServerFns: () => serverFnsById,\n              encodeModuleSpecifierInDev:\n                mode === 'dev'\n                  ? createViteDevServerFnModuleSpecifierEncoder(root)\n                  : undefined,\n              loadModule: async (id: string) => {\n                await loadModuleForViteCompiler({\n                  compiler: compiler!,\n                  mode: this.environment.mode,\n                  fetchModule:\n                    this.environment.mode === 'dev'\n                      ? this.environment.fetchModule.bind(this.environment)\n                      : undefined,\n                  loadModule: this.load.bind(this),\n                  id,\n                })\n              },\n\n              resolveId: async (source: string, importer?: string) => {\n                const r = await this.resolve(source, importer)\n\n                if (r) {\n                  if (!r.external) {\n                    return cleanId(r.id)\n                  }\n                }\n\n                return null\n              },\n            })\n\n            compilers.set(this.environment.name, compiler)\n          }\n\n          // Detect which kinds are present in this file before parsing\n          const detectedKinds = detectKindsInCode(code, environment.type)\n\n          const result = await compiler.compile({\n            id,\n            code,\n            detectedKinds,\n          })\n          return result\n        },\n      },\n\n      hotUpdate(ctx) {\n        const compiler = compilers.get(this.environment.name)\n\n        ctx.modules.forEach((m) => {\n          if (m.id) {\n            const deleted = compiler?.invalidateModule(m.id)\n            if (deleted) {\n              m.importers.forEach((importer) => {\n                if (importer.id) {\n                  compiler?.invalidateModule(importer.id)\n                }\n              })\n            }\n          }\n        })\n      },\n    }\n  }\n\n  return [\n    ...opts.environments.map(perEnvServerFnPlugin),\n    {\n      name: 'tanstack-start-core:capture-server-fn-module-lookup',\n      // we only need this plugin in dev mode\n      apply: 'serve',\n      applyToEnvironment(env) {\n        return !!opts.environments.find((e) => e.name === env.name)\n      },\n      transform: {\n        filter: {\n          id: new RegExp(`${SERVER_FN_LOOKUP}$`),\n        },\n        handler(code, id) {\n          const compiler = compilers.get(this.environment.name)\n          compiler?.ingestModule({ code, id: cleanId(id) })\n        },\n      },\n    },\n    // Validate server function ID in dev mode\n    {\n      name: 'tanstack-start-core:validate-server-fn-id',\n      apply: 'serve',\n      load: {\n        filter: {\n          id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)),\n        },\n        async handler(id) {\n          const parsed = parseIdQuery(id)\n          const fnId = parsed.query.id\n          if (fnId && serverFnsById[fnId]) {\n            return `export {}`\n          }\n\n          // ID not yet registered — the source file may not have been\n          // transformed in this dev session yet (e.g. cold restart with\n          // cached client). Try to decode the ID, discover the source\n          // file, trigger its compilation, and re-check.\n          if (fnId) {\n            try {\n              const decoded = JSON.parse(\n                Buffer.from(fnId, 'base64url').toString('utf8'),\n              )\n              if (\n                typeof decoded.file === 'string' &&\n                typeof decoded.export === 'string'\n              ) {\n                // Use the Vite strategy to decode the module specifier\n                // back to the original source file path.\n                const sourceFile = decodeViteDevServerModuleSpecifier(\n                  decoded.file,\n                )\n\n                if (sourceFile) {\n                  // Resolve to absolute path\n                  const absPath = resolvePath(root, sourceFile)\n\n                  // Trigger transform of the source file in this environment,\n                  // which will compile createServerFn calls and populate\n                  // serverFnsById as a side effect.\n                  // This plugin only runs in dev (apply: 'serve'), so mode\n                  // must be 'dev' — assert to narrow to DevEnvironment.\n                  assert(this.environment.mode === 'dev')\n                  await this.environment.fetchModule(absPath)\n\n                  // Re-check after lazy compilation\n                  if (serverFnsById[fnId]) {\n                    return `export {}`\n                  }\n                }\n              }\n            } catch {\n              // Decoding or fetching failed — fall through to error\n            }\n          }\n\n          this.error(`Invalid server function ID: ${fnId}`)\n        },\n      },\n    },\n    // Manifest plugin for server environments\n    {\n      name: 'tanstack-start-core:server-fn-resolver',\n      enforce: 'pre',\n      applyToEnvironment: (env) => {\n        return appliedResolverEnvironments.has(env.name)\n      },\n      configResolved(config) {\n        root = config.root\n      },\n      resolveId: {\n        filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) },\n        handler() {\n          return resolvedResolverVirtualImportId\n        },\n      },\n      load: {\n        filter: { id: new RegExp(resolvedResolverVirtualImportId) },\n        handler() {\n          if (this.environment.name !== opts.providerEnvName) {\n            const mod = opts.environments.find(\n              (e) => e.name === this.environment.name,\n            )?.getServerFnById\n            if (mod) {\n              return mod\n            } else {\n              this.error(\n                `No getServerFnById implementation found for caller environment: ${this.environment.name}`,\n              )\n            }\n          }\n\n          if (this.environment.mode !== 'build') {\n            return getDevServerFnValidatorModule()\n          }\n\n          // When SSR is the provider, server-only-referenced functions aren't in the manifest,\n          // so no isClientReferenced check is needed.\n          // When SSR is NOT the provider (custom provider env), server-only-referenced\n          // functions ARE in the manifest and need the isClientReferenced check to\n          // block direct client HTTP requests to server-only-referenced functions.\n          return generateServerFnResolverModule({\n            serverFnsById,\n            includeClientReferencedCheck: !ssrIsProvider,\n          })\n        },\n      },\n    },\n  ]\n}\n"],"mappings":"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"}

package/dist/esm/vite/start-manifest-plugin/normalized-client-build.d.ts

@@ -0,0 +1,6 @@
+import { Rollup } from 'vite';
+import { NormalizedClientBuild, NormalizedClientChunk } from '../../types.js';
+export declare function normalizeViteClientChunk(chunk: Rollup.OutputChunk): NormalizedClientChunk;
+export declare function normalizeViteClientChunks(clientBundle: Rollup.OutputBundle): ReadonlyMap<string, NormalizedClientChunk>;
+export declare function normalizeViteClientBuild(clientBundle: Rollup.OutputBundle): NormalizedClientBuild;
+export declare function getRouteFilePathsFromModuleIds(moduleIds: Array<string>): string[];

package/dist/esm/vite/start-manifest-plugin/normalized-client-build.js

@@ -0,0 +1,81 @@
+import { tsrSplit } from "@tanstack/router-plugin";
+//#region src/vite/start-manifest-plugin/normalized-client-build.ts
+function normalizeViteClientChunk(chunk) {
+	return {
+		fileName: chunk.fileName,
+		isEntry: chunk.isEntry,
+		imports: chunk.imports,
+		dynamicImports: chunk.dynamicImports,
+		css: Array.from(chunk.viteMetadata?.importedCss ?? []),
+		routeFilePaths: getRouteFilePathsFromModuleIds(chunk.moduleIds)
+	};
+}
+function normalizeViteClientChunks(clientBundle) {
+	const chunksByFileName = /* @__PURE__ */ new Map();
+	for (const fileName in clientBundle) {
+		const bundleEntry = clientBundle[fileName];
+		if (bundleEntry.type !== "chunk") continue;
+		const normalizedChunk = normalizeViteClientChunk(bundleEntry);
+		chunksByFileName.set(normalizedChunk.fileName, normalizedChunk);
+	}
+	return chunksByFileName;
+}
+function normalizeViteClientBuild(clientBundle) {
+	let entryChunkFileName;
+	const chunksByFileName = normalizeViteClientChunks(clientBundle);
+	const chunkFileNamesByRouteFilePath = /* @__PURE__ */ new Map();
+	const cssFilesBySourcePath = /* @__PURE__ */ new Map();
+	for (const chunk of chunksByFileName.values()) {
+		if (chunk.isEntry) {
+			if (entryChunkFileName) throw new Error(`multiple entries detected: ${entryChunkFileName} ${chunk.fileName}`);
+			entryChunkFileName = chunk.fileName;
+		}
+		for (const routeFilePath of chunk.routeFilePaths) {
+			let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath);
+			if (chunkFileNames === void 0) {
+				chunkFileNames = [];
+				chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames);
+			}
+			chunkFileNames.push(chunk.fileName);
+		}
+		const bundleEntry = clientBundle[chunk.fileName];
+		if (bundleEntry?.type === "chunk") for (const moduleId of bundleEntry.moduleIds) {
+			const queryIndex = moduleId.indexOf("?");
+			const sourcePath = queryIndex >= 0 ? moduleId.slice(0, queryIndex) : moduleId;
+			if (!sourcePath) continue;
+			const existing = cssFilesBySourcePath.get(sourcePath);
+			cssFilesBySourcePath.set(sourcePath, existing ? Array.from(new Set([...existing, ...chunk.css])) : chunk.css.slice());
+		}
+	}
+	if (!entryChunkFileName) throw new Error("No entry file found");
+	return {
+		entryChunkFileName,
+		chunksByFileName,
+		chunkFileNamesByRouteFilePath,
+		cssFilesBySourcePath
+	};
+}
+function getRouteFilePathsFromModuleIds(moduleIds) {
+	let routeFilePaths;
+	let seenRouteFilePaths;
+	for (const moduleId of moduleIds) {
+		const queryIndex = moduleId.indexOf("?");
+		if (queryIndex < 0) continue;
+		const query = moduleId.slice(queryIndex + 1);
+		if (!query.includes(tsrSplit)) continue;
+		if (!new URLSearchParams(query).has(tsrSplit)) continue;
+		const routeFilePath = moduleId.slice(0, queryIndex);
+		if (seenRouteFilePaths?.has(routeFilePath)) continue;
+		if (routeFilePaths === void 0 || seenRouteFilePaths === void 0) {
+			routeFilePaths = [];
+			seenRouteFilePaths = /* @__PURE__ */ new Set();
+		}
+		routeFilePaths.push(routeFilePath);
+		seenRouteFilePaths.add(routeFilePath);
+	}
+	return routeFilePaths ?? [];
+}
+//#endregion
+export { getRouteFilePathsFromModuleIds, normalizeViteClientBuild, normalizeViteClientChunk };
+
+//# sourceMappingURL=normalized-client-build.js.map

package/dist/esm/vite/start-manifest-plugin/normalized-client-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized-client-build.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/normalized-client-build.ts"],"sourcesContent":["import { tsrSplit } from '@tanstack/router-plugin'\nimport type { Rollup } from 'vite'\nimport type { NormalizedClientBuild, NormalizedClientChunk } from '../../types'\n\nexport function normalizeViteClientChunk(\n  chunk: Rollup.OutputChunk,\n): NormalizedClientChunk {\n  return {\n    fileName: chunk.fileName,\n    isEntry: chunk.isEntry,\n    imports: chunk.imports,\n    dynamicImports: chunk.dynamicImports,\n    css: Array.from(chunk.viteMetadata?.importedCss ?? []),\n    routeFilePaths: getRouteFilePathsFromModuleIds(chunk.moduleIds),\n  }\n}\n\nexport function normalizeViteClientChunks(\n  clientBundle: Rollup.OutputBundle,\n): ReadonlyMap<string, NormalizedClientChunk> {\n  const chunksByFileName = new Map<string, NormalizedClientChunk>()\n\n  for (const fileName in clientBundle) {\n    const bundleEntry = clientBundle[fileName]!\n    if (bundleEntry.type !== 'chunk') {\n      continue\n    }\n\n    const normalizedChunk = normalizeViteClientChunk(bundleEntry)\n    chunksByFileName.set(normalizedChunk.fileName, normalizedChunk)\n  }\n\n  return chunksByFileName\n}\n\nexport function normalizeViteClientBuild(\n  clientBundle: Rollup.OutputBundle,\n): NormalizedClientBuild {\n  let entryChunkFileName: string | undefined\n  const chunksByFileName = normalizeViteClientChunks(clientBundle)\n  const chunkFileNamesByRouteFilePath = new Map<string, Array<string>>()\n  const cssFilesBySourcePath = new Map<string, Array<string>>()\n\n  for (const chunk of chunksByFileName.values()) {\n    if (chunk.isEntry) {\n      if (entryChunkFileName) {\n        throw new Error(\n          `multiple entries detected: ${entryChunkFileName} ${chunk.fileName}`,\n        )\n      }\n      entryChunkFileName = chunk.fileName\n    }\n\n    for (const routeFilePath of chunk.routeFilePaths) {\n      let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath)\n      if (chunkFileNames === undefined) {\n        chunkFileNames = []\n        chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames)\n      }\n      chunkFileNames.push(chunk.fileName)\n    }\n\n    const bundleEntry = clientBundle[chunk.fileName]\n    if (bundleEntry?.type === 'chunk') {\n      for (const moduleId of bundleEntry.moduleIds) {\n        const queryIndex = moduleId.indexOf('?')\n        const sourcePath =\n          queryIndex >= 0 ? moduleId.slice(0, queryIndex) : moduleId\n        if (!sourcePath) continue\n\n        const existing = cssFilesBySourcePath.get(sourcePath)\n        cssFilesBySourcePath.set(\n          sourcePath,\n          existing\n            ? Array.from(new Set([...existing, ...chunk.css]))\n            : chunk.css.slice(),\n        )\n      }\n    }\n  }\n\n  if (!entryChunkFileName) {\n    throw new Error('No entry file found')\n  }\n\n  return {\n    entryChunkFileName,\n    chunksByFileName,\n    chunkFileNamesByRouteFilePath,\n    cssFilesBySourcePath,\n  }\n}\n\nexport function getRouteFilePathsFromModuleIds(moduleIds: Array<string>) {\n  let routeFilePaths: Array<string> | undefined\n  let seenRouteFilePaths: Set<string> | undefined\n\n  for (const moduleId of moduleIds) {\n    const queryIndex = moduleId.indexOf('?')\n\n    if (queryIndex < 0) {\n      continue\n    }\n\n    const query = moduleId.slice(queryIndex + 1)\n\n    if (!query.includes(tsrSplit)) {\n      continue\n    }\n\n    if (!new URLSearchParams(query).has(tsrSplit)) {\n      continue\n    }\n\n    const routeFilePath = moduleId.slice(0, queryIndex)\n\n    if (seenRouteFilePaths?.has(routeFilePath)) {\n      continue\n    }\n\n    if (routeFilePaths === undefined || seenRouteFilePaths === undefined) {\n      routeFilePaths = []\n      seenRouteFilePaths = new Set<string>()\n    }\n\n    routeFilePaths.push(routeFilePath)\n    seenRouteFilePaths.add(routeFilePath)\n  }\n\n  return routeFilePaths ?? []\n}\n"],"mappings":";;AAIA,SAAgB,yBACd,OACuB;AACvB,QAAO;EACL,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,SAAS,MAAM;EACf,gBAAgB,MAAM;EACtB,KAAK,MAAM,KAAK,MAAM,cAAc,eAAe,EAAE,CAAC;EACtD,gBAAgB,+BAA+B,MAAM,UAAU;EAChE;;AAGH,SAAgB,0BACd,cAC4C;CAC5C,MAAM,mCAAmB,IAAI,KAAoC;AAEjE,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,cAAc,aAAa;AACjC,MAAI,YAAY,SAAS,QACvB;EAGF,MAAM,kBAAkB,yBAAyB,YAAY;AAC7D,mBAAiB,IAAI,gBAAgB,UAAU,gBAAgB;;AAGjE,QAAO;;AAGT,SAAgB,yBACd,cACuB;CACvB,IAAI;CACJ,MAAM,mBAAmB,0BAA0B,aAAa;CAChE,MAAM,gDAAgC,IAAI,KAA4B;CACtE,MAAM,uCAAuB,IAAI,KAA4B;AAE7D,MAAK,MAAM,SAAS,iBAAiB,QAAQ,EAAE;AAC7C,MAAI,MAAM,SAAS;AACjB,OAAI,mBACF,OAAM,IAAI,MACR,8BAA8B,mBAAmB,GAAG,MAAM,WAC3D;AAEH,wBAAqB,MAAM;;AAG7B,OAAK,MAAM,iBAAiB,MAAM,gBAAgB;GAChD,IAAI,iBAAiB,8BAA8B,IAAI,cAAc;AACrE,OAAI,mBAAmB,KAAA,GAAW;AAChC,qBAAiB,EAAE;AACnB,kCAA8B,IAAI,eAAe,eAAe;;AAElE,kBAAe,KAAK,MAAM,SAAS;;EAGrC,MAAM,cAAc,aAAa,MAAM;AACvC,MAAI,aAAa,SAAS,QACxB,MAAK,MAAM,YAAY,YAAY,WAAW;GAC5C,MAAM,aAAa,SAAS,QAAQ,IAAI;GACxC,MAAM,aACJ,cAAc,IAAI,SAAS,MAAM,GAAG,WAAW,GAAG;AACpD,OAAI,CAAC,WAAY;GAEjB,MAAM,WAAW,qBAAqB,IAAI,WAAW;AACrD,wBAAqB,IACnB,YACA,WACI,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,UAAU,GAAG,MAAM,IAAI,CAAC,CAAC,GAChD,MAAM,IAAI,OAAO,CACtB;;;AAKP,KAAI,CAAC,mBACH,OAAM,IAAI,MAAM,sBAAsB;AAGxC,QAAO;EACL;EACA;EACA;EACA;EACD;;AAGH,SAAgB,+BAA+B,WAA0B;CACvE,IAAI;CACJ,IAAI;AAEJ,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,SAAS,QAAQ,IAAI;AAExC,MAAI,aAAa,EACf;EAGF,MAAM,QAAQ,SAAS,MAAM,aAAa,EAAE;AAE5C,MAAI,CAAC,MAAM,SAAS,SAAS,CAC3B;AAGF,MAAI,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,SAAS,CAC3C;EAGF,MAAM,gBAAgB,SAAS,MAAM,GAAG,WAAW;AAEnD,MAAI,oBAAoB,IAAI,cAAc,CACxC;AAGF,MAAI,mBAAmB,KAAA,KAAa,uBAAuB,KAAA,GAAW;AACpE,oBAAiB,EAAE;AACnB,wCAAqB,IAAI,KAAa;;AAGxC,iBAAe,KAAK,cAAc;AAClC,qBAAmB,IAAI,cAAc;;AAGvC,QAAO,kBAAkB,EAAE"}

package/dist/esm/vite/start-manifest-plugin/plugin.d.ts

@@ -0,0 +1,6 @@
+import { GetConfigFn, NormalizedClientBuild } from '../../types.js';
+import { PluginOption } from 'vite';
+export declare function startManifestPlugin(opts: {
+    getClientBuild: () => NormalizedClientBuild | undefined;
+    getConfig: GetConfigFn;
+}): PluginOption;

package/dist/esm/{start-manifest-plugin → vite/start-manifest-plugin}/plugin.js

@@ -1,9 +1,9 @@
-import { resolveViteId } from "../utils.js";
-import { ENTRY_POINTS } from "../constants.js";
-import { buildStartManifest } from "./manifestBuilder.js";
-import { joinURL } from "ufo";
+import { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from "../../constants.js";
+import { resolveViteId } from "../../utils.js";
+import { buildStartManifest } from "../../start-manifest-plugin/manifestBuilder.js";
 import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
-//#region src/start-manifest-plugin/plugin.ts
+import { joinURL } from "ufo";
+//#region src/vite/start-manifest-plugin/plugin.ts
 var resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest);
 function startManifestPlugin(opts) {
 	return {
@@ -20,16 +20,21 @@ function startManifestPlugin(opts) {
 			handler(id) {
 				const { resolvedStartConfig } = opts.getConfig();
 				if (id === resolvedModuleId) {
-					if (this.environment.name !== resolvedStartConfig.serverFnProviderEnv) return `export default {}`;
+					if (this.environment.name !== START_ENVIRONMENT_NAMES.server) return "export default {}";
 					if (this.environment.config.command === "serve") return `export const tsrStartManifest = () => ({
             routes: {},
-            clientEntry: '${joinURL(resolvedStartConfig.viteAppBase, "@id", ENTRY_POINTS.client)}',
+            clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, "@id", ENTRY_POINTS.client)}',
           })`;
 					const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST;
+					const clientBuild = opts.getClientBuild();
+					if (!clientBuild) return `export const tsrStartManifest = () => ({
+              routes: {},
+              clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, "@id", ENTRY_POINTS.client)}',
+              })`;
 					const startManifest = buildStartManifest({
-						clientBundle: opts.getClientBundle(),
+						clientBuild,
 						routeTreeRoutes,
-						basePath: resolvedStartConfig.viteAppBase
+						basePath: resolvedStartConfig.basePaths.publicBase
 					});
 					return `export const tsrStartManifest = () => (${JSON.stringify(startManifest)})`;
 				}

package/dist/esm/vite/start-manifest-plugin/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/plugin.ts"],"sourcesContent":["import { joinURL } from 'ufo'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { resolveViteId } from '../../utils'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'\nimport { buildStartManifest } from '../../start-manifest-plugin/manifestBuilder'\nimport type { GetConfigFn, NormalizedClientBuild } from '../../types'\nimport type { PluginOption } from 'vite'\n\nconst resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest)\n\nexport function startManifestPlugin(opts: {\n  getClientBuild: () => NormalizedClientBuild | undefined\n  getConfig: GetConfigFn\n}): PluginOption {\n  return {\n    name: 'tanstack-start:start-manifest-plugin',\n    enforce: 'pre',\n    resolveId: {\n      filter: { id: new RegExp(VIRTUAL_MODULES.startManifest) },\n      handler(id) {\n        if (id === VIRTUAL_MODULES.startManifest) {\n          return resolvedModuleId\n        }\n        return undefined\n      },\n    },\n    load: {\n      filter: {\n        id: new RegExp(resolvedModuleId),\n      },\n      handler(id) {\n        const { resolvedStartConfig } = opts.getConfig()\n        if (id === resolvedModuleId) {\n          if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {\n            return 'export default {}'\n          }\n\n          if (this.environment.config.command === 'serve') {\n            return `export const tsrStartManifest = () => ({\n            routes: {},\n            clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n          })`\n          }\n\n          const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n          const clientBuild = opts.getClientBuild()\n          // TODO this needs further discussion with vite-rsc, this is a temporary workaround\n          // If the client bundle isn't available yet (e.g., during RSC scan builds),\n          // return a dummy manifest. The real manifest will be generated in the actual build.\n          if (!clientBuild) {\n            return `export const tsrStartManifest = () => ({\n              routes: {},\n              clientEntry: '${joinURL(resolvedStartConfig.basePaths.publicBase, '@id', ENTRY_POINTS.client)}',\n              })`\n          }\n          const startManifest = buildStartManifest({\n            clientBuild,\n            routeTreeRoutes,\n            basePath: resolvedStartConfig.basePaths.publicBase,\n          })\n\n          return `export const tsrStartManifest = () => (${JSON.stringify(startManifest)})`\n        }\n\n        return undefined\n      },\n    },\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAM,mBAAmB,cAAc,gBAAgB,cAAc;AAErE,SAAgB,oBAAoB,MAGnB;AACf,QAAO;EACL,MAAM;EACN,SAAS;EACT,WAAW;GACT,QAAQ,EAAE,IAAI,IAAI,OAAO,gBAAgB,cAAc,EAAE;GACzD,QAAQ,IAAI;AACV,QAAI,OAAO,gBAAgB,cACzB,QAAO;;GAIZ;EACD,MAAM;GACJ,QAAQ,EACN,IAAI,IAAI,OAAO,iBAAiB,EACjC;GACD,QAAQ,IAAI;IACV,MAAM,EAAE,wBAAwB,KAAK,WAAW;AAChD,QAAI,OAAO,kBAAkB;AAC3B,SAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO;AAGT,SAAI,KAAK,YAAY,OAAO,YAAY,QACtC,QAAO;;4BAES,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;KAIhG,MAAM,kBAAkB,WAAW;KACnC,MAAM,cAAc,KAAK,gBAAgB;AAIzC,SAAI,CAAC,YACH,QAAO;;8BAEW,QAAQ,oBAAoB,UAAU,YAAY,OAAO,aAAa,OAAO,CAAC;;KAGlG,MAAM,gBAAgB,mBAAmB;MACvC;MACA;MACA,UAAU,oBAAoB,UAAU;MACzC,CAAC;AAEF,YAAO,0CAA0C,KAAK,UAAU,cAAc,CAAC;;;GAKpF;EACF"}

package/dist/esm/{start-router-plugin → vite/start-router-plugin}/plugin.d.ts

@@ -1,4 +1,5 @@
-import { GetConfigFn, TanStackStartVitePluginCoreOptions } from '../types.js';
+import { GetConfigFn } from '../../types.js';
+import { TanStackStartVitePluginCoreOptions } from '../types.js';
 import { PluginOption } from 'vite';
-import { TanStackStartInputConfig } from '../schema.js';
+import { TanStackStartInputConfig } from '../../schema.js';
 export declare function tanStackStartRouter(startPluginOpts: TanStackStartInputConfig, getConfig: GetConfigFn, corePluginOpts: TanStackStartVitePluginCoreOptions): Array<PluginOption>;

package/dist/esm/{start-router-plugin → vite/start-router-plugin}/plugin.js

@@ -1,35 +1,17 @@
-import { VITE_ENVIRONMENT_NAMES } from "../constants.js";
-import { routesManifestPlugin } from "./generator-plugins/routes-manifest-plugin.js";
-import { prerenderRoutesPlugin } from "./generator-plugins/prerender-routes-plugin.js";
-import "./constants.js";
-import { pruneServerOnlySubtrees } from "./pruneServerOnlySubtrees.js";
-import { normalizePath } from "vite";
+import { VITE_ENVIRONMENT_NAMES } from "../../constants.js";
+import { routesManifestPlugin } from "../../start-router-plugin/generator-plugins/routes-manifest-plugin.js";
+import { prerenderRoutesPlugin } from "../../start-router-plugin/generator-plugins/prerender-routes-plugin.js";
+import { buildRouteTreeFileFooterFromConfig } from "../../start-router-plugin/route-tree-footer.js";
+import "../../start-router-plugin/constants.js";
+import { pruneServerOnlySubtrees } from "../../start-router-plugin/pruneServerOnlySubtrees.js";
 import path from "pathe";
+import { normalizePath } from "vite";
 import { tanStackRouterCodeSplitter, tanstackRouterAutoImport, tanstackRouterGenerator } from "@tanstack/router-plugin/vite";
-//#region src/start-router-plugin/plugin.ts
+//#region src/vite/start-router-plugin/plugin.ts
 function isServerOnlyNode(node) {
 	if (!node?.createFileRouteProps) return false;
 	return node.createFileRouteProps.has("server") && node.createFileRouteProps.size === 1;
 }
-function moduleDeclaration({ startFilePath, routerFilePath, corePluginOpts, generatedRouteTreePath }) {
-	function getImportPath(absolutePath) {
-		let relativePath = path.relative(path.dirname(generatedRouteTreePath), absolutePath);
-		if (!relativePath.startsWith(".")) relativePath = "./" + relativePath;
-		relativePath = relativePath.split(path.sep).join("/");
-		return relativePath;
-	}
-	const result = [`import type { getRouter } from '${getImportPath(routerFilePath)}'`];
-	if (startFilePath) result.push(`import type { startInstance } from '${getImportPath(startFilePath)}'`);
-	else result.push(`import type { createStart } from '@tanstack/${corePluginOpts.framework}-start'`);
-	result.push(`declare module '@tanstack/${corePluginOpts.framework}-start' {
-  interface Register {
-    ssr: true
-    router: Awaited<ReturnType<typeof getRouter>>`);
-	if (startFilePath) result.push(`    config: Awaited<ReturnType<typeof startInstance.getOptions>>`);
-	result.push(`  }
-}`);
-	return result.join("\n");
-}
 function tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts) {
 	const getGeneratedRouteTreePath = () => {
 		const { startConfig } = getConfig();
@@ -58,16 +40,11 @@ function tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts) {
 	let routeTreeFileFooter = null;
 	function getRouteTreeFileFooter() {
 		if (routeTreeFileFooter) return routeTreeFileFooter;
-		const { startConfig, resolvedStartConfig } = getConfig();
-		const ogRouteTreeFileFooter = startConfig.router.routeTreeFileFooter;
-		if (ogRouteTreeFileFooter) if (Array.isArray(ogRouteTreeFileFooter)) routeTreeFileFooter = ogRouteTreeFileFooter;
-		else routeTreeFileFooter = ogRouteTreeFileFooter();
-		routeTreeFileFooter = [moduleDeclaration({
+		routeTreeFileFooter = [...buildRouteTreeFileFooterFromConfig({
 			generatedRouteTreePath: getGeneratedRouteTreePath(),
-			corePluginOpts,
-			startFilePath: resolvedStartConfig.startFilePath,
-			routerFilePath: resolvedStartConfig.routerFilePath
-		}), ...routeTreeFileFooter ?? []];
+			getConfig,
+			corePluginOpts
+		})];
 		return routeTreeFileFooter;
 	}
 	let resolvedGeneratedRouteTreePath = null;
@@ -114,7 +91,7 @@ function tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts) {
 		tanstackRouterGenerator(() => {
 			const routerConfig = getConfig().startConfig.router;
 			const plugins = [clientTreeGeneratorPlugin, routesManifestPlugin()];
-			if (startPluginOpts?.prerender?.enabled === true) plugins.push(prerenderRoutesPlugin());
+			if (startPluginOpts.prerender?.enabled === true) plugins.push(prerenderRoutesPlugin());
 			return {
 				...routerConfig,
 				target: corePluginOpts.framework,
@@ -149,7 +126,7 @@ function tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts) {
 				plugin: { vite: { environmentName: VITE_ENVIRONMENT_NAMES.server } }
 			};
 		}),
-		tanstackRouterAutoImport(startPluginOpts?.router)
+		tanstackRouterAutoImport(startPluginOpts.router)
 	];
 }
 //#endregion