better_ui 0.6.0 → 0.7.1

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

data/app/helpers/better_ui/general/components/dropdown/dropdown_helper.rb

@@ -1,88 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Dropdown
-        module DropdownHelper
-          ##
-          # Crea un componente dropdown interattivo con menu contestuale.
-          #
-          # @param trigger [String] Il testo del pulsante trigger (obbligatorio)
-          # @param position [Symbol] La posizione del menu dropdown (:bottom, :top, :left, :right)
-          # @param theme [Symbol] Il tema colore del trigger (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
-          # @param size [Symbol] La dimensione del trigger (:small, :medium, :large)
-          # @param rounded [Symbol] Il border radius (:none, :small, :medium, :large, :full)
-          # @param animation [Symbol] Il tipo di animazione (:fade, :slide, :none)
-          # @param fullwidth [Boolean] Se il trigger deve occupare tutta la larghezza disponibile
-          # @param show_chevron [Boolean] Se mostrare l'icona chevron automatica
-          # @param selectable [Boolean] Se il dropdown deve aggiornare il trigger con la selezione
-          # @param classes [String] Classi CSS aggiuntive
-          # @param options [Hash] Attributi HTML aggiuntivi
-          # @param block [Proc] Il contenuto del menu dropdown
-          #
-          # @return [String] Il markup HTML del componente dropdown
-          #
-          # @example Uso base
-          #   <%= bui_dropdown(trigger: "Azioni") do %>
-          #     <%= bui_dropdown_item(text: "Modifica") %>
-          #   <% end %>
-          #
-          # @example Con posizione e tema
-          #   <%= bui_dropdown(trigger: "Menu", position: :top, theme: :blue) do %>
-          #     <%= bui_dropdown_item(text: "Profilo", icon: "user") %>
-          #     <%= bui_dropdown_divider %>
-          #     <%= bui_dropdown_item(text: "Logout", icon: "logout") %>
-          #   <% end %>
-          #
-          # @example Con dimensioni e stile
-          #   <%= bui_dropdown(trigger: "Opzioni", size: :large, rounded: :full, animation: :slide) do %>
-          #     <%= bui_dropdown_item(text: "Impostazioni", icon: "cog") %>
-          #   <% end %>
-          #
-          # @example Con link e azioni
-          #   <%= bui_dropdown(trigger: "Utente", theme: :green) do %>
-          #     <%= bui_dropdown_item(text: "Dashboard", href: "/dashboard") %>
-          #     <%= bui_dropdown_item(text: "Profilo", href: "/profile") %>
-          #     <%= bui_dropdown_divider %>
-          #     <%= bui_dropdown_item(text: "Elimina", theme: :red, icon: "trash") %>
-          #   <% end %>
-          #
-          # @example Con attributi HTML personalizzati
-          #   <%= bui_dropdown(trigger: "Menu", id: "main-menu", data: { controller: "dropdown" }) do %>
-          #     <%= bui_dropdown_item(text: "Item 1") %>
-          #   <% end %>
-          #
-          def bui_dropdown(
-            trigger:,
-            position: :bottom,
-            theme: :default,
-            size: :medium,
-            rounded: :medium,
-            animation: :fade,
-            fullwidth: false,
-            show_chevron: true,
-            selectable: false,
-            classes: '',
-            **options,
-            &block
-          )
-            render BetterUi::General::Dropdown::Component.new(
-              trigger: trigger,
-              position: position,
-              theme: theme,
-              size: size,
-              rounded: rounded,
-              animation: animation,
-              fullwidth: fullwidth,
-              show_chevron: show_chevron,
-              selectable: selectable,
-              classes: classes,
-              **options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/dropdown/item_helper.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Dropdown
-        module ItemHelper
-          ##
-          # Crea un elemento del menu dropdown.
-          #
-          # @param text [String] Il testo dell'elemento (obbligatorio)
-          # @param icon [String] Il nome dell'icona da mostrare ("edit", "trash", "share", "user", "cog", "logout")
-          # @param href [String] L'URL per renderlo un link
-          # @param theme [Symbol] Il tema colore (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
-          # @param disabled [Boolean] Se l'elemento è disabilitato
-          # @param active [Boolean] Se l'elemento è attivo/selezionato
-          # @param classes [String] Classi CSS aggiuntive
-          # @param options [Hash] Attributi HTML aggiuntivi
-          #
-          # @return [String] Il markup HTML dell'elemento dropdown
-          #
-          # @example Uso base
-          #   <%= bui_dropdown_item("Modifica") %>
-          #
-          # @example Con icona
-          #   <%= bui_dropdown_item("Elimina", icon: "trash") %>
-          #
-          # @example Come link
-          #   <%= bui_dropdown_item("Profilo", href: "/profile", icon: "user") %>
-          #
-          # @example Con tema colorato
-          #   <%= bui_dropdown_item("Azione pericolosa", theme: :red, icon: "trash") %>
-          #
-          # @example Disabilitato
-          #   <%= bui_dropdown_item("Non disponibile", disabled: true) %>
-          #
-          # @example Uso con sintassi keyword (backward compatible)
-          #   <%= bui_dropdown_item(text: "Modifica legacy") %>
-          #
-          def bui_dropdown_item(
-            text = nil,
-            icon: nil,
-            href: nil,
-            theme: :default,
-            disabled: false,
-            active: false,
-            classes: '',
-            **options
-          )
-            # Supporta sia sintassi posizionale che keyword per backward compatibility
-            item_text = text || options.delete(:text)
-            
-            render BetterUi::General::Dropdown::ItemComponent.new(
-              text: item_text,
-              icon: icon,
-              href: href,
-              theme: theme,
-              disabled: disabled,
-              active: active,
-              classes: classes,
-              **options
-            )
-          end
-        end
-      end
-    end
-  end
-end

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

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

data/app/helpers/better_ui/general/components/grid/grid_helper.rb

@@ -1,145 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Grid
-        module GridHelper
-          # Helper per creare un contenitore grid CSS
-          #
-          # @param cols [Integer, Hash] Numero colonne (1-12, :auto, :none) o hash responsive {sm: 1, md: 2, lg: 3, xl: 4}
-          # @param rows [Integer, Hash, nil] Numero righe (1-6, :auto, :none) o hash responsive
-          # @param gap [Symbol, Hash] Spaziatura (:none, :small, :medium, :large) o hash responsive
-          # @param flow [Symbol] Direzione flusso (:row, :col, :row_dense, :col_dense)
-          # @param align_items [Symbol, nil] Allineamento verticale (:start, :center, :end, :stretch)
-          # @param justify_items [Symbol, nil] Allineamento orizzontale (:start, :center, :end, :stretch)
-          # @param classes [String] Classi CSS aggiuntive
-          # @param id [String, nil] ID elemento
-          # @param options [Hash] Attributi HTML aggiuntivi
-          # @param block [Proc] Blocco contenente le celle grid
-          #
-          # @return [String] HTML del grid container
-          #
-          # @example Uso base
-          #   <%= bui_grid(cols: 3, gap: :medium) do %>
-          #     <%= content %>
-          #   <% end %>
-          #
-          # @example Con responsive
-          #   <%= bui_grid(cols: {sm: 1, md: 2, lg: 3, xl: 4}, gap: :large) do %>
-          #     <%= content %>
-          #   <% end %>
-          #
-          # @example Con righe e allineamento
-          #   <%= bui_grid(cols: 2, rows: 3, gap: :medium, align_items: :center) do %>
-          #     <%= content %>
-          #   <% end %>
-          #
-          # @example Con flow e justify
-          #   <%= bui_grid(cols: 4, flow: :col, justify_items: :center) do %>
-          #     <%= content %>
-          #   <% end %>
-          #
-          # @example Con attributi HTML aggiuntivi
-          #   <%= bui_grid(cols: 3, id: "main-grid", data: {testid: "grid"}) do %>
-          #     <%= content %>
-          #   <% end %>
-          def bui_grid(
-            cols: 1,
-            rows: nil,
-            gap: :medium,
-            flow: :row,
-            align_items: nil,
-            justify_items: nil,
-            classes: '',
-            id: nil,
-            **options,
-            &block
-          )
-            render BetterUi::General::Grid::Component.new(
-              cols: cols,
-              rows: rows,
-              gap: gap,
-              flow: flow,
-              align_items: align_items,
-              justify_items: justify_items,
-              classes: classes,
-              id: id,
-              **options
-            ), &block
-          end
-
-          # Helper per creare una cella grid con controllo posizionamento
-          #
-          # @param col [Integer, Hash, nil] Span colonne (1-12, :auto, :full) o hash responsive {sm: 1, md: 2, lg: 3}
-          # @param row [Integer, Hash, nil] Span righe (1-6, :auto, :full) o hash responsive
-          # @param col_start [Integer, Hash, nil] Posizione inizio colonna (1-13, :auto) o hash responsive
-          # @param col_end [Integer, Hash, nil] Posizione fine colonna (1-13, :auto) o hash responsive
-          # @param row_start [Integer, Hash, nil] Posizione inizio riga (1-7, :auto) o hash responsive
-          # @param row_end [Integer, Hash, nil] Posizione fine riga (1-7, :auto) o hash responsive
-          # @param justify_self [Symbol, nil] Allineamento orizzontale cella (:auto, :start, :center, :end, :stretch)
-          # @param align_self [Symbol, nil] Allineamento verticale cella (:auto, :start, :center, :end, :stretch)
-          # @param classes [String] Classi CSS aggiuntive
-          # @param id [String, nil] ID elemento
-          # @param options [Hash] Attributi HTML aggiuntivi
-          # @param block [Proc] Blocco contenente il contenuto della cella
-          #
-          # @return [String] HTML della grid cell
-          #
-          # @example Uso base
-          #   <%= bui_grid_cell do %>
-          #     <div>Contenuto cella</div>
-          #   <% end %>
-          #
-          # @example Con span colonne
-          #   <%= bui_grid_cell(col: 2) do %>
-          #     <div>Cella che occupa 2 colonne</div>
-          #   <% end %>
-          #
-          # @example Con responsive
-          #   <%= bui_grid_cell(col: {sm: 1, md: 2, lg: 3}) do %>
-          #     <div>Cella responsive</div>
-          #   <% end %>
-          #
-          # @example Con posizionamento specifico
-          #   <%= bui_grid_cell(col_start: 2, col_end: 4) do %>
-          #     <div>Cella dalla colonna 2 alla 4</div>
-          #   <% end %>
-          #
-          # @example Con allineamento
-          #   <%= bui_grid_cell(col: 2, justify_self: :center, align_self: :start) do %>
-          #     <div>Cella centrata orizzontalmente</div>
-          #   <% end %>
-          def bui_grid_cell(
-            col: nil,
-            row: nil,
-            col_start: nil,
-            col_end: nil,
-            row_start: nil,
-            row_end: nil,
-            justify_self: nil,
-            align_self: nil,
-            classes: '',
-            id: nil,
-            **options,
-            &block
-          )
-            render BetterUi::General::Grid::CellComponent.new(
-              col: col,
-              row: row,
-              col_start: col_start,
-              col_end: col_end,
-              row_start: row_start,
-              row_end: row_end,
-              justify_self: justify_self,
-              align_self: align_self,
-              classes: classes,
-              id: id,
-              **options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/heading/heading_helper.rb

@@ -1,72 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Heading
-        module HeadingHelper
-          # Genera un heading usando BetterUi::General::Heading::Component
-          #
-          # @param text [String] testo del heading
-          # @param level [Integer] livello del heading (1-6)
-          # @param theme [Symbol] tema del colore (:default, :white, etc.)
-          # @param align [Symbol] allineamento (:left, :center, :right)
-          # @param size [Symbol] dimensione (:small, :medium, :large)
-          # @param style [Symbol] stile (:normal, :bold, :italic, :underline)
-          # @param icon [String] icona opzionale
-          # @param subtitle [String] sottotitolo opzionale
-          # @param with_divider [Boolean] mostra linea divisoria
-          # @param html_options [Hash] opzioni HTML per il container
-          # @return [String] HTML del heading renderizzato
-          #
-          # @example Uso base
-          #   bui_heading("Titolo principale")
-          #   bui_heading("Sottotitolo", level: 3, theme: :blue)
-          #
-          # @example Con icona e sottotitolo
-          #   bui_heading("Dashboard", icon: "home", subtitle: "Panoramica generale")
-          #
-          # @example Con divider
-          #   bui_heading("Sezione", level: 2, with_divider: true, theme: :green)
-          #
-          # @example Con opzioni avanzate
-          #   bui_heading(
-          #     "Titolo personalizzato",
-          #     level: 1,
-          #     theme: :violet,
-          #     align: :center,
-          #     size: :large,
-          #     style: :bold,
-          #     icon: "star",
-          #     subtitle: "Con tutte le opzioni",
-          #     with_divider: true,
-          #     id: "main-title",
-          #     class: "custom-heading"
-          #   )
-          def bui_heading(
-            text,
-            level: 2,
-            theme: :white,
-            align: :left,
-            size: :medium,
-            style: :normal,
-            icon: nil,
-            subtitle: nil,
-            with_divider: false,
-            **html_options
-          )
-            render BetterUi::General::Heading::Component.new(
-              level: level,
-              theme: theme,
-              align: align,
-              size: size,
-              style: style,
-              icon: icon,
-              subtitle: subtitle,
-              with_divider: with_divider,
-              **html_options
-            ).with_content(text)
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/icon/icon_helper.rb

@@ -1,16 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Icon
-        module IconHelper
-          def bui_icon(name = nil, **options)
-            render BetterUi::General::Icon::Component.new(
-              name: name,
-              **options
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/input/checkbox/checkbox_helper.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module General
-    module Components
-      module Input
-        module Checkbox
-          module CheckboxHelper
-            # Renderizza un componente Checkbox con tutti i parametri disponibili.
-            #
-            # @param name [String] Nome del campo checkbox (obbligatorio)
-            # @param value [String] Valore del checkbox (default: "1")
-            # @param checked [Boolean] Se il checkbox è selezionato
-            # @param required [Boolean] Se il campo è obbligatorio
-            # @param disabled [Boolean] Se il campo è disabilitato
-            # @param indeterminate [Boolean] Se il checkbox è in stato indeterminate
-            # @param label [String, nil] Testo della label associata al checkbox
-            # @param label_position [Symbol] Posizione della label (:left, :right)
-            # @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 Checkbox renderizzato
-            #
-            # @example Uso base
-            #   <%= bui_input_checkbox(name: 'accept_terms') %>
-            #
-            # @example Con label
-            #   <%= bui_input_checkbox(name: 'newsletter', label: 'Iscriviti alla newsletter', checked: true) %>
-            #
-            # @example Con label a sinistra
-            #   <%= bui_input_checkbox(name: 'terms', label: 'Accetto i termini e condizioni', label_position: :left, required: true) %>
-            #
-            # @example Con tema e dimensione personalizzati
-            #   <%= bui_input_checkbox(name: 'important', label: 'Importante', theme: :green, size: :large) %>
-            #
-            # @example Con border radius personalizzato
-            #   <%= bui_input_checkbox(name: 'rounded_option', label: 'Opzione arrotondata', rounded: :full) %>
-            #
-            # @example Con classi aggiuntive
-            #   <%= bui_input_checkbox(name: 'custom', label: 'Campo personalizzato', classes: 'mb-4', checked: true) %>
-            #
-            # @example Con attributi HTML aggiuntivi
-            #   <%= bui_input_checkbox(name: 'data-field', label: 'Campo obbligatorio', 'data-validation': 'required', 'aria-describedby': 'help-text') %>
-            #
-            # @example Con Rails form builder
-            #   <%= form_with model: @user do |form| %>
-            #     <%= bui_input_checkbox(name: :terms_accepted, label: 'Accetto i termini', form: form, theme: :green, required: true) %>
-            #   <% end %>
-            #
-            # @example Stato indeterminate
-            #   <%= bui_input_checkbox(name: 'partial_selection', label: 'Selezione parziale', indeterminate: true, theme: :blue) %>
-            def bui_input_checkbox(name:, value: '1', checked: false, required: false, disabled: false,
-                                   indeterminate: false, label: nil, label_position: :right, theme: :default, 
-                                   size: :medium, rounded: :medium, classes: '', form: nil, **options)
-              render BetterUi::General::Input::Checkbox::Component.new(
-                name: name,
-                value: value,
-                checked: checked,
-                required: required,
-                disabled: disabled,
-                indeterminate: indeterminate,
-                label: label,
-                label_position: label_position,
-                theme: theme,
-                size: size,
-                rounded: rounded,
-                classes: classes,
-                form: form,
-                **options
-              )
-            end
-          end
-        end
-      end
-    end
-  end
-end