Matrice de couverture web et mobile
État du code au 17 novembre 2026, après livraison des éléments partiels et des 17 modules précédemment à créer. Les guides des compléments et des nouveaux modules décrivent les API. Cette matrice compare les 115 modules publics exportés par @sia-ui/react-web au socle @sia-ui/react-native et à son adaptateur Expo Router. Un module peut exporter plusieurs composants, des types ou des fonctions : ce nombre n’est ni un nombre de composants individuels ni un pourcentage de parité fonctionnelle.
Les 13 adaptations mobiles sont désormais implémentées pour la prochaine publication ; les fonctions de bureau exclues de chaque API restent décrites dans ce guide.
Sources et méthode
- Exports publics web.
- Exports publics natifs et adaptateur Expo.
- Contrats et implémentations des champs, formulaires, navigation, modales et états natifs ; guide mobile, formulaires mobiles et navigation/session.
La comparaison porte sur l’existence d’une API publique et sa responsabilité, pas sur la seule présence d’un dessin dans la démo. Un écran d’exemple, une composition manuelle ou une fonction headless ne compte pas comme un composant natif livré. Les exports secondaires d’un module web sont à examiner lors de son portage ; cette matrice ne prétend pas auditer chaque prop, événement ou variante.
| Statut | Signification |
|---|---|
| Disponible | Un équivalent natif couvre la responsabilité principale ; cela ne signifie ni API identique ni validation complète sur téléphone. |
| Partiel | Une partie du besoin existe, dans un composant plus limité, une composition ou une intégration de démo. Les écarts sont indiqués. |
| À créer | Aucun équivalent public natif dédié ; travail prévu, non livré. |
| À adapter | Le besoin doit être repensé pour le tactile, les primitives natives ou le format d’écran ; travail prévu, décision ou portage encore à faire. |
Tous les composants natifs restent expérimentaux. Les tests de comportement, exports Android/iOS/web et essais dans le navigateur ne prouvent pas les gestes, le clavier, les zones sûres, les lecteurs d’écran ou les performances sur appareil. L’utilisateur confirme le 17 novembre avoir testé l’existant dans l’app. Ce retour est conservé comme validation utilisateur ; les nouveaux ajouts de ce lot restent à repasser dans l’app. Cela ne constitue pas une certification de tous les appareils.
Bilan par statut
- Disponible : 115 modules web.
- Partiel : 0 modules web.
- À créer : 0 modules web.
- À adapter : 0 modules web.
Les lots ci-dessous sont des priorités proposées, pas des engagements de livraison ni des dates. V concerne la consolidation de l’existant ; L1 à L5 identifient le premier lot où traiter le sujet. Un module partiel peut nécessiter plusieurs incréments.
Matrice détaillée
Fondations visuelles et présentation
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Typography | Disponible | Text, Heading, InlineCode | Titres hiérarchiques avec tailles indépendantes, tons, corps, légendes et code en ligne. | L1 |
Button | Disponible | Button | Action, variantes, tailles, chargement et animations ; les props DOM deviennent des props Pressable. | V |
IconButton | Disponible | IconButton | Surface carrée dédiée, nom accessible obligatoire, tailles, arrondis et contenu personnalisé. | V |
Icons | Disponible | Icon et 41 icônes SVG SIA | Tracés communs au web et au mobile, couleur et taille héritées des boutons ; rendu react-native-svg. | L1 |
BrandIcon | Disponible | BrandIcon | Tracé SVG fourni par l’application, taille, couleur de marque, mode décoratif et contraste clair/sombre. Peer react-native-svg compatible Expo. | L3 |
Card | Disponible | Card et parties composables | CardHeader, CardBody et CardFooter sont exportés ; title/description existants restent disponibles. | V |
Badge | Disponible | Badge | Tons, variantes soft/solid/outline et tailles ; vérifier contraste et grands textes sur appareil. | V |
Avatar | Disponible | Avatar | Image, échec avec repli par initiales/contenu, nom accessible et taille. | V |
Label | Disponible | Label | Libellé autonome, obligation, désactivation et cible de focus ; association native via nativeID/accessibilityLabelledBy. | L2 |
Divider | Disponible | Divider | Séparateur horizontal/vertical avec style natif. | V |
Container | Disponible | Container, Stack | Largeur maximale, padding, direction, espacement et retour à la ligne configurables. | L3 |
AspectRatio | Disponible | AspectRatio | Rapport natif validé, largeur adaptative et styles View. | L5 |
ScrollArea | Disponible | ScrollArea | ScrollView natif avec ref et événements ; les grandes collections restent virtualisées via FlatList. | L5 |
ColorModeToggle | Disponible | ColorModeToggle | Cycle clair/sombre/système ; provider contrôlé ou état local et notification onModeChange. | L1 |
Champs et sélection
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Input | Disponible | Input | Label, aide, erreurs rouges, ref, clavier et focus ; le contrat utilise TextInputProps plutôt que les props HTML. | V |
PasswordInput | Disponible | PasswordInput | Visibilité et ref natives ; vérifier le curseur et le clavier sur Android/iOS. | V |
Checkbox | Disponible | Checkbox | États coché/non coché/mixte, erreurs et désactivation ; activation tactile à valider sur appareil. | V |
Switch | Disponible | Switch | Identité SIA, tailles, focus et animations ; bascule par appui, sans glissement latéral du pouce. | V |
RadioGroup | Disponible | RadioGroup | Choix unique et options désactivées ; pas d’export Radio individuel comparable au web. | V |
Select | Disponible | Select dans BottomSheet | Recherche locale ou distante annulable, liste virtualisée et réessai ; pas de pagination distante. | V |
MultiSelect | Disponible | MultiSelect | Choix multiples, résumé des libellés et confirmation dans une feuille. | V |
Autocomplete | Disponible | Autocomplete | Suggestions distantes annulables et valeur libre optionnelle dans une feuille ; pas de menu DOM. | V |
ReferenceSelect | Disponible | ReferenceSelect | Choix métier avec description, recherche locale/distante, chargement, erreurs et conservation de valeur. | L3 |
SearchInput | Disponible | SearchInput | Effacement, validation et debounce configurable avec annulation au démontage. | V |
Textarea | Disponible | Textarea | Contrôle multiligne, hauteur minimale et retour à la ligne ; pas de redimensionnement DOM. | V |
InputNumber | Disponible | InputNumber | Brouillon intermédiaire, bornes, pas, précision et boutons masquables ; formatage local avancé absent. | V |
CurrencyInput | Disponible | CurrencyInput | Groupement et décimales selon la locale ; précision par devise, brouillons et bornes conservés. | V |
PhoneInput | Disponible | PhoneInput | Sélecteur recherchable de pays configurés, onCountryChange, normalisation et conservation des saisies invalides. | V |
OtpInput | Disponible | OtpInput | Cases visuelles sur une saisie native unique : collage, suggestion système, masquage et mode champ classique. | V |
TagsInput | Disponible | TagInput / TagsInput | Ajout par validation ou bouton, collage séparé par virgules, unicité, limites et retrait tactile. | L2 |
Slider | Disponible | Slider | Logique headless commune, geste tactile simple/plage, bornes/pas et actions d’accessibilité. | L2 |
Rating | Disponible | Rating | Étoiles tactiles, maximum configurable, effacement et état lecture seule. | L2 |
Toggle | Disponible | Toggle / ToggleGroup | État pressé contrôlé/local ; groupes simples/multiples, effacement facultatif, tailles, tons, variantes et désactivation. | L2 |
ColorPicker | Disponible | ColorPicker | Nuancier personnalisable, sélection tactile, saisie hexadécimale et validation du formulaire. | L4 |
FileUpload | Disponible | FileUpload et NativeFilePickerProvider | Sélection injectable, type/taille/nombre, retrait, annulation et erreurs. Comme sur le web, le transfert réseau appartient à l’application. | V |
ImageUpload | Disponible | ImageUpload | Photothèque/caméra via adaptateur, aperçu et limites. Le web ne fournit pas non plus recadrage/compression/transfert intégrés. | V |
SecretFields | Disponible | SecretFields | Valeurs masquées, noms enregistrés sans valeur relue, rotation, modèles, validation de noms/doublons et identité des champs conservée. | L3 |
Formulaires et parcours
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Field | Disponible | Field / FormField | Tous les types web sont reconnus, dont champs avancés et hidden ; alias datetime et extensions dateRange/dateTime. Éditeur HTML via adaptateur explicite. | V |
FormField | Disponible | FormField | Liaison adaptateur, événements TextInput, références stables, erreurs et états ; types natifs uniquement. | V |
Form | Disponible | Form et FormContainer | Dispatcher complet, groupes, validation JSON/couleur/nombre, premier invalide et barre clavier ; champs avancés intégrés. | V |
Steps | Disponible | Steps | États, connecteurs animés, orientation, étape contrôlée et callback ; validation externe et statusLabels traduisibles. | V |
UnsavedChangesGuard | Disponible | SiaExpoUnsavedChangesGuard | Retour/suppression de route et shell protégés. Les liens personnalisés passent par useSiaExpoNavigation : contrat d’intégration, pas fonctionnalité absente. | V |
Navigation, structure et session
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
AppShell | Disponible | AppShell et SiaExpoLayout | Disposition responsive, clavier, zones sûres et slots ; routes privées via l’adaptateur Expo optionnel. | V |
Sidebar | Disponible | Sidebar | Arbre, permissions, rail, sous-menus et variante flottante ; tester largeur, focus et grands textes sur appareil. | V |
Tabs | Disponible | Tabs, TabsList, TabsTrigger, TabsContent | Vues contrôlées/locales, panneaux conservés avec fondu/glissement et fond animé ; navigation externe par flèches/Home/End encore à compléter. | V |
Accordion | Disponible | Accordion | Hook partagé, single/multiple, variantes, disabled, contenu conservé et hauteur animée ; gestes et focus natifs à valider. | V |
Breadcrumb | Disponible | Breadcrumb | Parent et page courante sur téléphone ; ancêtres en feuille, fil complet sur tablette. | L5 |
PageHeader | Disponible | PageHeader | Titre, description, retour et actions adaptatives ; rendus natifs, sans contrat DOM. | V |
AuthLayout | Disponible | AuthLayout | Page réutilisable avec titre, logo, description, aside adaptatif, footer, largeur et défilement clavier. | L3 |
AccountMenu | Disponible | AccountMenu | Identité, e-mail, avatar, actions et permissions DropdownMenu ; déconnexion asynchrone injectée, sans deuxième session. | L3 |
RequireSession | Disponible | RequireSession | Même SessionStore SIA : vérification, profil incomplet, refus et callbacks ; ne constitue pas une autorisation serveur. | V |
PermissionGate | Disponible | PermissionGate | Évaluateur injecté, règle déclarée refusée sans évaluateur ; autorisation serveur toujours nécessaire. | V |
PermissionMatrix | Disponible | PermissionMatrix | Groupes tactiles, sélection partielle, jokers, droits non accordables et permissions inconnues conservées ; contrôle serveur applicatif. | L5 |
Couches flottantes et actions contextuelles
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Modal | Disponible | Modal | Ouverture contrôlée, footer, clavier, Retour et défilement ; APIs et garanties de focus DOM non transposables telles quelles. | V |
Drawer | Disponible | Drawer | Quatre positions, taille bornée, footer, Retour/Échap, fond, thème, clavier et animations ; ref open/close/toggle. | L3 |
Overlay | Disponible | Overlay | Couche NativeModal publique, fond configurable, fermeture contrôlée, thème local et restitution de focus ; réutilisée par Drawer. | L1 |
ConfirmDialog | Disponible | ConfirmDialog | Action asynchrone verrouillée, erreur réessayable, ton danger et confirmation textuelle. | V |
DropdownMenu | Disponible | DropdownMenu et ContextMenu | Actions, droits, attente/erreur, confirmation dans la surface, feuille ou ancrage et appui long avec bouton alternatif. | V |
Popover | Disponible | Popover adaptatif | Ancrage mesuré et borné, repli en feuille, Retour/Échap ; les menus ancrés se ferment à l’ouverture du clavier. Existant testé dans l’app par l’utilisateur. | V |
Tooltip | Disponible | Tooltip | Aide par appui, appui long et clavier ; feuille sur téléphone, ancrage sur tablette. | L5 |
HoverCard | Disponible | HoverCard | Aperçu au toucher via Popover/feuille, sans dépendance au survol. | L5 |
CommandPalette | Disponible | CommandPalette | Recherche locale, droits, actions asynchrones, erreurs et liste en feuille ; Ctrl/Cmd+K dans la cible web. | L5 |
Tour | Disponible | Tour | Préparation asynchrone de route/défilement injectée, cible native mesurée, spotlight et progression accessible. | L5 |
Retours utilisateur et états
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Alert | Disponible | Alert | Message sémantique, ton, action et fermeture contrôlée ; annoncer le contenu sans masquer les boutons. | V |
Toast | Disponible | Toast contrôlé et Toaster partagé | Pile, mises à jour, actions et placements reliés au store existant ; un hôte par store, pas de surcouche au-dessus des fenêtres Modal natives. | V |
Spinner | Disponible | Spinner | Dessins SIA ring/double-ring/dots, cinq tailles xs–xl, tons et current via contexte natif ; arrêt en arrière-plan et mouvement réduit. | V |
Skeleton | Disponible | Skeleton | Dimensions, rayon et pulsation ; statique lorsque le mouvement est réduit. | V |
Progress | Disponible | Progress | Remplissage borné animé/interruptible, maximum, attente indéterminée et valeur accessible. | V |
EmptyState | Disponible | EmptyState | Icône, titre, description, action et mode compact dans un composant public. | L3 |
ErrorState | Disponible | ErrorState | Erreur de requête, message, action et réessai asynchrone verrouillé ; distinct de la boundary de page. | L3 |
AsyncState | Disponible | AsyncState | Chargement, vide, erreur, réessai et actions de repli composés avec StateScreen. | V |
Dates, heures et agendas
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Calendar | Disponible | Calendar | Calendrier SIA tactile, locale, année recherchable, jours indisponibles et fondu de mois ; navigation clavier de bureau à compléter. | V |
DatePicker | Disponible | DatePicker | Jour civil contrôlé, bornes et brouillon ; mois complet ajusté à la feuille sans défilement interne. | V |
DateTimePicker | Disponible | DateTimePicker | Date/heure en étapes avec brouillon commun. Fuseau métier et heure d’été restent applicatifs sur les deux plateformes. | V |
DateRangePicker | Disponible | DateRangePicker | Début/fin, ordre et bornes, remise au début si le second choix est antérieur ; validation métier des jours intérieurs externe. | V |
TimePicker | Disponible | TimePicker | Heure HH:mm, bornes, pas de minutes et affichage 12/24 h ; contrôle SIA en feuille. | V |
TimeRangePicker | Disponible | TimeRangePicker | Deux heures sur roues, brouillon, confirmation, limites, pas de minutes et franchissement de minuit explicite. | L4 |
MonthPicker | Disponible | MonthPicker | Mois civil YYYY-MM, année navigable, bornes, lecture seule et brouillon annulable. | L4 |
WeekPicker | Disponible | WeekPicker | Valeur ISO YYYY-Www, semaine lundi–dimanche visible, contrôle des années ISO et bornes sur toute la semaine. | L4 |
YearPicker | Disponible | YearPicker | Années bornées 1–9999, sélection virtualisée, confirmation et lecture seule. | L4 |
MiniCalendar | Disponible | MiniCalendar | Composition compacte du Calendar natif ; thèmes, bornes, sélection et semaine commune. | L4 |
EventCalendar | Disponible | EventCalendar | Mois avec liste du jour, semaine/jour/agenda chronologiques, périodes et événements multi-jours headless ; pas de déplacement horaire par glisser. | L5 |
EventManager | Disponible | EventManager | Agenda par jour avec Calendar, liste, détail, création/modification et suppression confirmée ; erreurs serveur et permissions injectées. EventCalendar fournit les vues mobiles en listes chronologiques. | L5 |
DateRangeFilter | Disponible | DateRangeFilter | Période contrôlée, raccourcis, bornes, lecture seule et remise à zéro via callback. | L4 |
Listes, données et écrans métier
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
Resource | Disponible | ResourceDefinitionCore et defineResource natif | Métadonnées, permissions et sources partagées ; formulaires et renderers natifs dédiés. Séparer le rendu DOM du rendu natif est volontaire. | V |
CrudPage | Disponible | CrudPage natif | Liste, fiche, création/édition et suppression confirmée, droits et garde de saisie injectable ; pas de parité intégrale des props web. | V |
DataTable | Disponible | DataTable / ResourceList | Colonnes sur tablette, lignes sur téléphone, présentation forcée, tri, pagination, défilement horizontal et sélection globale par allKeys autorisées du résultat filtré. | V |
FiltersBar | Disponible | FiltersBar | Recherche temporisée, filtres simples en feuille, annulation/validation et résumé ; filtres complexes non portés. | V |
Pagination | Disponible | Pagination | Variantes compacte/numérotée et total ; pas de curseurs ou chargement infini. | V |
Descriptions | Disponible | Descriptions | Paires libellé/valeur verticales ou en ligne, rendus natifs personnalisables. | V |
EntityMeta | Disponible | EntityMeta | Statut, identifiant sélectionnable, auteurs et dates relatives ; variantes verticales/en ligne. | V |
AuditMeta | Disponible | AuditMeta | Événements, auteurs, détails, dates et état vide ; la source et la fiabilité du journal restent applicatives. | V |
Statistic | Disponible | Statistic | Nombre/devise/pourcentage, tailles, tendance et sens favorable configurables ; transition réduite selon la préférence système. | V |
StatCard | Disponible | StatCard | Contour/douce/accentuée, action, description, chargement et erreur réessayable. | V |
KpiGrid | Disponible | KpiGrid | Colonnes adaptées à la largeur intérieure mesurée ; pas de moteur de graphiques. | V |
AmountDisplay | Disponible | AmountDisplay | Devise, signe et locale partagés, tons et valeur absente. | V |
RelativeTime | Disponible | RelativeTime | Rafraîchissement actif, pause en arrière-plan et reprise immédiate ; date complète accessible. | V |
DurationDisplay | Disponible | DurationDisplay | Formats court/long/horloge ; textStyle natif séparé du style de formatage. | V |
Timeline | Disponible | Timeline | Ligne/cartes, repères, densité, inversion, attente et actions ; liste non virtualisée. | V |
Tree | Disponible | Tree | Expansion, recherche de chemins, sélection indépendante simple/multiple, disabled hérité ; cascade et clavier de bureau complet prévus. | V |
TreeSelect | Disponible | TreeSelect | Brouillon en feuille, recherche intégrée, chemins, validation/annulation et variantes de champ ; branches distantes prévues. | V |
Transfer | Disponible | Transfer | Résumé et brouillon en feuille avec recherche, confirmation/annulation et protection des clés verrouillées/inconnues. | L5 |
Chart | Disponible | Chart | Courbe, aire et barres SVG natives ; légende, sélection au toucher et lecture par boutons. Pas de zoom ou axes secondaires. | L5 |
QrCode | Disponible | QRCode | Encodeur UTF-8 local, SVG, zone calme et correction ; partage de valeur natif ou export SVG injecté. | L5 |
Éditeurs, supervision et outils spécialisés
| Module web | Statut mobile | Équivalent ou base actuelle | Écart réel / adaptation utile | Lot |
|---|---|---|---|---|
JsonView | Disponible | JsonView | Arbre dépliable borné en profondeur/nœuds, cycles, source invalide, virtualisation ou intégration sans défilement et copie injectable avec erreur réessayable. | L5 |
JsonEditor | Disponible | JsonEditor | Texte JSON, valeur analysée, erreur rouge, formatage au blur et clavier multiligne. | L5 |
MarkdownEditor | Disponible | MarkdownEditor | Écriture multiligne et aperçu injectable ; comme sur le web, aucun moteur Markdown imposé. | L5 |
RichTextEditor | Disponible | RichTextEditor et NativeRichTextProvider | Surface injectable, gras/italique/liste, HTML ; adaptateur WebView Android/iOS optionnel livré dans une entrée séparée, exemple navigateur dédié. | L5 |
ActivityLog | Disponible | ActivityLog | Journal virtualisé composant ResourceList, requête externe, recherche, filtres, pagination, états et actualisation ; aucun filtrage serveur implicite. | L5 |
LogStream | Disponible | LogStream | Liste bornée et virtualisée, pause/suivi, filtres et gel en arrière-plan ; transport réseau externe. | L5 |
JobProgress | Disponible | JobProgress | Statut, progression déterminée/indéterminée, étapes, essais, durée et actions asynchrones verrouillées ; erreur réessayable. | L5 |
LiveIndicator | Disponible | LiveIndicator | Connexion en cours/ouverte/fermée, libellés, mode compact, animation réduite et arrêt du mouvement en arrière-plan. | L5 |
Timer | Disponible | Timer | Sens montant/descendant, pause, reprise, changement de durée et calcul sur horodatage ; arrêt des intervalles en arrière-plan et fin unique. | L5 |
Countdown | Disponible | Countdown | Contrat Timer descendant, durée et fin unique ; rattrapage au retour au premier plan. | L5 |
ResizablePanel | Disponible | ResizablePanel | Panneaux ajustables sur tablette avec poignée et boutons ; empilement ou onglets sur téléphone. | L5 |
Briques natives sans module web du même nom
Ces ajouts ne doivent pas être comptés comme des modules web supplémentaires. Ils répondent à des usages mobiles ou regroupent plusieurs responsabilités web.
| API native disponible | Relation avec le web | Ce qui reste à distinguer |
|---|---|---|
| SiaNativeProvider, NativeThemeScope, useNativeTheme | Thème, locale et tokens communs | Distribution Uniwind, zones de portail et polices ; pas une API DOM interchangeable. |
| BottomBar | Navigation principale mobile ; pas d’export BottomBar web dans l’inventaire | Capsule/trait/minimal, styles, couleurs, badges, Plus et animations configurables sont livrés ; cela ne remplace pas Tabs dans une page. |
| BottomSheet | Besoin proche d’un Drawer web positionné en bas | Hauteur contrôlée, fermeture par poignée et primitives Modal sont livrées ; snap points et actions d’accessibilité par poignée sont livrés ; déplacement sur le contenu du ScrollView interne livré : tirer vers le bas à son début, ou vers le haut pour agrandir un snap point. Les listes virtualisées personnalisées gardent la poignée comme contrôle du geste. |
| FormContainer, FormSection, KeyboardScrollView | Conteneur, regroupement et saisie libre avec clavier | Validation via FormAdapter et verrou d’envoi présents ; Form/Field génèrent et lient tous les types web et les extensions de dates natives ; le HTML utilise un adaptateur explicite. |
| StateScreen | Présentation commune de plusieurs états de page | 404, refus, attente et action de reprise possibles ; AsyncState compose maintenant ces états pour les requêtes. |
| SiaExpoStack, SiaExpoLayout | Navigation protégée sur le SessionStore existant | Groupe privé, permission de route et retrait d’historique ; entrée optionnelle @sia-ui/react-native/expo-router. |
| useExpoSessionReturn, SiaExpoErrorBoundary | Reprise de route et erreur d’écran | Retour interne après connexion et réessai sont livrés ; aucune session parallèle n’est créée. |
Fondations partagées : réutiliser, pas annoncer un rendu absent
| Socle existant | Réutilisation possible | Limite actuelle |
|---|---|---|
| Tokens de couleur, espacement, typographie et mouvement | Même identité, thèmes et vocabulaire de mouvement | Les animations et les composants restent des implémentations propres à chaque plateforme. |
| SessionStore, useSession et règles d’accès headless | Même session pour la navigation, l’expiration et les droits | Le stockage des secrets et les appels d’authentification réels restent ceux de l’application ; la démo native est locale. |
| FormAdapter, useLocalForm et validation partagée | Même contrat de valeurs/erreurs, validation asynchrone selon l’adaptateur | FormContainer ne génère pas les champs et n’injecte pas automatiquement disabled dans ses enfants. |
| Arbres de navigation, disclosure, pagination, recherche différée, accordéon et slider headless | Réutiliser les calculs et états sans DOM | L’existence du hook ne livre ni la gestuelle ni le composant natif correspondant. |
| Toast store et logique de temps réel | Réutiliser des annonces ou statuts | Toast contrôlé et Toaster connecté au store sont disponibles ; cycle de vie et empilement à valider sur appareil. |
| Utilitaires de montants, dates, téléphones et validation | Éviter de réécrire le formatage et les règles métier | Ne signifie pas qu’un champ ou un composant d’affichage natif existe. |
| Module API partagé | Brancher une application mobile à ses services | L’intégration réelle avec stockage, réseau et session doit être vérifiée dans l’application consommatrice. |
| Définition de ressource | Contrat commun de métadonnées avec adaptateurs de champs | Métadonnées et permissions extraites dans headless ; adaptateurs de champs propres au web et au natif. |
Le package natif ne doit pas importer les rendus de @sia-ui/react-web. Un contrat commun doit vivre dans une couche sans DOM ; les valeurs métier et la session peuvent être communes tout en gardant des interfaces adaptées au téléphone.
Écarts transversaux à suivre
Ces points ne sont pas des modules supplémentaires et ne changent pas les comptes ci-dessus. Ils concernent plusieurs composants à la fois.
| Sujet | Existant | Travail restant / priorité |
|---|---|---|
| Configuration par défaut | SiaNativeProvider transmet defaults au provider headless | Button, Badge, Spinner, Alert, Avatar, Skeleton, Progress, Steps, Tabs, Accordion, Input, Select, MultiSelect, Autocomplete, Calendar, ResourceList, Popover, DropdownMenu, Tree, TreeSelect, BulkActionBar et les neuf briques d’affichage métier lisent leurs clés locales. Généralisation aux autres composants encore prévue ; ne pas annoncer une couverture globale. |
| Langues | Provider et plusieurs composants utilisent la locale partagée | Certains textes de l’adaptateur Expo et de la démo sont directement en français ; compléter l’internationalisation des textes de bibliothèque en L1/L2. |
| Personnalisation | Tokens, palettes locales et réglages détaillés de navigation | Les variantes, slots et props de personnalisation ne sont pas uniformes entre composants ; les vérifier lors de chaque portage. |
| Gestes et focus | Pressable, Animated, poignée PanResponder, premières annonces d’accessibilité | Focus initial/restauré, conflits de gestes, clavier et grands textes : validation V puis amélioration par composant. |
| Empilement des couches | Modal, BottomSheet et tiroir ont des implémentations natives | Vérifier les ouvertures imbriquées, le Retour et les annonces ; ne pas déduire la parité des garanties d’overlay DOM. |
| Distribution | Package natif, thème Uniwind et entrée Expo optionnelle | La CLI de copie des composants web ne distribue pas encore ces rendus natifs. Compatibilité annoncée limitée aux versions documentées du socle, pas à tout projet Expo/React Native. |
Ordre de réalisation et avancement
| Lot | Travail et avancement | Utilité et critère de sortie |
|---|---|---|
| V — Consolider l’existant | Tester navigation, champs, clavier, zones sûres, Retour, expiration, 404 et mouvement réduit sur Android/iOS | Documenter appareil, système et révision ; fermer les anomalies observées sans présenter les exports comme des tests sur téléphone. |
| L1a — États et petites briques | Socle livré : Badge, Avatar, Alert, Spinner, Skeleton, Progress, Divider, IconButton, parties Card, variantes Text et Toaster ; compléter les variantes et défauts transversaux | Construire un écran cohérent sans recréer les messages, les chargements ni une seconde API de notifications. |
| L1b — Organisation d’écran | Livré : Steps, Tabs de contenu et Accordion ; compléter le clavier externe et les validations sur appareil | Démontrer un formulaire en étapes avec états current/done/upcoming/error, navigation contrôlée, sections et annonces accessibles. La validation métier reste dans le formulaire. |
| L1c — BottomSheet avancée | Livré : positions d’arrêt, hauteur bornée, poignée, durée, actions d’accessibilité, agrandissement au clavier et entraînement par le contenu du ScrollView interne | Démontrer une sélection longue et un formulaire sans conflit de gestes, avec mouvement réduit. La poignée reste disponible pour les listes virtualisées personnalisées ; nouveaux gestes à repasser sur appareil. |
| L2 — Formulaires complets | Socle livré : Field/Form, Select distant, MultiSelect, champs spécialisés, confirmation et protection Expo ; champs avancés livrés ; nouveaux contrôles à repasser sur appareil | Démontrer saisie, recherche annulable, erreurs rouges, double envoi bloqué et abandon confirmé ; conserver focus, valeur et position lors des rendus. |
| L3 — Parcours métier | Contrat Resource sans DOM, liste/cartes virtualisées, filtres, pagination, détail et édition ; état asynchrone commun | Démontrer un parcours liste → détail → modification avec droits, actualisation, vide/erreur/réessai et conservation des filtres. Socle Contacts testé par l’utilisateur ; DataTable et sélection globale ajoutés dans ce lot. |
| L4 — Dates et fichiers | Socle livré : calendrier, date/heure/période, sélection documents/images ; couleur livrée ; transfert réseau applicatif comme sur le web, nouveaux contrôles à repasser sur appareil | Valider valeurs, bornes, locale/fuseau selon le contrat, permissions système et annulation sur appareil. Choisir les dépendances compatibles avec Expo. |
| L5 — Besoins spécialisés | Arbres, éditeurs, agenda, journal et suivi livrés ; 13 adaptations mobiles livrées, dont graphiques SVG, agenda multivue et journal borné | Implémenter à partir d’un usage identifié ; ne pas reproduire automatiquement chaque interaction de bureau sur téléphone. |
Les lots sont découpables. L1a ne doit pas bloquer un premier Steps ou une amélioration ciblée de BottomSheet ; les dépendances réelles déterminent le détail des incréments. L5 constitue une réserve de besoins à arbitrer, pas un engagement de porter l’intégralité du catalogue web à l’identique.
Critères communs à chaque composant porté
- Conserver l’identité SIA : tokens, clair/sombre, couleurs personnalisées, messages d’erreur rouges et mêmes états sémantiques utiles.
- Garder une API contrôlée cohérente avec le headless ; documenter les différences d’événements, refs et interactions propres à React Native.
- Vérifier cibles tactiles, noms et valeurs accessibles, focus, grands textes, lecteur d’écran et navigation avec clavier externe lorsque pertinente.
- Préserver la saisie et le défilement ; vérifier clavier logiciel, Retour Android, liens directs et cycle de vie de l’app lorsque le composant les utilise.
- Respecter la réduction des animations, interrompre proprement les transitions et exposer les réglages utiles sans imposer des animations à l’application.
- Ajouter des tests de comportement utiles, une démonstration et la documentation du même changement. Consigner séparément compilation et validation sur appareil.
Maintenance de la matrice
À chaque ajout ou changement de responsabilité publique : mettre à jour la ligne, son statut, les écarts encore présents et les preuves de validation. Ajouter une ligne lorsqu’un module web public apparaît ; mettre les API uniquement natives dans leur section dédiée. Le backlog indique précisément ce qui est effectivement livré ; cette matrice conserve aussi les besoins prévus.
Ne pas marquer un composant Disponible uniquement parce qu’il utilise le même nom, qu’une démo ressemble au web ou qu’un hook existe dans headless. En cas de nouveau sous-composant ou d’option majeure, reprendre l’examen du contrat avant de modifier son statut.
Le guide du lot présentation et organisation décrit les APIs livrées, les menus de la démo et les limites de gestes restantes.
Le guide listes et parcours métier décrit les APIs et les limites du socle L3 livré.
Le guide affichage métier mobile précise les variantes et les limites du tableau de bord et de l’historique.
Le guide actions et sélection mobiles décrit les menus, arbres et actions groupées, avec leurs limites.