feat: Add settings to control play button visibility on home shelves

This commit introduces new functionality to customize the visibility of the
play button on home page shelves.

Key changes:

- Added `HomePageSettings` to `AppSettings` to store your preferences:
    - `showPlayButtonOnContinueShelves`: Controls visibility on "Continue Listening" and "Continue Series" shelves (default: true).
    - `showPlayButtonOnAllShelves`: Controls visibility on other shelves (default: false).
- Modified `BookHomeShelf` to respect these settings when rendering books.
- Created a new "Home Page Settings" page under "Appearance" in App Settings, allowing you to toggle these two options.
- Added comprehensive unit and widget tests to cover the new settings model, the conditional logic in `BookHomeShelf`, and the functionality of the new settings page.

test/settings/app_settings_test.dart

@@ -0,0 +1,51 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:vaani/settings/models/app_settings.dart';
+
+void main() {
+  group('AppSettings', () {
+    test('initializes with default HomePageSettings', () {
+      const appSettings = AppSettings();
+      expect(appSettings.homePageSettings.showPlayButtonOnContinueShelves, isTrue);
+      expect(appSettings.homePageSettings.showPlayButtonOnAllShelves, isFalse);
+    });
+
+    test('HomePageSettings can be updated', () {
+      const initialSettings = AppSettings();
+      final updatedSettings = initialSettings.copyWith(
+        homePageSettings: initialSettings.homePageSettings.copyWith(
+          showPlayButtonOnContinueShelves: false,
+          showPlayButtonOnAllShelves: true,
+        ),
+      );
+
+      expect(updatedSettings.homePageSettings.showPlayButtonOnContinueShelves, isFalse);
+      expect(updatedSettings.homePageSettings.showPlayButtonOnAllShelves, isTrue);
+    });
+
+    test('HomePageSettings are correctly serialized and deserialized', () {
+      const originalSettings = AppSettings(
+        homePageSettings: HomePageSettings(
+          showPlayButtonOnContinueShelves: false,
+          showPlayButtonOnAllShelves: true,
+        ),
+      );
+
+      final json = originalSettings.toJson();
+      final deserializedSettings = AppSettings.fromJson(json);
+
+      expect(deserializedSettings.homePageSettings.showPlayButtonOnContinueShelves, isFalse);
+      expect(deserializedSettings.homePageSettings.showPlayButtonOnAllShelves, isTrue);
+      expect(deserializedSettings, originalSettings);
+    });
+
+    test('Default AppSettings serialization and deserialization', () {
+      const originalSettings = AppSettings();
+      final json = originalSettings.toJson();
+      final deserializedSettings = AppSettings.fromJson(json);
+
+      expect(deserializedSettings.homePageSettings.showPlayButtonOnContinueShelves, isTrue);
+      expect(deserializedSettings.homePageSettings.showPlayButtonOnAllShelves, isFalse);
+      expect(deserializedSettings, originalSettings);
+    });
+  });
+}

test/settings/view/home_page_settings_page_test.dart

@@ -0,0 +1,138 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:settings_ui/settings_ui.dart';
+import 'package:vaani/settings/models/app_settings.dart';
+import 'package:vaani/settings/app_settings_provider.dart';
+import 'package:vaani/settings/view/home_page_settings_page.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  // Helper function to pump HomePageSettingsPage
+  Future<void> pumpHomePageSettingsPage({
+    required WidgetTester tester,
+    required AppSettings initialAppSettings,
+    required ProviderContainer container,
+  }) async {
+    await tester.pumpWidget(
+      UncontrolledProviderScope(
+        container: container,
+        child: const MaterialApp(
+          home: HomePageSettingsPage(),
+        ),
+      ),
+    );
+    await tester.pumpAndSettle();
+  }
+
+  group('HomePageSettingsPage Widget Tests', () {
+    late ProviderContainer container;
+    late AppSettingsNotifier appSettingsNotifier;
+
+    setUp(() {
+      // Initialize with default AppSettings
+      appSettingsNotifier = AppSettingsNotifier(const AppSettings());
+      container = ProviderContainer(
+        overrides: [
+          appSettingsProvider.overrideWithValue(appSettingsNotifier),
+        ],
+      );
+    });
+
+    tearDown(() {
+      container.dispose();
+    });
+
+    testWidgets('Initial State: Switches reflect default AppSettings',
+        (WidgetTester tester) async {
+      await pumpHomePageSettingsPage(
+        tester: tester,
+        initialAppSettings: const AppSettings(), // Not strictly needed here as it's in setUp
+        container: container,
+      );
+
+      // Find the SettingsList
+      final settingsListFinder = find.byType(SettingsList);
+      expect(settingsListFinder, findsOneWidget);
+
+      // Find the switch tiles
+      final switchTileFinders = find.byType(SettingsTile);
+      expect(switchTileFinders, findsNWidgets(2));
+
+      final continueShelvesSwitch = tester.widget<SettingsTile>(
+        find.descendant(
+          of: settingsListFinder,
+          matching: find.widgetWithText(SettingsTile, 'Show play button on continue shelves'),
+        ),
+      );
+      expect(continueShelvesSwitch.initialValue, isTrue);
+
+      final allShelvesSwitch = tester.widget<SettingsTile>(
+        find.descendant(
+          of: settingsListFinder,
+          matching: find.widgetWithText(SettingsTile, 'Show play button on all shelves'),
+        ),
+      );
+      expect(allShelvesSwitch.initialValue, isFalse);
+    });
+
+    testWidgets('Toggle Switches: Updates AppSettings in provider',
+        (WidgetTester tester) async {
+      await pumpHomePageSettingsPage(
+        tester: tester,
+        initialAppSettings: const AppSettings(),
+        container: container,
+      );
+
+      // Initial state check (from AppSettingsNotifier directly)
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnContinueShelves,
+        isTrue,
+      );
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnAllShelves,
+        isFalse,
+      );
+
+      // Find and tap the first switch (Continue Shelves)
+      final continueShelvesSwitchFinder = find.widgetWithText(SettingsTile, 'Show play button on continue shelves');
+      expect(continueShelvesSwitchFinder, findsOneWidget);
+      await tester.tap(continueShelvesSwitchFinder);
+      await tester.pumpAndSettle(); // Allow state to update
+
+      // Verify the AppSettingsProvider was updated
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnContinueShelves,
+        isFalse,
+      );
+
+      // Find and tap the second switch (All Shelves)
+      final allShelvesSwitchFinder = find.widgetWithText(SettingsTile, 'Show play button on all shelves');
+      expect(allShelvesSwitchFinder, findsOneWidget);
+      await tester.tap(allShelvesSwitchFinder);
+      await tester.pumpAndSettle(); // Allow state to update
+
+      // Verify the AppSettingsProvider was updated
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnAllShelves,
+        isTrue,
+      );
+
+      // Tap them again to ensure they toggle back
+      await tester.tap(continueShelvesSwitchFinder);
+      await tester.pumpAndSettle();
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnContinueShelves,
+        isTrue,
+      );
+
+      await tester.tap(allShelvesSwitchFinder);
+      await tester.pumpAndSettle();
+      expect(
+        container.read(appSettingsProvider).homePageSettings.showPlayButtonOnAllShelves,
+        isFalse,
+      );
+    });
+  });
+}