solidstats 1.0.0 → 2.0.0

data/lib/generators/solidstats/feature/templates/component.html.erb

@@ -0,0 +1,84 @@
+<%# <%= human_name %> Component Partial %>
+<% 
+  # Initialize data with defaults
+  data ||= { value: 0, items: [], status: :ok, last_updated: Time.current }
+  
+  # Include helper module methods
+  extend Solidstats::<%= class_name %>Helper
+%>
+
+<div class="<%= file_name.dasherize %>-component">
+  <div class="component-header">
+    <div class="header-main">
+      <h3 class="component-title">
+        <span class="component-icon"><%= options[:icon] %></span>
+        <%= human_name %>
+      </h3>
+      <div class="component-status <%%= <%= file_name %>_status_class(data) %>">
+        <span class="status-icon"><%%= <%= file_name %>_status_icon(data) %></span>
+        <span class="status-text"><%%= <%= file_name %>_status_text(data) %></span>
+      </div>
+    </div>
+    <div class="header-meta">
+      <span class="last-updated">Last updated: <%%= <%= file_name %>_last_updated(data) %></span>
+    </div>
+  </div>
+
+  <div class="component-content">
+    <div class="metric-overview">
+      <div class="metric-card primary">
+        <div class="metric-icon"><%= options[:icon] %></div>
+        <div class="metric-data">
+          <div class="metric-value"><%%= <%= file_name %>_value_display(data) %></div>
+          <div class="metric-label">Total <%= human_name %></div>
+        </div>
+      </div>
+
+      <%% if <%= file_name %>_item_count(data) > 0 %>
+        <div class="metric-card secondary">
+          <div class="metric-icon">📊</div>
+          <div class="metric-data">
+            <div class="metric-value"><%%= <%= file_name %>_item_count(data) %></div>
+            <div class="metric-label">Items Found</div>
+          </div>
+        </div>
+      <%% end %>
+    </div>
+
+    <%% if <%= file_name %>_has_items?(data) %>
+      <div class="items-section">
+        <h4 class="section-title">Details</h4>
+        <div class="items-grid">
+          <%% data[:items].first(5).each do |item| %>
+            <div class="item-card">
+              <div class="item-header">
+                <span class="item-name"><%%= item[:name] %></span>
+                <span class="item-value"><%%= item[:value] %></span>
+              </div>
+              <%% if item[:category] %>
+                <div class="item-meta">
+                  <span class="item-category"><%%= item[:category].humanize %></span>
+                </div>
+              <%% end %>
+            </div>
+          <%% end %>
+        </div>
+        
+        <%% if data[:items].size > 5 %>
+          <div class="view-all-link">
+            <a href="<%%= solidstats.<%= file_name %>_path %>" class="action-button">
+              <span class="action-icon">👁️</span>
+              View All (<%%= data[:items].size %> total)
+            </a>
+          </div>
+        <%% end %>
+      </div>
+    <%% else %>
+      <div class="empty-state">
+        <div class="empty-icon">🎉</div>
+        <div class="empty-message">No <%= file_name.humanize.downcase %> items found</div>
+        <div class="empty-description">This is good news! Everything looks clean.</div>
+      </div>
+    <%% end %>
+  </div>
+</div>

data/lib/generators/solidstats/feature/templates/component.rb.erb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+# Helper module for <%= human_name %> component rendering
+# This provides data processing and helper methods for the <%= file_name %> partial
+module Solidstats
+  module <%= class_name %>Helper
+    def <%= file_name %>_status_class(data)
+      "status-#{data[:status] || 'ok'}"
+    end
+
+    def <%= file_name %>_status_icon(data)
+      case data[:status]&.to_sym
+      when :good then "✅"
+      when :warning then "⚠️"
+      when :critical then "❌"
+      when :info then "ℹ️"
+      else "❓"
+      end
+    end
+
+    def <%= file_name %>_status_text(data)
+      case data[:status]&.to_sym
+      when :good then "Good"
+      when :warning then "Warning"
+      when :critical then "Critical"
+      when :info then "Info"
+      else "Unknown"
+      end
+    end
+
+    def <%= file_name %>_value_display(data)
+      value = data[:value]
+      return "0" unless value
+
+      case value
+      when String then value
+      when Numeric
+        # Format large numbers with commas
+        if value >= 1000
+          number_with_delimiter(value)
+        else
+          value.to_s
+        end
+      else
+        value.to_s
+      end
+    end
+
+    def <%= file_name %>_last_updated(data)
+      return "Never" unless data[:last_updated]
+      
+      time = data[:last_updated]
+      time = Time.parse(time) if time.is_a?(String)
+      
+      distance_of_time_in_words(time, Time.current) + " ago"
+    end
+
+    def <%= file_name %>_has_items?(data)
+      data[:items].present? && data[:items].any?
+    end
+
+    def <%= file_name %>_item_count(data)
+      return 0 unless data[:items].present?
+      data[:items].length
+    end
+
+    def <%= file_name %>_summary_metrics(data)
+      {
+        value: <%= file_name %>_value_display(data),
+        status: <%= file_name %>_status_text(data),
+        last_updated: <%= file_name %>_last_updated(data),
+        item_count: <%= file_name %>_item_count(data)
+      }
+    end
+
+    def <%= file_name %>_trend_indicator(data)
+      return "" unless data[:trend]
+      
+      case data[:trend]&.to_sym
+      when :up then "📈"
+      when :down then "📉"
+      when :stable then "➡️"
+      else ""
+      end
+    end
+
+    def <%= file_name %>_priority_class(item)
+      return "" unless item.is_a?(Hash) && item[:priority]
+      
+      "priority-#{item[:priority]}"
+    end
+
+    def <%= file_name %>_format_item_value(item)
+      return "" unless item.is_a?(Hash)
+      
+      if item[:value].is_a?(Numeric) && item[:value] >= 1000
+        number_with_delimiter(item[:value])
+      else
+        item[:value].to_s
+      end
+    end
+  end
+end

data/lib/generators/solidstats/feature/templates/component.scss

@@ -0,0 +1,243 @@
+.<%= file_name.dasherize %>-component {
+  background-color: #fff;
+  border-radius: 12px;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+  overflow: hidden;
+  margin-bottom: 1.5rem;
+  border: 1px solid rgba(0, 0, 0, 0.05);
+}
+
+.component-header {
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  color: white;
+  padding: 1.5rem;
+  
+  .header-main {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 0.5rem;
+  }
+  
+  .component-title {
+    font-size: 1.25rem;
+    font-weight: 600;
+    margin: 0;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+  }
+  
+  .component-status {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.25rem 0.75rem;
+    border-radius: 12px;
+    background: rgba(255, 255, 255, 0.2);
+    font-size: 0.875rem;
+    
+    &.status-ok {
+      background: rgba(40, 167, 69, 0.2);
+    }
+    
+    &.status-warning {
+      background: rgba(255, 193, 7, 0.2);
+    }
+    
+    &.status-danger {
+      background: rgba(220, 53, 69, 0.2);
+    }
+    
+    &.status-error {
+      background: rgba(108, 117, 125, 0.2);
+    }
+  }
+  
+  .header-meta {
+    opacity: 0.9;
+    font-size: 0.875rem;
+  }
+}
+
+.component-content {
+  padding: 1.5rem;
+}
+
+.metric-overview {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+  gap: 1rem;
+  margin-bottom: 2rem;
+}
+
+.metric-card {
+  background: white;
+  border-radius: 8px;
+  padding: 1.25rem;
+  border: 1px solid #e5e7eb;
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  transition: all 0.3s ease;
+  
+  &:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 8px 25px -5px rgba(0, 0, 0, 0.1);
+  }
+  
+  &.primary {
+    border-left: 4px solid #3b82f6;
+  }
+  
+  &.secondary {
+    border-left: 4px solid #10b981;
+  }
+  
+  .metric-icon {
+    font-size: 1.5rem;
+    opacity: 0.8;
+  }
+  
+  .metric-data {
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+  
+  .metric-value {
+    font-size: 1.75rem;
+    font-weight: 700;
+    color: #1f2937;
+    line-height: 1;
+  }
+  
+  .metric-label {
+    font-size: 0.875rem;
+    color: #6b7280;
+    font-weight: 500;
+  }
+}
+
+.items-section {
+  .section-title {
+    font-size: 1.125rem;
+    font-weight: 600;
+    margin: 0 0 1rem 0;
+    color: #1f2937;
+  }
+}
+
+.items-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+.item-card {
+  background: #f9fafb;
+  border: 1px solid #e5e7eb;
+  border-radius: 8px;
+  padding: 1rem;
+  transition: all 0.2s ease;
+  
+  &:hover {
+    background: #f3f4f6;
+    border-color: #d1d5db;
+  }
+  
+  .item-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 0.5rem;
+  }
+  
+  .item-name {
+    font-weight: 500;
+    color: #1f2937;
+  }
+  
+  .item-value {
+    font-weight: 600;
+    color: #3b82f6;
+  }
+  
+  .item-meta {
+    font-size: 0.875rem;
+    color: #6b7280;
+  }
+  
+  .item-category {
+    background: #e5e7eb;
+    padding: 0.125rem 0.5rem;
+    border-radius: 4px;
+    font-size: 0.75rem;
+  }
+}
+
+.view-all-link {
+  text-align: center;
+  
+  .action-button {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.75rem 1.5rem;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+    text-decoration: none;
+    border-radius: 8px;
+    font-weight: 500;
+    transition: all 0.2s ease;
+    
+    &:hover {
+      transform: translateY(-1px);
+      box-shadow: 0 4px 12px rgba(102, 126, 234, 0.4);
+    }
+  }
+}
+
+.empty-state {
+  text-align: center;
+  padding: 3rem 1rem;
+  color: #6b7280;
+  
+  .empty-icon {
+    font-size: 3rem;
+    margin-bottom: 1rem;
+    opacity: 0.7;
+  }
+  
+  .empty-message {
+    font-size: 1.25rem;
+    font-weight: 600;
+    color: #374151;
+    margin-bottom: 0.5rem;
+  }
+  
+  .empty-description {
+    max-width: 400px;
+    margin: 0 auto;
+  }
+}
+
+// Responsive design
+@media (max-width: 768px) {
+  .component-header {
+    .header-main {
+      flex-direction: column;
+      gap: 0.75rem;
+      align-items: flex-start;
+    }
+  }
+  
+  .metric-overview {
+    grid-template-columns: 1fr;
+  }
+  
+  .items-grid {
+    grid-template-columns: 1fr;
+  }
+}

data/lib/generators/solidstats/feature/templates/component_test.rb.erb

@@ -0,0 +1,183 @@
+require "test_helper"
+
+module Solidstats
+  class <%= class_name %>HelperTest < ActionView::TestCase
+    include Solidstats::<%= class_name %>Helper
+    
+    def setup
+      @sample_data = {
+        value: 42,
+        count: 8,
+        status: :good,
+        last_updated: 30.minutes.ago,
+        items: [
+          {
+            name: "Test Item 1",
+            value: 15,
+            category: "important",
+            description: "Test description"
+          },
+          {
+            name: "Test Item 2",
+            value: 8,
+            category: "normal"
+          }
+        ]
+      }
+    end
+
+    test "returns correct status class" do
+      assert_equal "status-good", <%= file_name %>_status_class(@sample_data)
+      
+      warning_data = @sample_data.merge(status: :warning)
+      assert_equal "status-warning", <%= file_name %>_status_class(warning_data)
+      
+      critical_data = @sample_data.merge(status: :critical)
+      assert_equal "status-critical", <%= file_name %>_status_class(critical_data)
+    end
+
+    test "returns correct status icon" do
+      assert_equal "✅", <%= file_name %>_status_icon(@sample_data)
+      
+      warning_data = @sample_data.merge(status: :warning)
+      assert_equal "⚠️", <%= file_name %>_status_icon(warning_data)
+      
+      critical_data = @sample_data.merge(status: :critical)
+      assert_equal "❌", <%= file_name %>_status_icon(critical_data)
+    end
+
+    test "returns correct status text" do
+      assert_equal "Good", <%= file_name %>_status_text(@sample_data)
+      
+      critical_data = @sample_data.merge(status: :critical)
+      assert_equal "Critical", <%= file_name %>_status_text(critical_data)
+    end
+
+    test "displays value correctly" do
+      assert_equal "42", <%= file_name %>_value_display(@sample_data)
+      
+      large_value_data = @sample_data.merge(value: 1234567)
+      assert_equal "1,234,567", <%= file_name %>_value_display(large_value_data)
+      
+      string_value_data = @sample_data.merge(value: "Custom Value")
+      assert_equal "Custom Value", <%= file_name %>_value_display(string_value_data)
+    end
+
+    test "returns last updated time" do
+      result = <%= file_name %>_last_updated(@sample_data)
+      assert_includes result, "ago"
+      
+      no_update_data = @sample_data.except(:last_updated)
+      assert_equal "Never", <%= file_name %>_last_updated(no_update_data)
+    end
+
+    test "detects items presence" do
+      assert <%= file_name %>_has_items?(@sample_data)
+      
+      no_items_data = @sample_data.merge(items: [])
+      refute <%= file_name %>_has_items?(no_items_data)
+      
+      nil_items_data = @sample_data.merge(items: nil)
+      refute <%= file_name %>_has_items?(nil_items_data)
+    end
+
+    test "counts items correctly" do
+      assert_equal 2, <%= file_name %>_item_count(@sample_data)
+      
+      no_items_data = @sample_data.merge(items: [])
+      assert_equal 0, <%= file_name %>_item_count(no_items_data)
+      
+      nil_items_data = @sample_data.merge(items: nil)
+      assert_equal 0, <%= file_name %>_item_count(nil_items_data)
+    end
+
+    test "returns summary metrics" do
+      metrics = <%= file_name %>_summary_metrics(@sample_data)
+      
+      assert_equal "42", metrics[:value]
+      assert_equal "Good", metrics[:status]
+      assert_includes metrics[:last_updated], "ago"
+      assert_equal 2, metrics[:item_count]
+    end
+
+    test "returns trend indicators" do
+      up_data = @sample_data.merge(trend: :up)
+      assert_equal "📈", <%= file_name %>_trend_indicator(up_data)
+      
+      down_data = @sample_data.merge(trend: :down)
+      assert_equal "📉", <%= file_name %>_trend_indicator(down_data)
+      
+      stable_data = @sample_data.merge(trend: :stable)
+      assert_equal "➡️", <%= file_name %>_trend_indicator(stable_data)
+      
+      no_trend_data = @sample_data.except(:trend)
+      assert_equal "", <%= file_name %>_trend_indicator(no_trend_data)
+    end
+
+    test "returns priority class for items" do
+      high_priority_item = { priority: "high" }
+      assert_equal "priority-high", <%= file_name %>_priority_class(high_priority_item)
+      
+      low_priority_item = { priority: "low" }
+      assert_equal "priority-low", <%= file_name %>_priority_class(low_priority_item)
+      
+      no_priority_item = { name: "test" }
+      assert_equal "", <%= file_name %>_priority_class(no_priority_item)
+    end
+
+    test "formats item values correctly" do
+      large_value_item = { value: 1500 }
+      assert_equal "1,500", <%= file_name %>_format_item_value(large_value_item)
+      
+      small_value_item = { value: 42 }
+      assert_equal "42", <%= file_name %>_format_item_value(small_value_item)
+      
+      string_value_item = { value: "test" }
+      assert_equal "test", <%= file_name %>_format_item_value(string_value_item)
+    end
+
+    test "handles edge cases" do
+      # Test with nil data
+      nil_data = nil
+      assert_equal "", <%= file_name %>_priority_class(nil_data)
+      assert_equal "", <%= file_name %>_format_item_value(nil_data)
+      
+      # Test with empty hash
+      empty_hash = {}
+      assert_equal "status-ok", <%= file_name %>_status_class(empty_hash)
+      assert_equal "❓", <%= file_name %>_status_icon(empty_hash)
+      assert_equal "Unknown", <%= file_name %>_status_text(empty_hash)
+      
+      # Test with missing items
+      no_items = { value: 10 }
+      refute <%= file_name %>_has_items?(no_items)
+      assert_equal 0, <%= file_name %>_item_count(no_items)
+    end
+
+    test "handles different status values" do
+      statuses = [:good, :warning, :critical, :info, :unknown]
+      
+      statuses.each do |status|
+        test_data = @sample_data.merge(status: status)
+        
+        case status
+        when :good
+          assert_equal "✅", <%= file_name %>_status_icon(test_data)
+          assert_equal "Good", <%= file_name %>_status_text(test_data)
+        when :warning
+          assert_equal "⚠️", <%= file_name %>_status_icon(test_data)
+          assert_equal "Warning", <%= file_name %>_status_text(test_data)
+        when :critical
+          assert_equal "❌", <%= file_name %>_status_icon(test_data)
+          assert_equal "Critical", <%= file_name %>_status_text(test_data)
+        when :info
+          assert_equal "ℹ️", <%= file_name %>_status_icon(test_data)
+          assert_equal "Info", <%= file_name %>_status_text(test_data)
+        else
+          assert_equal "❓", <%= file_name %>_status_icon(test_data)
+          assert_equal "Unknown", <%= file_name %>_status_text(test_data)
+        end
+      end
+    end
+  end
+end

data/lib/generators/solidstats/feature/templates/controller.rb.erb

@@ -0,0 +1,44 @@
+module Solidstats
+  class <%= class_name %>Controller < ApplicationController
+    before_action :development_only
+    before_action :load_service
+
+    def index
+      @data = @service.detailed_data
+      
+      respond_to do |format|
+        format.html
+        format.json { render json: @data }
+      end
+    end
+
+    def refresh
+      @data = @service.fetch(true)
+      
+      respond_to do |format|
+        format.html { redirect_to solidstats.<%= file_name %>_path, notice: '<%= human_name %> data refreshed successfully.' }
+        format.json { render json: @data }
+      end
+    end
+
+    def summary
+      summary_data = @service.summary
+      
+      respond_to do |format|
+        format.json { render json: summary_data }
+      end
+    end
+
+    private
+
+    def load_service
+      @service = <%= class_name %>Service.new
+    end
+
+    def development_only
+      unless Rails.env.development?
+        head :not_found
+      end
+    end
+  end
+end