flu-cli 0.0.5 → 2.0.1

package/lib/commands/completion.js

@@ -0,0 +1,92 @@
+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 别名)'
+      '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/config.js

@@ -0,0 +1,70 @@
+/**
+ * config 命令
+ * 职责：初始化和管理项目配置文件
+ */
+
+import { ProjectConfigManager, detectProjectTemplate } from '@flu-cli/core';
+import { writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+
+/**
+ * 初始化配置文件
+ */
+export function initConfig (options) {
+  try {
+    const projectDir = options.dir || process.cwd();
+    const configPath = join(projectDir, '.flu-cli.json');
+
+    if (existsSync(configPath) && !options.force) {
+      console.log(chalk.yellow('⚠️  配置文件已存在 (.flu-cli.json)'));
+      console.log(chalk.gray('使用 --force 覆盖'));
+      return;
+    }
+
+    // 检测当前项目模板，生成对应的默认配置
+    const template = detectProjectTemplate(projectDir) || 'custom';
+    let config = ProjectConfigManager.getDefaultConfigTemplate(template);
+
+    // Smart Init: 现实检查，防止默认配置依赖的 BasePage/BaseViewModel 在项目中不存在
+    try {
+      const pageConfig = config.generators && config.generators.page;
+      if (pageConfig && pageConfig.withBasePage) {
+        const possiblePaths = [
+          join(projectDir, 'lib/base/base_page.dart'),
+          join(projectDir, 'lib/core/base/base_page.dart'),
+          join(projectDir, 'lib/core/presentation/base/base_page.dart')
+        ];
+
+        if (pageConfig.basePageImport && pageConfig.basePageImport.startsWith('lib/')) {
+          possiblePaths.unshift(join(projectDir, pageConfig.basePageImport));
+        }
+
+        const basePageExists = possiblePaths.some(p => existsSync(p));
+
+        if (!basePageExists) {
+          console.log(chalk.yellow('Smart Init: 未检测到 BasePage 文件，降级为原生模式 (Native Mode)'));
+          if (config.generators && config.generators.page) {
+            config.generators.page.withBasePage = false;
+            config.generators.page.withViewModel = false;
+          }
+          if (config.generators && config.generators.viewModel) {
+            config.generators.viewModel.withBaseViewModel = false;
+          }
+        }
+      }
+    } catch (e) {
+      console.log(chalk.gray(`Smart Init 检查失败: ${e.message || e}`));
+    }
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf8');
+
+    console.log(chalk.green(`✓ 配置文件已生成: ${configPath}`));
+    console.log(chalk.cyan(`ℹ️  基于检测到的模板类型: ${template}`));
+    console.log(chalk.gray('你可以编辑 .flu-cli.json 来自定义生成规则'));
+
+  } catch (error) {
+    console.error(chalk.red(`初始化配置失败: ${error.message}`));
+    process.exit(1);
+  }
+}

package/lib/commands/newClack.js

@@ -0,0 +1,399 @@
+/**
+ * new 命令（简化版）
+ * 职责：交互创建 Flutter 项目、选择模板与状态管理器，并触发生成器落地
+ * 说明：保留平台与包名，模板文件覆盖通用代码；支持内置/自定义模板与缓存开关
+ */
+
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+import { getTemplate, isValidTemplate, getAllTemplates } from '../../config/templates.js';
+import { selectTemplateWithEnquirer } from '../utils/templateSelectorEnquirer.js';
+import { cloneOrUpdateTemplate } from '../templates/templateManager.js';
+import { getAuthorName, saveAuthorName, saveDefaultTemplate } from '../utils/config.js';
+import { ConfigManager } from '@flu-cli/core';
+import { copyTemplate, replaceVariables, copyCustomTemplate, ensurePubspecName, mergePubspecFromTemplate, cleanupTemplateFiles } from '../templates/templateCopier.js';
+import { runFlutterCreate } from '../utils/flutterHelper.js';
+import { ProjectGenerator } from '../generators/project_generator.js';
+import { syncSnippets } from './snippets.js';
+
+/**
+ * 创建新项目
+ */
+export async function newProjectWithClack (projectName, options) {
+  p.intro(chalk.cyan.bold('🚀 创建 Flutter 项目'));
+
+  try {
+    const isInteractive = !projectName;
+    let finalProjectName = projectName;
+    let templateSelection = null;
+    let stateManager = options.state || 'default';
+    const nonInteractive = process.env.FLU_CLI_NON_INTERACTIVE === '1';
+
+    // ========== 交互式模式 ==========
+    if (isInteractive) {
+      // Step 1: 项目名称
+      finalProjectName = await p.text({
+        message: '请输入项目名称（直接回车使用: my_app）',
+        placeholder: 'my_app'
+      });
+
+      if (p.isCancel(finalProjectName)) {
+        p.cancel('操作已取消');
+        process.exit(0);
+      }
+
+      if (!finalProjectName || finalProjectName === '') {
+        finalProjectName = 'my_app';
+      }
+
+      // Step 2: 选择模板（实时预览，支持内置/自定义）
+      templateSelection = await selectTemplateWithEnquirer();
+
+      // Step 2.5: 选择状态管理器
+      const smChoice = await p.select({
+        message: '请选择状态管理器',
+        options: [
+          { value: 'default', label: 'ChangeNotifier (默认)' },
+          { value: 'provider', label: 'Provider' },
+          { value: 'getx', label: 'GetX' },
+          { value: 'riverpod', label: 'Riverpod' }
+        ],
+        initialValue: 'default'
+      });
+      if (!p.isCancel(smChoice)) {
+        stateManager = smChoice;
+      }
+
+      // Step 3: 项目路径（含冲突检测与删除确认）
+      const defaultPath = join(options.dir, finalProjectName);
+      let projectPath = await p.text({
+        message: `请输入项目路径（直接回车使用: ${defaultPath}）`,
+        placeholder: defaultPath
+      });
+
+      if (p.isCancel(projectPath)) {
+        p.cancel('操作已取消');
+        process.exit(0);
+      }
+
+      if (!projectPath || projectPath === '') {
+        projectPath = defaultPath;
+      }
+
+      // Step 4: 包名
+      const defaultPackageName = `com.example.${finalProjectName}`;
+      let packageName = await p.text({
+        message: `请输入包名（直接回车使用: ${defaultPackageName}）`,
+        placeholder: defaultPackageName
+      });
+
+      if (p.isCancel(packageName)) {
+        p.cancel('操作已取消');
+        process.exit(0);
+      }
+
+      if (!packageName || packageName === '') {
+        packageName = defaultPackageName;
+      }
+
+      // Step 5: 作者（使用缓存的名字）
+      const cachedAuthor = getAuthorName();
+      let author = await p.text({
+        message: `请输入作者名称（直接回车使用: ${cachedAuthor}）`,
+        placeholder: cachedAuthor
+      });
+
+      if (p.isCancel(author)) {
+        p.cancel('操作已取消');
+        process.exit(0);
+      }
+
+      if (!author || author === '') {
+        author = cachedAuthor;
+      } else {
+        // 保存新的作者名字
+        saveAuthorName(author);
+      }
+
+      // Step 6: 检查目录是否存在（交互确认删除）
+      if (existsSync(projectPath)) {
+        console.log('');
+        console.log(chalk.yellow(`⚠️  目录已存在: ${projectPath}`));
+
+        const shouldDelete = await p.confirm({
+          message: '是否删除现有目录并重新创建?',
+          initialValue: true
+        });
+
+        if (p.isCancel(shouldDelete)) {
+          p.cancel('操作已取消');
+          process.exit(0);
+        }
+
+        if (shouldDelete) {
+          const { rmSync } = await import('fs');
+          try {
+            rmSync(projectPath, { recursive: true, force: true });
+            console.log(chalk.green(`✓ 已删除目录: ${projectPath}`));
+          } catch (error) {
+            p.cancel(`删除目录失败: ${error.message}`);
+            process.exit(1);
+          }
+        } else {
+          p.cancel('操作已取消');
+          process.exit(0);
+        }
+      }
+
+      // Step 7: 显示信息并确认
+      const templateDisplay = templateSelection?.kind === 'builtin'
+        ? getTemplate(templateSelection.name).displayName
+        : (ConfigManager.getInstance().getTemplate(templateSelection.id)?.name || '自定义模板');
+
+      console.log('');
+      console.log(chalk.cyan('📋 项目信息确认:'));
+      console.log('');
+      console.log(`  ${chalk.gray('项目名称:')} ${chalk.green(finalProjectName)}`);
+      console.log(`  ${chalk.gray('项目模板:')} ${chalk.green(templateDisplay)}`);
+      console.log(`  ${chalk.gray('项目路径:')} ${chalk.green(projectPath)}`);
+      console.log(`  ${chalk.gray('包名:')} ${chalk.green(packageName)}`);
+      console.log(`  ${chalk.gray('作者:')} ${chalk.green(author)}`);
+      console.log('');
+
+      const shouldContinue = await p.confirm({
+        message: '确认创建项目?'
+      });
+
+      if (!shouldContinue || p.isCancel(shouldContinue)) {
+        p.cancel('操作已取消');
+        process.exit(0);
+      }
+
+      // Step 8: 创建项目
+      await createProject(finalProjectName, templateSelection, projectPath, { projectName: finalProjectName, packageName, author, stateManager }, options);
+
+    } else {
+      // ========== 命令行模式 ==========
+      if (!isValidProjectName(finalProjectName)) {
+        p.cancel('项目名称只能包含小写字母、数字和下划线');
+        process.exit(1);
+      }
+
+      // 如果通过参数传入模板名称，构造为内置模板选择
+      if (!templateSelection && options.template) {
+        templateSelection = { kind: 'builtin', name: options.template };
+      }
+      if (!templateSelection) {
+        templateSelection = await selectTemplateWithEnquirer();
+      }
+      if (templateSelection.kind === 'builtin' && !isValidTemplate(templateSelection.name)) {
+        p.cancel(`模板 "${templateSelection.name}" 不存在`);
+        process.exit(1);
+      }
+
+      const projectDir = join(options.dir, finalProjectName);
+
+      // 检查目录是否存在（命令行模式也提供删除确认）
+      if (existsSync(projectDir)) {
+        if (nonInteractive) {
+          const { rmSync } = await import('fs');
+          rmSync(projectDir, { recursive: true, force: true });
+        } else {
+          console.log('');
+          console.log(chalk.yellow(`⚠️  目录已存在: ${projectDir}`));
+          const shouldDelete = await p.confirm({ message: '是否删除现有目录并重新创建?', initialValue: true });
+          if (p.isCancel(shouldDelete)) {
+            p.cancel('操作已取消');
+            process.exit(0);
+          }
+          if (shouldDelete) {
+            const { rmSync } = await import('fs');
+            try {
+              rmSync(projectDir, { recursive: true, force: true });
+              console.log(chalk.green(`✓ 已删除目录: ${projectDir}`));
+            } catch (error) {
+              p.cancel(`删除目录失败: ${error.message}`);
+              process.exit(1);
+            }
+          } else {
+            p.cancel('操作已取消');
+            process.exit(0);
+          }
+        }
+      }
+
+      const defaultPackageName = `com.example.${finalProjectName}`;
+      let packageName = defaultPackageName;
+      if (!nonInteractive) {
+        packageName = await p.text({ message: `请输入包名（直接回车使用: ${defaultPackageName}）`, placeholder: defaultPackageName });
+        if (p.isCancel(packageName)) {
+          p.cancel('操作已取消');
+          process.exit(0);
+        }
+        if (!packageName || packageName === '') {
+          packageName = defaultPackageName;
+        }
+      }
+
+      let author = 'Your Name';
+      if (!nonInteractive) {
+        author = await p.text({ message: '请输入作者名称（直接回车使用: Your Name）', placeholder: 'Your Name' });
+        if (p.isCancel(author)) {
+          p.cancel('操作已取消');
+          process.exit(0);
+        }
+        if (!author || author === '') {
+          author = 'Your Name';
+        }
+      }
+
+      // CLI 模式支持 --state 传参
+      await createProject(finalProjectName, templateSelection, projectDir, { projectName: finalProjectName, packageName, author, stateManager }, options);
+    }
+  } catch (error) {
+    p.cancel(`创建失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * 创建项目
+ */
+async function createProject (projectName, templateSelection, projectDir, projectInfo, options) {
+  const s = p.spinner();
+
+  try {
+    // 1. 准备模板
+    s.start('正在准备模板...');
+    let templatePath;
+    if (templateSelection?.kind === 'builtin') {
+      const template = getTemplate(templateSelection.name);
+      // 根据运行环境决定是否使用本地模板
+      // 生产环境（production）默认走远程，其他环境默认走本地（除非显式使用 --remote）
+      const runMode = process.env.FLU_CLI_MODE || process.env.NODE_ENV || 'development';
+      const useLocal = !options.remote && runMode !== 'production' && (template.local || false);
+      const __here = dirname(fileURLToPath(import.meta.url));
+      const cliRoot = dirname(dirname(__here)); // flu-cli/flu-cli
+      const workspaceRoot = dirname(cliRoot);
+      const sourceLocalPath = join(workspaceRoot, `template-${templateSelection.name}`);
+      const forceUpdate = useLocal ? true : !options.cache;
+      templatePath = await cloneOrUpdateTemplate(
+        templateSelection.name,
+        template.repo,
+        template.branch,
+        forceUpdate,
+        useLocal,
+        sourceLocalPath
+      );
+    } else if (templateSelection?.kind === 'custom') {
+      const configManager = ConfigManager.getInstance();
+      const ct = configManager.getTemplate(templateSelection.id);
+
+      if (!ct) {
+        s.stop('模板准备失败');
+        throw new Error('未找到自定义模板');
+      }
+      if (ct.type === 'local') {
+        templatePath = await cloneOrUpdateTemplate(
+          ct.id,
+          null,
+          'main',
+          !options.cache,
+          true,
+          ct.path || ct.url // 兼容旧配置
+        );
+      } else {
+        templatePath = await cloneOrUpdateTemplate(
+          ct.id,
+          ct.url,
+          ct.branch || 'main',
+          !options.cache,
+          false
+        );
+      }
+    } else {
+      throw new Error('模板选择无效');
+    }
+
+    if (!templatePath) {
+      s.stop('模板准备失败');
+      throw new Error('模板准备失败');
+    }
+    s.stop('✓ 模板准备完成');
+
+    // 2. 创建 Flutter 项目
+    s.start('正在创建 Flutter 项目...');
+    const created = await runFlutterCreate(projectDir, projectInfo.projectName, projectInfo.packageName);
+    if (created) {
+      s.stop('✓ Flutter 项目创建成功');
+    } else {
+      s.stop('Flutter 项目创建失败');
+    }
+
+    // 3. 复制模板文件（自定义模板仅覆盖通用代码，保留平台与包名）
+    s.start('正在复制模板文件...');
+    const isCustom = templateSelection?.kind === 'custom';
+    const copied = isCustom
+      ? await copyCustomTemplate(templatePath, projectDir)
+      : await copyTemplate(templatePath, projectDir);
+
+    if (!copied) {
+      s.stop('模板文件复制失败');
+      throw new Error('模板文件复制失败');
+    }
+    s.stop('✓ 模板文件复制成功');
+
+    // 4. 配置项目
+    s.start('正在配置项目...');
+    const pg = new ProjectGenerator();
+    await pg.processTemplates(projectDir);
+    await replaceVariables(projectDir, projectInfo);
+    if (isCustom) {
+      mergePubspecFromTemplate(templatePath, projectDir, projectInfo.projectName);
+    } else {
+      ensurePubspecName(projectDir, projectInfo.projectName);
+    }
+    // 配置状态管理器
+    await pg.configureStateManager(projectDir, projectInfo.stateManager || 'default');
+
+    // 同步标准代码片段
+    s.start('正在同步代码片段...');
+    await syncSnippets(projectDir);
+    s.stop('✓ 代码片段同步完成');
+
+    cleanupTemplateFiles(projectDir);
+    s.stop('✓ 项目配置完成');
+
+    // 完成
+    p.outro(
+      chalk.green.bold('✨ 项目创建成功！\n\n') +
+      chalk.cyan('下一步:\n') +
+      chalk.yellow(`  cd ${projectName}\n`) +
+      chalk.yellow(`  flutter pub get\n`) +
+      chalk.yellow(`  flutter run`)
+    );
+
+    // 记忆默认模板
+    if (templateSelection?.kind === 'builtin') {
+      saveDefaultTemplate({ type: 'builtin', idOrName: templateSelection.name });
+    } else if (templateSelection?.kind === 'custom') {
+      saveDefaultTemplate({ type: 'custom', idOrName: templateSelection.id });
+    }
+
+    // 正常退出
+    process.exit(0);
+  } catch (error) {
+    s.stop('创建失败');
+    throw error;
+  }
+}
+
+/**
+ * 验证项目名称
+ */
+function isValidProjectName (name) {
+  return /^[a-z][a-z0-9_]*$/.test(name);
+}

package/lib/commands/snippets.js

@@ -0,0 +1,39 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * 同步代码片段到当前项目
+ */
+export async function syncSnippets (targetDir) {
+  const projectRoot = targetDir || process.cwd();
+  const vscodeDir = path.join(projectRoot, '.vscode');
+  const targetFile = path.join(vscodeDir, 'dart.code-snippets');
+
+  // 获取 centralized snippets 路径
+  // 假设结构: packages/v2/lib/commands/snippets.js -> packages/v2/templates/snippets/dart.code-snippets
+  const snippetsSource = path.join(__dirname, '../../templates/snippets/dart.code-snippets');
+
+  if (!fs.existsSync(snippetsSource)) {
+    console.log(chalk.red('❌ 错误: 找不到标准代码片段源文件'));
+    return;
+  }
+
+  try {
+    // 确保 .vscode 目录存在
+    await fs.ensureDir(vscodeDir);
+
+    // 复制文件
+    await fs.copy(snippetsSource, targetFile, { overwrite: true });
+
+    console.log(chalk.green('✅ 代码片段同步成功！'));
+    console.log(chalk.gray(`已更新: ${targetFile}`));
+    console.log(chalk.cyan('提示: 重启 VS Code 或运行 "Developer: Reload Window" 以应用更改'));
+
+  } catch (error) {
+    console.log(chalk.red(`❌ 同步失败: ${error.message}`));
+  }
+}