flu-cli-core 1.0.0

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

@@ -0,0 +1,40 @@
+import 'package:flutter/material.dart';
+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/core_files/utils/index.dart.template

@@ -0,0 +1,2 @@
+export 'loading_util.dart';
+export 'toast_util.dart';

package/templates/core_files/utils/loading_util.dart.template

@@ -0,0 +1,55 @@
+import 'package:flutter/material.dart';
+
+/// Loading 工具类 - 基于 Overlay 的原生实现
+/// 
+/// 优点：
+/// 1. 零第三方依赖：保持项目纯洁，不增加 pubspec.yaml 负担。
+/// 2. 灵活性高：完全基于 Flutter 原生机制，易于自定义 UI 样式。
+/// 3. 轻量级：不占用额外打包体积。
+class LoadingUtil {
+  static OverlayEntry? _overlayEntry;
+
+  /// 显示 Loading
+  /// 
+  /// [context] 上下文
+  /// [message] 加载提示文字
+  static void show(BuildContext context, {String? message}) {
+    if (_overlayEntry != null) return;
+
+    _overlayEntry = OverlayEntry(
+      builder: (context) => Material(
+        color: Colors.black54,
+        child: Center(
+          child: Container(
+            padding: const EdgeInsets.all(20),
+            decoration: BoxDecoration(
+              color: Colors.white,
+              borderRadius: BorderRadius.circular(8),
+            ),
+            child: Column(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                const CircularProgressIndicator(),
+                if (message != null) ...[
+                  const SizedBox(height: 16),
+                  Text(
+                    message,
+                    style: const TextStyle(fontSize: 14, color: Colors.black),
+                  ),
+                ],
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+
+    Overlay.of(context).insert(_overlayEntry!);
+  }
+
+  /// 隐藏 Loading
+  static void dismiss() {
+    _overlayEntry?.remove();
+    _overlayEntry = null;
+  }
+}

package/templates/core_files/utils/toast_util.dart.template

@@ -0,0 +1,128 @@
+import 'package:flutter/material.dart';
+{{#if_getx}}
+import 'package:get/get.dart';
+{{else}}
+import '../router/navigator_util.dart';
+{{/if_getx}}
+
+/// Toast 工具类 - 自动适配状态管理器
+///
+/// Material 模式: 基于 SnackBar
+/// GetX 模式: 基于 Get.snackbar
+///
+/// 优点：
+/// 1. 零第三方依赖(GetX 除外)
+/// 2. 无需 BuildContext，全局可调用
+/// 3. 自动清除旧消息，防止堆叠
+class ToastUtil {
+  /// 显示 Toast 消息
+  ///
+  /// [message] 提示消息
+  /// [duration] 显示时长，默认 2 秒
+  /// [showCloseIcon] 是否显示关闭图标，默认 true
+  static void show(
+    String message, {
+    Duration duration = const Duration(seconds: 2),
+    bool showCloseIcon = true,
+  }) {
+    if (message.isEmpty) return;
+
+    {{#if_getx}}
+    // GetX 模式: 使用 Get.snackbar
+    Get.snackbar(
+      '',
+      message,
+      snackPosition: SnackPosition.BOTTOM,
+      duration: duration,
+      margin: const EdgeInsets.all(16),
+      borderRadius: 8,
+      isDismissible: true,
+      dismissDirection: DismissDirection.horizontal,
+      showProgressIndicator: false,
+      titleText: const SizedBox.shrink(), // 不显示标题
+      messageText: Text(
+        message,
+        style: const TextStyle(color: Colors.white),
+      ),
+    );
+    {{else}}
+    // Material 模式: 使用 ScaffoldMessenger
+    final state = NavigatorUtil.scaffoldMessengerKey.currentState;
+    if (state == null) {
+      debugPrint('⚠️ 无法显示Toast, ScaffoldMessengerState为空: $message');
+      return;
+    }
+
+    // 清除之前的 SnackBar，防止堆叠
+    state.clearSnackBars();
+
+    // 显示新的 SnackBar
+    state.showSnackBar(
+      SnackBar(
+        content: Text(message),
+        behavior: SnackBarBehavior.floating, // 浮动样式
+        duration: duration,
+        showCloseIcon: showCloseIcon,
+      ),
+    );
+    {{/if_getx}}
+  }
+
+  /// 显示成功消息
+  static void success(String message) {
+    {{#if_getx}}
+    Get.snackbar(
+      '成功',
+      message,
+      snackPosition: SnackPosition.BOTTOM,
+      backgroundColor: Colors.green,
+      colorText: Colors.white,
+      icon: const Icon(Icons.check_circle, color: Colors.white),
+      duration: const Duration(seconds: 2),
+      margin: const EdgeInsets.all(16),
+      borderRadius: 8,
+    );
+    {{else}}
+    show(message);
+    {{/if_getx}}
+  }
+
+  /// 显示错误消息
+  static void error(String message) {
+    {{#if_getx}}
+    Get.snackbar(
+      '错误',
+      message,
+      snackPosition: SnackPosition.BOTTOM,
+      backgroundColor: Colors.red,
+      colorText: Colors.white,
+      icon: const Icon(Icons.error, color: Colors.white),
+      duration: const Duration(seconds: 3),
+      margin: const EdgeInsets.all(16),
+      borderRadius: 8,
+    );
+    {{else}}
+    show(message);
+    {{/if_getx}}
+  }
+
+  /// 显示警告消息
+  static void warning(String message) {
+    {{#if_getx}}
+    Get.snackbar(
+      '警告',
+      message,
+      snackPosition: SnackPosition.BOTTOM,
+      backgroundColor: Colors.orange,
+      colorText: Colors.white,
+      icon: const Icon(Icons.warning, color: Colors.white),
+      duration: const Duration(seconds: 2),
+      margin: const EdgeInsets.all(16),
+      borderRadius: 8,
+    );
+    {{else}}
+    show(message);
+    {{/if_getx}}
+  }
+}
+

package/templates/examples/eg_list_page.dart.template

@@ -0,0 +1,340 @@
+import 'package:flutter/material.dart';
+import '{{CORE_IMPORT}}';
+
+{{#if_clean}}
+import '{{DATA_IMPORT}}';
+{{else}}
+import '{{MODELS_IMPORT}}';
+{{/if_clean}}
+import '{{VIEWMODELS_IMPORT}}';
+
+/// 示例：图片列表页
+class EgListPage extends BaseListPage<TuChongItem, EgListViewModel> {
+  const EgListPage({super.key});
+
+  @override
+  State<EgListPage> createState() => _EgListPageState();
+}
+
+class _EgListPageState
+    extends BaseListPageState<TuChongItem, EgListViewModel, EgListPage> {
+  @override
+  String get title => '图片列表';
+  @override
+  bool get enableRefresh => true;
+  @override
+  EgListViewModel createViewModel() => EgListViewModel();
+
+  @override
+  Widget buildItem(BuildContext context, TuChongItem item, int index) {
+    Widget body = Container();
+
+    body = Column(
+      mainAxisAlignment: MainAxisAlignment.start,
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        _buildUserInfo(item),
+        const SizedBox(
+          height: 10,
+        ),
+        _buildTagsWidget(item),
+        ExampleTuItmeImagelessV(tuChongItem: item),
+      ],
+    );
+    body = Container(
+      margin: const EdgeInsets.only(
+        left: 15,
+        right: 15,
+        top: 15,
+      ),
+      padding: const EdgeInsets.all(15),
+      decoration: BoxDecoration(
+        color: Colors.white,
+        borderRadius: BorderRadius.circular(10),
+        boxShadow: const [
+          BoxShadow(
+            color: Colors.black12,
+            offset: Offset(0, 0),
+            blurRadius: 3,
+          ),
+        ],
+      ),
+      child: body,
+    );
+    return body;
+  }
+
+  // 构建用户信息
+  _buildUserInfo(TuChongItem item) {
+    final Widget body = Row(
+      children: [
+        _buildImageWidget(
+          url: item.imageUrl,
+        ),
+        const SizedBox(
+          width: 10,
+        ),
+        Expanded(
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            mainAxisAlignment: MainAxisAlignment.center,
+            children: [
+              Text(
+                item.site?.name ?? AppConstants.appName,
+                style: const TextStyle(
+                  fontSize: 16,
+                  fontWeight: FontWeight.bold,
+                ),
+              ),
+              if (item.site?.description?.isNotEmpty ?? false)
+                Text(
+                  item.site?.description ?? '',
+                  style: const TextStyle(
+                    fontSize: 14,
+                    color: Colors.grey,
+                  ),
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                ),
+            ],
+          ),
+        ),
+      ],
+    );
+    return body;
+  }
+
+  // 构建标签
+  _buildTagsWidget(TuChongItem tuChongItem) {
+    Widget body = Wrap(
+      spacing: 6,
+      runSpacing: 6,
+      children: [
+        ...List.generate(
+          tuChongItem.tagColors?.length ?? 0,
+          (index) {
+            final Widget body = Container(
+              decoration: BoxDecoration(
+                color: tuChongItem.tagColors?[index],
+                borderRadius: BorderRadius.circular(
+                  4,
+                ),
+              ),
+              padding: const EdgeInsets.symmetric(
+                horizontal: 6,
+              ),
+              child: Text(
+                tuChongItem.tags?[index] ?? '',
+                style: const TextStyle(
+                  fontSize: 12,
+                  color: Colors.white,
+                ),
+              ),
+            );
+            return body;
+          },
+        ),
+      ],
+    );
+    body = Padding(
+      padding: const EdgeInsets.only(bottom: 10),
+      child: body,
+    );
+    return body;
+  }
+}
+
+class ExampleTuItmeImagelessV extends StatelessWidget {
+  const ExampleTuItmeImagelessV({
+    super.key,
+    required this.tuChongItem,
+    this.heroTag = 'tuChongItem',
+    this.type = 0,
+  });
+  final TuChongItem tuChongItem;
+
+  final String heroTag;
+  final int type;
+  @override
+  Widget build(BuildContext context) {
+    Widget body = configImageListWidget();
+
+    body = ClipRRect(
+      borderRadius: BorderRadius.circular(10),
+      child: body,
+    );
+    body = Container(
+      padding: const EdgeInsets.all(5),
+      decoration: BoxDecoration(
+        color: Colors.lightBlue.withOpacity(0.1),
+        borderRadius: BorderRadius.circular(
+          10,
+        ),
+      ),
+      child: body,
+    );
+    return body;
+  }
+
+  /// 配置图片数组视图
+  configImageListWidget() {
+    if (tuChongItem.realImages?.length == 1) {
+      return configOnlyOneImageWidget();
+    } else {
+      return GridView.count(
+        crossAxisCount: tuChongItem.crossAxisCount ?? 1,
+        childAspectRatio: tuChongItem.crossAxisCount == 2 ? 1 : 1,
+        crossAxisSpacing: 5.0,
+        mainAxisSpacing: 5.0,
+        shrinkWrap: true,
+        physics: const NeverScrollableScrollPhysics(),
+        children: [
+          ...List.generate(
+              tuChongItem.realImages!.length > 9
+                  ? 9
+                  : tuChongItem.realImages!.length, (index) {
+            final Widget body = configImageItem(
+              imageUrl: tuChongItem.realImages![index],
+              index: index,
+              allNum: tuChongItem.images?.length ?? 0,
+              heroTag: heroTag,
+            );
+            return body;
+          }),
+        ],
+      );
+    }
+  }
+
+  /// 配置单图视图
+  configOnlyOneImageWidget() {
+    final Widget body = LayoutBuilder(
+      builder: (p0, p1) {
+        final ImageItem imageItem = tuChongItem.images![0];
+        final double ratio = (imageItem.width ?? 0) / (imageItem.height ?? 1);
+        final double imageH = p1.maxWidth / ratio;
+        final Widget body = configTuchongImageWidget(
+          url: imageItem.imageUrl,
+          width: p1.maxWidth,
+          height: imageH,
+          index: 0,
+          heroTag: heroTag,
+        );
+        return body;
+      },
+    );
+    return body;
+  }
+
+  /// 配置图片item
+  configImageItem({
+    required String imageUrl,
+    required int index,
+    required int allNum,
+    String? heroTag,
+  }) {
+    Widget body = LayoutBuilder(
+      builder: (p0, p1) {
+        /// 加载图片
+        final Widget body = configTuchongImageWidget(
+          url: imageUrl,
+          heroTag: heroTag,
+          width: p1.maxWidth,
+          height: p1.maxHeight,
+          index: index,
+          isTap: false,
+        );
+        return body;
+      },
+    );
+    if (index == 8 && allNum > (index + 1)) {
+      body = Stack(
+        children: [
+          body,
+          Positioned.fill(
+            child: configResidueNumWidget(
+              num: allNum - 9,
+            ),
+          ),
+        ],
+      );
+    }
+
+    return body;
+  }
+
+  /// 配置图片显示视图
+  configTuchongImageWidget({
+    String? url,
+    double? width,
+    double? height,
+    String? heroTag,
+    bool isTap = true,
+    required int index,
+  }) {
+    final Widget body = url != null
+        ? _buildImageWidget(
+            url: url,
+            width: width,
+            height: height,
+            borderRadius: 6,
+          )
+        : Container();
+
+    return body;
+  }
+
+  /// 创建图片剩余个数
+  configResidueNumWidget({required int num}) {
+    Widget body = Text(
+      '+$num',
+      style: const TextStyle(
+        fontSize: 16,
+        color: Colors.white,
+      ),
+    );
+    body = Container(
+      decoration: const BoxDecoration(
+        color: Colors.black12,
+      ),
+      alignment: Alignment.center,
+      child: body,
+    );
+    return body;
+  }
+}
+
+/// 配置用户头像
+_buildImageWidget({
+  required String url,
+  double? width = 50,
+  double? height = 50,
+  double borderRadius = 50,
+}) {
+  if (url.isEmpty) {
+    return SizedBox(
+      width: width,
+      height: height,
+    );
+  }
+  Widget body = Image.network(
+    url,
+    width: width,
+    height: height,
+    fit: BoxFit.cover,
+    errorBuilder: (context, error, stackTrace) {
+      return Container(
+        width: width,
+        height: height,
+        color: Colors.grey[200],
+        child: const Icon(Icons.broken_image, color: Colors.grey),
+      );
+    },
+  );
+  body = ClipRRect(
+    borderRadius: BorderRadius.circular(borderRadius),
+    child: body,
+  );
+
+  return body;
+}

package/templates/examples/eg_list_viewmodel.dart.template

@@ -0,0 +1,31 @@
+import '{{CORE_IMPORT}}';
+{{#if_clean}}
+import '{{DATA_IMPORT}}';
+{{else}}
+import '{{MODELS_IMPORT}}';
+import '{{SERVICES_IMPORT}}';
+{{/if_clean}}
+
+
+
+/// 图片列表 ViewModel
+class EgListViewModel extends BaseListViewModel<TuChongItem> {
+  final EgService _photoService = EgService();
+  @override
+  int get pageSize => 10;
+  @override
+  Future<List<TuChongItem>> fetchPage({
+    required int page,
+    required int pageSize,
+  }) async {
+    int? lastPostId;
+    if (items.length > 1) {
+      lastPostId = items.last.postId;
+    }
+    return await _photoService.getTuChongList(
+      page: page,
+      pageSize: pageSize,
+      lastPostId: lastPostId,
+    );
+  }
+}

package/templates/examples/eg_service.dart.template

@@ -0,0 +1,78 @@
+import 'package:flutter/foundation.dart';
+import '{{CORE_IMPORT}}';
+{{#if_clean}}
+import '{{DATA_IMPORT}}';
+{{else}}
+import '{{MODELS_IMPORT}}';
+{{/if_clean}}
+
+class EgService {
+  final AppHttp _http;
+  final bool useMock;
+
+  EgService({
+    AppHttp? http,
+    bool? useMock,
+  })  : _http = http ?? AppHttp(),
+        useMock = useMock ?? AppConfig.I.useMockData;
+
+  Future<List<TuChongItem>> getTuChongList({
+    required int page,
+    int pageSize = 10,
+    int? lastPostId,
+  }) async {
+    // 如果开启了 Mock 模式，从 mockData 加载数据
+    if (useMock) {
+      return _loadMockData(page, pageSize);
+    }
+
+    Map<String, dynamic> queryParameters = {};
+    if (lastPostId != null) {
+      queryParameters = {
+        'post_id': lastPostId,
+        'page': page,
+        'type': 'loadmore',
+      };
+    }
+
+    final response = await _http.get(
+      '/feed-app',
+      queryParameters: queryParameters,
+    );
+
+    if (response.isSuccess && response.data is List) {
+      return (response.data as List)
+          .map((e) => TuChongItem.fromJson(e as Map<String, dynamic>))
+          .toList();
+    }
+
+    // 降级处理：请求失败时加载模拟数据
+    return _loadMockData(1, pageSize);
+  }
+
+  /// 加载本地 Mock 数据
+  List<TuChongItem> _loadMockData(int page, int pageSize) {
+    try {
+      // 从 mock_data.dart 获取数据
+      // 结构为 { 'feedList': [...] }
+      final List? feedList = mock['feedList'];
+      if (feedList != null) {
+        // 模拟分页
+        final int start = (page - 1) * pageSize;
+        if (start >= feedList.length) return [];
+
+        final int end = start + pageSize > feedList.length
+            ? feedList.length
+            : start + pageSize;
+        final subList = feedList.sublist(start, end);
+
+        return subList
+            .map((e) => TuChongItem.fromJson(e as Map<String, dynamic>))
+            .toList();
+      }
+    } catch (e) {
+      debugPrint('Mock 数据解析错误: $e');
+    }
+    return [];
+  }
+}