@module-federation/vite 1.15.2 → 1.15.3

package/lib/index.cjs

@@ -544,7 +544,7 @@ function normalizeShareItem(key, shareItem) {
 		shareConfig: {
 			import: shareItem.import,
 			singleton: shareItem.singleton || false,
-			requiredVersion: shareItem.requiredVersion || (version ? `^${version}` : "*"),
+			requiredVersion: shareItem.requiredVersion || (isImportFalse ? "*" : version ? `^${version}` : "*"),
 			strictVersion: !!shareItem.strictVersion
 		}
 	};
@@ -661,35 +661,6 @@ function normalizeModuleFederationOptions(options) {
 }
 //#endregion
 //#region src/utils/VirtualModule.ts
-/**
-* Initialize virtual module infrastructure BEFORE VirtualModule class is used.
-* This must be called in the config hook to ensure the directory exists
-* before Vite's optimization phase.
-*/
-function initVirtualModuleInfrastructure(root, virtualModuleDir = "__mf__virtual") {
-	const virtualPackagePath = (0, pathe.join)((0, pathe.join)(root, "node_modules"), virtualModuleDir);
-	(0, fs.mkdirSync)(virtualPackagePath, { recursive: true });
-	(0, fs.writeFileSync)((0, pathe.join)(virtualPackagePath, "empty.js"), "");
-	(0, fs.writeFileSync)((0, pathe.join)(virtualPackagePath, "package.json"), JSON.stringify({
-		name: virtualModuleDir,
-		main: "empty.js"
-	}));
-}
-let rootDir;
-function findNodeModulesDir(root = process.cwd()) {
-	let currentDir = root;
-	while (currentDir !== (0, pathe.parse)(currentDir).root) {
-		const nodeModulesPath = (0, pathe.join)(currentDir, "node_modules");
-		if ((0, fs.existsSync)(nodeModulesPath)) return nodeModulesPath;
-		currentDir = (0, pathe.dirname)(currentDir);
-	}
-	return "";
-}
-let cachedNodeModulesDir;
-function getNodeModulesDir() {
-	if (!cachedNodeModulesDir) cachedNodeModulesDir = findNodeModulesDir(rootDir);
-	return cachedNodeModulesDir;
-}
 function getSuffix(name) {
 	const base = (0, pathe.basename)(name);
 	const dotIndex = base.lastIndexOf(".");
@@ -698,9 +669,6 @@ function getSuffix(name) {
 }
 const patternMap = {};
 const cacheMap = {};
-/**
-* Physically generate files as virtual modules under node_modules/__mf__virtual/*
-*/
 function assertModuleFound(tag, str = "") {
 	const module = VirtualModule.findModule(tag, str);
 	if (!module) throw createModuleFederationError(`Module Federation shared module '${str}' not found. Please ensure it's installed as a dependency in your package.json.`);
@@ -711,33 +679,16 @@ var VirtualModule = class {
 	tag;
 	suffix;
 	inited = false;
-	/**
-	* Set the root path for finding node_modules
-	* @param root - Root path
-	*/
-	static setRoot(root) {
-		rootDir = root;
-		cachedNodeModulesDir = void 0;
-	}
-	/**
-	* Ensure virtual package directory exists
-	*/
-	static ensureVirtualPackageExists() {
-		const nodeModulesDir = getNodeModulesDir();
-		const { virtualModuleDir } = getNormalizeModuleFederationOptions();
-		const virtualPackagePath = (0, pathe.resolve)(nodeModulesDir, virtualModuleDir);
-		(0, fs.mkdirSync)(virtualPackagePath, { recursive: true });
-		(0, fs.writeFileSync)((0, pathe.resolve)(virtualPackagePath, "empty.js"), "");
-		(0, fs.writeFileSync)((0, pathe.resolve)(virtualPackagePath, "package.json"), JSON.stringify({
-			name: virtualModuleDir,
-			main: "empty.js"
-		}));
-	}
+	code;
 	static findModule(tag, str = "") {
 		if (!patternMap[tag]) patternMap[tag] = new RegExp(`(.*${packageNameEncode(tag)}(.+?)${packageNameEncode(tag)}.*)`);
 		const moduleName = (str.match(patternMap[tag]) || [])[2];
 		if (moduleName) return cacheMap[tag][packageNameDecode(moduleName)];
 	}
+	static findById(id) {
+		const normalized = id.replace(/^\0+/, "").replace(/^\/@id\//, "").replace(/^__x00__/, "").replace(/[?#].*$/, "");
+		for (const modules of Object.values(cacheMap)) for (const module of Object.values(modules)) if (module.getImportId() === normalized) return module;
+	}
 	constructor(name, tag = "__mf_v__", suffix = "") {
 		this.name = name;
 		this.tag = tag;
@@ -745,24 +696,20 @@ var VirtualModule = class {
 		if (!cacheMap[this.tag]) cacheMap[this.tag] = {};
 		cacheMap[this.tag][this.name] = this;
 	}
-	getPath() {
-		return (0, pathe.resolve)(getNodeModulesDir(), this.getImportId());
-	}
 	getImportId() {
-		const { internalName: mfName, virtualModuleDir } = getNormalizeModuleFederationOptions();
-		return `${virtualModuleDir}/${packageNameEncode(`${mfName}${this.tag}${this.name}${this.tag}`)}${this.suffix}`;
+		const { internalName: mfName } = getNormalizeModuleFederationOptions();
+		return `virtual:mf:${packageNameEncode(`${mfName}${this.tag}${this.name}${this.tag}`)}${this.suffix}`;
+	}
+	getResolvedId() {
+		return `\0${this.getImportId()}`;
 	}
 	writeSync(code, force) {
 		if (!force && this.inited) return;
 		if (!this.inited) this.inited = true;
-		const path = this.getPath();
-		(0, fs.mkdirSync)((0, pathe.dirname)(path), { recursive: true });
-		(0, fs.writeFileSync)(path, code);
+		this.code = code;
 	}
 	write(code) {
-		const path = this.getPath();
-		(0, fs.mkdirSync)((0, pathe.dirname)(path), { recursive: true });
-		(0, fs.writeFile)(path, code, function() {});
+		this.writeSync(code, true);
 	}
 };
 //#endregion
@@ -964,6 +911,14 @@ globalThis[__mfCacheGlobalKey].remote ||= {};
 const __mfModuleCache = globalThis[__mfCacheGlobalKey];
 `;
 }
+function getRuntimeInitPromiseBootstrapCode() {
+	return getRuntimeInitStateBootstrapCode({
+		globalKeyVar: "__mfPromiseGlobalKey",
+		stateVar: "__mfPromiseState",
+		exposedConst: "initPromise",
+		exposedProperty: "initPromise"
+	});
+}
 function getRuntimeInitResolveBootstrapCode() {
 	return getRuntimeInitStateBootstrapCode({
 		globalKeyVar: "__mfResolveGlobalKey",
@@ -1208,6 +1163,16 @@ function writePreBuildLibPath(pkg, shareItem) {
     export const jsx = __mfPrebuildExports.jsx;
     export const jsxs = __mfPrebuildExports.jsxs;
     export default __mfPrebuildExports;
+  `, true);
+		return;
+	}
+	const namedExports = getPackageNamedExports(pkg);
+	if (namedExports.length > 0) {
+		preBuildCacheMap[pkg].writeSync(`
+    import * as __mfPrebuildNamespace from ${escapeGeneratedStringLiteral(importSource)};
+    const __mfPrebuildExports = __mfPrebuildNamespace;
+    ${namedExports.map((name) => `export const ${name} = __mfPrebuildExports[${escapeGeneratedStringLiteral(name)}];`).join("\n    ")}
+    export default __mfPrebuildExports;
   `, true);
 		return;
 	}
@@ -1235,25 +1200,62 @@ function getLoadShareImportId(pkg, _isRolldown) {
 }
 function getLoadShareModulePath(pkg, isRolldown) {
 	if (!loadShareCacheMap[pkg]) getLoadShareImportId(pkg, isRolldown);
-	return loadShareCacheMap[pkg].getPath();
+	return loadShareCacheMap[pkg].getImportId();
 }
+function generateDeferredHostProvidedExports(namedExports, pkg) {
+	const namedExportVars = namedExports.map((_name, i) => `__mf_${i}`);
+	const declarations = ["let __mf_default;", ...namedExportVars.map((name) => `let ${name};`)].join("\n    ");
+	const assignments = [...namedExports.map((name, i) => `${namedExportVars[i]} = exportModule[${escapeGeneratedStringLiteral(name)}];`), "__mf_default = exportModule.default ?? exportModule;"].join("\n      ");
+	const namedExportLine = namedExports.length > 0 ? `\n    export { ${namedExports.map((name, i) => `${namedExportVars[i]} as ${name}`).join(", ")} };` : "";
+	return `${declarations}
+    const __mfApplyHostProvidedExports = (exportModule) => {
+      ${assignments}
+    };
+    let exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}];
+    if (exportModule === undefined) {
+      initPromise.then(() => {
+        exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}];
+        if (exportModule === undefined) {
+          throw new Error("[Module Federation] Shared module ${pkg} was imported before federation bootstrap finished.");
+        }
+        __mfApplyHostProvidedExports(exportModule);
+      });
+    } else {
+      __mfApplyHostProvidedExports(exportModule);
+    }
+    export { __mf_default as default };${namedExportLine}`;
+}
+function generateShareModuleUnwrapCode({ source, preserveNamedExports, stopWithReturn }) {
+	return `let current = ${source};
+      for (let i = 0; i < 5; i++) {
+        const defaultExport = current?.default;
+        ${stopWithReturn ? `if (!defaultExport || typeof defaultExport !== "object") return ${stopWithReturn};` : `if (!defaultExport || typeof defaultExport !== "object") break;`}${preserveNamedExports ? `
+        const namedValues = Object.keys(current).filter((key) => key !== "default").map((key) => current[key]);
+        if (namedValues.length > 0 && namedValues.some((value) => value !== undefined)) break;` : ""}
+        current = defaultExport;
+      }
+      return current;`;
+}
+const normalizeLocalShareModuleCode = `const __mfNormalizeShareModule = (mod) => {
+      ${generateShareModuleUnwrapCode({
+	source: "mod",
+	preserveNamedExports: true
+})}
+    };`;
 function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
 	if (!loadShareCacheMap[pkg]) loadShareCacheMap[pkg] = new VirtualModule(pkg, LOAD_SHARE_TAG, ".mjs");
 	const importLine = getRuntimeModuleCacheBootstrapCode();
 	if (shareItem.shareConfig.import === false) {
 		const namedExports = getPackageNamedExports(pkg);
 		let exportLine;
-		if (namedExports.length > 0) exportLine = `export default exportModule.default ?? exportModule;\n    ${`const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`}\n    ${`export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`}`;
+		if (namedExports.length > 0) exportLine = generateDeferredHostProvidedExports(namedExports, pkg);
 		else {
 			mfWarn(`Shared dependency "${pkg}" has import: false but is not installed locally.\n  Named imports (e.g. import { ... } from '${pkg}') will not work in production builds.\n  Install it as a devDependency to enable named export detection.`);
-			exportLine = "export default exportModule.default ?? exportModule";
+			exportLine = generateDeferredHostProvidedExports([], pkg);
 		}
 		loadShareCacheMap[pkg].writeSync(`
+    ${getRuntimeInitPromiseBootstrapCode()}
     ${importLine}
-    const exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}]
-    if (exportModule === undefined) {
-      throw new Error("[Module Federation] Shared module ${pkg} was imported before federation bootstrap finished.")
-    }
     ${exportLine}
   `, true);
 		return;
@@ -1268,8 +1270,20 @@ function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
 	const usesLazyLocalFallback = isWorkspacePackage && shareItem.shareConfig.singleton === true;
 	const namedExports = getPackageNamedExports(pkg);
 	let exportLine;
-	if (namedExports.length > 0) exportLine = `export default exportModule.default ?? exportModule;\n    ${`const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`}\n    ${`export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`}`;
-	else if (usesLazyLocalFallback) exportLine = `export default exportModule.default ?? exportModule`;
+	if (namedExports.length > 0) {
+		const destructure = `const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`;
+		const namedExportLine = `export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`;
+		exportLine = `const __mfDefaultExport = (() => {
+      ${generateShareModuleUnwrapCode({
+			source: "exportModule",
+			preserveNamedExports: false,
+			stopWithReturn: "defaultExport ?? current"
+		})}
+    })();
+    export default __mfDefaultExport;
+    ${destructure}
+    ${namedExportLine}`;
+	} else if (usesLazyLocalFallback) exportLine = `export default exportModule.default ?? exportModule`;
 	else exportLine = `export default exportModule.default ?? exportModule\n    export * from ${escapeGeneratedStringLiteral(sharedImportSource)}`;
 	const prebuildImportLine = usesLazyLocalFallback || isWorkspacePackage && command !== "build" ? "" : `import * as __mfLocalShare from ${escapeGeneratedStringLiteral(skipServePrebuildWarmup ? devImportSource : sharedImportSource)};`;
 	const devDynamicImportLine = isWorkspacePackage ? "" : command !== "build" && !skipServePrebuildWarmup ? `;() => import(${escapeGeneratedStringLiteral(devImportSource)}).catch(() => {});` : "";
@@ -1277,10 +1291,11 @@ function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
     ${prebuildImportLine}
     ${devDynamicImportLine}
     ${importLine}
+    ${normalizeLocalShareModuleCode}
     let exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}]
     if (exportModule === undefined) {
-      ${usesLazyLocalFallback ? `exportModule = await import(${escapeGeneratedStringLiteral(lazyLocalFallbackSource)});
-      __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;` : `exportModule = __mfLocalShare;
+      ${usesLazyLocalFallback ? `exportModule = __mfNormalizeShareModule(await import(${escapeGeneratedStringLiteral(lazyLocalFallbackSource)}));
+      __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;` : `exportModule = __mfNormalizeShareModule(__mfLocalShare);
       __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;`}
     }
     ${exportLine}
@@ -1438,9 +1453,9 @@ function getShareItemForPreload(pkg) {
 function generateSharedCacheSeedItem(pkg, importPath) {
 	return `if (__mfModuleCache.share[${JSON.stringify(pkg)}] === undefined) {
         const mod = await import(${JSON.stringify(importPath)});
-        const exportModule = ${JSON.stringify(shouldUseDirectReactImport())} && ${JSON.stringify(pkg)} === "react"
-          ? (mod?.default ?? mod)
-          : {...mod};
+        ${normalizeRuntimeShareCode}
+        const normalizedModule = __mfNormalizeRuntimeShare(mod);
+        const exportModule = normalizedModule === mod ? {...mod} : normalizedModule;
         Object.defineProperty(exportModule, "__esModule", {
           value: true,
           enumerable: false
@@ -1448,6 +1463,17 @@ function generateSharedCacheSeedItem(pkg, importPath) {
         __mfModuleCache.share[${JSON.stringify(pkg)}] = exportModule;
       }`;
 }
+const normalizeRuntimeShareCode = `const __mfNormalizeRuntimeShare = (mod) => {
+            let current = mod;
+            for (let i = 0; i < 5; i++) {
+              const defaultExport = current?.default;
+              if (!defaultExport || typeof defaultExport !== "object") break;
+              const namedValues = Object.keys(current).filter((key) => key !== "default").map((key) => current[key]);
+              if (namedValues.length > 0 && namedValues.some((value) => value !== undefined)) break;
+              current = defaultExport;
+            }
+            return current;
+          };`;
 function generateDirectSharedCacheSeedCode(command = "build") {
 	return getOrderedUsedShares().map((pkg) => {
 		const shareItem = getShareItemForPreload(pkg);
@@ -1470,7 +1496,8 @@ function getHostAutoInitSharedSeedItems() {
 		return priority(a.pkg) - priority(b.pkg) || Number(aIsLocal) - Number(bIsLocal) || a.pkg.localeCompare(b.pkg);
 	});
 }
-function generateHostAutoInitSharedCacheSeedCode() {
+function generateHostAutoInitSharedCacheSeedCode(command = "build") {
+	if (command === "build") return "";
 	return getHostAutoInitSharedSeedItems().map(({ pkg, shareItem }) => {
 		if (!shareItem) return null;
 		return generateSharedCacheSeedItem(pkg, getBrowserImportPath(getDirectSharedCacheSeedImportPath(pkg, shareItem)));
@@ -1502,14 +1529,13 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
   if (typeof __VUE_HMR_RUNTIME__ === 'undefined') {
     globalThis.__VUE_HMR_RUNTIME__ = { createRecord() {}, rerender() {}, reload() {} };
   }
-  import {createInstance, loadRemote} from "@module-federation/runtime";
+  import {init as runtimeInit, loadRemote} from "@module-federation/runtime";
   ${pluginImportNames.map((item) => item[1]).join("\n")}
   ${command === "build" ? getRuntimeInitResolveBootstrapCode() : getRuntimeInitBootstrapCode() + "\n  const { initResolve } = globalThis[globalKey];"}
   ${getRuntimeModuleCacheBootstrapCode()}
   const initTokens = {}
   const shareScopeName = ${JSON.stringify(options.shareScope)}
   const mfName = ${JSON.stringify(options.internalName)}
-  let runtimeInstance
   let localSharedImportMapPromise
   let exposesMapPromise
   const shouldRetrySharedInitError = ${command !== "build"} && ((error) => {
@@ -1552,19 +1578,13 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
   async function init(shared = {}, initScope = []) {
     const {usedShared, usedRemotes} = await getLocalSharedImportMap()
     ${generateDirectSharedCacheSeedCode(command)}
-    const runtimeOptions = {
+    const initRes = runtimeInit({
       name: mfName,
       remotes: usedRemotes,
       shared: usedShared,
       plugins: [${pluginImportNames.map((item) => `${item[0]}(${item[2]})`).join(", ")}],
       ${options.shareStrategy ? `shareStrategy: '${options.shareStrategy}'` : ""}
-    };
-    if (!runtimeInstance) {
-      runtimeInstance = createInstance(runtimeOptions);
-    } else {
-      runtimeInstance.initOptions(runtimeOptions);
-    }
-    const initRes = runtimeInstance;
+    });
     // handling circular init calls
     var initToken = initTokens[shareScopeName];
     if (!initToken)
@@ -1584,6 +1604,17 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
     } catch (e) {
       console.error('[Module Federation]', e)
     }
+    for (const [pkg, share] of Object.entries(usedShared)) {
+      if (share.shareConfig?.import !== false || __mfModuleCache.share[pkg] !== undefined) continue;
+      ${normalizeRuntimeShareCode}
+      const versions = shared?.[pkg];
+      const provider = versions && versions[Object.keys(versions)[0]];
+      if (!provider) continue;
+      const factory = provider.lib || (provider.loading ? await provider.loading : await provider.get?.());
+      const mod = typeof factory === "function" ? factory() : factory;
+      const resolved = await Promise.resolve(mod);
+      __mfModuleCache.share[pkg] = __mfNormalizeRuntimeShare(resolved);
+    }
     return initRes
   }
 
@@ -1608,10 +1639,11 @@ function generateHostAutoInitCode(remoteEntryImport, _command = "build") {
     async function initHost() {
       if (!hostInitPromise) {
         hostInitPromise = (async () => {
-          ${generateHostAutoInitSharedCacheSeedCode()}
+          ${generateHostAutoInitSharedCacheSeedCode(_command)}
           const remoteEntry = await import(${remoteEntryImport});
           const runtime = await remoteEntry.init();
           const usedShared = ${generateUsedSharedPreloadConfig()};
+          ${normalizeRuntimeShareCode}
           for (const [pkg, share] of Object.entries(usedShared)) {
             if (__mfModuleCache.share[pkg] !== undefined) {
               continue;
@@ -1621,7 +1653,7 @@ function generateHostAutoInitCode(remoteEntryImport, _command = "build") {
             }).then((factory) => {
               const mod = typeof factory === "function" ? factory() : factory;
               return Promise.resolve(mod).then((resolved) => {
-                __mfModuleCache.share[pkg] = resolved;
+                __mfModuleCache.share[pkg] = __mfNormalizeRuntimeShare(resolved);
               });
             });
           }
@@ -1650,7 +1682,7 @@ function getHostAutoInitImportId() {
 	return hostAutoInitModule.getImportId();
 }
 function getHostAutoInitPath() {
-	return hostAutoInitModule.getPath();
+	return hostAutoInitModule.getImportId();
 }
 //#endregion
 //#region src/virtualModules/virtualRemotes.ts
@@ -1673,7 +1705,9 @@ function getUsedRemotesMap() {
 }
 function generateRemotes(id, command) {
 	const useReactProxy = command === "serve" && hasPackageDependency("react");
-	const reactImportLine = useReactProxy ? `import * as __mfReact from "react";` : "";
+	const reactImportLine = useReactProxy ? `import __mfReactDefault from "react";
+    import * as __mfReactNamespace from "react";
+    const __mfReact = __mfReactDefault ?? __mfReactNamespace.default ?? __mfReactNamespace;` : "";
 	const importLine = command === "build" ? `${getRuntimeModuleCacheBootstrapCode()}
     import { hostInitPromise as __mfHostInitPromise } from ${JSON.stringify(getHostAutoInitPath())};` : `${getRuntimeInitBootstrapCode()}
     const { initPromise, moduleCache: __mfModuleCache } = globalThis[globalKey];`;
@@ -1683,13 +1717,13 @@ function generateRemotes(id, command) {
 }
 export const __moduleExports = exportModule;
 export const __mf_remote_pending = Promise.resolve(exportModule);
-export default exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : command === "build" ? `if (__mfRemotePending) {
+export default exportModule?.__mf_is_remote_proxy ? exportModule : exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : command === "build" ? `if (__mfRemotePending) {
   const mod = await __mfRemotePending;
   if (mod !== undefined) exportModule = mod;
 }
 export const __moduleExports = exportModule;
 export const __mf_remote_pending = Promise.resolve(exportModule);
-export default exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : "export default exportModule";
+export default exportModule?.__mf_is_remote_proxy ? exportModule : exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : "export default exportModule";
 	return `
     ${reactImportLine}
     ${importLine}
@@ -1889,6 +1923,9 @@ ${importHelper}(async () => {
 		if (inject === "html" && hasPackageDependency("@sveltejs/kit")) return false;
 		return inject === "entry" || !htmlFilePath;
 	}
+	function normalizeDevHtmlProxyId(id) {
+		return id.replace(/^\0/, "").replace(/^\/@id\//, "").replace(/^__x00__/, "");
+	}
 	return [{
 		name: "add-entry",
 		apply: "serve",
@@ -1907,7 +1944,20 @@ ${importHelper}(async () => {
 			}
 		},
 		configureServer(server) {
-			server.middlewares.use((req, _res, next) => {
+			server.middlewares.use((req, res, next) => {
+				const rawUrl = req.url?.split("#")[0] ?? "";
+				if (normalizeDevHtmlProxyId(rawUrl.split("?")[0]) === DEV_HTML_PROXY_PREFIX.slice(0, -1)) {
+					const query = rawUrl.slice(rawUrl.indexOf("?") + 1);
+					const params = new URLSearchParams(query);
+					const initSrc = params.get("init");
+					const entrySrc = params.get("entry");
+					if (initSrc && entrySrc) {
+						res.statusCode = 200;
+						res.setHeader("Content-Type", "application/javascript");
+						res.end(getBootstrapSource(initSrc, entrySrc));
+						return;
+					}
+				}
 				if (!fileName) {
 					next();
 					return;
@@ -1924,7 +1974,7 @@ ${importHelper}(async () => {
 				const base = viteConfig.base.replace(/\/$/, "");
 				const stripBase = (p) => base && p.startsWith(base + "/") ? p.slice(base.length) : p;
 				const html = rewriteEntryScripts(c, (originalSrc) => {
-					return `/@id/${DEV_HTML_PROXY_PREFIX}${new URLSearchParams({
+					return `/@id/__x00__${DEV_HTML_PROXY_PREFIX}${new URLSearchParams({
 						init: sanitizeDevEntryPath(stripBase(devEntryPath)),
 						entry: sanitizeDevEntryPath(stripBase(originalSrc))
 					}).toString()}`;
@@ -1933,11 +1983,12 @@ ${importHelper}(async () => {
 			}
 		},
 		resolveId(id) {
-			if (id.startsWith(DEV_HTML_PROXY_PREFIX)) return id;
+			if (normalizeDevHtmlProxyId(id).startsWith(DEV_HTML_PROXY_PREFIX)) return id;
 		},
 		load(id) {
-			if (!id.startsWith(DEV_HTML_PROXY_PREFIX)) return;
-			const params = new URLSearchParams(id.slice(28));
+			const normalizedId = normalizeDevHtmlProxyId(id);
+			if (!normalizedId.startsWith(DEV_HTML_PROXY_PREFIX)) return;
+			const params = new URLSearchParams(normalizedId.slice(28));
 			const initSrc = params.get("init");
 			const entrySrc = params.get("entry");
 			if (!initSrc || !entrySrc) return;
@@ -2744,7 +2795,7 @@ function collectSystemProxyInfos(proxyChunks, loadShareTag) {
 		for (const m of proxyInfo.code.matchAll(/exports\(\s*["']([^"']+)["']\s*,([\s\S]*?)\);/g)) {
 			const exported = m[1];
 			const expression = m[2];
-			for (const [local, exportName] of Object.entries(loadShareBindings)) if (new RegExp(`\\b${local}\\b`).test(expression)) {
+			for (const [local, exportName] of Object.entries(loadShareBindings).reverse()) if (new RegExp(`\\b${local}\\b`).test(expression)) {
 				exportMap[exported] = {
 					type: "reexport",
 					exportName
@@ -3508,7 +3559,7 @@ function pluginProxyRemotes_default(options) {
 		const remoteModule = getRemoteVirtualModule(source, command);
 		addUsedRemote(remoteName, source);
 		refreshHostAutoInit();
-		return remoteModule.getPath();
+		return remoteModule.getImportId();
 	}
 	return {
 		name: "proxyRemotes",
@@ -4330,12 +4381,12 @@ function isFederationHtmlPreloadDependency(dep, includeSharedRuntime = false) {
 	return includeSharedRuntime && (file.includes("preload-helper") || file.includes("rolldown-runtime") || file.startsWith("dist-"));
 }
 /**
-* Plugin that runs FIRST to create virtual module files in the config hook.
-* This prevents 504 "Outdated Optimize Dep" errors by ensuring files exist
+* Plugin that runs FIRST to register generated virtual modules in the config hook.
+* This prevents 504 "Outdated Optimize Dep" errors by ensuring ids are known
 * before Vite's optimization phase.
 */
 function createEarlyVirtualModulesPlugin(options) {
-	const { shared, remotes, virtualModuleDir } = options;
+	const { shared, remotes } = options;
 	const isLitShare = (pkg) => pkg === "lit" || pkg.startsWith("lit/");
 	return {
 		name: "vite:module-federation-early-init",
@@ -4345,9 +4396,6 @@ function createEarlyVirtualModulesPlugin(options) {
 			const root = config.root || process.cwd();
 			setPackageDetectionCwd(root);
 			const isVinext = hasPackageDependency("vinext");
-			initVirtualModuleInfrastructure(root, virtualModuleDir);
-			VirtualModule.setRoot(root);
-			VirtualModule.ensureVirtualPackageExists();
 			initVirtualModules(_command, getRemoteEntryId(options));
 			const isRolldown = getIsRolldown(this);
 			if (remotes && Object.keys(remotes).length > 0) {
@@ -4393,6 +4441,10 @@ function createEarlyVirtualModulesPlugin(options) {
 						optimizeDeps.esbuildOptions.plugins.push({
 							name: "module-federation:optimize-shared-proxy",
 							setup(build) {
+								build.onResolve({ filter: /^virtual:mf:/ }, (args) => ({
+									path: args.path,
+									external: true
+								}));
 								build.onResolve({ filter: /.*/ }, (args) => {
 									if (!args.importer || args.namespace === "mf-shared") return;
 									if (isSharedResolverInternalImporter(args.importer)) return;
@@ -4424,7 +4476,6 @@ export default __mfShared.default ?? __mfShared;`
 							}
 						});
 					}
-					config.optimizeDeps.include.push(virtualRuntimeInitStatus.getImportId());
 				}
 				for (const key of Object.keys(shared)) {
 					const shareItem = shared[key];
@@ -4435,7 +4486,6 @@ export default __mfShared.default ?? __mfShared;`
 							for (const subpath of getCommonSharedSubpaths(key)) {
 								writePreBuildLibPath(subpath, shareItem);
 								optimizeDeps.include.push(subpath);
-								optimizeDeps.include.push(getPreBuildLibImportId(subpath));
 							}
 						}
 						continue;
@@ -4452,14 +4502,11 @@ export default __mfShared.default ?? __mfShared;`
 						const optimizeDeps = config.optimizeDeps ??= {};
 						optimizeDeps.include ??= [];
 						optimizeDeps.exclude ??= [];
-						const shouldBypassOptimizeDep = isLitShare(key);
-						if (shouldBypassOptimizeDep) optimizeDeps.exclude.push(key);
-						if (!isRolldown && !shouldBypassOptimizeDep) optimizeDeps.include.push(getLoadShareImportId(key, isRolldown));
-						optimizeDeps.include.push(getPreBuildLibImportId(key));
+						if (isLitShare(key)) optimizeDeps.exclude.push(key);
+						else optimizeDeps.include.push(key);
 						for (const subpath of getCommonSharedSubpaths(key)) {
 							writePreBuildLibPath(subpath, shareItem);
 							optimizeDeps.include.push(subpath);
-							optimizeDeps.include.push(getPreBuildLibImportId(subpath));
 						}
 					}
 				}
@@ -4479,6 +4526,21 @@ function federation(mfUserOptions) {
 	let command;
 	let desiredRolldownOutput;
 	return [
+		{
+			name: "vite:module-federation-virtual-modules",
+			enforce: "pre",
+			resolveId(id) {
+				const virtualModule = VirtualModule.findById(id);
+				if (!virtualModule) return;
+				return virtualModule.getResolvedId();
+			},
+			load(id) {
+				const virtualModule = VirtualModule.findById(id);
+				if (!virtualModule) return;
+				if (command === "build" && (id.includes("__loadShare__") || id.includes("__loadRemote__"))) return;
+				return virtualModule.code;
+			}
+		},
 		createEarlyVirtualModulesPlugin(options),
 		...isVinext ? [{
 			name: "module-federation-vinext-react-server-build-alias",
@@ -4503,9 +4565,7 @@ function federation(mfUserOptions) {
 			config(_config, env) {
 				command = env.command;
 			},
-			configResolved(config) {
-				VirtualModule.setRoot(config.root);
-				VirtualModule.ensureVirtualPackageExists();
+			configResolved() {
 				initVirtualModules(command, remoteEntryId);
 			}
 		},
@@ -4648,9 +4708,8 @@ function federation(mfUserOptions) {
 				}
 			},
 			load(id) {
-				if (id.startsWith("\0")) return;
 				if (id.includes("__loadShare__") || id.includes("__loadRemote__")) {
-					let code = (0, fs.readFileSync)(id, "utf-8");
+					let code = VirtualModule.findById(id)?.code ?? (0, fs.readFileSync)(id, "utf-8");
 					code = code.replace(/import\s+["'][^"']*__prebuild__[^"']*["']\s*;?/g, "");
 					code = code.replace(/export\s+\*\s+from\s+["'][^"']*__prebuild__[^"']*["']\s*;?/g, "");
 					/**
@@ -4669,7 +4728,10 @@ function federation(mfUserOptions) {
 					*
 					* @see https://rollupjs.org/plugin-development/#synthetic-named-exports
 					*/
-					if (!code.includes("__moduleExports")) code = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+					if (!/\bexport\s+const\s+__moduleExports\b/.test(code)) {
+						const nextCode = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+						code = nextCode === code ? `${code}\nexport const __moduleExports = exportModule;\n` : nextCode;
+					}
 					if (getIsRolldown(this)) return { code };
 					return {
 						code,
@@ -4734,14 +4796,9 @@ function federation(mfUserOptions) {
 				config.build ||= {};
 				config.build.commonjsOptions ||= {};
 				config.build.commonjsOptions.strictRequires ??= "auto";
-				const virtualDir = options.virtualModuleDir;
 				config.optimizeDeps ||= {};
 				config.optimizeDeps.include ||= [];
 				config.optimizeDeps.include.push("@module-federation/runtime");
-				if (!isRolldown) config.optimizeDeps.include.push(virtualDir);
-				config.ssr ||= {};
-				config.ssr.noExternal ||= [];
-				if (Array.isArray(config.ssr.noExternal)) config.ssr.noExternal.push(virtualDir);
 				options.runtimePlugins.forEach((p) => {
 					const pluginPath = typeof p === "string" ? p : p[0];
 					if (pluginPath && !pluginPath.startsWith(".") && !pluginPath.startsWith("/") && !pluginPath.startsWith("\0") && !pluginPath.startsWith("virtual:")) config.optimizeDeps.include.push(pluginPath);
@@ -4749,9 +4806,6 @@ function federation(mfUserOptions) {
 				if (isRolldown) {
 					config.build ??= {};
 					config.build.target ??= "esnext";
-				} else {
-					config.optimizeDeps.needsInterop ||= [];
-					config.optimizeDeps.needsInterop.push(virtualDir);
 				}
 				const isAstro = hasPackageDependency("astro");
 				const resolvedTarget = options.target ?? (config.build?.ssr ? "node" : "web");

package/lib/index.mjs

@@ -1,14 +1,14 @@
 import { createRequire } from "node:module";
 import * as fs$1 from "fs";
-import fs, { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFile, writeFileSync } from "fs";
+import fs, { existsSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from "fs";
 import { createRequire as createRequire$1 } from "module";
 import * as path$1 from "pathe";
-import path, { basename, dirname, join, parse, resolve } from "pathe";
+import path, { basename } from "pathe";
 import { normalizeOptions } from "@module-federation/sdk";
 import { consumeTypesAPI, generateTypesAPI, isTSProject, normalizeConsumeTypesOptions, normalizeDtsOptions, normalizeGenerateTypesOptions } from "@module-federation/dts-plugin";
 import { rpc } from "@module-federation/dts-plugin/core";
 import { fileURLToPath } from "url";
-import { init, parse as parse$1 } from "es-module-lexer";
+import { init, parse } from "es-module-lexer";
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -524,7 +524,7 @@ function normalizeShareItem(key, shareItem) {
 		shareConfig: {
 			import: shareItem.import,
 			singleton: shareItem.singleton || false,
-			requiredVersion: shareItem.requiredVersion || (version ? `^${version}` : "*"),
+			requiredVersion: shareItem.requiredVersion || (isImportFalse ? "*" : version ? `^${version}` : "*"),
 			strictVersion: !!shareItem.strictVersion
 		}
 	};
@@ -641,35 +641,6 @@ function normalizeModuleFederationOptions(options) {
 }
 //#endregion
 //#region src/utils/VirtualModule.ts
-/**
-* Initialize virtual module infrastructure BEFORE VirtualModule class is used.
-* This must be called in the config hook to ensure the directory exists
-* before Vite's optimization phase.
-*/
-function initVirtualModuleInfrastructure(root, virtualModuleDir = "__mf__virtual") {
-	const virtualPackagePath = join(join(root, "node_modules"), virtualModuleDir);
-	mkdirSync(virtualPackagePath, { recursive: true });
-	writeFileSync(join(virtualPackagePath, "empty.js"), "");
-	writeFileSync(join(virtualPackagePath, "package.json"), JSON.stringify({
-		name: virtualModuleDir,
-		main: "empty.js"
-	}));
-}
-let rootDir;
-function findNodeModulesDir(root = process.cwd()) {
-	let currentDir = root;
-	while (currentDir !== parse(currentDir).root) {
-		const nodeModulesPath = join(currentDir, "node_modules");
-		if (existsSync(nodeModulesPath)) return nodeModulesPath;
-		currentDir = dirname(currentDir);
-	}
-	return "";
-}
-let cachedNodeModulesDir;
-function getNodeModulesDir() {
-	if (!cachedNodeModulesDir) cachedNodeModulesDir = findNodeModulesDir(rootDir);
-	return cachedNodeModulesDir;
-}
 function getSuffix(name) {
 	const base = basename(name);
 	const dotIndex = base.lastIndexOf(".");
@@ -678,9 +649,6 @@ function getSuffix(name) {
 }
 const patternMap = {};
 const cacheMap = {};
-/**
-* Physically generate files as virtual modules under node_modules/__mf__virtual/*
-*/
 function assertModuleFound(tag, str = "") {
 	const module = VirtualModule.findModule(tag, str);
 	if (!module) throw createModuleFederationError(`Module Federation shared module '${str}' not found. Please ensure it's installed as a dependency in your package.json.`);
@@ -691,33 +659,16 @@ var VirtualModule = class {
 	tag;
 	suffix;
 	inited = false;
-	/**
-	* Set the root path for finding node_modules
-	* @param root - Root path
-	*/
-	static setRoot(root) {
-		rootDir = root;
-		cachedNodeModulesDir = void 0;
-	}
-	/**
-	* Ensure virtual package directory exists
-	*/
-	static ensureVirtualPackageExists() {
-		const nodeModulesDir = getNodeModulesDir();
-		const { virtualModuleDir } = getNormalizeModuleFederationOptions();
-		const virtualPackagePath = resolve(nodeModulesDir, virtualModuleDir);
-		mkdirSync(virtualPackagePath, { recursive: true });
-		writeFileSync(resolve(virtualPackagePath, "empty.js"), "");
-		writeFileSync(resolve(virtualPackagePath, "package.json"), JSON.stringify({
-			name: virtualModuleDir,
-			main: "empty.js"
-		}));
-	}
+	code;
 	static findModule(tag, str = "") {
 		if (!patternMap[tag]) patternMap[tag] = new RegExp(`(.*${packageNameEncode(tag)}(.+?)${packageNameEncode(tag)}.*)`);
 		const moduleName = (str.match(patternMap[tag]) || [])[2];
 		if (moduleName) return cacheMap[tag][packageNameDecode(moduleName)];
 	}
+	static findById(id) {
+		const normalized = id.replace(/^\0+/, "").replace(/^\/@id\//, "").replace(/^__x00__/, "").replace(/[?#].*$/, "");
+		for (const modules of Object.values(cacheMap)) for (const module of Object.values(modules)) if (module.getImportId() === normalized) return module;
+	}
 	constructor(name, tag = "__mf_v__", suffix = "") {
 		this.name = name;
 		this.tag = tag;
@@ -725,24 +676,20 @@ var VirtualModule = class {
 		if (!cacheMap[this.tag]) cacheMap[this.tag] = {};
 		cacheMap[this.tag][this.name] = this;
 	}
-	getPath() {
-		return resolve(getNodeModulesDir(), this.getImportId());
-	}
 	getImportId() {
-		const { internalName: mfName, virtualModuleDir } = getNormalizeModuleFederationOptions();
-		return `${virtualModuleDir}/${packageNameEncode(`${mfName}${this.tag}${this.name}${this.tag}`)}${this.suffix}`;
+		const { internalName: mfName } = getNormalizeModuleFederationOptions();
+		return `virtual:mf:${packageNameEncode(`${mfName}${this.tag}${this.name}${this.tag}`)}${this.suffix}`;
+	}
+	getResolvedId() {
+		return `\0${this.getImportId()}`;
 	}
 	writeSync(code, force) {
 		if (!force && this.inited) return;
 		if (!this.inited) this.inited = true;
-		const path = this.getPath();
-		mkdirSync(dirname(path), { recursive: true });
-		writeFileSync(path, code);
+		this.code = code;
 	}
 	write(code) {
-		const path = this.getPath();
-		mkdirSync(dirname(path), { recursive: true });
-		writeFile(path, code, function() {});
+		this.writeSync(code, true);
 	}
 };
 //#endregion
@@ -944,6 +891,14 @@ globalThis[__mfCacheGlobalKey].remote ||= {};
 const __mfModuleCache = globalThis[__mfCacheGlobalKey];
 `;
 }
+function getRuntimeInitPromiseBootstrapCode() {
+	return getRuntimeInitStateBootstrapCode({
+		globalKeyVar: "__mfPromiseGlobalKey",
+		stateVar: "__mfPromiseState",
+		exposedConst: "initPromise",
+		exposedProperty: "initPromise"
+	});
+}
 function getRuntimeInitResolveBootstrapCode() {
 	return getRuntimeInitStateBootstrapCode({
 		globalKeyVar: "__mfResolveGlobalKey",
@@ -1188,6 +1143,16 @@ function writePreBuildLibPath(pkg, shareItem) {
     export const jsx = __mfPrebuildExports.jsx;
     export const jsxs = __mfPrebuildExports.jsxs;
     export default __mfPrebuildExports;
+  `, true);
+		return;
+	}
+	const namedExports = getPackageNamedExports(pkg);
+	if (namedExports.length > 0) {
+		preBuildCacheMap[pkg].writeSync(`
+    import * as __mfPrebuildNamespace from ${escapeGeneratedStringLiteral(importSource)};
+    const __mfPrebuildExports = __mfPrebuildNamespace;
+    ${namedExports.map((name) => `export const ${name} = __mfPrebuildExports[${escapeGeneratedStringLiteral(name)}];`).join("\n    ")}
+    export default __mfPrebuildExports;
   `, true);
 		return;
 	}
@@ -1215,25 +1180,62 @@ function getLoadShareImportId(pkg, _isRolldown) {
 }
 function getLoadShareModulePath(pkg, isRolldown) {
 	if (!loadShareCacheMap[pkg]) getLoadShareImportId(pkg, isRolldown);
-	return loadShareCacheMap[pkg].getPath();
+	return loadShareCacheMap[pkg].getImportId();
 }
+function generateDeferredHostProvidedExports(namedExports, pkg) {
+	const namedExportVars = namedExports.map((_name, i) => `__mf_${i}`);
+	const declarations = ["let __mf_default;", ...namedExportVars.map((name) => `let ${name};`)].join("\n    ");
+	const assignments = [...namedExports.map((name, i) => `${namedExportVars[i]} = exportModule[${escapeGeneratedStringLiteral(name)}];`), "__mf_default = exportModule.default ?? exportModule;"].join("\n      ");
+	const namedExportLine = namedExports.length > 0 ? `\n    export { ${namedExports.map((name, i) => `${namedExportVars[i]} as ${name}`).join(", ")} };` : "";
+	return `${declarations}
+    const __mfApplyHostProvidedExports = (exportModule) => {
+      ${assignments}
+    };
+    let exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}];
+    if (exportModule === undefined) {
+      initPromise.then(() => {
+        exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}];
+        if (exportModule === undefined) {
+          throw new Error("[Module Federation] Shared module ${pkg} was imported before federation bootstrap finished.");
+        }
+        __mfApplyHostProvidedExports(exportModule);
+      });
+    } else {
+      __mfApplyHostProvidedExports(exportModule);
+    }
+    export { __mf_default as default };${namedExportLine}`;
+}
+function generateShareModuleUnwrapCode({ source, preserveNamedExports, stopWithReturn }) {
+	return `let current = ${source};
+      for (let i = 0; i < 5; i++) {
+        const defaultExport = current?.default;
+        ${stopWithReturn ? `if (!defaultExport || typeof defaultExport !== "object") return ${stopWithReturn};` : `if (!defaultExport || typeof defaultExport !== "object") break;`}${preserveNamedExports ? `
+        const namedValues = Object.keys(current).filter((key) => key !== "default").map((key) => current[key]);
+        if (namedValues.length > 0 && namedValues.some((value) => value !== undefined)) break;` : ""}
+        current = defaultExport;
+      }
+      return current;`;
+}
+const normalizeLocalShareModuleCode = `const __mfNormalizeShareModule = (mod) => {
+      ${generateShareModuleUnwrapCode({
+	source: "mod",
+	preserveNamedExports: true
+})}
+    };`;
 function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
 	if (!loadShareCacheMap[pkg]) loadShareCacheMap[pkg] = new VirtualModule(pkg, LOAD_SHARE_TAG, ".mjs");
 	const importLine = getRuntimeModuleCacheBootstrapCode();
 	if (shareItem.shareConfig.import === false) {
 		const namedExports = getPackageNamedExports(pkg);
 		let exportLine;
-		if (namedExports.length > 0) exportLine = `export default exportModule.default ?? exportModule;\n    ${`const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`}\n    ${`export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`}`;
+		if (namedExports.length > 0) exportLine = generateDeferredHostProvidedExports(namedExports, pkg);
 		else {
 			mfWarn(`Shared dependency "${pkg}" has import: false but is not installed locally.\n  Named imports (e.g. import { ... } from '${pkg}') will not work in production builds.\n  Install it as a devDependency to enable named export detection.`);
-			exportLine = "export default exportModule.default ?? exportModule";
+			exportLine = generateDeferredHostProvidedExports([], pkg);
 		}
 		loadShareCacheMap[pkg].writeSync(`
+    ${getRuntimeInitPromiseBootstrapCode()}
     ${importLine}
-    const exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}]
-    if (exportModule === undefined) {
-      throw new Error("[Module Federation] Shared module ${pkg} was imported before federation bootstrap finished.")
-    }
     ${exportLine}
   `, true);
 		return;
@@ -1248,8 +1250,20 @@ function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
 	const usesLazyLocalFallback = isWorkspacePackage && shareItem.shareConfig.singleton === true;
 	const namedExports = getPackageNamedExports(pkg);
 	let exportLine;
-	if (namedExports.length > 0) exportLine = `export default exportModule.default ?? exportModule;\n    ${`const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`}\n    ${`export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`}`;
-	else if (usesLazyLocalFallback) exportLine = `export default exportModule.default ?? exportModule`;
+	if (namedExports.length > 0) {
+		const destructure = `const { ${namedExports.map((name, i) => `${name}: __mf_${i}`).join(", ")} } = exportModule;`;
+		const namedExportLine = `export { ${namedExports.map((name, i) => `__mf_${i} as ${name}`).join(", ")} };`;
+		exportLine = `const __mfDefaultExport = (() => {
+      ${generateShareModuleUnwrapCode({
+			source: "exportModule",
+			preserveNamedExports: false,
+			stopWithReturn: "defaultExport ?? current"
+		})}
+    })();
+    export default __mfDefaultExport;
+    ${destructure}
+    ${namedExportLine}`;
+	} else if (usesLazyLocalFallback) exportLine = `export default exportModule.default ?? exportModule`;
 	else exportLine = `export default exportModule.default ?? exportModule\n    export * from ${escapeGeneratedStringLiteral(sharedImportSource)}`;
 	const prebuildImportLine = usesLazyLocalFallback || isWorkspacePackage && command !== "build" ? "" : `import * as __mfLocalShare from ${escapeGeneratedStringLiteral(skipServePrebuildWarmup ? devImportSource : sharedImportSource)};`;
 	const devDynamicImportLine = isWorkspacePackage ? "" : command !== "build" && !skipServePrebuildWarmup ? `;() => import(${escapeGeneratedStringLiteral(devImportSource)}).catch(() => {});` : "";
@@ -1257,10 +1271,11 @@ function writeLoadShareModule(pkg, shareItem, command, _isRolldown) {
     ${prebuildImportLine}
     ${devDynamicImportLine}
     ${importLine}
+    ${normalizeLocalShareModuleCode}
     let exportModule = __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}]
     if (exportModule === undefined) {
-      ${usesLazyLocalFallback ? `exportModule = await import(${escapeGeneratedStringLiteral(lazyLocalFallbackSource)});
-      __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;` : `exportModule = __mfLocalShare;
+      ${usesLazyLocalFallback ? `exportModule = __mfNormalizeShareModule(await import(${escapeGeneratedStringLiteral(lazyLocalFallbackSource)}));
+      __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;` : `exportModule = __mfNormalizeShareModule(__mfLocalShare);
       __mfModuleCache.share[${escapeGeneratedStringLiteral(pkg)}] = exportModule;`}
     }
     ${exportLine}
@@ -1418,9 +1433,9 @@ function getShareItemForPreload(pkg) {
 function generateSharedCacheSeedItem(pkg, importPath) {
 	return `if (__mfModuleCache.share[${JSON.stringify(pkg)}] === undefined) {
         const mod = await import(${JSON.stringify(importPath)});
-        const exportModule = ${JSON.stringify(shouldUseDirectReactImport())} && ${JSON.stringify(pkg)} === "react"
-          ? (mod?.default ?? mod)
-          : {...mod};
+        ${normalizeRuntimeShareCode}
+        const normalizedModule = __mfNormalizeRuntimeShare(mod);
+        const exportModule = normalizedModule === mod ? {...mod} : normalizedModule;
         Object.defineProperty(exportModule, "__esModule", {
           value: true,
           enumerable: false
@@ -1428,6 +1443,17 @@ function generateSharedCacheSeedItem(pkg, importPath) {
         __mfModuleCache.share[${JSON.stringify(pkg)}] = exportModule;
       }`;
 }
+const normalizeRuntimeShareCode = `const __mfNormalizeRuntimeShare = (mod) => {
+            let current = mod;
+            for (let i = 0; i < 5; i++) {
+              const defaultExport = current?.default;
+              if (!defaultExport || typeof defaultExport !== "object") break;
+              const namedValues = Object.keys(current).filter((key) => key !== "default").map((key) => current[key]);
+              if (namedValues.length > 0 && namedValues.some((value) => value !== undefined)) break;
+              current = defaultExport;
+            }
+            return current;
+          };`;
 function generateDirectSharedCacheSeedCode(command = "build") {
 	return getOrderedUsedShares().map((pkg) => {
 		const shareItem = getShareItemForPreload(pkg);
@@ -1450,7 +1476,8 @@ function getHostAutoInitSharedSeedItems() {
 		return priority(a.pkg) - priority(b.pkg) || Number(aIsLocal) - Number(bIsLocal) || a.pkg.localeCompare(b.pkg);
 	});
 }
-function generateHostAutoInitSharedCacheSeedCode() {
+function generateHostAutoInitSharedCacheSeedCode(command = "build") {
+	if (command === "build") return "";
 	return getHostAutoInitSharedSeedItems().map(({ pkg, shareItem }) => {
 		if (!shareItem) return null;
 		return generateSharedCacheSeedItem(pkg, getBrowserImportPath(getDirectSharedCacheSeedImportPath(pkg, shareItem)));
@@ -1482,14 +1509,13 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
   if (typeof __VUE_HMR_RUNTIME__ === 'undefined') {
     globalThis.__VUE_HMR_RUNTIME__ = { createRecord() {}, rerender() {}, reload() {} };
   }
-  import {createInstance, loadRemote} from "@module-federation/runtime";
+  import {init as runtimeInit, loadRemote} from "@module-federation/runtime";
   ${pluginImportNames.map((item) => item[1]).join("\n")}
   ${command === "build" ? getRuntimeInitResolveBootstrapCode() : getRuntimeInitBootstrapCode() + "\n  const { initResolve } = globalThis[globalKey];"}
   ${getRuntimeModuleCacheBootstrapCode()}
   const initTokens = {}
   const shareScopeName = ${JSON.stringify(options.shareScope)}
   const mfName = ${JSON.stringify(options.internalName)}
-  let runtimeInstance
   let localSharedImportMapPromise
   let exposesMapPromise
   const shouldRetrySharedInitError = ${command !== "build"} && ((error) => {
@@ -1532,19 +1558,13 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
   async function init(shared = {}, initScope = []) {
     const {usedShared, usedRemotes} = await getLocalSharedImportMap()
     ${generateDirectSharedCacheSeedCode(command)}
-    const runtimeOptions = {
+    const initRes = runtimeInit({
       name: mfName,
       remotes: usedRemotes,
       shared: usedShared,
       plugins: [${pluginImportNames.map((item) => `${item[0]}(${item[2]})`).join(", ")}],
       ${options.shareStrategy ? `shareStrategy: '${options.shareStrategy}'` : ""}
-    };
-    if (!runtimeInstance) {
-      runtimeInstance = createInstance(runtimeOptions);
-    } else {
-      runtimeInstance.initOptions(runtimeOptions);
-    }
-    const initRes = runtimeInstance;
+    });
     // handling circular init calls
     var initToken = initTokens[shareScopeName];
     if (!initToken)
@@ -1564,6 +1584,17 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
     } catch (e) {
       console.error('[Module Federation]', e)
     }
+    for (const [pkg, share] of Object.entries(usedShared)) {
+      if (share.shareConfig?.import !== false || __mfModuleCache.share[pkg] !== undefined) continue;
+      ${normalizeRuntimeShareCode}
+      const versions = shared?.[pkg];
+      const provider = versions && versions[Object.keys(versions)[0]];
+      if (!provider) continue;
+      const factory = provider.lib || (provider.loading ? await provider.loading : await provider.get?.());
+      const mod = typeof factory === "function" ? factory() : factory;
+      const resolved = await Promise.resolve(mod);
+      __mfModuleCache.share[pkg] = __mfNormalizeRuntimeShare(resolved);
+    }
     return initRes
   }
 
@@ -1588,10 +1619,11 @@ function generateHostAutoInitCode(remoteEntryImport, _command = "build") {
     async function initHost() {
       if (!hostInitPromise) {
         hostInitPromise = (async () => {
-          ${generateHostAutoInitSharedCacheSeedCode()}
+          ${generateHostAutoInitSharedCacheSeedCode(_command)}
           const remoteEntry = await import(${remoteEntryImport});
           const runtime = await remoteEntry.init();
           const usedShared = ${generateUsedSharedPreloadConfig()};
+          ${normalizeRuntimeShareCode}
           for (const [pkg, share] of Object.entries(usedShared)) {
             if (__mfModuleCache.share[pkg] !== undefined) {
               continue;
@@ -1601,7 +1633,7 @@ function generateHostAutoInitCode(remoteEntryImport, _command = "build") {
             }).then((factory) => {
               const mod = typeof factory === "function" ? factory() : factory;
               return Promise.resolve(mod).then((resolved) => {
-                __mfModuleCache.share[pkg] = resolved;
+                __mfModuleCache.share[pkg] = __mfNormalizeRuntimeShare(resolved);
               });
             });
           }
@@ -1630,7 +1662,7 @@ function getHostAutoInitImportId() {
 	return hostAutoInitModule.getImportId();
 }
 function getHostAutoInitPath() {
-	return hostAutoInitModule.getPath();
+	return hostAutoInitModule.getImportId();
 }
 //#endregion
 //#region src/virtualModules/virtualRemotes.ts
@@ -1653,7 +1685,9 @@ function getUsedRemotesMap() {
 }
 function generateRemotes(id, command) {
 	const useReactProxy = command === "serve" && hasPackageDependency("react");
-	const reactImportLine = useReactProxy ? `import * as __mfReact from "react";` : "";
+	const reactImportLine = useReactProxy ? `import __mfReactDefault from "react";
+    import * as __mfReactNamespace from "react";
+    const __mfReact = __mfReactDefault ?? __mfReactNamespace.default ?? __mfReactNamespace;` : "";
 	const importLine = command === "build" ? `${getRuntimeModuleCacheBootstrapCode()}
     import { hostInitPromise as __mfHostInitPromise } from ${JSON.stringify(getHostAutoInitPath())};` : `${getRuntimeInitBootstrapCode()}
     const { initPromise, moduleCache: __mfModuleCache } = globalThis[globalKey];`;
@@ -1663,13 +1697,13 @@ function generateRemotes(id, command) {
 }
 export const __moduleExports = exportModule;
 export const __mf_remote_pending = Promise.resolve(exportModule);
-export default exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : command === "build" ? `if (__mfRemotePending) {
+export default exportModule?.__mf_is_remote_proxy ? exportModule : exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : command === "build" ? `if (__mfRemotePending) {
   const mod = await __mfRemotePending;
   if (mod !== undefined) exportModule = mod;
 }
 export const __moduleExports = exportModule;
 export const __mf_remote_pending = Promise.resolve(exportModule);
-export default exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : "export default exportModule";
+export default exportModule?.__mf_is_remote_proxy ? exportModule : exportModule?.__esModule ? exportModule.default : exportModule.default ?? exportModule` : "export default exportModule";
 	return `
     ${reactImportLine}
     ${importLine}
@@ -1869,6 +1903,9 @@ ${importHelper}(async () => {
 		if (inject === "html" && hasPackageDependency("@sveltejs/kit")) return false;
 		return inject === "entry" || !htmlFilePath;
 	}
+	function normalizeDevHtmlProxyId(id) {
+		return id.replace(/^\0/, "").replace(/^\/@id\//, "").replace(/^__x00__/, "");
+	}
 	return [{
 		name: "add-entry",
 		apply: "serve",
@@ -1887,7 +1924,20 @@ ${importHelper}(async () => {
 			}
 		},
 		configureServer(server) {
-			server.middlewares.use((req, _res, next) => {
+			server.middlewares.use((req, res, next) => {
+				const rawUrl = req.url?.split("#")[0] ?? "";
+				if (normalizeDevHtmlProxyId(rawUrl.split("?")[0]) === DEV_HTML_PROXY_PREFIX.slice(0, -1)) {
+					const query = rawUrl.slice(rawUrl.indexOf("?") + 1);
+					const params = new URLSearchParams(query);
+					const initSrc = params.get("init");
+					const entrySrc = params.get("entry");
+					if (initSrc && entrySrc) {
+						res.statusCode = 200;
+						res.setHeader("Content-Type", "application/javascript");
+						res.end(getBootstrapSource(initSrc, entrySrc));
+						return;
+					}
+				}
 				if (!fileName) {
 					next();
 					return;
@@ -1904,7 +1954,7 @@ ${importHelper}(async () => {
 				const base = viteConfig.base.replace(/\/$/, "");
 				const stripBase = (p) => base && p.startsWith(base + "/") ? p.slice(base.length) : p;
 				const html = rewriteEntryScripts(c, (originalSrc) => {
-					return `/@id/${DEV_HTML_PROXY_PREFIX}${new URLSearchParams({
+					return `/@id/__x00__${DEV_HTML_PROXY_PREFIX}${new URLSearchParams({
 						init: sanitizeDevEntryPath(stripBase(devEntryPath)),
 						entry: sanitizeDevEntryPath(stripBase(originalSrc))
 					}).toString()}`;
@@ -1913,11 +1963,12 @@ ${importHelper}(async () => {
 			}
 		},
 		resolveId(id) {
-			if (id.startsWith(DEV_HTML_PROXY_PREFIX)) return id;
+			if (normalizeDevHtmlProxyId(id).startsWith(DEV_HTML_PROXY_PREFIX)) return id;
 		},
 		load(id) {
-			if (!id.startsWith(DEV_HTML_PROXY_PREFIX)) return;
-			const params = new URLSearchParams(id.slice(28));
+			const normalizedId = normalizeDevHtmlProxyId(id);
+			if (!normalizedId.startsWith(DEV_HTML_PROXY_PREFIX)) return;
+			const params = new URLSearchParams(normalizedId.slice(28));
 			const initSrc = params.get("init");
 			const entrySrc = params.get("entry");
 			if (!initSrc || !entrySrc) return;
@@ -2724,7 +2775,7 @@ function collectSystemProxyInfos(proxyChunks, loadShareTag) {
 		for (const m of proxyInfo.code.matchAll(/exports\(\s*["']([^"']+)["']\s*,([\s\S]*?)\);/g)) {
 			const exported = m[1];
 			const expression = m[2];
-			for (const [local, exportName] of Object.entries(loadShareBindings)) if (new RegExp(`\\b${local}\\b`).test(expression)) {
+			for (const [local, exportName] of Object.entries(loadShareBindings).reverse()) if (new RegExp(`\\b${local}\\b`).test(expression)) {
 				exportMap[exported] = {
 					type: "reexport",
 					exportName
@@ -3488,7 +3539,7 @@ function pluginProxyRemotes_default(options) {
 		const remoteModule = getRemoteVirtualModule(source, command);
 		addUsedRemote(remoteName, source);
 		refreshHostAutoInit();
-		return remoteModule.getPath();
+		return remoteModule.getImportId();
 	}
 	return {
 		name: "proxyRemotes",
@@ -3890,7 +3941,7 @@ async function collectFromEsLexer(code, isRemoteImport) {
 	await init;
 	let imports;
 	try {
-		[imports] = parse$1(code);
+		[imports] = parse(code);
 	} catch {
 		return;
 	}
@@ -4310,12 +4361,12 @@ function isFederationHtmlPreloadDependency(dep, includeSharedRuntime = false) {
 	return includeSharedRuntime && (file.includes("preload-helper") || file.includes("rolldown-runtime") || file.startsWith("dist-"));
 }
 /**
-* Plugin that runs FIRST to create virtual module files in the config hook.
-* This prevents 504 "Outdated Optimize Dep" errors by ensuring files exist
+* Plugin that runs FIRST to register generated virtual modules in the config hook.
+* This prevents 504 "Outdated Optimize Dep" errors by ensuring ids are known
 * before Vite's optimization phase.
 */
 function createEarlyVirtualModulesPlugin(options) {
-	const { shared, remotes, virtualModuleDir } = options;
+	const { shared, remotes } = options;
 	const isLitShare = (pkg) => pkg === "lit" || pkg.startsWith("lit/");
 	return {
 		name: "vite:module-federation-early-init",
@@ -4325,9 +4376,6 @@ function createEarlyVirtualModulesPlugin(options) {
 			const root = config.root || process.cwd();
 			setPackageDetectionCwd(root);
 			const isVinext = hasPackageDependency("vinext");
-			initVirtualModuleInfrastructure(root, virtualModuleDir);
-			VirtualModule.setRoot(root);
-			VirtualModule.ensureVirtualPackageExists();
 			initVirtualModules(_command, getRemoteEntryId(options));
 			const isRolldown = getIsRolldown(this);
 			if (remotes && Object.keys(remotes).length > 0) {
@@ -4373,6 +4421,10 @@ function createEarlyVirtualModulesPlugin(options) {
 						optimizeDeps.esbuildOptions.plugins.push({
 							name: "module-federation:optimize-shared-proxy",
 							setup(build) {
+								build.onResolve({ filter: /^virtual:mf:/ }, (args) => ({
+									path: args.path,
+									external: true
+								}));
 								build.onResolve({ filter: /.*/ }, (args) => {
 									if (!args.importer || args.namespace === "mf-shared") return;
 									if (isSharedResolverInternalImporter(args.importer)) return;
@@ -4404,7 +4456,6 @@ export default __mfShared.default ?? __mfShared;`
 							}
 						});
 					}
-					config.optimizeDeps.include.push(virtualRuntimeInitStatus.getImportId());
 				}
 				for (const key of Object.keys(shared)) {
 					const shareItem = shared[key];
@@ -4415,7 +4466,6 @@ export default __mfShared.default ?? __mfShared;`
 							for (const subpath of getCommonSharedSubpaths(key)) {
 								writePreBuildLibPath(subpath, shareItem);
 								optimizeDeps.include.push(subpath);
-								optimizeDeps.include.push(getPreBuildLibImportId(subpath));
 							}
 						}
 						continue;
@@ -4432,14 +4482,11 @@ export default __mfShared.default ?? __mfShared;`
 						const optimizeDeps = config.optimizeDeps ??= {};
 						optimizeDeps.include ??= [];
 						optimizeDeps.exclude ??= [];
-						const shouldBypassOptimizeDep = isLitShare(key);
-						if (shouldBypassOptimizeDep) optimizeDeps.exclude.push(key);
-						if (!isRolldown && !shouldBypassOptimizeDep) optimizeDeps.include.push(getLoadShareImportId(key, isRolldown));
-						optimizeDeps.include.push(getPreBuildLibImportId(key));
+						if (isLitShare(key)) optimizeDeps.exclude.push(key);
+						else optimizeDeps.include.push(key);
 						for (const subpath of getCommonSharedSubpaths(key)) {
 							writePreBuildLibPath(subpath, shareItem);
 							optimizeDeps.include.push(subpath);
-							optimizeDeps.include.push(getPreBuildLibImportId(subpath));
 						}
 					}
 				}
@@ -4459,6 +4506,21 @@ function federation(mfUserOptions) {
 	let command;
 	let desiredRolldownOutput;
 	return [
+		{
+			name: "vite:module-federation-virtual-modules",
+			enforce: "pre",
+			resolveId(id) {
+				const virtualModule = VirtualModule.findById(id);
+				if (!virtualModule) return;
+				return virtualModule.getResolvedId();
+			},
+			load(id) {
+				const virtualModule = VirtualModule.findById(id);
+				if (!virtualModule) return;
+				if (command === "build" && (id.includes("__loadShare__") || id.includes("__loadRemote__"))) return;
+				return virtualModule.code;
+			}
+		},
 		createEarlyVirtualModulesPlugin(options),
 		...isVinext ? [{
 			name: "module-federation-vinext-react-server-build-alias",
@@ -4483,9 +4545,7 @@ function federation(mfUserOptions) {
 			config(_config, env) {
 				command = env.command;
 			},
-			configResolved(config) {
-				VirtualModule.setRoot(config.root);
-				VirtualModule.ensureVirtualPackageExists();
+			configResolved() {
 				initVirtualModules(command, remoteEntryId);
 			}
 		},
@@ -4628,9 +4688,8 @@ function federation(mfUserOptions) {
 				}
 			},
 			load(id) {
-				if (id.startsWith("\0")) return;
 				if (id.includes("__loadShare__") || id.includes("__loadRemote__")) {
-					let code = readFileSync(id, "utf-8");
+					let code = VirtualModule.findById(id)?.code ?? readFileSync(id, "utf-8");
 					code = code.replace(/import\s+["'][^"']*__prebuild__[^"']*["']\s*;?/g, "");
 					code = code.replace(/export\s+\*\s+from\s+["'][^"']*__prebuild__[^"']*["']\s*;?/g, "");
 					/**
@@ -4649,7 +4708,10 @@ function federation(mfUserOptions) {
 					*
 					* @see https://rollupjs.org/plugin-development/#synthetic-named-exports
 					*/
-					if (!code.includes("__moduleExports")) code = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+					if (!/\bexport\s+const\s+__moduleExports\b/.test(code)) {
+						const nextCode = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+						code = nextCode === code ? `${code}\nexport const __moduleExports = exportModule;\n` : nextCode;
+					}
 					if (getIsRolldown(this)) return { code };
 					return {
 						code,
@@ -4714,14 +4776,9 @@ function federation(mfUserOptions) {
 				config.build ||= {};
 				config.build.commonjsOptions ||= {};
 				config.build.commonjsOptions.strictRequires ??= "auto";
-				const virtualDir = options.virtualModuleDir;
 				config.optimizeDeps ||= {};
 				config.optimizeDeps.include ||= [];
 				config.optimizeDeps.include.push("@module-federation/runtime");
-				if (!isRolldown) config.optimizeDeps.include.push(virtualDir);
-				config.ssr ||= {};
-				config.ssr.noExternal ||= [];
-				if (Array.isArray(config.ssr.noExternal)) config.ssr.noExternal.push(virtualDir);
 				options.runtimePlugins.forEach((p) => {
 					const pluginPath = typeof p === "string" ? p : p[0];
 					if (pluginPath && !pluginPath.startsWith(".") && !pluginPath.startsWith("/") && !pluginPath.startsWith("\0") && !pluginPath.startsWith("virtual:")) config.optimizeDeps.include.push(pluginPath);
@@ -4729,9 +4786,6 @@ function federation(mfUserOptions) {
 				if (isRolldown) {
 					config.build ??= {};
 					config.build.target ??= "esnext";
-				} else {
-					config.optimizeDeps.needsInterop ||= [];
-					config.optimizeDeps.needsInterop.push(virtualDir);
 				}
 				const isAstro = hasPackageDependency("astro");
 				const resolvedTarget = options.target ?? (config.build?.ssr ? "node" : "web");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/vite",
-  "version": "1.15.2",
+  "version": "1.15.3",
   "description": "Vite plugin for Module Federation",
   "type": "module",
   "main": "./lib/index.cjs",
@@ -84,6 +84,7 @@
     "oxfmt": "^0.36.0",
     "rollup": "^4.47.1",
     "tsdown": "^0.21.0",
+    "typescript": "5.9.3",
     "vite": "^8.0.10",
     "vitest": "^4.0.18"
   }