pzsh 0.3.1

Performance-first shell framework with sub-10ms startup
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

# Colors

pzsh provides a high-performance color system with O(1) rendering, supporting 16-color ANSI, 256-color palette, and true color (24-bit RGB).

## Enabling Colors

Colors are enabled by default in `~/.pzshrc`:

```toml
[prompt]
colors = true
```

## Color Palette

### 16-Color ANSI

Standard terminal colors with both normal and bright variants:

| Color | Normal | Bright |
|-------|--------|--------|
| Black | 0 | 8 |
| Red | 1 | 9 |
| Green | 2 | 10 |
| Yellow | 3 | 11 |
| Blue | 4 | 12 |
| Magenta | 5 | 13 |
| Cyan | 6 | 14 |
| White | 7 | 15 |

### 256-Color Palette

Access the full 256-color palette using palette indices:

```rust
ColorSpec::Palette(196)  // Bright red
ColorSpec::Palette(46)   // Bright green
```

### True Color (24-bit RGB)

Full RGB color support for modern terminals:

```rust
ColorSpec::Rgb(255, 128, 64)  // Orange
```

## Style Modifiers

Combine colors with text styles:

- **Bold**: `style.bold()`
- **Dim**: `style.dim()`
- **Italic**: `style.italic()`
- **Underline**: `style.underline()`

## Default Theme

pzsh includes oh-my-zsh compatible default styles:

| Element | Style |
|---------|-------|
| User | Green + Bold |
| Host | Blue + Bold |
| CWD | Cyan |
| Git (clean) | Green |
| Git (dirty) | Yellow |
| Error | Red + Bold |
| Success | Green |

## Environment Detection

pzsh automatically detects terminal capabilities:

- `NO_COLOR`: Disables all colors (https://no-color.org/)
- `CLICOLOR_FORCE`: Forces colors even without TTY
- `COLORTERM=truecolor`: Enables 24-bit color

## Performance

Color rendering is O(1) with pre-computed ANSI escape sequences. Style application adds no measurable overhead to prompt generation.