docs(code): add doc comments to all public widgets and providers

Document MyApp, MainPage, PokemonImage/Tile/TypeWidget, and the gen-filter
and theme providers/notifiers. Every public class/enum now has a /// doc.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

lib/presentation/providers/gen_filter_provider.dart

@@ -3,6 +3,8 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 import '../../core/config/app_constants.dart';
 
+/// Gère les générations activées pour le tirage et fournit un id aléatoire dans celles-ci.
+/// La sélection est persistée dans les préférences.
 class GenFilterNotifier extends Notifier<Set<int>> {
   @override
   Set<int> build() {
@@ -50,5 +52,6 @@ class GenFilterNotifier extends Notifier<Set<int>> {
   }
 }
 
+/// Ensemble des index de générations actuellement activées pour le jeu.
 final genFilterProvider =
     NotifierProvider<GenFilterNotifier, Set<int>>(GenFilterNotifier.new);

lib/presentation/providers/theme_provider.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 
+/// Palette de couleurs nommée de l'application (couleur primaire + surface de fond).
 class AppPalette {
   final String name;
   final Color primary;
@@ -24,6 +25,7 @@ const List<AppPalette> appPalettes = [
 
 const String _prefsPaletteIndex = 'palette_index';
 
+/// Gère l'index de la palette sélectionnée, persistée dans les préférences.
 class ThemeNotifier extends Notifier<int> {
   @override
   int build() {
@@ -46,4 +48,5 @@ class ThemeNotifier extends Notifier<int> {
   AppPalette get current => appPalettes[state];
 }
 
+/// Index de la palette de couleurs active.
 final themeProvider = NotifierProvider<ThemeNotifier, int>(ThemeNotifier.new);