@sia-ui/registry 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -10,6 +10,297 @@ 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.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
+
+- 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.

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,35 @@
-# @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://github.com/BeatJo/sia-ui/tree/main/docs).
-
-## Licence
-
-MIT
+# @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://github.com/BeatJo/sia-ui/tree/main/docs).
+
+## 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.1.0",
+  "version": "0.3.0",
   "description": "Installable component registry for SIA UI.",
   "keywords": [
     "sia-ui",

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": [
@@ -212,11 +219,12 @@
       "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 @@
     },
     {
       "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 @@
     },
     {
       "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 @@
         "@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 @@
     },
     {
       "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 @@
       ],
       "dependencies": [
         "@sia-ui/headless",
+        "@sia-ui/tokens",
         "@sia-ui/utils"
       ],
       "registryDependencies": [
-        "icons"
+        "icons",
+        "overlay"
       ]
     },
     {