better_ui_tmp 0.5.1

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

@@ -0,0 +1,53 @@
+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/badge.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Badge
+        # Require dell'helper badge
+        require_relative 'badge/badge_helper'
+
+        # Include dell'helper nel modulo Badge
+        include BadgeHelper
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+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 (: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/breadcrumb.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Breadcrumb
+        # Require dell'helper breadcrumb
+        require_relative 'breadcrumb/breadcrumb_helper'
+
+        # Include dell'helper nel modulo Breadcrumb
+        include BreadcrumbHelper
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+module BetterUi
+  module General
+    module Components
+      module Button
+        module ButtonHelper
+          # Helper per renderizzare un bottone
+          #
+          # @param label [String] Testo del bottone
+          # @param type [Symbol] Tipo 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(
+            label: nil,
+            type: :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(
+              label: label,
+              type: type,
+              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/button.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Button
+        # Require dell'helper button
+        require_relative 'button/button_helper'
+
+        # Include dell'helper nel modulo Button
+        include ButtonHelper
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+module BetterUi
+  module General
+    module Components
+      module Card
+        module CardHelper
+          # Helper per renderizzare una card
+          #
+          # @param options [Hash] opzioni per il componente
+          # @option options [Symbol] :theme (:white) tema del colore (:default, :white, :red, etc.)
+          # @option options [Symbol] :style (:default) stile (:default, :flat, :raised, :bordered)
+          # @option options [Symbol] :padding (:medium) padding interno (:none, :small, :medium, :large)
+          # @option options [Symbol] :radius (:medium) raggio dei bordi (:none, :small, :medium, :large, :full)
+          # @param block [Block] blocco per il contenuto della card
+          # @return [String] HTML della card
+
+
+          def bui_card(
+            theme: :white,
+            style: :default,
+            padding: :medium,
+            radius: :medium,
+            **options,
+            &block
+          )
+            render BetterUi::General::Card::Component.new(
+              theme: theme,
+              style: style,
+              padding: padding,
+              radius: radius,
+              **options
+            ), &block
+          end
+        end
+      end
+    end
+  end
+end 

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

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Card
+        # Require dell'helper card
+        require_relative 'card/card_helper'
+
+        # Include dell'helper nel modulo Card
+        include CardHelper
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Container
+        # Require dell'helper container
+        require_relative 'container/container_helper'
+
+        # Include dell'helper nel modulo Container
+        include ContainerHelper
+      end
+    end
+  end
+end

data/app/helpers/better_ui/general/components/divider/divider_helper.rb

@@ -0,0 +1,63 @@
+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/divider.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Divider
+        # Require dell'helper divider
+        require_relative 'divider/divider_helper'
+
+        # Include dell'helper nel modulo Divider
+        include DividerHelper
+      end
+    end
+  end
+end

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

@@ -0,0 +1,72 @@
+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/heading.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Heading
+        # Require dell'helper heading
+        require_relative 'heading/heading_helper'
+
+        # Include dell'helper nel modulo Heading
+        include HeadingHelper
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+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/icon.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Icon
+        # Require dell'helper icon
+        require_relative 'icon/icon_helper'
+
+        # Include dell'helper nel modulo Icon
+        include IconHelper
+      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 (: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/link.rb

@@ -0,0 +1,13 @@
+module BetterUi
+  module General
+    module Components
+      module Link
+        # Require dell'helper link
+        require_relative 'link/link_helper'
+
+        # Include dell'helper nel modulo Link
+        include LinkHelper
+      end
+    end
+  end
+end