flu-cli 0.0.4 → 2.0.0

package/config/templates.js

@@ -0,0 +1,147 @@
+/**
+ * 模板配置文件
+ * 定义所有可用的项目模板
+ */
+
+export const TEMPLATES = {
+  lite: {
+    name: 'Lite',
+    displayName: 'Lite - 精简版',
+    description: '最小依赖，单文件结构，适合小型项目和快速原型',
+    local: true,
+    repo: 'https://gitee.com/flu-cli/template-lite.git',
+    branch: 'main',
+    complexity: 1,
+    teamSize: '1 人',
+    codeSize: '< 5k 行',
+    features: [
+      '✅ 最小依赖',
+      '✅ 单文件结构',
+      '✅ Material 3 设计',
+      '✅ 快速启动'
+    ],
+    structure: `
+lib/
+├── 📄 main.dart           # 应用入口
+├── 📄 app.dart            # 应用配置
+├── 📁 pages/              # 页面
+├── 📁 viewmodels/         # 视图模型
+├── 📁 widgets/            # 简单组件
+├── 📁 components/         # 复合组件
+├── 📁 services/           # 业务服务
+├── 📁 models/             # 数据模型
+├── 📁 config/             # 配置
+└── 📁 utils/              # 工具类
+    `
+  },
+
+  modular: {
+    name: 'Modular',
+    displayName: 'Modular - 模块化版',
+    description: '模块化结构，功能分组，适合中型项目',
+    local: true,
+    repo: 'https://gitee.com/flu-cli/template-modular.git',
+    branch: 'main',
+    complexity: 3,
+    teamSize: '2-5 人',
+    codeSize: '5k-20k 行',
+    features: [
+      '✅ 模块化结构',
+      '✅ 路由配置独立',
+      '✅ 主题配置独立',
+      '✅ 功能分组'
+    ],
+    structure: `
+lib/
+├── 📄 main.dart
+├── 📁 core/              # 核心基础设施
+│   ├── theme/            # 主题系统
+│   ├── router/           # 路由系统
+│   ├── constants/        # 常量定义
+│   └── base/             # 基础类（BaseViewModel, BasePage）
+├── 📁 shared/            # 跨模块共享
+│   ├── widgets/          # 通用简单组件
+│   ├── components/       # 通用复合组件
+│   ├── models/           # 通用数据模型
+│   └── utils/            # 通用工具类
+└── 📁 features/          # 业务功能模块
+    ├── hoem/             # 用户模块
+    │   ├── pages/
+    │   ├── viewmodels/
+    │   ├── widgets/
+    │   ├── services/
+    └── └── models/
+    `
+  },
+
+  clean: {
+    name: 'Clean',
+    displayName: 'Clean - 分层版',
+    description: '严格分层架构，清晰的目录结构，适合大型项目',
+    local: true,
+    repo: 'https://gitee.com/flu-cli/template-clean.git',
+    branch: 'main',
+    complexity: 5,
+    teamSize: '5+ 人',
+    codeSize: '> 20k 行',
+    features: [
+      '✅ 严格分层架构',
+      '✅ 清晰的目录结构',
+      '✅ 易于扩展和维护',
+      '✅ 适合团队协作'
+    ],
+    structure: `
+lib/
+├── 📄 main.dart                    # 应用入口
+├── 📄 app.dart                     # 应用配置
+├── 📁 core/                        # 核心层(最内层)
+│   ├── constants/                  # 常量定义
+│   ├── errors/                     # 错误和异常
+│   ├── usecases/                   # UseCase 基类
+│   ├── utils/                      # 工具类
+│   └── network/                    # 网络配置
+├── 📁 features/                    # 功能模块(按业务划分)
+│   └── home/                       # 示例:首页模块
+│       ├── data/                   # 数据层
+│       │   ├── datasources/        # 数据源(API/本地)
+│       │   ├── models/             # 数据模型(DTO)
+│       │   └── repositories/       # Repository 实现
+│       ├── domain/                 # 领域层
+│       │   ├── entities/           # 业务实体
+│       │   ├── repositories/       # Repository 接口
+│       │   └── usecases/           # 用例(业务逻辑)
+│       └── presentation/           # 表现层
+│           ├── pages/              # 页面
+│           ├── widgets/            # 模块专用组件
+│           └── viewmodels/         # 视图模型
+├── 📁 shared/                      # 共享资源
+│   ├── widgets/                    # 通用组件
+│   ├── components/                 # 通用复合组件
+│   └── extensions/                 # 扩展方法
+└── 📁 config/                      # 配置层
+    ├── routes/                     # 路由配置
+    └── theme/                      # 主题配置
+    `
+  }
+};
+
+/**
+ * 获取模板配置
+ */
+export function getTemplate (name) {
+  return TEMPLATES[name];
+}
+
+/**
+ * 获取所有模板
+ */
+export function getAllTemplates () {
+  return Object.values(TEMPLATES);
+}
+
+/**
+ * 验证模板名称
+ */
+export function isValidTemplate (name) {
+  return name in TEMPLATES;
+}

package/index.js

@@ -1,108 +1,155 @@
 #!/usr/bin/env node
 
 /**
- * 火之夜工作室 Flutter 项目创建工具
+ * flu-cli v2.0
+ * Flutter MVVM 脚手架工具
  * 
- * 主入口文件，处理命令行参数并调用相应功能
+ * 支持多种架构模板和代码生成功能
  */
 
-
-import { program } from 'commander'
+import { program } from 'commander';
 import chalk from 'chalk';
-import { createProject } from './lib/createProject.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { newProjectWithClack } from './lib/commands/newClack.js';
+import { addComponent } from './lib/commands/add.js';
+import { listTemplates, showTemplateDetail } from './lib/commands/templates.js';
+import { updateTemplates, cleanCache } from './lib/commands/cache.js';
+import { generateStateManager } from './lib/commands/generate.js';
 
-// 获取package.json内容
+// 获取 package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const packageJson = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'));
 
-// 设置版本号和描述
+// 设置版本和描述
 program
   .version(packageJson.version)
-  .description(chalk.cyan('火之夜工作室 Flutter 项目创建工具'));
-
-// 
+  .description(chalk.cyan('🚀 Flutter MVVM 脚手架工具'));
 
-// 创建项目命令
+// ========== 创建项目命令（V1 已废弃） ==========
+// V1 命令已移除，请使用 'flu new' 命令
 program
   .command('create')
-  .description('创建新的Flutter项目')
-  .option('-t, --project-type <type>', '项目类型: app, module, package, plugin', 'app')
-  .option('-m, --template-type <type>', '模板类型: only, min, normal, pro', 'normal')
-  .option('-s, --state-manager <name>', '状态管理: state, GetX, Provider, MobX, Bloc, Riverpod', 'GetX')
-  .option('-n, --project-name <name>', '项目名称')
-  .option('-p, --package-name <name>', '包名(com.example.app)')
-  .option('-d, --parent-dir <path>', '项目存放目录')
-  .option('-i, --ide <type>', '使用的IDE: vscode, android_studio, open_folder , manual', 'vscode')
-  .option('-f, --flutter-sdk <path>', '自定义Flutter SDK路径')
-  .option('-h, --help', '显示创建命令帮助信息')
-  .action((options) => {
-    if (options.help) {
-      console.log(chalk.bold.greenBright('flu-cli create - 创建新的Flutter项目'));
-      console.log('用法: flu-cli create [选项]');
-      console.log('选项:');
-      console.log('  -t, --project-type <type>    项目类型 (app, module, package, plugin) [默认: app]');
-      console.log('  -m, --template-type <type>   模板类型 (only, min, normal, pro) [默认: pro]');
-      console.log('  -s, --state-manager <name>   状态管理方案 (state, GetX,) [默认: GetX]');
-      console.log('  -n, --project-name <name>    项目名称 [默认: hzy_example_${项目类型}]');
-      console.log('  -p, --package-name <name>    包名 [默认: com.example.${项目类型}]');
-      console.log('  -d, --parent-dir <path>      项目存放目录 [默认: 当前目录]');
-      console.log('  -i, --ide <choice>           IDE选择 (vscode, android_studio, open_folder, manual) [默认: vscode]');
-      console.log('  -f, --flutter-sdk <path>     自定义Flutter SDK路径 [默认: 系统环境变量中的flutter]');
-      console.log('  -h, --help                   显示本帮助信息');
-      process.exit(0);
+  .description('⚠️  已废弃：请使用 flu new 命令')
+  .action(() => {
+    console.log(chalk.yellow('\n⚠️  create 命令已在 V2 中废弃\n'));
+    console.log(chalk.cyan('请使用新命令：'));
+    console.log(chalk.green('  flu new <project-name>\n'));
+    console.log(chalk.gray('示例：'));
+    console.log(chalk.gray('  flu new my_app --template lite'));
+    console.log(chalk.gray('  flu new my_app --template modular'));
+    console.log(chalk.gray('  flu new my_app --template clean\n'));
+    console.log(chalk.blue('查看帮助：flu new --help\n'));
+    process.exit(0);
+  });
+
+// ========== 新建项目命令（现代化交互式体验） ==========
+program
+  .command('new [project-name]')
+  .alias('n')
+  .description('创建 Flutter 项目（实时模板预览）')
+  .option('-t, --template <type>', '模板类型: lite, modular, clean')
+  .option('-s, --state <type>', '状态管理器: default, provider, getx, riverpod', 'default')
+  .option('-d, --dir <path>', '项目存放目录', process.cwd())
+  .option('--no-cache', '不使用缓存，强制从 Git 拉取')
+  .option('--remote', '使用远程 Gitee 模板（默认使用本地模板）')
+  .action((projectName, options) => {
+    newProjectWithClack(projectName, options);
+  });
+
+// ========== 添加组件命令 ==========
+program
+  .command('add [type] [name]')
+  .alias('a')
+  .description('添加 Flutter 代码组件 (page/p, widget/w, component/c, ...)')
+  .option('-f, --feature <name>', '所属功能模块（仅 modular/clean 模式）')
+  .option('--stateful', '创建 StatefulWidget（默认 StatelessWidget）')
+  .option('--stateless', '强制创建 StatelessWidget（即使有 ViewModel，不推荐）')
+  .option('--list-page', '创建列表页 (BaseListPage)')
+  .option('--no-vm', '不生成 ViewModel（仅 page 类型）')
+  .option('--type <type>', 'Service 类型: api, storage, auth（仅 service 类型）', 'api')
+  .option('--json <file>', '从 JSON 文件生成（仅 model 类型）')
+  .option('--list', '查看支持的类型列表')
+  .action((type, name, options) => {
+    addComponent(type, name, options);
+  });
+
+// ========== 模板管理命令 ==========
+program
+  .command('templates [template-name]')
+  .alias('t')
+  .description('查看所有模板或指定模板详情')
+  .action((templateName) => {
+    if (templateName) {
+      showTemplateDetail(templateName);
+    } else {
+      listTemplates();
     }
+  });
 
-    console.log(chalk.bold.greenBright('欢迎使用 火之夜工作室 Flutter 项目创建工具'));
-
-    // 检查是否提供了命令行参数
-    const hasCommandLineArgs = options.projectName ||
-      options.packageName ||
-      options.projectType !== 'app' ||
-      options.templateType !== 'normal' ||
-      options.stateManager !== 'GetX' ||
-      options.parentDir || options.ide !== 'vscode' || options.flutterSdk;
-
-    // 如果提供了命令行参数，则直接使用这些参数创建项目
-    // 否则使用交互式方式获取参数
-    createProject({
-      useCommandLineArgs: hasCommandLineArgs,
-      projectType: options.projectType,
-      templateType: options.templateType,
-      stateManager: options.stateManager,
-      projectName: options.projectName,
-      packageName: options.packageName,
-      parentDir: options.parentDir,
-      ideChoice: options.ide,
-      flutterSdkPath: options.flutterSdk,
-    });
+program
+  .command('generate-sm <type>')
+  .alias('g')
+  .description('为现有项目生成状态管理适配与配置')
+  .option('-d, --dir <path>', '项目目录', process.cwd())
+  .option('-m, --module <name>', '模块名称（modular/clean 支持分模块适配器布局）')
+  .action((type, options) => {
+    generateStateManager(type, options);
   });
 
-// 全局帮助处理
-if (process.argv.includes('-h') || process.argv.includes('--help')) {
-  if (process.argv.length <= 3) {
-    console.log('flu-cli - 火之夜工作室Flutter项目创建工具');
-    console.log('版本: ' + packageJson.version);
-    console.log('用法: flu-cli [命令] [选项]\n');
-    console.log('命令:');
-    console.log('  create    创建新的Flutter项目\n');
-    console.log('全局选项:');
-    console.log('  -V, --version   显示版本号');
-    console.log('  -h, --help      显示全局帮助信息\n');
-    console.log('使用 "flu-cli [命令] --help" 查看特定命令的详细帮助');
-    process.exit(0);
-  }
-  program.parse(process.argv);
-}
+// ========== 缓存管理命令 ==========
+program
+  .command('update-templates [template-name]')
+  .alias('update')
+  .alias('u')
+  .description('更新模板缓存')
+  .option('--force', '强制刷新并清理未跟踪文件')
+  .action((templateName, options) => {
+    updateTemplates(templateName, options);
+  });
+
+program
+  .command('cache <action>')
+  .alias('c')
+  .description('缓存管理 (action: clean)')
+  .action((action) => {
+    if (action === 'clean') {
+      cleanCache();
+    } else {
+      console.log(chalk.red(`未知的操作: ${action}`));
+      console.log(chalk.yellow('支持的操作: clean'));
+    }
+  });
 
+// ========== 代码片段管理 ==========
+import { syncSnippets } from './lib/commands/snippets.js';
 
+program
+  .command('sync-snippets')
+  .alias('sync')
+  .description('同步最新版本的标准代码片段到当前项目')
+  .action(() => {
+    syncSnippets();
+  });
 
-// 如果没有提供命令，默认执行创建项目
+// ========== 自动补全 ==========
+import { completion } from './lib/commands/completion.js';
+
+program
+  .command('completion')
+  .alias('comp')
+  .description('生成 Shell 自动补全脚本 (bash/zsh)')
+  .action(() => {
+    completion();
+  });
+
+
+// 解析命令行参数
+program.parse(process.argv);
+
+// 如果没有提供命令，显示帮助信息
 if (process.argv.length === 2) {
-  console.log(chalk.bold.greenBright('欢迎使用 火之夜工作室 Flutter 项目创建工具\n'));
-  createProject({});
-} else {
-  program.parse(process.argv);
-}
+  console.log(chalk.bold.cyan('\n🚀 欢迎使用 flu-cli v2.0\n'));
+  program.help();
+}