# `Color.DesignTokensDecodeError`

Raised (or returned) when a Design Tokens (DTCG 2025.10) token
cannot be decoded into a `Color.*` struct.

Has fields:

* `:reason` — short atom describing the failure (e.g.
  `:unknown_color_space`, `:missing_field`, `:bad_components`,
  `:bad_alpha`, `:bad_hex`, `:not_a_color_token`).

* `:detail` — human-readable context string.

---

*Consult [api-reference.md](api-reference.md) for complete listing*