@done-coding/forge-compose
布局与组件编排能力，用于组合表单、列表和应用布局。
应用统一消费 @done-coding/forge；本包的公开桶供实现包组合，入口以 package.json 的 exports 为准。
安装与使用
pnpm add @done-coding/forge
import { AppLayout, FormMain, ModalPorter } from "@done-coding/forge";
import "@done-coding/forge/style.css";
消费边界
ModalShelfMap 由 forge-core 定义，应用通过 declare module "@done-coding/forge" { interface ModalShelfMap { /* 业务键 */ } } 增广，约束 ModalPorter 与 ModalShelf。共享注入键沿用历史 @done-coding/admin-core namespace，保持 Symbol.for 身份。
agent、flow 和插件需独立消费。JS 导出不会合并 CSS，应用须显式引入 @done-coding/forge/style.css。
宿主须满足以下 peer 要求：
| 包 | 范围 |
|---|
@element-plus/icons-vue | ^2.3.1 |
element-plus | ^2.7.0 |
lodash | ^4.17.21 |
vue | ^3.4.0 |
vue-router | ^4.3.0 |
文档与完整 API：使用文档。
MIT，Copyright (c) JustSoSu。完整许可见本包 LICENSE。
目录导航
src/index.ts：显式公共装配。src/style.css：样式入口。src/components/{layout,compose}/：组件/类型/hooks/tests/API。vite.config.ts：ESM preserveModules/声明构建与测试发现。
关于 @done-coding/forge-compose 的常见问题
@done-coding/forge-compose 是什么？
Forge 编排组件：应用布局、页面骨架、列表详情与弹窗表单
如何安装 @done-coding/forge-compose？
在项目目录运行 npm install @done-coding/forge-compose，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3.4.0）、lodash（^4.17.21）、vue-router（^4.3.0）、element-plus（^2.7.0）、@element-plus/icons-vue（^2.3.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@done-coding/forge-compose 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@done-coding/forge-compose 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@done-coding/forge-compose 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@done-coding/forge-compose 可以商用吗？
@done-coding/forge-compose 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@done-coding/forge-compose 的下载量有多少？
根据 npm 官方下载统计，@done-coding/forge-compose 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,076 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@done-coding/forge-compose 还在维护吗？
最新版本 0.102.0 发布于 2026/11/10（3 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/11/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。