文档

设计初衷

中后台界面的核心是查询、表格与操作。Selrux UI 想让这些界面在层级、状态和对齐上稳定一致，而不是靠装饰取胜。

行为与视觉分离

交互行为优先复用 @selrux/headless 的公开 API。以 Button 为例：激活、禁用和 loading 拦截都交给 headless，主题层只补充语义色、展示方式、尺寸和忙碌图标。上游缺少能力时，先明确跨仓库修改范围与版本影响，而不是在主题层另写一套。

颜色、尺寸、间距、圆角、阴影、动效时长都是 --srx-* 变量；组件用 CVA 把有限的颜色 / 变体 / 尺寸映射到语义类名。复杂状态写在组件自己的 CSS 中，不靠改全局样式修补局部页面。

仓库约定：演示或后台页面避免大面积渐变、玻璃卡片、过度阴影、大圆角、无意义大图标、过多 emoji、营销风格、无业务统计卡片和过度动效。按钮层级、状态和表单对齐保持统一。

写代码前先检索真实定义、同类实现与公开导出，不编造 API、import 路径或依赖版本。公开属性的边界用编译期契约固定，例如 Button 已移除的 appearance、asChild 等会在类型检查时报错。