@done-coding/forge

中文文档
0.102.0发布于 2026/11/10MITTypeScriptESM + CJS近 30 天下载 2030

Forge 组件库统一入口:聚合表单、数据、导航、反馈与布局编排组件

中文使用文档
文档目录4 节
  1. 安装与使用
  2. 消费边界
  3. 目录导航
  4. 用户行为与实验曝光

@done-coding/forge

应用统一入口,聚合 core、form、data、nav、feedback、compose 的公开组件与类型,并汇总样式。

安装与使用

pnpm add @done-coding/forge
import { AppLayout, FormMain, ModalPorter } from "@done-coding/forge";
import "@done-coding/forge/style.css";

宿主需设置全局盒模型 reset(多数项目已有);forge 组件按 border-box 设计,不自带全局 reset:

*,
*::before,
*::after {
  box-sizing: border-box;
}

消费边界

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。

文档与完整 API:使用文档。

MIT,Copyright (c) JustSoSu。完整许可见本包 LICENSE。

目录导航

  • src/index.ts:显式公共装配。
  • src/style.css:样式入口。
  • tests/:公共入口运行时兼容测试。
  • vite.config.ts:ESM preserveModules/声明构建与测试发现。

用户行为与实验曝光

聚合导出 useBehaviorPort、createBehaviorPort、BEHAVIOR_DEFAULT_EVENTS 及 BehaviorContext / BehaviorRecord / BehaviorPortOptions / BehaviorPort / BehaviorExposure。应用自行提供上下文和 send;分组不等于曝光,实际呈现后显式调用 exposure。见 端口 API。

版本与发布记录

@done-coding/forge 共发布 12 个版本,首次发布于 2026/11/05;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.102.0latest2026/11/103 天前
0.101.1-alpha.0alpha2026/11/103 天前
0.101.02026/11/094 天前
0.100.3-alpha.02026/11/094 天前
0.100.22026/11/077 天前
0.100.2-alpha.02026/11/077 天前

其他发布通道:placeholder → 0.0.0-placeholder.0,alpha → 0.101.1-alpha.0。

关于 @done-coding/forge 的常见问题

@done-coding/forge 是什么?

Forge 组件库统一入口:聚合表单、数据、导航、反馈与布局编排组件

如何安装 @done-coding/forge?

在项目目录运行 npm install @done-coding/forge,或使用 pnpm add / yarn add / bun add。

@done-coding/forge 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@done-coding/forge 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@done-coding/forge 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@done-coding/forge 可以商用吗?

@done-coding/forge 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@done-coding/forge 的下载量有多少?

根据 npm 官方下载统计,@done-coding/forge 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,030 次,日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@done-coding/forge 还在维护吗?

最新版本 0.102.0 发布于 2026/11/10(3 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/11/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。