pandora-kit 0.3.0

Interactive TUI toolkit for the Hefesto framework
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

# pandora choose — Interactive Item Selector

Opens an interactive popup to select one or more items from a list. Selected items are printed to stdout.

## Usage

```
pandora choose [OPTIONS] <ITEMS>...
```

## Options

| Flag                     | Default              | Description                        |
|--------------------------|----------------------|------------------------------------|
| `-t`, `--title`          | `"Seleccionar"`      | Title in the popup header          |
| `-m`, `--multi`          | (off)                | Enable multi-select with Space     |
| `-W`, `--width`          | `0` (auto)           | Popup width                        |
| `-H`, `--height`         | `0` (auto)           | Popup height                       |
| `-M`, `--max`            | (unlimited)          | Max selected items (with --multi)  |
| `--guide`                |                      | Show this guide                    |

## Arguments

| Argument    | Description                        |
|-------------|------------------------------------|
| `ITEMS`     | Items to display (one or more)     |

## Exit codes

| Code | Meaning                          |
|------|----------------------------------|
| 0    | Selection made (items on stdout) |
| 1    | User cancelled (no output)       |

## Examples

```bash
# Simple single selection
pandora choose foo bar baz

# Multi-select
pandora choose -m apple orange banana grape

# Custom title
pandora choose -t "Choose a file" file1.txt file2.txt file3.txt

# With explicit size
pandora choose -W 60 -H 20 item1 item2 item3
```

## Mouse

- **Click item**: select (single) or toggle (multi)
- **Drag**: click and hold on the border or title bar to move the popup

## Keyboard

| Key              | Action                          |
|------------------|---------------------------------|
| `↑` / `k`        | Navigate up                     |
| `↓` / `j`        | Navigate down                   |
| `Tab`            | Navigate down                   |
| `Shift+Tab`      | Navigate up                     |
| `gg`             | Go to first item                |
| `G`              | Go to last item                 |
| `Enter`          | Confirm selection               |
| `Space`          | Toggle item (multi-select only) |
| `Esc`            | Cancel                          |
| `Ctrl` + `c`     | Emergency exit                  |