ascona 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b96a8fcfad2c493ef7b0b877f6bde8054df80730b3738600fbb8400fb3f9fbbf
-  data.tar.gz: 123eda091efa88ea12fc891d98481c8cfc44efd7ec7b3f80bd51ec2474f79ec2
+  metadata.gz: e82c6a0457f3bf0faf2b1f16d86672d6eea193cb73b52ac8270fb051adc317dc
+  data.tar.gz: 8e1c0d4150d0f02189a08b4b6df7e7ba73b9e1ef6938d18f53d9104cc27e86ba
 SHA512:
-  metadata.gz: ba8095738e7ea2f19652e3922f9d9512380bd928c33910e739a4d92ce292bfea828823513b735bd3c6ccdc7f4a2e9b45422ae2ade0f91c25407bbed7940dcf9c
-  data.tar.gz: 18ee8bdcf4f298e03d061e8432b43f6500bbcc59f32773310c7fc82a641e3c05f4782abd03f1e4f8b02b39477f2bc4427f21f238c64d1969ea32744a7fbbdae1
+  metadata.gz: 238499050f9d7ad71f179273f6b43dab26e792486f5f0c01fa63bc0ab0e1ffc6989803639483c6679ad4ff302a6fd5e828379d8a6d269879e87e0ff6687a8e3e
+  data.tar.gz: 288b759f528fdd142c5fc33c83ed327869d883fffb5025c4ec42c1b141314c4a3a658f84a2768cc71b7d21e3d03271056d6a4221623c58f474f3889f80dcfff8

data/.github/workflows/push_gem.yml

@@ -0,0 +1,28 @@
+name: Push Gem
+
+on:
+  push:
+    tags:
+      - v*
+
+permissions:
+  contents: read
+
+jobs:
+  push:
+    if: github.repository == 'samuenti/ascona'
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+          ruby-version: ruby
+
+      - uses: rubygems/release-gem@v1

data/README.md

@@ -66,11 +66,22 @@ The name of the folder will be used as the library name.
 
 ```erb
 <%= icon "star" %>
+<%= icon "star", size: 5 %>
 <%= icon "star", class: "w-5 h-5" %>
 <%= icon "star", library: :heroicons, variant: :outline %>
 ```
 
-Attributes are added directly to the `<svg>` tag.
+The `size` option adds Tailwind classes `w-{size} h-{size}`.
+
+## Default Size
+
+Set a default size for all icons:
+
+```ruby
+config.default_size = 5
+```
+
+Icons without an explicit `size` will use this default.
 
 ## Variants
 
@@ -82,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/configuration.rb

@@ -2,12 +2,13 @@
 
 module Ascona
   class Configuration
-    attr_accessor :icon_path, :default_library, :default_variants
+    attr_accessor :icon_path, :default_library, :default_variants, :default_size
 
     def initialize
       @icon_path = "app/assets/icons"
       @default_library = nil
       @default_variants = {}
+      @default_size = nil
     end
   end
 end

data/lib/ascona/helper.rb

@@ -2,10 +2,20 @@
 
 module Ascona
   module Helper
-    def icon(name, library: nil, variant: 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
 
+      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
@@ -16,6 +26,13 @@ module Ascona
 
     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.1"
+  VERSION = "0.1.3"
 end

data/lib/generators/ascona/templates/initializer.rb

@@ -6,4 +6,7 @@ Ascona.configure do |config|
 
   # Set default variants per library (only for libraries with variants):
   # config.default_variants = { heroicons: :outline }
+
+  # Set default size for all icons (uses Tailwind classes w-{size} h-{size}):
+  # config.default_size = 5
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ascona
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Samuenti
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-04 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -32,6 +31,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/push_gem.yml"
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -55,7 +55,6 @@ metadata:
   homepage_uri: https://github.com/samuenti/ascona
   source_code_uri: https://github.com/samuenti/ascona
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -70,8 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Use SVG icons in Ruby
 test_files: []