bh 6.3.0 → 6.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e8820e04b1b71fbfacf44696b6fec712f77987c217dbedf5c2314867600bf42
-  data.tar.gz: 761251633d36f3e62dd92d9784c71d44a2306bc6c3358d24b3420f3347cebff6
+  metadata.gz: e56ebe3dc708d2c24faa0ce9419a73432bf56a2a89e30c4e43238c17a3212bfc
+  data.tar.gz: 787d7c455cded498c4e53ce624eca61981f7cc9a0522d9f743cf748bc95c09b6
 SHA512:
-  metadata.gz: 84be37f63354fe89c52d6532cb55a5c2db53127a568c228d58acc53d7d3a0ff3cbb98cad224b7bdd76138a3a02ffcf2b3a338cacda2ec0f12427e26fd10db361
-  data.tar.gz: bd2d39d1d0377f5e5730f90ad6400edf736b1cc281b63e2a491c8c6cf7bf922e3822a6f1525e5f7ae775f3ff48de3f089f2c526d9a09b992f6c53a875b9d9eb7
+  metadata.gz: 84fb271ca162d32df5eb64e4aeb9bff20752391e4c107a51259bcc9995431d5f6c4d0ff0160dfdc4da8deb080aed74197b0c3930f38e08ef2ccdb3984ff877d1
+  data.tar.gz: b7601d8739cdb4e21cb98d52aad08681a95f2366e19e7196028bfa8a9e30c47812826dee5a5a405f6862475474c8dd7f087f0a887051d9f0526d8acdf5ad6603

data/CHANGELOG.md

@@ -8,6 +8,23 @@ For more information about changelogs, check
 
 ## [Unreleased]
 
+## 6.4.0 - 2026-09-18
+
+* [FEATURE] A message carries its `photos`, drawn in the bubble under its words
+
+  `Bh::Message` takes a list of addresses beside its text. Each is drawn under the words in
+  the same bubble, linking to itself in a tab of its own: what fits beside words is rarely
+  what somebody wants to look at. A message carrying pictures and no words is a message all
+  the same, rather than one still being typed.
+
+* [FEATURE] `chat_with` takes a `note:`, said over the thread rather than in it
+
+  What the conversation is about, or the other way to reach whoever is on the far end of it.
+  Over rather than in, because nobody in the conversation said it and a bubble would claim
+  somebody had. It holds the top while the thread scrolls under it, and carries the page's
+  own background for that reason: a tint would read as somebody's turn, and without one the
+  bubbles would show through.
+
 ## 6.3.0 - 2026-09-18
 
 * [FEATURE] The nine palettes, served at `/bh/theme/<name>.css`

data/app/stylesheets/bh/chat.css

@@ -7,6 +7,33 @@
    overflows pushes its first message clean out of the top with no way to scroll back. */
 .chat > :first-child { margin-block-start: auto }
 
+/* What the whole thread is about, or the other way to reach whoever is on the far end of
+   it: said over the conversation rather than in it, quiet and in the page's own words,
+   because nobody in the conversation said it. It holds the top while the thread scrolls
+   under it, which is why it carries the page's background and not a band of its own: a
+   tint here would read as somebody's turn, and bubbles would show through without one. */
+.chat-note {
+  position: sticky;
+  inset-block-start: 0;
+  z-index: 1;
+  background-color: var(--bs-body-bg);
+  font-size: var(--bs-font-size-sm);
+  color: var(--bs-fg-2);
+  margin: 0;
+  padding-block: 0.25rem 0.75rem;
+}
+
+/* A picture a message carries, under its words and no wider than the bubble holding it. */
+.chat-photo {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  border-radius: 0.5rem;
+  margin-block-start: 0.5rem;
+}
+/* The first thing in a bubble has the bubble's own padding over it already. */
+.chat-bubble > a:first-child .chat-photo { margin-block-start: 0 }
+
 /* Who said it and when, small, over the bubble it belongs to and on its side. */
 .chat-aside { font-size: var(--bs-font-size-sm); color: var(--bs-fg-2); margin: 0 0.75rem }
 .chat-aside-out { align-self: flex-end; margin-inline-end: 1.25rem }

data/config/locales/bh.en.yml

@@ -8,6 +8,7 @@ en:
     more: '%{first} + %{count} more'
     no_results: Nothing matches that
     okay: Okay
+    photo: Photo
     search: Search
     send: Send
     typing: Typing

data/lib/bh/helpers/chats.rb

@@ -8,12 +8,16 @@ module Bh
       include Asides, Asks
 
       # `messages` as a thread that opens at its newest and, where `url` is given, a field
-      # under it that posts the next message there, suggesting `hints` one at a time.
-      def chat_with(messages:, url: nil, hints: [])
-        parts = [bh_chat_messages(messages)]
+      # under it that posts the next message there, suggesting `hints` one at a time. A
+      # `note` stands over the whole thread: what this conversation is about, or the other
+      # way to reach whoever is on the far end of it.
+      def chat_with(messages:, url: nil, hints: [], note: nil)
+        parts = [bh_chat_note(note), bh_chat_messages(messages)]
         parts.push bh_chat_ask(url, hints) if url
 
-        tag.div safe_join(parts, "\n"), class: 'chat-thread', data: { controller: 'thread' }
+        said = safe_join parts.compact, "\n"
+
+        tag.div said, class: 'chat-thread', data: { controller: 'thread' }
       end
 
     private
@@ -30,13 +34,36 @@ module Bh
         safe_join parts.compact, "\n"
       end
 
+      # Said over the thread rather than in it, so it is not one of the turns: nobody
+      # said this, and a bubble would claim somebody had.
+      def bh_chat_note(note)
+        tag.p note, class: 'chat-note' if note.present?
+      end
+
       def bh_chat_bubble(message)
         side = Asides::SIDES.fetch message.side
-        return tag.p message.text, class: "chat-bubble chat-#{side}" if message.text
+        said = bh_chat_said message
+        return tag.p said, class: "chat-bubble chat-#{side}" if said
 
         tag.p safe_join(Array.new(3) { tag.span }), class: "chat-bubble chat-#{side} chat-typing",
                                                     aria: { label: t('bh.typing') }
       end
+
+      # The words and then the pictures, which is the order a phone lays a picture
+      # message out in -- and nothing at all where a message has neither yet.
+      def bh_chat_said(message)
+        pictures = Array(message.photos).map { |photo| bh_chat_photo photo }
+
+        safe_join([message.text, *pictures].compact_blank, "\n").presence
+      end
+
+      # A picture in the bubble, opening full size in a tab of its own: what fits beside
+      # words is rarely what somebody wants to look at.
+      def bh_chat_photo(url)
+        tag.a href: url, target: :_blank, rel: 'noopener' do
+          tag.img src: url, alt: t('bh.photo'), class: 'chat-photo', loading: :lazy
+        end
+      end
     end
   end
 end

data/lib/bh/message.rb

@@ -1,11 +1,14 @@
 module Bh
   # One message of a chat, as `chat_with` draws it: which `side` its bubble is on (`:left`
-  # for the other party, `:right` for the reader), its `text`, who the `sender` was, when it
-  # was said (`at`), how its `delivery` went (`:delivered`, `:sent`, `:failed`,
-  # `:undelivered` or nil) and what it `cost` in dollars, where anything did. Any object
-  # answering the same six is a message too; this is for a host that has the facts and no
-  # model to hang them on. A message with no text yet is drawn as being typed.
-  Message = Data.define :side, :text, :sender, :at, :delivery, :cost do
-    def initialize(side:, text: nil, sender: nil, at: nil, delivery: nil, cost: nil) = super
+  # for the other party, `:right` for the reader), its `text`, the `photos` it carries as
+  # a list of addresses, who the `sender` was, when it was said (`at`), how its `delivery`
+  # went (`:delivered`, `:sent`, `:failed`, `:undelivered` or nil) and what it `cost` in
+  # dollars, where anything did. Any object answering the same seven is a message too;
+  # this is for a host that has the facts and no model to hang them on. A message with
+  # neither words nor pictures yet is drawn as being typed.
+  Message = Data.define :side, :text, :photos, :sender, :at, :delivery, :cost do
+    def initialize(side:, text: nil, photos: [], sender: nil, at: nil, delivery: nil, cost: nil)
+      super
+    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.3.0'
+  VERSION = '6.4.0'
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bh6",
-  "version": "6.3.0",
+  "version": "6.4.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",