@module-federation/sdk 2.0.1 → 2.2.0

package/README.md

@@ -11,7 +11,7 @@
 // The SDK can be used to parse entry strings, encode and decode module names, and generate filenames for exposed modules and shared packages.
 // It also includes a logger for debugging and environment detection utilities.
 // Additionally, it provides a function to generate a snapshot from a manifest and environment detection utilities.
-import { parseEntry, encodeName, decodeName, generateExposeFilename, generateShareFilename, createLogger, isBrowserEnv, isDebugMode, getProcessEnv, generateSnapshotFromManifest } from '@module-federation/sdk';
+import { parseEntry, encodeName, decodeName, generateExposeFilename, generateShareFilename, createLogger, isBrowserEnv, isBrowserEnvValue, isDebugMode, getProcessEnv, generateSnapshotFromManifest } from '@module-federation/sdk';
 
 // Parse an entry string into a RemoteEntryInfo object
 parseEntry('entryString');
@@ -32,7 +32,8 @@ generateShareFilename('packageName', true);
 const logger = createLogger('identifier');
 
 // Check if the current environment is a browser
-isBrowserEnv();
+const inBrowser = isBrowserEnv();
+const inBrowserStatic = isBrowserEnvValue;
 
 // Check if the current environment is in debug mode
 isDebugMode();
@@ -76,9 +77,14 @@ generateSnapshotFromManifest(manifest, options);
 
 ### isBrowserEnv
 
-- Type: `isBrowserEnv()`
+- Type: `isBrowserEnv(): boolean`
 - Checks if the current environment is a browser.
 
+### isBrowserEnvValue
+
+- Type: `isBrowserEnvValue: boolean`
+- Static browser environment flag (tree-shakable when ENV_TARGET is defined).
+
 ### isDebugMode
 
 - Type: `isDebugMode()`

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,19 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+
+exports.__exportAll = __exportAll;

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,18 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/constant.cjs

@@ -0,0 +1,70 @@
+
+//#region src/constant.ts
+const FederationModuleManifest = "federation-manifest.json";
+const MANIFEST_EXT = ".json";
+const BROWSER_LOG_KEY = "FEDERATION_DEBUG";
+const NameTransformSymbol = {
+	AT: "@",
+	HYPHEN: "-",
+	SLASH: "/"
+};
+const NameTransformMap = {
+	[NameTransformSymbol.AT]: "scope_",
+	[NameTransformSymbol.HYPHEN]: "_",
+	[NameTransformSymbol.SLASH]: "__"
+};
+const EncodedNameTransformMap = {
+	[NameTransformMap[NameTransformSymbol.AT]]: NameTransformSymbol.AT,
+	[NameTransformMap[NameTransformSymbol.HYPHEN]]: NameTransformSymbol.HYPHEN,
+	[NameTransformMap[NameTransformSymbol.SLASH]]: NameTransformSymbol.SLASH
+};
+const SEPARATOR = ":";
+const ManifestFileName = "mf-manifest.json";
+const StatsFileName = "mf-stats.json";
+const MFModuleType = {
+	NPM: "npm",
+	APP: "app"
+};
+const MODULE_DEVTOOL_IDENTIFIER = "__MF_DEVTOOLS_MODULE_INFO__";
+const ENCODE_NAME_PREFIX = "ENCODE_NAME_PREFIX";
+const TEMP_DIR = ".federation";
+const MFPrefetchCommon = {
+	identifier: "MFDataPrefetch",
+	globalKey: "__PREFETCH__",
+	library: "mf-data-prefetch",
+	exportsKey: "__PREFETCH_EXPORTS__",
+	fileName: "bootstrap.js"
+};
+let TreeShakingStatus = /* @__PURE__ */ function(TreeShakingStatus) {
+	/**
+	* Not handled by deploy server, needs to infer by the real runtime period.
+	*/
+	TreeShakingStatus[TreeShakingStatus["UNKNOWN"] = 1] = "UNKNOWN";
+	/**
+	* It means the shared has been calculated , runtime should take this shared as first choice.
+	*/
+	TreeShakingStatus[TreeShakingStatus["CALCULATED"] = 2] = "CALCULATED";
+	/**
+	* It means the shared has been calculated, and marked as no used
+	*/
+	TreeShakingStatus[TreeShakingStatus["NO_USE"] = 0] = "NO_USE";
+	return TreeShakingStatus;
+}({});
+
+//#endregion
+exports.BROWSER_LOG_KEY = BROWSER_LOG_KEY;
+exports.ENCODE_NAME_PREFIX = ENCODE_NAME_PREFIX;
+exports.EncodedNameTransformMap = EncodedNameTransformMap;
+exports.FederationModuleManifest = FederationModuleManifest;
+exports.MANIFEST_EXT = MANIFEST_EXT;
+exports.MFModuleType = MFModuleType;
+exports.MFPrefetchCommon = MFPrefetchCommon;
+exports.MODULE_DEVTOOL_IDENTIFIER = MODULE_DEVTOOL_IDENTIFIER;
+exports.ManifestFileName = ManifestFileName;
+exports.NameTransformMap = NameTransformMap;
+exports.NameTransformSymbol = NameTransformSymbol;
+exports.SEPARATOR = SEPARATOR;
+exports.StatsFileName = StatsFileName;
+exports.TEMP_DIR = TEMP_DIR;
+exports.TreeShakingStatus = TreeShakingStatus;
+//# sourceMappingURL=constant.cjs.map

package/dist/constant.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.cjs","names":[],"sources":["../src/constant.ts"],"sourcesContent":["export const FederationModuleManifest = 'federation-manifest.json';\nexport const MANIFEST_EXT = '.json';\n\nexport const BROWSER_LOG_KEY = 'FEDERATION_DEBUG';\n\nexport const NameTransformSymbol = {\n  AT: '@',\n  HYPHEN: '-',\n  SLASH: '/',\n} as const;\nexport const NameTransformMap = {\n  [NameTransformSymbol.AT]: 'scope_',\n  [NameTransformSymbol.HYPHEN]: '_',\n  [NameTransformSymbol.SLASH]: '__',\n} as const;\n\nexport const EncodedNameTransformMap = {\n  [NameTransformMap[NameTransformSymbol.AT]]: NameTransformSymbol.AT,\n  [NameTransformMap[NameTransformSymbol.HYPHEN]]: NameTransformSymbol.HYPHEN,\n  [NameTransformMap[NameTransformSymbol.SLASH]]: NameTransformSymbol.SLASH,\n};\n\nexport const SEPARATOR = ':';\n\nexport const ManifestFileName = 'mf-manifest.json';\nexport const StatsFileName = 'mf-stats.json';\n\nexport const MFModuleType = {\n  NPM: 'npm',\n  APP: 'app',\n};\n\nexport const MODULE_DEVTOOL_IDENTIFIER = '__MF_DEVTOOLS_MODULE_INFO__';\nexport const ENCODE_NAME_PREFIX = 'ENCODE_NAME_PREFIX';\nexport const TEMP_DIR = '.federation';\n\nexport const MFPrefetchCommon = {\n  identifier: 'MFDataPrefetch',\n  globalKey: '__PREFETCH__',\n  library: 'mf-data-prefetch',\n  exportsKey: '__PREFETCH_EXPORTS__',\n  fileName: 'bootstrap.js',\n};\n\nexport const enum TreeShakingStatus {\n  /**\n   * Not handled by deploy server, needs to infer by the real runtime period.\n   */\n  UNKNOWN = 1,\n  /**\n   * It means the shared has been calculated , runtime should take this shared as first choice.\n   */\n  CALCULATED = 2,\n  /**\n   * It means the shared has been calculated, and marked as no used\n   */\n  NO_USE = 0,\n}\n"],"mappings":";;AAAA,MAAa,2BAA2B;AACxC,MAAa,eAAe;AAE5B,MAAa,kBAAkB;AAE/B,MAAa,sBAAsB;CACjC,IAAI;CACJ,QAAQ;CACR,OAAO;CACR;AACD,MAAa,mBAAmB;EAC7B,oBAAoB,KAAK;EACzB,oBAAoB,SAAS;EAC7B,oBAAoB,QAAQ;CAC9B;AAED,MAAa,0BAA0B;EACpC,iBAAiB,oBAAoB,MAAM,oBAAoB;EAC/D,iBAAiB,oBAAoB,UAAU,oBAAoB;EACnE,iBAAiB,oBAAoB,SAAS,oBAAoB;CACpE;AAED,MAAa,YAAY;AAEzB,MAAa,mBAAmB;AAChC,MAAa,gBAAgB;AAE7B,MAAa,eAAe;CAC1B,KAAK;CACL,KAAK;CACN;AAED,MAAa,4BAA4B;AACzC,MAAa,qBAAqB;AAClC,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAC9B,YAAY;CACZ,WAAW;CACX,SAAS;CACT,YAAY;CACZ,UAAU;CACX;AAED,IAAkB,gEAAX;;;;AAIL;;;;AAIA;;;;AAIA"}

package/dist/constant.d.ts

@@ -0,0 +1,53 @@
+//#region src/constant.d.ts
+declare const FederationModuleManifest = "federation-manifest.json";
+declare const MANIFEST_EXT = ".json";
+declare const BROWSER_LOG_KEY = "FEDERATION_DEBUG";
+declare const NameTransformSymbol: {
+  readonly AT: "@";
+  readonly HYPHEN: "-";
+  readonly SLASH: "/";
+};
+declare const NameTransformMap: {
+  readonly "@": "scope_";
+  readonly "-": "_";
+  readonly "/": "__";
+};
+declare const EncodedNameTransformMap: {
+  scope_: "@";
+  _: "-";
+  __: "/";
+};
+declare const SEPARATOR = ":";
+declare const ManifestFileName = "mf-manifest.json";
+declare const StatsFileName = "mf-stats.json";
+declare const MFModuleType: {
+  NPM: string;
+  APP: string;
+};
+declare const MODULE_DEVTOOL_IDENTIFIER = "__MF_DEVTOOLS_MODULE_INFO__";
+declare const ENCODE_NAME_PREFIX = "ENCODE_NAME_PREFIX";
+declare const TEMP_DIR = ".federation";
+declare const MFPrefetchCommon: {
+  identifier: string;
+  globalKey: string;
+  library: string;
+  exportsKey: string;
+  fileName: string;
+};
+declare const enum TreeShakingStatus {
+  /**
+   * Not handled by deploy server, needs to infer by the real runtime period.
+   */
+  UNKNOWN = 1,
+  /**
+   * It means the shared has been calculated , runtime should take this shared as first choice.
+   */
+  CALCULATED = 2,
+  /**
+   * It means the shared has been calculated, and marked as no used
+   */
+  NO_USE = 0
+}
+//#endregion
+export { BROWSER_LOG_KEY, ENCODE_NAME_PREFIX, EncodedNameTransformMap, FederationModuleManifest, MANIFEST_EXT, MFModuleType, MFPrefetchCommon, MODULE_DEVTOOL_IDENTIFIER, ManifestFileName, NameTransformMap, NameTransformSymbol, SEPARATOR, StatsFileName, TEMP_DIR, TreeShakingStatus };
+//# sourceMappingURL=constant.d.ts.map

package/dist/constant.js

@@ -0,0 +1,55 @@
+//#region src/constant.ts
+const FederationModuleManifest = "federation-manifest.json";
+const MANIFEST_EXT = ".json";
+const BROWSER_LOG_KEY = "FEDERATION_DEBUG";
+const NameTransformSymbol = {
+	AT: "@",
+	HYPHEN: "-",
+	SLASH: "/"
+};
+const NameTransformMap = {
+	[NameTransformSymbol.AT]: "scope_",
+	[NameTransformSymbol.HYPHEN]: "_",
+	[NameTransformSymbol.SLASH]: "__"
+};
+const EncodedNameTransformMap = {
+	[NameTransformMap[NameTransformSymbol.AT]]: NameTransformSymbol.AT,
+	[NameTransformMap[NameTransformSymbol.HYPHEN]]: NameTransformSymbol.HYPHEN,
+	[NameTransformMap[NameTransformSymbol.SLASH]]: NameTransformSymbol.SLASH
+};
+const SEPARATOR = ":";
+const ManifestFileName = "mf-manifest.json";
+const StatsFileName = "mf-stats.json";
+const MFModuleType = {
+	NPM: "npm",
+	APP: "app"
+};
+const MODULE_DEVTOOL_IDENTIFIER = "__MF_DEVTOOLS_MODULE_INFO__";
+const ENCODE_NAME_PREFIX = "ENCODE_NAME_PREFIX";
+const TEMP_DIR = ".federation";
+const MFPrefetchCommon = {
+	identifier: "MFDataPrefetch",
+	globalKey: "__PREFETCH__",
+	library: "mf-data-prefetch",
+	exportsKey: "__PREFETCH_EXPORTS__",
+	fileName: "bootstrap.js"
+};
+let TreeShakingStatus = /* @__PURE__ */ function(TreeShakingStatus) {
+	/**
+	* Not handled by deploy server, needs to infer by the real runtime period.
+	*/
+	TreeShakingStatus[TreeShakingStatus["UNKNOWN"] = 1] = "UNKNOWN";
+	/**
+	* It means the shared has been calculated , runtime should take this shared as first choice.
+	*/
+	TreeShakingStatus[TreeShakingStatus["CALCULATED"] = 2] = "CALCULATED";
+	/**
+	* It means the shared has been calculated, and marked as no used
+	*/
+	TreeShakingStatus[TreeShakingStatus["NO_USE"] = 0] = "NO_USE";
+	return TreeShakingStatus;
+}({});
+
+//#endregion
+export { BROWSER_LOG_KEY, ENCODE_NAME_PREFIX, EncodedNameTransformMap, FederationModuleManifest, MANIFEST_EXT, MFModuleType, MFPrefetchCommon, MODULE_DEVTOOL_IDENTIFIER, ManifestFileName, NameTransformMap, NameTransformSymbol, SEPARATOR, StatsFileName, TEMP_DIR, TreeShakingStatus };
+//# sourceMappingURL=constant.js.map

package/dist/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","names":[],"sources":["../src/constant.ts"],"sourcesContent":["export const FederationModuleManifest = 'federation-manifest.json';\nexport const MANIFEST_EXT = '.json';\n\nexport const BROWSER_LOG_KEY = 'FEDERATION_DEBUG';\n\nexport const NameTransformSymbol = {\n  AT: '@',\n  HYPHEN: '-',\n  SLASH: '/',\n} as const;\nexport const NameTransformMap = {\n  [NameTransformSymbol.AT]: 'scope_',\n  [NameTransformSymbol.HYPHEN]: '_',\n  [NameTransformSymbol.SLASH]: '__',\n} as const;\n\nexport const EncodedNameTransformMap = {\n  [NameTransformMap[NameTransformSymbol.AT]]: NameTransformSymbol.AT,\n  [NameTransformMap[NameTransformSymbol.HYPHEN]]: NameTransformSymbol.HYPHEN,\n  [NameTransformMap[NameTransformSymbol.SLASH]]: NameTransformSymbol.SLASH,\n};\n\nexport const SEPARATOR = ':';\n\nexport const ManifestFileName = 'mf-manifest.json';\nexport const StatsFileName = 'mf-stats.json';\n\nexport const MFModuleType = {\n  NPM: 'npm',\n  APP: 'app',\n};\n\nexport const MODULE_DEVTOOL_IDENTIFIER = '__MF_DEVTOOLS_MODULE_INFO__';\nexport const ENCODE_NAME_PREFIX = 'ENCODE_NAME_PREFIX';\nexport const TEMP_DIR = '.federation';\n\nexport const MFPrefetchCommon = {\n  identifier: 'MFDataPrefetch',\n  globalKey: '__PREFETCH__',\n  library: 'mf-data-prefetch',\n  exportsKey: '__PREFETCH_EXPORTS__',\n  fileName: 'bootstrap.js',\n};\n\nexport const enum TreeShakingStatus {\n  /**\n   * Not handled by deploy server, needs to infer by the real runtime period.\n   */\n  UNKNOWN = 1,\n  /**\n   * It means the shared has been calculated , runtime should take this shared as first choice.\n   */\n  CALCULATED = 2,\n  /**\n   * It means the shared has been calculated, and marked as no used\n   */\n  NO_USE = 0,\n}\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,eAAe;AAE5B,MAAa,kBAAkB;AAE/B,MAAa,sBAAsB;CACjC,IAAI;CACJ,QAAQ;CACR,OAAO;CACR;AACD,MAAa,mBAAmB;EAC7B,oBAAoB,KAAK;EACzB,oBAAoB,SAAS;EAC7B,oBAAoB,QAAQ;CAC9B;AAED,MAAa,0BAA0B;EACpC,iBAAiB,oBAAoB,MAAM,oBAAoB;EAC/D,iBAAiB,oBAAoB,UAAU,oBAAoB;EACnE,iBAAiB,oBAAoB,SAAS,oBAAoB;CACpE;AAED,MAAa,YAAY;AAEzB,MAAa,mBAAmB;AAChC,MAAa,gBAAgB;AAE7B,MAAa,eAAe;CAC1B,KAAK;CACL,KAAK;CACN;AAED,MAAa,4BAA4B;AACzC,MAAa,qBAAqB;AAClC,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAC9B,YAAY;CACZ,WAAW;CACX,SAAS;CACT,YAAY;CACZ,UAAU;CACX;AAED,IAAkB,gEAAX;;;;AAIL;;;;AAIA;;;;AAIA"}

package/dist/createModuleFederationConfig.cjs

@@ -0,0 +1,9 @@
+
+//#region src/createModuleFederationConfig.ts
+const createModuleFederationConfig = (options) => {
+	return options;
+};
+
+//#endregion
+exports.createModuleFederationConfig = createModuleFederationConfig;
+//# sourceMappingURL=createModuleFederationConfig.cjs.map

package/dist/createModuleFederationConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createModuleFederationConfig.cjs","names":[],"sources":["../src/createModuleFederationConfig.ts"],"sourcesContent":["import type { moduleFederationPlugin } from './types/plugins';\n\nexport const createModuleFederationConfig = (\n  options: moduleFederationPlugin.ModuleFederationPluginOptions,\n): moduleFederationPlugin.ModuleFederationPluginOptions => {\n  return options;\n};\n"],"mappings":";;AAEA,MAAa,gCACX,YACyD;AACzD,QAAO"}

package/dist/createModuleFederationConfig.d.ts

@@ -0,0 +1,6 @@
+import { ModuleFederationPluginOptions } from "./types/plugins/ModuleFederationPlugin.js";
+//#region src/createModuleFederationConfig.d.ts
+declare const createModuleFederationConfig: (options: ModuleFederationPluginOptions) => ModuleFederationPluginOptions;
+//#endregion
+export { createModuleFederationConfig };
+//# sourceMappingURL=createModuleFederationConfig.d.ts.map

package/dist/createModuleFederationConfig.js

@@ -0,0 +1,8 @@
+//#region src/createModuleFederationConfig.ts
+const createModuleFederationConfig = (options) => {
+	return options;
+};
+
+//#endregion
+export { createModuleFederationConfig };
+//# sourceMappingURL=createModuleFederationConfig.js.map

package/dist/createModuleFederationConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createModuleFederationConfig.js","names":[],"sources":["../src/createModuleFederationConfig.ts"],"sourcesContent":["import type { moduleFederationPlugin } from './types/plugins';\n\nexport const createModuleFederationConfig = (\n  options: moduleFederationPlugin.ModuleFederationPluginOptions,\n): moduleFederationPlugin.ModuleFederationPluginOptions => {\n  return options;\n};\n"],"mappings":";AAEA,MAAa,gCACX,YACyD;AACzD,QAAO"}

package/dist/dom.cjs

@@ -0,0 +1,180 @@
+const require_utils = require('./utils.cjs');
+
+//#region src/dom.ts
+async function safeWrapper(callback, disableWarn) {
+	try {
+		return await callback();
+	} catch (e) {
+		!disableWarn && require_utils.warn(e);
+		return;
+	}
+}
+function isStaticResourcesEqual(url1, url2) {
+	const REG_EXP = /^(https?:)?\/\//i;
+	return url1.replace(REG_EXP, "").replace(/\/$/, "") === url2.replace(REG_EXP, "").replace(/\/$/, "");
+}
+function createScript(info) {
+	let script = null;
+	let needAttach = true;
+	let timeout = 2e4;
+	let timeoutId;
+	const scripts = document.getElementsByTagName("script");
+	for (let i = 0; i < scripts.length; i++) {
+		const s = scripts[i];
+		const scriptSrc = s.getAttribute("src");
+		if (scriptSrc && isStaticResourcesEqual(scriptSrc, info.url)) {
+			script = s;
+			needAttach = false;
+			break;
+		}
+	}
+	if (!script) {
+		const attrs = info.attrs;
+		script = document.createElement("script");
+		script.type = attrs?.["type"] === "module" ? "module" : "text/javascript";
+		let createScriptRes = void 0;
+		if (info.createScriptHook) {
+			createScriptRes = info.createScriptHook(info.url, info.attrs);
+			if (createScriptRes instanceof HTMLScriptElement) script = createScriptRes;
+			else if (typeof createScriptRes === "object") {
+				if ("script" in createScriptRes && createScriptRes.script) script = createScriptRes.script;
+				if ("timeout" in createScriptRes && createScriptRes.timeout) timeout = createScriptRes.timeout;
+			}
+		}
+		if (!script.src) script.src = info.url;
+		if (attrs && !createScriptRes) Object.keys(attrs).forEach((name) => {
+			if (script) {
+				if (name === "async" || name === "defer") script[name] = attrs[name];
+				else if (!script.getAttribute(name)) script.setAttribute(name, attrs[name]);
+			}
+		});
+	}
+	let executionError = null;
+	const executionErrorHandler = typeof window !== "undefined" ? (evt) => {
+		if (evt.filename && isStaticResourcesEqual(evt.filename, info.url)) {
+			const err = /* @__PURE__ */ new Error(`ScriptExecutionError: Script "${info.url}" loaded but threw a runtime error during execution: ${evt.message} (${evt.filename}:${evt.lineno}:${evt.colno})`);
+			err.name = "ScriptExecutionError";
+			executionError = err;
+		}
+	} : null;
+	if (executionErrorHandler) window.addEventListener("error", executionErrorHandler);
+	const onScriptComplete = async (prev, event) => {
+		clearTimeout(timeoutId);
+		if (executionErrorHandler) window.removeEventListener("error", executionErrorHandler);
+		const onScriptCompleteCallback = () => {
+			if (event?.type === "error") {
+				const networkError = /* @__PURE__ */ new Error(`ScriptNetworkError: Failed to load script "${info.url}" - the script URL is unreachable or the server returned an error (network failure, 404, CORS, etc.)`);
+				networkError.name = "ScriptNetworkError";
+				info?.onErrorCallback && info?.onErrorCallback(networkError);
+			} else if (executionError) info?.onErrorCallback && info?.onErrorCallback(executionError);
+			else info?.cb && info?.cb();
+		};
+		if (script) {
+			script.onerror = null;
+			script.onload = null;
+			safeWrapper(() => {
+				const { needDeleteScript = true } = info;
+				if (needDeleteScript) script?.parentNode && script.parentNode.removeChild(script);
+			});
+			if (prev && typeof prev === "function") {
+				const result = prev(event);
+				if (result instanceof Promise) {
+					const res = await result;
+					onScriptCompleteCallback();
+					return res;
+				}
+				onScriptCompleteCallback();
+				return result;
+			}
+		}
+		onScriptCompleteCallback();
+	};
+	script.onerror = onScriptComplete.bind(null, script.onerror);
+	script.onload = onScriptComplete.bind(null, script.onload);
+	timeoutId = setTimeout(() => {
+		onScriptComplete(null, /* @__PURE__ */ new Error(`Remote script "${info.url}" time-outed.`));
+	}, timeout);
+	return {
+		script,
+		needAttach
+	};
+}
+function createLink(info) {
+	let link = null;
+	let needAttach = true;
+	const links = document.getElementsByTagName("link");
+	for (let i = 0; i < links.length; i++) {
+		const l = links[i];
+		const linkHref = l.getAttribute("href");
+		const linkRel = l.getAttribute("rel");
+		if (linkHref && isStaticResourcesEqual(linkHref, info.url) && linkRel === info.attrs["rel"]) {
+			link = l;
+			needAttach = false;
+			break;
+		}
+	}
+	if (!link) {
+		link = document.createElement("link");
+		link.setAttribute("href", info.url);
+		let createLinkRes = void 0;
+		const attrs = info.attrs;
+		if (info.createLinkHook) {
+			createLinkRes = info.createLinkHook(info.url, attrs);
+			if (createLinkRes instanceof HTMLLinkElement) link = createLinkRes;
+		}
+		if (attrs && !createLinkRes) Object.keys(attrs).forEach((name) => {
+			if (link && !link.getAttribute(name)) link.setAttribute(name, attrs[name]);
+		});
+	}
+	const onLinkComplete = (prev, event) => {
+		const onLinkCompleteCallback = () => {
+			if (event?.type === "error") info?.onErrorCallback && info?.onErrorCallback(event);
+			else info?.cb && info?.cb();
+		};
+		if (link) {
+			link.onerror = null;
+			link.onload = null;
+			safeWrapper(() => {
+				const { needDeleteLink = true } = info;
+				if (needDeleteLink) link?.parentNode && link.parentNode.removeChild(link);
+			});
+			if (prev) {
+				const res = prev(event);
+				onLinkCompleteCallback();
+				return res;
+			}
+		}
+		onLinkCompleteCallback();
+	};
+	link.onerror = onLinkComplete.bind(null, link.onerror);
+	link.onload = onLinkComplete.bind(null, link.onload);
+	return {
+		link,
+		needAttach
+	};
+}
+function loadScript(url, info) {
+	const { attrs = {}, createScriptHook } = info;
+	return new Promise((resolve, reject) => {
+		const { script, needAttach } = createScript({
+			url,
+			cb: resolve,
+			onErrorCallback: reject,
+			attrs: {
+				fetchpriority: "high",
+				...attrs
+			},
+			createScriptHook,
+			needDeleteScript: true
+		});
+		needAttach && document.head.appendChild(script);
+	});
+}
+
+//#endregion
+exports.createLink = createLink;
+exports.createScript = createScript;
+exports.isStaticResourcesEqual = isStaticResourcesEqual;
+exports.loadScript = loadScript;
+exports.safeWrapper = safeWrapper;
+//# sourceMappingURL=dom.cjs.map

package/dist/dom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.cjs","names":["warn"],"sources":["../src/dom.ts"],"sourcesContent":["import type { CreateScriptHookDom, CreateScriptHookReturnDom } from './types';\nimport { warn } from './utils';\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function safeWrapper<T extends (...args: Array<any>) => any>(\n  callback: T,\n  disableWarn?: boolean,\n): Promise<ReturnType<T> | undefined> {\n  try {\n    const res = await callback();\n    return res;\n  } catch (e) {\n    !disableWarn && warn(e);\n    return;\n  }\n}\n\nexport function isStaticResourcesEqual(url1: string, url2: string): boolean {\n  const REG_EXP = /^(https?:)?\\/\\//i;\n  // Transform url1 and url2 into relative paths\n  const relativeUrl1 = url1.replace(REG_EXP, '').replace(/\\/$/, '');\n  const relativeUrl2 = url2.replace(REG_EXP, '').replace(/\\/$/, '');\n  // Check if the relative paths are identical\n  return relativeUrl1 === relativeUrl2;\n}\n\nexport function createScript(info: {\n  url: string;\n  cb?: (value: void | PromiseLike<void>) => void;\n  onErrorCallback?: (error: Error) => void;\n  attrs?: Record<string, any>;\n  needDeleteScript?: boolean;\n  createScriptHook?: CreateScriptHookDom;\n}): { script: HTMLScriptElement; needAttach: boolean } {\n  // Retrieve the existing script element by its src attribute\n  let script: HTMLScriptElement | null = null;\n  let needAttach = true;\n  let timeout = 20000;\n  let timeoutId: NodeJS.Timeout;\n  const scripts = document.getElementsByTagName('script');\n\n  for (let i = 0; i < scripts.length; i++) {\n    const s = scripts[i];\n    const scriptSrc = s.getAttribute('src');\n    if (scriptSrc && isStaticResourcesEqual(scriptSrc, info.url)) {\n      script = s;\n      needAttach = false;\n      break;\n    }\n  }\n\n  if (!script) {\n    const attrs = info.attrs;\n    script = document.createElement('script');\n    script.type = attrs?.['type'] === 'module' ? 'module' : 'text/javascript';\n    let createScriptRes: CreateScriptHookReturnDom = undefined;\n    if (info.createScriptHook) {\n      createScriptRes = info.createScriptHook(info.url, info.attrs);\n\n      if (createScriptRes instanceof HTMLScriptElement) {\n        script = createScriptRes;\n      } else if (typeof createScriptRes === 'object') {\n        if ('script' in createScriptRes && createScriptRes.script) {\n          script = createScriptRes.script;\n        }\n        if ('timeout' in createScriptRes && createScriptRes.timeout) {\n          timeout = createScriptRes.timeout;\n        }\n      }\n    }\n    if (!script.src) {\n      script.src = info.url;\n    }\n    if (attrs && !createScriptRes) {\n      Object.keys(attrs).forEach((name) => {\n        if (script) {\n          if (name === 'async' || name === 'defer') {\n            script[name] = attrs[name];\n            // Attributes that do not exist are considered overridden\n          } else if (!script.getAttribute(name)) {\n            script.setAttribute(name, attrs[name]);\n          }\n        }\n      });\n    }\n  }\n\n  // Capture JS runtime errors thrown by this script's IIFE during execution.\n  // The browser still fires onload even when the script throws, so without this\n  // listener the execution error would silently become an uncaught global exception.\n  let executionError: Error | null = null;\n  const executionErrorHandler =\n    typeof window !== 'undefined'\n      ? (evt: ErrorEvent) => {\n          if (evt.filename && isStaticResourcesEqual(evt.filename, info.url)) {\n            const err = new Error(\n              `ScriptExecutionError: Script \"${info.url}\" loaded but threw a runtime error during execution: ${evt.message} (${evt.filename}:${evt.lineno}:${evt.colno})`,\n            );\n            err.name = 'ScriptExecutionError';\n            executionError = err;\n          }\n        }\n      : null;\n  if (executionErrorHandler) {\n    window.addEventListener('error', executionErrorHandler);\n  }\n\n  const onScriptComplete = async (\n    prev: OnErrorEventHandler | GlobalEventHandlers['onload'] | null,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    event: any,\n  ): Promise<void> => {\n    clearTimeout(timeoutId);\n    if (executionErrorHandler) {\n      window.removeEventListener('error', executionErrorHandler);\n    }\n    const onScriptCompleteCallback = () => {\n      if (event?.type === 'error') {\n        const networkError = new Error(\n          `ScriptNetworkError: Failed to load script \"${info.url}\" - the script URL is unreachable or the server returned an error (network failure, 404, CORS, etc.)`,\n        );\n        networkError.name = 'ScriptNetworkError';\n        info?.onErrorCallback && info?.onErrorCallback(networkError);\n      } else if (executionError) {\n        // Script fetched OK (onload fired) but IIFE threw during execution.\n        info?.onErrorCallback && info?.onErrorCallback(executionError);\n      } else {\n        info?.cb && info?.cb();\n      }\n    };\n\n    // Prevent memory leaks in IE.\n    if (script) {\n      script.onerror = null;\n      script.onload = null;\n      safeWrapper(() => {\n        const { needDeleteScript = true } = info;\n        if (needDeleteScript) {\n          script?.parentNode && script.parentNode.removeChild(script);\n        }\n      });\n      if (prev && typeof prev === 'function') {\n        const result = (prev as any)(event);\n        if (result instanceof Promise) {\n          const res = await result;\n          onScriptCompleteCallback();\n          return res;\n        }\n        onScriptCompleteCallback();\n        return result;\n      }\n    }\n    onScriptCompleteCallback();\n  };\n\n  script.onerror = onScriptComplete.bind(null, script.onerror);\n  script.onload = onScriptComplete.bind(null, script.onload);\n\n  timeoutId = setTimeout(() => {\n    onScriptComplete(\n      null,\n      new Error(`Remote script \"${info.url}\" time-outed.`),\n    );\n  }, timeout);\n\n  return { script, needAttach };\n}\n\nexport function createLink(info: {\n  url: string;\n  cb?: (value: void | PromiseLike<void>) => void;\n  onErrorCallback?: (error: Error) => void;\n  attrs: Record<string, string>;\n  needDeleteLink?: boolean;\n  createLinkHook?: (\n    url: string,\n    attrs?: Record<string, any>,\n  ) => HTMLLinkElement | void;\n}) {\n  // <link rel=\"preload\" href=\"script.js\" as=\"script\">\n\n  // Retrieve the existing script element by its src attribute\n  let link: HTMLLinkElement | null = null;\n  let needAttach = true;\n  const links = document.getElementsByTagName('link');\n  for (let i = 0; i < links.length; i++) {\n    const l = links[i];\n    const linkHref = l.getAttribute('href');\n    const linkRel = l.getAttribute('rel');\n    if (\n      linkHref &&\n      isStaticResourcesEqual(linkHref, info.url) &&\n      linkRel === info.attrs['rel']\n    ) {\n      link = l;\n      needAttach = false;\n      break;\n    }\n  }\n\n  if (!link) {\n    link = document.createElement('link');\n    link.setAttribute('href', info.url);\n\n    let createLinkRes: void | HTMLLinkElement = undefined;\n    const attrs = info.attrs;\n\n    if (info.createLinkHook) {\n      createLinkRes = info.createLinkHook(info.url, attrs);\n      if (createLinkRes instanceof HTMLLinkElement) {\n        link = createLinkRes;\n      }\n    }\n\n    if (attrs && !createLinkRes) {\n      Object.keys(attrs).forEach((name) => {\n        if (link && !link.getAttribute(name)) {\n          link.setAttribute(name, attrs[name]);\n        }\n      });\n    }\n  }\n\n  const onLinkComplete = (\n    prev: OnErrorEventHandler | GlobalEventHandlers['onload'] | null,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    event: any,\n  ): void => {\n    const onLinkCompleteCallback = () => {\n      if (event?.type === 'error') {\n        info?.onErrorCallback && info?.onErrorCallback(event);\n      } else {\n        info?.cb && info?.cb();\n      }\n    };\n    // Prevent memory leaks in IE.\n    if (link) {\n      link.onerror = null;\n      link.onload = null;\n      safeWrapper(() => {\n        const { needDeleteLink = true } = info;\n        if (needDeleteLink) {\n          link?.parentNode && link.parentNode.removeChild(link);\n        }\n      });\n      if (prev) {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const res = (prev as any)(event);\n        onLinkCompleteCallback();\n        return res;\n      }\n    }\n    onLinkCompleteCallback();\n  };\n\n  link.onerror = onLinkComplete.bind(null, link.onerror);\n  link.onload = onLinkComplete.bind(null, link.onload);\n\n  return { link, needAttach };\n}\n\nexport function loadScript(\n  url: string,\n  info: {\n    attrs?: Record<string, any>;\n    createScriptHook?: CreateScriptHookDom;\n  },\n) {\n  const { attrs = {}, createScriptHook } = info;\n  return new Promise<void>((resolve, reject) => {\n    const { script, needAttach } = createScript({\n      url,\n      cb: resolve,\n      onErrorCallback: reject,\n      attrs: {\n        fetchpriority: 'high',\n        ...attrs,\n      },\n      createScriptHook,\n      needDeleteScript: true,\n    });\n    needAttach && document.head.appendChild(script);\n  });\n}\n"],"mappings":"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"}

package/dist/dom.d.ts

@@ -0,0 +1,33 @@
+import { CreateScriptHookDom } from "./types/hooks.js";
+//#region src/dom.d.ts
+declare function safeWrapper<T extends (...args: Array<any>) => any>(callback: T, disableWarn?: boolean): Promise<ReturnType<T> | undefined>;
+declare function isStaticResourcesEqual(url1: string, url2: string): boolean;
+declare function createScript(info: {
+  url: string;
+  cb?: (value: void | PromiseLike<void>) => void;
+  onErrorCallback?: (error: Error) => void;
+  attrs?: Record<string, any>;
+  needDeleteScript?: boolean;
+  createScriptHook?: CreateScriptHookDom;
+}): {
+  script: HTMLScriptElement;
+  needAttach: boolean;
+};
+declare function createLink(info: {
+  url: string;
+  cb?: (value: void | PromiseLike<void>) => void;
+  onErrorCallback?: (error: Error) => void;
+  attrs: Record<string, string>;
+  needDeleteLink?: boolean;
+  createLinkHook?: (url: string, attrs?: Record<string, any>) => HTMLLinkElement | void;
+}): {
+  link: HTMLLinkElement;
+  needAttach: boolean;
+};
+declare function loadScript(url: string, info: {
+  attrs?: Record<string, any>;
+  createScriptHook?: CreateScriptHookDom;
+}): Promise<void>;
+//#endregion
+export { createLink, createScript, isStaticResourcesEqual, loadScript, safeWrapper };
+//# sourceMappingURL=dom.d.ts.map