better_ui 0.3.0 → 0.5.1

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

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

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

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

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

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

@@ -1,85 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Modal
-        module ModalHelper
-          # Helper per renderizzare un modal con trigger e contenuto
-          #
-          # @param close_on_backdrop [Boolean] Se chiudere il modal cliccando sul backdrop
-          # @param close_on_escape [Boolean] Se chiudere il modal premendo Escape
-          # @param lock_scroll [Boolean] Se bloccare lo scroll del body quando il modal è aperto
-          # @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 con button trigger
-          #   <%= bui_modal do |modal| %>
-          #     <% modal.with_trigger(label: "Apri Modal", as: :button, type: :primary) %>
-          #     <% modal.with_modal(title: "Conferma azione") do %>
-          #       <p>Sei sicuro di voler continuare?</p>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Con link trigger
-          #   <%= bui_modal do |modal| %>
-          #     <% modal.with_trigger(label: "Visualizza dettagli", as: :link, variant: :underline) %>
-          #     <% modal.with_modal(title: "Dettagli elemento", theme: :blue, size: :large) do %>
-          #       <p>Informazioni dettagliate sull'elemento selezionato.</p>
-          #     <% end %>
-          #   <% end %>
-          #
-          # @example Modal con configurazione avanzata
-          #   <%= bui_modal(close_on_backdrop: false, lock_scroll: false) do |modal| %>
-          #     <% modal.with_trigger(label: "Elimina", as: :button, type: :red, size: :small) %>
-          #     <% modal.with_modal(title: "Elimina elemento", theme: :red, backdrop: true, closable: true) 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 %>
-          #   <% end %>
-          def bui_modal(
-            close_on_backdrop: true,
-            close_on_escape: true,
-            lock_scroll: true,
-            classes: nil,
-            **html_options,
-            &block
-          )
-            render BetterUi::General::Modal::Component.new(
-              close_on_backdrop: close_on_backdrop,
-              close_on_escape: close_on_escape,
-              lock_scroll: lock_scroll,
-              classes: classes,
-              **html_options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

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

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

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

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