theme

type ButtonOptions struct {
	Treatment ButtonTreatment
	Radius    ButtonRadius
}

type ButtonRadius int

type ButtonTreatment int

type ComponentOptions struct {
	Density Density
	Button  ButtonOptions
	Field   FieldOptions
}

type Density int

type FieldLayout int

type FieldOptions struct {
	Layout FieldLayout
	Radius FieldRadius
}

type FieldRadius int

type Option struct {
	// Key is the flattened Components key ("button.treatment"), the
	// exact string Flattened writes and OptionsFromFlattened switches
	// on; ThemeToTokens emits it under "component.".
	Key string
	// Members are the values the option's enum accepts, in declaration
	// order, derived from the enums' String methods.
	Members []string
	// Default is the value DefaultOptions carries for the key.
	Default string
}

type Overrides struct {
	// Color tokens (CSS hex values).
	Background, Surface, SurfaceSoft         string
	Border, BorderStrong                     string
	Text, TextMuted, TextSubtle              string
	Primary, PrimaryFg                       string
	Accent                                   string
	Success, Warning, Danger, DangerFg, Info string

	// Code-display surface tokens (ui.CodeBlock + demo source panels).
	// Intentionally a separate pair so dark mode reskins code blocks
	// independently of the page Text/Background pair.
	CodeSurface, CodeText, CodeBorder string

	// Dark is the dark-mode twin of the colour fields above: the same
	// typed fields, compiled into the theme's dark palette
	// (style.Theme.DarkColors) keyed by the CSS names the dark-scheme
	// blocks read. Light colour fields are not copied into dark mode
	// automatically because a contrast-safe dark value is usually
	// different; a light override with no dark twin logs a warning
	// naming the field.
	//
	// Dark changes colours only: setting Components, a font, a radius
	// or a nested Dark inside it panics when the theme is built. A
	// non-nil Dark with no colour set (Dark: &theme.Overrides{}) means
	// "the framework's dark palette is deliberate" and silences the
	// light-only warning.
	Dark *Overrides

	// Components are the typed component options (Density, the button
	// family's Treatment and Radius). Zero values mean "leave the
	// construction base unchanged" while overrides merge, exactly like
	// the string fields above; an explicit Comfortable, Filled or Round
	// resets an earlier override. The merged result is flattened into
	// style.Theme.Components complete, so every theme this package
	// produces declares a full option set.
	Components ComponentOptions

	// Font families.
	FontBody, FontHeading, FontMono string

	// Reskin extras: only apply if you really need them.
	RadiusSm, RadiusMd, RadiusLg int // px
}