@danielitouci96/design-system 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +239 -0
- package/LICENSE +21 -0
- package/README.md +720 -0
- package/dist/components/Alert/Alert.d.ts +20 -0
- package/dist/components/Alert/Alert.d.ts.map +1 -0
- package/dist/components/Alert/index.d.ts +2 -0
- package/dist/components/Alert/index.d.ts.map +1 -0
- package/dist/components/Avatar/Avatar.d.ts +15 -0
- package/dist/components/Avatar/Avatar.d.ts.map +1 -0
- package/dist/components/Avatar/index.d.ts +2 -0
- package/dist/components/Avatar/index.d.ts.map +1 -0
- package/dist/components/Badge/Badge.d.ts +17 -0
- package/dist/components/Badge/Badge.d.ts.map +1 -0
- package/dist/components/Badge/index.d.ts +2 -0
- package/dist/components/Badge/index.d.ts.map +1 -0
- package/dist/components/Breadcrumb/Breadcrumb.d.ts +16 -0
- package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -0
- package/dist/components/Breadcrumb/index.d.ts +2 -0
- package/dist/components/Breadcrumb/index.d.ts.map +1 -0
- package/dist/components/Button/Button.d.ts +26 -0
- package/dist/components/Button/Button.d.ts.map +1 -0
- package/dist/components/Button/index.d.ts +2 -0
- package/dist/components/Button/index.d.ts.map +1 -0
- package/dist/components/ButtonGroup/ButtonGroup.d.ts +16 -0
- package/dist/components/ButtonGroup/ButtonGroup.d.ts.map +1 -0
- package/dist/components/ButtonGroup/index.d.ts +2 -0
- package/dist/components/ButtonGroup/index.d.ts.map +1 -0
- package/dist/components/Calendar/Calendar.d.ts +15 -0
- package/dist/components/Calendar/Calendar.d.ts.map +1 -0
- package/dist/components/Calendar/index.d.ts +2 -0
- package/dist/components/Calendar/index.d.ts.map +1 -0
- package/dist/components/Card/Card.d.ts +27 -0
- package/dist/components/Card/Card.d.ts.map +1 -0
- package/dist/components/Card/index.d.ts +2 -0
- package/dist/components/Card/index.d.ts.map +1 -0
- package/dist/components/Checkbox/Checkbox.d.ts +16 -0
- package/dist/components/Checkbox/Checkbox.d.ts.map +1 -0
- package/dist/components/Checkbox/index.d.ts +2 -0
- package/dist/components/Checkbox/index.d.ts.map +1 -0
- package/dist/components/Chip/Chip.d.ts +14 -0
- package/dist/components/Chip/Chip.d.ts.map +1 -0
- package/dist/components/Chip/index.d.ts +2 -0
- package/dist/components/Chip/index.d.ts.map +1 -0
- package/dist/components/Combobox/Combobox.d.ts +23 -0
- package/dist/components/Combobox/Combobox.d.ts.map +1 -0
- package/dist/components/Combobox/index.d.ts +2 -0
- package/dist/components/Combobox/index.d.ts.map +1 -0
- package/dist/components/DataTable/DataTable.d.ts +89 -0
- package/dist/components/DataTable/DataTable.d.ts.map +1 -0
- package/dist/components/DataTable/Table.d.ts +18 -0
- package/dist/components/DataTable/Table.d.ts.map +1 -0
- package/dist/components/DataTable/index.d.ts +3 -0
- package/dist/components/DataTable/index.d.ts.map +1 -0
- package/dist/components/DatePicker/DatePicker.d.ts +16 -0
- package/dist/components/DatePicker/DatePicker.d.ts.map +1 -0
- package/dist/components/DatePicker/index.d.ts +2 -0
- package/dist/components/DatePicker/index.d.ts.map +1 -0
- package/dist/components/DateRangePicker/DateRangePicker.d.ts +17 -0
- package/dist/components/DateRangePicker/DateRangePicker.d.ts.map +1 -0
- package/dist/components/DateRangePicker/index.d.ts +2 -0
- package/dist/components/DateRangePicker/index.d.ts.map +1 -0
- package/dist/components/DateTimePicker/DateTimePicker.d.ts +16 -0
- package/dist/components/DateTimePicker/DateTimePicker.d.ts.map +1 -0
- package/dist/components/DateTimePicker/index.d.ts +2 -0
- package/dist/components/DateTimePicker/index.d.ts.map +1 -0
- package/dist/components/Drawer/Drawer.d.ts +24 -0
- package/dist/components/Drawer/Drawer.d.ts.map +1 -0
- package/dist/components/Drawer/index.d.ts +2 -0
- package/dist/components/Drawer/index.d.ts.map +1 -0
- package/dist/components/DropdownMenu/DropdownMenu.d.ts +32 -0
- package/dist/components/DropdownMenu/DropdownMenu.d.ts.map +1 -0
- package/dist/components/DropdownMenu/index.d.ts +2 -0
- package/dist/components/DropdownMenu/index.d.ts.map +1 -0
- package/dist/components/FilterBar/ActiveFilters.d.ts +9 -0
- package/dist/components/FilterBar/ActiveFilters.d.ts.map +1 -0
- package/dist/components/FilterBar/FilterBar.d.ts +21 -0
- package/dist/components/FilterBar/FilterBar.d.ts.map +1 -0
- package/dist/components/FilterBar/FilterButton.d.ts +13 -0
- package/dist/components/FilterBar/FilterButton.d.ts.map +1 -0
- package/dist/components/FilterBar/FilterChip.d.ts +15 -0
- package/dist/components/FilterBar/FilterChip.d.ts.map +1 -0
- package/dist/components/FilterBar/filters.d.ts +54 -0
- package/dist/components/FilterBar/filters.d.ts.map +1 -0
- package/dist/components/FilterBar/index.d.ts +6 -0
- package/dist/components/FilterBar/index.d.ts.map +1 -0
- package/dist/components/FormField/FormField.d.ts +29 -0
- package/dist/components/FormField/FormField.d.ts.map +1 -0
- package/dist/components/FormField/index.d.ts +2 -0
- package/dist/components/FormField/index.d.ts.map +1 -0
- package/dist/components/IconButton/IconButton.d.ts +17 -0
- package/dist/components/IconButton/IconButton.d.ts.map +1 -0
- package/dist/components/IconButton/index.d.ts +2 -0
- package/dist/components/IconButton/index.d.ts.map +1 -0
- package/dist/components/Input/Input.d.ts +13 -0
- package/dist/components/Input/Input.d.ts.map +1 -0
- package/dist/components/Input/index.d.ts +2 -0
- package/dist/components/Input/index.d.ts.map +1 -0
- package/dist/components/Label/Label.d.ts +10 -0
- package/dist/components/Label/Label.d.ts.map +1 -0
- package/dist/components/Label/index.d.ts +2 -0
- package/dist/components/Label/index.d.ts.map +1 -0
- package/dist/components/Modal/Modal.d.ts +34 -0
- package/dist/components/Modal/Modal.d.ts.map +1 -0
- package/dist/components/Modal/index.d.ts +2 -0
- package/dist/components/Modal/index.d.ts.map +1 -0
- package/dist/components/MultiSelect/MultiSelect.d.ts +21 -0
- package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -0
- package/dist/components/MultiSelect/index.d.ts +2 -0
- package/dist/components/MultiSelect/index.d.ts.map +1 -0
- package/dist/components/Navbar/Navbar.d.ts +21 -0
- package/dist/components/Navbar/Navbar.d.ts.map +1 -0
- package/dist/components/Navbar/index.d.ts +2 -0
- package/dist/components/Navbar/index.d.ts.map +1 -0
- package/dist/components/NumberInput/NumberInput.d.ts +13 -0
- package/dist/components/NumberInput/NumberInput.d.ts.map +1 -0
- package/dist/components/NumberInput/index.d.ts +2 -0
- package/dist/components/NumberInput/index.d.ts.map +1 -0
- package/dist/components/Pagination/Pagination.d.ts +20 -0
- package/dist/components/Pagination/Pagination.d.ts.map +1 -0
- package/dist/components/Pagination/index.d.ts +2 -0
- package/dist/components/Pagination/index.d.ts.map +1 -0
- package/dist/components/PasswordInput/PasswordInput.d.ts +8 -0
- package/dist/components/PasswordInput/PasswordInput.d.ts.map +1 -0
- package/dist/components/PasswordInput/index.d.ts +2 -0
- package/dist/components/PasswordInput/index.d.ts.map +1 -0
- package/dist/components/Popover/Popover.d.ts +19 -0
- package/dist/components/Popover/Popover.d.ts.map +1 -0
- package/dist/components/Popover/index.d.ts +2 -0
- package/dist/components/Popover/index.d.ts.map +1 -0
- package/dist/components/Progress/Progress.d.ts +15 -0
- package/dist/components/Progress/Progress.d.ts.map +1 -0
- package/dist/components/Progress/index.d.ts +2 -0
- package/dist/components/Progress/index.d.ts.map +1 -0
- package/dist/components/Radio/Radio.d.ts +25 -0
- package/dist/components/Radio/Radio.d.ts.map +1 -0
- package/dist/components/Radio/index.d.ts +2 -0
- package/dist/components/Radio/index.d.ts.map +1 -0
- package/dist/components/SearchInput/SearchInput.d.ts +19 -0
- package/dist/components/SearchInput/SearchInput.d.ts.map +1 -0
- package/dist/components/SearchInput/index.d.ts +2 -0
- package/dist/components/SearchInput/index.d.ts.map +1 -0
- package/dist/components/Select/Select.d.ts +25 -0
- package/dist/components/Select/Select.d.ts.map +1 -0
- package/dist/components/Select/index.d.ts +2 -0
- package/dist/components/Select/index.d.ts.map +1 -0
- package/dist/components/Sidebar/Sidebar.d.ts +32 -0
- package/dist/components/Sidebar/Sidebar.d.ts.map +1 -0
- package/dist/components/Sidebar/index.d.ts +2 -0
- package/dist/components/Sidebar/index.d.ts.map +1 -0
- package/dist/components/Skeleton/Skeleton.d.ts +15 -0
- package/dist/components/Skeleton/Skeleton.d.ts.map +1 -0
- package/dist/components/Skeleton/index.d.ts +2 -0
- package/dist/components/Skeleton/index.d.ts.map +1 -0
- package/dist/components/Slider/Slider.d.ts +17 -0
- package/dist/components/Slider/Slider.d.ts.map +1 -0
- package/dist/components/Slider/index.d.ts +2 -0
- package/dist/components/Slider/index.d.ts.map +1 -0
- package/dist/components/Spinner/Spinner.d.ts +13 -0
- package/dist/components/Spinner/Spinner.d.ts.map +1 -0
- package/dist/components/Spinner/index.d.ts +2 -0
- package/dist/components/Spinner/index.d.ts.map +1 -0
- package/dist/components/StatusIndicator/StatusIndicator.d.ts +14 -0
- package/dist/components/StatusIndicator/StatusIndicator.d.ts.map +1 -0
- package/dist/components/StatusIndicator/index.d.ts +2 -0
- package/dist/components/StatusIndicator/index.d.ts.map +1 -0
- package/dist/components/Stepper/Stepper.d.ts +23 -0
- package/dist/components/Stepper/Stepper.d.ts.map +1 -0
- package/dist/components/Stepper/index.d.ts +2 -0
- package/dist/components/Stepper/index.d.ts.map +1 -0
- package/dist/components/Switch/Switch.d.ts +16 -0
- package/dist/components/Switch/Switch.d.ts.map +1 -0
- package/dist/components/Switch/index.d.ts +2 -0
- package/dist/components/Switch/index.d.ts.map +1 -0
- package/dist/components/Tabs/Tabs.d.ts +23 -0
- package/dist/components/Tabs/Tabs.d.ts.map +1 -0
- package/dist/components/Tabs/index.d.ts +2 -0
- package/dist/components/Tabs/index.d.ts.map +1 -0
- package/dist/components/Tag/Tag.d.ts +15 -0
- package/dist/components/Tag/Tag.d.ts.map +1 -0
- package/dist/components/Tag/index.d.ts +2 -0
- package/dist/components/Tag/index.d.ts.map +1 -0
- package/dist/components/Textarea/Textarea.d.ts +12 -0
- package/dist/components/Textarea/Textarea.d.ts.map +1 -0
- package/dist/components/Textarea/index.d.ts +2 -0
- package/dist/components/Textarea/index.d.ts.map +1 -0
- package/dist/components/TimePicker/TimePicker.d.ts +11 -0
- package/dist/components/TimePicker/TimePicker.d.ts.map +1 -0
- package/dist/components/TimePicker/index.d.ts +2 -0
- package/dist/components/TimePicker/index.d.ts.map +1 -0
- package/dist/components/Toast/Toast.d.ts +22 -0
- package/dist/components/Toast/Toast.d.ts.map +1 -0
- package/dist/components/Toast/index.d.ts +2 -0
- package/dist/components/Toast/index.d.ts.map +1 -0
- package/dist/components/Tooltip/Tooltip.d.ts +21 -0
- package/dist/components/Tooltip/Tooltip.d.ts.map +1 -0
- package/dist/components/Tooltip/index.d.ts +2 -0
- package/dist/components/Tooltip/index.d.ts.map +1 -0
- package/dist/design-system.css +1 -0
- package/dist/icons/Icon.d.ts +20 -0
- package/dist/icons/Icon.d.ts.map +1 -0
- package/dist/icons/index.d.ts +3 -0
- package/dist/icons/index.d.ts.map +1 -0
- package/dist/index.d.ts +119 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.es.js +50695 -0
- package/dist/layouts/index.d.ts +2 -0
- package/dist/layouts/index.d.ts.map +1 -0
- package/dist/layouts/layouts.d.ts +48 -0
- package/dist/layouts/layouts.d.ts.map +1 -0
- package/dist/patterns/index.d.ts +2 -0
- package/dist/patterns/index.d.ts.map +1 -0
- package/dist/patterns/patterns.d.ts +55 -0
- package/dist/patterns/patterns.d.ts.map +1 -0
- package/dist/primitives/Box/Box.d.ts +68 -0
- package/dist/primitives/Box/Box.d.ts.map +1 -0
- package/dist/primitives/Box/index.d.ts +2 -0
- package/dist/primitives/Box/index.d.ts.map +1 -0
- package/dist/primitives/Container/Container.d.ts +14 -0
- package/dist/primitives/Container/Container.d.ts.map +1 -0
- package/dist/primitives/Container/index.d.ts +2 -0
- package/dist/primitives/Container/index.d.ts.map +1 -0
- package/dist/primitives/Divider/Divider.d.ts +11 -0
- package/dist/primitives/Divider/Divider.d.ts.map +1 -0
- package/dist/primitives/Divider/index.d.ts +2 -0
- package/dist/primitives/Divider/index.d.ts.map +1 -0
- package/dist/primitives/Grid/Grid.d.ts +19 -0
- package/dist/primitives/Grid/Grid.d.ts.map +1 -0
- package/dist/primitives/Grid/index.d.ts +2 -0
- package/dist/primitives/Grid/index.d.ts.map +1 -0
- package/dist/primitives/Heading/Heading.d.ts +15 -0
- package/dist/primitives/Heading/Heading.d.ts.map +1 -0
- package/dist/primitives/Heading/index.d.ts +2 -0
- package/dist/primitives/Heading/index.d.ts.map +1 -0
- package/dist/primitives/Inline/Inline.d.ts +14 -0
- package/dist/primitives/Inline/Inline.d.ts.map +1 -0
- package/dist/primitives/Inline/index.d.ts +2 -0
- package/dist/primitives/Inline/index.d.ts.map +1 -0
- package/dist/primitives/Link/Link.d.ts +13 -0
- package/dist/primitives/Link/Link.d.ts.map +1 -0
- package/dist/primitives/Link/index.d.ts +2 -0
- package/dist/primitives/Link/index.d.ts.map +1 -0
- package/dist/primitives/Stack/Stack.d.ts +18 -0
- package/dist/primitives/Stack/Stack.d.ts.map +1 -0
- package/dist/primitives/Stack/index.d.ts +2 -0
- package/dist/primitives/Stack/index.d.ts.map +1 -0
- package/dist/primitives/Text/Text.d.ts +25 -0
- package/dist/primitives/Text/Text.d.ts.map +1 -0
- package/dist/primitives/Text/index.d.ts +2 -0
- package/dist/primitives/Text/index.d.ts.map +1 -0
- package/package.json +90 -0
- package/themes/cardio.css +41 -0
- package/themes/onco.css +41 -0
- package/themes/tema-personalizado.css +161 -0
package/README.md
ADDED
|
@@ -0,0 +1,720 @@
|
|
|
1
|
+
# @danielitouci96/design-system
|
|
2
|
+
|
|
3
|
+
Design System profesional, reutilizable, versionable y desacoplado para la plataforma médica.
|
|
4
|
+
Independiente del dominio médico: es infraestructura de UI, no lógica clínica.
|
|
5
|
+
|
|
6
|
+
**Lenguaje visual — Grove AI.** Lienzo blanco / mist-gray, una sola píldora de verde bosque como
|
|
7
|
+
acento, tinta `#1c1c1e` para acciones primarias, tipografías **Geist** (interfaz) + **Libre Caslon
|
|
8
|
+
Text** (display editorial), radios de 8–24px, bordes hairline y sombras suaves.
|
|
9
|
+
|
|
10
|
+
Stack: **React + TypeScript + Radix UI + lucide-react + SCSS + CSS Custom Properties**.
|
|
11
|
+
No depende de Tailwind.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Índice
|
|
16
|
+
|
|
17
|
+
1. [Requisitos](#requisitos)
|
|
18
|
+
2. [Instalación y consumo](#instalación-y-consumo)
|
|
19
|
+
3. [Uso básico](#uso-básico)
|
|
20
|
+
4. [Estilos y tokens](#estilos-y-tokens)
|
|
21
|
+
5. [Tema claro / oscuro](#tema-claro--oscuro)
|
|
22
|
+
6. [Iconos](#iconos)
|
|
23
|
+
7. [Accesibilidad](#accesibilidad)
|
|
24
|
+
8. [Estructura del paquete](#estructura-del-paquete)
|
|
25
|
+
9. [Documentación de referencia](#documentación-de-referencia)
|
|
26
|
+
10. [Versionado](#versionado)
|
|
27
|
+
11. [Publicar una versión](#publicar-una-versión)
|
|
28
|
+
12. [Troubleshooting](#troubleshooting)
|
|
29
|
+
13. [Buenas prácticas](#buenas-prácticas)
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Requisitos
|
|
34
|
+
|
|
35
|
+
- Node.js ≥ 20
|
|
36
|
+
- React `^18.0.0 || ^19.0.0` y `react-dom` (peer dependencies: los aporta la app, no el paquete)
|
|
37
|
+
- TypeScript ≥ 5.0 (para los tipos que ya se distribuyen compilados)
|
|
38
|
+
- Cualquier bundler: Vite, webpack, Rollup… **no hace falta que processe SCSS**, el paquete
|
|
39
|
+
entrega el CSS ya compilado
|
|
40
|
+
|
|
41
|
+
No necesitas configurar `vite/client` ni `allowArbitraryExtensions` en el tsconfig de tu app:
|
|
42
|
+
los tipos se distribuyen compilados en `dist/index.d.ts` y no contienen referencias a `.scss`.
|
|
43
|
+
|
|
44
|
+
### Formas de consumir el paquete
|
|
45
|
+
|
|
46
|
+
Versión actual: **`1.2.0`**.
|
|
47
|
+
|
|
48
|
+
| Vía | Cuándo | Cómo |
|
|
49
|
+
|---|---|---|
|
|
50
|
+
| **Registro con SemVer** *(recomendada)* | Apps de tu equipo, incluso fuera del monorepo | `"@danielitouci96/design-system": "^1.2.0"` |
|
|
51
|
+
| **Tarball local `.tgz`** | Sin registry, red aislada o para probar un release puntual | `npm install ../medical-platform/artifacts/medical-design-system-1.2.0.tgz` |
|
|
52
|
+
| **Por fuente (monorepo Nx)** | Desarrollo diario dentro de `medical-platform` | Alias ya resuelto en `tsconfig.base.json` |
|
|
53
|
+
|
|
54
|
+
La vía con SemVer es la recomendada porque el consumidor escribe una versión y la va actualizando
|
|
55
|
+
con `npm update`, en vez de tener que editar una ruta en cada release. Ver
|
|
56
|
+
[Publicar una versión](#publicar-una-versión) para configurar el registro.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Instalación y consumo
|
|
61
|
+
|
|
62
|
+
### 1. Instalar
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
# Desde el registro (tras configurar el .npmrc, ver más abajo)
|
|
66
|
+
npm install @danielitouci96/design-system
|
|
67
|
+
|
|
68
|
+
# O desde un tarball local
|
|
69
|
+
npm install ../medical-platform/artifacts/medical-design-system-1.2.0.tgz
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### 2. Importar el CSS (obligatorio, una sola vez)
|
|
73
|
+
|
|
74
|
+
En el punto de entrada de la app, **antes** de tus propios estilos:
|
|
75
|
+
|
|
76
|
+
```tsx
|
|
77
|
+
// src/main.tsx
|
|
78
|
+
import '@danielitouci96/design-system/styles.css'
|
|
79
|
+
import './styles/app.css' // tus overrides: gana por orden de cascada
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
> **Por qué es obligatorio.** Desde `1.1.0` la hoja de estilos **no** se inyecta sola al importar un
|
|
83
|
+
> componente. Antes lo hacía, y eso filtraba una referencia a `.scss` en los tipos publicados que
|
|
84
|
+
> obligaba a cada consumidor a configurar `vite/client` solo para poder compilar. Importar el CSS
|
|
85
|
+
> explícitamente elimina ese problema y además hace **explícito el orden de cascada**, que es lo que
|
|
86
|
+
> determina si tus overrides ganan.
|
|
87
|
+
|
|
88
|
+
El orden importa: el CSS del DS debe entrar **antes** que el tuyo para que tus overrides
|
|
89
|
+
apliquen sobre los tokens del DS.
|
|
90
|
+
|
|
91
|
+
### 3. Usar los componentes
|
|
92
|
+
|
|
93
|
+
```tsx
|
|
94
|
+
import { Button, Card, CardContent, DataTable } from '@danielitouci96/design-system'
|
|
95
|
+
|
|
96
|
+
export function Ejemplo() {
|
|
97
|
+
return (
|
|
98
|
+
<Card>
|
|
99
|
+
<CardContent>
|
|
100
|
+
<Button variant="primary">Guardar</Button>
|
|
101
|
+
</CardContent>
|
|
102
|
+
</Card>
|
|
103
|
+
)
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Importa siempre desde el paquete. Nunca desde rutas internas.
|
|
108
|
+
|
|
109
|
+
### 4. Tema de marca (opcional)
|
|
110
|
+
|
|
111
|
+
```tsx
|
|
112
|
+
import '@danielitouci96/design-system/themes/onco.css' // azul
|
|
113
|
+
import '@danielitouci96/design-system/themes/cardio.css' // violeta
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
Como plantilla para un tema propio:
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
cp node_modules/@danielitouci96/design-system/themes/tema-personalizado.css src/styles/mi-tema.css
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### Instalar desde npm (no hace falta configurar nada)
|
|
123
|
+
|
|
124
|
+
El paquete se publica en **npmjs**, que es el registro por defecto. No hay `.npmrc`, ni token, ni
|
|
125
|
+
variables de entorno: es un paquete público.
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
npm install @danielitouci96/design-system
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
Para ver qué hay publicado sin instalar nada:
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
npm view @danielitouci96/design-system versions
|
|
135
|
+
npm view @danielitouci96/design-system@latest dist-tags
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
> Este paquete **no define ningún ejecutable**, así que `npx @danielitouci96/design-system` no
|
|
139
|
+
> funciona: `npx` solo puede lanzar paquetes con un campo `bin`, y esta es una librería, no una CLI.
|
|
140
|
+
> Para probarla de verdad, instálala en un proyecto y mira la demo del monorepo.
|
|
141
|
+
|
|
142
|
+
> **Por qué el scope no es `@medical`.** El scope `@medical` está reservado en npm por una
|
|
143
|
+
> organización ajena a este proyecto, así que no se podía publicar ahí. El nombre en npmjs es
|
|
144
|
+
> **inmutable para siempre**, de modo que se eligió el scope del maintainer desde el principio. Si
|
|
145
|
+
> algún día se quisiera mover a una organización, habría que publicar con otro nombre.
|
|
146
|
+
|
|
147
|
+
### Configurar el registro (GitHub Packages, opcional)
|
|
148
|
+
|
|
149
|
+
Además de npmjs se puede publicar en **GitHub Packages** (`npm.pkg.github.com`), útil para tener una
|
|
150
|
+
copia atada al repositorio o para instalaciones internas sin salida a npmjs. Es un registro
|
|
151
|
+
**distinto**: un paquete publicado ahí **no** aparece en npmjs y viceversa. Para instalar desde ahí
|
|
152
|
+
hace falta lo siguiente.
|
|
153
|
+
|
|
154
|
+
**En la app que consume** — archivo `.npmrc` en la raíz. Esto **no es un secreto**, se commitea:
|
|
155
|
+
|
|
156
|
+
```ini
|
|
157
|
+
@danielitouci96:registry=https://npm.pkg.github.com
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
**Autenticación, siempre por variable de entorno** y nunca en un archivo del repo:
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
# Linux / servidor / CI
|
|
164
|
+
export NODE_AUTH_TOKEN="<tu personal access token de GitHub con read:packages>"
|
|
165
|
+
npm install @danielitouci96/design-system
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
```powershell
|
|
169
|
+
# Windows
|
|
170
|
+
$env:NODE_AUTH_TOKEN = "<tu personal access token de GitHub con read:packages>"
|
|
171
|
+
npm install @danielitouci96/design-system
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
**Permisos.** Cada persona del equipo pide su propio token
|
|
175
|
+
(*Settings → Developer settings → Personal access tokens → Tokens (classic)*). Para **instalar**
|
|
176
|
+
basta `read:packages`; para **publicar** hace falta `write:packages` y `repo`. Si un compañero recibe
|
|
177
|
+
un `403` o un `404` sin haber expirado el token, casi siempre es que su cuenta no tiene acceso al
|
|
178
|
+
paquete: hay que darle rol de lectura sobre el repositorio asociado al paquete.
|
|
179
|
+
|
|
180
|
+
**Visibilidad.** Los paquetes de GitHub heredan la visibilidad del repositorio: si el repo es
|
|
181
|
+
privado, el paquete es privado y necesita token para instalarse. Si el repo es público, el paquete se
|
|
182
|
+
puede instalar sin autenticación, pero **solo desde el registry de GitHub**.
|
|
183
|
+
|
|
184
|
+
**Certificados.** GitHub Packages usa un certificado público, así que no hace falta instalar ninguna
|
|
185
|
+
CA corporativa. En redes con proxy, si npm se queja, es un problema del proxy y no del registry.
|
|
186
|
+
|
|
187
|
+
### Dentro del monorepo
|
|
188
|
+
|
|
189
|
+
El path ya está resuelto en `tsconfig.base.json`:
|
|
190
|
+
|
|
191
|
+
```json
|
|
192
|
+
"paths": {
|
|
193
|
+
"@danielitouci96/design-system": ["packages/design-system/src/index.ts"]
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
En este caso se sigue importando el CSS compilado igual:
|
|
198
|
+
|
|
199
|
+
```tsx
|
|
200
|
+
import { Button } from '@danielitouci96/design-system'
|
|
201
|
+
import '@danielitouci96/design-system/styles.css'
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
### Qué contiene el paquete
|
|
205
|
+
|
|
206
|
+
| Contenido | Ruta |
|
|
207
|
+
|---|---|
|
|
208
|
+
| JS compilado (ESM) | `dist/index.es.js` |
|
|
209
|
+
| Tipos compilados | `dist/index.d.ts` (+ 121 declaraciones por componente) |
|
|
210
|
+
| CSS compilado | `dist/design-system.css` |
|
|
211
|
+
| Temas de marca | `themes/*.css` |
|
|
212
|
+
| Documentación y licencia | `README.md`, `CHANGELOG.md`, `LICENSE` |
|
|
213
|
+
|
|
214
|
+
**No** se distribuye el código fuente: el paquete son los artefactos ya compilados.
|
|
215
|
+
|
|
216
|
+
### Fuentes
|
|
217
|
+
|
|
218
|
+
El DS define `--font-sans` (Geist) y `--font-serif` (Libre Caslon), pero **no** empaqueta las
|
|
219
|
+
fontfaces. Cada app debe instalarlas:
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
npm install @fontsource-variable/geist @fontsource/libre-caslon-text
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
```tsx
|
|
226
|
+
// src/main.tsx de la app
|
|
227
|
+
import '@fontsource-variable/geist'
|
|
228
|
+
import '@fontsource/libre-caslon-text'
|
|
229
|
+
import '@fontsource/libre-caslon-text/400.css'
|
|
230
|
+
import '@fontsource/libre-caslon-text/400-italic.css'
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
---
|
|
234
|
+
|
|
235
|
+
## Uso básico
|
|
236
|
+
|
|
237
|
+
```tsx
|
|
238
|
+
import {
|
|
239
|
+
Alert,
|
|
240
|
+
Badge,
|
|
241
|
+
Button,
|
|
242
|
+
DataTable,
|
|
243
|
+
Input,
|
|
244
|
+
Modal,
|
|
245
|
+
Select,
|
|
246
|
+
SelectItem,
|
|
247
|
+
Tag,
|
|
248
|
+
type DataTableColumn,
|
|
249
|
+
} from '@danielitouci96/design-system';
|
|
250
|
+
|
|
251
|
+
export function PanelEstudio() {
|
|
252
|
+
return (
|
|
253
|
+
<>
|
|
254
|
+
<Alert tone="success" title="Enmienda sincronizada">
|
|
255
|
+
La cohorte de dosis fue aprobada por la junta de revisión institucional.
|
|
256
|
+
</Alert>
|
|
257
|
+
|
|
258
|
+
<Button variant="primary" iconRight="ArrowRight">
|
|
259
|
+
Iniciar estudio
|
|
260
|
+
</Button>
|
|
261
|
+
<Button variant="outline" iconLeft="Filter">
|
|
262
|
+
Criterios de filtro
|
|
263
|
+
</Button>
|
|
264
|
+
|
|
265
|
+
<Tag tone="success" icon="Check">HER2+ confirmado</Tag>
|
|
266
|
+
<Badge tone="info">Evaluando in silico</Badge>
|
|
267
|
+
|
|
268
|
+
<Input placeholder="Filtrar por ID de sujeto…" fullWidth />
|
|
269
|
+
|
|
270
|
+
<Select placeholder="Paradigma de dosificación" fullWidth>
|
|
271
|
+
<SelectItem value="adaptativa">Titulación adaptativa</SelectItem>
|
|
272
|
+
<SelectItem value="fija">Fija · 300 mg semanales</SelectItem>
|
|
273
|
+
</Select>
|
|
274
|
+
|
|
275
|
+
<Modal trigger={<Button>Ver detalle</Button>} title="Detalle de cohorte">
|
|
276
|
+
Contenido…
|
|
277
|
+
</Modal>
|
|
278
|
+
</>
|
|
279
|
+
);
|
|
280
|
+
}
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
### DataTable con tipado estricto
|
|
284
|
+
|
|
285
|
+
```tsx
|
|
286
|
+
interface Cohorte { id: string; biomarcador: string; adherencia: number }
|
|
287
|
+
|
|
288
|
+
const columnas: DataTableColumn<Cohorte>[] = [
|
|
289
|
+
{ id: 'id', accessorKey: 'id', header: 'ID de sujeto' },
|
|
290
|
+
{
|
|
291
|
+
id: 'biomarcador',
|
|
292
|
+
header: 'Fenotipo',
|
|
293
|
+
cell: (row) => <Tag tone="success">{row.biomarcador}</Tag>,
|
|
294
|
+
},
|
|
295
|
+
{
|
|
296
|
+
id: 'adherencia',
|
|
297
|
+
accessorKey: 'adherencia',
|
|
298
|
+
header: 'Adherencia',
|
|
299
|
+
cell: (row) => `${row.adherencia}%`,
|
|
300
|
+
},
|
|
301
|
+
];
|
|
302
|
+
|
|
303
|
+
<DataTable<Cohorte>
|
|
304
|
+
columns={columnas}
|
|
305
|
+
data={datos}
|
|
306
|
+
getRowId={(r) => r.id}
|
|
307
|
+
striped
|
|
308
|
+
pagination={{ page, pageCount, onPageChange: setPage, totalItems: 128 }}
|
|
309
|
+
/>
|
|
310
|
+
```
|
|
311
|
+
|
|
312
|
+
Soporta: ordenación, selección de filas, `renderRowActions`, esqueletos de carga, estados de error,
|
|
313
|
+
paginación con selector de tamaño de página y modo denso.
|
|
314
|
+
|
|
315
|
+
---
|
|
316
|
+
|
|
317
|
+
## Estilos y tokens
|
|
318
|
+
|
|
319
|
+
Todos los tokens se exponen como **CSS Custom Properties** una vez importada la librería.
|
|
320
|
+
Puedes usarlos en tu propio SCSS/CSS:
|
|
321
|
+
|
|
322
|
+
```scss
|
|
323
|
+
.panel-oncologico {
|
|
324
|
+
background: var(--color-surface-elevated);
|
|
325
|
+
border: 1px solid var(--color-divider);
|
|
326
|
+
border-radius: var(--radius-card);
|
|
327
|
+
box-shadow: var(--shadow-card);
|
|
328
|
+
font-family: var(--font-sans);
|
|
329
|
+
color: var(--color-text-secondary);
|
|
330
|
+
}
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
### Grupos de variables (rutas en `src/foundations/tokens/`)
|
|
334
|
+
|
|
335
|
+
| Grupo | Archivo(s) | Ejemplos |
|
|
336
|
+
|---|---|---|
|
|
337
|
+
| Colores semánticos | `colors/_semantic.scss` | `--color-primary`, `--color-secondary`, `--color-surface`, `--color-surface-elevated`, `--color-surface-sunken`, `--color-text-primary/secondary/tertiary`, `--color-divider`, `--color-border(-subtle/strong)`, `--color-success`, `--color-warning`, `--color-danger`, `--color-info`, `--color-link` |
|
|
338
|
+
| Colores primitivos | `colors/_primitive.scss` | `--gray-0…950`, `--grove-50…950`, `--red-50…950`, `--yellow-50…950` |
|
|
339
|
+
| Tipografía | `typography/_primitive.scss` y `_semantic.scss` | `--font-sans`, `--font-serif`, `--font-mono`, `--font-size-2xs…7xl`, `--font-weight-*`, `--font-label-*`, `--font-heading-*`, `--font-display`, `--letter-spacing-*`, `--line-height-*` |
|
|
340
|
+
| Espaciado | `spacing/` | `--space-1…24`, `--space-component-*` |
|
|
341
|
+
| Radios | `radius/_semantic.scss` | `--radius-control`, `--radius-card`, `--radius-modal`, `--radius-table`, `--radius-full` |
|
|
342
|
+
| Sombras | `shadows/_semantic.scss` | `--shadow-card`, `--shadow-modal`, `--shadow-popover`, `--shadow-menu`, `--shadow-hairline` |
|
|
343
|
+
| Tokens de componente | `component/` | `--card-*`, `--table-*`, `--badge-*`, `--tag-*`, `--alert-*`, `--button-*`, `--input-*` (mira cada archivo) |
|
|
344
|
+
|
|
345
|
+
Los tokens de componente se pueden **sobrescribir a nivel de contenedor** para variantes locales:
|
|
346
|
+
|
|
347
|
+
```scss
|
|
348
|
+
.mis-tarjetas {
|
|
349
|
+
--card-radius: 24px;
|
|
350
|
+
--card-shadow: 0 20px 40px rgb(16 24 40 / 0.08);
|
|
351
|
+
}
|
|
352
|
+
```
|
|
353
|
+
|
|
354
|
+
---
|
|
355
|
+
|
|
356
|
+
## Tema claro / oscuro
|
|
357
|
+
|
|
358
|
+
El DS es claro por defecto y define overrides en `:root[data-theme='dark']`.
|
|
359
|
+
Para cambiar de tema en una app:
|
|
360
|
+
|
|
361
|
+
```ts
|
|
362
|
+
function toggleTheme() {
|
|
363
|
+
const html = document.documentElement;
|
|
364
|
+
html.dataset.theme = html.dataset.theme === 'dark' ? 'light' : 'dark';
|
|
365
|
+
// persiste: localStorage / cookie / preferencia de usuario
|
|
366
|
+
}
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
Los componentes y tokens reaccionan automáticamente; la app no necesita estilos extra.
|
|
370
|
+
|
|
371
|
+
---
|
|
372
|
+
|
|
373
|
+
## Temas por aplicación (colores distintos por app)
|
|
374
|
+
|
|
375
|
+
Cada app puede tener **su propio tema de marca** sobrescribiendo tokens **semánticos**
|
|
376
|
+
(`--color-*`) en su propio CSS. Los componentes del DS leen `--color-*`, así que **no hay que
|
|
377
|
+
tocar el paquete**: solo redefinir tokens.
|
|
378
|
+
|
|
379
|
+
### A) Un tema por app (lo más común)
|
|
380
|
+
|
|
381
|
+
Crea en tu app un archivo de tema, p. ej. `src/styles/tema.css`, y **impórtalo después del DS**:
|
|
382
|
+
|
|
383
|
+
```css
|
|
384
|
+
/* src/styles/tema.css */
|
|
385
|
+
:root {
|
|
386
|
+
--color-secondary: #075d9e; /* tu color de marca / acento */
|
|
387
|
+
--color-secondary-hover: #064a7e;
|
|
388
|
+
--color-secondary-soft: #e6f1fa;
|
|
389
|
+
--color-on-secondary: #ffffff; /* texto encima del acento */
|
|
390
|
+
--color-link: #075d9e;
|
|
391
|
+
--color-link-hover: #064a7e;
|
|
392
|
+
--color-border-focus: #075d9e; /* anillos de foco */
|
|
393
|
+
--color-selection-bg: #075d9e; /* selección de texto */
|
|
394
|
+
}
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
Con esto botones de acento, logo, enlaces, badges, focus rings y selección cambian solos.
|
|
398
|
+
|
|
399
|
+
### B) Varios temas en una misma app (white-label / multi-marca)
|
|
400
|
+
|
|
401
|
+
Usa un selector **scoped** que tu app controla (por ejemplo `data-brand`):
|
|
402
|
+
|
|
403
|
+
```css
|
|
404
|
+
:root[data-brand='clinicA'] {
|
|
405
|
+
--color-secondary: #7050c8;
|
|
406
|
+
--color-secondary-hover: #5a3cc0;
|
|
407
|
+
--color-secondary-soft: #f0ecfd;
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
:root[data-brand='clinicB'] {
|
|
411
|
+
--color-secondary: #075d9e;
|
|
412
|
+
--color-secondary-soft: #e6f1fa;
|
|
413
|
+
}
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
```tsx
|
|
417
|
+
document.documentElement.dataset.brand = 'clinicA'; // o en un contenedor <div data-brand="clinicA">
|
|
418
|
+
```
|
|
419
|
+
|
|
420
|
+
### Modo oscuro
|
|
421
|
+
|
|
422
|
+
Si tu tema necesita colores distintos en oscuro, define la variante con los **dos atributos**:
|
|
423
|
+
|
|
424
|
+
```css
|
|
425
|
+
:root[data-brand='clinicA'][data-theme='dark'] {
|
|
426
|
+
--color-secondary: #9d87ef;
|
|
427
|
+
--color-secondary-hover: #b6a4f4;
|
|
428
|
+
--color-secondary-soft: #221a45;
|
|
429
|
+
--color-on-secondary: #120d26;
|
|
430
|
+
}
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
### Plantilla y temas listos
|
|
434
|
+
|
|
435
|
+
El paquete incluye la carpeta **`themes/`** listos para copiar o importar:
|
|
436
|
+
|
|
437
|
+
| Archivo | Qué es |
|
|
438
|
+
|---|---|
|
|
439
|
+
| `themes/tema-personalizado.css` | **Plantilla** con todos los tokens semánticos comentados (luz + oscuro). Cópialo a tu app y descomenta lo que cambies. |
|
|
440
|
+
| `themes/onco.css` | Tema de marca **azul** (con su modo oscuro). |
|
|
441
|
+
| `themes/cardio.css` | Tema de marca **violeta** (con su modo oscuro). |
|
|
442
|
+
|
|
443
|
+
**Tema listo para aplicar a toda la app** (impórtalo después del DS):
|
|
444
|
+
|
|
445
|
+
```tsx
|
|
446
|
+
import '@danielitouci96/design-system';
|
|
447
|
+
import '@danielitouci96/design-system/themes/onco.css'; // o cardio.css / tu tema copiado
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
> **Cómo importarlo según tu app**
|
|
451
|
+
> - **Fuera del monorepo (paquete publicado):** el subpath `@danielitouci96/design-system/themes/...`
|
|
452
|
+
> funciona gracias al campo `exports` del paquete. Nada que configurar.
|
|
453
|
+
> - **Dentro del monorepo con Vite (como la demo):** configura el alias
|
|
454
|
+
> `@danielitouci96/design-system/themes → packages/design-system/themes/` (mira
|
|
455
|
+
> `apps/design-system-demo/vite.config.ts`).
|
|
456
|
+
> - **Atajo sin aliases:** copia el archivo a tu app (`src/styles/tema.css`) e impórtalo
|
|
457
|
+
> con una ruta relativa: `import './styles/tema.css';`
|
|
458
|
+
|
|
459
|
+
**Multi-marca**: abre el archivo de tema y cambia el selector de `:root` a
|
|
460
|
+
`:root[data-brand='miCliente']` (y su variante oscura con `[data-theme='dark']`).
|
|
461
|
+
|
|
462
|
+
Si publicas el paquete como dependencia, `themes/` viaja incluido en el artefacto
|
|
463
|
+
(campo `files` de `package.json` y export `@danielitouci96/design-system/themes/*`).
|
|
464
|
+
|
|
465
|
+
### Reglas
|
|
466
|
+
|
|
467
|
+
1. Sobrescribe **semánticos** (`--color-*`), nunca primitivos (`--gray-*`, `--grove-*`).
|
|
468
|
+
Así el resto del sistema (estados focus, contrastes del modo oscuro) sigue coherente.
|
|
469
|
+
2. Si tu CSS de tema se carga después del DS, ganas por cascada; si lo cargas antes, usa
|
|
470
|
+
`:root` con la misma especificidad o un selector con `data-brand`.
|
|
471
|
+
3. El verde de `success` se mantiene por defecto (es el color "OK" clínico) — sobrescríbelo con
|
|
472
|
+
`--color-success` solo si quieres cambiarlo.
|
|
473
|
+
4. **Ejemplo en vivo:** la demo (`apps/design-system-demo`, puerto 4401) tiene un selector de tema
|
|
474
|
+
en el header (Grove verde / Onco azul / Cardio violeta) que muestra exactamente este patrón,
|
|
475
|
+
incluyendo las variantes oscuras. Revisa `apps/design-system-demo/src/styles.scss` (sección
|
|
476
|
+
"TEMAS DE MARCA").
|
|
477
|
+
|
|
478
|
+
---
|
|
479
|
+
|
|
480
|
+
## Iconos
|
|
481
|
+
|
|
482
|
+
`Icon` expone todo el set de **lucide-react**:
|
|
483
|
+
|
|
484
|
+
```tsx
|
|
485
|
+
import { Icon } from '@danielitouci96/design-system';
|
|
486
|
+
|
|
487
|
+
<Icon name="Search" size="sm" />
|
|
488
|
+
<Icon name="Bell" size="md" color="var(--color-text-secondary)" label="Notificaciones" />
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
- `size`: `xs | sm | md | lg | xl` (o un número en px).
|
|
492
|
+
- `name` está tipado: `IconName = keyof typeof LucideIcons`.
|
|
493
|
+
- Sin `label` el icono es `aria-hidden`; con `label` se vuelve accesible.
|
|
494
|
+
- Los componentes que admiten iconos lo hacen por nombre: `Button iconLeft="Plus"` /
|
|
495
|
+
`iconRight="ArrowRight"`, `Tag icon="Check"`, `IconButton icon="MoreVertical"`.
|
|
496
|
+
|
|
497
|
+
---
|
|
498
|
+
|
|
499
|
+
## Accesibilidad
|
|
500
|
+
|
|
501
|
+
Los controles interactivos usan **Radix UI**: Switch, Select, Checkbox, RadioGroup, Modal/Dialog,
|
|
502
|
+
Drawer, DropdownMenu, Tooltip, Popover, Tabs, Slider, Toast, Avatar.
|
|
503
|
+
Esto aporta ARIA, navegación por teclado, gestión de foco y `data-state` listos para estilar.
|
|
504
|
+
|
|
505
|
+
Los componentes simples (Button, DataTable, Pagination…) implementan sus atributos accesibles de
|
|
506
|
+
forma nativa (aria-label requerido en IconButton, `aria-sort` en tablas ordenables, etc.).
|
|
507
|
+
|
|
508
|
+
---
|
|
509
|
+
|
|
510
|
+
## Estructura del paquete
|
|
511
|
+
|
|
512
|
+
```
|
|
513
|
+
packages/design-system/
|
|
514
|
+
├─ src/
|
|
515
|
+
│ ├─ index.ts ← ÚNICA API pública (todos los exports)
|
|
516
|
+
│ ├─ styles/index.scss ← hoja global (tokens + reset + utilidades)
|
|
517
|
+
│ ├─ foundations/
|
|
518
|
+
│ │ ├─ tokens/ ← tokens SCSS (colors, typography, spacing, radius, shadows, component)
|
|
519
|
+
│ │ └─ breakpoints/ ← mixins responsive
|
|
520
|
+
│ ├─ primitives/ ← Box, Stack, Inline, Grid, Container, Text, Heading, Link, Divider
|
|
521
|
+
│ ├─ components/ ← componentes (ver catálogo abajo)
|
|
522
|
+
│ └─ icons/Icon.tsx ← Icon (lucide-react)
|
|
523
|
+
├─ themes/ ← plantilla de tema + temas de marca listos (onco, cardio)
|
|
524
|
+
├─ dist/ ← salida del build (vite build)
|
|
525
|
+
└─ package.json
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
### Catálogo de componentes
|
|
529
|
+
|
|
530
|
+
- **Primitivos:** Box · Stack · Inline · Grid · Container · Text · Heading · Link · Divider
|
|
531
|
+
- **Botones:** Button · IconButton · ButtonGroup
|
|
532
|
+
- **Entradas:** FormField · Label · Input · Textarea · PasswordInput · SearchInput · NumberInput ·
|
|
533
|
+
Select(+Item) · MultiSelect · Combobox · Checkbox · RadioGroup · Switch · Slider
|
|
534
|
+
- **Feedback:** Alert · Toast · Spinner · Skeleton · Progress
|
|
535
|
+
- **Superficies / overlays:** Card · Modal · ConfirmDialog · Drawer · Popover · Tooltip ·
|
|
536
|
+
DropdownMenu
|
|
537
|
+
- **Datos:** Badge · Tag · Chip · Avatar · StatusIndicator · DataTable · Table · Pagination
|
|
538
|
+
- **Navegación:** Navbar · Sidebar · Tabs · Stepper · Breadcrumb
|
|
539
|
+
- **Extras:** Calendar · Icon
|
|
540
|
+
|
|
541
|
+
---
|
|
542
|
+
|
|
543
|
+
## Documentación de referencia
|
|
544
|
+
|
|
545
|
+
- **Demo viva (biblioteca de componentes):** `apps/design-system-demo` →
|
|
546
|
+
levantarla con `npx nx run design-system-demo:dev` (http://localhost:4401).
|
|
547
|
+
Muestra el sistema Grove en acción: header, métricas, botones, tabla de datos, formularios,
|
|
548
|
+
feedback, dark mode y tokens.
|
|
549
|
+
- **API pública:** `src/index.ts`, cada export está comentado.
|
|
550
|
+
- **Props y tipos:** JSDoc en el `.tsx` de cada componente, y los `.d.ts` ya vienen compilados
|
|
551
|
+
en el paquete, así que el autocompletado funciona sin configurar nada.
|
|
552
|
+
- **Muestrario (referencia viva):** `apps/design-system-demo` → `npx nx run design-system-demo:dev`
|
|
553
|
+
(http://localhost:4401). Es la referencia oficial: cada componente con sus variantes, la tabla de
|
|
554
|
+
props y el snippet copiable.
|
|
555
|
+
|
|
556
|
+
> Storybook se eliminó en `1.1.0`: no lo consumía nadie y duplicaba el trabajo de documentación que
|
|
557
|
+
> ya cubre el Muestrario. El Muestrario es el único sitio de referencia.
|
|
558
|
+
|
|
559
|
+
---
|
|
560
|
+
|
|
561
|
+
## Versionado
|
|
562
|
+
|
|
563
|
+
El paquete sigue **SemVer**, con una regla propia para los cambios visuales, que en un design system
|
|
564
|
+
son tan contractuales como los de API.
|
|
565
|
+
|
|
566
|
+
| Versión | Cuándo |
|
|
567
|
+
|---|---|
|
|
568
|
+
| **patch** (`1.0.2` → `1.0.3`) | Correcciones que **no** cambian lo que se ve: fallos de render, de accesibilidad o de tipos. |
|
|
569
|
+
| **minor** (`1.0.3` → `1.1.0`) | Componentes, props o tokens nuevos. **Y también los cambios visuales deliberados**: mover un espaciado, un radio, un color, un tamaño de fuente. |
|
|
570
|
+
| **major** (`1.1.0` → `2.0.0`) | Se quita o renombra algo de la API, se cambia un valor por defecto del que una app dependía, o el cambio visual obliga a tocar código. |
|
|
571
|
+
|
|
572
|
+
La regla que lo resume:
|
|
573
|
+
|
|
574
|
+
> **Si al actualizar, una app se ve distinta sin haber tocado código, es como mínimo `minor`, y el
|
|
575
|
+
> CHANGELOG tiene que decir qué se movió.**
|
|
576
|
+
|
|
577
|
+
Esto importa especialmente aquí, porque las apps de tu equipo apilan sus propios overrides sobre los
|
|
578
|
+
tokens del DS. Cuando el DS cambia un valor, el resultado depende del orden de cascada. Por eso el
|
|
579
|
+
CHANGELOG se escribe siempre mirando la diff visual, no solo el código.
|
|
580
|
+
|
|
581
|
+
---
|
|
582
|
+
|
|
583
|
+
## Publicar una versión
|
|
584
|
+
|
|
585
|
+
### Para quien mantiene el paquete
|
|
586
|
+
|
|
587
|
+
```bash
|
|
588
|
+
# 1. Verificar que todo está verde
|
|
589
|
+
npx nx run @danielitouci96/design-system:test
|
|
590
|
+
npm run build:design-system
|
|
591
|
+
|
|
592
|
+
# 2. Subir la versión (actualiza package.json)
|
|
593
|
+
npm version patch # o minor / major
|
|
594
|
+
|
|
595
|
+
# 3. Escribir el CHANGELOG y hacer commit de ambos
|
|
596
|
+
git add packages/design-system/package.json packages/design-system/CHANGELOG.md
|
|
597
|
+
git commit -m "release(ds): 1.0.3"
|
|
598
|
+
|
|
599
|
+
# 4. Crear el tarball (prepack compila automáticamente)
|
|
600
|
+
npm pack --pack-destination artifacts ./packages/design-system
|
|
601
|
+
```
|
|
602
|
+
|
|
603
|
+
Publicar en **npmjs**, que es el destino por defecto, requiere una cuenta en npmjs.org con **2FA
|
|
604
|
+
activado**. npm ya no admite publicar con contraseña: se usa un *automation token*.
|
|
605
|
+
|
|
606
|
+
```bash
|
|
607
|
+
# 1. En npmjs.com -> tu perfil -> Access Tokens -> Generate New Token
|
|
608
|
+
# -> tipo "Automation", con el paquete y solo permiso "Read & Write"
|
|
609
|
+
# 2. El token va SIEMPRE en la variable de entorno, nunca en un archivo versionado
|
|
610
|
+
export NODE_AUTH_TOKEN="<token de automatización de npmjs>"
|
|
611
|
+
|
|
612
|
+
cd packages/design-system
|
|
613
|
+
npm publish
|
|
614
|
+
```
|
|
615
|
+
|
|
616
|
+
El `publishConfig` del paquete es `{ "access": "public" }` y **no** fija registry, a propósito: un
|
|
617
|
+
`npm publish` a secas va a npmjs y nace público, que es el destino principal. Fijar aquí el registry
|
|
618
|
+
de GitHub Packages sería una trampa, porque en un `npm publish` sin flags ganaría el `publishConfig` y
|
|
619
|
+
el paquete se iría al registry equivocado y con visibilidad equivocada.
|
|
620
|
+
|
|
621
|
+
**Publicar también en GitHub Packages** es opt-in, con `--registry` explícito:
|
|
622
|
+
|
|
623
|
+
```bash
|
|
624
|
+
npm publish --registry https://npm.pkg.github.com
|
|
625
|
+
```
|
|
626
|
+
|
|
627
|
+
> Comprobado que los flags mandan sobre `publishConfig`: `--registry` y `--access` lo pisan. Aun así
|
|
628
|
+
> es más seguro que el default sea lo correcto en vez de depender de acordarse de los flags.
|
|
629
|
+
|
|
630
|
+
> **La versión es inmutable.** Ni npmjs ni GitHub Packages permiten republicar una versión ya
|
|
631
|
+
> publicada; hay que subir la siguiente. Por eso conviene publicar solo cuando los tests están en
|
|
632
|
+
> verde. Y ojo: en npmjs el **nombre** tampoco se puede cambiar una vez publicado.
|
|
633
|
+
|
|
634
|
+
Publicar **no** es obligatorio: el tarball del paso 4 ya es consumible por cualquier app del equipo.
|
|
635
|
+
Es el plan B para redes sin salida a internet.
|
|
636
|
+
|
|
637
|
+
### Automatizarlo
|
|
638
|
+
|
|
639
|
+
El versionado manual es el punto de fricción. El siguiente paso natural es
|
|
640
|
+
**Changesets** (o `nx release`), que genera el CHANGELOG, decide la versión según el tipo de cambio
|
|
641
|
+
declarado en el PR y publica al hacer merge a `main`. Con eso, publicar una versión pasa de ser una
|
|
642
|
+
tarea manual a ser un efecto secundario del PR.
|
|
643
|
+
|
|
644
|
+
---
|
|
645
|
+
|
|
646
|
+
## Troubleshooting
|
|
647
|
+
|
|
648
|
+
**No tengo estilos / los componentes salen sin CSS**
|
|
649
|
+
Falta el import del CSS en el punto de entrada. Es obligatorio desde `1.1.0`:
|
|
650
|
+
`import '@danielitouci96/design-system/styles.css'`, y **antes** de tus propios estilos.
|
|
651
|
+
|
|
652
|
+
**`Cannot find module '@danielitouci96/design-system'` o tipos que no resuelven**
|
|
653
|
+
Si tu `package.json` apunta a una ruta `.tgz`, recuerda que hay que volver a instalar tras cada
|
|
654
|
+
release nuevo (el contenido cambia aunque la versión no). Con SemVer (`^1.2.0`) esto no pasa.
|
|
655
|
+
|
|
656
|
+
**`EINTEGRITY: integrity checksum failed`**
|
|
657
|
+
Solo con dependencia `file:` a un tarball. El `package-lock.json` guarda el hash `sha512` del `.tgz`,
|
|
658
|
+
así que si **reempaquetas la misma versión** (por ejemplo para corregir un `repository`), el lock
|
|
659
|
+
apunta a un hash que ya no existe y la instalación falla aunque el tarball sea válido. No es que esté
|
|
660
|
+
corrupto: es que la versión no cambió pero el contenido sí, y para npm eso es otra paquete.
|
|
661
|
+
|
|
662
|
+
Se arregla regenerando la entrada, sin tocar el resto del lockfile:
|
|
663
|
+
|
|
664
|
+
```bash
|
|
665
|
+
npm install @danielitouci96/design-system@file:../medical-platform/artifacts/medical-design-system-1.2.0.tgz
|
|
666
|
+
```
|
|
667
|
+
|
|
668
|
+
Es otra razón para no depender de tarballs: la primera versión publicada en el registry elimina el
|
|
669
|
+
problema de raíz, porque allí el contenido se sella en la versión y no se puede reempaquetar.
|
|
670
|
+
|
|
671
|
+
**`Invalid hook call`**
|
|
672
|
+
Hay dos copias de React. Comprueba que tu app **no** tenga `react` en sus `dependencies` de la
|
|
673
|
+
librería: el paquete lo declara solo como `peerDependency`, y por eso tu app debe aportar una única
|
|
674
|
+
versión de React.
|
|
675
|
+
|
|
676
|
+
**Los estilos de mi app pisan los del DS (o al revés)**
|
|
677
|
+
Es orden de cascada. El CSS del DS va primero; tus overrides después. Si necesitas que un token del
|
|
678
|
+
DS cambie de valor, sobrescribe el token en vez de escribir CSS contra las clases internas.
|
|
679
|
+
|
|
680
|
+
**`Error: Tooltip must be used within TooltipProvider`**
|
|
681
|
+
Corregido en `1.0.2`: `Tooltip` ya monta su propio provider. Si te aparece, estás en una versión
|
|
682
|
+
anterior; actualiza.
|
|
683
|
+
|
|
684
|
+
---
|
|
685
|
+
|
|
686
|
+
## Buenas prácticas
|
|
687
|
+
|
|
688
|
+
1. **Importa solo de `@danielitouci96/design-system`.** Nunca rutas internas (`src/components/...`).
|
|
689
|
+
Es la garantía de tree-shaking y de que la API no se fragmente.
|
|
690
|
+
2. **No añadas Tailwind** sobre este DS. Usa los tokens CSS y las clases del paquete.
|
|
691
|
+
3. **Espacio plano, rutas absolutas** en la integración (sin `cd`, sin rutas relativas frágiles).
|
|
692
|
+
4. **No repitas estilos de componentes**: aprovecha la sobrescritura de tokens en lugar de CSS de
|
|
693
|
+
la app, salvo para layout específico de página.
|
|
694
|
+
5. **Usa los componentes de la tabla/overlay ya existentes** (DataTable, Modal, Toast) en lugar de
|
|
695
|
+
reinventarlos; están tipados, son accesibles y siguen el lenguaje Grove.
|
|
696
|
+
6. **Iconos siempre por nombre** con `aria-label` cuando el icono sea el único contenido del botón.
|
|
697
|
+
7. **Para cambios visuales globales**, edita los tokens (en `foundations/tokens/`), no el CSS de
|
|
698
|
+
cada componente. Así el cambio se propaga a todas las apps.
|
|
699
|
+
|
|
700
|
+
---
|
|
701
|
+
|
|
702
|
+
## Licencia
|
|
703
|
+
|
|
704
|
+
**MIT**. Puedes usar, copiar, modificar, forksar y redistribuir este paquete, también en
|
|
705
|
+
proyectos comerciales, sin pedir permiso. La única obligación es conservar el aviso de copyright
|
|
706
|
+
en las copias.
|
|
707
|
+
|
|
708
|
+
```bash
|
|
709
|
+
npm i @danielitouci96/design-system
|
|
710
|
+
```
|
|
711
|
+
|
|
712
|
+
El texto completo está en [`LICENSE`](./LICENSE). Titular del copyright: `Danielitouci96`.
|
|
713
|
+
|
|
714
|
+
> Sobre el cumplimiento normativo: MIT cubre el **código** de este paquete. Si tus apps lo usan en un
|
|
715
|
+
> contexto clínico o regulatorio, los requisitos de validación (GCP, 21 CFR Parte 11, ISO 13485)
|
|
716
|
+
> recaen sobre **tu** aplicación y tu proceso de validación, no sobre la licencia del componente.
|
|
717
|
+
|
|
718
|
+
---
|
|
719
|
+
|
|
720
|
+
© 2026 Danielitouci96 · MIT. Conforme a GCP / 21 CFR Parte 11 en las apps consumidoras.
|