pandora-kit 0.6.8

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

# pan confirm — Confirmation Popup

Opens an interactive confirmation popup. Exits with code 0 on accept, 1 on cancel.

## Usage

```
pan confirm [OPTIONS]
```

## Options

| Flag                     | Default              | Description                        |
|--------------------------|----------------------|------------------------------------|
| `-m`, `--message`        | `"¿Deseas continuar?"` | Body message inside the popup    |
| `-t`, `--title`          | `"Confirmación"`     | Title in the popup header          |
| `-v`, `--variant`        | `"warning"`          | Color: success, warning, danger, none |
| `-y`, `--confirm`        | `"Confirmar"`        | Confirm button label               |
| `-n`, `--cancel`         | `"Cancelar"`         | Cancel button label                |
| `-W`, `--width`          | `0` (auto)           | Popup width                        |
| `-H`, `--height`         | `0` (auto)           | Popup height                       |
| `--badge`                |                      | Badge: `text\|color\|anchor[@L]\|WxL`. Ver `--guide` en pandora |
| `--badge-anchor`         | `tl`                 | Default anchor: tl, t, tr, bl, b, br, l, r |
| `--badge-width`          | `0` (auto)           | Default badge width (0 = auto per badge) |
| `--badge-lines`          | `1`                  | Default badge content lines        |
| `--guide`                |                      | Show this guide                    |

## Exit codes

| Code | Meaning         |
|------|-----------------|
| 0    | User confirmed  |
| 1    | User cancelled  |

## Examples

```bash
# Basic usage — run command only if confirmed
pan confirm -m "¿Eliminar archivo?" -v danger && rm archivo

# Conditional
if pan confirm -t "Actualizar" -m "¿Proceder con la actualización?"; then
    make deploy
else
    echo "Cancelado"
fi

# Custom button labels
pan confirm -m "¿Continuar?" -y "Sí" -n "No"

# Simple message with default title
pan confirm -m "Operación completada" -v success

# With badges
pan confirm -m "¿Desplegar?" -v danger --badge "prod|red|tr" --badge "v2.1.0|cyan"

# With layers (no overlap)
pan confirm -m "¿Desplegar?" -v danger --badge "prod|red|tr" --badge "v2.1.0|cyan|tr@1"
```

## Mouse

- **Buttons**: click to confirm or cancel
- **Drag**: click and hold on the border or title bar to move the popup

## Capturing output

See [PANDORA_GUIDE.md](./PANDORA_GUIDE.md#capturing-output) for all capture patterns.

## Keyboard

| Key              | Action                |
|------------------|-----------------------|
| `y` / `Enter`    | Confirm               |
| `n` / `Esc`      | Cancel                |
| `Ctrl` + `c`     | Emergency exit        |