refactor: continue code cleanup

lib/providers/explore_provider.dart

@@ -5,7 +5,6 @@ import 'package:spotiflac_android/providers/extension_provider.dart';
 
 final _log = AppLogger('ExploreProvider');
 
-/// Represents an item in a Spotify home section
 class ExploreItem {
   final String id;
   final String uri;
@@ -50,7 +49,6 @@ class ExploreItem {
   }
 }
 
-/// Represents a section in Spotify home feed
 class ExploreSection {
   final String uri;
   final String title;
@@ -79,7 +77,6 @@ class ExploreSection {
   }
 }
 
-/// State for explore/home feed
 class ExploreState {
   final bool isLoading;
   final String? error;
@@ -114,7 +111,6 @@ class ExploreState {
   }
 }
 
-/// Calculate greeting based on local device time
 String _getLocalGreeting() {
   final hour = DateTime.now().hour;
   if (hour >= 5 && hour < 12) {
@@ -139,7 +135,6 @@ bool _isYTMusicQuickPicksItems(List<ExploreItem> items) {
   return true;
 }
 
-/// Provider for explore/home feed state
 class ExploreNotifier extends Notifier<ExploreState> {
   @override
   ExploreState build() {
@@ -150,7 +145,6 @@ class ExploreNotifier extends Notifier<ExploreState> {
   Future<void> fetchHomeFeed({bool forceRefresh = false}) async {
     _log.i('fetchHomeFeed called, forceRefresh=$forceRefresh');
     
-    // Don't refetch if we have data and it's less than 5 minutes old
     if (!forceRefresh && 
         state.hasContent && 
         state.lastFetched != null &&
@@ -167,11 +161,9 @@ class ExploreNotifier extends Notifier<ExploreState> {
     state = state.copyWith(isLoading: true, error: null);
 
     try {
-      // Find any extension with homeFeed capability
       final extState = ref.read(extensionProvider);
       _log.d('Extensions count: ${extState.extensions.length}');
       
-      // Look for extensions with homeFeed capability (prefer spotify-web)
       Extension? targetExt;
       for (final extension in extState.extensions) {
         if (!extension.enabled || !extension.hasHomeFeed) {
@@ -225,14 +217,11 @@ class ExploreNotifier extends Notifier<ExploreState> {
 
       _log.i('Fetched ${sections.length} sections');
       
-      // Debug: log first section items
       if (sections.isNotEmpty && sections.first.items.isNotEmpty) {
         final firstItem = sections.first.items.first;
         _log.d('First item: name=${firstItem.name}, artists=${firstItem.artists}, type=${firstItem.type}');
       }
 
-      // Always use local device time for greeting to avoid timezone issues
-      // Extension greeting may use wrong timezone (UTC or Spotify account timezone)
       final localGreeting = _getLocalGreeting();
       _log.d('Greeting from extension: $greeting, using local: $localGreeting');
 
@@ -251,15 +240,14 @@ class ExploreNotifier extends Notifier<ExploreState> {
     }
   }
 
-  /// Clear cached data
   void clear() {
     state = const ExploreState();
   }
 
-  /// Refresh home feed
   Future<void> refresh() => fetchHomeFeed(forceRefresh: true);
 }
 
+
 final exploreProvider = NotifierProvider<ExploreNotifier, ExploreState>(() {
   return ExploreNotifier();
 });

lib/providers/extension_provider.dart

@@ -452,7 +452,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     return const ExtensionState();
   }
 
-  /// Initialize the extension system
   Future<void> initialize(String extensionsDir, String dataDir) async {
     if (state.isInitialized) return;
     
@@ -485,7 +484,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Refresh the list of installed extensions
   Future<void> refreshExtensions() async {
     try {
       final list = await PlatformBridge.getInstalledExtensions();
@@ -493,7 +491,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
       state = state.copyWith(extensions: extensions);
       _log.d('Loaded ${extensions.length} extensions');
       
-      // Log search behavior for extensions that have it
       for (final ext in extensions) {
         if (ext.searchBehavior != null) {
           _log.d('Extension ${ext.id}: thumbnailRatio=${ext.searchBehavior!.thumbnailRatio}');
@@ -505,6 +502,7 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
+
   void clearError() {
     state = state.copyWith(error: null);
   }
@@ -550,7 +548,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Uninstall/remove an extension
   Future<bool> removeExtension(String extensionId) async {
     state = state.copyWith(isLoading: true, error: null);
     
@@ -567,6 +564,7 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
+
   Future<void> setExtensionEnabled(String extensionId, bool enabled) async {
     try {
       await PlatformBridge.setExtensionEnabled(extensionId, enabled);
@@ -603,7 +601,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Get settings for an extension
   Future<Map<String, dynamic>> getExtensionSettings(String extensionId) async {
     try {
       return await PlatformBridge.getExtensionSettings(extensionId);
@@ -623,7 +620,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Load provider priority order
   Future<void> loadProviderPriority() async {
     try {
       final priority = await PlatformBridge.getProviderPriority();
@@ -633,6 +629,7 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
+
   Future<void> setProviderPriority(List<String> priority) async {
     try {
       await PlatformBridge.setProviderPriority(priority);
@@ -644,7 +641,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Load metadata provider priority order
   Future<void> loadMetadataProviderPriority() async {
     try {
       final priority = await PlatformBridge.getMetadataProviderPriority();
@@ -665,7 +661,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Cleanup all extensions (call on app close)
   Future<void> cleanup() async {
     try {
       await PlatformBridge.cleanupExtensions();
@@ -683,7 +678,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
   }
 
-  /// Get all enabled extensions
   List<Extension> get enabledExtensions {
     return state.extensions.where((ext) => ext.enabled).toList();
   }
@@ -698,7 +692,6 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     return providers;
   }
 
-  /// Get all metadata providers (built-in + extensions)
   List<String> getAllMetadataProviders() {
     final providers = ['deezer', 'spotify'];
     for (final ext in state.extensions) {
@@ -708,6 +701,7 @@ class ExtensionNotifier extends Notifier<ExtensionState> {
     }
     return providers;
   }
+
   List<Extension> get searchProviders {
     return state.extensions.where((ext) => ext.enabled && ext.hasCustomSearch).toList();
   }

lib/providers/store_provider.dart

@@ -7,8 +7,6 @@ import 'package:spotiflac_android/providers/extension_provider.dart';
 final _log = AppLogger('StoreProvider');
 final RegExp _leadingVersionPrefix = RegExp(r'^v');
 
-/// Compare two semantic version strings
-/// Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
 int compareVersions(String v1, String v2) {
   final parts1 = v1.replaceAll(_leadingVersionPrefix, '').split('.');
   final parts2 = v2.replaceAll(_leadingVersionPrefix, '').split('.');
@@ -25,8 +23,8 @@ int compareVersions(String v1, String v2) {
   return 0;
 }
 
-/// Extension categories
 class StoreCategory {
+
   static const String metadata = 'metadata';
   static const String download = 'download';
   static const String utility = 'utility';
@@ -111,13 +109,13 @@ class StoreExtension {
     );
   }
 
-  /// Check if this extension requires a higher app version than current
   bool get requiresNewerApp {
     if (minAppVersion == null || minAppVersion!.isEmpty) return false;
     return compareVersions(minAppVersion!, AppInfo.version) > 0;
   }
 }
 
+
 class StoreState {
   final List<StoreExtension> extensions;
   final String? selectedCategory;
@@ -164,7 +162,6 @@ class StoreState {
     );
   }
 
-  /// Get filtered extensions based on category and search
   List<StoreExtension> get filteredExtensions {
     var result = extensions;
 
@@ -186,13 +183,11 @@ class StoreState {
     return result;
   }
 
-  /// Count of extensions with updates available
   int get updatesAvailableCount {
     return extensions.where((e) => e.hasUpdate).length;
   }
 }
 
-/// Provider for managing extension store
 class StoreNotifier extends Notifier<StoreState> {
   @override
   StoreState build() {
@@ -215,7 +210,6 @@ class StoreNotifier extends Notifier<StoreState> {
     }
   }
 
-  /// Refresh extensions from store
   Future<void> refresh({bool forceRefresh = false}) async {
     state = state.copyWith(isLoading: true, clearError: true);
 
@@ -240,7 +234,6 @@ class StoreNotifier extends Notifier<StoreState> {
     }
   }
 
-  /// Set search query
   void setSearchQuery(String query) {
     state = state.copyWith(searchQuery: query);
   }
@@ -249,7 +242,6 @@ class StoreNotifier extends Notifier<StoreState> {
     state = state.copyWith(searchQuery: '', clearCategory: true);
   }
 
-  /// Download and install extension
   Future<bool> installExtension(String extensionId, String tempDir, String extensionsDir) async {
     state = state.copyWith(isDownloading: true, downloadingId: extensionId, clearError: true);
 
@@ -275,6 +267,7 @@ class StoreNotifier extends Notifier<StoreState> {
     }
   }
 
+
   Future<bool> updateExtension(String extensionId, String tempDir) async {
     state = state.copyWith(isDownloading: true, downloadingId: extensionId, clearError: true);
 

lib/providers/theme_provider.dart

@@ -3,23 +3,19 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 import 'package:spotiflac_android/models/theme_settings.dart';
 
-/// Provider for theme settings state management
 final themeProvider = NotifierProvider<ThemeNotifier, ThemeSettings>(() {
   return ThemeNotifier();
 });
 
-/// Notifier for managing theme settings with persistence
 class ThemeNotifier extends Notifier<ThemeSettings> {
   final Future<SharedPreferences> _prefs = SharedPreferences.getInstance();
 
   @override
   ThemeSettings build() {
-    // Load settings asynchronously on first access
     _loadFromStorage();
     return const ThemeSettings();
   }
 
-  /// Load theme settings from SharedPreferences
   Future<void> _loadFromStorage() async {
     try {
       final prefs = await _prefs;
@@ -39,7 +35,6 @@ class ThemeNotifier extends Notifier<ThemeSettings> {
     }
   }
 
-  /// Save current settings to SharedPreferences
   Future<void> _saveToStorage() async {
     try {
       final prefs = await _prefs;
@@ -52,13 +47,11 @@ class ThemeNotifier extends Notifier<ThemeSettings> {
     }
   }
 
-  /// Set theme mode (light, dark, or system)
   Future<void> setThemeMode(ThemeMode mode) async {
     state = state.copyWith(themeMode: mode);
     await _saveToStorage();
   }
 
-  /// Enable or disable dynamic color from wallpaper
   Future<void> setUseDynamicColor(bool value) async {
     state = state.copyWith(useDynamicColor: value);
     await _saveToStorage();
@@ -70,19 +63,16 @@ class ThemeNotifier extends Notifier<ThemeSettings> {
     await _saveToStorage();
   }
 
-  /// Set seed color from int value
   Future<void> setSeedColorValue(int colorValue) async {
     state = state.copyWith(seedColorValue: colorValue);
     await _saveToStorage();
   }
 
-  /// Enable or disable AMOLED mode (pure black background)
   Future<void> setUseAmoled(bool value) async {
     state = state.copyWith(useAmoled: value);
     await _saveToStorage();
   }
 
-  /// Helper to convert string to ThemeMode
   ThemeMode _themeModeFromString(String? value) {
     if (value == null) return ThemeMode.system;
     return ThemeMode.values.firstWhere(
@@ -91,3 +81,4 @@ class ThemeNotifier extends Notifier<ThemeSettings> {
     );
   }
 }
+

lib/services/palette_service.dart

@@ -9,7 +9,6 @@ class PaletteService {
   static final PaletteService instance = PaletteService._();
   PaletteService._();
 
-  /// Cache for already computed colors
   final Map<String, Color> _colorCache = {};
 
   /// Extract dominant color from a network image URL
@@ -47,7 +46,6 @@ class PaletteService {
     }
   }
 
-  /// Extract dominant color from a local file path
   Future<Color?> extractDominantColorFromFile(String? filePath) async {
     if (filePath == null || filePath.isEmpty) return null;
 
@@ -81,12 +79,10 @@ class PaletteService {
     }
   }
 
-  /// Clear the color cache
   void clearCache() {
     _colorCache.clear();
   }
 
-  /// Get cached color without computing
   Color? getCached(String? imageUrl) {
     if (imageUrl == null) return null;
     return _colorCache[imageUrl];

lib/widgets/settings_group.dart

@@ -43,8 +43,8 @@ class SettingsGroup extends StatelessWidget {
   }
 }
 
-/// A single settings item that can be used inside SettingsGroup
 class SettingsItem extends StatelessWidget {
+
   final IconData? icon;
   final String title;
   final String? subtitle;
@@ -125,8 +125,8 @@ class SettingsItem extends StatelessWidget {
   }
 }
 
-/// A switch settings item for SettingsGroup
 class SettingsSwitchItem extends StatelessWidget {
+
   final IconData? icon;
   final String title;
   final String? subtitle;
@@ -213,8 +213,8 @@ class SettingsSwitchItem extends StatelessWidget {
   }
 }
 
-/// Section header for settings groups
 class SettingsSectionHeader extends StatelessWidget {
+
   final String title;
 
   const SettingsSectionHeader({super.key, required this.title});