@morya-ui/mcp 0.2.2 → 0.2.4

package/dist/decisions.js

@@ -137,6 +137,197 @@ export const componentDecisions = [
             },
         ],
     },
+    {
+        id: 'layout-spacing-choice',
+        title: '如何选择页面间距组件',
+        titleEn: 'Choosing page spacing/layout components',
+        question: '控件组、页面区块、栅格之间需要哪种间距与对齐方式？',
+        questionEn: 'What kind of spacing and alignment is needed between controls, page sections, or grid areas?',
+        keywords: ['间距', '布局', 'gap', 'flex', 'space', 'page', 'toolbar', 'filters', 'spacing', 'layout', 'stack'],
+        options: [
+            {
+                component: 'PageContent',
+                when: ['页面主内容区需要统一的 padding 和垂直 gap', '列表/表单/仪表盘区块纵向堆叠'],
+                whenEn: ['The main content area needs consistent padding and vertical gap', 'List, form, or dashboard sections stack vertically'],
+                avoidWhen: ['只是两个按钮之间的水平间距'],
+                avoidWhenEn: ['Only horizontal spacing between two buttons is needed'],
+            },
+            {
+                component: 'Flex',
+                when: ['同一行控件需要 gap 和对齐', '工具栏内操作组、筛选控件组'],
+                whenEn: ['Controls on one row need gap and alignment', 'Toolbar action groups or filter control rows'],
+                avoidWhen: ['整个页面区块的 padding 和垂直 rhythm'],
+                avoidWhenEn: ['Padding and vertical rhythm for whole page sections'],
+            },
+            {
+                component: 'Space',
+                when: ['简单 wrap 控件组且不需要 justify 语义', '表格行内操作按钮组'],
+                whenEn: ['A simple wrapped control group without justify semantics', 'Inline row action button groups'],
+                avoidWhen: ['页面级标题与主操作两端对齐'],
+                avoidWhenEn: ['Page-level title and primary action need space-between alignment'],
+            },
+            {
+                component: 'Grid',
+                when: ['KPI 卡片、仪表盘双栏、响应式列布局'],
+                whenEn: ['KPI cards, dashboard two-column layouts, responsive columns'],
+                avoidWhen: ['单个筛选行或表单字段列'],
+                avoidWhenEn: ['A single filter row or form field column'],
+            },
+        ],
+    },
+    {
+        id: 'page-section-choice',
+        title: '如何选择页面区块组件',
+        titleEn: 'Choosing page section components',
+        question: '这是筛选区、标题区、表单表面、KPI 还是图表占位？',
+        questionEn: 'Is this a filter bar, page header, form surface, KPI metric, or chart placeholder?',
+        keywords: ['筛选', '工具栏', '标题', '表单', 'kpi', '占位', 'page filters', 'toolbar', 'header', 'stat', 'placeholder'],
+        options: [
+            {
+                component: 'PageFilters',
+                when: ['列表页或搜索页的筛选/查询区域', '需要统一浅色背景与边框'],
+                whenEn: ['Filter or search region on list pages', 'A consistent muted background and border is needed'],
+                avoidWhen: ['普通表单字段分组', 'KPI 指标展示'],
+                avoidWhenEn: ['Regular form field grouping', 'KPI metric display'],
+            },
+            {
+                component: 'PageToolbar',
+                when: ['页面标题 + 右侧主操作', '列表页新建按钮区域'],
+                whenEn: ['Page title plus primary actions on the right', 'Create button area on list pages'],
+                avoidWhen: ['带长描述的表单引导区'],
+                avoidWhenEn: ['Form intro areas with long descriptions'],
+            },
+            {
+                component: 'PageHeader',
+                when: ['页面标题 + 描述文案', '表单页/详情页引导'],
+                whenEn: ['Page title plus descriptive copy', 'Form or detail page intros'],
+                avoidWhen: ['只有标题和单个主按钮的列表工具栏'],
+                avoidWhenEn: ['List toolbars with only a title and one primary button'],
+            },
+            {
+                component: 'PageSection',
+                when: ['表单主体表面 (variant="form")', '底栏操作区 (variant="actions")'],
+                whenEn: ['Form body surface (variant="form")', 'Footer actions (variant="actions")'],
+                avoidWhen: ['列表页筛选区', 'KPI 卡片'],
+                avoidWhenEn: ['List page filter areas', 'KPI cards'],
+            },
+            {
+                component: 'PageStat',
+                when: ['仪表盘 KPI 单指标卡', '需要 label/value/trend/icon 结构'],
+                whenEn: ['Dashboard KPI cards', 'Needs label/value/trend/icon structure'],
+                avoidWhen: ['普通内容分组', '表格或表单'],
+                avoidWhenEn: ['Generic content grouping', 'Tables or forms'],
+            },
+            {
+                component: 'PagePlaceholder',
+                when: ['图表、地图或媒体区域尚未接入', '需要 dashed 占位表面'],
+                whenEn: ['Charts, maps, or media areas are not wired yet', 'A dashed placeholder surface is needed'],
+                avoidWhen: ['真实数据表格或表单'],
+                avoidWhenEn: ['Real data tables or forms'],
+            },
+        ],
+    },
+    {
+        id: 'page-scroll-choice',
+        title: '页面滚动如何选择',
+        titleEn: 'Choosing page scroll strategy',
+        question: '这是整页滚动、组件内置滚动，还是业务手写的局部滚动区？',
+        questionEn: 'Is this whole-page scroll, built-in component scroll, or a hand-written local scroll region?',
+        keywords: [
+            'scroll',
+            'scrollbar',
+            '滚动',
+            '滚动条',
+            'overflow',
+            '页面滚动',
+            'layout scroll',
+            'panel scroll',
+        ],
+        options: [
+            {
+                component: 'MLayout fillViewport',
+                when: [
+                    '整页后台列表/表单/仪表盘',
+                    '需要 Header + Content + 可选 Sider 的应用骨架',
+                    '页面主滚动应随 Layout 主题化',
+                ],
+                whenEn: [
+                    'Full admin list/form/dashboard pages',
+                    'App shell with header, content, and optional sider',
+                    'Main page scroll should follow the layout theme',
+                ],
+                avoidWhen: ['单个卡片内部的小块内容', '需要业务自行控制滚动的 Dialog/Drawer 内容'],
+                avoidWhenEn: ['Small regions inside a single card', 'Dialog/Drawer bodies where apps control scrolling'],
+            },
+            {
+                component: 'MScrollbar',
+                when: [
+                    '业务自行限高的卡片正文、侧栏、日志列表，且希望主题化滚动条',
+                    'Dialog / Drawer 等内容区需要主题滚动时由业务显式包一层',
+                    '组件未内置滚动、又需要统一滚动外观时',
+                ],
+                whenEn: [
+                    'App-owned capped regions (card bodies, side panels, logs) that want themed scrollbars',
+                    'Dialog / Drawer content where the app opts into themed scrolling',
+                    'No built-in component scroll, but a consistent scrollbar look is desired',
+                ],
+                avoidWhen: [
+                    'Dialog / Drawer / Popover / Splitter 等用户内容插槽被组件库强行包滚动',
+                    'Textarea 等原生控件自身的滚动',
+                    'MTable / MLayoutContent / Select 弹出层等已内置滚动的区域',
+                ],
+                avoidWhenEn: [
+                    'Library-forced scroll around user content slots such as Dialog, Drawer, Popover, or Splitter',
+                    'Native control scrolling such as Textarea',
+                    'Areas that already scroll internally (MTable, MLayoutContent, Select popups)',
+                ],
+            },
+            {
+                component: 'Built-in (no extra wrapper)',
+                when: [
+                    'MLayout、MTable、MVirtualScroller、菜单/下拉面板等已内置 MScrollbar',
+                    '浮层菜单与子菜单（Dropdown/ContextMenu/TieredMenu/Menu flyout）',
+                ],
+                whenEn: [
+                    'MLayout, MTable, MVirtualScroller, and menu/select panels already scroll internally',
+                    'Overlay menus and nested flyouts (Dropdown/ContextMenu/TieredMenu/Menu flyout)',
+                ],
+                avoidWhen: ['在已内置滚动的组件外再包一层滚动容器'],
+                avoidWhenEn: ['Wrapping another scroll container around built-in scroll chrome'],
+            },
+        ],
+    },
+    {
+        id: 'surface-nesting-choice',
+        title: '如何避免双边框与多余容器',
+        titleEn: 'Avoiding double borders and redundant wrappers',
+        question: '内容是否已经被 Page 组件或 Table 提供了边界？',
+        questionEn: 'Does Page or Table already provide the boundary for this content?',
+        keywords: ['边框', '双边框', 'card', 'nested', 'border', 'wrapper', 'table', 'filters'],
+        options: [
+            {
+                component: 'PageContent + MTable',
+                when: ['列表页数据表格', 'MPageFilters 已提供筛选区边界'],
+                whenEn: ['List page data tables', 'MPageFilters already provides the filter boundary'],
+                avoidWhen: ['需要独立卡片标题的内容模块'],
+                avoidWhenEn: ['Content modules that need an independent card title'],
+            },
+            {
+                component: 'MCard',
+                when: ['仪表盘中的图表区/明细区', '需要 card 标题的内容模块'],
+                whenEn: ['Chart or detail areas on dashboards', 'Content modules that need a card title'],
+                avoidWhen: ['列表页表格外层', '筛选区外层'],
+                avoidWhenEn: ['Wrapping list page tables', 'Wrapping filter regions'],
+            },
+            {
+                component: 'PageSection',
+                when: ['表单页主体或 actions 底栏', '需要统一 form surface'],
+                whenEn: ['Form page bodies or action footers', 'A unified form surface is needed'],
+                avoidWhen: ['再套 MCard variant form 导致双边框'],
+                avoidWhenEn: ['Wrapping again with MCard and causing double borders'],
+            },
+        ],
+    },
 ];
 export function findDecision(name) {
     const key = name.trim().toLowerCase().replace(/[-_\s]/g, '');

package/dist/golden-pages.d.ts

@@ -0,0 +1,16 @@
+export interface GoldenPageRecord {
+    id: string;
+    file: string;
+    title: string;
+    titleEn: string;
+    patternId: string;
+}
+export declare const goldenPageCatalog: GoldenPageRecord[];
+export declare function listGoldenPages(): GoldenPageRecord[];
+export declare function findGoldenPage(id: string): GoldenPageRecord | undefined;
+export declare function readGoldenPageSource(id: string): {
+    record: GoldenPageRecord;
+    source: string;
+} | null;
+export declare function goldenPagesAvailable(): boolean;
+export declare function listGoldenPageFilesOnDisk(): string[];

package/dist/golden-pages.js

@@ -0,0 +1,67 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const goldenPageCatalog = [
+    {
+        id: 'list-page',
+        file: 'list-page.vue',
+        title: '列表页黄金样例',
+        titleEn: 'List page golden sample',
+        patternId: 'admin-list',
+    },
+    {
+        id: 'form-page',
+        file: 'form-page.vue',
+        title: '表单页黄金样例',
+        titleEn: 'Form page golden sample',
+        patternId: 'form-page',
+    },
+    {
+        id: 'dashboard-page',
+        file: 'dashboard-page.vue',
+        title: '仪表盘黄金样例',
+        titleEn: 'Dashboard golden sample',
+        patternId: 'dashboard',
+    },
+];
+const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const bundledDir = join(pkgRoot, 'data/golden-pages');
+const repoDir = join(pkgRoot, '../../ai-design-config/docs/golden-pages');
+function resolveGoldenPagesDir() {
+    if (existsSync(bundledDir))
+        return bundledDir;
+    if (existsSync(repoDir))
+        return repoDir;
+    return null;
+}
+export function listGoldenPages() {
+    return goldenPageCatalog;
+}
+export function findGoldenPage(id) {
+    const key = id.trim().toLowerCase().replace(/\.vue$/i, '').replace(/[-_\s]/g, '');
+    return goldenPageCatalog.find((item) => item.id.replace(/[-_\s]/g, '') === key);
+}
+export function readGoldenPageSource(id) {
+    const record = findGoldenPage(id);
+    if (!record)
+        return null;
+    const dir = resolveGoldenPagesDir();
+    if (!dir)
+        return null;
+    const path = join(dir, record.file);
+    if (!existsSync(path))
+        return null;
+    return { record, source: readFileSync(path, 'utf8').replace(/^\uFEFF/, '') };
+}
+export function goldenPagesAvailable() {
+    const dir = resolveGoldenPagesDir();
+    if (!dir)
+        return false;
+    return goldenPageCatalog.every((item) => existsSync(join(dir, item.file)));
+}
+export function listGoldenPageFilesOnDisk() {
+    const dir = resolveGoldenPagesDir();
+    if (!dir)
+        return [];
+    return readdirSync(dir).filter((name) => name.endsWith('.vue'));
+}

package/dist/index.js

@@ -33,7 +33,7 @@ register('list', 'List morya-ui components, guides, examples, categories, or pag
 }, async (args) => handlers.list(args));
 register('search', 'Search components, guides, API text, examples, page patterns, and component decision guides.', {
     query: z.string().min(1),
-    scope: z.enum(['all', 'components', 'guides', 'api', 'examples', 'patterns', 'decisions']).optional(),
+    scope: z.enum(['all', 'components', 'guides', 'api', 'examples', 'patterns', 'decisions', 'snippets']).optional(),
     mode: z.string().optional(),
     limit: z.number().int().min(1).max(50).optional(),
     offset: z.number().int().min(0).optional(),
@@ -101,6 +101,27 @@ register('recommend_component', 'List, read, or recommend component selection gu
     limit: z.number().int().min(1).max(200).optional(),
     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, form-page, dashboard-page).', {
+    page: z.string().min(1),
+    mode: z.string().optional(),
+}, async (args) => handlers.getGoldenPage(args));
+register('validate_page', 'Validate a generated page for composition, spacing, and border anti-patterns.', {
+    code: z.string().min(1),
+    mode: z.string().optional(),
+}, async (args) => handlers.validatePage(args));
+register('list_page_snippets', 'List reusable page section snippets for local edits (filters, toolbar, form actions, KPI grid, etc.).', {
+    query: z.string().optional(),
+    pageType: z.string().optional(),
+    mode: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    offset: z.number().int().min(0).optional(),
+}, async (args) => handlers.listPageSnippets(args));
+register('get_page_snippet', 'Read a standard page section snippet by id or keyword (e.g. filters, toolbar, form-actions). Pass includeScript: true for import + template bundle.', {
+    section: z.string().min(1),
+    mode: z.string().optional(),
+    includeScript: z.boolean().optional(),
+}, async (args) => handlers.getPageSnippet(args));
 register('version', 'Return MCP package, library version, and catalog status.', {}, async () => handlers.version());
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/page-snippets.d.ts

@@ -0,0 +1,33 @@
+export type PageSnippetPageType = 'list' | 'form' | 'dashboard' | 'detail' | 'common';
+export interface PageSnippet {
+    id: string;
+    title: string;
+    titleEn: string;
+    description: string;
+    descriptionEn: string;
+    pageTypes: PageSnippetPageType[];
+    keywords: string[];
+    imports: string[];
+    scriptSetup?: string;
+    template: string;
+    rules: string[];
+    rulesEn: string[];
+    avoid: string[];
+    avoidEn: string[];
+}
+export declare const pageSnippets: PageSnippet[];
+export declare function findPageSnippet(id: string): PageSnippet | undefined;
+export declare function scorePageSnippet(snippet: PageSnippet, query: string): number;
+export declare function filterPageSnippets(args: {
+    query?: string;
+    pageType?: string;
+    limit?: number;
+    offset?: number;
+}): {
+    total: number;
+    items: PageSnippet[];
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+    nextOffset: number | undefined;
+};