theme

type Capabilities struct {
	// Dark reports whether the terminal background is dark. Themes use it
	// to pick foreground hex values that contrast appropriately and to
	// pick between glamour's "dark" and "light" presets.
	Dark bool

	// BackgroundHex is the exact terminal background color when the
	// detector could read it (typically via the OSC 11 query). Empty
	// when the detector could not run (non-TTY output, redirected
	// input, custom IO bundle). Themes that want to adapt to the
	// real background — say, a manifest tuned for a specific
	// off-white — branch on this value; themes that only need
	// "darkish vs lightish" stick with [Dark].
	BackgroundHex string

	// Profile is the active [colorprofile.Profile] for the primary output
	// stream. Themes use it to fall back from full-color hex values to
	// ANSI16/ANSI256 indexes, and to switch glamour to "notty" when the
	// stream is plain text.
	Profile colorprofile.Profile

	// Interactive reports whether the primary output stream is a TTY and
	// the input stream allows prompting. Themes that animate or use
	// background color blocks check this so non-interactive output stays
	// pipe-friendly.
	Interactive bool

	// Width is the terminal width in cells, or 0 when the framework
	// could not measure it (non-TTY output, sandboxed test bundle).
	// Themes use it for table / tree decisions; the framework's own
	// table layout reads it through the IO bundle.
	Width int

	// Hyperlinks reports whether the terminal supports OSC 8
	// hyperlinks. Themes / extensions that emit clickable URLs gate
	// the escape-sequence emission on this flag so they degrade to
	// raw URL text in unsupported terminals (most CI runners,
	// minimal SSH targets, etc.).
	Hyperlinks bool

	// Unicode reports the terminal's Unicode capability tier. Themes
	// pick enumerator characters (•, -, └─) and prefix glyphs based
	// on this; sticking to ASCII when the terminal cannot render
	// box-drawing characters keeps the output readable on legacy
	// Windows consoles and minimal CI environments.
	Unicode UnicodeLevel

	// ReducedMotion reports whether the framework should suppress
	// animations (spinners, progress sweeps, transition effects).
	// Set when the env signals "no motion please" via NO_MOTION,
	// REDUCE_MOTION, or similar accessibility flags. Consumers that
	// run animations check this and substitute a static rendering.
	ReducedMotion bool
}

type Metadata struct {
	// Name is the manifest's "name" field, identical to the registry
	// key used by [Get].
	Name string

	// Description is the manifest's "description" field. Empty when
	// the manifest omitted it.
	Description string

	// Default is the manifest's "default" field — the variant
	// [Theme.Resolve] falls back to when capabilities don't pin a
	// pick. Empty for single-variant themes.
	Default string

	// Variants is the sorted list of variant keys this manifest
	// declares ("dark" / "light" / "notty"). Always non-empty (the
	// schema requires at least one entry).
	Variants []string

	// TokenNames is the sorted, deduplicated set of token paths any
	// variant declares under its "tokens" map. Tools surfacing
	// "what does this theme cover?" use this without having to
	// re-aggregate per variant.
	TokenNames []string
}

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

type Palette struct {
	// Tokens is the per-token style map. Lookups in
	// [ResolvedTheme.Style] hit this map first; tokens the
	// palette omits fall through to the alias chain (per-palette
	// [Aliases] overlaid on [DefaultAliases]) before defaulting to
	// the zero [lipgloss.Style] (terminal default).
	Tokens map[Token]lipgloss.Style

	// Aliases overrides entries in [DefaultAliases] for this
	// palette. A non-empty mapping replaces the framework default;
	// an explicit empty Token value (Aliases[X] = "") disables the
	// framework default for that key without substituting another.
	//
	// Typical use: the manifest's "aliases" field, where a theme
	// author wants list bullets to follow text.secondary instead of
	// text.muted. Most themes leave this nil and inherit the
	// framework defaults wholesale.
	Aliases map[Token]Token

	// Chroma is an owned [*chroma.Style] for syntax highlighting.
	// When non-nil it wins over [Palette.ChromaName]; when both are
	// zero the palette's variant determines the framework default
	// via [ChromaPreset].
	Chroma *chroma.Style

	// ChromaName is the upstream chroma style name (e.g. "monokai",
	// "dracula"). 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] for markdown
	// rendering. When non-nil it wins over both
	// [Palette.GlamourName] and [Palette.GlamourFor].
	Glamour *ansi.StyleConfig

	// GlamourName is the upstream glamour preset name (e.g. "dark",
	// "light", "notty"). Used when both Glamour and GlamourFor are
	// nil; unknown names fall through to glamour's own default.
	GlamourName string

	// GlamourFor is the capability-aware factory used by themes
	// (typically the manifest loader's inline "glamourStyle" path)
	// that need to evaluate glamour against the current
	// [Capabilities]. Called by [Theme.Resolve] when both Glamour
	// and GlamourName are zero. The function may return an error
	// that surfaces from [Theme.Resolve].
	GlamourFor func(Capabilities) (*ansi.StyleConfig, error)

	// Prompt is the Nabat-native style block for interactive
	// prompts. The framework converts it to a [huh.Theme] at
	// [Theme.Resolve] time. Zero (the empty Prompt) means the
	// catalog falls back to [PromptFromTokens] using
	// [Palette.Tokens]; setting any field opts into the closed
	// Nabat-native surface and forgoes the framework default.
	//
	// [Palette.Huh] still wins over [Prompt] when set — that's
	// the escape hatch for themes that need huh's full surface.
	Prompt Prompt

	// Huh is the [huh.Theme] used by interactive prompts. When
	// non-nil it wins outright over [Prompt] and the
	// [PromptFromTokens] fallback. The escape hatch is for themes
	// that need huh's full per-state surface (separate focused /
	// blurred styling, custom textInput layout, etc.) — the
	// closed Nabat-native [Prompt] cannot express those.
	Huh huh.Theme
}

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

	// Description is the explanatory text rendered under each
	// prompt.
	Description lipgloss.Style

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

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

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

	// UnselectedOption styles the items not currently selected.
	UnselectedOption lipgloss.Style

	// SelectedPrefix styles the marker drawn next to the selected
	// item (often "✓ " or "● ").
	SelectedPrefix lipgloss.Style

	// UnselectedPrefix styles the marker drawn next to non-selected
	// items (often "  " or "○ ").
	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 (next / prev).
	Selector lipgloss.Style

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

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

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

type PromptKnobs struct {
	// SelectedPrefix is the literal prefix rendered before selected
	// options (for example "✓ ").
	SelectedPrefix string

	// UnselectedPrefix is the literal prefix rendered before
	// unselected options (for example "  ").
	UnselectedPrefix string

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

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 error messages, the catalog
	// registry key, and [ResolvedTheme.Name]. Required for built-in
	// themes; programmatic themes may leave it empty.
	Name string

	// Variants maps each declared [Variant] to its [Palette]. Most
	// themes ship a single entry; multi-variant themes carry one
	// palette per dark/light/notty mode and let [Theme.Resolve] pick
	// at runtime.
	//
	// An empty Variants produces a zero [ResolvedTheme] from
	// [Theme.Resolve] — every Style call returns the zero
	// [lipgloss.Style], which lipgloss renders as the terminal
	// default.
	Variants map[Variant]Palette

	// Default is the variant [Theme.Resolve] picks when the runtime
	// [Capabilities] do not point at one of the declared variants.
	// For single-variant themes it must equal the only key in
	// Variants; the zero [VariantUnset] is treated as the lone key
	// when exactly one variant exists.
	Default Variant

	// ListEnum is the default enumerator for [Context.List] output.
	// Themes that want bullets, dashes, or numbers without a
	// per-call override set it once here; the framework picks
	// [list.Bullet] when this is nil.
	ListEnum list.Enumerator

	// TableBorder is the default border drawn by [Context.Table]
	// when no per-call override is supplied. The zero
	// [lipgloss.Border] resolves to [lipgloss.NormalBorder].
	TableBorder lipgloss.Border

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

type Token string

type UnicodeLevel uint8

type Variant string