@module-federation/runtime-core 2.0.1 → 2.2.0

package/dist/shared/index.js

@@ -0,0 +1,303 @@
+import { assert, error } from "../utils/logger.js";
+import { DEFAULT_SCOPE } from "../constant.js";
+import { addUseIn, directShare, formatShareConfigs, getGlobalShareScope, getRegisteredShare, getTargetSharedOptions, shouldUseTreeShaking } from "../utils/share.js";
+import { optionsToMFContext } from "../utils/context.js";
+import "../utils/index.js";
+import { AsyncHook } from "../utils/hooks/asyncHook.js";
+import { SyncWaterfallHook } from "../utils/hooks/syncWaterfallHook.js";
+import { AsyncWaterfallHook } from "../utils/hooks/asyncWaterfallHooks.js";
+import { PluginSystem } from "../utils/hooks/pluginSystem.js";
+import "../utils/hooks/index.js";
+import { RUNTIME_005, RUNTIME_006, runtimeDescMap } from "@module-federation/error-codes";
+
+//#region src/shared/index.ts
+var SharedHandler = class {
+	constructor(host) {
+		this.hooks = new PluginSystem({
+			beforeRegisterShare: new SyncWaterfallHook("beforeRegisterShare"),
+			afterResolve: new AsyncWaterfallHook("afterResolve"),
+			beforeLoadShare: new AsyncWaterfallHook("beforeLoadShare"),
+			loadShare: new AsyncHook(),
+			resolveShare: new SyncWaterfallHook("resolveShare"),
+			initContainerShareScopeMap: new SyncWaterfallHook("initContainerShareScopeMap")
+		});
+		this.host = host;
+		this.shareScopeMap = {};
+		this.initTokens = {};
+		this._setGlobalShareScopeMap(host.options);
+	}
+	registerShared(globalOptions, userOptions) {
+		const { newShareInfos, allShareInfos } = formatShareConfigs(globalOptions, userOptions);
+		Object.keys(newShareInfos).forEach((sharedKey) => {
+			newShareInfos[sharedKey].forEach((sharedVal) => {
+				sharedVal.scope.forEach((sc) => {
+					this.hooks.lifecycle.beforeRegisterShare.emit({
+						origin: this.host,
+						pkgName: sharedKey,
+						shared: sharedVal
+					});
+					if (!this.shareScopeMap[sc]?.[sharedKey]) this.setShared({
+						pkgName: sharedKey,
+						lib: sharedVal.lib,
+						get: sharedVal.get,
+						loaded: sharedVal.loaded || Boolean(sharedVal.lib),
+						shared: sharedVal,
+						from: userOptions.name
+					});
+				});
+			});
+		});
+		return {
+			newShareInfos,
+			allShareInfos
+		};
+	}
+	async loadShare(pkgName, extraOptions) {
+		const { host } = this;
+		const shareOptions = getTargetSharedOptions({
+			pkgName,
+			extraOptions,
+			shareInfos: host.options.shared
+		});
+		if (shareOptions?.scope) await Promise.all(shareOptions.scope.map(async (shareScope) => {
+			await Promise.all(this.initializeSharing(shareScope, { strategy: shareOptions.strategy }));
+		}));
+		const { shareInfo: shareOptionsRes } = await this.hooks.lifecycle.beforeLoadShare.emit({
+			pkgName,
+			shareInfo: shareOptions,
+			shared: host.options.shared,
+			origin: host
+		});
+		assert(shareOptionsRes, `Cannot find shared "${pkgName}" in host "${host.options.name}". Ensure the shared config for "${pkgName}" is declared in the federation plugin options and the host has been initialized before loading shares.`);
+		const { shared: registeredShared, useTreesShaking } = getRegisteredShare(this.shareScopeMap, pkgName, shareOptionsRes, this.hooks.lifecycle.resolveShare) || {};
+		if (registeredShared) {
+			const targetShared = directShare(registeredShared, useTreesShaking);
+			if (targetShared.lib) {
+				addUseIn(targetShared, host.options.name);
+				return targetShared.lib;
+			} else if (targetShared.loading && !targetShared.loaded) {
+				const factory = await targetShared.loading;
+				targetShared.loaded = true;
+				if (!targetShared.lib) targetShared.lib = factory;
+				addUseIn(targetShared, host.options.name);
+				return factory;
+			} else {
+				const asyncLoadProcess = async () => {
+					const factory = await targetShared.get();
+					addUseIn(targetShared, host.options.name);
+					targetShared.loaded = true;
+					targetShared.lib = factory;
+					return factory;
+				};
+				const loading = asyncLoadProcess();
+				this.setShared({
+					pkgName,
+					loaded: false,
+					shared: registeredShared,
+					from: host.options.name,
+					lib: null,
+					loading,
+					treeShaking: useTreesShaking ? targetShared : void 0
+				});
+				return loading;
+			}
+		} else {
+			if (extraOptions?.customShareInfo) return false;
+			const _useTreeShaking = shouldUseTreeShaking(shareOptionsRes.treeShaking);
+			const targetShared = directShare(shareOptionsRes, _useTreeShaking);
+			const asyncLoadProcess = async () => {
+				const factory = await targetShared.get();
+				targetShared.lib = factory;
+				targetShared.loaded = true;
+				addUseIn(targetShared, host.options.name);
+				const { shared: gShared, useTreesShaking: gUseTreeShaking } = getRegisteredShare(this.shareScopeMap, pkgName, shareOptionsRes, this.hooks.lifecycle.resolveShare) || {};
+				if (gShared) {
+					const targetGShared = directShare(gShared, gUseTreeShaking);
+					targetGShared.lib = factory;
+					targetGShared.loaded = true;
+					gShared.from = shareOptionsRes.from;
+				}
+				return factory;
+			};
+			const loading = asyncLoadProcess();
+			this.setShared({
+				pkgName,
+				loaded: false,
+				shared: shareOptionsRes,
+				from: host.options.name,
+				lib: null,
+				loading,
+				treeShaking: _useTreeShaking ? targetShared : void 0
+			});
+			return loading;
+		}
+	}
+	/**
+	* This function initializes the sharing sequence (executed only once per share scope).
+	* It accepts one argument, the name of the share scope.
+	* If the share scope does not exist, it creates one.
+	*/
+	initializeSharing(shareScopeName = DEFAULT_SCOPE, extraOptions) {
+		const { host } = this;
+		const from = extraOptions?.from;
+		const strategy = extraOptions?.strategy;
+		let initScope = extraOptions?.initScope;
+		const promises = [];
+		if (from !== "build") {
+			const { initTokens } = this;
+			if (!initScope) initScope = [];
+			let initToken = initTokens[shareScopeName];
+			if (!initToken) initToken = initTokens[shareScopeName] = { from: this.host.name };
+			if (initScope.indexOf(initToken) >= 0) return promises;
+			initScope.push(initToken);
+		}
+		const shareScope = this.shareScopeMap;
+		const hostName = host.options.name;
+		if (!shareScope[shareScopeName]) shareScope[shareScopeName] = {};
+		const scope = shareScope[shareScopeName];
+		const register = (name, shared) => {
+			const { version, eager } = shared;
+			scope[name] = scope[name] || {};
+			const versions = scope[name];
+			const activeVersion = versions[version] && directShare(versions[version]);
+			const activeVersionEager = Boolean(activeVersion && ("eager" in activeVersion && activeVersion.eager || "shareConfig" in activeVersion && activeVersion.shareConfig?.eager));
+			if (!activeVersion || activeVersion.strategy !== "loaded-first" && !activeVersion.loaded && (Boolean(!eager) !== !activeVersionEager ? eager : hostName > versions[version].from)) versions[version] = shared;
+		};
+		const initRemoteModule = async (key) => {
+			const { module } = await host.remoteHandler.getRemoteModuleAndOptions({ id: key });
+			let remoteEntryExports = void 0;
+			try {
+				remoteEntryExports = await module.getEntry();
+			} catch (error) {
+				remoteEntryExports = await host.remoteHandler.hooks.lifecycle.errorLoadRemote.emit({
+					id: key,
+					error,
+					from: "runtime",
+					lifecycle: "beforeLoadShare",
+					origin: host
+				});
+				if (!remoteEntryExports) return;
+			} finally {
+				if (remoteEntryExports?.init && !module.initing) {
+					module.remoteEntryExports = remoteEntryExports;
+					await module.init(void 0, void 0, initScope);
+				}
+			}
+		};
+		Object.keys(host.options.shared).forEach((shareName) => {
+			host.options.shared[shareName].forEach((shared) => {
+				if (shared.scope.includes(shareScopeName)) register(shareName, shared);
+			});
+		});
+		if (host.options.shareStrategy === "version-first" || strategy === "version-first") host.options.remotes.forEach((remote) => {
+			if (remote.shareScope === shareScopeName) promises.push(initRemoteModule(remote.name));
+		});
+		return promises;
+	}
+	loadShareSync(pkgName, extraOptions) {
+		const { host } = this;
+		const shareOptions = getTargetSharedOptions({
+			pkgName,
+			extraOptions,
+			shareInfos: host.options.shared
+		});
+		if (shareOptions?.scope) shareOptions.scope.forEach((shareScope) => {
+			this.initializeSharing(shareScope, { strategy: shareOptions.strategy });
+		});
+		const { shared: registeredShared, useTreesShaking } = getRegisteredShare(this.shareScopeMap, pkgName, shareOptions, this.hooks.lifecycle.resolveShare) || {};
+		if (registeredShared) {
+			if (typeof registeredShared.lib === "function") {
+				addUseIn(registeredShared, host.options.name);
+				if (!registeredShared.loaded) {
+					registeredShared.loaded = true;
+					if (registeredShared.from === host.options.name) shareOptions.loaded = true;
+				}
+				return registeredShared.lib;
+			}
+			if (typeof registeredShared.get === "function") {
+				const module = registeredShared.get();
+				if (!(module instanceof Promise)) {
+					addUseIn(registeredShared, host.options.name);
+					this.setShared({
+						pkgName,
+						loaded: true,
+						from: host.options.name,
+						lib: module,
+						shared: registeredShared
+					});
+					return module;
+				}
+			}
+		}
+		if (shareOptions.lib) {
+			if (!shareOptions.loaded) shareOptions.loaded = true;
+			return shareOptions.lib;
+		}
+		if (shareOptions.get) {
+			const module = shareOptions.get();
+			if (module instanceof Promise) error(extraOptions?.from === "build" ? RUNTIME_005 : RUNTIME_006, runtimeDescMap, {
+				hostName: host.options.name,
+				sharedPkgName: pkgName
+			}, void 0, optionsToMFContext(host.options));
+			shareOptions.lib = module;
+			this.setShared({
+				pkgName,
+				loaded: true,
+				from: host.options.name,
+				lib: shareOptions.lib,
+				shared: shareOptions
+			});
+			return shareOptions.lib;
+		}
+		error(RUNTIME_006, runtimeDescMap, {
+			hostName: host.options.name,
+			sharedPkgName: pkgName
+		}, void 0, optionsToMFContext(host.options));
+	}
+	initShareScopeMap(scopeName, shareScope, extraOptions = {}) {
+		const { host } = this;
+		this.shareScopeMap[scopeName] = shareScope;
+		this.hooks.lifecycle.initContainerShareScopeMap.emit({
+			shareScope,
+			options: host.options,
+			origin: host,
+			scopeName,
+			hostShareScopeMap: extraOptions.hostShareScopeMap
+		});
+	}
+	setShared({ pkgName, shared, from, lib, loading, loaded, get, treeShaking }) {
+		const { version, scope = "default", ...shareInfo } = shared;
+		const scopes = Array.isArray(scope) ? scope : [scope];
+		const mergeAttrs = (shared) => {
+			const merge = (s, key, val) => {
+				if (val && !s[key]) s[key] = val;
+			};
+			const targetShared = treeShaking ? shared.treeShaking : shared;
+			merge(targetShared, "loaded", loaded);
+			merge(targetShared, "loading", loading);
+			merge(targetShared, "get", get);
+		};
+		scopes.forEach((sc) => {
+			if (!this.shareScopeMap[sc]) this.shareScopeMap[sc] = {};
+			if (!this.shareScopeMap[sc][pkgName]) this.shareScopeMap[sc][pkgName] = {};
+			if (!this.shareScopeMap[sc][pkgName][version]) this.shareScopeMap[sc][pkgName][version] = {
+				version,
+				scope: [sc],
+				...shareInfo,
+				lib
+			};
+			const registeredShared = this.shareScopeMap[sc][pkgName][version];
+			mergeAttrs(registeredShared);
+			if (from && registeredShared.from !== from) registeredShared.from = from;
+		});
+	}
+	_setGlobalShareScopeMap(hostOptions) {
+		const globalShareScopeMap = getGlobalShareScope();
+		const identifier = hostOptions.id || hostOptions.name;
+		if (identifier && !globalShareScopeMap[identifier]) globalShareScopeMap[identifier] = this.shareScopeMap;
+	}
+};
+
+//#endregion
+export { SharedHandler };
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/shared/index.ts"],"sourcesContent":["import {\n  RUNTIME_005,\n  RUNTIME_006,\n  runtimeDescMap,\n} from '@module-federation/error-codes';\nimport { Federation } from '../global';\nimport {\n  Options,\n  ShareScopeMap,\n  ShareInfos,\n  Shared,\n  RemoteEntryExports,\n  UserOptions,\n  ShareStrategy,\n  InitScope,\n  InitTokens,\n  CallFrom,\n  TreeShakingArgs,\n} from '../type';\nimport { ModuleFederation } from '../core';\nimport {\n  PluginSystem,\n  AsyncHook,\n  AsyncWaterfallHook,\n  SyncWaterfallHook,\n} from '../utils/hooks';\nimport {\n  formatShareConfigs,\n  getRegisteredShare,\n  getTargetSharedOptions,\n  getGlobalShareScope,\n  directShare,\n  shouldUseTreeShaking,\n  addUseIn,\n} from '../utils/share';\nimport { assert, error, addUniqueItem, optionsToMFContext } from '../utils';\nimport { DEFAULT_SCOPE } from '../constant';\nimport { LoadRemoteMatch } from '../remote';\nimport { createRemoteEntryInitOptions } from '../module';\n\nexport class SharedHandler {\n  host: ModuleFederation;\n  shareScopeMap: ShareScopeMap;\n  hooks = new PluginSystem({\n    beforeRegisterShare: new SyncWaterfallHook<{\n      pkgName: string;\n      shared: Shared;\n      origin: ModuleFederation;\n    }>('beforeRegisterShare'),\n    afterResolve: new AsyncWaterfallHook<LoadRemoteMatch>('afterResolve'),\n    beforeLoadShare: new AsyncWaterfallHook<{\n      pkgName: string;\n      shareInfo?: Shared;\n      shared: Options['shared'];\n      origin: ModuleFederation;\n    }>('beforeLoadShare'),\n    // not used yet\n    loadShare: new AsyncHook<[ModuleFederation, string, ShareInfos]>(),\n    resolveShare: new SyncWaterfallHook<{\n      shareScopeMap: ShareScopeMap;\n      scope: string;\n      pkgName: string;\n      version: string;\n      shareInfo: Shared;\n      GlobalFederation: Federation;\n      resolver: () => { shared: Shared; useTreesShaking: boolean } | undefined;\n    }>('resolveShare'),\n    // maybe will change, temporarily for internal use only\n    initContainerShareScopeMap: new SyncWaterfallHook<{\n      shareScope: ShareScopeMap[string];\n      options: Options;\n      origin: ModuleFederation;\n      scopeName: string;\n      hostShareScopeMap?: ShareScopeMap;\n    }>('initContainerShareScopeMap'),\n  });\n  initTokens: InitTokens;\n  constructor(host: ModuleFederation) {\n    this.host = host;\n    this.shareScopeMap = {};\n    this.initTokens = {};\n    this._setGlobalShareScopeMap(host.options);\n  }\n\n  // register shared in shareScopeMap\n  registerShared(globalOptions: Options, userOptions: UserOptions) {\n    const { newShareInfos, allShareInfos } = formatShareConfigs(\n      globalOptions,\n      userOptions,\n    );\n\n    const sharedKeys = Object.keys(newShareInfos);\n    sharedKeys.forEach((sharedKey) => {\n      const sharedVals = newShareInfos[sharedKey];\n      sharedVals.forEach((sharedVal) => {\n        sharedVal.scope.forEach((sc) => {\n          this.hooks.lifecycle.beforeRegisterShare.emit({\n            origin: this.host,\n            pkgName: sharedKey,\n            shared: sharedVal,\n          });\n          const registeredShared = this.shareScopeMap[sc]?.[sharedKey];\n          if (!registeredShared) {\n            this.setShared({\n              pkgName: sharedKey,\n              lib: sharedVal.lib,\n              get: sharedVal.get,\n              loaded: sharedVal.loaded || Boolean(sharedVal.lib),\n              shared: sharedVal,\n              from: userOptions.name,\n            });\n          }\n        });\n      });\n    });\n\n    return {\n      newShareInfos,\n      allShareInfos,\n    };\n  }\n\n  async loadShare<T>(\n    pkgName: string,\n    extraOptions?: {\n      customShareInfo?: Partial<Shared>;\n      resolver?: (sharedOptions: ShareInfos[string]) => Shared;\n    },\n  ): Promise<false | (() => T | undefined)> {\n    const { host } = this;\n    // This function performs the following steps:\n    // 1. Checks if the currently loaded share already exists, if not, it throws an error\n    // 2. Searches globally for a matching share, if found, it uses it directly\n    // 3. If not found, it retrieves it from the current share and stores the obtained share globally.\n\n    const shareOptions = getTargetSharedOptions({\n      pkgName,\n      extraOptions,\n      shareInfos: host.options.shared,\n    });\n\n    if (shareOptions?.scope) {\n      await Promise.all(\n        shareOptions.scope.map(async (shareScope) => {\n          await Promise.all(\n            this.initializeSharing(shareScope, {\n              strategy: shareOptions.strategy,\n            }),\n          );\n          return;\n        }),\n      );\n    }\n    const loadShareRes = await this.hooks.lifecycle.beforeLoadShare.emit({\n      pkgName,\n      shareInfo: shareOptions,\n      shared: host.options.shared,\n      origin: host,\n    });\n\n    const { shareInfo: shareOptionsRes } = loadShareRes;\n\n    // Assert that shareInfoRes exists, if not, throw an error\n    assert(\n      shareOptionsRes,\n      `Cannot find shared \"${pkgName}\" in host \"${host.options.name}\". Ensure the shared config for \"${pkgName}\" is declared in the federation plugin options and the host has been initialized before loading shares.`,\n    );\n\n    const { shared: registeredShared, useTreesShaking } =\n      getRegisteredShare(\n        this.shareScopeMap,\n        pkgName,\n        shareOptionsRes,\n        this.hooks.lifecycle.resolveShare,\n      ) || {};\n\n    if (registeredShared) {\n      const targetShared = directShare(registeredShared, useTreesShaking);\n      if (targetShared.lib) {\n        addUseIn(targetShared, host.options.name);\n        return targetShared.lib as () => T;\n      } else if (targetShared.loading && !targetShared.loaded) {\n        const factory = await targetShared.loading;\n        targetShared.loaded = true;\n        if (!targetShared.lib) {\n          targetShared.lib = factory;\n        }\n        addUseIn(targetShared, host.options.name);\n        return factory;\n      } else {\n        const asyncLoadProcess = async () => {\n          const factory = await targetShared.get!();\n          addUseIn(targetShared, host.options.name);\n          targetShared.loaded = true;\n          targetShared.lib = factory;\n          return factory as () => T;\n        };\n        const loading = asyncLoadProcess();\n        this.setShared({\n          pkgName,\n          loaded: false,\n          shared: registeredShared,\n          from: host.options.name,\n          lib: null,\n          loading,\n          treeShaking: useTreesShaking\n            ? (targetShared as TreeShakingArgs)\n            : undefined,\n        });\n        return loading;\n      }\n    } else {\n      if (extraOptions?.customShareInfo) {\n        return false;\n      }\n      const _useTreeShaking = shouldUseTreeShaking(shareOptionsRes.treeShaking);\n      const targetShared = directShare(shareOptionsRes, _useTreeShaking);\n\n      const asyncLoadProcess = async () => {\n        const factory = await targetShared.get!();\n        targetShared.lib = factory;\n        targetShared.loaded = true;\n        addUseIn(targetShared, host.options.name);\n        const { shared: gShared, useTreesShaking: gUseTreeShaking } =\n          getRegisteredShare(\n            this.shareScopeMap,\n            pkgName,\n            shareOptionsRes,\n            this.hooks.lifecycle.resolveShare,\n          ) || {};\n        if (gShared) {\n          const targetGShared = directShare(gShared, gUseTreeShaking);\n          targetGShared.lib = factory;\n          targetGShared.loaded = true;\n          gShared.from = shareOptionsRes.from;\n        }\n        return factory as () => T;\n      };\n      const loading = asyncLoadProcess();\n      this.setShared({\n        pkgName,\n        loaded: false,\n        shared: shareOptionsRes,\n        from: host.options.name,\n        lib: null,\n        loading,\n        treeShaking: _useTreeShaking\n          ? (targetShared as TreeShakingArgs)\n          : undefined,\n      });\n      return loading;\n    }\n  }\n\n  /**\n   * This function initializes the sharing sequence (executed only once per share scope).\n   * It accepts one argument, the name of the share scope.\n   * If the share scope does not exist, it creates one.\n   */\n  // eslint-disable-next-line @typescript-eslint/member-ordering\n  initializeSharing(\n    shareScopeName = DEFAULT_SCOPE,\n    extraOptions?: {\n      initScope?: InitScope;\n      from?: CallFrom;\n      strategy?: ShareStrategy;\n    },\n  ): Array<Promise<void>> {\n    const { host } = this;\n    const from = extraOptions?.from;\n    const strategy = extraOptions?.strategy;\n    let initScope = extraOptions?.initScope;\n    const promises: Promise<any>[] = [];\n    if (from !== 'build') {\n      const { initTokens } = this;\n      if (!initScope) initScope = [];\n      let initToken = initTokens[shareScopeName];\n      if (!initToken)\n        initToken = initTokens[shareScopeName] = { from: this.host.name };\n      if (initScope.indexOf(initToken) >= 0) return promises;\n      initScope.push(initToken);\n    }\n\n    const shareScope = this.shareScopeMap;\n    const hostName = host.options.name;\n    // Creates a new share scope if necessary\n    if (!shareScope[shareScopeName]) {\n      shareScope[shareScopeName] = {};\n    }\n    // Executes all initialization snippets from all accessible modules\n    const scope = shareScope[shareScopeName];\n    const register = (name: string, shared: Shared) => {\n      const { version, eager } = shared;\n      scope[name] = scope[name] || {};\n      const versions = scope[name];\n      const activeVersion: Shared =\n        versions[version] && (directShare(versions[version]) as Shared);\n      const activeVersionEager = Boolean(\n        activeVersion &&\n        (('eager' in activeVersion && activeVersion.eager) ||\n          ('shareConfig' in activeVersion && activeVersion.shareConfig?.eager)),\n      );\n      if (\n        !activeVersion ||\n        (activeVersion.strategy !== 'loaded-first' &&\n          !activeVersion.loaded &&\n          (Boolean(!eager) !== !activeVersionEager\n            ? eager\n            : hostName > versions[version].from))\n      ) {\n        versions[version] = shared;\n      }\n    };\n\n    const initRemoteModule = async (key: string): Promise<void> => {\n      const { module } = await host.remoteHandler.getRemoteModuleAndOptions({\n        id: key,\n      });\n      let remoteEntryExports: RemoteEntryExports | undefined = undefined;\n      try {\n        remoteEntryExports = await module.getEntry();\n      } catch (error) {\n        remoteEntryExports =\n          (await host.remoteHandler.hooks.lifecycle.errorLoadRemote.emit({\n            id: key,\n            error,\n            from: 'runtime',\n            lifecycle: 'beforeLoadShare',\n            origin: host,\n          })) as RemoteEntryExports;\n        if (!remoteEntryExports) {\n          return;\n        }\n      } finally {\n        // prevent self load loop: when host load self , the initTokens is not the same\n        if (remoteEntryExports?.init && !module.initing) {\n          module.remoteEntryExports = remoteEntryExports;\n          await module.init(undefined, undefined, initScope);\n        }\n      }\n    };\n    Object.keys(host.options.shared).forEach((shareName) => {\n      const sharedArr = host.options.shared[shareName];\n      sharedArr.forEach((shared) => {\n        if (shared.scope.includes(shareScopeName)) {\n          register(shareName, shared);\n        }\n      });\n    });\n    // TODO: strategy==='version-first' need to be removed in the future\n    if (\n      host.options.shareStrategy === 'version-first' ||\n      strategy === 'version-first'\n    ) {\n      host.options.remotes.forEach((remote) => {\n        if (remote.shareScope === shareScopeName) {\n          promises.push(initRemoteModule(remote.name));\n        }\n      });\n    }\n\n    return promises;\n  }\n\n  // The lib function will only be available if the shared set by eager or runtime init is set or the shared is successfully loaded.\n  // 1. If the loaded shared already exists globally, then it will be reused\n  // 2. If lib exists in local shared, it will be used directly\n  // 3. If the local get returns something other than Promise, then it will be used directly\n  loadShareSync<T>(\n    pkgName: string,\n    extraOptions?: {\n      from?: 'build' | 'runtime';\n      customShareInfo?: Partial<Shared>;\n      resolver?: (sharedOptions: ShareInfos[string]) => Shared;\n    },\n  ): () => T | never {\n    const { host } = this;\n    const shareOptions = getTargetSharedOptions({\n      pkgName,\n      extraOptions,\n      shareInfos: host.options.shared,\n    });\n\n    if (shareOptions?.scope) {\n      shareOptions.scope.forEach((shareScope) => {\n        this.initializeSharing(shareScope, { strategy: shareOptions.strategy });\n      });\n    }\n    const { shared: registeredShared, useTreesShaking } =\n      getRegisteredShare(\n        this.shareScopeMap,\n        pkgName,\n        shareOptions,\n        this.hooks.lifecycle.resolveShare,\n      ) || {};\n\n    if (registeredShared) {\n      if (typeof registeredShared.lib === 'function') {\n        addUseIn(registeredShared, host.options.name);\n        if (!registeredShared.loaded) {\n          registeredShared.loaded = true;\n          if (registeredShared.from === host.options.name) {\n            shareOptions.loaded = true;\n          }\n        }\n        return registeredShared.lib as () => T;\n      }\n      if (typeof registeredShared.get === 'function') {\n        const module = registeredShared.get();\n        if (!(module instanceof Promise)) {\n          addUseIn(registeredShared, host.options.name);\n          this.setShared({\n            pkgName,\n            loaded: true,\n            from: host.options.name,\n            lib: module,\n            shared: registeredShared,\n          });\n          return module;\n        }\n      }\n    }\n\n    if (shareOptions.lib) {\n      if (!shareOptions.loaded) {\n        shareOptions.loaded = true;\n      }\n      return shareOptions.lib as () => T;\n    }\n\n    if (shareOptions.get) {\n      const module = shareOptions.get();\n\n      if (module instanceof Promise) {\n        const errorCode =\n          extraOptions?.from === 'build' ? RUNTIME_005 : RUNTIME_006;\n        error(\n          errorCode,\n          runtimeDescMap,\n          {\n            hostName: host.options.name,\n            sharedPkgName: pkgName,\n          },\n          undefined,\n          optionsToMFContext(host.options),\n        );\n      }\n\n      shareOptions.lib = module;\n\n      this.setShared({\n        pkgName,\n        loaded: true,\n        from: host.options.name,\n        lib: shareOptions.lib,\n        shared: shareOptions,\n      });\n      return shareOptions.lib as () => T;\n    }\n\n    error(\n      RUNTIME_006,\n      runtimeDescMap,\n      {\n        hostName: host.options.name,\n        sharedPkgName: pkgName,\n      },\n      undefined,\n      optionsToMFContext(host.options),\n    );\n  }\n\n  initShareScopeMap(\n    scopeName: string,\n    shareScope: ShareScopeMap[string],\n    extraOptions: { hostShareScopeMap?: ShareScopeMap } = {},\n  ): void {\n    const { host } = this;\n    this.shareScopeMap[scopeName] = shareScope;\n    this.hooks.lifecycle.initContainerShareScopeMap.emit({\n      shareScope,\n      options: host.options,\n      origin: host,\n      scopeName,\n      hostShareScopeMap: extraOptions.hostShareScopeMap,\n    });\n  }\n\n  private setShared({\n    pkgName,\n    shared,\n    from,\n    lib,\n    loading,\n    loaded,\n    get,\n    treeShaking,\n  }: {\n    pkgName: string;\n    shared: Shared;\n    from: string;\n    lib: any;\n    loaded?: boolean;\n    loading?: Shared['loading'];\n    get?: Shared['get'];\n    treeShaking?: TreeShakingArgs;\n  }): void {\n    const { version, scope = 'default', ...shareInfo } = shared;\n    const scopes: string[] = Array.isArray(scope) ? scope : [scope];\n\n    const mergeAttrs = (shared: Shared) => {\n      const merge = <K extends keyof TreeShakingArgs>(\n        s: TreeShakingArgs,\n        key: K,\n        val: TreeShakingArgs[K],\n      ): void => {\n        if (val && !s[key]) {\n          s[key] = val;\n        }\n      };\n      const targetShared = (\n        treeShaking ? shared.treeShaking! : shared\n      ) as TreeShakingArgs;\n      merge(targetShared, 'loaded', loaded);\n      merge(targetShared, 'loading', loading);\n      merge(targetShared, 'get', get);\n    };\n    scopes.forEach((sc) => {\n      if (!this.shareScopeMap[sc]) {\n        this.shareScopeMap[sc] = {};\n      }\n      if (!this.shareScopeMap[sc][pkgName]) {\n        this.shareScopeMap[sc][pkgName] = {};\n      }\n\n      if (!this.shareScopeMap[sc][pkgName][version]) {\n        this.shareScopeMap[sc][pkgName][version] = {\n          version,\n          scope: [sc],\n          ...shareInfo,\n          lib,\n        };\n      }\n\n      const registeredShared = this.shareScopeMap[sc][pkgName][version];\n      mergeAttrs(registeredShared);\n      if (from && registeredShared.from !== from) {\n        registeredShared.from = from;\n      }\n    });\n  }\n\n  private _setGlobalShareScopeMap(hostOptions: Options): void {\n    const globalShareScopeMap = getGlobalShareScope();\n    const identifier = hostOptions.id || hostOptions.name;\n    if (identifier && !globalShareScopeMap[identifier]) {\n      globalShareScopeMap[identifier] = this.shareScopeMap;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/type/config.d.ts

@@ -0,0 +1,130 @@
+import { ModuleFederationRuntimePlugin } from "./plugin.js";
+import { Module, RemoteEntryType, RemoteWithEntry, RemoteWithVersion, TreeShakingStatus } from "@module-federation/sdk";
+
+//#region src/type/config.d.ts
+type Optional<T, K extends keyof T> = Omit<T, K> & Partial<T>;
+type PartialOptional<T, K extends keyof T> = Omit<T, K> & { [P in K]-?: T[P] };
+interface RemoteInfoCommon {
+  alias?: string;
+  shareScope?: string | string[];
+  type?: RemoteEntryType;
+  entryGlobalName?: string;
+}
+type RemoteInfoOptionalVersion = {
+  name: string;
+  version?: string;
+} & RemoteInfoCommon;
+type Remote = (RemoteWithEntry | RemoteWithVersion) & RemoteInfoCommon;
+type LoadShareExtraOptions = {
+  customShareInfo?: Partial<Shared>;
+  resolver?: (sharedOptions: ShareInfos[string]) => Shared;
+};
+interface RemoteInfo {
+  alias?: string;
+  name: string;
+  version?: string;
+  buildVersion?: string;
+  entry: string;
+  type: RemoteEntryType;
+  entryGlobalName: string;
+  shareScope: string | string[];
+}
+type HostInfo = Pick<Options, 'name' | 'version' | 'remotes' | 'version'>;
+interface SharedConfig {
+  singleton?: boolean;
+  requiredVersion: false | string;
+  eager?: boolean;
+  strictVersion?: boolean;
+  layer?: string | null;
+}
+type TreeShakingArgs = {
+  usedExports?: string[];
+  get?: SharedGetter;
+  lib?: () => Module;
+  status?: TreeShakingStatus;
+  mode?: 'server-calc' | 'runtime-infer';
+  loading?: null | Promise<any>;
+  loaded?: boolean;
+  useIn?: Array<string>;
+};
+type SharedBaseArgs = {
+  version?: string;
+  shareConfig?: SharedConfig;
+  scope?: string | Array<string>;
+  deps?: Array<string>;
+  strategy?: 'version-first' | 'loaded-first';
+  loaded?: boolean;
+  treeShaking?: TreeShakingArgs;
+};
+type SharedGetter = (() => () => Module) | (() => Promise<() => Module>);
+type ShareArgs = (SharedBaseArgs & {
+  get: SharedGetter;
+}) | (SharedBaseArgs & {
+  lib: () => Module;
+}) | SharedBaseArgs;
+type ShareStrategy = 'version-first' | 'loaded-first';
+type NoMatchedUsedExportsItem = [from: string, usedExports?: string[]];
+type Shared = {
+  version: string;
+  get: SharedGetter;
+  shareConfig: SharedConfig;
+  scope: Array<string>;
+  useIn: Array<string>;
+  from: string;
+  deps: Array<string>;
+  lib?: () => Module;
+  loaded?: boolean;
+  loading?: null | Promise<any>;
+  eager?: boolean;
+  /**
+   * @deprecated set in initOptions.shareStrategy instead
+   */
+  strategy: ShareStrategy;
+  treeShaking?: TreeShakingArgs;
+};
+type ShareScopeMap = {
+  [scope: string]: {
+    [pkgName: string]: {
+      [sharedVersion: string]: Shared;
+    };
+  };
+};
+type GlobalShareScopeMap = {
+  [instanceName: string]: ShareScopeMap;
+};
+type ShareInfos = {
+  [pkgName: string]: Shared[];
+};
+interface Options {
+  id?: string;
+  name: string;
+  version?: string;
+  remotes: Array<Remote>;
+  shared: ShareInfos;
+  plugins: Array<ModuleFederationRuntimePlugin>;
+  inBrowser: boolean;
+  shareStrategy?: ShareStrategy;
+}
+type UserOptions = Omit<Optional<Options, 'plugins'>, 'shared' | 'inBrowser'> & {
+  shared?: {
+    [pkgName: string]: ShareArgs | ShareArgs[];
+  };
+};
+type LoadModuleOptions = {
+  version?: string;
+};
+type RemoteEntryInitOptions = {
+  version: string;
+  shareScopeMap?: ShareScopeMap;
+  shareScopeKeys: string | string[];
+};
+type InitTokens = Record<string, Record<string, any>>;
+type InitScope = InitTokens[];
+type CallFrom = 'build' | 'runtime';
+type RemoteEntryExports = {
+  get: (id: string) => () => Promise<Module>;
+  init: (shareScope: ShareScopeMap[string], initScope?: InitScope, remoteEntryInitOPtions?: RemoteEntryInitOptions) => void | Promise<void>;
+};
+//#endregion
+export { CallFrom, GlobalShareScopeMap, HostInfo, InitScope, InitTokens, LoadModuleOptions, LoadShareExtraOptions, NoMatchedUsedExportsItem, Optional, Options, PartialOptional, Remote, RemoteEntryExports, RemoteEntryInitOptions, RemoteInfo, RemoteInfoCommon, RemoteInfoOptionalVersion, ShareArgs, ShareInfos, ShareScopeMap, ShareStrategy, Shared, SharedConfig, SharedGetter, TreeShakingArgs, UserOptions };
+//# sourceMappingURL=config.d.ts.map

package/dist/type/index.cjs

@@ -0,0 +1,13 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+
+//#region src/type/index.ts
+var type_exports = /* @__PURE__ */ require_runtime.__exportAll({});
+
+//#endregion
+Object.defineProperty(exports, 'type_exports', {
+  enumerable: true,
+  get: function () {
+    return type_exports;
+  }
+});
+//# sourceMappingURL=index.cjs.map

package/dist/type/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/type/index.ts"],"sourcesContent":["export * from './config';\nexport * from './plugin';\nexport * from './preload';\n"],"mappings":""}

package/dist/type/index.d.ts

@@ -0,0 +1,11 @@
+import { ModuleFederationRuntimePlugin } from "./plugin.js";
+import { CallFrom, GlobalShareScopeMap, HostInfo, InitScope, InitTokens, LoadModuleOptions, LoadShareExtraOptions, NoMatchedUsedExportsItem, Optional, Options, PartialOptional, Remote, RemoteEntryExports, RemoteEntryInitOptions, RemoteInfo, RemoteInfoCommon, RemoteInfoOptionalVersion, ShareArgs, ShareInfos, ShareScopeMap, ShareStrategy, Shared, SharedConfig, SharedGetter, TreeShakingArgs, UserOptions } from "./config.js";
+import { EntryAssets, PreloadAssets, PreloadConfig, PreloadOptions, PreloadRemoteArgs, depsPreloadArg } from "./preload.js";
+
+//#region src/type/index.d.ts
+declare namespace index_d_exports {
+  export { CallFrom, EntryAssets, GlobalShareScopeMap, HostInfo, InitScope, InitTokens, LoadModuleOptions, LoadShareExtraOptions, ModuleFederationRuntimePlugin, NoMatchedUsedExportsItem, Optional, Options, PartialOptional, PreloadAssets, PreloadConfig, PreloadOptions, PreloadRemoteArgs, Remote, RemoteEntryExports, RemoteEntryInitOptions, RemoteInfo, RemoteInfoCommon, RemoteInfoOptionalVersion, ShareArgs, ShareInfos, ShareScopeMap, ShareStrategy, Shared, SharedConfig, SharedGetter, TreeShakingArgs, UserOptions, depsPreloadArg };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.ts.map

package/dist/type/index.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+
+//#region src/type/index.ts
+var type_exports = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+export { type_exports };
+//# sourceMappingURL=index.js.map

package/dist/type/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/type/index.ts"],"sourcesContent":["export * from './config';\nexport * from './plugin';\nexport * from './preload';\n"],"mappings":""}

package/dist/type/plugin.d.ts

@@ -0,0 +1,27 @@
+import { Module } from "../module/index.js";
+import { SnapshotHandler } from "../plugins/snapshot/SnapshotHandler.js";
+import { RemoteHandler } from "../remote/index.js";
+import { SharedHandler } from "../shared/index.js";
+import { ModuleFederation } from "../core.js";
+
+//#region src/type/plugin.d.ts
+type CoreLifeCycle = ModuleFederation['hooks']['lifecycle'];
+type CoreLifeCyclePartial = Partial<{ [k in keyof CoreLifeCycle]: Parameters<CoreLifeCycle[k]['on']>[0] }>;
+type SnapshotLifeCycle = SnapshotHandler['hooks']['lifecycle'];
+type SnapshotLifeCycleCyclePartial = Partial<{ [k in keyof SnapshotLifeCycle]: Parameters<SnapshotLifeCycle[k]['on']>[0] }>;
+type ModuleLifeCycle = Module['host']['loaderHook']['lifecycle'];
+type ModuleLifeCycleCyclePartial = Partial<{ [k in keyof ModuleLifeCycle]: Parameters<ModuleLifeCycle[k]['on']>[0] }>;
+type ModuleBridgeLifeCycle = Module['host']['bridgeHook']['lifecycle'];
+type ModuleBridgeLifeCycleCyclePartial = Partial<{ [k in keyof ModuleBridgeLifeCycle]: Parameters<ModuleBridgeLifeCycle[k]['on']>[0] }>;
+type SharedLifeCycle = SharedHandler['hooks']['lifecycle'];
+type SharedLifeCycleCyclePartial = Partial<{ [k in keyof SharedLifeCycle]: Parameters<SharedLifeCycle[k]['on']>[0] }>;
+type RemoteLifeCycle = RemoteHandler['hooks']['lifecycle'];
+type RemoteLifeCycleCyclePartial = Partial<{ [k in keyof RemoteLifeCycle]: Parameters<RemoteLifeCycle[k]['on']>[0] }>;
+type ModuleFederationRuntimePlugin = CoreLifeCyclePartial & SnapshotLifeCycleCyclePartial & SharedLifeCycleCyclePartial & RemoteLifeCycleCyclePartial & ModuleLifeCycleCyclePartial & ModuleBridgeLifeCycleCyclePartial & {
+  name: string;
+  version?: string;
+  apply?: (instance: ModuleFederation) => void;
+};
+//#endregion
+export { ModuleFederationRuntimePlugin };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/type/preload.d.ts

@@ -0,0 +1,31 @@
+import { Remote, RemoteInfo } from "./config.js";
+
+//#region src/type/preload.d.ts
+type depsPreloadArg = Omit<PreloadRemoteArgs, 'depsRemote'>;
+interface PreloadRemoteArgs {
+  nameOrAlias: string;
+  exposes?: Array<string>;
+  resourceCategory?: 'all' | 'sync';
+  share?: boolean;
+  depsRemote?: boolean | Array<depsPreloadArg>;
+  filter?: (assetUrl: string) => boolean;
+  prefetchInterface?: boolean;
+}
+type PreloadConfig = PreloadRemoteArgs;
+type PreloadOptions = Array<{
+  remote: Remote;
+  preloadConfig: PreloadConfig;
+}>;
+type EntryAssets = {
+  name: string;
+  url: string;
+  moduleInfo: RemoteInfo;
+};
+interface PreloadAssets {
+  cssAssets: Array<string>;
+  jsAssetsWithoutEntry: Array<string>;
+  entryAssets: Array<EntryAssets>;
+}
+//#endregion
+export { EntryAssets, PreloadAssets, PreloadConfig, PreloadOptions, PreloadRemoteArgs, depsPreloadArg };
+//# sourceMappingURL=preload.d.ts.map

package/dist/types.d.ts

@@ -1 +1,4 @@
-export * from "./src/types";
+import { ModuleFederationRuntimePlugin } from "./type/plugin.js";
+import { CallFrom, GlobalShareScopeMap, HostInfo, InitScope, InitTokens, LoadModuleOptions, LoadShareExtraOptions, NoMatchedUsedExportsItem, Optional, Options, PartialOptional, Remote, RemoteEntryExports, RemoteEntryInitOptions, RemoteInfo, RemoteInfoCommon, RemoteInfoOptionalVersion, ShareArgs, ShareInfos, ShareScopeMap, ShareStrategy, Shared, SharedConfig, SharedGetter, TreeShakingArgs, UserOptions } from "./type/config.js";
+import { EntryAssets, PreloadAssets, PreloadConfig, PreloadOptions, PreloadRemoteArgs, depsPreloadArg } from "./type/preload.js";
+export { CallFrom, EntryAssets, GlobalShareScopeMap, HostInfo, InitScope, InitTokens, LoadModuleOptions, LoadShareExtraOptions, ModuleFederationRuntimePlugin, NoMatchedUsedExportsItem, Optional, Options, PartialOptional, PreloadAssets, PreloadConfig, PreloadOptions, PreloadRemoteArgs, Remote, RemoteEntryExports, RemoteEntryInitOptions, RemoteInfo, RemoteInfoCommon, RemoteInfoOptionalVersion, ShareArgs, ShareInfos, ShareScopeMap, ShareStrategy, Shared, SharedConfig, SharedGetter, TreeShakingArgs, UserOptions, depsPreloadArg };

package/dist/types.js

@@ -0,0 +1 @@
+export {  };

package/dist/utils/context.cjs

@@ -0,0 +1,45 @@
+
+//#region src/utils/context.ts
+function remoteToEntry(r) {
+	return {
+		name: r.name,
+		alias: r.alias,
+		entry: "entry" in r ? r.entry : void 0,
+		version: "version" in r ? r.version : void 0,
+		type: r.type,
+		entryGlobalName: r.entryGlobalName,
+		shareScope: r.shareScope
+	};
+}
+/**
+* Build a partial MFContext from runtime Options.
+* Used to enrich diagnostic entries with host context at error sites.
+*/
+function optionsToMFContext(options) {
+	const shared = {};
+	for (const [pkgName, versions] of Object.entries(options.shared)) {
+		const first = versions[0];
+		if (first) shared[pkgName] = {
+			version: first.version,
+			singleton: first.shareConfig?.singleton,
+			requiredVersion: first.shareConfig?.requiredVersion === false ? false : first.shareConfig?.requiredVersion,
+			eager: first.eager,
+			strictVersion: first.shareConfig?.strictVersion
+		};
+	}
+	return {
+		project: {
+			name: options.name,
+			mfRole: options.remotes?.length > 0 ? "host" : "unknown"
+		},
+		mfConfig: {
+			name: options.name,
+			remotes: options.remotes?.map(remoteToEntry) ?? [],
+			shared
+		}
+	};
+}
+
+//#endregion
+exports.optionsToMFContext = optionsToMFContext;
+//# sourceMappingURL=context.cjs.map

package/dist/utils/context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.cjs","names":[],"sources":["../../src/utils/context.ts"],"sourcesContent":["import type { MFContext } from '@module-federation/error-codes';\nimport type { Options, Remote } from '../type';\n\nfunction remoteToEntry(\n  r: Remote,\n): import('@module-federation/error-codes').MFRemoteEntry {\n  return {\n    name: r.name,\n    alias: r.alias,\n    entry: 'entry' in r ? (r as { entry: string }).entry : undefined,\n    version: 'version' in r ? (r as { version: string }).version : undefined,\n    type: r.type,\n    entryGlobalName: r.entryGlobalName,\n    shareScope: r.shareScope,\n  };\n}\n\n/**\n * Build a partial MFContext from runtime Options.\n * Used to enrich diagnostic entries with host context at error sites.\n */\nexport function optionsToMFContext(options: Options): Partial<MFContext> {\n  const shared: MFContext['mfConfig'] extends undefined\n    ? never\n    : NonNullable<MFContext['mfConfig']>['shared'] = {};\n\n  for (const [pkgName, versions] of Object.entries(options.shared)) {\n    const first = versions[0];\n    if (first) {\n      shared[pkgName] = {\n        version: first.version,\n        singleton: first.shareConfig?.singleton,\n        requiredVersion:\n          first.shareConfig?.requiredVersion === false\n            ? false\n            : first.shareConfig?.requiredVersion,\n        eager: first.eager,\n        strictVersion: first.shareConfig?.strictVersion,\n      };\n    }\n  }\n\n  return {\n    project: {\n      name: options.name,\n      mfRole: options.remotes?.length > 0 ? 'host' : 'unknown',\n    },\n    mfConfig: {\n      name: options.name,\n      remotes: options.remotes?.map(remoteToEntry) ?? [],\n      shared,\n    },\n  };\n}\n"],"mappings":";;AAGA,SAAS,cACP,GACwD;AACxD,QAAO;EACL,MAAM,EAAE;EACR,OAAO,EAAE;EACT,OAAO,WAAW,IAAK,EAAwB,QAAQ;EACvD,SAAS,aAAa,IAAK,EAA0B,UAAU;EAC/D,MAAM,EAAE;EACR,iBAAiB,EAAE;EACnB,YAAY,EAAE;EACf;;;;;;AAOH,SAAgB,mBAAmB,SAAsC;CACvE,MAAM,SAE6C,EAAE;AAErD,MAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,QAAQ,OAAO,EAAE;EAChE,MAAM,QAAQ,SAAS;AACvB,MAAI,MACF,QAAO,WAAW;GAChB,SAAS,MAAM;GACf,WAAW,MAAM,aAAa;GAC9B,iBACE,MAAM,aAAa,oBAAoB,QACnC,QACA,MAAM,aAAa;GACzB,OAAO,MAAM;GACb,eAAe,MAAM,aAAa;GACnC;;AAIL,QAAO;EACL,SAAS;GACP,MAAM,QAAQ;GACd,QAAQ,QAAQ,SAAS,SAAS,IAAI,SAAS;GAChD;EACD,UAAU;GACR,MAAM,QAAQ;GACd,SAAS,QAAQ,SAAS,IAAI,cAAc,IAAI,EAAE;GAClD;GACD;EACF"}

package/dist/utils/context.d.ts

@@ -0,0 +1 @@
+import { MFContext } from "@module-federation/error-codes";