theme

type Capabilities struct {
	// Dark reports whether the terminal background is dark.
	Dark bool

	// BackgroundHex is the exact terminal background color when the
	// detector could read it. Empty when detection could not run.
	BackgroundHex string

	// Profile is the active [colorprofile.Profile] for the primary
	// output stream.
	Profile colorprofile.Profile

	// Interactive reports whether primary output is a TTY and input
	// allows prompting.
	Interactive bool

	// Width is the terminal width in cells, or 0 when unmeasured.
	Width int

	// Hyperlinks reports OSC 8 hyperlink support.
	Hyperlinks bool

	// Unicode is the terminal's Unicode capability tier.
	Unicode UnicodeLevel

	// ReducedMotion reports whether animations should be suppressed
	// (NO_MOTION, REDUCE_MOTION, and similar flags).
	ReducedMotion bool
}

type Metadata struct {
	// Name is the manifest "name" field and [Get] registry key.
	Name string

	// Description is the manifest "description" field, or empty.
	Description string

	// Default is the fallback variant for [Theme.Resolve]. Empty for
	// single-variant themes.
	Default string

	// Variants is the sorted list of declared variant keys. Always
	// non-empty (schema requires at least one).
	Variants []string

	// TokenNames is the sorted, deduplicated set of token paths any
	// variant declares.
	TokenNames []string
}

type Override interface {
	// contains filtered or unexported methods
}

type Palette struct {
	// Tokens is the per-token style map. Missing tokens fall through
	// the alias chain ([Aliases] over [DefaultAliases]) before the
	// zero [lipgloss.Style].
	Tokens map[Token]lipgloss.Style

	// Aliases overrides [DefaultAliases] for this palette. A non-empty
	// mapping replaces the default; Aliases[X] = "" disables the
	// default for that key without substituting another.
	Aliases map[Token]Token

	// Chroma is an owned [*chroma.Style]. Non-nil wins over
	// [Palette.ChromaName]; when both are zero, [ChromaFromTokens]
	// supplies the default.
	Chroma *chroma.Style

	// ChromaName is the upstream chroma style name used when
	// [Palette.Chroma] is nil. Unknown names fall through to chroma's
	// own default at render time.
	ChromaName string

	// Glamour is an owned [*ansi.StyleConfig]. Non-nil wins over
	// [Palette.GlamourName] and [Palette.GlamourFor].
	Glamour *ansi.StyleConfig

	// GlamourName is the upstream glamour preset name used when
	// Glamour and GlamourFor are nil. Unknown names fall through to
	// glamour's own default.
	GlamourName string

	// GlamourFor is a capability-aware factory called by [Theme.Resolve]
	// when Glamour and GlamourName are zero. Errors surface from
	// [Theme.ResolveErr] (and are discarded by [Theme.Resolve]).
	GlamourFor func(Capabilities) (*ansi.StyleConfig, error)

	// Prompt is the Nabat-native prompt style block, converted to a
	// [huh.Theme] at resolve time. Zero falls back to
	// [PromptFromTokens]. [Palette.Huh] wins over Prompt when set.
	Prompt Prompt

	// Huh is the [huh.Theme] for interactive prompts. Non-nil wins
	// over [Prompt] and [PromptFromTokens]. Use it when the closed
	// [Prompt] surface is not enough.
	Huh huh.Theme
}

type Prompt struct {
	// Title styles the group / section title above prompts.
	Title lipgloss.Style

	// Description styles explanatory text under each prompt.
	Description lipgloss.Style

	// Cursor styles the text-input cursor.
	Cursor lipgloss.Style

	// Placeholder styles the text-input placeholder.
	Placeholder lipgloss.Style

	// SelectedOption styles the currently selected list item.
	SelectedOption lipgloss.Style

	// UnselectedOption styles items that are not selected.
	UnselectedOption lipgloss.Style

	// SelectedPrefix styles the marker next to the selected item.
	SelectedPrefix lipgloss.Style

	// UnselectedPrefix styles the marker next to non-selected items.
	UnselectedPrefix lipgloss.Style

	// Error styles error indicators and messages.
	Error lipgloss.Style

	// Help styles the keybind footer text.
	Help lipgloss.Style

	// Selector styles the active-row indicator and navigation arrows.
	Selector lipgloss.Style

	// ButtonFocused styles the focused submit / next button.
	ButtonFocused lipgloss.Style

	// ButtonBlurred styles the inactive button.
	ButtonBlurred lipgloss.Style

	// Border is the form / card border. The zero [lipgloss.Border]
	// leaves huh's base border untouched.
	Border lipgloss.Border

	// BorderColor is the focused field left-border foreground. The
	// zero value leaves huh's base border color untouched.
	BorderColor color.Color
}

type PromptKnobs struct {
	// SelectedPrefix is the literal prefix before selected options.
	SelectedPrefix string

	// UnselectedPrefix is the literal prefix before unselected options.
	UnselectedPrefix string

	// Border is the form/card border. The zero [lipgloss.Border]
	// leaves the prompt border unchanged.
	Border lipgloss.Border

	// BorderColor is the focused field left-border foreground. The
	// zero value leaves the prompt border color unchanged.
	BorderColor color.Color
}

type Requirement struct {
	Consumer string
	Tokens   []Token
}

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

type Resolver interface {
	Resolve(Capabilities) ResolvedTheme
}

type Theme struct {
	// Name identifies the theme in errors, the catalog key, and
	// [ResolvedTheme.Name]. Built-ins require it; programmatic themes
	// may leave it empty.
	Name string

	// Variants maps each declared [Variant] to its [Palette].
	// An empty map yields a zero [ResolvedTheme] from [Theme.Resolve]
	// (every Style call returns the zero [lipgloss.Style]).
	Variants map[Variant]Palette

	// Default is the variant [Theme.Resolve] picks when [Capabilities]
	// do not match a declared variant. For a single-variant theme the
	// lone key wins even when Default is [VariantUnset].
	Default Variant

	// ListEnum is the default enumerator for list output. Nil resolves
	// to [list.Bullet].
	ListEnum list.Enumerator

	// TableBorder is the default table border. The zero
	// [lipgloss.Border] resolves to [lipgloss.NormalBorder].
	TableBorder lipgloss.Border

	// PromptKnobs are theme-wide prompt settings applied to
	// token-derived and palette prompt styles.
	PromptKnobs PromptKnobs
}

type Token string

type UnicodeLevel uint8

type Variant string