panes 0.19.0

Renderer-agnostic layout engine with declarative ergonomics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use std::sync::Arc;

use crate::builder::LayoutBuilder;
use crate::error::PaneError;
use crate::layout::Layout;
use crate::preset::{add_active_hidden_panels, collect_kinds, validate_active, validate_kinds};

/// Builder for the monocle preset layout.
pub struct Monocle {
    kinds: Arc<[Arc<str>]>,
    active: usize,
}

impl Monocle {
    pub(crate) fn new(kinds: impl IntoIterator<Item = impl Into<Arc<str>>>) -> Self {
        Self {
            kinds: collect_kinds(kinds),
            active: 0,
        }
    }

    crate::macros::builder_setters!(
        /// Set which panel index is active (visible).
        active(index: usize)
    );

    /// Consume the builder and produce a [`Layout`].
    pub fn build(&self) -> Result<Layout, PaneError> {
        validate_kinds(&self.kinds)?;
        validate_active(self.active, self.kinds.len())?;

        let mut b = LayoutBuilder::new();
        let active = self.active;

        b.col(|c| {
            add_active_hidden_panels(c, &self.kinds, active);
        })?;

        b.build()
    }
}

super::impl_preset!(
    Monocle,
    runtime(kinds, |_this| crate::strategy::StrategyKind::ActivePanel {
        variant: crate::strategy::ActivePanelVariant::Monocle,
        bar_height: 0.0,
    })
);