Add contextual input mapping for overlays.

PR Details:
- Enables input behavior based on active overlay context
- Integrates with existing input systems

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,8 +2,9 @@ MODEL: GPT-5.4
 REASONING: medium
 
 COMMAND:
-Implement gesture support for overlay system:
-- Add gesture abstraction (tap, hold, swipe)
-- Map gestures to overlay actions
-- Maintain compatibility with existing input system
+Implement contextual input mapping:
+- Add context-aware input resolution
+- Use overlay stack and active layer
+- Integrate with existing gesture + keybind systems
+- Do not duplicate gesture logic
 - Update roadmap status only

docs/dev/COMMIT_COMMENT.txt

@@ -1,5 +1,5 @@
-Add gesture support to overlay system.
+Add contextual input mapping for overlays.
 
 PR Details:
-- Introduces gesture abstraction layer
-- Maps gestures to overlay interactions
+- Enables input behavior based on active overlay context
+- Integrates with existing input systems

docs/dev/reports/validation_checklist.txt

@@ -1,5 +1,4 @@
-[ ] Tap gesture works
-[ ] Hold gesture works
-[ ] Swipe gesture works
-[ ] No regression in keyboard/mouse input
+[ ] Context switching updates input behavior
+[ ] No conflicts across overlays
+[ ] Gesture + keybind compatibility maintained
 [ ] Roadmap updated

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -636,6 +636,7 @@
 - [x] Level 21 overlay system baseline promoted after validation (context-aware behavior, synchronized state, event-driven updates, and performance optimization; no Level 17/19 overlay regressions)
 - [x] Level 21 advanced overlay interactions implemented (click/drag/resize) with gameplay-safe explicit interaction mode
 - [x] Level 22 gesture abstraction added for overlays (tap/hold/swipe mapped to runtime actions with explicit gameplay-safe gating)
+- [x] Level 22 contextual input mapping added (active overlay/layer stack-aware resolution across keybind and gesture actions)
 
 ### Sample Phase Tracks
 - [x] 3D phase normalized

docs/pr/BUILD_PR.md

@@ -1,21 +1,21 @@
-# BUILD_PR_LEVEL_22_2_OVERLAY_GESTURE_SUPPORT
+# BUILD_PR_LEVEL_22_3_OVERLAY_CONTEXTUAL_INPUT_MAPPING
 
 ## Purpose
-Extend overlay interaction system with gesture-based input support.
+Introduce context-aware input mapping for overlays based on runtime state.
 
 ## Roadmap Improvement
-Adds gesture layer on top of interaction system (Level 22).
+Advances Level 22 by aligning input behavior with active overlay context.
 
 ## Scope
-- Add gesture abstraction (tap, hold, swipe)
-- Map gestures to overlay actions
-- Ensure compatibility with keyboard/mouse input
+- Map inputs based on overlay stack/context
+- Support priority-based input resolution
+- Integrate with existing gesture and keybind systems
 
 ## Test Steps
-1. Perform tap/hold/swipe on overlays
-2. Validate correct mapping
-3. Ensure no regression in keyboard controls
+1. Activate different overlay contexts
+2. Verify input behavior changes correctly
+3. Ensure no cross-context leakage
 
 ## Expected
-- Gesture support operational
-- No input conflicts
+- Context-driven input behavior
+- Stable and predictable mapping