better_ui 0.4.0 → 0.5.1

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

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module AvatarHelper
+        def bui_avatar(image = nil, **options)
+          render BetterUi::General::AvatarComponent.new(
+            image: image,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_avatar, :bui_avatar
+      end
+    end
+  end
+end 

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

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

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

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module BreadcrumbHelper
+        def bui_breadcrumb(items = nil, **options)
+          render BetterUi::General::BreadcrumbComponent.new(
+            items: items,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_breadcrumb, :bui_breadcrumb
+      end
+    end
+  end
+end 

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

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

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

@@ -0,0 +1,17 @@
+module BetterUi
+  module General
+    module Components
+      module HeadingHelper
+        def bui_heading(title = nil, **options)
+          render BetterUi::General::HeadingComponent.new(
+            title: title,
+            **options
+          )
+        end
+        
+        # Supporto per la sintassi originale per compatibilità
+        alias_method :better_ui_general_heading, :bui_heading
+      end
+    end
+  end
+end 

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/app/views/components/better_ui/general/table/_custom_body_row.html.erb

@@ -0,0 +1,17 @@
+<tr class="<%= component.tr_classes(index) %>">
+  <% headers.each_with_index do |header, cell_index| %>
+    <td class="<%= component.td_classes %>">
+      <% cell_value = component.get_cell_value(row, header) %>
+      <% if cell_index == 0 %>
+        <div class="flex items-center">
+          <div class="w-8 h-8 rounded-full bg-blue-100 mr-2 flex items-center justify-center text-blue-700">
+            <%= cell_value.to_s.first&.upcase || 'N/A' %>
+          </div>
+          <%= cell_value %>
+        </div>
+      <% else %>
+        <%= cell_value %>
+      <% end %>
+    </td>
+  <% end %>
+</tr> 

data/app/views/components/better_ui/general/table/_custom_footer_rows.html.erb

@@ -0,0 +1,17 @@
+<tr>
+  <% footer.each_with_index do |value, index| %>
+    <td class="<%= component.tf_classes %>">
+      <% if index == 0 %>
+        <div class="flex items-center">
+          <svg class="w-5 h-5 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2
+ 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path>
+          </svg>
+          <strong><%= value %></strong>
+        </div>
+      <% else %>
+        <%= value %>
+      <% end %>
+    </td>
+  <% end %>
+</tr> 

data/app/views/components/better_ui/general/table/_custom_header_rows.html.erb

@@ -0,0 +1,12 @@
+<tr>
+  <% headers.each do |header| %>
+    <th class="<%= component.th_classes %>">
+      <div class="flex items-center justify-between">
+        <%= header.to_s.humanize %>
+        <svg class="w-4 h-4 ml-1" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"></path>
+        </svg>
+      </div>
+    </th>
+  <% end %>
+</tr> 

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,49 +3,99 @@ require 'redcarpet'
 require 'tailwindcss-rails'
 require 'coderay'
 require 'font-awesome-sass'
+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 defined?(Lookbook) && (Rails.env.development? || Rails.env.test?)
-        # Carica esplicitamente le dipendenze per le funzionalità avanzate di Lookbook
-        begin
-          require 'listen'
-          require 'action_cable'
-        rescue LoadError => e
-          # Log che le dipendenze opzionali non sono disponibili
-          puts "NOTA: Alcune funzionalità avanzate di Lookbook potrebbero non essere disponibili: #{e.message}"
+    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
-        
-        config.lookbook = Lookbook
       end
     end
   end

data/lib/better_ui/version.rb

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

data/lib/better_ui.rb

@@ -21,5 +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 dei generator
+require '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