better_ui 0.1.0 → 0.1.1

data/app/helpers/better_ui/application_helper.rb

@@ -1,183 +1,46 @@
 module BetterUi
   module ApplicationHelper
-    # Metodi helper per i componenti UI semplici
-    
-    # Button component
-    def better_ui_button(text, options = {})
-      options = BetterUi.configuration.button_defaults.deep_merge(options)
-      type = options.delete(:type) || 'primary'
-      css_class = "better-ui-button better-ui-button-#{type}"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      button_tag(text, **options.merge(class: css_class))
-    end
-    
-    # Alert component
-    def better_ui_alert(message, options = {})
-      options = BetterUi.configuration.alert_defaults.deep_merge(options)
-      type = options.delete(:type) || 'info'
-      css_class = "better-ui-alert better-ui-alert-#{type}"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class) do
-        concat content_tag(:div, message, class: 'better-ui-alert-message')
-        if options[:dismissible]
-          concat content_tag(:button, 'x', class: 'better-ui-alert-close')
-        end
-      end
-    end
-    
-    # Card component
-    def better_ui_card(options = {}, &block)
-      options = BetterUi.configuration.card_defaults.deep_merge(options)
-      css_class = "better-ui-card"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Card header
-    def better_ui_card_header(title, options = {})
-      css_class = "better-ui-card-header"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class) do
-        content_tag(:h3, title, class: 'better-ui-card-title')
-      end
-    end
-    
-    # Card body
-    def better_ui_card_body(options = {}, &block)
-      css_class = "better-ui-card-body"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Card footer
-    def better_ui_card_footer(options = {}, &block)
-      css_class = "better-ui-card-footer"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Tabs component
-    def better_ui_tabs(options = {}, &block)
-      options = BetterUi.configuration.tabs_defaults.deep_merge(options)
-      css_class = "better-ui-tabs"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Tab list
-    def better_ui_tab_list(options = {}, &block)
-      css_class = "better-ui-tab-list"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, role: 'tablist', **options, &block)
-    end
-    
-    # Tab item
-    def better_ui_tab_item(text, target, options = {})
-      active = options.delete(:active) || false
-      css_class = "better-ui-tab-item"
-      css_class += " better-ui-tab-active" if active
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:button, text, {
-        class: css_class,
-        role: 'tab',
-        'aria-selected': active,
-        'data-target': target,
-      }.merge(options))
-    end
-    
-    # Tab content
-    def better_ui_tab_content(options = {}, &block)
-      css_class = "better-ui-tab-content"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, role: 'tabpanel', **options, &block)
-    end
-    
-    # Modal component
-    def better_ui_modal(id, options = {}, &block)
-      css_class = "better-ui-modal"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, id: id, class: css_class) do
-        concat content_tag(:div, '', class: 'better-ui-modal-background')
-        concat content_tag(:div, class: 'better-ui-modal-dialog', &block)
-      end
-    end
-    
-    # Modal header
-    def better_ui_modal_header(title, options = {})
-      css_class = "better-ui-modal-header"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class) do
-        concat content_tag(:h5, title, class: 'better-ui-modal-title')
-        concat content_tag(:button, '×', type: 'button', class: 'better-ui-modal-close')
-      end
-    end
-    
-    # Modal body
-    def better_ui_modal_body(options = {}, &block)
-      css_class = "better-ui-modal-body"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Modal footer
-    def better_ui_modal_footer(options = {}, &block)
-      css_class = "better-ui-modal-footer"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      content_tag(:div, class: css_class, **options, &block)
-    end
-    
-    # Trigger button for modal
-    def better_ui_modal_trigger(text, modal_id, options = {})
-      options = BetterUi.configuration.button_defaults.deep_merge(options)
-      type = options.delete(:type) || 'primary'
-      css_class = "better-ui-button better-ui-button-#{type}"
-      css_class += " #{options.delete(:class)}" if options[:class]
-      
-      button_tag(text, **options.merge(
-        class: css_class,
-        type: 'button',
-        onclick: "document.getElementById('#{modal_id}').style.display='flex'"
-      ))
-    end
-    
-    # Render markdown
-    def better_ui_markdown(text)
-      return '' if text.blank?
-      
-      renderer = Redcarpet::Render::HTML.new(
-        filter_html: false,
-        hard_wrap: true,
-        link_attributes: { target: '_blank', rel: 'noopener noreferrer' }
-      )
-      
-      markdown = Redcarpet::Markdown.new(
-        renderer,
-        autolink: true,
-        tables: true,
-        fenced_code_blocks: true,
-        strikethrough: true,
-        superscript: true,
-        underline: true,
-        highlight: true,
-        quote: true,
-        footnotes: true
-      )
-      
-      markdown.render(text).html_safe
-    end
+    # Inclusione dei moduli aggregatori per i componenti application
+    # Questo assicura che tutti gli helper specifici dei componenti siano disponibili.
+
+    # General Components
+    include General::Components::Alert::AlertHelper
+    include General::Components::Avatar::AvatarHelper
+    include General::Components::Badge::BadgeHelper
+    include General::Components::Breadcrumb::BreadcrumbHelper
+    include General::Components::Button::ButtonHelper
+    include General::Components::Divider::DividerHelper
+    include General::Components::Heading::HeadingHelper
+    include General::Components::Icon::IconHelper
+    include General::Components::Link::LinkHelper
+    include General::Components::Panel::PanelHelper
+    include General::Components::Progress::ProgressHelper
+    include General::Components::Spinner::SpinnerHelper
+
+    include General::Components::Table::TableHelper
+    include General::Components::Table::TbodyHelper
+    include General::Components::Table::TdHelper
+    include General::Components::Table::TfootHelper
+    include General::Components::Table::ThHelper
+    include General::Components::Table::TheadHelper
+    include General::Components::Table::TrHelper
+
+    include General::Components::Tag::TagHelper
+    include General::Components::Tooltip::TooltipHelper
+
+    # General Form Components
+    include General::Components::Input::Checkbox::CheckboxHelper
+    include General::Components::Input::Datetime::DatetimeHelper
+    include General::Components::Input::Radio::RadioHelper
+    include General::Components::Input::RadioGroup::RadioGroupHelper
+    include General::Components::Input::Select::SelectHelper
+    include General::Components::Input::Text::TextHelper
+    include General::Components::Input::Textarea::TextareaHelper
+
+    # Application Components
+    include Application::Components::Main::MainHelper
+    include Application::Components::Navbar::NavbarHelper
+    include Application::Components::Sidebar::SidebarHelper
+    include Application::Components::Card::CardHelper
   end
 end

data/app/helpers/better_ui/general/components/alert/alert_helper.rb

@@ -0,0 +1,57 @@
+module BetterUi
+  module General
+    module Components
+      module Alert
+        module AlertHelper
+          # Renderizza un componente Alert per comunicare messaggi importanti all'utente.
+          #
+          # @param title [String, nil] Titolo dell'alert (opzionale)
+          # @param message [String] Contenuto dell'alert
+          # @param theme [Symbol] Tema dell'alert (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+          # @param icon [String, nil] Nome dell'icona (se vuoto usa l'icona predefinita in base al tema)
+          # @param icon_position [Symbol] Posizione dell'icona (:left, :right)
+          # @param dismissible [Boolean] Se l'alert può essere chiuso dall'utente
+          # @param rounded [Symbol] Arrotondamento degli angoli (:none, :small, :medium, :large, :full)
+          # @param importance [Symbol] Livello di importanza per accessibilità (:high, :medium, :low)
+          # @param html_content [Boolean] Se il messaggio contiene HTML
+          # @param classes [String] Classi CSS aggiuntive
+          # @param options [Hash] Attributi HTML aggiuntivi
+          #
+          # @return [String] HTML del componente Alert renderizzato
+          #
+          # @example Alert base
+          #   <%= bui_alert(message: 'Operazione completata con successo') %>
+          #
+          # @example Alert con titolo e tema
+          #   <%= bui_alert(title: 'Errore', message: 'Impossibile completare', theme: :red) %>
+          #
+          # @example Alert con icona personalizzata
+          #   <%= bui_alert(message: 'Avviso importante', icon: 'bell') %>
+          #
+          # @example Alert con pulsante per chiudere
+          #   <%= bui_alert(message: 'Notifica temporanea', dismissible: true) %>
+          #
+          # @example Alert con HTML nel messaggio
+          #   <%= bui_alert(message: '<strong>Attenzione!</strong> Controlla i dati.', html_content: true) %>
+          def bui_alert(title: nil, message: nil, theme: :default, icon: nil, icon_position: :left, 
+                       dismissible: false, rounded: :medium, importance: :medium, html_content: false, 
+                       classes: nil, **options)
+            render BetterUi::General::Alert::Component.new(
+              title: title,
+              message: message,
+              theme: theme,
+              icon: icon,
+              icon_position: icon_position,
+              dismissible: dismissible,
+              rounded: rounded,
+              importance: importance,
+              html_content: html_content,
+              classes: classes,
+              **options
+            )
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module BetterUi
+  module General
+    module Components
+      module Avatar
+        module AvatarHelper
+          # Render un avatar con le opzioni specificate
+          #
+          # @param options [Hash] opzioni per il componente
+          #
+          # @option options [String] :name (nil) nome per le iniziali
+          # @option options [String] :src (nil) URL dell'immagine
+          # @option options [Symbol] :size (:medium) :xxsmall, :xsmall, :small, :medium, :large, :xlarge, :xxlarge
+          # @option options [Symbol] :shape (:circle) :circle, :square, :rounded
+          # @option options [Symbol] :status (nil) :online, :offline, :busy, :away
+          # @option options [Symbol] :status_position (:bottom_right) :bottom_right, :bottom_left, :top_right, :top_left
+          # @option options [Symbol] :theme (:white) :default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet
+          # @option options [Symbol] :style (:filled) :filled, :outline, :light
+          # @option options [String] :classes (nil) classi CSS aggiuntive
+          # @option options [String] :id (nil) ID HTML
+          #
+          # @return [String] HTML del componente
+          def bui_avatar(**options)
+            render BetterUi::General::Avatar::Component.new(**options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,53 @@
+module BetterUi
+  module General
+    module Components
+      module Badge
+        module BadgeHelper
+          # Helper per renderizzare un badge
+          #
+          # @param label [String] Testo del badge
+          # @param theme [Symbol] Tema del badge (:default, :white, :red, etc.)
+          # @param size [Symbol] Dimensione del badge (:small, :medium, :large)
+          # @param shape [Symbol] Forma del badge (:square, :rounded)
+          # @param style [Symbol] Stile del badge (:filled, :outline)
+          # @param variant [Symbol] Variante del badge (:notification, :counter, :dot)
+          # @param icon [String] Nome dell'icona (opzionale)
+          # @param icon_position [Symbol] Posizione dell'icona (:left, :right)
+          # @param classes [String] Classi CSS aggiuntive
+          # @param id [String] ID HTML
+          # @param html_options [Hash] Opzioni HTML aggiuntive
+          #
+          # @return [String] HTML del badge
+          def bui_badge(
+            label: nil,
+            theme: :white,
+            size: :medium,
+            shape: :rounded,
+            style: :filled,
+            variant: nil,
+            icon: nil,
+            icon_position: :left,
+            classes: nil,
+            id: nil,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Badge::Component.new(
+              label: label,
+              theme: theme,
+              size: size,
+              shape: shape,
+              style: style,
+              variant: variant,
+              icon: icon,
+              icon_position: icon_position,
+              classes: classes,
+              id: id,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+module BetterUi
+  module General
+    module Components
+      module Breadcrumb
+        module BreadcrumbHelper
+          # Helper per renderizzare un breadcrumb
+          #
+          # @param items [Array] Array di items del breadcrumb
+          # @param separator [Symbol] Tipo di separatore (:chevron, :slash, :arrow, :dot, :pipe)
+          # @param theme [Symbol] Tema del breadcrumb (:default, :white, :red, etc.)
+          # @param size [Symbol] Dimensione del testo (:extra_small, :small, :medium, :large)
+          # @param classes [String] Classi CSS aggiuntive
+          # @param html_options [Hash] Opzioni HTML aggiuntive
+          #
+          # @return [String] HTML del breadcrumb
+          def bui_breadcrumb(
+            items: [],
+            separator: :chevron,
+            theme: :white,
+            size: :medium,
+            classes: nil,
+            **html_options
+          )
+            render BetterUi::General::Breadcrumb::Component.new(
+              items: items,
+              separator: separator,
+              theme: theme,
+              size: size,
+              classes: classes,
+              **html_options
+            )
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+module BetterUi
+  module General
+    module Components
+      module Button
+        module ButtonHelper
+          # Helper per renderizzare un bottone
+          #
+          # @param label [String] Testo del bottone
+          # @param type [Symbol] Tipo del bottone (:default, :white, :red, etc.)
+          # @param size [Symbol] Dimensione del bottone (:small, :medium, :large)
+          # @param full_width [Boolean] Larghezza completa
+          # @param disabled [Boolean] Stato disabilitato
+          # @param icon [String] Nome icona (opzionale)
+          # @param icon_position [Symbol] Posizione icona (:left, :right)
+          # @param href [String] URL per il link (opzionale)
+          # @param method [Symbol] Metodo HTTP (opzionale)
+          # @param data [Hash] Attributi data
+          # @param classes [String] Classi CSS aggiuntive
+          # @param id [String] ID elemento
+          # @param rounded [Symbol] Tipo di border-radius (:none, :small, :medium, :large, :full)
+          # @param html_options [Hash] Opzioni HTML aggiuntive
+          # @params button_type [Symbol] Tipo di bottone (:button, :submit, :reset)
+          #
+          # @return [String] HTML del bottone
+          def bui_button(
+            label: nil,
+            type: :white,
+            size: :medium,
+            full_width: false,
+            disabled: false,
+            icon: nil,
+            icon_position: :left,
+            href: nil,
+            method: nil,
+            data: {},
+            classes: nil,
+            id: nil,
+            rounded: :medium,
+            button_type: :button,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Button::Component.new(
+              label: label,
+              type: type,
+              size: size,
+              full_width: full_width,
+              disabled: disabled,
+              icon: icon,
+              icon_position: icon_position,
+              href: href,
+              method: method,
+              data: data,
+              classes: classes,
+              id: id,
+              rounded: rounded,
+              button_type: button_type,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/container/container_helper.rb

@@ -0,0 +1,60 @@
+module BetterUi
+  module General
+    module Components
+      module Container
+        module ContainerHelper
+          # Genera un container usando BetterUi::General::Container::Component
+          #
+          # @param html_content [String] contenuto HTML del container (opzionale)
+          # @param fluid [Boolean] se il container deve essere fluid (full width)
+          # @param max_width [Symbol] larghezza massima del container (:sm, :md, :lg, :xl, :xxl)
+          # @param padding [Symbol] padding interno (:none, :small, :medium, :large)
+          # @param background [Symbol] colore di sfondo (:white, :light, :dark, :transparent)
+          # @param html_options [Hash] opzioni HTML aggiuntive
+          # @return [String] HTML del container renderizzato
+          #
+          # @example Uso base
+          #   bui_container(html_content: "Contenuto del container")
+          #
+          # @example Container fluid
+          #   bui_container(
+          #     html_content: "Contenuto full width",
+          #     fluid: true
+          #   )
+          #
+          # @example Container con larghezza massima
+          #   bui_container(
+          #     html_content: "Contenuto limitato",
+          #     max_width: :lg,
+          #     padding: :large
+          #   )
+          #
+          # @example Con contenuto block
+          #   bui_container(background: :light) do
+          #     "<div>Il mio contenuto</div>".html_safe
+          #   end
+          def bui_container(
+            html_content: nil,
+            fluid: false,
+            max_width: :lg,
+            padding: :medium,
+            background: :white,
+            border: false,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Container::Component.new(
+              html_content: html_content,
+              fluid: fluid,
+              max_width: max_width,
+              padding: padding,
+              background: background,
+              border: border,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/divider/divider_helper.rb

@@ -0,0 +1,63 @@
+module BetterUi
+  module General
+    module Components
+      module Divider
+        module DividerHelper
+          # Genera un divider usando BetterUi::General::Divider::Component
+          #
+          # @param theme [Symbol] tema del divider (:default, :white, etc.)
+          # @param orientation [Symbol] orientamento del divider (:horizontal, :vertical)
+          # @param style [Symbol] stile della linea (:solid, :dashed, :dotted, :double)
+          # @param size [Symbol] dimensione della linea (:thin, :medium, :thick)
+          # @param label [String] testo opzionale da mostrare al centro del divider
+          # @param height [String] altezza per divider verticale (es. "100px", "100%")
+          # @param classes [String] classi CSS aggiuntive
+          # @param html_options [Hash] opzioni HTML per il container
+          # @return [String] HTML del divider renderizzato
+          #
+          # @example Uso base
+          #   bui_divider
+          #   bui_divider(theme: :blue, size: :thick)
+          #
+          # @example Con label
+          #   bui_divider(label: "Oppure", theme: :red)
+          #
+          # @example Divider verticale
+          #   bui_divider(orientation: :vertical, height: "100px", theme: :green)
+          #
+          # @example Con opzioni avanzate
+          #   bui_divider(
+          #     theme: :violet,
+          #     orientation: :horizontal,
+          #     style: :dashed,
+          #     size: :medium,
+          #     label: "Sezione",
+          #     classes: "my-8",
+          #     id: "main-divider"
+          #   )
+          def bui_divider(
+            theme: :white,
+            orientation: :horizontal,
+            style: :solid,
+            size: :medium,
+            label: nil,
+            height: nil,
+            classes: nil,
+            **html_options
+          )
+            render BetterUi::General::Divider::Component.new(
+              theme: theme,
+              orientation: orientation,
+              style: style,
+              size: size,
+              label: label,
+              height: height,
+              classes: classes,
+              **html_options
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/field/field_helper.rb

@@ -0,0 +1,26 @@
+module BetterUi
+  module General
+    module Components
+      module Field
+        module FieldHelper
+          # @param label [String] Label del campo
+          # @param name [String] Nome del campo
+          # @param required [Boolean] Se il campo è obbligatorio
+          # @param error [String] Messaggio di errore
+          # @param help_text [String] Testo di aiuto
+          # @return [BetterUi::General::FieldComponent] Componente del campo
+          def bui_field(label:, name:, required: false, error: nil, help_text: nil, id: nil, &block)
+            render BetterUi::General::Field::Component.new(
+              label: label,
+              name: name,
+              required: required,
+              error: error,
+              help_text: help_text,
+              id: id || SecureRandom.uuid
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end