@morya-ui/mcp 0.2.2 → 0.2.4

package/dist/patterns.js

@@ -32,7 +32,10 @@ export const pagePatterns = [
             { component: 'LayoutHeader', role: '顶栏面包屑' },
             { component: 'LayoutContent', role: '页面主体内容区' },
             { component: 'Breadcrumb', role: '页面层级导航' },
-            { component: 'Space', role: '筛选区与行操作间距布局' },
+            { component: 'PageContent', role: '内容区垂直堆叠与间距', reason: '替代手写 gap/padding CSS' },
+            { component: 'PageFilters', role: '筛选区表面与边框' },
+            { component: 'PageToolbar', role: '标题与主操作两端对齐' },
+            { component: 'Space', role: '筛选控件与行操作间距' },
             { component: 'Input', role: '关键词筛选' },
             { component: 'Select', role: '枚举或状态筛选' },
             { component: 'Button', role: '查询、新增和行操作' },
@@ -47,15 +50,16 @@ export const pagePatterns = [
             '    └── MLayout',
             '        ├── MLayoutHeader → MBreadcrumb',
             '        └── MLayoutContent',
-            '            ├── Filter section (MSpace + MInput + MSelect + MButton)',
-            '            ├── PageHeader (title + primary action)',
-            '            └── MTable (paginator, #cell-* slots, #empty)',
+            '            └── MPageContent',
+            '                ├── MPageFilters (MSpace + MInput + MSelect + MButton)',
+            '                ├── MPageToolbar (title + primary action)',
+            '                └── MTable (paginator, #cell-* slots, #empty)',
         ],
         layout: {
-            page: 'MLayout has-sider 作为后台骨架；内容区 padding 使用 --m-space-6',
-            header: 'MLayoutHeader 放面包屑；标题与主操作在内容区 toolbar 两端对齐',
-            filters: '筛选区使用浅色背景 + border-radius；桌面端 MSpace wrap，窄屏堆叠',
-            data: 'MTable 启用 paginator；行操作用 MButton size="small"；空态用 #empty 插槽',
+            page: 'MLayout fillViewport + has-sider；MLayoutContent 内用 MPageContent 堆叠区块',
+            header: 'MLayoutHeader 放面包屑；标题与主操作用 MPageToolbar',
+            filters: 'MPageFilters 包裹筛选控件；内部 MSpace wrap 或 MFlex',
+            data: 'MTable 直接放在 MPageContent 内，不要额外 MCard；paginator + #empty',
         },
         styleRules: [
             '新增、保存等主操作使用 primary MButton',
@@ -90,7 +94,10 @@ export const pagePatterns = [
             { component: 'ConfigProvider', role: '应用根包裹' },
             { component: 'Layout', role: '页面骨架' },
             { component: 'LayoutHeader', role: '顶栏面包屑' },
-            { component: 'LayoutContent', role: '表单主体区', reason: 'max-width 约 42rem' },
+            { component: 'LayoutContent', role: '页面主体滚动区' },
+            { component: 'PageContent', role: '表单页窄宽与垂直间距', reason: 'width="narrow"' },
+            { component: 'PageHeader', role: '页面标题与说明' },
+            { component: 'PageSection', role: '表单表面与底栏', reason: 'variant form / actions' },
             { component: 'Breadcrumb', role: '页面层级导航' },
             { component: 'Form', role: '声明式校验和布局' },
             { component: 'FormItem', role: '字段标签、帮助文本和校验状态', required: false, reason: '由 MForm 同目录导出，作为表单子结构使用' },
@@ -104,16 +111,16 @@ export const pagePatterns = [
             '└── MLayout',
             '    ├── MLayoutHeader → MBreadcrumb',
             '    └── MLayoutContent',
-            '        ├── Page intro (title + description)',
-            '        └── MForm',
-            '            ├── MFormItem fields',
-            '            └── Actions (submit + cancel)',
+            '        └── MPageContent (width="narrow")',
+            '            ├── MPageHeader',
+            '            └── MPageSection (variant="form")',
+            '                └── MForm + MPageSection (variant="actions")',
         ],
         layout: {
-            shell: 'MLayout + MLayoutHeader + MLayoutContent；表单 max-width 约 42rem',
-            page: '表单主体使用 max-width，避免字段横向过宽',
-            form: '默认 label-position=top；字段按业务逻辑分组',
-            actions: '提交按钮在前，取消使用 text 或 secondary，操作区与表单分隔',
+            shell: 'MLayout fillViewport + MLayoutHeader + MLayoutContent',
+            page: 'MPageContent width="narrow" 限制表单宽度',
+            form: 'MPageSection variant="form" 包裹 MForm；label-position=top',
+            actions: 'MPageSection variant="actions" 放提交/取消；不要手写 border-top CSS',
             responsive: '多列字段在窄屏降为单列',
         },
         styleRules: [
@@ -148,9 +155,13 @@ export const pagePatterns = [
             { component: 'LayoutHeader', role: '顶栏与面包屑' },
             { component: 'LayoutContent', role: '仪表盘内容' },
             { component: 'Breadcrumb', role: '页面层级导航' },
+            { component: 'PageContent', role: '仪表盘垂直间距', reason: 'density="spacious"' },
+            { component: 'PageHeader', role: '页面标题' },
+            { component: 'PageStat', role: 'KPI 指标卡' },
+            { component: 'PagePlaceholder', role: '图表占位' },
             { component: 'Grid', role: 'KPI 与内容区栅格' },
             { component: 'GridItem', role: '栅格子项' },
-            { component: 'Card', role: '指标和内容分区' },
+            { component: 'Card', role: '图表与列表明细分区' },
             { component: 'Icon', role: 'KPI 图标', required: false },
             { component: 'Tag', role: '状态和告警级别' },
             { component: 'Table', role: '明细数据', required: false },
@@ -313,7 +324,127 @@ export const pagePatterns = [
         ],
     },
 ];
+/** Advisory page-writing standards for MCP and human authors — not enforced blockers. */
+export const pageStandards = [
+    {
+        id: 'layout-shell',
+        title: '页面骨架',
+        titleEn: 'Page shell',
+        recommend: [
+            '后台页根布局使用 MLayout fillViewport',
+            'MLayoutContent 内使用 MPageContent 统一 padding 与区块间距',
+            '写整页前先 get_golden_page 复制对应类型结构',
+        ],
+        recommendEn: [
+            'Use MLayout fillViewport as the admin page root',
+            'Place MPageContent inside MLayoutContent for consistent padding and section gap',
+            'Call get_golden_page before writing a full page and copy the matching structure',
+        ],
+        discouraged: ['手写 min-height:100vh', '在 MLayoutContent 上写 padding/gap'],
+        discouragedEn: ['Hand-written min-height:100vh', 'Padding/gap on MLayoutContent instead of MPageContent'],
+        mcp: { snippet: 'layout-app-shell' },
+    },
+    {
+        id: 'page-sections',
+        title: '页面区块组件',
+        titleEn: 'Page section components',
+        recommend: [
+            '筛选区用 MPageFilters，标题+操作用 MPageToolbar，表单区用 MPageSection',
+            '列表页 MTable 直接放在 MPageContent 内',
+            '局部区块优先 get_page_snippet（filters / toolbar / form-actions 等）',
+        ],
+        recommendEn: [
+            'Use MPageFilters, MPageToolbar, and MPageSection for filters, headers/actions, and forms',
+            'Place MTable directly in MPageContent on list pages',
+            'Prefer get_page_snippet for local blocks such as filters, toolbar, or form-actions',
+        ],
+        discouraged: ['手写 .page-filters / .page-toolbar 类', '用 MCard 包裹 MPageFilters 或 bordered MTable'],
+        discouragedEn: [
+            'Hand-written .page-filters / .page-toolbar classes',
+            'Wrapping MPageFilters or bordered MTable with MCard',
+        ],
+        mcp: { decision: 'surface-nesting-choice' },
+    },
+    {
+        id: 'scroll',
+        title: '滚动',
+        titleEn: 'Scroll',
+        recommend: [
+            '组件内置滚动区（Layout 壳、菜单/下拉面板、Table 视口等）使用内置 MScrollbar',
+            'Dialog / Drawer / Popover / Splitter 等内容区不强制主题滚动；需要时由业务自行包 MScrollbar',
+            '已内置滚动的组件通常无需再外包一层',
+        ],
+        recommendEn: [
+            'Component-owned scroll chrome (Layout shell, menu/select panels, Table viewport) uses built-in MScrollbar',
+            'Do not force themed scroll into Dialog / Drawer / Popover / Splitter content; apps can wrap MScrollbar when needed',
+            'Components that already scroll internally usually need no extra wrapper',
+        ],
+        discouraged: [
+            '在 Dialog / Drawer / Popover / Splitter / Textarea 等用户内容区强行内置 MScrollbar',
+            '业务代码定制 ::-webkit-scrollbar 替代组件内置滚动',
+            '重复包裹已内置滚动的组件',
+        ],
+        discouragedEn: [
+            'Forcing MScrollbar into user content areas such as Dialog, Drawer, Popover, Splitter, or Textarea',
+            '::-webkit-scrollbar styling instead of component-owned scroll chrome',
+            'Extra scroll wrappers around components that already scroll',
+        ],
+        mcp: { snippet: 'scrollable-panel', decision: 'page-scroll-choice' },
+    },
+    {
+        id: 'tokens',
+        title: '设计令牌',
+        titleEn: 'Design tokens',
+        recommend: ['颜色、间距、圆角、字号优先 --m-* Token', '控件宽度等局部尺寸可用 inline style'],
+        recommendEn: [
+            'Prefer --m-* tokens for color, spacing, radius, and typography',
+            'Inline styles are fine for local control widths',
+        ],
+        discouraged: ['页面级 hex / 裸 rgb() 色值', '维护第二套色板变量'],
+        discouragedEn: ['Page-level hex or raw rgb() colors', 'Maintaining a second color palette'],
+    },
+    {
+        id: 'feedback',
+        title: '操作反馈',
+        titleEn: 'Action feedback',
+        recommend: [
+            '单行结果（已保存/已删除）默认 message.success / error',
+            '需要标题+补充说明时用 toast',
+            '危险操作配合 MConfirmDialog',
+        ],
+        recommendEn: [
+            'Default single-line results to message.success / error',
+            'Use toast when a summary plus detail is needed',
+            'Pair destructive actions with MConfirmDialog',
+        ],
+        discouraged: ['只有一行文案却用 toast', '删除等危险操作无确认'],
+        discouragedEn: ['Toast for single-line-only feedback', 'Destructive actions without confirmation'],
+        mcp: { decision: 'overlay-choice' },
+    },
+    {
+        id: 'accessibility',
+        title: '无障碍',
+        titleEn: 'Accessibility',
+        recommend: [
+            '图标按钮提供 aria-label 或 ariaLabel',
+            '表单控件有可见 label 或等价可访问名称',
+            '筛选区、表格等语义区域可加 aria-label',
+        ],
+        recommendEn: [
+            'Provide aria-label or ariaLabel on icon-only buttons',
+            'Give form controls a visible label or equivalent accessible name',
+            'Add aria-label to semantic regions such as filter bars or tables when helpful',
+        ],
+    },
+];
 export const designRules = {
+    meta: {
+        nature: 'recommended',
+        noteZh: 'standards 为页面书写标准（推荐实践）；特殊场景可偏离。validate_page 仅给出参考建议。',
+        noteEn: 'standards are recommended page-writing practices; deviations are fine when justified. validate_page is advisory only.',
+    },
+    /** Page writing standards — single source for layout, scroll, tokens, feedback, a11y, etc. */
+    standards: pageStandards,
     tokens: {
         colors: ['--m-color-primary', '--m-color-surface', '--m-color-text', '--m-color-border'],
         spacing: '--m-space-*',
@@ -321,6 +452,49 @@ export const designRules = {
         typography: '--m-font-size-xs/sm/md/lg',
         motion: '--m-motion-fast/normal',
     },
+    composition: {
+        workflow: [
+            'For full pages: recommend_page → get_golden_page → get_design_rules.',
+            'For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI/scrollable-panel blocks.',
+            'Use MLayout fillViewport as the app shell; put MPageContent inside MLayoutContent.',
+            'Prefer MPage* components over scoped CSS for filters, toolbars, headers, form surfaces, and KPI cards.',
+            'Use MSpace or MFlex for control groups inside MPageFilters; use MPageToolbar for title + primary action.',
+        ],
+        snippets: [
+            'list-filters',
+            'list-toolbar',
+            'list-table',
+            'list-row-actions',
+            'form-header',
+            'form-body',
+            'form-actions',
+            'dashboard-kpi-grid',
+            'dashboard-chart-card',
+            'layout-app-shell',
+            'scrollable-panel',
+        ],
+        pageStack: {
+            list: ['MLayout', 'MLayoutHeader', 'MLayoutContent', 'MPageContent', 'MPageFilters', 'MPageToolbar', 'MTable'],
+            form: ['MLayout', 'MLayoutHeader', 'MLayoutContent', 'MPageContent', 'MPageHeader', 'MPageSection', 'MForm'],
+            dashboard: ['MLayout', 'MLayoutHeader', 'MLayoutContent', 'MPageContent', 'MPageHeader', 'MGrid', 'MPageStat', 'MCard'],
+        },
+        spacing: {
+            pageContent: 'MPageContent handles padding (--m-space-6) and gap (--m-space-4); spacious uses --m-space-6 gap',
+            filters: 'MPageFilters handles padded muted surface; do not wrap filters in MCard',
+            toolbar: 'MPageToolbar handles title/actions alignment with --m-space-4 gap',
+            form: 'MPageSection variant="form" handles form padding/border/shadow',
+        },
+        borders: {
+            do: ['MLayoutHeader bordered (default)', 'MPageFilters for filter regions', 'MPageSection variant="form" for forms', 'MTable bordered when table needs grid lines'],
+            avoid: [
+                'MCard wrapping MTable that is already bordered',
+                'Nested MCard with bordered=true on both levels',
+                'Hand-written section borders when MPageFilters or MPageSection applies',
+                'Double borders on filter + table wrapper',
+            ],
+        },
+        goldenPages: ['list-page', 'form-page', 'dashboard-page'],
+    },
     actions: {
         primary: { component: 'MButton', props: ['severity omitted or primary'] },
         secondary: { component: 'MButton', props: ['severity="secondary"', 'outlined or text'] },
@@ -350,12 +524,11 @@ export const designRules = {
         doc: 'docs/feedback-message-vs-toast.md',
     },
     global: [
-        '优先使用组件库组件和 --m-* Token，不重复维护第二套色板',
-        '操作反馈默认 message；无 detail 禁止用 toast.add({ summary only })',
-        '图标按钮必须提供 aria-label 或 ariaLabel',
-        '表单字段必须有可见 label 或等价的可访问名称',
-        '浮层默认 Teleport 到 body；只有有明确布局约束时才改 appendTo',
-        '优先使用组件的 documented variant，不通过深层 CSS 覆盖内部样式',
+        '优先使用组件库组件和 --m-* Token',
+        '操作反馈默认 message；仅一行文案时优先于 toast',
+        '图标按钮建议提供 aria-label；表单字段建议有可见 label',
+        '浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo',
+        '优先使用组件 documented variant，少写深层 CSS 覆盖',
     ],
 };
 export function findPattern(input) {

package/dist/tools.d.ts

@@ -14,7 +14,7 @@ export declare function createToolHandlers(catalog?: import("./catalog.js").Cata
     };
     search: (args: {
         query: string;
-        scope?: "all" | "components" | "guides" | "api" | "examples" | "patterns" | "decisions";
+        scope?: "all" | "components" | "guides" | "api" | "examples" | "patterns" | "decisions" | "snippets";
         mode?: string;
         limit?: number;
         offset?: number;
@@ -147,6 +147,59 @@ export declare function createToolHandlers(catalog?: import("./catalog.js").Cata
             text: string;
         }[];
     };
+    listGoldenPageCatalog: (args?: {
+        mode?: string;
+    }) => {
+        structuredContent?: Record<string, unknown> | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    getGoldenPage: (args: {
+        page: string;
+        mode?: string;
+    }) => {
+        structuredContent?: Record<string, unknown> | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    listPageSnippets: (args: {
+        query?: string;
+        pageType?: string;
+        mode?: string;
+        limit?: number;
+        offset?: number;
+    }) => {
+        structuredContent?: Record<string, unknown> | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    getPageSnippet: (args: {
+        section: string;
+        mode?: string;
+        includeScript?: boolean;
+    }) => {
+        structuredContent?: Record<string, unknown> | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    validatePage: (args: {
+        code?: string;
+        mode?: string;
+    }) => {
+        structuredContent?: Record<string, unknown> | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
     version: () => {
         structuredContent?: Record<string, unknown> | undefined;
         content: {