flu-cli 2.0.0 → 2.0.2

package/index.js

@@ -16,7 +16,7 @@ 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';
+// generate-sm 命令已移除
 
 // 获取 package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -68,7 +68,6 @@ program
   .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) => {
@@ -88,15 +87,7 @@ program
     }
   });
 
-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);
-  });
+// generate-sm 命令已移除
 
 // ========== 缓存管理命令 ==========
 program
@@ -133,6 +124,43 @@ program
     syncSnippets();
   });
 
+// ========== 模板管理命令 (New) ==========
+import { listAllTemplates, addTemplate, removeTemplate } from './lib/commands/template.js';
+
+const templateCmd = program.command('template');
+
+templateCmd
+  .description('管理自定义项目模板')
+  .action(() => {
+    listAllTemplates();
+  });
+
+templateCmd
+  .command('list')
+  .description('列出所有模板')
+  .action(() => {
+    listAllTemplates();
+  });
+
+templateCmd
+  .command('add <id> <source>')
+  .description('添加自定义模板 (id: 唯一标识, source: Git URL 或本地路径)')
+  .option('--local', '添加本地模板 (source 为路径)')
+  .option('-n, --name <name>', '显示名称')
+  .option('-b, --branch <branch>', 'Git 分支 (默认 main)')
+  .option('-d, --description <text>', '描述信息')
+  .option('-f, --force', '覆盖已存在的模板')
+  .action((id, source, options) => {
+    addTemplate(id, source, options);
+  });
+
+templateCmd
+  .command('remove <id>')
+  .description('删除自定义模板')
+  .action((id) => {
+    removeTemplate(id);
+  });
+
 // ========== 自动补全 ==========
 import { completion } from './lib/commands/completion.js';
 
@@ -145,11 +173,32 @@ program
   });
 
 
+// ========== 配置管理命令 ==========
+import { initConfig } from './lib/commands/config.js';
+
+const configCmd = program.command('config');
+
+configCmd
+  .description('管理项目生成配置 (.flu-cli.json)')
+  .action(() => {
+    configCmd.help();
+  });
+
+configCmd
+  .command('init')
+  .description('初始化配置文件 (基于当前项目结构)')
+  .option('-d, --dir <path>', '项目目录', process.cwd())
+  .option('-f, --force', '覆盖已存在的配置文件')
+  .action((options) => {
+    initConfig(options);
+  });
+
+
 // 解析命令行参数
 program.parse(process.argv);
 
 // 如果没有提供命令，显示帮助信息
 if (process.argv.length === 2) {
   console.log(chalk.bold.cyan('\n🚀 欢迎使用 flu-cli v2.0\n'));
-  program.help();
+  program.help({ error: false });
 }

package/lib/commands/add.js

@@ -3,14 +3,18 @@
  * 生成页面、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';
+import {
+  ConsoleLogger,
+  generatePage,
+  generateWidget,
+  generateViewModel,
+  generateService,
+  generateModel,
+  generateComponent,
+  generateModule
+} from '@flu-cli/core';
+
+const logger = new ConsoleLogger();
 
 /**
  * 添加组件
@@ -45,6 +49,11 @@ export async function addComponent (type, name, options) {
 
     const normalizedType = typeMap[type.toLowerCase()] || type.toLowerCase();
 
+    // 自动推断 feature (如果未指定)
+    if (!options.feature) {
+      options.feature = inferFeatureFromCwd();
+    }
+
     switch (normalizedType) {
       case 'page':
         await addPage(name, options);
@@ -102,25 +111,65 @@ async function addPage (name, options) {
     logger.info(`功能模块: ${feature}`);
   }
 
-  if (listPage) {
+  // 交互式选择页面类型 (如果未指定任何标志)
+  let finalStateful = stateful;
+  let finalStateless = stateless;
+  let finalNoVm = noVm;
+  let finalListPage = listPage;
+
+  if (!stateful && !stateless && !listPage) {
+    try {
+      const inquirer = (await import('inquirer')).default;
+      const { pageType } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'pageType',
+          message: '请选择页面类型:',
+          choices: [
+            { name: 'Stateful(BasePage) + ViewModel (推荐)', value: 'default' },
+            { name: 'Stateful (no ViewModel)', value: 'stateful_no_vm' },
+            { name: 'Stateless', value: 'stateless' },
+            { name: 'List Page (列表页)', value: 'list_page' }
+          ]
+        }
+      ]);
+
+      if (pageType === 'stateful_no_vm') {
+        finalStateful = true;
+        finalNoVm = true;
+      } else if (pageType === 'stateless') {
+        finalStateless = true;
+        finalNoVm = true; // Stateless 通常不需要 VM 绑定
+      } else if (pageType === 'list_page') {
+        finalListPage = true;
+      }
+      // default: stateful=false (use config default), stateless=false, noVm=false
+    } catch (e) {
+      if (process.stdout.isTTY) {
+        logger.warn('交互式选择已取消，使用默认配置');
+      }
+    }
+  }
+
+  if (finalListPage) {
     logger.info(`类型: 列表页 (BaseListPage)`);
-  } else if (stateless) {
+  } else if (finalStateless) {
     logger.info(`强制类型: StatelessWidget`);
-  } else if (stateful) {
+  } else if (finalStateful) {
     logger.info(`类型: StatefulWidget`);
   }
-  if (noVm) {
+  if (finalNoVm) {
     logger.info(`不生成 ViewModel`);
   }
 
   const success = generatePage(name, {
     feature,
-    stateful,
-    stateless,
-    withViewModel: !noVm,
-    isListPage: listPage,
+    stateful: finalStateful,
+    stateless: finalStateless,
+    withViewModel: !finalNoVm,
+    isListPage: finalListPage,
     outputDir: process.cwd()
-  });
+  }, logger);
 
   if (success) {
     logger.newLine();
@@ -130,16 +179,16 @@ async function addPage (name, options) {
     logger.info('下一步:');
     if (feature) {
       console.log(`  1. 在 lib/features/${feature}/pages/${name}_page.dart 中实现页面逻辑`);
-      if (!noVm) {
+      if (!finalNoVm) {
         console.log(`  2. 在 lib/features/${feature}/viewmodels/${name}_viewmodel.dart 中实现业务逻辑`);
       }
     } else {
       console.log(`  1. 在 lib/pages/${name}_page.dart 中实现页面逻辑`);
-      if (!noVm) {
+      if (!finalNoVm) {
         console.log(`  2. 在 lib/viewmodels/${name}_viewmodel.dart 中实现业务逻辑`);
       }
     }
-    console.log(`  ${noVm ? 2 : 3}. 在路由中注册新页面`);
+    console.log(`  ${finalNoVm ? 2 : 3}. 在路由中注册新页面`);
   }
 }
 
@@ -164,7 +213,7 @@ async function addWidget (name, options) {
     feature,
     stateful,
     outputDir: process.cwd()
-  });
+  }, logger);
 
   if (success) {
     logger.newLine();
@@ -187,8 +236,8 @@ async function addComponentItem (name, options) {
 
   const success = generateComponent(name, {
     feature,
-    outputDir: process.cwd()
-  });
+    outputDir: options.outputDir || process.cwd()
+  }, logger);
 
   if (success) {
     logger.newLine();
@@ -212,7 +261,7 @@ async function addViewModel (name, options) {
   const success = generateViewModel(name, {
     feature,
     outputDir: process.cwd()
-  });
+  }, logger);
 
   if (success) {
     logger.newLine();
@@ -225,36 +274,22 @@ async function addViewModel (name, options) {
  */
 async function addService (name, options) {
   const {
-    feature = null,
-    type = 'api'
+    feature = null
   } = options;
 
   logger.info(`生成 Service: ${name}`);
   if (feature) {
     logger.info(`功能模块: ${feature}`);
   }
-  logger.info(`类型: ${type}`);
 
   const success = generateService(name, {
     feature,
-    type,
     outputDir: process.cwd()
-  });
+  }, logger);
 
   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');
-    }
   }
 }
 
@@ -271,15 +306,92 @@ async function addModel (name, options) {
   if (feature) {
     logger.info(`功能模块: ${feature}`);
   }
-  if (json) {
+
+  // 交互式获取 JSON 数据
+  let jsonData = null;
+  if (!json) {
+    try {
+      const inquirer = (await import('inquirer')).default;
+      const { source } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'source',
+          message: '请选择 JSON 数据源:',
+          choices: [
+            { name: '使用默认模板', value: 'default' },
+            { name: '输入 JSON (粘贴)', value: 'input' },
+            { name: '使用编辑器输入 (推荐)', value: 'editor' },
+            { name: '选择 JSON 文件', value: 'file' }
+          ]
+        }
+      ]);
+
+      if (source === 'input') {
+        const { content } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'content',
+            message: '请输入 JSON 内容:',
+            validate: (input) => {
+              try {
+                JSON.parse(input);
+                return true;
+              } catch (e) {
+                return `JSON 格式错误: ${e.message}`;
+              }
+            }
+          }
+        ]);
+        jsonData = JSON.parse(content);
+      } else if (source === 'editor') {
+        const { content } = await inquirer.prompt([
+          {
+            type: 'editor',
+            name: 'content',
+            message: '请在编辑器中输入 JSON 内容，保存并关闭以继续',
+            default: '{\n  "example": "value"\n}',
+            validate: (input) => {
+              try {
+                JSON.parse(input);
+                return true;
+              } catch (e) {
+                return `JSON 格式错误: ${e.message}`;
+              }
+            }
+          }
+        ]);
+        jsonData = JSON.parse(content);
+      } else if (source === 'file') {
+        const { filePath } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'filePath',
+            message: '请输入 JSON 文件路径:',
+            validate: (input) => {
+              if (!input) return '路径不能为空';
+              return true;
+            }
+          }
+        ]);
+        // 这里只是更新 options.json，后续逻辑会处理
+        options.json = filePath;
+      }
+    } catch (e) {
+      // 如果交互失败（非 TTY），则忽略，使用默认行为
+      if (process.stdout.isTTY) {
+        logger.warn('交互式输入已取消，使用默认模板');
+      }
+    }
+  } else {
     logger.info(`从 JSON 文件生成: ${json}`);
   }
 
   const success = generateModel(name, {
     feature,
-    jsonFile: json,
+    jsonFile: options.json || json,
+    jsonData,
     outputDir: process.cwd()
-  });
+  }, logger);
 
   if (success) {
     logger.newLine();
@@ -294,7 +406,7 @@ async function addModule (name, options) {
   logger.info(`生成模块: ${name}`);
 
   const success = generateModule(name, {
-    outputDir: process.cwd()
+    outputDir: options.outputDir || process.cwd()
   });
 
   if (!success) {
@@ -381,25 +493,23 @@ async function printSupportedTypes () {
       name: 'service',
       emoji: '⚙️',
       desc: '服务层',
-      detail: '生成 API、存储、认证等服务',
+      detail: '生成基础 Service 文件',
       options: [
-        '-f, --feature <name>  指定功能模块',
-        '--type <type>         服务类型: api, storage, auth (默认: api)'
+        '-f, --feature <name>  指定功能模块'
       ],
       examples: [
-        'flu-cli add service user --type api',
-        'flu-cli add service cache --type storage',
-        'flu-cli add service auth --type auth --feature user'
+        'flu-cli add service user',
+        'flu-cli add service auth --feature user'
       ]
     },
     {
       name: 'model',
       emoji: '📊',
       desc: '数据模型',
-      detail: '生成数据模型类',
+      detail: '生成数据模型类 (支持交互式输入 JSON)',
       options: [
         '-f, --feature <name>  指定功能模块',
-        '--json <file>         从 JSON 文件生成'
+        '--json <file>         从 JSON 文件生成 (可选)'
       ],
       examples: [
         'flu-cli add model user',
@@ -459,8 +569,8 @@ async function printSupportedTypes () {
   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.white('  # 创建一个 Service'));
+  console.log(chalk.gray('  flu-cli add service user\n'));
 
   // 提示信息
   console.log(chalk.bold.cyan('💡 提示:\n'));
@@ -470,3 +580,16 @@ async function printSupportedTypes () {
   console.log(chalk.gray('  • 更多帮助请运行: flu-cli add --help\n'));
 }
 
+/**
+ * 从当前工作目录推断 feature 名称
+ * 规则: 如果路径包含 /features/<name>/...，则返回 <name>
+ */
+function inferFeatureFromCwd () {
+  const cwd = process.cwd();
+  const match = cwd.match(/features[\\/]([^\\/]+)/);
+  if (match && match[1]) {
+    return match[1];
+  }
+  return null;
+}
+

package/lib/commands/completion.js

@@ -22,8 +22,6 @@ if type compdef &>/dev/null; then
       'a:添加组件 (add 别名)'
       'templates:管理模板'
       't:管理模板 (templates 别名)'
-      'generate-sm:生成状态管理代码'
-      'g:生成状态管理代码 (generate-sm 别名)'
       'update-templates:更新模板缓存'
       'u:更新模板缓存 (update-templates 别名)'
       'cache:管理缓存'

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

@@ -9,10 +9,11 @@ import chalk from 'chalk';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { existsSync } from 'fs';
-import { getTemplate, isValidTemplate } from '../../config/templates.js';
+import { getTemplate, isValidTemplate, getAllTemplates } from '../../config/templates.js';
 import { selectTemplateWithEnquirer } from '../utils/templateSelectorEnquirer.js';
 import { cloneOrUpdateTemplate } from '../templates/templateManager.js';
-import { getAuthorName, saveAuthorName, findCustomTemplateById, saveDefaultTemplate } from '../utils/config.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';
@@ -150,7 +151,7 @@ export async function newProjectWithClack (projectName, options) {
       // Step 7: 显示信息并确认
       const templateDisplay = templateSelection?.kind === 'builtin'
         ? getTemplate(templateSelection.name).displayName
-        : (findCustomTemplateById(templateSelection.id)?.name || '自定义模板');
+        : (ConfigManager.getInstance().getTemplate(templateSelection.id)?.name || '自定义模板');
 
       console.log('');
       console.log(chalk.cyan('📋 项目信息确认:'));
@@ -288,7 +289,9 @@ async function createProject (projectName, templateSelection, projectDir, projec
         sourceLocalPath
       );
     } else if (templateSelection?.kind === 'custom') {
-      const ct = findCustomTemplateById(templateSelection.id);
+      const configManager = ConfigManager.getInstance();
+      const ct = configManager.getTemplate(templateSelection.id);
+
       if (!ct) {
         s.stop('模板准备失败');
         throw new Error('未找到自定义模板');
@@ -300,12 +303,12 @@ async function createProject (projectName, templateSelection, projectDir, projec
           'main',
           !options.cache,
           true,
-          ct.pathOrUrl
+          ct.path || ct.url // 兼容旧配置
         );
       } else {
         templatePath = await cloneOrUpdateTemplate(
           ct.id,
-          ct.pathOrUrl,
+          ct.url,
           ct.branch || 'main',
           !options.cache,
           false