From 1fd5ae06eccc24575728346d0adffc9e3ad5ce1c Mon Sep 17 00:00:00 2001
From: Day Dreamer <87640074+HugoXK@users.noreply.github.com>
Date: Sun, 15 Nov 2026 11:08:27 +0800
Subject: [PATCH] fix(social): read the face card's accessible names in the
interface language
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
A past face-to-face card drew two accessible names as literals at the draw
site: `Open
` on the row button that opens the read-only room, and
`Members` on the stack of people on it. Both are text a screen reader hears,
never text the render parses back, and the dictionary already carries the two
keys `Open {title}` and `Members`, so a zh window read them in English for no
reason other than the literals.
Route both through `tr()`. Nothing else moves: the visible title, the stored
`room.name` and every rule that parses it stay exactly as they were, and an
English window keeps the same bytes (`Open Face-to-face · Alice · Oct 19
14:05`, `Members`). A test mounts the real client with the zh dictionary bound
and fails on the base source for both names, with the English control green on
both.
Docs-not-needed is not used: plugins/social/client.js is owned by the social
page, which gains the two accessible names and the new test file.
---
changelog.d/3100-social-aria-labels.fixed.md | 1 +
core/test/i18n-plugins.baseline.json | 1 -
docs/subsystems/social.md | 2 +-
.../files/test/i18n-plugins.baseline.json | 1 -
plugins/social/client.js | 6 +-
plugins/social/test/zh-face-aria.test.js | 135 ++++++++++++++++++
6 files changed, 141 insertions(+), 5 deletions(-)
create mode 100644 changelog.d/3100-social-aria-labels.fixed.md
create mode 100644 plugins/social/test/zh-face-aria.test.js
diff --git a/changelog.d/3100-social-aria-labels.fixed.md b/changelog.d/3100-social-aria-labels.fixed.md
new file mode 100644
index 000000000..c1ed6ab24
--- /dev/null
+++ b/changelog.d/3100-social-aria-labels.fixed.md
@@ -0,0 +1 @@
+The two accessible names on a past face-to-face room card now read in the window's language: a screen reader in a Chinese window says `打开 面对面 · Alice · 10月19日 14:05` for the row and `成员` for the people on it, instead of the English `Open …` and `Members`. Both words come from the dictionary, so an English window keeps exactly the names it had before; only the text read out changes, never the stored room name ([#3100](https://github.com/ThinkFlowLab/FlyBot/issues/3100)).
diff --git a/core/test/i18n-plugins.baseline.json b/core/test/i18n-plugins.baseline.json
index 719fb7fde..0fe2ab5b2 100644
--- a/core/test/i18n-plugins.baseline.json
+++ b/core/test/i18n-plugins.baseline.json
@@ -8,7 +8,6 @@
"plugins/social/client.js:Copy link",
"plugins/social/client.js:Dismiss#1",
"plugins/social/client.js:Dismiss#2",
- "plugins/social/client.js:Members",
"plugins/social/client.js:New link",
"plugins/social/client.js:Your Bot Social handle",
"plugins/social/client.js:Your Bots",
diff --git a/docs/subsystems/social.md b/docs/subsystems/social.md
index 6f73df1f7..77820c040 100644
--- a/docs/subsystems/social.md
+++ b/docs/subsystems/social.md
@@ -208,7 +208,7 @@ Settings → **Bot Social** lists friends and shares once the server is connecte
### Past rooms, unique titles, poll, and + (#129–#133)
- Expired matching (`candidate` whose `expiresAt` has passed) and a peer leaving the last remote seat move the hosted room to **Past rooms** on the next poll (`rememberPastFace`, status `closed` / `left`). The local room stays so **Open** still works; **Leave** is not shown on those cards. Face-room names are `Face-to-face · Alice, Bob · 482913` (people plus the 6-digit code, or `Oct 16 21:40` when there is no code) so two rooms with the same people stay distinct. The literal `Face-to-face room` is not a fallback. The number printed there and on the waiting card is the six digits only (#1005): `faceWaitCode` and `shownFaceTitle` refuse a stored value that is not exactly six digits (`1234567` never reads as `123456`) and fall back to the code the owner typed, or to the creation time.
-- Ended-room state and titles (#304): when every other home's Bots have left an open room, this home marks it **Closed** (it did not leave; `faceSnapshotPast` → `closed` with `peersGone`) and then leaves it on Bot Social itself (`leaveFaceRoom({ status: 'closed' })`), so it stops polling the room and the room-only identity is released (invariant 4). If that leave fails (timeout, 5xx), the next poll that still finds the room open on Bot Social tries it again. A room that drops off Bot Social's list without this home leaving is the same end (#1070): the hosted room is marked `closed` so the sidebar's active list drops it, and Past rooms keeps that one row (a `left` room stays Left). Its `endedAt` is the snapshot's `closed_at` when Bot Social sent one, so both homes show that time; otherwise the first time this home noticed. The owner who left keeps **Left**: `rememberPastFace` never turns a `left` row into `closed` when a later poll finds the room gone, and their room reads `You left this room.` while the others read ` left the room. Room closed.` That status line is the one leave signal when the room closes (#1103): the shorter ` left the room` is not also posted into the transcript. The number a room was joined by goes with every `upsertFace` (`joinCode`) and core keeps it on `room.face.joinCode`, so the title stays `Face-to-face · Alice, Bob · 482913` through polls, Leave and the end; Past rooms show that same title (people rebuilt from the row's members when it has them, the number or stored time kept; with neither, the creation time, never the joining deadline). A left or closed room's details are read-only: the status chip only, no Auto-send and no Leave. Past rows list everyone who was in the room (#304): `faceRoomTitle` takes the snapshot's members plus every participant the hosted room ever had (like the core title), and `viewHostedFace` for a closed or left room lists all participants, marking who had left `left: true` (Open on a dropped room seats only the others again); a row stored before this is refreshed from its hosted room. Each row shows its time (`data-flybot=face-time`): `endedAt`, set once by `rememberPastFace`, else the start (or creation) time; today reads `14:05`, an earlier day `Oct 19`, and the hover text has the full `Ended Oct 19 14:05`. That day, that hover word and the first word of the title rebuilt from the row's members follow the interface language (#3098): a zh window draws `10月19日` and `已结束 10月19日 14:05` / `开始 …` / `面对面 · Alice · 10月19日 14:05` while an English window keeps the bytes it drew before. Only what the owner reads moves — the stored `room.name` (still `Face-to-face · Alice · Oct 19 14:05`) and every rule that parses it (`startsWith('Face-to-face · ')`, the two fallback matches, the six-digit code) stay English, because the next render parses that string again; a stored auto name's own English stamp is rewritten for display only, never saved back. Tests: `plugins/social/test/zh-face-time.test.js` (four zh cases, two English byte controls). The fold remembers whether it is open across a reload (`localStorage` `flybot.social.pastRoomsOpen`). A read-only window (the shell names it in `roster.readOnly`) keeps every read and drops every write (#2219): the section still polls `social/status` and still lists share requests, accept notices and past rooms, but draws no Dismiss, no Ask them to share a Bot, no Leave and no decision on a held send, offers none of the three Bot Social rows in the sidebar `+` menu, and `social/face-open` returns the stored past view (`readOnly: true`, name, status, members) instead of `upsertFace`-ing a local mirror, so reopening a past room creates no room; the room view's own head row draws the same chip-only head as a past room, with no Leave, no Auto-send switch and no invite (#2228), while a waiting room keeps its wait code and roster and drops its Leave and Enter chat; a local Bot's **Sharing** card draws the window's reason, no invite maker and no **Share with a friend**, and keeps **People with access** readable — the list of who has this Bot, and each person's Auto-send as a state line rather than a switch, with no Revoke — because `social/access` is a read the host allows (#2219, #2446), while a local group's **Members** card keeps no read of its own and draws only the reason with no **Create link** (#2418); a writable window behaves exactly as before.
+- Ended-room state and titles (#304): when every other home's Bots have left an open room, this home marks it **Closed** (it did not leave; `faceSnapshotPast` → `closed` with `peersGone`) and then leaves it on Bot Social itself (`leaveFaceRoom({ status: 'closed' })`), so it stops polling the room and the room-only identity is released (invariant 4). If that leave fails (timeout, 5xx), the next poll that still finds the room open on Bot Social tries it again. A room that drops off Bot Social's list without this home leaving is the same end (#1070): the hosted room is marked `closed` so the sidebar's active list drops it, and Past rooms keeps that one row (a `left` room stays Left). Its `endedAt` is the snapshot's `closed_at` when Bot Social sent one, so both homes show that time; otherwise the first time this home noticed. The owner who left keeps **Left**: `rememberPastFace` never turns a `left` row into `closed` when a later poll finds the room gone, and their room reads `You left this room.` while the others read ` left the room. Room closed.` That status line is the one leave signal when the room closes (#1103): the shorter ` left the room` is not also posted into the transcript. The number a room was joined by goes with every `upsertFace` (`joinCode`) and core keeps it on `room.face.joinCode`, so the title stays `Face-to-face · Alice, Bob · 482913` through polls, Leave and the end; Past rooms show that same title (people rebuilt from the row's members when it has them, the number or stored time kept; with neither, the creation time, never the joining deadline). A left or closed room's details are read-only: the status chip only, no Auto-send and no Leave. Past rows list everyone who was in the room (#304): `faceRoomTitle` takes the snapshot's members plus every participant the hosted room ever had (like the core title), and `viewHostedFace` for a closed or left room lists all participants, marking who had left `left: true` (Open on a dropped room seats only the others again); a row stored before this is refreshed from its hosted room. Each row shows its time (`data-flybot=face-time`): `endedAt`, set once by `rememberPastFace`, else the start (or creation) time; today reads `14:05`, an earlier day `Oct 19`, and the hover text has the full `Ended Oct 19 14:05`. That day, that hover word and the first word of the title rebuilt from the row's members follow the interface language (#3098): a zh window draws `10月19日` and `已结束 10月19日 14:05` / `开始 …` / `面对面 · Alice · 10月19日 14:05` while an English window keeps the bytes it drew before. Only what the owner reads moves — the stored `room.name` (still `Face-to-face · Alice · Oct 19 14:05`) and every rule that parses it (`startsWith('Face-to-face · ')`, the two fallback matches, the six-digit code) stay English, because the next render parses that string again; a stored auto name's own English stamp is rewritten for display only, never saved back. Tests: `plugins/social/test/zh-face-time.test.js` (four zh cases, two English byte controls). The card's two accessible names follow the same rule (#3100): the past row's open button is `tr('Open {title}', …)` and the member stack is `tr('Members')`, so a zh window reads `打开 面对面 · Alice · 10月19日 14:05` and `成员` while an English window keeps `Open Face-to-face · Alice · Oct 19 14:05` and `Members`; both keys already existed in the dictionary (`Open {title}`, `Members`), so `core/src/client/i18n.js` does not change. Tests: `plugins/social/test/zh-face-aria.test.js`. The fold remembers whether it is open across a reload (`localStorage` `flybot.social.pastRoomsOpen`). A read-only window (the shell names it in `roster.readOnly`) keeps every read and drops every write (#2219): the section still polls `social/status` and still lists share requests, accept notices and past rooms, but draws no Dismiss, no Ask them to share a Bot, no Leave and no decision on a held send, offers none of the three Bot Social rows in the sidebar `+` menu, and `social/face-open` returns the stored past view (`readOnly: true`, name, status, members) instead of `upsertFace`-ing a local mirror, so reopening a past room creates no room; the room view's own head row draws the same chip-only head as a past room, with no Leave, no Auto-send switch and no invite (#2228), while a waiting room keeps its wait code and roster and drops its Leave and Enter chat; a local Bot's **Sharing** card draws the window's reason, no invite maker and no **Share with a friend**, and keeps **People with access** readable — the list of who has this Bot, and each person's Auto-send as a state line rather than a switch, with no Revoke — because `social/access` is a read the host allows (#2219, #2446), while a local group's **Members** card keeps no read of its own and draws only the reason with no **Create link** (#2418); a writable window behaves exactly as before.
- The face-to-face join field for the room number starts empty with a light `6 digits` hint (normal letter spacing, 13px), not a `000000` that looks pre-filled (#173). A number that is not empty and not exactly six digits keeps **Join** disabled and shows **Enter 6 digits** under the field (#1052). Six digits clear that line and enable Join once a Bot is picked; an empty field shows nothing.
- Round-3 polish (#173): **Accept invite** is no longer a separate **+** row; **Add friend** opens the single join panel for both a handle and an invite link or code. Escape closes the Add friend and Face-to-face panels, the `000000` code is a placeholder, Past rooms and friend rows use shorter copy, and Bot settings group invite and access under **Sharing** / **People with access**.
- **Open** on a Past room calls `social/face-open` (`plugins/social/src/social.js`): it returns the existing local hosted session or recreates one from the saved room, so a peer home can open a room that already left Bot Social (#171). Titles come from `plugins/social/src/face-title.js`, with participant owners in stable handle order, so both homes show the same name (#172).
diff --git a/patches/ds-bot/files/test/i18n-plugins.baseline.json b/patches/ds-bot/files/test/i18n-plugins.baseline.json
index 719fb7fde..0fe2ab5b2 100644
--- a/patches/ds-bot/files/test/i18n-plugins.baseline.json
+++ b/patches/ds-bot/files/test/i18n-plugins.baseline.json
@@ -8,7 +8,6 @@
"plugins/social/client.js:Copy link",
"plugins/social/client.js:Dismiss#1",
"plugins/social/client.js:Dismiss#2",
- "plugins/social/client.js:Members",
"plugins/social/client.js:New link",
"plugins/social/client.js:Your Bot Social handle",
"plugins/social/client.js:Your Bots",
diff --git a/plugins/social/client.js b/plugins/social/client.js
index b3a675d59..df78f7171 100644
--- a/plugins/social/client.js
+++ b/plugins/social/client.js
@@ -2086,7 +2086,9 @@ window.__ModuleLoader__.load({
'data-open': openable ? true : undefined,
onClick: openable ? () => (busy ? undefined : open()) : undefined,
...(rowOpens ? {
- role: 'button', tabIndex: 0, 'aria-label': `Open ${title}`, 'aria-busy': busy ? true : undefined,
+ // The two accessible names on this card are read out, never parsed back, so they take the
+ // dictionary like the visible copy does; the stored room name stays English (#3100).
+ role: 'button', tabIndex: 0, 'aria-label': tr('Open {title}', { title }), 'aria-busy': busy ? true : undefined,
onKeyDown: (event) => {
if (event.key !== 'Enter' && event.key !== ' ') return
event.preventDefault?.()
@@ -2094,7 +2096,7 @@ window.__ModuleLoader__.load({
},
} : {}),
},
- h('span', { className: 'fs-stack', 'aria-label': 'Members' },
+ h('span', { className: 'fs-stack', 'aria-label': tr('Members') },
shown.map(m => h('span', { key: m.handle || m.id, 'data-flybot': 'face-card-member', 'data-handle': m.handle },
h(FaceAvatar, { bot: look(m), size: 20 }))),
extra ? h('span', { className: 'fs-stack-more' }, `+${extra}`) : null),
diff --git a/plugins/social/test/zh-face-aria.test.js b/plugins/social/test/zh-face-aria.test.js
new file mode 100644
index 000000000..76edaaf38
--- /dev/null
+++ b/plugins/social/test/zh-face-aria.test.js
@@ -0,0 +1,135 @@
+// #3100: the two accessible names on a card read English in a zh window. The row's button
+// says `Open ` and the member stack says `Members`; both are drawn as literals at the draw
+// site, so the dictionary never reaches them even though it already carries `Open {title}` and
+// `Members`. This mounts the real client.js with the tiny hook renderer the other client tests use
+// (no jsdom), binds `__flybot__.t` to the zh dictionary, and reads the two `aria-label` values off
+// a Past card.
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { test } from 'node:test'
+import { DICTIONARY } from '../../../core/src/client/i18n.js'
+
+const zh = DICTIONARY.zh
+const live = { inst: null, idx: 0 }
+const reactStub = {
+ createElement: (type, props, ...children) => ({ type, props: props ?? {}, children: children.flat(Infinity) }),
+ Fragment: 'F',
+ Component: class {},
+ useState(init) {
+ const { inst } = live
+ const i = live.idx++
+ if (!(i in inst.hooks)) inst.hooks[i] = { value: typeof init === 'function' ? init() : init }
+ const slot = inst.hooks[i]
+ return [slot.value, (next) => { slot.value = typeof next === 'function' ? next(slot.value) : next; inst.dirty = true }]
+ },
+ useEffect(fn, deps) {
+ const { inst } = live
+ const i = live.idx++
+ if (!(i in inst.hooks)) inst.hooks[i] = { deps: undefined }
+ inst.effects.push([i, fn, deps])
+ },
+ useRef(value) {
+ const { inst } = live
+ const i = live.idx++
+ if (!(i in inst.hooks)) inst.hooks[i] = { current: value }
+ return inst.hooks[i]
+ },
+}
+for (const name of ['useMemo', 'useCallback', 'useLayoutEffect', 'useContext', 'useReducer', 'useId', 'useSyncExternalStore', 'useTransition', 'useDeferredValue', 'memo', 'forwardRef', 'createContext', 'createPortal', 'cloneElement', 'isValidElement', 'startTransition']) reactStub[name] = (value) => value
+
+globalThis.document ??= { createElement: () => ({ setAttribute() {} }), head: { appendChild() {} }, getElementById: () => null, addEventListener() {}, removeEventListener() {} }
+
+function loadApp() {
+ const modules = new Map()
+ const window = { __ModuleLoader__: { load: ({ id, factory }) => modules.set(id, factory(name => (name === 'react' ? reactStub : {}))) } }
+ new Function('window', readFileSync(new URL('../client.js', import.meta.url), 'utf8'))(window)
+ return modules.get('@flybot/social')
+}
+
+const fresh = () => ({ hooks: {}, effects: [] })
+function render(Component, inst) {
+ live.inst = inst
+ live.idx = 0
+ inst.effects = []
+ return Component(inst.props ?? {})
+}
+// A component element is a function in `type`: it has to be called to see the card it draws. Its own
+// hook slots are separate from the caller's, the way React keeps them apart.
+function mount(element) {
+ const outer = { inst: live.inst, idx: live.idx }
+ live.inst = fresh()
+ live.idx = 0
+ const out = element.type(element.props ?? {})
+ live.inst = outer.inst
+ live.idx = outer.idx
+ return out
+}
+function walk(node, visit) {
+ if (node == null || node === false || node === true) return
+ if (Array.isArray(node)) { for (const child of node) walk(child, visit); return }
+ if (typeof node === 'string' || typeof node === 'number') return
+ visit(node)
+ if (typeof node.type === 'function') return walk(mount(node), visit)
+ return walk(node.children ?? [], visit)
+}
+const nodeWhere = (tree, match) => {
+ let hit = null
+ walk(tree, node => { if (!hit && match(node)) hit = node })
+ return hit
+}
+
+// The host's `t`: the dictionary entry when it has one, the English otherwise, which is what a
+// Chinese window sees.
+const hostT = (text, params) => {
+ const hit = Object.hasOwn(zh, text) ? zh[text] : text
+ return String(hit).replace(/\{(\w+)\}/g, (_, key) => String(params?.[key] ?? ''))
+}
+const englishT = (text, params) => String(text).replace(/\{(\w+)\}/g, (_, key) => String(params?.[key] ?? ''))
+
+// One local timestamp, so the day the card names does not depend on the runner's zone.
+const local = (day, hh, mm) => new Date(2026, 9, day, hh, mm).toISOString()
+
+// The Past card's two accessible names: the row button that opens the room, and the member stack.
+const faceCard = (t, room = {}) => {
+ globalThis.__flybot__ = { t, call: () => Promise.resolve({}) }
+ const app = loadApp()
+ const inst = {
+ hooks: {},
+ effects: [],
+ props: {
+ room: {
+ roomId: 'r1', faceRoomId: 'frm1', name: 'Face-to-face room',
+ members: [{ handle: '@alice', ownerName: 'Alice' }], createdAt: local(19, 14, 5), ...room,
+ },
+ past: true,
+ },
+ }
+ const tree = render(app.FaceRoomCard, inst)
+ const row = nodeWhere(tree, node => node?.props?.role === 'button' && 'aria-label' in (node.props ?? {}))
+ const stack = nodeWhere(tree, node => node?.props?.className === 'fs-stack')
+ assert.ok(row, 'the Past row is one button')
+ assert.ok(stack, 'the row draws its member stack')
+ return { row: row.props['aria-label'], stack: stack.props['aria-label'] }
+}
+
+test('#3100: a Past row’s open button names the room in the window’s language', () => {
+ try {
+ const seen = faceCard(hostT)
+ assert.equal(seen.row, `打开 面对面 · Alice · 10月19日 14:05`, `the row’s accessible name: saw ${JSON.stringify(seen.row)}`)
+ } finally { delete globalThis.__flybot__ }
+})
+
+test('#3100: the member stack’s accessible name reads the window’s language', () => {
+ try {
+ const seen = faceCard(hostT)
+ assert.equal(seen.stack, '成员', `the member stack’s accessible name: saw ${JSON.stringify(seen.stack)}`)
+ } finally { delete globalThis.__flybot__ }
+})
+
+test('#3100: an English window keeps the accessible names it drew before', () => {
+ try {
+ const seen = faceCard(englishT)
+ assert.equal(seen.row, 'Open Face-to-face · Alice · Oct 19 14:05', `the row’s accessible name: saw ${JSON.stringify(seen.row)}`)
+ assert.equal(seen.stack, 'Members', `the member stack’s accessible name: saw ${JSON.stringify(seen.stack)}`)
+ } finally { delete globalThis.__flybot__ }
+})