@songluo/ui-base
监管平台基础组件层——55 个 shadcn/ui 组件 + 主题令牌(oklch,明暗双套)。零平台依赖,可独立构建消费。
安装
npm i @songluo/ui-base
使用
import { Button, Card, CardContent } from '@songluo/ui-base';
import '@songluo/ui-base/dist/style.css';
export default () => (
<Card>
<CardContent>
<Button>确定</Button>
</CardContent>
</Card>
);
只要主题变量:import '@songluo/ui-base/theme.css'。CDN/UMD 通道见 supervision-ui-sdk。
换肤(白标)
覆盖主题变量白名单内的 CSS 变量即整体换肤(改 --primary 等),加载顺序晚于组件 style.css。
完整清单与派生位注意事项见仓库 docs/theme-token-whitelist.md —— --primary、
--radius、--chart-*、--sidebar-* 一族等。暗色给 <html class="dark">。
公开 API 与稳定性
- 公开面 = 组件导出名 + 各组件 props(以 shadcn 官方同名组件为准)+ 主题变量白名单。
- 非公开(不承诺稳定):DOM 结构、内部类名本身、白名单外的 CSS 变量、
@theme inline 映射段。
换肤请用白名单变量,不要选中内部类名覆盖。
- 变更遵循 semver 版本政策;破坏性只在 major,弃用先经一个 minor 缓冲。
冻结面全表见
docs/api-surface.md,变更记录见根 CHANGELOG.md。
当前处于 0.x,公开面可能调整,升级前读 CHANGELOG。
License
见根 README.md License 段(法务定稿前为占位)。