Lipgloss Layers: Proper Styles, Proper Keybindings

[JasonWarrenUK]

Overview

Replaces the TUI's ad-hoc styling and vim-style keybinding system with idiomatic Lipgloss v2 patterns and the standard bubbles/key library. View palettes use typed color.Color instead of raw hex strings, the command palette overlay uses Lipgloss Compositor instead of a brittle line-replacement hack, the Glamour markdown renderer is cached for performance, and all single-char vim bindings (j/k/q/:) are replaced with modifier-based keys (ctrl+c, ctrl+n, ctrl+p, arrows) to eliminate collisions with terminal escape sequences.

Summary

Imagine you've been navigating your house by shouting room names through a megaphone while wearing mismatched shoes. This PR replaces the megaphone with actual doors, gives you matching shoes, and stops the neighbours complaining about the noise. The house is the same; you just look less unhinged walking through it.

Tip

No manual steps required. Keybindings have changed — q no longer quits (use ctrl+c), : no longer opens palette (use ctrl+p), i no longer captures (use ctrl+n). Arrow keys replace j/k/h/l throughout.

---

Changes

Keybinding system rewrite — keyboard.go, app.go, app_test.go

• Replaced custom KeyAction enum, keyRule table, and KeyMap struct with idiomatic bubbles/key.Binding declarations (AppKeyMap)
• App-level key dispatch now uses key.Matches() switch instead of handleAction() indirection
• Removed jumpMsg type — jump-to-top/bottom handled directly by list/viewport KeyMap configuration
• All single-char bindings removed: q → ctrl+c, : → ctrl+p, i → ctrl+n, j/k → arrows
• Tests updated to use modifier key presses; new tests for spurious byte rejection (OSC 11 responses) and ctrl+c-before-ready

Pane keybinding configuration — node_list_pane.go, pane.go, capture.go

• nodeListPane: reconfigures bubbles/list KeyMap directly — removes j/k/g/G, keeps arrows/pgup/pgdn/home/end
• viewportPane: reconfigures bubbles/viewport KeyMap — removes j/k/d/u/f/b/space, keeps arrows/pgup/pgdn/ctrl+d/ctrl+u
• Capture key changed from i to ctrl+n; placeholder text updated
• KeyBindings() return values updated across both pane types

Lipgloss v2 Compositor overlay — app.go, palette.go

• Command palette overlay now uses lipgloss.NewCompositor() with NewLayer().X().Y().Z() instead of splitLines/joinLines replacement
• Palette View() no longer pads itself horizontally — centring delegated to Compositor via Layer.X()
• Removed splitLines and joinLines helper functions from app.go
• Selected palette row uses Selection() background (VS.7)
• Border background set explicitly on palette box to prevent bleed

Status bar polish — statusbar.go, layout.go

• Status bar now 2 lines: separator (─) + content bar
• Added SetKeyHints() — focused pane's bindings shown as compact hints
• Layout statusBarHeight updated from 1 → 2; border calculation adjusted for Lipgloss v2 outer dimensions
• Spacer() used for all internal gaps (no more strings.Repeat)
• syncKeyHints() called on focus change, form open/close, and pane mount

View palette type safety — views/budget.go, views/list.go, views/prose.go, views/schedule.go, views/timeline.go

• All palette struct fields changed from string to color.Color (VS.1)
• Default*Palette() functions return lipgloss.Color(...) typed values
• Removed all lipgloss.Color(stringField) wrapper calls at render sites — fields used directly

Glamour renderer caching — detail.go, app.go

• DetailRenderer now caches its glamour.TermRenderer instance, only recreating when Width changes
• Model holds a long-lived detailRenderer field instead of creating one per selection
• Detail rendering moved to async via renderDetailAsync() / detailReadyMsg to keep the event loop responsive

Roadmap updates — docs/roadmaps/tui.md, docs/diagrams/roadmap-tui.html

• VS.1, VS.2, VS.6, VS.7, VS.11 marked complete
• VS.3–VS.5, VS.9, VS.10 unblocked (moved from Blocked → To Do)
• Mermaid dependency graph pruned: completed nodes removed, edges updated
• RT.1, CL.1, CL.2 dependency annotations updated (CP.1 marked done)
• LG.7 duplicate entry consolidated

---

🤖 Generated with Claude Code