Optionally support serde.

CHANGELOG.md

@@ -18,6 +18,7 @@ This release has an [MSRV][] of 1.82.
 ### Added
 
 * Add `BLACK`, `WHITE`, and `TRANSPARENT` constants to the color types. ([#64][] by [@waywardmonkeys][])
+* The `serde` feature enables using `serde` with `AlphaColor`, `OpaqueColor`, `PremulColor`, and `Rgba8`. ([#61][] by [@waywardmonkeys][])
 
 ### Changed
 
@@ -31,6 +32,7 @@ This is the initial release.
 
 [@waywardmonkeys]: https://github.com/waywardmonkeys
 
+[#61]: https://github.com/linebender/color/pull/61
 [#64]: https://github.com/linebender/color/pull/64
 [#65]: https://github.com/linebender/color/pull/65
 

color/Cargo.toml

@@ -17,9 +17,10 @@ targets = []
 
 [features]
 default = ["std"]
-std = []
+std = ["serde?/std"]
 libm = ["dep:libm"]
 bytemuck = ["dep:bytemuck"]
+serde = ["dep:serde"]
 
 [dependencies]
 
@@ -32,5 +33,11 @@ default-features = false
 version = "0.2.11"
 optional = true
 
+[dependencies.serde]
+version = "1.0.215"
+optional = true
+default-features = false
+features = ["derive"]
+
 [lints]
 workspace = true

color/README.md

@@ -92,6 +92,8 @@ this trait for new color spaces.
 - `libm`: Use floating point implementations from [libm][].
 - `bytemuck`: Implement traits from `bytemuck` on [`AlphaColor`], [`OpaqueColor`],
   [`PremulColor`], and [`Rgba8`].
+- `serde`: Implement `serde::Deserialize` and `serde::Serialize` on [`AlphaColor`],
+  [`OpaqueColor`], [`PremulColor`], and [`Rgba8`].
 
 At least one of `std` and `libm` is required; `std` overrides `libm`.
 

color/src/color.rs

@@ -22,6 +22,7 @@ use crate::floatfuncs::FloatFuncs;
 /// for spline interpolation. For cylindrical color spaces, hue fixup should
 /// be applied before interpolation.
 #[derive(Clone, Copy, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 #[repr(transparent)]
 pub struct OpaqueColor<CS> {
     /// The components, which may be manipulated directly.
@@ -38,6 +39,7 @@ pub struct OpaqueColor<CS> {
 ///
 /// See [`OpaqueColor`] for a discussion of arithmetic traits and interpolation.
 #[derive(Clone, Copy, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 #[repr(transparent)]
 pub struct AlphaColor<CS> {
     /// The components, which may be manipulated directly.
@@ -60,6 +62,7 @@ pub struct AlphaColor<CS> {
 ///
 /// See [`OpaqueColor`] for a discussion of arithmetic traits and interpolation.
 #[derive(Clone, Copy, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 #[repr(transparent)]
 pub struct PremulColor<CS> {
     /// The components, which may be manipulated directly.

color/src/lib.rs

@@ -63,6 +63,8 @@
 //! - `libm`: Use floating point implementations from [libm][].
 //! - `bytemuck`: Implement traits from `bytemuck` on [`AlphaColor`], [`OpaqueColor`],
 //!   [`PremulColor`], and [`Rgba8`].
+//! - `serde`: Implement `serde::Deserialize` and `serde::Serialize` on [`AlphaColor`],
+//!   [`OpaqueColor`], [`PremulColor`], and [`Rgba8`].
 //!
 //! At least one of `std` and `libm` is required; `std` overrides `libm`.
 //!

color/src/rgba8.rs

@@ -9,6 +9,7 @@ use crate::{AlphaColor, Srgb};
 /// it is efficient and convenient, even if limited in accuracy and
 /// gamut.
 #[derive(Clone, Copy, PartialEq, Eq, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 #[repr(C)]
 pub struct Rgba8 {
     /// Red component.