@dd-code/uni-tools 1.0.13 → 1.0.14

package/README.md

@@ -2,16 +2,17 @@
 
 `@dd-code/uni-tools` 是一个针对 UniApp 的微信小程序（mp-weixin）模块化解决方案与工具集，目标是让「主应用 + 多子应用（分包）」的开发、联调与构建更顺畅、更自动化。
 
-## 项目简介
-- 面向微信小程序的模块化架构：主应用负责壳与公共能力，子应用以分包形式集成。
-- 自动管理主/子应用的 `app.json`、`pages.json` 等配置合并，减少人工维护成本。
-- 开发态具备文件监听、自动同步与应用间通信能力，提升联调效率。
-- 提供统一 CLI 命令，简化拉取子应用仓库、开发、构建等流程。
+## 特性
+- 主/子应用模块化：主应用负责壳与公共能力，子应用以分包形式接入。
+- 配置自动合并：自动汇总各子应用的 `pages.json` 并生成最终 `app.json`。
+- 开发态联调：监听子应用构建输出并同步至主应用分包目录，支持 WS 通知。
+- 运行时暴露：通过 `@dd-code/runtime` 统一导出公共模块（如 `store/index.js`）。
+- 一体化 CLI：拉取子应用仓库、启动开发、执行构建，开箱即用。
 
 ## 有哪些命令
-- `npx uni-tools fetch`：交互式拉取已配置的子应用仓库到本地工作空间（packages/uni-tools/src/cli.ts:20）。
-- `npx uni-tools serve -p mp-weixin --mode development`：启动开发态；自动识别主/子应用并启动对应插件逻辑（packages/uni-tools/src/cli.ts:14）。
-- `npx uni-tools build -p mp-weixin --mode production`：执行生产构建，按模块化架构输出主应用及分包（packages/uni-tools/src/cli.ts:52）。
+- `npx uni-tools fetch`：交互式拉取子应用仓库到本地（packages/uni-tools/src/cli.ts:20）。
+- `npx uni-tools serve -p mp-weixin --mode development`：启动开发态，识别主/子应用并启用对应插件（packages/uni-tools/src/cli.ts:14）。
+- `npx uni-tools build -p mp-weixin --mode production`：生产构建输出主应用与分包（packages/uni-tools/src/cli.ts:52）。
 - 可选参数：
   - `-p <platform>`：平台，默认 `h5`，支持 `mp-weixin`。
   - `--mode <mode>`：模式，默认 `development`。
@@ -25,18 +26,29 @@
 - 生产构建可控：按环境与模式输出稳定的主应用与分包结构，避免配置漂移与遗漏。
 - 仓库管理简化：通过交互命令拉取/更新子应用仓库，快速搭建本地联调环境。
 
-## 大致的实现逻辑
-- 插件入口与平台分发（packages/uni-tools/src/plugins/mp-weixin.ts:8-22）
-  - 检测当前平台是否为 `mp-weixin`，是则注册一组 Vite 插件：环境初始化、资源处理、Manifest 管理、主应用逻辑等。
-- Manifest 管理与 `app.json` 合并（packages/uni-tools/src/plugins/modules/mp-weixin/plugins/main-app.ts:31-76, 105-119, 261-279）
-  - 读取各子应用的 `pages.json`，生成分包结构并合并到主应用的 `app.json`。
-  - 在 `closeBundle` 钩子中根据当前模式（开发/构建）与是否主应用，决定是否生成或更新最终的 `app.json`。
-- 开发态联调（packages/uni-tools/src/plugins/modules/mp-weixin/plugins/main-app.ts:121-156, 187-245）
-  - 主应用启动 WebSocket 服务，子应用作为客户端连接；
-  - 监听子应用构建输出目录变更（`DistWatcher`），变更时拷贝至主应用对应分包路径，并通过 WS 通知；
-  - 收到子应用变更通知后，主应用实时增量更新 `app.json` 中的对应分包页面配置。
-- 交互式拉取子应用仓库（packages/uni-tools/src/plugins/modules/mp-weixin/gitlib/index.ts）
-  - 使用交互框选择需要拉取的应用，自动将其下载/更新至本地指定目录，便于快速联调。
+## 架构与插件
+- 入口与平台分发：`packages/uni-tools/src/plugins/mp-weixin.ts:8-22`
+- 目录分层：`core/ + plugins/ + server/ + utils`，职责明确、低耦合
+  - `core`：运行时与 `app.json` 处理（如 `core/app-json.ts`、`core/runtime.ts`）
+  - `plugins`：Vite 插件（主应用、exposes 等）
+  - `server`：HTTP/WS 服务
+  - `utils`：通用工具（文件复制、下载等）
+- Manifest 管理与 `app.json` 合并：`packages/uni-tools/src/plugins/modules/mp-weixin/plugins/main-app.ts:31-76, 105-119, 261-279`
+  - 汇总子应用 `pages.json`，渲染为主应用分包配置并写入 `app.json`
+  - 写入采用内容比较，避免频繁重启与重复打包（`core/app-json.ts`）
+- 开发态联调：`packages/uni-tools/src/plugins/modules/mp-weixin/plugins/main-app.ts:121-156, 187-245`
+  - 主应用启动 WS 服务，子应用变更触发同步与增量更新
+  - 监听拷贝使用内容比较，避免无效触发（`utils/copy.ts`）
+
+## 运行时暴露（Runtime Exposes）
+- 目标：在任意页面通过 `@dd-code/runtime` 访问公共模块导出（如 `store/index.js`）
+- 使用方式：
+  - 在页面或模块中 `import { userStore } from '@dd-code/runtime'`
+  - 插件在打包阶段生成 `__mfe_runtime__.js` 于根目录，并将各处引用指向它
+- 实现要点：
+  - `load` 阶段生成占位引用，`generateBundle` 计算相对路径并替换（`packages/uni-tools/src/plugins/modules/mp-weixin/plugins/exposes.ts:91-109`）
+  - 所有 `@dd-code/runtime/*` 形式在 `resolveId` 阶段重定向到同一虚拟模块（保持单一产物）
+  - 可通过 `options.exposes` 扩展需要暴露的模块与导出
 
 ## 配置与环境变量
 - `mfe.json`（项目根目录，packages/uni-tools/src/config/const.ts:1）
@@ -70,18 +82,18 @@
 1. 安装依赖：
    - 使用你的包管理器安装 `@dd-code/uni-tools`。
 2. 在 `vite.config.ts` 中启用插件：
-   ```ts
-   import { defineConfig } from 'vite';
-   import uni from '@dcloudio/vite-plugin-uni';
-   import uniTools from '@dd-code/uni-tools';
-
-   export default defineConfig({
-     plugins: [
-       uni(),
-       uniTools()
-     ],
-   });
-   ```
+  ```ts
+  import { defineConfig } from 'vite';
+  import uni from '@dcloudio/vite-plugin-uni';
+  import uniTools from '@dd-code/uni-tools';
+
+  export default defineConfig({
+    plugins: [
+      uni(),
+      uniTools()
+    ],
+  });
+  ```
 3. 拉取子应用仓库：`npx uni-tools fetch`
 4. 启动开发：`npx uni-tools serve -p mp-weixin --mode development`
 5. 构建生产：`npx uni-tools build -p mp-weixin --mode production`
@@ -118,6 +130,11 @@
 - 子应用：分包形式接入，拥有独立 `pages.json` 与资源；构建输出由插件监听并同步。
 - Manifest 与分包配置生成：读取各子应用 `pages.json` 并渲染至主应用 `subPackages`（packages/uni-tools/src/plugins/modules/mp-weixin/plugins/main-app.ts:41-69）。
 
+## 常见问题
+- 端口被占用（`MFE_UNI_SERVE=true`）：HTTP/WS 服务具备幂等复用与端口探测，避免重复 `listen`（packages/uni-tools/src/plugins/modules/mp-weixin/server/http-server.ts）。
+- 开发态频繁重启/重复打包：写入 `app.json` 与文件拷贝均进行内容比较，仅在变更时写入（`core/app-json.ts`、`utils/copy.ts`）。
+- CLI 交互报错（inquirer 兼容）：已采用动态导入并移动到依赖，`npx` 下可正常使用（packages/uni-tools/src/plugins/modules/mp-weixin/gitlib/index.ts, packages/uni-tools/package.json）。
+
 ## 适用场景
 - 同一个小程序中承载多个业务模块/团队的功能分包，需要高效联调与统一发布。
 - 希望减少主/子应用配置的重复劳动与易错区域。
@@ -127,3 +144,54 @@
 - 开发态会根据 `mode`、`isRoot` 等状态决定是否启动 WS 服务与目录监听。
 - 请确保各子应用的 `pages.json` 合法且页面路径正确，便于自动合并。
  - 使用 `--b root` 时需先启动主应用的 HTTP 服务，以便子应用定位 `UNI_OUTPUT_DIR`（packages/uni-tools/src/plugins/modules/mp-weixin/output.ts:39-59）。
+
+## 接入指南（主/子应用）
+- 主应用配置
+  - 在 `vite.config.ts` 中启用插件并声明暴露映射：
+    ```ts
+    import { defineConfig } from 'vite';
+    import uni from '@dcloudio/vite-plugin-uni';
+    import uniTools from '@dd-code/uni-tools';
+
+    export default defineConfig({
+      plugins: [
+        uni(),
+        uniTools({
+          exposes: {
+            '.': '@/store/index',       // -> @dd-code/runtime
+            './axios': '@/axios/index', // -> @dd-code/runtime/axios
+          }
+        })
+      ],
+    });
+    ```
+  - 键规则：以 `.` 开头，`'.'` 表示根运行时入口，`'./xxx'` 表示子入口；值为主应用 `src/` 下模块路径，支持 `@/` 别名。
+- 子应用使用
+  - 在任意页面或模块中直接引用：
+    ```ts
+    import { userStore } from '@dd-code/runtime';
+    import { axios } from '@dd-code/runtime/axios';
+    ```
+  - 构建后，运行时文件输出为根目录 `__mfe_runtime__.js`，各子入口统一指向该文件的导出。
+- 运行与构建约定
+  - 主应用 `.env.development`：
+    ```
+    MFE_UNI_IS_ROOT=true
+    MFE_UNI_CODE=your-project-code
+    MFE_UNI_SERVE=true
+    UNI_PLATFORM=mp-weixin
+    ```
+  - 子应用 `.env.development`：
+    ```
+    MFE_UNI_IS_ROOT=false
+    MFE_UNI_CODE=your-project-code
+    MFE_APP_CODE=modules/your-app
+    MFE_UNI_SERVE=true
+    UNI_PLATFORM=mp-weixin
+    ```
+  - 开发：主/子应用分别执行 `npx uni-tools serve -p mp-weixin --mode development`，联调时主应用作为 WS 服务端，子应用作为客户端。
+  - 子应用直写主应用（不联调）：在主应用启动 HTTP 接口后执行 `npx uni-tools build -p mp-weixin --mode development --b root`，产物将按 `appCode` 写入主应用输出目录。
+- 验证与排错
+  - 构建后检查根目录是否存在 `__mfe_runtime__.js`。
+  - 若子入口未生效，确认主应用 `exposes` 配置键值对应正确，且导出为命名导出。
+  - 避免无效重启：确保 `app.json` 与文件拷贝只在内容变化时写入（已内置比较）。

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+interface IUniConfigOptions {
+    exposes?: Record<string, string>;
+}
+
 /**
  * 创建 dd-code Uni 插件
  * @description 根据配置文件和传入选项创建插件实例
@@ -9,6 +13,6 @@
  *   customOption: 'value'
  * });
  */
-declare const _default: (options?: Record<string, any>) => any[];
+declare const _default: (options?: IUniConfigOptions) => any[];
 
 export { _default as default };

package/dist/index.js

@@ -275,6 +275,11 @@ var unlinkDeepDirOrFile = function (filePath) {
         console.error("删除文件夹失败：", err);
     }
 };
+var getFilePathWithoutExt = function (filePath) {
+    var dirName = path.dirname(filePath);
+    var baseName = path.basename(filePath, path.extname(filePath));
+    return path.join(dirName, baseName);
+};
 
 var UniCdnManager = /** @class */ (function () {
     function UniCdnManager() {
@@ -661,6 +666,9 @@ var createManifestManager = function () {
             newManifest.hash = generateSHA256(JSON.stringify(__assign({}, newManifest)));
             writeFiles(filePath, JSON.stringify(newManifest, null, 2));
         },
+        setExposes: function (exposes) {
+            row.exposes = exposes || {};
+        },
         setEnv: function (mode) {
             var env = formatCliCommandConfig(mode);
             var mfeJson = getMfeJson();
@@ -682,6 +690,47 @@ var createManifestManager = function () {
         },
     };
 };
+var getRootMainManifestJson = function (code, mode) { return __awaiter(void 0, void 0, void 0, function () {
+    var pageManifest, nodeModulesManifest, cdnUrl, manifestJson;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                try {
+                    pageManifest = uniReadFile(path.join(process.env.UNI_OUTPUT_DIR, MANIFEST_NAME));
+                    if (Object.keys(pageManifest).length !== 0) {
+                        return [2 /*return*/, pageManifest];
+                    }
+                }
+                catch (_c) { }
+                try {
+                    nodeModulesManifest = uniReadFile(path.join(SAVE_CDN_FILE_PATH, mode, ROOT_APP_CODE, MANIFEST_NAME));
+                    if (Object.keys(nodeModulesManifest).length !== 0) {
+                        return [2 /*return*/, nodeModulesManifest];
+                    }
+                }
+                catch (_d) { }
+                _b.label = 1;
+            case 1:
+                _b.trys.push([1, 3, , 4]);
+                cdnUrl = cdn.getManifestUrl({
+                    code: code,
+                    appCode: ROOT_APP_CODE,
+                    mode: mode,
+                });
+                return [4 /*yield*/, fetchFileByPath(cdnUrl)];
+            case 2:
+                manifestJson = _b.sent();
+                if (Object.keys(manifestJson).length !== 0) {
+                    return [2 /*return*/, manifestJson];
+                }
+                return [3 /*break*/, 4];
+            case 3:
+                _b.sent();
+                return [3 /*break*/, 4];
+            case 4: return [2 /*return*/, { exposes: {} }];
+        }
+    });
+}); };
 
 var num = 5;
 var getMainProcess = function () { return __awaiter(void 0, void 0, void 0, function () {
@@ -1500,8 +1549,170 @@ var createMainAppPlugin = function (manifestJson) {
     ];
 };
 
+var buildName = "mfe_runtime/__mfe_{template}_runtime__.js";
+var RUNTIME_NAME = "@dd-code/runtime";
+// const runtimeDir = 'mfe_runtime'
+var RUNTIME_NAME_REGEXP = new RegExp(RUNTIME_NAME + "(/.*)?");
+var renderRuntimeCode = function (moduleExpose, appCode) {
+    var deepPath = path.relative(path.join(appCode, path.dirname(buildName)), ".");
+    var resultCode = "";
+    var _a = moduleExpose || {}, _b = _a.exports, exportName = _b === void 0 ? [] : _b, filePath = _a.path;
+    exportName.forEach(function (item) {
+        resultCode += "export const {".concat(item, "} = require('").concat(deepPath, "/").concat(filePath, "');");
+    });
+    return resultCode;
+};
+var createExposesPlugin = function (options, currentManifestJson) {
+    if (options === void 0) { options = {}; }
+    options.exposes = options.exposes || {};
+    var mainAppExposeCode = {};
+    return [
+        {
+            name: "@chagee:uni-exposes",
+            enforce: "post",
+            configResolved: function (config) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var manifestJson;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4 /*yield*/, getRootMainManifestJson(currentManifestJson.value.code, currentManifestJson.value.mode)];
+                            case 1:
+                                manifestJson = _a.sent();
+                                mainAppExposeCode = manifestJson.exposes || {};
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            resolveId: function (id, importer) {
+                return __awaiter(this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        if (RUNTIME_NAME_REGEXP.test(id)) {
+                            return [2 /*return*/, id];
+                        }
+                        return [2 /*return*/];
+                    });
+                });
+            },
+            load: function (id) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var matched, deepPath, moduleExpose;
+                    return __generator(this, function (_a) {
+                        if (RUNTIME_NAME_REGEXP.test(id)) {
+                            matched = id.match(RUNTIME_NAME_REGEXP);
+                            deepPath = "." + ((matched === null || matched === void 0 ? void 0 : matched[1]) || "");
+                            moduleExpose = mainAppExposeCode[deepPath] || {};
+                            return [2 /*return*/, renderRuntimeCode(moduleExpose, currentManifestJson.value.appCode)];
+                        }
+                        return [2 /*return*/];
+                    });
+                });
+            },
+            buildStart: function () {
+                return __awaiter(this, void 0, void 0, function () {
+                    var _i, _a, _b, spec, r, id, fileName, fileNameWithoutExt;
+                    var _this = this;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                // 显式发射 runtime chunk，确保它被打包到根目录
+                                Object.keys(mainAppExposeCode).forEach(function (key) {
+                                    var keyDir = key.replace(/\./g, "").replace(/\//g, "_");
+                                    _this.emitFile({
+                                        type: "chunk",
+                                        id: path.join(RUNTIME_NAME, key),
+                                        fileName: buildName.replace("{template}", keyDir),
+                                    });
+                                });
+                                _i = 0, _a = Object.entries(options.exposes || {});
+                                _c.label = 1;
+                            case 1:
+                                if (!(_i < _a.length)) return [3 /*break*/, 4];
+                                _b = _a[_i], _b[0], spec = _b[1];
+                                return [4 /*yield*/, this.resolve(spec)];
+                            case 2:
+                                r = _c.sent();
+                                if (r) {
+                                    id = r === null || r === void 0 ? void 0 : r.id;
+                                    fileName = path.relative(process.cwd() + "/src/", id);
+                                    fileNameWithoutExt = getFilePathWithoutExt(fileName);
+                                    this.emitFile({
+                                        type: "chunk",
+                                        id: r.id,
+                                        name: fileNameWithoutExt,
+                                    });
+                                }
+                                _c.label = 3;
+                            case 3:
+                                _i++;
+                                return [3 /*break*/, 1];
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            generateBundle: function (_, bundles) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var chunks, resolveIdsMap, _loop_1, this_1, _a, _b, _c, _i, i;
+                    return __generator(this, function (_d) {
+                        switch (_d.label) {
+                            case 0:
+                                chunks = Object.values(bundles).filter(function (b) { return b.type === "chunk"; });
+                                resolveIdsMap = {};
+                                _loop_1 = function (i) {
+                                    var moduleId, owner;
+                                    return __generator(this, function (_e) {
+                                        switch (_e.label) {
+                                            case 0: return [4 /*yield*/, this_1.resolve(options.exposes[i])];
+                                            case 1:
+                                                moduleId = _e.sent();
+                                                if (moduleId) {
+                                                    owner = chunks.find(function (c) { return c.modules && c.modules[moduleId.id]; });
+                                                    if (owner) {
+                                                        resolveIdsMap[i] = {
+                                                            path: owner.fileName,
+                                                            exports: owner.exports,
+                                                        };
+                                                    }
+                                                }
+                                                return [2 /*return*/];
+                                        }
+                                    });
+                                };
+                                this_1 = this;
+                                _a = options.exposes;
+                                _b = [];
+                                for (_c in _a)
+                                    _b.push(_c);
+                                _i = 0;
+                                _d.label = 1;
+                            case 1:
+                                if (!(_i < _b.length)) return [3 /*break*/, 4];
+                                _c = _b[_i];
+                                if (!(_c in _a)) return [3 /*break*/, 3];
+                                i = _c;
+                                return [5 /*yield**/, _loop_1(i)];
+                            case 2:
+                                _d.sent();
+                                _d.label = 3;
+                            case 3:
+                                _i++;
+                                return [3 /*break*/, 1];
+                            case 4:
+                                currentManifestJson.setExposes(resolveIdsMap);
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+        },
+    ];
+};
+
 var createMpWeixinUniPlugin = function (options) {
+    if (options === void 0) { options = {}; }
     var currentManifestJson = createManifestManager();
+    options.exposes = options.exposes || {};
     return [
         {
             name: "@dd-code:genre-params",
@@ -1511,7 +1722,7 @@ var createMpWeixinUniPlugin = function (options) {
                     return __generator(this, function (_a) {
                         switch (_a.label) {
                             case 0:
-                                currentManifestJson.setEnv(config.mode);
+                                currentManifestJson.setEnv(config.mode || "dev");
                                 // 清空 PUBLISH_PATH 目录
                                 unlinkDeepDirOrFile(PUBLISH_PATH);
                                 return [4 /*yield*/, resetOutDir(currentManifestJson, config)];
@@ -1523,6 +1734,7 @@ var createMpWeixinUniPlugin = function (options) {
                 });
             },
         },
+        createExposesPlugin(options, currentManifestJson),
         createAppsAssetsPlugin(currentManifestJson),
         createManifestPlugin(currentManifestJson),
         createMainAppPlugin(currentManifestJson),
@@ -1543,7 +1755,7 @@ var createMpWeixinUniPlugin = function (options) {
 var index = (function (options) {
     var platform = getPlatform();
     return platform === EPlaform.MP_WEIXIN
-        ? createMpWeixinUniPlugin()
+        ? createMpWeixinUniPlugin(options)
         : [];
 });
 

package/dist/index.mjs.js

@@ -273,6 +273,11 @@ var unlinkDeepDirOrFile = function (filePath) {
         console.error("删除文件夹失败：", err);
     }
 };
+var getFilePathWithoutExt = function (filePath) {
+    var dirName = path.dirname(filePath);
+    var baseName = path.basename(filePath, path.extname(filePath));
+    return path.join(dirName, baseName);
+};
 
 var UniCdnManager = /** @class */ (function () {
     function UniCdnManager() {
@@ -659,6 +664,9 @@ var createManifestManager = function () {
             newManifest.hash = generateSHA256(JSON.stringify(__assign({}, newManifest)));
             writeFiles(filePath, JSON.stringify(newManifest, null, 2));
         },
+        setExposes: function (exposes) {
+            row.exposes = exposes || {};
+        },
         setEnv: function (mode) {
             var env = formatCliCommandConfig(mode);
             var mfeJson = getMfeJson();
@@ -680,6 +688,47 @@ var createManifestManager = function () {
         },
     };
 };
+var getRootMainManifestJson = function (code, mode) { return __awaiter(void 0, void 0, void 0, function () {
+    var pageManifest, nodeModulesManifest, cdnUrl, manifestJson;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                try {
+                    pageManifest = uniReadFile(path.join(process.env.UNI_OUTPUT_DIR, MANIFEST_NAME));
+                    if (Object.keys(pageManifest).length !== 0) {
+                        return [2 /*return*/, pageManifest];
+                    }
+                }
+                catch (_c) { }
+                try {
+                    nodeModulesManifest = uniReadFile(path.join(SAVE_CDN_FILE_PATH, mode, ROOT_APP_CODE, MANIFEST_NAME));
+                    if (Object.keys(nodeModulesManifest).length !== 0) {
+                        return [2 /*return*/, nodeModulesManifest];
+                    }
+                }
+                catch (_d) { }
+                _b.label = 1;
+            case 1:
+                _b.trys.push([1, 3, , 4]);
+                cdnUrl = cdn.getManifestUrl({
+                    code: code,
+                    appCode: ROOT_APP_CODE,
+                    mode: mode,
+                });
+                return [4 /*yield*/, fetchFileByPath(cdnUrl)];
+            case 2:
+                manifestJson = _b.sent();
+                if (Object.keys(manifestJson).length !== 0) {
+                    return [2 /*return*/, manifestJson];
+                }
+                return [3 /*break*/, 4];
+            case 3:
+                _b.sent();
+                return [3 /*break*/, 4];
+            case 4: return [2 /*return*/, { exposes: {} }];
+        }
+    });
+}); };
 
 var num = 5;
 var getMainProcess = function () { return __awaiter(void 0, void 0, void 0, function () {
@@ -1498,8 +1547,170 @@ var createMainAppPlugin = function (manifestJson) {
     ];
 };
 
+var buildName = "mfe_runtime/__mfe_{template}_runtime__.js";
+var RUNTIME_NAME = "@dd-code/runtime";
+// const runtimeDir = 'mfe_runtime'
+var RUNTIME_NAME_REGEXP = new RegExp(RUNTIME_NAME + "(/.*)?");
+var renderRuntimeCode = function (moduleExpose, appCode) {
+    var deepPath = path.relative(path.join(appCode, path.dirname(buildName)), ".");
+    var resultCode = "";
+    var _a = moduleExpose || {}, _b = _a.exports, exportName = _b === void 0 ? [] : _b, filePath = _a.path;
+    exportName.forEach(function (item) {
+        resultCode += "export const {".concat(item, "} = require('").concat(deepPath, "/").concat(filePath, "');");
+    });
+    return resultCode;
+};
+var createExposesPlugin = function (options, currentManifestJson) {
+    if (options === void 0) { options = {}; }
+    options.exposes = options.exposes || {};
+    var mainAppExposeCode = {};
+    return [
+        {
+            name: "@chagee:uni-exposes",
+            enforce: "post",
+            configResolved: function (config) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var manifestJson;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4 /*yield*/, getRootMainManifestJson(currentManifestJson.value.code, currentManifestJson.value.mode)];
+                            case 1:
+                                manifestJson = _a.sent();
+                                mainAppExposeCode = manifestJson.exposes || {};
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            resolveId: function (id, importer) {
+                return __awaiter(this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        if (RUNTIME_NAME_REGEXP.test(id)) {
+                            return [2 /*return*/, id];
+                        }
+                        return [2 /*return*/];
+                    });
+                });
+            },
+            load: function (id) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var matched, deepPath, moduleExpose;
+                    return __generator(this, function (_a) {
+                        if (RUNTIME_NAME_REGEXP.test(id)) {
+                            matched = id.match(RUNTIME_NAME_REGEXP);
+                            deepPath = "." + ((matched === null || matched === void 0 ? void 0 : matched[1]) || "");
+                            moduleExpose = mainAppExposeCode[deepPath] || {};
+                            return [2 /*return*/, renderRuntimeCode(moduleExpose, currentManifestJson.value.appCode)];
+                        }
+                        return [2 /*return*/];
+                    });
+                });
+            },
+            buildStart: function () {
+                return __awaiter(this, void 0, void 0, function () {
+                    var _i, _a, _b, spec, r, id, fileName, fileNameWithoutExt;
+                    var _this = this;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                // 显式发射 runtime chunk，确保它被打包到根目录
+                                Object.keys(mainAppExposeCode).forEach(function (key) {
+                                    var keyDir = key.replace(/\./g, "").replace(/\//g, "_");
+                                    _this.emitFile({
+                                        type: "chunk",
+                                        id: path.join(RUNTIME_NAME, key),
+                                        fileName: buildName.replace("{template}", keyDir),
+                                    });
+                                });
+                                _i = 0, _a = Object.entries(options.exposes || {});
+                                _c.label = 1;
+                            case 1:
+                                if (!(_i < _a.length)) return [3 /*break*/, 4];
+                                _b = _a[_i], _b[0], spec = _b[1];
+                                return [4 /*yield*/, this.resolve(spec)];
+                            case 2:
+                                r = _c.sent();
+                                if (r) {
+                                    id = r === null || r === void 0 ? void 0 : r.id;
+                                    fileName = path.relative(process.cwd() + "/src/", id);
+                                    fileNameWithoutExt = getFilePathWithoutExt(fileName);
+                                    this.emitFile({
+                                        type: "chunk",
+                                        id: r.id,
+                                        name: fileNameWithoutExt,
+                                    });
+                                }
+                                _c.label = 3;
+                            case 3:
+                                _i++;
+                                return [3 /*break*/, 1];
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+            generateBundle: function (_, bundles) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var chunks, resolveIdsMap, _loop_1, this_1, _a, _b, _c, _i, i;
+                    return __generator(this, function (_d) {
+                        switch (_d.label) {
+                            case 0:
+                                chunks = Object.values(bundles).filter(function (b) { return b.type === "chunk"; });
+                                resolveIdsMap = {};
+                                _loop_1 = function (i) {
+                                    var moduleId, owner;
+                                    return __generator(this, function (_e) {
+                                        switch (_e.label) {
+                                            case 0: return [4 /*yield*/, this_1.resolve(options.exposes[i])];
+                                            case 1:
+                                                moduleId = _e.sent();
+                                                if (moduleId) {
+                                                    owner = chunks.find(function (c) { return c.modules && c.modules[moduleId.id]; });
+                                                    if (owner) {
+                                                        resolveIdsMap[i] = {
+                                                            path: owner.fileName,
+                                                            exports: owner.exports,
+                                                        };
+                                                    }
+                                                }
+                                                return [2 /*return*/];
+                                        }
+                                    });
+                                };
+                                this_1 = this;
+                                _a = options.exposes;
+                                _b = [];
+                                for (_c in _a)
+                                    _b.push(_c);
+                                _i = 0;
+                                _d.label = 1;
+                            case 1:
+                                if (!(_i < _b.length)) return [3 /*break*/, 4];
+                                _c = _b[_i];
+                                if (!(_c in _a)) return [3 /*break*/, 3];
+                                i = _c;
+                                return [5 /*yield**/, _loop_1(i)];
+                            case 2:
+                                _d.sent();
+                                _d.label = 3;
+                            case 3:
+                                _i++;
+                                return [3 /*break*/, 1];
+                            case 4:
+                                currentManifestJson.setExposes(resolveIdsMap);
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            },
+        },
+    ];
+};
+
 var createMpWeixinUniPlugin = function (options) {
+    if (options === void 0) { options = {}; }
     var currentManifestJson = createManifestManager();
+    options.exposes = options.exposes || {};
     return [
         {
             name: "@dd-code:genre-params",
@@ -1509,7 +1720,7 @@ var createMpWeixinUniPlugin = function (options) {
                     return __generator(this, function (_a) {
                         switch (_a.label) {
                             case 0:
-                                currentManifestJson.setEnv(config.mode);
+                                currentManifestJson.setEnv(config.mode || "dev");
                                 // 清空 PUBLISH_PATH 目录
                                 unlinkDeepDirOrFile(PUBLISH_PATH);
                                 return [4 /*yield*/, resetOutDir(currentManifestJson, config)];
@@ -1521,6 +1732,7 @@ var createMpWeixinUniPlugin = function (options) {
                 });
             },
         },
+        createExposesPlugin(options, currentManifestJson),
         createAppsAssetsPlugin(currentManifestJson),
         createManifestPlugin(currentManifestJson),
         createMainAppPlugin(currentManifestJson),
@@ -1541,7 +1753,7 @@ var createMpWeixinUniPlugin = function (options) {
 var index = (function (options) {
     var platform = getPlatform();
     return platform === EPlaform.MP_WEIXIN
-        ? createMpWeixinUniPlugin()
+        ? createMpWeixinUniPlugin(options)
         : [];
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dd-code/uni-tools",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Universal tools for code utilities",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",