tha-cli 0.0.0-stage → 0.1.0

package/tha/generate/domain/executors.mjs

@@ -0,0 +1,93 @@
+// ============ 执行器模板 ============
+// crud 关掉的能力不生成对应函数；每个写动作入口都过 ctx.can —— 权限在这里真正生效。
+
+import { pascal } from '../names.mjs'
+import { importSpec } from '../../config/paths.mjs'
+
+export function executorsBody(domain, dirs) {
+  const type = pascal(domain.name)
+  const apiModule = importSpec(dirs, 'api', domain.name)
+  const { create, update, remove } = domain.crud
+  const needDetail = domain.pages.includes('detail') || domain.pages.includes('form')
+
+  const imports = [`import type { ${type}Context } from '../context'`]
+
+  const typeImports = []
+  if (needDetail) typeImports.push(type)
+  if (create) typeImports.push(`${type}Create`)
+  if (update) typeImports.push(`${type}Update`)
+  if (typeImports.length > 0) {
+    imports.unshift(`import type { ${typeImports.join(', ')} } from '${apiModule}'`)
+  }
+
+  const blocks = [
+    `/* 执行器：完整流程、业务判断、请求都只在这里。 */
+export async function refresh${type}(ctx: ${type}Context): Promise<boolean> {
+  const ok = await ctx.run('list', async () => {
+    const items = await ctx.api.list()
+    ctx.state.setItems(items)
+    return true
+  })
+  return ok === true
+}`
+  ]
+
+  if (needDetail) {
+    blocks.push(`export async function load${type}(id: number, ctx: ${type}Context): Promise<${type} | undefined> {
+  if (!ctx.can('view')) return undefined
+
+  return ctx.run('list', async () => {
+    const row = await ctx.api.detail(id)
+    ctx.state.upsert(row)
+    return row
+  })
+}`)
+  }
+
+  if (create) {
+    blocks.push(`export async function create${type}(input: ${type}Create, ctx: ${type}Context): Promise<boolean> {
+  if (!ctx.can('create')) return false
+
+  const ok = await ctx.run('create', async () => {
+    const row = await ctx.api.create(input)
+    ctx.state.upsert(row)
+    return true
+  })
+  return ok === true
+}`)
+  }
+
+  if (update) {
+    blocks.push(`export async function update${type}(
+  input: { id: number; data: ${type}Update },
+  ctx: ${type}Context
+): Promise<boolean> {
+  if (!ctx.can('update')) return false
+
+  const ok = await ctx.run('update', async () => {
+    const row = await ctx.api.update(input.id, input.data)
+    ctx.state.upsert(row)
+    return true
+  })
+  return ok === true
+}`)
+  }
+
+  if (remove) {
+    blocks.push(`export async function remove${type}(id: number, ctx: ${type}Context): Promise<boolean> {
+  if (!ctx.can('remove')) return false
+
+  const ok = await ctx.run('remove', async () => {
+    await ctx.api.remove(id)
+    ctx.state.removeById(id)
+    return true
+  })
+  return ok === true
+}`)
+  }
+
+  return `${imports.join('\n')}
+
+${blocks.join('\n\n')}
+`
+}

package/tha/generate/domain/form.mjs

@@ -0,0 +1,34 @@
+// ============ 表单页模板 ============
+// pages 含 form 才生成。带 id 是编辑，不带 id 是新增 —— 同一个模板两种用法。
+
+import { pascal } from '../names.mjs'
+import { importSpec } from '../../config/paths.mjs'
+
+export function formBody(domain, dirs) {
+  const type = pascal(domain.name)
+  const kitForm = importSpec(dirs, 'components', 'tha/ThaForm.vue')
+  const config = importSpec(dirs, 'domains', domain.name, 'config')
+  const hub = importSpec(dirs, 'domains', domain.name)
+  const store = importSpec(dirs, 'stores', domain.name)
+
+  return `<script setup lang="ts">
+import { computed } from 'vue'
+import { useRoute } from 'vue-router'
+import ThaForm from '${kitForm}'
+import { ${domain.name}Config } from '${config}'
+import { use${type}Module } from '${hub}'
+import { use${type}Store } from '${store}'
+
+const route = useRoute()
+const actions = use${type}Module()
+const store = use${type}Store()
+
+/* 有 id 就是编辑，没有就是新增 */
+const id = computed(() => (route.params.id ? Number(route.params.id) : undefined))
+</script>
+
+<template>
+  <ThaForm :config="${domain.name}Config" :actions="actions" :store="store" :id="id" />
+</template>
+`
+}

package/tha/generate/domain/index.mjs

@@ -0,0 +1,72 @@
+// ============ 一个标准域生成哪些文件 ============
+// 基线 5 个（接口 / 状态 / 上下文 / 执行器 / 列表页），
+// pages 声明的详情页、表单页按需追加。
+
+import { generatedFile, generatedVueFile } from '../header.mjs'
+import { relPath } from '../../config/paths.mjs'
+import { apiBody } from './api.mjs'
+import { contextBody } from './context.mjs'
+import { executorsBody } from './executors.mjs'
+import { storeBody } from './store.mjs'
+import { viewBody } from './view.mjs'
+import { detailBody } from './detail.mjs'
+import { formBody } from './form.mjs'
+
+export function domainFiles(domain, dirs) {
+  const source = relPath(dirs, 'domains', domain.name, 'config.ts')
+
+  const files = [
+    {
+      path: relPath(dirs, 'api', `${domain.name}.ts`),
+      content: generatedFile(source, apiBody(domain, dirs))
+    },
+    {
+      path: relPath(dirs, 'stores', domain.name, 'index.ts'),
+      content: generatedFile(source, storeBody(domain, dirs))
+    },
+    {
+      path: relPath(dirs, 'domains', domain.name, 'context.ts'),
+      content: generatedFile(source, contextBody(domain, dirs))
+    },
+    {
+      path: relPath(dirs, 'domains', domain.name, 'executors/crud.generated.ts'),
+      content: generatedFile(source, executorsBody(domain, dirs), {
+        config: snapshot(domain)
+      })
+    },
+    {
+      path: relPath(dirs, 'views', domain.name, 'Index.vue'),
+      content: generatedVueFile(source, viewBody(domain, dirs))
+    }
+  ]
+
+  if (domain.pages.includes('detail')) {
+    files.push({
+      path: relPath(dirs, 'views', domain.name, 'Detail.vue'),
+      content: generatedVueFile(source, detailBody(domain, dirs))
+    })
+  }
+
+  if (domain.pages.includes('form')) {
+    files.push({
+      path: relPath(dirs, 'views', domain.name, 'Form.vue'),
+      content: generatedVueFile(source, formBody(domain, dirs))
+    })
+  }
+
+  return files
+}
+
+function snapshot(domain) {
+  return {
+    name: domain.name,
+    title: domain.title,
+    path: domain.path,
+    api: domain.api,
+    fields: domain.fields,
+    list: domain.list,
+    crud: domain.crud,
+    permissions: domain.permissions,
+    pages: domain.pages
+  }
+}

package/tha/generate/domain/permissions.mjs

@@ -0,0 +1,35 @@
+// ============ 权限骨架模板 ============
+// 只补一次，之后归人。CLI 只保证「有一个明确的判定入口」，
+// 不猜项目怎么存权限（用户 store / 路由 meta / 后端下发都行）。
+
+import { pascal } from '../names.mjs'
+
+export function permissionsBody(domain) {
+  const type = pascal(domain.name)
+  const codes = domain.permissions ?? {}
+
+  const codeLines = Object.entries(codes)
+    .map(([action, code]) => `  ${action}: '${code}'`)
+    .join(',\n')
+
+  return `import type { ${type}Action } from './context'
+
+/* 权限码：来自 config.permissions，改这里不会回头影响 config。
+ * 只声明部分动作是允许的，没声明的动作由 can${type} 自行决定。 */
+export const ${domain.name}PermissionCodes: Partial<Record<${type}Action, string>> = {
+${codeLines}
+}
+
+/**
+ * 权限判定：执行器入口与页面按钮共用这一处。
+ * 骨架默认放行 —— 刚创建时不该把模块锁死；接真实权限后改成对应判断。
+ * @param action 动作名（view / create / update / remove）
+ * @returns 是否允许
+ */
+export function can${type}(action: ${type}Action): boolean {
+  // TODO: 接项目自己的权限来源，例如用户 store 里的权限码集合
+  void action
+  return true
+}
+`
+}

package/tha/generate/domain/store.mjs

@@ -0,0 +1,68 @@
+// ============ 状态层模板 ============
+// PendingKey 跟着 crud 走：关掉的动作不出现在 pending 里。
+
+import { pascal } from '../names.mjs'
+import { importSpec } from '../../config/paths.mjs'
+
+export function storeBody(domain, dirs) {
+  const type = pascal(domain.name)
+  const apiModule = importSpec(dirs, 'api', domain.name)
+  const { create, update, remove } = domain.crud
+
+  const actions = ['list', ...(create ? ['create'] : []), ...(update ? ['update'] : []), ...(remove ? ['remove'] : [])]
+  const pendingInit = actions.map((action) => `    ${action}: false`).join(',\n')
+  const writable = create || update
+
+  const members = ['items', 'pending', 'error', 'setItems']
+  if (writable) members.push('upsert')
+  if (remove) members.push('removeById')
+  members.push('setPending', 'setError')
+
+  const functions = [
+    `  function setItems(list: ${type}[]) {
+    items.value = list
+  }`
+  ]
+
+  if (writable) {
+    functions.push(`  function upsert(row: ${type}) {
+    const index = items.value.findIndex((item) => item.id === row.id)
+    if (index >= 0) items.value.splice(index, 1, row)
+    else items.value.unshift(row)
+  }`)
+  }
+
+  if (remove) {
+    functions.push(`  function removeById(id: number) {
+    items.value = items.value.filter((item) => item.id !== id)
+  }`)
+  }
+
+  functions.push(`  function setPending(key: PendingKey, value: boolean) {
+    pending[key] = value
+  }`)
+
+  functions.push(`  function setError(message: string | null) {
+    error.value = message
+  }`)
+
+  return `import { defineStore } from 'pinia'
+import { reactive, ref } from 'vue'
+import type { ${type} } from '${apiModule}'
+
+export type PendingKey = ${actions.map((action) => `'${action}'`).join(' | ')}
+
+/* 状态层：原子更新；不发请求、不做业务判断。 */
+export const use${type}Store = defineStore('${domain.name}', () => {
+  const items = ref<${type}[]>([])
+  const pending = reactive<Record<PendingKey, boolean>>({
+${pendingInit}
+  })
+  const error = ref<string | null>(null)
+
+${functions.join('\n\n')}
+
+  return { ${members.join(', ')} }
+})
+`
+}

package/tha/generate/domain/view.mjs

@@ -0,0 +1,29 @@
+// ============ 列表页模板 ============
+// 薄壳：页面实现由 CLI 提供的 ThaCrudPage 承担（init 时脚手架到项目里），
+// 项目想换 UI 只需要改这一个组件，不用动任何模块。
+
+import { pascal } from '../names.mjs'
+import { importSpec } from '../../config/paths.mjs'
+
+export function viewBody(domain, dirs) {
+  const type = pascal(domain.name)
+  const kitPage = importSpec(dirs, 'components', 'tha/ThaCrudPage.vue')
+  const config = importSpec(dirs, 'domains', domain.name, 'config')
+  const hub = importSpec(dirs, 'domains', domain.name)
+  const store = importSpec(dirs, 'stores', domain.name)
+
+  return `<script setup lang="ts">
+import ThaCrudPage from '${kitPage}'
+import { ${domain.name}Config } from '${config}'
+import { use${type}Module } from '${hub}'
+import { use${type}Store } from '${store}'
+
+const actions = use${type}Module()
+const store = use${type}Store()
+</script>
+
+<template>
+  <ThaCrudPage :config="${domain.name}Config" :actions="actions" :store="store" />
+</template>
+`
+}

package/tha/generate/global.mjs

@@ -0,0 +1,111 @@
+// ============ 全局注册表模板 ============
+// 路由按 pages 展开：列表、新增、编辑、详情各一条；菜单只认列表页。
+
+import { generatedFile } from './header.mjs'
+import { quote } from './names.mjs'
+import { importSpec, relPath } from '../config/paths.mjs'
+
+export function globalFiles(domains, dirs) {
+  const source = 'tha:global'
+
+  return [
+    {
+      path: relPath(dirs, 'router', 'routes.generated.ts'),
+      content: generatedFile(source, routesBody(domains, dirs))
+    },
+    {
+      path: relPath(dirs, 'layouts', 'menu.generated.ts'),
+      content: generatedFile(source, menuBody(domains))
+    }
+  ]
+}
+
+function routesBody(domains, dirs) {
+  const routes = []
+
+  for (const domain of domains) {
+    const meta = routeMeta(domain)
+
+    routes.push(
+      routeEntry(domain.path, domain.name, importSpec(dirs, 'views', domain.name, 'Index.vue'), meta)
+    )
+
+    if (domain.pages.includes('form')) {
+      const formView = importSpec(dirs, 'views', domain.name, 'Form.vue')
+      // /new 必须排在 /:id 前面，否则会被当成 id
+      routes.push(routeEntry(`${domain.path}/new`, `${domain.name}Create`, formView, meta))
+      routes.push(routeEntry(`${domain.path}/:id/edit`, `${domain.name}Edit`, formView, meta))
+    }
+
+    if (domain.pages.includes('detail')) {
+      routes.push(
+        routeEntry(
+          `${domain.path}/:id`,
+          `${domain.name}Detail`,
+          importSpec(dirs, 'views', domain.name, 'Detail.vue'),
+          meta
+        )
+      )
+    }
+  }
+
+  return `import type { RouteRecordRaw } from 'vue-router'
+
+/* 全局路由注册表：由所有模块的 config 生成，不要手动修改。 */
+export const generatedRoutes: RouteRecordRaw[] = ${arrayBody(routes)}
+`
+}
+
+function routeEntry(path, name, target, meta) {
+  return `  {
+    path: ${quote(path)},
+    name: ${quote(name)},
+    component: () => import(${quote(target)}),
+    meta: ${meta}
+  }`
+}
+
+function routeMeta(domain) {
+  const permissions = domain.permissions ?? {}
+  const keys = Object.keys(permissions)
+
+  if (keys.length === 0) {
+    return `{ title: ${quote(domain.title)} }`
+  }
+
+  const lines = keys.map((key) => `        ${key}: ${quote(permissions[key])}`)
+  return `{
+      title: ${quote(domain.title)},
+      permissions: {
+${lines.join(',\n')}
+      }
+    }`
+}
+
+function menuBody(domains) {
+  const items = domains.map((domain) => {
+    const permission = domain.permissions?.view
+    return `  {
+    title: ${quote(domain.title)},
+    path: ${quote(domain.path)}${permission ? `,
+    permission: ${quote(permission)}` : ''}
+  }`
+  })
+
+  return `/* 全局菜单注册表：由所有模块的 config 生成，不要手动修改。 */
+export interface GeneratedMenuItem {
+  title: string
+  path: string
+  permission?: string
+}
+
+export const generatedMenu: GeneratedMenuItem[] = ${arrayBody(items)}
+`
+}
+
+/**
+ * 空模块时输出 `[]`，有模块时按行展开（避免空数组里留一串空行）
+ */
+function arrayBody(items) {
+  return items.length === 0 ? '[]' : `[\n${items.join(',\n')}\n]`
+}

package/tha/generate/header.mjs

@@ -0,0 +1,29 @@
+import { sha256 } from '../utils/files.mjs'
+
+export function generatedFile(source, body, options = {}) {
+  const hash = sha256(body)
+  const config = options.config
+    ? `\n * config: ${Buffer.from(JSON.stringify(options.config)).toString('base64')}`
+    : ''
+
+  return `/* @tha-generated
+ * source: ${source}
+ * hash: ${hash}${config}
+ * DO NOT EDIT. 由 tha sync 生成。
+ */
+${body}`
+}
+
+export function generatedVueFile(source, body, options = {}) {
+  const hash = sha256(body)
+  const config = options.config
+    ? `\nconfig: ${Buffer.from(JSON.stringify(options.config)).toString('base64')}`
+    : ''
+
+  return `<!-- @tha-generated
+source: ${source}
+hash: ${hash}${config}
+DO NOT EDIT. 由 tha sync 生成。
+-->
+${body}`
+}

package/tha/generate/names.mjs

@@ -0,0 +1,45 @@
+export function pascal(value) {
+  return String(value)
+    .replace(/[-_\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))
+    .replace(/^[a-z]/, (char) => char.toUpperCase())
+}
+
+export function quote(value) {
+  return `'${String(value)
+    .replace(/\\/g, '\\\\')
+    .replace(/'/g, "\\'")
+    .replace(/\r?\n/g, '\\n')}'`
+}
+
+export function fieldTsType(field) {
+  if (field.type === 'enum') {
+    const values = (field.options ?? []).map((option) => quote(option.value))
+    return values.length > 0 ? values.join(' | ') : 'string'
+  }
+
+  if (field.type === 'number') return 'number'
+  if (field.type === 'boolean') return 'boolean'
+  return 'string'
+}
+
+export function fieldLiteral(key, field) {
+  const value = {
+    key,
+    label: field.label,
+    type: field.type
+  }
+
+  if (field.required) value.required = true
+  if (field.options) value.options = field.options
+  if (field.default !== undefined) value.default = field.default
+
+  return JSON.stringify(value, null, 2)
+}
+
+export function indent(value, spaces) {
+  const pad = ' '.repeat(spaces)
+  return String(value)
+    .split('\n')
+    .map((line) => `${pad}${line}`)
+    .join('\n')
+}

package/tha/generate/plan.mjs

@@ -0,0 +1,41 @@
+// ============ 生成计划：模块清单 → 待写文件清单 ============
+// 两件「只补一次」的事在这里：中枢骨架、权限骨架。
+// 它们一旦存在就归模块所有，sync 不再覆盖，也不再进 plan。
+
+import { absPath, relPath } from '../config/paths.mjs'
+import { exists } from '../utils/files.mjs'
+import { domainFiles } from './domain/index.mjs'
+import { entryBody } from './domain/entry.mjs'
+import { permissionsBody } from './domain/permissions.mjs'
+import { globalFiles } from './global.mjs'
+
+export function buildPlan(domains, root, dirs) {
+  const files = []
+
+  for (const domain of domains) {
+    files.push(...domainFiles(domain, dirs))
+
+    const entry = absPath(root, dirs, 'domains', domain.name, 'index.ts')
+    if (!exists(entry)) {
+      files.push({
+        path: relPath(dirs, 'domains', domain.name, 'index.ts'),
+        content: entryBody(domain, dirs)
+      })
+    }
+
+    // 权限骨架只在声明了权限码时补；空对象等于没声明，can 恒为 true，不需要文件
+    if (domain.permissions && Object.keys(domain.permissions).length > 0) {
+      const permissions = absPath(root, dirs, 'domains', domain.name, 'permissions.ts')
+      if (!exists(permissions)) {
+        files.push({
+          path: relPath(dirs, 'domains', domain.name, 'permissions.ts'),
+          content: permissionsBody(domain, dirs)
+        })
+      }
+    }
+  }
+
+  files.push(...globalFiles(domains, dirs))
+
+  return files.sort((left, right) => left.path.localeCompare(right.path))
+}