@tanstack/start-plugin-core 1.167.35 → 1.169.0

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

@@ -1,15 +1,20 @@
 //#region src/vite/start-compiler-plugin/module-specifier.ts
 function createViteDevServerFnModuleSpecifierEncoder(root) {
-	const rootWithTrailingSlash = root.endsWith("/") ? root : `${root}/`;
+	const normalizedRoot = root.replace(/\\/g, "/");
+	const rootWithTrailingSlash = normalizedRoot.endsWith("/") ? normalizedRoot : `${normalizedRoot}/`;
 	return ({ extractedFilename }) => {
-		let file = extractedFilename;
-		if (file.startsWith(rootWithTrailingSlash)) file = file.slice(rootWithTrailingSlash.length);
-		return `/@id/${file}`;
+		const normalizedFile = extractedFilename.replace(/\\/g, "/");
+		if (normalizedFile.startsWith(rootWithTrailingSlash)) return `/${normalizedFile.slice(rootWithTrailingSlash.length)}`;
+		return normalizedFile.startsWith("/") ? `/@fs${normalizedFile}` : `/@fs/${normalizedFile}`;
 	};
 }
 function decodeViteDevServerModuleSpecifier(moduleSpecifier) {
 	let sourceFile = moduleSpecifier;
 	if (sourceFile.startsWith("/@id/")) sourceFile = sourceFile.slice(5);
+	else if (sourceFile.startsWith("/@fs/")) {
+		sourceFile = sourceFile.slice(4);
+		sourceFile = sourceFile.replace(/^\/([A-Za-z]:\/)/, "$1");
+	} else if (sourceFile.startsWith("/")) sourceFile = sourceFile.slice(1);
 	const queryIndex = sourceFile.indexOf("?");
 	return queryIndex === -1 ? sourceFile : sourceFile.slice(0, queryIndex);
 }

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

@@ -1 +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"}
+{"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 normalizedRoot = root.replace(/\\\\/g, '/')\n  const rootWithTrailingSlash = normalizedRoot.endsWith('/')\n    ? normalizedRoot\n    : `${normalizedRoot}/`\n\n  return ({ extractedFilename }) => {\n    const normalizedFile = extractedFilename.replace(/\\\\/g, '/')\n\n    if (normalizedFile.startsWith(rootWithTrailingSlash)) {\n      return `/${normalizedFile.slice(rootWithTrailingSlash.length)}`\n    }\n\n    return normalizedFile.startsWith('/')\n      ? `/@fs${normalizedFile}`\n      : `/@fs/${normalizedFile}`\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  } else if (sourceFile.startsWith('/@fs/')) {\n    sourceFile = sourceFile.slice('/@fs'.length)\n    sourceFile = sourceFile.replace(/^\\/([A-Za-z]:\\/)/, '$1')\n  } else if (sourceFile.startsWith('/')) {\n    sourceFile = sourceFile.slice(1)\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,iBAAiB,KAAK,QAAQ,OAAO,IAAI;CAC/C,MAAM,wBAAwB,eAAe,SAAS,IAAI,GACtD,iBACA,GAAG,eAAe;AAEtB,SAAQ,EAAE,wBAAwB;EAChC,MAAM,iBAAiB,kBAAkB,QAAQ,OAAO,IAAI;AAE5D,MAAI,eAAe,WAAW,sBAAsB,CAClD,QAAO,IAAI,eAAe,MAAM,sBAAsB,OAAO;AAG/D,SAAO,eAAe,WAAW,IAAI,GACjC,OAAO,mBACP,QAAQ;;;AAIhB,SAAgB,mCACd,iBACQ;CACR,IAAI,aAAa;AAEjB,KAAI,WAAW,WAAW,QAAQ,CAChC,cAAa,WAAW,MAAM,EAAe;UACpC,WAAW,WAAW,QAAQ,EAAE;AACzC,eAAa,WAAW,MAAM,EAAc;AAC5C,eAAa,WAAW,QAAQ,oBAAoB,KAAK;YAChD,WAAW,WAAW,IAAI,CACnC,cAAa,WAAW,MAAM,EAAE;CAGlC,MAAM,aAAa,WAAW,QAAQ,IAAI;AAE1C,QAAO,eAAe,KAAK,aAAa,WAAW,MAAM,GAAG,WAAW"}

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

@@ -5,14 +5,46 @@ 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 { mergeHotUpdateModules } from "./hot-update.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
 var validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`;
+var TSS_SERVERFN_SPLIT_PARAM = "tss-serverfn-split";
+function invalidateMatchingFileModules(environment, ids, shouldInvalidate) {
+	const seen = /* @__PURE__ */ new Set();
+	const invalidatedModules = [];
+	for (const id of ids) {
+		const fileModules = environment.moduleGraph.getModulesByFile(cleanId(id));
+		if (!fileModules) continue;
+		for (const fileModule of fileModules) {
+			if (!shouldInvalidate(fileModule)) continue;
+			environment.moduleGraph.invalidateModule(fileModule, seen);
+			invalidatedModules.push(fileModule);
+		}
+	}
+	return invalidatedModules;
+}
+function invalidateServerFnProviderModules(environment, ids) {
+	return invalidateMatchingFileModules(environment, ids, (fileModule) => fileModule.id?.includes(TSS_SERVERFN_SPLIT_PARAM) ?? false);
+}
+function invalidateServerFnLookupModules(environment, ids) {
+	invalidateMatchingFileModules(environment, ids, (fileModule) => fileModule.id?.includes("server-fn-module-lookup") ?? false);
+}
+function getServerFnProviderIds(ids) {
+	const providerIds = /* @__PURE__ */ new Set();
+	for (const id of ids) {
+		const cleanedId = cleanId(id);
+		providerIds.add(`${cleanedId}?${TSS_SERVERFN_SPLIT_PARAM}`);
+	}
+	return providerIds;
+}
+function invalidateModuleNodes(environment, modules) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const mod of modules) environment.moduleGraph.invalidateModule(mod, seen);
+}
 function getDevServerFnValidatorModule() {
 	return `
 export async function getServerFnById(id, _access) {
@@ -81,13 +113,16 @@ function startCompilerPlugin(opts) {
 							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
-								});
+								if (mode === "build") {
+									const code = (await this.load({ id })).code ?? "";
+									compiler.ingestModule({
+										code,
+										id
+									});
+									return;
+								}
+								if (this.environment.mode !== "dev") this.error(`could not load module ${id}: unknown environment mode ${this.environment.mode}`);
+								await this.environment.transformRequest(`${id}?${SERVER_FN_LOOKUP}`);
 							},
 							resolveId: async (source, importer) => {
 								const r = await this.resolve(source, importer);
@@ -109,13 +144,51 @@ function startCompilerPlugin(opts) {
 			},
 			hotUpdate(ctx) {
 				const compiler = compilers.get(this.environment.name);
+				const idsToInvalidate = /* @__PURE__ */ new Set();
+				const transitiveCompilerImportersToInvalidate = /* @__PURE__ */ new Set();
+				const importerModulesToInvalidate = /* @__PURE__ */ new Set();
 				ctx.modules.forEach((m) => {
 					if (m.id) {
-						if (compiler?.invalidateModule(m.id)) m.importers.forEach((importer) => {
-							if (importer.id) compiler?.invalidateModule(importer.id);
+						idsToInvalidate.add(m.id);
+						const deleted = compiler?.invalidateModule(m.id);
+						if (deleted) transitiveCompilerImportersToInvalidate.add(cleanId(m.id));
+						if (deleted) m.importers.forEach((importer) => {
+							if (importer.id) {
+								idsToInvalidate.add(importer.id);
+								importerModulesToInvalidate.add(importer);
+								transitiveCompilerImportersToInvalidate.add(cleanId(importer.id));
+							}
 						});
 					}
 				});
+				const finishHotUpdate = async () => {
+					if (environment.type === "server" && compiler) {
+						const pendingImporters = [...transitiveCompilerImportersToInvalidate];
+						const seenImporters = new Set(pendingImporters);
+						while (pendingImporters.length > 0) {
+							const importerId = pendingImporters.pop();
+							const nestedImporters = await compiler.getTransitiveImporters(importerId);
+							for (const nestedImporterId of nestedImporters) {
+								if (seenImporters.has(nestedImporterId)) continue;
+								seenImporters.add(nestedImporterId);
+								pendingImporters.push(nestedImporterId);
+							}
+						}
+						for (const importerId of seenImporters) {
+							idsToInvalidate.add(importerId);
+							compiler.invalidateModule(importerId);
+						}
+					}
+					invalidateModuleNodes(this.environment, importerModulesToInvalidate);
+					invalidateServerFnLookupModules(this.environment, idsToInvalidate);
+					if (environment.type !== "server") return;
+					invalidateModuleNodes(this.environment, ctx.modules);
+					const providerIdsToInvalidate = getServerFnProviderIds(idsToInvalidate);
+					for (const providerId of providerIdsToInvalidate) compiler?.invalidateModule(providerId);
+					const providerModules = invalidateServerFnProviderModules(this.environment, [...idsToInvalidate, ...providerIdsToInvalidate]);
+					return mergeHotUpdateModules(ctx.modules, providerModules);
+				};
+				return finishHotUpdate();
 			}
 		};
 	}
@@ -151,8 +224,8 @@ function startCompilerPlugin(opts) {
 							const sourceFile = decodeViteDevServerModuleSpecifier(decoded.file);
 							if (sourceFile) {
 								const absPath = resolve(root, sourceFile);
-								assert(this.environment.mode === "dev");
-								await this.environment.fetchModule(absPath);
+								if (this.environment.mode !== "dev") this.error(`could not validate server function ID ${fnId}: unknown environment mode ${this.environment.mode}`);
+								await this.environment.transformRequest(`${absPath}?${SERVER_FN_LOOKUP}`);
 								if (serverFnsById[fnId]) return `export {}`;
 							}
 						}

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

@@ -1 +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 { createVirtualModule } from '../createVirtualModule'\nimport { resolveViteId } from '../../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\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  // 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    createVirtualModule({\n      name: 'tanstack-start-core:server-fn-resolver',\n      moduleId: VIRTUAL_MODULES.serverFnResolver,\n      enforce: 'pre',\n      applyToEnvironment: (env) => {\n        return appliedResolverEnvironments.has(env.name)\n      },\n      load() {\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          }\n\n          this.error(\n            `No getServerFnById implementation found for caller environment: ${this.environment.name}`,\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"],"mappings":";;;;;;;;;;;;;;AAiCA,IAAM,kCAAkC;AAExC,SAAS,gCAAwC;AAC/C,QAAO;;6BAEoB,KAAK,UAAU,gCAAgC,CAAC;;;;;;;;;AAU7E,SAAS,aAAa,IAKpB;AACA,KAAI,CAAC,GAAG,SAAS,IAAI,CAAE,QAAO;EAAE,UAAU;EAAI,OAAO,EAAE;EAAE;CACzD,MAAM,CAAC,UAAU,YAAY,GAAG,MAAM,KAAK,EAAE;AAE7C,QAAO;EAAE;EAAU,OADL,OAAO,YAAY,IAAI,gBAAgB,SAAS,CAAC;EACrC;;AAoB5B,SAAgB,oBACd,MACc;CACd,MAAM,4BAAY,IAAI,KAAqD;CAG3E,MAAM,gBAA0C,EAAE;CAElD,MAAM,mBAAmB,MAAgC;AACvD,qBAAmB,eAAe,EAAE;;CAGtC,IAAI,OAAO,QAAQ,KAAK;CAIxB,MAAM,aAAa,uBAAuB;CAG1C,MAAM,gBAAgB,KAAK,oBAAoB;CAG/C,MAAM,8BAA8B,IAAI,IACtC,gBAAgB,CAAC,KAAK,gBAAgB,GAAG,CAAC,YAAY,KAAK,gBAAgB,CAC5E;CAED,SAAS,qBAAqB,aAGb;EAEf,MAAM,sBAAsB,6BAA6B,YAAY,KAAK;AAC1E,SAAO;GACL,MAAM,kCAAkC,YAAY;GACpD,SAAS;GACT,mBAAmB,KAAK;AACtB,WAAO,IAAI,SAAS,YAAY;;GAElC,eAAe,QAAQ;AACrB,WAAO,OAAO;;GAEhB,WAAW;IACT,QAAQ;KACN,IAAI;MACF,SAAS,IAAI,OAAO,GAAG,iBAAiB,GAAG;MAC3C,SAAS;MACV;KACD,MAAM,EACJ,SAAS,qBACV;KACF;IACD,MAAM,QAAQ,MAAM,IAAI;KACtB,IAAI,WAAW,UAAU,IAAI,KAAK,YAAY,KAAK;AAEnD,SAAI,CAAC,UAAU;MAEb,MAAM,OAAO,KAAK,YAAY,SAAS,UAAU,UAAU;AAE3D,iBAAW,oBAAoB;OAC7B,KAAK,YAAY;OACjB,SAAS,YAAY;OACrB;OACA;OACA,WAAW,KAAK;OAChB,iBAAiB,KAAK;OACtB,oBAAoB,KAAK;OACzB;OACA,yBAAyB;OACzB,4BACE,SAAS,QACL,4CAA4C,KAAK,GACjD,KAAA;OACN,YAAY,OAAO,OAAe;AAChC,cAAM,0BAA0B;SACpB;SACV,MAAM,KAAK,YAAY;SACvB,aACE,KAAK,YAAY,SAAS,QACtB,KAAK,YAAY,YAAY,KAAK,KAAK,YAAY,GACnD,KAAA;SACN,YAAY,KAAK,KAAK,KAAK,KAAK;SAChC;SACD,CAAC;;OAGJ,WAAW,OAAO,QAAgB,aAAsB;QACtD,MAAM,IAAI,MAAM,KAAK,QAAQ,QAAQ,SAAS;AAE9C,YAAI;aACE,CAAC,EAAE,SACL,QAAO,QAAQ,EAAE,GAAG;;AAIxB,eAAO;;OAEV,CAAC;AAEF,gBAAU,IAAI,KAAK,YAAY,MAAM,SAAS;;KAIhD,MAAM,gBAAgB,kBAAkB,MAAM,YAAY,KAAK;AAO/D,YALe,MAAM,SAAS,QAAQ;MACpC;MACA;MACA;MACD,CAAC;;IAGL;GAED,UAAU,KAAK;IACb,MAAM,WAAW,UAAU,IAAI,KAAK,YAAY,KAAK;AAErD,QAAI,QAAQ,SAAS,MAAM;AACzB,SAAI,EAAE;UACY,UAAU,iBAAiB,EAAE,GAAG,CAE9C,GAAE,UAAU,SAAS,aAAa;AAChC,WAAI,SAAS,GACX,WAAU,iBAAiB,SAAS,GAAG;QAEzC;;MAGN;;GAEL;;AAGH,QAAO;EACL,GAAG,KAAK,aAAa,IAAI,qBAAqB;EAC9C;GACE,MAAM;GAEN,OAAO;GACP,mBAAmB,KAAK;AACtB,WAAO,CAAC,CAAC,KAAK,aAAa,MAAM,MAAM,EAAE,SAAS,IAAI,KAAK;;GAE7D,WAAW;IACT,QAAQ,EACN,IAAI,IAAI,OAAO,GAAG,iBAAiB,GAAG,EACvC;IACD,QAAQ,MAAM,IAAI;AACC,eAAU,IAAI,KAAK,YAAY,KAAK,EAC3C,aAAa;MAAE;MAAM,IAAI,QAAQ,GAAG;MAAE,CAAC;;IAEpD;GACF;EAED;GACE,MAAM;GACN,OAAO;GACP,MAAM;IACJ,QAAQ,EACN,IAAI,IAAI,OAAO,cAAc,gCAAgC,CAAC,EAC/D;IACD,MAAM,QAAQ,IAAI;KAEhB,MAAM,OADS,aAAa,GAAG,CACX,MAAM;AAC1B,SAAI,QAAQ,cAAc,MACxB,QAAO;AAOT,SAAI,KACF,KAAI;MACF,MAAM,UAAU,KAAK,MACnB,OAAO,KAAK,MAAM,YAAY,CAAC,SAAS,OAAO,CAChD;AACD,UACE,OAAO,QAAQ,SAAS,YACxB,OAAO,QAAQ,WAAW,UAC1B;OAGA,MAAM,aAAa,mCACjB,QAAQ,KACT;AAED,WAAI,YAAY;QAEd,MAAM,UAAU,QAAY,MAAM,WAAW;AAO7C,eAAO,KAAK,YAAY,SAAS,MAAM;AACvC,cAAM,KAAK,YAAY,YAAY,QAAQ;AAG3C,YAAI,cAAc,MAChB,QAAO;;;aAIP;AAKV,UAAK,MAAM,+BAA+B,OAAO;;IAEpD;GACF;EAED,oBAAoB;GAClB,MAAM;GACN,UAAU,gBAAgB;GAC1B,SAAS;GACT,qBAAqB,QAAQ;AAC3B,WAAO,4BAA4B,IAAI,IAAI,KAAK;;GAElD,OAAO;AACL,QAAI,KAAK,YAAY,SAAS,KAAK,iBAAiB;KAClD,MAAM,MAAM,KAAK,aAAa,MAC3B,MAAM,EAAE,SAAS,KAAK,YAAY,KACpC,EAAE;AACH,SAAI,IACF,QAAO;AAGT,UAAK,MACH,mEAAmE,KAAK,YAAY,OACrF;;AAGH,QAAI,KAAK,YAAY,SAAS,QAC5B,QAAO,+BAA+B;AAQxC,WAAO,+BAA+B;KACpC;KACA,8BAA8B,CAAC;KAChC,CAAC;;GAEL,CAAC;EACH"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-compiler-plugin/plugin.ts"],"sourcesContent":["import { 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 { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module'\nimport { cleanId } from '../../start-compiler/utils'\nimport { createVirtualModule } from '../createVirtualModule'\nimport { resolveViteId } from '../../utils'\nimport {\n  createViteDevServerFnModuleSpecifierEncoder,\n  decodeViteDevServerModuleSpecifier,\n} from './module-specifier'\nimport { mergeHotUpdateModules } from './hot-update'\nimport type { CompileStartFrameworkOptions } from '../../types'\nimport type {\n  GenerateFunctionIdFnOptional,\n  ServerFn,\n} from '../../start-compiler/types'\nimport type { EnvironmentModuleNode, PluginOption } from 'vite'\n\n// Re-export from shared constants for backwards compatibility\nexport { SERVER_FN_LOOKUP }\n\nconst validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id`\nconst TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split'\n\ntype ModuleInvalidationEnvironment = {\n  moduleGraph: {\n    getModulesByFile: (file: string) => Set<EnvironmentModuleNode> | undefined\n    invalidateModule: (\n      mod: EnvironmentModuleNode,\n      seen?: Set<EnvironmentModuleNode>,\n    ) => void\n  }\n}\n\nfunction invalidateMatchingFileModules(\n  environment: ModuleInvalidationEnvironment,\n  ids: Iterable<string>,\n  shouldInvalidate: (mod: EnvironmentModuleNode) => boolean,\n) {\n  const seen = new Set<EnvironmentModuleNode>()\n  const invalidatedModules: Array<EnvironmentModuleNode> = []\n\n  for (const id of ids) {\n    const fileModules = environment.moduleGraph.getModulesByFile(cleanId(id))\n\n    if (!fileModules) {\n      continue\n    }\n\n    for (const fileModule of fileModules) {\n      if (!shouldInvalidate(fileModule)) {\n        continue\n      }\n\n      environment.moduleGraph.invalidateModule(fileModule, seen)\n      invalidatedModules.push(fileModule)\n    }\n  }\n\n  return invalidatedModules\n}\n\nfunction invalidateServerFnProviderModules(\n  environment: {\n    moduleGraph: {\n      getModulesByFile: (file: string) => Set<EnvironmentModuleNode> | undefined\n      invalidateModule: (\n        mod: EnvironmentModuleNode,\n        seen?: Set<EnvironmentModuleNode>,\n      ) => void\n    }\n  },\n  ids: Iterable<string>,\n) {\n  return invalidateMatchingFileModules(\n    environment,\n    ids,\n    (fileModule) => fileModule.id?.includes(TSS_SERVERFN_SPLIT_PARAM) ?? false,\n  )\n}\n\nfunction invalidateServerFnLookupModules(\n  environment: ModuleInvalidationEnvironment,\n  ids: Iterable<string>,\n) {\n  invalidateMatchingFileModules(\n    environment,\n    ids,\n    (fileModule) => fileModule.id?.includes(SERVER_FN_LOOKUP) ?? false,\n  )\n}\n\nfunction getServerFnProviderIds(ids: Iterable<string>) {\n  const providerIds = new Set<string>()\n\n  for (const id of ids) {\n    const cleanedId = cleanId(id)\n    providerIds.add(`${cleanedId}?${TSS_SERVERFN_SPLIT_PARAM}`)\n  }\n\n  return providerIds\n}\n\nfunction invalidateModuleNodes(\n  environment: {\n    moduleGraph: {\n      invalidateModule: (\n        mod: EnvironmentModuleNode,\n        seen?: Set<EnvironmentModuleNode>,\n      ) => void\n    }\n  },\n  modules: Iterable<EnvironmentModuleNode>,\n) {\n  const seen = new Set<EnvironmentModuleNode>()\n\n  for (const mod of modules) {\n    environment.moduleGraph.invalidateModule(mod, seen)\n  }\n}\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  // 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                if (mode === 'build') {\n                  const loaded = await this.load({ id })\n                  const code = loaded.code ?? ''\n\n                  compiler!.ingestModule({ code, id })\n                  return\n                }\n\n                if (this.environment.mode !== 'dev') {\n                  this.error(\n                    `could not load module ${id}: unknown environment mode ${this.environment.mode}`,\n                  )\n                }\n\n                await this.environment.transformRequest(\n                  `${id}?${SERVER_FN_LOOKUP}`,\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        const idsToInvalidate = new Set<string>()\n        const transitiveCompilerImportersToInvalidate = new Set<string>()\n        const importerModulesToInvalidate = new Set<EnvironmentModuleNode>()\n\n        ctx.modules.forEach((m) => {\n          if (m.id) {\n            idsToInvalidate.add(m.id)\n            const deleted = compiler?.invalidateModule(m.id)\n\n            if (deleted) {\n              transitiveCompilerImportersToInvalidate.add(cleanId(m.id))\n            }\n\n            if (deleted) {\n              m.importers.forEach((importer) => {\n                if (importer.id) {\n                  idsToInvalidate.add(importer.id)\n                  importerModulesToInvalidate.add(importer)\n                  transitiveCompilerImportersToInvalidate.add(\n                    cleanId(importer.id),\n                  )\n                }\n              })\n            }\n          }\n        })\n\n        const finishHotUpdate = async () => {\n          if (environment.type === 'server' && compiler) {\n            const pendingImporters = [\n              ...transitiveCompilerImportersToInvalidate,\n            ]\n            const seenImporters = new Set(pendingImporters)\n\n            while (pendingImporters.length > 0) {\n              const importerId = pendingImporters.pop()!\n              const nestedImporters =\n                await compiler.getTransitiveImporters(importerId)\n\n              for (const nestedImporterId of nestedImporters) {\n                if (seenImporters.has(nestedImporterId)) {\n                  continue\n                }\n\n                seenImporters.add(nestedImporterId)\n                pendingImporters.push(nestedImporterId)\n              }\n            }\n\n            for (const importerId of seenImporters) {\n              idsToInvalidate.add(importerId)\n              compiler.invalidateModule(importerId)\n            }\n          }\n\n          invalidateModuleNodes(this.environment, importerModulesToInvalidate)\n          invalidateServerFnLookupModules(this.environment, idsToInvalidate)\n\n          if (environment.type !== 'server') {\n            return\n          }\n\n          invalidateModuleNodes(this.environment, ctx.modules)\n\n          const providerIdsToInvalidate =\n            getServerFnProviderIds(idsToInvalidate)\n          for (const providerId of providerIdsToInvalidate) {\n            compiler?.invalidateModule(providerId)\n          }\n\n          const providerModules = invalidateServerFnProviderModules(\n            this.environment,\n            [...idsToInvalidate, ...providerIdsToInvalidate],\n          )\n\n          return mergeHotUpdateModules(ctx.modules, providerModules)\n        }\n\n        return finishHotUpdate()\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                  if (this.environment.mode !== 'dev') {\n                    this.error(\n                      `could not validate server function ID ${fnId}: unknown environment mode ${this.environment.mode}`,\n                    )\n                  }\n\n                  await this.environment.transformRequest(\n                    `${absPath}?${SERVER_FN_LOOKUP}`,\n                  )\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    createVirtualModule({\n      name: 'tanstack-start-core:server-fn-resolver',\n      moduleId: VIRTUAL_MODULES.serverFnResolver,\n      enforce: 'pre',\n      applyToEnvironment: (env) => {\n        return appliedResolverEnvironments.has(env.name)\n      },\n      load() {\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          }\n\n          this.error(\n            `No getServerFnById implementation found for caller environment: ${this.environment.name}`,\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"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-plugin-core",
-  "version": "1.167.35",
+  "version": "1.169.0",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -40,6 +40,24 @@
         "default": "./dist/esm/utils.js"
       }
     },
+    "./vite": {
+      "import": {
+        "types": "./dist/esm/vite/index.d.ts",
+        "default": "./dist/esm/vite/index.js"
+      }
+    },
+    "./rsbuild": {
+      "import": {
+        "types": "./dist/esm/rsbuild/index.d.ts",
+        "default": "./dist/esm/rsbuild/index.js"
+      }
+    },
+    "./rsbuild/types": {
+      "import": {
+        "types": "./dist/esm/rsbuild/types.d.ts",
+        "default": "./dist/esm/rsbuild/types.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -68,13 +86,14 @@
     "xmlbuilder2": "^4.0.3",
     "zod": "^3.24.2",
     "@tanstack/router-core": "1.168.15",
-    "@tanstack/router-generator": "1.166.32",
-    "@tanstack/router-plugin": "1.167.22",
-    "@tanstack/router-utils": "1.161.6",
+    "@tanstack/router-generator": "1.166.33",
+    "@tanstack/router-plugin": "1.167.23",
+    "@tanstack/router-utils": "1.161.7",
     "@tanstack/start-client-core": "1.167.17",
     "@tanstack/start-server-core": "1.167.19"
   },
   "devDependencies": {
+    "@rsbuild/core": "^2.0.0",
     "@types/babel__code-frame": "^7.0.6",
     "@types/babel__core": "^7.20.5",
     "@types/picomatch": "^4.0.2",
@@ -82,8 +101,17 @@
     "@types/node": ">=20"
   },
   "peerDependencies": {
+    "@rsbuild/core": "^2.0.0",
     "vite": ">=7.0.0"
   },
+  "peerDependenciesMeta": {
+    "@rsbuild/core": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  },
   "scripts": {
     "clean": "rimraf ./dist && rimraf ./coverage",
     "clean:snapshots": "rimraf **/*snapshot* --glob",

package/src/import-protection/INTERNALS.md

@@ -0,0 +1,266 @@
+# Import Protection - Shared Internals
+
+## Overview
+
+`src/import-protection/` contains the adapter-independent core for TanStack
+Start import protection.
+
+Its current structure is:
+
+- parse module code once per `TransformResult`
+- derive a read-only `ImportAnalysis` object from that AST
+- reuse that analysis for source extraction, import-specifier locations, mock
+  export discovery, named export discovery, and usage lookup
+- keep AST mutation in a separate rewrite pass
+- keep adapter lifecycle/state-machine behavior outside this directory
+
+The shared layer is responsible for correctness-sensitive logic that must stay
+aligned between Vite and Rsbuild.
+
+## Shared Module Layout
+
+### `analysis.ts`
+
+The central shared analysis module.
+
+It builds and caches `ImportAnalysis` on `TransformResult.analysis`.
+
+`ImportAnalysis` contains:
+
+- parsed AST
+- line index
+- import sources in source order
+- import specifier literal locations
+- imported bindings by source
+- mock export names by source
+- named exports
+- usage-position cache
+
+It exposes both result-based and code-based helpers:
+
+- `getOrCreateImportAnalysis(result)`
+- `getImportSourcesFromResult(result)`
+- `getImportSources(code)`
+- `getImportSpecifierLocationFromResult(result, source)`
+- `getMockExportNamesBySourceFromResult(result)`
+- `getMockExportNamesBySource(code)`
+- `getNamedExportsFromResult(result)`
+- `getNamedExports(code)`
+- `findPostCompileUsagePosFromResult(result, source)`
+- `findPostCompileUsagePos(code, source)`
+- `findOriginalUnsafeUsagePosFromResult(result, source, envType)`
+- `findOriginalUnsafeUsagePos(code, source, envType)`
+- `isValidExportName(name)`
+
+### `adapterUtils.ts`
+
+Contains small adapter-facing shared helpers for decisions that are identical in
+Vite and Rsbuild.
+
+It currently owns:
+
+- environment type selection from `envTypeMap`
+- environment rule selection from `compiledRules`
+- normalized root-relative path calculation
+- importer filtering via include/exclude/ignore/srcDirectory rules
+
+This keeps the adapters from duplicating the same targeting logic while still
+leaving lifecycle-specific behavior in the adapter implementations.
+
+### `rewrite.ts`
+
+Contains the actual AST mutation pass for denied static imports and re-exports.
+
+It is intentionally separate from `analysis.ts`.
+
+Why:
+
+- analysis is read-only and cacheable
+- rewrite mutates AST structure and generates code/maps
+- keeping them separate prevents adapter code from depending on mutation when it
+  only needs inspection
+
+`rewriteDeniedImports()` rewrites denied static import/re-export edges to mock
+module imports while preserving explicit bindings expected by the importer.
+
+### `sourceLocation.ts`
+
+Builds source locations and snippets from transformed code plus sourcemaps.
+
+It reuses shared analysis for two important lookups:
+
+- import-specifier positions in transformed code
+- post-compile and original-source usage locations
+
+It also owns:
+
+- line-index helpers
+- sourcemap normalization
+- `sourcesContent` original-source selection
+- import-location caching for traces
+- code snippet formatting
+
+### `virtualModules.ts`
+
+Owns the shared mock module generators and payload encoding.
+
+This includes:
+
+- silent mock module code
+- runtime diagnostic mock module code
+- mock-edge module code with explicit named exports
+- self-denial module generation for denied files
+- marker module loading
+
+The adapter-specific transport of these modules is not handled here.
+
+### `defaults.ts`, `matchers.ts`, `utils.ts`, `trace.ts`
+
+These remain shared support layers:
+
+- `defaults.ts`: default deny/marker rules
+- `matchers.ts`: compiled glob/regex matcher utilities
+- `utils.ts`: path normalization, candidate generation, messages, defer logic,
+  generic helpers
+- `trace.ts`: import graph, traces, snippet-aware message formatting
+
+## Analysis Lifetime And Cache Model
+
+The key cache decision is: analysis is cached per `TransformResult`, not
+globally by source text.
+
+That means:
+
+- Vite can attach analysis to transform-cache results for the current module
+  version
+- Rsbuild can attach analysis to transform results rebuilt from compilation or
+  preloaded during transform
+- cache invalidation follows the host tool's normal module invalidation model
+- long dev/HMR sessions do not accumulate an unbounded process-global AST cache
+
+The analysis object is read-only after creation, except for the internal
+`usageByKey` memoization map.
+
+## Import Source Extraction
+
+`getImportSources()` is now AST-driven and returns sources in encountered order.
+
+It includes:
+
+- `import ... from 'x'`
+- `export ... from 'x'`
+- `export * from 'x'`
+- `import('x')`
+- dynamic import call forms supported by Babel's AST shape
+
+Adapter code that needs source extraction should call into `analysis.ts`
+directly.
+
+## Mock Export Discovery
+
+Mock-edge modules need to know which named exports the importer expects.
+
+`analysis.ts` derives that from the importer AST by recording:
+
+- named import specifiers
+- namespace member access
+- default-import member access
+- re-export specifiers
+
+This produces `mockExportNamesBySource`, which is a safe over-approximation of
+the named exports the adapter should expose on a mock-edge module.
+
+## Named Export Discovery
+
+Self-denial needs the denied file's export surface.
+
+`getNamedExports()` and `getNamedExportsFromResult()` collect valid named
+exports from:
+
+- function/class declarations
+- variable declarations, including destructuring patterns
+- export specifiers and aliases
+
+`default` is excluded from the named export list because the mock generators
+handle default export separately.
+
+## Usage Lookup And Safe Boundaries
+
+Usage lookup is shared across adapters through `analysis.ts`.
+
+The walker:
+
+- tracks lexical/program/block/function bindings manually
+- respects shadowing across nested scopes, block bindings, function params, and
+  `catch` params
+- treats certain compiler-recognized boundaries as safe when looking for
+  original unsafe usage
+
+Safe boundary recognition is environment-specific:
+
+- client env safe boundaries:
+  - `createServerFn().handler(...)`
+  - `createMiddleware(...).server(...)`
+  - `createIsomorphicFn().server(...)`
+  - `createServerOnlyFn(...)`
+- server env safe boundaries:
+  - `createClientOnlyFn(...)`
+  - `createIsomorphicFn().client(...)`
+
+This is the core shared logic that keeps both adapters aligned on cases like
+`boundary-safe`, `factory-safe`, and `compiler-leak`.
+
+## Rewriting Versus Analysis
+
+Analysis and rewrite are intentionally separate.
+
+Reasons:
+
+- adapters frequently need inspection without mutation
+- mutation wants a fresh, isolated AST/codegen pass
+- read-only analysis is much easier to cache safely
+- source-location helpers and usage lookup should not depend on whether a module
+  was rewritten
+
+The intended flow is:
+
+1. build or reuse `ImportAnalysis`
+2. inspect/import-locate/trace as needed
+3. if a denied-specifier rewrite is needed, run `rewriteDeniedImports()`
+
+## Adapter Contract
+
+The shared layer deliberately does not decide:
+
+- when a violation is discovered
+- when it is reported versus deferred
+- how dev/build lifecycle hooks work
+- how virtual module ids/files are transported by the bundler
+- how final compilation truth is obtained
+
+Those are adapter responsibilities.
+
+The shared layer does provide the primitives both adapters rely on:
+
+- rule helpers
+- AST parsing
+- analysis
+- rewrite
+- virtual module code generation
+- source locations/snippets
+- trace formatting
+
+## Maintainer Guidance
+
+When making future import-protection changes:
+
+1. If the behavior is about parsing, source extraction, export discovery, usage
+   lookup, source locations, rewrite mechanics, or mock codegen, it probably
+   belongs in `src/import-protection/`.
+2. If the behavior is about hook timing, deferral, compilation truth, pending
+   queues, or environment-specific virtual-module transport, it probably belongs
+   in the adapter docs/code.
+3. Prefer extending `ImportAnalysis` over adding new one-off parsers or wrapper
+   helpers.
+4. Avoid reintroducing global source-text caches; cache on `TransformResult`
+   instead.