remote-reload-utils 0.0.17 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.0.0
+
+### Major Changes
+
+- 9306c65: changeset cli 集成 & 变更日志记录
+
 所有重要的项目变更都将记录在此文件中。
 
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
@@ -7,70 +13,69 @@
 
 ## [未发布]
 
+## [1.0.1] - 2026-03-20
+
+### Release
+
+- Published version 1.0.1 with patch bump
+
+
 ## [0.0.17] - 2026-03-19
 
 ### Release
 
 - Published version 0.0.17 with patch bump
 
-
 ## [0.0.16] - 2026-03-18
 
 ### Release
 
 - Published version 0.0.16 with patch bump
 
-
 ## [0.0.15] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.15 with patch bump
 
-
 ## [0.0.14] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.14 with patch bump
 
-
 ## [0.0.13] - 2026-03-17
 
 ### Release
 
 - Published version 0.0.13 with patch bump
 
-
 ## [0.0.12] - 2026-03-16
 
 ### Release
 
 - Published version 0.0.12 with patch bump
 
-
 ## [0.0.11] - 2026-03-16
 
 ### Release
 
 - Published version 0.0.11 with patch bump
 
-
 ## [0.0.10] - 2026-03-15
 
 ### Release
 
 - Published version 0.0.10 with patch bump
 
-
 ## [0.0.9] - 2026-03-15
 
 ### Release
 
 - Published version 0.0.9 with patch bump
 
-
 ### Refactor
+
 - 重构项目为模块化目录结构
   - `src/loader/` - 核心加载模块
   - `src/version/` - 版本管理模块
@@ -84,6 +89,7 @@
 - 更新 package.json types 路径为 `./dist/index.d.ts`
 
 ### Changed
+
 - 修复 preloadRemote 引用从 loadRemote2 改为 loadRemote
 - 移除 App.tsx 中未使用的 React 导入
 - 添加 release 脚本到 package.json
@@ -91,6 +97,7 @@
 ## [0.0.8] - 2026-03-15
 
 ### Refactor
+
 - 抽离公共工具函数到 `loadRemoteUtils.ts`
   - 新增 `fetchLatestVersion()` - 从 npm registry 获取最新版本
   - 新增 `getVersionCache()` / `setVersionCache()` - 缓存管理
@@ -103,14 +110,17 @@
 - 简化 `loadRemote.ts`，使用公共工具函数
 
 ### Changed
+
 - 更新 `index.ts` 导出，新增工具函数导出
 
 ### Docs
+
 - 更新 `loadRemote.md`，添加工具函数 API 文档
 
 ## [0.0.7] - 2026-03-15
 
 ### Features
+
 - 新增微前端工具函数集
   - 远程模块加载
   - React 多版本支持
@@ -121,15 +131,18 @@
 ## [0.0.6] - 2026-03-14
 
 ### Docs
+
 - 更新 README 和 loadRemote.md 文档
 - 添加使用指南和 API 参考
 
 ### Chore
+
 - 更新 remote-reload-utils 版本至 0.0.8
 
 ## [0.0.5] - 2026-03-14
 
 ### Features
+
 - 添加多版本远程加载功能
 - 支持自定义 shared 配置
 - 改进错误处理机制
@@ -137,33 +150,39 @@
 ## [0.0.4] - 2026-03-14
 
 ### Chore
+
 - 更新错误处理逻辑
 - 优化加载流程
 
 ## [0.0.3] - 2026-03-14
 
 ### Docs
+
 - 添加项目描述和 git 仓库信息
 - 更新 README 中的示例代码
 - 将 loadRemote.md 从 src 移动到根目录
 
 ### Chore
+
 - 更新 remote-reload-utils 的版本号至 0.0.3
 
 ## [0.0.2] - 2026-03-14
 
 ### Features
+
 - 添加 React 多版本加载功能（v17/v18/v19）
 - 添加共享配置支持
   - 默认共享 react 和 react-dom
   - 支持自定义共享模块
 
 ### Docs
+
 - 更新示例代码展示如何使用 loadRemoteMultiVersion
 
 ## [0.0.1] - 2026-03-14
 
 ### Features
+
 - 实现多版本远程模块加载功能
   - 支持 CDN 故障转移（jsdelivr、unpkg）
   - 支持本地 fallback 兜底
@@ -177,32 +196,32 @@
 
 ## 版本说明
 
-| 版本 | 日期 | 主要变更 |
-|------|------|----------|
-| 0.0.17 | 2026-03-19 | patch 版本发布 |
-|------|------|----------|
-| 0.0.16 | 2026-03-18 | patch 版本发布 |
-|------|------|----------|
-| 0.0.15 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.14 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.13 | 2026-03-17 | patch 版本发布 |
-|------|------|----------|
-| 0.0.12 | 2026-03-16 | patch 版本发布 |
-|------|------|----------|
-| 0.0.11 | 2026-03-16 | patch 版本发布 |
-|------|------|----------|
-| 0.0.10 | 2026-03-15 | patch 版本发布 |
-|------|------|----------|
-| 0.0.9 | 2026-03-15 | patch 版本发布 |
-|------|------|----------|
-| 0.0.9 | 2026-03-15 | 重构为模块化目录结构 |
-| 0.0.8 | 2026-03-15 | 重构代码结构，抽离公共工具函数 |
-| 0.0.7 | 2026-03-15 | 新增微前端工具函数集 |
-| 0.0.6 | 2026-03-14 | 文档更新 |
-| 0.0.5 | 2026-03-14 | 多版本远程加载 |
-| 0.0.4 | 2026-03-14 | 错误处理优化 |
-| 0.0.3 | 2026-03-14 | 文档和配置更新 |
-| 0.0.2 | 2026-03-14 | React 多版本支持 |
-| 0.0.1 | 2026-03-14 | 初始版本 |
+| 版本   | 日期       | 主要变更                       |
+| ------ | ---------- | ------------------------------ |
+| 0.0.17 | 2026-03-19 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.16 | 2026-03-18 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.15 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.14 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.13 | 2026-03-17 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.12 | 2026-03-16 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.11 | 2026-03-16 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.10 | 2026-03-15 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.9  | 2026-03-15 | patch 版本发布                 |
+| ------ | ------     | ----------                     |
+| 0.0.9  | 2026-03-15 | 重构为模块化目录结构           |
+| 0.0.8  | 2026-03-15 | 重构代码结构，抽离公共工具函数 |
+| 0.0.7  | 2026-03-15 | 新增微前端工具函数集           |
+| 0.0.6  | 2026-03-14 | 文档更新                       |
+| 0.0.5  | 2026-03-14 | 多版本远程加载                 |
+| 0.0.4  | 2026-03-14 | 错误处理优化                   |
+| 0.0.3  | 2026-03-14 | 文档和配置更新                 |
+| 0.0.2  | 2026-03-14 | React 多版本支持               |
+| 0.0.1  | 2026-03-14 | 初始版本                       |

package/dist/loader/utils.d.ts

@@ -21,11 +21,14 @@ export interface LoadResult {
     mf: ReturnType<typeof createInstance>;
 }
 export type RuntimeRemote = Parameters<ReturnType<typeof createInstance>['registerRemotes']>[0][number];
+declare const mfInstanceCache: Map<string, import("@module-federation/enhanced/runtime").ModuleFederation>;
+declare const mfInstanceLoadingCache: Map<string, Promise<LoadResult>>;
+export { mfInstanceCache, mfInstanceLoadingCache };
 /**
  * 尝试加载单个远程模块 URL
  * 注意：实际的重试机制在外层 loadRemoteMultiVersion 的 URL 遍历中实现
  */
-export declare function tryLoadRemote(scopeName: string, url: string, _retries: number, _delay: number, sharedConfig: Record<string, any>, plugins: ModuleFederationRuntimePlugin[], extraRemotes?: RuntimeRemote[], registerOptions?: {
+export declare function tryLoadRemote(scopeName: string, url: string, retries: number, delay: number, sharedConfig: Record<string, any>, plugins: ModuleFederationRuntimePlugin[], extraRemotes?: RuntimeRemote[], registerOptions?: {
     force?: boolean;
 }): Promise<LoadResult>;
 /**

package/dist/main.cjs

@@ -335,7 +335,7 @@ function buildRemotesIdentity(remotes) {
             entryGlobalName: remote.entryGlobalName || ''
         })).sort().join('|');
 }
-async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
+async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
     const remotesIdentity = buildRemotesIdentity(extraRemotes);
     const cacheKey = `${scopeName}::${url}::${remotesIdentity}::${registerOptions.force ? 'force' : 'normal'}`;
     const cachedMfs = mfInstanceCache.get(cacheKey);
@@ -345,28 +345,35 @@ async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plu
     };
     const loadingMfs = mfInstanceLoadingCache.get(cacheKey);
     if (loadingMfs) return loadingMfs;
-    const loadPromise = Promise.resolve().then(()=>{
-        const mf = (0, runtime_namespaceObject.createInstance)({
-            name: 'host',
-            remotes: [
-                {
-                    name: scopeName,
-                    entry: url
-                }
-            ],
-            shared: sharedConfig,
-            plugins: [
-                ...plugins,
-                fallbackPlugin()
-            ]
-        });
-        if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
-        const result = {
-            scopeName,
-            mf
-        };
-        mfInstanceCache.set(cacheKey, mf);
-        return result;
+    const loadPromise = Promise.resolve().then(async ()=>{
+        let lastError;
+        for(let attempt = 0; attempt < retries; attempt++)try {
+            if (attempt > 0) await new Promise((resolve)=>setTimeout(resolve, delay));
+            const mf = (0, runtime_namespaceObject.createInstance)({
+                name: 'host',
+                remotes: [
+                    {
+                        name: scopeName,
+                        entry: url
+                    }
+                ],
+                shared: sharedConfig,
+                plugins: [
+                    ...plugins,
+                    fallbackPlugin()
+                ]
+            });
+            if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
+            const result = {
+                scopeName,
+                mf
+            };
+            mfInstanceCache.set(cacheKey, mf);
+            return result;
+        } catch (e) {
+            lastError = e;
+        }
+        throw lastError || new Error('Unknown error');
     });
     mfInstanceLoadingCache.set(cacheKey, loadPromise);
     try {

package/dist/main.js

@@ -267,7 +267,7 @@ function buildRemotesIdentity(remotes) {
             entryGlobalName: remote.entryGlobalName || ''
         })).sort().join('|');
 }
-async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
+async function tryLoadRemote(scopeName, url, retries, delay, sharedConfig, plugins, extraRemotes = [], registerOptions = {}) {
     const remotesIdentity = buildRemotesIdentity(extraRemotes);
     const cacheKey = `${scopeName}::${url}::${remotesIdentity}::${registerOptions.force ? 'force' : 'normal'}`;
     const cachedMfs = mfInstanceCache.get(cacheKey);
@@ -277,28 +277,35 @@ async function tryLoadRemote(scopeName, url, _retries, _delay, sharedConfig, plu
     };
     const loadingMfs = mfInstanceLoadingCache.get(cacheKey);
     if (loadingMfs) return loadingMfs;
-    const loadPromise = Promise.resolve().then(()=>{
-        const mf = createInstance({
-            name: 'host',
-            remotes: [
-                {
-                    name: scopeName,
-                    entry: url
-                }
-            ],
-            shared: sharedConfig,
-            plugins: [
-                ...plugins,
-                fallbackPlugin()
-            ]
-        });
-        if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
-        const result = {
-            scopeName,
-            mf
-        };
-        mfInstanceCache.set(cacheKey, mf);
-        return result;
+    const loadPromise = Promise.resolve().then(async ()=>{
+        let lastError;
+        for(let attempt = 0; attempt < retries; attempt++)try {
+            if (attempt > 0) await new Promise((resolve)=>setTimeout(resolve, delay));
+            const mf = createInstance({
+                name: 'host',
+                remotes: [
+                    {
+                        name: scopeName,
+                        entry: url
+                    }
+                ],
+                shared: sharedConfig,
+                plugins: [
+                    ...plugins,
+                    fallbackPlugin()
+                ]
+            });
+            if (extraRemotes.length > 0) mf.registerRemotes(extraRemotes, registerOptions);
+            const result = {
+                scopeName,
+                mf
+            };
+            mfInstanceCache.set(cacheKey, mf);
+            return result;
+        } catch (e) {
+            lastError = e;
+        }
+        throw lastError || new Error('Unknown error');
     });
     mfInstanceLoadingCache.set(cacheKey, loadPromise);
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-reload-utils",
-  "version": "0.0.17",
+  "version": "1.0.1",
   "type": "module",
   "description": "Utilities for remote reload in Module Federation & React Component",
   "exports": {
@@ -57,23 +57,6 @@
       "optional": true
     }
   },
-  "scripts": {
-    "build": "rslib build",
-    "dev": "rslib build --watch",
-    "prepublishOnly": "npm run build",
-    "format": "biome format --write",
-    "check": "biome check --write",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "biome format ./src --write",
-    "release:prepare": "node scripts/generateReleasePr.mjs",
-    "release:finalize": "node scripts/finalizeRelease.mjs",
-    "release:patch": "pnpm release:prepare -t patch",
-    "release:minor": "pnpm release:prepare -t minor",
-    "release:major": "pnpm release:prepare -t major",
-    "publish:dry": "npm publish --dry-run",
-    "publish:live": "npm publish"
-  },
   "devDependencies": {
     "@biomejs/biome": "2.0.6",
     "@rslib/core": "0.17.0",
@@ -90,7 +73,26 @@
     "typescript": "^5.9.2",
     "vitest": "^2.1.8"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@module-federation/enhanced": "0.18.3"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "dev": "rslib build --watch",
+    "format": "biome format --write",
+    "check": "biome check --write",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome format ./src --write",
+    "release:prepare": "node scripts/generateReleasePr.mjs",
+    "release:finalize": "node scripts/finalizeRelease.mjs",
+    "release:patch": "pnpm release:prepare -t patch",
+    "release:minor": "pnpm release:prepare -t minor",
+    "release:major": "pnpm release:prepare -t major",
+    "publish:dry": "npm publish --dry-run",
+    "publish:live": "npm publish"
   }
-}
+}