Tint pane tag filenames with an optional theme color

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