@done-coding/forge-core

中文文档
0.102.0发布于 2026/11/10MITTypeScriptES Module零依赖近 30 天下载 2422

Forge 配置化底座:桥接、共享契约、路由与状态工具及基础组件

原始使用文档
文档目录4 节
  1. 安装与使用
  2. 消费边界
  3. 目录导航
  4. 登录守卫与外部登录

@done-coding/forge-core

配置化前端底座,提供 bridge、共享契约、注入键、路由、状态、工具和基础组件。

应用统一消费 @done-coding/forge;本包的公开桶供实现包组合,入口以 package.json 的 exports 为准。

安装与使用

pnpm add @done-coding/forge
import { createCoreBridge, ActionBtn } from "@done-coding/forge";
import "@done-coding/forge/style.css";

直接消费实现包时,改用本包入口及对应的 style.css;应用统一使用上述聚合入口。

消费边界

ModalShelfMap 由 forge-core 定义,应用通过 declare module "@done-coding/forge" { interface ModalShelfMap { /* 业务键 */ } } 增广,约束 ModalPorter 与 ModalShelf。共享注入键沿用历史 @done-coding/admin-core namespace,保持 Symbol.for 身份。

本包不依赖上层组件;internals 为包间实现契约,应用聚合不转出。需要 Pinia 2;本包不使用或注册 persistedstate,应用自定义持久化 store 时自行选择兼容插件。

宿主须满足以下 peer 要求:

包范围
@done-coding/request-axios^0.0.2
@element-plus/icons-vue^2.3.1
element-plus^2.7.0
lodash^4.17.21
pinia^2.1.7
vue^3.4.0
vue-router^4.3.0

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

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

目录导航

  • src/components/{basic,config,data,feedback,other}/:底座组件,含配套测试与 API 文档。
  • src/{bridge,config,helpers,hooks,inject,router,store,types,utils}/:底座实现与共享契约。
  • src/internals/:包间实现契约桶,应用根不转出。
  • src/injection-namespace.ts:固定历史注入身份。
  • vite.config.ts:全部公开桶入口的 ESM/声明构建。

登录守卫与外部登录

createGuard 检测到未登录时固定跳 loginPath 并带 from query;接口 401 经 bridge.goToLogin 走同一登录页。外部 IdP(如 OIDC signinRedirect、iframe 登录)由登录页自行发起,回调参数与 from 回跳也在登录页(或其回调路由)收拢;登录页与回调路由需列入免登录校验路由。forge 不提供守卫级外跳钩子,以免守卫与 goToLogin 两个入口行为分叉。

导出列协议 ExportColumn 的 label 来自 Element Plus 根入口 TableColumnCtx,不从组件构造器反推 props;列渲染与导出行为不变。

版本与发布记录

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

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

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

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

@done-coding/forge-core 是什么?

Forge 配置化底座:桥接、共享契约、路由与状态工具及基础组件

如何安装 @done-coding/forge-core?

在项目目录运行 npm install @done-coding/forge-core,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^3.4.0)、pinia(^2.1.7)、lodash(^4.17.21)、vue-router(^4.3.0)、element-plus(^2.7.0)、@element-plus/icons-vue(^2.3.1)、@done-coding/request-axios(^0.0.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@done-coding/forge-core 支持 TypeScript 吗?

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

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

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

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

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

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

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

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

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

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

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