unmagic-color 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 385638e771dedbaff1485e3d8d45d18e632b4210b6d6d781916ef34358c09bd6
-  data.tar.gz: a34aa8373606265ada813caae4a495c006a9a71f3cfa8ec37c759ceb0e6f3818
+  metadata.gz: 276b2cc6192a6fea7e69f4893c9989434e8101c3e9c6a88b56996eeeeb910262
+  data.tar.gz: cd421ccce7640490b140a74a62640ee9dbbb6060f815d770b14ac12e4b1ff991
 SHA512:
-  metadata.gz: 1f484d35f71337bf9055569537a97337ea4cba6ddadf74774e73d93d6f1567a5b2934312e76635755fb6ca52aae1317ca9e47055d376e836f89d0ec8298af4d3
-  data.tar.gz: c99cd2ec04a304a7ef707449c21503238e6db4dee39ab31b6b73e731ab2e26e8a7d0bbf12b9a46d214f58cc354d00707bf40fd69ce0abab6e380f99205219de1
+  metadata.gz: 2da573372028a3d08793d01bcd9245a24fc88934085b081712934e4606a2d60ff03d8c8f6f94b06abb2fb6817e1b5b0acdf8ac2fd332e1d9f9b2923a90221d5c
+  data.tar.gz: 8a17575b7f89b7f9c29d613208972242bd851e42b25659a7533a4c6ed156ce14f9f9396148aa6e171ad5a8e0159395d8e9f9e28b881fa000bbdeb6492cc40388

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-01-05
+
+### Added
+- `to_hex` method for HSL colors (converts via RGB)
+- `to_hex` method for OKLCH colors (converts via RGB)
+
 ## [0.2.0] - 2026-01-05
 
 ### Added
@@ -75,5 +81,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - HSL color progressions for palette generation
 - Multiple hash functions for string-to-color derivation
 
+[0.2.1]: https://github.com/unreasonable-magic/unmagic-color/releases/tag/v0.2.1
 [0.2.0]: https://github.com/unreasonable-magic/unmagic-color/releases/tag/v0.2.0
 [0.1.0]: https://github.com/unreasonable-magic/unmagic-color/releases/tag/v0.1.0

data/README.md

@@ -159,31 +159,22 @@ Generate color palettes based on color theory relationships:
 color = Unmagic::Color.parse("#FF5733")
 
 # Complementary - opposite on the color wheel (180°)
-complement = color.complementary
-# => Single color opposite on the wheel
+color.complementary.to_hex # => "#33daff"
 
 # Analogous - adjacent colors (default ±30°)
-analogous = color.analogous
-# => [color at -30°, color at +30°]
-analogous = color.analogous(angle: 15)  # Custom angle
+color.analogous.map(&:to_hex) # => ["#ff3374", "#ffbe33"]
 
 # Triadic - three colors equally spaced (120° apart)
-triadic = color.triadic
-# => [color at +120°, color at +240°]
+color.triadic.map(&:to_hex) # => ["#33ff58", "#5833ff"]
 
 # Split Complementary - complement's neighbors (default 180° ±30°)
-split = color.split_complementary
-# => [color at 150°, color at 210°]
-split = color.split_complementary(angle: 45)  # Custom split
+color.split_complementary.map(&:to_hex) # => ["#33ffbe", "#3374ff"]
 
 # Tetradic Square - four colors equally spaced (90° apart)
-tetradic = color.tetradic_square
-# => [color at +90°, color at +180°, color at +270°]
+color.tetradic_square.map(&:to_hex) # => ["#74ff33", "#33daff", "#be33ff"]
 
 # Tetradic Rectangle - two complementary pairs (default 60°)
-tetradic = color.tetradic_rectangle
-# => [color at +60°, color at +180°, color at +240°]
-tetradic = color.tetradic_rectangle(angle: 30)  # Custom angle
+color.tetradic_rectangle.map(&:to_hex) # => ["#daff33", "#33daff", "#5833ff"]
 ```
 
 ### Color Variations
@@ -196,8 +187,7 @@ Generate shades, tints, tones, and monochromatic palettes:
 color = Unmagic::Color.parse("#3366CC")
 
 # Monochromatic - same hue with varying lightness
-mono = color.monochromatic(steps: 5)
-# => Array of 5 colors from dark to light
+color.monochromatic(steps: 5).map(&:to_hex) # => ["#0f1f3d", "#214285", "#3366cc", "#7a9cde", "#c2d1f0"]
 
 # Shades - progressively darker (mixed with black)
 shades = color.shades(steps: 5)
@@ -216,11 +206,11 @@ All harmony and variation methods preserve the original color space:
 
 ```ruby
 hsl = Unmagic::Color::HSL.new(hue: 200, saturation: 80, lightness: 50)
-hsl.complementary        # => HSL color
-hsl.shades(steps: 3)     # => Array of HSL colors
+hsl.complementary.to_hex        # => "#e65e19"
+hsl.shades(steps: 3).map(&:to_hex) # => ["#1587bf", "#116c99", "#0d5173"]
 
 rgb = Unmagic::Color.parse("#FF5733")
-rgb.analogous            # => Array of RGB colors
+rgb.analogous.map(&:to_hex)     # => ["#ff3374", "#ffbe33"]
 ```
 
 ### HSL-Specific Features
@@ -234,11 +224,8 @@ muted = hsl.desaturate(0.3)
 shifted = hsl.adjust_hue(30)
 
 # Create color progressions
-palette = hsl.progression(
-  steps: 5,
-  lightness: [30, 50, 70, 85, 95]
-)
-# => Array of 5 HSL colors with varying lightness
+hsl.progression(steps: 5, lightness: [30, 50, 70, 85, 95]).map(&:to_hex)
+# => ["#175e82", "#269dd9", "#7dc4e8", "#bee2f4", "#e9f5fb"]
 ```
 
 ### Generating Colors from Strings

data/lib/unmagic/color/console/help.rb

@@ -14,7 +14,7 @@ module Unmagic
         #
         # @return [String] The formatted help text
         def render
-          link = highlighter.link("https://github.com/unmagic/unmagic-color")
+          link = highlighter.link("https://github.com/unreasonable-magic/unmagic-color")
 
           code = highlighter.highlight(<<~RUBY)
             # Parse colors

data/lib/unmagic/color/hsl.rb

@@ -291,6 +291,15 @@ module Unmagic
         to_rgb.to_oklch
       end
 
+      # Convert to hex string.
+      #
+      # Converts via RGB as an intermediate step.
+      #
+      # @return [String] The color as a hex string (e.g., "#ff5733")
+      def to_hex
+        to_rgb.to_hex
+      end
+
       # Calculate the relative luminance.
       #
       # Converts to RGB first, then calculates luminance.

data/lib/unmagic/color/oklch.rb

@@ -302,6 +302,15 @@ module Unmagic
         Unmagic::Color::RGB.new(red: r, green: g, blue: b, alpha: @alpha)
       end
 
+      # Convert to hex string.
+      #
+      # Converts via RGB as an intermediate step.
+      #
+      # @return [String] The color as a hex string (e.g., "#ff5733")
+      def to_hex
+        to_rgb.to_hex
+      end
+
       # Calculate the relative luminance.
       #
       # In OKLCH, the lightness value directly represents perceptual luminance,

data/lib/unmagic/color/version.rb

@@ -3,6 +3,6 @@
 module Unmagic
   class Color
     # Current version of the Unmagic::Color gem
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: unmagic-color
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Keith Pitt