niuma-ui 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# 变更日志
+
+本文件记录项目的重要变更。
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
+
+## [Unreleased]
+
+## [1.0.0] - 2026-08-11
+
+### 新增
+
+- 以 **Apache License 2.0** 开源发布 `niuma-ui`（npm 包名，无 scope）。
+- 公开文档：中文 / 英文 README、贡献指南、行为准则、安全策略、组件清单与消费方指南。
+- GitHub Issue / PR 模板、CI（`pnpm test`）与 Playground Pages 部署工作流。
+- Playground 升级为对外组件演示门面（分组导航、搜索、首页快速开始、示例代码与 API 简表）。
+
+### 变更
+
+- 包名由 `@niuma/ui` 统一为 **`niuma-ui`**；公开 SemVer 基线为 **1.0.0**。
+- 包不再标记为 `private`；消费方通过 npm / git tag / link 安装。
+- `RsTable` 排序相关测试改为点击 `.rs-table__sort` 图标，与组件交互一致。
+
+### 说明
+
+- 1.0 之前的私有 tag（如 `v0.1.0`）仅作历史记录；新接入请依赖 `v1.0.0` 及之后版本。
+
+[Unreleased]: https://github.com/Blair-Shang/niuma-ui/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,25 @@
+NiuMa UI
+Copyright 2026 Blair-Shang and NiuMa UI contributors
+
+This product includes software developed at NiuMa UI
+(https://github.com/Blair-Shang/niuma-ui).
+
+Licensed under the Apache License, Version 2.0.
+See the LICENSE file for the full license text.
+
+----
+
+第三方依赖按其各自许可证分发，常见依赖如下（请以 lockfile 中的实际版本为准）：
+
+| 项目 | 常见许可证 | 用途 |
+|------|------------|------|
+| Vue | MIT | peer 框架 |
+| Reka UI | MIT | 无障碍交互原语 |
+| Lucide (lucide-vue-next) | ISC | 默认图标 |
+| Monaco Editor | MIT | RsMonacoEditor |
+| CodeMirror | MIT | RsCodeEditor |
+| xterm.js | MIT | RsTerminal |
+| marked | MIT | Markdown 解析 |
+| DOMPurify | Apache-2.0 / MPL-2.0 | HTML 消毒 |
+| dayjs | MIT | 日期辅助 |
+| vue-sonner | MIT | Toast 原语 |

package/README.en.md

@@ -0,0 +1,99 @@
+# niuma-ui
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
+[![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/)
+[![pnpm](https://img.shields.io/badge/pnpm-%3E%3D9-yellow.svg)](https://pnpm.io/)
+
+English | [简体中文](./README.md)
+
+Vue 3 design system and component library. Ships consistent `Rs*` components, `--rs-*` design tokens, and optional desktop-tooling editors / terminal wrappers.
+
+Use it for ops consoles, database workbenches, internal admin UIs, and product sites that need one visual and interaction language.
+
+**Status:** open source from **v1.0.0** under [Apache License 2.0](./LICENSE).
+
+## Features
+
+- **Design tokens** — light / dark via `data-rs-theme` and CSS variables; hosts can override a brand layer
+- **Rs\* components** — Button, Form, Dialog, Table, Tree, Tabs, and more
+- **Tooling-oriented** — Monaco, CodeMirror, xterm wrappers (import carefully in light apps)
+- **Accessible primitives** — built on [Reka UI](https://reka-ui.com/); apps only consume `niuma-ui`
+- **Vite-friendly** — source-linked HMR; optional host Vite plugins
+
+## Requirements
+
+| Item | Version |
+|------|---------|
+| Node.js | ≥ 20 |
+| Package manager | pnpm ≥ 9 (recommended) |
+| Vue | ^3.5 (`peerDependency`) |
+| Bundler | Vite 5+ / 8 (recommended) |
+
+## Install
+
+```bash
+pnpm add niuma-ui
+```
+
+Until published to npm, install from a GitHub tag:
+
+```bash
+pnpm add git+https://github.com/Blair-Shang/niuma-ui.git#v1.0.0
+```
+
+Local link and Vite details: **[Consumer guide](./docs/consumers.md)** (Chinese).
+
+## Quick start
+
+```ts
+import { createApp } from 'vue'
+import { RsConfigProvider, RsButton } from 'niuma-ui'
+import 'niuma-ui/styles.css'
+import App from './App.vue'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<script setup lang="ts">
+import { RsConfigProvider, RsButton } from 'niuma-ui'
+</script>
+
+<template>
+  <RsConfigProvider theme="light" locale="zh-CN">
+    <RsButton variant="primary">Hello</RsButton>
+  </RsConfigProvider>
+</template>
+```
+
+## Usage conventions
+
+1. Apps import only from `niuma-ui` — **do not** depend on `reka-ui` directly.
+2. Styles: `import 'niuma-ui/styles.css'`.
+3. Wrap the app with `RsConfigProvider`.
+4. Light apps should avoid pulling Monaco / Terminal / heavy table editors via the main barrel.
+
+Component catalog: **[docs/components.md](./docs/components.md)**.
+
+## Live demos
+
+- **Component site**: [https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/) (GitHub Pages, deploys from `main`)
+- Local: `pnpm dev` → http://localhost:5180
+
+## Local development
+
+```bash
+pnpm install
+pnpm dev
+pnpm build:playground
+pnpm test
+```
+
+## Versioning
+
+Semantic Versioning. Pin git **tags** (or exact npm versions). See [CHANGELOG.md](./CHANGELOG.md).
+
+## License
+
+[Apache License 2.0](./LICENSE). See [NOTICE](./NOTICE) for attribution.

package/README.md

@@ -0,0 +1,161 @@
+# niuma-ui
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
+[![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/)
+[![pnpm](https://img.shields.io/badge/pnpm-%3E%3D9-yellow.svg)](https://pnpm.io/)
+
+[English](./README.en.md) | 简体中文
+
+Vue 3 设计系统与组件库。提供一致的 `Rs*` 组件、`--rs-*` 设计 token，以及面向桌面工具场景的编辑器 / 终端能力。
+
+适用于运维控制台、数据库工作台、内部后台与产品官网等需要统一视觉与交互语言的 Vue 应用。
+
+**状态：** 自 **v1.0.0** 起按 [Apache License 2.0](./LICENSE) 开源。
+
+## 特性
+
+- **设计 token**：明暗主题通过 `data-rs-theme` 与 CSS 变量驱动，业务侧可用品牌层覆盖
+- **Rs\* 组件**：Button、Form、Dialog、Table、Tree、Tabs 等完整交互控件
+- **专业工具向**：Monaco、CodeMirror、xterm 等编辑器 / 终端封装（按需引入）
+- **无障碍与焦点**：底层基于 [Reka UI](https://reka-ui.com/)，业务层只消费 `niuma-ui`
+- **Vite 友好**：源码直连联调；可选导出消费方 Vite 插件
+
+## 要求
+
+| 项 | 版本 |
+|----|------|
+| Node.js | ≥ 20 |
+| 包管理器 | pnpm ≥ 9（推荐） |
+| Vue | ^3.5（peerDependency） |
+| 构建 | Vite 5+ / 8（推荐） |
+
+## 安装
+
+```bash
+pnpm add niuma-ui
+```
+
+在发布到 npm 之前，可使用 GitHub tag：
+
+```bash
+pnpm add git+https://github.com/Blair-Shang/niuma-ui.git#v1.0.0
+```
+
+本地 link、Vite 配置、包体积建议见 **[消费方指南](./docs/consumers.md)**。
+
+## 快速开始
+
+```ts
+import { createApp } from 'vue'
+import { RsConfigProvider, RsButton } from 'niuma-ui'
+import 'niuma-ui/styles.css'
+import App from './App.vue'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<script setup lang="ts">
+import { RsConfigProvider, RsButton } from 'niuma-ui'
+</script>
+
+<template>
+  <RsConfigProvider theme="light" locale="zh-CN">
+    <RsButton variant="primary">Hello</RsButton>
+  </RsConfigProvider>
+</template>
+```
+
+## 使用约定
+
+1. 应用与业务模块只允许 `import { … } from 'niuma-ui'`，**禁止**直接依赖 `reka-ui`。
+2. 样式入口：`import 'niuma-ui/styles.css'`（须在业务品牌 CSS 之前或按文档顺序加载）。
+3. 根节点使用 `RsConfigProvider` 提供主题、语言与默认控件尺寸。
+4. 营销站 / 轻量应用避免从主入口导入 Monaco、Terminal、重型 Table 编辑能力；按文件路径或自建薄封装按需引用（见消费方指南）。
+
+组件清单与新增组件规范见 **[组件说明](./docs/components.md)**。
+
+## 在线演示
+
+- **组件演示站**：[https://blair-shang.github.io/niuma-ui/](https://blair-shang.github.io/niuma-ui/)（随 `main` 由 [pages.yml](./.github/workflows/pages.yml) 部署）
+- 首次启用：仓库 **Settings → Pages → Source** 选 **GitHub Actions**
+- 本地：`pnpm dev` → http://localhost:5180
+
+## 本地开发
+
+```bash
+pnpm install
+pnpm dev                 # 组件演示，默认 http://localhost:5180
+pnpm build:playground    # 构建演示站静态资源 → playground-dist/
+pnpm test                # Vitest
+pnpm test:watch
+```
+
+| 路径 | 说明 |
+|------|------|
+| `src/components/` | `Rs*` 组件实现 |
+| `src/styles.css` | Token 与全局样式 |
+| `src/theme/` | 主题应用与品牌覆盖示例 |
+| `src/monaco/` | Monaco 语言与 Worker 辅助 |
+| `playground/` | 组件演示应用（对外演示门面） |
+| `vite-plugins/` | 可供宿主工程复用的 Vite 插件 |
+| `docs/` | 接入与组件类文档 |
+
+## 版本与发版
+
+遵循 [Semantic Versioning](https://semver.org/)：
+
+| 变更类型 | 版本 |
+|----------|------|
+| 缺陷修复、文档（兼容） | PATCH `1.0.x` |
+| 新增组件 / 能力（兼容） | MINOR `1.x.0` |
+| 破坏性 API 或 token 更名 | MAJOR `x.0.0` |
+
+```bash
+# 1. 更新 package.json 的 version
+# 2. 更新 CHANGELOG.md
+# 3. 提交并推送 main 后打 tag（推送 tag 会触发 Publish 流水线自动 pnpm publish）
+git tag v1.0.1
+git push origin v1.0.1
+```
+
+需在仓库 Settings → Secrets 配置 **`NPM_TOKEN`**：
+
+1. 打开 https://www.npmjs.com/settings/shangjian/tokens → **Generate New Token** → **Granular Access Token**
+2. Permissions：对包 `niuma-ui` 勾选 **Read and write**
+3. 务必开启 **Bypass two-factor authentication**（否则 CI 会报 `EOTP`）
+4. 把 token 填进 GitHub Secret 名 `NPM_TOKEN`
+
+不要配置 `NPM_OTP`：一次性验证码约 30 秒过期，无法用于自动发版。
+
+也可在 Actions 里手动运行 **Publish** 工作流。
+
+消费方应锁定 **tag**（或 npm 精确版本），避免长期跟踪 `main`。
+
+详见 [CHANGELOG.md](./CHANGELOG.md)。
+
+## 相关文档
+
+| 文档 | 内容 |
+|------|------|
+| [docs/consumers.md](./docs/consumers.md) | 宿主工程接入、联调、CI、体积与插件 |
+| [docs/components.md](./docs/components.md) | 公开组件清单与设计约定 |
+| [CONTRIBUTING.md](./CONTRIBUTING.md) | 贡献指南 |
+| [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) | 行为准则 |
+| [SECURITY.md](./SECURITY.md) | 安全漏洞报告 |
+| [NOTICE](./NOTICE) | Apache 版权与第三方声明 |
+| [README.en.md](./README.en.md) | English README |
+| [src/theme/brand.example.css](./src/theme/brand.example.css) | 品牌色覆盖示例 |
+
+## 仓库信息
+
+- **包名**：`niuma-ui`
+- **源码**：https://github.com/Blair-Shang/niuma-ui
+- **Issues**：https://github.com/Blair-Shang/niuma-ui/issues
+- **开源基线**：`v1.0.0`
+- **许可**：[Apache License 2.0](./LICENSE)
+
+## 致谢
+
+交互原语基于 [Reka UI](https://reka-ui.com/)；图标默认集成 [Lucide](https://lucide.dev/)；代码编辑能力基于 [Monaco Editor](https://microsoft.github.io/monaco-editor/) 与 [CodeMirror](https://codemirror.net/)；终端基于 [xterm.js](https://xtermjs.org/)。

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "niuma-ui",
+  "version": "1.0.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "description": "Vue 3 设计系统与 Rs* 组件库（--rs-* token）",
+  "keywords": [
+    "vue",
+    "vue3",
+    "ui",
+    "components",
+    "design-system",
+    "reka-ui",
+    "niuma"
+  ],
+  "author": "Blair-Shang",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blair-Shang/niuma-ui.git"
+  },
+  "homepage": "https://github.com/Blair-Shang/niuma-ui#readme",
+  "bugs": {
+    "url": "https://github.com/Blair-Shang/niuma-ui/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./styles.css": "./src/styles.css",
+    "./theme/brand.example.css": "./src/theme/brand.example.css",
+    "./vite-plugins/monaco-zh-nls": "./vite-plugins/monaco-zh-nls.ts",
+    "./vite-plugins/silence-antlr-parse-console": "./vite-plugins/silence-antlr-parse-console.ts",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "vite-plugins",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "vue": "^3.5.39"
+  },
+  "dependencies": {
+    "@codemirror/commands": "^6.10.2",
+    "@codemirror/lang-cpp": "^6.0.3",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-go": "^6.0.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-java": "^6.0.2",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/lang-rust": "^6.0.2",
+    "@codemirror/lang-sql": "^6.10.0",
+    "@codemirror/lang-xml": "^6.1.0",
+    "@codemirror/lang-yaml": "^6.1.3",
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/legacy-modes": "^6.5.3",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.43.1",
+    "@xterm/addon-fit": "^0.11.0",
+    "codemirror": "^6.0.2",
+    "dayjs": "^1.11.21",
+    "dompurify": "^3.4.13",
+    "lucide-vue-next": "^1.0.0",
+    "marked": "^18.0.9",
+    "monaco-editor": "^0.55.1",
+    "monaco-sql-languages": "^1.2.0",
+    "reka-ui": "^2.9.10",
+    "vue-sonner": "^2.0.9",
+    "xterm": "^5.3.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.3.2",
+    "@types/node": "^26.1.1",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "@vue/test-utils": "^2.4.11",
+    "jsdom": "^29.1.1",
+    "tailwindcss": "^4.3.2",
+    "typescript": "^5.9.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9",
+    "vue": "^3.5.39",
+    "vue-router": "^5.1.0"
+  },
+  "engines": {
+    "node": ">=20",
+    "pnpm": ">=9"
+  },
+  "scripts": {
+    "dev": "vite --config playground/vite.config.ts",
+    "build:playground": "vite build --config playground/vite.config.ts",
+    "preview:playground": "vite preview --config playground/vite.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/__tests__/RsBadge.spec.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest'
+import { mount } from '@vue/test-utils'
+import RsBadge from '../components/RsBadge.vue'
+
+const variants = ['default', 'primary', 'success', 'warning', 'danger', 'info'] as const
+
+describe('RsBadge', () => {
+  it('renders slot text', () => {
+    const wrapper = mount(RsBadge, { slots: { default: 'Open' } })
+    expect(wrapper.text()).toBe('Open')
+  })
+
+  it('renders as span with base class', () => {
+    const wrapper = mount(RsBadge, { slots: { default: 'Tag' } })
+    expect(wrapper.element.tagName).toBe('SPAN')
+    expect(wrapper.classes()).toContain('rs-badge')
+  })
+
+  it('uses default variant when variant is omitted', () => {
+    const wrapper = mount(RsBadge, { slots: { default: '默认' } })
+    expect(wrapper.classes()).toContain('rs-badge--default')
+  })
+
+  it.each(variants)('applies %s variant class', (variant) => {
+    const wrapper = mount(RsBadge, {
+      props: { variant },
+      slots: { default: variant },
+    })
+    expect(wrapper.classes()).toContain(`rs-badge--${variant}`)
+  })
+
+  it('renders longer slot content', () => {
+    const wrapper = mount(RsBadge, {
+      props: { variant: 'warning' },
+      slots: { default: '配额已用尽' },
+    })
+    expect(wrapper.text()).toBe('配额已用尽')
+    expect(wrapper.classes()).toContain('rs-badge--warning')
+  })
+})