flu-cli 0.0.5 → 2.0.0

package/templates/base_files/base_viewmodel.dart.template

@@ -0,0 +1,77 @@
+import 'package:flutter/foundation.dart';
+
+/// 页面状态定义
+enum ViewState { idle, loading, success, error }
+
+class BaseViewModel extends ChangeNotifier {
+  ViewState _state = ViewState.idle;
+  String? _errorMessage;
+  bool _isRefreshing = 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;
+  // ==================== 状态设置 ====================
+  /// 设置视图状态
+  ///
+  /// [state] 新的状态
+  /// [error] 错误信息（仅在 error 状态时有效）
+  void setState(ViewState state, {String? error}) {
+    _state = state;
+    _errorMessage = error;
+    notifyListeners();
+  }
+
+  /// 设置刷新状态
+  void setRefreshing(bool refreshing) {
+    _isRefreshing = refreshing;
+    notifyListeners();
+  }
+
+  @override
+  void notifyListeners() {
+    super.notifyListeners();
+  }
+
+  /// 通知数据变化（函数级注释）
+  ///
+  /// - 仅用于局部刷新，避免整页重建
+  void notifyDataChange() {
+    notifyListeners();
+  }
+
+  // ==================== 生命周期 ====================
+  /// 初始化钩子（函数级注释）
+  Future<void> onInit() async {
+    // 子类可以重写此方法进行初始化
+  }
+
+  /// 刷新钩子（函数级注释）
+  Future<void> refreshData() async {
+    // 子类可以重写此方法实现刷新逻辑
+  }
+
+  /// 释放资源（函数级注释）
+  @override
+  void dispose() {
+    super.dispose();
+  }
+}

package/templates/base_files/theme/status_views_theme.dart.template

@@ -0,0 +1,46 @@
+import 'package:flutter/material.dart';
+
+/// 状态占位页全局配置（函数级注释）
+///
+/// - 统一的 ThemeExtension，用于 Loading/Error/Empty/LoadMore 视图
+class StatusViewsTheme extends ThemeExtension<StatusViewsTheme> {
+  final Widget Function(BuildContext ctx)? loadingBuilder;
+  final Widget Function(BuildContext ctx, String? msg)? errorBuilder;
+  final Widget Function(BuildContext ctx)? emptyBuilder;
+  final Color? refreshIndicatorColor;
+  final Widget Function(BuildContext ctx, bool hasMore)? loadMoreBuilder;
+
+  const StatusViewsTheme({
+    this.loadingBuilder,
+    this.errorBuilder,
+    this.emptyBuilder,
+    this.refreshIndicatorColor,
+    this.loadMoreBuilder,
+  });
+
+  @override
+  StatusViewsTheme copyWith({
+    Widget Function(BuildContext)? loadingBuilder,
+    Widget Function(BuildContext, String?)? errorBuilder,
+    Widget Function(BuildContext)? emptyBuilder,
+    Color? refreshIndicatorColor,
+    Widget Function(BuildContext, bool)? loadMoreBuilder,
+  }) {
+    return StatusViewsTheme(
+      loadingBuilder: loadingBuilder ?? this.loadingBuilder,
+      errorBuilder: errorBuilder ?? this.errorBuilder,
+      emptyBuilder: emptyBuilder ?? this.emptyBuilder,
+      refreshIndicatorColor:
+          refreshIndicatorColor ?? this.refreshIndicatorColor,
+      loadMoreBuilder: loadMoreBuilder ?? this.loadMoreBuilder,
+    );
+  }
+
+  @override
+  ThemeExtension<StatusViewsTheme> lerp(
+    ThemeExtension<StatusViewsTheme>? other,
+    double t,
+  ) {
+    return this;
+  }
+}

package/templates/snippets/dart.code-snippets

@@ -0,0 +1,487 @@
+{
+  "InkWell": {
+    "prefix": "ik",
+    "body": [
+      "InkWell(",
+      "\tonTap: () {",
+      "",
+      "\t},",
+      "\tchild: body,",
+      ");"
+    ]
+  },
+  "by": {
+    "prefix": "by",
+    "body": [
+      "Widget body = Container();",
+      "return body;",
+    ]
+  },
+  "状态页 分层模版": {
+    "prefix": "stLay",
+    "description": "Flutter StatefulWidget 分层结构框架",
+    "body": [
+      "\t// ------------------------------",
+      "\t// 2. 内部状态（仅组件自身需要的临时状态）",
+      "\t// ------------------------------",
+      "",
+      "\t// ------------------------------",
+      "\t// 3. 状态更新方法（仅处理内部状态）",
+      "\t// ------------------------------",
+      "",
+      "\t// ------------------------------",
+      "\t// 4. UI构建（核心：根据参数和内部状态渲染）",
+      "\t// ------------------------------",
+      "\t@override",
+      "\tWidget build(BuildContext context) {",
+      "\t\tfinal Widget body = _buildBody();",
+      "\t\treturn body;",
+      "\t}",
+      "",
+      "\t// 主体布局",
+      "\tWidget _buildBody() {",
+      "\t\tfinal Widget body = Container();",
+      "\t\treturn body;",
+      "\t}",
+      "",
+      "\t// ------------------------------",
+      "\t// 5. 事件处理（内部交互+转发外部回调）",
+      "\t// ------------------------------",
+      "",
+      "\t// ------------------------------",
+      "\t// 6. 辅助方法（UI计算、数据转换等）",
+      "\t// ------------------------------",
+      "",
+      "\t// ------------------------------",
+      "\t// 7. 生命周期方法（仅必要时使用）",
+      "\t// ------------------------------",
+      "",
+      "\t// ------------------------------",
+      "\t// 8. 资源释放",
+      "\t// ------------------------------",
+      "\t@override",
+      "\tvoid dispose() {",
+      "\t\tsuper.dispose();",
+      "\t}"
+    ]
+  },
+  "无状态 分层模版": {
+    "prefix": "lessLay",
+    "description": "Flutter StatelessWidget 分层结构框架",
+    "body": [
+      "",
+      "\t// ------------------------------",
+      "\t// 2. UI构建（核心：根据参数渲染）",
+      "\t// ------------------------------",
+      "\t@override",
+      "\tWidget build(BuildContext context) {",
+      "\t\tfinal Widget body = _buildBody();",
+      "\t\treturn body;",
+      "\t}",
+      "\t// 主容器（拆分UI结构）",
+      "\tWidget _buildBody() {",
+      "\t\tfinal Widget body = Container();",
+      "\t\treturn body;",
+      "\t}",
+      "",
+      "\t// ------------------------------",
+      "\t// 3. 辅助方法（UI计算/转换）",
+      "\t// ------------------------------",
+      "",
+    ]
+  },
+  "flu.stPage": {
+    "prefix": "stPage",
+    "description": "Stateful 页面(使用 BasePage)",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "import '../base/base_page.dart';",
+      "import '{{vm_import}}';",
+      "",
+      "class {{Name}}Page extends BasePage<{{Name}}ViewModel> {",
+      "  const {{Name}}Page({super.key});",
+      "",
+      "  @override",
+      "  State<{{Name}}Page> createState() => _{{Name}}PageState();",
+      "}",
+      "",
+      "class _{{Name}}PageState extends BasePageState<{{Name}}ViewModel, {{Name}}Page> {",
+      "  // ==================== UI 配置 ====================",
+      "  @override",
+      "  String get title => '{{title}}';",
+      "",
+      "  // ==================== ViewModel ====================",
+      "  @override",
+      "  {{Name}}ViewModel createViewModel() => {{Name}}ViewModel();",
+      "",
+      "  // ==================== UI 构建 ====================",
+      "  @override",
+      "  Widget buildContent(BuildContext context) {",
+      "    return Center(",
+      "      child: Text('{{Name}} Page'),",
+      "    );",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.lessPage": {
+    "prefix": "lessPage",
+    "description": "Stateless 页面（三段分层 + 增量包裹）",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "",
+      "class {{Name}}Page extends StatelessWidget {",
+      "  // ------------------------------",
+      "  // 1. 外部配置参数（构造函数）",
+      "  // ------------------------------",
+      "  /// 构造函数",
+      "  const {{Name}}Page({super.key});",
+      "",
+      "  // ------------------------------",
+      "  // 2. UI构建（核心：根据参数渲染）",
+      "  // ------------------------------",
+      "  @override",
+      "  Widget build(BuildContext context) {",
+      "    final appBar = _buildAppBar(context);",
+      "    final body = _buildBody(context);",
+      "    return Scaffold(appBar: appBar, body: body);",
+      "  }",
+      "",
+      "  /// 主容器（style: incremental-wrapping）",
+      "  Widget _buildBody(BuildContext context) {",
+      "    Widget w = const SizedBox.shrink();",
+      "    w = Padding(padding: const EdgeInsets.all(16), child: w);",
+      "    return w;",
+      "  }",
+      "",
+      "  AppBar _buildAppBar(BuildContext context) {",
+      "    return AppBar(title: const Text('{{title}}'));",
+      "  }",
+      "",
+      "  // ------------------------------",
+      "  // 3. 辅助方法（UI计算/转换）",
+      "  // ------------------------------",
+      "  String _formatTitle(String text) => text;",
+      "}",
+      ""
+    ]
+  },
+  "flu.stWidget": {
+    "prefix": "stWidget",
+    "description": "Stateful 组件（七段分层 + 增量包裹）",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "",
+      "class {{Name}}Widget extends StatefulWidget {",
+      "  // ------------------------------",
+      "  // 1. 外部配置参数（构造函数）",
+      "  // ------------------------------",
+      "  /// 构造函数",
+      "  const {{Name}}Widget({super.key});",
+      "",
+      "  @override",
+      "  State<{{Name}}Widget> createState() => _{{Name}}WidgetState();",
+      "}",
+      "",
+      "class _{{Name}}WidgetState extends State<{{Name}}Widget> {",
+      "  // ------------------------------",
+      "  // 2. 内部状态（仅组件自身需要的临时状态）",
+      "  // ------------------------------",
+      "  int _count = 0;",
+      "",
+      "  // ------------------------------",
+      "  // 3. 状态更新方法（仅处理内部状态）",
+      "  // ------------------------------",
+      "  void _inc() { setState(() { _count++; }); }",
+      "",
+      "  // ------------------------------",
+      "  // 4. UI构建（核心：根据参数和内部状态渲染）",
+      "  // ------------------------------",
+      "  @override",
+      "  Widget build(BuildContext context) {",
+      "    Widget w = Text('count: ' + _count.toString());",
+      "    w = Padding(padding: const EdgeInsets.all(12), child: w);",
+      "    return w;",
+      "  }",
+      "",
+      "  // ------------------------------",
+      "  // 5. 事件处理（内部交互+转发外部回调）",
+      "  // ------------------------------",
+      "  void _onPressed() { _inc(); }",
+      "",
+      "  // ------------------------------",
+      "  // 5.2 转发外部回调（如点击事件）",
+      "  // ------------------------------",
+      "  void _emitPressed() { /* TODO */ }",
+      "",
+      "  // ------------------------------",
+      "  // 6. 辅助方法（UI计算、数据转换等）",
+      "  // ------------------------------",
+      "  String _format(String s) => s;",
+      "",
+      "  // ------------------------------",
+      "  // 7. 生命周期方法（仅必要时使用）",
+      "  // ------------------------------",
+      "  @override",
+      "  void initState() {",
+      "    super.initState();",
+      "  }",
+      "",
+      "  @override",
+      "  void dispose() {",
+      "    super.dispose();",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.lessWidget": {
+    "prefix": "lessWidget",
+    "description": "Stateless 组件（三段分层 + 增量包裹）",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "",
+      "class {{Name}}Widget extends StatelessWidget {",
+      "  // ------------------------------",
+      "  // 1. 外部配置参数（构造函数）",
+      "  // ------------------------------",
+      "  /// 构造函数",
+      "  const {{Name}}Widget({super.key});",
+      "",
+      "  // ------------------------------",
+      "  // 2. UI构建（核心：根据参数渲染）",
+      "  // ------------------------------",
+      "  @override",
+      "  Widget build(BuildContext context) {",
+      "    Widget w = const SizedBox.shrink();",
+      "    w = Padding(padding: const EdgeInsets.all(12), child: w);",
+      "    return w;",
+      "  }",
+      "",
+      "  // ------------------------------",
+      "  // 3. 辅助方法（UI计算/转换）",
+      "  // ------------------------------",
+      "  String _format(String s) => s;",
+      "}",
+      ""
+    ]
+  },
+  "flu.component": {
+    "prefix": "component",
+    "description": "通用组件（模块内或共享）",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "",
+      "class {{Name}}Component extends StatelessWidget {",
+      "  /// 构造函数",
+      "  const {{Name}}Component({super.key});",
+      "",
+      "  @override",
+      "  Widget build(BuildContext context) {",
+      "    return Container(",
+      "      padding: const EdgeInsets.all(16),",
+      "      child: Column(",
+      "        crossAxisAlignment: CrossAxisAlignment.start,",
+      "        children: [",
+      "          Text(",
+      "            '{{Name}}Component',",
+      "            style: Theme.of(context).textTheme.titleLarge,",
+      "          ),",
+      "          const SizedBox(height: 8),",
+      "          const Text('Component content goes here'),",
+      "        ],",
+      "      ),",
+      "    );",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.viewmodel": {
+    "prefix": "viewmodel",
+    "description": "ViewModel（使用 BaseViewModel）",
+    "body": [
+      "import '../base/base_viewmodel.dart';",
+      "",
+      "class {{Name}}ViewModel extends BaseViewModel {",
+      "  /// 初始化",
+      "  @override",
+      "  Future<void> onInit() async {",
+      "    await super.onInit();",
+      "    // TODO: 初始化逻辑",
+      "  }",
+      "",
+      "  /// 刷新数据",
+      "  @override",
+      "  Future<void> refreshData() async {",
+      "    // TODO: 刷新逻辑",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.service.api": {
+    "prefix": "apiService",
+    "description": "API Service（http 示例）",
+    "body": [
+      "import 'dart:convert';",
+      "import 'package:http/http.dart' as http;",
+      "",
+      "class {{Name}}Service {",
+      "  final String baseUrl = 'https://api.example.com';",
+      "",
+      "  Future<Map<String, dynamic>> getData(String id) async {",
+      "    try {",
+      "      final response = await http.get(",
+      "        Uri.parse('$baseUrl/{{snake_name}}/$id'),",
+      "        headers: {'Content-Type': 'application/json'},",
+      "      );",
+      "      if (response.statusCode == 200) {",
+      "        return json.decode(response.body);",
+      "      } else {",
+      "        throw Exception('Failed: ${response.statusCode}');",
+      "      }",
+      "    } catch (e) {",
+      "      throw Exception('Network error: ' + e.toString());",
+      "    }",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.service.auth": {
+    "prefix": "authService",
+    "description": "Auth Service（登录/登出示例）",
+    "body": [
+      "import 'dart:convert';",
+      "import 'package:http/http.dart' as http;",
+      "import 'package:shared_preferences/shared_preferences.dart';",
+      "",
+      "class {{Name}}Service {",
+      "  final String baseUrl = 'https://api.example.com';",
+      "  static const String _tokenKey = 'auth_token';",
+      "",
+      "  Future<Map<String, dynamic>> login(String username, String password) async {",
+      "    try {",
+      "      final response = await http.post(",
+      "        Uri.parse('$baseUrl/auth/login'),",
+      "        headers: {'Content-Type': 'application/json'},",
+      "        body: json.encode({'username': username, 'password': password}),",
+      "      );",
+      "      if (response.statusCode == 200) {",
+      "        final data = json.decode(response.body);",
+      "        return data;",
+      "      } else {",
+      "        throw Exception('Login failed: ${response.statusCode}');",
+      "      }",
+      "    } catch (e) {",
+      "      throw Exception('Login error: ' + e.toString());",
+      "    }",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.service.storage": {
+    "prefix": "storageService",
+    "description": "Storage Service（SharedPreferences 示例）",
+    "body": [
+      "import 'package:shared_preferences/shared_preferences.dart';",
+      "import 'dart:convert';",
+      "",
+      "class {{Name}}Service {",
+      "  static const String _keyPrefix = '{{snake_name}}_';",
+      "",
+      "  Future<bool> saveString(String key, String value) async {",
+      "    final prefs = await SharedPreferences.getInstance();",
+      "    return await prefs.setString(_keyPrefix + key, value);",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.model": {
+    "prefix": "model",
+    "description": "基础 Model（JSON 序列化）",
+    "body": [
+      "class {{Name}}Model {",
+      "  final String id;",
+      "  final String name;",
+      "  final DateTime createdAt;",
+      "",
+      "  {{Name}}Model({",
+      "    required this.id,",
+      "    required this.name,",
+      "    required this.createdAt,",
+      "  });",
+      "",
+      "  factory {{Name}}Model.fromJson(Map<String, dynamic> json) {",
+      "    return {{Name}}Model(",
+      "      id: json['id'] as String,",
+      "      name: json['name'] as String,",
+      "      createdAt: DateTime.parse(json['created_at'] as String),",
+      "    );",
+      "  }",
+      "",
+      "  Map<String, dynamic> toJson() {",
+      "    return {",
+      "      'id': id,",
+      "      'name': name,",
+      "      'created_at': createdAt.toIso8601String(),",
+      "    };",
+      "  }",
+      "}",
+      ""
+    ]
+  },
+  "flu.listPage": {
+    "prefix": "listPage",
+    "description": "List Page (BaseListPage)",
+    "body": [
+      "import 'package:flutter/material.dart';",
+      "import '../base/base_list_page.dart';",
+      "import '{{vm_import}}';",
+      "import '../models/{{snake_name}}_model.dart';",
+      "",
+      "class {{Name}}Page extends BaseListPage<{{ModelName}}, {{Name}}ViewModel> {",
+      "  const {{Name}}Page({super.key});",
+      "",
+      "  @override",
+      "  State<{{Name}}Page> createState() => _{{Name}}PageState();",
+      "}",
+      "",
+      "class _{{Name}}PageState extends BaseListPageState<{{ModelName}}, {{Name}}ViewModel, {{Name}}Page> {",
+      "  @override",
+      "  String get title => '{{title}}';",
+      "",
+      "  @override",
+      "  {{Name}}ViewModel createViewModel() => {{Name}}ViewModel();",
+      "",
+      "  @override",
+      "  Widget buildItem(BuildContext context, {{ModelName}} item, int index) {",
+      "    return ListTile(",
+      "      title: Text(item.toString()),",
+      "    );",
+      "  }",
+      "}"
+    ]
+  },
+  "flu.listViewModel": {
+    "prefix": "listViewModel",
+    "description": "List ViewModel (BaseListViewModel)",
+    "body": [
+      "import '../base/base_list_viewmodel.dart';",
+      "import '../models/{{snake_name}}_model.dart';",
+      "",
+      "class {{Name}}ViewModel extends BaseListViewModel<{{ModelName}}> {",
+      "  @override",
+      "  Future<List<{{ModelName}}>> fetchPage({required int page, required int pageSize}) async {",
+      "    // TODO: Load data from service",
+      "    await Future.delayed(const Duration(seconds: 1));",
+      "    return [];",
+      "  }",
+      "}"
+    ]
+  }
+}