tha-cli 0.0.0-stage → 0.1.1

package/tha/commands/init.mjs

@@ -0,0 +1,262 @@
+import path from 'node:path'
+import * as readline from 'node:readline/promises'
+import { stdin, stdout } from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { API_RE, NAME_RE, PATH_RE, normalizeUrlPath } from '../config/schema.mjs'
+import { renderInitConfig } from '../config/template.mjs'
+import { CONFIG_FILE, DEFAULT_DIRS, loadDirs, relPath } from '../config/paths.mjs'
+import { parseArgs } from '../utils/args.mjs'
+import { absolute, exists, read, writeAtomic } from '../utils/files.mjs'
+import { glyph, ui } from '../utils/style.mjs'
+import { printNextSteps } from '../utils/output.mjs'
+
+// 生成物会 import 的基线文件：空项目里没有，init 时补上（不覆盖已有文件）
+const BASELINE = [
+  ['ThaCrudPage.vue', ['components', 'tha/ThaCrudPage.vue']],
+  ['ThaDetail.vue', ['components', 'tha/ThaDetail.vue']],
+  ['ThaForm.vue', ['components', 'tha/ThaForm.vue']],
+  ['request.ts', ['utils', 'request.ts']],
+  ['transport.ts', ['utils', 'transport.ts']]
+]
+
+const KIT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'kit')
+
+export async function runInit({ root, args }) {
+  const { flags, positional } = parseArgs(args, {
+    boolean: ['force', 'dry-run', 'json', 'help', 'bare', 'config'],
+    value: ['title', 'path', 'api']
+  })
+
+  if (flags.help) {
+    printInitHelp()
+    return
+  }
+
+  const { dirs } = loadDirs(root)
+
+  const needPrompt = stdin.isTTY && !flags.json
+  const rl = needPrompt
+    ? readline.createInterface({ input: stdin, output: stdout })
+    : null
+
+  try {
+    let name = positional[0]?.trim()
+
+    if (!name && rl) {
+      name = (
+        await ask(rl, {
+          cn: '模块名',
+          en: 'Module',
+          hint: 'lowercase or camelCase, e.g. doc, userProfile (小写或小驼峰，例如 doc、userProfile)',
+          fallback: ''
+        })
+      ).trim()
+    }
+    if (!name) {
+      throw new Error(
+        'Missing module (请提供模块名)\nUsage (用法): tha init <module>\nExample (示例): tha init doc'
+      )
+    }
+    if (!NAME_RE.test(name)) {
+      throw new Error(
+        `Invalid module name (模块名不合法): "${name}"\nExpected (期望): 小写开头，例如 doc、userProfile\nExample (示例): doc、userProfile`
+      )
+    }
+
+    const relativeConfig = relPath(dirs, 'domains', name, 'config.ts')
+    const configPath = absolute(root, relativeConfig)
+    if (exists(configPath) && !flags.force && !flags['dry-run']) {
+      throw new Error(
+        `${path.relative(root, configPath)} already exists (已存在)\nTo overwrite (覆盖请加): --force`
+      )
+    }
+
+    const title =
+      flags.title ??
+      (rl
+        ? await ask(rl, {
+            cn: '标题',
+            en: 'Title',
+            hint: 'shown in page and menu (显示在页面和菜单上)',
+            fallback: name
+          })
+        : name)
+    const routePath = normalizeUrlPath(
+      flags.path ??
+        (rl
+          ? await ask(rl, {
+              cn: '页面地址',
+              en: 'Page path',
+              hint: 'URL path shown in the browser, e.g. /doc (浏览器里的地址，例如 /doc)',
+              fallback: `/${name}`
+            })
+          : `/${name}`),
+      `/${name}`
+    )
+    const apiBase = normalizeUrlPath(
+      flags.api ??
+        (rl
+          ? await ask(rl, {
+              cn: '接口地址',
+              en: 'API path',
+              hint: 'API prefix, e.g. /docs (接口根路径，例如 /docs)',
+              fallback: `/${name}`
+            })
+          : `/${name}`),
+      `/${name}`
+    )
+
+    if (!PATH_RE.test(routePath)) {
+      throw new Error(
+        `Invalid page path (页面地址不合法): "${routePath}"\nExpected (期望): 以 / 开头，可多级\nExample (示例): /doc、/system/doc`
+      )
+    }
+    if (!API_RE.test(apiBase)) {
+      throw new Error(
+        `Invalid API path (接口地址不合法): "${apiBase}"\nExpected (期望): 以 / 开头，可多级\nExample (示例): /docs、/system/docs`
+      )
+    }
+
+    const template = renderInitConfig({
+      name,
+      title: title.trim() || name,
+      path: routePath,
+      apiBase
+    })
+
+    if (flags['dry-run']) {
+      if (flags.json) {
+        console.log(
+          JSON.stringify(
+            { created: false, dryRun: true, path: relativeConfig, config: template },
+            null,
+            2
+          )
+        )
+      } else {
+        console.log(template)
+      }
+      return
+    }
+
+    writeAtomic(configPath, template)
+
+    // 空项目基线：生成物要 import 的组件与工具，缺了就补（已有的不动）
+    const baseline = flags.bare ? { created: [], skipped: [] } : ensureBaseline(root, dirs)
+    const dirsConfig = flags.config ? ensureDirsConfig(root) : null
+
+    if (flags.json) {
+      console.log(
+        JSON.stringify(
+          {
+            created: true,
+            path: relativeConfig,
+            baseline: baseline.created,
+            kept: baseline.skipped,
+            dirsConfig
+          },
+          null,
+          2
+        )
+      )
+      return
+    }
+
+    console.log('')
+    console.log(`  ${ui.success(glyph.ok)} ${ui.label('配置已创建', 'Config created')}`)
+    console.log(`    ${ui.path(relativeConfig)}`)
+
+    if (baseline.created.length > 0) {
+      console.log('')
+      console.log(`  ${ui.label('公共文件已补齐', 'Base files added')}`)
+      for (const file of baseline.created) console.log(`    ${ui.path(file)}`)
+      console.log(`    ${ui.muted('Delete them if your project already has these (生成出来的代码要用这些文件；已有自己的实现就删掉)')}`)
+    }
+    if (baseline.skipped.length > 0) {
+      console.log(`    ${ui.muted(`already exists, not overwritten: ${baseline.skipped.join(', ')} (已存在、未覆盖)`)}`)
+    }
+    if (dirsConfig) {
+      console.log(`  ${ui.muted(`目录映射示例已写入 ${dirsConfig}，改完删掉即回默认`)}`)
+    }
+
+    console.log('')
+    printNextSteps()
+  } finally {
+    rl?.close()
+  }
+}
+
+/**
+ * 补齐基线文件：只写不存在的，绝不覆盖
+ */
+function ensureBaseline(root, dirs) {
+  const created = []
+  const skipped = []
+
+  for (const [source, [key, ...rest]] of BASELINE) {
+    const targetRel = relPath(dirs, key, ...rest)
+    if (exists(absolute(root, targetRel))) {
+      skipped.push(targetRel)
+      continue
+    }
+
+    const from = path.join(KIT_DIR, source)
+    if (!exists(from)) continue
+
+    writeAtomic(absolute(root, targetRel), read(from))
+    created.push(targetRel)
+  }
+
+  return { created, skipped }
+}
+
+/**
+ * --config：写一份全默认值的 tha.config.json，方便直接改
+ */
+function ensureDirsConfig(root) {
+  const target = path.join(root, CONFIG_FILE)
+  if (exists(target)) return null
+
+  writeAtomic(target, `${JSON.stringify({ dirs: { ...DEFAULT_DIRS } }, null, 2)}\n`)
+  return CONFIG_FILE
+}
+
+async function ask(rl, { cn, en, hint, fallback }) {
+  const suffix = fallback ? ` ${ui.muted(`[${fallback}]`)}` : ''
+  const answer = (
+    await rl.question(
+      `  ${ui.accent('?')} ${ui.label(cn, en)}${suffix}\n` +
+        `    ${ui.muted(hint)}\n` +
+        `    ${ui.muted('›')} `
+    )
+  ).trim()
+  return answer || fallback || ''
+}
+
+function printInitHelp() {
+  console.log('')
+  console.log(`  ${ui.heading('初始化', 'init · create config')}`)
+  console.log(`  ${ui.rule(40)}`)
+  console.log('')
+  console.log(`  ${ui.label('用法', 'Usage')}`)
+  console.log(
+    `    ${ui.command('tha init')} <模块> [--title 标题] [--path /页面地址] [--api /接口地址]`
+  )
+  console.log(`    ${ui.muted('              [--force] [--bare] [--config] [--dry-run] [--json]')}`)
+  console.log('')
+  console.log(`  ${ui.label('例子', 'Examples')}`)
+  console.log(`    ${ui.muted('tha init doc')}`)
+  console.log(`    ${ui.muted('tha init doc --title 文档 --path /doc --api /docs')}`)
+  console.log(`    ${ui.muted('tha init doc --bare --dry-run')}`)
+  console.log('')
+  console.log(`  ${ui.label('说明', 'Notes')}`)
+  console.log(`    ${ui.bullet('config only (只创建模块 config.ts，不生成业务代码)')}`)
+  console.log(
+    `    ${ui.bullet('base files (同时补公共文件：组件 tha/*.vue、utils/request.ts、utils/transport.ts)')}`
+  )
+  console.log(`    ${ui.bullet('bare: config only (--bare 只写 config，不补公共文件)')}`)
+  console.log(`    ${ui.bullet('write dirs example (--config 额外写一份 tha.config.json 目录映射示例)')}`)
+  console.log(`    ${ui.bullet('run tha sync next (下一步运行 tha sync 生成标准增删改查页面)')}`)
+  console.log(`    ${ui.bullet('disable color (关闭颜色)')}`)
+  console.log('')
+}

package/tha/commands/remove.mjs

@@ -0,0 +1,328 @@
+import * as readline from 'node:readline/promises'
+import path from 'node:path'
+import { stdin, stdout } from 'node:process'
+import { loadProject } from '../config/project.mjs'
+import { importSpec, relPath } from '../config/paths.mjs'
+import { globalFiles } from '../generate/global.mjs'
+import { comparePlan } from '../utils/compare.mjs'
+import { parseArgs } from '../utils/args.mjs'
+import {
+  absolute,
+  exists,
+  isGenerated,
+  isEmptyDir,
+  listFiles,
+  read,
+  removeDir,
+  removeFile,
+  writeAll
+} from '../utils/files.mjs'
+import { glyph, ui } from '../utils/style.mjs'
+
+export async function runRemove({ root, args }) {
+  const { flags, positional } = parseArgs(args, {
+    boolean: ['json', 'help', 'dry-run', 'yes', 'purge']
+  })
+
+  if (flags.help) {
+    printRemoveHelp()
+    return
+  }
+
+  const name = positional[0]?.trim()
+  if (!name) {
+    throw new Error(
+      'Missing module (请提供模块名)\nUsage (用法): tha remove <module>\nExample (示例): tha remove doc'
+    )
+  }
+
+  // 目录映射先取一次：删除前后模块列表会变，但目录映射不变
+  const { dirs } = loadProject(root)
+  const configRel = relPath(dirs, 'domains', name, 'config.ts')
+  if (!exists(absolute(root, configRel))) {
+    throw new Error(`Module not found (没有模块): "${name}", ${configRel} does not exist`)
+  }
+
+  const targets = collectTargets(root, name, flags.purge, dirs)
+  const kept = collectKept(root, name, flags.purge, dirs)
+
+  if (flags['dry-run']) {
+    if (flags.json) {
+      console.log(
+        JSON.stringify(
+          {
+            ok: true,
+            dryRun: true,
+            module: name,
+            remove: targets.map((target) => target.rel),
+            keep: kept
+          },
+          null,
+          2
+        )
+      )
+    } else {
+      printHeader(`删除模块 ${name}`, 'Remove')
+      printTargets(targets, kept)
+    }
+    return
+  }
+
+  if (!flags.yes && !flags.json) {
+    if (!stdin.isTTY) {
+      throw new Error('Not a terminal, nothing deleted. Add --yes to delete. (现在不是终端，没删。要删请加 --yes。)')
+    }
+
+    if (!(await confirm(`\nRemove ${name}? ${targets.length} files will be deleted. (要删 ${name} 吗？会删 ${targets.length} 个文件) [y/N] `))) {
+      console.log('Cancelled, nothing deleted. (已取消，没有删除。)')
+      return
+    }
+  }
+
+  for (const target of targets) {
+    if (target.kind === 'dir') removeDir(target.path)
+    else removeFile(target.path)
+  }
+
+  cleanupEmptyDirs(root, name, dirs)
+
+  // 模块没了，全局路由/菜单必须跟着重算，否则旧路由会留在 generated 里
+  const project = loadProject(root)
+  const globals = comparePlan(globalFiles(project.domains, project.dirs), root).filter(
+    (entry) => entry.status === 'add' || entry.status === 'update'
+  )
+  writeAll(globals)
+
+  if (flags.json) {
+    console.log(
+      JSON.stringify(
+        {
+          ok: true,
+          module: name,
+          removed: targets.map((target) => target.rel),
+          keep: kept,
+          regenerated: globals.map((entry) => entry.path)
+        },
+        null,
+        2
+      )
+    )
+    return
+  }
+
+  console.log('')
+  console.log(
+    `  ${ui.success(glyph.ok)} ${ui.label(
+      `已删除 ${name}：${targets.length} 个文件`,
+      `${name} removed: ${targets.length} files`
+    )}`
+  )
+
+  if (kept.length > 0) {
+    console.log(`  ${ui.warning(glyph.warn)} ${ui.label('手写文件保留（默认不动）', 'Handwritten files kept')}`)
+    for (const file of kept) {
+      console.log(`    ${ui.path(file)}`)
+    }
+    console.log(`  ${ui.muted('To remove all (要连手写文件一起删): tha remove ' + name + ' --purge')}`)
+  }
+
+  // 保留的手写文件如果还 import 刚删掉的生成物，项目会直接编译不过 —— 必须让人看见
+  const dangling = findDanglingImports(root, name, kept, dirs)
+  if (dangling.length > 0) {
+    console.log(
+      `  ${ui.danger(glyph.warn)} ${ui.label(
+        '保留的文件还在引用刚删掉的代码，项目会编译不过',
+        'Kept files still import removed code'
+      )}`
+    )
+    for (const item of dangling) {
+      console.log(`    ${ui.path(item.file)} ${ui.muted(`→ ${item.missing}`)}`)
+    }
+    console.log(`  ${ui.muted('Remove the imports by hand, or (手动清掉这些引用，或): tha remove ' + name + ' --purge')}`)
+  }
+
+  console.log(`  ${ui.muted('routes and menu regenerated (全局路由/菜单已重算)')}`)
+  console.log('')
+}
+
+/**
+ * 保留的手写文件里，是否还 import 了本次删除的生成物（只提示，不改文件）
+ */
+function findDanglingImports(root, name, kept, dirs) {
+  const contextRel = relPath(dirs, 'domains', name, 'context.ts')
+  const crudRel = relPath(dirs, 'domains', name, 'executors/crud.generated.ts')
+  const permissionsRel = relPath(dirs, 'domains', name, 'permissions.ts')
+  const apiRel = relPath(dirs, 'api', `${name}.ts`)
+
+  const candidates = [
+    { marker: './context', missing: contextRel },
+    { marker: '../context', missing: contextRel },
+    { marker: './executors/crud.generated', missing: crudRel },
+    { marker: '../executors/crud.generated', missing: crudRel },
+    { marker: './permissions', missing: permissionsRel },
+    { marker: '../permissions', missing: permissionsRel },
+    { marker: importSpec(dirs, 'api', name), missing: apiRel }
+  ]
+
+  const hits = []
+  const seen = new Set()
+
+  for (const file of kept) {
+    if (!file.endsWith('.ts')) continue
+    const text = read(absolute(root, file))
+
+    for (const item of candidates) {
+      if (exists(absolute(root, item.missing))) continue
+      if (!text.includes(`'${item.marker}'`) && !text.includes(`"${item.marker}"`)) continue
+      if (seen.has(file)) continue
+      seen.add(file)
+      hits.push({ file, missing: item.missing })
+    }
+  }
+
+  return hits
+}
+
+/**
+ * 模块的标准生成物（不含中枢 index.ts 与自定义执行器）
+ */
+function moduleFiles(name, dirs) {
+  return [
+    relPath(dirs, 'api', `${name}.ts`),
+    relPath(dirs, 'stores', name, 'index.ts'),
+    relPath(dirs, 'domains', name, 'context.ts'),
+    relPath(dirs, 'domains', name, 'executors/crud.generated.ts'),
+    relPath(dirs, 'domains', name, 'permissions.ts'),
+    relPath(dirs, 'views', name, 'Index.vue'),
+    relPath(dirs, 'views', name, 'Detail.vue'),
+    relPath(dirs, 'views', name, 'Form.vue')
+  ]
+}
+
+/**
+ * 默认只删「模块定义 config + 带生成头的生成物」；被手写替换过的文件一律保留。
+ * --purge 连手写文件 / 整个模块目录一起删。
+ */
+function collectTargets(root, name, purge, dirs) {
+  const targets = []
+  const add = (rel, kind) => {
+    const full = absolute(root, rel)
+    if (exists(full)) targets.push({ rel, path: full, kind })
+  }
+
+  if (purge) {
+    add(relPath(dirs, 'api', `${name}.ts`), 'file')
+    add(relPath(dirs, 'stores', name), 'dir')
+    add(relPath(dirs, 'domains', name), 'dir')
+    add(relPath(dirs, 'views', name), 'dir')
+    return targets
+  }
+
+  // config 是模块定义本身，删模块必删
+  add(relPath(dirs, 'domains', name, 'config.ts'), 'file')
+
+  for (const rel of moduleFiles(name, dirs)) {
+    const full = absolute(root, rel)
+    if (!exists(full)) continue
+    if (isGenerated(read(full))) targets.push({ rel, path: full, kind: 'file' })
+  }
+
+  return targets
+}
+
+/**
+ * 默认模式下手写文件的保留清单（只用于提示，不删）
+ */
+function collectKept(root, name, purge, dirs) {
+  if (purge) return []
+
+  const kept = []
+  const push = (rel) => {
+    if (exists(absolute(root, rel))) kept.push(rel)
+  }
+
+  // 被手写替换的标准文件（生成头没了，就是人写的）
+  for (const rel of moduleFiles(name, dirs)) {
+    if (exists(absolute(root, rel)) && !isGenerated(read(absolute(root, rel)))) kept.push(rel)
+  }
+
+  push(relPath(dirs, 'domains', name, 'index.ts'))
+  const executorsRel = relPath(dirs, 'domains', name, 'executors')
+  for (const file of listFiles(absolute(root, executorsRel))) {
+    if (file !== 'crud.generated.ts') push(relPath(dirs, 'domains', name, 'executors', file))
+  }
+  const viewsRel = relPath(dirs, 'views', name)
+  const generatedViews = new Set(['Index.vue', 'Detail.vue', 'Form.vue'])
+  for (const file of listFiles(absolute(root, viewsRel))) {
+    if (!generatedViews.has(file)) push(relPath(dirs, 'views', name, file))
+  }
+
+  return kept
+}
+
+/**
+ * 清理删除后剩下的空目录（只清模块自己的，不碰上层公共目录）
+ */
+function cleanupEmptyDirs(root, name, dirs) {
+  const paths = [
+    relPath(dirs, 'stores', name),
+    relPath(dirs, 'domains', name, 'executors'),
+    relPath(dirs, 'domains', name),
+    relPath(dirs, 'views', name)
+  ]
+
+  for (const rel of paths) {
+    const full = path.join(root, rel)
+    if (isEmptyDir(full)) removeDir(full)
+  }
+}
+
+function printTargets(targets, kept) {
+  console.log(`  ${ui.label(`将删除 ${targets.length} 个`, `Will remove ${targets.length}`)}`)
+  for (const target of targets) {
+    console.log(`    ${ui.danger(glyph.warn)} ${ui.path(target.rel)}`)
+  }
+  console.log('')
+
+  if (kept.length > 0) {
+    console.log(`  ${ui.label(`手写文件保留 ${kept.length} 个`, `Keep handwritten ${kept.length}`)}`)
+    for (const file of kept) {
+      console.log(`    ${ui.muted(glyph.dot)} ${ui.path(file)}`)
+    }
+    console.log('')
+  }
+}
+
+async function confirm(question) {
+  const rl = readline.createInterface({ input: stdin, output: stdout })
+  try {
+    const answer = (await rl.question(question)).trim().toLowerCase()
+    return answer === 'y' || answer === 'yes'
+  } finally {
+    rl.close()
+  }
+}
+
+function printHeader(cn, en) {
+  console.log('')
+  console.log(`  ${ui.heading(cn, en)}`)
+  console.log(`  ${ui.rule(46)}`)
+  console.log('')
+}
+
+function printRemoveHelp() {
+  console.log('')
+  console.log(`  ${ui.heading('删除模块', 'remove · delete module')}`)
+  console.log(`  ${ui.rule(50)}`)
+  console.log('')
+  console.log(`  ${ui.label('用法', 'Usage')}`)
+  console.log(`    ${ui.command('tha remove')} <模块> [--purge] [--dry-run] [--yes] [--json]`)
+  console.log('')
+  console.log(`  ${ui.label('说明', 'Notes')}`)
+  console.log(`    ${ui.bullet('remove module files (删除 config 和生成的 5 个文件，并重算全局路由/菜单)')}`)
+  console.log(`    ${ui.bullet('handwritten files kept (手写的模块入口和动作文件默认保留)')}`)
+  console.log(`    ${ui.bullet('remove everything (--purge 连手写文件一起删，整个模块目录)')}`)
+  console.log(`    ${ui.bullet('preview only (--dry-run 只列出将删除的文件)')}`)
+  console.log(`    ${ui.bullet('disable color (关闭颜色)')}`)
+  console.log('')
+}