feat: adaptive theme selection based on the terminal color scheme

book/src/configuration.md

@@ -11,6 +11,8 @@ Example config:
 
 ```toml
 theme = "onedark"
+# Adaptive Theme
+# theme = { light = "onelight", dark = "onedark" }
 
 [editor]
 line-number = "relative"

book/src/themes.md

@@ -1,6 +1,7 @@
 ## Themes
 
 To use a theme add `theme = "<name>"` to the top of your [`config.toml`](./configuration.md) file, or select it during runtime using `:theme <name>`.
+Alternatively, `theme = { light = "<name>", dark = "<name>" }` tries to select a theme based on the terminal color scheme. The detection should work with all major terminals including Windows Terminal (starting with v1.22).
 
 ## Creating a theme
 

helix-term/src/application.rs

@@ -113,6 +113,7 @@ impl Application {
         let theme = config
             .theme
             .as_ref()
+            .map(helix_view::theme::Config::get_active_theme)
             .and_then(|theme| {
                 theme_loader
                     .load(theme)
@@ -428,6 +429,7 @@ impl Application {
         let theme = config
             .theme
             .as_ref()
+            .map(helix_view::theme::Config::get_active_theme)
             .and_then(|theme| {
                 self.theme_loader
                     .load(theme)

helix-term/src/config.rs

@@ -11,15 +11,15 @@ use toml::de::Error as TomlError;
 
 #[derive(Debug, Clone, PartialEq)]
 pub struct Config {
-    pub theme: Option<String>,
+    pub theme: Option<helix_view::theme::Config>,
     pub keys: HashMap<Mode, KeyTrie>,
     pub editor: helix_view::editor::Config,
 }
 
 #[derive(Debug, Clone, PartialEq, Deserialize)]
 #[serde(deny_unknown_fields)]
 pub struct ConfigRaw {
-    pub theme: Option<String>,
+    pub theme: Option<helix_view::theme::Config>,
     pub keys: Option<HashMap<Mode, KeyTrie>>,
     pub editor: Option<toml::Value>,
 }

helix-view/Cargo.toml

@@ -27,6 +27,7 @@ helix-vcs = { path = "../helix-vcs" }
 bitflags = "2.6"
 anyhow = "1"
 crossterm = { version = "0.28", optional = true }
+terminal-colorsaurus = "0.4"
 
 tempfile = "3.14"
 

helix-view/src/theme.rs

@@ -9,7 +9,7 @@ use helix_core::hashmap;
 use helix_loader::merge_toml_values;
 use log::warn;
 use once_cell::sync::Lazy;
-use serde::{Deserialize, Deserializer};
+use serde::{Deserialize, Deserializer, Serialize};
 use toml::{map::Map, Value};
 
 use crate::graphics::UnderlineStyle;
@@ -540,6 +540,28 @@ impl TryFrom<Value> for ThemePalette {
     }
 }
 
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+#[serde(untagged, deny_unknown_fields)]
+pub enum Config {
+    Static(String),
+    Adaptive { light: String, dark: String },
+}
+
+impl Config {
+    pub fn get_active_theme(&self) -> &str {
+        match self {
+            Config::Static(x) => x,
+            Config::Adaptive { light, dark } => {
+                use terminal_colorsaurus::{color_scheme, ColorScheme, QueryOptions};
+                match color_scheme(QueryOptions::default()).unwrap_or(ColorScheme::Dark) {
+                    ColorScheme::Light => light,
+                    ColorScheme::Dark => dark,
+                }
+            }
+        }
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;