ascona 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e552faf28b1003107b30f7a4cfa0463d50eeba70c3d4c54b7cf7da216e4e6a37
-  data.tar.gz: c920983c5eead44035bf32df7741951778131df9450d66ef256568c2adffb183
+  metadata.gz: e82c6a0457f3bf0faf2b1f16d86672d6eea193cb73b52ac8270fb051adc317dc
+  data.tar.gz: 8e1c0d4150d0f02189a08b4b6df7e7ba73b9e1ef6938d18f53d9104cc27e86ba
 SHA512:
-  metadata.gz: 815c00c080456a6bfcf54a85104e91cd702f80f784b856a9398e3630245a9e30cf7e7a2d9141988566f8f71337ecc4d4a92be487d835acfef8cb8078232e1d0b
-  data.tar.gz: 276f173cd17cb4a93da418dedebb1fbbe75ccaad00ee14895cebe79b7c35e0c0295e4de6b33e4956e2a97ea77479ce40e90fe53f7871111e4a3efc7438cc7a41
+  metadata.gz: 238499050f9d7ad71f179273f6b43dab26e792486f5f0c01fa63bc0ab0e1ffc6989803639483c6679ad4ff302a6fd5e828379d8a6d269879e87e0ff6687a8e3e
+  data.tar.gz: 288b759f528fdd142c5fc33c83ed327869d883fffb5025c4ec42c1b141314c4a3a658f84a2768cc71b7d21e3d03271056d6a4221623c58f474f3889f80dcfff8

data/README.md

@@ -93,6 +93,19 @@ config.default_variants = { heroicons: :outline }
 
 Note: Some libraries have no default variant. You must specify one when downloading (`--variant=outline`) and when rendering (`variant: :outline`) unless set in config.
 
+## External Mode
+
+By default, icons are inlined as SVG markup. For pages with many icons, use `external: true` to render `<img>` tags instead. This keeps the HTML lightweight and lets the browser cache icons individually.
+
+```erb
+<%= icon "star", external: true %>
+<%= icon "ch", library: :flags, external: true, class: "h-8 w-8" %>
+```
+
+External mode uses Rails' `image_path`, so icons are automatically served from your configured `asset_host` (e.g. a CDN).
+
+**Tradeoff:** External icons can't be styled with CSS properties like `currentColor`. Use inline (default) for UI icons that need to match text color, and external for decorative icons like flags.
+
 ## Non-Rails
 
 Include the helper manually:

data/lib/ascona/helper.rb

@@ -2,26 +2,37 @@
 
 module Ascona
   module Helper
-    def icon(name, library: nil, variant: nil, size: nil, **attributes)
+    def icon(name, library: nil, variant: nil, size: nil, external: false, **attributes)
       library ||= Ascona.configuration.default_library
       raise ArgumentError, "No library specified and no default set" unless library
 
-      variant ||= Ascona.configuration.default_variants[library.to_sym]
-      svg = Ascona.registry.get(name.to_sym, library: library.to_sym, variant: variant)
-      raise ArgumentError, "Icon '#{name}' not found in library '#{library}'" unless svg
-
       size ||= Ascona.configuration.default_size
       if size
         size_class = "w-#{size} h-#{size}"
         attributes[:class] = attributes[:class] ? "#{attributes[:class]} #{size_class}" : size_class
       end
 
+      if external
+        return icon_external(name, library: library, variant: variant, **attributes)
+      end
+
+      variant ||= Ascona.configuration.default_variants[library.to_sym]
+      svg = Ascona.registry.get(name.to_sym, library: library.to_sym, variant: variant)
+      raise ArgumentError, "Icon '#{name}' not found in library '#{library}'" unless svg
+
       svg = inject_attributes(svg, attributes) unless attributes.empty?
       svg.html_safe
     end
 
     private
 
+    def icon_external(name, library:, variant: nil, **attributes)
+      path = variant ? "#{library}/#{variant}/#{name}.svg" : "#{library}/#{name}.svg"
+      attributes[:alt] ||= name.to_s
+      attributes[:src] = image_path(path)
+      tag.img(**attributes)
+    end
+
     def inject_attributes(svg, attributes)
       attrs_string = attributes.map { |k, v| %(#{k.to_s.gsub("_", "-")}="#{v}") }.join(" ")
       svg.sub("<svg", "<svg #{attrs_string}")

data/lib/ascona/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ascona
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ascona
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Samuenti
@@ -69,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Use SVG icons in Ruby
 test_files: []