@morya-ui/setup 0.2.7 → 0.2.8

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 Agent skill / Cursor rules / design docs from `design-kit`, 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
 
@@ -40,7 +40,7 @@ npx @morya-ui/setup app
 | `--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 |
 
@@ -64,12 +64,7 @@ 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/`
-
-`morya-app-shell.css` is written by the CLI (not copied from the template tree).
 
 ### MCP (Cursor)
 
@@ -96,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`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/setup",
   "type": "module",
-  "version": "0.2.7",
+  "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

@@ -6,7 +6,7 @@ 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, '..')
@@ -14,15 +14,12 @@ const TEMPLATE_ROOT = join(PKG_ROOT, 'template')
 
 const MODES = new Set(['app', 'ai', 'full'])
 
-/** AI pack paths under template/ (excludes runtime src/styles — owned by app mode). */
+/** AI pack paths under template/. */
 const AI_TEMPLATE_INCLUDE = [
   'DESIGN.md',
   '.agents/skills/morya-ui-pages',
   '.cursor/rules',
-  'docs',
-  'design-tokens',
   'scripts/check-raw-colors.mjs',
-  'src/examples',
 ]
 
 /** Mode → default skips (user --skip-* can only add more skips). */
@@ -45,16 +42,15 @@ export function printHelp() {
 
 Commands:
   (default) / full  Install morya-ui, AI template, MCP, styles, check:colors
-  app               Install morya-ui and inject styles / app-shell CSS
-  ai                Copy Agent skill / rules / DESIGN / docs / tokens / examples,
+  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 and inject its import
   - add check:colors script when missing
 
 Options:
@@ -65,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
 `)
@@ -210,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 })
@@ -256,17 +248,6 @@ export async function runSetup(options) {
     console.log("  import 'morya-ui/styles.css'")
   }
 
-  if (shell.reason === 'skip-styles') {
-    console.log('Shell CSS: skipped (--skip-styles or ai mode)')
-  } 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 or app mode)')
   } else {
@@ -276,18 +257,18 @@ export async function runSetup(options) {
   console.log('')
   console.log('Next:')
   if (mode === 'app') {
-    console.log('  1. Ensure styles.css + morya-app-shell.css imports are in your app entry.')
+    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 styles.css + morya-app-shell.css imports are in your app entry.')
+    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 { mode, install, template, mcp, styles, shell, scripts }
+  return { mode, install, template, mcp, styles, scripts }
 }

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` 为准）

package/template/.cursor/rules/page-layout.mdc

@@ -7,14 +7,14 @@ alwaysApply: false
 
 生成完整页面时，先确定类型并 **复制黄金样例结构**：
 
-| 类型 | 模板 |
+| 类型 | MCP `get_golden_page` |
 | --- | --- |
-| 列表页 | `docs/golden-pages/list-page.vue` |
-| 表单页 | `docs/golden-pages/form-page.vue`（仅长表单 / 独立配置页） |
-| 仪表盘 | `docs/golden-pages/dashboard-page.vue` |
-| 登录页 | `docs/golden-pages/login-page.vue` |
-| 营销落地 | `docs/golden-pages/landing-page.vue` |
-| 空状态 | `docs/golden-pages/empty-state.vue` |
+| 列表页 | `list-page` |
+| 表单页 | `form-page`（仅长表单 / 独立配置页） |
+| 仪表盘 | `dashboard-page` |
+| 登录页 | `login-page` |
+| 营销落地 | `landing-page` |
+| 空状态 | `empty-state` |
 
 ## 列表内新建 / 编辑（默认）
 
@@ -69,5 +69,3 @@ alwaysApply: false
 - 整页：`recommend_page` → `get_golden_page` → `get_design_rules`
 - 局部：`get_page_snippet`（如 `filters` / `toolbar` / `form-actions` / `scrollable-panel`）
 - 可选：`validate_page`（参考建议，不阻断）
-
-引用可运行示例：`src/examples/*PageExample.vue`

package/template/DESIGN.md

@@ -1,6 +1,6 @@
 # Morya UI 设计系统（AI 第一信源）
 
-> 基于 `morya-ui` v0.2.6。生成或审查业务页面时，**必须先遵守本文**，再查阅 `docs/components.md` 与 `docs/golden-pages/`。
+> 基于 `morya-ui` v0.2.6。生成或审查业务页面时，**必须先遵守本文**。样例用 MCP `get_golden_page`，组件 API 用 MCP，反馈选型见 `morya-ui-pages` skill 的 `references/feedback.md`。
 
 ## 1. 设计原则
 
@@ -49,14 +49,14 @@ import 'morya-ui/styles.css'
 
 ## 3. 页面类型与黄金样例
 
-| 类型 | 参考文件 | 必备区块 |
+| 类型 | MCP `get_golden_page` | 必备区块 |
 | --- | --- | --- |
-| 列表页 | `docs/golden-pages/list-page.vue` | 面包屑、筛选区、工具栏、表格、分页 |
-| 表单页 | `docs/golden-pages/form-page.vue` | 面包屑、分组表单、`MForm` / `MFormItem`、提交/取消 |
-| 仪表盘 | `docs/golden-pages/dashboard-page.vue` | 统计卡片栅格、图表区占位、快捷入口 / 最近列表 |
-| 登录页 | `docs/golden-pages/login-page.vue` | 品牌区 + `MForm` / `MInputPassword`；表单级错误用 token 告警条 |
-| 营销落地 | `docs/golden-pages/landing-page.vue` | 单任务首屏、分节、`MButton` / `MTag` / `MAccordion` |
-| 空状态 | `docs/golden-pages/empty-state.vue` | `MEmpty` + 说明 + 主 CTA；可嵌列表 `#empty` |
+| 列表页 | `list-page` | 面包屑、筛选区、工具栏、表格、分页 |
+| 表单页 | `form-page` | 面包屑、分组表单、`MForm` / `MFormItem`、提交/取消 |
+| 仪表盘 | `dashboard-page` | 统计卡片栅格、图表区占位、快捷入口 / 最近列表 |
+| 登录页 | `login-page` | 品牌区 + `MForm` / `MInputPassword`；表单级错误用 token 告警条 |
+| 营销落地 | `landing-page` | 单任务首屏、分节、`MButton` / `MTag` / `MAccordion` |
+| 空状态 | `empty-state` | `MEmpty` + 说明 + 主 CTA；可嵌列表 `#empty` |
 
 生成 **Ops** 页面时：结构对齐对应黄金样例，用 `MPage*` 拼装，尽量少写 scoped CSS。  
 生成 **Account / Express / Flow** 页面时：对齐上表样例；允许有节制的 scoped 布局，但颜色/间距仍用 `--m-*`。
@@ -65,7 +65,7 @@ import 'morya-ui/styles.css'
 
 - 使用 `MForm` + `MFormItem`，`name` 与校验规则对应。
 - **从列表新建/编辑（字段约 ≤8、单段表单）默认用 `MDialog` + `MForm`，不要为每个实体再开独立路由表单页。**
-- 多分组、长流程、向导式录入再用独立表单页（`docs/golden-pages/form-page.vue`）或 `MDrawer`。
+- 多分组、长流程、向导式录入再用独立表单页（MCP `get_golden_page` `form-page`）或 `MDrawer`。
 - 字段组件自带 `label` / `invalid` / `helpText` 时优先用组件 prop（如 `MInput`、`MSelect`），复杂表单再用 `MFormItem` 包一层。
 - 尺寸：默认 medium；密集后台可 `size="small"` 或 ConfigProvider `globalDensity`。
 - 宽度：筛选项 `fluid` 慎用；独立表单页主栏 `max-width: 40rem` 左右。
@@ -88,11 +88,11 @@ import 'morya-ui/styles.css'
 | 表单区常驻错误 | token 告警条 / 字段 `errorMessage` |
 | 字段说明 | `MTooltip` |
 
-**选型细则见 [`docs/feedback-message-vs-toast.md`](docs/feedback-message-vs-toast.md)。AI 生成代码时：无 `detail` 的操作回执一律用 `message`，不要默认 Toast。**
+**选型细则见 `morya-ui-pages` skill 的 `references/feedback.md`。AI 生成代码时：无 `detail` 的操作回执一律用 `message`，不要默认 Toast。**
 
 ## 7. 设计令牌（摘要）
 
-完整定义见 `design-tokens/tokens.json`。
+完整定义见 MCP `get_design_rules`。运行时以 `morya-ui/styles.css` 为准。
 
 | 用途 | 变量 |
 | --- | --- |
@@ -117,11 +117,11 @@ import 'morya-ui/styles.css'
 ## 9. AI 工作流
 
 1. 读本文 → 确定页面类型（列表 / 表单 / 仪表盘）。
-2. 打开对应 `docs/golden-pages/*.vue` 与 `src/examples/*.vue`。
-3. 查 `docs/components.md` 选型。
+2. 用 MCP `get_golden_page` 读取对应样例。
+3. 用 MCP `search` / `get_component` / `recommend_component` 选型。
 4. 不确定 API 时查文档站或 MCP，**不要臆造 prop 名**。
 5. 完成后运行 `pnpm check:colors`（若已配置）。
-6. 操作反馈见 `docs/feedback-message-vs-toast.md`：**默认 `message`，有 detail 才用 `toast`**。
+6. 操作反馈见 skill `references/feedback.md`：**默认 `message`，有 detail 才用 `toast`**。
 
 ## 10. 相关资源
 

package/template/design-tokens/tokens.css

@@ -1,55 +0,0 @@
-/**
- * Morya UI design tokens (compiled view for AI / static tooling).
- * Runtime source of truth: morya-ui/styles.css
- * Do not hand-edit hex values in business code — use --m-* variables.
- */
-:root {
-    --m-color-primary: #2563eb;
-    --m-color-primary-hover: #1d4ed8;
-    --m-color-surface: #ffffff;
-    --m-color-text: #0f172a;
-    --m-color-text-muted: #64748b;
-    --m-color-border: #e2e8f0;
-    --m-color-focus-ring: #2563eb;
-    --m-color-success: #159570;
-    --m-color-info: #2563eb;
-    --m-color-warning: #d97706;
-    --m-color-help: #9333ea;
-    --m-color-danger: #dc2626;
-    --m-color-contrast: #0f172a;
-    --m-color-contrast-fg: #ffffff;
-    --m-overlay-scrim: rgb(15 23 42 / 0.55);
-
-    --m-control-height-small: 28px;
-    --m-control-height-medium: 34px;
-    --m-control-height-large: 40px;
-    --m-radius-control: 3px;
-    --m-space-1: 0.25rem;
-    --m-space-2: 0.5rem;
-    --m-space-3: 0.75rem;
-    --m-space-4: 1rem;
-    --m-space-6: 1.5rem;
-    --m-space-8: 2rem;
-    --m-radius-sm: 0.25rem;
-    --m-radius-md: 0.5rem;
-    --m-radius-lg: 0.75rem;
-    --m-shadow-sm: 0 1px 2px rgb(15 23 42 / 0.25);
-    --m-shadow-md: 0 0.75rem 2rem rgb(15 23 42 / 0.16);
-    --m-shadow-lg: 0 1rem 3rem rgb(15 23 42 / 0.25);
-    --m-font-sans: Inter, ui-sans-serif, system-ui, sans-serif;
-    --m-motion-fast: 150ms;
-    --m-motion-normal: 250ms;
-    --m-motion-ease: cubic-bezier(0.2, 0, 0, 1);
-    --m-z-base: 1000;
-}
-
-[data-theme="dark"] {
-    --m-color-primary: #60a5fa;
-    --m-color-primary-hover: #93c5fd;
-    --m-color-surface: #0f172a;
-    --m-color-text: #f8fafc;
-    --m-color-text-muted: #94a3b8;
-    --m-color-border: #334155;
-    --m-color-danger: #fca5a5;
-    --m-overlay-scrim: rgb(2 6 23 / 0.72);
-}

package/template/design-tokens/tokens.json

@@ -1,77 +0,0 @@
-{
-  "$schema": "https://design-tokens.github.io/community-group/format/",
-  "meta": {
-    "name": "morya-ui",
-    "version": "0.2.6",
-    "source": "morya-ui/src/theme/styles.css",
-    "prefix": "m"
-  },
-  "color": {
-    "primary": { "value": "#2563eb", "dark": "#60a5fa" },
-    "primary-hover": { "value": "#1d4ed8", "dark": "#93c5fd" },
-    "surface": { "value": "#ffffff", "dark": "#0f172a" },
-    "text": { "value": "#0f172a", "dark": "#f8fafc" },
-    "text-muted": { "value": "#64748b", "dark": "#94a3b8" },
-    "border": { "value": "#e2e8f0", "dark": "#334155" },
-    "focus-ring": { "value": "#2563eb", "dark": "#93c5fd" },
-    "success": { "value": "#159570", "dark": "#5eead4" },
-    "info": { "value": "#2563eb", "dark": "#93c5fd" },
-    "warning": { "value": "#d97706", "dark": "#fbbf24" },
-    "help": { "value": "#9333ea", "dark": "#c084fc" },
-    "danger": { "value": "#dc2626", "dark": "#fca5a5" },
-    "contrast": { "value": "#0f172a", "dark": "#f8fafc" },
-    "contrast-fg": { "value": "#ffffff", "dark": "#0f172a" },
-    "overlay-scrim": { "value": "rgb(15 23 42 / 0.55)", "dark": "rgb(2 6 23 / 0.72)" }
-  },
-  "control": {
-    "height": { "small": "28px", "medium": "34px", "large": "40px" },
-    "font": { "small": "14px", "medium": "14px", "large": "15px" },
-    "padding-x": { "small": "10px", "medium": "12px", "large": "14px" },
-    "affix-size": "2rem"
-  },
-  "space": {
-    "1": "0.25rem",
-    "2": "0.5rem",
-    "3": "0.75rem",
-    "4": "1rem",
-    "6": "1.5rem",
-    "8": "2rem"
-  },
-  "radius": {
-    "control": "3px",
-    "sm": "0.25rem",
-    "md": "0.5rem",
-    "lg": "0.75rem",
-    "full": "9999px"
-  },
-  "shadow": {
-    "sm": "0 1px 2px rgb(15 23 42 / 0.25)",
-    "md": "0 0.75rem 2rem rgb(15 23 42 / 0.16)",
-    "lg": "0 1rem 3rem rgb(15 23 42 / 0.25)"
-  },
-  "font": {
-    "sans": "Inter, ui-sans-serif, system-ui, sans-serif",
-    "size": { "xs": "0.75rem", "sm": "0.8125rem", "md": "0.875rem", "lg": "1.125rem" }
-  },
-  "motion": {
-    "fast": "150ms",
-    "normal": "250ms",
-    "ease": "cubic-bezier(0.2, 0, 0, 1)"
-  },
-  "zIndex": {
-    "base": 1000,
-    "dropdown": "calc(var(--m-z-base) + 50)",
-    "toast": "calc(var(--m-z-base) + 100)"
-  },
-  "cssVarMap": {
-    "color.primary": "--m-color-primary",
-    "color.surface": "--m-color-surface",
-    "color.text": "--m-color-text",
-    "color.textMuted": "--m-color-text-muted",
-    "color.border": "--m-color-border",
-    "color.danger": "--m-color-danger",
-    "space.4": "--m-space-4",
-    "radius.md": "--m-radius-md",
-    "shadow.md": "--m-shadow-md"
-  }
-}