Input Abstraction Layer

Overview

Normalize heterogeneous platform key events into one app-level action contract. Treat platform keycodes as adapter concerns, not feature code concerns.

Core Contract

Expose canonical actions:

• NAV_UP, NAV_DOWN, NAV_LEFT, NAV_RIGHT
• SELECT, BACK, MENU, PLAY_PAUSE
• SEEK_FWD, SEEK_BACK, PAGE_UP, PAGE_DOWN

Workflow

1. Create per-platform adapters that map native events to canonical actions.
2. Centralize repeat-rate and long-press policy in one dispatcher.
3. Emit input source metadata (remote, gamepad, keyboard) for telemetry.
4. Gate feature-level handlers behind canonical actions only.
5. Add platform fallback paths for missing keys.