abachrome 0.1.5 → 0.1.6

data/lib/abachrome/color_mixins/to_grayscale.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# Abachrome::ColorMixins::ToGrayscale - Grayscale conversion mixin
+#
+# This mixin provides methods for converting colors to grayscale using various
+# standard luma calculations. It supports both legacy Rec. 601 (SDTV) and modern
+# Rec. 709 (HDTV) coefficients for accurate grayscale conversion based on human
+# eye sensitivity.
+#
+# Key features:
+# - Rec. 601 luma: Y = 0.299R + 0.587G + 0.114B (NTSC/SDTV standard)
+# - Rec. 709 luma: Y = 0.2126R + 0.7152G + 0.0722B (HDTV standard)
+# - Maintains alpha channel during conversion
+# - Uses BigDecimal for precise calculations
+#
+# This is essential for image processing, accessibility checks, and any application
+# that needs perceptually accurate grayscale conversion rather than simple averaging.
+
+module Abachrome
+  module ColorMixins
+    module ToGrayscale
+      # Converts the color to grayscale using Rec. 601 luma coefficients (legacy NTSC standard).
+      # This is the same calculation used in the YIQ color space's Y component.
+      #
+      # @return [Abachrome::Color] A grayscale version of the color in sRGB space
+      def to_grayscale_601
+        rgb_color = to_srgb
+        r, g, b = rgb_color.coordinates
+
+        # Rec. 601 luma: Y = 0.299R + 0.587G + 0.114B
+        luma = (AD("0.299") * r) + (AD("0.587") * g) + (AD("0.114") * b)
+
+        Color.from_rgb(luma, luma, luma, alpha)
+      end
+
+      # Converts the color to grayscale using Rec. 709 luma coefficients (HDTV standard).
+      #
+      # @return [Abachrome::Color] A grayscale version of the color in sRGB space
+      def to_grayscale_709
+        rgb_color = to_srgb
+        r, g, b = rgb_color.coordinates
+
+        # Rec. 709 luma: Y = 0.2126R + 0.7152G + 0.0722B
+        luma = (AD("0.2126") * r) + (AD("0.7152") * g) + (AD("0.0722") * b)
+
+        Color.from_rgb(luma, luma, luma, alpha)
+      end
+
+      # Converts the color to grayscale using the default Rec. 601 standard.
+      # This is an alias for to_grayscale_601 and matches the legacy behavior
+      # expected by most image processing applications.
+      #
+      # @return [Abachrome::Color] A grayscale version of the color in sRGB space
+      def to_grayscale
+        to_grayscale_601
+      end
+
+      # Calculates the relative luminance (luma) value using Rec. 601 coefficients.
+      # This returns just the Y component without creating a new color.
+      #
+      # @return [AbcDecimal] The luma value in range [0, 1]
+      def luma_601
+        rgb_color = to_srgb
+        r, g, b = rgb_color.coordinates
+        (AD("0.299") * r) + (AD("0.587") * g) + (AD("0.114") * b)
+      end
+
+      # Calculates the relative luminance (luma) value using Rec. 709 coefficients.
+      # This returns just the Y component without creating a new color.
+      #
+      # @return [AbcDecimal] The luma value in range [0, 1]
+      def luma_709
+        rgb_color = to_srgb
+        r, g, b = rgb_color.coordinates
+        (AD("0.2126") * r) + (AD("0.7152") * g) + (AD("0.0722") * b)
+      end
+
+      # Calculates the relative luminance using the default Rec. 601 standard.
+      # Alias for luma_601.
+      #
+      # @return [AbcDecimal] The luma value in range [0, 1]
+      def luma
+        luma_601
+      end
+    end
+  end
+end

data/lib/abachrome/color_mixins/to_lrgb.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorMixins::ToLrgb - Linear RGB color space conversion functionality
 #
 # This mixin provides methods for converting colors to the linear RGB (LRGB) color space,
@@ -28,7 +30,7 @@ module Abachrome
       # which uses a linear relationship between the stored numeric value and
       # the actual light intensity. If the color is already in the LRGB space,
       # it returns the current object without conversion.
-      # 
+      #
       # @return [Abachrome::Color] A new color object in the LRGB color space,
       # or the original object if already in LRGB space
       def to_lrgb
@@ -39,10 +41,10 @@ module Abachrome
 
       # Converts the current color to the linear RGB (LRGB) color space and updates
       # the receiver's state. If the color is already in LRGB space, this is a no-op.
-      # 
+      #
       # Unlike #to_lrgb which returns a new color instance, this method modifies the
       # current object by changing its color space and coordinates to the LRGB equivalent.
-      # 
+      #
       # @return [Abachrome::Color] the receiver itself, now in LRGB color space
       def to_lrgb!
         unless color_space.name == :lrgb
@@ -54,11 +56,11 @@ module Abachrome
       end
 
       # Returns the linear red component value of the color.
-      # 
+      #
       # This method accesses the first coordinate from the color in linear RGB space.
       # Linear RGB values differ from standard RGB by using a non-gamma-corrected
       # linear representation of luminance.
-      # 
+      #
       # @return [AbcDecimal] The linear red component value, typically in range [0, 1]
       def lred
         to_lrgb.coordinates[0]
@@ -68,7 +70,7 @@ module Abachrome
       # linear RGB color space first. Linear RGB uses a different scale than standard
       # sRGB, with values representing linear light energy rather than gamma-corrected
       # values.
-      # 
+      #
       # @return [AbcDecimal] The linear green component value from the color's linear
       # RGB representation
       def lgreen
@@ -76,17 +78,17 @@ module Abachrome
       end
 
       # Returns the linear blue channel value of this color after conversion to linear RGB color space.
-      # 
+      #
       # This method converts the current color to the linear RGB color space and extracts the blue
       # component (the third coordinate).
-      # 
+      #
       # @return [AbcDecimal] The linear blue component value, typically in the range [0, 1]
       def lblue
         to_lrgb.coordinates[2]
       end
 
       # Returns the coordinates of the color in the linear RGB color space.
-      # 
+      #
       # @return [Array<AbcDecimal>] An array of three AbcDecimal values representing
       # the red, green, and blue components in linear RGB color space.
       def lrgb_values
@@ -96,14 +98,14 @@ module Abachrome
       # Returns an array of sRGB values as integers in the 0-255 range.
       # This method converts the color to RGB, scales the values to the 0-255 range,
       # rounds to integers, and ensures they are clamped within the valid range.
-      # 
+      #
       # @return [Array<Integer>] An array of three RGB integer values between 0-255
       def rgb_array
         to_rgb.coordinates.map { |c| (c * 255).round.clamp(0, 255) }
       end
 
       # Returns a hexadecimal string representation of the color in RGB format.
-      # 
+      #
       # @return [String] A hexadecimal color code in the format '#RRGGBB' where RR, GG, and BB
       # are two-digit hexadecimal values for the red, green, and blue components respectively.
       # @example
@@ -116,4 +118,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_mixins/to_oklab.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorMixins::ToOklab - OKLAB color space conversion functionality
 #
 # This mixin provides methods for converting colors to the OKLAB color space, which is a
@@ -23,10 +25,10 @@ module Abachrome
   module ColorMixins
     module ToOklab
       # Converts the current color to the OKLAB color space.
-      # 
+      #
       # If the color is already in OKLAB, it returns the color unchanged.
       # Otherwise, it uses the Converter to transform the color to OKLAB.
-      # 
+      #
       # @return [Abachrome::Color] A new Color object in the OKLAB color space
       def to_oklab
         return self if color_space.name == :oklab
@@ -38,11 +40,11 @@ module Abachrome
       # This method transforms the current color into OKLAB space,
       # modifying the original object by updating its color space
       # and coordinates if not already in OKLAB.
-      # 
+      #
       # @example
       # color = Abachrome::Color.from_hex("#ff5500")
       # color.to_oklab!  # Color now uses OKLAB color space
-      # 
+      #
       # @return [Abachrome::Color] self, with updated color space and coordinates
       def to_oklab!
         unless color_space.name == :oklab
@@ -56,27 +58,27 @@ module Abachrome
       # Returns the lightness component (L) of the color in the OKLAB color space.
       # The lightness value ranges from 0 (black) to 1 (white) and represents
       # the perceived lightness of the color.
-      # 
+      #
       # @return [AbcDecimal] The lightness (L) value from the OKLAB color space
       def lightness
         to_oklab.coordinates[0]
       end
 
       # Returns the L (Lightness) component from the OKLAB color space.
-      # 
+      #
       # The L value represents perceptual lightness in the OKLAB color space,
       # typically ranging from 0 (black) to 1 (white).
-      # 
+      #
       # @return [AbcDecimal] The L (Lightness) component from the OKLAB color space
       def l
         to_oklab.coordinates[0]
       end
 
       # Returns the 'a' component from the OKLAB color space (green-red axis).
-      # 
+      #
       # The 'a' component in OKLAB represents the position on the green-red axis,
       # with negative values being more green and positive values being more red.
-      # 
+      #
       # @return [AbcDecimal] The 'a' component value from the OKLAB color space.
       # @see #to_oklab For the full conversion to OKLAB color space
       def a
@@ -84,25 +86,25 @@ module Abachrome
       end
 
       # Returns the B value of the color in OKLAB color space.
-      # 
+      #
       # This method first converts the color to OKLAB color space if needed,
       # then extracts the B component (blue-yellow axis), which is the third
       # coordinate in the OKLAB model.
-      # 
+      #
       # @return [AbcDecimal] The B component value in OKLAB color space
       def b
         to_oklab.coordinates[2]
       end
 
       # Returns the OKLAB color space coordinates for this color.
-      # 
+      #
       # @return [Array] An array of OKLAB coordinates [L, a, b] representing the color in OKLAB color space
       def oklab_values
         to_oklab.coordinates
       end
 
       # Returns an array representation of the color's coordinates in the OKLAB color space.
-      # 
+      #
       # @return [Array<AbcDecimal>] An array containing the coordinates of the color
       # in the OKLAB color space in the order [L, a, b]
       def oklab_array
@@ -112,4 +114,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_mixins/to_oklch.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorMixins::ToOklch - OKLCH color space conversion functionality
 #
 # This mixin provides methods for converting colors to the OKLCH color space, which is a
@@ -21,12 +23,12 @@ module Abachrome
   module ColorMixins
     module ToOklch
       # Converts the current color to the OKLCH color space.
-      # 
+      #
       # This method transforms the color into the perceptually uniform OKLCH color space.
       # If the color is already in OKLCH, it returns itself unchanged. If the color is in
       # OKLAB, it directly converts from OKLAB to OKLCH. For all other color spaces, it
       # first converts to OKLAB as an intermediate step, then converts to OKLCH.
-      # 
+      #
       # @return [Abachrome::Color] A new Color object in the OKLCH color space
       def to_oklch
         return self if color_space.name == :oklch
@@ -44,7 +46,7 @@ module Abachrome
       # This method transforms the current color to OKLCH color space, modifying
       # the original object instead of creating a new one. If the color is already
       # in OKLCH space, no conversion is performed.
-      # 
+      #
       # @return [Abachrome::Color] self, allowing for method chaining
       def to_oklch!
         unless color_space.name == :oklch
@@ -58,7 +60,7 @@ module Abachrome
       # Returns the lightness component of the color in the OKLCH color space.
       # This method provides direct access to the first coordinate of the OKLCH
       # representation of the color, which represents perceptual lightness.
-      # 
+      #
       # @return [AbcDecimal] the lightness value in the OKLCH color space,
       # typically in the range of 0.0 to 1.0, where 0.0 is black and 1.0 is white
       def lightness
@@ -67,14 +69,14 @@ module Abachrome
 
       # Returns the chroma value of the color by converting it to the OKLCH color space.
       # Chroma represents color intensity or saturation in the OKLCH color space.
-      # 
+      #
       # @return [AbcDecimal] The chroma value (second coordinate) from the OKLCH color space
       def chroma
         to_oklch.coordinates[1]
       end
 
       # Returns the hue value of the color in the OKLCH color space.
-      # 
+      #
       # @return [AbcDecimal] The hue component of the color in degrees (0-360)
       # from the OKLCH color space representation.
       def hue
@@ -82,7 +84,7 @@ module Abachrome
       end
 
       # Returns the OKLCH coordinates of the color.
-      # 
+      #
       # @return [Array<AbcDecimal>] Array of OKLCH coordinates [lightness, chroma, hue] where:
       # - lightness: perceptual lightness component (0-1)
       # - chroma: colorfulness/saturation component
@@ -92,11 +94,11 @@ module Abachrome
       end
 
       # Returns the OKLCH coordinates of the color as an array.
-      # 
+      #
       # Converts the current color to OKLCH color space and returns its coordinates
       # as an array. The OKLCH color space represents colors using Lightness,
       # Chroma, and Hue components in a perceptually uniform way.
-      # 
+      #
       # @return [Array<Numeric>] An array containing the OKLCH coordinates [lightness, chroma, hue]
       def oklch_array
         to_oklch.coordinates
@@ -105,4 +107,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_mixins/to_srgb.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorMixins::ToSrgb - sRGB color space conversion functionality
 #
 # This mixin provides methods for converting colors to the sRGB color space, which is the
@@ -23,11 +25,11 @@ module Abachrome
   module ColorMixins
     module ToSrgb
       # Converts the current color to the sRGB color space.
-      # 
+      #
       # If the color is already in the sRGB color space, returns the color instance
       # unchanged. Otherwise, performs a color space conversion from the current
       # color space to sRGB.
-      # 
+      #
       # @return [Abachrome::Color] A new Color instance in the sRGB color space,
       # or self if already in sRGB
       def to_srgb
@@ -37,7 +39,7 @@ module Abachrome
       end
 
       # Alias for #to_srgb method.
-      # 
+      #
       # @return [Abachrome::Color] The color converted to sRGB color space
       def to_rgb
         # assume they mean srgb
@@ -59,7 +61,7 @@ module Abachrome
       # Converts the current color to sRGB color space in place.
       # This is an alias for {#to_srgb!} as RGB commonly refers to sRGB
       # in web and design contexts.
-      # 
+      #
       # @return [self] Returns self after converting to sRGB
       def to_rgb!
         # assume they mean srgb
@@ -67,7 +69,7 @@ module Abachrome
       end
 
       # Returns the red component of the color in the sRGB color space.
-      # 
+      #
       # @return [AbcDecimal] The red component value in the sRGB color space,
       # normalized between 0 and 1.
       def red
@@ -75,27 +77,27 @@ module Abachrome
       end
 
       # Returns the green component of the color in sRGB space.
-      # 
+      #
       # This method converts the current color to sRGB color space if needed,
       # then extracts the green component (second coordinate).
-      # 
+      #
       # @return [AbcDecimal] The green component value in the sRGB color space, typically in the range 0-1
       def green
         to_srgb.coordinates[1]
       end
 
       # Returns the blue component of the color in sRGB color space.
-      # 
+      #
       # This method converts the current color to sRGB if needed and
       # extracts the third coordinate value (blue).
-      # 
+      #
       # @return [AbcDecimal] The blue component value in sRGB space, typically in range 0-1
       def blue
         to_srgb.coordinates[2]
       end
 
       # Returns the RGB color values in the sRGB color space.
-      # 
+      #
       # @return [Array<AbcDecimal>] An array of three AbcDecimal values representing
       # the red, green, and blue color components in the sRGB color space.
       def srgb_values
@@ -103,18 +105,18 @@ module Abachrome
       end
 
       # Returns the RGB values of the color as coordinates in the sRGB color space.
-      # 
+      #
       # @return [Array<Abachrome::AbcDecimal>] The RGB coordinates (red, green, blue) in sRGB color space
       def rgb_values
         to_srgb.coordinates
       end
 
       # Returns an array of RGB values (0-255) for this color.
-      # 
+      #
       # This method converts the color to sRGB, then scales the component values
       # from the 0-1 range to the 0-255 range commonly used in RGB color codes.
       # Values are rounded to the nearest integer and clamped between 0 and 255.
-      # 
+      #
       # @return [Array<Integer>] An array of three integers representing the [R, G, B]
       # values in the 0-255 range
       def rgb_array
@@ -123,7 +125,7 @@ module Abachrome
 
       # Returns a hexadecimal representation of this color in sRGB color space.
       # Converts the color to sRGB, then formats it as a hexadecimal string.
-      # 
+      #
       # @return [String] A string in the format "#RRGGBB" where RR, GG, and BB are
       # the hexadecimal representations of the red, green, and blue components,
       # each ranging from 00 to FF.
@@ -137,4 +139,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_models/cmyk.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+# Abachrome::ColorModels::CMYK - CMYK color space model utilities
+#
+# This module provides utility methods for the CMYK (Cyan, Magenta, Yellow, Key/Black)
+# color model within the Abachrome color manipulation library. CMYK represents colors
+# using the subtractive color synthesis model used in printing and physical media.
+#
+# Key features:
+# - Subtractive color model (ink on paper, not light)
+# - Four channels: Cyan, Magenta, Yellow, and Key (Black)
+# - Supports Undercolor Removal (UCR) for ink savings
+# - Supports Gray Component Replacement (GCR) for richer blacks
+# - High-precision BigDecimal arithmetic for exact ink percentages
+# - Essential for print media, PDF generation, and pre-press workflows
+#
+# The CMYK model is fundamental for professional printing, where the fourth channel
+# (Black/Key) is added to achieve crisp text and deep shadows that cannot be produced
+# by combining cyan, magenta, and yellow inks alone.
+
+require_relative "../abc_decimal"
+
+module Abachrome
+  module ColorModels
+    class CMYK
+      include Abachrome::ToAbcd
+
+      class << self
+        # Normalizes CMYK color component values to the [0,1] range.
+        #
+        # @param c [Numeric] Cyan component (0-1 or 0-100 for percentages)
+        # @param m [Numeric] Magenta component (0-1 or 0-100 for percentages)
+        # @param y [Numeric] Yellow component (0-1 or 0-100 for percentages)
+        # @param k [Numeric] Key/Black component (0-1 or 0-100 for percentages)
+        # @return [Array<AbcDecimal>] Array of four normalized components as AbcDecimal objects
+        def normalize(c, m, y, k)
+          [c, m, y, k].map do |value|
+            case value
+            when String
+              if value.end_with?("%")
+                AbcDecimal(value.chomp("%")) / AbcDecimal(100)
+              else
+                AbcDecimal(value)
+              end
+            when Numeric
+              if value > 1
+                AbcDecimal(value) / AbcDecimal(100)
+              else
+                AbcDecimal(value)
+              end
+            end
+          end
+        end
+
+        # Converts RGB values to CMYK using the standard naive conversion.
+        # This produces high ink coverage and is generally not recommended for production.
+        #
+        # @param r [Numeric] Red component (0-1)
+        # @param g [Numeric] Green component (0-1)
+        # @param b [Numeric] Blue component (0-1)
+        # @return [Array<AbcDecimal>] Array of [c, m, y, k] values
+        def from_rgb_naive(r, g, b)
+          r = AbcDecimal(r)
+          g = AbcDecimal(g)
+          b = AbcDecimal(b)
+
+          # Simple complementary conversion
+          c = AbcDecimal(1) - r
+          m = AbcDecimal(1) - g
+          y = AbcDecimal(1) - b
+          k = AbcDecimal(0)
+
+          [c, m, y, k]
+        end
+
+        # Converts RGB values to CMYK using Undercolor Removal (UCR).
+        # This extracts the gray component to the black (K) channel, reducing ink usage.
+        #
+        # @param r [Numeric] Red component (0-1)
+        # @param g [Numeric] Green component (0-1)
+        # @param b [Numeric] Blue component (0-1)
+        # @param gcr_amount [Numeric] Gray Component Replacement amount (0-1), default 1.0 for full UCR
+        # @return [Array<AbcDecimal>] Array of [c, m, y, k] values
+        def from_rgb_ucr(r, g, b, gcr_amount = 1.0)
+          r = AbcDecimal(r)
+          g = AbcDecimal(g)
+          b = AbcDecimal(b)
+          gcr = AbcDecimal(gcr_amount)
+
+          # Calculate complementary CMY values
+          c = AbcDecimal(1) - r
+          m = AbcDecimal(1) - g
+          y = AbcDecimal(1) - b
+
+          # Find the minimum (gray component)
+          k = [c, m, y].min * gcr
+
+          # Remove the gray component from CMY if k > 0
+          if k.positive?
+            c -= k
+            m -= k
+            y -= k
+          end
+
+          [c, m, y, k]
+        end
+
+        # Alias for from_rgb_ucr with full GCR (the standard approach).
+        # GCR is essentially the same as UCR but allows control over how much
+        # of the gray component to extract.
+        #
+        # @param r [Numeric] Red component (0-1)
+        # @param g [Numeric] Green component (0-1)
+        # @param b [Numeric] Blue component (0-1)
+        # @param amount [Numeric] Amount of GCR to apply (0-1), default 1.0
+        # @return [Array<AbcDecimal>] Array of [c, m, y, k] values
+        def from_rgb_gcr(r, g, b, amount = 1.0)
+          from_rgb_ucr(r, g, b, amount)
+        end
+
+        # Converts CMYK values back to RGB.
+        # This is a straightforward inverse of the naive RGB→CMY conversion
+        # plus the addition of the black channel.
+        #
+        # @param c [Numeric] Cyan component (0-1)
+        # @param m [Numeric] Magenta component (0-1)
+        # @param y [Numeric] Yellow component (0-1)
+        # @param k [Numeric] Key/Black component (0-1)
+        # @return [Array<AbcDecimal>] Array of [r, g, b] values
+        def to_rgb(c, m, y, k)
+          c = AbcDecimal(c)
+          m = AbcDecimal(m)
+          y = AbcDecimal(y)
+          k = AbcDecimal(k)
+
+          # Standard CMYK to RGB conversion
+          r = (AbcDecimal(1) - c) * (AbcDecimal(1) - k)
+          g = (AbcDecimal(1) - m) * (AbcDecimal(1) - k)
+          b = (AbcDecimal(1) - y) * (AbcDecimal(1) - k)
+
+          [r, g, b]
+        end
+
+        # Calculates the Total Area Coverage (TAC) for CMYK values.
+        # TAC is the sum of all four ink percentages and is critical in print workflows
+        # to prevent excessive ink that can cause smearing or paper damage.
+        #
+        # @param c [Numeric] Cyan component (0-1)
+        # @param m [Numeric] Magenta component (0-1)
+        # @param y [Numeric] Yellow component (0-1)
+        # @param k [Numeric] Key/Black component (0-1)
+        # @return [AbcDecimal] Total ink coverage as a decimal (0-4, often expressed as 0-400%)
+        def total_area_coverage(c, m, y, k)
+          AbcDecimal(c) + AbcDecimal(m) + AbcDecimal(y) + AbcDecimal(k)
+        end
+      end
+    end
+  end
+end

data/lib/abachrome/color_models/hsv.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorModels::HSV - HSV color space model definition
 #
 # This module defines the HSV (Hue, Saturation, Value) color model within the Abachrome
@@ -30,13 +32,13 @@ module Abachrome
 
       # Validates whether the coordinates are valid for the HSV color model.
       # Each component (hue, saturation, value) must be in the range [0, 1].
-      # 
+      #
       # @param coordinates [Array<Numeric>] An array of three values representing
       # hue (h), saturation (s), and value (v) in the range [0, 1]
       # @return [Boolean] true if all coordinates are within valid ranges, false otherwise
       def valid_coordinates?(coordinates)
         h, s, v = coordinates
-        h >= 0 && h <= 1.0 &&
+        h.between?(0, 1.0) &&
           s >= 0 && s <= 1.0 &&
           v >= 0 && v <= 1.0
       end
@@ -44,4 +46,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_models/lms.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorModels::Lms - LMS color space model definition
 #
 # This module defines the LMS color model within the Abachrome color manipulation library.
@@ -33,4 +35,4 @@ ColorSpace.register(
   []
 )
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_models/oklab.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorModels::Oklab - OKLAB color space model definition
 #
 # This module defines the OKLAB color model within the Abachrome color manipulation library.
@@ -32,4 +34,4 @@ ColorSpace.register(
   ["ok-lab"]
 )
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.