@morya-ui/setup 0.3.4 → 0.3.5

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

@@ -3,68 +3,68 @@
   "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.",
+      "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 golden: narrow MPageContent, MPageHeader, MPageSection form/actions, MForm + MSelect/MDatePicker, message for success if shown, one primary, no landing hero.",
+      "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: MPageStat grid with domain labels, MCard shadow=always + MEmpty chart pending, recent MTable with MStatus, MLayout shell, --m-* only, spacious density.",
+      "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: 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.",
+      "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: MPageHeader + MEmpty + next-action MButton, short copy, no custom dashed/radial shell, fits list content slot.",
+      "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-*，避免紫渐变和奶油衬线陶土那套 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.",
+      "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: wizard-form golden — MStepper :steps, per-step MForm, MInputTags invites, clear next/back/submit, message success, validate_usage clean.",
+      "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: result-page golden — MResult status=403, #footer escape actions, no jokey 404 essay, on-token, validate_usage clean.",
+      "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 golden structure.",
+      "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，对齐详情黄金样例，不要做成落地页。",
-      "expected_output": "Ops detail: MPageHeader + MStatus, property MCard, related MTable rows, --m-* only, no marketing hero.",
+      "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: list stays, MDialog + MForm + #footer, message.success not toast string, MTable rows.",
+      "expected_output": "form-in-dialog snippet: list stays, MDialog + MForm + #footer, message.success not toast string, MTable rows.",
       "files": []
     },
     {
@@ -76,13 +76,13 @@
     {
       "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.",
+      "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-surface Dialog recipe: v-model not visible, #footer actions, fluid fields, message.success.",
+      "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/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

package/template/.agents/skills/morya-ui-pages/references/optional-companions.md

@@ -1,107 +1,62 @@
 # Optional companions (craft bridge)
 
-`morya-ui-pages` is **standalone**: contract + golden structure + [visual-craft.md](visual-craft.md) + [style-presets.md](style-presets.md) are enough to ship.
+`morya-ui-pages` is **standalone**: contract + page snippets / decision recipes + block-order checklists + [visual-craft.md](visual-craft.md) + [style-presets.md](style-presets.md) are enough. Golden pages are optional structure demos. **No named style-preset catalog.**
 
-Installed market skills (**Frontend Design**, **Impeccable**, **UI-UX-Pro-Max**, **fixing-accessibility**, …) are **soft upgrades**. Use them to raise taste and polish — **never** to replace `M*` / `--m-*` / golden layouts / MCP APIs.
+Installed market skills are **soft upgrades** — never replace `M*` / `--m-*` / page-layout block order / MCP / the **user’s** style direction.
 
 ## Conflict rule (hard)
 
-Whenever a companion conflicts with this skill, project `DESIGN.md`, or MCP (`get_component` / `validate_usage`):
-
 **morya-ui-pages + DESIGN.md + MCP win.**
 
-Forbidden outcomes from any companion:
+Forbidden from any companion:
 
-- Second UI kit (shadcn / Element / Ant / raw HTML “design system”)
-- Invented `M*` props or parallel token hex soup
-- Replacing Ops golden shell with a marketing hero “to look less stiff”
-- Replacing library overlays with custom ARIA widgets (unless fixing-accessibility is only auditing names/focus on top of `M*`)
+- Second UI kit  
+- Invented `M*` props or hex soup  
+- Replacing Ops block-order shell with a marketing hero  
+- Custom ARIA widgets replacing library overlays  
+- **Unearned AI atmosphere** the user did not ask for (aurora, cream-serif-terracotta, dual neon, frosted glass, neumorph on dense tables)  
+- Overriding an explicit user reference or description  
 
-## When to load which companion
+## When to load
 
-| Need | Prefer companion | After / instead use distilled |
+| Need | Prefer companion | Else |
 | --- | --- | --- |
-| Express / landing / branded login panel — distinctive POV | `frontend-design` | [visual-craft.md](visual-craft.md) § Design plan + anti-defaults |
-| Named polish / audit / bolder / quieter / typeset / delight | `impeccable` (`polish`, `bolder`, `quieter`, …) | [visual-craft.md](visual-craft.md) § Polish modes |
-| Industry / mood / palette keywords for Express | `ui-ux-pro-max` (search only) | [style-presets.md](style-presets.md) heuristics + visual-craft mood |
-| a11y names, keyboard, focus, forms | `fixing-accessibility` | review-checklist a11y + MCP validate |
-| Routine Ops CRUD | **none** — style preset + Ops polish | [style-presets.md](style-presets.md) |
-
-### Load budget
-
-- Default: **morya-ui-pages only**
-- Max one **visual** companion per task (`frontend-design` **or** `impeccable` **or** `ui-ux-pro-max`)
-- a11y companion may stack **after** visual pass (pages → one visual → optional a11y)
-- If absent: **do not** ask the user to install mid-task; use distilled craft and continue
-
-## Mode bridge (Impeccable → morya lanes)
-
-| Impeccable mode | morya lane | What companion may change | What stays locked |
-| --- | --- | --- | --- |
-| **Operate** | Ops / System / most Settings | Density, hierarchy, copy verbs, chrome polish, style preset | Golden block order, `MTable`/`MPage*`, feedback API |
-| **Persuade** | Express / marketing CTA | Design plan, signature, type/atmosphere | Controls still `M*`; colors map to `--m-*` |
-| **Read** | Docs chrome / long detail | Typeset, spacing, reading measure | No second kit |
-| **Experience** | Gallery / showcase | Artifact-first layout | Interactive chrome still `M*` |
-
-Pick the mode from the **surface**, not the company name (a tool’s landing page is still Persuade).
-
-## Frontend Design bridge (Express & brand moments)
-
-When `frontend-design` is available **or** you are on Express / branded Account:
+| Express / brand POV | `frontend-design` | visual-craft design plan |
+| Named polish / audit / bolder / quieter | `impeccable` | visual-craft polish modes |
+| Mood keywords | `ui-ux-pro-max` (search only) | infer from prompt → `--m-*` |
+| a11y | `fixing-accessibility` | review-checklist |
+| Routine Ops | **none** | Ops polish + resolved direction |
 
-1. **Ground the subject** — concrete product, audience, single job (same as this skill step 1).
-2. **Short design plan** before code — color roles, type roles, layout concept, **one** signature risk.
-3. **Critique the plan** — if it matches the plan you’d write for any SaaS, revise for **this** subject.
-4. **Anti-defaults** — do not spend free axes on cream+serif+terracotta / acid-green dark / broadsheet / purple gradient (see visual-craft).
-5. **Remediate with morya-ui** — implement the plan using `M*` + `--m-*` / `color-mix`; do not introduce Inter-as-display on Express when the brief allows character **unless** the project theme already fixes fonts.
+Load budget: max one visual companion; a11y may follow. If absent, do not ask to install mid-task.
 
-Ops lists: Frontend Design may inform **copy tone and hierarchy**, not a new scaffold aesthetic.
+## Frontend Design bridge
 
-## Impeccable bridge (polish commands)
+1. Ground subject / audience / job.  
+2. Resolve style direction first ([style-presets.md](style-presets.md)).  
+3. Short design plan; signature fits the **user’s** words.  
+4. Strip AI-default faces unless the user asked.  
+5. Remediate with `M*` + `--m-*`; flat shells by default.
 
-Map user asks to Impeccable-style passes (run companion if installed; else visual-craft polish modes):
+## Impeccable bridge
 
-| User intent | Pass | morya constraint |
+| User intent | Pass | Constraint |
 | --- | --- | --- |
-| 太平 / 太呆板 / 大胆一点 | `bolder` | Amplify **one** signature or style preset (`studio`/`rail`); keep Ops golden |
-| 太花 / 太吵 | `quieter` | Remove competing accents; keep one primary |
-| 提交前收一遍 | `polish` | Ops polish + style preset cues + a11y basics |
-| 文案/空态/错误看不懂 | `clarify` | Domain verbs; `MEmpty` / `errorMessage` |
-| 字阶乱 | `typeset` | Theme font tokens; no random CDN font stacks on Ops |
-| 加点微交互 | `delight` / `animate` | 1–2 moments; `useMotion` / `data-m-motion` |
-| 无障碍 | `audit` + fixing-accessibility | Labels on `M*`; don’t replace Dialog/Menu |
+| 太平 / 大胆一点 | `bolder` | One signature inside current direction; ask before changing the whole face |
+| 太花 / 太像 AI | `quieter` | Strip unearned gradients / glow / glass |
+| 提交前 | `polish` | Ops polish + direction + a11y basics |
+| 文案 | `clarify` | Domain verbs |
+| 微交互 | `delight` | 1–2 moments; `useMotion` |
 
-**Brief wins** (Impeccable): if the user pinned a reference or named a [style preset](style-presets.md), do not redirect toward companion taste.
+**Brief wins.**
 
-## UI-UX-Pro-Max bridge (mood only)
-
-Safe: search mood / industry / palette **keywords**, then map onto `--m-*` roles and a style preset.
-
-Unsafe: adopting suggested React/Tailwind/shadcn stacks, GSAP-heavy landing kits, or chart libraries that replace `M*` patterns.
-
-## Combined workflow (pages + companions)
+## Combined workflow
 
 ```text
-1. Style direction   → reference → preset → cues → ask  ([style-presets.md](style-presets.md))
-2. Structure         → recommend_page / get_golden_page  (MCP)
-3. Contract          → recommend_component / get_component / validate_usage
-4. Craft             → visual-craft Ops polish or Express design plan
-5. Companion (opt.)  → frontend-design (Express) OR impeccable polish command
-6. a11y (opt.)       → fixing-accessibility
+1. Style direction   → user reference/description → cues → ask if uncertain
+2. Compose           → recommend_page.suggestedSnippets / get_page_snippet + recommend_component
+3. Optional structure → get_golden_page only for whole-page block-order check
+4. Contract          → get_component / validate_usage
+5. Craft             → visual-craft (flat shells by default)
+6. Companion (opt.)  → deepen inside the resolved direction
 7. Gate              → validate_usage + validate_page
 ```
-
-## Install via setup
-
-```bash
-npx @morya-ui/setup ai
-npx @morya-ui/setup ai --skills=morya-ui-pages,frontend-design,impeccable,fixing-accessibility
-npx @morya-ui/setup ai --skills=all
-```
-
-| Companion | Source | Safe use | Unsafe use |
-| --- | --- | --- | --- |
-| `frontend-design` | `anthropics/skills` | Express / brand panel POV after surface + contract fixed | Replacing Ops golden shell; second UI kit |
-| `impeccable` | `pbakaus/impeccable` | Operate/Persuade polish passes aligned with visual-craft | New token schema; swap `M*` for raw controls |
-| `ui-ux-pro-max` | local / marketplace | Mood & industry keywords for Express | Stack swap; ignoring morya tokens |
-| `fixing-accessibility` | `ibelick/ui-skills` | Names, keyboard, focus on top of `M*` | Custom ARIA widgets replacing library overlays |

package/template/.agents/skills/morya-ui-pages/references/page-layouts.md

@@ -1,46 +1,46 @@
 # Page layouts
 
-When generating a full page, pick a type and **mirror the golden-page block order**. Source: MCP `get_golden_page`.
-
-| Type | `get_golden_page` id |
-| --- | --- |
-| List (structure · soft) | `list-page` |
-| List · dense craft | `list-page-dense` |
-| List · rail craft | `list-page-rail` |
-| Form (long / dedicated) | `form-page` |
-| List create/edit dialog | `form-in-dialog` |
-| Detail | `detail-page` |
-| Dashboard | `dashboard-page` |
-| Login | `login-page` |
-| Landing | `landing-page` |
-| Empty | `empty-state` |
-| Result / 403 / terminal | `result-page` |
-| Settings | `settings-page` |
-| Wizard | `wizard-form` |
-
-Via MCP: `recommend_page({ style? })` → resolves list craft (`dense`→`list-page-dense`, `rail`→`list-page-rail`, else `list-page`) → `get_golden_page`; then apply `styleDirection` (or a user reference). Local edits: `get_page_snippet` (`filters`, `toolbar`, `form-actions`, `scrollable-panel`, …). Styles: `list_style_presets` / `get_style_preset`.
-
-**List craft variants** share the same block order; only density / chrome / copy change. Prefer `recommend_page` style routing over hand-picking unless the user named a variant id.
+When generating a full page, pick a type and follow the **block-order checklist** below. Fill each block with MCP **`get_page_snippet`** / `recommend_page.suggestedSnippets` (composition-first). Optional: `get_golden_page` only to cross-check whole-page order or when the user asks to mirror a golden sample.
+
+Golden pages are **assembly demos / structure baselines**, not the default clone source. Do not add new craft variants (`list-page-*`); density / sider cues inform polish via style direction.
+
+| Type | Checklist below | Optional `get_golden_page` | Typical snippets |
+| --- | --- | --- | --- |
+| List | List page | `list-page` (`list-page-dense` / `list-page-rail` craft only) | `layout-app-shell`, `page-header-actions`, **`list-filters-stack`** (dense → `list-filters-dense`), `list-table`, `form-in-dialog`, `confirm-delete` |
+| Form (long / dedicated) | Form page | `form-page` | `page-content-form`, `form-header`, `form-body`, `form-actions` |
+| List create/edit dialog | List create/edit dialog | `form-in-dialog` | **`form-in-dialog`** (preferred) |
+| Detail | Detail page | `detail-page` | `detail-toolbar`, `form-in-dialog` |
+| Dashboard | Dashboard | `dashboard-page` | `dashboard-kpi-grid`, `dashboard-chart-card`, `dashboard-recent-table` |
+| Login | — (see [surfaces.md](surfaces.md)) | `login-page` | **`auth-split-shell`** |
+| Landing | — (see [surfaces.md](surfaces.md)) | `landing-page` | — |
+| Empty | — | `empty-state` | **`empty-block`** |
+| Result / 403 / terminal | — | `result-page` | **`result-block`** |
+| Settings | Settings page | `settings-page` | `form-header`, `form-body`, `form-actions` |
+| Wizard | Wizard | `wizard-form` | **`wizard-steps`** |
+
+Via MCP: `recommend_page({ style? })` → use **`suggestedSnippets`** + `recommend_component` / `get_page_snippet`; apply `styleDirection` (user reference/description — no preset catalog). Call `get_golden_page` only when needed for block-order check. Style: `get_style_direction`.
+
+**List craft variants** share the same block order; only density / chrome / copy change. Prefer style-direction cues over inventing new golden ids.
 
 ## Product defaults
 
-- **Short create/edit** (about ≤8 fields, single section): same-page `MDialog` + `MForm` — do not invent a new route form for every entity.
-- **Long / multi-section / wizard**: dedicated form page (`form-page`) or `MDrawer`.
+- **Short create/edit** (about ≤8 fields, single section): same-page `MDialog` + `MForm` — snippet `form-in-dialog`; do not invent a new route form for every entity.
+- **Long / multi-section / wizard**: dedicated form page (`form-page`) or `MDrawer` (`form-in-drawer`).
 - **One-line success/error**: `message` API; title + detail or async notify → `toast` (see [feedback.md](feedback.md)).
 
 ## List page — block order
 
-1. `MLayout fillViewport` + optional `MLayoutSider bordered`
+1. `MLayout fillViewport` + optional `MLayoutSider bordered` → snippet `layout-app-shell`
 2. Sider `MMenu` (**every item has `icon`**)
 3. `MLayoutHeader` → `MBreadcrumb`
-4. `MLayoutContent` → `MPageContent` (**add `fill` only when the height rule below applies**)
-5. `MPageHeader` — page title + `#actions` primary (**one** filled primary in viewport)
-6. `MPageFilters` — `variant="filled"` optional; inner `MSpace wrap` + Input/Select + query/reset (query/reset → secondary); optional `collapsible` + `#advanced` for secondary fields
-7. Optional `MPageFilterChips` + closable `MTag` when filters are applied (after filters, before table)
-8. Optional `MPageToolbar` — batch actions only (no page title)
-9. `MTable` directly in content (usually **no** wrapping `MCard`); status → `MStatus`; `#empty` → `MEmpty`
+4. `MLayoutContent` → `MPageContent` (**add `fill` only when the height rule below applies**) → `page-content-list`
+5. `MPageHeader` — page title + `#actions` primary (**one** filled primary in viewport) → `page-header-actions`
+6. `MPageFilters` — 默认 **`list-filters-stack`**（`#actions` 查询/重置 + collapsible「高级筛选/收起」chevron + `#advanced` + FilterChips）；条件少无高级区用 `list-filters`；dense craft 用 `list-filters-dense`
+7. Optional `MPageFilterChips` — 已含在 `list-filters-stack`；单独增量用 `list-filter-chips`
+8. Optional `MPageToolbar` — batch actions only → `list-toolbar` / `list-batch-toolbar`
+9. `MTable` directly in content; status → `MStatus`; `#empty` → `MEmpty` → `list-table` + `list-status-dot` + `empty-block`
 10. Pagination via `MTable paginator` or sibling `MPagination`
-11. Short create/edit → `MDialog` + `MForm` on the same page (default)
+11. Short create/edit → same-page `MDialog` + `MForm` → **`form-in-dialog`**; delete → **`confirm-delete`**
 
 ### List height — decide, don’t always fill
 
@@ -65,17 +65,17 @@ Craft: [visual-craft.md](visual-craft.md) § Ops polish.
 ## Form page — block order
 
 1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
-2. `MPageContent width="narrow"`
-3. `MPageHeader` (title + description)
-4. `MPageSection variant="form"` → `MForm`
-5. `MPageSection variant="actions"` — save (`primary`) + cancel (`secondary`)
+2. `MPageContent width="narrow"` → `page-content-form`
+3. `MPageHeader` (title + description) → `form-header`
+4. `MPageSection variant="form"` → `MForm` → `form-body`
+5. `MPageSection variant="actions"` — save (`primary`) + cancel (`secondary`) → `form-actions`
 
 ## Dashboard — block order
 
 1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
 2. `MPageContent density="spacious"` → `MPageHeader` (title + short domain description when useful)
-3. KPI row: `MGrid` + `MPageStat` (4 columns or responsive) — real metric names, not “Metric 1”
-4. Main split: `MCard shadow="always"` + `MEmpty` (chart pending) and/or recent `MTable` (row status → `MStatus`)
+3. KPI row: `MGrid` + `MPageStat` (4 columns or responsive) — `dashboard-kpi-grid`
+4. Main split: `MCard shadow="always"` + `MEmpty` (chart pending) and/or recent `MTable` — `dashboard-chart-card` / `dashboard-recent-table`
 
 Craft: spacious density + Ops polish; do not turn the first viewport into a marketing hero.
 
@@ -97,22 +97,18 @@ Inline style is acceptable for control widths (e.g. filter `width: 14rem`).
 ## Detail page — block order
 
 1. Same admin chrome as list (breadcrumb → `MPageContent`)
-2. `MPageHeader` — title, `MStatus` in `#actions` (or chip `MTag` for categories), primary/secondary/danger actions
+2. `MPageHeader` — title, `MStatus` in `#actions`, primary/secondary/danger → `detail-toolbar`
 3. Summary `MPageSection` + property `MCard` (definition grid with `--m-*` only)
 4. Related data: `MCard` + `MTable` / tabs / timeline
-5. Short edit → same-page `MDialog` (`form-in-dialog`); long edit → `form-page` / `MDrawer`
-
-Mirror MCP `get_golden_page` `detail-page`.
+5. Short edit → `form-in-dialog`; long edit → form page / `form-in-drawer`
 
 ## List create/edit dialog — block order
 
 1. Stay on the list page (`MPageHeader` + filters/table; optional batch `MPageToolbar`)
-2. `MDialog` ~`28–36rem` + `MForm` fields
+2. `MDialog` ~`28–36rem` + `MForm` fields → snippet **`form-in-dialog`**
 3. Actions in Dialog `#footer` (cancel secondary/text + save primary)
 4. Success → `message.success` one-liner, then close
 
-Mirror MCP `get_golden_page` `form-in-dialog`.
-
 ## Settings page — block order
 
 1. Admin chrome + `MPageContent width="narrow"`
@@ -121,21 +117,17 @@ Mirror MCP `get_golden_page` `form-in-dialog`.
 4. Per tab: `MPageSection variant="form"` + `MForm` + save in `variant="actions"`
 5. Dangerous zone last: `severity="danger"` + confirm
 
-Mirror MCP `get_golden_page` `settings-page`.
-
 ## Wizard — block order
 
 1. Narrow `MPageContent` + `MPageHeader`
-2. `MStepper v-model` + **`:steps`** (not `:items`)
+2. `MStepper v-model` + **`:steps`** (not `:items`) → snippet **`wizard-steps`**
 3. One form/job per step; sticky `上一步` / `下一步` / `创建`
-4. Success → `result-page` / `MResult`
-
-Mirror MCP `get_golden_page` `wizard-form`.
+4. Success → `result-block` / `MResult`
 
 ## Hybrids
 
-- List + row edit dialog → `form-in-dialog` golden (or list golden + dialog body).
-- List + side detail → list + `MDrawer`.
-- Resource detail → `detail-page` golden.
+- List + row edit dialog → `form-in-dialog` snippet on the list.
+- List + side detail → list + `form-in-drawer`.
+- Resource detail → detail checklist + `detail-toolbar`.
 - Settings without admin chrome → still use `MPageContent` + `MPageSection`; omit sider only if the host app already provides chrome.
-- Non-Ops surfaces (auth, landing, empty, wizard) → [surfaces.md](surfaces.md), not these golden orders.
+- Non-Ops surfaces (auth, landing, empty, wizard) → [surfaces.md](surfaces.md) + matching snippets, not Ops list chrome.