flu-cli 0.0.5 → 2.0.1

package/lib/commands/template.js

@@ -0,0 +1,113 @@
+import chalk from 'chalk';
+import { ConfigManager } from '@flu-cli/core';
+import { getAllTemplates } from '../../config/templates.js';
+import { logger } from '../utils/logger.js';
+import { existsSync } from 'fs';
+import { getTemplateCachePath } from '../templates/templateManager.js';
+import { format } from 'date-fns'; // 需要检查是否已安装 date-fns，如果没有可以用原生 Date
+
+/**
+ * 格式化日期
+ */
+function formatDate (timestamp) {
+  if (!timestamp) return '从未';
+  return new Date(timestamp).toLocaleString('zh-CN');
+}
+
+/**
+ * 列出所有模板（内置 + 自定义）
+ */
+export function listAllTemplates () {
+  logger.title('📦 可用的项目模板');
+
+  // 1. 内置模板
+  console.log(chalk.bold.cyan('📌 内置模板'));
+  const builtinTemplates = getAllTemplates();
+  builtinTemplates.forEach((template) => {
+    const cachePath = getTemplateCachePath(template.name);
+    const isCached = existsSync(cachePath);
+    const status = isCached ? chalk.green('已缓存') : chalk.gray('未缓存');
+
+    console.log(chalk.bold(`  • ${template.name} (${template.displayName})`) + ` [${status}]`);
+    console.log(chalk.gray(`    ${template.description}`));
+  });
+
+  // 2. 自定义模板
+  const configManager = ConfigManager.getInstance();
+  const customTemplates = configManager.getTemplates();
+
+  if (customTemplates.length > 0) {
+    logger.newLine();
+    console.log(chalk.bold.cyan('🔧 自定义模板'));
+    customTemplates.forEach((template) => {
+      const source = template.type === 'git' ? template.url : template.path;
+      let status = '';
+      let updateInfo = '';
+
+      if (template.type === 'git') {
+        const cachePath = getTemplateCachePath(template.id);
+        const isCached = existsSync(cachePath);
+        status = isCached ? chalk.green('已缓存') : chalk.gray('未缓存');
+        if (template.lastUsedAt) {
+          updateInfo = chalk.gray(` (上次使用: ${formatDate(template.lastUsedAt)})`);
+        }
+      } else {
+        status = chalk.blue('本地链接');
+      }
+
+      console.log(chalk.bold(`  • ${template.id} (${template.name})`) + ` [${status}]` + updateInfo);
+      console.log(chalk.gray(`    ${template.description || '无描述'}`));
+      console.log(chalk.gray(`    来源: [${template.type}] ${source}`));
+      if (template.branch) {
+        console.log(chalk.gray(`    分支: ${template.branch}`));
+      }
+    });
+  } else {
+    logger.newLine();
+    console.log(chalk.gray('  (暂无自定义模板)'));
+  }
+
+  logger.newLine();
+  logger.info('使用 "flu template add" 添加自定义模板');
+  logger.info('使用 "flu new <name> -t <template>" 创建项目');
+}
+
+/**
+ * 添加自定义模板
+ */
+export function addTemplate (name, source, options) {
+  const configManager = ConfigManager.getInstance();
+  const existing = configManager.getTemplate(name);
+
+  if (existing && !options.force) {
+    logger.error(`模板 "${name}" 已存在`);
+    logger.info('使用 --force 覆盖，或使用 "flu template remove" 删除');
+    return;
+  }
+
+  const isLocal = options.local;
+  const template = {
+    id: name,
+    name: options.name || name,
+    type: isLocal ? 'local' : 'git',
+    description: options.description || '自定义模板',
+    ...(isLocal ? { path: source } : { url: source, branch: options.branch || 'main' })
+  };
+
+  configManager.addTemplate(template);
+  logger.success(`✅ 模板 "${name}" 添加成功`);
+}
+
+/**
+ * 删除自定义模板
+ */
+export function removeTemplate (name) {
+  const configManager = ConfigManager.getInstance();
+  const success = configManager.removeTemplate(name);
+
+  if (success) {
+    logger.success(`🗑️ 模板 "${name}" 已删除`);
+  } else {
+    logger.error(`模板 "${name}" 不存在`);
+  }
+}

package/lib/commands/templates.js

@@ -0,0 +1,84 @@
+/**
+ * 模板查看命令
+ * 显示所有模板或指定模板的详细信息
+ */
+
+import chalk from 'chalk';
+import { getAllTemplates, getTemplate, isValidTemplate } from '../../config/templates.js';
+import { logger } from '../utils/logger.js';
+
+/**
+ * 列出所有模板
+ */
+export function listTemplates () {
+  logger.title('📦 可用的项目模板');
+
+  const templates = getAllTemplates();
+
+  templates.forEach((template, index) => {
+    console.log(chalk.bold(`${index + 1}. ${template.displayName}`));
+    console.log(chalk.gray(`   ${template.description}`));
+    console.log(chalk.gray(`   复杂度: ${'⭐'.repeat(template.complexity)}${'☆'.repeat(5 - template.complexity)}`));
+    console.log(chalk.gray(`   团队规模: ${template.teamSize}`));
+    console.log(chalk.gray(`   代码量: ${template.codeSize}`));
+    logger.newLine();
+  });
+
+  logger.info('使用 "flu-cli templates <name>" 查看详细信息');
+  logger.info('使用 "flu-cli new <project-name> -t <template>" 创建项目');
+
+  logger.newLine();
+  console.log(chalk.gray('示例:'));
+  console.log(chalk.yellow('  flu-cli templates lite'));
+  console.log(chalk.yellow('  flu-cli new my_app -t modular'));
+}
+
+/**
+ * 显示模板详情
+ */
+export function showTemplateDetail (templateName) {
+  if (!isValidTemplate(templateName)) {
+    logger.error(`模板 "${templateName}" 不存在`);
+    logger.info('使用 "flu-cli templates" 查看所有可用模板');
+    return;
+  }
+
+  const template = getTemplate(templateName);
+
+  // 显示模板信息框
+  console.log(chalk.bold.cyan('\n┌─────────────────────────────────────────────────────────────┐'));
+  console.log(chalk.bold.cyan(`│ 📦 ${template.displayName.padEnd(56)} │`));
+  console.log(chalk.bold.cyan('├─────────────────────────────────────────────────────────────┤'));
+
+  // 基本信息
+  console.log(chalk.cyan('│ ') + chalk.gray('描述: ') + template.description.padEnd(50) + chalk.cyan(' │'));
+  console.log(chalk.cyan('│ ') + chalk.gray('复杂度: ') + ('⭐'.repeat(template.complexity) + '☆'.repeat(5 - template.complexity)).padEnd(50) + chalk.cyan(' │'));
+  console.log(chalk.cyan('│ ') + chalk.gray('团队规模: ') + template.teamSize.padEnd(48) + chalk.cyan(' │'));
+  console.log(chalk.cyan('│ ') + chalk.gray('代码量: ') + template.codeSize.padEnd(50) + chalk.cyan(' │'));
+
+  console.log(chalk.bold.cyan('├─────────────────────────────────────────────────────────────┤'));
+  console.log(chalk.bold.cyan('│ 特性:                                                        │'));
+  console.log(chalk.cyan('│                                                              │'));
+
+  template.features.forEach(feature => {
+    console.log(chalk.cyan('│ ') + feature.padEnd(60) + chalk.cyan(' │'));
+  });
+
+  console.log(chalk.bold.cyan('├─────────────────────────────────────────────────────────────┤'));
+  console.log(chalk.bold.cyan('│ 项目结构:                                                    │'));
+  console.log(chalk.cyan('│                                                              │'));
+
+  // 显示项目结构
+  const structureLines = template.structure.trim().split('\n');
+  structureLines.forEach(line => {
+    const paddedLine = line.padEnd(60);
+    console.log(chalk.cyan('│ ') + paddedLine + chalk.cyan(' │'));
+  });
+
+  console.log(chalk.bold.cyan('└─────────────────────────────────────────────────────────────┘'));
+
+  logger.newLine();
+  logger.info('创建项目:');
+  console.log(chalk.yellow(`  flu-cli new my_app -t ${templateName}`));
+  logger.newLine();
+}

package/lib/generators/model_generator.js

@@ -0,0 +1,303 @@
+/**
+ * Model 生成器
+ */
+
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../utils/logger.js';
+import { toPascalCase, toSnakeCase, toCamelCase } from '../utils/string_helper.js';
+import { updateIndexFile } from '../utils/index_updater.js';
+import { getSnippetContent } from '../utils/snippet_loader.js';
+
+/**
+ * 生成 Model 文件
+ */
+export function generateModel (name, options = {}) {
+  try {
+    const {
+      feature = null,
+      jsonFile = null,
+      outputDir = process.cwd()
+    } = options;
+
+    // 转换命名
+    const namePascal = toPascalCase(name);
+    const nameSnake = toSnakeCase(name);
+
+    // 确定输出路径
+    let modelsDir;
+    if (feature) {
+      // Modular/Clean 架构
+      modelsDir = join(outputDir, 'lib', 'features', feature, 'models');
+    } else {
+      // Lite 架构
+      modelsDir = join(outputDir, 'lib', 'models');
+    }
+
+    // 创建目录
+    if (!existsSync(modelsDir)) {
+      mkdirSync(modelsDir, { recursive: true });
+    }
+
+    // 生成文件内容
+    let content;
+    if (jsonFile && existsSync(jsonFile)) {
+      // 从 JSON 文件生成
+      const jsonContent = readFileSync(jsonFile, 'utf8');
+      const jsonData = JSON.parse(jsonContent);
+      content = generateModelFromJson(namePascal, jsonData);
+    } else {
+      // 优先片段，其次基础模板
+      content = getSnippetContent(outputDir, 'flu.model', { Name: namePascal }) || generateBasicModel(namePascal);
+    }
+
+    // 写入文件
+    const filePath = join(modelsDir, `${nameSnake}_model.dart`);
+    if (existsSync(filePath)) {
+      logger.error(`文件已存在: ${filePath}`);
+      return false;
+    }
+
+    writeFileSync(filePath, content, 'utf8');
+    logger.success(`Model 创建成功: ${filePath}`);
+
+    // 更新 index.dart
+    updateIndexFile(modelsDir, `${nameSnake}_model.dart`);
+
+    return true;
+
+  } catch (error) {
+    logger.error(`生成 Model 失败: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * 生成基础 Model
+ */
+function generateBasicModel (namePascal) {
+  return `class ${namePascal}Model {
+  final String id;
+  final String name;
+  final DateTime createdAt;
+
+  ${namePascal}Model({
+    required this.id,
+    required this.name,
+    required this.createdAt,
+  });
+
+  // 从 JSON 创建
+  factory ${namePascal}Model.fromJson(Map<String, dynamic> json) {
+    return ${namePascal}Model(
+      id: json['id'] as String,
+      name: json['name'] as String,
+      createdAt: DateTime.parse(json['created_at'] as String),
+    );
+  }
+
+  // 转换为 JSON
+  Map<String, dynamic> toJson() {
+    return {
+      'id': id,
+      'name': name,
+      'created_at': createdAt.toIso8601String(),
+    };
+  }
+
+  // 复制并修改
+  ${namePascal}Model copyWith({
+    String? id,
+    String? name,
+    DateTime? createdAt,
+  }) {
+    return ${namePascal}Model(
+      id: id ?? this.id,
+      name: name ?? this.name,
+      createdAt: createdAt ?? this.createdAt,
+    );
+  }
+
+  @override
+  String toString() {
+    return '${namePascal}Model(id: $id, name: $name, createdAt: $createdAt)';
+  }
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    return other is ${namePascal}Model &&
+        other.id == id &&
+        other.name == name &&
+        other.createdAt == createdAt;
+  }
+
+  @override
+  int get hashCode {
+    return id.hashCode ^ name.hashCode ^ createdAt.hashCode;
+  }
+}
+`;
+}
+
+/**
+ * 从 JSON 生成 Model
+ */
+function generateModelFromJson (namePascal, jsonData) {
+  const fields = analyzeJsonStructure(jsonData);
+
+  // 生成字段声明
+  const fieldDeclarations = fields.map(f => `  final ${f.type} ${f.name};`).join('\n');
+
+  // 生成构造函数参数
+  const constructorParams = fields.map(f => `    required this.${f.name},`).join('\n');
+
+  // 生成 fromJson 字段
+  const fromJsonFields = fields.map(f => {
+    if (f.type === 'String') {
+      return `      ${f.name}: json['${f.jsonKey}'] as String,`;
+    } else if (f.type === 'int') {
+      return `      ${f.name}: json['${f.jsonKey}'] as int,`;
+    } else if (f.type === 'double') {
+      return `      ${f.name}: (json['${f.jsonKey}'] as num).toDouble(),`;
+    } else if (f.type === 'bool') {
+      return `      ${f.name}: json['${f.jsonKey}'] as bool,`;
+    } else if (f.type === 'DateTime') {
+      return `      ${f.name}: DateTime.parse(json['${f.jsonKey}'] as String),`;
+    } else if (f.type.startsWith('List<')) {
+      return `      ${f.name}: (json['${f.jsonKey}'] as List).cast<${f.type.slice(5, -1)}>(),`;
+    } else {
+      return `      ${f.name}: json['${f.jsonKey}'],`;
+    }
+  }).join('\n');
+
+  // 生成 toJson 字段
+  const toJsonFields = fields.map(f => {
+    if (f.type === 'DateTime') {
+      return `      '${f.jsonKey}': ${f.name}.toIso8601String(),`;
+    } else {
+      return `      '${f.jsonKey}': ${f.name},`;
+    }
+  }).join('\n');
+
+  // 生成 copyWith 参数
+  const copyWithParams = fields.map(f => `    ${f.type}? ${f.name},`).join('\n');
+  const copyWithFields = fields.map(f => `      ${f.name}: ${f.name} ?? this.${f.name},`).join('\n');
+
+  // 生成 toString
+  const toStringFields = fields.map(f => `${f.name}: $${f.name}`).join(', ');
+
+  // 生成 == 比较
+  const equalityChecks = fields.map(f => `        other.${f.name} == ${f.name}`).join(' &&\n');
+
+  // 生成 hashCode
+  const hashCodeFields = fields.map(f => `${f.name}.hashCode`).join(' ^ ');
+
+  return `class ${namePascal}Model {
+${fieldDeclarations}
+
+  ${namePascal}Model({
+${constructorParams}
+  });
+
+  // 从 JSON 创建
+  factory ${namePascal}Model.fromJson(Map<String, dynamic> json) {
+    return ${namePascal}Model(
+${fromJsonFields}
+    );
+  }
+
+  // 转换为 JSON
+  Map<String, dynamic> toJson() {
+    return {
+${toJsonFields}
+    };
+  }
+
+  // 复制并修改
+  ${namePascal}Model copyWith({
+${copyWithParams}
+  }) {
+    return ${namePascal}Model(
+${copyWithFields}
+    );
+  }
+
+  @override
+  String toString() {
+    return '${namePascal}Model(${toStringFields})';
+  }
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    return other is ${namePascal}Model &&
+${equalityChecks};
+  }
+
+  @override
+  int get hashCode {
+    return ${hashCodeFields};
+  }
+}
+`;
+}
+
+/**
+ * 分析 JSON 结构
+ */
+function analyzeJsonStructure (jsonData) {
+  const fields = [];
+
+  for (const [key, value] of Object.entries(jsonData)) {
+    const camelKey = toCamelCase(key);
+    const type = inferDartType(value);
+
+    fields.push({
+      name: camelKey,
+      jsonKey: key,
+      type: type
+    });
+  }
+
+  return fields;
+}
+
+/**
+ * 推断 Dart 类型
+ */
+function inferDartType (value) {
+  if (value === null) return 'dynamic';
+
+  const type = typeof value;
+
+  if (type === 'string') {
+    // 尝试判断是否是日期
+    if (/^\d{4}-\d{2}-\d{2}/.test(value)) {
+      return 'DateTime';
+    }
+    return 'String';
+  }
+
+  if (type === 'number') {
+    return Number.isInteger(value) ? 'int' : 'double';
+  }
+
+  if (type === 'boolean') {
+    return 'bool';
+  }
+
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return 'List<dynamic>';
+    }
+    const itemType = inferDartType(value[0]);
+    return `List<${itemType}>`;
+  }
+
+  if (type === 'object') {
+    return 'Map<String, dynamic>';
+  }
+
+  return 'dynamic';
+}