feat(maestro): palette of named colour roles for the TUI
Every colour the TUI painted on its own chrome was a named ratatui colour spelled out at the use site, so nothing could be themed and the selected card had broken contrast: the highlighted card's black-on-cyan base was patched with an activity colour chosen for the dark card background, leaving AwaitingInput yellow on light blue. Roles now live in `palette.rs`, named for meaning. A palette holds one role set per surface — card and selection — plus the panel border in its focused and unfocused forms, a focus accent, a group-row style for the sidebar grouping, the status-bar mode indicators and error text. Each surface carries its own activity colours, so the selected card's dot keeps carrying state without wearing a colour picked for another background. Values are `Color::Rgb`, so contrast is asserted rather than left to the terminal theme: every role clears WCAG AA on its own surface, and a sidebar test fails if a card-surface state colour is painted onto the selection background. PTY cell colours stay a passthrough of what the program in the pane emits — they are not chrome and not a palette role.
This commit is contained in:
+20
-11
@@ -68,21 +68,30 @@ web has always surfaced this; the TUI may omit it).
|
||||
|
||||
The state word is never spelled out — the colour carries it.
|
||||
|
||||
| Activity state | Web token | ratatui colour |
|
||||
| ---------------- | --------- | ----------------- |
|
||||
| `Active` | `--live` | `Color::Green` |
|
||||
| `Idle` | `--muted` | `Color::DarkGray` |
|
||||
| `AwaitingInput` | `--warn` | `Color::Yellow` |
|
||||
| `Error` | `--danger`| `Color::Red` |
|
||||
| Activity state | Web token | TUI palette role |
|
||||
| ---------------- | --------- | ---------------- |
|
||||
| `Active` | `--live` | `active` |
|
||||
| `Idle` | `--muted` | `idle` |
|
||||
| `AwaitingInput` | `--warn` | `awaiting` |
|
||||
| `Error` | `--danger`| `error` |
|
||||
|
||||
Web tokens resolve per theme automatically (`styles.css` defines dark, light,
|
||||
and `prefers-color-scheme` variants for each). The TUI uses the plain ratatui
|
||||
named colours above; do not introduce RGB values or a new palette module for
|
||||
this.
|
||||
and `prefers-color-scheme` variants for each). The TUI names roles, not
|
||||
colours: a role's value comes from the active palette
|
||||
(`maestro-tui/src/palette.rs`), never from a colour spelled out at the use
|
||||
site.
|
||||
|
||||
A palette holds one role set per **surface** — the card surface every card
|
||||
sits on, and the selection surface the highlighted card swaps in — so each
|
||||
state role resolves to the value picked for the surface it is painted on. The
|
||||
highlighted card therefore takes its state colours from the selection
|
||||
surface; a colour chosen for the card background is never painted onto the
|
||||
selection background. Contrast is a property of the palette (values are RGB)
|
||||
and is asserted in the palette's tests, not left to the terminal theme.
|
||||
|
||||
The duration text inherits its state's colour; the blocked-work, exited and
|
||||
command fragments use the muted colour (`--faint` / default style), since the
|
||||
⚠ glyph already signals severity.
|
||||
command fragments use the surface's `muted` role, since the ⚠ glyph already
|
||||
signals severity.
|
||||
|
||||
## Duration format
|
||||
|
||||
|
||||
Reference in New Issue
Block a user