diff --git a/docs/superpowers/specs/2026-03-16-color-scheme-design.md b/docs/superpowers/specs/2026-03-16-color-scheme-design.md index 27bdf2e..56120b5 100644 --- a/docs/superpowers/specs/2026-03-16-color-scheme-design.md +++ b/docs/superpowers/specs/2026-03-16-color-scheme-design.md @@ -255,6 +255,14 @@ All three gradient sequences (green, orange, purple main + complementary) are no ### Theme ID Naming IDs are `"green"`, `"orange"`, `"purple"` — matching the menu labels exactly for clarity. +### Terminal Resize Handling +The `pick_color_theme()` function mirrors `pick_font_face()`, which does not handle terminal resizing during the picker display. If the terminal is resized while the picker menu is shown, the menu redraw may be incomplete; pressing any key (arrow, j/k, q) continues normally. This is acceptable because: +1. The picker completes quickly (< 5 seconds typical interaction) +2. Once a theme is selected, the menu closes and rendering begins +3. The streaming phase (`stream()`) is resilient to terminal resizing and auto-reflows to new dimensions + +No special resize handling is needed for the color picker beyond what exists for the font picker. + ### Testing Strategy 1. **Unit tests** (`tests/test_themes.py`): - Verify Theme class construction