@module-federation/runtime-core 0.0.0-next-20250515032632 → 0.0.0-next-20250522105937

package/dist/index.cjs.cjs

@@ -48,7 +48,7 @@ function isRemoteInfoWithEntry(remote) {
     return typeof remote.entry !== 'undefined';
 }
 function isPureRemoteEntry(remote) {
-    return !remote.entry.includes('.json') && remote.entry.includes('.js');
+    return !remote.entry.includes('.json');
 }
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 async function safeWrapper(callback, disableWarn) {
@@ -196,7 +196,7 @@ function getGlobalFederationConstructor() {
 function setGlobalFederationConstructor(FederationConstructor, isDebug = sdk.isDebugMode()) {
     if (isDebug) {
         CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR__ = FederationConstructor;
-        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.13.1";
+        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.14.0";
     }
 }
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -648,7 +648,6 @@ function satisfy(version, range) {
     }
     const [, versionOperator, , versionMajor, versionMinor, versionPatch, versionPreRelease] = extractedVersion;
     const versionAtom = {
-        operator: versionOperator,
         version: combineVersion(versionMajor, versionMinor, versionPatch, versionPreRelease),
         major: versionMajor,
         minor: versionMinor,
@@ -1008,12 +1007,13 @@ function registerPlugins(plugins, hookInstances) {
     return plugins;
 }
 
+const importCallback = '.then(callbacks[0]).catch(callbacks[1])';
 async function loadEsmEntry({ entry, remoteEntryExports }) {
     return new Promise((resolve, reject)=>{
         try {
             if (!remoteEntryExports) {
                 if (typeof FEDERATION_ALLOW_NEW_FUNCTION !== 'undefined') {
-                    new Function('callbacks', `import("${entry}").then(callbacks[0]).catch(callbacks[1])`)([
+                    new Function('callbacks', `import("${entry}")${importCallback}`)([
                         resolve,
                         reject
                     ]);
@@ -1037,7 +1037,7 @@ async function loadSystemJsEntry({ entry, remoteEntryExports }) {
                     //@ts-ignore
                     System.import(entry).then(resolve).catch(reject);
                 } else {
-                    new Function('callbacks', `System.import("${entry}").then(callbacks[0]).catch(callbacks[1])`)([
+                    new Function('callbacks', `System.import("${entry}")${importCallback}`)([
                         resolve,
                         reject
                     ]);
@@ -1050,6 +1050,15 @@ async function loadSystemJsEntry({ entry, remoteEntryExports }) {
         }
     });
 }
+function handleRemoteEntryLoaded(name, globalName, entry) {
+    const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
+    assert(entryExports, errorCodes.getShortErrorMsg(errorCodes.RUNTIME_001, errorCodes.runtimeDescMap, {
+        remoteName: name,
+        remoteEntryUrl: entry,
+        remoteEntryKey
+    }));
+    return entryExports;
+}
 async function loadEntryScript({ name, globalName, entry, loaderHook }) {
     const { entryExports: remoteEntryExports } = getRemoteEntryExports(name, globalName);
     if (remoteEntryExports) {
@@ -1072,13 +1081,7 @@ async function loadEntryScript({ name, globalName, entry, loaderHook }) {
             return;
         }
     }).then(()=>{
-        const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
-        assert(entryExports, errorCodes.getShortErrorMsg(errorCodes.RUNTIME_001, errorCodes.runtimeDescMap, {
-            remoteName: name,
-            remoteEntryUrl: entry,
-            remoteEntryKey
-        }));
-        return entryExports;
+        return handleRemoteEntryLoaded(name, globalName, entry);
     }).catch((e)=>{
         assert(undefined, errorCodes.getShortErrorMsg(errorCodes.RUNTIME_008, errorCodes.runtimeDescMap, {
             remoteName: name,
@@ -1136,13 +1139,7 @@ async function loadEntryNode({ remoteInfo, loaderHook }) {
             }
         }
     }).then(()=>{
-        const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
-        assert(entryExports, errorCodes.getShortErrorMsg(errorCodes.RUNTIME_001, errorCodes.runtimeDescMap, {
-            remoteName: name,
-            remoteEntryUrl: entry,
-            remoteEntryKey
-        }));
-        return entryExports;
+        return handleRemoteEntryLoaded(name, globalName, entry);
     }).catch((e)=>{
         throw e;
     });
@@ -1167,7 +1164,9 @@ async function getRemoteEntry({ origin, remoteEntryExports, remoteInfo }) {
             if (res) {
                 return res;
             }
-            return sdk.isBrowserEnv() ? loadEntryDom({
+            // Use ENV_TARGET if defined, otherwise fallback to isBrowserEnv, must keep this
+            const isWebEnvironment = typeof ENV_TARGET !== 'undefined' ? ENV_TARGET === 'web' : sdk.isBrowserEnv();
+            return isWebEnvironment ? loadEntryDom({
                 remoteInfo,
                 remoteEntryExports,
                 loaderHook
@@ -1692,9 +1691,12 @@ function snapshotPlugin() {
     return {
         name: 'snapshot-plugin',
         async afterResolve (args) {
-            const { remote, pkgNameOrAlias, expose, origin, remoteInfo } = args;
+            const { remote, pkgNameOrAlias, expose, origin, remoteInfo, id } = args;
             if (!isRemoteInfoWithEntry(remote) || !isPureRemoteEntry(remote)) {
-                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo(remote);
+                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo({
+                    moduleInfo: remote,
+                    id
+                });
                 assignRemoteInfo(remoteInfo, remoteSnapshot);
                 // preloading assets
                 const preloadOptions = {
@@ -1953,7 +1955,7 @@ const generatePreloadAssetsPlugin = function() {
 
 function getGlobalRemoteInfo(moduleInfo, origin) {
     const hostGlobalSnapshot = getGlobalSnapshotInfoByModuleInfo({
-        name: origin.options.name,
+        name: origin.name,
         version: origin.options.version
     });
     // get remote detail info from global
@@ -1978,23 +1980,8 @@ function getGlobalRemoteInfo(moduleInfo, origin) {
     };
 }
 class SnapshotHandler {
-    async loadSnapshot(moduleInfo) {
-        const { options } = this.HostInstance;
-        const { hostGlobalSnapshot, remoteSnapshot, globalSnapshot } = this.getGlobalRemoteInfo(moduleInfo);
-        const { remoteSnapshot: globalRemoteSnapshot, globalSnapshot: globalSnapshotRes } = await this.hooks.lifecycle.loadSnapshot.emit({
-            options,
-            moduleInfo,
-            hostGlobalSnapshot,
-            remoteSnapshot,
-            globalSnapshot
-        });
-        return {
-            remoteSnapshot: globalRemoteSnapshot,
-            globalSnapshot: globalSnapshotRes
-        };
-    }
     // eslint-disable-next-line max-lines-per-function
-    async loadRemoteSnapshotInfo(moduleInfo) {
+    async loadRemoteSnapshotInfo({ moduleInfo, id, expose }) {
         const { options } = this.HostInstance;
         await this.hooks.lifecycle.beforeLoadRemoteSnapshot.emit({
             options,
@@ -2081,6 +2068,8 @@ class SnapshotHandler {
             }
         }
         await this.hooks.lifecycle.afterLoadSnapshot.emit({
+            id,
+            host: this.HostInstance,
             options,
             moduleInfo,
             remoteSnapshot: mSnapshot
@@ -2618,7 +2607,9 @@ class RemoteHandler {
         await Promise.all(preloadOps.map(async (ops)=>{
             const { remote } = ops;
             const remoteInfo = getRemoteInfo(remote);
-            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo(remote);
+            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo({
+                moduleInfo: remote
+            });
             const assets = await this.hooks.lifecycle.generatePreloadAssets.emit({
                 origin: host,
                 preloadOptions: ops,
@@ -2872,6 +2863,7 @@ class RemoteHandler {
     }
 }
 
+const USE_SNAPSHOT = typeof FEDERATION_OPTIMIZE_NO_SNAPSHOT_PLUGIN === 'boolean' ? !FEDERATION_OPTIMIZE_NO_SNAPSHOT_PLUGIN : true; // Default to true (use snapshot) when not explicitly defined
 class FederationHost {
     initOptions(userOptions) {
         this.registerPlugins(userOptions.plugins);
@@ -2978,7 +2970,7 @@ class FederationHost {
             // maybe will change, temporarily for internal use only
             initContainer: new AsyncWaterfallHook('initContainer')
         });
-        this.version = "0.13.1";
+        this.version = "0.14.0";
         this.moduleCache = new Map();
         this.loaderHook = new PluginSystem({
             // FIXME: may not be suitable , not open to the public yet
@@ -2995,15 +2987,16 @@ class FederationHost {
             beforeBridgeDestroy: new SyncHook(),
             afterBridgeDestroy: new SyncHook()
         });
+        const plugins = USE_SNAPSHOT ? [
+            snapshotPlugin(),
+            generatePreloadAssetsPlugin()
+        ] : [];
         // TODO: Validate the details of the options
         // Initialize options with default values
         const defaultOptions = {
             id: getBuilderId(),
             name: userOptions.name,
-            plugins: [
-                snapshotPlugin(),
-                generatePreloadAssetsPlugin()
-            ],
+            plugins,
             remotes: [],
             shared: {},
             inBrowser: sdk.isBrowserEnv()

package/dist/index.esm.js

@@ -1,7 +1,7 @@
 import { _ as _extends, a as _object_without_properties_loose } from './polyfills.esm.js';
-import { createLogger, isBrowserEnv, isReactNativeEnv, isDebugMode, loadScriptNode, composeKeyWithSeparator, loadScript, safeToString, createLink, createScript, getResourceUrl, isManifestProvider, generateSnapshotFromManifest, warn as warn$1 } from '@module-federation/sdk';
+import { createLogger, isBrowserEnv, isReactNativeEnv, isDebugMode, composeKeyWithSeparator, loadScriptNode, loadScript, safeToString, createLink, createScript, getResourceUrl, isManifestProvider, generateSnapshotFromManifest, warn as warn$1 } from '@module-federation/sdk';
 export { loadScript, loadScriptNode } from '@module-federation/sdk';
-import { getShortErrorMsg, RUNTIME_001, runtimeDescMap, RUNTIME_008, RUNTIME_002, RUNTIME_007, RUNTIME_003, RUNTIME_005, RUNTIME_006, RUNTIME_004 } from '@module-federation/error-codes';
+import { getShortErrorMsg, RUNTIME_008, runtimeDescMap, RUNTIME_001, RUNTIME_002, RUNTIME_007, RUNTIME_003, RUNTIME_005, RUNTIME_006, RUNTIME_004 } from '@module-federation/error-codes';
 
 const LOG_CATEGORY = '[ Federation Runtime ]';
 // FIXME: pre-bundle ?
@@ -47,7 +47,7 @@ function isRemoteInfoWithEntry(remote) {
     return typeof remote.entry !== 'undefined';
 }
 function isPureRemoteEntry(remote) {
-    return !remote.entry.includes('.json') && remote.entry.includes('.js');
+    return !remote.entry.includes('.json');
 }
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 async function safeWrapper(callback, disableWarn) {
@@ -195,7 +195,7 @@ function getGlobalFederationConstructor() {
 function setGlobalFederationConstructor(FederationConstructor, isDebug = isDebugMode()) {
     if (isDebug) {
         CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR__ = FederationConstructor;
-        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.13.1";
+        CurrentGlobal.__FEDERATION__.__DEBUG_CONSTRUCTOR_VERSION__ = "0.14.0";
     }
 }
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -647,7 +647,6 @@ function satisfy(version, range) {
     }
     const [, versionOperator, , versionMajor, versionMinor, versionPatch, versionPreRelease] = extractedVersion;
     const versionAtom = {
-        operator: versionOperator,
         version: combineVersion(versionMajor, versionMinor, versionPatch, versionPreRelease),
         major: versionMajor,
         minor: versionMinor,
@@ -1007,12 +1006,13 @@ function registerPlugins(plugins, hookInstances) {
     return plugins;
 }
 
+const importCallback = '.then(callbacks[0]).catch(callbacks[1])';
 async function loadEsmEntry({ entry, remoteEntryExports }) {
     return new Promise((resolve, reject)=>{
         try {
             if (!remoteEntryExports) {
                 if (typeof FEDERATION_ALLOW_NEW_FUNCTION !== 'undefined') {
-                    new Function('callbacks', `import("${entry}").then(callbacks[0]).catch(callbacks[1])`)([
+                    new Function('callbacks', `import("${entry}")${importCallback}`)([
                         resolve,
                         reject
                     ]);
@@ -1036,7 +1036,7 @@ async function loadSystemJsEntry({ entry, remoteEntryExports }) {
                     //@ts-ignore
                     System.import(entry).then(resolve).catch(reject);
                 } else {
-                    new Function('callbacks', `System.import("${entry}").then(callbacks[0]).catch(callbacks[1])`)([
+                    new Function('callbacks', `System.import("${entry}")${importCallback}`)([
                         resolve,
                         reject
                     ]);
@@ -1049,6 +1049,15 @@ async function loadSystemJsEntry({ entry, remoteEntryExports }) {
         }
     });
 }
+function handleRemoteEntryLoaded(name, globalName, entry) {
+    const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
+    assert(entryExports, getShortErrorMsg(RUNTIME_001, runtimeDescMap, {
+        remoteName: name,
+        remoteEntryUrl: entry,
+        remoteEntryKey
+    }));
+    return entryExports;
+}
 async function loadEntryScript({ name, globalName, entry, loaderHook }) {
     const { entryExports: remoteEntryExports } = getRemoteEntryExports(name, globalName);
     if (remoteEntryExports) {
@@ -1071,13 +1080,7 @@ async function loadEntryScript({ name, globalName, entry, loaderHook }) {
             return;
         }
     }).then(()=>{
-        const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
-        assert(entryExports, getShortErrorMsg(RUNTIME_001, runtimeDescMap, {
-            remoteName: name,
-            remoteEntryUrl: entry,
-            remoteEntryKey
-        }));
-        return entryExports;
+        return handleRemoteEntryLoaded(name, globalName, entry);
     }).catch((e)=>{
         assert(undefined, getShortErrorMsg(RUNTIME_008, runtimeDescMap, {
             remoteName: name,
@@ -1135,13 +1138,7 @@ async function loadEntryNode({ remoteInfo, loaderHook }) {
             }
         }
     }).then(()=>{
-        const { remoteEntryKey, entryExports } = getRemoteEntryExports(name, globalName);
-        assert(entryExports, getShortErrorMsg(RUNTIME_001, runtimeDescMap, {
-            remoteName: name,
-            remoteEntryUrl: entry,
-            remoteEntryKey
-        }));
-        return entryExports;
+        return handleRemoteEntryLoaded(name, globalName, entry);
     }).catch((e)=>{
         throw e;
     });
@@ -1166,7 +1163,9 @@ async function getRemoteEntry({ origin, remoteEntryExports, remoteInfo }) {
             if (res) {
                 return res;
             }
-            return isBrowserEnv() ? loadEntryDom({
+            // Use ENV_TARGET if defined, otherwise fallback to isBrowserEnv, must keep this
+            const isWebEnvironment = typeof ENV_TARGET !== 'undefined' ? ENV_TARGET === 'web' : isBrowserEnv();
+            return isWebEnvironment ? loadEntryDom({
                 remoteInfo,
                 remoteEntryExports,
                 loaderHook
@@ -1691,9 +1690,12 @@ function snapshotPlugin() {
     return {
         name: 'snapshot-plugin',
         async afterResolve (args) {
-            const { remote, pkgNameOrAlias, expose, origin, remoteInfo } = args;
+            const { remote, pkgNameOrAlias, expose, origin, remoteInfo, id } = args;
             if (!isRemoteInfoWithEntry(remote) || !isPureRemoteEntry(remote)) {
-                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo(remote);
+                const { remoteSnapshot, globalSnapshot } = await origin.snapshotHandler.loadRemoteSnapshotInfo({
+                    moduleInfo: remote,
+                    id
+                });
                 assignRemoteInfo(remoteInfo, remoteSnapshot);
                 // preloading assets
                 const preloadOptions = {
@@ -1952,7 +1954,7 @@ const generatePreloadAssetsPlugin = function() {
 
 function getGlobalRemoteInfo(moduleInfo, origin) {
     const hostGlobalSnapshot = getGlobalSnapshotInfoByModuleInfo({
-        name: origin.options.name,
+        name: origin.name,
         version: origin.options.version
     });
     // get remote detail info from global
@@ -1977,23 +1979,8 @@ function getGlobalRemoteInfo(moduleInfo, origin) {
     };
 }
 class SnapshotHandler {
-    async loadSnapshot(moduleInfo) {
-        const { options } = this.HostInstance;
-        const { hostGlobalSnapshot, remoteSnapshot, globalSnapshot } = this.getGlobalRemoteInfo(moduleInfo);
-        const { remoteSnapshot: globalRemoteSnapshot, globalSnapshot: globalSnapshotRes } = await this.hooks.lifecycle.loadSnapshot.emit({
-            options,
-            moduleInfo,
-            hostGlobalSnapshot,
-            remoteSnapshot,
-            globalSnapshot
-        });
-        return {
-            remoteSnapshot: globalRemoteSnapshot,
-            globalSnapshot: globalSnapshotRes
-        };
-    }
     // eslint-disable-next-line max-lines-per-function
-    async loadRemoteSnapshotInfo(moduleInfo) {
+    async loadRemoteSnapshotInfo({ moduleInfo, id, expose }) {
         const { options } = this.HostInstance;
         await this.hooks.lifecycle.beforeLoadRemoteSnapshot.emit({
             options,
@@ -2080,6 +2067,8 @@ class SnapshotHandler {
             }
         }
         await this.hooks.lifecycle.afterLoadSnapshot.emit({
+            id,
+            host: this.HostInstance,
             options,
             moduleInfo,
             remoteSnapshot: mSnapshot
@@ -2617,7 +2606,9 @@ class RemoteHandler {
         await Promise.all(preloadOps.map(async (ops)=>{
             const { remote } = ops;
             const remoteInfo = getRemoteInfo(remote);
-            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo(remote);
+            const { globalSnapshot, remoteSnapshot } = await host.snapshotHandler.loadRemoteSnapshotInfo({
+                moduleInfo: remote
+            });
             const assets = await this.hooks.lifecycle.generatePreloadAssets.emit({
                 origin: host,
                 preloadOptions: ops,
@@ -2871,6 +2862,7 @@ class RemoteHandler {
     }
 }
 
+const USE_SNAPSHOT = typeof FEDERATION_OPTIMIZE_NO_SNAPSHOT_PLUGIN === 'boolean' ? !FEDERATION_OPTIMIZE_NO_SNAPSHOT_PLUGIN : true; // Default to true (use snapshot) when not explicitly defined
 class FederationHost {
     initOptions(userOptions) {
         this.registerPlugins(userOptions.plugins);
@@ -2977,7 +2969,7 @@ class FederationHost {
             // maybe will change, temporarily for internal use only
             initContainer: new AsyncWaterfallHook('initContainer')
         });
-        this.version = "0.13.1";
+        this.version = "0.14.0";
         this.moduleCache = new Map();
         this.loaderHook = new PluginSystem({
             // FIXME: may not be suitable , not open to the public yet
@@ -2994,15 +2986,16 @@ class FederationHost {
             beforeBridgeDestroy: new SyncHook(),
             afterBridgeDestroy: new SyncHook()
         });
+        const plugins = USE_SNAPSHOT ? [
+            snapshotPlugin(),
+            generatePreloadAssetsPlugin()
+        ] : [];
         // TODO: Validate the details of the options
         // Initialize options with default values
         const defaultOptions = {
             id: getBuilderId(),
             name: userOptions.name,
-            plugins: [
-                snapshotPlugin(),
-                generatePreloadAssetsPlugin()
-            ],
+            plugins,
             remotes: [],
             shared: {},
             inBrowser: isBrowserEnv()

package/dist/src/plugins/snapshot/SnapshotHandler.d.ts

@@ -33,6 +33,8 @@ export declare class SnapshotHandler {
             from: "global" | "manifest";
         }>;
         afterLoadSnapshot: AsyncWaterfallHook<{
+            id?: string;
+            host: FederationHost;
             options: Options;
             moduleInfo: Remote;
             remoteSnapshot: ModuleInfo;
@@ -41,11 +43,11 @@ export declare class SnapshotHandler {
     loaderHook: FederationHost['loaderHook'];
     manifestLoading: Record<string, Promise<ModuleInfo>>;
     constructor(HostInstance: FederationHost);
-    loadSnapshot(moduleInfo: Remote): Promise<{
-        remoteSnapshot: GlobalModuleInfo[string] | undefined;
-        globalSnapshot: ReturnType<typeof getGlobalSnapshot>;
-    }>;
-    loadRemoteSnapshotInfo(moduleInfo: Remote): Promise<{
+    loadRemoteSnapshotInfo({ moduleInfo, id, expose, }: {
+        moduleInfo: Remote;
+        id?: string;
+        expose?: string;
+    }): Promise<{
         remoteSnapshot: ModuleInfo;
         globalSnapshot: GlobalModuleInfo;
     }> | never;

package/dist/src/type/config.d.ts

@@ -20,6 +20,7 @@ export type LoadShareExtraOptions = {
     resolver?: (sharedOptions: ShareInfos[string]) => Shared;
 };
 export interface RemoteInfo {
+    alias?: string;
     name: string;
     version?: string;
     buildVersion?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/runtime-core",
-  "version": "0.0.0-next-20250515032632",
+  "version": "0.0.0-next-20250522105937",
   "type": "module",
   "author": "zhouxiao <codingzx@gmail.com>",
   "main": "./dist/index.cjs.cjs",
@@ -52,7 +52,7 @@
     }
   },
   "dependencies": {
-    "@module-federation/sdk": "0.0.0-next-20250515032632",
-    "@module-federation/error-codes": "0.0.0-next-20250515032632"
+    "@module-federation/sdk": "0.0.0-next-20250522105937",
+    "@module-federation/error-codes": "0.0.0-next-20250522105937"
   }
 }