@morya-ui/mcp 0.3.2 → 0.3.4

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 { findStylePreset, resolveStyleDirection, stylePresets, styleResolution, } from './style-presets.js';
 function inspectButtonIconOnlyUsage(code, issues) {
     const pairedTagRe = /<MButton\b([^>]*)>([\s\S]*?)<\/MButton>/gi;
     let match = pairedTagRe.exec(code);
@@ -47,6 +48,25 @@ function pickLocale(record, locale) {
 function vueName(name) {
     return `M${name}`;
 }
+function mapDecisionOption(option, locale) {
+    const zh = locale !== 'en-US';
+    const recipe = {
+        props: zh ? option.recipe.props : option.recipe.propsEn,
+        ...(option.recipe.slots?.length
+            ? { slots: zh ? option.recipe.slots : option.recipe.slotsEn }
+            : {}),
+        ...(option.recipe.events?.length
+            ? { events: zh ? option.recipe.events : option.recipe.eventsEn }
+            : {}),
+    };
+    return {
+        component: option.component,
+        when: zh ? option.when : option.whenEn,
+        avoidWhen: zh ? option.avoidWhen : option.avoidWhenEn,
+        recipe,
+        antiPatterns: zh ? option.antiPatterns : option.antiPatternsEn,
+    };
+}
 function generatedPageCode(patternId, intent, locale) {
     const zh = locale === 'zh-CN';
     const isList = patternId === 'admin-list';
@@ -73,149 +93,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) {
@@ -229,76 +249,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 };
 }
@@ -710,13 +730,47 @@ 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,
+            preset: styleDirection.preset
+                ? {
+                    id: styleDirection.preset.id,
+                    title: locale === 'en-US' ? styleDirection.preset.titleEn : styleDirection.preset.title,
+                    summary: locale === 'en-US' ? styleDirection.preset.summaryEn : styleDirection.preset.summary,
+                    apply: locale === 'en-US' ? styleDirection.preset.applyEn : styleDirection.preset.apply,
+                    avoid: locale === 'en-US' ? styleDirection.preset.avoidEn : styleDirection.preset.avoid,
+                }
+                : null,
+            candidates: styleDirection.candidates.map((item) => ({
+                id: item.id,
+                title: locale === 'en-US' ? item.titleEn : item.title,
+                score: item.score,
+            })),
+            guidance: locale === 'en-US' ? styleDirection.guidanceEn : styleDirection.guidanceZh,
+            priority: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+            note: locale === 'en-US'
+                ? 'If the user supplied a visual reference, follow that first (map to --m-* + M*). Golden pages lock structure, not the only aesthetic.'
+                : '若用户提供了参考样式，优先跟参考（映射到 --m-* + M*）。黄金样例锁结构，不是唯一审美。',
+        };
+        const resolvedGoldenId = resolveGoldenPageId({
+            patternId: best.pattern.id,
+            canonicalGoldenId: best.pattern.goldenPage,
+            styleId: styleDirection.preset?.id || args.style || null,
+        });
+        const resolvedGoldenPath = resolvedGoldenId
+            ? `docs/golden-pages/${resolvedGoldenId}.vue`
+            : best.pattern.goldenPage;
         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,
@@ -725,23 +779,26 @@ export function createToolHandlers(catalog = loadCatalog()) {
             avoid: best.pattern.avoid,
             alternatives: ranked.slice(1, 3).filter((item) => item.score > 0).map((item) => ({ id: item.pattern.id, score: item.score })),
             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 styleHint = locale === 'en-US'
+                    ? styleDirection.resolution === 'offer'
+                        ? ' Resolve style first (reference → preset → ask among quiet/soft/dense/rail/studio/ink).'
+                        : ` Apply styleDirection preset "${styleDirection.preset?.id || 'n/a'}".`
+                    : styleDirection.resolution === 'offer'
+                        ? ' 先定风格（参考 → 预设 → 请用户从 quiet/soft/dense/rail/studio/ink 选）。'
+                        : ` 套用 styleDirection 预设「${styleDirection.preset?.id || 'n/a'}」。`;
                 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.`;
+                        ? `Call get_golden_page("${goldenId}") and mirror structure.${styleHint} Look up unfamiliar APIs with get_component/get_example, then always run validate_usage and validate_page.`
+                        : `No golden page for this pattern: use get_pattern + get_design_rules.${styleHint} Look up 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。`;
+                    ? `调用 get_golden_page("${goldenId}") 并镜像结构。${styleHint} 不熟悉的 API 用 get_component/get_example 核对，然后必须跑 validate_usage 与 validate_page。`
+                    : `该模式暂无黄金样例：用 get_pattern + get_design_rules。${styleHint} 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 = {
@@ -786,6 +843,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.'
@@ -800,6 +859,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,
             })),
         });
     }
@@ -1014,6 +1075,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',
@@ -1078,10 +1152,21 @@ 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,
+            presets: stylePresets.map((preset) => ({
+                id: preset.id,
+                title: locale === 'en-US' ? preset.titleEn : preset.title,
+                summary: locale === 'en-US' ? preset.summaryEn : preset.summary,
+                lanes: preset.lanes,
+            })),
+        };
         if (locale === 'zh-CN') {
             return textResult({
                 meta: designRules.meta,
                 standards: designRules.standards,
+                styles,
                 tokens: designRules.tokens,
                 composition: designRules.composition,
                 actions: designRules.actions,
@@ -1099,6 +1184,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-*',
@@ -1140,9 +1226,47 @@ 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 via reference → preset → prompt cues → offer quiet/soft/dense/rail/studio/ink; golden pages lock structure, not aesthetics.',
             ],
         });
     }
+    function listStylePresets(args = {}) {
+        const locale = resolveLocale(args.mode);
+        return textResult({
+            resolution: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+            hardRules: locale === 'en-US' ? styleResolution.hardRulesEn : styleResolution.hardRulesZh,
+            presets: stylePresets.map((preset) => ({
+                id: preset.id,
+                title: locale === 'en-US' ? preset.titleEn : preset.title,
+                summary: locale === 'en-US' ? preset.summaryEn : preset.summary,
+                lanes: preset.lanes,
+                keywords: preset.keywords,
+                listGoldenPage: preset.listGoldenPage ?? null,
+            })),
+        });
+    }
+    function getStylePreset(args) {
+        const locale = resolveLocale(args.mode);
+        const preset = findStylePreset(args.style);
+        if (!preset) {
+            return textResult({
+                error: `Style preset not found: ${args.style}`,
+                available: stylePresets.map((item) => item.id),
+            });
+        }
+        return textResult({
+            id: preset.id,
+            title: locale === 'en-US' ? preset.titleEn : preset.title,
+            summary: locale === 'en-US' ? preset.summaryEn : preset.summary,
+            lanes: preset.lanes,
+            keywords: preset.keywords,
+            listGoldenPage: preset.listGoldenPage ?? null,
+            cues: locale === 'en-US' ? preset.cuesEn : preset.cues,
+            apply: locale === 'en-US' ? preset.applyEn : preset.apply,
+            avoid: locale === 'en-US' ? preset.avoidEn : preset.avoid,
+            resolution: locale === 'en-US' ? styleResolution.priorityEn : styleResolution.priorityZh,
+        });
+    }
     function recommendComponent(args) {
         const locale = resolveLocale(args.mode);
         if (!args.query && !args.decision) {
@@ -1170,11 +1294,7 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 title: locale === 'en-US' ? decision.titleEn : decision.title,
                 question: locale === 'en-US' ? decision.questionEn : decision.question,
                 keywords: decision.keywords,
-                options: decision.options.map((option) => ({
-                    component: option.component,
-                    when: locale === 'en-US' ? option.whenEn : option.when,
-                    avoidWhen: locale === 'en-US' ? option.avoidWhenEn : option.avoidWhen,
-                })),
+                options: decision.options.map((option) => mapDecisionOption(option, locale)),
             });
         }
         if (!args.query) {
@@ -1194,14 +1314,10 @@ export function createToolHandlers(catalog = loadCatalog()) {
             decision: matched.id,
             title: locale === 'en-US' ? matched.titleEn : matched.title,
             question: locale === 'en-US' ? matched.questionEn : matched.question,
-            recommendations: matched.options.map((option) => ({
-                component: option.component,
-                when: locale === 'en-US' ? option.whenEn : option.when,
-                avoidWhen: locale === 'en-US' ? option.avoidWhenEn : option.avoidWhen,
-            })),
+            recommendations: matched.options.map((option) => mapDecisionOption(option, locale)),
             nextStep: locale === 'en-US'
-                ? 'Use get_component and get_example for the selected component before implementing.'
-                : '实现前请用 get_component 和 get_example 核对所选组件 API。',
+                ? 'Apply the recipe props/slots/events, then use get_component and get_example before implementing. Run validate_usage before delivery.'
+                : '先按 recipe 的 props/slots/events 落地，再用 get_component / get_example 核对 API；交付前跑 validate_usage。',
         });
     }
     function getSetup(args) {
@@ -1369,6 +1485,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 'get_pattern',
                 'recommend_page',
                 'get_design_rules',
+                'list_style_presets',
+                'get_style_preset',
                 'recommend_component',
                 'list_golden_pages',
                 'get_golden_page',
@@ -1392,6 +1510,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
         getPattern,
         recommendPage,
         getDesignRules,
+        listStylePresets,
+        getStylePreset,
         recommendComponent,
         listGoldenPageCatalog,
         getGoldenPage,