flu-cli-core 1.0.5 → 1.1.0

package/README.md

@@ -55,6 +55,15 @@ ProjectGenerator
 - **Android**: APK / AAB 自动构建
 - **iOS**: IPA 自动构建
 
+### 6. AI + SKILL（规则投影）
+
+通过 `.flu-cli.json`（单一事实来源）投影生成多份 AI 可读规则文件，保证 AI/CLI/VSCode 产出一致：
+
+- `.cursor/rules/flu-project.mdc`
+- `CLAUDE.md`
+- `AI_RULES.md`
+- `.agent/skills/<slug>/SKILL.md`
+
 ## 💡 架构优势
 
 - **极简核心** — `ProjectGenerator.ts` 从 1500 行精简至 100 行

package/dist/chunk-BGYZU6TU.js

@@ -0,0 +1,466 @@
+// 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) {
+    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()),
+      // --- \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/bloc_adapter.ts
+var BlocAdapter = class {
+  name = "bloc";
+  getDependencies() {
+    return ["flutter_bloc: ^8.1.3"];
+  }
+  getBaseViewModelTemplate(_context) {
+    return `import 'package:flutter_bloc/flutter_bloc.dart';
+
+enum ViewState { idle, loading, success, error }
+
+class BaseViewModel extends Cubit<ViewState> {
+  String? _errorMessage;
+  bool _isRefreshing = false;
+  bool _disposed = false;
+
+  BaseViewModel() : super(ViewState.idle);
+
+  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;
+  bool get isDisposed => _disposed;
+
+  void setState(ViewState state, {String? error}) {
+    if (_disposed) return;
+    _errorMessage = error;
+    emit(state);
+  }
+
+  void setRefreshing(bool refreshing) {
+    if (_disposed) return;
+    _isRefreshing = refreshing;
+    emit(state);
+  }
+
+  void notifyDataChange() {
+    if (_disposed) return;
+    emit(state);
+  }
+
+  Future<void> onInit() async {}
+  Future<void> refreshData() async {}
+
+  @override
+  Future<void> close() {
+    _disposed = true;
+    return super.close();
+  }
+}
+`;
+  }
+  getBasePageParent(isListPage) {
+    return isListPage ? "BaseListPage" : "BasePage";
+  }
+  getBaseViewModelParent(isListPage) {
+    return isListPage ? "BaseListViewModel" : "BaseViewModel";
+  }
+  getImports(relativeCorePath) {
+    return [`import 'package:flutter_bloc/flutter_bloc.dart';`, `import '${relativeCorePath}';`];
+  }
+  patchAppEntry(content, _context) {
+    let raw = content;
+    if (!raw.includes("import 'package:flutter_bloc/flutter_bloc.dart'")) {
+      if (raw.includes("import 'package:flutter/material.dart';")) {
+        raw = raw.replace(
+          "import 'package:flutter/material.dart';",
+          "import 'package:flutter/material.dart';\nimport 'package:flutter_bloc/flutter_bloc.dart';"
+        );
+      } else {
+        raw = `import 'package:flutter_bloc/flutter_bloc.dart';
+${raw}`;
+      }
+    }
+    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 "bloc":
+        return new BlocAdapter();
+      case "provider":
+        return new ProviderAdapter("provider");
+      case "riverpod":
+        return new RiverpodAdapter();
+      default:
+        return new ProviderAdapter("default");
+    }
+  }
+};
+
+export {
+  StateManagerAdapterFactory
+};

package/dist/chunk-QGM4M3NI.js

@@ -0,0 +1,37 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __toESM
+};

package/dist/factory-LM2CTHPW.js

@@ -0,0 +1,7 @@
+import {
+  StateManagerAdapterFactory
+} from "./chunk-BGYZU6TU.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  StateManagerAdapterFactory
+};

package/dist/factory-P6ABQFH3.js

@@ -0,0 +1,7 @@
+import {
+  StateManagerAdapterFactory
+} from "./chunk-ANN4MX7M.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  StateManagerAdapterFactory
+};