niuma-ui 2.0.1 → 2.0.3

package/CHANGELOG.md

@@ -6,6 +6,44 @@
 
 ## [Unreleased]
 
+## [2.0.3] - 2026-09-21
+
+### 新增
+
+- 文档站接入 vue-i18n（`site/locales`）。顶栏切语言同步 `RsConfigProvider.locale` 与 vue-i18n，并记住上次选择。只用于 site，不进组件库依赖。
+- `RsBadge`：补 `name` 与公开类型 `RsBadgeVariant`。只写 `variant` + 默认插槽时仍是原来的状态芯片。可选 `count` / `max` / `dot` / `showZero`：有插槽时为角标，无插槽时只渲染数字或点。文档站按 site README 补全 events / methods / tokens / FAQ。
+
+### 变更
+
+- 文档站演示与壳层不再用 `isEn` 二分。文案按 locale 表选取（`useSiteDemo` / `pickSitePair`），缺语言回退 en-US → zh-CN；顶栏语言按 `SITE_LOCALES` 轮换。主题仍走 `resolvedTheme` / `data-rs-theme` / token。
+- `RsTag`：补 `name`；关闭钮改用 `RsButton`（仍是 `.rs-tag__close`，props / `close` 语义与原来相同）。文档站按 site README 补全 events / methods / tokens（中英）。
+- `RsDivider`：补 `name` 与公开类型 `RsDividerOrientation`。仍是 `div[role=separator]`，`orientation` / `dashed` / 默认插槽语义不变。文档站按 site README 补全 events / methods / tokens / FAQ（中英）。
+- 文档站基础组 Avatar / Card / Container / Scrollbar：按 site README 补全中英演示、events / methods / tokens / FAQ。Scrollbar 演示可点 `scrollTop` / `getViewport`。
+- `RsIcon`：补 `name`；尺寸档位与 `RS_COMPONENT_SIZE_ICON_PX` 对齐（lg 现为 18）；抽 `icon-utils`；`spin` 尊重减少动态。文档站 Icon 用法与 Button 对齐（中英）。
+- 文档站基础组：Button 补 `iconSize` / 原生 `click` / 事件演示；Badge–Scrollbar 按源码补全 props、事件、插槽、方法（中英）。
+- `RsLink`：去掉 Reka `Primitive`，改为原生 `<a>`；补 `name`、`tone`、`icon`；样式改 scoped，并尊重减少动态。默认 `inline`（有图标才 `inline-flex`）。文档站按 site README 补 events / methods / tokens、跟正文与可感知 click。公开类型 `RsLinkTone` / `RsLinkUnderline`；helper 保持内部。不设 size / theme prop。
+
+### 修复
+
+- `RsButton`：补 `name`，loading 时拦住点击；内置 tip 用自研定位，不再提 Reka。图标在按钮内为装饰，可访问名称只走 `aria-label`。
+- `RsButton` 内置 tip 回到 `calc(var(--rs-z-modal) + 2)`，与 `RsTooltip` / Dialog 内浮层同一档，避免在对话框里被盖住。
+- `RsButton` 幽灵：未传 `bordered` 时不再被 Vue 收成 false（与 text 撞车）；hover 改为 `--rs-surface-hover` 实底，语义色再叠 14% 色相。
+
+## [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
 
 ### 变更

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 / 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`
-- **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`（`light` / `dark` / `system`）与 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,64 @@ 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
+- **How to write demos and APIs:** [site/README.en.md](./site/README.en.md) ([中文](./site/README.md)) — catalog must list props / events / slots / methods; demos are bilingual and events must be visible
+- `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)) |
+| [site/README.en.md](./site/README.en.md) | How to write site demos and API tables ([中文](./site/README.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,130 @@
+# 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
+- **演示与 API 写法**：[site/README.md](./site/README.md)（[English](./site/README.en.md)）— catalog 必须写清 props / events / slots / methods，演示要中英对照且事件可感知
+- `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)） |
+| [site/README.md](./site/README.md) | 文档站演示与 API 表怎么写（[English](./site/README.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/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/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/badge/index.d.ts

@@ -1 +1,2 @@
 export { default as RsBadge } from './src/RsBadge.js';
+export type { RsBadgeVariant } from './src/badge-utils';

package/dist/components/badge/src/RsBadge.css

@@ -1,41 +1,94 @@
 
-.rs-badge[data-v-90af0872] {
+.rs-badge[data-v-f91a65a7] {
+  --rs-badge-padding-y: 0.125rem;
+  --rs-badge-padding-x: 0.625rem;
+  --rs-badge-dot-size: var(--rs-space-sm);
+  --rs-badge-count-min: 1.125rem;
+  --rs-badge-ring: var(--rs-surface);
   display: inline-flex;
   align-items: center;
-  padding: 0.125rem 0.625rem;
+  justify-content: center;
+  box-sizing: border-box;
+  padding: var(--rs-badge-padding-y) var(--rs-badge-padding-x);
   border-radius: var(--rs-radius-full);
   font-size: var(--rs-font-size-xs);
   font-weight: var(--rs-font-weight-medium);
   line-height: var(--rs-line-height-tight);
   letter-spacing: 0.02em;
+  white-space: nowrap;
+  vertical-align: middle;
 }
-.rs-badge--default[data-v-90af0872] {
+.rs-badge-wrap[data-v-f91a65a7] {
+  position: relative;
+  display: inline-flex;
+  vertical-align: middle;
+}
+.rs-badge-wrap .rs-badge--mark[data-v-f91a65a7] {
+  position: absolute;
+  inset-block-start: 0;
+  inset-inline-end: 0;
+  z-index: 1;
+  transform: translate(50%, -50%);
+  box-shadow: 0 0 0 2px var(--rs-badge-ring);
+}
+:dir(rtl) .rs-badge-wrap .rs-badge--mark[data-v-f91a65a7] {
+  transform: translate(-50%, -50%);
+}
+.rs-badge--mark[data-v-f91a65a7]:not(.rs-badge--dot) {
+  min-width: var(--rs-badge-count-min);
+  min-height: var(--rs-badge-count-min);
+  padding: 0 0.375rem;
+  letter-spacing: 0;
+  line-height: 1;
+}
+.rs-badge--dot[data-v-f91a65a7] {
+  width: var(--rs-badge-dot-size);
+  height: var(--rs-badge-dot-size);
+  min-width: var(--rs-badge-dot-size);
+  padding: 0;
+  border-radius: var(--rs-radius-full);
+}
+.rs-badge--default[data-v-f91a65a7] {
   background: var(--rs-surface-hover);
   color: var(--rs-text);
   border: 1px solid var(--rs-border);
 }
-.rs-badge--primary[data-v-90af0872] {
+.rs-badge--primary[data-v-f91a65a7] {
   background: var(--rs-primary-container);
   color: var(--rs-on-primary-container);
   border: 1px solid color-mix(in srgb, var(--rs-primary) 40%, transparent);
 }
-.rs-badge--success[data-v-90af0872] {
+.rs-badge--success[data-v-f91a65a7] {
   background: var(--rs-success-container);
   color: var(--rs-on-success-container);
   border: 1px solid color-mix(in srgb, var(--rs-success) 40%, transparent);
 }
-.rs-badge--warning[data-v-90af0872] {
+.rs-badge--warning[data-v-f91a65a7] {
   background: var(--rs-warning-container);
   color: var(--rs-on-warning-container);
   border: 1px solid color-mix(in srgb, var(--rs-warning) 40%, transparent);
 }
-.rs-badge--danger[data-v-90af0872] {
+.rs-badge--danger[data-v-f91a65a7] {
   background: var(--rs-danger-container);
   color: var(--rs-on-danger-container);
   border: 1px solid color-mix(in srgb, var(--rs-danger) 40%, transparent);
 }
-.rs-badge--info[data-v-90af0872] {
+.rs-badge--info[data-v-f91a65a7] {
   background: var(--rs-info-container);
   color: var(--rs-on-info-container);
   border: 1px solid color-mix(in srgb, var(--rs-info) 40%, transparent);
 }
+.rs-badge--dot.rs-badge--default[data-v-f91a65a7],
+.rs-badge--dot.rs-badge--primary[data-v-f91a65a7],
+.rs-badge--dot.rs-badge--success[data-v-f91a65a7],
+.rs-badge--dot.rs-badge--warning[data-v-f91a65a7],
+.rs-badge--dot.rs-badge--danger[data-v-f91a65a7],
+.rs-badge--dot.rs-badge--info[data-v-f91a65a7] {
+  color: transparent;
+}
+@media (forced-colors: active) {
+.rs-badge[data-v-f91a65a7] {
+    border: 1px solid CanvasText;
+    forced-color-adjust: none;
+}
+}