@morya-ui/mcp 0.2.5 → 0.2.7

package/data/example-coverage.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-15T13:16:12.638Z",
-  "catalogGeneratedAt": "2026-09-15T13:16:07.335Z",
+  "generatedAt": "2026-09-18T07:52:19.611Z",
+  "catalogGeneratedAt": "2026-09-18T07:52:14.544Z",
   "components": [
     {
       "id": "Accordion",
@@ -844,12 +844,15 @@
     {
       "id": "Empty",
       "exportName": "MEmpty",
-      "examples": 8,
+      "examples": 12,
       "props": {
-        "total": 5,
-        "covered": 3,
+        "total": 10,
+        "covered": 5,
         "missing": [
+          "showDescription",
+          "showIcon",
           "image",
+          "size",
           "pt"
         ]
       },
@@ -859,13 +862,12 @@
         "missing": []
       },
       "slots": {
-        "total": 6,
+        "total": 5,
         "covered": 2,
         "missing": [
           "icon",
           "image",
-          "title",
-          "description"
+          "title"
         ]
       },
       "methods": {
@@ -2085,12 +2087,11 @@
     {
       "id": "Result",
       "exportName": "MResult",
-      "examples": 8,
+      "examples": 10,
       "props": {
-        "total": 5,
-        "covered": 2,
+        "total": 6,
+        "covered": 4,
         "missing": [
-          "title",
           "icon",
           "pt"
         ]
@@ -2501,10 +2502,10 @@
     {
       "id": "Status",
       "exportName": "MStatus",
-      "examples": 8,
+      "examples": 10,
       "props": {
-        "total": 5,
-        "covered": 4,
+        "total": 8,
+        "covered": 7,
         "missing": [
           "color"
         ]
@@ -2515,9 +2516,11 @@
         "missing": []
       },
       "slots": {
-        "total": 1,
+        "total": 2,
         "covered": 1,
-        "missing": []
+        "missing": [
+          "icon"
+        ]
       },
       "methods": {
         "total": 0,
@@ -3193,6 +3196,6 @@
   "summary": {
     "components": 92,
     "componentsWithMissingCoverage": 87,
-    "totalExamples": 781
+    "totalExamples": 789
   }
 }

package/data/golden-pages/list-page.vue

@@ -26,6 +26,12 @@ import { ref } from 'vue'
 
 const keyword = ref('')
 const status = ref<string | undefined>()
+const siderCollapsed = ref(false)
+
+const menuModel = [
+  { key: 'users', label: '用户管理', icon: 'user', to: '/users' },
+  { key: 'roles', label: '角色管理', icon: 'shield', to: '/roles' },
+]
 
 const statusOptions = [
   { label: '全部', value: '' },
@@ -52,8 +58,13 @@ const rows = [
 <template>
   <MConfigProvider :locale="zhCN">
     <MLayout has-sider fill-viewport>
-      <MLayoutSider bordered>
-        <MMenu :model="[{ label: '用户管理', key: 'users' }, { label: '角色管理', key: 'roles' }]" />
+      <MLayoutSider v-model:collapsed="siderCollapsed" bordered :collapsed-width="72">
+        <MMenu
+          :model="menuModel"
+          :collapsed="siderCollapsed"
+          :collapsed-width="72"
+          selected-key="users"
+        />
       </MLayoutSider>
 
       <MLayout>

package/dist/__tests__/tools.test.js

@@ -167,6 +167,27 @@ describe('@morya-ui/mcp handlers', () => {
         expect(result.ok).toBe(true);
         expect(result.suggestions.some((item) => item.type === 'redundant-wrapper' && item.standardId === 'page-sections')).toBe(true);
     });
+    it('suggests height-chain when MLayout is used without shell CSS', () => {
+        const result = read(handlers.validatePage({
+            code: '<MLayout fill-viewport has-sider><MLayoutContent /></MLayout>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'height-chain')).toBe(true);
+    });
+    it('suggests menu icons when MMenu model has no icon fields', () => {
+        const result = read(handlers.validatePage({
+            code: `<MMenu :model="[{ key: 'users', label: 'Users', to: '/users' }]" />`,
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'menu-missing-icons')).toBe(true);
+    });
+    it('does not suggest menu icons when model items include icon', () => {
+        const result = read(handlers.validatePage({
+            code: `<MMenu :model="[{ key: 'users', label: 'Users', icon: 'user', to: '/users' }]" />`,
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'menu-missing-icons')).toBe(false);
+    });
     it('lists component decision guides when query is omitted', () => {
         const result = read(handlers.recommendComponent({ limit: 5 }));
         expect(result.kind).toBe('decisions');

package/dist/decisions.js

@@ -1,4 +1,46 @@
 export const componentDecisions = [
+    {
+        id: 'form-surface-choice',
+        title: '新建/编辑用弹窗还是独立表单页',
+        titleEn: 'Dialog vs dedicated form page for create/edit',
+        question: '表单是从列表触发的短录入，还是多分组/长流程的独立配置？',
+        questionEn: 'Is this a short create/edit from a list, or a multi-section dedicated form flow?',
+        keywords: ['新建', '编辑', '表单', '弹窗', '路由', 'create', 'edit', 'form', 'dialog', 'page'],
+        options: [
+            {
+                component: 'Dialog',
+                when: [
+                    '从列表/工具栏打开新建或编辑',
+                    '字段大约 ≤8 个、单段表单',
+                    '希望保存后仍停留在列表上下文',
+                ],
+                whenEn: [
+                    'Create/edit is launched from a list or toolbar',
+                    'About ≤8 fields in a single section',
+                    'User should stay in the list context after save',
+                ],
+                avoidWhen: ['多步骤向导', '多分组长配置页'],
+                avoidWhenEn: ['Multi-step wizards', 'Long multi-section configuration pages'],
+            },
+            {
+                component: 'Drawer',
+                when: ['表单比 Dialog 更长但仍需对照列表', '详情+编辑侧滑'],
+                whenEn: ['Form is longer than a dialog but list context matters', 'Detail plus edit in a side panel'],
+                avoidWhen: ['字段极少的确认式录入'],
+                avoidWhenEn: ['Tiny confirmation-style forms'],
+            },
+            {
+                component: 'Form',
+                when: ['用户明确要求独立表单页', '多分组、长校验、离开需确认的配置流'],
+                whenEn: [
+                    'The user explicitly asked for a dedicated form page',
+                    'Multi-section, heavy validation, or leave-confirm configuration flows',
+                ],
+                avoidWhen: ['列表上的常规短 CRUD'],
+                avoidWhenEn: ['Routine short CRUD from a list'],
+            },
+        ],
+    },
     {
         id: 'overlay-choice',
         title: '如何选择浮层组件',
@@ -9,10 +51,23 @@ export const componentDecisions = [
         options: [
             {
                 component: 'Dialog',
-                when: ['需要用户聚焦完成一项短到中等任务', '需要确认危险操作', '内容不适合直接放在页面流中'],
-                whenEn: ['The user should focus on a short or medium-sized task', 'A destructive action needs confirmation', 'Content should not interrupt the page flow'],
-                avoidWhen: ['内容接近完整页面', '用户需要持续查看底层页面上下文'],
-                avoidWhenEn: ['The content is effectively a full page', 'The user must continuously reference the underlying page'],
+                when: [
+                    '需要用户聚焦完成一项短到中等任务',
+                    '列表页上的新建/编辑短表单（约 ≤8 个字段）',
+                    '需要确认危险操作',
+                    '内容不适合直接放在页面流中',
+                ],
+                whenEn: [
+                    'The user should focus on a short or medium-sized task',
+                    'Create/edit short forms launched from a list (~≤8 fields)',
+                    'A destructive action needs confirmation',
+                    'Content should not interrupt the page flow',
+                ],
+                avoidWhen: ['内容接近完整多分组页面', '用户需要持续查看底层页面上下文且表单很长'],
+                avoidWhenEn: [
+                    'The content is effectively a multi-section full page',
+                    'The user must continuously reference the underlying page and the form is long',
+                ],
             },
             {
                 component: 'Drawer',

package/dist/golden-pages.js

@@ -47,7 +47,7 @@ export const goldenPageCatalog = [
 ];
 const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
 const bundledDir = join(pkgRoot, 'data/golden-pages');
-const repoDir = join(pkgRoot, '../../ai-design-config/docs/golden-pages');
+const repoDir = join(pkgRoot, '../../design-kit/docs/golden-pages');
 function resolveGoldenPagesDir() {
     if (existsSync(bundledDir))
         return bundledDir;

package/dist/page-snippets.js

@@ -394,23 +394,51 @@ const recentRows = ref<Record<string, unknown>[]>([])`,
         descriptionEn: 'Minimal MLayout fillViewport shell with header and content.',
         pageTypes: ['common'],
         keywords: ['layout', 'shell', 'breadcrumb', 'sider', 'app'],
-        imports: ['MLayout', 'MLayoutHeader', 'MLayoutContent', 'MBreadcrumb', 'MConfigProvider', 'zhCN'],
+        imports: [
+            'MLayout',
+            'MLayoutHeader',
+            'MLayoutContent',
+            'MLayoutSider',
+            'MMenu',
+            'MBreadcrumb',
+            'MPageContent',
+            'MConfigProvider',
+            'zhCN',
+        ],
         template: `<MConfigProvider :locale="zhCN">
-  <MLayout fill-viewport>
-    <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
-      <MBreadcrumb :model="[{ label: '首页', to: '/' }, { label: '当前页' }]" />
-    </MLayoutHeader>
-    <MLayoutContent>
-      <MPageContent>
-        <!-- page sections -->
-      </MPageContent>
-    </MLayoutContent>
+  <MLayout fill-viewport has-sider>
+    <MLayoutSider v-model:collapsed="siderCollapsed" bordered :collapsed-width="72">
+      <MMenu
+        :model="[
+          { key: 'users', label: '用户管理', icon: 'user', to: '/users' },
+          { key: 'roles', label: '角色管理', icon: 'shield', to: '/roles' },
+        ]"
+        :collapsed="siderCollapsed"
+        :collapsed-width="72"
+      />
+    </MLayoutSider>
+    <MLayout>
+      <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
+        <MBreadcrumb :model="[{ label: '首页', to: '/' }, { label: '当前页' }]" />
+      </MLayoutHeader>
+      <MLayoutContent>
+        <MPageContent>
+          <!-- page sections -->
+        </MPageContent>
+      </MLayoutContent>
+    </MLayout>
   </MLayout>
 </MConfigProvider>`,
-        rules: ['根布局用 fillViewport', '面包屑放 MLayoutHeader'],
-        rulesEn: ['Use fillViewport on the root layout', 'Place breadcrumb in MLayoutHeader'],
-        avoid: ['不要手写 min-height: 100vh'],
-        avoidEn: ['Do not hand-write min-height: 100vh'],
+        rules: [
+            '根布局用 fillViewport',
+            '面包屑放 MLayoutHeader',
+        ],
+        rulesEn: [
+            'Use fillViewport on the root layout',
+            'Place breadcrumb in MLayoutHeader',
+        ],
+        avoid: ['不要在 MLayoutContent 上写 padding'],
+        avoidEn: ['Do not put padding on MLayoutContent'],
     },
     {
         id: 'scrollable-panel',

package/dist/patterns.js

@@ -42,30 +42,32 @@ export const pagePatterns = [
             { component: 'Table', role: '数据展示', reason: 'paginator 启用内置分页' },
             { component: 'Tag', role: '业务状态展示（分类/可关闭）', required: false },
             { component: 'Status', role: '行内状态圆点+文案', required: false },
-            { component: 'Dialog', role: '编辑或删除确认', required: false },
+            { component: 'Dialog', role: '新建/编辑短表单（首选）或删除确认', required: false },
         ],
         structure: [
             'MConfigProvider',
-            '└── MLayout (has-sider)',
-            '    ├── MLayoutSider → MMenu (optional)',
+            '└── MLayout (has-sider fill-viewport)',
+            '    ├── MLayoutSider → MMenu',
             '    └── MLayout',
             '        ├── MLayoutHeader → MBreadcrumb',
             '        └── MLayoutContent',
             '            └── MPageContent',
             '                ├── MPageFilters (MSpace + MInput + MSelect + MButton)',
             '                ├── MPageToolbar (title + primary action)',
-            '                └── MTable (paginator, #cell-* slots, #empty)',
+            '                ├── MTable (paginator, #cell-* slots, #empty)',
+            '                └── MDialog (create/edit MForm, optional)',
         ],
         layout: {
             page: 'MLayout fillViewport + has-sider；MLayoutContent 内用 MPageContent 堆叠区块',
             header: 'MLayoutHeader 放面包屑；标题与主操作用 MPageToolbar',
             filters: 'MPageFilters 包裹筛选控件；内部 MSpace wrap 或 MFlex',
             data: 'MTable 直接放在 MPageContent 内，不要额外 MCard；paginator + #empty',
+            form: '列表新建/编辑默认 MDialog + MForm，不要默认拆独立表单路由',
         },
         styleRules: [
             '新增、保存等主操作使用 primary MButton',
             '查询等次要操作使用 secondary 或 outlined MButton',
-            '删除使用 danger MButton，并配合 MDialog 或 MConfirmDialog',
+            '删除使用 danger MButton，并配合 MConfirmDialog',
             '业务状态优先使用 MStatus（圆点+文案）或 MTag（分类标签），不使用 Button severity 表达状态',
             '间距、颜色、圆角优先使用 --m-* 设计令牌，不直接硬编码色板',
         ],
@@ -74,10 +76,12 @@ export const pagePatterns = [
             '加载中禁用重复提交并显示 loading 状态',
             '空数据使用 MTable #empty 插槽或 DataView 空态，不渲染空白表格',
             '行级危险操作必须有确认反馈',
+            '新建/编辑短表单用 MDialog，保存成功 message.success 并关闭弹窗',
             'CRUD 成功/删除等单行回执使用 message API，不要默认 Toast',
         ],
         avoid: [
             '不要用 MDialog 承载完整列表页',
+            '不要为列表短 CRUD 默认生成 /entities/new 独立表单路由',
             '不要用 MButton 代替业务状态标签',
             '不要为每个筛选字段手写一套不一致的 label 和间距',
             '不要用 toast.add({ summary }) 代替 message.success 表达单行操作结果',
@@ -139,10 +143,50 @@ export const pagePatterns = [
         ],
         avoid: [
             '不要绕过 MForm 直接手写不一致的字段校验状态',
-            '不要把完整编辑流程塞进过窄的 Dialog，除非字段很少',
+            '列表上的短新建/编辑优先 MDialog，不要默认拆成独立路由表单页',
+            '不要把完整多分组编辑流程塞进过窄的 Dialog；字段很多时用独立表单页或 MDrawer',
             '不要使用 placeholder 代替 label',
         ],
     },
+    {
+        id: 'form-in-dialog',
+        title: '列表内新建 / 编辑弹窗',
+        titleEn: 'Create or edit in a dialog from a list',
+        description: '从列表触发的短表单 CRUD：留在列表页，用 MDialog 承载 MForm。',
+        descriptionEn: 'Short CRUD forms launched from a list: keep the list page and host MForm in MDialog.',
+        keywords: ['弹窗表单', '新建弹窗', '编辑弹窗', '列表新建', 'dialog form', 'modal form', 'inline create', 'inline edit'],
+        components: [
+            { component: 'Dialog', role: '承载短表单' },
+            { component: 'Form', role: '声明式校验' },
+            { component: 'FormItem', role: '字段标签与校验', required: false },
+            { component: 'Input', role: '文本字段' },
+            { component: 'Select', role: '枚举字段', required: false },
+            { component: 'Button', role: '页脚保存/取消' },
+        ],
+        structure: [
+            '列表页（list-page）',
+            '└── MDialog',
+            '    ├── MForm + 字段',
+            '    └── #footer → 取消 / 保存',
+        ],
+        layout: {
+            host: '留在列表页，不另开路由',
+            dialog: 'MDialog 承载短表单；宽度约 28–36rem',
+            form: 'MForm + 字段；页脚用 Dialog #footer',
+        },
+        styleRules: [
+            'Dialog 宽度约 28–36rem；树/长内容区可限高滚动',
+            '页脚用 Dialog #footer，不要把主按钮只放在表单流末尾却看不见',
+        ],
+        interactionRules: [
+            '保存成功后关闭 Dialog 并 message.success',
+            '取消或关闭丢弃未保存草稿（或按产品要求提示）',
+        ],
+        avoid: [
+            '不要为 ≤8 字段的列表 CRUD 再开 /entities/new 路由',
+            '不要用 Toast 代替单行 message 回执',
+        ],
+    },
     {
         id: 'dashboard',
         title: '仪表盘 / 监控工作台',
@@ -471,12 +515,12 @@ export const pageStandards = [
             'Call get_golden_page before writing a full page and copy the matching structure',
         ],
         discouraged: [
-            '手写 min-height:100vh',
+            '手写 min-height:100vh 代替 Layout',
             '在 MLayoutContent 上写 padding/gap',
             '嵌套多层 MPageContent',
         ],
         discouragedEn: [
-            'Hand-written min-height:100vh',
+            'Hand-written min-height:100vh instead of Layout',
             'Padding/gap on MLayoutContent instead of MPageContent',
             'Nesting multiple MPageContent shells',
         ],

package/dist/tools.js

@@ -927,6 +927,29 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     : '标准建议：整页高度优先 MLayout fillViewport，少写 min-height:100vh。',
             });
         }
+        if ((/fill-viewport|fillViewport/i.test(code) || /<MLayout\b/i.test(code))
+            && !/html\s*,\s*body\s*,\s*#app[\s\S]{0,80}height\s*:\s*100%/i.test(code)) {
+            suggestions.push({
+                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）。',
+            });
+        }
+        if (/<MMenu\b/i.test(code)) {
+            const iconCount = (code.match(/\bicon\s*:/g) || []).length;
+            const looksLikeMenuModel = /MMenu[\s\S]{0,1200}\b(label|model)\s*[:=]/i.test(code) || /:model=/i.test(code);
+            if (looksLikeMenuModel && iconCount === 0) {
+                suggestions.push({
+                    standardId: 'layout-shell',
+                    type: 'menu-missing-icons',
+                    message: locale === 'en-US'
+                        ? 'Prefer golden / layout-app-shell menu items that include icon (e.g. user, shield, home).'
+                        : '对齐黄金样例 / layout-app-shell：侧栏菜单项带上 icon（如 user、shield、home）。',
+                });
+            }
+        }
         return textResult({
             ok: true,
             advisory: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/mcp",
   "type": "module",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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",