ui

type Env struct {
	// Out is the destination for data: tables, JSON, anything pipeable.
	Out io.Writer

	// Err is the destination for chrome: spinners, prompts, and diagnostics.
	Err io.Writer

	// Style reports whether ANSI styling may be written to Out.
	Style bool

	// ErrStyle reports whether ANSI styling may be written to Err.
	ErrStyle bool

	// Anim reports whether animation may be written to Err. It is stricter than
	// ErrStyle, additionally requiring an interactive, non-CI session.
	Anim bool

	// ASCII reports whether output must avoid non-ASCII glyphs.
	ASCII bool

	// Width is the session width, for chrome on Err, or 0 when undetermined.
	Width int

	// DataWidth is the width available to data on Out, or 0 when data must be
	// left unconstrained. It is tracked separately from Width because a
	// terminal on Err says nothing about Out: reflowing to a width Out does not
	// have would corrupt a pipe.
	DataWidth int

	// DataTTY reports whether Out is an interactive terminal outside CI.
	// Layout that is only meaningful on a screen someone is watching live -
	// cards, boxed tables, the records fallback - is gated on it rather than
	// on Style.
	DataTTY bool

	// ErrTTY reports whether Err is an interactive terminal outside CI, which
	// gates glyphs and other screen-only chrome.
	ErrTTY bool

	// Machine reports whether machine-readable output was asked for. When true,
	// Style, ErrStyle, and Anim are all false.
	Machine bool

	// Mask reports whether sensitive values (secrets, tokens, and similar)
	// should be hidden rather than printed in full. It is independent of
	// Machine: --output json still masks, since piping to a script is not
	// consent to leak a secret into a log. It is true unless the invocation
	// is running in CI or --show was passed.
	Mask bool
	// contains filtered or unexported fields
}

type Glyphs struct {
	Success   string
	Failure   string
	Warning   string
	Info      string
	Cancelled string
	Pending   string
	Bullet    string
	Arrow     string
	Ellipsis  string

	// Hint leads the suggestion that follows a diagnostic, pointing at what to
	// do about it. It is a different arrow from Arrow, which prefixes prompts.
	Hint string

	// Separator and None carry no state, but both need an ASCII fallback.
	Separator string
	None      string

	// Spinner holds the animation frames, which must all be the same display
	// width or the line jitters as it cycles.
	Spinner []string
}

type Option func(*config)

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

type SpinnerOption func(*Spinner)

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

type Tone int