better_ui 0.1.0 → 0.1.1

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/panel/panel_helper.rb

@@ -0,0 +1,83 @@
+module BetterUi
+  module General
+    module Components
+      module Panel
+        module PanelHelper
+          # Genera un pannello usando BetterUi::General::Panel::Component
+          #
+          # @param title [String] titolo del pannello (opzionale)
+          # @param body [String] contenuto HTML del pannello (opzionale)
+          # @param header [String] header personalizzato (opzionale)
+          # @param footer [String] footer del pannello (opzionale)
+          # @param theme [Symbol] tema del colore (:default, :white, etc.)
+          # @param style [Symbol] stile (:default, :flat, :raised, :bordered)
+          # @param padding [Symbol] padding interno (:none, :small, :medium, :large)
+          # @param radius [Symbol] raggio dei bordi (:none, :small, :medium, :large, :full)
+          # @param html_options [Hash] opzioni HTML aggiuntive
+          # @return [String] HTML del pannello renderizzato
+          #
+          # @example Uso base
+          #   bui_panel(title: "Dashboard")
+          #   bui_panel(body: "Contenuto del pannello")
+          #
+          # @example Pannello completo
+          #   bui_panel(
+          #     title: "Impostazioni",
+          #     body: "Configura le tue preferenze",
+          #     footer: "Ultimo aggiornamento: oggi",
+          #     theme: :blue
+          #   )
+          #
+          # @example Con header personalizzato
+          #   bui_panel(
+          #     header: "<h2>Header Custom</h2>",
+          #     body: "Il mio contenuto",
+          #     theme: :green,
+          #     style: :raised
+          #   )
+          #
+          # @example Pannello con stili avanzati
+          #   bui_panel(
+          #     title: "Card Premium",
+          #     body: "Contenuto speciale",
+          #     theme: :violet,
+          #     style: :bordered,
+          #     padding: :large,
+          #     radius: :large,
+          #     id: "premium-panel",
+          #     class: "special-panel"
+          #   )
+          #
+          # @example Con contenuto block
+          #   bui_panel(title: "Lista Utenti", theme: :white) do
+          #     "<ul><li>Utente 1</li><li>Utente 2</li></ul>".html_safe
+          #   end
+          def bui_panel(
+            title: nil,
+            body: nil,
+            header: nil,
+            footer: nil,
+            theme: :white,
+            style: :default,
+            padding: :medium,
+            radius: :small,
+            **html_options,
+            &block
+          )
+            render BetterUi::General::Panel::Component.new(
+              title: title,
+              body: body,
+              header: header,
+              footer: footer,
+              theme: theme,
+              style: style,
+              padding: padding,
+              radius: radius,
+              **html_options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/progress/progress_helper.rb

@@ -0,0 +1,53 @@
+module BetterUi
+  module General
+    module Components
+      module Progress
+        module ProgressHelper
+          # Helper per renderizzare una progress bar
+          #
+          # @param value [Integer] percentuale di completamento (0-100)
+          # @param theme [Symbol] tema del colore (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
+          # @param size [Symbol] dimensione della progress bar (:small, :medium, :large)
+          # @param label [Boolean] mostra etichetta con percentuale
+          # @param classes [String] classi CSS aggiuntive
+          # @param html_options [Hash] opzioni HTML aggiuntive
+          #
+          # @return [String] HTML della progress bar
+          #
+          # @example Uso base
+          #   bui_progress(value: 75)
+          #
+          # @example Progress con etichetta
+          #   bui_progress(value: 50, label: true, theme: :green)
+          #
+          # @example Progress personalizzata
+          #   bui_progress(
+          #     value: 90,
+          #     theme: :blue,
+          #     size: :large,
+          #     label: true,
+          #     classes: "my-custom-class",
+          #     id: "main-progress"
+          #   )
+          def bui_progress(
+            value: 0,
+            theme: :white,
+            size: :medium,
+            label: false,
+            classes: nil,
+            **html_options
+          )
+            render BetterUi::General::Progress::Component.new(
+              value: value,
+              theme: theme,
+              size: size,
+              label: label,
+              classes: classes,
+              **html_options
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/spinner/spinner_helper.rb

@@ -0,0 +1,19 @@
+module BetterUi
+  module General
+    module Components
+      module Spinner
+        module SpinnerHelper
+          def bui_spinner(label = nil, **options)
+            render BetterUi::General::Spinner::Component.new(
+              label: label,
+              **options
+            )
+          end
+
+          # Supporto per la sintassi originale per compatibilità
+          alias_method :better_ui_general_spinner, :bui_spinner
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/table_helper.rb

@@ -0,0 +1,53 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TableHelper
+
+          # Renderizza un componente Table per visualizzare dati strutturati in formato tabellare.
+          #
+          # @param headers [Array<String>] Intestazioni delle colonne della tabella
+          # @param rows [Array<Array>] Dati delle righe della tabella
+          # @param striped [Boolean] Applica righe alternate con colori diversi
+          # @param bordered [Boolean] Aggiunge bordi alla tabella
+          # @param hover [Boolean] Aggiunge effetto hover sulle righe
+          # @param responsive [Boolean] Rende la tabella responsiva (scrollabile orizzontalmente)
+          # @param compact [Boolean] Riduce la spaziatura interna
+          # @param theme [Symbol] Tema della tabella (:default, :white, :gray)
+          # @param size [Symbol] Dimensione della tabella (:small, :medium, :large)
+          # @param rounded [Symbol] Arrotondamento degli angoli (:none, :small, :medium, :large)
+          # @param classes [String] Classi CSS aggiuntive
+          # @param options [Hash] Attributi HTML aggiuntivi
+          #
+          # @return [String] HTML della tabella renderizzata
+          #
+          # @example Tabella base con intestazioni e righe
+          #   <%= bui_table(headers: ['Nome', 'Email'], rows: [['Mario Rossi', 'mario@example.com']]) %>
+          #
+          # @example Tabella con righe alternate e bordi
+          #   <%= bui_table(headers: ['ID', 'Prodotto', 'Prezzo'], 
+          #                rows: [[1, 'Scarpe', '€80'], [2, 'Camicia', '€40']], 
+          #                striped: true, bordered: true) %>
+          #
+          # @example Tabella con stile personalizzato
+          #   <%= bui_table(headers: ['Data', 'Evento'], 
+          #                rows: [['10/01/2023', 'Riunione'], ['15/01/2023', 'Scadenza']], 
+          #                theme: :blue, size: :large, hover: true) %>
+          #
+          # @example Tabella responsiva per dispositivi mobili
+          #   <%= bui_table(headers: ['Prodotto', 'Descrizione', 'Prezzo', 'Disponibilità'], 
+          #                rows: [...], 
+          #                responsive: true) %>
+          #
+          # @example Tabella con attributi HTML personalizzati
+          #   <%= bui_table(headers: ['Nome', 'Email'], 
+          #                rows: [['Mario Rossi', 'mario@example.com']], 
+          #                id: 'users-table', 'data-sortable': true) %>
+          def bui_table(**options, &block)
+            render BetterUi::General::Table::Component.new(**options), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/tbody_helper.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TbodyHelper
+          def bui_tbody(**options, &block)
+            render BetterUi::General::Table::TbodyComponent.new(**options), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/td_helper.rb

@@ -0,0 +1,19 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TdHelper
+          def bui_td(content = nil, **options, &block)
+            if block_given?
+              render BetterUi::General::Table::TdComponent.new(**options), &block
+            else
+              render BetterUi::General::Table::TdComponent.new(**options) do
+                content
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/tfoot_helper.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TfootHelper
+          def bui_tfoot(**options, &block)
+            render BetterUi::General::Table::TfootComponent.new(**options), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/th_helper.rb

@@ -0,0 +1,19 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module ThHelper
+          def bui_th(content = nil, **options, &block)
+            if block_given?
+              render BetterUi::General::Table::ThComponent.new(**options), &block
+            else
+              render BetterUi::General::Table::ThComponent.new(**options) do
+                content
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/thead_helper.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TheadHelper
+          def bui_thead(**options, &block)
+            render BetterUi::General::Table::TheadComponent.new(**options), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/table/tr_helper.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Table
+        module TrHelper
+          def bui_tr(**options, &block)
+            render BetterUi::General::Table::TrComponent.new(**options), &block
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/tag/tag_helper.rb

@@ -0,0 +1,26 @@
+module BetterUi
+  module General
+    module Components
+      module Tag
+        module TagHelper
+        # Render un tag con le opzioni specificate
+        #
+        # @param text [String] testo del tag (obbligatorio)
+        # @param options [Hash] opzioni per il componente
+        #
+        # @option options [Symbol] :theme (:white) tema del colore (:default, :white, :red, etc.)
+        # @option options [Symbol] :size (:medium) dimensione (:small, :medium, :large)
+        # @option options [Symbol] :style (:filled) stile (:filled, :outline)
+        #
+        # @return [String] HTML del componente
+        def bui_tag(text, **options)
+          render BetterUi::General::Tag::Component.new(
+            text: text,
+            **options
+          )
+        end
+        end
+      end
+    end
+  end
+end