flu-cli-core 1.0.4 → 1.1.0

package/templates/starter_project/lib/app.dart.template

@@ -0,0 +1,22 @@
+import 'package:flutter/material.dart';
+import 'core/index.dart';
+
+class App extends StatelessWidget {
+  const App({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      navigatorKey: NavigatorUtil.navigatorKey,
+      scaffoldMessengerKey: NavigatorUtil.scaffoldMessengerKey,
+      title: AppConstants.appName,
+      theme: AppTheme.light(),
+      darkTheme: AppTheme.dark(),
+      themeMode: ThemeMode.system,
+      initialRoute:
+          AppConfig.I.shouldShowSplash ? AppRoutes.splash : AppRoutes.home,
+      routes: AppRoutes.routes,
+      debugShowCheckedModeBanner: false,
+    );
+  }
+}

package/templates/starter_project/lib/main.dart.template

@@ -0,0 +1,34 @@
+import 'dart:async';
+
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+
+import 'app.dart';
+import 'core/index.dart';
+
+void main() {
+  runZonedGuarded(
+    () async => _bootstrap(),
+    (error, stackTrace) {
+      if (kDebugMode) {
+        debugPrint(
+          FlutterErrorDetails(exception: error, stack: stackTrace).toString(),
+        );
+      }
+    },
+  );
+}
+
+Future<void> _bootstrap() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  FlutterError.onError = (details) {
+    FlutterError.presentError(details);
+    Zone.current.handleUncaughtError(
+      details.exception,
+      details.stack ?? StackTrace.current,
+    );
+  };
+
+  await AppInitializer.init();
+  runApp(const App());
+}

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';