ui

func ContentRows ¶ added in v1.14.0

func ContentRows(frameHeight, chromeRows int, header, footer string) int

ContentRows is the space left for content inside a frame of frameHeight rows once the frame's own chrome (chromeRows) and the header and footer have taken theirs. A view that renders a viewport should size that viewport to this, so what the viewport scrolls is exactly what the frame draws.

func DistributeColumns ¶

func DistributeColumns(totalWidth, gapCount, gapWidth int, cols []int, flexIndices []int) []int

DistributeColumns adjusts column widths to fit `totalWidth` after accounting for `gapCount` gaps of `gapWidth` each. `cols` contains preferred/min widths for each column. `flexIndices` are indexes into `cols` that are allowed to absorb remaining space when total cols < available, or to be reduced when cols exceed available. The function returns a new slice with adjusted widths.

func FilterFragment ¶

func FilterFragment(query string) string

FilterFragment renders a trailing " </query>" fragment marking an active `/` filter, mirroring k9s (which appends the filter rather than folding it into the scope). The angle brackets share the label colour while the "/query" reuses the scope colour, so the filter reads as a scope refinement. It returns "" when no filter is active. Like the rest of ScopedTitle the result already carries ANSI styling, so styleFrameTitle passes it through unchanged.

func Frame ¶

func Frame(title, content string, width int) string

func LeftPadContent ¶

func LeftPadContent(content string) string

LeftPadContent prepends a single space to each line of content.

func OverlayCentered ¶

func OverlayCentered(base, overlay string, width, height int) string

func RenderColumnHeader ¶

func RenderColumnHeader(labels []string, colWidths []int) string

RenderColumnHeader builds a single-line header from labels and column widths. `labels` and `colWidths` must have the same length. It applies the FrameHeaderStyle to the resulting line so callers can place it in the framed header slot.

func RenderConfirmDialog ¶

func RenderConfirmDialog(message string) string

RenderConfirmDialog renders a standard confirmation dialog with y/n options

func RenderFileBrowserDialog ¶

func RenderFileBrowserDialog(title, currentPath string, files []string, cursor int) string

RenderFileBrowserDialog renders a file browser dialog with common styling

func RenderFramedBox ¶

func RenderFramedBox(title, header, content, footer string, width int) string

RenderFramedBox draws a bordered frame with title, optional header, and content. If width <= 0, defaults to content width + padding. ANSI sequences in content are preserved.

func RenderFramedBoxHeight ¶

func RenderFramedBoxHeight(title, header, content, footer string, width, frameHeight int) string

RenderFramedBoxHeight renders a framed box constrained to `frameHeight` lines (including borders). If `frameHeight` <= 0 the function falls back to the unconstrained `RenderFramedBox` behavior. This helper pads the content so the resulting framed box occupies exactly `frameHeight` lines when possible.

func RenderViewFrame ¶

func RenderViewFrame(title, header, content, footer string, width, height int, fullscreen bool) string

RenderViewFrame composes a complete framed view from its parts. It computes frame dimensions, trims/pads content to fit, and renders the bordered frame. When fullscreen is true the borders are dropped and a centered title line takes their place. Either way the result occupies exactly `height` rows, as long as the chrome, header and footer fit in them.

func ScopedTitle ¶

func ScopedTitle(label, scope string, count int) string

ScopedTitle renders a frame title of the form "Label(scope)[count]" with the label/separators, scope, and count coloured distinctly. The returned string already carries its own ANSI styling, so RenderFramedBox passes it through unchanged instead of re-applying FrameTitleStyle (see styleFrameTitle).

func ScopedTitleFiltered ¶

func ScopedTitleFiltered(label, scope string, count int, filter string) string

ScopedTitleFiltered renders ScopedTitle and, when filter is non-empty, appends a FilterFragment so the header reflects the active `/` filter, e.g. "Stacks(all)[1] </pos>". The count is expected to be the post-filter row count. See FilterFragment.

func SpinnerCharAt ¶

func SpinnerCharAt(frame int) string

SpinnerCharAt returns the spinner character for the given frame index. Falls back to an ellipsis if spinner charset is not available.

func SpinnerMarker ¶

func SpinnerMarker() string

SpinnerMarker returns the first spinner character (useful as a marker).

func ToggleRow ¶ added in v1.14.0

func ToggleRow(items []Toggle, width int) string

ToggleRow renders items as "Label:Value", gapped by toggleGap and centred in width, so a view's options read at a glance instead of hiding in prose. The result is always a single line no wider than width: the row is a frame header, and a header that grows a second line silently shrinks the content the frame draws.

A narrowing terminal closes the gaps first and only then drops items, from the right, marking the cut with "…" rather than truncating mid-item — a value cut to "Hid" reads as a state rather than as missing text.

func TrimOrPadContentToLines ¶

func TrimOrPadContentToLines(content string, lines int) string

TrimOrPadContentToLines returns content limited to exactly `lines` rows, padding with empty lines when shorter. Useful when framing viewport content to a fixed height.

func TruncateANSI ¶

func TruncateANSI(s string, width int) string

TruncateANSI truncates a string with ANSI codes to a specific visual (cell) width. It is grapheme/display-width aware (wide East-Asian chars and emoji count as 2 cells) and never splits an escape sequence.

func TruncateANSIAfter ¶

func TruncateANSIAfter(s string, skipWidth int) string

TruncateANSIAfter skips skipWidth visual cells and returns the rest, re-emitting the active SGR state at the cut so colors survive. It is grapheme/display-width aware and never splits an escape sequence.

func WrapText ¶

func WrapText(text string, width int) []string

WrapText wraps text to the specified width, breaking on word boundaries.