Ordo UI

概览

Ordo UI —— React 19 + Tailwind 4 + Base UI 组件库,从 ordo 主仓前端抽离,多项目共享

Ordo UI 是从 ordo 主仓前端抽离的独立组件库,承载 raw / ui 两层组件 + Tailwind 4 主题 token,经 npm 私有包 @mox-hub/ui 分发。

真相源结构

  • 组件源码与登记表唯一真相在 packages/ui:src/components/** + src/registry.ts(73 条,五态治理)
  • 主题 token 单一来源在 src/styles/theme.css(@theme 语义色桥 + :root/.dark 双主题基线)
  • 本站组件页由 registry 单向再生,pnpm check:docs 门禁强制零漂移

五态治理

状态含义
canonical生产可用(有真实消费方)
standby已落地待接线(先登记不删除)
internal内部件(不出画廊/文档重点区)
review裁决中
deprecated已废弃(expiresAt 护栏强制)

架构分层

  • raw(3 件):非动作交互元素具名直通出口,internal 态
  • ui(66+ 件):Base UI 原语 + cva 变体 + 语义 token 的原子层
  • semantic 升层件(7 件):依赖闭包纯净的语义组件(empty-state、async-state 等),2026-11-08 升层批进包
  • semantic 层本体(业务语义件)留在 ordo 主仓,不进库