@module-federation/vite 1.23.5 → 1.23.7

package/README.md

@@ -9,7 +9,7 @@
 <br />
 
 <a href="https://github.com/sponsors/gioboa">
-  <img src="./docs/sponsors.png" alt="Sponsors" />
+  <img src="./docs/sponsors.png" alt="Sponsors" width="677" />
 </a>
 
 ## Become a sponsor
@@ -253,10 +253,31 @@ export default defineConfig({
 
 The host app configuration specifies its name, the filename of its exposed remote entry remoteEntry.js, and importantly, the configuration of the remote application to load.
 Object remotes that omit `type` retain the legacy `"var"` default and emit a warning. Use `type: "module"` for Vite ESM remotes. Use `type: "var"` explicitly only for global-format remotes, such as Webpack/Rspack remotes or a Vite remote's `varFilename` output.
+
+The optional `varFilename` wrapper registers the container on `globalThis[name]` and throws if that name already belongs to another global (e.g. `window`, `self`, `location`), even when its value is `0`, `false`, `""` or `null` (e.g. `length`). Use a distinct name or an ESM remote (`type: "module"`). Loading the wrapper again keeps the existing container.
 You can specify the place the host initialization file is injected with the **hostInitInjectLocation** option, which is described in the example code above.
 The **moduleParseTimeout** option allows you to configure the maximum time to wait for module parsing during the build process.
 The **moduleParseIdleTimeout** option is an alternative that resets the timer on every parsed module. It only fires when there has been no module activity for the configured duration, making it suitable for large codebases where the total build time exceeds the fixed timeout.
 
+## SSR runtime initialization
+
+For applications with configured remotes, SSR entries and modules importing
+`@module-federation/runtime` initialize the owning runtime before plain
+`getInstance()` or `loadRemote()` calls run. Startup registers remotes and shares
+without fetching remote entries or manifests, or requesting a root expose. Remote
+loading stays lazy, including with `loaded-first`. Apps without remotes receive no
+SSR host bootstrap. Cold development SSR follows the existing Vite 8+ support gate;
+independent SSR builds are supported on Vite 5–8.
+
+A remote the application registers at runtime with `init()` or `registerRemotes()`
+under a configured remote's name or alias replaces that remote for `loadRemote()`
+calls. Static `import "remote/expose"` statements keep using the configured entry.
+
+Dependencies externalized by Vite keep Node's own runtime resolution. Their runtime
+imports are not bound to the application's instance by this bootstrap.
+Include runtime-consuming dependencies in Vite's `ssr.noExternal` when they need
+to use the application's runtime instance.
+
 ## SSR entry loading strategy
 
 SSR hosts can choose how HTTP ESM remote entries are evaluated during build and preview:

package/lib/{dtsConstants-BQdFpgKb.js → dtsConstants-CDuC8Bb7.js}

@@ -1,10 +1,11 @@
-import { d as getNodeModulesSuffix, r as getSharedRuntimeKey } from "./sharedKeyMatcher-CHp4QRNq.js";
-import { l as normalizePathForImport, r as mfWarn, t as createModuleFederationError } from "./logger-DOwfTlw5.js";
+import { r as mfWarn, t as createModuleFederationError, u as normalizePathForImport } from "./logger-D67aJYOe.js";
+import { d as getNodeModulesSuffix, r as getSharedRuntimeKey } from "./sharedKeyMatcher-C04bVN1q.js";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "fs";
 import { createRequire } from "module";
 import * as path$1 from "node:path";
 import { fileURLToPath, pathToFileURL } from "url";
 import { createHash } from "node:crypto";
+import { isIPv6 } from "node:net";
 //#region src/utils/reactShares.ts
 /** Property under which React 19 exposes its internals object. */
 const REACT_CLIENT_INTERNALS_KEY = "__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE";
@@ -37,6 +38,7 @@ function getDependencyCacheKey(cwd, dependencyName) {
 const installedPackageJsonCache = /* @__PURE__ */ new Map();
 const dependentsLookupCache = /* @__PURE__ */ new Map();
 const reachableDependencyNames = /* @__PURE__ */ new Map();
+const pnpmStorePackageIndexCache = /* @__PURE__ */ new Map();
 function setPackageDetectionCwd(cwd) {
 	packageDetectionCwd = cwd;
 }
@@ -494,7 +496,6 @@ function getInstalledPackageJson(pkg, opts) {
 	return result;
 }
 function tryReadPackageJson(packageJsonPath, expectedName) {
-	if (!existsSync(packageJsonPath)) return void 0;
 	try {
 		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 		if (expectedName !== void 0 && packageJson.name !== expectedName) return void 0;
@@ -508,19 +509,6 @@ function tryReadPackageJson(packageJsonPath, expectedName) {
 	}
 }
 function resolveInstalledPackageJson(pkg, cwd, packageName, opts) {
-	const findPackageInPnpmStore = (startDir) => {
-		for (const dir of ancestorDirs(startDir)) {
-			const pnpmStoreDir = path$1.join(dir, "node_modules", ".pnpm");
-			if (!existsSync(pnpmStoreDir)) continue;
-			try {
-				for (const entry of readdirSync(pnpmStoreDir, { withFileTypes: true })) {
-					if (!entry.isDirectory()) continue;
-					const candidate = tryReadPackageJson(path$1.join(pnpmStoreDir, entry.name, "node_modules", packageName, "package.json"));
-					if (candidate?.packageJson.name === packageName) return candidate;
-				}
-			} catch {}
-		}
-	};
 	let resolvedPath;
 	try {
 		const rootPackageJson = path$1.join(cwd, "package.json");
@@ -542,7 +530,54 @@ function resolveInstalledPackageJson(pkg, cwd, packageName, opts) {
 		const directCandidate = tryReadPackageJson(path$1.join(dir, "node_modules", packageName, "package.json"), packageName);
 		if (directCandidate) return directCandidate;
 	}
-	return findPackageInDependents(packageName, cwd) ?? findPackageInPnpmStore(cwd);
+	return findPackageInDependents(packageName, cwd) ?? findPackageInPnpmStore(packageName, cwd);
+}
+function readDirEntries(dir) {
+	try {
+		return readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+}
+function isDirOrLink(entry) {
+	return entry.isDirectory() || entry.isSymbolicLink();
+}
+function getPnpmStorePackageIndex(startDir) {
+	const cached = pnpmStorePackageIndexCache.get(startDir);
+	if (cached) return cached;
+	const index = /* @__PURE__ */ new Map();
+	const add = (name, packageJsonPath) => {
+		const paths = index.get(name);
+		if (paths) paths.push(packageJsonPath);
+		else index.set(name, [packageJsonPath]);
+	};
+	for (const dir of ancestorDirs(startDir)) {
+		const pnpmStoreDir = path$1.join(dir, "node_modules", ".pnpm");
+		for (const entry of readDirEntries(pnpmStoreDir)) {
+			if (!entry.isDirectory()) continue;
+			const storeNodeModules = path$1.join(pnpmStoreDir, entry.name, "node_modules");
+			for (const packageEntry of readDirEntries(storeNodeModules)) {
+				if (!isDirOrLink(packageEntry)) continue;
+				const entryDir = path$1.join(storeNodeModules, packageEntry.name);
+				if (!packageEntry.name.startsWith("@")) {
+					add(packageEntry.name, path$1.join(entryDir, "package.json"));
+					continue;
+				}
+				for (const scopedEntry of readDirEntries(entryDir)) {
+					if (!isDirOrLink(scopedEntry)) continue;
+					add(`${packageEntry.name}/${scopedEntry.name}`, path$1.join(entryDir, scopedEntry.name, "package.json"));
+				}
+			}
+		}
+	}
+	pnpmStorePackageIndexCache.set(startDir, index);
+	return index;
+}
+function findPackageInPnpmStore(packageName, startDir) {
+	for (const packageJsonPath of getPnpmStorePackageIndex(startDir).get(packageName) ?? []) {
+		const candidate = tryReadPackageJson(packageJsonPath, packageName);
+		if (candidate) return candidate;
+	}
 }
 /**
 * A package installed only under a dependent is invisible to the walks above.
@@ -609,12 +644,13 @@ function warnOnAmbiguousDependents(packageName, candidates) {
 	const versions = [...viaByVersion].map(([version, via]) => `${version} (via ${via})`);
 	mfWarn(`Shared package "${packageName}" is not a dependency of the project, and its closest dependents install different versions: ${versions.join(", ")}. The fallback uses ${versions[0]}. Add "${packageName}" to the project's dependencies or set its shared "import" to choose the version.`);
 }
+const realpath = process.platform === "win32" ? realpathSync : realpathSync.native;
 /** The package Node's `node_modules` lookup finds from `fromDir`, read at its real path. */
 function findPackageFrom(packageName, fromDir) {
 	const entry = findNodeModulesEntry(packageName, fromDir);
 	if (!entry) return void 0;
 	try {
-		return tryReadPackageJson(path$1.join(realpathSync(entry), "package.json"), packageName);
+		return tryReadPackageJson(path$1.join(realpath(entry), "package.json"), packageName);
 	} catch {
 		return;
 	}
@@ -689,14 +725,11 @@ function getInstalledPackageEntry(pkg, opts) {
 	const explicitEntry = resolveExportsEntry(getPackageExportsTarget(pkg, packageName, packageJson.exports), opts?.conditions) || (typeof packageJson.module === "string" ? packageJson.module : void 0) || (typeof packageJson.main === "string" ? packageJson.main : void 0) || "index.js";
 	return path$1.join(installed.dir, explicitEntry);
 }
-/**
-* Detect whether the current runtime is Vite 8+ by checking for a Vite version flag
-* on the plugin hook context, with Rolldown metadata kept as a compatibility fallback.
-*/
+/** Detect Vite 8+ (Rolldown) from the Vite version on the plugin hook context. */
 function getIsRolldown(ctx) {
 	const viteVersion = ctx?.meta?.viteVersion;
 	const viteMajor = Number(String(viteVersion ?? "").split(".")[0]);
-	return Number.isFinite(viteMajor) && viteMajor >= 8 || !!ctx?.meta?.rolldownVersion;
+	return Number.isFinite(viteMajor) && viteMajor >= 8;
 }
 /**
 * Rolldown 1.2.10 added `codeSplitting.groups[].debugName` and warns when a group's
@@ -741,7 +774,34 @@ function hasPackageDependency(dependencyName, cwd = packageDetectionCwd || proce
 	}
 }
 //#endregion
+//#region src/utils/devServerHost.ts
+const UNSPECIFIED_HOSTS = /* @__PURE__ */ new Set(["0.0.0.0", "::"]);
+/**
+* Hostname for client-facing HTTP/WS origins built from Vite `server.host`.
+*
+* Unspecified bind addresses (`0.0.0.0`, `::`) map to `localhost`, matching
+* Vite's own printed local URL. IPv6 addresses are wrapped in brackets so
+* `http://[::1]:5173` / `ws://[::1]:5173` parse as valid URLs.
+*/
+function formatDevServerHostForOrigin(host) {
+	if (typeof host !== "string" || UNSPECIFIED_HOSTS.has(host)) return "localhost";
+	if (host.startsWith("[") && host.endsWith("]")) return host;
+	return isIPv6(host) ? `[${host}]` : host;
+}
+const FILE_EVENTS = [
+	"change",
+	"add",
+	"unlink"
+];
+/** Runs `listener` on every file change, add, or unlink; returns a function that unsubscribes it. */
+function watchFileEvents(watcher, listener) {
+	for (const event of FILE_EVENTS) watcher.on(event, listener);
+	return () => {
+		for (const event of FILE_EVENTS) watcher.off(event, listener);
+	};
+}
+//#endregion
 //#region src/utils/dtsConstants.ts
 const DEFAULT_PUBLIC_TYPES_FOLDER = "@mf-types";
 //#endregion
-export { REACT_DOM_CLIENT_SHARE as C, REACT_CLIENT_INTERNALS_KEY as S, resolveImportPath as _, getIsRolldown as a, sharedCacheHelperCode as b, getPackageName as c, hasPackageDependency as d, isNuxtProjectRoot as f, packageNameEncode as g, packageNameDecode as h, getInstalledPackageJson as i, getPackageNameFromNodeModulePath as l, isPackageInstalled as m, getDependencyNames as n, getPackageDetectionCwd as o, isPackageExportAvailable as p, getInstalledPackageEntry as r, getPackageExportSpecifiersForFile as s, DEFAULT_PUBLIC_TYPES_FOLDER as t, getSharedCacheDescriptor as u, resolveModulePath as v, isReactCoreShare as w, supportsCodeSplittingGroupDebugName as x, setPackageDetectionCwd as y };
+export { supportsCodeSplittingGroupDebugName as C, isReactCoreShare as E, sharedCacheHelperCode as S, REACT_DOM_CLIENT_SHARE as T, packageNameDecode as _, getInstalledPackageEntry as a, resolveModulePath as b, getPackageDetectionCwd as c, getPackageNameFromNodeModulePath as d, getSharedCacheDescriptor as f, isPackageInstalled as g, isPackageExportAvailable as h, getDependencyNames as i, getPackageExportSpecifiersForFile as l, isNuxtProjectRoot as m, formatDevServerHostForOrigin as n, getInstalledPackageJson as o, hasPackageDependency as p, watchFileEvents as r, getIsRolldown as s, DEFAULT_PUBLIC_TYPES_FOLDER as t, getPackageName as u, packageNameEncode as v, REACT_CLIENT_INTERNALS_KEY as w, setPackageDetectionCwd as x, resolveImportPath as y };