@sia-ui/registry 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -10,6 +10,81 @@ vérifie, et la CI le lance. Sans quoi une entrée monterait de version sans
 que personne ne puisse savoir ce qui a changé dans le fichier qu'il a déjà
 chez lui.
 
+## 0.3.1
+
+### Patch Changes
+
+- Expose public contribution flow on npm
+
+## 0.3.0
+
+### Minor Changes
+
+- Une ressource se déclare une fois, cinq composants refondus, et une
+  documentation qui décrit le produit plutôt que son développement.
+
+  ## Déclarer une ressource
+
+  `defineResource` décrit un objet métier **une seule fois**. Les colonnes du
+  tableau, les champs du formulaire, les lignes de la vue de détail, la
+  validation, les clés de recherche et les quatre règles de droits en sont
+  dérivés — et chaque dérivation reste remplaçable par la prop correspondante.
+
+  ```tsx
+  <CrudPage resource={FACTURE} data={factures} can={can}
+            onSubmit={…} onDelete={…} />
+  ```
+
+  Le rendu se déduit du type : un `currency` s'affiche formaté et aligné à
+  droite, un `select` avec ses `tones` devient une pastille, une `date` passe
+  par le format local. `permissions: "auto"` applique la convention
+  `<nom>.<verbe>`.
+
+  ## Les quatre opérations ouvrent leurs propres boîtes
+
+  `CrudPage` n'appelle plus seulement un gestionnaire : déclarer `fields` et
+  `onSubmit` suffit à obtenir un formulaire vide en création, le même prérempli
+  en modification, et une vue de détail. `onCreate`, `onEdit` et `onView`
+  restent la porte de sortie vers une page dédiée — fournis, ils passent devant
+  la boîte.
+
+  Les boîtes n'inventent rien : `Modal` pour la boîte, `Form` pour la saisie,
+  `Descriptions` pour la lecture.
+
+  ## Cinq composants refondus
+  - **`Sidebar`** — le rail réduit n'enferme plus ses sous-menus : ils sortent
+    en volet. Profondeur illimitée, droits en cascade, trois variantes.
+  - **`AppShell`** — se branche sur n'importe quel routeur par une seule
+    chaîne, l'adresse courante. Trois états de barre, tiroir ou onglets bas sur
+    mobile, filtrage des droits fait une seule fois.
+  - **`Avatar`** — teinte dérivée du nom, repli peint sous l'image, quatre états
+    de présence, et des piles qui résument leur surplus.
+  - **`DataTable`** — actions de ligne avec droits et confirmation, sélection et
+    barre groupée, vue en cartes, trois densités, états de chargement, d'erreur
+    et de vide.
+  - **`CrudPage`** — réécrit : il tenait en neuf lignes et n'offrait aucune des
+    quatre opérations qui lui donnent son nom.
+
+  ## Ruptures
+  - `CrudPage` : `actions` portait des nœuds d'en-tête, ils vont dans
+    `headerActions`. `data` est requis, et `columns` l'est aussi à moins qu'une
+    `resource` ne les fournisse.
+  - `Sidebar` et `AppShell` : les props ont changé. Voir
+    [La navigation latérale](https://beatjo.github.io/sia-ui-site/guides/navigation)
+    et [La coquille d'application](https://beatjo.github.io/sia-ui-site/guides/coquille-application).
+
+  ## Documentation
+
+  Les cent trois composants ont désormais une page de référence — ce qu'ils
+  font, comment les installer, et **toutes** leurs props avec type et valeur par
+  défaut. Ces pages sont écrites par le code : les props viennent des types, les
+  descriptions de leurs commentaires, la commande d'installation du registre.
+
+  Le catalogue est passé de seize sections en deux langues à neuf, ordonnées du
+  plus général au plus assemblé. Les comptes rendus de développement ont été
+  retirés de la documentation : ils décrivaient un chemin parcouru, pas un
+  produit.
+
 ## 0.2.0
 
 ### Minor Changes
@@ -90,6 +165,148 @@ chez lui.
 
 - Include component styles when installing registry components
 
+## 0.2.0
+
+- `resource` — **nouvelle entrée**. Une page de liste décrivait le même objet
+  trois fois : en colonnes pour le tableau, en champs pour le formulaire, en
+  lignes pour le détail. Plus la validation, les clés de recherche et la règle
+  de droits par opération. Ces descriptions divergent, et toujours dans le
+  même sens — c'est le formulaire qui oublie le champ que le tableau affiche.
+
+  `defineResource` la décrit **une seule fois**. Colonnes, champs, détail,
+  validation, recherche, clé de ligne et droits en sont dérivés. Le rendu se
+  déduit du type : un `currency` s'affiche formaté et aligné à droite, un
+  `select` avec ses `tones` devient une pastille, une `date` passe par le
+  format local.
+
+  Trois surfaces, trois défauts : `inTable` écarte ce qui est trop long pour
+  une cellule, `inForm` écarte ce que `readOnly` marque, `inDetail` garde
+  tout. Le détail n'est donc pas le tableau — une note de trois phrases sort
+  des colonnes et reste dans la boîte de consultation.
+
+  `permissions: "auto"` applique la convention `<nom>.<verbe>`. Chaque
+  dérivation cède à la prop correspondante : passer `columns` ne coûte ni le
+  formulaire, ni les droits.
+
+- `crud-page` — **réécrit**. Il tenait en neuf lignes : un titre, un
+  emplacement libre et une pagination. Les quatre opérations d'une page de
+  liste étaient à réécrire à chaque écran, ce qui produit quatre variantes
+  qui divergent — celle qui oublie la confirmation, celle qui ne vérifie
+  pas les droits, celle dont le bouton reste actif pendant l'appel.
+
+  Créer, consulter, modifier, supprimer **fonctionnent d'emblée** : fournir
+  le gestionnaire suffit, ne pas le fournir retire l'action. La suppression
+  est confirmée d'office — on peut lever la confirmation, encore faut-il
+  l'avoir écrit.
+
+  `operations` personnalise chaque action : libellé, icône, droits,
+  visibilité ligne par ligne, confirmation. `extraRowActions` en ajoute
+  d'autres, `onBulkDelete` active la sélection et sa barre.
+
+  Sans gestionnaire, les actions **ouvrent leurs propres boîtes** : déclarer
+  `fields` et `onSubmit` suffit à obtenir un formulaire vide en création, le
+  même prérempli en modification, et une vue de détail dérivée des colonnes.
+  `onCreate`, `onEdit` et `onView` restent la porte de sortie vers une page
+  dédiée : fournis, ils passent devant la boîte. `resource` va plus loin et
+  dérive tout d'une seule déclaration.
+
+  **Migration, rupture** : `actions` portait des nœuds d'en-tête; ils vont
+  dans `headerActions`. Le nom `actions` désignerait sinon deux choses
+  différentes selon la version, ce qui est le pire cas — le code compile et
+  se comporte autrement. `data` est désormais requis, et `columns` l'est
+  aussi à moins qu'une `resource` ne les fournisse; le tableau reste
+  remplaçable par `children`.
+
+- `data-table` — refonte. Il affichait des colonnes et un tri délégué.
+  S'ajoutent les **actions de ligne** — avec droits, confirmation, et
+  passage en menu au-delà de la limite —, la **sélection** et sa barre
+  d'actions groupées, une **vue en cartes** qui bascule d'elle-même sous
+  768 px, la recherche locale, trois densités, les états de chargement,
+  d'erreur et de vide.
+
+  Les actions de ligne s'estompent hors survol : une colonne pleine de
+  boutons attire l'œil plus que les données. Elles restent entières au
+  clavier et sur tactile, où il n'y a pas de survol.
+
+  **Migration, rupture** : `align` passe de `left`/`right` à `start`/`end`,
+  et `getRowKey` devient facultatif. `useDataTableQuery` et
+  `createUrlTableStorage` sont inchangés.
+
+- `app-shell` — **réécrit**. Il tenait en six lignes : une grille à deux
+  colonnes, un bouton de repli écrit `☰`, et des emplacements libres. Il ne
+  réutilisait ni la navigation, ni le tiroir, ni rien.
+
+  Il assemble maintenant le `Sidebar` et le `Drawer`, filtre les droits **une
+  seule fois** pour la barre comme pour les onglets, et se branche sur
+  n'importe quel routeur par une seule chaîne :
+
+  ```tsx
+  <AppShell nav={NAV} currentPath={usePathname()} renderLink={…} />
+  ```
+
+  De là il déduit l'entrée courante par le préfixe le plus long — une page
+  `/factures/12/lignes` marque bien `Factures` — et referme le tiroir mobile
+  à chaque navigation, sans jamais importer de routeur.
+
+  S'ajoutent trois états de barre (`expanded`, `collapsed`, `hidden`), trois
+  stratégies mobiles (`drawer`, `tabs`, `both`), `contentWidth`, `side`, les
+  largeurs personnalisables, et `BottomTabs` — qui ne montre que des
+  feuilles, un onglet ouvrant un sous-menu étant un piège tactile.
+
+  **Migration, rupture** : `logo` devient `brand`, `navigation` devient
+  `nav` et prend des données plutôt que des nœuds. `header` est inchangé.
+  Le titre de page n'est pas une prop : le poser dans `page`, avec
+  `PageHeader` — une coquille qui rend le `<h1>` force chaque écran à passer
+  par ses props.
+
+  L'entrée annonçait deux fichiers et une dépendance; elle en annonce
+  maintenant trois et cinq. Copiée telle quelle, elle serait arrivée cassée.
+
+- `avatar` — refonte. Il servait une image, trois tailles et des initiales.
+  S'ajoutent : une **teinte dérivée du nom**, stable d'un écran à l'autre,
+  pour distinguer deux personnes aux mêmes initiales; trois formes et trois
+  variantes (`soft`, `solid`, `outline`); cinq tailles; une pastille de
+  présence à quatre états; et `AvatarGroup`, qui empile et résume son
+  surplus.
+
+  Le repli est désormais peint **sous** l'image plutôt qu'à sa place : la
+  mise en page ne bouge plus entre l'attente, la réussite et l'échec.
+
+  Les initiales prennent la première et la dernière partie du nom, particules
+  écartées : « Jean-Baptiste Kouassi Mbella » donne « JM », « Marie de la
+  Tour » donne « MT ».
+
+  **Migration** : aucune prop retirée. `fallback` accepte maintenant un
+  nœud React et non plus seulement une chaîne.
+
+- `sidebar` — refonte. Trois défauts corrigés :
+
+  **Réduite, la barre enfermait ses sous-entrées.** Une règle forçait le
+  panneau des enfants à une hauteur nulle quel que soit son état : une
+  rubrique à sous-menus devenait inatteignable dès qu'on repliait la barre.
+  Les sous-menus sortent maintenant en volet, au survol ou au clavier.
+
+  **L'arbre s'arrêtait à deux niveaux**, interdits par le type lui-même
+  (`items?: Array<Omit<SidebarItem, "items">>`). Il descend désormais aussi
+  profond que l'arborescence du produit.
+
+  **Aucun filtrage par droits.** `permission` sur une entrée, `can` sur le
+  composant, et une cascade : un parent dont toute la descendance est
+  filtrée disparaît avec elle, sauf `keepWhenEmpty`.
+
+  S'ajoutent `renderLink` pour brancher un routeur sans en dépendre,
+  `openKeys` pour piloter les branches ouvertes, `accordion`, `side`, et les
+  variantes `default` / `filled` / `floating` en trois tailles.
+
+  **Migration** : aucune prop retirée. `registryDependencies` gagne
+  `overlay` — `sia-ui add sidebar --overwrite` l'installe.
+
+## 0.1.1
+
+- `button` — l'entrée n'annonçait que son `index.tsx`. Installé, le bouton
+  arrivait donc sans sa feuille de style. `components/Button/styles.css`
+  rejoint ses fichiers.
+
 ## 0.1.0
 
 Première version des 104 entrées du registre.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Ivan Mbella
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Ivan Mbella
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,35 +1,468 @@
-# @sia-ui/registry
+# @sia-ui/registry
+
+Le catalogue des composants installables par la CLI.
+
+```ts
+import { registry, getRegistryItem } from "@sia-ui/registry";
+```
+
+Chaque entrée porte son `nom`, sa `version`, son `status`
+(`experimental`, `stable`, `deprecated`, `removed`), ses fichiers, ses
+dépendances npm et ses dépendances de registre.
+
+Les fichiers viennent de `@sia-ui/react-web` et sont copiés **sans
+transformation** : il n'y a qu'une implémentation.
+
+Ce paquet sert surtout à la [CLI](https://www.npmjs.com/package/@sia-ui/cli).
+
+## Place dans SIA UI
+
+```
+@sia-ui/tokens      valeurs : couleurs, espacements, mouvement, vocabulaire
+@sia-ui/utils       fonctions sans dépendance
+@sia-ui/api         client HTTP — indépendant de l'interface
+@sia-ui/headless    comportement, avec React, sans plateforme
+@sia-ui/react       primitives de runtime DOM
+@sia-ui/react-web   composants DOM
+@sia-ui/react-native  composants natifs, à venir
+```
+
+Une chose s'écrit au niveau le plus bas où elle a du sens, et une seule fois.
+Voir [la documentation](https://beatjo.github.io/sia-ui-site).
+
+## Contribuer
+
+Le code source principal de SIA UI est privé pour le moment. Les retours publics passent par le dépôt `BeatJo/sia-ui-site` : bugs, demandes de composants, corrections de documentation et questions d'usage.
+
+- Signaler un bug : https://github.com/BeatJo/sia-ui-site/issues
+- Lire la documentation : https://beatjo.github.io/sia-ui-site/
+- Voir la démonstration : https://beatjo.github.io/sia-ui-site/preview/
+
+Les contributions directes au code des packages se font sur invitation dans le dépôt source privé.
+## Journal des changements
+
+Le contenu ci-dessous reprend intégralement `CHANGELOG.md` pour rester visible sur npm.
+
+# Journal du registre
 
-Le catalogue des composants installables par la CLI.
+Les versions des **entrées**, pas celles des paquets. Un composant copié
+cesse de suivre `@sia-ui/react-web` : il vit dans le dépôt de qui l'a
+installé. C'est ce numéro-là, noté dans son `sia-ui.lock.json`, que
+`sia-ui list --outdated` compare.
 
-```ts
-import { registry, getRegistryItem } from "@sia-ui/registry";
-```
+Chaque version d'une entrée doit apparaître ici — `pnpm check:changelog` le
+vérifie, et la CI le lance. Sans quoi une entrée monterait de version sans
+que personne ne puisse savoir ce qui a changé dans le fichier qu'il a déjà
+chez lui.
 
-Chaque entrée porte son `nom`, sa `version`, son `status`
-(`experimental`, `stable`, `deprecated`, `removed`), ses fichiers, ses
-dépendances npm et ses dépendances de registre.
+## 0.3.0
 
-Les fichiers viennent de `@sia-ui/react-web` et sont copiés **sans
-transformation** : il n'y a qu'une implémentation.
+### Minor Changes
 
-Ce paquet sert surtout à la [CLI](https://www.npmjs.com/package/@sia-ui/cli).
+- Une ressource se déclare une fois, cinq composants refondus, et une
+  documentation qui décrit le produit plutôt que son développement.
 
-## Place dans SIA UI
+  ## Déclarer une ressource
 
-```
-@sia-ui/tokens      valeurs : couleurs, espacements, mouvement, vocabulaire
-@sia-ui/utils       fonctions sans dépendance
-@sia-ui/api         client HTTP — indépendant de l'interface
-@sia-ui/headless    comportement, avec React, sans plateforme
-@sia-ui/react       primitives de runtime DOM
-@sia-ui/react-web   composants DOM
-@sia-ui/react-native  composants natifs, à venir
-```
+  `defineResource` décrit un objet métier **une seule fois**. Les colonnes du
+  tableau, les champs du formulaire, les lignes de la vue de détail, la
+  validation, les clés de recherche et les quatre règles de droits en sont
+  dérivés — et chaque dérivation reste remplaçable par la prop correspondante.
 
-Une chose s'écrit au niveau le plus bas où elle a du sens, et une seule fois.
-Voir [la documentation](https://github.com/BeatJo/sia-ui/tree/main/docs).
+  ```tsx
+  <CrudPage resource={FACTURE} data={factures} can={can}
+            onSubmit={…} onDelete={…} />
+  ```
 
-## Licence
+  Le rendu se déduit du type : un `currency` s'affiche formaté et aligné à
+  droite, un `select` avec ses `tones` devient une pastille, une `date` passe
+  par le format local. `permissions: "auto"` applique la convention
+  `<nom>.<verbe>`.
 
-MIT
+  ## Les quatre opérations ouvrent leurs propres boîtes
+
+  `CrudPage` n'appelle plus seulement un gestionnaire : déclarer `fields` et
+  `onSubmit` suffit à obtenir un formulaire vide en création, le même prérempli
+  en modification, et une vue de détail. `onCreate`, `onEdit` et `onView`
+  restent la porte de sortie vers une page dédiée — fournis, ils passent devant
+  la boîte.
+
+  Les boîtes n'inventent rien : `Modal` pour la boîte, `Form` pour la saisie,
+  `Descriptions` pour la lecture.
+
+  ## Cinq composants refondus
+  - **`Sidebar`** — le rail réduit n'enferme plus ses sous-menus : ils sortent
+    en volet. Profondeur illimitée, droits en cascade, trois variantes.
+  - **`AppShell`** — se branche sur n'importe quel routeur par une seule
+    chaîne, l'adresse courante. Trois états de barre, tiroir ou onglets bas sur
+    mobile, filtrage des droits fait une seule fois.
+  - **`Avatar`** — teinte dérivée du nom, repli peint sous l'image, quatre états
+    de présence, et des piles qui résument leur surplus.
+  - **`DataTable`** — actions de ligne avec droits et confirmation, sélection et
+    barre groupée, vue en cartes, trois densités, états de chargement, d'erreur
+    et de vide.
+  - **`CrudPage`** — réécrit : il tenait en neuf lignes et n'offrait aucune des
+    quatre opérations qui lui donnent son nom.
+
+  ## Ruptures
+  - `CrudPage` : `actions` portait des nœuds d'en-tête, ils vont dans
+    `headerActions`. `data` est requis, et `columns` l'est aussi à moins qu'une
+    `resource` ne les fournisse.
+  - `Sidebar` et `AppShell` : les props ont changé. Voir
+    [La navigation latérale](https://beatjo.github.io/sia-ui-site/guides/navigation)
+    et [La coquille d'application](https://beatjo.github.io/sia-ui-site/guides/coquille-application).
+
+  ## Documentation
+
+  Les cent trois composants ont désormais une page de référence — ce qu'ils
+  font, comment les installer, et **toutes** leurs props avec type et valeur par
+  défaut. Ces pages sont écrites par le code : les props viennent des types, les
+  descriptions de leurs commentaires, la commande d'installation du registre.
+
+  Le catalogue est passé de seize sections en deux langues à neuf, ordonnées du
+  plus général au plus assemblé. Les comptes rendus de développement ont été
+  retirés de la documentation : ils décrivaient un chemin parcouru, pas un
+  produit.
+
+## 0.2.0
+
+### Minor Changes
+
+- e4e4a72: Annonces, session et droits, formulaires sans dépendance, et vingt entrées de
+  registre de plus.
+
+  ## Composants
+  - **Annonces** — `toast()` s'appelle hors de React, variante `loading`, boutons
+    d'action, six coins réglables par annonce, balayage pour écarter, suivi de
+    promesse.
+  - **Session et droits** — `createSessionStore` avec sa machine à quatre états,
+    `createAccessLayer` à évaluateur injecté, `RequireSession` sans routeur.
+  - **Formulaires** — le contrat `FormAdapter` et `useLocalForm`, sans
+    dépendance. `Form` est écrit sur le contrat : il n'importe ni
+    react-hook-form ni zod, et se câble à l'un ou l'autre par un adaptateur.
+  - **Vingt entrées de registre de plus** — `progress`, `dropdown-menu`,
+    `accordion`, `sidebar`, `breadcrumb`, `steps`, `toggle`, `scroll-area`,
+    `hover-card`, `aspect-ratio`, `input-number`, `password-input`,
+    `phone-input`, `chart`, `require-session`, `form`…
+  - **Thème** — mode `system`, persistance et script anti-clignotement dans
+    `SiaProvider`, en remplacement de `next-themes`.
+
+  ## `@sia-ui/api`
+
+  Le client HTTP typé est un paquet à part : ni React, ni DOM, ni tokens. Il
+  s'installe seul, et copier un `Badge` depuis le registre ne l'entraîne pas.
+
+  ## Utilitaires
+
+  `@sia-ui/utils` passe de six à quatorze modules : `query`, `async`,
+  `collection`, `object`, `validation`, `file`, `clipboard`, `locale`.
+
+  ## Archives
+  - Plus de sourcemaps : elles pesaient environ soixante pour cent de chaque
+    archive — `@sia-ui/react-web` passe de 2,1 Mo à 759 Ko.
+  - Chaque paquet porte enfin la licence MIT qu'il annonce.
+
+  ## Vitrine en ligne
+
+  Trois surfaces publiées sur GitHub Pages à chaque poussée sur `main` : la
+  documentation à la racine, le catalogue Storybook sous `/storybook/`, la
+  démonstration sous `/preview/`. Le site de documentation est construit depuis
+  les fichiers de `docs/` eux-mêmes, qui restent du Markdown ordinaire.
+
+  ## Le registre n'est plus une voie sans retour
+
+  Installer était jusqu'ici définitif : plus rien ne disait ce qu'on avait, ce
+  qu'on avait retouché, ni ce qui avait bougé en amont — donc rien ne permettait
+  de corriger ni de déprécier une entrée après coup.
+  - **`sia-ui.lock.json`**, écrit à chaque `add` : version, date et empreinte de
+    chaque fichier copié.
+  - **Quatre commandes** : `diff`, `remove`, `doctor`, `list --outdated`.
+    `remove` refuse de casser un voisin ou d'effacer un fichier retouché.
+  - **Cycle de vie des entrées** — `experimental`, `stable`, `deprecated`,
+    `removed` — avec `replacedBy`. `add` refuse ce qui est retiré, `doctor`
+    signale ce qui est déprécié chez qui l'a déjà installé.
+  - **Journal du registre**, entrée par entrée, dont `pnpm check:changelog`
+    refuse qu'il mente.
+  - **Registre servi en HTTP**, versionné par l'URL : `…/r/v1/`. Corriger une
+    entrée n'oblige plus à republier la CLI.
+
+  ## Corrections
+  - La case à cocher et le bouton radio masquaient leur contrôle natif en
+    `opacity:0`. Le navigateur le peignait encore sous le visuel personnalisé, et
+    ce dessin clignotait au clic. Les deux utilisent désormais la recette
+    partagée `.sia-visually-hidden`, qui le découpe hors du rendu sans le retirer
+    du clavier.
+  - Une case à cocher non contrôlée ne se peignait jamais cochée : l'`<input>`
+    basculait, mais la classe qui dessine la case ne suivait pas.
+  - Le curseur de survol des graphes était ovale, et le tracé de la courbe
+    haché : les marqueurs sont sortis du SVG, qui est étiré sans conserver ses
+    proportions.
+  - L'entrée `drawer` du registre était impossible à installer — elle importait
+    deux dossiers que la CLI ne copie pas.
+
+### Patch Changes
+
+- Include component styles when installing registry components
+
+## 0.2.0
+
+- `resource` — **nouvelle entrée**. Une page de liste décrivait le même objet
+  trois fois : en colonnes pour le tableau, en champs pour le formulaire, en
+  lignes pour le détail. Plus la validation, les clés de recherche et la règle
+  de droits par opération. Ces descriptions divergent, et toujours dans le
+  même sens — c'est le formulaire qui oublie le champ que le tableau affiche.
+
+  `defineResource` la décrit **une seule fois**. Colonnes, champs, détail,
+  validation, recherche, clé de ligne et droits en sont dérivés. Le rendu se
+  déduit du type : un `currency` s'affiche formaté et aligné à droite, un
+  `select` avec ses `tones` devient une pastille, une `date` passe par le
+  format local.
+
+  Trois surfaces, trois défauts : `inTable` écarte ce qui est trop long pour
+  une cellule, `inForm` écarte ce que `readOnly` marque, `inDetail` garde
+  tout. Le détail n'est donc pas le tableau — une note de trois phrases sort
+  des colonnes et reste dans la boîte de consultation.
+
+  `permissions: "auto"` applique la convention `<nom>.<verbe>`. Chaque
+  dérivation cède à la prop correspondante : passer `columns` ne coûte ni le
+  formulaire, ni les droits.
+
+- `crud-page` — **réécrit**. Il tenait en neuf lignes : un titre, un
+  emplacement libre et une pagination. Les quatre opérations d'une page de
+  liste étaient à réécrire à chaque écran, ce qui produit quatre variantes
+  qui divergent — celle qui oublie la confirmation, celle qui ne vérifie
+  pas les droits, celle dont le bouton reste actif pendant l'appel.
+
+  Créer, consulter, modifier, supprimer **fonctionnent d'emblée** : fournir
+  le gestionnaire suffit, ne pas le fournir retire l'action. La suppression
+  est confirmée d'office — on peut lever la confirmation, encore faut-il
+  l'avoir écrit.
+
+  `operations` personnalise chaque action : libellé, icône, droits,
+  visibilité ligne par ligne, confirmation. `extraRowActions` en ajoute
+  d'autres, `onBulkDelete` active la sélection et sa barre.
+
+  Sans gestionnaire, les actions **ouvrent leurs propres boîtes** : déclarer
+  `fields` et `onSubmit` suffit à obtenir un formulaire vide en création, le
+  même prérempli en modification, et une vue de détail dérivée des colonnes.
+  `onCreate`, `onEdit` et `onView` restent la porte de sortie vers une page
+  dédiée : fournis, ils passent devant la boîte. `resource` va plus loin et
+  dérive tout d'une seule déclaration.
+
+  **Migration, rupture** : `actions` portait des nœuds d'en-tête; ils vont
+  dans `headerActions`. Le nom `actions` désignerait sinon deux choses
+  différentes selon la version, ce qui est le pire cas — le code compile et
+  se comporte autrement. `data` est désormais requis, et `columns` l'est
+  aussi à moins qu'une `resource` ne les fournisse; le tableau reste
+  remplaçable par `children`.
+
+- `data-table` — refonte. Il affichait des colonnes et un tri délégué.
+  S'ajoutent les **actions de ligne** — avec droits, confirmation, et
+  passage en menu au-delà de la limite —, la **sélection** et sa barre
+  d'actions groupées, une **vue en cartes** qui bascule d'elle-même sous
+  768 px, la recherche locale, trois densités, les états de chargement,
+  d'erreur et de vide.
+
+  Les actions de ligne s'estompent hors survol : une colonne pleine de
+  boutons attire l'œil plus que les données. Elles restent entières au
+  clavier et sur tactile, où il n'y a pas de survol.
+
+  **Migration, rupture** : `align` passe de `left`/`right` à `start`/`end`,
+  et `getRowKey` devient facultatif. `useDataTableQuery` et
+  `createUrlTableStorage` sont inchangés.
+
+- `app-shell` — **réécrit**. Il tenait en six lignes : une grille à deux
+  colonnes, un bouton de repli écrit `☰`, et des emplacements libres. Il ne
+  réutilisait ni la navigation, ni le tiroir, ni rien.
+
+  Il assemble maintenant le `Sidebar` et le `Drawer`, filtre les droits **une
+  seule fois** pour la barre comme pour les onglets, et se branche sur
+  n'importe quel routeur par une seule chaîne :
+
+  ```tsx
+  <AppShell nav={NAV} currentPath={usePathname()} renderLink={…} />
+  ```
+
+  De là il déduit l'entrée courante par le préfixe le plus long — une page
+  `/factures/12/lignes` marque bien `Factures` — et referme le tiroir mobile
+  à chaque navigation, sans jamais importer de routeur.
+
+  S'ajoutent trois états de barre (`expanded`, `collapsed`, `hidden`), trois
+  stratégies mobiles (`drawer`, `tabs`, `both`), `contentWidth`, `side`, les
+  largeurs personnalisables, et `BottomTabs` — qui ne montre que des
+  feuilles, un onglet ouvrant un sous-menu étant un piège tactile.
+
+  **Migration, rupture** : `logo` devient `brand`, `navigation` devient
+  `nav` et prend des données plutôt que des nœuds. `header` est inchangé.
+  Le titre de page n'est pas une prop : le poser dans `page`, avec
+  `PageHeader` — une coquille qui rend le `<h1>` force chaque écran à passer
+  par ses props.
+
+  L'entrée annonçait deux fichiers et une dépendance; elle en annonce
+  maintenant trois et cinq. Copiée telle quelle, elle serait arrivée cassée.
+
+- `avatar` — refonte. Il servait une image, trois tailles et des initiales.
+  S'ajoutent : une **teinte dérivée du nom**, stable d'un écran à l'autre,
+  pour distinguer deux personnes aux mêmes initiales; trois formes et trois
+  variantes (`soft`, `solid`, `outline`); cinq tailles; une pastille de
+  présence à quatre états; et `AvatarGroup`, qui empile et résume son
+  surplus.
+
+  Le repli est désormais peint **sous** l'image plutôt qu'à sa place : la
+  mise en page ne bouge plus entre l'attente, la réussite et l'échec.
+
+  Les initiales prennent la première et la dernière partie du nom, particules
+  écartées : « Jean-Baptiste Kouassi Mbella » donne « JM », « Marie de la
+  Tour » donne « MT ».
+
+  **Migration** : aucune prop retirée. `fallback` accepte maintenant un
+  nœud React et non plus seulement une chaîne.
+
+- `sidebar` — refonte. Trois défauts corrigés :
+
+  **Réduite, la barre enfermait ses sous-entrées.** Une règle forçait le
+  panneau des enfants à une hauteur nulle quel que soit son état : une
+  rubrique à sous-menus devenait inatteignable dès qu'on repliait la barre.
+  Les sous-menus sortent maintenant en volet, au survol ou au clavier.
+
+  **L'arbre s'arrêtait à deux niveaux**, interdits par le type lui-même
+  (`items?: Array<Omit<SidebarItem, "items">>`). Il descend désormais aussi
+  profond que l'arborescence du produit.
+
+  **Aucun filtrage par droits.** `permission` sur une entrée, `can` sur le
+  composant, et une cascade : un parent dont toute la descendance est
+  filtrée disparaît avec elle, sauf `keepWhenEmpty`.
+
+  S'ajoutent `renderLink` pour brancher un routeur sans en dépendre,
+  `openKeys` pour piloter les branches ouvertes, `accordion`, `side`, et les
+  variantes `default` / `filled` / `floating` en trois tailles.
+
+  **Migration** : aucune prop retirée. `registryDependencies` gagne
+  `overlay` — `sia-ui add sidebar --overwrite` l'installe.
+
+## 0.1.1
+
+- `button` — l'entrée n'annonçait que son `index.tsx`. Installé, le bouton
+  arrivait donc sans sa feuille de style. `components/Button/styles.css`
+  rejoint ses fichiers.
+
+## 0.1.0
+
+Première version des 104 entrées du registre.
+
+### Primitives (19)
+
+- `aspect-ratio` — Box locked to a width / height ratio.
+- `avatar` — Image avatar with automatic initials fallback.
+- `badge` — Compact semantic status label with side content and loading state.
+- `button` — Accessible button with loading and icon states.
+- `card` — Composable card with header, body and footer regions.
+- `checkbox` — Checkbox and CheckboxGroup with indeterminate, button and tone variants.
+- `container` — Responsive page container and stack primitives.
+- `divider` — Horizontal or vertical semantic separator.
+- `form-adapter-rhf` — react-hook-form adapter for the FormAdapter contract. Requires react-hook-form.
+- `icon-button` — Accessible icon-only action with required label.
+- `icons` — Jeu d'icônes SVG sans dépendance, servi par le package.
+- `input` — Accessible text input with side content and loading state.
+- `overlay` — Positioned portal foundation with viewport collision handling and dismissal.
+- `radio-group` — Controlled radio group with standard and RadioButton controls.
+- `skeleton` — Token-based loading placeholder for content layouts.
+- `spinner` — Accessible loading indicator with sizes and screen-reader label.
+- `switch` — Controlled or uncontrolled accessible boolean switch.
+- `textarea` — Accessible multiline input with invalid and resize states.
+- `typography` — Headings, body text and inline code with semantic sizing and tones.
+
+### Composants (65)
+
+- `accordion` — Collapsible sections with animated height.
+- `alert` — Semantic feedback alert with tones, action and dismissal.
+- `amount-display` — Consistent semantic amount display for finance interfaces.
+- `autocomplete` — Combobox with local filtering and optional custom values.
+- `breadcrumb` — Navigation trail that folds middle levels into a menu.
+- `calendar` — Localized month and year calendar with range selection and custom cells.
+- `chart` — Dependency-free line, area and bar charts.
+- `color-picker` — Native color selection with visible serialized value.
+- `countdown` — Countdown specialization of Timer.
+- `currency-input` — Locale-aware currency input exposing a numeric value.
+- `data-table` — Generic typed table with loading and empty states.
+- `date-picker` — Calendar-based date picker with overlay, tones, limits and custom cells.
+- `date-range-picker` — Unified calendar range selection with serializable boundaries.
+- `date-time-picker` — Composable date and time selection with serializable values.
+- `descriptions` — Responsive labeled value grid for entity details.
+- `drawer` — Accessible side panel with focus management and portal rendering.
+- `dropdown-menu` — Dropdown and context menus with keyboard navigation.
+- `duration-display` — Localized duration display in text or clock format.
+- `event-calendar` — Calendar with per-day business events.
+- `field` — Typed form field factory reusing the SIA UI control catalog.
+- `file-upload` — Accessible file picker with drag and drop.
+- `form-field` — Deprecated compatibility alias for Field.
+- `hover-card` — Rich preview on hover, with open and close delays.
+- `image-upload` — Image file upload with local preview and removal.
+- `input-number` — Numeric input with stepper, bounds and decimal handling.
+- `json-editor` — JSON textarea with validation and formatting.
+- `label` — Libellé de champ, avec marque d'obligation.
+- `markdown-editor` — Markdown writing and pluggable preview surface.
+- `mini-calendar` — Compact calendar built on the shared calendar foundation.
+- `modal` — Accessible modal dialog with portal, Escape and backdrop handling.
+- `month-picker` — Native serializable month selection.
+- `multi-select` — Searchable multiple selection with removable values.
+- `otp-input` — Keyboard and paste friendly one-time code input.
+- `pagination` — Accessible controlled pagination with compact page ranges.
+- `password-input` — Password field with reveal toggle and strength meter.
+- `phone-input` — International phone input with dial code and grouping.
+- `popover` — Click or hover popover composed from the shared positioned Overlay.
+- `progress` — Determinate and indeterminate progress, bar or circle.
+- `qr-code` — Accessible QR code frame with pluggable encoder renderer.
+- `rating` — Accessible controlled or uncontrolled rating control.
+- `reference-select` — Entity reference selection built on Autocomplete.
+- `relative-time` — Auto-refreshing semantic relative date display.
+- `resizable-panel` — Keyboard and pointer resizable split panels.
+- `rich-text-editor` — Lightweight rich text input with basic formatting commands.
+- `scroll-area` — Scrollable region with thin scrollbars and edge fades.
+- `search-input` — Controlled or uncontrolled search field with submit and clear actions.
+- `select` — Accessible searchable select with positioned overlay and async option loading.
+- `slider` — Accessible single or interval slider with formatted values.
+- `statistic` — Locale-aware number, currency and percentage display with trend.
+- `steps` — Step progression, horizontal or vertical, with status.
+- `tabs` — Accessible controlled or uncontrolled tabs with keyboard navigation.
+- `tags-input` — Create and remove string tags from a text input.
+- `time-picker` — Timer-based time selection panel with steps, confirmation and tones.
+- `time-range-picker` — Serializable start and end time selection.
+- `timeline` — Chronological events with semantic tones.
+- `timer` — Reliable count-up or count-down timer based on absolute time.
+- `toast` — Toast queue with placement, pause on hover and promise tracking.
+- `toggle` — Two-state button and toggle group.
+- `tooltip` — Accessible contextual tooltip for hover and focus targets.
+- `tour` — Guided multi-step product tour overlay.
+- `transfer` — Move items between available and selected lists.
+- `tree` — Accessible expandable hierarchical data view.
+- `tree-select` — Hierarchical value selection built on Tree.
+- `week-picker` — Native ISO week selection.
+- `year-picker` — Bounded year selection.
+
+### Patterns applicatifs (20)
+
+- `app-shell` — Responsive application shell with collapsible navigation.
+- `async-state` — Loading, empty and error states for remotely loaded content.
+- `audit-meta` — Chronological audit history for admin and finance entities.
+- `auth-layout` — Reusable authentication page composition.
+- `command-palette` — Keyboard command search and execution dialog.
+- `confirm-dialog` — Confirmation dialog composed from Modal and Button.
+- `crud-page` — CRUD page composition with header, async states and pagination.
+- `date-range-filter` — Date range filter with reusable presets and clear action.
+- `empty-state` — Reusable empty state with icon, description and action.
+- `entity-meta` — Compact audit and entity metadata block for admin and finance screens.
+- `error-state` — Reusable error state with message extraction and retry action.
+- `filters-bar` — Composable search, filter, reset and action toolbar.
+- `form` — Declarative form driven by a field list, wired to any FormAdapter.
+- `kpi-grid` — Responsive grid for KPI and statistic cards.
+- `page-header` — Consistent page title, description and action area.
+- `permission-gate` — Render content according to application permissions.
+- `require-session` — Route guard on a session store, with a permission rule and no router dependency.
+- `sidebar` — Collapsible application navigation with groups and sub-items.
+- `stat-card` — Business metric card composed from Card and Statistic.
+- `unsaved-changes-guard` — Protect browser and in-app navigation with unsaved changes.
+
+## Licence
+
+MIT

package/dist/index.cjs

@@ -60,17 +60,24 @@ var registry_default = {
     },
     {
       name: "app-shell",
-      description: "Responsive application shell with collapsible navigation.",
+      description: "Application shell: three sidebar states, permission filtering, router-agnostic active route, and mobile drawer or bottom tabs.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/AppShell/index.tsx",
+        "components/AppShell/tab-bar.tsx",
         "components/AppShell/styles.css"
       ],
       dependencies: [
+        "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
+      ],
+      registryDependencies: [
+        "drawer",
+        "sidebar"
       ]
     },
     {
@@ -155,9 +162,9 @@ var registry_default = {
     },
     {
       name: "avatar",
-      description: "Image avatar with automatic initials fallback.",
+      description: "Avatar and stacked group: name-derived tint, initials, presence, three shapes and variants.",
       type: "primitive",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
@@ -212,11 +219,12 @@ var registry_default = {
       name: "button",
       description: "Accessible button with loading and icon states.",
       type: "primitive",
-      version: "0.1.0",
+      version: "0.1.1",
       status: "stable",
       source: "package",
       files: [
-        "components/Button/index.tsx"
+        "components/Button/index.tsx",
+        "components/Button/styles.css"
       ],
       dependencies: [
         "@sia-ui/headless",
@@ -373,22 +381,30 @@ var registry_default = {
     },
     {
       name: "crud-page",
-      description: "CRUD page composition with header, async states and pagination.",
+      description: "List page for a declared resource: create, view, edit and delete open their own dialogs, each removable and permission-aware.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/CrudPage/index.tsx",
+        "components/CrudPage/dialogs.tsx",
         "components/CrudPage/styles.css"
       ],
       dependencies: [
+        "@sia-ui/headless",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "async-state",
+        "button",
+        "data-table",
+        "descriptions",
+        "form",
+        "icons",
+        "modal",
         "page-header",
-        "pagination"
+        "pagination",
+        "resource"
       ]
     },
     {
@@ -408,21 +424,35 @@ var registry_default = {
     },
     {
       name: "data-table",
-      description: "Generic typed table with loading and empty states.",
+      description: "Data table: row actions with permissions and confirmation, selection, card view, density and sorting.",
       type: "component",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/DataTable/index.tsx",
+        "components/DataTable/types.ts",
+        "components/DataTable/values.ts",
+        "components/DataTable/row-actions.tsx",
+        "components/DataTable/query.ts",
         "components/DataTable/styles.css"
       ],
       dependencies: [
         "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "icons"
+        "button",
+        "checkbox",
+        "confirm-dialog",
+        "dropdown-menu",
+        "empty-state",
+        "error-state",
+        "icon-button",
+        "icons",
+        "search-input",
+        "skeleton"
       ]
     },
     {
@@ -1275,6 +1305,30 @@ var registry_default = {
         "@sia-ui/utils"
       ]
     },
+    {
+      name: "resource",
+      description: "Declare a resource once: table columns, form fields, detail view, validation, search keys and permissions are all derived from it.",
+      type: "pattern",
+      version: "0.2.0",
+      status: "stable",
+      source: "package",
+      files: [
+        "components/Resource/index.tsx"
+      ],
+      dependencies: [
+        "@sia-ui/headless",
+        "@sia-ui/tokens",
+        "@sia-ui/utils"
+      ],
+      registryDependencies: [
+        "amount-display",
+        "badge",
+        "data-table",
+        "field",
+        "form",
+        "select"
+      ]
+    },
     {
       name: "rich-text-editor",
       description: "Lightweight rich text input with basic formatting commands.",
@@ -1346,9 +1400,9 @@ var registry_default = {
     },
     {
       name: "sidebar",
-      description: "Collapsible application navigation with groups and sub-items.",
+      description: "Application navigation: unlimited depth, permission filtering, and a rail whose sub-menus open in a flyout.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
@@ -1357,10 +1411,12 @@ var registry_default = {
       ],
       dependencies: [
         "@sia-ui/headless",
+        "@sia-ui/tokens",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "icons"
+        "icons",
+        "overlay"
       ]
     },
     {

package/dist/index.js

@@ -58,17 +58,24 @@ var registry_default = {
     },
     {
       name: "app-shell",
-      description: "Responsive application shell with collapsible navigation.",
+      description: "Application shell: three sidebar states, permission filtering, router-agnostic active route, and mobile drawer or bottom tabs.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/AppShell/index.tsx",
+        "components/AppShell/tab-bar.tsx",
         "components/AppShell/styles.css"
       ],
       dependencies: [
+        "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
+      ],
+      registryDependencies: [
+        "drawer",
+        "sidebar"
       ]
     },
     {
@@ -153,9 +160,9 @@ var registry_default = {
     },
     {
       name: "avatar",
-      description: "Image avatar with automatic initials fallback.",
+      description: "Avatar and stacked group: name-derived tint, initials, presence, three shapes and variants.",
       type: "primitive",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
@@ -210,11 +217,12 @@ var registry_default = {
       name: "button",
       description: "Accessible button with loading and icon states.",
       type: "primitive",
-      version: "0.1.0",
+      version: "0.1.1",
       status: "stable",
       source: "package",
       files: [
-        "components/Button/index.tsx"
+        "components/Button/index.tsx",
+        "components/Button/styles.css"
       ],
       dependencies: [
         "@sia-ui/headless",
@@ -371,22 +379,30 @@ var registry_default = {
     },
     {
       name: "crud-page",
-      description: "CRUD page composition with header, async states and pagination.",
+      description: "List page for a declared resource: create, view, edit and delete open their own dialogs, each removable and permission-aware.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/CrudPage/index.tsx",
+        "components/CrudPage/dialogs.tsx",
         "components/CrudPage/styles.css"
       ],
       dependencies: [
+        "@sia-ui/headless",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "async-state",
+        "button",
+        "data-table",
+        "descriptions",
+        "form",
+        "icons",
+        "modal",
         "page-header",
-        "pagination"
+        "pagination",
+        "resource"
       ]
     },
     {
@@ -406,21 +422,35 @@ var registry_default = {
     },
     {
       name: "data-table",
-      description: "Generic typed table with loading and empty states.",
+      description: "Data table: row actions with permissions and confirmation, selection, card view, density and sorting.",
       type: "component",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
         "components/DataTable/index.tsx",
+        "components/DataTable/types.ts",
+        "components/DataTable/values.ts",
+        "components/DataTable/row-actions.tsx",
+        "components/DataTable/query.ts",
         "components/DataTable/styles.css"
       ],
       dependencies: [
         "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "icons"
+        "button",
+        "checkbox",
+        "confirm-dialog",
+        "dropdown-menu",
+        "empty-state",
+        "error-state",
+        "icon-button",
+        "icons",
+        "search-input",
+        "skeleton"
       ]
     },
     {
@@ -1273,6 +1303,30 @@ var registry_default = {
         "@sia-ui/utils"
       ]
     },
+    {
+      name: "resource",
+      description: "Declare a resource once: table columns, form fields, detail view, validation, search keys and permissions are all derived from it.",
+      type: "pattern",
+      version: "0.2.0",
+      status: "stable",
+      source: "package",
+      files: [
+        "components/Resource/index.tsx"
+      ],
+      dependencies: [
+        "@sia-ui/headless",
+        "@sia-ui/tokens",
+        "@sia-ui/utils"
+      ],
+      registryDependencies: [
+        "amount-display",
+        "badge",
+        "data-table",
+        "field",
+        "form",
+        "select"
+      ]
+    },
     {
       name: "rich-text-editor",
       description: "Lightweight rich text input with basic formatting commands.",
@@ -1344,9 +1398,9 @@ var registry_default = {
     },
     {
       name: "sidebar",
-      description: "Collapsible application navigation with groups and sub-items.",
+      description: "Application navigation: unlimited depth, permission filtering, and a rail whose sub-menus open in a flyout.",
       type: "pattern",
-      version: "0.1.0",
+      version: "0.2.0",
       status: "stable",
       source: "package",
       files: [
@@ -1355,10 +1409,12 @@ var registry_default = {
       ],
       dependencies: [
         "@sia-ui/headless",
+        "@sia-ui/tokens",
         "@sia-ui/utils"
       ],
       registryDependencies: [
-        "icons"
+        "icons",
+        "overlay"
       ]
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia-ui/registry",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Installable component registry for SIA UI.",
   "keywords": [
     "sia-ui",
@@ -10,14 +10,13 @@
   ],
   "license": "MIT",
   "author": "Ivan Mbella",
-  "homepage": "https://github.com/BeatJo/sia-ui#readme",
+  "homepage": "https://beatjo.github.io/sia-ui-site/",
   "bugs": {
-    "url": "https://github.com/BeatJo/sia-ui/issues"
+    "url": "https://github.com/BeatJo/sia-ui-site/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BeatJo/sia-ui.git",
-    "directory": "packages/registry"
+    "url": "git+https://github.com/BeatJo/sia-ui-site.git"
   },
   "type": "module",
   "files": [

package/registry.json

@@ -60,17 +60,24 @@
     },
     {
       "name": "app-shell",
-      "description": "Responsive application shell with collapsible navigation.",
+      "description": "Application shell: three sidebar states, permission filtering, router-agnostic active route, and mobile drawer or bottom tabs.",
       "type": "pattern",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "status": "stable",
       "source": "package",
       "files": [
         "components/AppShell/index.tsx",
+        "components/AppShell/tab-bar.tsx",
         "components/AppShell/styles.css"
       ],
       "dependencies": [
+        "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
+      ],
+      "registryDependencies": [
+        "drawer",
+        "sidebar"
       ]
     },
     {
@@ -155,9 +162,9 @@
     },
     {
       "name": "avatar",
-      "description": "Image avatar with automatic initials fallback.",
+      "description": "Avatar and stacked group: name-derived tint, initials, presence, three shapes and variants.",
       "type": "primitive",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "status": "stable",
       "source": "package",
       "files": [
@@ -374,22 +381,30 @@
     },
     {
       "name": "crud-page",
-      "description": "CRUD page composition with header, async states and pagination.",
+      "description": "List page for a declared resource: create, view, edit and delete open their own dialogs, each removable and permission-aware.",
       "type": "pattern",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "status": "stable",
       "source": "package",
       "files": [
         "components/CrudPage/index.tsx",
+        "components/CrudPage/dialogs.tsx",
         "components/CrudPage/styles.css"
       ],
       "dependencies": [
+        "@sia-ui/headless",
         "@sia-ui/utils"
       ],
       "registryDependencies": [
-        "async-state",
+        "button",
+        "data-table",
+        "descriptions",
+        "form",
+        "icons",
+        "modal",
         "page-header",
-        "pagination"
+        "pagination",
+        "resource"
       ]
     },
     {
@@ -409,21 +424,35 @@
     },
     {
       "name": "data-table",
-      "description": "Generic typed table with loading and empty states.",
+      "description": "Data table: row actions with permissions and confirmation, selection, card view, density and sorting.",
       "type": "component",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "status": "stable",
       "source": "package",
       "files": [
         "components/DataTable/index.tsx",
+        "components/DataTable/types.ts",
+        "components/DataTable/values.ts",
+        "components/DataTable/row-actions.tsx",
+        "components/DataTable/query.ts",
         "components/DataTable/styles.css"
       ],
       "dependencies": [
         "@sia-ui/headless",
+        "@sia-ui/react",
         "@sia-ui/utils"
       ],
       "registryDependencies": [
-        "icons"
+        "button",
+        "checkbox",
+        "confirm-dialog",
+        "dropdown-menu",
+        "empty-state",
+        "error-state",
+        "icon-button",
+        "icons",
+        "search-input",
+        "skeleton"
       ]
     },
     {
@@ -1276,6 +1305,30 @@
         "@sia-ui/utils"
       ]
     },
+    {
+      "name": "resource",
+      "description": "Declare a resource once: table columns, form fields, detail view, validation, search keys and permissions are all derived from it.",
+      "type": "pattern",
+      "version": "0.2.0",
+      "status": "stable",
+      "source": "package",
+      "files": [
+        "components/Resource/index.tsx"
+      ],
+      "dependencies": [
+        "@sia-ui/headless",
+        "@sia-ui/tokens",
+        "@sia-ui/utils"
+      ],
+      "registryDependencies": [
+        "amount-display",
+        "badge",
+        "data-table",
+        "field",
+        "form",
+        "select"
+      ]
+    },
     {
       "name": "rich-text-editor",
       "description": "Lightweight rich text input with basic formatting commands.",
@@ -1347,9 +1400,9 @@
     },
     {
       "name": "sidebar",
-      "description": "Collapsible application navigation with groups and sub-items.",
+      "description": "Application navigation: unlimited depth, permission filtering, and a rail whose sub-menus open in a flyout.",
       "type": "pattern",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "status": "stable",
       "source": "package",
       "files": [
@@ -1358,10 +1411,12 @@
       ],
       "dependencies": [
         "@sia-ui/headless",
+        "@sia-ui/tokens",
         "@sia-ui/utils"
       ],
       "registryDependencies": [
-        "icons"
+        "icons",
+        "overlay"
       ]
     },
     {