phlex-icons-hero 2.18.0 → 2.20.0

data/lib/phlex-icons/hero/user_minus_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UserMinusSolid < Base
       def view_template
-        render UserMinus.new(variant: :solid)
+        render UserMinus.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/user_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UserOutline < Base
       def view_template
-        render User.new(variant: :outline)
+        render User.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/user_plus_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UserPlusOutline < Base
       def view_template
-        render UserPlus.new(variant: :outline)
+        render UserPlus.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/user_plus_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UserPlusSolid < Base
       def view_template
-        render UserPlus.new(variant: :solid)
+        render UserPlus.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/user_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UserSolid < Base
       def view_template
-        render User.new(variant: :solid)
+        render User.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/users_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UsersOutline < Base
       def view_template
-        render Users.new(variant: :outline)
+        render Users.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/users_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class UsersSolid < Base
       def view_template
-        render Users.new(variant: :solid)
+        render Users.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/variable_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VariableOutline < Base
       def view_template
-        render Variable.new(variant: :outline)
+        render Variable.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/variable_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VariableSolid < Base
       def view_template
-        render Variable.new(variant: :solid)
+        render Variable.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/video_camera_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VideoCameraOutline < Base
       def view_template
-        render VideoCamera.new(variant: :outline)
+        render VideoCamera.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/video_camera_slash_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VideoCameraSlashOutline < Base
       def view_template
-        render VideoCameraSlash.new(variant: :outline)
+        render VideoCameraSlash.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/video_camera_slash_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VideoCameraSlashSolid < Base
       def view_template
-        render VideoCameraSlash.new(variant: :solid)
+        render VideoCameraSlash.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/video_camera_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class VideoCameraSolid < Base
       def view_template
-        render VideoCamera.new(variant: :solid)
+        render VideoCamera.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/view_columns_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class ViewColumnsOutline < Base
       def view_template
-        render ViewColumns.new(variant: :outline)
+        render ViewColumns.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/view_columns_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class ViewColumnsSolid < Base
       def view_template
-        render ViewColumns.new(variant: :solid)
+        render ViewColumns.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/viewfinder_circle_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class ViewfinderCircleOutline < Base
       def view_template
-        render ViewfinderCircle.new(variant: :outline)
+        render ViewfinderCircle.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/viewfinder_circle_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class ViewfinderCircleSolid < Base
       def view_template
-        render ViewfinderCircle.new(variant: :solid)
+        render ViewfinderCircle.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wallet_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WalletOutline < Base
       def view_template
-        render Wallet.new(variant: :outline)
+        render Wallet.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wallet_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WalletSolid < Base
       def view_template
-        render Wallet.new(variant: :solid)
+        render Wallet.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wifi_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WifiOutline < Base
       def view_template
-        render Wifi.new(variant: :outline)
+        render Wifi.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wifi_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WifiSolid < Base
       def view_template
-        render Wifi.new(variant: :solid)
+        render Wifi.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/window_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WindowOutline < Base
       def view_template
-        render Window.new(variant: :outline)
+        render Window.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/window_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WindowSolid < Base
       def view_template
-        render Window.new(variant: :solid)
+        render Window.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wrench_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WrenchOutline < Base
       def view_template
-        render Wrench.new(variant: :outline)
+        render Wrench.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wrench_screwdriver_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WrenchScrewdriverOutline < Base
       def view_template
-        render WrenchScrewdriver.new(variant: :outline)
+        render WrenchScrewdriver.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wrench_screwdriver_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WrenchScrewdriverSolid < Base
       def view_template
-        render WrenchScrewdriver.new(variant: :solid)
+        render WrenchScrewdriver.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/wrench_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class WrenchSolid < Base
       def view_template
-        render Wrench.new(variant: :solid)
+        render Wrench.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/x_circle_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class XCircleOutline < Base
       def view_template
-        render XCircle.new(variant: :outline)
+        render XCircle.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/x_circle_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class XCircleSolid < Base
       def view_template
-        render XCircle.new(variant: :solid)
+        render XCircle.new(variant: :solid, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/x_mark_outline.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class XMarkOutline < Base
       def view_template
-        render XMark.new(variant: :outline)
+        render XMark.new(variant: :outline, **attrs)
       end
     end
   end

data/lib/phlex-icons/hero/x_mark_solid.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Hero
     class XMarkSolid < Base
       def view_template
-        render XMark.new(variant: :solid)
+        render XMark.new(variant: :solid, **attrs)
       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.18.0'
+  VERSION = '2.20.0'
 end

data/lib/phlex-icons-hero.rb

@@ -12,6 +12,9 @@ require_relative 'phlex-icons/version'
 require_relative 'phlex-icons/hero'
 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-hero
 version: !ruby/object:Gem::Version
-  version: 2.18.0
+  version: 2.20.0
 platform: ruby
 authors:
 - Ali Hamdi Ali Fadel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-18 00:00:00.000000000 Z
+date: 2025-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -1028,6 +1028,7 @@ files:
 - lib/phlex-icons/hero/x_mark.rb
 - lib/phlex-icons/hero/x_mark_outline.rb
 - lib/phlex-icons/hero/x_mark_solid.rb
+- lib/phlex-icons/icon.rb
 - lib/phlex-icons/material.rb
 - lib/phlex-icons/material/abc.rb
 - lib/phlex-icons/material/abc_filled.rb
@@ -13752,6 +13753,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