doc.go RawHistoryFolder

1// Package html prepares safe, transactional browser updates from the
2// frontend-neutral github.com/bnema/vev-vt/core model.
3//
4// Renderer state is single-owner and is not internally synchronized. Prepare
5// allows exactly one outstanding draw. The consumer must call Commit only
6// after accepting the immutable update, or Abort to preserve the committed
7// shadow. Reset invalidates any outstanding draw.
8//
9// Damage values are non-authoritative hints: every row is compared with the
10// committed shadow, so mutations outside reported damage remain observable.
11// Updates replace complete rows to preserve wide-cell atomicity. Rows are
12// encoded as text runs of same-style printable ASCII; wide and non-ASCII
13// characters stay single entries. Scroll damage
14// uses a full snapshot until browser measurements justify a more complex plan.
15//
16// The package emits typed data and structural CSS; it never converts terminal
17// text to markup. Package browser owns safe DOM application and neutral input
18// events. HTTP, WebSocket, sessions, PTY encoding, and application policy are
19// consumer responsibilities.
20package html