Documentation
¶
Overview ¶
Package ui provides shared styling for the Truestamp CLI using lipgloss v2. Colors are sourced from the Catppuccin palette (Latte for light terminals, Mocha for dark). The same palette is used for both static lipgloss output and interactive huh components via HuhTheme().
IMPORTANT: Color initialization is deferred to Init() to avoid terminal queries at package init time. Querying the terminal (for dark/light background detection) in a background process group causes SIGTTIN, which hangs shell completion via source <(truestamp completion zsh).
Index ¶
- Variables
- func AccentBoldStyle() lipgloss.Style
- func FailureBanner(text string) string
- func FaintStyle() lipgloss.Style
- func HeaderBox(title, subtitle string) string
- func HuhTheme() huh.Theme
- func Init(noColor bool)
- func LabelStyle() lipgloss.Style
- func LabelValueStyleFunc() func(row, col int) lipgloss.Style
- func PickFile(opts PickFileOptions) (string, error)
- func SectionHeader(name string) string
- func SuccessBanner(text string) string
- func ValueStyle() lipgloss.Style
- type PickFileOptions
Constants ¶
This section is empty.
Variables ¶
var ( Green color.Color = catppuccin.Mocha.Green() Red color.Color = catppuccin.Mocha.Red() Yellow color.Color = catppuccin.Mocha.Yellow() Blue color.Color = catppuccin.Mocha.Blue() Accent color.Color = catppuccin.Mocha.Mauve() Dim color.Color = catppuccin.Mocha.Overlay0() Label color.Color = catppuccin.Mocha.Subtext0() Value color.Color = catppuccin.Mocha.Text() Banner color.Color = catppuccin.Mocha.Text() )
Color variables. Defaults to dark (Mocha) palette. Updated by Init() if the terminal has a light background.
Functions ¶
func AccentBoldStyle ¶
AccentBoldStyle returns a bold accent-colored style.
func FailureBanner ¶
FailureBanner renders a bold red failure message.
func HuhTheme ¶
HuhTheme returns the Catppuccin theme for huh interactive components. Uses the same Latte/Mocha palette as the static color definitions above.
func Init ¶
func Init(noColor bool)
Init configures the global color profile and detects the terminal's background color. Call once from root command before any output. If noColor is true, all ANSI sequences are stripped. The NO_COLOR env var is handled automatically by lipgloss.
func LabelStyle ¶
LabelStyle returns the style for key-value labels.
func LabelValueStyleFunc ¶ added in v0.3.0
LabelValueStyleFunc returns a lipgloss table StyleFunc that renders the first column as a right-aligned label and subsequent columns as the value. It matches the two-column "key: value" layout used by the create and download summary tables.
func PickFile ¶ added in v0.3.0
func PickFile(opts PickFileOptions) (string, error)
PickFile launches a single-page interactive file picker themed with the CLI's palette and returns the selected path. Returns an error if the user aborts, the form fails, or no file is selected.
func SectionHeader ¶
SectionHeader renders a styled group header with a separator line.
func SuccessBanner ¶
SuccessBanner renders a bold green success message.
func ValueStyle ¶
ValueStyle returns the style for key-value values.
Types ¶
type PickFileOptions ¶ added in v0.3.0
PickFileOptions configures an interactive file-picker form. Both fields are optional; Title defaults to "Select file" and AllowedTypes to "any file type".
Source Files