splashboard 2.10.2

use ratatui::{Frame, layout::Rect};
use tui_piechart::{LegendPosition, PieChart, PieSlice};

use crate::options::OptionSchema;
use crate::payload::{BarsData, Body};
use crate::theme::{self, ColorKey, Theme};

use super::{Registry, RenderOptions, Renderer, Shape};

#[derive(Debug, Clone, Default, serde::Deserialize)]
#[serde(deny_unknown_fields)]
struct Options {
    #[serde(default)]
    pub legend: Option<String>,
    #[serde(default)]
    pub donut: Option<bool>,
}

const COLOR_KEYS: &[ColorKey] = &[theme::PALETTE_SERIES];

const OPTION_SCHEMAS: &[OptionSchema] = &[
    OptionSchema {
        name: "legend",
        type_hint: "\"right\" | \"bottom\" | \"top\" | \"left\" | \"none\"",
        required: false,
        default: Some("\"right\""),
        description: "Legend placement. `none` hides the legend; any direction pins it to that side of the chart.",
    },
    OptionSchema {
        name: "donut",
        type_hint: "bool",
        required: false,
        default: Some("false"),
        description: "Render a donut (hollow centre) instead of a filled pie. Implemented by substituting the slice glyph so the centre reads as empty.",
    },
];

/// Pie-chart renderer. Consumes the same `Bars` shape as `chart_bar`, so one fetcher feeds
/// either — `render = "chart_pie"` vs `render = "chart_bar"` is a config choice. Slice colours
/// cycle through the shared `series` palette in input order; labels and percentages come from
/// the widget.
pub struct ChartPieRenderer;

impl Renderer for ChartPieRenderer {
    fn name(&self) -> &str {
        "chart_pie"
    }
    fn description(&self) -> &'static str {
        "Pie chart of `Bars` slices with palette-cycled colours, percentages, and an adjacent legend. Use `donut = true` for a hollow centre, or pick `chart_bar` instead when exact comparisons between slices matter."
    }
    fn accepts(&self) -> &[Shape] {
        &[Shape::Bars]
    }
    fn color_keys(&self) -> &[ColorKey] {
        COLOR_KEYS
    }
    fn option_schemas(&self) -> &[OptionSchema] {
        OPTION_SCHEMAS
    }
    fn render(
        &self,
        frame: &mut Frame,
        area: Rect,
        body: &Body,
        opts: &RenderOptions,
        theme: &Theme,
        _registry: &Registry,
    ) {
        if let Body::Bars(d) = body {
            render_pie(frame, area, d, opts, theme);
        }
    }
}

fn render_pie(frame: &mut Frame, area: Rect, data: &BarsData, opts: &RenderOptions, theme: &Theme) {
    let specific: Options = opts.parse_specific();
    let slices: Vec<PieSlice> = data
        .bars
        .iter()
        .enumerate()
        .map(|(i, b)| PieSlice::new(b.label.as_str(), b.value as f64, theme.series_color(i)))
        .collect();
    let show_legend = !matches!(specific.legend.as_deref(), Some("none"));
    let mut chart = PieChart::new(slices)
        .show_legend(show_legend)
        .show_percentages(true)
        .legend_position(legend_position(specific.legend.as_deref()));
    if specific.donut.unwrap_or(false) {
        chart = chart.pie_char('○');
    }
    frame.render_widget(chart, area);
}

fn legend_position(legend: Option<&str>) -> LegendPosition {
    match legend {
        Some("left") => LegendPosition::Left,
        Some("top") => LegendPosition::Top,
        Some("bottom") => LegendPosition::Bottom,
        _ => LegendPosition::Right,
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::payload::{Bar, BarsData, Payload};
    use crate::render::test_utils::render_to_buffer_with_spec;
    use crate::render::{Registry, RenderSpec};

    fn payload(bars: Vec<Bar>) -> Payload {
        Payload {
            icon: None,
            status: None,
            format: None,
            body: Body::Bars(BarsData { bars }),
        }
    }

    fn render(bars: Vec<Bar>, w: u16, h: u16) -> ratatui::buffer::Buffer {
        let registry = Registry::with_builtins();
        let spec = RenderSpec::Short("chart_pie".into());
        render_to_buffer_with_spec(&payload(bars), Some(&spec), &registry, w, h)
    }

    fn bar(label: &str, value: u64) -> Bar {
        Bar {
            label: label.into(),
            value,
            value_label: None,
        }
    }

    #[test]
    fn renders_without_panicking() {
        let _ = render(
            vec![bar("rust", 45), bar("go", 30), bar("python", 25)],
            40,
            15,
        );
    }

    #[test]
    fn empty_bars_short_circuit_to_placeholder() {
        use crate::render::test_utils::line_text;
        let buf = render(vec![], 40, 5);
        let joined: String = (0..5).map(|y| line_text(&buf, y)).collect();
        assert!(
            joined.contains("nothing here yet"),
            "missing empty-state caption: {joined:?}"
        );
    }

    #[test]
    fn accepts_only_bars_shape() {
        let r = ChartPieRenderer;
        assert_eq!(r.accepts(), &[Shape::Bars]);
    }

    #[test]
    fn registered_under_chart_pie_name() {
        let r = Registry::with_builtins();
        assert!(r.get("chart_pie").is_some(), "chart_pie not registered");
    }

    #[test]
    fn exposes_renderer_contract() {
        let r = ChartPieRenderer;
        assert!(r.description().contains("donut = true"));
        assert!(r.color_keys().iter().map(|k| k.name).eq(["palette_series"]));
        assert!(
            r.option_schemas()
                .iter()
                .map(|s| s.name)
                .eq(["legend", "donut"])
        );
    }

    #[test]
    fn legend_position_maps_named_edges() {
        assert_eq!(legend_position(Some("left")), LegendPosition::Left);
        assert_eq!(legend_position(Some("top")), LegendPosition::Top);
        assert_eq!(legend_position(Some("bottom")), LegendPosition::Bottom);
    }

    #[test]
    fn legend_labels_appear_in_buffer() {
        use crate::render::test_utils::line_text;
        let buf = render(vec![bar("alpha", 10), bar("beta", 20)], 60, 20);
        let joined: String = (0..20).map(|y| line_text(&buf, y)).collect();
        assert!(joined.contains("alpha"), "alpha label missing: {joined:?}");
        assert!(joined.contains("beta"), "beta label missing: {joined:?}");
    }

    #[test]
    fn legend_none_hides_labels() {
        use crate::render::test_utils::line_text;
        let registry = Registry::with_builtins();
        #[derive(serde::Deserialize)]
        struct W {
            render: RenderSpec,
        }
        let w: W = toml::from_str(r#"render = { type = "chart_pie", legend = "none" }"#).unwrap();
        let buf = render_to_buffer_with_spec(
            &payload(vec![bar("alpha", 10), bar("beta", 20)]),
            Some(&w.render),
            &registry,
            60,
            20,
        );
        let joined: String = (0..20).map(|y| line_text(&buf, y)).collect();
        assert!(
            !joined.contains("alpha"),
            "legend should be hidden: {joined:?}"
        );
    }

    #[test]
    fn donut_mode_renders_without_panicking() {
        let registry = Registry::with_builtins();
        #[derive(serde::Deserialize)]
        struct W {
            render: RenderSpec,
        }
        let w: W = toml::from_str(r#"render = { type = "chart_pie", donut = true }"#).unwrap();
        let _ = render_to_buffer_with_spec(
            &payload(vec![bar("alpha", 10), bar("beta", 20)]),
            Some(&w.render),
            &registry,
            60,
            20,
        );
    }

    #[test]
    fn more_bars_than_palette_does_not_panic() {
        let palette_len = Theme::default().palette_series.len();
        let many: Vec<Bar> = (0..palette_len + 3)
            .map(|i| bar(&format!("b{i}"), (i as u64) + 1))
            .collect();
        let _ = render(many, 80, 30);
    }
}