better_ui 0.6.0 → 0.7.0

data/app/helpers/better_ui/application/components/card/card_helper.rb

@@ -1,96 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module Application
-    module Components
-      module Card
-        module CardHelper
-          # Helper per creare una card per metriche e statistiche nelle dashboard applicative
-          #
-          # @param title [String] Il titolo/etichetta della metrica
-          # @param value [String] Il valore principale da visualizzare
-          # @param trend [Symbol, nil] La direzione del trend (:up, :down, nil), default nil
-          # @param change [String, nil] Il valore del cambiamento (es. "+12%"), default nil
-          # @param color [Symbol] Il colore del trend (:green, :red, :blue, :yellow, :purple, :indigo, :gray), default :green
-          # @param theme [Symbol] Il tema della card (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet, :purple), default :default
-          # @param size [Symbol] La dimensione della card (:small, :medium, :large), default :medium
-          # @param rounded [Symbol] Il livello di arrotondamento (:none, :small, :medium, :large, :full), default :medium
-          # @param shadow [Symbol] Il tipo di ombra (:none, :small, :medium, :large), default :small
-          # @param classes [String, nil] Classi CSS aggiuntive per il contenitore principale
-          # @param form [Nil] Parametro form per compatibilità con form builder (non utilizzato)
-          # @param options [Hash] Attributi HTML aggiuntivi da passare al div principale
-          #
-          # @return [String] HTML della card per metriche
-          #
-          # @example Card base con solo titolo e valore
-          #   <%= bui_card(title: "Utenti Attivi", value: "1.234") %>
-          #
-          # @example Card con trend positivo
-          #   <%= bui_card(
-          #     title: "Vendite Totali",
-          #     value: "€ 45.231",
-          #     trend: :up,
-          #     change: "+12%",
-          #     color: :green
-          #   ) %>
-          #
-          # @example Card con trend negativo
-          #   <%= bui_card(
-          #     title: "Conversioni",
-          #     value: "2.8%",
-          #     trend: :down,
-          #     change: "-5%",
-          #     color: :red
-          #   ) %>
-          #
-          # @example Card con tema e dimensioni personalizzate
-          #   <%= bui_card(
-          #     title: "Revenue",
-          #     value: "$89,432",
-          #     theme: :primary,
-          #     size: :large,
-          #     rounded: :large,
-          #     shadow: :medium
-          #   ) %>
-          #
-          # @example Card con attributi HTML aggiuntivi
-          #   <%= bui_card(
-          #     title: "Performance",
-          #     value: "98.5%",
-          #     classes: "transition-all hover:shadow-lg",
-          #     data: { controller: "stats" },
-          #     id: "performance-card"
-          #   ) %>
-          def bui_card(
-            title:,
-            value:,
-            trend: nil,
-            change: nil,
-            color: :green,
-            theme: :default,
-            size: :medium,
-            rounded: :medium,
-            shadow: :small,
-            classes: nil,
-            form: nil,
-            **options
-          )
-            render BetterUi::Application::Card::Component.new(
-              title: title,
-              value: value,
-              trend: trend,
-              change: change,
-              color: color,
-              theme: theme,
-              size: size,
-              rounded: rounded,
-              shadow: shadow,
-              classes: classes,
-              **options
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/application/components/card.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module Application
-    module Components
-      module Card
-        include BetterUi::Application::Components::Card::CardHelper
-      end
-    end
-  end
-end

data/app/helpers/better_ui/application/components/main/main_helper.rb

@@ -1,64 +0,0 @@
-module BetterUi
-  module Application
-    module Components
-      module Main
-        module MainHelper
-          # Helper per creare il contenitore principale dell'applicazione
-          #
-          # @param padding [Boolean] Se applicare il padding al contenitore principale, default true
-          # @param inner_padding [Boolean] Se applicare il padding al contenitore interno, default true
-          # @param rounded [Symbol] Tipo di border-radius del contenitore interno (:none, :small, :medium, :large, :full), default :small
-          # @param shadow [Symbol] Tipo di ombra del contenitore interno (:none, :small, :medium, :large), default :medium
-          # @param with_sidebar [Boolean] Se lasciare lo spazio per la sidebar, default true
-          # @param sidebar_width [Symbol] Larghezza della sidebar (:sm, :md, :lg, :xl), default :md
-          # @param classes [String] Classi CSS aggiuntive per il contenitore principale
-          # @param form [Nil] Parametro form per compatibilità con form builder (non utilizzato)
-          # @param block [Proc] Blocco contenente il contenuto del main
-          #
-          # @return [String] HTML del componente main
-          #
-          # @example Main base
-          #   <%= bui_main %>
-          # 
-          # @example Main con tema
-          #   <%= bui_main(rounded: :medium, shadow: :lg) %>
-          #
-          # @example Main senza sidebar
-          #   <%= bui_main(with_sidebar: false) %>
-          #
-          # @example Main con padding personalizzati
-          #   <%= bui_main(padding: false, inner_padding: true) %>
-          #
-          # @example Main con classi aggiuntive
-          #   <%= bui_main(
-          #     classes: "my-8",
-          #     data: { controller: "main" }
-          #   ) %>
-          def bui_main(
-            padding: true,
-            inner_padding: true,
-            rounded: :small,
-            shadow: :medium,
-            with_sidebar: true,
-            sidebar_width: :md,
-            classes: nil,
-            form: nil, 
-            **options,
-            &block
-          )
-            render BetterUi::Application::Main::Component.new(
-              padding: padding,
-              inner_padding: inner_padding,
-              rounded: rounded,
-              shadow: shadow,
-              with_sidebar: with_sidebar,
-              sidebar_width: sidebar_width,
-              classes: classes,
-              **options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-module BetterUi
-  module Application
-    module Components
-      module Navbar
-        module NavbarHelper
-          # Helper per creare la navbar dell'applicazione
-          #
-          # @param theme [Symbol] Tema colori (default, white, red, rose, orange, green, blue, yellow, violet), default :default
-          # @param shadow [Symbol] Tipo di ombra (none, small, medium, large), default :small
-          # @param border [Boolean] Se mostrare il bordo inferiore, default true
-          # @param actions [Array] Array di azioni/pulsanti a destra
-          # @param classes [String] Classi CSS aggiuntive
-          # @param with_sidebar [Boolean] Se la navbar è affiancata a una sidebar, default false
-          # @param sidebar_width [Symbol] Larghezza della sidebar affiancata (:sm, :md, :lg, :xl), default :md
-          # @param form [Nil] Parametro form per compatibilità con form builder (non utilizzato)
-          # @param options [Hash] Opzioni HTML aggiuntive
-          # @param block [Proc] Blocco contenente contenuto aggiuntivo della navbar
-          #
-          # @return [String] HTML del componente navbar
-          #
-          # @example Navbar base
-          #   <%= bui_navbar %>
-          # 
-          # @example Navbar con tema
-          #   <%= bui_navbar(theme: :blue) %>
-          #
-          #
-          # @example Navbar con azioni
-          #   <%= bui_navbar(
-          #     actions: [
-          #       { 
-          #         type: :avatar,
-          #         avatar: { initials: 'AB', theme: :green },
-          #         href: '/profile'
-          #       },
-          #       {
-          #         type: :icon,
-          #         icon: 'chat',
-          #         data: { action: 'click->chat#toggle' }
-          #       }
-          #     ]
-          #   ) %>
-          #
-          # @example Navbar con classi aggiuntive
-          #   <%= bui_navbar(
-          #     classes: "my-8",
-          #     data: { controller: "navbar" }
-          #   ) %>
-          def bui_navbar(
-            theme: :default,
-            shadow: :small,
-            border: true,
-            actions: [],
-            classes: nil,
-            with_sidebar: false,
-            sidebar_width: :md,
-            form: nil, 
-            **options,
-            &block
-          )
-            render BetterUi::Application::Navbar::Component.new(
-              theme: theme,
-              shadow: shadow,
-              border: border,
-              actions: actions,
-              classes: classes,
-              with_sidebar: with_sidebar,
-              sidebar_width: sidebar_width
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/application/components/sidebar/sidebar_helper.rb

@@ -1,51 +0,0 @@
-module BetterUi
-  module Application
-    module Components
-      module Sidebar
-        module SidebarHelper
-          # Helper per creare la sidebar dell'applicazione
-          #
-          # @param width [Symbol] Larghezza della sidebar (:sm, :md, :lg, :xl), default :md
-          # @param position [Symbol] Posizione della sidebar (:left, :right), default :left
-          # @param theme [Symbol] Tema colori (:default, :dark, :light), default :default
-          # @param shadow [Symbol] Tipo di ombra (:none, :sm, :md, :lg), default :lg
-          # @param border [Boolean] Se mostrare il bordo destro/sinistro, default true
-          # @param header [Hash] Configurazione header (logo, title, subtitle)
-          # @param footer [Hash] Configurazione footer (content, user_info)
-          # @param navigation_sections [Array] Array di sezioni di navigazione
-          # @param collapsible [Boolean] Se abilitare sezioni collassabili, default true
-          # @param classes [String] Classi CSS aggiuntive
-          # @param block [Proc] Blocco contenente contenuto aggiuntivo della sidebar
-          #
-          # @return [String] HTML del componente sidebar
-          def bui_sidebar(
-            width: :md,
-            position: :left,
-            theme: :default,
-            shadow: :lg,
-            border: true,
-            header: {},
-            footer: {},
-            navigation_sections: [],
-            collapsible: true,
-            classes: nil,
-            &block
-          )
-            render BetterUi::Application::Sidebar::Component.new(
-              width: width,
-              position: position,
-              theme: theme,
-              shadow: shadow,
-              border: border,
-              header: header,
-              footer: footer,
-              navigation_sections: navigation_sections,
-              collapsible: collapsible,
-              classes: classes
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

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

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

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

@@ -1,57 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Alert
-        module AlertHelper
-          # Renderizza un componente Alert per comunicare messaggi importanti all'utente.
-          #
-          # @param title [String, nil] Titolo dell'alert (opzionale)
-          # @param message [String] Contenuto dell'alert
-          # @param theme [Symbol] Tema dell'alert (:default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet)
-          # @param icon [String, nil] Nome dell'icona (se vuoto usa l'icona predefinita in base al tema)
-          # @param icon_position [Symbol] Posizione dell'icona (:left, :right)
-          # @param dismissible [Boolean] Se l'alert può essere chiuso dall'utente
-          # @param rounded [Symbol] Arrotondamento degli angoli (:none, :small, :medium, :large, :full)
-          # @param importance [Symbol] Livello di importanza per accessibilità (:high, :medium, :low)
-          # @param html_content [Boolean] Se il messaggio contiene HTML
-          # @param classes [String] Classi CSS aggiuntive
-          # @param options [Hash] Attributi HTML aggiuntivi
-          #
-          # @return [String] HTML del componente Alert renderizzato
-          #
-          # @example Alert base
-          #   <%= bui_alert(message: 'Operazione completata con successo') %>
-          #
-          # @example Alert con titolo e tema
-          #   <%= bui_alert(title: 'Errore', message: 'Impossibile completare', theme: :red) %>
-          #
-          # @example Alert con icona personalizzata
-          #   <%= bui_alert(message: 'Avviso importante', icon: 'bell') %>
-          #
-          # @example Alert con pulsante per chiudere
-          #   <%= bui_alert(message: 'Notifica temporanea', dismissible: true) %>
-          #
-          # @example Alert con HTML nel messaggio
-          #   <%= bui_alert(message: '<strong>Attenzione!</strong> Controlla i dati.', html_content: true) %>
-          def bui_alert(title: nil, message: nil, theme: :default, icon: nil, icon_position: :left, 
-                       dismissible: false, rounded: :medium, importance: :medium, html_content: false, 
-                       classes: nil, **options)
-            render BetterUi::General::Alert::Component.new(
-              title: title,
-              message: message,
-              theme: theme,
-              icon: icon,
-              icon_position: icon_position,
-              dismissible: dismissible,
-              rounded: rounded,
-              importance: importance,
-              html_content: html_content,
-              classes: classes,
-              **options
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/avatar/avatar_helper.rb

@@ -1,29 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Avatar
-        module AvatarHelper
-          # Render un avatar con le opzioni specificate
-          #
-          # @param options [Hash] opzioni per il componente
-          #
-          # @option options [String] :name (nil) nome per le iniziali
-          # @option options [String] :src (nil) URL dell'immagine
-          # @option options [Symbol] :size (:medium) :xxsmall, :xsmall, :small, :medium, :large, :xlarge, :xxlarge
-          # @option options [Symbol] :shape (:circle) :circle, :square, :rounded
-          # @option options [Symbol] :status (nil) :online, :offline, :busy, :away
-          # @option options [Symbol] :status_position (:bottom_right) :bottom_right, :bottom_left, :top_right, :top_left
-          # @option options [Symbol] :theme (:white) :default, :white, :red, :rose, :orange, :green, :blue, :yellow, :violet
-          # @option options [Symbol] :style (:filled) :filled, :outline, :light
-          # @option options [String] :classes (nil) classi CSS aggiuntive
-          # @option options [String] :id (nil) ID HTML
-          #
-          # @return [String] HTML del componente
-          def bui_avatar(**options)
-            render BetterUi::General::Avatar::Component.new(**options)
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/badge/badge_helper.rb

@@ -1,53 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Badge
-        module BadgeHelper
-          # Helper per renderizzare un badge
-          #
-          # @param label [String] Testo del badge
-          # @param theme [Symbol] Tema del badge (:default, :white, :red, etc.)
-          # @param size [Symbol] Dimensione del badge (:small, :medium, :large)
-          # @param shape [Symbol] Forma del badge (:square, :rounded)
-          # @param style [Symbol] Stile del badge (:filled, :outline)
-          # @param variant [Symbol] Variante del badge (:notification, :counter, :dot)
-          # @param icon [String] Nome dell'icona (opzionale)
-          # @param icon_position [Symbol] Posizione dell'icona (:left, :right)
-          # @param classes [String] Classi CSS aggiuntive
-          # @param id [String] ID HTML
-          # @param html_options [Hash] Opzioni HTML aggiuntive
-          #
-          # @return [String] HTML del badge
-          def bui_badge(
-            label: nil,
-            theme: :white,
-            size: :medium,
-            shape: :rounded,
-            style: :filled,
-            variant: nil,
-            icon: nil,
-            icon_position: :left,
-            classes: nil,
-            id: nil,
-            **html_options,
-            &block
-          )
-            render BetterUi::General::Badge::Component.new(
-              label: label,
-              theme: theme,
-              size: size,
-              shape: shape,
-              style: style,
-              variant: variant,
-              icon: icon,
-              icon_position: icon_position,
-              classes: classes,
-              id: id,
-              **html_options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/breadcrumb/breadcrumb_helper.rb

@@ -1,37 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Breadcrumb
-        module BreadcrumbHelper
-          # Helper per renderizzare un breadcrumb
-          #
-          # @param items [Array] Array di items del breadcrumb
-          # @param separator [Symbol] Tipo di separatore (:chevron, :slash, :arrow, :dot, :pipe)
-          # @param theme [Symbol] Tema del breadcrumb (:default, :white, :red, etc.)
-          # @param size [Symbol] Dimensione del testo (:extra_small, :small, :medium, :large)
-          # @param classes [String] Classi CSS aggiuntive
-          # @param html_options [Hash] Opzioni HTML aggiuntive
-          #
-          # @return [String] HTML del breadcrumb
-          def bui_breadcrumb(
-            items: [],
-            separator: :chevron,
-            theme: :white,
-            size: :medium,
-            classes: nil,
-            **html_options
-          )
-            render BetterUi::General::Breadcrumb::Component.new(
-              items: items,
-              separator: separator,
-              theme: theme,
-              size: size,
-              classes: classes,
-              **html_options
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/button/button_helper.rb

@@ -1,65 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Button
-        module ButtonHelper
-          # Helper per renderizzare un bottone
-          #
-          # @param text [String] Testo del bottone (argomento posizionale)
-          # @param theme [Symbol] Tema del bottone (:default, :white, :red, etc.)
-          # @param size [Symbol] Dimensione del bottone (:small, :medium, :large)
-          # @param full_width [Boolean] Larghezza completa
-          # @param disabled [Boolean] Stato disabilitato
-          # @param icon [String] Nome icona (opzionale)
-          # @param icon_position [Symbol] Posizione icona (:left, :right)
-          # @param href [String] URL per il link (opzionale)
-          # @param method [Symbol] Metodo HTTP (opzionale)
-          # @param data [Hash] Attributi data
-          # @param classes [String] Classi CSS aggiuntive
-          # @param id [String] ID elemento
-          # @param rounded [Symbol] Tipo di border-radius (:none, :small, :medium, :large, :full)
-          # @param html_options [Hash] Opzioni HTML aggiuntive
-          # @params button_type [Symbol] Tipo di bottone (:button, :submit, :reset)
-          #
-          # @return [String] HTML del bottone
-          def bui_button(
-            text = nil,
-            theme: :white,
-            size: :medium,
-            full_width: false,
-            disabled: false,
-            icon: nil,
-            icon_position: :left,
-            href: nil,
-            method: nil,
-            data: {},
-            classes: nil,
-            id: nil,
-            rounded: :medium,
-            button_type: :button,
-            **html_options,
-            &block
-          )
-            render BetterUi::General::Button::Component.new(
-              text: text,
-              theme: theme,
-              size: size,
-              full_width: full_width,
-              disabled: disabled,
-              icon: icon,
-              icon_position: icon_position,
-              href: href,
-              method: method,
-              data: data,
-              classes: classes,
-              id: id,
-              rounded: rounded,
-              button_type: button_type,
-              **html_options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end

data/app/helpers/better_ui/general/components/container/container_helper.rb

@@ -1,60 +0,0 @@
-module BetterUi
-  module General
-    module Components
-      module Container
-        module ContainerHelper
-          # Genera un container usando BetterUi::General::Container::Component
-          #
-          # @param html_content [String] contenuto HTML del container (opzionale)
-          # @param fluid [Boolean] se il container deve essere fluid (full width)
-          # @param max_width [Symbol] larghezza massima del container (:sm, :md, :lg, :xl, :xxl)
-          # @param padding [Symbol] padding interno (:none, :small, :medium, :large)
-          # @param background [Symbol] colore di sfondo (:white, :light, :dark, :transparent)
-          # @param html_options [Hash] opzioni HTML aggiuntive
-          # @return [String] HTML del container renderizzato
-          #
-          # @example Uso base
-          #   bui_container(html_content: "Contenuto del container")
-          #
-          # @example Container fluid
-          #   bui_container(
-          #     html_content: "Contenuto full width",
-          #     fluid: true
-          #   )
-          #
-          # @example Container con larghezza massima
-          #   bui_container(
-          #     html_content: "Contenuto limitato",
-          #     max_width: :lg,
-          #     padding: :large
-          #   )
-          #
-          # @example Con contenuto block
-          #   bui_container(background: :light) do
-          #     "<div>Il mio contenuto</div>".html_safe
-          #   end
-          def bui_container(
-            html_content: nil,
-            fluid: false,
-            max_width: :lg,
-            padding: :medium,
-            background: :white,
-            border: false,
-            **html_options,
-            &block
-          )
-            render BetterUi::General::Container::Component.new(
-              html_content: html_content,
-              fluid: fluid,
-              max_width: max_width,
-              padding: padding,
-              background: background,
-              border: border,
-              **html_options
-            ), &block
-          end
-        end
-      end
-    end
-  end
-end