primer

module

v0.1.4 Latest Latest Go to latest Published: Jul 24, 2026 License: MIT

Details

A Charm-native library of reusable terminal UI primitives.

Package	Description
`ansi/hyperlink`	OSC 8 terminal hyperlinks with TTY-aware fallback modes
`filter`	Smart-case text matching with `!` negate, `^` prefix, `$` suffix modifiers
`flash`	Transient status message state with monotonic-ID expiry
`human`	Human-readable time formatting, path contraction, and path expansion
`helpbar`	Wrapped footer hints
`input`	Textarea factory with sensible TUI defaults and functional options
`helpsheet`	Two-column keybinding overlay sheet with dismiss footer
`key`	Shared key-name constants plus inline key-highlight rendering
`layout`	Line normalization, ANSI-aware hard wrapping, and separator rendering
`overlay`	Centered foreground placement over background content
`pick`	Generic multi-select interactive prompt built on huh
`picker`	Cursor-navigable options overlay with row/choice selection
`prompt`	Scrollable modal prompts with choice groups, hints, and interaction state
`render`	Terminal markdown, theme-derived glamour styles, and diff rendering
`scrollbar`	Proportional scrollbar rendering and scroll position math
`scrollwheel`	Mouse wheel event coalescing for Bubble Tea filters
`table`	ANSI-aware column alignment, typed sorting, and generic table rendering
`term`	Terminal detection and size queries
`view`	Viewport body rendering and composable fullscreen frame footers

go get github.com/gechr/primer@latest

Path	Synopsis
filter
flash Package flash provides state management for transient status messages in Bubble Tea applications.	Package flash provides state management for transient status messages in Bubble Tea applications.
helpbar
helpsheet
input
key
layout
overlay
pick
picker
prompt
render Package render provides terminal-friendly markdown and diff rendering.	Package render provides terminal-friendly markdown and diff rendering.
scrollbar
scrollwheel Package scrollwheel coalesces rapid mouse wheel events into batched scroll messages, preventing per-event Update + Render cycles from pegging CPU.	Package scrollwheel coalesces rapid mouse wheel events into batched scroll messages, preventing per-event Update + Render cycles from pegging CPU.
table
view