doc.go RawHistoryFolder

1// Package vt implements the frontend-neutral terminal emulator core.
2//
3// It tracks the visible cell grid, damage rectangles, scroll regions,
4// alternate-screen state, cursor/reporting modes, and common xterm/VT control
5// sequences. Wide runes that fit are stored as a head cell plus a continuation
6// cell, and resize or edit operations repair row-boundary splits instead of
7// leaving orphaned halves.
8//
9// Stateful values are single-owner and are not internally synchronized. The
10// owner must serialize Write, Resize, Snapshot, and History mutations. Write
11// parses synchronously: every callback runs before Write returns and callbacks
12// are delivered in the order their control sequences are encountered. A line
13// eviction callback receives a stable row copy; response bytes should be
14// consumed or copied during the callback. Other callback arguments are values
15// or strings owned by the callback.
16//
17// Snapshot and HistorySnapshotView capture owned state without sealing or
18// mutating the live owner. Screen, ScreenSnapshot, and core.Frame expose
19// storage-independent CellSource reads, and Row methods return owned copies.
20// HistoryView.Row and HistoryView.Range decode owned semantic rows from compact
21// slabs. A HistoryChunk pointer has stable identity for the lifetime of the
22// view, so consumers can reuse unchanged sealed chunks.
23package vt