abachrome 0.1.0 → 0.1.2

data/lib/abachrome/converters/oklch_to_lrgb.rb

@@ -1,14 +1,74 @@
-# frozen_string_literal: true
-
-require_relative "oklab_to_lrgb"
-require_relative "oklch_to_oklab"
+# Abachrome::Converters::OklchToLrgb - OKLCH to Linear RGB color space converter
+#
+# This converter transforms colors from the OKLCH color space to the linear RGB (LRGB) color space.
+# The conversion is performed by first transforming OKLCH's cylindrical coordinates (Lightness, Chroma, Hue)
+# into OKLAB's rectangular coordinates (L, a, b).
+# Then, these OKLAB coordinates are converted to LRGB. This second part involves transforming
+# OKLAB to an intermediate non-linear cone response space (L'M'S'), then to a linear
+# cone response space (LMS), and finally from LMS to LRGB using appropriate matrices.
+# All these steps are combined into a single direct conversion method.
+#
+# Key features:
+# - Direct conversion from OKLCH to LRGB.
+# - Combines cylindrical to rectangular conversion (OKLCH to OKLAB)
+#   with the OKLAB to LRGB transformation pipeline (OKLAB -> L'M'S' -> LMS -> LRGB).
+# - Uses AbcDecimal arithmetic for precise color science calculations.
+# - Maintains alpha channel transparency values during conversion.
+# - Validates input color space to ensure proper OKLCH source data.
 
 module Abachrome
   module Converters
     class OklchToLrgb < Abachrome::Converters::Base
       def self.convert(oklch_color)
-        oklab_color = OklchToOklab.convert(oklch_color)
-        OklabToLrgb.convert(oklab_color)
+        raise_unless oklch_color, :oklch
+
+        l_oklch, c_oklch, h_oklch = oklch_color.coordinates.map { |_| AbcDecimal(_) }
+        alpha = oklch_color.alpha
+
+        # Step 1: OKLCH to OKLAB
+        # l_oklab is the same as l_oklch
+        l_oklab = l_oklch
+
+        # Convert hue from degrees to radians
+        # h_oklch is AbcDecimal, Math::PI is Float. AD(Math::PI) makes it AbcDecimal.
+        # Division by AD("180") ensures AbcDecimal arithmetic.
+        h_rad = (h_oklch * AD(Math::PI)) / AD("180")
+
+        # Calculate a_oklab and b_oklab
+        # Math.cos/sin take a float; .value of AbcDecimal is BigDecimal.
+        # AD(Math.cos/sin(big_decimal_value)) wraps the result back to AbcDecimal.
+        a_oklab = c_oklch * AD(Math.cos(h_rad.value))
+        b_oklab = c_oklch * AD(Math.sin(h_rad.value))
+
+        # Step 2: OKLAB to L'M'S' (cone responses, non-linear)
+        # Constants from the inverse of M2 matrix (OKLAB to L'M'S')
+        # l_oklab, a_oklab, b_oklab are already AbcDecimal.
+        l_prime = l_oklab + (AD("0.39633779217376785678") * a_oklab) + (AD("0.21580375806075880339") * b_oklab)
+        m_prime = l_oklab - (AD("0.1055613423236563494") * a_oklab) - (AD("0.063854174771705903402") * b_oklab)
+        s_prime = l_oklab - (AD("0.089484182094965759684") * a_oklab) - (AD("1.2914855378640917399") * b_oklab)
+
+        # Step 3: L'M'S' to LMS (cubing to linearize cone responses)
+        l_lms = l_prime**3
+        m_lms = m_prime**3
+        s_lms = s_prime**3
+
+        # Step 4: LMS to LRGB
+        # Using matrix M_lrgb_from_lms (OKLAB specific)
+        r_lrgb = (l_lms * AD("4.07674166134799"))   + (m_lms * AD("-3.307711590408193")) + (s_lms * AD("0.230969928729428"))
+        g_lrgb = (l_lms * AD("-1.2684380040921763")) + (m_lms * AD("2.6097574006633715")) + (s_lms * AD("-0.3413193963102197"))
+        b_lrgb = (l_lms * AD("-0.004196086541837188"))+ (m_lms * AD("-0.7034186144594493")) + (s_lms * AD("1.7076147009309444"))
+
+        # Clamp LRGB values to be non-negative.
+        # LRGB values can be outside [0,1] but should be >= 0.
+        # Further clamping to [0,1] typically occurs when converting to display-referred spaces like sRGB.
+        zero_ad = AD("0")
+        output_coords = [
+          [r_lrgb, zero_ad].max,
+          [g_lrgb, zero_ad].max,
+          [b_lrgb, zero_ad].max
+        ]
+
+        Color.new(ColorSpace.find(:lrgb), output_coords, alpha)
       end
     end
   end

data/lib/abachrome/converters/oklch_to_oklab.rb

@@ -1,16 +1,41 @@
-# frozen_string_literal: true
+# Abachrome::Converters::OklchToOklab - OKLCH to OKLAB color space converter
+#
+# This converter transforms colors from the OKLCH color space to the OKLAB color space
+# using cylindrical to rectangular coordinate conversion. The transformation converts the
+# cylindrical coordinates (L, C, h) to rectangular coordinates (L, a, b) where lightness
+# remains unchanged, and the a and b components are calculated from chroma and hue using
+# trigonometric functions (cosine and sine respectively).
+#
+# Key features:
+# - Converts OKLCH cylindrical coordinates to OKLAB rectangular coordinates
+# - Preserves lightness component unchanged during conversion
+# - Calculates a component as chroma × cos(hue) for green-red axis positioning
+# - Calculates b component as chroma × sin(hue) for blue-yellow axis positioning
+# - Converts hue angle from degrees to radians for trigonometric calculations
+# - Maintains alpha channel transparency values during conversion
+# - Uses AbcDecimal arithmetic for precise color science calculations
+# - Validates input color space to ensure proper OKLCH source data
+#
+# The OKLAB color space provides the foundation for further conversions to other color
+# spaces and serves as an intermediate step in the color transformation pipeline when
+# working with OKLCH color manipulations that need to be converted to display-ready formats.
 
 module Abachrome
   module Converters
     class OklchToOklab < Abachrome::Converters::Base
+      # Converts a color from OKLCH color space to OKLAB color space.
+      # 
+      # @param oklch_color [Abachrome::Color] The color in OKLCH format to convert
+      # @return [Abachrome::Color] The converted color in OKLAB format
+      # @raise [StandardError] If the provided color is not in OKLCH color space
       def self.convert(oklch_color)
         raise_unless oklch_color, :oklch
 
         l, c, h = oklch_color.coordinates.map { |_| AbcDecimal(_) }
 
-        h_rad = h * Rational(Math::PI, 180)
-        a = c * Math.cos(h_rad.value)
-        b = c * Math.sin(h_rad.value)
+        h_rad = (h * Math::PI)/ AD(180)
+        a = c * AD(Math.cos(h_rad.value))
+        b = c * AD(Math.sin(h_rad.value))
 
         Color.new(
           ColorSpace.find(:oklab),

data/lib/abachrome/converters/oklch_to_srgb.rb

@@ -1,4 +1,22 @@
-# frozen_string_literal: true
+# Abachrome::Converters::OklchToSrgb - OKLCH to sRGB color space converter
+#
+# This converter transforms colors from the OKLCH color space to the standard RGB (sRGB) color space
+# through a two-step conversion process. The transformation first converts OKLCH cylindrical
+# coordinates to OKLAB rectangular coordinates, then applies the standard OKLAB to sRGB
+# transformation pipeline to produce the final gamma-corrected sRGB values.
+#
+# Key features:
+# - Two-stage conversion pipeline: OKLCH → OKLAB → sRGB
+# - Leverages existing OklchToOklab and OklabToSrgb converters for modular transformation
+# - Converts cylindrical coordinates (lightness, chroma, hue) to display-ready RGB values
+# - Maintains alpha channel transparency values during conversion
+# - Applies proper gamma correction for display on standard monitors and web applications
+# - Uses AbcDecimal arithmetic for precise color science calculations
+# - Validates input color space to ensure proper OKLCH source data
+#
+# The sRGB color space is the standard RGB color space for web content and most consumer
+# displays, providing gamma-corrected values that properly represent colors on typical
+# display devices while maintaining compatibility with web standards and digital media formats.
 
 require_relative "oklch_to_oklab"
 require_relative "oklab_to_srgb"
@@ -6,6 +24,12 @@ require_relative "oklab_to_srgb"
 module Abachrome
   module Converters
     class OklchToSrgb < Abachrome::Converters::Base
+      # Converts a color from OKLCH color space to sRGB color space.
+      # This is done by first converting from OKLCH to OKLAB,
+      # then from OKLAB to sRGB.
+      # 
+      # @param oklch_color [Abachrome::Color] Color in OKLCH color space
+      # @return [Abachrome::Color] The converted color in sRGB color space
       def self.convert(oklch_color)
         # Convert OKLCh to OKLab first
         oklab_color = OklchToOklab.convert(oklch_color)
@@ -15,4 +39,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/converters/oklch_to_xyz.rb

@@ -0,0 +1,66 @@
+module Abachrome
+  module Converters
+    class OklchToXyz < Abachrome::Converters::Base
+      def self.convert(oklch_color)
+        raise_unless oklch_color, :oklch
+
+        l_oklch, c_oklch, h_oklch = oklch_color.coordinates.map { |coord| AbcDecimal(coord) }
+        alpha = oklch_color.alpha
+
+        # Step 1: OKLCH to OKLAB
+        # (l_oklab, a_oklab, b_oklab)
+        l_oklab = l_oklch
+        # h_rad = (h_oklch * Math::PI) / AD(180) # h_oklch is AbcDecimal, Math::PI is Float. Coercion happens.
+        # More explicit for Math::PI:
+        h_rad = (h_oklch * AD(Math::PI.to_s)) / AD(180)
+
+        # Standard Math.cos/sin expect float. h_rad is AbcDecimal.
+        # .to_f is needed for conversion from AbcDecimal/BigDecimal to Float.
+        cos_h_rad = AD(Math.cos(h_rad.to_f))
+        sin_h_rad = AD(Math.sin(h_rad.to_f))
+
+        a_oklab = c_oklch * cos_h_rad
+        b_oklab = c_oklch * sin_h_rad
+
+        # Step 2: OKLAB to L'M'S' (cone responses, non-linear)
+        # (l_prime, m_prime, s_prime)
+        # These are the M_lms_prime_from_oklab matrix operations.
+        # The AbcDecimal() wrapper on the whole sum (as in OklabToLms.rb) is not strictly necessary
+        # if l_oklab, a_oklab, b_oklab are already AbcDecimal, as AbcDecimal ops return AbcDecimal.
+        l_prime = l_oklab + (AD("0.39633779217376785678") * a_oklab) + (AD("0.21580375806075880339") * b_oklab)
+        m_prime = l_oklab - (a_oklab * AD("-0.1055613423236563494")) + (b_oklab * AD("-0.063854174771705903402"))
+        s_prime = l_oklab - (a_oklab * AD("-0.089484182094965759684")) + (b_oklab * AD("-1.2914855378640917399"))
+
+        # Step 3: L'M'S' to LMS (cubing)
+        # (l_lms, m_lms, s_lms)
+        l_lms = l_prime**3
+        m_lms = m_prime**3
+        s_lms = s_prime**3
+
+        # Step 4: LMS to LRGB
+        # (r_lrgb, g_lrgb, b_lrgb)
+        # Using matrix M_lrgb_from_lms (OKLAB specific)
+        r_lrgb = (l_lms * AD("4.07674166134799"))   + (m_lms * AD("-3.307711590408193")) + (s_lms * AD("0.230969928729428"))
+        g_lrgb = (l_lms * AD("-1.2684380040921763")) + (m_lms * AD("2.6097574006633715")) + (s_lms * AD("-0.3413193963102197"))
+        b_lrgb = (l_lms * AD("-0.004196086541837188"))+ (m_lms * AD("-0.7034186144594493")) + (s_lms * AD("1.7076147009309444"))
+
+        # Clamp LRGB values to be non-negative (as done in LmsToLrgb.rb)
+        # Using the pattern [AbcDecimal, Integer].max which relies on AbcDecimal's <=> coercion.
+        # AD(0) is AbcDecimal zero.
+        zero_ad = AD(0)
+        r_lrgb_clamped = [r_lrgb, zero_ad].max
+        g_lrgb_clamped = [g_lrgb, zero_ad].max
+        b_lrgb_clamped = [b_lrgb, zero_ad].max
+        
+        # Step 5: LRGB to XYZ
+        # (x_xyz, y_xyz, z_xyz)
+        # Using matrix M_xyz_from_lrgb (sRGB D65)
+        x_xyz = (r_lrgb_clamped * AD("0.4124564")) + (g_lrgb_clamped * AD("0.3575761")) + (b_lrgb_clamped * AD("0.1804375"))
+        y_xyz = (r_lrgb_clamped * AD("0.2126729")) + (g_lrgb_clamped * AD("0.7151522")) + (b_lrgb_clamped * AD("0.0721750"))
+        z_xyz = (r_lrgb_clamped * AD("0.0193339")) + (g_lrgb_clamped * AD("0.1191920")) + (b_lrgb_clamped * AD("0.9503041"))
+
+        Color.new(ColorSpace.find(:xyz), [x_xyz, y_xyz, z_xyz], alpha)
+      end
+    end
+  end
+end

data/lib/abachrome/converters/srgb_to_lrgb.rb

@@ -1,8 +1,26 @@
-# frozen_string_literal: true
+# Abachrome::Converters::SrgbToLrgb - sRGB to Linear RGB color space converter
+#
+# This converter transforms colors from the standard RGB (sRGB) color space to the linear RGB (LRGB) color space by removing gamma correction. The conversion process applies the inverse sRGB transfer function which uses different formulas for small and large values to convert from the gamma-corrected sRGB representation to linear light intensity values.
+#
+# Key features:
+# - Implements the standard sRGB to linear RGB conversion algorithm with precise threshold handling
+# - Converts gamma-corrected sRGB values to linear RGB values for accurate color calculations
+# - Applies different transformation functions based on value magnitude (linear vs power function)
+# - Maintains alpha channel transparency values during conversion
+# - Uses AbcDecimal arithmetic for precise color science calculations
+# - Validates input color space to ensure proper sRGB source data
+#
+# The linear RGB color space provides a linear relationship between stored numeric values and actual light intensity, making it essential for accurate color calculations and serving as an intermediate color space for many color transformations, particularly when converting between different color models.
 
 module Abachrome
   module Converters
     class SrgbToLrgb
+      # Converts a color from sRGB color space to linear RGB color space.
+      # This method performs gamma correction by linearizing each sRGB coordinate.
+      # 
+      # @param srgb_color [Abachrome::Color] A color object in the sRGB color space
+      # @return [Abachrome::Color] A new color object in the linear RGB (LRGB) color space
+      # with the same alpha value as the input color
       def self.convert(srgb_color)
         r, g, b = srgb_color.coordinates.map { |c| to_linear(AbcDecimal(c)) }
 
@@ -13,6 +31,12 @@ module Abachrome
         )
       end
 
+      # Converts a sRGB component to its linear RGB equivalent.
+      # This conversion applies the appropriate gamma correction to transform an sRGB value
+      # into a linear RGB value.
+      # 
+      # @param v [AbcDecimal, Numeric] The sRGB component value to convert (typically in range 0-1)
+      # @return [AbcDecimal] The corresponding linear RGB component value
       def self.to_linear(v)
         v_abs = v.abs
         v_sign = v.negative? ? -1 : 1
@@ -24,4 +48,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/converters/srgb_to_oklab.rb

@@ -1,8 +1,34 @@
-# frozen_string_literal: true
+# Abachrome::Converters::SrgbToOklab - sRGB to OKLAB color space converter
+#
+# This converter transforms colors from the standard RGB (sRGB) color space to the OKLAB color space
+# through a two-step conversion process. The transformation first converts sRGB gamma-corrected
+# values to linear RGB as an intermediate step, then applies the standard OKLAB transformation
+# matrices to produce the final perceptually uniform OKLAB coordinates.
+#
+# Key features:
+# - Two-stage conversion pipeline: sRGB → Linear RGB → OKLAB
+# - Leverages existing SrgbToLrgb and LrgbToOklab converters for modular transformation
+# - Removes gamma correction and applies perceptual uniformity transformations
+# - Maintains alpha channel transparency values during conversion
+# - Uses AbcDecimal arithmetic for precise color science calculations
+# - Validates input color space to ensure proper sRGB source data
+#
+# The OKLAB color space provides better perceptual uniformity compared to traditional RGB spaces,
+# making it ideal for color manipulation operations like blending, lightness adjustments, and
+# gamut mapping where human visual perception accuracy is important. This converter enables
+# seamless transformation from display-ready sRGB values to the scientifically accurate OKLAB
+# representation for advanced color processing workflows.
 
 module Abachrome
   module Converters
     class SrgbToOklab
+      # Converts a color from sRGB color space to Oklab color space.
+      # The conversion happens in two steps:
+      # 1. sRGB is first converted to linear RGB
+      # 2. Linear RGB is then converted to Oklab
+      # 
+      # @param srgb_color [Abachrome::Color] The color in sRGB color space to convert
+      # @return [Abachrome::Color] The converted color in Oklab color space
       def self.convert(srgb_color)
         # First convert sRGB to linear RGB
         lrgb_color = SrgbToLrgb.convert(srgb_color)
@@ -12,4 +38,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/converters/srgb_to_oklch.rb

@@ -1,4 +1,22 @@
-# frozen_string_literal: true
+# Abachrome::Converters::SrgbToOklch - sRGB to OKLCH color space converter
+#
+# This converter transforms colors from the standard RGB (sRGB) color space to the OKLCH color space
+# through a two-step conversion process. The transformation first converts sRGB gamma-corrected
+# values to OKLAB rectangular coordinates as an intermediate step, then applies cylindrical coordinate
+# conversion to produce the final OKLCH values with lightness, chroma, and hue components.
+#
+# Key features:
+# - Two-stage conversion pipeline: sRGB → OKLAB → OKLCH
+# - Leverages existing SrgbToOklab and OklabToOklch converters for modular transformation
+# - Converts display-ready RGB values to perceptually uniform cylindrical coordinates
+# - Maintains alpha channel transparency values during conversion
+# - Uses AbcDecimal arithmetic for precise color science calculations
+# - Validates input color space to ensure proper sRGB source data
+#
+# The OKLCH color space provides an intuitive interface for color manipulation through its
+# cylindrical coordinate system, making it ideal for hue adjustments, saturation modifications,
+# and other color operations that benefit from polar coordinates while maintaining perceptual
+# uniformity for natural-looking color transformations.
 
 require_relative "srgb_to_oklab"
 require_relative "oklab_to_oklch"
@@ -6,6 +24,13 @@ require_relative "oklab_to_oklch"
 module Abachrome
   module Converters
     class SrgbToOklch < Abachrome::Converters::Base
+      # Converts an sRGB color to OKLCH color space
+      # 
+      # @param srgb_color [Abachrome::Color] The color in sRGB color space to convert
+      # @return [Abachrome::Color] The converted color in OKLCH color space
+      # @note This is a two-step conversion process: first from sRGB to OKLab, then from OKLab to OKLCH
+      # @see SrgbToOklab
+      # @see OklabToOklch
       def self.convert(srgb_color)
         # First convert sRGB to OKLab
         oklab_color = SrgbToOklab.convert(srgb_color)
@@ -15,4 +40,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/converters/xyz_to_lms.rb

@@ -0,0 +1,30 @@
+module Abachrome
+  module Converters
+    class XyzToLms < Abachrome::Converters::Base
+      # Converts a color from XYZ color space to LMS color space.
+      # 
+      # This method implements the XYZ to LMS transformation using the standard
+      # transformation matrix. The LMS color space represents the response of
+      # the three types of cone cells in the human eye (Long, Medium, Short),
+      # while XYZ is the CIE 1931 color space that forms the basis for most
+      # other color space definitions.
+      # 
+      # @param xyz_color [Abachrome::Color] The color in XYZ color space
+      # @raise [ArgumentError] If the input color is not in XYZ color space
+      # @return [Abachrome::Color] The resulting color in LMS color space with
+      # the same alpha as the input color
+      def self.convert(xyz_color)
+        raise_unless xyz_color, :xyz
+
+        x, y, z = xyz_color.coordinates.map { |_| AbcDecimal(_) }
+
+        # XYZ to LMS transformation matrix
+        l = (x * AD("0.8189330101")) + (y * AD("0.3618667424")) - (z * AD("0.1288597137"))
+        m = (x * AD("0.0329845436")) + (y * AD("0.9293118715")) + (z * AD("0.0361456387"))
+        s = (x * AD("0.0482003018")) + (y * AD("0.2643662691")) + (z * AD("0.6338517070"))
+
+        Color.new(ColorSpace.find(:lms), [l, m, s], xyz_color.alpha)
+      end
+    end
+  end
+end

data/lib/abachrome/converters/xyz_to_oklab.rb

@@ -0,0 +1,38 @@
+module Abachrome
+  module Converters
+    class XyzToOklab < Abachrome::Converters::Base
+      # Converts a color from XYZ color space to OKLAB color space.
+      # 
+      # This method implements the XYZ to OKLAB transformation by first
+      # converting XYZ coordinates to the intermediate LMS (Long, Medium, Short)
+      # color space, then applying the LMS to OKLAB transformation matrix.
+      # 
+      # @param xyz_color [Abachrome::Color] The color in XYZ color space
+      # @raise [ArgumentError] If the input color is not in XYZ color space
+      # @return [Abachrome::Color] The resulting color in OKLAB color space with
+      # the same alpha as the input color
+      def self.convert(xyz_color)
+        raise_unless xyz_color, :xyz
+
+        x, y, z = xyz_color.coordinates.map { |_| AbcDecimal(_) }
+
+        # XYZ to LMS transformation matrix
+        l = (x * AD("0.8189330101")) + (y * AD("0.3618667424")) - (z * AD("0.1288597137"))
+        m = (x * AD("0.0329845436")) + (y * AD("0.9293118715")) + (z * AD("0.0361456387"))
+        s = (x * AD("0.0482003018")) + (y * AD("0.2643662691")) + (z * AD("0.6338517070"))
+
+        # Apply cube root transformation
+        l_ = AbcDecimal(l)**Rational(1, 3)
+        m_ = AbcDecimal(m)**Rational(1, 3)
+        s_ = AbcDecimal(s)**Rational(1, 3)
+
+        # LMS to OKLAB transformation matrix
+        lightness = (AD("0.2104542553") * l_) + (AD("0.793617785") * m_) - (AD("0.0040720468") * s_)
+        a         = (AD("1.9779984951") * l_) - (AD("2.4285922050") * m_) + (AD("0.4505937099") * s_)
+        b         = (AD("0.0259040371") * l_) + (AD("0.7827717662") * m_) - (AD("0.8086757660") * s_)
+
+        Color.new(ColorSpace.find(:oklab), [lightness, a, b], xyz_color.alpha)
+      end
+    end
+  end
+end

data/lib/abachrome/gamut/base.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Gamut
@@ -69,4 +69,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/gamut/p3.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Gamut
@@ -22,4 +22,4 @@ module Abachrome
 
     register(P3.new)
   end
-end
+end

data/lib/abachrome/gamut/rec2020.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 lib
 abachrome
@@ -20,4 +20,4 @@ module Abachrome
 
     register(Rec2020.new)
   end
-end
+end

data/lib/abachrome/gamut/srgb.rb

@@ -1,4 +1,22 @@
-# frozen_string_literal: true
+# Abachrome::Gamut::SRGB - sRGB color gamut definition and validation
+#
+# This module defines the sRGB color gamut within the Abachrome color manipulation library.
+# The sRGB gamut represents the range of colors that can be displayed on standard monitors
+# and is the default color space for web content and most consumer displays. It uses the
+# D65 white point and specific primary color coordinates that define the boundaries of
+# reproducible colors in the sRGB color space.
+#
+# Key features:
+# - Defines sRGB primary color coordinates for red, green, and blue
+# - Uses D65 illuminant as the white point reference for proper color reproduction
+# - Provides gamut boundary validation to ensure colors fall within displayable ranges
+# - Implements color containment checking for RGB coordinate validation
+# - Automatically registers with the global gamut registry for system-wide access
+# - Serves as the foundation for sRGB color space conversions and display output
+#
+# The sRGB gamut is essential for ensuring colors are properly represented on standard
+# displays and provides the color boundary definitions needed for gamut mapping operations
+# when converting between different color spaces or preparing colors for web and print output.
 
 require_relative "base"
 
@@ -24,4 +42,4 @@ module Abachrome
 
     register(SRGB.new)
   end
-end
+end

data/lib/abachrome/illuminants/base.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Illuminants
@@ -30,4 +30,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/illuminants/d50.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Illuminants
@@ -28,4 +28,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/illuminants/d55.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Illuminants
@@ -24,4 +24,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/illuminants/d65.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Illuminants
@@ -32,4 +32,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/illuminants/d75.rb

@@ -1,4 +1,4 @@
-# frozen_string_literal: true
+#
 
 module Abachrome
   module Illuminants
@@ -24,4 +24,4 @@ module Abachrome
       end
     end
   end
-end
+end