@morya-ui/setup 0.3.4 → 0.3.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Morya UI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,7 +9,7 @@ Docs (zh/en):
 - [Agent Skill](https://morya-space.github.io/morya-ui/docs/agent-skill) — `morya-ui-pages` behavior
 - [Quick start](https://morya-space.github.io/morya-ui/docs/quick-start) — install and first component
 
-Installs the UI library, copies first-party Agent skills / Cursor rules / design docs from `design-kit`, installs optional companion skills at **latest** via the [skills CLI](https://skills.sh/), merges Cursor MCP for [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp), and injects `import 'morya-ui/styles.css'`.
+Installs / upgrades the UI library and any existing `@morya-ui/*` packages to **latest**, copies first-party Agent skills / Cursor rules / design docs from `design-kit`, installs optional companion skills at **latest** via the [skills CLI](https://skills.sh/), merges Cursor MCP for [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp), and injects `import 'morya-ui/styles.css'`.
 
 ## Usage
 
@@ -24,16 +24,19 @@ On a TTY, `full` / `ai` will prompt for optional Agent skills (required `morya-u
 Other common commands:
 
 ```bash
-# AI config + MCP only (library already installed)
+# Upgrade deps + AI config + MCP (skips styles injection)
 npx @morya-ui/setup ai
 
-# Library + styles only
+# Upgrade deps + styles only
 npx @morya-ui/setup app
 
 # Non-interactive skill selection
 npx @morya-ui/setup ai --yes
 npx @morya-ui/setup ai --skills=morya-ui-pages,frontend-design,impeccable
 npx @morya-ui/setup ai --skills=all
+
+# Refresh AI template / MCP without touching dependencies
+npx @morya-ui/setup ai --skip-install
 ```
 
 ### Options
@@ -46,7 +49,7 @@ npx @morya-ui/setup ai --skills=all
 | `--yes` / `-y` | Use default skills without prompting |
 | `--force` | Overwrite existing template files and the `morya-ui` MCP entry |
 | `--dry-run` | Print actions without writing or installing |
-| `--skip-install` | Do not install `morya-ui` |
+| `--skip-install` | Do not install / upgrade `morya-ui` or `@morya-ui/*` |
 | `--skip-template` | Do not copy AI skill / rules / docs (also skips companion skill install) |
 | `--skip-mcp` | Do not write `.cursor/mcp.json` |
 | `--skip-styles` | Do not inject `styles.css` |
@@ -57,7 +60,7 @@ npx @morya-ui/setup ai --skills=all
 
 | Id | Default | Install | Role |
 | --- | --- | --- | --- |
-| `morya-ui-pages` | required | template (from this package) | Page generation with `M*` + golden layouts |
+| `morya-ui-pages` | required | template (from this package) | Page generation with `M*` + snippets / decisions (composition-first) |
 | `frontend-design` | optional | skills CLI → `anthropics/skills` (latest) | Express / brand visual taste |
 | `fixing-accessibility` | optional | skills CLI → `ibelick/ui-skills` (latest) | A11y audit and targeted fixes |
 | `impeccable` | optional | skills CLI → `pbakaus/impeccable` (latest) | Named polish / audit / redesign passes |
@@ -66,9 +69,10 @@ Catalog: [`catalog/skills.json`](./catalog/skills.json).
 
 ### Conflict policy
 
+- Dependencies: always install / upgrade `morya-ui@latest` and any existing `@morya-ui/*` (e.g. `@morya-ui/nuxt`) to `@latest` unless `--skip-install`.
 - Template files and `.cursor/rules/*`: **skip** if the destination exists (unless `--force`).
 - Companion skills (`skills-cli`): always reinstall/update to **latest** when selected.
-- `.cursor/mcp.json`: merge other servers; skip existing `morya-ui` entry unless `--force`.
+- `.cursor/mcp.json`: merge other servers; skip existing `morya-ui` entry unless `--force`. New or forced entries use `npx -y @morya-ui/mcp@latest`.
 - `package.json` `check:colors`: add only if missing (unless `--force`).
 - Styles: inject only when an entry file is found and the import is not already present.
 
@@ -94,7 +98,7 @@ Writes / merges:
   "mcpServers": {
     "morya-ui": {
       "command": "npx",
-      "args": ["-y", "@morya-ui/mcp"]
+      "args": ["-y", "@morya-ui/mcp@latest"]
     }
   }
 }

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@morya-ui/setup",
   "type": "module",
-  "version": "0.3.4",
-  "packageManager": "pnpm@10.12.4",
+  "version": "0.3.5",
   "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",
@@ -32,7 +31,6 @@
   },
   "scripts": {
     "sync-template": "node ./scripts/sync-template.mjs",
-    "build": "pnpm run sync-template",
-    "prepublishOnly": "pnpm run build"
+    "build": "pnpm run sync-template"
   }
-}
+}

package/src/cli.mjs

@@ -1,8 +1,6 @@
-import { existsSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { copyTemplate } from './copy-template.mjs'
-import { readJson } from './fs-utils.mjs'
 import { installMoryaUi } from './install.mjs'
 import { mergeMcpConfig } from './mcp.mjs'
 import { ensureCheckColorsScript } from './package-json.mjs'
@@ -25,7 +23,8 @@ const MODES = new Set(['app', 'ai', 'full'])
 const MODE_DEFAULTS = {
   full: {},
   app: { skipTemplate: true, skipMcp: true, skipScripts: true },
-  ai: { skipInstall: true, skipStyles: true },
+  // ai still upgrades morya-ui / @morya-ui/* to latest unless --skip-install
+  ai: { skipStyles: true },
 }
 
 const SKIP_FLAGS = {
@@ -47,15 +46,15 @@ export function printHelp() {
   console.log(`Usage: morya-ui-setup [command] [options]
 
 Commands:
-  (default) / full  Install morya-ui, AI template, MCP, styles, check:colors
-  app               Install morya-ui and inject styles.css
-  ai                Copy Agent skills / rules / DESIGN,
+  (default) / full  Upgrade morya packages to latest, AI template, MCP, styles, check:colors
+  app               Upgrade morya packages to latest and inject styles.css
+  ai                Upgrade morya packages to latest, copy Agent skills / rules / DESIGN,
                     merge Cursor MCP, add check:colors
 
 Default command:
-  - install morya-ui
+  - install / upgrade morya-ui@latest and any existing @morya-ui/* to @latest
   - copy DESIGN.md, selected Agent skills, Cursor rules
-  - merge .cursor/mcp.json for @morya-ui/mcp
+  - merge .cursor/mcp.json for @morya-ui/mcp@latest
   - inject import 'morya-ui/styles.css' into the app entry when found
   - add check:colors script when missing
 
@@ -66,7 +65,7 @@ Options:
   --yes             Use default skills without prompting (CI / non-interactive)
   --force           Overwrite existing template files and MCP server entry
   --dry-run         Print actions without writing or installing
-  --skip-install    Skip dependency install
+  --skip-install    Skip dependency install / upgrade
   --skip-template   Skip copying AI template files
   --skip-mcp        Skip writing .cursor/mcp.json
   --skip-styles     Skip injecting styles.css
@@ -170,24 +169,6 @@ function rel(cwd, path) {
   return path.startsWith(cwd) ? path.slice(cwd.length).replace(/^[\\/]/, '') || path : path
 }
 
-/**
- * @param {string} cwd
- */
-function hasMoryaUiDependency(cwd) {
-  const path = join(cwd, 'package.json')
-  if (!existsSync(path)) return false
-  try {
-    const pkg = readJson(path)
-    return Boolean(
-      pkg.dependencies?.['morya-ui']
-      || pkg.devDependencies?.['morya-ui']
-      || pkg.peerDependencies?.['morya-ui'],
-    )
-  } catch {
-    return false
-  }
-}
-
 /**
  * @param {ReturnType<typeof parseArgs>} options
  */
@@ -210,13 +191,6 @@ export async function runSetup(options) {
   console.log(`@morya-ui/setup [${mode}] → ${cwd}${dryRun ? ' (dry-run)' : ''}`)
   console.log('')
 
-  if (mode === 'ai' && !hasMoryaUiDependency(cwd)) {
-    console.log(
-      'Warning: morya-ui is not listed in package.json. Run `npx @morya-ui/setup app` first (or pnpm add morya-ui).',
-    )
-    console.log('')
-  }
-
   const catalog = loadSkillsCatalog()
   let selectedSkills = []
   let aiInclude
@@ -235,7 +209,8 @@ export async function runSetup(options) {
     console.log('')
   }
 
-  const install = installMoryaUi(cwd, { pm, dryRun, skipInstall })
+  // Always ensure morya-ui@latest; also bump any existing @morya-ui/* (nuxt, mcp, …).
+  const install = installMoryaUi(cwd, { pm, dryRun, skipInstall, ensureCore: true })
 
   const template = skipTemplate
     ? { copied: [], skipped: [], forced: [], skippedStep: true }
@@ -262,10 +237,12 @@ export async function runSetup(options) {
     : ensureCheckColorsScript(cwd, { force, dryRun })
 
   console.log('--- Summary ---')
+  const pkgList = (install.packages || []).join(', ') || 'morya-ui'
   if (install.skipped) {
     console.log(`Install: skipped (${install.reason}) — would run: ${install.command}`)
   } else {
-    console.log(`Install: ok (${install.pm}) — ${install.command}`)
+    console.log(`Install: upgraded to latest (${install.pm}) — ${pkgList}`)
+    console.log(`  $ ${install.command}`)
   }
 
   if (template.skippedStep) {

package/src/install.mjs

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { execSync } from 'node:child_process'
+import { readJson } from './fs-utils.mjs'
 
 const LOCKFILES = [
   { pm: 'pnpm', file: 'pnpm-lock.yaml' },
@@ -8,6 +9,9 @@ const LOCKFILES = [
   { pm: 'npm', file: 'package-lock.json' },
 ]
 
+const CORE_PACKAGE = 'morya-ui'
+const SCOPE_PREFIX = '@morya-ui/'
+
 export function detectPackageManager(cwd, explicit) {
   if (explicit) {
     if (!['pnpm', 'yarn', 'npm'].includes(explicit)) {
@@ -21,43 +25,110 @@ export function detectPackageManager(cwd, explicit) {
   return 'pnpm'
 }
 
-function installCommand(pm) {
+/**
+ * Collect morya-ui / @morya-ui/* names from package.json.
+ * Always includes `morya-ui` when ensureCore is true (full / app).
+ * @param {Record<string, unknown> | null} pkg
+ * @param {{ ensureCore?: boolean }} [opts]
+ * @returns {string[]}
+ */
+export function collectMoryaPackages(pkg, { ensureCore = true } = {}) {
+  const names = new Set()
+  if (pkg && typeof pkg === 'object') {
+    for (const field of ['dependencies', 'devDependencies', 'optionalDependencies']) {
+      const deps = pkg[field]
+      if (!deps || typeof deps !== 'object') continue
+      for (const name of Object.keys(deps)) {
+        if (name === CORE_PACKAGE || name.startsWith(SCOPE_PREFIX)) {
+          names.add(name)
+        }
+      }
+    }
+  }
+  if (ensureCore) names.add(CORE_PACKAGE)
+  return [...names].sort()
+}
+
+/**
+ * @param {string} pm
+ * @param {string[]} packages bare package names
+ */
+export function installCommand(pm, packages) {
+  const specs = packages.map((name) => `${name}@latest`)
+  const joined = specs.join(' ')
   switch (pm) {
     case 'pnpm':
-      return 'pnpm add morya-ui'
+      return `pnpm add ${joined}`
     case 'yarn':
-      return 'yarn add morya-ui'
+      return `yarn add ${joined}`
     case 'npm':
-      return 'npm install morya-ui'
+      return `npm install ${joined}`
     default:
       throw new Error(`Unknown package manager: ${pm}`)
   }
 }
 
 /**
- * @returns {{ pm: string, command: string, skipped?: boolean, reason?: string }}
+ * Install / upgrade `morya-ui` and any existing `@morya-ui/*` deps to the npm `latest` tag.
+ * @returns {{
+ *   pm: string,
+ *   command: string,
+ *   packages: string[],
+ *   skipped?: boolean,
+ *   reason?: string,
+ * }}
  */
-export function installMoryaUi(cwd, { pm, dryRun = false, skipInstall = false } = {}) {
+export function installMoryaUi(cwd, {
+  pm,
+  dryRun = false,
+  skipInstall = false,
+  ensureCore = true,
+} = {}) {
   const resolved = detectPackageManager(cwd, pm)
-  const command = installCommand(resolved)
+  const pkgPath = join(cwd, 'package.json')
+
+  let pkg = null
+  if (existsSync(pkgPath)) {
+    try {
+      pkg = readJson(pkgPath)
+    } catch {
+      pkg = null
+    }
+  }
+
+  const packages = collectMoryaPackages(pkg, { ensureCore })
+  const command = packages.length
+    ? installCommand(resolved, packages)
+    : installCommand(resolved, [CORE_PACKAGE])
 
   if (skipInstall) {
-    return { pm: resolved, command, skipped: true, reason: 'skip-install' }
+    return { pm: resolved, command, packages, skipped: true, reason: 'skip-install' }
   }
 
-  if (!existsSync(join(cwd, 'package.json'))) {
+  if (!existsSync(pkgPath)) {
     return {
       pm: resolved,
       command,
+      packages,
       skipped: true,
       reason: 'no-package-json',
     }
   }
 
+  if (!packages.length) {
+    return {
+      pm: resolved,
+      command,
+      packages,
+      skipped: true,
+      reason: 'no-morya-packages',
+    }
+  }
+
   if (dryRun) {
-    return { pm: resolved, command, skipped: true, reason: 'dry-run' }
+    return { pm: resolved, command, packages, skipped: true, reason: 'dry-run' }
   }
 
   execSync(command, { cwd, stdio: 'inherit', shell: true })
-  return { pm: resolved, command }
+  return { pm: resolved, command, packages }
 }

package/src/mcp.mjs

@@ -5,7 +5,7 @@ import { readJson, writeJson } from './fs-utils.mjs'
 const SERVER_NAME = 'morya-ui'
 const SERVER_CONFIG = {
   command: 'npx',
-  args: ['-y', '@morya-ui/mcp'],
+  args: ['-y', '@morya-ui/mcp@latest'],
 }
 
 /**

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

@@ -5,10 +5,10 @@ description: >
   morya-ui component library — admin CRUD (list, form, dashboard, detail,
   settings), auth and onboarding, empty and error states, wizards, overlays,
   marketing/landing and pricing pages, docs chrome, and hybrid product UI.
-  Trigger on: morya-ui, M* components, --m-* tokens, golden pages, 后台页,
-  列表页, 表单页, 仪表盘, 登录页, 注册, 空状态, 向导, 落地页, 官网, landing,
-  login, dashboard, settings, onboarding, or “用组件库做页面”. Prefer this
-  skill over generic frontend-design, impeccable, or ui-ux-pro-max when the
+  Trigger on: morya-ui, M* components, --m-* tokens, golden pages, page snippets,
+  后台页, 列表页, 表单页, 仪表盘, 登录页, 注册, 空状态, 向导, 落地页, 官网,
+  landing, login, dashboard, settings, onboarding, or “用组件库做页面”. Prefer
+  this skill over generic frontend-design, impeccable, or ui-ux-pro-max when the
   implementation stack is morya-ui; those companions may deepen taste and polish
   after structure/contract are fixed (see references/optional-companions.md).
   Do not use for backend-only work or for authoring new components inside the
@@ -22,7 +22,9 @@ Guide agents that **consume morya-ui** across the full product surface — not o
 Two layers always apply:
 
 1. **Contract** — only `M*` controls, `--m-*` tokens, real APIs (MCP/docs). Never invent props or mix UI kits.
-2. **Craft** — pick the right surface pattern, then apply intentional visual direction (distilled from Frontend Design / Impeccable / UI-UX-Pro-Max ideas). Admin golden pages stay disciplined; expressive surfaces (landing, auth brand moments, empty states) may take a justified aesthetic risk — still on-token and on-component.
+2. **Craft** — pick the right surface pattern, then apply intentional visual direction (distilled from Frontend Design / Impeccable / UI-UX-Pro-Max ideas). Ops stays disciplined; expressive surfaces (landing, auth brand moments, empty states) may take a justified aesthetic risk — still on-token and on-component.
+
+**Default build path (composition-first):** pin surface → L2 decisions + page snippets → craft → validate. Golden pages are an **optional** whole-page block-order check — not the default clone target.
 
 When companions conflict with this skill or project `DESIGN.md`, **this skill wins**.
 
@@ -30,14 +32,14 @@ When companions conflict with this skill or project `DESIGN.md`, **this skill wi
 
 | Lane | Surfaces | Primary references |
 | --- | --- | --- |
-| **Ops** | list, form, dashboard, detail, settings, filter drawer, CRUD dialog | [page-layouts.md](references/page-layouts.md), golden pages |
-| **Account** | login, register, invite, forgot/reset password, profile | [surfaces.md](references/surfaces.md) § Account |
-| **Flow** | onboarding, empty state, wizard/stepper, success/result | [surfaces.md](references/surfaces.md) § Flow |
+| **Ops** | list, form, dashboard, detail, settings, filter drawer, CRUD dialog | [page-layouts.md](references/page-layouts.md) block order + snippets |
+| **Account** | login, register, invite, forgot/reset password, profile | [surfaces.md](references/surfaces.md) § Account + `auth-split-shell` |
+| **Flow** | onboarding, empty state, wizard/stepper, success/result | [surfaces.md](references/surfaces.md) § Flow + empty/result/wizard snippets |
 | **System** | 404 / error, permission denied, maintenance | [surfaces.md](references/surfaces.md) § System |
 | **Express** | marketing landing, pricing, feature showcase, docs marketing chrome | [surfaces.md](references/surfaces.md) § Express + [visual-craft.md](references/visual-craft.md) |
-| **Overlay** | dialog, drawer, popover, command menu as the main UI | [surfaces.md](references/surfaces.md) § Overlay |
+| **Overlay** | dialog, drawer, popover, command menu as the main UI | [surfaces.md](references/surfaces.md) § Overlay + form-in-dialog/drawer snippets |
 
-Unclear brief → ask **one** short question, or default: Ops → closest golden page; public marketing → Express.
+Unclear brief → ask **one** short question, or default: Ops → closest page-layout checklist + snippets; public marketing → Express.
 
 Full taxonomy: [references/surfaces.md](references/surfaces.md).
 
@@ -45,7 +47,7 @@ Full taxonomy: [references/surfaces.md](references/surfaces.md).
 
 1. `morya-ui` installed; `morya-ui/styles.css` imported.
 2. Prefer `@morya-ui/mcp` — never invent prop / event / slot names.
-3. Golden pages, component APIs, and feedback rules come from `@morya-ui/mcp`. Without MCP, use this skill's `references/`. Project `DESIGN.md` overrides generic taste when the AI pack is merged.
+3. Component APIs, decision recipes, page snippets, and feedback rules come from `@morya-ui/mcp`. Golden pages are optional assembly demos. Without MCP, use this skill's `references/`. Project `DESIGN.md` overrides generic taste when the AI pack is merged.
 
 ## Workflow
 
@@ -57,69 +59,69 @@ State explicitly (even briefly in thinking):
 - **Audience** — who uses this screen
 - **Surface** — from the map above
 - **Single job** — what the first viewport must accomplish
-- **Style direction** — resolve in this order (see [style-presets.md](references/style-presets.md)):
-  1. User **reference** (screenshot / mock / existing page / “像 XX”) → extract cues, map to `--m-*` + `M*`
-  2. User **named preset** (`soft` / 柔和留白 / …) → apply it
-  3. **Prompt cues** (行业/气质) → infer a preset and name it
-  4. Still unclear → ask **one** question with 3–4 presets; if “直接写” → domain heuristic (**not** always `quiet`)
+- **Style direction** — resolve in this order (see [style-presets.md](references/style-presets.md); **no preset catalog**):
+  1. User **reference** or **explicit description** → **must follow** (map to `--m-*` + `M*`; never substitute another face)
+  2. No description, but **clear prompt cues** → infer and **state your reading** in one sentence
+  3. **Uncertain** → **ask once** for a description or reference; do not invent the full look first
+  4. User says “直接写 / 你看着办” with still no cues → quiet flat on-token admin face, **say so**; never default glass/neon/aurora
 
-Golden pages lock **structure/API**, not the only aesthetic. Blindly cloning golden visuals makes pages feel stiff.
+Golden pages (when used) lock **block order**, not aesthetics. Blindly cloning golden visuals makes pages feel stiff — prefer composing snippets.
 
-For Express / branded Account moments, also draft a tiny **design plan** (see [visual-craft.md](references/visual-craft.md)): palette roles mapped to `--m-*` (extend only if the project already customizes theme), type roles, layout concept, one signature element. For Ops, a named preset + Ops polish is enough unless the user asks for a redesign.
+For Express / branded Account moments, also draft a tiny **design plan** (see [visual-craft.md](references/visual-craft.md)): palette roles mapped to `--m-*` (extend only if the project already customizes theme), type roles, layout concept, one signature element. For Ops, Ops polish + the resolved direction is enough unless the user asks for a redesign.
 
 ### 2. Load the smallest useful references
 
 | Need | Prefer (MCP) | Else read |
 | --- | --- | --- |
-| Ops pattern | `recommend_page` → **`get_golden_page`** (mirror structure; craft from style direction) | [page-layouts.md](references/page-layouts.md) |
-| Style direction | `recommend_page({ style })` / **`list_style_presets`** / **`get_style_preset`** | [style-presets.md](references/style-presets.md) |
-| Account / Express / empty / result | `recommend_page` → `get_golden_page` (`login-page` / `landing-page` / `empty-state` / `result-page`) | [surfaces.md](references/surfaces.md) |
+| Ops pattern + snippets | `recommend_page` → **`suggestedSnippets`** / **`get_page_snippet`** + **`recommend_component`** | [page-layouts.md](references/page-layouts.md) + [decision-recipes.md](references/decision-recipes.md) |
+| Style direction | `recommend_page({ style })` / **`get_style_direction`** | [style-presets.md](references/style-presets.md) |
+| Account / Express / empty / result | snippets (`auth-split-shell`, `empty-block`, `result-block`, …) + `recommend_page` | [surfaces.md](references/surfaces.md) |
+| Optional whole-page block order | `get_golden_page` only when unsure of section order or user asks to mirror a golden sample | [page-layouts.md](references/page-layouts.md) |
 | Visual direction | — | [visual-craft.md](references/visual-craft.md) + [style-presets.md](references/style-presets.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) |
+| Components / **API truth** | `search` / **`get_component`** / `get_example` / **`recommend_component`** (L2 recipes + `relatedSnippets`) | [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) |
 | **Required checks** | **`validate_usage`** (every `M*` you used) + `validate_page` | [review-checklist.md](references/review-checklist.md) |
 
 ### 3. Compose
 
-**Ops:** mirror golden-page **block order**; apply the resolved **style preset** (or reference cues) for density/chrome/copy; prefer `MPage*` over custom chrome. Do not freeze every Ops page into identical quiet chrome. List craft variants: `list-page` (soft structure), `list-page-dense`, `list-page-rail` — `recommend_page({ style })` routes them.
+**Ops:** follow [page-layouts.md](references/page-layouts.md) **block-order checklist**; fill each block with **`get_page_snippet`** / `suggestedSnippets` (filters, table, header actions, form-in-dialog, confirm-delete, …). Apply the resolved **style direction** for density/chrome/copy; prefer `MPage*` over custom chrome. Do not freeze every Ops page into identical chrome. List density/sider cues (`dense` / `rail`) inform craft — do not invent new golden-page variants.
 
-**Account / Flow / System:** centered or split shells with `MCard` / `MForm` / `MEmpty` / `MResult` (see surfaces); keep controls as `M*`. Persistent form errors use field `errorMessage` or a token-styled `role="alert"` — `<MMessage>` is the `message` host, not an inline alert.
+**Account / Flow / System:** centered or split shells with `MCard` / `MForm` / `MEmpty` / `MResult` (see surfaces + snippets); keep controls as `M*`. Persistent form errors use field `errorMessage` or a token-styled `role="alert"` — `<MMessage>` is the `message` host, not an inline alert.
 
 **Express:** hero + sections with intentional hierarchy; interactive bits still `MButton` / `MTag` / etc.; atmosphere via layout, motion, and tokens — not a second component library.
 
-**Overlay:** build the host page lightly; put the real job inside `MDialog` / `MDrawer` / `MCommandMenu`.
+**Overlay:** build the host page lightly; put the real job inside `MDialog` / `MDrawer` / `MCommandMenu` (use `form-in-dialog` / `form-in-drawer` snippets).
 
 ### 4. Wire real API usage
 
 - Import from `morya-ui` (or documented subpath + style).
-- **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`).
+- **Selection + key props:** call MCP **`recommend_component`** (by query or `decision` id) and apply the returned **recipe** (`props` / `slots` / `events`), **antiPatterns**, and **`relatedSnippets`**. 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` snippet).
 - Tables: `columns` + `rows` + `row-key`; `#cell-{key}`. There is no `data` prop. For full-viewport admin lists whose main job is one table, consider `MPageContent fill` + `MTable fill paginator`; skip `fill` for embedded/short/whole-page-scroll cases (see [page-layouts.md](references/page-layouts.md)).
 - Enums → `MSelect` / `MTreeSelect`; action menus → `MDropdown`.
-- Destructive → `MConfirmDialog` / `MConfirmPopup` (`confirm-choice`).
+- Destructive → `MConfirmDialog` / `MConfirmPopup` (`confirm-choice` + `confirm-delete` snippet).
 - 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.
+- `recommend_page(includeScaffold: true)` may return golden source as a **structure reference** — remap copy/data only; default path does **not** require cloning the whole page. Never treat generated fallback as the visual target.
 
 ### 5. Craft pass (always — lane-aware + companions)
 
 Run **before** delivery. Do not stop at a structurally correct shell.
 
-1. Resolve **style direction** ([style-presets.md](references/style-presets.md)) — reference → preset → cues → ask.
+1. Resolve **style direction** ([style-presets.md](references/style-presets.md)) — reference/description first; else prompt cues; else **ask**; never silent AI face. **No preset catalog.**
 2. Apply lane craft from [visual-craft.md](references/visual-craft.md):
-   - **Ops / Operate:** style preset + § Ops polish (one primary, menu icons, `MStatus`, designed empty, no decorative cards).
-   - **Account / Flow:** one calm brand or empty-state cue from § Atmosphere; form errors via `errorMessage` / token `role="alert"`.
-   - **Express / Persuade:** short design plan + one signature; avoid AI-default looks; optional 1–2 token-only motions via `useMotion`.
+   - **Ops / Operate:** resolved direction + § Ops polish (one primary, menu icons, `MStatus`, designed empty, no decorative cards).
+   - **Account / Flow:** one calm brand or empty-state cue from § Shell recipes; form errors via `errorMessage` / token `role="alert"`.
+   - **Express / Persuade:** short design plan + one signature; avoid AI-default looks; optional 1–2 token-only motions via `useMotion`. Signature ≠ unearned gradient/glass/neon.
 3. **If companions are already installed** (see [optional-companions.md](references/optional-companions.md)):
-   - Express / brand → may load **`frontend-design`** for POV after contract is fixed
-   - User asks 更大胆/更克制/polish/audit → may load **`impeccable`** command (`bolder` / `quieter` / `polish` / …)
-   - Mood/industry keywords only → optional **`ui-ux-pro-max`** search, then map to tokens/preset
+   - Express / brand → may load **`frontend-design`** for POV after contract **and style direction** are fixed
+   - User asks 更大胆/更克制/polish/audit → may load **`impeccable`** command (`bolder` / `quieter` / `polish` / …) **inside** the resolved direction
+   - Mood/industry keywords only → optional **`ui-ux-pro-max`** search, then map to `--m-*` (not a preset id)
    - a11y pass → optional **`fixing-accessibility`** after visual
-   - Max **one** visual companion per task; always remediate with `M*` + `--m-*`
-4. If companions are **absent**, use distilled visual-craft / style-presets — do **not** block or ask to install mid-task.
+   - Max **one** visual companion per task; always remediate with `M*` + `--m-*`; strip companion-added AI atmosphere the user did not ask for
+4. If companions are **absent**, use distilled visual-craft / style-direction — do **not** block or ask to install mid-task.
 5. **All lanes:** responsive, focus visible, domain-real copy. User **reference** overrides companion taste within the morya contract.
 
 Named polish modes (`quieter` | `bolder` | `clarify` | `audit` | …): extra pass when the user asks to improve an existing screen.
@@ -141,10 +143,12 @@ Do not deliver with unresolved `unknown-prop` / `unknown-event`.
 - No hand-rolled table/modal when `MTable` / `MDialog` / `MDrawer` fit.
 - No invented props / events / slots.
 - No defaulting every success to `toast`.
-- No substituting a generated scaffold for `get_golden_page` when a golden sample exists.
-- Ops surfaces follow golden layouts first — do not replace them with marketing heroes.
+- No substituting a generated scaffold for a real golden sample when the user asked to mirror one — but default path composes snippets, not full-page clones.
+- Ops surfaces follow page-layout **block order** — do not replace them with marketing heroes.
 - Express surfaces still use `M*` for controls and `--m-*` for color/space; do not introduce shadcn/Element/etc. stacks suggested by generic design skills.
 - Soft-load companions only; never require Impeccable / UI-UX-Pro-Max / Frontend Design to be installed.
+- Do **not** invent decorative glass / neon / aurora / neumorph / full-page gradients unless the **user reference or description** clearly asks for them.
+- Do **not** add new golden-page craft variants (`list-page-*`); express density/sider via style direction + polish.
 
 ## Soft companions
 
@@ -154,7 +158,7 @@ If already installed in the consumer project, **combine** them after structure +
 | --- | --- | --- |
 | `frontend-design` | Express / branded Account moments | Distinctive design plan + signature (taste) |
 | `impeccable` | Polish / bolder / quieter / audit / delight asks | Named Operate/Persuade craft passes |
-| `ui-ux-pro-max` | Mood / industry keyword search for Express | Keywords → map to `--m-*` + style preset |
+| `ui-ux-pro-max` | Mood / industry keyword search for Express | Keywords → map to `--m-*` (no preset ids) |
 | `fixing-accessibility` | a11y audit after visual | Names, keyboard, focus on top of `M*` |
 
 Routing, conflict rules, and load budget: [optional-companions.md](references/optional-companions.md). Distilled craft in [visual-craft.md](references/visual-craft.md) + [style-presets.md](references/style-presets.md) keeps this skill **standalone**.
@@ -164,7 +168,7 @@ Routing, conflict rules, and load budget: [optional-companions.md](references/op
 - Vue 3 `<script setup lang="ts">`.
 - PascalCase `M*` in templates.
 - Domain-real copy and data shapes (not placeholder “示例 / Name / No data” when the brief names a product).
-- Scoped CSS minimal; tokens only (`color-mix` / gradients from `--m-*` OK; control widths may be inline).
+- Scoped CSS minimal; tokens only (`color-mix` OK). Prefer **flat** surfaces; gradients / glass / glow **only** when the user/reference asks (control widths may be inline).
 - Craft pass completed for the lane (see step 5).
 - For multi-file asks: sensible `views/` / `components/` split; otherwise one SFC is fine.
 
@@ -173,9 +177,9 @@ Routing, conflict rules, and load budget: [optional-companions.md](references/op
 | File | Read when |
 | --- | --- |
 | [surfaces.md](references/surfaces.md) | Choosing / composing non-Ops (and hybrid) surfaces |
-| [page-layouts.md](references/page-layouts.md) | Ops golden layouts |
-| [style-presets.md](references/style-presets.md) | Style resolution + named presets users can pick |
-| [visual-craft.md](references/visual-craft.md) | Ops polish, atmosphere recipes, anti-defaults, polish modes |
+| [page-layouts.md](references/page-layouts.md) | Ops block-order checklists (fill with snippets) |
+| [style-presets.md](references/style-presets.md) | Style resolution (no preset catalog) |
+| [visual-craft.md](references/visual-craft.md) | Ops polish, shell recipes, anti-defaults, polish modes |
 | [design-system.md](references/design-system.md) | Principles, tokens, bans |
 | [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) |