README.md

Deterministic terminal samples

These plain UTF-8 files are complete, source-controlled renderer frames:

• simple.txt
• verbose.txt
• search-matches.txt — one focused keyword occurrence, other matching record markers, and an occurrence count that includes keys and values
• nested-expanded-json.txt — recursively expanded provider content and response text with visible derived-display cues
• truncated-content.txt
• truncated-nested-leaves.txt — an expanded container whose long string leaf is independently previewed while structure remains visible
• malformed-input.txt
• tiny-terminal.txt
• plain-no-color.txt

tests/test_documented_samples.py reconstructs every frame through the public API and compares it byte for byte. ANSI is code-native rather than stored as opaque terminal bytes: the renderer's SGR role table is documented in the design system, and tests require stripping those SGR sequences to produce the exact corresponding plain frame.

The sample files are intentionally not screenshots. They remain searchable, reviewable, accessible without color, and byte-synchronized with the behavior that produces them.