@morya-ui/mcp 0.5.0 → 0.5.1

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

@@ -116,7 +116,7 @@ const rows = [
 
         <MLayoutContent>
           <MPageContent fill>
-            <MPageHeader title="用户管理" description="维护账号、角色与权限。">
+            <MPageHeader title="{{页面标题}}" description="{{页面说明}}">
               <template #actions>
                 <MButton type="primary">
                   新建用户
@@ -124,13 +124,14 @@ const rows = [
               </template>
             </MPageHeader>
 
+            <!-- 筛选区：四选一（list-filters / collapsible / stack / dense）。variant 跟密度，不默认 filled。 -->
             <MPageFilters
               v-model:expanded="filtersExpanded"
               aria-label="筛选"
-              variant="filled"
               collapsible
             >
               <MSpace wrap>
+                <!-- 控件宽度可局部 inline；其余视觉跟 styleDirection -->
                 <MInput v-model="keyword" placeholder="搜索名称" clearable style="width: 14rem" />
                 <MSelect
                   v-model="status"
@@ -161,6 +162,7 @@ const rows = [
               </template>
             </MPageFilters>
 
+            <!-- 用折叠筛选栈时通常不再叠加独立 chips；以下为演示已选摘要的独立用法 -->
             <MPageFilterChips v-if="activeFilters.length" label="已选" aria-label="已选筛选">
               <MTag
                 v-for="item in activeFilters"
@@ -173,14 +175,13 @@ const rows = [
               />
             </MPageFilterChips>
 
+            <!-- 全视口主列表：fill + paginator 成对；striped/bordered 跟密度，非默认 -->
             <MTable
               :columns="columns"
               :rows="rows"
               :rows-per-page="5"
               fill
               paginator
-              striped
-              bordered
               row-key="id"
               aria-label="用户列表"
             >
@@ -201,14 +202,15 @@ const rows = [
                 </MSpace>
               </template>
               <template #empty>
+                <!-- 空态说明“接下来做什么” + 唯一主操作 -->
                 <MEmpty
-                  title="还没有用户"
-                  description="创建第一个用户后，即可分配角色与权限。"
+                  title="{{空态标题}}"
+                  description="{{空态说明}}"
                   icon="user"
                 >
                   <template #extra>
                     <MButton type="primary">
-                      新建用户
+                      {{空态主操作}}
                     </MButton>
                   </template>
                 </MEmpty>
@@ -219,4 +221,4 @@ const rows = [
       </MLayout>
     </MLayout>
   </MConfigProvider>
-</template>
+</template>

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

@@ -25,9 +25,9 @@ const model = reactive({
   password: '',
 })
 
-/** Brand seed for Account surfaces — prefer themeConfig over page-level hex. */
+/** Brand seed for Account surfaces — prefer themeConfig over page-level hex. 品牌色改主题覆盖，不写页面 hex。 */
 const themeConfig = {
-  seed: { colorPrimary: '#0b6e4f' },
+  seed: { colorPrimary: '#0b6e4f' }, // 演示：实际项目用 --m-color-primary 主题覆盖
 }
 
 async function onSubmit() {
@@ -51,12 +51,13 @@ async function onSubmit() {
     input-variant="filled"
     :theme-config="themeConfig"
   >
+    <!-- 品牌区渐变/氛围跟 styleDirection；结构：品牌区 + 表单面板 -->
     <div class="login-shell">
       <aside class="login-brand" aria-label="品牌">
-        <p class="login-brand__mark">青禾书房</p>
-        <h1 class="login-brand__title">把好书留在手边</h1>
+        <p class="login-brand__mark">{{品牌名}}</p>
+        <h1 class="login-brand__title">{{品牌主张}}</h1>
         <p class="login-brand__lead">
-          店员与会员共用同一套账户。登录后继续进货、上架与会员服务。
+          {{品牌导语}}
         </p>
       </aside>
 
@@ -64,10 +65,10 @@ async function onSubmit() {
         <div class="login-panel">
           <header class="login-panel__header">
             <MTitle :level="3">
-              登录
+              {{登录标题}}
             </MTitle>
             <MParagraph type="secondary">
-              使用工作邮箱进入后台。
+              {{登录说明}}
             </MParagraph>
           </header>
 
@@ -123,31 +124,11 @@ async function onSubmit() {
   gap: var(--m-space-4);
   padding: clamp(2rem, 6vw, 4.5rem);
   overflow: hidden;
-  background:
-    radial-gradient(
-      80% 60% at 10% 20%,
-      color-mix(in srgb, var(--m-color-primary) 22%, transparent),
-      transparent 55%
-    ),
-    linear-gradient(
-      165deg,
-      color-mix(in srgb, var(--m-color-primary) 16%, var(--m-color-surface)) 0%,
-      var(--m-color-surface) 55%,
-      color-mix(in srgb, var(--m-color-border) 35%, var(--m-color-surface)) 100%
-    );
+  /* 品牌氛围（渐变/插画）跟 styleDirection；默认 token-only 平壳 */
+  background: var(--m-color-surface);
   border-right: 1px solid var(--m-color-border);
 }
 
-.login-brand::after {
-  content: '';
-  position: absolute;
-  inset: auto -10% -20% 40%;
-  height: 55%;
-  border-radius: 50%;
-  background: color-mix(in srgb, var(--m-color-primary) 12%, transparent);
-  pointer-events: none;
-}
-
 .login-brand__mark,
 .login-brand__title,
 .login-brand__lead {

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

@@ -34,20 +34,21 @@ import {
 
       <MLayoutContent>
         <MPageContent>
+          <!-- 结果壳：视觉（渐变/虚线边框）跟 styleDirection；此处保留 token-only 极简壳 -->
           <div class="result-shell">
             <MResult
               status="403"
-              title="没有权限查看该项目"
-              description="当前账号无权访问「青禾书房」工作区。可返回上一页，或联系管理员开通权限。"
+              title="{{结果标题}}"
+              description="{{结果说明}}"
               size="large"
             >
               <template #footer>
                 <MSpace>
                   <MButton type="primary">
-                    返回上一页
+                    {{主操作}}
                   </MButton>
                   <MButton type="text">
-                    联系管理员
+                    {{次操作}}
                   </MButton>
                 </MSpace>
               </template>
@@ -66,19 +67,7 @@ import {
   min-height: min(28rem, 70vh);
   padding: var(--m-space-8) var(--m-space-4);
   border-radius: var(--m-radius-lg);
-  background:
-    radial-gradient(
-      70% 55% at 50% 0%,
-      color-mix(in srgb, var(--m-color-primary) 10%, transparent),
-      transparent 60%
-    ),
-    var(--m-color-surface);
-  border: 1px dashed color-mix(in srgb, var(--m-color-border) 80%, transparent);
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .result-shell {
-    background: var(--m-color-surface);
-  }
+  background: var(--m-color-surface);
+  border: 1px solid var(--m-color-border);
 }
 </style>

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

@@ -8,6 +8,7 @@ import {
   MBreadcrumb,
   MButton,
   MConfigProvider,
+  message,
   MForm,
   MFormItem,
   MInput,
@@ -21,7 +22,6 @@ import {
   MSpace,
   MSwitch,
   MTabs,
-  message,
   zhCN,
 } from 'morya-ui'
 import { reactive, ref } from 'vue'
@@ -82,8 +82,8 @@ async function saveNotify() {
       <MLayoutContent>
         <MPageContent width="narrow">
           <MPageHeader
-            title="系统设置"
-            description="按域分组配置；切换 Tab 时保留未保存输入，保存成功用 message 一句话回执。"
+            title="{{设置页标题}}"
+            description="{{设置页说明}}"
           />
 
           <MTabs v-model="activeTab" :tabs="tabs">

package/data/golden-pages/wizard-form.vue

@@ -89,8 +89,8 @@ async function finish() {
       <MLayoutContent>
         <MPageContent width="narrow">
           <MPageHeader
-            title="创建工作空间"
-            description="三步完成；每步只做一件事。Stepper 使用 steps（不是 items）。"
+            title="{{向导标题}}"
+            description="{{向导说明}}"
           />
 
           <MStepper v-model="activeStep" :steps="steps" linear />

package/dist/__tests__/tools.test.js

@@ -251,7 +251,9 @@ describe('@morya-ui/mcp handlers', () => {
         const rail = read(handlers.getGoldenPage({ page: 'list-page-rail' }));
         expect(rail.id).toBe('list-page-rail');
         expect(rail.style).toBe('rail');
-        expect(rail.source).toContain('color-mix');
+        // rail 变体差异集中在侧栏品牌 chrome；token-only，不再默认渐变
+        expect(rail.source).toContain('gp-rail-sider');
+        expect(rail.source).toContain('--m-color-primary');
     });
     it('exposes style direction rules without a preset catalog', () => {
         const result = read(handlers.getStyleDirection({ mode: 'zh-CN' }));
@@ -343,6 +345,27 @@ describe('@morya-ui/mcp handlers', () => {
         expect(result.ok).toBe(true);
         expect(result.suggestions.some((item) => item.type === 'status-cell-tag')).toBe(true);
     });
+    it('suggests a single filter region when multiple MPageFilters appear', () => {
+        const result = read(handlers.validatePage({
+            code: '<MPageFilters /><MPageFilters collapsible />',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.craft.some((item) => item.type === 'multiple-filter-regions' && item.severity === 'craft')).toBe(true);
+    });
+    it('suggests dropping standalone chips when the collapsible stack already renders them', () => {
+        const result = read(handlers.validatePage({
+            code: '<MPageFilters collapsible><MInput /></MPageFilters><MPageFilterChips />',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.craft.some((item) => item.type === 'redundant-filter-chips')).toBe(true);
+    });
+    it('suggests consistent density when compact and spacious are mixed', () => {
+        const result = read(handlers.validatePage({
+            code: '<MTable density="compact" /><MCard density="spacious" />',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.craft.some((item) => item.type === 'mixed-density')).toBe(true);
+    });
     it('returns detail-page and form-in-dialog golden samples', () => {
         const detail = read(handlers.getGoldenPage({ page: 'detail-page' }));
         expect(detail.id).toBe('detail-page');

package/dist/index.js

@@ -86,7 +86,7 @@ register('get_pattern', 'Read the structure, component composition, layout, and
     pattern: z.string().min(1),
     mode: z.string().optional(),
 }, async (args) => handlers.getPattern(args));
-register('recommend_page', 'Recommend a page pattern and component composition from product intent. Pass style as free-text look; density=compact|default|spacious; brief for reference fidelity mapping; includeScaffold for optional golden structure.', {
+register('recommend_page', 'Recommend a page pattern and component composition from product intent. Default path composes suggestedSnippets + get_page_snippet (golden pages are optional block-order checks, not a default look). Pass style as free-text look; density=compact|default|spacious; brief for reference fidelity mapping; includeScaffold only when you explicitly need the golden structure source.', {
     intent: z.string().min(1),
     pageType: z.string().optional(),
     features: z.array(z.string()).max(20).optional(),

package/dist/page-snippets.d.ts

@@ -14,6 +14,10 @@ export interface PageSnippet {
     rulesEn: string[];
     avoid: string[];
     avoidEn: string[];
+    /** Mutually exclusive sibling snippets (pick one for the same block). */
+    excludes?: string[];
+    /** Snippets commonly composed together (weak pointer for polish/validate). */
+    pairsWith?: string[];
 }
 export declare const pageSnippets: PageSnippet[];
 export declare function findPageSnippet(id: string): PageSnippet | undefined;

package/dist/page-snippets.js

@@ -1,6 +1,7 @@
 export const pageSnippets = [
     {
         id: 'list-filters',
+        excludes: ['list-filters-collapsible', 'list-filters-stack', 'list-filters-dense'],
         title: '列表页基础筛选栏',
         titleEn: 'Basic list filter bar',
         description: '关键词 + 1–2 个枚举 + 查询/重置。条件少、无需已选摘要时用本片段；有次要条件用 list-filters-collapsible；默认列表推荐 list-filters-stack。',
@@ -61,6 +62,7 @@ function resetFilters() {
     },
     {
         id: 'list-filters-collapsible',
+        excludes: ['list-filters', 'list-filters-stack', 'list-filters-dense'],
         title: '列表页折叠高级筛选',
         titleEn: 'Collapsible advanced list filters',
         description: '常用条件在 default，次要条件在 #advanced；对齐 list-page 黄金结构。通常再接 list-filter-chips，或直接用 list-filters-stack。',
@@ -215,6 +217,8 @@ function clearFilter(key: string) {
     },
     {
         id: 'list-filters-stack',
+        excludes: ['list-filters', 'list-filters-collapsible', 'list-filters-dense'],
+        pairsWith: ['list-filter-chips'],
         title: '列表筛选完整栈（折叠 + 已选）',
         titleEn: 'Full list filter stack (collapsible + chips)',
         description: '默认推荐的列表筛选组合：MPageFilters collapsible + #advanced + MPageFilterChips。对齐 list-page / list-page-rail 黄金结构；dense 无高级条件时可改用 list-filters（plain/small）。',
@@ -352,6 +356,7 @@ function resetFilters() {
     },
     {
         id: 'list-filters-dense',
+        excludes: ['list-filters', 'list-filters-collapsible', 'list-filters-stack'],
         title: '列表页紧凑筛选栏',
         titleEn: 'Dense list filter bar',
         description: 'list-page-dense craft：variant="plain" + size="small"，字段少、无折叠/Chips。监控/告警等高密度列表用。',

package/dist/tools.js

@@ -1125,6 +1125,22 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 m = iconOnlyRe.exec(code);
             }
         }
+        // Craft: composition relations — multiple filter regions on one page
+        {
+            const filterCount = (code.match(/<MPageFilters\b/gi) || []).length;
+            if (filterCount > 1) {
+                push('craft', 'composition', 'multiple-filter-regions', '组合建议：一个列表视图通常只保留一个 MPageFilters 筛选区（list-filters / collapsible / stack / dense 四选一）。', 'Composition: keep a single MPageFilters region per list view (pick one of list-filters / collapsible / stack / dense).');
+            }
+        }
+        // Craft: composition relations — filter stack already carries chips; avoid stacking a standalone chip row
+        if (/<MPageFilters\b[^>]*\bcollapsible\b[\s\S]*?<\/MPageFilters>/i.test(code) &&
+            /<MPageFilterChips\b/i.test(code)) {
+            push('craft', 'composition', 'redundant-filter-chips', '组合建议：使用折叠筛选栈（list-filters-stack / collapsible 已含已选摘要）时，通常不再叠加独立 MPageFilterChips。', 'Composition: when the collapsible filter stack already renders active chips, avoid adding a standalone MPageFilterChips row.');
+        }
+        // Craft: composition relations — density mixed within one page
+        if (/density\s*=\s*["']compact["']/i.test(code) && /density\s*=\s*["']spacious["']/i.test(code)) {
+            push('craft', 'composition', 'mixed-density', '组合建议：同一页面内保持密度一致，不要混用 compact 与 spacious。', 'Composition: keep density consistent within one page — do not mix compact and spacious.');
+        }
         // Brief fidelity: required blocks / components
         const mapped = args.brief
             ? mapReferenceBrief(args.brief)

package/package.json

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