morya-ui 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,64 +1,95 @@
-# morya-ui
-
-## 0.1.1
-
-`morya-ui` 的初始公开版本（Morya UI），以当前组件库能力为基准。
-
-### 组件（88 个）
-
-- **基础**：Button、ButtonGroup、Icon、Avatar、AvatarGroup、Badge、Chip、Tag、Divider、Skeleton、ProgressBar、ProgressSpinner、BlockUI、ScrollTop
-- **表单**：Input、Textarea、InputNumber、InputPassword、InputOtp、InputTags、InputColor、InputGroup、InputGroupAddon、IconField、FloatLabel、Label、Checkbox、CheckboxGroup、Radio、RadioGroup、Switch、Select、SelectButton、ToggleButton、Slider、Knob、Rating、DatePicker、AutoComplete、CascadeSelect、TreeSelect、FileUpload、Form、FormItem
-- **浮层与对话框**：Dialog、Drawer、Popover、Tooltip、ConfirmDialog、ConfirmPopup、ContextMenu、Dropdown、SplitButton、SpeedDial
-- **数据展示**：Table、Tree、TreeTable、TreeSelect、DataView、VirtualScroller、Timeline、MeterGroup、Terminal、Gallery、Carousel、Inplace
-- **导航与菜单**：Menu、Menubar、MegaMenu、TieredMenu、Breadcrumb、Tabs、Stepper、Pagination、CommandMenu、Dock、Sidebar
-- **布局**：Layout（Header / Sider / Content / Footer）、Grid、Flex、Space、Fluid、Panel、Card、Fieldset、Accordion、Splitter、Toolbar、Listbox、PickList、OrderList、Scrollbar
-
-### 主题与设计令牌
-
-- 亮/暗色主题（`useTheme`、`applyTheme`、`getPreferredTheme`）
-- 密度与动效偏好（`useDensity`、`useMotion`，支持 `prefers-reduced-motion` 与 `data-m-motion`）
-- 基于 `--m-*` CSS 变量的设计令牌体系（颜色、间距、圆角、阴影、边框、布局、树形、时间线、分割面板等）
-- 子树级覆盖：`MConfigProvider` 注入主题、密度、动效与组件默认项
-
-### 全局配置与工具 API
-
-- 插件入口：`MoryaUI` 全量注册、`createMoryaUI` 按需/默认配置
-- 按需构建：`MoryaUIResolver`（配合 `unplugin-vue-components`）
-- ESM 子路径导出（`morya-ui/button` 等），tree-shaking 友好
-- 命令式 API：`useConfirm`、`useToast` / `toast`、`useMessage` / `message`、`useContextMenu`
-- 共享 composable：`useControllable`、`useFieldFeedback`、`useMenuKeyboard`、`useModalOverlay`、`useMId`
-- 国际化：`zhCN`、`enUS`、`mergeLocale`、`useMLocale`、`formatLocale`
-
-### 打包与类型
-
-- 产物：ESM + 类型声明 + 聚合样式 `styles.css`
-- 完整 TypeScript 类型（Props、Emits、Slots、Locale）
-- `sideEffects` 与细粒度 exports，支持按组件引入样式
-
-### 文档站
-
-- 交互式文档站（Markdown + `vue preview` 实时示例）
-- 组件目录、指南（快速上手、主题、配置、SSR、无障碍、MCP）
-- 亮/暗主题切换、中英文切换、全局搜索（CommandMenu）
-- 部署至 GitHub Pages：https://morya-ui.github.io/morya-ui/
-
-### 生态包
-
-- **`@morya-space/nuxt`**：Nuxt 3 模块（样式注入、transpile、客户端 overlay 上下文）
-- **`morya-ui-mcp`**：MCP 服务，供 AI 客户端检索组件文档、示例与用法建议
-
-### SSR 与框架集成
-
-- 兼容 Nuxt 3、Astro + Vue、Vite SSR 等场景（推荐 Vue 3.5+）
-- 浮层统一挂载与 placement（flip / clamp）策略
-
-### 无障碍
-
-- 表单控件、Tabs、Slider、Switch、MeterGroup、ProgressSpinner 等核心路径的 ARIA 与键盘支持
-- 菜单类组件统一键盘导航（`useMenuKeyboard`）
-- Tree / TreeTable treegrid 语义
-
-### 质量
-
-- 600+ 单元测试用例
-- `check:tokens` / `check:colors` 设计令牌校验
+# morya-ui
+
+## 0.2.1
+
+### 破坏性变更
+
+- rebrand WiseKit to morya-ui with M-prefixed public API
+
+### 新功能
+
+- link API table types to doc anchors
+- add hybrid fallthrough attrs helpers
+
+### 修复
+
+- support uncontrolled open and slot trigger
+- rename Nuxt module to morya-ui-nuxt for npm publish
+
+### 文档
+
+- add type sections at end of component docs
+- document shared types and type link conventions
+- document pt props and trim attrs boilerplate
+- add attrs and types guides with updated nav
+
+### 变更
+
+- add component doc type section tooling
+- add attrs audit and doc maintenance tooling
+- apply hybrid attrs routing across library
+- update documentation links to reflect new GitHub Pages URL
+- rename satellite packages to @morya-ui scope
+
+## 0.1.1
+
+`morya-ui` 的初始公开版本（Morya UI），以当前组件库能力为基准。
+
+### 组件（88 个）
+
+- **基础**：Button、ButtonGroup、Icon、Avatar、AvatarGroup、Badge、Chip、Tag、Divider、Skeleton、ProgressBar、ProgressSpinner、BlockUI、ScrollTop
+- **表单**：Input、Textarea、InputNumber、InputPassword、InputOtp、InputTags、InputColor、InputGroup、InputGroupAddon、IconField、FloatLabel、Label、Checkbox、CheckboxGroup、Radio、RadioGroup、Switch、Select、SelectButton、ToggleButton、Slider、Knob、Rating、DatePicker、AutoComplete、CascadeSelect、TreeSelect、FileUpload、Form、FormItem
+- **浮层与对话框**：Dialog、Drawer、Popover、Tooltip、ConfirmDialog、ConfirmPopup、ContextMenu、Dropdown、SplitButton、SpeedDial
+- **数据展示**：Table、Tree、TreeTable、TreeSelect、DataView、VirtualScroller、Timeline、MeterGroup、Terminal、Gallery、Carousel、Inplace
+- **导航与菜单**：Menu、Menubar、MegaMenu、TieredMenu、Breadcrumb、Tabs、Stepper、Pagination、CommandMenu、Dock、Sidebar
+- **布局**：Layout（Header / Sider / Content / Footer）、Grid、Flex、Space、Fluid、Panel、Card、Fieldset、Accordion、Splitter、Toolbar、Listbox、PickList、OrderList、Scrollbar
+
+### 主题与设计令牌
+
+- 亮/暗色主题（`useTheme`、`applyTheme`、`getPreferredTheme`）
+- 密度与动效偏好（`useDensity`、`useMotion`，支持 `prefers-reduced-motion` 与 `data-m-motion`）
+- 基于 `--m-*` CSS 变量的设计令牌体系（颜色、间距、圆角、阴影、边框、布局、树形、时间线、分割面板等）
+- 子树级覆盖：`MConfigProvider` 注入主题、密度、动效与组件默认项
+
+### 全局配置与工具 API
+
+- 插件入口：`MoryaUI` 全量注册、`createMoryaUI` 按需/默认配置
+- 按需构建：`MoryaUIResolver`（配合 `unplugin-vue-components`）
+- ESM 子路径导出（`morya-ui/button` 等），tree-shaking 友好
+- 命令式 API：`useConfirm`、`useToast` / `toast`、`useMessage` / `message`、`useContextMenu`
+- 共享 composable：`useControllable`、`useFieldFeedback`、`useMenuKeyboard`、`useModalOverlay`、`useMId`
+- 国际化：`zhCN`、`enUS`、`mergeLocale`、`useMLocale`、`formatLocale`
+
+### 打包与类型
+
+- 产物：ESM + 类型声明 + 聚合样式 `styles.css`
+- 完整 TypeScript 类型（Props、Emits、Slots、Locale）
+- `sideEffects` 与细粒度 exports，支持按组件引入样式
+
+### 文档站
+
+- 交互式文档站（Markdown + `vue preview` 实时示例）
+- 组件目录、指南（快速上手、主题、配置、SSR、无障碍、MCP）
+- 亮/暗主题切换、中英文切换、全局搜索（CommandMenu）
+- 部署至 GitHub Pages：https://morya-space.github.io/morya-ui/
+
+### 生态包
+
+- **`@morya-ui/nuxt`**：Nuxt 3 模块（样式注入、transpile、客户端 overlay 上下文）
+- **`@morya-ui/mcp`**：MCP 服务，供 AI 客户端检索组件文档、示例与用法建议
+
+### SSR 与框架集成
+
+- 兼容 Nuxt 3、Astro + Vue、Vite SSR 等场景（推荐 Vue 3.5+）
+- 浮层统一挂载与 placement（flip / clamp）策略
+
+### 无障碍
+
+- 表单控件、Tabs、Slider、Switch、MeterGroup、ProgressSpinner 等核心路径的 ARIA 与键盘支持
+- 菜单类组件统一键盘导航（`useMenuKeyboard`）
+- Tree / TreeTable treegrid 语义
+
+### 质量
+
+- 600+ 单元测试用例
+- `check:tokens` / `check:colors` 设计令牌校验

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,149 +1,149 @@
-<p align="center">
-  <a href="https://morya-ui.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-ui.github.io/morya-ui/"><b>Documentation</b></a>
-  ·
-  <a href="https://morya-ui.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 **88 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
-
-88 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-space/nuxt`](./packages/nuxt) module — see the [SSR guide](https://morya-ui.github.io/morya-ui/docs/ssr).
-
-## Documentation
-
-**https://morya-ui.github.io/morya-ui/**
-
-| Section | Link |
-| --- | --- |
-| Quick start | [Guide](https://morya-ui.github.io/morya-ui/docs/quick-start) |
-| Theme | [Theme](https://morya-ui.github.io/morya-ui/docs/theme) |
-| Configuration | [Config](https://morya-ui.github.io/morya-ui/docs/config) |
-| SSR | [Nuxt / Astro / Vite SSR](https://morya-ui.github.io/morya-ui/docs/ssr) |
-| Components | [Catalog](https://morya-ui.github.io/morya-ui/components) |
-| Changelog | [Releases](https://morya-ui.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-ui.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-space/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 |
-
-## 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 **88 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
+
+88 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 |
+
+## 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