open-index/open-npm huggingface dataset:
npm package: @obita-org/ui
Description: <!-- 文档更新：2026-01-08，作者：Codex -->
Latest version: 0.0.1

<!-- 文档更新：2026-01-08，作者：Codex -->

# obita-ui

Obita UI 组件库。

## 组件文档

- 组件文档位于对应组件目录内，例如 `src/components/Button/button.md` 与 `src/components/Button/button.en.md`
- 新增组件请参照 `src/components/DOCS_TEMPLATE.md`

## 主题色与暗夜模式

- 默认跟随系统 `prefers-color-scheme` 自动切换浅色/深色
- 可在根节点或任意容器设置 `data-theme="light|dark"` 进行手动覆盖
- 所有主题色通过 CSS 变量暴露，便于在业务侧覆盖

### 主题令牌示例（浅色）

```css
:root {
  --obita-color-primary: #0072f7;
  --obita-color-primary-hover: #1a82ff;
  --obita-color-primary-active: #0062d1;
  --obita-color-on-primary: #ffffff;
  --obita-color-success: #52c41a;
  --obita-color-warning: #faad14;
  --obita-color-error: #ff4d4f;
  --obita-color-info: #1677ff;
  --obita-color-bg: #ffffff;
  --obita-color-bg-subtle: #f8fafc;
  --obita-color-bg-elevated: #ffffff;
  --obita-color-text: #0f172a;
  --obita-color-text-muted: #475569;
  --obita-color-border: #cbd5e1;
}
```

### 手动切换示例

```html
<html data-theme="dark">
  <!-- 应用内容 -->
</html>
```

## 安装与发布（GitHub Packages）

安装前请在项目根目录创建 `.npmrc`：

```bash
@obita-org:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
```

安装：

```bash
npm install @obita-org/ui
```