@morya-ui/setup 0.3.4 → 0.3.6

package/template/.agents/skills/morya-ui-pages/evals/evals.json

@@ -1,89 +1,89 @@
-{
-  "skill_name": "morya-ui-pages",
-  "evals": [
-    {
-      "id": 1,
-      "prompt": "我们内部教务系统用 Vue3 + morya-ui。请做一个「课程列表」后台页：按课程名搜索、按开课状态（全部/开课中/已结课）筛选；表格列：名称、状态、学分、更新时间；行内「编辑」进抽屉表单，「删除」要二次确认；右上角「新建课程」。保存/删除成功只要一句话提示。输出单个 Vue SFC，结构对齐列表黄金样例，并做 Ops 精致化（侧栏图标、状态用 MStatus、空态用 MEmpty、行操作不要一排实心按钮）。",
-      "expected_output": "Ops list: MLayout/MPageHeader/MPageFilters/MTable rows, optional batch MPageToolbar, MSelect status, MDrawer edit, MConfirmDialog delete, message not toast, MStatus for status, MEmpty in #empty, menu icons, text/small row actions, craft pass applied, no second UI kit.",
-      "files": []
-    },
-    {
-      "id": 2,
-      "prompt": "同一个 morya-ui 项目里，生成「新建员工」独立表单页：姓名、工作邮箱、部门（下拉）、入职日期；窄栏；页头有标题和一句说明；底栏保存（primary）/取消（secondary）。不要做成营销落地页，不要用 Toast 提示「已保存」。输出单个 Vue SFC。",
-      "expected_output": "Ops form golden: narrow MPageContent, MPageHeader, MPageSection form/actions, MForm + MSelect/MDatePicker, message for success if shown, one primary, no landing hero.",
-      "files": []
-    },
-    {
-      "id": 3,
-      "prompt": "运营后台首页仪表盘：四个 KPI（今日订单、待处理、转化率、退款率）、中间一块图表占位、右侧或下方「最近告警」表格（级别、内容、时间）。Vue3 + morya-ui，可先用静态假数据；告警级别可用 Tag，状态用 MStatus。",
-      "expected_output": "Dashboard: MPageStat grid with domain labels, MCard shadow=always + MEmpty chart pending, recent MTable with MStatus, MLayout shell, --m-* only, spacious density.",
-      "files": []
-    },
-    {
-      "id": 4,
-      "prompt": "给「青禾书房」这个独立书店品牌做登录页：左品牌、右表单（邮箱+密码+登录）。要有一点品牌感（token 氛围即可），但控件必须用 morya-ui；登录失败用表单区常驻错误（字段 errorMessage 或 token role=alert），不要一闪而过的 Toast，也不要把 MMessage 当成内嵌 Alert。输出单个 Vue SFC。",
-      "expected_output": "Account+craft: split shell, MForm/MInputPassword/MButton, token role=alert or field error for failure, brand panel with --m-* color-mix, no MMessage severity alert, no second UI kit.",
-      "files": []
-    },
-    {
-      "id": 5,
-      "prompt": "课程列表在零数据时太空了。请设计一个空状态区块（可嵌在列表页内容区）：说明还没有课程、引导「创建第一门课程」；视觉克制，用 morya-ui 默认空态即可，不要自定义 dashed 框或径向光晕。只要空状态相关模板片段或带空状态的列表 SFC 均可。",
-      "expected_output": "Flow empty: MPageHeader + MEmpty + next-action MButton, short copy, no custom dashed/radial shell, fits list content slot.",
-      "files": []
-    },
-    {
-      "id": 6,
-      "prompt": "为「流水线 CI」产品写一个营销落地首页（不是后台）：首屏只有品牌名、一句主标题、一句副文、一组 CTA；下面再分「为何选择」「能力」「客户」三节。技术实现用 Vue3 + morya-ui 组件做按钮/标签/折叠 FAQ；颜色走 --m-*，避免紫渐变和奶油衬线陶土那套 AI 默认脸。可有 1–2 个微动效，强度跟 useMotion / data-m-motion。输出单个 Vue SFC。",
-      "expected_output": "Express landing: single-job hero, MButton CTAs, sections with one job each, MAccordion FAQ optional, no purple/cream-terracotta defaults, no admin MPageFilters shell, motion gated by useMotion / data-m-motion.",
-      "files": []
-    },
-    {
-      "id": 7,
-      "prompt": "做一个三步「创建工作空间」向导：1 名称与地区 2 邀请成员（邮箱标签）3 确认。用 morya-ui 的 Stepper + Form；每步一个主任务；最后提交成功进入结果页（查看工作空间 / 返回）。输出一个或两个 SFC。",
-      "expected_output": "Flow wizard: wizard-form golden — MStepper :steps, per-step MForm, MInputTags invites, clear next/back/submit, message success, validate_usage clean.",
-      "files": []
-    },
-    {
-      "id": 8,
-      "prompt": "用户点了删除项目但权限不足：做一张「无权限」系统页（或全页占位），说明原因，并提供返回上一页、联系管理员。用 morya-ui，文案直接别玩梗。",
-      "expected_output": "System surface: result-page golden — MResult status=403, #footer escape actions, no jokey 404 essay, on-token, validate_usage clean.",
-      "files": []
-    },
-    {
-      "id": 9,
-      "prompt": "把上面的课程列表再 polish 一轮：去掉多余实心按钮、保证只有一个主按钮、表格状态改成 MStatus、补上 MEmpty。不要改成营销页。",
-      "expected_output": "Ops quieter polish: one primary, MStatus, MEmpty, text row actions, still list golden structure.",
-      "files": []
-    },
-    {
-      "id": 10,
-      "prompt": "给「用户管理」做资源详情页：面包屑、标题旁启用状态、编辑/返回/删除；摘要标签；基本信息属性网格；下方近期活动表。Vue3 + morya-ui，对齐详情黄金样例，不要做成落地页。",
-      "expected_output": "Ops detail: MPageHeader + MStatus, property MCard, related MTable rows, --m-* only, no marketing hero.",
-      "files": []
-    },
-    {
-      "id": 11,
-      "prompt": "用户列表页上「新建/编辑」不要另开路由：同页 MDialog（约 32rem）里放短表单（姓名、邮箱、角色），页脚取消/保存；保存成功用 message 一句话。输出单个 Vue SFC。",
-      "expected_output": "form-in-dialog: list stays, MDialog + MForm + #footer, message.success not toast string, MTable rows.",
-      "files": []
-    },
-    {
-      "id": 12,
-      "prompt": "做一个用户列表表格页：列姓名、角色、状态。状态列必须用 MStatus；行数据绑定用 rows（不要写 data prop）；空表用 #empty + MEmpty。Vue3 + morya-ui，输出单个 SFC。",
-      "expected_output": "Prop accuracy: MTable columns+rows (not :data), #cell or Status for status, #empty+MEmpty, validate_usage clean.",
-      "files": []
-    },
-    {
-      "id": 13,
-      "prompt": "列表行删除：点删除后用 MConfirmDialog（危险确认），确认后 message.success('已删除')。不要用 toast，也不要手写 Dialog 当确认框。输出片段或 SFC 均可。",
-      "expected_output": "confirm-choice + feedback-choice: MConfirmDialog v-model header/message acceptSeverity=danger @accept, message.success not toast, no hand Dialog confirm.",
-      "files": []
-    },
-    {
-      "id": 14,
-      "prompt": "短新建弹窗：MDialog v-model + header + #footer（取消 secondary、保存 primary）；表单字段 fluid。保存成功 message 一句话。不要用 v-model:visible。",
-      "expected_output": "form-surface Dialog recipe: v-model not visible, #footer actions, fluid fields, message.success.",
-      "files": []
-    }
-  ]
-}
+{
+  "skill_name": "morya-ui-pages",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "我们内部教务系统用 Vue3 + morya-ui。请做一个「课程列表」后台页：按课程名搜索、按开课状态（全部/开课中/已结课）筛选；表格列：名称、状态、学分、更新时间；行内「编辑」进抽屉表单，「删除」要二次确认；右上角「新建课程」。保存/删除成功只要一句话提示。输出单个 Vue SFC，用 list-filters-stack / list-table / form-in-drawer / confirm-delete / page-header-actions 等 snippets 拼装并对齐 page-layouts 块顺序，并做 Ops 精致化（侧栏图标、状态用 MStatus、空态用 MEmpty、行操作不要一排实心按钮）。",
+      "expected_output": "Ops list composition-first: MLayout/MPageHeader/list-filters-stack (collapsible+#advanced+FilterChips)/MTable rows, page-header-actions one primary, form-in-drawer edit, confirm-delete, message not toast, MStatus, MEmpty in #empty, menu icons, text/small row actions, craft pass, no second UI kit; do not require whole golden-page clone.",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "同一个 morya-ui 项目里，生成「新建员工」独立表单页：姓名、工作邮箱、部门（下拉）、入职日期；窄栏；页头有标题和一句说明；底栏保存（primary）/取消（secondary）。不要做成营销落地页，不要用 Toast 提示「已保存」。输出单个 Vue SFC。",
+      "expected_output": "Ops form snippets: page-content-form + form-header/body/actions, narrow MPageContent, MForm + MSelect/MDatePicker, message for success if shown, one primary, no landing hero.",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "运营后台首页仪表盘：四个 KPI（今日订单、待处理、转化率、退款率）、中间一块图表占位、右侧或下方「最近告警」表格（级别、内容、时间）。Vue3 + morya-ui，可先用静态假数据；告警级别可用 Tag，状态用 MStatus。",
+      "expected_output": "Dashboard snippets: dashboard-kpi-grid, dashboard-chart-card, dashboard-recent-table, MLayout shell, --m-* only, spacious density.",
+      "files": []
+    },
+    {
+      "id": 4,
+      "prompt": "给「青禾书房」这个独立书店品牌做登录页：左品牌、右表单（邮箱+密码+登录）。要有一点品牌感（token 氛围即可），但控件必须用 morya-ui；登录失败用表单区常驻错误（字段 errorMessage 或 token role=alert），不要一闪而过的 Toast，也不要把 MMessage 当成内嵌 Alert。输出单个 Vue SFC。",
+      "expected_output": "Account+craft via auth-split-shell: split shell, MForm/MInputPassword/MButton, token role=alert or field error for failure, brand panel with flat --m-* color-mix (no stacked radial+linear aurora), no MMessage severity alert, no second UI kit.",
+      "files": []
+    },
+    {
+      "id": 5,
+      "prompt": "课程列表在零数据时太空了。请设计一个空状态区块（可嵌在列表页内容区）：说明还没有课程、引导「创建第一门课程」；视觉克制，用 morya-ui 默认空态即可，不要自定义 dashed 框或径向光晕。只要空状态相关模板片段或带空状态的列表 SFC 均可。",
+      "expected_output": "Flow empty via empty-block: MEmpty + next-action MButton, short copy, no custom dashed/radial shell, fits list content slot.",
+      "files": []
+    },
+    {
+      "id": 6,
+      "prompt": "为「流水线 CI」产品写一个营销落地首页（不是后台）：首屏只有品牌名、一句主标题、一句副文、一组 CTA；下面再分「为何选择」「能力」「客户」三节。技术实现用 Vue3 + morya-ui 组件做按钮/标签/折叠 FAQ；颜色走 --m-*，风格偏简洁扁平（不要紫渐变 aurora、奶油衬线陶土、霓虹毛玻璃）。可有 1–2 个微动效，强度跟 useMotion / data-m-motion。输出单个 Vue SFC。",
+      "expected_output": "Express landing: single-job hero, MButton CTAs, sections with one job each, MAccordion FAQ optional, flat/simple surfaces (no purple aurora / cream-terracotta / unsolicited glass-neon), no admin MPageFilters shell, motion gated by useMotion / data-m-motion.",
+      "files": []
+    },
+    {
+      "id": 7,
+      "prompt": "做一个三步「创建工作空间」向导：1 名称与地区 2 邀请成员（邮箱标签）3 确认。用 morya-ui 的 Stepper + Form；每步一个主任务；最后提交成功进入结果页（查看工作空间 / 返回）。输出一个或两个 SFC。",
+      "expected_output": "Flow wizard via wizard-steps (+ result-block): MStepper :steps, per-step MForm, MInputTags invites, clear next/back/submit, message success, validate_usage clean.",
+      "files": []
+    },
+    {
+      "id": 8,
+      "prompt": "用户点了删除项目但权限不足：做一张「无权限」系统页（或全页占位），说明原因，并提供返回上一页、联系管理员。用 morya-ui，文案直接别玩梗。",
+      "expected_output": "System surface via result-block: MResult status=403, #footer escape actions, no jokey 404 essay, on-token, validate_usage clean.",
+      "files": []
+    },
+    {
+      "id": 9,
+      "prompt": "把上面的课程列表再 polish 一轮：去掉多余实心按钮、保证只有一个主按钮、表格状态改成 MStatus、补上 MEmpty。不要改成营销页。",
+      "expected_output": "Ops quieter polish: one primary, MStatus, MEmpty, text row actions, still list block-order / snippets structure.",
+      "files": []
+    },
+    {
+      "id": 10,
+      "prompt": "给「用户管理」做资源详情页：面包屑、标题旁启用状态、编辑/返回/删除；摘要标签；基本信息属性网格；下方近期活动表。Vue3 + morya-ui，按 detail 块顺序 + detail-toolbar 拼装，不要做成落地页。",
+      "expected_output": "Ops detail composition: detail-toolbar MPageHeader + MStatus, property MCard, related MTable rows, --m-* only, no marketing hero.",
+      "files": []
+    },
+    {
+      "id": 11,
+      "prompt": "用户列表页上「新建/编辑」不要另开路由：同页 MDialog（约 32rem）里放短表单（姓名、邮箱、角色），页脚取消/保存；保存成功用 message 一句话。输出单个 Vue SFC。",
+      "expected_output": "form-in-dialog snippet: list stays, MDialog + MForm + #footer, message.success not toast string, MTable rows.",
+      "files": []
+    },
+    {
+      "id": 12,
+      "prompt": "做一个用户列表表格页：列姓名、角色、状态。状态列必须用 MStatus；行数据绑定用 rows（不要写 data prop）；空表用 #empty + MEmpty。Vue3 + morya-ui，输出单个 SFC。",
+      "expected_output": "Prop accuracy: MTable columns+rows (not :data), #cell or Status for status, #empty+MEmpty, validate_usage clean.",
+      "files": []
+    },
+    {
+      "id": 13,
+      "prompt": "列表行删除：点删除后用 MConfirmDialog（危险确认），确认后 message.success('已删除')。不要用 toast，也不要手写 Dialog 当确认框。输出片段或 SFC 均可。",
+      "expected_output": "confirm-delete snippet + feedback-choice: MConfirmDialog v-model header/message acceptSeverity=danger @accept, message.success not toast, no hand Dialog confirm.",
+      "files": []
+    },
+    {
+      "id": 14,
+      "prompt": "短新建弹窗：MDialog v-model + header + #footer（取消 secondary、保存 primary）；表单字段 fluid。保存成功 message 一句话。不要用 v-model:visible。",
+      "expected_output": "form-in-dialog / form-surface Dialog recipe: v-model not visible, #footer actions, fluid fields, message.success, relatedSnippets include form-in-dialog.",
+      "files": []
+    }
+  ]
+}

package/template/.agents/skills/morya-ui-pages/references/component-index.md

@@ -1,99 +1,99 @@
-# Component index (scenario map)
-
-Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_usage`).
-
-- **Selection + key props**: MCP `recommend_component`, or offline [decision-recipes.md](./decision-recipes.md) (generated from `packages/ui-mcp/src/decisions.ts`).
-- This file is a **catalog + decision-id index**, not a prop manual.
-
-## Shell
-
-| Component | Use |
-| --- | --- |
-| `MConfigProvider` | Root locale / theme / density / defaults |
-| `MLayout` family | Admin chrome (`MLayoutSider` is the layout sider) |
-| `MSidebar` | Standalone nav rail (not a `MDrawer`, not a substitute for `MLayoutSider` inside `MLayout`) |
-| `MBreadcrumb` | Path |
-| `MPageContent` / `MPageFilters` / `MPageToolbar` / `MPageHeader` / `MPageSection` / `MPageStat` / `MPagePlaceholder` | Page composition |
-| `MDock` | App dock / launcher, not page actions |
-
-## Actions
-
-`MButton` / `MButtonGroup` (primary `severity="primary"`, danger `severity="danger"`), `MSplitButton` (main action + menu), `MSpeedDial` (floating action cluster)
-
-## Forms · inputs
-
-`MForm`, `MFormItem`, `MInput`, `MInputPassword`, `MInputNumber`, `MTextarea`, `MInputOtp`, `MInputColor`, `MInputGroup`, `MInputTags`, `MSelect`, `MTreeSelect`, `MCascadeSelect`, `MListbox`, `MSelectButton`, `MDatePicker`, `MAutoComplete`, `MCheckbox` / `MCheckboxGroup`, `MRadio` / `MRadioGroup`, `MSwitch`, `MToggleButton`, `MSlider`, `MRating`, `MKnob`, `MFileUpload`, `MFloatLabel`, `MIconField`, `MLabel`
-
-## Layout helpers
-
-`MGrid` / `MGridItem`, `MFlex`, `MSpace`, `MFluid`, `MDivider`, `MFieldset`, `MSplitter`, `MToolbar`
-
-## Data
-
-`MTable` (`columns` + **`rows`**, not `data`), `MTreeTable`, `MDataView`, `MTree`, `MPagination`, `MOrderList`, `MPickList`, `MStatus` / `MTag` / `MChip` / `MBadge`, `MAvatar` / `MAvatarGroup`, `MTimeline`, `MMeterGroup`, `MVirtualScroller`
-
-## Feedback
-
-| API / component | When | Decision |
-| --- | --- | --- |
-| `message` | **Default** one-line CRUD result | `feedback-choice` |
-| `toast` | `summary` + `detail`, or async / background feel | `feedback-choice` |
-| `<MMessage>` | Optional host for the `message` service. **Not** an inline alert | `feedback-choice` |
-| field `errorMessage` or token `role="alert"` | Persistent form / auth error | `feedback-choice` |
-| `MEmpty` | No-data / first-use / filtered empty | `empty-result-choice` |
-| `MResult` | Terminal outcome: success, failure, 403 / 404 / 500 | `empty-result-choice` |
-| `MLoading` / `v-loading` / `loading.service` | **Default** region or fullscreen loading mask | `loading-choice` |
-| `MSkeleton` | Layout known; placeholder while content arrives | `loading-choice` |
-| `MProgressBar` | Determinate progress | `loading-choice` |
-| `MProgressSpinner` | Inline spinner only, not a region mask | `loading-choice` |
-| `MBlockUI` | Block interaction without a loading message | `loading-choice` |
-
-## Overlays & menus
-
-`MDialog`, `MDrawer`, `MConfirmDialog` / `MConfirmPopup`, `MPopover`, `MTooltip`, `MDropdown` (**actions only**), `MContextMenu`, `MCommandMenu`, `MMenu` / `MMenubar` / `MTieredMenu` / `MMegaMenu`, `MTabs`, `MStepper`
-
-## Surfaces / media
-
-`MCard`, `MPanel`, `MAccordion`, `MCarousel`, `MGallery`, `MIcon`, `MScrollbar`, `MInplace`, `MScrollTop`, `MTerminal`
-
-## Scenario → decision
-
-Open MCP `recommend_component({ decision })` or the matching section in [decision-recipes.md](./decision-recipes.md) for **when / avoid / recipe props / anti-patterns**.
-
-| Intent | Decision id |
-| --- | --- |
-| Create / edit from a list (few–medium fields) vs long form page | `form-surface-choice` |
-| Dialog vs Drawer vs Popover vs Tooltip | `overlay-choice` |
-| Table vs DataView vs Tree / TreeTable | `data-display-choice` |
-| Select vs TreeSelect vs AutoComplete vs Radio / … | `selection-choice` |
-| Card vs Panel vs Fieldset | `surface-choice` |
-| PageContent vs Flex vs Space vs Grid | `layout-spacing-choice` |
-| PageFilters / Toolbar / Header / Section / Stat / Placeholder | `page-section-choice` |
-| Layout scroll vs MScrollbar vs built-in | `page-scroll-choice` |
-| Avoid double borders / extra Card wrappers | `surface-nesting-choice` |
-| Loading vs Skeleton vs Progress* vs BlockUI | `loading-choice` |
-| Status vs Tag vs Chip vs Badge | `status-label-choice` |
-| Empty vs Result | `empty-result-choice` |
-| Dropdown vs Menu vs ContextMenu vs CommandMenu | `action-menu-choice` |
-| message vs toast vs field / form alert | `feedback-choice` |
-| ConfirmDialog vs ConfirmPopup | `confirm-choice` |
-| Searchable list + paging | `page-section-choice` + `data-display-choice` (+ list golden) |
-| Delete / destructive | `confirm-choice` |
-| Login / auth | `feedback-choice` + `login-page` golden |
-| Marketing landing | `landing-page` golden (Express) |
-| Multi-step create | `wizard-form` golden |
-| Preferences / settings | `settings-page` golden |
-| Resizable two-pane | use `MSplitter` (see docs / `get_component`) |
-
-## Common mistakes
-
-| Wrong | Right |
-| --- | --- |
-| `MDropdown` as form enum | `MSelect` (`selection-choice`) |
-| `MTable` `:data` | `:rows` (`data-display-choice`) |
-| `<MMessage severity>` as an inline alert | Field `errorMessage`, or token `role="alert"` (`feedback-choice`) |
-| Hand `<table>` | `MTable` |
-| Hand modal div | `MDialog` / `MConfirmDialog` |
-| Hand spinner or `MProgressSpinner` as a region / page mask | `MLoading` / `v-loading` (`loading-choice`) |
-| Extra `MCard` around every `MPage*` block | `surface-nesting-choice` |
-| Assume undocumented props | MCP / docs lookup + `validate_usage` |
+# Component index (scenario map)
+
+Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_usage`).
+
+- **Selection + key props**: MCP `recommend_component`, or offline [decision-recipes.md](./decision-recipes.md) (generated from `packages/ui-mcp/src/decisions.ts`).
+- This file is a **catalog + decision-id index**, not a prop manual.
+
+## Shell
+
+| Component | Use |
+| --- | --- |
+| `MConfigProvider` | Root locale / theme / density / defaults |
+| `MLayout` family | Admin chrome (`MLayoutSider` is the layout sider) |
+| `MSidebar` | Standalone nav rail (not a `MDrawer`, not a substitute for `MLayoutSider` inside `MLayout`) |
+| `MBreadcrumb` | Path |
+| `MPageContent` / `MPageFilters` / `MPageToolbar` / `MPageHeader` / `MPageSection` / `MPageStat` / `MPagePlaceholder` | Page composition |
+| `MDock` | App dock / launcher, not page actions |
+
+## Actions
+
+`MButton` / `MButtonGroup` (primary `severity="primary"`, danger `severity="danger"`), `MSplitButton` (main action + menu), `MSpeedDial` (floating action cluster)
+
+## Forms · inputs
+
+`MForm`, `MFormItem`, `MInput`, `MInputPassword`, `MInputNumber`, `MTextarea`, `MInputOtp`, `MInputColor`, `MInputGroup`, `MInputTags`, `MSelect`, `MTreeSelect`, `MCascadeSelect`, `MListbox`, `MSelectButton`, `MDatePicker`, `MAutoComplete`, `MCheckbox` / `MCheckboxGroup`, `MRadio` / `MRadioGroup`, `MSwitch`, `MToggleButton`, `MSlider`, `MRating`, `MKnob`, `MFileUpload`, `MFloatLabel`, `MIconField`, `MLabel`
+
+## Layout helpers
+
+`MGrid` / `MGridItem`, `MFlex`, `MSpace`, `MFluid`, `MDivider`, `MFieldset`, `MSplitter`, `MToolbar`
+
+## Data
+
+`MTable` (`columns` + **`rows`**, not `data`), `MTreeTable`, `MDataView`, `MTree`, `MPagination`, `MOrderList`, `MPickList`, `MStatus` / `MTag` / `MChip` / `MBadge`, `MAvatar` / `MAvatarGroup`, `MTimeline`, `MMeterGroup`, `MVirtualScroller`
+
+## Feedback
+
+| API / component | When | Decision |
+| --- | --- | --- |
+| `message` | **Default** one-line CRUD result | `feedback-choice` |
+| `toast` | `summary` + `detail`, or async / background feel | `feedback-choice` |
+| `<MMessage>` | Optional host for the `message` service. **Not** an inline alert | `feedback-choice` |
+| field `errorMessage` or token `role="alert"` | Persistent form / auth error | `feedback-choice` |
+| `MEmpty` | No-data / first-use / filtered empty | `empty-result-choice` |
+| `MResult` | Terminal outcome: success, failure, 403 / 404 / 500 | `empty-result-choice` |
+| `MLoading` / `v-loading` / `loading.service` | **Default** region or fullscreen loading mask | `loading-choice` |
+| `MSkeleton` | Layout known; placeholder while content arrives | `loading-choice` |
+| `MProgressBar` | Determinate progress | `loading-choice` |
+| `MProgressSpinner` | Inline spinner only, not a region mask | `loading-choice` |
+| `MBlockUI` | Block interaction without a loading message | `loading-choice` |
+
+## Overlays & menus
+
+`MDialog`, `MDrawer`, `MConfirmDialog` / `MConfirmPopup`, `MPopover`, `MTooltip`, `MDropdown` (**actions only**), `MContextMenu`, `MCommandMenu`, `MMenu` / `MMenubar` / `MTieredMenu` / `MMegaMenu`, `MTabs`, `MStepper`
+
+## Surfaces / media
+
+`MCard`, `MPanel`, `MAccordion`, `MCarousel`, `MGallery`, `MIcon`, `MScrollbar`, `MInplace`, `MScrollTop`, `MTerminal`
+
+## Scenario → decision
+
+Open MCP `recommend_component({ decision })` or the matching section in [decision-recipes.md](./decision-recipes.md) for **when / avoid / recipe props / anti-patterns**.
+
+| Intent | Decision id |
+| --- | --- |
+| Create / edit from a list (few–medium fields) vs long form page | `form-surface-choice` |
+| Dialog vs Drawer vs Popover vs Tooltip | `overlay-choice` |
+| Table vs DataView vs Tree / TreeTable | `data-display-choice` |
+| Select vs TreeSelect vs AutoComplete vs Radio / … | `selection-choice` |
+| Card vs Panel vs Fieldset | `surface-choice` |
+| PageContent vs Flex vs Space vs Grid | `layout-spacing-choice` |
+| PageFilters / Toolbar / Header / Section / Stat / Placeholder | `page-section-choice` |
+| Layout scroll vs MScrollbar vs built-in | `page-scroll-choice` |
+| Avoid double borders / extra Card wrappers | `surface-nesting-choice` |
+| Loading vs Skeleton vs Progress* vs BlockUI | `loading-choice` |
+| Status vs Tag vs Chip vs Badge | `status-label-choice` |
+| Empty vs Result | `empty-result-choice` |
+| Dropdown vs Menu vs ContextMenu vs CommandMenu | `action-menu-choice` |
+| message vs toast vs field / form alert | `feedback-choice` |
+| ConfirmDialog vs ConfirmPopup | `confirm-choice` |
+| Searchable list + paging | `page-section-choice` + `data-display-choice` (+ list golden) |
+| Delete / destructive | `confirm-choice` |
+| Login / auth | `feedback-choice` + `login-page` golden |
+| Marketing landing | `landing-page` golden (Express) |
+| Multi-step create | `wizard-form` golden |
+| Preferences / settings | `settings-page` golden |
+| Resizable two-pane | use `MSplitter` (see docs / `get_component`) |
+
+## Common mistakes
+
+| Wrong | Right |
+| --- | --- |
+| `MDropdown` as form enum | `MSelect` (`selection-choice`) |
+| `MTable` `:data` | `:rows` (`data-display-choice`) |
+| `<MMessage severity>` as an inline alert | Field `errorMessage`, or token `role="alert"` (`feedback-choice`) |
+| Hand `<table>` | `MTable` |
+| Hand modal div | `MDialog` / `MConfirmDialog` |
+| Hand spinner or `MProgressSpinner` as a region / page mask | `MLoading` / `v-loading` (`loading-choice`) |
+| Extra `MCard` around every `MPage*` block | `surface-nesting-choice` |
+| Assume undocumented props | MCP / docs lookup + `validate_usage` |

package/template/.agents/skills/morya-ui-pages/references/decision-recipes.md

@@ -6,7 +6,7 @@ Generated from `packages/ui-mcp/src/decisions.ts`. **Do not hand-edit** this fil
 pnpm --filter @morya-ui/mcp generate:recipes
 ```
 
-MCP: `recommend_component` (list / read by `decision` / query). Full prop manuals still come from `get_component` + `validate_usage`.
+MCP: `recommend_component` (list / read by `decision` / query; options may include `relatedSnippets`). Full prop manuals still come from `get_component` + `validate_usage`. Prefer page snippets for composition; golden pages are optional block-order checks.
 
 This file is the **offline** mirror for agents without MCP.
 
@@ -31,7 +31,7 @@ This file is the **offline** mirror for agents without MCP.
 
 - v-model / modelValue 控制开关（不要用 visible）
 - header 或 title 设弹窗标题
-- width 约 32rem 适配短表单（见 form-in-dialog 黄金样例）
+- width 约 32rem 适配短表单（见 form-in-dialog snippet）
 - 表单字段用 fluid；主按钮 severity="primary"
 
 **Recipe · slots**
@@ -44,6 +44,11 @@ This file is the **offline** mirror for agents without MCP.
 - @close 重置表单模型
 - 保存可用按钮 @click，或 MForm @submit + type="submit"
 
+**Related snippets**
+
+- `form-in-dialog`
+- `page-header-actions`
+
 **Anti-patterns**
 
 - 用普通 Dialog 手写删除确认 → MConfirmDialog
@@ -77,6 +82,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - @close 清理草稿
 
+**Related snippets**
+
+- `form-in-drawer`
+
 **Anti-patterns**
 
 - 极短 2–3 字段也用 Drawer → Dialog
@@ -110,6 +119,13 @@ This file is the **offline** mirror for agents without MCP.
 - MForm @submit（或 @submit.prevent）
 - 提交按钮 type="submit" + severity="primary"
 
+**Related snippets**
+
+- `page-content-form`
+- `form-header`
+- `form-body`
+- `form-actions`
+
 **Anti-patterns**
 
 - 列表短 CRUD 开独立路由 → form-in-dialog
@@ -151,6 +167,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - @close / @update:modelValue
 
+**Related snippets**
+
+- `form-in-dialog`
+
 **Anti-patterns**
 
 - Dialog + 手写「确定删除」→ MConfirmDialog
@@ -184,6 +204,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - @close
 
+**Related snippets**
+
+- `form-in-drawer`
+
 **Anti-patterns**
 
 - 简单 Yes/No 确认用 Drawer → ConfirmDialog / ConfirmPopup
@@ -727,17 +751,30 @@ This file is the **offline** mirror for agents without MCP.
 
 **Recipe · props**
 
-- 内放 MInput / MSelect 等筛选控件
-- 可 collapsible + #advanced
-- 不要外包 MCard
+- 内放 MInput / MSelect；同行用 MSpace wrap
+- 查询/重置放 #actions（与折叠切换同列）
+- 默认 variant="filled"；dense craft 用 plain + size="small"
+- 有次要条件：collapsible + v-model:expanded + #advanced
+- toggle 默认「高级筛选/收起」+ chevron；已选用 FilterChips
 
 **Recipe · slots**
 
+- #actions 查询/重置
 - #advanced 高级筛选
+- #active 可选；更常见是下方 FilterChips
+
+**Related snippets**
+
+- `list-filters-stack`
+- `list-filters`
+- `list-filters-collapsible`
+- `list-filter-chips`
+- `list-filters-dense`
 
 **Anti-patterns**
 
 - 表单字段组用 PageFilters → PageSection form / Fieldset
+- 手写已选条 → list-filter-chips / list-filters-stack
 
 
 ### PageToolbar
@@ -1299,6 +1336,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - #extra 放下一步按钮（创建…）
 
+**Related snippets**
+
+- `empty-block`
+
 **Anti-patterns**
 
 - 403/404 用 Empty → Result
@@ -1328,6 +1369,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - #footer 逃逸/下一步按钮
 
+**Related snippets**
+
+- `result-block`
+
 **Anti-patterns**
 
 - 表格无数据用 Result → Empty
@@ -1358,6 +1403,11 @@ This file is the **offline** mirror for agents without MCP.
 - 触发器放默认插槽（按钮/图标）
 - 危险项用文档 severity / 确认流
 
+**Related snippets**
+
+- `row-actions-menu`
+- `list-row-actions`
+
 **Anti-patterns**
 
 - 表单枚举用 Dropdown → Select
@@ -1475,6 +1525,11 @@ This file is the **offline** mirror for agents without MCP.
 - message.success('已保存') / info / warn / error
 - 大多数操作反馈的默认选择
 
+**Related snippets**
+
+- `confirm-delete`
+- `form-in-dialog`
+
 **Anti-patterns**
 
 - toast.add({ summary: '已保存' }) → message.success('已保存')
@@ -1520,6 +1575,10 @@ This file is the **offline** mirror for agents without MCP.
 - 表单级：token 样式的 role="alert" 条（见 login-page）
 - <MMessage> 只是 message 宿主，不是内嵌 Alert
 
+**Related snippets**
+
+- `auth-split-shell`
+
 **Anti-patterns**
 
 - 登录失败只闪 Toast → 表单区 alert / errorMessage
@@ -1557,6 +1616,10 @@ This file is the **offline** mirror for agents without MCP.
 - @accept 执行删除
 - @reject 关闭
 
+**Related snippets**
+
+- `confirm-delete`
+
 **Anti-patterns**
 
 - 普通 Dialog 手写「确定/取消」删除 → ConfirmDialog
@@ -1586,6 +1649,10 @@ This file is the **offline** mirror for agents without MCP.
 
 - @accept / @reject
 
+**Related snippets**
+
+- `confirm-delete`
+
 **Anti-patterns**
 
 - 无 target 的全局危险确认 → ConfirmDialog