@sia-ui/registry 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,128 @@
+# Journal du registre
+
+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.
+
+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.
+
+## 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.

package/LICENSE

@@ -0,0 +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.

package/README.md

@@ -0,0 +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