houseaccount 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e940a284d7295b6c3945f86e2d5d99cff64c0f6474b9bdda190c41d782ac95c3
-  data.tar.gz: 826e327eca8b704721e5e3e887d947d3ad714b9130bf006fd80b5a2dae803e5a
+  metadata.gz: 4ff5237b22740dc32c8e7c3bb833aa6ca51e3557e103eb0b628653658564d2fa
+  data.tar.gz: 9ecc04823998049cd0c4e60a2e8c402250e1b651c04cfb4df14385444758478d
 SHA512:
-  metadata.gz: 58a97334a737b8af5edaef43bbe3e68d5f9dd8cfdba7e72f65356fb48d54ba5a65f68126a04929048601e2718927cc0e65f88dd1842024fb9a57fd9780532428
-  data.tar.gz: 548b7f79b7c64e5dcd1cc69117d7670246b9f8ece10197f0d2fcc1e11d09c7d41cef92b3145c59a6c84b890371fc152dda9736da187818a0152bb058c819dfe4
+  metadata.gz: ccec1d767a683d8df0be2c1c86ea8f720d608e52ba897531ffcf5192195c9dd4be8aeab7e834b5cdc12346b5aaf31fadd2881fcca0715200b5c751b1c300da27
+  data.tar.gz: 1fa4898055b78bf0dbfb4d7a54ade28eaee556836c1f583fafc7b44e51543d9e5a1de6c230cdd7bbffb3ccbd9652ea7a2a54ff73844a229d88be58507e620e80

data/CHANGELOG.md

@@ -7,6 +7,16 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 0.7.0 - 2026-09-14
+
+## 0.6.0 - 2026-09-14
+
+* [Breaking change] `HouseAccount.one_time_code` answers the words in both voices
+
+  It gave back the text a code is sent in; it gives back a `HouseAccount::Copy` now, whose
+  `written` is that same text and whose `spoken` is the sentence alone with the digits one at
+  a time, for an app reading a code out over a call. Every caller gains `.written`.
+
 ## 0.5.0 - 2026-09-14
 
 * [Feature] The `map` controller draws a page's rows on a Google map

data/README.md

@@ -20,10 +20,10 @@ gem install houseaccount
 
 ```ruby
 # Gemfile
-gem 'houseaccount', '~> 0.5.0'
+gem 'houseaccount', '~> 0.7.0'
 ```
 
-`~> 0.5.0` stops short of `0.6`, since below 1.0 a minor release may break whatever it likes.
+`~> 0.7.0` stops short of `0.8`, since below 1.0 a minor release may break whatever it likes.
 Rails 8.1 and Ruby 3.2 are the minimum.
 
 A page takes the gem's layout, and wears the same head:
@@ -60,7 +60,7 @@ which Pages redirects away from.
 
 With the gem in the bundle an app serves `/css/houseaccount.css`, `/js/houseaccount.js`,
 `/theme/*`, `/font/*`, `/logo/*` and `/favicon/*` itself — and its own version's copy under
-`/v0.5.0/`, which is what the head helper links, cached for a year — answers a 400, 404, 406, 422 or 500
+`/v0.7.0/`, which is what the head helper links, cached for a year — answers a 400, 404, 406, 422 or 500
 with the house's own page, and has these helpers in every view:
 
 ```erb
@@ -140,6 +140,8 @@ nests on the gem's layout, giving the page as `content_for :content` and renderi
 as a template:
 
 ```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 %>
     <%= yield %>
@@ -149,6 +151,9 @@ as a template:
 <%= render template: 'layouts/houseaccount' %>
 ```
 
+`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.
+
 The words are the view's, said in `content_for`: `:title` is the `h1`, `:subtitle` the line
 under it, drawn only where there is one, and `:width` how wide the card is, a CSS length that
 is `30rem` unless said — a chat's page says `75rem`. What the layout knows goes in the call:
@@ -175,14 +180,18 @@ HouseAccount::Message.new side: :left, text: answer.note, sender: 'Claude', at:
                           cost: Chat.spent_on(answer.input_usage, answer.output_usage)
 ```
 
-A code texted to a phone is the same words from every app, `HouseAccount.one_time_code`:
-the sentence a person reads, and under it the `@host #code` line that offers the code above
-the keyboard on the phone it arrived on. The host is the application's default one unless
-`host:` says otherwise, and the copy is the gem's `config/locales` entry.
+A code sent to a phone is the same words from every app, `HouseAccount.one_time_code`, in
+each voice they are said in. `written` is the sentence a person reads and, under it, the
+`@host #code` line that offers the code above the keyboard on the phone it arrived on;
+`spoken` is the sentence alone, its digits one at a time so a listener can write them down.
+The host is the application's default one unless `host:` says otherwise, and the words are
+the gem's `config/locales` entry.
 
 ```ruby
-HouseAccount.one_time_code contact.pin
+HouseAccount.one_time_code(contact.pin).written
 # => "Enter this 6-digit code to proceed: 482913\n\n@houseaccount.com #482913"
+HouseAccount.one_time_code(contact.pin).spoken
+# => "Enter this 6-digit code to proceed: 4, 8, 2, 9, 1, 3"
 ```
 
 A page not on the gem links the two files from the site, and nothing else:
@@ -196,8 +205,8 @@ Those follow the latest release. Every release is also kept whole under its own
 forever and cached for a year, for a page that would rather move on its own terms:
 
 ```html
-<link rel='stylesheet' href='https://design.houseaccount.com/v0.5.0/css/houseaccount.css'>
-<script type='module' src='https://design.houseaccount.com/v0.5.0/js/houseaccount.js'></script>
+<link rel='stylesheet' href='https://design.houseaccount.com/v0.7.0/css/houseaccount.css'>
+<script type='module' src='https://design.houseaccount.com/v0.7.0/js/houseaccount.js'></script>
 ```
 
 A host with a Content Security Policy allows that origin for `style-src`, `script-src` and

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

@@ -10,7 +10,7 @@
     <%- if (csp = csp_meta_tag) -%>
     <%= csp %>
     <%- end -%>
-    <%= houseaccount_head_tags %>
+    <%= houseaccount_head_tags content_for(:logo).presence || HouseAccount.app %>
     <%- if content_for?(:head) -%>
     <%= yield :head %>
     <%- end -%>

data/config/locales/houseaccount.en.yml

@@ -9,4 +9,5 @@ en:
 
       @%{host} #%{pin}
     send: Send
+    spoken_one_time_code: 'Enter this 6-digit code to proceed: %{pin}'
     typing: Typing

data/lib/houseaccount/copy.rb

@@ -0,0 +1,5 @@
+module HouseAccount
+  # Words the house says the same way in every app, in each of the voices they are said in:
+  # `written` for a screen or a text, `spoken` for a voice reading them out.
+  Copy = Data.define :written, :spoken
+end

data/lib/houseaccount/helpers/heads.rb

@@ -6,11 +6,12 @@ module HouseAccount
       # by two: `<html>`, then `<head>`, then these.
       INDENT = "\n    "
 
-      # The stylesheet and the script every page needs, and the icons this app is known
-      # by. Both files at this version's own path, which never changes and so is kept for
-      # a year. A page refresh Turbo is sent morphs the page in place and keeps the scroll,
-      # so an answer landing in a thread leaves the reader where they were.
-      def houseaccount_head_tags
+      # The stylesheet and the script every page needs, and the icons `app` is known by —
+      # this app unless said, since a page a customer reads may wear the house's mark rather
+      # than the app's. Both files at this version's own path, which never changes and so is
+      # kept for a year. A page refresh Turbo is sent morphs the page in place and keeps the
+      # scroll, so an answer landing in a thread leaves the reader where they were.
+      def houseaccount_head_tags(app = HouseAccount.app)
         safe_join [
           tag.meta(name: 'viewport', content: 'width=device-width, initial-scale=1'),
           tag.meta(name: 'color-scheme', content: 'light dark'),
@@ -18,7 +19,7 @@ module HouseAccount
           tag.meta(name: 'turbo-refresh-scroll', content: 'preserve'),
           tag.link(rel: 'stylesheet', href: "/v#{VERSION}/css/houseaccount.css"),
           tag.script('', type: 'module', src: "/v#{VERSION}/js/houseaccount.js"),
-          houseaccount_icons,
+          houseaccount_icons(app),
         ], INDENT
       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.5.0'
+  VERSION = '0.7.0'
 end

data/lib/houseaccount.rb

@@ -1,5 +1,6 @@
 require_relative 'houseaccount/version'
 require_relative 'houseaccount/marks'
+require_relative 'houseaccount/copy'
 require_relative 'houseaccount/message'
 require_relative 'houseaccount/down'
 require_relative 'houseaccount/helpers'
@@ -28,11 +29,14 @@ module HouseAccount
     MARKS.key?(name) ? name : :houseaccount
   end
 
-  # The text that carries a 6-digit code to a phone: the sentence a person reads, and under
-  # it the line Safari matches against the page about to be filled, `@host #code`, which is
-  # what offers the code above the keyboard so nobody leaves for Messages to copy it. Every
-  # app of the house that texts a code sends this one, from `config/locales`.
+  # The words that carry a 6-digit code to a phone, in both voices. `written` is the sentence
+  # a person reads and, under it, the line Safari matches against the page about to be filled,
+  # `@host #code`, which offers the code above the keyboard so nobody leaves for Messages to
+  # copy it. `spoken` is the sentence alone, its digits one at a time so a listener can write
+  # them down, and without a line meant for a phone rather than a person. Every app of the
+  # house that sends a code sends these, from `config/locales`.
   def self.one_time_code(pin, host: Rails.application.default_url_options[:host])
-    I18n.t 'houseaccount.one_time_code', pin:, host:
+    Copy.new written: I18n.t('houseaccount.one_time_code', pin:, host:),
+             spoken: I18n.t('houseaccount.spoken_one_time_code', pin: pin.chars.join(', '))
   end
 end

data/public/index.html

@@ -66,8 +66,8 @@
           </div>
           <div class='col-12'>
             <div class='card p-3'>
-              <strong>Pinned to a version — the latest is 0.5.0</strong>
-              <span class='design-url'>https://design.houseaccount.com/v0.5.0/css/houseaccount.css · /v0.5.0/js/houseaccount.js · /v0.5.0/theme/nord.css</span>
+              <strong>Pinned to a version — the latest is 0.7.0</strong>
+              <span class='design-url'>https://design.houseaccount.com/v0.7.0/css/houseaccount.css · /v0.7.0/js/houseaccount.js · /v0.7.0/theme/nord.css</span>
               <span class='small fg-2 mt-1'>Every release stays at its own prefix forever, whole and cached for a year, for a page that moves on its own terms. The unversioned paths follow the latest.</span>
             </div>
           </div>