bh 6.8.0 → 6.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c459a4f1b4c83f76208288d0fcaa877ff4e90ff22e176db261622070dc7e8baf
-  data.tar.gz: c91ff74b63a56449dda82736e3a930596d8c9db1c61b9174dfa856cf7f7d9173
+  metadata.gz: 1cd77c71793dce878451ae631e1072b5edb1b8cf711e6905eeec3990f3fb359a
+  data.tar.gz: 5c156dd6204dde82cd2fc5cc1f1f0de8303aafb9b852d8bc1598d02326b5e791
 SHA512:
-  metadata.gz: 44cc5e7e1672de1a525d7ea28f710210129750fcc9d1652eb14ba76879e375f547a5d88fb8b36783d02b11ed5c20812b8835bc11f68be0fc410509cf582ac09b
-  data.tar.gz: 38e4622db91c415c7aabb1c8e64bf8c16227e2a44c6ecc08a50186d5ef513db604fe8819044cd44f97c8ab9fcfd5153247d9a33ab5e64df09675268e3366b58b
+  metadata.gz: 9bb7c8f7bdeab02553154c22630b40aebcdcdffd69c3c8b7353e429e4ae8e0b241bf2cd061cdc2782df1f1292fd5fbece8f5be196494b47556325967b4671e57
+  data.tar.gz: 108ebfbee3a538d02710cd5b80ab22055714ba0393efa1a2abaf57a23d46bd08dc9cfbc674eaab5f4f8f2dd9b7eea70f43435557f1b8527b4d03a1b3e8da789a

data/CHANGELOG.md

@@ -8,6 +8,14 @@ For more information about changelogs, check
 
 ## [Unreleased]
 
+## 6.9.0 - 2026-09-20
+
+* [FEATURE] A box can say what ticking it means
+
+  `check` takes a `description:`, which is the line Bootstrap draws under the words beside
+  a box: `form.check :insured, 'Insured', description: 'Uninsured providers are only
+  offered preferred work.'` Given none, the markup is what it was.
+
 ## 6.8.0 - 2026-09-19
 
 * [FEATURE] A field a browser keeps an answer for says which

data/README.md

@@ -20,18 +20,13 @@ gem install bh
 ```
 
 ```ruby
-# Gemfile
-gem 'bh', '~> 6.8.0'
+gem 'bh', '~> 6.9.0'
 ```
 
-`~> 6.8.0` stops short of `6.9`, 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.9.0` stops short of `6.10`, which is the pin to hold while this line still breaks on a
+minor rather than on a major.
 
-6.2.0 breaks everything before it and keeps its major anyway. 6.0 through 6.1.4 were an alpha
-in everything but the number — Bootstrap 3 wrappers with a Bootstrap 6 stopgap bolted on, cut
-while Bootstrap 6 was itself pre-release — so there was no settled API to break. Those numbers
-are taken and cannot be withdrawn, RubyGems keeping anything published over thirty days ago, so
-this release steps over them.
+## The stylesheet and the script
 
 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:
@@ -81,6 +76,7 @@ end
 | `fieldset` `label` `submit` `button` | the form's furniture, with the pill Bootstrap draws |
 | every `*_field`, `text_area`, `select`, `check` | dressed at one size, so a view says which kind and nothing about how it looks |
 | `phone_field` | a North American number, shaped `555-555-5555` as it is typed |
+| `price_field` `percentage_field` | money and a share of a hundred, typed into Bootstrap's adorned control |
 | `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 |
@@ -111,4 +107,4 @@ rails s
 - [API reference](https://rubydoc.info/gems/bh) — built from what RubyGems holds
 - [CHANGELOG](CHANGELOG.md) — what each release is, and which of the three it is
 
-MIT licensed. Drawn for [houseaccount](https://houseaccount.com/) by the Earl of Bubblehum.
+MIT licensed.

data/lib/bh/form_builder/controls.rb

@@ -58,12 +58,25 @@ module Bh
 
       # 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.
+      # A `description:` is the line under those words, for a box whose label is too short to
+      # say what ticking it means. Every other option is the box's.
       def check(method, text, options = {})
-        words = @template.label_tag field_id(method), text
-        inside = @template.safe_join [check_box(method, options), words]
+        box = check_box method, options.except(:description)
+        inside = @template.safe_join [box, checked_words(method, text, options[:description])]
 
         @template.tag.div inside, class: 'form-field'
       end
+
+    private
+
+      def checked_words(method, text, description)
+        words = @template.label_tag field_id(method), text
+        return words unless description
+
+        said = @template.tag.small description, class: 'form-text'
+
+        @template.tag.div @template.safe_join([words, said]), class: 'form-field-content'
+      end
     end
   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.8.0'
+  VERSION = '6.9.0'
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bh6",
-  "version": "6.6.0",
+  "version": "6.8.0",
   "private": true,
   "description": "Bootstrap 6 in a Rails app: the form builder that dresses every field, the components Bootstrap ships behavior for and no markup, and the Stimulus controllers behind them.",
   "license": "MIT",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bh
 version: !ruby/object:Gem::Version
-  version: 6.8.0
+  version: 6.9.0
 platform: ruby
 authors:
 - claudiob