fontawesome_cdn 0.2.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6e25b39df453df95abdf3432c1a3d752c99ecb9f16a61c722a61144589b5cdb
-  data.tar.gz: fc6374becd7e0a3c9331b76560e342818acda650554aabb234961ca4f908299f
+  metadata.gz: 17a69f882df20af599d2070ad9249f1759d14fc0b14bea47c109b0a15d157d0e
+  data.tar.gz: 187ff7f8c50fd6edaa022217c4d526ee63f447cd46590b2f037bd76f988189e9
 SHA512:
-  metadata.gz: 5fb96ae5eb2718f69423fcd5627e2a5d2571a23453bed4b66c742219f9b83423e9d6cd076dc21e426d829159356e24318f94bcafe10acb0d92f04fac7d8d4b6d
-  data.tar.gz: e679249b19bbe2acc6622fed33d9995d6806efeee854656de21c434d99e0049658fe9494f774d34e42d4924872f8b27df8d4d898a84e51543240da310d64be1e
+  metadata.gz: c71799ae50fc7baf58f5057d58e96f047f079fff04ce4a97bc919b3769c4e3ba8a401c07cc1280980e2d0e2583246a3589c71184da9d6f736fddcf9e10dc0fda
+  data.tar.gz: de8a29cdc724e752652a6f116ed0010ad76eff35952a810b343b71eeaf22d87ff759937b6c9a1a9734c025e8b10ebce2d8391baac9a4dcac59ae63eb6ca749c7

data/CHANGELOG.md

@@ -6,6 +6,68 @@ This project follows [Semantic Versioning](https://semver.org).
 
 ---
 
+## 1.0.0
+
+This release marks the **first stable version** of FontawesomeCdn.
+The public API is now considered stable and will follow Semantic Versioning.
+
+### Changed
+- Stabilized the `icon` helper API with a fully class-based approach.
+- Removed legacy `style:` and `pack:` options in favor of direct Font Awesome classes.
+- Default family and style are now applied automatically via configuration.
+- The `classic` family is implicit and no longer rendered as `fa-classic`.
+- When using the `brands` family, no style class is automatically injected.
+
+### Added
+- Added `fa:` option as a convenience shortcut to pass space-separated Font Awesome tokens
+  (automatically prefixed with `fa-`).
+- Added global configuration options:
+  - `default_family`
+  - `default_style`
+  - `default_aria_hidden`
+
+### Examples
+```erb
+<%= icon "user" %>
+<%= icon "gear", "Settings" %>
+<%= icon "bell", class: "fa-regular fa-2x fa-shake" %>
+<%= icon "bell", fa: "regular 2x shake" %>
+<%= icon "github", "Source code", fa: "brands", class: "link" %>
+```
+
+### Notes
+- No validation or conflict resolution is applied when multiple styles or families are provided.
+- Users are free to combine classes as needed for experimentation or advanced use cases.
+- Versions prior to `1.0.0` should be considered experimental.
+
+---
+
+## 0.3.0
+
+### Changed
+- Renamed the `fontawesome_cdn_stylesheet_tag` helper to `include_font_awesome` for clarity and consistency.
+- The new `include_font_awesome` helper now supports loading **Font Awesome Kits**, including **Font Awesome Pro**.
+
+### Added
+- Added `kit:` option to `include_font_awesome` to load Font Awesome through the official Kit CDN:
+  ```erb
+  <%= include_font_awesome kit: "YOUR-KIT-ID" %>
+  ```
+
+### Behavior
+- Using a version number still loads Font Awesome Free from cdnjs:
+  ```erb
+  <%= include_font_awesome "7.0.1" %>
+  ```
+- Using `kit:` injects the official Font Awesome Kit `<script>` tag.
+- Passing both `version` and `kit:` now raises an error.
+
+### Notes
+- Existing functionality is preserved for layouts using CDN-based loading.
+- This update enables developers with a **Font Awesome Pro** subscription to load their private icon kits safely and cleanly.
+
+---
+
 ## 0.2.0
 
 ### Changed

data/README.md

@@ -3,13 +3,13 @@
 [![Gem Version](https://img.shields.io/gem/v/fontawesome_cdn.svg)](https://rubygems.org/gems/fontawesome_cdn)
 [![CI](https://github.com/OpenCodeForge/fontawesome_cdn/actions/workflows/ci.yml/badge.svg)](https://github.com/OpenCodeForge/fontawesome_cdn/actions/workflows/ci.yml)
 
-Simple Rails helpers to load **Font Awesome via CDN** and render icons in views.
+Simple Rails helpers to load **Font Awesome via CDN or Kit**, and render icons in views.
 
+✅ Supports **Font Awesome Free (CDN)**  
+✅ Supports **Font Awesome Pro (Kit)**  
 ✅ Compatible with **Font Awesome 7**  
-✅ Compatible with **Rails 8**  
-✅ No asset pipeline  
-✅ No JavaScript
-
+✅ Compatible with **Rails 7 and 8**  
+✅ No asset pipeline required
 
 ---
 
@@ -27,38 +27,111 @@ bundle install
 
 ## 🚀 Usage
 
-### Load Font Awesome (layout)
+### 1️⃣ Load Font Awesome (in your layout)
+
+#### **Option A — Load from cdnjs (Font Awesome Free)**
 
-Place this helper in your layout, inside `<head>`.
+Place inside your `<head>`:
 
 ```erb
-<%= fontawesome_cdn_stylesheet_tag "7.0.1" %>
+<%= include_font_awesome "7.0.1" %>
+```
+
+This generates:
+
+```html
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/css/all.min.css" ...>
 ```
 
 ---
 
-### Render icons (views)
+#### **Option B — Load a Font Awesome Kit (supports Pro)**
 
-Use this helper anywhere in your views or partials.
+If you have a Font Awesome Pro subscription, you can load your Kit:
+
+```erb
+<%= include_font_awesome kit: "YOUR-KIT-ID" %>
+```
+
+This generates:
+
+```html
+<script src="https://kit.fontawesome.com/YOUR-KIT-ID.js" crossorigin="anonymous"></script>
+```
+
+👉 Use this method for **Font Awesome Pro**  
+👉 The kit automatically loads your own selection (Pro icons, subsets, etc.)
+
+---
+
+### 2️⃣ Render icons (in views)
+
+Basic usage:
 
 ```erb
 <%= icon "user" %>
 <%= icon "gear", "Settings" %>
-<%= icon "trash-can", "Delete", style: :regular %>
-<%= icon "github", pack: :brands, class: "fa-2x fa-shake" %>
+<%= icon "bell", class: "fa-regular fa-2x fa-shake" %>
 ```
 
+#### Using the `fa:` shortcut
+
+For convenience, you can use the `fa:` option to pass **space-separated Font Awesome tokens**, automatically prefixed with `fa-`.
+
+```erb
+<%= icon "bell", fa: "regular 2x shake" %>
+<%= icon "github", "Source code", fa: "brands", class: "link" %>
+```
+
+---
+
+## ⚙️ Configuration
+
+FontawesomeCdn allows you to define default icon behavior that will be **automatically applied to all icons**, unless explicitly overridden at render time.
+
+```rb
+# config/initializers/fontawesome_cdn.rb
+FontawesomeCdn.configure do |config|
+  config.default_family = "classic"
+  config.default_style  = "solid"
+  config.default_aria_hidden = true
+end
+```
+
+By default, these settings are used to determine which Font Awesome family and style are added to each icon.  
+If a family or style is explicitly provided via `class:` or `fa:`, it will be used instead of the defaults.
+
+Defaults:
+- `classic` is implicit (no `fa-classic`)
+- default style is injected automatically
+- `brands` does not inject a style
+
 ---
 
-## ✅ Supported Font Awesome versions
+## 🧩 Supported Font Awesome versions
+
+These versions are loaded via **cdnjs** and include verified SRI hashes:
+
+- **7.0.1**
+- **7.0.0**
+- **6.7.2**
+
+---
 
-Font Awesome is loaded directly from [cdnjs](https://cdnjs.com/libraries/font-awesome).
+## 🔐 Using Font Awesome Pro
 
-**Supported versions** (with verified SRI):
+To load Pro icons, create a **Kit** in your Font Awesome account:
+
+1. Go to https://fontawesome.com/kits
+2. Create a kit
+3. Copy your Kit ID
+4. Use:
+
+```erb
+<%= include_font_awesome kit: "YOUR-KIT-ID" %>
+```
 
-- ✅ **7.0.1**
-- ✅ **7.0.0**
-- ✅ **6.7.2**
+> ❗ CDNJS does **not** host Font Awesome Pro — you must use a Kit.
 
 ---
 

data/lib/fontawesome_cdn/configuration.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module FontawesomeCdn
+  # Configuration object for FontawesomeCdn.
+  #
+  # Allows customizing default icon behavior such as:
+  # - icon family (classic, brands, duotone, …)
+  # - icon style (solid, regular, light, thin)
+  # - default aria-hidden attribute
+  #
+  # This configuration can be set in a Rails initializer:
+  #
+  #   FontawesomeCdn.configure do |config|
+  #     config.default_family = "classic"
+  #     config.default_style = "solid"
+  #     config.default_aria_hidden = true
+  #   end
+  #
+  class Configuration
+    attr_accessor :default_family, :default_style, :default_aria_hidden
+
+    def initialize
+      @default_family = :classic
+      @default_style = :solid
+      @default_aria_hidden = true
+    end
+  end
+end

data/lib/fontawesome_cdn/helpers/icon.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module FontawesomeCdn
+  # View helpers for rendering Font Awesome icons
+  module Helpers
+    FAMILIES = %w[
+      classic duotone sharp sharp-duotone brands chisel etch jelly notdog slab
+      thumbprint utility whiteboard
+    ].freeze
+
+    STYLES = %w[solid regular light thin].freeze
+
+    # Renders a Font Awesome icon
+    #
+    # Basic usage (default family and style are applied automatically):
+    #
+    #   <%= icon "user" %>
+    #   <%= icon "gear", "Settings" %>
+    #   <%= icon "bell", class: "fa-regular fa-2x fa-shake" %>
+    #
+    # Using the `fa:` shortcut (tokens are automatically prefixed with `fa-`):
+    #
+    #   <%= icon "bell", fa: "regular 2x shake" %>
+    #   <%= icon "github", "Source code", fa: "brands", class: "link" %>
+    #   <%= icon "alien", fa: "duotone light" %>
+    #
+    # Accessibility:
+    #
+    #   <%= icon "user", aria-hidden: false %>
+    #
+    # Notes:
+    # - Default family and style are applied unless explicitly overridden.
+    # - No validation or conflict resolution is performed on classes.
+    # - Users are free to combine multiple styles or families if needed.
+    #
+    def icon(name, text = nil, **options)
+      # Allow the 2nd argument to be either text or the options hash
+      if text.is_a?(Hash)
+        options = text
+        text = nil
+      end
+
+      aria_hidden =
+        if options.key?(:"aria-hidden")
+          options.delete(:"aria-hidden")
+        else
+          FontawesomeCdn.configuration.default_aria_hidden
+        end
+
+      class_tokens = options.delete(:class).to_s.split
+      fa_tokens = options.delete(:fa).to_s.split.map { |t| "fa-#{t}" }
+
+      tokens = (class_tokens + fa_tokens).uniq
+
+      family = tokens
+               .map { |t| t.delete_prefix("fa-") }
+               .find { |t| FAMILIES.include?(t) } || FontawesomeCdn.configuration.default_family.to_s
+
+      style = tokens
+              .map { |t| t.delete_prefix("fa-") }
+              .find { |t| STYLES.include?(t) } || FontawesomeCdn.configuration.default_style.to_s
+
+      # remove family + style from tokens so they can't reappear later
+      tokens.delete("fa-#{family}")
+      tokens.delete("fa-#{style}")
+
+      classes = []
+      classes << "fa-#{family}" unless family == "classic"
+      classes << "fa-#{style}" unless family == "brands"
+      classes << "fa-#{name}"
+      classes.concat(tokens)
+
+      icon_tag = content_tag(:i, nil, class: classes.uniq.join(" "), "aria-hidden": aria_hidden)
+      return icon_tag if text.nil? || text.to_s.empty?
+
+      safe_join([icon_tag, ERB::Util.html_escape(text.to_s)], " ")
+    end
+
+    private
+
+    def extract_family_and_style(tokens)
+      family = tokens.find { |t| FAMILIES.include?(t) }
+      style = tokens.find { |t| STYLES.include?(t) }
+      [family, style]
+    end
+  end
+end

data/lib/fontawesome_cdn/helpers/include_font_awesome.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module FontawesomeCdn
+  # View helpers for loading Font Awesome assets (CDN or kit)
+  module Helpers
+    # Helper for loading Font Awesome
+    #
+    #   <%= include_font_awesome "7.0.1" %>
+    #   # => <link rel="stylesheet" ...> to cdnjs
+    #
+    #   <%= include_font_awesome kit: "YOUR-KIT" %>
+    #   # => <script src="https://kit.fontawesome.com/YOUR-KIT.js" crossorigin="anonymous"></script>
+    #
+    def include_font_awesome(version = nil, kit: nil, **options)
+      # Prevent ambiguous usage
+      raise ArgumentError, "Use either the version argument or the :kit option, not both" if version && kit
+
+      if kit
+        attrs = {
+          src: "#{FontawesomeCdn::KIT_BASE_URL}/#{kit}.js",
+          crossorigin: "anonymous"
+        }
+
+        tag.script(nil, **attrs, **options)
+      else
+        validate_fontawesome_version!(version)
+
+        attrs = {
+          rel: "stylesheet",
+          href: "#{FontawesomeCdn::CDN_BASE_URL}/#{version}/css/all.min.css",
+          integrity: FontawesomeCdn::CDN_INTEGRITY_MAP[version],
+          crossorigin: "anonymous",
+          referrerpolicy: "no-referrer"
+        }
+
+        tag.link(**attrs, **options)
+      end
+    end
+
+    private
+
+    #
+    # Font Awesome version validation
+    #
+    def validate_fontawesome_version!(version)
+      raise_version_required_error if version.nil?
+      raise_version_type_error(version) unless version.is_a?(String)
+      raise_version_not_supported_error(version) unless FontawesomeCdn::SUPPORTED_VERSIONS.include?(version)
+    end
+
+    def raise_version_required_error
+      raise ArgumentError, <<~MSG
+        fontawesome_cdn: Font Awesome version is required.
+        Usage: <%= include_font_awesome "7.x.x" %> or <%= include_font_awesome kit: "YOUR-KIT" %>
+      MSG
+    end
+
+    def raise_version_type_error(version)
+      raise ArgumentError, <<~MSG
+        fontawesome_cdn: version must be a String, got #{version.class}
+      MSG
+    end
+
+    def raise_version_not_supported_error(version)
+      raise ArgumentError, <<~MSG
+        fontawesome_cdn: Font Awesome version #{version.inspect} is not supported.
+        Supported versions: #{FontawesomeCdn::SUPPORTED_VERSIONS.join(", ")}
+      MSG
+    end
+  end
+end

data/lib/fontawesome_cdn/railtie.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "rails/railtie"
-require "fontawesome_cdn/helpers"
 
 module FontawesomeCdn
   # Railtie for loading FontawesomeCdn helpers into Rails.

data/lib/fontawesome_cdn/version.rb

@@ -2,5 +2,5 @@
 
 # Current version of the FontawesomeCdn gem.
 module FontawesomeCdn
-  VERSION = "0.2.0"
+  VERSION = "1.0.0"
 end

data/lib/fontawesome_cdn.rb

@@ -1,9 +1,39 @@
 # frozen_string_literal: true
 
 require_relative "fontawesome_cdn/version"
+require_relative "fontawesome_cdn/configuration"
 
+require "fontawesome_cdn/helpers/include_font_awesome"
+require "fontawesome_cdn/helpers/icon"
 require "fontawesome_cdn/railtie" if defined?(Rails)
 
 # Rails helpers for loading Font Awesome via CDN.
 module FontawesomeCdn
+  CDN_BASE_URL = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome"
+  KIT_BASE_URL = "https://kit.fontawesome.com"
+
+  # Font Awesome versions supported by the gem
+  # SRI hashes provided by cdnjs for all.min.css
+  CDN_INTEGRITY_MAP = {
+    "7.0.1" => "sha512-2SwdPD6INVrV/lHTZbO2nodKhrnDdJK9/kg2XD1r9uGqPo1cUbujc+IYdlYdEErWNu69gVcYgdxlmVmzTWnetw==",
+    "7.0.0" => "sha512-DxV+EoADOkOygM4IR9yXP8Sb2qwgidEmeqAEmDKIOfPRQZOWbXCzLC6vjbZyy0vPisbH2SyW27+ddLVCN+OMzQ==",
+    "6.7.2" => "sha512-Evv84Mr4kqVGRNSgIGL/F/aIDqQb7xQ2vcrdIwxfjThSH8CSR7PBEakCr51Ck+w+/U6swU2Im1vVX0SVk9ABhg=="
+  }.freeze
+
+  SUPPORTED_VERSIONS = CDN_INTEGRITY_MAP.keys.freeze
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+  end
+
+  # Helpers exposed to the Rails views
+  module Helpers
+    # The methods are added here by the helper files
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fontawesome_cdn
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 1.0.0
 platform: ruby
 authors:
 - OpenCodeForge
@@ -16,6 +16,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -23,9 +26,12 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
 description: |
-  Tiny Rails helpers to load Font Awesome via CDN and render icons.
-  No asset pipeline integration, no JavaScript, no magic.
+  FontawesomeCdn provides simple Rails helpers to load Font Awesome (Free or Pro) via CDN or Kit,
+  and render icons using a flexible, class-based API.
 email:
 - contact@opencodeforge.com
 executables: []
@@ -38,7 +44,9 @@ files:
 - README.md
 - Rakefile
 - lib/fontawesome_cdn.rb
-- lib/fontawesome_cdn/helpers.rb
+- lib/fontawesome_cdn/configuration.rb
+- lib/fontawesome_cdn/helpers/icon.rb
+- lib/fontawesome_cdn/helpers/include_font_awesome.rb
 - lib/fontawesome_cdn/railtie.rb
 - lib/fontawesome_cdn/version.rb
 - sig/fontawesome_cdn.rbs
@@ -47,7 +55,6 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/OpenCodeForge/fontawesome_cdn
-  source_code_uri: https://github.com/OpenCodeForge/fontawesome_cdn
   bug_tracker_uri: https://github.com/OpenCodeForge/fontawesome_cdn/issues
   changelog_uri: https://github.com/OpenCodeForge/fontawesome_cdn/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
@@ -67,5 +74,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.7.2
 specification_version: 4
-summary: Simple Rails helpers to load Font Awesome from a CDN.
+summary: Rails helpers to load Font Awesome via CDN or Kit and render icons in views
 test_files: []

data/lib/fontawesome_cdn/helpers.rb

@@ -1,137 +0,0 @@
-# frozen_string_literal: true
-
-module FontawesomeCdn
-  BASE_URL = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome"
-
-  # Font Awesome versions supported by the gem
-  # SRI hashes provided by cdnjs for all.min.css
-  INTEGRITY_MAP = {
-    "7.0.1" => "sha512-2SwdPD6INVrV/lHTZbO2nodKhrnDdJK9/kg2XD1r9uGqPo1cUbujc+IYdlYdEErWNu69gVcYgdxlmVmzTWnetw==",
-    "7.0.0" => "sha512-DxV+EoADOkOygM4IR9yXP8Sb2qwgidEmeqAEmDKIOfPRQZOWbXCzLC6vjbZyy0vPisbH2SyW27+ddLVCN+OMzQ==",
-    "6.7.2" => "sha512-Evv84Mr4kqVGRNSgIGL/F/aIDqQb7xQ2vcrdIwxfjThSH8CSR7PBEakCr51Ck+w+/U6swU2Im1vVX0SVk9ABhg=="
-  }.freeze
-
-  SUPPORTED_VERSIONS = INTEGRITY_MAP.keys.freeze
-
-  ICON_STYLES = %w[solid regular light thin semibold].freeze
-  DEFAULT_ICON_STYLE = "solid"
-
-  # Helpers exposed to Rails views.
-  #
-  # Provides:
-  # - fontawesome_cdn_stylesheet_tag(version)
-  # - icon(name, text = nil, **options)
-  module Helpers
-    # Stylesheet helper for loading Font Awesome via CDN
-    #
-    #   <%= fontawesome_cdn_stylesheet_tag "7.0.1" %>
-    #
-    # Raises ArgumentError if version is not supported.
-    #
-    def fontawesome_cdn_stylesheet_tag(version = nil, **options)
-      validate_fontawesome_version!(version)
-
-      href = "#{FontawesomeCdn::BASE_URL}/#{version}/css/all.min.css"
-
-      attrs = {
-        rel: "stylesheet",
-        href: href,
-        integrity: FontawesomeCdn::INTEGRITY_MAP[version],
-        crossorigin: "anonymous",
-        referrerpolicy: "no-referrer"
-      }
-
-      tag.link(**attrs, **options)
-    end
-
-    # Main helper for displaying an icon
-    #
-    #   <%= icon "user" %>
-    #   <%= icon "gear", "Settings" %>
-    #   <%= icon "trash-can", "Delete", style: :regular %>
-    #   <%= icon "github", pack: :brands, class: "fa-2x fa-shake" %>
-    #
-    def icon(name, text = nil, **options)
-      # Allow the 2nd argument to be either text or the options hash
-      if text.is_a?(Hash)
-        options = text
-        text = nil
-      end
-
-      pack_class, style_class = build_pack_and_style_classes(options)
-      options[:class] = [pack_class, style_class, "fa-#{name}", options[:class]].compact.join(" ")
-      options["aria-hidden"] = true unless options.key?("aria-hidden") || options.key?(:"aria-hidden")
-
-      icon_tag = tag.i(nil, **options)
-
-      text.nil? || text.to_s.strip.empty? ? icon_tag : safe_join([icon_tag, " ", text.to_s])
-    end
-
-    private
-
-    #
-    # Font Awesome version validation
-    #
-    def validate_fontawesome_version!(version)
-      raise_version_required_error if version.nil?
-      raise_version_type_error(version) unless version.is_a?(String)
-      raise_version_not_supported_error(version) unless FontawesomeCdn::SUPPORTED_VERSIONS.include?(version)
-    end
-
-    def raise_version_required_error
-      raise ArgumentError, <<~MSG
-        fontawesome_cdn: Font Awesome version is required.
-        Usage: <%= fontawesome_cdn_stylesheet_tag "7.x.x" %>
-      MSG
-    end
-
-    def raise_version_type_error(version)
-      raise ArgumentError, <<~MSG
-        fontawesome_cdn: version must be a String, got #{version.class}
-      MSG
-    end
-
-    def raise_version_not_supported_error(version)
-      raise ArgumentError, <<~MSG
-        fontawesome_cdn: Font Awesome version #{version.inspect} is not supported.
-        Supported versions: #{FontawesomeCdn::SUPPORTED_VERSIONS.join(", ")}
-      MSG
-    end
-
-    # Classes:
-    # - style → fa-solid / fa-regular / ...
-    # - pack → fa-brands / ...
-    # Special case: brands icons don't use a style like "solid"
-    def build_pack_and_style_classes(options)
-      pack = options.delete(:pack)&.to_s
-      style = options.delete(:style)&.to_s
-      style ||= DEFAULT_ICON_STYLE unless pack == "brands"
-
-      validate_icon_style_and_pack!(style, pack)
-
-      [pack, style].compact.map { |c| "fa-#{c}" }
-    end
-
-    #
-    # Icon validation
-    #
-    def validate_icon_style_and_pack!(style, pack)
-      raise_style_used_as_pack_error(pack) if pack && ICON_STYLES.include?(pack)
-      raise_unsupported_icon_style_error(style) if style && !ICON_STYLES.include?(style)
-    end
-
-    def raise_style_used_as_pack_error(pack)
-      raise ArgumentError, <<~MSG
-        fontawesome_cdn: #{pack.inspect} is a style, not a pack.
-        Use style: #{pack.inspect} instead.
-      MSG
-    end
-
-    def raise_unsupported_icon_style_error(style)
-      raise ArgumentError, <<~MSG
-        fontawesome_cdn: unsupported icon style #{style.inspect}.
-        Supported styles: #{ICON_STYLES.join(", ")}
-      MSG
-    end
-  end
-end