better_ui 0.1.0 → 0.2.0

data/app/helpers/better_ui/application/components/navbar/navbar_helper.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module Application
+    module Components
+      module Navbar
+        module NavbarHelper
+          # Helper per creare la navbar dell'applicazione
+          #
+          # @param theme [Symbol] Tema colori (default, white, red, rose, orange, green, blue, yellow, violet), default :default
+          # @param shadow [Symbol] Tipo di ombra (none, small, medium, large), default :small
+          # @param border [Boolean] Se mostrare il bordo inferiore, default true
+          # @param actions [Array] Array di azioni/pulsanti a destra
+          # @param classes [String] Classi CSS aggiuntive
+          # @param with_sidebar [Boolean] Se la navbar è affiancata a una sidebar, default false
+          # @param sidebar_width [Symbol] Larghezza della sidebar affiancata (:sm, :md, :lg, :xl), default :md
+          # @param form [Nil] Parametro form per compatibilità con form builder (non utilizzato)
+          # @param options [Hash] Opzioni HTML aggiuntive
+          # @param block [Proc] Blocco contenente contenuto aggiuntivo della navbar
+          #
+          # @return [String] HTML del componente navbar
+          #
+          # @example Navbar base
+          #   <%= bui_navbar %>
+          # 
+          # @example Navbar con tema
+          #   <%= bui_navbar(theme: :blue) %>
+          #
+          #
+          # @example Navbar con azioni
+          #   <%= bui_navbar(
+          #     actions: [
+          #       { 
+          #         type: :avatar,
+          #         avatar: { initials: 'AB', theme: :green },
+          #         href: '/profile'
+          #       },
+          #       {
+          #         type: :icon,
+          #         icon: 'chat',
+          #         data: { action: 'click->chat#toggle' }
+          #       }
+          #     ]
+          #   ) %>
+          #
+          # @example Navbar con classi aggiuntive
+          #   <%= bui_navbar(
+          #     classes: "my-8",
+          #     data: { controller: "navbar" }
+          #   ) %>
+          def bui_navbar(
+            theme: :default,
+            shadow: :small,
+            border: true,
+            actions: [],
+            classes: nil,
+            with_sidebar: false,
+            sidebar_width: :md,
+            form: nil, 
+            **options,
+            &block
+          )
+            render BetterUi::Application::Navbar::Component.new(
+              theme: theme,
+              shadow: shadow,
+              border: border,
+              actions: actions,
+              classes: classes,
+              with_sidebar: with_sidebar,
+              sidebar_width: sidebar_width
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/application/components/sidebar/sidebar_helper.rb

@@ -0,0 +1,51 @@
+module BetterUi
+  module Application
+    module Components
+      module Sidebar
+        module SidebarHelper
+          # Helper per creare la sidebar dell'applicazione
+          #
+          # @param width [Symbol] Larghezza della sidebar (:sm, :md, :lg, :xl), default :md
+          # @param position [Symbol] Posizione della sidebar (:left, :right), default :left
+          # @param theme [Symbol] Tema colori (:default, :dark, :light), default :default
+          # @param shadow [Symbol] Tipo di ombra (:none, :sm, :md, :lg), default :lg
+          # @param border [Boolean] Se mostrare il bordo destro/sinistro, default true
+          # @param header [Hash] Configurazione header (logo, title, subtitle)
+          # @param footer [Hash] Configurazione footer (content, user_info)
+          # @param navigation_sections [Array] Array di sezioni di navigazione
+          # @param collapsible [Boolean] Se abilitare sezioni collassabili, default true
+          # @param classes [String] Classi CSS aggiuntive
+          # @param block [Proc] Blocco contenente contenuto aggiuntivo della sidebar
+          #
+          # @return [String] HTML del componente sidebar
+          def bui_sidebar(
+            width: :md,
+            position: :left,
+            theme: :default,
+            shadow: :lg,
+            border: true,
+            header: {},
+            footer: {},
+            navigation_sections: [],
+            collapsible: true,
+            classes: nil,
+            &block
+          )
+            render BetterUi::Application::Sidebar::Component.new(
+              width: width,
+              position: position,
+              theme: theme,
+              shadow: shadow,
+              border: border,
+              header: header,
+              footer: footer,
+              navigation_sections: navigation_sections,
+              collapsible: collapsible,
+              classes: classes
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/application_helper.rb

@@ -1,183 +1,55 @@
 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::Dropdown::DropdownHelper
+    include General::Components::Dropdown::ItemHelper
+    include General::Components::Dropdown::DividerHelper
+    include General::Components::Heading::HeadingHelper
+    include General::Components::Icon::IconHelper
+    include General::Components::Link::LinkHelper
+    include General::Components::Modal::ModalHelper
+    include General::Components::Pagination::PaginationHelper
+    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::Tabs::TabsHelper
+    include General::Components::Tabs::TabHelper
+    
+    include General::Components::Tabs::PanelHelper
+    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