docs: Phase 241 GUI — embed keyshortcuts, actions focus, triple nest, codec chip (v0.8.205)

Roadmap marks Phase 241 complete and plans Phase 242; parity, UI flow, topic, markdown, and voice docs updated with new smokes. Co-authored-by: Cursor <[email protected]>
2026-05-23 01:00:09 -04:00
parent 341385fb93
commit 1528947fcb
6 changed files with 44 additions and 6 deletions
@@ -53,6 +53,7 @@ Forum channels reserve `topic` for the tag palette JSON (`{"forumTags":[...]}`).
 - **Kbd toolbar** (v0.8.202): shortcut row wrapped in `role="toolbar"` (`channel-topic-popover-kbd-toolbar`)
 - **Toolbar focus** (v0.8.203): popover opens with focus on **⌘C copy** chip (or Copy all when present)
 - **Actions toolbar** (v0.8.204): copy/edit row uses `role="toolbar"` with **Topic actions** label
 - **Actions focus** (v0.8.205): kbd shortcut chips take initial focus; otherwise first actions-toolbar button
 - **Focus trap** (v0.8.184): Tab cycles within the popover; first action receives focus
 - **Focus restore** (v0.8.185): Escape or dismiss returns focus to the channel name trigger
 - **✎** button (moderators) → edit modal
@@ -20,6 +20,7 @@
 | Spoiler + heading | Composer warns when spoiler and heading markers overlap in one selection (v0.8.202) |
 | Code + heading | Composer warns when code and heading markers overlap in one selection (v0.8.203) |
 | Quote + code | Composer warns when quote and code markers overlap in one selection (v0.8.204) |
 | Spoiler + quote + code | Composer warns when all three block styles appear in one selection (v0.8.205) |
 | `\|\|spoiler\|\|` | Click-to-reveal spoiler (nestable inside **bold** / *italic* / __underline__ / ~~strike~~ / `` `code` `` — v0.8.182+); URLs inside spoilers blur link previews until reveal (v0.8.186); compact previews use **Show/Hide spoiler link** toggle with **▮ Spoiler link** row hint (v0.8.195–199); expanded spoiler links per channel (v0.8.193); revealed message/embed spoilers per channel for the session (v0.8.194); composer **selection is spoiler** hint when wrapped in `\|\|` (v0.8.191); composer warns when spoiler/code or overlapping style wraps nest (v0.8.198–199) |
 | `@username` | Mention highlight (when name is in `view.mentionNames`) |
 | `:emoji_name:` | Custom guild emoji image |
@@ -4,6 +4,15 @@ Gap analysis between **Pearcord** (P2P Pear app) and a typical **centralized cha
 > This is the only doc that compares against an external reference product. All other docs use Pearcord naming only.
 ## Summary (v0.8.205) — GUI focus
 | Area | Reference product | Pearcord | Gap |
 |------|-------------------|----------|-----|
 | Embed keyshortcuts | Keyboard a11y | Collapse toggle **aria-keyshortcuts Enter Space** | Spoiler keyshortcuts |
 | Actions focus | Popover entry | Kbd chips first, else first **Topic actions** button | Dual-toolbar tab |
 | Triple nest | Block styles | **spoiler+quote+code** triple overlap warning | spoiler/heading/code |
 | Video codec chip | Stream stats | Dedicated **CODEC** badge on video hover (deduped from quality) | Connected RTT chip |
 ## Summary (v0.8.204) — GUI focus
 | Area | Reference product | Pearcord | Gap |
@@ -1661,16 +1661,29 @@ When completing work, change `[ ]` → `[x]` and add a one-line note under **Cha
 ---
-### Phase 241 — Discord-like GUI sprint XLVII (planned)
+### Phase 241 — Discord-like GUI sprint XLVII (complete)
 | ID | Item | Status |
 |----|------|--------|
-| P241-1 | Messages: embed toggle aria-keyshortcuts Enter/Space | [ ] |
+| P241-1 | Messages: embed toggle aria-keyshortcuts Enter/Space | [x] |
-| P241-2 | Channels: topic popover actions toolbar focus order | [ ] |
+| P241-2 | Channels: topic popover actions toolbar focus order | [x] |
-| P241-3 | Composer: spoiler+quote+code triple nest guard | [ ] |
+| P241-3 | Composer: spoiler+quote+code triple nest guard | [x] |
-| P241-4 | Voice: stream hover codec-only badge on video | [ ] |
+| P241-4 | Voice: stream hover codec-only badge on video | [x] |
-**Next:** Embed keyshortcuts · actions focus · triple nest · codec chip.
+**Next:** ~~Embed keyshortcuts · actions focus · triple nest · codec chip~~ (Phase 241).
 ---
 ### Phase 242 — Discord-like GUI sprint XLVIII (planned)
 | ID | Item | Status |
 |----|------|--------|
 | P242-1 | Messages: spoiler link toggle aria-keyshortcuts Enter/Space | [ ] |
 | P242-2 | Channels: topic popover dual-toolbar tab order | [ ] |
 | P242-3 | Composer: spoiler+heading+code triple nest guard | [ ] |
 | P242-4 | Voice: stream hover RTT-only badge when connected | [ ] |
 **Next:** Spoiler keyshortcuts · dual-toolbar tab · spoiler/heading/code triple · RTT chip.
 ---
@@ -3116,6 +3129,7 @@ Micro a11y/guild smokes deferred while GUI sprint is prioritized. See Phase 195
 ### Changelog
 - **2026-05-22** — v0.8.205: Phase 241 GUI — embed Enter/Space keyshortcuts, topic actions focus fallback, spoiler/quote/code triple nest, video codec hover chip (`test:embed-toggle-keyshortcuts`, `test:channel-topic-actions-focus`, `test:composer-spoiler-quote-code-triple-nest`, `test:stream-hover-codec-badge`). Phase 242 planned.
 - **2026-05-22** — v0.8.204: Phase 240 GUI — spoiler link aria-label sync, topic actions toolbar, quote/code nest guard, video resolution hover chip (`test:spoiler-link-aria-label`, `test:channel-topic-actions-toolbar`, `test:composer-quote-code-nest`, `test:stream-hover-resolution-badge`). Phase 241 planned.
 - **2026-05-22** — v0.8.203: Phase 239 GUI — embed toggle aria-labels, topic toolbar focus order, code/heading nest guard, video FPS hover chip (`test:embed-toggle-aria-label`, `test:channel-topic-toolbar-focus`, `test:composer-code-heading-nest`, `test:stream-hover-fps-badge`). Phase 240 planned.
 - **2026-05-22** — v0.8.202: Phase 238 GUI — embed collapse keyboard, topic kbd toolbar, spoiler/heading nest, quality RTT dedupe label (`test:embed-collapse-keyboard`, `test:channel-topic-kbd-toolbar`, `test:composer-spoiler-heading-nest`, `test:stream-quality-rtt-dedupe`). Phase 239 planned.
@@ -133,6 +133,17 @@ Smokes: `npm run test:reply-preview-hover`, `npm run test:channel-notification-l
 Smokes: `npm run test:embed-card-layout`, `npm run test:unread-divider`, `npm run test:role-reorder`, `npm run test:group-dm-header`.
 ## Desktop GUI (v0.8.205)
 | Flow | Behavior |
 |------|----------|
 | Embed keyshortcuts | Collapse toggle exposes **Enter Space** via `aria-keyshortcuts` |
 | Actions focus | Topic popover focuses kbd copy chips first, else first actions-toolbar button |
 | Triple nest | Composer warns when spoiler, quote, and code markers appear together |
 | Video codec chip | Video hover shows dedicated codec badge; quality pill omits codec |
 Smokes: `npm run test:embed-toggle-keyshortcuts`, `test:channel-topic-actions-focus`, `test:composer-spoiler-quote-code-triple-nest`, `test:stream-hover-codec-badge`.
 ## Desktop GUI (v0.8.204)
 | Flow | Behavior |
@@ -80,6 +80,8 @@ Per-channel overwrites apply via `pearcord-channel-permissions` (see [CHANNEL_PE
 **v0.8.114:** **Collapse all** — Voice filter bar **Collapse all** clears every expanded roster via `set-voice-roster-expanded`. Smoke: `npm run test:voice-roster-collapse-all`.
 **v0.8.205:** **Stream hover codec chip** — Video stream hover shows a dedicated codec badge (VP8/H264/etc.) deduped from the quality pill when Opus is not active. Smoke: `npm run test:stream-hover-codec-badge`. See [UI_FLOW.md](./UI_FLOW.md).
 ## Tests
 - `npm run test:voice`