loom documentation
The published release is 0.2.1, paired with weft 0.2.1 or newer. Use the getting-started guide and stable API reference for that release. These repository guides describe this branch; unreleased additions are marked.
| Guide | Scope |
|---|---|
| Architecture | Frames, widgets, text geometry, application ownership |
| Collections and interaction | Stable IDs, lists/tables, scrolling, focus and keys |
| Common widgets | Gauges, tabs, fills and rich panel titles |
| Widget and rendering details | Borders/shadows, row measurement, wrapping, layout cache, buffers and backends |
| Plotting and calendars | Sparkline, grouped bars, Chart, Canvas and MonthlyCalendar |
| Viewports | Fixed/inline placement, scrollback insertion and recovery |
| Platform support | Unicode policy, macOS/Linux/Windows evidence and native Windows boundaries |
| API customization — unreleased | Repeated prefixes, column flex, independent titles, line alignment, markers, legends, fills and diff controls |
The unreleased reference describes
PR #2, based on source revision
0ac2ae4. These APIs preserve current defaults and shared paint/hit/copy
geometry, but are not available from the 0.2.1 tag.
Validation and historical records
PR #2 CI passed 315 tests and all executable builds on macOS, Windows, and Linux under C and C.UTF-8. macOS and Linux additionally passed the four PTY checks. weft validates native console restoration/input and ConPTY separately. These checks do not establish every terminal emulator/font combination or performance parity.
The original Ratatui audit, feature gap plan and implementation record preserve dated findings and validation counts. Their original missing-feature tables are historical; see the audit's current status table before treating an entry as an open gap.