API 参考
Tabula 以十个 @tabula-css/* 包的形式发布,共同构成一条流水线。你编写扁平的 DTCG 设计令牌(design token),tabula build(即 cli)将其转换为生成的 .tabula/ 产物和 registry.json(通过 tokens 和 registry),随后该注册表在运行时被合并函数(merge)和 Tailwind 入口样式表(preset)读取,并由 linter(eslint-plugin、stylelint-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/cli—tabula命令行工具:build、build --check、check:css、scan、migrate、except add、doctor、explain、canary。@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/产物的智能体接口。