@tanstack/start-plugin-core 1.167.35 → 1.169.0

package/dist/esm/rsbuild/virtual-modules.js

@@ -0,0 +1,287 @@
+import { generateServerFnResolverModule } from "../start-compiler/server-fn-resolver-module.js";
+import { buildStartManifest } from "../start-manifest-plugin/manifestBuilder.js";
+import { generateSerializationAdaptersModule } from "../serialization-adapters-module.js";
+import { RSBUILD_ENVIRONMENT_NAMES } from "./planning.js";
+import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
+//#region src/rsbuild/virtual-modules.ts
+var RSC_RUNTIME_VIRTUAL_ID = "virtual:tanstack-rsc-runtime";
+var RSC_HMR_VIRTUAL_ID = "virtual:tanstack-rsc-hmr";
+var RSC_BROWSER_DECODE_VIRTUAL_ID = "virtual:tanstack-rsc-browser-decode";
+var RSC_SSR_DECODE_VIRTUAL_ID = "virtual:tanstack-rsc-ssr-decode";
+var START_MANIFEST_PLACEHOLDER = "__TSS_START_MANIFEST_PLACEHOLDER__";
+var DEV_START_MANIFEST_GLOBAL = "__TSS_DEV_START_MANIFEST__";
+/**
+* VirtualModulesPlugin resolves module paths relative to compiler.context.
+* Prefix them under the app root so they are unique and watcher-friendly.
+*/
+function virtualPath(root, moduleId) {
+	return `${root}/node_modules/.virtual/${moduleId.replace(/[:#]/g, "_")}.js`;
+}
+function generateManifestModuleDev(devClientEntryUrl) {
+	return `const fallbackManifest = {
+  routes: {},
+  clientEntry: '${devClientEntryUrl}',
+}
+export const tsrStartManifest = () => globalThis[${JSON.stringify(DEV_START_MANIFEST_GLOBAL)}] ?? fallbackManifest`;
+}
+function buildStartManifestData(clientBuild, publicBase) {
+	const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST;
+	return buildStartManifest({
+		clientBuild,
+		routeTreeRoutes,
+		basePath: publicBase
+	});
+}
+function serializeStartManifestData(clientBuild, publicBase) {
+	return JSON.stringify(buildStartManifestData(clientBuild, publicBase));
+}
+function generateManifestModuleBuild(clientBuild, publicBase, _devClientEntryUrl) {
+	if (!clientBuild) return `const tsrStartManifestData = ${JSON.stringify(START_MANIFEST_PLACEHOLDER)}
+export const tsrStartManifest = () => tsrStartManifestData`;
+	return `export const tsrStartManifest = () => (${serializeStartManifestData(clientBuild, publicBase)})`;
+}
+function generateInjectedHeadScripts(scripts) {
+	return `export const injectedHeadScripts = ${scripts ? JSON.stringify(scripts) : "undefined"}`;
+}
+/**
+* Generate virtual:tanstack-rsc-runtime content.
+* In the RSC layer this re-exports from react-server-dom-rspack/server.
+* In other layers it provides stubs that throw.
+*/
+function generateRscRuntimeModule(isRscLayer) {
+	if (isRscLayer) return `export { renderToReadableStream, createTemporaryReferenceSet, decodeReply, decodeAction, decodeFormState } from 'react-server-dom-rspack/server'
+export function createFromReadableStream() { throw new Error('createFromReadableStream is not available in RSC environment (use SSR or browser decode instead)'); }
+// loadServerAction is provided by the RSC entry, not react-server-dom-rspack
+import { getServerFnById } from '#tanstack-start-server-fn-resolver'
+export const loadServerAction = async (id) => getServerFnById(id, { origin: 'server' })`;
+	return `
+export function renderToReadableStream() { throw new Error('renderToReadableStream can only be used in RSC environment'); }
+export function createFromReadableStream() { throw new Error('createFromReadableStream can only be used in RSC environment'); }
+export function createTemporaryReferenceSet() { throw new Error('createTemporaryReferenceSet can only be used in RSC environment'); }
+export function decodeReply() { throw new Error('decodeReply can only be used in RSC environment'); }
+export function loadServerAction() { throw new Error('loadServerAction can only be used in RSC environment'); }
+export function decodeAction() { throw new Error('decodeAction can only be used in RSC environment'); }
+export function decodeFormState() { throw new Error('decodeFormState can only be used in RSC environment'); }
+`;
+}
+/**
+* Generate virtual:tanstack-rsc-hmr content.
+* In the client env during dev, listens for rsc:update WebSocket events
+* and invalidates the router. In all other contexts, exports nothing.
+*/
+function generateRscHmrModule(isClientEnv, isDev) {
+	if (!isClientEnv || !isDev) return "export function setupRscHmr() {}";
+	return `
+// RSC HMR listener for rsbuild dev server
+// Listens for 'rsc:update' custom events sent via sockWrite
+export function setupRscHmr() {
+  let __invalidateQueued = false
+
+  function __queueInvalidate() {
+    if (__invalidateQueued) return
+    __invalidateQueued = true
+    queueMicrotask(async () => {
+      __invalidateQueued = false
+      try {
+        const router = window.__TSR_ROUTER__
+        if (!router) {
+          console.warn('[rsc:hmr] No router found on window.__TSR_ROUTER__')
+          return
+        }
+        await router.invalidate()
+      } catch (e) {
+        console.warn('[rsc:hmr] Failed to invalidate router:', e)
+      }
+    })
+  }
+
+  if (import.meta.webpackHot) {
+    import.meta.webpackHot.on('rsc:update', () => {
+      __queueInvalidate()
+    })
+  }
+}
+`;
+}
+/**
+* Registers virtual modules for the rsbuild adapter using VirtualModulesPlugin.
+*
+* Creates one VirtualModulesPlugin per environment and registers them via
+* `modifyBundlerChain`. Provides update functions to refresh content dynamically.
+*/
+function registerVirtualModules(api, opts) {
+	const isDev = api.context.action === "dev";
+	const root = opts.root;
+	const paths = {
+		manifest: virtualPath(root, VIRTUAL_MODULES.startManifest),
+		injectedHeadScripts: virtualPath(root, VIRTUAL_MODULES.injectedHeadScripts),
+		serverFnResolver: virtualPath(root, VIRTUAL_MODULES.serverFnResolver),
+		pluginAdapters: virtualPath(root, VIRTUAL_MODULES.pluginAdapters)
+	};
+	const rscPaths = opts.rscEnabled ? {
+		rscRuntime: virtualPath(root, RSC_RUNTIME_VIRTUAL_ID),
+		rscHmr: virtualPath(root, RSC_HMR_VIRTUAL_ID),
+		rscBrowserDecode: virtualPath(root, RSC_BROWSER_DECODE_VIRTUAL_ID),
+		rscSsrDecode: virtualPath(root, RSC_SSR_DECODE_VIRTUAL_ID)
+	} : null;
+	const vmPlugins = {};
+	const readyVmPlugins = {};
+	const pendingWrites = /* @__PURE__ */ new Map();
+	let clientBuild;
+	const lastResolverContentByEnvironment = {};
+	const hasSeparateProviderEnvironment = !opts.rscEnabled && opts.providerEnvName !== RSBUILD_ENVIRONMENT_NAMES.server;
+	function isProviderEnvironment(environmentName) {
+		return environmentName === opts.providerEnvName;
+	}
+	function needsServerFnResolver(environmentName) {
+		return environmentName === RSBUILD_ENVIRONMENT_NAMES.server || hasSeparateProviderEnvironment && isProviderEnvironment(environmentName);
+	}
+	function generateResolverContent(environmentName) {
+		return generateServerFnResolverModule({
+			serverFnsById: opts.serverFnsById,
+			includeClientReferencedCheck: !isProviderEnvironment(environmentName),
+			useStaticImports: Boolean(opts.rscEnabled && isDev)
+		});
+	}
+	function writeResolverContent(environmentName, content) {
+		if (!isDev || content !== lastResolverContentByEnvironment[environmentName]) {
+			lastResolverContentByEnvironment[environmentName] = content;
+			tryWriteModule(environmentName, paths.serverFnResolver, content);
+		}
+	}
+	function queuePendingWrite(environmentName, filePath, content) {
+		let writes = pendingWrites.get(environmentName);
+		if (!writes) {
+			writes = /* @__PURE__ */ new Map();
+			pendingWrites.set(environmentName, writes);
+		}
+		writes.set(filePath, content);
+	}
+	function tryWriteModule(environmentName, filePath, content) {
+		const vmPlugin = vmPlugins[environmentName];
+		if (!vmPlugin || !readyVmPlugins[environmentName]) {
+			queuePendingWrite(environmentName, filePath, content);
+			return false;
+		}
+		vmPlugin.writeModule(filePath, content);
+		return true;
+	}
+	function flushPendingWrites(environmentName) {
+		if (!readyVmPlugins[environmentName]) return;
+		const writes = pendingWrites.get(environmentName);
+		if (!writes?.size) return;
+		for (const [filePath, content] of writes) {
+			if (!tryWriteModule(environmentName, filePath, content)) return;
+			writes.delete(filePath);
+		}
+		if (writes.size === 0) pendingWrites.delete(environmentName);
+	}
+	function getInitialContent(environmentName) {
+		const { resolvedStartConfig } = opts.getConfig();
+		const isServerEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.server;
+		const isClientEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.client;
+		const content = {};
+		if (isServerEnv) {
+			const devClientEntryUrl = opts.getDevClientEntryUrl(resolvedStartConfig.basePaths.publicBase);
+			content[paths.manifest] = isDev ? generateManifestModuleDev(devClientEntryUrl) : generateManifestModuleBuild(clientBuild, resolvedStartConfig.basePaths.publicBase, devClientEntryUrl);
+		} else content[paths.manifest] = "export default {}";
+		content[paths.injectedHeadScripts] = generateInjectedHeadScripts();
+		if (needsServerFnResolver(environmentName)) content[paths.serverFnResolver] = generateResolverContent(environmentName);
+		else content[paths.serverFnResolver] = "export {}";
+		content[paths.pluginAdapters] = generateSerializationAdaptersModule({
+			adapters: opts.serializationAdapters,
+			runtime: environmentName === RSBUILD_ENVIRONMENT_NAMES.client ? "client" : "server"
+		});
+		if (rscPaths) {
+			if (isServerEnv) content[rscPaths.rscRuntime] = generateRscRuntimeModule(true);
+			else content[rscPaths.rscRuntime] = generateRscRuntimeModule(false);
+			content[rscPaths.rscHmr] = generateRscHmrModule(isClientEnv, isDev);
+			content[rscPaths.rscBrowserDecode] = isClientEnv ? `export * from '@tanstack/react-start/rsbuild/browser-decode'` : `export function createFromReadableStream() { throw new Error('RSC browser decode is only available in the client environment') }
+export function createFromFetch() { throw new Error('RSC browser decode is only available in the client environment') }`;
+			content[rscPaths.rscSsrDecode] = isServerEnv ? `export * from '@tanstack/react-start/rsbuild/ssr-decode'` : `export function setOnClientReference() {}
+export function createFromReadableStream() { throw new Error('RSC SSR decode is only available in the server environment') }`;
+		}
+		return content;
+	}
+	const aliasMap = {
+		[VIRTUAL_MODULES.startManifest]: paths.manifest,
+		[VIRTUAL_MODULES.injectedHeadScripts]: paths.injectedHeadScripts,
+		[VIRTUAL_MODULES.serverFnResolver]: paths.serverFnResolver,
+		[VIRTUAL_MODULES.pluginAdapters]: paths.pluginAdapters
+	};
+	if (rscPaths) {
+		aliasMap[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime;
+		aliasMap[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr;
+		aliasMap[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode;
+		aliasMap[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode;
+	}
+	api.modifyRspackConfig((config, utils) => {
+		const envName = utils.environment.name;
+		const initialContent = getInitialContent(envName);
+		const VMP = utils.rspack.experiments.VirtualModulesPlugin;
+		const vmPlugin = new VMP(initialContent);
+		vmPlugins[envName] = vmPlugin;
+		readyVmPlugins[envName] = false;
+		config.plugins.push(vmPlugin);
+		config.plugins.push({ apply(compiler) {
+			compiler.hooks.thisCompilation.tap("TanStackStartFlushPendingVirtualModules", () => {
+				readyVmPlugins[envName] = true;
+				flushPendingWrites(envName);
+			});
+		} });
+		for (const [moduleId, virtualFilePath] of Object.entries(aliasMap)) {
+			const escaped = moduleId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+			const NMR = utils.rspack.NormalModuleReplacementPlugin;
+			config.plugins.push(new NMR(new RegExp(`^${escaped}$`), virtualFilePath));
+		}
+		const resolve = config.resolve;
+		const resolveAlias = resolve.alias ??= {};
+		resolveAlias[VIRTUAL_MODULES.serverFnResolver] = paths.serverFnResolver;
+		resolveAlias[VIRTUAL_MODULES.pluginAdapters] = paths.pluginAdapters;
+		if (rscPaths) {
+			resolveAlias[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime;
+			resolveAlias[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr;
+			resolveAlias[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode;
+			resolveAlias[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode;
+		}
+	});
+	return {
+		serverFnResolverPath: paths.serverFnResolver,
+		manifestPath: paths.manifest,
+		vmPlugins,
+		generateCurrentResolverContent(forProvider) {
+			return generateResolverContent(forProvider ? opts.providerEnvName : RSBUILD_ENVIRONMENT_NAMES.server);
+		},
+		generateManifestContent(newClientBuild) {
+			const { resolvedStartConfig } = opts.getConfig();
+			const devClientEntryUrl = opts.getDevClientEntryUrl(resolvedStartConfig.basePaths.publicBase);
+			return generateManifestModuleBuild(newClientBuild, resolvedStartConfig.basePaths.publicBase, devClientEntryUrl);
+		},
+		generateManifestValueLiteral(newClientBuild) {
+			const { resolvedStartConfig } = opts.getConfig();
+			return serializeStartManifestData(newClientBuild, resolvedStartConfig.basePaths.publicBase);
+		},
+		updateManifest(newClientBuild) {
+			clientBuild = newClientBuild;
+			const { resolvedStartConfig } = opts.getConfig();
+			if (isDev) globalThis[DEV_START_MANIFEST_GLOBAL] = buildStartManifestData(clientBuild, resolvedStartConfig.basePaths.publicBase);
+		},
+		updateServerFnResolver() {
+			for (const environmentName of new Set([RSBUILD_ENVIRONMENT_NAMES.server, ...hasSeparateProviderEnvironment ? [opts.providerEnvName] : []])) {
+				if (!needsServerFnResolver(environmentName)) continue;
+				writeResolverContent(environmentName, generateResolverContent(environmentName));
+			}
+		},
+		tryUpdateServerFnResolver(content) {
+			lastResolverContentByEnvironment[RSBUILD_ENVIRONMENT_NAMES.server] = content;
+			tryWriteModule(RSBUILD_ENVIRONMENT_NAMES.server, paths.serverFnResolver, content);
+		},
+		getVirtualPath(moduleId) {
+			return virtualPath(root, moduleId);
+		}
+	};
+}
+//#endregion
+export { START_MANIFEST_PLACEHOLDER, registerVirtualModules };
+
+//# sourceMappingURL=virtual-modules.js.map

package/dist/esm/rsbuild/virtual-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-modules.js","names":[],"sources":["../../../src/rsbuild/virtual-modules.ts"],"sourcesContent":["import { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { generateSerializationAdaptersModule } from '../serialization-adapters-module'\nimport { generateServerFnResolverModule } from '../start-compiler/server-fn-resolver-module'\nimport { buildStartManifest } from '../start-manifest-plugin/manifestBuilder'\nimport { RSBUILD_ENVIRONMENT_NAMES } from './planning'\nimport type {\n  RsbuildPluginAPI,\n  rspack as rspackNamespaceType,\n} from '@rsbuild/core'\nimport type {\n  GetConfigFn,\n  NormalizedClientBuild,\n  SerializationAdapterConfig,\n} from '../types'\nimport type { ServerFn } from '../start-compiler/types'\n\ntype RspackNamespace = typeof rspackNamespaceType\ntype RspackVirtualModulesPlugin = InstanceType<\n  RspackNamespace['experiments']['VirtualModulesPlugin']\n>\n\n// Virtual module IDs for RSC (must match what react-start-rsc imports)\nconst RSC_RUNTIME_VIRTUAL_ID = 'virtual:tanstack-rsc-runtime'\nconst RSC_HMR_VIRTUAL_ID = 'virtual:tanstack-rsc-hmr'\nconst RSC_BROWSER_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-browser-decode'\nconst RSC_SSR_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-ssr-decode'\nexport const START_MANIFEST_PLACEHOLDER = '__TSS_START_MANIFEST_PLACEHOLDER__'\nconst DEV_START_MANIFEST_GLOBAL = '__TSS_DEV_START_MANIFEST__'\n/**\n * VirtualModulesPlugin resolves module paths relative to compiler.context.\n * Prefix them under the app root so they are unique and watcher-friendly.\n */\nfunction virtualPath(root: string, moduleId: string): string {\n  // VirtualModulesPlugin resolves paths relative to compiler.context (root).\n  // Use a recognizable prefix to avoid collisions with real files.\n  const sanitized = moduleId.replace(/[:#]/g, '_')\n  return `${root}/node_modules/.virtual/${sanitized}.js`\n}\n\nexport interface VirtualModuleState {\n  /** Call to update manifest content after client build completes */\n  updateManifest: (clientBuild: NormalizedClientBuild) => void\n  /** Call to update server fn resolver content after compilation discovers fns */\n  updateServerFnResolver: () => void\n  /** Try to write explicit resolver content now; queues if env not ready */\n  tryUpdateServerFnResolver: (content: string) => void\n  /** Get the virtual path for a given module ID */\n  getVirtualPath: (moduleId: string) => string\n  /** Generate resolver module content from current serverFnsById state.\n   *  When forProvider=true, generates without isClientReferenced checks (RSC layer). */\n  generateCurrentResolverContent: (forProvider?: boolean) => string\n  /** The absolute virtual path of the server fn resolver module */\n  serverFnResolverPath: string\n  /** The absolute virtual path of the manifest module */\n  manifestPath: string\n  /** Generate manifest module content from a given client build */\n  generateManifestContent: (clientBuild: NormalizedClientBuild) => string\n  /** Generate the serialized manifest value literal for asset patching */\n  generateManifestValueLiteral: (clientBuild: NormalizedClientBuild) => string\n  /** VirtualModulesPlugin instances keyed by environment name */\n  vmPlugins: Record<string, RspackVirtualModulesPlugin>\n}\n\n// ---------------------------------------------------------------------------\n// Manifest module codegen\n// ---------------------------------------------------------------------------\n\nfunction generateManifestModuleDev(devClientEntryUrl: string): string {\n  return `const fallbackManifest = {\n  routes: {},\n  clientEntry: '${devClientEntryUrl}',\n}\nexport const tsrStartManifest = () => globalThis[${JSON.stringify(DEV_START_MANIFEST_GLOBAL)}] ?? fallbackManifest`\n}\n\nfunction buildStartManifestData(\n  clientBuild: NormalizedClientBuild,\n  publicBase: string,\n) {\n  const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n  return buildStartManifest({\n    clientBuild,\n    routeTreeRoutes,\n    basePath: publicBase,\n  })\n}\n\nfunction serializeStartManifestData(\n  clientBuild: NormalizedClientBuild,\n  publicBase: string,\n): string {\n  return JSON.stringify(buildStartManifestData(clientBuild, publicBase))\n}\n\nfunction generateManifestModuleBuild(\n  clientBuild: NormalizedClientBuild | undefined,\n  publicBase: string,\n  _devClientEntryUrl: string,\n): string {\n  if (!clientBuild) {\n    return `const tsrStartManifestData = ${JSON.stringify(START_MANIFEST_PLACEHOLDER)}\nexport const tsrStartManifest = () => tsrStartManifestData`\n  }\n\n  return `export const tsrStartManifest = () => (${serializeStartManifestData(clientBuild, publicBase)})`\n}\n\n// ---------------------------------------------------------------------------\n// Injected head scripts codegen\n// ---------------------------------------------------------------------------\n\nfunction generateInjectedHeadScripts(scripts?: string): string {\n  return `export const injectedHeadScripts = ${scripts ? JSON.stringify(scripts) : 'undefined'}`\n}\n\n// ---------------------------------------------------------------------------\n// RSC virtual module codegen\n// ---------------------------------------------------------------------------\n\n/**\n * Generate virtual:tanstack-rsc-runtime content.\n * In the RSC layer this re-exports from react-server-dom-rspack/server.\n * In other layers it provides stubs that throw.\n */\nfunction generateRscRuntimeModule(isRscLayer: boolean): string {\n  if (isRscLayer) {\n    // Re-export the RSC runtime functions from react-server-dom-rspack/server.\n    // NOTE: `createFromReadableStream` is a CLIENT-side API — it's NOT exported\n    // by react-server-dom-rspack/server. The RSC layer never needs it (RSC\n    // renders TO streams, doesn't decode FROM them). We provide a stub that\n    // throws so the export surface stays consistent across bundlers.\n    return `export { renderToReadableStream, createTemporaryReferenceSet, decodeReply, decodeAction, decodeFormState } from 'react-server-dom-rspack/server'\nexport function createFromReadableStream() { throw new Error('createFromReadableStream is not available in RSC environment (use SSR or browser decode instead)'); }\n// loadServerAction is provided by the RSC entry, not react-server-dom-rspack\nimport { getServerFnById } from '#tanstack-start-server-fn-resolver'\nexport const loadServerAction = async (id) => getServerFnById(id, { origin: 'server' })`\n  }\n\n  // In other layers, provide stubs that throw\n  return `\nexport function renderToReadableStream() { throw new Error('renderToReadableStream can only be used in RSC environment'); }\nexport function createFromReadableStream() { throw new Error('createFromReadableStream can only be used in RSC environment'); }\nexport function createTemporaryReferenceSet() { throw new Error('createTemporaryReferenceSet can only be used in RSC environment'); }\nexport function decodeReply() { throw new Error('decodeReply can only be used in RSC environment'); }\nexport function loadServerAction() { throw new Error('loadServerAction can only be used in RSC environment'); }\nexport function decodeAction() { throw new Error('decodeAction can only be used in RSC environment'); }\nexport function decodeFormState() { throw new Error('decodeFormState can only be used in RSC environment'); }\n`\n}\n\n/**\n * Generate virtual:tanstack-rsc-hmr content.\n * In the client env during dev, listens for rsc:update WebSocket events\n * and invalidates the router. In all other contexts, exports nothing.\n */\nfunction generateRscHmrModule(isClientEnv: boolean, isDev: boolean): string {\n  if (!isClientEnv || !isDev) {\n    return 'export function setupRscHmr() {}'\n  }\n\n  // Rsbuild dev server delivers custom WebSocket events through\n  // import.meta.webpackHot.on(event, cb). The server-side\n  // sockWrite('custom', { event: 'rsc:update' }) maps directly to that.\n  return `\n// RSC HMR listener for rsbuild dev server\n// Listens for 'rsc:update' custom events sent via sockWrite\nexport function setupRscHmr() {\n  let __invalidateQueued = false\n\n  function __queueInvalidate() {\n    if (__invalidateQueued) return\n    __invalidateQueued = true\n    queueMicrotask(async () => {\n      __invalidateQueued = false\n      try {\n        const router = window.__TSR_ROUTER__\n        if (!router) {\n          console.warn('[rsc:hmr] No router found on window.__TSR_ROUTER__')\n          return\n        }\n        await router.invalidate()\n      } catch (e) {\n        console.warn('[rsc:hmr] Failed to invalidate router:', e)\n      }\n    })\n  }\n\n  if (import.meta.webpackHot) {\n    import.meta.webpackHot.on('rsc:update', () => {\n      __queueInvalidate()\n    })\n  }\n}\n`\n}\n\n// ---------------------------------------------------------------------------\n// Main registration\n// ---------------------------------------------------------------------------\n\nexport interface RegisterVirtualModulesOptions {\n  root: string\n  getConfig: GetConfigFn\n  serverFnsById: Record<string, ServerFn>\n  providerEnvName: string\n  ssrIsProvider: boolean\n  serializationAdapters: Array<SerializationAdapterConfig> | undefined\n  /**\n   * Get the URL at which the rsbuild dev server serves the client entry JS.\n   * Called lazily inside modifyRspackConfig when getConfig() is available.\n   * Example return: '/static/js/index.js'\n   */\n  getDevClientEntryUrl: (publicBase: string) => string\n  /** Whether RSC virtual modules should be registered. */\n  rscEnabled?: boolean | undefined\n}\n\n/**\n * Registers virtual modules for the rsbuild adapter using VirtualModulesPlugin.\n *\n * Creates one VirtualModulesPlugin per environment and registers them via\n * `modifyBundlerChain`. Provides update functions to refresh content dynamically.\n */\nexport function registerVirtualModules(\n  api: RsbuildPluginAPI,\n  opts: RegisterVirtualModulesOptions,\n): VirtualModuleState {\n  const isDev = api.context.action === 'dev'\n  const root = opts.root\n\n  // Virtual module paths keyed by module ID\n  const paths = {\n    manifest: virtualPath(root, VIRTUAL_MODULES.startManifest),\n    injectedHeadScripts: virtualPath(root, VIRTUAL_MODULES.injectedHeadScripts),\n    serverFnResolver: virtualPath(root, VIRTUAL_MODULES.serverFnResolver),\n    pluginAdapters: virtualPath(root, VIRTUAL_MODULES.pluginAdapters),\n  }\n\n  // RSC virtual module paths (only defined when RSC is enabled)\n  const rscPaths = opts.rscEnabled\n    ? {\n        rscRuntime: virtualPath(root, RSC_RUNTIME_VIRTUAL_ID),\n        rscHmr: virtualPath(root, RSC_HMR_VIRTUAL_ID),\n        rscBrowserDecode: virtualPath(root, RSC_BROWSER_DECODE_VIRTUAL_ID),\n        rscSsrDecode: virtualPath(root, RSC_SSR_DECODE_VIRTUAL_ID),\n      }\n    : null\n\n  // Track VirtualModulesPlugin instances per environment for dynamic updates\n  const vmPlugins: Record<string, RspackVirtualModulesPlugin> = {}\n  const readyVmPlugins: Record<string, boolean> = {}\n  const pendingWrites = new Map<string, Map<string, string>>()\n\n  let clientBuild: NormalizedClientBuild | undefined\n  const lastResolverContentByEnvironment: Record<string, string | undefined> =\n    {}\n  const hasSeparateProviderEnvironment =\n    !opts.rscEnabled &&\n    opts.providerEnvName !== RSBUILD_ENVIRONMENT_NAMES.server\n\n  function isProviderEnvironment(environmentName: string): boolean {\n    return environmentName === opts.providerEnvName\n  }\n\n  function needsServerFnResolver(environmentName: string): boolean {\n    return (\n      environmentName === RSBUILD_ENVIRONMENT_NAMES.server ||\n      (hasSeparateProviderEnvironment && isProviderEnvironment(environmentName))\n    )\n  }\n\n  function generateResolverContent(environmentName: string): string {\n    return generateServerFnResolverModule({\n      serverFnsById: opts.serverFnsById,\n      includeClientReferencedCheck: !isProviderEnvironment(environmentName),\n      useStaticImports: Boolean(opts.rscEnabled && isDev),\n    })\n  }\n\n  function writeResolverContent(environmentName: string, content: string) {\n    if (\n      !isDev ||\n      content !== lastResolverContentByEnvironment[environmentName]\n    ) {\n      lastResolverContentByEnvironment[environmentName] = content\n      tryWriteModule(environmentName, paths.serverFnResolver, content)\n    }\n  }\n\n  function queuePendingWrite(\n    environmentName: string,\n    filePath: string,\n    content: string,\n  ) {\n    let writes = pendingWrites.get(environmentName)\n    if (!writes) {\n      writes = new Map()\n      pendingWrites.set(environmentName, writes)\n    }\n    writes.set(filePath, content)\n  }\n\n  function tryWriteModule(\n    environmentName: string,\n    filePath: string,\n    content: string,\n  ) {\n    const vmPlugin = vmPlugins[environmentName]\n    if (!vmPlugin || !readyVmPlugins[environmentName]) {\n      queuePendingWrite(environmentName, filePath, content)\n      return false\n    }\n\n    vmPlugin.writeModule(filePath, content)\n    return true\n  }\n\n  function flushPendingWrites(environmentName: string) {\n    if (!readyVmPlugins[environmentName]) {\n      return\n    }\n\n    const writes = pendingWrites.get(environmentName)\n    if (!writes?.size) {\n      return\n    }\n\n    for (const [filePath, content] of writes) {\n      if (!tryWriteModule(environmentName, filePath, content)) {\n        return\n      }\n      writes.delete(filePath)\n    }\n\n    if (writes.size === 0) {\n      pendingWrites.delete(environmentName)\n    }\n  }\n\n  // NOTE: getConfig() is deferred — it must NOT be called until modifyRsbuildConfig\n  // has resolved (which sets resolvedStartConfig.root). All access to resolvedStartConfig\n  // happens inside modifyRspackConfig (which runs after modifyRsbuildConfig) or\n  // inside update callbacks (which run even later during/after compilation).\n\n  // Generate initial content for each virtual module per environment\n  function getInitialContent(environmentName: string): Record<string, string> {\n    // Safe to call getConfig() here — this runs inside modifyRspackConfig\n    const { resolvedStartConfig } = opts.getConfig()\n    const isServerEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.server\n    const isClientEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.client\n    const content: Record<string, string> = {}\n\n    // Manifest — only meaningful for server env\n    if (isServerEnv) {\n      const devClientEntryUrl = opts.getDevClientEntryUrl(\n        resolvedStartConfig.basePaths.publicBase,\n      )\n      content[paths.manifest] = isDev\n        ? generateManifestModuleDev(devClientEntryUrl)\n        : generateManifestModuleBuild(\n            clientBuild,\n            resolvedStartConfig.basePaths.publicBase,\n            devClientEntryUrl,\n          )\n    } else {\n      content[paths.manifest] = 'export default {}'\n    }\n\n    // Injected head scripts — only server\n    content[paths.injectedHeadScripts] = generateInjectedHeadScripts()\n\n    // Server fn resolver — SSR and provider environments\n    if (needsServerFnResolver(environmentName)) {\n      content[paths.serverFnResolver] = generateResolverContent(environmentName)\n    } else {\n      // Client doesn't need the resolver but needs a valid module\n      content[paths.serverFnResolver] = 'export {}'\n    }\n\n    // Plugin adapters — both environments get environment-specific content\n    content[paths.pluginAdapters] = generateSerializationAdaptersModule({\n      adapters: opts.serializationAdapters,\n      runtime:\n        environmentName === RSBUILD_ENVIRONMENT_NAMES.client\n          ? 'client'\n          : 'server',\n    })\n\n    // --- RSC virtual modules ---\n    if (rscPaths) {\n      // virtual:tanstack-rsc-runtime\n      // In the server env, this provides the RSC runtime for the RSC layer.\n      // The virtual module content is the same regardless of layer since\n      // rspack layers handle module isolation. The RSC entry imports this\n      // and the react-server condition on the RSC layer resolves\n      // react-server-dom-rspack/server correctly.\n      if (isServerEnv) {\n        // Server env gets the real RSC runtime (used by RSC layer)\n        content[rscPaths.rscRuntime] = generateRscRuntimeModule(true)\n      } else {\n        // Client env gets stubs\n        content[rscPaths.rscRuntime] = generateRscRuntimeModule(false)\n      }\n\n      // virtual:tanstack-rsc-hmr\n      content[rscPaths.rscHmr] = generateRscHmrModule(isClientEnv, isDev)\n      content[rscPaths.rscBrowserDecode] = isClientEnv\n        ? `export * from '@tanstack/react-start/rsbuild/browser-decode'`\n        : `export function createFromReadableStream() { throw new Error('RSC browser decode is only available in the client environment') }\nexport function createFromFetch() { throw new Error('RSC browser decode is only available in the client environment') }`\n      content[rscPaths.rscSsrDecode] = isServerEnv\n        ? `export * from '@tanstack/react-start/rsbuild/ssr-decode'`\n        : `export function setOnClientReference() {}\nexport function createFromReadableStream() { throw new Error('RSC SSR decode is only available in the server environment') }`\n    }\n\n    return content\n  }\n\n  // Build a map from virtual module IDs to their virtual file paths.\n  // Scheme-like IDs are rewritten with NormalModuleReplacementPlugin because\n  // rspack validates request schemes before normal alias resolution.\n  const aliasMap: Record<string, string> = {\n    [VIRTUAL_MODULES.startManifest]: paths.manifest,\n    [VIRTUAL_MODULES.injectedHeadScripts]: paths.injectedHeadScripts,\n    [VIRTUAL_MODULES.serverFnResolver]: paths.serverFnResolver,\n    [VIRTUAL_MODULES.pluginAdapters]: paths.pluginAdapters,\n  }\n\n  // Add RSC virtual module aliases\n  if (rscPaths) {\n    aliasMap[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime\n    aliasMap[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr\n    aliasMap[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode\n    aliasMap[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode\n  }\n\n  // Register VirtualModulesPlugin per environment via modifyRspackConfig\n  api.modifyRspackConfig((config, utils) => {\n    const envName = utils.environment.name\n    const initialContent = getInitialContent(envName)\n\n    // Create VirtualModulesPlugin instance\n    const VMP = utils.rspack.experiments.VirtualModulesPlugin\n    const vmPlugin = new VMP(initialContent)\n    vmPlugins[envName] = vmPlugin\n    readyVmPlugins[envName] = false\n    config.plugins.push(vmPlugin)\n    config.plugins.push({\n      apply(compiler: {\n        hooks: {\n          thisCompilation: { tap: (name: string, handler: () => void) => void }\n        }\n      }) {\n        compiler.hooks.thisCompilation.tap(\n          'TanStackStartFlushPendingVirtualModules',\n          () => {\n            readyVmPlugins[envName] = true\n            flushPendingWrites(envName)\n          },\n        )\n      },\n    })\n\n    // Rewrite scheme-like IDs to the VirtualModulesPlugin-backed file paths.\n    for (const [moduleId, virtualFilePath] of Object.entries(aliasMap)) {\n      const escaped = moduleId.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n      const NMR = utils.rspack.NormalModuleReplacementPlugin\n      config.plugins.push(new NMR(new RegExp(`^${escaped}$`), virtualFilePath))\n    }\n\n    const resolve = config.resolve\n    const resolveAlias = (resolve.alias ??= {}) as Record<string, string>\n    resolveAlias[VIRTUAL_MODULES.serverFnResolver] = paths.serverFnResolver\n    resolveAlias[VIRTUAL_MODULES.pluginAdapters] = paths.pluginAdapters\n\n    // Add RSC-specific resolve aliases\n    if (rscPaths) {\n      resolveAlias[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime\n      resolveAlias[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr\n      resolveAlias[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode\n      resolveAlias[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode\n    }\n  })\n\n  return {\n    serverFnResolverPath: paths.serverFnResolver,\n    manifestPath: paths.manifest,\n    vmPlugins,\n\n    generateCurrentResolverContent(forProvider?: boolean): string {\n      return generateResolverContent(\n        forProvider ? opts.providerEnvName : RSBUILD_ENVIRONMENT_NAMES.server,\n      )\n    },\n\n    generateManifestContent(newClientBuild: NormalizedClientBuild): string {\n      const { resolvedStartConfig } = opts.getConfig()\n      const devClientEntryUrl = opts.getDevClientEntryUrl(\n        resolvedStartConfig.basePaths.publicBase,\n      )\n      return generateManifestModuleBuild(\n        newClientBuild,\n        resolvedStartConfig.basePaths.publicBase,\n        devClientEntryUrl,\n      )\n    },\n\n    generateManifestValueLiteral(\n      newClientBuild: NormalizedClientBuild,\n    ): string {\n      const { resolvedStartConfig } = opts.getConfig()\n      return serializeStartManifestData(\n        newClientBuild,\n        resolvedStartConfig.basePaths.publicBase,\n      )\n    },\n\n    updateManifest(newClientBuild: NormalizedClientBuild) {\n      clientBuild = newClientBuild\n      // Safe to call getConfig() here — runs after client build\n      const { resolvedStartConfig } = opts.getConfig()\n      if (isDev) {\n        ;(\n          globalThis as typeof globalThis & {\n            [DEV_START_MANIFEST_GLOBAL]?: ReturnType<typeof buildStartManifest>\n          }\n        )[DEV_START_MANIFEST_GLOBAL] = buildStartManifestData(\n          clientBuild,\n          resolvedStartConfig.basePaths.publicBase,\n        )\n      }\n    },\n\n    updateServerFnResolver() {\n      for (const environmentName of new Set([\n        RSBUILD_ENVIRONMENT_NAMES.server,\n        ...(hasSeparateProviderEnvironment ? [opts.providerEnvName] : []),\n      ])) {\n        if (!needsServerFnResolver(environmentName)) {\n          continue\n        }\n\n        writeResolverContent(\n          environmentName,\n          generateResolverContent(environmentName),\n        )\n      }\n    },\n\n    tryUpdateServerFnResolver(content: string) {\n      lastResolverContentByEnvironment[RSBUILD_ENVIRONMENT_NAMES.server] =\n        content\n      tryWriteModule(\n        RSBUILD_ENVIRONMENT_NAMES.server,\n        paths.serverFnResolver,\n        content,\n      )\n    },\n\n    getVirtualPath(moduleId: string): string {\n      return virtualPath(root, moduleId)\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/esm/schema.d.ts

@@ -142,12 +142,12 @@ export declare function parseStartConfig(opts: z.input<typeof tanstackStartOptio
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
         routeFilePrefix?: string | undefined;
@@ -1060,11 +1060,11 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         codeSplittingOptions: z.ZodOptional<z.ZodOptional<z.ZodType<import('@tanstack/router-plugin').CodeSplittingOptions, z.ZodTypeDef, import('@tanstack/router-plugin').CodeSplittingOptions>>>;
         plugin: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             hmr: z.ZodOptional<z.ZodObject<{
-                hotExpression: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<["vite", "webpack"]>>;
             }, "strip", z.ZodTypeAny, {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             }, {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             }>>;
             vite: z.ZodOptional<z.ZodObject<{
                 environmentName: z.ZodOptional<z.ZodString>;
@@ -1074,19 +1074,19 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
                 environmentName?: string | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
-        }, {
             hmr?: {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             } | undefined;
+        }, {
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -1125,12 +1125,12 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }, {
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -1169,12 +1169,12 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }>>>>>>;
     client: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -3420,12 +3420,12 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     };
     serverFns: {
@@ -3745,12 +3745,12 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }) | undefined;
     serverFns?: {
@@ -4094,11 +4094,11 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         codeSplittingOptions: z.ZodOptional<z.ZodOptional<z.ZodType<import('@tanstack/router-plugin').CodeSplittingOptions, z.ZodTypeDef, import('@tanstack/router-plugin').CodeSplittingOptions>>>;
         plugin: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             hmr: z.ZodOptional<z.ZodObject<{
-                hotExpression: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<["vite", "webpack"]>>;
             }, "strip", z.ZodTypeAny, {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             }, {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             }>>;
             vite: z.ZodOptional<z.ZodObject<{
                 environmentName: z.ZodOptional<z.ZodString>;
@@ -4108,19 +4108,19 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
                 environmentName?: string | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
-        }, {
             hmr?: {
-                hotExpression?: string | undefined;
+                style?: "vite" | "webpack" | undefined;
             } | undefined;
+        }, {
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -4159,12 +4159,12 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }, {
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -4203,12 +4203,12 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }>>>>>>;
     client: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -6454,12 +6454,12 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     };
     serverFns: {
@@ -6779,12 +6779,12 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         enableRouteGeneration?: boolean | undefined;
         codeSplittingOptions?: import('@tanstack/router-plugin').CodeSplittingOptions | undefined;
         plugin?: {
-            hmr?: {
-                hotExpression?: string | undefined;
-            } | undefined;
             vite?: {
                 environmentName?: string | undefined;
             } | undefined;
+            hmr?: {
+                style?: "vite" | "webpack" | undefined;
+            } | undefined;
         } | undefined;
     }) | undefined;
     serverFns?: {

package/dist/esm/start-compiler/compiler.d.ts

@@ -93,7 +93,6 @@ export declare class StartCompiler {
     private init;
     /**
      * Extracts bindings and exports from an already-parsed AST.
-     * This is the core logic shared by ingestModule and ingestModuleFromAst.
      */
     private extractModuleInfo;
     ingestModule({ code, id }: {
@@ -104,6 +103,7 @@ export declare class StartCompiler {
         ast: import('@tanstack/router-utils').ParseAstResult;
     };
     invalidateModule(id: string): boolean;
+    getTransitiveImporters(id: string): Promise<Set<string>>;
     compile({ code, id, detectedKinds, }: {
         code: string;
         id: string;