// Navigator 1.0 기본 사용법
// 화면 이동 (push)
Navigator.push(
  context,
  MaterialPageRoute(builder: (context) => DetailScreen()),
);

// 화면 뒤로 가기 (pop)
Navigator.pop(context);

// 이전 화면에 데이터 전달하며 pop
Navigator.pop(context, '결과 데이터');

// Named Route 방식
Navigator.pushNamed(context, '/detail', arguments: {'id': 123});

// 모든 화면 제거하고 새 화면으로
Navigator.pushAndRemoveUntil(
  context,
  MaterialPageRoute(builder: (context) => HomeScreen()),
  (route) => false,
);

// go_router 설정 예시
final router = GoRouter(
  initialLocation: '/',
  routes: [
    GoRoute(
      path: '/',
      builder: (context, state) => HomeScreen(),
    ),
    GoRoute(
      path: '/profile/:userId',
      builder: (context, state) {
        final userId = state.pathParameters['userId']!;
        return ProfileScreen(userId: userId);
      },
    ),
    ShellRoute(  // 하단 탭 바 유지하면서 내부 라우팅
      builder: (context, state, child) => MainShell(child: child),
      routes: [
        GoRoute(path: '/home', builder: (_, __) => HomeTab()),
        GoRoute(path: '/search', builder: (_, __) => SearchTab()),
        GoRoute(path: '/settings', builder: (_, __) => SettingsTab()),
      ],
    ),
  ],
);

// 사용 방법
context.go('/profile/123');      // 이동
context.push('/profile/123');    // 스택에 추가
context.pop();                   // 뒤로 가기

// AnimatedContainer 예시
class AnimatedBox extends StatefulWidget {
  @override
  State<AnimatedBox> createState() => _AnimatedBoxState();
}

class _AnimatedBoxState extends State<AnimatedBox> {
  bool _isExpanded = false;

  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: () => setState(() => _isExpanded = !_isExpanded),
      child: AnimatedContainer(
        duration: Duration(milliseconds: 300),
        curve: Curves.easeInOut,  // 애니메이션 커브
        width: _isExpanded ? 200 : 100,
        height: _isExpanded ? 200 : 100,
        color: _isExpanded ? Colors.purple : Colors.blue,
        child: Center(child: Text('탭해봐!')),
      ),
    );
  }
}

// 명시적 애니메이션 예시 — 회전하는 로고
class RotatingLogo extends StatefulWidget {
  @override
  State<RotatingLogo> createState() => _RotatingLogoState();
}

class _RotatingLogoState extends State<RotatingLogo>
    with SingleTickerProviderStateMixin {
  late AnimationController _controller;
  late Animation<double> _rotation;

  @override
  void initState() {
    super.initState();
    _controller = AnimationController(
      duration: Duration(seconds: 2),
      vsync: this,
    )..repeat();  // 무한 반복

    _rotation = Tween<double>(begin: 0, end: 2 * 3.14159)
        .animate(CurvedAnimation(
          parent: _controller,
          curve: Curves.linear,
        ));
  }

  @override
  void dispose() {
    _controller.dispose();  // 메모리 누수 방지!
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return AnimatedBuilder(
      animation: _rotation,
      builder: (context, child) {
        return Transform.rotate(
          angle: _rotation.value,
          child: child,
        );
      },
      child: FlutterLogo(size: 100),
    );
  }
}

// Dio를 사용한 API 통신 예시
import 'package:dio/dio.dart';

class ApiService {
  final Dio _dio;

  ApiService() : _dio = Dio(BaseOptions(
    baseUrl: 'https://api.example.com',
    connectTimeout: Duration(seconds: 5),
    receiveTimeout: Duration(seconds: 10),
    headers: {'Content-Type': 'application/json'},
  )) {
    // 인터셉터 추가 (토큰 자동 주입)
    _dio.interceptors.add(InterceptorsWrapper(
      onRequest: (options, handler) {
        options.headers['Authorization'] = 'Bearer ${getToken()}';
        handler.next(options);
      },
      onError: (error, handler) {
        if (error.response?.statusCode == 401) {
          // 토큰 만료 처리
          refreshToken();
        }
        handler.next(error);
      },
    ));
  }

  Future<List<User>> getUsers() async {
    try {
      final response = await _dio.get('/users');
      return (response.data as List)
          .map((json) => User.fromJson(json))
          .toList();
    } on DioException catch (e) {
      throw ApiException(e.message ?? '알 수 없는 오류');
    }
  }
}

// Hive 사용 예시
import 'package:hive_flutter/hive_flutter.dart';

// 데이터 모델 정의
@HiveType(typeId: 0)
class User extends HiveObject {
  @HiveField(0)
  String name;
  
  @HiveField(1)
  String email;
  
  User({required this.name, required this.email});
}

// 초기화 및 사용
await Hive.initFlutter();
Hive.registerAdapter(UserAdapter());
final box = await Hive.openBox<User>('users');

// 저장
await box.add(User(name: '홍길동', email: 'hong@example.com'));

// 조회
final users = box.values.toList();

// 삭제
await box.deleteAt(0);

// MediaQuery로 화면 크기 가져오기
Widget build(BuildContext context) {
  final screenWidth = MediaQuery.of(context).size.width;
  final screenHeight = MediaQuery.of(context).size.height;
  final isTablet = screenWidth > 600;
  final isDesktop = screenWidth > 1200;

  return isDesktop
      ? DesktopLayout()
      : isTablet
          ? TabletLayout()
          : MobileLayout();
}

// LayoutBuilder로 부모 위젯 크기 기반 반응형
LayoutBuilder(
  builder: (context, constraints) {
    if (constraints.maxWidth > 600) {
      return GridView.count(crossAxisCount: 3);
    } else {
      return ListView();
    }
  },
)

// 단위 테스트 예시
import 'package:flutter_test/flutter_test.dart';

void main() {
  group('Counter 테스트', () {
    test('초기값은 0이어야 해', () {
      final counter = Counter();
      expect(counter.value, equals(0));
    });

    test('increment 호출 시 1 증가해야 해', () {
      final counter = Counter();
      counter.increment();
      expect(counter.value, equals(1));
    });
  });
}

// 위젯 테스트 예시
testWidgets('버튼 탭 시 카운터 증가', (WidgetTester tester) async {
  await tester.pumpWidget(MaterialApp(home: CounterPage()));
  
  expect(find.text('0'), findsOneWidget);
  
  await tester.tap(find.byIcon(Icons.add));
  await tester.pump();  // 리빌드 트리거
  
  expect(find.text('1'), findsOneWidget);
});

// ✅ 성능 최적화 팁들

// 1. const 위젯 사용 — 리빌드 방지
const Text('변하지 않는 텍스트')  // ✅
Text('변하지 않는 텍스트')         // ❌ (불필요한 리빌드)

// 2. ListView.builder 사용 — 화면에 보이는 것만 렌더링
ListView.builder(
  itemCount: items.length,
  itemBuilder: (context, index) => ItemWidget(item: items[index]),
)

// 3. RepaintBoundary — 특정 위젯의 리페인트 격리
RepaintBoundary(
  child: ComplexAnimationWidget(),
)

// 4. 이미지 캐싱 — cached_network_image 패키지 사용
CachedNetworkImage(
  imageUrl: 'https://example.com/image.jpg',
  placeholder: (context, url) => CircularProgressIndicator(),
  errorWidget: (context, url, error) => Icon(Icons.error),
)

// 5. 선택적 리빌드 — Consumer 또는 Selector 사용 (Provider)
Selector<UserModel, String>(
  selector: (context, user) => user.name,  // name만 변경 시 리빌드
  builder: (context, name, child) => Text(name),
)

lib/
├── core/                    # 공통 유틸리티
│   ├── constants/           # 상수 (색상, 크기, API URL 등)
│   ├── errors/              # 에러 처리
│   ├── network/             # HTTP 클라이언트 설정
│   ├── router/              # 라우팅 설정
│   └── theme/               # 앱 테마
│
├── features/                # 기능별 모듈
│   ├── auth/                # 인증 기능
│   │   ├── data/            # 데이터 레이어
│   │   │   ├── datasources/ # API, 로컬 DB
│   │   │   ├── models/      # JSON 직렬화 모델
│   │   │   └── repositories/# Repository 구현체
│   │   ├── domain/          # 도메인 레이어
│   │   │   ├── entities/    # 순수 비즈니스 객체
│   │   │   ├── repositories/# Repository 인터페이스
│   │   │   └── usecases/    # 비즈니스 로직
│   │   └── presentation/    # UI 레이어
│   │       ├── pages/       # 화면
│   │       ├── widgets/     # 재사용 위젯
│   │       └── providers/   # 상태 관리
│   │
│   ├── home/                # 홈 기능
│   └── profile/             # 프로필 기능
│
└── main.dart                # 앱 진입점