flu-cli-core 1.0.5 → 1.1.1

package/templates/starter_project/lib/pages/splash_page.dart.template

@@ -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_clean/lib/features/home/data/datasources/index.dart

@@ -0,0 +1 @@
+// Home datasources 导出入口。

package/templates/template_clean/lib/features/home/data/models/index.dart

@@ -0,0 +1 @@
+// Home data models 导出入口。

package/templates/template_clean/lib/features/home/domain/index.dart

@@ -0,0 +1 @@
+// Home domain 导出入口。

package/templates/template_clean/lib/features/home/presentation/pages/home_page.dart

@@ -0,0 +1,290 @@
+import 'package:flutter/material.dart';
+
+import '../../../../core/index.dart';
+{{#if_base_page}}
+import '../viewmodels/home_viewmodel.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(
+                'Clean · $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_clean/lib/features/home/presentation/pages/index.dart

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

package/templates/template_clean/lib/features/home/presentation/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_clean/lib/features/home/presentation/viewmodels/home_viewmodel.dart

@@ -0,0 +1,17 @@
+{{#if_base_viewmodel}}
+import '../../../../core/index.dart';
+
+class HomeViewModel extends BaseViewModel {
+  @override
+  Future<void> onInit() async {
+    await super.onInit();
+    setState(ViewState.success);
+  }
+}
+{{else}}
+import 'package:flutter/foundation.dart';
+
+class HomeViewModel extends ChangeNotifier {
+  Future<void> onInit() async {}
+}
+{{/if_base_viewmodel}}

package/templates/template_clean/lib/features/index.dart

@@ -0,0 +1,2 @@
+export 'home/presentation/pages/index.dart';
+export 'user/presentation/pages/index.dart';

package/templates/template_clean/lib/features/user/data/datasources/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_clean/lib/features/user/data/datasources/index.dart

@@ -0,0 +1,4 @@
+// User datasources 导出入口。
+{{#if_network_example}}
+export 'home_feed_service.dart';
+{{/if_network_example}}

package/templates/template_clean/lib/features/user/data/models/index.dart

@@ -0,0 +1,3 @@
+{{#if_network_example}}
+export 'user.dart';
+{{/if_network_example}}

package/templates/template_clean/lib/features/user/data/models/user.dart

@@ -0,0 +1,15 @@
+class User {
+  final String name;
+
+  const User(this.name);
+
+{{#if_network_example}}
+  factory User.fromNetworkJson(Map<String, dynamic> json) {
+    final id = json['id'] as int? ?? 0;
+    final title = json['title'] as String? ?? '网络记录 #$id';
+    final body = json['body'] as String? ?? '';
+
+    return User(title.isNotEmpty ? title : body);
+  }
+{{/if_network_example}}
+}

package/templates/template_clean/lib/features/user/domain/index.dart

@@ -0,0 +1 @@
+// User domain 导出入口。

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

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