文档

产品介绍

Selrux UI(@selrux/ui)是基于已发布的 @selrux/headless 构建的 React 主题组件库,当前版本 0.4.0,peer 依赖 React 19 与 ReactDOM 19。

包含什么

  • 主题组件:package.json 声明了 75 个组件与配置子路径(如 @selrux/ui/button、@selrux/ui/table)。每个子路径单独导入,没有包根聚合导出。
  • 设计 Token:@selrux/ui/tokens.css ;组件样式按组件拆分并随入口自动引入,也可用全量 @selrux/ui/styles.css。变量统一以 --srx- 开头,样式都在 @layer srx 内(子层 tokens → base → component → composite)。
  • 配置域:ConfigProvider 设置明暗(light / dark)、表面外观(flat / layered)、角色色、默认尺寸、字号、字体、方向和语言包。
  • 语言包:@selrux/ui/locale/zh-CN 与 @selrux/ui/locale/en-US。
  • 反馈门面:@selrux/ui/app 提供 message / modal / notification。

不包含什么

本库不承担应用路由或业务模板。行为(状态机、焦点、浮层)来自 headless,主题组件不重复实现。

分发与许可

依赖安装使用包管理器当前配置;私有 registry 地址仅保存在开发者本机。package.json 的 license 为 UNLICENSED,即未授予开源许可;第三方声明见仓库中的 THIRD_PARTY_NOTICES.md。

文档现状

本站目前只完成了 Button 的组件文档,其余组件在组件总览中标注为“文档编写中”。