sparcli 0.3.0

Lightweight, cross-platform toolkit for styled CLI output and interactive input widgets
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

//! The input hero collage for the README, mirroring the C sparcli demo in a
//! slim form: a titled hero panel and a balanced multi-column dashboard of
//! statically rendered prompt frames (no boxes/hints, default theme).
//!
//! `cargo run --example prompt-readme`
//!
//! Each prompt's frame is produced by its `frame()` method (no TTY, no
//! interaction); columns are stacked with `vstack` and joined with `Columns`.
//! The fuzzy column is composed directly so the example needs no extra
//! features.

use sparcli::prelude::*;
use sparcli::{
    Columns, Confirm, Date, DatePicker, NumberInput, Panel, PasswordInput,
    Select, TextInput, Textarea,
};

fn main() -> Result<()> {
    println!();
    let board = dashboard();
    hero(board.width() as u16)?;
    println!();
    board.print()?;
    Ok(())
}

/// A blank one-line spacer for `vstack`.
fn blank() -> Rendered {
    Rendered::new(vec![Line::default()])
}

/// The top hero panel, sized to match the dashboard width.
fn hero(width: u16) -> Result<()> {
    let theme = theme();
    let body = Text::new(vec![
        Line::raw("Interactive prompts - confirm · select · text · password ·"),
        Line::raw("number · textarea · fuzzy · date."),
    ]);
    Panel::new(body)
        .border(BorderType::Rounded)
        .border_style(Style::new().fg(theme.accent))
        .title(
            Title::new(" sparcli · input widgets ")
                .align(Align::Center)
                .style(theme.title),
        )
        .content_align(Align::Center)
        .width(width)
        .print()
}

/// The balanced three-column dashboard of prompt frames.
fn dashboard() -> Rendered {
    Columns::new()
        .add_rendered(left_column())
        .add_rendered(middle_column())
        .add_rendered(calendar_column())
        .gap(3)
        .separator(BorderType::Single)
        .render(0)
}

/// Left column: the confirm prompt with the input fields stacked beneath it,
/// then the notes textarea.
fn left_column() -> Rendered {
    vstack(
        &[
            Confirm::new("Deploy to production?").default_yes().frame(),
            blank(),
            TextInput::new("Service").initial("api-gateway").frame(),
            PasswordInput::new("Password").initial("hunter2").frame(),
            NumberInput::new("Replicas")
                .initial(3.0)
                .range(1.0, 10.0)
                .frame(),
            TextInput::new("Email")
                .placeholder("you@example.com")
                .frame(),
            TextInput::new("Region")
                .initial("eu-")
                .suggestions(["eu-central-1"])
                .frame(),
            blank(),
            Textarea::new("Notes")
                .initial("first line\nsecond line\nthird line")
                .frame(),
        ],
        0,
    )
}

/// Middle column: the single- and multi-select prompts.
fn middle_column() -> Rendered {
    vstack(
        &[
            Select::new("Environment")
                .options(["staging", "production", "local"])
                .cursor(1)
                .frame(),
            blank(),
            Select::new("Targets")
                .multi()
                .options(["web", "api", "worker", "db"])
                .checked([0, 2])
                .frame(),
        ],
        0,
    )
}

/// Right column: the date picker with the fuzzy finder beneath it.
fn calendar_column() -> Rendered {
    let date = DatePicker::new("Release date")
        .initial(Date::new(2026, 5, 15))
        .frame();
    vstack(&[date, blank(), fuzzy_block()], 0)
}

/// A composed snapshot of an inline fuzzy finder (no `fuzzy` feature needed
/// for this static screenshot).
fn fuzzy_block() -> Rendered {
    let theme = theme();
    Rendered::new(vec![
        Line::new(vec![
            Span::styled("Language ".to_string(), theme.title),
            Span::raw("ru"),
            Span::styled(" ".to_string(), theme.cursor),
        ]),
        Line::new(vec![
            Span::styled("‣ ".to_string(), theme.selection),
            Span::styled("Rust".to_string(), theme.selection),
        ]),
    ])
}