@morya-ui/mcp 0.3.4 → 0.3.5

package/dist/__tests__/tools.test.js

@@ -202,19 +202,23 @@ describe('@morya-ui/mcp handlers', () => {
         const result = read(handlers.recommendPage({ intent: '用户列表页', pageType: 'list' }));
         expect(result.matchedPattern).toBe('admin-list');
         expect(result.nextStep).toContain('validate_usage');
+        expect(result.nextStep).toMatch(/get_page_snippet|suggestedSnippets|relatedSnippets/);
         expect(result.nextStep).toContain('get_golden_page');
+        expect(result.nextStep).toMatch(/可选|Optional/);
+        expect(result.suggestedSnippets?.length).toBeGreaterThan(0);
+        expect(result.suggestedSnippets).toContain('list-filters-stack');
+        expect(result.suggestedSnippets).toContain('list-table');
         expect(result.pageStandards).toBeUndefined();
         expect(result.scrollStandards).toBeUndefined();
-        expect(result.styleDirection?.candidates?.length).toBeGreaterThan(0);
+        expect(result.styleDirection?.resolution).toBeTruthy();
     });
-    it('resolves an explicit style preset on recommend_page', () => {
-        const result = read(handlers.recommendPage({ intent: '用户列表', pageType: 'list', style: 'soft' }));
-        expect(result.styleDirection.resolution).toBe('preset');
-        expect(result.styleDirection.preset?.id).toBe('soft');
-        expect(result.styleDirection.guidance).toContain('soft');
+    it('resolves an explicit free-text style on recommend_page', () => {
+        const result = read(handlers.recommendPage({ intent: '用户列表', pageType: 'list', style: '简洁留白，少装饰' }));
+        expect(result.styleDirection.resolution).toBe('explicit');
+        expect(result.styleDirection.summary).toContain('简洁留白');
         expect(result.goldenPage).toContain('list-page');
     });
-    it('routes dense/rail styles to list craft golden variants', () => {
+    it('routes dense/rail craft cues to list golden variants', () => {
         const dense = read(handlers.recommendPage({
             intent: '监控告警列表',
             pageType: 'list',
@@ -225,6 +229,8 @@ describe('@morya-ui/mcp handlers', () => {
         expect(dense.scaffold.goldenPage).toBe('list-page-dense');
         expect(dense.scaffold.files.component).toContain('density="compact"');
         expect(dense.nextStep).toContain('list-page-dense');
+        expect(dense.suggestedSnippets).toContain('list-filters-dense');
+        expect(dense.suggestedSnippets).not.toContain('list-filters-stack');
         const rail = read(handlers.recommendPage({
             intent: '品牌色后台列表',
             pageType: 'list',
@@ -234,6 +240,7 @@ describe('@morya-ui/mcp handlers', () => {
         expect(rail.goldenPage).toContain('list-page-rail');
         expect(rail.scaffold.goldenPage).toBe('list-page-rail');
         expect(rail.scaffold.files.component).toContain('gp-rail-sider');
+        expect(rail.suggestedSnippets).toContain('list-filters-stack');
     });
     it('returns dense and rail golden page sources', () => {
         const dense = read(handlers.getGoldenPage({ page: 'list-page-dense' }));
@@ -246,19 +253,21 @@ describe('@morya-ui/mcp handlers', () => {
         expect(rail.style).toBe('rail');
         expect(rail.source).toContain('color-mix');
     });
-    it('lists style presets with resolution priority', () => {
-        const result = read(handlers.listStylePresets({ mode: 'zh-CN' }));
-        expect(result.presets.map((item) => item.id)).toEqual(expect.arrayContaining(['quiet', 'soft', 'dense', 'rail', 'studio', 'ink']));
-        expect(result.resolution[0]).toContain('参考');
-    });
-    it('reads a style preset by alias', () => {
-        const result = read(handlers.getStylePreset({ style: '柔和留白', mode: 'zh-CN' }));
-        expect(result.id).toBe('soft');
-        expect(result.apply.length).toBeGreaterThan(0);
-    });
-    it('exposes style presets from get_design_rules', () => {
+    it('exposes style direction rules without a preset catalog', () => {
+        const result = read(handlers.getStyleDirection({ mode: 'zh-CN' }));
+        expect(result.resolution).toBe('ask');
+        expect(result.priority[0]).toContain('参考');
+        expect(result.hardRules.some((rule) => rule.includes('没有命名风格预设'))).toBe(true);
+        expect(result.note).toContain('没有命名风格预设');
+        const explicit = read(handlers.getStyleDirection({ style: '毛玻璃一点', mode: 'zh-CN' }));
+        expect(explicit.resolution).toBe('explicit');
+        expect(explicit.summary).toContain('毛玻璃');
+    });
+    it('exposes style direction from get_design_rules', () => {
         const result = read(handlers.getDesignRules({ mode: 'zh-CN' }));
-        expect(result.styles.presets.some((item) => item.id === 'dense')).toBe(true);
+        expect(result.styles.resolution[0]).toContain('参考');
+        expect(result.styles.presets).toBeUndefined();
+        expect(result.styles.note).toContain('没有命名风格预设');
     });
     it('keeps get_golden_page focused on source code', () => {
         const result = read(handlers.getGoldenPage({ page: 'list-page' }));
@@ -355,6 +364,14 @@ describe('@morya-ui/mcp handlers', () => {
         expect(result.id).toBe('overlay-choice');
         expect(result.options.some((option) => option.component === 'Drawer')).toBe(true);
     });
+    it('exposes relatedSnippets on decision options', () => {
+        const result = read(handlers.recommendComponent({ decision: 'confirm-choice' }));
+        const confirm = result.options.find((option) => option.component === 'ConfirmDialog');
+        expect(confirm?.relatedSnippets).toContain('confirm-delete');
+        const formSurface = read(handlers.recommendComponent({ decision: 'form-surface-choice' }));
+        const dialog = formSurface.options.find((option) => option.component === 'Dialog');
+        expect(dialog?.relatedSnippets).toContain('form-in-dialog');
+    });
     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');
@@ -390,11 +407,12 @@ describe('@morya-ui/mcp handlers', () => {
         expect(result.counts.decisions).toBeGreaterThan(0);
         expect(result.counts.resources).toBeGreaterThan(100);
         expect(result.counts.resourceTemplates).toBe(3);
-        expect(result.tools).toHaveLength(20);
+        expect(result.tools).toHaveLength(19);
         expect(result.tools).toContain('get_golden_page');
         expect(result.tools).toContain('get_page_snippet');
-        expect(result.tools).toContain('list_style_presets');
-        expect(result.tools).toContain('get_style_preset');
+        expect(result.tools).toContain('get_style_direction');
+        expect(result.tools).not.toContain('list_style_presets');
+        expect(result.tools).not.toContain('get_style_preset');
         expect(result.tools).toContain('validate_page');
         expect(result.tools).not.toContain('create_page');
     });

package/dist/decisions.d.ts

@@ -16,6 +16,8 @@ export interface ComponentDecisionOption {
     recipe: ComponentDecisionRecipe;
     antiPatterns: string[];
     antiPatternsEn: string[];
+    /** Page-snippet ids to compose after choosing this option (composition-first). */
+    relatedSnippets?: string[];
 }
 export interface ComponentDecision {
     id: string;

package/dist/decisions.js

@@ -45,7 +45,7 @@ export const componentDecisions = [
                 recipe: recipe([
                     ['v-model / modelValue 控制开关（不要用 visible）', 'v-model / modelValue for open state (not visible)'],
                     ['header 或 title 设弹窗标题', 'header or title for the dialog title'],
-                    ['width 约 32rem 适配短表单（见 form-in-dialog 黄金样例）', 'width ~32rem for short forms (see form-in-dialog golden)'],
+                    ['width 约 32rem 适配短表单（见 form-in-dialog snippet）', 'width ~32rem for short forms (see form-in-dialog snippet)'],
                     ['表单字段用 fluid；主按钮 severity="primary"', 'Form fields use fluid; primary button severity="primary"'],
                 ], [
                     ['#footer 放取消/保存', '#footer for cancel / save'],
@@ -54,6 +54,7 @@ export const componentDecisions = [
                     ['@close 重置表单模型', '@close to reset the form model'],
                     ['保存可用按钮 @click，或 MForm @submit + type="submit"', 'Save via button @click, or MForm @submit + type="submit"'],
                 ]),
+                relatedSnippets: ['form-in-dialog', 'page-header-actions'],
                 ...anti([
                     ['用普通 Dialog 手写删除确认 → MConfirmDialog', 'Hand-rolled delete confirm in Dialog → MConfirmDialog'],
                     ['长多分组配置塞进 Dialog → Form 页或 Drawer', 'Long multi-section config in Dialog → Form page or Drawer'],
@@ -74,6 +75,7 @@ export const componentDecisions = [
                     ['#footer 取消/保存', '#footer cancel / save'],
                     ['默认插槽 MForm', 'Default slot: MForm'],
                 ], [['@close 清理草稿', '@close to clear draft state']]),
+                relatedSnippets: ['form-in-drawer'],
                 ...anti([
                     ['极短 2–3 字段也用 Drawer → Dialog', 'Tiny 2–3 field form in Drawer → Dialog'],
                     ['危险删除只用 Drawer 无确认 → MConfirmDialog', 'Destructive delete in Drawer without confirm → MConfirmDialog'],
@@ -97,6 +99,7 @@ export const componentDecisions = [
                     ['MForm @submit（或 @submit.prevent）', 'MForm @submit (or @submit.prevent)'],
                     ['提交按钮 type="submit" + severity="primary"', 'Submit button type="submit" + severity="primary"'],
                 ]),
+                relatedSnippets: ['page-content-form', 'form-header', 'form-body', 'form-actions'],
                 ...anti([
                     ['列表短 CRUD 开独立路由 → form-in-dialog', 'Short list CRUD as a route → form-in-dialog'],
                     ['表单外再套装饰性 MCard → 用 PageSection form', 'Extra decorative MCard around form → PageSection form'],
@@ -151,6 +154,7 @@ export const componentDecisions = [
                     ['modal 默认阻塞；任务型内容放默认插槽', 'modal blocks by default; task content in default slot'],
                     ['危险确认不要用 Dialog 冒充 → ConfirmDialog', 'Do not fake destructive confirm with Dialog → ConfirmDialog'],
                 ], [['#footer 主/次操作', '#footer primary / secondary actions']], [['@close / @update:modelValue', '@close / @update:modelValue']]),
+                relatedSnippets: ['form-in-dialog'],
                 ...anti([
                     ['Dialog + 手写「确定删除」→ MConfirmDialog', 'Dialog + hand-rolled Delete? → MConfirmDialog'],
                     ['v-model:visible → v-model / modelValue', 'v-model:visible → v-model / modelValue'],
@@ -171,6 +175,7 @@ export const componentDecisions = [
                     ['position="right"（常用）', 'position="right" (typical)'],
                     ['header 说明侧栏任务', 'header describes the side-panel job'],
                 ], [['#footer 操作区', '#footer actions']], [['@close', '@close']]),
+                relatedSnippets: ['form-in-drawer'],
                 ...anti([['简单 Yes/No 确认用 Drawer → ConfirmDialog / ConfirmPopup', 'Simple Yes/No in Drawer → ConfirmDialog / ConfirmPopup']]),
             },
             {
@@ -614,11 +619,27 @@ export const componentDecisions = [
                 avoidWhen: ['普通表单字段分组', 'KPI 指标展示'],
                 avoidWhenEn: ['Regular form field grouping', 'KPI metric display'],
                 recipe: recipe([
-                    ['内放 MInput / MSelect 等筛选控件', 'Place MInput / MSelect filters inside'],
-                    ['可 collapsible + #advanced', 'Optional collapsible + #advanced'],
-                    ['不要外包 MCard', 'Do not wrap in MCard'],
-                ], [['#advanced 高级筛选', '#advanced for advanced filters']]),
-                ...anti([['表单字段组用 PageFilters → PageSection form / Fieldset', 'Form field groups via PageFilters → PageSection form / Fieldset']]),
+                    ['内放 MInput / MSelect；同行用 MSpace wrap', 'Place MInput / MSelect inside; peers in MSpace wrap'],
+                    ['查询/重置放 #actions（与折叠切换同列）', 'Query/reset in #actions (trailing with toggle)'],
+                    ['默认 variant="filled"；dense craft 用 plain + size="small"', 'Default variant="filled"; dense craft: plain + size="small"'],
+                    ['有次要条件：collapsible + v-model:expanded + #advanced', 'Secondary fields: collapsible + v-model:expanded + #advanced'],
+                    ['toggle 默认「高级筛选/收起」+ chevron；已选用 FilterChips', 'Toggle defaults to Advanced/Collapse + chevron; active via FilterChips'],
+                ], [
+                    ['#actions 查询/重置', '#actions for query / reset'],
+                    ['#advanced 高级筛选', '#advanced for advanced filters'],
+                    ['#active 可选；更常见是下方 FilterChips', '#active optional; sibling FilterChips is more common'],
+                ]),
+                relatedSnippets: [
+                    'list-filters-stack',
+                    'list-filters',
+                    'list-filters-collapsible',
+                    'list-filter-chips',
+                    'list-filters-dense',
+                ],
+                ...anti([
+                    ['表单字段组用 PageFilters → PageSection form / Fieldset', 'Form field groups via PageFilters → PageSection form / Fieldset'],
+                    ['手写已选条 → list-filter-chips / list-filters-stack', 'Hand-rolled active bar → list-filter-chips / list-filters-stack'],
+                ]),
             },
             {
                 component: 'PageToolbar',
@@ -1096,6 +1117,7 @@ export const componentDecisions = [
                     ['icon 或 illustration 按需（默认即可）', 'icon or illustration as needed (default OK)'],
                     ['表格内放在 #empty', 'Inside tables: #empty slot'],
                 ], [['#extra 放下一步按钮（创建…）', '#extra for next-step button (Create…)']]),
+                relatedSnippets: ['empty-block'],
                 ...anti([
                     ['403/404 用 Empty → Result', '403/404 via Empty → Result'],
                     ['#action → #extra', '#action → #extra'],
@@ -1120,6 +1142,7 @@ export const componentDecisions = [
                     ['title + description', 'title + description'],
                     ['size 按页面比重', 'size for page weight'],
                 ], [['#footer 逃逸/下一步按钮', '#footer escape / next actions']]),
+                relatedSnippets: ['result-block'],
                 ...anti([
                     ['表格无数据用 Result → Empty', 'Table no-rows via Result → Empty'],
                     ['操作插槽写成 #extra → #footer', 'Actions slot #extra → #footer'],
@@ -1156,6 +1179,7 @@ export const componentDecisions = [
                     ['触发器放默认插槽（按钮/图标）', 'Trigger in default slot (button/icon)'],
                     ['危险项用文档 severity / 确认流', 'Danger items: docs severity / confirm flow'],
                 ]),
+                relatedSnippets: ['row-actions-menu', 'list-row-actions'],
                 ...anti([['表单枚举用 Dropdown → Select', 'Form enum via Dropdown → Select']]),
             },
             {
@@ -1245,6 +1269,7 @@ export const componentDecisions = [
                     ["message.success('已保存') / info / warn / error", "message.success('Saved') / info / warn / error"],
                     ['大多数操作反馈的默认选择', 'Default for most operation feedback'],
                 ]),
+                relatedSnippets: ['confirm-delete', 'form-in-dialog'],
                 ...anti([
                     ["toast.add({ summary: '已保存' }) → message.success('已保存')", "toast.add({ summary: 'Saved' }) → message.success('Saved')"],
                     ['<MMessage severity> 当内嵌 Alert → errorMessage / role="alert"', '<MMessage severity> as inline Alert → errorMessage / role="alert"'],
@@ -1277,6 +1302,7 @@ export const componentDecisions = [
                     ['表单级：token 样式的 role="alert" 条（见 login-page）', 'Form-level: token-styled role="alert" bar (see login-page)'],
                     ['<MMessage> 只是 message 宿主，不是内嵌 Alert', '<MMessage> is the message host, not an inline Alert'],
                 ]),
+                relatedSnippets: ['auth-split-shell'],
                 ...anti([
                     ['登录失败只闪 Toast → 表单区 alert / errorMessage', 'Login failure only via Toast → form alert / errorMessage'],
                     ['编造 MMessage severity 插槽 Alert API', 'Invented MMessage severity slot Alert API'],
@@ -1321,6 +1347,7 @@ export const componentDecisions = [
                     ['@accept 执行删除', '@accept to perform delete'],
                     ['@reject 关闭', '@reject to dismiss'],
                 ]),
+                relatedSnippets: ['confirm-delete'],
                 ...anti([
                     ['普通 Dialog 手写「确定/取消」删除 → ConfirmDialog', 'Hand-rolled Dialog Yes/No delete → ConfirmDialog'],
                     ['编辑表单误用 ConfirmDialog → Dialog + Form', 'Edit form via ConfirmDialog → Dialog + Form'],
@@ -1344,6 +1371,7 @@ export const componentDecisions = [
                     ['target 锚定触发元素（或 position）', 'target anchors the trigger (or position)'],
                     ['placement top|bottom|left|right', 'placement top|bottom|left|right'],
                 ], undefined, [['@accept / @reject', '@accept / @reject']]),
+                relatedSnippets: ['confirm-delete'],
                 ...anti([['无 target 的全局危险确认 → ConfirmDialog', 'Global dangerous confirm without target → ConfirmDialog']]),
             },
         ],

package/dist/golden-pages.d.ts

@@ -1,10 +1,15 @@
+/**
+ * Golden pages = optional whole-page assembly demos / block-order baselines.
+ * Default agent path is composition-first (page snippets + decision recipes).
+ * FROZEN: do not add new craft variants (e.g. more list-page-*). Express density/sider via style direction + Ops polish.
+ */
 export interface GoldenPageRecord {
     id: string;
     file: string;
     title: string;
     titleEn: string;
     patternId: string;
-    /** Visual style preset this sample demonstrates (structure may be shared). */
+    /** Optional craft cue this sample demonstrates (structure may be shared). Not a style-preset catalog. */
     style?: string;
     /** Canonical structure id when this is a craft variant. */
     variantOf?: string;

package/dist/golden-pages.js

@@ -1,20 +1,21 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { resolveListCraftVariant } from './style-presets.js';
 export const goldenPageCatalog = [
     {
         id: 'list-page',
         file: 'list-page.vue',
-        title: '列表页黄金样例（soft）',
-        titleEn: 'List page golden sample (soft)',
+        title: '列表页结构样例（soft）',
+        titleEn: 'List page structure sample (soft)',
         patternId: 'admin-list',
         style: 'soft',
     },
     {
         id: 'list-page-dense',
         file: 'list-page-dense.vue',
-        title: '列表页黄金样例（dense）',
-        titleEn: 'List page golden sample (dense)',
+        title: '列表页结构样例（dense）',
+        titleEn: 'List page structure sample (dense)',
         patternId: 'admin-list',
         style: 'dense',
         variantOf: 'list-page',
@@ -22,8 +23,8 @@ export const goldenPageCatalog = [
     {
         id: 'list-page-rail',
         file: 'list-page-rail.vue',
-        title: '列表页黄金样例（rail）',
-        titleEn: 'List page golden sample (rail)',
+        title: '列表页结构样例（rail）',
+        titleEn: 'List page structure sample (rail)',
         patternId: 'admin-list',
         style: 'rail',
         variantOf: 'list-page',
@@ -31,81 +32,78 @@ export const goldenPageCatalog = [
     {
         id: 'form-page',
         file: 'form-page.vue',
-        title: '表单页黄金样例',
-        titleEn: 'Form page golden sample',
+        title: '表单页结构样例',
+        titleEn: 'Form page structure sample',
         patternId: 'form-page',
     },
     {
         id: 'dashboard-page',
         file: 'dashboard-page.vue',
-        title: '仪表盘黄金样例',
-        titleEn: 'Dashboard golden sample',
+        title: '仪表盘结构样例',
+        titleEn: 'Dashboard structure sample',
         patternId: 'dashboard',
     },
     {
         id: 'login-page',
         file: 'login-page.vue',
-        title: '登录页黄金样例',
-        titleEn: 'Login page golden sample',
+        title: '登录页结构样例',
+        titleEn: 'Login page structure sample',
         patternId: 'auth-page',
     },
     {
         id: 'landing-page',
         file: 'landing-page.vue',
-        title: '营销落地页黄金样例',
-        titleEn: 'Marketing landing golden sample',
+        title: '营销落地页结构样例',
+        titleEn: 'Marketing landing structure sample',
         patternId: 'marketing-landing',
     },
     {
         id: 'empty-state',
         file: 'empty-state.vue',
-        title: '空状态黄金样例',
-        titleEn: 'Empty state golden sample',
+        title: '空状态结构样例',
+        titleEn: 'Empty state structure sample',
         patternId: 'empty-state',
     },
     {
         id: 'detail-page',
         file: 'detail-page.vue',
-        title: '详情页黄金样例',
-        titleEn: 'Detail page golden sample',
+        title: '详情页结构样例',
+        titleEn: 'Detail page structure sample',
         patternId: 'detail-page',
     },
     {
         id: 'form-in-dialog',
         file: 'form-in-dialog.vue',
-        title: '列表内弹窗表单黄金样例',
-        titleEn: 'List create/edit dialog golden sample',
+        title: '列表内弹窗表单结构样例',
+        titleEn: 'List create/edit dialog structure sample',
         patternId: 'form-in-dialog',
     },
     {
         id: 'result-page',
         file: 'result-page.vue',
-        title: '结果 / 阻断页黄金样例',
-        titleEn: 'Result / terminal page golden sample',
+        title: '结果 / 阻断页结构样例',
+        titleEn: 'Result / terminal page structure sample',
         patternId: 'result-page',
     },
     {
         id: 'settings-page',
         file: 'settings-page.vue',
-        title: '设置页黄金样例',
-        titleEn: 'Settings page golden sample',
+        title: '设置页结构样例',
+        titleEn: 'Settings page structure sample',
         patternId: 'settings-page',
     },
     {
         id: 'wizard-form',
         file: 'wizard-form.vue',
-        title: '分步向导黄金样例',
-        titleEn: 'Wizard form golden sample',
+        title: '分步向导结构样例',
+        titleEn: 'Wizard form structure sample',
         patternId: 'wizard-form',
     },
 ];
-/** Map style preset → list golden craft variant (same structure). */
-const listStyleGolden = {
-    soft: 'list-page',
-    quiet: 'list-page',
-    studio: 'list-page',
-    ink: 'list-page',
+/** Optional legacy exact keys for list craft (density / sider) — not a style catalog. */
+const listCraftGolden = {
     dense: 'list-page-dense',
+    compact: 'list-page-dense',
     rail: 'list-page-rail',
 };
 const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
@@ -137,7 +135,10 @@ export function resolveGoldenPageId(args) {
             : null) ||
         null;
     if (args.patternId === 'admin-list' || canonical === 'list-page' || canonical?.startsWith('list-page')) {
-        const styled = style ? listStyleGolden[style] : null;
+        const key = style.replace(/[-_\s]/g, '');
+        const exact = style ? listCraftGolden[style] || listCraftGolden[key] : null;
+        const fromText = resolveListCraftVariant(args.styleId);
+        const styled = exact || fromText;
         if (styled && findGoldenPage(styled))
             return styled;
         return 'list-page';

package/dist/index.js

@@ -86,20 +86,20 @@ 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 for a visual preset (quiet/soft/dense/rail/studio/ink). Pass includeScaffold: true for starter Vue code.', {
+register('recommend_page', 'Recommend a page pattern and component composition from product intent. Pass style as free-text user description when they specified a look (no preset catalog). Pass includeScaffold: true for starter Vue code.', {
     intent: z.string().min(1),
     pageType: z.string().optional(),
     features: z.array(z.string()).max(20).optional(),
-    style: z.string().optional().describe('Optional visual style preset id or alias, e.g. soft / dense / 柔和留白.'),
+    style: z.string().optional().describe('Optional free-text style description from the user (not a preset id).'),
     mode: z.string().optional(),
     includeScaffold: z.boolean().optional(),
 }, async (args) => handlers.recommendPage(args));
-register('get_design_rules', 'Return design-token, style presets, semantic-action, accessibility, and composition rules for generated pages.', { mode: z.string().optional() }, async (args) => handlers.getDesignRules(args));
-register('list_style_presets', 'List selectable page visual styles (quiet/soft/dense/rail/studio/ink) and resolution priority (reference → preset → prompt → ask).', { mode: z.string().optional() }, async (args) => handlers.listStylePresets(args));
-register('get_style_preset', 'Read apply/avoid cues for one visual style preset (quiet, soft, dense, rail, studio, ink, or Chinese aliases).', {
-    style: z.string().min(1).describe('Style preset id or alias.'),
+register('get_design_rules', 'Return design-token, style-direction rules, semantic-action, accessibility, and composition rules for generated pages.', { mode: z.string().optional() }, async (args) => handlers.getDesignRules(args));
+register('get_style_direction', 'Resolve visual style direction: follow user reference/description, infer from clear cues, or ask when uncertain. No named preset catalog.', {
+    intent: z.string().optional(),
+    style: z.string().optional().describe('Free-text style description from the user.'),
     mode: z.string().optional(),
-}, async (args) => handlers.getStylePreset(args));
+}, async (args) => handlers.getStyleDirection(args));
 register('recommend_component', 'List, read, or recommend component selection guides. Omit query/decision to list; pass decision only to read; pass query to recommend.', {
     query: z.string().optional(),
     decision: z.string().optional(),
@@ -108,7 +108,7 @@ register('recommend_component', 'List, read, or recommend component selection gu
     offset: z.number().int().min(0).optional(),
 }, async (args) => handlers.recommendComponent(args));
 register('list_golden_pages', 'List golden page samples for list, form, and dashboard layouts.', { mode: z.string().optional() }, async (args) => handlers.listGoldenPageCatalog(args));
-register('get_golden_page', 'Read a golden page Vue source sample (list-page, list-page-dense, list-page-rail, form-page, dashboard-page, login-page, landing-page, empty-state, detail-page, form-in-dialog, result-page, settings-page, wizard-form). List craft variants: dense/rail when style is dense/rail; soft structure is list-page.', {
+register('get_golden_page', 'Read a golden page Vue source sample (list-page, list-page-dense, list-page-rail, form-page, dashboard-page, login-page, landing-page, empty-state, detail-page, form-in-dialog, result-page, settings-page, wizard-form). List craft variants: dense/compact cues → dense; rail/brand-sider cues → rail; otherwise list-page.', {
     page: z.string().min(1),
     mode: z.string().optional(),
 }, async (args) => handlers.getGoldenPage(args));