better_ui 0.3.0 → 0.5.0

data/app/assets/javascripts/better_ui/toast_manager.js

@@ -0,0 +1,77 @@
+// Gestore per l'impilamento dei toast in diverse posizioni
+class ToastManager {
+  constructor() {
+    // Mantiene traccia dei toast attivi per posizione
+    this.toasts = {
+      'top-right': [],
+      'top-left': [],
+      'bottom-right': [],
+      'bottom-left': [],
+      'top-center': [],
+      'bottom-center': []
+    }
+    
+    // Offset di base per ogni posizione (in px)
+    this.baseOffset = 16; // equivalente a Tailwind top-4 (16px)
+    
+    // Spaziatura tra i toast (in px)
+    this.spacing = 12;
+  }
+  
+  // Registra un nuovo toast e calcola la sua posizione
+  registerToast(toast, position) {
+    if (!this.toasts[position]) {
+      console.warn(`Posizione toast non valida: ${position}. Utilizzo 'top-right' come predefinita.`);
+      position = 'top-right';
+    }
+    
+    // Aggiungi il toast all'array della posizione specifica
+    this.toasts[position].push(toast);
+    
+    // Ricalcola le posizioni per tutti i toast in questa posizione
+    this.updatePositions(position);
+    
+    return () => this.removeToast(toast, position);
+  }
+  
+  // Rimuove un toast e ricalcola le posizioni
+  removeToast(toast, position) {
+    const index = this.toasts[position].indexOf(toast);
+    if (index !== -1) {
+      this.toasts[position].splice(index, 1);
+      this.updatePositions(position);
+    }
+  }
+  
+  // Aggiorna le posizioni di tutti i toast in una data posizione
+  updatePositions(position) {
+    const isTopPosition = position.startsWith('top-');
+    const toastArray = this.toasts[position];
+    
+    let currentOffset = this.baseOffset;
+    
+    toastArray.forEach((toast, index) => {
+      // Applica la posizione corretta
+      if (isTopPosition) {
+        toast.style.top = `${currentOffset}px`;
+      } else {
+        toast.style.bottom = `${currentOffset}px`;
+      }
+      
+      // Aggiorna l'offset per il prossimo toast
+      const height = toast.offsetHeight;
+      currentOffset += height + this.spacing;
+    });
+  }
+  
+  // Metodo statico per accedere all'istanza singleton
+  static getInstance() {
+    if (!ToastManager.instance) {
+      ToastManager.instance = new ToastManager();
+    }
+    return ToastManager.instance;
+  }
+}
+
+// Esporta il gestore come singleton
+export default ToastManager.getInstance(); 

data/app/assets/stylesheets/better_ui/application.css

@@ -12,4 +12,34 @@
  *
  *= require_tree .
  *= require_self
+ *= require font-awesome
  */
+
+/* 
+ * BetterUI - Utilizziamo Tailwind CSS per tutti gli stili
+ */
+
+/* Stili per il syntax highlighting di CodeRay */
+.syntax-ruby {
+  color: #333;
+  background-color: #f8f8f8;
+  font-family: Monaco, Consolas, 'Courier New', monospace;
+  line-height: 1.5;
+}
+.syntax-ruby .keyword { color: #0066CC; font-weight: bold; }
+.syntax-ruby .string, .syntax-ruby .string-content { color: #008800; }
+.syntax-ruby .comment { color: #888888; font-style: italic; }
+.syntax-ruby .constant { color: #CC0000; }
+.syntax-ruby .class { color: #0086B3; font-weight: bold; }
+.syntax-ruby .module { color: #0086B3; font-weight: bold; }
+.syntax-ruby .symbol { color: #AA6600; }
+.syntax-ruby .function { color: #990000; }
+.syntax-ruby .regexp { color: #AA6600; }
+.syntax-ruby .integer, .syntax-ruby .float { color: #0000DD; }
+.syntax-ruby .global-variable, .syntax-ruby .instance-variable { color: #336699; }
+.syntax-ruby .predefined { color: #3377BB; font-weight: bold; }
+.syntax-ruby .error { color: #FF0000; background-color: #FFAAAA; }
+.syntax-ruby .delimiter { color: #555555; }
+.syntax-ruby .method { color: #990000; font-weight: bold; }
+.syntax-ruby .attribute-name { color: #994500; }
+.syntax-ruby .value { color: #0066CC; }

data/app/components/better_ui/application/alert_component.html.erb

@@ -0,0 +1,27 @@
+<div role="alert" class="<%= container_classes %>" <%= @data&.map { |k, v| "data-#{k}=\"#{v}\"" }&.join(' ')&.html_safe %>>
+  <% if effective_icon.present? %>
+    <div class="<%= icon_classes %>">
+      <%= render BetterUi::General::IconComponent.new(name: effective_icon) %>
+    </div>
+  <% end %>
+  
+  <div class="<%= content_classes %>">
+    <% if @title.present? %>
+      <div class="<%= title_classes %>"><%= @title %></div>
+    <% end %>
+    
+    <% if @message.present? %>
+      <div class="<%= message_classes %>"><%= @message %></div>
+    <% end %>
+    
+    <% if content.present? %>
+      <div class="<%= message_classes %>"><%= content %></div>
+    <% end %>
+  </div>
+  
+  <% if @dismissible %>
+    <button type="button" class="<%= close_button_classes %>" data-dismiss-target="[role='alert']" aria-label="Chiudi">
+      <%= render BetterUi::General::IconComponent.new(name: "xmark") %>
+    </button>
+  <% end %>
+</div>

data/app/components/better_ui/application/alert_component.rb

@@ -0,0 +1,202 @@
+module BetterUi
+  module Application
+    class AlertComponent < ViewComponent::Base
+      attr_reader :title, :message, :variant, :icon, :dismissible, :classes, :data, :icon_position, :outline, :rounded
+
+      # Varianti di colore disponibili
+      VARIANTS = {
+        default: {
+          bg: "bg-black",
+          border: "border-gray-900",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-gray-800"
+        },
+        white: {
+          bg: "bg-white",
+          border: "border-gray-200",
+          title: "text-black",
+          text: "text-black",
+          icon: "text-black",
+          close: "text-black hover:bg-gray-100"
+        },
+        red: {
+          bg: "bg-red-500",
+          border: "border-red-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-red-600"
+        },
+        rose: {
+          bg: "bg-rose-500",
+          border: "border-rose-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-rose-600"
+        },
+        orange: {
+          bg: "bg-orange-500",
+          border: "border-orange-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-orange-600"
+        },
+        green: {
+          bg: "bg-green-500",
+          border: "border-green-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-green-600"
+        },
+        blue: {
+          bg: "bg-blue-500",
+          border: "border-blue-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-blue-600"
+        },
+        yellow: {
+          bg: "bg-yellow-500",
+          border: "border-yellow-600",
+          title: "text-black",
+          text: "text-black",
+          icon: "text-black",
+          close: "text-black hover:bg-yellow-600"
+        },
+        violet: {
+          bg: "bg-violet-500",
+          border: "border-violet-600",
+          title: "text-white",
+          text: "text-white",
+          icon: "text-white",
+          close: "text-white hover:bg-violet-600"
+        }
+      }
+
+      # Icone predefinite per ciascuna variante
+      DEFAULT_ICONS = {
+        default: "bell",
+        white: "info-circle",
+        red: "exclamation-circle",
+        rose: "exclamation-circle",
+        orange: "bell",
+        green: "check-circle",
+        blue: "info-circle",
+        yellow: "exclamation-triangle",
+        violet: "shield-exclamation"
+      }
+
+      # Posizioni possibili per le icone
+      ICON_POSITIONS = [:left, :top]
+
+      # Inizializzazione del componente
+      def initialize(
+        title: nil,
+        message: nil,
+        variant: :default,
+        icon: nil, 
+        dismissible: false,
+        classes: nil,
+        data: {},
+        icon_position: :left,
+        outline: false,
+        rounded: :sm
+      )
+        @title = title
+        @message = message
+        @variant = variant.to_sym
+        @icon = icon
+        @dismissible = dismissible
+        @classes = classes
+        @data = data
+        @icon_position = icon_position.to_sym
+        @outline = outline
+        @rounded = rounded.to_sym
+      end
+
+      # Genera l'icona in base alla variante se non specificata
+      def effective_icon
+        return @icon if @icon.present?
+        DEFAULT_ICONS[@variant] || DEFAULT_ICONS[:default]
+      end
+
+      # Genera le classi per il container
+      def container_classes
+        styles = VARIANTS.fetch(@variant, VARIANTS[:default])
+        
+        base_classes = ["p-4 mb-4 flex border"]
+        base_classes << get_border_radius_class
+        
+        [
+          *base_classes,
+          styles[:bg],
+          styles[:border],
+          @icon_position == :top ? "flex-col" : "items-start",
+          @classes
+        ].compact.join(" ")
+      end
+
+      # Genera il border-radius
+      def get_border_radius_class
+        ThemeHelper::BORDER_RADIUS[@rounded] || ThemeHelper::BORDER_RADIUS[:sm]
+      end
+
+      # Genera le classi per il titolo
+      def title_classes
+        styles = VARIANTS.fetch(@variant, VARIANTS[:default])
+        
+        [
+          "font-medium",
+          styles[:title]
+        ].compact.join(" ")
+      end
+
+      # Genera le classi per il messaggio
+      def message_classes
+        styles = VARIANTS.fetch(@variant, VARIANTS[:default])
+        
+        [
+          "mt-1",
+          styles[:text]
+        ].compact.join(" ")
+      end
+
+      # Genera le classi per l'icona
+      def icon_classes
+        styles = VARIANTS.fetch(@variant, VARIANTS[:default])
+        
+        [
+          "flex-shrink-0",
+          @icon_position == :left ? "mr-3 mt-0.5" : "mb-3",
+          styles[:icon]
+        ].compact.join(" ")
+      end
+
+      # Genera le classi per il pulsante di chiusura
+      def close_button_classes
+        styles = VARIANTS.fetch(@variant, VARIANTS[:default])
+        
+        [
+          "ml-auto -mr-1.5 -mt-1.5 inline-flex h-8 w-8 rounded-lg p-1.5 focus:ring-2 focus:ring-gray-400",
+          styles[:close]
+        ].compact.join(" ")
+      end
+
+      # Genera le classi per il contenuto
+      def content_classes
+        "flex-1"
+      end
+
+      # Verifica se il componente deve essere reso
+      def render?
+        @title.present? || @message.present? || content.present?
+      end
+    end
+  end
+end 

data/app/components/better_ui/application/card_component.html.erb

@@ -0,0 +1,24 @@
+<div class="bui-card-base <%= get_border_radius_class %> px-4 py-5 sm:p-6">
+  <dt class="bui-card-title text-gray-900"><%= title %></dt>
+  <dd class="bui-card-body mt-1 flex items-baseline justify-between md:block lg:flex">
+    <div class="flex items-baseline">
+      <span class="bui-card-value text-indigo-600"><%= value %></span>
+      <span class="bui-card-value-from ml-2">from <%= value_from %></span>
+    </div>
+
+    <div class="bui-card-trend <%= trend_classes %>">
+      <% if trend_type == :up %>
+        <svg class="mr-0.5 -ml-1 size-5 shrink-0 self-center <%= trend_icon_classes %>" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true" data-slot="icon">
+          <path fill-rule="evenodd" d="M10 17a.75.75 0 0 1-.75-.75V5.612L5.29 9.77a.75.75 0 0 1-1.08-1.04l5.25-5.5a.75.75 0 0 1 1.08 0l5.25 5.5a.75.75 0 1 1-1.08 1.04l-3.96-4.158V16.25A.75.75 0 0 1 10 17Z" clip-rule="evenodd" />
+        </svg>
+        <span class="sr-only">Incremento di</span>
+      <% else %>
+        <svg class="mr-0.5 -ml-1 size-5 shrink-0 self-center <%= trend_icon_classes %>" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true" data-slot="icon">
+          <path fill-rule="evenodd" d="M10 3a.75.75 0 0 1 .75.75v10.638l3.96-4.158a.75.75 0 1 1 1.08 1.04l-5.25 5.5a.75.75 0 0 1-1.08 0l-5.25-5.5a.75.75 0 1 1 1.08-1.04l3.96 4.158V3.75A.75.75 0 0 1 10 3Z" clip-rule="evenodd" />
+        </svg>
+        <span class="sr-only">Decremento di</span>
+      <% end %>
+      <%= trend_value %>
+    </div>
+  </dd>
+</div> 

data/app/components/better_ui/application/card_component.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module Application
+    class CardComponent < ViewComponent::Base
+      attr_reader :title, :value, :value_from, :trend_value, :trend_type, :rounded
+
+      # Opzioni di bordi arrotondati standardizzati
+      CARD_RADIUS = {
+        none: 'bui-card-radius-none',
+        small: 'bui-card-radius-small',
+        medium: 'bui-card-radius-medium',
+        large: 'bui-card-radius-large',
+        full: 'bui-card-radius-full'
+      }.freeze
+
+      # @param title [String] Titolo della card
+      # @param value [String] Valore principale da visualizzare
+      # @param value_from [String] Valore precedente di riferimento
+      # @param trend_value [String] Percentuale di variazione
+      # @param trend_type [Symbol] Tipo di variazione (:up o :down)
+      # @param rounded [Symbol] Tipo di border-radius (:none, :small, :medium, :large, :full), default :small
+      def initialize(title:, value:, value_from:, trend_value:, trend_type: :up, rounded: :small)
+        @title = title
+        @value = value
+        @value_from = value_from
+        @trend_value = trend_value
+        @trend_type = trend_type.to_sym
+        @rounded = rounded.to_sym
+      end
+
+      def trend_classes
+        if trend_type == :up
+          'bg-green-500 text-white'
+        else
+          'bg-black text-white'
+        end
+      end
+
+      def trend_icon_classes
+        if trend_type == :up
+          'text-white'
+        else
+          'text-white'
+        end
+      end
+
+      def get_border_radius_class
+        CARD_RADIUS[@rounded] || CARD_RADIUS[:small]
+      end
+    end
+  end
+end 

data/app/components/better_ui/application/card_container_component.html.erb

@@ -0,0 +1,8 @@
+<div>
+  <h3 class="text-base font-semibold text-gray-900"><%= @title %></h3>
+  <dl class="mt-5 grid grid-cols-1 divide-y divide-gray-200 overflow-hidden rounded-lg bg-white shadow-sm md:grid-cols-3 md:divide-x md:divide-y-0">
+    <% cards.each do |card| %>
+      <%= card %>
+    <% end %>
+  </dl>
+</div> 

data/app/components/better_ui/application/card_container_component.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module BetterUi
+  module Application
+    class CardContainerComponent < ViewComponent::Base
+      renders_many :cards, CardComponent
+
+      # @param title [String] Titolo del container delle card
+      def initialize(title:)
+        @title = title
+      end
+    end
+  end
+end 

data/app/components/better_ui/application/header_component.html.erb

@@ -0,0 +1,88 @@
+<header class="<%= header_classes %>" <%= @data&.map { |k, v| "data-#{k}=\"#{v}\"" }&.join(' ')&.html_safe %>>
+  <div class="<%= container_class %>">
+    <div class="md:flex md:justify-between md:items-start">
+      <div class="min-w-0 flex-1">
+        <% if has_breadcrumbs? %>
+          <nav class="<%= breadcrumb_container_classes %>" aria-label="Breadcrumb">
+            <ol class="flex items-center">
+              <% @breadcrumbs.each_with_index do |breadcrumb, index| %>
+                <li class="flex items-center">
+                  <% if index > 0 %>
+                    <span class="<%= breadcrumb_divider_classes %>" aria-hidden="true">
+                      <% if variant == :modern %>
+                        <svg class="h-4 w-4" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
+                        </svg>
+                      <% else %>
+                        /
+                      <% end %>
+                    </span>
+                  <% end %>
+                  <% is_last = index == @breadcrumbs.length - 1 %>
+                  <% if is_last || !breadcrumb[:url].present? %>
+                    <span class="<%= breadcrumb_link_classes(is_last) %>" <%= is_last ? 'aria-current="page"' : '' %>>
+                      <%= breadcrumb[:text] %>
+                    </span>
+                  <% else %>
+                    <a href="<%= breadcrumb[:url] %>" class="<%= breadcrumb_link_classes %>">
+                      <%= breadcrumb[:text] %>
+                    </a>
+                  <% end %>
+                </li>
+              <% end %>
+            </ol>
+          </nav>
+        <% end %>
+        
+        <div class="flex items-center">
+          <% if @title.is_a?(Hash) && @title[:icon].present? %>
+            <div class="mr-3 bg-gray-100 rounded-md p-2 flex-shrink-0">
+              <% if @title[:icon] == "document" %>
+                <svg class="h-5 w-5 text-gray-500" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+                </svg>
+              <% elsif @title[:icon] == "users" %>
+                <svg class="h-5 w-5 text-gray-500" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z" />
+                </svg>
+              <% elsif @title[:icon] == "settings" || @title[:icon] == "gear" %>
+                <svg class="h-5 w-5 text-gray-500" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+                </svg>
+              <% elsif @title[:icon] == "dashboard" %>
+                <svg class="h-5 w-5 text-gray-500" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z" />
+                </svg>
+              <% else %>
+                <%= render BetterUi::General::IconComponent.new(name: @title[:icon], classes: "h-5 w-5 text-gray-500") %>
+              <% end %>
+            </div>
+            <h1 class="<%= title_classes %>"><%= @title[:text] %></h1>
+          <% else %>
+            <h1 class="<%= title_classes %>"><%= @title %></h1>
+          <% end %>
+        </div>
+        <% if @subtitle.present? %>
+          <p class="<%= subtitle_classes %>">
+            <%= @subtitle %>
+          </p>
+        <% end %>
+      </div>
+
+      <% if action_items.any? %>
+        <div class="<%= actions_container_classes %>">
+          <% action_items.each do |action| %>
+            <div class="ml-2">
+              <% if action.is_a?(Hash) && action[:content].present? %>
+                <%= action[:content].html_safe %>
+              <% elsif action.is_a?(String) %>
+                <%= action.html_safe %>
+              <% end %>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+</header>