Expand description
Inline Mode Spike: Validates correctness-first inline mode strategies.
This module implements the Phase -1 spike (bd-10i.1.1) to validate inline mode strategies for FrankenTUI. Inline mode preserves terminal scrollback while rendering a stable UI region + streaming logs.
§Strategies Implemented
- Strategy A (Scroll-Region): Uses DECSTBM to constrain scrolling to a region.
- Strategy B (Overlay-Redraw): Save cursor, clear UI, write logs, redraw UI, restore.
- Strategy C (Hybrid): Overlay-redraw baseline with scroll-region optimization where safe.
§Key Invariants
- Cursor is restored after each frame present.
- Terminal modes are restored on normal exit AND panic.
- No full-screen clears in inline mode (preserves scrollback).
- One writer owns terminal output (enforced by ownership).
Structs§
- Inline
Config - Configuration for inline mode rendering.
- Inline
Renderer - Inline mode renderer implementing the one-writer rule.
Enums§
- Inline
Strategy - Inline mode rendering strategy.