ThemeSelectorScreen

Key bindings for the selector.

Esc dismisses, restoring the original theme unless a t save set a per-terminal default this session (in which case that theme is kept). Arrow keys and Enter are handled natively by the embedded OptionList; Tab / Shift+Tab are bound here to advance the option list cursor for consistency with other selector screens (where Tab cycles focus across multiple widgets). action_toggle_names toggles between human-readable labels and canonical registry keys, which are accepted by the theme config. The terminal-default action saves the highlighted theme for the current terminal and updates the (default) badge in place without closing the picker.

Styling for the centered modal shell, title, option list, and help footer.

Compose the screen layout.

Apply ASCII border if needed.

Live-preview the highlighted theme.

Commit the selected theme.

Dismiss, keeping a terminal default chosen this session or restoring.

Pressing t to save a per-terminal default is a deliberate choice, so Esc keeps that theme instead of reverting. action_set_for_terminal records the choice synchronously (and clears it only if the async save fails), so Esc keeps the theme even when the write is still in flight; the persisted [ui.terminal_themes] mapping is the source of truth across sessions. dismiss(None) intentionally skips the global [ui].theme write. Without a t press — or after a failed save — Esc restores the theme that was active when the picker opened.

Move the option list cursor down (Tab).

Move the option list cursor up (Shift+Tab).

Persist the highlighted theme as the default for TERM_PROGRAM.

Writes [ui.terminal_themes][TERM_PROGRAM] = name and updates the (default) badge in the option list without closing the picker, so the user can confirm the change and keep browsing. [ui].theme is intentionally not touched because this action saves only the current terminal default. Config writes are serialized in app.py, so overlapping global-theme and per-terminal-theme saves cannot clobber each other's keys.

No-ops with a warning toast if TERM_PROGRAM is unset, or silently if the option list has no highlighted entry / the highlighted id isn't a registered theme.

Toggle between human labels and registry keys in the option list.

Useful for copying the canonical key into [ui.terminal_themes] or [ui].theme without leaving the picker.