@morya-ui/setup 0.3.2 → 0.3.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/setup",
   "type": "module",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "One-shot setup for morya-ui: install the library, Cursor MCP, Agent skills, and design config.",
   "license": "MIT",
   "homepage": "https://github.com/morya-space/morya-ui/tree/main/packages/setup#readme",

package/template/.agents/skills/morya-ui-pages/SKILL.md

@@ -66,7 +66,7 @@ For Express / branded Account moments, also draft a tiny **design plan** (see [v
 | Ops pattern | `recommend_page` → **`get_golden_page`** (mirror; do not invent a parallel scaffold aesthetic) | [page-layouts.md](references/page-layouts.md) |
 | Account / Express / empty / result | `recommend_page` → `get_golden_page` (`login-page` / `landing-page` / `empty-state` / `result-page`) | [surfaces.md](references/surfaces.md) |
 | Visual direction | — | [visual-craft.md](references/visual-craft.md) (Ops polish / atmosphere / anti-defaults) |
-| Components / **API truth** | `search` / **`get_component`** / `get_example` / `recommend_component` | [component-index.md](references/component-index.md) |
+| Components / **API truth** | `search` / **`get_component`** / `get_example` / **`recommend_component`** (includes L2 recipes) | [decision-recipes.md](references/decision-recipes.md) + [component-index.md](references/component-index.md) |
 | Tokens / rules | `get_design_rules` | [design-system.md](references/design-system.md) |
 | Snippet | `get_page_snippet` | golden / surface excerpt |
 | Feedback API | — | [feedback.md](references/feedback.md) |
@@ -85,11 +85,12 @@ For Express / branded Account moments, also draft a tiny **design plan** (see [v
 ### 4. Wire real API usage
 
 - Import from `morya-ui` (or documented subpath + style).
-- Forms: `MForm` + fields; `@submit` + `type="submit"`.
+- **Selection + key props:** call MCP **`recommend_component`** (by query or `decision` id) and apply the returned **recipe** (`props` / `slots` / `events`) and **antiPatterns**. Without MCP, read [decision-recipes.md](references/decision-recipes.md). Then confirm full API with `get_component` / `get_example`.
+- Forms: `MForm` + fields; `@submit` + `type="submit"` (or documented footer button pattern on `form-in-dialog`).
 - Tables: `columns` + `rows` + `row-key`; `#cell-{key}`. There is no `data` prop.
 - Enums → `MSelect` / `MTreeSelect`; action menus → `MDropdown`.
-- Destructive → `MConfirmDialog` / `MConfirmPopup`.
-- Feedback → default **`message`**; `toast` only for summary+detail / async. See [feedback.md](references/feedback.md).
+- Destructive → `MConfirmDialog` / `MConfirmPopup` (`confirm-choice`).
+- Feedback → default **`message`**; `toast` only for summary+detail / async; persistent form errors → `errorMessage` / `role="alert"` (`feedback-choice`). See [feedback.md](references/feedback.md).
 - Motion → intensity with `useMotion` (`full` / `reduced` / `none`); overlay enter/exit with `transition` prop or `createMoryaUI({ motion: { transitions } })` — do not invent a second animation stack. Prefer MCP / docs `motion` guide.
 - **Before craft:** for each unfamiliar or newly written `M*` usage, call MCP **`get_component` / `get_example`**, then **`validate_usage`**. Fix every `unknown-prop` / `unknown-event` before delivery.
 - `recommend_page(includeScaffold: true)` returns the **golden page source** when one exists — remap copy/data only; never treat generated fallback as the visual target.
@@ -156,7 +157,8 @@ Details: [optional-companions.md](references/optional-companions.md). Distilled
 | [page-layouts.md](references/page-layouts.md) | Ops golden layouts |
 | [visual-craft.md](references/visual-craft.md) | Ops polish, atmosphere recipes, anti-defaults, polish modes |
 | [design-system.md](references/design-system.md) | Principles, tokens, bans |
-| [component-index.md](references/component-index.md) | Scenario → component |
+| [component-index.md](references/component-index.md) | Catalog + decision-id index |
+| [decision-recipes.md](references/decision-recipes.md) | Scenario → component → key props (generated; offline MCP mirror) |
 | [feedback.md](references/feedback.md) | message / toast / MMessage |
 | [review-checklist.md](references/review-checklist.md) | Pre-delivery checks |
 | [optional-companions.md](references/optional-companions.md) | Combining with external design skills |

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

@@ -66,6 +66,24 @@
       "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": []
     }
   ]
 }

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

@@ -1,6 +1,9 @@
 # Component index (scenario map)
 
-Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_usage`). This file is for **selection**, not prop manuals.
+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
 
@@ -31,68 +34,66 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 
 ## Feedback
 
-| API / component | When |
-| --- | --- |
-| `message` | **Default** one-line CRUD result |
-| `toast` | `summary` + `detail`, or async / background feel |
-| `<MMessage>` | Optional host for the `message` service (`appendTo` / placement). **Not** an inline alert |
-| field `errorMessage` or token `role="alert"` | Persistent form / auth error |
-| `MEmpty` | No-data / first-use / filtered empty (not an error) |
-| `MResult` | Terminal outcome: success, failure, 403 / 404 / 500 |
-| `MLoading` / `v-loading` / `loading.service` | **Default** region or fullscreen loading mask |
-| `MSkeleton` | Layout is already known; placeholder while content arrives |
-| `MProgressBar` | Determinate progress |
-| `MProgressSpinner` | Inline spinner only, not a region mask |
-| `MBlockUI` | Block interaction without a loading message |
+| 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` (right-click), `MCommandMenu` (searchable command palette), `MMenu` / `MMenubar` / `MTieredMenu` / `MMegaMenu`, `MTabs`, `MStepper`
+`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 → pick
+## 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 | Prefer |
+| Intent | Decision id |
 | --- | --- |
-| Searchable list + paging | `MPageFilters` + `MTable` (+ paginator) |
-| Create / edit from a list (few–medium fields) | **`form-in-dialog`** golden (`MDialog` + `MForm`) |
-| Create / edit long / multi-section entity | Form golden page **or** `MDrawer` |
-| Resource detail / profile | `detail-page` golden |
-| Delete | `MConfirmDialog` |
-| Lightweight inline status | `MStatus` (dot + label) |
-| Status chip / closable label | `MTag` severities |
-| Primary / secondary actions | `MSpace` + `MButton` |
-| Dashboard KPIs | `MGrid` + `MPageStat` |
-| Org tree | `MTree` / `MTreeSelect` |
-| Login / auth | `login-page` golden + `MInputPassword` |
-| Marketing landing | `landing-page` golden + `MButton` / `MTag` / `MAccordion` |
-| Empty list / zero state | `MEmpty` (+ `empty-state` golden or `MTable` `#empty`) |
-| Preferences / settings | `settings-page` golden (`MTabs` + `tabs`) |
-| Multi-step create | `wizard-form` golden (`MStepper` + `steps`) |
-| Region or page is waiting | `MLoading`, `v-loading`, or `loading.service`; known layout → `MSkeleton` |
-| Local capped scroll | Explicit `MScrollbar` |
-| Resizable two-pane (editor / preview, master-detail) | `MSplitter` |
-| Admin sider nav | `MMenu` inside `MLayoutSider` (or `MSidebar` when the shell is not `MLayout`) |
-| Few options, all visible | `MRadio` or `MSelectButton` |
-| Always-visible option list | `MListbox` |
-| Multi-level cascade (not a tree dropdown) | `MCascadeSelect` |
-| Right-click actions | `MContextMenu` |
-| Global command search | `MCommandMenu` |
-| Count or dot on a control | `MBadge` |
-| Removable entity chip | `MChip` |
+| 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` |
-| `MTable` `:data` | `:rows` (`row-key` defaults to `id`) |
-| `<MMessage severity>` as an inline alert | Field `errorMessage`, or a token-styled `role="alert"` |
+| `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` |
-| Hand spinner or `MProgressSpinner` as a region / page mask | `MLoading` / `v-loading` |
-| Extra `MCard` around every `MPage*` block | Use page components' own surface/gap |
-| Assume undocumented props | MCP / docs lookup |
+| 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` |