better_ui 0.3.0 → 0.4.0

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

@@ -1,77 +0,0 @@
-# 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

@@ -1,51 +0,0 @@
-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,55 +0,0 @@
-module BetterUi
-  module ApplicationHelper
-    # Inclusione dei moduli aggregatori per i componenti application
-    # Questo assicura che tutti gli helper specifici dei componenti siano disponibili.
-
-    # General Components
-    include General::Components::Accordion::AccordionHelper
-    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::Tag::TagHelper
-    include General::Components::Tooltip::TooltipHelper
-
-    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::Tabs::TabsHelper
-    include General::Components::Tabs::TabHelper
-    include General::Components::Tabs::PanelHelper
-
-    # 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/accordion/accordion_helper.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Accordion
-        module AccordionHelper
-          # Rendering di un accordion con item collassabili/espandibili
-          #
-          # @param multiple [Boolean] se permettere multipli item aperti contemporaneamente
-          # @param theme [Symbol] tema di colore per l'accordion
-          # @param variant [Symbol] variante visuale dell'accordion
-          # @param size [Symbol] dimensione del testo e padding
-          # @param classes [String] classi CSS aggiuntive per il wrapper
-          # @param options [Hash] attributi HTML aggiuntivi da passare al componente
-          # @return [String] HTML renderizzato dell'accordion
-          #
-          # @example Uso base standalone
-          #   <%= bui_accordion do |accordion| %>
-          #     <%= accordion.with_item(title: "Domanda 1") do %>
-          #       <p>Risposta alla prima domanda</p>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Con tema e configurazioni
-          #   <%= bui_accordion(multiple: true, theme: :blue, size: :large) do |accordion| %>
-          #     <%= accordion.with_item(title: "FAQ 1", expanded: true) do %>
-          #       <p>Contenuto della prima FAQ</p>
-          #     <% end %>
-          #     <%= accordion.with_item(title: "FAQ 2") do %>
-          #       <p>Contenuto della seconda FAQ</p>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Con varianti stilistiche
-          #   <%= bui_accordion(variant: :separated, theme: :green) do |accordion| %>
-          #     <%= accordion.with_item(title: "Sezione 1") do %>
-          #       <div>Contenuto complesso con HTML</div>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Con attributi HTML aggiuntivi
-          #   <%= bui_accordion(id: "faq-accordion", "data-testid": "main-faq") do |accordion| %>
-          #     <%= accordion.with_item(title: "Come funziona?") do %>
-          #       <p>Spiegazione dettagliata...</p>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Con item disabilitati e icone personalizzate
-          #   <%= bui_accordion(theme: :violet, size: :small) do |accordion| %>
-          #     <%= accordion.with_item(title: "Disponibile", icon: "check-circle") do %>
-          #       <p>Questa sezione è disponibile</p>
-          #     <% end %>
-          #     <%= accordion.with_item(title: "Non disponibile", disabled: true) do %>
-          #       <p>Questa sezione è disabilitata</p>
-          #     <% end %>
-          #   <% end %>
-          def bui_accordion(multiple: false, theme: :default, variant: :bordered, size: :medium, 
-                           classes: '', **options, &block)
-            render BetterUi::General::Accordion::Component.new(
-              multiple: multiple,
-              theme: theme,
-              variant: variant,
-              size: size,
-              classes: classes,
-              **options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Accordion
-        include BetterUi::General::Components::Accordion::AccordionHelper
-      end
-    end
-  end
-end

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

@@ -1,57 +0,0 @@
-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

@@ -1,29 +0,0 @@
-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

@@ -1,53 +0,0 @@
-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

@@ -1,37 +0,0 @@
-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

@@ -1,65 +0,0 @@
-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

@@ -1,60 +0,0 @@
-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

@@ -1,63 +0,0 @@
-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/dropdown/divider_helper.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Dropdown
-        module DividerHelper
-          ##
-          # Crea un divisore per separare gruppi di elementi nel menu dropdown.
-          #
-          # @param classes [String] Classi CSS aggiuntive
-          # @param options [Hash] Attributi HTML aggiuntivi
-          #
-          # @return [String] Il markup HTML del divisore dropdown
-          #
-          # @example Uso base
-          #   <%= bui_dropdown_divider %>
-          #
-          # @example Con classi personalizzate
-          #   <%= bui_dropdown_divider(classes: "my-4") %>
-          #
-          def bui_dropdown_divider(classes: '', **options)
-            render BetterUi::General::Dropdown::DividerComponent.new(
-              classes: classes,
-              **options
-            )
-          end
-        end
-      end
-    end
-  end
-end