0.1.0-0-pre.8

docs/architecture/004-INPUT_AND_CONTROLS.md

@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/004-INPUT_AND_CONTROLS.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Abstraction des entrées et contrôles
 
@@ -53,3 +53,17 @@ Cette structure n'est pas imposée comme API définitive à la baseline ; elle i
 ## Orientation d'écran
 
 Portrait convient particulièrement aux jeux one-button, merge, puzzle, idle, stacking et climber. Paysage convient mieux aux shooters, runners latéraux, survivor-like, tower defense et jeux utilisant deux zones de contrôle.
+
+## Pointeur primaire normalisé
+
+Le moteur V1 expose un `PointerState` indépendant de la plateforme :
+
+- `active` indique qu'un pointeur primaire est maintenu ;
+- `x` et `y` sont normalisés dans `[0.0, 1.0]` ;
+- la plateforme borne les coordonnées avant de les transmettre au gameplay.
+
+SDL3 fournit cette abstraction sur Android avec les événements `FingerDown`, `FingerMotion`, `FingerUp` et `FingerCanceled`.
+
+La baseline `0.1.0-0-pre.8` mappe également un doigt actif vers `GameAction::Primary`. Cette association est volontairement minimale et pourra être remplacée par des zones tactiles ou boutons virtuels par jeu.
+
+Le gameplay ne dépend d'aucun type Android, Java ou SDL3.