Skip to content

API 参考

Tabula 以十个 @tabula-css/* 包的形式发布,共同构成一条流水线。你编写扁平的 DTCG 设计令牌(design token),tabula build(即 cli)将其转换为生成的 .tabula/ 产物和 registry.json(通过 tokensregistry),随后该注册表在运行时被合并函数(merge)和 Tailwind 入口样式表(preset)读取,并由 linter(eslint-pluginstylelint-plugin)在你的编辑器和 CI 中强制执行,还通过 mcp 服务器和生成的 llms.txt 暴露给编码智能体。core 是所有其他包据以导入其不变量的零依赖契约,而 react 是构建在 merge 之上的一组可选的“铺好的路径”组件。

基础

  • @tabula-css/core — Tabula 的“契约即代码”层:冻结表、纯函数、错误码,以及 JSON Schema。零运行时依赖。
  • @tabula-css/tokens — Tabula 的扁平 DTCG 配置档案解析器、值语义校验器、轴解析器与生成器。
  • @tabula-css/registry — Tabula 的注册表生成器(双后端 oracle),以及被 merge/eslint/mcp 使用的、不依赖 Tailwind 的注册表读取器。

运行时

  • @tabula-css/merge — Tabula 的运行时合并:cn()resolve()dyn()。只读取注册表(不依赖 Tailwind);是该配置档案的数学核心。
  • @tabula-css/preset — Tabula 的 Tailwind v4 入口组装:面向整个词汇表的 @import "tailwindcss" source(none) + @theme + @source inline()。纯库——由 CLI 负责写入文件。
  • @tabula-css/react — 可选的 Tabula “铺好的路径”原语:<Text><Separator><Prose>。基于注册表的合并;导入图中不含 Tailwind。

工具链

  • @tabula-css/clitabula 命令行工具:buildbuild --checkcheck:cssscanmigrateexcept adddoctorexplaincanary
  • @tabula-css/eslint-plugin — Tabula 的强制执行层:将封闭词汇表变为硬性门禁的 flat-config ESLint 插件。只读取注册表(SPEC J15——其导入图中不含 Tailwind)。
  • @tabula-css/stylelint-plugin — Tabula 的 CSS 治理:将五条项目 CSS 规则(禁止 @apply、禁止手写规则、自定义属性仅限根级、禁止 @theme inline、禁止 !important)实现为 stylelint 规则,外加 tabula check:css 运行的 PostCSS 内核。

智能体接口(agent surface)

  • @tabula-css/mcp — Tabula 的只读 MCP 服务器:面向生成的 .tabula/ 产物的智能体接口。

参见

  • 快速上手 — 一份从零开始、贯穿整条流水线的演练。
  • 概念 — 局部性、注册表、合并算法、配置档案层级、主题化,以及禁用机制目录。
  • 智能体接口llms.txt、MCP 工具,以及智能体接口所依赖的“故障可见”保证。

Released under the MIT License.