"/home/yossef/notes/git/projects/maplibra/risks/Keyboard and Joystick Input.md"

path: maplibra/risks/Keyboard and Joystick Input.md

- **fileName**: Keyboard and Joystick Input
- **Created on**: 2026-06-16 00:48:42

Keyboard and Joystick Input

Migrated from: obs_vault

Parent: ../modules/Bootstrap System.md

This note covers the non-mapbox navigation input helpers.

Main Source Files

• src/bootstrap/init-keyboard.js
• src/bootstrap/init-joystick.js

What It Does

• setupKeyboardControls() handles WASD and arrow-key panning.
• setupJoystickControls() handles joystick-based pan, rotate, and pitch adjustments.
• Both helpers return or store cleanup logic so listeners can be removed later.

Why It Matters

• These helpers are the only path to keyboard and joystick navigation.
• They also reveal whether shell bootstrapping actually wires the optional controls into the running map.

Risks

• Keyboard setup can exist in the codebase without being invoked in the live startup path.
• Listener cleanup has to match the exact function references used when the listeners were registered.

See Also

• ../modules/Bootstrap System.md

• ./Shell Bootstrap Risks.md

  continue:[[]]
  before:[[]]