niuma-ui 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -6,6 +6,23 @@
 
 ## [Unreleased]
 
+## [2.0.2] - 2026-09-21
+
+### 变更
+
+- 未设 `locale` 时按本机语言选择（`navigator.languages`）：`zh*` → `zh-CN`，`en*` → `en-US`，已登记语言按前缀匹配。无法识别或 SSR 回退 `zh-CN`。显式传 `locale` 的应用不受影响。
+
+### 新增
+
+- `t()` ICU 子集复数：`{count, plural, one {#} other {#}}`，`Intl.PluralRules`。
+- `rsLocaleMessageKeys`：社区语言包 key 清单。说明见 `docs/locales.md`。
+- `RsConfigProvider` 把解析后的 `dir` / `locale` 传给 Reka，Select 等浮层跟书写方向。
+- 公开导出 `resolveDirMode`、`resolveHostLocale`。
+- 文档站 / npm README 默认英文；中文见 `README.zh-CN.md`。
+- RTL 像素回归：`/#/visual/rs-rtl`。
+
+## [2.0.1] - 2026-09-21
+
 ### 变更
 
 - 单测放到对应模块的 `__tests__/`；跨组件冒烟仍留在 `src/__tests__/`。
@@ -15,6 +32,20 @@
 - 每个组件内部为 `index.ts` + `src/` + 可选 `style/` + `__tests__/`。
 - 表格 `src/` 再拆：`table-header` / `table-body` / `table-footer` / `composables` / `context` / `features` / `utils`。
 - 架构契约补齐目录规范：组件四槽、`src/` 再拆门槛、仓库根、`package.json` 发布面（`docs/components.md` §3）。
+- `:root` 不再默认暗色。未写属性时用浅色 token。暗色宿主请在 `index.html` 写 `data-rs-theme="dark"` 或 `theme="dark"`，避免首屏闪浅色。
+- `themePresets` 标明仅参考，不驱动画面。
+- 文字公开 token 改为 `--rs-text-primary` 等；`--rs-text` / `--rs-muted` / `--rs-placeholder` 降为别名。
+- 数据源品牌色移出通用 `styles.css`。需要官方色的宿主加 `import 'niuma-ui/brand-icons.css'`。
+
+### 新增
+
+- `RsConfigProvider` `theme` 支持 `system`，跟随 `prefers-color-scheme`。`applyTheme` 仍写解析后的 `data-rs-theme="light|dark"`，并标 `data-rs-theme-pref="system"`。
+- `resolveThemeMode` / `readResolvedTheme` / `useRsConfig().resolvedTheme`。无 `data-rs-theme` 时按浅色，与 Provider 默认一致。
+- 内置品牌图标名单 `rsBrandIconNames`；Lucide 走 `--rs-icon-color`。图形规则在 `src/icons/style/brand-icons.css`。
+- `registerRsLocale`：第三方登记 BCP-47 文案；缺 key 回退 en-US。
+- `RsConfigProvider dir`（`ltr` / `rtl` / `auto`），写入 `dir` / `lang` / `data-rs-dir`。
+- 高对比：`forced-colors` 下语义 token 映射系统色。
+- 可选 `niuma-ui/brand-icons.css`：数据源 mark 色。不引入则 mark 为 currentColor。
 
 ## [2.0.0] - 2026-09-21
 

package/README.en.md

@@ -1,120 +1,3 @@
 # niuma-ui
 
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
-[![npm](https://img.shields.io/npm/v/niuma-ui.svg)](https://www.npmjs.com/package/niuma-ui)
-[![Vue 3](https://img.shields.io/badge/Vue-3.5+-42b883.svg)](https://vuejs.org/)
-[![Node](https://img.shields.io/badge/Node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
-
-English | [简体中文](./README.md)
-
-Vue 3 **workbench** design system: consistent `Rs*` components, `--rs-*` tokens, and optional editor / terminal wrappers.
-
-Built for ops consoles, database workbenches, and internal admin UIs. Marketing sites can use named imports. `npm install` pulls Monaco, CodeMirror, and xterm; named imports control the bundle.
-
-**Status:** [Apache License 2.0](./LICENSE) since v1.0.0. Compiled ESM on npm since v1.2.0. Current line is **2.0.0**. The `1.x` branch keeps the 1.3 line.
-
-## Features
-
-- **Design tokens** — light / dark via `data-rs-theme` and CSS variables; hosts override a brand layer
-- **Rs\* components** — Button, Form, Dialog, Table, Tree, Tabs, Anchor, and more
-- **Tooling** — Monaco, CodeMirror, xterm (import only on routes that need them)
-- **Accessibility** — [Reka UI](https://reka-ui.com/) underneath; apps depend only on `niuma-ui`
-- **Vite** — `import { RsButton } from 'niuma-ui'` is enough to bundle; `niumaUiHost` is local `pnpm dev` HMR only
-
-## Requirements
-
-| Item | Version |
-|------|---------|
-| Node.js | ≥ 20 |
-| Package manager | npm / pnpm / yarn (this repo develops with pnpm ≥ 9) |
-| Vue | ^3.5 (`peerDependency`) |
-| Bundler | Vite 5+ recommended; `RsMonacoEditor` needs Vite `?worker` |
-| Styles | `import 'niuma-ui/styles.css'` (standalone CSS, no Tailwind) |
-
-## Install
-
-```bash
-pnpm add niuma-ui
-# or: npm install niuma-ui / yarn add niuma-ui
-```
-
-Prefer a range such as `^2.0.0`. Pin **2.0.0** for a bit-for-bit install. Use `niuma-ui@1` for the 1.x line.
-
-Local `link`, Vite plugins, and bundle size: **[Consumer guide](./docs/consumers.en.md)** ([中文](./docs/consumers.md)).
-
-## Quick start
-
-```ts
-// main.ts
-import { createApp } from 'vue'
-import 'niuma-ui/styles.css'
-import App from './App.vue'
-
-createApp(App).mount('#app')
-```
-
-```vue
-<!-- App.vue -->
-<script setup lang="ts">
-import { RsConfigProvider, RsButton } from 'niuma-ui'
-</script>
-
-<template>
-  <RsConfigProvider theme="light" locale="en-US">
-    <RsButton variant="primary">Hello</RsButton>
-  </RsConfigProvider>
-</template>
-```
-
-Shipped locales: `zh-CN` | `en-US`.
-
-## Usage
-
-1. Named-import from the package root only. **Do not** depend on `reka-ui`. Do not `import *`.
-2. Import `niuma-ui/styles.css` once, then your brand CSS.
-3. Wrap the app with `RsConfigProvider` (theme, locale, default control size).
-4. Light sites re-export used symbols from their own `ui.ts`. Do not alias the package to this repo’s `src/index.ts`.
-
-Component APIs live on the docs site. The architecture contract is for maintainers: [components.en.md](./docs/components.en.md) ([中文](./docs/components.md)).
-
-## Docs
-
-- **Component site:** [https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/) (source: `site/`)
-- Local docs: `pnpm dev:site` → http://127.0.0.1:5181
-- `playground/` is internal smoke / visual regression only (`pnpm dev` → :5180). It is not usage documentation.
-
-| Doc | Audience |
-|-----|----------|
-| [docs/consumers.en.md](./docs/consumers.en.md) | People installing the library ([中文](./docs/consumers.md)) |
-| [docs/components.en.md](./docs/components.en.md) | People changing this repository ([中文](./docs/components.md)) |
-| [CONTRIBUTING.en.md](./CONTRIBUTING.en.md) | PRs, tests, releases ([中文](./CONTRIBUTING.md)) |
-| [CHANGELOG.md](./CHANGELOG.md) | Release notes |
-| [SECURITY.md](./SECURITY.md) | Private vulnerability reports |
-
-## Local development
-
-```bash
-pnpm install
-pnpm dev:site     # docs site
-pnpm test
-pnpm build        # library → dist/
-```
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full contributor flow.
-
-## Versioning
-
-[Semantic Versioning](https://semver.org/): compatible fixes are PATCH, compatible features MINOR, breaking API or token renames MAJOR.
-
-Stable publishes set npm dist-tag **`latest`**; prereleases use **`next`**. There is no Git tag named `latest`. Release steps live only in [CONTRIBUTING.md](./CONTRIBUTING.md).
-
-## License and credits
-
-[Apache License 2.0](./LICENSE). Attribution: [NOTICE](./NOTICE).
-
-Primitives: [Reka UI](https://reka-ui.com/). Icons: [Lucide](https://lucide.dev/). Editors: [Monaco](https://microsoft.github.io/monaco-editor/), [CodeMirror](https://codemirror.net/). Terminal: [xterm.js](https://xtermjs.org/).
-
-- Docs: https://blair-shang.github.io/niuma-ui/
-- npm: https://www.npmjs.com/package/niuma-ui
-- Source: https://github.com/Blair-Shang/niuma-ui
-- Issues: https://github.com/Blair-Shang/niuma-ui/issues
+The English README is [README.md](./README.md). 中文：[README.zh-CN.md](./README.zh-CN.md).

package/README.md

@@ -5,44 +5,45 @@
 [![Vue 3](https://img.shields.io/badge/Vue-3.5+-42b883.svg)](https://vuejs.org/)
 [![Node](https://img.shields.io/badge/Node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
 
-[English](./README.en.md) | 简体中文
+English | [简体中文](./README.zh-CN.md)
 
-Vue 3 **工作台**设计系统：一致的 `Rs*` 组件与 `--rs-*` Token，以及按需使用的编辑器 / 终端封装。
+Vue 3 **workbench** design system: consistent `Rs*` components, `--rs-*` tokens, and optional editor / terminal wrappers.
 
-适用于运维控制台、数据库工作台、内部后台。营销站也可以用具名导入。`npm install` 会带上 Monaco、CodeMirror、xterm，体积靠具名导入摇树。
+Built for ops consoles, database workbenches, and internal admin UIs. Marketing sites can use named imports. `npm install` pulls Monaco, CodeMirror, and xterm; named imports control the bundle.
 
-**状态：** [Apache License 2.0](./LICENSE)，自 v1.0.0 开源。自 v1.2.0 起 npm 发布编译 ESM。当前主线 **2.0.0**。1.x 见分支 `1.x`。
+**Status:** [Apache License 2.0](./LICENSE) since v1.0.0. Compiled ESM on npm since v1.2.0. Current line is **2.0.0**. The `1.x` branch keeps the 1.3 line.
 
-## 特性
+## Features
 
-- **Design Token**：明暗主题走 `data-rs-theme` 与 CSS 变量，宿主用品牌层覆盖
-- **Rs\* 组件**：Button、Form、Dialog、Table、Tree、Tabs、Anchor 等
-- **专业工具**：Monaco、CodeMirror、xterm（只在用到的路由引入）
-- **无障碍**：底层 [Reka UI](https://reka-ui.com/)，应用只依赖 `niuma-ui`
-- **Vite**：`import { RsButton } from 'niuma-ui'` 即可打包；`niumaUiHost` 仅本机 `pnpm dev` 联调源码
+- **Design tokens** — light / dark / system via `data-rs-theme` and CSS variables; hosts override a brand layer
+- **Rs\* components** — Button, Form, Dialog, Table, Tree, Tabs, Anchor, and more
+- **Tooling** — Monaco, CodeMirror, xterm (import only on routes that need them)
+- **Accessibility** — [Reka UI](https://reka-ui.com/) underneath; apps depend only on `niuma-ui`
+- **i18n** — omitted `locale` follows the host language (`zh*` → `zh-CN`, `en*` → `en-US`); unknown tags fall back to `zh-CN`. Extra languages: `registerRsLocale` ([guide](./docs/locales.en.md))
+- **Vite** — `import { RsButton } from 'niuma-ui'` is enough to bundle; `niumaUiHost` is local `pnpm dev` HMR only
 
-## 要求
+## Requirements
 
-| 项 | 版本 |
-|----|------|
+| Item | Version |
+|------|---------|
 | Node.js | ≥ 20 |
-| 包管理器 | npm / pnpm / yarn（本仓库开发用 pnpm ≥ 9） |
-| Vue | ^3.5（peerDependency） |
-| 打包器 | 推荐 Vite 5+；`RsMonacoEditor` 需要 Vite 处理 `?worker` |
-| 样式 | `import 'niuma-ui/styles.css'`（独立 CSS，不含 Tailwind） |
+| Package manager | npm / pnpm / yarn (this repo develops with pnpm ≥ 9) |
+| Vue | ^3.5 (`peerDependency`) |
+| Bundler | Vite 5+ recommended; `RsMonacoEditor` needs Vite `?worker` |
+| Styles | `import 'niuma-ui/styles.css'` (standalone CSS, no Tailwind) |
 
-## 安装
+## Install
 
 ```bash
 pnpm add niuma-ui
-# 或 npm install niuma-ui / yarn add niuma-ui
+# or: npm install niuma-ui / yarn add niuma-ui
 ```
 
-建议锁定兼容范围，例如 `^2.0.0`。精确复现请钉死 **2.0.0**。1.x 请用 `niuma-ui@1`。
+Prefer a range such as `^2.0.0`. Pin **2.0.0** for a bit-for-bit install. Use `niuma-ui@1` for the 1.x line.
 
-本地改源码、Vite 插件、包体积见 **[消费方指南](./docs/consumers.md)**（[English](./docs/consumers.en.md)）。
+Local `link`, Vite plugins, and bundle size: **[Consumer guide](./docs/consumers.en.md)** ([中文](./docs/consumers.md)).
 
-## 快速开始
+## Quick start
 
 ```ts
 // main.ts
@@ -60,67 +61,62 @@ import { RsConfigProvider, RsButton } from 'niuma-ui'
 </script>
 
 <template>
-  <RsConfigProvider theme="light" locale="zh-CN">
+  <RsConfigProvider theme="light" locale="en-US">
     <RsButton variant="primary">Hello</RsButton>
   </RsConfigProvider>
 </template>
 ```
 
-`locale` 现支持 `zh-CN` | `en-US`。
+Omit `locale` to follow the host language. Chinese systems stay on `zh-CN`. Community packs: [locales.en.md](./docs/locales.en.md).
 
-## 使用约定
+## Usage
 
-1. 只从包根具名导入：`import { RsButton } from 'niuma-ui'`。**不要**直接依赖 `reka-ui`，不要 `import *`。
-2. 样式只引一次 `niuma-ui/styles.css`，再加载你的品牌 CSS。
-3. 根节点包 `RsConfigProvider`（主题、语言、默认控件尺寸）。
-4. 轻量站点在自己的 `ui.ts` 里再导出用到的符号。不要把包名别名到本仓库的 `src/index.ts`。
+1. Named-import from the package root only. **Do not** depend on `reka-ui`. Do not `import *`.
+2. Import `niuma-ui/styles.css` once, then your brand CSS.
+3. Wrap the app with `RsConfigProvider` (theme, locale, default control size).
+4. Light sites re-export used symbols from their own `ui.ts`. Do not alias the package to this repo’s `src/index.ts`.
 
-组件 API 以文档站为准。仓库里的架构契约给维护者：[组件规范](./docs/components.md)（[English](./docs/components.en.md)）。
+Component APIs live on the docs site. The architecture contract is for maintainers: [components.en.md](./docs/components.en.md) ([中文](./docs/components.md)).
 
-## 文档
+## Docs
 
-- **组件文档（官网）**：[https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/)（源码 `site/`）
-- 本地文档站：`pnpm dev:site` → http://127.0.0.1:5181
-- `playground/` 仅内部冒烟与像素回归（`pnpm dev` → :5180），不提供对外用法
+- **Component site:** [https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/) (source: `site/`)
+- Local docs: `pnpm dev:site` → http://127.0.0.1:5181
+- `playground/` is internal smoke / visual regression only (`pnpm dev` → :5180). It is not usage documentation.
 
-| 文档 | 给谁看 |
-|------|--------|
-| [docs/consumers.md](./docs/consumers.md) | 把库装进产品的人（[English](./docs/consumers.en.md)） |
-| [docs/components.md](./docs/components.md) | 改本仓库的人（[English](./docs/components.en.md)） |
-| [CONTRIBUTING.md](./CONTRIBUTING.md) | PR、测试、发版（[English](./CONTRIBUTING.en.md)） |
-| [CHANGELOG.md](./CHANGELOG.md) | 版本记录 |
-| [SECURITY.md](./SECURITY.md) | 漏洞私下报告 |
+| Doc | Audience |
+|-----|----------|
+| [docs/consumers.en.md](./docs/consumers.en.md) | People installing the library ([中文](./docs/consumers.md)) |
+| [docs/locales.en.md](./docs/locales.en.md) | Registering extra languages ([中文](./docs/locales.md)) |
+| [docs/components.en.md](./docs/components.en.md) | People changing this repository ([中文](./docs/components.md)) |
+| [CONTRIBUTING.en.md](./CONTRIBUTING.en.md) | PRs, tests, releases ([中文](./CONTRIBUTING.md)) |
+| [CHANGELOG.md](./CHANGELOG.md) | Release notes |
+| [SECURITY.md](./SECURITY.md) | Private vulnerability reports |
 
-## 本地开发
+## Local development
 
 ```bash
 pnpm install
-pnpm dev:site     # 文档站
-pnpm test         # Vitest
-pnpm build        # 库 → dist/
+pnpm dev:site     # docs site
+pnpm test
+pnpm build        # library → dist/
 ```
 
-贡献步骤见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full contributor flow.
 
-## 版本
+## Versioning
 
-遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)：
+[Semantic Versioning](https://semver.org/): compatible fixes are PATCH, compatible features MINOR, breaking API or token renames MAJOR.
 
-| 变更 | 版本 |
-|------|------|
-| 兼容的缺陷 / 文档 | PATCH |
-| 兼容的新组件 / 能力 | MINOR |
-| 破坏性 API 或 Token 更名 | MAJOR |
+Stable publishes set npm dist-tag **`latest`**; prereleases use **`next`**. There is no Git tag named `latest`. Release steps live only in [CONTRIBUTING.md](./CONTRIBUTING.md).
 
-正式版更新 npm dist-tag **`latest`**，预发布走 **`next`**。没有名为 `latest` 的 Git 标签。发版流程只在 [CONTRIBUTING.md](./CONTRIBUTING.md)，不在本页。
+## License and credits
 
-## 许可与致谢
+[Apache License 2.0](./LICENSE). Attribution: [NOTICE](./NOTICE).
 
-[Apache License 2.0](./LICENSE)。版权与第三方声明见 [NOTICE](./NOTICE)。
+Primitives: [Reka UI](https://reka-ui.com/). Icons: [Lucide](https://lucide.dev/). Editors: [Monaco](https://microsoft.github.io/monaco-editor/), [CodeMirror](https://codemirror.net/). Terminal: [xterm.js](https://xtermjs.org/).
 
-交互原语：[Reka UI](https://reka-ui.com/)。图标：[Lucide](https://lucide.dev/)。编辑器：[Monaco](https://microsoft.github.io/monaco-editor/)、[CodeMirror](https://codemirror.net/)。终端：[xterm.js](https://xtermjs.org/)。
-
-- 文档站：https://blair-shang.github.io/niuma-ui/
-- npm：https://www.npmjs.com/package/niuma-ui
-- 源码：https://github.com/Blair-Shang/niuma-ui
-- Issues：https://github.com/Blair-Shang/niuma-ui/issues
+- Docs: https://blair-shang.github.io/niuma-ui/
+- npm: https://www.npmjs.com/package/niuma-ui
+- Source: https://github.com/Blair-Shang/niuma-ui
+- Issues: https://github.com/Blair-Shang/niuma-ui/issues

package/README.zh-CN.md

@@ -0,0 +1,128 @@
+# niuma-ui
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
+[![npm](https://img.shields.io/npm/v/niuma-ui.svg)](https://www.npmjs.com/package/niuma-ui)
+[![Vue 3](https://img.shields.io/badge/Vue-3.5+-42b883.svg)](https://vuejs.org/)
+[![Node](https://img.shields.io/badge/Node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
+
+[English](./README.md) | 简体中文
+
+Vue 3 **工作台**设计系统：一致的 `Rs*` 组件与 `--rs-*` Token，以及按需使用的编辑器 / 终端封装。
+
+适用于运维控制台、数据库工作台、内部后台。营销站也可以用具名导入。`npm install` 会带上 Monaco、CodeMirror、xterm，体积靠具名导入摇树。
+
+**状态：** [Apache License 2.0](./LICENSE)，自 v1.0.0 开源。自 v1.2.0 起 npm 发布编译 ESM。当前主线 **2.0.0**。1.x 见分支 `1.x`。
+
+## 特性
+
+- **Design Token**：明暗主题走 `data-rs-theme`（`light` / `dark` / `system`）与 CSS 变量，宿主用品牌层覆盖
+- **Rs\* 组件**：Button、Form、Dialog、Table、Tree、Tabs、Anchor 等
+- **专业工具**：Monaco、CodeMirror、xterm（只在用到的路由引入）
+- **无障碍**：底层 [Reka UI](https://reka-ui.com/)，应用只依赖 `niuma-ui`
+- **国际化**：未设 `locale` 时跟本机语言（中文系统就是 `zh-CN`）；认不出回退中文。第三方语言用 `registerRsLocale`，见 [docs/locales.md](./docs/locales.md)
+- **Vite**：`import { RsButton } from 'niuma-ui'` 即可打包；`niumaUiHost` 仅本机 `pnpm dev` 联调源码
+
+## 要求
+
+| 项 | 版本 |
+|----|------|
+| Node.js | ≥ 20 |
+| 包管理器 | npm / pnpm / yarn（本仓库开发用 pnpm ≥ 9） |
+| Vue | ^3.5（peerDependency） |
+| 打包器 | 推荐 Vite 5+；`RsMonacoEditor` 需要 Vite 处理 `?worker` |
+| 样式 | `import 'niuma-ui/styles.css'`（独立 CSS，不含 Tailwind） |
+
+## 安装
+
+```bash
+pnpm add niuma-ui
+# 或 npm install niuma-ui / yarn add niuma-ui
+```
+
+建议锁定兼容范围，例如 `^2.0.0`。精确复现请钉死 **2.0.0**。1.x 请用 `niuma-ui@1`。
+
+本地改源码、Vite 插件、包体积见 **[消费方指南](./docs/consumers.md)**（[English](./docs/consumers.en.md)）。
+
+## 快速开始
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import 'niuma-ui/styles.css'
+import App from './App.vue'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { RsConfigProvider, RsButton } from 'niuma-ui'
+</script>
+
+<template>
+  <RsConfigProvider theme="light" locale="zh-CN">
+    <RsButton variant="primary">你好</RsButton>
+  </RsConfigProvider>
+</template>
+```
+
+未设 `locale` 时跟本机语言：中文环境仍是中文。更多语言见 [社区语言包](./docs/locales.md)。
+
+## 使用约定
+
+1. 只从包根具名导入：`import { RsButton } from 'niuma-ui'`。**不要**直接依赖 `reka-ui`，不要 `import *`。
+2. 样式只引一次 `niuma-ui/styles.css`，再加载你的品牌 CSS。
+3. 根节点包 `RsConfigProvider`（主题、语言、默认控件尺寸）。
+4. 轻量站点在自己的 `ui.ts` 里再导出用到的符号。不要把包名别名到本仓库的 `src/index.ts`。
+
+组件 API 以文档站为准。仓库里的架构契约给维护者：[组件规范](./docs/components.md)（[English](./docs/components.en.md)）。
+
+## 文档
+
+- **组件文档（官网）**：[https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/)（源码 `site/`）
+- 本地文档站：`pnpm dev:site` → http://127.0.0.1:5181
+- `playground/` 仅内部冒烟与像素回归（`pnpm dev` → :5180），不提供对外用法
+
+| 文档 | 给谁看 |
+|------|--------|
+| [docs/consumers.md](./docs/consumers.md) | 把库装进产品的人（[English](./docs/consumers.en.md)） |
+| [docs/locales.md](./docs/locales.md) | 登记第三方语言（[English](./docs/locales.en.md)） |
+| [docs/components.md](./docs/components.md) | 改本仓库的人（[English](./docs/components.en.md)） |
+| [CONTRIBUTING.md](./CONTRIBUTING.md) | PR、测试、发版（[English](./CONTRIBUTING.en.md)） |
+| [CHANGELOG.md](./CHANGELOG.md) | 版本记录 |
+| [SECURITY.md](./SECURITY.md) | 漏洞私下报告 |
+
+## 本地开发
+
+```bash
+pnpm install
+pnpm dev:site     # 文档站
+pnpm test         # Vitest
+pnpm build        # 库 → dist/
+```
+
+贡献步骤见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
+
+## 版本
+
+遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)：
+
+| 变更 | 版本 |
+|------|------|
+| 兼容的缺陷 / 文档 | PATCH |
+| 兼容的新组件 / 能力 | MINOR |
+| 破坏性 API 或 Token 更名 | MAJOR |
+
+正式版更新 npm dist-tag **`latest`**，预发布走 **`next`**。没有名为 `latest` 的 Git 标签。发版流程只在 [CONTRIBUTING.md](./CONTRIBUTING.md)，不在本页。
+
+## 许可与致谢
+
+[Apache License 2.0](./LICENSE)。版权与第三方声明见 [NOTICE](./NOTICE)。
+
+交互原语：[Reka UI](https://reka-ui.com/)。图标：[Lucide](https://lucide.dev/)。编辑器：[Monaco](https://microsoft.github.io/monaco-editor/)、[CodeMirror](https://codemirror.net/)。终端：[xterm.js](https://xtermjs.org/)。
+
+- 文档站：https://blair-shang.github.io/niuma-ui/
+- npm：https://www.npmjs.com/package/niuma-ui
+- 源码：https://github.com/Blair-Shang/niuma-ui
+- Issues：https://github.com/Blair-Shang/niuma-ui/issues

package/dist/brand-icons.css

@@ -0,0 +1,40 @@
+/**
+ * 工作台品牌 mark 色（可选）。
+ * 用法：在 styles.css 之后 `import 'niuma-ui/brand-icons.css'`。
+ * 不引入时，mark 走 currentColor，与 Lucide 一致。
+ */
+
+:root:not([data-rs-theme]),
+[data-rs-theme='light'] {
+  --rs-icon-ftp-accent: #ea580c;
+  --rs-icon-ftp-on-accent: #ffffff;
+  --rs-icon-redis-accent: #dc382d;
+  --rs-icon-mongodb-accent: #47a248;
+  --rs-icon-vastbase-accent: #ff6f1a;
+  --rs-icon-mysql-accent: #4479a1;
+  --rs-icon-sqlite-accent: #003b57;
+  --rs-icon-dameng-accent: #0000d2;
+  --rs-icon-dameng-wave: #ec1b34;
+  --rs-icon-oracle-accent: #f80000;
+  --rs-icon-clickhouse-accent: #ffcc01;
+  --rs-icon-kingbase-accent: #c9151e;
+  --rs-icon-sqlserver-accent: #cc2927;
+  --rs-icon-postgres-accent: #336791;
+}
+
+[data-rs-theme='dark'] {
+  --rs-icon-ftp-accent: #fb923c;
+  --rs-icon-ftp-on-accent: #ffffff;
+  --rs-icon-redis-accent: #ff6f61;
+  --rs-icon-mongodb-accent: #5cb85c;
+  --rs-icon-vastbase-accent: #ff8a3d;
+  --rs-icon-mysql-accent: #5a9fd4;
+  --rs-icon-sqlite-accent: #5aafd4;
+  --rs-icon-dameng-accent: #4d4dff;
+  --rs-icon-dameng-wave: #ff4d63;
+  --rs-icon-oracle-accent: #ff4d4d;
+  --rs-icon-clickhouse-accent: #ffe066;
+  --rs-icon-kingbase-accent: #ff4d57;
+  --rs-icon-sqlserver-accent: #ff5a57;
+  --rs-icon-postgres-accent: #6a9ec4;
+}

package/dist/components/_shared/src/reka.d.ts

@@ -1,2 +1,2 @@
-export { AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AlertDialogTrigger, Primitive, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogClose, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DialogTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, SwitchRoot, SwitchThumb, PaginationEllipsis, PaginationFirst, PaginationLast, PaginationList, PaginationListItem, PaginationNext, PaginationPrev, PaginationRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SelectContent, SelectItem, SelectItemIndicator, SelectItemText, SelectPortal, SelectRoot, SelectTrigger, SelectValue, SelectViewport, StepperDescription, StepperIndicator, StepperItem, StepperRoot, StepperSeparator, StepperTitle, StepperTrigger, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, TreeItem, TreeRoot, TreeVirtualizer, useForwardExpose, useFilter, } from 'reka-ui';
+export { AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AlertDialogTrigger, Primitive, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ConfigProvider, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogClose, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DialogTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, SwitchRoot, SwitchThumb, PaginationEllipsis, PaginationFirst, PaginationLast, PaginationList, PaginationListItem, PaginationNext, PaginationPrev, PaginationRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SelectContent, SelectItem, SelectItemIndicator, SelectItemText, SelectPortal, SelectRoot, SelectTrigger, SelectValue, SelectViewport, StepperDescription, StepperIndicator, StepperItem, StepperRoot, StepperSeparator, StepperTitle, StepperTrigger, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, TreeItem, TreeRoot, TreeVirtualizer, useForwardExpose, useFilter, } from 'reka-ui';
 export type { AcceptableValue, PrimitiveProps, TooltipRootEmits, TooltipRootProps } from 'reka-ui';

package/dist/components/_shared/src/reka.js

@@ -1,2 +1,2 @@
-import { AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Primitive, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SwitchRoot, SwitchThumb, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, useFilter } from "reka-ui";
-export { AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Primitive, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SwitchRoot, SwitchThumb, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, useFilter };
+import { AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ConfigProvider, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Primitive, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SwitchRoot, SwitchThumb, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, useFilter } from "reka-ui";
+export { AlertDialogContent, AlertDialogDescription, AlertDialogOverlay, AlertDialogPortal, AlertDialogRoot, AlertDialogTitle, AvatarFallback, AvatarImage, AvatarRoot, CollapsibleContent, CollapsibleRoot, CollapsibleTrigger, ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxItemIndicator, ComboboxLabel, ComboboxPortal, ComboboxRoot, ComboboxTrigger, ComboboxViewport, ComboboxVirtualizer, ConfigProvider, ContextMenuContent, ContextMenuItem, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DialogContent, DialogDescription, DialogOverlay, DialogPortal, DialogRoot, DialogTitle, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuRoot, DropdownMenuTrigger, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Primitive, RadioGroupIndicator, RadioGroupItem, RadioGroupRoot, ScrollAreaCorner, ScrollAreaRoot, ScrollAreaScrollbar, ScrollAreaThumb, ScrollAreaViewport, SwitchRoot, SwitchThumb, TabsContent, TabsList, TabsRoot, TabsTrigger, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger, useFilter };

package/dist/components/_shared/src/resolve-radius.js

@@ -1,5 +1,5 @@
-import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
 import { RS_RADIUS_CSS } from "../../../theme/types.js";
+import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
 import { computed } from "vue";
 //#region src/components/_shared/src/resolve-radius.ts
 /**

package/dist/components/avatar/src/RsAvatar.impl.js

@@ -1,5 +1,5 @@
-import RsIcon_default from "../../icon/src/RsIcon.js";
 import { AvatarFallback, AvatarImage, AvatarRoot } from "../../_shared/src/reka.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
 import { getAvatarInitials } from "./avatar-utils.js";
 import { computed, createBlock, createCommentVNode, createElementBlock, createVNode, defineComponent, normalizeClass, openBlock, renderSlot, toDisplayString, unref, withCtx } from "vue";
 //#region src/components/avatar/src/RsAvatar.vue?vue&type=script&setup=true&lang.ts

package/dist/components/button/src/RsButton.impl.js

@@ -1,5 +1,5 @@
-import RsIcon_default from "../../icon/src/RsIcon.js";
 import { RS_COMPONENT_SIZE_ICON_PX } from "../../../theme/types.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
 import { resolveRsButtonTone, resolveRsButtonVariant } from "./button-utils.js";
 import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
 import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";

package/dist/components/card/src/RsCard.impl.js

@@ -1,5 +1,5 @@
-import { rsRadiusCss } from "../../_shared/src/resolve-radius.js";
 import { Primitive } from "../../_shared/src/reka.js";
+import { rsRadiusCss } from "../../_shared/src/resolve-radius.js";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, renderSlot, toDisplayString, unref, useSlots, withCtx } from "vue";
 //#region src/components/card/src/RsCard.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = {