bh 6.6.0 → 6.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9c573e779abc79338fe373283a0f0e30805337a2daad8804fc826e9b22acd55
-  data.tar.gz: 7b8041b33fbcccaccb94902bbc8947f88ebc5aa8ccdd5ba5613241a37c777cb7
+  metadata.gz: 9161e2164dd9b496c6ad7210d47f43ab01c2dba40101e3f4c7ef90da2d782d82
+  data.tar.gz: df825d0fb572112a3c36d3a82b8035b5005e669affe3da80b1f9c792bc78bafc
 SHA512:
-  metadata.gz: 65668c148e51ae156e55de930fc3656c91bdecd61ac9b6d555022ffb4a3a6dfc6021cca19e83b6c85e536c712f58665f11e3914dab92834c2d576071c4c63b07
-  data.tar.gz: 3a0e4eb9fc775a15ecbe432cc09e551f55a06026589bc990b03cd18cf39a2ca4a8f793cd8c07ad35a25703056cbb50144991843883b16888f3dbc37e0f6cd934
+  metadata.gz: a83fcd4a1403078a9edc6dda158025b2a05033d849f15373d4fec9d1039ae4eccafd7d250e8767a5b3da60c6d8c6b843807d73d4b87c06d709c7196ea5aff897
+  data.tar.gz: cc5f5495354b1e89e046982febfc44635427b23e9089a43e27867552bdce2e881301277849bc8a963f176a4416f3326312e969ec943de9bacb018627f4ef90f9

data/CHANGELOG.md

@@ -8,6 +8,74 @@ For more information about changelogs, check
 
 ## [Unreleased]
 
+## 6.7.0 - 2026-09-19
+
+* [CHANGE] The signup page goes
+
+  `flow` drew a page no part of Bootstrap names, out of three `content_for` keys a caller
+  never passes, in rules only one product's onboarding wanted. It belongs to whoever ships
+  that product, and this gem keeps what Bootstrap defines.
+
+  The two classes the builder writes go with it in name only: `flow-fieldset` is now
+  `bh-fieldset` and `flow-field` is `bh-field`, both being the form's business rather than
+  a page's, and the spacing of a fieldset stays here with them.
+
+* [CHANGE] The head is the host's to write
+
+  `bh_head_tags` bundled four metas a page decides for itself with the two files this gem
+  serves, all or nothing. `Bh::Engine::PREFIX` is where they are served, and a layout links
+  them:
+
+  ```erb
+  <link rel='stylesheet' href='<%= Bh::Engine::PREFIX %>css/bh.css'>
+  <script type='module' src='<%= Bh::Engine::PREFIX %>js/bh.js'></script>
+  ```
+
+* [CHANGE] `notices` is `toasts`
+
+  It draws a stack of Bootstrap's toasts and says so. `toast` is left for the one a host
+  hands over itself.
+
+  It takes `data:` for a host marking what the page it stands on is about, and a block for
+  one splicing a link into the words a message says.
+
+* [FEATURE] A control says what it is to a reader who meets it alone
+
+  Every field the builder dresses carries an `aria-label` off the attribute it sets, which
+  a page's own `aria` still overrides key by key.
+
+* [FEATURE] Money and a share of a hundred are typed into an adorned control
+
+  `price_field` and `percentage_field` draw Bootstrap's adorned control: the unit in a span
+  and the field inside it wearing no border of its own.
+
+* [FEATURE] `file_field`, which Rails handed over undressed
+
+* [FEATURE] `confirm_button_to` asks before it acts
+
+  The bundle draws the question as a dialog, and the form is sent only where it is answered
+  yes.
+
+* [FEATURE] `tooltip_data` is the data an element wearing a tooltip takes
+
+* [FEATURE] A phone field shows the shape it will take
+
+  `555-555-5555`, from the locale rather than the code, since how a number is written is
+  the reader's language and not this gem's. A page saying its own placeholder keeps it.
+
+  The only field given one: a placeholder is decoration over a label, and it earns its
+  place where it shows a shape a reader could get wrong rather than where it repeats what
+  the label already says. This is the one field where the gem knows the shape, because the
+  gem is what imposes it.
+
+* [FIX] A menu, a box and a circle wear what Bootstrap 6 draws
+
+  A `<select>` wore `form-select form-select-lg`, a ticked box `form-check-input`, and the
+  words beside it sat in a `form-check` under a `form-check-label`. Bootstrap 6 defines
+  none of those: a menu is a control like any other, a box is a `check`, a circle is a
+  `radio`, and the two of them stand in a `form-field`, which lays them out in a row. Every
+  one of them was drawing undressed.
+
 ## 6.6.0 - 2026-09-18
 
 * [CHANGE] A picture in a bubble is a thumbnail

data/README.md

@@ -21,10 +21,10 @@ gem install bh
 
 ```ruby
 # Gemfile
-gem 'bh', '~> 6.3.0'
+gem 'bh', '~> 6.7.0'
 ```
 
-`~> 6.3.0` stops short of `6.4`, and that is the pin to hold: **until this line settles it
+`~> 6.7.0` stops short of `6.8`, and that is the pin to hold: **until this line settles it
 breaks on a minor, not on a major.** Rails 8.1 and Ruby 3.2 are the minimum.
 
 6.2.0 breaks everything before it and keeps its major anyway. 6.0 through 6.1.4 were an alpha
@@ -33,11 +33,12 @@ while Bootstrap 6 was itself pre-release — so there was no settled API to brea
 are taken and cannot be withdrawn, RubyGems keeping anything published over thirty days ago, so
 this release steps over them.
 
-With the gem in the bundle an app serves `/bh/css/bh.css` and `/bh/js/bh.js` itself. One helper
-puts both in the head, along with everything Bootstrap and Turbo read:
+With the gem in the bundle an app serves `/bh/css/bh.css` and `/bh/js/bh.js` itself, at the
+prefix its engine is mounted at. A layout links both:
 
 ```erb
-<%= bh_head_tags %>
+<link rel='stylesheet' href='<%= Bh::Engine::PREFIX %>css/bh.css'>
+<script type='module' src='<%= Bh::Engine::PREFIX %>js/bh.js'></script>
 ```
 
 ## The palettes
@@ -83,9 +84,10 @@ end
 | `pin_field` | one real field drawn as six slots, offered by the phone from the text that brought it |
 | `combobox` | a `<select>` drawn as a searchable menu, still the one thing the form submits |
 | `dialog` | a link and the `<dialog>` it opens, sharing an id made from the link's own words |
-| `notices` | the flash as toasts, held while they are read |
+| `toasts` | the flash as toasts, held while they are read |
 | `chat_with` | a thread of bubbles, and the field that posts the next one |
-| `flow` | the page of a signup flow: a header, a title, one card, a footer |
+| `confirm_button_to` | a button whose form is sent only where the question it carries is answered yes |
+| `tooltip_data` | the `data` an element wearing a tooltip takes |
 | 22 Stimulus controllers | registered by the bundle, called by `data-controller` |
 | 9 palettes | served at `/bh/theme/`, swapped by the `scheme` controller |
 
@@ -101,8 +103,7 @@ bin/setup
 rails s
 ```
 
-`localhost:3000` is every component at once, `?flash=1` adds the toasts, and `/flow` is the
-signup page.
+`localhost:3000` is every component at once, and `?flash=1` adds the toasts.
 
 ## Elsewhere
 

data/app/stylesheets/bh/base.css

@@ -25,3 +25,6 @@ mark { padding: 0; }
    ::before, so the hover transform on the .bi box itself is untouched. */
 .icon-link > .bi::before { vertical-align: .0625em; }
 
+/* A group of controls carries its own spacing, and twice as much under it as over: the words
+   over a group belong to it, and even space either side would let them drift between two. */
+.bh-fieldset { margin-block: 1rem 2rem; gap: 1rem }

data/app/stylesheets/bh.css

@@ -10,4 +10,3 @@
 @import 'bh/values.css';
 @import 'bh/chat.css';
 @import 'bh/pin.css';
-@import 'bh/flow.css';

data/config/locales/bh.en.yml

@@ -9,6 +9,7 @@ en:
     no_results: Nothing matches that
     okay: Okay
     photo: Photo
+    phone: 555-555-5555
     search: Search
     send: Send
     typing: Typing

data/lib/bh/form_builder/adornments.rb

@@ -0,0 +1,47 @@
+require 'action_view'
+
+module Bh
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # The two controls that carry a unit inside their border: money, and a share of a hundred.
+    module Adornments
+      # What a price takes: no less than nothing, and the cents a currency is counted in. A
+      # caller knowing its column's scale says so and overrides the step.
+      PRICE = { min: 0, step: 0.01 }.freeze
+
+      # What the wrapper wears. Bootstrap adorns a control by wrapping it, so the border and
+      # the padding are the wrapper's and the field inside carries neither.
+      ADORN = 'form-control form-adorn d-flex'
+
+      # What money is typed into: the number and the currency beside it, inside one border.
+      def price_field(method, options = {})
+        adorned method, currency_unit, PRICE.merge(options)
+      end
+
+      # And a share of a hundred, whose sign follows the number rather than leading it.
+      def percentage_field(method, options = {})
+        adorned method, '%', options, ending: true
+      end
+
+    private
+
+      def currency_unit = I18n.t 'number.currency.format.unit', default: '$'
+
+      def adorned(method, unit, options, ending: false)
+        classes = @template.class_names ADORN, ('form-adorn-end' if ending), options[:class]
+        unit = @template.tag.span unit, class: 'form-adorn-text'
+        inside = @template.safe_join [unit, ghost_field(method, options.except(:class))]
+
+        @template.tag.div inside, class: classes
+      end
+
+      # The control Rails draws before this builder dresses one, which is what the wrapper
+      # holds: `form-ghost` wears neither the border nor the padding a control does.
+      def ghost_field(method, options)
+        asked = { aria: { label: method } }.deep_merge options
+
+        @template.number_field @object_name, method,
+                               objectify_options(asked.merge(class: 'form-ghost'))
+      end
+    end
+  end
+end

data/lib/bh/form_builder/buttons.rb

@@ -0,0 +1,40 @@
+require 'action_view'
+
+module Bh
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # What a form is sent with, and what else it offers to press.
+    module Buttons
+      # What a button wears: the large pill in the primary color, solid or outlined.
+      PILL = 'btn btn-lg rounded-5 theme-primary'
+
+      # What clears a button of the field or the button above it.
+      SPACE = 'mt-3 md:mt-4'
+
+      # A submit is the builder's button, solid.
+      def submit(value = nil, options = {})
+        super(value, with_classes(options, "#{PILL} btn-solid #{SPACE}"))
+      end
+
+      # A button is the builder's too: solid where it submits, which is what one does unless
+      # told `type: :button`, and outlined where it does not. A disabled one given a `title`
+      # says why on hover — `Available soon` — from a wrapper around it, since a disabled
+      # button hears no mouse; the wrapper then takes the button's place in the column.
+      def button(value = nil, options = {}, &)
+        return button(nil, value, &) if value.is_a? Hash
+
+        wrapped = options[:disabled] && options[:title]
+        fill = options[:type].to_s == 'button' ? 'btn-outline' : 'btn-solid'
+        classes = @template.class_names PILL, fill, (SPACE unless wrapped)
+        button = super(value, with_classes(options.except(:title), classes), &)
+
+        wrapped ? tooltipped(button, options[:title]) : button
+      end
+
+    private
+
+      def tooltipped(button, title)
+        @template.tag.span button, class: "d-grid #{SPACE}", data: @template.tooltip_data(title)
+      end
+    end
+  end
+end

data/lib/bh/form_builder/controls.rb

@@ -6,42 +6,40 @@ module Bh
     # it wants and nothing about how it looks. Rails hands an undressed control to whatever it
     # has no method for here, which is how a Bootstrap class ends up written in a view.
     module Controls
-      # What a menu wears: the control's size, so a menu and a box beside it line up.
-      MENU = 'form-select form-select-lg'
-
-      # What a box or a circle that is ticked wears.
-      CHECK = 'form-check-input'
+      # What a box that is ticked wears, and what a circle does.
+      CHECK = 'check'
+      RADIO = 'radio'
 
       # An email address.
-      def email_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def email_field(method, options = {}) = super(method, dressed(method, options))
 
       # A number, which brings the keyboard for one.
-      def number_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def number_field(method, options = {}) = super(method, dressed(method, options))
 
       # A password, which no name of a column earns on its own.
-      def password_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def password_field(method, options = {}) = super(method, dressed(method, options))
 
       # A term to search by.
-      def search_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def search_field(method, options = {}) = super(method, dressed(method, options))
 
       # A web address.
-      def url_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def url_field(method, options = {}) = super(method, dressed(method, options))
 
       # A day.
-      def date_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def date_field(method, options = {}) = super(method, dressed(method, options))
 
       # A time of day.
-      def time_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def time_field(method, options = {}) = super(method, dressed(method, options))
 
       # A day and a time together.
-      def datetime_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def datetime_field(method, options = {}) = super(method, dressed(method, options))
 
       # More than a line of words.
-      def text_area(method, options = {}) = super(method, with_classes(options, CONTROL))
+      def text_area(method, options = {}) = super(method, dressed(method, options))
 
       # A menu of what a column may be.
       def select(method, choices = nil, options = {}, html_options = {}, &)
-        super(method, choices, options, with_classes(html_options, MENU), &)
+        super(method, choices, options, dressed(method, html_options), &)
       end
 
       # One of several, ticked.
@@ -51,16 +49,16 @@ module Bh
 
       # One of several, and only one.
       def radio_button(method, value, options = {})
-        super(method, value, with_classes(options, CHECK))
+        super(method, value, with_classes(options, RADIO))
       end
 
       # A box and the words beside it, which is the one place words sit after a control rather
       # than over it -- so they are not the label a field wears, and are written here instead.
       def check(method, text, options = {})
-        words = @template.label_tag field_id(method), text, class: 'form-check-label'
+        words = @template.label_tag field_id(method), text
         inside = @template.safe_join [check_box(method, options), words]
 
-        @template.tag.div inside, class: 'form-check'
+        @template.tag.div inside, class: 'form-field'
       end
     end
   end

data/lib/bh/form_builder.rb

@@ -1,4 +1,6 @@
 require 'action_view'
+require_relative 'form_builder/adornments'
+require_relative 'form_builder/buttons'
 require_relative 'form_builder/comboboxes'
 require_relative 'form_builder/controls'
 require_relative 'form_builder/pins'
@@ -9,17 +11,11 @@ module Bh
   # `default_form_builder`. What a view passes is kept: its classes join the builder's, its
   # `data` is merged key by key with the builder's, and any other option of its overrides.
   class FormBuilder < ActionView::Helpers::FormBuilder
-    include Comboboxes, Controls, Pins
+    include Adornments, Buttons, Comboboxes, Controls, Pins
 
     # What a field wears: Bootstrap's control, at the size a thumb finds.
     CONTROL = 'form-control form-control-lg'
 
-    # What a button wears: the large pill in the primary color, solid or outlined.
-    PILL = 'btn btn-lg rounded-5 theme-primary'
-
-    # What clears a button of the field or the button above it.
-    SPACE = 'mt-3 md:mt-4'
-
     # What a phone field carries: the bundle's `phone` controller, which shapes the number as
     # it is typed, and the keyboard and autofill a phone offers for one.
     PHONE = {
@@ -35,7 +31,7 @@ module Bh
       heading = (@template.tag.legend legend if legend)
       inside = @template.safe_join [heading, @template.capture(&)].compact
 
-      @template.tag.fieldset inside, **with_classes(options, 'd-grid flow-fieldset')
+      @template.tag.fieldset inside, **with_classes(options, 'd-grid bh-fieldset')
     end
 
     # A label is Bootstrap's `form-label`, whatever else it is given -- and given both words
@@ -51,46 +47,35 @@ module Bh
       words = @template.tag.span text, class: 'form-label'
       inside = @template.safe_join [words, @template.capture(&block)]
 
-      @template.tag.label inside, for: field_id(method), **with_classes(options, 'flow-field')
+      @template.tag.label inside, for: field_id(method), **with_classes(options, 'bh-field')
     end
 
     # A text field is a large control.
-    def text_field(method, options = {}) = super(method, with_classes(options, CONTROL))
-
-    # A phone field is a large control shaped by the `phone` controller as it is typed.
-    def phone_field(method, options = {})
-      super(method, PHONE.deep_merge(with_classes(options, CONTROL)))
-    end
-
-    # A submit is the builder's button, solid.
-    def submit(value = nil, options = {})
-      super(value, with_classes(options, "#{PILL} btn-solid #{SPACE}"))
-    end
+    def text_field(method, options = {}) = super(method, dressed(method, options))
 
-    # A button is the builder's too: solid where it submits, which is what one does unless told
-    # `type: :button`, and outlined where it does not. A disabled one given a `title` says why
-    # on hover — `Available soon` — from a wrapper around it, since a disabled button hears no
-    # mouse; the wrapper then takes the button's place in the column.
-    def button(value = nil, options = {}, &)
-      return button(nil, value, &) if value.is_a? Hash
+    # A file to attach, which Rails hands over undressed.
+    def file_field(method, options = {}) = super(method, dressed(method, options))
 
-      wrapped = options[:disabled] && options[:title]
-      fill = options[:type].to_s == 'button' ? 'btn-outline' : 'btn-solid'
-      classes = @template.class_names PILL, fill, (SPACE unless wrapped)
-      button = super(value, with_classes(options.except(:title), classes), &)
+    # A phone field is a large control shaped by the `phone` controller as it is typed, and
+    # showing the shape it will take. Read at the call rather than frozen into `PHONE`, since
+    # how a number is written is the reader's language and not this gem's.
+    def phone_field(method, options = {})
+      shown = { placeholder: @template.t('bh.phone') }
 
-      wrapped ? tooltipped(button, options[:title]) : button
+      super(method, PHONE.merge(shown).deep_merge(dressed(method, options)))
     end
 
   private
 
-    def tooltipped(button, title)
-      @template.tag.span button, class: "d-grid #{SPACE}",
-                                 data: { controller: 'tooltip', bs_title: title }
-    end
-
     def with_classes(options, classes)
       options.merge class: @template.class_names(classes, options[:class])
     end
+
+    # What a control wears, and what names it where the words that do are not beside it: the
+    # attribute, as the label a reader meeting the field alone is read it by. A page's own
+    # `aria` wins over this one, key by key.
+    def dressed(method, options, classes = CONTROL)
+      { aria: { label: method } }.deep_merge with_classes(options, classes)
+    end
   end
 end

data/lib/bh/helpers/confirmations.rb

@@ -0,0 +1,20 @@
+module Bh
+  module Helpers
+    # The button that asks before it acts.
+    module Confirmations
+      # A button whose form is sent only where the question it carries is answered yes.
+      # The bundle draws that question as a dialog. Every option is the button's, and the
+      # question rides on the form, which is what Turbo asks before submitting either.
+      # @param words [String] what the button reads.
+      # @param path [String] where the form is sent.
+      # @param confirm [String] the question, its first line the title of the dialog.
+      # @param options [Hash] anything else the button takes.
+      # @return [String] the form and the button in it.
+      def confirm_button_to(words, path, confirm:, **options)
+        form = { data: { turbo_confirm: confirm } }.deep_merge options.fetch(:form, {})
+
+        button_to words, path, **options.except(:form), form: form
+      end
+    end
+  end
+end

data/lib/bh/helpers/{notices.rb → toasts.rb}

@@ -1,7 +1,7 @@
 module Bh
   module Helpers
     # What the flash says, as the toasts every Bh page shows them in.
-    module Notices
+    module Toasts
       # Bootstrap's tone for each key, so a notice and an alert read apart; a key of the
       # host's own reads neutral.
       TONES = { 'notice' => 'theme-success', 'alert' => 'theme-danger' }.freeze
@@ -16,14 +16,21 @@ module Bh
       # other part of a host keeps in the flash, and is not something to show. Nothing at all
       # where there is nothing to say. `data-turbo-temporary`, so a toast born visible does
       # not replay from the page's snapshot on every Back.
-      def notices
+      # @param data [Hash] anything else the stack of them carries, for a host marking what
+      #   the page it stands on is about.
+      # @yield [key, message] what to draw in place of the message, for a host with a link
+      #   to splice into it. The message itself where no block is given.
+      # @return [String, nil] the toasts, or nothing where the flash says nothing.
+      def toasts(data: {}, &)
         messages = flash.to_hash.select { |_, message| message.is_a? String }
         return if messages.empty?
 
-        toasts = messages.map { |key, message| bh_toast key, message }
+        toasts = messages.map do |key, message|
+          bh_toast key, block_given? ? yield(key, message) : message
+        end
 
         tag.div safe_join(toasts), class: 'toast-container position-fixed bottom-0 end-0 p-3',
-                                   data: { turbo_temporary: '' }
+                                   data: { turbo_temporary: '' }.merge(data)
       end
 
     private

data/lib/bh/helpers/tooltips.rb

@@ -0,0 +1,15 @@
+module Bh
+  module Helpers
+    # The words an element says on hover, which Bootstrap wires nowhere on its own.
+    module Tooltips
+      # What an element carries to be given a tooltip: the controller that makes one, and
+      # what it says. `bs_title` is the name Bootstrap's own tooltip reads.
+      # @param title [String] the words the tooltip says.
+      # @param placement [String, nil] which side of the element it opens on.
+      # @return [Hash] the `data` an element wearing a tooltip takes.
+      def tooltip_data(title, placement: nil)
+        { controller: 'tooltip', bs_placement: placement, bs_title: title }.compact
+      end
+    end
+  end
+end

data/lib/bh/helpers.rb

@@ -1,12 +1,12 @@
 require_relative 'helpers/chats'
+require_relative 'helpers/confirmations'
 require_relative 'helpers/dialogs'
-require_relative 'helpers/flows'
-require_relative 'helpers/heads'
-require_relative 'helpers/notices'
+require_relative 'helpers/toasts'
+require_relative 'helpers/tooltips'
 
 module Bh
   # Everything a view may call, in one module the engine puts on every Action View.
   module Helpers
-    include Chats, Dialogs, Flows, Heads, Notices
+    include Chats, Confirmations, Dialogs, Toasts, Tooltips
   end
 end

data/lib/bh/version.rb

@@ -1,4 +1,4 @@
 module Bh
   # Version of the gem, read by the gemspec and by hosts checking compatibility.
-  VERSION = '6.6.0'
+  VERSION = '6.7.0'
 end