houseaccount 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 247974e6010176c5287b60457bafb5a026ad1ee501c944ce780e3cadb1211225
-  data.tar.gz: a0c0a478884552c608ff2e9374fbd97fdabc292089cdc752168210da18460b77
+  metadata.gz: ed184a1937949b68eddec9963ca7432953697bcc370aa9831cc91c8fa5b19514
+  data.tar.gz: 570c5608351078cecfd03b7fb72a9601fce3897cfb30218eab31cd6c193b6ae7
 SHA512:
-  metadata.gz: b4aa364acf156ea2fc1430232ed75f98d9e3416d7b7099016f7e981d8d9592dfe49f8c43237e2204552f05fcce2e2800c50f41e0857e75d52874804e2f24265b
-  data.tar.gz: 5e0a5e27071c4e0416bf8085b995aa733db8f10784bf9ca2f6690e0e07aa25c7be90365647253fb73504a19cd88a36b3ac832086559e5b801fceb962473639aa
+  metadata.gz: a20b6800724be5cb32ff25b4f9de7f086b33e79dfdd09bf72cf3e03bd9189e7e26d6e2eb91894d2b3c8917ec3a405a5050e6a7124753e7d83cd8ab301047e03f
+  data.tar.gz: '0086d99c66d0b57cb7b6072b664b978a0d6d06394d8d95e550441c7c80d23773ca772f0a0b8c777dc01b484e9b57611d699f48fc25d90bdc84ecdcd840f28308'

data/CHANGELOG.md

@@ -7,6 +7,29 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 0.13.0 - 2026-09-17
+
+* [Feature] The ascending sort glyph
+
+  `bi-sort-up` joins `bi-sort-down` in the subset. A table heading says which way its column
+  is sorted, and until now only one of the two directions had a glyph to say it with — the
+  other drew an empty box, since a name the subset does not carry has no `content` rule and
+  no code point in the font.
+
+  `unicon` names the pair as `:sort_asc` and `:sort_desc` from 3.7.0, which is where recourse
+  reads them from.
+* [Change] The card is as wide as what it holds, and a page asking one question says `30rem`
+* [Change] A legend wears nothing of ours
+* [Change] A form of more than one field reads its rows from where their words start
+* [Feature] `flow-middle` stands a card as tall as the rest and holds its content in the middle
+* [Feature] The builder dresses every kind of field, so a page writes no Bootstrap class
+* [Feature] `form.combobox` is a select the bundle searches, in the house's own words
+* [Change] A fieldset carries its own spacing and the gap between its controls
+* [Change] A rule inside the card is given room either side of it
+* [Feature] `form.check` is a box and the words beside it, which no page draws by hand now
+* [Feature] `form.label` with words and a block wraps the control, so a wide card takes two columns
+* [Feature] `flow-scroll` gives any long card the height, the inner scroll and the fixed foot a chat's card has
+
 ## 0.12.0 - 2026-09-17
 
 * [Change] The showcase shows rather than describes

data/README.md

@@ -186,6 +186,14 @@ as a template:
 <%= render template: 'layouts/houseaccount' %>
 ```
 
+A form's controls sit in `form.fieldset`, a grid, with a `legend` over them where a page has
+one; `form.label` given both its words and a block wraps the control those words name, which is
+the cell a card wide enough for two columns lays out. Every kind of field is dressed by the
+builder rather than by the page — a number, a menu, a box that is ticked — so a view names the
+kind it wants and no class at all, and `form.combobox` is a menu the bundle searches, given the
+words it says before a pick. Everything else in the fieldset keeps the whole row, and
+the card is what is measured rather than the window, so a narrow one stays in one column.
+
 `content_for :logo` is which of the family's marks the tab wears, for a page a customer reads
 rather than the app's own people: unsaid, it is this app's, by its name.
 

data/art/icons.txt

@@ -148,6 +148,7 @@ skip-forward
 sliders
 snow
 sort-down
+sort-up
 soundwave
 speedometer
 square

data/config/locales/houseaccount.en.yml

@@ -1,13 +1,18 @@
 en:
   houseaccount:
     ago: '%{time} ago'
+    all: All
     ask: Ask a question
+    clear: Clear
     close: Close
+    more: '%{first} + %{count} more'
+    no_results: Nothing matches that
     okay: Okay
     one_time_code: |-
       Enter this 6-digit code to proceed: %{pin}
 
       @%{host} #%{pin}
+    search: Search
     send: Send
     spoken_one_time_code: 'Enter this 6-digit code to proceed: %{pin}'
     typing: Typing

data/lib/houseaccount/form_builder/comboboxes.rb

@@ -0,0 +1,38 @@
+require 'action_view'
+
+module HouseAccount
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # The menu the bundle draws as a combobox: Bootstrap's toggle and a searchable menu built
+    # from a select it then hides, which stays the one thing the form submits.
+    module Comboboxes
+      # The words the menu is read by, which belong to the house rather than to a page.
+      WORDS = %i[all clear more no_results search].freeze
+
+      # `method` as a combobox over `choices` -- the select `form.select` would draw, carrying
+      # what the bundle needs to draw it as one instead. Every argument is that select's, and
+      # its own `:prompt` is what the toggle says before anything is picked. The words it is
+      # searched, cleared and emptied by are the house's, in the reader's own language, and
+      # `data` given in `html_options` is kept over any of them.
+      def combobox(method, choices = nil, options = {}, html_options = {}, &)
+        data = { controller: 'combobox', combobox_placeholder_value: options[:prompt],
+                 **houseaccount_combobox_words, **html_options.fetch(:data, {}), }
+
+        select method, choices, options, html_options.merge(data: data), &
+      end
+
+    private
+
+      # `all` and `more` are Stimulus values the menu reads; the rest are plain attributes.
+      # `more` is a template the bundle fills, so it is asked for with its own placeholders as
+      # their values -- I18n would otherwise raise on the two it cannot fill.
+      def houseaccount_combobox_words
+        WORDS.to_h do |word|
+          # rubocop:disable-next Style/FormatStringToken -- the bundle fills these, not Ruby
+          said = @template.t "houseaccount.#{word}", first: '%{first}', count: '%{count}'
+
+          [%i[all more].include?(word) ? :"combobox_#{word}_value" : word, said]
+        end
+      end
+    end
+  end
+end

data/lib/houseaccount/form_builder/controls.rb

@@ -0,0 +1,67 @@
+require 'action_view'
+
+module HouseAccount
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # Every other kind of field, at the one size the house draws them: a page says which kind
+    # 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'
+
+      # An email address.
+      def email_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A number, which brings the keyboard for one.
+      def number_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A password, which no name of a column earns on its own.
+      def password_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A term to search by.
+      def search_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A web address.
+      def url_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A day.
+      def date_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A time of day.
+      def time_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # A day and a time together.
+      def datetime_field(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # More than a line of words.
+      def text_area(method, options = {}) = super(method, with_classes(options, CONTROL))
+
+      # 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), &)
+      end
+
+      # One of several, ticked.
+      def check_box(method, options = {}, checked = '1', unchecked = '0')
+        super(method, with_classes(options, CHECK), checked, unchecked)
+      end
+
+      # One of several, and only one.
+      def radio_button(method, value, options = {})
+        super(method, value, with_classes(options, CHECK))
+      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'
+        inside = @template.safe_join [check_box(method, options), words]
+
+        @template.tag.div inside, class: 'form-check'
+      end
+    end
+  end
+end

data/lib/houseaccount/form_builder.rb

@@ -1,4 +1,6 @@
 require 'action_view'
+require_relative 'form_builder/comboboxes'
+require_relative 'form_builder/controls'
 require_relative 'form_builder/pins'
 
 module HouseAccount
@@ -7,7 +9,7 @@ module HouseAccount
   # `default_form_builder`. What a view passes is kept: its classes join the house's, its
   # `data` is merged key by key with the house's, and any other option of its overrides.
   class FormBuilder < ActionView::Helpers::FormBuilder
-    include Pins
+    include Comboboxes, Controls, Pins
 
     # What a field wears: Bootstrap's control, at the size a thumb finds.
     CONTROL = 'form-control form-control-lg'
@@ -25,21 +27,31 @@ module HouseAccount
       data: { controller: 'phone', action: 'keydown->phone#down input->phone#input' },
     }.freeze
 
-    # The fieldset a form's controls sit in: a grid one column wide, so each takes the whole
-    # row, with `legend` over them as a `form-label` where one is given. Every option is the
-    # fieldset's.
+    # The fieldset a form's controls sit in: a grid, with `legend` over them where one is
+    # given, wearing nothing of ours. It carries
+    # its own spacing, twice as much under it as over, so one group reads as belonging to the
+    # words above it rather than sitting evenly between two. Every option is the fieldset's.
     def fieldset(legend = nil, **options, &)
-      heading = (@template.tag.legend legend, class: 'form-label' if legend)
+      heading = (@template.tag.legend legend if legend)
       inside = @template.safe_join [heading, @template.capture(&)].compact
 
-      @template.tag.fieldset inside, **with_classes(options, 'd-grid')
+      @template.tag.fieldset inside, **with_classes(options, 'd-grid form-fieldset')
     end
 
-    # A label is Bootstrap's `form-label`, whatever else it is given.
-    def label(method, text = nil, options = {}, &)
-      return label(method, nil, text, &) if text.is_a? Hash
+    # A label is Bootstrap's `form-label`, whatever else it is given -- and given both words
+    # and a block, the control the words name as well, which Rails' own label has no meaning
+    # for: it drops the words and renders the block. Wrapped, the pair is one element, so a
+    # form laid out in columns has a cell to place and neither an id nor a stylesheet counting
+    # children has to bind them -- which a control drawing markup of its own, a combobox say,
+    # would break on connect.
+    def label(method, text = nil, options = {}, &block)
+      return label(method, nil, text, &block) if text.is_a? Hash
+      return super(method, text, with_classes(options, 'form-label'), &block) unless text && block
 
-      super(method, text, with_classes(options, 'form-label'), &)
+      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, 'form-field')
     end
 
     # A text field is a large control.

data/lib/houseaccount/version.rb

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