@morya-ui/mcp 0.2.7 → 0.2.9

package/dist/decisions.js

@@ -136,7 +136,7 @@ export const componentDecisions = [
         titleEn: 'Choosing a selection control',
         question: '选项是平面少量、层级结构、多选标签，还是需要输入搜索？',
         questionEn: 'Are options a small flat set, a hierarchy, multi-select tags, or searchable input?',
-        keywords: ['选择', '下拉', '多选', '树选择', '搜索选择', 'select', 'treeselect', 'autocomplete', 'dropdown'],
+        keywords: ['选择', '下拉', '多选', '树选择', '搜索选择', '级联', '列表选择', '按钮组', 'select', 'treeselect', 'autocomplete', 'cascadeselect', 'listbox', 'selectbutton', 'radio', 'dropdown'],
         options: [
             {
                 component: 'Select',
@@ -159,6 +159,34 @@ export const componentDecisions = [
                 avoidWhen: ['用户只能从固定枚举中选择', '不应该允许自由输入'],
                 avoidWhenEn: ['Users must choose from a fixed enum', 'Free input must not be allowed'],
             },
+            {
+                component: 'SelectButton',
+                when: ['选项很少且需要全部露出', '单选或多选都适合按钮组'],
+                whenEn: ['Only a few options, and all of them should stay visible', 'Single or multiple selection works as a button group'],
+                avoidWhen: ['选项超过大约 5 个', '选项很长或来自远程搜索'],
+                avoidWhenEn: ['More than about five options', 'Labels are long or options come from remote search'],
+            },
+            {
+                component: 'Radio',
+                when: ['少量互斥选项需要和表单文案一起阅读', '一次只能选一个'],
+                whenEn: ['A few mutually exclusive options should be read with the form copy', 'Only one value can be selected'],
+                avoidWhen: ['多选', '选项很多需要收进弹出层'],
+                avoidWhenEn: ['Multiple selection', 'Too many options for an always-visible list'],
+            },
+            {
+                component: 'Listbox',
+                when: ['选项需要始终以列表展示', '可筛选，但不希望收成下拉框'],
+                whenEn: ['Options should stay visible as a list', 'Filtering is useful, but a collapsed dropdown is not'],
+                avoidWhen: ['页面空间紧、只需要一个闭合的选择框'],
+                avoidWhenEn: ['Space is tight and a closed select is enough'],
+            },
+            {
+                component: 'CascadeSelect',
+                when: ['值要按多级分栏逐级点选', '层级是路径而不是可勾选的树'],
+                whenEn: ['The value is chosen column by column through levels', 'The hierarchy is a path, not a checkable tree'],
+                avoidWhen: ['需要勾选树节点或搜索整棵树'],
+                avoidWhenEn: ['Users need to check tree nodes or search the whole tree'],
+            },
         ],
     },
     {
@@ -383,6 +411,182 @@ export const componentDecisions = [
             },
         ],
     },
+    {
+        id: 'loading-choice',
+        title: '如何选择加载反馈',
+        titleEn: 'Choosing a loading indicator',
+        question: '这是区域或全屏等待、已知布局的占位、可量化进度，还是只需要阻止交互？',
+        questionEn: 'Is this a region or fullscreen wait, a placeholder for a known layout, measurable progress, or interaction blocking without a loading message?',
+        keywords: [
+            '加载',
+            '等待',
+            '遮罩',
+            '骨架',
+            '进度',
+            'loading',
+            'spinner',
+            'skeleton',
+            'progress',
+            'v-loading',
+            'mloading',
+        ],
+        options: [
+            {
+                component: 'Loading',
+                when: [
+                    '一块区域或整页正在等待，用户暂时不能操作这块内容',
+                    '需要加载文案、多种动效，或用 v-loading / loading.service 盖住已有节点',
+                    '全屏提交、保存、跳转前的短暂等待',
+                ],
+                whenEn: [
+                    'A region or the whole page is waiting and that content should not be operated',
+                    'A caption, effect, v-loading, or loading.service mask over an existing node is needed',
+                    'A short fullscreen wait before submit, save, or navigation',
+                ],
+                avoidWhen: ['布局已知、希望用占位块避免跳动', '进度可以量化', '只是按钮自己的 loading 状态'],
+                avoidWhenEn: [
+                    'The layout is known and a placeholder should prevent jump',
+                    'Progress can be measured',
+                    'Only the button’s own loading state is needed',
+                ],
+            },
+            {
+                component: 'Skeleton',
+                when: ['内容结构已知，用占位块表示即将出现的卡片、文本或列表', '仪表盘或详情初次进入'],
+                whenEn: ['The content structure is known and placeholders stand in for cards, text, or lists', 'First paint of a dashboard or detail view'],
+                avoidWhen: ['需要明确的“正在加载”遮罩', '进度可量化'],
+                avoidWhenEn: ['An explicit loading mask is required', 'Progress can be measured'],
+            },
+            {
+                component: 'ProgressBar',
+                when: ['进度有百分比或可估算完成度', '上传、导入等长任务'],
+                whenEn: ['Progress has a percentage or an estimated completion', 'Long tasks such as upload or import'],
+                avoidWhen: ['不知道还要等多久', '只是挡住一块区域'],
+                avoidWhenEn: ['Duration is unknown', 'The only goal is to cover a region'],
+            },
+            {
+                component: 'ProgressSpinner',
+                when: ['行内或控件旁需要一个很小的转圈，不盖住内容'],
+                whenEn: ['A small inline spinner beside a control, without covering content'],
+                avoidWhen: ['区域遮罩、全屏等待或带文案的加载态'],
+                avoidWhenEn: ['A region mask, fullscreen wait, or loading state with a caption'],
+            },
+            {
+                component: 'BlockUI',
+                when: ['只需要阻止点击，不需要表达“正在加载”'],
+                whenEn: ['Interaction should be blocked without saying that something is loading'],
+                avoidWhen: ['用户需要知道正在等待结果'],
+                avoidWhenEn: ['The user needs to know a result is still pending'],
+            },
+        ],
+    },
+    {
+        id: 'status-label-choice',
+        title: '如何选择状态与标签',
+        titleEn: 'Choosing status, tag, chip, or badge',
+        question: '这是行内业务状态、分类标签、可移除实体，还是挂在控件上的数量？',
+        questionEn: 'Is this an inline business status, a category label, a removable entity, or a count on another control?',
+        keywords: ['行内状态', '状态点', '角标', '徽章', '可关闭标签', '芯片', 'status', 'badge', 'chip', 'tag', 'closable'],
+        options: [
+            {
+                component: 'Status',
+                when: ['表格单元格或标题旁的业务状态', '需要圆点或语义图标加短文案'],
+                whenEn: ['Business status in a table cell or beside a title', 'A dot or semantic icon plus a short label'],
+                avoidWhen: ['可关闭的分类标签', '挂在按钮上的数字'],
+                avoidWhenEn: ['A closable category label', 'A count attached to a button'],
+            },
+            {
+                component: 'Tag',
+                when: ['分类、筛选结果或可关闭标签', '需要比 Status 更像芯片的表面'],
+                whenEn: ['A category, filter result, or closable label', 'A chip-like surface rather than an inline status'],
+                avoidWhen: ['只是一行里的轻量状态', '带图片且代表一个可移除实体'],
+                avoidWhenEn: ['A lightweight inline status', 'An entity with an image that can be removed'],
+            },
+            {
+                component: 'Chip',
+                when: ['短实体信息，可带图标、图片和移除'],
+                whenEn: ['A short entity that may include an icon, image, and remove action'],
+                avoidWhen: ['纯状态色点', '只是分类色块'],
+                avoidWhenEn: ['A status dot only', 'A category color block only'],
+            },
+            {
+                component: 'Badge',
+                when: ['角标数量或圆点，附着在按钮、头像等控件上'],
+                whenEn: ['A count or dot attached to a button, avatar, or other control'],
+                avoidWhen: ['独立成行的状态文案'],
+                avoidWhenEn: ['A standalone status sentence'],
+            },
+        ],
+    },
+    {
+        id: 'empty-result-choice',
+        title: '空态还是结果页',
+        titleEn: 'Empty state vs result page',
+        question: '这是没有数据，还是流程已经结束的成功、失败或 HTTP 状态？',
+        questionEn: 'Is there simply no data, or has a flow ended in success, failure, or an HTTP status?',
+        keywords: ['空状态', '无数据', '首次使用', '筛选无结果', '结果页', '404', '403', '500', 'empty', 'result'],
+        options: [
+            {
+                component: 'Empty',
+                when: ['列表没有行', '筛选没有命中', '首次使用，需要引导创建'],
+                whenEn: ['A list has no rows', 'Filters matched nothing', 'First use, and the next step is to create something'],
+                avoidWhen: ['接口失败', '无权限', '页面不存在', '提交成功回执'],
+                avoidWhenEn: ['The request failed', 'Permission was denied', 'The page does not exist', 'A submit-success receipt'],
+            },
+            {
+                component: 'Result',
+                when: ['提交成功或失败的终点页', '403 / 404 / 500 等阻断状态', '需要明确的下一步（返回、重试、回首页）'],
+                whenEn: ['A terminal success or failure page', 'A blocking 403 / 404 / 500 state', 'The next step must be explicit (back, retry, home)'],
+                avoidWhen: ['正常的无数据', '表格内部的空行'],
+                avoidWhenEn: ['A normal empty collection', 'The empty slot inside a table'],
+            },
+        ],
+    },
+    {
+        id: 'action-menu-choice',
+        title: '如何选择菜单',
+        titleEn: 'Choosing a menu',
+        question: '这是按钮上的操作项、侧栏导航、右键菜单，还是全局命令搜索？',
+        questionEn: 'Is this an action menu on a trigger, sider navigation, a context menu, or a global command search?',
+        keywords: ['动作菜单', '右键', '右键菜单', '命令面板', '导航菜单', 'context menu', 'command menu', 'menubar', '上下文菜单'],
+        options: [
+            {
+                component: 'Dropdown',
+                when: ['从按钮或图标打开一组操作', '编辑、删除、更多'],
+                whenEn: ['Actions open from a button or icon', 'Edit, delete, or more'],
+                avoidWhen: ['表单里选一个枚举值', '常驻侧栏导航'],
+                avoidWhenEn: ['Choosing an enum in a form', 'Persistent sider navigation'],
+            },
+            {
+                component: 'Menu',
+                when: ['后台侧栏或页面内的常驻导航', '需要选中项与路由同步'],
+                whenEn: ['Persistent navigation in an admin sider or page', 'Selection should stay in sync with the route'],
+                avoidWhen: ['一次性操作菜单', '右键弹出'],
+                avoidWhenEn: ['A one-shot action menu', 'A right-click popup'],
+            },
+            {
+                component: 'ContextMenu',
+                when: ['在指针位置弹出，通常由右键触发'],
+                whenEn: ['The menu opens at the pointer, usually from a right-click'],
+                avoidWhen: ['可见的导航', '表单选择'],
+                avoidWhenEn: ['Visible navigation', 'Form selection'],
+            },
+            {
+                component: 'CommandMenu',
+                when: ['全局搜索命令或跳转', '键盘优先，例如 Cmd/Ctrl+K'],
+                whenEn: ['Global command search or jump', 'Keyboard-first, such as Cmd/Ctrl+K'],
+                avoidWhen: ['少量固定操作放在按钮旁即可'],
+                avoidWhenEn: ['A few fixed actions fit next to a button'],
+            },
+            {
+                component: 'Menubar',
+                when: ['顶部应用菜单，项很多且分组'],
+                whenEn: ['A top application menu with many grouped items'],
+                avoidWhen: ['侧栏只有一层链接'],
+                avoidWhenEn: ['The sider is a single level of links'],
+            },
+        ],
+    },
 ];
 export function findDecision(name) {
     const key = name.trim().toLowerCase().replace(/[-_\s]/g, '');

package/dist/page-snippets.js

@@ -61,7 +61,7 @@ const statusOptions = [
         descriptionEn: 'Standard MTable placed directly in MPageContent without an extra Card wrapper.',
         pageTypes: ['list'],
         keywords: ['表格', 'table', 'pagination', 'paginator', 'empty', 'columns', 'rows'],
-        imports: ['MTable'],
+        imports: ['MTable', 'MEmpty', 'MButton'],
         scriptSetup: `const columns = [
   { key: 'name', label: '名称' },
   { key: 'status', label: '状态' },
@@ -82,13 +82,19 @@ const loading = ref(false)`,
   aria-label="数据列表"
 >
   <template #empty>
-    <p style="margin:0;padding:var(--m-space-8);text-align:center;color:var(--m-color-text-muted)">
-      暂无数据
-    </p>
+    <MEmpty
+      title="还没有数据"
+      description="创建第一条记录后，这里会列出结果。"
+      icon="inbox"
+    >
+      <template #extra>
+        <MButton severity="primary">新建</MButton>
+      </template>
+    </MEmpty>
   </template>
 </MTable>`,
-        rules: ['表格直接放在 MPageContent 内', '空态用 #empty，不要留空白区域'],
-        rulesEn: ['Place the table directly in MPageContent', 'Use #empty for zero-data states'],
+        rules: ['表格直接放在 MPageContent 内', '空态用 MEmpty，不要留空白或单行灰字'],
+        rulesEn: ['Place the table directly in MPageContent', 'Use MEmpty for zero-data states, not a blank or muted sentence'],
         avoid: ['不要用 MCard 包裹 bordered MTable'],
         avoidEn: ['Do not wrap a bordered MTable with MCard'],
     },
@@ -103,12 +109,12 @@ const loading = ref(false)`,
         imports: ['MSpace', 'MButton'],
         template: `<template #cell-actions>
   <MSpace>
-    <MButton severity="secondary" size="small">编辑</MButton>
-    <MButton severity="danger" size="small">删除</MButton>
+    <MButton severity="secondary" size="small" text>编辑</MButton>
+    <MButton severity="danger" size="small" text>删除</MButton>
   </MSpace>
 </template>`,
-        rules: ['行内操作用 size="small"', '危险操作使用 severity="danger" 并配合确认弹窗'],
-        rulesEn: ['Use size="small" for row actions', 'Use severity="danger" with confirmation for destructive actions'],
+        rules: ['行内操作用 size="small" + text/outlined，避免一排实心按钮', '危险操作使用 severity="danger" 并配合确认弹窗'],
+        rulesEn: ['Use size="small" with text/outlined row actions', 'Use severity="danger" with confirmation for destructive actions'],
         avoid: ['不要用 Dropdown 代替明确的行内按钮组，除非操作很多'],
         avoidEn: ['Do not replace explicit row buttons with Dropdown unless there are many actions'],
     },
@@ -116,8 +122,8 @@ const loading = ref(false)`,
         id: 'list-status-tag',
         title: '表格状态列 Tag',
         titleEn: 'Table status tag cell',
-        description: '在 #cell-status 中用 MTag 展示业务状态。',
-        descriptionEn: 'Render business status with MTag in #cell-status.',
+        description: '在 #cell-status 中用 MTag 展示分类标签（业务状态优先用 list-status-dot / MStatus）。',
+        descriptionEn: 'Render category labels with MTag in #cell-status (prefer MStatus for business status).',
         pageTypes: ['list'],
         keywords: ['状态', 'tag', 'status', 'cell-status'],
         imports: ['MTag'],
@@ -313,18 +319,22 @@ const submitting = ref(false)`,
         descriptionEn: 'Recent records in a small MTable inside MCard.',
         pageTypes: ['dashboard'],
         keywords: ['recent', '最近', 'table', 'card', 'list'],
-        imports: ['MCard', 'MTable', 'MTag'],
+        imports: ['MCard', 'MTable', 'MStatus'],
         scriptSetup: `const recentColumns = [
   { key: 'id', label: '工单号', width: 96 },
   { key: 'title', label: '标题' },
-  { key: 'status', label: '状态', width: 96 },
+  { key: 'status', label: '状态', width: 110 },
 ]
 const recentRows = ref<Record<string, unknown>[]>([])`,
         template: `<MCard title="最近工单">
-  <MTable :columns="recentColumns" :rows="recentRows" size="small" :paginator="false" bordered />
+  <MTable :columns="recentColumns" :rows="recentRows" size="small" :paginator="false" bordered row-key="id">
+    <template #cell-status="{ value }">
+      <MStatus :label="String(value ?? '')" severity="secondary" />
+    </template>
+  </MTable>
 </MCard>`,
-        rules: ['明细列表放 MCard 内合理', 'size="small" 适合卡片内表格'],
-        rulesEn: ['Detail lists inside MCard are appropriate', 'Use size="small" for in-card tables'],
+        rules: ['明细列表放 MCard 内合理', 'size="small" 适合卡片内表格', '行内业务状态用 MStatus'],
+        rulesEn: ['Detail lists inside MCard are appropriate', 'Use size="small" for in-card tables', 'Use MStatus for row business status'],
         avoid: ['卡片内表格不要再外包一层 MPageContent'],
         avoidEn: ['Do not wrap in-card tables with another MPageContent'],
     },

package/dist/patterns.d.ts

@@ -92,13 +92,15 @@ export declare const designRules: {
     readonly status: {
         readonly preferred: "MStatus";
         readonly chip: "MTag";
+        readonly badge: "MBadge";
+        readonly entity: "MChip";
         readonly mapping: {
             readonly active: "success";
             readonly pending: "warn";
             readonly disabled: "secondary";
             readonly error: "danger";
         };
-        readonly note: "行内轻量状态用 MStatus；芯片/可关闭标签用 MTag";
+        readonly note: "行内轻量状态用 MStatus；分类或可关闭标签用 MTag；数量角标用 MBadge；可移除实体用 MChip";
     };
     readonly feedback: {
         readonly default: "message";
@@ -126,7 +128,7 @@ export declare const designRules: {
             readonly api: "field errorMessage | token-styled role=alert";
             readonly when: readonly ["登录/表单区常驻错误：优先字段 errorMessage", "表单级总结：使用 --m-* 样式的 role=alert 条（见 login-page 黄金样例）", "MMessage 组件当前主要为 message 服务宿主，勿臆造 severity 子节点 API"];
         };
-        readonly doc: "docs/feedback-message-vs-toast.md";
+        readonly doc: "design-kit/.agents/skills/morya-ui-pages/references/feedback.md";
     };
     readonly global: readonly ["优先使用组件库组件和 --m-* Token", "操作反馈默认 message；仅一行文案时优先于 toast", "空态用 MEmpty；结果/阻断页用 MResult；行内状态优先 MStatus", "图标按钮建议提供 aria-label；表单字段建议有可见 label", "浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo", "优先使用组件 documented variant，少写深层 CSS 覆盖"];
 };

package/dist/patterns.js

@@ -5,7 +5,7 @@ export const pagePatterns = [
         titleEn: 'Admin list page',
         description: '用于资源管理、设备管理、用户管理等带筛选和行操作的数据列表。',
         descriptionEn: 'A resource-management list with filters, actions, row operations, and pagination.',
-        goldenPage: 'docs/golden-pages/list-page.vue',
+        goldenPage: 'list-page',
         keywords: [
             '列表',
             '表格',
@@ -93,7 +93,7 @@ export const pagePatterns = [
         titleEn: 'Create or edit form page',
         description: '用于创建或编辑业务对象，包含分组字段、校验和提交状态。',
         descriptionEn: 'A create or edit page with grouped fields, validation, and submit states.',
-        goldenPage: 'docs/golden-pages/form-page.vue',
+        goldenPage: 'form-page',
         keywords: ['表单', '新增', '编辑', '创建', '配置', '设置', 'form', 'create', 'edit', 'settings'],
         components: [
             { component: 'ConfigProvider', role: '应用根包裹' },
@@ -216,7 +216,7 @@ export const pagePatterns = [
             { component: 'Button', role: '刷新、查看详情和快捷操作', required: false },
             { component: 'Skeleton', role: '初始加载占位', required: false },
         ],
-        goldenPage: 'docs/golden-pages/dashboard-page.vue',
+        goldenPage: 'dashboard-page',
         structure: [
             'ConfigProvider',
             '└── Layout',
@@ -267,7 +267,7 @@ export const pagePatterns = [
         titleEn: 'Empty state / no results page',
         description: '用于首次使用、搜索无结果、资源已清空或暂时没有内容的场景。',
         descriptionEn: 'For first use, no search results, empty resources, or temporarily unavailable content.',
-        goldenPage: 'docs/golden-pages/empty-state.vue',
+        goldenPage: 'empty-state',
         keywords: ['空状态', '无数据', '无结果', '首次使用', 'empty', 'no results', 'no data', 'zero state'],
         components: [
             { component: 'PageContent', role: '承载空态的内容区', required: false },
@@ -297,7 +297,7 @@ export const pagePatterns = [
         titleEn: 'Login / authentication page',
         description: '用于登录、注册、找回密码和二次认证流程。',
         descriptionEn: 'For login, registration, password recovery, and second-factor authentication flows.',
-        goldenPage: 'docs/golden-pages/login-page.vue',
+        goldenPage: 'login-page',
         keywords: ['登录', '注册', '认证', '密码', '验证码', 'login', 'register', 'authentication', 'password', 'otp'],
         components: [
             { component: 'ConfigProvider', role: '应用根包裹' },
@@ -329,7 +329,7 @@ export const pagePatterns = [
         titleEn: 'Marketing landing page',
         description: '用于产品官网、发布页、定价前导等公开营销表面；首屏单一任务，控件仍用 morya-ui。',
         descriptionEn: 'Public marketing surfaces (product home, launch, pre-pricing). One job in the first viewport; controls still use morya-ui.',
-        goldenPage: 'docs/golden-pages/landing-page.vue',
+        goldenPage: 'landing-page',
         keywords: [
             '落地页',
             '营销',
@@ -432,7 +432,7 @@ export const pagePatterns = [
             '不使用大面积自定义背景色覆盖组件库 surface Token',
         ],
         interactionRules: [
-            '详情加载中使用 Skeleton 或 ProgressSpinner',
+            '已知布局用 Skeleton 占位；区域或全屏等待用 Loading（MLoading / v-loading / loading.service）',
             '资源不存在用 MResult status="404"；列表空数据用 MEmpty，不要混用',
             '危险操作必须确认并在成功后刷新或离开当前详情页',
         ],
@@ -693,8 +693,10 @@ export const designRules = {
     status: {
         preferred: 'MStatus',
         chip: 'MTag',
+        badge: 'MBadge',
+        entity: 'MChip',
         mapping: { active: 'success', pending: 'warn', disabled: 'secondary', error: 'danger' },
-        note: '行内轻量状态用 MStatus；芯片/可关闭标签用 MTag',
+        note: '行内轻量状态用 MStatus；分类或可关闭标签用 MTag；数量角标用 MBadge；可移除实体用 MChip',
     },
     feedback: {
         default: 'message',
@@ -726,7 +728,7 @@ export const designRules = {
                 'MMessage 组件当前主要为 message 服务宿主，勿臆造 severity 子节点 API',
             ],
         },
-        doc: 'docs/feedback-message-vs-toast.md',
+        doc: 'design-kit/.agents/skills/morya-ui-pages/references/feedback.md',
     },
     global: [
         '优先使用组件库组件和 --m-* Token',

package/dist/tools.js

@@ -933,8 +933,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 standardId: 'layout-shell',
                 type: 'height-chain',
                 message: locale === 'en-US'
-                    ? 'Prefer layout-app-shell / golden pages: include html, body, #app { height: 100% } (morya-app-shell.css) with MLayout.'
-                    : '对齐 layout-app-shell / 黄金样例：配合 MLayout 使用 html, body, #app { height: 100% }（morya-app-shell.css）。',
+                    ? 'Prefer layout-app-shell / golden pages: with MLayout, set html, body, #app { height: 100% } when the shell is not using fillViewport.'
+                    : '对齐 layout-app-shell / 黄金样例：未使用 fillViewport 时，配合 MLayout 设置 html, body, #app { height: 100% }。',
             });
         }
         if (/<MMenu\b/i.test(code)) {
@@ -1003,13 +1003,25 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 destructive: { component: 'MButton', props: ['severity="danger"'], requiresConfirmation: true },
                 cancel: { component: 'MButton', props: ['severity="secondary"', 'text'] },
             },
-            status: { component: 'MTag', mapping: { active: 'success', pending: 'warn', disabled: 'secondary', error: 'danger' } },
+            status: {
+                preferred: 'MStatus',
+                chip: 'MTag',
+                badge: 'MBadge',
+                entity: 'MChip',
+                mapping: { active: 'success', pending: 'warn', disabled: 'secondary', error: 'danger' },
+                note: 'Inline status uses MStatus; category or closable labels use MTag; counts use MBadge.',
+            },
             feedback: {
                 default: 'message',
                 message: { when: ['single-line action result', 'save/delete/create confirmations'] },
                 toast: { when: ['summary + detail', 'async or background notifications'] },
-                inlineMessage: { api: 'field errorMessage | token-styled role=alert', when: ['persistent form/auth errors'] },
-                doc: 'docs/feedback-message-vs-toast.md',
+                empty: { component: 'MEmpty', when: ['no rows', 'no filter matches', 'first use'] },
+                result: { component: 'MResult', when: ['terminal success/failure', '403 / 404 / 500'] },
+                inlineMessage: {
+                    api: 'field errorMessage | token-styled role=alert',
+                    when: ['persistent form/auth errors; MMessage is the message host, not an inline alert'],
+                },
+                doc: 'design-kit/.agents/skills/morya-ui-pages/references/feedback.md',
             },
             global: [
                 'Prefer library components and --m-* tokens.',
@@ -1104,6 +1116,14 @@ export function createToolHandlers(catalog = loadCatalog()) {
             install: 'pnpm add morya-ui',
             peer: 'vue@^3.3.0',
             styles: "import 'morya-ui/styles.css'",
+            aiSetup: {
+                command: 'npx @morya-ui/setup',
+                skill: 'morya-ui-pages',
+                mcp: 'npx -y @morya-ui/mcp',
+                note: locale === 'en-US'
+                    ? 'setup installs the library, copies the page skill and Cursor rules, and merges MCP. Table data uses the rows prop. MMessage is the message host, not an inline alert.'
+                    : 'setup 会安装组件库、复制页面 skill 与 Cursor 规则，并合并 MCP。表格数据用 rows。MMessage 是 message 宿主，不是内嵌 Alert。',
+            },
             guides: {
                 introduction: pickMarkdown(intro),
                 quickStart: pickMarkdown(quickStart),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/mcp",
   "type": "module",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "MCP server for morya-ui — component docs, examples, and usage guidance for AI coding agents.",
   "license": "MIT",
   "homepage": "https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp#readme",