houseaccount 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c38f00185e5c9252a22102deb4364544009684dd39e164adaa755b5cf8dc33f
-  data.tar.gz: 64f4791d9875ad24848a60e81ead1e519e477022c5ad1a0a2a41a74460632b6a
+  metadata.gz: 4a93e46d0497ab00af3030de2f6931f575a54c4ee39db2258f3ebb4bf2585bb5
+  data.tar.gz: 44d72378f63ef8ec113502c77f5917ca8bc443e7a1fa23bc2b40634601bbc3d0
 SHA512:
-  metadata.gz: 49eac16043f37eed2ffa4e6dd8ec9d1deaff77638c77c4015a836d825adb70998d78bdaf2a9907bca251db6b5b9394e0b640b2da22eae449263ec52173a27cc0
-  data.tar.gz: b96627a40bb6764b183fca3a2fc46c17bf1991683d11975165a89d78bc6a1ceaf43f13f34792c119d3ac5aee9efbd6142c3fe16e9e1979f67fb571fbf88d2383
+  metadata.gz: 56f76b166bc81a0c3ec9e880dbf4b5fb7696fdc52eb9a8e676f4c02cb8c8c8ef05c6707f19f33a5b75bb1618d4dd29effef82b80665cad7834fbbd2906a224de
+  data.tar.gz: c4b9414f1d9479059eca88dae57eacff79b7a51c6027b5eb8f35338e1f82061ca4722fd727828a91693bd15c91c10aef2b754fab210829aff2e88eaf96d7c841

data/CHANGELOG.md

@@ -7,6 +7,42 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 0.19.0 - 2026-09-19
+
+* [FEATURE] The head of an admin screen is drawn here
+
+  recourse draws a `recourses/head` partial where a view path supplies one, and this gem
+  supplies it: the house's two files and the icons a tab wears. An app on both gems keeps
+  no partial of its own, and one wanting something else writes its own, which is found
+  first.
+
+## 0.18.0 - 2026-09-19
+
+* [BREAKING] The bundle is the house's layer alone
+
+  It carried bh's stylesheet and script inside it, so a page linking this one got Bootstrap
+  and the house together in 378K. It carries neither now: a page links bh's files first and
+  this one's after, which is what `houseaccount_layer` draws, and the house stylesheet is
+  12K. `houseaccount_tags` draws the house's two alone, for a page that already has bh's.
+
+* [BREAKING] `flow` is this gem's own
+
+  It wrapped bh's with `super`, which took an `include` ordering between two engines to
+  make work. bh no longer draws a signup page at all, so this one draws the whole of it.
+  `footer:` is `links:`, and `header:` is gone -- the lockup and the wall are what a house
+  flow is rather than options a caller passes. `logo:` is `href:`.
+
+* [BREAKING] `houseaccount_url` goes, with `HouseAccount.url` and `HouseAccount::URL`
+
+  Nothing called it. The static pages name the design site outright.
+
+* [BREAKING] The `recourses/head` partial goes
+
+  It was this gem reaching toward another by the name of its partial. An app that wants the
+  house layer on the pages recourse draws writes those two lines itself, which is one file
+  in the app that already knows about both.
+
+
 ## 0.17.0 - 2026-09-18
 
 * [FEATURE] bh 6.6, which draws a picture in a bubble as a thumbnail

data/README.md

@@ -5,10 +5,12 @@ sit in, the wall a signup flow stands on, the palettes, the pages an app shows w
 or lost, and the one stylesheet and one script that carry all of it.
 
 The Bootstrap 6 underneath is [`bh`](https://claudiob.github.io/bh/), which this gem depends on
-and bundles. **The components are documented there, not here** — the form builder, the combobox,
-the 6-digit code, the phone field, the dialog, the toasts, the thread of messages and the
-twenty-two Stimulus controllers are Bootstrap with the markup written once, and are worth the
-same to any Rails app. This gem is only what is the house's.
+and draws on top of rather than bundling: a page links bh's stylesheet and script first and this
+one's after, so the house rules win and Bootstrap ships once. **The components are documented
+there, not here** — the form builder, the combobox, the 6-digit code, the phone field, the
+dialog, the toasts, the thread of messages and the twenty-two Stimulus controllers are Bootstrap
+with the markup written once, and are worth the same to any Rails app. This gem is only what is
+the house's.
 
 Published three ways from this repo:
 
@@ -130,14 +132,14 @@ view paths.
 
 ## The flow, and the wall it stands on
 
-`flow` is bh's page-of-a-signup-flow with the house's two things added: the lockup in its header
-and the cyanotype behind the card. A layout of the app's own calls it and nests on the gem's:
+`flow` is the page a signup flow lives on: the lockup over the cyanotype, a title, a line, one
+card, and the way out under it. A layout of the app's own calls it and nests on the gem's:
 
 ```erb
 <% content_for :logo, 'houseaccount' %>
 
 <% content_for :content do %>
-  <%= flow logo: root_path, footer: [button_to('Sign out', session_path, method: :delete, class: 'btn btn-link')] do %>
+  <%= flow href: root_path, links: [button_to('Sign out', session_path, method: :delete, class: 'btn btn-link')] do %>
     <%= yield %>
   <% end %>
 <% end %>
@@ -145,11 +147,11 @@ and the cyanotype behind the card. A layout of the app's own calls it and nests
 <%= render template: 'layouts/houseaccount' %>
 ```
 
-`logo:` is where the mark links, the house's front door unless said; `footer:` the pieces of the
-foot, joined by a middot, none drawing no foot. Everything else — `:title`, `:subtitle`,
-`:width`, how the card lays its fields out — is bh's, and is
-[documented there](https://claudiob.github.io/bh/). `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.
+`href:` is where the mark links, the house's front door unless said; `links:` the pieces of the
+foot, joined by a middot, none drawing no foot. The mark and the wall are not asked for, being
+what a house flow is. What the page says about itself — `content_for :title`, `:subtitle` and
+`:width` — it says in its own view, and `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.
 
 The wall alone is one attribute, `data-controller='wall'`, on any element that should stand on
 it: fourteen trade tools and the family's five marks drifting up in seven columns, on blueprint

data/app/views/layouts/houseaccount.html.erb

@@ -19,6 +19,6 @@
     <main class='container-fluid py-4 flex-grow-1 d-flex flex-column'>
       <%= content_for?(:content) ? yield(:content) : yield %>
     </main>
-    <%= notices %>
+    <%= toasts %>
   </body>
 </html>

data/app/views/recourses/_head.html.erb

@@ -1 +1,3 @@
+<%= houseaccount_tags %>
+
 <%= houseaccount_icons %>

data/art/index.html.erb

@@ -14,8 +14,10 @@
          pins a host to, so the page is drawn by the bytes it hands out rather than by
          whatever was last built. Relative, so it reads the same on staging, on production
          and from a folder on disk. -->
+    <link rel='stylesheet' href='v<%= version %>/bh/css/bh.css'>
     <link rel='stylesheet' href='v<%= version %>/css/houseaccount.css'>
-    <link rel='stylesheet' href='v<%= version %>/theme/bootstrap.css' data-recourse-theme=''>
+    <link rel='stylesheet' href='v<%= version %>/bh/theme/bootstrap.css' data-recourse-theme=''>
+    <script type='module' src='v<%= version %>/bh/js/bh.js'></script>
     <script type='module' src='v<%= version %>/js/houseaccount.js'></script>
     <style>
       /* The page's own chrome and nothing else: everything shown below is styled by
@@ -58,7 +60,7 @@
           <div class='col-12'>
             <div class='card p-3'>
               <strong>Pinned to a version — the latest is <%= version %></strong>
-              <span class='design-url'><a href='v<%= version %>/css/houseaccount.css'>v<%= version %>/css/houseaccount.css</a> · <a href='v<%= version %>/js/houseaccount.js'>v<%= version %>/js/houseaccount.js</a> · <a href='v<%= version %>/theme/nord.css'>v<%= version %>/theme/nord.css</a></span>
+              <span class='design-url'><a href='v<%= version %>/css/houseaccount.css'>v<%= version %>/css/houseaccount.css</a> · <a href='v<%= version %>/js/houseaccount.js'>v<%= version %>/js/houseaccount.js</a> · <a href='v<%= version %>/bh/theme/nord.css'>v<%= version %>/bh/theme/nord.css</a></span>
             </div>
           </div>
         </div>
@@ -68,7 +70,7 @@
         <h2>Themes</h2>
         <button type='button' class='btn btn-outline theme-primary' data-controller='scheme' data-action='scheme#rotate'
                 data-scheme-themes-value='["bootstrap","dawn","dracula","gruvbox","monokai","nord","one_dark","solarized","tokyo_night"]'
-                data-scheme-path-value='v<%= version %>/theme' data-scheme-storage-value='recourse-scheme'>
+                data-scheme-path-value='v<%= version %>/bh/theme' data-scheme-storage-value='recourse-scheme'>
           <span class='recourse-scheme-light'><i class='bi bi-moon-fill'></i> Switch to dark</span>
           <span class='recourse-scheme-dark'><i class='bi bi-sun-fill'></i> Switch to light</span>
         </button>

data/lib/houseaccount/helpers/flows.rb

@@ -1,13 +1,52 @@
 module HouseAccount
   module Helpers
-    # The page of a signup flow as the house draws it: bh's column, with the lockup over it
-    # and the cyanotype under it.
+    # The page of a signup flow: the house's mark over the wall it stands on, a title, a line,
+    # one card, and the way out under it.
     module Flows
-      # bh's flow with the house's mark in its header, linking to `logo`, and the wall the
-      # `wall` controller paints behind the card. Every other option is bh's, and overrides:
-      # a page standing on something else of its own names the controller for it.
-      def flow(logo: Logos::HOME, **, &)
-        super(header: houseaccount_logo(href: logo), data: { controller: 'wall' }, **, &)
+      # How wide the card is unless a page says otherwise: as wide as a thread, a table or a
+      # contract wants. A page asking one question says a narrower one.
+      WIDTH = '75rem'
+
+      # Draws the page around the card's content: the lockup over what the view said in
+      # `content_for` — its `:title`, its `:subtitle`, how wide the card is in `:width` — and
+      # the `links` under the card joined by a middot. No subtitle draws no line and no links
+      # no foot: a page says only what it has. The mark and the wall are not asked for, being
+      # what a house flow is; every other option is an attribute of the column.
+      # @param href [String] where the lockup over the page leads.
+      # @param links [Array<String>] the way out, and whatever else stands beside it.
+      # @param options [Hash] anything else the column carries.
+      # @return [String] the page.
+      def flow(href: Logos::HOME, links: [], **options, &)
+        parts = [
+          tag.header(houseaccount_logo(href: href)),
+          *houseaccount_flow_words,
+          houseaccount_flow_card(content_for(:width), &),
+          houseaccount_flow_links(links),
+        ]
+        classes = class_names 'flow', options[:class]
+
+        tag.div safe_join(parts.compact), class: classes, data: { controller: 'wall' },
+                                          **options.except(:class)
+      end
+
+    private
+
+      def houseaccount_flow_words
+        [tag.h1(content_for(:title)), (tag.p content_for :subtitle if content_for? :subtitle)]
+      end
+
+      def houseaccount_flow_card(width, &)
+        width = width.presence || WIDTH
+        style = "--flow-width: #{width}" unless width == WIDTH
+
+        tag.div capture(&), class: 'flow-card p-3 md:p-4 mx-auto', style:
+      end
+
+      def houseaccount_flow_links(pieces)
+        pieces = Array(pieces).compact_blank
+        return if pieces.empty?
+
+        tag.footer safe_join(pieces, tag.span('·', class: 'fg-2', aria: { hidden: true }))
       end
     end
   end

data/lib/houseaccount/helpers/heads.rb

@@ -17,15 +17,34 @@ module HouseAccount
           tag.meta(name: 'color-scheme', content: 'light dark'),
           tag.meta(name: 'turbo-refresh-method', content: 'morph'),
           tag.meta(name: 'turbo-refresh-scroll', content: 'preserve'),
+          houseaccount_layer,
+          houseaccount_icons(app),
+        ], INDENT
+      end
+
+      # bh's layer and the house's on top of it, in that order: every rule and every
+      # controller here is written against what bh draws, so bh goes first. bh's files are
+      # served by its own engine, under a path of its own.
+      def houseaccount_layer
+        safe_join [
+          tag.link(rel: 'stylesheet', href: "#{Bh::Engine::PREFIX}css/bh.css"),
+          tag.script('', type: 'module', src: "#{Bh::Engine::PREFIX}js/bh.js"),
+          houseaccount_tags,
+        ], INDENT
+      end
+
+      # The house's own two files, for a page that already links bh's. At this version's own
+      # path, which never changes and so is kept for a year.
+      def houseaccount_tags
+        safe_join [
           tag.link(rel: 'stylesheet', href: "/v#{VERSION}/css/houseaccount.css"),
           tag.script('', type: 'module', src: "/v#{VERSION}/js/houseaccount.js"),
-          houseaccount_icons(app),
         ], INDENT
       end
 
       # The icons a tab, a home screen and a saved app know `app` by — this app unless said:
       # the SVG, its dev variant while developing, the 96px PNG, the apple touch icon and the
-      # web manifest, one to a line. Also what `recourses/head` draws for a host of recourse.
+      # web manifest, one to a line.
       def houseaccount_icons(app = HouseAccount.app)
         mark = Rails.env.development? ? "#{app}-dev" : app
 
@@ -36,9 +55,6 @@ module HouseAccount
           tag.link(rel: 'manifest', href: "/favicon/#{app}.webmanifest"),
         ], INDENT
       end
-
-      # An asset on the design site by its path, for a page this engine does not serve.
-      def houseaccount_url(path) = "#{HouseAccount.url}/#{path}"
     end
   end
 end

data/lib/houseaccount/helpers.rb

@@ -4,12 +4,8 @@ require_relative 'helpers/heads'
 require_relative 'helpers/logos'
 
 module HouseAccount
-  # Everything a view may call, in one module the engine puts on every Action View: the
-  # house's own, and bh's components under them. Not alphabetical, and bh's listed here at
-  # all rather than left to bh's engine, because both decide where the house's `flow` sits
-  # against the one it wraps: `include A, B` seats A ahead of B, and a module already in the
-  # chain is not moved by a second `include` — so this order wins whichever engine runs first.
+  # Everything a view may call, in one module the engine puts on every Action View.
   module Helpers
-    include Flows, Heads, Logos, Bh::Helpers
+    include Flows, Heads, Logos
   end
 end

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.17.0'
+  VERSION = '0.19.0'
 end

data/lib/houseaccount.rb

@@ -10,9 +10,6 @@ require_relative 'houseaccount/engine'
 # with the house's own layer over it — the marks every app is known by, and the helpers that
 # draw a head, a logo or a signup page the same way everywhere.
 module HouseAccount
-  # Where the same tree is published for a page this engine does not serve.
-  URL = 'https://design.houseaccount.com'
-
   # The form every HouseAccount page is written with, which is bh's: the house dresses no
   # field differently, so this name and `Bh::FormBuilder` are one builder.
   FormBuilder = Bh::FormBuilder
@@ -21,14 +18,6 @@ module HouseAccount
   # the house's name before the components moved.
   Message = Bh::Message
 
-  class << self
-    # The origin a remote link points at, `URL` unless a host says otherwise.
-    attr_writer :url
-  end
-
-  # The origin a remote link points at, `URL` unless a host says otherwise.
-  def self.url = @url || URL
-
   # Which of the family this host is, read off the Rails application's own name — the
   # `Goldrush` of `Goldrush::Application` — and the house itself for any app not in `MARKS`.
   # What a tab wears, what a logo says and whose page answers `/down.html`.