@morya-ui/mcp 0.3.1 → 0.3.3

package/data/example-coverage.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-23T09:00:43.642Z",
-  "catalogGeneratedAt": "2026-09-23T09:00:38.573Z",
+  "generatedAt": "2026-09-24T08:45:50.660Z",
+  "catalogGeneratedAt": "2026-09-24T08:45:45.036Z",
   "components": [
     {
       "id": "Accordion",
@@ -198,12 +198,14 @@
       "exportName": "MButton",
       "examples": 20,
       "props": {
-        "total": 24,
-        "covered": 21,
+        "total": 27,
+        "covered": 22,
         "missing": [
           "variant",
-          "autofocus",
-          "nativeType"
+          "ripple",
+          "press",
+          "nativeType",
+          "autofocus"
         ]
       },
       "events": {
@@ -231,7 +233,7 @@
     {
       "id": "Card",
       "exportName": "MCard",
-      "examples": 8,
+      "examples": 10,
       "props": {
         "total": 8,
         "covered": 4,
@@ -1920,13 +1922,15 @@
     {
       "id": "Page",
       "exportName": "MPageContent",
-      "examples": 6,
+      "examples": 10,
       "props": {
-        "total": 13,
-        "covered": 10,
+        "total": 24,
+        "covered": 19,
         "missing": [
+          "bands",
+          "expandLabel",
+          "collapseLabel",
           "headingLevel",
-          "trendSeverity",
           "minHeight"
         ]
       },
@@ -1936,9 +1940,15 @@
         "missing": []
       },
       "slots": {
-        "total": 2,
-        "covered": 2,
-        "missing": []
+        "total": 8,
+        "covered": 3,
+        "missing": [
+          "active",
+          "breadcrumb",
+          "tags",
+          "icon",
+          "extra"
+        ]
       },
       "methods": {
         "total": 0,
@@ -3377,6 +3387,6 @@
   "summary": {
     "components": 93,
     "componentsWithMissingCoverage": 93,
-    "totalExamples": 811
+    "totalExamples": 817
   }
 }

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

@@ -13,8 +13,8 @@ import {
   MLayoutContent,
   MLayoutHeader,
   MPageContent,
+  MEmpty,
   MPageHeader,
-  MPagePlaceholder,
   MPageStat,
   MStatus,
   MTable,
@@ -23,9 +23,9 @@ import {
 } from 'morya-ui'
 
 const stats = [
-  { label: '总用户', value: '12,480', trend: '+8.2%', icon: 'users' },
-  { label: '今日活跃', value: '1,926', trend: '+3.1%', icon: 'activity' },
-  { label: '待处理工单', value: '47', trend: '-12%', trendSeverity: 'warn' as const, icon: 'clipboard' },
+  { label: '总用户', value: '12,480', trend: '+8.2%', trendDirection: 'up' as const, trendLabel: '较上月', icon: 'users' },
+  { label: '今日活跃', value: '1,926', trend: '+3.1%', trendDirection: 'up' as const, trendLabel: '较昨日', icon: 'activity' },
+  { label: '待处理工单', value: '47', trend: '-12%', trendDirection: 'down' as const, trendLabel: '较上周', trendSeverity: 'warn' as const, icon: 'clipboard' },
   { label: '系统健康', value: '99.9%', trend: '稳定', trendSeverity: 'secondary' as const, icon: 'heart' },
 ]
 
@@ -88,6 +88,8 @@ function statusSeverity(s: string) {
                 :value="item.value"
                 :trend="item.trend"
                 :trend-severity="item.trendSeverity ?? 'primary'"
+                :trend-direction="item.trendDirection"
+                :trend-label="item.trendLabel"
                 :icon="item.icon"
               />
             </MGridItem>
@@ -95,15 +97,15 @@ function statusSeverity(s: string) {
 
           <MGrid :cols="2" :x-gap="16" :y-gap="16" responsive="screen">
             <MGridItem :span="1">
-              <MCard title="趋势概览">
-                <MPagePlaceholder
-                  aria-label="图表占位"
+              <MCard title="趋势概览" shadow="always">
+                <MEmpty
                   description="接入图表组件后展示近 7 日活跃与转化。"
+                  icon="chart-bar"
                 />
               </MCard>
             </MGridItem>
             <MGridItem :span="1">
-              <MCard title="最近工单">
+              <MCard title="最近工单" shadow="always">
                 <MTable
                   :columns="recentColumns"
                   :rows="recentRows"

package/data/golden-pages/empty-state.vue

@@ -13,7 +13,7 @@ import {
   MLayoutContent,
   MLayoutHeader,
   MPageContent,
-  MPageToolbar,
+  MPageHeader,
   zhCN,
 } from 'morya-ui'
 </script>
@@ -27,61 +27,30 @@ import {
 
       <MLayoutContent>
         <MPageContent>
-          <MPageToolbar title="课程">
+          <MPageHeader title="课程" description="管理目录与可见性。">
             <template #actions>
-              <MButton label="新建课程" />
+              <MButton severity="primary">
+                新建课程
+              </MButton>
             </template>
-          </MPageToolbar>
+          </MPageHeader>
 
-          <div class="empty-state-shell">
-            <MEmpty
-              title="还没有课程"
-              description="创建第一门课程后，学员就能在目录里看到它。也可以稍后从模板导入。"
-              icon="book"
-            >
-              <template #extra>
-                <MButton label="创建第一门课程" />
-                <MButton label="从模板导入" severity="secondary" text />
-              </template>
-            </MEmpty>
-          </div>
+          <MEmpty
+            title="还没有课程"
+            description="创建第一门课程后，学员就能在目录里看到它。也可以稍后从模板导入。"
+            icon="book"
+          >
+            <template #extra>
+              <MButton severity="primary">
+                创建第一门课程
+              </MButton>
+              <MButton severity="secondary" text>
+                从模板导入
+              </MButton>
+            </template>
+          </MEmpty>
         </MPageContent>
       </MLayoutContent>
     </MLayout>
   </MConfigProvider>
 </template>
-
-<style scoped>
-.empty-state-shell {
-  display: grid;
-  place-items: center;
-  min-height: 18rem;
-  padding: var(--m-space-8) var(--m-space-6);
-  border: 1px dashed color-mix(in srgb, var(--m-color-border) 80%, var(--m-color-primary));
-  border-radius: var(--m-radius-md);
-  background:
-    radial-gradient(
-      120% 80% at 50% 0%,
-      color-mix(in srgb, var(--m-color-primary) 10%, transparent),
-      transparent 55%
-    ),
-    var(--m-color-surface);
-}
-
-@media (prefers-reduced-motion: no-preference) {
-  .empty-state-shell {
-    animation: empty-in 400ms ease both;
-  }
-}
-
-@keyframes empty-in {
-  from {
-    opacity: 0;
-    transform: translateY(0.35rem);
-  }
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-</style>

package/data/golden-pages/form-in-dialog.vue

@@ -16,7 +16,7 @@ import {
   MLayoutContent,
   MLayoutHeader,
   MPageContent,
-  MPageToolbar,
+  MPageHeader,
   MSelect,
   MSpace,
   MStatus,
@@ -101,13 +101,13 @@ async function onSave() {
 
       <MLayoutContent>
         <MPageContent>
-          <MPageToolbar title="用户管理">
+          <MPageHeader title="用户管理" description="短表单留在列表内弹窗；字段多时再走独立表单页。">
             <template #actions>
               <MButton severity="primary" @click="openCreate">
                 新建用户
               </MButton>
             </template>
-          </MPageToolbar>
+          </MPageHeader>
 
           <MTable
             :columns="columns"

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

@@ -15,18 +15,22 @@ import {
   MLayoutSider,
   MMenu,
   MPageContent,
+  MPageFilterChips,
   MPageFilters,
-  MPageToolbar,
+  MPageHeader,
   MSelect,
   MSpace,
   MStatus,
   MTable,
+  MTag,
   zhCN,
 } from 'morya-ui'
-import { ref } from 'vue'
+import { computed, ref } from 'vue'
 
 const keyword = ref('')
 const status = ref<string | undefined>()
+const department = ref<string | null>(null)
+const filtersExpanded = ref(false)
 const siderCollapsed = ref(false)
 
 const menuModel = [
@@ -41,6 +45,39 @@ const statusOptions = [
   { label: '停用', value: 'inactive' },
 ]
 
+const departmentOptions = [
+  { label: '研发', value: '研发' },
+  { label: '运营', value: '运营' },
+  { label: '市场', value: '市场' },
+]
+
+const activeFilters = computed(() => {
+  const items: Array<{ key: string; label: string }> = []
+  if (keyword.value.trim()) {
+    items.push({ key: 'keyword', label: `关键词：${keyword.value.trim()}` })
+  }
+  if (status.value) {
+    const label = statusOptions.find((o) => o.value === status.value)?.label ?? status.value
+    items.push({ key: 'status', label: `状态：${label}` })
+  }
+  if (department.value) {
+    items.push({ key: 'department', label: `部门：${department.value}` })
+  }
+  return items
+})
+
+function clearFilter(key: string) {
+  if (key === 'keyword') keyword.value = ''
+  if (key === 'status') status.value = undefined
+  if (key === 'department') department.value = null
+}
+
+function resetFilters() {
+  keyword.value = ''
+  status.value = undefined
+  department.value = null
+}
+
 const columns = [
   { key: 'name', label: '名称' },
   { key: 'status', label: '状态', width: 120 },
@@ -76,7 +113,20 @@ const rows = [
 
         <MLayoutContent>
           <MPageContent>
-            <MPageFilters aria-label="筛选">
+            <MPageHeader title="用户管理" description="维护账号、角色与权限。">
+              <template #actions>
+                <MButton severity="primary">
+                  新建用户
+                </MButton>
+              </template>
+            </MPageHeader>
+
+            <MPageFilters
+              v-model:expanded="filtersExpanded"
+              aria-label="筛选"
+              variant="filled"
+              collapsible
+            >
               <MSpace wrap>
                 <MInput v-model="keyword" placeholder="搜索名称" clearable style="width: 14rem" />
                 <MSelect
@@ -86,22 +136,37 @@ const rows = [
                   clearable
                   style="width: 10rem"
                 />
-                <MButton severity="primary">
+                <MButton severity="secondary">
                   查询
                 </MButton>
-                <MButton severity="secondary">
+                <MButton severity="secondary" text @click="resetFilters">
                   重置
                 </MButton>
               </MSpace>
+              <template #advanced>
+                <MSpace wrap>
+                  <MSelect
+                    v-model="department"
+                    :options="departmentOptions"
+                    placeholder="部门"
+                    clearable
+                    style="width: 10rem"
+                  />
+                </MSpace>
+              </template>
             </MPageFilters>
 
-            <MPageToolbar title="用户管理">
-              <template #actions>
-                <MButton severity="primary">
-                  新建用户
-                </MButton>
-              </template>
-            </MPageToolbar>
+            <MPageFilterChips v-if="activeFilters.length" label="已选" aria-label="已选筛选">
+              <MTag
+                v-for="item in activeFilters"
+                :key="item.key"
+                :value="item.label"
+                size="small"
+                bordered
+                closable
+                @close="clearFilter(item.key)"
+              />
+            </MPageFilterChips>
 
             <MTable
               :columns="columns"

package/dist/__tests__/tools.test.js

@@ -149,7 +149,7 @@ describe('@morya-ui/mcp handlers', () => {
     });
     it('searches page snippets scope', () => {
         const result = read(handlers.search({ query: 'toolbar', scope: 'snippets', limit: 5 }));
-        expect(result.items.some((item) => item.type === 'snippet' && item.id === 'list-toolbar')).toBe(true);
+        expect(result.items.some((item) => item.type === 'snippet' && item.id === 'list-batch-toolbar')).toBe(true);
     });
     it('suggests double-border page composition as advisory standard', () => {
         const result = read(handlers.validatePage({
@@ -282,6 +282,23 @@ describe('@morya-ui/mcp handlers', () => {
         expect(result.id).toBe('overlay-choice');
         expect(result.options.some((option) => option.component === 'Drawer')).toBe(true);
     });
+    it('returns L2 recipes and antiPatterns on decision reads', () => {
+        const result = read(handlers.recommendComponent({ decision: 'data-display-choice' }));
+        const table = result.options.find((option) => option.component === 'Table');
+        expect(table?.recipe?.props?.length).toBeGreaterThanOrEqual(3);
+        expect(table?.recipe?.props?.some((line) => /rows/i.test(line))).toBe(true);
+        expect(table?.antiPatterns?.length).toBeGreaterThan(0);
+    });
+    it('covers feedback and confirm decision guides', () => {
+        const feedback = read(handlers.recommendComponent({ decision: 'feedback-choice' }));
+        expect(feedback.options.map((option) => option.component)).toEqual(expect.arrayContaining(['message', 'toast', 'field errorMessage / role="alert"']));
+        expect(feedback.options.every((option) => (option.recipe?.props?.length ?? 0) >= 3)).toBe(true);
+        const confirm = read(handlers.recommendComponent({ decision: 'confirm-choice' }));
+        expect(confirm.options.map((option) => option.component)).toEqual([
+            'ConfirmDialog',
+            'ConfirmPopup',
+        ]);
+    });
     it('covers current selection, status, empty, and menu guides', () => {
         const selection = read(handlers.recommendComponent({ decision: 'selection-choice' }));
         expect(selection.options.map((option) => option.component)).toEqual(expect.arrayContaining(['Select', 'CascadeSelect', 'Listbox', 'SelectButton', 'Radio']));

package/dist/decisions.d.ts

@@ -1,9 +1,21 @@
+export interface ComponentDecisionRecipe {
+    /** 3–8 critical props / usage notes (zh). Not a full API manual. */
+    props: string[];
+    propsEn: string[];
+    slots?: string[];
+    slotsEn?: string[];
+    events?: string[];
+    eventsEn?: string[];
+}
 export interface ComponentDecisionOption {
     component: string;
     when: string[];
     whenEn: string[];
     avoidWhen: string[];
     avoidWhenEn: string[];
+    recipe: ComponentDecisionRecipe;
+    antiPatterns: string[];
+    antiPatternsEn: string[];
 }
 export interface ComponentDecision {
     id: string;
@@ -17,3 +29,5 @@ export interface ComponentDecision {
 export declare const componentDecisions: ComponentDecision[];
 export declare function findDecision(name: string): ComponentDecision | undefined;
 export declare function scoreDecision(decision: ComponentDecision, query: string): number;
+/** Ensures every option carries a non-empty L2 recipe (used by tests / generate script). */
+export declare function assertDecisionRecipes(decisions?: ComponentDecision[]): void;