@morya-ui/setup 0.3.5 → 0.3.6

package/template/.agents/skills/morya-ui-pages/references/visual-craft.md

@@ -1,129 +1,131 @@
-# Visual craft (distilled)
-
-Portable craft for morya-ui consumers. Inspired by **Frontend Design**, **Impeccable**, and **UI-UX-Pro-Max** — without requiring those skills. Still honor the morya-ui contract. **No named style-preset catalog.**
-
-## When to lean on craft
-
-| Lane | Craft intensity | Default pass |
-| --- | --- | --- |
-| Ops CRUD | Low — clarity, density, golden structure | **Always** run § Ops polish |
-| Account / Flow / System | Medium — trust, hierarchy, one calm brand cue | **Always** run § Shell recipes when relevant |
-| Express | High — design plan + one signature risk | **Always** run design plan + anti-defaults |
-
-**Style is not fixed to the golden look.** Resolve direction first ([style-presets.md](style-presets.md)): **user reference / description → prompt cues → ask when uncertain**.
-
-## Companion bridge (distilled)
-
-Run companions **after** structure + contract + **resolved style direction**, then remediate with `M*` + `--m-*`.
-
-### Subject first (Frontend Design)
-
-- Name **subject**, **audience**, **single job** before visual choices.
-- Personality from the subject’s world — not a generic “SaaS aurora” board.
-- **One signature** per surface; everything else quieter.
-- Signature = type / layout / product artifact / motion — **not** a default gradient wash.
-
-### Mode (Impeccable)
-
-| Mode | Use when | Craft budget |
-| --- | --- | --- |
-| **Operate** | Ops lists, forms, settings | Clarity, density, resolved direction; no marketing hero |
-| **Persuade** | Landing, pricing | Design plan + signature; controls still `M*` |
-| **Read** | Docs / long detail | Typeset + measure |
-| **Experience** | Gallery / showcase | Artifact leads |
-
-### Design plan (Express & branded Account)
-
-1. **Color** — roles mapped to `--m-*`. Companions may suggest hex — **map** to tokens.
-2. **Type** — Ops stick to theme fonts.
-3. **Layout** — one sentence + hierarchy.
-4. **Signature** — one memorable element that fits the **user’s** direction.
-
-If the plan looks like any-SaaS (purple wash, cream serif, neon glow) and the user did not ask for that, revise. **User reference / words win.**
-
-## Ops polish (baseline)
-
-1. **One primary** filled button in the main viewport.
-2. **Sider icons** on every top-level `MMenu` item.
-3. **Status** → `MStatus`; `MTag` for categories/filters only.
-4. **Row actions** — text / outlined / small.
-5. **Filter rhythm** — search ~`14rem`, selects ~`10–12rem`.
-6. **Empty** — `MEmpty` with next action.
-7. **No extra cards** around filters/table “for polish”.
-8. **Domain copy**.
-9. **Density** — follow user cues (`compact` / spacious); don’t invent a second scale.
-10. **Quiet chrome** — no marketing heroes / glow unless the user asked.
-
-Ops beauty = alignment + semantics + restraint, **not** gradients.
-
-## Anti-default looks
-
-Unless the user **asks** or a reference **shows** them, do not use:
-
-1. Cream + serif + terracotta  
-2. Acid-green / dual neon on black  
-3. Broadsheet newspaper columns  
-4. Purple aurora / mesh washes (even via `color-mix`)  
-5. Glow stacks, pill clouds, emoji decoration  
-6. Unsolicited glass, neumorph on dense tables, full-page gradients  
-7. Stacked radial + linear “atmosphere” brand panels  
-
-**Token gradients are not a free pass** — only when the user/reference asks.
-
-## Shell recipes (token-only — defaults are flat)
-
-### Account — split brand panel
-
-```css
-.login-brand {
-  display: flex;
-  flex-direction: column;
-  justify-content: flex-end;
-  gap: var(--m-space-4);
-  padding: clamp(2rem, 6vw, 4.5rem);
-  background: color-mix(in srgb, var(--m-color-primary) 12%, var(--m-color-surface));
-  border-right: 1px solid var(--m-color-border);
-}
-```
-
-### Express — hero plane
-
-```css
-.landing-hero__visual {
-  margin-top: var(--m-space-5);
-  padding: var(--m-space-5);
-  border: 1px solid var(--m-color-border);
-  border-radius: var(--m-radius-md);
-  background: var(--m-color-surface);
-}
-```
-
-### Flow — empty shell
-
-Prefer stock `MEmpty`. Optional light frame:
-
-```css
-.empty-state-shell {
-  border: 1px dashed var(--m-color-border);
-  border-radius: var(--m-radius-md);
-  background: var(--m-color-surface);
-  padding: var(--m-space-6);
-}
-```
-
-If the user asked for glass / gradient / dark-tech, implement **that** request with `--m-*` — do not escalate into AI mesh.
-
-## Polish modes (Impeccable-inspired)
-
-| Mode | Intent |
-| --- | --- |
-| `quieter` | Strip competing accents **and unearned gradients/glow/glass** |
-| `bolder` | Strengthen one signature **inside** the user’s direction — do not invent a new face |
-| `polish` / `clarify` / `typeset` / `adapt` / `delight` | As named |
-
-## Quality floor
-
-- Responsive, focus visible, keyboard to primary actions  
-- No raw hex theme colors  
-- Craft pass done; MCP `validate_usage` / `validate_page` when available  
-- No unearned AI atmosphere  
+# Visual craft (distilled)
+
+Portable craft for morya-ui consumers. Inspired by **Frontend Design**, **Impeccable**, and **UI-UX-Pro-Max** — without requiring those skills. Still honor the morya-ui contract. **No named style-preset catalog.**
+
+## When to lean on craft
+
+| Lane | Craft intensity | Default pass |
+| --- | --- | --- |
+| Ops CRUD | Low — clarity, density, golden structure | **Always** run § Ops polish |
+| Account / Flow / System | Medium — trust, hierarchy, one calm brand cue | **Always** run § Shell recipes when relevant |
+| Express | High — design plan + one signature risk | **Always** run design plan + anti-defaults |
+
+**Style is not fixed to the golden look.** Resolve direction first ([style-presets.md](style-presets.md)): **user reference / description → prompt cues → ask when uncertain**.
+
+## Companion bridge (distilled)
+
+Run companions **after** structure + contract + **resolved style direction**, then remediate with `M*` + `--m-*`.
+
+### Subject first (Frontend Design)
+
+- Name **subject**, **audience**, **single job** before visual choices.
+- Personality from the subject’s world — not a generic “SaaS aurora” board.
+- **One signature** per surface; everything else quieter.
+- Signature = type / layout / product artifact / motion — **not** a default gradient wash.
+
+### Mode (Impeccable)
+
+| Mode | Use when | Craft budget |
+| --- | --- | --- |
+| **Operate** | Ops lists, forms, settings | Clarity, density, resolved direction; no marketing hero |
+| **Persuade** | Landing, pricing | Design plan + signature; controls still `M*` |
+| **Read** | Docs / long detail | Typeset + measure |
+| **Experience** | Gallery / showcase | Artifact leads |
+
+### Design plan (Express & branded Account)
+
+1. **Color** — roles mapped to `--m-*`. Companions may suggest hex — **map** to tokens.
+2. **Type** — Ops stick to theme fonts.
+3. **Layout** — one sentence + hierarchy.
+4. **Signature** — one memorable element that fits the **user’s** direction.
+
+If the plan looks like any-SaaS (purple wash, cream serif, neon glow) and the user did not ask for that, revise. **User reference / words win.**
+
+## Ops polish (baseline)
+
+1. **One primary** filled button in the main viewport.
+2. **Sider icons** on every top-level `MMenu` item.
+3. **Status** → `MStatus`; `MTag` for categories/filters only.
+4. **Row actions** — text / outlined / small.
+5. **Filter rhythm** — search ~`14rem`, selects ~`10–12rem`.
+6. **Empty** — `MEmpty` with next action.
+7. **No extra cards** around filters/table “for polish”.
+8. **Domain copy**.
+9. **Density** — follow user cues (`compact` / spacious); don’t invent a second scale.
+10. **Quiet chrome** — no marketing heroes / glow unless the user asked.
+
+Ops beauty = alignment + semantics + restraint, **not** gradients.
+
+## Anti-default looks
+
+Unless the user **asks** or a reference **shows** them, do not use:
+
+1. Cream + serif + terracotta  
+2. Acid-green / dual neon on black  
+3. Broadsheet newspaper columns  
+4. Purple aurora / mesh washes (even via `color-mix`)  
+5. Glow stacks, pill clouds, emoji decoration  
+6. Unsolicited glass, neumorph on dense tables, full-page gradients  
+7. Stacked radial + linear “atmosphere” brand panels  
+
+**Token gradients are not a free pass** — only when the user/reference asks.
+
+## Shell recipes (token-only — defaults are flat)
+
+Prefer MCP **`get_style_shells`** for pasteable CSS (`account-split`, `account-centered`, `express-hero`, `flow-empty-frame`, `flow-result-hero`, `ops-quiet`). Below are the same defaults for offline use.
+
+### Account — split brand panel (`account-split`)
+
+```css
+.login-brand {
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-end;
+  gap: var(--m-space-4);
+  padding: clamp(2rem, 6vw, 4.5rem);
+  background: color-mix(in srgb, var(--m-color-primary) 12%, var(--m-color-surface));
+  border-right: 1px solid var(--m-color-border);
+}
+```
+
+### Express — hero plane (`express-hero`)
+
+```css
+.landing-hero__visual {
+  margin-top: var(--m-space-5);
+  padding: var(--m-space-5);
+  border: 1px solid var(--m-color-border);
+  border-radius: var(--m-radius-md);
+  background: color-mix(in srgb, var(--m-color-primary) 8%, var(--m-color-surface));
+}
+```
+
+### Flow — empty shell (`flow-empty-frame`)
+
+Prefer stock `MEmpty`. Optional light frame:
+
+```css
+.empty-state-shell {
+  border: 1px dashed var(--m-color-border);
+  border-radius: var(--m-radius-md);
+  background: var(--m-color-surface);
+  padding: var(--m-space-6);
+}
+```
+
+If the user asked for glass / gradient / dark-tech, implement **that** request with `--m-*` — do not escalate into AI mesh. Brand palette changes belong in theme overrides (project `DESIGN.md` § 主题覆盖).
+
+## Polish modes (Impeccable-inspired)
+
+| Mode | Intent |
+| --- | --- |
+| `quieter` | Strip competing accents **and unearned gradients/glow/glass** |
+| `bolder` | Strengthen one signature **inside** the user’s direction — do not invent a new face |
+| `polish` / `clarify` / `typeset` / `adapt` / `delight` | As named |
+
+## Quality floor
+
+- Responsive, focus visible, keyboard to primary actions  
+- No raw hex theme colors  
+- Craft pass done; MCP `validate_usage` / `validate_page` when available  
+- No unearned AI atmosphere  

package/template/.cursor/rules/coding-style.mdc

@@ -1,41 +1,41 @@
----
-description: Vue 3 + TypeScript 业务代码风格（Morya UI 项目）
-globs: "**/*.{ts,vue}"
-alwaysApply: false
----
-
-# 编码风格
-
-## Vue
-
-- 使用 `<script setup lang="ts">`。
-- 组件名 PascalCase；模板中用 `M*` 前缀组件。
-- `v-model` 与组件库 emit 对齐（如 `v-model:page`）。
-- 页面级样式 `scoped`；仅使用 `--m-*` 与设计令牌。
-
-## TypeScript
-
-- Props/emit 显式类型；避免 `any`。
-- 异步提交：`loading` ref + `try/finally`。
-
-## 文件组织
-
-```text
-src/
-  views/          # 路由页面
-  components/     # 业务组件
-  composables/    # 复用逻辑
-  api/            # 请求层
-```
-
-## 命名
-
-- 页面：`UserListView.vue` / `UserFormView.vue`
-- 路由 path kebab-case：`/users/create`
-
-## 检查
-
-```bash
-pnpm check:colors   # 裸色值扫描
-pnpm typecheck
-```
+---
+description: Vue 3 + TypeScript 业务代码风格（Morya UI 项目）
+globs: "**/*.{ts,vue}"
+alwaysApply: false
+---
+
+# 编码风格
+
+## Vue
+
+- 使用 `<script setup lang="ts">`。
+- 组件名 PascalCase；模板中用 `M*` 前缀组件。
+- `v-model` 与组件库 emit 对齐（如 `v-model:page`）。
+- 页面级样式 `scoped`；仅使用 `--m-*` 与设计令牌。
+
+## TypeScript
+
+- Props/emit 显式类型；避免 `any`。
+- 异步提交：`loading` ref + `try/finally`。
+
+## 文件组织
+
+```text
+src/
+  views/          # 路由页面
+  components/     # 业务组件
+  composables/    # 复用逻辑
+  api/            # 请求层
+```
+
+## 命名
+
+- 页面：`UserListView.vue` / `UserFormView.vue`
+- 路由 path kebab-case：`/users/create`
+
+## 检查
+
+```bash
+pnpm check:colors   # 裸色值扫描
+pnpm typecheck
+```

package/template/.cursor/rules/component-usage.mdc

@@ -1,41 +1,41 @@
----
-description: Morya UI 组件用法与选型（Vue 业务代码）
-globs: src/**/*.vue
-alwaysApply: false
----
-
-# 组件用法
-
-## 引入
-
-```ts
-import { MButton, MInput } from 'morya-ui'
-// 按需：import MButton from 'morya-ui/button'
-//        import 'morya-ui/button/style'
-```
-
-## 必选模式
-
-- 表单：`MForm` + `MFormItem` + 字段组件；提交用 `@submit` + `type="submit"`。
-- 表格：`MTable` 的 `columns` + `rows` + `row-key`；单元格用 `#cell-{key}` 插槽。没有 `data` prop。
-- 浮层：详情/编辑 `MDialog`；侧栏 `MDrawer`；删除确认 `MConfirmDialog`。
-- 反馈（**默认 Message**）：
-  - 单行操作结果 → `message.success/info/warn/error('…')`
-  - 有标题 + 详情 / 异步通知 → `toast.*({ summary, detail })`
-  - 表单区常驻错误 → 字段 `errorMessage`，或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主，不是内嵌 Alert）
-  - 详见 skill `references/feedback.md`
-
-## Props 约定
-
-- 尺寸：`size="small" | "large"`（默认 medium）。
-- 危险：`severity="danger"` 或 `invalid` + `errorMessage`。
-- 清除：优先 `clearable`（Select 亦支持 `showClear` 别名）。
-- 宽度：表单字段 `fluid`；页面级宽度用 layout CSS + `max-width`。
-
-## 禁止
-
-- 同一页面混用其他 UI 库。
-- 用 `MDropdown` 代替 Select 做枚举选择。
-- 手写 table/modal 替代 `MTable` / `MDialog`。
-
-完整清单：MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。
+---
+description: Morya UI 组件用法与选型（Vue 业务代码）
+globs: src/**/*.vue
+alwaysApply: false
+---
+
+# 组件用法
+
+## 引入
+
+```ts
+import { MButton, MInput } from 'morya-ui'
+// 按需：import MButton from 'morya-ui/button'
+//        import 'morya-ui/button/style'
+```
+
+## 必选模式
+
+- 表单：`MForm` + `MFormItem` + 字段组件；提交用 `@submit` + `type="submit"`。
+- 表格：`MTable` 的 `columns` + `rows` + `row-key`；单元格用 `#cell-{key}` 插槽。没有 `data` prop。
+- 浮层：详情/编辑 `MDialog`；侧栏 `MDrawer`；删除确认 `MConfirmDialog`。
+- 反馈（**默认 Message**）：
+  - 单行操作结果 → `message.success/info/warn/error('…')`
+  - 有标题 + 详情 / 异步通知 → `toast.*({ summary, detail })`
+  - 表单区常驻错误 → 字段 `errorMessage`，或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主，不是内嵌 Alert）
+  - 详见 skill `references/feedback.md`
+
+## Props 约定
+
+- 尺寸：`size="small" | "large"`（默认 medium）。
+- 危险：`severity="danger"` 或 `invalid` + `errorMessage`。
+- 清除：优先 `clearable`（Select 亦支持 `showClear` 别名）。
+- 宽度：表单字段 `fluid`；页面级宽度用 layout CSS + `max-width`。
+
+## 禁止
+
+- 同一页面混用其他 UI 库。
+- 用 `MDropdown` 代替 Select 做枚举选择。
+- 手写 table/modal 替代 `MTable` / `MDialog`。
+
+完整清单：MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。

package/template/.cursor/rules/design-system.mdc

@@ -1,17 +1,18 @@
----
-description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md。
-alwaysApply: true
----
-
-# Morya UI 设计系统
-
-1. **先读** 项目根目录 `DESIGN.md`。组件选型用 MCP `recommend_component`（含 recipe + `relatedSnippets`），或 skill `references/decision-recipes.md` / `component-index.md`。
-2. **只用** `morya-ui` 的 `M*` 组件；全局样式 `morya-ui/styles.css`。
-3. **颜色/间距/圆角** 使用 `--m-*` CSS 变量，禁止裸 hex/rgb（见 `scripts/check-raw-colors.mjs`）。
-4. **页面组装（composition-first）**：用 MCP `recommend_page` → `suggestedSnippets` / `get_page_snippet` + `recommend_component` 拼装；`page-layouts` 块顺序作 checklist。`get_golden_page` **可选**（核对整页块顺序或用户明确要求对齐样例时）。**视觉方向**：有明确参考或明确描述 → 必须跟用户；提示词有清晰线索 → 推断并说明；不确定 → 先问（`get_style_direction`）。**没有命名风格预设表。** 禁止未询问就套 AI 默认渐变/霓虹/毛玻璃。已安装 `frontend-design` / `impeccable` 时只加深已定方向，**不得**换组件库或推翻块顺序 / 用户指定。
-5. **表单选项** 用 `MSelect` / `MTreeSelect`；**动作菜单** 用 `MDropdown`。
-6. 不确定 API 时查文档站或 MCP `get_component`，**禁止臆造 prop**；写完后必须 `validate_usage`。
-7. 根节点用 `MConfigProvider`；后台布局用 `MLayout` 系列。
-8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用字段 `errorMessage` 或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主）。见 skill `references/feedback.md`。
-
-Token / 风格 / companion：MCP `get_design_rules`、`get_style_direction`；skill `optional-companions.md`（运行时以 `morya-ui/styles.css` 为准）
+---
+description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md。
+alwaysApply: true
+---
+
+# Morya UI 设计系统
+
+1. **先读** 项目根目录 `DESIGN.md`。组件选型用 MCP `recommend_component`（含 recipe + `relatedSnippets`），或 skill `references/decision-recipes.md` / `component-index.md`。
+2. **只用** `morya-ui` 的 `M*` 组件；全局样式 `morya-ui/styles.css`。
+3. **颜色/间距/圆角** 使用 `--m-*` CSS 变量，禁止裸 hex/rgb（见 `scripts/check-raw-colors.mjs`）。品牌差异优先主题覆盖 `--m-color-primary` / 字体（见 DESIGN.md § 主题覆盖）。
+4. **页面组装（composition-first）**：有参考时先 `map_reference`（或 `recommend_page` + `brief` / `density`）→ 按 `mapping` / `suggestedSnippets` 用 `get_page_snippet` 拼装；`page-layouts` 作块顺序 checklist。`get_golden_page` **可选**。Account / Express / Flow 签名壳用 `get_style_shells`。**视觉方向**：明确参考/描述 → 跟用户；线索清晰 → 推断并说明；不确定 → 先问（`get_style_direction`）。**没有命名风格预设表。** 禁止未询问就套 AI 默认渐变/霓虹/毛玻璃。
+5. **表单选项** 用 `MSelect` / `MTreeSelect`；**动作菜单** 用 `MDropdown`。
+6. 不确定 API 时查文档站或 MCP `get_component`，**禁止臆造 prop**；写完后必须 `validate_usage`。
+7. 根节点用 `MConfigProvider`；后台布局用 `MLayout` 系列。
+8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用字段 `errorMessage` 或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主）。见 skill `references/feedback.md`。
+9. 交付前 `validate_page`（同一 `brief`）：契约 `ok` 必须为 true；工艺建议可说明后放过。
+
+Token / 风格 / companion：MCP `get_design_rules`、`get_style_direction`、`get_style_shells`、`map_reference`；skill `optional-companions.md`（运行时以 `morya-ui/styles.css` 为准）