@morya-ui/mcp 0.2.6 → 0.2.8

package/data/example-coverage.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-16T08:52:49.016Z",
-  "catalogGeneratedAt": "2026-09-16T08:52:44.900Z",
+  "generatedAt": "2026-09-21T01:37:39.078Z",
+  "catalogGeneratedAt": "2026-09-21T01:37:31.355Z",
   "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": {
@@ -1602,6 +1604,41 @@
         "missing": []
       }
     },
+    {
+      "id": "Loading",
+      "exportName": "MLoading",
+      "examples": 14,
+      "props": {
+        "total": 11,
+        "covered": 4,
+        "missing": [
+          "ariaLabel",
+          "background",
+          "customClass",
+          "fullscreen",
+          "lock",
+          "delay",
+          "pt"
+        ]
+      },
+      "events": {
+        "total": 0,
+        "covered": 0,
+        "missing": []
+      },
+      "slots": {
+        "total": 2,
+        "covered": 1,
+        "missing": [
+          "indicator"
+        ]
+      },
+      "methods": {
+        "total": 0,
+        "covered": 0,
+        "missing": []
+      }
+    },
     {
       "id": "MegaMenu",
       "exportName": "MMegaMenu",
@@ -2085,12 +2122,11 @@
     {
       "id": "Result",
       "exportName": "MResult",
-      "examples": 8,
+      "examples": 10,
       "props": {
-        "total": 5,
-        "covered": 2,
+        "total": 6,
+        "covered": 4,
         "missing": [
-          "title",
           "icon",
           "pt"
         ]
@@ -2501,10 +2537,10 @@
     {
       "id": "Status",
       "exportName": "MStatus",
-      "examples": 8,
+      "examples": 10,
       "props": {
-        "total": 5,
-        "covered": 4,
+        "total": 8,
+        "covered": 7,
         "missing": [
           "color"
         ]
@@ -2515,9 +2551,11 @@
         "missing": []
       },
       "slots": {
-        "total": 1,
+        "total": 2,
         "covered": 1,
-        "missing": []
+        "missing": [
+          "icon"
+        ]
       },
       "methods": {
         "total": 0,
@@ -3191,8 +3229,8 @@
     }
   ],
   "summary": {
-    "components": 92,
-    "componentsWithMissingCoverage": 87,
-    "totalExamples": 781
+    "components": 93,
+    "componentsWithMissingCoverage": 88,
+    "totalExamples": 803
   }
 }

package/dist/decisions.js

@@ -383,6 +383,75 @@ 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'],
+            },
+        ],
+    },
 ];
 export function findDecision(name) {
     const key = name.trim().toLowerCase().replace(/[-_\s]/g, '');

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/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，不要混用',
             '危险操作必须确认并在成功后刷新或离开当前详情页',
         ],

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)) {

package/package.json

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