flu-cli 0.0.5 → 2.0.0

package/lib/commands/add.js

@@ -0,0 +1,472 @@
+/**
+ * add 命令 - 添加组件
+ * 生成页面、Widget、Component、ViewModel 等
+ */
+
+import { logger } from '../utils/logger.js';
+import { generatePage } from '../generators/page_generator.js';
+import { generateWidget } from '../generators/widget_generator.js';
+import { generateComponent } from '../generators/component_generator.js';
+import { generateViewModel } from '../generators/viewmodel_generator.js';
+import { generateService } from '../generators/service_generator.js';
+import { generateModel } from '../generators/model_generator.js';
+import { generateModule } from '../generators/module_generator.js';
+
+/**
+ * 添加组件
+ */
+export async function addComponent (type, name, options) {
+  // 处理 --list 参数
+  if (options.list || (type === '--list')) {
+    await printSupportedTypes();
+    return;
+  }
+
+  if (!type || !name) {
+    logger.error('请指定类型和名称');
+    await printSupportedTypes();
+    return;
+  }
+
+  logger.title(`📝 添加 ${type}: ${name}`);
+
+  try {
+    // 处理别名
+    const typeMap = {
+      'p': 'page',
+      'w': 'widget',
+      'c': 'component',
+      'v': 'viewmodel',
+      'vm': 'viewmodel',
+      's': 'service',
+      'm': 'model',
+      'mod': 'module'
+    };
+
+    const normalizedType = typeMap[type.toLowerCase()] || type.toLowerCase();
+
+    switch (normalizedType) {
+      case 'page':
+        await addPage(name, options);
+        break;
+
+      case 'widget':
+        await addWidget(name, options);
+        break;
+
+      case 'component':
+        await addComponentItem(name, options);
+        break;
+
+      case 'viewmodel':
+        await addViewModel(name, options);
+        break;
+
+      case 'service':
+        await addService(name, options);
+        break;
+
+      case 'model':
+        await addModel(name, options);
+        break;
+
+      case 'module':
+        await addModule(name, options);
+        break;
+
+      default:
+        logger.error(`未知的类型: ${type}`);
+        logger.info('支持的类型: page (p), widget (w), component (c), vm (v), service (s), model (m), module (mod)');
+        return;
+    }
+
+  } catch (error) {
+    logger.error(`生成失败: ${error.message}`);
+  }
+}
+
+/**
+ * 添加页面
+ */
+async function addPage (name, options) {
+  const {
+    feature = null,
+    stateful = false,
+    stateless = false,
+    noVm = false,
+    listPage = false
+  } = options;
+
+  logger.info(`生成页面: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+
+  if (listPage) {
+    logger.info(`类型: 列表页 (BaseListPage)`);
+  } else if (stateless) {
+    logger.info(`强制类型: StatelessWidget`);
+  } else if (stateful) {
+    logger.info(`类型: StatefulWidget`);
+  }
+  if (noVm) {
+    logger.info(`不生成 ViewModel`);
+  }
+
+  const success = generatePage(name, {
+    feature,
+    stateful,
+    stateless,
+    withViewModel: !noVm,
+    isListPage: listPage,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ 页面生成完成！');
+    logger.newLine();
+
+    logger.info('下一步:');
+    if (feature) {
+      console.log(`  1. 在 lib/features/${feature}/pages/${name}_page.dart 中实现页面逻辑`);
+      if (!noVm) {
+        console.log(`  2. 在 lib/features/${feature}/viewmodels/${name}_viewmodel.dart 中实现业务逻辑`);
+      }
+    } else {
+      console.log(`  1. 在 lib/pages/${name}_page.dart 中实现页面逻辑`);
+      if (!noVm) {
+        console.log(`  2. 在 lib/viewmodels/${name}_viewmodel.dart 中实现业务逻辑`);
+      }
+    }
+    console.log(`  ${noVm ? 2 : 3}. 在路由中注册新页面`);
+  }
+}
+
+/**
+ * 添加 Widget
+ */
+async function addWidget (name, options) {
+  const {
+    feature = null,
+    stateful = false
+  } = options;
+
+  logger.info(`生成 Widget: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+  if (stateful) {
+    logger.info(`类型: StatefulWidget`);
+  }
+
+  const success = generateWidget(name, {
+    feature,
+    stateful,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ Widget 生成完成！');
+  }
+}
+
+/**
+ * 添加 Component
+ */
+async function addComponentItem (name, options) {
+  const {
+    feature = null
+  } = options;
+
+  logger.info(`生成 Component: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+
+  const success = generateComponent(name, {
+    feature,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ Component 生成完成！');
+  }
+}
+
+/**
+ * 添加 ViewModel
+ */
+async function addViewModel (name, options) {
+  const {
+    feature = null
+  } = options;
+
+  logger.info(`生成 ViewModel: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+
+  const success = generateViewModel(name, {
+    feature,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ ViewModel 生成完成！');
+  }
+}
+
+/**
+ * 添加 Service
+ */
+async function addService (name, options) {
+  const {
+    feature = null,
+    type = 'api'
+  } = options;
+
+  logger.info(`生成 Service: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+  logger.info(`类型: ${type}`);
+
+  const success = generateService(name, {
+    feature,
+    type,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ Service 生成完成！');
+    logger.newLine();
+
+    if (type === 'api') {
+      logger.info('提示: 记得在 pubspec.yaml 中添加 http 依赖');
+      console.log('  dependencies:');
+      console.log('    http: ^1.1.0');
+    } else if (type === 'storage' || type === 'auth') {
+      logger.info('提示: 记得在 pubspec.yaml 中添加 shared_preferences 依赖');
+      console.log('  dependencies:');
+      console.log('    shared_preferences: ^2.2.0');
+    }
+  }
+}
+
+/**
+ * 添加 Model
+ */
+async function addModel (name, options) {
+  const {
+    feature = null,
+    json = null
+  } = options;
+
+  logger.info(`生成 Model: ${name}`);
+  if (feature) {
+    logger.info(`功能模块: ${feature}`);
+  }
+  if (json) {
+    logger.info(`从 JSON 文件生成: ${json}`);
+  }
+
+  const success = generateModel(name, {
+    feature,
+    jsonFile: json,
+    outputDir: process.cwd()
+  });
+
+  if (success) {
+    logger.newLine();
+    logger.success('✅ Model 生成完成！');
+  }
+}
+
+/**
+ * 添加模块
+ */
+async function addModule (name, options) {
+  logger.info(`生成模块: ${name}`);
+
+  const success = generateModule(name, {
+    outputDir: process.cwd()
+  });
+
+  if (!success) {
+    logger.error('模块创建失败');
+  }
+}
+
+/**
+ * 打印支持的类型列表
+ */
+async function printSupportedTypes () {
+  const chalk = (await import('chalk')).default;
+
+  console.log(chalk.bold.cyan('\n📦 flu-cli add - 代码生成工具\n'));
+  console.log(chalk.gray('用于快速生成 Flutter 项目中的各种代码组件\n'));
+
+  // 基本用法
+  console.log(chalk.bold.yellow('📖 基本用法:'));
+  console.log(chalk.white('  flu-cli add <type> <name> [options]\n'));
+
+  // 支持的类型
+  console.log(chalk.bold.yellow('🎯 支持的组件类型:\n'));
+
+  const types = [
+    {
+      name: 'page',
+      emoji: '📄',
+      desc: '页面组件',
+      detail: '生成完整的页面文件 (Page + ViewModel)',
+      options: [
+        '-f, --feature <name>  指定功能模块',
+        '--stateful            创建 StatefulWidget',
+        '--stateless           强制创建 StatelessWidget',
+        '--list-page           创建列表页 (BaseListPage)',
+        '--no-vm               不生成 ViewModel'
+      ],
+      examples: [
+        'flu-cli add page home',
+        'flu-cli add page login --feature auth',
+        'flu-cli add page profile --stateful --no-vm'
+      ]
+    },
+    {
+      name: 'widget',
+      emoji: '🧩',
+      desc: '通用组件',
+      detail: '生成可复用的 Widget 组件',
+      options: [
+        '-f, --feature <name>  指定功能模块',
+        '--stateful            创建 StatefulWidget'
+      ],
+      examples: [
+        'flu-cli add widget custom_button',
+        'flu-cli add widget user_avatar --stateful'
+      ]
+    },
+    {
+      name: 'component',
+      emoji: '🔧',
+      desc: '业务组件',
+      detail: '生成特定业务场景的组件',
+      options: [
+        '-f, --feature <name>  指定功能模块'
+      ],
+      examples: [
+        'flu-cli add component product_card',
+        'flu-cli add component order_item --feature shop'
+      ]
+    },
+    {
+      name: 'vm / viewmodel',
+      emoji: '🎮',
+      desc: '视图模型',
+      detail: '生成独立的 ViewModel 文件',
+      options: [
+        '-f, --feature <name>  指定功能模块'
+      ],
+      examples: [
+        'flu-cli add vm settings',
+        'flu-cli add viewmodel user --feature auth'
+      ]
+    },
+    {
+      name: 'service',
+      emoji: '⚙️',
+      desc: '服务层',
+      detail: '生成 API、存储、认证等服务',
+      options: [
+        '-f, --feature <name>  指定功能模块',
+        '--type <type>         服务类型: api, storage, auth (默认: api)'
+      ],
+      examples: [
+        'flu-cli add service user --type api',
+        'flu-cli add service cache --type storage',
+        'flu-cli add service auth --type auth --feature user'
+      ]
+    },
+    {
+      name: 'model',
+      emoji: '📊',
+      desc: '数据模型',
+      detail: '生成数据模型类',
+      options: [
+        '-f, --feature <name>  指定功能模块',
+        '--json <file>         从 JSON 文件生成'
+      ],
+      examples: [
+        'flu-cli add model user',
+        'flu-cli add model product --json ./data/product.json'
+      ]
+    },
+    {
+      name: 'module',
+      emoji: '📦',
+      desc: '完整模块',
+      detail: '生成包含多个文件的完整功能模块',
+      options: [],
+      examples: [
+        'flu-cli add module shop',
+        'flu-cli add module user_profile'
+      ]
+    }
+  ];
+
+  types.forEach((t, index) => {
+    // 类型名称和描述
+    console.log(chalk.bold.green(`  ${t.emoji} ${t.name}`));
+    console.log(chalk.gray(`     ${t.detail}`));
+
+    // 可用选项
+    if (t.options.length > 0) {
+      console.log(chalk.cyan('     选项:'));
+      t.options.forEach(opt => {
+        console.log(chalk.gray(`       ${opt}`));
+      });
+    }
+
+    // 使用示例
+    if (t.examples.length > 0) {
+      console.log(chalk.cyan('     示例:'));
+      t.examples.forEach(ex => {
+        console.log(chalk.white(`       ${ex}`));
+      });
+    }
+
+    // 添加分隔线（最后一项除外）
+    if (index < types.length - 1) {
+      console.log('');
+    }
+  });
+
+  // 通用选项
+  console.log(chalk.bold.yellow('\n⚡ 通用选项:\n'));
+  console.log(chalk.white('  --list                查看此帮助信息'));
+  console.log(chalk.white('  -f, --feature <name>  指定功能模块（modular/clean 架构）\n'));
+
+  // 快速开始
+  console.log(chalk.bold.yellow('🚀 快速开始:\n'));
+  console.log(chalk.white('  # 查看所有支持的类型'));
+  console.log(chalk.gray('  flu-cli add --list\n'));
+  console.log(chalk.white('  # 创建一个简单页面'));
+  console.log(chalk.gray('  flu-cli add page home\n'));
+  console.log(chalk.white('  # 创建带功能模块的页面'));
+  console.log(chalk.gray('  flu-cli add page login --feature auth\n'));
+  console.log(chalk.white('  # 创建一个 API 服务'));
+  console.log(chalk.gray('  flu-cli add service user --type api\n'));
+
+  // 提示信息
+  console.log(chalk.bold.cyan('💡 提示:\n'));
+  console.log(chalk.gray('  • 支持简写: p(page), w(widget), c(component), v(vm), s(service), m(model)'));
+  console.log(chalk.gray('  • 使用 -f 或 --feature 可将组件生成到指定功能模块下'));
+  console.log(chalk.gray('  • page 类型默认会同时生成 ViewModel，使用 --no-vm 可禁用'));
+  console.log(chalk.gray('  • 更多帮助请运行: flu-cli add --help\n'));
+}
+

package/lib/commands/cache.js

@@ -0,0 +1,99 @@
+/**
+ * 缓存管理命令
+ * 更新和清理模板缓存
+ */
+
+import { logger } from '../utils/logger.js';
+import { getAllTemplates } from '../../config/templates.js';
+import { cloneOrUpdateTemplate, getTemplateCachePath, checkTemplateUpdate } from '../templates/templateManager.js';
+import fsExtra from 'fs-extra';
+import ora from 'ora';
+
+const { removeSync, existsSync } = fsExtra;
+
+/**
+ * 更新模板缓存
+ */
+export async function updateTemplates (templateName, options = {}) {
+  logger.title('🔄 更新模板缓存');
+
+  if (templateName) {
+    // 更新指定模板
+    await updateSingleTemplate(templateName, options);
+  } else {
+    // 更新所有模板
+    const templates = getAllTemplates();
+
+    for (const template of templates) {
+      await updateSingleTemplate(template.name.toLowerCase(), options);
+    }
+  }
+
+  logger.newLine();
+  logger.success('模板更新完成');
+}
+
+/**
+ * 更新单个模板
+ */
+async function updateSingleTemplate (templateName, options = {}) {
+  const templates = getAllTemplates();
+  const template = templates.find(t => t.name.toLowerCase() === templateName);
+
+  if (!template) {
+    logger.error(`模板 "${templateName}" 不存在`);
+    return;
+  }
+
+  logger.info(`检查模板 ${template.displayName}...`);
+
+  const updateInfo = await checkTemplateUpdate(templateName);
+
+  // 更新模板
+  const spinner = ora(`更新 ${template.displayName}...`).start();
+
+  const result = await cloneOrUpdateTemplate(
+    templateName,
+    template.repo,
+    template.branch,
+    true
+  );
+
+  if (result) {
+    spinner.succeed(`${template.displayName} 更新成功`);
+  } else {
+    spinner.fail(`${template.displayName} 更新失败`);
+  }
+}
+
+/**
+ * 清理缓存
+ */
+export async function cleanCache () {
+  logger.title('🗑️  清理模板缓存');
+
+  const templates = getAllTemplates();
+  let cleaned = 0;
+
+  for (const template of templates) {
+    const templateName = template.name.toLowerCase();
+    const cachePath = getTemplateCachePath(templateName);
+
+    if (existsSync(cachePath)) {
+      try {
+        removeSync(cachePath);
+        logger.success(`已清理: ${template.displayName}`);
+        cleaned++;
+      } catch (error) {
+        logger.error(`清理失败: ${template.displayName} - ${error.message}`);
+      }
+    }
+  }
+
+  logger.newLine();
+  if (cleaned > 0) {
+    logger.success(`已清理 ${cleaned} 个模板缓存`);
+  } else {
+    logger.info('没有需要清理的缓存');
+  }
+}

package/lib/commands/completion.js

@@ -0,0 +1,94 @@
+import chalk from 'chalk';
+
+/**
+ * 生成 Shell 自动补全脚本
+ */
+export function completion () {
+  const script = `
+###-begin-flu-cli-completion-###
+#
+# flu-cli command completion script
+#
+# Installation: flu-cli completion >> ~/.zshrc  (or ~/.bashrc)
+#
+
+if type compdef &>/dev/null; then
+  _flu_cli_completion() {
+    local -a commands
+    commands=(
+      'new:创建新 Flutter 项目'
+      'n:创建新 Flutter 项目 (new 别名)'
+      'add:添加组件 (page, widget, etc.)'
+      'a:添加组件 (add 别名)'
+      'templates:管理模板'
+      't:管理模板 (templates 别名)'
+      'generate-sm:生成状态管理代码'
+      'g:生成状态管理代码 (generate-sm 别名)'
+      'update-templates:更新模板缓存'
+      'u:更新模板缓存 (update-templates 别名)'
+      'cache:管理缓存'
+      'c:管理缓存 (cache 别名)'
+      'sync-snippets:同步标准代码片段'
+      'sync:同步标准代码片段 (sync-snippets 别名)'
+      'completion:生成自动补全脚本'
+      'comp:生成自动补全脚本 (completion 别名)'
+      'help:显示帮助信息'
+    )
+    
+    local -a add_types
+    add_types=(
+      'page:页面组件'
+      'widget:通用组件'
+      'component:业务组件'
+      'viewmodel:ViewModel'
+      'service:服务层 (Service)'
+      'model:数据模型 (Model)'
+      'module:完整功能模块'
+      'p:页面 (page 别名)'
+      'w:组件 (widget 别名)'
+      'c:业务组件 (component 别名)'
+      'v:ViewModel (vm 别名)'
+      's:服务 (service 别名)'
+      'm:模型 (model 别名)'
+      'mod:模块 (module 别名)'
+    )
+
+    _arguments -C \\
+      '1: :->command' \\
+      '*:: :->args'
+
+    case $state in
+      (command)
+        _describe -t commands 'flu-cli commands' commands
+        ;;
+      (args)
+        case $line[1] in
+          (add|a)
+            _describe -t add_types 'component types' add_types
+            ;;
+          (new|n)
+            _arguments \\
+              '--template[模板类型]:template:(lite modular clean)' \\
+              '--state[状态管理器]:state:(default provider getx riverpod)' \\
+              '--dir[目标目录]:dir:_files -/' \\
+              '--no-cache[禁用缓存]' \\
+              '--remote[使用远程模板]'
+            ;;
+          *)
+            ;;
+        esac
+        ;;
+    esac
+  }
+  
+  compdef _flu_cli_completion flu-cli
+fi
+
+###-end-flu-cli-completion-###
+`;
+
+  console.log(script);
+  console.error(chalk.green('✅ 补全脚本已生成'));
+  console.error(chalk.gray('请将其添加到您的 shell 配置文件中 (例如 ~/.zshrc 或 ~/.bashrc)'));
+  console.error(chalk.gray('用法: flu-cli completion >> ~/.zshrc && source ~/.zshrc'));
+}

package/lib/commands/generate.js

@@ -0,0 +1,26 @@
+// generate-sm 命令：为现有项目生成/切换状态管理器（依赖注入、入口与路由增强、适配器/变体生成）
+import chalk from 'chalk'
+import { existsSync } from 'fs'
+import { StateManagerGenerator } from '../generators/state_manager_generator.js'
+import { ProjectGenerator } from '../generators/project_generator.js'
+
+const SUPPORTED = ['default', 'provider', 'getx', 'riverpod']
+
+export async function generateStateManager (type, options) {
+  try {
+    const state = SUPPORTED.includes(type) ? type : 'default'
+    const projectPath = options.dir || process.cwd()
+    if (!existsSync(projectPath)) {
+      console.log(chalk.red(`目录不存在: ${projectPath}`))
+      process.exit(1)
+    }
+    const pg = new ProjectGenerator()
+    await pg.processTemplates(projectPath)
+    const sm = new StateManagerGenerator(projectPath, state, { module: options.module })
+    await sm.generate()
+    console.log(chalk.green('生成完成'))
+  } catch (e) {
+    console.log(chalk.red(`生成失败: ${e.message}`))
+    process.exit(1)
+  }
+}