phlex-icons-remix 2.40.0 → 2.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b025c133870618b4abad31d8f4a1e07389bc1f4800e3bc1b9665d223a5ef2001
-  data.tar.gz: 015c18049eeadb096cedef105c1d53d85c176972345827ca6ca50743ab6909ba
+  metadata.gz: a9f54e26d83cdeaec9638d10c645c094aa50d392840f07dccc3ef90968e86ade
+  data.tar.gz: 3ecdc4eb1037834f9ff00e2d96bce80a5d78efaedab5646fe098b36eed3cda4e
 SHA512:
-  metadata.gz: d379b2a62b3fea57cc1fde82221c725f5c5679763537511f0095a76ddba09acc1db4a1e772b7b31184a2d10af2eaa0efb6a44393072f873076a9b370c4a7e570
-  data.tar.gz: 22a32139e15b28a26e4fa139d37ccb669b7af22f0676f042c5b93147fe8ee7c651af07bc9f8ad16cb94f8bdb42912862ee461d911762c3a3cda0658dd077b331
+  metadata.gz: 4372e3c5da6a17556bc6e2fe6c4ba2cad87186fbe30a9e176d08eb2726773df4ba6b936386f8117b28bb4440bb998e83f8b89e6eb0f449865b67ae4a0d150297
+  data.tar.gz: 697fbb3634cf4637c7a67c84d0c991fb548cd9d32507a299aa8bed0594c8fae7217aefbbe710732045a8973139356a853aa0210e8266717f25cea7f13997c175

data/.devcontainer/devcontainer.json

@@ -1,23 +1,23 @@
 // For format details, see https://aka.ms/devcontainer.json. For config options, see the
 // README at: https://github.com/devcontainers/templates/tree/main/src/ruby
 {
-	"name": "phlex-icons",
-	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-	"image": "ghcr.io/rails/devcontainer/images/ruby:3.3.4",
+  "name": "phlex-icons",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "ghcr.io/rails/devcontainer/images/ruby:3.4.7",
 
-	// Features to add to the dev container. More info: https://containers.dev/features.
-	"features": {
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
     "ghcr.io/jungaretti/features/vim": {}
   },
 
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	// "forwardPorts": [],
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
 
-	// Use 'postCreateCommand' to run commands after the container is created.
-	"postCreateCommand": ".devcontainer/setup.sh",
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": ".devcontainer/setup.sh",
 
-	// Configure tool-specific properties.
-	"customizations": {
+  // Configure tool-specific properties.
+  "customizations": {
     "vscode": {
       "settings": {
         "workbench": {
@@ -48,6 +48,6 @@
     }
   }
 
-	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-	// "remoteUser": "root"
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
 }

data/.ruby-version

@@ -1 +1 @@
-3.3.4
+3.4.7

data/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "Shopify.ruby-lsp",
+    "eamodio.gitlens",
+    "hverlin.mise-vscode",
+    "vscode-icons-team.vscode-icons",
+    "waderyan.gitblame"
+  ]
+}

data/.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+  "workbench.iconTheme": "vscode-icons",
+  "editor.formatOnSave": true,
+  "editor.quickSuggestions": {
+    "strings": "on"
+  },
+  "[ruby]": {
+    "editor.defaultFormatter": "Shopify.ruby-lsp",
+    "editor.formatOnSave": true,
+    "editor.tabSize": 2,
+    "editor.insertSpaces": true,
+    "editor.semanticHighlighting.enabled": true,
+    "editor.formatOnType": true
+  },
+  "rubyLsp.rubyVersionManager": {
+    "identifier": "mise"
+  },
+  "rubyLsp.formatter": "rubocop_internal",
+  "mise.configureExtensionsAutomaticallyIgnoreList": [
+    "ms-vscode.js-debug"
+  ]
+}

data/README.md

@@ -10,23 +10,25 @@
 
 # PhlexIcons
 
-General icons extension for [Phlex](https://phlex.fun). Includes more than 🎨 14,500 icons from:
-- [Bootstrap Icons](https://icons.getbootstrap.com) (2,000+)
+PhlexIcons brings 19,250+ SVG icons to [Phlex](https://phlex.fun) through a single, consistent API:
+- [Bootstrap Icons](https://icons.getbootstrap.com) (2,050+)
 - [Flag Icons](https://flagicons.lipis.dev) (250+)
 - [Heroicons](https://heroicons.com) (300+)
-- [Lucide Icons](https://lucide.dev/icons) (1,500+)
+- [Hugeicons](https://hugeicons.com) (4,450+)
+- [Lucide Icons](https://lucide.dev/icons) (1,600+)
 - [Material Design Icons](https://fonts.google.com/icons?icon.style=Filled&icon.set=Material+Icons) (2,100+)
 - [RadixUI Icons](https://radix-ui.com/icons) (300+)
-- [Remix Icons](https://remixicon.com) (3,000+)
-- [Tabler Icons](https://tabler.io/icons) (4,900+)
+- [Remix Icons](https://remixicon.com) (3,050+)
+- [Tabler Icons](https://tabler.io/icons) (4,950+)
 
-And happy to extend to other icon packs!
+More packs can be added over time.
 
-If you don't want to add all icon packs to your application, you can add a specific icon pack by using one (or multiple) of the following gems:
+Prefer not to include every pack? Install only the packs you need with these gems:
 
 - [phlex-icons-bootstrap](https://rubygems.org/gems/phlex-icons-bootstrap)
 - [phlex-icons-flag](https://rubygems.org/gems/phlex-icons-flag)
 - [phlex-icons-hero](https://rubygems.org/gems/phlex-icons-hero)
+- [phlex-icons-huge](https://rubygems.org/gems/phlex-icons-huge)
 - [phlex-icons-lucide](https://rubygems.org/gems/phlex-icons-lucide)
 - [phlex-icons-material](https://rubygems.org/gems/phlex-icons-material)
 - [phlex-icons-radix](https://rubygems.org/gems/phlex-icons-radix)
@@ -39,6 +41,16 @@ Other Phlex icon gems:
 - [phlex-remixicon](https://github.com/danieldocki/phlex-remixicon)
 - [phlex-lucide](https://github.com/akodkod/phlex-lucide)
 
+## Features
+
+- **Unified API**: One way to render icons across all supported packs.
+- **Use everything or just a pack**: Depend on the main gem or install per-pack gems.
+- **Configurable defaults**: Global defaults and per-pack variants.
+- **Works anywhere Phlex works**: With `Phlex::Kit` or plain Phlex components.
+- **Rails helper**: Simple `phlex_icon` helper (name is configurable).
+- **Custom icons**: Add your own icons alongside built-in packs.
+- **Kept up-to-date**: Auto-generated packs and weekly updates.
+
 ## Installation
 
 Install the gem and add it to the application's Gemfile by executing:
@@ -53,9 +65,26 @@ If bundler is not being used to manage dependencies, install the gem by executin
 gem install phlex-icons
 ```
 
+## Quick start
+
+```ruby
+require 'phlex-icons' # Not needed in Rails apps; Bundler will require it.
+
+class IconsDemo < Phlex::HTML
+  include PhlexIcons
+
+  def view_template
+    div do
+      Hero::Home(variant: :solid, class: 'w-6 h-6')
+      Icon('bootstrap/house', class: 'w-6 h-6') # string form
+    end
+  end
+end
+```
+
 ## Configuration
 
-The gem provides global configuration options, and per icons pack configuration options.
+The gem provides global configuration options and per-pack options.
 
 ### Global configuration
 
@@ -101,6 +130,10 @@ end
 PhlexIcons::Hero.configuration.default_variant = :solid # or :outline
 ```
 
+### Hugeicons configuration
+
+Nothing to configure for Hugeicons, as we are providing only the free stroke variant.
+
 ### Lucide Icons configuration
 
 Nothing to configure for Lucide Icons.
@@ -144,7 +177,7 @@ PhlexIcons::Tabler.configuration.default_variant = :outline # or :filled
 ```ruby
 require 'phlex-icons' # No need to require the gem if you are using it in a Rails application.
 
-class PhlexIcons < Phlex::HTML
+class IconsDemo < Phlex::HTML
   include PhlexIcons
 
   def view_template
@@ -152,6 +185,7 @@ class PhlexIcons < Phlex::HTML
       Bootstrap::House(class: 'size-4')
       Flag::Sa(variant: :rectangle, class: 'size-4')
       Hero::Home(variant: :solid, class: 'size-4')
+      Huge::Home08(variant: :stroke, class: 'size-4')
       Lucide::House(class: 'size-4')
       Material::House(variant: :filled, class: 'size-4')
       Radix::Home(class: 'size-4')
@@ -170,12 +204,13 @@ end
 ```ruby
 require 'phlex-icons' # No need to require the gem if you are using it in a Rails application.
 
-class PhlexIcons < Phlex::HTML
+class IconsDemo < Phlex::HTML
   def view_template
     div do
       render PhlexIcons::Bootstrap::House.new(class: 'size-4')
       render PhlexIcons::Flag::Sa.new(variant: :rectangle, class: 'size-4')
       render PhlexIcons::Hero::Home.new(variant: :solid, class: 'size-4')
+      render PhlexIcons::Huge::Home08.new(variant: :stroke, class: 'size-4')
       render PhlexIcons::Lucide::House.new(class: 'size-4')
       render PhlexIcons::Material::House.new(variant: :filled, class: 'size-4')
       render PhlexIcons::Radix::Home.new(class: 'size-4')
@@ -183,7 +218,7 @@ class PhlexIcons < Phlex::HTML
       render PhlexIcons::Tabler::Home.new(variant: :filled, class: 'size-4')
 
       # or with a string
-      render PhlexIcons::Icon('bootstrap/house', class: 'size-4')
+      render PhlexIcons::Icon.new('bootstrap/house', class: 'size-4')
     end
   end
 end
@@ -191,9 +226,11 @@ end
 
 ### Rails View Helper
 
-`phlex-icons` provides a convenient helper method to render icons directly in your ERB or Phlex views.
+PhlexIcons 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 it is configurable. You can change it by configuring `PhlexIcons.configuration.helper_method_name`.
 
-By default, the helper method is named `phlex_icon`, but is configurable.
+To use the helper method inside Phlex views/components, you need to register it in your base component (Or any other component) using `register_output_helper`.
 
 ```erb
 <%# Render a Bootstrap house icon with default size %>
@@ -217,15 +254,15 @@ By default, the helper method is named `phlex_icon`, but is configurable.
 
 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'`
+- 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)
+### Use only specific packs
 
-Let's say you want to use only Heroicons and Flag Icons, you can use the following gems:
+For example, to use only Heroicons and Flag Icons, add:
 - [phlex-icons-flag](https://rubygems.org/gems/phlex-icons-flag)
 - [phlex-icons-hero](https://rubygems.org/gems/phlex-icons-hero)
 
@@ -252,12 +289,12 @@ class PhlexIcons < Phlex::HTML
 end
 ```
 
-### Add custom icons to your Rails application
+### Add custom icons (Rails)
 
-You can extend the gem in your Rails application to add new icons by creating a `phlex-icons/custom` directory inside `views/components` directory. Then, you can create a new component for each icon you want to add. For example:
+To add your own icons in a Rails app, create a `phlex_icons/custom` directory under `app/components`, then create one component per icon. For example:
 
 ```ruby
-# app/views/components/phlex-icons/custom/icon_class_name.rb
+# app/components/phlex_icons/custom/icon_class_name.rb
 
 module PhlexIcons
   module Custom
@@ -270,33 +307,23 @@ module PhlexIcons
 end
 ```
 
-Finally, you will need to create a `PhlexIcons::Custom` module in `phlex-icons/custom.rb` file to include your custom icons and make them a `Phlex::Kit`:
-
-```ruby
-# app/views/components/phlex-icons/custom.rb
-
-module PhlexIcons
-  module Custom
-    extend Phlex::Kit
-  end
-end
-```
-
 Now, you can use your custom icons like any other icon pack as described above.
 
 ## Update icon packs
 
-All icon packs provided in this gem are auto-generated by their generator under [`generators`](/generators) directory. You just need to clone the repo and run the generator for the icon pack you want to update. Also, there is a GitHub Action that will run the generator for all icon packs and update the gem weekly on each Friday.
+All packs are generated from the scripts under [`generators`](/generators). Clone the repo and run the relevant generator to update a pack. A GitHub Action also regenerates all packs weekly and ships updates.
 
-## What is the icon pack version used in the gem?
+## Icon pack versions
 
-Each icon pack contains a `VERSION` constant in its module represents the version of the icon pack used in the gem. So, for example, to get the Bootstrap version used in the gem you can access it by `PhlexIcons::Bootstrap::VERSION`.
+Each pack exposes a `VERSION` constant indicating the source version used by the gem. For example: `PhlexIcons::Bootstrap::VERSION`.
 
 ## Development
 
-After checking out the repo, open it in VSCode and click `Reopen in Container` to start a development container. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, open it in VS Code and choose `Reopen in Container` to start a development container. Then run `rake spec` to execute tests. Use `bin/console` to experiment interactively.
+
+If you prefer not to use the dev container, install Mise and run `mise trust && mise install` to set up dependencies.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem locally, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, then run `bundle exec rake release` to tag, push, and publish the gem to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 

data/generators/huge.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+
+REPO_URL = 'https://github.com/hugeicons/hugeicons-static.git'
+REPO_NAME = 'hugeicons-static'
+ICONS_PACK_MODULE_PATH = 'lib/phlex-icons/huge.rb'
+ICONS_PACK_PATH = 'lib/phlex-icons/huge'
+VARIANTS = %i[stroke].freeze
+
+TEMPLATE = ERB.new <<~TEMPLATE
+  # frozen_string_literal: true
+
+  # rubocop:disable #{ROBOCOP_DISABLE_WARNINGS}
+  module PhlexIcons
+    module Huge
+      class <%= icon_name %> < Base
+        def stroke
+          <%= stroke_icon %>
+        end
+      end
+    end
+  end
+  # rubocop:enable #{ROBOCOP_DISABLE_WARNINGS}
+TEMPLATE
+
+VARIANT_TEMPLATE = ERB.new <<~VARIANT_TEMPLATE
+  # frozen_string_literal: true
+
+  # rubocop:disable #{ROBOCOP_DISABLE_WARNINGS}
+  module PhlexIcons
+    module Huge
+      class <%= icon_name %><%= variant.to_s.capitalize %> < Base
+        def view_template
+          render <%= icon_name %>.new(variant: :<%= variant %>, **attrs)
+        end
+      end
+    end
+  end
+  # rubocop:enable #{ROBOCOP_DISABLE_WARNINGS}
+VARIANT_TEMPLATE
+
+REPLACEMENTS = {
+  '1st-' => 'first-',
+  '2nd-' => 'second-',
+  '3rd-' => 'third-',
+  '3-d-' => 'three-d-',
+  '3d-' => 'three-d-',
+  '4k' => 'four-k',
+  '7z-' => 'seven-z-',
+  'comment ' => 'comment-',
+  'image-flip ' => 'image-flip'
+}.freeze
+
+def main
+  run_generator do
+    new_version = JSON.parse(File.read("generators/#{REPO_NAME}/package.json"))['version']
+    update_icon_path_version(new_version)
+
+    icon_file_names.tqdm.each { create_icon_component(_1) }
+  end
+end
+
+def icon_file_names
+  Dir.glob("generators/#{REPO_NAME}/icons/*").map { |file| File.basename(file) }
+end
+
+def create_icon_component(icon_file_name)
+  File.write(
+    File.join(ICONS_PACK_PATH, component_file_name(icon_file_name, REPLACEMENTS)),
+    TEMPLATE.result_with_hash(
+      icon_name: component_class_name(icon_file_name, REPLACEMENTS),
+      stroke_icon: read_and_convert_icon(stroke_icon_file_path(icon_file_name))
+    )
+  )
+
+  VARIANTS.each do |variant|
+    File.write(
+      File.join(ICONS_PACK_PATH, variant_component_file_name(icon_file_name, variant, REPLACEMENTS)),
+      VARIANT_TEMPLATE.result_with_hash(
+        icon_name: component_class_name(icon_file_name, REPLACEMENTS),
+        variant: variant
+      )
+    )
+  end
+end
+
+def read_and_convert_icon(icon_file_path)
+  icon_file_content = File.read(icon_file_path)
+                          .sub('width="24"', '')
+                          .sub('height="24"', '')
+
+  Phlexing::Converter.convert(icon_file_content).sub('svg(', "svg(\n**attrs,")
+end
+
+def stroke_icon_file_path(icon_file_name)
+  "generators/#{REPO_NAME}/icons/#{icon_file_name}"
+end
+
+main if __FILE__ == $PROGRAM_NAME

data/lib/phlex-icons/railtie.rb

@@ -9,7 +9,15 @@ module PhlexIcons
         helper_method_name = PhlexIcons.configuration.helper_method_name
 
         define_method helper_method_name do |name, **options|
-          PhlexIcons::Icon.call(name, **options)&.html_safe
+          component, fiber_id = Thread.current[:__phlex_component__]
+
+          if component && fiber_id == Fiber.current.object_id
+            component.instance_exec { render PhlexIcons::Icon.new(name, **options) }
+
+            nil
+          else
+            PhlexIcons::Icon.call(name, **options)&.html_safe
+          end
         end
       end
     end

data/lib/phlex-icons/version.rb

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

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4.7"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: phlex-icons-remix
 version: !ruby/object:Gem::Version
-  version: 2.40.0
+  version: 2.41.0
 platform: ruby
 authors:
 - Ali Hamdi Ali Fadel
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -24,7 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.11'
-description:
 email:
 - aliosm1997@gmail.com
 executables: []
@@ -36,6 +34,8 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
+- ".vscode/extensions.json"
+- ".vscode/settings.json"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
@@ -45,6 +45,7 @@ files:
 - generators/flag.rb
 - generators/helper.rb
 - generators/hero.rb
+- generators/huge.rb
 - generators/lucide.rb
 - generators/material.rb
 - generators/radix.rb
@@ -3117,6 +3118,7 @@ files:
 - lib/phlex-icons/remix/zzz_fill.rb
 - lib/phlex-icons/remix/zzz_line.rb
 - lib/phlex-icons/version.rb
+- mise.toml
 - phlex-icons.png
 - sig/phlex/icons.rbs
 homepage: https://github.com/AliOsm/phlex-icons
@@ -3128,7 +3130,6 @@ metadata:
   source_code_uri: https://github.com/AliOsm/phlex-icons
   changelog_uri: https://github.com/AliOsm/phlex-icons/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -3143,8 +3144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Remix icons library for Phlex
 test_files: []