// Hex colors
let coral: Hue = "#FF6B6B"
let dark = coral.darker(by: 0.2)

// WCAG accessibility
coral.meetsWCAG(.aa, against: .white)  // false
coral.bestTextColor()                   // .black

// Color theory
let (warm, cool) = coral.analogous
let palette = coral.triadic

# As an SPM dependency (recommended — manages versions and transitive deps)
lpm install @lpm.dev/swiftd.hue

# Source delivery (if you want to modify the code directly)
lpm add @lpm.dev/swiftd.hue

import Hue

// From hex string
let coral = Hue(hex: "#FF6B6B")
let blue = Hue(hex: "0000FF")      // # is optional
let short = Hue(hex: "#F00")       // 3-char shorthand
let alpha = Hue(hex: "#FF000080")  // 8-char with alpha

// From hex integer
let green = Hue(hex: 0x00FF00)

// From RGBA
let custom = Hue(red: 0.5, green: 0.3, blue: 0.8)

// From HSL
let pastel = Hue(hue: 210, saturation: 0.8, lightness: 0.85)

// String literal
let color: Hue = "#FF6B6B"

// Predefined
Hue.black, Hue.white, Hue.red, Hue.green, Hue.blue, Hue.clear

let base = Hue(hex: "#FF6B6B")

base.lighter(by: 0.2)      // increase lightness
base.darker(by: 0.2)       // decrease lightness
base.saturated(by: 0.3)    // more vivid
base.desaturated(by: 0.3)  // more muted
base.adjustHue(by: 90)     // rotate hue 90°
base.inverted()             // RGB complement
base.grayscale()            // fully desaturated

let pink = Hue.red.mixed(with: .white)             // 50/50
let mostlyRed = Hue.red.mixed(with: .blue, amount: 0.2)  // 80% red, 20% blue

let base = Hue(hex: "#FF6B6B")

base.complementary                // 180° opposite
let (warm, cool) = base.analogous // ±30°
let (b, c) = base.triadic        // ±120°
let (l, r) = base.splitComplementary  // 150° and 210°
let (q2, q3, q4) = base.tetradic     // 90°, 180°, 270°

let text = Hue(hex: "#333333")
let bg = Hue.white

// Contrast ratio (1:1 to 21:1)
text.contrastRatio(with: bg)  // ≈ 12.63

// WCAG compliance
text.meetsWCAG(.aa, against: bg)                // true (≥ 4.5:1)
text.meetsWCAG(.aaa, against: bg)               // true (≥ 7:1)
text.meetsWCAG(.aa, size: .large, against: bg)  // true (≥ 3:1)

// Light/dark detection
bg.isLight  // true
text.isDark // true

// Best text color for a background
bg.bestTextColor()  // .black (highest contrast)
bg.bestTextColor(from: [Hue(hex: "#333"), Hue(hex: "#CCC")])

let color = Hue(hex: "#FF6B6B")

color.hue         // 0.0 (degrees, 0–360)
color.saturation  // 1.0 (0.0–1.0)
color.lightness   // 0.71 (0.0–1.0)

// Full HSLA tuple
let (h, s, l, a) = color.hsla

let color = Hue(hex: "#FF6B6B")

// Individual components
color.red    // 1.0
color.green  // 0.42
color.blue   // 0.42
color.alpha  // 1.0

// RGBA tuple
let (r, g, b, a) = color.rgba

// New color with modified component
color.withAlpha(0.5)
color.withRed(0.8)

// CGColor (always available)
layer.borderColor = Hue(hex: "#FF6B6B").cgColor
let hue = Hue(cgColor: someCGColor)

// UIColor (iOS, tvOS, watchOS, Mac Catalyst)
view.backgroundColor = Hue(hex: "#FF6B6B").uiColor
let hue = Hue(uiColor: .systemBlue)

// NSColor (macOS)
textField.textColor = Hue(hex: "#333333").nsColor
let hue = Hue(nsColor: .controlAccentColor)

// Hue → SwiftUI Color
Text("Hello")
    .foregroundColor(Hue(hex: "#FF6B6B").color)

// Convenience Color(hex:) extension
Text("World")
    .foregroundColor(Color(hex: "#FF6B6B"))

// Direct Color init
let hue = Hue(hex: "#FF6B6B")
Text("!").foregroundColor(Color(hue))

// Encode/decode colors in JSON
struct Theme: Codable {
    let primary: Hue
    let secondary: Hue
}

// Use as dictionary keys or in sets
var colorSet = Set<Hue>()
colorSet.insert(Hue(hex: "#FF6B6B"))

Hue.red.toHex()                    // "#FF0000"
Hue.red.toHex(includeAlpha: true)  // "#FF0000FF"
Hue(hex: "#FF6B6B").description    // "Hue(#FF6B6B)"