@morya-ui/mcp 0.4.0 → 0.4.2

package/data/catalog.json

@@ -1,12 +1,12 @@
 {
-  "generatedAt": "2026-09-30T07:47:11.558Z",
+  "generatedAt": "2026-10-09T09:31:59.453Z",
   "library": {
     "name": "morya-ui",
-    "version": "0.4.0"
+    "version": "0.4.2"
   },
   "mcp": {
     "name": "@morya-ui/mcp",
-    "version": "0.4.0"
+    "version": "0.4.2"
   },
   "components": [
     {
@@ -101,7 +101,7 @@
           "sectionId": "extra",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MAccordion, MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = [\n  { value: 'a', header: 'Section A' },\n]\n</script>\n\n<template>\n  <MAccordion v-model=\"active\" :tabs=\"tabs\">\n    <template #extra=\"{ tab }\">\n      <MButton :label=\"tab.header\" size=\"small\" text />\n    </template>\n    <template #a>\n      <p style=\"margin:0\">\n        Content.\n      </p>\n    </template>\n  </MAccordion>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MAccordion, MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = [\n  { value: 'a', header: 'Section A' },\n]\n</script>\n\n<template>\n  <MAccordion v-model=\"active\" :tabs=\"tabs\">\n    <template #extra=\"{ tab }\">\n      <MButton :label=\"tab.header\" size=\"small\" type=\"text\"/>\n    </template>\n    <template #a>\n      <p style=\"margin:0\">\n        Content.\n      </p>\n    </template>\n  </MAccordion>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -137,7 +137,7 @@
           "sectionId": "extra",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MAccordion, MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = [\n  { value: 'a', header: 'Section A' },\n]\n</script>\n\n<template>\n  <MAccordion v-model=\"active\" :tabs=\"tabs\">\n    <template #extra=\"{ tab }\">\n      <MButton :label=\"tab.header\" size=\"small\" text />\n    </template>\n    <template #a>\n      <p style=\"margin:0\">\n        Content.\n      </p>\n    </template>\n  </MAccordion>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MAccordion, MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = [\n  { value: 'a', header: 'Section A' },\n]\n</script>\n\n<template>\n  <MAccordion v-model=\"active\" :tabs=\"tabs\">\n    <template #extra=\"{ tab }\">\n      <MButton :label=\"tab.header\" size=\"small\" type=\"text\"/>\n    </template>\n    <template #a>\n      <p style=\"margin:0\">\n        Content.\n      </p>\n    </template>\n  </MAccordion>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -302,7 +302,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MAffix, MButton } from 'morya-ui'\n\nconst top = ref(80)\n</script>\n\n<template>\n  <div style=\"height: 320px; overflow: auto; border: 1px solid var(--m-color-border); padding: var(--m-space-4);\">\n    <p>向下滚动，按钮在距顶部 {{ top }}px 时固定。</p>\n    <div style=\"height: 120px\" />\n    <MAffix :offset-top=\"top\">\n      <MButton severity=\"primary\">\n        Affix at {{ top }}px\n      </MButton>\n    </MAffix>\n    <div style=\"height: 480px\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MAffix, MButton } from 'morya-ui'\n\nconst top = ref(80)\n</script>\n\n<template>\n  <div style=\"height: 320px; overflow: auto; border: 1px solid var(--m-color-border); padding: var(--m-space-4);\">\n    <p>向下滚动，按钮在距顶部 {{ top }}px 时固定。</p>\n    <div style=\"height: 120px\" />\n    <MAffix :offset-top=\"top\">\n      <MButton type=\"primary\">\n        Affix at {{ top }}px\n      </MButton>\n    </MAffix>\n    <div style=\"height: 480px\" />\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -320,7 +320,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MAffix, MButton } from 'morya-ui'\n\nconst top = ref(80)\n</script>\n\n<template>\n  <div style=\"height: 320px; overflow: auto; border: 1px solid var(--m-color-border); padding: var(--m-space-4);\">\n    <p>向下滚动，按钮在距顶部 {{ top }}px 时固定。</p>\n    <div style=\"height: 120px\" />\n    <MAffix :offset-top=\"top\">\n      <MButton severity=\"primary\">\n        Affix at {{ top }}px\n      </MButton>\n    </MAffix>\n    <div style=\"height: 480px\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MAffix, MButton } from 'morya-ui'\n\nconst top = ref(80)\n</script>\n\n<template>\n  <div style=\"height: 320px; overflow: auto; border: 1px solid var(--m-color-border); padding: var(--m-space-4);\">\n    <p>向下滚动，按钮在距顶部 {{ top }}px 时固定。</p>\n    <div style=\"height: 120px\" />\n    <MAffix :offset-top=\"top\">\n      <MButton type=\"primary\">\n        Affix at {{ top }}px\n      </MButton>\n    </MAffix>\n    <div style=\"height: 480px\" />\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -510,7 +510,7 @@
           "sectionId": "操作区",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MAlert, MButton, message } from 'morya-ui'\n\nfunction onUndo() {\n  message.info('已撤销')\n}\n</script>\n\n<template>\n  <MAlert severity=\"info\">\n    <template #title>\n      已归档\n    </template>\n    该记录已移入归档。你可以撤销此次操作。\n    <template #action>\n      <MButton\n        size=\"small\"\n        text\n        @click=\"onUndo\"\n      >\n        撤销\n      </MButton>\n    </template>\n  </MAlert>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MAlert, MButton, message } from 'morya-ui'\n\nfunction onUndo() {\n  message.info('已撤销')\n}\n</script>\n\n<template>\n  <MAlert severity=\"info\">\n    <template #title>\n      已归档\n    </template>\n    该记录已移入归档。你可以撤销此次操作。\n    <template #action>\n      <MButton size=\"small\" @click=\"onUndo\" type=\"text\">\n        撤销\n      </MButton>\n    </template>\n  </MAlert>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -564,7 +564,7 @@
           "sectionId": "action",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MAlert, MButton, message } from 'morya-ui'\n\nfunction onUndo() {\n  message.info('已撤销')\n}\n</script>\n\n<template>\n  <MAlert severity=\"info\">\n    <template #title>\n      已归档\n    </template>\n    该记录已移入归档。你可以撤销此次操作。\n    <template #action>\n      <MButton\n        size=\"small\"\n        text\n        @click=\"onUndo\"\n      >\n        撤销\n      </MButton>\n    </template>\n  </MAlert>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MAlert, MButton, message } from 'morya-ui'\n\nfunction onUndo() {\n  message.info('已撤销')\n}\n</script>\n\n<template>\n  <MAlert severity=\"info\">\n    <template #title>\n      已归档\n    </template>\n    该记录已移入归档。你可以撤销此次操作。\n    <template #action>\n      <MButton size=\"small\" @click=\"onUndo\" type=\"text\">\n        撤销\n      </MButton>\n    </template>\n  </MAlert>\n</template>",
           "locale": "en-US"
         },
         {
@@ -1495,6 +1495,12 @@
           "type": "boolean",
           "default": "false",
           "description": "脉冲动画。"
+        },
+        {
+          "name": "pt",
+          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "default": "—",
+          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
         }
       ],
       "events": [],
@@ -1548,7 +1554,7 @@
           "sectionId": "overlay",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MBadge, MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:flex;flex-wrap:wrap;gap:1.5rem;align-items:center\">\n    <MBadge :value=\"120\" :max=\"99\">\n      <MButton label=\"Inbox\" severity=\"secondary\" />\n    </MBadge>\n    <MBadge processing>\n      <MButton label=\"Live\" icon=\"check\" />\n    </MBadge>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MBadge, MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:flex;flex-wrap:wrap;gap:1.5rem;align-items:center\">\n    <MBadge :value=\"120\" :max=\"99\">\n      <MButton label=\"Inbox\"/>\n    </MBadge>\n    <MBadge processing>\n      <MButton label=\"Live\" icon=\"check\" />\n    </MBadge>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -1593,7 +1599,7 @@
           "sectionId": "overlay",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MBadge, MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:flex;flex-wrap:wrap;gap:1.5rem;align-items:center\">\n    <MBadge :value=\"120\" :max=\"99\">\n      <MButton label=\"Inbox\" severity=\"secondary\" />\n    </MBadge>\n    <MBadge processing>\n      <MButton label=\"Live\" icon=\"check\" />\n    </MBadge>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MBadge, MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:flex;flex-wrap:wrap;gap:1.5rem;align-items:center\">\n    <MBadge :value=\"120\" :max=\"99\">\n      <MButton label=\"Inbox\"/>\n    </MBadge>\n    <MBadge processing>\n      <MButton label=\"Live\" icon=\"check\" />\n    </MBadge>\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -1635,7 +1641,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | — | 角标内容。省略时显示为圆点。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；`sm` / `lg` 为别名。 |\n| `max` | `number` | — | 数字上限，超出显示 `{max}+`。 |\n| `offset` | `[number, number]` | — | 包裹模式下的位移 `[x, y]`。 |\n| `processing` | `boolean` | `false` | 脉冲动画。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | — | 角标内容。省略时显示为圆点。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；`sm` / `lg` 为别名。 |\n| `max` | `number` | — | 数字上限，超出显示 `{max}+`。 |\n| `offset` | `[number, number]` | — | 包裹模式下的位移 `[x, y]`。 |\n| `processing` | `boolean` | `false` | 脉冲动画。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "slots",
@@ -1653,7 +1659,7 @@
               "body": "无自定义事件。"
             }
           ],
-          "markdown": "---\ntitle: Badge\ncategory: 01 / BASIC\ndescription: 状态角标或圆点。\n---\n\n# Badge\n\n状态角标或圆点，用于数量与状态提示。\n\n## 引入\n\n```ts\nimport { MBadge } from 'morya-ui'\n```\n\n## 基础用法\n\n传入 `value` 展示文案或数字；省略 `value` 时渲染为圆点。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\n使用 `severity` 定义语义色；省略时为 primary。兼容旧值 `warning`（映射为 `warn`）。\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Size\n\n`size` 支持 `small` / `large`，以及别名 `sm` / `lg`。\n\n```vue preview src=\"./demos/Size.vue\"\n```\n\n## Overlay\n\n默认插槽包裹子节点；`max` 超出时显示 `99+`，`processing` 显示脉冲。\n\n```vue preview src=\"./demos/Overlay.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | — | 角标内容。省略时显示为圆点。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；`sm` / `lg` 为别名。 |\n| `max` | `number` | — | 数字上限，超出显示 `{max}+`。 |\n| `offset` | `[number, number]` | — | 包裹模式下的位移 `[x, y]`。 |\n| `processing` | `boolean` | `false` | 脉冲动画。 |\n\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 被角标包裹的内容。 |\n\n## 无障碍\n\n- 角标数字变化时，若状态重要，请同步更新附近可见文案或 `aria-live` 区域。\n- 包裹模式下，勿让角标成为唯一的状态提示。\n\n## Events\n\n无自定义事件。\n"
+          "markdown": "---\ntitle: Badge\ncategory: 01 / BASIC\ndescription: 状态角标或圆点。\n---\n\n# Badge\n\n状态角标或圆点，用于数量与状态提示。\n\n## 引入\n\n```ts\nimport { MBadge } from 'morya-ui'\n```\n\n## 基础用法\n\n传入 `value` 展示文案或数字；省略 `value` 时渲染为圆点。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\n使用 `severity` 定义语义色；省略时为 primary。兼容旧值 `warning`（映射为 `warn`）。\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Size\n\n`size` 支持 `small` / `large`，以及别名 `sm` / `lg`。\n\n```vue preview src=\"./demos/Size.vue\"\n```\n\n## Overlay\n\n默认插槽包裹子节点；`max` 超出时显示 `99+`，`processing` 显示脉冲。\n\n```vue preview src=\"./demos/Overlay.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | — | 角标内容。省略时显示为圆点。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；`sm` / `lg` 为别名。 |\n| `max` | `number` | — | 数字上限，超出显示 `{max}+`。 |\n| `offset` | `[number, number]` | — | 包裹模式下的位移 `[x, y]`。 |\n| `processing` | `boolean` | `false` | 脉冲动画。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 被角标包裹的内容。 |\n\n## 无障碍\n\n- 角标数字变化时，若状态重要，请同步更新附近可见文案或 `aria-live` 区域。\n- 包裹模式下，勿让角标成为唯一的状态提示。\n\n## Events\n\n无自定义事件。\n"
         },
         "en-US": {
           "title": "Badge",
@@ -1692,7 +1698,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | 鈥?| Badge content. Renders as a dot when omitted. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size; `sm` / `lg` are aliases. |\n| `max` | `number` | 鈥?| Cap numeric values as `{max}+`. |\n| `offset` | `[number, number]` | 鈥?| Offset `[x, y]` when wrapping content. |\n| `processing` | `boolean` | `false` | Pulse animation. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | 鈥?| Badge content. Renders as a dot when omitted. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size; `sm` / `lg` are aliases. |\n| `max` | `number` | 鈥?| Cap numeric values as `{max}+`. |\n| `offset` | `[number, number]` | 鈥?| Offset `[x, y]` when wrapping content. |\n| `processing` | `boolean` | `false` | Pulse animation. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |"
             },
             {
               "id": "slots",
@@ -1710,7 +1716,7 @@
               "body": "No custom events."
             }
           ],
-          "markdown": "---\ntitle: Badge\ncategory: 01 / BASIC\ndescription: Status badge or dot.\n---\n\n# Badge\n\nStatus badge or dot for counts and status cues.\n\n## Import\n\n```ts\nimport { MBadge } from 'morya-ui'\n```\n\n## Basic\n\nPass `value` to show text or a number; omit `value` to render a dot.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\nUse `severity` for semantic color; defaults to primary when omitted. Legacy value `warning` is supported (mapped to `warn`).\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Size\n\n`size` supports `small` / `large`, plus aliases `sm` / `lg`.\n\n```vue preview src=\"./demos/Size.vue\"\n```\n\n## Overlay\n\nWrap content with the default slot. `max` caps numeric values; `processing` pulses.\n\n```vue preview src=\"./demos/Overlay.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | 鈥?| Badge content. Renders as a dot when omitted. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size; `sm` / `lg` are aliases. |\n| `max` | `number` | 鈥?| Cap numeric values as `{max}+`. |\n| `offset` | `[number, number]` | 鈥?| Offset `[x, y]` when wrapping content. |\n| `processing` | `boolean` | `false` | Pulse animation. |\n\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Content to overlay. |\n\n## Accessibility\n\n- When badge counts matter, update nearby visible text or an `aria-live` region.\n- Do not rely on the badge alone as the only status indicator.\n\n## Events\n\nNo custom events.\n"
+          "markdown": "---\ntitle: Badge\ncategory: 01 / BASIC\ndescription: Status badge or dot.\n---\n\n# Badge\n\nStatus badge or dot for counts and status cues.\n\n## Import\n\n```ts\nimport { MBadge } from 'morya-ui'\n```\n\n## Basic\n\nPass `value` to show text or a number; omit `value` to render a dot.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\nUse `severity` for semantic color; defaults to primary when omitted. Legacy value `warning` is supported (mapped to `warn`).\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Size\n\n`size` supports `small` / `large`, plus aliases `sm` / `lg`.\n\n```vue preview src=\"./demos/Size.vue\"\n```\n\n## Overlay\n\nWrap content with the default slot. `max` caps numeric values; `processing` pulses.\n\n```vue preview src=\"./demos/Overlay.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string \\| number` | 鈥?| Badge content. Renders as a dot when omitted. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size; `sm` / `lg` are aliases. |\n| `max` | `number` | 鈥?| Cap numeric values as `{max}+`. |\n| `offset` | `[number, number]` | 鈥?| Offset `[x, y]` when wrapping content. |\n| `processing` | `boolean` | `false` | Pulse animation. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |\n\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Content to overlay. |\n\n## Accessibility\n\n- When badge counts matter, update nearby visible text or an `aria-live` region.\n- Do not rely on the badge alone as the only status indicator.\n\n## Events\n\nNo custom events.\n"
         }
       }
     },
@@ -2059,171 +2065,129 @@
       "name": "Button",
       "exportName": "MButton",
       "category": "01 / BASIC",
-      "description": "按钮用于触发即时动作。",
-      "descriptionEn": "Button triggers an immediate action.",
+      "description": "触发即时操作的按钮。",
+      "descriptionEn": "A button that triggers an immediate action.",
       "import": "import { MButton } from 'morya-ui'",
       "props": [
         {
-          "name": "label",
-          "type": "string",
-          "default": "—",
-          "description": "按钮文案。存在默认插槽内容时以插槽为准。"
-        },
-        {
-          "name": "icon",
-          "type": "IconName | Component",
-          "default": "—",
-          "description": "图标名称或自定义组件。"
-        },
-        {
-          "name": "iconPos",
-          "type": "'left' | 'right' | 'top' | 'bottom'",
-          "default": "'left'",
-          "description": "图标相对标签的位置。"
-        },
-        {
-          "name": "iconOnly",
-          "type": "boolean",
-          "default": "false",
-          "description": "强制方形纯图标按钮。"
-        },
-        {
-          "name": "badge",
-          "type": "string",
-          "default": "—",
-          "description": "徽标文本。"
-        },
-        {
-          "name": "badgeSeverity",
-          "type": "'secondary' | 'info' | 'success' | 'warn' | 'danger' | 'contrast' | null",
-          "default": "null",
-          "description": "徽标语义色。"
-        },
-        {
-          "name": "severity",
-          "type": "'secondary' | 'success' | 'info' | 'warn' | 'help' | 'danger' | 'contrast'",
-          "default": "—",
-          "description": "语义色。省略时为 primary。"
+          "name": "type",
+          "type": "'default' | 'primary' | 'dashed' | 'link' | 'text'",
+          "default": "'default'",
+          "description": "语法糖。同时设置 `color` 与 `variant` 时以后者为准。"
         },
         {
           "name": "color",
-          "type": "string",
+          "type": "'default' | 'primary' | 'danger' | 'success' | 'info' | 'warning' | 'help' | 'contrast'",
           "default": "—",
-          "description": "自定义颜色，覆盖 `severity`。"
-        },
-        {
-          "name": "size",
-          "type": "'small' | 'large' | 'sm' | 'md' | 'lg'",
-          "default": "—",
-          "description": "尺寸。默认中等；兼容 `sm` / `lg`。"
+          "description": "颜色轴。"
         },
         {
           "name": "variant",
-          "type": "'outlined' | 'dashed' | 'text' | 'link' | 'ghost' | 'quaternary'",
+          "type": "'solid' | 'outlined' | 'dashed' | 'filled' | 'text' | 'link'",
           "default": "—",
-          "description": "样式变体快捷方式，等价于对应布尔 prop。"
+          "description": "变体轴。"
         },
         {
-          "name": "outlined",
+          "name": "danger",
           "type": "boolean",
           "default": "false",
-          "description": "描边按钮。"
+          "description": "危险色语法糖。设置了 `color` 时以 `color` 为准。"
         },
         {
-          "name": "dashed",
+          "name": "ghost",
           "type": "boolean",
           "default": "false",
-          "description": "虚线边框。"
+          "description": "透明背景。对 `text` / `link` 无效。"
         },
         {
-          "name": "text",
-          "type": "boolean",
-          "default": "false",
-          "description": "文字按钮。"
+          "name": "shape",
+          "type": "'default' | 'circle' | 'round' | 'square'",
+          "default": "'default'",
+          "description": "形状。"
         },
         {
-          "name": "link",
-          "type": "boolean",
-          "default": "false",
-          "description": "链接按钮。"
+          "name": "size",
+          "type": "'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'",
+          "default": "—",
+          "description": "尺寸；可继承 ConfigProvider。"
         },
         {
-          "name": "underline",
+          "name": "block",
           "type": "boolean",
-          "default": "true",
-          "description": "`link` 悬浮下划线。设为 `false` 可关闭。"
+          "default": "false",
+          "description": "宽度撑满父容器。"
         },
         {
-          "name": "ghost",
-          "type": "boolean",
+          "name": "loading",
+          "type": "boolean | { delay?: number; icon?: IconName | Component }",
           "default": "false",
-          "description": "浅色填充，等同于 `text` 的悬浮态。"
+          "description": "加载中；可延迟出现并自定义图标。"
         },
         {
-          "name": "quaternary",
+          "name": "disabled",
           "type": "boolean",
           "default": "false",
-          "description": "极轻量文字按钮。"
+          "description": "禁用；可继承 ConfigProvider。"
         },
         {
-          "name": "plain",
-          "type": "boolean",
-          "default": "false",
-          "description": "浅色填充，等同于 `outlined` 的悬浮态；也可与 `text` / `outlined` 组合弱化。"
+          "name": "htmlType",
+          "type": "'button' | 'submit' | 'reset'",
+          "default": "'button'",
+          "description": "原生 `button` 的 `type`。"
         },
         {
-          "name": "raised",
-          "type": "boolean",
-          "default": "false",
-          "description": "浮起阴影。"
+          "name": "href",
+          "type": "string",
+          "default": "—",
+          "description": "设置后渲染为 `<a>`。"
         },
         {
-          "name": "rounded",
-          "type": "boolean",
-          "default": "false",
-          "description": "全圆角（兼容；推荐 `shape=\"round\"`）。"
+          "name": "target",
+          "type": "string",
+          "default": "—",
+          "description": "链接 `target`，需配合 `href`。"
         },
         {
-          "name": "shape",
-          "type": "'default' | 'circle' | 'round' | 'square'",
-          "default": "'default'",
-          "description": "形状。"
+          "name": "label",
+          "type": "string",
+          "default": "—",
+          "description": "文案；默认插槽优先。"
         },
         {
-          "name": "fluid",
-          "type": "boolean",
-          "default": "false",
-          "description": "宽度撑满容器。"
+          "name": "icon",
+          "type": "IconName | Component",
+          "default": "—",
+          "description": "图标名称或组件。"
         },
         {
-          "name": "loading",
+          "name": "iconPlacement",
+          "type": "'start' | 'end'",
+          "default": "'start'",
+          "description": "图标位置。"
+        },
+        {
+          "name": "iconOnly",
           "type": "boolean",
           "default": "false",
-          "description": "加载中，禁用点击并显示 spinner。"
+          "description": "强制纯图标方形按钮。"
         },
         {
-          "name": "disabled",
+          "name": "autoInsertSpace",
           "type": "boolean",
-          "default": "false",
-          "description": "禁用。"
+          "default": "true",
+          "description": "两个汉字之间插入空格。"
         },
         {
           "name": "ripple",
           "type": "boolean",
           "default": "false",
-          "description": "点击水波纹。设为 `true` 可开启。"
+          "description": "点击水波纹。"
         },
         {
           "name": "press",
           "type": "boolean",
           "default": "false",
-          "description": "按下时轻微缩放。设为 `true` 可开启。"
-        },
-        {
-          "name": "nativeType",
-          "type": "'button' | 'submit' | 'reset'",
-          "default": "'button'",
-          "description": "原生 button type。"
+          "description": "按下缩放。"
         },
         {
           "name": "autofocus",
@@ -2235,11 +2199,11 @@
           "name": "ariaLabel",
           "type": "string",
           "default": "—",
-          "description": "组合的可访问名称。"
+          "description": "组的可访问名称。"
         },
         {
           "name": "pt",
-          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "type": "{ root? }",
           "default": "—",
           "description": "组容器透传。"
         }
@@ -2248,7 +2212,7 @@
         {
           "name": "click",
           "payload": "MouseEvent",
-          "description": "启用状态下点击触发。"
+          "description": "点击时触发；`loading` / `disabled` 时不触发。"
         }
       ],
       "slots": [
@@ -2268,11 +2232,11 @@
       "methods": [
         {
           "name": "focus",
-          "description": "聚焦底层 button。"
+          "description": "聚焦根元素。"
         },
         {
           "name": "ref",
-          "description": "底层 `HTMLButtonElement`。"
+          "description": "根 `HTMLButtonElement` 或 `HTMLAnchorElement`。"
         }
       ],
       "examples": [
@@ -2282,7 +2246,7 @@
           "sectionId": "引入",
           "lang": "ts",
           "preview": false,
-          "code": "import { MButton } from \"morya-ui\";",
+          "code": "import { MButton, MButtonGroup } from 'morya-ui'",
           "locale": "zh-CN"
         },
         {
@@ -2291,7 +2255,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton>Submit</MButton>\n    <MButton label=\"Label Prop\" />\n    <MButton severity=\"secondary\" label=\"Secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Primary\" />\n    <MButton label=\"Default\" />\n    <MButton type=\"dashed\" label=\"Dashed\" />\n    <MButton type=\"text\" label=\"Text\" />\n    <MButton type=\"link\" label=\"Link\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2300,7 +2264,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace wrap>\n    <MButton label=\"Primary\" />\n    <MButton\n      severity=\"secondary\"\n      label=\"Default\"\n    />\n    <MButton\n      variant=\"dashed\"\n      label=\"Dashed\"\n    />\n    <MButton\n      text\n      label=\"Text\"\n    />\n    <MButton\n      link\n      label=\"Link\"\n    />\n    <MButton\n      severity=\"danger\"\n      label=\"Danger\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"medium\">\n    <MFlex gap=\"small\" wrap>\n      <MButton color=\"primary\" variant=\"solid\" label=\"Solid\" />\n      <MButton color=\"primary\" variant=\"outlined\" label=\"Outlined\" />\n      <MButton color=\"primary\" variant=\"dashed\" label=\"Dashed\" />\n      <MButton color=\"primary\" variant=\"filled\" label=\"Filled\" />\n      <MButton color=\"primary\" variant=\"text\" label=\"Text\" />\n      <MButton color=\"primary\" variant=\"link\" label=\"Link\" />\n    </MFlex>\n    <MFlex gap=\"small\" wrap>\n      <MButton color=\"danger\" variant=\"solid\" label=\"Danger\" />\n      <MButton color=\"success\" variant=\"solid\" label=\"Success\" />\n      <MButton color=\"info\" variant=\"filled\" label=\"Info\" />\n      <MButton color=\"warning\" variant=\"outlined\" label=\"Warning\" />\n      <MButton color=\"contrast\" variant=\"solid\" label=\"Contrast\" />\n    </MFlex>\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2309,7 +2273,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace wrap>\n    <MButton label=\"Default\" />\n    <MButton\n      shape=\"round\"\n      label=\"Round\"\n    />\n    <MButton\n      shape=\"circle\"\n      icon=\"search\"\n      icon-only\n      aria-label=\"Search\"\n    />\n    <MButton\n      shape=\"square\"\n      icon=\"edit\"\n      icon-only\n      aria-label=\"Edit\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" icon=\"search\" label=\"Search\" />\n    <MButton icon=\"search\" icon-placement=\"end\" label=\"Search\" />\n    <MButton type=\"primary\" icon=\"plus\" icon-only aria-label=\"Add\" />\n    <MButton shape=\"circle\" icon=\"edit\" aria-label=\"Edit\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2318,7 +2282,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Primary\" />\n    <MButton label=\"Secondary\" severity=\"secondary\" />\n    <MButton label=\"Success\" severity=\"success\" />\n    <MButton label=\"Info\" severity=\"info\" />\n    <MButton label=\"Warn\" severity=\"warn\" />\n    <MButton label=\"Help\" severity=\"help\" />\n    <MButton label=\"Danger\" severity=\"danger\" />\n    <MButton label=\"Contrast\" severity=\"contrast\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" size=\"small\" label=\"Small\" />\n    <MButton type=\"primary\" size=\"medium\" label=\"Medium\" />\n    <MButton type=\"primary\" size=\"large\" label=\"Large\" />\n    <MButton type=\"primary\" size=\"small\" icon=\"search\" icon-only aria-label=\"Search small\" />\n    <MButton type=\"primary\" size=\"large\" icon=\"search\" icon-only aria-label=\"Search large\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2327,7 +2291,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4 w-full\">\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Outlined\" outlined />\n      <MButton label=\"Success\" severity=\"success\" outlined />\n      <MButton label=\"Danger\" severity=\"danger\" outlined />\n    </div>\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Raised\" raised />\n      <MButton label=\"Rounded\" rounded />\n      <MButton label=\"Plain\" plain />\n      <MButton label=\"Plain Text\" text plain />\n    </div>\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Small\" size=\"small\" />\n      <MButton label=\"Large\" size=\"large\" />\n      <MButton label=\"Fluid\" fluid />\n    </div>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" label=\"Default\" />\n    <MButton type=\"primary\" shape=\"round\" label=\"Round\" />\n    <MButton type=\"primary\" shape=\"circle\" icon=\"search\" aria-label=\"Search\" />\n    <MButton type=\"primary\" shape=\"square\" icon=\"plus\" aria-label=\"Add\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2336,7 +2300,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Text\" text />\n    <MButton label=\"Text Danger\" text severity=\"danger\" />\n    <MButton label=\"Link\" link />\n    <MButton label=\"Link No Underline\" link :underline=\"false\" />\n    <MButton label=\"Link Secondary\" link severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" danger label=\"Primary\" />\n    <MButton danger label=\"Default\" />\n    <MButton type=\"dashed\" danger label=\"Dashed\" />\n    <MButton type=\"text\" danger label=\"Text\" />\n    <MButton type=\"link\" danger label=\"Link\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2345,7 +2309,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Ghost\" ghost />\n    <MButton label=\"Ghost Danger\" ghost severity=\"danger\" />\n    <MButton label=\"Quaternary\" quaternary />\n    <MButton label=\"Custom\" color=\"#e11d48\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <div\n    class=\"rounded-md p-4\"\n    style=\"background: linear-gradient(135deg, #0f172a, #1d4ed8)\"\n  >\n    <MFlex gap=\"small\" wrap>\n      <MButton type=\"primary\" ghost label=\"Primary Ghost\" />\n      <MButton ghost label=\"Default Ghost\" />\n      <MButton type=\"dashed\" ghost label=\"Dashed Ghost\" />\n      <MButton type=\"primary\" danger ghost label=\"Danger Ghost\" />\n    </MFlex>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2354,7 +2318,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MButtonGroup } from 'morya-ui'\n</script>\n\n<template>\n  <MButtonGroup aria-label=\"对齐\">\n    <MButton label=\"左\" />\n    <MButton label=\"中\" severity=\"secondary\" />\n    <MButton label=\"右\" severity=\"secondary\" />\n  </MButtonGroup>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MButton, MFlex } from 'morya-ui'\n\nconst loading = ref(false)\n\nfunction toggle() {\n  loading.value = true\n  window.setTimeout(() => {\n    loading.value = false\n  }, 2000)\n}\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Always\" loading />\n    <MButton label=\"Delayed\" :loading=\"{ delay: 400 }\" />\n    <MButton type=\"primary\" :loading=\"loading\" label=\"Click me\" @click=\"toggle\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2363,7 +2327,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton icon=\"check\" label=\"Save\" />\n    <MButton icon=\"search\" label=\"Search\" icon-pos=\"right\" severity=\"secondary\" />\n    <MButton icon=\"plus\" icon-only rounded aria-label=\"Add\" />\n    <MButton icon=\"trash\" icon-only rounded outlined severity=\"danger\" aria-label=\"Delete\" />\n    <MButton label=\"Messages\" badge=\"2\" badge-severity=\"danger\" severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Primary\" disabled />\n    <MButton label=\"Default\" disabled />\n    <MButton type=\"dashed\" label=\"Dashed\" disabled />\n    <MButton type=\"text\" label=\"Text\" disabled />\n    <MButton type=\"link\" label=\"Link\" disabled />\n    <MButton type=\"primary\" danger label=\"Danger\" disabled />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2372,7 +2336,7 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst loading = ref(false)\n\nfunction toggleLoading() {\n  loading.value = true\n  window.setTimeout(() => {\n    loading.value = false\n  }, 900)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Search\" icon=\"search\" :loading=\"loading\" @click=\"toggleLoading\" />\n    <MButton label=\"Always Loading\" loading severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"small\" class=\"w-full\">\n    <MButton type=\"primary\" block label=\"Primary Block\" />\n    <MButton block label=\"Default Block\" />\n    <MButton type=\"dashed\" block label=\"Dashed Block\" />\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2381,7 +2345,34 @@
           "sectionId": "代码演示",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Disabled\" disabled />\n    <MButton label=\"Disabled Outlined\" outlined disabled />\n    <MButton label=\"Disabled Text\" text disabled />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MButtonGroup, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"medium\">\n    <MButtonGroup aria-label=\"行内操作\">\n      <MButton label=\"编辑\" />\n      <MButton label=\"分享\" />\n      <MButton danger label=\"删除\" />\n    </MButtonGroup>\n    <MButtonGroup block aria-label=\"表单操作\">\n      <MButton label=\"取消\" />\n      <MButton type=\"primary\" label=\"确认\" />\n    </MButtonGroup>\n  </MFlex>\n</template>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "代码演示-12",
+          "section": "代码演示",
+          "sectionId": "代码演示",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" ripple label=\"Ripple\" />\n    <MButton type=\"primary\" press label=\"Press\" />\n    <MButton type=\"primary\" ripple press label=\"Both\" />\n  </MFlex>\n</template>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "faq-1",
+          "section": "FAQ",
+          "sectionId": "faq",
+          "lang": "vue",
+          "preview": false,
+          "code": "<MButton type=\"primary\">保存</MButton>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "faq-2",
+          "section": "FAQ",
+          "sectionId": "faq",
+          "lang": "vue",
+          "preview": false,
+          "code": "<MButton color=\"primary\" variant=\"solid\">保存</MButton>",
           "locale": "zh-CN"
         },
         {
@@ -2390,7 +2381,7 @@
           "sectionId": "import",
           "lang": "ts",
           "preview": false,
-          "code": "import { MButton } from \"morya-ui\";",
+          "code": "import { MButton, MButtonGroup } from 'morya-ui'",
           "locale": "en-US"
         },
         {
@@ -2399,7 +2390,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton>Submit</MButton>\n    <MButton label=\"Label Prop\" />\n    <MButton severity=\"secondary\" label=\"Secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Primary\" />\n    <MButton label=\"Default\" />\n    <MButton type=\"dashed\" label=\"Dashed\" />\n    <MButton type=\"text\" label=\"Text\" />\n    <MButton type=\"link\" label=\"Link\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2408,7 +2399,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace wrap>\n    <MButton label=\"Primary\" />\n    <MButton\n      severity=\"secondary\"\n      label=\"Default\"\n    />\n    <MButton\n      variant=\"dashed\"\n      label=\"Dashed\"\n    />\n    <MButton\n      text\n      label=\"Text\"\n    />\n    <MButton\n      link\n      label=\"Link\"\n    />\n    <MButton\n      severity=\"danger\"\n      label=\"Danger\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"medium\">\n    <MFlex gap=\"small\" wrap>\n      <MButton color=\"primary\" variant=\"solid\" label=\"Solid\" />\n      <MButton color=\"primary\" variant=\"outlined\" label=\"Outlined\" />\n      <MButton color=\"primary\" variant=\"dashed\" label=\"Dashed\" />\n      <MButton color=\"primary\" variant=\"filled\" label=\"Filled\" />\n      <MButton color=\"primary\" variant=\"text\" label=\"Text\" />\n      <MButton color=\"primary\" variant=\"link\" label=\"Link\" />\n    </MFlex>\n    <MFlex gap=\"small\" wrap>\n      <MButton color=\"danger\" variant=\"solid\" label=\"Danger\" />\n      <MButton color=\"success\" variant=\"solid\" label=\"Success\" />\n      <MButton color=\"info\" variant=\"filled\" label=\"Info\" />\n      <MButton color=\"warning\" variant=\"outlined\" label=\"Warning\" />\n      <MButton color=\"contrast\" variant=\"solid\" label=\"Contrast\" />\n    </MFlex>\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2417,7 +2408,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace wrap>\n    <MButton label=\"Default\" />\n    <MButton\n      shape=\"round\"\n      label=\"Round\"\n    />\n    <MButton\n      shape=\"circle\"\n      icon=\"search\"\n      icon-only\n      aria-label=\"Search\"\n    />\n    <MButton\n      shape=\"square\"\n      icon=\"edit\"\n      icon-only\n      aria-label=\"Edit\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" icon=\"search\" label=\"Search\" />\n    <MButton icon=\"search\" icon-placement=\"end\" label=\"Search\" />\n    <MButton type=\"primary\" icon=\"plus\" icon-only aria-label=\"Add\" />\n    <MButton shape=\"circle\" icon=\"edit\" aria-label=\"Edit\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2426,7 +2417,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Primary\" />\n    <MButton label=\"Secondary\" severity=\"secondary\" />\n    <MButton label=\"Success\" severity=\"success\" />\n    <MButton label=\"Info\" severity=\"info\" />\n    <MButton label=\"Warn\" severity=\"warn\" />\n    <MButton label=\"Help\" severity=\"help\" />\n    <MButton label=\"Danger\" severity=\"danger\" />\n    <MButton label=\"Contrast\" severity=\"contrast\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" size=\"small\" label=\"Small\" />\n    <MButton type=\"primary\" size=\"medium\" label=\"Medium\" />\n    <MButton type=\"primary\" size=\"large\" label=\"Large\" />\n    <MButton type=\"primary\" size=\"small\" icon=\"search\" icon-only aria-label=\"Search small\" />\n    <MButton type=\"primary\" size=\"large\" icon=\"search\" icon-only aria-label=\"Search large\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2435,7 +2426,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4 w-full\">\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Outlined\" outlined />\n      <MButton label=\"Success\" severity=\"success\" outlined />\n      <MButton label=\"Danger\" severity=\"danger\" outlined />\n    </div>\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Raised\" raised />\n      <MButton label=\"Rounded\" rounded />\n      <MButton label=\"Plain\" plain />\n      <MButton label=\"Plain Text\" text plain />\n    </div>\n    <div class=\"flex flex-wrap gap-3 items-center\">\n      <MButton label=\"Small\" size=\"small\" />\n      <MButton label=\"Large\" size=\"large\" />\n      <MButton label=\"Fluid\" fluid />\n    </div>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap align=\"center\">\n    <MButton type=\"primary\" label=\"Default\" />\n    <MButton type=\"primary\" shape=\"round\" label=\"Round\" />\n    <MButton type=\"primary\" shape=\"circle\" icon=\"search\" aria-label=\"Search\" />\n    <MButton type=\"primary\" shape=\"square\" icon=\"plus\" aria-label=\"Add\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2444,7 +2435,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Text\" text />\n    <MButton label=\"Text Danger\" text severity=\"danger\" />\n    <MButton label=\"Link\" link />\n    <MButton label=\"Link No Underline\" link :underline=\"false\" />\n    <MButton label=\"Link Secondary\" link severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" danger label=\"Primary\" />\n    <MButton danger label=\"Default\" />\n    <MButton type=\"dashed\" danger label=\"Dashed\" />\n    <MButton type=\"text\" danger label=\"Text\" />\n    <MButton type=\"link\" danger label=\"Link\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2453,7 +2444,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Ghost\" ghost />\n    <MButton label=\"Ghost Danger\" ghost severity=\"danger\" />\n    <MButton label=\"Quaternary\" quaternary />\n    <MButton label=\"Custom\" color=\"#e11d48\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <div\n    class=\"rounded-md p-4\"\n    style=\"background: linear-gradient(135deg, #0f172a, #1d4ed8)\"\n  >\n    <MFlex gap=\"small\" wrap>\n      <MButton type=\"primary\" ghost label=\"Primary Ghost\" />\n      <MButton ghost label=\"Default Ghost\" />\n      <MButton type=\"dashed\" ghost label=\"Dashed Ghost\" />\n      <MButton type=\"primary\" danger ghost label=\"Danger Ghost\" />\n    </MFlex>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2462,7 +2453,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MButtonGroup } from 'morya-ui'\n</script>\n\n<template>\n  <MButtonGroup aria-label=\"Align\">\n    <MButton label=\"Left\" />\n    <MButton label=\"Center\" severity=\"secondary\" />\n    <MButton label=\"Right\" severity=\"secondary\" />\n  </MButtonGroup>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { MButton, MFlex } from 'morya-ui'\n\nconst loading = ref(false)\n\nfunction toggle() {\n  loading.value = true\n  window.setTimeout(() => {\n    loading.value = false\n  }, 2000)\n}\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Always\" loading />\n    <MButton label=\"Delayed\" :loading=\"{ delay: 400 }\" />\n    <MButton type=\"primary\" :loading=\"loading\" label=\"Click me\" @click=\"toggle\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2471,7 +2462,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton icon=\"check\" label=\"Save\" />\n    <MButton icon=\"search\" label=\"Search\" icon-pos=\"right\" severity=\"secondary\" />\n    <MButton icon=\"plus\" icon-only rounded aria-label=\"Add\" />\n    <MButton icon=\"trash\" icon-only rounded outlined severity=\"danger\" aria-label=\"Delete\" />\n    <MButton label=\"Messages\" badge=\"2\" badge-severity=\"danger\" severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" label=\"Primary\" disabled />\n    <MButton label=\"Default\" disabled />\n    <MButton type=\"dashed\" label=\"Dashed\" disabled />\n    <MButton type=\"text\" label=\"Text\" disabled />\n    <MButton type=\"link\" label=\"Link\" disabled />\n    <MButton type=\"primary\" danger label=\"Danger\" disabled />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2480,7 +2471,7 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst loading = ref(false)\n\nfunction toggleLoading() {\n  loading.value = true\n  window.setTimeout(() => {\n    loading.value = false\n  }, 900)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Search\" icon=\"search\" :loading=\"loading\" @click=\"toggleLoading\" />\n    <MButton label=\"Always Loading\" loading severity=\"secondary\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"small\" class=\"w-full\">\n    <MButton type=\"primary\" block label=\"Primary Block\" />\n    <MButton block label=\"Default Block\" />\n    <MButton type=\"dashed\" block label=\"Dashed Block\" />\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -2489,114 +2480,141 @@
           "sectionId": "examples",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Disabled\" disabled />\n    <MButton label=\"Disabled Outlined\" outlined disabled />\n    <MButton label=\"Disabled Text\" text disabled />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MButtonGroup, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical gap=\"medium\">\n    <MButtonGroup aria-label=\"Row actions\">\n      <MButton label=\"Edit\" />\n      <MButton label=\"Share\" />\n      <MButton danger label=\"Delete\" />\n    </MButtonGroup>\n    <MButtonGroup block aria-label=\"Form actions\">\n      <MButton label=\"Cancel\" />\n      <MButton type=\"primary\" label=\"Confirm\" />\n    </MButtonGroup>\n  </MFlex>\n</template>",
+          "locale": "en-US"
+        },
+        {
+          "id": "examples-12",
+          "section": "Examples",
+          "sectionId": "examples",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex gap=\"small\" wrap>\n    <MButton type=\"primary\" ripple label=\"Ripple\" />\n    <MButton type=\"primary\" press label=\"Press\" />\n    <MButton type=\"primary\" ripple press label=\"Both\" />\n  </MFlex>\n</template>",
+          "locale": "en-US"
+        },
+        {
+          "id": "faq-1",
+          "section": "FAQ",
+          "sectionId": "faq",
+          "lang": "vue",
+          "preview": false,
+          "code": "<MButton type=\"primary\">Save</MButton>",
+          "locale": "en-US"
+        },
+        {
+          "id": "faq-2",
+          "section": "FAQ",
+          "sectionId": "faq",
+          "lang": "vue",
+          "preview": false,
+          "code": "<MButton color=\"primary\" variant=\"solid\">Save</MButton>",
           "locale": "en-US"
         }
       ],
       "locales": {
         "zh-CN": {
           "title": "Button",
-          "description": "按钮用于触发即时动作。",
+          "description": "触发即时操作的按钮。",
           "sections": [
             {
               "id": "overview",
               "title": "",
-              "body": "# Button\n\n按钮用于触发即时动作。"
+              "body": "# Button\n\n触发提交、确认、导航等即时操作。"
             },
             {
               "id": "何时使用",
               "title": "何时使用",
-              "body": "- 需要触发表单提交、确认、导航或其它即时操作时。\n- 页面主操作使用默认（primary）按钮；次要操作用 `severity=\"secondary\"` 或 `outlined` / `text`。\n- 危险、破坏性操作用 `severity=\"danger\"`；轻量内联操作用 `text` 或 `link`。\n- 相邻一组互斥或相关操作用 `MButtonGroup`。"
+              "body": "- 主操作：`type=\"primary\"`，同一操作区通常只放一个。\n- 次操作：默认按钮，或 `type=\"dashed\"` / `type=\"text\"`。\n- 内联导航或弱操作：`type=\"link\"` / `type=\"text\"`。\n- 破坏性操作：加 `danger`，并配合确认。\n- 相邻操作需要拼成一组时：用 `MButtonGroup`（仅视觉拼组）。"
             },
             {
               "id": "引入",
               "title": "引入",
-              "body": "```ts\nimport { MButton } from \"morya-ui\";\n```"
+              "body": "```ts\nimport { MButton, MButtonGroup } from 'morya-ui'\n```"
             },
             {
               "id": "代码演示",
               "title": "代码演示",
-              "body": "### 基础用法\n\n通过默认插槽或 `label` 展示按钮文案。\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### 类型\n\n常用组合：`severity=\"secondary\"` 默认样式、`variant=\"dashed\"` 虚线、`text` / `link` 文字链、`severity=\"danger\"` 危险、`fluid` 通栏。\n\n```vue preview src=\"./demos/VariantTypes.vue\"\n\n```\n\n### Shape\n\n`shape`：`default` / `round` / `circle` / `square`。旧 `rounded` 等价于 `shape=\"round\"`。\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Severity\n\n使用 `severity` 定义按钮语义色；省略时为 primary。\n\n```vue preview src=\"./demos/Severity.vue\"\n\n```\n\n### Styles\n\n`outlined`、`text`、`link`、`raised`、`rounded`、`plain` 可自由组合。\n\n```vue preview src=\"./demos/Styles.vue\"\n\n```\n\n### Text & Link\n\n`text` 为轻量文字按钮；`link` 呈现为无背景的内联链接样式，默认悬浮下划线，设 `:underline=\"false\"` 可关闭。二者均可与 `severity` 组合。\n\n```vue preview src=\"./demos/TextAndLink.vue\"\n\n```\n\n### Ghost & Quaternary\n\n`ghost` 为浅色填充，等同于 `text` 的悬浮态；`quaternary` 更克制，适合工具栏次要操作。也可通过 `variant` 指定。\n\n```vue preview src=\"./demos/GhostAndQuaternary.vue\"\n\n```\n\n### Button Group\n\n`MButtonGroup` 将相邻按钮拼成一组。\n\n```vue preview src=\"./demos/ButtonGroup.zh.vue\"\n\n```\n\n### Icons & Badge\n\n支持 `icon`、`iconPos`、`iconOnly`，以及 `badge` 徽标。\n\n```vue preview src=\"./demos/IconsAndBadge.vue\"\n\n```\n\n### Loading\n\n`loading` 状态下显示 spinner 并阻止点击。\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```"
+              "body": "### 基础用法\n\n`type` 是 `color` + `variant` 的语法糖。省略时为默认描边按钮。\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### 颜色与变体\n\n需要更细控制时直接设 `color` 与 `variant`；二者同时存在时优先于 `type`。\n\n```vue preview src=\"./demos/ColorVariant.vue\"\n\n```\n\n### 图标\n\n`icon` 可配名称或组件；`iconPlacement` 控制位置；纯图标请提供 `ariaLabel`。\n\n```vue preview src=\"./demos/Icon.vue\"\n\n```\n\n### 尺寸\n\n```vue preview src=\"./demos/Size.vue\"\n\n```\n\n### 形状\n\n`shape`：`default` / `round` / `circle` / `square`。\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### 危险按钮\n\n`danger` 将颜色切到危险色，并保留当前 `type` / `variant` 形态。\n\n```vue preview src=\"./demos/Danger.vue\"\n\n```\n\n### 幽灵按钮\n\n`ghost` 让背景透明，适合深色或复杂底图。对 `text` / `link` 无效。\n\n```vue preview src=\"./demos/Ghost.vue\"\n\n```\n\n### 加载中\n\n`loading` 可为布尔值，或 `{ delay, icon }`。加载中会禁用点击。\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### 不可用\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n### Block\n\n`block` 让按钮宽度撑满父容器。\n\n```vue preview src=\"./demos/Block.vue\"\n\n```\n\n### 按钮组\n\n`MButtonGroup` 只做视觉拼组（圆角与边框衔接），没有选中态。需要互斥切换时用 [`SelectButton`](/components/SelectButton)。\n\n```vue preview src=\"./demos/ButtonGroup.zh.vue\"\n\n```\n\n### 水波纹与按压\n\n`ripple` / `press` 默认关闭，需要时显式开启。\n\n```vue preview src=\"./demos/RipplePress.vue\"\n\n```"
             },
             {
               "id": "api",
               "title": "API",
-              "body": "### Props\n\n| 参数            | 类型                                                                               | 默认值      | 说明                                                                        |\n| --------------- | ---------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------- |\n| `label`         | `string`                                                                           | —           | 按钮文案。存在默认插槽内容时以插槽为准。                                    |\n| `icon`          | `IconName \\| Component`                                                            | —           | 图标名称或自定义组件。                                                      |\n| `iconPos`       | `'left' \\| 'right' \\| 'top' \\| 'bottom'`                                           | `'left'`    | 图标相对标签的位置。                                                        |\n| `iconOnly`      | `boolean`                                                                          | `false`     | 强制方形纯图标按钮。                                                        |\n| `badge`         | `string`                                                                           | —           | 徽标文本。                                                                  |\n| `badgeSeverity` | `'secondary' \\| 'info' \\| 'success' \\| 'warn' \\| 'danger' \\| 'contrast' \\| null`   | `null`      | 徽标语义色。                                                                |\n| `severity`      | `'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast'` | —           | 语义色。省略时为 primary。                                                  |\n| `color`         | `string`                                                                           | —           | 自定义颜色，覆盖 `severity`。                                               |\n| `size`          | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'`                                       | —           | 尺寸。默认中等；兼容 `sm` / `lg`。                                          |\n| `variant`       | `'outlined' \\| 'dashed' \\| 'text' \\| 'link' \\| 'ghost' \\| 'quaternary'`            | —           | 样式变体快捷方式，等价于对应布尔 prop。                                     |\n| `outlined`      | `boolean`                                                                          | `false`     | 描边按钮。                                                                  |\n| `dashed`        | `boolean`                                                                          | `false`     | 虚线边框。                                                                  |\n| `text`          | `boolean`                                                                          | `false`     | 文字按钮。                                                                  |\n| `link`          | `boolean`                                                                          | `false`     | 链接按钮。                                                                  |\n| `underline`     | `boolean`                                                                          | `true`      | `link` 悬浮下划线。设为 `false` 可关闭。                                    |\n| `ghost`         | `boolean`                                                                          | `false`     | 浅色填充，等同于 `text` 的悬浮态。                                          |\n| `quaternary`    | `boolean`                                                                          | `false`     | 极轻量文字按钮。                                                            |\n| `plain`         | `boolean`                                                                          | `false`     | 浅色填充，等同于 `outlined` 的悬浮态；也可与 `text` / `outlined` 组合弱化。 |\n| `raised`        | `boolean`                                                                          | `false`     | 浮起阴影。                                                                  |\n| `rounded`       | `boolean`                                                                          | `false`     | 全圆角（兼容；推荐 `shape=\"round\"`）。                                      |\n| `shape`         | `'default' \\| 'circle' \\| 'round' \\| 'square'`                                     | `'default'` | 形状。                                                                      |\n| `fluid`         | `boolean`                                                                          | `false`     | 宽度撑满容器。                                                              |\n| `loading`       | `boolean`                                                                          | `false`     | 加载中，禁用点击并显示 spinner。                                            |\n| `disabled`      | `boolean`                                                                          | `false`     | 禁用。                                                                      |\n| `ripple`        | `boolean`                                                                          | `false`     | 点击水波纹。设为 `true` 可开启。                                            |\n| `press`         | `boolean`                                                                          | `false`     | 按下时轻微缩放。设为 `true` 可开启。                                        |\n| `nativeType`    | `'button' \\| 'submit' \\| 'reset'`                                                  | `'button'`  | 原生 button type。                                                          |\n| `autofocus`     | `boolean`                                                                          | `false`     | 原生 autofocus。                                                            |\n| `ariaLabel`     | `string`                                                                           | —           | 可访问名称；图标按钮建议提供。                                              |\n\n### Events\n\n| 事件名  | 参数         | 说明                 |\n| ------- | ------------ | -------------------- |\n| `click` | `MouseEvent` | 启用状态下点击触发。 |\n\n### Slots\n\n| 插槽名        | 说明                       |\n| ------------- | -------------------------- |\n| `default`     | 按钮内容，优先于 `label`。 |\n| `icon`        | 自定义图标。               |\n| `loadingicon` | 自定义加载图标。           |\n\n### Instance\n\n| 方法 / 属性 | 说明                       |\n| ----------- | -------------------------- |\n| `focus()`   | 聚焦底层 button。          |\n| `ref`       | 底层 `HTMLButtonElement`。 |\n\n### Props — ButtonGroup\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `fluid` | `boolean` | `false` | 宽度撑满容器。 |\n| `ariaLabel` | `string` | — | 组合的可访问名称。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 组容器透传。 |"
+              "body": "推荐组合顺序：`type` → `shape` → `size` → `loading` → `disabled`。\n\n### Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `type` | `'default' \\| 'primary' \\| 'dashed' \\| 'link' \\| 'text'` | `'default'` | 语法糖。同时设置 `color` 与 `variant` 时以后者为准。 |\n| `color` | `'default' \\| 'primary' \\| 'danger' \\| 'success' \\| 'info' \\| 'warning' \\| 'help' \\| 'contrast'` | — | 颜色轴。 |\n| `variant` | `'solid' \\| 'outlined' \\| 'dashed' \\| 'filled' \\| 'text' \\| 'link'` | — | 变体轴。 |\n| `danger` | `boolean` | `false` | 危险色语法糖。设置了 `color` 时以 `color` 为准。 |\n| `ghost` | `boolean` | `false` | 透明背景。对 `text` / `link` 无效。 |\n| `shape` | `'default' \\| 'circle' \\| 'round' \\| 'square'` | `'default'` | 形状。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；可继承 ConfigProvider。 |\n| `block` | `boolean` | `false` | 宽度撑满父容器。 |\n| `loading` | `boolean \\| { delay?: number; icon?: IconName \\| Component }` | `false` | 加载中；可延迟出现并自定义图标。 |\n| `disabled` | `boolean` | `false` | 禁用；可继承 ConfigProvider。 |\n| `htmlType` | `'button' \\| 'submit' \\| 'reset'` | `'button'` | 原生 `button` 的 `type`。 |\n| `href` | `string` | — | 设置后渲染为 `<a>`。 |\n| `target` | `string` | — | 链接 `target`，需配合 `href`。 |\n| `label` | `string` | — | 文案；默认插槽优先。 |\n| `icon` | `IconName \\| Component` | — | 图标名称或组件。 |\n| `iconPlacement` | `'start' \\| 'end'` | `'start'` | 图标位置。 |\n| `iconOnly` | `boolean` | `false` | 强制纯图标方形按钮。 |\n| `autoInsertSpace` | `boolean` | `true` | 两个汉字之间插入空格。 |\n| `ripple` | `boolean` | `false` | 点击水波纹。 |\n| `press` | `boolean` | `false` | 按下缩放。 |\n| `autofocus` | `boolean` | `false` | 原生 autofocus。 |\n| `ariaLabel` | `string` | — | 可访问名称；纯图标按钮建议提供。 |\n| `pt` | `{ root?, icon?, content? }` | — | 语义结构透传。 |\n\n### Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `click` | `MouseEvent` | 点击时触发；`loading` / `disabled` 时不触发。 |\n\n### Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 按钮内容，优先于 `label`。 |\n| `icon` | 自定义图标。 |\n| `loadingicon` | 自定义加载图标。 |\n\n### Instance\n\n| 方法 / 属性 | 说明 |\n| --- | --- |\n| `focus()` | 聚焦根元素。 |\n| `ref` | 根 `HTMLButtonElement` 或 `HTMLAnchorElement`。 |\n\n### MButtonGroup Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `block` | `boolean` | `false` | 宽度撑满父容器。 |\n| `ariaLabel` | `string` | — | 组的可访问名称。 |\n| `pt` | `{ root? }` | — | 组容器透传。 |"
             },
             {
               "id": "design-token",
               "title": "Design Token",
-              "body": "复用全局 `--m-*` 令牌，见[设计令牌](/docs/design-tokens)。组件级 `--m-button-*` 表将在后续补充。"
+              "body": "复用全局 `--m-*` 令牌，见[设计令牌](/docs/design-tokens)。按钮在根节点暴露 `--m-button-*`（尺寸、圆角、色阶、填充透明度、动效等），主题切换时跟随 `--m-color-*` / `--m-control-*` / `--m-motion-*`。"
             },
             {
               "id": "semantic-dom",
               "title": "Semantic DOM",
-              "body": "`MButton` 是叶子组件：根节点即原生 `<button class=\"m-button\">`，`class` / `style` / 事件直接落在该元素上（见[样式与 attrs](/docs/attrs)、[Common Props](/docs/common-props)）。\n\n```text\nbutton.m-button                 ← 根（交互元素）\n  span.m-button__ripple         ← 可选：ripple 层\n  span.m-button__icon           ← 图标 / loading spinner（aria-hidden）\n    span.m-button__spinner      ← loading 时\n  span.m-button__label          ← 文案（插槽或 label）\n  span.m-button__badge*         ← 可选徽标\n```\n\n`MButton` 本身不暴露 `pt`；拼组用 `MButtonGroup` 的 `pt.root` 修改组容器。绑定样式时优先针对 `.m-button`，再按需覆盖 `__icon` / `__label` / `__badge`。"
+              "body": "根节点即交互元素：有 `href` 时为 `<a class=\"m-button\">`，否则为 `<button class=\"m-button\">`。\n\n```text\nbutton.m-button / a.m-button\n  span.m-button__ripple*   ← ripple 开启时\n  span.m-button__icon*     ← 图标 / loading\n  span.m-button__label*    ← 文案\n```\n\n可用 `pt.root` / `pt.icon` / `pt.content` 覆盖各节点。更多约定见[样式与 attrs](/docs/attrs)、[Common Props](/docs/common-props)。"
             },
             {
               "id": "faq",
               "title": "FAQ",
-              "body": "### `severity` 和 `variant` 有什么区别？\n\n`severity` 控制语义色（如 `danger`、`success`）；省略时为 primary。`variant`（或对应布尔 prop）控制样式形态，如 `outlined`、`text`、`link`、`ghost`。二者可组合，例如 `severity=\"danger\"` + `variant=\"outlined\"`。\n\n### `text` 和 `link` 该怎么选？`rounded` 和 `shape` 呢？\n\n`text` 是轻量文字按钮；`link` 更接近内联链接（默认悬浮下划线）。形状优先用 `shape`（`round` / `circle` / `square`）；旧的 `rounded` 仍可用，等价于 `shape=\"round\"`。"
+              "body": "### `type` 和 `color` / `variant` 怎么选？\n\n日常优先用 `type`。需要跨色系细调时再用 `color` + `variant`；二者齐全时覆盖 `type`。\n\n| `type` | 等价于 |\n| --- | --- |\n| `primary` | `color=\"primary\"` + `variant=\"solid\"` |\n| `default` | `color=\"default\"` + `variant=\"outlined\"` |\n| `dashed` | `color=\"default\"` + `variant=\"dashed\"` |\n| `text` | `color=\"default\"` + `variant=\"text\"` |\n| `link` | `color=\"link\"` + `variant=\"link\"` |\n\n```vue\n<MButton type=\"primary\">保存</MButton>\n```\n\n等同于\n\n```vue\n<MButton color=\"primary\" variant=\"solid\">保存</MButton>\n```\n\n### Button 的 `color` 和其它组件的 `severity`？\n\nButton 使用 `color` / `variant`。Badge、Tag、Alert、Message、Toast 等反馈组件仍使用 `severity`。\n\n### `text` 和 `link` 怎么区分？\n\n`type=\"text\"`（或 `variant=\"text\"`）保留按钮热区与高度；`type=\"link\"` 更接近内联链接。"
             },
             {
               "id": "无障碍",
               "title": "无障碍",
-              "body": "- 渲染原生 `<button>`。\n- 纯图标按钮请设置 `ariaLabel`（或可访问的文本标签）。\n- `loading` 时设置 `aria-busy`，并禁用交互。"
+              "body": "- 默认渲染原生 `<button>`；设置 `href` 时渲染 `<a>`。\n- 纯图标按钮请设置 `ariaLabel`（或可见文本）。\n- `loading` 时设置 `aria-busy`，并阻止点击。\n- 禁用的链接按钮会去掉 `href`，并设置 `aria-disabled` 与 `tabindex=\"-1\"`。"
             }
           ],
-          "markdown": "---\ntitle: Button\ncategory: 01 / BASIC\ndescription: 按钮用于触发即时动作。\n---\n\n# Button\n\n按钮用于触发即时动作。\n\n## 何时使用\n\n- 需要触发表单提交、确认、导航或其它即时操作时。\n- 页面主操作使用默认（primary）按钮；次要操作用 `severity=\"secondary\"` 或 `outlined` / `text`。\n- 危险、破坏性操作用 `severity=\"danger\"`；轻量内联操作用 `text` 或 `link`。\n- 相邻一组互斥或相关操作用 `MButtonGroup`。\n\n## 引入\n\n```ts\nimport { MButton } from \"morya-ui\";\n```\n\n## 代码演示\n\n### 基础用法\n\n通过默认插槽或 `label` 展示按钮文案。\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### 类型\n\n常用组合：`severity=\"secondary\"` 默认样式、`variant=\"dashed\"` 虚线、`text` / `link` 文字链、`severity=\"danger\"` 危险、`fluid` 通栏。\n\n```vue preview src=\"./demos/VariantTypes.vue\"\n\n```\n\n### Shape\n\n`shape`：`default` / `round` / `circle` / `square`。旧 `rounded` 等价于 `shape=\"round\"`。\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Severity\n\n使用 `severity` 定义按钮语义色；省略时为 primary。\n\n```vue preview src=\"./demos/Severity.vue\"\n\n```\n\n### Styles\n\n`outlined`、`text`、`link`、`raised`、`rounded`、`plain` 可自由组合。\n\n```vue preview src=\"./demos/Styles.vue\"\n\n```\n\n### Text & Link\n\n`text` 为轻量文字按钮；`link` 呈现为无背景的内联链接样式，默认悬浮下划线，设 `:underline=\"false\"` 可关闭。二者均可与 `severity` 组合。\n\n```vue preview src=\"./demos/TextAndLink.vue\"\n\n```\n\n### Ghost & Quaternary\n\n`ghost` 为浅色填充，等同于 `text` 的悬浮态；`quaternary` 更克制，适合工具栏次要操作。也可通过 `variant` 指定。\n\n```vue preview src=\"./demos/GhostAndQuaternary.vue\"\n\n```\n\n### Button Group\n\n`MButtonGroup` 将相邻按钮拼成一组。\n\n```vue preview src=\"./demos/ButtonGroup.zh.vue\"\n\n```\n\n### Icons & Badge\n\n支持 `icon`、`iconPos`、`iconOnly`，以及 `badge` 徽标。\n\n```vue preview src=\"./demos/IconsAndBadge.vue\"\n\n```\n\n### Loading\n\n`loading` 状态下显示 spinner 并阻止点击。\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n## API\n\n### Props\n\n| 参数            | 类型                                                                               | 默认值      | 说明                                                                        |\n| --------------- | ---------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------- |\n| `label`         | `string`                                                                           | —           | 按钮文案。存在默认插槽内容时以插槽为准。                                    |\n| `icon`          | `IconName \\| Component`                                                            | —           | 图标名称或自定义组件。                                                      |\n| `iconPos`       | `'left' \\| 'right' \\| 'top' \\| 'bottom'`                                           | `'left'`    | 图标相对标签的位置。                                                        |\n| `iconOnly`      | `boolean`                                                                          | `false`     | 强制方形纯图标按钮。                                                        |\n| `badge`         | `string`                                                                           | —           | 徽标文本。                                                                  |\n| `badgeSeverity` | `'secondary' \\| 'info' \\| 'success' \\| 'warn' \\| 'danger' \\| 'contrast' \\| null`   | `null`      | 徽标语义色。                                                                |\n| `severity`      | `'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast'` | —           | 语义色。省略时为 primary。                                                  |\n| `color`         | `string`                                                                           | —           | 自定义颜色，覆盖 `severity`。                                               |\n| `size`          | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'`                                       | —           | 尺寸。默认中等；兼容 `sm` / `lg`。                                          |\n| `variant`       | `'outlined' \\| 'dashed' \\| 'text' \\| 'link' \\| 'ghost' \\| 'quaternary'`            | —           | 样式变体快捷方式，等价于对应布尔 prop。                                     |\n| `outlined`      | `boolean`                                                                          | `false`     | 描边按钮。                                                                  |\n| `dashed`        | `boolean`                                                                          | `false`     | 虚线边框。                                                                  |\n| `text`          | `boolean`                                                                          | `false`     | 文字按钮。                                                                  |\n| `link`          | `boolean`                                                                          | `false`     | 链接按钮。                                                                  |\n| `underline`     | `boolean`                                                                          | `true`      | `link` 悬浮下划线。设为 `false` 可关闭。                                    |\n| `ghost`         | `boolean`                                                                          | `false`     | 浅色填充，等同于 `text` 的悬浮态。                                          |\n| `quaternary`    | `boolean`                                                                          | `false`     | 极轻量文字按钮。                                                            |\n| `plain`         | `boolean`                                                                          | `false`     | 浅色填充，等同于 `outlined` 的悬浮态；也可与 `text` / `outlined` 组合弱化。 |\n| `raised`        | `boolean`                                                                          | `false`     | 浮起阴影。                                                                  |\n| `rounded`       | `boolean`                                                                          | `false`     | 全圆角（兼容；推荐 `shape=\"round\"`）。                                      |\n| `shape`         | `'default' \\| 'circle' \\| 'round' \\| 'square'`                                     | `'default'` | 形状。                                                                      |\n| `fluid`         | `boolean`                                                                          | `false`     | 宽度撑满容器。                                                              |\n| `loading`       | `boolean`                                                                          | `false`     | 加载中，禁用点击并显示 spinner。                                            |\n| `disabled`      | `boolean`                                                                          | `false`     | 禁用。                                                                      |\n| `ripple`        | `boolean`                                                                          | `false`     | 点击水波纹。设为 `true` 可开启。                                            |\n| `press`         | `boolean`                                                                          | `false`     | 按下时轻微缩放。设为 `true` 可开启。                                        |\n| `nativeType`    | `'button' \\| 'submit' \\| 'reset'`                                                  | `'button'`  | 原生 button type。                                                          |\n| `autofocus`     | `boolean`                                                                          | `false`     | 原生 autofocus。                                                            |\n| `ariaLabel`     | `string`                                                                           | —           | 可访问名称；图标按钮建议提供。                                              |\n\n### Events\n\n| 事件名  | 参数         | 说明                 |\n| ------- | ------------ | -------------------- |\n| `click` | `MouseEvent` | 启用状态下点击触发。 |\n\n### Slots\n\n| 插槽名        | 说明                       |\n| ------------- | -------------------------- |\n| `default`     | 按钮内容，优先于 `label`。 |\n| `icon`        | 自定义图标。               |\n| `loadingicon` | 自定义加载图标。           |\n\n### Instance\n\n| 方法 / 属性 | 说明                       |\n| ----------- | -------------------------- |\n| `focus()`   | 聚焦底层 button。          |\n| `ref`       | 底层 `HTMLButtonElement`。 |\n\n### Props — ButtonGroup\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `fluid` | `boolean` | `false` | 宽度撑满容器。 |\n| `ariaLabel` | `string` | — | 组合的可访问名称。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 组容器透传。 |\n\n## Design Token\n\n复用全局 `--m-*` 令牌，见[设计令牌](/docs/design-tokens)。组件级 `--m-button-*` 表将在后续补充。\n\n## Semantic DOM\n\n`MButton` 是叶子组件：根节点即原生 `<button class=\"m-button\">`，`class` / `style` / 事件直接落在该元素上（见[样式与 attrs](/docs/attrs)、[Common Props](/docs/common-props)）。\n\n```text\nbutton.m-button                 ← 根（交互元素）\n  span.m-button__ripple         ← 可选：ripple 层\n  span.m-button__icon           ← 图标 / loading spinner（aria-hidden）\n    span.m-button__spinner      ← loading 时\n  span.m-button__label          ← 文案（插槽或 label）\n  span.m-button__badge*         ← 可选徽标\n```\n\n`MButton` 本身不暴露 `pt`；拼组用 `MButtonGroup` 的 `pt.root` 修改组容器。绑定样式时优先针对 `.m-button`，再按需覆盖 `__icon` / `__label` / `__badge`。\n\n## FAQ\n\n### `severity` 和 `variant` 有什么区别？\n\n`severity` 控制语义色（如 `danger`、`success`）；省略时为 primary。`variant`（或对应布尔 prop）控制样式形态，如 `outlined`、`text`、`link`、`ghost`。二者可组合，例如 `severity=\"danger\"` + `variant=\"outlined\"`。\n\n### `text` 和 `link` 该怎么选？`rounded` 和 `shape` 呢？\n\n`text` 是轻量文字按钮；`link` 更接近内联链接（默认悬浮下划线）。形状优先用 `shape`（`round` / `circle` / `square`）；旧的 `rounded` 仍可用，等价于 `shape=\"round\"`。\n\n## 无障碍\n\n- 渲染原生 `<button>`。\n- 纯图标按钮请设置 `ariaLabel`（或可访问的文本标签）。\n- `loading` 时设置 `aria-busy`，并禁用交互。\n"
+          "markdown": "---\ntitle: Button\ncategory: 01 / BASIC\ndescription: 触发即时操作的按钮。\n---\n\n# Button\n\n触发提交、确认、导航等即时操作。\n\n## 何时使用\n\n- 主操作：`type=\"primary\"`，同一操作区通常只放一个。\n- 次操作：默认按钮，或 `type=\"dashed\"` / `type=\"text\"`。\n- 内联导航或弱操作：`type=\"link\"` / `type=\"text\"`。\n- 破坏性操作：加 `danger`，并配合确认。\n- 相邻操作需要拼成一组时：用 `MButtonGroup`（仅视觉拼组）。\n\n## 引入\n\n```ts\nimport { MButton, MButtonGroup } from 'morya-ui'\n```\n\n## 代码演示\n\n### 基础用法\n\n`type` 是 `color` + `variant` 的语法糖。省略时为默认描边按钮。\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### 颜色与变体\n\n需要更细控制时直接设 `color` 与 `variant`；二者同时存在时优先于 `type`。\n\n```vue preview src=\"./demos/ColorVariant.vue\"\n\n```\n\n### 图标\n\n`icon` 可配名称或组件；`iconPlacement` 控制位置；纯图标请提供 `ariaLabel`。\n\n```vue preview src=\"./demos/Icon.vue\"\n\n```\n\n### 尺寸\n\n```vue preview src=\"./demos/Size.vue\"\n\n```\n\n### 形状\n\n`shape`：`default` / `round` / `circle` / `square`。\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### 危险按钮\n\n`danger` 将颜色切到危险色，并保留当前 `type` / `variant` 形态。\n\n```vue preview src=\"./demos/Danger.vue\"\n\n```\n\n### 幽灵按钮\n\n`ghost` 让背景透明，适合深色或复杂底图。对 `text` / `link` 无效。\n\n```vue preview src=\"./demos/Ghost.vue\"\n\n```\n\n### 加载中\n\n`loading` 可为布尔值，或 `{ delay, icon }`。加载中会禁用点击。\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### 不可用\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n### Block\n\n`block` 让按钮宽度撑满父容器。\n\n```vue preview src=\"./demos/Block.vue\"\n\n```\n\n### 按钮组\n\n`MButtonGroup` 只做视觉拼组（圆角与边框衔接），没有选中态。需要互斥切换时用 [`SelectButton`](/components/SelectButton)。\n\n```vue preview src=\"./demos/ButtonGroup.zh.vue\"\n\n```\n\n### 水波纹与按压\n\n`ripple` / `press` 默认关闭，需要时显式开启。\n\n```vue preview src=\"./demos/RipplePress.vue\"\n\n```\n\n## API\n\n推荐组合顺序：`type` → `shape` → `size` → `loading` → `disabled`。\n\n### Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `type` | `'default' \\| 'primary' \\| 'dashed' \\| 'link' \\| 'text'` | `'default'` | 语法糖。同时设置 `color` 与 `variant` 时以后者为准。 |\n| `color` | `'default' \\| 'primary' \\| 'danger' \\| 'success' \\| 'info' \\| 'warning' \\| 'help' \\| 'contrast'` | — | 颜色轴。 |\n| `variant` | `'solid' \\| 'outlined' \\| 'dashed' \\| 'filled' \\| 'text' \\| 'link'` | — | 变体轴。 |\n| `danger` | `boolean` | `false` | 危险色语法糖。设置了 `color` 时以 `color` 为准。 |\n| `ghost` | `boolean` | `false` | 透明背景。对 `text` / `link` 无效。 |\n| `shape` | `'default' \\| 'circle' \\| 'round' \\| 'square'` | `'default'` | 形状。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸；可继承 ConfigProvider。 |\n| `block` | `boolean` | `false` | 宽度撑满父容器。 |\n| `loading` | `boolean \\| { delay?: number; icon?: IconName \\| Component }` | `false` | 加载中；可延迟出现并自定义图标。 |\n| `disabled` | `boolean` | `false` | 禁用；可继承 ConfigProvider。 |\n| `htmlType` | `'button' \\| 'submit' \\| 'reset'` | `'button'` | 原生 `button` 的 `type`。 |\n| `href` | `string` | — | 设置后渲染为 `<a>`。 |\n| `target` | `string` | — | 链接 `target`，需配合 `href`。 |\n| `label` | `string` | — | 文案；默认插槽优先。 |\n| `icon` | `IconName \\| Component` | — | 图标名称或组件。 |\n| `iconPlacement` | `'start' \\| 'end'` | `'start'` | 图标位置。 |\n| `iconOnly` | `boolean` | `false` | 强制纯图标方形按钮。 |\n| `autoInsertSpace` | `boolean` | `true` | 两个汉字之间插入空格。 |\n| `ripple` | `boolean` | `false` | 点击水波纹。 |\n| `press` | `boolean` | `false` | 按下缩放。 |\n| `autofocus` | `boolean` | `false` | 原生 autofocus。 |\n| `ariaLabel` | `string` | — | 可访问名称；纯图标按钮建议提供。 |\n| `pt` | `{ root?, icon?, content? }` | — | 语义结构透传。 |\n\n### Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `click` | `MouseEvent` | 点击时触发；`loading` / `disabled` 时不触发。 |\n\n### Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 按钮内容，优先于 `label`。 |\n| `icon` | 自定义图标。 |\n| `loadingicon` | 自定义加载图标。 |\n\n### Instance\n\n| 方法 / 属性 | 说明 |\n| --- | --- |\n| `focus()` | 聚焦根元素。 |\n| `ref` | 根 `HTMLButtonElement` 或 `HTMLAnchorElement`。 |\n\n### MButtonGroup Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `block` | `boolean` | `false` | 宽度撑满父容器。 |\n| `ariaLabel` | `string` | — | 组的可访问名称。 |\n| `pt` | `{ root? }` | — | 组容器透传。 |\n\n## Design Token\n\n复用全局 `--m-*` 令牌，见[设计令牌](/docs/design-tokens)。按钮在根节点暴露 `--m-button-*`（尺寸、圆角、色阶、填充透明度、动效等），主题切换时跟随 `--m-color-*` / `--m-control-*` / `--m-motion-*`。\n\n## Semantic DOM\n\n根节点即交互元素：有 `href` 时为 `<a class=\"m-button\">`，否则为 `<button class=\"m-button\">`。\n\n```text\nbutton.m-button / a.m-button\n  span.m-button__ripple*   ← ripple 开启时\n  span.m-button__icon*     ← 图标 / loading\n  span.m-button__label*    ← 文案\n```\n\n可用 `pt.root` / `pt.icon` / `pt.content` 覆盖各节点。更多约定见[样式与 attrs](/docs/attrs)、[Common Props](/docs/common-props)。\n\n## FAQ\n\n### `type` 和 `color` / `variant` 怎么选？\n\n日常优先用 `type`。需要跨色系细调时再用 `color` + `variant`；二者齐全时覆盖 `type`。\n\n| `type` | 等价于 |\n| --- | --- |\n| `primary` | `color=\"primary\"` + `variant=\"solid\"` |\n| `default` | `color=\"default\"` + `variant=\"outlined\"` |\n| `dashed` | `color=\"default\"` + `variant=\"dashed\"` |\n| `text` | `color=\"default\"` + `variant=\"text\"` |\n| `link` | `color=\"link\"` + `variant=\"link\"` |\n\n```vue\n<MButton type=\"primary\">保存</MButton>\n```\n\n等同于\n\n```vue\n<MButton color=\"primary\" variant=\"solid\">保存</MButton>\n```\n\n### Button 的 `color` 和其它组件的 `severity`？\n\nButton 使用 `color` / `variant`。Badge、Tag、Alert、Message、Toast 等反馈组件仍使用 `severity`。\n\n### `text` 和 `link` 怎么区分？\n\n`type=\"text\"`（或 `variant=\"text\"`）保留按钮热区与高度；`type=\"link\"` 更接近内联链接。\n\n## 无障碍\n\n- 默认渲染原生 `<button>`；设置 `href` 时渲染 `<a>`。\n- 纯图标按钮请设置 `ariaLabel`（或可见文本）。\n- `loading` 时设置 `aria-busy`，并阻止点击。\n- 禁用的链接按钮会去掉 `href`，并设置 `aria-disabled` 与 `tabindex=\"-1\"`。\n"
         },
         "en-US": {
           "title": "Button",
-          "description": "Button triggers an immediate action.",
+          "description": "A button that triggers an immediate action.",
           "sections": [
             {
               "id": "overview",
               "title": "",
-              "body": "# Button\n\nButton triggers an immediate action."
+              "body": "# Button\n\nUse Button for submit, confirm, navigate, and other immediate actions."
             },
             {
               "id": "when-to-use",
               "title": "When to use",
-              "body": "- Use when the user needs to trigger a submit, confirm, navigate, or other immediate action.\n- Prefer the default (primary) button for the main action; use `severity=\"secondary\"` or `outlined` / `text` for secondary actions.\n- Use `severity=\"danger\"` for destructive actions; use `text` or `link` for lightweight inline actions.\n- Use `MButtonGroup` when adjacent buttons belong together."
+              "body": "- Primary action: `type=\"primary\"`. Keep one primary action in a region.\n- Secondary action: the default button, or `type=\"dashed\"` / `type=\"text\"`.\n- Inline or low-emphasis action: `type=\"link\"` / `type=\"text\"`.\n- Destructive action: add `danger`, and confirm when needed.\n- Adjacent actions that should look joined: wrap them in `MButtonGroup` (visual only)."
             },
             {
               "id": "import",
               "title": "Import",
-              "body": "```ts\nimport { MButton } from \"morya-ui\";\n```"
+              "body": "```ts\nimport { MButton, MButtonGroup } from 'morya-ui'\n```"
             },
             {
               "id": "examples",
               "title": "Examples",
-              "body": "### Basic\n\nShow button text via the default slot or the `label` prop.\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### Types\n\nCommon combinations: default primary, `severity=\"secondary\"`, `variant=\"dashed\"`, `text` / `link`, `severity=\"danger\"`, and `fluid` for full width.\n\n```vue preview src=\"./demos/VariantTypes.vue\"\n\n```\n\n### Shape\n\n`shape`: `default` / `round` / `circle` / `square`. Legacy `rounded` maps to `shape=\"round\"`.\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Severity\n\nUse `severity` for semantic color; defaults to primary when omitted.\n\n```vue preview src=\"./demos/Severity.vue\"\n\n```\n\n### Styles\n\n`outlined`, `text`, `link`, `raised`, `rounded`, and `plain` can be combined freely.\n\n```vue preview src=\"./demos/Styles.vue\"\n\n```\n\n### Text & Link\n\n`text` is a lightweight text button; `link` renders as a backgroundless inline link style with underline on hover by default. Set `:underline=\"false\"` to disable. Both can be combined with `severity`.\n\n```vue preview src=\"./demos/TextAndLink.vue\"\n\n```\n\n### Ghost & Quaternary\n\n`ghost` is a soft fill matching text hover; `quaternary` is quieter for secondary toolbar actions. Both can be set via `variant`.\n\n```vue preview src=\"./demos/GhostAndQuaternary.vue\"\n\n```\n\n### Button Group\n\n`MButtonGroup` joins adjacent buttons.\n\n```vue preview src=\"./demos/ButtonGroup.en.vue\"\n\n```\n\n### Icons & Badge\n\nSupports `icon`, `iconPos`, `iconOnly`, and a `badge`.\n\n```vue preview src=\"./demos/IconsAndBadge.vue\"\n\n```\n\n### Loading\n\nIn the `loading` state, a spinner is shown and clicks are blocked.\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```"
+              "body": "### Basic\n\n`type` is sugar for a `color` + `variant` pair. Omit it for the default outlined button.\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### Color & variant\n\nSet `color` and `variant` for finer control. When both are set, they win over `type`.\n\n```vue preview src=\"./demos/ColorVariant.vue\"\n\n```\n\n### Icon\n\n`icon` accepts a name or component. Use `iconPlacement` for position. Icon-only buttons need `ariaLabel`.\n\n```vue preview src=\"./demos/Icon.vue\"\n\n```\n\n### Size\n\n```vue preview src=\"./demos/Size.vue\"\n\n```\n\n### Shape\n\n`shape`: `default` / `round` / `circle` / `square`.\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Danger\n\n`danger` switches the color to danger while keeping the current `type` / `variant` look.\n\n```vue preview src=\"./demos/Danger.vue\"\n\n```\n\n### Ghost\n\n`ghost` makes the background transparent for dark or busy surfaces. It is ignored for `text` / `link`.\n\n```vue preview src=\"./demos/Ghost.vue\"\n\n```\n\n### Loading\n\n`loading` accepts a boolean or `{ delay, icon }`. Clicks are blocked while loading.\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n### Block\n\n`block` stretches the button to the parent width.\n\n```vue preview src=\"./demos/Block.vue\"\n\n```\n\n### Button group\n\n`MButtonGroup` only joins adjacent buttons visually. It has no selected state. For mutually exclusive switching, use [`SelectButton`](/components/SelectButton).\n\n```vue preview src=\"./demos/ButtonGroup.en.vue\"\n\n```\n\n### Ripple & press\n\n`ripple` and `press` are off by default. Turn them on when you want the motion.\n\n```vue preview src=\"./demos/RipplePress.vue\"\n\n```"
             },
             {
               "id": "api",
               "title": "API",
-              "body": "### Props\n\n| Prop            | Type                                                                               | Default    | Description                                                           |\n| --------------- | ---------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------- |\n| `label`         | `string`                                                                           | —          | Button text. Default slot content takes precedence when present.      |\n| `icon`          | `IconName \\| Component`                                                            | —          | Icon name or custom component.                                        |\n| `iconPos`       | `'left' \\| 'right' \\| 'top' \\| 'bottom'`                                           | `'left'`   | Icon position relative to the label.                                  |\n| `iconOnly`      | `boolean`                                                                          | `false`    | Force a square icon-only button.                                      |\n| `badge`         | `string`                                                                           | —          | Badge text.                                                           |\n| `badgeSeverity` | `'secondary' \\| 'info' \\| 'success' \\| 'warn' \\| 'danger' \\| 'contrast' \\| null`   | `null`     | Badge semantic color.                                                 |\n| `severity`      | `'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast'` | —          | Semantic color. Defaults to primary when omitted.                     |\n| `color`         | `string`                                                                           | —          | Custom color; overrides `severity`.                                   |\n| `size`          | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'`                                       | —          | Size. Medium by default; `sm` / `lg` aliases supported.               |\n| `variant`       | `'outlined' \\| 'text' \\| 'link' \\| 'ghost' \\| 'quaternary'`                        | —          | Style variant shortcut, equivalent to the matching boolean prop.      |\n| `outlined`      | `boolean`                                                                          | `false`    | Outlined button.                                                      |\n| `text`          | `boolean`                                                                          | `false`    | Text button.                                                          |\n| `link`          | `boolean`                                                                          | `false`    | Link button.                                                          |\n| `underline`     | `boolean`                                                                          | `true`     | Underline on hover for `link`. Set `false` to disable.                |\n| `ghost`         | `boolean`                                                                          | `false`    | Soft fill matching text hover.                                        |\n| `quaternary`    | `boolean`                                                                          | `false`    | Extra-quiet text button.                                              |\n| `plain`         | `boolean`                                                                          | `false`    | Soft fill matching outlined hover; can also mute `text` / `outlined`. |\n| `raised`        | `boolean`                                                                          | `false`    | Raised shadow.                                                        |\n| `rounded`       | `boolean`                                                                          | `false`    | Fully rounded.                                                        |\n| `fluid`         | `boolean`                                                                          | `false`    | Stretch to full container width.                                      |\n| `loading`       | `boolean`                                                                          | `false`    | Loading state; disables clicks and shows a spinner.                   |\n| `disabled`      | `boolean`                                                                          | `false`    | Disabled.                                                             |\n| `ripple`        | `boolean`                                                                          | `false`    | Click ripple ink. Set `true` to enable.                               |\n| `press`         | `boolean`                                                                          | `false`    | Slight scale while pressed. Set `true` to enable.                     |\n| `nativeType`    | `'button' \\| 'submit' \\| 'reset'`                                                  | `'button'` | Native button type.                                                   |\n| `autofocus`     | `boolean`                                                                          | `false`    | Native autofocus.                                                     |\n| `ariaLabel`     | `string`                                                                           | —          | Accessible name; recommended for icon-only buttons.                   |\n\n### Events\n\n| Event   | Prop         | Description                  |\n| ------- | ------------ | ---------------------------- |\n| `click` | `MouseEvent` | Fired on click when enabled. |\n\n### Slots\n\n| Slot          | Description                                    |\n| ------------- | ---------------------------------------------- |\n| `default`     | Button content; takes precedence over `label`. |\n| `icon`        | Custom icon.                                   |\n| `loadingicon` | Custom loading icon.                           |\n\n### Instance\n\n| Method / Property | Description                     |\n| ----------------- | ------------------------------- |\n| `focus()`         | Focus the underlying button.    |\n| `ref`             | Underlying `HTMLButtonElement`. |\n\n### Props — ButtonGroup\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `fluid` | `boolean` | `false` | Stretch to full container width. |\n| `ariaLabel` | `string` | — | Accessible name for the group. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Group wrapper pass-through. |"
+              "body": "Suggested composition order: `type` → `shape` → `size` → `loading` → `disabled`.\n\n### Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `type` | `'default' \\| 'primary' \\| 'dashed' \\| 'link' \\| 'text'` | `'default'` | Sugar. When both `color` and `variant` are set, they win. |\n| `color` | `'default' \\| 'primary' \\| 'danger' \\| 'success' \\| 'info' \\| 'warning' \\| 'help' \\| 'contrast'` | — | Color axis. |\n| `variant` | `'solid' \\| 'outlined' \\| 'dashed' \\| 'filled' \\| 'text' \\| 'link'` | — | Variant axis. |\n| `danger` | `boolean` | `false` | Danger-color sugar. `color` wins when set. |\n| `ghost` | `boolean` | `false` | Transparent background. Ignored for `text` / `link`. |\n| `shape` | `'default' \\| 'circle' \\| 'round' \\| 'square'` | `'default'` | Corner shape. |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | Size; can inherit from ConfigProvider. |\n| `block` | `boolean` | `false` | Stretch to the parent width. |\n| `loading` | `boolean \\| { delay?: number; icon?: IconName \\| Component }` | `false` | Loading state with optional delay and icon. |\n| `disabled` | `boolean` | `false` | Disabled; can inherit from ConfigProvider. |\n| `htmlType` | `'button' \\| 'submit' \\| 'reset'` | `'button'` | Native button `type`. |\n| `href` | `string` | — | Renders as `<a>` when set. |\n| `target` | `string` | — | Anchor `target`; requires `href`. |\n| `label` | `string` | — | Label text; the default slot wins when present. |\n| `icon` | `IconName \\| Component` | — | Icon name or component. |\n| `iconPlacement` | `'start' \\| 'end'` | `'start'` | Icon placement. |\n| `iconOnly` | `boolean` | `false` | Force a square icon-only button. |\n| `autoInsertSpace` | `boolean` | `true` | Insert a space between two Chinese characters. |\n| `ripple` | `boolean` | `false` | Click ripple. |\n| `press` | `boolean` | `false` | Press scale. |\n| `autofocus` | `boolean` | `false` | Native autofocus. |\n| `ariaLabel` | `string` | — | Accessible name; recommended for icon-only buttons. |\n| `pt` | `{ root?, icon?, content? }` | — | Semantic DOM pass-through. |\n\n### Events\n\n| Event | Payload | Description |\n| --- | --- | --- |\n| `click` | `MouseEvent` | Fired on click; suppressed while `loading` / `disabled`. |\n\n### Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Button content; wins over `label`. |\n| `icon` | Custom icon. |\n| `loadingicon` | Custom loading icon. |\n\n### Instance\n\n| Member | Description |\n| --- | --- |\n| `focus()` | Focus the root element. |\n| `ref` | Root `HTMLButtonElement` or `HTMLAnchorElement`. |\n\n### MButtonGroup Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `block` | `boolean` | `false` | Stretch to the parent width. |\n| `ariaLabel` | `string` | — | Accessible name for the group. |\n| `pt` | `{ root? }` | — | Group wrapper pass-through. |"
             },
             {
               "id": "design-token",
               "title": "Design Token",
-              "body": "Reuses global `--m-*` tokens; see [Design Tokens](/docs/design-tokens). A component-level `--m-button-*` table will follow later."
+              "body": "Reuses global `--m-*` tokens; see [Design Tokens](/docs/design-tokens). Button exposes `--m-button-*` on the root (size, radius, tones, fill opacity, motion). Theme switches follow `--m-color-*` / `--m-control-*` / `--m-motion-*`."
             },
             {
               "id": "semantic-dom",
               "title": "Semantic DOM",
-              "body": "`MButton` is a leaf control: the root is the native `<button class=\"m-button\">`. `class` / `style` / events land on that element (see [Attrs](/docs/attrs) and [Common Props](/docs/common-props)).\n\n```text\nbutton.m-button                 ← root (interactive element)\n  span.m-button__ripple         ← optional ripple layer\n  span.m-button__icon           ← icon / loading spinner (aria-hidden)\n    span.m-button__spinner      ← while loading\n  span.m-button__label          ← label (slot or `label` prop)\n  span.m-button__badge*         ← optional badge\n```\n\n`MButton` itself does not expose `pt`; use `MButtonGroup` `pt.root` for the group wrapper. Target `.m-button` first when styling, then `__icon` / `__label` / `__badge` as needed."
+              "body": "The root is the interactive element: `<a class=\"m-button\">` when `href` is set, otherwise `<button class=\"m-button\">`.\n\n```text\nbutton.m-button / a.m-button\n  span.m-button__ripple*   ← when ripple is on\n  span.m-button__icon*     ← icon / loading\n  span.m-button__label*    ← label\n```\n\nOverride parts with `pt.root` / `pt.icon` / `pt.content`. See also [Attrs](/docs/attrs) and [Common Props](/docs/common-props)."
             },
             {
               "id": "faq",
               "title": "FAQ",
-              "body": "### What is the difference between `severity` and `variant`?\n\n`severity` sets the semantic color (e.g. `danger`, `success`); primary is used when omitted. `variant` (or the matching boolean prop) sets the visual style such as `outlined`, `text`, `link`, or `ghost`. They compose, e.g. `severity=\"danger\"` + `variant=\"outlined\"`.\n\n### When should I use `text` vs `link`, or `rounded` vs `shape`?\n\n`text` is a lightweight text button; `link` behaves more like an inline link (underline on hover by default). Prefer `shape` (`round` / `circle` / `square`) for geometry; legacy `rounded` still works and maps to `shape=\"round\"`."
+              "body": "### How do I choose between `type` and `color` / `variant`?\n\nPrefer `type` for everyday use. Reach for `color` + `variant` when you need finer cross-tone control. When both axes are set, they override `type`.\n\n| `type` | Equals |\n| --- | --- |\n| `primary` | `color=\"primary\"` + `variant=\"solid\"` |\n| `default` | `color=\"default\"` + `variant=\"outlined\"` |\n| `dashed` | `color=\"default\"` + `variant=\"dashed\"` |\n| `text` | `color=\"default\"` + `variant=\"text\"` |\n| `link` | `color=\"link\"` + `variant=\"link\"` |\n\n```vue\n<MButton type=\"primary\">Save</MButton>\n```\n\nequals\n\n```vue\n<MButton color=\"primary\" variant=\"solid\">Save</MButton>\n```\n\n### Button `color` vs other components' `severity`?\n\nButton uses `color` / `variant`. Feedback components such as Badge, Tag, Alert, Message, and Toast still use `severity`.\n\n### `text` vs `link`?\n\n`type=\"text\"` (or `variant=\"text\"`) keeps button height and hit area. `type=\"link\"` is closer to an inline link."
             },
             {
               "id": "accessibility",
               "title": "Accessibility",
-              "body": "- Renders a native `<button>`.\n- For icon-only buttons, set `ariaLabel` (or provide an accessible text label).\n- Sets `aria-busy` while `loading` and disables interaction."
+              "body": "- Renders a native `<button>` by default; renders `<a>` when `href` is set.\n- Provide `ariaLabel` (or visible text) for icon-only buttons.\n- Sets `aria-busy` while `loading` and blocks interaction.\n- A disabled link button drops `href` and sets `aria-disabled` with `tabindex=\"-1\"`."
             }
           ],
-          "markdown": "---\ntitle: Button\ncategory: 01 / BASIC\ndescription: Button triggers an immediate action.\n---\n\n# Button\n\nButton triggers an immediate action.\n\n## When to use\n\n- Use when the user needs to trigger a submit, confirm, navigate, or other immediate action.\n- Prefer the default (primary) button for the main action; use `severity=\"secondary\"` or `outlined` / `text` for secondary actions.\n- Use `severity=\"danger\"` for destructive actions; use `text` or `link` for lightweight inline actions.\n- Use `MButtonGroup` when adjacent buttons belong together.\n\n## Import\n\n```ts\nimport { MButton } from \"morya-ui\";\n```\n\n## Examples\n\n### Basic\n\nShow button text via the default slot or the `label` prop.\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### Types\n\nCommon combinations: default primary, `severity=\"secondary\"`, `variant=\"dashed\"`, `text` / `link`, `severity=\"danger\"`, and `fluid` for full width.\n\n```vue preview src=\"./demos/VariantTypes.vue\"\n\n```\n\n### Shape\n\n`shape`: `default` / `round` / `circle` / `square`. Legacy `rounded` maps to `shape=\"round\"`.\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Severity\n\nUse `severity` for semantic color; defaults to primary when omitted.\n\n```vue preview src=\"./demos/Severity.vue\"\n\n```\n\n### Styles\n\n`outlined`, `text`, `link`, `raised`, `rounded`, and `plain` can be combined freely.\n\n```vue preview src=\"./demos/Styles.vue\"\n\n```\n\n### Text & Link\n\n`text` is a lightweight text button; `link` renders as a backgroundless inline link style with underline on hover by default. Set `:underline=\"false\"` to disable. Both can be combined with `severity`.\n\n```vue preview src=\"./demos/TextAndLink.vue\"\n\n```\n\n### Ghost & Quaternary\n\n`ghost` is a soft fill matching text hover; `quaternary` is quieter for secondary toolbar actions. Both can be set via `variant`.\n\n```vue preview src=\"./demos/GhostAndQuaternary.vue\"\n\n```\n\n### Button Group\n\n`MButtonGroup` joins adjacent buttons.\n\n```vue preview src=\"./demos/ButtonGroup.en.vue\"\n\n```\n\n### Icons & Badge\n\nSupports `icon`, `iconPos`, `iconOnly`, and a `badge`.\n\n```vue preview src=\"./demos/IconsAndBadge.vue\"\n\n```\n\n### Loading\n\nIn the `loading` state, a spinner is shown and clicks are blocked.\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n## API\n\n### Props\n\n| Prop            | Type                                                                               | Default    | Description                                                           |\n| --------------- | ---------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------- |\n| `label`         | `string`                                                                           | —          | Button text. Default slot content takes precedence when present.      |\n| `icon`          | `IconName \\| Component`                                                            | —          | Icon name or custom component.                                        |\n| `iconPos`       | `'left' \\| 'right' \\| 'top' \\| 'bottom'`                                           | `'left'`   | Icon position relative to the label.                                  |\n| `iconOnly`      | `boolean`                                                                          | `false`    | Force a square icon-only button.                                      |\n| `badge`         | `string`                                                                           | —          | Badge text.                                                           |\n| `badgeSeverity` | `'secondary' \\| 'info' \\| 'success' \\| 'warn' \\| 'danger' \\| 'contrast' \\| null`   | `null`     | Badge semantic color.                                                 |\n| `severity`      | `'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast'` | —          | Semantic color. Defaults to primary when omitted.                     |\n| `color`         | `string`                                                                           | —          | Custom color; overrides `severity`.                                   |\n| `size`          | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'`                                       | —          | Size. Medium by default; `sm` / `lg` aliases supported.               |\n| `variant`       | `'outlined' \\| 'text' \\| 'link' \\| 'ghost' \\| 'quaternary'`                        | —          | Style variant shortcut, equivalent to the matching boolean prop.      |\n| `outlined`      | `boolean`                                                                          | `false`    | Outlined button.                                                      |\n| `text`          | `boolean`                                                                          | `false`    | Text button.                                                          |\n| `link`          | `boolean`                                                                          | `false`    | Link button.                                                          |\n| `underline`     | `boolean`                                                                          | `true`     | Underline on hover for `link`. Set `false` to disable.                |\n| `ghost`         | `boolean`                                                                          | `false`    | Soft fill matching text hover.                                        |\n| `quaternary`    | `boolean`                                                                          | `false`    | Extra-quiet text button.                                              |\n| `plain`         | `boolean`                                                                          | `false`    | Soft fill matching outlined hover; can also mute `text` / `outlined`. |\n| `raised`        | `boolean`                                                                          | `false`    | Raised shadow.                                                        |\n| `rounded`       | `boolean`                                                                          | `false`    | Fully rounded.                                                        |\n| `fluid`         | `boolean`                                                                          | `false`    | Stretch to full container width.                                      |\n| `loading`       | `boolean`                                                                          | `false`    | Loading state; disables clicks and shows a spinner.                   |\n| `disabled`      | `boolean`                                                                          | `false`    | Disabled.                                                             |\n| `ripple`        | `boolean`                                                                          | `false`    | Click ripple ink. Set `true` to enable.                               |\n| `press`         | `boolean`                                                                          | `false`    | Slight scale while pressed. Set `true` to enable.                     |\n| `nativeType`    | `'button' \\| 'submit' \\| 'reset'`                                                  | `'button'` | Native button type.                                                   |\n| `autofocus`     | `boolean`                                                                          | `false`    | Native autofocus.                                                     |\n| `ariaLabel`     | `string`                                                                           | —          | Accessible name; recommended for icon-only buttons.                   |\n\n### Events\n\n| Event   | Prop         | Description                  |\n| ------- | ------------ | ---------------------------- |\n| `click` | `MouseEvent` | Fired on click when enabled. |\n\n### Slots\n\n| Slot          | Description                                    |\n| ------------- | ---------------------------------------------- |\n| `default`     | Button content; takes precedence over `label`. |\n| `icon`        | Custom icon.                                   |\n| `loadingicon` | Custom loading icon.                           |\n\n### Instance\n\n| Method / Property | Description                     |\n| ----------------- | ------------------------------- |\n| `focus()`         | Focus the underlying button.    |\n| `ref`             | Underlying `HTMLButtonElement`. |\n\n### Props — ButtonGroup\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `fluid` | `boolean` | `false` | Stretch to full container width. |\n| `ariaLabel` | `string` | — | Accessible name for the group. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Group wrapper pass-through. |\n\n## Design Token\n\nReuses global `--m-*` tokens; see [Design Tokens](/docs/design-tokens). A component-level `--m-button-*` table will follow later.\n\n## Semantic DOM\n\n`MButton` is a leaf control: the root is the native `<button class=\"m-button\">`. `class` / `style` / events land on that element (see [Attrs](/docs/attrs) and [Common Props](/docs/common-props)).\n\n```text\nbutton.m-button                 ← root (interactive element)\n  span.m-button__ripple         ← optional ripple layer\n  span.m-button__icon           ← icon / loading spinner (aria-hidden)\n    span.m-button__spinner      ← while loading\n  span.m-button__label          ← label (slot or `label` prop)\n  span.m-button__badge*         ← optional badge\n```\n\n`MButton` itself does not expose `pt`; use `MButtonGroup` `pt.root` for the group wrapper. Target `.m-button` first when styling, then `__icon` / `__label` / `__badge` as needed.\n\n## FAQ\n\n### What is the difference between `severity` and `variant`?\n\n`severity` sets the semantic color (e.g. `danger`, `success`); primary is used when omitted. `variant` (or the matching boolean prop) sets the visual style such as `outlined`, `text`, `link`, or `ghost`. They compose, e.g. `severity=\"danger\"` + `variant=\"outlined\"`.\n\n### When should I use `text` vs `link`, or `rounded` vs `shape`?\n\n`text` is a lightweight text button; `link` behaves more like an inline link (underline on hover by default). Prefer `shape` (`round` / `circle` / `square`) for geometry; legacy `rounded` still works and maps to `shape=\"round\"`.\n\n## Accessibility\n\n- Renders a native `<button>`.\n- For icon-only buttons, set `ariaLabel` (or provide an accessible text label).\n- Sets `aria-busy` while `loading` and disables interaction.\n"
+          "markdown": "---\ntitle: Button\ncategory: 01 / BASIC\ndescription: A button that triggers an immediate action.\n---\n\n# Button\n\nUse Button for submit, confirm, navigate, and other immediate actions.\n\n## When to use\n\n- Primary action: `type=\"primary\"`. Keep one primary action in a region.\n- Secondary action: the default button, or `type=\"dashed\"` / `type=\"text\"`.\n- Inline or low-emphasis action: `type=\"link\"` / `type=\"text\"`.\n- Destructive action: add `danger`, and confirm when needed.\n- Adjacent actions that should look joined: wrap them in `MButtonGroup` (visual only).\n\n## Import\n\n```ts\nimport { MButton, MButtonGroup } from 'morya-ui'\n```\n\n## Examples\n\n### Basic\n\n`type` is sugar for a `color` + `variant` pair. Omit it for the default outlined button.\n\n```vue preview src=\"./demos/Basic.vue\"\n\n```\n\n### Color & variant\n\nSet `color` and `variant` for finer control. When both are set, they win over `type`.\n\n```vue preview src=\"./demos/ColorVariant.vue\"\n\n```\n\n### Icon\n\n`icon` accepts a name or component. Use `iconPlacement` for position. Icon-only buttons need `ariaLabel`.\n\n```vue preview src=\"./demos/Icon.vue\"\n\n```\n\n### Size\n\n```vue preview src=\"./demos/Size.vue\"\n\n```\n\n### Shape\n\n`shape`: `default` / `round` / `circle` / `square`.\n\n```vue preview src=\"./demos/Shape.vue\"\n\n```\n\n### Danger\n\n`danger` switches the color to danger while keeping the current `type` / `variant` look.\n\n```vue preview src=\"./demos/Danger.vue\"\n\n```\n\n### Ghost\n\n`ghost` makes the background transparent for dark or busy surfaces. It is ignored for `text` / `link`.\n\n```vue preview src=\"./demos/Ghost.vue\"\n\n```\n\n### Loading\n\n`loading` accepts a boolean or `{ delay, icon }`. Clicks are blocked while loading.\n\n```vue preview src=\"./demos/Loading.vue\"\n\n```\n\n### Disabled\n\n```vue preview src=\"./demos/Disabled.vue\"\n\n```\n\n### Block\n\n`block` stretches the button to the parent width.\n\n```vue preview src=\"./demos/Block.vue\"\n\n```\n\n### Button group\n\n`MButtonGroup` only joins adjacent buttons visually. It has no selected state. For mutually exclusive switching, use [`SelectButton`](/components/SelectButton).\n\n```vue preview src=\"./demos/ButtonGroup.en.vue\"\n\n```\n\n### Ripple & press\n\n`ripple` and `press` are off by default. Turn them on when you want the motion.\n\n```vue preview src=\"./demos/RipplePress.vue\"\n\n```\n\n## API\n\nSuggested composition order: `type` → `shape` → `size` → `loading` → `disabled`.\n\n### Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `type` | `'default' \\| 'primary' \\| 'dashed' \\| 'link' \\| 'text'` | `'default'` | Sugar. When both `color` and `variant` are set, they win. |\n| `color` | `'default' \\| 'primary' \\| 'danger' \\| 'success' \\| 'info' \\| 'warning' \\| 'help' \\| 'contrast'` | — | Color axis. |\n| `variant` | `'solid' \\| 'outlined' \\| 'dashed' \\| 'filled' \\| 'text' \\| 'link'` | — | Variant axis. |\n| `danger` | `boolean` | `false` | Danger-color sugar. `color` wins when set. |\n| `ghost` | `boolean` | `false` | Transparent background. Ignored for `text` / `link`. |\n| `shape` | `'default' \\| 'circle' \\| 'round' \\| 'square'` | `'default'` | Corner shape. |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | Size; can inherit from ConfigProvider. |\n| `block` | `boolean` | `false` | Stretch to the parent width. |\n| `loading` | `boolean \\| { delay?: number; icon?: IconName \\| Component }` | `false` | Loading state with optional delay and icon. |\n| `disabled` | `boolean` | `false` | Disabled; can inherit from ConfigProvider. |\n| `htmlType` | `'button' \\| 'submit' \\| 'reset'` | `'button'` | Native button `type`. |\n| `href` | `string` | — | Renders as `<a>` when set. |\n| `target` | `string` | — | Anchor `target`; requires `href`. |\n| `label` | `string` | — | Label text; the default slot wins when present. |\n| `icon` | `IconName \\| Component` | — | Icon name or component. |\n| `iconPlacement` | `'start' \\| 'end'` | `'start'` | Icon placement. |\n| `iconOnly` | `boolean` | `false` | Force a square icon-only button. |\n| `autoInsertSpace` | `boolean` | `true` | Insert a space between two Chinese characters. |\n| `ripple` | `boolean` | `false` | Click ripple. |\n| `press` | `boolean` | `false` | Press scale. |\n| `autofocus` | `boolean` | `false` | Native autofocus. |\n| `ariaLabel` | `string` | — | Accessible name; recommended for icon-only buttons. |\n| `pt` | `{ root?, icon?, content? }` | — | Semantic DOM pass-through. |\n\n### Events\n\n| Event | Payload | Description |\n| --- | --- | --- |\n| `click` | `MouseEvent` | Fired on click; suppressed while `loading` / `disabled`. |\n\n### Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Button content; wins over `label`. |\n| `icon` | Custom icon. |\n| `loadingicon` | Custom loading icon. |\n\n### Instance\n\n| Member | Description |\n| --- | --- |\n| `focus()` | Focus the root element. |\n| `ref` | Root `HTMLButtonElement` or `HTMLAnchorElement`. |\n\n### MButtonGroup Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `block` | `boolean` | `false` | Stretch to the parent width. |\n| `ariaLabel` | `string` | — | Accessible name for the group. |\n| `pt` | `{ root? }` | — | Group wrapper pass-through. |\n\n## Design Token\n\nReuses global `--m-*` tokens; see [Design Tokens](/docs/design-tokens). Button exposes `--m-button-*` on the root (size, radius, tones, fill opacity, motion). Theme switches follow `--m-color-*` / `--m-control-*` / `--m-motion-*`.\n\n## Semantic DOM\n\nThe root is the interactive element: `<a class=\"m-button\">` when `href` is set, otherwise `<button class=\"m-button\">`.\n\n```text\nbutton.m-button / a.m-button\n  span.m-button__ripple*   ← when ripple is on\n  span.m-button__icon*     ← icon / loading\n  span.m-button__label*    ← label\n```\n\nOverride parts with `pt.root` / `pt.icon` / `pt.content`. See also [Attrs](/docs/attrs) and [Common Props](/docs/common-props).\n\n## FAQ\n\n### How do I choose between `type` and `color` / `variant`?\n\nPrefer `type` for everyday use. Reach for `color` + `variant` when you need finer cross-tone control. When both axes are set, they override `type`.\n\n| `type` | Equals |\n| --- | --- |\n| `primary` | `color=\"primary\"` + `variant=\"solid\"` |\n| `default` | `color=\"default\"` + `variant=\"outlined\"` |\n| `dashed` | `color=\"default\"` + `variant=\"dashed\"` |\n| `text` | `color=\"default\"` + `variant=\"text\"` |\n| `link` | `color=\"link\"` + `variant=\"link\"` |\n\n```vue\n<MButton type=\"primary\">Save</MButton>\n```\n\nequals\n\n```vue\n<MButton color=\"primary\" variant=\"solid\">Save</MButton>\n```\n\n### Button `color` vs other components' `severity`?\n\nButton uses `color` / `variant`. Feedback components such as Badge, Tag, Alert, Message, and Toast still use `severity`.\n\n### `text` vs `link`?\n\n`type=\"text\"` (or `variant=\"text\"`) keeps button height and hit area. `type=\"link\"` is closer to an inline link.\n\n## Accessibility\n\n- Renders a native `<button>` by default; renders `<a>` when `href` is set.\n- Provide `ariaLabel` (or visible text) for icon-only buttons.\n- Sets `aria-busy` while `loading` and blocks interaction.\n- A disabled link button drops `href` and sets `aria-disabled` with `tabindex=\"-1\"`.\n"
         }
       }
     },
@@ -2929,7 +2947,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MCard } from 'morya-ui'\n</script>\n\n<template>\n  <MCard title=\"Project overview\" subtitle=\"Updated 2 hours ago\">\n    <p style=\"margin:0;color:var(--m-color-text-muted)\">\n      Title and subtitle align in the header. Body content stays in the default slot.\n    </p>\n    <template #footer>\n      <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n        <MButton label=\"Dismiss\" severity=\"secondary\" text />\n        <MButton label=\"Continue\" />\n      </div>\n    </template>\n  </MCard>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MCard } from 'morya-ui'\n</script>\n\n<template>\n  <MCard title=\"Project overview\" subtitle=\"Updated 2 hours ago\">\n    <p style=\"margin:0;color:var(--m-color-text-muted)\">\n      Title and subtitle align in the header. Body content stays in the default slot.\n    </p>\n    <template #footer>\n      <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n        <MButton label=\"Dismiss\" type=\"text\"/>\n        <MButton label=\"Continue\" />\n      </div>\n    </template>\n  </MCard>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2956,7 +2974,7 @@
           "sectionId": "shadow",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCard } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:grid;gap:var(--m-space-4);max-width:28rem;padding:var(--m-space-2)\">\n    <MCard title=\"Flat (default)\" shadow=\"never\">\n      Flat surface; use `shadow=\"hover\"` when you want elevation on interaction only.\n    </MCard>\n    <MCard title=\"Hover shadow\" shadow=\"hover\">\n      Same elevation as `always`, shown only on hover (`--m-card-shadow-rest`).\n    </MCard>\n    <MCard title=\"Always elevated\" shadow=\"always\">\n      Resting shadow (`--m-card-shadow-rest` → `--m-shadow-raised`); use for dashboard modules.\n    </MCard>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCard, MInput } from 'morya-ui'\nimport { ref } from 'vue';\n\nconst inputValue = ref('')\n</script>\n\n<template>\n  <div style=\"display:grid;gap:var(--m-space-4);max-width:28rem;padding:var(--m-space-2)\">\n    <MCard title=\"Flat (default)\" shadow=\"never\">\n      Flat surface; use `shadow=\"hover\"` when you want elevation on interaction only.\n    </MCard>\n    <MCard title=\"Hover shadow\" shadow=\"hover\">\n      Same elevation as `always`, shown only on hover (`--m-card-shadow-rest`).\n\n      <MInput v-model=\"inputValue\" placeholder=\"Hover me\" />\n    </MCard>\n    <MCard title=\"Always elevated\" shadow=\"always\">\n      Resting shadow (`--m-card-shadow-rest` → `--m-shadow-raised`); use for dashboard modules.\n    </MCard>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -2974,7 +2992,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MCard } from 'morya-ui'\n</script>\n\n<template>\n  <MCard title=\"Project overview\" subtitle=\"Updated 2 hours ago\">\n    <p style=\"margin:0;color:var(--m-color-text-muted)\">\n      Title and subtitle align in the header. Body content stays in the default slot.\n    </p>\n    <template #footer>\n      <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n        <MButton label=\"Dismiss\" severity=\"secondary\" text />\n        <MButton label=\"Continue\" />\n      </div>\n    </template>\n  </MCard>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MCard } from 'morya-ui'\n</script>\n\n<template>\n  <MCard title=\"Project overview\" subtitle=\"Updated 2 hours ago\">\n    <p style=\"margin:0;color:var(--m-color-text-muted)\">\n      Title and subtitle align in the header. Body content stays in the default slot.\n    </p>\n    <template #footer>\n      <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n        <MButton label=\"Dismiss\" type=\"text\"/>\n        <MButton label=\"Continue\" />\n      </div>\n    </template>\n  </MCard>\n</template>",
           "locale": "en-US"
         },
         {
@@ -3001,7 +3019,7 @@
           "sectionId": "shadow",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCard } from 'morya-ui'\n</script>\n\n<template>\n  <div style=\"display:grid;gap:var(--m-space-4);max-width:28rem;padding:var(--m-space-2)\">\n    <MCard title=\"Flat (default)\" shadow=\"never\">\n      Flat surface; use `shadow=\"hover\"` when you want elevation on interaction only.\n    </MCard>\n    <MCard title=\"Hover shadow\" shadow=\"hover\">\n      Same elevation as `always`, shown only on hover (`--m-card-shadow-rest`).\n    </MCard>\n    <MCard title=\"Always elevated\" shadow=\"always\">\n      Resting shadow (`--m-card-shadow-rest` → `--m-shadow-raised`); use for dashboard modules.\n    </MCard>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCard, MInput } from 'morya-ui'\nimport { ref } from 'vue';\n\nconst inputValue = ref('')\n</script>\n\n<template>\n  <div style=\"display:grid;gap:var(--m-space-4);max-width:28rem;padding:var(--m-space-2)\">\n    <MCard title=\"Flat (default)\" shadow=\"never\">\n      Flat surface; use `shadow=\"hover\"` when you want elevation on interaction only.\n    </MCard>\n    <MCard title=\"Hover shadow\" shadow=\"hover\">\n      Same elevation as `always`, shown only on hover (`--m-card-shadow-rest`).\n\n      <MInput v-model=\"inputValue\" placeholder=\"Hover me\" />\n    </MCard>\n    <MCard title=\"Always elevated\" shadow=\"always\">\n      Resting shadow (`--m-card-shadow-rest` → `--m-shadow-raised`); use for dashboard modules.\n    </MCard>\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -3127,79 +3145,176 @@
       "name": "Carousel",
       "exportName": "MCarousel",
       "category": "03 / DATA",
-      "description": "轮播展示一组内容项。",
-      "descriptionEn": "Carousel for a set of content items.",
+      "description": "轮播展示一组内容项，支持滑动 / 淡入 / 卡片效果。",
+      "descriptionEn": "Carousel for a set of content items with slide / fade / card effects.",
       "import": "import { MCarousel } from 'morya-ui'",
       "props": [
         {
-          "name": "value",
-          "type": "unknown[]",
+          "name": "currentIndex",
+          "type": "number",
           "default": "—",
-          "description": "内容列表。"
+          "description": "受控当前页，配合 `v-model:currentIndex`。"
         },
         {
-          "name": "numVisible",
+          "name": "defaultIndex",
           "type": "number",
+          "default": "0",
+          "description": "非受控初始页。"
+        },
+        {
+          "name": "showArrow",
+          "type": "boolean",
+          "default": "false",
+          "description": "显示箭头。"
+        },
+        {
+          "name": "showDots",
+          "type": "boolean",
+          "default": "true",
+          "description": "显示指示点。"
+        },
+        {
+          "name": "dotType",
+          "type": "'dot' | 'line'",
+          "default": "'dot'",
+          "description": "指示点样式。"
+        },
+        {
+          "name": "dotPlacement",
+          "type": "'top' | 'bottom' | 'left' | 'right'",
+          "default": "'bottom'",
+          "description": "指示点位置。"
+        },
+        {
+          "name": "slidesPerView",
+          "type": "number | 'auto'",
           "default": "1",
-          "description": "同时可见项数。"
+          "description": "一屏可见数量（`slide`）。"
+        },
+        {
+          "name": "spaceBetween",
+          "type": "number",
+          "default": "0",
+          "description": "幻灯片间距（px）。"
         },
         {
-          "name": "circular",
+          "name": "centeredSlides",
           "type": "boolean",
           "default": "false",
-          "description": "循环翻页。"
+          "description": "居中当前页。"
+        },
+        {
+          "name": "direction",
+          "type": "'horizontal' | 'vertical'",
+          "default": "'horizontal'",
+          "description": "方向。"
         },
         {
           "name": "autoplay",
           "type": "boolean",
           "default": "false",
-          "description": "自动翻页。"
+          "description": "自动播放。"
         },
         {
           "name": "interval",
           "type": "number",
-          "default": "3000",
-          "description": "自动翻页间隔（毫秒）。"
+          "default": "5000",
+          "description": "自动播放间隔（ms）。"
         },
         {
-          "name": "showArrows",
+          "name": "loop",
           "type": "boolean",
           "default": "true",
-          "description": "显示左右箭头。"
+          "description": "循环。"
+        },
+        {
+          "name": "effect",
+          "type": "'slide' | 'fade' | 'card'",
+          "default": "'slide'",
+          "description": "过渡效果。"
+        },
+        {
+          "name": "trigger",
+          "type": "'click' | 'hover'",
+          "default": "'click'",
+          "description": "指示点触发方式。"
         },
         {
-          "name": "showIndicators",
+          "name": "touchable",
           "type": "boolean",
           "default": "true",
-          "description": "显示指示点。"
+          "description": "触摸滑动。"
         },
         {
-          "name": "page",
+          "name": "draggable",
+          "type": "boolean",
+          "default": "false",
+          "description": "鼠标拖拽。"
+        },
+        {
+          "name": "mousewheel",
+          "type": "boolean",
+          "default": "false",
+          "description": "滚轮切换。"
+        },
+        {
+          "name": "keyboard",
+          "type": "boolean",
+          "default": "false",
+          "description": "方向键切换（需聚焦）。"
+        },
+        {
+          "name": "transitionDuration",
           "type": "number",
-          "default": "—",
-          "description": "—"
+          "default": "300",
+          "description": "过渡时长（ms）。"
         },
         {
           "name": "pt",
           "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
           "default": "—",
-          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
+          "description": "DOM 透传。"
         }
       ],
       "events": [
         {
-          "name": "update:page",
-          "payload": "number",
-          "description": "页码变化。"
+          "name": "update:currentIndex",
+          "payload": "(currentIndex, lastIndex)",
+          "description": "当前页变化。"
         }
       ],
       "slots": [
         {
-          "name": "item",
-          "description": "`{ item, index }` 单项。"
+          "name": "default",
+          "description": "幻灯片内容，建议使用 `MCarouselItem`。"
+        },
+        {
+          "name": "arrow",
+          "description": "`{ prev, next, total, currentIndex }` 自定义箭头。"
+        },
+        {
+          "name": "dots",
+          "description": "`{ total, currentIndex, to }` 自定义指示点。"
+        }
+      ],
+      "methods": [
+        {
+          "name": "prev",
+          "description": "上一页。"
+        },
+        {
+          "name": "next",
+          "description": "下一页。"
+        },
+        {
+          "name": "to",
+          "description": "跳到指定页。"
+        },
+        {
+          "name": "getCurrentIndex",
+          "description": "获取当前页。"
         }
       ],
-      "methods": [],
       "examples": [
         {
           "id": "引入-1",
@@ -3207,7 +3322,7 @@
           "sectionId": "引入",
           "lang": "ts",
           "preview": false,
-          "code": "import { MCarousel } from 'morya-ui'",
+          "code": "import { MCarousel, MCarouselItem } from 'morya-ui'",
           "locale": "zh-CN"
         },
         {
@@ -3216,7 +3331,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCarousel } from 'morya-ui'\n\nconst value = ['春', '夏', '秋', '冬']\n</script>\n\n<template>\n  <MCarousel :value=\"value\" :num-visible=\"1\" circular>\n    <template #item=\"{ item }\">\n      <div style=\"padding:2rem;text-align:center;background:var(--m-color-surface-muted, #f3f4f6);border-radius:var(--m-radius-md)\">\n        {{ item }}\n      </div>\n    </template>\n  </MCarousel>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = [\n  { title: '春', color: 'color-mix(in srgb, var(--m-color-success) 18%, var(--m-color-surface))' },\n  { title: '夏', color: 'color-mix(in srgb, var(--m-color-warning) 18%, var(--m-color-surface))' },\n  { title: '秋', color: 'color-mix(in srgb, var(--m-color-danger) 16%, var(--m-color-surface))' },\n  { title: '冬', color: 'color-mix(in srgb, var(--m-color-info) 18%, var(--m-color-surface))' },\n]\n</script>\n\n<template>\n  <MCarousel show-arrow style=\"height: 180px\">\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide.title\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          display: flex;\n          font-size: 1.5rem;\n          height: 100%;\n          justify-content: center;\n          border-radius: var(--m-radius-md);\n        \"\n        :style=\"{ background: slide.color }\"\n      >\n        {{ slide.title }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -3225,7 +3340,34 @@
           "sectionId": "autoplay",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCarousel } from 'morya-ui'\n\nconst value = ['A', 'B', 'C']\n</script>\n\n<template>\n  <MCarousel :value=\"value\" autoplay :interval=\"4000\" :show-arrows=\"false\">\n    <template #item=\"{ item }\">\n      <div style=\"padding:1.5rem;text-align:center;background:var(--m-color-surface-muted, #f3f4f6);border-radius:var(--m-radius-md)\">\n        {{ item }}\n      </div>\n    </template>\n  </MCarousel>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['01', '02', '03', '04']\n</script>\n\n<template>\n  <MCarousel\n    autoplay\n    :interval=\"4000\"\n    show-arrow\n    style=\"height: 160px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: var(--m-color-surface-muted, #f3f4f6);\n          border-radius: var(--m-radius-md);\n          display: flex;\n          font-size: 2rem;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "过渡效果-1",
+          "section": "过渡效果",
+          "sectionId": "过渡效果",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['卡片 A', '卡片 B', '卡片 C', '卡片 D']\n</script>\n\n<template>\n  <div class=\"demo-stack\">\n    <MCarousel\n      class=\"demo-carousel\"\n      effect=\"fade\"\n      show-arrow\n    >\n      <MCarouselItem\n        v-for=\"slide in slides\"\n        :key=\"`fade-${slide}`\"\n      >\n        <div class=\"demo-slide\">\n          Fade · {{ slide }}\n        </div>\n      </MCarouselItem>\n    </MCarousel>\n\n    <MCarousel\n      class=\"demo-carousel demo-carousel--card\"\n      effect=\"card\"\n      show-arrow\n    >\n      <MCarouselItem\n        v-for=\"slide in slides\"\n        :key=\"`card-${slide}`\"\n      >\n        <div class=\"demo-slide demo-slide--card\">\n          Card · {{ slide }}\n        </div>\n      </MCarouselItem>\n    </MCarousel>\n  </div>\n</template>\n\n<style scoped>\n.demo-stack {\n  display: grid;\n  gap: 1.5rem;\n  width: 100%;\n}\n\n.demo-carousel {\n  height: 140px;\n  width: 100%;\n}\n\n.demo-carousel--card {\n  height: 160px;\n}\n\n.demo-slide {\n  align-items: center;\n  background: color-mix(in srgb, var(--m-color-primary) 12%, var(--m-color-surface));\n  border-radius: var(--m-radius-md);\n  box-sizing: border-box;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n}\n\n.demo-slide--card {\n  background: var(--m-color-surface);\n  border: var(--m-border-width) solid var(--m-color-border);\n  box-shadow: var(--m-shadow-md);\n}\n</style>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "多图同屏-1",
+          "section": "多图同屏",
+          "sectionId": "多图同屏",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['一', '二', '三', '四', '五', '六']\n</script>\n\n<template>\n  <MCarousel\n    :slides-per-view=\"3\"\n    :space-between=\"12\"\n    :loop=\"false\"\n    show-arrow\n    draggable\n    style=\"height: 120px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: var(--m-color-surface-muted, #f3f4f6);\n          border-radius: var(--m-radius-md);\n          display: flex;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
+          "locale": "zh-CN"
+        },
+        {
+          "id": "纵向-1",
+          "section": "纵向",
+          "sectionId": "纵向",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['上', '中', '下']\n</script>\n\n<template>\n  <MCarousel\n    direction=\"vertical\"\n    show-arrow\n    dot-placement=\"right\"\n    dot-type=\"line\"\n    style=\"height: 200px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: color-mix(in srgb, var(--m-color-primary) 10%, var(--m-color-surface));\n          border-radius: var(--m-radius-md);\n          display: flex;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -3234,7 +3376,7 @@
           "sectionId": "import",
           "lang": "ts",
           "preview": false,
-          "code": "import { MCarousel } from 'morya-ui'",
+          "code": "import { MCarousel, MCarouselItem } from 'morya-ui'",
           "locale": "en-US"
         },
         {
@@ -3243,7 +3385,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCarousel } from 'morya-ui'\n\nconst value = ['Spring', 'Summer', 'Autumn', 'Winter']\n</script>\n\n<template>\n  <MCarousel :value=\"value\" :num-visible=\"1\" circular>\n    <template #item=\"{ item }\">\n      <div style=\"padding:2rem;text-align:center;background:var(--m-color-surface-muted, #f3f4f6);border-radius:var(--m-radius-md)\">\n        {{ item }}\n      </div>\n    </template>\n  </MCarousel>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = [\n  { title: 'Spring', color: 'color-mix(in srgb, var(--m-color-success) 18%, var(--m-color-surface))' },\n  { title: 'Summer', color: 'color-mix(in srgb, var(--m-color-warning) 18%, var(--m-color-surface))' },\n  { title: 'Autumn', color: 'color-mix(in srgb, var(--m-color-danger) 16%, var(--m-color-surface))' },\n  { title: 'Winter', color: 'color-mix(in srgb, var(--m-color-info) 18%, var(--m-color-surface))' },\n]\n</script>\n\n<template>\n  <MCarousel show-arrow style=\"height: 180px\">\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide.title\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          display: flex;\n          font-size: 1.5rem;\n          height: 100%;\n          justify-content: center;\n          border-radius: var(--m-radius-md);\n        \"\n        :style=\"{ background: slide.color }\"\n      >\n        {{ slide.title }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
           "locale": "en-US"
         },
         {
@@ -3252,24 +3394,51 @@
           "sectionId": "autoplay",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MCarousel } from 'morya-ui'\n\nconst value = ['A', 'B', 'C']\n</script>\n\n<template>\n  <MCarousel :value=\"value\" autoplay :interval=\"4000\" :show-arrows=\"false\">\n    <template #item=\"{ item }\">\n      <div style=\"padding:1.5rem;text-align:center;background:var(--m-color-surface-muted, #f3f4f6);border-radius:var(--m-radius-md)\">\n        {{ item }}\n      </div>\n    </template>\n  </MCarousel>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['01', '02', '03', '04']\n</script>\n\n<template>\n  <MCarousel\n    autoplay\n    :interval=\"4000\"\n    show-arrow\n    style=\"height: 160px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: var(--m-color-surface-muted, #f3f4f6);\n          border-radius: var(--m-radius-md);\n          display: flex;\n          font-size: 2rem;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
+          "locale": "en-US"
+        },
+        {
+          "id": "effects-1",
+          "section": "Effects",
+          "sectionId": "effects",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['Card A', 'Card B', 'Card C', 'Card D']\n</script>\n\n<template>\n  <div class=\"demo-stack\">\n    <MCarousel\n      class=\"demo-carousel\"\n      effect=\"fade\"\n      show-arrow\n    >\n      <MCarouselItem\n        v-for=\"slide in slides\"\n        :key=\"`fade-${slide}`\"\n      >\n        <div class=\"demo-slide\">\n          Fade · {{ slide }}\n        </div>\n      </MCarouselItem>\n    </MCarousel>\n\n    <MCarousel\n      class=\"demo-carousel demo-carousel--card\"\n      effect=\"card\"\n      show-arrow\n    >\n      <MCarouselItem\n        v-for=\"slide in slides\"\n        :key=\"`card-${slide}`\"\n      >\n        <div class=\"demo-slide demo-slide--card\">\n          Card · {{ slide }}\n        </div>\n      </MCarouselItem>\n    </MCarousel>\n  </div>\n</template>\n\n<style scoped>\n.demo-stack {\n  display: grid;\n  gap: 1.5rem;\n  width: 100%;\n}\n\n.demo-carousel {\n  height: 140px;\n  width: 100%;\n}\n\n.demo-carousel--card {\n  height: 160px;\n}\n\n.demo-slide {\n  align-items: center;\n  background: color-mix(in srgb, var(--m-color-primary) 12%, var(--m-color-surface));\n  border-radius: var(--m-radius-md);\n  box-sizing: border-box;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n}\n\n.demo-slide--card {\n  background: var(--m-color-surface);\n  border: var(--m-border-width) solid var(--m-color-border);\n  box-shadow: var(--m-shadow-md);\n}\n</style>",
+          "locale": "en-US"
+        },
+        {
+          "id": "multiple-slides-1",
+          "section": "Multiple slides",
+          "sectionId": "multiple-slides",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['One', 'Two', 'Three', 'Four', 'Five', 'Six']\n</script>\n\n<template>\n  <MCarousel\n    :slides-per-view=\"3\"\n    :space-between=\"12\"\n    :loop=\"false\"\n    show-arrow\n    draggable\n    style=\"height: 120px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: var(--m-color-surface-muted, #f3f4f6);\n          border-radius: var(--m-radius-md);\n          display: flex;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
+          "locale": "en-US"
+        },
+        {
+          "id": "vertical-1",
+          "section": "Vertical",
+          "sectionId": "vertical",
+          "lang": "vue",
+          "preview": true,
+          "code": "<script setup lang=\"ts\">\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n\nconst slides = ['Top', 'Middle', 'Bottom']\n</script>\n\n<template>\n  <MCarousel\n    direction=\"vertical\"\n    show-arrow\n    dot-placement=\"right\"\n    dot-type=\"line\"\n    style=\"height: 200px\"\n  >\n    <MCarouselItem\n      v-for=\"slide in slides\"\n      :key=\"slide\"\n    >\n      <div\n        style=\"\n          align-items: center;\n          background: color-mix(in srgb, var(--m-color-primary) 10%, var(--m-color-surface));\n          border-radius: var(--m-radius-md);\n          display: flex;\n          height: 100%;\n          justify-content: center;\n        \"\n      >\n        {{ slide }}\n      </div>\n    </MCarouselItem>\n  </MCarousel>\n</template>",
           "locale": "en-US"
         }
       ],
       "locales": {
         "zh-CN": {
           "title": "Carousel",
-          "description": "轮播展示一组内容项。",
+          "description": "轮播展示一组内容项，支持滑动 / 淡入 / 卡片效果。",
           "sections": [
             {
               "id": "overview",
               "title": "",
-              "body": "# Carousel\n\n按 `numVisible` 窗口滑动展示内容。"
+              "body": "# Carousel\n\n支持默认插槽 + `MCarouselItem`、多种过渡、指示点样式与方位、触摸/拖拽/滚轮/键盘、自动播放。"
             },
             {
               "id": "引入",
               "title": "引入",
-              "body": "```ts\nimport { MCarousel } from 'morya-ui'\n```"
+              "body": "```ts\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n```"
             },
             {
               "id": "基础用法",
@@ -3279,39 +3448,59 @@
             {
               "id": "autoplay",
               "title": "Autoplay",
-              "body": "`autoplay` 按 `interval`（默认 3000ms）自动翻页。`show-arrows` / `show-indicators` 控制箭头与指示点。\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```"
+              "body": "`autoplay` 按 `interval`（默认 5000ms）自动切换；悬停或聚焦时暂停。\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```"
+            },
+            {
+              "id": "过渡效果",
+              "title": "过渡效果",
+              "body": "`effect` 支持 `slide`（默认）、`fade`、`card`。\n\n```vue preview src=\"./demos/Effects.zh.vue\"\n```"
+            },
+            {
+              "id": "多图同屏",
+              "title": "多图同屏",
+              "body": "`slides-per-view` + `space-between` 控制一屏可见数量与间距；可配合 `draggable` 鼠标拖拽。\n\n```vue preview src=\"./demos/MultiView.zh.vue\"\n```"
+            },
+            {
+              "id": "纵向",
+              "title": "纵向",
+              "body": "`direction=\"vertical\"`，指示点可用 `dot-placement` / `dot-type` 调整。\n\n```vue preview src=\"./demos/Vertical.zh.vue\"\n```"
             },
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `unknown[]` | — | 内容列表。 |\n| `numVisible` | `number` | `1` | 同时可见项数。 |\n| `circular` | `boolean` | `false` | 循环翻页。 |\n| `autoplay` | `boolean` | `false` | 自动翻页。 |\n| `interval` | `number` | `3000` | 自动翻页间隔（毫秒）。 |\n| `showArrows` | `boolean` | `true` | 显示左右箭头。 |\n| `showIndicators` | `boolean` | `true` | 显示指示点。 |\n| `page` | `number` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `currentIndex` | `number` | — | 受控当前页，配合 `v-model:currentIndex`。 |\n| `defaultIndex` | `number` | `0` | 非受控初始页。 |\n| `showArrow` | `boolean` | `false` | 显示箭头。 |\n| `showDots` | `boolean` | `true` | 显示指示点。 |\n| `dotType` | `'dot' \\| 'line'` | `'dot'` | 指示点样式。 |\n| `dotPlacement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 指示点位置。 |\n| `slidesPerView` | `number \\| 'auto'` | `1` | 一屏可见数量（`slide`）。 |\n| `spaceBetween` | `number` | `0` | 幻灯片间距（px）。 |\n| `centeredSlides` | `boolean` | `false` | 居中当前页。 |\n| `direction` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 方向。 |\n| `autoplay` | `boolean` | `false` | 自动播放。 |\n| `interval` | `number` | `5000` | 自动播放间隔（ms）。 |\n| `loop` | `boolean` | `true` | 循环。 |\n| `effect` | `'slide' \\| 'fade' \\| 'card'` | `'slide'` | 过渡效果。 |\n| `trigger` | `'click' \\| 'hover'` | `'click'` | 指示点触发方式。 |\n| `touchable` | `boolean` | `true` | 触摸滑动。 |\n| `draggable` | `boolean` | `false` | 鼠标拖拽。 |\n| `mousewheel` | `boolean` | `false` | 滚轮切换。 |\n| `keyboard` | `boolean` | `false` | 方向键切换（需聚焦）。 |\n| `transitionDuration` | `number` | `300` | 过渡时长（ms）。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传。 |"
             },
             {
               "id": "slots",
               "title": "Slots",
-              "body": "| 插槽 | 说明 |\n| --- | --- |\n| `item` | `{ item, index }` 单项。 |"
+              "body": "| 插槽 | 说明 |\n| --- | --- |\n| `default` | 幻灯片内容，建议使用 `MCarouselItem`。 |\n| `arrow` | `{ prev, next, total, currentIndex }` 自定义箭头。 |\n| `dots` | `{ total, currentIndex, to }` 自定义指示点。 |"
             },
             {
               "id": "events",
               "title": "Events",
-              "body": "| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:page` | `number` | 页码变化。 |"
+              "body": "| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:currentIndex` | `(currentIndex, lastIndex)` | 当前页变化。 |"
+            },
+            {
+              "id": "methods",
+              "title": "Methods",
+              "body": "| 方法 | 说明 |\n| --- | --- |\n| `prev()` | 上一页。 |\n| `next()` | 下一页。 |\n| `to(index)` | 跳到指定页。 |\n| `getCurrentIndex()` | 获取当前页。 |"
             }
           ],
-          "markdown": "---\ntitle: Carousel\ncategory: 03 / DATA\ndescription: 轮播展示一组内容项。\n---\n\n# Carousel\n\n按 `numVisible` 窗口滑动展示内容。\n\n## 引入\n\n```ts\nimport { MCarousel } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Autoplay\n\n`autoplay` 按 `interval`（默认 3000ms）自动翻页。`show-arrows` / `show-indicators` 控制箭头与指示点。\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `unknown[]` | — | 内容列表。 |\n| `numVisible` | `number` | `1` | 同时可见项数。 |\n| `circular` | `boolean` | `false` | 循环翻页。 |\n| `autoplay` | `boolean` | `false` | 自动翻页。 |\n| `interval` | `number` | `3000` | 自动翻页间隔（毫秒）。 |\n| `showArrows` | `boolean` | `true` | 显示左右箭头。 |\n| `showIndicators` | `boolean` | `true` | 显示指示点。 |\n| `page` | `number` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Slots\n\n| 插槽 | 说明 |\n| --- | --- |\n| `item` | `{ item, index }` 单项。 |\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:page` | `number` | 页码变化。 |\n"
+          "markdown": "---\ntitle: Carousel\ncategory: 03 / DATA\ndescription: 轮播展示一组内容项，支持滑动 / 淡入 / 卡片效果。\n---\n\n# Carousel\n\n支持默认插槽 + `MCarouselItem`、多种过渡、指示点样式与方位、触摸/拖拽/滚轮/键盘、自动播放。\n\n## 引入\n\n```ts\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Autoplay\n\n`autoplay` 按 `interval`（默认 5000ms）自动切换；悬停或聚焦时暂停。\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```\n\n## 过渡效果\n\n`effect` 支持 `slide`（默认）、`fade`、`card`。\n\n```vue preview src=\"./demos/Effects.zh.vue\"\n```\n\n## 多图同屏\n\n`slides-per-view` + `space-between` 控制一屏可见数量与间距；可配合 `draggable` 鼠标拖拽。\n\n```vue preview src=\"./demos/MultiView.zh.vue\"\n```\n\n## 纵向\n\n`direction=\"vertical\"`，指示点可用 `dot-placement` / `dot-type` 调整。\n\n```vue preview src=\"./demos/Vertical.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `currentIndex` | `number` | — | 受控当前页，配合 `v-model:currentIndex`。 |\n| `defaultIndex` | `number` | `0` | 非受控初始页。 |\n| `showArrow` | `boolean` | `false` | 显示箭头。 |\n| `showDots` | `boolean` | `true` | 显示指示点。 |\n| `dotType` | `'dot' \\| 'line'` | `'dot'` | 指示点样式。 |\n| `dotPlacement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 指示点位置。 |\n| `slidesPerView` | `number \\| 'auto'` | `1` | 一屏可见数量（`slide`）。 |\n| `spaceBetween` | `number` | `0` | 幻灯片间距（px）。 |\n| `centeredSlides` | `boolean` | `false` | 居中当前页。 |\n| `direction` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 方向。 |\n| `autoplay` | `boolean` | `false` | 自动播放。 |\n| `interval` | `number` | `5000` | 自动播放间隔（ms）。 |\n| `loop` | `boolean` | `true` | 循环。 |\n| `effect` | `'slide' \\| 'fade' \\| 'card'` | `'slide'` | 过渡效果。 |\n| `trigger` | `'click' \\| 'hover'` | `'click'` | 指示点触发方式。 |\n| `touchable` | `boolean` | `true` | 触摸滑动。 |\n| `draggable` | `boolean` | `false` | 鼠标拖拽。 |\n| `mousewheel` | `boolean` | `false` | 滚轮切换。 |\n| `keyboard` | `boolean` | `false` | 方向键切换（需聚焦）。 |\n| `transitionDuration` | `number` | `300` | 过渡时长（ms）。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传。 |\n\n## Slots\n\n| 插槽 | 说明 |\n| --- | --- |\n| `default` | 幻灯片内容，建议使用 `MCarouselItem`。 |\n| `arrow` | `{ prev, next, total, currentIndex }` 自定义箭头。 |\n| `dots` | `{ total, currentIndex, to }` 自定义指示点。 |\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:currentIndex` | `(currentIndex, lastIndex)` | 当前页变化。 |\n\n## Methods\n\n| 方法 | 说明 |\n| --- | --- |\n| `prev()` | 上一页。 |\n| `next()` | 下一页。 |\n| `to(index)` | 跳到指定页。 |\n| `getCurrentIndex()` | 获取当前页。 |\n"
         },
         "en-US": {
           "title": "Carousel",
-          "description": "Carousel for a set of content items.",
+          "description": "Carousel for a set of content items with slide / fade / card effects.",
           "sections": [
             {
               "id": "overview",
               "title": "",
-              "body": "# Carousel\n\nSlides content in a window of `numVisible` items."
+              "body": "# Carousel\n\nSupports a default slot + `MCarouselItem`, multiple effects, dot styles/placement, touch/drag/wheel/keyboard, and autoplay."
             },
             {
               "id": "import",
               "title": "Import",
-              "body": "```ts\nimport { MCarousel } from 'morya-ui'\n```"
+              "body": "```ts\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n```"
             },
             {
               "id": "basic",
@@ -3321,25 +3510,45 @@
             {
               "id": "autoplay",
               "title": "Autoplay",
-              "body": "`autoplay` advances pages every `interval` (default 3000ms). `show-arrows` / `show-indicators` control arrows and dots.\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```"
+              "body": "`autoplay` advances every `interval` (default 5000ms). Pauses on hover/focus.\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```"
+            },
+            {
+              "id": "effects",
+              "title": "Effects",
+              "body": "`effect` supports `slide` (default), `fade`, and `card`.\n\n```vue preview src=\"./demos/Effects.en.vue\"\n```"
+            },
+            {
+              "id": "multiple-slides",
+              "title": "Multiple slides",
+              "body": "Use `slides-per-view` + `space-between`. Enable `draggable` for mouse drag.\n\n```vue preview src=\"./demos/MultiView.en.vue\"\n```"
+            },
+            {
+              "id": "vertical",
+              "title": "Vertical",
+              "body": "Set `direction=\"vertical\"`. Tune dots with `dot-placement` / `dot-type`.\n\n```vue preview src=\"./demos/Vertical.en.vue\"\n```"
             },
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `unknown[]` | — | Content list. |\n| `numVisible` | `number` | `1` | Number of items visible at once. |\n| `circular` | `boolean` | `false` | Loop paging. |\n| `autoplay` | `boolean` | `false` | Auto-advance. |\n| `interval` | `number` | `3000` | Autoplay interval in milliseconds. |\n| `showArrows` | `boolean` | `true` | Show prev/next arrows. |\n| `showIndicators` | `boolean` | `true` | Show page dots. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `currentIndex` | `number` | — | Controlled index (`v-model:currentIndex`). |\n| `defaultIndex` | `number` | `0` | Uncontrolled initial index. |\n| `showArrow` | `boolean` | `false` | Show arrows. |\n| `showDots` | `boolean` | `true` | Show dots. |\n| `dotType` | `'dot' \\| 'line'` | `'dot'` | Dot style. |\n| `dotPlacement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | Dot placement. |\n| `slidesPerView` | `number \\| 'auto'` | `1` | Visible slides (`slide`). |\n| `spaceBetween` | `number` | `0` | Gap between slides (px). |\n| `centeredSlides` | `boolean` | `false` | Center the active slide. |\n| `direction` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Orientation. |\n| `autoplay` | `boolean` | `false` | Auto play. |\n| `interval` | `number` | `5000` | Autoplay interval (ms). |\n| `loop` | `boolean` | `true` | Loop. |\n| `effect` | `'slide' \\| 'fade' \\| 'card'` | `'slide'` | Transition effect. |\n| `trigger` | `'click' \\| 'hover'` | `'click'` | How dots activate slides. |\n| `touchable` | `boolean` | `true` | Touch swipe. |\n| `draggable` | `boolean` | `false` | Mouse drag. |\n| `mousewheel` | `boolean` | `false` | Mouse wheel. |\n| `keyboard` | `boolean` | `false` | Arrow keys when focused. |\n| `transitionDuration` | `number` | `300` | Transition duration (ms). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through. |"
             },
             {
               "id": "slots",
               "title": "Slots",
-              "body": "| Slot | Description |\n| --- | --- |\n| `item` | `{ item, index }` for each item. |"
+              "body": "| Slot | Description |\n| --- | --- |\n| `default` | Slides; prefer `MCarouselItem`. |\n| `arrow` | `{ prev, next, total, currentIndex }` custom arrows. |\n| `dots` | `{ total, currentIndex, to }` custom dots. |"
             },
             {
               "id": "events",
               "title": "Events",
-              "body": "| Event | Prop | Description |\n| --- | --- | --- |\n| `update:page` | `number` | Page change. |"
+              "body": "| Event | Payload | Description |\n| --- | --- | --- |\n| `update:currentIndex` | `(currentIndex, lastIndex)` | Active index changed. |"
+            },
+            {
+              "id": "methods",
+              "title": "Methods",
+              "body": "| Method | Description |\n| --- | --- |\n| `prev()` | Go to previous. |\n| `next()` | Go to next. |\n| `to(index)` | Jump to index. |\n| `getCurrentIndex()` | Read current index. |"
             }
           ],
-          "markdown": "---\ntitle: Carousel\ncategory: 03 / DATA\ndescription: Carousel for a set of content items.\n---\n\n# Carousel\n\nSlides content in a window of `numVisible` items.\n\n## Import\n\n```ts\nimport { MCarousel } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Autoplay\n\n`autoplay` advances pages every `interval` (default 3000ms). `show-arrows` / `show-indicators` control arrows and dots.\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `unknown[]` | — | Content list. |\n| `numVisible` | `number` | `1` | Number of items visible at once. |\n| `circular` | `boolean` | `false` | Loop paging. |\n| `autoplay` | `boolean` | `false` | Auto-advance. |\n| `interval` | `number` | `3000` | Autoplay interval in milliseconds. |\n| `showArrows` | `boolean` | `true` | Show prev/next arrows. |\n| `showIndicators` | `boolean` | `true` | Show page dots. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |\n\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `item` | `{ item, index }` for each item. |\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `update:page` | `number` | Page change. |\n"
+          "markdown": "---\ntitle: Carousel\ncategory: 03 / DATA\ndescription: Carousel for a set of content items with slide / fade / card effects.\n---\n\n# Carousel\n\nSupports a default slot + `MCarouselItem`, multiple effects, dot styles/placement, touch/drag/wheel/keyboard, and autoplay.\n\n## Import\n\n```ts\nimport { MCarousel, MCarouselItem } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Autoplay\n\n`autoplay` advances every `interval` (default 5000ms). Pauses on hover/focus.\n\n```vue preview src=\"./demos/Autoplay.vue\"\n```\n\n## Effects\n\n`effect` supports `slide` (default), `fade`, and `card`.\n\n```vue preview src=\"./demos/Effects.en.vue\"\n```\n\n## Multiple slides\n\nUse `slides-per-view` + `space-between`. Enable `draggable` for mouse drag.\n\n```vue preview src=\"./demos/MultiView.en.vue\"\n```\n\n## Vertical\n\nSet `direction=\"vertical\"`. Tune dots with `dot-placement` / `dot-type`.\n\n```vue preview src=\"./demos/Vertical.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `currentIndex` | `number` | — | Controlled index (`v-model:currentIndex`). |\n| `defaultIndex` | `number` | `0` | Uncontrolled initial index. |\n| `showArrow` | `boolean` | `false` | Show arrows. |\n| `showDots` | `boolean` | `true` | Show dots. |\n| `dotType` | `'dot' \\| 'line'` | `'dot'` | Dot style. |\n| `dotPlacement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | Dot placement. |\n| `slidesPerView` | `number \\| 'auto'` | `1` | Visible slides (`slide`). |\n| `spaceBetween` | `number` | `0` | Gap between slides (px). |\n| `centeredSlides` | `boolean` | `false` | Center the active slide. |\n| `direction` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Orientation. |\n| `autoplay` | `boolean` | `false` | Auto play. |\n| `interval` | `number` | `5000` | Autoplay interval (ms). |\n| `loop` | `boolean` | `true` | Loop. |\n| `effect` | `'slide' \\| 'fade' \\| 'card'` | `'slide'` | Transition effect. |\n| `trigger` | `'click' \\| 'hover'` | `'click'` | How dots activate slides. |\n| `touchable` | `boolean` | `true` | Touch swipe. |\n| `draggable` | `boolean` | `false` | Mouse drag. |\n| `mousewheel` | `boolean` | `false` | Mouse wheel. |\n| `keyboard` | `boolean` | `false` | Arrow keys when focused. |\n| `transitionDuration` | `number` | `300` | Transition duration (ms). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Slides; prefer `MCarouselItem`. |\n| `arrow` | `{ prev, next, total, currentIndex }` custom arrows. |\n| `dots` | `{ total, currentIndex, to }` custom dots. |\n\n## Events\n\n| Event | Payload | Description |\n| --- | --- | --- |\n| `update:currentIndex` | `(currentIndex, lastIndex)` | Active index changed. |\n\n## Methods\n\n| Method | Description |\n| --- | --- |\n| `prev()` | Go to previous. |\n| `next()` | Go to next. |\n| `to(index)` | Jump to index. |\n| `getCurrentIndex()` | Read current index. |\n"
         }
       }
     },
@@ -4064,6 +4273,12 @@
           "type": "'small' | 'large' | 'sm' | 'md' | 'lg'",
           "default": "—",
           "description": "尺寸。"
+        },
+        {
+          "name": "pt",
+          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "default": "—",
+          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
         }
       ],
       "events": [
@@ -4145,7 +4360,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 芯片文案。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 前置图标名称。 |\n| `image` | `string` | — | 前置图片 URL（优先于 icon）。 |\n| `removable` | `boolean` | `false` | 显示 × 移除按钮。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `severity` | `MTagSeverity \\| 'warning'` | — | 语义色。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 芯片文案。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 前置图标名称。 |\n| `image` | `string` | — | 前置图片 URL（优先于 icon）。 |\n| `removable` | `boolean` | `false` | 显示 × 移除按钮。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `severity` | `MTagSeverity \\| 'warning'` | — | 语义色。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -4158,7 +4373,7 @@
               "body": "| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容。 |\n| `icon` | 前置图标。 |"
             }
           ],
-          "markdown": "---\ntitle: Chip\ncategory: 01 / BASIC\ndescription: 芯片用于展示标签化信息，可带图标、图片与移除操作。\n---\n\n# Chip\n\n芯片用于展示简短标签信息，可选图标/图片与移除按钮。\n\n## 引入\n\n```ts\nimport { MChip } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 芯片文案。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 前置图标名称。 |\n| `image` | `string` | — | 前置图片 URL（优先于 icon）。 |\n| `removable` | `boolean` | `false` | 显示 × 移除按钮。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `severity` | `MTagSeverity \\| 'warning'` | — | 语义色。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `remove` | `MouseEvent` | 点击移除按钮时触发。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容。 |\n| `icon` | 前置图标。 |\n"
+          "markdown": "---\ntitle: Chip\ncategory: 01 / BASIC\ndescription: 芯片用于展示标签化信息，可带图标、图片与移除操作。\n---\n\n# Chip\n\n芯片用于展示简短标签信息，可选图标/图片与移除按钮。\n\n## 引入\n\n```ts\nimport { MChip } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 芯片文案。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 前置图标名称。 |\n| `image` | `string` | — | 前置图片 URL（优先于 icon）。 |\n| `removable` | `boolean` | `false` | 显示 × 移除按钮。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `severity` | `MTagSeverity \\| 'warning'` | — | 语义色。 |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `remove` | `MouseEvent` | 点击移除按钮时触发。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容。 |\n| `icon` | 前置图标。 |\n"
         },
         "en-US": {
           "title": "Chip",
@@ -4182,7 +4397,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | 鈥?| Chip text. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| Leading icon name. |\n| `image` | `string` | 鈥?| Leading image URL (takes precedence over icon). |\n| `removable` | `boolean` | `false` | Show 脳 remove button. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `severity` | `MTagSeverity \\| 'warning'` | 鈥?| Semantic color. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | 鈥?| Chip text. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| Leading icon name. |\n| `image` | `string` | 鈥?| Leading image URL (takes precedence over icon). |\n| `removable` | `boolean` | `false` | Show 脳 remove button. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `severity` | `MTagSeverity \\| 'warning'` | 鈥?| Semantic color. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -4195,7 +4410,7 @@
               "body": "| Slot | Description |\n| --- | --- |\n| `default` | Label content. |\n| `icon` | Leading icon. |"
             }
           ],
-          "markdown": "---\ntitle: Chip\ncategory: 01 / BASIC\ndescription: Chip displays tagged information, optionally with an icon, image, and remove action.\n---\n\n# Chip\n\nChip displays short tagged information, with optional icon/image and a remove button.\n\n## Import\n\n```ts\nimport { MChip } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | 鈥?| Chip text. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| Leading icon name. |\n| `image` | `string` | 鈥?| Leading image URL (takes precedence over icon). |\n| `removable` | `boolean` | `false` | Show 脳 remove button. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `severity` | `MTagSeverity \\| 'warning'` | 鈥?| Semantic color. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `remove` | `MouseEvent` | Fired when the remove button is clicked. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Label content. |\n| `icon` | Leading icon. |\n"
+          "markdown": "---\ntitle: Chip\ncategory: 01 / BASIC\ndescription: Chip displays tagged information, optionally with an icon, image, and remove action.\n---\n\n# Chip\n\nChip displays short tagged information, with optional icon/image and a remove button.\n\n## Import\n\n```ts\nimport { MChip } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | 鈥?| Chip text. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| Leading icon name. |\n| `image` | `string` | 鈥?| Leading image URL (takes precedence over icon). |\n| `removable` | `boolean` | `false` | Show 脳 remove button. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `severity` | `MTagSeverity \\| 'warning'` | 鈥?| Semantic color. |\n| `size` | `'small' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `remove` | `MouseEvent` | Fired when the remove button is clicked. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Label content. |\n| `icon` | Leading icon. |\n"
         }
       }
     },
@@ -4852,10 +5067,10 @@
           "description": "取消按钮文案。"
         },
         {
-          "name": "acceptSeverity",
-          "type": "[ButtonSeverity](/docs/types#ButtonSeverity)",
+          "name": "acceptColor",
+          "type": "[ButtonColor](/docs/types#ButtonColor)",
           "default": "—",
-          "description": "确认按钮语义色。"
+          "description": "确认按钮颜色。"
         },
         {
           "name": "type",
@@ -4972,7 +5187,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst visible = ref(false)\n</script>\n\n<template>\n  <MButton label=\"删除\" severity=\"danger\" @click=\"visible = true\" />\n  <MConfirmDialog\n    v-model=\"visible\"\n    header=\"删除确认\"\n    message=\"确定要删除该项吗？此操作不可撤销。\"\n    accept-label=\"删除\"\n    reject-label=\"取消\"\n    accept-severity=\"danger\"\n  />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst visible = ref(false)\n</script>\n\n<template>\n  <MButton label=\"删除\" @click=\"visible = true\" danger type=\"primary\"/>\n  <MConfirmDialog\n    v-model=\"visible\"\n    header=\"删除确认\"\n    message=\"确定要删除该项吗？此操作不可撤销。\"\n    accept-label=\"删除\"\n    reject-label=\"取消\"\n    accept-color=\"danger\"\n  />\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -4990,7 +5205,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst visible = ref(false)\n</script>\n\n<template>\n  <MButton label=\"Delete\" severity=\"danger\" @click=\"visible = true\" />\n  <MConfirmDialog\n    v-model=\"visible\"\n    header=\"Confirm delete\"\n    message=\"Are you sure you want to delete this item? This action cannot be undone.\"\n    accept-label=\"Delete\"\n    reject-label=\"Cancel\"\n    accept-severity=\"danger\"\n  />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst visible = ref(false)\n</script>\n\n<template>\n  <MButton label=\"Delete\" @click=\"visible = true\" danger type=\"primary\"/>\n  <MConfirmDialog\n    v-model=\"visible\"\n    header=\"Confirm delete\"\n    message=\"Are you sure you want to delete this item? This action cannot be undone.\"\n    accept-label=\"Delete\"\n    reject-label=\"Cancel\"\n    accept-color=\"danger\"\n  />\n</template>",
           "locale": "en-US"
         }
       ],
@@ -5017,7 +5232,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否可见。 |\n| `header` | `string` | `'确认'` | 标题。 |\n| `message` | `string` | — | 正文。 |\n| `acceptLabel` | `string` | `'确认'` | 确认按钮文案。 |\n| `rejectLabel` | `string` | `'取消'` | 取消按钮文案。 |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | 确认按钮语义色。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 正文状态图标；确认流程用本组件，Dialog `type` 只做标题图标。 |\n| `loading` | `boolean` | `false` | 确认按钮加载中。 |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `accept`。 |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `reject`。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `blockScroll` | `boolean` | — | — |\n| `closeOnEsc` | `boolean` | — | — |\n| `closeOnOutsideClick` | `boolean` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否可见。 |\n| `header` | `string` | `'确认'` | 标题。 |\n| `message` | `string` | — | 正文。 |\n| `acceptLabel` | `string` | `'确认'` | 确认按钮文案。 |\n| `rejectLabel` | `string` | `'取消'` | 取消按钮文案。 |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | 确认按钮颜色。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 正文状态图标；确认流程用本组件，Dialog `type` 只做标题图标。 |\n| `loading` | `boolean` | `false` | 确认按钮加载中。 |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `accept`。 |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `reject`。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `blockScroll` | `boolean` | — | — |\n| `closeOnEsc` | `boolean` | — | — |\n| `closeOnOutsideClick` | `boolean` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -5030,7 +5245,7 @@
               "body": "| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 对话框正文。 |\n| `footer` | 自定义 `footer` 内容。 |\n| `header` | 自定义 `header` 内容。 |"
             }
           ],
-          "markdown": "---\ntitle: ConfirmDialog\ncategory: 05 / FEEDBACK\ndescription: 确认 / 取消对话框，复用 Dialog 浮层样式。\n---\n\n# ConfirmDialog\n\n需要用户明确确认时使用的模态对话框。\n\n## 引入\n\n```ts\nimport { MButton, MConfirmDialog } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否可见。 |\n| `header` | `string` | `'确认'` | 标题。 |\n| `message` | `string` | — | 正文。 |\n| `acceptLabel` | `string` | `'确认'` | 确认按钮文案。 |\n| `rejectLabel` | `string` | `'取消'` | 取消按钮文案。 |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | 确认按钮语义色。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 正文状态图标；确认流程用本组件，Dialog `type` 只做标题图标。 |\n| `loading` | `boolean` | `false` | 确认按钮加载中。 |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `accept`。 |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `reject`。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `blockScroll` | `boolean` | — | — |\n| `closeOnEsc` | `boolean` | — | — |\n| `closeOnOutsideClick` | `boolean` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 可见性变化。 |\n| `accept` | — | 点击确认。 |\n| `reject` | — | 点击取消或关闭。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 对话框正文。 |\n| `footer` | 自定义 `footer` 内容。 |\n| `header` | 自定义 `header` 内容。 |\n"
+          "markdown": "---\ntitle: ConfirmDialog\ncategory: 05 / FEEDBACK\ndescription: 确认 / 取消对话框，复用 Dialog 浮层样式。\n---\n\n# ConfirmDialog\n\n需要用户明确确认时使用的模态对话框。\n\n## 引入\n\n```ts\nimport { MButton, MConfirmDialog } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否可见。 |\n| `header` | `string` | `'确认'` | 标题。 |\n| `message` | `string` | — | 正文。 |\n| `acceptLabel` | `string` | `'确认'` | 确认按钮文案。 |\n| `rejectLabel` | `string` | `'取消'` | 取消按钮文案。 |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | 确认按钮颜色。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 正文状态图标；确认流程用本组件，Dialog `type` 只做标题图标。 |\n| `loading` | `boolean` | `false` | 确认按钮加载中。 |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `accept`。 |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭、不触发 `reject`。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `blockScroll` | `boolean` | — | — |\n| `closeOnEsc` | `boolean` | — | — |\n| `closeOnOutsideClick` | `boolean` | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 可见性变化。 |\n| `accept` | — | 点击确认。 |\n| `reject` | — | 点击取消或关闭。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 对话框正文。 |\n| `footer` | 自定义 `footer` 内容。 |\n| `header` | 自定义 `header` 内容。 |\n"
         },
         "en-US": {
           "title": "ConfirmDialog",
@@ -5054,7 +5269,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. |\n| `header` | `string` | locale `confirm` | Title. |\n| `message` | `string` | — | Body text. |\n| `acceptLabel` | `string` | locale `accept` | Accept button label. |\n| `rejectLabel` | `string` | locale `reject` | Reject button label. |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | Accept button semantic color. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon beside the message. |\n| `loading` | `boolean` | `false` | Loading state on the accept button. |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `accept`. |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `reject`. |\n| `teleport` | `boolean` | `true` | Overlay Teleport; defaults to `body`. |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | Mount target; `'self'` / `false` renders in place. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. |\n| `header` | `string` | locale `confirm` | Title. |\n| `message` | `string` | — | Body text. |\n| `acceptLabel` | `string` | locale `accept` | Accept button label. |\n| `rejectLabel` | `string` | locale `reject` | Reject button label. |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | Accept button color. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon beside the message. |\n| `loading` | `boolean` | `false` | Loading state on the accept button. |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `accept`. |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `reject`. |\n| `teleport` | `boolean` | `true` | Overlay Teleport; defaults to `body`. |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | Mount target; `'self'` / `false` renders in place. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -5067,7 +5282,7 @@
               "body": "| Slot | Description |\n| --- | --- |\n| `default` | Dialog body. |"
             }
           ],
-          "markdown": "---\ntitle: ConfirmDialog\ncategory: 05 / FEEDBACK\ndescription: Confirm / cancel dialog that reuses Dialog overlay styling.\n---\n\n# ConfirmDialog\n\nModal dialog used when the user must explicitly confirm an action.\n\n## Import\n\n```ts\nimport { MButton, MConfirmDialog } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. |\n| `header` | `string` | locale `confirm` | Title. |\n| `message` | `string` | — | Body text. |\n| `acceptLabel` | `string` | locale `accept` | Accept button label. |\n| `rejectLabel` | `string` | locale `reject` | Reject button label. |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | Accept button semantic color. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon beside the message. |\n| `loading` | `boolean` | `false` | Loading state on the accept button. |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `accept`. |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `reject`. |\n| `teleport` | `boolean` | `true` | Overlay Teleport; defaults to `body`. |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | Mount target; `'self'` / `false` renders in place. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | Visibility change. |\n| `accept` | — | Accept clicked. |\n| `reject` | — | Reject clicked or dialog closed. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Dialog body. |\n"
+          "markdown": "---\ntitle: ConfirmDialog\ncategory: 05 / FEEDBACK\ndescription: Confirm / cancel dialog that reuses Dialog overlay styling.\n---\n\n# ConfirmDialog\n\nModal dialog used when the user must explicitly confirm an action.\n\n## Import\n\n```ts\nimport { MButton, MConfirmDialog } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. |\n| `header` | `string` | locale `confirm` | Title. |\n| `message` | `string` | — | Body text. |\n| `acceptLabel` | `string` | locale `accept` | Accept button label. |\n| `rejectLabel` | `string` | locale `reject` | Reject button label. |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | Accept button color. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon beside the message. |\n| `loading` | `boolean` | `false` | Loading state on the accept button. |\n| `beforeAccept` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `accept`. |\n| `beforeReject` | `() => unknown \\| Promise<unknown>` | — | Return `false` to keep open and skip `reject`. |\n| `teleport` | `boolean` | `true` | Overlay Teleport; defaults to `body`. |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | Mount target; `'self'` / `false` renders in place. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | Visibility change. |\n| `accept` | — | Accept clicked. |\n| `reject` | — | Reject clicked or dialog closed. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Dialog body. |\n"
         }
       }
     },
@@ -5153,8 +5368,8 @@
           "description": "进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。"
         },
         {
-          "name": "acceptSeverity",
-          "type": "[ButtonSeverity](/docs/types#ButtonSeverity)",
+          "name": "acceptColor",
+          "type": "[ButtonColor](/docs/types#ButtonColor)",
           "default": "—",
           "description": "—"
         },
@@ -5205,7 +5420,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmPopup } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst target = ref<HTMLElement | null>(null)\n\nfunction ask(event: MouseEvent) {\n  target.value = event.currentTarget as HTMLElement\n  open.value = true\n}\n</script>\n\n<template>\n  <MButton label=\"删除\" severity=\"danger\" @click=\"ask\" />\n  <MConfirmPopup v-model=\"open\" :target=\"target\" message=\"确认删除？\" icon=\"info\" placement=\"top\" />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmPopup } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst target = ref<HTMLElement | null>(null)\n\nfunction ask(event: MouseEvent) {\n  target.value = event.currentTarget as HTMLElement\n  open.value = true\n}\n</script>\n\n<template>\n  <MButton label=\"删除\" @click=\"ask\" danger type=\"primary\"/>\n  <MConfirmPopup v-model=\"open\" :target=\"target\" message=\"确认删除？\" icon=\"info\" placement=\"top\" />\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -5232,7 +5447,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmPopup } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst target = ref<HTMLElement | null>(null)\n\nfunction ask(event: MouseEvent) {\n  target.value = event.currentTarget as HTMLElement\n  open.value = true\n}\n</script>\n\n<template>\n  <MButton label=\"Delete\" severity=\"danger\" @click=\"ask\" />\n  <MConfirmPopup v-model=\"open\" :target=\"target\" message=\"Delete this item?\" icon=\"info\" placement=\"top\" />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MConfirmPopup } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst target = ref<HTMLElement | null>(null)\n\nfunction ask(event: MouseEvent) {\n  target.value = event.currentTarget as HTMLElement\n  open.value = true\n}\n</script>\n\n<template>\n  <MButton label=\"Delete\" @click=\"ask\" danger type=\"primary\"/>\n  <MConfirmPopup v-model=\"open\" :target=\"target\" message=\"Delete this item?\" icon=\"info\" placement=\"top\" />\n</template>",
           "locale": "en-US"
         },
         {
@@ -5273,7 +5488,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否显示。 |\n| `message` | `string` | — | 提示文案。 |\n| `acceptLabel` / `rejectLabel` | `string` | `确认` / `取消` | 按钮。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 文案旁图标。 |\n| `beforeAccept` | `() => boolean \\| Promise<boolean>` | — | 返回 `false` 时保持打开。 |\n| `placement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 相对 `target` 的位置。 |\n| `target` | `HTMLElement \\| null` | — | 锚点。 |\n| `position` | `{ top, left } \\| null` | — | 无锚点时的坐标。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否显示。 |\n| `message` | `string` | — | 提示文案。 |\n| `acceptLabel` / `rejectLabel` | `string` | `确认` / `取消` | 按钮。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 文案旁图标。 |\n| `beforeAccept` | `() => boolean \\| Promise<boolean>` | — | 返回 `false` 时保持打开。 |\n| `placement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 相对 `target` 的位置。 |\n| `target` | `HTMLElement \\| null` | — | 锚点。 |\n| `position` | `{ top, left } \\| null` | — | 无锚点时的坐标。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -5286,7 +5501,7 @@
               "body": "| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 弹出层正文。 |"
             }
           ],
-          "markdown": "---\ntitle: ConfirmPopup\ncategory: 05 / FEEDBACK\ndescription: 锚定在目标旁的确认气泡。\n---\n\n# ConfirmPopup\n\n轻量确认浮层，支持 `target` 或坐标定位。\n\n## 引入\n\n```ts\nimport { MConfirmPopup } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Before accept\n\n`beforeAccept` 返回 `false` 时保持打开且不触发 `accept`。\n\n```vue preview src=\"./demos/BeforeAccept.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否显示。 |\n| `message` | `string` | — | 提示文案。 |\n| `acceptLabel` / `rejectLabel` | `string` | `确认` / `取消` | 按钮。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 文案旁图标。 |\n| `beforeAccept` | `() => boolean \\| Promise<boolean>` | — | 返回 `false` 时保持打开。 |\n| `placement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 相对 `target` 的位置。 |\n| `target` | `HTMLElement \\| null` | — | 锚点。 |\n| `position` | `{ top, left } \\| null` | — | 无锚点时的坐标。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `acceptSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 显隐。 |\n| `accept` / `reject` | — | 确认 / 取消。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 弹出层正文。 |\n"
+          "markdown": "---\ntitle: ConfirmPopup\ncategory: 05 / FEEDBACK\ndescription: 锚定在目标旁的确认气泡。\n---\n\n# ConfirmPopup\n\n轻量确认浮层，支持 `target` 或坐标定位。\n\n## 引入\n\n```ts\nimport { MConfirmPopup } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Before accept\n\n`beforeAccept` 返回 `false` 时保持打开且不触发 `accept`。\n\n```vue preview src=\"./demos/BeforeAccept.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 是否显示。 |\n| `message` | `string` | — | 提示文案。 |\n| `acceptLabel` / `rejectLabel` | `string` | `确认` / `取消` | 按钮。 |\n| `icon` | [IconName](/docs/types#IconName) | — | 文案旁图标。 |\n| `beforeAccept` | `() => boolean \\| Promise<boolean>` | — | 返回 `false` 时保持打开。 |\n| `placement` | `'top' \\| 'bottom' \\| 'left' \\| 'right'` | `'bottom'` | 相对 `target` 的位置。 |\n| `target` | `HTMLElement \\| null` | — | 锚点。 |\n| `position` | `{ top, left } \\| null` | — | 无锚点时的坐标。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self' \\| false` | `'body'` | 挂载目标；`'self'` / `false` 就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `acceptColor` | [ButtonColor](/docs/types#ButtonColor) | — | — |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 显隐。 |\n| `accept` / `reject` | — | 确认 / 取消。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 弹出层正文。 |\n"
         },
         "en-US": {
           "title": "ConfirmPopup",
@@ -6751,10 +6966,10 @@
           "description": "预设页脚按钮；有 `footer` 插槽时忽略"
         },
         {
-          "name": "positiveSeverity",
-          "type": "[ButtonSeverity](/docs/types#ButtonSeverity)",
+          "name": "positiveColor",
+          "type": "[ButtonColor](/docs/types#ButtonColor)",
           "default": "—",
-          "description": "确认按钮语义色"
+          "description": "确认按钮颜色"
         },
         {
           "name": "onPositiveClick",
@@ -6902,7 +7117,7 @@
           "sectionId": "positions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'center' | 'top' | 'topright' | 'bottomleft'>('center')\n\nfunction openAt(next: 'center' | 'top' | 'topright' | 'bottomleft') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Center\" size=\"small\" @click=\"openAt('center')\" />\n    <MButton label=\"Top\" size=\"small\" severity=\"secondary\" @click=\"openAt('top')\" />\n    <MButton label=\"Top Right\" size=\"small\" @click=\"openAt('topright')\" />\n    <MButton label=\"Bottom Left\" size=\"small\" severity=\"secondary\" @click=\"openAt('bottomleft')\" />\n    <MDialog v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Dialog can dock to edges and corners.\n      </p>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'center' | 'top' | 'topright' | 'bottomleft'>('center')\n\nfunction openAt(next: 'center' | 'top' | 'topright' | 'bottomleft') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Center\" size=\"small\" @click=\"openAt('center')\" />\n    <MButton label=\"Top\" size=\"small\" @click=\"openAt('top')\"/>\n    <MButton label=\"Top Right\" size=\"small\" @click=\"openAt('topright')\" />\n    <MButton label=\"Bottom Left\" size=\"small\" @click=\"openAt('bottomleft')\"/>\n    <MDialog v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Dialog can dock to edges and corners.\n      </p>\n    </MDialog>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -6911,7 +7126,7 @@
           "sectionId": "footer-actions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Save changes\" width=\"28rem\">\n      <p style=\"margin:0\">\n        Footer slot is for primary and secondary actions.\n      </p>\n      <template #footer>\n        <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n          <MButton label=\"Cancel\" severity=\"secondary\" text @click=\"open = false\" />\n          <MButton label=\"Confirm\" @click=\"open = false\" />\n        </div>\n      </template>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Save changes\" width=\"28rem\">\n      <p style=\"margin:0\">\n        Footer slot is for primary and secondary actions.\n      </p>\n      <template #footer>\n        <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n          <MButton label=\"Cancel\" @click=\"open = false\" type=\"text\"/>\n          <MButton label=\"Confirm\" @click=\"open = false\" />\n        </div>\n      </template>\n    </MDialog>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -6920,7 +7135,7 @@
           "sectionId": "no-dismiss-mask",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"No Mask Dismiss\" severity=\"secondary\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Stay open\" :dismissable-mask=\"false\">\n      <p style=\"margin:0\">\n        Click the mask — the dialog stays open. Use the close button or Esc.\n      </p>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"No Mask Dismiss\" @click=\"open = true\"/>\n    <MDialog v-model=\"open\" header=\"Stay open\" :dismissable-mask=\"false\">\n      <p style=\"margin:0\">\n        Click the mask — the dialog stays open. Use the close button or Esc.\n      </p>\n    </MDialog>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -6974,7 +7189,7 @@
           "sectionId": "positions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'center' | 'top' | 'topright' | 'bottomleft'>('center')\n\nfunction openAt(next: 'center' | 'top' | 'topright' | 'bottomleft') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Center\" size=\"small\" @click=\"openAt('center')\" />\n    <MButton label=\"Top\" size=\"small\" severity=\"secondary\" @click=\"openAt('top')\" />\n    <MButton label=\"Top Right\" size=\"small\" @click=\"openAt('topright')\" />\n    <MButton label=\"Bottom Left\" size=\"small\" severity=\"secondary\" @click=\"openAt('bottomleft')\" />\n    <MDialog v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Dialog can dock to edges and corners.\n      </p>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'center' | 'top' | 'topright' | 'bottomleft'>('center')\n\nfunction openAt(next: 'center' | 'top' | 'topright' | 'bottomleft') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Center\" size=\"small\" @click=\"openAt('center')\" />\n    <MButton label=\"Top\" size=\"small\" @click=\"openAt('top')\"/>\n    <MButton label=\"Top Right\" size=\"small\" @click=\"openAt('topright')\" />\n    <MButton label=\"Bottom Left\" size=\"small\" @click=\"openAt('bottomleft')\"/>\n    <MDialog v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Dialog can dock to edges and corners.\n      </p>\n    </MDialog>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -6983,7 +7198,7 @@
           "sectionId": "footer-actions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Save changes\" width=\"28rem\">\n      <p style=\"margin:0\">\n        Footer slot is for primary and secondary actions.\n      </p>\n      <template #footer>\n        <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n          <MButton label=\"Cancel\" severity=\"secondary\" text @click=\"open = false\" />\n          <MButton label=\"Confirm\" @click=\"open = false\" />\n        </div>\n      </template>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Save changes\" width=\"28rem\">\n      <p style=\"margin:0\">\n        Footer slot is for primary and secondary actions.\n      </p>\n      <template #footer>\n        <div style=\"display:flex;gap:0.75rem;justify-content:flex-end;width:100%\">\n          <MButton label=\"Cancel\" @click=\"open = false\" type=\"text\"/>\n          <MButton label=\"Confirm\" @click=\"open = false\" />\n        </div>\n      </template>\n    </MDialog>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -6992,7 +7207,7 @@
           "sectionId": "no-dismiss-mask",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"No Mask Dismiss\" severity=\"secondary\" @click=\"open = true\" />\n    <MDialog v-model=\"open\" header=\"Stay open\" :dismissable-mask=\"false\">\n      <p style=\"margin:0\">\n        Click the mask — the dialog stays open. Use the close button or Esc.\n      </p>\n    </MDialog>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDialog } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"No Mask Dismiss\" @click=\"open = true\"/>\n    <MDialog v-model=\"open\" header=\"Stay open\" :dismissable-mask=\"false\">\n      <p style=\"margin:0\">\n        Click the mask — the dialog stays open. Use the close button or Esc.\n      </p>\n    </MDialog>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -7071,7 +7286,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 可见性。配合 `v-model` 使用。 |\n| `title` | `string` | — | 标题文案。 |\n| `header` | `string` | — | `title` 的别名。 |\n| `closeOnEsc` | `boolean` | `true` | 按 Esc 关闭。 |\n| `blockScroll` | `boolean` | `true` | 打开时锁定页面滚动（`modal` 时生效）。 |\n| `closeOnOutsideClick` | `boolean` | `true` | 点击遮罩关闭。 |\n| `dismissableMask` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `maskClosable` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `closable` | `boolean` | `true` | 显示关闭按钮。 |\n| `maximizable` | `boolean` | `false` | 显示最大化 / 还原按钮。 |\n| `modal` | `boolean` | `true` | 遮罩层。 |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | 对话框位置。 |\n| `centered` | `boolean` | — | 垂直居中：`true` → `center`，`false` → `top`；省略时用 `position`。 |\n| `width` | `string` | — | 对话框宽度（最大化时忽略）。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 就地渲染。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 标题状态图标；`warning` 与 `warn` 同义 |\n| `positiveText` / `negativeText` | `string` | — | 预设页脚按钮；有 `footer` 插槽时忽略 |\n| `positiveSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | 确认按钮语义色 |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭 |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | X / Esc / 遮罩关闭前；返回 `false` 则保持打开 |\n| `ariaLabel` | `string` | — | 对话框可访问名称。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 遮罩层（backdrop）透传，键名 `root`。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 可见性。配合 `v-model` 使用。 |\n| `title` | `string` | — | 标题文案。 |\n| `header` | `string` | — | `title` 的别名。 |\n| `closeOnEsc` | `boolean` | `true` | 按 Esc 关闭。 |\n| `blockScroll` | `boolean` | `true` | 打开时锁定页面滚动（`modal` 时生效）。 |\n| `closeOnOutsideClick` | `boolean` | `true` | 点击遮罩关闭。 |\n| `dismissableMask` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `maskClosable` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `closable` | `boolean` | `true` | 显示关闭按钮。 |\n| `maximizable` | `boolean` | `false` | 显示最大化 / 还原按钮。 |\n| `modal` | `boolean` | `true` | 遮罩层。 |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | 对话框位置。 |\n| `centered` | `boolean` | — | 垂直居中：`true` → `center`，`false` → `top`；省略时用 `position`。 |\n| `width` | `string` | — | 对话框宽度（最大化时忽略）。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 就地渲染。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 标题状态图标；`warning` 与 `warn` 同义 |\n| `positiveText` / `negativeText` | `string` | — | 预设页脚按钮；有 `footer` 插槽时忽略 |\n| `positiveColor` | [ButtonColor](/docs/types#ButtonColor) | — | 确认按钮颜色 |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭 |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | X / Esc / 遮罩关闭前；返回 `false` 则保持打开 |\n| `ariaLabel` | `string` | — | 对话框可访问名称。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 遮罩层（backdrop）透传，键名 `root`。 |"
             },
             {
               "id": "样式与-attrs",
@@ -7096,10 +7311,10 @@
             {
               "id": "命令式调用-usemodal-modal",
               "title": "命令式调用（useModal / modal）",
-              "body": "不写模板也能弹出对话框：\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// 模块级单例\nmodal.confirm({\n  title: '确认删除？',\n  content: '删除后不可恢复',\n  onOk: async () => { await remove() },\n})\n\n// 或组件内作用域实例\nconst dialog = useModal()\ndialog.success({ title: '已保存' })\n```\n\n每个调用返回 `{ destroy, update }`：`update` 可在打开时改标题/内容，`destroy` 立即关闭并卸载。`modal.destroyAll()` 关闭全部由该 API 创建的对话框。\n\n| 方法 | 说明 |\n| --- | --- |\n| `info(options)` | 信息弹窗（默认无取消按钮） |\n| `success(options)` | 成功弹窗 |\n| `warning(options)` | 警告弹窗 |\n| `error(options)` | 错误弹窗 |\n| `confirm(options)` | 确认弹窗（默认显示取消按钮） |\n| `destroyAll()` | 关闭全部 |\n\n`options` 传字符串等价于 `{ content: '...' }`。\n\n| 字段 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `title` | `string` | — | 标题 |\n| `content` | `string \\| VNode` | — | 内容 |\n| `type` | `DialogType` | — | 头部状态图标 |\n| `okText` / `cancelText` | `string` | locale | 按钮文案 |\n| `showCancel` | `boolean` | 状态弹窗 `false`，`confirm` `true` | 是否显示取消按钮 |\n| `okSeverity` | `ButtonSeverity` | `'primary'` | 确认按钮语义色 |\n| `width` / `position` / `centered` | 同 Dialog | — | 布局 |\n| `maskClosable` | `boolean` | `false` | 点击遮罩关闭 |\n| `onOk` | `() => void \\| Promise<void>` | — | 确认回调；返回 Promise 时按钮进入 loading |\n| `onCancel` | `() => void` | — | 取消 / 关闭回调 |\n| `afterClose` | `() => void` | — | 关闭动画结束后回调 |\n\n> 命令式弹窗就地渲染在挂载容器内（不 Teleport），便于精确销毁。\n| `footer` | 底部操作区。 |"
+              "body": "不写模板也能弹出对话框：\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// 模块级单例\nmodal.confirm({\n  title: '确认删除？',\n  content: '删除后不可恢复',\n  onOk: async () => { await remove() },\n})\n\n// 或组件内作用域实例\nconst dialog = useModal()\ndialog.success({ title: '已保存' })\n```\n\n每个调用返回 `{ destroy, update }`：`update` 可在打开时改标题/内容，`destroy` 立即关闭并卸载。`modal.destroyAll()` 关闭全部由该 API 创建的对话框。\n\n| 方法 | 说明 |\n| --- | --- |\n| `info(options)` | 信息弹窗（默认无取消按钮） |\n| `success(options)` | 成功弹窗 |\n| `warning(options)` | 警告弹窗 |\n| `error(options)` | 错误弹窗 |\n| `confirm(options)` | 确认弹窗（默认显示取消按钮） |\n| `destroyAll()` | 关闭全部 |\n\n`options` 传字符串等价于 `{ content: '...' }`。\n\n| 字段 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `title` | `string` | — | 标题 |\n| `content` | `string \\| VNode` | — | 内容 |\n| `type` | `DialogType` | — | 头部状态图标 |\n| `okText` / `cancelText` | `string` | locale | 按钮文案 |\n| `showCancel` | `boolean` | 状态弹窗 `false`，`confirm` `true` | 是否显示取消按钮 |\n| `okColor` | `ButtonColor` | `'primary'` | 确认按钮颜色 |\n| `width` / `position` / `centered` | 同 Dialog | — | 布局 |\n| `maskClosable` | `boolean` | `false` | 点击遮罩关闭 |\n| `onOk` | `() => void \\| Promise<void>` | — | 确认回调；返回 Promise 时按钮进入 loading |\n| `onCancel` | `() => void` | — | 取消 / 关闭回调 |\n| `afterClose` | `() => void` | — | 关闭动画结束后回调 |\n\n> 命令式弹窗就地渲染在挂载容器内（不 Teleport），便于精确销毁。\n| `footer` | 底部操作区。 |"
             }
           ],
-          "markdown": "---\ntitle: Dialog\ncategory: 05 / FEEDBACK\ndescription: 模态对话框。支持预设页脚、异步关闭拦截、状态 type。\n---\n\n# Dialog\n\n模态对话框。可见性使用 `v-model`（`modelValue`），对应 的 `visible`。\n\n## 引入\n\n```ts\nimport { MButton, MDialog } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Positions\n\n支持 `center` / `top` / `bottom` / `left` / `right` 以及四角位置。\n\n```vue preview src=\"./demos/Positions.vue\"\n```\n\n## Footer actions\n\n```vue preview src=\"./demos/FooterActions.vue\"\n```\n\n## No dismiss mask\n\n`dismissableMask={false}`（或 `closeOnOutsideClick={false}` / `maskClosable={false}`）时点击遮罩不关闭。\n\n```vue preview src=\"./demos/NoDismissMask.vue\"\n```\n\n## Maximizable\n\n`maximizable` 在标题栏提供最大化 / 还原切换。\n\n```vue preview src=\"./demos/Maximizable.vue\"\n```\n\n## 预设页脚与异步关闭\n\n`positiveText` / `negativeText` 生成确认 / 取消按钮（`footer` 插槽优先）。处理函数返回 `false`（含 Promise）则保持打开。确认型流程请用 [ConfirmDialog](/components/ConfirmDialog)；`type` 只负责 Dialog 标题图标。\n\n```vue preview src=\"./demos/PresetFooterAndAsyncClose.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 可见性。配合 `v-model` 使用。 |\n| `title` | `string` | — | 标题文案。 |\n| `header` | `string` | — | `title` 的别名。 |\n| `closeOnEsc` | `boolean` | `true` | 按 Esc 关闭。 |\n| `blockScroll` | `boolean` | `true` | 打开时锁定页面滚动（`modal` 时生效）。 |\n| `closeOnOutsideClick` | `boolean` | `true` | 点击遮罩关闭。 |\n| `dismissableMask` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `maskClosable` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `closable` | `boolean` | `true` | 显示关闭按钮。 |\n| `maximizable` | `boolean` | `false` | 显示最大化 / 还原按钮。 |\n| `modal` | `boolean` | `true` | 遮罩层。 |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | 对话框位置。 |\n| `centered` | `boolean` | — | 垂直居中：`true` → `center`，`false` → `top`；省略时用 `position`。 |\n| `width` | `string` | — | 对话框宽度（最大化时忽略）。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 就地渲染。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 标题状态图标；`warning` 与 `warn` 同义 |\n| `positiveText` / `negativeText` | `string` | — | 预设页脚按钮；有 `footer` 插槽时忽略 |\n| `positiveSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | 确认按钮语义色 |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭 |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | X / Esc / 遮罩关闭前；返回 `false` 则保持打开 |\n| `ariaLabel` | `string` | — | 对话框可访问名称。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 遮罩层（backdrop）透传，键名 `root`。 |\n\n## 样式与 attrs\n\nDialog Teleport 到 `body` 后，你在组件上写的 fallthrough attrs（`class`、`style`、`data-*`、`title` 等）落在**遮罩层**（`.m-dialog-backdrop`），不是内层 `.m-dialog` 面板。面板宽度用 `width` prop；内层 DOM 用 `pt`。详见 [样式与 attrs](/docs/attrs)。\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 可见性变化。 |\n| `close` | — | 关闭时触发。 |\n| `show` | — | 打开时触发。 |\n| `hide` | — | 关闭后触发。 |\n| `maximize` | — | 进入最大化。 |\n| `unmaximize` | — | 退出最大化。 |\n\n## Methods\n\n| 方法 | 说明 |\n| --- | --- |\n| `close()` | 关闭对话框（等同取消/关闭动作）。 |\n| `maximize()` | 最大化；已最大化时无操作。 |\n| `unmaximize()` | 退出最大化。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 对话框内容。 |\n| `header` | 自定义标题区。 |\n| `footer` | 底部操作区。 |\n\n## 命令式调用（useModal / modal）\n\n不写模板也能弹出对话框：\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// 模块级单例\nmodal.confirm({\n  title: '确认删除？',\n  content: '删除后不可恢复',\n  onOk: async () => { await remove() },\n})\n\n// 或组件内作用域实例\nconst dialog = useModal()\ndialog.success({ title: '已保存' })\n```\n\n每个调用返回 `{ destroy, update }`：`update` 可在打开时改标题/内容，`destroy` 立即关闭并卸载。`modal.destroyAll()` 关闭全部由该 API 创建的对话框。\n\n| 方法 | 说明 |\n| --- | --- |\n| `info(options)` | 信息弹窗（默认无取消按钮） |\n| `success(options)` | 成功弹窗 |\n| `warning(options)` | 警告弹窗 |\n| `error(options)` | 错误弹窗 |\n| `confirm(options)` | 确认弹窗（默认显示取消按钮） |\n| `destroyAll()` | 关闭全部 |\n\n`options` 传字符串等价于 `{ content: '...' }`。\n\n| 字段 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `title` | `string` | — | 标题 |\n| `content` | `string \\| VNode` | — | 内容 |\n| `type` | `DialogType` | — | 头部状态图标 |\n| `okText` / `cancelText` | `string` | locale | 按钮文案 |\n| `showCancel` | `boolean` | 状态弹窗 `false`，`confirm` `true` | 是否显示取消按钮 |\n| `okSeverity` | `ButtonSeverity` | `'primary'` | 确认按钮语义色 |\n| `width` / `position` / `centered` | 同 Dialog | — | 布局 |\n| `maskClosable` | `boolean` | `false` | 点击遮罩关闭 |\n| `onOk` | `() => void \\| Promise<void>` | — | 确认回调；返回 Promise 时按钮进入 loading |\n| `onCancel` | `() => void` | — | 取消 / 关闭回调 |\n| `afterClose` | `() => void` | — | 关闭动画结束后回调 |\n\n> 命令式弹窗就地渲染在挂载容器内（不 Teleport），便于精确销毁。\n| `footer` | 底部操作区。 |\n"
+          "markdown": "---\ntitle: Dialog\ncategory: 05 / FEEDBACK\ndescription: 模态对话框。支持预设页脚、异步关闭拦截、状态 type。\n---\n\n# Dialog\n\n模态对话框。可见性使用 `v-model`（`modelValue`），对应 的 `visible`。\n\n## 引入\n\n```ts\nimport { MButton, MDialog } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Positions\n\n支持 `center` / `top` / `bottom` / `left` / `right` 以及四角位置。\n\n```vue preview src=\"./demos/Positions.vue\"\n```\n\n## Footer actions\n\n```vue preview src=\"./demos/FooterActions.vue\"\n```\n\n## No dismiss mask\n\n`dismissableMask={false}`（或 `closeOnOutsideClick={false}` / `maskClosable={false}`）时点击遮罩不关闭。\n\n```vue preview src=\"./demos/NoDismissMask.vue\"\n```\n\n## Maximizable\n\n`maximizable` 在标题栏提供最大化 / 还原切换。\n\n```vue preview src=\"./demos/Maximizable.vue\"\n```\n\n## 预设页脚与异步关闭\n\n`positiveText` / `negativeText` 生成确认 / 取消按钮（`footer` 插槽优先）。处理函数返回 `false`（含 Promise）则保持打开。确认型流程请用 [ConfirmDialog](/components/ConfirmDialog)；`type` 只负责 Dialog 标题图标。\n\n```vue preview src=\"./demos/PresetFooterAndAsyncClose.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | 可见性。配合 `v-model` 使用。 |\n| `title` | `string` | — | 标题文案。 |\n| `header` | `string` | — | `title` 的别名。 |\n| `closeOnEsc` | `boolean` | `true` | 按 Esc 关闭。 |\n| `blockScroll` | `boolean` | `true` | 打开时锁定页面滚动（`modal` 时生效）。 |\n| `closeOnOutsideClick` | `boolean` | `true` | 点击遮罩关闭。 |\n| `dismissableMask` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `maskClosable` | `boolean` | — | `closeOnOutsideClick` 的别名。 |\n| `closable` | `boolean` | `true` | 显示关闭按钮。 |\n| `maximizable` | `boolean` | `false` | 显示最大化 / 还原按钮。 |\n| `modal` | `boolean` | `true` | 遮罩层。 |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | 对话框位置。 |\n| `centered` | `boolean` | — | 垂直居中：`true` → `center`，`false` → `top`；省略时用 `position`。 |\n| `width` | `string` | — | 对话框宽度（最大化时忽略）。 |\n| `teleport` | `boolean` | `true` | 浮层 Teleport；默认挂到 `body`。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 就地渲染。 |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | 标题状态图标；`warning` 与 `warn` 同义 |\n| `positiveText` / `negativeText` | `string` | — | 预设页脚按钮；有 `footer` 插槽时忽略 |\n| `positiveColor` | [ButtonColor](/docs/types#ButtonColor) | — | 确认按钮颜色 |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | 返回 `false` 则不关闭 |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | X / Esc / 遮罩关闭前；返回 `false` 则保持打开 |\n| `ariaLabel` | `string` | — | 对话框可访问名称。 |\n| `transition` | `string \\| false` | `'zoom'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | 遮罩层（backdrop）透传，键名 `root`。 |\n\n## 样式与 attrs\n\nDialog Teleport 到 `body` 后，你在组件上写的 fallthrough attrs（`class`、`style`、`data-*`、`title` 等）落在**遮罩层**（`.m-dialog-backdrop`），不是内层 `.m-dialog` 面板。面板宽度用 `width` prop；内层 DOM 用 `pt`。详见 [样式与 attrs](/docs/attrs)。\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | 可见性变化。 |\n| `close` | — | 关闭时触发。 |\n| `show` | — | 打开时触发。 |\n| `hide` | — | 关闭后触发。 |\n| `maximize` | — | 进入最大化。 |\n| `unmaximize` | — | 退出最大化。 |\n\n## Methods\n\n| 方法 | 说明 |\n| --- | --- |\n| `close()` | 关闭对话框（等同取消/关闭动作）。 |\n| `maximize()` | 最大化；已最大化时无操作。 |\n| `unmaximize()` | 退出最大化。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 对话框内容。 |\n| `header` | 自定义标题区。 |\n| `footer` | 底部操作区。 |\n\n## 命令式调用（useModal / modal）\n\n不写模板也能弹出对话框：\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// 模块级单例\nmodal.confirm({\n  title: '确认删除？',\n  content: '删除后不可恢复',\n  onOk: async () => { await remove() },\n})\n\n// 或组件内作用域实例\nconst dialog = useModal()\ndialog.success({ title: '已保存' })\n```\n\n每个调用返回 `{ destroy, update }`：`update` 可在打开时改标题/内容，`destroy` 立即关闭并卸载。`modal.destroyAll()` 关闭全部由该 API 创建的对话框。\n\n| 方法 | 说明 |\n| --- | --- |\n| `info(options)` | 信息弹窗（默认无取消按钮） |\n| `success(options)` | 成功弹窗 |\n| `warning(options)` | 警告弹窗 |\n| `error(options)` | 错误弹窗 |\n| `confirm(options)` | 确认弹窗（默认显示取消按钮） |\n| `destroyAll()` | 关闭全部 |\n\n`options` 传字符串等价于 `{ content: '...' }`。\n\n| 字段 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `title` | `string` | — | 标题 |\n| `content` | `string \\| VNode` | — | 内容 |\n| `type` | `DialogType` | — | 头部状态图标 |\n| `okText` / `cancelText` | `string` | locale | 按钮文案 |\n| `showCancel` | `boolean` | 状态弹窗 `false`，`confirm` `true` | 是否显示取消按钮 |\n| `okColor` | `ButtonColor` | `'primary'` | 确认按钮颜色 |\n| `width` / `position` / `centered` | 同 Dialog | — | 布局 |\n| `maskClosable` | `boolean` | `false` | 点击遮罩关闭 |\n| `onOk` | `() => void \\| Promise<void>` | — | 确认回调；返回 Promise 时按钮进入 loading |\n| `onCancel` | `() => void` | — | 取消 / 关闭回调 |\n| `afterClose` | `() => void` | — | 关闭动画结束后回调 |\n\n> 命令式弹窗就地渲染在挂载容器内（不 Teleport），便于精确销毁。\n| `footer` | 底部操作区。 |\n"
         },
         "en-US": {
           "title": "Dialog",
@@ -7148,7 +7363,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. Use with `v-model`. |\n| `title` | `string` | — | Title text. |\n| `header` | `string` | — | Alias of `title`. |\n| `closeOnEsc` | `boolean` | `true` | Close on Esc. |\n| `blockScroll` | `boolean` | `true` | Lock page scroll while open (when `modal` is true). |\n| `closeOnOutsideClick` | `boolean` | `true` | Close when clicking the mask. |\n| `dismissableMask` | `boolean` | — | Alias of `closeOnOutsideClick`. |\n| `maskClosable` | `boolean` | — | Alias of `closeOnOutsideClick` . |\n| `closable` | `boolean` | `true` | Show the close button. |\n| `maximizable` | `boolean` | `false` | Show the maximize / restore button. |\n| `modal` | `boolean` | `true` | Overlay mask. |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | Dialog position. |\n| `centered` | `boolean` | — | Vertical centering: `true` → `center`, `false` → `top`; omit to use `position`. |\n| `width` | `string` | — | Dialog width (ignored when maximized). |\n| `teleport` | `boolean` | `true` | Overlay Teleport; mounts to `body` by default. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` renders in place. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon in the header; `warning` is an alias of `warn` |\n| `positiveText` / `negativeText` | `string` | — | Preset footer buttons; ignored when the `footer` slot is used |\n| `positiveSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | Confirm button severity |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | Return `false` to keep the dialog open |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | Runs before X / Esc / mask dismiss; return `false` to keep open |\n| `ariaLabel` | `string` | — | Accessible dialog name. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Backdrop pass-through; key `root`. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. Use with `v-model`. |\n| `title` | `string` | — | Title text. |\n| `header` | `string` | — | Alias of `title`. |\n| `closeOnEsc` | `boolean` | `true` | Close on Esc. |\n| `blockScroll` | `boolean` | `true` | Lock page scroll while open (when `modal` is true). |\n| `closeOnOutsideClick` | `boolean` | `true` | Close when clicking the mask. |\n| `dismissableMask` | `boolean` | — | Alias of `closeOnOutsideClick`. |\n| `maskClosable` | `boolean` | — | Alias of `closeOnOutsideClick` . |\n| `closable` | `boolean` | `true` | Show the close button. |\n| `maximizable` | `boolean` | `false` | Show the maximize / restore button. |\n| `modal` | `boolean` | `true` | Overlay mask. |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | Dialog position. |\n| `centered` | `boolean` | — | Vertical centering: `true` → `center`, `false` → `top`; omit to use `position`. |\n| `width` | `string` | — | Dialog width (ignored when maximized). |\n| `teleport` | `boolean` | `true` | Overlay Teleport; mounts to `body` by default. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` renders in place. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon in the header; `warning` is an alias of `warn` |\n| `positiveText` / `negativeText` | `string` | — | Preset footer buttons; ignored when the `footer` slot is used |\n| `positiveColor` | [ButtonColor](/docs/types#ButtonColor) | — | Confirm button color |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | Return `false` to keep the dialog open |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | Runs before X / Esc / mask dismiss; return `false` to keep open |\n| `ariaLabel` | `string` | — | Accessible dialog name. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Backdrop pass-through; key `root`. |"
             },
             {
               "id": "styling-attrs",
@@ -7173,10 +7388,10 @@
             {
               "id": "imperative-api-usemodal-modal",
               "title": "Imperative API (useModal / modal)",
-              "body": "Open dialogs without writing a template:\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// Module-level singleton\nmodal.confirm({\n  title: 'Delete this item?',\n  content: 'This cannot be undone',\n  onOk: async () => { await remove() },\n})\n\n// Or a component-scoped instance\nconst dialog = useModal()\ndialog.success({ title: 'Saved' })\n```\n\nEvery call returns `{ destroy, update }`: `update` patches the title / content while open, `destroy` closes and unmounts immediately. `modal.destroyAll()` closes every dialog created through the API.\n\n| Method | Description |\n| --- | --- |\n| `info(options)` | Message dialog (no cancel button by default) |\n| `success(options)` | Success dialog |\n| `warning(options)` | Warning dialog |\n| `error(options)` | Error dialog |\n| `confirm(options)` | Confirmation dialog (cancel button shown by default) |\n| `destroyAll()` | Close all |\n\nPassing a string as `options` is shorthand for `{ content: '...' }`.\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `title` | `string` | — | Title |\n| `content` | `string \\| VNode` | — | Body |\n| `type` | `DialogType` | — | Header status icon |\n| `okText` / `cancelText` | `string` | locale | Button labels |\n| `showCancel` | `boolean` | `false` for status helpers, `true` for `confirm` | Show the cancel button |\n| `okSeverity` | `ButtonSeverity` | `'primary'` | Confirm button tone |\n| `width` / `position` / `centered` | as Dialog | — | Layout |\n| `maskClosable` | `boolean` | `false` | Dismiss by clicking the mask |\n| `onOk` | `() => void \\| Promise<void>` | — | Confirm handler; a returned Promise puts the button in a loading state |\n| `onCancel` | `() => void` | — | Cancel / dismiss handler |\n| `afterClose` | `() => void` | — | Called after the close transition |\n\n> Imperative dialogs render in place inside their mount container (no Teleport) so they can be destroyed precisely."
+              "body": "Open dialogs without writing a template:\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// Module-level singleton\nmodal.confirm({\n  title: 'Delete this item?',\n  content: 'This cannot be undone',\n  onOk: async () => { await remove() },\n})\n\n// Or a component-scoped instance\nconst dialog = useModal()\ndialog.success({ title: 'Saved' })\n```\n\nEvery call returns `{ destroy, update }`: `update` patches the title / content while open, `destroy` closes and unmounts immediately. `modal.destroyAll()` closes every dialog created through the API.\n\n| Method | Description |\n| --- | --- |\n| `info(options)` | Message dialog (no cancel button by default) |\n| `success(options)` | Success dialog |\n| `warning(options)` | Warning dialog |\n| `error(options)` | Error dialog |\n| `confirm(options)` | Confirmation dialog (cancel button shown by default) |\n| `destroyAll()` | Close all |\n\nPassing a string as `options` is shorthand for `{ content: '...' }`.\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `title` | `string` | — | Title |\n| `content` | `string \\| VNode` | — | Body |\n| `type` | `DialogType` | — | Header status icon |\n| `okText` / `cancelText` | `string` | locale | Button labels |\n| `showCancel` | `boolean` | `false` for status helpers, `true` for `confirm` | Show the cancel button |\n| `okColor` | `ButtonColor` | `'primary'` | Confirm button color |\n| `width` / `position` / `centered` | as Dialog | — | Layout |\n| `maskClosable` | `boolean` | `false` | Dismiss by clicking the mask |\n| `onOk` | `() => void \\| Promise<void>` | — | Confirm handler; a returned Promise puts the button in a loading state |\n| `onCancel` | `() => void` | — | Cancel / dismiss handler |\n| `afterClose` | `() => void` | — | Called after the close transition |\n\n> Imperative dialogs render in place inside their mount container (no Teleport) so they can be destroyed precisely."
             }
           ],
-          "markdown": "---\ntitle: Dialog\ncategory: 05 / FEEDBACK\ndescription: Modal dialog with preset footer actions, async close guards, and status type.\n---\n\n# Dialog\n\nModal dialog. Visibility uses `v-model` (`modelValue`), corresponding to `visible`.\n\n## Import\n\n```ts\nimport { MButton, MDialog } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Positions\n\nSupports `center` / `top` / `bottom` / `left` / `right` and the four corner positions.\n\n```vue preview src=\"./demos/Positions.vue\"\n```\n\n## Footer actions\n\n```vue preview src=\"./demos/FooterActions.vue\"\n```\n\n## No dismiss mask\n\nWith `dismissableMask={false}` (or `closeOnOutsideClick={false}` / `maskClosable={false}`), clicking the mask does not close the dialog.\n\n```vue preview src=\"./demos/NoDismissMask.vue\"\n```\n\n## Maximizable\n\n`maximizable` adds a maximize / restore toggle in the title bar.\n\n```vue preview src=\"./demos/Maximizable.vue\"\n```\n\n## Preset footer and async close\n\n`positiveText` / `negativeText` render confirm / cancel buttons (`footer` slot wins). Return `false` (including from a Promise) to keep the dialog open. Use [ConfirmDialog](/components/ConfirmDialog) for accept/reject flows; Dialog `type` is a header icon only.\n\n```vue preview src=\"./demos/PresetFooterAndAsyncClose.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. Use with `v-model`. |\n| `title` | `string` | — | Title text. |\n| `header` | `string` | — | Alias of `title`. |\n| `closeOnEsc` | `boolean` | `true` | Close on Esc. |\n| `blockScroll` | `boolean` | `true` | Lock page scroll while open (when `modal` is true). |\n| `closeOnOutsideClick` | `boolean` | `true` | Close when clicking the mask. |\n| `dismissableMask` | `boolean` | — | Alias of `closeOnOutsideClick`. |\n| `maskClosable` | `boolean` | — | Alias of `closeOnOutsideClick` . |\n| `closable` | `boolean` | `true` | Show the close button. |\n| `maximizable` | `boolean` | `false` | Show the maximize / restore button. |\n| `modal` | `boolean` | `true` | Overlay mask. |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | Dialog position. |\n| `centered` | `boolean` | — | Vertical centering: `true` → `center`, `false` → `top`; omit to use `position`. |\n| `width` | `string` | — | Dialog width (ignored when maximized). |\n| `teleport` | `boolean` | `true` | Overlay Teleport; mounts to `body` by default. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` renders in place. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon in the header; `warning` is an alias of `warn` |\n| `positiveText` / `negativeText` | `string` | — | Preset footer buttons; ignored when the `footer` slot is used |\n| `positiveSeverity` | [ButtonSeverity](/docs/types#ButtonSeverity) | — | Confirm button severity |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | Return `false` to keep the dialog open |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | Runs before X / Esc / mask dismiss; return `false` to keep open |\n| `ariaLabel` | `string` | — | Accessible dialog name. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Backdrop pass-through; key `root`. |\n\n## Styling & attrs\n\nAfter Teleport, fallthrough attrs on `<MDialog>` (`class`, `style`, `data-*`, `title`, …) land on the **backdrop** (`.m-dialog-backdrop`), not the inner `.m-dialog` panel. Use the `width` prop for panel width; use `pt` for inner DOM. See [Styling & attrs](/docs/attrs).\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | Visibility change. |\n| `close` | — | Emitted when closing. |\n| `show` | — | Emitted when opening. |\n| `hide` | — | Emitted after closing. |\n| `maximize` | — | Enter maximize. |\n| `unmaximize` | — | Exit maximize. |\n\n## Methods\n\n| Method | Description |\n| --- | --- |\n| `close()` | Close the dialog (same as the cancel/close action). |\n| `maximize()` | Maximize; no-op when already maximized. |\n| `unmaximize()` | Leave the maximized state. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Dialog content. |\n| `header` | Custom header area. |\n| `footer` | Footer actions. |\n\n## Imperative API (useModal / modal)\n\nOpen dialogs without writing a template:\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// Module-level singleton\nmodal.confirm({\n  title: 'Delete this item?',\n  content: 'This cannot be undone',\n  onOk: async () => { await remove() },\n})\n\n// Or a component-scoped instance\nconst dialog = useModal()\ndialog.success({ title: 'Saved' })\n```\n\nEvery call returns `{ destroy, update }`: `update` patches the title / content while open, `destroy` closes and unmounts immediately. `modal.destroyAll()` closes every dialog created through the API.\n\n| Method | Description |\n| --- | --- |\n| `info(options)` | Message dialog (no cancel button by default) |\n| `success(options)` | Success dialog |\n| `warning(options)` | Warning dialog |\n| `error(options)` | Error dialog |\n| `confirm(options)` | Confirmation dialog (cancel button shown by default) |\n| `destroyAll()` | Close all |\n\nPassing a string as `options` is shorthand for `{ content: '...' }`.\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `title` | `string` | — | Title |\n| `content` | `string \\| VNode` | — | Body |\n| `type` | `DialogType` | — | Header status icon |\n| `okText` / `cancelText` | `string` | locale | Button labels |\n| `showCancel` | `boolean` | `false` for status helpers, `true` for `confirm` | Show the cancel button |\n| `okSeverity` | `ButtonSeverity` | `'primary'` | Confirm button tone |\n| `width` / `position` / `centered` | as Dialog | — | Layout |\n| `maskClosable` | `boolean` | `false` | Dismiss by clicking the mask |\n| `onOk` | `() => void \\| Promise<void>` | — | Confirm handler; a returned Promise puts the button in a loading state |\n| `onCancel` | `() => void` | — | Cancel / dismiss handler |\n| `afterClose` | `() => void` | — | Called after the close transition |\n\n> Imperative dialogs render in place inside their mount container (no Teleport) so they can be destroyed precisely.\n"
+          "markdown": "---\ntitle: Dialog\ncategory: 05 / FEEDBACK\ndescription: Modal dialog with preset footer actions, async close guards, and status type.\n---\n\n# Dialog\n\nModal dialog. Visibility uses `v-model` (`modelValue`), corresponding to `visible`.\n\n## Import\n\n```ts\nimport { MButton, MDialog } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Positions\n\nSupports `center` / `top` / `bottom` / `left` / `right` and the four corner positions.\n\n```vue preview src=\"./demos/Positions.vue\"\n```\n\n## Footer actions\n\n```vue preview src=\"./demos/FooterActions.vue\"\n```\n\n## No dismiss mask\n\nWith `dismissableMask={false}` (or `closeOnOutsideClick={false}` / `maskClosable={false}`), clicking the mask does not close the dialog.\n\n```vue preview src=\"./demos/NoDismissMask.vue\"\n```\n\n## Maximizable\n\n`maximizable` adds a maximize / restore toggle in the title bar.\n\n```vue preview src=\"./demos/Maximizable.vue\"\n```\n\n## Preset footer and async close\n\n`positiveText` / `negativeText` render confirm / cancel buttons (`footer` slot wins). Return `false` (including from a Promise) to keep the dialog open. Use [ConfirmDialog](/components/ConfirmDialog) for accept/reject flows; Dialog `type` is a header icon only.\n\n```vue preview src=\"./demos/PresetFooterAndAsyncClose.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `modelValue` | `boolean` | `false` | Visibility. Use with `v-model`. |\n| `title` | `string` | — | Title text. |\n| `header` | `string` | — | Alias of `title`. |\n| `closeOnEsc` | `boolean` | `true` | Close on Esc. |\n| `blockScroll` | `boolean` | `true` | Lock page scroll while open (when `modal` is true). |\n| `closeOnOutsideClick` | `boolean` | `true` | Close when clicking the mask. |\n| `dismissableMask` | `boolean` | — | Alias of `closeOnOutsideClick`. |\n| `maskClosable` | `boolean` | — | Alias of `closeOnOutsideClick` . |\n| `closable` | `boolean` | `true` | Show the close button. |\n| `maximizable` | `boolean` | `false` | Show the maximize / restore button. |\n| `modal` | `boolean` | `true` | Overlay mask. |\n| `position` | `'center' \\| 'top' \\| 'bottom' \\| 'left' \\| 'right' \\| 'topleft' \\| 'topright' \\| 'bottomleft' \\| 'bottomright'` | `'center'` | Dialog position. |\n| `centered` | `boolean` | — | Vertical centering: `true` → `center`, `false` → `top`; omit to use `position`. |\n| `width` | `string` | — | Dialog width (ignored when maximized). |\n| `teleport` | `boolean` | `true` | Overlay Teleport; mounts to `body` by default. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` renders in place. |\n| `type` | `'info' \\| 'success' \\| 'warning' \\| 'error'` | — | Status icon in the header; `warning` is an alias of `warn` |\n| `positiveText` / `negativeText` | `string` | — | Preset footer buttons; ignored when the `footer` slot is used |\n| `positiveColor` | [ButtonColor](/docs/types#ButtonColor) | — | Confirm button color |\n| `onPositiveClick` / `onNegativeClick` | `(e) => unknown \\| Promise<unknown>` | — | Return `false` to keep the dialog open |\n| `beforeClose` | `() => unknown \\| Promise<unknown>` | — | Runs before X / Esc / mask dismiss; return `false` to keep open |\n| `ariaLabel` | `string` | — | Accessible dialog name. |\n| `transition` | `string \\| false` | `'zoom'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Backdrop pass-through; key `root`. |\n\n## Styling & attrs\n\nAfter Teleport, fallthrough attrs on `<MDialog>` (`class`, `style`, `data-*`, `title`, …) land on the **backdrop** (`.m-dialog-backdrop`), not the inner `.m-dialog` panel. Use the `width` prop for panel width; use `pt` for inner DOM. See [Styling & attrs](/docs/attrs).\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `update:modelValue` | `boolean` | Visibility change. |\n| `close` | — | Emitted when closing. |\n| `show` | — | Emitted when opening. |\n| `hide` | — | Emitted after closing. |\n| `maximize` | — | Enter maximize. |\n| `unmaximize` | — | Exit maximize. |\n\n## Methods\n\n| Method | Description |\n| --- | --- |\n| `close()` | Close the dialog (same as the cancel/close action). |\n| `maximize()` | Maximize; no-op when already maximized. |\n| `unmaximize()` | Leave the maximized state. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Dialog content. |\n| `header` | Custom header area. |\n| `footer` | Footer actions. |\n\n## Imperative API (useModal / modal)\n\nOpen dialogs without writing a template:\n\n```ts\nimport { modal, useModal } from 'morya-ui'\n\n// Module-level singleton\nmodal.confirm({\n  title: 'Delete this item?',\n  content: 'This cannot be undone',\n  onOk: async () => { await remove() },\n})\n\n// Or a component-scoped instance\nconst dialog = useModal()\ndialog.success({ title: 'Saved' })\n```\n\nEvery call returns `{ destroy, update }`: `update` patches the title / content while open, `destroy` closes and unmounts immediately. `modal.destroyAll()` closes every dialog created through the API.\n\n| Method | Description |\n| --- | --- |\n| `info(options)` | Message dialog (no cancel button by default) |\n| `success(options)` | Success dialog |\n| `warning(options)` | Warning dialog |\n| `error(options)` | Error dialog |\n| `confirm(options)` | Confirmation dialog (cancel button shown by default) |\n| `destroyAll()` | Close all |\n\nPassing a string as `options` is shorthand for `{ content: '...' }`.\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `title` | `string` | — | Title |\n| `content` | `string \\| VNode` | — | Body |\n| `type` | `DialogType` | — | Header status icon |\n| `okText` / `cancelText` | `string` | locale | Button labels |\n| `showCancel` | `boolean` | `false` for status helpers, `true` for `confirm` | Show the cancel button |\n| `okColor` | `ButtonColor` | `'primary'` | Confirm button color |\n| `width` / `position` / `centered` | as Dialog | — | Layout |\n| `maskClosable` | `boolean` | `false` | Dismiss by clicking the mask |\n| `onOk` | `() => void \\| Promise<void>` | — | Confirm handler; a returned Promise puts the button in a loading state |\n| `onCancel` | `() => void` | — | Cancel / dismiss handler |\n| `afterClose` | `() => void` | — | Called after the close transition |\n\n> Imperative dialogs render in place inside their mount container (no Teleport) so they can be destroyed precisely.\n"
         }
       }
     },
@@ -7236,6 +7451,12 @@
           "type": "string",
           "default": "—",
           "description": "中间标签文案。存在默认插槽时以插槽为准。"
+        },
+        {
+          "name": "pt",
+          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "default": "—",
+          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
         }
       ],
       "events": [],
@@ -7422,7 +7643,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 布局方向。 |\n| `orientation` | `'horizontal' \\| 'vertical'` | — | `layout` 的别名。 |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | 线条样式（含虚线 / 点线）。 |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | 水平分隔带标签时的标签对齐。 |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | — | `align` 的别名；传入时优先。 |\n| `plain` | `boolean` | `false` | 标签使用正文样式。 |\n| `size` | `'small' \\| 'medium' \\| 'large'` | — | 水平分隔的上下间距（`--m-space-*`）。 |\n| `label` | `string` | — | 中间标签文案。存在默认插槽时以插槽为准。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 布局方向。 |\n| `orientation` | `'horizontal' \\| 'vertical'` | — | `layout` 的别名。 |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | 线条样式（含虚线 / 点线）。 |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | 水平分隔带标签时的标签对齐。 |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | — | `align` 的别名；传入时优先。 |\n| `plain` | `boolean` | `false` | 标签使用正文样式。 |\n| `size` | `'small' \\| 'medium' \\| 'large'` | — | 水平分隔的上下间距（`--m-space-*`）。 |\n| `label` | `string` | — | 中间标签文案。存在默认插槽时以插槽为准。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "slots",
@@ -7435,7 +7656,7 @@
               "body": "无自定义事件。"
             }
           ],
-          "markdown": "---\ntitle: Divider\ncategory: 01 / BASIC\ndescription: 内容分隔线。\n---\n\n# Divider\n\n内容分隔线，可带标签。\n\n## 引入\n\n```ts\nimport { MDivider } from 'morya-ui'\n```\n\n## 基础用法\n\n默认水平实线分隔。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Type\n\n`type` 支持 `solid`、`dashed`、`dotted`。\n\n```vue preview src=\"./demos/Type.vue\"\n```\n\n## Align\n\n水平分隔且带标签时，可用 `align` 控制标签位置。\n\n```vue preview src=\"./demos/Align.vue\"\n```\n\n## Title placement\n\n`titlePlacement` 是 `align` 的别名。\n\n```vue preview src=\"./demos/TitlePlacement.vue\"\n```\n\n## Layout\n\n`layout` 控制水平 / 垂直；`orientation` 为别名。\n\n```vue preview src=\"./demos/Layout.vue\"\n```\n\n## Plain\n\n`plain` 让标签使用正文样式（默认偏标题字重）。\n\n```vue preview src=\"./demos/Plain.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 布局方向。 |\n| `orientation` | `'horizontal' \\| 'vertical'` | — | `layout` 的别名。 |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | 线条样式（含虚线 / 点线）。 |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | 水平分隔带标签时的标签对齐。 |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | — | `align` 的别名；传入时优先。 |\n| `plain` | `boolean` | `false` | 标签使用正文样式。 |\n| `size` | `'small' \\| 'medium' \\| 'large'` | — | 水平分隔的上下间距（`--m-space-*`）。 |\n| `label` | `string` | — | 中间标签文案。存在默认插槽时以插槽为准。 |\n\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容，优先于 `label`。 |\n\n## Events\n\n无自定义事件。\n"
+          "markdown": "---\ntitle: Divider\ncategory: 01 / BASIC\ndescription: 内容分隔线。\n---\n\n# Divider\n\n内容分隔线，可带标签。\n\n## 引入\n\n```ts\nimport { MDivider } from 'morya-ui'\n```\n\n## 基础用法\n\n默认水平实线分隔。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Type\n\n`type` 支持 `solid`、`dashed`、`dotted`。\n\n```vue preview src=\"./demos/Type.vue\"\n```\n\n## Align\n\n水平分隔且带标签时，可用 `align` 控制标签位置。\n\n```vue preview src=\"./demos/Align.vue\"\n```\n\n## Title placement\n\n`titlePlacement` 是 `align` 的别名。\n\n```vue preview src=\"./demos/TitlePlacement.vue\"\n```\n\n## Layout\n\n`layout` 控制水平 / 垂直；`orientation` 为别名。\n\n```vue preview src=\"./demos/Layout.vue\"\n```\n\n## Plain\n\n`plain` 让标签使用正文样式（默认偏标题字重）。\n\n```vue preview src=\"./demos/Plain.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | 布局方向。 |\n| `orientation` | `'horizontal' \\| 'vertical'` | — | `layout` 的别名。 |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | 线条样式（含虚线 / 点线）。 |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | 水平分隔带标签时的标签对齐。 |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | — | `align` 的别名；传入时优先。 |\n| `plain` | `boolean` | `false` | 标签使用正文样式。 |\n| `size` | `'small' \\| 'medium' \\| 'large'` | — | 水平分隔的上下间距（`--m-space-*`）。 |\n| `label` | `string` | — | 中间标签文案。存在默认插槽时以插槽为准。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容，优先于 `label`。 |\n\n## Events\n\n无自定义事件。\n"
         },
         "en-US": {
           "title": "Divider",
@@ -7484,7 +7705,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Layout direction. |\n| `orientation` | `'horizontal' \\| 'vertical'` | 鈥?| Alias of `layout`. |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | Line style (solid / dashed / dotted). |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | Label alignment for a horizontal divider with a label. |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | 鈥?| Alias of `align`; takes precedence when set. |\n| `plain` | `boolean` | `false` | Use body text style for the label. |\n| `size` | `'small' \\| 'medium' \\| 'large'` | 鈥?| Vertical margin for horizontal dividers (`--m-space-*`). |\n| `label` | `string` | 鈥?| Center label text. The default slot takes precedence when present. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Layout direction. |\n| `orientation` | `'horizontal' \\| 'vertical'` | 鈥?| Alias of `layout`. |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | Line style (solid / dashed / dotted). |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | Label alignment for a horizontal divider with a label. |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | 鈥?| Alias of `align`; takes precedence when set. |\n| `plain` | `boolean` | `false` | Use body text style for the label. |\n| `size` | `'small' \\| 'medium' \\| 'large'` | 鈥?| Vertical margin for horizontal dividers (`--m-space-*`). |\n| `label` | `string` | 鈥?| Center label text. The default slot takes precedence when present. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |"
             },
             {
               "id": "slots",
@@ -7497,7 +7718,7 @@
               "body": "No custom events."
             }
           ],
-          "markdown": "---\ntitle: Divider\ncategory: 01 / BASIC\ndescription: Content divider.\n---\n\n# Divider\n\nContent divider, optionally with a label.\n\n## Import\n\n```ts\nimport { MDivider } from 'morya-ui'\n```\n\n## Basic\n\nDefault horizontal solid divider.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Type\n\n`type` supports `solid`, `dashed`, and `dotted`.\n\n```vue preview src=\"./demos/Type.vue\"\n```\n\n## Align\n\nWhen the divider is horizontal and has a label, use `align` to control the label position.\n\n```vue preview src=\"./demos/Align.vue\"\n```\n\n## Title placement\n\n`titlePlacement` is an alias of `align`.\n\n```vue preview src=\"./demos/TitlePlacement.vue\"\n```\n\n## Layout\n\n`layout` controls horizontal / vertical; `orientation` is an alias.\n\n```vue preview src=\"./demos/Layout.vue\"\n```\n\n## Plain\n\n`plain` uses body text styling for the label (default is stronger heading weight).\n\n```vue preview src=\"./demos/Plain.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Layout direction. |\n| `orientation` | `'horizontal' \\| 'vertical'` | 鈥?| Alias of `layout`. |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | Line style (solid / dashed / dotted). |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | Label alignment for a horizontal divider with a label. |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | 鈥?| Alias of `align`; takes precedence when set. |\n| `plain` | `boolean` | `false` | Use body text style for the label. |\n| `size` | `'small' \\| 'medium' \\| 'large'` | 鈥?| Vertical margin for horizontal dividers (`--m-space-*`). |\n| `label` | `string` | 鈥?| Center label text. The default slot takes precedence when present. |\n\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Label content, takes precedence over `label`. |\n\n## Events\n\nNo custom events.\n"
+          "markdown": "---\ntitle: Divider\ncategory: 01 / BASIC\ndescription: Content divider.\n---\n\n# Divider\n\nContent divider, optionally with a label.\n\n## Import\n\n```ts\nimport { MDivider } from 'morya-ui'\n```\n\n## Basic\n\nDefault horizontal solid divider.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Type\n\n`type` supports `solid`, `dashed`, and `dotted`.\n\n```vue preview src=\"./demos/Type.vue\"\n```\n\n## Align\n\nWhen the divider is horizontal and has a label, use `align` to control the label position.\n\n```vue preview src=\"./demos/Align.vue\"\n```\n\n## Title placement\n\n`titlePlacement` is an alias of `align`.\n\n```vue preview src=\"./demos/TitlePlacement.vue\"\n```\n\n## Layout\n\n`layout` controls horizontal / vertical; `orientation` is an alias.\n\n```vue preview src=\"./demos/Layout.vue\"\n```\n\n## Plain\n\n`plain` uses body text styling for the label (default is stronger heading weight).\n\n```vue preview src=\"./demos/Plain.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `layout` | `'horizontal' \\| 'vertical'` | `'horizontal'` | Layout direction. |\n| `orientation` | `'horizontal' \\| 'vertical'` | 鈥?| Alias of `layout`. |\n| `type` | `'solid' \\| 'dashed' \\| 'dotted'` | `'solid'` | Line style (solid / dashed / dotted). |\n| `align` | `'left' \\| 'center' \\| 'right'` | `'center'` | Label alignment for a horizontal divider with a label. |\n| `titlePlacement` | `'left' \\| 'center' \\| 'right'` | 鈥?| Alias of `align`; takes precedence when set. |\n| `plain` | `boolean` | `false` | Use body text style for the label. |\n| `size` | `'small' \\| 'medium' \\| 'large'` | 鈥?| Vertical margin for horizontal dividers (`--m-space-*`). |\n| `label` | `string` | 鈥?| Center label text. The default slot takes precedence when present. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |\n\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Label content, takes precedence over `label`. |\n\n## Events\n\nNo custom events.\n"
         }
       }
     },
@@ -7873,7 +8094,7 @@
           "sectionId": "position",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'left' | 'right' | 'top' | 'bottom'>('right')\n\nfunction openAt(next: 'left' | 'right' | 'top' | 'bottom') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Left\" size=\"small\" @click=\"openAt('left')\" />\n    <MButton label=\"Right\" size=\"small\" severity=\"secondary\" @click=\"openAt('right')\" />\n    <MButton label=\"Top\" size=\"small\" severity=\"secondary\" @click=\"openAt('top')\" />\n    <MButton label=\"Bottom\" size=\"small\" severity=\"secondary\" @click=\"openAt('bottom')\" />\n    <MDrawer v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Use <code>dismissable</code> to control mask dismiss.\n      </p>\n    </MDrawer>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'left' | 'right' | 'top' | 'bottom'>('right')\n\nfunction openAt(next: 'left' | 'right' | 'top' | 'bottom') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Left\" size=\"small\" @click=\"openAt('left')\" />\n    <MButton label=\"Right\" size=\"small\" @click=\"openAt('right')\"/>\n    <MButton label=\"Top\" size=\"small\" @click=\"openAt('top')\"/>\n    <MButton label=\"Bottom\" size=\"small\" @click=\"openAt('bottom')\"/>\n    <MDrawer v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Use <code>dismissable</code> to control mask dismiss.\n      </p>\n    </MDrawer>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -7882,7 +8103,7 @@
           "sectionId": "footer",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer, MSpace } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDrawer v-model=\"open\" header=\"Edit details\" position=\"right\" :width=\"360\">\n      <p style=\"margin:0\">\n        Put primary and secondary actions in the footer slot so the body can scroll independently.\n      </p>\n      <template #footer>\n        <MSpace style=\"justify-content: flex-end; width: 100%\">\n          <MButton label=\"Cancel\" severity=\"secondary\" text @click=\"open = false\" />\n          <MButton label=\"Save\" @click=\"open = false\" />\n        </MSpace>\n      </template>\n    </MDrawer>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer, MSpace } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDrawer v-model=\"open\" header=\"Edit details\" position=\"right\" :width=\"360\">\n      <p style=\"margin:0\">\n        Put primary and secondary actions in the footer slot so the body can scroll independently.\n      </p>\n      <template #footer>\n        <MSpace style=\"justify-content: flex-end; width: 100%\">\n          <MButton label=\"Cancel\" @click=\"open = false\" type=\"text\"/>\n          <MButton label=\"Save\" @click=\"open = false\" />\n        </MSpace>\n      </template>\n    </MDrawer>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -7909,7 +8130,7 @@
           "sectionId": "position",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'left' | 'right' | 'top' | 'bottom'>('right')\n\nfunction openAt(next: 'left' | 'right' | 'top' | 'bottom') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Left\" size=\"small\" @click=\"openAt('left')\" />\n    <MButton label=\"Right\" size=\"small\" severity=\"secondary\" @click=\"openAt('right')\" />\n    <MButton label=\"Top\" size=\"small\" severity=\"secondary\" @click=\"openAt('top')\" />\n    <MButton label=\"Bottom\" size=\"small\" severity=\"secondary\" @click=\"openAt('bottom')\" />\n    <MDrawer v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Use <code>dismissable</code> to control mask dismiss.\n      </p>\n    </MDrawer>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst position = ref<'left' | 'right' | 'top' | 'bottom'>('right')\n\nfunction openAt(next: 'left' | 'right' | 'top' | 'bottom') {\n  position.value = next\n  open.value = true\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Left\" size=\"small\" @click=\"openAt('left')\" />\n    <MButton label=\"Right\" size=\"small\" @click=\"openAt('right')\"/>\n    <MButton label=\"Top\" size=\"small\" @click=\"openAt('top')\"/>\n    <MButton label=\"Bottom\" size=\"small\" @click=\"openAt('bottom')\"/>\n    <MDrawer v-model=\"open\" :header=\"`Position: ${position}`\" :position=\"position\">\n      <p style=\"margin:0\">\n        Use <code>dismissable</code> to control mask dismiss.\n      </p>\n    </MDrawer>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -7918,7 +8139,7 @@
           "sectionId": "footer",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer, MSpace } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDrawer v-model=\"open\" header=\"Edit details\" position=\"right\" :width=\"360\">\n      <p style=\"margin:0\">\n        Put primary and secondary actions in the footer slot so the body can scroll independently.\n      </p>\n      <template #footer>\n        <MSpace style=\"justify-content: flex-end; width: 100%\">\n          <MButton label=\"Cancel\" severity=\"secondary\" text @click=\"open = false\" />\n          <MButton label=\"Save\" @click=\"open = false\" />\n        </MSpace>\n      </template>\n    </MDrawer>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDrawer, MSpace } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div>\n    <MButton label=\"With Footer\" @click=\"open = true\" />\n    <MDrawer v-model=\"open\" header=\"Edit details\" position=\"right\" :width=\"360\">\n      <p style=\"margin:0\">\n        Put primary and secondary actions in the footer slot so the body can scroll independently.\n      </p>\n      <template #footer>\n        <MSpace style=\"justify-content: flex-end; width: 100%\">\n          <MButton label=\"Cancel\" @click=\"open = false\" type=\"text\"/>\n          <MButton label=\"Save\" @click=\"open = false\" />\n        </MSpace>\n      </template>\n    </MDrawer>\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -8140,7 +8361,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { value: 'edit', label: 'Edit' },\n  { value: 'duplicate', label: 'Duplicate' },\n  { value: 'delete', label: 'Delete', disabled: true },\n]\n\nfunction onSelect(item: { value?: string; label?: string }) {\n  open.value = false\n  console.log(item.value)\n}\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" @select=\"onSelect\">\n    <template #trigger>\n      <MButton label=\"Actions\" icon=\"chevron-down\" icon-pos=\"right\" severity=\"secondary\" />\n    </template>\n  </MDropdown>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { value: 'edit', label: 'Edit' },\n  { value: 'duplicate', label: 'Duplicate' },\n  { value: 'delete', label: 'Delete', disabled: true },\n]\n\nfunction onSelect(item: { value?: string; label?: string }) {\n  open.value = false\n  console.log(item.value)\n}\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" @select=\"onSelect\">\n    <template #trigger>\n      <MButton label=\"Actions\" icon=\"chevron-down\" icon-placement=\"end\"/>\n    </template>\n  </MDropdown>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -8149,7 +8370,7 @@
           "sectionId": "nested-group-hover",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { type: 'group' as const, label: '编辑', items: [{ value: 'cut', label: '剪切' }, { value: 'copy', label: '复制' }] },\n  { separator: true },\n  { value: 'more', label: '更多', items: [{ value: 'deep', label: '深层操作' }] },\n]\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" trigger=\"hover\" :show-delay=\"0\" :hide-delay=\"200\">\n    <template #trigger>\n      <MButton label=\"悬停打开\" severity=\"secondary\" />\n    </template>\n  </MDropdown>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { type: 'group' as const, label: '编辑', items: [{ value: 'cut', label: '剪切' }, { value: 'copy', label: '复制' }] },\n  { separator: true },\n  { value: 'more', label: '更多', items: [{ value: 'deep', label: '深层操作' }] },\n]\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" trigger=\"hover\" :show-delay=\"0\" :hide-delay=\"200\">\n    <template #trigger>\n      <MButton label=\"悬停打开\"/>\n    </template>\n  </MDropdown>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -8176,7 +8397,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { value: 'edit', label: 'Edit' },\n  { value: 'duplicate', label: 'Duplicate' },\n  { value: 'delete', label: 'Delete', disabled: true },\n]\n\nfunction onSelect(item: { value?: string; label?: string }) {\n  open.value = false\n  console.log(item.value)\n}\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" @select=\"onSelect\">\n    <template #trigger>\n      <MButton label=\"Actions\" icon=\"chevron-down\" icon-pos=\"right\" severity=\"secondary\" />\n    </template>\n  </MDropdown>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { value: 'edit', label: 'Edit' },\n  { value: 'duplicate', label: 'Duplicate' },\n  { value: 'delete', label: 'Delete', disabled: true },\n]\n\nfunction onSelect(item: { value?: string; label?: string }) {\n  open.value = false\n  console.log(item.value)\n}\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" @select=\"onSelect\">\n    <template #trigger>\n      <MButton label=\"Actions\" icon=\"chevron-down\" icon-placement=\"end\"/>\n    </template>\n  </MDropdown>\n</template>",
           "locale": "en-US"
         },
         {
@@ -8185,7 +8406,7 @@
           "sectionId": "nested-group-hover",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { type: 'group' as const, label: 'Edit', items: [{ value: 'cut', label: 'Cut' }, { value: 'copy', label: 'Copy' }] },\n  { separator: true },\n  { value: 'more', label: 'More', items: [{ value: 'deep', label: 'Deep action' }] },\n]\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" trigger=\"hover\" :show-delay=\"0\" :hide-delay=\"200\">\n    <template #trigger>\n      <MButton label=\"Hover to open\" severity=\"secondary\" />\n    </template>\n  </MDropdown>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MDropdown } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\nconst items = [\n  { type: 'group' as const, label: 'Edit', items: [{ value: 'cut', label: 'Cut' }, { value: 'copy', label: 'Copy' }] },\n  { separator: true },\n  { value: 'more', label: 'More', items: [{ value: 'deep', label: 'Deep action' }] },\n]\n</script>\n\n<template>\n  <MDropdown v-model=\"open\" :items=\"items\" trigger=\"hover\" :show-delay=\"0\" :hide-delay=\"200\">\n    <template #trigger>\n      <MButton label=\"Hover to open\"/>\n    </template>\n  </MDropdown>\n</template>",
           "locale": "en-US"
         },
         {
@@ -8424,7 +8645,7 @@
           "sectionId": "操作区",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MEmpty } from 'morya-ui'\n</script>\n\n<template>\n  <MEmpty\n    title=\"还没有课程\"\n    description=\"创建第一门课程后，学员就能在目录里看到它。也可以稍后从模板导入。\"\n    icon=\"book\"\n  >\n    <template #extra>\n      <MButton label=\"创建第一门课程\" />\n      <MButton label=\"从模板导入\" severity=\"secondary\" text />\n    </template>\n  </MEmpty>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MEmpty } from 'morya-ui'\n</script>\n\n<template>\n  <MEmpty\n    title=\"还没有课程\"\n    description=\"创建第一门课程后，学员就能在目录里看到它。也可以稍后从模板导入。\"\n    icon=\"book\"\n  >\n    <template #extra>\n      <MButton label=\"创建第一门课程\" />\n      <MButton label=\"从模板导入\" type=\"text\"/>\n    </template>\n  </MEmpty>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -8478,7 +8699,7 @@
           "sectionId": "actions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MEmpty } from 'morya-ui'\n</script>\n\n<template>\n  <MEmpty\n    title=\"No courses yet\"\n    description=\"Create your first course so learners can find it in the catalog. You can also import from a template later.\"\n    icon=\"book\"\n  >\n    <template #extra>\n      <MButton label=\"Create first course\" />\n      <MButton label=\"Import from template\" severity=\"secondary\" text />\n    </template>\n  </MEmpty>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MEmpty } from 'morya-ui'\n</script>\n\n<template>\n  <MEmpty\n    title=\"No courses yet\"\n    description=\"Create your first course so learners can find it in the catalog. You can also import from a template later.\"\n    icon=\"book\"\n  >\n    <template #extra>\n      <MButton label=\"Create first course\" />\n      <MButton label=\"Import from template\" type=\"text\"/>\n    </template>\n  </MEmpty>\n</template>",
           "locale": "en-US"
         },
         {
@@ -9463,7 +9684,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex>\n    <MButton label=\"一\" size=\"small\" />\n    <MButton label=\"二\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"三\" size=\"small\" severity=\"secondary\" />\n  </MFlex>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex>\n    <MButton label=\"一\" size=\"small\" />\n    <MButton label=\"二\" size=\"small\"/>\n    <MButton label=\"三\" size=\"small\"/>\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -9472,7 +9693,7 @@
           "sectionId": "vertical",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical>\n    <MButton label=\"上\" size=\"small\" />\n    <MButton label=\"中\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"下\" size=\"small\" severity=\"secondary\" />\n  </MFlex>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical>\n    <MButton label=\"上\" size=\"small\" />\n    <MButton label=\"中\" size=\"small\"/>\n    <MButton label=\"下\" size=\"small\"/>\n  </MFlex>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -9499,7 +9720,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex>\n    <MButton label=\"One\" size=\"small\" />\n    <MButton label=\"Two\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"Three\" size=\"small\" severity=\"secondary\" />\n  </MFlex>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex>\n    <MButton label=\"One\" size=\"small\" />\n    <MButton label=\"Two\" size=\"small\"/>\n    <MButton label=\"Three\" size=\"small\"/>\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -9508,7 +9729,7 @@
           "sectionId": "vertical",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical>\n    <MButton label=\"Top\" size=\"small\" />\n    <MButton label=\"Middle\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"Bottom\" size=\"small\" severity=\"secondary\" />\n  </MFlex>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MFlex } from 'morya-ui'\n</script>\n\n<template>\n  <MFlex vertical>\n    <MButton label=\"Top\" size=\"small\" />\n    <MButton label=\"Middle\" size=\"small\"/>\n    <MButton label=\"Bottom\" size=\"small\"/>\n  </MFlex>\n</template>",
           "locale": "en-US"
         },
         {
@@ -10176,7 +10397,7 @@
           "sectionId": "声明式-rules",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { FormInstance, FormRules } from 'morya-ui'\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive, ref } from 'vue'\n\nconst formRef = ref<FormInstance | null>(null)\nconst model = reactive({ name: '', email: '' })\nconst rules: FormRules = {\n  name: { required: true, message: '请输入名称', trigger: ['blur', 'input'] },\n  email: [\n    { required: true, message: '请输入邮箱', trigger: 'blur' },\n    { pattern: /.[^\\n\\r@\\u2028\\u2029]*@.+\\..+/, message: '邮箱格式不正确', trigger: 'blur' },\n  ],\n}\n\nasync function onSubmit() {\n  const { valid } = await formRef.value!.validate()\n  if (!valid) return\n}\n</script>\n\n<template>\n  <MForm\n    ref=\"formRef\"\n    :model=\"model\"\n    :rules=\"rules\"\n    label-position=\"top\"\n    validate-on=\"submit\"\n    style=\"max-width: 22rem\"\n    @submit=\"onSubmit\"\n  >\n    <MFormItem label=\"名称\" name=\"name\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MFormItem label=\"邮箱\" name=\"email\" help=\"用于接收通知\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.email\" type=\"email\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton native-type=\"submit\" label=\"提交\" />\n  </MForm>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { FormInstance, FormRules } from 'morya-ui'\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive, ref } from 'vue'\n\nconst formRef = ref<FormInstance | null>(null)\nconst model = reactive({ name: '', email: '' })\nconst rules: FormRules = {\n  name: { required: true, message: '请输入名称', trigger: ['blur', 'input'] },\n  email: [\n    { required: true, message: '请输入邮箱', trigger: 'blur' },\n    { pattern: /.[^\\n\\r@\\u2028\\u2029]*@.+\\..+/, message: '邮箱格式不正确', trigger: 'blur' },\n  ],\n}\n\nasync function onSubmit() {\n  const { valid } = await formRef.value!.validate()\n  if (!valid) return\n}\n</script>\n\n<template>\n  <MForm\n    ref=\"formRef\"\n    :model=\"model\"\n    :rules=\"rules\"\n    label-position=\"top\"\n    validate-on=\"submit\"\n    style=\"max-width: 22rem\"\n    @submit=\"onSubmit\"\n  >\n    <MFormItem label=\"名称\" name=\"name\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MFormItem label=\"邮箱\" name=\"email\" help=\"用于接收通知\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.email\" type=\"email\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton html-type=\"submit\" label=\"提交\"/>\n  </MForm>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -10203,7 +10424,7 @@
           "sectionId": "回调校验-兼容",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive } from 'vue'\n\nconst form = reactive({ name: '' })\n</script>\n\n<template>\n  <MForm validate-on=\"submit\" style=\"max-width: 22rem\">\n    <MFormItem\n      label=\"名称\"\n      name=\"name\"\n      required\n      :validate=\"() => (form.name.trim() ? undefined : '请输入名称')\"\n    >\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"form.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton native-type=\"submit\" label=\"提交\" />\n  </MForm>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive } from 'vue'\n\nconst form = reactive({ name: '' })\n</script>\n\n<template>\n  <MForm validate-on=\"submit\" style=\"max-width: 22rem\">\n    <MFormItem\n      label=\"名称\"\n      name=\"name\"\n      required\n      :validate=\"() => (form.name.trim() ? undefined : '请输入名称')\"\n    >\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"form.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton html-type=\"submit\" label=\"提交\"/>\n  </MForm>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -10239,7 +10460,7 @@
           "sectionId": "declarative-rules",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { FormInstance, FormRules } from 'morya-ui'\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive, ref } from 'vue'\n\nconst formRef = ref<FormInstance | null>(null)\nconst model = reactive({ name: '', email: '' })\nconst rules: FormRules = {\n  name: { required: true, message: 'Enter a name', trigger: ['blur', 'input'] },\n  email: [\n    { required: true, message: 'Enter an email', trigger: 'blur' },\n    { pattern: /.[^\\n\\r@\\u2028\\u2029]*@.+\\..+/, message: 'Enter a valid email', trigger: 'blur' },\n  ],\n}\n\nasync function onSubmit() {\n  const { valid } = await formRef.value!.validate()\n  if (!valid) return\n}\n</script>\n\n<template>\n  <MForm\n    ref=\"formRef\"\n    :model=\"model\"\n    :rules=\"rules\"\n    label-position=\"top\"\n    validate-on=\"submit\"\n    style=\"max-width: 22rem\"\n    @submit=\"onSubmit\"\n  >\n    <MFormItem label=\"Name\" name=\"name\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MFormItem label=\"Email\" name=\"email\" help=\"Used for notifications\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.email\" type=\"email\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton native-type=\"submit\" label=\"Submit\" />\n  </MForm>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { FormInstance, FormRules } from 'morya-ui'\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive, ref } from 'vue'\n\nconst formRef = ref<FormInstance | null>(null)\nconst model = reactive({ name: '', email: '' })\nconst rules: FormRules = {\n  name: { required: true, message: 'Enter a name', trigger: ['blur', 'input'] },\n  email: [\n    { required: true, message: 'Enter an email', trigger: 'blur' },\n    { pattern: /.[^\\n\\r@\\u2028\\u2029]*@.+\\..+/, message: 'Enter a valid email', trigger: 'blur' },\n  ],\n}\n\nasync function onSubmit() {\n  const { valid } = await formRef.value!.validate()\n  if (!valid) return\n}\n</script>\n\n<template>\n  <MForm\n    ref=\"formRef\"\n    :model=\"model\"\n    :rules=\"rules\"\n    label-position=\"top\"\n    validate-on=\"submit\"\n    style=\"max-width: 22rem\"\n    @submit=\"onSubmit\"\n  >\n    <MFormItem label=\"Name\" name=\"name\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MFormItem label=\"Email\" name=\"email\" help=\"Used for notifications\">\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"model.email\" type=\"email\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton html-type=\"submit\" label=\"Submit\"/>\n  </MForm>\n</template>",
           "locale": "en-US"
         },
         {
@@ -10266,7 +10487,7 @@
           "sectionId": "callback-validation-compatible",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive } from 'vue'\n\nconst form = reactive({ name: '' })\n</script>\n\n<template>\n  <MForm validate-on=\"submit\" style=\"max-width: 22rem\">\n    <MFormItem\n      label=\"Name\"\n      name=\"name\"\n      required\n      :validate=\"() => (form.name.trim() ? undefined : 'Enter a name')\"\n    >\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"form.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton native-type=\"submit\" label=\"Submit\" />\n  </MForm>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MForm, MFormItem, MInput } from 'morya-ui'\nimport { reactive } from 'vue'\n\nconst form = reactive({ name: '' })\n</script>\n\n<template>\n  <MForm validate-on=\"submit\" style=\"max-width: 22rem\">\n    <MFormItem\n      label=\"Name\"\n      name=\"name\"\n      required\n      :validate=\"() => (form.name.trim() ? undefined : 'Enter a name')\"\n    >\n      <template #default=\"{ id, invalid }\">\n        <MInput :id=\"id\" v-model=\"form.name\" fluid :invalid=\"invalid\" />\n      </template>\n    </MFormItem>\n    <MButton html-type=\"submit\" label=\"Submit\"/>\n  </MForm>\n</template>",
           "locale": "en-US"
         },
         {
@@ -15595,7 +15816,7 @@
           "sectionId": "服务式调用",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, useLoading } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst panel = ref<HTMLElement>()\nconst { open } = useLoading()\n\nfunction openRegion() {\n  const instance = open({\n    target: panel.value,\n    text: '加载中',\n    effect: 'wave',\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n\nfunction openFullscreen() {\n  const instance = open({\n    text: '正在提交',\n    effect: 'aurora',\n    lock: true,\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <div\n      ref=\"panel\"\n      class=\"min-h-32 rounded-md border border-solid border-[var(--m-color-border)] p-4\"\n    >\n      可被服务盖住的区域\n    </div>\n    <div class=\"flex flex-wrap gap-3\">\n      <MButton label=\"区域加载\" severity=\"secondary\" @click=\"openRegion\" />\n      <MButton label=\"全屏加载\" @click=\"openFullscreen\" />\n    </div>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, useLoading } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst panel = ref<HTMLElement>()\nconst { open } = useLoading()\n\nfunction openRegion() {\n  const instance = open({\n    target: panel.value,\n    text: '加载中',\n    effect: 'wave',\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n\nfunction openFullscreen() {\n  const instance = open({\n    text: '正在提交',\n    effect: 'aurora',\n    lock: true,\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <div\n      ref=\"panel\"\n      class=\"min-h-32 rounded-md border border-solid border-[var(--m-color-border)] p-4\"\n    >\n      可被服务盖住的区域\n    </div>\n    <div class=\"flex flex-wrap gap-3\">\n      <MButton label=\"区域加载\" @click=\"openRegion\"/>\n      <MButton label=\"全屏加载\" @click=\"openFullscreen\" />\n    </div>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -15658,7 +15879,7 @@
           "sectionId": "service",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, useLoading } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst panel = ref<HTMLElement>()\nconst { open } = useLoading()\n\nfunction openRegion() {\n  const instance = open({\n    target: panel.value,\n    text: 'Loading',\n    effect: 'wave',\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n\nfunction openFullscreen() {\n  const instance = open({\n    text: 'Submitting',\n    effect: 'aurora',\n    lock: true,\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <div\n      ref=\"panel\"\n      class=\"min-h-32 rounded-md border border-solid border-[var(--m-color-border)] p-4\"\n    >\n      Region covered by the service\n    </div>\n    <div class=\"flex flex-wrap gap-3\">\n      <MButton label=\"Cover region\" severity=\"secondary\" @click=\"openRegion\" />\n      <MButton label=\"Fullscreen\" @click=\"openFullscreen\" />\n    </div>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, useLoading } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst panel = ref<HTMLElement>()\nconst { open } = useLoading()\n\nfunction openRegion() {\n  const instance = open({\n    target: panel.value,\n    text: 'Loading',\n    effect: 'wave',\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n\nfunction openFullscreen() {\n  const instance = open({\n    text: 'Submitting',\n    effect: 'aurora',\n    lock: true,\n  })\n  window.setTimeout(() => instance.close(), 1600)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <div\n      ref=\"panel\"\n      class=\"min-h-32 rounded-md border border-solid border-[var(--m-color-border)] p-4\"\n    >\n      Region covered by the service\n    </div>\n    <div class=\"flex flex-wrap gap-3\">\n      <MButton label=\"Cover region\" @click=\"openRegion\"/>\n      <MButton label=\"Fullscreen\" @click=\"openFullscreen\" />\n    </div>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -17198,7 +17419,7 @@
           "sectionId": "api",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, message } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Success\" severity=\"success\" @click=\"message.success('保存成功')\" />\n    <MButton label=\"Info\" severity=\"info\" @click=\"message.info('这是一条提示')\" />\n    <MButton label=\"Warn\" severity=\"warn\" @click=\"message.warn('请核对后再提交')\" />\n    <MButton label=\"Error\" severity=\"danger\" @click=\"message.error('请求失败，请重试')\" />\n    <MButton\n      label=\"Closable\"\n      @click=\"message.info({ content: '可手动关闭', closable: true, life: 0 })\"\n    />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, message } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Success\" @click=\"message.success('保存成功')\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"message.info('这是一条提示')\" color=\"info\" variant=\"solid\"/>\n    <MButton label=\"Warn\" @click=\"message.warn('请核对后再提交')\" color=\"warning\" variant=\"solid\"/>\n    <MButton label=\"Error\" @click=\"message.error('请求失败，请重试')\" danger type=\"primary\"/>\n    <MButton\n      label=\"Closable\"\n      @click=\"message.info({ content: '可手动关闭', closable: true, life: 0 })\"\n    />\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -17243,7 +17464,7 @@
           "sectionId": "api",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, message } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Success\" severity=\"success\" @click=\"message.success('Saved')\" />\n    <MButton label=\"Info\" severity=\"info\" @click=\"message.info('A short tip')\" />\n    <MButton label=\"Warn\" severity=\"warn\" @click=\"message.warn('Please double-check')\" />\n    <MButton label=\"Error\" severity=\"danger\" @click=\"message.error('Request failed')\" />\n    <MButton\n      label=\"Closable\"\n      @click=\"message.info({ content: 'Dismiss manually', closable: true, life: 0 })\"\n    />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, message } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3\">\n    <MButton label=\"Success\" @click=\"message.success('Saved')\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"message.info('A short tip')\" color=\"info\" variant=\"solid\"/>\n    <MButton label=\"Warn\" @click=\"message.warn('Please double-check')\" color=\"warning\" variant=\"solid\"/>\n    <MButton label=\"Error\" @click=\"message.error('Request failed')\" danger type=\"primary\"/>\n    <MButton\n      label=\"Closable\"\n      @click=\"message.info({ content: 'Dismiss manually', closable: true, life: 0 })\"\n    />\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -17940,7 +18161,7 @@
           "sectionId": "列表页组合",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilters,\n  MPageHeader,\n  MPageToolbar,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst keyword = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"用户管理\" description=\"维护账号与角色。\">\n        <template #actions>\n          <MButton severity=\"primary\">\n            新建\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters aria-label=\"筛选\" variant=\"filled\">\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"搜索\" clearable class=\"w-48\" />\n        </MSpace>\n        <template #actions>\n          <MButton severity=\"secondary\">\n            查询\n          </MButton>\n        </template>\n      </MPageFilters>\n      <MPageToolbar>\n        <span style=\"color:var(--m-color-text-muted);font-size:var(--m-font-size-sm)\">已选 0 项</span>\n        <template #actions>\n          <MButton severity=\"secondary\" text>\n            导出\n          </MButton>\n          <MButton severity=\"danger\" text>\n            删除\n          </MButton>\n        </template>\n      </MPageToolbar>\n    </MPageContent>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilters,\n  MPageHeader,\n  MPageToolbar,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst keyword = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"用户管理\" description=\"维护账号与角色。\">\n        <template #actions>\n          <MButton type=\"primary\">\n            新建\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters aria-label=\"筛选\" variant=\"filled\">\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"搜索\" clearable class=\"w-48\" />\n        </MSpace>\n        <template #actions>\n          <MButton>\n            查询\n          </MButton>\n        </template>\n      </MPageFilters>\n      <MPageToolbar>\n        <span style=\"color:var(--m-color-text-muted);font-size:var(--m-font-size-sm)\">已选 0 项</span>\n        <template #actions>\n          <MButton type=\"text\">\n            导出\n          </MButton>\n          <MButton type=\"text\" danger>\n            删除\n          </MButton>\n        </template>\n      </MPageToolbar>\n    </MPageContent>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -17949,7 +18170,7 @@
           "sectionId": "列表页组合",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilterChips,\n  MPageFilters,\n  MPageHeader,\n  MSelect,\n  MSpace,\n  MTag,\n} from 'morya-ui'\nimport { computed, ref } from 'vue'\n\nconst keyword = ref('')\nconst status = ref<string | null>('active')\nconst filtersExpanded = ref(false)\nconst department = ref<string | null>(null)\n\nconst activeFilters = computed(() => {\n  const items: Array<{ key: string; label: string }> = []\n  if (keyword.value.trim()) {\n    items.push({ key: 'keyword', label: `关键词：${keyword.value.trim()}` })\n  }\n  if (status.value && status.value !== 'all') {\n    items.push({ key: 'status', label: `状态：${status.value === 'active' ? '启用' : '停用'}` })\n  }\n  if (department.value) {\n    items.push({ key: 'department', label: `部门：${department.value}` })\n  }\n  return items\n})\n\nfunction clearFilter(key: string) {\n  if (key === 'keyword') keyword.value = ''\n  if (key === 'status') status.value = 'all'\n  if (key === 'department') department.value = null\n}\n\nfunction resetAll() {\n  keyword.value = ''\n  status.value = 'all'\n  department.value = null\n}\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"用户管理\" description=\"折叠高级筛选（chevron + 收起），查询/重置放 #actions。\">\n        <template #actions>\n          <MButton severity=\"primary\">\n            新建\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters\n        v-model:expanded=\"filtersExpanded\"\n        aria-label=\"筛选\"\n        variant=\"filled\"\n        collapsible\n      >\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"搜索名称\" clearable style=\"width: 14rem\" />\n          <MSelect\n            v-model=\"status\"\n            :options=\"[\n              { label: '全部', value: 'all' },\n              { label: '启用', value: 'active' },\n              { label: '停用', value: 'inactive' },\n            ]\"\n            placeholder=\"状态\"\n            style=\"width: 10rem\"\n          />\n        </MSpace>\n        <template #actions>\n          <MButton severity=\"secondary\">\n            查询\n          </MButton>\n          <MButton severity=\"secondary\" text @click=\"resetAll\">\n            重置\n          </MButton>\n        </template>\n        <template #advanced>\n          <MSpace wrap>\n            <MSelect\n              v-model=\"department\"\n              :options=\"[\n                { label: '研发', value: '研发' },\n                { label: '运营', value: '运营' },\n              ]\"\n              placeholder=\"部门\"\n              clearable\n              style=\"width: 10rem\"\n            />\n          </MSpace>\n        </template>\n      </MPageFilters>\n      <MPageFilterChips v-if=\"activeFilters.length\" label=\"已选\" aria-label=\"已选筛选\">\n        <MTag\n          v-for=\"item in activeFilters\"\n          :key=\"item.key\"\n          :value=\"item.label\"\n          size=\"small\"\n          bordered\n          closable\n          @close=\"clearFilter(item.key)\"\n        />\n      </MPageFilterChips>\n    </MPageContent>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilterChips,\n  MPageFilters,\n  MPageHeader,\n  MSelect,\n  MSpace,\n  MTag,\n} from 'morya-ui'\nimport { computed, ref } from 'vue'\n\nconst keyword = ref('')\nconst status = ref<string | null>('active')\nconst filtersExpanded = ref(false)\nconst department = ref<string | null>(null)\n\nconst activeFilters = computed(() => {\n  const items: Array<{ key: string; label: string }> = []\n  if (keyword.value.trim()) {\n    items.push({ key: 'keyword', label: `关键词：${keyword.value.trim()}` })\n  }\n  if (status.value && status.value !== 'all') {\n    items.push({ key: 'status', label: `状态：${status.value === 'active' ? '启用' : '停用'}` })\n  }\n  if (department.value) {\n    items.push({ key: 'department', label: `部门：${department.value}` })\n  }\n  return items\n})\n\nfunction clearFilter(key: string) {\n  if (key === 'keyword') keyword.value = ''\n  if (key === 'status') status.value = 'all'\n  if (key === 'department') department.value = null\n}\n\nfunction resetAll() {\n  keyword.value = ''\n  status.value = 'all'\n  department.value = null\n}\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"用户管理\" description=\"折叠高级筛选（chevron + 收起），查询/重置放 #actions。\">\n        <template #actions>\n          <MButton type=\"primary\">\n            新建\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters\n        v-model:expanded=\"filtersExpanded\"\n        aria-label=\"筛选\"\n        variant=\"filled\"\n        collapsible\n      >\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"搜索名称\" clearable style=\"width: 14rem\" />\n          <MSelect\n            v-model=\"status\"\n            :options=\"[\n              { label: '全部', value: 'all' },\n              { label: '启用', value: 'active' },\n              { label: '停用', value: 'inactive' },\n            ]\"\n            placeholder=\"状态\"\n            style=\"width: 10rem\"\n          />\n        </MSpace>\n        <template #actions>\n          <MButton>\n            查询\n          </MButton>\n          <MButton @click=\"resetAll\" type=\"text\">\n            重置\n          </MButton>\n        </template>\n        <template #advanced>\n          <MSpace wrap>\n            <MSelect\n              v-model=\"department\"\n              :options=\"[\n                { label: '研发', value: '研发' },\n                { label: '运营', value: '运营' },\n              ]\"\n              placeholder=\"部门\"\n              clearable\n              style=\"width: 10rem\"\n            />\n          </MSpace>\n        </template>\n      </MPageFilters>\n      <MPageFilterChips v-if=\"activeFilters.length\" label=\"已选\" aria-label=\"已选筛选\">\n        <MTag\n          v-for=\"item in activeFilters\"\n          :key=\"item.key\"\n          :value=\"item.label\"\n          size=\"small\"\n          bordered\n          closable\n          @close=\"clearFilter(item.key)\"\n        />\n      </MPageFilterChips>\n    </MPageContent>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -17958,7 +18179,7 @@
           "sectionId": "表单页组合",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MForm,\n  MFormItem,\n  MInput,\n  MPageContent,\n  MPageHeader,\n  MPageSection,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst name = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:hidden;background:var(--m-color-surface)\"\n  >\n    <MPageContent width=\"narrow\">\n      <MPageHeader title=\"新建用户\" description=\"填写基本信息。\" />\n      <MPageSection variant=\"form\">\n        <MForm @submit.prevent>\n          <MFormItem label=\"姓名\" name=\"name\">\n            <MInput v-model=\"name\" fluid />\n          </MFormItem>\n          <MPageSection variant=\"actions\">\n            <MSpace>\n              <MButton native-type=\"submit\" severity=\"primary\">\n                保存\n              </MButton>\n              <MButton severity=\"secondary\">\n                取消\n              </MButton>\n            </MSpace>\n          </MPageSection>\n        </MForm>\n      </MPageSection>\n    </MPageContent>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MForm,\n  MFormItem,\n  MInput,\n  MPageContent,\n  MPageHeader,\n  MPageSection,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst name = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:hidden;background:var(--m-color-surface)\"\n  >\n    <MPageContent width=\"narrow\">\n      <MPageHeader title=\"新建用户\" description=\"填写基本信息。\" />\n      <MPageSection variant=\"form\">\n        <MForm @submit.prevent>\n          <MFormItem label=\"姓名\" name=\"name\">\n            <MInput v-model=\"name\" fluid />\n          </MFormItem>\n          <MPageSection variant=\"actions\">\n            <MSpace>\n              <MButton html-type=\"submit\">\n                保存\n              </MButton>\n              <MButton>\n                取消\n              </MButton>\n            </MSpace>\n          </MPageSection>\n        </MForm>\n      </MPageSection>\n    </MPageContent>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -17994,7 +18215,7 @@
           "sectionId": "list-page-stack",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilters,\n  MPageHeader,\n  MPageToolbar,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst keyword = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"Users\" description=\"Manage accounts and roles.\">\n        <template #actions>\n          <MButton severity=\"primary\">\n            Create\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters aria-label=\"Filters\" variant=\"filled\">\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"Search\" clearable class=\"w-48\" />\n        </MSpace>\n        <template #actions>\n          <MButton severity=\"secondary\">\n            Search\n          </MButton>\n        </template>\n      </MPageFilters>\n      <MPageToolbar>\n        <span style=\"color:var(--m-color-text-muted);font-size:var(--m-font-size-sm)\">0 selected</span>\n        <template #actions>\n          <MButton severity=\"secondary\" text>\n            Export\n          </MButton>\n          <MButton severity=\"danger\" text>\n            Delete\n          </MButton>\n        </template>\n      </MPageToolbar>\n    </MPageContent>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilters,\n  MPageHeader,\n  MPageToolbar,\n  MSpace,\n} from 'morya-ui'\nimport { ref } from 'vue'\n\nconst keyword = ref('')\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"Users\" description=\"Manage accounts and roles.\">\n        <template #actions>\n          <MButton type=\"primary\">\n            Create\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters aria-label=\"Filters\" variant=\"filled\">\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"Search\" clearable class=\"w-48\" />\n        </MSpace>\n        <template #actions>\n          <MButton>\n            Search\n          </MButton>\n        </template>\n      </MPageFilters>\n      <MPageToolbar>\n        <span style=\"color:var(--m-color-text-muted);font-size:var(--m-font-size-sm)\">0 selected</span>\n        <template #actions>\n          <MButton type=\"text\">\n            Export\n          </MButton>\n          <MButton type=\"text\" danger>\n            Delete\n          </MButton>\n        </template>\n      </MPageToolbar>\n    </MPageContent>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -18003,7 +18224,7 @@
           "sectionId": "list-page-stack",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilterChips,\n  MPageFilters,\n  MPageHeader,\n  MSelect,\n  MSpace,\n  MTag,\n} from 'morya-ui'\nimport { computed, ref } from 'vue'\n\nconst keyword = ref('')\nconst status = ref<string | null>('active')\nconst filtersExpanded = ref(false)\nconst department = ref<string | null>(null)\n\nconst activeFilters = computed(() => {\n  const items: Array<{ key: string; label: string }> = []\n  if (keyword.value.trim()) {\n    items.push({ key: 'keyword', label: `Keyword: ${keyword.value.trim()}` })\n  }\n  if (status.value && status.value !== 'all') {\n    items.push({\n      key: 'status',\n      label: `Status: ${status.value === 'active' ? 'Active' : 'Inactive'}`,\n    })\n  }\n  if (department.value) {\n    items.push({ key: 'department', label: `Department: ${department.value}` })\n  }\n  return items\n})\n\nfunction clearFilter(key: string) {\n  if (key === 'keyword') keyword.value = ''\n  if (key === 'status') status.value = 'all'\n  if (key === 'department') department.value = null\n}\n\nfunction resetAll() {\n  keyword.value = ''\n  status.value = 'all'\n  department.value = null\n}\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"Users\" description=\"Collapsible advanced filters (chevron + Collapse); query/reset in #actions.\">\n        <template #actions>\n          <MButton severity=\"primary\">\n            Create\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters\n        v-model:expanded=\"filtersExpanded\"\n        aria-label=\"Filters\"\n        variant=\"filled\"\n        collapsible\n      >\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"Search name\" clearable style=\"width: 14rem\" />\n          <MSelect\n            v-model=\"status\"\n            :options=\"[\n              { label: 'All', value: 'all' },\n              { label: 'Active', value: 'active' },\n              { label: 'Inactive', value: 'inactive' },\n            ]\"\n            placeholder=\"Status\"\n            style=\"width: 10rem\"\n          />\n        </MSpace>\n        <template #actions>\n          <MButton severity=\"secondary\">\n            Search\n          </MButton>\n          <MButton severity=\"secondary\" text @click=\"resetAll\">\n            Reset\n          </MButton>\n        </template>\n        <template #advanced>\n          <MSpace wrap>\n            <MSelect\n              v-model=\"department\"\n              :options=\"[\n                { label: 'Engineering', value: 'Engineering' },\n                { label: 'Operations', value: 'Operations' },\n              ]\"\n              placeholder=\"Department\"\n              clearable\n              style=\"width: 10rem\"\n            />\n          </MSpace>\n        </template>\n      </MPageFilters>\n      <MPageFilterChips v-if=\"activeFilters.length\" label=\"Active\" aria-label=\"Active filters\">\n        <MTag\n          v-for=\"item in activeFilters\"\n          :key=\"item.key\"\n          :value=\"item.label\"\n          size=\"small\"\n          bordered\n          closable\n          @close=\"clearFilter(item.key)\"\n        />\n      </MPageFilterChips>\n    </MPageContent>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport {\n  MButton,\n  MInput,\n  MPageContent,\n  MPageFilterChips,\n  MPageFilters,\n  MPageHeader,\n  MSelect,\n  MSpace,\n  MTag,\n} from 'morya-ui'\nimport { computed, ref } from 'vue'\n\nconst keyword = ref('')\nconst status = ref<string | null>('active')\nconst filtersExpanded = ref(false)\nconst department = ref<string | null>(null)\n\nconst activeFilters = computed(() => {\n  const items: Array<{ key: string; label: string }> = []\n  if (keyword.value.trim()) {\n    items.push({ key: 'keyword', label: `Keyword: ${keyword.value.trim()}` })\n  }\n  if (status.value && status.value !== 'all') {\n    items.push({\n      key: 'status',\n      label: `Status: ${status.value === 'active' ? 'Active' : 'Inactive'}`,\n    })\n  }\n  if (department.value) {\n    items.push({ key: 'department', label: `Department: ${department.value}` })\n  }\n  return items\n})\n\nfunction clearFilter(key: string) {\n  if (key === 'keyword') keyword.value = ''\n  if (key === 'status') status.value = 'all'\n  if (key === 'department') department.value = null\n}\n\nfunction resetAll() {\n  keyword.value = ''\n  status.value = 'all'\n  department.value = null\n}\n</script>\n\n<template>\n  <div\n    class=\"doc-demo-frame\"\n    style=\"border:1px solid var(--m-color-border);border-radius:var(--m-radius-md);overflow:visible;background:var(--m-color-surface)\"\n  >\n    <MPageContent>\n      <MPageHeader title=\"Users\" description=\"Collapsible advanced filters (chevron + Collapse); query/reset in #actions.\">\n        <template #actions>\n          <MButton type=\"primary\">\n            Create\n          </MButton>\n        </template>\n      </MPageHeader>\n      <MPageFilters\n        v-model:expanded=\"filtersExpanded\"\n        aria-label=\"Filters\"\n        variant=\"filled\"\n        collapsible\n      >\n        <MSpace wrap>\n          <MInput v-model=\"keyword\" placeholder=\"Search name\" clearable style=\"width: 14rem\" />\n          <MSelect\n            v-model=\"status\"\n            :options=\"[\n              { label: 'All', value: 'all' },\n              { label: 'Active', value: 'active' },\n              { label: 'Inactive', value: 'inactive' },\n            ]\"\n            placeholder=\"Status\"\n            style=\"width: 10rem\"\n          />\n        </MSpace>\n        <template #actions>\n          <MButton>\n            Search\n          </MButton>\n          <MButton @click=\"resetAll\" type=\"text\">\n            Reset\n          </MButton>\n        </template>\n        <template #advanced>\n          <MSpace wrap>\n            <MSelect\n              v-model=\"department\"\n              :options=\"[\n                { label: 'Engineering', value: 'Engineering' },\n                { label: 'Operations', value: 'Operations' },\n              ]\"\n              placeholder=\"Department\"\n              clearable\n              style=\"width: 10rem\"\n            />\n          </MSpace>\n        </template>\n      </MPageFilters>\n      <MPageFilterChips v-if=\"activeFilters.length\" label=\"Active\" aria-label=\"Active filters\">\n        <MTag\n          v-for=\"item in activeFilters\"\n          :key=\"item.key\"\n          :value=\"item.label\"\n          size=\"small\"\n          bordered\n          closable\n          @close=\"clearFilter(item.key)\"\n        />\n      </MPageFilterChips>\n    </MPageContent>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -18973,7 +19194,7 @@
           "sectionId": "placement",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div style=\"display:flex;justify-content:center;padding:2rem\">\n    <MPopover v-model=\"open\" placement=\"bottom-start\">\n      <MButton label=\"bottom-start\" severity=\"secondary\" @click=\"open = !open\" />\n      <template #content>\n        <p style=\"margin:0\">\n          Aligned to the start of the trigger.\n        </p>\n      </template>\n    </MPopover>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div style=\"display:flex;justify-content:center;padding:2rem\">\n    <MPopover v-model=\"open\" placement=\"bottom-start\">\n      <MButton label=\"bottom-start\" @click=\"open = !open\"/>\n      <template #content>\n        <p style=\"margin:0\">\n          Aligned to the start of the trigger.\n        </p>\n      </template>\n    </MPopover>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -18982,7 +19203,7 @@
           "sectionId": "hover",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <MPopover v-model=\"open\" trigger=\"hover\" :show-delay=\"80\" :hide-delay=\"120\">\n    <MButton label=\"Hover me\" severity=\"secondary\" />\n    <template #content>\n      <p style=\"margin:0\">\n        Opens on hover.\n      </p>\n    </template>\n  </MPopover>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <MPopover v-model=\"open\" trigger=\"hover\" :show-delay=\"80\" :hide-delay=\"120\">\n    <MButton label=\"Hover me\"/>\n    <template #content>\n      <p style=\"margin:0\">\n        Opens on hover.\n      </p>\n    </template>\n  </MPopover>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -19009,7 +19230,7 @@
           "sectionId": "placement",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div style=\"display:flex;justify-content:center;padding:2rem\">\n    <MPopover v-model=\"open\" placement=\"bottom-start\">\n      <MButton label=\"bottom-start\" severity=\"secondary\" @click=\"open = !open\" />\n      <template #content>\n        <p style=\"margin:0\">\n          Aligned to the start of the trigger.\n        </p>\n      </template>\n    </MPopover>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <div style=\"display:flex;justify-content:center;padding:2rem\">\n    <MPopover v-model=\"open\" placement=\"bottom-start\">\n      <MButton label=\"bottom-start\" @click=\"open = !open\"/>\n      <template #content>\n        <p style=\"margin:0\">\n          Aligned to the start of the trigger.\n        </p>\n      </template>\n    </MPopover>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -19018,7 +19239,7 @@
           "sectionId": "hover",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <MPopover v-model=\"open\" trigger=\"hover\" :show-delay=\"80\" :hide-delay=\"120\">\n    <MButton label=\"Hover me\" severity=\"secondary\" />\n    <template #content>\n      <p style=\"margin:0\">\n        Opens on hover.\n      </p>\n    </template>\n  </MPopover>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MPopover } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst open = ref(false)\n</script>\n\n<template>\n  <MPopover v-model=\"open\" trigger=\"hover\" :show-delay=\"80\" :hide-delay=\"120\">\n    <MButton label=\"Hover me\"/>\n    <template #content>\n      <p style=\"margin:0\">\n        Opens on hover.\n      </p>\n    </template>\n  </MPopover>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -19173,6 +19394,12 @@
           "type": "string",
           "default": "—",
           "description": "自定义填充色。"
+        },
+        {
+          "name": "pt",
+          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "default": "—",
+          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
         }
       ],
       "events": [],
@@ -19262,7 +19489,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | 进度 0–100（determinate）。 |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | 确定 / 不确定模式。 |\n| `showValue` | `boolean` | `true` | 是否显示百分比文案。 |\n| `type` | `'line' \\| 'circle'` | `'line'` | 线形或环形。 |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| …` | — | 语义色。`exception`→danger；`active`→线形条纹动效；`normal`→主色。 |\n| `color` | `string` | — | 自定义填充色。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | 进度 0–100（determinate）。 |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | 确定 / 不确定模式。 |\n| `showValue` | `boolean` | `true` | 是否显示百分比文案。 |\n| `type` | `'line' \\| 'circle'` | `'line'` | 线形或环形。 |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| …` | — | 语义色。`exception`→danger；`active`→线形条纹动效；`normal`→主色。 |\n| `color` | `string` | — | 自定义填充色。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -19275,7 +19502,7 @@
               "body": "无插槽。"
             }
           ],
-          "markdown": "---\ntitle: ProgressBar\ncategory: 03 / DATA\ndescription: 进度条用于展示确定或不确定进度。\n---\n\n# ProgressBar\n\n进度条用于展示任务完成比例，或不确定加载态。\n\n## 引入\n\n```ts\nimport { MProgressBar } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Circle & status\n\n```vue preview src=\"./demos/CircleAndStatus.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | 进度 0–100（determinate）。 |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | 确定 / 不确定模式。 |\n| `showValue` | `boolean` | `true` | 是否显示百分比文案。 |\n| `type` | `'line' \\| 'circle'` | `'line'` | 线形或环形。 |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| …` | — | 语义色。`exception`→danger；`active`→线形条纹动效；`normal`→主色。 |\n| `color` | `string` | — | 自定义填充色。 |\n\n## Events\n\n无自定义事件。\n\n## Slots\n\n无插槽。\n"
+          "markdown": "---\ntitle: ProgressBar\ncategory: 03 / DATA\ndescription: 进度条用于展示确定或不确定进度。\n---\n\n# ProgressBar\n\n进度条用于展示任务完成比例，或不确定加载态。\n\n## 引入\n\n```ts\nimport { MProgressBar } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Circle & status\n\n```vue preview src=\"./demos/CircleAndStatus.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | 进度 0–100（determinate）。 |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | 确定 / 不确定模式。 |\n| `showValue` | `boolean` | `true` | 是否显示百分比文案。 |\n| `type` | `'line' \\| 'circle'` | `'line'` | 线形或环形。 |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| …` | — | 语义色。`exception`→danger；`active`→线形条纹动效；`normal`→主色。 |\n| `color` | `string` | — | 自定义填充色。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n## Events\n\n无自定义事件。\n\n## Slots\n\n无插槽。\n"
         },
         "en-US": {
           "title": "ProgressBar",
@@ -19304,7 +19531,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | Progress 0鈥?00 (determinate). |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | Determinate / indeterminate mode. |\n| `showValue` | `boolean` | `true` | Whether to show the percentage label. |\n| `type` | `'line' \\| 'circle'` | `'line'` | Line or circle. |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| 鈥 | 鈥?| Semantic fill. `exception`鈫抎anger; `active`鈫抣ine stripe; `normal`鈫抪rimary. |\n| `color` | `string` | 鈥?| Custom fill color. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | Progress 0鈥?00 (determinate). |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | Determinate / indeterminate mode. |\n| `showValue` | `boolean` | `true` | Whether to show the percentage label. |\n| `type` | `'line' \\| 'circle'` | `'line'` | Line or circle. |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| 鈥 | 鈥?| Semantic fill. `exception`鈫抎anger; `active`鈫抣ine stripe; `normal`鈫抪rimary. |\n| `color` | `string` | 鈥?| Custom fill color. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -19317,7 +19544,7 @@
               "body": "No slots."
             }
           ],
-          "markdown": "---\ntitle: ProgressBar\ncategory: 03 / DATA\ndescription: Progress bar for determinate or indeterminate progress.\n---\n\n# ProgressBar\n\nShows task completion, or an indeterminate loading state.\n\n## Import\n\n```ts\nimport { MProgressBar } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Circle & status\n\n```vue preview src=\"./demos/CircleAndStatus.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | Progress 0鈥?00 (determinate). |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | Determinate / indeterminate mode. |\n| `showValue` | `boolean` | `true` | Whether to show the percentage label. |\n| `type` | `'line' \\| 'circle'` | `'line'` | Line or circle. |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| 鈥 | 鈥?| Semantic fill. `exception`鈫抎anger; `active`鈫抣ine stripe; `normal`鈫抪rimary. |\n| `color` | `string` | 鈥?| Custom fill color. |\n\n## Events\n\nNo custom events.\n\n## Slots\n\nNo slots.\n"
+          "markdown": "---\ntitle: ProgressBar\ncategory: 03 / DATA\ndescription: Progress bar for determinate or indeterminate progress.\n---\n\n# ProgressBar\n\nShows task completion, or an indeterminate loading state.\n\n## Import\n\n```ts\nimport { MProgressBar } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Circle & status\n\n```vue preview src=\"./demos/CircleAndStatus.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `number` | `0` | Progress 0鈥?00 (determinate). |\n| `mode` | `'determinate' \\| 'indeterminate'` | `'determinate'` | Determinate / indeterminate mode. |\n| `showValue` | `boolean` | `true` | Whether to show the percentage label. |\n| `type` | `'line' \\| 'circle'` | `'line'` | Line or circle. |\n| `status` | `'success' \\| 'info' \\| 'warning' \\| 'danger' \\| 'exception' \\| 'active' \\| 'normal' \\| 鈥 | 鈥?| Semantic fill. `exception`鈫抎anger; `active`鈫抣ine stripe; `normal`鈫抪rimary. |\n| `color` | `string` | 鈥?| Custom fill color. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |\n\n## Events\n\nNo custom events.\n\n## Slots\n\nNo slots.\n"
         }
       }
     },
@@ -20404,7 +20631,7 @@
           "sectionId": "操作区",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"success\" description=\"订单已创建，可在列表中查看详情。\">\n      <template #footer>\n        <MButton label=\"查看订单\" />\n        <MButton label=\"返回首页\" severity=\"secondary\" text />\n      </template>\n    </MResult>\n    <MResult status=\"error\" description=\"请检查网络后重试，或联系管理员。\">\n      <template #footer>\n        <MButton label=\"重试\" />\n      </template>\n    </MResult>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"success\" description=\"订单已创建，可在列表中查看详情。\">\n      <template #footer>\n        <MButton label=\"查看订单\" />\n        <MButton label=\"返回首页\" type=\"text\"/>\n      </template>\n    </MResult>\n    <MResult status=\"error\" description=\"请检查网络后重试，或联系管理员。\">\n      <template #footer>\n        <MButton label=\"重试\" />\n      </template>\n    </MResult>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -20413,7 +20640,7 @@
           "sectionId": "http-类状态",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"403\" description=\"你没有访问该资源的权限。\">\n      <template #footer>\n        <MButton label=\"返回\" severity=\"secondary\" />\n      </template>\n    </MResult>\n    <MResult status=\"404\" description=\"页面不存在或已被移除。\" />\n    <MResult status=\"500\" description=\"服务暂时不可用，请稍后再试。\" />\n    <MResult :status=\"('418' as any)\" description=\"服务器拒绝泡茶请求。\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"403\" description=\"你没有访问该资源的权限。\">\n      <template #footer>\n        <MButton label=\"返回\"/>\n      </template>\n    </MResult>\n    <MResult status=\"404\" description=\"页面不存在或已被移除。\" />\n    <MResult status=\"500\" description=\"服务暂时不可用，请稍后再试。\" />\n    <MResult :status=\"('418' as any)\" description=\"服务器拒绝泡茶请求。\" />\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -20422,7 +20649,7 @@
           "sectionId": "尺寸",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-6\" style=\"grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\">\n    <MResult\n      size=\"small\"\n      status=\"success\"\n      title=\"保存成功\"\n    >\n      <template #footer>\n        <MButton\n          label=\"知道了\"\n          size=\"small\"\n          severity=\"secondary\"\n        />\n      </template>\n    </MResult>\n    <MResult\n      size=\"small\"\n      status=\"error\"\n      title=\"上传失败\"\n    >\n      <template #footer>\n        <MButton\n          label=\"重试\"\n          size=\"small\"\n        />\n      </template>\n    </MResult>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-6\" style=\"grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\">\n    <MResult\n      size=\"small\"\n      status=\"success\"\n      title=\"保存成功\"\n    >\n      <template #footer>\n        <MButton label=\"知道了\" size=\"small\"/>\n      </template>\n    </MResult>\n    <MResult\n      size=\"small\"\n      status=\"error\"\n      title=\"上传失败\"\n    >\n      <template #footer>\n        <MButton\n          label=\"重试\"\n          size=\"small\"\n        />\n      </template>\n    </MResult>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -20449,7 +20676,7 @@
           "sectionId": "actions",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"success\" description=\"Your order was created. You can review it in the list.\">\n      <template #footer>\n        <MButton label=\"View order\" />\n        <MButton label=\"Back home\" severity=\"secondary\" text />\n      </template>\n    </MResult>\n    <MResult status=\"error\" description=\"Check your network and try again, or contact an admin.\">\n      <template #footer>\n        <MButton label=\"Retry\" />\n      </template>\n    </MResult>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"success\" description=\"Your order was created. You can review it in the list.\">\n      <template #footer>\n        <MButton label=\"View order\" />\n        <MButton label=\"Back home\" type=\"text\"/>\n      </template>\n    </MResult>\n    <MResult status=\"error\" description=\"Check your network and try again, or contact an admin.\">\n      <template #footer>\n        <MButton label=\"Retry\" />\n      </template>\n    </MResult>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -20458,7 +20685,7 @@
           "sectionId": "http-statuses",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"403\" description=\"You do not have permission to access this resource.\">\n      <template #footer>\n        <MButton label=\"Go back\" severity=\"secondary\" />\n      </template>\n    </MResult>\n    <MResult status=\"404\" description=\"This page does not exist or was removed.\" />\n    <MResult status=\"500\" description=\"The service is temporarily unavailable. Try again later.\" />\n    <MResult :status=\"('418' as any)\" description=\"The server refuses to brew coffee.\" />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-8\">\n    <MResult status=\"403\" description=\"You do not have permission to access this resource.\">\n      <template #footer>\n        <MButton label=\"Go back\"/>\n      </template>\n    </MResult>\n    <MResult status=\"404\" description=\"This page does not exist or was removed.\" />\n    <MResult status=\"500\" description=\"The service is temporarily unavailable. Try again later.\" />\n    <MResult :status=\"('418' as any)\" description=\"The server refuses to brew coffee.\" />\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -20467,7 +20694,7 @@
           "sectionId": "size",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-6\" style=\"grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\">\n    <MResult\n      size=\"small\"\n      status=\"success\"\n      title=\"Saved\"\n    >\n      <template #footer>\n        <MButton\n          label=\"OK\"\n          size=\"small\"\n          severity=\"secondary\"\n        />\n      </template>\n    </MResult>\n    <MResult\n      size=\"small\"\n      status=\"error\"\n      title=\"Upload failed\"\n    >\n      <template #footer>\n        <MButton\n          label=\"Retry\"\n          size=\"small\"\n        />\n      </template>\n    </MResult>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MResult } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-6\" style=\"grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\">\n    <MResult\n      size=\"small\"\n      status=\"success\"\n      title=\"Saved\"\n    >\n      <template #footer>\n        <MButton label=\"OK\" size=\"small\"/>\n      </template>\n    </MResult>\n    <MResult\n      size=\"small\"\n      status=\"error\"\n      title=\"Upload failed\"\n    >\n      <template #footer>\n        <MButton\n          label=\"Retry\"\n          size=\"small\"\n        />\n      </template>\n    </MResult>\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -20815,7 +21042,7 @@
           "sectionId": "max-height",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst count = ref(3)\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;gap:0.5rem\">\n      <MButton label=\"Add\" size=\"small\" @click=\"count++\" />\n      <MButton label=\"Remove\" severity=\"secondary\" size=\"small\" @click=\"count = Math.max(0, count - 1)\" />\n    </div>\n    <MScrollbar max-height=\"220px\" always class=\"w-full\">\n      <p\n        v-for=\"item in count\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-info) 12%, transparent);\n          color:var(--m-color-info);\n        \"\n      >\n        Item {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst count = ref(3)\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;gap:0.5rem\">\n      <MButton label=\"Add\" size=\"small\" @click=\"count++\" />\n      <MButton label=\"Remove\" size=\"small\" @click=\"count = Math.max(0, count - 1)\"/>\n    </div>\n    <MScrollbar max-height=\"220px\" always class=\"w-full\">\n      <p\n        v-for=\"item in count\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-info) 12%, transparent);\n          color:var(--m-color-info);\n        \"\n      >\n        Item {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -20842,7 +21069,7 @@
           "sectionId": "manual-scroll",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { ScrollbarInstance } from 'morya-ui'\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst scrollbarRef = ref<ScrollbarInstance>()\nconst scrollTop = ref(0)\n\nfunction jump(top: number) {\n  scrollbarRef.value?.setScrollTop(top)\n}\n\nfunction onScroll(payload: { scrollTop: number }) {\n  scrollTop.value = Math.round(payload.scrollTop)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;flex-wrap:wrap;gap:0.5rem;align-items:center\">\n      <MButton label=\"Top\" size=\"small\" @click=\"jump(0)\" />\n      <MButton label=\"Mid\" size=\"small\" severity=\"secondary\" @click=\"jump(200)\" />\n      <MButton label=\"Bottom\" size=\"small\" severity=\"secondary\" @click=\"jump(9999)\" />\n      <span style=\"color:var(--m-color-text-muted);font-size:0.875rem\">scrollTop: {{ scrollTop }}</span>\n    </div>\n    <MScrollbar ref=\"scrollbarRef\" height=\"200px\" style=\"width: 200px\" always @scroll=\"onScroll\">\n      <p\n        v-for=\"item in 24\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-success) 12%, transparent);\n          color:var(--m-color-success);\n        \"\n      >\n        {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { ScrollbarInstance } from 'morya-ui'\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst scrollbarRef = ref<ScrollbarInstance>()\nconst scrollTop = ref(0)\n\nfunction jump(top: number) {\n  scrollbarRef.value?.setScrollTop(top)\n}\n\nfunction onScroll(payload: { scrollTop: number }) {\n  scrollTop.value = Math.round(payload.scrollTop)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;flex-wrap:wrap;gap:0.5rem;align-items:center\">\n      <MButton label=\"Top\" size=\"small\" @click=\"jump(0)\" />\n      <MButton label=\"Mid\" size=\"small\" @click=\"jump(200)\"/>\n      <MButton label=\"Bottom\" size=\"small\" @click=\"jump(9999)\"/>\n      <span style=\"color:var(--m-color-text-muted);font-size:0.875rem\">scrollTop: {{ scrollTop }}</span>\n    </div>\n    <MScrollbar ref=\"scrollbarRef\" height=\"200px\" style=\"width: 200px\" always @scroll=\"onScroll\">\n      <p\n        v-for=\"item in 24\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-success) 12%, transparent);\n          color:var(--m-color-success);\n        \"\n      >\n        {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -20896,7 +21123,7 @@
           "sectionId": "max-height",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst count = ref(3)\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;gap:0.5rem\">\n      <MButton label=\"Add\" size=\"small\" @click=\"count++\" />\n      <MButton label=\"Remove\" severity=\"secondary\" size=\"small\" @click=\"count = Math.max(0, count - 1)\" />\n    </div>\n    <MScrollbar max-height=\"220px\" always class=\"w-full\">\n      <p\n        v-for=\"item in count\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-info) 12%, transparent);\n          color:var(--m-color-info);\n        \"\n      >\n        Item {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst count = ref(3)\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;gap:0.5rem\">\n      <MButton label=\"Add\" size=\"small\" @click=\"count++\" />\n      <MButton label=\"Remove\" size=\"small\" @click=\"count = Math.max(0, count - 1)\"/>\n    </div>\n    <MScrollbar max-height=\"220px\" always class=\"w-full\">\n      <p\n        v-for=\"item in count\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-info) 12%, transparent);\n          color:var(--m-color-info);\n        \"\n      >\n        Item {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -20923,7 +21150,7 @@
           "sectionId": "manual-scroll",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { ScrollbarInstance } from 'morya-ui'\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst scrollbarRef = ref<ScrollbarInstance>()\nconst scrollTop = ref(0)\n\nfunction jump(top: number) {\n  scrollbarRef.value?.setScrollTop(top)\n}\n\nfunction onScroll(payload: { scrollTop: number }) {\n  scrollTop.value = Math.round(payload.scrollTop)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;flex-wrap:wrap;gap:0.5rem;align-items:center\">\n      <MButton label=\"Top\" size=\"small\" @click=\"jump(0)\" />\n      <MButton label=\"Mid\" size=\"small\" severity=\"secondary\" @click=\"jump(200)\" />\n      <MButton label=\"Bottom\" size=\"small\" severity=\"secondary\" @click=\"jump(9999)\" />\n      <span style=\"color:var(--m-color-text-muted);font-size:0.875rem\">scrollTop: {{ scrollTop }}</span>\n    </div>\n    <MScrollbar ref=\"scrollbarRef\" height=\"200px\" always style=\"width: 200px\" @scroll=\"onScroll\">\n      <p\n        v-for=\"item in 24\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-success) 12%, transparent);\n          color:var(--m-color-success);\n        \"\n      >\n        {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { ScrollbarInstance } from 'morya-ui'\nimport { MButton, MScrollbar } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst scrollbarRef = ref<ScrollbarInstance>()\nconst scrollTop = ref(0)\n\nfunction jump(top: number) {\n  scrollbarRef.value?.setScrollTop(top)\n}\n\nfunction onScroll(payload: { scrollTop: number }) {\n  scrollTop.value = Math.round(payload.scrollTop)\n}\n</script>\n\n<template>\n  <div class=\"grid gap-3\">\n    <div style=\"display:flex;flex-wrap:wrap;gap:0.5rem;align-items:center\">\n      <MButton label=\"Top\" size=\"small\" @click=\"jump(0)\" />\n      <MButton label=\"Mid\" size=\"small\" @click=\"jump(200)\"/>\n      <MButton label=\"Bottom\" size=\"small\" @click=\"jump(9999)\"/>\n      <span style=\"color:var(--m-color-text-muted);font-size:0.875rem\">scrollTop: {{ scrollTop }}</span>\n    </div>\n    <MScrollbar ref=\"scrollbarRef\" height=\"200px\" always style=\"width: 200px\" @scroll=\"onScroll\">\n      <p\n        v-for=\"item in 24\"\n        :key=\"item\"\n        style=\"\n          display:flex;align-items:center;justify-content:center;\n          height:48px;margin:8px;border-radius:6px;\n          background:color-mix(in srgb, var(--m-color-success) 12%, transparent);\n          color:var(--m-color-success);\n        \"\n      >\n        {{ item }}\n      </p>\n    </MScrollbar>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -21902,7 +22129,7 @@
           "sectionId": "自定义选项渲染",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSelect } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst value = ref<string | number | undefined>()\nconst options = [\n  { label: 'Design', value: 'design' },\n  { label: 'Development', value: 'dev' },\n  { label: 'Marketing', value: 'mkt' },\n]\n</script>\n\n<template>\n  <MSelect v-model=\"value\" label=\"Team\" :options=\"options\" placeholder=\"Choose a team\">\n    <template #header>\n      <span style=\"color: var(--m-color-text-muted); font-size: var(--m-font-size-xs)\">\n        Teams you belong to\n      </span>\n    </template>\n    <template #footer>\n      <MButton label=\"Manage teams\" variant=\"text\" size=\"sm\" />\n    </template>\n  </MSelect>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSelect } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst value = ref<string | number | undefined>()\nconst options = [\n  { label: 'Design', value: 'design' },\n  { label: 'Development', value: 'dev' },\n  { label: 'Marketing', value: 'mkt' },\n]\n</script>\n\n<template>\n  <MSelect v-model=\"value\" label=\"Team\" :options=\"options\" placeholder=\"Choose a team\">\n    <template #header>\n      <span style=\"color: var(--m-color-text-muted); font-size: var(--m-font-size-xs)\">\n        Teams you belong to\n      </span>\n    </template>\n    <template #footer>\n      <MButton label=\"Manage teams\" variant=\"text\" size=\"sm\"/>\n    </template>\n  </MSelect>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -22064,7 +22291,7 @@
           "sectionId": "custom-option-rendering",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSelect } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst value = ref<string | number | undefined>()\nconst options = [\n  { label: 'Design', value: 'design' },\n  { label: 'Development', value: 'dev' },\n  { label: 'Marketing', value: 'mkt' },\n]\n</script>\n\n<template>\n  <MSelect v-model=\"value\" label=\"Team\" :options=\"options\" placeholder=\"Choose a team\">\n    <template #header>\n      <span style=\"color: var(--m-color-text-muted); font-size: var(--m-font-size-xs)\">\n        Teams you belong to\n      </span>\n    </template>\n    <template #footer>\n      <MButton label=\"Manage teams\" variant=\"text\" size=\"sm\" />\n    </template>\n  </MSelect>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSelect } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst value = ref<string | number | undefined>()\nconst options = [\n  { label: 'Design', value: 'design' },\n  { label: 'Development', value: 'dev' },\n  { label: 'Marketing', value: 'mkt' },\n]\n</script>\n\n<template>\n  <MSelect v-model=\"value\" label=\"Team\" :options=\"options\" placeholder=\"Choose a team\">\n    <template #header>\n      <span style=\"color: var(--m-color-text-muted); font-size: var(--m-font-size-xs)\">\n        Teams you belong to\n      </span>\n    </template>\n    <template #footer>\n      <MButton label=\"Manage teams\" variant=\"text\" size=\"sm\"/>\n    </template>\n  </MSelect>\n</template>",
           "locale": "en-US"
         },
         {
@@ -23366,7 +23593,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace>\n    <MButton label=\"保存\" size=\"small\" />\n    <MButton label=\"取消\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"重置\" size=\"small\" severity=\"secondary\" />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace>\n    <MButton label=\"保存\" size=\"small\" />\n    <MButton label=\"取消\" size=\"small\"/>\n    <MButton label=\"重置\" size=\"small\"/>\n  </MSpace>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -23384,7 +23611,7 @@
           "sectionId": "size",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <MSpace size=\"small\">\n      <MButton label=\"small\" size=\"small\" />\n      <MButton label=\"small\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace size=\"medium\">\n      <MButton label=\"medium\" size=\"small\" />\n      <MButton label=\"medium\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace size=\"large\">\n      <MButton label=\"large\" size=\"small\" />\n      <MButton label=\"large\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace :size=\"20\">\n      <MButton label=\"20px\" size=\"small\" />\n      <MButton label=\"20px\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <MSpace size=\"small\">\n      <MButton label=\"small\" size=\"small\" />\n      <MButton label=\"small\" size=\"small\"/>\n    </MSpace>\n    <MSpace size=\"medium\">\n      <MButton label=\"medium\" size=\"small\" />\n      <MButton label=\"medium\" size=\"small\"/>\n    </MSpace>\n    <MSpace size=\"large\">\n      <MButton label=\"large\" size=\"small\" />\n      <MButton label=\"large\" size=\"small\"/>\n    </MSpace>\n    <MSpace :size=\"20\">\n      <MButton label=\"20px\" size=\"small\" />\n      <MButton label=\"20px\" size=\"small\"/>\n    </MSpace>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -23411,7 +23638,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace>\n    <MButton label=\"Save\" size=\"small\" />\n    <MButton label=\"Cancel\" size=\"small\" severity=\"secondary\" />\n    <MButton label=\"Reset\" size=\"small\" severity=\"secondary\" />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <MSpace>\n    <MButton label=\"Save\" size=\"small\" />\n    <MButton label=\"Cancel\" size=\"small\"/>\n    <MButton label=\"Reset\" size=\"small\"/>\n  </MSpace>\n</template>",
           "locale": "en-US"
         },
         {
@@ -23429,7 +23656,7 @@
           "sectionId": "size",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <MSpace size=\"small\">\n      <MButton label=\"small\" size=\"small\" />\n      <MButton label=\"small\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace size=\"medium\">\n      <MButton label=\"medium\" size=\"small\" />\n      <MButton label=\"medium\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace size=\"large\">\n      <MButton label=\"large\" size=\"small\" />\n      <MButton label=\"large\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n    <MSpace :size=\"20\">\n      <MButton label=\"20px\" size=\"small\" />\n      <MButton label=\"20px\" size=\"small\" severity=\"secondary\" />\n    </MSpace>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MSpace } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"grid gap-4\">\n    <MSpace size=\"small\">\n      <MButton label=\"small\" size=\"small\" />\n      <MButton label=\"small\" size=\"small\"/>\n    </MSpace>\n    <MSpace size=\"medium\">\n      <MButton label=\"medium\" size=\"small\" />\n      <MButton label=\"medium\" size=\"small\"/>\n    </MSpace>\n    <MSpace size=\"large\">\n      <MButton label=\"large\" size=\"small\" />\n      <MButton label=\"large\" size=\"small\"/>\n    </MSpace>\n    <MSpace :size=\"20\">\n      <MButton label=\"20px\" size=\"small\" />\n      <MButton label=\"20px\" size=\"small\"/>\n    </MSpace>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -23853,13 +24080,13 @@
           "description": "菜单项。"
         },
         {
-          "name": "severity",
+          "name": "color",
           "type": "—",
           "default": "—",
           "description": "视觉变体。"
         },
         {
-          "name": "outlined",
+          "name": "variant",
           "type": "—",
           "default": "—",
           "description": "视觉变体。"
@@ -23981,7 +24208,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 主按钮文案。 |\n| `icon` | `string` | — | 可选图标字符。 |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | 菜单项。 |\n| `severity` / `outlined` / `size` | — | — | 视觉变体。 |\n| `disabled` | `boolean` | `false` | 禁用。 |\n| `teleport` | `boolean` | `true` | 是否将菜单 Teleport 出去。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 表示就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 主按钮文案。 |\n| `icon` | `string` | — | 可选图标字符。 |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | 菜单项。 |\n| `color` / `variant` / `size` | — | — | 视觉变体。 |\n| `disabled` | `boolean` | `false` | 禁用。 |\n| `teleport` | `boolean` | `true` | 是否将菜单 Teleport 出去。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 表示就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -23994,7 +24221,7 @@
               "body": "| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 主按钮内容。 |"
             }
           ],
-          "markdown": "---\ntitle: SplitButton\ncategory: 01 / BASIC\ndescription: 主操作按钮附带下拉菜单项。\n---\n\n# SplitButton\n\n左侧主按钮触发 `click`，右侧展开菜单项触发 `command`。\n\n## 引入\n\n```ts\nimport { MSplitButton } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 主按钮文案。 |\n| `icon` | `string` | — | 可选图标字符。 |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | 菜单项。 |\n| `severity` / `outlined` / `size` | — | — | 视觉变体。 |\n| `disabled` | `boolean` | `false` | 禁用。 |\n| `teleport` | `boolean` | `true` | 是否将菜单 Teleport 出去。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 表示就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `click` | `MouseEvent` | 主按钮点击。 |\n| `command` | `item` | 菜单项激活。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 主按钮内容。 |\n"
+          "markdown": "---\ntitle: SplitButton\ncategory: 01 / BASIC\ndescription: 主操作按钮附带下拉菜单项。\n---\n\n# SplitButton\n\n左侧主按钮触发 `click`，右侧展开菜单项触发 `command`。\n\n## 引入\n\n```ts\nimport { MSplitButton } from 'morya-ui'\n```\n\n## 基础用法\n\n```vue preview src=\"./demos/Basic.zh.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `label` | `string` | — | 主按钮文案。 |\n| `icon` | `string` | — | 可选图标字符。 |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | 菜单项。 |\n| `color` / `variant` / `size` | — | — | 视觉变体。 |\n| `disabled` | `boolean` | `false` | 禁用。 |\n| `teleport` | `boolean` | `true` | 是否将菜单 Teleport 出去。 |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | 挂载目标；`'self'` 表示就地渲染。 |\n| `transition` | `string \\| false` | `'scale-fade'` | 进出场动效预设；`false` / `'none'` 关闭。见[动效](/docs/motion)。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `click` | `MouseEvent` | 主按钮点击。 |\n| `command` | `item` | 菜单项激活。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 主按钮内容。 |\n"
         },
         "en-US": {
           "title": "SplitButton",
@@ -24018,7 +24245,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | — | Primary button label. |\n| `icon` | `string` | — | Optional icon character. |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | Menu items. |\n| `severity` / `outlined` / `size` | — | — | Visual variants. |\n| `disabled` | `boolean` | `false` | Disabled. |\n| `teleport` | `boolean` | `true` | Whether to Teleport the menu. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` keeps it in place. |\n| `transition` | `string \\| false` | `'scale-fade'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | — | Primary button label. |\n| `icon` | `string` | — | Optional icon character. |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | Menu items. |\n| `color` / `variant` / `size` | — | — | Visual variants. |\n| `disabled` | `boolean` | `false` | Disabled. |\n| `teleport` | `boolean` | `true` | Whether to Teleport the menu. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` keeps it in place. |\n| `transition` | `string \\| false` | `'scale-fade'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -24031,7 +24258,7 @@
               "body": "| Slot | Description |\n| --- | --- |\n| `default` | Main button content. |"
             }
           ],
-          "markdown": "---\ntitle: SplitButton\ncategory: 01 / BASIC\ndescription: A primary action button with extra dropdown items.\n---\n\n# SplitButton\n\nThe left primary button emits `click`; items in the right-side menu emit `command`.\n\n## Import\n\n```ts\nimport { MSplitButton } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | — | Primary button label. |\n| `icon` | `string` | — | Optional icon character. |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | Menu items. |\n| `severity` / `outlined` / `size` | — | — | Visual variants. |\n| `disabled` | `boolean` | `false` | Disabled. |\n| `teleport` | `boolean` | `true` | Whether to Teleport the menu. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` keeps it in place. |\n| `transition` | `string \\| false` | `'scale-fade'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `click` | `MouseEvent` | Primary button click. |\n| `command` | `item` | Menu item activated. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Main button content. |\n"
+          "markdown": "---\ntitle: SplitButton\ncategory: 01 / BASIC\ndescription: A primary action button with extra dropdown items.\n---\n\n# SplitButton\n\nThe left primary button emits `click`; items in the right-side menu emit `command`.\n\n## Import\n\n```ts\nimport { MSplitButton } from 'morya-ui'\n```\n\n## Basic\n\n```vue preview src=\"./demos/Basic.en.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `label` | `string` | — | Primary button label. |\n| `icon` | `string` | — | Optional icon character. |\n| `model` | `{ label, command?, disabled? }[]` | `[]` | Menu items. |\n| `color` / `variant` / `size` | — | — | Visual variants. |\n| `disabled` | `boolean` | `false` | Disabled. |\n| `teleport` | `boolean` | `true` | Whether to Teleport the menu. |\n| `appendTo` | `string \\| HTMLElement \\| 'self'` | `'body'` | Mount target; `'self'` keeps it in place. |\n| `transition` | `string \\| false` | `'scale-fade'` | Enter/exit motion preset; `false` / `'none'` disables. See [Motion](/docs/motion). |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | Pass-through; see [Styling & attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Prop | Description |\n| --- | --- | --- |\n| `click` | `MouseEvent` | Primary button click. |\n| `command` | `item` | Menu item activated. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Main button content. |\n"
         }
       }
     },
@@ -26926,7 +27153,7 @@
           "sectionId": "card-closable-extra",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MTabs } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = ref([\n  { label: '设计', value: 'a' },\n  { label: '数据', value: 'b' },\n  { label: '发布', value: 'c' },\n])\n\nfunction onClose(value: string) {\n  tabs.value = tabs.value.filter((tab) => tab.value !== value)\n}\n\nfunction onAdd() {\n  const value = `tab-${tabs.value.length + 1}`\n  tabs.value = [...tabs.value, { label: `Tab ${tabs.value.length + 1}`, value }]\n  active.value = value\n}\n</script>\n\n<template>\n  <MTabs\n    v-model=\"active\"\n    type=\"card\"\n    closable\n    addable\n    :tabs=\"tabs\"\n    @close=\"onClose\"\n    @add=\"onAdd\"\n  >\n    <template #extra>\n      <MButton label=\"操作\" size=\"small\" severity=\"secondary\" />\n    </template>\n    <template #default=\"{ activeValue }\">\n      <p style=\"margin:0\">\n        {{ activeValue }}\n      </p>\n    </template>\n  </MTabs>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MTabs } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = ref([\n  { label: '设计', value: 'a' },\n  { label: '数据', value: 'b' },\n  { label: '发布', value: 'c' },\n])\n\nfunction onClose(value: string) {\n  tabs.value = tabs.value.filter((tab) => tab.value !== value)\n}\n\nfunction onAdd() {\n  const value = `tab-${tabs.value.length + 1}`\n  tabs.value = [...tabs.value, { label: `Tab ${tabs.value.length + 1}`, value }]\n  active.value = value\n}\n</script>\n\n<template>\n  <MTabs\n    v-model=\"active\"\n    type=\"card\"\n    closable\n    addable\n    :tabs=\"tabs\"\n    @close=\"onClose\"\n    @add=\"onAdd\"\n  >\n    <template #extra>\n      <MButton label=\"操作\" size=\"small\"/>\n    </template>\n    <template #default=\"{ activeValue }\">\n      <p style=\"margin:0\">\n        {{ activeValue }}\n      </p>\n    </template>\n  </MTabs>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -26962,7 +27189,7 @@
           "sectionId": "card-closable-extra",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MTabs } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = ref([\n  { label: 'Design', value: 'a' },\n  { label: 'Data', value: 'b' },\n  { label: 'Ship', value: 'c' },\n])\n\nfunction onClose(value: string) {\n  tabs.value = tabs.value.filter((tab) => tab.value !== value)\n}\n\nfunction onAdd() {\n  const value = `tab-${tabs.value.length + 1}`\n  tabs.value = [...tabs.value, { label: `Tab ${tabs.value.length + 1}`, value }]\n  active.value = value\n}\n</script>\n\n<template>\n  <MTabs\n    v-model=\"active\"\n    type=\"card\"\n    closable\n    addable\n    :tabs=\"tabs\"\n    @close=\"onClose\"\n    @add=\"onAdd\"\n  >\n    <template #extra>\n      <MButton label=\"Action\" size=\"small\" severity=\"secondary\" />\n    </template>\n    <template #default=\"{ activeValue }\">\n      <p style=\"margin:0\">\n        {{ activeValue }}\n      </p>\n    </template>\n  </MTabs>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MTabs } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst active = ref('a')\nconst tabs = ref([\n  { label: 'Design', value: 'a' },\n  { label: 'Data', value: 'b' },\n  { label: 'Ship', value: 'c' },\n])\n\nfunction onClose(value: string) {\n  tabs.value = tabs.value.filter((tab) => tab.value !== value)\n}\n\nfunction onAdd() {\n  const value = `tab-${tabs.value.length + 1}`\n  tabs.value = [...tabs.value, { label: `Tab ${tabs.value.length + 1}`, value }]\n  active.value = value\n}\n</script>\n\n<template>\n  <MTabs\n    v-model=\"active\"\n    type=\"card\"\n    closable\n    addable\n    :tabs=\"tabs\"\n    @close=\"onClose\"\n    @add=\"onAdd\"\n  >\n    <template #extra>\n      <MButton label=\"Action\" size=\"small\"/>\n    </template>\n    <template #default=\"{ activeValue }\">\n      <p style=\"margin:0\">\n        {{ activeValue }}\n      </p>\n    </template>\n  </MTabs>\n</template>",
           "locale": "en-US"
         },
         {
@@ -27146,6 +27373,12 @@
           "type": "boolean",
           "default": "false",
           "description": "选中态；配合 `v-model:checked`。"
+        },
+        {
+          "name": "pt",
+          "type": "[RootPassThrough](/docs/types#RootPassThrough) `{ root? }",
+          "default": "—",
+          "description": "DOM 透传，见 [样式与 attrs](/docs/attrs)."
         }
       ],
       "events": [
@@ -27348,7 +27581,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string` | — | 标签文案。存在默认插槽内容时以插槽为准。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `rounded` | `boolean` | `false` | 全圆角。 |\n| `icon` | [IconName](/docs/types#IconName) | — | `MIcon` 图标名称。 |\n| `closable` | `boolean` | `false` | 显示关闭按钮（`checkable` 时忽略）。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `bordered` | `boolean` | `false` | 描边。 |\n| `color` | `string` | — | 自定义颜色。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `checkable` | `boolean` | `false` | 可切换选中。 |\n| `checked` | `boolean` | `false` | 选中态；配合 `v-model:checked`。 |"
+              "body": "| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string` | — | 标签文案。存在默认插槽内容时以插槽为准。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `rounded` | `boolean` | `false` | 全圆角。 |\n| `icon` | [IconName](/docs/types#IconName) | — | `MIcon` 图标名称。 |\n| `closable` | `boolean` | `false` | 显示关闭按钮（`checkable` 时忽略）。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `bordered` | `boolean` | `false` | 描边。 |\n| `color` | `string` | — | 自定义颜色。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `checkable` | `boolean` | `false` | 可切换选中。 |\n| `checked` | `boolean` | `false` | 选中态；配合 `v-model:checked`。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -27361,7 +27594,7 @@
               "body": "| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容，优先于 `value`。 |"
             }
           ],
-          "markdown": "---\ntitle: Tag\ncategory: 01 / BASIC\ndescription: 标签用于展示状态或分类。\n---\n\n# Tag\n\n标签用于展示状态或分类。\n\n## 引入\n\n```ts\nimport { MTag } from 'morya-ui'\n```\n\n## 基础用法\n\n通过 `value` 或默认插槽展示文案。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\n使用 `severity` 定义语义色；省略时为 primary。兼容旧值 `warning`（映射为 `warn`）。\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Icons\n\n`icon` 传入 `MIcon` 的图标名称。\n\n```vue preview src=\"./demos/Icons.vue\"\n```\n\n## Bordered\n\n`bordered` 使用色调描边。默认无描边、填充色调背景。\n\n```vue preview src=\"./demos/Bordered.vue\"\n```\n\n## Closable\n\n```vue preview src=\"./demos/Closable.vue\"\n```\n\n## Checkable\n\n`checkable` + `v-model:checked` 可切换选中。与 `closable` 同时设置时关闭按钮不显示。\n\n```vue preview src=\"./demos/Checkable.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string` | — | 标签文案。存在默认插槽内容时以插槽为准。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `rounded` | `boolean` | `false` | 全圆角。 |\n| `icon` | [IconName](/docs/types#IconName) | — | `MIcon` 图标名称。 |\n| `closable` | `boolean` | `false` | 显示关闭按钮（`checkable` 时忽略）。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `bordered` | `boolean` | `false` | 描边。 |\n| `color` | `string` | — | 自定义颜色。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `checkable` | `boolean` | `false` | 可切换选中。 |\n| `checked` | `boolean` | `false` | 选中态；配合 `v-model:checked`。 |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `close` | `MouseEvent` | 点击关闭。 |\n| `update:checked` | `boolean` | 选中态变更（`v-model:checked`）。 |\n| `change` | `boolean` | 选中态变更。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容，优先于 `value`。 |\n"
+          "markdown": "---\ntitle: Tag\ncategory: 01 / BASIC\ndescription: 标签用于展示状态或分类。\n---\n\n# Tag\n\n标签用于展示状态或分类。\n\n## 引入\n\n```ts\nimport { MTag } from 'morya-ui'\n```\n\n## 基础用法\n\n通过 `value` 或默认插槽展示文案。\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\n使用 `severity` 定义语义色；省略时为 primary。兼容旧值 `warning`（映射为 `warn`）。\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Icons\n\n`icon` 传入 `MIcon` 的图标名称。\n\n```vue preview src=\"./demos/Icons.vue\"\n```\n\n## Bordered\n\n`bordered` 使用色调描边。默认无描边、填充色调背景。\n\n```vue preview src=\"./demos/Bordered.vue\"\n```\n\n## Closable\n\n```vue preview src=\"./demos/Closable.vue\"\n```\n\n## Checkable\n\n`checkable` + `v-model:checked` 可切换选中。与 `closable` 同时设置时关闭按钮不显示。\n\n```vue preview src=\"./demos/Checkable.vue\"\n```\n\n## Props\n\n| 参数 | 类型 | 默认值 | 说明 |\n| --- | --- | --- | --- |\n| `value` | `string` | — | 标签文案。存在默认插槽内容时以插槽为准。 |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | 语义色。`warning` 为兼容别名，映射为 `warn`。 |\n| `rounded` | `boolean` | `false` | 全圆角。 |\n| `icon` | [IconName](/docs/types#IconName) | — | `MIcon` 图标名称。 |\n| `closable` | `boolean` | `false` | 显示关闭按钮（`checkable` 时忽略）。 |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | — | 尺寸。 |\n| `bordered` | `boolean` | `false` | 描边。 |\n| `color` | `string` | — | 自定义颜色。 |\n| `disabled` | `boolean` | `false` | 禁用交互。 |\n| `checkable` | `boolean` | `false` | 可切换选中。 |\n| `checked` | `boolean` | `false` | 选中态；配合 `v-model:checked`。 |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM 透传，见 [样式与 attrs](/docs/attrs). |\n\n\n## Events\n\n| 事件名 | 参数 | 说明 |\n| --- | --- | --- |\n| `close` | `MouseEvent` | 点击关闭。 |\n| `update:checked` | `boolean` | 选中态变更（`v-model:checked`）。 |\n| `change` | `boolean` | 选中态变更。 |\n\n## Slots\n\n| 插槽名 | 说明 |\n| --- | --- |\n| `default` | 标签内容，优先于 `value`。 |\n"
         },
         "en-US": {
           "title": "Tag",
@@ -27410,7 +27643,7 @@
             {
               "id": "props",
               "title": "Props",
-              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string` | 鈥?| Tag text. The default slot takes precedence when present. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `rounded` | `boolean` | `false` | Fully rounded. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| `MIcon` icon name. |\n| `closable` | `boolean` | `false` | Show a close control (ignored when `checkable`). |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `bordered` | `boolean` | `false` | Draw a border. |\n| `color` | `string` | 鈥?| Custom color. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `checkable` | `boolean` | `false` | Toggleable selection. |\n| `checked` | `boolean` | `false` | Checked state; use with `v-model:checked`. |"
+              "body": "| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string` | 鈥?| Tag text. The default slot takes precedence when present. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `rounded` | `boolean` | `false` | Fully rounded. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| `MIcon` icon name. |\n| `closable` | `boolean` | `false` | Show a close control (ignored when `checkable`). |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `bordered` | `boolean` | `false` | Draw a border. |\n| `color` | `string` | 鈥?| Custom color. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `checkable` | `boolean` | `false` | Toggleable selection. |\n| `checked` | `boolean` | `false` | Checked state; use with `v-model:checked`. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |"
             },
             {
               "id": "events",
@@ -27423,7 +27656,7 @@
               "body": "| Slot | Description |\n| --- | --- |\n| `default` | Tag content; takes precedence over `value`. |"
             }
           ],
-          "markdown": "---\ntitle: Tag\ncategory: 01 / BASIC\ndescription: Tag for status or category.\n---\n\n# Tag\n\nTags display status or category.\n\n## Import\n\n```ts\nimport { MTag } from 'morya-ui'\n```\n\n## Basic\n\nShow text via `value` or the default slot.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\nUse `severity` for semantic color; defaults to primary when omitted. The legacy value `warning` is mapped to `warn`.\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Icons\n\nPass a `MIcon` icon name to `icon`.\n\n```vue preview src=\"./demos/Icons.vue\"\n```\n\n## Bordered\n\n`bordered` draws a tone-colored outline. Default is borderless with a filled tone background.\n\n```vue preview src=\"./demos/Bordered.vue\"\n```\n\n## Closable\n\n```vue preview src=\"./demos/Closable.vue\"\n```\n\n## Checkable\n\n`checkable` + `v-model:checked` toggles selection. When combined with `closable`, the close control is hidden.\n\n```vue preview src=\"./demos/Checkable.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string` | 鈥?| Tag text. The default slot takes precedence when present. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `rounded` | `boolean` | `false` | Fully rounded. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| `MIcon` icon name. |\n| `closable` | `boolean` | `false` | Show a close control (ignored when `checkable`). |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `bordered` | `boolean` | `false` | Draw a border. |\n| `color` | `string` | 鈥?| Custom color. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `checkable` | `boolean` | `false` | Toggleable selection. |\n| `checked` | `boolean` | `false` | Checked state; use with `v-model:checked`. |\n\n\n## Events\n\n| Event | Payload | Description |\n| --- | --- | --- |\n| `close` | `MouseEvent` | Fired when close is clicked. |\n| `update:checked` | `boolean` | Checked state change (`v-model:checked`). |\n| `change` | `boolean` | Checked state change. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Tag content; takes precedence over `value`. |\n"
+          "markdown": "---\ntitle: Tag\ncategory: 01 / BASIC\ndescription: Tag for status or category.\n---\n\n# Tag\n\nTags display status or category.\n\n## Import\n\n```ts\nimport { MTag } from 'morya-ui'\n```\n\n## Basic\n\nShow text via `value` or the default slot.\n\n```vue preview src=\"./demos/Basic.vue\"\n```\n\n## Severity\n\nUse `severity` for semantic color; defaults to primary when omitted. The legacy value `warning` is mapped to `warn`.\n\n```vue preview src=\"./demos/Severity.vue\"\n```\n\n## Icons\n\nPass a `MIcon` icon name to `icon`.\n\n```vue preview src=\"./demos/Icons.vue\"\n```\n\n## Bordered\n\n`bordered` draws a tone-colored outline. Default is borderless with a filled tone background.\n\n```vue preview src=\"./demos/Bordered.vue\"\n```\n\n## Closable\n\n```vue preview src=\"./demos/Closable.vue\"\n```\n\n## Checkable\n\n`checkable` + `v-model:checked` toggles selection. When combined with `closable`, the close control is hidden.\n\n```vue preview src=\"./demos/Checkable.vue\"\n```\n\n## Props\n\n| Prop | Type | Default | Description |\n| --- | --- | --- | --- |\n| `value` | `string` | 鈥?| Tag text. The default slot takes precedence when present. |\n| `severity` | `'primary' \\| 'secondary' \\| 'success' \\| 'info' \\| 'warn' \\| 'help' \\| 'danger' \\| 'contrast' \\| 'warning'` | `'primary'` | Semantic color. `warning` is a compatibility alias mapped to `warn`. |\n| `rounded` | `boolean` | `false` | Fully rounded. |\n| `icon` | [IconName](/docs/types#IconName) | 鈥?| `MIcon` icon name. |\n| `closable` | `boolean` | `false` | Show a close control (ignored when `checkable`). |\n| `size` | `'small' \\| 'medium' \\| 'large' \\| 'sm' \\| 'md' \\| 'lg'` | 鈥?| Size. |\n| `bordered` | `boolean` | `false` | Draw a border. |\n| `color` | `string` | 鈥?| Custom color. |\n| `disabled` | `boolean` | `false` | Disable interaction. |\n| `checkable` | `boolean` | `false` | Toggleable selection. |\n| `checked` | `boolean` | `false` | Checked state; use with `v-model:checked`. |\n| `pt` | [RootPassThrough](/docs/types#RootPassThrough) `{ root? }` | — | DOM pass-through; see [attrs](/docs/attrs). |\n\n\n## Events\n\n| Event | Payload | Description |\n| --- | --- | --- |\n| `close` | `MouseEvent` | Fired when close is clicked. |\n| `update:checked` | `boolean` | Checked state change (`v-model:checked`). |\n| `change` | `boolean` | Checked state change. |\n\n## Slots\n\n| Slot | Description |\n| --- | --- |\n| `default` | Tag content; takes precedence over `value`. |\n"
         }
       }
     },
@@ -28932,7 +29165,7 @@
           "sectionId": "api",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, toast } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton\n      label=\"Success\"\n      severity=\"success\"\n      @click=\"toast.success({ summary: '已保存', detail: '变更已生效。' })\"\n    />\n    <MButton\n      label=\"Info\"\n      severity=\"info\"\n      @click=\"toast.info({ summary: '提示', detail: '可以继续操作。' })\"\n    />\n    <MButton\n      label=\"Warn\"\n      severity=\"warn\"\n      @click=\"toast.warn({ summary: '注意', detail: '请再核对一次。' })\"\n    />\n    <MButton\n      label=\"Error\"\n      severity=\"danger\"\n      @click=\"toast.error({ summary: '失败', detail: '请稍后重试。' })\"\n    />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, toast } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" @click=\"toast.success({ summary: '已保存', detail: '变更已生效。' })\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"toast.info({ summary: '提示', detail: '可以继续操作。' })\" color=\"info\" variant=\"solid\"/>\n    <MButton label=\"Warn\" @click=\"toast.warn({ summary: '注意', detail: '请再核对一次。' })\" color=\"warning\" variant=\"solid\"/>\n    <MButton label=\"Error\" @click=\"toast.error({ summary: '失败', detail: '请稍后重试。' })\" danger type=\"primary\"/>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -28950,7 +29183,7 @@
           "sectionId": "controlled",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { ToastMessage } from 'morya-ui'\nimport { MButton, MToast } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst messages = ref<ToastMessage[]>([])\nlet seq = 0\n\nfunction push(severity: ToastMessage['severity'], summary: string, detail?: string) {\n  messages.value = [\n    ...messages.value,\n    { id: `toast-${++seq}`, summary, detail, severity, life: 0 },\n  ]\n}\n\nfunction onClose(message: ToastMessage) {\n  messages.value = messages.value.filter((item) => item.id !== message.id)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" severity=\"success\" @click=\"push('success', 'Saved', 'Your changes are live.')\" />\n    <MButton label=\"Info\" severity=\"info\" @click=\"push('info', 'Tip', 'Something to know.')\" />\n  </div>\n  <MToast :messages=\"messages\" position=\"top-right\" @close=\"onClose\" />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { ToastMessage } from 'morya-ui'\nimport { MButton, MToast } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst messages = ref<ToastMessage[]>([])\nlet seq = 0\n\nfunction push(severity: ToastMessage['severity'], summary: string, detail?: string) {\n  messages.value = [\n    ...messages.value,\n    { id: `toast-${++seq}`, summary, detail, severity, life: 0 },\n  ]\n}\n\nfunction onClose(message: ToastMessage) {\n  messages.value = messages.value.filter((item) => item.id !== message.id)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" @click=\"push('success', 'Saved', 'Your changes are live.')\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"push('info', 'Tip', 'Something to know.')\" color=\"info\" variant=\"solid\"/>\n  </div>\n  <MToast :messages=\"messages\" position=\"top-right\" @close=\"onClose\" />\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -28986,7 +29219,7 @@
           "sectionId": "api",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, toast } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton\n      label=\"Success\"\n      severity=\"success\"\n      @click=\"toast.success({ summary: 'Saved', detail: 'Your changes are live.' })\"\n    />\n    <MButton\n      label=\"Info\"\n      severity=\"info\"\n      @click=\"toast.info({ summary: 'Tip', detail: 'You can continue.' })\"\n    />\n    <MButton\n      label=\"Warn\"\n      severity=\"warn\"\n      @click=\"toast.warn({ summary: 'Caution', detail: 'Please double-check.' })\"\n    />\n    <MButton\n      label=\"Error\"\n      severity=\"danger\"\n      @click=\"toast.error({ summary: 'Failed', detail: 'Try again later.' })\"\n    />\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, toast } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" @click=\"toast.success({ summary: 'Saved', detail: 'Your changes are live.' })\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"toast.info({ summary: 'Tip', detail: 'You can continue.' })\" color=\"info\" variant=\"solid\"/>\n    <MButton label=\"Warn\" @click=\"toast.warn({ summary: 'Caution', detail: 'Please double-check.' })\" color=\"warning\" variant=\"solid\"/>\n    <MButton label=\"Error\" @click=\"toast.error({ summary: 'Failed', detail: 'Try again later.' })\" danger type=\"primary\"/>\n  </div>\n</template>",
           "locale": "en-US"
         },
         {
@@ -29004,7 +29237,7 @@
           "sectionId": "controlled",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { ToastMessage } from 'morya-ui'\nimport { MButton, MToast } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst messages = ref<ToastMessage[]>([])\nlet seq = 0\n\nfunction push(severity: ToastMessage['severity'], summary: string, detail?: string) {\n  messages.value = [\n    ...messages.value,\n    { id: `toast-${++seq}`, summary, detail, severity, life: 0 },\n  ]\n}\n\nfunction onClose(message: ToastMessage) {\n  messages.value = messages.value.filter((item) => item.id !== message.id)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" severity=\"success\" @click=\"push('success', 'Saved', 'Your changes are live.')\" />\n    <MButton label=\"Info\" severity=\"info\" @click=\"push('info', 'Tip', 'Something to know.')\" />\n  </div>\n  <MToast :messages=\"messages\" position=\"top-right\" @close=\"onClose\" />\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { ToastMessage } from 'morya-ui'\nimport { MButton, MToast } from 'morya-ui'\nimport { ref } from 'vue'\n\nconst messages = ref<ToastMessage[]>([])\nlet seq = 0\n\nfunction push(severity: ToastMessage['severity'], summary: string, detail?: string) {\n  messages.value = [\n    ...messages.value,\n    { id: `toast-${++seq}`, summary, detail, severity, life: 0 },\n  ]\n}\n\nfunction onClose(message: ToastMessage) {\n  messages.value = messages.value.filter((item) => item.id !== message.id)\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-3 items-center\">\n    <MButton label=\"Success\" @click=\"push('success', 'Saved', 'Your changes are live.')\" color=\"success\" variant=\"solid\"/>\n    <MButton label=\"Info\" @click=\"push('info', 'Tip', 'Something to know.')\" color=\"info\" variant=\"solid\"/>\n  </div>\n  <MToast :messages=\"messages\" position=\"top-right\" @close=\"onClose\" />\n</template>",
           "locale": "en-US"
         },
         {
@@ -29416,7 +29649,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MToolbar } from 'morya-ui'\n</script>\n\n<template>\n  <MToolbar>\n    <template #start>\n      <MButton label=\"新建\" size=\"small\" />\n    </template>\n    <template #center>\n      <span>工具栏</span>\n    </template>\n    <template #end>\n      <MButton label=\"导出\" severity=\"secondary\" size=\"small\" />\n    </template>\n  </MToolbar>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MToolbar } from 'morya-ui'\n</script>\n\n<template>\n  <MToolbar>\n    <template #start>\n      <MButton label=\"新建\" size=\"small\" />\n    </template>\n    <template #center>\n      <span>工具栏</span>\n    </template>\n    <template #end>\n      <MButton label=\"导出\" size=\"small\"/>\n    </template>\n  </MToolbar>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -29434,7 +29667,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MToolbar } from 'morya-ui'\n</script>\n\n<template>\n  <MToolbar>\n    <template #start>\n      <MButton label=\"New\" size=\"small\" />\n    </template>\n    <template #center>\n      <span>Toolbar</span>\n    </template>\n    <template #end>\n      <MButton label=\"Export\" severity=\"secondary\" size=\"small\" />\n    </template>\n  </MToolbar>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MToolbar } from 'morya-ui'\n</script>\n\n<template>\n  <MToolbar>\n    <template #start>\n      <MButton label=\"New\" size=\"small\" />\n    </template>\n    <template #center>\n      <span>Toolbar</span>\n    </template>\n    <template #end>\n      <MButton label=\"Export\" size=\"small\"/>\n    </template>\n  </MToolbar>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -29603,7 +29836,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MTooltip } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-4 items-center\">\n    <MTooltip content=\"Save changes\" placement=\"top\">\n      <MButton icon=\"check\" icon-only aria-label=\"Save\" />\n    </MTooltip>\n    <MTooltip content=\"Delete item\" placement=\"bottom\" :show-delay=\"200\" :hide-delay=\"120\" :max-width=\"160\">\n      <MButton icon=\"trash\" icon-only severity=\"danger\" outlined aria-label=\"Delete\" />\n    </MTooltip>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MTooltip } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-4 items-center\">\n    <MTooltip content=\"Save changes\" placement=\"top\">\n      <MButton icon=\"check\" icon-only aria-label=\"Save\" />\n    </MTooltip>\n    <MTooltip content=\"Delete item\" placement=\"bottom\" :show-delay=\"200\" :hide-delay=\"120\" :max-width=\"160\">\n      <MButton icon=\"trash\" icon-only aria-label=\"Delete\" danger/>\n    </MTooltip>\n  </div>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -29621,7 +29854,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport { MButton, MTooltip } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-4 items-center\">\n    <MTooltip content=\"Save changes\" placement=\"top\">\n      <MButton icon=\"check\" icon-only aria-label=\"Save\" />\n    </MTooltip>\n    <MTooltip content=\"Delete item\" placement=\"bottom\" :show-delay=\"200\" :hide-delay=\"120\" :max-width=\"160\">\n      <MButton icon=\"trash\" icon-only severity=\"danger\" outlined aria-label=\"Delete\" />\n    </MTooltip>\n  </div>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport { MButton, MTooltip } from 'morya-ui'\n</script>\n\n<template>\n  <div class=\"flex flex-wrap gap-4 items-center\">\n    <MTooltip content=\"Save changes\" placement=\"top\">\n      <MButton icon=\"check\" icon-only aria-label=\"Save\" />\n    </MTooltip>\n    <MTooltip content=\"Delete item\" placement=\"bottom\" :show-delay=\"200\" :hide-delay=\"120\" :max-width=\"160\">\n      <MButton icon=\"trash\" icon-only aria-label=\"Delete\" danger/>\n    </MTooltip>\n  </div>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -29821,7 +30054,7 @@
           "sectionId": "基础用法",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { TourStep } from '../../types'\nimport { computed, ref } from 'vue'\nimport { MButton, MSpace, MTour } from 'morya-ui'\n\nconst open = ref(false)\nconst current = ref(0)\nconst firstEl = ref<HTMLElement | null>(null)\nconst secondEl = ref<HTMLElement | null>(null)\n\nfunction resolveEl(el: HTMLElement | { $el?: HTMLElement } | null) {\n  if (!el) return null\n  if (el instanceof HTMLElement) return el\n  return el.$el ?? null\n}\n\nconst steps = computed((): TourStep[] => [\n  {\n    title: 'Primary action',\n    description: 'This button starts the guided tour.',\n    target: () => resolveEl(firstEl.value),\n  },\n  {\n    title: 'Secondary',\n    description: 'You can attach steps to any element.',\n    target: () => resolveEl(secondEl.value),\n    placement: 'bottom-start',\n  },\n])\n</script>\n\n<template>\n  <MSpace vertical>\n    <MSpace>\n      <span ref=\"firstEl\">\n        <MButton\n          severity=\"primary\"\n          @click=\"open = true\"\n        >\n          Start tour\n        </MButton>\n      </span>\n      <span ref=\"secondEl\">\n        <MButton>\n          Another control\n        </MButton>\n      </span>\n    </MSpace>\n\n    <MTour\n      v-model:open=\"open\"\n      v-model:current=\"current\"\n      :steps=\"steps\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { TourStep } from '../../types'\nimport { computed, ref } from 'vue'\nimport { MButton, MSpace, MTour } from 'morya-ui'\n\nconst open = ref(false)\nconst current = ref(0)\nconst firstEl = ref<HTMLElement | null>(null)\nconst secondEl = ref<HTMLElement | null>(null)\n\nfunction resolveEl(el: HTMLElement | { $el?: HTMLElement } | null) {\n  if (!el) return null\n  if (el instanceof HTMLElement) return el\n  return el.$el ?? null\n}\n\nconst steps = computed((): TourStep[] => [\n  {\n    title: 'Primary action',\n    description: 'This button starts the guided tour.',\n    target: () => resolveEl(firstEl.value),\n  },\n  {\n    title: 'Secondary',\n    description: 'You can attach steps to any element.',\n    target: () => resolveEl(secondEl.value),\n    placement: 'bottom-start',\n  },\n])\n</script>\n\n<template>\n  <MSpace vertical>\n    <MSpace>\n      <span ref=\"firstEl\">\n        <MButton @click=\"open = true\" type=\"primary\">\n          Start tour\n        </MButton>\n      </span>\n      <span ref=\"secondEl\">\n        <MButton>\n          Another control\n        </MButton>\n      </span>\n    </MSpace>\n\n    <MTour\n      v-model:open=\"open\"\n      v-model:current=\"current\"\n      :steps=\"steps\"\n    />\n  </MSpace>\n</template>",
           "locale": "zh-CN"
         },
         {
@@ -29839,7 +30072,7 @@
           "sectionId": "basic",
           "lang": "vue",
           "preview": true,
-          "code": "<script setup lang=\"ts\">\nimport type { TourStep } from '../../types'\nimport { computed, ref } from 'vue'\nimport { MButton, MSpace, MTour } from 'morya-ui'\n\nconst open = ref(false)\nconst current = ref(0)\nconst firstEl = ref<HTMLElement | null>(null)\nconst secondEl = ref<HTMLElement | null>(null)\n\nfunction resolveEl(el: HTMLElement | { $el?: HTMLElement } | null) {\n  if (!el) return null\n  if (el instanceof HTMLElement) return el\n  return el.$el ?? null\n}\n\nconst steps = computed((): TourStep[] => [\n  {\n    title: 'Primary action',\n    description: 'This button starts the guided tour.',\n    target: () => resolveEl(firstEl.value),\n  },\n  {\n    title: 'Secondary',\n    description: 'You can attach steps to any element.',\n    target: () => resolveEl(secondEl.value),\n    placement: 'bottom-start',\n  },\n])\n</script>\n\n<template>\n  <MSpace vertical>\n    <MSpace>\n      <span ref=\"firstEl\">\n        <MButton\n          severity=\"primary\"\n          @click=\"open = true\"\n        >\n          Start tour\n        </MButton>\n      </span>\n      <span ref=\"secondEl\">\n        <MButton>\n          Another control\n        </MButton>\n      </span>\n    </MSpace>\n\n    <MTour\n      v-model:open=\"open\"\n      v-model:current=\"current\"\n      :steps=\"steps\"\n    />\n  </MSpace>\n</template>",
+          "code": "<script setup lang=\"ts\">\nimport type { TourStep } from '../../types'\nimport { computed, ref } from 'vue'\nimport { MButton, MSpace, MTour } from 'morya-ui'\n\nconst open = ref(false)\nconst current = ref(0)\nconst firstEl = ref<HTMLElement | null>(null)\nconst secondEl = ref<HTMLElement | null>(null)\n\nfunction resolveEl(el: HTMLElement | { $el?: HTMLElement } | null) {\n  if (!el) return null\n  if (el instanceof HTMLElement) return el\n  return el.$el ?? null\n}\n\nconst steps = computed((): TourStep[] => [\n  {\n    title: 'Primary action',\n    description: 'This button starts the guided tour.',\n    target: () => resolveEl(firstEl.value),\n  },\n  {\n    title: 'Secondary',\n    description: 'You can attach steps to any element.',\n    target: () => resolveEl(secondEl.value),\n    placement: 'bottom-start',\n  },\n])\n</script>\n\n<template>\n  <MSpace vertical>\n    <MSpace>\n      <span ref=\"firstEl\">\n        <MButton @click=\"open = true\" type=\"primary\">\n          Start tour\n        </MButton>\n      </span>\n      <span ref=\"secondEl\">\n        <MButton>\n          Another control\n        </MButton>\n      </span>\n    </MSpace>\n\n    <MTour\n      v-model:open=\"open\"\n      v-model:current=\"current\"\n      :steps=\"steps\"\n    />\n  </MSpace>\n</template>",
           "locale": "en-US"
         }
       ],
@@ -31874,7 +32107,7 @@
         "zh-CN": {
           "title": "设计语言",
           "description": "Morya 设计原则与 Design Spec 章节入口。",
-          "markdown": "---\ntitle: 设计语言\norder: 4.5\ndescription: Morya 设计原则与 Design Spec 章节入口。\n---\n\n# 设计语言\n\nMorya UI 是一套**令牌驱动**的 Vue 3 组件库：颜色、间距、圆角、字号与动效统一走 `--m-*`，交互词表用 `severity` / `variant` / `size`，全局行为由 `MConfigProvider`、`useTheme`、`useDensity`、`useMotion` 协同。\n\n本文是 Design Spec 总览。原则摘要来自仓库 [`design-kit/DESIGN.md`](https://github.com/morya-space/morya-ui/blob/main/design-kit/DESIGN.md)；完整变量目录见 [设计令牌](/docs/design-tokens)。\n\n## 原则\n\n1. **组件优先**：交互与布局优先用库内 `M*`，避免手写等价 DOM。\n2. **令牌优先**：页面与业务样式只消费 `--m-*`；禁止在业务代码写裸 `#hex` / `rgb()`（换品牌改主题入口）。\n3. **语义一致**：主操作为默认 primary；破坏性操作用 `severity=\"danger\"` 或确认流。\n4. **可访问**：控件有可访问名称；纯图标按钮提供 `aria-label`；浮层可键盘关闭。\n5. **单一事实源**：API 以组件文档 / MCP 为准，勿臆造 prop。\n\n## 章节\n\n| 章节                                  | 内容                                       |\n| ------------------------------------- | ------------------------------------------ |\n| [色彩](/docs/design-color)            | 品牌色、语义色、中性面、对比与覆盖         |\n| [字体与排版](/docs/design-typography) | 字号阶梯、字重、控件字号                   |\n| [间距](/docs/design-spacing)          | `--m-space-*` 节奏与密度缩放               |\n| [布局](/docs/design-layout)           | `MLayout` / `MPage*` / `MSpace` 与页面框架 |\n| [动效](/docs/motion)                  | 设计原则、时长、缓动、减弱与 API           |\n| [反馈](/docs/design-feedback)         | Message / Toast / Dialog / Alert 层级      |\n\n工程接入另见 [主题](/docs/theme)、[全局配置](/docs/config)、[约定](/docs/conventions)、[Common Props](/docs/common-props)。\n\n## 主题编辑器\n\n在线调色、密度与动效预览：[主题编辑器](/theme-editor)（独立交互路由）。编程侧用 `createTheme` / `useTheme`，见 [主题](/docs/theme)。\n",
+          "markdown": "---\ntitle: 设计语言\norder: 4.5\ndescription: Morya 设计原则与 Design Spec 章节入口。\n---\n\n# 设计语言\n\nMorya UI 是一套**令牌驱动**的 Vue 3 组件库：颜色、间距、圆角、字号与动效统一走 `--m-*`，交互词表用 `severity` / `variant` / `size`，全局行为由 `MConfigProvider`、`useTheme`、`useDensity`、`useMotion` 协同。\n\n本文是 Design Spec 总览。原则摘要来自仓库 [`design-kit/DESIGN.md`](https://github.com/morya-space/morya-ui/blob/main/design-kit/DESIGN.md)；完整变量目录见 [设计令牌](/docs/design-tokens)。\n\n## 原则\n\n1. **组件优先**：交互与布局优先用库内 `M*`，避免手写等价 DOM。\n2. **令牌优先**：页面与业务样式只消费 `--m-*`；禁止在业务代码写裸 `#hex` / `rgb()`（换品牌改主题入口）。\n3. **语义一致**：主操作用 `type=\"primary\"`；破坏性操作用 `danger` / `color=\"danger\"` 或确认流。\n4. **可访问**：控件有可访问名称；纯图标按钮提供 `aria-label`；浮层可键盘关闭。\n5. **单一事实源**：API 以组件文档 / MCP 为准，勿臆造 prop。\n\n## 章节\n\n| 章节                                  | 内容                                       |\n| ------------------------------------- | ------------------------------------------ |\n| [色彩](/docs/design-color)            | 品牌色、语义色、中性面、对比与覆盖         |\n| [字体与排版](/docs/design-typography) | 字号阶梯、字重、控件字号                   |\n| [间距](/docs/design-spacing)          | `--m-space-*` 节奏与密度缩放               |\n| [布局](/docs/design-layout)           | `MLayout` / `MPage*` / `MSpace` 与页面框架 |\n| [动效](/docs/motion)                  | 设计原则、时长、缓动、减弱与 API           |\n| [反馈](/docs/design-feedback)         | Message / Toast / Dialog / Alert 层级      |\n\n工程接入另见 [主题](/docs/theme)、[全局配置](/docs/config)、[约定](/docs/conventions)、[Common Props](/docs/common-props)。\n\n## 主题编辑器\n\n在线调色、密度与动效预览：[主题编辑器](/theme-editor)（独立交互路由）。编程侧用 `createTheme` / `useTheme`，见 [主题](/docs/theme)。\n",
           "sections": [
             {
               "title": "",
@@ -31884,7 +32117,7 @@
             {
               "title": "原则",
               "id": "原则",
-              "body": "1. **组件优先**：交互与布局优先用库内 `M*`，避免手写等价 DOM。\n2. **令牌优先**：页面与业务样式只消费 `--m-*`；禁止在业务代码写裸 `#hex` / `rgb()`（换品牌改主题入口）。\n3. **语义一致**：主操作为默认 primary；破坏性操作用 `severity=\"danger\"` 或确认流。\n4. **可访问**：控件有可访问名称；纯图标按钮提供 `aria-label`；浮层可键盘关闭。\n5. **单一事实源**：API 以组件文档 / MCP 为准，勿臆造 prop。"
+              "body": "1. **组件优先**：交互与布局优先用库内 `M*`，避免手写等价 DOM。\n2. **令牌优先**：页面与业务样式只消费 `--m-*`；禁止在业务代码写裸 `#hex` / `rgb()`（换品牌改主题入口）。\n3. **语义一致**：主操作用 `type=\"primary\"`；破坏性操作用 `danger` / `color=\"danger\"` 或确认流。\n4. **可访问**：控件有可访问名称；纯图标按钮提供 `aria-label`；浮层可键盘关闭。\n5. **单一事实源**：API 以组件文档 / MCP 为准，勿臆造 prop。"
             },
             {
               "title": "章节",
@@ -31901,7 +32134,7 @@
         "en-US": {
           "title": "Design language",
           "description": "Entry to Morya design principles and Design Spec chapters.",
-          "markdown": "---\ntitle: Design language\norder: 4.5\ndescription: Entry to Morya design principles and Design Spec chapters.\n---\n\n# Design language\n\nMorya UI is a **token-driven** Vue 3 library: color, spacing, radius, type, and motion share `--m-*` variables; interaction vocabulary uses `severity` / `variant` / `size`; global behavior is coordinated by `MConfigProvider`, `useTheme`, `useDensity`, and `useMotion`.\n\nThis page is the Design Spec hub. Principles come from [`design-kit/DESIGN.md`](https://github.com/morya-space/morya-ui/blob/main/design-kit/DESIGN.md); the full variable catalog is in [Design tokens](/docs/design-tokens).\n\n## Principles\n\n1. **Components first**: Prefer library `M*` controls over hand-rolled DOM equivalents.\n2. **Tokens first**: App styles consume `--m-*` only; no raw `#hex` / `rgb()` in product CSS (change brand at the theme entry).\n3. **Semantic consistency**: Primary actions default to primary; destructive work uses `severity=\"danger\"` or a confirm flow.\n4. **Accessibility**: Controls need accessible names; icon-only buttons need `aria-label`; overlays dismiss via keyboard.\n5. **Single source of truth**: Trust component docs / MCP for APIs; do not invent props.\n\n## Chapters\n\n| Chapter                               | Focus                                                         |\n| ------------------------------------- | ------------------------------------------------------------- |\n| [Color](/docs/design-color)           | Brand, severity, neutrals, contrast, overrides                |\n| [Typography](/docs/design-typography) | Type ramp, weights, control fonts                             |\n| [Spacing](/docs/design-spacing)       | `--m-space-*` rhythm and density scaling                      |\n| [Layout](/docs/design-layout)         | `MLayout` / `MPage*` / `MSpace` and app chrome                |\n| [Motion](/docs/motion)                | Design principles, duration, easing, reduced motion, and APIs |\n| [Feedback](/docs/design-feedback)     | Message / Toast / Dialog / Alert hierarchy                    |\n\nEngineering guides: [Theme](/docs/theme), [Configuration](/docs/config), [Conventions](/docs/conventions), [Common Props](/docs/common-props).\n\n## Theme editor\n\nLive accent, density, and motion preview: [Theme editor](/theme-editor) (interactive route). Programmatic APIs: `createTheme` / `useTheme` — see [Theme](/docs/theme).\n",
+          "markdown": "---\ntitle: Design language\norder: 4.5\ndescription: Entry to Morya design principles and Design Spec chapters.\n---\n\n# Design language\n\nMorya UI is a **token-driven** Vue 3 library: color, spacing, radius, type, and motion share `--m-*` variables; interaction vocabulary uses `severity` / `variant` / `size`; global behavior is coordinated by `MConfigProvider`, `useTheme`, `useDensity`, and `useMotion`.\n\nThis page is the Design Spec hub. Principles come from [`design-kit/DESIGN.md`](https://github.com/morya-space/morya-ui/blob/main/design-kit/DESIGN.md); the full variable catalog is in [Design tokens](/docs/design-tokens).\n\n## Principles\n\n1. **Components first**: Prefer library `M*` controls over hand-rolled DOM equivalents.\n2. **Tokens first**: App styles consume `--m-*` only; no raw `#hex` / `rgb()` in product CSS (change brand at the theme entry).\n3. **Semantic consistency**: Primary actions use `type=\"primary\"`; destructive work uses `danger` / `color=\"danger\"` or a confirm flow.\n4. **Accessibility**: Controls need accessible names; icon-only buttons need `aria-label`; overlays dismiss via keyboard.\n5. **Single source of truth**: Trust component docs / MCP for APIs; do not invent props.\n\n## Chapters\n\n| Chapter                               | Focus                                                         |\n| ------------------------------------- | ------------------------------------------------------------- |\n| [Color](/docs/design-color)           | Brand, severity, neutrals, contrast, overrides                |\n| [Typography](/docs/design-typography) | Type ramp, weights, control fonts                             |\n| [Spacing](/docs/design-spacing)       | `--m-space-*` rhythm and density scaling                      |\n| [Layout](/docs/design-layout)         | `MLayout` / `MPage*` / `MSpace` and app chrome                |\n| [Motion](/docs/motion)                | Design principles, duration, easing, reduced motion, and APIs |\n| [Feedback](/docs/design-feedback)     | Message / Toast / Dialog / Alert hierarchy                    |\n\nEngineering guides: [Theme](/docs/theme), [Configuration](/docs/config), [Conventions](/docs/conventions), [Common Props](/docs/common-props).\n\n## Theme editor\n\nLive accent, density, and motion preview: [Theme editor](/theme-editor) (interactive route). Programmatic APIs: `createTheme` / `useTheme` — see [Theme](/docs/theme).\n",
           "sections": [
             {
               "title": "",
@@ -31911,7 +32144,7 @@
             {
               "title": "Principles",
               "id": "principles",
-              "body": "1. **Components first**: Prefer library `M*` controls over hand-rolled DOM equivalents.\n2. **Tokens first**: App styles consume `--m-*` only; no raw `#hex` / `rgb()` in product CSS (change brand at the theme entry).\n3. **Semantic consistency**: Primary actions default to primary; destructive work uses `severity=\"danger\"` or a confirm flow.\n4. **Accessibility**: Controls need accessible names; icon-only buttons need `aria-label`; overlays dismiss via keyboard.\n5. **Single source of truth**: Trust component docs / MCP for APIs; do not invent props."
+              "body": "1. **Components first**: Prefer library `M*` controls over hand-rolled DOM equivalents.\n2. **Tokens first**: App styles consume `--m-*` only; no raw `#hex` / `rgb()` in product CSS (change brand at the theme entry).\n3. **Semantic consistency**: Primary actions use `type=\"primary\"`; destructive work uses `danger` / `color=\"danger\"` or a confirm flow.\n4. **Accessibility**: Controls need accessible names; icon-only buttons need `aria-label`; overlays dismiss via keyboard.\n5. **Single source of truth**: Trust component docs / MCP for APIs; do not invent props."
             },
             {
               "title": "Chapters",
@@ -31938,7 +32171,7 @@
         "zh-CN": {
           "title": "色彩",
           "description": "品牌色、语义色、中性色与对比度约定。",
-          "markdown": "---\ntitle: 色彩\norder: 4.51\ndescription: 品牌色、语义色、中性色与对比度约定。\n---\n\n# 色彩\n\n组件只消费语义化 `--m-*` 颜色变量，不维护第二套业务色板。亮 / 暗色由 `document.documentElement` 的 `data-theme` 切换（`useTheme`）。\n\n## 原则\n\n- **换品牌改令牌**：在主题入口覆盖 `--m-color-primary`（及派生 hover / active / bg），页面仍写 `var(--m-*)`。\n- **语义先于色相**：按钮、Tag、Alert 用 `severity`，不要用裸色冒充状态。\n- **暗色必须可跟随**：业务 CSS 勿写死浅色专用 hex；依赖 `[data-theme=\"dark\"]` 覆盖。\n- **不只靠颜色传达**：错误 / 成功同时给文案或图标（见 [无障碍](/docs/accessibility)）。\n\n## 核心令牌\n\n| Token | 默认（亮色） | 用途 |\n| --- | --- | --- |\n| `--m-color-primary` | `#1677ff` | 品牌主色、链接、默认主按钮 |\n| `--m-color-primary-hover` | `#4096ff` | 主色悬浮 |\n| `--m-color-surface` | `#ffffff` | 容器 / 卡片底 |\n| `--m-color-text` | `rgba(0,0,0,0.88)` | 正文 |\n| `--m-color-text-muted` | `rgba(0,0,0,0.45)` | 次要说明 |\n| `--m-color-border` | `#d9d9d9` | 描边 |\n| `--m-color-split` | `#f0f0f0` | 弱分割（弱于 border） |\n| `--m-color-success` | `#52c41a` | 成功 |\n| `--m-color-info` | `#1677ff` | 信息 |\n| `--m-color-warning` / `--m-color-warn` | `#faad14` | 警告（`warn` 为别名） |\n| `--m-color-danger` | `#ff4d4f` | 危险 / 错误 |\n| `--m-color-help` | `#9333ea` | 帮助提示 |\n| `--m-color-on-emphasis` | `#ffffff` | 实心强调面上的前景 |\n| `--m-color-focus-ring` | 跟主色 | 聚焦相关 |\n| `--m-opacity-disabled` | `0.55` | 禁用透明度 |\n\n暗色示例：`--m-color-surface: #141414`，正文 `rgba(255,255,255,0.85)`。完整表见 [设计令牌](/docs/design-tokens)。\n\n## severity 映射\n\n| `severity` | 对应色 |\n| --- | --- |\n| （省略 / primary） | `--m-color-primary` |\n| `secondary` | 中性次要外观 |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` 系 |\n\n破坏性操作：按钮 / 确认用 `severity=\"danger\"`，不要用主色冒充删除。\n\n## 覆盖方式\n\n```css\n:root {\n  --m-color-primary: #0b6e4f;\n}\n[data-theme=\"dark\"] {\n  --m-color-primary: #3ecf8e;\n}\n```\n\n也可用 `createTheme({ seed: { colorPrimary: '…' } })` 派生 hover / bg 等（见 [主题](/docs/theme)）。在线预览：[主题编辑器](/theme-editor)。\n\n## 建议与避免\n\n| 建议 | 避免 |\n| --- | --- |\n| 主操作默认 primary，次要用 `secondary` / `outlined` | 一屏多个同等实心主按钮 |\n| 错误态用 `danger` + 文案 | 只用红色边框表达错误 |\n| 弱分隔用 `--m-color-split` | 到处加粗边框抢层级 |\n| 聚焦用 `--m-focus-shadow` | 手写外扩 outline 与主题脱节 |\n\n下一章：[字体与排版](/docs/design-typography)。\n",
+          "markdown": "---\ntitle: 色彩\norder: 4.51\ndescription: 品牌色、语义色、中性色与对比度约定。\n---\n\n# 色彩\n\n组件只消费语义化 `--m-*` 颜色变量，不维护第二套业务色板。亮 / 暗色由 `document.documentElement` 的 `data-theme` 切换（`useTheme`）。\n\n## 原则\n\n- **换品牌改令牌**：在主题入口覆盖 `--m-color-primary`（及派生 hover / active / bg），页面仍写 `var(--m-*)`。\n- **语义先于色相**：按钮、Tag、Alert 用 `severity`，不要用裸色冒充状态。\n- **暗色必须可跟随**：业务 CSS 勿写死浅色专用 hex；依赖 `[data-theme=\"dark\"]` 覆盖。\n- **不只靠颜色传达**：错误 / 成功同时给文案或图标（见 [无障碍](/docs/accessibility)）。\n\n## 核心令牌\n\n| Token | 默认（亮色） | 用途 |\n| --- | --- | --- |\n| `--m-color-primary` | `#1677ff` | 品牌主色、链接、默认主按钮 |\n| `--m-color-primary-hover` | `#4096ff` | 主色悬浮 |\n| `--m-color-surface` | `#ffffff` | 容器 / 卡片底 |\n| `--m-color-text` | `rgba(0,0,0,0.88)` | 正文 |\n| `--m-color-text-muted` | `rgba(0,0,0,0.45)` | 次要说明 |\n| `--m-color-border` | `#d9d9d9` | 描边 |\n| `--m-color-split` | `#f0f0f0` | 弱分割（弱于 border） |\n| `--m-color-success` | `#52c41a` | 成功 |\n| `--m-color-info` | `#1677ff` | 信息 |\n| `--m-color-warning` / `--m-color-warn` | `#faad14` | 警告（`warn` 为别名） |\n| `--m-color-danger` | `#ff4d4f` | 危险 / 错误 |\n| `--m-color-help` | `#9333ea` | 帮助提示 |\n| `--m-color-on-emphasis` | `#ffffff` | 实心强调面上的前景 |\n| `--m-color-focus-ring` | 跟主色 | 聚焦相关 |\n| `--m-opacity-disabled` | `0.55` | 禁用透明度 |\n\n暗色示例：`--m-color-surface: #141414`，正文 `rgba(255,255,255,0.85)`。完整表见 [设计令牌](/docs/design-tokens)。\n\n## severity 映射\n\n| `severity` | 对应色 |\n| --- | --- |\n| （省略 / primary） | `--m-color-primary` |\n| `secondary` | 中性次要外观 |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` 系 |\n\n破坏性操作：按钮 / 确认用 `danger` 或 `color=\"danger\"`，不要用主色冒充删除。\n\n## 覆盖方式\n\n```css\n:root {\n  --m-color-primary: #0b6e4f;\n}\n[data-theme=\"dark\"] {\n  --m-color-primary: #3ecf8e;\n}\n```\n\n也可用 `createTheme({ seed: { colorPrimary: '…' } })` 派生 hover / bg 等（见 [主题](/docs/theme)）。在线预览：[主题编辑器](/theme-editor)。\n\n## 建议与避免\n\n| 建议 | 避免 |\n| --- | --- |\n| 主操作默认 primary，次要用 `secondary` / `outlined` | 一屏多个同等实心主按钮 |\n| 错误态用 `danger` + 文案 | 只用红色边框表达错误 |\n| 弱分隔用 `--m-color-split` | 到处加粗边框抢层级 |\n| 聚焦用 `--m-focus-shadow` | 手写外扩 outline 与主题脱节 |\n\n下一章：[字体与排版](/docs/design-typography)。\n",
           "sections": [
             {
               "title": "",
@@ -31958,7 +32191,7 @@
             {
               "title": "severity 映射",
               "id": "severity-映射",
-              "body": "| `severity` | 对应色 |\n| --- | --- |\n| （省略 / primary） | `--m-color-primary` |\n| `secondary` | 中性次要外观 |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` 系 |\n\n破坏性操作：按钮 / 确认用 `severity=\"danger\"`，不要用主色冒充删除。"
+              "body": "| `severity` | 对应色 |\n| --- | --- |\n| （省略 / primary） | `--m-color-primary` |\n| `secondary` | 中性次要外观 |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` 系 |\n\n破坏性操作：按钮 / 确认用 `danger` 或 `color=\"danger\"`，不要用主色冒充删除。"
             },
             {
               "title": "覆盖方式",
@@ -31975,7 +32208,7 @@
         "en-US": {
           "title": "Color",
           "description": "Brand, severity, neutrals, and contrast conventions.",
-          "markdown": "---\ntitle: Color\norder: 4.51\ndescription: Brand, severity, neutrals, and contrast conventions.\n---\n\n# Color\n\nComponents consume semantic `--m-*` color variables only—there is no second product palette. Light / dark follows `data-theme` on `document.documentElement` via `useTheme`.\n\n## Principles\n\n- **Brand at the theme entry**: Override `--m-color-primary` (and derived hover / active / bg); pages keep `var(--m-*)`.\n- **Semantics over hue**: Buttons, tags, and alerts use `severity`—do not fake status with raw colors.\n- **Dark must follow**: Avoid light-only hex in app CSS; rely on `[data-theme=\"dark\"]` overrides.\n- **Never color alone**: Pair error / success with copy or icons (see [Accessibility](/docs/accessibility)).\n\n## Core tokens\n\n| Token | Default (light) | Role |\n| --- | --- | --- |\n| `--m-color-primary` | `#1677ff` | Brand, links, default primary button |\n| `--m-color-primary-hover` | `#4096ff` | Primary hover |\n| `--m-color-surface` | `#ffffff` | Container / card surface |\n| `--m-color-text` | `rgba(0,0,0,0.88)` | Body text |\n| `--m-color-text-muted` | `rgba(0,0,0,0.45)` | Secondary copy |\n| `--m-color-border` | `#d9d9d9` | Borders |\n| `--m-color-split` | `#f0f0f0` | Weaker dividers |\n| `--m-color-success` | `#52c41a` | Success |\n| `--m-color-info` | `#1677ff` | Info |\n| `--m-color-warning` / `--m-color-warn` | `#faad14` | Warning (`warn` alias) |\n| `--m-color-danger` | `#ff4d4f` | Danger / error |\n| `--m-color-help` | `#9333ea` | Help accent |\n| `--m-color-on-emphasis` | `#ffffff` | Foreground on solid emphasis |\n| `--m-color-focus-ring` | Tracks primary | Focus-related |\n| `--m-opacity-disabled` | `0.55` | Disabled opacity |\n\nDark example: `--m-color-surface: #141414`, body `rgba(255,255,255,0.85)`. Full catalog: [Design tokens](/docs/design-tokens).\n\n## Severity mapping\n\n| `severity` | Maps to |\n| --- | --- |\n| (omit / primary) | `--m-color-primary` |\n| `secondary` | Neutral secondary treatment |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` family |\n\nDestructive actions: use `severity=\"danger\"` on buttons / confirms—do not paint delete as primary.\n\n## Overrides\n\n```css\n:root {\n  --m-color-primary: #0b6e4f;\n}\n[data-theme=\"dark\"] {\n  --m-color-primary: #3ecf8e;\n}\n```\n\nOr derive with `createTheme({ seed: { colorPrimary: '…' } })` (see [Theme](/docs/theme)). Live preview: [Theme editor](/theme-editor).\n\n## Do / Don't\n\n| Do | Don't |\n| --- | --- |\n| One clear primary action; secondary via `secondary` / `outlined` | Several equally solid primary buttons |\n| Errors: `danger` + message | Red border alone for validation |\n| Weak rules with `--m-color-split` | Heavy borders everywhere |\n| Focus with `--m-focus-shadow` | Ad-hoc outline rings that ignore theme |\n\nNext: [Typography](/docs/design-typography).\n",
+          "markdown": "---\ntitle: Color\norder: 4.51\ndescription: Brand, severity, neutrals, and contrast conventions.\n---\n\n# Color\n\nComponents consume semantic `--m-*` color variables only—there is no second product palette. Light / dark follows `data-theme` on `document.documentElement` via `useTheme`.\n\n## Principles\n\n- **Brand at the theme entry**: Override `--m-color-primary` (and derived hover / active / bg); pages keep `var(--m-*)`.\n- **Semantics over hue**: Buttons, tags, and alerts use `severity`—do not fake status with raw colors.\n- **Dark must follow**: Avoid light-only hex in app CSS; rely on `[data-theme=\"dark\"]` overrides.\n- **Never color alone**: Pair error / success with copy or icons (see [Accessibility](/docs/accessibility)).\n\n## Core tokens\n\n| Token | Default (light) | Role |\n| --- | --- | --- |\n| `--m-color-primary` | `#1677ff` | Brand, links, default primary button |\n| `--m-color-primary-hover` | `#4096ff` | Primary hover |\n| `--m-color-surface` | `#ffffff` | Container / card surface |\n| `--m-color-text` | `rgba(0,0,0,0.88)` | Body text |\n| `--m-color-text-muted` | `rgba(0,0,0,0.45)` | Secondary copy |\n| `--m-color-border` | `#d9d9d9` | Borders |\n| `--m-color-split` | `#f0f0f0` | Weaker dividers |\n| `--m-color-success` | `#52c41a` | Success |\n| `--m-color-info` | `#1677ff` | Info |\n| `--m-color-warning` / `--m-color-warn` | `#faad14` | Warning (`warn` alias) |\n| `--m-color-danger` | `#ff4d4f` | Danger / error |\n| `--m-color-help` | `#9333ea` | Help accent |\n| `--m-color-on-emphasis` | `#ffffff` | Foreground on solid emphasis |\n| `--m-color-focus-ring` | Tracks primary | Focus-related |\n| `--m-opacity-disabled` | `0.55` | Disabled opacity |\n\nDark example: `--m-color-surface: #141414`, body `rgba(255,255,255,0.85)`. Full catalog: [Design tokens](/docs/design-tokens).\n\n## Severity mapping\n\n| `severity` | Maps to |\n| --- | --- |\n| (omit / primary) | `--m-color-primary` |\n| `secondary` | Neutral secondary treatment |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` family |\n\nDestructive actions: use `danger` or `color=\"danger\"` on buttons / confirms—do not paint delete as primary.\n\n## Overrides\n\n```css\n:root {\n  --m-color-primary: #0b6e4f;\n}\n[data-theme=\"dark\"] {\n  --m-color-primary: #3ecf8e;\n}\n```\n\nOr derive with `createTheme({ seed: { colorPrimary: '…' } })` (see [Theme](/docs/theme)). Live preview: [Theme editor](/theme-editor).\n\n## Do / Don't\n\n| Do | Don't |\n| --- | --- |\n| One clear primary action; secondary via `secondary` / `outlined` | Several equally solid primary buttons |\n| Errors: `danger` + message | Red border alone for validation |\n| Weak rules with `--m-color-split` | Heavy borders everywhere |\n| Focus with `--m-focus-shadow` | Ad-hoc outline rings that ignore theme |\n\nNext: [Typography](/docs/design-typography).\n",
           "sections": [
             {
               "title": "",
@@ -31995,7 +32228,7 @@
             {
               "title": "Severity mapping",
               "id": "severity-mapping",
-              "body": "| `severity` | Maps to |\n| --- | --- |\n| (omit / primary) | `--m-color-primary` |\n| `secondary` | Neutral secondary treatment |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` family |\n\nDestructive actions: use `severity=\"danger\"` on buttons / confirms—do not paint delete as primary."
+              "body": "| `severity` | Maps to |\n| --- | --- |\n| (omit / primary) | `--m-color-primary` |\n| `secondary` | Neutral secondary treatment |\n| `success` | `--m-color-success` |\n| `info` | `--m-color-info` |\n| `warning` / `warn` | `--m-color-warning` |\n| `help` | `--m-color-help` |\n| `danger` | `--m-color-danger` |\n| `contrast` | `--m-color-contrast` family |\n\nDestructive actions: use `danger` or `color=\"danger\"` on buttons / confirms—do not paint delete as primary."
             },
             {
               "title": "Overrides",
@@ -32640,7 +32873,7 @@
         "zh-CN": {
           "title": "Common Props",
           "description": "跨组件公共 props、Semantic DOM 与 pt 约定。",
-          "markdown": "---\ntitle: Common Props\norder: 7.5\ndescription: 跨组件公共 props、Semantic DOM 与 pt 约定。\n---\n\n# Common Props\n\n多数 Morya 组件共享同一套交互词表与样式落点，本页说明 morya 自己的命名与语义。细节交叉阅读：[约定](/docs/conventions)、[样式与 attrs](/docs/attrs)、[API 类型](/docs/types)、[设计令牌](/docs/design-tokens)。\n\n## 语义与外观\n\n| Prop                 | 含义         | 常见取值                                                                                                      |\n| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |\n| `severity`           | 语义色       | `primary`（常可省略）/ `secondary` / `success` / `info` / `warning`（`warn`）/ `help` / `danger` / `contrast` |\n| `variant`            | 外观快捷方式 | 随组件：`outlined` / `dashed` / `text` / `link` / `ghost` / `quaternary` / 输入框 `filled` 等                 |\n| `size`               | 控件尺寸     | `small` / `medium` / `large`（兼容 `sm` / `md` / `lg`）；未传常继承 Config                                    |\n| `disabled`           | 禁用         | 交互与点击关闭；视觉用 `--m-opacity-disabled` 等                                                              |\n| `loading`            | 加载中       | 常见于 Button；阻止重复提交                                                                                   |\n| `fluid`              | 通栏         | 宽度撑满父级                                                                                                  |\n| `status` / `invalid` | 表单校验态   | 如 `error` / `warning`；配合 `error-message`                                                                  |\n\n布尔形态（`outlined`、`text`、`link`…）与 `variant` 等价时可择一；**severity 管色，variant 管形**，可组合（如 `severity=\"danger\"` + `outlined`）。\n\n## 样式落点：class / style / 事件\n\n复合组件不是「根 = 原生控件」。attrs 三类落点：\n\n| 类型       | 例子             | `class` / `style` / 多数 attrs   | 事件 `@xxx`       |\n| ---------- | ---------------- | -------------------------------- | ----------------- |\n| 字段       | Input、Select    | 外层 field 根                    | 内层 input / 控件 |\n| Label 控件 | Checkbox、Switch | 可见 `<label>`                   | hidden `<input>`  |\n| 容器       | Card、Tabs       | 对外根（Dialog 的 class 在遮罩） | 同层              |\n| 叶子       | Button、Tag      | 交互元素本身                     | 同元素            |\n\n完整规则与演示：[样式与 attrs](/docs/attrs)。\n\n## Semantic DOM 与 `pt`\n\n**Semantic DOM**：文档里用稳定的结构名描述可定制节点（如 Button 的 root / icon / label），方便主题与测试定位。\n\n**`pt`（pass-through）**：按分段把 `class` / `style` / 原生属性合并到内层 DOM，键名即分段名。\n\n```vue\n<MInput\n  label=\"API Key\"\n  :pt=\"{\n    root: { class: 'col-span-2' },\n    input: { class: 'font-mono', autocomplete: 'off' },\n  }\"\n/>\n```\n\n常见键：\n\n| 形态        | `pt` 键                                                                   |\n| ----------- | ------------------------------------------------------------------------- |\n| 字段        | `root`、`label`、`input` / `control`，部分有 `prefix` / `suffix` / `help` |\n| Checkbox 等 | `root`、`input`                                                           |\n| 单根容器    | `root`                                                                    |\n| 复杂组件    | 额外键见该组件文档（如 Splitter 的 `gutter`）                             |\n\n类型：`PassThroughPart`、`FieldPassThrough`、`RootPassThrough` 等见 [API 类型](/docs/types)。同名 `class` / `style` 与已有绑定**合并**，非整段覆盖。\n\n叶子组件（如 `MButton`）通常直接把 `class` 绑在 `<button>` 上；`MButtonGroup` 等仍可用 `pt.root`。结构说明写在各组件 **Semantic DOM** 小节（示范：[Button](/components/Button)）。\n\n## 全局默认\n\n`MConfigProvider` / `createMoryaUI` 可下发默认 `size`、`density`、`inputVariant`、`appendTo`、`zIndex`、`locale`、`componentDefaults`、`motion` 等——见 [全局配置](/docs/config)。视觉层仍用 [主题](/docs/theme) 的 `useTheme` / 令牌覆盖。\n\n## 建议与避免\n\n| 建议                                                  | 避免                                  |\n| ----------------------------------------------------- | ------------------------------------- |\n| 跨组件统一 `severity` 词表                            | 同一产品里混用 `type=\"danger\"` 等异名 |\n| 布局 class 加在字段根                                 | 指望 `class` 自动落到内层 input       |\n| 用 `pt` 改前缀 / 控件细节                             | 为改一处 class 去 fork 组件           |\n| Semantic DOM 名称与 BEM（`.m-button__label`）对齐记忆 | 臆造未文档化的 `pt` 键                |\n",
+          "markdown": "---\ntitle: Common Props\norder: 7.5\ndescription: 跨组件公共 props、Semantic DOM 与 pt 约定。\n---\n\n# Common Props\n\n多数 Morya 组件共享同一套交互词表与样式落点，本页说明 morya 自己的命名与语义。细节交叉阅读：[约定](/docs/conventions)、[样式与 attrs](/docs/attrs)、[API 类型](/docs/types)、[设计令牌](/docs/design-tokens)。\n\n## 语义与外观\n\n| Prop                 | 含义         | 常见取值                                                                                                      |\n| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |\n| `severity`           | 语义色       | Badge / Tag / Alert / Message 等：`primary` / `secondary` / `success` / `info` / `warning`（`warn`）/ `danger` / `contrast` |\n| `type` / `color` / `variant` | Button 外观 | Button 用 `type`（糖）+ `color` + `variant`（`solid` / `outlined` / `dashed` / `filled` / `text` / `link`）；默认 `color=default` + `variant=outlined`；主实心用 `type=\"primary\"` |\n| `size`               | 控件尺寸     | `small` / `medium` / `large`（兼容 `sm` / `md` / `lg`）；未传常继承 Config                                    |\n| `disabled`           | 禁用         | 交互与点击关闭；视觉用 `--m-opacity-disabled` 等                                                              |\n| `loading`            | 加载中       | 常见于 Button；阻止重复提交                                                                                   |\n| `fluid` / `block`    | 通栏         | 多数字段用 `fluid`；Button / ButtonGroup 用 `block`                                                          |\n| `status` / `invalid` | 表单校验态   | 如 `error` / `warning`；配合 `error-message`                                                                  |\n\n**Badge / Tag / Alert 等**：`severity` 管色。**Button**：`type` / `color` / `variant` 管色与形（如 `type=\"primary\"`，或 `color=\"danger\"` + `variant=\"outlined\"`）；危险实心可用 `type=\"primary\" danger`。\n\n## 样式落点：class / style / 事件\n\n复合组件不是「根 = 原生控件」。attrs 三类落点：\n\n| 类型       | 例子             | `class` / `style` / 多数 attrs   | 事件 `@xxx`       |\n| ---------- | ---------------- | -------------------------------- | ----------------- |\n| 字段       | Input、Select    | 外层 field 根                    | 内层 input / 控件 |\n| Label 控件 | Checkbox、Switch | 可见 `<label>`                   | hidden `<input>`  |\n| 容器       | Card、Tabs       | 对外根（Dialog 的 class 在遮罩） | 同层              |\n| 叶子       | Button、Tag      | 交互元素本身                     | 同元素            |\n\n完整规则与演示：[样式与 attrs](/docs/attrs)。\n\n## Semantic DOM 与 `pt`\n\n**Semantic DOM**：文档里用稳定的结构名描述可定制节点（如 Button 的 root / icon / label），方便主题与测试定位。\n\n**`pt`（pass-through）**：按分段把 `class` / `style` / 原生属性合并到内层 DOM，键名即分段名。\n\n```vue\n<MInput\n  label=\"API Key\"\n  :pt=\"{\n    root: { class: 'col-span-2' },\n    input: { class: 'font-mono', autocomplete: 'off' },\n  }\"\n/>\n```\n\n常见键：\n\n| 形态        | `pt` 键                                                                   |\n| ----------- | ------------------------------------------------------------------------- |\n| 字段        | `root`、`label`、`input` / `control`，部分有 `prefix` / `suffix` / `help` |\n| Checkbox 等 | `root`、`input`                                                           |\n| 单根容器    | `root`                                                                    |\n| 复杂组件    | 额外键见该组件文档（如 Splitter 的 `gutter`）                             |\n\n类型：`PassThroughPart`、`FieldPassThrough`、`RootPassThrough` 等见 [API 类型](/docs/types)。同名 `class` / `style` 与已有绑定**合并**，非整段覆盖。\n\n叶子组件（如 `MButton`）通常直接把 `class` 绑在 `<button>` 上；`MButtonGroup` 等仍可用 `pt.root`。结构说明写在各组件 **Semantic DOM** 小节（示范：[Button](/components/Button)）。\n\n## 全局默认\n\n`MConfigProvider` / `createMoryaUI` 可下发默认 `size`、`density`、`inputVariant`、`appendTo`、`zIndex`、`locale`、`componentDefaults`、`motion` 等——见 [全局配置](/docs/config)。视觉层仍用 [主题](/docs/theme) 的 `useTheme` / 令牌覆盖。\n\n## 建议与避免\n\n| 建议                                                  | 避免                                  |\n| ----------------------------------------------------- | ------------------------------------- |\n| Badge / Tag / Alert 用 `severity`；Button 用 `type` / `color` / `variant` | 在 Button 上继续写已移除的 `severity` / `fluid` / `outlined` 布尔 |\n| 布局 class 加在字段根                                 | 指望 `class` 自动落到内层 input       |\n| 用 `pt` 改前缀 / 控件细节                             | 为改一处 class 去 fork 组件           |\n| Semantic DOM 名称与 BEM（`.m-button__label`）对齐记忆 | 臆造未文档化的 `pt` 键                |\n",
           "sections": [
             {
               "title": "",
@@ -32650,7 +32883,7 @@
             {
               "title": "语义与外观",
               "id": "语义与外观",
-              "body": "| Prop                 | 含义         | 常见取值                                                                                                      |\n| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |\n| `severity`           | 语义色       | `primary`（常可省略）/ `secondary` / `success` / `info` / `warning`（`warn`）/ `help` / `danger` / `contrast` |\n| `variant`            | 外观快捷方式 | 随组件：`outlined` / `dashed` / `text` / `link` / `ghost` / `quaternary` / 输入框 `filled` 等                 |\n| `size`               | 控件尺寸     | `small` / `medium` / `large`（兼容 `sm` / `md` / `lg`）；未传常继承 Config                                    |\n| `disabled`           | 禁用         | 交互与点击关闭；视觉用 `--m-opacity-disabled` 等                                                              |\n| `loading`            | 加载中       | 常见于 Button；阻止重复提交                                                                                   |\n| `fluid`              | 通栏         | 宽度撑满父级                                                                                                  |\n| `status` / `invalid` | 表单校验态   | 如 `error` / `warning`；配合 `error-message`                                                                  |\n\n布尔形态（`outlined`、`text`、`link`…）与 `variant` 等价时可择一；**severity 管色，variant 管形**，可组合（如 `severity=\"danger\"` + `outlined`）。"
+              "body": "| Prop                 | 含义         | 常见取值                                                                                                      |\n| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |\n| `severity`           | 语义色       | Badge / Tag / Alert / Message 等：`primary` / `secondary` / `success` / `info` / `warning`（`warn`）/ `danger` / `contrast` |\n| `type` / `color` / `variant` | Button 外观 | Button 用 `type`（糖）+ `color` + `variant`（`solid` / `outlined` / `dashed` / `filled` / `text` / `link`）；默认 `color=default` + `variant=outlined`；主实心用 `type=\"primary\"` |\n| `size`               | 控件尺寸     | `small` / `medium` / `large`（兼容 `sm` / `md` / `lg`）；未传常继承 Config                                    |\n| `disabled`           | 禁用         | 交互与点击关闭；视觉用 `--m-opacity-disabled` 等                                                              |\n| `loading`            | 加载中       | 常见于 Button；阻止重复提交                                                                                   |\n| `fluid` / `block`    | 通栏         | 多数字段用 `fluid`；Button / ButtonGroup 用 `block`                                                          |\n| `status` / `invalid` | 表单校验态   | 如 `error` / `warning`；配合 `error-message`                                                                  |\n\n**Badge / Tag / Alert 等**：`severity` 管色。**Button**：`type` / `color` / `variant` 管色与形（如 `type=\"primary\"`，或 `color=\"danger\"` + `variant=\"outlined\"`）；危险实心可用 `type=\"primary\" danger`。"
             },
             {
               "title": "样式落点：class / style / 事件",
@@ -32670,14 +32903,14 @@
             {
               "title": "建议与避免",
               "id": "建议与避免",
-              "body": "| 建议                                                  | 避免                                  |\n| ----------------------------------------------------- | ------------------------------------- |\n| 跨组件统一 `severity` 词表                            | 同一产品里混用 `type=\"danger\"` 等异名 |\n| 布局 class 加在字段根                                 | 指望 `class` 自动落到内层 input       |\n| 用 `pt` 改前缀 / 控件细节                             | 为改一处 class 去 fork 组件           |\n| Semantic DOM 名称与 BEM（`.m-button__label`）对齐记忆 | 臆造未文档化的 `pt` 键                |"
+              "body": "| 建议                                                  | 避免                                  |\n| ----------------------------------------------------- | ------------------------------------- |\n| Badge / Tag / Alert 用 `severity`；Button 用 `type` / `color` / `variant` | 在 Button 上继续写已移除的 `severity` / `fluid` / `outlined` 布尔 |\n| 布局 class 加在字段根                                 | 指望 `class` 自动落到内层 input       |\n| 用 `pt` 改前缀 / 控件细节                             | 为改一处 class 去 fork 组件           |\n| Semantic DOM 名称与 BEM（`.m-button__label`）对齐记忆 | 臆造未文档化的 `pt` 键                |"
             }
           ]
         },
         "en-US": {
           "title": "Common Props",
           "description": "Shared props, Semantic DOM, and pt conventions across components.",
-          "markdown": "---\ntitle: Common Props\norder: 7.5\ndescription: Shared props, Semantic DOM, and pt conventions across components.\n---\n\n# Common Props\n\nMost Morya components share one interaction vocabulary and style targeting model. This page documents morya's own names and semantics. Cross-links: [Conventions](/docs/conventions), [Attrs](/docs/attrs), [API types](/docs/types), [Design tokens](/docs/design-tokens).\n\n## Semantics and appearance\n\n| Prop                 | Meaning             | Common values                                                                                                      |\n| -------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| `severity`           | Semantic color      | `primary` (often omitted) / `secondary` / `success` / `info` / `warning` (`warn`) / `help` / `danger` / `contrast` |\n| `variant`            | Appearance shortcut | Per component: `outlined` / `dashed` / `text` / `link` / `ghost` / `quaternary` / input `filled`, etc.             |\n| `size`               | Control size        | `small` / `medium` / `large` (`sm` / `md` / `lg` aliases); often inherits Config when omitted                      |\n| `disabled`           | Disabled            | Blocks interaction; visuals use `--m-opacity-disabled` and related tokens                                          |\n| `loading`            | Busy                | Common on Button; prevents double submit                                                                           |\n| `fluid`              | Full width          | Stretch to parent width                                                                                            |\n| `status` / `invalid` | Form validation     | e.g. `error` / `warning`; pair with `error-message`                                                                |\n\nBoolean mirrors (`outlined`, `text`, `link`, …) may equal `variant`—pick one. **`severity` colors; `variant` shapes**; they compose (e.g. `severity=\"danger\"` + `outlined`).\n\n## Where class / style / events land\n\nComposite components are not “root = native control”. Three targeting patterns:\n\n| Kind          | Examples         | `class` / `style` / most attrs        | Events `@xxx`         |\n| ------------- | ---------------- | ------------------------------------- | --------------------- |\n| Field         | Input, Select    | Outer field root                      | Inner input / control |\n| Label control | Checkbox, Switch | Visible `<label>`                     | Hidden `<input>`      |\n| Container     | Card, Tabs       | Public root (Dialog `class` on scrim) | Same layer            |\n| Leaf          | Button, Tag      | Interactive element itself            | Same element          |\n\nFull rules and demos: [Attrs](/docs/attrs).\n\n## Semantic DOM and `pt`\n\n**Semantic DOM**: stable structural names in docs for customizable nodes (e.g. Button root / icon / label)—handy for theming and tests.\n\n**`pt` (pass-through)**: merge `class` / `style` / native attrs onto inner DOM by segment key.\n\n```vue\n<MInput\n  label=\"API Key\"\n  :pt=\"{\n    root: { class: 'col-span-2' },\n    input: { class: 'font-mono', autocomplete: 'off' },\n  }\"\n/>\n```\n\nCommon keys:\n\n| Shape                 | `pt` keys                                                                    |\n| --------------------- | ---------------------------------------------------------------------------- |\n| Field                 | `root`, `label`, `input` / `control`; sometimes `prefix` / `suffix` / `help` |\n| Checkbox-like         | `root`, `input`                                                              |\n| Single-root container | `root`                                                                       |\n| Complex               | Extra keys in that component’s docs (e.g. Splitter `gutter`)                 |\n\nTypes: `PassThroughPart`, `FieldPassThrough`, `RootPassThrough`, … in [API types](/docs/types). Same-named `class` / `style` **merge** with existing bindings rather than replace wholesale.\n\nLeaf components such as `MButton` bind `class` on the `<button>` directly; groups like `MButtonGroup` still accept `pt.root`. Structure notes live under each component’s **Semantic DOM** section (example: [Button](/components/Button)).\n\n## Global defaults\n\n`MConfigProvider` / `createMoryaUI` can supply default `size`, `density`, `inputVariant`, `appendTo`, `zIndex`, `locale`, `componentDefaults`, `motion`, and more — see [Configuration](/docs/config). Visual layer remains [Theme](/docs/theme) via `useTheme` / token overrides.\n\n## Do / Don't\n\n| Do                                                     | Don't                                                      |\n| ------------------------------------------------------ | ---------------------------------------------------------- |\n| Keep one `severity` vocabulary across components       | Mix foreign names like `type=\"danger\"` in the same product |\n| Put layout `class` on the field root                   | Expect `class` to fall through onto the inner input        |\n| Use `pt` for prefix / inner tweaks                     | Fork a component to change one class                       |\n| Align Semantic DOM names with BEM (`.m-button__label`) | Invent undocumented `pt` keys                              |\n",
+          "markdown": "---\ntitle: Common Props\norder: 7.5\ndescription: Shared props, Semantic DOM, and pt conventions across components.\n---\n\n# Common Props\n\nMost Morya components share one interaction vocabulary and style targeting model. This page documents morya's own names and semantics. Cross-links: [Conventions](/docs/conventions), [Attrs](/docs/attrs), [API types](/docs/types), [Design tokens](/docs/design-tokens).\n\n## Semantics and appearance\n\n| Prop                 | Meaning             | Common values                                                                                                      |\n| -------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| `severity`           | Semantic color      | Badge / Tag / Alert / Message: `primary` / `secondary` / `success` / `info` / `warning` (`warn`) / `danger` / `contrast` |\n| `type` / `color` / `variant` | Button appearance | Button uses `type` (sugar) + `color` + `variant` (`solid` / `outlined` / `dashed` / `filled` / `text` / `link`); default is `color=default` + `variant=outlined`; solid primary needs `type=\"primary\"` |\n| `size`               | Control size        | `small` / `medium` / `large` (`sm` / `md` / `lg` aliases); often inherits Config when omitted                      |\n| `disabled`           | Disabled            | Blocks interaction; visuals use `--m-opacity-disabled` and related tokens                                          |\n| `loading`            | Busy                | Common on Button; prevents double submit                                                                           |\n| `fluid` / `block`    | Full width          | Most fields use `fluid`; Button / ButtonGroup use `block`                                                          |\n| `status` / `invalid` | Form validation     | e.g. `error` / `warning`; pair with `error-message`                                                                |\n\n**Badge / Tag / Alert**: `severity` sets tone. **Button**: `type` / `color` / `variant` set tone and shape (e.g. `type=\"primary\"`, or `color=\"danger\"` + `variant=\"outlined\"`); solid danger can be `type=\"primary\" danger`.\n\n## Where class / style / events land\n\nComposite components are not “root = native control”. Three targeting patterns:\n\n| Kind          | Examples         | `class` / `style` / most attrs        | Events `@xxx`         |\n| ------------- | ---------------- | ------------------------------------- | --------------------- |\n| Field         | Input, Select    | Outer field root                      | Inner input / control |\n| Label control | Checkbox, Switch | Visible `<label>`                     | Hidden `<input>`      |\n| Container     | Card, Tabs       | Public root (Dialog `class` on scrim) | Same layer            |\n| Leaf          | Button, Tag      | Interactive element itself            | Same element          |\n\nFull rules and demos: [Attrs](/docs/attrs).\n\n## Semantic DOM and `pt`\n\n**Semantic DOM**: stable structural names in docs for customizable nodes (e.g. Button root / icon / label)—handy for theming and tests.\n\n**`pt` (pass-through)**: merge `class` / `style` / native attrs onto inner DOM by segment key.\n\n```vue\n<MInput\n  label=\"API Key\"\n  :pt=\"{\n    root: { class: 'col-span-2' },\n    input: { class: 'font-mono', autocomplete: 'off' },\n  }\"\n/>\n```\n\nCommon keys:\n\n| Shape                 | `pt` keys                                                                    |\n| --------------------- | ---------------------------------------------------------------------------- |\n| Field                 | `root`, `label`, `input` / `control`; sometimes `prefix` / `suffix` / `help` |\n| Checkbox-like         | `root`, `input`                                                              |\n| Single-root container | `root`                                                                       |\n| Complex               | Extra keys in that component’s docs (e.g. Splitter `gutter`)                 |\n\nTypes: `PassThroughPart`, `FieldPassThrough`, `RootPassThrough`, … in [API types](/docs/types). Same-named `class` / `style` **merge** with existing bindings rather than replace wholesale.\n\nLeaf components such as `MButton` bind `class` on the `<button>` directly; groups like `MButtonGroup` still accept `pt.root`. Structure notes live under each component’s **Semantic DOM** section (example: [Button](/components/Button)).\n\n## Global defaults\n\n`MConfigProvider` / `createMoryaUI` can supply default `size`, `density`, `inputVariant`, `appendTo`, `zIndex`, `locale`, `componentDefaults`, `motion`, and more — see [Configuration](/docs/config). Visual layer remains [Theme](/docs/theme) via `useTheme` / token overrides.\n\n## Do / Don't\n\n| Do                                                     | Don't                                                      |\n| ------------------------------------------------------ | ---------------------------------------------------------- |\n| Use `severity` on Badge / Tag / Alert; `type` / `color` / `variant` on Button | Keep removed Button props (`severity` / `fluid` / boolean `outlined`) |\n| Put layout `class` on the field root                   | Expect `class` to fall through onto the inner input        |\n| Use `pt` for prefix / inner tweaks                     | Fork a component to change one class                       |\n| Align Semantic DOM names with BEM (`.m-button__label`) | Invent undocumented `pt` keys                              |\n",
           "sections": [
             {
               "title": "",
@@ -32687,7 +32920,7 @@
             {
               "title": "Semantics and appearance",
               "id": "semantics-and-appearance",
-              "body": "| Prop                 | Meaning             | Common values                                                                                                      |\n| -------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| `severity`           | Semantic color      | `primary` (often omitted) / `secondary` / `success` / `info` / `warning` (`warn`) / `help` / `danger` / `contrast` |\n| `variant`            | Appearance shortcut | Per component: `outlined` / `dashed` / `text` / `link` / `ghost` / `quaternary` / input `filled`, etc.             |\n| `size`               | Control size        | `small` / `medium` / `large` (`sm` / `md` / `lg` aliases); often inherits Config when omitted                      |\n| `disabled`           | Disabled            | Blocks interaction; visuals use `--m-opacity-disabled` and related tokens                                          |\n| `loading`            | Busy                | Common on Button; prevents double submit                                                                           |\n| `fluid`              | Full width          | Stretch to parent width                                                                                            |\n| `status` / `invalid` | Form validation     | e.g. `error` / `warning`; pair with `error-message`                                                                |\n\nBoolean mirrors (`outlined`, `text`, `link`, …) may equal `variant`—pick one. **`severity` colors; `variant` shapes**; they compose (e.g. `severity=\"danger\"` + `outlined`)."
+              "body": "| Prop                 | Meaning             | Common values                                                                                                      |\n| -------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| `severity`           | Semantic color      | Badge / Tag / Alert / Message: `primary` / `secondary` / `success` / `info` / `warning` (`warn`) / `danger` / `contrast` |\n| `type` / `color` / `variant` | Button appearance | Button uses `type` (sugar) + `color` + `variant` (`solid` / `outlined` / `dashed` / `filled` / `text` / `link`); default is `color=default` + `variant=outlined`; solid primary needs `type=\"primary\"` |\n| `size`               | Control size        | `small` / `medium` / `large` (`sm` / `md` / `lg` aliases); often inherits Config when omitted                      |\n| `disabled`           | Disabled            | Blocks interaction; visuals use `--m-opacity-disabled` and related tokens                                          |\n| `loading`            | Busy                | Common on Button; prevents double submit                                                                           |\n| `fluid` / `block`    | Full width          | Most fields use `fluid`; Button / ButtonGroup use `block`                                                          |\n| `status` / `invalid` | Form validation     | e.g. `error` / `warning`; pair with `error-message`                                                                |\n\n**Badge / Tag / Alert**: `severity` sets tone. **Button**: `type` / `color` / `variant` set tone and shape (e.g. `type=\"primary\"`, or `color=\"danger\"` + `variant=\"outlined\"`); solid danger can be `type=\"primary\" danger`."
             },
             {
               "title": "Where class / style / events land",
@@ -32707,7 +32940,7 @@
             {
               "title": "Do / Don't",
               "id": "do-don-t",
-              "body": "| Do                                                     | Don't                                                      |\n| ------------------------------------------------------ | ---------------------------------------------------------- |\n| Keep one `severity` vocabulary across components       | Mix foreign names like `type=\"danger\"` in the same product |\n| Put layout `class` on the field root                   | Expect `class` to fall through onto the inner input        |\n| Use `pt` for prefix / inner tweaks                     | Fork a component to change one class                       |\n| Align Semantic DOM names with BEM (`.m-button__label`) | Invent undocumented `pt` keys                              |"
+              "body": "| Do                                                     | Don't                                                      |\n| ------------------------------------------------------ | ---------------------------------------------------------- |\n| Use `severity` on Badge / Tag / Alert; `type` / `color` / `variant` on Button | Keep removed Button props (`severity` / `fluid` / boolean `outlined`) |\n| Put layout `class` on the field root                   | Expect `class` to fall through onto the inner input        |\n| Use `pt` for prefix / inner tweaks                     | Fork a component to change one class                       |\n| Align Semantic DOM names with BEM (`.m-button__label`) | Invent undocumented `pt` keys                              |"
             }
           ]
         }
@@ -32724,24 +32957,24 @@
         "zh-CN": {
           "title": "API 类型",
           "description": "文档 Props 里常见类型名的结构与含义。",
-          "markdown": "---\ntitle: API 类型\norder: 8\ndescription: 文档 Props 里常见类型名的结构与含义。\n---\n\n# API 类型\n\n组件文档 Props 表里出现的类型名，在这里查具体结构。包入口也导出同名类型，可在业务代码里 `import type { … } from 'morya-ui'`（以各组件 `types.ts` 为准）。\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\n单个 DOM 节点上要合并的属性 bag。`pt.<part>` 的值就是这个类型。\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\n常用键：`class`、`style`、`data-*`、`onClick` / `onKeydown`（Vue 事件监听写法）、以及该节点合法的原生 HTML 属性。\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\n单根容器（Card、Dialog 遮罩、Tabs 等）：\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch（可见根是 `<label>`，hidden input 单独一段）：\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // 一般是 label\n  input?: PassThroughPart  // 原生 input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\n表单字段（Input、Select、DatePicker 等）：\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // 外层 .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // 触发器 / 组合控件（Select 等）\n  input?: PassThroughPart   // 原生 input / textarea\n}\n```\n\n具体组件支持哪些键，见该组件文档的 **类型** 或 **pt** 小节。\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) 在 `FieldPassThrough` 基础上多了前后缀等：\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) 在 `RootPassThrough` 上增加分隔条与面板：\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\n分隔条外观也可用 `resizeTriggerClass` / `resizeTriggerStyle`，内容用 `#resize-trigger`（别名 `#gutter`）。\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\n控件尺寸，多数表单 / 按钮组件的 `size` prop：\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` 为兼容别名；未传时通常继承 [ConfigProvider](/docs/config) 的 `size`。\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n输入框视觉变体：\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonSeverity\">ButtonSeverity</h3>\n\n按钮语义色（[`Button`](/components/Button)、Dialog 页脚等）：\n\n```ts\ntype ButtonSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'   // 'warn' 为别名\n  | 'help'\n  | 'danger'\n  | 'contrast'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\n浮层 Teleport 挂载目标（Dialog、Select 菜单、Toast 等）：\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'`（默认）：挂到 document.body  \n- `'self'`：不 Teleport，就地渲染  \n- 也常见 `appendTo: false`（运行时兼容，同 `'self'`）\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\n关闭 / 确认前的拦截函数。返回 `false`（含 Promise 解析为 `false`）则**不继续**：\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\n用于 Dialog `beforeClose`、`onPositiveClick`，ConfirmDialog / ConfirmPopup 的 `beforeAccept` 等。\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) 选项项：\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) 选项分组（混入 `options` 渲染分组标题行）：\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\n单选为标量；`multiple` 时为数组。\n\n<h3 id=\"IconName\">IconName</h3>\n\n[`MIcon`](/components/Icon) / [`Button`](/components/Button) 的 `icon` / `name` 使用的注册名，例如 `'search'`、`'chevron-down'`。完整列表见 Icon 文档注册表。\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nMenu / Dropdown / ContextMenu 等导航项的公共字段：\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nMessage、Tag 等的状态色：\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\n更细的组件专属类型（如 `TableServerOptions`、`MenuItem`）写在对应组件页 **类型** 小节；这里只列跨组件复用的名字。\n",
+          "markdown": "---\ntitle: API 类型\norder: 8\ndescription: 文档 Props 里常见类型名的结构与含义。\n---\n\n# API 类型\n\n组件文档 Props 表里出现的类型名，在这里查具体结构。包入口也导出同名类型，可在业务代码里 `import type { … } from 'morya-ui'`（以各组件 `types.ts` 为准）。\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\n单个 DOM 节点上要合并的属性 bag。`pt.<part>` 的值就是这个类型。\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\n常用键：`class`、`style`、`data-*`、`onClick` / `onKeydown`（Vue 事件监听写法）、以及该节点合法的原生 HTML 属性。\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\n单根容器（Card、Dialog 遮罩、Tabs 等）：\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch（可见根是 `<label>`，hidden input 单独一段）：\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // 一般是 label\n  input?: PassThroughPart  // 原生 input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\n表单字段（Input、Select、DatePicker 等）：\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // 外层 .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // 触发器 / 组合控件（Select 等）\n  input?: PassThroughPart   // 原生 input / textarea\n}\n```\n\n具体组件支持哪些键，见该组件文档的 **类型** 或 **pt** 小节。\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) 在 `FieldPassThrough` 基础上多了前后缀等：\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) 在 `RootPassThrough` 上增加分隔条与面板：\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\n分隔条外观也可用 `resizeTriggerClass` / `resizeTriggerStyle`，内容用 `#resize-trigger`（别名 `#gutter`）。\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\n控件尺寸，多数表单 / 按钮组件的 `size` prop：\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` 为兼容别名；未传时通常继承 [ConfigProvider](/docs/config) 的 `size`。\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n输入框视觉变体：\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonType\">ButtonType</h3>\n\n按钮类型糖（[`Button`](/components/Button)）：\n\n```ts\ntype ButtonType = 'default' | 'primary' | 'dashed' | 'link' | 'text'\n```\n\n<h3 id=\"ButtonColor\">ButtonColor</h3>\n\n按钮颜色轴（Button、ConfirmDialog `acceptColor`、Dialog `positiveColor` 等）：\n\n```ts\ntype ButtonColor =\n  | 'default'\n  | 'primary'\n  | 'danger'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'help'\n  | 'contrast'\n  | 'link'\n```\n\n<h3 id=\"ButtonVariant\">ButtonVariant</h3>\n\n按钮变体轴：\n\n```ts\ntype ButtonVariant = 'solid' | 'outlined' | 'dashed' | 'filled' | 'text' | 'link'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\n浮层 Teleport 挂载目标（Dialog、Select 菜单、Toast 等）：\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'`（默认）：挂到 document.body  \n- `'self'`：不 Teleport，就地渲染  \n- 也常见 `appendTo: false`（运行时兼容，同 `'self'`）\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\n关闭 / 确认前的拦截函数。返回 `false`（含 Promise 解析为 `false`）则**不继续**：\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\n用于 Dialog `beforeClose`、`onPositiveClick`，ConfirmDialog / ConfirmPopup 的 `beforeAccept` 等。\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) 选项项：\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) 选项分组（混入 `options` 渲染分组标题行）：\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\n单选为标量；`multiple` 时为数组。\n\n<h3 id=\"IconName\">IconName</h3>\n\n[`MIcon`](/components/Icon) / [`Button`](/components/Button) 的 `icon` / `name` 使用的注册名，例如 `'search'`、`'chevron-down'`。完整列表见 Icon 文档注册表。\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nMenu / Dropdown / ContextMenu 等导航项的公共字段：\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nMessage、Tag 等的状态色：\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\n更细的组件专属类型（如 `TableServerOptions`、`MenuItem`）写在对应组件页 **类型** 小节；这里只列跨组件复用的名字。\n",
           "sections": [
             {
               "title": "",
               "id": "overview",
-              "body": "# API 类型\n\n组件文档 Props 表里出现的类型名，在这里查具体结构。包入口也导出同名类型，可在业务代码里 `import type { … } from 'morya-ui'`（以各组件 `types.ts` 为准）。\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\n单个 DOM 节点上要合并的属性 bag。`pt.<part>` 的值就是这个类型。\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\n常用键：`class`、`style`、`data-*`、`onClick` / `onKeydown`（Vue 事件监听写法）、以及该节点合法的原生 HTML 属性。\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\n单根容器（Card、Dialog 遮罩、Tabs 等）：\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch（可见根是 `<label>`，hidden input 单独一段）：\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // 一般是 label\n  input?: PassThroughPart  // 原生 input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\n表单字段（Input、Select、DatePicker 等）：\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // 外层 .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // 触发器 / 组合控件（Select 等）\n  input?: PassThroughPart   // 原生 input / textarea\n}\n```\n\n具体组件支持哪些键，见该组件文档的 **类型** 或 **pt** 小节。\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) 在 `FieldPassThrough` 基础上多了前后缀等：\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) 在 `RootPassThrough` 上增加分隔条与面板：\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\n分隔条外观也可用 `resizeTriggerClass` / `resizeTriggerStyle`，内容用 `#resize-trigger`（别名 `#gutter`）。\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\n控件尺寸，多数表单 / 按钮组件的 `size` prop：\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` 为兼容别名；未传时通常继承 [ConfigProvider](/docs/config) 的 `size`。\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n输入框视觉变体：\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonSeverity\">ButtonSeverity</h3>\n\n按钮语义色（[`Button`](/components/Button)、Dialog 页脚等）：\n\n```ts\ntype ButtonSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'   // 'warn' 为别名\n  | 'help'\n  | 'danger'\n  | 'contrast'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\n浮层 Teleport 挂载目标（Dialog、Select 菜单、Toast 等）：\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'`（默认）：挂到 document.body  \n- `'self'`：不 Teleport，就地渲染  \n- 也常见 `appendTo: false`（运行时兼容，同 `'self'`）\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\n关闭 / 确认前的拦截函数。返回 `false`（含 Promise 解析为 `false`）则**不继续**：\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\n用于 Dialog `beforeClose`、`onPositiveClick`，ConfirmDialog / ConfirmPopup 的 `beforeAccept` 等。\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) 选项项：\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) 选项分组（混入 `options` 渲染分组标题行）：\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\n单选为标量；`multiple` 时为数组。\n\n<h3 id=\"IconName\">IconName</h3>\n\n[`MIcon`](/components/Icon) / [`Button`](/components/Button) 的 `icon` / `name` 使用的注册名，例如 `'search'`、`'chevron-down'`。完整列表见 Icon 文档注册表。\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nMenu / Dropdown / ContextMenu 等导航项的公共字段：\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nMessage、Tag 等的状态色：\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\n更细的组件专属类型（如 `TableServerOptions`、`MenuItem`）写在对应组件页 **类型** 小节；这里只列跨组件复用的名字。"
+              "body": "# API 类型\n\n组件文档 Props 表里出现的类型名，在这里查具体结构。包入口也导出同名类型，可在业务代码里 `import type { … } from 'morya-ui'`（以各组件 `types.ts` 为准）。\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\n单个 DOM 节点上要合并的属性 bag。`pt.<part>` 的值就是这个类型。\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\n常用键：`class`、`style`、`data-*`、`onClick` / `onKeydown`（Vue 事件监听写法）、以及该节点合法的原生 HTML 属性。\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\n单根容器（Card、Dialog 遮罩、Tabs 等）：\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch（可见根是 `<label>`，hidden input 单独一段）：\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // 一般是 label\n  input?: PassThroughPart  // 原生 input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\n表单字段（Input、Select、DatePicker 等）：\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // 外层 .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // 触发器 / 组合控件（Select 等）\n  input?: PassThroughPart   // 原生 input / textarea\n}\n```\n\n具体组件支持哪些键，见该组件文档的 **类型** 或 **pt** 小节。\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) 在 `FieldPassThrough` 基础上多了前后缀等：\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) 在 `RootPassThrough` 上增加分隔条与面板：\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\n分隔条外观也可用 `resizeTriggerClass` / `resizeTriggerStyle`，内容用 `#resize-trigger`（别名 `#gutter`）。\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\n控件尺寸，多数表单 / 按钮组件的 `size` prop：\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` 为兼容别名；未传时通常继承 [ConfigProvider](/docs/config) 的 `size`。\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n输入框视觉变体：\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonType\">ButtonType</h3>\n\n按钮类型糖（[`Button`](/components/Button)）：\n\n```ts\ntype ButtonType = 'default' | 'primary' | 'dashed' | 'link' | 'text'\n```\n\n<h3 id=\"ButtonColor\">ButtonColor</h3>\n\n按钮颜色轴（Button、ConfirmDialog `acceptColor`、Dialog `positiveColor` 等）：\n\n```ts\ntype ButtonColor =\n  | 'default'\n  | 'primary'\n  | 'danger'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'help'\n  | 'contrast'\n  | 'link'\n```\n\n<h3 id=\"ButtonVariant\">ButtonVariant</h3>\n\n按钮变体轴：\n\n```ts\ntype ButtonVariant = 'solid' | 'outlined' | 'dashed' | 'filled' | 'text' | 'link'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\n浮层 Teleport 挂载目标（Dialog、Select 菜单、Toast 等）：\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'`（默认）：挂到 document.body  \n- `'self'`：不 Teleport，就地渲染  \n- 也常见 `appendTo: false`（运行时兼容，同 `'self'`）\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\n关闭 / 确认前的拦截函数。返回 `false`（含 Promise 解析为 `false`）则**不继续**：\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\n用于 Dialog `beforeClose`、`onPositiveClick`，ConfirmDialog / ConfirmPopup 的 `beforeAccept` 等。\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) 选项项：\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) 选项分组（混入 `options` 渲染分组标题行）：\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\n单选为标量；`multiple` 时为数组。\n\n<h3 id=\"IconName\">IconName</h3>\n\n[`MIcon`](/components/Icon) / [`Button`](/components/Button) 的 `icon` / `name` 使用的注册名，例如 `'search'`、`'chevron-down'`。完整列表见 Icon 文档注册表。\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nMenu / Dropdown / ContextMenu 等导航项的公共字段：\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nMessage、Tag 等的状态色：\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\n更细的组件专属类型（如 `TableServerOptions`、`MenuItem`）写在对应组件页 **类型** 小节；这里只列跨组件复用的名字。"
             }
           ]
         },
         "en-US": {
           "title": "API types",
           "description": "Shapes behind type names in component Props tables.",
-          "markdown": "---\ntitle: API types\norder: 8\ndescription: Shapes behind type names in component Props tables.\n---\n\n# API types\n\nLook up structures for names that appear in Props tables. The package re-exports the same names as TypeScript types (`import type { … } from 'morya-ui'`), per component `types.ts`.\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\nAttribute bag merged onto one DOM node—the value of `pt.<part>`.\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\nCommon keys: `class`, `style`, `data-*`, `onClick` / `onKeydown`, and valid native attributes for that element.\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\nSingle-root containers (Card, Dialog backdrop, Tabs, …):\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch (visible `<label>` root + hidden input):\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // usually the label\n  input?: PassThroughPart  // native input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\nForm fields (Input, Select, DatePicker, …):\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // outer .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // trigger / composite control\n  input?: PassThroughPart   // native input / textarea\n}\n```\n\nWhich keys a component accepts is listed on that component’s **Types** or **pt** section.\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) extends `FieldPassThrough` with affixes:\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) extends `RootPassThrough` with gutter and panes:\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\nGutter look can also use `resizeTriggerClass` / `resizeTriggerStyle`; content goes in `#resize-trigger` (alias `#gutter`).\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\nControl size for many form / button props:\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` are legacy aliases. Omitted `size` usually inherits [ConfigProvider](/docs/config).\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonSeverity\">ButtonSeverity</h3>\n\nButton / dialog footer tones:\n\n```ts\ntype ButtonSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'   // alias: 'warn'\n  | 'help'\n  | 'danger'\n  | 'contrast'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\nOverlay Teleport target:\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'` (default)  \n- `'self'` — render in place (no Teleport)  \n- `false` is accepted at runtime (same idea as `'self'`)\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\nGuard before close / confirm. Return `false` (including from a Promise) to **abort**:\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\nUsed by Dialog `beforeClose`, ConfirmDialog `beforeAccept`, and similar.\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) option row:\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) option group (mix into `options` to render a group header row):\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\nScalar when single-select; array when `multiple`.\n\n<h3 id=\"IconName\">IconName</h3>\n\nRegistered icon id for [`MIcon`](/components/Icon) / [`Button`](/components/Button), e.g. `'search'`. See the Icon registry.\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nShared fields for Menu / Dropdown / ContextMenu items:\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nStatus tone for Message, Tag, etc.:\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\nComponent-only types (`TableServerOptions`, `MenuItem`, …) live under each component’s **Types** section; this page is for shared names only.\n",
+          "markdown": "---\ntitle: API types\norder: 8\ndescription: Shapes behind type names in component Props tables.\n---\n\n# API types\n\nLook up structures for names that appear in Props tables. The package re-exports the same names as TypeScript types (`import type { … } from 'morya-ui'`), per component `types.ts`.\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\nAttribute bag merged onto one DOM node—the value of `pt.<part>`.\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\nCommon keys: `class`, `style`, `data-*`, `onClick` / `onKeydown`, and valid native attributes for that element.\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\nSingle-root containers (Card, Dialog backdrop, Tabs, …):\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch (visible `<label>` root + hidden input):\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // usually the label\n  input?: PassThroughPart  // native input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\nForm fields (Input, Select, DatePicker, …):\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // outer .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // trigger / composite control\n  input?: PassThroughPart   // native input / textarea\n}\n```\n\nWhich keys a component accepts is listed on that component’s **Types** or **pt** section.\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) extends `FieldPassThrough` with affixes:\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) extends `RootPassThrough` with gutter and panes:\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\nGutter look can also use `resizeTriggerClass` / `resizeTriggerStyle`; content goes in `#resize-trigger` (alias `#gutter`).\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\nControl size for many form / button props:\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` are legacy aliases. Omitted `size` usually inherits [ConfigProvider](/docs/config).\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonType\">ButtonType</h3>\n\nButton type sugar ([`Button`](/components/Button)):\n\n```ts\ntype ButtonType = 'default' | 'primary' | 'dashed' | 'link' | 'text'\n```\n\n<h3 id=\"ButtonColor\">ButtonColor</h3>\n\nButton color axis (Button, ConfirmDialog `acceptColor`, Dialog `positiveColor`, …):\n\n```ts\ntype ButtonColor =\n  | 'default'\n  | 'primary'\n  | 'danger'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'help'\n  | 'contrast'\n  | 'link'\n```\n\n<h3 id=\"ButtonVariant\">ButtonVariant</h3>\n\nButton variant axis:\n\n```ts\ntype ButtonVariant = 'solid' | 'outlined' | 'dashed' | 'filled' | 'text' | 'link'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\nOverlay Teleport target:\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'` (default)  \n- `'self'` — render in place (no Teleport)  \n- `false` is accepted at runtime (same idea as `'self'`)\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\nGuard before close / confirm. Return `false` (including from a Promise) to **abort**:\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\nUsed by Dialog `beforeClose`, ConfirmDialog `beforeAccept`, and similar.\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) option row:\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) option group (mix into `options` to render a group header row):\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\nScalar when single-select; array when `multiple`.\n\n<h3 id=\"IconName\">IconName</h3>\n\nRegistered icon id for [`MIcon`](/components/Icon) / [`Button`](/components/Button), e.g. `'search'`. See the Icon registry.\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nShared fields for Menu / Dropdown / ContextMenu items:\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nStatus tone for Message, Tag, etc.:\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\nComponent-only types (`TableServerOptions`, `MenuItem`, …) live under each component’s **Types** section; this page is for shared names only.\n",
           "sections": [
             {
               "title": "",
               "id": "overview",
-              "body": "# API types\n\nLook up structures for names that appear in Props tables. The package re-exports the same names as TypeScript types (`import type { … } from 'morya-ui'`), per component `types.ts`.\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\nAttribute bag merged onto one DOM node—the value of `pt.<part>`.\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\nCommon keys: `class`, `style`, `data-*`, `onClick` / `onKeydown`, and valid native attributes for that element.\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\nSingle-root containers (Card, Dialog backdrop, Tabs, …):\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch (visible `<label>` root + hidden input):\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // usually the label\n  input?: PassThroughPart  // native input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\nForm fields (Input, Select, DatePicker, …):\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // outer .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // trigger / composite control\n  input?: PassThroughPart   // native input / textarea\n}\n```\n\nWhich keys a component accepts is listed on that component’s **Types** or **pt** section.\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) extends `FieldPassThrough` with affixes:\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) extends `RootPassThrough` with gutter and panes:\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\nGutter look can also use `resizeTriggerClass` / `resizeTriggerStyle`; content goes in `#resize-trigger` (alias `#gutter`).\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\nControl size for many form / button props:\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` are legacy aliases. Omitted `size` usually inherits [ConfigProvider](/docs/config).\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonSeverity\">ButtonSeverity</h3>\n\nButton / dialog footer tones:\n\n```ts\ntype ButtonSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'   // alias: 'warn'\n  | 'help'\n  | 'danger'\n  | 'contrast'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\nOverlay Teleport target:\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'` (default)  \n- `'self'` — render in place (no Teleport)  \n- `false` is accepted at runtime (same idea as `'self'`)\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\nGuard before close / confirm. Return `false` (including from a Promise) to **abort**:\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\nUsed by Dialog `beforeClose`, ConfirmDialog `beforeAccept`, and similar.\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) option row:\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) option group (mix into `options` to render a group header row):\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\nScalar when single-select; array when `multiple`.\n\n<h3 id=\"IconName\">IconName</h3>\n\nRegistered icon id for [`MIcon`](/components/Icon) / [`Button`](/components/Button), e.g. `'search'`. See the Icon registry.\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nShared fields for Menu / Dropdown / ContextMenu items:\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nStatus tone for Message, Tag, etc.:\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\nComponent-only types (`TableServerOptions`, `MenuItem`, …) live under each component’s **Types** section; this page is for shared names only."
+              "body": "# API types\n\nLook up structures for names that appear in Props tables. The package re-exports the same names as TypeScript types (`import type { … } from 'morya-ui'`), per component `types.ts`.\n\n<h3 id=\"PassThroughPart\">PassThroughPart</h3>\n\nAttribute bag merged onto one DOM node—the value of `pt.<part>`.\n\n```ts\ntype PassThroughPart = Record<string, unknown>\n```\n\nCommon keys: `class`, `style`, `data-*`, `onClick` / `onKeydown`, and valid native attributes for that element.\n\n<h3 id=\"RootPassThrough\">RootPassThrough</h3>\n\nSingle-root containers (Card, Dialog backdrop, Tabs, …):\n\n```ts\ninterface RootPassThrough {\n  root?: PassThroughPart\n}\n```\n\n<h3 id=\"ControlPassThrough\">ControlPassThrough</h3>\n\nCheckbox / Radio / Switch (visible `<label>` root + hidden input):\n\n```ts\ninterface ControlPassThrough {\n  root?: PassThroughPart   // usually the label\n  input?: PassThroughPart  // native input\n}\n```\n\n<h3 id=\"FieldPassThrough\">FieldPassThrough</h3>\n\nForm fields (Input, Select, DatePicker, …):\n\n```ts\ninterface FieldPassThrough {\n  root?: PassThroughPart    // outer .m-*-field\n  label?: PassThroughPart\n  control?: PassThroughPart // trigger / composite control\n  input?: PassThroughPart   // native input / textarea\n}\n```\n\nWhich keys a component accepts is listed on that component’s **Types** or **pt** section.\n\n<h3 id=\"InputPassThrough\">InputPassThrough</h3>\n\n[`Input`](/components/Input) extends `FieldPassThrough` with affixes:\n\n```ts\ntype InputPassThrough = FieldPassThrough & {\n  prefix?: PassThroughPart\n  suffix?: PassThroughPart\n  help?: PassThroughPart\n  count?: PassThroughPart\n}\n```\n\n<h3 id=\"SplitterPassThrough\">SplitterPassThrough</h3>\n\n[`Splitter`](/components/Splitter) extends `RootPassThrough` with gutter and panes:\n\n```ts\ntype SplitterPassThrough = RootPassThrough & {\n  gutter?: PassThroughPart\n  panel1?: PassThroughPart\n  panel2?: PassThroughPart\n}\n```\n\nGutter look can also use `resizeTriggerClass` / `resizeTriggerStyle`; content goes in `#resize-trigger` (alias `#gutter`).\n\n<h3 id=\"MSizeInput\">MSizeInput</h3>\n\nControl size for many form / button props:\n\n```ts\ntype MSizeInput = 'small' | 'medium' | 'large' | 'sm' | 'md' | 'lg'\n```\n\n`sm` / `md` / `lg` are legacy aliases. Omitted `size` usually inherits [ConfigProvider](/docs/config).\n\n<h3 id=\"MInputVariant\">MInputVariant</h3>\n\n```ts\ntype MInputVariant = 'outlined' | 'filled'\n```\n\n<h3 id=\"ButtonType\">ButtonType</h3>\n\nButton type sugar ([`Button`](/components/Button)):\n\n```ts\ntype ButtonType = 'default' | 'primary' | 'dashed' | 'link' | 'text'\n```\n\n<h3 id=\"ButtonColor\">ButtonColor</h3>\n\nButton color axis (Button, ConfirmDialog `acceptColor`, Dialog `positiveColor`, …):\n\n```ts\ntype ButtonColor =\n  | 'default'\n  | 'primary'\n  | 'danger'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'help'\n  | 'contrast'\n  | 'link'\n```\n\n<h3 id=\"ButtonVariant\">ButtonVariant</h3>\n\nButton variant axis:\n\n```ts\ntype ButtonVariant = 'solid' | 'outlined' | 'dashed' | 'filled' | 'text' | 'link'\n```\n\n<h3 id=\"MAppendTo\">MAppendTo</h3>\n\nOverlay Teleport target:\n\n```ts\ntype MAppendTo = string | HTMLElement | 'self'\n```\n\n- `'body'` (default)  \n- `'self'` — render in place (no Teleport)  \n- `false` is accepted at runtime (same idea as `'self'`)\n\n<h3 id=\"AsyncGuard\">AsyncGuard</h3>\n\nGuard before close / confirm. Return `false` (including from a Promise) to **abort**:\n\n```ts\ntype AsyncGuard<T extends unknown[] = []> = (\n  ...args: T\n) => unknown | Promise<unknown>\n```\n\nUsed by Dialog `beforeClose`, ConfirmDialog `beforeAccept`, and similar.\n\n<h3 id=\"SelectOption\">SelectOption</h3>\n\n[`Select`](/components/Select) option row:\n\n```ts\ninterface SelectOption {\n  label: string\n  value: string | number\n  disabled?: boolean\n}\n```\n\n<h3 id=\"SelectOptionGroup\">SelectOptionGroup</h3>\n\n[`Select`](/components/Select) option group (mix into `options` to render a group header row):\n\n```ts\ninterface SelectOptionGroup {\n  label: string\n  items: SelectOption[]\n}\n```\n\n<h3 id=\"SelectModelValue\">SelectModelValue</h3>\n\n```ts\ntype SelectValue = string | number\ntype SelectModelValue = SelectValue | SelectValue[] | undefined\n```\n\nScalar when single-select; array when `multiple`.\n\n<h3 id=\"IconName\">IconName</h3>\n\nRegistered icon id for [`MIcon`](/components/Icon) / [`Button`](/components/Button), e.g. `'search'`. See the Icon registry.\n\n<h3 id=\"MenuNodeBase\">MenuNodeBase</h3>\n\nShared fields for Menu / Dropdown / ContextMenu items:\n\n```ts\ninterface MenuNodeBase {\n  key?: string\n  label?: string\n  value?: string\n  icon?: string\n  disabled?: boolean\n  separator?: boolean\n  shortcut?: string\n  command?: () => void\n  items?: MenuNodeBase[]\n}\n```\n\n<h3 id=\"MSeverity\">MSeverity</h3>\n\nStatus tone for Message, Tag, etc.:\n\n```ts\ntype MSeverity =\n  | 'primary'\n  | 'secondary'\n  | 'success'\n  | 'info'\n  | 'warning'\n  | 'danger'\n  | 'contrast'\n```\n\n---\n\nComponent-only types (`TableServerOptions`, `MenuItem`, …) live under each component’s **Types** section; this page is for shared names only."
             }
           ]
         }
@@ -33342,7 +33575,7 @@
         "zh-CN": {
           "title": "Agent MCP",
           "description": "可选的 MCP 服务，供支持 Model Context Protocol 的 AI 客户端检索本库文档。",
-          "markdown": "---\ntitle: Agent MCP\norder: 14\ndescription: 可选的 MCP 服务，供支持 Model Context Protocol 的 AI 客户端检索本库文档。\n---\n\n# Agent MCP\n\n[`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) 是可选的 [Model Context Protocol](https://modelcontextprotocol.io/)（stdio）服务。它把本站组件文档、示例与指南做成可检索工具，方便 **支持 MCP 的 AI 客户端** 按真实 API 生成代码。\n\n日常使用组件库 **不需要** 安装或配置 MCP。应用里仍然只依赖：\n\n```bash\npnpm add morya-ui\n```\n\n```ts\nimport 'morya-ui/styles.css'\n```\n\n若要连同 Agent Skill、规则与多编辑器 MCP 一起装好，见 [一键接入](/docs/setup)（默认写入 Cursor / VS Code / Zed 与 `.mcp.json`）；AI 流程见 [AI 接入](/docs/ai-setup)；Skill 本身说明见 [Agent Skill](/docs/agent-skill)。\n\n## 接入方式\n\nMCP 客户端通过 stdio 启动本包即可：\n\n```bash\nnpx -y @morya-ui/mcp\n```\n\n通用写法：\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@morya-ui/mcp\"]\n}\n```\n\n字段名因客户端而异，只要支持 MCP stdio 即可接入。\n\n### 常见客户端配置示例\n\n以下为常见产品的配置片段，键名可能随版本变化，以各产品官方文档为准。\n\n**Cursor**（`.cursor/mcp.json` 或用户级 MCP 配置；setup 会写入）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**VS Code**（工作区 `.vscode/mcp.json`；setup 会写入）：\n\n```json\n{\n  \"servers\": {\n    \"morya-ui\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**便携**（项目根 `.mcp.json`；setup 会写入，供 Agent Host / 跨工具发现）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Claude Desktop / Claude Code**（`claude_desktop_config.json` 等；需手写，setup 不自动写）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Windsurf**（MCP 设置中的 servers 配置）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Cline**（VS Code 扩展设置中的 MCP servers）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Zed**（项目 `.zed/settings.json` → `context_servers`；setup 会合并写入）：\n\n```json\n{\n  \"context_servers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Continue**（`config.json` / YAML 中的 MCP servers，字段名以当前版本为准）：\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"morya-ui\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  ]\n}\n```\n\n## 可用工具\n\n### 基础 — 查组件文档\n\n| 工具 | 作用 |\n| --- | --- |\n| `list` | 列出组件 / 指南 / 示例 / 分类 / 页面模式 |\n| `search` | 搜索文档、示例、页面模式与组件选型指南 |\n| `get_component` | 读取组件说明与 API |\n| `get_example` | 获取源码示例 |\n| `get_guide` | 读取指南 |\n| `get_setup` | 安装与初始化说明 |\n| `validate_usage` | 对照文档粗检 props / events 用法 |\n| `version` | 版本与目录状态 |\n\n### 高级 — 页面组合（可选）\n\n| 工具 | 作用 |\n| --- | --- |\n| `list_patterns` | 列出可复用的页面组合模式 |\n| `get_pattern` | 读取模式的结构、布局与交互规则 |\n| `recommend_page` | 根据页面意图推荐模式；可附带 starter 脚手架 |\n| `get_design_rules` | 设计令牌与 MPage* 组合配方 |\n| `recommend_component` | 列出、阅读或推荐组件选型指南 |\n| `list_golden_pages` | 列出黄金样例页面 |\n| `get_golden_page` | 读取黄金样例 Vue 源码（含 settings / wizard / result / detail / form-in-dialog 等；`includeScaffold` 有样例时返回样例源码） |\n| `list_page_snippets` | 列出可复用的页面区块 snippet |\n| `get_page_snippet` | 读取局部区块 snippet（筛选区、工具栏等） |\n| `validate_page` | 校验页面组合、间距、双边框，以及 rows / message / MStatus 等契约 |\n\n多数工具支持 `mode`：`zh`（默认）或 `en`。\n\n### 推荐工作流\n\n**查单个组件：** `search` / `get_component` → `get_example` → `validate_usage`\n\n**规划整页：** `recommend_page` → `get_golden_page` → `get_pattern` → `get_design_rules` → `get_component` / `get_example` → **`validate_usage`** → `validate_page`\n\n**改局部区块：** `get_page_snippet(section)` → `get_component` / `get_example` → `validate_usage` → `validate_page`\n\n需要 starter 代码时，给 `recommend_page` 传 `includeScaffold: true`（有黄金样例时返回样例源码，不是另一套模板）：\n\n```json\n{\n  \"intent\": \"油井管理列表\",\n  \"pageType\": \"list\",\n  \"features\": [\"筛选\", \"新增\", \"分页\"],\n  \"includeScaffold\": true\n}\n```\n\n`recommend_component` 用法：\n\n- 不传 `query` 和 `decision` → 列出全部选型指南\n- 只传 `decision` → 阅读某一指南\n- 传 `query` → 根据问题推荐组件\n\n当前指南包括：`form-surface-choice`、`overlay-choice`、`data-display-choice`、`selection-choice`（含 Select / TreeSelect / CascadeSelect / Listbox / SelectButton / Radio / AutoComplete）、`status-label-choice`、`empty-result-choice`、`action-menu-choice`、`loading-choice`、`page-scroll-choice`、`surface-choice`、`page-section-choice`、`layout-spacing-choice`、`surface-nesting-choice`。\n\n## 对话示例\n\n接入后，可直接让助手调用本服务，例如：\n\n> 用 morya-ui 的 MCP 查一下 Dialog 的 props，并给一个带确认 / 取消按钮的示例。\n\n> 搜索和「日期」相关的组件，选一个适合表单的，按文档写出最小用法。\n\n> 根据 MCP 里 Button 的文档，写一个 `severity=\"danger\"` 的删除按钮，并校验 props 是否合法。\n\n助手应先调用工具，再基于返回内容生成类似：\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"删除\" severity=\"danger\" />\n</template>\n```\n\n## 与文档站的关系\n\n目录与本站同源（组件 `docs/` + 指南 Markdown）。官网文档更新后，维护者重新发布 `@morya-ui/mcp`，客户端通过 `npx -y` 即可拿到新版本。\n\n更多实现细节见仓库内 [packages/ui-mcp/README.md](https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp)。\n\n## 下一步\n\n- [AI 接入](/docs/ai-setup)：`npx @morya-ui/setup`、skill 与多编辑器 MCP\n- [Agent Skill](/docs/agent-skill)：`morya-ui-pages` 何时用、表面地图\n- [快速上手](/docs/quick-start)：在应用中安装并使用组件\n- [组件](/components)：浏览全部组件与交互示例\n",
+          "markdown": "---\ntitle: Agent MCP\norder: 14\ndescription: 可选的 MCP 服务，供支持 Model Context Protocol 的 AI 客户端检索本库文档。\n---\n\n# Agent MCP\n\n[`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) 是可选的 [Model Context Protocol](https://modelcontextprotocol.io/)（stdio）服务。它把本站组件文档、示例与指南做成可检索工具，方便 **支持 MCP 的 AI 客户端** 按真实 API 生成代码。\n\n日常使用组件库 **不需要** 安装或配置 MCP。应用里仍然只依赖：\n\n```bash\npnpm add morya-ui\n```\n\n```ts\nimport 'morya-ui/styles.css'\n```\n\n若要连同 Agent Skill、规则与多编辑器 MCP 一起装好，见 [一键接入](/docs/setup)（默认写入 Cursor / VS Code / Zed 与 `.mcp.json`）；AI 流程见 [AI 接入](/docs/ai-setup)；Skill 本身说明见 [Agent Skill](/docs/agent-skill)。\n\n## 接入方式\n\nMCP 客户端通过 stdio 启动本包即可：\n\n```bash\nnpx -y @morya-ui/mcp\n```\n\n通用写法：\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@morya-ui/mcp\"]\n}\n```\n\n字段名因客户端而异，只要支持 MCP stdio 即可接入。\n\n### 常见客户端配置示例\n\n以下为常见产品的配置片段，键名可能随版本变化，以各产品官方文档为准。\n\n**Cursor**（`.cursor/mcp.json` 或用户级 MCP 配置；setup 会写入）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**VS Code**（工作区 `.vscode/mcp.json`；setup 会写入）：\n\n```json\n{\n  \"servers\": {\n    \"morya-ui\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**便携**（项目根 `.mcp.json`；setup 会写入，供 Agent Host / 跨工具发现）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Claude Desktop / Claude Code**（`claude_desktop_config.json` 等；需手写，setup 不自动写）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Windsurf**（MCP 设置中的 servers 配置）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Cline**（VS Code 扩展设置中的 MCP servers）：\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Zed**（项目 `.zed/settings.json` → `context_servers`；setup 会合并写入）：\n\n```json\n{\n  \"context_servers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Continue**（`config.json` / YAML 中的 MCP servers，字段名以当前版本为准）：\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"morya-ui\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  ]\n}\n```\n\n## 可用工具\n\n### 基础 — 查组件文档\n\n| 工具 | 作用 |\n| --- | --- |\n| `list` | 列出组件 / 指南 / 示例 / 分类 / 页面模式 |\n| `search` | 搜索文档、示例、页面模式与组件选型指南 |\n| `get_component` | 读取组件说明与 API |\n| `get_example` | 获取源码示例 |\n| `get_guide` | 读取指南 |\n| `get_setup` | 安装与初始化说明 |\n| `validate_usage` | 对照文档粗检 props / events 用法 |\n| `version` | 版本与目录状态 |\n\n### 高级 — 页面组合（可选）\n\n| 工具 | 作用 |\n| --- | --- |\n| `list_patterns` | 列出可复用的页面组合模式 |\n| `get_pattern` | 读取模式的结构、布局与交互规则 |\n| `recommend_page` | 根据页面意图推荐模式；可附带 starter 脚手架 |\n| `get_design_rules` | 设计令牌与 MPage* 组合配方 |\n| `recommend_component` | 列出、阅读或推荐组件选型指南 |\n| `list_golden_pages` | 列出黄金样例页面 |\n| `get_golden_page` | 读取黄金样例 Vue 源码（含 settings / wizard / result / detail / form-in-dialog 等；`includeScaffold` 有样例时返回样例源码） |\n| `list_page_snippets` | 列出可复用的页面区块 snippet |\n| `get_page_snippet` | 读取局部区块 snippet（筛选区、工具栏等） |\n| `validate_page` | 校验页面组合、间距、双边框，以及 rows / message / MStatus 等契约 |\n\n多数工具支持 `mode`：`zh`（默认）或 `en`。\n\n### 推荐工作流\n\n**查单个组件：** `search` / `get_component` → `get_example` → `validate_usage`\n\n**规划整页：** `recommend_page` → `get_golden_page` → `get_pattern` → `get_design_rules` → `get_component` / `get_example` → **`validate_usage`** → `validate_page`\n\n**改局部区块：** `get_page_snippet(section)` → `get_component` / `get_example` → `validate_usage` → `validate_page`\n\n需要 starter 代码时，给 `recommend_page` 传 `includeScaffold: true`（有黄金样例时返回样例源码，不是另一套模板）：\n\n```json\n{\n  \"intent\": \"油井管理列表\",\n  \"pageType\": \"list\",\n  \"features\": [\"筛选\", \"新增\", \"分页\"],\n  \"includeScaffold\": true\n}\n```\n\n`recommend_component` 用法：\n\n- 不传 `query` 和 `decision` → 列出全部选型指南\n- 只传 `decision` → 阅读某一指南\n- 传 `query` → 根据问题推荐组件\n\n当前指南包括：`form-surface-choice`、`overlay-choice`、`data-display-choice`、`selection-choice`（含 Select / TreeSelect / CascadeSelect / Listbox / SelectButton / Radio / AutoComplete）、`status-label-choice`、`empty-result-choice`、`action-menu-choice`、`loading-choice`、`page-scroll-choice`、`surface-choice`、`page-section-choice`、`layout-spacing-choice`、`surface-nesting-choice`。\n\n## 对话示例\n\n接入后，可直接让助手调用本服务，例如：\n\n> 用 morya-ui 的 MCP 查一下 Dialog 的 props，并给一个带确认 / 取消按钮的示例。\n\n> 搜索和「日期」相关的组件，选一个适合表单的，按文档写出最小用法。\n\n> 根据 MCP 里 Button 的文档，写一个 `type=\"primary\" danger` 的删除按钮，并校验 props 是否合法。\n\n助手应先调用工具，再基于返回内容生成类似：\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"删除\" danger type=\"primary\"/>\n</template>\n```\n\n## 与文档站的关系\n\n目录与本站同源（组件 `docs/` + 指南 Markdown）。官网文档更新后，维护者重新发布 `@morya-ui/mcp`，客户端通过 `npx -y` 即可拿到新版本。\n\n更多实现细节见仓库内 [packages/ui-mcp/README.md](https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp)。\n\n## 下一步\n\n- [AI 接入](/docs/ai-setup)：`npx @morya-ui/setup`、skill 与多编辑器 MCP\n- [Agent Skill](/docs/agent-skill)：`morya-ui-pages` 何时用、表面地图\n- [快速上手](/docs/quick-start)：在应用中安装并使用组件\n- [组件](/components)：浏览全部组件与交互示例\n",
           "sections": [
             {
               "title": "",
@@ -33362,7 +33595,7 @@
             {
               "title": "对话示例",
               "id": "对话示例",
-              "body": "接入后，可直接让助手调用本服务，例如：\n\n> 用 morya-ui 的 MCP 查一下 Dialog 的 props，并给一个带确认 / 取消按钮的示例。\n\n> 搜索和「日期」相关的组件，选一个适合表单的，按文档写出最小用法。\n\n> 根据 MCP 里 Button 的文档，写一个 `severity=\"danger\"` 的删除按钮，并校验 props 是否合法。\n\n助手应先调用工具，再基于返回内容生成类似：\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"删除\" severity=\"danger\" />\n</template>\n```"
+              "body": "接入后，可直接让助手调用本服务，例如：\n\n> 用 morya-ui 的 MCP 查一下 Dialog 的 props，并给一个带确认 / 取消按钮的示例。\n\n> 搜索和「日期」相关的组件，选一个适合表单的，按文档写出最小用法。\n\n> 根据 MCP 里 Button 的文档，写一个 `type=\"primary\" danger` 的删除按钮，并校验 props 是否合法。\n\n助手应先调用工具，再基于返回内容生成类似：\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"删除\" danger type=\"primary\"/>\n</template>\n```"
             },
             {
               "title": "与文档站的关系",
@@ -33379,7 +33612,7 @@
         "en-US": {
           "title": "Agent MCP",
           "description": "Optional MCP server for AI clients that support the Model Context Protocol.",
-          "markdown": "---\ntitle: Agent MCP\norder: 14\ndescription: Optional MCP server for AI clients that support the Model Context Protocol.\n---\n\n# Agent MCP\n\n[`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) is an optional [Model Context Protocol](https://modelcontextprotocol.io/) (stdio) server. It indexes this site’s component docs, examples, and guides so **any MCP-capable AI client** can look up the real API.\n\nYou do **not** need MCP to use the component library. Apps still only depend on:\n\n```bash\npnpm add morya-ui\n```\n\n```ts\nimport 'morya-ui/styles.css'\n```\n\nFor Agent skill, rules, and multi-editor MCP in one step, see [One-shot setup](/docs/setup) (writes Cursor / VS Code / Zed plus `.mcp.json` by default). AI workflow: [AI setup](/docs/ai-setup). Skill behavior: [Agent Skill](/docs/agent-skill).\n\n## How to connect\n\nMCP clients start the package over stdio:\n\n```bash\nnpx -y @morya-ui/mcp\n```\n\nGeneric shape:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@morya-ui/mcp\"]\n}\n```\n\nField names differ by client. Any client that supports MCP stdio can connect.\n\n### Common client config examples\n\nSnippets for popular products. Key names may change across versions — check each product’s docs.\n\n**Cursor** (`.cursor/mcp.json` or user-level MCP settings; written by setup):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**VS Code** (workspace `.vscode/mcp.json`; written by setup):\n\n```json\n{\n  \"servers\": {\n    \"morya-ui\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Portable** (project-root `.mcp.json`; written by setup for Agent Host / cross-tool discovery):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Claude Desktop / Claude Code** (`claude_desktop_config.json`, etc.; configure manually — setup does not write these):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Windsurf** (MCP servers in settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Cline** (MCP servers in the VS Code extension settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Zed** (project `.zed/settings.json` → `context_servers`; merged by setup):\n\n```json\n{\n  \"context_servers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Continue** (`config.json` / YAML MCP servers — follow the current schema):\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"morya-ui\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  ]\n}\n```\n\n## Tools\n\n### Core — component docs\n\n| Tool | Purpose |\n| --- | --- |\n| `list` | List components / guides / examples / categories / patterns |\n| `search` | Search docs, examples, patterns, and decision guides |\n| `get_component` | Read component docs and API |\n| `get_example` | Return a source example |\n| `get_guide` | Read a guide |\n| `get_setup` | Install and setup guidance |\n| `validate_usage` | Soft-check usage against documented props/events |\n| `version` | Version and catalog status |\n\n### Advanced — page composition (optional)\n\n| Tool | Purpose |\n| --- | --- |\n| `list_patterns` | List reusable page composition patterns |\n| `get_pattern` | Read a pattern's structure, layout, and rules |\n| `recommend_page` | Recommend a pattern from page intent; optional starter scaffold |\n| `get_design_rules` | Design-token and MPage* composition rules |\n| `recommend_component` | List, read, or recommend component selection guides |\n| `list_golden_pages` | List golden page samples |\n| `get_golden_page` | Read a golden page Vue source (`list-page` … `settings-page`, `wizard-form`, …) |\n| `list_page_snippets` | List reusable page section snippets |\n| `get_page_snippet` | Read a local section snippet (filters, toolbar, …) |\n| `validate_page` | Check page composition, spacing, double-border, and contract hints (`rows`, message, MStatus) |\n\nMost tools accept `mode`: `zh` (default) or `en`.\n\nComponent lookup accepts common aliases such as `DataTable`, `数据表格`, `Pager`, and `确认弹窗`.\n\n### Recommended workflow\n\n**Look up a component:** `search` / `get_component` → `get_example` → `validate_usage`\n\n**Plan a page:** `recommend_page` → `get_golden_page` → `get_pattern` → `get_design_rules` → `get_component` / `get_example` → **`validate_usage`** → `validate_page`. Use `recommend_component` when choosing between similar components.\n\n**Edit one section:** `list_page_snippets` → `get_page_snippet` → `get_component` / `get_example` → `validate_usage` → `validate_page`\n\nPass `includeScaffold: true` to `recommend_page` for starter Vue code (returns the golden page source when one exists):\n\n```json\n{\n  \"intent\": \"Oil well management list\",\n  \"pageType\": \"list\",\n  \"features\": [\"filters\", \"create\", \"pagination\"],\n  \"mode\": \"en\",\n  \"includeScaffold\": true\n}\n```\n\n`recommend_component` modes:\n\n- omit `query` and `decision` → list decision guides\n- `decision` only → read one guide\n- `query` → recommend a component for a UI question\n\nCurrent guides include `form-surface-choice`, `overlay-choice`, `data-display-choice`, `selection-choice` (Select / TreeSelect / CascadeSelect / Listbox / SelectButton / Radio / AutoComplete), `status-label-choice`, `empty-result-choice`, `action-menu-choice`, `loading-choice`, `page-scroll-choice`, `surface-choice`, `page-section-choice`, `layout-spacing-choice`, and `surface-nesting-choice`.\n\n## Prompt examples\n\nAfter connecting, you can ask the assistant to use this server, for example:\n\n> Use the morya-ui MCP to look up Dialog props and give an example with confirm / cancel actions.\n\n> Search for date-related components, pick one suitable for forms, and write a minimal usage from the docs.\n\n> Following the Button docs from MCP, write a delete button with `severity=\"danger\"` and validate the props.\n\nThe assistant should call tools first, then produce something like:\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"Delete\" severity=\"danger\" />\n</template>\n```\n\n## Relation to this site\n\nThe catalog is generated from the same sources as this site (component `docs/` + guide Markdown). After docs change, maintainers republish `@morya-ui/mcp`; clients using `npx -y` pick up the new release.\n\nImplementation notes live in [packages/ui-mcp/README.md](https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp).\n\n## Next steps\n\n- [One-shot setup](/docs/setup): `npx @morya-ui/setup`\n- [AI setup](/docs/ai-setup): Agent skill and MCP workflow\n- [Agent Skill](/docs/agent-skill): when to use `morya-ui-pages`\n- [Quick start](/docs/quick-start): install and use components in an app\n- [Components](/components): browse live examples and APIs\n",
+          "markdown": "---\ntitle: Agent MCP\norder: 14\ndescription: Optional MCP server for AI clients that support the Model Context Protocol.\n---\n\n# Agent MCP\n\n[`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp) is an optional [Model Context Protocol](https://modelcontextprotocol.io/) (stdio) server. It indexes this site’s component docs, examples, and guides so **any MCP-capable AI client** can look up the real API.\n\nYou do **not** need MCP to use the component library. Apps still only depend on:\n\n```bash\npnpm add morya-ui\n```\n\n```ts\nimport 'morya-ui/styles.css'\n```\n\nFor Agent skill, rules, and multi-editor MCP in one step, see [One-shot setup](/docs/setup) (writes Cursor / VS Code / Zed plus `.mcp.json` by default). AI workflow: [AI setup](/docs/ai-setup). Skill behavior: [Agent Skill](/docs/agent-skill).\n\n## How to connect\n\nMCP clients start the package over stdio:\n\n```bash\nnpx -y @morya-ui/mcp\n```\n\nGeneric shape:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@morya-ui/mcp\"]\n}\n```\n\nField names differ by client. Any client that supports MCP stdio can connect.\n\n### Common client config examples\n\nSnippets for popular products. Key names may change across versions — check each product’s docs.\n\n**Cursor** (`.cursor/mcp.json` or user-level MCP settings; written by setup):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**VS Code** (workspace `.vscode/mcp.json`; written by setup):\n\n```json\n{\n  \"servers\": {\n    \"morya-ui\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Portable** (project-root `.mcp.json`; written by setup for Agent Host / cross-tool discovery):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Claude Desktop / Claude Code** (`claude_desktop_config.json`, etc.; configure manually — setup does not write these):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Windsurf** (MCP servers in settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Cline** (MCP servers in the VS Code extension settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Zed** (project `.zed/settings.json` → `context_servers`; merged by setup):\n\n```json\n{\n  \"context_servers\": {\n    \"morya-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  }\n}\n```\n\n**Continue** (`config.json` / YAML MCP servers — follow the current schema):\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"morya-ui\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@morya-ui/mcp\"]\n    }\n  ]\n}\n```\n\n## Tools\n\n### Core — component docs\n\n| Tool | Purpose |\n| --- | --- |\n| `list` | List components / guides / examples / categories / patterns |\n| `search` | Search docs, examples, patterns, and decision guides |\n| `get_component` | Read component docs and API |\n| `get_example` | Return a source example |\n| `get_guide` | Read a guide |\n| `get_setup` | Install and setup guidance |\n| `validate_usage` | Soft-check usage against documented props/events |\n| `version` | Version and catalog status |\n\n### Advanced — page composition (optional)\n\n| Tool | Purpose |\n| --- | --- |\n| `list_patterns` | List reusable page composition patterns |\n| `get_pattern` | Read a pattern's structure, layout, and rules |\n| `recommend_page` | Recommend a pattern from page intent; optional starter scaffold |\n| `get_design_rules` | Design-token and MPage* composition rules |\n| `recommend_component` | List, read, or recommend component selection guides |\n| `list_golden_pages` | List golden page samples |\n| `get_golden_page` | Read a golden page Vue source (`list-page` … `settings-page`, `wizard-form`, …) |\n| `list_page_snippets` | List reusable page section snippets |\n| `get_page_snippet` | Read a local section snippet (filters, toolbar, …) |\n| `validate_page` | Check page composition, spacing, double-border, and contract hints (`rows`, message, MStatus) |\n\nMost tools accept `mode`: `zh` (default) or `en`.\n\nComponent lookup accepts common aliases such as `DataTable`, `数据表格`, `Pager`, and `确认弹窗`.\n\n### Recommended workflow\n\n**Look up a component:** `search` / `get_component` → `get_example` → `validate_usage`\n\n**Plan a page:** `recommend_page` → `get_golden_page` → `get_pattern` → `get_design_rules` → `get_component` / `get_example` → **`validate_usage`** → `validate_page`. Use `recommend_component` when choosing between similar components.\n\n**Edit one section:** `list_page_snippets` → `get_page_snippet` → `get_component` / `get_example` → `validate_usage` → `validate_page`\n\nPass `includeScaffold: true` to `recommend_page` for starter Vue code (returns the golden page source when one exists):\n\n```json\n{\n  \"intent\": \"Oil well management list\",\n  \"pageType\": \"list\",\n  \"features\": [\"filters\", \"create\", \"pagination\"],\n  \"mode\": \"en\",\n  \"includeScaffold\": true\n}\n```\n\n`recommend_component` modes:\n\n- omit `query` and `decision` → list decision guides\n- `decision` only → read one guide\n- `query` → recommend a component for a UI question\n\nCurrent guides include `form-surface-choice`, `overlay-choice`, `data-display-choice`, `selection-choice` (Select / TreeSelect / CascadeSelect / Listbox / SelectButton / Radio / AutoComplete), `status-label-choice`, `empty-result-choice`, `action-menu-choice`, `loading-choice`, `page-scroll-choice`, `surface-choice`, `page-section-choice`, `layout-spacing-choice`, and `surface-nesting-choice`.\n\n## Prompt examples\n\nAfter connecting, you can ask the assistant to use this server, for example:\n\n> Use the morya-ui MCP to look up Dialog props and give an example with confirm / cancel actions.\n\n> Search for date-related components, pick one suitable for forms, and write a minimal usage from the docs.\n\n> Following the Button docs from MCP, write a delete button with `type=\"primary\" danger` and validate the props.\n\nThe assistant should call tools first, then produce something like:\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"Delete\" danger type=\"primary\"/>\n</template>\n```\n\n## Relation to this site\n\nThe catalog is generated from the same sources as this site (component `docs/` + guide Markdown). After docs change, maintainers republish `@morya-ui/mcp`; clients using `npx -y` pick up the new release.\n\nImplementation notes live in [packages/ui-mcp/README.md](https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp).\n\n## Next steps\n\n- [One-shot setup](/docs/setup): `npx @morya-ui/setup`\n- [AI setup](/docs/ai-setup): Agent skill and MCP workflow\n- [Agent Skill](/docs/agent-skill): when to use `morya-ui-pages`\n- [Quick start](/docs/quick-start): install and use components in an app\n- [Components](/components): browse live examples and APIs\n",
           "sections": [
             {
               "title": "",
@@ -33399,7 +33632,7 @@
             {
               "title": "Prompt examples",
               "id": "prompt-examples",
-              "body": "After connecting, you can ask the assistant to use this server, for example:\n\n> Use the morya-ui MCP to look up Dialog props and give an example with confirm / cancel actions.\n\n> Search for date-related components, pick one suitable for forms, and write a minimal usage from the docs.\n\n> Following the Button docs from MCP, write a delete button with `severity=\"danger\"` and validate the props.\n\nThe assistant should call tools first, then produce something like:\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"Delete\" severity=\"danger\" />\n</template>\n```"
+              "body": "After connecting, you can ask the assistant to use this server, for example:\n\n> Use the morya-ui MCP to look up Dialog props and give an example with confirm / cancel actions.\n\n> Search for date-related components, pick one suitable for forms, and write a minimal usage from the docs.\n\n> Following the Button docs from MCP, write a delete button with `type=\"primary\" danger` and validate the props.\n\nThe assistant should call tools first, then produce something like:\n\n```vue\n<script setup lang=\"ts\">\nimport { MButton } from 'morya-ui'\n</script>\n\n<template>\n  <MButton label=\"Delete\" danger type=\"primary\"/>\n</template>\n```"
             },
             {
               "title": "Relation to this site",
@@ -33426,7 +33659,7 @@
         "zh-CN": {
           "title": "登录表单",
           "description": "用 MForm + FormRules 做邮箱/密码登录校验。",
-          "markdown": "---\ntitle: 登录表单\norder: 20\ndescription: 用 MForm + FormRules 做邮箱/密码登录校验。\n---\n\n# 登录表单\n\n把邮箱、密码和提交按钮组合成可直接复制的登录表单：声明式 `rules` 校验，提交时统一跑一遍。\n\n## 目标\n\n- 邮箱必填 + 格式校验\n- 密码必填 + 最短长度\n- 提交时 `validate()`，失败只展示字段错误，成功再继续业务逻辑\n\n## 何时使用\n\n- 登录 / 注册页、账号切换弹窗等短表单\n- 需要字段级错误文案，而不是一次弹全局 Toast\n\n## 步骤\n\n1. 安装并引入样式：`pnpm add morya-ui`，入口加 `import 'morya-ui/styles.css'`（按需导入可跳过全量样式）。\n2. 用 `reactive` 建 `model`，用 `FormRules` 按字段名写规则。\n3. `MForm` 绑定 `model` / `rules`，`validate-on=\"submit\"`；字段放在 `MFormItem` 里，并通过默认插槽拿到 `id` / `invalid`。\n4. 密码用 `MInputPassword`；邮箱用 `MInput type=\"email\"`。\n5. 在 `@submit` 里 `await formRef.validate()`，检查 `valid` 后再请求接口。\n\n`validate()` **始终 resolve**，不会 reject；失败时看 `{ valid, errors }`。\n\n## 预览\n\n```vue preview src=\"./demos/recipes/FormLogin.zh.vue\"\n```\n\n## 检查清单\n\n- [ ] `name` 与 `rules` 键一致（`email` / `password`）\n- [ ] 控件收到 `id` 与 `invalid`，错误能关联到 label\n- [ ] 密码使用 `MInputPassword`（不要用明文 `type=\"password\"` 凑合，除非刻意简化）\n- [ ] 提交按钮 `native-type=\"submit\"`，避免只绑 `@click` 漏掉原生提交\n- [ ] 已引入 `morya-ui` 与样式\n\n## 相关\n\n- [Form](/components/Form)：声明式 rules、`useForm`\n- [Input](/components/Input) / [InputPassword](/components/InputPassword)\n- [Button](/components/Button)\n- [快速上手](/docs/quick-start)\n",
+          "markdown": "---\ntitle: 登录表单\norder: 20\ndescription: 用 MForm + FormRules 做邮箱/密码登录校验。\n---\n\n# 登录表单\n\n把邮箱、密码和提交按钮组合成可直接复制的登录表单：声明式 `rules` 校验，提交时统一跑一遍。\n\n## 目标\n\n- 邮箱必填 + 格式校验\n- 密码必填 + 最短长度\n- 提交时 `validate()`，失败只展示字段错误，成功再继续业务逻辑\n\n## 何时使用\n\n- 登录 / 注册页、账号切换弹窗等短表单\n- 需要字段级错误文案，而不是一次弹全局 Toast\n\n## 步骤\n\n1. 安装并引入样式：`pnpm add morya-ui`，入口加 `import 'morya-ui/styles.css'`（按需导入可跳过全量样式）。\n2. 用 `reactive` 建 `model`，用 `FormRules` 按字段名写规则。\n3. `MForm` 绑定 `model` / `rules`，`validate-on=\"submit\"`；字段放在 `MFormItem` 里，并通过默认插槽拿到 `id` / `invalid`。\n4. 密码用 `MInputPassword`；邮箱用 `MInput type=\"email\"`。\n5. 在 `@submit` 里 `await formRef.validate()`，检查 `valid` 后再请求接口。\n\n`validate()` **始终 resolve**，不会 reject；失败时看 `{ valid, errors }`。\n\n## 预览\n\n```vue preview src=\"./demos/recipes/FormLogin.zh.vue\"\n```\n\n## 检查清单\n\n- [ ] `name` 与 `rules` 键一致（`email` / `password`）\n- [ ] 控件收到 `id` 与 `invalid`，错误能关联到 label\n- [ ] 密码使用 `MInputPassword`（不要用明文 `type=\"password\"` 凑合，除非刻意简化）\n- [ ] 提交按钮 `html-type=\"submit\"`，避免只绑 `@click` 漏掉原生提交\n- [ ] 已引入 `morya-ui` 与样式\n\n## 相关\n\n- [Form](/components/Form)：声明式 rules、`useForm`\n- [Input](/components/Input) / [InputPassword](/components/InputPassword)\n- [Button](/components/Button)\n- [快速上手](/docs/quick-start)\n",
           "sections": [
             {
               "title": "",
@@ -33456,7 +33689,7 @@
             {
               "title": "检查清单",
               "id": "检查清单",
-              "body": "- [ ] `name` 与 `rules` 键一致（`email` / `password`）\n- [ ] 控件收到 `id` 与 `invalid`，错误能关联到 label\n- [ ] 密码使用 `MInputPassword`（不要用明文 `type=\"password\"` 凑合，除非刻意简化）\n- [ ] 提交按钮 `native-type=\"submit\"`，避免只绑 `@click` 漏掉原生提交\n- [ ] 已引入 `morya-ui` 与样式"
+              "body": "- [ ] `name` 与 `rules` 键一致（`email` / `password`）\n- [ ] 控件收到 `id` 与 `invalid`，错误能关联到 label\n- [ ] 密码使用 `MInputPassword`（不要用明文 `type=\"password\"` 凑合，除非刻意简化）\n- [ ] 提交按钮 `html-type=\"submit\"`，避免只绑 `@click` 漏掉原生提交\n- [ ] 已引入 `morya-ui` 与样式"
             },
             {
               "title": "相关",
@@ -33468,7 +33701,7 @@
         "en-US": {
           "title": "Login form",
           "description": "Build an email/password login form with MForm and FormRules.",
-          "markdown": "---\ntitle: Login form\norder: 20\ndescription: Build an email/password login form with MForm and FormRules.\n---\n\n# Login form\n\nA copy-paste login form with declarative `rules`: email + password, validate on submit.\n\n## Goal\n\n- Required email with format check\n- Required password with a minimum length\n- Call `validate()` on submit; show field errors first, then run your business logic\n\n## When to use\n\n- Sign-in / sign-up pages and short account dialogs\n- Field-level error copy instead of a single global toast\n\n## Steps\n\n1. Install and load styles: `pnpm add morya-ui`, then `import 'morya-ui/styles.css'` at the app entry (skip full CSS when using subpath imports).\n2. Keep values in a `reactive` `model` and declare `FormRules` keyed by field name.\n3. Bind `model` / `rules` on `MForm` with `validate-on=\"submit\"`. Wrap fields in `MFormItem` and pass `id` / `invalid` from the default slot.\n4. Use `MInputPassword` for the password and `MInput type=\"email\"` for the email.\n5. In `@submit`, `await formRef.validate()` and check `valid` before calling your API.\n\n`validate()` **always resolves** — it does not reject. On failure, inspect `{ valid, errors }`.\n\n## Preview\n\n```vue preview src=\"./demos/recipes/FormLogin.en.vue\"\n```\n\n## Checklist\n\n- [ ] `name` matches the `rules` keys (`email` / `password`)\n- [ ] Controls receive `id` and `invalid` so errors link to labels\n- [ ] Password uses `MInputPassword` (avoid a plain `type=\"password\"` unless you intentionally simplify)\n- [ ] Submit button uses `native-type=\"submit\"` so native form submit is not skipped\n- [ ] `morya-ui` and styles are imported\n\n## Related\n\n- [Form](/components/Form): declarative rules, `useForm`\n- [Input](/components/Input) / [InputPassword](/components/InputPassword)\n- [Button](/components/Button)\n- [Quick start](/docs/quick-start)\n",
+          "markdown": "---\ntitle: Login form\norder: 20\ndescription: Build an email/password login form with MForm and FormRules.\n---\n\n# Login form\n\nA copy-paste login form with declarative `rules`: email + password, validate on submit.\n\n## Goal\n\n- Required email with format check\n- Required password with a minimum length\n- Call `validate()` on submit; show field errors first, then run your business logic\n\n## When to use\n\n- Sign-in / sign-up pages and short account dialogs\n- Field-level error copy instead of a single global toast\n\n## Steps\n\n1. Install and load styles: `pnpm add morya-ui`, then `import 'morya-ui/styles.css'` at the app entry (skip full CSS when using subpath imports).\n2. Keep values in a `reactive` `model` and declare `FormRules` keyed by field name.\n3. Bind `model` / `rules` on `MForm` with `validate-on=\"submit\"`. Wrap fields in `MFormItem` and pass `id` / `invalid` from the default slot.\n4. Use `MInputPassword` for the password and `MInput type=\"email\"` for the email.\n5. In `@submit`, `await formRef.validate()` and check `valid` before calling your API.\n\n`validate()` **always resolves** — it does not reject. On failure, inspect `{ valid, errors }`.\n\n## Preview\n\n```vue preview src=\"./demos/recipes/FormLogin.en.vue\"\n```\n\n## Checklist\n\n- [ ] `name` matches the `rules` keys (`email` / `password`)\n- [ ] Controls receive `id` and `invalid` so errors link to labels\n- [ ] Password uses `MInputPassword` (avoid a plain `type=\"password\"` unless you intentionally simplify)\n- [ ] Submit button uses `html-type=\"submit\"` so native form submit is not skipped\n- [ ] `morya-ui` and styles are imported\n\n## Related\n\n- [Form](/components/Form): declarative rules, `useForm`\n- [Input](/components/Input) / [InputPassword](/components/InputPassword)\n- [Button](/components/Button)\n- [Quick start](/docs/quick-start)\n",
           "sections": [
             {
               "title": "",
@@ -33498,7 +33731,7 @@
             {
               "title": "Checklist",
               "id": "checklist",
-              "body": "- [ ] `name` matches the `rules` keys (`email` / `password`)\n- [ ] Controls receive `id` and `invalid` so errors link to labels\n- [ ] Password uses `MInputPassword` (avoid a plain `type=\"password\"` unless you intentionally simplify)\n- [ ] Submit button uses `native-type=\"submit\"` so native form submit is not skipped\n- [ ] `morya-ui` and styles are imported"
+              "body": "- [ ] `name` matches the `rules` keys (`email` / `password`)\n- [ ] Controls receive `id` and `invalid` so errors link to labels\n- [ ] Password uses `MInputPassword` (avoid a plain `type=\"password\"` unless you intentionally simplify)\n- [ ] Submit button uses `html-type=\"submit\"` so native form submit is not skipped\n- [ ] `morya-ui` and styles are imported"
             },
             {
               "title": "Related",
@@ -33614,7 +33847,7 @@
         "zh-CN": {
           "title": "确认流程",
           "description": "声明式 MConfirmDialog 与命令式 useConfirm 两种确认交互。",
-          "markdown": "---\ntitle: 确认流程\norder: 22\ndescription: 声明式 MConfirmDialog 与命令式 useConfirm 两种确认交互。\n---\n\n# 确认流程\n\n删除、停用、覆盖写入等不可轻易撤销的操作，先让用户点一次确认。Morya 提供模板声明式与 `useConfirm().require()` 命令式两条路。\n\n## 目标\n\n- 模板里用 `MConfirmDialog` + `v-model` 控制显隐\n- 脚本里用 `useConfirm().require(...)`，得到 `Promise<boolean>`\n- 危险操作用 `accept-severity=\"danger\"`（可选 `type=\"warning\"`）\n\n## 何时使用\n\n| 方式 | 适合 |\n| --- | --- |\n| 声明式 `MConfirmDialog` | 文案/插槽固定、需要和页面状态绑定、要自定义 footer |\n| 命令式 `useConfirm` | 工具函数、表格行操作、不想为每个入口挂一个 Dialog |\n| Dialog `modal.confirm` | 需要完整 Dialog 能力（异步 `onOk`、自定义内容）。见 [Dialog](/components/Dialog) |\n\n## 步骤\n\n1. **声明式**：`visible` 驱动 `v-model`；按钮打开对话框；监听 `@accept` / `@reject`。\n2. **命令式**：`const confirm = useConfirm()`，`await confirm.require({ header, message, ... })`；`true` 表示确认，`false` 表示取消或关闭。\n3. 确认按钮语义色用 `acceptSeverity: 'danger'`；需要状态图标时加 `type: 'warning'`。\n4. 真正删数据放在确认之后；若删除是异步的，可在声明式路径用 `beforeAccept`，或命令式路径里先 `await` 再反馈结果。\n\n## 预览\n\n```vue preview src=\"./demos/recipes/ConfirmFlow.zh.vue\"\n```\n\n## 检查清单\n\n- [ ] 危险操作文案写清楚不可撤销后果\n- [ ] 声明式路径绑定了 `@accept` / `@reject`（或等价业务回调）\n- [ ] 命令式路径处理了 `false`（取消 / Esc / 点遮罩）\n- [ ] 不要把确认框当成普通通知（短反馈用 `message` / `toast`）\n- [ ] 已引入 `morya-ui` 与样式\n\n## 相关\n\n- [ConfirmDialog](/components/ConfirmDialog)：`MConfirmDialog`、`useConfirm`\n- [Dialog](/components/Dialog)：`useModal` / `modal.confirm`\n- [约定](/docs/conventions)：反馈选型\n- [快速上手](/docs/quick-start)\n",
+          "markdown": "---\ntitle: 确认流程\norder: 22\ndescription: 声明式 MConfirmDialog 与命令式 useConfirm 两种确认交互。\n---\n\n# 确认流程\n\n删除、停用、覆盖写入等不可轻易撤销的操作，先让用户点一次确认。Morya 提供模板声明式与 `useConfirm().require()` 命令式两条路。\n\n## 目标\n\n- 模板里用 `MConfirmDialog` + `v-model` 控制显隐\n- 脚本里用 `useConfirm().require(...)`，得到 `Promise<boolean>`\n- 危险操作用 `accept-color=\"danger\"`（可选 `type=\"warning\"`）\n\n## 何时使用\n\n| 方式 | 适合 |\n| --- | --- |\n| 声明式 `MConfirmDialog` | 文案/插槽固定、需要和页面状态绑定、要自定义 footer |\n| 命令式 `useConfirm` | 工具函数、表格行操作、不想为每个入口挂一个 Dialog |\n| Dialog `modal.confirm` | 需要完整 Dialog 能力（异步 `onOk`、自定义内容）。见 [Dialog](/components/Dialog) |\n\n## 步骤\n\n1. **声明式**：`visible` 驱动 `v-model`；按钮打开对话框；监听 `@accept` / `@reject`。\n2. **命令式**：`const confirm = useConfirm()`，`await confirm.require({ header, message, ... })`；`true` 表示确认，`false` 表示取消或关闭。\n3. 确认按钮颜色用 `acceptColor: 'danger'`；需要状态图标时加 `type: 'warning'`。\n4. 真正删数据放在确认之后；若删除是异步的，可在声明式路径用 `beforeAccept`，或命令式路径里先 `await` 再反馈结果。\n\n## 预览\n\n```vue preview src=\"./demos/recipes/ConfirmFlow.zh.vue\"\n```\n\n## 检查清单\n\n- [ ] 危险操作文案写清楚不可撤销后果\n- [ ] 声明式路径绑定了 `@accept` / `@reject`（或等价业务回调）\n- [ ] 命令式路径处理了 `false`（取消 / Esc / 点遮罩）\n- [ ] 不要把确认框当成普通通知（短反馈用 `message` / `toast`）\n- [ ] 已引入 `morya-ui` 与样式\n\n## 相关\n\n- [ConfirmDialog](/components/ConfirmDialog)：`MConfirmDialog`、`useConfirm`\n- [Dialog](/components/Dialog)：`useModal` / `modal.confirm`\n- [约定](/docs/conventions)：反馈选型\n- [快速上手](/docs/quick-start)\n",
           "sections": [
             {
               "title": "",
@@ -33624,7 +33857,7 @@
             {
               "title": "目标",
               "id": "目标",
-              "body": "- 模板里用 `MConfirmDialog` + `v-model` 控制显隐\n- 脚本里用 `useConfirm().require(...)`，得到 `Promise<boolean>`\n- 危险操作用 `accept-severity=\"danger\"`（可选 `type=\"warning\"`）"
+              "body": "- 模板里用 `MConfirmDialog` + `v-model` 控制显隐\n- 脚本里用 `useConfirm().require(...)`，得到 `Promise<boolean>`\n- 危险操作用 `accept-color=\"danger\"`（可选 `type=\"warning\"`）"
             },
             {
               "title": "何时使用",
@@ -33634,7 +33867,7 @@
             {
               "title": "步骤",
               "id": "步骤",
-              "body": "1. **声明式**：`visible` 驱动 `v-model`；按钮打开对话框；监听 `@accept` / `@reject`。\n2. **命令式**：`const confirm = useConfirm()`，`await confirm.require({ header, message, ... })`；`true` 表示确认，`false` 表示取消或关闭。\n3. 确认按钮语义色用 `acceptSeverity: 'danger'`；需要状态图标时加 `type: 'warning'`。\n4. 真正删数据放在确认之后；若删除是异步的，可在声明式路径用 `beforeAccept`，或命令式路径里先 `await` 再反馈结果。"
+              "body": "1. **声明式**：`visible` 驱动 `v-model`；按钮打开对话框；监听 `@accept` / `@reject`。\n2. **命令式**：`const confirm = useConfirm()`，`await confirm.require({ header, message, ... })`；`true` 表示确认，`false` 表示取消或关闭。\n3. 确认按钮颜色用 `acceptColor: 'danger'`；需要状态图标时加 `type: 'warning'`。\n4. 真正删数据放在确认之后；若删除是异步的，可在声明式路径用 `beforeAccept`，或命令式路径里先 `await` 再反馈结果。"
             },
             {
               "title": "预览",
@@ -33656,7 +33889,7 @@
         "en-US": {
           "title": "Confirm flow",
           "description": "Declarative MConfirmDialog and imperative useConfirm for destructive actions.",
-          "markdown": "---\ntitle: Confirm flow\norder: 22\ndescription: Declarative MConfirmDialog and imperative useConfirm for destructive actions.\n---\n\n# Confirm flow\n\nFor deletes, disables, and other hard-to-undo actions, ask once before running them. Morya covers both a template-driven dialog and `useConfirm().require()`.\n\n## Goal\n\n- Control `MConfirmDialog` with `v-model` in the template\n- Call `useConfirm().require(...)` from script and await a `Promise<boolean>`\n- Mark destructive accepts with `accept-severity=\"danger\"` (optional `type=\"warning\"`)\n\n## When to use\n\n| Approach | Best for |\n| --- | --- |\n| Declarative `MConfirmDialog` | Fixed copy/slots, state bound to the page, custom footer |\n| Imperative `useConfirm` | Helpers, per-row table actions, avoiding one Dialog per entry |\n| Dialog `modal.confirm` | Full Dialog features (async `onOk`, custom content). See [Dialog](/components/Dialog) |\n\n## Steps\n\n1. **Declarative**: drive visibility with `v-model`; open from a button; handle `@accept` / `@reject`.\n2. **Imperative**: `const confirm = useConfirm()`, then `await confirm.require({ header, message, ... })`. `true` means accepted; `false` means cancelled or dismissed.\n3. Set `acceptSeverity: 'danger'` for destructive confirms; add `type: 'warning'` when you want a status icon.\n4. Run the real side effect after confirm. For async deletes, use `beforeAccept` on the declarative path, or `await` your API after `require()` resolves `true`.\n\n## Preview\n\n```vue preview src=\"./demos/recipes/ConfirmFlow.en.vue\"\n```\n\n## Checklist\n\n- [ ] Copy spells out the irreversible consequence\n- [ ] Declarative path wires `@accept` / `@reject` (or equivalent handlers)\n- [ ] Imperative path handles `false` (cancel / Esc / outside click)\n- [ ] Do not misuse confirms as toasts (short feedback belongs to `message` / `toast`)\n- [ ] `morya-ui` and styles are imported\n\n## Related\n\n- [ConfirmDialog](/components/ConfirmDialog): `MConfirmDialog`, `useConfirm`\n- [Dialog](/components/Dialog): `useModal` / `modal.confirm`\n- [Conventions](/docs/conventions): feedback selection\n- [Quick start](/docs/quick-start)\n",
+          "markdown": "---\ntitle: Confirm flow\norder: 22\ndescription: Declarative MConfirmDialog and imperative useConfirm for destructive actions.\n---\n\n# Confirm flow\n\nFor deletes, disables, and other hard-to-undo actions, ask once before running them. Morya covers both a template-driven dialog and `useConfirm().require()`.\n\n## Goal\n\n- Control `MConfirmDialog` with `v-model` in the template\n- Call `useConfirm().require(...)` from script and await a `Promise<boolean>`\n- Mark destructive accepts with `accept-color=\"danger\"` (optional `type=\"warning\"`)\n\n## When to use\n\n| Approach | Best for |\n| --- | --- |\n| Declarative `MConfirmDialog` | Fixed copy/slots, state bound to the page, custom footer |\n| Imperative `useConfirm` | Helpers, per-row table actions, avoiding one Dialog per entry |\n| Dialog `modal.confirm` | Full Dialog features (async `onOk`, custom content). See [Dialog](/components/Dialog) |\n\n## Steps\n\n1. **Declarative**: drive visibility with `v-model`; open from a button; handle `@accept` / `@reject`.\n2. **Imperative**: `const confirm = useConfirm()`, then `await confirm.require({ header, message, ... })`. `true` means accepted; `false` means cancelled or dismissed.\n3. Set `acceptColor: 'danger'` for destructive confirms; add `type: 'warning'` when you want a status icon.\n4. Run the real side effect after confirm. For async deletes, use `beforeAccept` on the declarative path, or `await` your API after `require()` resolves `true`.\n\n## Preview\n\n```vue preview src=\"./demos/recipes/ConfirmFlow.en.vue\"\n```\n\n## Checklist\n\n- [ ] Copy spells out the irreversible consequence\n- [ ] Declarative path wires `@accept` / `@reject` (or equivalent handlers)\n- [ ] Imperative path handles `false` (cancel / Esc / outside click)\n- [ ] Do not misuse confirms as toasts (short feedback belongs to `message` / `toast`)\n- [ ] `morya-ui` and styles are imported\n\n## Related\n\n- [ConfirmDialog](/components/ConfirmDialog): `MConfirmDialog`, `useConfirm`\n- [Dialog](/components/Dialog): `useModal` / `modal.confirm`\n- [Conventions](/docs/conventions): feedback selection\n- [Quick start](/docs/quick-start)\n",
           "sections": [
             {
               "title": "",
@@ -33666,7 +33899,7 @@
             {
               "title": "Goal",
               "id": "goal",
-              "body": "- Control `MConfirmDialog` with `v-model` in the template\n- Call `useConfirm().require(...)` from script and await a `Promise<boolean>`\n- Mark destructive accepts with `accept-severity=\"danger\"` (optional `type=\"warning\"`)"
+              "body": "- Control `MConfirmDialog` with `v-model` in the template\n- Call `useConfirm().require(...)` from script and await a `Promise<boolean>`\n- Mark destructive accepts with `accept-color=\"danger\"` (optional `type=\"warning\"`)"
             },
             {
               "title": "When to use",
@@ -33676,7 +33909,7 @@
             {
               "title": "Steps",
               "id": "steps",
-              "body": "1. **Declarative**: drive visibility with `v-model`; open from a button; handle `@accept` / `@reject`.\n2. **Imperative**: `const confirm = useConfirm()`, then `await confirm.require({ header, message, ... })`. `true` means accepted; `false` means cancelled or dismissed.\n3. Set `acceptSeverity: 'danger'` for destructive confirms; add `type: 'warning'` when you want a status icon.\n4. Run the real side effect after confirm. For async deletes, use `beforeAccept` on the declarative path, or `await` your API after `require()` resolves `true`."
+              "body": "1. **Declarative**: drive visibility with `v-model`; open from a button; handle `@accept` / `@reject`.\n2. **Imperative**: `const confirm = useConfirm()`, then `await confirm.require({ header, message, ... })`. `true` means accepted; `false` means cancelled or dismissed.\n3. Set `acceptColor: 'danger'` for destructive confirms; add `type: 'warning'` when you want a status icon.\n4. Run the real side effect after confirm. For async deletes, use `beforeAccept` on the declarative path, or `await` your API after `require()` resolves `true`."
             },
             {
               "title": "Preview",
@@ -33980,12 +34213,12 @@
         "zh-CN": {
           "title": "约定",
           "description": "morya-ui 的命名、语义色、尺寸与主题约定。",
-          "markdown": "---\ntitle: 约定\norder: 35\ndescription: morya-ui 的命名、语义色、尺寸与主题约定。\n---\n\n# 约定\n\nMorya UI 用自己的词表描述界面：组件前缀 `M*`、语义色 `severity`、外观 `variant`、设计令牌 `--m-*`。写业务页时直接跟这套约定走。\n\n## 组件与令牌\n\n| 约定 | 说明 |\n| --- | --- |\n| 组件名 | 一律 `M` 前缀：`MButton`、`MDialog`、`MTable` |\n| 主题 | `MConfigProvider` + `useTheme` / `useDensity` / `useMotion` |\n| 颜色与几何 | 只用 `--m-*`，品牌色改 `--m-color-primary` |\n| 控件高度 | 默认 medium `32px`，圆角 `--m-control-radius` |\n| 字重 | 控件文案默认 400 |\n\n完整变量见 [设计令牌](/docs/design-tokens)，覆盖方式见 [主题](/docs/theme)。\n\n## 语义与外观\n\n| 词 | 用在 |\n| --- | --- |\n| `severity` | 语义色：`primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `variant` | 外观：`outlined` / `dashed` / `text` / `link` / `ghost` 等 |\n| `fluid` | 通栏（占满父级宽度） |\n| `size` | `small` / `medium` / `large`（部分控件仍接受 `sm` / `md` / `lg`） |\n| `status` | 表单控件校验态：`error` / `warning` |\n\n按钮默认就是主色实心；次要操作用 `severity=\"secondary\"`，危险操作用 `severity=\"danger\"`。\n\n## 反馈\n\n| 场景 | 用法 |\n| --- | --- |\n| 短操作结果 | `message` / `MMessage` |\n| 摘要 + 详情、异步过程 | `toast` / `MToast` |\n| 需要确认 | `MConfirmDialog` / `MConfirmPopup` / `useConfirm` |\n| 页面内常驻说明 | `MAlert` |\n| 阻塞等待 | `MLoading`（细环可用 `MProgressSpinner`） |\n| 进度 | `MProgressBar` |\n| 空态 / 结果页 | `MEmpty` / `MResult` |\n\n## 布局与页面\n\n后台骨架用 `MLayout` 系列；列表/筛选/统计块用 `MPage*`。间距容器是 `MSpace` / `MFlex` / `MGrid`，相邻按钮拼组用 `MButtonGroup`。\n\n## 本库特有的能力\n\nDock、Terminal、Knob、Page 套件、以及 MCP / Agent Skill 是同一套令牌上的产品面。选型看 [组件文档](/components/Button) 和仓库 `DESIGN.md`。\n",
+          "markdown": "---\ntitle: 约定\norder: 35\ndescription: morya-ui 的命名、语义色、尺寸与主题约定。\n---\n\n# 约定\n\nMorya UI 用自己的词表描述界面：组件前缀 `M*`、语义色 `severity`（Badge / Tag / Alert 等）、Button 的 `type` / `color` / `variant`、设计令牌 `--m-*`。写业务页时直接跟这套约定走。\n\n## 组件与令牌\n\n| 约定 | 说明 |\n| --- | --- |\n| 组件名 | 一律 `M` 前缀：`MButton`、`MDialog`、`MTable` |\n| 主题 | `MConfigProvider` + `useTheme` / `useDensity` / `useMotion` |\n| 颜色与几何 | 只用 `--m-*`，品牌色改 `--m-color-primary` |\n| 控件高度 | 默认 medium `32px`，圆角 `--m-control-radius` |\n| 字重 | 控件文案默认 400 |\n\n完整变量见 [设计令牌](/docs/design-tokens)，覆盖方式见 [主题](/docs/theme)。\n\n## 语义与外观\n\n| 词 | 用在 |\n| --- | --- |\n| `severity` | Badge / Tag / Alert 等语义色：`primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `type` / `color` / `variant` | Button：`type` 糖（`primary` / `dashed` / `text` / `link`…）+ `color` + `variant`（`solid` / `outlined` / `filled`…） |\n| `fluid` / `block` | 通栏；字段多用 `fluid`，Button / ButtonGroup 用 `block` |\n| `size` | `small` / `medium` / `large`（部分控件仍接受 `sm` / `md` / `lg`） |\n| `status` | 表单控件校验态：`error` / `warning` |\n\n按钮默认是灰色描边（`default` + `outlined`）；主实心用 `type=\"primary\"`，次要动作保持默认或 `type=\"text\"`，危险操作用 `danger` / `color=\"danger\"`。\n\n## 反馈\n\n| 场景 | 用法 |\n| --- | --- |\n| 短操作结果 | `message` / `MMessage` |\n| 摘要 + 详情、异步过程 | `toast` / `MToast` |\n| 需要确认 | `MConfirmDialog` / `MConfirmPopup` / `useConfirm` |\n| 页面内常驻说明 | `MAlert` |\n| 阻塞等待 | `MLoading`（细环可用 `MProgressSpinner`） |\n| 进度 | `MProgressBar` |\n| 空态 / 结果页 | `MEmpty` / `MResult` |\n\n## 布局与页面\n\n后台骨架用 `MLayout` 系列；列表/筛选/统计块用 `MPage*`。间距容器是 `MSpace` / `MFlex` / `MGrid`，相邻按钮拼组用 `MButtonGroup`。\n\n## 本库特有的能力\n\nDock、Terminal、Knob、Page 套件、以及 MCP / Agent Skill 是同一套令牌上的产品面。选型看 [组件文档](/components/Button) 和仓库 `DESIGN.md`。\n",
           "sections": [
             {
               "title": "",
               "id": "overview",
-              "body": "# 约定\n\nMorya UI 用自己的词表描述界面：组件前缀 `M*`、语义色 `severity`、外观 `variant`、设计令牌 `--m-*`。写业务页时直接跟这套约定走。"
+              "body": "# 约定\n\nMorya UI 用自己的词表描述界面：组件前缀 `M*`、语义色 `severity`（Badge / Tag / Alert 等）、Button 的 `type` / `color` / `variant`、设计令牌 `--m-*`。写业务页时直接跟这套约定走。"
             },
             {
               "title": "组件与令牌",
@@ -33995,7 +34228,7 @@
             {
               "title": "语义与外观",
               "id": "语义与外观",
-              "body": "| 词 | 用在 |\n| --- | --- |\n| `severity` | 语义色：`primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `variant` | 外观：`outlined` / `dashed` / `text` / `link` / `ghost` 等 |\n| `fluid` | 通栏（占满父级宽度） |\n| `size` | `small` / `medium` / `large`（部分控件仍接受 `sm` / `md` / `lg`） |\n| `status` | 表单控件校验态：`error` / `warning` |\n\n按钮默认就是主色实心；次要操作用 `severity=\"secondary\"`，危险操作用 `severity=\"danger\"`。"
+              "body": "| 词 | 用在 |\n| --- | --- |\n| `severity` | Badge / Tag / Alert 等语义色：`primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `type` / `color` / `variant` | Button：`type` 糖（`primary` / `dashed` / `text` / `link`…）+ `color` + `variant`（`solid` / `outlined` / `filled`…） |\n| `fluid` / `block` | 通栏；字段多用 `fluid`，Button / ButtonGroup 用 `block` |\n| `size` | `small` / `medium` / `large`（部分控件仍接受 `sm` / `md` / `lg`） |\n| `status` | 表单控件校验态：`error` / `warning` |\n\n按钮默认是灰色描边（`default` + `outlined`）；主实心用 `type=\"primary\"`，次要动作保持默认或 `type=\"text\"`，危险操作用 `danger` / `color=\"danger\"`。"
             },
             {
               "title": "反馈",
@@ -34017,12 +34250,12 @@
         "en-US": {
           "title": "Conventions",
           "description": "Naming, severity, size, and theme conventions in morya-ui.",
-          "markdown": "---\ntitle: Conventions\norder: 35\ndescription: Naming, severity, size, and theme conventions in morya-ui.\n---\n\n# Conventions\n\nMorya UI has its own vocabulary: `M*` components, `severity` for tone, `variant` for appearance, and `--m-*` design tokens. Follow these conventions when you assemble product UI.\n\n## Components and tokens\n\n| Convention | Meaning |\n| --- | --- |\n| Names | Always `M` prefix: `MButton`, `MDialog`, `MTable` |\n| Theme | `MConfigProvider` plus `useTheme` / `useDensity` / `useMotion` |\n| Color and geometry | `--m-*` only; brand via `--m-color-primary` |\n| Control height | Medium default `32px`; radius `--m-control-radius` |\n| Type weight | Control copy defaults to 400 |\n\nSee [Design tokens](/docs/design-tokens) and [Theme](/docs/theme).\n\n## Tone and appearance\n\n| Word | Use |\n| --- | --- |\n| `severity` | Semantic color: `primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `variant` | Appearance: `outlined` / `dashed` / `text` / `link` / `ghost`, etc. |\n| `fluid` | Full width of the parent |\n| `size` | `small` / `medium` / `large` (some controls still accept `sm` / `md` / `lg`) |\n| `status` | Field validation: `error` / `warning` |\n\nThe default button is a solid primary action. Use `severity=\"secondary\"` for quiet actions and `severity=\"danger\"` for destructive ones.\n\n## Feedback\n\n| Situation | Use |\n| --- | --- |\n| Short result | `message` / `MMessage` |\n| Summary + detail, or async work | `toast` / `MToast` |\n| Confirm | `MConfirmDialog` / `MConfirmPopup` / `useConfirm` |\n| Persistent in-page notice | `MAlert` |\n| Blocking wait | `MLoading` (`MProgressSpinner` for a thin ring) |\n| Progress | `MProgressBar` |\n| Empty / outcome | `MEmpty` / `MResult` |\n\n## Layout and pages\n\nAdmin chrome uses the `MLayout` family; list/filter/stat blocks use `MPage*`. Spacing containers are `MSpace` / `MFlex` / `MGrid`. Join adjacent buttons with `MButtonGroup`.\n\n## Distinctive surfaces\n\nDock, Terminal, Knob, the Page kit, and MCP / Agent Skill sit on the same token system. Prefer the [component docs](/components/Button) and repository `DESIGN.md` when choosing APIs.\n",
+          "markdown": "---\ntitle: Conventions\norder: 35\ndescription: Naming, severity, size, and theme conventions in morya-ui.\n---\n\n# Conventions\n\nMorya UI has its own vocabulary: `M*` components, `severity` for tone on Badge / Tag / Alert, Button `type` / `color` / `variant`, and `--m-*` design tokens. Follow these conventions when you assemble product UI.\n\n## Components and tokens\n\n| Convention | Meaning |\n| --- | --- |\n| Names | Always `M` prefix: `MButton`, `MDialog`, `MTable` |\n| Theme | `MConfigProvider` plus `useTheme` / `useDensity` / `useMotion` |\n| Color and geometry | `--m-*` only; brand via `--m-color-primary` |\n| Control height | Medium default `32px`; radius `--m-control-radius` |\n| Type weight | Control copy defaults to 400 |\n\nSee [Design tokens](/docs/design-tokens) and [Theme](/docs/theme).\n\n## Tone and appearance\n\n| Word | Use |\n| --- | --- |\n| `severity` | Semantic color on Badge / Tag / Alert: `primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `type` / `color` / `variant` | Button: `type` sugar (`primary` / `dashed` / `text` / `link`…) + `color` + `variant` (`solid` / `outlined` / `filled`…) |\n| `fluid` / `block` | Full width; fields mostly use `fluid`, Button / ButtonGroup use `block` |\n| `size` | `small` / `medium` / `large` (some controls still accept `sm` / `md` / `lg`) |\n| `status` | Field validation: `error` / `warning` |\n\nButtons default to gray outlined (`default` + `outlined`). Use `type=\"primary\"` for solid primary, keep the default or `type=\"text\"` for quiet actions, and `danger` / `color=\"danger\"` for destructive ones.\n\n## Feedback\n\n| Situation | Use |\n| --- | --- |\n| Short result | `message` / `MMessage` |\n| Summary + detail, or async work | `toast` / `MToast` |\n| Confirm | `MConfirmDialog` / `MConfirmPopup` / `useConfirm` |\n| Persistent in-page notice | `MAlert` |\n| Blocking wait | `MLoading` (`MProgressSpinner` for a thin ring) |\n| Progress | `MProgressBar` |\n| Empty / outcome | `MEmpty` / `MResult` |\n\n## Layout and pages\n\nAdmin chrome uses the `MLayout` family; list/filter/stat blocks use `MPage*`. Spacing containers are `MSpace` / `MFlex` / `MGrid`. Join adjacent buttons with `MButtonGroup`.\n\n## Distinctive surfaces\n\nDock, Terminal, Knob, the Page kit, and MCP / Agent Skill sit on the same token system. Prefer the [component docs](/components/Button) and repository `DESIGN.md` when choosing APIs.\n",
           "sections": [
             {
               "title": "",
               "id": "overview",
-              "body": "# Conventions\n\nMorya UI has its own vocabulary: `M*` components, `severity` for tone, `variant` for appearance, and `--m-*` design tokens. Follow these conventions when you assemble product UI."
+              "body": "# Conventions\n\nMorya UI has its own vocabulary: `M*` components, `severity` for tone on Badge / Tag / Alert, Button `type` / `color` / `variant`, and `--m-*` design tokens. Follow these conventions when you assemble product UI."
             },
             {
               "title": "Components and tokens",
@@ -34032,7 +34265,7 @@
             {
               "title": "Tone and appearance",
               "id": "tone-and-appearance",
-              "body": "| Word | Use |\n| --- | --- |\n| `severity` | Semantic color: `primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `variant` | Appearance: `outlined` / `dashed` / `text` / `link` / `ghost`, etc. |\n| `fluid` | Full width of the parent |\n| `size` | `small` / `medium` / `large` (some controls still accept `sm` / `md` / `lg`) |\n| `status` | Field validation: `error` / `warning` |\n\nThe default button is a solid primary action. Use `severity=\"secondary\"` for quiet actions and `severity=\"danger\"` for destructive ones."
+              "body": "| Word | Use |\n| --- | --- |\n| `severity` | Semantic color on Badge / Tag / Alert: `primary` / `secondary` / `success` / `info` / `warning` / `danger` |\n| `type` / `color` / `variant` | Button: `type` sugar (`primary` / `dashed` / `text` / `link`…) + `color` + `variant` (`solid` / `outlined` / `filled`…) |\n| `fluid` / `block` | Full width; fields mostly use `fluid`, Button / ButtonGroup use `block` |\n| `size` | `small` / `medium` / `large` (some controls still accept `sm` / `md` / `lg`) |\n| `status` | Field validation: `error` / `warning` |\n\nButtons default to gray outlined (`default` + `outlined`). Use `type=\"primary\"` for solid primary, keep the default or `type=\"text\"` for quiet actions, and `danger` / `color=\"danger\"` for destructive ones."
             },
             {
               "title": "Feedback",