make refresh rate selectable

apps/weblibre/lib/features/geckoview/domain/providers/desktop_mode.g.dart

@@ -57,7 +57,7 @@ final class DesktopModeProvider extends $NotifierProvider<DesktopMode, bool> {
   }
 }
 
-String _$desktopModeHash() => r'e755b0a36f7079006047896cb8f2a7be484dea90';
+String _$desktopModeHash() => r'af80dc2845488b6a039281d1e7c3d9ab79a38a62';
 
 final class DesktopModeFamily extends $Family
     with $ClassFamilyOverride<DesktopMode, bool, bool, bool, String> {

apps/weblibre/lib/features/settings/presentation/screens/general_settings.dart

@@ -53,7 +53,8 @@ const List<SettingsSectionDefinition> generalSettingsSections = [
       ),
       SettingsEntryDefinition(
         title: 'Pure Black (OLED)',
-        subtitle: 'Use true-black surfaces in dark mode to save power on OLED '
+        subtitle:
+            'Use true-black surfaces in dark mode to save power on OLED '
             'screens',
         keywords: ['oled', 'amoled', 'high contrast', 'black', 'dark'],
         child: _PureBlackTile(),
@@ -64,6 +65,24 @@ const List<SettingsSectionDefinition> generalSettingsSections = [
         keywords: ['ui scale', 'zoom'],
         child: _UiZoomSection(),
       ),
+      SettingsEntryDefinition(
+        title: 'Refresh Rate',
+        subtitle: 'Request a high or low display refresh rate (Android)',
+        keywords: [
+          'fps',
+          'hz',
+          'hertz',
+          'frame rate',
+          'framerate',
+          '60hz',
+          '90hz',
+          '120hz',
+          'smooth',
+          'high refresh',
+          'display mode',
+        ],
+        child: _RefreshRateSection(),
+      ),
       SettingsEntryDefinition(
         title: 'Disable Animations',
         subtitle: 'Reduce motion and turn off app animations',
@@ -78,7 +97,8 @@ const List<SettingsSectionDefinition> generalSettingsSections = [
       ),
       SettingsEntryDefinition(
         title: 'Show Close Button',
-        subtitle: 'Add a button to dismiss the search / new-tab page without '
+        subtitle:
+            'Add a button to dismiss the search / new-tab page without '
             'a back gesture',
         keywords: [
           'back',
@@ -421,6 +441,66 @@ class _ThemeSection extends HookConsumerWidget {
   }
 }
 
+class _RefreshRateSection extends HookConsumerWidget {
+  const _RefreshRateSection();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final refreshRateMode = ref.watch(
+      generalSettingsWithDefaultsProvider.select((s) => s.refreshRateMode),
+    );
+
+    return Padding(
+      padding: const EdgeInsets.symmetric(horizontal: 16.0, vertical: 8),
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          const ListTile(
+            title: Text('Refresh Rate'),
+            subtitle: Text(
+              'Choose "High" for the smoothest scrolling and animations on '
+              '90/120Hz screens, or "Low" to save battery.',
+            ),
+            leading: Icon(Icons.speed),
+            contentPadding: EdgeInsets.zero,
+          ),
+          Center(
+            child: SegmentedButton<RefreshRateMode>(
+              segments: const [
+                ButtonSegment(
+                  value: RefreshRateMode.system,
+                  icon: Icon(Icons.smartphone),
+                  label: Text('System'),
+                ),
+                ButtonSegment(
+                  value: RefreshRateMode.high,
+                  icon: Icon(Icons.bolt),
+                  label: Text('High'),
+                ),
+                ButtonSegment(
+                  value: RefreshRateMode.low,
+                  icon: Icon(Icons.battery_saver),
+                  label: Text('Low'),
+                ),
+              ],
+              selected: {refreshRateMode},
+              onSelectionChanged: (value) async {
+                await ref
+                    .read(saveGeneralSettingsControllerProvider.notifier)
+                    .save(
+                      (currentSettings) =>
+                          currentSettings.copyWith.refreshRateMode(value.first),
+                    );
+              },
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
 class _ExternalDownloadManagerTile extends HookConsumerWidget {
   const _ExternalDownloadManagerTile();
 

apps/weblibre/lib/features/user/data/models/general_settings.dart

@@ -47,6 +47,15 @@ const defaultQuickTabSwitcherHierarchyGlyphs = 2;
 const minQuickTabSwitcherHierarchyGlyphs = 0;
 const maxQuickTabSwitcherHierarchyGlyphs = 4;
 
+/// Controls the Android display refresh rate the app requests at startup.
+///
+/// Flutter does not request a high refresh rate by default, so on many devices
+/// (Samsung, OnePlus, Xiaomi, …) the app is left at 60Hz even on a 90/120Hz
+/// panel. [high] asks the OS for the fastest available mode, [low] for the
+/// slowest (battery saving), and [system] leaves the OS-managed default in
+/// place. Android-only; ignored on other platforms.
+enum RefreshRateMode { system, high, low }
+
 enum TabBarSwipeAction { switchLastOpened, navigateOrderedTabs }
 
 enum QuickTabSwitcherMode { lastUsedTabs, containerTabs }
@@ -79,6 +88,9 @@ class GeneralSettings with FastEquatable {
   final ThemeMode themeMode;
   final double uiScaleFactor;
   final bool disableAnimations;
+
+  /// Android display refresh rate requested at startup. See [RefreshRateMode].
+  final RefreshRateMode refreshRateMode;
   final bool showModalBarrier;
   final bool enableReadability;
   final bool enforceReadability;
@@ -168,6 +180,7 @@ class GeneralSettings with FastEquatable {
     required this.themeMode,
     required this.uiScaleFactor,
     required this.disableAnimations,
+    required this.refreshRateMode,
     required this.showModalBarrier,
     required this.enableReadability,
     required this.enforceReadability,
@@ -232,6 +245,7 @@ class GeneralSettings with FastEquatable {
     ThemeMode? themeMode,
     double? uiScaleFactor,
     bool? disableAnimations,
+    RefreshRateMode? refreshRateMode,
     bool? showModalBarrier,
     bool? enableReadability,
     bool? enforceReadability,
@@ -293,6 +307,7 @@ class GeneralSettings with FastEquatable {
   }) : themeMode = themeMode ?? ThemeMode.dark,
        uiScaleFactor = uiScaleFactor ?? defaultUiScaleFactor,
        disableAnimations = disableAnimations ?? false,
+       refreshRateMode = refreshRateMode ?? RefreshRateMode.high,
        showModalBarrier = showModalBarrier ?? true,
        enableReadability = enableReadability ?? true,
        enforceReadability = enforceReadability ?? false,
@@ -419,6 +434,7 @@ class GeneralSettings with FastEquatable {
     themeMode,
     uiScaleFactor,
     disableAnimations,
+    refreshRateMode,
     showModalBarrier,
     enableReadability,
     enforceReadability,

apps/weblibre/lib/features/user/data/models/general_settings.g.dart

@@ -13,6 +13,8 @@ abstract class _$GeneralSettingsCWProxy {
 
   GeneralSettings disableAnimations(bool disableAnimations);
 
+  GeneralSettings refreshRateMode(RefreshRateMode refreshRateMode);
+
   GeneralSettings showModalBarrier(bool showModalBarrier);
 
   GeneralSettings enableReadability(bool enableReadability);
@@ -162,6 +164,7 @@ abstract class _$GeneralSettingsCWProxy {
     ThemeMode themeMode,
     double uiScaleFactor,
     bool disableAnimations,
+    RefreshRateMode refreshRateMode,
     bool showModalBarrier,
     bool enableReadability,
     bool enforceReadability,
@@ -241,6 +244,10 @@ class _$GeneralSettingsCWProxyImpl implements _$GeneralSettingsCWProxy {
   GeneralSettings disableAnimations(bool disableAnimations) =>
       call(disableAnimations: disableAnimations);
 
+  @override
+  GeneralSettings refreshRateMode(RefreshRateMode refreshRateMode) =>
+      call(refreshRateMode: refreshRateMode);
+
   @override
   GeneralSettings showModalBarrier(bool showModalBarrier) =>
       call(showModalBarrier: showModalBarrier);
@@ -500,6 +507,7 @@ class _$GeneralSettingsCWProxyImpl implements _$GeneralSettingsCWProxy {
     Object? themeMode = const $CopyWithPlaceholder(),
     Object? uiScaleFactor = const $CopyWithPlaceholder(),
     Object? disableAnimations = const $CopyWithPlaceholder(),
+    Object? refreshRateMode = const $CopyWithPlaceholder(),
     Object? showModalBarrier = const $CopyWithPlaceholder(),
     Object? enableReadability = const $CopyWithPlaceholder(),
     Object? enforceReadability = const $CopyWithPlaceholder(),
@@ -576,6 +584,12 @@ class _$GeneralSettingsCWProxyImpl implements _$GeneralSettingsCWProxy {
           ? _value.disableAnimations
           // ignore: cast_nullable_to_non_nullable
           : disableAnimations as bool,
+      refreshRateMode:
+          refreshRateMode == const $CopyWithPlaceholder() ||
+              refreshRateMode == null
+          ? _value.refreshRateMode
+          // ignore: cast_nullable_to_non_nullable
+          : refreshRateMode as RefreshRateMode,
       showModalBarrier:
           showModalBarrier == const $CopyWithPlaceholder() ||
               showModalBarrier == null
@@ -940,6 +954,10 @@ GeneralSettings _$GeneralSettingsFromJson(
   themeMode: $enumDecodeNullable(_$ThemeModeEnumMap, json['themeMode']),
   uiScaleFactor: (json['uiScaleFactor'] as num?)?.toDouble(),
   disableAnimations: json['disableAnimations'] as bool?,
+  refreshRateMode: $enumDecodeNullable(
+    _$RefreshRateModeEnumMap,
+    json['refreshRateMode'],
+  ),
   showModalBarrier: json['showModalBarrier'] as bool?,
   enableReadability: json['enableReadability'] as bool?,
   enforceReadability: json['enforceReadability'] as bool?,
@@ -1059,6 +1077,7 @@ Map<String, dynamic> _$GeneralSettingsToJson(
   'themeMode': _$ThemeModeEnumMap[instance.themeMode]!,
   'uiScaleFactor': instance.uiScaleFactor,
   'disableAnimations': instance.disableAnimations,
+  'refreshRateMode': _$RefreshRateModeEnumMap[instance.refreshRateMode]!,
   'showModalBarrier': instance.showModalBarrier,
   'enableReadability': instance.enableReadability,
   'enforceReadability': instance.enforceReadability,
@@ -1138,6 +1157,12 @@ const _$ThemeModeEnumMap = {
   ThemeMode.dark: 'dark',
 };
 
+const _$RefreshRateModeEnumMap = {
+  RefreshRateMode.system: 'system',
+  RefreshRateMode.high: 'high',
+  RefreshRateMode.low: 'low',
+};
+
 const _$DeleteBrowsingDataTypeEnumMap = {
   DeleteBrowsingDataType.tabs: 'tabs',
   DeleteBrowsingDataType.history: 'history',

apps/weblibre/lib/features/user/domain/repositories/general_settings.dart

@@ -56,6 +56,10 @@ class GeneralSettingsRepository extends _$GeneralSettingsRepository {
         DriftSqlType.bool,
         db.typeMapping,
       ),
+      'refreshRateMode': settings['refreshRateMode']?.readAs(
+        DriftSqlType.string,
+        db.typeMapping,
+      ),
       'showModalBarrier': settings['showModalBarrier']?.readAs(
         DriftSqlType.bool,
         db.typeMapping,

apps/weblibre/lib/features/user/domain/repositories/general_settings.g.dart

@@ -35,7 +35,7 @@ final class GeneralSettingsRepositoryProvider
 }
 
 String _$generalSettingsRepositoryHash() =>
-    r'0f3991899956a779f18615fa7c8c172d9086af1c';
+    r'eb369cd699e336cd5ca51709f116883ae8c6dbc4';
 
 abstract class _$GeneralSettingsRepository
     extends $StreamNotifier<GeneralSettings> {