flu-cli-core 1.0.5 → 1.1.1

package/templates/template_clean/lib/features/user/presentation/pages/user_list_page.dart

@@ -0,0 +1,27 @@
+import 'package:flutter/material.dart';
+
+import '../../../../core/index.dart';
+import '../../data/models/user.dart';
+import '../viewmodels/user_list_viewmodel.dart';
+import '../widgets/user_item_card.dart';
+
+class UserListPage extends BaseListPage<User, UserListViewModel> {
+  const UserListPage({super.key});
+
+  @override
+  State<UserListPage> createState() => _UserListPageState();
+}
+
+class _UserListPageState
+    extends BaseListPageState<User, UserListViewModel, UserListPage> {
+  @override
+  String get title => '列表样板';
+
+  @override
+  UserListViewModel createViewModel() => UserListViewModel();
+
+  @override
+  Widget buildItem(BuildContext context, User item, int index) {
+    return UserItemCard(item: item);
+  }
+}

package/templates/template_clean/lib/features/user/presentation/viewmodels/user_list_viewmodel.dart

@@ -0,0 +1,88 @@
+import '../../../../core/index.dart';
+{{#if_network_example}}
+import '../../data/datasources/index.dart';
+{{/if_network_example}}
+import '../../data/models/user.dart';
+
+enum DemoListMode {
+  standard,
+  finite,
+  empty,
+  firstPageError,
+  loadMoreError,
+}
+
+class UserListViewModel extends BaseListViewModel<User> {
+{{#if_network_example}}
+  UserListViewModel({
+    HomeFeedService? feedService,
+  }) {
+    _feedService = feedService ?? HomeFeedService();
+    pageSize = 12;
+  }
+{{else}}
+  UserListViewModel() {
+    pageSize = 12;
+  }
+{{/if_network_example}}
+
+  final DemoListMode mode = _resolveMode();
+{{#if_network_example}}
+  late final HomeFeedService _feedService;
+{{/if_network_example}}
+
+  @override
+  Future<List<User>> fetchPage({
+    required int page,
+    required int pageSize,
+  }) async {
+{{#if_network_example}}
+    if (!AppConfig.I.useMockData) {
+      final posts = await _feedService.fetchPosts(page: page, pageSize: pageSize);
+      return posts.map(User.fromNetworkJson).toList();
+    }
+
+{{/if_network_example}}
+    await Future<void>.delayed(const Duration(milliseconds: 250));
+
+    if (mode == DemoListMode.empty && page == 1) {
+      return const <User>[];
+    }
+
+    if (mode == DemoListMode.firstPageError && page == 1) {
+      throw Exception('列表样板加载失败，请点击重试');
+    }
+
+    if (mode == DemoListMode.loadMoreError && page >= 2) {
+      throw Exception('分页加载失败，请重试');
+    }
+
+    if (mode == DemoListMode.finite && page >= 3) {
+      return List<User>.generate(
+        5,
+        (index) => User('样板记录 ${(page - 1) * pageSize + index + 1}'),
+      );
+    }
+
+    return List<User>.generate(
+      pageSize,
+      (index) => User('样板记录 ${(page - 1) * pageSize + index + 1}'),
+    );
+  }
+
+  static DemoListMode _resolveMode() {
+    switch (EnvConfig.demoListMode.trim().toLowerCase()) {
+      case 'standard':
+        return DemoListMode.standard;
+      case 'empty':
+        return DemoListMode.empty;
+      case 'first_page_error':
+        return DemoListMode.firstPageError;
+      case 'load_more_error':
+        return DemoListMode.loadMoreError;
+      case 'finite':
+      default:
+        return DemoListMode.finite;
+    }
+  }
+}

package/templates/template_clean/lib/features/user/presentation/widgets/user_item_card.dart

@@ -0,0 +1,24 @@
+import 'package:flutter/material.dart';
+
+import '../../data/models/user.dart';
+
+class UserItemCard extends StatelessWidget {
+  final User item;
+
+  const UserItemCard({
+    super.key,
+    required this.item,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return ListTile(
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(16)),
+      tileColor: Colors.white,
+      leading: CircleAvatar(child: Text(item.name.substring(0, 1))),
+      title: Text(item.name),
+      subtitle: Text('${item.name.toLowerCase()}@example.com'),
+      trailing: const Icon(Icons.chevron_right),
+    );
+  }
+}

package/templates/template_clean/lib/shared/extensions/index.dart

@@ -0,0 +1 @@
+// 跨 feature 共享扩展导出入口。

package/templates/template_clean/lib/shared/widgets/index.dart

@@ -0,0 +1 @@
+// 跨 feature 共享组件导出入口。

package/templates/template_lite/lib/models/index.dart

@@ -0,0 +1 @@
+export '../viewmodels/user_list_viewmodel.dart' show User;

package/templates/template_lite/lib/pages/home_page.dart

@@ -0,0 +1,290 @@
+import 'package:flutter/material.dart';
+
+import '../core/index.dart';
+{{#if_base_page}}
+import '../viewmodels/index.dart';
+{{/if_base_page}}
+
+{{#if_base_page}}
+class HomePage extends BasePage<HomeViewModel> {
+  const HomePage({super.key});
+
+  @override
+  State<HomePage> createState() => _HomePageState();
+}
+
+class _HomePageState extends BasePageState<HomeViewModel, HomePage> {
+  @override
+  bool get showAppBar => false;
+
+  @override
+  bool get safeAreaTop => false;
+
+  @override
+  bool get safeAreaBottom => false;
+
+  @override
+  Color? get backgroundColor => const Color(0xFFF4F7FB);
+
+  @override
+  HomeViewModel createViewModel() => HomeViewModel();
+
+  @override
+  Widget buildContent(BuildContext context) => const _HomePageBody();
+}
+{{else}}
+class HomePage extends StatefulWidget {
+  const HomePage({super.key});
+
+  @override
+  State<HomePage> createState() => _HomePageState();
+}
+
+class _HomePageState extends State<HomePage> {
+  @override
+  Widget build(BuildContext context) {
+    return const Scaffold(
+      backgroundColor: Color(0xFFF4F7FB),
+      body: _HomePageBody(),
+    );
+  }
+}
+{{/if_base_page}}
+
+class _HomePageBody extends StatelessWidget {
+  const _HomePageBody();
+
+  @override
+  Widget build(BuildContext context) {
+    final config = AppConfig.isInitialized ? AppConfig.I : null;
+    final appName = config?.appName ?? '{{projectDisplayName}}';
+    final envLabel = (config?.env.name ?? 'dev').toUpperCase();
+
+    return SafeArea(
+      child: CustomScrollView(
+        slivers: [
+          SliverToBoxAdapter(
+            child: Padding(
+              padding: const EdgeInsets.fromLTRB(20, 14, 20, 28),
+              child: Column(
+                crossAxisAlignment: CrossAxisAlignment.stretch,
+                children: [
+                  _buildTopBar(appName, envLabel),
+                  const SizedBox(height: 28),
+                  _buildSectionTitle('开始使用'),
+                  const SizedBox(height: 12),
+                  _buildActionList([
+                    _buildActionCard(
+                      icon: Icons.add_box_outlined,
+                      title: '创建第一个页面',
+                      description: '使用 flu add page 或 VSCode 右键生成业务页面',
+                      accentColor: const Color(0xFF2563EB),
+                      onTap: () => _showCreatePageHint(context),
+                    ),
+                    _buildActionCard(
+                      icon: Icons.privacy_tip_outlined,
+                      title: '协议与隐私',
+                      description: '查看用户协议、隐私政策和本地合规说明',
+                      accentColor: const Color(0xFF059669),
+                      onTap: () => _openAgreementMenu(context),
+                    ),
+                  ]),
+                  // 示例模块 - 由 CLI 在选择示例时动态注入
+                ],
+              ),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildTopBar(String appName, String envLabel) {
+    return Row(
+      children: [
+        Container(
+          width: 42,
+          height: 42,
+          decoration: BoxDecoration(
+            color: const Color(0xFF111827),
+            borderRadius: BorderRadius.circular(13),
+          ),
+          child: const Icon(
+            Icons.dashboard_customize_outlined,
+            color: Colors.white,
+            size: 21,
+          ),
+        ),
+        const SizedBox(width: 12),
+        Expanded(
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Text(
+                appName,
+                maxLines: 1,
+                overflow: TextOverflow.ellipsis,
+                style: const TextStyle(
+                  color: Color(0xFF111827),
+                  fontSize: 19,
+                  fontWeight: FontWeight.w800,
+                ),
+              ),
+              const SizedBox(height: 2),
+              Text(
+                'Lite · $envLabel',
+                style: const TextStyle(
+                  color: Color(0xFF64748B),
+                  fontSize: 12,
+                  fontWeight: FontWeight.w600,
+                ),
+              ),
+            ],
+          ),
+        ),
+      ],
+    );
+  }
+
+  Widget _buildSectionTitle(String title) {
+    return Text(
+      title,
+      style: const TextStyle(
+        color: Color(0xFF111827),
+        fontSize: 18,
+        fontWeight: FontWeight.w800,
+      ),
+    );
+  }
+
+  Widget _buildActionList(List<Widget> actions) {
+    return Column(
+      children: [
+        for (var i = 0; i < actions.length; i++) ...[
+          if (i > 0) const SizedBox(height: 10),
+          actions[i],
+        ],
+      ],
+    );
+  }
+
+  Widget _buildActionCard({
+    required IconData icon,
+    required String title,
+    required String description,
+    required Color accentColor,
+    required VoidCallback onTap,
+  }) {
+    return Material(
+      color: Colors.white,
+      borderRadius: BorderRadius.circular(16),
+      child: InkWell(
+        onTap: onTap,
+        borderRadius: BorderRadius.circular(16),
+        child: Container(
+          padding: const EdgeInsets.all(16),
+          decoration: BoxDecoration(
+            border: Border.all(color: const Color(0xFFE2E8F0)),
+            borderRadius: BorderRadius.circular(16),
+          ),
+          child: Row(
+            children: [
+              Container(
+                width: 42,
+                height: 42,
+                decoration: BoxDecoration(
+                  color: accentColor.withAlpha(20),
+                  borderRadius: BorderRadius.circular(12),
+                ),
+                child: Icon(icon, color: accentColor, size: 21),
+              ),
+              const SizedBox(width: 12),
+              Expanded(
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Text(
+                      title,
+                      maxLines: 1,
+                      overflow: TextOverflow.ellipsis,
+                      style: const TextStyle(
+                        color: Color(0xFF111827),
+                        fontSize: 15,
+                        fontWeight: FontWeight.w800,
+                      ),
+                    ),
+                    const SizedBox(height: 5),
+                    Text(
+                      description,
+                      maxLines: 2,
+                      overflow: TextOverflow.ellipsis,
+                      style: const TextStyle(
+                        color: Color(0xFF64748B),
+                        fontSize: 12,
+                        height: 1.35,
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+              const SizedBox(width: 8),
+              const Icon(
+                Icons.chevron_right,
+                color: Color(0xFF94A3B8),
+                size: 20,
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  void _showCreatePageHint(BuildContext context) {
+    ScaffoldMessenger.of(context).showSnackBar(
+      const SnackBar(
+        content: Text('在终端运行 flu add page，或在 VSCode 资源管理器右键生成页面。'),
+      ),
+    );
+  }
+
+  void _openAgreementMenu(BuildContext context) {
+    showModalBottomSheet<void>(
+      context: context,
+      showDragHandle: true,
+      backgroundColor: Colors.white,
+      builder: (sheetContext) {
+        return SafeArea(
+          child: Padding(
+            padding: const EdgeInsets.fromLTRB(16, 0, 16, 16),
+            child: Column(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                ListTile(
+                  leading: const Icon(Icons.assignment_outlined),
+                  title: const Text('用户协议'),
+                  onTap: () {
+                    Navigator.of(sheetContext).pop();
+                    _openAgreement(AgreementDocumentType.userAgreement);
+                  },
+                ),
+                ListTile(
+                  leading: const Icon(Icons.privacy_tip_outlined),
+                  title: const Text('隐私政策'),
+                  onTap: () {
+                    Navigator.of(sheetContext).pop();
+                    _openAgreement(AgreementDocumentType.privacyPolicy);
+                  },
+                ),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+
+  void _openAgreement(AgreementDocumentType type) {
+    NavigatorUtil.push(AgreementDocumentPage(type: type));
+  }
+}

package/templates/template_lite/lib/pages/index.dart

@@ -0,0 +1,3 @@
+export 'home_page.dart';
+export 'splash_page.dart';
+export 'user_list_page.dart';

package/templates/template_lite/lib/pages/splash_page.dart

@@ -0,0 +1,154 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+import '../core/index.dart';
+
+class SplashPage extends StatefulWidget {
+  const SplashPage({super.key});
+
+  @override
+  State<SplashPage> createState() => _SplashPageState();
+}
+
+class _SplashPageState extends State<SplashPage>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController _controller;
+  late final Animation<double> _opacity;
+  late final Animation<double> _scale;
+  bool _blocked = false;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 820),
+    );
+    _opacity = CurvedAnimation(
+      parent: _controller,
+      curve: Curves.easeOutCubic,
+    );
+    _scale = Tween<double>(begin: 0.92, end: 1.0).animate(
+      CurvedAnimation(
+        parent: _controller,
+        curve: Curves.easeOutBack,
+      ),
+    );
+    _controller.forward();
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      _checkPrivacy();
+    });
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  Future<void> _checkPrivacy() async {
+    if (!EnvConfig.enableAgreementDialog || AppConfig.I.hasAcceptedAgreement) {
+      _goHome();
+      return;
+    }
+
+    if (!mounted) return;
+    final agreed = await PrivacyDialog.show(context);
+    if (!mounted) return;
+
+    if (agreed == true) {
+      await AppConfig.acceptCurrentAgreement();
+      _goHome();
+      return;
+    }
+
+    _handleAgreementRejected();
+  }
+
+  void _goHome() {
+    if (!mounted) return;
+    NavigatorUtil.pushNamed(AppRoutes.home, clearStack: true);
+  }
+
+  void _handleAgreementRejected() {
+    if (kIsWeb || defaultTargetPlatform == TargetPlatform.iOS) {
+      setState(() {
+        _blocked = true;
+      });
+      return;
+    }
+    SystemNavigator.pop();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final colors = AppColorConfig.I;
+    return Scaffold(
+      backgroundColor: colors.background,
+      body: SafeArea(
+        child: Center(
+          child: FadeTransition(
+            opacity: _opacity,
+            child: ScaleTransition(
+              scale: _scale,
+              child: Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  Container(
+                    width: 84,
+                    height: 84,
+                    decoration: BoxDecoration(
+                      gradient: LinearGradient(
+                        begin: Alignment.topLeft,
+                        end: Alignment.bottomRight,
+                        colors: [
+                          colors.primary,
+                          colors.primary.withBlue(212),
+                        ],
+                      ),
+                      borderRadius: BorderRadius.circular(26),
+                      boxShadow: [
+                        BoxShadow(
+                          color: colors.primary.withAlpha(45),
+                          blurRadius: 24,
+                          offset: const Offset(0, 12),
+                        ),
+                      ],
+                    ),
+                    child: const Icon(
+                      Icons.blur_on_rounded,
+                      color: Colors.white,
+                      size: 38,
+                    ),
+                  ),
+                  const SizedBox(height: 22),
+                  Text(
+                    EnvConfig.appName,
+                    style: AppTextStyleConfig.I.titleLarge(
+                      fontWeight: FontWeight.w800,
+                    ),
+                  ),
+                  const SizedBox(height: 8),
+                  Text(
+                    _blocked ? '需要同意协议后继续使用' : '正在准备首页入口...',
+                    style: AppTextStyleConfig.I.bodySmall(
+                      color: colors.titleSecondary,
+                    ),
+                  ),
+                  if (_blocked) ...[
+                    const SizedBox(height: 18),
+                    FilledButton(
+                      onPressed: _checkPrivacy,
+                      child: const Text('重新阅读并同意'),
+                    ),
+                  ],
+                ],
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}

package/templates/template_lite/lib/pages/user_list_page.dart

@@ -0,0 +1,29 @@
+import 'package:flutter/material.dart';
+
+import '../core/index.dart';
+import '../viewmodels/index.dart';
+import '../widgets/index.dart';
+
+class UserListPage extends BaseListPage<User, UserListViewModel> {
+  const UserListPage({super.key});
+
+  @override
+  State<UserListPage> createState() => _UserListPageState();
+}
+
+class _UserListPageState
+    extends BaseListPageState<User, UserListViewModel, UserListPage> {
+  @override
+  String get title => '列表样板';
+
+  @override
+  bool get enableRefresh => true;
+
+  @override
+  UserListViewModel createViewModel() => UserListViewModel();
+
+  @override
+  Widget buildItem(BuildContext context, User item, int index) {
+    return UserItemWidget(item: item);
+  }
+}

package/templates/template_lite/lib/services/home_feed_service.dart

@@ -0,0 +1,37 @@
+{{#if_network_example}}
+import '../core/index.dart';
+
+class HomeFeedService {
+  HomeFeedService({
+    AppHttp? http,
+  }) : _http = http ?? AppHttp();
+
+  final AppHttp _http;
+
+  Future<List<Map<String, dynamic>>> fetchPosts({
+    required int page,
+    required int pageSize,
+  }) async {
+    final response = await _http.get<List<Map<String, dynamic>>>(
+      '/posts',
+      queryParameters: {
+        '_page': page,
+        '_limit': pageSize,
+      },
+      showError: false,
+      fromJson: (json) {
+        final list = json as List;
+        return list
+            .map((item) => Map<String, dynamic>.from(item as Map))
+            .toList();
+      },
+    );
+
+    if (response.isSuccess && response.data != null) {
+      return response.data!;
+    }
+
+    throw Exception(response.msg);
+  }
+}
+{{/if_network_example}}

package/templates/template_lite/lib/services/index.dart

@@ -0,0 +1,5 @@
+// 业务服务统一导出入口。
+// 当你选择网络示例后，会导出示例接口服务；真实业务服务可继续补充到这里。
+{{#if_network_example}}
+export 'home_feed_service.dart';
+{{/if_network_example}}

package/templates/template_lite/lib/utils/index.dart

@@ -0,0 +1 @@
+// 非 core 的页面级/业务级工具可在这里集中导出。