phlex-icons-flag 2.18.0 → 2.20.0

data/lib/phlex-icons/flag/ua_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UaRectangle < Base
       def view_template
-        render Ua.new(variant: :rectangle)
+        render Ua.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ua_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UaSquare < Base
       def view_template
-        render Ua.new(variant: :square)
+        render Ua.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ug_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UgRectangle < Base
       def view_template
-        render Ug.new(variant: :rectangle)
+        render Ug.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ug_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UgSquare < Base
       def view_template
-        render Ug.new(variant: :square)
+        render Ug.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/um_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UmRectangle < Base
       def view_template
-        render Um.new(variant: :rectangle)
+        render Um.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/um_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UmSquare < Base
       def view_template
-        render Um.new(variant: :square)
+        render Um.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/un_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UnRectangle < Base
       def view_template
-        render Un.new(variant: :rectangle)
+        render Un.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/un_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UnSquare < Base
       def view_template
-        render Un.new(variant: :square)
+        render Un.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/us_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UsRectangle < Base
       def view_template
-        render Us.new(variant: :rectangle)
+        render Us.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/us_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UsSquare < Base
       def view_template
-        render Us.new(variant: :square)
+        render Us.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/uy_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UyRectangle < Base
       def view_template
-        render Uy.new(variant: :rectangle)
+        render Uy.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/uy_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UySquare < Base
       def view_template
-        render Uy.new(variant: :square)
+        render Uy.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/uz_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UzRectangle < Base
       def view_template
-        render Uz.new(variant: :rectangle)
+        render Uz.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/uz_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class UzSquare < Base
       def view_template
-        render Uz.new(variant: :square)
+        render Uz.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/va_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VaRectangle < Base
       def view_template
-        render Va.new(variant: :rectangle)
+        render Va.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/va_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VaSquare < Base
       def view_template
-        render Va.new(variant: :square)
+        render Va.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vc_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VcRectangle < Base
       def view_template
-        render Vc.new(variant: :rectangle)
+        render Vc.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vc_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VcSquare < Base
       def view_template
-        render Vc.new(variant: :square)
+        render Vc.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ve_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VeRectangle < Base
       def view_template
-        render Ve.new(variant: :rectangle)
+        render Ve.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ve_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VeSquare < Base
       def view_template
-        render Ve.new(variant: :square)
+        render Ve.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vg_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VgRectangle < Base
       def view_template
-        render Vg.new(variant: :rectangle)
+        render Vg.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vg_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VgSquare < Base
       def view_template
-        render Vg.new(variant: :square)
+        render Vg.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vi_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ViRectangle < Base
       def view_template
-        render Vi.new(variant: :rectangle)
+        render Vi.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vi_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ViSquare < Base
       def view_template
-        render Vi.new(variant: :square)
+        render Vi.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vn_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VnRectangle < Base
       def view_template
-        render Vn.new(variant: :rectangle)
+        render Vn.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vn_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VnSquare < Base
       def view_template
-        render Vn.new(variant: :square)
+        render Vn.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vu_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VuRectangle < Base
       def view_template
-        render Vu.new(variant: :rectangle)
+        render Vu.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/vu_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class VuSquare < Base
       def view_template
-        render Vu.new(variant: :square)
+        render Vu.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/wf_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class WfRectangle < Base
       def view_template
-        render Wf.new(variant: :rectangle)
+        render Wf.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/wf_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class WfSquare < Base
       def view_template
-        render Wf.new(variant: :square)
+        render Wf.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ws_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class WsRectangle < Base
       def view_template
-        render Ws.new(variant: :rectangle)
+        render Ws.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ws_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class WsSquare < Base
       def view_template
-        render Ws.new(variant: :square)
+        render Ws.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/xk_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class XkRectangle < Base
       def view_template
-        render Xk.new(variant: :rectangle)
+        render Xk.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/xk_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class XkSquare < Base
       def view_template
-        render Xk.new(variant: :square)
+        render Xk.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/xx_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class XxRectangle < Base
       def view_template
-        render Xx.new(variant: :rectangle)
+        render Xx.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/xx_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class XxSquare < Base
       def view_template
-        render Xx.new(variant: :square)
+        render Xx.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ye_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class YeRectangle < Base
       def view_template
-        render Ye.new(variant: :rectangle)
+        render Ye.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/ye_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class YeSquare < Base
       def view_template
-        render Ye.new(variant: :square)
+        render Ye.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/yt_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class YtRectangle < Base
       def view_template
-        render Yt.new(variant: :rectangle)
+        render Yt.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/yt_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class YtSquare < Base
       def view_template
-        render Yt.new(variant: :square)
+        render Yt.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/za_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZaRectangle < Base
       def view_template
-        render Za.new(variant: :rectangle)
+        render Za.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/za_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZaSquare < Base
       def view_template
-        render Za.new(variant: :square)
+        render Za.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/zm_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZmRectangle < Base
       def view_template
-        render Zm.new(variant: :rectangle)
+        render Zm.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/zm_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZmSquare < Base
       def view_template
-        render Zm.new(variant: :square)
+        render Zm.new(variant: :square, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/zw_rectangle.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZwRectangle < Base
       def view_template
-        render Zw.new(variant: :rectangle)
+        render Zw.new(variant: :rectangle, **attrs)
       end
     end
   end

data/lib/phlex-icons/flag/zw_square.rb

@@ -4,7 +4,7 @@ module PhlexIcons
   module Flag
     class ZwSquare < Base
       def view_template
-        render Zw.new(variant: :square)
+        render Zw.new(variant: :square, **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-flag.rb

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