flu-cli 0.0.4 → 2.0.0

package/lib/utils/index_updater.js

@@ -0,0 +1,69 @@
+/**
+ * index.dart 更新工具
+ * 自动更新目录的 index.dart 导出文件
+ */
+
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { logger } from './logger.js';
+
+/**
+ * 更新 index.dart 文件
+ * @param {string} dirPath - 目录路径
+ * @param {string} fileName - 要添加的文件名
+ */
+export function updateIndexFile (dirPath, fileName) {
+  try {
+    const indexPath = join(dirPath, 'index.dart');
+
+    // 如果 index.dart 不存在,不做处理
+    if (!existsSync(indexPath)) {
+      return false;
+    }
+
+    // 读取现有内容
+    let content = readFileSync(indexPath, 'utf8');
+
+    // 检查是否已经导出
+    const exportStatement = `export '${fileName}';`;
+    if (content.includes(exportStatement)) {
+      return false; // 已经存在,不需要更新
+    }
+
+    // 找到注释行后添加导出语句
+    const lines = content.split('\n');
+    let insertIndex = -1;
+
+    // 找到第一个注释行之后的位置
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].trim().startsWith('//')) {
+        insertIndex = i + 1;
+        break;
+      }
+    }
+
+    // 如果没找到注释,添加到末尾
+    if (insertIndex === -1) {
+      insertIndex = lines.length;
+    }
+
+    // 跳过空行
+    while (insertIndex < lines.length && lines[insertIndex].trim() === '') {
+      insertIndex++;
+    }
+
+    // 插入导出语句
+    lines.splice(insertIndex, 0, exportStatement);
+
+    // 写回文件
+    content = lines.join('\n');
+    writeFileSync(indexPath, content, 'utf8');
+
+    logger.info(`已更新 index.dart: ${exportStatement}`);
+    return true;
+
+  } catch (error) {
+    logger.warn(`更新 index.dart 失败: ${error.message}`);
+    return false;
+  }
+}

package/lib/utils/logger.js

@@ -0,0 +1,57 @@
+/**
+ * 日志工具
+ * 统一的日志输出格式
+ */
+
+import chalk from 'chalk';
+
+export const logger = {
+  /**
+   * 成功信息
+   */
+  success (message) {
+    console.log(chalk.green('✅ ' + message));
+  },
+
+  /**
+   * 错误信息
+   */
+  error (message) {
+    console.log(chalk.red('❌ ' + message));
+  },
+
+  /**
+   * 警告信息
+   */
+  warn (message) {
+    console.log(chalk.yellow('⚠️  ' + message));
+  },
+
+  /**
+   * 信息
+   */
+  info (message) {
+    console.log(chalk.blue('ℹ️  ' + message));
+  },
+
+  /**
+   * 标题
+   */
+  title (message) {
+    console.log(chalk.bold.cyan('\n' + message + '\n'));
+  },
+
+  /**
+   * 分隔线
+   */
+  divider () {
+    console.log(chalk.gray('─'.repeat(60)));
+  },
+
+  /**
+   * 空行
+   */
+  newLine () {
+    console.log('');
+  }
+};

package/lib/utils/project_detector.js

@@ -0,0 +1,227 @@
+/**
+ * 项目类型检测工具
+ * 职责：基于目录结构识别 lite/modular/clean 模板，并提供生成路径解析
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * 检测项目模板类型
+ * @param {string} projectDir - 项目目录
+ * @returns {'lite'|'modular'|'clean'|null} 模板类型
+ */
+export function detectProjectTemplate (projectDir = process.cwd()) {
+  try {
+    const libDir = join(projectDir, 'lib');
+
+    if (!existsSync(libDir)) {
+      return null;
+    }
+
+    // 检测 Clean 架构特征
+    // Clean 架构有 features/xxx/data, features/xxx/domain, features/xxx/presentation
+    const featuresDir = join(libDir, 'features');
+    if (existsSync(featuresDir)) {
+      // 检查是否有 data/domain/presentation 三层结构
+      const coreDir = join(libDir, 'core');
+      const hasUsecases = existsSync(join(coreDir, 'usecases'));
+      const hasErrors = existsSync(join(coreDir, 'errors'));
+
+      if (hasUsecases && hasErrors) {
+        return 'clean';
+      }
+
+      // 检测 Modular 架构特征
+      // Modular 架构有 core/base, core/router, shared
+      const hasBase = existsSync(join(coreDir, 'base'));
+      const hasRouter = existsSync(join(coreDir, 'router'));
+      const sharedDir = existsSync(join(libDir, 'shared'));
+
+      if (hasBase && hasRouter && sharedDir) {
+        return 'modular';
+      }
+    }
+
+    // 检测 Lite 架构特征
+    // Lite 架构有 pages, viewmodels, widgets 等扁平目录
+    const pagesDir = join(libDir, 'pages');
+    const viewmodelsDir = join(libDir, 'viewmodels');
+    const widgetsDir = join(libDir, 'widgets');
+
+    if (existsSync(pagesDir) && existsSync(viewmodelsDir) && existsSync(widgetsDir)) {
+      return 'lite';
+    }
+
+    return null;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * 获取页面生成路径
+ * @param {string} projectDir - 项目目录
+ * @param {string} moduleName - 模块名称
+ * @returns {string} 页面目录路径
+ */
+export function getPagePath (projectDir, moduleName) {
+  const template = detectProjectTemplate(projectDir);
+
+  switch (template) {
+    case 'lite':
+      return join(projectDir, 'lib', 'pages');
+
+    case 'modular':
+      return join(projectDir, 'lib', 'features', moduleName, 'pages');
+
+    case 'clean':
+      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'pages');
+
+    default:
+      return join(projectDir, 'lib', 'pages');
+  }
+}
+
+/**
+ * 获取 ViewModel 生成路径
+ * @param {string} projectDir - 项目目录
+ * @param {string} moduleName - 模块名称
+ * @returns {string} ViewModel 目录路径
+ */
+export function getViewModelPath (projectDir, moduleName) {
+  const template = detectProjectTemplate(projectDir);
+
+  switch (template) {
+    case 'lite':
+      return join(projectDir, 'lib', 'viewmodels');
+
+    case 'modular':
+      return join(projectDir, 'lib', 'features', moduleName, 'viewmodels');
+
+    case 'clean':
+      return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'viewmodels');
+
+    default:
+      return join(projectDir, 'lib', 'viewmodels');
+  }
+}
+
+/**
+ * 获取 Widget 生成路径
+ * @param {string} projectDir - 项目目录
+ * @param {string} moduleName - 模块名称（可选）
+ * @returns {string} Widget 目录路径
+ */
+export function getWidgetPath (projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir);
+
+  switch (template) {
+    case 'lite':
+      return join(projectDir, 'lib', 'widgets');
+
+    case 'modular':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'widgets');
+      }
+      return join(projectDir, 'lib', 'shared', 'widgets');
+
+    case 'clean':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'presentation', 'widgets');
+      }
+      return join(projectDir, 'lib', 'shared', 'widgets');
+
+    default:
+      return join(projectDir, 'lib', 'widgets');
+  }
+}
+
+/**
+ * 获取 Service 生成路径
+ * @param {string} projectDir - 项目目录
+ * @param {string} moduleName - 模块名称（可选）
+ * @returns {string} Service 目录路径
+ */
+export function getServicePath (projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir);
+
+  switch (template) {
+    case 'lite':
+      return join(projectDir, 'lib', 'services');
+
+    case 'modular':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'services');
+      }
+      return join(projectDir, 'lib', 'shared', 'services');
+
+    case 'clean':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'data', 'datasources');
+      }
+      return join(projectDir, 'lib', 'core', 'network');
+
+    default:
+      return join(projectDir, 'lib', 'services');
+  }
+}
+
+/**
+ * 获取 Model 生成路径
+ * @param {string} projectDir - 项目目录
+ * @param {string} moduleName - 模块名称（可选）
+ * @returns {string} Model 目录路径
+ */
+export function getModelPath (projectDir, moduleName = null) {
+  const template = detectProjectTemplate(projectDir);
+
+  switch (template) {
+    case 'lite':
+      return join(projectDir, 'lib', 'models');
+
+    case 'modular':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'models');
+      }
+      return join(projectDir, 'lib', 'shared', 'models');
+
+    case 'clean':
+      if (moduleName) {
+        return join(projectDir, 'lib', 'features', moduleName, 'data', 'models');
+      }
+      return join(projectDir, 'lib', 'shared', 'models');
+
+    default:
+      return join(projectDir, 'lib', 'models');
+  }
+}
+
+/**
+ * 获取相对导入路径
+ * @param {string} fromPath - 源文件路径
+ * @param {string} toPath - 目标文件路径
+ * @returns {string} 相对路径
+ */
+export function getRelativeImportPath (fromPath, toPath) {
+  const fromParts = fromPath.split('/');
+  const toParts = toPath.split('/');
+
+  // 找到共同的父目录
+  let commonIndex = 0;
+  while (commonIndex < fromParts.length && commonIndex < toParts.length) {
+    if (fromParts[commonIndex] !== toParts[commonIndex]) {
+      break;
+    }
+    commonIndex++;
+  }
+
+  // 计算需要返回的层级
+  const upLevels = fromParts.length - commonIndex - 1;
+  const upPath = '../'.repeat(upLevels);
+
+  // 计算目标路径
+  const targetPath = toParts.slice(commonIndex).join('/');
+
+  return upPath + targetPath;
+}

package/lib/utils/snippet_loader.js

@@ -0,0 +1,32 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import JSON5 from 'json5';
+
+// 读取项目片段文件
+export function loadProjectSnippets (projectDir) {
+  try {
+    const snippetsPath = join(projectDir, '.vscode', 'dart.code-snippets');
+    if (!existsSync(snippetsPath)) return {};
+    const raw = readFileSync(snippetsPath, 'utf8');
+    const json = JSON5.parse(raw);
+    return json || {};
+  } catch (_) {
+    return {};
+  }
+}
+
+// 渲染片段内容
+export function renderSnippet (bodyLines, variables) {
+  const body = Array.isArray(bodyLines) ? bodyLines.join('\n') : String(bodyLines || '');
+  return body.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+    return Object.prototype.hasOwnProperty.call(variables, key) ? String(variables[key]) : `{{${key}}}`;
+  });
+}
+
+// 简便方法：按 key 获取片段并渲染
+export function getSnippetContent (projectDir, key, variables) {
+  const map = loadProjectSnippets(projectDir);
+  const item = map[key];
+  if (!item || !item.body) return null;
+  return renderSnippet(item.body, variables);
+}

package/lib/utils/string_helper.js

@@ -0,0 +1,56 @@
+/**
+ * 字符串工具函数
+ */
+
+/**
+ * 转换为 PascalCase
+ * home_page -> HomePage
+ */
+export function toPascalCase (str) {
+  return str
+    .split(/[-_\s]+/)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('');
+}
+
+/**
+ * 转换为 snake_case
+ * HomePage -> home_page
+ */
+export function toSnakeCase (str) {
+  return str
+    .replace(/([A-Z])/g, '_$1')
+    .toLowerCase()
+    .replace(/^_/, '');
+}
+
+/**
+ * 转换为 camelCase
+ * home_page -> homePage
+ */
+export function toCamelCase (str) {
+  const pascal = toPascalCase(str);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+
+/**
+ * 转换为 Title Case
+ * home_page -> Home Page
+ */
+export function toTitleCase (str) {
+  return str
+    .split(/[-_\s]+/)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(' ');
+}
+
+/**
+ * 转换为 kebab-case
+ * HomePage -> home-page
+ */
+export function toKebabCase (str) {
+  return str
+    .replace(/([A-Z])/g, '-$1')
+    .toLowerCase()
+    .replace(/^-/, '');
+}

package/lib/utils/templateSelectorEnquirer.js

@@ -0,0 +1,200 @@
+/**
+ * 使用 Enquirer 实现实时模板预览
+ * 当用户上下切换时，实时显示对应模板的结构
+ */
+
+import enquirer from 'enquirer';
+import chalk from 'chalk';
+import { existsSync } from 'fs';
+import { basename } from 'path';
+import { getAllTemplates } from '../../config/templates.js';
+import { getDefaultTemplate, getCustomTemplates, addOrUpdateCustomTemplate, saveDefaultTemplate } from '../utils/config.js';
+
+const { Select } = enquirer;
+
+/**
+ * 选择模板（带实时预览 - Enquirer 版本）
+ */
+export async function selectTemplateWithEnquirer () {
+  const templates = getAllTemplates();
+  const customTemplates = getCustomTemplates();
+  const defaultTpl = getDefaultTemplate();
+
+  // 创建自定义的 Select prompt
+  class TemplateSelect extends Select {
+    async render () {
+      const { submitted, size } = this.state;
+      const index = this.index;
+      // 选择项与模板索引可能不一致，安全获取
+      const choice = this.choices[index];
+      const isBuiltin = choice?.name?.startsWith('builtin:');
+      const builtinIndex = isBuiltin ? templates.findIndex(t => `builtin:${t.name.toLowerCase()}` === choice.name) : -1;
+      const template = isBuiltin && builtinIndex >= 0 ? templates[builtinIndex] : null;
+
+      let prompt = '';
+      let header = await this.header();
+      let prefix = await this.prefix();
+      let separator = await this.separator();
+      let message = await this.message();
+
+      if (this.options.promptLine !== false) {
+        prompt = [prefix, message, separator].filter(Boolean).join(' ');
+        this.state.prompt = prompt;
+      }
+
+      let output = prompt + '\n\n';
+
+      // 显示选项列表
+      for (let i = 0; i < this.choices.length; i++) {
+        const choice = this.choices[i];
+        const isSelected = i === index;
+        const prefix = isSelected ? chalk.cyan('❯') : ' ';
+        const style = isSelected ? chalk.cyan : chalk.gray;
+        output += `${prefix} ${style(choice.message)}\n`;
+        if (choice.hint) {
+          output += `  ${chalk.gray(choice.hint)}\n`;
+        }
+      }
+
+      // 显示当前模板的结构预览（仅内置模板）
+      output += '\n' + chalk.cyan('─'.repeat(70)) + '\n';
+      if (template) {
+        output += chalk.yellow('📁 项目结构预览:\n\n');
+        const structureLines = template.structure.trim().split('\n');
+        structureLines.forEach(line => {
+          output += chalk.gray(line) + '\n';
+        });
+        output += '\n';
+        output += chalk.cyan('✨ 特性: ') + chalk.gray(template.features.join(', ')) + '\n';
+        output += chalk.cyan('📊 适用: ') + chalk.gray(`${template.teamSize}, ${template.codeSize}`) + '\n';
+      } else {
+        output += chalk.yellow('自定义模板：不提供结构预览') + '\n';
+      }
+      output += chalk.cyan('─'.repeat(70));
+
+      this.clear(size);
+      this.write(output);
+    }
+  }
+
+  // 构建选择项：内置模板 + 自定义模板 + 新增自定义入口
+  const builtinChoices = templates.map(t => ({
+    name: `builtin:${t.name.toLowerCase()}`,
+    message: `${t.displayName}`
+  }));
+  const customChoices = customTemplates.map(ct => ({
+    name: `custom:${ct.id}`,
+    message: `自定义：${ct.name}`,
+    hint: ct.type === 'git' ? ct.pathOrUrl : `本地: ${ct.pathOrUrl}`
+  }));
+  const addCustomChoice = { name: '__add_custom__', message: chalk.yellow('➕ 新增自定义模板（本地或 Git）') };
+
+  const allChoices = [...builtinChoices, ...customChoices, addCustomChoice];
+
+  // 计算默认选中索引
+  let initialIndex = 0;
+  if (defaultTpl && defaultTpl.type === 'builtin') {
+    const idx = allChoices.findIndex(c => c.name === `builtin:${defaultTpl.idOrName}`);
+    if (idx >= 0) initialIndex = idx;
+  } else if (defaultTpl && defaultTpl.type === 'custom') {
+    const idx = allChoices.findIndex(c => c.name === `custom:${defaultTpl.idOrName}`);
+    if (idx >= 0) initialIndex = idx;
+  }
+
+  const prompt = new TemplateSelect({
+    name: 'template',
+    message: '选择项目模板（使用 ↑↓ 键切换，实时查看结构）',
+    choices: allChoices,
+    initial: initialIndex
+  });
+
+  try {
+    const answer = await prompt.run();
+
+    // 清除屏幕上的大量输出，只保留简洁的确认信息
+    console.clear();
+
+    // 显示选中确认
+    if (answer === '__add_custom__') {
+      // 选择来源类型
+      const typePrompt = new enquirer.Select({
+        name: 'sourceType',
+        message: '选择自定义模板来源',
+        choices: [
+          { name: 'local', message: '本地目录' },
+          { name: 'git', message: 'Git 仓库' }
+        ]
+      });
+      const sourceType = await typePrompt.run();
+
+      // 输入路径或 URL
+      const inputPrompt = new enquirer.Input({
+        name: 'pathOrUrl',
+        message: sourceType === 'git' ? '请输入 Git 仓库地址（如 https://... 或 git@...）' : '请输入本地模板目录绝对路径'
+      });
+      const pathOrUrl = await inputPrompt.run();
+
+      // 分支（Git）
+      let branch = 'main';
+      if (sourceType === 'git') {
+        const branchPrompt = new enquirer.Input({
+          name: 'branch',
+          message: '请输入分支名称（默认 main）',
+          initial: 'main'
+        });
+        branch = await branchPrompt.run();
+        if (!branch) branch = 'main';
+      }
+
+      // 基本校验
+      if (sourceType === 'local' && !existsSync(pathOrUrl)) {
+        console.log(chalk.red('本地目录不存在：'), pathOrUrl);
+        process.exit(1);
+      }
+
+      // 生成 id 与名称
+      const nameGuess = sourceType === 'git'
+        ? (pathOrUrl.split('/').pop() || 'custom')
+        : basename(pathOrUrl);
+      const id = `${nameGuess.replace(/\W+/g, '-').toLowerCase()}-${Date.now()}`;
+
+      const saved = addOrUpdateCustomTemplate({
+        id,
+        name: nameGuess,
+        type: sourceType,
+        pathOrUrl,
+        branch
+      });
+
+      console.log(chalk.green('✓ 已保存自定义模板:'), chalk.cyan.bold(saved.name));
+      saveDefaultTemplate({ type: 'custom', idOrName: saved.id });
+      return { kind: 'custom', id: saved.id };
+    }
+
+    if (answer.startsWith('builtin:')) {
+      const name = answer.split(':')[1];
+      const selectedTemplate = templates.find(t => t.name.toLowerCase() === name);
+      console.log(chalk.green('✓ 已选择:'), chalk.cyan.bold(selectedTemplate.displayName));
+      saveDefaultTemplate({ type: 'builtin', idOrName: name });
+      return { kind: 'builtin', name };
+    }
+
+    if (answer.startsWith('custom:')) {
+      const id = answer.split(':')[1];
+      const ct = customTemplates.find(t => t.id === id);
+      console.log(chalk.green('✓ 已选择自定义:'), chalk.cyan.bold(ct?.name || id));
+      saveDefaultTemplate({ type: 'custom', idOrName: id });
+      return { kind: 'custom', id };
+    }
+
+    // 兜底（保持兼容）
+    const name = answer;
+    saveDefaultTemplate({ type: 'builtin', idOrName: name });
+    const selectedTemplate = templates.find(t => t.name.toLowerCase() === name);
+    console.log(chalk.green('✓ 已选择:'), chalk.cyan.bold(selectedTemplate?.displayName || name));
+    return { kind: 'builtin', name };
+  } catch (error) {
+    console.log(chalk.yellow('\n操作已取消'));
+    process.exit(0);
+  }
+}