unmagic-color 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 276b2cc6192a6fea7e69f4893c9989434e8101c3e9c6a88b56996eeeeb910262
-  data.tar.gz: cd421ccce7640490b140a74a62640ee9dbbb6060f815d770b14ac12e4b1ff991
+  metadata.gz: 971c6c19affe985327415a3993e1b47b739a972a51617a39c92be5c4a1af2f2e
+  data.tar.gz: a44de67386e8360347f526b97fc14e925178c475cd93c46fbd831444fd4bc776
 SHA512:
-  metadata.gz: 2da573372028a3d08793d01bcd9245a24fc88934085b081712934e4606a2d60ff03d8c8f6f94b06abb2fb6817e1b5b0acdf8ac2fd332e1d9f9b2923a90221d5c
-  data.tar.gz: 8a17575b7f89b7f9c29d613208972242bd851e42b25659a7533a4c6ed156ce14f9f9396148aa6e171ad5a8e0159395d8e9f9e28b881fa000bbdeb6492cc40388
+  metadata.gz: 1c24ada886792f4443852806fbe7fbae4a491d7428f83eb61e830ce7b768daf7a0b4d46ec615bd8e4f88b797501baedeafd9b6ada46fc6767d4dc3922e481ebb
+  data.tar.gz: fa0b066a29064c5d0db5db70a60489a2201eb5970860865b86b5927eb9f2f64a96e258dcfb85aecf37a0d8e1afda94e702a174e3310fb51408f41500bcad326e

data/CHANGELOG.md

@@ -7,6 +7,11 @@ 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
@@ -81,6 +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:

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

@@ -17,38 +17,20 @@ module Unmagic
           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/version.rb

@@ -3,6 +3,6 @@
 module Unmagic
   class Color
     # Current version of the Unmagic::Color gem
-    VERSION = "0.2.1"
+    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.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Keith Pitt