@module-federation/sdk 2.0.1 → 2.2.0

package/dist/types/plugins/ProvideSharedPlugin.d.ts

@@ -0,0 +1,97 @@
+import { IncludeExcludeOptions } from "./ConsumeSharedPlugin.js";
+
+//#region src/types/plugins/ProvideSharedPlugin.d.ts
+declare namespace ProvideSharedPlugin_d_exports {
+  export { ProvideSharedPluginOptions, Provides, ProvidesConfig, ProvidesItem, ProvidesObject };
+}
+/**
+ * Request to a module that should be provided as shared module to the share scope (will be resolved when relative).
+ */
+type ProvidesItem = string;
+/**
+ * Advanced configuration for modules that should be provided as shared modules to the share scope.
+ */
+interface ProvidesConfig {
+  /**
+   * Include the provided module directly instead behind an async request. This allows to use this shared module in initial load too. All possible shared modules need to be eager too.
+   */
+  eager?: boolean;
+  /**
+   * Key in the share scope under which the shared modules should be stored.
+   */
+  shareKey?: string;
+  /**
+   * Import request to match on
+   */
+  request?: string;
+  /**
+   * Share scope name.
+   */
+  shareScope?: string | string[];
+  /**
+   * Version requirement from module in share scope.
+   */
+  requiredVersion?: false | string;
+  /**
+   * Do not accept shared module if version is not valid (defaults to yes, if local fallback module is available and shared module is not a singleton, otherwise no, has no effect if there is no required version specified).
+   */
+  strictVersion?: boolean;
+  /**
+   * Allow only a single version of the shared module in share scope (disabled by default).
+   */
+  singleton?: boolean;
+  /**
+   * Layer in which the shared module should be placed.
+   */
+  layer?: string;
+  /**
+   * Layer of the issuer.
+   */
+  issuerLayer?: string;
+  /**
+   * Version of the provided module. Will replace lower matching versions, but not higher.
+   */
+  version?: false | string;
+  /**
+   * Filter for the shared module.
+   */
+  exclude?: IncludeExcludeOptions;
+  /**
+   * Options for including only certain versions or requests of the provided module. Cannot be used with 'exclude'.
+   */
+  include?: IncludeExcludeOptions;
+  /**
+   * Enable reconstructed lookup for node_modules paths for this share item
+   */
+  allowNodeModulesSuffixMatch?: boolean;
+  /**
+   * Tree shaking mode for the shared module.
+   */
+  treeShakingMode?: 'server-calc' | 'runtime-infer';
+}
+/**
+ * Modules that should be provided as shared modules to the share scope. Property names are used as share keys.
+ */
+interface ProvidesObject {
+  [k: string]: ProvidesConfig | ProvidesItem;
+}
+/**
+ * Modules that should be provided as shared modules to the share scope. When provided, property name is used to match modules, otherwise this is automatically inferred from share key.
+ */
+type Provides = (ProvidesItem | ProvidesObject)[] | ProvidesObject;
+interface ProvideSharedPluginOptions {
+  provides: Provides;
+  /**
+   * Share scope name used for all provided modules (defaults to 'default').
+   */
+  shareScope?: string | string[];
+  /**
+   * Experimental features configuration
+   */
+  experiments?: {
+    /** Enable reconstructed lookup for node_modules paths */allowNodeModulesSuffixMatch?: boolean;
+  };
+}
+//#endregion
+export { ProvideSharedPlugin_d_exports };
+//# sourceMappingURL=ProvideSharedPlugin.d.ts.map

package/dist/types/plugins/ProvideSharedPlugin.js

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

package/dist/types/plugins/ProvideSharedPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProvideSharedPlugin.js","names":[],"sources":["../../../src/types/plugins/ProvideSharedPlugin.ts"],"sourcesContent":["/*\n * This file was automatically generated.\n * DO NOT MODIFY BY HAND.\n * Run `pnpm generate:schema -w` to update.\n */\n\nimport type { IncludeExcludeOptions } from './ConsumeSharedPlugin';\n\n/**\n * Request to a module that should be provided as shared module to the share scope (will be resolved when relative).\n */\nexport type ProvidesItem = string;\n\n/**\n * Advanced configuration for modules that should be provided as shared modules to the share scope.\n */\nexport interface ProvidesConfig {\n  /**\n   * Include the provided module directly instead behind an async request. This allows to use this shared module in initial load too. All possible shared modules need to be eager too.\n   */\n  eager?: boolean;\n  /**\n   * Key in the share scope under which the shared modules should be stored.\n   */\n  shareKey?: string;\n  /**\n   * Import request to match on\n   */\n  request?: string;\n  /**\n   * Share scope name.\n   */\n  shareScope?: string | string[];\n  /**\n   * Version requirement from module in share scope.\n   */\n  requiredVersion?: false | string;\n  /**\n   * Do not accept shared module if version is not valid (defaults to yes, if local fallback module is available and shared module is not a singleton, otherwise no, has no effect if there is no required version specified).\n   */\n  strictVersion?: boolean;\n  /**\n   * Allow only a single version of the shared module in share scope (disabled by default).\n   */\n  singleton?: boolean;\n  /**\n   * Layer in which the shared module should be placed.\n   */\n  layer?: string;\n  /**\n   * Layer of the issuer.\n   */\n  issuerLayer?: string;\n  /**\n   * Version of the provided module. Will replace lower matching versions, but not higher.\n   */\n  version?: false | string;\n  /**\n   * Filter for the shared module.\n   */\n  exclude?: IncludeExcludeOptions;\n  /**\n   * Options for including only certain versions or requests of the provided module. Cannot be used with 'exclude'.\n   */\n  include?: IncludeExcludeOptions;\n  /**\n   * Enable reconstructed lookup for node_modules paths for this share item\n   */\n  allowNodeModulesSuffixMatch?: boolean;\n  /**\n   * Tree shaking mode for the shared module.\n   */\n  treeShakingMode?: 'server-calc' | 'runtime-infer';\n}\n\n/**\n * Modules that should be provided as shared modules to the share scope. Property names are used as share keys.\n */\nexport interface ProvidesObject {\n  [k: string]: ProvidesConfig | ProvidesItem;\n}\n\n/**\n * Modules that should be provided as shared modules to the share scope. When provided, property name is used to match modules, otherwise this is automatically inferred from share key.\n */\nexport type Provides = (ProvidesItem | ProvidesObject)[] | ProvidesObject;\n\nexport interface ProvideSharedPluginOptions {\n  provides: Provides;\n  /**\n   * Share scope name used for all provided modules (defaults to 'default').\n   */\n  shareScope?: string | string[];\n  /**\n   * Experimental features configuration\n   */\n  experiments?: {\n    /** Enable reconstructed lookup for node_modules paths */\n    allowNodeModulesSuffixMatch?: boolean;\n  };\n}\n"],"mappings":""}

package/dist/types/plugins/SharePlugin.cjs

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

package/dist/types/plugins/SharePlugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharePlugin.cjs","names":[],"sources":["../../../src/types/plugins/SharePlugin.ts"],"sourcesContent":["/*\n * This file was automatically generated.\n * DO NOT MODIFY BY HAND.\n * Run `pnpm generate:schema -w` to update.\n */\n\nimport type { Shared } from './ModuleFederationPlugin';\n\nexport interface SharePluginOptions {\n  /**\n   * Enable/disable asynchronous loading of runtime modules. When enabled, entry points will be wrapped in asynchronous chunks.\n   */\n  async?: boolean;\n  /**\n   * Share scope name used for all shared modules (defaults to 'default').\n   */\n  shareScope?: string | string[];\n  shared: Shared;\n  /**\n   * Experimental features configuration\n   */\n  experiments?: {\n    /** Enable reconstructed lookup for node_modules paths */\n    allowNodeModulesSuffixMatch?: boolean;\n  };\n}\n"],"mappings":""}

package/dist/types/plugins/SharePlugin.d.ts

@@ -0,0 +1,26 @@
+import { Shared } from "./ModuleFederationPlugin.js";
+
+//#region src/types/plugins/SharePlugin.d.ts
+declare namespace SharePlugin_d_exports {
+  export { SharePluginOptions };
+}
+interface SharePluginOptions {
+  /**
+   * Enable/disable asynchronous loading of runtime modules. When enabled, entry points will be wrapped in asynchronous chunks.
+   */
+  async?: boolean;
+  /**
+   * Share scope name used for all shared modules (defaults to 'default').
+   */
+  shareScope?: string | string[];
+  shared: Shared;
+  /**
+   * Experimental features configuration
+   */
+  experiments?: {
+    /** Enable reconstructed lookup for node_modules paths */allowNodeModulesSuffixMatch?: boolean;
+  };
+}
+//#endregion
+export { SharePlugin_d_exports };
+//# sourceMappingURL=SharePlugin.d.ts.map

package/dist/types/plugins/SharePlugin.js

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

package/dist/types/plugins/SharePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharePlugin.js","names":[],"sources":["../../../src/types/plugins/SharePlugin.ts"],"sourcesContent":["/*\n * This file was automatically generated.\n * DO NOT MODIFY BY HAND.\n * Run `pnpm generate:schema -w` to update.\n */\n\nimport type { Shared } from './ModuleFederationPlugin';\n\nexport interface SharePluginOptions {\n  /**\n   * Enable/disable asynchronous loading of runtime modules. When enabled, entry points will be wrapped in asynchronous chunks.\n   */\n  async?: boolean;\n  /**\n   * Share scope name used for all shared modules (defaults to 'default').\n   */\n  shareScope?: string | string[];\n  shared: Shared;\n  /**\n   * Experimental features configuration\n   */\n  experiments?: {\n    /** Enable reconstructed lookup for node_modules paths */\n    allowNodeModulesSuffixMatch?: boolean;\n  };\n}\n"],"mappings":""}

package/dist/types/plugins/index.d.ts

@@ -0,0 +1,6 @@
+import { ModuleFederationPlugin_d_exports } from "./ModuleFederationPlugin.js";
+import { ContainerPlugin_d_exports } from "./ContainerPlugin.js";
+import { ContainerReferencePlugin_d_exports } from "./ContainerReferencePlugin.js";
+import { SharePlugin_d_exports } from "./SharePlugin.js";
+import { ConsumeSharedPlugin_d_exports } from "./ConsumeSharedPlugin.js";
+import { ProvideSharedPlugin_d_exports } from "./ProvideSharedPlugin.js";

package/dist/types/snapshot.d.ts

@@ -0,0 +1,81 @@
+import { TreeShakingStatus } from "../constant.js";
+import { RemoteEntryType, StatsAssets } from "./stats.js";
+
+//#region src/types/snapshot.d.ts
+interface BasicModuleInfo {
+  dev?: {
+    version?: string;
+    remotes?: {
+      [nameWithType: string]: string;
+    };
+  };
+  version: string;
+  buildVersion: string;
+  remoteTypes: string;
+  remoteTypesZip: string;
+  remoteTypesAPI?: string;
+  remotesInfo: Record<string, {
+    matchedVersion: string;
+  }>;
+  shared: Array<{
+    sharedName: string;
+    fallback?: string;
+    fallbackName?: string;
+    fallbackType?: RemoteEntryType;
+    version?: string;
+    assets: StatsAssets;
+    treeShakingStatus?: TreeShakingStatus;
+    secondarySharedTreeShakingEntry?: string;
+    secondarySharedTreeShakingName?: string;
+  }>;
+}
+interface BasicProviderModuleInfo extends BasicModuleInfo {
+  remoteEntry: string;
+  remoteEntryType: RemoteEntryType;
+  ssrRemoteEntry?: string;
+  ssrRemoteEntryType?: RemoteEntryType;
+  globalName: string;
+  modules: Array<{
+    moduleName: string;
+    modulePath?: string;
+    assets: StatsAssets;
+  }>;
+  prefetchInterface?: boolean;
+  prefetchEntry?: string;
+  prefetchEntryType?: RemoteEntryType;
+}
+interface BasicProviderModuleInfoWithPublicPath extends BasicProviderModuleInfo {
+  publicPath: string;
+  ssrPublicPath?: string;
+}
+interface BasicProviderModuleInfoWithGetPublicPath extends BasicProviderModuleInfo {
+  getPublicPath: string;
+}
+interface ManifestProvider {
+  remoteEntry: string;
+  ssrRemoteEntry?: string;
+  version?: string;
+}
+interface PureEntryProvider extends ManifestProvider {
+  globalName: string;
+}
+interface BasicConsumerModuleInfo extends BasicModuleInfo {
+  consumerList: Array<string>;
+}
+interface ConsumerModuleInfoWithPublicPath extends BasicConsumerModuleInfo, BasicProviderModuleInfo {
+  publicPath: string;
+  ssrPublicPath?: string;
+}
+interface ConsumerModuleInfoWithGetPublicPath extends BasicConsumerModuleInfo, BasicProviderModuleInfo {
+  getPublicPath: string;
+}
+type PureConsumerModuleInfo = Omit<BasicConsumerModuleInfo, 'remoteTypes'>;
+type ConsumerModuleInfo = ConsumerModuleInfoWithPublicPath | ConsumerModuleInfoWithGetPublicPath;
+type ProviderModuleInfo = BasicProviderModuleInfoWithPublicPath | BasicProviderModuleInfoWithGetPublicPath;
+type ModuleInfo = ConsumerModuleInfo | PureConsumerModuleInfo | ProviderModuleInfo;
+type GlobalModuleInfo = {
+  [key: string]: ModuleInfo | ManifestProvider | PureEntryProvider | undefined;
+};
+//#endregion
+export { BasicProviderModuleInfo, ConsumerModuleInfo, ConsumerModuleInfoWithPublicPath, GlobalModuleInfo, ManifestProvider, ModuleInfo, ProviderModuleInfo, PureConsumerModuleInfo, PureEntryProvider };
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/stats.d.ts

@@ -0,0 +1,101 @@
+import { RemoteWithEntry, RemoteWithVersion } from "./common.js";
+
+//#region src/types/stats.d.ts
+type RemoteEntryType = 'var' | 'module' | 'assign' | 'assign-properties' | 'this' | 'window' | 'self' | 'global' | 'commonjs' | 'commonjs2' | 'commonjs-module' | 'commonjs-static' | 'amd' | 'amd-require' | 'umd' | 'umd2' | 'jsonp' | 'system' | string;
+interface ResourceInfo {
+  path: string;
+  name: string;
+  type: RemoteEntryType;
+}
+interface StatsBuildInfo {
+  buildVersion: string;
+  buildName: string;
+  target?: string[];
+  plugins?: string[];
+  excludePlugins?: string[];
+}
+interface MetaDataTypes {
+  path: string;
+  name: string;
+  api: string;
+  zip: string;
+}
+interface BasicStatsMetaData {
+  name: string;
+  globalName: string;
+  buildInfo: StatsBuildInfo;
+  remoteEntry: ResourceInfo;
+  ssrRemoteEntry?: ResourceInfo;
+  prefetchInterface?: boolean;
+  prefetchEntry?: ResourceInfo;
+  types?: MetaDataTypes;
+  type: string;
+  pluginVersion?: string;
+}
+type StatsMetaDataWithGetPublicPath<T = BasicStatsMetaData> = T & {
+  getPublicPath: string;
+};
+type StatsMetaDataWithPublicPath<T = BasicStatsMetaData> = T & {
+  publicPath: string;
+  ssrPublicPath?: string;
+};
+type StatsMetaData<T = BasicStatsMetaData> = StatsMetaDataWithGetPublicPath<T> | StatsMetaDataWithPublicPath<T>;
+interface StatsAssets {
+  js: StatsAssetsInfo;
+  css: StatsAssetsInfo;
+}
+interface StatsAssetsInfo {
+  sync: string[];
+  async: string[];
+}
+interface StatsShared {
+  id: string;
+  name: string;
+  version: string;
+  singleton: boolean;
+  requiredVersion: string;
+  hash: string;
+  assets: StatsAssets;
+  deps: string[];
+  usedIn: string[];
+  usedExports: string[];
+  fallback: string;
+  fallbackName: string;
+  fallbackType: RemoteEntryType;
+}
+interface StatsRemoteVal {
+  moduleName: string;
+  federationContainerName: string;
+  consumingFederationContainerName: string;
+  alias: string;
+  usedIn: string[];
+}
+type StatsRemoteWithEntry<T = StatsRemoteVal> = T & Omit<RemoteWithEntry, 'name'>;
+type StatsRemoteWithVersion<T = StatsRemoteVal> = T & Omit<RemoteWithVersion, 'name'>;
+type StatsRemote<T = StatsRemoteVal> = StatsRemoteWithEntry<T> | StatsRemoteWithVersion<T>;
+interface StatsModuleInfo {
+  name: string;
+  file: string[];
+}
+interface ManifestModuleInfos {
+  [exposeModuleName: string]: StatsModuleInfo;
+}
+interface StatsExpose {
+  id: string;
+  name: string;
+  path?: string;
+  file: string;
+  requires: string[];
+  assets: StatsAssets;
+}
+interface Stats<T = BasicStatsMetaData, K = StatsRemoteVal> {
+  id: string;
+  name: string;
+  metaData: StatsMetaData<T>;
+  shared: StatsShared[];
+  remotes: StatsRemote<K>[];
+  exposes: StatsExpose[];
+}
+//#endregion
+export { BasicStatsMetaData, ManifestModuleInfos, MetaDataTypes, RemoteEntryType, ResourceInfo, Stats, StatsAssets, StatsBuildInfo, StatsExpose, StatsMetaData, StatsMetaDataWithGetPublicPath, StatsMetaDataWithPublicPath, StatsModuleInfo, StatsRemote, StatsRemoteVal, StatsRemoteWithEntry, StatsRemoteWithVersion, StatsShared };
+//# sourceMappingURL=stats.d.ts.map

package/dist/utils.cjs

@@ -0,0 +1,127 @@
+const require_constant = require('./constant.cjs');
+const require_env = require('./env.cjs');
+
+//#region src/utils.ts
+const LOG_CATEGORY = "[ Federation Runtime ]";
+const parseEntry = (str, devVerOrUrl, separator = require_constant.SEPARATOR) => {
+	const strSplit = str.split(separator);
+	const devVersionOrUrl = require_env.getProcessEnv()["NODE_ENV"] === "development" && devVerOrUrl;
+	const defaultVersion = "*";
+	const isEntry = (s) => s.startsWith("http") || s.includes(require_constant.MANIFEST_EXT);
+	if (strSplit.length >= 2) {
+		let [name, ...versionOrEntryArr] = strSplit;
+		if (str.startsWith(separator)) {
+			name = strSplit.slice(0, 2).join(separator);
+			versionOrEntryArr = [devVersionOrUrl || strSplit.slice(2).join(separator)];
+		}
+		let versionOrEntry = devVersionOrUrl || versionOrEntryArr.join(separator);
+		if (isEntry(versionOrEntry)) return {
+			name,
+			entry: versionOrEntry
+		};
+		else return {
+			name,
+			version: versionOrEntry || defaultVersion
+		};
+	} else if (strSplit.length === 1) {
+		const [name] = strSplit;
+		if (devVersionOrUrl && isEntry(devVersionOrUrl)) return {
+			name,
+			entry: devVersionOrUrl
+		};
+		return {
+			name,
+			version: devVersionOrUrl || defaultVersion
+		};
+	} else throw `Invalid entry value: ${str}`;
+};
+const composeKeyWithSeparator = function(...args) {
+	if (!args.length) return "";
+	return args.reduce((sum, cur) => {
+		if (!cur) return sum;
+		if (!sum) return cur;
+		return `${sum}${require_constant.SEPARATOR}${cur}`;
+	}, "");
+};
+const encodeName = function(name, prefix = "", withExt = false) {
+	try {
+		const ext = withExt ? ".js" : "";
+		return `${prefix}${name.replace(new RegExp(`${require_constant.NameTransformSymbol.AT}`, "g"), require_constant.NameTransformMap[require_constant.NameTransformSymbol.AT]).replace(new RegExp(`${require_constant.NameTransformSymbol.HYPHEN}`, "g"), require_constant.NameTransformMap[require_constant.NameTransformSymbol.HYPHEN]).replace(new RegExp(`${require_constant.NameTransformSymbol.SLASH}`, "g"), require_constant.NameTransformMap[require_constant.NameTransformSymbol.SLASH])}${ext}`;
+	} catch (err) {
+		throw err;
+	}
+};
+const decodeName = function(name, prefix, withExt) {
+	try {
+		let decodedName = name;
+		if (prefix) {
+			if (!decodedName.startsWith(prefix)) return decodedName;
+			decodedName = decodedName.replace(new RegExp(prefix, "g"), "");
+		}
+		decodedName = decodedName.replace(new RegExp(`${require_constant.NameTransformMap[require_constant.NameTransformSymbol.AT]}`, "g"), require_constant.EncodedNameTransformMap[require_constant.NameTransformMap[require_constant.NameTransformSymbol.AT]]).replace(new RegExp(`${require_constant.NameTransformMap[require_constant.NameTransformSymbol.SLASH]}`, "g"), require_constant.EncodedNameTransformMap[require_constant.NameTransformMap[require_constant.NameTransformSymbol.SLASH]]).replace(new RegExp(`${require_constant.NameTransformMap[require_constant.NameTransformSymbol.HYPHEN]}`, "g"), require_constant.EncodedNameTransformMap[require_constant.NameTransformMap[require_constant.NameTransformSymbol.HYPHEN]]);
+		if (withExt) decodedName = decodedName.replace(".js", "");
+		return decodedName;
+	} catch (err) {
+		throw err;
+	}
+};
+const generateExposeFilename = (exposeName, withExt) => {
+	if (!exposeName) return "";
+	let expose = exposeName;
+	if (expose === ".") expose = "default_export";
+	if (expose.startsWith("./")) expose = expose.replace("./", "");
+	return encodeName(expose, "__federation_expose_", withExt);
+};
+const generateShareFilename = (pkgName, withExt) => {
+	if (!pkgName) return "";
+	return encodeName(pkgName, "__federation_shared_", withExt);
+};
+const getResourceUrl = (module, sourceUrl) => {
+	if ("getPublicPath" in module) {
+		let publicPath;
+		if (!module.getPublicPath.startsWith("function")) publicPath = new Function(module.getPublicPath)();
+		else publicPath = new Function("return " + module.getPublicPath)()();
+		return `${publicPath}${sourceUrl}`;
+	} else if ("publicPath" in module) {
+		if (!require_env.isBrowserEnv() && !require_env.isReactNativeEnv() && "ssrPublicPath" in module && typeof module.ssrPublicPath === "string") return `${module.ssrPublicPath}${sourceUrl}`;
+		return `${module.publicPath}${sourceUrl}`;
+	} else {
+		console.warn("Cannot get resource URL. If in debug mode, please ignore.", module, sourceUrl);
+		return "";
+	}
+};
+const assert = (condition, msg) => {
+	if (!condition) error(msg);
+};
+const error = (msg) => {
+	throw new Error(`${LOG_CATEGORY}: ${msg}`);
+};
+const warn = (msg) => {
+	console.warn(`${LOG_CATEGORY}: ${msg}`);
+};
+function safeToString(info) {
+	try {
+		return JSON.stringify(info, null, 2);
+	} catch (e) {
+		return "";
+	}
+}
+const VERSION_PATTERN_REGEXP = /^([\d^=v<>~]|[*xX]$)/;
+function isRequiredVersion(str) {
+	return VERSION_PATTERN_REGEXP.test(str);
+}
+
+//#endregion
+exports.assert = assert;
+exports.composeKeyWithSeparator = composeKeyWithSeparator;
+exports.decodeName = decodeName;
+exports.encodeName = encodeName;
+exports.error = error;
+exports.generateExposeFilename = generateExposeFilename;
+exports.generateShareFilename = generateShareFilename;
+exports.getResourceUrl = getResourceUrl;
+exports.isRequiredVersion = isRequiredVersion;
+exports.parseEntry = parseEntry;
+exports.safeToString = safeToString;
+exports.warn = warn;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":["SEPARATOR","getProcessEnv","MANIFEST_EXT","NameTransformSymbol","NameTransformMap","EncodedNameTransformMap","isBrowserEnv","isReactNativeEnv"],"sources":["../src/utils.ts"],"sourcesContent":["import { RemoteEntryInfo, ModuleInfo } from './types';\nimport {\n  NameTransformMap,\n  NameTransformSymbol,\n  EncodedNameTransformMap,\n  SEPARATOR,\n  MANIFEST_EXT,\n} from './constant';\nimport { getProcessEnv, isBrowserEnv, isReactNativeEnv } from './env';\n\nconst LOG_CATEGORY = '[ Federation Runtime ]';\n\n// entry: name:version   version : 1.0.0 | ^1.2.3\n// entry: name:entry  entry:  https://localhost:9000/federation-manifest.json\nconst parseEntry = (\n  str: string,\n  devVerOrUrl?: string,\n  separator = SEPARATOR,\n): RemoteEntryInfo => {\n  const strSplit = str.split(separator);\n  const devVersionOrUrl =\n    getProcessEnv()['NODE_ENV'] === 'development' && devVerOrUrl;\n  const defaultVersion = '*';\n  const isEntry = (s: string) =>\n    s.startsWith('http') || s.includes(MANIFEST_EXT);\n\n  // Check if the string starts with a type\n  if (strSplit.length >= 2) {\n    let [name, ...versionOrEntryArr] = strSplit;\n    // @name@manifest-url.json\n    if (str.startsWith(separator)) {\n      name = strSplit.slice(0, 2).join(separator);\n      versionOrEntryArr = [\n        devVersionOrUrl || strSplit.slice(2).join(separator),\n      ];\n    }\n\n    let versionOrEntry = devVersionOrUrl || versionOrEntryArr.join(separator);\n\n    if (isEntry(versionOrEntry)) {\n      return {\n        name,\n        entry: versionOrEntry,\n      };\n    } else {\n      // Apply version rule\n      // devVersionOrUrl => inputVersion => defaultVersion\n      return {\n        name,\n        version: versionOrEntry || defaultVersion,\n      };\n    }\n  } else if (strSplit.length === 1) {\n    const [name] = strSplit;\n    if (devVersionOrUrl && isEntry(devVersionOrUrl)) {\n      return {\n        name,\n        entry: devVersionOrUrl,\n      };\n    }\n    return {\n      name,\n      version: devVersionOrUrl || defaultVersion,\n    };\n  } else {\n    throw `Invalid entry value: ${str}`;\n  }\n};\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var FEDERATION_DEBUG: string | undefined;\n}\n\nconst composeKeyWithSeparator = function (\n  ...args: (string | undefined)[]\n): string {\n  if (!args.length) {\n    return '';\n  }\n\n  return args.reduce((sum, cur) => {\n    if (!cur) {\n      return sum;\n    }\n    if (!sum) {\n      return cur;\n    }\n\n    return `${sum}${SEPARATOR}${cur}`;\n  }, '') as string;\n};\n\nconst encodeName = function (\n  name: string,\n  prefix = '',\n  withExt = false,\n): string {\n  try {\n    const ext = withExt ? '.js' : '';\n    return `${prefix}${name\n      .replace(\n        new RegExp(`${NameTransformSymbol.AT}`, 'g'),\n        NameTransformMap[NameTransformSymbol.AT],\n      )\n      .replace(\n        new RegExp(`${NameTransformSymbol.HYPHEN}`, 'g'),\n        NameTransformMap[NameTransformSymbol.HYPHEN],\n      )\n      .replace(\n        new RegExp(`${NameTransformSymbol.SLASH}`, 'g'),\n        NameTransformMap[NameTransformSymbol.SLASH],\n      )}${ext}`;\n  } catch (err) {\n    throw err;\n  }\n};\n\nconst decodeName = function (\n  name: string,\n  prefix?: string,\n  withExt?: boolean,\n): string {\n  try {\n    let decodedName = name;\n    if (prefix) {\n      if (!decodedName.startsWith(prefix)) {\n        return decodedName;\n      }\n      decodedName = decodedName.replace(new RegExp(prefix, 'g'), '');\n    }\n    decodedName = decodedName\n      .replace(\n        new RegExp(`${NameTransformMap[NameTransformSymbol.AT]}`, 'g'),\n        EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.AT]],\n      )\n      .replace(\n        new RegExp(`${NameTransformMap[NameTransformSymbol.SLASH]}`, 'g'),\n        EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.SLASH]],\n      )\n      .replace(\n        new RegExp(`${NameTransformMap[NameTransformSymbol.HYPHEN]}`, 'g'),\n        EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.HYPHEN]],\n      );\n    if (withExt) {\n      decodedName = decodedName.replace('.js', '');\n    }\n    return decodedName;\n  } catch (err) {\n    throw err;\n  }\n};\n\nconst generateExposeFilename = (\n  exposeName: string,\n  withExt: boolean,\n): string => {\n  if (!exposeName) {\n    return '';\n  }\n\n  let expose = exposeName;\n  if (expose === '.') {\n    expose = 'default_export';\n  }\n  if (expose.startsWith('./')) {\n    expose = expose.replace('./', '');\n  }\n\n  return encodeName(expose, '__federation_expose_', withExt);\n};\n\nconst generateShareFilename = (pkgName: string, withExt: boolean): string => {\n  if (!pkgName) {\n    return '';\n  }\n  return encodeName(pkgName, '__federation_shared_', withExt);\n};\n\nconst getResourceUrl = (module: ModuleInfo, sourceUrl: string): string => {\n  if ('getPublicPath' in module) {\n    let publicPath;\n\n    if (!module.getPublicPath.startsWith('function')) {\n      publicPath = new Function(module.getPublicPath)();\n    } else {\n      publicPath = new Function('return ' + module.getPublicPath)()();\n    }\n\n    return `${publicPath}${sourceUrl}`;\n  } else if ('publicPath' in module) {\n    if (\n      !isBrowserEnv() &&\n      !isReactNativeEnv() &&\n      'ssrPublicPath' in module &&\n      typeof module.ssrPublicPath === 'string'\n    ) {\n      return `${module.ssrPublicPath}${sourceUrl}`;\n    }\n    return `${module.publicPath}${sourceUrl}`;\n  } else {\n    console.warn(\n      'Cannot get resource URL. If in debug mode, please ignore.',\n      module,\n      sourceUrl,\n    );\n    return '';\n  }\n};\n\n// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types\nconst assert = (condition: any, msg: string): asserts condition => {\n  if (!condition) {\n    error(msg);\n  }\n};\n\nconst error = (msg: string | Error | unknown): never => {\n  throw new Error(`${LOG_CATEGORY}: ${msg}`);\n};\n\nconst warn = (msg: Parameters<typeof console.warn>[0]): void => {\n  console.warn(`${LOG_CATEGORY}: ${msg}`);\n};\n\nfunction safeToString(info: any): string {\n  try {\n    return JSON.stringify(info, null, 2);\n  } catch (e) {\n    return '';\n  }\n}\n\n// RegExp for version string\nconst VERSION_PATTERN_REGEXP: RegExp = /^([\\d^=v<>~]|[*xX]$)/;\n\nfunction isRequiredVersion(str: string): boolean {\n  return VERSION_PATTERN_REGEXP.test(str);\n}\n\nexport {\n  parseEntry,\n  decodeName,\n  encodeName,\n  composeKeyWithSeparator,\n  generateExposeFilename,\n  generateShareFilename,\n  getResourceUrl,\n  assert,\n  error,\n  warn,\n  safeToString,\n  isRequiredVersion,\n};\n"],"mappings":"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"}

package/dist/{src/utils.d.ts → utils.d.ts}

@@ -1,7 +1,9 @@
-import { RemoteEntryInfo, ModuleInfo } from './types';
+import { RemoteEntryInfo } from "./types/common.js";
+import { ModuleInfo } from "./types/snapshot.js";
+//#region src/utils.d.ts
 declare const parseEntry: (str: string, devVerOrUrl?: string, separator?: string) => RemoteEntryInfo;
 declare global {
-    var FEDERATION_DEBUG: string | undefined;
+  var FEDERATION_DEBUG: string | undefined;
 }
 declare const composeKeyWithSeparator: (...args: (string | undefined)[]) => string;
 declare const encodeName: (name: string, prefix?: string, withExt?: boolean) => string;
@@ -14,4 +16,6 @@ declare const error: (msg: string | Error | unknown) => never;
 declare const warn: (msg: Parameters<typeof console.warn>[0]) => void;
 declare function safeToString(info: any): string;
 declare function isRequiredVersion(str: string): boolean;
-export { parseEntry, decodeName, encodeName, composeKeyWithSeparator, generateExposeFilename, generateShareFilename, getResourceUrl, assert, error, warn, safeToString, isRequiredVersion, };
+//#endregion
+export { assert, composeKeyWithSeparator, decodeName, encodeName, error, generateExposeFilename, generateShareFilename, getResourceUrl, isRequiredVersion, parseEntry, safeToString, warn };
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,116 @@
+import { EncodedNameTransformMap, MANIFEST_EXT, NameTransformMap, NameTransformSymbol, SEPARATOR } from "./constant.js";
+import { getProcessEnv, isBrowserEnv, isReactNativeEnv } from "./env.js";
+
+//#region src/utils.ts
+const LOG_CATEGORY = "[ Federation Runtime ]";
+const parseEntry = (str, devVerOrUrl, separator = SEPARATOR) => {
+	const strSplit = str.split(separator);
+	const devVersionOrUrl = getProcessEnv()["NODE_ENV"] === "development" && devVerOrUrl;
+	const defaultVersion = "*";
+	const isEntry = (s) => s.startsWith("http") || s.includes(MANIFEST_EXT);
+	if (strSplit.length >= 2) {
+		let [name, ...versionOrEntryArr] = strSplit;
+		if (str.startsWith(separator)) {
+			name = strSplit.slice(0, 2).join(separator);
+			versionOrEntryArr = [devVersionOrUrl || strSplit.slice(2).join(separator)];
+		}
+		let versionOrEntry = devVersionOrUrl || versionOrEntryArr.join(separator);
+		if (isEntry(versionOrEntry)) return {
+			name,
+			entry: versionOrEntry
+		};
+		else return {
+			name,
+			version: versionOrEntry || defaultVersion
+		};
+	} else if (strSplit.length === 1) {
+		const [name] = strSplit;
+		if (devVersionOrUrl && isEntry(devVersionOrUrl)) return {
+			name,
+			entry: devVersionOrUrl
+		};
+		return {
+			name,
+			version: devVersionOrUrl || defaultVersion
+		};
+	} else throw `Invalid entry value: ${str}`;
+};
+const composeKeyWithSeparator = function(...args) {
+	if (!args.length) return "";
+	return args.reduce((sum, cur) => {
+		if (!cur) return sum;
+		if (!sum) return cur;
+		return `${sum}${SEPARATOR}${cur}`;
+	}, "");
+};
+const encodeName = function(name, prefix = "", withExt = false) {
+	try {
+		const ext = withExt ? ".js" : "";
+		return `${prefix}${name.replace(new RegExp(`${NameTransformSymbol.AT}`, "g"), NameTransformMap[NameTransformSymbol.AT]).replace(new RegExp(`${NameTransformSymbol.HYPHEN}`, "g"), NameTransformMap[NameTransformSymbol.HYPHEN]).replace(new RegExp(`${NameTransformSymbol.SLASH}`, "g"), NameTransformMap[NameTransformSymbol.SLASH])}${ext}`;
+	} catch (err) {
+		throw err;
+	}
+};
+const decodeName = function(name, prefix, withExt) {
+	try {
+		let decodedName = name;
+		if (prefix) {
+			if (!decodedName.startsWith(prefix)) return decodedName;
+			decodedName = decodedName.replace(new RegExp(prefix, "g"), "");
+		}
+		decodedName = decodedName.replace(new RegExp(`${NameTransformMap[NameTransformSymbol.AT]}`, "g"), EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.AT]]).replace(new RegExp(`${NameTransformMap[NameTransformSymbol.SLASH]}`, "g"), EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.SLASH]]).replace(new RegExp(`${NameTransformMap[NameTransformSymbol.HYPHEN]}`, "g"), EncodedNameTransformMap[NameTransformMap[NameTransformSymbol.HYPHEN]]);
+		if (withExt) decodedName = decodedName.replace(".js", "");
+		return decodedName;
+	} catch (err) {
+		throw err;
+	}
+};
+const generateExposeFilename = (exposeName, withExt) => {
+	if (!exposeName) return "";
+	let expose = exposeName;
+	if (expose === ".") expose = "default_export";
+	if (expose.startsWith("./")) expose = expose.replace("./", "");
+	return encodeName(expose, "__federation_expose_", withExt);
+};
+const generateShareFilename = (pkgName, withExt) => {
+	if (!pkgName) return "";
+	return encodeName(pkgName, "__federation_shared_", withExt);
+};
+const getResourceUrl = (module, sourceUrl) => {
+	if ("getPublicPath" in module) {
+		let publicPath;
+		if (!module.getPublicPath.startsWith("function")) publicPath = new Function(module.getPublicPath)();
+		else publicPath = new Function("return " + module.getPublicPath)()();
+		return `${publicPath}${sourceUrl}`;
+	} else if ("publicPath" in module) {
+		if (!isBrowserEnv() && !isReactNativeEnv() && "ssrPublicPath" in module && typeof module.ssrPublicPath === "string") return `${module.ssrPublicPath}${sourceUrl}`;
+		return `${module.publicPath}${sourceUrl}`;
+	} else {
+		console.warn("Cannot get resource URL. If in debug mode, please ignore.", module, sourceUrl);
+		return "";
+	}
+};
+const assert = (condition, msg) => {
+	if (!condition) error(msg);
+};
+const error = (msg) => {
+	throw new Error(`${LOG_CATEGORY}: ${msg}`);
+};
+const warn = (msg) => {
+	console.warn(`${LOG_CATEGORY}: ${msg}`);
+};
+function safeToString(info) {
+	try {
+		return JSON.stringify(info, null, 2);
+	} catch (e) {
+		return "";
+	}
+}
+const VERSION_PATTERN_REGEXP = /^([\d^=v<>~]|[*xX]$)/;
+function isRequiredVersion(str) {
+	return VERSION_PATTERN_REGEXP.test(str);
+}
+
+//#endregion
+export { assert, composeKeyWithSeparator, decodeName, encodeName, error, generateExposeFilename, generateShareFilename, getResourceUrl, isRequiredVersion, parseEntry, safeToString, warn };
+//# sourceMappingURL=utils.js.map