bh 1.3.6 → 6.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 4835fba6739004e8e02e01f90670e12c833b7929
-  data.tar.gz: 500cbb73beec40e8dd4e45c2cfd4e67c45fac64d
+SHA256:
+  metadata.gz: 69696e91234843a608d61dc3e40ee1016a5f53b393937edb1f31cef2ec31afe3
+  data.tar.gz: 44e44d2395418f1a0fcf9eb87846348bb433aed10e0669e1a8c1279045de1147
 SHA512:
-  metadata.gz: cae44b5d31e51196d14f6b2fe50a8875b9246935238cbebb5db4ea5c820565e474ad6a74aec284ea4285441ad582f7ca6dc3a5213be2568ef1d7c4ada2035e2f
-  data.tar.gz: ee8cbf7798afc6e732f4418c6f7c5f1094b4aa6af7cd1e15c2819980cd8e661a5a0d66d2fc421bfb05834511b32d1b964b6615bfcdec768e460924c14d0805cc
+  metadata.gz: eca07106a30e3638225040b503e983f89f90320ed5f027af5f29f1d1d5ee0d559f7257d6042d52e07b0b948b5d536c643a910698ec8b017ecf09e012f3f49b56
+  data.tar.gz: eb1049d9e7f10328eeea23fc229ce0911da5ab37bedf29cfe60c07d734b6fccd3a5c11a0bc1ed1ec1743e8953bcb44fab30a49d572a14846c85412c15143ac1b

data/CHANGELOG.md

@@ -6,6 +6,10 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 6.0.0 - 2026-02-18
+
+* [BREAKING FIXES] Literally everything changed. Moving from Bootstrap 3 to Bootstrap 6.
+
 ## 1.3.6 - 2015-12-18
 
 * [ENHANCEMENT] Bump versions of asset libraries

data/README.md

@@ -2,149 +2,19 @@ Bh · Bootstrap Helpers
 ======================
 
 A set of Ruby helpers that streamlines the use of
-[Bootstrap 3 components](http://getbootstrap.com/components) in HTML views.
+[Bootstrap 6 components](https://deploy-preview-42067--twbs-bootstrap.netlify.app/) in HTML views.
 
-The **full documentation** is available at [rubydoc.info](http://www.rubydoc.info/github/Fullscreen/bh/master/Bh/Helpers).
-
-[![Build Status](http://img.shields.io/travis/Fullscreen/bh/master.svg)](https://travis-ci.org/Fullscreen/bh)
-[![Coverage Status](http://img.shields.io/coveralls/Fullscreen/bh/master.svg)](https://coveralls.io/r/Fullscreen/bh)
-[![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/bh.svg)](https://gemnasium.com/Fullscreen/bh)
-[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/bh.svg)](https://codeclimate.com/github/Fullscreen/bh)
-[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/github/Fullscreen/bh/master/Bh/Helpers)
-[![Gem Version](http://img.shields.io/gem/v/bh.svg)](http://rubygems.org/gems/bh)
-
-Bootstrap 3 is a great framework, but requires many lines of HTML code
+Bootstrap 6 is a great framework, but requires many lines of HTML code
 even for simple components.
-For instance, you need to write the following HTML to show a _dismissible alert_:
-
-```html
-<div class="alert alert-info alert-dismissible" role="alert">
-  <button type="button" class="close" data-dismiss="alert">
-    <span aria-hidden="true">&times;</span>
-    <span class="sr-only">Close</span>
-  </button>
-  You accepted the Terms of service.
-</div>
-```
-
-Writing this for every _dismissible alert_ is cumbersome,
-repetitive, and prone to errors.
 
-With Bh, you can achieve the same result with just one line of code:
-
-```rhtml
-<%= alert_box 'You accepted the Terms of service.', dismissible: true %>
-```
-
-`alert_box` is only one of the helpers provided by Bh.
-The other ones are: `bootstrap_css`, `bootstrap_js`, `bootstrap_theme_css`,
-`button_to`, `button`, `dropdown`, `font_awesome_css`, `form_for`,
-`icon`, `modal`, `navbar`, `nav`, `panel_row`, `panel` and `progress_bar`.
+With Bh, you can achieve the same result with fewer lines of code
 
 How to install
 ==============
 
-Bh is compatible with **Rails 3.2**, **Rails 4**, **Padrino** and **Middleman**.
-
-To include the Bh gem in your project:
-
-1. Add `gem 'bh', '~> 1.3'` to the `Gemfile` file of your Rails, Padrino or Middleman project.
-2. *Only if you are using Middleman*: open `config.rb` and add `activate :bh`.
-3. *Only if you are using Padrino*: open `app.rb` and add `register Bh`.
-
-That’s all!
-From now on, you will be able to use any Bh helper in your views.
-
-A comprehensive guide to Bh helpers
-===================================
-
-All the helpers available in Bh are detailed on the [Bh homepage](http://fullscreen.github.io/bh):
-
-[![Bh homepage](https://cloud.githubusercontent.com/assets/7408595/4195282/5e823a9c-37bc-11e4-865d-bbc04aab38ec.png)](http://fullscreen.github.io/bh)
-
-Please proceed to [http://fullscreen.github.io/bh](http://fullscreen.github.io/bh) for more details and examples on how to use Bh.
-
-How to try it in your browser
-=============================
-
-The `examples` folder includes three sample apps that you can rapidly run in
-your browser and edit as you please, in order to visually appreciate the result
-of Bh.
-
-If you’d like to run the _test Rails app_:
-
-1. Download the source code
-1. `cd` into the `examples/rails` folder
-1. Run `bundle install`
-1. Run `bundle exec rails server`
-1. Point your browser to [http://0.0.0.0:3000](http://0.0.0.0:3000)
-
-If you prefer to see the helpers inside a _test Middleman app_:
-
-1. Download the source code
-1. `cd` into the `examples/middleman` folder
-1. Run `bundle install`
-1. Run `bundle exec middleman`
-1. Point your browser to [http://0.0.0.0:4567](http://0.0.0.0:4567)
-
-If you prefer to see the helpers inside a _test Padrino app_:
+1. Add `gem 'bh'` to the `Gemfile` file of your Rails app.
+2. Add this line to the `config/importmap.rb` file:
 
-1. Download the source code
-1. `cd` into the `examples/padrino` folder
-1. Run `bundle install`
-1. Run `bundle padrino start`
-1. Point your browser to [http://0.0.0.0:3000](http://0.0.0.0:3000)
-
-
-How to update
-=============
-
-Bh strictly follows [Semantic Versioning](http://semver.org).
-By indicating the version number in the *'~> major.minor'* format  in your
-Gemfile, you are guaranteed that that your project won’t break when you
-`bundle update` to a new version.
-
-Whenever a new version is released, the [CHANGELOG file](https://github.com/claudiob/bh/blob/master/CHANGELOG.md)
-will include a description of what features have changed and how to upgrade
-your code, if necessary.
-
-The full [history of Bh versions](https://gemnasium.com/gems/bh/versions) is also available.
-
-To stay updated with the latest releases, to receive code examples,
-implementation details and announcements, please consider subscribing to the
-[Bh mailing list](http://eepurl.com/2Hwfb):
-
-[![Bh mailing list](https://cloud.githubusercontent.com/assets/7408595/4204475/b8f1d8fe-3837-11e4-8e2f-79b017f583e1.png)](http://eepurl.com/2Hwfb)
-
-How to release new versions
-===========================
-
-If you are a manager of this project, remember to upgrade the [Bh gem](http://rubygems.org/gems/bh)
-whenever a new feature is added or a bug gets fixed.
-
-Make sure all the tests are passing on [Travis CI](https://travis-ci.org/Fullscreen/bh),
-document the changes in CHANGELOG.md and README.md, bump the version, then run
-
-    rake release
-
-Remember that the bh gem follows [Semantic Versioning](http://semver.org).
-
-Any new release that makes backward-compatible bug fixes should bump the *patch* version (1.1.x).
-
-Any new release that adds backward-compatible features should bump the *minor* version (1.x.0).
-
-Any new version that breaks compatibility should bump the *major* version (2.0.0)
-
-How to contribute
-=================
-
-Bh needs your support!
-
-If you find that a method is missing, fork the project, add the missing code,
-write the appropriate tests, then submit a pull request, and it will gladly
-be merged!
-
-To run the tests, simply type `bundle exec rspec` on the command line.
-
-Don’t hesitate to send code pull requests through GitHub
-and to spread the love. And [don’t click here](http://bit.ly/move-to-la)! Thanks! :)
+```ruby
+pin_all_from Bh::Engine.root.join('app/javascript/controllers'), under: 'controllers'
+```

data/app/assets/stylesheets/bh.css

@@ -0,0 +1,29 @@
+/*
+ * This file contains overrides to Bootstrap styles.
+ *
+ * Each override must be justified and explained with a comment.
+ */
+
+/* ensure highlighted text from a search is not separated from the rest of the word */
+mark { padding: 0 }
+
+/* make the base font size readable */
+:root {--bs-body-font-size: 1rem}
+
+/* ensure a field placeholder is not confused for an actual value */
+.form-control::placeholder { opacity: 0.35 }
+
+/* make radio buttons bigger */
+input[type=radio] { transform:scale(1.5); margin-right: .75rem }
+
+/* make the label around radio buttons colored when checked */
+label:has(input[type=radio]:checked) { background-color: var(--bs-primary-bg-subtle); border-color: var(--bs-primary-border) }
+
+/* Fixes bugs in Bootstrap 6.0@alpha1 where some colors are undefined */
+.form-text { color: var(--bs-secondary-text) }
+:root {
+  --bs-form-valid-color: var(--bs-success-text);
+  --bs-form-valid-border-color: var(--bs-success-border);
+  --bs-form-invalid-color: var(--bs-danger-text);
+  --bs-form-invalid-border-color: var(--bs-danger-border);
+}

data/app/javascript/controllers/bh/theme_controller.js

@@ -0,0 +1,17 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Toggle color theme between dark and light when the element is clicked.
+export default class extends Controller {
+  connect() {
+    console.log('connected')
+    document.documentElement.setAttribute('data-bs-theme', localStorage.getItem('theme'))
+  }
+
+  // Toggle color theme between dark and light when the element is clicked.
+  toggle() {
+    const oldTheme = localStorage.getItem('theme') || 'light'
+    const newTheme = ((oldTheme == 'light') ? 'dark' : 'light')
+    document.documentElement.setAttribute('data-bs-theme', newTheme)
+    localStorage.setItem('theme', newTheme)
+  }
+}

data/app/views/bh/_grid.html.erb

@@ -0,0 +1,6 @@
+<%# locals: (item:, cached: true) -%>
+<% cache_if cached, item do %>
+  <div class='container-fluid m-0'>
+    <%= yield item %>
+  </div>
+<% end %>

data/app/views/bh/_table.html.erb

@@ -0,0 +1,46 @@
+<%# locals: (items:, empty_label:, positioned: false, cached: true, headers: [], pagy: nil) -%>
+<% cache_if cached, [items, (items.unscoped.size if cached)].compact do %>
+  <%= turbo_frame_tag :results, data: { turbo_action: :advance }, class: 'w-100' do %>
+    <% if items.present? %>
+      <table class='table caption-top table-hover table-responsive'>
+        <thead>
+          <tr>
+            <% if positioned %>
+            <th scope='col'></th>
+            <% end %>
+            <% headers.each do |header| %>
+            <th scope='col'><%= header %></th>
+            <% end %>
+          </tr>
+        </thead>
+        <% if positioned %>
+        <tbody class='table-group-divider' data-controller='sortable' data-sortable-handle-value='.sortable-handle' data-sortable-resource-name-value='<%= ActiveModel::Naming.param_key items %>' data-sortable-animation-value='200'>
+        <% else %>
+        <tbody class='table-group-divider'>
+        <% end %>
+        <% items.each do |item| %>
+          <% if positioned %>
+          <tr data-sortable-update-url='<%= url_for(action: :update, id: item) %>'>
+            <td class='sortable-handle text-center' style='cursor: pointer; width: 40px'>⇅</td>
+          <% else %>
+          <tr>
+          <% end %>
+          <% cache_if (cached && !params.key?(:q)), item do %>
+            <%= yield item %>
+          <% end %>
+          </tr>
+        <% end %>
+        </tbody>
+      </table>
+
+      <% if pagy %>
+        <div class='d-flex align-items-center'>
+          <div class='ps-2 flex-grow-1'><%== pagy.info_tag %></div>
+          <div class='pe-2'><%== pagy.series_nav(:bootstrap, classes: 'pagination mb-0') if pagy.last > 1 %></div>
+        </div>
+      <% end %>
+    <% else %>
+      <p><%= empty_label %>.</p>
+    <% end %>
+  <% end %>
+<% end %>

data/bh.gemspec

@@ -1,43 +1,18 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'bh/version'
+require_relative 'lib/bh/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "bh"
   spec.version       = Bh::VERSION
   spec.authors       = ["Claudio Baccigalupo"]
-  spec.email         = ["claudio@fullscreen.net"]
+  spec.email         = ["claudio@houseaccount.com"]
   spec.description   = %q{Bh - Bootstrap Helpers}
   spec.summary       = %q{Bh provides a set of powerful helpers that
     streamlines the use of Bootstrap components in Rails views.}
-  spec.homepage      = "http://github.com/Fullscreen/bh"
+  spec.homepage      = "http://github.com/claudiob/bh"
   spec.license       = "MIT"
-
-  spec.required_ruby_version = '>= 1.9.3'
+  spec.required_ruby_version = ">= 3.2.0"
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
-
-  spec.add_dependency 'activesupport'                # versioned in gemfiles/
-  spec.add_dependency 'actionpack'                   # versioned in gemfiles/
-
-  # For development / Code coverage / Documentation
-  spec.add_development_dependency 'bundler',         '~> 1.1'
-  spec.add_development_dependency 'rspec',           '~> 3.1'
-  spec.add_development_dependency 'rake',            '~> 10.3'
-  spec.add_development_dependency 'yard',            '~> 0.8.7'
-  spec.add_development_dependency 'coveralls',       '~> 0.8.13'
-  spec.add_development_dependency 'activemodel'      # versioned in gemfiles/
-
-  unless ENV['ONLY_RAILS']
-    # For spec/dummy
-    spec.add_development_dependency 'middleman-core'   # versioned in gemfiles/
-
-    # For Middleman/Padrino tests
-    spec.add_development_dependency 'padrino-helpers', '~> 0.12.4'
-    spec.add_development_dependency 'padrino-routing', '~> 0.5.0'
-  end
-end
+end

data/lib/bh/bootstrap_helpers.rb

@@ -0,0 +1,131 @@
+module Bh
+  module BootstrapHelpers
+    def head_tags
+      <<~HEAD.html_safe
+        <meta name='viewport' content='width=device-width,initial-scale=1'>
+        <meta name='view-transition' content='same-origin'>
+        <meta name='turbo-refresh-method' content='morph'>
+        <meta name='turbo-refresh-scroll' content='preserve'>
+        <meta name='apple-mobile-web-app-capable' content='yes'>
+        <meta name='mobile-web-app-capable' content='yes'>
+        <meta name='color-scheme' content='light dark'>
+        #{csrf_meta_tags}
+        #{csp_meta_tag}
+        <script async src="https://ga.jspm.io/npm:es-module-shims@1.8.2/dist/es-module-shims.js" data-turbo-track="reload"></script>
+        #{javascript_importmap_tags}
+        <link rel='icon' href="/favicon#{'-dev' if Rails.env.development?}.png" type='image/png'>
+        <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+        <link href='https://assets.houseaccount.com/css/bootstrap.min.css' rel='stylesheet'>
+        <!-- once it's live: <link href="https://cdn.jsdelivr.net/npm/bootstrap@6.0.0-alpha1/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-VuYVTUAUbEW1A1EgqVmiLTxfqmvVgsV8yG3KeYZmz8aLednYx2pzlYdT4NS041oo" crossorigin="anonymous"> -->
+        #{stylesheet_link_tag :app, 'data-turbo-track': 'reload'}
+        #{stylesheet_link_tag :bh, 'data-turbo-track': 'reload'}
+      HEAD
+    end
+
+    def script_tags
+      <<~SCRIPTS.html_safe
+        <script src='https://assets.houseaccount.com/js/bootstrap.bundle.min.js'></script>
+        <!-- once it's live: <script src="https://cdn.jsdelivr.net/npm/bootstrap@6.0.0-alpha1/dist/js/bootstrap.bundle.min.js" integrity="sha384-kBqjI9J+3T2+popvAtxRzS3v5xO7BkyKlAyF/GZgnB0kZ2HoQdx6V1I/EX8ljPWj" crossorigin="anonymous"></script> -->
+      SCRIPTS
+    end
+
+    def navbar(options = {}, &block)
+      tag.div class: 'mb-4 border-bottom shadow-sm' do
+        tag.nav class: 'navbar navbar-expand-lg' do
+          tag.div **options, &block
+        end
+      end
+    end
+
+    def navbar_brand(brand)
+      tag.div brand, class: 'navbar-brand', data: { controller: 'bh--theme', action: 'dblclick->bh--theme#toggle' }
+    end
+
+    def card(tabs:, &block)
+      tag.div class: 'card' do
+        safe_join [card_header(tabs: tabs), card_body(&block)]
+      end
+    end
+
+    def nav(pills:)
+      tag.ul pills, class:'nav nav-pills border-bottom pb-3 mb-3'
+    end
+
+    def navbar_nav(&block)
+      tag.ul class: 'nav navbar-nav me-auto', &block
+    end
+
+    # @return [String] wraps link_to into a nav-item tab.
+    def nav_link_to(name, options, &block)
+      options.merge! nav_link_options_for(options) if block_given?
+      tag.li(class: 'nav-item') { link_to name, options, nav_link_options_for(options), &block }
+    end
+
+    def nav_link_options_for(path)
+      if current_page?(path) # request.path.starts_with? path
+        { class: 'nav-link active', aria: { current: :page } }
+      else
+        { class: 'nav-link' }
+      end
+    end
+
+    def navbar_collapsable(&block)
+      safe_join [navbar_toggler, navbar_collapse(&block)]
+    end
+
+    def navbar_toggler
+      tag.button class: 'navbar-toggler', type: 'button', data: {'bs-toggle': 'collapse', 'bs-target': '#navbarSupportedContent'}, aria: {controls: 'navbarSupportedContent', expanded: 'false', label: 'Toggle navigation'} do
+        tag.span nil, class: 'navbar-toggler-icon'
+      end
+    end
+
+    def navbar_collapse(&block)
+      tag.div class: 'collapse navbar-collapse', id: 'navbarSupportedContent', &block
+    end
+
+    def table(items:, empty_label:, positioned: false, cached: true, headers: [], pagy: nil, &block)
+      render 'bh/table', items: items, empty_label: empty_label, positioned: positioned, cached: cached, headers: headers, pagy: pagy, &block
+    end
+
+    # Renders the block inside a grid row.
+    def grid_row(&block)
+      tag.div class: 'row p-2 border-bottom border-subtle', &block
+    end
+
+    # Renders key and value next to each other inside a grid row.
+    def grid_column(key, value)
+      left = tag.div key, class: 'col-3 p-2 fst-italic'
+      right = tag.div value, class: 'col p-2'
+      safe_join [ left, right ]
+    end
+
+    def grid(item:, cached: true, &block)
+      render 'bh/grid', item: item, cached: cached, &block
+    end
+
+    # Returns a link_to that opens the link outside of the current turbo frame.
+    # @note Helpful for links within an administered/table that uses +turbo_action: :advance+.
+    def turbo_link_to(name, options, html_options = {})
+      link_to name, options, html_options.merge(data: { turbo_frame: '_top' })
+    end
+
+    # Display a link with an emoji to edit a resource inside a table.
+    def edit_link_to(path)
+      tag.td class: 'text-center', style: 'width: 40px' do
+        turbo_link_to '➡️', path, class: 'text-decoration-none'
+      end
+    end
+
+  private
+
+    def card_header(tabs:)
+      tag.div class:'card-header' do
+        tag.ul tabs, class: 'nav nav-tabs card-header-tabs'
+      end
+    end
+
+    def card_body(&block)
+      tag.div class: 'card-body card-row py-4', &block
+    end
+  end
+end

data/lib/bh/engine.rb

@@ -0,0 +1,13 @@
+require_relative 'bootstrap_helpers'
+
+module Bh
+  class Engine < Rails::Engine
+    initializer 'bh.view_helpers' do
+      ActiveSupport.on_load(:action_view) { include Bh::BootstrapHelpers }
+    end
+
+    initializer 'bh.assets' do |app|
+      app.config.assets.paths << root.join('app/javascript')
+    end
+  end
+end

data/lib/bh/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Bh
-  VERSION = '1.3.6'
+  VERSION = '6.0.0'
 end

data/lib/bh.rb

@@ -1,17 +1,9 @@
-require 'active_support'
-require 'active_support/core_ext'
+# frozen_string_literal: true
+
+require 'bh/version'
+require 'bh/engine' if defined?(Rails)
 
-# Bootstrap Helpers
 module Bh
-  mattr_accessor :framework
+  class Error < StandardError; end
+  # Your code goes here...
 end
-
-# Always require every generic helper
-helpers_folder = File.expand_path '../bh/helpers/*_helper.rb', __FILE__
-Dir[helpers_folder].each{|file| require file}
-
-# Conditionally require platform-specific helpers
-extension   = :railtie if defined?(Rails)
-extension ||= :middleman if defined?(Middleman)
-extension ||= :padrino if defined?(Padrino)
-require "bh/core_ext/#{extension}" if extension