abachrome 0.1.5 → 0.1.6

data/lib/abachrome/palette.rb

@@ -1,4 +1,4 @@
-#
+# frozen_string_literal: true
 
 module Abachrome
   class Palette
@@ -6,7 +6,7 @@ module Abachrome
 
     # Initializes a new color palette with the given colors.
     # Automatically converts non-Color objects to Color objects by parsing them as hex values.
-    # 
+    #
     # @param colors [Array] An array of colors to include in the palette. Each element can be
     # either a Color object or a string-convertible object representing a hex color code.
     # @return [Abachrome::Palette] A new palette instance containing the provided colors.
@@ -17,7 +17,7 @@ module Abachrome
     # Adds a color to the palette.
     # Accepts either an Abachrome::Color object or any object that can be
     # converted to a string and parsed as a hex color code.
-    # 
+    #
     # @param color [Abachrome::Color, String, #to_s] The color to add to the palette.
     # If not already an Abachrome::Color object, it will be converted using Color.from_hex
     # @return [Abachrome::Palette] self, enabling method chaining
@@ -30,7 +30,7 @@ module Abachrome
     alias << add
 
     # Removes the specified color from the palette.
-    # 
+    #
     # @param color [Abachrome::Color, Object] The color to be removed from the palette
     # @return [Abachrome::Palette] Returns self for method chaining
     def remove(color)
@@ -39,10 +39,10 @@ module Abachrome
     end
 
     # Clears all colors from the palette.
-    # 
+    #
     # This method removes all stored colors in the palette. It provides a way to
     # reset the palette to an empty state while maintaining the same palette object.
-    # 
+    #
     # @return [Abachrome::Palette] Returns self for method chaining
     def clear
       @colors.clear
@@ -50,21 +50,21 @@ module Abachrome
     end
 
     # Returns the number of colors in the palette.
-    # 
+    #
     # @return [Integer] the number of colors in the palette
     def size
       @colors.size
     end
 
     # Returns whether the palette has no colors.
-    # 
+    #
     # @return [Boolean] true if the palette contains no colors, false otherwise
     def empty?
       @colors.empty?
     end
 
     # Yields each color in the palette to the given block.
-    # 
+    #
     # @param block [Proc] The block to be executed for each color in the palette.
     # @yield [Abachrome::Color] Each color in the palette.
     # @return [Enumerator] Returns an Enumerator if no block is given.
@@ -72,11 +72,12 @@ module Abachrome
     def each(&block)
       @colors.each(&block)
     end
+
     # Calls the given block once for each color in the palette, passing the color and its index as parameters.
-    # 
+    #
     # @example
     # palette.each_with_index { |color, index| puts "Color #{index}: #{color}" }
-    # 
+    #
     # @param block [Proc] The block to be called for each color
     # @yield [color, index] Yields a color and its index
     # @yieldparam color [Abachrome::Color] The color at the current position
@@ -88,7 +89,7 @@ module Abachrome
     end
 
     # Maps the palette by applying a block to each color.
-    # 
+    #
     # @param block [Proc] A block that takes a color and returns a new color.
     # @return [Abachrome::Palette] A new palette with the mapped colors.
     # @example
@@ -99,14 +100,14 @@ module Abachrome
     end
 
     # Returns a duplicate of the internal colors array.
-    # 
+    #
     # @return [Array<Abachrome::Color>] A duplicate of the palette's color array
     def to_a
       @colors.dup
     end
 
     # Access a color in the palette at the specified index.
-    # 
+    #
     # @param index [Integer] The index of the color to retrieve from the palette
     # @return [Abachrome::Color, nil] The color at the specified index, or nil if the index is out of bounds
     def [](index)
@@ -114,7 +115,7 @@ module Abachrome
     end
 
     # Slices the palette to create a new palette with a subset of colors.
-    # 
+    #
     # @param start [Integer] The starting index (or range) from which to start the slice.
     # @param length [Integer, nil] The number of colors to include in the slice. If nil and start is an Integer,
     # returns a new palette containing the single color at that index. If start is a Range, length is ignored.
@@ -125,14 +126,14 @@ module Abachrome
     end
 
     # Returns the first color in the palette.
-    # 
+    #
     # @return [Abachrome::Color, nil] The first color in the palette, or nil if the palette is empty.
     def first
       @colors.first
     end
 
     # Returns the last color in the palette.
-    # 
+    #
     # @return [Abachrome::Color, nil] The last color in the palette or nil if palette is empty.
     def last
       @colors.last
@@ -141,7 +142,7 @@ module Abachrome
     # Returns a new palette with colors sorted by lightness.
     # This method creates a new palette instance containing the same colors as the current
     # palette but sorted in ascending order based on their lightness values.
-    # 
+    #
     # @return [Abachrome::Palette] a new palette with the same colors sorted by lightness
     def sort_by_lightness
       self.class.new(@colors.sort_by(&:lightness))
@@ -150,7 +151,7 @@ module Abachrome
     # Returns a new palette with colors sorted by saturation from lowest to highest.
     # Saturation is determined by the second coordinate (a*) in the OKLAB color space.
     # Lower values represent less saturated colors, higher values represent more saturated colors.
-    # 
+    #
     # @return [Abachrome::Palette] A new palette instance with the same colors sorted by saturation
     def sort_by_saturation
       self.class.new(@colors.sort_by { |c| c.to_oklab.coordinates[1] })
@@ -160,7 +161,7 @@ module Abachrome
     # This method takes each color in the palette and blends it with the accumulated result
     # of previous blends. It starts with the first color and progressively blends each subsequent
     # color at the specified blend amount.
-    # 
+    #
     # @param amount [Float] The blend amount to use between each color pair, between 0.0 and 1.0.
     # Defaults to 0.5 (equal blend).
     # @return [Abachrome::Color, nil] The final blended color result, or nil if the palette is empty.
@@ -178,7 +179,7 @@ module Abachrome
     # This method converts each color in the palette to OKLAB coordinates,
     # calculates the arithmetic mean of these coordinates, and creates a new
     # color from the average values. Alpha values are also averaged.
-    # 
+    #
     # @return [Abachrome::Color, nil] The average color of all colors in the palette,
     # or nil if the palette is empty
     def average
@@ -198,9 +199,9 @@ module Abachrome
     end
 
     # Converts the colors in the palette to CSS-formatted strings.
-    # 
+    #
     # The format of the output can be specified with the format parameter.
-    # 
+    #
     # @param format [Symbol] The format to use for the CSS color strings.
     # :hex - Outputs colors in hexadecimal format (e.g., "#RRGGBB")
     # :rgb - Outputs colors in rgb() function format
@@ -223,7 +224,7 @@ module Abachrome
     end
 
     # Returns a string representation of the palette for inspection purposes.
-    # 
+    #
     # @return [String] A string containing the class name and a list of colors in the palette
     def inspect
       "#<#{self.class} colors=#{@colors.map(&:to_s)}>"
@@ -240,4 +241,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/palette_mixins/interpolate.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::PaletteMixins::Interpolate - Color palette interpolation functionality
 #
 # This mixin provides methods for interpolating between adjacent colors in a palette to create
@@ -48,4 +50,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/palette_mixins/resample.rb

@@ -1,4 +1,4 @@
-#
+# frozen_string_literal: true
 
 module Abachrome
   module PaletteMixins
@@ -58,4 +58,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/palette_mixins/stretch_luminance.rb

@@ -1,4 +1,4 @@
-#
+# frozen_string_literal: true
 
 module Abachrome
   module PaletteMixins
@@ -69,4 +69,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/parsers/css.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 #
 # Abachrome::Parsers::CSS - CSS color format parser
 #
@@ -36,8 +38,6 @@ module Abachrome
         parse_functional_color(input)
       end
 
-      private
-
       def self.parse_named_color(input)
         # Check if input matches a named color
         rgb_values = Named::CSS.method(input.to_sym)&.call
@@ -53,27 +53,25 @@ module Abachrome
       def self.parse_functional_color(input)
         case input
         when /^rgb\((.+)\)$/
-          parse_rgb($1)
+          parse_rgb(::Regexp.last_match(1))
         when /^rgba\((.+)\)$/
-          parse_rgba($1)
+          parse_rgba(::Regexp.last_match(1))
         when /^hsl\((.+)\)$/
-          parse_hsl($1)
+          parse_hsl(::Regexp.last_match(1))
         when /^hsla\((.+)\)$/
-          parse_hsla($1)
+          parse_hsla(::Regexp.last_match(1))
         when /^hwb\((.+)\)$/
-          parse_hwb($1)
+          parse_hwb(::Regexp.last_match(1))
         when /^lab\((.+)\)$/
-          parse_lab($1)
+          parse_lab(::Regexp.last_match(1))
         when /^lch\((.+)\)$/
-          parse_lch($1)
+          parse_lch(::Regexp.last_match(1))
         when /^oklab\((.+)\)$/
-          parse_oklab($1)
+          parse_oklab(::Regexp.last_match(1))
         when /^oklch\((.+)\)$/
-          parse_oklch($1)
+          parse_oklch(::Regexp.last_match(1))
         when /^color\((.+)\)$/
-          parse_color_function($1)
-        else
-          nil
+          parse_color_function(::Regexp.last_match(1))
         end
       end
 
@@ -171,39 +169,43 @@ module Abachrome
         when "srgb"
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_rgb(r, g, b)
         when "srgb-linear"
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_lrgb(r, g, b)
         when "display-p3"
           # For now, approximate as sRGB
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_rgb(r, g, b)
         when "a98-rgb"
           # For now, approximate as sRGB
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_rgb(r, g, b)
         when "prophoto-rgb"
           # For now, approximate as sRGB
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_rgb(r, g, b)
         when "rec2020"
           # For now, approximate as sRGB
           values = parse_color_values(values_str, 3)
           return nil unless values
+
           r, g, b = values
           Color.from_rgb(r, g, b)
-        else
-          nil
         end
       end
 
@@ -224,15 +226,16 @@ module Abachrome
 
         parsed = []
         values.each_with_index do |v, i|
-          if i == 0 # Hue
-            val = parse_angle_value(v)
-            return nil unless val
-            parsed << val
-          else # Saturation, Lightness, Alpha
-            val = parse_percentage_or_number(v)
-            return nil unless val
-            parsed << val
-          end
+          val = if i.zero? # Hue
+                  parse_angle_value(v)
+
+                else # Saturation, Lightness, Alpha
+                  parse_percentage_or_number(v)
+
+                end
+          return nil unless val
+
+          parsed << val
         end
         parsed
       end
@@ -306,66 +309,78 @@ module Abachrome
       def self.parse_numeric_value(str)
         return nil unless str
 
-        if str.end_with?('%')
-          (str.chomp('%').to_f / 100.0)
+        if str.end_with?("%")
+          (str.chomp("%").to_f / 100.0)
         else
           str.to_f
         end
-      rescue
+      rescue StandardError
         nil
       end
 
       def self.parse_percentage_or_number(str)
         return nil unless str
 
-        if str.end_with?('%')
-          str.chomp('%').to_f / 100.0
+        if str.end_with?("%")
+          str.chomp("%").to_f / 100.0
         else
           str.to_f
         end
-      rescue
+      rescue StandardError
         nil
       end
 
       def self.parse_angle_value(str)
         return nil unless str
 
-        if str.end_with?('deg')
-          str.chomp('deg').to_f
-        elsif str.end_with?('rad')
-          str.chomp('rad').to_f * 180.0 / Math::PI
-        elsif str.end_with?('grad')
-          str.chomp('grad').to_f * 0.9
-        elsif str.end_with?('turn')
-          str.chomp('turn').to_f * 360.0
+        if str.end_with?("deg")
+          str.chomp("deg").to_f
+        elsif str.end_with?("rad")
+          str.chomp("rad").to_f * 180.0 / Math::PI
+        elsif str.end_with?("grad")
+          str.chomp("grad").to_f * 0.9
+        elsif str.end_with?("turn")
+          str.chomp("turn").to_f * 360.0
         else
           str.to_f # Assume degrees
         end
-      rescue
+      rescue StandardError
         nil
       end
 
       # Color space conversion functions
 
       def self.hsl_to_rgb(h, s, l)
-        h = h / 360.0 # Normalize hue to 0-1
-
-        c = (1 - (2 * l - 1).abs) * s
-        x = c * (1 - ((h * 6) % 2 - 1).abs)
-        m = l - c / 2
-
-        if h < 1.0/6
-          r, g, b = c, x, 0
-        elsif h < 2.0/6
-          r, g, b = x, c, 0
-        elsif h < 3.0/6
-          r, g, b = 0, c, x
-        elsif h < 4.0/6
-          r, g, b = 0, x, c
-        elsif h < 5.0/6
-          r, g, b = x, 0, c
+        h /= 360.0 # Normalize hue to 0-1
+
+        c = (1 - ((2 * l) - 1).abs) * s
+        x = c * (1 - (((h * 6) % 2) - 1).abs)
+        m = l - (c / 2)
+
+        if h < 1.0 / 6
+          r = c
+          g = x
+          b = 0
+        elsif h < 2.0 / 6
+          r = x
+          g = c
+          b = 0
+        elsif h < 3.0 / 6
+          r = 0
+          g = c
+          b = x
+        elsif h < 4.0 / 6
+          r = 0
+          g = x
+          b = c
+        elsif h < 5.0 / 6
+          r = x
+          g = 0
+          b = c
         else
-          r, g, b = c, 0, x
+          r = c
+          g = 0
+          b = x
         end
 
         [r + m, g + m, b + m]
@@ -373,7 +388,7 @@ module Abachrome
 
       def self.hwb_to_rgb(h, w, b)
         # Normalize values
-        h = h / 360.0
+        h /= 360.0
 
         # Calculate RGB from HSL equivalent
         if w + b >= 1
@@ -384,9 +399,9 @@ module Abachrome
           r, g, b_rgb = rgb
 
           # Apply whiteness and blackness
-          r = r * (1 - w - b) + w
-          g = g * (1 - w - b) + w
-          b_rgb = b_rgb * (1 - w - b) + w
+          r = (r * (1 - w - b)) + w
+          g = (g * (1 - w - b)) + w
+          b_rgb = (b_rgb * (1 - w - b)) + w
 
           [r, g, b_rgb]
         end
@@ -395,12 +410,12 @@ module Abachrome
       def self.lab_to_xyz(l, a, b)
         # CIELAB to XYZ conversion (D65 white point)
         y = (l + 16) / 116
-        x = a / 500 + y
-        z = y - b / 200
+        x = (a / 500) + y
+        z = y - (b / 200)
 
-        x = x**3 > 0.008856 ? x**3 : (x - 16/116) / 7.787
-        y = y**3 > 0.008856 ? y**3 : (y - 16/116) / 7.787
-        z = z**3 > 0.008856 ? z**3 : (z - 16/116) / 7.787
+        x = x**3 > 0.008856 ? x**3 : (x - (16 / 116)) / 7.787
+        y = y**3 > 0.008856 ? y**3 : (y - (16 / 116)) / 7.787
+        z = z**3 > 0.008856 ? z**3 : (z - (16 / 116)) / 7.787
 
         # D65 white point
         x *= 0.95047
@@ -419,14 +434,14 @@ module Abachrome
 
       def self.xyz_to_rgb(x, y, z)
         # XYZ to linear RGB
-        r = x *  3.2406 + y * -1.5372 + z * -0.4986
-        g = x * -0.9689 + y *  1.8758 + z *  0.0415
-        b = x *  0.0557 + y * -0.2040 + z *  1.0570
+        r = (x * 3.2406) + (y * -1.5372) + (z * -0.4986)
+        g = (x * -0.9689) + (y * 1.8758) + (z *  0.0415)
+        b = (x * 0.0557) + (y * -0.2040) + (z *  1.0570)
 
         # Linear RGB to sRGB
         [r, g, b].map do |v|
           if v > 0.0031308
-            1.055 * (v ** (1/2.4)) - 0.055
+            (1.055 * (v**(1 / 2.4))) - 0.055
           else
             12.92 * v
           end
@@ -434,4 +449,4 @@ module Abachrome
       end
     end
   end
-end
+end

data/lib/abachrome/parsers/hex.rb

@@ -1,4 +1,4 @@
-#
+# frozen_string_literal: true
 
 module Abachrome
   module Parsers
@@ -49,4 +49,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/parsers/tailwind.rb

@@ -1,4 +1,4 @@
-#
+# frozen_string_literal: true
 
 module Abachrome
   module Parsers
@@ -7,7 +7,7 @@ module Abachrome
       # - gray-400
       # - blue-900/20 (with opacity)
       # - slate-50
-      TAILWIND_PATTERN = /^([a-z]+)-(\d+)(?:\/(\d+(?:\.\d+)?))?$/
+      TAILWIND_PATTERN = %r{^([a-z]+)-(\d+)(?:/(\d+(?:\.\d+)?))?$}
 
       def self.parse(input)
         match = input.match(TAILWIND_PATTERN)
@@ -29,12 +29,12 @@ module Abachrome
 
         # Calculate alpha from opacity percentage if provided
         alpha = if opacity
-          opacity_value = opacity.to_f
-          # Opacity in Tailwind is a percentage (0-100)
-          opacity_value / 100.0
-        else
-          1.0
-        end
+                  opacity_value = opacity.to_f
+                  # Opacity in Tailwind is a percentage (0-100)
+                  opacity_value / 100.0
+                else
+                  1.0
+                end
 
         Color.from_rgb(r, g, b, alpha)
       end