atagen

monolith

public
Star0
Watch0
47259c39793f538fe13c032d5f644f7d43715c12
1
ssh://brewery@pls.lobotomise.me:33/atagen/monolith.git

Blame: crates/config/src/lib.rs

fe835aed6c8datagen2026-10-16 10:05 UTC1
//! The TOML config. Parsing and validation only, the compositor applies it.
57f44a63d99fatagen2026-10-16 05:34 UTC2
fe835aed6c8datagen2026-10-16 10:05 UTC3
use monolith_ipc::Command;
fe835aed6c8datagen2026-10-16 10:05 UTC4
use regex::Regex;
fe835aed6c8datagen2026-10-16 10:05 UTC5
use serde::Deserialize;
fe835aed6c8datagen2026-10-16 10:05 UTC6
use std::collections::BTreeMap;
fe835aed6c8datagen2026-10-16 10:05 UTC7
use std::fmt;
fe835aed6c8datagen2026-10-16 10:05 UTC8
use std::path::{Path, PathBuf};
fe835aed6c8datagen2026-10-16 10:05 UTC9
fe835aed6c8datagen2026-10-16 10:05 UTC10
pub const DEFAULT: &str = include_str!("../default.toml");
fe835aed6c8datagen2026-10-16 10:05 UTC11
fe835aed6c8datagen2026-10-16 10:05 UTC12
#[derive(Debug, Clone)]
fe835aed6c8datagen2026-10-16 10:05 UTC13
pub struct Config {
fe835aed6c8datagen2026-10-16 10:05 UTC14
    pub general: General,
8e6f96f0a32datagen2026-10-16 22:17 UTC15
    pub output: Outputs,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC16
    pub decoration: Decoration,
2af1d8c55876atagen2026-10-16 11:05 UTC17
    pub animation: Animation,
fe835aed6c8datagen2026-10-16 10:05 UTC18
    pub keyboard: Keyboard,
fe835aed6c8datagen2026-10-16 10:05 UTC19
    pub binds: Vec<Bind>,
fe835aed6c8datagen2026-10-16 10:05 UTC20
    pub rules: Vec<Rule>,
fe835aed6c8datagen2026-10-16 10:05 UTC21
    pub startup: Vec<Vec<String>>,
fe835aed6c8datagen2026-10-16 10:05 UTC22
}
fe835aed6c8datagen2026-10-16 10:05 UTC23
fe835aed6c8datagen2026-10-16 10:05 UTC24
#[derive(Deserialize, Debug, Clone, PartialEq)]
fe835aed6c8datagen2026-10-16 10:05 UTC25
#[serde(default, deny_unknown_fields)]
fe835aed6c8datagen2026-10-16 10:05 UTC26
pub struct General {
fe835aed6c8datagen2026-10-16 10:05 UTC27
    /// What `Mod` means in binds.
fe835aed6c8datagen2026-10-16 10:05 UTC28
    #[serde(rename = "mod")]
fe835aed6c8datagen2026-10-16 10:05 UTC29
    pub mod_key: Modifier,
fe835aed6c8datagen2026-10-16 10:05 UTC30
    pub gaps: Gaps,
4444c779eb48atagen2026-10-16 12:07 UTC31
    /// What a window move does when it meets a neighbour.
4444c779eb48atagen2026-10-16 12:07 UTC32
    #[serde(rename = "move")]
4444c779eb48atagen2026-10-16 12:07 UTC33
    pub move_mode: MoveMode,
24fca1aad608atagen2026-10-17 09:56 UTC34
    pub focus_follows_mouse: bool,
24fca1aad608atagen2026-10-17 09:56 UTC35
    pub mouse_follows_focus: bool,
47259c39793fatagen2026-10-17 10:13 UTC36
    /// The first window on an empty tag nobody is viewing brings that tag
47259c39793fatagen2026-10-17 10:13 UTC37
    /// into view on its output.
47259c39793fatagen2026-10-17 10:13 UTC38
    pub view_tag_on_first_window: bool,
4444c779eb48atagen2026-10-16 12:07 UTC39
}
4444c779eb48atagen2026-10-16 12:07 UTC40
4444c779eb48atagen2026-10-16 12:07 UTC41
#[derive(Deserialize, Debug, Clone, Copy, PartialEq, Eq, Default)]
4444c779eb48atagen2026-10-16 12:07 UTC42
#[serde(rename_all = "lowercase")]
4444c779eb48atagen2026-10-16 12:07 UTC43
pub enum MoveMode {
4444c779eb48atagen2026-10-16 12:07 UTC44
    /// Trade places with it.
4444c779eb48atagen2026-10-16 12:07 UTC45
    #[default]
4444c779eb48atagen2026-10-16 12:07 UTC46
    Swap,
4444c779eb48atagen2026-10-16 12:07 UTC47
    /// Join its lane, stacking with it if it is alone.
4444c779eb48atagen2026-10-16 12:07 UTC48
    Merge,
fe835aed6c8datagen2026-10-16 10:05 UTC49
}
fe835aed6c8datagen2026-10-16 10:05 UTC50
fe835aed6c8datagen2026-10-16 10:05 UTC51
impl Default for General {
fe835aed6c8datagen2026-10-16 10:05 UTC52
    fn default() -> Self {
fe835aed6c8datagen2026-10-16 10:05 UTC53
        Self {
fe835aed6c8datagen2026-10-16 10:05 UTC54
            mod_key: Modifier::Super,
fe835aed6c8datagen2026-10-16 10:05 UTC55
            gaps: Gaps::default(),
4444c779eb48atagen2026-10-16 12:07 UTC56
            move_mode: MoveMode::Swap,
24fca1aad608atagen2026-10-17 09:56 UTC57
            focus_follows_mouse: false,
24fca1aad608atagen2026-10-17 09:56 UTC58
            mouse_follows_focus: false,
47259c39793fatagen2026-10-17 10:13 UTC59
            view_tag_on_first_window: true,
fe835aed6c8datagen2026-10-16 10:05 UTC60
        }
fe835aed6c8datagen2026-10-16 10:05 UTC61
    }
fe835aed6c8datagen2026-10-16 10:05 UTC62
}
fe835aed6c8datagen2026-10-16 10:05 UTC63
fe835aed6c8datagen2026-10-16 10:05 UTC64
#[derive(Deserialize, Debug, Clone, Copy, PartialEq)]
fe835aed6c8datagen2026-10-16 10:05 UTC65
#[serde(default, deny_unknown_fields)]
fe835aed6c8datagen2026-10-16 10:05 UTC66
pub struct Gaps {
fe835aed6c8datagen2026-10-16 10:05 UTC67
    pub inner: f64,
fe835aed6c8datagen2026-10-16 10:05 UTC68
    pub outer: f64,
fe835aed6c8datagen2026-10-16 10:05 UTC69
}
fe835aed6c8datagen2026-10-16 10:05 UTC70
fe835aed6c8datagen2026-10-16 10:05 UTC71
impl Default for Gaps {
fe835aed6c8datagen2026-10-16 10:05 UTC72
    fn default() -> Self {
fe835aed6c8datagen2026-10-16 10:05 UTC73
        Self {
fe835aed6c8datagen2026-10-16 10:05 UTC74
            inner: 8.0,
fe835aed6c8datagen2026-10-16 10:05 UTC75
            outer: 8.0,
fe835aed6c8datagen2026-10-16 10:05 UTC76
        }
fe835aed6c8datagen2026-10-16 10:05 UTC77
    }
fe835aed6c8datagen2026-10-16 10:05 UTC78
}
fe835aed6c8datagen2026-10-16 10:05 UTC79
8e6f96f0a32datagen2026-10-16 22:17 UTC80
#[derive(Deserialize, Debug, Clone, PartialEq, Default)]
8e6f96f0a32datagen2026-10-16 22:17 UTC81
#[serde(default, deny_unknown_fields)]
8e6f96f0a32datagen2026-10-16 22:17 UTC82
pub struct Outputs {
8e6f96f0a32datagen2026-10-16 22:17 UTC83
    pub vrr: Vrr,
8e6f96f0a32datagen2026-10-16 22:17 UTC84
}
8e6f96f0a32datagen2026-10-16 22:17 UTC85
8e6f96f0a32datagen2026-10-16 22:17 UTC86
#[derive(Deserialize, Debug, Clone, Copy, PartialEq, Eq, Default)]
8e6f96f0a32datagen2026-10-16 22:17 UTC87
#[serde(rename_all = "lowercase")]
8e6f96f0a32datagen2026-10-16 22:17 UTC88
pub enum Vrr {
8e6f96f0a32datagen2026-10-16 22:17 UTC89
    Off,
8e6f96f0a32datagen2026-10-16 22:17 UTC90
    On,
8e6f96f0a32datagen2026-10-16 22:17 UTC91
    /// Only while a fullscreen window is shown, where a game sets the pace.
8e6f96f0a32datagen2026-10-16 22:17 UTC92
    #[default]
8e6f96f0a32datagen2026-10-16 22:17 UTC93
    Fullscreen,
8e6f96f0a32datagen2026-10-16 22:17 UTC94
}
8e6f96f0a32datagen2026-10-16 22:17 UTC95
fe835aed6c8datagen2026-10-16 10:05 UTC96
#[derive(Deserialize, Debug, Clone, PartialEq)]
fe835aed6c8datagen2026-10-16 10:05 UTC97
#[serde(default, deny_unknown_fields)]
7ce6ae4e5a85atagen2026-10-16 12:16 UTC98
pub struct Decoration {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC99
    /// Border width in logical pixels, drawn in the gap around each window.
7ce6ae4e5a85atagen2026-10-16 12:16 UTC100
    pub border: u32,
47259c39793fatagen2026-10-17 10:13 UTC101
    pub radius: Corners,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC102
    pub focused: Color,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC103
    pub unfocused: Color,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC104
}
7ce6ae4e5a85atagen2026-10-16 12:16 UTC105
47259c39793fatagen2026-10-17 10:13 UTC106
/// Corner radii in logical pixels, top left, top right, bottom right and
47259c39793fatagen2026-10-17 10:13 UTC107
/// bottom left. One number rounds every corner alike.
47259c39793fatagen2026-10-17 10:13 UTC108
#[derive(Deserialize, Debug, Clone, Copy, PartialEq, Eq, Default)]
47259c39793fatagen2026-10-17 10:13 UTC109
#[serde(from = "CornersToml")]
47259c39793fatagen2026-10-17 10:13 UTC110
pub struct Corners(pub [u32; 4]);
47259c39793fatagen2026-10-17 10:13 UTC111
47259c39793fatagen2026-10-17 10:13 UTC112
#[derive(Deserialize)]
47259c39793fatagen2026-10-17 10:13 UTC113
#[serde(untagged)]
47259c39793fatagen2026-10-17 10:13 UTC114
enum CornersToml {
47259c39793fatagen2026-10-17 10:13 UTC115
    All(u32),
47259c39793fatagen2026-10-17 10:13 UTC116
    Each([u32; 4]),
47259c39793fatagen2026-10-17 10:13 UTC117
}
47259c39793fatagen2026-10-17 10:13 UTC118
47259c39793fatagen2026-10-17 10:13 UTC119
impl From<CornersToml> for Corners {
47259c39793fatagen2026-10-17 10:13 UTC120
    fn from(c: CornersToml) -> Self {
47259c39793fatagen2026-10-17 10:13 UTC121
        match c {
47259c39793fatagen2026-10-17 10:13 UTC122
            CornersToml::All(r) => Self([r; 4]),
47259c39793fatagen2026-10-17 10:13 UTC123
            CornersToml::Each(r) => Self(r),
47259c39793fatagen2026-10-17 10:13 UTC124
        }
47259c39793fatagen2026-10-17 10:13 UTC125
    }
47259c39793fatagen2026-10-17 10:13 UTC126
}
47259c39793fatagen2026-10-17 10:13 UTC127
7ce6ae4e5a85atagen2026-10-16 12:16 UTC128
impl Default for Decoration {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC129
    fn default() -> Self {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC130
        Self {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC131
            border: 2,
47259c39793fatagen2026-10-17 10:13 UTC132
            radius: Corners([0; 4]),
b22c0511d5afatagen2026-10-17 03:48 UTC133
            focused: Color::rgb(0x88, 0xbf, 0xd1),
b22c0511d5afatagen2026-10-17 03:48 UTC134
            unfocused: Color::rgb(0x3b, 0x42, 0x52),
7ce6ae4e5a85atagen2026-10-16 12:16 UTC135
        }
7ce6ae4e5a85atagen2026-10-16 12:16 UTC136
    }
7ce6ae4e5a85atagen2026-10-16 12:16 UTC137
}
7ce6ae4e5a85atagen2026-10-16 12:16 UTC138
7ce6ae4e5a85atagen2026-10-16 12:16 UTC139
/// Straight RGBA from `#rrggbb` or `#rrggbbaa`.
7ce6ae4e5a85atagen2026-10-16 12:16 UTC140
#[derive(Debug, Clone, Copy, PartialEq)]
7ce6ae4e5a85atagen2026-10-16 12:16 UTC141
pub struct Color(pub [f32; 4]);
7ce6ae4e5a85atagen2026-10-16 12:16 UTC142
b22c0511d5afatagen2026-10-17 03:48 UTC143
impl Color {
b22c0511d5afatagen2026-10-17 03:48 UTC144
    pub const fn rgb(r: u8, g: u8, b: u8) -> Self {
b22c0511d5afatagen2026-10-17 03:48 UTC145
        Self([r as f32 / 255.0, g as f32 / 255.0, b as f32 / 255.0, 1.0])
b22c0511d5afatagen2026-10-17 03:48 UTC146
    }
b22c0511d5afatagen2026-10-17 03:48 UTC147
}
b22c0511d5afatagen2026-10-17 03:48 UTC148
7ce6ae4e5a85atagen2026-10-16 12:16 UTC149
impl<'de> Deserialize<'de> for Color {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC150
    fn deserialize<D: serde::Deserializer<'de>>(d: D) -> Result<Self, D::Error> {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC151
        let s = String::deserialize(d)?;
7ce6ae4e5a85atagen2026-10-16 12:16 UTC152
        let hex = s.strip_prefix('#').unwrap_or(&s);
7ce6ae4e5a85atagen2026-10-16 12:16 UTC153
        let bad =
7ce6ae4e5a85atagen2026-10-16 12:16 UTC154
            || serde::de::Error::custom(format!("bad colour {s:?}, use #rrggbb or #rrggbbaa"));
7ce6ae4e5a85atagen2026-10-16 12:16 UTC155
        if !matches!(hex.len(), 6 | 8) || !hex.is_ascii() {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC156
            return Err(bad());
7ce6ae4e5a85atagen2026-10-16 12:16 UTC157
        }
7ce6ae4e5a85atagen2026-10-16 12:16 UTC158
        let mut c = [1.0f32; 4];
7ce6ae4e5a85atagen2026-10-16 12:16 UTC159
        for (i, v) in c.iter_mut().enumerate().take(hex.len() / 2) {
7ce6ae4e5a85atagen2026-10-16 12:16 UTC160
            let byte = u8::from_str_radix(&hex[i * 2..i * 2 + 2], 16).map_err(|_| bad())?;
7ce6ae4e5a85atagen2026-10-16 12:16 UTC161
            *v = f32::from(byte) / 255.0;
7ce6ae4e5a85atagen2026-10-16 12:16 UTC162
        }
7ce6ae4e5a85atagen2026-10-16 12:16 UTC163
        Ok(Self(c))
7ce6ae4e5a85atagen2026-10-16 12:16 UTC164
    }
7ce6ae4e5a85atagen2026-10-16 12:16 UTC165
}
7ce6ae4e5a85atagen2026-10-16 12:16 UTC166
7ce6ae4e5a85atagen2026-10-16 12:16 UTC167
#[derive(Deserialize, Debug, Clone, PartialEq)]
7ce6ae4e5a85atagen2026-10-16 12:16 UTC168
#[serde(default, deny_unknown_fields)]
2af1d8c55876atagen2026-10-16 11:05 UTC169
pub struct Animation {
2af1d8c55876atagen2026-10-16 11:05 UTC170
    pub enabled: bool,
2af1d8c55876atagen2026-10-16 11:05 UTC171
    pub style: AnimationStyle,
2af1d8c55876atagen2026-10-16 11:05 UTC172
    /// Every phase of a planned transition lasts this long.
2af1d8c55876atagen2026-10-16 11:05 UTC173
    pub phase_ms: u64,
2af1d8c55876atagen2026-10-16 11:05 UTC174
    /// A cubic bezier, as in CSS.
2af1d8c55876atagen2026-10-16 11:05 UTC175
    pub curve: [f64; 4],
2af1d8c55876atagen2026-10-16 11:05 UTC176
}
2af1d8c55876atagen2026-10-16 11:05 UTC177
2af1d8c55876atagen2026-10-16 11:05 UTC178
impl Default for Animation {
2af1d8c55876atagen2026-10-16 11:05 UTC179
    fn default() -> Self {
2af1d8c55876atagen2026-10-16 11:05 UTC180
        Self {
2af1d8c55876atagen2026-10-16 11:05 UTC181
            enabled: true,
2af1d8c55876atagen2026-10-16 11:05 UTC182
            style: AnimationStyle::Orthogonal,
2af1d8c55876atagen2026-10-16 11:05 UTC183
            phase_ms: 160,
2af1d8c55876atagen2026-10-16 11:05 UTC184
            curve: [0.45, 0.0, 0.2, 1.0],
2af1d8c55876atagen2026-10-16 11:05 UTC185
        }
2af1d8c55876atagen2026-10-16 11:05 UTC186
    }
2af1d8c55876atagen2026-10-16 11:05 UTC187
}
2af1d8c55876atagen2026-10-16 11:05 UTC188
2af1d8c55876atagen2026-10-16 11:05 UTC189
#[derive(Deserialize, Debug, Clone, Copy, PartialEq, Eq)]
2af1d8c55876atagen2026-10-16 11:05 UTC190
#[serde(rename_all = "lowercase")]
2af1d8c55876atagen2026-10-16 11:05 UTC191
pub enum AnimationStyle {
2af1d8c55876atagen2026-10-16 11:05 UTC192
    Orthogonal,
2af1d8c55876atagen2026-10-16 11:05 UTC193
    Direct,
2af1d8c55876atagen2026-10-16 11:05 UTC194
}
2af1d8c55876atagen2026-10-16 11:05 UTC195
2af1d8c55876atagen2026-10-16 11:05 UTC196
#[derive(Deserialize, Debug, Clone, PartialEq)]
2af1d8c55876atagen2026-10-16 11:05 UTC197
#[serde(default, deny_unknown_fields)]
fe835aed6c8datagen2026-10-16 10:05 UTC198
pub struct Keyboard {
fe835aed6c8datagen2026-10-16 10:05 UTC199
    pub rules: String,
fe835aed6c8datagen2026-10-16 10:05 UTC200
    pub model: String,
fe835aed6c8datagen2026-10-16 10:05 UTC201
    pub layout: String,
fe835aed6c8datagen2026-10-16 10:05 UTC202
    pub variant: String,
fe835aed6c8datagen2026-10-16 10:05 UTC203
    pub options: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC204
    pub repeat_delay: i32,
fe835aed6c8datagen2026-10-16 10:05 UTC205
    pub repeat_rate: i32,
fe835aed6c8datagen2026-10-16 10:05 UTC206
}
fe835aed6c8datagen2026-10-16 10:05 UTC207
fe835aed6c8datagen2026-10-16 10:05 UTC208
impl Default for Keyboard {
fe835aed6c8datagen2026-10-16 10:05 UTC209
    fn default() -> Self {
fe835aed6c8datagen2026-10-16 10:05 UTC210
        Self {
fe835aed6c8datagen2026-10-16 10:05 UTC211
            rules: String::new(),
fe835aed6c8datagen2026-10-16 10:05 UTC212
            model: String::new(),
fe835aed6c8datagen2026-10-16 10:05 UTC213
            layout: String::new(),
fe835aed6c8datagen2026-10-16 10:05 UTC214
            variant: String::new(),
fe835aed6c8datagen2026-10-16 10:05 UTC215
            options: None,
fe835aed6c8datagen2026-10-16 10:05 UTC216
            repeat_delay: 200,
fe835aed6c8datagen2026-10-16 10:05 UTC217
            repeat_rate: 25,
fe835aed6c8datagen2026-10-16 10:05 UTC218
        }
fe835aed6c8datagen2026-10-16 10:05 UTC219
    }
fe835aed6c8datagen2026-10-16 10:05 UTC220
}
fe835aed6c8datagen2026-10-16 10:05 UTC221
fe835aed6c8datagen2026-10-16 10:05 UTC222
#[derive(Deserialize, Debug, Clone, Copy, PartialEq, Eq)]
fe835aed6c8datagen2026-10-16 10:05 UTC223
#[serde(rename_all = "lowercase")]
fe835aed6c8datagen2026-10-16 10:05 UTC224
pub enum Modifier {
fe835aed6c8datagen2026-10-16 10:05 UTC225
    Super,
fe835aed6c8datagen2026-10-16 10:05 UTC226
    Alt,
fe835aed6c8datagen2026-10-16 10:05 UTC227
    Ctrl,
fe835aed6c8datagen2026-10-16 10:05 UTC228
    Shift,
fe835aed6c8datagen2026-10-16 10:05 UTC229
}
fe835aed6c8datagen2026-10-16 10:05 UTC230
fe835aed6c8datagen2026-10-16 10:05 UTC231
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Hash)]
fe835aed6c8datagen2026-10-16 10:05 UTC232
pub struct Mods {
fe835aed6c8datagen2026-10-16 10:05 UTC233
    pub logo: bool,
fe835aed6c8datagen2026-10-16 10:05 UTC234
    pub alt: bool,
fe835aed6c8datagen2026-10-16 10:05 UTC235
    pub ctrl: bool,
fe835aed6c8datagen2026-10-16 10:05 UTC236
    pub shift: bool,
fe835aed6c8datagen2026-10-16 10:05 UTC237
}
fe835aed6c8datagen2026-10-16 10:05 UTC238
fe835aed6c8datagen2026-10-16 10:05 UTC239
impl Mods {
b22c0511d5afatagen2026-10-17 03:48 UTC240
    pub fn has(&self, m: Modifier) -> bool {
b22c0511d5afatagen2026-10-17 03:48 UTC241
        match m {
b22c0511d5afatagen2026-10-17 03:48 UTC242
            Modifier::Super => self.logo,
b22c0511d5afatagen2026-10-17 03:48 UTC243
            Modifier::Alt => self.alt,
b22c0511d5afatagen2026-10-17 03:48 UTC244
            Modifier::Ctrl => self.ctrl,
b22c0511d5afatagen2026-10-17 03:48 UTC245
            Modifier::Shift => self.shift,
b22c0511d5afatagen2026-10-17 03:48 UTC246
        }
b22c0511d5afatagen2026-10-17 03:48 UTC247
    }
b22c0511d5afatagen2026-10-17 03:48 UTC248
fe835aed6c8datagen2026-10-16 10:05 UTC249
    fn set(&mut self, m: Modifier) {
fe835aed6c8datagen2026-10-16 10:05 UTC250
        match m {
fe835aed6c8datagen2026-10-16 10:05 UTC251
            Modifier::Super => self.logo = true,
fe835aed6c8datagen2026-10-16 10:05 UTC252
            Modifier::Alt => self.alt = true,
fe835aed6c8datagen2026-10-16 10:05 UTC253
            Modifier::Ctrl => self.ctrl = true,
fe835aed6c8datagen2026-10-16 10:05 UTC254
            Modifier::Shift => self.shift = true,
fe835aed6c8datagen2026-10-16 10:05 UTC255
        }
fe835aed6c8datagen2026-10-16 10:05 UTC256
    }
fe835aed6c8datagen2026-10-16 10:05 UTC257
}
fe835aed6c8datagen2026-10-16 10:05 UTC258
fe835aed6c8datagen2026-10-16 10:05 UTC259
#[derive(Debug, Clone, PartialEq)]
fe835aed6c8datagen2026-10-16 10:05 UTC260
pub struct Bind {
fe835aed6c8datagen2026-10-16 10:05 UTC261
    pub mods: Mods,
fe835aed6c8datagen2026-10-16 10:05 UTC262
    /// An xkb keysym name, resolved by the compositor.
fe835aed6c8datagen2026-10-16 10:05 UTC263
    pub key: String,
fe835aed6c8datagen2026-10-16 10:05 UTC264
    pub command: Command,
fe835aed6c8datagen2026-10-16 10:05 UTC265
}
fe835aed6c8datagen2026-10-16 10:05 UTC266
fe835aed6c8datagen2026-10-16 10:05 UTC267
#[derive(Debug, Clone)]
fe835aed6c8datagen2026-10-16 10:05 UTC268
pub struct Rule {
fe835aed6c8datagen2026-10-16 10:05 UTC269
    pub app_id: Option<Regex>,
fe835aed6c8datagen2026-10-16 10:05 UTC270
    pub title: Option<Regex>,
fe835aed6c8datagen2026-10-16 10:05 UTC271
    pub tag: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC272
    pub output: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC273
    pub floating: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC274
    pub sticky: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC275
    pub scratchpad: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC276
}
fe835aed6c8datagen2026-10-16 10:05 UTC277
fe835aed6c8datagen2026-10-16 10:05 UTC278
/// Everything the matching rules say about a window, later rules winning.
fe835aed6c8datagen2026-10-16 10:05 UTC279
#[derive(Debug, Clone, Default, PartialEq)]
fe835aed6c8datagen2026-10-16 10:05 UTC280
pub struct Placement {
fe835aed6c8datagen2026-10-16 10:05 UTC281
    pub tag: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC282
    pub output: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC283
    pub floating: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC284
    pub sticky: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC285
    pub scratchpad: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC286
}
fe835aed6c8datagen2026-10-16 10:05 UTC287
fe835aed6c8datagen2026-10-16 10:05 UTC288
#[derive(Debug)]
fe835aed6c8datagen2026-10-16 10:05 UTC289
pub enum Error {
fe835aed6c8datagen2026-10-16 10:05 UTC290
    Io(PathBuf, std::io::Error),
fe835aed6c8datagen2026-10-16 10:05 UTC291
    Toml(toml::de::Error),
fe835aed6c8datagen2026-10-16 10:05 UTC292
    Bind(String, String),
fe835aed6c8datagen2026-10-16 10:05 UTC293
    Regex(String, regex::Error),
fe835aed6c8datagen2026-10-16 10:05 UTC294
}
fe835aed6c8datagen2026-10-16 10:05 UTC295
fe835aed6c8datagen2026-10-16 10:05 UTC296
impl fmt::Display for Error {
fe835aed6c8datagen2026-10-16 10:05 UTC297
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
fe835aed6c8datagen2026-10-16 10:05 UTC298
        match self {
fe835aed6c8datagen2026-10-16 10:05 UTC299
            Error::Io(p, e) => write!(f, "{}: {e}", p.display()),
fe835aed6c8datagen2026-10-16 10:05 UTC300
            Error::Toml(e) => write!(f, "{e}"),
fe835aed6c8datagen2026-10-16 10:05 UTC301
            Error::Bind(k, e) => write!(f, "bind {k:?}: {e}"),
fe835aed6c8datagen2026-10-16 10:05 UTC302
            Error::Regex(r, e) => write!(f, "rule pattern {r:?}: {e}"),
fe835aed6c8datagen2026-10-16 10:05 UTC303
        }
fe835aed6c8datagen2026-10-16 10:05 UTC304
    }
fe835aed6c8datagen2026-10-16 10:05 UTC305
}
fe835aed6c8datagen2026-10-16 10:05 UTC306
fe835aed6c8datagen2026-10-16 10:05 UTC307
impl std::error::Error for Error {}
fe835aed6c8datagen2026-10-16 10:05 UTC308
fe835aed6c8datagen2026-10-16 10:05 UTC309
#[derive(Deserialize)]
fe835aed6c8datagen2026-10-16 10:05 UTC310
#[serde(deny_unknown_fields)]
fe835aed6c8datagen2026-10-16 10:05 UTC311
struct Raw {
fe835aed6c8datagen2026-10-16 10:05 UTC312
    #[serde(default)]
fe835aed6c8datagen2026-10-16 10:05 UTC313
    startup: Vec<Vec<String>>,
fe835aed6c8datagen2026-10-16 10:05 UTC314
    #[serde(default)]
fe835aed6c8datagen2026-10-16 10:05 UTC315
    general: General,
fe835aed6c8datagen2026-10-16 10:05 UTC316
    #[serde(default)]
fe835aed6c8datagen2026-10-16 10:05 UTC317
    keyboard: Keyboard,
fe835aed6c8datagen2026-10-16 10:05 UTC318
    #[serde(default)]
2af1d8c55876atagen2026-10-16 11:05 UTC319
    animation: Animation,
2af1d8c55876atagen2026-10-16 11:05 UTC320
    #[serde(default)]
7ce6ae4e5a85atagen2026-10-16 12:16 UTC321
    decoration: Decoration,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC322
    #[serde(default)]
8e6f96f0a32datagen2026-10-16 22:17 UTC323
    output: Outputs,
8e6f96f0a32datagen2026-10-16 22:17 UTC324
    #[serde(default)]
fe835aed6c8datagen2026-10-16 10:05 UTC325
    binds: BTreeMap<String, Words>,
fe835aed6c8datagen2026-10-16 10:05 UTC326
    #[serde(default)]
fe835aed6c8datagen2026-10-16 10:05 UTC327
    rules: Vec<RawRule>,
fe835aed6c8datagen2026-10-16 10:05 UTC328
}
fe835aed6c8datagen2026-10-16 10:05 UTC329
fe835aed6c8datagen2026-10-16 10:05 UTC330
#[derive(Deserialize)]
fe835aed6c8datagen2026-10-16 10:05 UTC331
#[serde(untagged)]
fe835aed6c8datagen2026-10-16 10:05 UTC332
enum Words {
fe835aed6c8datagen2026-10-16 10:05 UTC333
    Line(String),
fe835aed6c8datagen2026-10-16 10:05 UTC334
    List(Vec<String>),
fe835aed6c8datagen2026-10-16 10:05 UTC335
}
fe835aed6c8datagen2026-10-16 10:05 UTC336
fe835aed6c8datagen2026-10-16 10:05 UTC337
#[derive(Deserialize)]
fe835aed6c8datagen2026-10-16 10:05 UTC338
#[serde(deny_unknown_fields)]
fe835aed6c8datagen2026-10-16 10:05 UTC339
struct RawRule {
fe835aed6c8datagen2026-10-16 10:05 UTC340
    app_id: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC341
    title: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC342
    tag: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC343
    output: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC344
    floating: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC345
    sticky: Option<bool>,
fe835aed6c8datagen2026-10-16 10:05 UTC346
    scratchpad: Option<String>,
fe835aed6c8datagen2026-10-16 10:05 UTC347
}
fe835aed6c8datagen2026-10-16 10:05 UTC348
fe835aed6c8datagen2026-10-16 10:05 UTC349
impl Config {
fe835aed6c8datagen2026-10-16 10:05 UTC350
    /// `$MONOLITH_CONFIG`, else `$XDG_CONFIG_HOME/monolith/config.toml`.
fe835aed6c8datagen2026-10-16 10:05 UTC351
    pub fn path() -> Option<PathBuf> {
fe835aed6c8datagen2026-10-16 10:05 UTC352
        if let Some(p) = std::env::var_os("MONOLITH_CONFIG") {
fe835aed6c8datagen2026-10-16 10:05 UTC353
            return Some(p.into());
fe835aed6c8datagen2026-10-16 10:05 UTC354
        }
fe835aed6c8datagen2026-10-16 10:05 UTC355
        let base = std::env::var_os("XDG_CONFIG_HOME")
fe835aed6c8datagen2026-10-16 10:05 UTC356
            .map(PathBuf::from)
fe835aed6c8datagen2026-10-16 10:05 UTC357
            .or_else(|| std::env::var_os("HOME").map(|h| PathBuf::from(h).join(".config")))?;
fe835aed6c8datagen2026-10-16 10:05 UTC358
        Some(base.join("monolith/config.toml"))
fe835aed6c8datagen2026-10-16 10:05 UTC359
    }
fe835aed6c8datagen2026-10-16 10:05 UTC360
fe835aed6c8datagen2026-10-16 10:05 UTC361
    /// Loads `path`, or the built-in default when it does not exist.
fe835aed6c8datagen2026-10-16 10:05 UTC362
    pub fn load(path: Option<&Path>) -> Result<Self, Error> {
fe835aed6c8datagen2026-10-16 10:05 UTC363
        match path {
fe835aed6c8datagen2026-10-16 10:05 UTC364
            Some(p) => match std::fs::read_to_string(p) {
fe835aed6c8datagen2026-10-16 10:05 UTC365
                Ok(text) => Self::parse(&text),
fe835aed6c8datagen2026-10-16 10:05 UTC366
                Err(e) if e.kind() == std::io::ErrorKind::NotFound => Self::parse(DEFAULT),
fe835aed6c8datagen2026-10-16 10:05 UTC367
                Err(e) => Err(Error::Io(p.to_owned(), e)),
fe835aed6c8datagen2026-10-16 10:05 UTC368
            },
fe835aed6c8datagen2026-10-16 10:05 UTC369
            None => Self::parse(DEFAULT),
fe835aed6c8datagen2026-10-16 10:05 UTC370
        }
fe835aed6c8datagen2026-10-16 10:05 UTC371
    }
fe835aed6c8datagen2026-10-16 10:05 UTC372
fe835aed6c8datagen2026-10-16 10:05 UTC373
    pub fn parse(text: &str) -> Result<Self, Error> {
fe835aed6c8datagen2026-10-16 10:05 UTC374
        let raw: Raw = toml::from_str(text).map_err(Error::Toml)?;
fe835aed6c8datagen2026-10-16 10:05 UTC375
        let mod_key = raw.general.mod_key;
fe835aed6c8datagen2026-10-16 10:05 UTC376
        let binds = raw
fe835aed6c8datagen2026-10-16 10:05 UTC377
            .binds
fe835aed6c8datagen2026-10-16 10:05 UTC378
            .into_iter()
fe835aed6c8datagen2026-10-16 10:05 UTC379
            .map(|(combo, words)| parse_bind(&combo, words, mod_key))
fe835aed6c8datagen2026-10-16 10:05 UTC380
            .collect::<Result<_, _>>()?;
fe835aed6c8datagen2026-10-16 10:05 UTC381
        let regex = |p: Option<String>| {
fe835aed6c8datagen2026-10-16 10:05 UTC382
            p.map(|p| Regex::new(&p).map_err(|e| Error::Regex(p, e)))
fe835aed6c8datagen2026-10-16 10:05 UTC383
                .transpose()
fe835aed6c8datagen2026-10-16 10:05 UTC384
        };
fe835aed6c8datagen2026-10-16 10:05 UTC385
        let rules = raw
fe835aed6c8datagen2026-10-16 10:05 UTC386
            .rules
fe835aed6c8datagen2026-10-16 10:05 UTC387
            .into_iter()
fe835aed6c8datagen2026-10-16 10:05 UTC388
            .map(|r| {
fe835aed6c8datagen2026-10-16 10:05 UTC389
                Ok(Rule {
fe835aed6c8datagen2026-10-16 10:05 UTC390
                    app_id: regex(r.app_id)?,
fe835aed6c8datagen2026-10-16 10:05 UTC391
                    title: regex(r.title)?,
fe835aed6c8datagen2026-10-16 10:05 UTC392
                    tag: r.tag,
fe835aed6c8datagen2026-10-16 10:05 UTC393
                    output: r.output,
fe835aed6c8datagen2026-10-16 10:05 UTC394
                    floating: r.floating,
fe835aed6c8datagen2026-10-16 10:05 UTC395
                    sticky: r.sticky,
fe835aed6c8datagen2026-10-16 10:05 UTC396
                    scratchpad: r.scratchpad,
fe835aed6c8datagen2026-10-16 10:05 UTC397
                })
fe835aed6c8datagen2026-10-16 10:05 UTC398
            })
fe835aed6c8datagen2026-10-16 10:05 UTC399
            .collect::<Result<_, Error>>()?;
fe835aed6c8datagen2026-10-16 10:05 UTC400
        Ok(Self {
fe835aed6c8datagen2026-10-16 10:05 UTC401
            general: raw.general,
2af1d8c55876atagen2026-10-16 11:05 UTC402
            animation: raw.animation,
7ce6ae4e5a85atagen2026-10-16 12:16 UTC403
            decoration: raw.decoration,
8e6f96f0a32datagen2026-10-16 22:17 UTC404
            output: raw.output,
fe835aed6c8datagen2026-10-16 10:05 UTC405
            keyboard: raw.keyboard,
fe835aed6c8datagen2026-10-16 10:05 UTC406
            binds,
fe835aed6c8datagen2026-10-16 10:05 UTC407
            rules,
fe835aed6c8datagen2026-10-16 10:05 UTC408
            startup: raw.startup,
fe835aed6c8datagen2026-10-16 10:05 UTC409
        })
fe835aed6c8datagen2026-10-16 10:05 UTC410
    }
fe835aed6c8datagen2026-10-16 10:05 UTC411
fe835aed6c8datagen2026-10-16 10:05 UTC412
    pub fn placement(&self, app_id: &str, title: &str) -> Placement {
fe835aed6c8datagen2026-10-16 10:05 UTC413
        let mut p = Placement::default();
fe835aed6c8datagen2026-10-16 10:05 UTC414
        let hit = |re: &Option<Regex>, s: &str| re.as_ref().is_none_or(|re| re.is_match(s));
fe835aed6c8datagen2026-10-16 10:05 UTC415
        for r in &self.rules {
fe835aed6c8datagen2026-10-16 10:05 UTC416
            if !hit(&r.app_id, app_id) || !hit(&r.title, title) {
fe835aed6c8datagen2026-10-16 10:05 UTC417
                continue;
fe835aed6c8datagen2026-10-16 10:05 UTC418
            }
fe835aed6c8datagen2026-10-16 10:05 UTC419
            p.tag = r.tag.clone().or(p.tag);
fe835aed6c8datagen2026-10-16 10:05 UTC420
            p.output = r.output.clone().or(p.output);
fe835aed6c8datagen2026-10-16 10:05 UTC421
            p.floating = r.floating.or(p.floating);
fe835aed6c8datagen2026-10-16 10:05 UTC422
            p.sticky = r.sticky.or(p.sticky);
fe835aed6c8datagen2026-10-16 10:05 UTC423
            p.scratchpad = r.scratchpad.clone().or(p.scratchpad);
fe835aed6c8datagen2026-10-16 10:05 UTC424
        }
fe835aed6c8datagen2026-10-16 10:05 UTC425
        p
fe835aed6c8datagen2026-10-16 10:05 UTC426
    }
fe835aed6c8datagen2026-10-16 10:05 UTC427
}
fe835aed6c8datagen2026-10-16 10:05 UTC428
fe835aed6c8datagen2026-10-16 10:05 UTC429
fn parse_bind(combo: &str, words: Words, mod_key: Modifier) -> Result<Bind, Error> {
fe835aed6c8datagen2026-10-16 10:05 UTC430
    let bad = |m: String| Error::Bind(combo.to_owned(), m);
fe835aed6c8datagen2026-10-16 10:05 UTC431
    let parts: Vec<&str> = combo.split('+').map(str::trim).collect();
fe835aed6c8datagen2026-10-16 10:05 UTC432
    let Some((&key, mods)) = parts.split_last().filter(|(k, _)| !k.is_empty()) else {
fe835aed6c8datagen2026-10-16 10:05 UTC433
        return Err(bad("no key".into()));
fe835aed6c8datagen2026-10-16 10:05 UTC434
    };
fe835aed6c8datagen2026-10-16 10:05 UTC435
    let mut set = Mods::default();
fe835aed6c8datagen2026-10-16 10:05 UTC436
    for m in mods {
fe835aed6c8datagen2026-10-16 10:05 UTC437
        let m = match m.to_ascii_lowercase().as_str() {
fe835aed6c8datagen2026-10-16 10:05 UTC438
            "mod" => mod_key,
fe835aed6c8datagen2026-10-16 10:05 UTC439
            "super" | "logo" | "win" => Modifier::Super,
fe835aed6c8datagen2026-10-16 10:05 UTC440
            "alt" => Modifier::Alt,
fe835aed6c8datagen2026-10-16 10:05 UTC441
            "ctrl" | "control" => Modifier::Ctrl,
fe835aed6c8datagen2026-10-16 10:05 UTC442
            "shift" => Modifier::Shift,
fe835aed6c8datagen2026-10-16 10:05 UTC443
            other => return Err(bad(format!("unknown modifier {other}"))),
fe835aed6c8datagen2026-10-16 10:05 UTC444
        };
fe835aed6c8datagen2026-10-16 10:05 UTC445
        set.set(m);
fe835aed6c8datagen2026-10-16 10:05 UTC446
    }
fe835aed6c8datagen2026-10-16 10:05 UTC447
    let words: Vec<String> = match words {
fe835aed6c8datagen2026-10-16 10:05 UTC448
        Words::Line(s) => s.split_whitespace().map(str::to_owned).collect(),
fe835aed6c8datagen2026-10-16 10:05 UTC449
        Words::List(v) => v,
fe835aed6c8datagen2026-10-16 10:05 UTC450
    };
fe835aed6c8datagen2026-10-16 10:05 UTC451
    let command = Command::parse(&words).map_err(|e| bad(e.0))?;
fe835aed6c8datagen2026-10-16 10:05 UTC452
    Ok(Bind {
fe835aed6c8datagen2026-10-16 10:05 UTC453
        mods: set,
fe835aed6c8datagen2026-10-16 10:05 UTC454
        key: key.to_owned(),
fe835aed6c8datagen2026-10-16 10:05 UTC455
        command,
fe835aed6c8datagen2026-10-16 10:05 UTC456
    })
fe835aed6c8datagen2026-10-16 10:05 UTC457
}
fe835aed6c8datagen2026-10-16 10:05 UTC458
fe835aed6c8datagen2026-10-16 10:05 UTC459
#[cfg(test)]
fe835aed6c8datagen2026-10-16 10:05 UTC460
mod tests {
b22c0511d5afatagen2026-10-17 03:48 UTC461
    use super::*;
b22c0511d5afatagen2026-10-17 03:48 UTC462
b22c0511d5afatagen2026-10-17 03:48 UTC463
    /// default.toml documents the defaults for users, and the Default impls
b22c0511d5afatagen2026-10-17 03:48 UTC464
    /// apply them to sections a user config leaves out. They must agree.
fe835aed6c8datagen2026-10-16 10:05 UTC465
    #[test]
b22c0511d5afatagen2026-10-17 03:48 UTC466
    fn default_toml_states_the_defaults() {
b22c0511d5afatagen2026-10-17 03:48 UTC467
        let c = Config::parse(DEFAULT).unwrap();
b22c0511d5afatagen2026-10-17 03:48 UTC468
        assert_eq!(c.general, General::default());
b22c0511d5afatagen2026-10-17 03:48 UTC469
        assert_eq!(c.output, Outputs::default());
b22c0511d5afatagen2026-10-17 03:48 UTC470
        assert_eq!(c.decoration, Decoration::default());
b22c0511d5afatagen2026-10-17 03:48 UTC471
        assert_eq!(c.animation, Animation::default());
b22c0511d5afatagen2026-10-17 03:48 UTC472
        assert_eq!(c.keyboard, Keyboard::default());
fe835aed6c8datagen2026-10-16 10:05 UTC473
        assert!(c.binds.len() > 40);
fe835aed6c8datagen2026-10-16 10:05 UTC474
    }
fe835aed6c8datagen2026-10-16 10:05 UTC475
}