heroicons_helper 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82d8da995254ac85d7fe26d34eb87e3275a5469e296a5684ca2a961ea6cd36d6
-  data.tar.gz: eaea3e8f1913c02803c9a8f1d3059ccc41a18810791687cb9b15249b0ab25e83
+  metadata.gz: 2a4fd38721f8363f1f2b36b45cec732c0dba30f7ac3ad5d1cb243a8e5a722bda
+  data.tar.gz: 59333a78638dacbc4690bc22d231382d79addea64d4bb703b2efbdb4ccc052df
 SHA512:
-  metadata.gz: f237870c06e656d6056c3f3efc48d79ecbeffc99a9688d575d289794269ca476147319af658fb38e9e08cb8b07f00708a8bd9d616309882a18628f9e881f613f
-  data.tar.gz: 320e20817dd459fa7b5f18d2b4d218b0a715abc3a7c4b88e3e805a2d4a207c11b1fe9fac81db1b90711f165c1278e167818def8097f0ad9c34c05624e8114cc0
+  metadata.gz: 1aef948793f04e86a224734f44da163f037a26c74f392757c0cb0b7546ae26edbfb00ef6ef0bd5bed5bea6b93be49933f3c432f28c94b9654b2905028dced010
+  data.tar.gz: 40c2239119dc8de51e43e55260e2bd9190faaad885ae1e53f4a5b4a24eb2420f5cc5d0e5fb13658c9a5cae55563d319fd858895a23dedbb5611da192d87bb654

data/README.md

@@ -22,10 +22,10 @@ require "heroicons_helper"
 include HeroiconsHelper
 ```
 
-You'll have a brand new method called `heroicons` whose signature looks like this:
+You'll have a brand new method called `heroicon` whose signature looks like this:
 
 ```ruby
-heroicons(symbol, variant, attributes: {})
+heroicon(symbol, variant, attributes: {})
 ```
 
 where
@@ -37,7 +37,7 @@ where
 This one method call returns an object that represents the Heroicon, and you should call `to_svg` to get the resulting SVG string:
 
 ```ruby
-outline_icon = heroicons("x", "outline")
+outline_icon = heroicon("x", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE)
 puts outline_icon.to_svg
 ```
 ```
@@ -58,7 +58,7 @@ icons_to_preload = [{
 },]
 
 HeroiconsHelper::Cache.preload!(icons_to_preload) do |found, icon|
-    # An instance of `FakeClass` is stored in the cache
+    # An instance of `FakeClass` will be stored in the cache
     FakeClass.new(icon) unless found
 end
 ```

data/lib/heroicons_helper/icon.rb

@@ -3,22 +3,29 @@
 module HeroiconsHelper
   # Icon to show heroicons by name and variant.
   class Icon
-    attr_reader :path, :attributes, :width, :height, :symbol, :variant
+    attr_reader :path, :attributes, :width, :height, :symbol, :variant, :keywords
 
     VARIANT_OUTLINE = "outline"
     VARIANT_SOLID = "solid"
     VARIANTS = [VARIANT_OUTLINE, VARIANT_SOLID].freeze
 
     def initialize(symbol, variant, attributes: {})
-      @symbol = symbol
-      @variant = variant
+      @symbol = symbol.to_s
+      @variant = variant.to_s
 
-      icon = get_heroicon(@symbol, @variant)
+      heroicon = get_heroicon(@symbol, @variant)
 
-      @path = icon["path"]
-      @width = icon["width"]
-      @height = icon["height"]
-      @attributes = attributes.dup.merge!(default_attributes)
+      @path = heroicon["path"]
+      @width = heroicon["width"]
+      @height = heroicon["height"]
+      @keywords = heroicon["keywords"]
+      @attributes = attributes.dup
+      @attributes[:class] = classes
+      @attributes[:viewBox] = viewbox
+      @attributes.merge!(size)
+      @attributes[:version] = "1.1"
+      @attributes.merge!(variant_attributes)
+      @attributes.merge!(a11y)
     end
 
     # Returns an string representing a <svg> tag
@@ -26,51 +33,93 @@ module HeroiconsHelper
       "<svg xmlns=\"http://www.w3.org/2000/svg\" #{html_attributes}>#{@path}</svg>"
     end
 
-    private
-
-    def html_attributes
+    private def html_attributes
       attrs = []
       @attributes.each_pair { |attr, value| attrs << "#{attr}=\"#{value}\"" }
       attrs.map(&:strip).join(" ")
     end
 
-    def default_attributes
+    # add some accessibility features to svg
+    private def a11y
+      accessible = {}
+
+      if @attributes[:"aria-label"].nil? && @attributes["aria-label"].nil?
+        accessible[:"aria-hidden"] = "true"
+      else
+        accessible[:role] = "img"
+      end
+
+      accessible
+    end
+
+    # prepare the octicon class
+    private def classes
+      "heroicon heroicon-#{@symbol}-#{@variant} #{@attributes[:class]} ".strip
+    end
+
+    private def variant_attributes
       case @variant
       when VARIANT_OUTLINE
         {
-          viewBox: viewbox,
           fill: "none",
           stroke: "currentColor",
         }
       when VARIANT_SOLID
         {
-          viewBox: viewbox,
           fill: "currentColor",
         }
       end
     end
 
-    def viewbox
+    private def viewbox
       "0 0 #{@width} #{@height}"
     end
 
-    def get_heroicon(symbol, variant)
-      raise ArgumentError, "Icon name can't be empty" unless !symbol.to_s.empty?
-      raise ArgumentError, "Variant `#{variant}` is invalid; must be one of #{VARIANTS.join(", ")}" unless VARIANTS.include?(variant.to_s)
+    # determine the height and width of the octicon based on :size option
+    private def size
+      size = {
+        width: @width,
+        height: @height,
+      }
+
+      # Specific size
+      unless @attributes[:width].nil? && @attributes[:height].nil?
+        size[:width]  = @attributes[:width].nil? ? calculate_width(@attributes[:height]) : @attributes[:width]
+        size[:height] = @attributes[:height].nil? ? calculate_height(@attributes[:width]) : @attributes[:height]
+        @width = size[:width]
+        @height = size[:height]
+      end
+
+      size
+    end
+
+    private def calculate_width(height)
+      (height.to_i * @width) / @height
+    end
+
+    private def calculate_height(width)
+      (width.to_i * @height) / @width
+    end
+
+    private def get_heroicon(symbol, variant)
+      raise ArgumentError, "Icon name can't be empty" if symbol.empty?
+
+      raise ArgumentError, "Variant `#{variant.inspect}` is invalid; must be one of #{VARIANTS.join(", ")}" unless VARIANTS.include?(variant)
 
       icon = HeroiconsHelper::ICON_SYMBOLS[symbol]
 
       raise ArgumentError, "Couldn't find Heroicon for `#{symbol.inspect}`" unless icon
 
-      icon_in_variant = icon["variants"][variant]
-      raise ArgumentError, "Heroicon for `#{symbol.inspect}` doesn't have variant `#{variant.inspect}`" unless icon_in_variant
+      icon_variant = icon["variants"][variant]
+      raise ArgumentError, "Heroicon for `#{symbol.inspect}` doesn't have variant `#{variant.inspect}`" unless icon_variant
 
       {
         "name" => icon["name"],
         "variant" => variant,
-        "width" => icon_in_variant["width"],
-        "height" => icon_in_variant["height"],
-        "path" => icon_in_variant["path"],
+        "keywords" => icon["keywords"] || [],
+        "width" => icon_variant["width"],
+        "height" => icon_variant["height"],
+        "path" => icon_variant["path"],
       }
     end
   end

data/lib/heroicons_helper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HeroiconsHelper
-  VERSION = "0.2.1"
+  VERSION = "0.4.0"
 end

data/lib/heroicons_helper.rb

@@ -9,7 +9,7 @@ module HeroiconsHelper
   file_data = File.read(File.join(File.dirname(__FILE__), "./heroicons_helper/data.json"))
   ICON_SYMBOLS = JSON.parse(file_data).freeze
 
-  def heroicons(symbol, variant, attributes: {})
+  def heroicon(symbol, variant:, **attributes)
     ::HeroiconsHelper::Icon.new(symbol, variant, attributes: attributes)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: heroicons_helper
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Garen J. Torikian
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-06-10 00:00:00.000000000 Z
+date: 2022-06-11 00:00:00.000000000 Z
 dependencies: []
 description: A package that distributes Heroicons as a gem, for easy inclusion in
   Ruby projects.