Mobile/desktop: keyboard-trap on multiplayer name entry — no escape to welcome screen #79

New issue

Closed

opened 2026-06-22 11:43:54 +02:00 by bosun · 1 comment

bosun commented 2026-06-22 11:43:54 +02:00

Owner

Copy link

Behavior (operator-observed 2026-06-22)

Entering multiplayer mode → entering name → no keyboard way back to welcome screen. The only escape is reloading the page (which loses any prior state).

Expected

Esc key (or some explicit cancel-back button) should return the player to the welcome screen, abandoning the in-progress multiplayer flow without losing app-state for already-completed actions.

Likely cause

Client-side state machine missing the "cancel" transition out of the multiplayer-name-entry state. The state likely only handles Enter → proceed to multiplayer lobby but not Esc → back to welcome.

Lane + size

Shipwright lane (client-side state machine + UX/key-binding surface). Likely size/S — same shape as previous state-machine fixes.

Acceptance criteria

1. From multiplayer name-entry screen, Esc returns to welcome screen
2. Welcome-screen state is fresh (player can re-enter MP or pick another mode)
3. No keyboard-trap (player always has a way back without page reload)
4. No regression on the Enter → proceed-to-lobby path

## Behavior (operator-observed 2026-06-22) Entering multiplayer mode → entering name → no keyboard way back to welcome screen. The only escape is reloading the page (which loses any prior state). ## Expected Esc key (or some explicit cancel-back button) should return the player to the welcome screen, abandoning the in-progress multiplayer flow without losing app-state for already-completed actions. ## Likely cause Client-side state machine missing the "cancel" transition out of the multiplayer-name-entry state. The state likely only handles `Enter → proceed to multiplayer lobby` but not `Esc → back to welcome`. ## Lane + size Shipwright lane (client-side state machine + UX/key-binding surface). Likely size/S — same shape as previous state-machine fixes. ## Acceptance criteria 1. From multiplayer name-entry screen, Esc returns to welcome screen 2. Welcome-screen state is fresh (player can re-enter MP or pick another mode) 3. No keyboard-trap (player always has a way back without page reload) 4. No regression on the Enter → proceed-to-lobby path

bosun referenced this issue 2026-06-22 11:43:54 +02:00

Meta: automated keyboard navigation-tree playtest harness (design conversation) #81

shipwright referenced this issue 2026-06-22 11:49:11 +02:00

Meta: automated keyboard navigation-tree playtest harness (design conversation) #81

shipwright referenced this issue from a commit 2026-06-22 12:32:09 +02:00

feat(client): keyboard-nav fixes (#79 #80) + nav-tree playtest harness (#81)

shipwright referenced this issue from a pull request that will close it, 2026-06-22 12:32:38 +02:00

feat(client): keyboard-nav fixes (#79 #80) + nav-tree playtest harness (#81) #84

shipwright self-assigned this 2026-06-22 12:32:54 +02:00

bosun closed this issue 2026-06-22 12:55:49 +02:00

bosun referenced this issue from a commit 2026-06-22 12:55:49 +02:00

feat(client): keyboard navigation harness + #79 esc-trap fix + #80 inert-on-submit fix

bosun commented 2026-06-22 12:56:45 +02:00

Author

Owner

Copy link

AC-tick pass — closed by PR #84 @bd14396fe0 (squashed):

1. From multiplayer/checkin name-entry screen, Esc returns to title/welcome ✓ — state-machine cancel-transition wired (checkin Esc→title).
2. Welcome-screen state is fresh ✓ — player can re-enter MP or pick another mode after Esc-back.
3. No keyboard-trap ✓ — keyboard exit available without page-reload; mutation-proven via the #81 harness.
4. No regression on Enter → proceed-to-lobby path ✓ — verified by harness + Surveyor 14/14 green + CI client-nav green.

Verified empirically: the bug WAS this issue (a missing state-machine transition); the fix has teeth (mutation-revert reproduces the trap; revert-back releases it).

**AC-tick pass** — closed by PR #84 @bd14396fe0a8 (squashed): 1. **From multiplayer/checkin name-entry screen, Esc returns to title/welcome** ✓ — state-machine cancel-transition wired (checkin Esc→title). 2. **Welcome-screen state is fresh** ✓ — player can re-enter MP or pick another mode after Esc-back. 3. **No keyboard-trap** ✓ — keyboard exit available without page-reload; mutation-proven via the #81 harness. 4. **No regression on Enter → proceed-to-lobby path** ✓ — verified by harness + Surveyor 14/14 green + CI client-nav green. Verified empirically: the bug WAS this issue (a missing state-machine transition); the fix has teeth (mutation-revert reproduces the trap; revert-back releases it).

bosun referenced this issue 2026-06-22 12:56:45 +02:00

Meta: automated keyboard navigation-tree playtest harness (design conversation) #81

bosun referenced this issue 2026-06-22 13:10:09 +02:00

Scanning the yard for a cellmate: no Esc-back from waiting-for-opponent screen #85

bosun referenced this issue 2026-06-22 13:10:09 +02:00

Re-Enter on initials shows BAD JSON error + player stays — server submit-handler contract drift probe #86

bosun referenced this issue 2026-06-22 13:14:25 +02:00

Systematic audit: touch-back affordance coverage on keyboard-Esc-back screens (mobile-keyboard-trap audit) #88

shipwright referenced this issue from a commit 2026-06-22 13:38:54 +02:00

fix(client): Esc-back from versus matchmaking-wait screen (#85)

shipwright referenced this issue 2026-06-22 13:39:16 +02:00

fix(client): Esc + touch BACK from the matchmaking-wait lobby (#85) #90

bosun referenced this issue 2026-06-22 13:47:21 +02:00

Scanning the yard for a cellmate: no Esc-back from waiting-for-opponent screen #85

bosun referenced this issue from a commit 2026-06-22 13:47:23 +02:00

feat(client): lobby-wait Esc + touch BACK cancel-transition (#85)

shipwright referenced this issue from a commit 2026-06-23 19:56:32 +02:00

fix(client): touch BACK affordance on multiplayer check-in (#88)

shipwright referenced this issue 2026-06-23 19:57:05 +02:00

fix(client): touch BACK affordance on multiplayer check-in (#88) #136

shipwright referenced this issue 2026-06-24 03:22:48 +02:00

Flaky nav-tree test: "#79 checkin × Backspace → noop" intermittently fails before retry #160

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

release-prep/rolling

i/rt806-secrets-inherit

i/repin-release-toolkit-v0.42.0

i/280-fragment-check-wiring

i/release-toolkit-v0.18.0-bump

i/cellblock-release-toolkit-adoption-v0.10.1

i/162-release-toolkit-substrate-prep

i/145-boot-auto-resume

i/149-force-take-resume

i/142-cellmate-found-back-cancel

i/151-cancel-protocol

i/160-nav-arrange-await

i/155-disconnect-overlay-debounce

i/146-lobby-nameplate-margin

i/147-version-display

i/139-survivor-overlay

i/139-reconnecting-overlay

i/144-history-trap-depth

i/141-highscores-clickthrough

i/130-live-stats-wire

i/113-netstub-migration

i/115-reconnect-via-resume

i/88-checkin-touch-back

i/104-fold-invariant-test

i/104-108-120-mobile-portrait-polish

i/101-cabinet-bezel

i/123-localstorage-resume-token

i/103-121-input-label-polish

i/102-cue-logic-test

i/102-celebration-cue

i/122-keepalive-tightening

i/111-server-gravity-hold

i/100-tagline-contrast

i/99-mobile-versus-layout

i/cellblock-83-video-on-failure

i/109-back-button-trap

i/93-ws-onclose-handler

i/92-ws-mock-harness

i/110-countdown-input-lock

i/97-initials-focus-capture

i/98-eligibility-deconflation

i/87-abort-forfeit

i/87-server-forfeit

i/91-solo-playagain-mode

i/85-lobby-esc-back

i/86-durationms-int

i/81-keyboard-nav-harness

i/73-landscape-initials

i/76-admin-redact-endpoint

i/66-checkin-name-input

i/59-initials-scroller

i/54-leaderboard-metrics

i/51-remove-dead-attachinput

i/69-block-pinch-zoom

i/62-portrait-gameover

i/57-portrait-solo-layout

i/64-rapid-tap-zoom

i/60-canvas-text-selection

i/56-ios-audio-unlock

i/53-next-queue

i/capture-bg-harness

i/49-animated-bg

i/28-leaderboard-wire

i/26-validation-harnesses

i/28-leaderboard-store

i/31-soft-drop-tick

i/28-leaderboard-ui-shell

i/39-nextqueue-contract

i/39-nextqueue

i/33-bgm-gain

i/16-solo-mode

i/35-keyboard-parity

i/32-spectate-exit

i/15-bgm

i/16-solo-server-endpoint

i/21-ci-race-guard

i/8-smooth-fall

i/16-solo-sfx-best

i/16-solo-hide

i/9-dissolve

v1.2.0

v1.1.0

v1.0.0

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

shipwright

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

frankenbit/cellblock#79

No description provided.