retroglyph-widgets 0.3.1

Immediate-mode drawing helpers for retroglyph (panels, gauges, tables, sparklines)
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

# retroglyph-widgets

[![crates.io](https://img.shields.io/crates/v/retroglyph-widgets.svg)](https://crates.io/crates/retroglyph-widgets)
[![docs.rs](https://img.shields.io/docsrs/retroglyph-widgets)](https://docs.rs/retroglyph-widgets)
[![coverage](https://codecov.io/gh/crates-lurey-io/retroglyph/graph/badge.svg?token=z8BBUp8fiY&flag=widgets)](https://app.codecov.io/gh/crates-lurey-io/retroglyph/flags)
[![license](https://img.shields.io/crates/l/retroglyph-widgets.svg)](https://github.com/crates-lurey-io/retroglyph/blob/main/LICENSE)

Immediate-mode drawing helpers for [retroglyph](https://github.com/crates-lurey-io/retroglyph): box
borders, filled panels, gauges, tables, lists, tab strips, buttons, sparklines, and a small
constraint-based layout splitter (`split_h`/`split_v` with ratatui-style
`Fixed`/`Percent`/`Fill`/`Min`/`Max` constraints), plus hover/click/drag/focus interaction tracking.
Every widget is a builder struct that draws itself into a `Terminal` and retains no state of its
own; depends only on [`retroglyph-core`](https://crates.io/crates/retroglyph-core), so games that
draw manually never pull it in.

`Theme` (`Theme::DARK`/`Theme::LIGHT`, or a caller-built palette) is a set of named color roles --
every widget with a style knob has a matching `.theme(Theme)` builder method that maps those roles
onto it, optionally: nothing requires a `Theme` at all, and a manual `.border_style(...)`/etc. call
after `.theme(...)` still wins.

## Quick start

```toml
[dependencies]
retroglyph-core = "0.1"
retroglyph-widgets = "0.1"
```

```rust
use retroglyph_core::{Rect, Terminal, backend::Headless};
use retroglyph_widgets::{Gauge, Widget};

let mut term = Terminal::new(Headless::new(20, 1));
Gauge::new("HP", 0.75).render(Rect::new(0, 0, 20, 1), &mut term);
term.present().unwrap();
```

See [docs.rs](https://docs.rs/retroglyph-widgets) for the full API, or the
[workspace README](https://github.com/crates-lurey-io/retroglyph#readme) for the crate list.