@morya-ui/setup 0.2.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

@@ -0,0 +1,93 @@
+# @morya-ui/setup
+
+One-shot setup for consumer Vue projects using [`morya-ui`](https://www.npmjs.com/package/morya-ui).
+
+Docs (zh/en):
+
+- [AI setup](https://morya-space.github.io/morya-ui/docs/ai-setup) — one-shot CLI
+- [Agent Skill](https://morya-space.github.io/morya-ui/docs/agent-skill) — `morya-ui-pages` behavior
+
+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), and tries to inject `import 'morya-ui/styles.css'` into the app entry.
+
+## Usage
+
+In your app project root:
+
+```bash
+npx @morya-ui/setup
+```
+
+### Options
+
+| Flag | Meaning |
+| --- | --- |
+| `--cwd <dir>` | Target project root (default: current directory) |
+| `--pm pnpm\|yarn\|npm` | Package manager (default: detect from lockfile, else `pnpm`) |
+| `--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-template` | Do not copy AI skill / rules / docs / tokens |
+| `--skip-mcp` | Do not write `.cursor/mcp.json` |
+| `--skip-styles` | Do not inject `styles.css` import |
+| `--skip-scripts` | Do not add `check:colors` to `package.json` |
+| `-h`, `--help` | Show help |
+
+### Conflict policy
+
+- Template files and `.cursor/rules/*`: **skip** if the destination exists (unless `--force`).
+- `.cursor/mcp.json`: merge other servers; skip existing `morya-ui` entry unless `--force`.
+- `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.
+
+### What gets copied
+
+From the package `template/` (synced from repo `ai-design-config/`):
+
+- `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/`
+
+### MCP (Cursor)
+
+Writes / merges:
+
+```json
+{
+  "mcpServers": {
+    "morya-ui": {
+      "command": "npx",
+      "args": ["-y", "@morya-ui/mcp"]
+    }
+  }
+}
+```
+
+Restart Cursor (or reload MCP) after setup.
+
+Other clients can use the same stdio command; this CLI only writes `.cursor/mcp.json`.
+
+### Styles
+
+Looks for `src/main.ts` / `.js` / `.tsx` / `.jsx`, root `main.*`, `src/app.ts` / `.js`, or the module script in `index.html`. If none match, add manually:
+
+```ts
+import 'morya-ui/styles.css'
+```
+
+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:build
+node packages/setup/bin/morya-ui-setup.js --cwd /path/to/app --dry-run
+```
+
+## License
+
+MIT

package/bin/morya-ui-setup.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { parseArgs, printHelp, runSetup } from '../src/cli.mjs'
+
+try {
+  const options = parseArgs(process.argv.slice(2))
+  if (options.help) {
+    printHelp()
+    process.exit(0)
+  }
+  await runSetup(options)
+} catch (error) {
+  console.error(error instanceof Error ? error.message : error)
+  process.exit(1)
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@morya-ui/setup",
+  "type": "module",
+  "version": "0.2.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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/morya-space/morya-ui.git",
+    "directory": "packages/setup"
+  },
+  "bugs": {
+    "url": "https://github.com/morya-space/morya-ui/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "morya-ui-setup": "./bin/morya-ui-setup.js"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "src",
+    "template"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "sync-template": "node ./scripts/sync-template.mjs",
+    "build": "pnpm run sync-template"
+  }
+}

package/src/cli.mjs

@@ -0,0 +1,200 @@
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { copyTemplate } from './copy-template.mjs'
+import { installMoryaUi } from './install.mjs'
+import { mergeMcpConfig } from './mcp.mjs'
+import { ensureCheckColorsScript } from './package-json.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 SKIP_FLAGS = {
+  '--skip-install': 'skipInstall',
+  '--skip-template': 'skipTemplate',
+  '--skip-mcp': 'skipMcp',
+  '--skip-styles': 'skipStyles',
+  '--skip-scripts': 'skipScripts',
+}
+
+export function printHelp() {
+  console.log(`Usage: morya-ui-setup [options]
+
+One-shot setup for morya-ui in a consumer Vue project:
+  - install morya-ui
+  - copy DESIGN.md, Agent skill, Cursor rules, docs, tokens, examples
+  - merge .cursor/mcp.json for @morya-ui/mcp
+  - inject import 'morya-ui/styles.css' into the app entry when found
+  - add check:colors script when missing
+
+Options:
+  --cwd <dir>       Target project root (default: process.cwd())
+  --pm <name>       Package manager: pnpm | yarn | npm (auto-detect by lockfile)
+  --force           Overwrite existing template files and MCP server entry
+  --dry-run         Print actions without writing or installing
+  --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 import
+  --skip-scripts    Skip adding check:colors to package.json
+  -h, --help        Show this help
+`)
+}
+
+/**
+ * @param {string[]} argv
+ */
+export function parseArgs(argv) {
+  const options = {
+    cwd: process.cwd(),
+    pm: undefined,
+    force: false,
+    dryRun: false,
+    skipInstall: false,
+    skipTemplate: false,
+    skipMcp: false,
+    skipStyles: false,
+    skipScripts: false,
+    help: false,
+  }
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+    if (arg === '-h' || arg === '--help') {
+      options.help = true
+      continue
+    }
+    if (arg === '--force') {
+      options.force = true
+      continue
+    }
+    if (arg === '--dry-run') {
+      options.dryRun = true
+      continue
+    }
+    if (SKIP_FLAGS[arg]) {
+      options[SKIP_FLAGS[arg]] = true
+      continue
+    }
+    if (arg === '--cwd') {
+      const value = argv[++i]
+      if (!value) throw new Error('--cwd requires a path')
+      options.cwd = resolve(value)
+      continue
+    }
+    if (arg.startsWith('--cwd=')) {
+      options.cwd = resolve(arg.slice('--cwd='.length))
+      continue
+    }
+    if (arg === '--pm') {
+      const value = argv[++i]
+      if (!value) throw new Error('--pm requires pnpm, yarn, or npm')
+      options.pm = value
+      continue
+    }
+    if (arg.startsWith('--pm=')) {
+      options.pm = arg.slice('--pm='.length)
+      continue
+    }
+    throw new Error(`Unknown argument: ${arg}`)
+  }
+
+  return options
+}
+
+function rel(cwd, path) {
+  if (!path) return ''
+  return path.startsWith(cwd) ? path.slice(cwd.length).replace(/^[\\/]/, '') || path : path
+}
+
+/**
+ * @param {ReturnType<typeof parseArgs>} options
+ */
+export async function runSetup(options) {
+  const {
+    cwd,
+    force,
+    dryRun,
+    skipInstall,
+    skipTemplate,
+    skipMcp,
+    skipStyles,
+    skipScripts,
+    pm,
+  } = options
+
+  console.log(`@morya-ui/setup → ${cwd}${dryRun ? ' (dry-run)' : ''}`)
+  console.log('')
+
+  const install = installMoryaUi(cwd, { pm, dryRun, skipInstall })
+
+  const template = skipTemplate
+    ? { copied: [], skipped: [], forced: [], skippedStep: true }
+    : copyTemplate(TEMPLATE_ROOT, cwd, { force, dryRun })
+
+  const mcp = skipMcp
+    ? { path: join(cwd, '.cursor', 'mcp.json'), action: 'skipped-flag' }
+    : mergeMcpConfig(cwd, { force, dryRun })
+
+  const styles = skipStyles
+    ? { action: 'skipped', reason: 'skip-styles' }
+    : ensureStylesImport(cwd, { dryRun })
+
+  const scripts = skipScripts
+    ? { action: 'skipped-flag' }
+    : ensureCheckColorsScript(cwd, { force, dryRun })
+
+  console.log('--- Summary ---')
+  if (install.skipped) {
+    console.log(`Install: skipped (${install.reason}) — would run: ${install.command}`)
+  } else {
+    console.log(`Install: ok (${install.pm}) — ${install.command}`)
+  }
+
+  if (template.skippedStep) {
+    console.log('Template: skipped (--skip-template)')
+  } else {
+    console.log(
+      `Template: ${template.copied.length} copied, ${template.forced.length} overwritten, ${template.skipped.length} skipped`,
+    )
+    if (template.skipped.length && template.skipped.length <= 8) {
+      for (const file of template.skipped) console.log(`  skip ${file}`)
+    } else if (template.skipped.length > 8) {
+      for (const file of template.skipped.slice(0, 5)) console.log(`  skip ${file}`)
+      console.log(`  … and ${template.skipped.length - 5} more (use --force to overwrite)`)
+    }
+  }
+
+  if (mcp.action === 'skipped-flag') {
+    console.log('MCP: skipped (--skip-mcp)')
+  } else {
+    console.log(`MCP: ${mcp.action} (${rel(cwd, mcp.path) || '.cursor/mcp.json'})`)
+  }
+
+  if (styles.reason === 'skip-styles') {
+    console.log('Styles: skipped (--skip-styles)')
+  } else if (styles.action === 'injected') {
+    console.log(`Styles: injected into ${rel(cwd, styles.path)}`)
+  } else if (styles.action === 'skipped') {
+    console.log(`Styles: skipped (${styles.reason}) in ${rel(cwd, styles.path)}`)
+  } else {
+    console.log('Styles: no entry file found — add manually:')
+    console.log("  import 'morya-ui/styles.css'")
+  }
+
+  if (scripts.action === 'skipped-flag') {
+    console.log('Scripts: skipped (--skip-scripts)')
+  } else {
+    console.log(`Scripts: check:colors ${scripts.action}`)
+  }
+
+  console.log('')
+  console.log('Next:')
+  console.log('  1. Ensure the styles import is in your app entry (if not injected).')
+  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, scripts }
+}

package/src/copy-template.mjs

@@ -0,0 +1,62 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs'
+import { dirname, join, relative } from 'node:path'
+
+/**
+ * Recursively list files under dir (relative to dir).
+ * @param {string} dir
+ * @returns {string[]}
+ */
+function listFiles(dir) {
+  const out = []
+  function walk(current) {
+    for (const name of readdirSync(current)) {
+      const full = join(current, name)
+      const st = statSync(full)
+      if (st.isDirectory()) walk(full)
+      else out.push(relative(dir, full))
+    }
+  }
+  walk(dir)
+  return out
+}
+
+/**
+ * Copy template tree into target cwd.
+ * @returns {{ copied: string[], skipped: string[], forced: string[] }}
+ */
+export function copyTemplate(templateRoot, cwd, { force = false, dryRun = false } = {}) {
+  const copied = []
+  const skipped = []
+  const forced = []
+
+  if (!existsSync(templateRoot)) {
+    throw new Error(
+      `Template missing at ${templateRoot}. Run sync-template / build before publishing.`,
+    )
+  }
+
+  const files = listFiles(templateRoot)
+  for (const rel of files) {
+    const from = join(templateRoot, rel)
+    const to = join(cwd, rel)
+    const exists = existsSync(to)
+
+    if (exists && !force) {
+      skipped.push(rel)
+      continue
+    }
+
+    if (dryRun) {
+      if (exists) forced.push(rel)
+      else copied.push(rel)
+      continue
+    }
+
+    mkdirSync(dirname(to), { recursive: true })
+    cpSync(from, to)
+    if (exists) forced.push(rel)
+    else copied.push(rel)
+  }
+
+  return { copied, skipped, forced }
+}

package/src/fs-utils.mjs

@@ -0,0 +1,23 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname } from 'node:path'
+
+export function readJson(path) {
+  return JSON.parse(readFileSync(path, 'utf8'))
+}
+
+export function writeJson(path, value, { dryRun = false } = {}) {
+  const text = `${JSON.stringify(value, null, 2)}\n`
+  if (dryRun) return text
+  mkdirSync(dirname(path), { recursive: true })
+  writeFileSync(path, text, 'utf8')
+  return text
+}
+
+export function ensureDir(path, { dryRun = false } = {}) {
+  if (dryRun || existsSync(path)) return
+  mkdirSync(path, { recursive: true })
+}
+
+export function fileExists(path) {
+  return existsSync(path)
+}

package/src/install.mjs

@@ -0,0 +1,63 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { execSync } from 'node:child_process'
+
+const LOCKFILES = [
+  { pm: 'pnpm', file: 'pnpm-lock.yaml' },
+  { pm: 'yarn', file: 'yarn.lock' },
+  { pm: 'npm', file: 'package-lock.json' },
+]
+
+export function detectPackageManager(cwd, explicit) {
+  if (explicit) {
+    if (!['pnpm', 'yarn', 'npm'].includes(explicit)) {
+      throw new Error(`Unsupported --pm value: ${explicit}. Use pnpm, yarn, or npm.`)
+    }
+    return explicit
+  }
+  for (const { pm, file } of LOCKFILES) {
+    if (existsSync(join(cwd, file))) return pm
+  }
+  return 'pnpm'
+}
+
+function installCommand(pm) {
+  switch (pm) {
+    case 'pnpm':
+      return 'pnpm add morya-ui'
+    case 'yarn':
+      return 'yarn add morya-ui'
+    case 'npm':
+      return 'npm install morya-ui'
+    default:
+      throw new Error(`Unknown package manager: ${pm}`)
+  }
+}
+
+/**
+ * @returns {{ pm: string, command: string, skipped?: boolean, reason?: string }}
+ */
+export function installMoryaUi(cwd, { pm, dryRun = false, skipInstall = false } = {}) {
+  const resolved = detectPackageManager(cwd, pm)
+  const command = installCommand(resolved)
+
+  if (skipInstall) {
+    return { pm: resolved, command, skipped: true, reason: 'skip-install' }
+  }
+
+  if (!existsSync(join(cwd, 'package.json'))) {
+    return {
+      pm: resolved,
+      command,
+      skipped: true,
+      reason: 'no-package-json',
+    }
+  }
+
+  if (dryRun) {
+    return { pm: resolved, command, skipped: true, reason: 'dry-run' }
+  }
+
+  execSync(command, { cwd, stdio: 'inherit', shell: true })
+  return { pm: resolved, command }
+}

package/src/mcp.mjs

@@ -0,0 +1,50 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { readJson, writeJson } from './fs-utils.mjs'
+
+const SERVER_NAME = 'morya-ui'
+const SERVER_CONFIG = {
+  command: 'npx',
+  args: ['-y', '@morya-ui/mcp'],
+}
+
+/**
+ * Merge Cursor MCP config for morya-ui.
+ * @returns {{ path: string, action: 'created' | 'merged' | 'skipped' | 'forced', dryRun?: boolean }}
+ */
+export function mergeMcpConfig(cwd, { force = false, dryRun = false } = {}) {
+  const path = join(cwd, '.cursor', 'mcp.json')
+  const exists = existsSync(path)
+
+  let data = { mcpServers: {} }
+  if (exists) {
+    try {
+      data = readJson(path)
+    } catch {
+      throw new Error(`Invalid JSON in ${path}`)
+    }
+    if (!data || typeof data !== 'object') {
+      throw new Error(`Invalid MCP config shape in ${path}`)
+    }
+    if (!data.mcpServers || typeof data.mcpServers !== 'object') {
+      data.mcpServers = {}
+    }
+  }
+
+  const hasExisting = Boolean(data.mcpServers[SERVER_NAME])
+  if (hasExisting && !force) {
+    return { path, action: 'skipped' }
+  }
+
+  data.mcpServers[SERVER_NAME] = { ...SERVER_CONFIG }
+
+  if (!dryRun) {
+    writeJson(path, data)
+  }
+
+  let action = 'created'
+  if (exists && hasExisting && force) action = 'forced'
+  else if (exists) action = 'merged'
+
+  return { path, action, dryRun }
+}

package/src/package-json.mjs

@@ -0,0 +1,30 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { readJson, writeJson } from './fs-utils.mjs'
+
+const CHECK_COLORS = 'node scripts/check-raw-colors.mjs'
+
+/**
+ * @returns {{ action: 'added' | 'skipped' | 'missing-package-json', dryRun?: boolean }}
+ */
+export function ensureCheckColorsScript(cwd, { force = false, dryRun = false } = {}) {
+  const path = join(cwd, 'package.json')
+  if (!existsSync(path)) {
+    return { action: 'missing-package-json' }
+  }
+
+  const pkg = readJson(path)
+  pkg.scripts = pkg.scripts || {}
+
+  if (pkg.scripts['check:colors'] && !force) {
+    return { action: 'skipped' }
+  }
+
+  pkg.scripts['check:colors'] = CHECK_COLORS
+
+  if (!dryRun) {
+    writeJson(path, pkg)
+  }
+
+  return { action: 'added', dryRun }
+}