@formancy/core

中文文档
0.13.0发布于 2026/11/06Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4970

无头型形成引擎:一个反应式评价图,在浏览器和节点中相同.

中文使用文档

@ 成型/ 核心

无头窗体引擎:一个在浏览器中运行且没有变化的架构 服务器,所以客户端和服务器对表单的含义永远不能有分歧.

没有框架导入,没有DOM,没有节点环球. 没有 @types/node 实值 故意——它使打字检查执行约束而不是审查员 不得不这样做.

两项负载决定

快照稳定身份. getFieldSnapshot(path) 返回同样的 冻结对象直到该字段的值,能见度,需要,被触碰的状态 或错误实际改变。 这就是让反应的 useSyncExternalStore 财务报告和审定财务报表 Angular的无区变化探测工作 没有纪念消费者 侧面:按键键在五千分之一的地上 重置其地 触动。 (计量:~0.4 ms 发动机工作每按下这个大小键

失败的方向是按关切选择的. 汇编失败——a 无法解析的表达式,一个幽灵字段参考,一个依赖周期——是 引擎建成后被拒绝,所以一个破损的形态永远不会到达一个人. 输入时评价失败是正常的, 并且有元数据失败 打开 (打破的能见度规则显示球场,而不是默默地吞下什么) 键入) 验证失败时 关闭 (不能评价的规则) 无法保证值 .

使用

import { createFormEngine } from '@formancy/core'

const engine = createFormEngine({
  schema,
  capabilities: { now: Date.now, today: () => '2026-09-20', random: Math.random },
})

engine.subscribeField(['email'], () => render())
engine.setValue(['email'], '[email protected]')
const { value, errors, props, ids } = engine.getFieldSnapshot(['email'])
const outcome = engine.submit()

引擎还提供无障碍标识和作曲 aria-describedby 中央,所以每个制造器都发出相同的接线 而不是三个团队 几乎都对了.

文档 : apps/docs。 。 。 .

版本与发布记录

@formancy/core 共发布 13 个版本,首次发布于 2026/09/21;过去 12 个月发布了 13 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.13.0latest2026/11/0610 天前
0.12.02026/11/0115 天前
0.11.02026/10/3016 天前
0.10.02026/10/3017 天前
0.9.02026/10/3017 天前
0.8.02026/10/2918 天前

关于 @formancy/core 的常见问题

@formancy/core 是什么?

无头型形成引擎:一个反应式评价图,在浏览器和节点中相同.

如何安装 @formancy/core?

在项目目录运行 npm install @formancy/core,或使用 pnpm add / yarn add / bun add。

@formancy/core 支持 TypeScript 吗?

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

@formancy/core 支持 ESM 还是 CommonJS?

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

@formancy/core 可以商用吗?

@formancy/core 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@formancy/core 的下载量有多少?

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

@formancy/core 还在维护吗?

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