pandora-kit 0.4.6

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

# 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                       |
| `--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
```

## 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        |