splashboard 2.10.2

#![allow(dead_code)]

use std::path::{Path, PathBuf};

use serde::Deserialize;

use crate::layout::{BgLevel, BorderStyle, Child, Flex, Layout, TitleAlign};
use crate::render::RenderSpec;
use crate::theme::ThemeConfig;

const DEFAULT_SETTINGS: &str = include_str!("default_settings.toml");
const DEFAULT_HOME_DASHBOARD: &str = include_str!("default_home_dashboard.toml");
const DEFAULT_PROJECT_DASHBOARD: &str = include_str!("default_project_dashboard.toml");

/// Combined view the runtime consumes: user preferences composed with the active dashboard.
#[derive(Debug, Clone, Default)]
pub struct Config {
    pub general: General,
    pub theme: ThemeConfig,
    pub widgets: Vec<WidgetConfig>,
    pub rows: Vec<RowConfig>,
}

/// User preferences: `[general]` + `[theme]`. Loaded from `$HOME/.splashboard/settings.toml`.
/// Shared across every dashboard the same user sees; per-dir overrides are 0.x out of scope.
#[derive(Debug, Clone, Default, Deserialize)]
pub struct SettingsConfig {
    #[serde(default)]
    pub general: General,
    /// Semantic colour overrides. Omitted keys use the built-in defaults; see
    /// [`crate::theme`] for the list of tokens.
    #[serde(default)]
    pub theme: ThemeConfig,
}

/// Widgets + rows. Loaded from one of:
///
/// - a per-dir `./.splashboard/dashboard.toml` or `./.splashboard.toml`
/// - `$HOME/.splashboard/project.dashboard.toml` (CWD == git repo root, no per-dir override)
/// - `$HOME/.splashboard/home.dashboard.toml` (everything else)
#[derive(Debug, Clone, Default, Deserialize)]
pub struct DashboardConfig {
    #[serde(default, rename = "widget")]
    pub widgets: Vec<WidgetConfig>,
    #[serde(default, rename = "row")]
    pub rows: Vec<RowConfig>,
}

#[derive(Debug, Clone, Deserialize)]
pub struct General {
    #[serde(default)]
    pub wait_for_fresh: bool,
    /// Inline viewport height in rows. `None` uses the built-in default. Configs that ship more
    /// widgets than fit in the default bump this to make room.
    #[serde(default)]
    pub height: Option<u16>,
    /// Space reserved around the root layout. `padding = 1` pads one cell on all four sides;
    /// `padding = { x = 2, y = 1 }` splits horizontal / vertical. The viewport bg (if any)
    /// still paints across the whole splash area so the padded band shows the theme colour,
    /// not the terminal background.
    #[serde(default)]
    pub padding: Option<PaddingSpec>,
    /// IANA timezone name (`"Asia/Tokyo"`, `"UTC"`, …) applied to every fetcher and renderer
    /// that emits a human-readable timestamp. Unset (or unrecognised) falls back to the host's
    /// `Local` zone — matching pre-config behaviour. Per-widget options can still override
    /// (for example each `clock_*` widget already carries its own `timezone` knob).
    #[serde(default)]
    pub timezone: Option<String>,
    /// Locale code (`"en_US"`, `"ja_JP"`, …) for chrono's localized month / weekday names.
    /// Requires the `unstable-locales` chrono feature. Unset falls back to `Locale::POSIX`,
    /// which matches chrono's hard-coded English output and keeps unmigrated configs
    /// rendering identical strings.
    #[serde(default)]
    pub locale: Option<String>,
    /// Render the home dashboard automatically on shell startup. Default `true`.
    /// Set to `false` to keep `splashboard` quiet when CWD doesn't resolve to a project,
    /// while still letting the cd-hook paint the project splash on entry.
    #[serde(default = "default_true")]
    pub auto_home: bool,
    /// Run the cd-hook (`splashboard --on-cd`) when entering a project directory. Default
    /// `true`. Set to `false` to disable per-`cd` repaints without unwiring the shell rc.
    #[serde(default = "default_true")]
    pub auto_on_cd: bool,
    /// When the configured dashboard is taller than the terminal viewport, push the
    /// overflowing top rows into shell scrollback (so the user can scroll up to see them)
    /// instead of just clipping with a `… +N rows` hint. Default `false`: the flush path
    /// drags every renderer through ratatui's `insert_before` write loop, which doesn't
    /// honour `Cell::skip` and visibly overdraws stateful image protocols (kitty / iTerm2 /
    /// sixel) in the scrollback portion. Opt in only when the dashboard is text-only and
    /// you specifically want the overflow in scrollback.
    #[serde(default)]
    pub flush_to_scrollback: bool,
}

fn default_true() -> bool {
    true
}

impl Default for General {
    fn default() -> Self {
        Self {
            wait_for_fresh: false,
            height: None,
            padding: None,
            timezone: None,
            locale: None,
            auto_home: true,
            auto_on_cd: true,
            flush_to_scrollback: false,
        }
    }
}

/// Uniform or split padding. Short form `padding = 1` applies the same value to all sides;
/// long form `{ x, y }` sets horizontal (left + right) and vertical (top + bottom) separately.
#[derive(Debug, Clone, Copy, Deserialize)]
#[serde(untagged)]
pub enum PaddingSpec {
    Uniform(u16),
    Axes {
        #[serde(default)]
        x: u16,
        #[serde(default)]
        y: u16,
    },
}

impl PaddingSpec {
    /// (`x`, `y`) where `x` is left+right-per-side and `y` is top+bottom-per-side.
    pub fn xy(&self) -> (u16, u16) {
        match self {
            Self::Uniform(n) => (*n, *n),
            Self::Axes { x, y } => (*x, *y),
        }
    }
}

#[derive(Debug, Clone, Deserialize, Default)]
pub struct WidgetConfig {
    pub id: String,
    pub fetcher: String,
    /// Renderer selection. `render = "text_plain"` (short form) or
    /// `render = { type = "text_ascii", pixel_size = "quadrant" }` (full form with options).
    /// Absent = pick the default renderer for the fetcher's shape.
    #[serde(default)]
    pub render: Option<RenderSpec>,
    #[serde(default)]
    pub format: Option<String>,
    #[serde(default)]
    pub refresh_interval: Option<u64>,
    /// read_store: file format — "json", "toml", or "text". Other fetchers ignore it.
    #[serde(default)]
    pub file_format: Option<String>,
    /// Fetcher-specific options as a TOML sub-table (`[widget.options]`). Each fetcher
    /// deserializes the keys it cares about; unknown keys are ignored so upgrading the
    /// fetcher never invalidates old configs.
    #[serde(default)]
    pub options: Option<toml::Value>,
}

#[derive(Debug, Clone, Deserialize)]
pub struct RowConfig {
    #[serde(default)]
    pub height: Option<SizeSpec>,
    #[serde(default)]
    pub title: Option<String>,
    #[serde(default)]
    pub title_align: Option<TitleAlignSpec>,
    #[serde(default)]
    pub border: Option<BorderSpec>,
    /// How children are placed along this row's horizontal axis when they don't fill the row.
    /// `center` is the obvious use case: a narrower widget parked in the middle of its row.
    #[serde(default)]
    pub flex: Option<FlexSpec>,
    /// Which semantic background paints this row. `default` (or omitted) inherits the
    /// viewport bg; `subtle` paints `theme.bg_subtle` — use it to lift header/footer bands
    /// visually off the main content.
    #[serde(default)]
    pub bg: Option<BgSpec>,
    /// Horizontal gap inserted between sibling children, in cells. Sugar for the common
    /// 2/3-column case — `gap = 2` auto-splices empty spacers between children so configs
    /// don't have to declare a `basic_static` "gap" widget just to carve whitespace.
    #[serde(default)]
    pub gap: Option<u16>,
    #[serde(default, rename = "child")]
    pub children: Vec<ChildConfig>,
}

#[derive(Debug, Clone, Copy, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum BgSpec {
    /// Inherit whatever the viewport painted (usually `theme.bg`).
    Default,
    /// Paint `theme.bg_subtle` behind this slot — for header/footer/callout bands.
    Subtle,
}

#[derive(Debug, Clone, Copy, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum FlexSpec {
    Legacy,
    Start,
    Center,
    End,
    SpaceBetween,
    SpaceAround,
}

#[derive(Debug, Clone, Deserialize)]
pub struct ChildConfig {
    /// Referenced widget id. Absent means this child is a pure layout spacer — the slot
    /// reserves its `width` but paints nothing. Preferred over the historical
    /// `basic_static`-with-empty-format hack for gap columns. Mutually exclusive with `rows`.
    #[serde(default)]
    pub widget: Option<String>,
    #[serde(default)]
    pub width: Option<SizeSpec>,
    #[serde(default)]
    pub title: Option<String>,
    #[serde(default)]
    pub title_align: Option<TitleAlignSpec>,
    #[serde(default)]
    pub border: Option<BorderSpec>,
    /// Per-child background; see [`RowConfig::bg`].
    #[serde(default)]
    pub bg: Option<BgSpec>,
    /// Nested rows stacked vertically inside this child cell. Lets a single cell host a
    /// sub-layout (e.g. uptime above load-avg in the right gutter of a thermometer row).
    /// Mutually exclusive with `widget`; when both are set, `rows` wins.
    #[serde(default, rename = "row")]
    pub rows: Vec<RowConfig>,
}

/// Title alignment on a `border = "top"` (or any bordered) panel. `left` matches ratatui's
/// default; `center` gives `──  title  ──` style section dividers.
#[derive(Debug, Clone, Copy, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum TitleAlignSpec {
    Left,
    Center,
    Right,
}

#[derive(Debug, Clone, Copy, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum SizeSpec {
    Fill(u16),
    Length(u16),
    Min(u16),
    Max(u16),
    Percentage(u16),
    /// `height = "auto"` — row / child sizes itself to the rendered content.
    /// Resolves at draw time via the renderer's `natural_height`, so a figlet
    /// hero that word-wraps onto a second block gets the row height it needs
    /// while a single-word hero fits in its natural 7-row box.
    Auto,
}

#[derive(Debug, Clone, Copy, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum BorderSpec {
    /// No chrome at all — widget fills its full cell, no title drawn. Useful for hero
    /// elements like a big clock that should own its slot without framing.
    None,
    Plain,
    Rounded,
    Thick,
    Double,
    /// Single top edge only, plain style — `border = "top"` + `title = "..."` paints a
    /// section divider above the row. No side or bottom chrome is drawn, so the row keeps
    /// its full inner width for the body beneath the rule.
    Top,
}

impl Config {
    pub fn from_parts(settings: SettingsConfig, dashboard: DashboardConfig) -> Self {
        Self {
            general: settings.general,
            theme: settings.theme,
            widgets: dashboard.widgets,
            rows: dashboard.rows,
        }
    }

    pub fn to_layout(&self) -> Layout {
        Layout::rows(self.rows.iter().map(to_row_child).collect())
    }

    /// Sum of row heights — what the inline viewport needs to be to fit every row without
    /// clipping the bottom. Non-Length sizes fall back to reasonable approximations
    /// (Min/Max use their value, Fill contributes a small default, Percentage is ignored
    /// since it can't resolve without a known viewport).
    pub fn computed_height(&self) -> u16 {
        let rows: u16 = self
            .rows
            .iter()
            .map(|r| row_height_estimate(r.height))
            .sum();
        let pad_y = self
            .general
            .padding
            .map(|p| p.xy().1)
            .unwrap_or(0)
            .saturating_mul(2);
        rows.saturating_add(pad_y)
    }
}

impl SettingsConfig {
    pub fn default_baked() -> Self {
        toml::from_str(DEFAULT_SETTINGS).expect("built-in default settings must parse")
    }

    pub fn parse(toml_str: &str) -> Result<Self, String> {
        toml::from_str(toml_str).map_err(|e| e.to_string())
    }

    /// Loads the user's settings file, or the baked default if it's missing. Errors bubble up
    /// for parse failures so users see what's broken instead of silently getting defaults.
    pub fn load_or_default(path: &Path) -> Result<Self, String> {
        match std::fs::read_to_string(path) {
            Ok(s) => Self::parse(&s).map_err(|e| format!("{}: {e}", path.display())),
            Err(e) if e.kind() == std::io::ErrorKind::NotFound => Ok(Self::default_baked()),
            Err(e) => Err(format!("{}: {e}", path.display())),
        }
    }
}

impl DashboardConfig {
    pub fn default_home() -> Self {
        toml::from_str(DEFAULT_HOME_DASHBOARD).expect("built-in home dashboard must parse")
    }

    pub fn default_project() -> Self {
        toml::from_str(DEFAULT_PROJECT_DASHBOARD).expect("built-in project dashboard must parse")
    }

    pub fn parse(toml_str: &str) -> Result<Self, String> {
        toml::from_str(toml_str).map_err(|e| e.to_string())
    }
}

/// Where the active dashboard came from. Drives trust gating (local files need explicit trust;
/// the HOME-backed defaults are implicitly trusted) and which baked fallback applies when the
/// file is missing.
#[derive(Debug, Clone)]
pub enum DashboardSource {
    /// Per-dir dashboard discovered in the CWD (`./.splashboard/dashboard.toml` or
    /// `./.splashboard.toml`). Trust-gated.
    Local(PathBuf),
    /// `$HOME/.splashboard/project.dashboard.toml` — used when CWD is a git repo root and no
    /// per-dir dashboard overrides. Baked-in default applies when the file is absent.
    Project,
    /// `$HOME/.splashboard/home.dashboard.toml` — the ambient fallback. Baked-in default
    /// applies when the file is absent.
    Home,
}

pub const LOCAL_DASHBOARD_CANDIDATES: &[&str] =
    &[".splashboard/dashboard.toml", ".splashboard.toml"];

/// Dashboard resolution for a shell-startup render. Returns `Home` as a final fallback so the
/// splash always has something to show.
pub fn resolve_dashboard_source() -> DashboardSource {
    let cwd = std::env::current_dir().ok();
    match cwd.as_deref() {
        Some(c) => resolve_from(c, /* on_cd = */ false).unwrap_or(DashboardSource::Home),
        None => DashboardSource::Home,
    }
}

/// Dashboard resolution for an `--on-cd` render. Returns `None` in the fallback case so the
/// shell hook exits silently instead of repainting the home splash on every `cd`.
pub fn resolve_on_cd_dashboard_source() -> Option<DashboardSource> {
    let cwd = std::env::current_dir().ok()?;
    resolve_from(&cwd, /* on_cd = */ true)
}

/// Nearest project-local dashboard file, for the trust subcommands. Walks up ancestors so
/// running `splashboard trust` from a subdirectory picks the same dashboard the startup
/// resolver would use at the repo root.
pub fn resolve_local_dashboard_path() -> Option<PathBuf> {
    let cwd = std::env::current_dir().ok()?;
    find_local_walking_up(&cwd)
}

fn resolve_from(cwd: &Path, on_cd: bool) -> Option<DashboardSource> {
    if is_home_dir(cwd) {
        // Dotfiles-in-git case: CWD == $HOME still means "home context", not "project".
        return Some(DashboardSource::Home);
    }
    if let Some(path) = find_local_at(cwd) {
        return Some(DashboardSource::Local(path));
    }
    if is_git_repo_root(cwd) {
        return Some(DashboardSource::Project);
    }
    if on_cd {
        None
    } else {
        Some(DashboardSource::Home)
    }
}

fn is_home_dir(path: &Path) -> bool {
    // Respect `HOME` first so the test suite can redirect the home dir on any platform.
    // On Windows, `dirs::home_dir()` consults `SHGetKnownFolderPath(FOLDERID_Profile)` and
    // ignores env vars; checking `HOME` keeps behavior aligned with shells that set it
    // (git-bash, MSYS, WSL, configured PowerShell profiles).
    let home = std::env::var_os("HOME")
        .map(PathBuf::from)
        .or_else(dirs::home_dir);
    let Some(home) = home else {
        return false;
    };
    canonicalize_or(path) == canonicalize_or(&home)
}

fn canonicalize_or(path: &Path) -> PathBuf {
    path.canonicalize().unwrap_or_else(|_| path.to_path_buf())
}

fn is_git_repo_root(cwd: &Path) -> bool {
    // "CWD == repo root" using direct `.git` presence. `gix::discover` walks upward, so using
    // it here would misclassify subdirectories as project roots and re-render the project
    // dashboard on every sub-cd. Checking for `.git` right here keeps the rule crisp.
    let dot_git = cwd.join(".git");
    dot_git.is_dir() || dot_git.is_file()
}

fn find_local_walking_up(start: &Path) -> Option<PathBuf> {
    let mut current = Some(start);
    while let Some(dir) = current {
        if let Some(path) = find_local_at(dir) {
            return Some(path);
        }
        current = dir.parent();
    }
    None
}

fn find_local_at(dir: &Path) -> Option<PathBuf> {
    LOCAL_DASHBOARD_CANDIDATES
        .iter()
        .map(|name| dir.join(name))
        .find(|p| p.is_file())
}

fn row_height_estimate(size: Option<SizeSpec>) -> u16 {
    match size {
        Some(SizeSpec::Length(n)) | Some(SizeSpec::Min(n)) | Some(SizeSpec::Max(n)) => n,
        Some(SizeSpec::Fill(_)) => 3,
        Some(SizeSpec::Percentage(_)) => 0,
        // Content-sized rows don't know their height until render, so use the same
        // Fill default estimate used by other flexible sizes for viewport sizing.
        Some(SizeSpec::Auto) => 3,
        None => 3,
    }
}

fn to_row_child(row: &RowConfig) -> Child {
    let cols = intersperse_gaps(row.children.iter().map(to_col_child).collect(), row.gap);
    let mut inner = Layout::cols(cols);
    if let Some(f) = row.flex {
        inner = inner.flexed(to_flex(f));
    }
    let decorated = apply_panel(inner, row.title.as_deref(), row.border, row.title_align);
    let decorated = apply_bg(decorated, row.bg);
    make_child(row.height, decorated)
}

fn intersperse_gaps(children: Vec<Child>, gap: Option<u16>) -> Vec<Child> {
    let Some(n) = gap.filter(|n| *n > 0) else {
        return children;
    };
    let mut out = Vec::with_capacity(children.len() * 2);
    for (i, c) in children.into_iter().enumerate() {
        if i > 0 {
            out.push(Child::length(n, Layout::Empty));
        }
        out.push(c);
    }
    out
}

fn to_flex(f: FlexSpec) -> Flex {
    match f {
        FlexSpec::Legacy => Flex::Legacy,
        FlexSpec::Start => Flex::Start,
        FlexSpec::Center => Flex::Center,
        FlexSpec::End => Flex::End,
        FlexSpec::SpaceBetween => Flex::SpaceBetween,
        FlexSpec::SpaceAround => Flex::SpaceAround,
    }
}

fn to_col_child(c: &ChildConfig) -> Child {
    let leaf = if c.rows.is_empty() {
        match c.widget.as_deref() {
            Some(id) => Layout::widget(id.to_string()),
            None => Layout::Empty,
        }
    } else {
        Layout::rows(c.rows.iter().map(to_row_child).collect())
    };
    let decorated = apply_panel(leaf, c.title.as_deref(), c.border, c.title_align);
    let decorated = apply_bg(decorated, c.bg);
    make_child(c.width, decorated)
}

fn apply_bg(layout: Layout, bg: Option<BgSpec>) -> Layout {
    match bg {
        None | Some(BgSpec::Default) => layout,
        Some(BgSpec::Subtle) => layout.with_bg(BgLevel::Subtle),
    }
}

fn make_child(size: Option<SizeSpec>, layout: Layout) -> Child {
    match size {
        Some(SizeSpec::Fill(w)) => Child::fill(w, layout),
        Some(SizeSpec::Length(n)) => Child::length(n, layout),
        Some(SizeSpec::Min(n)) => Child::min(n, layout),
        Some(SizeSpec::Max(n)) => Child::max(n, layout),
        Some(SizeSpec::Percentage(p)) => Child::percentage(p, layout),
        Some(SizeSpec::Auto) => Child::auto(layout),
        None => Child::fill(1, layout),
    }
}

fn apply_panel(
    layout: Layout,
    title: Option<&str>,
    border: Option<BorderSpec>,
    title_align: Option<TitleAlignSpec>,
) -> Layout {
    // Chrome is opt-in: no border, no panel — even if a title was set. A bare title has no
    // border to render on, so dropping it cleanly is better than pretending. Users who want
    // the framed-with-label look set `border = "rounded"` (or plain/thick/double) explicitly
    // on the widgets that deserve it (charts, tables), keeping hero widgets (clock, greeting)
    // chromeless by default.
    let Some(style) = border.and_then(to_border_style) else {
        return layout;
    };
    let l = match title {
        Some(t) => layout.titled(t).title_aligned(to_title_align(title_align)),
        None => layout,
    };
    l.bordered(style)
}

fn to_title_align(spec: Option<TitleAlignSpec>) -> TitleAlign {
    match spec {
        Some(TitleAlignSpec::Center) => TitleAlign::Center,
        Some(TitleAlignSpec::Right) => TitleAlign::Right,
        Some(TitleAlignSpec::Left) | None => TitleAlign::Left,
    }
}

fn to_border_style(b: BorderSpec) -> Option<BorderStyle> {
    match b {
        BorderSpec::None => None,
        BorderSpec::Plain => Some(BorderStyle::Plain),
        BorderSpec::Rounded => Some(BorderStyle::Rounded),
        BorderSpec::Thick => Some(BorderStyle::Thick),
        BorderSpec::Double => Some(BorderStyle::Double),
        BorderSpec::Top => Some(BorderStyle::Top),
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::layout::Size;

    #[test]
    fn default_baked_settings_parses() {
        let _ = SettingsConfig::default_baked();
    }

    #[test]
    fn default_home_dashboard_parses() {
        let _ = DashboardConfig::default_home();
    }

    #[test]
    fn default_project_dashboard_parses() {
        let _ = DashboardConfig::default_project();
    }

    #[test]
    fn minimal_dashboard_parses() {
        let toml = r#"
[[widget]]
id = "x"
fetcher = "basic_static"
render = "text_plain"

[[row]]
height = { length = 3 }
[[row.child]]
widget = "x"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert_eq!(d.widgets.len(), 1);
        assert_eq!(d.rows.len(), 1);
        assert_eq!(d.rows[0].children.len(), 1);
    }

    #[test]
    fn size_spec_accepts_variants() {
        let toml = r#"
[[widget]]
id = "x"
fetcher = "f"
render = "text_plain"

[[row]]
height = { fill = 2 }
[[row.child]]
widget = "x"
width = { percentage = 50 }

[[row]]
height = { min = 6 }
[[row.child]]
widget = "x"
width = { max = 30 }
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert!(matches!(d.rows[0].height, Some(SizeSpec::Fill(2))));
        assert!(matches!(
            d.rows[0].children[0].width,
            Some(SizeSpec::Percentage(50))
        ));
        assert!(matches!(d.rows[1].height, Some(SizeSpec::Min(6))));
        assert!(matches!(
            d.rows[1].children[0].width,
            Some(SizeSpec::Max(30))
        ));
    }

    #[test]
    fn border_spec_parses_all_styles() {
        for name in ["plain", "rounded", "thick", "double", "top"] {
            let toml = format!(
                r#"
[[widget]]
id = "x"
fetcher = "f"
render = "text_plain"

[[row]]
border = "{name}"
[[row.child]]
widget = "x"
"#
            );
            DashboardConfig::parse(&toml).unwrap();
        }
    }

    #[test]
    fn bg_spec_parses_on_row_and_child() {
        let toml = r#"
[[widget]]
id = "x"
fetcher = "basic_static"
render = "text_plain"

[[row]]
bg = "subtle"
height = { length = 2 }
[[row.child]]
widget = "x"
bg = "default"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert_eq!(d.rows[0].bg, Some(BgSpec::Subtle));
        assert_eq!(d.rows[0].children[0].bg, Some(BgSpec::Default));
    }

    #[test]
    fn invalid_dashboard_toml_returns_error() {
        let r = DashboardConfig::parse("this is not [valid toml");
        assert!(r.is_err());
    }

    #[test]
    fn missing_settings_file_falls_back_to_default() {
        let path = Path::new("/does/not/exist.toml");
        let s = SettingsConfig::load_or_default(path).unwrap();
        assert!(s.general.height.is_none());
    }

    #[test]
    fn settings_parses_general_and_theme() {
        let toml = r#"
[general]
wait_for_fresh = true
height = 24

[theme]
preset = "nord"
"#;
        let s = SettingsConfig::parse(toml).unwrap();
        assert!(s.general.wait_for_fresh);
        assert_eq!(s.general.height, Some(24));
        assert_eq!(s.theme.preset.as_deref(), Some("nord"));
    }

    #[test]
    fn padding_xy_and_computed_height_cover_size_fallbacks() {
        assert_eq!(PaddingSpec::Uniform(3).xy(), (3, 3));
        assert_eq!(PaddingSpec::Axes { x: 4, y: 2 }.xy(), (4, 2));

        let row = |height| RowConfig {
            height,
            title: None,
            title_align: None,
            border: None,
            flex: None,
            bg: None,
            gap: None,
            children: vec![],
        };
        let config = Config {
            general: General {
                padding: Some(PaddingSpec::Axes { x: 9, y: 2 }),
                ..General::default()
            },
            theme: ThemeConfig::default(),
            widgets: vec![],
            rows: vec![
                row(Some(SizeSpec::Length(4))),
                row(Some(SizeSpec::Min(5))),
                row(Some(SizeSpec::Max(6))),
                row(Some(SizeSpec::Fill(7))),
                row(Some(SizeSpec::Percentage(50))),
                row(Some(SizeSpec::Auto)),
                row(None),
            ],
        };

        assert_eq!(config.computed_height(), 28);
    }

    #[test]
    fn load_or_default_prefixes_non_missing_io_errors() {
        let dir = tempfile::tempdir().unwrap();
        let err = SettingsConfig::load_or_default(dir.path()).unwrap_err();
        assert!(err.starts_with(&format!("{}:", dir.path().display())));
    }

    #[test]
    fn auto_display_toggles_default_to_true() {
        let s = SettingsConfig::default_baked();
        assert!(s.general.auto_home);
        assert!(s.general.auto_on_cd);
    }

    #[test]
    fn auto_display_toggles_parse_when_false() {
        let toml = r#"
[general]
auto_home = false
auto_on_cd = false
"#;
        let s = SettingsConfig::parse(toml).unwrap();
        assert!(!s.general.auto_home);
        assert!(!s.general.auto_on_cd);
    }

    #[test]
    fn auto_display_toggles_partial_override_keeps_other_default() {
        let toml = r#"
[general]
auto_home = false
"#;
        let s = SettingsConfig::parse(toml).unwrap();
        assert!(!s.general.auto_home);
        assert!(s.general.auto_on_cd);
    }

    #[test]
    fn dashboard_ignores_stray_settings_sections() {
        // Dashboard files may end up with leftover `[general]` / `[theme]` blocks after a
        // manual migration. Silently ignore them so the dashboard still parses.
        let toml = r#"
[general]
wait_for_fresh = true

[theme]
preset = "nord"

[[widget]]
id = "x"
fetcher = "basic_static"

[[row]]
[[row.child]]
widget = "x"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert_eq!(d.widgets.len(), 1);
        assert_eq!(d.rows.len(), 1);
    }

    #[test]
    fn find_local_picks_up_flat_file() {
        let dir = tempfile::tempdir().unwrap();
        let file = dir.path().join(".splashboard.toml");
        std::fs::write(&file, "").unwrap();
        assert_eq!(find_local_at(dir.path()).unwrap(), file);
    }

    #[test]
    fn find_local_picks_up_directory_form() {
        let dir = tempfile::tempdir().unwrap();
        let subdir = dir.path().join(".splashboard");
        std::fs::create_dir(&subdir).unwrap();
        let file = subdir.join("dashboard.toml");
        std::fs::write(&file, "").unwrap();
        assert_eq!(find_local_at(dir.path()).unwrap(), file);
    }

    #[test]
    fn find_local_prefers_directory_form_when_both_exist() {
        let dir = tempfile::tempdir().unwrap();
        std::fs::create_dir(dir.path().join(".splashboard")).unwrap();
        let dir_file = dir.path().join(".splashboard/dashboard.toml");
        std::fs::write(&dir_file, "").unwrap();
        std::fs::write(dir.path().join(".splashboard.toml"), "").unwrap();
        assert_eq!(find_local_at(dir.path()).unwrap(), dir_file);
    }

    #[test]
    fn find_local_walks_up_to_ancestor() {
        let root = tempfile::tempdir().unwrap();
        let file = root.path().join(".splashboard.toml");
        std::fs::write(&file, "").unwrap();
        let nested = root.path().join("a").join("b").join("c");
        std::fs::create_dir_all(&nested).unwrap();
        assert_eq!(find_local_walking_up(&nested).unwrap(), file);
    }

    #[test]
    fn find_local_walking_up_returns_none_when_absent() {
        let dir = tempfile::tempdir().unwrap();
        assert!(find_local_walking_up(dir.path()).is_none());
    }

    #[test]
    fn find_local_at_does_not_walk_up() {
        let root = tempfile::tempdir().unwrap();
        std::fs::write(root.path().join(".splashboard.toml"), "").unwrap();
        let nested = root.path().join("sub");
        std::fs::create_dir(&nested).unwrap();
        assert!(find_local_at(&nested).is_none());
        assert!(find_local_walking_up(&nested).is_some());
    }

    #[test]
    fn resolve_prefers_local_over_project() {
        let dir = tempfile::tempdir().unwrap();
        std::fs::create_dir(dir.path().join(".git")).unwrap();
        std::fs::write(dir.path().join(".splashboard.toml"), "").unwrap();
        let src = resolve_from(dir.path(), false).unwrap();
        assert!(matches!(src, DashboardSource::Local(_)));
    }

    #[test]
    fn resolve_picks_project_when_cwd_is_repo_root() {
        let dir = tempfile::tempdir().unwrap();
        std::fs::create_dir(dir.path().join(".git")).unwrap();
        let src = resolve_from(dir.path(), false).unwrap();
        assert!(matches!(src, DashboardSource::Project));
    }

    #[test]
    fn resolve_falls_back_to_home_outside_repo() {
        let dir = tempfile::tempdir().unwrap();
        let src = resolve_from(dir.path(), false).unwrap();
        assert!(matches!(src, DashboardSource::Home));
    }

    #[test]
    fn on_cd_silent_in_plain_subdir() {
        let dir = tempfile::tempdir().unwrap();
        assert!(resolve_from(dir.path(), true).is_none());
    }

    #[test]
    fn on_cd_fires_home_at_home_dir() {
        let _lock = crate::paths::TEST_ENV_LOCK
            .lock()
            .unwrap_or_else(|e| e.into_inner());
        let tmp = tempfile::tempdir().unwrap();
        let previous = std::env::var("HOME").ok();
        // SAFETY: scoped mutation of process env; the lock above serializes with other
        // env-touching tests.
        unsafe {
            std::env::set_var("HOME", tmp.path());
        }
        let src = resolve_from(tmp.path(), true).unwrap();
        assert!(matches!(src, DashboardSource::Home));
        unsafe {
            match previous {
                Some(v) => std::env::set_var("HOME", v),
                None => std::env::remove_var("HOME"),
            }
        }
    }

    #[test]
    fn on_cd_fires_at_repo_root() {
        let dir = tempfile::tempdir().unwrap();
        std::fs::create_dir(dir.path().join(".git")).unwrap();
        let src = resolve_from(dir.path(), true).unwrap();
        assert!(matches!(src, DashboardSource::Project));
    }

    #[test]
    fn on_cd_silent_in_repo_subdir() {
        let root = tempfile::tempdir().unwrap();
        std::fs::create_dir(root.path().join(".git")).unwrap();
        let sub = root.path().join("src");
        std::fs::create_dir(&sub).unwrap();
        // Sub-directory: even though an ancestor is a git root, `resolve_from` must not walk
        // up — that's what keeps cd into src/ from re-triggering the project splash.
        assert!(resolve_from(&sub, true).is_none());
    }

    #[test]
    fn child_without_widget_is_layout_spacer() {
        // `[[row.child]]` with no `widget = ...` is a pure layout spacer — it reserves its
        // `width` but renders nothing. Replaces the historical `basic_static` gap hack.
        let toml = r#"
[[widget]]
id = "a"
fetcher = "basic_static"
render = "text_plain"

[[row]]
height = { length = 3 }
[[row.child]]
width = { length = 2 }
[[row.child]]
widget = "a"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert!(d.rows[0].children[0].widget.is_none());
        let layout = Config::from_parts(SettingsConfig::default(), d).to_layout();
        let cols = match layout {
            Layout::Stack { children, .. } => match &children[0].layout {
                Layout::Stack { children: cs, .. } => cs.clone(),
                _ => panic!("expected inner cols stack"),
            },
            _ => panic!("expected rows at root"),
        };
        assert!(matches!(cols[0].layout, Layout::Empty));
        assert!(matches!(cols[1].layout, Layout::Widget { .. }));
    }

    #[test]
    fn row_gap_splices_spacers_between_children() {
        let toml = r#"
[[widget]]
id = "a"
fetcher = "basic_static"
render = "text_plain"

[[widget]]
id = "b"
fetcher = "basic_static"
render = "text_plain"

[[row]]
height = { length = 3 }
gap = 2
[[row.child]]
widget = "a"
[[row.child]]
widget = "b"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        assert_eq!(d.rows[0].gap, Some(2));
        let layout = Config::from_parts(SettingsConfig::default(), d).to_layout();
        let cols = match layout {
            Layout::Stack { children, .. } => match &children[0].layout {
                Layout::Stack { children: cs, .. } => cs.clone(),
                _ => panic!("expected inner cols stack"),
            },
            _ => panic!("expected rows at root"),
        };
        assert_eq!(cols.len(), 3);
        assert!(matches!(cols[0].layout, Layout::Widget { .. }));
        assert!(matches!(cols[1].layout, Layout::Empty));
        assert!(matches!(cols[2].layout, Layout::Widget { .. }));
        assert!(matches!(cols[1].size, crate::layout::Size::Length(2)));
    }

    #[test]
    fn row_gap_zero_is_noop() {
        let toml = r#"
[[widget]]
id = "a"
fetcher = "basic_static"

[[row]]
gap = 0
[[row.child]]
widget = "a"
[[row.child]]
widget = "a"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        let layout = Config::from_parts(SettingsConfig::default(), d).to_layout();
        let cols = match layout {
            Layout::Stack { children, .. } => match &children[0].layout {
                Layout::Stack { children: cs, .. } => cs.clone(),
                _ => panic!(),
            },
            _ => panic!(),
        };
        assert_eq!(cols.len(), 2);
    }

    #[test]
    fn helper_mappings_cover_sizes_flex_titles_and_borders() {
        assert_eq!(to_flex(FlexSpec::Legacy), Flex::Legacy);
        assert_eq!(to_flex(FlexSpec::Start), Flex::Start);
        assert_eq!(to_flex(FlexSpec::Center), Flex::Center);
        assert_eq!(to_flex(FlexSpec::End), Flex::End);
        assert_eq!(to_flex(FlexSpec::SpaceBetween), Flex::SpaceBetween);
        assert_eq!(to_flex(FlexSpec::SpaceAround), Flex::SpaceAround);

        assert_eq!(
            to_title_align(Some(TitleAlignSpec::Center)),
            TitleAlign::Center
        );
        assert_eq!(
            to_title_align(Some(TitleAlignSpec::Right)),
            TitleAlign::Right
        );
        assert_eq!(to_title_align(Some(TitleAlignSpec::Left)), TitleAlign::Left);
        assert_eq!(to_title_align(None), TitleAlign::Left);

        assert_eq!(to_border_style(BorderSpec::None), None);
        assert_eq!(to_border_style(BorderSpec::Plain), Some(BorderStyle::Plain));
        assert_eq!(
            to_border_style(BorderSpec::Rounded),
            Some(BorderStyle::Rounded)
        );
        assert_eq!(to_border_style(BorderSpec::Thick), Some(BorderStyle::Thick));
        assert_eq!(
            to_border_style(BorderSpec::Double),
            Some(BorderStyle::Double)
        );
        assert_eq!(to_border_style(BorderSpec::Top), Some(BorderStyle::Top));

        assert_eq!(
            make_child(Some(SizeSpec::Fill(2)), Layout::Empty).size,
            Size::Fill(2)
        );
        assert_eq!(
            make_child(Some(SizeSpec::Length(3)), Layout::Empty).size,
            Size::Length(3)
        );
        assert_eq!(
            make_child(Some(SizeSpec::Min(4)), Layout::Empty).size,
            Size::Min(4)
        );
        assert_eq!(
            make_child(Some(SizeSpec::Max(5)), Layout::Empty).size,
            Size::Max(5)
        );
        assert_eq!(
            make_child(Some(SizeSpec::Percentage(60)), Layout::Empty).size,
            Size::Percentage(60)
        );
        assert_eq!(
            make_child(Some(SizeSpec::Auto), Layout::Empty).size,
            Size::Auto
        );
        assert_eq!(make_child(None, Layout::Empty).size, Size::Fill(1));
    }

    #[test]
    fn panel_and_git_root_helpers_cover_remaining_branches() {
        let titled = apply_panel(
            Layout::widget("hero"),
            Some("Status"),
            Some(BorderSpec::Top),
            Some(TitleAlignSpec::Right),
        );
        let Layout::Widget {
            panel: Some(panel), ..
        } = titled
        else {
            panic!("expected widget with panel");
        };
        assert_eq!(panel.title.as_deref(), Some("Status"));
        assert_eq!(panel.border, BorderStyle::Top);
        assert_eq!(panel.title_align, TitleAlign::Right);

        let untitled = apply_panel(
            Layout::widget("chart"),
            None,
            Some(BorderSpec::Rounded),
            Some(TitleAlignSpec::Center),
        );
        let Layout::Widget {
            panel: Some(panel), ..
        } = untitled
        else {
            panic!("expected rounded widget panel");
        };
        assert!(panel.title.is_none());
        assert_eq!(panel.border, BorderStyle::Rounded);
        assert_eq!(panel.title_align, TitleAlign::Left);

        let chromeless = apply_panel(
            Layout::widget("clock"),
            Some("Ignored"),
            Some(BorderSpec::None),
            Some(TitleAlignSpec::Center),
        );
        assert!(matches!(chromeless, Layout::Widget { panel: None, .. }));

        let dir = tempfile::tempdir().unwrap();
        std::fs::write(dir.path().join(".git"), "gitdir: ../.git/worktrees/x").unwrap();
        assert!(is_git_repo_root(dir.path()));
        assert_eq!(
            canonicalize_or(&dir.path().join("missing")),
            dir.path().join("missing")
        );
    }

    #[test]
    fn to_layout_builds_nested_rows_of_cols() {
        let toml = r#"
[[widget]]
id = "a"
fetcher = "basic_static"
render = "text_plain"

[[widget]]
id = "b"
fetcher = "basic_static"
render = "text_plain"

[[row]]
height = { length = 3 }
[[row.child]]
widget = "a"
[[row.child]]
widget = "b"
"#;
        let d = DashboardConfig::parse(toml).unwrap();
        let config = Config::from_parts(SettingsConfig::default(), d);
        let layout = config.to_layout();
        match layout {
            Layout::Stack { children, .. } => {
                assert!(!children.is_empty());
            }
            _ => panic!("expected Stack at root"),
        }
    }
}