output

type AtomicWriter ¶

type AtomicWriter struct {
	// contains filtered or unexported fields
}

AtomicWriter is a goroutine-safe, mutable reference to an io.Writer.

It is useful for packages that need to emit user-facing output but also want to cooperate with a higher-level UI that may redirect output to a managed writer (e.g. a progress UI that has to keep terminal rendering stable).

AtomicWriter stores a wrapper type in sync/atomic.Value to avoid the common panic caused by storing interface values of different concrete types (e.g. *os.File vs *bytes.Buffer).

func NewAtomicWriter(fallback io.Writer) *AtomicWriter

func (aw *AtomicWriter) Get() io.Writer

func (aw *AtomicWriter) Set(w io.Writer)

type Callout ¶

type Callout struct {
	Style      CalloutStyle
	StatusText string
	Content    string
}

Callout renders a small status+content block.

In color mode, it uses lipgloss to render ANSI styles (no borders). When color is disabled, it emits plain text.

func (c Callout) Render(out io.Writer) string

type CalloutStyle ¶

type CalloutStyle int

CalloutStyle selects the visual style used by Callout.

const (
	// CalloutDefault is the default callout style.
	CalloutDefault CalloutStyle = iota
	// CalloutSucceeded is the success callout style.
	CalloutSucceeded
	// CalloutWarning is the warning callout style.
	CalloutWarning
	// CalloutFailed is the failure callout style.
	CalloutFailed
)

type Labels ¶

type Labels struct {
	Rows [][2]string

	// LabelWidth pads the label column to the given width.
	// When 0, it is computed from Rows.
	LabelWidth int

	// Gap is the number of spaces between the two columns.
	// When 0, it defaults to 1.
	Gap int
}

Labels renders aligned two-column text (label/value pairs).

When color is enabled, the label column is styled as dark gray and the value column keeps the default terminal style.

The value column is intentionally not width-constrained. Long values (e.g. URLs) are expected to wrap naturally by the terminal.

func (l Labels) Lines(out io.Writer) []string

func (l Labels) Render(out io.Writer) string