@morya-ui/mcp 0.3.3 → 0.3.5

package/dist/tools.js

@@ -1,9 +1,10 @@
 import { findComponent, findGuide, loadCatalog, normalizeName, resolveLocale, textResult, toKebab, } from './catalog.js';
 import { componentDecisions, findDecision, scoreDecision } from './decisions.js';
-import { listGoldenPages, readGoldenPageSource } from './golden-pages.js';
+import { listGoldenPages, readGoldenPageSource, resolveGoldenPageId } from './golden-pages.js';
 import { filterPageSnippets, findPageSnippet, pageSnippets, scorePageSnippet } from './page-snippets.js';
 import { designRules, findPattern, pagePatterns, scorePattern } from './patterns.js';
 import { countCatalogResources, countCatalogResourceTemplates } from './resources.js';
+import { resolveListCraftVariant, resolveStyleDirection, styleResolution, } from './style-presets.js';
 function inspectButtonIconOnlyUsage(code, issues) {
     const pairedTagRe = /<MButton\b([^>]*)>([\s\S]*?)<\/MButton>/gi;
     let match = pairedTagRe.exec(code);
@@ -64,6 +65,7 @@ function mapDecisionOption(option, locale) {
         avoidWhen: zh ? option.avoidWhen : option.avoidWhenEn,
         recipe,
         antiPatterns: zh ? option.antiPatterns : option.antiPatternsEn,
+        ...(option.relatedSnippets?.length ? { relatedSnippets: option.relatedSnippets } : {}),
     };
 }
 function generatedPageCode(patternId, intent, locale) {
@@ -92,149 +94,149 @@ function generatedPageCode(patternId, intent, locale) {
     const wizardImports = isWizard ? ', MStepper, MSpace' : '';
     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}${statusImports} } from 'morya-ui'
-
-const loading = ref(false)
-const error = ref('')
-const title = ${JSON.stringify(title)}
-${isList ? `const keyword = ref('')
-const rows = ref<Record<string, unknown>[]>([])
-const columns = [{ key: 'name', label: '${zh ? '名称' : 'Name'}' }, { key: 'status', label: '${zh ? '状态' : 'Status'}' }]
-` : ''}${isForm || isAuth || isWizard ? `const model = ref({ name: '' })
-` : ''}${isDashboard ? `const metrics = ref([
-  { label: '${zh ? '总用户' : 'Users'}', value: '0' },
-  { label: '${zh ? '今日活跃' : 'Active today'}', value: '0' },
-])
-` : ''}${isSettings ? `const activeTab = ref('general')
-const settingTabs = [{ label: '${zh ? '常规' : 'General'}', value: 'general' }]
-` : ''}${isWizard ? `const activeStep = ref(0)
-const wizardSteps = [{ label: '${zh ? '基本信息' : 'Details'}' }, { label: '${zh ? '确认' : 'Confirm'}' }]
-` : ''}
-
-async function submit() {
-  loading.value = true
-  error.value = ''
-  try {
-    // Replace with the page API request.
-  } finally {
-    loading.value = false
-  }
-}
+    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}${statusImports} } from 'morya-ui'
+
+const loading = ref(false)
+const error = ref('')
+const title = ${JSON.stringify(title)}
+${isList ? `const keyword = ref('')
+const rows = ref<Record<string, unknown>[]>([])
+const columns = [{ key: 'name', label: '${zh ? '名称' : 'Name'}' }, { key: 'status', label: '${zh ? '状态' : 'Status'}' }]
+` : ''}${isForm || isAuth || isWizard ? `const model = ref({ name: '' })
+` : ''}${isDashboard ? `const metrics = ref([
+  { label: '${zh ? '总用户' : 'Users'}', value: '0' },
+  { label: '${zh ? '今日活跃' : 'Active today'}', value: '0' },
+])
+` : ''}${isSettings ? `const activeTab = ref('general')
+const settingTabs = [{ label: '${zh ? '常规' : 'General'}', value: 'general' }]
+` : ''}${isWizard ? `const activeStep = ref(0)
+const wizardSteps = [{ label: '${zh ? '基本信息' : 'Details'}' }, { label: '${zh ? '确认' : 'Confirm'}' }]
+` : ''}
+
+async function submit() {
+  loading.value = true
+  error.value = ''
+  try {
+    // Replace with the page API request.
+  } finally {
+    loading.value = false
+  }
+}
 </script>`;
-    const listContent = `            <MPageHeader :title="title">
-              <template #actions>
-                <MButton severity="primary">${zh ? '新建' : 'Create'}</MButton>
-              </template>
-            </MPageHeader>
-            <MPageFilters variant="filled" :aria-label="${zh ? '筛选' : 'Filters'}">
-              <MSpace wrap>
-                <MInput v-model="keyword" placeholder="${zh ? '搜索关键词' : 'Search keyword'}" clearable style="width: 14rem" />
-                <MButton severity="secondary">${zh ? '查询' : 'Search'}</MButton>
-                <MButton severity="secondary">${zh ? '重置' : 'Reset'}</MButton>
-              </MSpace>
-            </MPageFilters>
-            <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>
-                <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>
+    const listContent = `            <MPageHeader :title="title">
+              <template #actions>
+                <MButton severity="primary">${zh ? '新建' : 'Create'}</MButton>
+              </template>
+            </MPageHeader>
+            <MPageFilters variant="filled" :aria-label="${zh ? '筛选' : 'Filters'}">
+              <MSpace wrap>
+                <MInput v-model="keyword" placeholder="${zh ? '搜索关键词' : 'Search keyword'}" clearable style="width: 14rem" />
+                <MButton severity="secondary">${zh ? '查询' : 'Search'}</MButton>
+                <MButton severity="secondary">${zh ? '重置' : 'Reset'}</MButton>
+              </MSpace>
+            </MPageFilters>
+            <MTable :columns="columns" :rows="rows" :loading="loading" fill 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>
+                <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.'}" />
-            <MPageSection variant="form">
-              <MForm @submit.prevent="submit">
-                <MFormItem label="${zh ? '名称' : 'Name'}" name="name" required>
-                  <MInput v-model="model.name" fluid />
-                </MFormItem>
-                <MPageSection variant="actions">
-                  <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '保存' : 'Save'}</MButton>
-                  <MButton severity="secondary">${zh ? '取消' : 'Cancel'}</MButton>
-                </MPageSection>
-              </MForm>
+    const formContent = `            <MPageHeader :title="title" :description="${zh ? '填写表单并保存。' : 'Fill in the form and save.'}" />
+            <MPageSection variant="form">
+              <MForm @submit.prevent="submit">
+                <MFormItem label="${zh ? '名称' : 'Name'}" name="name" required>
+                  <MInput v-model="model.name" fluid />
+                </MFormItem>
+                <MPageSection variant="actions">
+                  <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '保存' : 'Save'}</MButton>
+                  <MButton severity="secondary">${zh ? '取消' : 'Cancel'}</MButton>
+                </MPageSection>
+              </MForm>
             </MPageSection>`;
-    const dashboardContent = `            <MPageHeader :title="title" />
-            <MGrid :cols="2" :x-gap="16" :y-gap="16" responsive="screen">
-              <MGridItem v-for="metric in metrics" :key="metric.label" :span="1">
-                <MPageStat :label="metric.label" :value="metric.value" icon="activity" />
-              </MGridItem>
-            </MGrid>
-            <MCard shadow="always" :title="${zh ? '趋势概览' : 'Trend overview'}">
-              <MSkeleton v-if="loading" height="8rem" />
-              <MEmpty
-                v-else
-                :title="${zh ? '暂无图表数据' : 'No chart data yet'}"
-                :description="${zh ? '接入图表或业务组件。' : 'Connect charts or business widgets here.'}"
-                aria-label="${zh ? '图表占位' : 'Chart placeholder'}"
-              />
+    const dashboardContent = `            <MPageHeader :title="title" />
+            <MGrid :cols="2" :x-gap="16" :y-gap="16" responsive="screen">
+              <MGridItem v-for="metric in metrics" :key="metric.label" :span="1">
+                <MPageStat :label="metric.label" :value="metric.value" icon="activity" />
+              </MGridItem>
+            </MGrid>
+            <MCard shadow="always" :title="${zh ? '趋势概览' : 'Trend overview'}">
+              <MSkeleton v-if="loading" height="8rem" />
+              <MEmpty
+                v-else
+                :title="${zh ? '暂无图表数据' : 'No chart data yet'}"
+                :description="${zh ? '接入图表或业务组件。' : 'Connect charts or business widgets here.'}"
+                aria-label="${zh ? '图表占位' : 'Chart placeholder'}"
+              />
             </MCard>`;
-    const detailContent = `            <MPageHeader :title="title" :description="${zh ? '查看资源摘要与属性。' : 'Review summary and properties.'}">
-              <template #actions>
-                <MSpace>
-                  <MStatus :label="${zh ? '启用' : 'Active'}" severity="success" />
-                  <MButton severity="primary">${zh ? '编辑' : 'Edit'}</MButton>
-                  <MButton severity="secondary">${zh ? '返回' : 'Back'}</MButton>
-                </MSpace>
-              </template>
-            </MPageHeader>
-            <MCard :title="${zh ? '基本信息' : 'Basics'}">
-              <p style="margin:0;color:var(--m-color-text-muted)">${zh ? '用定义列表或网格展示属性；相关列表用 MTable + rows。' : 'Use a definition grid; related lists use MTable + rows.'}</p>
+    const detailContent = `            <MPageHeader :title="title" :description="${zh ? '查看资源摘要与属性。' : 'Review summary and properties.'}">
+              <template #actions>
+                <MSpace>
+                  <MStatus :label="${zh ? '启用' : 'Active'}" severity="success" />
+                  <MButton severity="primary">${zh ? '编辑' : 'Edit'}</MButton>
+                  <MButton severity="secondary">${zh ? '返回' : 'Back'}</MButton>
+                </MSpace>
+              </template>
+            </MPageHeader>
+            <MCard :title="${zh ? '基本信息' : 'Basics'}">
+              <p style="margin:0;color:var(--m-color-text-muted)">${zh ? '用定义列表或网格展示属性；相关列表用 MTable + rows。' : 'Use a definition grid; related lists use MTable + rows.'}</p>
             </MCard>`;
-    const settingsContent = `            <MPageHeader :title="title" :description="${zh ? '按域分组配置偏好。' : 'Grouped preference settings.'}" />
-            <MTabs v-model="activeTab" :tabs="settingTabs">
-              <template #default="{ activeValue }">
-                <MPageSection v-if="activeValue === 'general'" variant="form" :title="${zh ? '常规' : 'General'}">
-                  <MForm @submit.prevent="submit">
-                    <MFormItem label="${zh ? '显示名称' : 'Display name'}" name="name" required>
-                      <MInput v-model="model.name" fluid />
-                    </MFormItem>
-                    <MPageSection variant="actions">
-                      <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '保存' : 'Save'}</MButton>
-                    </MPageSection>
-                  </MForm>
-                </MPageSection>
-              </template>
+    const settingsContent = `            <MPageHeader :title="title" :description="${zh ? '按域分组配置偏好。' : 'Grouped preference settings.'}" />
+            <MTabs v-model="activeTab" :tabs="settingTabs">
+              <template #default="{ activeValue }">
+                <MPageSection v-if="activeValue === 'general'" variant="form" :title="${zh ? '常规' : 'General'}">
+                  <MForm @submit.prevent="submit">
+                    <MFormItem label="${zh ? '显示名称' : 'Display name'}" name="name" required>
+                      <MInput v-model="model.name" fluid />
+                    </MFormItem>
+                    <MPageSection variant="actions">
+                      <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '保存' : 'Save'}</MButton>
+                    </MPageSection>
+                  </MForm>
+                </MPageSection>
+              </template>
             </MTabs>`;
-    const wizardContent = `            <MPageHeader :title="title" :description="${zh ? '每步一个主任务。' : 'One job per step.'}" />
-            <MStepper v-model="activeStep" :steps="wizardSteps" linear />
-            <MPageSection variant="form">
-              <MForm @submit.prevent="submit">
-                <MFormItem label="${zh ? '名称' : 'Name'}" name="name" required>
-                  <MInput v-model="model.name" fluid />
-                </MFormItem>
-                <MPageSection variant="actions">
-                  <MSpace>
-                    <MButton severity="secondary" text :disabled="activeStep === 0" @click="activeStep = Math.max(activeStep - 1, 0)">${zh ? '上一步' : 'Back'}</MButton>
-                    <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '下一步' : 'Next'}</MButton>
-                  </MSpace>
-                </MPageSection>
-              </MForm>
+    const wizardContent = `            <MPageHeader :title="title" :description="${zh ? '每步一个主任务。' : 'One job per step.'}" />
+            <MStepper v-model="activeStep" :steps="wizardSteps" linear />
+            <MPageSection variant="form">
+              <MForm @submit.prevent="submit">
+                <MFormItem label="${zh ? '名称' : 'Name'}" name="name" required>
+                  <MInput v-model="model.name" fluid />
+                </MFormItem>
+                <MPageSection variant="actions">
+                  <MSpace>
+                    <MButton severity="secondary" text :disabled="activeStep === 0" @click="activeStep = Math.max(activeStep - 1, 0)">${zh ? '上一步' : 'Back'}</MButton>
+                    <MButton native-type="submit" severity="primary" :loading="loading">${zh ? '下一步' : 'Next'}</MButton>
+                  </MSpace>
+                </MPageSection>
+              </MForm>
             </MPageSection>`;
     let innerTemplate = '';
     if (isList) {
-        innerTemplate = `<MConfigProvider :locale="zhCN">
-  <MLayout has-sider fill-viewport>
-    <MLayoutSider bordered />
-    <MLayout>
-      <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
-        <MBreadcrumb :model="[{ label: '${zh ? '首页' : 'Home'}', to: '/' }, { label: '${title}' }]" />
-      </MLayoutHeader>
-      <MLayoutContent>
-        <MPageContent>
-${listContent}
-        </MPageContent>
-      </MLayoutContent>
-    </MLayout>
-  </MLayout>
+        innerTemplate = `<MConfigProvider :locale="zhCN">
+  <MLayout has-sider fill-viewport>
+    <MLayoutSider bordered />
+    <MLayout>
+      <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
+        <MBreadcrumb :model="[{ label: '${zh ? '首页' : 'Home'}', to: '/' }, { label: '${title}' }]" />
+      </MLayoutHeader>
+      <MLayoutContent>
+        <MPageContent fill>
+${listContent}
+        </MPageContent>
+      </MLayoutContent>
+    </MLayout>
+  </MLayout>
 </MConfigProvider>`;
     }
     else if (useLayoutShell) {
@@ -248,76 +250,76 @@ ${listContent}
                         ? wizardContent
                         : formContent;
         const pageContentAttrs = isForm || isSettings || isWizard ? ' width="narrow"' : isDashboard ? ' density="spacious"' : '';
-        innerTemplate = `<MConfigProvider :locale="zhCN">
-  <MLayout fill-viewport>
-    <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
-      <MBreadcrumb :model="[{ label: '${zh ? '首页' : 'Home'}', to: '/' }, { label: title }]" />
-    </MLayoutHeader>
-    <MLayoutContent>
-      <MPageContent${pageContentAttrs}>
-${content}
-      </MPageContent>
-    </MLayoutContent>
-  </MLayout>
+        innerTemplate = `<MConfigProvider :locale="zhCN">
+  <MLayout fill-viewport>
+    <MLayoutHeader :padding="'var(--m-space-4) var(--m-space-6)'">
+      <MBreadcrumb :model="[{ label: '${zh ? '首页' : 'Home'}', to: '/' }, { label: title }]" />
+    </MLayoutHeader>
+    <MLayoutContent>
+      <MPageContent${pageContentAttrs}>
+${content}
+      </MPageContent>
+    </MLayoutContent>
+  </MLayout>
 </MConfigProvider>`;
     }
     else if (isAuth) {
-        innerTemplate = `<MConfigProvider :locale="zhCN">
-  <main class="m-generated-page m-generated-auth">
-    <MCard>
-      <MForm label-position="top" @submit.prevent="submit">
-        <MFormItem label="${zh ? '邮箱' : 'Email'}" name="email">
-          <MInput type="email" fluid />
-        </MFormItem>
-        <MFormItem label="${zh ? '密码' : 'Password'}" name="password">
-          <MInput type="password" fluid />
-        </MFormItem>
-        <MButton native-type="submit" severity="primary" :loading="loading" fluid>${zh ? '登录' : 'Sign in'}</MButton>
-      </MForm>
-    </MCard>
-  </main>
+        innerTemplate = `<MConfigProvider :locale="zhCN">
+  <main class="m-generated-page m-generated-auth">
+    <MCard>
+      <MForm label-position="top" @submit.prevent="submit">
+        <MFormItem label="${zh ? '邮箱' : 'Email'}" name="email">
+          <MInput type="email" fluid />
+        </MFormItem>
+        <MFormItem label="${zh ? '密码' : 'Password'}" name="password">
+          <MInput type="password" fluid />
+        </MFormItem>
+        <MButton native-type="submit" severity="primary" :loading="loading" fluid>${zh ? '登录' : 'Sign in'}</MButton>
+      </MForm>
+    </MCard>
+  </main>
 </MConfigProvider>`;
     }
     else if (isEmpty) {
-        innerTemplate = `<MConfigProvider :locale="zhCN">
-  <main class="m-generated-page">
-    <MPageContent>
-      <MPageHeader :title="title">
-        <template #actions>
-          <MButton severity="primary" @click="submit">${zh ? '新建' : 'Create'}</MButton>
-        </template>
-      </MPageHeader>
-    <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>
-    </MPageContent>
-  </main>
+        innerTemplate = `<MConfigProvider :locale="zhCN">
+  <main class="m-generated-page">
+    <MPageContent>
+      <MPageHeader :title="title">
+        <template #actions>
+          <MButton severity="primary" @click="submit">${zh ? '新建' : 'Create'}</MButton>
+        </template>
+      </MPageHeader>
+    <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>
+    </MPageContent>
+  </main>
 </MConfigProvider>`;
     }
     else {
-        innerTemplate = `<MConfigProvider :locale="zhCN">
-  <main class="m-generated-page">
-    <MCard>
-      <p class="m-generated-muted">${zh ? '将此区域替换为页面内容。' : 'Replace this area with page content.'}</p>
-      <MTag value="${zh ? '示例' : 'Example'}" severity="info" />
-    </MCard>
-  </main>
+        innerTemplate = `<MConfigProvider :locale="zhCN">
+  <main class="m-generated-page">
+    <MCard>
+      <p class="m-generated-muted">${zh ? '将此区域替换为页面内容。' : 'Replace this area with page content.'}</p>
+      <MTag value="${zh ? '示例' : 'Example'}" severity="info" />
+    </MCard>
+  </main>
 </MConfigProvider>`;
     }
-    const template = `<template>
-  ${innerTemplate}
-  <p v-if="error" role="alert" class="m-generated-error">${'{{ error }}'}</p>
+    const template = `<template>
+  ${innerTemplate}
+  <p v-if="error" role="alert" class="m-generated-error">${'{{ error }}'}</p>
 </template>`;
-    const style = `<style scoped>
-.m-generated-auth { display: grid; place-items: center; padding: var(--m-space-8); max-width: 24rem; margin: 0 auto; min-height: 100vh; }
-.m-generated-empty { display: grid; gap: var(--m-space-2); justify-items: center; padding: var(--m-space-8); text-align: center; }
-.m-generated-error { color: var(--m-color-danger); padding: 0 var(--m-space-6); }
+    const style = `<style scoped>
+.m-generated-auth { display: grid; place-items: center; padding: var(--m-space-8); max-width: 24rem; margin: 0 auto; min-height: 100vh; }
+.m-generated-empty { display: grid; gap: var(--m-space-2); justify-items: center; padding: var(--m-space-8); text-align: center; }
+.m-generated-error { color: var(--m-color-danger); padding: 0 var(--m-space-6); }
 </style>`;
     return { script, template, style };
 }
@@ -729,13 +731,43 @@ export function createToolHandlers(catalog = loadCatalog()) {
             });
         }
         const locale = resolveLocale(args.mode);
+        const styleDirection = resolveStyleDirection({ intent: args.intent, style: args.style });
+        const stylePayload = {
+            resolution: styleDirection.resolution,
+            confidence: styleDirection.confidence,
+            summary: styleDirection.summary ?? null,
+            guidance: locale === 'en-US' ? styleDirection.guidanceEn : styleDirection.guidanceZh,
+            priority: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+            hardRules: locale === 'en-US' ? styleResolution.hardRulesEn : styleResolution.hardRulesZh,
+            note: locale === 'en-US'
+                ? 'No named style-preset catalog. Follow an explicit user reference/description; if styleDirection.resolution is ask, ask before inventing the look. Prefer snippets for composition; golden pages are optional block-order checks, not aesthetics.'
+                : '没有命名风格预设表。有明确参考/描述就跟用户；若 styleDirection.resolution 为 ask，先询问再写完整视觉。优先用 snippets 拼装；黄金样例仅可选核对块顺序，不是审美模板。',
+        };
+        const craftText = [args.style || '', args.intent || ''].join(' ');
+        const resolvedGoldenId = resolveGoldenPageId({
+            patternId: best.pattern.id,
+            canonicalGoldenId: best.pattern.goldenPage,
+            styleId: craftText || null,
+        });
+        const resolvedGoldenPath = resolvedGoldenId
+            ? `docs/golden-pages/${resolvedGoldenId}.vue`
+            : best.pattern.goldenPage;
+        let suggestedSnippets = [...(best.pattern.suggestedSnippets ?? [])];
+        if (best.pattern.id === 'admin-list') {
+            const listCraft = resolveListCraftVariant(craftText);
+            if (listCraft === 'list-page-dense') {
+                suggestedSnippets = suggestedSnippets.map((id) => id === 'list-filters-stack' ? 'list-filters-dense' : id);
+            }
+        }
         const result = {
             intent: args.intent,
             pageType: args.pageType,
+            style: args.style,
             matchedPattern: best.pattern.id,
             title: locale === 'en-US' ? best.pattern.titleEn : best.pattern.title,
             confidence: best.score,
-            goldenPage: best.pattern.goldenPage,
+            goldenPage: resolvedGoldenPath,
+            styleDirection: stylePayload,
             components: best.pattern.components,
             structure: best.pattern.structure,
             layout: best.pattern.layout,
@@ -743,24 +775,39 @@ export function createToolHandlers(catalog = loadCatalog()) {
             interactionRules: best.pattern.interactionRules,
             avoid: best.pattern.avoid,
             alternatives: ranked.slice(1, 3).filter((item) => item.score > 0).map((item) => ({ id: item.pattern.id, score: item.score })),
+            suggestedSnippets,
             nextStep: (() => {
-                const goldenId = best.pattern.goldenPage?.split('/').pop()?.replace(/\.vue$/i, '') ||
-                    listGoldenPages().find((item) => item.patternId === best.pattern.id)?.id ||
-                    null;
+                const goldenId = resolvedGoldenId;
+                const snippets = suggestedSnippets;
+                const snippetHint = snippets.length > 0
+                    ? locale === 'en-US'
+                        ? ` Compose with get_page_snippet for: ${snippets.join(', ')}. Use recommend_component for L2 recipes (relatedSnippets).`
+                        : ` 用 get_page_snippet 拼装：${snippets.join(', ')}。选型用 recommend_component（含 relatedSnippets）。`
+                    : locale === 'en-US'
+                        ? ' Compose with get_page_snippet + recommend_component (relatedSnippets).'
+                        : ' 用 get_page_snippet + recommend_component（relatedSnippets）拼装。';
+                const styleHint = locale === 'en-US'
+                    ? styleDirection.resolution === 'ask'
+                        ? ' Style is uncertain — ask the user for a short description or reference before inventing the look.'
+                        : ` Follow styleDirection (${styleDirection.resolution}): “${styleDirection.summary || 'user/reference'}”; honor explicit user words over companions.`
+                    : styleDirection.resolution === 'ask'
+                        ? ' 风格不确定 — 先请用户说明气质或贴参考，再写完整视觉。'
+                        : ` 按 styleDirection（${styleDirection.resolution}）落实「${styleDirection.summary || '用户参考/描述'}」；用户明确指定优先于 companion。`;
+                const goldenHint = goldenId
+                    ? locale === 'en-US'
+                        ? ` Optional: get_golden_page("${goldenId}") only to check whole-page block order (not the default clone target).`
+                        : ` 可选：仅当需核对整页块顺序时再 get_golden_page("${goldenId}")（默认不要整页克隆）。`
+                    : locale === 'en-US'
+                        ? ' No golden page for this pattern — follow get_pattern structure + snippets.'
+                        : ' 该模式暂无黄金样例：按 get_pattern 结构 + snippets 拼装。';
                 if (locale === 'en-US') {
-                    return goldenId
-                        ? `Call get_golden_page("${goldenId}") and mirror it. Look up unfamiliar APIs with get_component/get_example, then always run validate_usage and validate_page. includeScaffold returns the golden source when available — not a separate aesthetic template.`
-                        : `No golden page for this pattern: use get_pattern + get_design_rules, look up APIs with get_component/get_example, then always run validate_usage and validate_page.`;
+                    return `${snippetHint.trim()}${styleHint}${goldenHint} Look up unfamiliar APIs with get_component/get_example, then always run validate_usage and validate_page.`;
                 }
-                return goldenId
-                    ? `调用 get_golden_page("${goldenId}") 并镜像结构。不熟悉的 API 用 get_component/get_example 核对，然后必须跑 validate_usage 与 validate_page。includeScaffold 有黄金样例时返回样例源码，不是另一套审美模板。`
-                    : `该模式暂无黄金样例：用 get_pattern + get_design_rules，API 用 get_component/get_example 核对，然后必须跑 validate_usage 与 validate_page。`;
+                return `${snippetHint.trim()}${styleHint}${goldenHint} 不熟悉的 API 用 get_component/get_example 核对，然后必须跑 validate_usage 与 validate_page。`;
             })(),
         };
         if (args.includeScaffold) {
-            const goldenId = best.pattern.goldenPage?.split('/').pop()?.replace(/\.vue$/i, '') ||
-                listGoldenPages().find((item) => item.patternId === best.pattern.id)?.id ||
-                null;
+            const goldenId = resolvedGoldenId;
             const golden = goldenId ? readGoldenPageSource(goldenId) : null;
             if (golden) {
                 result.scaffold = {
@@ -769,8 +816,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     files: { component: golden.source },
                     warnings: [
                         locale === 'en-US'
-                            ? 'Scaffold is the golden page source. Remap domain copy/data only; never invent props. Then validate_usage + validate_page.'
-                            : '脚手架即黄金样例源码。只替换域文案与数据，禁止臆造 prop。完成后必须 validate_usage + validate_page。',
+                            ? 'Scaffold is an optional structure reference from the golden sample. Prefer composing suggestedSnippets; remap domain copy/data only if you use this source. Never invent props. Then validate_usage + validate_page.'
+                            : '脚手架是黄金样例的可选结构参考。默认优先拼装 suggestedSnippets；若使用本源码只替换域文案与数据。禁止臆造 prop。完成后必须 validate_usage + validate_page。',
                     ],
                 };
             }
@@ -783,8 +830,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     files: { component: componentSource },
                     warnings: [
                         locale === 'en-US'
-                            ? 'No golden page for this pattern — structural fallback only. Prefer get_pattern + get_component. Must validate_usage before delivery.'
-                            : '该模式暂无黄金样例，仅为结构占位。优先 get_pattern + get_component。交付前必须 validate_usage。',
+                            ? 'No golden page for this pattern — structural fallback only. Prefer suggestedSnippets + get_component. Must validate_usage before delivery.'
+                            : '该模式暂无黄金样例，仅为结构占位。优先 suggestedSnippets + get_component。交付前必须 validate_usage。',
                     ],
                 };
             }
@@ -805,6 +852,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
             patternId: payload.record.patternId,
             title: locale === 'en-US' ? payload.record.titleEn : payload.record.title,
             file: payload.record.file,
+            style: payload.record.style ?? null,
+            variantOf: payload.record.variantOf ?? null,
             source: payload.source,
             nextStep: locale === 'en-US'
                 ? 'Mirror this structure and replace business data. Look up unfamiliar APIs with get_component/get_example, then always run validate_usage and validate_page. See get_design_rules for page standards.'
@@ -819,6 +868,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 patternId: item.patternId,
                 title: locale === 'en-US' ? item.titleEn : item.title,
                 file: item.file,
+                style: item.style ?? null,
+                variantOf: item.variantOf ?? null,
             })),
         });
     }
@@ -1033,6 +1084,19 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     : '契约：MTable 行数据使用 rows，不要用 data。见黄金样例 list-page / get_component Table。',
             });
         }
+        if (/fill-viewport|fillViewport/i.test(code)
+            && /<MTable\b[^>]*\bpaginator\b/i.test(code)
+            && /<MPageContent\b/i.test(code)
+            && !(/<MPageContent\b[^>]*\bfill\b/i.test(code)
+                && /<MTable\b[^>]*\bfill\b/i.test(code))) {
+            suggestions.push({
+                standardId: 'page-sections',
+                type: 'list-fill-height',
+                message: locale === 'en-US'
+                    ? 'Advisory: for a full-viewport admin list whose main job is one table, consider MPageContent fill + MTable fill so the body scrolls and pagination stays at the page bottom. Skip fill for embedded/short/document-scroll tables (see page-scroll-choice / golden list-page).'
+                    : '参考建议：若这是全视口后台主列表且表格是页面主任务，可考虑 MPageContent fill + MTable fill（表体滚动、分页贴底）。嵌入表/短页/整页文档滚动则跳过 fill（见 page-scroll-choice / 黄金样例 list-page）。',
+            });
+        }
         if (/<MMessage\b[^>]*\bseverity\b/i.test(code)) {
             suggestions.push({
                 standardId: 'feedback',
@@ -1097,10 +1161,18 @@ export function createToolHandlers(catalog = loadCatalog()) {
     }
     function getDesignRules(args = {}) {
         const locale = resolveLocale(args.mode);
+        const styles = {
+            resolution: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+            hardRules: locale === 'en-US' ? styleResolution.hardRulesEn : styleResolution.hardRulesZh,
+            note: locale === 'en-US'
+                ? 'No named style-preset catalog. Follow user reference/description; ask when uncertain.'
+                : '没有命名风格预设表。跟用户参考/描述；不确定就先问。',
+        };
         if (locale === 'zh-CN') {
             return textResult({
                 meta: designRules.meta,
                 standards: designRules.standards,
+                styles,
                 tokens: designRules.tokens,
                 composition: designRules.composition,
                 actions: designRules.actions,
@@ -1118,6 +1190,7 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 discouraged: item.discouragedEn,
                 mcp: item.mcp,
             })),
+            styles,
             tokens: {
                 colors: ['--m-color-primary', '--m-color-surface', '--m-color-text', '--m-color-border'],
                 spacing: '--m-space-*',
@@ -1159,9 +1232,25 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 'Form controls should have a visible label or an equivalent accessible name.',
                 'Overlays teleport to body by default; only change appendTo for a clear layout constraint.',
                 'Prefer documented component variants over deep CSS overrides.',
+                'Resolve visual style: follow explicit user reference/description first; else infer from clear prompt cues; if uncertain ask once. No named preset catalog. Golden pages lock structure, not aesthetics.',
             ],
         });
     }
+    function getStyleDirection(args = {}) {
+        const locale = resolveLocale(args.mode);
+        const direction = resolveStyleDirection({ intent: args.intent, style: args.style });
+        return textResult({
+            resolution: direction.resolution,
+            confidence: direction.confidence,
+            summary: direction.summary ?? null,
+            guidance: locale === 'en-US' ? direction.guidanceEn : direction.guidanceZh,
+            priority: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+            hardRules: locale === 'en-US' ? styleResolution.hardRulesEn : styleResolution.hardRulesZh,
+            note: locale === 'en-US'
+                ? 'No named style-preset catalog. Pass style as free-text user description when they specified one.'
+                : '没有命名风格预设表。用户有描述时把原文放进 style；不确定时 resolution 为 ask，应先问用户。',
+        });
+    }
     function recommendComponent(args) {
         const locale = resolveLocale(args.mode);
         if (!args.query && !args.decision) {
@@ -1380,6 +1469,7 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 'get_pattern',
                 'recommend_page',
                 'get_design_rules',
+                'get_style_direction',
                 'recommend_component',
                 'list_golden_pages',
                 'get_golden_page',
@@ -1403,6 +1493,7 @@ export function createToolHandlers(catalog = loadCatalog()) {
         getPattern,
         recommendPage,
         getDesignRules,
+        getStyleDirection,
         recommendComponent,
         listGoldenPageCatalog,
         getGoldenPage,