@morya-ui/mcp 0.2.3 → 0.2.5

package/data/golden-pages/login-page.vue

@@ -0,0 +1,191 @@
+<script setup lang="ts">
+/**
+ * 黄金样例：登录页（Account + 轻量品牌）
+ * @see DESIGN.md §3 · morya-ui-pages surfaces § Account
+ */
+import {
+  MButton,
+  MConfigProvider,
+  MForm,
+  MFormItem,
+  MInput,
+  MInputPassword,
+  MSpace,
+  zhCN,
+} from 'morya-ui'
+import { reactive, ref } from 'vue'
+
+const submitting = ref(false)
+const formError = ref('')
+
+const model = reactive({
+  email: '',
+  password: '',
+})
+
+async function onSubmit() {
+  formError.value = ''
+  submitting.value = true
+  try {
+    // await api.login(model)
+    if (!model.email || !model.password) {
+      formError.value = '请输入邮箱和密码后再试。'
+      return
+    }
+  } finally {
+    submitting.value = false
+  }
+}
+</script>
+
+<template>
+  <MConfigProvider :locale="zhCN">
+    <div class="login-shell">
+      <aside class="login-brand" aria-label="品牌">
+        <p class="login-brand__mark">青禾书房</p>
+        <h1 class="login-brand__title">把好书留在手边</h1>
+        <p class="login-brand__lead">
+          店员与会员共用同一套账户。登录后继续进货、上架与会员服务。
+        </p>
+      </aside>
+
+      <main class="login-main">
+        <div class="login-panel">
+          <header class="login-panel__header">
+            <h2>登录</h2>
+            <p>使用工作邮箱进入后台。</p>
+          </header>
+
+          <!-- 表单级常驻错误：token 样式告警条（字段错误优先用 errorMessage） -->
+          <p v-if="formError" class="login-alert" role="alert">
+            {{ formError }}
+          </p>
+
+          <MForm @submit="onSubmit">
+            <MFormItem label="邮箱" name="email" required>
+              <MInput
+                v-model="model.email"
+                type="email"
+                placeholder="name@qinghe.example"
+                autocomplete="username"
+                fluid
+              />
+            </MFormItem>
+
+            <MFormItem label="密码" name="password" required>
+              <MInputPassword
+                v-model="model.password"
+                placeholder="请输入密码"
+                autocomplete="current-password"
+                fluid
+              />
+            </MFormItem>
+
+            <MSpace style="margin-top: var(--m-space-2)" alignment="center">
+              <MButton type="submit" label="登录" :loading="submitting" />
+              <MButton type="button" label="忘记密码" severity="secondary" text />
+            </MSpace>
+          </MForm>
+        </div>
+      </main>
+    </div>
+  </MConfigProvider>
+</template>
+
+<style scoped>
+.login-shell {
+  display: grid;
+  grid-template-columns: minmax(0, 1.05fr) minmax(0, 0.95fr);
+  min-height: 100vh;
+  background: var(--m-color-surface);
+  color: var(--m-color-text);
+}
+
+.login-brand {
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-end;
+  gap: var(--m-space-4);
+  padding: clamp(2rem, 6vw, 4.5rem);
+  background:
+    linear-gradient(
+      165deg,
+      color-mix(in srgb, var(--m-color-primary) 18%, var(--m-color-surface)) 0%,
+      var(--m-color-surface) 55%,
+      color-mix(in srgb, var(--m-color-border) 35%, var(--m-color-surface)) 100%
+    );
+  border-right: 1px solid var(--m-color-border);
+}
+
+.login-brand__mark {
+  margin: 0;
+  font-size: 0.8125rem;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--m-color-text-muted);
+}
+
+.login-brand__title {
+  margin: 0;
+  max-width: 12em;
+  font-size: clamp(2rem, 4vw, 3rem);
+  font-weight: 650;
+  line-height: 1.15;
+  letter-spacing: -0.03em;
+}
+
+.login-brand__lead {
+  margin: 0;
+  max-width: 28rem;
+  color: var(--m-color-text-muted);
+  line-height: 1.6;
+}
+
+.login-main {
+  display: grid;
+  place-items: center;
+  padding: var(--m-space-6);
+}
+
+.login-panel {
+  width: min(100%, 22rem);
+}
+
+.login-panel__header {
+  margin-bottom: var(--m-space-5);
+}
+
+.login-panel__header h2 {
+  margin: 0 0 var(--m-space-2);
+  font-size: 1.5rem;
+  font-weight: 650;
+}
+
+.login-panel__header p {
+  margin: 0;
+  color: var(--m-color-text-muted);
+}
+
+.login-alert {
+  margin: 0 0 var(--m-space-4);
+  padding: var(--m-space-3) var(--m-space-4);
+  border: 1px solid color-mix(in srgb, var(--m-color-danger) 40%, var(--m-color-border));
+  border-radius: var(--m-radius-md);
+  background: color-mix(in srgb, var(--m-color-danger) 10%, var(--m-color-surface));
+  color: var(--m-color-danger);
+  font-size: 0.875rem;
+  line-height: 1.45;
+}
+
+@media (max-width: 768px) {
+  .login-shell {
+    grid-template-columns: 1fr;
+  }
+
+  .login-brand {
+    border-right: 0;
+    border-bottom: 1px solid var(--m-color-border);
+    min-height: 12rem;
+  }
+}
+</style>

package/dist/__tests__/resources.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
+import { countCatalogResources, countCatalogResourceTemplates } from '../resources.js';
 import { createToolHandlers } from '../tools.js';
-import { countCatalogResourceTemplates, countCatalogResources } from '../resources.js';
 describe('@morya-ui/mcp resources', () => {
     const handlers = createToolHandlers();
     it('registers static resources and resource templates', () => {

package/dist/__tests__/tools.test.js

@@ -107,12 +107,65 @@ describe('@morya-ui/mcp handlers', () => {
         const result = read(handlers.search({ query: 'toolbar', scope: 'snippets', limit: 5 }));
         expect(result.items.some((item) => item.type === 'snippet' && item.id === 'list-toolbar')).toBe(true);
     });
-    it('flags double-border page composition issues', () => {
+    it('suggests double-border page composition as advisory standard', () => {
         const result = read(handlers.validatePage({
             code: '<MLayoutContent><MCard><MTable bordered /></MCard></MLayoutContent>',
         }));
-        expect(result.ok).toBe(false);
-        expect(result.issues.some((issue) => issue.type === 'double-border')).toBe(true);
+        expect(result.ok).toBe(true);
+        expect(result.advisory).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'double-border')).toBe(true);
+    });
+    it('suggests MScrollbar over inline overflow scroll styles', () => {
+        const result = read(handlers.validatePage({
+            code: '<div style="overflow:auto;height:20rem"><MTable /></div>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'native-scroll' && item.standardId === 'scroll')).toBe(true);
+    });
+    it('suggests MScrollbar over overflow in style blocks', () => {
+        const result = read(handlers.validatePage({
+            code: '<template><div class="panel">x</div></template><style>.panel { max-height: 20rem; overflow-y: auto; }</style>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'native-scroll')).toBe(true);
+    });
+    it('returns scrollable-panel snippet for scroll queries', () => {
+        const result = read(handlers.getPageSnippet({ section: 'scrollable-panel' }));
+        expect(result.id).toBe('scrollable-panel');
+        expect(result.template).toContain('MScrollbar');
+        expect(result.imports).toContain('MScrollbar');
+    });
+    it('keeps recommend_page focused on pattern matching', () => {
+        const result = read(handlers.recommendPage({ intent: '用户列表页', pageType: 'list' }));
+        expect(result.matchedPattern).toBe('admin-list');
+        expect(result.nextStep).toContain('get_design_rules');
+        expect(result.pageStandards).toBeUndefined();
+        expect(result.scrollStandards).toBeUndefined();
+    });
+    it('keeps get_golden_page focused on source code', () => {
+        const result = read(handlers.getGoldenPage({ page: 'list-page' }));
+        expect(result.source).toContain('MLayout');
+        expect(result.nextStep).toContain('get_design_rules');
+        expect(result.pageStandards).toBeUndefined();
+        expect(result.scrollStandards).toBeUndefined();
+    });
+    it('exposes page standards from get_design_rules', () => {
+        const result = read(handlers.getDesignRules({ mode: 'zh-CN' }));
+        expect(result.meta.nature).toBe('recommended');
+        expect(result.standards.some((item) => item.id === 'scroll')).toBe(true);
+        expect(result.standards.some((item) => item.id === 'feedback')).toBe(true);
+    });
+    it('reads page scroll decision guide by id', () => {
+        const result = read(handlers.recommendComponent({ decision: 'page-scroll-choice' }));
+        expect(result.id).toBe('page-scroll-choice');
+        expect(result.options.some((option) => option.component === 'MScrollbar')).toBe(true);
+    });
+    it('suggests redundant wrappers around MPage blocks', () => {
+        const result = read(handlers.validatePage({
+            code: '<MPageContent><div style="padding:24px"><MPageFilters /></div></MPageContent>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'redundant-wrapper' && item.standardId === 'page-sections')).toBe(true);
     });
     it('lists component decision guides when query is omitted', () => {
         const result = read(handlers.recommendComponent({ limit: 5 }));

package/dist/decisions.js

@@ -227,6 +227,76 @@ export const componentDecisions = [
             },
         ],
     },
+    {
+        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: '如何避免双边框与多余容器',

package/dist/golden-pages.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const goldenPageCatalog = [
@@ -23,6 +23,27 @@ export const goldenPageCatalog = [
         titleEn: 'Dashboard golden sample',
         patternId: 'dashboard',
     },
+    {
+        id: 'login-page',
+        file: 'login-page.vue',
+        title: '登录页黄金样例',
+        titleEn: 'Login page golden sample',
+        patternId: 'auth-page',
+    },
+    {
+        id: 'landing-page',
+        file: 'landing-page.vue',
+        title: '营销落地页黄金样例',
+        titleEn: 'Marketing landing golden sample',
+        patternId: 'marketing-landing',
+    },
+    {
+        id: 'empty-state',
+        file: 'empty-state.vue',
+        title: '空状态黄金样例',
+        titleEn: 'Empty state golden sample',
+        patternId: 'empty-state',
+    },
 ];
 const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
 const bundledDir = join(pkgRoot, 'data/golden-pages');

package/dist/index.js

@@ -102,7 +102,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, form-page, dashboard-page).', {
+register('get_golden_page', 'Read a golden page Vue source sample (list-page, form-page, dashboard-page, login-page, landing-page, empty-state).', {
     page: z.string().min(1),
     mode: z.string().optional(),
 }, async (args) => handlers.getGoldenPage(args));

package/dist/page-snippets.js

@@ -127,11 +127,75 @@ const loading = ref(false)`,
     :severity="value === 'active' ? 'success' : 'secondary'"
   />
 </template>`,
-        rules: ['状态用 MTag，不要用 Button 颜色表达状态'],
-        rulesEn: ['Use MTag for status, not Button colors'],
+        rules: ['分类/强调态用 MTag；更轻的圆点+文案用 MStatus', '不要用 Button 颜色表达状态'],
+        rulesEn: ['Use MTag for chip-like status; use MStatus for lighter dot+label', 'Do not use Button colors for status'],
         avoid: ['不要用裸文本颜色区分状态'],
         avoidEn: ['Do not rely on raw text color for status'],
     },
+    {
+        id: 'list-status-dot',
+        title: '表格状态列 Status',
+        titleEn: 'Table status dot cell',
+        description: '在 #cell-status 中用 MStatus 展示轻量业务状态。',
+        descriptionEn: 'Render lightweight business status with MStatus in #cell-status.',
+        pageTypes: ['list'],
+        keywords: ['状态', 'status', 'dot', 'cell-status', '在线'],
+        imports: ['MStatus'],
+        template: `<template #cell-status="{ value }">
+  <MStatus
+    :label="value === 'online' ? '在线' : '离线'"
+    :severity="value === 'online' ? 'success' : 'secondary'"
+  />
+</template>`,
+        rules: ['行内轻量状态优先 MStatus', '不要用 Button 颜色表达状态'],
+        rulesEn: ['Prefer MStatus for lightweight inline status', 'Do not use Button colors for status'],
+        avoid: ['不要用裸文本颜色区分状态'],
+        avoidEn: ['Do not rely on raw text color for status'],
+    },
+    {
+        id: 'empty-block',
+        title: '空状态 MEmpty',
+        titleEn: 'Empty state with MEmpty',
+        description: '列表或内容区无数据时使用 MEmpty，操作放在 #extra。',
+        descriptionEn: 'Use MEmpty for no-data regions; put actions in #extra.',
+        pageTypes: ['list', 'common'],
+        keywords: ['空状态', '无数据', 'empty', 'zero state', 'no data'],
+        imports: ['MEmpty', 'MButton'],
+        template: `<MEmpty
+  title="还没有数据"
+  description="创建第一条记录后即可在此查看。"
+  icon="database"
+>
+  <template #extra>
+    <MButton label="新建" />
+    <MButton label="导入" severity="secondary" text />
+  </template>
+</MEmpty>`,
+        rules: ['正常无数据用 MEmpty，不要用错误色', '主 CTA 用 primary，次动作用 text/secondary'],
+        rulesEn: ['Use MEmpty for normal emptiness, not error colors', 'Primary CTA + secondary/text for lesser actions'],
+        avoid: ['不要用手写 div 拼空态', '不要用 MResult 表达无数据'],
+        avoidEn: ['Do not hand-roll empty markup', 'Do not use MResult for no-data'],
+    },
+    {
+        id: 'result-block',
+        title: '结果页 MResult',
+        titleEn: 'Result page with MResult',
+        description: '提交成功、失败或 403/404/500 使用 MResult。',
+        descriptionEn: 'Use MResult for submit outcomes and 403/404/500 pages.',
+        pageTypes: ['common'],
+        keywords: ['结果', '成功', '失败', '404', '403', 'result', 'success', 'error'],
+        imports: ['MResult', 'MButton'],
+        template: `<MResult status="success" description="订单已创建，可在列表中查看详情。">
+  <template #extra>
+    <MButton label="查看订单" />
+    <MButton label="返回列表" severity="secondary" text />
+  </template>
+</MResult>`,
+        rules: ['流程终点用 MResult', '提供明确下一步操作'],
+        rulesEn: ['Use MResult for terminal outcomes', 'Provide clear next-step actions'],
+        avoid: ['不要用 MEmpty 表达 403/404/失败', '不要只靠颜色表达结果'],
+        avoidEn: ['Do not use MEmpty for 403/404/failure', 'Do not rely on color alone'],
+    },
     {
         id: 'form-header',
         title: '表单页标题区',
@@ -348,6 +412,55 @@ const recentRows = ref<Record<string, unknown>[]>([])`,
         avoid: ['不要手写 min-height: 100vh'],
         avoidEn: ['Do not hand-write min-height: 100vh'],
     },
+    {
+        id: 'scrollable-panel',
+        title: '局部可滚动面板',
+        titleEn: 'Scrollable local panel',
+        description: '业务自行限高滚动时的可选写法：显式使用 MScrollbar。组件内置滚动区无需再包。',
+        descriptionEn: 'Optional pattern when the app wants a themed capped scroll region. Do not wrap component-owned scroll chrome again.',
+        pageTypes: ['list', 'form', 'dashboard', 'detail', 'common'],
+        keywords: [
+            'scroll',
+            'scrollbar',
+            '滚动',
+            '滚动条',
+            'overflow',
+            'max-height',
+            'panel',
+            'card body',
+            'sidebar',
+            'log',
+        ],
+        imports: ['MScrollbar', 'MCard'],
+        template: `<MCard title="活动日志">
+  <MScrollbar max-height="16rem">
+    <ul style="margin:0;padding:0;list-style:none">
+      <li v-for="item in logLines" :key="item.id" style="padding:var(--m-space-2) 0;border-bottom:1px solid var(--m-color-border)">
+        {{ item.text }}
+      </li>
+    </ul>
+  </MScrollbar>
+</MCard>`,
+        scriptSetup: `const logLines = [
+  { id: '1', text: '用户 admin 登录成功' },
+  { id: '2', text: '导出任务已完成' },
+  { id: '3', text: '配置已保存' },
+]`,
+        rules: [
+            '整页主滚动推荐 MLayout fillViewport',
+            '固定高度用 height；仅超出时才滚动用 max-height',
+            'MTable / Layout / 菜单下拉等通常已内置滚动，一般无需再包一层',
+            'Dialog / Drawer 内容滚动由业务自行决定，需要主题滚动时再包 MScrollbar',
+        ],
+        rulesEn: [
+            'Main page scroll: prefer MLayout fillViewport',
+            'Use height for fixed viewports; use max-height when scroll should appear only on overflow',
+            'MTable / Layout / menu popups usually scroll internally; an extra wrapper is often unnecessary',
+            'Dialog / Drawer content scrolling is app-owned; wrap MScrollbar only when themed scroll is desired',
+        ],
+        avoid: ['整页壳写 overflow:auto', '重复包裹已内置滚动的组件'],
+        avoidEn: ['overflow:auto on the page shell', 'Double-wrapping components that already scroll'],
+    },
 ];
 export function findPageSnippet(id) {
     const key = id.trim().toLowerCase().replace(/[-_\s]/g, '');

package/dist/patterns.d.ts

@@ -20,7 +20,29 @@ export interface PagePattern {
     avoid: string[];
 }
 export declare const pagePatterns: PagePattern[];
+export interface PageStandard {
+    id: string;
+    title: string;
+    titleEn: string;
+    recommend: string[];
+    recommendEn: string[];
+    discouraged?: string[];
+    discouragedEn?: string[];
+    mcp?: {
+        snippet?: string;
+        decision?: string;
+    };
+}
+/** Advisory page-writing standards for MCP and human authors — not enforced blockers. */
+export declare const pageStandards: PageStandard[];
 export declare const designRules: {
+    readonly meta: {
+        readonly nature: "recommended";
+        readonly noteZh: "standards 为页面书写标准（推荐实践）；特殊场景可偏离。validate_page 仅给出参考建议。";
+        readonly 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. */
+    readonly standards: PageStandard[];
     readonly tokens: {
         readonly colors: readonly ["--m-color-primary", "--m-color-surface", "--m-color-text", "--m-color-border"];
         readonly spacing: "--m-space-*";
@@ -29,8 +51,8 @@ export declare const designRules: {
         readonly motion: "--m-motion-fast/normal";
     };
     readonly composition: {
-        readonly workflow: readonly ["For full pages: recommend_page then get_golden_page before writing layout code.", "For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI blocks instead of reading the whole golden page.", "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."];
-        readonly snippets: readonly ["list-filters", "list-toolbar", "list-table", "list-row-actions", "form-header", "form-body", "form-actions", "dashboard-kpi-grid", "dashboard-chart-card", "layout-app-shell"];
+        readonly workflow: readonly ["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."];
+        readonly snippets: readonly ["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"];
         readonly pageStack: {
             readonly list: readonly ["MLayout", "MLayoutHeader", "MLayoutContent", "MPageContent", "MPageFilters", "MPageToolbar", "MTable"];
             readonly form: readonly ["MLayout", "MLayoutHeader", "MLayoutContent", "MPageContent", "MPageHeader", "MPageSection", "MForm"];
@@ -46,7 +68,7 @@ export declare const designRules: {
             readonly do: readonly ["MLayoutHeader bordered (default)", "MPageFilters for filter regions", "MPageSection variant=\"form\" for forms", "MTable bordered when table needs grid lines"];
             readonly avoid: readonly ["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"];
         };
-        readonly goldenPages: readonly ["list-page", "form-page", "dashboard-page"];
+        readonly goldenPages: readonly ["list-page", "form-page", "dashboard-page", "login-page", "landing-page", "empty-state"];
     };
     readonly actions: {
         readonly primary: {
@@ -68,13 +90,15 @@ export declare const designRules: {
         };
     };
     readonly status: {
-        readonly component: "MTag";
+        readonly preferred: "MStatus";
+        readonly chip: "MTag";
         readonly mapping: {
             readonly active: "success";
             readonly pending: "warn";
             readonly disabled: "secondary";
             readonly error: "danger";
         };
+        readonly note: "行内轻量状态用 MStatus；芯片/可关闭标签用 MTag";
     };
     readonly feedback: {
         readonly default: "message";
@@ -88,13 +112,23 @@ export declare const designRules: {
             readonly when: readonly ["同时需要标题与补充说明", "后台任务/批量结果含统计", "异步通知感、角落堆叠"];
             readonly avoid: readonly ["仅有单行文案时不要使用 Toast"];
         };
+        readonly empty: {
+            readonly component: "MEmpty";
+            readonly when: readonly ["列表无数据", "筛选无结果", "首次使用"];
+            readonly avoid: readonly ["不要用错误色表达正常空态", "不要用 MResult 表达无数据"];
+        };
+        readonly result: {
+            readonly component: "MResult";
+            readonly when: readonly ["提交成功/失败页", "403 / 404 / 500", "流程终点回执"];
+            readonly avoid: readonly ["不要用手写图标+文案替代 MResult", "不要用 MEmpty 表达阻断错误"];
+        };
         readonly inlineMessage: {
-            readonly component: "MMessage";
-            readonly when: readonly ["登录/表单区常驻错误", "页面级错误需与表单同区展示"];
+            readonly api: "field errorMessage | token-styled role=alert";
+            readonly when: readonly ["登录/表单区常驻错误：优先字段 errorMessage", "表单级总结：使用 --m-* 样式的 role=alert 条（见 login-page 黄金样例）", "MMessage 组件当前主要为 message 服务宿主，勿臆造 severity 子节点 API"];
         };
         readonly doc: "docs/feedback-message-vs-toast.md";
     };
-    readonly global: readonly ["优先使用组件库组件和 --m-* Token，不重复维护第二套色板", "操作反馈默认 message；无 detail 禁止用 toast.add({ summary only })", "图标按钮必须提供 aria-label 或 ariaLabel", "表单字段必须有可见 label 或等价的可访问名称", "浮层默认 Teleport 到 body；只有有明确布局约束时才改 appendTo", "优先使用组件的 documented variant，不通过深层 CSS 覆盖内部样式"];
+    readonly global: readonly ["优先使用组件库组件和 --m-* Token", "操作反馈默认 message；仅一行文案时优先于 toast", "空态用 MEmpty；结果/阻断页用 MResult；行内状态优先 MStatus", "图标按钮建议提供 aria-label；表单字段建议有可见 label", "浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo", "优先使用组件 documented variant，少写深层 CSS 覆盖"];
 };
 export declare function findPattern(input: string): PagePattern | undefined;
 export declare function scorePattern(pattern: PagePattern, query: string): number;