palettes

type CSSFormat struct {
	// UseReferences determines whether semantic/component colors should
	// use var(--palette-*) references or resolved hex values.
	UseReferences bool

	// Prefix for raw color CSS variables (default: "palette")
	RawPrefix string

	// Prefix for semantic color CSS variables (default: "color")
	SemanticPrefix string

	// Prefix for component color CSS variables (default: none, use name directly)
	ComponentPrefix string

	// IncludeRaw includes raw color definitions
	IncludeRaw bool

	// IncludeSemantic includes semantic color definitions
	IncludeSemantic bool

	// IncludeComponents includes component color definitions
	IncludeComponents bool

	// Minify removes whitespace for smaller output
	Minify bool
}

type Color struct {
	R, G, B uint8
}

type ColorResolutionError struct {
	Color   string // Color name that failed to resolve
	Palette string // Palette name
	Message string // Human-readable error message
	Err     error  // Underlying error
}

type ContrastCheck struct {
	Foreground    string   `json:"foreground"`     // Foreground color name
	Background    string   `json:"background"`     // Background color name
	ForegroundHex string   `json:"foreground_hex"` // Resolved foreground hex
	BackgroundHex string   `json:"background_hex"` // Resolved background hex
	Ratio         float64  `json:"ratio"`          // Calculated contrast ratio
	Required      float64  `json:"required"`       // Minimum required ratio
	Level         string   `json:"level"`          // WCAG level: "AA", "AAA", "AA Large", "UI"
	Passed        bool     `json:"passed"`         // Whether the check passed
	PassedLevels  []string `json:"passed_levels"`  // All WCAG levels that pass
}

type ContrastCheckSpec struct {
	Foreground string  // Foreground color name (semantic or component)
	Background string  // Background color name (semantic or component)
	MinRatio   float64 // Minimum required ratio
	Level      string  // WCAG level description
}

type ContrastRequirement struct {
	NormalText float64 // Minimum for normal text
	LargeText  float64 // Minimum for large text (18pt+ or 14pt bold)
	UI         float64 // Minimum for UI components
}

type ContrastSummary struct {
	Palette      string          `json:"palette"`
	Total        int             `json:"total"`
	Passed       int             `json:"passed"`
	Failed       int             `json:"failed"`
	Skipped      int             `json:"skipped"` // Colors not found
	AllPassed    bool            `json:"all_passed"`
	FailedChecks []ContrastCheck `json:"failed_checks,omitempty"`
}

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

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

type LospecClientOption func(*LospecClient)

type LospecFetchError struct {
	URL        string
	StatusCode int
	Message    string
	Err        error
}

type Palette struct {
	// Metadata
	Name        string  `json:"name" toml:"name"`
	Variant     Variant `json:"variant" toml:"variant"`
	Author      string  `json:"author,omitempty" toml:"author,omitempty"`
	License     string  `json:"license,omitempty" toml:"license,omitempty"`
	Homepage    string  `json:"homepage,omitempty" toml:"homepage,omitempty"`
	Description string  `json:"description,omitempty" toml:"description,omitempty"`

	// Color definitions
	Colors     map[string]string `json:"colors" toml:"colors"`         // Raw colors (hex values)
	Semantic   map[string]string `json:"semantic" toml:"semantic"`     // Semantic mappings (references)
	Components map[string]string `json:"components" toml:"components"` // Component colors (references)

	// Source information (set after loading)
	Source     string `json:"-" toml:"-"` // "built-in", "user", "project"
	SourcePath string `json:"-" toml:"-"` // File path if loaded from file
	// contains filtered or unexported fields
}

type PaletteExport struct {
	Name        string            `json:"name"`
	Variant     string            `json:"variant"`
	Author      string            `json:"author,omitempty"`
	License     string            `json:"license,omitempty"`
	Homepage    string            `json:"homepage,omitempty"`
	Description string            `json:"description,omitempty"`
	Colors      map[string]string `json:"colors"`
	Semantic    map[string]string `json:"semantic"`
	Components  map[string]string `json:"components,omitempty"`
	Resolved    map[string]string `json:"resolved,omitempty"`
}

type PaletteInfo struct {
	Name        string  `json:"name"`
	Variant     Variant `json:"variant"`
	Description string  `json:"description,omitempty"`
	Author      string  `json:"author,omitempty"`
	Source      string  `json:"source"` // "built-in", "user", "project"
	Path        string  `json:"path,omitempty"`
}

type PaletteLoadError struct {
	Name    string // Palette name that failed to load
	Path    string // Path attempted (if applicable)
	Message string // Human-readable error message
	Err     error  // Underlying error
}

type PaletteVariants struct {
	// Light is the light variant palette name (empty if not found)
	Light string `json:"light"`
	// Dark is the dark variant palette name (empty if not found)
	Dark string `json:"dark"`
	// Base is the base palette name without variant suffix
	Base string `json:"base"`
}

type ValidationError struct {
	Field   string // Field that failed validation
	Message string // Human-readable error message
}

type Variant string

type WCAGLevel string