@bimetal/headless-core

中文文档
0.42.0发布于 2026/10/30Apache-2.0TypeScriptES Module零依赖近 30 天下载 1.3万

域中性无头控制器核心:身份-稳定得到Snapshot/订阅(使用SyncExternalStore合同),一个版本总线,和一个错误-状态表面. 共享蓝图 每个组件控制器( Calendar, Kanban,...) 作曲—— 所以子

中文使用文档

@ bimetal/ 无头核心

BIMETAL 组件家族共享的域中立控制器核心 (卡伦达尔,坎班,. 零从属.

它拥有每个组件控制器需要的通用~30%,即: 错误复制 :

  • 身份稳定 getSnapshot - 返回相同的引用直到 版本实际移动。 这是 useSyncExternalStore 合同; 获取 错误的原因导致循环 或僵化UI.
  • 一个版本总线 —— 说 markChanged() 单击版本并通知 订户; subscribe(listener) 编号 : destroy()。 。 。 .
  • 错误- 状态 —— 说 setLastAction 编号 : getLastAction 编号 : dismissLastAction 因此,规则违反 和WIP拒绝 表面作为快照场(敬酒) 而不是在渲染道上抛出.
import { createControllerCore } from '@bimetal/headless-core';

const core = createControllerCore({ buildSnapshot: () => buildMySnapshot() });
// component intents mutate local state, then call core.markChanged()

构成部分控制器(createCalendarController, (中文(简体) ), createKanbanController(中文(简体) ) 由其中之一组成,并只加入它们的相互作用语义. 框架 绑定 消耗 SnapshotSource<TSnapshot> 合同 - { getSnapshot, subscribe, destroy } ——一般地,所以每个框架绑定的驱动器 每个组件.

版本与发布记录

@bimetal/headless-core 共发布 15 个版本,首次发布于 2026/07/16;过去 12 个月发布了 15 个版本。

版本发布日期距今
0.42.0latest2026/10/308 天前
0.41.02026/10/2415 天前
0.40.02026/10/1128 天前
0.39.02026/10/061 个月前
0.38.02026/10/041 个月前
0.37.02026/09/131 个月前

其他发布通道:next → 1.0.0-rc.3。

关于 @bimetal/headless-core 的常见问题

@bimetal/headless-core 是什么?

域中性无头控制器核心:身份-稳定得到Snapshot/订阅(使用SyncExternalStore合同),一个版本总线,和一个错误-状态表面. 共享蓝图 每个组件控制器( Calendar, Kanban,...) 作曲—— 所以子

如何安装 @bimetal/headless-core?

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

@bimetal/headless-core 支持 TypeScript 吗?

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

@bimetal/headless-core 支持 ESM 还是 CommonJS?

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

@bimetal/headless-core 可以商用吗?

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

@bimetal/headless-core 的下载量有多少?

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

@bimetal/headless-core 还在维护吗?

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