kiso 0.5.2.pre → 0.5.3.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60861d160167adf83488de026f4bc6e3ae9a6ec90ce04cb5862f0ce5ec1a4567
-  data.tar.gz: d6c5017ed994250be02db77345fdf14c6b72f7971837f7fdc86c6f27a5701dc4
+  metadata.gz: 0e2ae8ad60d92d8f26f348cfcf1dc7e244ab9d43d8650c70bb55563a569ebd92
+  data.tar.gz: 75bcf4fd1147c79754256ab6c3cccd994a1b5a7ace087fd52529e716d7521422
 SHA512:
-  metadata.gz: 7046fc1419c4bb2ca1a2096b11965f714bd91743c70605278bb4ebf9a1d041bad38b073a038aad9f717e730b469841e4532f76752ee952389b7f908b310f8fd0
-  data.tar.gz: 6910db9bd5316e5a556f8032e431305b33d86bce7537428fdd9fd8a3074fe66a5943a02b037955670721772d34dadaf2e5ed97a7448c2db1297c357f99243f50
+  metadata.gz: 80ddd9d1a892eec79083c535516369d0278c3680ee75fd9e7cbffb406a8684d705805104ee12dd2e8d5a920baa15aa1a445d31c637d0ec8a8a675b05889f96e6
+  data.tar.gz: '06824eba6296399c458259426d806da86901040d0922c696efc1f066e0c1feed2c8f405fb09edc5344e54995ef51a932e313291ee77846605315d3e8c433f1ca'

data/app/views/kiso/components/_avatar.html.erb

@@ -1,5 +1,5 @@
-<%# locals: (src: nil, alt: "", text: nil, size: :md, color: nil, ui: {}, css_classes: "", **component_options) %>
-<% text_color = Kiso::ColorUtils.contrast_text_color(color) if color %>
+<%# locals: (src: nil, alt: "", text: nil, size: :md, color: nil, contrast_threshold: nil, ui: {}, css_classes: "", **component_options) %>
+<% text_color = Kiso::ColorUtils.contrast_text_color(color, threshold: contrast_threshold) if color %>
 <%= content_tag :span,
     class: Kiso::Themes::Avatar.render(size: size, class: css_classes),
     style: (color ? "background-color: #{color}; color: #{text_color};" : nil),

data/lib/kiso/color_utils.rb

@@ -4,13 +4,17 @@ module Kiso
   module ColorUtils
     module_function
 
+    DEFAULT_CONTRAST_THRESHOLD = 0.42
+
     # Returns "white" or "black" based on WCAG relative luminance.
-    # Uses a perceptual threshold of 0.36 rather than the mathematical
-    # midpoint of 0.179, per Lea Verou's research on contrast color
-    # generation. The higher threshold produces better results on
-    # saturated chromatic colors (e.g. Tailwind 500-shade palette).
-    # Accepts 3-digit (#abc) or 6-digit (#aabbcc) hex strings.
-    def contrast_text_color(hex)
+    # Uses a perceptual threshold (default 0.42) rather than the
+    # mathematical midpoint of 0.179, per Lea Verou's research on
+    # contrast color generation. The higher threshold produces better
+    # results on saturated chromatic colors (e.g. Tailwind 500-shade
+    # palette). Accepts 3-digit (#abc) or 6-digit (#aabbcc) hex strings.
+    def contrast_text_color(hex, threshold: nil)
+      threshold ||= Kiso.config.contrast_threshold
+
       hex = hex.delete("#")
       hex = hex.chars.map { |c| c * 2 }.join if hex.length == 3
 
@@ -19,7 +23,7 @@ module Kiso
         (c <= 0.04045) ? c / 12.92 : ((c + 0.055) / 1.055)**2.4
       }.then { |lr, lg, lb| 0.2126 * lr + 0.7152 * lg + 0.0722 * lb }
 
-      (luminance > 0.36) ? "black" : "white"
+      (luminance > threshold) ? "black" : "white"
     end
   end
 end

data/lib/kiso/configuration.rb

@@ -33,10 +33,21 @@ module Kiso
     #   end
     attr_accessor :app_theme
 
+    # @return [Float] luminance threshold for contrast text color calculation.
+    #   Colors with luminance above this value get black text, below get white.
+    #   Default is 0.42 (perceptual midpoint per Lea Verou's research).
+    #
+    # @example Tune for a darker palette
+    #   Kiso.configure do |config|
+    #     config.contrast_threshold = 0.36
+    #   end
+    attr_accessor :contrast_threshold
+
     def initialize
       @icons = default_icons
       @theme = {}
       @app_theme = :default
+      @contrast_threshold = Kiso::ColorUtils::DEFAULT_CONTRAST_THRESHOLD
     end
 
     # Resolves the active app theme directory path relative to the given root.

data/lib/kiso/version.rb

@@ -2,5 +2,5 @@
 
 module Kiso
   # @return [String] the current gem version
-  VERSION = "0.5.2.pre"
+  VERSION = "0.5.3.pre"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kiso
 version: !ruby/object:Gem::Version
-  version: 0.5.2.pre
+  version: 0.5.3.pre
 platform: ruby
 authors:
 - Steve Clarke