splashboard 2.10.2

//! `basic_bars` — labeled bars authored inline. Right for ad-hoc comparisons that don't
//! warrant a dedicated fetcher (manual team-by-team counts, "books read per year", etc.).

use serde::Deserialize;

use crate::fetcher::{FetchContext, RealtimeFetcher, Safety};
use crate::options::OptionSchema;
use crate::payload::{Bar, BarsData, Body, Payload};
use crate::render::Shape;

use super::common;

const SHAPES: &[Shape] = &[Shape::Bars];

const OPTION_SCHEMAS: &[OptionSchema] = &[OptionSchema {
    name: "bars",
    type_hint: "list of {label, value: u64}",
    required: false,
    default: Some("[]"),
    description: "Labeled bars. Order is preserved (sorting / ranking lives in the renderer via `style = \"medal\"` / `max_items`).",
}];

pub struct BasicBars;

#[derive(Debug, Default, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct Options {
    #[serde(default)]
    pub bars: Vec<BarConfig>,
}

#[derive(Debug, Default, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct BarConfig {
    pub label: String,
    pub value: u64,
}

impl RealtimeFetcher for BasicBars {
    fn name(&self) -> &str {
        "basic_bars"
    }
    fn safety(&self) -> Safety {
        Safety::Safe
    }
    fn description(&self) -> &'static str {
        "Renders a `Bars` payload from inline `[widget.options].bars = [{label, value}]`. Row order is preserved as authored; sorting / ranking is a renderer concern (`list_ranking`, `chart_bar`'s sort option)."
    }
    fn shapes(&self) -> &[Shape] {
        SHAPES
    }
    fn option_schemas(&self) -> &[OptionSchema] {
        OPTION_SCHEMAS
    }
    fn sample_body(&self, shape: Shape) -> Option<Body> {
        (shape == Shape::Bars).then(|| {
            Body::Bars(BarsData {
                bars: vec![
                    Bar {
                        label: "alice".into(),
                        value: 12,
                        value_label: None,
                    },
                    Bar {
                        label: "bob".into(),
                        value: 7,
                        value_label: None,
                    },
                ],
            })
        })
    }
    fn compute(&self, ctx: &FetchContext) -> Payload {
        let opts: Options = match common::parse_options(ctx.options.as_ref()) {
            Ok(o) => o,
            Err(msg) => return common::placeholder(&msg),
        };
        common::bare(Body::Bars(BarsData {
            bars: opts
                .bars
                .into_iter()
                .map(|b| Bar {
                    label: b.label,
                    value: b.value,
                    value_label: None,
                })
                .collect(),
        }))
    }
}

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

    fn compute(toml_src: &str) -> Payload {
        BasicBars.compute(&FetchContext {
            options: Some(toml::from_str(toml_src).unwrap()),
            ..Default::default()
        })
    }

    #[test]
    fn contract() {
        assert_eq!(BasicBars.name(), "basic_bars");
        assert_eq!(BasicBars.shapes(), &[Shape::Bars]);
    }

    #[test]
    fn emits_bars_preserving_input_order() {
        let p = compute(
            r#"
            [[bars]]
            label = "alice"
            value = 12
            [[bars]]
            label = "bob"
            value = 7
            "#,
        );
        let Body::Bars(d) = p.body else {
            panic!("expected Bars");
        };
        assert_eq!(d.bars.len(), 2);
        assert_eq!(d.bars[0].label, "alice");
        assert_eq!(d.bars[0].value, 12);
        assert_eq!(d.bars[1].label, "bob");
    }

    #[test]
    fn no_bars_yields_empty_payload() {
        let p = BasicBars.compute(&FetchContext::default());
        let Body::Bars(d) = p.body else {
            panic!("expected Bars");
        };
        assert!(d.bars.is_empty());
    }

    #[test]
    fn metadata_methods_have_content() {
        let f = BasicBars;
        assert_eq!(f.safety(), Safety::Safe);
        assert!(!f.description().is_empty());
        assert_eq!(
            f.option_schemas()
                .iter()
                .map(|s| s.name)
                .collect::<Vec<_>>(),
            vec!["bars"]
        );
    }

    #[test]
    fn sample_body_matches_declared_shape_only() {
        let f = BasicBars;
        assert!(matches!(f.sample_body(Shape::Bars), Some(Body::Bars(_))));
        assert!(f.sample_body(Shape::Text).is_none());
    }

    #[test]
    fn invalid_options_render_placeholder() {
        let p = compute(r#"bars = "not-a-list""#);
        let Body::TextBlock(d) = p.body else {
            panic!("expected placeholder");
        };
        assert!(d.lines[0].contains("invalid options"));
    }
}