diff --git a/src/commands/form/index.ts b/src/commands/form/index.ts index dc46a8c..f30e10c 100644 --- a/src/commands/form/index.ts +++ b/src/commands/form/index.ts @@ -17,6 +17,7 @@ import { buildFormImportCommand } from './import.ts' import { buildFormCodegenCommand } from './codegen.ts' import { buildFormBindFlowCommand } from './bindflow.ts' import { buildFormSelectorCommand } from './selector.ts' +import { buildFormPreviewCommand } from './preview.ts' export function buildFormCommand(): Command { const cmd = new Command('form').description('表单 CRUD (list/info/create/update/release/delete/export/import/codegen/bindFlow/selector)') @@ -31,5 +32,7 @@ export function buildFormCommand(): Command { cmd.addCommand(buildFormCodegenCommand()) cmd.addCommand(buildFormBindFlowCommand()) cmd.addCommand(buildFormSelectorCommand()) + // v0.11d+ Phase 3.2: standalone HTML 预览 (AI 场景增强, 非 web 镜像) + cmd.addCommand(buildFormPreviewCommand()) return cmd } diff --git a/src/commands/form/preview.ts b/src/commands/form/preview.ts new file mode 100644 index 0000000..ed31140 --- /dev/null +++ b/src/commands/form/preview.ts @@ -0,0 +1,328 @@ +/** + * commands/form/preview.ts — 表单预览 (AI 场景增强, 非 web 镜像) + * + * v0.11d+ Phase 3.2: 输出 standalone HTML, 浏览器打开即可, 无需 nginx/JNPF + * + * ⚠️ 不是 web 镜像: web 端 formDesign 没有专门 FormPreview.vue + * - web 端"预览"是 FormGenerator 组件复用 + * - dacli form preview 是 AI 场景增强 (不启动 JNPF 就能验证 form 长什么样) + * + * 输出 HTML 结构: + * - 标题: form fullName + enCode + * - List 视图 (table + columnData.columnList) + * - Detail 视图 (form + formData.fields, read-only) + * - 嵌入 form schema JSON (script 标签, 调试用) + * - 内联 CSS (no-spa-page 风格, 无 CDN) + * + * 渲染字段映射 (镜像 web FormGenerator): + * input/textarea/inputNumber/select/radio/checkbox/date → 对应 HTML 控件 + * popup/relationForm/popupTableSelect → placeholder (诚实标记, 不假装) + * + * 验证: tdd10 用 spare_parts_requisition_v3 (840232970903094085) 跑通 + */ +import { Command } from 'commander' +import * as fs from 'node:fs' +import * as path from 'node:path' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' +import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' + +interface Opts { + id: string + out?: string + json?: boolean +} + +interface FormSchemaLite { + id?: string + fullName?: string + enCode?: string + formData?: string | Record + columnData?: string | Record + tables?: string | unknown[] +} + +export function buildFormPreviewCommand(): Command { + const cmd = new Command('preview') + .description('表单预览 (输出 standalone HTML, 浏览器打开即可, 无需 JNPF). 镜像 web FormGenerator 组件 + no-spa-page 风格 (内联 CSS, 无 CDN).') + .requiredOption('--id ', '表单 id') + .option('--out ', '输出 HTML 文件路径 (默认 ./form-preview-.html)', `./form-preview-${'${id}'}.html`) + .option('--json', '输出 schema JSON 而不生成 HTML (调试用)', false) + .action(async (opts: Opts) => { + const c = await JnpfClient.fromToken() + await initWebapi(c) + + // 1. 拉 form + log.info(`loadVisualDev.getInfo (formId=${opts.id})`) + const form = (await loadVisualDev.getInfo(opts.id)) as FormSchemaLite + if (!form || !form.id) { + log.error(`form 不存在 (id=${opts.id})`) + process.exit(1) + } + log.info(`form: fullName=${form.fullName} enCode=${form.enCode}`) + + // 2. 解析 formData + columnData (可能是 JSON 字符串) + const formData = parseJson(form.formData) || { fields: [] } + const columnData = parseJson(form.columnData) || { columnList: [] } + const formDataFields = (formData as { fields?: unknown[] }).fields || [] + const columnList = (columnData as { columnList?: unknown[] }).columnList || [] + + if (opts.json) { + printJson({ + id: opts.id, + fullName: form.fullName, + enCode: form.enCode, + formDataFields: formDataFields, + columnList: columnList, + }) + return + } + + // 3. 生成 HTML + const html = renderPreviewHtml({ + id: opts.id, + fullName: form.fullName || '(未命名)', + enCode: form.enCode || '', + formDataFields: formDataFields as Array>, + columnList: columnList as Array>, + rawSchema: { form, formData, columnData }, + }) + + // 4. 写入文件 + const outFile = opts.out || `./form-preview-${opts.id}.html` + const outPath = path.resolve(outFile) + fs.writeFileSync(outPath, html, 'utf8') + log.ok(`✓ 已生成预览: ${outPath}`) + log.info(` 浏览器打开: file://${outPath}`) + log.info(` 列表列数: ${(columnList as unknown[]).length} 表单字段数: ${(formDataFields as unknown[]).length}`) + }) + + installAiHelpHook(cmd, { + purpose: '输出 form standalone HTML 预览, 浏览器打开即可, 无需 JNPF/nginx. AI 场景增强 (web 没专门 FormPreview 组件, 是 FormGenerator 复用)', + required: { '--id': '表单 id' }, + optional: { + '--out': '输出文件 (默认 ./form-preview-.html)', + '--json': '输出 schema JSON 而不生成 HTML (调试用)', + }, + example: [ + 'dacli form preview --id=840232970903094085', + 'dacli form preview --id=840232970903094085 --out=/tmp/spare_parts_preview.html', + 'dacli form preview --id=840232970903094085 --json # 调试 schema', + ], + source: { + web: 'web/.../components/FormGenerator/ + no-spa-page 风格', + api: 'loadVisualDev.getInfo (走 webapi 镜像)', + ref: 'formData.fields 镜像 FormGenerator 渲染 + columnData.columnList 镜像 List 组件', + }, + notes: [ + 'v0.11d+ Phase 3.2: AI 场景增强, 非 web 镜像', + 'web 端 formDesign 无专门 FormPreview.vue, 是 FormGenerator 复用', + '镜像 web FormGenerator 字段渲染 (input/textarea/select/date 等)', + '复杂控件 (popup/relationForm) 标 placeholder, 不假装渲染', + '输出 HTML 内联 CSS, 无 CDN, AI 离线可用', + 'schema 嵌入