@morya-ui/setup 0.2.6 → 0.2.8

package/README.md

@@ -4,10 +4,12 @@ One-shot setup for consumer Vue projects using [`morya-ui`](https://www.npmjs.co
 
 Docs (zh/en):
 
-- [AI setup](https://morya-space.github.io/morya-ui/docs/ai-setup) — one-shot CLI
+- [One-shot setup](https://morya-space.github.io/morya-ui/docs/setup) — CLI commands and options
+- [AI setup](https://morya-space.github.io/morya-ui/docs/ai-setup) — Agent workflow
 - [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 Agent skill / Cursor rules / design docs from `ai-design-config`, merges Cursor MCP for [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp), injects `import 'morya-ui/styles.css'`, and writes `src/styles/morya-app-shell.css` with its entry import.
+Installs the UI library, copies Agent skill / Cursor rules / design docs from `design-kit`, merges Cursor MCP for [`@morya-ui/mcp`](https://www.npmjs.com/package/@morya-ui/mcp), and injects `import 'morya-ui/styles.css'`.
 
 ## Usage
 
@@ -17,6 +19,16 @@ In your app project root:
 npx @morya-ui/setup
 ```
 
+Other common commands:
+
+```bash
+# AI config + MCP only (library already installed)
+npx @morya-ui/setup ai
+
+# Library + styles only
+npx @morya-ui/setup app
+```
+
 ### Options
 
 | Flag | Meaning |
@@ -28,10 +40,16 @@ npx @morya-ui/setup
 | `--skip-install` | Do not install `morya-ui` |
 | `--skip-template` | Do not copy AI skill / rules / docs / tokens |
 | `--skip-mcp` | Do not write `.cursor/mcp.json` |
-| `--skip-styles` | Do not inject `styles.css` / write app-shell CSS |
+| `--skip-styles` | Do not inject `styles.css` |
 | `--skip-scripts` | Do not add `check:colors` to `package.json` |
 | `-h`, `--help` | Show help |
 
+Example: MCP only:
+
+```bash
+npx @morya-ui/setup ai --skip-template --skip-scripts
+```
+
 ### Conflict policy
 
 - Template files and `.cursor/rules/*`: **skip** if the destination exists (unless `--force`).
@@ -41,16 +59,12 @@ npx @morya-ui/setup
 
 ### What gets copied
 
-From the package `template/` (synced from repo `ai-design-config/`):
+From the package `template/` (synced from repo `design-kit/`):
 
 - `DESIGN.md`
 - `.agents/skills/morya-ui-pages/`
 - `.cursor/rules/`
-- `docs/` (component index, golden pages, feedback guide)
-- `design-tokens/`
 - `scripts/check-raw-colors.mjs`
-- `src/examples/`
-- `src/styles/morya-app-shell.css`
 
 ### MCP (Cursor)
 
@@ -77,7 +91,6 @@ Looks for `src/main.ts` / `.js` / `.tsx` / `.jsx`, root `main.*`, `src/app.ts` /
 
 ```ts
 import 'morya-ui/styles.css'
-import './styles/morya-app-shell.css'
 ```
 
 The CLI does **not** call `app.use(MoryaUI)` or edit `App.vue`.
@@ -85,7 +98,7 @@ The CLI does **not** call `app.use(MoryaUI)` or edit `App.vue`.
 ## Local development (this monorepo)
 
 ```bash
-pnpm setup:sync-template   # refresh packages/setup/template from ai-design-config
+pnpm setup:sync-template   # refresh packages/setup/template from design-kit
 pnpm setup:build
 node packages/setup/bin/morya-ui-setup.js --cwd /path/to/app --dry-run
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/setup",
   "type": "module",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "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/src/cli.mjs

@@ -1,15 +1,34 @@
+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'
-import { ensureShellStyles, ensureStylesImport } from './styles.mjs'
+import { ensureStylesImport } from './styles.mjs'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const PKG_ROOT = resolve(__dirname, '..')
 const TEMPLATE_ROOT = join(PKG_ROOT, 'template')
 
+const MODES = new Set(['app', 'ai', 'full'])
+
+/** AI pack paths under template/. */
+const AI_TEMPLATE_INCLUDE = [
+  'DESIGN.md',
+  '.agents/skills/morya-ui-pages',
+  '.cursor/rules',
+  'scripts/check-raw-colors.mjs',
+]
+
+/** Mode → default skips (user --skip-* can only add more skips). */
+const MODE_DEFAULTS = {
+  full: {},
+  app: { skipTemplate: true, skipMcp: true, skipScripts: true },
+  ai: { skipInstall: true, skipStyles: true },
+}
+
 const SKIP_FLAGS = {
   '--skip-install': 'skipInstall',
   '--skip-template': 'skipTemplate',
@@ -19,14 +38,19 @@ const SKIP_FLAGS = {
 }
 
 export function printHelp() {
-  console.log(`Usage: morya-ui-setup [options]
+  console.log(`Usage: morya-ui-setup [command] [options]
 
-One-shot setup for morya-ui in a consumer Vue project:
+Commands:
+  (default) / full  Install morya-ui, AI template, MCP, styles, check:colors
+  app               Install morya-ui and inject styles.css
+  ai                Copy Agent skill / rules / DESIGN,
+                    merge Cursor MCP, add check:colors
+
+Default command:
   - install morya-ui
-  - copy DESIGN.md, Agent skill, Cursor rules, docs, tokens, examples
+  - copy DESIGN.md, Agent skill, Cursor rules
   - merge .cursor/mcp.json for @morya-ui/mcp
   - inject import 'morya-ui/styles.css' into the app entry when found
-  - write src/styles/morya-app-shell.css (html/body/#app height chain) and inject its import
   - add check:colors script when missing
 
 Options:
@@ -37,7 +61,7 @@ Options:
   --skip-install    Skip dependency install
   --skip-template   Skip copying AI template files
   --skip-mcp        Skip writing .cursor/mcp.json
-  --skip-styles     Skip injecting styles.css / app-shell CSS
+  --skip-styles     Skip injecting styles.css
   --skip-scripts    Skip adding check:colors to package.json
   -h, --help        Show this help
 `)
@@ -48,6 +72,7 @@ Options:
  */
 export function parseArgs(argv) {
   const options = {
+    mode: 'full',
     cwd: process.cwd(),
     pm: undefined,
     force: false,
@@ -66,6 +91,10 @@ export function parseArgs(argv) {
       options.help = true
       continue
     }
+    if (MODES.has(arg)) {
+      options.mode = arg
+      continue
+    }
     if (arg === '--force') {
       options.force = true
       continue
@@ -101,6 +130,11 @@ export function parseArgs(argv) {
     throw new Error(`Unknown argument: ${arg}`)
   }
 
+  const defaults = MODE_DEFAULTS[options.mode] || {}
+  for (const [key, value] of Object.entries(defaults)) {
+    if (value) options[key] = true
+  }
+
   return options
 }
 
@@ -109,11 +143,30 @@ 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
  */
 export async function runSetup(options) {
   const {
+    mode,
     cwd,
     force,
     dryRun,
@@ -125,14 +178,25 @@ export async function runSetup(options) {
     pm,
   } = options
 
-  console.log(`@morya-ui/setup → ${cwd}${dryRun ? ' (dry-run)' : ''}`)
+  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 install = installMoryaUi(cwd, { pm, dryRun, skipInstall })
 
   const template = skipTemplate
     ? { copied: [], skipped: [], forced: [], skippedStep: true }
-    : copyTemplate(TEMPLATE_ROOT, cwd, { force, dryRun })
+    : copyTemplate(TEMPLATE_ROOT, cwd, {
+        force,
+        dryRun,
+        include: mode === 'ai' || mode === 'full' ? AI_TEMPLATE_INCLUDE : undefined,
+      })
 
   const mcp = skipMcp
     ? { path: join(cwd, '.cursor', 'mcp.json'), action: 'skipped-flag' }
@@ -142,10 +206,6 @@ export async function runSetup(options) {
     ? { action: 'skipped', reason: 'skip-styles' }
     : ensureStylesImport(cwd, { dryRun })
 
-  const shell = skipStyles
-    ? { fileAction: 'skipped', importAction: 'skipped', reason: 'skip-styles' }
-    : ensureShellStyles(cwd, { dryRun, force })
-
   const scripts = skipScripts
     ? { action: 'skipped-flag' }
     : ensureCheckColorsScript(cwd, { force, dryRun })
@@ -158,7 +218,7 @@ export async function runSetup(options) {
   }
 
   if (template.skippedStep) {
-    console.log('Template: skipped (--skip-template)')
+    console.log('Template: skipped (--skip-template or app mode)')
   } else {
     console.log(
       `Template: ${template.copied.length} copied, ${template.forced.length} overwritten, ${template.skipped.length} skipped`,
@@ -172,13 +232,13 @@ export async function runSetup(options) {
   }
 
   if (mcp.action === 'skipped-flag') {
-    console.log('MCP: skipped (--skip-mcp)')
+    console.log('MCP: skipped (--skip-mcp or app mode)')
   } else {
     console.log(`MCP: ${mcp.action} (${rel(cwd, mcp.path) || '.cursor/mcp.json'})`)
   }
 
   if (styles.reason === 'skip-styles') {
-    console.log('Styles: skipped (--skip-styles)')
+    console.log('Styles: skipped (--skip-styles or ai mode)')
   } else if (styles.action === 'injected') {
     console.log(`Styles: injected into ${rel(cwd, styles.path)}`)
   } else if (styles.action === 'skipped') {
@@ -188,29 +248,27 @@ export async function runSetup(options) {
     console.log("  import 'morya-ui/styles.css'")
   }
 
-  if (shell.reason === 'skip-styles') {
-    console.log('Shell CSS: skipped (--skip-styles)')
-  } else {
-    console.log(
-      `Shell CSS: file ${shell.fileAction}`
-        + (shell.path ? ` (${rel(cwd, shell.path)})` : '')
-        + `, import ${shell.importAction}`
-        + (shell.entry ? ` (${rel(cwd, shell.entry)})` : ''),
-    )
-  }
-
   if (scripts.action === 'skipped-flag') {
-    console.log('Scripts: skipped (--skip-scripts)')
+    console.log('Scripts: skipped (--skip-scripts or app mode)')
   } else {
     console.log(`Scripts: check:colors ${scripts.action}`)
   }
 
   console.log('')
   console.log('Next:')
-  console.log('  1. Ensure styles.css + morya-app-shell.css imports are in your app entry.')
-  console.log('  2. Restart Cursor (or reload MCP) so morya-ui MCP tools appear.')
-  console.log('  3. Have the agent read DESIGN.md before generating pages.')
-  console.log('  4. Optional: pnpm check:colors')
+  if (mode === 'app') {
+    console.log('  1. Ensure the styles.css import is in your app entry.')
+    console.log('  2. Optional AI pack: npx @morya-ui/setup ai')
+  } else if (mode === 'ai') {
+    console.log('  1. Restart Cursor (or reload MCP) so morya-ui MCP tools appear.')
+    console.log('  2. Have the agent read DESIGN.md before generating pages.')
+    console.log('  3. Optional: pnpm check:colors')
+  } else {
+    console.log('  1. Ensure the styles.css import is in your app entry.')
+    console.log('  2. Restart Cursor (or reload MCP) so morya-ui MCP tools appear.')
+    console.log('  3. Have the agent read DESIGN.md before generating pages.')
+    console.log('  4. Optional: pnpm check:colors')
+  }
 
-  return { install, template, mcp, styles, shell, scripts }
+  return { mode, install, template, mcp, styles, scripts }
 }

package/src/copy-template.mjs

@@ -20,11 +20,27 @@ function listFiles(dir) {
   return out
 }
 
+/**
+ * @param {string} rel
+ * @param {string[] | undefined} include
+ */
+function matchesInclude(rel, include) {
+  if (!include || include.length === 0) return true
+  const norm = rel.replace(/\\/g, '/')
+  return include.some((prefix) => {
+    const p = prefix.replace(/\\/g, '/')
+    return norm === p || norm.startsWith(`${p}/`)
+  })
+}
+
 /**
  * Copy template tree into target cwd.
+ * @param {string} templateRoot
+ * @param {string} cwd
+ * @param {{ force?: boolean, dryRun?: boolean, include?: string[] }} [options]
  * @returns {{ copied: string[], skipped: string[], forced: string[] }}
  */
-export function copyTemplate(templateRoot, cwd, { force = false, dryRun = false } = {}) {
+export function copyTemplate(templateRoot, cwd, { force = false, dryRun = false, include } = {}) {
   const copied = []
   const skipped = []
   const forced = []
@@ -35,7 +51,7 @@ export function copyTemplate(templateRoot, cwd, { force = false, dryRun = false
     )
   }
 
-  const files = listFiles(templateRoot)
+  const files = listFiles(templateRoot).filter((rel) => matchesInclude(rel, include))
   for (const rel of files) {
     const from = join(templateRoot, rel)
     const to = join(cwd, rel)

package/src/fs-utils.mjs

@@ -2,7 +2,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 
 export function readJson(path) {
-  return JSON.parse(readFileSync(path, 'utf8'))
+  const text = readFileSync(path, 'utf8').replace(/^\uFEFF/, '')
+  return JSON.parse(text)
 }
 
 export function writeJson(path, value, { dryRun = false } = {}) {

package/src/styles.mjs

@@ -1,10 +1,8 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join, relative, resolve } from 'node:path'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
 
 const STYLE_IMPORT = "import 'morya-ui/styles.css'"
 const STYLE_MARKER = 'morya-ui/styles.css'
-const SHELL_MARKER = 'morya-app-shell.css'
-const SHELL_REL = 'src/styles/morya-app-shell.css'
 
 const CANDIDATES = [
   'src/main.ts',
@@ -17,14 +15,6 @@ const CANDIDATES = [
   'src/app.js',
 ]
 
-const SHELL_CSS = `html,
-body,
-#app {
-  height: 100%;
-  margin: 0;
-}
-`
-
 /**
  * @param {string} cwd
  * @returns {string | null} absolute path
@@ -100,16 +90,6 @@ export function injectStyleImport(source) {
   return injectImportLine(source, STYLE_IMPORT, STYLE_MARKER)
 }
 
-/**
- * @param {string} entryFile absolute
- * @param {string} shellFile absolute
- */
-export function shellImportLine(entryFile, shellFile) {
-  let rel = relative(dirname(entryFile), shellFile).replace(/\\/g, '/')
-  if (!rel.startsWith('.')) rel = `./${rel}`
-  return `import '${rel}'`
-}
-
 /**
  * @returns {{
  *   action: 'injected' | 'skipped' | 'missing-entry',
@@ -137,68 +117,3 @@ export function ensureStylesImport(cwd, { dryRun = false } = {}) {
 
   return { action: 'injected', path: entry, dryRun }
 }
-
-/**
- * Write morya-app-shell.css (height chain) and inject its import into the entry.
- * @returns {{
- *   fileAction: 'written' | 'skipped' | 'dry-run',
- *   importAction: 'injected' | 'skipped' | 'missing-entry',
- *   path?: string,
- *   entry?: string,
- *   reason?: string,
- *   dryRun?: boolean
- * }}
- */
-export function ensureShellStyles(cwd, { dryRun = false, force = false } = {}) {
-  const shellFile = join(cwd, SHELL_REL)
-  const entry = findEntryFile(cwd)
-
-  let fileAction = 'skipped'
-  if (!existsSync(shellFile) || force) {
-    if (dryRun) {
-      fileAction = 'dry-run'
-    }
-    else {
-      mkdirSync(dirname(shellFile), { recursive: true })
-      writeFileSync(shellFile, SHELL_CSS, 'utf8')
-      fileAction = 'written'
-    }
-  }
-
-  if (!entry) {
-    return {
-      fileAction,
-      importAction: 'missing-entry',
-      path: shellFile,
-      reason: 'no-entry-found',
-      dryRun,
-    }
-  }
-
-  const importLine = shellImportLine(entry, shellFile)
-  const original = readFileSync(entry, 'utf8')
-  const { source, changed, reason } = injectImportLine(original, importLine, SHELL_MARKER)
-
-  if (!changed) {
-    return {
-      fileAction,
-      importAction: 'skipped',
-      path: shellFile,
-      entry,
-      reason: reason || 'already-present',
-      dryRun,
-    }
-  }
-
-  if (!dryRun) {
-    writeFileSync(entry, source, 'utf8')
-  }
-
-  return {
-    fileAction,
-    importAction: 'injected',
-    path: shellFile,
-    entry,
-    dryRun,
-  }
-}

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

@@ -44,9 +44,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. If the AI config pack is merged, prefer project files over bundled copies:
-   - `DESIGN.md`
-   - `docs/golden-pages/*.vue`, `docs/components.md`, `docs/feedback-message-vs-toast.md`
+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.
 
 ## Workflow
 

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

@@ -32,7 +32,11 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 | `<MMessage>` | Persistent in-page error / warning |
 | `MEmpty` | No-data / first-use / filtered empty (not an error) |
 | `MResult` | Terminal outcome: success, failure, 403 / 404 / 500 |
-| `MProgressBar` / `MProgressSpinner` / `MSkeleton` / `MBlockUI` | Loading / blocking |
+| `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 |
 
 ## Overlays & menus
 
@@ -59,6 +63,7 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 | Marketing landing | `landing-page` golden + `MButton` / `MTag` / `MAccordion` |
 | Empty list / zero state | `MEmpty` (+ `empty-state` golden or `MTable` `#empty`) |
 | Submit success / HTTP error page | `MResult` |
+| Region or page is waiting | `MLoading`, `v-loading`, or `loading.service`; known layout → `MSkeleton` |
 | Local capped scroll | Explicit `MScrollbar` |
 | Admin sider nav | `MMenu` |
 
@@ -69,5 +74,6 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 | `MDropdown` as form enum | `MSelect` |
 | 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 |

package/template/.agents/skills/morya-ui-pages/references/design-system.md

@@ -87,7 +87,7 @@ import 'morya-ui/styles.css'
 | Card radius | `--m-radius-md` |
 | Card shadow | `--m-shadow-md` |
 
-Full machine-readable set: project `design-tokens/tokens.json` (runtime truth remains `morya-ui/styles.css`).
+Full set: MCP `get_design_rules`. Runtime truth remains `morya-ui/styles.css`.
 
 ## Bans
 

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

@@ -46,7 +46,7 @@ toast.success({
 ## Prefer `<MMessage>` / form-level errors
 
 - Field validation: component `invalid` / `errorMessage` (preferred).
-- Form-level persistent errors (login/auth): token-styled `role="alert"` bar as in `docs/golden-pages/login-page.vue`.
+- Form-level persistent errors (login/auth): token-styled `role="alert"` bar as in MCP `get_golden_page` `login-page`.
 - Note: `<MMessage>` today is primarily the **message service host** (`messages` / teleport). Do not invent a `severity` + default-slot Alert API unless docs add it.
 
 ```vue

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

@@ -1,15 +1,15 @@
 # Page layouts
 
-When generating a full page, pick a type and **mirror the golden-page block order**. Prefer project files when present:
-
-| Type | Golden page | Runnable example |
-| --- | --- | --- |
-| List | `docs/golden-pages/list-page.vue` | `src/examples/ListPageExample.vue` |
-| Form | `docs/golden-pages/form-page.vue` | `src/examples/FormPageExample.vue` |
-| Dashboard | `docs/golden-pages/dashboard-page.vue` | `src/examples/DashboardPageExample.vue` |
-| Login | `docs/golden-pages/login-page.vue` | `src/examples/LoginPageExample.vue` |
-| Landing | `docs/golden-pages/landing-page.vue` | `src/examples/LandingPageExample.vue` |
-| Empty | `docs/golden-pages/empty-state.vue` | `src/examples/EmptyStateExample.vue` |
+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 | `list-page` |
+| Form | `form-page` |
+| Dashboard | `dashboard-page` |
+| Login | `login-page` |
+| Landing | `landing-page` |
+| Empty | `empty-state` |
 
 Via MCP: `recommend_page` → `get_golden_page`; local edits: `get_page_snippet` (`filters`, `toolbar`, `form-actions`, `scrollable-panel`, …).
 

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

@@ -17,7 +17,7 @@ Pick a lane, then a surface. Prefer project golden pages for **Ops**; use the re
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Login / register | Authenticate with trust | Golden: `docs/golden-pages/login-page.vue` — split brand + `MForm` (`MInput`, `MInputPassword`); form-level errors via token `role="alert"` (not Toast) |
+| Login / register | Authenticate with trust | Golden: MCP `get_golden_page` `login-page` — split brand + `MForm` (`MInput`, `MInputPassword`); form-level errors via token `role="alert"` (not Toast) |
 | Invite / accept | Join org | Same shell; show org name clearly |
 | Forgot / reset | Recover access | Short form + success state with next step |
 | Profile / account | Edit self | Settings-like sections; avatar via `MAvatar` |
@@ -28,7 +28,7 @@ Keep credential forms quiet: one primary CTA, clear labels, no decorative noise
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Empty state | Invite first action | Golden: `docs/golden-pages/empty-state.vue` — `MEmpty` + primary/secondary `MButton` in `#extra` |
+| Empty state | Invite first action | Golden: MCP `get_golden_page` `empty-state` — `MEmpty` + primary/secondary `MButton` in `#extra` |
 | Onboarding | Teach the product path | `MStepper` or paced cards; one decision per step; finish → Ops home |
 | Wizard | Multi-step create | `MStepper` + `MForm` per step + sticky actions (`上一步` / `下一步` / `提交`) |
 | Success / result | Confirm completion | `MResult` (`status="success"` / `error` …) + next actions (`查看详情` / `返回列表`) |
@@ -51,7 +51,7 @@ Use when the brief is landing, pricing, launch, or docs marketing — **not** fo
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Landing | Convert / explain product | Golden: `docs/golden-pages/landing-page.vue` — one-job hero; CTAs → `MButton`; chips → `MTag`; FAQ → `MAccordion` |
+| Landing | Convert / explain product | Golden: MCP `get_golden_page` `landing-page` — one-job hero; CTAs → `MButton`; chips → `MTag`; FAQ → `MAccordion` |
 | Pricing | Choose a plan | Clear plan cards (`MCard`) + primary CTA; highlight recommended plan without clutter |
 | Feature showcase | Prove capability | Alternating media/copy; live `M*` demo only if lightweight |
 | Docs marketing chrome | Frame documentation | Header + nav using `M*` where suitable; content area stays readable |

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

@@ -23,7 +23,7 @@ import { MButton, MInput } from 'morya-ui'
   - 单行操作结果 → `message.success/info/warn/error('…')`
   - 有标题 + 详情 / 异步通知 → `toast.*({ summary, detail })`
   - 表单区常驻错误 → `<MMessage>` 或字段 `errorMessage`
-  - 详见 `docs/feedback-message-vs-toast.md`
+  - 详见 skill `references/feedback.md`
 
 ## Props 约定
 
@@ -38,4 +38,4 @@ import { MButton, MInput } from 'morya-ui'
 - 用 `MDropdown` 代替 Select 做枚举选择。
 - 手写 table/modal 替代 `MTable` / `MDialog`。
 
-完整清单：`docs/components.md`
+完整清单：MCP，或 skill `references/component-index.md`

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

@@ -1,17 +1,17 @@
 ---
-description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md 与 design-tokens。
+description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md。
 alwaysApply: true
 ---
 
 # Morya UI 设计系统
 
-1. **先读** 项目根目录 `DESIGN.md`，再读 `docs/components.md`。
+1. **先读** 项目根目录 `DESIGN.md`。组件选型用 MCP，或 skill `references/component-index.md`。
 2. **只用** `morya-ui` 的 `M*` 组件；全局样式 `morya-ui/styles.css`。
 3. **颜色/间距/圆角** 使用 `--m-*` CSS 变量，禁止裸 hex/rgb（见 `scripts/check-raw-colors.mjs`）。
-4. **页面结构** 对齐 `docs/golden-pages/`（列表 / 表单 / 仪表盘 / 登录 / 落地 / 空状态），不要发明新布局范式。
+4. **页面结构** 用 MCP `get_golden_page`（`list-page` / `form-page` / `dashboard-page` / `login-page` / `landing-page` / `empty-state`），不要发明新布局范式。
 5. **表单选项** 用 `MSelect` / `MTreeSelect`；**动作菜单** 用 `MDropdown`。
 6. 不确定 API 时查文档站或 MCP，**禁止臆造 prop**。
 7. 根节点用 `MConfigProvider`；后台布局用 `MLayout` 系列。
-8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用 `<MMessage>`。见 `docs/feedback-message-vs-toast.md`。
+8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用 `<MMessage>`。见 skill `references/feedback.md`。
 
-Token 参考：`design-tokens/tokens.json`
+Token 参考：MCP `get_design_rules`（运行时以 `morya-ui/styles.css` 为准）