theme

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

type Theme interface {
	// Backgrounds
	Base() lipgloss.Color       // App canvas background
	Surface() lipgloss.Color    // Pane interior background
	SurfaceAlt() lipgloss.Color // Overlay backgrounds (search, devices, help)

	// Borders
	ActiveBorder() lipgloss.Color   // Focused pane border
	InactiveBorder() lipgloss.Color // Unfocused pane borders

	// Text hierarchy
	TextPrimary() lipgloss.Color   // Main content — track names, body text
	TextSecondary() lipgloss.Color // Supporting — artist names, subtitles
	TextMuted() lipgloss.Color     // Dim — timestamps, counts, hints

	// Selection
	SelectedBg() lipgloss.Color // Selected list item background (retained for backward compat)
	// SelectedFg is the selection accent applied to item text (name + subtitle lines)
	// when a list item is focused. Used WITHOUT a background fill — must be visually
	// distinct from ColumnSecondary, ColumnTertiary, and TextPrimary in every theme.
	SelectedFg() lipgloss.Color

	// Semantic colours
	SectionHeader() lipgloss.Color    // Section labels: LIBRARY, QUEUE, NOW PLAYING
	PlayingIndicator() lipgloss.Color // playing symbol (GlyphPlaying role)
	SeekBar() lipgloss.Color          // Seek bar fill
	VolumeBar() lipgloss.Color        // Volume bar fill
	Success() lipgloss.Color          // Success states
	Warning() lipgloss.Color          // Caution notices
	Error() lipgloss.Color            // Error messages
	Info() lipgloss.Color             // Informational notices (info toasts)
	HeaderChipFg() lipgloss.Color     // header chip foreground (device chip, profile chip)

	// Status bar
	StatusBarBg() lipgloss.Color // Status bar background
	StatusBarFg() lipgloss.Color // Status bar body text
	KeyHint() lipgloss.Color     // Keybinding key labels (Space, Tab, etc.)

	// Gradient bars — seek bar fill stages and volume bands (Feature 44)
	Gradient1() lipgloss.Color // Seek bar start / low volume (cool)
	Gradient2() lipgloss.Color // Seek bar end / mid volume
	Gradient3() lipgloss.Color // High volume (hot)

	// Visualizer — braille-dot audio spectrum (Feature 44)
	VisualizerFg() lipgloss.Color // Braille dot foreground

	// Tables — dense column header text (Feature 43+)
	TableHeader() lipgloss.Color // Column header text

	// Status — preset label in the header bar
	PresetIndicator() lipgloss.Color // Preset label in header

	// Per-pane borders — distinct accent colour per pane, btop-style identity (Feature 42)
	PaneBorderNowPlaying() lipgloss.Color     // Green accent
	PaneBorderQueue() lipgloss.Color          // Yellow accent
	PaneBorderPlaylists() lipgloss.Color      // Blue accent
	PaneBorderAlbums() lipgloss.Color         // Cyan accent
	PaneBorderLikedSongs() lipgloss.Color     // Green accent
	PaneBorderRecentlyPlayed() lipgloss.Color // Teal accent
	PaneBorderTopTracks() lipgloss.Color      // Purple accent
	PaneBorderTopArtists() lipgloss.Color     // Pink/red accent
	PaneBorderRequestFlow() lipgloss.Color    // Orange/amber accent
	PaneBorderNetworkLog() lipgloss.Color     // Warm grey accent

	// Column colors — distinct foreground for each table column semantic (Feature 70)
	ColumnIndex() lipgloss.Color     // # column (muted but colorful)
	ColumnPrimary() lipgloss.Color   // Main data: track name, playlist name
	ColumnSecondary() lipgloss.Color // Supporting: artist, genre
	ColumnTertiary() lipgloss.Color  // Metadata: duration, year, played time

	// CLI accent — used by cliout palette resolution in "theme" mode (Story 146).
	// Optional in TOML; implementations fall back to SeekBar() when "accent" is unset.
	Accent() lipgloss.Color

	// Metadata
	ID() string   // Config key matching the TOML id field (e.g. "black", "dracula")
	Name() string // Display name: "True Black", "Monokai", etc.
}