diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/config.md | 9 | ||||
| -rw-r--r-- | docs/themes.md | 5 |
2 files changed, 12 insertions, 2 deletions
diff --git a/docs/config.md b/docs/config.md index e8c25ceb..899d4cc4 100644 --- a/docs/config.md +++ b/docs/config.md @@ -254,8 +254,8 @@ format, and it is `pardes.Theme` serialised by `std.zon.stringify`: the theme name, thirteen required RGB roles (`sel_bg`, `sel_fg`, `tag_bg`, `tag_fg`, `box`, `box_dim`, `kw`, `str`, `num`, `comment`, `lineno`, `scroll_track`, `scroll_thumb`), nullable `bg`/`fg`, and either a 16-color RGB `palette` or -`null`. Nine optional nullable RGB roles extend this format: -`tag_active_bg`, `tag_active_fg`, `border`, `search_bg`, `search_fg`, +`null`. Optional nullable RGB roles extend this format: +`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `border`, `lineno_active`, `search_bg`, `search_fg`, `diagnostic_error`, `diagnostic_warning`, `diagnostic_info`, and `diagnostic_hint`. Missing new roles use backward-compatible defaults, so previously exported files remain valid. [Theme customization](themes.md) @@ -263,6 +263,11 @@ describes each role and its fallback. RGB values are three-byte arrays, and hex literals are accepted. The original fields remain required; there is no inheritance or partial override layer. +`tag_name_fg` gives the filename at the end of a pane's path a separate +foreground on both normal and active tags. When omitted or `null`, it uses +the corresponding tag foreground. Directory text and tag commands retain +their regular colors; selecting filename text uses the selection colors. + `Filter` in a terminal's tag projects that pane's ANSI colors through the active theme, and does it in two stages. The default foreground and background roles are mapped FIRST, because ghostty-vt generates the whole 256-color diff --git a/docs/themes.md b/docs/themes.md index 7d71d0dd..d2cad95b 100644 --- a/docs/themes.md +++ b/docs/themes.md @@ -37,6 +37,10 @@ tints. Active pane and column tags use a restrained tone-on-tone shift, not a light/dark inversion: dark palettes keep dark tags, and light palettes keep light tags. A slight text lift and the focus marker retain the cue without turning the entire command strip into a highlight. +The filename at the end of a pane's path uses a subtle accent tint, mixed +from the tag text and each palette's accent. The directory and commands keep +their usual foreground. Filename text meets the same contrast threshold on +both normal and active tag backgrounds. Comments are colorful first-class text, while line numbers stay quiet; the current line number gets a small color emphasis and bold weight, never a bright tag-colored block. These are appearance changes only; @@ -98,6 +102,7 @@ so existing exported themes remain valid. | Optional role | Purpose | When absent | | --- | --- | --- | | `tag_active_bg`, `tag_active_fg` | Focused pane tag surface and text | `tag_bg`, `tag_fg` | +| `tag_name_fg` | Filename at the end of the pane's path, on normal and active tags | The corresponding normal or active tag foreground | | `border` | Quiet separators | `scroll_track` | | `lineno_active` | Restrained current line number foreground | `lineno` | | `search_bg`, `search_fg` | Search matches, independent of selection | `sel_bg`, `sel_fg` | |