doc.go RawHistoryFolder

1// Package ansi emits ANSI terminal output from the frontend-neutral
2// github.com/bnema/vev-vt/core model.
3//
4// The package owns output planning, ANSI encoding, and a transactional renderer
5// shadow. Renderers consume the read-only CellSource contract. Cell, Style, RGB,
6// Frame, CellSource, Damage, and RuneWidth are aliases of the core package.
7//
8// [New] preserves the historical truecolor behavior. A renderer created by
9// [NewWithColorProfile] projects every color-bearing style field to its chosen
10// [ColorProfile]. [ColorProfileTrueColor] preserves RGB and indexed colors
11// exactly as earlier releases did. [ColorProfileANSI256] converts RGB colors to
12// the nearest fixed xterm color in indices 16 through 255 while preserving
13// valid indexed colors. [ColorProfileANSI16] preserves indices
14// 0 through 15, converts other foreground and background colors to the nearest
15// canonical ANSI color, and omits explicit underline colors.
16// [ColorProfileMonochrome] omits foreground, background, and underline colors
17// while preserving non-color attributes.
18//
19// RGB conversion minimizes squared distance in sRGB space and chooses the lower
20// palette index on ties. ANSI-256 conversion compares the 6x6x6 color cube with
21// the 24-step gray ramp; it does not generate theme-dependent indices 0 through
22// 15. ANSI-16 output uses basic 30-37, 40-47, 90-97, and 100-107 SGR codes.
23//
24// Constrained profiles omit indexed values outside 0 through 255. Color
25// projection is identical for full and incremental draws. Renderer
26// configuration is fixed for its lifetime; construct a new Renderer when the
27// output target changes.
28package ansi