flu-cli-core 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# @flu-cli/core (V6.0)
+
+核心逻辑库，遵循 **Task Pipeline (任务流水线)** 架构，为 flu-cli 和 VSCode 扩展提供标准化的 Flutter 代码生成与增强能力。
+
+## 🏗 核心架构：Task Pipeline
+
+从 V6.0 开始，核心生成器由传统的命令式逻辑转变为 **原子化任务流水线** 架构。
+
+### 1. 乐高式搭建 (The Lego Model)
+`ProjectGenerator` 不再直接操作文件，而是作为一个 **Orchestrator (指挥官)**。它通过 `ProjectPipeline` 编排一系列 `IProjectTask`。
+
+```mermaid
+graph LR
+    A[ProjectGenerator] --> B(ProjectPipeline)
+    B --> T1[FlutterInitTask]
+    B --> T2[TemplateCopyTask]
+    B --> T3[VariablesReplaceTask]
+    B --> T4[NetworkEnrichTask]
+    B --> T5[RouteMappingTask]
+    B --> T6[HomePatchTask]
+    B --> T7[CleanupTask]
+```
+
+### 2. 骨架 + 增强 (Skeleton + Enrichment)
+- **Skeleton (骨架)**: 从 Git 或本地加载的纯净 Flutter 代码模板。
+- **Enrichment (增强)**: CLI 通过任务流水线动态注入的功能层（如：`NetworkEnrichTask` 注入 Dio 封装，`StateManagerEnrichTask` 注入状态管理适配器）。
+
+## 💡 为什么这么牛？
+
+- **极简核心**: `ProjectGenerator.ts` 从 1500 行精简至 100 行，逻辑高度内聚于各个 Task。
+- **高可扩展性**: 想要支持一个新的功能（如 Sentry 监控、WeChat SDK）？只需编写一个新的 `EnrichTask` 并加入流水线。
+- **高度解耦**: 状态管理、路由注册、环境修复各司其职，互不干扰。
+- **声明式配置**: 开发者可以清晰地看到项目生成的每一个步骤。
+
+## 🚀 核心组件
+
+### 生成器 (Generators)
+- **ProjectGenerator**: 采用 Pipeline 模式的项目实例化引擎。
+- **Page/ViewModel/Model Generator**: 针对不同架构模板的高级代码生成器。
+
+### 任务体系 (Tasks)
+- `FlutterInitTask`: 确保原生 Flutter 环境就绪。
+- `TemplateCopyTask`: 智能处理模板复制与冗余清理。
+- `NetworkEnrichTask`: 声明式注入网络层基础设施。
+- `RouteMappingTask`: 自动扫描业务路径并注册路由表。
+- `HomePatchTask`: 自动化首页示例入口侵入。
+
+## 🛠 开发与扩展
+
+### 如何添加一个新任务？
+1. 在 `src/generators/tasks/` 创建实现 `IProjectTask` 的类。
+2. 在 `ProjectGenerator.generate` 中通过 `.addTask()` 链式调用。
+
+```typescript
+pipeline.addTask(new YourAwesomeTask());
+```
+
+## 📜 许可证
+
+MIT - Copyright © 2025 火叶工作室

package/dist/chunk-FOMWV2YP.js

@@ -0,0 +1,378 @@
+// src/generators/tasks/adapters/provider_adapter.ts
+var ProviderAdapter = class {
+  name;
+  constructor(name = "provider") {
+    this.name = name;
+  }
+  getDependencies() {
+    return this.name === "provider" ? ["provider: ^6.1.1"] : [];
+  }
+  getBaseViewModelTemplate(context) {
+    return null;
+  }
+  getBasePageParent(isListPage) {
+    return isListPage ? "BaseListPage" : "BasePage";
+  }
+  getBaseViewModelParent(isListPage) {
+    return isListPage ? "BaseListViewModel" : "BaseViewModel";
+  }
+  getImports(relativeCorePath) {
+    if (this.name === "provider") {
+      return [
+        `import 'package:provider/provider.dart';`,
+        `import '${relativeCorePath}';`
+      ];
+    }
+    return [`import '${relativeCorePath}';`];
+  }
+  patchAppEntry(content, context) {
+    return content;
+  }
+  getCommonInfo() {
+    return `  ViewState _state = ViewState.idle;
+  String? _errorMessage;
+  bool _isRefreshing = false;
+ 
+  // ==================== Getters ====================
+  // \u5F53\u524D\u89C6\u56FE\u72B6\u6001
+  ViewState get state => _state;
+  // \u9519\u8BEF\u4FE1\u606F
+  String? get errorMessage => _errorMessage;
+  // \u662F\u5426\u6B63\u5728\u52A0\u8F7D
+  bool get isLoading => _state == ViewState.loading;
+  // \u662F\u5426\u52A0\u8F7D\u5931\u8D25
+  bool get isError => _state == ViewState.error;
+  // \u662F\u5426\u52A0\u8F7D\u6210\u529F
+  bool get isSuccess => _state == ViewState.success;
+  // \u662F\u5426\u7A7A\u95F2\u72B6\u6001
+  bool get isIdle => _state == ViewState.idle;
+  // \u662F\u5426\u6B63\u5728\u5237\u65B0
+  bool get isRefreshing => _isRefreshing;
+
+  // ==================== \u72B6\u6001\u8BBE\u7F6E ====================
+
+  /// \u8BBE\u7F6E\u89C6\u56FE\u72B6\u6001
+  void setState(ViewState state, {String? error}) {
+    _state = state;
+    _errorMessage = error;
+    notifyListeners();
+  }
+  
+  /// \u8BBE\u7F6E\u5237\u65B0\u72B6\u6001
+  void setRefreshing(bool refreshing) {
+    _isRefreshing = refreshing;
+    notifyListeners();
+  }
+`;
+  }
+};
+
+// src/generators/tasks/adapters/getx_adapter.ts
+var GetXAdapter = class {
+  name = "getx";
+  getDependencies() {
+    return ["get: ^4.6.6"];
+  }
+  getBaseViewModelTemplate(context) {
+    return `import 'package:get/get.dart';
+
+enum ViewState { idle, loading, success, error }
+
+class BaseViewModel extends GetxController {
+  ViewState _state = ViewState.idle;
+  String? _errorMessage;
+  bool _isRefreshing = false;
+  bool _disposed = false;
+
+  // ==================== Getters ====================
+  ViewState get state => _state;
+  String? get errorMessage => _errorMessage;
+  bool get isLoading => _state == ViewState.loading;
+  bool get isError => _state == ViewState.error;
+  bool get isSuccess => _state == ViewState.success;
+  bool get isIdle => _state == ViewState.idle;
+  bool get isRefreshing => _isRefreshing;
+  // GetX \u4F7F\u7528 isClosed \u5224\u65AD\u662F\u5426\u5DF2\u91CA\u653E
+  bool get isDisposed => _disposed || isClosed;
+
+  // ==================== \u72B6\u6001\u8BBE\u7F6E ====================
+  void setState(ViewState state, {String? error}) {
+    if (_disposed || isClosed) return;
+    _state = state;
+    _errorMessage = error;
+    update();  // GetX \u4F7F\u7528 update() \u800C\u975E notifyListeners()
+  }
+
+  void setRefreshing(bool refreshing) {
+    if (_disposed || isClosed) return;
+    _isRefreshing = refreshing;
+    update();
+  }
+
+  /// \u901A\u77E5\u6570\u636E\u53D8\u5316(\u4EC5\u7528\u4E8E\u5C40\u90E8\u5237\u65B0)
+  void notifyDataChange() {
+    if (_disposed || isClosed) return;
+    update();
+  }
+
+  // ==================== \u751F\u547D\u5468\u671F ====================
+  /// \u521D\u59CB\u5316\u94A9\u5B50
+  @override
+  Future<void> onInit() async {
+    super.onInit();
+    // \u5B50\u7C7B\u53EF\u4EE5\u91CD\u5199\u6B64\u65B9\u6CD5\u8FDB\u884C\u521D\u59CB\u5316
+  }
+
+  /// \u5237\u65B0\u6570\u636E(\u94A9\u5B50)
+  Future<void> refreshData() async {
+    // \u5B50\u7C7B\u53EF\u4EE5\u91CD\u5199\u6B64\u65B9\u6CD5\u5B9E\u73B0\u5237\u65B0\u903B\u8F91
+  }
+
+  @override
+  void onClose() {
+    _disposed = true;
+    super.onClose();
+  }
+}
+`;
+  }
+  getBasePageParent(isListPage) {
+    return isListPage ? "BaseListPage" : "BasePage";
+  }
+  getBaseViewModelParent(isListPage) {
+    return isListPage ? "BaseListViewModel" : "BaseViewModel";
+  }
+  getImports(relativeCorePath) {
+    return [
+      `import '${relativeCorePath}';`
+    ];
+  }
+  /**
+   * 修改 app.dart
+   */
+  patchAppEntry(content, context) {
+    let raw = content;
+    if (!raw.includes("GetMaterialApp(")) {
+      raw = raw.replace(/MaterialApp\s*\(/, "GetMaterialApp(");
+    }
+    if (raw.includes("GetMaterialApp(") && !raw.includes("import 'package:get/get.dart'")) {
+      if (raw.includes("import 'package:flutter/material.dart';")) {
+        raw = raw.replace(
+          "import 'package:flutter/material.dart';",
+          "import 'package:flutter/material.dart';\nimport 'package:get/get.dart';"
+        );
+      } else {
+        raw = `import 'package:get/get.dart';
+` + raw;
+      }
+    }
+    if (raw.includes("routes: AppRoutes.routes")) {
+      raw = raw.replace("routes: AppRoutes.routes", "getPages: AppRoutes.pages");
+    }
+    if (raw.includes("navigatorKey: NavigatorUtil.navigatorKey")) {
+      raw = raw.replace(/navigatorKey:\s*NavigatorUtil\.navigatorKey\s*,?/g, "");
+    }
+    if (raw.includes("scaffoldMessengerKey: NavigatorUtil.scaffoldMessengerKey")) {
+      raw = raw.replace(/scaffoldMessengerKey:\s*NavigatorUtil\.scaffoldMessengerKey\s*,?\s*\n?/g, "");
+    }
+    return raw;
+  }
+  /**
+   * 修改 app_routes.dart
+   */
+  patchRoutes(content, context) {
+    let raw = content;
+    if (raw.includes("static List<GetPage> get pages")) {
+      return raw;
+    }
+    if (!raw.includes("import 'package:get/get.dart'")) {
+      if (raw.includes("import 'package:flutter/material.dart';")) {
+        raw = raw.replace(
+          "import 'package:flutter/material.dart';",
+          "import 'package:get/get.dart';"
+        );
+      } else {
+        raw = `import 'package:get/get.dart';
+` + raw;
+      }
+    }
+    const startMarker = "// __ROUTE_CONFIG_START__";
+    const endMarker = "// __ROUTE_CONFIG_END__";
+    const pagesGetter = `
+  /// GetX \u8DEF\u7531\u6620\u5C04
+  /// \u5728 app.dart \u4E2D\u4F7F\u7528: GetMaterialApp(getPages: AppRoutes.pages, ...)
+  static List<GetPage> get pages {
+    return [
+      GetPage(name: home, page: () => const HomePage()),
+      GetPage(name: userList, page: () => const UserListPage()),
+      // --- \u5728\u6B64\u4E0B\u65B9\u6DFB\u52A0\u60A8\u7684\u81EA\u5B9A\u4E49\u8DEF\u7531 ---
+    ];
+  }
+`;
+    const startIndex = raw.indexOf(startMarker);
+    const endIndex = raw.indexOf(endMarker);
+    if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+      const before = raw.substring(0, startIndex);
+      const after = raw.substring(endIndex + endMarker.length);
+      raw = before + pagesGetter.trim() + after;
+    } else {
+      const standardRoutesPattern = /\s*\/\/\/\s*Material\s+路由映射[\s\S]*?static\s+Map<String,\s*WidgetBuilder>\s*get\s*routes\s*\{\s*return\s*\{[\s\S]*?\}\s*;\s*\}/;
+      if (standardRoutesPattern.test(raw)) {
+        raw = raw.replace(standardRoutesPattern, pagesGetter);
+      } else {
+        const lastBraceIndex = raw.lastIndexOf("}");
+        if (lastBraceIndex !== -1) {
+          raw = raw.slice(0, lastBraceIndex) + "\n" + pagesGetter + raw.slice(lastBraceIndex);
+        }
+      }
+    }
+    return raw;
+  }
+};
+
+// src/generators/tasks/adapters/riverpod_adapter.ts
+import { join } from "path";
+import fsx from "fs-extra";
+var RiverpodAdapter = class {
+  name = "riverpod";
+  getDependencies() {
+    return ["flutter_riverpod: ^2.4.9"];
+  }
+  getBasePageParent(isListPage) {
+    return isListPage ? "BaseListPageRiverpod" : "BasePageRiverpod";
+  }
+  getBaseViewModelParent(isListPage) {
+    return isListPage ? "BaseListNotifier" : "BaseNotifier";
+  }
+  getImports(relativeCorePath) {
+    return [
+      `import 'package:flutter_riverpod/flutter_riverpod.dart';`,
+      `import '${relativeCorePath}';`
+    ];
+  }
+  getBaseViewModelTemplate(context) {
+    return null;
+  }
+  patchAppEntry(content, context) {
+    let raw = content;
+    if (raw.includes("runApp(") && !raw.includes("ProviderScope")) {
+      raw = raw.replace(/runApp\((.*?)\)/, "runApp(const ProviderScope(child: $1))");
+      if (!raw.includes("import 'package:flutter_riverpod/flutter_riverpod.dart'")) {
+        raw = `import 'package:flutter_riverpod/flutter_riverpod.dart';
+` + raw;
+      }
+    }
+    return raw;
+  }
+  async onEnrich(context) {
+    const { projectPath } = context;
+    const baseDir = join(projectPath, "lib", "core", "base");
+    await fsx.ensureDir(baseDir);
+    await fsx.writeFile(join(baseDir, "view_state.dart"), "enum ViewState { idle, loading, success, error }\n");
+    await fsx.writeFile(join(baseDir, "base_state.dart"), `
+import 'view_state.dart';
+
+class BaseState {
+  final ViewState state;
+  final bool isRefreshing;
+  final String? error;
+
+  const BaseState({
+    this.state = ViewState.idle,
+    this.isRefreshing = false,
+    this.error,
+  });
+
+  BaseState copyWith({ ViewState? state, bool? isRefreshing, String? error }) {
+    return BaseState(
+      state: state ?? this.state,
+      isRefreshing: isRefreshing ?? this.isRefreshing,
+      error: error ?? this.error,
+    );
+  }
+
+  bool get isLoading => state == ViewState.loading;
+  bool get isSuccess => state == ViewState.success;
+  bool get isError => state == ViewState.error;
+  bool get isIdle => state == ViewState.idle;
+}
+`);
+    await fsx.writeFile(join(baseDir, "base_notifier.dart"), `
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'view_state.dart';
+import 'base_state.dart';
+
+abstract class BaseNotifier<T extends BaseState> extends Notifier<T> {
+  T createInitialState();
+  @override
+  T build() => createInitialState();
+
+  void setLoading() { state = (state.copyWith(state: ViewState.loading, error: null)) as T; }
+  void setSuccess() { state = (state.copyWith(state: ViewState.success)) as T; }
+  void setError(String message) { state = (state.copyWith(state: ViewState.error, error: message)) as T; }
+  void setRefreshing(bool refreshing) { state = (state.copyWith(isRefreshing: refreshing)) as T; }
+
+  Future<void> run(Future<void> Function() task) async {
+    setLoading();
+    try {
+      await task();
+      setSuccess();
+    } catch (e) {
+      setError(e.toString());
+    }
+  }
+}
+`);
+    await fsx.writeFile(join(baseDir, "base_page_riverpod.dart"), `
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'base_state.dart';
+
+typedef ContentBuilder<TState extends BaseState, TNotifier extends Notifier<TState>> = Widget Function(BuildContext context, TState state, TNotifier vm);
+
+class BasePageRiverpod<TState extends BaseState, TNotifier extends Notifier<TState>> extends ConsumerWidget {
+  final ProviderListenable<TState> provider;
+  final String title;
+  final ContentBuilder<TState, TNotifier> builder;
+
+  const BasePageRiverpod({ super.key, required this.provider, required this.title, required this.builder });
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final state = ref.watch(provider);
+    final vm = ref.read(provider as dynamic).notifier as TNotifier;
+    return Scaffold(
+      appBar: AppBar(title: Text(title)),
+      body: Center(
+        child: state.isLoading
+          ? const CircularProgressIndicator()
+          : state.isError
+            ? Text('Error: ' + (state.error ?? ''))
+            : builder(context, state, vm),
+      ),
+    );
+  }
+}
+`);
+  }
+};
+
+// src/generators/tasks/adapters/factory.ts
+var StateManagerAdapterFactory = class {
+  static getAdapter(name) {
+    switch (name.toLowerCase()) {
+      case "getx":
+        return new GetXAdapter();
+      case "provider":
+        return new ProviderAdapter("provider");
+      case "riverpod":
+        return new RiverpodAdapter();
+      default:
+        return new ProviderAdapter("default");
+    }
+  }
+};
+
+export {
+  StateManagerAdapterFactory
+};

package/dist/chunk-SW6YDKXI.js

@@ -0,0 +1,112 @@
+// src/commands/upgrade_snippets.ts
+import { existsSync, mkdirSync, copyFileSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+// src/utils/logger.ts
+import chalk from "chalk";
+var ConsoleLogger = class {
+  info(message) {
+    console.log(chalk.blue("\u2139\uFE0F  " + message));
+  }
+  success(message) {
+    console.log(chalk.green("\u2705 " + message));
+  }
+  warn(message) {
+    console.log(chalk.yellow("\u26A0\uFE0F  " + message));
+  }
+  error(message) {
+    console.log(chalk.red("\u274C " + message));
+  }
+  title(message) {
+    console.log(chalk.bold.cyan("\n" + message + "\n"));
+  }
+  newLine() {
+    console.log("");
+  }
+};
+var logger = new ConsoleLogger();
+
+// src/commands/upgrade_snippets.ts
+var __dirname;
+try {
+  if (typeof import.meta !== "undefined" && import.meta.url) {
+    const __filename = fileURLToPath(import.meta.url);
+    __dirname = dirname(__filename);
+  } else {
+    throw new Error("Using CJS fallback");
+  }
+} catch {
+  __dirname = typeof global !== "undefined" && global.__dirname ? global.__dirname : process.cwd();
+}
+async function upgradeSnippets(options = {}, logger2 = new ConsoleLogger()) {
+  try {
+    const projectDir = options.projectDir || process.cwd();
+    const force = options.force || false;
+    logger2.info("\u{1F504} \u6B63\u5728\u5347\u7EA7\u9879\u76EE snippets...");
+    const pubspecPath = join(projectDir, "pubspec.yaml");
+    if (!existsSync(pubspecPath)) {
+      logger2.error("\u274C \u672A\u68C0\u6D4B\u5230 Flutter \u9879\u76EE (\u7F3A\u5C11 pubspec.yaml)");
+      return false;
+    }
+    const sourceSnippetsPath = join(
+      __dirname,
+      "..",
+      "..",
+      "templates",
+      "snippets",
+      "flu-cli.code-snippets"
+    );
+    if (!existsSync(sourceSnippetsPath)) {
+      logger2.error(`\u274C \u627E\u4E0D\u5230\u6E90 snippets \u6587\u4EF6: ${sourceSnippetsPath}`);
+      return false;
+    }
+    const targetDir = join(projectDir, ".vscode");
+    const targetPath = join(targetDir, "flu-cli.code-snippets");
+    if (existsSync(targetPath) && !force) {
+      logger2.warn("\u26A0\uFE0F  \u9879\u76EE\u4E2D\u5DF2\u5B58\u5728 snippets \u6587\u4EF6");
+      logger2.info("\u63D0\u793A: \u4F7F\u7528 --force \u53C2\u6570\u5F3A\u5236\u8986\u76D6");
+      return false;
+    }
+    if (!existsSync(targetDir)) {
+      mkdirSync(targetDir, { recursive: true });
+      logger2.info("\u2713 \u521B\u5EFA .vscode \u76EE\u5F55");
+    }
+    copyFileSync(sourceSnippetsPath, targetPath);
+    logger2.success(`\u2705 Snippets \u66F4\u65B0\u6210\u529F!`);
+    logger2.info(`   \u4F4D\u7F6E: ${targetPath}`);
+    logger2.newLine();
+    logger2.info("\u{1F4DD} \u66F4\u65B0\u5185\u5BB9:");
+    logger2.info("   \u2022 Core \u5BFC\u5165\u8DEF\u5F84\u6539\u4E3A\u4F7F\u7528\u53D8\u91CF ${relative_core_path}");
+    logger2.info("   \u2022 \u652F\u6301 package imports (\u81EA\u52A8\u751F\u6210)");
+    logger2.info("   \u2022 \u9002\u914D\u6240\u6709\u67B6\u6784 (Lite/Modular/Clean)");
+    return true;
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    logger2.error(`\u274C \u5347\u7EA7\u5931\u8D25: ${msg}`);
+    return false;
+  }
+}
+function checkSnippetsVersion(projectDir = process.cwd()) {
+  const snippetsPath = join(projectDir, ".vscode", "flu-cli.code-snippets");
+  if (!existsSync(snippetsPath)) {
+    return "missing";
+  }
+  try {
+    const content = readFileSync(snippetsPath, "utf8");
+    if (content.includes("${relative_core_path}")) {
+      return "up-to-date";
+    } else {
+      return "outdated";
+    }
+  } catch {
+    return "missing";
+  }
+}
+
+export {
+  ConsoleLogger,
+  logger,
+  upgradeSnippets,
+  checkSnippetsVersion
+};

package/dist/factory-6DDXZYQP.js

@@ -0,0 +1,6 @@
+import {
+  StateManagerAdapterFactory
+} from "./chunk-FOMWV2YP.js";
+export {
+  StateManagerAdapterFactory
+};