unmagic-color 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 385638e771dedbaff1485e3d8d45d18e632b4210b6d6d781916ef34358c09bd6
-  data.tar.gz: a34aa8373606265ada813caae4a495c006a9a71f3cfa8ec37c759ceb0e6f3818
+  metadata.gz: 971c6c19affe985327415a3993e1b47b739a972a51617a39c92be5c4a1af2f2e
+  data.tar.gz: a44de67386e8360347f526b97fc14e925178c475cd93c46fbd831444fd4bc776
 SHA512:
-  metadata.gz: 1f484d35f71337bf9055569537a97337ea4cba6ddadf74774e73d93d6f1567a5b2934312e76635755fb6ca52aae1317ca9e47055d376e836f89d0ec8298af4d3
-  data.tar.gz: c99cd2ec04a304a7ef707449c21503238e6db4dee39ab31b6b73e731ab2e26e8a7d0bbf12b9a46d214f58cc354d00707bf40fd69ce0abab6e380f99205219de1
+  metadata.gz: 1c24ada886792f4443852806fbe7fbae4a491d7428f83eb61e830ce7b768daf7a0b4d46ec615bd8e4f88b797501baedeafd9b6ada46fc6767d4dc3922e481ebb
+  data.tar.gz: fa0b066a29064c5d0db5db70a60489a2201eb5970860865b86b5927eb9f2f64a96e258dcfb85aecf37a0d8e1afda94e702a174e3310fb51408f41500bcad326e

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-01-05
+
+### Added
+- `Gradient::Bitmap#to_ansi` method to render gradients as colored blocks in terminal
+
+## [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 +86,7 @@ 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.2]: https://github.com/unreasonable-magic/unmagic-color/releases/tag/v0.2.2
+[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

@@ -4,6 +4,8 @@
 
 A comprehensive Ruby color manipulation library with support for RGB, HSL, and OKLCH color spaces. Parse, convert, and manipulate colors with an intuitive API.
 
+We have a fancy-pants WASM based demo here: https://unreasonable-magic.github.io/unmagic-color/
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -159,31 +161,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 +189,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 +208,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 +226,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,41 +14,23 @@ 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
+            # Parse a color (hex, rgb, hsl, oklch, ansi, css named, x11)
             parse("#ff5733")
-            rgb(255, 87, 51)
+            parse("goldenrod")
+
+            # Manually create colors
+            rgb(255, 87, 51, alpha: percentage(50))
             hsl(9, 100, 60)
             oklch(0.65, 0.22, 30)
-            parse("rebeccapurple")
-
-            # Manipulate colors
-            color = parse("#ff5733")
-            color.lighten(0.1)
-            color.darken(0.1)
-            color.saturate(0.1)
-            color.desaturate(0.1)
-            color.rotate(30)
-
-            # Convert between formats
-            color.to_rgb
-            color.to_hsl
-            color.to_oklch
-            color.to_hex
-            color.to_css_oklch
 
-            # Create gradients
-            gradient(:linear, ["#FF0000", "#0000FF"]).rasterize(width: 10).pixels[0].map(&:to_hex)
+            # Show a color card
+            show("#ff5733")
 
-            # Helpers
-            rgb(255, 87, 51)
-            hsl(9, 100, 60)
-            oklch(0.65, 0.22, 30)
-            parse("#ff5733")
-            gradient(:linear, ["#FF0000", "#0000FF"])
-            percentage(50)
+            # Make a rainbow
+            puts gradient(:linear, %w[red orange yellow green blue purple], direction: "to right").rasterize(width: 60).to_ansi
           RUBY
 
           "#{link}\n\n#{code}"

data/lib/unmagic/color/gradient/bitmap.rb

@@ -85,6 +85,27 @@ module Unmagic
         def to_a
           @pixels.flatten
         end
+
+        # Convert to ANSI escape codes for terminal display.
+        #
+        # Renders each pixel as a colored character using 24-bit true color
+        # ANSI codes. Each row is joined and rows are separated by newlines.
+        #
+        # @param fill [String] Character to use for each pixel (default: "█")
+        # @return [String] ANSI-colored string representation
+        #
+        # @example Render a rainbow gradient
+        #   gradient = Gradient.linear(%w[red yellow green blue])
+        #   bitmap = gradient.rasterize(width: 40)
+        #   puts bitmap.to_ansi
+        #
+        # @example Use custom fill character
+        #   puts bitmap.to_ansi(fill: "▀")
+        def to_ansi(fill: "█")
+          @pixels.map do |row|
+            row.map { |color| "\e[#{color.to_ansi}m#{fill}\e[0m" }.join
+          end.join("\n")
+        end
       end
     end
   end

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.2"
   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.2
 platform: ruby
 authors:
 - Keith Pitt