40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
|
# Frame Bubbletea Upgrade — Completion Summary
|
||
|
|
|
||
|
|
**Completed:** 22 February 2026
|
||
|
|
**Module:** `forge.lthn.ai/core/cli`
|
||
|
|
**Status:** Complete — Frame implements tea.Model with full bubbletea lifecycle
|
||
|
|
|
||
|
|
## What Was Built
|
||
|
|
|
||
|
|
Upgraded the Frame layout system from a static HLCRF renderer to a full
|
||
|
|
bubbletea `tea.Model` with lifecycle management, keyboard handling, and
|
||
|
|
panel navigation.
|
||
|
|
|
||
|
|
### Key changes
|
||
|
|
|
||
|
|
- **Frame implements `tea.Model`** — `Init()`, `Update()`, `View()` lifecycle
|
||
|
|
- **`KeyMap`** — configurable keybindings with default set (quit, navigate,
|
||
|
|
help, focus cycling)
|
||
|
|
- **`Navigate(name)` / `Back()`** — panel switching with history stack
|
||
|
|
- **Focus management** — Tab/Shift-Tab cycles focus between visible models
|
||
|
|
- **lipgloss layout** — HLCRF regions (Header, Left, Content, Right, Footer)
|
||
|
|
rendered with lipgloss instead of raw ANSI
|
||
|
|
- **`FrameModel` interface** — models register with `Frame.Header()`,
|
||
|
|
`.Content()`, `.Footer()` etc., receiving focus/blur/resize messages
|
||
|
|
|
||
|
|
### Tests
|
||
|
|
|
||
|
|
Navigate/Back stack tests, focus cycling, key dispatch, resize propagation.
|
||
|
|
All passing with `-race`.
|
||
|
|
|
||
|
|
### Dependencies
|
||
|
|
|
||
|
|
- `github.com/charmbracelet/bubbletea`
|
||
|
|
- `github.com/charmbracelet/lipgloss`
|
||
|
|
|
||
|
|
### Consumer
|
||
|
|
|
||
|
|
`go-blockchain/cmd/chain/` is the first consumer — TUI dashboard uses
|
||
|
|
Frame with StatusModel (header), ExplorerModel (content), KeyHintsModel
|
||
|
|
(footer).
|