API 레퍼런스

Tabula는 하나의 파이프라인을 이루는 열 개의 @tabula-css/* 패키지로 제공됩니다. 플랫(flat) DTCG 디자인 토큰을 작성하면 tabula build(cli)가 이를 생성된 .tabula/ 아티팩트와 registry.json(tokens과 registry를 통해)으로 변환하고, 이 레지스트리는 런타임에 병합 함수(merge)와 Tailwind 진입 스타일시트(preset)가 읽어 들이며, 에디터와 CI에서는 린터(eslint-plugin, stylelint-plugin)가 이를 강제하고, mcp 서버와 생성된 llms.txt를 통해 코딩 에이전트에게 노출됩니다. core는 다른 모든 패키지가 불변식을 가져오는, 의존성 없는 계약(contract)이며, react는 merge 위에 구축된 선택적 정석 경로(paved-path) 컴포넌트 집합입니다.

기반

• @tabula-css/core — Tabula의 코드형 계약(contract-as-code): 고정 테이블, 순수 함수, 오류 코드, JSON 스키마. 런타임 의존성 없음.
• @tabula-css/tokens — Tabula의 플랫 DTCG 프로파일 파서, 값 의미론(value-semantics) 검증기, 축(axis) 리졸버, 이미터.
• @tabula-css/registry — Tabula 레지스트리 생성기(두 개의 백엔드를 갖는 오라클)와, 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>. 레지스트리 기반 병합이며, import 그래프에 Tailwind가 없습니다.

도구

• @tabula-css/cli — tabula CLI: build, build --check, check:css, scan, migrate, except add, doctor, explain, canary.
• @tabula-css/eslint-plugin — Tabula의 강제 계층: 닫힌 어휘(closed vocabulary)를 강력한 게이트로 만드는 플랫 설정(flat-config) ESLint 플러그인. 레지스트리만 읽습니다(SPEC J15 — import 그래프에 Tailwind 없음).
• @tabula-css/stylelint-plugin — Tabula CSS 거버넌스: 다섯 가지 프로젝트-CSS 규칙(@apply 금지, 수작성 규칙 금지, 루트 전용 커스텀 속성, @theme inline 금지, !important 금지)을 stylelint 규칙으로 구현한 것, 그리고 tabula check:css가 실행하는 PostCSS 커널.

에이전트 서피스

• @tabula-css/mcp — Tabula의 읽기 전용 MCP 서버: 생성된 .tabula/ 아티팩트에 대한 에이전트 대면 서피스.

함께 보기

• 시작하기 — 이 파이프라인 전체를 처음부터 훑어보는 안내서.
• 핵심 개념 — 지역성, 레지스트리, 병합 알고리즘, 프로파일 레벨, 테마 설정, 금지된 메커니즘 카탈로그.
• 에이전트 서피스 — llms.txt, MCP 도구, 그리고 에이전트 서피스가 의존하는 실패-가시성(fail-visible) 보장.