appstyles

func Contrast ¶

func Contrast(a, b color.Color) float64

Contrast is the WCAG 2.x contrast ratio between two opaque colors.

func FillBackground ¶

func FillBackground(bg color.Color, block string) string

FillBackground repaints `block` so every cell on every line carries `bg`.

Why this is needed: a terminal's SGR reset (`\x1b[m`) clears the background along with everything else, and it applies until the next SGR. lipgloss closes every styled run with a reset, so any *unstyled* text that follows a styled run on the same line renders on the terminal's default background — a visible notch in an otherwise solid panel.

Two things in the render pipeline produce exactly that unstyled text:

• lipgloss.JoinVertical/JoinHorizontal pad shorter blocks to the widest block with a bare strings.Repeat(" ", n) — see join.go. Unlike a style's own Width() padding, which alignTextHorizontal runs through the style's whitespace renderer, Join's padding carries no SGR at all.
• bubbles components (the lists' "No items." row, for one) join their inner rows the same way.

Wrapping the result in an outer Background() style does not help: that only styles the padding the outer style itself adds, so the bare spaces already sitting inside the block survive untouched.

So the fix has to run over the finished string. For each line we re-assert `bg` immediately after every reset, and open the line with it, which leaves any explicit inner background (a title pill, a status dot) intact while closing every gap around it. Foreground is deliberately not re-asserted: the runs we are patching are whitespace, and real text always brings its own foreground.

Apply this once per background tier, at the point that tier is established (see the tier comments in this package and docs/DESIGN.md). Applying it at an outer tier only would paint inner panels with the outer tier's color.

func FilterStatus ¶ added in v0.7.0

func FilterStatus() lipgloss.Style

FilterStatus styles a bubbles list's status bar, which the lists show only while a filter is standing - it is the only thing on screen that names the term once the filter has been accepted (bubbles draws the filter input while it is being typed and nothing after that; see list.titleView).

Like NormalTitle it is a function rather than a var, so it reads the live theme rather than whichever one happened to be active at package init. The bottom padding is bubbles' own default and is what separates the bar from the first row; the left padding lines it up with the title chip's gutter.

func HasBackgroundBleed ¶

func HasBackgroundBleed(block string) bool

HasBackgroundBleed reports whether any line in block contains a run of spaces that will render on the terminal's default background: spaces that follow a reset with no SGR in between. It is the inverse of what FillBackground guarantees, and exists so tests in any package can assert the invariant on a fully rendered frame rather than eyeballing a screenshot.

func InkOn ¶

func InkOn(fill color.Color) color.Color

InkOn returns whichever of the theme's two fixed inks reads better on fill.

InkOnLight/InkOnDark do not vary with the theme (see the Theme field comment) because the fills they sit on - a status pill, the accent title chip - are not derived from the surface tiers. What *does* vary is which of the two is correct, and that is a property of the fill, not of the call site. Hard-coding it worked while one dark theme existed; with a light theme and ten imported palettes in the registry, the same call site draws on a #BC3FBC magenta in one theme and a #A7C080 sage in another.

func NormalTitle ¶

func NormalTitle() lipgloss.Style

NormalTitle is THE accent title chip: bold ink derived from the theme accent on an accent background, with one space of padding on each side. Every title - the Details/GroupDetails frames, the Services, Groups and Containers list titles, and every modal heading - renders through this one style, so a theme or style change here lands on all of them at once. See PanelFrame.go.

The style deliberately carries no margin: the left gutter is the container's job. A bubbles list provides it via its internal TitleBar padding, and the panel frame adds MarginLeft(2) to match that gutter - see renderPanelFrame.

func SetTheme ¶

func SetTheme(name string) bool

SetTheme assigns a new active theme by name. Everything that draws reads Active fresh on each render, so the next frame repaints in the new palette. Exported so the theme picker modal can apply themes live as the cursor moves.

Returns false if name is not in the registry, so the caller can report the error. When config file persistence lands, this function gains a tea.Cmd return that writes the chosen name to disk - one line added, no caller changes needed.