1# llimphi-widget-terminal
2
3**Infinite, virtualized** terminal surface.
4
5Full design: `02_ruway/shuma/SDD-TERMINAL.md`. The control replaces the shell's
6`output_pane` in phases: unlimited scrollback at **constant** render cost (only
7the visible window is painted), three modes over the same cloth (IDE line / TUI
8grid / hybrid) and direct GPU where it pays off.
9
10**Phase 0:** **Layer 0** — `store::Scrollback`, an append-only scrollback store
11with a line index, a memory cap and O(1) access. Pure, with no UI dependencies:
12the agnostic core lives apart from whoever paints it (Rule 2).
13
14**Phase 1:** line mode — `view::line_surface` materializes only the visible rows
15under the widget's own `scroll_y` (**constant** render cost at unlimited
16scrollback), global numbering and colour by runs.
17
18**Phase 2:** **Layer 1** — the **blocks** model (`blocks`): the stream is a
19sequence of `blocks::Item`s (fixed-height chrome painted by the caller + ranges
20of store lines), virtualized over mixed heights with binary search; collapsing a
21block means not emitting its body. It maps the shell's `output_pane`
22(header/badge/stages/collapse) without the widget knowing about commands
23(Rule 2). Phase 1's line mode is the single-`Item::Lines` case.
24
25---
26
27Part of **llimphi** — see [llimphi](../../README.md).