phlex-icons-bootstrap 2.19.0 → 2.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9132e7a32afc9c2ff41a25dd7de207f16e02a9f3a655bdfe1eded0fd8a8be1ba
-  data.tar.gz: 81bc50d824973d237042b925511be98408fdf0d38731f4841113de513fcbe00f
+  metadata.gz: 1402a43e6df889d63b04b2422c5c4d2f6f457d43330adba486710b76d1e03cce
+  data.tar.gz: 6a85af5e4933722783191a4f7188728ef3f12fb195efda34e8688d79b2e24f74
 SHA512:
-  metadata.gz: 6da70c91224b802a0aab3639df440ee888b1e4fe25a3755ebd73ed2fab7301a4395cce00a20705d92a7fa0cf7d2512c14a95796a630f00b4973f9f053b61948a
-  data.tar.gz: 6e7f10f3c812bea158086b53fab5984577462dd4ea9bb4aa40bd5375fd81536a513131b626ee1ada4e2ac5c546fb9c512497c753e439add208444b1bb6f9b0d0
+  metadata.gz: a7849af580a4bc83606a5ca1e1d15c2e48c53991323c4c8fdccca18559358560dd37831fb61662f71278cbe917c8a7eb7453a81400568b17e5a0b542b719eef5
+  data.tar.gz: '099cd42e6d2a067e8215bc3a009c2b973f1cc44b53c5ce32d4cc408df3ee67aca909338f47bbdb4aa912605f9ecd80f67b085666f1877f138267db17b7eabab0'

data/.rubocop.yml

@@ -25,4 +25,8 @@ Metrics/MethodLength:
   CountAsOne: ['array', 'method_call']
 
 Metrics/ClassLength:
-  CountAsOne: ['array', 'method_call']
+  CountAsOne: ['array', 'method_call']
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'

data/README.md

@@ -62,11 +62,15 @@ The gem provides global configuration options, and per icons pack configuration
 ```ruby
 PhlexIcons.configure do |config|
   config.default_classes = 'size-6'
+  config.helper_method_name = :phlex_icon # Default: :phlex_icon
+  config.default_pack = :hero # Default: nil. Accepts :symbol, "string", or Class (e.g., PhlexIcons::Hero)
 end
 
 # OR
 
 PhlexIcons.configuration.default_classes = 'size-6'
+PhlexIcons.configuration.helper_method_name = :phlex_icon
+PhlexIcons.configuration.default_pack = :hero
 ```
 
 ### Bootstrap Icons configuration
@@ -153,6 +157,9 @@ class PhlexIcons < Phlex::HTML
       Radix::Home(class: 'size-4')
       Remix::HomeLine(class: 'size-4')
       Tabler::Home(variant: :filled, class: 'size-4')
+
+      # or with a string
+      Icon('bootstrap/house', class: 'size-4')
     end
   end
 end
@@ -174,11 +181,48 @@ class PhlexIcons < Phlex::HTML
       render PhlexIcons::Radix::Home.new(class: 'size-4')
       render PhlexIcons::Remix::HomeLine.new(class: 'size-4')
       render PhlexIcons::Tabler::Home.new(variant: :filled, class: 'size-4')
+
+      # or with a string
+      render PhlexIcons::Icon('bootstrap/house', class: 'size-4')
     end
   end
 end
 ```
 
+### Rails View Helper
+
+`phlex-icons` provides a convenient helper method to render icons directly in your ERB or Phlex views.
+
+By default, the helper method is named `phlex_icon`, but is configurable.
+
+```erb
+<%# Render a Bootstrap house icon with default size %>
+<%= phlex_icon 'bootstrap/house' %>
+
+<%# Render a Heroicons solid home icon with a specific class %>
+<%= phlex_icon 'hero/home', variant: :solid, class: 'w-5 h-5 text-blue-500' %>
+
+<%# Render a Tabler home icon, filled variant %>
+<%= phlex_icon 'tabler/home:filled' %>
+
+<%# If default_pack = :hero, render a Heroicons home icon %>
+<%= phlex_icon 'home', class: 'w-6 h-6' %>
+
+<%# Render a Flag icon (rectangle variant is default for flags if not configured otherwise) %>
+<%= phlex_icon 'flag/sa' %>
+
+<%# Render a custom icon %>
+<%= phlex_icon 'custom/my_awesome_icon:variant_name' %>
+```
+
+The first argument is the icon identifier. Such as: `'pack/icon_name:variant'`.
+
+*   If `default_pack` is configured, you can omit the pack name (e.g., `'icon_name:variant'` instead of `'pack/icon_name:variant'`).
+*   The `:variant` part is optional.
+*   Examples: `'hero/house:solid'`, `'house:solid'`, `'house'`
+
+Subsequent arguments are passed as options to the icon component, such as `variant`, `class`, etc.
+
 ### Specific icon pack(s)
 
 Let's say you want to use only Heroicons and Flag Icons, you can use the following gems:

data/lib/phlex-icons/bootstrap/bluesky.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# rubocop:disable Layout/LineLength
+module PhlexIcons
+  module Bootstrap
+    class Bluesky < Base
+      def view_template
+        svg(
+          **attrs,
+          xmlns: 'http://www.w3.org/2000/svg',
+          fill: 'currentColor',
+          viewbox: '0 0 16 16'
+        ) do |s|
+          s.path(
+            d:
+              'M3.468 1.948C5.303 3.325 7.276 6.118 8 7.616c.725-1.498 2.698-4.29 4.532-5.668C13.855.955 16 .186 16 2.632c0 .489-.28 4.105-.444 4.692-.572 2.04-2.653 2.561-4.504 2.246 3.236.551 4.06 2.375 2.281 4.2-3.376 3.464-4.852-.87-5.23-1.98-.07-.204-.103-.3-.103-.218 0-.081-.033.014-.102.218-.379 1.11-1.855 5.444-5.231 1.98-1.778-1.825-.955-3.65 2.28-4.2-1.85.315-3.932-.205-4.503-2.246C.28 6.737 0 3.12 0 2.632 0 .186 2.145.955 3.468 1.948'
+          )
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Layout/LineLength

data/lib/phlex-icons/bootstrap/calendar3_event_fill.rb

@@ -12,9 +12,8 @@ module PhlexIcons
           viewbox: '0 0 16 16'
         ) do |s|
           s.path(
-            fill_rule: 'evenodd',
             d:
-              'M2 0a2 2 0 0 0-2 2h16a2 2 0 0 0-2-2zM0 14V3h16v11a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2m12-8a1 1 0 1 0 2 0 1 1 0 0 0-2 0'
+              'M16 14a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V3h16zm-3-9a1 1 0 1 0 0 2 1 1 0 0 0 0-2m1-5a2 2 0 0 1 2 2H0a2 2 0 0 1 2-2z'
           )
         end
       end

data/lib/phlex-icons/bootstrap/calendar3_range_fill.rb

@@ -12,9 +12,8 @@ module PhlexIcons
           viewbox: '0 0 16 16'
         ) do |s|
           s.path(
-            fill_rule: 'evenodd',
             d:
-              'M2 0a2 2 0 0 0-2 2h16a2 2 0 0 0-2-2zM0 8V3h16v2h-6a1 1 0 1 0 0 2h6v7a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-4h6a1 1 0 1 0 0-2z'
+              'M16 5h-6a1 1 0 0 0 0 2h6v7a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-4h6a1 1 0 0 0 0-2H0V3h16zm-2-5a2 2 0 0 1 2 2H0a2 2 0 0 1 2-2z'
           )
         end
       end

data/lib/phlex-icons/bootstrap/calendar3_week_fill.rb

@@ -12,9 +12,8 @@ module PhlexIcons
           viewbox: '0 0 16 16'
         ) do |s|
           s.path(
-            fill_rule: 'evenodd',
             d:
-              'M2 0a2 2 0 0 0-2 2h16a2 2 0 0 0-2-2zM0 14V3h16v11a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2m12-8a1 1 0 1 0 2 0 1 1 0 0 0-2 0M5 9a1 1 0 1 0 2 0 1 1 0 0 0-2 0m5-2a1 1 0 1 1 0-2 1 1 0 0 1 0 2M2 9a1 1 0 1 0 2 0 1 1 0 0 0-2 0'
+              'M16 14a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V3h16zM3 8a1 1 0 1 0 0 2 1 1 0 0 0 0-2m3 0a1 1 0 1 0 0 2 1 1 0 0 0 0-2m4-3a1 1 0 1 0 0 2 1 1 0 0 0 0-2m3 0a1 1 0 1 0 0 2 1 1 0 0 0 0-2m1-5a2 2 0 0 1 2 2H0a2 2 0 0 1 2-2z'
           )
         end
       end

data/lib/phlex-icons/bootstrap.rb

@@ -2,7 +2,7 @@
 
 module PhlexIcons
   module Bootstrap # rubocop:disable Metrics/ModuleLength
-    VERSION = '1.11.3'
+    VERSION = '1.12.1'
     VARIANTS = nil
 
     extend Phlex::Kit
@@ -201,6 +201,7 @@ module PhlexIcons
     autoload :BinocularsFill, 'phlex-icons/bootstrap/binoculars_fill'
     autoload :BlockquoteLeft, 'phlex-icons/bootstrap/blockquote_left'
     autoload :BlockquoteRight, 'phlex-icons/bootstrap/blockquote_right'
+    autoload :Bluesky, 'phlex-icons/bootstrap/bluesky'
     autoload :Bluetooth, 'phlex-icons/bootstrap/bluetooth'
     autoload :BodyText, 'phlex-icons/bootstrap/body_text'
     autoload :Book, 'phlex-icons/bootstrap/book'

data/lib/phlex-icons/configuration.rb

@@ -2,10 +2,33 @@
 
 module PhlexIcons
   class Configuration
-    attr_accessor :default_variant, :default_classes
+    attr_accessor :default_variant, :default_classes, :helper_method_name
+    attr_reader :default_pack
 
     def initialize(default_classes: 'size-6')
       @default_classes = default_classes
+      @helper_method_name = :phlex_icon
+      @default_pack = nil
+    end
+
+    # Custom setter for default_pack
+    # Accepts Class (PhlexIcons::Hero), String ('hero'), or Symbol (:hero)
+    #
+    # @param value [Class, String, Symbol, nil] The value to set the default pack to.
+    # @raise [ArgumentError] If the value is not a Class, String, Symbol, or nil.
+    def default_pack=(value)
+      @default_pack = case value
+                      when Class
+                        # Extract 'Hero' from PhlexIcons::Hero, lowercase, symbolize
+                        value.name.split('::').last&.downcase&.to_sym
+                      when String, Symbol
+                        value.to_sym
+                      when nil
+                        nil
+                      else
+                        raise ArgumentError,
+                              "Invalid type for default_pack: #{value.class}. Expected Class, String, Symbol, or nil."
+                      end
     end
   end
 end

data/lib/phlex-icons/icon.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'name_parser'
+
+module PhlexIcons
+  extend Phlex::Kit
+
+  class Icon < Phlex::SVG
+    # Factory method to create an icon component instance.
+    # Parses the name string, finds the corresponding class, and initializes it with options.
+    # @param name [String] Icon identifier (e.g., "hero/house:solid", "lucide/arrow-right").
+    # @param options [Hash] HTML attributes and options for the icon component.
+    # @return [Phlex::SVG] An instance of the resolved icon component.
+    # @raise [ArgumentError] If the name format is invalid or default pack is missing.
+    # @raise [NameError] If the corresponding icon class cannot be found.
+    def initialize(name, **options)
+      @name = name
+      @options = options&.transform_keys(&:to_sym) || {}
+      super()
+    end
+
+    def view_template
+      parser = PhlexIcons::NameParser.new(@name)
+
+      # Prioritize variant from the name string over options hash
+      @options[:variant] = parser.variant_name if parser.variant_name
+
+      render parser.klass.new(**@options)
+    end
+  end
+end

data/lib/phlex-icons/name_parser.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module PhlexIcons
+  class NameParser
+    attr_reader :pack_name, :icon_name, :variant_name, :identifier, :klass
+
+    # Initializes the parser with the full icon identifier string (e.g., "hero/arrow-right:solid").
+    # Parses the string into pack, icon, and variant components.
+    # Determines and validates the corresponding icon component class.
+    # @param identifier [String] The full icon identifier.
+    # @raise [ArgumentError] If the name format is invalid or default pack is missing.
+    # @raise [NameError] If the corresponding icon class cannot be found.
+    def initialize(identifier)
+      @identifier = identifier.to_s
+      @pack_name, @icon_name, @variant_name = parse(@identifier)
+      @klass = find_icon_class(@pack_name, @icon_name)
+    end
+
+    private
+
+    # Performs the core parsing logic.
+    # @param identifier [String] The full icon identifier.
+    # @return [Array<String, String, Symbol, nil>] An array containing [pack_name, icon_name, variant_name].
+    def parse(identifier)
+      name_part, variant = identifier.split(':', 2)
+
+      # Check if the part before ':' (or the whole string if no ':') is empty
+      if name_part.nil? || name_part.strip.empty?
+        raise ArgumentError,
+              "Invalid icon name format. Could not determine pack or icon name from '#{identifier}'."
+      end
+
+      parsed_variant = variant&.empty? ? nil : variant&.to_sym
+      pack, icon = parse_pack_and_icon(name_part)
+
+      validate_identifier_parts(pack, icon, identifier)
+
+      [pack, icon, parsed_variant]
+    end
+
+    # Extracts the pack and icon names from the part before the variant separator (':').
+    # @param name_part [String] The part of the name string before ':'.
+    # @return [Array<String, String>] An array containing [pack_name, icon_name].
+    def parse_pack_and_icon(name_part)
+      if name_part.include?('/')
+        # If split results in empty parts, they will be caught by validate_identifier_parts later
+        name_part.split('/', 2)
+      else
+        # If name_part is just the icon, it cannot be empty (checked in `parse`)
+        [get_default_pack_name_or_raise(name_part), name_part]
+      end
+    end
+
+    # Retrieves the configured default pack name or raises an error if not set.
+    # @param icon_name_part [String] The icon name used when the pack prefix is missing (for error message).
+    # @return [String] The default pack name.
+    # @raise [ArgumentError] If PhlexIcons.configuration.default_pack is not configured.
+    def get_default_pack_name_or_raise(icon_name_part)
+      # Assumes PhlexIcons.configuration is available.
+      # Consider requiring 'phlex_icons/configuration' explicitly if needed outside Rails context.
+      default_pack_name = defined?(PhlexIcons.configuration) ? PhlexIcons.configuration&.default_pack&.to_s : nil
+      unless default_pack_name && !default_pack_name.empty?
+        raise ArgumentError,
+              "Icon name '#{icon_name_part}' is missing the pack name prefix (e.g., 'hero/'), " \
+              'and no `default_pack` is configured in PhlexIcons.'
+      end
+      default_pack_name
+    end
+
+    # Validates that both pack and icon name parts were successfully extracted.
+    # @param pack [String, nil] The extracted pack name.
+    # @param icon [String, nil] The extracted icon name.
+    # @param identifier [String] The original full identifier (for error message).
+    # @raise [ArgumentError] If either pack or icon is missing or empty.
+    def validate_identifier_parts(pack, icon, identifier)
+      return if pack && !pack.empty? && icon && !icon.empty?
+
+      raise ArgumentError,
+            "Invalid icon name format. Could not determine pack or icon name from '#{identifier}'."
+    end
+
+    # Finds the PhlexIcon component class based on pack and icon names.
+    # @param pack_name [String] The kebab-case pack name (e.g., "hero").
+    # @param icon_name [String] The kebab-case icon name (e.g., "arrow-right").
+    # @return [Class] The icon component class.
+    # @raise [NameError] If the corresponding icon class cannot be found.
+    def find_icon_class(pack_name, icon_name)
+      class_name = build_icon_class_name(pack_name, icon_name)
+      find_and_validate_icon_class(class_name, pack_name, icon_name)
+    end
+
+    # Constructs the full Ruby class name for an icon component.
+    # @param pack_name [String] The kebab-case pack name (e.g., "hero").
+    # @param icon_name [String] The kebab-case icon name (e.g., "arrow-right").
+    # @return [String] The CamelCase class name (e.g., "PhlexIcons::Hero::ArrowRight").
+    def build_icon_class_name(pack_name, icon_name)
+      pack_module_name = pack_name.split('-').map(&:capitalize).join
+      icon_class_name = icon_name.split('-').map(&:capitalize).join
+      "PhlexIcons::#{pack_module_name}::#{icon_class_name}"
+    end
+
+    # Attempts to find the icon class by its name and validates its existence.
+    # @param class_name [String] The full class name to find.
+    # @param pack_name [String] Original pack name (for error message).
+    # @param icon_name [String] Original icon name (for error message).
+    # @return [Class] The found icon component class.
+    # @raise [NameError] If the class cannot be found.
+    def find_and_validate_icon_class(class_name, pack_name, icon_name)
+      Object.const_get(class_name)
+    rescue NameError
+      raise NameError,
+            "Could not find icon component class '#{class_name}'. " \
+            "Make sure the pack ('#{pack_name}') and name ('#{icon_name}') " \
+            'are correct and the corresponding file is loaded.'
+    end
+  end
+end

data/lib/phlex-icons/railtie.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative 'configuration'
+
+module PhlexIcons
+  class Railtie < ::Rails::Railtie
+    initializer 'phlex_icons.view_helpers' do
+      ActiveSupport.on_load(:action_view) do
+        helper_method_name = PhlexIcons.configuration.helper_method_name
+
+        define_method helper_method_name do |name, **options|
+          PhlexIcons::Icon.call(name, **options)&.html_safe
+        end
+      end
+    end
+  end
+end

data/lib/phlex-icons/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PhlexIcons
-  VERSION = '2.19.0'
+  VERSION = '2.20.0'
 end

data/lib/phlex-icons-bootstrap.rb

@@ -12,6 +12,9 @@ require_relative 'phlex-icons/version'
 require_relative 'phlex-icons/bootstrap'
 require_relative 'phlex-icons/material'
 
+require_relative 'phlex-icons/icon'
+require_relative 'phlex-icons/railtie' if defined?(Rails)
+
 module PhlexIcons
   class << self
     def configuration

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phlex-icons-bootstrap
 version: !ruby/object:Gem::Version
-  version: 2.19.0
+  version: 2.20.0
 platform: ruby
 authors:
 - Ali Hamdi Ali Fadel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-25 00:00:00.000000000 Z
+date: 2025-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -245,6 +245,7 @@ files:
 - lib/phlex-icons/bootstrap/binoculars_fill.rb
 - lib/phlex-icons/bootstrap/blockquote_left.rb
 - lib/phlex-icons/bootstrap/blockquote_right.rb
+- lib/phlex-icons/bootstrap/bluesky.rb
 - lib/phlex-icons/bootstrap/bluetooth.rb
 - lib/phlex-icons/bootstrap/body_text.rb
 - lib/phlex-icons/bootstrap/book.rb
@@ -2105,6 +2106,7 @@ files:
 - lib/phlex-icons/bootstrap/zoom_in.rb
 - lib/phlex-icons/bootstrap/zoom_out.rb
 - lib/phlex-icons/configuration.rb
+- lib/phlex-icons/icon.rb
 - lib/phlex-icons/material.rb
 - lib/phlex-icons/material/abc.rb
 - lib/phlex-icons/material/abc_filled.rb
@@ -14829,6 +14831,8 @@ files:
 - lib/phlex-icons/material/zoom_out_round.rb
 - lib/phlex-icons/material/zoom_out_sharp.rb
 - lib/phlex-icons/material/zoom_out_two_tone.rb
+- lib/phlex-icons/name_parser.rb
+- lib/phlex-icons/railtie.rb
 - lib/phlex-icons/version.rb
 - phlex-icons.png
 - sig/phlex/icons.rbs