feat(a11y): Physical Keyboard Navigation

.github/workflows/build-pr.yml

@@ -82,7 +82,7 @@ jobs:
     secrets: inherit
     strategy:
       matrix:
-        shard: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
+        shard: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]
       fail-fast: false
     with:
       shard: ${{ matrix.shard }}

.github/workflows/maestro-android.yml

@@ -13,6 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       MAESTRO_VERSION: 2.2.0
+      ANDROID_AVD_HOME: /home/runner/.android/avd
 
     steps:
       - name: Checkout Repository
@@ -67,8 +68,82 @@ jobs:
       - name: Make Maestro script executable
         run: chmod +x .github/scripts/run-maestro.sh
 
-      - name: Start Android Emulator and Run Maestro Tests
-        uses: reactivecircus/android-emulator-runner@v2
+      - name: Create Keyboard-enabled AVD (shard 14)
+        if: ${{ inputs.shard == '14' }}
+        run: |
+          set -eux
+
+          ANDROID_SDK="${ANDROID_HOME:-${ANDROID_SDK_ROOT:-/usr/local/lib/android/sdk}}"
+          SDKMANAGER="$ANDROID_SDK/cmdline-tools/latest/bin/sdkmanager"
+          AVDMANAGER="$ANDROID_SDK/cmdline-tools/latest/bin/avdmanager"
+          AVD_NAME="Pixel_API_34_Keyboard"
+          IMAGE="system-images;android-34;google_apis;x86_64"
+          AVD_BASE="$ANDROID_AVD_HOME"
+          AVD_INI="$AVD_BASE/${AVD_NAME}.ini"
+
+          mkdir -p "$AVD_BASE"
+          rm -rf "$AVD_BASE/${AVD_NAME}.avd" "$AVD_INI"
+
+          "$SDKMANAGER" --install emulator "$IMAGE"
+          yes | "$SDKMANAGER" --licenses > /dev/null || true
+
+          echo "no" | "$AVDMANAGER" create avd -n "$AVD_NAME" -d pixel_7_pro --package "$IMAGE" --force
+
+          if [ ! -f "$AVD_INI" ]; then
+            echo "Expected AVD ini not found: $AVD_INI"
+            echo "--- avdmanager list avd ---"
+            "$AVDMANAGER" list avd || true
+            echo "--- ls AVD_BASE ---"
+            ls -la "$AVD_BASE" || true
+            exit 1
+          fi
+
+          AVD_PATH="$(sed -n 's/^path=//p' "$AVD_INI")"
+          if [ -z "$AVD_PATH" ]; then
+            echo "Could not resolve AVD path from: $AVD_INI"
+            cat "$AVD_INI"
+            exit 1
+          fi
+
+          AVD_CONFIG="$AVD_PATH/config.ini"
+          if [ ! -f "$AVD_CONFIG" ]; then
+            echo "Expected AVD config not found: $AVD_CONFIG"
+            ls -la "$AVD_BASE" || true
+            ls -la "$AVD_PATH" || true
+            exit 1
+          fi
+
+          {
+            echo "hw.keyboard=yes"
+            echo "hw.keyboard.lid=no"
+            echo "hw.lcd.density=440"
+            echo "hw.lcd.height=2280"
+            echo "hw.lcd.width=1080"
+          } >> "$AVD_CONFIG"
+
+          echo "$AVD_NAME created with physical keyboard support"
+
+      - name: Start Android Emulator and Run Maestro Tests (keyboard AVD)
+        if: ${{ inputs.shard == '14' }}
+        uses: reactivecircus/android-emulator-runner@e89f39f1abbbd05b1113a29cf4db69e7540cae5a # v2.37.0
+        timeout-minutes: 60
+        with:
+          api-level: 34
+          disk-size: 4096M
+          arch: x86_64
+          target: google_apis
+          avd-name: Pixel_API_34_Keyboard
+          cores: 4
+          ram-size: 4096M
+          force-avd-creation: false
+          disable-animations: true
+          emulator-boot-timeout: 900
+          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none -accel on
+          script: ./.github/scripts/run-maestro.sh android ${{ inputs.shard }}
+
+      - name: Start Android Emulator and Run Maestro Tests (default)
+        if: ${{ inputs.shard != '14' }}
+        uses: reactivecircus/android-emulator-runner@e89f39f1abbbd05b1113a29cf4db69e7540cae5a # v2.37.0
         timeout-minutes: 60
         with:
           api-level: 34

.maestro/tests/keyboardNavigation/keyboard-navigation-components.yaml

@@ -0,0 +1,117 @@
+appId: chat.rocket.reactnative
+name: Keyboard Navigation Components
+onFlowStart:
+  - runFlow: '../../helpers/setup.yaml'
+onFlowComplete:
+  - evalScript: ${output.utils.deleteCreatedUsers()}
+tags:
+  - test-14
+  - android-only
+
+---
+- evalScript: ${output.user = output.utils.createUser()}
+
+- runFlow:
+    file: '../../helpers/login-with-deeplink.yaml'
+    env:
+      USERNAME: ${output.user.username}
+      PASSWORD: ${output.user.password}
+
+# open Accessibility & appearance
+- extendedWaitUntil:
+    visible:
+      text: 'Save your encryption password'
+    timeout: 60000
+- pressKey: enter
+- extendedWaitUntil:
+    visible:
+      text: 'Accessibility & Appearance'
+    timeout: 60000
+- pressKey: Remote Dpad Left
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+
+# switches
+- extendedWaitUntil:
+    visible:
+      text: 'Theme'
+    timeout: 60000
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Up
+- assertVisible:
+    text: 'Mentions with @ symbol unchecked'
+- pressKey: enter
+- assertVisible:
+    text: 'Mentions with @ symbol checked'
+- pressKey: Remote Dpad Down
+
+# open Theme and navigate radio buttons
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Up
+- pressKey: enter
+- extendedWaitUntil:
+    visible:
+      id: 'theme-view'
+    timeout: 60000
+- pressKey: Remote Dpad Down
+- waitForAnimationToEnd:
+    timeout: 1000
+- pressKey: enter
+- pressKey: Remote Dpad Down
+- waitForAnimationToEnd:
+    timeout: 1000
+- pressKey: enter
+
+# open Toasts and Dialogs action sheet and navigate through options
+- tapOn:
+    id: 'custom-header-back'
+- extendedWaitUntil:
+    visible:
+      id: 'accessibility-view-list'
+    timeout: 60000
+- assertVisible: Show alerts as
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+- waitForAnimationToEnd:
+    timeout: 1000
+- assertVisible: 'Toasts. Dismissed automatically. Checked'
+- assertVisible: 'Dialogs. Require manual dismissal. Unchecked'
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+- waitForAnimationToEnd:
+    timeout: 1000
+- assertVisible: Dialogs
+- assertVisible: Show alerts as
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+- waitForAnimationToEnd:
+    timeout: 1000
+- assertVisible: 'Toasts. Dismissed automatically. Unchecked'
+- assertVisible: 'Dialogs. Require manual dismissal. Checked'
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+- waitForAnimationToEnd:
+    timeout: 1000
+- assertVisible: Toasts
+- assertVisible: Show alerts as

.maestro/tests/keyboardNavigation/keyboard-navigation-onboarding.yaml

@@ -0,0 +1,54 @@
+appId: chat.rocket.reactnative
+name: Keyboard Navigation Onboarding
+onFlowStart:
+  - runFlow: '../../helpers/setup.yaml'
+onFlowComplete:
+  - evalScript: ${output.utils.deleteCreatedUsers()}
+tags:
+  - test-14
+  - android-only
+
+---
+- evalScript: ${output.user = output.utils.createUser()}
+- evalScript: ${output.keyboardMessage = 'keyboard-nav-' + output.random(6)}
+
+- runFlow: ../../helpers/launch-app.yaml
+
+# login from onboarding/NewServerView
+- extendedWaitUntil:
+    visible:
+      id: 'new-server-view'
+    timeout: 60000
+- inputText: ${output.data.server}
+- pressKey: tab
+- pressKey: enter
+- extendedWaitUntil:
+    visible: 'Login'
+    timeout: 60000
+- pressKey: enter
+
+- extendedWaitUntil:
+    visible:
+      id: 'login-view'
+    timeout: 60000
+- pressKey: Remote Dpad Down
+- waitForAnimationToEnd:
+    timeout: 1000
+- pressKey: Remote Dpad Down
+- waitForAnimationToEnd:
+    timeout: 1000
+- pressKey: Remote Dpad Down
+- waitForAnimationToEnd:
+    timeout: 1000
+- pressKey: Remote Dpad Down
+- inputText: ${output.user.email}
+- pressKey: enter
+- waitForAnimationToEnd:
+    timeout: 1000
+- inputText: ${output.user.password}
+- pressKey: enter
+- extendedWaitUntil:
+    visible:
+      id: 'rooms-list-view'
+    timeout: 60000
+#

.maestro/tests/keyboardNavigation/keyboard-navigation-room.yaml

@@ -0,0 +1,74 @@
+appId: chat.rocket.reactnative
+name: Keyboard Navigation Room
+jsEngine: graaljs
+onFlowStart:
+  - runFlow: '../../helpers/setup.yaml'
+onFlowComplete:
+  - evalScript: ${output.utils.deleteCreatedUsers()}
+tags:
+  - test-14
+  - android-only
+
+---
+- evalScript: ${output.user = output.utils.createUser()}
+- evalScript: ${output.room = output.utils.createRandomRoom(output.user.username, output.user.password)}
+- evalScript: ${output.keyboardMessage = 'keyboard-room-' + output.random(6)}
+
+- runFlow:
+    file: '../../helpers/login-with-deeplink.yaml'
+    env:
+      USERNAME: ${output.user.username}
+      PASSWORD: ${output.user.password}
+# Navigate to RoomView
+- extendedWaitUntil:
+    visible:
+      text: '${output.room.name}'
+    timeout: 60000
+- extendedWaitUntil:
+    visible:
+      text: 'Save your encryption password'
+    timeout: 60000
+- pressKey: Remote Dpad Right
+- pressKey: Remote Dpad Right
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: enter
+# Submit: ComposerInput wires onSubmitEditing -> send when soft keyboard is hidden (TV / physical keyboard)
+- extendedWaitUntil:
+    visible:
+      id: message-composer-input
+    timeout: 60000
+- inputText: ${output.keyboardMessage}
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Right
+- pressKey: enter
+- extendedWaitUntil:
+    visible:
+      id: 'message-content-${output.keyboardMessage}'
+    timeout: 60000
+# Open Emoji Keyboard
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Right
+- pressKey: enter
+
+# Open category emoji
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Right
+- pressKey: enter
+
+# Select emoji
+- pressKey: Remote Dpad Down
+- pressKey: Remote Dpad Right
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Up
+- pressKey: enter
+
+# Send emoji
+- pressKey: Remote Dpad Up
+- pressKey: Remote Dpad Up
+- pressKey: enter
+- assertVisible:
+    id: 'message-content-😀'

.maestro/tests/room/jump-to-message.yaml

@@ -28,7 +28,7 @@ tags:
       id: '.*Quote first message.*'
     timeout: 60000
 - longPressOn:
-    id: '.*Quote first message.*'
+    text: '.*Quote first message.*'
     retryTapIfNoChange: true
 - extendedWaitUntil:
     visible: