flu-cli 0.0.4 → 2.0.0

package/package.json

@@ -1,33 +1,58 @@
 {
     "name": "flu-cli",
-    "version": "0.0.4",
-    "description": "火之夜工作室 Flutter 项目创建工具",
+    "version": "2.0.0",
+    "description": "Flutter MVVM 脚手架工具 - V2",
     "main": "index.js",
     "type": "module",
     "bin": {
         "flu-cli": "./index.js"
     },
+    "publishConfig": {
+        "tag": "latest"
+    },
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",
-        "start": "node ./index.js"
+        "start": "node ./index.js",
+        "dev": "NODE_ENV=development node ./index.js",
+        "prod": "NODE_ENV=production node ./index.js",
+        "prepublishOnly": "NODE_ENV=production"
     },
     "keywords": [
         "flutter",
         "cli",
-        "project",
+        "v2",
+        "scaffold",
+        "mvvm",
+        "template",
         "generator"
     ],
     "author": "火之夜工作室",
     "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://gitee.com/flu-cli/flu-cli.git"
+    },
+    "homepage": "http://huozhiye.cn/flu-cli",
+    "bugs": {
+        "url": "https://gitee.com/flu-cli/flu-cli/issues"
+    },
     "dependencies": {
+        "@clack/prompts": "^0.11.0",
         "chalk": "^4.1.2",
         "commander": "^11.1.0",
+        "enquirer": "^2.4.1",
         "fs-extra": "^11.2.0",
+        "handlebars": "^4.7.8",
         "inquirer": "^8.2.6",
+        "json5": "^2.2.3",
         "ora": "^5.4.1",
-        "path": "^0.12.7"
+        "simple-git": "^3.20.0"
     },
     "devDependencies": {
-        "@types/fs-extra": "^11.0.4"
+        "@types/fs-extra": "^11.0.4",
+        "@types/inquirer": "^9.0.7"
+    },
+    "engines": {
+        "node": ">=14.0.0"
     }
 }

package/release.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+
+# flu-cli v2 发布脚本
+# 自动化版本发布流程
+
+set -e  # 遇到错误立即退出
+
+echo "🚀 flu-cli v2 发布脚本"
+echo "===================="
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# 检查当前目录
+if [ ! -f "package.json" ]; then
+    echo -e "${RED}错误: 请在 packages/v2 目录下运行此脚本${NC}"
+    exit 1
+fi
+
+# 获取当前版本
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+echo -e "当前版本: ${GREEN}v${CURRENT_VERSION}${NC}"
+
+# 询问发布类型
+echo ""
+echo "请选择发布类型:"
+echo "  1) patch (bug 修复, 1.0.0 -> 1.0.1)"
+echo "  2) minor (新功能, 1.0.0 -> 1.1.0)"
+echo "  3) major (重大变更, 1.0.0 -> 2.0.0)"
+echo "  4) 跳过版本更新"
+read -p "选择 [1-4]: " version_choice
+
+case $version_choice in
+    1) VERSION_TYPE="patch" ;;
+    2) VERSION_TYPE="minor" ;;
+    3) VERSION_TYPE="major" ;;
+    4) VERSION_TYPE="" ;;
+    *)
+        echo -e "${RED}无效选择${NC}"
+        exit 1
+        ;;
+esac
+
+# 更新版本号
+if [ -n "$VERSION_TYPE" ]; then
+    echo ""
+    echo -e "${YELLOW}更新版本号...${NC}"
+    npm version $VERSION_TYPE --no-git-tag-version
+    NEW_VERSION=$(node -p "require('./package.json').version")
+    echo -e "新版本: ${GREEN}v${NEW_VERSION}${NC}"
+else
+    NEW_VERSION=$CURRENT_VERSION
+fi
+
+# 运行测试（如果有）
+echo ""
+echo -e "${YELLOW}运行测试...${NC}"
+npm test || echo -e "${YELLOW}警告: 测试未通过或未配置${NC}"
+
+# 确认发布
+echo ""
+echo -e "${YELLOW}准备发布 v${NEW_VERSION} 到 NPM${NC}"
+read -p "是否继续? (y/n): " confirm
+
+if [ "$confirm" != "y" ]; then
+    echo -e "${RED}发布已取消${NC}"
+    exit 1
+fi
+
+# 发布到 NPM
+echo ""
+echo -e "${YELLOW}发布到 NPM...${NC}"
+npm publish
+
+# 提交代码并打标签
+if [ -n "$VERSION_TYPE" ]; then
+    echo ""
+    echo -e "${YELLOW}提交代码并打标签...${NC}"
+    
+    cd ../..
+    git add .
+    git commit -m "chore: release v${NEW_VERSION}"
+    git tag "v${NEW_VERSION}"
+    
+    echo -e "${GREEN}✓ 代码已提交并打标签${NC}"
+    
+    read -p "是否推送到远程仓库? (y/n): " push_confirm
+    if [ "$push_confirm" = "y" ]; then
+        git push origin main
+        git push origin "v${NEW_VERSION}"
+        echo -e "${GREEN}✓ 已推送到远程仓库${NC}"
+    fi
+fi
+
+echo ""
+echo -e "${GREEN}===================="
+echo "✅ 发布完成!"
+echo "===================="${NC}
+echo ""
+echo "下一步:"
+echo "  1. 部署文档: cd ../../docs && ./deploy-docs.sh"
+echo "  2. 验证安装: npm install -g flu-cli@${NEW_VERSION}"
+echo "  3. 发布公告（可选）"
+echo ""

package/scripts/e2e-state-tests.js

@@ -0,0 +1,116 @@
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, readdirSync, rmSync, mkdirSync } from 'fs';
+import { join } from 'path';
+
+const demoDir = join(process.cwd(), 'demo');
+const templates = ['lite', 'modular', 'clean'];
+const states = ['default', 'provider', 'getx', 'riverpod'];
+
+function createProject (template, state) {
+  const name = `t_${template}_${state}`;
+  const cmd = `FLU_CLI_NON_INTERACTIVE=1 node index.js new ${name} -t ${template} --state ${state} -d demo`;
+  execSync(cmd, { stdio: 'inherit' });
+  return join(demoDir, name);
+}
+
+function assert (cond, msg) {
+  if (!cond) {
+    throw new Error(msg);
+  }
+}
+
+function validateProject (dir, template, state) {
+  const pubspec = readFileSync(join(dir, 'pubspec.yaml'), 'utf8');
+  const main = readFileSync(join(dir, 'lib', 'main.dart'), 'utf8');
+  const analysis = readFileSync(join(dir, 'analysis_options.yaml'), 'utf8');
+
+  // 所有模板都不应包含 flu_core
+  assert(!pubspec.includes('flu_core:'), `${template} 模板不应包含 flu_core 依赖`);
+  assert(!main.includes("import 'package:flu_core/flu_core.dart';") && !main.includes("import 'flu_core/flu_core.dart';"), `${template} 模板 main.dart 不应导入 flu_core`);
+  assert(!main.includes('StateManagerConfig.init('), `${template} 模板不应初始化 StateManagerConfig`);
+
+  // GetX 特定检查
+  if (state === 'getx') {
+    if (template === 'lite') {
+      const app = readFileSync(join(dir, 'lib', 'app.dart'), 'utf8');
+      const routes = readFileSync(join(dir, 'lib', 'config', 'routes.dart'), 'utf8');
+      assert(app.includes('GetMaterialApp('), 'GetX 入口未使用 GetMaterialApp');
+      assert(app.includes('getPages: AppRoutes.pages'), 'GetX 入口未配置 getPages');
+      assert(routes.includes('GetPage('), 'GetX 路由未生成 GetPage 列表');
+      assert(!app.includes('routes:'), 'GetX 模式入口不应保留 routes 属性');
+      assert(!/static\s+Map<\s*String,\s*WidgetBuilder\s*>\s*get\s+routes/.test(routes), 'GetX 模式不应保留 routes getter');
+    } else if (template === 'modular') {
+      const app = readFileSync(join(dir, 'lib', 'main.dart'), 'utf8');
+      const routes = readFileSync(join(dir, 'lib', 'core', 'router', 'app_router.dart'), 'utf8');
+      assert(app.includes('GetMaterialApp('), 'modular GetX 入口未使用 GetMaterialApp');
+      assert(app.includes('getPages: AppRouter.pages'), 'modular GetX 入口未配置 getPages');
+      assert(routes.includes('GetPage('), 'modular GetX 路由未生成 GetPage 列表');
+      assert(!app.includes('routes:'), 'modular GetX 入口不应保留 routes 属性');
+      assert(!/static\s+Map<\s*String,\s*WidgetBuilder\s*>\s*get\s+routes/.test(routes), 'modular GetX 路由不应保留 routes getter');
+    } else if (template === 'clean') {
+      const app = readFileSync(join(dir, 'lib', 'app.dart'), 'utf8');
+      const routes = readFileSync(join(dir, 'lib', 'config', 'routes', 'app_routes.dart'), 'utf8');
+      assert(app.includes('GetMaterialApp('), 'clean GetX 入口未使用 GetMaterialApp');
+      assert(app.includes('getPages: AppRoutes.pages'), 'clean GetX 入口未配置 getPages');
+      assert(routes.includes('GetPage('), 'clean GetX 路由未生成 GetPage 列表');
+      assert(!app.includes('routes:'), 'clean GetX 入口不应保留 routes 属性');
+      assert(!/static\s+Map<\s*String,\s*WidgetBuilder\s*>\s*get\s+routes/.test(routes), 'clean GetX 路由不应保留 routes getter');
+    }
+  }
+
+  // 检查状态管理器依赖
+  const depMap = { provider: 'provider:', getx: 'get:', riverpod: 'flutter_riverpod:' };
+  const keys = Object.values(depMap);
+  if (state === 'default') {
+    assert(!keys.some(k => pubspec.includes(k)), '默认状态不应包含第三方依赖');
+  } else {
+    assert(pubspec.includes(depMap[state]), `pubspec 未包含 ${state} 依赖`);
+  }
+
+  // 关键规则断言（lint）
+  const mustHaveRules = [
+    'prefer_single_quotes:',
+    'directives_ordering:',
+    'prefer_const_constructors:',
+    'prefer_const_literals_to_create_immutables:',
+    'require_trailing_commas:',
+    'prefer_final_fields:',
+    'prefer_final_locals:',
+    'sized_box_for_whitespace:',
+    'avoid_unnecessary_containers:',
+    'use_build_context_synchronously:'
+  ];
+  mustHaveRules.forEach(r => assert(analysis.includes(r), `analysis_options 缺少规则: ${r}`));
+
+  // 所有模板都不应生成适配器和工厂
+  const adapterPath = join(dir, 'lib', 'core', 'state', `${state}_adapter.dart`);
+  const factoryPath = join(dir, 'lib', 'core', 'state', 'state_manager_factory.dart');
+  assert(!existsSync(adapterPath), `${template} 模板不应生成适配器`);
+  assert(!existsSync(factoryPath), `${template} 模板不应生成工厂`);
+
+  assert(!existsSync(join(dir, 'init.sh')), '不应包含 init.sh');
+  assert(!existsSync(join(dir, 'pubspec.yaml.template')), '不应包含 pubspec.yaml.template');
+}
+
+function run () {
+  if (!existsSync(demoDir)) {
+    mkdirSync(demoDir, { recursive: true });
+  } else {
+    const entries = readdirSync(demoDir);
+    for (const name of entries) {
+      if (name.startsWith('t_')) {
+        try { rmSync(join(demoDir, name), { recursive: true, force: true }); } catch { }
+      }
+    }
+  }
+  for (const template of templates) {
+    for (const state of states) {
+      const dir = createProject(template, state);
+      validateProject(dir, template, state);
+      console.log(`✅ 通过: ${template} + ${state}`);
+    }
+  }
+  console.log('✅ 所有组合测试通过');
+}
+
+run();

package/scripts/sync-base-to-templates.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+/**
+ * 同步 base 文件到所有模板
+ * 
+ * 用法：
+ *   node scripts/sync-base-to-templates.js
+ */
+
+import fs from 'fs-extra';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = join(__dirname, '..');
+
+// 源目录
+const sourceDir = join(rootDir, 'templates', 'base_files');
+
+// 目标模板配置
+const templates = [
+  {
+    name: 'template-lite',
+    basePath: join(rootDir, '..', 'template-lite', 'lib', 'base')
+  },
+  {
+    name: 'template-modular',
+    basePath: join(rootDir, '..', 'template-modular', 'lib', 'core', 'base')
+  },
+  {
+    name: 'template-clean',
+    basePath: join(rootDir, '..', 'template-clean', 'lib', 'core', 'base')
+  }
+];
+
+async function syncBaseFiles () {
+  console.log('🚀 开始同步 base 文件到所有模板...\n');
+
+  // 检查源目录
+  if (!(await fs.pathExists(sourceDir))) {
+    console.error(`❌ 源目录不存在: ${sourceDir}`);
+    process.exit(1);
+  }
+
+  let successCount = 0;
+  let failCount = 0;
+
+  for (const template of templates) {
+    console.log(`📦 同步到 ${template.name}...`);
+
+    try {
+      // 确保目标目录存在
+      await fs.ensureDir(template.basePath);
+
+      // 递归复制并处理 .template 后缀
+      await copyWithTemplateProcessing(sourceDir, template.basePath);
+
+      console.log(`   ✅ ${template.name} 同步成功\n`);
+      successCount++;
+    } catch (error) {
+      console.error(`   ❌ ${template.name} 同步失败: ${error.message}\n`);
+      failCount++;
+    }
+  }
+
+  console.log('━'.repeat(50));
+  console.log(`\n✨ 同步完成！`);
+  console.log(`   成功: ${successCount} 个模板`);
+  console.log(`   失败: ${failCount} 个模板\n`);
+
+  if (failCount > 0) {
+    process.exit(1);
+  }
+}
+
+/**
+ * 复制文件并处理 .template 后缀
+ * 将 .dart.template 文件复制为 .dart 文件
+ */
+async function copyWithTemplateProcessing (src, dest) {
+  const items = await fs.readdir(src);
+
+  for (const item of items) {
+    const srcPath = join(src, item);
+    const stat = await fs.stat(srcPath);
+
+    if (stat.isDirectory()) {
+      // 递归处理子目录
+      const destPath = join(dest, item);
+      await fs.ensureDir(destPath);
+      await copyWithTemplateProcessing(srcPath, destPath);
+    } else {
+      // 处理文件：去掉 .template 后缀
+      let destFileName = item;
+      if (item.endsWith('.template')) {
+        destFileName = item.replace(/\.template$/, '');
+      }
+      const destPath = join(dest, destFileName);
+      await fs.copy(srcPath, destPath, { overwrite: true });
+    }
+  }
+}
+
+// 执行同步
+syncBaseFiles().catch(error => {
+  console.error('❌ 同步过程出错:', error);
+  process.exit(1);
+});

package/scripts/workspace-clone-all.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+
+# 克隆所有 Flu CLI 相关仓库到工作区
+# 使用方法: ./scripts/workspace-clone-all.sh
+
+set -e
+
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+ORG="flu-cli"
+BASE_URL="https://gitee.com/${ORG}"
+
+echo -e "${BLUE}🚀 克隆 Flu CLI 工作区...${NC}\n"
+
+# 检查是否在正确的目录
+if [ ! -f "package.json" ]; then
+  echo -e "${YELLOW}⚠️  请在 flu-cli 目录运行此脚本${NC}"
+  exit 1
+fi
+
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+WORKSPACE_DIR="$( cd "$SCRIPT_DIR/../../" && pwd )"
+cd "$WORKSPACE_DIR"
+
+
+REPOS=()
+if command -v curl >/dev/null 2>&1; then
+  PAGE=1
+  while :; do
+    URL="https://gitee.com/api/v5/orgs/${ORG}/repos?per_page=100&page=${PAGE}"
+    if [ -n "${GITEE_TOKEN}" ]; then
+      URL="${URL}&access_token=${GITEE_TOKEN}"
+    fi
+    REPO_JSON=$(curl -s "$URL")
+    NAMES=$(echo "$REPO_JSON" | grep -oE '"full_name":"'"$ORG"'/[^"]+"' | cut -d'/' -f2 | tr -d '"')
+    if [ -z "$NAMES" ]; then
+      break
+    fi
+    for name in $NAMES; do
+      REPOS+=("$name")
+    done
+    PAGE=$((PAGE+1))
+    if [ $PAGE -gt 10 ]; then
+      break
+    fi
+  done
+fi
+if [ ${#REPOS[@]} -eq 0 ] && command -v curl >/dev/null 2>&1; then
+  REPOS_SCRAPED=$(curl -sL "https://gitee.com/${ORG}" \
+    | grep -oE 'href="/'"$ORG"'/[^"/]+"' \
+    | sed -E 's@href="/'"$ORG"'/([^"/]+)"@\1@' \
+    | grep -Ev '^(follow|followers|members|projects|activity|discussions|issues|pulls|joined)$' \
+    | sort -u)
+  for repo in $REPOS_SCRAPED; do REPOS+=("$repo"); done
+fi
+if [ ${#REPOS[@]} -eq 0 ]; then
+  REPOS=(
+    "flu-cli"
+    "flu-cli-docs"
+    "flu-core"
+    "flu-cli-examples"
+    "template-lite"
+    "template-modular"
+    "template-clean"
+  )
+fi
+
+# 克隆每个仓库
+for repo in "${REPOS[@]}"; do
+  if [ -d "$repo" ]; then
+    echo -e "${GREEN}✓ $repo 已存在${NC}"
+  else
+    echo -e "${YELLOW}📥 克隆 $repo...${NC}"
+    if git clone "${BASE_URL}/${repo}.git"; then
+      echo -e "${GREEN}✓ $repo 克隆完成${NC}\n"
+    else
+      echo -e "${YELLOW}⚠️  跳过无效仓库：$repo${NC}\n"
+      continue
+    fi
+  fi
+done
+
+# 复制工作区 README
+if [ -f "flu-cli-v2/WORKSPACE_README.md" ]; then
+  cp flu-cli-v2/WORKSPACE_README.md README.md
+  echo -e "${GREEN}✓ 工作区 README 已创建${NC}\n"
+fi
+
+echo -e "${GREEN}🎉 工作区设置完成！${NC}\n"
+
+echo -e "${BLUE}📁 工作区结构：${NC}"
+ls -1
+echo ""
+
+echo -e "${BLUE}💡 下一步：${NC}"
+echo "1. cd flu-cli-v2 && npm install"
+echo "2. cd flu-cli-docs && npm install"
+echo "3. cd template-lite && ./init.sh"

package/scripts/workspace-status-all.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+
+# 检查工作区所有仓库的状态
+# 使用方法: ./scripts/workspace-status-all.sh
+
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+echo -e "${BLUE}📊 检查工作区状态...${NC}\n"
+
+ORG="flu-cli"
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+WORKSPACE_DIR="$( cd "$SCRIPT_DIR/../../" && pwd )"
+cd "$WORKSPACE_DIR" || exit
+
+REPOS=()
+if command -v curl >/dev/null 2>&1; then
+  PAGE=1
+  while :; do
+    URL="https://gitee.com/api/v5/orgs/${ORG}/repos?per_page=100&page=${PAGE}"
+    if [ -n "${GITEE_TOKEN}" ]; then
+      URL="${URL}&access_token=${GITEE_TOKEN}"
+    fi
+    REPO_JSON=$(curl -s "$URL")
+    NAMES=$(echo "$REPO_JSON" | grep -oE '"full_name":"'"$ORG"'/[^"]+"' | cut -d'/' -f2 | tr -d '"')
+    if [ -z "$NAMES" ]; then
+      break
+    fi
+    for name in $NAMES; do
+      REPOS+=("$name")
+    done
+    PAGE=$((PAGE+1))
+    if [ $PAGE -gt 10 ]; then
+      break
+    fi
+  done
+fi
+if [ ${#REPOS[@]} -eq 0 ] && command -v curl >/dev/null 2>&1; then
+  REPOS_SCRAPED=$(curl -sL "https://gitee.com/${ORG}" \
+    | grep -oE 'href="/'"$ORG"'/[^"/]+"' \
+    | sed -E 's@href="/'"$ORG"'/([^"/]+)"@\1@' \
+    | grep -Ev '^(follow|followers|members|projects|activity|discussions|issues|pulls|joined)$' \
+    | sort -u)
+  for repo in $REPOS_SCRAPED; do REPOS+=("$repo"); done
+fi
+if [ ${#REPOS[@]} -eq 0 ]; then
+  REPOS=(
+    "flu-cli"
+    "flu-cli-docs"
+    "flu-core"
+    "flu-cli-examples"
+    "template-lite"
+    "template-modular"
+    "template-clean"
+  )
+fi
+
+# 检查每个仓库
+for repo in "${REPOS[@]}"; do
+  echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${BLUE}📦 $repo${NC}"
+  echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  
+  if [ ! -d "$repo" ]; then
+    echo -e "${RED}❌ 仓库不存在${NC}\n"
+    continue
+  fi
+  
+  cd "$repo" || continue
+  
+  # 当前分支
+  BRANCH=$(git branch --show-current)
+  echo -e "${YELLOW}分支:${NC} $BRANCH"
+  
+  # 远程状态
+  git fetch --quiet
+  BEHIND=$(git rev-list HEAD..'@{u}' --count 2>/dev/null || echo "0")
+  AHEAD=$(git rev-list '@{u}'..HEAD --count 2>/dev/null || echo "0")
+  
+  if [ "$BEHIND" -gt 0 ]; then
+    echo -e "${YELLOW}⬇️  落后远程 $BEHIND 个提交${NC}"
+  fi
+  
+  if [ "$AHEAD" -gt 0 ]; then
+    echo -e "${YELLOW}⬆️  领先远程 $AHEAD 个提交${NC}"
+  fi
+  
+  if [ "$BEHIND" -eq 0 ] && [ "$AHEAD" -eq 0 ]; then
+    echo -e "${GREEN}✓ 与远程同步${NC}"
+  fi
+  
+  # 工作区状态
+  if [ -n "$(git status --porcelain)" ]; then
+    echo -e "${YELLOW}📝 有未提交的更改:${NC}"
+    git status --short | head -5
+    COUNT=$(git status --porcelain | wc -l)
+    if [ "$COUNT" -gt 5 ]; then
+      echo -e "${YELLOW}   ... 还有 $((COUNT - 5)) 个文件${NC}"
+    fi
+  else
+    echo -e "${GREEN}✓ 工作区干净${NC}"
+  fi
+  
+  echo ""
+  cd ..
+done
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${GREEN}✅ 状态检查完成${NC}"