kozenet_ui 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1e2e8b54a360d5a3d0e6adb313c7b622f95d604d45313f05bd4f11dcb80546b
-  data.tar.gz: c112ab997c36542a6b7ae9e1c2e16687948b1cbd6d3e4176ba5be6cf17087524
+  metadata.gz: 630f1277f958277505d69a7087f698c54772615ce49b5e461127f252a18d532f
+  data.tar.gz: 826562e84fcc99ae538683cbdf7685dd0065908eed308c6a58ec0ed9261a1371
 SHA512:
-  metadata.gz: e792e18445663e57457a3f459f35141cad5609b6358d75b7856d22aef034be4b810bad6de2131a3226d4e7c53f6d0f0493c8b4b8e9c967bd2741640b1eff05c5
-  data.tar.gz: '029ab38c64adb66d73c59a4cb7915d95124b943f36d118c69e2600224e3367587f1177bfbd08e7c3e28208943d41cebf26efc43b23d18e24a1407c2b877685a0'
+  metadata.gz: 7c06c46de9012183f644f314cfc60f58099369696a30b25b83ab5a10aff6fdb5f62f9d6f27c988002a7c36ad44d796b83fa9a721b63d36a727bf85fba0bc6910
+  data.tar.gz: 356c12469d4f01569fc86ea4e46b036fd78f3c051c60daa0a1cc26e70761039f59f414bf60cde3fb9a215b7f8ee2a261fd9f833bb0d6a4e3a841c5aca485a843

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.1.5] - 2025-10-31
+
+- Feature: Robust icon helper now supports both heroicon and asset-based SVGs, with automatic fallback and variant/class support
+- Fix: Header/action button icon rendering is now more flexible and compatible with heroicon
+- Chore: Improved test coverage for icon rendering
+
+
+## [0.1.4] - 2025-01-01
+
+- Fix: better stylesheet management 
+
 ## [0.1.1] - 2025-10-31
 
 - Fix: Ensure all Kozenet UI CSS files are available in the asset pipeline for all Rails setups (improved asset paths and precompile logic in engine).

data/app/components/kozenet_ui/header_component/action_button_component.rb

@@ -22,7 +22,10 @@ module KozenetUi
       end
 
       def render_icon(icon)
-        ApplicationController.helpers.kozenet_ui_icon(icon, class: "kz-action-btn-icon") if icon
+        return unless icon
+
+        icon_name = icon.to_s.tr("_", "-").to_sym
+        ApplicationController.helpers.kozenet_ui_icon(icon_name, class: "kz-action-btn-icon")
       end
     end
   end

data/app/helpers/kozenet_ui/icon_helper.rb

@@ -3,9 +3,26 @@
 module KozenetUi
   # Helper methods for rendering SVG icons in Kozenet UI
   module IconHelper
-    # Renders a Heroicon SVG from the gem's assets
-    # Usage: kozenet_ui_icon(:cart, class: "w-5 h-5 text-gray-500")
     def kozenet_ui_icon(name, options = {})
+      heroicon_name = normalize_icon_name(name)
+      return render_heroicon(heroicon_name, options) if defined?(heroicon)
+
+      render_fallback_icon(name, options)
+    end
+
+    private
+
+    def normalize_icon_name(name)
+      name.to_s.tr("_", "-").to_sym
+    end
+
+    def render_heroicon(name, options)
+      heroicon(name, **options)
+    rescue StandardError
+      render_fallback_icon(name, options)
+    end
+
+    def render_fallback_icon(name, options)
       app_path = "icons/#{name}.svg"
       gem_path = "kozenet_ui/icons/#{name}.svg"
       app_full_path = Rails.root.join("app/assets/images", app_path)

data/lib/generators/kozenet_ui/install/install_generator.rb

@@ -5,6 +5,7 @@ require "rails/generators/base"
 module KozenetUi
   module Generators
     # Generator for installing Kozenet UI into a Rails application
+    # Copies stylesheets, creates initializer, and updates application CSS
     class InstallGenerator < Rails::Generators::Base
       source_root File.expand_path("templates", __dir__)
 
@@ -14,53 +15,130 @@ module KozenetUi
         template "kozenet_ui.rb", "config/initializers/kozenet_ui.rb"
       end
 
-      def copy_css_files_to_app
-        # do NOT copy CSS files to the app. Let the gem expose them via the asset pipeline.
-        say "Kozenet UI stylesheets are now available via the asset pipeline. " \
-            "Import them in your Tailwind/application.css:", :green
-        say "\n@import 'kozenet_ui/tokens.css';\n@import 'kozenet_ui/base.css';" \
-            "\n@import 'kozenet_ui/components.css';\n", :cyan
+      def copy_stylesheets
+        say "📦 Copying Kozenet UI stylesheets...", :blue
+        setup_directories
+        copy_main_stylesheets
+        copy_component_stylesheets
+        say "✅ Stylesheets copied successfully!", :green
       end
 
-      # rubocop:disable Metrics/MethodLength
       def add_stylesheets_to_application
-        tailwind_css = nil
-        tailwind_css = "app/assets/stylesheets/application.css" if File.exist?("app/assets/stylesheets/application.css")
-
-        if tailwind_css
-          content = File.read(tailwind_css)
-          kozenet_imports = "\n/* Kozenet UI Styles */\n" \
-            "@import 'kozenet_ui/tokens.css';\n" \
-            "@import 'kozenet_ui/base.css';\n" \
-            "@import 'kozenet_ui/components.css';\n"
-
-          if content.include?("kozenet_ui/base.css")
-            say "File unchanged! Kozenet UI styles already present in #{tailwind_css}", :yellow
-          else
-            append_to_file tailwind_css, kozenet_imports
-            say "Appended Kozenet UI styles to #{tailwind_css}", :green
-          end
+        css_file = find_application_css
+        return warn_no_css_file unless css_file
+
+        update_css_file(css_file)
+      end
+
+      def show_readme
+        display_success_message
+      end
+
+      private
+
+      def setup_directories
+        dest_dir = Rails.root.join("app/assets/stylesheets/kozenet_ui")
+        FileUtils.mkdir_p(dest_dir)
+        FileUtils.mkdir_p(dest_dir.join("components"))
+      end
+
+      def copy_main_stylesheets
+        %w[tokens.css base.css components.css].each do |file|
+          copy_stylesheet_file(file)
+        end
+      end
+
+      def copy_component_stylesheets
+        component_files = Dir.glob(File.join(gem_stylesheets_path, "components", "*.css"))
+        component_files.each { |src| copy_component_file(src) }
+      end
+
+      def copy_stylesheet_file(filename)
+        src = File.join(gem_stylesheets_path, filename)
+        dest = Rails.root.join("app/assets/stylesheets/kozenet_ui", filename)
+
+        if File.exist?(src)
+          FileUtils.cp(src, dest)
+          say "  ✓ Copied #{filename}", :green
         else
-          say "Could not find app/assets/stylesheets/application.css. " \
-              "Please manually import Kozenet UI stylesheets.", :yellow
+          say "  ✗ #{filename} not found!", :red
         end
       end
-      # rubocop:enable Metrics/MethodLength
 
-      def show_readme
-        say "\n✅ Kozenet UI installed successfully!", :green
+      def copy_component_file(src_path)
+        filename = File.basename(src_path)
+        dest = Rails.root.join("app/assets/stylesheets/kozenet_ui/components", filename)
+        FileUtils.cp(src_path, dest)
+        say "  ✓ Copied components/#{filename}", :green
+      end
+
+      def gem_stylesheets_path
+        @gem_stylesheets_path ||= begin
+          gem_spec = Gem::Specification.find_by_name("kozenet_ui")
+          File.join(gem_spec.gem_dir, "app/assets/stylesheets/kozenet_ui")
+        end
+      end
+
+      def find_application_css
+        %w[
+          app/assets/stylesheets/application.tailwind.css
+          app/assets/stylesheets/application.css
+        ].find { |path| File.exist?(path) }
+      end
+
+      def update_css_file(css_file)
+        content = File.read(css_file)
+
+        if content.include?("kozenet_ui/base.css")
+          say "File unchanged! Kozenet UI styles already present", :yellow
+        else
+          append_to_file css_file, stylesheet_imports
+          say "✅ Added imports to #{css_file}", :green
+        end
+      end
+
+      def stylesheet_imports
+        <<~CSS
+
+          /* Kozenet UI Styles */
+          @import "kozenet_ui/tokens.css";
+          @import "kozenet_ui/base.css";
+          @import "kozenet_ui/components.css";
+        CSS
+      end
+
+      def warn_no_css_file
+        say "⚠️  Could not find application CSS file", :yellow
+        say "Add these imports manually:", :yellow
+        say stylesheet_imports.strip, :cyan
+      end
+
+      def display_success_message
+        say_header
+        say_next_steps
+        say_documentation
+      end
+
+      def say_header
+        say "\n#{"=" * 60}", :green
+        say "✅ Kozenet UI installed successfully!", :green
+        say ("=" * 60).to_s, :green
+      end
+
+      def say_next_steps
         say "\nNext steps:", :cyan
-        say "  1. Add <%= kozenet_ui_theme_variables_tag %> to your layout <head>"
-        say "  2. Customize colors in config/initializers/kozenet_ui.rb"
-        say "  3. Start using components: <%= kz_button { 'Click me' } %>"
-        say "\nDocumentation: https://github.com/kozenetpro/kozenet_ui\n"
+        say "  1. Add to layout <head>:", :white
+        say "     <%= kozenet_ui_theme_variables_tag %>", :yellow
+        say "\n  2. Restart server:", :white
+        say "     bin/dev", :yellow
+        say "\n  3. Use components:", :white
+        say "     <%= kz_button { 'Click me' } %>", :yellow
+        say "\n  4. Customize colors:", :white
+        say "     config/initializers/kozenet_ui.rb", :yellow
       end
 
-      def install
-        create_initializer
-        copy_css_files_to_app
-        add_stylesheets_to_application
-        show_readme
+      def say_documentation
+        say "\n📚 Documentation: https://github.com/kozenetpro/kozenet_ui\n\n", :blue
       end
     end
   end

data/lib/kozenet_ui/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kozenet_ui
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Kozenet Pro
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2025-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: color
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rails_heroicon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
@@ -218,10 +232,11 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
-description: "Kozenet UI is a modern, production-ready component library for Ruby
-  on Rails. \nBuilt with ViewComponent and Tailwind CSS, it provides beautiful, accessible,
-  \nand customizable UI components with dynamic theming support. Features CSP-compliant
-  \nstyling, dark mode, and smooth animations.\n"
+description: |
+  Kozenet UI is a modern, production-ready component library for Ruby on Rails.
+  Built with ViewComponent and Tailwind CSS, it provides beautiful, accessible,
+  and customizable UI components with dynamic theming support. Features CSP-compliant
+  styling, dark mode, and smooth animations.
 email:
 - kozenetpro@gmail.com
 executables: []