Figure

pub fn new(rows: usize, cols: usize) -> Self

use kuva::render::figure::Figure;

// Create a 2x2 grid
let figure = Figure::new(2, 2);

pub fn with_title<S: Into<String>>(mut self, title: S) -> Self

pub fn with_title_size(mut self, size: u32) -> Self

let figure = Figure::new(2, 2)
    .with_title("Multi-Panel Analysis")
    .with_title_size(24);

pub fn with_plots(mut self, plots: Vec<Vec<Plot>>) -> Self

pub fn with_layouts(mut self, layouts: Vec<Layout>) -> Self

let scatter1 = ScatterPlot::new().with_data(vec![(1.0, 2.0)]);
let scatter2 = ScatterPlot::new().with_data(vec![(2.0, 3.0)]);
let line1 = LinePlot::new().with_data(vec![(0.0, 1.0), (1.0, 2.0)]);
let line2 = LinePlot::new().with_data(vec![(0.0, 0.5), (1.0, 1.5)]);

let plots = vec![
    vec![scatter1.into()],  // Panel 0
    vec![scatter2.into()],  // Panel 1
    vec![line1.into()],     // Panel 2
    vec![line2.into()],     // Panel 3
];

let figure = Figure::new(2, 2)
    .with_plots(plots);

pub fn with_structure(mut self, structure: Vec<Vec<usize>>) -> Self

// 2x2 grid where top row is merged:
// [  Panel 0 (merged)  ]
// [ Panel 1 ][ Panel 2 ]
let structure = vec![
    vec![0, 1],  // Merge cells 0 and 1 (top row)
    vec![2],     // Cell 2 (bottom-left)
    vec![3],     // Cell 3 (bottom-right)
];

let figure = Figure::new(2, 2)
    .with_structure(structure);

pub fn with_labels(mut self) -> Self

pub fn with_labels_numeric(mut self) -> Self

pub fn with_labels_lowercase(mut self) -> Self

pub fn with_labels_custom(mut self, labels: Vec<&str>, config: LabelConfig) -> Self

use kuva::render::figure::{Figure, LabelConfig, LabelStyle};

// Uppercase labels (A, B, C, ...)
let figure = Figure::new(2, 2)
    .with_labels();

// Custom labels
let config = LabelConfig {
    style: LabelStyle::Custom(vec![]),
    size: 14,
    bold: true,
};
let figure = Figure::new(2, 2)
    .with_labels_custom(vec!["Fig 1", "Fig 2", "Fig 3", "Fig 4"], config);

pub fn with_shared_x_all(mut self) -> Self

pub fn with_shared_y_all(mut self) -> Self

pub fn with_shared_x(mut self, col: usize) -> Self

pub fn with_shared_y(mut self, row: usize) -> Self

pub fn with_shared_x_slice(mut self, col: usize, row_start: usize, row_end: usize) -> Self

pub fn with_shared_y_slice(mut self, row: usize, col_start: usize, col_end: usize) -> Self

let figure = Figure::new(3, 2)
    .with_shared_x_all()  // All panels share x-axis
    .with_shared_y(0);    // Top row shares y-axis

pub fn with_cell_size(mut self, w: f64, h: f64) -> Self

pub fn with_figure_size(mut self, w: f64, h: f64) -> Self

pub fn with_spacing(mut self, px: f64) -> Self

pub fn with_padding(mut self, px: f64) -> Self

let figure = Figure::new(2, 3)
    .with_figure_size(1200.0, 800.0)
    .with_spacing(20.0)
    .with_padding(15.0);

pub fn with_shared_legend(mut self) -> Self

pub fn with_shared_legend_bottom(mut self) -> Self

pub fn with_shared_legend_position(mut self, pos: FigureLegendPosition) -> Self

pub fn with_shared_legend_entries(mut self, entries: Vec<LegendEntry>) -> Self

pub fn with_keep_panel_legends(mut self) -> Self

use kuva::render::figure::{Figure, FigureLegendPosition};

let figure = Figure::new(2, 2)
    .with_plots(plots)
    .with_shared_legend()  // Auto-collect legend on right
    .with_keep_panel_legends();  // Also show per-panel legends

pub fn render(self) -> Scene

use kuva::render::figure::Figure;
use kuva::backend::svg::SvgBackend;

let figure = Figure::new(2, 2)
    .with_plots(plots)
    .with_labels()
    .with_shared_x_all();

let scene = figure.render();
let svg = SvgBackend.render_scene(&scene);

use kuva::prelude::*;
use kuva::render::figure::{Figure, FigureLegendPosition};
use kuva::render::layout::Layout;
use kuva::backend::svg::SvgBackend;

// Create plots for each panel
let scatter1 = ScatterPlot::new()
    .with_data(vec![(1.0, 2.0), (2.0, 3.0), (3.0, 2.5)])
    .with_color("steelblue")
    .with_legend_label("Series A");

let scatter2 = ScatterPlot::new()
    .with_data(vec![(1.0, 1.5), (2.0, 2.5), (3.0, 3.5)])
    .with_color("orange")
    .with_legend_label("Series B");

let line1 = LinePlot::new()
    .with_data(vec![(0.0, 1.0), (1.0, 2.0), (2.0, 3.0), (3.0, 4.0)])
    .with_color("red")
    .with_legend_label("Trend A");

let line2 = LinePlot::new()
    .with_data(vec![(0.0, 0.5), (1.0, 1.5), (2.0, 2.5), (3.0, 3.5)])
    .with_color("green")
    .with_legend_label("Trend B");

// Organize plots by panel
let plots = vec![
    vec![scatter1.into()],  // Top-left
    vec![scatter2.into()],  // Top-right
    vec![line1.into()],     // Bottom-left
    vec![line2.into()],     // Bottom-right
];

// Optional: custom layouts for each panel
let layouts = vec![
    Layout::auto_from_plots(&plots[0])
        .with_title("Scatter A")
        .with_x_label("Time"),
    Layout::auto_from_plots(&plots[1])
        .with_title("Scatter B")
        .with_x_label("Time"),
    Layout::auto_from_plots(&plots[2])
        .with_title("Line A")
        .with_y_label("Value"),
    Layout::auto_from_plots(&plots[3])
        .with_title("Line B")
        .with_y_label("Value"),
];

// Build the figure
let figure = Figure::new(2, 2)
    .with_title("Multi-Panel Analysis")
    .with_plots(plots)
    .with_layouts(layouts)
    .with_labels()  // Add A, B, C, D labels
    .with_shared_x_all()  // Share x-axis across columns
    .with_shared_legend()  // Unified legend on right
    .with_figure_size(1000.0, 800.0)
    .with_spacing(20.0);

// Render to SVG
let scene = figure.render();
let svg = SvgBackend.render_scene(&scene);
std::fs::write("figure.svg", svg).unwrap();

// 3x3 grid with merged cells:
// [ Panel 0 (merged 2x2) ][ Panel 1 ]
// [                      ][ Panel 2 ]
// [ Panel 3 ][ Panel 4  ][ Panel 5 ]

let structure = vec![
    vec![0, 1, 3, 4],  // Merge cells 0,1,3,4 (top-left 2x2)
    vec![2],           // Cell 2
    vec![5],           // Cell 5
    vec![6],           // Cell 6
    vec![7],           // Cell 7
    vec![8],           // Cell 8
];

let figure = Figure::new(3, 3)
    .with_structure(structure)
    .with_plots(plots);

pub enum FigureLegendPosition {
    Right,
    Bottom,
}

pub enum LabelStyle {
    Uppercase,
    Lowercase,
    Numeric,
    Custom(Vec<String>),
}

pub struct LabelConfig {
    pub style: LabelStyle,
    pub size: u32,
    pub bold: bool,
}