flu-cli 2.0.3 → 2.0.5

package/templates/base_files/base_list_page.dart.template

@@ -1,174 +0,0 @@
-import 'package:flutter/material.dart';
-
-import 'base_list_viewmodel.dart';
-import 'base_page.dart';
-import 'theme/status_views_theme.dart';
-
-/// 列表页面基类：在 BasePage 基础上扩展列表体与触底加载能力
-abstract class BaseListPage<T, VM extends BaseListViewModel<T>>
-    extends BasePage<VM> {
-  /// 构造函数
-  const BaseListPage({super.key});
-
-  /// 子类必须实现：创建 ViewModel 实例
-  VM createListViewModel();
-
-  /// 渲染单个条目
-  Widget buildItem(BuildContext context, VM vm, T item, int index);
-
-  /// 可选：头部、尾部、状态页覆盖（函数级注释）
-
-  /// 构建成功态的列表体（函数级注释）
-  /// 返回 null 使用默认 ListView.builder；可自定义 SliverList/GridView 等容器
-  Widget? buildListWidget(BuildContext context, VM vm) => null;
-  Widget? buildHeader(BuildContext context, VM vm) => null;
-  Widget? buildFooter(BuildContext context, VM vm) => null;
-  Widget? buildLoading(BuildContext context, VM vm) => null;
-  Widget? buildError(BuildContext context, VM vm, String? msg) => null;
-  Widget? buildEmpty(BuildContext context, VM vm) => null;
-
-  /// 可选：替换底部“加载更多”视图
-  Widget? loadMoreFooterBuilder(
-    BuildContext context,
-    VM vm,
-    bool hasMore,
-    bool isLoadingMore,
-  ) =>
-      null;
-
-  /// 刷新容器包裹（用于接入第三方刷新库）
-  Widget refreshWrapperBuilder(BuildContext context, Widget child, VM vm) =>
-      child;
-
-  /// 列表体外层包裹（函数级注释）
-  /// 用于添加 Scrollbar、NotificationListener、吸顶 Header 等额外结构
-  Widget listWrapperBuilder(BuildContext context, Widget list, VM vm) => list;
-
-  /// 提供自定义 ScrollController（函数级注释）
-  /// 返回 null 使用内部控制器；非空时由外部管理其生命周期
-  ScrollController? provideScrollController(BuildContext context, VM vm) =>
-      null;
-
-  /// 滚动事件回调（函数级注释）
-  /// 可用于自定义触底策略或滚动埋点
-  void onScroll(BuildContext context, ScrollPosition position, VM vm) {}
-
-  /// 是否启用自动触底加载
-  bool get enableAutoLoadMore => true;
-
-  /// 触底阈值
-  double get loadMoreThreshold => 100;
-
-  /// 是否启用下拉刷新（透传到 BasePageState）
-  bool get enableRefresh => false;
-
-  @override
-  State<BaseListPage<T, VM>> createState() => _BaseListPageState<T, VM>();
-}
-
-class _BaseListPageState<T, VM extends BaseListViewModel<T>>
-    extends BasePageState<VM, BaseListPage<T, VM>> {
-  late final ScrollController _controller =
-      widget.provideScrollController(context, viewModel) ?? ScrollController();
-
-  /// 创建 ViewModel（使用注入的实例）
-  @override
-  VM createViewModel() => widget.createListViewModel();
-
-  /// 页面是否为空：依据列表数据判断
-  @override
-  bool get isEmptyContent => viewModel.items.isEmpty;
-
-  @override
-  void initState() {
-    super.initState();
-    _controller.addListener(_onScroll);
-  }
-
-  @override
-  void dispose() {
-    _controller.removeListener(_onScroll);
-    _controller.dispose();
-    super.dispose();
-  }
-
-  /// 触底检测：接近底部时尝试加载更多
-  void _onScroll() {
-    widget.onScroll(context, _controller.position, viewModel);
-    if (!widget.enableAutoLoadMore) return;
-    if (!_controller.hasClients) return;
-    final max = _controller.position.maxScrollExtent;
-    final offset = _controller.offset;
-    if (offset >= max - widget.loadMoreThreshold) {
-      viewModel.loadMore();
-    }
-  }
-
-  /// 构建成功态内容：列表 + 底部 Footer
-  @override
-  Widget buildContent(BuildContext context) {
-    Widget body = _buildListWidget();
-    if (widget.enableRefresh) {
-      body = widget.refreshWrapperBuilder(context, body, viewModel);
-    }
-    return body;
-  }
-
-  /// 构建列表视图：支持自定义或默认实现
-  Widget _buildListWidget() {
-    final vm = viewModel;
-    final theme = Theme.of(context).extension<StatusViewsTheme>();
-    final list = widget.buildListWidget(context, vm) ??
-        ListView.builder(
-          controller: _controller,
-          itemCount: vm.items.length + 1,
-          itemBuilder: (ctx, i) {
-            if (i == 0) {
-              final header = widget.buildHeader(ctx, vm);
-              if (header != null) return header;
-            }
-            final last = i == vm.items.length;
-            if (last) {
-              final localFooter = widget.buildFooter(ctx, vm);
-              if (localFooter != null) return localFooter;
-
-              if (vm.loadMoreFailed) {
-                return Padding(
-                  padding: const EdgeInsets.all(16),
-                  child: Column(
-                    mainAxisSize: MainAxisSize.min,
-                    children: [
-                      Text(
-                        vm.loadMoreError?.toString() ?? '加载更多失败',
-                        style: const TextStyle(color: Colors.red),
-                      ),
-                      const SizedBox(height: 8),
-                      ElevatedButton(
-                        onPressed: vm.loadMore,
-                        child: const Text('重试'),
-                      ),
-                    ],
-                  ),
-                );
-              }
-
-              final globalFooter =
-                  theme?.loadMoreBuilder?.call(ctx, vm.hasMore);
-              if (globalFooter != null) return globalFooter;
-
-              return Padding(
-                padding: const EdgeInsets.all(16),
-                child: Center(
-                  child: vm.hasMore
-                      ? const CircularProgressIndicator()
-                      : const Text('没有更多了'),
-                ),
-              );
-            }
-            final item = vm.items[i];
-            return widget.buildItem(ctx, vm, item, i);
-          },
-        );
-    return widget.listWrapperBuilder(context, list, vm);
-  }
-}

package/templates/base_files/base_list_viewmodel.dart.template

@@ -1,134 +0,0 @@
-import 'base_viewmodel.dart';
-
-/// 列表基础 ViewModel（轻量版）
-///
-/// - 提供分页/刷新/加载更多的最小实现
-abstract class BaseListViewModel<T> extends BaseViewModel {
-  final List<T> items = <T>[];
-  int page = 1;
-  int pageSize = 20;
-  bool hasMore = true;
-  bool isLoadingMore = false;
-  bool loadMoreFailed = false;
-  Object? loadMoreError;
-
-  /// 子类必须实现：拉取一页数据（函数级注释）
-  Future<List<T>> fetchPage({required int page, required int pageSize});
-
-  /// 初始化加载（函数级注释）
-  @override
-  Future<void> onInit() async {
-    super.onInit();
-    await loadData();
-  }
-
-  /// 首屏加载（函数级注释）
-  Future<void> loadData() async {
-    setState(ViewState.loading);
-    page = 1;
-    hasMore = true;
-    try {
-      final list = await fetchPage(page: page, pageSize: pageSize);
-      items
-        ..clear()
-        ..addAll(list);
-      _configHasMore(list);
-      setState(ViewState.success);
-    } catch (e) {
-      setState(ViewState.error, error: e.toString());
-    }
-  }
-
-  /// 下拉刷新（函数级注释）
-  @override
-  Future<void> refreshData() async {
-    if (isRefreshing) return;
-    setRefreshing(true);
-    final old = state;
-    try {
-      page = 1;
-      hasMore = true;
-      final list = await fetchPage(page: page, pageSize: pageSize);
-      items
-        ..clear()
-        ..addAll(list);
-      _configHasMore(list);
-      setState(ViewState.success);
-    } catch (_) {
-      // 刷新失败回退原状态
-      setState(old);
-    } finally {
-      setRefreshing(false);
-    }
-  }
-
-  /// 加载更多（函数级注释）
-  Future<void> loadMore() async {
-    if (!hasMore || isLoadingMore) return;
-    isLoadingMore = true;
-    loadMoreFailed = false;
-    loadMoreError = null;
-    try {
-      final next = page + 1;
-      final list = await fetchPage(page: next, pageSize: pageSize);
-      if (list.isNotEmpty) {
-        items.addAll(list);
-        page = next;
-      }
-      _configHasMore(list);
-    } catch (e) {
-      loadMoreFailed = true;
-      loadMoreError = e;
-    } finally {
-      isLoadingMore = false;
-      notifyDataChange();
-    }
-  }
-
-  /// 重置分页（函数级注释）
-  void resetPaging({int initialPage = 1, int pageSize = 20}) {
-    page = initialPage;
-    this.pageSize = pageSize;
-    hasMore = true;
-    items.clear();
-    loadMoreFailed = false;
-    loadMoreError = null;
-    notifyListeners();
-    setState(ViewState.idle);
-  }
-
-  /// 计算是否还有更多（函数级注释）
-  void _configHasMore(List<T> data) {
-    hasMore = data.length >= pageSize;
-    loadMoreFailed = false;
-    loadMoreError = null;
-  }
-
-  /// 清空列表
-  void clearItems() {
-    items.clear();
-    page = 1;
-    hasMore = true;
-    notifyListeners();
-  }
-
-  /// 数据操作：添加（函数级注释）
-  void addItem(T item) {
-    items.add(item);
-    notifyListeners();
-  }
-
-  /// 数据操作：移除（函数级注释）
-  void removeItem(T item) {
-    items.remove(item);
-    notifyListeners();
-  }
-
-  /// 数据操作：更新（函数级注释）
-  void updateItem(int index, T item) {
-    if (index >= 0 && index < items.length) {
-      items[index] = item;
-      notifyListeners();
-    }
-  }
-}

package/templates/base_files/base_page.dart.template

@@ -1,251 +0,0 @@
-import 'package:flutter/material.dart';
-
-import 'base_viewmodel.dart';
-import 'theme/status_views_theme.dart';
-
-/// Page 基类
-///
-/// 提供统一的页面结构和状态处理
-///
-/// 示例：
-/// ```dart
-/// class HomePage extends BasePage<HomeViewModel> {
-///   const HomePage({super.key});
-///
-///   @override
-///   State<HomePage> createState() => _HomePageState();
-/// }
-///
-/// class _HomePageState extends BasePageState<HomeViewModel, HomePage> {
-///   @override
-///   HomeViewModel createViewModel() => HomeViewModel();
-///
-///   @override
-///   String get title => '首页';
-///
-///   @override
-///   Widget buildContent(BuildContext context) {
-///     return Center(
-///       child: Text('Counter: ${viewModel.counter}'),
-///     );
-///   }
-/// }
-/// ```
-abstract class BasePage<VM extends BaseViewModel> extends StatefulWidget {
-  const BasePage({super.key});
-
-  /// 是否显示 AppBar（默认 true）
-  bool get showAppBar => true;
-
-  /// AppBar 标题（默认空串）
-  String get title => '';
-
-  /// AppBar 操作按钮（默认 null）
-  List<Widget>? get actions => null;
-
-  /// 是否显示返回按钮（默认自动判断）
-  bool? get showBackButton => null;
-
-  /// 背景颜色（默认 null）
-  Color? get backgroundColor => null;
-
-  /// 是否启用 SafeArea（默认 true）
-  bool get useSafeArea => true;
-
-  @override
-  State<BasePage<VM>> createState();
-}
-
-/// Page State 基类
-abstract class BasePageState<VM extends BaseViewModel, T extends BasePage<VM>>
-    extends State<T> {
-  /// ViewModel 实例
-  late final VM viewModel;
-
-  // ==================== 子类需要实现的方法 ====================
-
-  /// 创建 ViewModel
-  VM createViewModel();
-
-  /// 构建内容区域
-  Widget buildContent(BuildContext context);
-
-  // ==================== 可选重写的方法 ====================
-
-  /// 是否显示 AppBar（透传自 Widget 层）
-  bool get showAppBar => widget.showAppBar;
-
-  /// AppBar 标题（透传自 Widget 层）
-  String get title => widget.title;
-
-  /// AppBar 操作按钮（透传自 Widget 层）
-  List<Widget>? get actions => widget.actions;
-
-  /// 是否显示返回按钮（透传自 Widget 层）
-  bool? get showBackButton => widget.showBackButton;
-
-  /// 背景颜色（透传自 Widget 层）
-  Color? get backgroundColor => widget.backgroundColor;
-
-  /// 是否安全区域（透传自 Widget 层）
-  bool get useSafeArea => widget.useSafeArea;
-
-  // ==================== 生命周期 ====================
-
-  @override
-  void initState() {
-    super.initState();
-    viewModel = createViewModel();
-    _setupListener();
-    viewModel.onInit();
-  }
-
-  /// 设置监听器
-  void _setupListener() {
-    // 所有状态管理器都使用统一的 addListener 方式
-    viewModel.addListener(_onViewModelChanged);
-  }
-
-  @override
-  void dispose() {
-    viewModel.removeListener(_onViewModelChanged);
-    viewModel.dispose();
-    super.dispose();
-  }
-
-  /// ViewModel 变化回调
-  void _onViewModelChanged() {
-    if (mounted) {
-      setState(() {});
-    }
-  }
-
-  // ==================== UI 构建 ====================
-
-  @override
-  Widget build(BuildContext context) {
-    Widget body = _buildBody();
-
-    if (useSafeArea) {
-      body = SafeArea(child: body);
-    }
-
-    return Scaffold(
-      appBar: showAppBar ? _buildAppBar() : null,
-      backgroundColor: backgroundColor,
-      body: body,
-    );
-  }
-
-  /// 构建 AppBar
-  PreferredSizeWidget? _buildAppBar() {
-    return AppBar(
-      title: Text(title),
-      actions: actions,
-      automaticallyImplyLeading: showBackButton ?? true,
-    );
-  }
-
-  /// 构建 Body
-  Widget _buildBody() {
-    final theme = Theme.of(context).extension<StatusViewsTheme>();
-
-    if (viewModel.isLoading) {
-      final global = theme?.loadingBuilder?.call(context);
-      return global ?? buildLoading();
-    }
-
-    if (viewModel.isError) {
-      final global = theme?.errorBuilder?.call(context, viewModel.errorMessage);
-      return global ?? buildError();
-    }
-
-    if (isEmptyContent) {
-      final global = theme?.emptyBuilder?.call(context);
-      return global ?? buildEmpty();
-    }
-
-    return buildContent(context);
-  }
-
-  // ==================== 可重写的 UI 组件 ====================
-
-  /// 构建 Loading 视图
-  Widget buildLoading() {
-    return const Center(
-      child: CircularProgressIndicator(),
-    );
-  }
-
-  /// 构建错误视图
-  Widget buildError() {
-    return Center(
-      child: Column(
-        mainAxisAlignment: MainAxisAlignment.center,
-        children: [
-          const Icon(
-            Icons.error_outline,
-            size: 64,
-            color: Colors.red,
-          ),
-          const SizedBox(height: 16),
-          Text(
-            viewModel.errorMessage ?? '加载失败',
-            style: const TextStyle(fontSize: 16),
-          ),
-          const SizedBox(height: 24),
-          ElevatedButton.icon(
-            onPressed: viewModel.refreshData,
-            icon: const Icon(Icons.refresh),
-            label: const Text('重试'),
-          ),
-        ],
-      ),
-    );
-  }
-
-  /// 构建空视图
-  Widget buildEmpty() {
-    return const Center(
-      child: Text('暂无数据'),
-    );
-  }
-
-  /// 页面是否为空（默认 false，子类可重写）
-  bool get isEmptyContent => false;
-
-  /// 显示 SnackBar
-  void showSnackBar(String message, {Duration? duration}) {
-    if (!mounted) return;
-    ScaffoldMessenger.of(context).showSnackBar(
-      SnackBar(
-        content: Text(message),
-        duration: duration ?? const Duration(seconds: 2),
-      ),
-    );
-  }
-
-  /// 显示 Loading Dialog
-  void showLoadingDialog({String? message}) {
-    showDialog(
-      context: context,
-      barrierDismissible: false,
-      builder: (context) => AlertDialog(
-        content: Row(
-          children: [
-            const CircularProgressIndicator(),
-            const SizedBox(width: 16),
-            Text(message ?? '加载中...'),
-          ],
-        ),
-      ),
-    );
-  }
-
-  /// 隐藏 Loading Dialog
-  void hideLoadingDialog() {
-    if (mounted) {
-      Navigator.of(context).pop();
-    }
-  }
-}

package/templates/base_files/base_viewmodel.dart.template

@@ -1,77 +0,0 @@
-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

@@ -1,46 +0,0 @@
-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;
-  }
-}