Skip to content

Architecture ​

Organisation ​

text
sia-ui/
├── packages/
│   ├── tokens/      # valeurs visuelles, thèmes et vocabulaire de rendu
│   ├── utils/       # helpers transverses importables à la carte
│   ├── api/         # client HTTP et temps réel, sans React ni DOM
│   ├── realtime-server/ # passerelle, contrats et réservations, sans transport imposé
│   ├── headless/    # logique de composant sans rendu
│   ├── react/       # fondations React partagées
│   ├── react-web/   # les composants web, source unique
│   ├── registry/    # catalogue et sources copiables
│   └── cli/         # commandes init, list et add
└── docs/            # documentation d'architecture, et le site qui la publie

Graphe des dépendances ​

Une dépendance inverse est interdite. Par exemple, tokens ne peut pas importer React, et headless ne peut pas importer un composant de react-web.

Responsabilités ​

@sia-ui/tokens ​

Contient les couleurs, espacements, rayons, ombres et thèmes sémantiques. Il ne dépend ni du DOM ni de React et peut donc servir à plusieurs moteurs de rendu.

@sia-ui/headless ​

Contient la logique de composant sans son rendu : magasins hors de React (annonces, session), contrat de formulaire, et crochets d'état réutilisables entre le web et un futur moteur natif.

@sia-ui/api ​

Contient le client HTTP typé, ses greffons de transport et ses services de ressource. Il ne dépend ni de React, ni du DOM, ni des tokens, et s'installe seul.

@sia-ui/utils ​

Contient les helpers transverses réutilisés entre produits : classes CSS, formatage de montants, dates, nombres et chaînes de caractères. Il reste indépendant de React pour pouvoir être utilisé aussi bien dans le registre que dans les applications.

@sia-ui/react ​

Contient uniquement les mécanismes React réellement partagés : SiaProvider, portail, état contrôlé/non contrôlé, disclosure et fusion de références.

@sia-ui/react-web ​

Contient les composants web eux-mêmes — source unique de leur code et de leur CSS. C'est ce paquet que le registre sert, fichier pour fichier.

@sia-ui/registry ​

Décrit les composants installables et conserve leurs fichiers sources. Une entrée indique son type, ses fichiers et ses dépendances envers d'autres entrées.

@sia-ui/cli ​

Lit le registre, résout les dépendances transitives et copie les fichiers dans l'application. Elle n'écrase pas un fichier existant.

Frontières ​

SIA UI peut accepter un queryFn ou des données, mais ne doit pas connaître une URL d'API, une entité métier ou une règle d'autorisation propre à un produit.

@sia-ui/realtime-server ​

Paquet indépendant du rendu et sans dépendance de production. Il expose des formes structurelles pour le transport, le broker, le journal de reprise et les réservations atomiques. Les adaptateurs de l’application fournissent leurs implémentations ; les exemples NestJS restent dans la documentation. Les contrats de sujets et salons peuvent être partagés sans importer un framework serveur.

Rendu React Native — prototype expérimental ​

Uniwind compile les styles du premier lot @sia-ui/react-native. Les tokens génèrent le thème ; les comportements headless restent partagés. La démonstration Expo intègre Button, Input, Card, Modal et Toast avec animations natives et un formulaire local. La compilation Android/iOS/web est vérifiée ; la validation sur appareils reste à faire. Voir le guide mobile et la décision technique.

Le socle mobile comprend aussi BottomBar, Sidebar, AppShell et les gardes reliées au SessionStore headless. Expo Router est isolé dans le sous-chemin optionnel @sia-ui/react-native/expo-router. Le build de cet adaptateur réutilise le runtime public du package afin de ne pas créer une deuxième instance des contextes de thème/configuration, tout en résolvant ses types depuis les sources lors d’un build à neuf. Les providers utilisent des variables Uniwind locales ; les portails rétablissent leur scope. Voir le guide navigation/session.

Publié sous licence MIT.