@es-plus/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 liujiaao
+
+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,421 @@
+# @es-plus/cli
+
+[es-plus-ui](https://www.npmjs.com/package/es-plus-ui) 官方命令行工具 —— 用自然语言生成 Vue 3 CRUD 页面，校验 JSON 配置，快速搭建页面脚手架。
+
+## 安装
+
+```bash
+# 方式一：npx 直接运行（无需安装）
+npx @es-plus/cli create user-management
+
+# 方式二：全局安装
+npm install -g @es-plus/cli
+
+# 方式三：项目内安装
+npm install -D @es-plus/cli
+```
+
+安装后，终端可直接使用 `es-plus` 命令。
+
+> **环境要求：** Node.js >= 18，npm >= 8
+
+---
+
+## 命令总览
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `es-plus create <name>` | 自然语言 → 完整 CRUD 页面 | `es-plus create user-management` |
+| `es-plus validate <file>` | 校验 JSON 配置文件 | `es-plus validate ./config.json` |
+| `es-plus scaffold <name>` | 生成最小页面脚手架 | `es-plus scaffold dashboard` |
+
+---
+
+## create — 生成 CRUD 页面
+
+从自然语言描述生成完整的 Vue 3 CRUD 页面（.vue SFC），包含查询表单、数据表格、新增/编辑弹窗、删除确认。
+
+### 基本用法
+
+```bash
+# 交互式 — 引导选择预设或输入描述
+es-plus create user-management
+
+# 非交互式 — 直接传入描述
+es-plus create user-management \
+  -d "用户管理，查询姓名、手机号、状态，表格显示姓名、手机号、邮箱、状态、创建时间，支持新增编辑删除"
+
+# 指定输出路径
+es-plus create user-management \
+  -d "用户管理，查询姓名、手机号、状态，表格显示姓名、手机号、邮箱、状态、创建时间，支持新增编辑删除" \
+  -o ./src/views/system/UserManagement.vue
+```
+
+### 参数说明
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `<name>` | 页面名称（kebab-case） | **必填** |
+| `-d, --description` | 跳过交互，直接用此描述生成 | 无（进入交互模式） |
+| `-o, --output <path>` | 输出文件路径 | `./src/views/<PascalName>.vue` |
+
+### 交互流程
+
+```
+$ es-plus create order-list
+
+? 选择预设或自定义描述
+  ❯ 自定义描述
+    用户管理
+    订单列表
+    商品管理
+    日志查询
+    角色权限
+    员工花名册
+    文章管理
+    系统配置
+
+? 请描述页面功能: 订单列表，查询订单号、客户名称、日期范围、状态，
+  表格显示订单号、客户、金额、状态、创建时间，支持查看详情和删除
+
+? 输出路径: ./src/views/OrderList.vue
+
+⏳ 正在生成...
+
+✔ 已生成: ./src/views/OrderList.vue
+  Generated CRUD page with:
+  - 4 query form fields
+  - 6 table columns (including actions)
+  - Actions: view, delete
+  - Dialog form with 5 fields and validation
+  - Status column with ElTag render
+  - Delete with confirmation dialog
+```
+
+### 描述技巧
+
+描述越明确，生成代码越精确。格式：**页面名称 + 查询字段 + 表格字段 + 操作类型**
+
+```bash
+# ✅ 好 — 明确分段
+"用户管理页面，
+ 查询条件有姓名、手机号、状态，
+ 表格显示姓名、手机号、邮箱、状态、创建时间，
+ 支持新增编辑删除"
+
+# ✅ 好 — 简洁罗列（自动推断查询和表格共用）
+"员工管理：姓名、部门、职位、手机号、状态"
+
+# ✅ 好 — 只读列表
+"操作日志查询，查询关键词、级别、日期范围，表格显示时间、级别、操作人、内容，只查看"
+
+# ❌ 差 — 太模糊
+"做一个管理页面"
+```
+
+### 关键词智能识别
+
+引擎根据字段名自动推断控件类型：
+
+| 字段关键词 | 映射控件 | 示例字段 |
+|-----------|---------|---------|
+| 状态、类型、分类、级别、来源 | Select 下拉选择 | 订单状态、用户类型 |
+| 日期、创建时间、更新时间 | datePicker 日期选择器 | 注册日期、下单时间 |
+| 时间、时刻 | timePicker 时间选择器 | 开始时间 |
+| 开关、启用、是否 | Switch 开关 | 是否启用 |
+| 评分、星级 | Rate 评分 | 满意度评分 |
+| 头像、图片、文件、附件 | Upload 上传 | 用户头像 |
+| 备注、描述、内容、简介 | Input(textarea) 多行文本 | 备注信息 |
+| 性别、单选 | Radio 单选框 | 性别 |
+| 多选、标签、兴趣 | Checkbox 多选框 | 兴趣爱好 |
+| 省市、城市、地区、层级 | Cascader 级联选择 | 所在城市 |
+| 进度、区间、范围 | Slider 滑块 | 完成进度 |
+| 穿梭、分配 | Transfer 穿梭框 | 权限分配 |
+| 其他 | Input 输入框 | 姓名、手机号 |
+
+### 操作类型识别
+
+在描述中用"支持 XXX"指定操作：
+
+| 关键词 | 生成内容 |
+|--------|---------|
+| 新增 / 添加 / 创建 | 新增按钮 + 弹窗表单 |
+| 编辑 / 修改 / 更新 | 编辑按钮 + 弹窗表单（回填数据） |
+| 删除 / 移除 | 删除按钮 + ElMessageBox 确认 |
+| 查看 / 详情 | 查看按钮 + 只读弹窗 |
+| 导出 | 导出按钮 |
+| 导入 | 导入按钮 |
+| 只查看 / 只读 | 仅生成表格，无操作按钮 |
+| 不指定 | 默认生成新增、编辑、删除 |
+
+### 8 个内置预设
+
+| 预设 | 查询 | 表格 | 操作 |
+|------|------|------|------|
+| 用户管理 | 姓名、手机号、状态 | 姓名、手机号、邮箱、状态、创建时间 | 增删改 |
+| 订单列表 | 订单号、客户、日期、状态 | 订单号、客户、金额、状态、创建时间 | 查看、删除 |
+| 商品管理 | 名称、分类、状态 | 名称、分类、价格、库存、状态 | 增删改 |
+| 日志查询 | 关键词、级别、日期 | 时间、级别、操作人、内容 | 只读 |
+| 角色权限 | 角色名称、状态 | 角色名称、描述、状态、创建时间 | 增删改 |
+| 员工花名册 | 姓名、部门、职位 | 姓名、性别、年龄、部门、职位、手机号、状态 | 新增、编辑 |
+| 文章管理 | 标题、分类、状态 | 标题、分类、创建人、创建时间、状态 | 增删改 |
+| 系统配置 | 名称、类型 | 名称、编号、类型、描述、状态 | 增删改导出 |
+
+---
+
+## validate — 校验配置
+
+校验 JSON 配置文件是否符合 es-plus-ui 组件的 Schema 规范。
+
+### 基本用法
+
+```bash
+# 指定 schema 类型
+es-plus validate ./config/form-items.json --schema form-item
+
+# 自动检测 schema 类型
+es-plus validate ./config/table-options.json
+```
+
+### 参数说明
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `<file>` | JSON 配置文件路径 | **必填** |
+| `-s, --schema <type>` | Schema 类型 | 自动检测 |
+
+### 支持的 Schema 类型
+
+| 类型 | 验证内容 | 对应组件 |
+|------|----------|----------|
+| `form-item` | 表单项配置 | EsForm 的 `formItemList` |
+| `table-column` | 表格列配置 | EsTable 的 `columns` |
+| `table-options` | 表格选项配置 | EsTable 的 `options` |
+| `dialog-options` | 弹窗配置 | useDialog 参数 |
+
+### 自动检测规则
+
+不指定 `--schema` 时，根据 JSON 内容自动判断：
+
+| JSON 中包含 | 判定为 |
+|-------------|--------|
+| `columns` / `tableData` | `table-column` |
+| `httpRequest` / `configTableOut` / `apiParams` | `table-options` |
+| `render` / `configBtn` / `isDraggable` | `dialog-options` |
+| 其他 | `form-item` |
+
+### 输出示例
+
+**校验通过：**
+
+```
+✔ 校验通过 (schema: form-item)
+```
+
+**校验失败：**
+
+```
+✗ 校验失败（2 个错误）:
+  (root): must have required property 'prop'
+  /formtype: must be equal to one of the allowed values
+
+建议:
+  - Add missing property "prop"
+  - Valid values for /formtype: Input, Select, datePicker, timePicker,
+    Slider, ColorPicker, Transfer, Cascader, Radio, Checkbox, Switch, Rate, Upload
+
+可用 schema: form-item, table-column, table-options, dialog-options
+```
+
+### 配合 CI 使用
+
+```yaml
+# .github/workflows/validate.yml
+- name: Validate es-plus configs
+  run: |
+    npx @es-plus/cli validate ./src/configs/user-form.json --schema form-item
+    npx @es-plus/cli validate ./src/configs/table-options.json --schema table-options
+```
+
+---
+
+## scaffold — 生成脚手架
+
+生成最小化的 es-plus 页面模板，适合需要手动编写配置的场景。
+
+### 基本用法
+
+```bash
+# 默认：查询 + 表格
+es-plus scaffold user-list
+
+# 查询 + 表格 + 弹窗
+es-plus scaffold user-management --features query,table,dialog
+
+# 只有表格
+es-plus scaffold data-view --features table
+
+# 指定输出路径
+es-plus scaffold report -o ./src/views/report/Index.vue
+```
+
+### 参数说明
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `<name>` | 页面名称（kebab-case） | **必填** |
+| `-f, --features <list>` | 功能列表（逗号分隔） | `query,table` |
+| `-o, --output <path>` | 输出文件路径 | `./src/views/<PascalName>.vue` |
+
+### 可用 features
+
+| Feature | 生成内容 |
+|---------|---------|
+| `query` | EsForm 查询表单 + 查询/重置按钮 |
+| `table` | EsTable 表格 + 分页 + httpRequest 模板 |
+| `dialog` | useDialog 引入 + dialog 实例 |
+
+### 生成结果
+
+```vue
+<template>
+  <div class="user-list-page">
+    <es-table ref="tableRef" :columns="columns" :options="options"
+      v-model:data-source="tableData" v-model:pagination="pagination">
+      <es-form :model="queryForm" :form-item-list="formItems" :config-btn="queryBtns" />
+    </es-table>
+  </div>
+</template>
+
+<script setup>
+import { reactive, ref } from 'vue'
+
+const queryForm = reactive({})
+const formItems = []
+const queryBtns = [
+  { name: '查询', type: 'primary', key: 'query', triggerEvent: true },
+  { name: '重置', key: 'rest', triggerEvent: true },
+]
+
+const tableRef = ref(null)
+const tableData = ref([])
+const pagination = ref({ current: 1, pageSize: 10, total: 0 })
+const columns = []
+const options = {
+  border: true,
+  stripe: true,
+  highlightCurrentRow: true,
+  headerCellStyle: { background: '#f5f7fa' },
+  httpRequest: async (params) => {
+    // TODO: 替换为实际接口调用
+  },
+  configTableOut: { total: 'total', tableData: 'data', pageSize: 'pageSize', current: 'pageIndex' },
+}
+</script>
+```
+
+---
+
+## 生成代码说明
+
+生成的代码是完整可运行的 Vue 3 SFC，通常只需修改以下部分：
+
+### 1. 替换接口地址
+
+```js
+// 修改 options 中的 httpRequest
+const options = {
+  httpRequest: async (params) => {
+    const res = await axios.get('/api/user/list', { params: params.formParams })
+    return res.data
+  },
+  configTableOut: {
+    total: 'total',       // 总条数字段名
+    tableData: 'records', // 列表数据字段名（根据实际接口调整）
+    pageSize: 'pageSize',
+    current: 'pageIndex'
+  }
+}
+```
+
+### 2. 替换删除接口
+
+```js
+function handleDelete(row) {
+  ElMessageBox.confirm('确定删除该条数据吗？', '提示', { type: 'warning' })
+    .then(async () => {
+      await axios.delete(`/api/user/${row.id}`)  // 替换为实际接口
+      ElMessage.success('删除成功')
+      tableRef.value?.httpRequestInstance()
+    })
+}
+```
+
+### 3. 替换保存接口
+
+```js
+// openForm 函数中的确定按钮
+click: async (_, { close, getRefs }) => {
+  try {
+    await getRefs('form')?.validate()
+    await axios.post('/api/user/save', formData)  // 替换为实际接口
+    close()
+    tableRef.value?.httpRequestInstance()
+  } catch { /* 表单验证失败 */ }
+}
+```
+
+### 4. 调整 Select 选项数据
+
+```js
+// 默认生成的是占位选项，替换为实际数据或从接口获取
+{ prop: 'status', label: '状态', formtype: 'Select',
+  dataOptions: [{ label: '启用', value: 1 }, { label: '禁用', value: 0 }] }
+```
+
+---
+
+## 与 @es-plus/mcp-server 的区别
+
+| 特性 | @es-plus/cli | @es-plus/mcp-server |
+|------|-------------|---------------------|
+| 使用方式 | 终端命令行 | AI 编码工具自动调用 |
+| 适用场景 | 批量生成、CI/CD | AI 对话式开发 |
+| 交互方式 | 终端问答 / 命令参数 | AI 自然语言对话 |
+| 输出 | 直接写入 .vue 文件 | 返回代码字符串给 AI |
+
+**推荐组合：** 项目初始化用 CLI 批量生成 → 日常迭代用 MCP Server 让 AI 辅助修改。
+
+---
+
+## 常见问题
+
+### Q: 支持 TypeScript 吗？
+
+生成的是 `<script setup>` 格式（JavaScript）。如需 TypeScript，将 `<script setup>` 改为 `<script setup lang="ts">` 并添加类型注解即可。
+
+### Q: 生成的代码依赖什么？
+
+- `vue` >= 3.3
+- `es-plus-ui` — 提供 EsForm、EsTable、useDialog
+- `element-plus` — 提供 ElTag、ElMessageBox、ElMessage 等
+
+### Q: Windows 下 npx 报错？
+
+确保使用 PowerShell 或 Git Bash，Node.js >= 18：
+
+```bash
+npx @es-plus/cli create user-management
+```
+
+---
+
+## 相关链接
+
+- [es-plus-ui 组件库](https://www.npmjs.com/package/es-plus-ui)
+- [@es-plus/mcp-server AI 集成](https://www.npmjs.com/package/@es-plus/mcp-server)
+- [GitHub 仓库](https://github.com/es-plus-ui/es-plus)
+
+## License
+
+[MIT](./LICENSE)

package/build/commands/create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createCommand: Command;
+//# sourceMappingURL=create.d.ts.map

package/build/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,aAAa,SA+EtB,CAAC"}

package/build/commands/create.js

@@ -0,0 +1,79 @@
+import { Command } from "commander";
+import prompts from "prompts";
+import pc from "picocolors";
+import { writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { generateCrudPage } from "../core/code-generator.js";
+import { PRESET_EXAMPLES } from "../core/constants.js";
+function toPascalCase(str) {
+    return str
+        .replace(/(^|[-_])([a-z])/g, (_, __, letter) => letter.toUpperCase())
+        .replace(/[-_]/g, "");
+}
+export const createCommand = new Command("create")
+    .argument("<name>", "page name (kebab-case, e.g. user-management)")
+    .option("-o, --output <path>", "output file path")
+    .option("-d, --description <desc>", "skip interactive prompt, use this description directly")
+    .description("Generate a CRUD page from natural language description")
+    .action(async (name, options) => {
+    let description = options.description;
+    if (!description) {
+        const presetChoices = [
+            { title: "自定义描述", value: "__custom__" },
+            ...PRESET_EXAMPLES.map((p) => ({ title: p.label, value: p.prompt })),
+        ];
+        const { source } = await prompts({
+            type: "select",
+            name: "source",
+            message: "选择预设或自定义描述",
+            choices: presetChoices,
+        });
+        if (!source) {
+            console.log(pc.yellow("已取消"));
+            return;
+        }
+        if (source === "__custom__") {
+            const { desc } = await prompts({
+                type: "text",
+                name: "desc",
+                message: "请描述页面功能（自然语言）",
+                validate: (v) => (v.length > 5 ? true : "描述至少 6 个字符"),
+            });
+            if (!desc) {
+                console.log(pc.yellow("已取消"));
+                return;
+            }
+            description = desc;
+        }
+        else {
+            description = source;
+        }
+    }
+    const defaultOutput = resolve(process.cwd(), `src/views/${toPascalCase(name)}.vue`);
+    let outputPath = options.output;
+    if (!outputPath) {
+        const { path } = await prompts({
+            type: "text",
+            name: "path",
+            message: "输出路径",
+            initial: defaultOutput,
+        });
+        if (!path) {
+            console.log(pc.yellow("已取消"));
+            return;
+        }
+        outputPath = path;
+    }
+    outputPath = resolve(process.cwd(), outputPath);
+    console.log(pc.cyan("\n⏳ 正在生成..."));
+    const result = generateCrudPage(description);
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(outputPath, result.code, "utf-8");
+    console.log(pc.green(`\n✔ 已生成: ${outputPath}`));
+    console.log(pc.dim(result.summary));
+    console.log("");
+});
+//# sourceMappingURL=create.js.map

package/build/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"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"}

package/build/commands/scaffold.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const scaffoldCommand: Command;
+//# sourceMappingURL=scaffold.d.ts.map

package/build/commands/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,eAAO,MAAM,eAAe,SAyBxB,CAAC"}

package/build/commands/scaffold.js

@@ -0,0 +1,29 @@
+import { Command } from "commander";
+import pc from "picocolors";
+import { writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { generateScaffold } from "../core/code-generator.js";
+function toPascalCase(str) {
+    return str
+        .replace(/(^|[-_])([a-z])/g, (_, __, letter) => letter.toUpperCase())
+        .replace(/[-_]/g, "");
+}
+export const scaffoldCommand = new Command("scaffold")
+    .argument("<name>", "page name (kebab-case)")
+    .option("-f, --features <list>", "comma-separated features: query,table,dialog", "query,table")
+    .option("-o, --output <path>", "output file path")
+    .description("Generate a minimal es-plus page scaffold")
+    .action((name, options) => {
+    const features = options.features.split(",").map((f) => f.trim());
+    const outputPath = resolve(process.cwd(), options.output || `src/views/${toPascalCase(name)}.vue`);
+    const code = generateScaffold(name, features);
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(outputPath, code, "utf-8");
+    console.log(pc.green(`✔ 已生成: ${outputPath}`));
+    console.log(pc.dim(`  features: ${features.join(", ")}`));
+    console.log("");
+});
+//# sourceMappingURL=scaffold.js.map

package/build/commands/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;SACpE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC5C,MAAM,CAAC,uBAAuB,EAAE,8CAA8C,EAAE,aAAa,CAAC;KAC9F,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;KACjD,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,CAAC,IAAY,EAAE,OAA8C,EAAE,EAAE;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAElE,MAAM,UAAU,GAAG,OAAO,CACxB,OAAO,CAAC,GAAG,EAAE,EACb,OAAO,CAAC,MAAM,IAAI,aAAa,YAAY,CAAC,IAAI,CAAC,MAAM,CACxD,CAAC;IAEF,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE9C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/commands/validate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const validateCommand: Command;
+//# sourceMappingURL=validate.d.ts.map

package/build/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,eAAe,SAiDxB,CAAC"}

package/build/commands/validate.js

@@ -0,0 +1,57 @@
+import { Command } from "commander";
+import pc from "picocolors";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { validateConfig, listAvailableSchemas } from "../core/schema-validator.js";
+export const validateCommand = new Command("validate")
+    .argument("<file>", "JSON config file to validate")
+    .option("-s, --schema <type>", "schema type: " + listAvailableSchemas().join(", "))
+    .description("Validate es-plus config JSON against schema")
+    .action((file, options) => {
+    const filePath = resolve(process.cwd(), file);
+    if (!existsSync(filePath)) {
+        console.log(pc.red(`✗ 文件不存在: ${filePath}`));
+        process.exit(1);
+    }
+    let config;
+    try {
+        const raw = readFileSync(filePath, "utf-8");
+        config = JSON.parse(raw);
+    }
+    catch (e) {
+        console.log(pc.red(`✗ JSON 解析失败: ${e.message}`));
+        process.exit(1);
+    }
+    const schemaType = options.schema || detectSchemaType(config);
+    const result = validateConfig(config, schemaType);
+    if (result.valid) {
+        console.log(pc.green(`✔ 校验通过 (schema: ${schemaType})`));
+    }
+    else {
+        console.log(pc.red(`✗ 校验失败（${result.errors.length} 个错误）:`));
+        for (const err of result.errors) {
+            console.log(pc.red(`  ${err}`));
+        }
+        if (result.suggestions.length) {
+            console.log(pc.yellow("\n建议:"));
+            for (const s of result.suggestions) {
+                console.log(pc.yellow(`  - ${s}`));
+            }
+        }
+        console.log(pc.dim(`\n可用 schema: ${listAvailableSchemas().join(", ")}`));
+        process.exit(1);
+    }
+});
+function detectSchemaType(config) {
+    if (!config || typeof config !== "object")
+        return "form-item";
+    const obj = config;
+    if ("columns" in obj || "tableData" in obj)
+        return "table-column";
+    if ("httpRequest" in obj || "configTableOut" in obj || "apiParams" in obj)
+        return "table-options";
+    if ("render" in obj || "configBtn" in obj || "isDraggable" in obj)
+        return "dialog-options";
+    return "form-item";
+}
+//# sourceMappingURL=validate.js.map

package/build/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}

package/build/core/code-generator.d.ts

@@ -0,0 +1,9 @@
+import { type GeneratedConfig } from "./crud-engine.js";
+export interface GenerateResult {
+    code: string;
+    config: GeneratedConfig;
+    summary: string;
+}
+export declare function generateCrudPage(description: string): GenerateResult;
+export declare function generateScaffold(name: string, features?: string[]): string;
+//# sourceMappingURL=code-generator.d.ts.map

package/build/core/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../src/core/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAmBpE;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,MAAM,CA2ER"}