Skip to main content

Module inline_mode

Module inline_mode 

Source
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

  1. Cursor is restored after each frame present.
  2. Terminal modes are restored on normal exit AND panic.
  3. No full-screen clears in inline mode (preserves scrollback).
  4. One writer owns terminal output (enforced by ownership).

Structs§

InlineConfig
Configuration for inline mode rendering.
InlineRenderer
Inline mode renderer implementing the one-writer rule.

Enums§

InlineStrategy
Inline mode rendering strategy.