better_ui 0.1.0

data/app/helpers/better_ui/application_helper.rb

@@ -0,0 +1,183 @@
+module BetterUi
+  module ApplicationHelper
+    # Metodi helper per i componenti UI semplici
+    
+    # Button component
+    def better_ui_button(text, options = {})
+      options = BetterUi.configuration.button_defaults.deep_merge(options)
+      type = options.delete(:type) || 'primary'
+      css_class = "better-ui-button better-ui-button-#{type}"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      button_tag(text, **options.merge(class: css_class))
+    end
+    
+    # Alert component
+    def better_ui_alert(message, options = {})
+      options = BetterUi.configuration.alert_defaults.deep_merge(options)
+      type = options.delete(:type) || 'info'
+      css_class = "better-ui-alert better-ui-alert-#{type}"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class) do
+        concat content_tag(:div, message, class: 'better-ui-alert-message')
+        if options[:dismissible]
+          concat content_tag(:button, 'x', class: 'better-ui-alert-close')
+        end
+      end
+    end
+    
+    # Card component
+    def better_ui_card(options = {}, &block)
+      options = BetterUi.configuration.card_defaults.deep_merge(options)
+      css_class = "better-ui-card"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Card header
+    def better_ui_card_header(title, options = {})
+      css_class = "better-ui-card-header"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class) do
+        content_tag(:h3, title, class: 'better-ui-card-title')
+      end
+    end
+    
+    # Card body
+    def better_ui_card_body(options = {}, &block)
+      css_class = "better-ui-card-body"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Card footer
+    def better_ui_card_footer(options = {}, &block)
+      css_class = "better-ui-card-footer"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Tabs component
+    def better_ui_tabs(options = {}, &block)
+      options = BetterUi.configuration.tabs_defaults.deep_merge(options)
+      css_class = "better-ui-tabs"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Tab list
+    def better_ui_tab_list(options = {}, &block)
+      css_class = "better-ui-tab-list"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, role: 'tablist', **options, &block)
+    end
+    
+    # Tab item
+    def better_ui_tab_item(text, target, options = {})
+      active = options.delete(:active) || false
+      css_class = "better-ui-tab-item"
+      css_class += " better-ui-tab-active" if active
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:button, text, {
+        class: css_class,
+        role: 'tab',
+        'aria-selected': active,
+        'data-target': target,
+      }.merge(options))
+    end
+    
+    # Tab content
+    def better_ui_tab_content(options = {}, &block)
+      css_class = "better-ui-tab-content"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, role: 'tabpanel', **options, &block)
+    end
+    
+    # Modal component
+    def better_ui_modal(id, options = {}, &block)
+      css_class = "better-ui-modal"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, id: id, class: css_class) do
+        concat content_tag(:div, '', class: 'better-ui-modal-background')
+        concat content_tag(:div, class: 'better-ui-modal-dialog', &block)
+      end
+    end
+    
+    # Modal header
+    def better_ui_modal_header(title, options = {})
+      css_class = "better-ui-modal-header"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class) do
+        concat content_tag(:h5, title, class: 'better-ui-modal-title')
+        concat content_tag(:button, '×', type: 'button', class: 'better-ui-modal-close')
+      end
+    end
+    
+    # Modal body
+    def better_ui_modal_body(options = {}, &block)
+      css_class = "better-ui-modal-body"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Modal footer
+    def better_ui_modal_footer(options = {}, &block)
+      css_class = "better-ui-modal-footer"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      content_tag(:div, class: css_class, **options, &block)
+    end
+    
+    # Trigger button for modal
+    def better_ui_modal_trigger(text, modal_id, options = {})
+      options = BetterUi.configuration.button_defaults.deep_merge(options)
+      type = options.delete(:type) || 'primary'
+      css_class = "better-ui-button better-ui-button-#{type}"
+      css_class += " #{options.delete(:class)}" if options[:class]
+      
+      button_tag(text, **options.merge(
+        class: css_class,
+        type: 'button',
+        onclick: "document.getElementById('#{modal_id}').style.display='flex'"
+      ))
+    end
+    
+    # Render markdown
+    def better_ui_markdown(text)
+      return '' if text.blank?
+      
+      renderer = Redcarpet::Render::HTML.new(
+        filter_html: false,
+        hard_wrap: true,
+        link_attributes: { target: '_blank', rel: 'noopener noreferrer' }
+      )
+      
+      markdown = Redcarpet::Markdown.new(
+        renderer,
+        autolink: true,
+        tables: true,
+        fenced_code_blocks: true,
+        strikethrough: true,
+        superscript: true,
+        underline: true,
+        highlight: true,
+        quote: true,
+        footnotes: true
+      )
+      
+      markdown.render(text).html_safe
+    end
+  end
+end

data/app/jobs/better_ui/application_job.rb

@@ -0,0 +1,4 @@
+module BetterUi
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/better_ui/application_mailer.rb

@@ -0,0 +1,6 @@
+module BetterUi
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/better_ui/application_record.rb

@@ -0,0 +1,5 @@
+module BetterUi
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/better_ui/docs/component.html.erb

@@ -0,0 +1,365 @@
+<% content_for :title, @component_name.titleize + ' - Documentazione' %>
+
+<div class="better-ui-doc-content">
+  <%= better_ui_markdown(@content) %>
+</div>
+
+<div class="better-ui-component-examples">
+  <h2>Esempi</h2>
+  
+  <% case @component_name %>
+  <% when 'button' %>
+    <div class="better-ui-example">
+      <h3>Tipi di Button</h3>
+      <div class="better-ui-example-preview">
+        <%= better_ui_button("Primary", type: 'primary') %>
+        <%= better_ui_button("Secondary", type: 'secondary') %>
+        <%= better_ui_button("Success", type: 'success') %>
+        <%= better_ui_button("Danger", type: 'danger') %>
+      </div>
+      <div class="better-ui-example-code">
+        <pre><code>&lt;%= better_ui_button("Primary", type: 'primary') %&gt;
+&lt;%= better_ui_button("Secondary", type: 'secondary') %&gt;
+&lt;%= better_ui_button("Success", type: 'success') %&gt;
+&lt;%= better_ui_button("Danger", type: 'danger') %&gt;</code></pre>
+      </div>
+    </div>
+  <% when 'alert' %>
+    <div class="better-ui-example">
+      <h3>Tipi di Alert</h3>
+      <div class="better-ui-example-preview">
+        <%= better_ui_alert("Questo è un alert informativo", type: 'info') %>
+        <%= better_ui_alert("Operazione completata con successo", type: 'success') %>
+        <%= better_ui_alert("Attenzione: questa è un'azione importante", type: 'warning') %>
+        <%= better_ui_alert("Si è verificato un errore", type: 'danger') %>
+      </div>
+      <div class="better-ui-example-code">
+        <pre><code>&lt;%= better_ui_alert("Questo è un alert informativo", type: 'info') %&gt;
+&lt;%= better_ui_alert("Operazione completata con successo", type: 'success') %&gt;
+&lt;%= better_ui_alert("Attenzione: questa è un'azione importante", type: 'warning') %&gt;
+&lt;%= better_ui_alert("Si è verificato un errore", type: 'danger') %&gt;</code></pre>
+      </div>
+    </div>
+  <% when 'card' %>
+    <div class="better-ui-example">
+      <h3>Card con Titolo e Corpo</h3>
+      <div class="better-ui-example-preview">
+        <%= better_ui_card do %>
+          <%= better_ui_card_header("Titolo della Card") %>
+          <%= better_ui_card_body do %>
+            <p>Questo è il contenuto della card. Puoi inserire qualsiasi elemento HTML qui.</p>
+          <% end %>
+        <% end %>
+      </div>
+      <div class="better-ui-example-code">
+        <pre><code>&lt;%= better_ui_card do %&gt;
+  &lt;%= better_ui_card_header("Titolo della Card") %&gt;
+  &lt;%= better_ui_card_body do %&gt;
+    &lt;p&gt;Questo è il contenuto della card. Puoi inserire qualsiasi elemento HTML qui.&lt;/p&gt;
+  &lt;% end %&gt;
+&lt;% end %&gt;</code></pre>
+      </div>
+    </div>
+    
+    <div class="better-ui-example">
+      <h3>Card con Footer</h3>
+      <div class="better-ui-example-preview">
+        <%= better_ui_card do %>
+          <%= better_ui_card_header("Titolo della Card") %>
+          <%= better_ui_card_body do %>
+            <p>Questo è il contenuto della card. Puoi inserire qualsiasi elemento HTML qui.</p>
+          <% end %>
+          <%= better_ui_card_footer do %>
+            <%= better_ui_button("Salva", type: 'primary') %>
+            <%= better_ui_button("Annulla", type: 'secondary') %>
+          <% end %>
+        <% end %>
+      </div>
+      <div class="better-ui-example-code">
+        <pre><code>&lt;%= better_ui_card do %&gt;
+  &lt;%= better_ui_card_header("Titolo della Card") %&gt;
+  &lt;%= better_ui_card_body do %&gt;
+    &lt;p&gt;Questo è il contenuto della card. Puoi inserire qualsiasi elemento HTML qui.&lt;/p&gt;
+  &lt;% end %&gt;
+  &lt;%= better_ui_card_footer do %&gt;
+    &lt;%= better_ui_button("Salva", type: 'primary') %&gt;
+    &lt;%= better_ui_button("Annulla", type: 'secondary') %&gt;
+  &lt;% end %&gt;
+&lt;% end %&gt;</code></pre>
+      </div>
+    </div>
+  <% when 'tabs' %>
+    <div class="better-ui-example">
+      <h3>Tabs Base</h3>
+      <div class="better-ui-example-preview">
+        <%= better_ui_tabs do %>
+          <%= better_ui_tab_list do %>
+            <%= better_ui_tab_item("Tab 1", "#tab1", active: true) %>
+            <%= better_ui_tab_item("Tab 2", "#tab2") %>
+            <%= better_ui_tab_item("Tab 3", "#tab3") %>
+          <% end %>
+          
+          <div class="better-ui-tab-panels">
+            <%= better_ui_tab_content(id: 'tab1', class: 'active') do %>
+              <p>Contenuto del Tab 1</p>
+            <% end %>
+            
+            <%= better_ui_tab_content(id: 'tab2', style: 'display: none;') do %>
+              <p>Contenuto del Tab 2</p>
+            <% end %>
+            
+            <%= better_ui_tab_content(id: 'tab3', style: 'display: none;') do %>
+              <p>Contenuto del Tab 3</p>
+            <% end %>
+          </div>
+        <% end %>
+      </div>
+      <div class="better-ui-example-code">
+        <pre><code>&lt;%= better_ui_tabs do %&gt;
+  &lt;%= better_ui_tab_list do %&gt;
+    &lt;%= better_ui_tab_item("Tab 1", "#tab1", active: true) %&gt;
+    &lt;%= better_ui_tab_item("Tab 2", "#tab2") %&gt;
+    &lt;%= better_ui_tab_item("Tab 3", "#tab3") %&gt;
+  &lt;% end %&gt;
+  
+  &lt;div class="better-ui-tab-panels"&gt;
+    &lt;%= better_ui_tab_content(id: 'tab1', class: 'active') do %&gt;
+      &lt;p&gt;Contenuto del Tab 1&lt;/p&gt;
+    &lt;% end %&gt;
+    
+    &lt;%= better_ui_tab_content(id: 'tab2', style: 'display: none;') do %&gt;
+      &lt;p&gt;Contenuto del Tab 2&lt;/p&gt;
+    &lt;% end %&gt;
+    
+    &lt;%= better_ui_tab_content(id: 'tab3', style: 'display: none;') do %&gt;
+      &lt;p&gt;Contenuto del Tab 3&lt;/p&gt;
+    &lt;% end %&gt;
+  &lt;/div&gt;
+&lt;% end %&gt;</code></pre>
+      </div>
+    </div>
+  <% else %>
+    <div class="better-ui-example">
+      <p>Gli esempi per questo componente saranno disponibili presto.</p>
+    </div>
+  <% end %>
+</div>
+
+<style>
+  .better-ui-doc-content {
+    max-width: 100%;
+    margin-bottom: 2rem;
+  }
+  
+  .better-ui-doc-content h1 {
+    margin-bottom: 1.5rem;
+    padding-bottom: 0.5rem;
+    border-bottom: 1px solid #e0e0e0;
+  }
+  
+  .better-ui-doc-content h2 {
+    margin-top: 2rem;
+    margin-bottom: 1rem;
+    padding-bottom: 0.5rem;
+    border-bottom: 1px solid #f0f0f0;
+  }
+  
+  .better-ui-doc-content pre {
+    background-color: #f5f5f5;
+    padding: 1rem;
+    border-radius: 4px;
+    overflow-x: auto;
+    margin: 1rem 0;
+  }
+  
+  .better-ui-doc-content code {
+    font-family: monospace;
+  }
+  
+  .better-ui-component-examples {
+    margin-top: 2rem;
+    border-top: 1px solid #e0e0e0;
+    padding-top: 1rem;
+  }
+  
+  .better-ui-example {
+    margin-bottom: 2rem;
+    border: 1px solid #e0e0e0;
+    border-radius: 4px;
+    overflow: hidden;
+  }
+  
+  .better-ui-example h3 {
+    margin: 0;
+    padding: 1rem;
+    background-color: #f9f9f9;
+    border-bottom: 1px solid #e0e0e0;
+  }
+  
+  .better-ui-example-preview {
+    padding: 1.5rem;
+    border-bottom: 1px solid #e0e0e0;
+  }
+  
+  .better-ui-example-code {
+    padding: 0;
+    margin: 0;
+    background-color: #f5f5f5;
+  }
+  
+  .better-ui-example-code pre {
+    margin: 0;
+    border-radius: 0;
+  }
+  
+  /* Stili per i componenti */
+  .better-ui-button {
+    display: inline-block;
+    font-weight: 400;
+    text-align: center;
+    white-space: nowrap;
+    vertical-align: middle;
+    user-select: none;
+    border: 1px solid transparent;
+    padding: 0.5rem 1rem;
+    font-size: 1rem;
+    line-height: 1.5;
+    border-radius: 0.25rem;
+    transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
+    margin-right: 0.5rem;
+    cursor: pointer;
+  }
+  
+  .better-ui-button-primary {
+    color: #fff;
+    background-color: #007bff;
+    border-color: #007bff;
+  }
+  
+  .better-ui-button-secondary {
+    color: #fff;
+    background-color: #6c757d;
+    border-color: #6c757d;
+  }
+  
+  .better-ui-button-success {
+    color: #fff;
+    background-color: #28a745;
+    border-color: #28a745;
+  }
+  
+  .better-ui-button-danger {
+    color: #fff;
+    background-color: #dc3545;
+    border-color: #dc3545;
+  }
+  
+  .better-ui-alert {
+    position: relative;
+    padding: 1rem;
+    margin-bottom: 1rem;
+    border: 1px solid transparent;
+    border-radius: 0.25rem;
+  }
+  
+  .better-ui-alert-info {
+    color: #0c5460;
+    background-color: #d1ecf1;
+    border-color: #bee5eb;
+  }
+  
+  .better-ui-alert-success {
+    color: #155724;
+    background-color: #d4edda;
+    border-color: #c3e6cb;
+  }
+  
+  .better-ui-alert-warning {
+    color: #856404;
+    background-color: #fff3cd;
+    border-color: #ffeeba;
+  }
+  
+  .better-ui-alert-danger {
+    color: #721c24;
+    background-color: #f8d7da;
+    border-color: #f5c6cb;
+  }
+  
+  .better-ui-card {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    min-width: 0;
+    word-wrap: break-word;
+    background-color: #fff;
+    background-clip: border-box;
+    border: 1px solid rgba(0, 0, 0, 0.125);
+    border-radius: 0.25rem;
+    margin-bottom: 1rem;
+  }
+  
+  .better-ui-card-header {
+    padding: 0.75rem 1.25rem;
+    margin-bottom: 0;
+    background-color: rgba(0, 0, 0, 0.03);
+    border-bottom: 1px solid rgba(0, 0, 0, 0.125);
+  }
+  
+  .better-ui-card-title {
+    margin: 0;
+    font-size: 1.25rem;
+  }
+  
+  .better-ui-card-body {
+    flex: 1 1 auto;
+    padding: 1.25rem;
+  }
+  
+  .better-ui-card-footer {
+    padding: 0.75rem 1.25rem;
+    background-color: rgba(0, 0, 0, 0.03);
+    border-top: 1px solid rgba(0, 0, 0, 0.125);
+  }
+  
+  .better-ui-tabs {
+    margin-bottom: 1rem;
+  }
+  
+  .better-ui-tab-list {
+    display: flex;
+    flex-wrap: wrap;
+    border-bottom: 1px solid #dee2e6;
+    margin-bottom: 0;
+    list-style: none;
+  }
+  
+  .better-ui-tab-item {
+    display: block;
+    padding: 0.5rem 1rem;
+    border: 1px solid transparent;
+    border-top-left-radius: 0.25rem;
+    border-top-right-radius: 0.25rem;
+    cursor: pointer;
+    background: none;
+    margin-bottom: -1px;
+  }
+  
+  .better-ui-tab-item:hover {
+    border-color: #e9ecef #e9ecef #dee2e6;
+  }
+  
+  .better-ui-tab-active {
+    color: #495057;
+    background-color: #fff;
+    border-color: #dee2e6 #dee2e6 #fff;
+  }
+  
+  .better-ui-tab-content {
+    padding: 1rem;
+    border: 1px solid #dee2e6;
+    border-top: 0;
+    border-bottom-right-radius: 0.25rem;
+    border-bottom-left-radius: 0.25rem;
+  }
+</style> 

data/app/views/better_ui/docs/index.html.erb

@@ -0,0 +1,100 @@
+<% content_for :title, 'Documentazione' %>
+
+<div class="better-ui-doc-header">
+  <h1>BetterUI - Componenti UI per Rails</h1>
+  <p>Una libreria di componenti UI riutilizzabili per Rails con documentazione integrata.</p>
+</div>
+
+<div class="better-ui-doc-section">
+  <h2>Introduzione</h2>
+  <p>
+    BetterUI è una gemma Rails che fornisce componenti UI riutilizzabili pronti all'uso.
+    L'obiettivo principale è fornire un set di componenti UI coerenti e facilmente personalizzabili
+    che possono essere integrati in qualsiasi applicazione Rails.
+  </p>
+</div>
+
+<div class="better-ui-doc-section">
+  <h2>Installazione</h2>
+  <p>Aggiungi questa riga al tuo Gemfile:</p>
+  <pre><code>gem 'better_ui'</code></pre>
+  
+  <p>Quindi esegui:</p>
+  <pre><code>$ bundle install</code></pre>
+  
+  <p>O installa tu stesso la gemma:</p>
+  <pre><code>$ gem install better_ui</code></pre>
+</div>
+
+<div class="better-ui-doc-section">
+  <h2>Configurazione</h2>
+  <p>Per montare l'engine nel tuo file routes.rb:</p>
+  <pre><code>Rails.application.routes.draw do
+  mount BetterUi::Engine => "/better_ui"
+end</code></pre>
+</div>
+
+<div class="better-ui-doc-section">
+  <h2>Componenti disponibili</h2>
+  <div class="better-ui-component-grid">
+    <% @components.each do |component| %>
+      <div class="better-ui-component-card">
+        <h3><%= component[:name] %></h3>
+        <p>Esplora la documentazione e gli esempi per il componente <%= component[:name] %>.</p>
+        <%= link_to "Visualizza dettagli", component[:path], class: "better-ui-component-link" %>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+<style>
+  .better-ui-doc-header {
+    margin-bottom: 2rem;
+    border-bottom: 1px solid #e0e0e0;
+    padding-bottom: 1rem;
+  }
+  
+  .better-ui-doc-section {
+    margin-bottom: 2rem;
+  }
+  
+  .better-ui-doc-section h2 {
+    margin-bottom: 1rem;
+    color: #333;
+  }
+  
+  pre {
+    background-color: #f5f5f5;
+    padding: 1rem;
+    border-radius: 4px;
+    overflow-x: auto;
+  }
+  
+  code {
+    font-family: monospace;
+  }
+  
+  .better-ui-component-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+    gap: 1rem;
+  }
+  
+  .better-ui-component-card {
+    border: 1px solid #e0e0e0;
+    border-radius: 4px;
+    padding: 1rem;
+    background-color: #f9f9f9;
+  }
+  
+  .better-ui-component-link {
+    display: inline-block;
+    margin-top: 1rem;
+    color: #007bff;
+    text-decoration: none;
+  }
+  
+  .better-ui-component-link:hover {
+    text-decoration: underline;
+  }
+</style>