bs5 0.0.4 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d4e64b1fb40e3224c42147923de60bb7233c2c2fbf411674e0bca31c093c837
-  data.tar.gz: 80ef0fe973d5cab69eb75e4834dbaed31c1886d13c4f6586aeed655d0a69ba2a
+  metadata.gz: 54b572156c8e8680ba3937031736fe9cdb6e2aeaf2ea88cb49b6e26c18e02c35
+  data.tar.gz: 4a4650ceee8e21d32f6a905f00c398e072bb407a4f118cd95488454f9ef61121
 SHA512:
-  metadata.gz: a4b8e31ace3f99001251e99f0e8c7d2ad8e2320008223c7b346eeca08fcd9e39d2b59c208e181720a2c6e611550a6913e11cc941b0c92a89dffd73b4bf9d615d
-  data.tar.gz: 10bcf562669a15ea680eea134048ab9ee32986e905e28173184ddf044842ac6dafdb507817a3154487e2fa5e567aaa2209313e25752b77e7699df18720adc630
+  metadata.gz: c3be0fb1a7839cafbd9673ee974879fd2e95c13e25c5a0f73a27c278c0f2abb1d4305d7eaf965999e5c5fcd390079d116c9aea297e63c1ce5530fdc3e455deb8
+  data.tar.gz: 73f164bfd36774c565a358e23e294d49b8f386db1450e92a9e73cefd81fa2951b7560705c6e098607a5005e50bf071c094a23d1eacfadf304be61c07995771df

data/README.md

@@ -2,7 +2,7 @@
 
 This is a Ruby on Rails engine to include [Bootstrap 5](https://v5.getbootstrap.com/).
 
-[![Gem Version](https://badge.fury.io/rb/bs5.svg)](https://badge.fury.io/rb/bs5)
+[![Gem Version](https://badge.fury.io/rb/bs5.svg)](https://badge.fury.io/rb/bs5) [![Build Status](https://travis-ci.org/bazzel/bs5.svg?branch=main)](https://travis-ci.org/bazzel/bs5) [![Ruby Style Guide](https://img.shields.io/badge/code_style-community-brightgreen.svg)](https://rubystyle.guide)
 
 ## Usage
 
@@ -34,75 +34,6 @@ Run the following command to setup your project to use Bootstrap 5.
 
     $ rails generate bs5:install
 
-## Components
-
-### [Accordion](https://v5.getbootstrap.com/docs/5.0/components/accordion/) ✅
-
-```
-<%= bs5_accordion do |accordion| %>
-  <% accordion.slot(:item, title: 'Accordion Item #1', collapsed: false) do %>
-    <strong>This is the first item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
-  <% end %>
-  <% accordion.slot(:item, title: 'Accordion Item #2') do %>
-    <strong>This is the second item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
-  <% end %>
-  <% accordion.slot(:item, title: 'Accordion Item #3') do %>
-    <strong>This is the third item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
-  <% end %>
-<%- end %>
-```
-
-```
-<%= bs5_accordion(flush: true) do |accordion| %>
-  <% accordion.slot(:item, title: 'Accordion Item #1') do %>
-    Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
-  <% end %>
-  <% accordion.slot(:item, title: 'Accordion Item #2') do %>
-    Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
-  <% end %>
-  <% accordion.slot(:item, title: 'Accordion Item #3') do %>
-    Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
-  <% end %>
-<%- end %>
-```
-
-### [Alert](https://v5.getbootstrap.com/docs/5.0/components/alerts/) ✅
-
-```
-<%= bs5_alert do %>
-  A simple primary alert—check it out!
-<%- end %>
-```
-
-```
-<%= bs5_alert(style: :warning, is_dismissable: true) do %>
-  <strong>Holy guacamole!</strong> You should check in on some of those fields below.
-<%- end %>
-```
-
-### [Badge](https://v5.getbootstrap.com/docs/5.0/components/badge/) ✅
-
-```
-<%= bs5_badge(text: 'New') %>
-```
-
-```
-<%= bs5_badge(text: 'Warning', style: :warning) %>
-```
-
-```
-<%= bs5_badge(text: 'Danger', style: :danger, pill: true) %>
-```
-
-
-### [Breadcrumb](https://v5.getbootstrap.com/docs/5.0/components/breadcrumb/)
-
-### [Button](https://v5.getbootstrap.com/docs/5.0/components/buttons/)
-
-## Previewing components
-
-- http://localhost:3000/rails/view_components
-
 ## Contributing
 
 Contribution directions go here.

data/app/components/bs5/alert_component.html.erb

@@ -1,6 +1,6 @@
 <div class="<%= component_class %>" role="alert">
   <%= content %>
   <%- if is_dismissable %>
-    <button type="button" class="btn-close" data-dismiss="alert" aria-label="Close"></button>
+    <%= render Bs5::CloseButtonComponent.new(data: { dismiss: :alert }) %>
   <%- end %>
 </div>

data/app/components/bs5/alert_component.rb

@@ -2,6 +2,8 @@
 
 module Bs5
   class AlertComponent < ViewComponent::Base
+    STYLES = %i[primary secondary success danger warning info light dark].freeze
+
     attr_reader :style, :is_dismissable
 
     include ActiveModel::Validations

data/app/components/bs5/badge_component.rb

@@ -2,6 +2,8 @@
 
 module Bs5
   class BadgeComponent < ViewComponent::Base
+    STYLES = %i[primary secondary success danger warning info light dark].freeze
+
     attr_reader :text, :style
 
     include ActiveModel::Validations

data/app/components/bs5/breadcrumb_component.html.erb

@@ -0,0 +1,9 @@
+<% if items.any? %>
+  <nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+      <% items.each do |item| %>
+        <li class="breadcrumb-item <%= item == items.last ? 'active' : '' %>" <%= item == items.last ? 'aria-current=page' : '' %>><%= item.content %></li>
+      <% end %>
+    </ol>
+  </nav>
+<% end %>

data/app/components/bs5/breadcrumb_component.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Bs5
+  class BreadcrumbComponent < ViewComponent::Base
+    include ViewComponent::Slotable
+
+    with_slot :item, collection: true, class_name: 'Item'
+
+    class Item < ViewComponent::Slot
+    end
+  end
+end

data/app/components/bs5/button_tag_component.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+module Bs5
+  class ButtonTagComponent < ViewComponent::Base
+    STYLES = %i[primary secondary success danger warning info light dark link].freeze
+    SIZES = %i[small large].freeze
+
+    attr_reader :content_or_options, :options, :size
+
+    include ActiveModel::Validations
+    validates :style, style: true
+    validates :size, inclusion: { in: SIZES, valid_sizes: SIZES.to_sentence, allow_nil: true }
+
+    def initialize(content_or_options = nil, options = nil)
+      @content_or_options = content_or_options.dup
+      @options = options.dup
+
+      extract_custom_options
+      merge_default_options
+    end
+
+    def before_render
+      raise errors.full_messages.to_sentence if invalid?
+    end
+
+    def call
+      if content
+        button_tag(content_or_options, options) { content }
+      else
+        button_tag(content_or_options, options)
+      end
+    end
+
+    private
+
+    def extract_custom_options
+      extract_style
+      extract_outline
+      extract_size
+    end
+
+    def extract_style
+      if @content_or_options.is_a? Hash
+        @style = @content_or_options.delete(:style)
+        @content_or_options = nil if @content_or_options.empty?
+      elsif @options.is_a? Hash
+        @style = @options.delete(:style)
+        @options = nil if @options.empty?
+      end
+    end
+
+    def extract_outline
+      if @content_or_options.is_a? Hash
+        @outline = @content_or_options.delete(:outline)
+        @content_or_options = nil if @content_or_options.empty?
+      elsif @options.is_a? Hash
+        @outline = @options.delete(:outline)
+        @options = nil if @options.empty?
+      end
+    end
+
+    def extract_size
+      if @content_or_options.is_a? Hash
+        @size = @content_or_options.delete(:size)
+        @content_or_options = nil if @content_or_options.empty?
+      elsif @options.is_a? Hash
+        @size = @options.delete(:size)
+        @options = nil if @options.empty?
+      end
+    end
+
+    def merge_default_options
+      if @content_or_options.is_a? Hash
+        deep_merge_and_join @content_or_options, default_options
+      else
+        @options ||= {}
+        deep_merge_and_join @options, default_options
+      end
+    end
+
+    def default_options
+      {
+        class: button_class
+      }
+    end
+
+    def button_class
+      ['btn', contextual_class, size_class].compact.join(' ')
+    end
+
+    def contextual_class
+      ['btn', outline? ? 'outline' : nil, style].compact.join('-')
+    end
+
+    def size_class
+      return unless size?
+
+      x = { large: 'lg', small: 'sm' }[@size]
+
+      "btn-#{x}"
+    end
+
+    def style
+      (@style || 'primary').to_sym
+    end
+
+    def outline?
+      !!@outline
+    end
+
+    def size?
+      !!@size
+    end
+
+    def deep_merge_and_join(h1, h2)
+      h1.deep_merge!(h2) do |key, this_val, other_val|
+        [this_val, other_val].join(' ').strip
+      end
+    end
+  end
+end

data/app/components/bs5/close_button_component.html.erb

@@ -0,0 +1,7 @@
+<%= button_tag '',
+  type: 'button',
+  class: component_class,
+  disabled: disabled?,
+  aria: { label: 'Close'},
+  data: data
+%>

data/app/components/bs5/close_button_component.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Bs5
+  class CloseButtonComponent < ViewComponent::Base
+    attr_reader :data
+
+    def initialize(disabled: false, white: false, data: nil)
+      @disabled = disabled
+      @white = white
+      @data = data
+    end
+
+    private
+
+    def white?
+      @white
+    end
+
+    def disabled?
+      @disabled
+    end
+
+    def component_class
+      class_names = ['btn-close']
+      class_names << %w[btn-close-white] if white?
+      class_names.join(' ')
+    end
+  end
+end

data/app/components/bs5/example_component.html.erb

@@ -0,0 +1,8 @@
+<div class="mt-4 mb-3">
+  <div class="border rounded-2 p-4">
+    <%= render template: snippet %>
+  </div>
+  <div class="highlight p-4">
+    <pre class='mb-0'><code><%= highlight %></code></pre>
+  </div>
+</div>

data/app/components/bs5/example_component.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'rouge'
+
+module Bs5
+  class ExampleComponent < ViewComponent::Base
+    include ComponentsHelper
+
+    attr_reader :snippet
+
+    def initialize(snippet:)
+      @snippet = snippet
+      @path = snippet.split('/')
+      @basename = @path.pop
+    end
+
+    def highlight
+      formatter = Rouge::Formatters::HTML.new
+      lexer = Rouge::Lexer.find(language)
+      formatter.format(lexer.lex(file_content)).html_safe # rubocop:disable Rails/OutputSafety
+    end
+
+    private
+
+    def file_content
+      @file_content ||= file.read
+    end
+
+    def file
+      @file ||= examples_path
+                .join(*@path)
+                .children
+                .find { |ch| ch.basename.to_s.start_with?(@basename) }
+    end
+
+    def examples_path
+      Engine.root.join('app', 'views', 'bs5', 'examples')
+    end
+
+    def language
+      file.extname.delete('.')
+    end
+  end
+end

data/app/controllers/bs5/application_controller.rb

@@ -1,5 +1,14 @@
+# frozen_string_literal: true
+
 module Bs5
   class ApplicationController < ActionController::Base
     protect_from_forgery with: :exception
+    before_action :set_views_path
+
+    private
+
+    def set_views_path
+      append_view_path Engine.root.join('app', 'views', 'bs5', 'examples')
+    end
   end
 end

data/app/controllers/bs5/examples_controller.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_dependency 'bs5/application_controller'
+
+module Bs5
+  class ExamplesController < ApplicationController
+    def index; end
+  end
+end

data/app/helpers/bs5/application_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Bs5
   module ApplicationHelper
   end

data/app/helpers/bs5/components_helper.rb

@@ -2,20 +2,21 @@
 
 module Bs5
   module ComponentsHelper
-    def bs5_accordion(*args)
-      render AccordionComponent.new(*args) do |accordion|
-        yield accordion if block_given?
-      end
-    end
+    COMPONENTS = %w[accordion alert badge close_button breadcrumb button_tag].freeze
 
-    def bs5_alert(*args)
-      render AlertComponent.new(*args) do
-        yield if block_given?
+    COMPONENTS.each do |name|
+      define_method("bs5_#{name}") do |*args, &block|
+        clazz = "Bs5::#{name.classify}Component".constantize
+        render_component(clazz, *args, &block)
       end
     end
 
-    def bs5_badge(*args)
-      render BadgeComponent.new(*args)
+    private
+
+    def render_component(component_clazz, *args)
+      render component_clazz.new(*args) do |c|
+        yield c if block_given?
+      end
     end
   end
 end

data/app/helpers/bs5/examples_helper.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Bs5
+  module ExamplesHelper
+    def bs5_example(*args)
+      render ExampleComponent.new(*args)
+    end
+  end
+end

data/app/models/bs5/application_record.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Bs5
   class ApplicationRecord < ActiveRecord::Base
     self.abstract_class = true