Premier socle React Native
Prototype expérimental. Le premier lot existe : SiaNativeProvider, Text, Button, Input, Card, Modal, Toast, Checkbox, Switch, RadioGroup, PasswordInput, BottomSheet, Select, FormContainer, FormSection, BottomBar, Sidebar, AppShell, RequireSession et StateScreen. Le lot de présentation et organisation ajoute notamment Badge, Avatar, Alert, Spinner, Skeleton, Progress, Steps, Tabs, Accordion et Toaster. Il ne remplace pas encore tout le catalogue web. La matrice de couverture détaille chaque module, ses écarts et les priorités proposées. Les interactions tactiles et lecteurs d’écran sur appareils restent à valider avant une utilisation en production.
Essayer dans le dépôt
Depuis la racine, avec Node 24.3 ou supérieur dans la branche 24 (ou Node 22.13+), et pnpm 10.26.2 :
pnpm install --frozen-lockfile
pnpm nativeLa commande construit les packages partagés puis démarre Expo. Le terminal propose Android, iOS ou web. Un simulateur ou appareil compatible avec ce SDK Expo est nécessaire pour les plateformes natives ; le navigateur ne valide pas leur rendu. Le simulateur iOS nécessite macOS et Xcode. Un client de développement doit être reconstruit si ses dépendances natives changent.
pnpm native:export
pnpm --filter @sia-ui/react-native testnative:export compile les bundles Android, iOS et web, sans installer une app, sans créer un APK/IPA et sans publier sur un store. La démo propose des pages Expo Router avec compte local, galerie, formulaires, navigation, personnalisation, session et permissions. Aucun identifiant n’est envoyé à un service externe. Voir le guide navigation et session.
Versions utilisées ensemble
| Dépendance | Version de la démo |
|---|---|
| Expo | 58.0.23 |
| React / React Native | 19.3.0 / 0.88.1 |
| Uniwind / Tailwind CSS | 1.13.1 / 4.3.3 |
| react-native-safe-area-context | 5.11.1 |
| react-native-svg | 15.16.0 |
| react-native-web | 0.21.4 |
| qrcode-generator (pair JavaScript) | 2.0.4 |
La base vient du template officiel expo-template-blank-typescript@58.0.32. La démonstration conserve TypeScript 6 du template officiel ; les autres packages et la documentation déclarent leur compilateur TypeScript 5.9 explicitement. Ces versions constituent la matrice du prototype ; les anciennes versions Expo ne sont pas annoncées compatibles. L’application fournit les dépendances natives.
Styles et configuration
packages/react-native/scripts/build-theme.mjs génère les couleurs sémantiques clair/sombre, espacements, rayons, typographie et mouvement à partir des tokens. Le preset NativeWind existant reste indépendant de cette intégration Uniwind. Les classes sont statiques pour être détectées pendant la compilation.
Dans une application consommatrice, configurer Metro :
const { getDefaultConfig } = require('expo/metro-config');
const { withUniwindConfig } = require('uniwind/metro');
module.exports = withUniwindConfig(getDefaultConfig(__dirname), {
cssEntryFile: './global.css',
dtsFile: './uniwind-types.d.ts',
polyfills: { rem: 16 },
});Importer la feuille au point d’entrée :
@import "tailwindcss";
@import "uniwind";
@import "@sia-ui/react-native/theme.css";
@source "./node_modules/@sia-ui/react-native/src";Adapter @source à l’emplacement réel du package ; la démo utilise le chemin workspace ../../packages/react-native/src. Construire le package avant Metro pour disposer de theme.css. Les imports React Native sont transformés par Uniwind : le point d’entrée natif conserve les sources distribuées à cet effet.
Charger les polices Inter et Inter-Semibold avant d’afficher les composants (voir apps/native-demo/app/_layout.tsx), puis envelopper l’application :
import { SafeAreaProvider } from 'react-native-safe-area-context';
import { SiaNativeProvider, Button, Card } from '@sia-ui/react-native';
<SafeAreaProvider>
<SiaNativeProvider mode="system">
<Card title="Bienvenue">
<Button onPress={() => { /* action native */ }}>Continuer</Button>
</Card>
</SiaNativeProvider>
</SafeAreaProvider>Le provider fournit un thème local via ScopedTheme, la locale et les valeurs par défaut headless. mode accepte system, light et dark. Les composants utilisent leurs props natives : onPress, onChangeText, keyboardType, refs TextInput et informations d’accessibilité, sans convertir des props DOM.
Comportements disponibles et utilité
| API | Comportement et utilité |
|---|---|
Text | Corps, titre, légende et couleur atténuée ; conserver la hiérarchie SIA avec le grossissement natif du texte. |
Button | Variantes solid/outline/ghost, tons primary/danger, tailles sm/md/lg, cibles d’au moins 48 unités, état loading désactivant l’action ; éviter les doubles validations. |
Input | Label permanent, aide, erreur, ref native et anneau de focus animé ; saisir sans perdre le curseur et en conservant les réglages du clavier. |
Card | Titre, description, espacement, bordure et surface sémantiques ; organiser une interface mobile avec les mêmes repères que le web. |
Modal | État contrôlé, contenu défilant, zones sûres, évitement du clavier et demande de fermeture Retour Android ; confirmer une action sans masquer la saisie. |
Toast | État contrôlé, tons sémantiques, annonce accessible et fermeture ; conserver le temps de lecture en arrière-plan. |
Modal expose footer, dismissible, closeLabel et nativeModalProps pour adapter le conteneur natif. Son titre reçoit une demande de focus d’accessibilité à l’ouverture native. Toast accepte durationMs (5000 par défaut, 0 pour une fermeture explicite) ; un lecteur d’écran suspend la fermeture automatique. Le délai restant reprend au retour au premier plan. Le parent contrôle open et doit appliquer onOpenChange pour fermer effectivement la couche.
Animations
Le moteur est Animated de React Native, sans dépendance Reanimated pour ce lot. Les courbes et durées viennent des tokens partagés : appui du bouton (80 ms), focus du champ, entrée et sortie de modale et notification. Opacité et translation utilisent le pilote natif ; une transition interrompue repart de sa valeur courante. reduceMotion peut forcer une présentation immédiate. false ne neutralise jamais la préférence d’accessibilité du système ; celle-ci est également suivie à chaud. Le glissement de la poignée de BottomSheet est implémenté avec PanResponder et un retour Animated. Le suivi du doigt est piloté en JavaScript ; aucune revendication de performance de gestes sur appareil n’est faite sans ces essais. Les positions intermédiaires par poignée sont disponibles dans le lot de composants mobiles. Les gestes sur tout le contenu et les gestes de navigation restent prévus.
Validation et limites
Les tests de comportement utilisent le preset Jest React Native ; Uniwind et les zones sûres y sont simulés. Ils vérifient états, callbacks, saisie, reprise du délai, réouverture et mouvement réduit. Ils ne prouvent pas le rendu visuel natif. Les exports Metro/Hermes Android et iOS et l’export web vérifient la compilation. Le contrôle navigateur vérifie l’aperçu web et ses interactions.
À valider sur Android et iOS : clavier logiciel et champs dans les modales, Retour Android, découpes d’écran, VoiceOver/TalkBack et ordre/restauration du focus, grandes tailles de texte, contraste et ombres réelles, fluidité des animations et changements système pendant l’utilisation. Aucun test sur téléphone physique ou émulateur natif n’est revendiqué par ces contrôles de compilation.
Suite prévue : durcir les essais sur appareils et les parcours métier. La navigation, les états de page et l’adaptateur Expo Router sont implémentés ; leur configuration est décrite dans le guide dédié. La CLI de copie et les patterns web ne distribuent pas encore ces composants natifs.
Formulaires mobiles et erreurs rouges
Le guide des formulaires mobiles détaille FormContainer, FormSection, les nouveaux champs, le Select et la BottomSheet. Tous les messages d’erreur de champ et le résumé utilisent colors.danger explicitement : le rouge sémantique suit le thème et s’accompagne toujours d’un message accessible.
Listes et parcours métier
ResourceList, CrudPage, FiltersBar, Pagination, PageHeader, Descriptions, PermissionGate et AsyncState composent le nouveau parcours Contacts : recherche, filtres, tri, actualisation, détail et formulaire avec droits et erreurs serveur. La démo conserve les contacts localement et propose les états de simulation. Voir le guide du lot listes et parcours métier.
Affichage métier et indicateurs
Statistic, StatCard, KpiGrid, EntityMeta, AuditMeta, Timeline et les affichages de montants/durées/dates relatives complètent le socle. La démo Contacts propose un tableau de bord sur toute la collection et un historique local des écritures. Voir le guide affichage métier mobile.
Actions et sélection avancée
Popover, DropdownMenu/ContextMenu, Tree/TreeSelect et BulkActionBar complètent les listes natives. La démo propose une page Actions et sélection et des actions groupées persistées dans Contacts. Voir le guide actions et sélection.
Catalogue de tous les composants
Composants → Tous présente les aperçus, les statuts, une recherche par nom ou alias et des filtres par famille. Les exemples détaillés et parcours restent liés depuis chaque fiche. Voir le guide du catalogue mobile.
Nouveaux modules du catalogue
Le guide des nouveaux composants décrit les périodes, secrets, permissions, agenda, journal et suivi. BrandIcon ajoute le peer react-native-svg (15.16.0 pour le socle Expo 58 de la démo). Dans un projet Expo, installer avec npx expo install react-native-svg et respecter la matrice de versions. Les modules de copie et services restent injectés par l’application.