flu-cli 2.0.3 → 2.0.4

package/lib/generators/project_generator.js

@@ -1,96 +0,0 @@
-// 项目生成器：复制模板、处理占位、触发状态管理生成
-import { existsSync } from 'fs';
-import fsx from 'fs-extra';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import { StateManagerGenerator } from './state_manager_generator.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * 项目生成器
- * 负责复制模板、渲染入口与依赖、并执行状态管理器配置
- */
-export class ProjectGenerator {
-  /**
-   * 检查项目目录是否存在
-   */
-  checkProjectExists (projectPath) {
-    return existsSync(projectPath);
-  }
-
-  /**
-   * 复制内置模板到目标目录（lite/modular/clean）
-   */
-  async copyTemplate (templateName, projectPath) {
-    const source = join(__dirname, '../../..', `template-${templateName}`);
-    if (!(await fsx.pathExists(source))) {
-      throw new Error(`内置模板不存在: ${source}`);
-    }
-    await fsx.copy(source, projectPath, { overwrite: true });
-    logger.success(`✓ 已复制模板: ${templateName}`);
-    return true;
-  }
-
-  /**
-   * 根据用户选择配置状态管理器（适配器与入口）
-   */
-  async configureStateManager (projectPath, stateManager, options = {}) {
-    const sm = new StateManagerGenerator(projectPath, stateManager, options);
-    await sm.generate();
-  }
-
-  /**
-   * 处理模板占位符：将 .template 文件落地为实际文件
-   */
-  async processTemplates (projectPath) {
-    const pubspecTpl = join(projectPath, 'pubspec.yaml.template');
-    const pubspecOut = join(projectPath, 'pubspec.yaml');
-    if (await fsx.pathExists(pubspecTpl)) {
-      const content = await fsx.readFile(pubspecTpl, 'utf8');
-      await fsx.writeFile(pubspecOut, content);
-      await fsx.remove(pubspecTpl);
-    }
-
-    const mainTpl = join(projectPath, 'lib', 'main.dart.template');
-    const mainOut = join(projectPath, 'lib', 'main.dart');
-    if (await fsx.pathExists(mainTpl)) {
-      const content = await fsx.readFile(mainTpl, 'utf8');
-      await fsx.writeFile(mainOut, content);
-      await fsx.remove(mainTpl);
-    }
-
-    const initScript = join(projectPath, 'init.sh');
-    if (await fsx.pathExists(initScript)) {
-      await fsx.remove(initScript);
-    }
-
-    const analysisTpl = join(projectPath, 'analysis_options.yaml.template');
-    const analysisOut = join(projectPath, 'analysis_options.yaml');
-    if (await fsx.pathExists(analysisTpl)) {
-      const content = await fsx.readFile(analysisTpl, 'utf8');
-      if (await fsx.pathExists(analysisOut)) {
-        await fsx.remove(analysisOut);
-      }
-      await fsx.writeFile(analysisOut, content);
-      await fsx.remove(analysisTpl);
-    }
-
-    // 统一 analysis_options.yaml 内容，避免重复或历史残留
-    const unified = `# 引入 Flutter 官方推荐的 lint 规则集，确保项目遵循社区最佳实践\ninclude: package:flutter_lints/flutter.yaml\n\nlinter:\n  rules:\n    # 文本与导入相关规则\n    # 强制使用单引号，保持字符串风格统一，减少混用带来的视觉差异\n    prefer_single_quotes: true\n    # 对导入语句按字母顺序及来源分组排序，提升可读性并减少合并冲突\n    directives_ordering: true\n\n    # const 与不可变性相关规则\n    # 鼓励使用 const 构造函数，提前暴露编译期常量，减少运行时对象创建\n    prefer_const_constructors: true\n    # 鼓励使用 const 字面量创建不可变集合，进一步节省内存并提升性能\n    prefer_const_literals_to_create_immutables: true\n\n    # 可读性与一致性相关规则\n    # 要求多行参数、集合、列表等末尾加逗号，使格式化后自动换行更美观\n    require_trailing_commas: true\n    # 推荐将类字段声明为 final，强化不可变语义，减少意外修改\n    prefer_final_fields: true\n    # 推荐将局部变量声明为 final，明确变量只赋值一次，降低副作用\n    prefer_final_locals: true\n    # 建议使用 SizedBox 替代 Container 作为空白占位，语义更清晰且性能更好\n    sized_box_for_whitespace: true\n    # 避免使用不必要的 Container 嵌套，减少冗余节点，提升渲染性能\n    avoid_unnecessary_containers: true\n\n    # Flutter 常见建议规则\n    # 在异步操作后使用 BuildContext 时，先检查 mounted，防止异步回调时组件已卸载导致异常\n    use_build_context_synchronously: true\n`;
-    await fsx.writeFile(analysisOut, unified);
-
-    return true;
-  }
-
-  /**
-   * 执行 flutter pub get（调用者触发，不在此直接运行）
-   */
-  async runPubGet () {
-    logger.info(chalk.gray('提示: 请在项目目录中执行 `flutter pub get`'));
-    return true;
-  }
-
-}

package/lib/generators/state_manager_generator.js

@@ -1,402 +0,0 @@
-// 统一状态管理生成器：按模板与状态管理器选择执行依赖注入、入口增强、路由增强与变体生成
-// 原则：最小侵入、单一代码路径、可演进（便于后续扩展 riverpod 专用变体等）
-import fsx from 'fs-extra';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import Handlebars from 'handlebars';
-
-import { logger } from '../utils/logger.js';
-import { detectProjectTemplate } from '../utils/project_detector.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * 状态管理器生成器
- * 功能：
- * - 注入依赖（get/provider/flutter_riverpod）
- * - 所有模板生成 BaseViewModel 变体（ChangeNotifier/GetX）
- * - 所有模板按需增强入口（GetMaterialApp/ProviderScope）与路由（GetPage 列表）
- */
-export class StateManagerGenerator {
-  /**
-   * 构造函数
-   * @param {string} projectPath 项目根目录
-   * @param {'default'|'provider'|'getx'|'riverpod'} stateManager 选中的状态管理器
-   * @param {{module?: string}} options 额外选项
-   */
-  constructor(projectPath, stateManager = 'default', options = {}) {
-    this.projectPath = projectPath;
-    this.stateManager = stateManager;
-    this.module = options.module || null;
-  }
-
-  /**
-   * 主流程：依赖 → BaseViewModel 生成 → 入口 → App/路由增强 → 完成
-   */
-  async generate () {
-    logger.info(`🔧 配置状态管理器: ${this.stateManager}`);
-    try {
-      await this.addDependencies();
-
-      // 所有模板都生成 BaseViewModel (统一策略)
-      await this.generateBaseViewModel();
-
-      await this.configureMain();
-      await this.configureAppWidget();
-      await this.configureRoutes();
-
-      logger.success('✅ 状态管理器配置完成');
-    } catch (error) {
-      logger.error(`❌ 状态管理器配置失败: ${error.message}`);
-      throw error;
-    }
-  }
-
-  /**
-   * 注入依赖到 pubspec.yaml：
-   * - 处理模板占位 {{{state_manager_dependency}}} / {{{flu_core_dependency}}}
-   * - 兼容非模板 pubspec，通过正则插入
-   */
-  async addDependencies () {
-    const pubspecPath = join(this.projectPath, 'pubspec.yaml');
-
-    if (!(await fsx.pathExists(pubspecPath))) {
-      throw new Error(`pubspec.yaml not found at ${pubspecPath}`);
-    }
-
-    let content = await fsx.readFile(pubspecPath, 'utf8');
-    const dependency = this.getDependency();
-
-    // 移除 flu_core_dependency 占位符
-    if (content.includes('{{{flu_core_dependency}}}')) {
-      content = content.replace(/\s*\{{{flu_core_dependency}}}\s*\n?/, '');
-    }
-
-    if (content.includes('{{{state_manager_dependency}}}')) {
-      content = content.replace('{{{state_manager_dependency}}}', dependency);
-    } else if (dependency) {
-      content = content.replace(/(dependencies:\s*\n(?:[\s\S]*?))(\n\w)/, `$1\n    ${dependency}$2`);
-    }
-
-    await fsx.writeFile(pubspecPath, content);
-    if (dependency) logger.info(`  ✓ 添加依赖: ${dependency.split(':')[0]}`);
-  }
-
-  /**
-   * 返回选中状态管理器的依赖字符串
-   */
-  getDependency () {
-    const map = {
-      default: '',
-      provider: 'provider: ^6.1.1',
-      getx: 'get: ^4.6.6',
-      riverpod: 'flutter_riverpod: ^2.4.9'
-    };
-    return map[this.stateManager] || '';
-  }
-
-  /**
-   * 为所有模板生成 BaseViewModel 变体并重导出统一入口
-   */
-  async generateBaseViewModel () {
-    const { detectProjectTemplate } = await import('../utils/project_detector.js');
-    const tpl = detectProjectTemplate(this.projectPath);
-
-    // 根据模板类型确定目标路径
-    let baseDir;
-    if (tpl === 'lite') {
-      baseDir = join(this.projectPath, 'lib', 'base');
-    } else if (tpl === 'modular') {
-      baseDir = join(this.projectPath, 'lib', 'core', 'base');
-    } else if (tpl === 'clean') {
-      baseDir = join(this.projectPath, 'lib', 'core', 'base');
-    } else {
-      return;  // 未知模板，跳过
-    }
-
-    await fsx.ensureDir(baseDir);
-    const target = join(baseDir, 'base_viewmodel.dart');
-
-    const content = this.buildBaseViewModelContent();
-    await fsx.writeFile(target, content);
-
-    const relPath = target.replace(this.projectPath + '/', '');
-    logger.info(`  ✓ 生成 BaseViewModel: ${relPath}`);
-  }
-
-  /**
-   * 构建 BaseViewModel 变体源码：
-   * - getx：GetxController + 自管理监听列表（兼容 BasePage 的 addListener/removeListener）
-   * - default/provider：ChangeNotifier 变体
-   */
-  buildBaseViewModelContent () {
-
-
-    const commonInfo = `
-  ViewState _state = ViewState.idle;
-  String? _errorMessage;
-  bool _isRefreshing = false;
- 
-  // ==================== Getters ====================
-  // 当前视图状态
-  ViewState get state => _state;
-  // 错误信息
-  String? get errorMessage => _errorMessage;
-  // 是否正在加载
-  bool get isLoading => _state == ViewState.loading;
-  // 是否加载失败
-  bool get isError => _state == ViewState.error;
-  // 是否加载成功
-  bool get isSuccess => _state == ViewState.success;
-  // 是否空闲状态
-  bool get isIdle => _state == ViewState.idle;
-  // 是否正在刷新
-  bool get isRefreshing => _isRefreshing;
-
-
-  // ==================== 状态设置 ====================
-
-  /// 设置视图状态
-  ///
-  /// [state] 新的状态
-  /// [error] 错误信息（仅在 error 状态时有效）
-  void setState(ViewState state, {String? error}) {
-    _state = state;
-    _errorMessage = error;
-    notifyListeners();
-  }
-  
-  /// 设置刷新状态
-  void setRefreshing(bool refreshing) {
-    _isRefreshing = refreshing;
-    notifyListeners();
-  }
- 
-
-`;
-    if (this.stateManager === 'getx') {
-      return `import 'package:get/get.dart';
-enum ViewState { idle, loading, success, error }
-class BaseViewModel extends GetxController {
-  ${commonInfo}
-
-  ///  刷新数据（通知所有监听器）
-  void notifyListeners() {
-    notifyDataChange();
-  }
-  /// 通知数据变化（仅用于局部刷新）
-  void notifyDataChange() {
-    update();
-  }
-
-  // ==================== 生命周期 ====================
-  /// 初始化钩子（函数级注释）
-  @override
-  Future<void> onInit() async {  
-    super.onInit();
-    // 子类可以重写此方法进行初始化
-  }
-
-  /// 刷新数据（钩子）
-  Future<void> refreshData() async {  
-    // 子类可以重写此方法实现刷新逻辑
-  }
-}
-`;
-    }
-
-    // provider 与 default 采用 ChangeNotifier 变体
-    return `import 'package:flutter/foundation.dart';
-enum ViewState { idle, loading, success, error }
-
-class BaseViewModel extends ChangeNotifier {
-  ${commonInfo}
-
-    /// 通知数据变化（仅用于局部刷新）
-  void notifyDataChange() {
-    notifyListeners();
-  }
-
-  // ==================== 生命周期 ====================
-  /// 初始化钩子（函数级注释）
-  Future<void> onInit() async {
-     // 子类可以重写此方法进行初始化
-  }
-
-  /// 刷新数据（钩子）
-  Future<void> refreshData() async {  
-    // 子类可以重写此方法实现刷新逻辑
-  }
-}
-`;
-  }
-
-  /**
-   * 配置入口 main.dart：
-   * - 模板文件执行 Handlebars 渲染（只处理 riverpod 条件）
-   * - 非模板文件无需额外处理
-   */
-  async configureMain () {
-    const mainPath = join(this.projectPath, 'lib', 'main.dart');
-    if (!(await fsx.pathExists(mainPath))) {
-      throw new Error(`main.dart not found at ${mainPath}`);
-    }
-
-    const raw = await fsx.readFile(mainPath, 'utf8');
-
-    // 检查是否为模板文件
-    const isTemplate = raw.includes('{{#if_riverpod}}');
-    if (isTemplate) {
-      this.registerHandlebarsHelpers();
-      const compiled = Handlebars.compile(raw);
-      const rendered = compiled({
-        if_riverpod: this.stateManager === 'riverpod'
-      });
-      await fsx.writeFile(mainPath, rendered);
-    }
-  }
-
-  /**
-   * 增强 App 入口组件（GetX）：
-   * - lite/clean：lib/app.dart → MaterialApp 替换为 GetMaterialApp，注入 get 导入与 getPages
-   * - modular：lib/main.dart → MaterialApp 替换为 GetMaterialApp，注入 get 导入与 getPages
-   */
-  async configureAppWidget () {
-    try {
-      const tpl = detectProjectTemplate(this.projectPath);
-      const isGetX = this.stateManager === 'getx';
-      if (!isGetX) return;
-
-      if (tpl === 'lite' || tpl === 'clean') {
-        const appPath = join(this.projectPath, 'lib', 'app.dart');
-        if (!(await fsx.pathExists(appPath))) return;
-        let raw = await fsx.readFile(appPath, 'utf8');
-        if (!raw.includes('GetMaterialApp(')) {
-          raw = raw.replace(/MaterialApp\s*\(/, 'GetMaterialApp(');
-        }
-        if (!/package:get\/get\.dart/.test(raw)) {
-          raw = `import 'package:get/get.dart';\n` + raw;
-        }
-        const pagesAccessor = tpl === 'lite' ? 'AppRoutes.pages' : 'AppRoutes.pages';
-        if (!new RegExp(`getPages:\\s*${pagesAccessor}`).test(raw)) {
-          raw = raw.replace(/initialRoute:\s*AppRoutes\.home,/, `initialRoute: AppRoutes.home,\n      getPages: ${pagesAccessor},`);
-        }
-        raw = raw.replace(/\s*routes:\s*AppRoutes\.routes,\s*\n/, '\n');
-        await fsx.writeFile(appPath, raw);
-      } else if (tpl === 'modular') {
-        const mainPath = join(this.projectPath, 'lib', 'main.dart');
-        if (!(await fsx.pathExists(mainPath))) return;
-        let raw = await fsx.readFile(mainPath, 'utf8');
-        if (!raw.includes('GetMaterialApp(')) {
-          raw = raw.replace(/MaterialApp\s*\(/, 'GetMaterialApp(');
-        }
-        if (!/package:get\/get\.dart/.test(raw)) {
-          raw = raw.replace(/^(import\s+['"].+?['"];\s*\n)+/m, (m) => `${m}import 'package:get/get.dart';\n`);
-          if (!raw.includes("import 'package:get/get.dart';")) {
-            raw = `import 'package:get/get.dart';\n` + raw;
-          }
-        }
-        if (!/getPages:\s*AppRouter\.pages/.test(raw)) {
-          raw = raw.replace(/initialRoute:\s*AppRouter\.home,/, "initialRoute: AppRouter.home,\n      getPages: AppRouter.pages,");
-        }
-        raw = raw.replace(/\s*routes:\s*AppRouter\.routes,\s*\n/, '\n');
-        await fsx.writeFile(mainPath, raw);
-      }
-    } catch (_) { }
-  }
-
-  /**
-   * 增强路由文件(GetX):为不同模板注入 List<GetPage> pages 与 get 导入
-   * 智能转换原有路由定义,保留所有路由
-   */
-  async configureRoutes () {
-    try {
-      const tpl = detectProjectTemplate(this.projectPath);
-      if (this.stateManager !== 'getx') return;
-      let routesPath;
-      if (tpl === 'lite') {
-        routesPath = join(this.projectPath, 'lib', 'config', 'routes.dart');
-      } else if (tpl === 'modular') {
-        routesPath = join(this.projectPath, 'lib', 'core', 'router', 'app_router.dart');
-      } else if (tpl === 'clean') {
-        routesPath = join(this.projectPath, 'lib', 'config', 'routes', 'app_routes.dart');
-      } else {
-        return;
-      }
-      if (!(await fsx.pathExists(routesPath))) return;
-      let raw = await fsx.readFile(routesPath, 'utf8');
-
-      // 替换 flutter import 为 get import
-      if (!/package:get\/get\.dart/.test(raw)) {
-        raw = raw.replace("import 'package:flutter/material.dart';\n", "import 'package:get/get.dart';\n");
-      }
-
-      // 如果已经是 GetPage 格式,跳过
-      if (/static\s+List<\s*GetPage/.test(raw)) {
-        return;
-      }
-
-      // 提取路由常量定义
-      const routeConstantsMatch = raw.match(/static\s+const\s+String\s+\w+\s*=\s*['"][^'"]+['"];/g);
-      const routeConstants = routeConstantsMatch ? routeConstantsMatch.join('\n  ') : "static const String home = '/';";
-
-      // 提取原有的 routes map 并转换为 GetPage
-      let getPages = [];
-      const routesMapMatch = raw.match(/routes:\s*\(context\)\s*=>\s*const\s+(\w+)\(\)/g) ||
-        raw.match(/(\w+):\s*\(context\)\s*=>\s*const\s+(\w+)\(\)/g);
-
-      if (routesMapMatch) {
-        // 从 routes getter 中提取
-        const routesGetterMatch = raw.match(/static\s+Map<String,\s*WidgetBuilder>\s+get\s+routes\s*\{[^}]*return\s*\{([^}]+)\};/s);
-        if (routesGetterMatch) {
-          const routesContent = routesGetterMatch[1];
-          // 解析每个路由
-          const routePattern = /(\w+):\s*\(context\)\s*=>\s*const\s+(\w+)\(\)/g;
-          let match;
-          while ((match = routePattern.exec(routesContent)) !== null) {
-            const [, routeName, widgetName] = match;
-            getPages.push(`      GetPage(name: ${routeName}, page: () => const ${widgetName}())`);
-          }
-        }
-      }
-
-      // 如果没有提取到任何路由,使用默认的 home
-      if (getPages.length === 0) {
-        getPages.push(`      GetPage(name: home, page: () => const HomePage())`);
-      }
-
-      const className = raw.match(/class\s+(\w+)/)?.[1] || 'AppRoutes';
-
-      // 构建新的 class
-      const newClass = `class ${className} {
-  ${className}._();
-
-  ${routeConstants}
-
-  static List<GetPage<dynamic>> get pages {
-    return [
-${getPages.join(',\n')},
-    ];
-  }
-}
-`;
-
-      // 替换整个 class
-      raw = raw.replace(/class\s+\w+[\s\S]*?^}/m, newClass);
-
-      await fsx.writeFile(routesPath, raw);
-    } catch (error) {
-      logger.warn(`  ⚠️ 路由配置可能需要手动调整: ${error.message}`);
-    }
-  }
-
-  /**
-   * 注册 Handlebars 条件助手：控制模板片段的渲染/隐藏
-   */
-  registerHandlebarsHelpers () {
-    Handlebars.registerHelper('if_riverpod', function (options) {
-      return options.data.root.if_riverpod ? options.fn(this) : options.inverse(this);
-    });
-  }
-
-}

package/templates/README.md

@@ -1,138 +0,0 @@
-# Flutter 模板
-
-## 📁 独立仓库架构
-
-从 V2 开始，每个模板都有自己的独立 Git 仓库：
-
-| 模板        | 仓库地址                                                       | 说明                                    |
-| ----------- | -------------------------------------------------------------- | --------------------------------------- |
-| **lite**    | [template-lite](https://gitee.com/flu-cli/template-lite)       | 轻量级模板，适合快速原型开发            |
-| **modular** | [template-modular](https://gitee.com/flu-cli/template-modular) | 模块化模板，适合中大型项目              |
-| **clean**   | [template-clean](https://gitee.com/flu-cli/template-clean)     | Clean Architecture 模板，适合企业级应用 |
-
-## 🎯 为什么使用独立仓库？
-
-### 优势
-
-1. **独立维护**
-
-    - 每个模板可以独立更新和发版
-    - 不同团队可以维护不同模板
-    - 版本控制更清晰
-
-2. **减小主仓库体积**
-
-    - flu-cli 主仓库不包含模板代码
-    - 下载和克隆更快
-
-3. **灵活的版本控制**
-
-    - 用户可以选择特定版本的模板
-    - 支持模板的独立版本号
-
-4. **更好的协作**
-    - 模板贡献者不需要访问主仓库
-    - 降低协作门槛
-
-## 🚀 使用方式
-
-### 通过 flu-cli 使用（推荐）
-
-```bash
-# flu-cli 会自动从远程下载模板
-flu-cli new my_app --template lite
-
-# 或使用本地模板（如果已克隆）
-flu-cli new my_app --template lite
-```
-
-### 直接克隆模板
-
-```bash
-# 克隆模板仓库
-git clone https://gitee.com/flu-cli/template-lite.git my_app
-cd my_app
-
-# 初始化（创建 pubspec.yaml）
-./init.sh
-
-# 运行
-flutter run
-```
-
-## 📝 本地开发模板
-
-如果你想在本地开发和测试模板：
-
-```bash
-# 1. 克隆模板到 templates/ 目录
-cd templates/
-git clone https://gitee.com/flu-cli/template-lite.git lite
-git clone https://gitee.com/flu-cli/template-modular.git modular
-git clone https://gitee.com/flu-cli/template-clean.git clean
-
-# 2. 进入模板目录开发
-cd lite
-./init.sh
-flutter run
-
-# 3. 提交更改到模板仓库
-git add .
-git commit -m "Update template"
-git push
-```
-
-## 🔄 模板更新流程
-
-### 更新模板
-
-```bash
-# 进入模板目录
-cd templates/lite
-
-# 拉取最新代码
-git pull
-
-# 测试
-./init.sh
-flutter run
-
-# 提交更改
-git add .
-git commit -m "Update: xxx"
-git push
-```
-
-### 用户更新模板
-
-```bash
-# flu-cli 会自动检查更新
-flu-cli update
-
-# 或强制更新
-flu-cli new my_app --template lite --no-cache
-```
-
-## 📚 相关文档
-
--   [双文件策略说明](../MIGRATION_PLAN.md#双文件策略)
--   [迁移到 Gitee 组织](../MIGRATION_PLAN.md)
--   [模板开发指南](https://gitee.com/flu-cli/flu-cli-docs)
-
-## 💡 注意事项
-
-1. **flu-cli 主仓库不跟踪 templates/ 内容**
-
-    - templates/ 已添加到 .gitignore
-    - 只保留此 README.md
-
-2. **每个模板都是独立的 Git 仓库**
-
-    - 有自己的 .git 目录
-    - 独立的提交历史
-    - 独立的版本号
-
-3. **本地开发时**
-    - 可以在 templates/ 下克隆模板仓库
-    - 修改后提交到对应的模板仓库
-    - 不会影响 flu-cli 主仓库