// 导入 Flutter 的 Material UI 包，用于构建用户界面
import 'package:flutter/material.dart';

// 导入 provider 包，用于状态管理
import 'package:provider/provider.dart';

// 导入各个示例页面的文件
import 'pages/basic_provider_page.dart';
import 'pages/multi_provider_page.dart';
import 'pages/change_notifier_page.dart';
import 'pages/consumer_page.dart';
import 'pages/selector_page.dart';
import 'pages/future_provider_page.dart';
import 'pages/stream_provider_page.dart';
import 'pages/proxy_provider_page.dart';

// Flutter 应用程序的入口点
void main() {
  // 运行 MyApp 小部件作为应用程序的根
  runApp(const MyApp());
}

// MyApp 是一个无状态小部件，是应用程序的根小部件
class MyApp extends StatelessWidget {
  // MyApp 的构造函数
  const MyApp({super.key});

  // build 方法描述了如何构建小部件的用户界面
  @override
  Widget build(BuildContext context) {
    // MaterialApp 是一个 Flutter 提供的便捷小部件，封装了应用程序通常需要的一些功能
    return MaterialApp(
      // 应用程序的标题，通常在任务切换器中显示
      title: 'Provider Examples',
      // 应用程序的主题
      theme: ThemeData(
        // 设置主题的主色调为蓝色
        primarySwatch: Colors.blue,
      ),
      // 应用程序启动时显示的首页
      home: const HomePage(),
    );
  }
}

// HomePage 是一个无状态小部件，用于显示 Provider 示例的列表
class HomePage extends StatelessWidget {
  // HomePage 的构造函数
  const HomePage({super.key});

  // build 方法描述了如何构建小部件的用户界面
  @override
  Widget build(BuildContext context) {
    // Scaffold 是 Material Design 布局结构的基本实现
    return Scaffold(
      // 应用程序栏
      appBar: AppBar(
        // 应用程序栏的标题
        title: const Text('Provider Examples'),
      ),
      // 页面的主体内容，使用 ListView 来显示可滚动的列表
      body: ListView(
        // 列表中的子项
        children: [
          // 列表项：基本 Provider 示例
          ListTile(
            // 列表项的标题
            title: const Text('Basic Provider'),
            // 点击列表项时的回调函数
            onTap: () => Navigator.push(
              context,
              // 创建一个 MaterialPageRoute 来导航到 BasicProviderPage
              MaterialPageRoute(builder: (_) => const BasicProviderPage()),
            ),
          ),
          // 列表项：MultiProvider 示例
          ListTile(
            title: const Text('MultiProvider'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const MultiProviderPage()),
            ),
          ),
          // 列表项：ChangeNotifierProvider 示例
          ListTile(
            title: const Text('ChangeNotifierProvider'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const ChangeNotifierPage()),
            ),
          ),
          // 列表项：Consumer 示例
          ListTile(
            title: const Text('Consumer'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const ConsumerPage()),
            ),
          ),
          // 列表项：Selector 示例
          ListTile(
            title: const Text('Selector'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const SelectorPage()),
            ),
          ),
          // 列表项：FutureProvider 示例
          ListTile(
            title: const Text('FutureProvider'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const FutureProviderPage()),
            ),
          ),
          // 列表项：StreamProvider 示例
          ListTile(
            title: const Text('StreamProvider'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const StreamProviderPage()),
            ),
          ),
          // 列表项：ProxyProvider 示例
          ListTile(
            title: const Text('ProxyProvider'),
            onTap: () => Navigator.push(
              context,
              MaterialPageRoute(builder: (_) => const ProxyProviderPage()),
            ),
          ),
        ],
      ),
    );
  }
}