morya-ui 0.3.2 → 0.3.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Morya UI contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Morya UI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,150 +1,150 @@
-<p align="center">
-  <a href="https://morya-space.github.io/morya-ui/">
-    <img src="./assets/logo.svg" alt="Morya UI" width="96" height="96" />
-  </a>
-</p>
-
-<h1 align="center">Morya UI</h1>
-
-<p align="center">
-  A Vue 3 component library with design tokens, light/dark themes, and interactive docs.
-</p>
-
-<p align="center">
-  English | <a href="./README.zh-CN.md">中文</a>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/v/morya-ui?style=flat-square" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/dm/morya-ui?style=flat-square" alt="npm downloads" /></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/github/license/morya-space/morya-ui?style=flat-square" alt="license" /></a>
-  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3-42b883?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3" /></a>
-  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.x-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
-</p>
-
-<p align="center">
-  <a href="https://morya-space.github.io/morya-ui/"><b>Documentation</b></a>
-  ·
-  <a href="https://morya-space.github.io/morya-ui/components">Components</a>
-  ·
-  <a href="https://github.com/morya-space/morya-ui/issues">Issues</a>
-  ·
-  <a href="./CHANGELOG.md">Changelog</a>
-</p>
-
----
-
-## Introduction
-
-**Morya UI** (`morya-ui`) is an open-source Vue 3 component library for building modern web applications. It ships **90+ components**, a token-based theme system, built-in i18n, and a documentation site with live previews.
-
-Whether you are starting a new admin dashboard, SaaS product, or internal tool, you get consistent forms, overlays, data display, and feedback primitives out of the box.
-
-## Features
-
-### Complete
-
-90+ components covering basics, forms, navigation, data display, layout, and feedback — all tree-shakeable via ESM subpath imports.
-
-### Theme-ready
-
-Light and dark modes powered by `--m-*` CSS variables. Switch themes with `useTheme`, tune density and motion with `useDensity` / `useMotion`, and override per subtree via `MConfigProvider`.
-
-### TypeScript-first
-
-Written in Vue 3 Composition API + TypeScript. Props, emits, and locale messages are fully typed.
-
-### Flexible consumption
-
-Use full registration, named imports, on-demand subpaths, or `MoryaUIResolver` with `unplugin-vue-components` — pick one style per app.
-
-### Docs as preview
-
-Every component includes Markdown docs with interactive `vue preview` blocks. Browse them online or run the docs site locally.
-
-### SSR & meta-frameworks
-
-Works with **Nuxt 3**, **Astro + Vue**, **Vite SSR**, and similar setups. Includes the [`@morya-ui/nuxt`](./packages/nuxt) module — see the [SSR guide](https://morya-space.github.io/morya-ui/docs/ssr).
-
-## Documentation
-
-**https://morya-space.github.io/morya-ui/**
-
-| Section | Link |
-| --- | --- |
-| Quick start | [Guide](https://morya-space.github.io/morya-ui/docs/quick-start) |
-| Theme | [Theme](https://morya-space.github.io/morya-ui/docs/theme) |
-| Configuration | [Config](https://morya-space.github.io/morya-ui/docs/config) |
-| SSR | [Nuxt / Astro / Vite SSR](https://morya-space.github.io/morya-ui/docs/ssr) |
-| Components | [Catalog](https://morya-space.github.io/morya-ui/components) |
-| Changelog | [Releases](https://morya-space.github.io/morya-ui/changelog) |
-
-## Install
-
-Requires **Vue 3** (3.5+ recommended) and a bundler that resolves package `exports` (Vite, webpack 5+, etc.).
-
-```bash
-pnpm add morya-ui
-# npm i morya-ui
-# yarn add morya-ui
-```
-
-## Quick start
-
-Register all components and import the full stylesheet:
-
-```ts
-import MoryaUI from 'morya-ui'
-import { createApp } from 'vue'
-import App from './App.vue'
-import 'morya-ui/styles.css'
-
-createApp(App).use(MoryaUI).mount('#app')
-```
-
-On-demand import (styles included automatically):
-
-```ts
-import { MButton } from 'morya-ui/button'
-import { MInput } from 'morya-ui/input'
-```
-
-For global defaults (locale, size, overlay mount point):
-
-```ts
-import { createMoryaUI, enUS } from 'morya-ui'
-
-createApp(App).use(createMoryaUI({ locale: enUS })).mount('#app')
-```
-
-See the [Quick start guide](https://morya-space.github.io/morya-ui/docs/quick-start) for full import modes, Vite resolver setup, and theme APIs.
-
-## Ecosystem
-
-| Package | Description |
-| --- | --- |
-| [`morya-ui`](https://www.npmjs.com/package/morya-ui) | Components, styles, theme & locale helpers |
-| [`@morya-ui/nuxt`](./packages/nuxt) | Nuxt 3 module (styles, transpile, overlay context) |
-| [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) | Optional MCP server for AI-assisted doc lookup |
-| [`@morya-ui/setup`](https://www.npmjs.com/package/@morya-ui/setup) | One-shot consumer setup: library, styles, Agent skill, Cursor rules, and MCP |
-
-## Contributing
-
-We welcome issues and pull requests. Please read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes.
-
-For maintainers: [Development guide](./docs/DEVELOPMENT.md) · [Release scripts](./scripts/README.md)
-
-## Local development
-
-```bash
-pnpm install
-pnpm dev              # docs site → http://localhost:5182
-pnpm build            # library → dist/
-pnpm build:docs:pages # GitHub Pages build
-pnpm test
-pnpm typecheck
-```
-
-## License
-
-[MIT](./LICENSE) © Morya UI contributors
+<p align="center">
+  <a href="https://morya-space.github.io/morya-ui/">
+    <img src="./assets/logo.svg" alt="Morya UI" width="96" height="96" />
+  </a>
+</p>
+
+<h1 align="center">Morya UI</h1>
+
+<p align="center">
+  A Vue 3 component library with design tokens, light/dark themes, and interactive docs.
+</p>
+
+<p align="center">
+  English | <a href="./README.zh-CN.md">中文</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/v/morya-ui?style=flat-square" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/dm/morya-ui?style=flat-square" alt="npm downloads" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/github/license/morya-space/morya-ui?style=flat-square" alt="license" /></a>
+  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3-42b883?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3" /></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.x-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
+</p>
+
+<p align="center">
+  <a href="https://morya-space.github.io/morya-ui/"><b>Documentation</b></a>
+  ·
+  <a href="https://morya-space.github.io/morya-ui/components">Components</a>
+  ·
+  <a href="https://github.com/morya-space/morya-ui/issues">Issues</a>
+  ·
+  <a href="./CHANGELOG.md">Changelog</a>
+</p>
+
+---
+
+## Introduction
+
+**Morya UI** (`morya-ui`) is an open-source Vue 3 component library for building modern web applications. It ships **90+ components**, a token-based theme system, built-in i18n, and a documentation site with live previews.
+
+Whether you are starting a new admin dashboard, SaaS product, or internal tool, you get consistent forms, overlays, data display, and feedback primitives out of the box.
+
+## Features
+
+### Complete
+
+90+ components covering basics, forms, navigation, data display, layout, and feedback — all tree-shakeable via ESM subpath imports.
+
+### Theme-ready
+
+Light and dark modes powered by `--m-*` CSS variables. Switch themes with `useTheme`, tune density and motion with `useDensity` / `useMotion`, and override per subtree via `MConfigProvider`.
+
+### TypeScript-first
+
+Written in Vue 3 Composition API + TypeScript. Props, emits, and locale messages are fully typed.
+
+### Flexible consumption
+
+Use full registration, named imports, on-demand subpaths, or `MoryaUIResolver` with `unplugin-vue-components` — pick one style per app.
+
+### Docs as preview
+
+Every component includes Markdown docs with interactive `vue preview` blocks. Browse them online or run the docs site locally.
+
+### SSR & meta-frameworks
+
+Works with **Nuxt 3**, **Astro + Vue**, **Vite SSR**, and similar setups. Includes the [`@morya-ui/nuxt`](./packages/nuxt) module — see the [SSR guide](https://morya-space.github.io/morya-ui/docs/ssr).
+
+## Documentation
+
+**https://morya-space.github.io/morya-ui/**
+
+| Section | Link |
+| --- | --- |
+| Quick start | [Guide](https://morya-space.github.io/morya-ui/docs/quick-start) |
+| Theme | [Theme](https://morya-space.github.io/morya-ui/docs/theme) |
+| Configuration | [Config](https://morya-space.github.io/morya-ui/docs/config) |
+| SSR | [Nuxt / Astro / Vite SSR](https://morya-space.github.io/morya-ui/docs/ssr) |
+| Components | [Catalog](https://morya-space.github.io/morya-ui/components) |
+| Changelog | [Releases](https://morya-space.github.io/morya-ui/changelog) |
+
+## Install
+
+Requires **Vue 3** (3.5+ recommended) and a bundler that resolves package `exports` (Vite, webpack 5+, etc.).
+
+```bash
+pnpm add morya-ui
+# npm i morya-ui
+# yarn add morya-ui
+```
+
+## Quick start
+
+Register all components and import the full stylesheet:
+
+```ts
+import MoryaUI from 'morya-ui'
+import { createApp } from 'vue'
+import App from './App.vue'
+import 'morya-ui/styles.css'
+
+createApp(App).use(MoryaUI).mount('#app')
+```
+
+On-demand import (styles included automatically):
+
+```ts
+import { MButton } from 'morya-ui/button'
+import { MInput } from 'morya-ui/input'
+```
+
+For global defaults (locale, size, overlay mount point):
+
+```ts
+import { createMoryaUI, enUS } from 'morya-ui'
+
+createApp(App).use(createMoryaUI({ locale: enUS })).mount('#app')
+```
+
+See the [Quick start guide](https://morya-space.github.io/morya-ui/docs/quick-start) for full import modes, Vite resolver setup, and theme APIs.
+
+## Ecosystem
+
+| Package | Description |
+| --- | --- |
+| [`morya-ui`](https://www.npmjs.com/package/morya-ui) | Components, styles, theme & locale helpers |
+| [`@morya-ui/nuxt`](./packages/nuxt) | Nuxt 3 module (styles, transpile, overlay context) |
+| [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) | Optional MCP server for AI-assisted doc lookup |
+| [`@morya-ui/setup`](https://www.npmjs.com/package/@morya-ui/setup) | One-shot consumer setup: library, styles, Agent skill, Cursor rules, and MCP |
+
+## Contributing
+
+We welcome issues and pull requests. Please read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes.
+
+For maintainers: [Development guide](./docs/DEVELOPMENT.md) · [Release scripts](./scripts/README.md)
+
+## Local development
+
+```bash
+pnpm install
+pnpm dev              # docs site → http://localhost:5182
+pnpm build            # library → dist/
+pnpm build:docs:pages # GitHub Pages build
+pnpm test
+pnpm typecheck
+```
+
+## License
+
+[MIT](./LICENSE) © Morya UI contributors

package/README.zh-CN.md

@@ -1,150 +1,150 @@
-<p align="center">
-  <a href="https://morya-space.github.io/morya-ui/">
-    <img src="./assets/logo.svg" alt="Morya UI" width="96" height="96" />
-  </a>
-</p>
-
-<h1 align="center">Morya UI</h1>
-
-<p align="center">
-  带设计令牌、亮暗主题与交互式文档的 Vue 3 组件库。
-</p>
-
-<p align="center">
-  <a href="./README.md">English</a> | 中文
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/v/morya-ui?style=flat-square" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/dm/morya-ui?style=flat-square" alt="npm downloads" /></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/github/license/morya-space/morya-ui?style=flat-square" alt="license" /></a>
-  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3-42b883?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3" /></a>
-  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.x-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
-</p>
-
-<p align="center">
-  <a href="https://morya-space.github.io/morya-ui/"><b>文档站</b></a>
-  ·
-  <a href="https://morya-space.github.io/morya-ui/components">组件</a>
-  ·
-  <a href="https://github.com/morya-space/morya-ui/issues">Issues</a>
-  ·
-  <a href="./CHANGELOG.md">更新日志</a>
-</p>
-
----
-
-## 介绍
-
-**Morya UI**（`morya-ui`）是一套开源的 Vue 3 组件库，提供 **90+ 个组件**、基于令牌的主题系统、内置国际化，以及带实时预览的文档站。
-
-无论你是做管理后台、SaaS 产品还是内部工具，都可以直接使用统一的表单、浮层、数据展示与反馈能力。
-
-## 特性
-
-### 组件齐全
-
-覆盖基础、表单、导航、数据展示、布局与反馈等 90+ 个组件，均支持 ESM 按需引入与 tree-shaking。
-
-### 主题开箱即用
-
-亮/暗色模式基于 `--m-*` CSS 变量；通过 `useTheme` 切换主题，用 `useDensity` / `useMotion` 调整密度与动效，子树可用 `MConfigProvider` 覆盖。
-
-### TypeScript 优先
-
-基于 Vue 3 Composition API 与 TypeScript 编写，Props、Emits 与 locale 均有完整类型。
-
-### 多种接入方式
-
-支持全量注册、按名导入、按需子路径，以及配合 `unplugin-vue-components` 的 `MoryaUIResolver`——同一应用内建议保持一致。
-
-### 文档即预览
-
-每个组件自带 Markdown 文档与可交互 `vue preview` 示例，可在线浏览或本地启动文档站。
-
-### SSR 与元框架
-
-兼容 **Nuxt 3**、**Astro + Vue**、**Vite SSR** 等场景；提供 [`@morya-ui/nuxt`](./packages/nuxt) 模块，详见 [SSR 指南](https://morya-space.github.io/morya-ui/docs/ssr)。
-
-## 文档
-
-**https://morya-space.github.io/morya-ui/**
-
-| 章节 | 链接 |
-| --- | --- |
-| 快速上手 | [指南](https://morya-space.github.io/morya-ui/docs/quick-start) |
-| 主题 | [主题](https://morya-space.github.io/morya-ui/docs/theme) |
-| 全局配置 | [配置](https://morya-space.github.io/morya-ui/docs/config) |
-| SSR | [Nuxt / Astro / Vite SSR](https://morya-space.github.io/morya-ui/docs/ssr) |
-| 组件 | [目录](https://morya-space.github.io/morya-ui/components) |
-| 更新日志 | [版本](https://morya-space.github.io/morya-ui/changelog) |
-
-## 安装
-
-需要 **Vue 3**（推荐 3.5 及以上），以及能解析包 `exports` 的构建工具（Vite、webpack 5+ 等）。
-
-```bash
-pnpm add morya-ui
-# npm i morya-ui
-# yarn add morya-ui
-```
-
-## 快速开始
-
-全量注册并引入样式：
-
-```ts
-import MoryaUI from 'morya-ui'
-import { createApp } from 'vue'
-import App from './App.vue'
-import 'morya-ui/styles.css'
-
-createApp(App).use(MoryaUI).mount('#app')
-```
-
-按需引入（样式自动带入）：
-
-```ts
-import { MButton } from 'morya-ui/button'
-import { MInput } from 'morya-ui/input'
-```
-
-应用级默认配置（语言、尺寸、浮层挂载点等）：
-
-```ts
-import { createMoryaUI, zhCN } from 'morya-ui'
-
-createApp(App).use(createMoryaUI({ locale: zhCN })).mount('#app')
-```
-
-完整接入方式、Vite 解析器与主题 API 见 [快速上手](https://morya-space.github.io/morya-ui/docs/quick-start)。
-
-## 生态
-
-| 包 | 说明 |
-| --- | --- |
-| [`morya-ui`](https://www.npmjs.com/package/morya-ui) | 组件、样式、主题与语言工具 |
-| [`@morya-ui/nuxt`](./packages/nuxt) | Nuxt 3 模块（样式、transpile、overlay 上下文） |
-| [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) | 可选 MCP 服务，供 AI 客户端检索文档 |
-| [`@morya-ui/setup`](https://www.npmjs.com/package/@morya-ui/setup) | 业务项目一键接入：组件库、样式、Agent Skill、Cursor 规则与 MCP |
-
-## 参与贡献
-
-欢迎提交 Issue 与 Pull Request。请先阅读 [CONTRIBUTING.zh-CN.md](./CONTRIBUTING.zh-CN.md)。
-
-维护者文档：[开发指南](./docs/DEVELOPMENT.zh-CN.md) · [发版脚本](./scripts/README.md)
-
-## 本地开发
-
-```bash
-pnpm install
-pnpm dev              # 文档站 → http://localhost:5182
-pnpm build            # 组件库 → dist/
-pnpm build:docs:pages # GitHub Pages 构建
-pnpm test
-pnpm typecheck
-```
-
-## 许可证
-
-[MIT](./LICENSE) © Morya UI contributors
+<p align="center">
+  <a href="https://morya-space.github.io/morya-ui/">
+    <img src="./assets/logo.svg" alt="Morya UI" width="96" height="96" />
+  </a>
+</p>
+
+<h1 align="center">Morya UI</h1>
+
+<p align="center">
+  带设计令牌、亮暗主题与交互式文档的 Vue 3 组件库。
+</p>
+
+<p align="center">
+  <a href="./README.md">English</a> | 中文
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/v/morya-ui?style=flat-square" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/morya-ui"><img src="https://img.shields.io/npm/dm/morya-ui?style=flat-square" alt="npm downloads" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/github/license/morya-space/morya-ui?style=flat-square" alt="license" /></a>
+  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3-42b883?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3" /></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.x-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" /></a>
+</p>
+
+<p align="center">
+  <a href="https://morya-space.github.io/morya-ui/"><b>文档站</b></a>
+  ·
+  <a href="https://morya-space.github.io/morya-ui/components">组件</a>
+  ·
+  <a href="https://github.com/morya-space/morya-ui/issues">Issues</a>
+  ·
+  <a href="./CHANGELOG.md">更新日志</a>
+</p>
+
+---
+
+## 介绍
+
+**Morya UI**（`morya-ui`）是一套开源的 Vue 3 组件库，提供 **90+ 个组件**、基于令牌的主题系统、内置国际化，以及带实时预览的文档站。
+
+无论你是做管理后台、SaaS 产品还是内部工具，都可以直接使用统一的表单、浮层、数据展示与反馈能力。
+
+## 特性
+
+### 组件齐全
+
+覆盖基础、表单、导航、数据展示、布局与反馈等 90+ 个组件，均支持 ESM 按需引入与 tree-shaking。
+
+### 主题开箱即用
+
+亮/暗色模式基于 `--m-*` CSS 变量；通过 `useTheme` 切换主题，用 `useDensity` / `useMotion` 调整密度与动效，子树可用 `MConfigProvider` 覆盖。
+
+### TypeScript 优先
+
+基于 Vue 3 Composition API 与 TypeScript 编写，Props、Emits 与 locale 均有完整类型。
+
+### 多种接入方式
+
+支持全量注册、按名导入、按需子路径，以及配合 `unplugin-vue-components` 的 `MoryaUIResolver`——同一应用内建议保持一致。
+
+### 文档即预览
+
+每个组件自带 Markdown 文档与可交互 `vue preview` 示例，可在线浏览或本地启动文档站。
+
+### SSR 与元框架
+
+兼容 **Nuxt 3**、**Astro + Vue**、**Vite SSR** 等场景；提供 [`@morya-ui/nuxt`](./packages/nuxt) 模块，详见 [SSR 指南](https://morya-space.github.io/morya-ui/docs/ssr)。
+
+## 文档
+
+**https://morya-space.github.io/morya-ui/**
+
+| 章节 | 链接 |
+| --- | --- |
+| 快速上手 | [指南](https://morya-space.github.io/morya-ui/docs/quick-start) |
+| 主题 | [主题](https://morya-space.github.io/morya-ui/docs/theme) |
+| 全局配置 | [配置](https://morya-space.github.io/morya-ui/docs/config) |
+| SSR | [Nuxt / Astro / Vite SSR](https://morya-space.github.io/morya-ui/docs/ssr) |
+| 组件 | [目录](https://morya-space.github.io/morya-ui/components) |
+| 更新日志 | [版本](https://morya-space.github.io/morya-ui/changelog) |
+
+## 安装
+
+需要 **Vue 3**（推荐 3.5 及以上），以及能解析包 `exports` 的构建工具（Vite、webpack 5+ 等）。
+
+```bash
+pnpm add morya-ui
+# npm i morya-ui
+# yarn add morya-ui
+```
+
+## 快速开始
+
+全量注册并引入样式：
+
+```ts
+import MoryaUI from 'morya-ui'
+import { createApp } from 'vue'
+import App from './App.vue'
+import 'morya-ui/styles.css'
+
+createApp(App).use(MoryaUI).mount('#app')
+```
+
+按需引入（样式自动带入）：
+
+```ts
+import { MButton } from 'morya-ui/button'
+import { MInput } from 'morya-ui/input'
+```
+
+应用级默认配置（语言、尺寸、浮层挂载点等）：
+
+```ts
+import { createMoryaUI, zhCN } from 'morya-ui'
+
+createApp(App).use(createMoryaUI({ locale: zhCN })).mount('#app')
+```
+
+完整接入方式、Vite 解析器与主题 API 见 [快速上手](https://morya-space.github.io/morya-ui/docs/quick-start)。
+
+## 生态
+
+| 包 | 说明 |
+| --- | --- |
+| [`morya-ui`](https://www.npmjs.com/package/morya-ui) | 组件、样式、主题与语言工具 |
+| [`@morya-ui/nuxt`](./packages/nuxt) | Nuxt 3 模块（样式、transpile、overlay 上下文） |
+| [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) | 可选 MCP 服务，供 AI 客户端检索文档 |
+| [`@morya-ui/setup`](https://www.npmjs.com/package/@morya-ui/setup) | 业务项目一键接入：组件库、样式、Agent Skill、Cursor 规则与 MCP |
+
+## 参与贡献
+
+欢迎提交 Issue 与 Pull Request。请先阅读 [CONTRIBUTING.zh-CN.md](./CONTRIBUTING.zh-CN.md)。
+
+维护者文档：[开发指南](./docs/DEVELOPMENT.zh-CN.md) · [发版脚本](./scripts/README.md)
+
+## 本地开发
+
+```bash
+pnpm install
+pnpm dev              # 文档站 → http://localhost:5182
+pnpm build            # 组件库 → dist/
+pnpm build:docs:pages # GitHub Pages 构建
+pnpm test
+pnpm typecheck
+```
+
+## 许可证
+
+[MIT](./LICENSE) © Morya UI contributors