summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-15 15:17:32 -0300
committerGabriel Schneider <[email protected]>2026-09-15 17:24:42 -0300
commit3327666759d47cad41d97264cd1f7b8ec64eafed (patch)
treedacb3cd5490f0a3a162f7ec8161ac138f6d35590 /docs
parent7d75f5d7f1394a09c6a2cc42c2a9a60e6aef7b12 (diff)
downloadpardes-3327666759d47cad41d97264cd1f7b8ec64eafed.tar.gz
pardes-3327666759d47cad41d97264cd1f7b8ec64eafed.zip
Match filename tint lightness in every canonical theme and focus state
Diffstat (limited to 'docs')
-rw-r--r--docs/config.md9
-rw-r--r--docs/themes.md3
2 files changed, 8 insertions, 4 deletions
diff --git a/docs/config.md b/docs/config.md
index 53c76087..5a7a358f 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -268,7 +268,7 @@ 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`. Optional nullable RGB roles extend this format:
-`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `border`, `lineno_active`, `search_bg`, `search_fg`,
+`tag_active_bg`, `tag_active_fg`, `tag_name_fg`, `tag_active_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)
@@ -277,8 +277,11 @@ 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
+foreground. `tag_active_name_fg` can adjust that tint for active tags; it falls
+back to `tag_name_fg`. When both are omitted or `null`, the filename uses
+the corresponding tag foreground. All canonical themes use a different hue
+at similar perceived brightness to the surrounding text in both states.
+Directory text and tag commands retain
their regular colors; selecting filename text uses the selection colors.
Terminal tags use this color for `Tty`, which comes immediately after the path.
diff --git a/docs/themes.md b/docs/themes.md
index 5c7da44b..01965de5 100644
--- a/docs/themes.md
+++ b/docs/themes.md
@@ -102,7 +102,8 @@ 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 |
+| `tag_name_fg` | Filename or terminal `Tty` command tint | The corresponding normal or active tag foreground |
+| `tag_active_name_fg` | Filename or terminal `Tty` tint in active tags | `tag_name_fg`, then the 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` |