better_ui 0.1.0 → 0.2.0

data/app/helpers/better_ui/general/components/input/radio_group/radio_group_helper.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module General
+    module Components
+      module Input
+        module RadioGroup
+          # Helper per creare gruppi di radio button Better UI
+          module RadioGroupHelper
+            # Genera un gruppo completo di radio button con stili Better UI
+            #
+            # @param name [String] Nome del campo radio (comune a tutto il gruppo)
+            # @param options [Array<Hash>] Array di opzioni per ogni radio button
+            # @param selected [String, nil] Valore dell'opzione selezionata
+            # @param theme [Symbol] Tema del componente (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+            # @param size [Symbol] Dimensione del componente (:small, :medium, :large)
+            # @param rounded [Symbol] Border radius (:none, :small, :medium, :large, :full)
+            # @param direction [Symbol] Direzione del gruppo (:vertical, :horizontal)
+            # @param required [Boolean] Se il gruppo è obbligatorio
+            # @param disabled [Boolean] Se il gruppo è disabilitato
+            # @param classes [String] Classi CSS aggiuntive per il contenitore
+            # @param form [ActionView::Helpers::FormBuilder, nil] Form builder Rails opzionale
+            # @param html_options [Hash] Opzioni HTML aggiuntive per ogni radio
+            # @return [String] HTML del gruppo radio renderizzato
+            #
+            # @example Gruppo radio base - Selezione genere
+            #   bui_input_radio_group(
+            #     name: "gender",
+            #     options: [
+            #       { value: "male", label: "Maschio" },
+            #       { value: "female", label: "Femmina" },
+            #       { value: "other", label: "Altro" }
+            #     ]
+            #   )
+            #
+            # @example Gruppo radio con tema e selezione
+            #   bui_input_radio_group(
+            #     name: "priority",
+            #     options: [
+            #       { value: "low", label: "Bassa", theme: :green },
+            #       { value: "medium", label: "Media", theme: :yellow },
+            #       { value: "high", label: "Alta", theme: :red }
+            #     ],
+            #     selected: "medium",
+            #     size: :large
+            #   )
+            #
+            # @example Gruppo radio orizzontale con Rails form
+            #   <%= form_with model: @user do |form| %>
+            #     <%= bui_input_radio_group(
+            #       name: :role,
+            #       options: [
+            #         { value: "admin", label: "Amministratore" },
+            #         { value: "user", label: "Utente" },
+            #         { value: "guest", label: "Ospite" }
+            #       ],
+            #       selected: @user.role,
+            #       direction: :horizontal,
+            #       form: form
+            #     ) %>
+            #   <% end %>
+            #
+            # @example Gruppo radio con validazione e attributi HTML
+            #   bui_input_radio_group(
+            #     name: "notification_type",
+            #     options: [
+            #       { value: "email", label: "Email" },
+            #       { value: "sms", label: "SMS" },
+            #       { value: "push", label: "Push Notification" }
+            #     ],
+            #     required: true,
+            #     theme: :blue,
+            #     html_options: { data: { action: "change->form#validateNotification" } }
+            #   )
+            #
+            # @example Gruppo radio con temi personalizzati per opzione
+            #   bui_input_radio_group(
+            #     name: "status",
+            #     options: [
+            #       { value: "active", label: "Attivo", theme: :green },
+            #       { value: "pending", label: "In Sospeso", theme: :yellow },
+            #       { value: "inactive", label: "Inattivo", theme: :red }
+            #     ],
+            #     selected: "active",
+            #     direction: :horizontal
+            #   )
+            #
+            def bui_input_radio_group(name:, options:, selected: nil, theme: :default, size: :medium, 
+                                     rounded: :full, direction: :vertical, required: false, disabled: false,
+                                     classes: '', form: nil, **html_options)
+              container_classes = [
+                'space-y-2',
+                direction == :horizontal ? 'flex flex-wrap gap-6' : 'space-y-2',
+                classes
+              ].compact.join(' ')
+
+              content_tag(:div, class: container_classes) do
+                options.map do |option|
+                  option_theme = option[:theme] || theme
+                  option_classes = option[:classes] || ''
+                  
+                  render BetterUi::General::Input::Radio::Component.new(
+                    name: name,
+                    value: option[:value],
+                    label: option[:label],
+                    checked: selected.to_s == option[:value].to_s,
+                    theme: option_theme,
+                    size: size,
+                    rounded: rounded,
+                    required: required,
+                    disabled: disabled || option[:disabled],
+                    classes: option_classes,
+                    form: form,
+                    **html_options
+                  )
+                end.join.html_safe
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/input/select/select_helper.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module General
+    module Components
+      module Input
+        module Select
+          module SelectHelper
+            # Renders a Select component for selection fields from option lists.
+            #
+            # @param name [String] Name of the select field
+            # @param options [Array<Hash>] Array of select options in format [{value: 'value', label: 'label'}, ...]
+            # @param selected [String, Array, nil] Selected value or values
+            # @param required [Boolean] Whether the field is required
+            # @param disabled [Boolean] Whether the field is disabled
+            # @param multiple [Boolean] Whether multiple options can be selected
+            # @param theme [Symbol] Component theme (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+            # @param size [Symbol] Component size (:small, :medium, :large)
+            # @param rounded [Symbol] Border radius (:none, :small, :medium, :large, :full)
+            # @param placeholder [String, nil] Placeholder text for the field (creates an initial disabled option)
+            # @param classes [String] Additional CSS classes
+            # @param form [ActionView::Helpers::FormBuilder, nil] Optional Rails form builder
+            # @param options_html [Hash] Additional HTML attributes for option tags
+            # @param html_options [Hash] Additional HTML attributes for the select tag
+            #
+            # @return [String] Rendered HTML of the Select component
+            #
+            # @example Basic select
+            #   <%= bui_input_select(name: 'country', options: [{value: 'it', label: 'Italy'}, {value: 'fr', label: 'France'}]) %>
+            #
+            # @example Select with selected option
+            #   <%= bui_input_select(name: 'role', options: roles_array, selected: 'admin') %>
+            #
+            # @example Multiple select
+            #   <%= bui_input_select(name: 'languages[]', options: languages_array, multiple: true, selected: ['en', 'fr']) %>
+            #
+            # @example Select with custom theme and size
+            #   <%= bui_input_select(name: 'category', options: categories_array, theme: :blue, size: :large) %>
+            #
+            # @example With Rails form builder
+            #   <%= form_with model: @user do |form| %>
+            #     <%= bui_input_select(name: :country_id, options: countries_array, form: form, required: true) %>
+            #   <% end %>
+            def bui_input_select(name:, options:, selected: nil, required: false, disabled: false, 
+                           multiple: false, theme: :default, size: :medium, rounded: :medium, 
+                           placeholder: nil, classes: '', form: nil, options_html: {}, **html_options)
+              
+              render BetterUi::General::Input::Select::Component.new(
+                name: name,
+                options: options,
+                selected: selected,
+                required: required,
+                disabled: disabled,
+                multiple: multiple,
+                theme: theme,
+                size: size,
+                rounded: rounded,
+                placeholder: placeholder,
+                classes: classes,
+                form: form,
+                options_html: options_html,
+                **html_options
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/input/text/text_helper.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module General
+    module Components
+      module Input
+        module Text
+          module TextHelper
+            # Renderizza un componente Text Input con tutti i parametri disponibili.
+            #
+            # @param name [String] Nome del campo input (obbligatorio)
+            # @param value [String, nil] Valore del campo
+            # @param placeholder [String, nil] Placeholder del campo
+            # @param required [Boolean] Se il campo è obbligatorio
+            # @param disabled [Boolean] Se il campo è disabilitato
+            # @param type [Symbol] Tipo del campo input (:text, :password, :email, :tel, :url, :number, :search, :color)
+            # @param theme [Symbol] Tema del componente (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+            # @param size [Symbol] Dimensione del componente (:small, :medium, :large)
+            # @param rounded [Symbol] Border radius (:none, :small, :medium, :large, :full)
+            # @param classes [String] Classi CSS aggiuntive
+            # @param form [ActionView::Helpers::FormBuilder, nil] Form builder Rails opzionale
+            # @param options [Hash] Opzioni aggiuntive per l'input (es. data attributes, aria attributes)
+            #
+            # @return [String] HTML del componente Text Input renderizzato
+            #
+            # @example Uso base
+            #   <%= bui_input_text(name: 'email') %>
+            #
+            # @example Con placeholder e validazione
+            #   <%= bui_input_text(name: 'email', placeholder: 'Inserisci la tua email', required: true) %>
+            #
+            # @example Con tema e dimensione personalizzati
+            #   <%= bui_input_text(name: 'search', theme: :blue, size: :large, placeholder: 'Cerca...') %>
+            #
+            # @example Con border radius personalizzato
+            #   <%= bui_input_text(name: 'username', rounded: :full, placeholder: 'Username') %>
+            #
+            # @example Con classi aggiuntive
+            #   <%= bui_input_text(name: 'custom', classes: 'mb-4', placeholder: 'Campo personalizzato') %>
+            #
+            # @example Con attributi HTML aggiuntivi
+            #   <%= bui_input_text(name: 'data-field', 'data-validation': 'email', 'aria-label': 'Campo email') %>
+            #
+            # @example Con Rails form builder
+            #   <%= form_with model: @user do |form| %>
+            #     <%= bui_input_text(name: :email, form: form, theme: :blue, placeholder: 'Email utente') %>
+            #   <% end %>
+            def bui_input_text(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                               type: :text, theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              render BetterUi::General::Input::Text::Component.new(
+                name: name,
+                value: value,
+                placeholder: placeholder,
+                required: required,
+                disabled: disabled,
+                type: type,
+                theme: theme,
+                size: size,
+                rounded: rounded,
+                classes: classes,
+                form: form,
+                **options
+              )
+            end
+
+            # Helper specifici per ogni tipo di input
+
+            # Input di tipo password
+            def bui_input_password(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                                  theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :password, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+            # Input di tipo email
+            def bui_input_email(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                               theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :email, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+            # Input di tipo tel
+            def bui_input_tel(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                             theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :tel, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+            # Input di tipo url
+            def bui_input_url(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                             theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :url, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+            # Input di tipo number
+            def bui_input_number(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                                theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :number, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+            # Input di tipo search
+            def bui_input_search(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                                theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :search, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+
+
+
+
+            # Input di tipo color
+            def bui_input_color(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                               theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              bui_input_text(
+                name: name, value: value, placeholder: placeholder, required: required, disabled: disabled,
+                type: :color, theme: theme, size: size, rounded: rounded, classes: classes, form: form, **options
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/input/textarea/textarea_helper.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module General
+    module Components
+      module Input
+        module Textarea
+          module TextareaHelper
+            # Renderizza un componente Textarea con tutti i parametri disponibili.
+            #
+            # @param name [String] Nome del campo textarea (obbligatorio)
+            # @param value [String, nil] Valore del campo
+            # @param placeholder [String, nil] Placeholder del campo
+            # @param required [Boolean] Se il campo è obbligatorio
+            # @param disabled [Boolean] Se il campo è disabilitato
+            # @param rows [Integer] Numero di righe per la textarea
+            # @param theme [Symbol] Tema del componente (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+            # @param size [Symbol] Dimensione del componente (:small, :medium, :large)
+            # @param rounded [Symbol] Border radius (:none, :small, :medium, :large, :full)
+            # @param classes [String] Classi CSS aggiuntive
+            # @param form [ActionView::Helpers::FormBuilder, nil] Form builder Rails opzionale
+            # @param options [Hash] Opzioni aggiuntive per la textarea (es. data attributes, aria attributes)
+            #
+            # @return [String] HTML del componente Textarea renderizzato
+            #
+            # @example Uso base
+            #   <%= bui_input_textarea(name: 'description') %>
+            #
+            # @example Con placeholder e validazione
+            #   <%= bui_input_textarea(name: 'message', placeholder: 'Inserisci il tuo messaggio', required: true) %>
+            #
+            # @example Con numero di righe personalizzato
+            #   <%= bui_input_textarea(name: 'content', rows: 5, placeholder: 'Contenuto lungo...') %>
+            #
+            # @example Con tema e dimensione personalizzati
+            #   <%= bui_input_textarea(name: 'feedback', theme: :blue, size: :large, rows: 4) %>
+            #
+            # @example Con border radius personalizzato
+            #   <%= bui_input_textarea(name: 'notes', rounded: :large, rows: 3, placeholder: 'Note aggiuntive') %>
+            #
+            # @example Con classi aggiuntive
+            #   <%= bui_input_textarea(name: 'custom', classes: 'mb-4', rows: 6, placeholder: 'Campo personalizzato') %>
+            #
+            # @example Con attributi HTML aggiuntivi
+            #   <%= bui_input_textarea(name: 'data-field', rows: 4, 'data-validation': 'required', 'aria-label': 'Campo textarea') %>
+            #
+            # @example Con Rails form builder
+            #   <%= form_with model: @post do |form| %>
+            #     <%= bui_input_textarea(name: :content, form: form, theme: :blue, rows: 8, placeholder: 'Contenuto del post') %>
+            #   <% end %>
+            def bui_input_textarea(name:, value: nil, placeholder: nil, required: false, disabled: false,
+                                   rows: 3, theme: :default, size: :medium, rounded: :medium, classes: '', form: nil, **options)
+              render BetterUi::General::Input::Textarea::Component.new(
+                name: name,
+                value: value,
+                placeholder: placeholder,
+                required: required,
+                disabled: disabled,
+                rows: rows,
+                theme: theme,
+                size: size,
+                rounded: rounded,
+                classes: classes,
+                form: form,
+                **options
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,89 @@
+module BetterUi
+  module General
+    module Components
+      module Link
+        module LinkHelper
+          # Genera un link usando BetterUi::General::Link::Component
+          #
+          # @param label [String] testo del link
+          # @param href [String] URL di destinazione (nil per semplice testo)
+          # @param theme [Symbol] tema del colore (:default, :white, etc.)
+          # @param orientation [Symbol] orientamento (:horizontal, :vertical)
+          # @param style [Symbol] stile (:default, :underline, :bold, :text)
+          # @param size [Symbol] dimensione (:extra_small, :small, :medium, :large)
+          # @param icon [String] icona opzionale
+          # @param active [Boolean] stato attivo del link
+          # @param disabled [Boolean] stato disabilitato del link
+          # @param data [Hash] attributi data
+          # @param method [Symbol] metodo HTTP (per Turbo)
+          # @param target [String] target del link
+          # @param html_options [Hash] opzioni HTML aggiuntive
+          # @return [String] HTML del link renderizzato
+          #
+          # @example Uso base
+          #   bui_link("Home", href: "/")
+          #   bui_link("Contatti", href: "/contact", theme: :blue)
+          #
+          # @example Con icona
+          #   bui_link("Dashboard", href: "/admin", icon: "home", theme: :green)
+          #
+          # @example Link attivo
+          #   bui_link("Pagina corrente", href: "/current", active: true)
+          #
+          # @example Link disabilitato (diventa span)
+          #   bui_link("Non disponibile", disabled: true)
+          #
+          # @example Con attributi Turbo
+          #   bui_link("Elimina", href: "/delete", method: :delete,
+          #            data: { confirm: "Sei sicuro?" }, theme: :red)
+          #
+          # @example Con opzioni avanzate
+          #   bui_link(
+          #     "Link esterno",
+          #     href: "https://example.com",
+          #     theme: :violet,
+          #     orientation: :vertical,
+          #     style: :bold,
+          #     size: :large,
+          #     icon: "external-link",
+          #     target: "_blank",
+          #     id: "external-link",
+          #     class: "custom-link"
+          #   )
+          def bui_link(
+            label,
+            href: nil,
+            theme: :white,
+            orientation: :horizontal,
+            style: :default,
+            size: :medium,
+            icon: nil,
+            active: false,
+            disabled: false,
+            data: {},
+            method: nil,
+            target: nil,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Link::Component.new(
+              label: label,
+              href: href,
+              theme: theme,
+              orientation: orientation,
+              style: style,
+              size: size,
+              icon: icon,
+              active: active,
+              disabled: disabled,
+              data: data,
+              method: method,
+              target: target,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/modal/modal_helper.rb

@@ -0,0 +1,95 @@
+module BetterUi
+  module General
+    module Components
+      module Modal
+        module ModalHelper
+          # Helper per renderizzare un modal
+          #
+          # @param title [String] Il titolo del modal (obbligatorio)
+          # @param theme [Symbol] Il tema dell'header del modal
+          # @param size [Symbol] La dimensione del modal
+          # @param rounded [Symbol] Il border radius del modal
+          # @param backdrop [Boolean] Se mostrare l'overlay di sfondo cliccabile
+          # @param closable [Boolean] Se mostrare il pulsante di chiusura
+          # @param classes [String] Classi CSS aggiuntive per il contenitore
+          # @param html_options [Hash] Attributi HTML aggiuntivi
+          #
+          # @option theme [Symbol] :default (default) Header con sfondo grigio chiaro
+          # @option theme [Symbol] :white Header con sfondo bianco
+          # @option theme [Symbol] :red Header con sfondo rosso chiaro
+          # @option theme [Symbol] :rose Header con sfondo rosa chiaro
+          # @option theme [Symbol] :orange Header con sfondo arancione chiaro
+          # @option theme [Symbol] :green Header con sfondo verde chiaro
+          # @option theme [Symbol] :blue Header con sfondo blu chiaro
+          # @option theme [Symbol] :yellow Header con sfondo giallo chiaro
+          # @option theme [Symbol] :violet Header con sfondo violetto chiaro
+          #
+          # @option size [Symbol] :small (max-w-sm) Modal piccolo
+          # @option size [Symbol] :medium (max-w-md, default) Modal medio
+          # @option size [Symbol] :large (max-w-2xl) Modal grande
+          #
+          # @option rounded [Symbol] :none (rounded-none) Nessun border radius
+          # @option rounded [Symbol] :small (rounded-md) Border radius piccolo
+          # @option rounded [Symbol] :medium (rounded-lg, default) Border radius medio
+          # @option rounded [Symbol] :large (rounded-xl) Border radius grande
+          # @option rounded [Symbol] :full (rounded-full) Border radius completo
+          #
+          # @return [String] HTML del modal
+          #
+          # @example Utilizzo base
+          #   <%= bui_modal(title: "Conferma azione") do %>
+          #     <p>Sei sicuro di voler continuare?</p>
+          #   <% end %>
+          #
+          # @example Con tema, dimensione e border radius
+          #   <%= bui_modal(title: "Attenzione", theme: :red, size: :large, rounded: :large) do %>
+          #     <p>Questa azione non può essere annullata.</p>
+          #   <% end %>
+          #
+          # @example Senza backdrop
+          #   <%= bui_modal(title: "Informazioni", backdrop: false) do %>
+          #     <p>Contenuto del modal senza overlay di sfondo.</p>
+          #   <% end %>
+          #
+          # @example Non chiudibile
+          #   <%= bui_modal(title: "Caricamento", closable: false) do %>
+          #     <p>Operazione in corso...</p>
+          #   <% end %>
+          #
+          # @example Con bottoni di azione
+          #   <%= bui_modal(title: "Elimina elemento", theme: :red) do %>
+          #     <p>Sei sicuro di voler eliminare questo elemento?</p>
+          #     <p class="text-sm text-gray-600 mt-2">Questa azione non può essere annullata.</p>
+          #     
+          #     <div class="flex justify-end space-x-3 mt-6">
+          #       <%= bui_button(label: "Annulla", type: :white, size: :medium) %>
+          #       <%= bui_button(label: "Elimina", type: :red, size: :medium) %>
+          #     </div>
+          #   <% end %>
+          def bui_modal(
+            title:,
+            theme: :default,
+            size: :medium,
+            rounded: :medium,
+            backdrop: true,
+            closable: true,
+            classes: nil,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Modal::Component.new(
+              title: title,
+              theme: theme,
+              size: size,
+              rounded: rounded,
+              backdrop: backdrop,
+              closable: closable,
+              classes: classes,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/pagination/pagination_helper.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module General
+    module Components
+      module Pagination
+        module PaginationHelper
+          # Genera un componente di navigazione paginata per liste e tabelle
+          #
+          # @param current_page [Integer] La pagina corrente (1-indexed)
+          # @param total_pages [Integer] Il numero totale di pagine
+          # @param path [String] L'URL base per costruire i link di paginazione
+          # @param theme [Symbol] Il tema del componente (:default, :blue, :red, :green, :yellow, :violet, :orange, :rose, :white)
+          # @param size [Symbol] La dimensione del componente (:small, :medium, :large)
+          # @param window [Integer] Il numero di pagine da mostrare intorno alla pagina corrente (default: 2)
+          # @param show_info [Boolean] Se mostrare le informazioni sui risultati (default: false)
+          # @param per_page [Integer] Il numero di elementi per pagina (richiesto se show_info è true)
+          # @param classes [String] Classi CSS aggiuntive
+          # @param form [FormBuilder, nil] Form builder per l'integrazione con Rails form (opzionale)
+          # @param options [Hash] Attributi HTML aggiuntivi
+          # @return [String] Il markup HTML del componente pagination
+          #
+          # @example Uso base standalone
+          #   <%= bui_pagination(current_page: 3, total_pages: 10, path: '/products') %>
+          #
+          # @example Con tema e dimensione personalizzati
+          #   <%= bui_pagination(
+          #     current_page: 5, 
+          #     total_pages: 20, 
+          #     path: '/articles',
+          #     theme: :blue,
+          #     size: :large
+          #   ) %>
+          #
+          # @example Con informazioni sui risultati
+          #   <%= bui_pagination(
+          #     current_page: 2,
+          #     total_pages: 8,
+          #     path: '/users',
+          #     show_info: true,
+          #     per_page: 25,
+          #     theme: :green
+          #   ) %>
+          #
+          # @example Con finestra di pagine personalizzata
+          #   <%= bui_pagination(
+          #     current_page: 10,
+          #     total_pages: 50,
+          #     path: '/orders',
+          #     window: 3,
+          #     size: :small
+          #   ) %>
+          #
+          # @example Con attributi HTML aggiuntivi
+          #   <%= bui_pagination(
+          #     current_page: 1,
+          #     total_pages: 5,
+          #     path: '/dashboard',
+          #     classes: 'my-4',
+          #     data: { turbo_frame: 'content' }
+          #   ) %>
+          def bui_pagination(current_page:, total_pages:, path:, theme: :default, size: :medium,
+                             window: 2, show_info: false, per_page: nil, classes: '', 
+                             form: nil, **options)
+            render BetterUi::General::Pagination::Component.new(
+              current_page: current_page,
+              total_pages: total_pages,
+              path: path,
+              theme: theme,
+              size: size,
+              window: window,
+              show_info: show_info,
+              per_page: per_page,
+              classes: classes,
+              **options
+            )
+          end
+        end
+      end
+    end
+  end
+end