ADR-008 — Compose Navigation 3 retenu pour la navigation

Statut

Accepté — 2026-04-19

Contexte

Redface 2 est une application 100% Compose avec un besoin explicite de :

• back stack typé
• intégration propre avec Material 3 Adaptive
• gestion explicite des scènes et du state
• deep linking HFR, y compris avec des fragments URI non gérés nativement

Les options étudiées étaient principalement :

• Navigation 2.x
• Compose Navigation 3
• Circuit
• Decompose

Décision

Le projet retient Compose Navigation 3 comme stack de navigation.

Les choix d’API associés sont :

• routes typées (@Serializable) implémentant un sealed interface RedfaceNavKey : NavKey
• back stack explicite via NavBackStack<NavKey> (un par onglet de bottom nav, conservé entre commutations)
• rendu via NavDisplay(backStack, onBack, entryDecorators, entryProvider { entry<Route> { … } }) — l’API stable single-pane, qui couvre déjà predictive back, lifecycle et state restoration
• décorateurs rememberSaveableStateHolderNavEntryDecorator() + rememberViewModelStoreNavEntryDecorator() pour la persistance d’état et des ViewModels par entrée
• multi-pane (tablette / foldables) via ListDetailPaneScaffold (Material 3 Adaptive 1.2+) au-dessus du même back stack
• gestion du back par défaut via le paramètre onBack de NavDisplay ; PredictiveBackHandler ajouté seulement sur les écrans à interaction custom (ex. éditeur avec draft non sauvegardé)

Les fragments HFR de type #t{numreponse} sont parsés manuellement à l’entrée de l’app, puis transformés en routes typées.

Conséquences

• la navigation est alignée avec une app Compose-first moderne
• les exemples et snippets doivent utiliser l’API stable actuelle de Navigation 3
• le deep linking HFR reste une responsabilité applicative explicite, pas un mapping “automatique”
• les écrans tablette et list-detail se branchent naturellement sur cette stack

Alternatives considérées

• Navigation 2.x : mature, mais moins propre pour le modèle de scenes/state retenu
• Circuit : solide, mais plus structurant et moins naturel pour ce repo
• Decompose : puissant, mais apporte un modèle plus large que le besoin immédiat