ono 0.1.0

Beautiful terminal UI components for Ratatui — themeable widgets with an eject-to-source CLI.
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! Serde-deserializable shapes for the TOML spec format.

use serde::Deserialize;
use std::collections::BTreeMap;

/// One full component spec — what a single `.toml` file parses into.
#[derive(Debug, Deserialize)]
pub struct Spec {
    pub component: Meta,
    #[serde(default)]
    pub params: BTreeMap<String, Param>,
    #[serde(default)]
    pub classes: BTreeMap<String, String>,
    #[serde(default)]
    pub compose: Vec<Compose>,
    /// Freeform animation knobs (e.g. splash's `pulse_left_phase`).
    #[serde(default)]
    pub animation: toml::Table,
    #[serde(default)]
    pub theme_knobs: ThemeKnobs,
}

#[derive(Debug, Deserialize)]
pub struct Meta {
    pub name: String,
    pub kind: Kind,
    pub description: String,
    #[serde(default)]
    pub targets: Vec<String>,
}

#[derive(Debug, Deserialize, PartialEq, Eq, Clone, Copy)]
#[serde(rename_all = "lowercase")]
pub enum Kind {
    Element,
    Component,
}

#[derive(Debug, Deserialize)]
pub struct Param {
    #[serde(rename = "type")]
    pub ty: ParamType,
    pub default: toml::Value,
    #[serde(default)]
    pub doc: Option<String>,
    #[serde(default)]
    pub min: Option<toml::Value>,
    #[serde(default)]
    pub range: Option<[f64; 2]>,
    #[serde(default)]
    pub values: Option<Vec<String>>,
}

#[derive(Debug, Deserialize, PartialEq, Eq, Clone, Copy)]
#[serde(rename_all = "lowercase")]
pub enum ParamType {
    Float,
    Int,
    String,
    Bool,
    Enum,
}

/// A `[[compose]]` entry. Exactly one of `element` or `component` must be set;
/// the child is looked up by name in the catalog.
#[derive(Debug, Deserialize)]
pub struct Compose {
    #[serde(default)]
    pub element: Option<String>,
    #[serde(default)]
    pub component: Option<String>,
    #[serde(default)]
    pub slot: Option<String>,
    /// Name of a parent param whose truthiness gates this child. When absent,
    /// the child is unconditional.
    #[serde(default)]
    pub when: Option<String>,
    /// Map of child-param-name → expression string. Expressions use `${...}`
    /// to reference parent params; bare values are literal strings.
    #[serde(default)]
    pub pass: BTreeMap<String, String>,
}

impl Compose {
    /// Name of the child being composed. Returns `None` if neither `element`
    /// nor `component` is set (invalid spec; caught by validation).
    pub fn child(&self) -> Option<&str> {
        self.element
            .as_deref()
            .or(self.component.as_deref())
    }
}

#[derive(Debug, Default, Deserialize)]
pub struct ThemeKnobs {
    #[serde(default)]
    pub uses: Vec<String>,
}