railsglyphs 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0a23c4b18acfe00c2a6486291700489bd80156bf929e6dea279593f62256c67c
+  data.tar.gz: 59d535e3009fe32d8d4fb20b7613b245f25287b1f450704b69ba91763ceabdff
+SHA512:
+  metadata.gz: b2754fe87b0c34d7f285118442234a2749082a368bac6a730d18832652218115b9add22d225c35dbfdb522888b1dc3cc90b3942ebc46ab0e4118c04d35968576
+  data.tar.gz: b0503a41316ea08a90495f06c64c7197e295142fcecd04f0533b565175bf884dcf6c194399a173f6e2ef0d9facfcfb04b45afa2265fb82ec992cb9cdffed2c17

data/lib/railsglyphs/icon_helper.rb

@@ -0,0 +1,49 @@
+require "erb"
+require 'digest'
+
+module Railsglyphs
+  module IconHelper
+    ICON_CACHE = {}
+
+    # Returns the absolute path to the gem's asset directory
+    def self.gem_asset_path
+      File.expand_path("../../assets/icons", __dir__)
+    end
+
+    # Optionally allow the icon path to be overridden in the host app
+    def self.icon_base_path
+      @icon_base_path || gem_asset_path
+    end
+
+    def self.icon_base_path=(path)
+      @icon_base_path = path
+    end
+
+    def icon(style, name, text = nil, html_options = {})
+      text, html_options = nil, text if text.is_a?(Hash)
+      height = html_options[:size] || 24
+      width  = html_options[:size]  || 24
+      html_options.delete(:size)
+
+      svg_path = File.join(Railsglyphs::IconHelper.icon_base_path, style.to_s, "#{name}.svg")
+      raise ArgumentError, "Icon '#{name}' with style '#{style}' not found at #{svg_path}." unless File.exist?(svg_path)
+
+      cache_key = "#{style}-#{name}-#{Digest::MD5.hexdigest(text.to_s)}-#{height}-#{width}"
+
+      svg_content = ICON_CACHE[cache_key] ||= begin
+        svg = File.read(svg_path)
+        svg.gsub!("<svg", "<svg style=\"display: inline-block;\" height=\"#{height}\" width=\"#{width}\"")
+        svg.html_safe
+      end
+
+      if html_options[:class]
+        html_options[:class] = html_options[:class].strip
+      end
+      html_options['aria-hidden'] ||= true
+
+      html = content_tag(:i, svg_content, html_options)
+      html << ' ' << text.to_s unless text.blank?
+      html
+    end
+  end
+end

data/lib/railsglyphs/railtie.rb

@@ -0,0 +1,11 @@
+require "rails/railtie"
+
+module Railsglyphs
+  class Railtie < Rails::Railtie
+    initializer "railsglyphs.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Railsglyphs::IconHelper
+      end
+    end
+  end
+end

data/lib/railsglyphs/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RailsGlyphs
+  VERSION = "1.0.0"
+end

data/lib/railsglyphs.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require "railsglyphs/version"
+require "railsglyphs/icon_helper"
+require "railsglyphs/railtie" if defined?(Rails)

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: railsglyphs
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Victor S. Keenan
+bindir: bin
+cert_chain: []
+date: 2025-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: Simple helper utility for using SVG icons within your Rails project.
+email:
+- me@victorkeenan.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/railsglyphs.rb
+- lib/railsglyphs/icon_helper.rb
+- lib/railsglyphs/railtie.rb
+- lib/railsglyphs/version.rb
+homepage: https://www.victorkeenan.com/projects/railsglyphs/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.victorkeenan.com/projects/railsglyphs/
+  source_code_uri: https://github.com/VictorSK/railsglyphs/
+  changelog_uri: https://github.com/VictorSK/railsglyphs/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: Simple helper utility for using SVG icons within your Rails project.
+test_files: []