houseaccount 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e940a284d7295b6c3945f86e2d5d99cff64c0f6474b9bdda190c41d782ac95c3
-  data.tar.gz: 826e327eca8b704721e5e3e887d947d3ad714b9130bf006fd80b5a2dae803e5a
+  metadata.gz: aa18dd4454ada3709be81ff0ff416708064b02c2a988c37a55152099371e2179
+  data.tar.gz: b79f81239be25fb692c7e7fc60e1821014b61929cddc4740d29ea5d43fa15288
 SHA512:
-  metadata.gz: 58a97334a737b8af5edaef43bbe3e68d5f9dd8cfdba7e72f65356fb48d54ba5a65f68126a04929048601e2718927cc0e65f88dd1842024fb9a57fd9780532428
-  data.tar.gz: 548b7f79b7c64e5dcd1cc69117d7670246b9f8ece10197f0d2fcc1e11d09c7d41cef92b3145c59a6c84b890371fc152dda9736da187818a0152bb058c819dfe4
+  metadata.gz: bcecfd9589223bd8eb27679668b6fb441cf9d66ae8cc82cc67e19b7df8a464fef9dfdfa3b0044c344289156e8f9342a33d548bffe4bdf737ff26724f48e56f5e
+  data.tar.gz: 7d2e72f1c2873f6a70482377f3792711a4f4940c40a7859495f0665059c9f05939e60ea46eeebbd12a3c62701dea43d10db58dfc63efa38fee8c61829ec17151

data/CHANGELOG.md

@@ -7,6 +7,14 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 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.6.0'
 ```
 
-`~> 0.5.0` stops short of `0.6`, since below 1.0 a minor release may break whatever it likes.
+`~> 0.6.0` stops short of `0.7`, 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.6.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
@@ -175,14 +175,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 +200,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.6.0/css/houseaccount.css'>
+<script type='module' src='https://design.houseaccount.com/v0.6.0/js/houseaccount.js'></script>
 ```
 
 A host with a Content Security Policy allows that origin for `style-src`, `script-src` and

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/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.6.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.6.0</strong>
+              <span class='design-url'>https://design.houseaccount.com/v0.6.0/css/houseaccount.css · /v0.6.0/js/houseaccount.js · /v0.6.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>