better_ui 0.5.0 → 0.5.1

data/app/helpers/better_ui/general/components/icon_helper.rb

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module IconHelper
+        def bui_icon(name = nil, **options)
+          render BetterUi::General::IconComponent.new(
+            name: name,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_icon, :bui_icon
+      end
+    end
+  end
+end 

data/app/helpers/better_ui/general/components/link_helper.rb

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module LinkHelper
+        def bui_link(label = nil, **options)
+          render BetterUi::General::LinkComponent.new(
+            label: label,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_link, :bui_link
+      end
+    end
+  end
+end 

data/app/helpers/better_ui/general/components/panel_helper.rb

@@ -0,0 +1,16 @@
+module BetterUi
+  module General
+    module Components
+      module PanelHelper
+        def bui_panel(**options, &block)
+          render BetterUi::General::PanelComponent.new(
+            **options
+          ), &block
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_panel, :bui_panel
+      end
+    end
+  end
+end 

data/app/helpers/better_ui/general/components/spinner_helper.rb

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module SpinnerHelper
+        def bui_spinner(label = nil, **options)
+          render BetterUi::General::SpinnerComponent.new(
+            label: label,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_spinner, :bui_spinner
+      end
+    end
+  end
+end 

data/app/helpers/better_ui/general/components/table_helper.rb

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module TableHelper
+        def bui_table(data = nil, **options, &block)
+          render BetterUi::General::TableComponent.new(
+            data: data,
+            **options
+          ), &block
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_table, :bui_table
+      end
+    end
+  end
+end 

data/app/helpers/better_ui/general_helper.rb

@@ -0,0 +1,15 @@
+module BetterUi
+  module GeneralHelper
+    # Inclusione di tutti i componenti general
+    include BetterUi::General::Components::ButtonHelper
+    include BetterUi::General::Components::IconHelper
+    include BetterUi::General::Components::LinkHelper
+    include BetterUi::General::Components::BadgeHelper
+    include BetterUi::General::Components::AvatarHelper
+    include BetterUi::General::Components::TableHelper
+    include BetterUi::General::Components::SpinnerHelper
+    include BetterUi::General::Components::HeadingHelper
+    include BetterUi::General::Components::PanelHelper
+    include BetterUi::General::Components::BreadcrumbHelper
+  end
+end 

data/app/helpers/better_ui_helper.rb

@@ -0,0 +1,12 @@
+module BetterUi
+  # Includi esplicitamente il GeneralHelper
+  require_relative 'better_ui/general_helper'
+  
+  module Helper
+    # Estendi il modulo con ActiveSupport::Concern per funzionalità helper
+    extend ActiveSupport::Concern
+    
+    # Includi gli helper disponibili
+    include BetterUi::GeneralHelper
+  end
+end 

data/config/routes.rb

@@ -1,15 +1,4 @@
 BetterUi::Engine.routes.draw do
-  # Route principale per la documentazione
-  root to: 'docs#index'
-  
-  # Route per le pagine di documentazione generiche
-  get 'docs/:page', to: 'docs#show', as: :docs_page
-  
-  # Route specifica per i componenti
-  get 'docs/components/:component', to: 'docs#component', as: :docs_component
-  
-  # Montaggio di Lookbook per lo sviluppo e il test
-  if Rails.env.development? || Rails.env.test?
-    mount Lookbook::Engine, at: "/lookbook"
-  end
+  # Montaggio di Lookbook come root
+  mount Lookbook::Engine, at: "/"
 end

data/lib/better_ui/engine.rb

@@ -3,43 +3,99 @@ require 'redcarpet'
 require 'tailwindcss-rails'
 require 'coderay'
 require 'font-awesome-sass'
-require 'lookbook'
-require 'listen'
-require 'action_cable'
+begin
+  require 'lookbook'
+rescue LoadError
+  # Lookbook non è richiesto, è una dipendenza opzionale
+end
+begin
+  require 'listen'
+rescue LoadError
+  # Listen non è richiesto, è una dipendenza opzionale
+end
+begin
+  require 'action_cable'
+rescue LoadError
+  # ActionCable non è richiesto, è una dipendenza opzionale
+end
 
 module BetterUi
+  # Engine Rails per Better UI
+  # Gestisce l'isolamento del namespace, le dipendenze, gli asset e le configurazioni
   class Engine < ::Rails::Engine
     isolate_namespace BetterUi
     
     # Configurazione per rendere disponibili gli assets all'applicazione host
     initializer 'better_ui.assets' do |app|
+      # Aggiungi i percorsi asset
       app.config.assets.paths << root.join('app', 'assets', 'stylesheets')
       app.config.assets.paths << root.join('app', 'assets', 'images')
+      app.config.assets.paths << root.join('app', 'assets', 'fonts')
+      
+      # Aggiungi i file SCSS e CSS alla precompilazione
+      if app.config.respond_to?(:assets)
+        app.config.assets.precompile += %w( 
+          better_ui/application.css
+          better_ui/components/*.css
+          better_ui/components/**/*.css
+          better_ui/components/index.css
+        )
+      end
+      
+      # Configurazione per Propshaft se disponibile
+      if defined?(Propshaft) && app.config.respond_to?(:asset_host)
+        app.config.asset_host = app.config.asset_host
+      end
     end
     
     # Assicuriamo che gli helper siano correttamente caricati
     config.autoload_paths << root.join('app', 'helpers')
+    config.eager_load_paths << root.join('app', 'helpers')
     
-    # Configurazione per rendere disponibili i componenti all'applicazione host
-    initializer 'better_ui.view_helpers' do
-      require_relative '../../app/helpers/better_ui_application_helper'
+    # Caricamento dei componenti helper
+    initializer 'better_ui.load_helpers', before: :load_config_initializers do
+      # Carica prima i componenti singoli
+      Dir.glob(root.join('app/helpers/better_ui/general/components/*.rb')).sort.each do |component|
+        require component
+      end
+      
+      # Poi carica il general_helper che li unisce tutti
+      require_relative '../../app/helpers/better_ui/general_helper' if File.exist?(root.join('app/helpers/better_ui/general_helper.rb'))
       
+      # Infine carica il modulo principale
+      require_relative '../../app/helpers/better_ui_helper' if File.exist?(root.join('app/helpers/better_ui_helper.rb'))
+    end
+    
+    # Configurazione per rendere disponibili i componenti all'applicazione host
+    initializer 'better_ui.view_helpers' do      
       ActiveSupport.on_load :action_controller do
-        helper BetterUi::ApplicationHelper
+        helper BetterUi::Helper if defined?(BetterUi::Helper)
       end
       
       ActiveSupport.on_load :action_view do
-        include BetterUi::ApplicationHelper
+        include BetterUi::Helper if defined?(BetterUi::Helper)
       end
     end
     
     # Configurazione per ViewComponent
+    config.view_component.preview_paths ||= []
     config.view_component.preview_paths << root.join('test', 'components', 'previews')
     
     # Configurazione per Lookbook in sviluppo e test
-    initializer 'better_ui.lookbook' do
-      if Rails.env.development? || Rails.env.test?
-        config.lookbook = Lookbook
+    if defined?(Lookbook)
+      initializer 'better_ui.lookbook' do
+        if Rails.env.development? || Rails.env.test?
+          config.lookbook = Lookbook
+        end
+      end
+    end
+    
+    # Configurazione per l'uso personalizzato dei componenti
+    initializer 'better_ui.custom_configuration', before: :load_config_initializers do |app|
+      app.config.to_prepare do
+        BetterUi.configure do |config|
+          # Configurazione di default, può essere sovrascritta dall'applicazione host
+        end
       end
     end
   end

data/lib/better_ui/version.rb

@@ -1,3 +1,3 @@
 module BetterUi
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

data/lib/better_ui.rb

@@ -21,9 +21,17 @@ module BetterUi
     def configure
       yield(configuration) if block_given?
     end
+    
+    # Metodo utile per accedere al percorso degli stilesheets
+    def stylesheets_path
+      File.join(File.dirname(__FILE__), '..', 'app', 'assets', 'stylesheets')
+    end
   end
 end
 
-# Caricamento del generator
+# Caricamento dei generator
 require 'rails/generators'
-require 'generators/better_ui/stylesheet_generator' if defined?(Rails::Generators)
+if defined?(Rails::Generators)
+  require 'generators/better_ui/stylesheet_generator'
+  require 'generators/better_ui/install_generator'
+end

data/lib/generators/better_ui/install_generator.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module Generators
+    # Generatore per l'installazione di Better UI in un'applicazione Rails
+    #
+    # Questo generatore:
+    # 1. Aggiunge le dipendenze necessarie
+    # 2. Monta l'engine nelle routes
+    # 3. Aggiunge gli asset all'applicazione
+    # 4. Crea un file di configurazione initializer
+    # 5. Genera i file di stile personalizzabili (opzionalmente)
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+      
+      desc "Installa Better UI nell'applicazione Rails"
+      
+      class_option :skip_routes, type: :boolean, default: false,
+                  desc: "Salta l'aggiunta del mount engine nelle routes"
+      class_option :skip_stylesheets, type: :boolean, default: false,
+                  desc: "Salta la generazione dei file di stile personalizzabili"
+      class_option :skip_config, type: :boolean, default: false,
+                  desc: "Salta la creazione del file di configurazione"
+      
+      def mount_engine
+        return if options[:skip_routes]
+        
+        route_file = "config/routes.rb"
+        
+        if File.exist?(route_file)
+          mount_code = "  mount BetterUi::Engine => '/better_ui'"
+          
+          append_to_file route_file, injectible_routes(mount_code)
+          
+          say "Engine di Better UI montato in #{route_file}", :green
+        else
+          say "File routes.rb non trovato. Salta il montaggio dell'engine.", :yellow
+        end
+      end
+      
+      def copy_initializer
+        return if options[:skip_config]
+        
+        template "initializer.rb", "config/initializers/better_ui.rb"
+        say "File di configurazione creato in config/initializers/better_ui.rb", :green
+      end
+      
+      def add_assets
+        application_css = "app/assets/stylesheets/application.css"
+        application_scss = "app/assets/stylesheets/application.scss"
+        
+        file_to_update = if File.exist?(application_scss)
+          application_scss
+        elsif File.exist?(application_css)
+          application_css
+        else
+          nil
+        end
+        
+        if file_to_update
+          if file_to_update.end_with?('.css')
+            inject_into_file file_to_update, " *= require better_ui/application\n", before: " */\n"
+          else
+            append_to_file file_to_update, "\n@import 'better_ui/application';\n"
+          end
+          
+          say "Better UI assets aggiunti a #{file_to_update}", :green
+        else
+          say "File CSS dell'applicazione non trovato. Salta l'aggiunta degli assets.", :yellow
+        end
+      end
+      
+      def create_stylesheets
+        return if options[:skip_stylesheets]
+        
+        generate "better_ui:stylesheet"
+        say "Fogli di stile personalizzabili generati", :green
+      end
+      
+      def show_instructions
+        say "\n========================================================", :green
+        say "Better UI installato con successo!", :green
+        say "========================================================", :green
+        say "\nPer utilizzare i componenti nella tua applicazione:", :blue
+        say "- Accedi a http://localhost:3000/better_ui per vedere la documentazione", :blue
+        say "- Utilizza i componenti nel tuo codice, ad esempio:", :blue
+        say "  <%= render BetterUi::General::ButtonComponent.new(label: 'Clicca qui') %>", :blue
+        say "\nPer personalizzare i componenti, modifica i file in:", :blue
+        say "  app/assets/stylesheets/components/", :blue
+        say "- I file *_overrides.scss contengono le classi vuote per le personalizzazioni", :blue
+        say "\nPer configurare i valori predefiniti, modifica:", :blue
+        say "  config/initializers/better_ui.rb", :blue
+        say "\n========================================================\n", :green
+      end
+      
+      private
+      
+      def injectible_routes(mount_code)
+        "\n#{mount_code}\n"
+      end
+    end
+  end
+end 

data/lib/generators/better_ui/stylesheet_generator.rb

@@ -2,56 +2,71 @@
 
 module BetterUi
   module Generators
+    # Generatore per creare file SCSS personalizzati per i componenti BetterUI
+    #
+    # Questo generatore crea:
+    # 1. Un foglio di stile principale che importa tutti i componenti usando @use/@forward
+    # 2. File di override per ogni componente che permettono personalizzazioni senza modificare i file originali
+    # 3. Un file indice che raccoglie tutti gli override usando @forward
     class StylesheetGenerator < Rails::Generators::Base
       source_root File.expand_path('templates', __dir__)
       
-      desc "Genera un foglio di stile SCSS di base per personalizzare i componenti di BetterUi"
+      desc "Genera un foglio di stile SCSS di base per personalizzare i componenti di BetterUI"
       
+      # Opzioni configurabili
       class_option :prefix, type: :string, default: "custom", 
                   desc: "Prefisso da utilizzare per il foglio di stile (default: 'custom')"
+      class_option :path, type: :string, default: "app/assets/stylesheets", 
+                  desc: "Path dove installare i file CSS all'interno della cartella app (default: 'app/assets/stylesheets')"
       
+      # Lista dei file dei componenti da gestire
+      COMPONENT_FILES = [
+        '_variables.scss', 
+        '_button.scss', 
+        '_heading.scss', 
+        '_breadcrumb.scss', 
+        '_link.scss', 
+        '_panel.scss', 
+        '_icon.scss', 
+        '_table.scss', 
+        '_badge.scss', 
+        '_spinner.scss', 
+        '_avatar.scss',
+        '_card.scss'
+      ].freeze
+      
+      # Crea il foglio di stile principale
       def create_stylesheet
-        # Crea il file principale
+        # Crea il file principale che importa tutti i componenti
         template "components_stylesheet.scss", 
-                File.join("app/assets/stylesheets", "#{options[:prefix]}_better_ui_components.scss")
+                File.join(options[:path], "#{options[:prefix]}_better_ui.scss")
         
         # Crea la directory dei componenti se non esiste
-        directory = File.join("app/assets/stylesheets", "components")
+        directory = File.join(options[:path], "components")
         FileUtils.mkdir_p(directory) unless File.directory?(directory)
         
-        # Lista dei file dei componenti
-        component_files = ['_variables.scss', '_button.scss', '_heading.scss', '_breadcrumb.scss', 
-                          '_link.scss', '_panel.scss', '_icon.scss', '_table.scss', '_badge.scss', 
-                          '_spinner.scss', '_avatar.scss']
-        
-        # Copia i file originali
-        component_files.each do |filename|
-          copy_file "components/#{filename}", File.join(directory, filename)
-        end
+        # Crea il file indice che raccoglie tutti gli override
+        template "index.scss", File.join(directory, "_index.scss")
       end
 
+      # Crea i file di override per ogni componente
       def create_overrides
         # Crea la directory dei componenti se non esiste
-        directory = File.join("app/assets/stylesheets", "components")
+        directory = File.join(options[:path], "components")
         FileUtils.mkdir_p(directory) unless File.directory?(directory)
         
-        # Lista dei file dei componenti
-        component_files = ['_variables.scss', '_button.scss', '_heading.scss', '_breadcrumb.scss', 
-                          '_link.scss', '_panel.scss', '_icon.scss', '_table.scss', '_badge.scss', 
-                          '_spinner.scss', '_avatar.scss']
-        
-        # Crea i file di override
-        component_files.each do |filename|
-          # Nome del file di override
+        # Crea i file di override per ogni componente
+        COMPONENT_FILES.each do |filename|
+          # Nome del file di override (es. _button_overrides.scss)
           override_filename = filename.sub('.scss', '_overrides.scss')
           override_path = File.join(directory, override_filename)
           
           # Crea il file di override solo se non esiste già
           unless File.exist?(override_path)
-            # Leggi il contenuto del file originale dalla directory templates
+            # Percorso del file template originale
             template_path = File.join(self.class.source_root, "components", filename)
             
-            # Se il file template esiste, crea il file di override
+            # Se il file template esiste, crea il file di override basato su di esso
             if File.exist?(template_path)
               original_content = File.read(template_path)
               override_content = generate_empty_override(original_content, filename)
@@ -61,6 +76,7 @@ module BetterUi
         end
       end
       
+      # Mostra le istruzioni README dopo l'esecuzione del generatore
       def show_readme
         readme "README" if behavior == :invoke
       end
@@ -68,8 +84,15 @@ module BetterUi
       private
       
       # Genera un file di override vuoto con le stesse classi del file originale
+      # 
+      # @param content [String] Il contenuto del file SCSS originale
+      # @param filename [String] Il nome del file del componente
+      # @return [String] Il contenuto formattato del file di override
       def generate_empty_override(content, filename)
+        # Estrae il nome del componente dal nome file (es. "_button.scss" -> "button")
         component_name = filename.sub('_', '').sub('.scss', '')
+        
+        # Intestazione del file di override
         result = "/* ==============================\n"
         result += " * #{component_name.capitalize} Component Overrides\n"
         result += " * ==============================\n"
@@ -77,20 +100,60 @@ module BetterUi
         result += " * Aggiungi qui le tue personalizzazioni.\n"
         result += " */\n\n"
         
-        # Estrae le classi tramite regex
+        # Aggiungiamo il layer di Tailwind se presente nell'originale
+        if content.include?('@layer components')
+          result += "@layer components {\n"
+          layer_present = true
+        end
+        
+        # Estrae le classi principali (Block) usando regex
         class_matches = content.scan(/\.(bui-[a-zA-Z0-9_-]+)\s*\{/)
         class_matches.flatten.uniq.each do |css_class|
-          result += ".#{css_class} {\n  // Sovrascrivi qui gli stili per .#{css_class}\n}\n\n"
+          result += layer_present ? "  " : ""
+          result += ".#{css_class} {\n    // Aggiungi personalizzazioni qui\n#{layer_present ? "  " : ""}}\n\n"
         end
         
-        # Estrae anche classi annidate usando la sintassi SCSS
-        nested_matches = content.scan(/\.(bui-[a-zA-Z0-9_-]+)\s*{[^{]*\.([\w-]+)\s*{/)
-        nested_matches.each do |parent_class, child_class|
-          result += ".#{parent_class} {\n  .#{child_class} {\n    // Sovrascrivi qui gli stili annidati\n  }\n}\n\n"
+        # Estrae classi modifier (es. &--small, &__icon, ecc.)
+        modifier_matches = content.scan(/&([a-zA-Z0-9_-]+)\s*\{/)
+        if !modifier_matches.empty?
+          # Raggruppa i modifier per classe principale
+          main_classes = class_matches.flatten.uniq
+          main_classes.each do |main_class|
+            # Estrae tutti i modifier di questa classe principale
+            class_content = extract_class_block(content, main_class)
+            modifiers = class_content.scan(/&([a-zA-Z0-9_-]+)\s*\{/).flatten.uniq
+            
+            if !modifiers.empty?
+              result += layer_present ? "  " : ""
+              result += ".#{main_class} {\n"
+              
+              modifiers.each do |modifier|
+                result += layer_present ? "    " : "  "
+                result += "&#{modifier} {\n      // Aggiungi personalizzazioni qui\n#{layer_present ? "    " : "  "}}\n\n"
+              end
+              
+              result += layer_present ? "  " : ""
+              result += "}\n\n"
+            end
+          end
         end
         
+        # Chiude il layer se presente
+        result += "}\n" if layer_present
+        
         result
       end
+      
+      # Estrae il blocco di codice relativo a una classe CSS specifica
+      #
+      # @param content [String] Il contenuto del file SCSS completo
+      # @param css_class [String] Il nome della classe CSS da estrarre
+      # @return [String] Il blocco di codice della classe
+      def extract_class_block(content, css_class)
+        regex = /\.(#{css_class})\s*\{((?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})*)\}/m
+        match = content.match(regex)
+        match ? match[2] : ""
+      end
     end
   end
 end