@module-federation/vite 1.13.3 → 1.13.5

package/README.md

@@ -23,6 +23,8 @@ This plugin makes Module Federation work together with [Vite](https://vitejs.dev
 
 ### [More examples here](https://github.com/module-federation/vite/tree/main/examples)<br>
 
+Includes a pure runtime host example in [`examples/vite-runtime-register`](./examples/vite-runtime-register).
+
 ## Try this crazy example with all these bundlers together
 
 <img src="./docs/multi-example.png"/>
@@ -168,6 +170,16 @@ const RemoteMFE = defineAsyncComponent( 👈
 </template>
 ```
 
+## ⚠️ `codeSplitting: false` is not supported
+
+Do not set `build.rolldownOptions.output.codeSplitting` to `false` with this plugin — it will be **automatically ignored**.
+Module federation requires chunk splitting to isolate shared dependencies and remote entries into separate chunks.
+
+## ⚠️ `manualChunks` is not supported
+
+Do not use `build.rollupOptions.output.manualChunks` with this plugin — it will be **automatically ignored**.
+Module federation transforms shared dependency imports with top-level `await`, and grouping these transformed modules into a single chunk creates circular async dependencies that cause the application to silently hang.
+
 ### So far so good 🎉
 
 Now you are ready to use Module Federation in Vite!

package/lib/index.cjs

@@ -36,6 +36,7 @@ let _module_federation_dts_plugin = require("@module-federation/dts-plugin");
 let _module_federation_dts_plugin_core = require("@module-federation/dts-plugin/core");
 let node_module = require("node:module");
 let url = require("url");
+let es_module_lexer = require("es-module-lexer");
 //#region src/utils/mapCodeToCodeWithSourcemap.ts
 async function mapCodeToCodeWithSourcemap(code) {
 	const resolvedCode = await code;
@@ -151,7 +152,7 @@ function removePathFromNpmPackage(packageString) {
 	return match ? match[0] : packageString;
 }
 /**
-* Detect whether the current bundler is Rolldown (Vite 8+) by checking
+* Detect whether the current runtime is Vite 8+ (with rolldown internally) by checking
 * for `meta.rolldownVersion` on the plugin hook context.
 */
 function getIsRolldown(ctx) {
@@ -380,15 +381,17 @@ function checkAliasConflicts(options) {
 	};
 }
 //#endregion
-//#region src/plugins/pluginDevProxyModuleTopLevelAwait.ts
-/**
-* Solve the problem that dev mode dependency prebunding does not support top-level await syntax
-*/
+//#region src/utils/loadWalk.ts
 let walkPromise = null;
 function loadWalk() {
 	walkPromise ||= import("estree-walker").then(({ walk }) => walk);
 	return walkPromise;
 }
+//#endregion
+//#region src/plugins/pluginDevProxyModuleTopLevelAwait.ts
+/**
+* Solve the problem that dev mode dependency prebunding does not support top-level await syntax
+*/
 function PluginDevProxyModuleTopLevelAwait() {
 	const filterFunction = (0, _rollup_pluginutils.createFilter)();
 	const processedFlag = "/* already-processed-by-dev-proxy-module-top-level-await */";
@@ -746,7 +749,7 @@ function inferVersionFromRequiredVersion(requiredVersion) {
 }
 function normalizeShareItem(key, shareItem) {
 	let version;
-	try {
+	if (!(typeof shareItem === "object" && shareItem.import === false)) try {
 		try {
 			version = require(pathe.join(removePathFromNpmPackage(key), "package.json")).version;
 		} catch (e1) {
@@ -1197,7 +1200,7 @@ function generateRemotes(id, command, isRolldown) {
 	const importLine = command === "build" ? getRuntimeInitPromiseBootstrapCode() : useESM ? `${getRuntimeInitBootstrapCode()}
     const { initPromise } = globalThis[globalKey];` : `const {initPromise} = require("${virtualRuntimeInitStatus.getImportId()}")`;
 	const awaitOrPlaceholder = useESM ? "await " : "/*mf top-level-await placeholder replacement mf*/";
-	const exportLine = command === "serve" && useESM ? "export default exportModule.default ?? exportModule" : useESM ? "export default exportModule" : "module.exports = exportModule";
+	const exportLine = command === "serve" && useESM ? "export const __moduleExports = exportModule;\nexport default exportModule.default ?? exportModule" : useESM ? "export default exportModule" : "module.exports = exportModule";
 	return `
     ${importLine}
     const res = initPromise.then(runtime => runtime.loadRemote(${JSON.stringify(id)}))
@@ -1386,6 +1389,28 @@ function writeLoadShareModule(pkg, shareItem, command, isRolldown) {
 	const importLine = command === "build" ? getRuntimeInitPromiseBootstrapCode() : useESM ? `${getRuntimeInitBootstrapCode()}
     const { initPromise } = globalThis[globalKey];` : `const {initPromise} = require("${virtualRuntimeInitStatus.getImportId()}")`;
 	const awaitOrPlaceholder = useESM ? "await " : "/*mf top-level-await placeholder replacement mf*/";
+	if (shareItem.shareConfig.import === false) {
+		const namedExports = useESM ? getPackageNamedExports(pkg) : [];
+		let exportLine;
+		if (useESM && 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 (useESM) 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 = useESM ? "export default exportModule.default ?? exportModule" : "module.exports = exportModule";
+		}
+		loadShareCacheMap[pkg].writeSync(`
+    ${importLine}
+    const res = initPromise.then(runtime => runtime.loadShare(${escapeGeneratedStringLiteral(pkg)}, {
+      customShareInfo: {shareConfig:{
+        singleton: ${shareItem.shareConfig.singleton},
+        strictVersion: ${shareItem.shareConfig.strictVersion},
+        requiredVersion: ${JSON.stringify(shareItem.shareConfig.requiredVersion)}
+      }}
+    }))
+    const exportModule = ${awaitOrPlaceholder}res.then((factory) => (typeof factory === "function" ? factory() : factory))
+    ${exportLine}
+  `, true);
+		return;
+	}
 	const useSsrProviderFallback = hasPackageDependency("vinext") && command === "build" && pkg === "react";
 	const concreteSharedImportSource = getConcreteSharedImportSource(pkg, shareItem);
 	const sharedImportSource = concreteSharedImportSource || getPreBuildLibImportId(pkg);
@@ -1533,6 +1558,14 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
 		];
 	});
 	return `
+  // Shim Vue HMR runtime for dev-compiled components loaded by a non-Vite host.
+  // When a remote is served by a Vite dev server, Vue's SFC compiler injects HMR
+  // hooks that reference __VUE_HMR_RUNTIME__. This global only exists on pages
+  // served by Vite's client runtime. When a production host loads the remote,
+  // the HMR calls would throw. This no-op shim prevents that.
+  if (typeof __VUE_HMR_RUNTIME__ === 'undefined') {
+    globalThis.__VUE_HMR_RUNTIME__ = { createRecord() {}, rerender() {}, reload() {} };
+  }
   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];"}
@@ -2203,6 +2236,265 @@ function pluginProxyRemotes_default(options) {
 	};
 }
 //#endregion
+//#region src/plugins/pluginRemoteNamedExports.ts
+/**
+* Transforms consumer-side imports of remote modules so that named exports
+* are accessible even when the bundler does not support syntheticNamedExports
+* (Rolldown / Vite 8+).
+*
+* The remote proxy module exports:
+*   export const __moduleExports = exportModule;   // full namespace
+*   export default exportModule.default ?? exportModule;  // unwrapped default
+*
+* This plugin rewrites consumer code:
+*   import { foo } from "remote/xxx"
+*     → import { __moduleExports as __mf_ns_0 } from "remote/xxx"; const { foo } = __mf_ns_0;
+*
+*   import("remote/xxx")
+*     → import("remote/xxx").then(…)  // spreads __moduleExports into namespace
+*
+* NOTE: `export * from "remote/xxx"` is not supported — Rolldown cannot
+* statically resolve the set of exported names from a federated remote at
+* build time.  Use explicit named re-exports instead.
+*/
+const JS_EXTENSIONS_RE = /\.(?:[mc]?[jt]sx?|vue|svelte)(?:\?|$)/;
+function wrapDynamicImport(original) {
+	return `${original}.then(function(__mf_m__) {\n  if (!__mf_m__ || !__mf_m__.__moduleExports) return __mf_m__;\n  var __mf_ns__ = Object.create(null);\n  Object.defineProperty(__mf_ns__, Symbol.toStringTag, { value: "Module" });\n  var __mf_e__ = __mf_m__.__moduleExports;\n  Object.keys(__mf_e__).forEach(function(k) { if (k !== "__esModule") __mf_ns__[k] = __mf_e__[k] });\n  if ("default" in __mf_m__) __mf_ns__.default = __mf_m__.default;\n  return __mf_ns__;\n})`;
+}
+function applyRewrites(code, imports, id) {
+	if (imports.length === 0) return;
+	const ms = new magic_string.default(code);
+	let changed = false;
+	let counter = 0;
+	for (const imp of imports) switch (imp.kind) {
+		case "static": {
+			const src = JSON.stringify(imp.source);
+			if (imp.namespaceLocal && !imp.defaultLocal && imp.named.length === 0) ms.overwrite(imp.start, imp.end, `import { __moduleExports as ${imp.namespaceLocal} } from ${src};`);
+			else {
+				const nsId = `__mf_ns_${counter++}`;
+				const importParts = [];
+				if (imp.defaultLocal) importParts.push(`default as ${imp.defaultLocal}`);
+				importParts.push(`__moduleExports as ${nsId}`);
+				const destructParts = imp.named.map((s) => s.imported === s.local ? s.local : `${s.imported}: ${s.local}`);
+				let rewrite = `import { ${importParts.join(", ")} } from ${src};`;
+				if (destructParts.length > 0) rewrite += `\nconst { ${destructParts.join(", ")} } = ${nsId};`;
+				ms.overwrite(imp.start, imp.end, rewrite);
+			}
+			changed = true;
+			break;
+		}
+		case "reexport": {
+			const src = JSON.stringify(imp.source);
+			const nsId = `__mf_ns_${counter++}`;
+			const vars = imp.specifiers.map((s) => {
+				const tmp = `__mf_re_${counter++}`;
+				return {
+					...s,
+					tmp
+				};
+			});
+			const importLine = `import { __moduleExports as ${nsId} } from ${src};`;
+			const varLines = vars.map((v) => `const ${v.tmp} = ${nsId}[${JSON.stringify(v.local)}];`).join("\n");
+			const exportLine = `export { ${vars.map((v) => `${v.tmp} as ${v.exported}`).join(", ")} };`;
+			ms.overwrite(imp.start, imp.end, `${importLine}\n${varLines}\n${exportLine}`);
+			changed = true;
+			break;
+		}
+		case "export-all":
+			console.warn(`[module-federation] "export * from '${imp.source}'" is not supported with Rolldown — use explicit named re-exports instead. (${id})`);
+			break;
+		case "dynamic":
+			ms.overwrite(imp.start, imp.end, wrapDynamicImport(imp.originalText));
+			changed = true;
+			break;
+	}
+	if (!changed) return;
+	return {
+		code: ms.toString(),
+		map: ms.generateMap({ hires: true })
+	};
+}
+async function collectFromAST(ast, code, isRemoteImport) {
+	const walk = await loadWalk();
+	const result = [];
+	walk(ast, { enter(node) {
+		if (node.type === "ImportDeclaration" && node.source?.value) {
+			if (!isRemoteImport(node.source.value)) return;
+			const specifiers = node.specifiers || [];
+			const named = specifiers.filter((s) => s.type === "ImportSpecifier" && s.importKind !== "type").map((s) => ({
+				imported: s.imported.name ?? s.imported.value,
+				local: s.local.name
+			}));
+			const defaultSpec = specifiers.find((s) => s.type === "ImportDefaultSpecifier");
+			const nsSpec = specifiers.find((s) => s.type === "ImportNamespaceSpecifier");
+			if (named.length === 0 && !nsSpec) return;
+			result.push({
+				kind: "static",
+				source: node.source.value,
+				start: node.start,
+				end: node.end,
+				named,
+				defaultLocal: defaultSpec?.local.name,
+				namespaceLocal: nsSpec?.local.name
+			});
+		}
+		if (node.type === "ExportNamedDeclaration" && node.source?.value && isRemoteImport(node.source.value)) {
+			const specifiers = (node.specifiers || []).filter((s) => s.exportKind !== "type").map((s) => ({
+				local: s.local.name ?? s.local.value,
+				exported: s.exported.name ?? s.exported.value
+			}));
+			if (specifiers.length === 0) return;
+			result.push({
+				kind: "reexport",
+				source: node.source.value,
+				start: node.start,
+				end: node.end,
+				specifiers
+			});
+		}
+		if (node.type === "ExportAllDeclaration" && node.source?.value && isRemoteImport(node.source.value)) {
+			this.skip();
+			result.push({
+				kind: "export-all",
+				source: node.source.value,
+				start: node.start,
+				end: node.end
+			});
+		}
+		if (node.type === "ImportExpression") {
+			const source = node.source;
+			if (source.type !== "Literal" && source.type !== "StringLiteral" && source.type !== "TemplateLiteral") return;
+			const value = source.type === "TemplateLiteral" ? source.quasis?.length === 1 ? source.quasis[0].value?.cooked : void 0 : source.value;
+			if (!value || !isRemoteImport(value)) return;
+			result.push({
+				kind: "dynamic",
+				start: node.start,
+				end: node.end,
+				originalText: code.slice(node.start, node.end)
+			});
+		}
+	} });
+	return result;
+}
+async function collectFromEsLexer(code, isRemoteImport) {
+	await es_module_lexer.init;
+	let imports;
+	try {
+		[imports] = (0, es_module_lexer.parse)(code);
+	} catch {
+		return;
+	}
+	const result = [];
+	for (const imp of imports) {
+		if (imp.d === -2) continue;
+		if (!imp.n || !isRemoteImport(imp.n)) continue;
+		const stmtText = code.slice(imp.ss, imp.se);
+		if (imp.d >= 0) {
+			result.push({
+				kind: "dynamic",
+				start: imp.ss,
+				end: imp.se,
+				originalText: stmtText
+			});
+			continue;
+		}
+		if (/^\s*export\s*\*\s/.test(stmtText)) {
+			result.push({
+				kind: "export-all",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se
+			});
+			continue;
+		}
+		if (/^\s*export\s/.test(stmtText)) {
+			const braceMatch = stmtText.match(/\{([^}]*)\}/);
+			if (!braceMatch) continue;
+			const specs = braceMatch[1].split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+			if (specs.length === 0) continue;
+			const specifiers = specs.map((s) => {
+				const asMatch = s.match(/^(\w+)\s+as\s+(\w+)$/);
+				return {
+					local: asMatch ? asMatch[1] : s,
+					exported: asMatch ? asMatch[2] : s
+				};
+			});
+			result.push({
+				kind: "reexport",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se,
+				specifiers
+			});
+			continue;
+		}
+		const importMatch = stmtText.match(/^import\s+([\s\S]*?)\s+from\s/);
+		if (!importMatch) continue;
+		const specifiersPart = importMatch[1].trim();
+		if (/^type\s/.test(specifiersPart)) continue;
+		const nsMatch = specifiersPart.match(/^\*\s+as\s+(\w+)$/);
+		if (nsMatch) {
+			result.push({
+				kind: "static",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se,
+				named: [],
+				namespaceLocal: nsMatch[1]
+			});
+			continue;
+		}
+		const braceMatch = specifiersPart.match(/\{([^}]*)\}/);
+		if (!braceMatch) continue;
+		const namedSpecifiers = braceMatch[1].split(",").map((s) => s.trim()).filter((s) => s.length > 0 && !s.startsWith("type "));
+		if (namedSpecifiers.length === 0) continue;
+		const defaultMatch = specifiersPart.match(/^(\w+)\s*,/);
+		const named = namedSpecifiers.map((s) => {
+			const asMatch = s.match(/^(\w+)\s+as\s+(\w+)$/);
+			return {
+				imported: asMatch ? asMatch[1] : s,
+				local: asMatch ? asMatch[2] : s
+			};
+		});
+		result.push({
+			kind: "static",
+			source: imp.n,
+			start: imp.ss,
+			end: imp.se,
+			named,
+			defaultLocal: defaultMatch?.[1]
+		});
+	}
+	return result;
+}
+function pluginRemoteNamedExports(options) {
+	const remoteNames = Object.keys(options.remotes);
+	let rolldown;
+	function isRemoteImport(source) {
+		return remoteNames.some((name) => source === name || source.startsWith(name + "/"));
+	}
+	return {
+		name: "module-federation-remote-named-exports",
+		enforce: "pre",
+		async transform(code, id) {
+			rolldown ??= getIsRolldown(this);
+			if (!rolldown) return;
+			if (remoteNames.length === 0) return;
+			if (id.includes("__loadRemote__") || id.includes("__loadShare__")) return;
+			if (!JS_EXTENSIONS_RE.test(id)) return;
+			if (!remoteNames.some((name) => code.includes(name))) return;
+			let imports;
+			try {
+				imports = await collectFromAST(this.parse(code), code, isRemoteImport);
+			} catch {
+				imports = await collectFromEsLexer(code, isRemoteImport);
+			}
+			if (!imports) return;
+			return applyRewrites(code, imports, id);
+		}
+	};
+}
+//#endregion
 //#region src/utils/PromiseStore.ts
 /**
 * example:
@@ -2278,7 +2570,7 @@ function proxySharedModule(options) {
 						if (key.endsWith("/") && source !== key.slice(0, -1)) return;
 						const loadSharePath = getLoadShareModulePath(source, isRolldown, command);
 						writeLoadShareModule(source, shared[key], command, isRolldown);
-						writePreBuildLibPath(source, shared[key]);
+						if (shared[key].shareConfig.import !== false) writePreBuildLibPath(source, shared[key]);
 						addUsedShares(source);
 						writeLocalSharedImportMap();
 						return this.resolve(loadSharePath, importer);
@@ -2309,7 +2601,7 @@ function proxySharedModule(options) {
 		},
 		configResolved(config) {
 			_config = config;
-			const isRolldown = !!config.experimental?.rolldownDev;
+			const isRolldown = getIsRolldown(this);
 			Object.keys(shared).forEach((key) => {
 				if (key.endsWith("/")) return;
 				if (isVinext && key === "react") {
@@ -2317,7 +2609,7 @@ function proxySharedModule(options) {
 					return;
 				}
 				writeLoadShareModule(key, shared[key], _command, isRolldown);
-				writePreBuildLibPath(key, shared[key]);
+				if (shared[key].shareConfig.import !== false) writePreBuildLibPath(key, shared[key]);
 				addUsedShares(key);
 			});
 			writeLocalSharedImportMap();
@@ -2545,9 +2837,9 @@ function createEarlyVirtualModulesPlugin(options) {
 					}
 					getLoadShareModulePath(key, isRolldown);
 					writeLoadShareModule(key, shareItem, _command, isRolldown);
-					writePreBuildLibPath(key, shareItem);
+					if (shareItem.shareConfig?.import !== false) writePreBuildLibPath(key, shareItem);
 					addUsedShares(key);
-					if (_command === "serve") {
+					if (_command === "serve" && shareItem.shareConfig?.import !== false) {
 						if (!isRolldown) config.optimizeDeps.include.push(getLoadShareImportId(key, isRolldown, _command));
 						config.optimizeDeps.include.push(getPreBuildLibImportId(key));
 					}
@@ -2620,6 +2912,7 @@ function federation(mfUserOptions) {
 			virtualExposesId
 		}),
 		pluginProxyRemotes_default(options),
+		pluginRemoteNamedExports(options),
 		...pluginModuleParseEnd_default((id) => {
 			return id.includes(getHostAutoInitImportId()) || id.includes(remoteEntryId) || id.includes(virtualExposesId) || id.includes(getLocalSharedImportMapPath());
 		}, {
@@ -2655,19 +2948,19 @@ function federation(mfUserOptions) {
 					warnedAboutCodeSplitting = true;
 					mfWarn("Ignoring `build.rolldownOptions.output.codeSplitting = false` because module federation requires chunk splitting.");
 				};
+				let warnedAboutManualChunks = false;
 				const applyManualChunks = (output) => {
 					ensureCodeSplitting(output);
-					const existingManualChunks = output.manualChunks;
+					if (output.manualChunks && !warnedAboutManualChunks) {
+						warnedAboutManualChunks = true;
+						mfWarn("Ignoring `build.rollupOptions.output.manualChunks` because it conflicts with module federation. Module federation transforms shared dependency imports with top-level await, and grouping these transformed modules into a single chunk creates circular async dependencies that cause the application to silently hang.");
+					}
 					output.manualChunks = function(id) {
 						if (id.includes(runtimeInitId)) return "runtimeInit";
 						if (id.includes("__loadShare__")) {
 							const match = id.match(/([^/\\]+__loadShare__[^/\\]+)/);
 							return match ? match[1] : "loadShare";
 						}
-						if (typeof existingManualChunks === "function") return existingManualChunks.apply(this, arguments);
-						if (existingManualChunks && typeof existingManualChunks === "object") {
-							for (const [key, ids] of Object.entries(existingManualChunks)) if (Array.isArray(ids) && ids.some((v) => id.includes(v))) return key;
-						}
 					};
 				};
 				config.build.rollupOptions = config.build.rollupOptions || {};
@@ -2699,6 +2992,7 @@ function federation(mfUserOptions) {
 					* @see https://rollupjs.org/plugin-development/#synthetic-named-exports
 					*/
 					code = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+					if (getIsRolldown(this)) return { code };
 					return {
 						code,
 						syntheticNamedExports: "__moduleExports"

package/lib/index.mjs

@@ -11,6 +11,7 @@ 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";
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -129,7 +130,7 @@ function removePathFromNpmPackage(packageString) {
 	return match ? match[0] : packageString;
 }
 /**
-* Detect whether the current bundler is Rolldown (Vite 8+) by checking
+* Detect whether the current runtime is Vite 8+ (with rolldown internally) by checking
 * for `meta.rolldownVersion` on the plugin hook context.
 */
 function getIsRolldown(ctx) {
@@ -358,15 +359,17 @@ function checkAliasConflicts(options) {
 	};
 }
 //#endregion
-//#region src/plugins/pluginDevProxyModuleTopLevelAwait.ts
-/**
-* Solve the problem that dev mode dependency prebunding does not support top-level await syntax
-*/
+//#region src/utils/loadWalk.ts
 let walkPromise = null;
 function loadWalk() {
 	walkPromise ||= import("estree-walker").then(({ walk }) => walk);
 	return walkPromise;
 }
+//#endregion
+//#region src/plugins/pluginDevProxyModuleTopLevelAwait.ts
+/**
+* Solve the problem that dev mode dependency prebunding does not support top-level await syntax
+*/
 function PluginDevProxyModuleTopLevelAwait() {
 	const filterFunction = createFilter();
 	const processedFlag = "/* already-processed-by-dev-proxy-module-top-level-await */";
@@ -724,7 +727,7 @@ function inferVersionFromRequiredVersion(requiredVersion) {
 }
 function normalizeShareItem(key, shareItem) {
 	let version;
-	try {
+	if (!(typeof shareItem === "object" && shareItem.import === false)) try {
 		try {
 			version = __require(path$1.join(removePathFromNpmPackage(key), "package.json")).version;
 		} catch (e1) {
@@ -1174,7 +1177,7 @@ function generateRemotes(id, command, isRolldown) {
 	const importLine = command === "build" ? getRuntimeInitPromiseBootstrapCode() : useESM ? `${getRuntimeInitBootstrapCode()}
     const { initPromise } = globalThis[globalKey];` : `const {initPromise} = require("${virtualRuntimeInitStatus.getImportId()}")`;
 	const awaitOrPlaceholder = useESM ? "await " : "/*mf top-level-await placeholder replacement mf*/";
-	const exportLine = command === "serve" && useESM ? "export default exportModule.default ?? exportModule" : useESM ? "export default exportModule" : "module.exports = exportModule";
+	const exportLine = command === "serve" && useESM ? "export const __moduleExports = exportModule;\nexport default exportModule.default ?? exportModule" : useESM ? "export default exportModule" : "module.exports = exportModule";
 	return `
     ${importLine}
     const res = initPromise.then(runtime => runtime.loadRemote(${JSON.stringify(id)}))
@@ -1363,6 +1366,28 @@ function writeLoadShareModule(pkg, shareItem, command, isRolldown) {
 	const importLine = command === "build" ? getRuntimeInitPromiseBootstrapCode() : useESM ? `${getRuntimeInitBootstrapCode()}
     const { initPromise } = globalThis[globalKey];` : `const {initPromise} = require("${virtualRuntimeInitStatus.getImportId()}")`;
 	const awaitOrPlaceholder = useESM ? "await " : "/*mf top-level-await placeholder replacement mf*/";
+	if (shareItem.shareConfig.import === false) {
+		const namedExports = useESM ? getPackageNamedExports(pkg) : [];
+		let exportLine;
+		if (useESM && 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 (useESM) 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 = useESM ? "export default exportModule.default ?? exportModule" : "module.exports = exportModule";
+		}
+		loadShareCacheMap[pkg].writeSync(`
+    ${importLine}
+    const res = initPromise.then(runtime => runtime.loadShare(${escapeGeneratedStringLiteral(pkg)}, {
+      customShareInfo: {shareConfig:{
+        singleton: ${shareItem.shareConfig.singleton},
+        strictVersion: ${shareItem.shareConfig.strictVersion},
+        requiredVersion: ${JSON.stringify(shareItem.shareConfig.requiredVersion)}
+      }}
+    }))
+    const exportModule = ${awaitOrPlaceholder}res.then((factory) => (typeof factory === "function" ? factory() : factory))
+    ${exportLine}
+  `, true);
+		return;
+	}
 	const useSsrProviderFallback = hasPackageDependency("vinext") && command === "build" && pkg === "react";
 	const concreteSharedImportSource = getConcreteSharedImportSource(pkg, shareItem);
 	const sharedImportSource = concreteSharedImportSource || getPreBuildLibImportId(pkg);
@@ -1510,6 +1535,14 @@ function generateRemoteEntry(options, virtualExposesId = getVirtualExposesId(opt
 		];
 	});
 	return `
+  // Shim Vue HMR runtime for dev-compiled components loaded by a non-Vite host.
+  // When a remote is served by a Vite dev server, Vue's SFC compiler injects HMR
+  // hooks that reference __VUE_HMR_RUNTIME__. This global only exists on pages
+  // served by Vite's client runtime. When a production host loads the remote,
+  // the HMR calls would throw. This no-op shim prevents that.
+  if (typeof __VUE_HMR_RUNTIME__ === 'undefined') {
+    globalThis.__VUE_HMR_RUNTIME__ = { createRecord() {}, rerender() {}, reload() {} };
+  }
   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];"}
@@ -2180,6 +2213,265 @@ function pluginProxyRemotes_default(options) {
 	};
 }
 //#endregion
+//#region src/plugins/pluginRemoteNamedExports.ts
+/**
+* Transforms consumer-side imports of remote modules so that named exports
+* are accessible even when the bundler does not support syntheticNamedExports
+* (Rolldown / Vite 8+).
+*
+* The remote proxy module exports:
+*   export const __moduleExports = exportModule;   // full namespace
+*   export default exportModule.default ?? exportModule;  // unwrapped default
+*
+* This plugin rewrites consumer code:
+*   import { foo } from "remote/xxx"
+*     → import { __moduleExports as __mf_ns_0 } from "remote/xxx"; const { foo } = __mf_ns_0;
+*
+*   import("remote/xxx")
+*     → import("remote/xxx").then(…)  // spreads __moduleExports into namespace
+*
+* NOTE: `export * from "remote/xxx"` is not supported — Rolldown cannot
+* statically resolve the set of exported names from a federated remote at
+* build time.  Use explicit named re-exports instead.
+*/
+const JS_EXTENSIONS_RE = /\.(?:[mc]?[jt]sx?|vue|svelte)(?:\?|$)/;
+function wrapDynamicImport(original) {
+	return `${original}.then(function(__mf_m__) {\n  if (!__mf_m__ || !__mf_m__.__moduleExports) return __mf_m__;\n  var __mf_ns__ = Object.create(null);\n  Object.defineProperty(__mf_ns__, Symbol.toStringTag, { value: "Module" });\n  var __mf_e__ = __mf_m__.__moduleExports;\n  Object.keys(__mf_e__).forEach(function(k) { if (k !== "__esModule") __mf_ns__[k] = __mf_e__[k] });\n  if ("default" in __mf_m__) __mf_ns__.default = __mf_m__.default;\n  return __mf_ns__;\n})`;
+}
+function applyRewrites(code, imports, id) {
+	if (imports.length === 0) return;
+	const ms = new MagicString(code);
+	let changed = false;
+	let counter = 0;
+	for (const imp of imports) switch (imp.kind) {
+		case "static": {
+			const src = JSON.stringify(imp.source);
+			if (imp.namespaceLocal && !imp.defaultLocal && imp.named.length === 0) ms.overwrite(imp.start, imp.end, `import { __moduleExports as ${imp.namespaceLocal} } from ${src};`);
+			else {
+				const nsId = `__mf_ns_${counter++}`;
+				const importParts = [];
+				if (imp.defaultLocal) importParts.push(`default as ${imp.defaultLocal}`);
+				importParts.push(`__moduleExports as ${nsId}`);
+				const destructParts = imp.named.map((s) => s.imported === s.local ? s.local : `${s.imported}: ${s.local}`);
+				let rewrite = `import { ${importParts.join(", ")} } from ${src};`;
+				if (destructParts.length > 0) rewrite += `\nconst { ${destructParts.join(", ")} } = ${nsId};`;
+				ms.overwrite(imp.start, imp.end, rewrite);
+			}
+			changed = true;
+			break;
+		}
+		case "reexport": {
+			const src = JSON.stringify(imp.source);
+			const nsId = `__mf_ns_${counter++}`;
+			const vars = imp.specifiers.map((s) => {
+				const tmp = `__mf_re_${counter++}`;
+				return {
+					...s,
+					tmp
+				};
+			});
+			const importLine = `import { __moduleExports as ${nsId} } from ${src};`;
+			const varLines = vars.map((v) => `const ${v.tmp} = ${nsId}[${JSON.stringify(v.local)}];`).join("\n");
+			const exportLine = `export { ${vars.map((v) => `${v.tmp} as ${v.exported}`).join(", ")} };`;
+			ms.overwrite(imp.start, imp.end, `${importLine}\n${varLines}\n${exportLine}`);
+			changed = true;
+			break;
+		}
+		case "export-all":
+			console.warn(`[module-federation] "export * from '${imp.source}'" is not supported with Rolldown — use explicit named re-exports instead. (${id})`);
+			break;
+		case "dynamic":
+			ms.overwrite(imp.start, imp.end, wrapDynamicImport(imp.originalText));
+			changed = true;
+			break;
+	}
+	if (!changed) return;
+	return {
+		code: ms.toString(),
+		map: ms.generateMap({ hires: true })
+	};
+}
+async function collectFromAST(ast, code, isRemoteImport) {
+	const walk = await loadWalk();
+	const result = [];
+	walk(ast, { enter(node) {
+		if (node.type === "ImportDeclaration" && node.source?.value) {
+			if (!isRemoteImport(node.source.value)) return;
+			const specifiers = node.specifiers || [];
+			const named = specifiers.filter((s) => s.type === "ImportSpecifier" && s.importKind !== "type").map((s) => ({
+				imported: s.imported.name ?? s.imported.value,
+				local: s.local.name
+			}));
+			const defaultSpec = specifiers.find((s) => s.type === "ImportDefaultSpecifier");
+			const nsSpec = specifiers.find((s) => s.type === "ImportNamespaceSpecifier");
+			if (named.length === 0 && !nsSpec) return;
+			result.push({
+				kind: "static",
+				source: node.source.value,
+				start: node.start,
+				end: node.end,
+				named,
+				defaultLocal: defaultSpec?.local.name,
+				namespaceLocal: nsSpec?.local.name
+			});
+		}
+		if (node.type === "ExportNamedDeclaration" && node.source?.value && isRemoteImport(node.source.value)) {
+			const specifiers = (node.specifiers || []).filter((s) => s.exportKind !== "type").map((s) => ({
+				local: s.local.name ?? s.local.value,
+				exported: s.exported.name ?? s.exported.value
+			}));
+			if (specifiers.length === 0) return;
+			result.push({
+				kind: "reexport",
+				source: node.source.value,
+				start: node.start,
+				end: node.end,
+				specifiers
+			});
+		}
+		if (node.type === "ExportAllDeclaration" && node.source?.value && isRemoteImport(node.source.value)) {
+			this.skip();
+			result.push({
+				kind: "export-all",
+				source: node.source.value,
+				start: node.start,
+				end: node.end
+			});
+		}
+		if (node.type === "ImportExpression") {
+			const source = node.source;
+			if (source.type !== "Literal" && source.type !== "StringLiteral" && source.type !== "TemplateLiteral") return;
+			const value = source.type === "TemplateLiteral" ? source.quasis?.length === 1 ? source.quasis[0].value?.cooked : void 0 : source.value;
+			if (!value || !isRemoteImport(value)) return;
+			result.push({
+				kind: "dynamic",
+				start: node.start,
+				end: node.end,
+				originalText: code.slice(node.start, node.end)
+			});
+		}
+	} });
+	return result;
+}
+async function collectFromEsLexer(code, isRemoteImport) {
+	await init;
+	let imports;
+	try {
+		[imports] = parse$1(code);
+	} catch {
+		return;
+	}
+	const result = [];
+	for (const imp of imports) {
+		if (imp.d === -2) continue;
+		if (!imp.n || !isRemoteImport(imp.n)) continue;
+		const stmtText = code.slice(imp.ss, imp.se);
+		if (imp.d >= 0) {
+			result.push({
+				kind: "dynamic",
+				start: imp.ss,
+				end: imp.se,
+				originalText: stmtText
+			});
+			continue;
+		}
+		if (/^\s*export\s*\*\s/.test(stmtText)) {
+			result.push({
+				kind: "export-all",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se
+			});
+			continue;
+		}
+		if (/^\s*export\s/.test(stmtText)) {
+			const braceMatch = stmtText.match(/\{([^}]*)\}/);
+			if (!braceMatch) continue;
+			const specs = braceMatch[1].split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+			if (specs.length === 0) continue;
+			const specifiers = specs.map((s) => {
+				const asMatch = s.match(/^(\w+)\s+as\s+(\w+)$/);
+				return {
+					local: asMatch ? asMatch[1] : s,
+					exported: asMatch ? asMatch[2] : s
+				};
+			});
+			result.push({
+				kind: "reexport",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se,
+				specifiers
+			});
+			continue;
+		}
+		const importMatch = stmtText.match(/^import\s+([\s\S]*?)\s+from\s/);
+		if (!importMatch) continue;
+		const specifiersPart = importMatch[1].trim();
+		if (/^type\s/.test(specifiersPart)) continue;
+		const nsMatch = specifiersPart.match(/^\*\s+as\s+(\w+)$/);
+		if (nsMatch) {
+			result.push({
+				kind: "static",
+				source: imp.n,
+				start: imp.ss,
+				end: imp.se,
+				named: [],
+				namespaceLocal: nsMatch[1]
+			});
+			continue;
+		}
+		const braceMatch = specifiersPart.match(/\{([^}]*)\}/);
+		if (!braceMatch) continue;
+		const namedSpecifiers = braceMatch[1].split(",").map((s) => s.trim()).filter((s) => s.length > 0 && !s.startsWith("type "));
+		if (namedSpecifiers.length === 0) continue;
+		const defaultMatch = specifiersPart.match(/^(\w+)\s*,/);
+		const named = namedSpecifiers.map((s) => {
+			const asMatch = s.match(/^(\w+)\s+as\s+(\w+)$/);
+			return {
+				imported: asMatch ? asMatch[1] : s,
+				local: asMatch ? asMatch[2] : s
+			};
+		});
+		result.push({
+			kind: "static",
+			source: imp.n,
+			start: imp.ss,
+			end: imp.se,
+			named,
+			defaultLocal: defaultMatch?.[1]
+		});
+	}
+	return result;
+}
+function pluginRemoteNamedExports(options) {
+	const remoteNames = Object.keys(options.remotes);
+	let rolldown;
+	function isRemoteImport(source) {
+		return remoteNames.some((name) => source === name || source.startsWith(name + "/"));
+	}
+	return {
+		name: "module-federation-remote-named-exports",
+		enforce: "pre",
+		async transform(code, id) {
+			rolldown ??= getIsRolldown(this);
+			if (!rolldown) return;
+			if (remoteNames.length === 0) return;
+			if (id.includes("__loadRemote__") || id.includes("__loadShare__")) return;
+			if (!JS_EXTENSIONS_RE.test(id)) return;
+			if (!remoteNames.some((name) => code.includes(name))) return;
+			let imports;
+			try {
+				imports = await collectFromAST(this.parse(code), code, isRemoteImport);
+			} catch {
+				imports = await collectFromEsLexer(code, isRemoteImport);
+			}
+			if (!imports) return;
+			return applyRewrites(code, imports, id);
+		}
+	};
+}
+//#endregion
 //#region src/utils/PromiseStore.ts
 /**
 * example:
@@ -2255,7 +2547,7 @@ function proxySharedModule(options) {
 						if (key.endsWith("/") && source !== key.slice(0, -1)) return;
 						const loadSharePath = getLoadShareModulePath(source, isRolldown, command);
 						writeLoadShareModule(source, shared[key], command, isRolldown);
-						writePreBuildLibPath(source, shared[key]);
+						if (shared[key].shareConfig.import !== false) writePreBuildLibPath(source, shared[key]);
 						addUsedShares(source);
 						writeLocalSharedImportMap();
 						return this.resolve(loadSharePath, importer);
@@ -2286,7 +2578,7 @@ function proxySharedModule(options) {
 		},
 		configResolved(config) {
 			_config = config;
-			const isRolldown = !!config.experimental?.rolldownDev;
+			const isRolldown = getIsRolldown(this);
 			Object.keys(shared).forEach((key) => {
 				if (key.endsWith("/")) return;
 				if (isVinext && key === "react") {
@@ -2294,7 +2586,7 @@ function proxySharedModule(options) {
 					return;
 				}
 				writeLoadShareModule(key, shared[key], _command, isRolldown);
-				writePreBuildLibPath(key, shared[key]);
+				if (shared[key].shareConfig.import !== false) writePreBuildLibPath(key, shared[key]);
 				addUsedShares(key);
 			});
 			writeLocalSharedImportMap();
@@ -2522,9 +2814,9 @@ function createEarlyVirtualModulesPlugin(options) {
 					}
 					getLoadShareModulePath(key, isRolldown);
 					writeLoadShareModule(key, shareItem, _command, isRolldown);
-					writePreBuildLibPath(key, shareItem);
+					if (shareItem.shareConfig?.import !== false) writePreBuildLibPath(key, shareItem);
 					addUsedShares(key);
-					if (_command === "serve") {
+					if (_command === "serve" && shareItem.shareConfig?.import !== false) {
 						if (!isRolldown) config.optimizeDeps.include.push(getLoadShareImportId(key, isRolldown, _command));
 						config.optimizeDeps.include.push(getPreBuildLibImportId(key));
 					}
@@ -2597,6 +2889,7 @@ function federation(mfUserOptions) {
 			virtualExposesId
 		}),
 		pluginProxyRemotes_default(options),
+		pluginRemoteNamedExports(options),
 		...pluginModuleParseEnd_default((id) => {
 			return id.includes(getHostAutoInitImportId()) || id.includes(remoteEntryId) || id.includes(virtualExposesId) || id.includes(getLocalSharedImportMapPath());
 		}, {
@@ -2632,19 +2925,19 @@ function federation(mfUserOptions) {
 					warnedAboutCodeSplitting = true;
 					mfWarn("Ignoring `build.rolldownOptions.output.codeSplitting = false` because module federation requires chunk splitting.");
 				};
+				let warnedAboutManualChunks = false;
 				const applyManualChunks = (output) => {
 					ensureCodeSplitting(output);
-					const existingManualChunks = output.manualChunks;
+					if (output.manualChunks && !warnedAboutManualChunks) {
+						warnedAboutManualChunks = true;
+						mfWarn("Ignoring `build.rollupOptions.output.manualChunks` because it conflicts with module federation. Module federation transforms shared dependency imports with top-level await, and grouping these transformed modules into a single chunk creates circular async dependencies that cause the application to silently hang.");
+					}
 					output.manualChunks = function(id) {
 						if (id.includes(runtimeInitId)) return "runtimeInit";
 						if (id.includes("__loadShare__")) {
 							const match = id.match(/([^/\\]+__loadShare__[^/\\]+)/);
 							return match ? match[1] : "loadShare";
 						}
-						if (typeof existingManualChunks === "function") return existingManualChunks.apply(this, arguments);
-						if (existingManualChunks && typeof existingManualChunks === "object") {
-							for (const [key, ids] of Object.entries(existingManualChunks)) if (Array.isArray(ids) && ids.some((v) => id.includes(v))) return key;
-						}
 					};
 				};
 				config.build.rollupOptions = config.build.rollupOptions || {};
@@ -2676,6 +2969,7 @@ function federation(mfUserOptions) {
 					* @see https://rollupjs.org/plugin-development/#synthetic-named-exports
 					*/
 					code = code.replace("export default exportModule", "export const __moduleExports = exportModule;\nexport default exportModule.__esModule ? exportModule.default : exportModule");
+					if (getIsRolldown(this)) return { code };
 					return {
 						code,
 						syntheticNamedExports: "__moduleExports"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/vite",
-  "version": "1.13.3",
+  "version": "1.13.5",
   "description": "Vite plugin for Module Federation",
   "type": "module",
   "main": "./lib/index.cjs",
@@ -30,10 +30,13 @@
     "dev-rv": "pnpm clean && pnpm -filter 'examples-rust-vite*' run dev",
     "preview-rv": "pnpm clean && pnpm -filter 'examples-rust-vite*' run preview",
     "dev-vv": "pnpm clean && pnpm -filter 'examples-vite-vite*' run dev",
-    "preview-vv": "pnpm clean && pnpm -filter 'examples-vite-vite*' --parallel run preview",
+    "preview-vv": "pnpm clean && pnpm run build:shared-lib && pnpm -filter 'examples-vite-vite*' --parallel run preview",
+    "preview-vv:ci": "pnpm run build:shared-lib && pnpm -filter 'examples-vite-vite*' --parallel run preview",
+    "build:shared-lib": "pnpm --filter @vite-vite/shared-lib run build",
+    "multi-example:ci": "pnpm -filter 'multi-example-*' --parallel run start",
     "mixed-vv:1": "pnpm clean && pnpm -filter 'examples-vite-vite*' run mixed:1",
     "mixed-vv:2": "pnpm clean && pnpm -filter 'examples-vite-vite*' run mixed:2",
-    "multi-example": "pnpm clean && pnpm --filter \"multi-example-*\" --parallel run start",
+    "multi-example": "pnpm clean && pnpm --filter 'multi-example-*' --parallel run start",
     "test": "vitest run --dir src",
     "test:integration": "vitest run integration",
     "e2e": "playwright test",
@@ -72,7 +75,7 @@
     "@module-federation/sdk": "2.2.3",
     "@rollup/pluginutils": "^5.3.0",
     "defu": "^6.1.4",
-    "es-module-lexer": "^1.7.0",
+    "es-module-lexer": "^2.0.0",
     "estree-walker": "^3.0.3",
     "magic-string": "^0.30.21",
     "pathe": "^2.0.3"