wanzhuang-cli 1.0.0

package/.gitattributes

@@ -0,0 +1,41 @@
+# 设置默认行为
+* text=auto
+
+# 源代码文件
+*.ts text diff=typescript
+*.js text diff=javascript
+*.json text
+*.md text
+*.yml text
+*.yaml text
+*.html text
+*.css text
+*.scss text
+*.less text
+
+# 二进制文件
+*.png binary
+*.jpg binary
+*.gif binary
+*.ico binary
+*.ttf binary
+*.woff binary
+*.woff2 binary
+*.eot binary
+*.pdf binary
+
+# 行尾处理
+*.ts eol=lf
+*.js eol=lf
+*.json eol=lf
+*.md eol=lf
+*.yml eol=lf
+*.yaml eol=lf
+*.html eol=lf
+*.css eol=lf
+*.scss eol=lf
+*.less eol=lf
+
+# 导出忽略
+.gitattributes export-ignore
+.gitignore export-ignore 

package/README.md

@@ -0,0 +1,113 @@
+# wzcli
+
+一个简单易用的前端项目脚手架工具，支持 React、Vue、UniApp 项目模板。
+
+## 特性
+
+- 快速创建 React/Vue/UniApp 项目
+- 基于 Vite 构建，开发体验极佳
+- TypeScript 支持
+- ESLint 代码规范
+- API 生成器（基于 Swagger/OpenAPI）
+- 一键更新项目依赖
+
+## 安装
+
+```bash
+# 使用 pnpm 安装（推荐）
+pnpm add -g wzcli
+
+# 或使用 npm 安装
+npm install -g wzcli
+
+# 或使用 yarn 安装
+yarn global add wzcli
+```
+
+## 使用指南
+
+### 创建项目
+
+```bash
+# 创建项目
+wz create my-project
+
+# 指定模板类型
+wz create my-project -t vue
+wz create my-project -t react
+wz create my-project -t uniapp
+```
+
+### 生成 API
+
+基于 Swagger/OpenAPI 规范自动生成 TypeScript API 代码：
+
+```bash
+# 默认生成到 src/api 目录
+wz api https://api.example.com/swagger.json
+
+# 指定输出目录
+wz api https://api.example.com/swagger.json -o ./src/services
+```
+
+生成的 API 包含：
+
+- TypeScript 类型定义
+- 请求函数
+- 参数验证
+
+### 更新依赖
+
+```bash
+wz update
+```
+
+## 项目模板
+
+### React 模板
+
+| 技术栈 | 版本    |
+| ------ | ------- |
+| React  | ^19.1.0 |
+| Vite   | ^6.3.5  |
+
+### Vue 模板
+
+| 技术栈 | 版本    |
+| ------ | ------- |
+| Vue    | ^3.5.13 |
+| Vite   | ^6.3.5  |
+
+### UniApp 模板
+
+跨平台开发框架，支持编译到多端：
+
+| 技术栈 | 版本    |
+| ------ | ------- |
+| Vue    | ^3.4.21 |
+| Vite   | 5.2.8   |
+
+支持平台：
+
+| 平台         | 命令                 |
+| ------------ | -------------------- |
+| H5           | `pnpm dev:h5`        |
+| 微信小程序   | `pnpm dev:mp-weixin` |
+| 支付宝小程序 | `pnpm dev:mp-alipay` |
+
+## 命令一览
+
+| 命令               | 说明       | 选项                                                |
+| ------------------ | ---------- | --------------------------------------------------- |
+| `wz create <name>` | 创建新项目 | `-t, --template` 模板类型<br>`-f, --force` 强制覆盖 |
+| `wz api <url>`     | 生成 API   | `-o, --output` 输出目录                             |
+| `wz update`        | 更新依赖   | -                                                   |
+
+## 环境要求
+
+| 项目        | Node.js 版本 |
+| ----------- | ------------ |
+| CLI 工具    | >= 14.0.0    |
+| React 模板  | >= 18.0.0    |
+| Vue 模板    | >= 18.0.0    |
+| UniApp 模板 | >= 18.0.0    |

package/dist/commands/create.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 创建新项目的主函数
+ * 1. 交互选择模板和功能
+ * 2. 复制模板
+ * 3. 自动类型/配置/依赖集成
+ * 4. 安装依赖并输出提示
+ */
+export declare function createProject(projectName: string, options: {
+    force: boolean;
+}): Promise<void>;

package/dist/commands/create.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProject = createProject;
+const path_1 = require("path");
+const fs_1 = require("fs");
+const child_process_1 = require("child_process");
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const template_1 = require("../utils/template");
+const fs_extra_1 = require("fs-extra");
+const fileOps_1 = require("../utils/fileOps");
+const configGen_1 = require("../utils/configGen");
+const deps_1 = require("../utils/deps");
+/**
+ * 创建新项目的主函数
+ * 1. 交互选择模板和功能
+ * 2. 复制模板
+ * 3. 自动类型/配置/依赖集成
+ * 4. 安装依赖并输出提示
+ */
+async function createProject(projectName, options) {
+    // 目标目录
+    const targetDir = (0, path_1.join)(process.cwd(), projectName);
+    // 1. 检查目标目录是否已存在，处理覆盖逻辑
+    if ((0, fs_1.existsSync)(targetDir)) {
+        if (options.force) {
+            console.log(chalk_1.default.yellow(`正在删除目录: ${targetDir}`));
+            (0, fs_extra_1.removeSync)(targetDir);
+        }
+        else {
+            const { action } = await inquirer_1.default.prompt([
+                {
+                    name: 'action',
+                    type: 'list',
+                    message: '目标目录已存在，请选择操作:',
+                    choices: [
+                        { name: '覆盖', value: 'overwrite' },
+                        { name: '取消', value: false },
+                    ],
+                },
+            ]);
+            if (!action)
+                return;
+            if (action === 'overwrite') {
+                console.log(chalk_1.default.yellow(`正在删除目录: ${targetDir}`));
+                (0, fs_extra_1.removeSync)(targetDir);
+            }
+        }
+    }
+    // 2. 创建新目录
+    (0, fs_1.mkdirSync)(targetDir, { recursive: true });
+    // 3. 交互选择模板
+    const { template } = await inquirer_1.default.prompt([
+        {
+            name: 'template',
+            type: 'list',
+            message: '请选择项目模板:',
+            choices: [
+                { name: 'React', value: 'react' },
+                { name: 'Vue', value: 'vue' },
+                { name: 'UniApp', value: 'uniapp' },
+            ],
+        },
+    ]);
+    // 4. 交互多选功能
+    const { features } = await inquirer_1.default.prompt([
+        {
+            name: 'features',
+            type: 'checkbox',
+            message: '请选择要包含的功能:',
+            choices: [
+                { name: 'TypeScript', value: 'typescript' },
+                { name: 'Prettier', value: 'prettier' },
+                { name: 'ESLint', value: 'eslint' },
+                { name: 'UnoCSS', value: 'unocss' },
+                { name: 'Tailwind CSS', value: 'tailwindcss' },
+            ],
+        },
+    ]);
+    console.log(chalk_1.default.cyan('已选择功能:'), features);
+    // 5. 复制模板到目标目录
+    await (0, template_1.copyTemplate)(template, targetDir);
+    // 6. 类型/文件自动转换（React: jsx->tsx，Vue/UniApp: js->ts + vue lang="ts"）
+    const srcDir = (0, path_1.join)(targetDir, 'src');
+    if (features.includes('typescript')) {
+        if (template === 'react' && (0, fs_1.existsSync)(srcDir)) {
+            (0, fileOps_1.convertExtRecursive)(srcDir, '.jsx', '.tsx');
+            (0, fileOps_1.replaceImportExtRecursive)(srcDir, '.jsx', '.tsx');
+        }
+        if ((template === 'vue' || template === 'uniapp') && (0, fs_1.existsSync)(srcDir)) {
+            (0, fileOps_1.convertExtRecursive)(srcDir, '.js', '.ts');
+            (0, fileOps_1.replaceImportExtRecursive)(srcDir, '.js', '.ts');
+            (0, fileOps_1.addLangTsToAllVue)(srcDir);
+        }
+        // 新增：根目录 vite.config.js -> vite.config.ts
+        (0, fileOps_1.convertViteConfigToTs)(targetDir);
+        (0, configGen_1.genTsConfig)(targetDir, template);
+    }
+    // 7. 配置文件自动生成
+    if (features.includes('eslint'))
+        (0, configGen_1.genEslintConfig)(targetDir, template, features);
+    if (features.includes('prettier'))
+        (0, configGen_1.genPrettierConfig)(targetDir);
+    if (features.includes('unocss'))
+        (0, configGen_1.genUnoConfig)(targetDir);
+    if (features.includes('tailwindcss'))
+        (0, configGen_1.genTailwindConfig)(targetDir);
+    // 8. 安装开发依赖
+    const devDeps = (0, deps_1.getDevDeps)(template, features);
+    (0, deps_1.installDevDeps)(targetDir, devDeps);
+    // 9. 进度提示与最终依赖安装
+    const spinner = (0, ora_1.default)('正在创建项目...').start();
+    try {
+        // 更新 package.json
+        await (0, template_1.updatePackageJson)(targetDir, projectName);
+        // 安装依赖
+        spinner.text = '正在安装依赖...';
+        (0, child_process_1.execSync)('pnpm install', { cwd: targetDir, stdio: 'inherit' });
+        spinner.succeed(chalk_1.default.green('项目创建成功！'));
+        // 使用说明
+        if (template === 'uniapp') {
+            console.log('\n开始使用:');
+            console.log(`  cd ${projectName}`);
+            console.log('  # 推荐用 HBuilderX 打开项目，或使用 dcloud 官方 CLI');
+            console.log('  # 例如：');
+            console.log('  pnpm build:alipay    # 打包支付宝小程序');
+            console.log('  pnpm dev:alipay      # 运行支付宝小程序');
+            console.log('  pnpm build:mp-weixin # 打包微信小程序');
+            console.log('  pnpm dev:mp-weixin   # 运行微信小程序');
+        }
+        else {
+            console.log('\n开始使用:');
+            console.log(`  cd ${projectName}`);
+            console.log('  pnpm dev');
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('项目创建失败！'));
+        console.error(error);
+    }
+}

package/dist/commands/generate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 生成 API 的函数
+ * @param url - API 文档的 URL 地址
+ * @param options - 配置选项，包含输出目录
+ */
+export declare function generateApi(url: string, options: {
+    output: string;
+}): Promise<void>;

package/dist/commands/generate.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateApi = generateApi;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../utils/api");
+/**
+ * 生成 API 的函数
+ * @param url - API 文档的 URL 地址
+ * @param options - 配置选项，包含输出目录
+ */
+async function generateApi(url, options) {
+    const spinner = (0, ora_1.default)('正在生成 API...').start();
+    try {
+        // 调用 API 生成工具函数
+        await (0, api_1.generateApi)(url, options.output);
+        spinner.succeed(chalk_1.default.green('API 生成成功！'));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('API 生成失败！'));
+        console.error(error);
+    }
+}

package/dist/commands/update.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 更新项目依赖的函数
+ * 使用 pnpm update 命令更新所有依赖包到最新版本
+ * 如果更新失败会显示错误信息
+ */
+export declare function updateDeps(): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateDeps = updateDeps;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+/**
+ * 更新项目依赖的函数
+ * 使用 pnpm update 命令更新所有依赖包到最新版本
+ * 如果更新失败会显示错误信息
+ */
+async function updateDeps() {
+    const spinner = (0, ora_1.default)('正在更新依赖...').start();
+    try {
+        // 执行 pnpm update 命令更新依赖
+        (0, child_process_1.execSync)('pnpm update', { stdio: 'inherit' });
+        spinner.succeed(chalk_1.default.green('依赖更新成功！'));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('依赖更新失败！'));
+        console.error(error);
+    }
+}

package/dist/createApiTest/displayEnumLabel.d.ts

@@ -0,0 +1,3 @@
+import * as API from './types';
+export declare function displayStatusEnum(field: API.StatusEnum): string;
+export declare function displayStatusEnum2(field: API.StatusEnum2): string;

package/dist/createApiTest/displayEnumLabel.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayStatusEnum = displayStatusEnum;
+exports.displayStatusEnum2 = displayStatusEnum2;
+function displayStatusEnum(field) {
+    return { placed: 'placed', approved: 'approved', delivered: 'delivered' }[field];
+}
+function displayStatusEnum2(field) {
+    return { available: 'available', pending: 'pending', sold: 'sold' }[field];
+}

package/dist/createApiTest/displayTypeLabel.d.ts

@@ -0,0 +1,19 @@
+import * as API from './types';
+export declare function displayApiResponse(field: keyof API.ApiResponse): string;
+export declare function displayCategory(field: keyof API.Category): string;
+export declare function displayOrder(field: keyof API.Order): string;
+export declare function displayPet(field: keyof API.Pet): string;
+export declare function displaypetFindByStatusUsingGetParams(field: keyof API.petFindByStatusUsingGetParams): string;
+export declare function displaypetFindByTagsUsingGetParams(field: keyof API.petFindByTagsUsingGetParams): string;
+export declare function displaypetPetIdUploadImageUsingPostParams(field: keyof API.petPetIdUploadImageUsingPostParams): string;
+export declare function displaypetPetIdUsingDeleteParams(field: keyof API.petPetIdUsingDeleteParams): string;
+export declare function displaypetPetIdUsingGetParams(field: keyof API.petPetIdUsingGetParams): string;
+export declare function displaypetPetIdUsingPostParams(field: keyof API.petPetIdUsingPostParams): string;
+export declare function displaystoreOrderOrderIdUsingDeleteParams(field: keyof API.storeOrderOrderIdUsingDeleteParams): string;
+export declare function displaystoreOrderOrderIdUsingGetParams(field: keyof API.storeOrderOrderIdUsingGetParams): string;
+export declare function displayTag(field: keyof API.Tag): string;
+export declare function displayUser(field: keyof API.User): string;
+export declare function displayuserLoginUsingGetParams(field: keyof API.userLoginUsingGetParams): string;
+export declare function displayuserUsernameUsingDeleteParams(field: keyof API.userUsernameUsingDeleteParams): string;
+export declare function displayuserUsernameUsingGetParams(field: keyof API.userUsernameUsingGetParams): string;
+export declare function displayuserUsernameUsingPutParams(field: keyof API.userUsernameUsingPutParams): string;

package/dist/createApiTest/displayTypeLabel.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayApiResponse = displayApiResponse;
+exports.displayCategory = displayCategory;
+exports.displayOrder = displayOrder;
+exports.displayPet = displayPet;
+exports.displaypetFindByStatusUsingGetParams = displaypetFindByStatusUsingGetParams;
+exports.displaypetFindByTagsUsingGetParams = displaypetFindByTagsUsingGetParams;
+exports.displaypetPetIdUploadImageUsingPostParams = displaypetPetIdUploadImageUsingPostParams;
+exports.displaypetPetIdUsingDeleteParams = displaypetPetIdUsingDeleteParams;
+exports.displaypetPetIdUsingGetParams = displaypetPetIdUsingGetParams;
+exports.displaypetPetIdUsingPostParams = displaypetPetIdUsingPostParams;
+exports.displaystoreOrderOrderIdUsingDeleteParams = displaystoreOrderOrderIdUsingDeleteParams;
+exports.displaystoreOrderOrderIdUsingGetParams = displaystoreOrderOrderIdUsingGetParams;
+exports.displayTag = displayTag;
+exports.displayUser = displayUser;
+exports.displayuserLoginUsingGetParams = displayuserLoginUsingGetParams;
+exports.displayuserUsernameUsingDeleteParams = displayuserUsernameUsingDeleteParams;
+exports.displayuserUsernameUsingGetParams = displayuserUsernameUsingGetParams;
+exports.displayuserUsernameUsingPutParams = displayuserUsernameUsingPutParams;
+function displayApiResponse(field) {
+    return {
+        code: 'code',
+        type: 'type',
+        message: 'message',
+    }[field];
+}
+function displayCategory(field) {
+    return {
+        id: 'id',
+        name: 'name',
+    }[field];
+}
+function displayOrder(field) {
+    return {
+        id: 'id',
+        petId: 'petId',
+        quantity: 'quantity',
+        shipDate: 'shipDate',
+        status: 'Order Status',
+        complete: 'complete',
+    }[field];
+}
+function displayPet(field) {
+    return {
+        id: 'id',
+        name: 'name',
+        category: 'category',
+        photoUrls: 'photoUrls',
+        tags: 'tags',
+        status: 'pet status in the store',
+    }[field];
+}
+function displaypetFindByStatusUsingGetParams(field) {
+    return {
+        status: 'Status values that need to be considered for filter',
+    }[field];
+}
+function displaypetFindByTagsUsingGetParams(field) {
+    return {
+        tags: 'Tags to filter by',
+    }[field];
+}
+function displaypetPetIdUploadImageUsingPostParams(field) {
+    return {
+        petId: 'ID of pet to update',
+        additionalMetadata: 'Additional Metadata',
+    }[field];
+}
+function displaypetPetIdUsingDeleteParams(field) {
+    return {
+        petId: 'Pet id to delete',
+    }[field];
+}
+function displaypetPetIdUsingGetParams(field) {
+    return {
+        petId: 'ID of pet to return',
+    }[field];
+}
+function displaypetPetIdUsingPostParams(field) {
+    return {
+        petId: 'ID of pet that needs to be updated',
+        name: 'Name of pet that needs to be updated',
+        status: 'Status of pet that needs to be updated',
+    }[field];
+}
+function displaystoreOrderOrderIdUsingDeleteParams(field) {
+    return {
+        orderId: 'ID of the order that needs to be deleted',
+    }[field];
+}
+function displaystoreOrderOrderIdUsingGetParams(field) {
+    return {
+        orderId: 'ID of order that needs to be fetched',
+    }[field];
+}
+function displayTag(field) {
+    return {
+        id: 'id',
+        name: 'name',
+    }[field];
+}
+function displayUser(field) {
+    return {
+        id: 'id',
+        username: 'username',
+        firstName: 'firstName',
+        lastName: 'lastName',
+        email: 'email',
+        password: 'password',
+        phone: 'phone',
+        userStatus: 'User Status',
+    }[field];
+}
+function displayuserLoginUsingGetParams(field) {
+    return {
+        username: 'The user name for login',
+        password: 'The password for login in clear text',
+    }[field];
+}
+function displayuserUsernameUsingDeleteParams(field) {
+    return {
+        username: 'The name that needs to be deleted',
+    }[field];
+}
+function displayuserUsernameUsingGetParams(field) {
+    return {
+        username: 'The name that needs to be fetched. Use user1 for testing',
+    }[field];
+}
+function displayuserUsernameUsingPutParams(field) {
+    return {
+        username: 'name that need to be deleted',
+    }[field];
+}

package/dist/createApiTest/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './displayEnumLabel';
+export * from './displayTypeLabel';
+export * from './pet';
+export * from './store';
+export * from './user';

package/dist/createApiTest/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable */
+// @ts-ignore
+__exportStar(require("./types"), exports);
+__exportStar(require("./displayEnumLabel"), exports);
+__exportStar(require("./displayTypeLabel"), exports);
+__exportStar(require("./pet"), exports);
+__exportStar(require("./store"), exports);
+__exportStar(require("./user"), exports);

package/dist/createApiTest/pet.d.ts

@@ -0,0 +1,58 @@
+import * as API from './types';
+/** Update an existing pet. Update an existing pet by Id. 返回值: Unexpected error PUT /pet */
+export declare function petUsingPut({ body, options, }: {
+    body: API.Pet;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Add a new pet to the store. Add a new pet to the store. 返回值: Unexpected error POST /pet */
+export declare function petUsingPost({ body, options, }: {
+    body: API.Pet;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Find pet by ID. Returns a single pet. 返回值: Unexpected error GET /pet/${param0} */
+export declare function petPetIdUsingGet({ params, options, }: {
+    params: API.petPetIdUsingGetParams;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Updates a pet in the store with form data. Updates a pet resource based on the form data. 返回值: Unexpected error POST /pet/${param0} */
+export declare function petPetIdUsingPost({ params, options, }: {
+    params: API.petPetIdUsingPostParams;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Deletes a pet. Delete a pet. 返回值: Unexpected error DELETE /pet/${param0} */
+export declare function petPetIdUsingDelete({ params, options, }: {
+    params: API.petPetIdUsingDeleteParams;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Uploads an image. Upload image of the pet. 返回值: Unexpected error POST /pet/${param0}/uploadImage */
+export declare function petPetIdUploadImageUsingPost({ params, body, options, }: {
+    params: API.petPetIdUploadImageUsingPostParams;
+    body: string;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Finds Pets by status. Multiple status values can be provided with comma separated strings. 返回值: Unexpected error GET /pet/findByStatus */
+export declare function petFindByStatusUsingGet({ params, options, }: {
+    params: API.petFindByStatusUsingGetParams;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;
+/** Finds Pets by tags. Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing. 返回值: Unexpected error GET /pet/findByTags */
+export declare function petFindByTagsUsingGet({ params, options, }: {
+    params: API.petFindByTagsUsingGetParams;
+    options?: {
+        [key: string]: unknown;
+    };
+}): Promise<any>;