// ✅ Entity example
@freezed
class User with _$User {
  const factory User({
    required int id,
    required String name,
  }) = _User;
}

// ✅ Repository Interface example
abstract interface class IUserRepository {
  Future<Either<Failure, User>> getUser(int id);
}

// ✅ UseCase example (Optional Constructor Injection)
class GetUserUseCase {
  const GetUserUseCase([IUserRepository? repository])
      : _repository = repository ?? const UserRepository();

  final IUserRepository _repository;

  Future<Either<Failure, User>> call(GetUserParams params) async {
    return _repository.getUser(params.id);
  }
}

# Code generation commands
melos run generate:{feature_name}

# Or full build
melos run build

test('should return user when repository succeeds', () async {
  // Arrange
  when(() => mockRepository.getUser(any()))
    .thenAnswer((_) async => Right(testUser));

  // Act
  final result = await useCase(GetUserParams(id: 1));

  // Assert
  expect(result, Right(testUser));
  verify(() => mockRepository.getUser(1)).called(1);
});

blocTest<HomeBloC, HomeState>(
  'emits [loading, loaded] when LoadUser succeeds',
  setUp: () {
    when(() => mockGetUserUseCase(any()))
      .thenAnswer((_) async => Right(testUser));
  },
  build: () => HomeBloC(getUserUseCase: mockGetUserUseCase),  // ✅ Direct mock injection
  act: (bloc) => bloc.add(LoadUser(id: 1)),
  expect: () => [HomeLoading(), HomeLoaded(testUser)],
);

# Single feature test
flutter test feature/{type}/{feature_name}/test/

# Coverage report
melos run test:with-html-coverage

feat(auth): ✨ Add social login feature
fix(home): 🐛 Fix feed infinite scroll bug
refactor(store): ♻️ Optimize product list query

✅ Correct dependency direction:
Presentation → Domain → Data

❌ Incorrect dependency:
Presentation → Data (bypassing Domain)
Feature A → Feature B (direct reference)

// ✅ Correct BLoC pattern
@freezed
class HomeEvent with _$HomeEvent {
  const factory HomeEvent.loadUser(int id) = LoadUser;
}

@freezed
class HomeState with _$HomeState {
  const factory HomeState.initial() = _Initial;
  const factory HomeState.loading() = _Loading;
  const factory HomeState.loaded(User user) = _Loaded;
  const factory HomeState.error(Failure failure) = _Error;
}

# Secret search
grep -r  " api_key\|secret\|password\|token "   --include= " *.dart "

# Check PR status
gh pr checks [PR_NUMBER]

# View PR in browser
gh pr view [PR_NUMBER] --web

# Run analysis
melos run analyze

# Formatting
melos run format