feat(theme): add pure black AMOLED dark mode toggle

lib/core/app_initialization.dart

@@ -232,6 +232,7 @@ Future<void> initPrefs() async {
     "language",
     "themeMode",
     "enableDynamicColor",
+    "pureBlackDarkMode",
     "themeSeedColor",
     "tagsOrder",
     "secureScreen",

lib/l10n/app_en.arb

@@ -24,6 +24,10 @@
   "@dynamicColor": {},
   "dynamicColorDescription": "Use system dynamic color scheme",
   "@dynamicColorDescription": {},
+  "pureBlackDarkMode": "Pure Black Dark Mode (AMOLED)",
+  "@pureBlackDarkMode": {},
+  "pureBlackDarkModeDescription": "Use true black surfaces in dark theme",
+  "@pureBlackDarkModeDescription": {},
   "appThemeColor": "App Theme Color",
   "@appThemeColor": {},
   "chooseThemeColor": "Choose Theme Color",

lib/l10n/app_zh.arb

@@ -24,6 +24,10 @@
   "@dynamicColor": {},
   "dynamicColorDescription": "使用系统动态配色方案",
   "@dynamicColorDescription": {},
+  "pureBlackDarkMode": "纯黑暗色模式 (AMOLED)",
+  "@pureBlackDarkMode": {},
+  "pureBlackDarkModeDescription": "在深色主题中使用纯黑背景",
+  "@pureBlackDarkModeDescription": {},
   "appThemeColor": "应用主题配色",
   "@appThemeColor": {},
   "chooseThemeColor": "选择主题色",

lib/l10n/app_zh_HK.arb

@@ -24,6 +24,10 @@
   "@dynamicColor": {},
   "dynamicColorDescription": "使用系統動態配色方案",
   "@dynamicColorDescription": {},
+  "pureBlackDarkMode": "純黑暗色模式 (AMOLED)",
+  "@pureBlackDarkMode": {},
+  "pureBlackDarkModeDescription": "在深色主題中使用純黑背景",
+  "@pureBlackDarkModeDescription": {},
   "appThemeColor": "應用主題配色",
   "@appThemeColor": {},
   "chooseThemeColor": "選擇主題色",

lib/l10n/app_zh_TW.arb

@@ -24,6 +24,10 @@
   "@dynamicColor": {},
   "dynamicColorDescription": "使用系統動態配色方案",
   "@dynamicColorDescription": {},
+  "pureBlackDarkMode": "純黑深色模式 (AMOLED)",
+  "@pureBlackDarkMode": {},
+  "pureBlackDarkModeDescription": "在深色主題中使用純黑背景",
+  "@pureBlackDarkModeDescription": {},
   "appThemeColor": "應用主題配色",
   "@appThemeColor": {},
   "chooseThemeColor": "選擇主題色",

lib/main.dart

@@ -102,6 +102,24 @@ class Ciyue extends StatefulWidget {
 }
 
 class _CiyueState extends State<Ciyue> with TrayListener {
+  ColorScheme _applyPureBlackDarkScheme(ColorScheme colorScheme) {
+    if (colorScheme.brightness != Brightness.dark) {
+      return colorScheme;
+    }
+
+    return colorScheme.copyWith(
+      surface: Colors.black,
+      surfaceDim: Colors.black,
+      surfaceBright: Colors.black,
+      surfaceContainerLowest: Colors.black,
+      surfaceContainerLow: Colors.black,
+      surfaceContainer: Colors.black,
+      surfaceContainerHigh: Colors.black,
+      surfaceContainerHighest: Colors.black,
+      surfaceTint: Colors.transparent,
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
     if (widget.isFloatingWindow) {
@@ -159,15 +177,27 @@ class _CiyueState extends State<Ciyue> with TrayListener {
 
   Widget buildMaterialApp(ColorScheme? lightColorScheme,
       ColorScheme? darkColorScheme, Locale? locale) {
+    final ColorScheme resolvedDarkColorScheme;
+    if (darkColorScheme != null) {
+      resolvedDarkColorScheme = darkColorScheme;
+    } else {
+      resolvedDarkColorScheme = ColorScheme.fromSeed(
+          seedColor: Colors.blue, brightness: Brightness.dark);
+    }
+
+    final ColorScheme darkScheme;
+    if (settings.pureBlackDarkMode) {
+      darkScheme = _applyPureBlackDarkScheme(resolvedDarkColorScheme);
+    } else {
+      darkScheme = resolvedDarkColorScheme;
+    }
+
     return SafeArea(
       top: false,
       child: MaterialApp.router(
         title: "Ciyue",
         theme: ThemeData(colorScheme: lightColorScheme),
-        darkTheme: ThemeData(
-            colorScheme: darkColorScheme ??
-                ColorScheme.fromSeed(
-                    seedColor: Colors.blue, brightness: Brightness.dark)),
+        darkTheme: ThemeData(colorScheme: darkScheme),
         themeMode: settings.themeMode,
         locale: locale,
         localizationsDelegates: [

lib/repositories/settings.dart

@@ -17,6 +17,7 @@ class Settings {
 
   late ThemeMode themeMode;
   late bool enableDynamicColor;
+  late bool pureBlackDarkMode;
   late Color themeSeedColor;
   String? language;
   late bool searchBarInAppBar;
@@ -69,6 +70,7 @@ class Settings {
 
     language = prefs.getString("language") ?? "system";
     enableDynamicColor = prefs.getBool("enableDynamicColor") ?? true;
+    pureBlackDarkMode = prefs.getBool("pureBlackDarkMode") ?? false;
     final int? themeSeedColorValue = prefs.getInt("themeSeedColor");
     themeSeedColor = Color(themeSeedColorValue ?? Colors.blue.toARGB32());
     searchBarInAppBar = prefs.getBool("searchBarInAppBar") ?? true;
@@ -173,6 +175,11 @@ class Settings {
     await prefs.setInt("themeSeedColor", color.toARGB32());
   }
 
+  Future<void> setPureBlackDarkMode(bool value) async {
+    pureBlackDarkMode = value;
+    await prefs.setBool("pureBlackDarkMode", value);
+  }
+
   Future<void> setTabBarPosition(TabBarPosition position) async {
     tabBarPosition = position;
     await prefs.setString("tabBarPosition", position.name);

lib/ui/pages/settings/appearance/theme_color_settings_section.dart

@@ -6,19 +6,23 @@ import "package:flutter_riverpod/flutter_riverpod.dart";
 
 class ThemeColorSettingsState {
   final bool dynamicColorEnabled;
+  final bool pureBlackDarkMode;
   final Color seedColor;
 
   const ThemeColorSettingsState({
     required this.dynamicColorEnabled,
+    required this.pureBlackDarkMode,
     required this.seedColor,
   });
 
   ThemeColorSettingsState copyWith({
     bool? dynamicColorEnabled,
+    bool? pureBlackDarkMode,
     Color? seedColor,
   }) {
     return ThemeColorSettingsState(
       dynamicColorEnabled: dynamicColorEnabled ?? this.dynamicColorEnabled,
+      pureBlackDarkMode: pureBlackDarkMode ?? this.pureBlackDarkMode,
       seedColor: seedColor ?? this.seedColor,
     );
   }
@@ -29,6 +33,7 @@ class ThemeColorSettingsNotifier extends Notifier<ThemeColorSettingsState> {
   ThemeColorSettingsState build() {
     return ThemeColorSettingsState(
       dynamicColorEnabled: settings.enableDynamicColor,
+      pureBlackDarkMode: settings.pureBlackDarkMode,
       seedColor: settings.themeSeedColor,
     );
   }
@@ -40,6 +45,10 @@ class ThemeColorSettingsNotifier extends Notifier<ThemeColorSettingsState> {
   void setSeedColor(Color color) {
     state = state.copyWith(seedColor: color);
   }
+
+  void setPureBlackDarkMode(bool value) {
+    state = state.copyWith(pureBlackDarkMode: value);
+  }
 }
 
 final themeColorSettingsProvider =
@@ -57,6 +66,7 @@ class ThemeColorSettingsSection extends ConsumerWidget {
     final locale = AppLocalizations.of(context)!;
     final themeSettings = ref.watch(themeColorSettingsProvider);
     final dynamicColorEnabled = themeSettings.dynamicColorEnabled;
+    final pureBlackDarkMode = themeSettings.pureBlackDarkMode;
     final themeSeedColor = themeSettings.seedColor;
 
     return Column(
@@ -74,6 +84,19 @@ class ThemeColorSettingsSection extends ConsumerWidget {
             refreshAll();
           },
         ),
+        SwitchListTile(
+          secondary: const Icon(Icons.contrast),
+          title: Text(locale.pureBlackDarkMode),
+          subtitle: Text(locale.pureBlackDarkModeDescription),
+          value: pureBlackDarkMode,
+          onChanged: (value) async {
+            ref
+                .read(themeColorSettingsProvider.notifier)
+                .setPureBlackDarkMode(value);
+            await settings.setPureBlackDarkMode(value);
+            refreshAll();
+          },
+        ),
         if (!dynamicColorEnabled)
           ListTile(
             leading: const Icon(Icons.palette_outlined),