Struct Color 

pub struct Color {
    pub l: f64,
    pub c: f64,
    pub h: f64,
}

A color stored in OKLCH. All engine math happens in this space.

• l (lightness) in 0.0..=1.0. 0 is black, 1 is white.
• c (chroma) in 0.0..~0.4. 0 is achromatic; ~0.37 is a vivid sRGB-gamut red. Values above the gamut clip on emission.
• h (hue) in degrees 0.0..360.0. Undefined when chroma is 0, but we always store a value (typically 0) for Copy/PartialEq.

Fields

l: f64

Lightness in 0.0..=1.0. 0 is black, 1 is white. Perceptually uniform — equal steps in l look equally bright to the eye.

c: f64

Chroma in 0.0..~0.4. 0 is achromatic; ~0.37 is a vivid sRGB-gamut red. Values above the gamut clip on emission.

h: f64

Hue in degrees 0.0..360.0. Undefined when c is 0 but always stored (typically 0) so the struct remains Copy and PartialEq.

Implementations

impl Color

pub fn from_oklch(l: f64, c: f64, h: f64) -> Self

Construct directly from OKLCH components. Used by tests and by pipeline stages that compute coordinates rather than parse strings.

pub fn from_hex(hex: &str) -> Result<Self, ColorError>

Parse #rrggbb or #rgb. Never panics on bad input.

pub fn to_hex(&self) -> String

Emit a #rrggbb string. Converts to sRGB and clamps each channel into 0..=1 before quantizing — out-of-gamut OKLCH coordinates are projected by channel clamping, not by hue shift.

pub fn mix(&self, other: &Color, amount: f64) -> Color

Mix toward other by amount (0.0 = self, 1.0 = other).

Interpolation happens in OKLab — L, a, b each interpolate linearly — so the result tracks perceived color without the hue-wraparound traps of LCh-space mixing. This is the engine’s port of CSS color-mix() for the cases this engine needs.

pub fn lighten(&self, amount: f64) -> Color

Mix toward pure white by amount. Convenience wrapper used across the derivation rules (§5).

pub fn darken(&self, amount: f64) -> Color

Mix toward near-black (#111) by amount. Convenience wrapper for hover / active / dark-text derivations (§5). Near-black rather than pure black so the result keeps a hair of warmth instead of going dead-flat.

Trait Implementations

impl Clone for Color

fn clone(&self) -> Color

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Color

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Color

fn eq(&self, other: &Color) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Color

impl StructuralPartialEq for Color