@morya-ui/mcp 0.2.4 → 0.2.6

package/dist/patterns.js

@@ -40,32 +40,35 @@ export const pagePatterns = [
             { component: 'Select', role: '枚举或状态筛选' },
             { component: 'Button', role: '查询、新增和行操作' },
             { component: 'Table', role: '数据展示', reason: 'paginator 启用内置分页' },
-            { component: 'Tag', role: '业务状态展示' },
-            { component: 'Dialog', role: '编辑或删除确认', required: false },
+            { component: 'Tag', role: '业务状态展示（分类/可关闭）', required: false },
+            { component: 'Status', 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',
-            '业务状态使用 MTag，不使用 Button severity 表达状态',
+            '删除使用 danger MButton，并配合 MConfirmDialog',
+            '业务状态优先使用 MStatus（圆点+文案）或 MTag（分类标签），不使用 Button severity 表达状态',
             '间距、颜色、圆角优先使用 --m-* 设计令牌，不直接硬编码色板',
         ],
         interactionRules: [
@@ -73,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 表达单行操作结果',
@@ -138,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: '仪表盘 / 监控工作台',
@@ -163,7 +208,10 @@ export const pagePatterns = [
             { component: 'GridItem', role: '栅格子项' },
             { component: 'Card', role: '图表与列表明细分区' },
             { component: 'Icon', role: 'KPI 图标', required: false },
-            { component: 'Tag', role: '状态和告警级别' },
+            { component: 'Tag', role: '分类标签和告警级别', required: false },
+            { component: 'Status', role: '行内状态圆点+文案', required: false },
+            { component: 'Empty', role: '明细表空态', required: false },
+            { component: 'Result', role: '接口失败结果区', required: false },
             { component: 'Table', role: '明细数据', required: false },
             { component: 'Button', role: '刷新、查看详情和快捷操作', required: false },
             { component: 'Skeleton', role: '初始加载占位', required: false },
@@ -186,8 +234,8 @@ export const pagePatterns = [
             content: '图表和明细按业务优先级排列，重要告警靠前',
             responsive: '多列网格在窄屏降为单列或两列',
         },
-        styleRules: ['指标使用 text hierarchy，不用大面积高饱和背景', '状态和告警使用 MTag 等语义组件', '图表容器使用 Card 和 --m-* Token 保持表面一致', '实时刷新操作使用 secondary 或 text MButton'],
-        interactionRules: ['首次加载使用 Skeleton', '无数据和接口错误必须有明确状态', '刷新中禁用重复请求并保留上次数据', '告警需要可追踪到详情或处理入口'],
+        styleRules: ['指标使用 text hierarchy，不用大面积高饱和背景', '状态用 MStatus / 告警级别用 MTag', '图表容器使用 Card 和 --m-* Token 保持表面一致', '实时刷新操作使用 secondary 或 text MButton'],
+        interactionRules: ['首次加载使用 Skeleton', '无数据用 MEmpty；接口错误用 MResult 或 Message', '刷新中禁用重复请求并保留上次数据', '告警需要可追踪到详情或处理入口'],
         avoid: ['不要把所有信息都做成 KPI 卡片', '不要使用颜色作为唯一告警表达', '不要用固定像素绝对定位实现响应式布局'],
     },
     {
@@ -219,17 +267,29 @@ 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',
         keywords: ['空状态', '无数据', '无结果', '首次使用', 'empty', 'no results', 'no data', 'zero state'],
         components: [
-            { component: 'DataView', role: '列表或网格空态承载' },
+            { component: 'PageContent', role: '承载空态的内容区', required: false },
+            { component: 'PageToolbar', role: '保留列表上下文标题与主操作', required: false },
+            { component: 'Empty', role: '空态主体：图标、标题、说明与操作', required: true },
+            { component: 'Icon', role: '空态视觉锚点（也可由 Empty icon 提供）', required: false },
             { component: 'Button', role: '创建、重置筛选或返回', required: false },
+            { component: 'Table', role: '表格 #empty 插槽承载', required: false },
+            { component: 'DataView', role: '列表或网格空态承载', required: false },
             { component: 'Card', role: '在列表或详情容器中承载空态', required: false },
         ],
-        structure: ['Container or Card', '└── DataView / Table #empty', '    ├── Explanation', '    └── Primary recovery action (optional)'],
+        structure: [
+            'MPageContent (or MTable #empty)',
+            '└── MEmpty',
+            '    ├── icon / image',
+            '    ├── title + description',
+            '    └── #extra primary + optional secondary MButton',
+        ],
         layout: { page: '空态在当前内容区域内居中，不一定占满整个视口', content: '说明原因、下一步动作和可选的辅助信息', responsive: '保持按钮可触达，窄屏垂直排列' },
-        styleRules: ['空态文案使用中性、可行动的语气', '主恢复动作使用 primary MButton，次动作使用 text', '不要用错误色表达正常的无数据状态'],
+        styleRules: ['空态文案使用中性、可行动的语气', '主恢复动作使用 primary MButton，次动作使用 text', '不要用错误色表达正常的无数据状态', '颜色与间距使用 --m-* Token'],
         interactionRules: ['搜索无结果提供清除筛选或修改条件入口', '首次使用提供创建或导入入口', '保留页面标题和上下文导航'],
-        avoid: ['不要只显示“暂无数据”而没有下一步', '不要把无数据和接口错误混为一谈'],
+        avoid: ['不要只显示“暂无数据”而没有下一步', '不要把无数据和接口错误混为一谈', '不要堆 emoji 或促销贴纸'],
     },
     {
         id: 'auth-page',
@@ -237,22 +297,79 @@ 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',
         keywords: ['登录', '注册', '认证', '密码', '验证码', 'login', 'register', 'authentication', 'password', 'otp'],
         components: [
-            { component: 'Card', role: '认证表面' },
+            { component: 'ConfigProvider', role: '应用根包裹' },
             { component: 'Form', role: '认证字段校验' },
-            { component: 'FormItem', role: '字段标签和错误信息', required: false, reason: '由 MForm 同目录导出，作为表单子结构使用' },
-            { component: 'Input', role: '账号或密码字段' },
+            { component: 'FormItem', role: '字段标签和错误信息', required: false },
+            { component: 'Input', role: '账号字段' },
+            { component: 'InputPassword', role: '密码字段' },
             { component: 'InputOtp', role: '验证码字段', required: false },
             { component: 'Button', role: '提交认证' },
-            { component: 'Message', role: '页面级反馈', required: false },
+            { component: 'Space', role: '主次操作排列', required: false },
         ],
-        structure: ['AuthLayout', '└── Card', '    └── Form', '        ├── Identity fields', '        ├── Recovery / alternative links', '        └── Submit action'],
-        layout: { page: '认证表单使用窄 max-width 并保持视觉聚焦', form: '字段垂直排列，提交按钮 fluid', 'feedback': '错误信息靠近字段，认证失败提供页面级总结' },
-        styleRules: ['密码字段使用 InputPassword 或 documented password API', '提交按钮使用 primary + fluid', '不要用高对比装饰削弱错误信息和焦点状态', '品牌视觉可定制，但控件状态仍使用 --m-* Token'],
-        interactionRules: ['提交中显示 loading 并防止重复提交', '错误不清空用户已填写的非敏感字段', '密码输入和验证码输入提供可访问名称', '支持键盘提交和清晰焦点顺序'],
+        structure: [
+            'MConfigProvider',
+            '└── Split or centered shell',
+            '    ├── Brand panel (optional Express craft)',
+            '    └── Form panel',
+            '        ├── Persistent form-level alert (token-styled) when needed',
+            '        ├── MForm + MInput / MInputPassword',
+            '        └── Submit + recovery links',
+        ],
+        layout: { page: '认证表单使用窄 max-width 并保持视觉聚焦', form: '字段垂直排列', feedback: '字段错误用 errorMessage；表单级常驻错误用 token 告警条，勿默认 Toast' },
+        styleRules: ['密码字段使用 MInputPassword', '提交按钮使用 primary', '品牌视觉可定制，但颜色仍映射 --m-*', '不要用高对比装饰削弱错误信息和焦点状态'],
+        interactionRules: ['提交中显示 loading 并防止重复提交', '错误不清空用户已填写的非敏感字段', '支持键盘提交和清晰焦点顺序'],
         avoid: ['不要用 placeholder 代替字段 label', '不要把所有认证错误只放在 Toast 中', '不要在错误时回显密码'],
     },
+    {
+        id: 'marketing-landing',
+        title: '营销落地页',
+        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',
+        keywords: [
+            '落地页',
+            '营销',
+            '官网',
+            '首页',
+            'landing',
+            'marketing',
+            'pricing',
+            'hero',
+            '产品介绍',
+        ],
+        components: [
+            { component: 'ConfigProvider', role: '应用根包裹' },
+            { component: 'Button', role: 'CTA' },
+            { component: 'Tag', role: '能力标签', required: false },
+            { component: 'Accordion', role: 'FAQ', required: false },
+            { component: 'Card', role: '套餐或能力卡', required: false },
+        ],
+        structure: [
+            'MConfigProvider',
+            '├── Nav (brand + links + CTA)',
+            '├── Hero (brand, one headline, one lead, CTA group, one visual)',
+            '├── Sections (one job each)',
+            '└── Footer',
+        ],
+        layout: {
+            page: '首屏单一构图；勿做成后台仪表盘',
+            hero: '品牌 + 标题 + 一句支持文案 + CTA + 一个主视觉',
+            sections: '每节一个目的与一个短说明',
+            responsive: '导航链接可折叠；能力卡降为单列',
+        },
+        styleRules: [
+            '交互控件使用 MButton / MTag / MAccordion 等',
+            '颜色与间距使用 --m-*，可用 color-mix 做氛围',
+            '避开紫渐变、奶油衬线陶土、报纸风等 AI 默认脸（除非 brief 指定）',
+            '首屏不要堆统计条、促销胶囊、日程碎片',
+        ],
+        interactionRules: ['CTA 指向明确下一步', 'FAQ 用 Accordion 降低长页噪声', '尊重 prefers-reduced-motion 若加动画'],
+        avoid: ['不要用第二套 UI 库', '不要把 Ops 的 MPageFilters 壳套在营销页上', '不要用 inset 小卡片代替首屏主视觉'],
+    },
     {
         id: 'wizard-form',
         title: '分步表单 / 向导',
@@ -285,16 +402,18 @@ export const pagePatterns = [
         components: [
             { component: 'Breadcrumb', role: '页面层级导航' },
             { component: 'Card', role: '内容分组表面' },
-            { component: 'Tag', role: '状态展示' },
+            { component: 'Status', role: '标题旁轻量状态（圆点+文案）', required: false },
+            { component: 'Tag', role: '分类/强调态标签', required: false },
             { component: 'Divider', role: '内容分组分隔', required: false },
             { component: 'Button', role: '编辑、返回和危险操作' },
             { component: 'Dialog', role: '危险操作确认', required: false },
+            { component: 'Result', role: '资源不存在或无权访问时的结果页', required: false },
         ],
         structure: [
             'Page',
             '├── Breadcrumb',
             '├── PageHeader',
-            '│   ├── Title + Status Tag',
+            '│   ├── Title + MStatus (or MTag)',
             '│   └── Actions',
             '├── Summary Card',
             '├── Properties Card',
@@ -307,14 +426,14 @@ export const pagePatterns = [
             actions: '编辑为主操作，返回为次操作，删除放在低强调区域',
         },
         styleRules: [
-            '状态使用 MTag 的语义色',
+            '轻量状态优先 MStatus；需要芯片感或可关闭时用 MTag',
             '内容分组使用 MCard，必要时用 MDivider 分隔',
             '编辑使用 primary 或 outlined MButton，删除使用 danger',
             '不使用大面积自定义背景色覆盖组件库 surface Token',
         ],
         interactionRules: [
             '详情加载中使用 Skeleton 或 ProgressSpinner',
-            '资源不存在时提供明确的 Table #empty 或 DataView 空态和返回入口',
+            '资源不存在用 MResult status="404"；列表空数据用 MEmpty，不要混用',
             '危险操作必须确认并在成功后刷新或离开当前详情页',
         ],
         avoid: [
@@ -323,6 +442,61 @@ export const pagePatterns = [
             '不要让详情页的操作按钮分散在多个无关区域',
         ],
     },
+    {
+        id: 'result-page',
+        title: '结果页 / 阻断页',
+        titleEn: 'Result / terminal page',
+        description: '用于提交成功、失败回执、403、404、500 等流程终点或阻断场景。',
+        descriptionEn: 'Terminal outcomes: success, failure, 403, 404, 500, and other blocking pages.',
+        keywords: [
+            '结果',
+            '成功',
+            '失败',
+            '403',
+            '404',
+            '500',
+            '无权',
+            '不存在',
+            'result',
+            'success',
+            'error',
+            'forbidden',
+            'not found',
+        ],
+        components: [
+            { component: 'Result', role: '结果主体：图标、标题、说明与操作', required: true },
+            { component: 'Button', role: '下一步：返回、重试、查看详情', required: false },
+            { component: 'PageContent', role: '承载结果区', required: false },
+        ],
+        structure: [
+            'MPageContent (optional shell)',
+            '└── MResult',
+            '    ├── status icon',
+            '    ├── title + description',
+            '    └── #extra primary + optional secondary MButton',
+        ],
+        layout: {
+            page: '结果在内容区居中，不一定占满整屏',
+            content: '说明发生了什么，以及用户下一步能做什么',
+            responsive: '操作按钮可触达，窄屏垂直排列',
+        },
+        styleRules: [
+            '使用 MResult 的 status 语义，不要手写大图标+文案拼盘',
+            '成功/失败用对应 severity 色；403/404 保持中性',
+            '主恢复动作使用 primary MButton，次动作使用 secondary 或 text',
+            '颜色与间距使用 --m-* Token',
+        ],
+        interactionRules: [
+            '成功后提供查看详情或返回列表',
+            '失败提供重试或联系支持入口',
+            '不要把无数据空态做成 Result；空态用 MEmpty',
+        ],
+        avoid: [
+            '不要用 Empty 表达 403/404/提交失败',
+            '不要只用颜色表达结果而无标题文案',
+            '不要在结果页堆砌无关营销内容',
+        ],
+    },
 ];
 /** Advisory page-writing standards for MCP and human authors — not enforced blockers. */
 export const pageStandards = [
@@ -340,8 +514,16 @@ export const pageStandards = [
             'Place MPageContent inside MLayoutContent for consistent padding and section gap',
             'Call get_golden_page before writing a full page and copy the matching structure',
         ],
-        discouraged: ['手写 min-height:100vh', '在 MLayoutContent 上写 padding/gap'],
-        discouragedEn: ['Hand-written min-height:100vh', 'Padding/gap on MLayoutContent instead of MPageContent'],
+        discouraged: [
+            '手写 min-height:100vh 代替 Layout',
+            '在 MLayoutContent 上写 padding/gap',
+            '嵌套多层 MPageContent',
+        ],
+        discouragedEn: [
+            'Hand-written min-height:100vh instead of Layout',
+            'Padding/gap on MLayoutContent instead of MPageContent',
+            'Nesting multiple MPageContent shells',
+        ],
         mcp: { snippet: 'layout-app-shell' },
     },
     {
@@ -351,17 +533,24 @@ export const pageStandards = [
         recommend: [
             '筛选区用 MPageFilters，标题+操作用 MPageToolbar，表单区用 MPageSection',
             '列表页 MTable 直接放在 MPageContent 内',
+            '同行控件用 MSpace / MFlex；区块之间依赖 MPageContent 的 gap',
             '局部区块优先 get_page_snippet（filters / toolbar / form-actions 等）',
         ],
         recommendEn: [
             'Use MPageFilters, MPageToolbar, and MPageSection for filters, headers/actions, and forms',
             'Place MTable directly in MPageContent on list pages',
+            'Use MSpace / MFlex for same-row controls; let MPageContent gap separate sections',
             'Prefer get_page_snippet for local blocks such as filters, toolbar, or form-actions',
         ],
-        discouraged: ['手写 .page-filters / .page-toolbar 类', '用 MCard 包裹 MPageFilters 或 bordered MTable'],
+        discouraged: [
+            '手写 .page-filters / .page-toolbar 类',
+            '用 MCard 或带 padding 的容器再包 MPageFilters / MPageSection / MPageToolbar',
+            '在已有 MPage* 区块之间再写 margin 叠间距',
+        ],
         discouragedEn: [
             'Hand-written .page-filters / .page-toolbar classes',
-            'Wrapping MPageFilters or bordered MTable with MCard',
+            'Wrapping MPageFilters / MPageSection / MPageToolbar with MCard or extra padded containers',
+            'Adding margin between MPage* siblings that PageContent gap already spaces',
         ],
         mcp: { decision: 'surface-nesting-choice' },
     },
@@ -493,7 +682,7 @@ export const designRules = {
                 'Double borders on filter + table wrapper',
             ],
         },
-        goldenPages: ['list-page', 'form-page', 'dashboard-page'],
+        goldenPages: ['list-page', 'form-page', 'dashboard-page', 'login-page', 'landing-page', 'empty-state'],
     },
     actions: {
         primary: { component: 'MButton', props: ['severity omitted or primary'] },
@@ -502,8 +691,10 @@ export const designRules = {
         cancel: { component: 'MButton', props: ['severity="secondary"', 'text'] },
     },
     status: {
-        component: 'MTag',
+        preferred: 'MStatus',
+        chip: 'MTag',
         mapping: { active: 'success', pending: 'warn', disabled: 'secondary', error: 'danger' },
+        note: '行内轻量状态用 MStatus；芯片/可关闭标签用 MTag',
     },
     feedback: {
         default: 'message',
@@ -517,15 +708,30 @@ export const designRules = {
             when: ['同时需要标题与补充说明', '后台任务/批量结果含统计', '异步通知感、角落堆叠'],
             avoid: ['仅有单行文案时不要使用 Toast'],
         },
+        empty: {
+            component: 'MEmpty',
+            when: ['列表无数据', '筛选无结果', '首次使用'],
+            avoid: ['不要用错误色表达正常空态', '不要用 MResult 表达无数据'],
+        },
+        result: {
+            component: 'MResult',
+            when: ['提交成功/失败页', '403 / 404 / 500', '流程终点回执'],
+            avoid: ['不要用手写图标+文案替代 MResult', '不要用 MEmpty 表达阻断错误'],
+        },
         inlineMessage: {
-            component: 'MMessage',
-            when: ['登录/表单区常驻错误', '页面级错误需与表单同区展示'],
+            api: 'field errorMessage | token-styled role=alert',
+            when: [
+                '登录/表单区常驻错误：优先字段 errorMessage',
+                '表单级总结：使用 --m-* 样式的 role=alert 条（见 login-page 黄金样例）',
+                'MMessage 组件当前主要为 message 服务宿主，勿臆造 severity 子节点 API',
+            ],
         },
         doc: 'docs/feedback-message-vs-toast.md',
     },
     global: [
         '优先使用组件库组件和 --m-* Token',
         '操作反馈默认 message；仅一行文案时优先于 toast',
+        '空态用 MEmpty；结果/阻断页用 MResult；行内状态优先 MStatus',
         '图标按钮建议提供 aria-label；表单字段建议有可见 label',
         '浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo',
         '优先使用组件 documented variant，少写深层 CSS 覆盖',

package/dist/resources.d.ts

@@ -1,4 +1,4 @@
-import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Catalog } from './catalog.js';
 export declare function registerCatalogResources(server: McpServer, catalog: Catalog): void;
 export declare function countCatalogResources(catalog: Catalog): number;

package/dist/tools.js

@@ -3,7 +3,7 @@ import { componentDecisions, findDecision, scoreDecision } from './decisions.js'
 import { listGoldenPages, readGoldenPageSource } from './golden-pages.js';
 import { filterPageSnippets, findPageSnippet, pageSnippets, scorePageSnippet } from './page-snippets.js';
 import { designRules, findPattern, pagePatterns, scorePattern } from './patterns.js';
-import { countCatalogResourceTemplates, countCatalogResources } from './resources.js';
+import { countCatalogResources, countCatalogResourceTemplates } from './resources.js';
 function inspectButtonIconOnlyUsage(code, issues) {
     const pairedTagRe = /<MButton\b([^>]*)>([\s\S]*?)<\/MButton>/gi;
     let match = pairedTagRe.exec(code);
@@ -65,16 +65,17 @@ function generatedPageCode(patternId, intent, locale) {
     const pageImports = useLayoutShell
         ? ', MPageContent, MPageFilters, MPageHeader, MPageSection, MPageToolbar'
         : '';
-    const listImports = isList ? ', MSelect, MSpace, MTable' : '';
+    const listImports = isList ? ', MEmpty, MSelect, MSpace, MTable' : '';
     const formImports = isForm || isAuth || isWizard ? ', MForm, MFormItem, MSelect' : '';
     const dashboardImports = isDashboard ? ', MCard, MGrid, MGridItem, MPagePlaceholder, MPageStat, MSkeleton, MTable' : '';
     const detailImports = isDetail ? ', MDivider' : '';
-    const emptyImports = isEmpty ? ', MDataView' : '';
+    const emptyImports = isEmpty ? ', MEmpty, MPageToolbar' : '';
     const wizardImports = isWizard ? ', MStepper' : '';
     const settingsImports = isSettings ? ', MTabs' : '';
+    const statusImports = isList || isDetail || isDashboard ? ', MStatus' : '';
     const script = `<script setup lang="ts">
 import { ref } from 'vue'
-import { MButton, MCard, MConfigProvider, MInput, MTag, zhCN${layoutImports}${pageImports}${listImports}${formImports}${dashboardImports}${detailImports}${emptyImports}${wizardImports}${settingsImports} } from 'morya-ui'
+import { MButton, MCard, MConfigProvider, MInput, MTag, zhCN${layoutImports}${pageImports}${listImports}${formImports}${dashboardImports}${detailImports}${emptyImports}${wizardImports}${settingsImports}${statusImports} } from 'morya-ui'
 
 const loading = ref(false)
 const error = ref('')
@@ -112,8 +113,18 @@ async function submit() {
               </template>
             </MPageToolbar>
             <MTable :columns="columns" :rows="rows" :loading="loading" paginator :rows-per-page="10" striped bordered row-key="id">
+              <template #cell-status="{ value }">
+                <MStatus :label="String(value ?? '')" :severity="value === 'active' ? 'success' : 'secondary'" />
+              </template>
               <template #empty>
-                <p style="margin:0;padding:var(--m-space-8);text-align:center;color:var(--m-color-text-muted)">${zh ? '暂无数据' : 'No data yet'}</p>
+                <MEmpty
+                  :title="${zh ? '暂无数据' : 'No data yet'}"
+                  :description="${zh ? '创建第一条记录开始使用。' : 'Create your first record to get started.'}"
+                >
+                  <template #extra>
+                    <MButton severity="primary">${zh ? '新建' : 'Create'}</MButton>
+                  </template>
+                </MEmpty>
               </template>
             </MTable>`;
     const formContent = `            <MPageHeader :title="title" :description="${zh ? '填写表单并保存。' : 'Fill in the form and save.'}" />
@@ -210,17 +221,20 @@ ${content}
     else if (isEmpty) {
         innerTemplate = `<MConfigProvider :locale="zhCN">
   <main class="m-generated-page">
-    <MCard>
-      <MDataView :value="[]">
-        <template #empty>
-          <div class="m-generated-empty">
-            <strong>${zh ? '暂无内容' : 'Nothing here yet'}</strong>
-            <p class="m-generated-muted">${zh ? '创建第一条记录开始使用。' : 'Create your first record to get started.'}</p>
-            <MButton severity="primary" @click="submit">${zh ? '创建' : 'Create'}</MButton>
-          </div>
-        </template>
-      </MDataView>
-    </MCard>
+    <MPageToolbar :title="title">
+      <template #actions>
+        <MButton severity="primary" @click="submit">${zh ? '新建' : 'Create'}</MButton>
+      </template>
+    </MPageToolbar>
+    <MEmpty
+      :title="${zh ? '暂无内容' : 'Nothing here yet'}"
+      :description="${zh ? '创建第一条记录开始使用。' : 'Create your first record to get started.'}"
+      icon="database"
+    >
+      <template #extra>
+        <MButton severity="primary" @click="submit">${zh ? '创建' : 'Create'}</MButton>
+      </template>
+    </MEmpty>
   </main>
 </MConfigProvider>`;
     }
@@ -857,6 +871,34 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     : '标准建议：MPageFilters 已自带表面样式，通常不必再用 MCard 包裹。',
             });
         }
+        if (/<MPageSection\b[^>]*variant=["']form["']/i.test(code) &&
+            /<MCard\b[^>]*>[\s\S]*?<MPageSection\b/i.test(code)) {
+            suggestions.push({
+                standardId: 'page-sections',
+                type: 'redundant-wrapper',
+                message: locale === 'en-US'
+                    ? 'Standard: MPageSection variant="form" already provides a surface; wrapping it in MCard is usually redundant.'
+                    : '标准建议：MPageSection variant="form" 已自带表面样式，通常不必再用 MCard 包裹。',
+            });
+        }
+        if (/<MPageContent\b[^>]*>[\s\S]*?<MPageContent\b/i.test(code)) {
+            suggestions.push({
+                standardId: 'layout-shell',
+                type: 'redundant-wrapper',
+                message: locale === 'en-US'
+                    ? 'Standard: prefer a single MPageContent shell for page padding and section gap.'
+                    : '标准建议：页面 padding 与区块间距优先只用一层 MPageContent。',
+            });
+        }
+        if (/<(?:div|section|main)\b[^>]*style=["'][^"']*(?:padding|gap)\s*:[^"']*["'][^>]*>\s*<(?:MPage(?:Content|Filters|Toolbar|Header|Section)|MTable)\b/i.test(code)) {
+            suggestions.push({
+                standardId: 'page-sections',
+                type: 'redundant-wrapper',
+                message: locale === 'en-US'
+                    ? 'Standard: avoid extra padded wrappers around MPage* blocks; prefer the components’ built-in spacing.'
+                    : '标准建议：少在 MPage* 外包带 padding 的容器；优先使用组件自带间距。',
+            });
+        }
         if (/style="[^"]*overflow(?:-y|-x)?\s*:\s*(auto|scroll)/i.test(code) ||
             /<style\b[^>]*>[\s\S]*?overflow(?:-y|-x)?\s*:\s*(auto|scroll)/i.test(code)) {
             suggestions.push({
@@ -885,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,
@@ -943,7 +1008,7 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 default: 'message',
                 message: { when: ['single-line action result', 'save/delete/create confirmations'] },
                 toast: { when: ['summary + detail', 'async or background notifications'] },
-                inlineMessage: { component: 'MMessage', when: ['persistent form/auth errors'] },
+                inlineMessage: { api: 'field errorMessage | token-styled role=alert', when: ['persistent form/auth errors'] },
                 doc: 'docs/feedback-message-vs-toast.md',
             },
             global: [

package/package.json

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