@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.
Files changed (253) hide show
  1. package/CHANGELOG.md +239 -0
  2. package/LICENSE +21 -0
  3. package/README.md +720 -0
  4. package/dist/components/Alert/Alert.d.ts +20 -0
  5. package/dist/components/Alert/Alert.d.ts.map +1 -0
  6. package/dist/components/Alert/index.d.ts +2 -0
  7. package/dist/components/Alert/index.d.ts.map +1 -0
  8. package/dist/components/Avatar/Avatar.d.ts +15 -0
  9. package/dist/components/Avatar/Avatar.d.ts.map +1 -0
  10. package/dist/components/Avatar/index.d.ts +2 -0
  11. package/dist/components/Avatar/index.d.ts.map +1 -0
  12. package/dist/components/Badge/Badge.d.ts +17 -0
  13. package/dist/components/Badge/Badge.d.ts.map +1 -0
  14. package/dist/components/Badge/index.d.ts +2 -0
  15. package/dist/components/Badge/index.d.ts.map +1 -0
  16. package/dist/components/Breadcrumb/Breadcrumb.d.ts +16 -0
  17. package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -0
  18. package/dist/components/Breadcrumb/index.d.ts +2 -0
  19. package/dist/components/Breadcrumb/index.d.ts.map +1 -0
  20. package/dist/components/Button/Button.d.ts +26 -0
  21. package/dist/components/Button/Button.d.ts.map +1 -0
  22. package/dist/components/Button/index.d.ts +2 -0
  23. package/dist/components/Button/index.d.ts.map +1 -0
  24. package/dist/components/ButtonGroup/ButtonGroup.d.ts +16 -0
  25. package/dist/components/ButtonGroup/ButtonGroup.d.ts.map +1 -0
  26. package/dist/components/ButtonGroup/index.d.ts +2 -0
  27. package/dist/components/ButtonGroup/index.d.ts.map +1 -0
  28. package/dist/components/Calendar/Calendar.d.ts +15 -0
  29. package/dist/components/Calendar/Calendar.d.ts.map +1 -0
  30. package/dist/components/Calendar/index.d.ts +2 -0
  31. package/dist/components/Calendar/index.d.ts.map +1 -0
  32. package/dist/components/Card/Card.d.ts +27 -0
  33. package/dist/components/Card/Card.d.ts.map +1 -0
  34. package/dist/components/Card/index.d.ts +2 -0
  35. package/dist/components/Card/index.d.ts.map +1 -0
  36. package/dist/components/Checkbox/Checkbox.d.ts +16 -0
  37. package/dist/components/Checkbox/Checkbox.d.ts.map +1 -0
  38. package/dist/components/Checkbox/index.d.ts +2 -0
  39. package/dist/components/Checkbox/index.d.ts.map +1 -0
  40. package/dist/components/Chip/Chip.d.ts +14 -0
  41. package/dist/components/Chip/Chip.d.ts.map +1 -0
  42. package/dist/components/Chip/index.d.ts +2 -0
  43. package/dist/components/Chip/index.d.ts.map +1 -0
  44. package/dist/components/Combobox/Combobox.d.ts +23 -0
  45. package/dist/components/Combobox/Combobox.d.ts.map +1 -0
  46. package/dist/components/Combobox/index.d.ts +2 -0
  47. package/dist/components/Combobox/index.d.ts.map +1 -0
  48. package/dist/components/DataTable/DataTable.d.ts +89 -0
  49. package/dist/components/DataTable/DataTable.d.ts.map +1 -0
  50. package/dist/components/DataTable/Table.d.ts +18 -0
  51. package/dist/components/DataTable/Table.d.ts.map +1 -0
  52. package/dist/components/DataTable/index.d.ts +3 -0
  53. package/dist/components/DataTable/index.d.ts.map +1 -0
  54. package/dist/components/DatePicker/DatePicker.d.ts +16 -0
  55. package/dist/components/DatePicker/DatePicker.d.ts.map +1 -0
  56. package/dist/components/DatePicker/index.d.ts +2 -0
  57. package/dist/components/DatePicker/index.d.ts.map +1 -0
  58. package/dist/components/DateRangePicker/DateRangePicker.d.ts +17 -0
  59. package/dist/components/DateRangePicker/DateRangePicker.d.ts.map +1 -0
  60. package/dist/components/DateRangePicker/index.d.ts +2 -0
  61. package/dist/components/DateRangePicker/index.d.ts.map +1 -0
  62. package/dist/components/DateTimePicker/DateTimePicker.d.ts +16 -0
  63. package/dist/components/DateTimePicker/DateTimePicker.d.ts.map +1 -0
  64. package/dist/components/DateTimePicker/index.d.ts +2 -0
  65. package/dist/components/DateTimePicker/index.d.ts.map +1 -0
  66. package/dist/components/Drawer/Drawer.d.ts +24 -0
  67. package/dist/components/Drawer/Drawer.d.ts.map +1 -0
  68. package/dist/components/Drawer/index.d.ts +2 -0
  69. package/dist/components/Drawer/index.d.ts.map +1 -0
  70. package/dist/components/DropdownMenu/DropdownMenu.d.ts +32 -0
  71. package/dist/components/DropdownMenu/DropdownMenu.d.ts.map +1 -0
  72. package/dist/components/DropdownMenu/index.d.ts +2 -0
  73. package/dist/components/DropdownMenu/index.d.ts.map +1 -0
  74. package/dist/components/FilterBar/ActiveFilters.d.ts +9 -0
  75. package/dist/components/FilterBar/ActiveFilters.d.ts.map +1 -0
  76. package/dist/components/FilterBar/FilterBar.d.ts +21 -0
  77. package/dist/components/FilterBar/FilterBar.d.ts.map +1 -0
  78. package/dist/components/FilterBar/FilterButton.d.ts +13 -0
  79. package/dist/components/FilterBar/FilterButton.d.ts.map +1 -0
  80. package/dist/components/FilterBar/FilterChip.d.ts +15 -0
  81. package/dist/components/FilterBar/FilterChip.d.ts.map +1 -0
  82. package/dist/components/FilterBar/filters.d.ts +54 -0
  83. package/dist/components/FilterBar/filters.d.ts.map +1 -0
  84. package/dist/components/FilterBar/index.d.ts +6 -0
  85. package/dist/components/FilterBar/index.d.ts.map +1 -0
  86. package/dist/components/FormField/FormField.d.ts +29 -0
  87. package/dist/components/FormField/FormField.d.ts.map +1 -0
  88. package/dist/components/FormField/index.d.ts +2 -0
  89. package/dist/components/FormField/index.d.ts.map +1 -0
  90. package/dist/components/IconButton/IconButton.d.ts +17 -0
  91. package/dist/components/IconButton/IconButton.d.ts.map +1 -0
  92. package/dist/components/IconButton/index.d.ts +2 -0
  93. package/dist/components/IconButton/index.d.ts.map +1 -0
  94. package/dist/components/Input/Input.d.ts +13 -0
  95. package/dist/components/Input/Input.d.ts.map +1 -0
  96. package/dist/components/Input/index.d.ts +2 -0
  97. package/dist/components/Input/index.d.ts.map +1 -0
  98. package/dist/components/Label/Label.d.ts +10 -0
  99. package/dist/components/Label/Label.d.ts.map +1 -0
  100. package/dist/components/Label/index.d.ts +2 -0
  101. package/dist/components/Label/index.d.ts.map +1 -0
  102. package/dist/components/Modal/Modal.d.ts +34 -0
  103. package/dist/components/Modal/Modal.d.ts.map +1 -0
  104. package/dist/components/Modal/index.d.ts +2 -0
  105. package/dist/components/Modal/index.d.ts.map +1 -0
  106. package/dist/components/MultiSelect/MultiSelect.d.ts +21 -0
  107. package/dist/components/MultiSelect/MultiSelect.d.ts.map +1 -0
  108. package/dist/components/MultiSelect/index.d.ts +2 -0
  109. package/dist/components/MultiSelect/index.d.ts.map +1 -0
  110. package/dist/components/Navbar/Navbar.d.ts +21 -0
  111. package/dist/components/Navbar/Navbar.d.ts.map +1 -0
  112. package/dist/components/Navbar/index.d.ts +2 -0
  113. package/dist/components/Navbar/index.d.ts.map +1 -0
  114. package/dist/components/NumberInput/NumberInput.d.ts +13 -0
  115. package/dist/components/NumberInput/NumberInput.d.ts.map +1 -0
  116. package/dist/components/NumberInput/index.d.ts +2 -0
  117. package/dist/components/NumberInput/index.d.ts.map +1 -0
  118. package/dist/components/Pagination/Pagination.d.ts +20 -0
  119. package/dist/components/Pagination/Pagination.d.ts.map +1 -0
  120. package/dist/components/Pagination/index.d.ts +2 -0
  121. package/dist/components/Pagination/index.d.ts.map +1 -0
  122. package/dist/components/PasswordInput/PasswordInput.d.ts +8 -0
  123. package/dist/components/PasswordInput/PasswordInput.d.ts.map +1 -0
  124. package/dist/components/PasswordInput/index.d.ts +2 -0
  125. package/dist/components/PasswordInput/index.d.ts.map +1 -0
  126. package/dist/components/Popover/Popover.d.ts +19 -0
  127. package/dist/components/Popover/Popover.d.ts.map +1 -0
  128. package/dist/components/Popover/index.d.ts +2 -0
  129. package/dist/components/Popover/index.d.ts.map +1 -0
  130. package/dist/components/Progress/Progress.d.ts +15 -0
  131. package/dist/components/Progress/Progress.d.ts.map +1 -0
  132. package/dist/components/Progress/index.d.ts +2 -0
  133. package/dist/components/Progress/index.d.ts.map +1 -0
  134. package/dist/components/Radio/Radio.d.ts +25 -0
  135. package/dist/components/Radio/Radio.d.ts.map +1 -0
  136. package/dist/components/Radio/index.d.ts +2 -0
  137. package/dist/components/Radio/index.d.ts.map +1 -0
  138. package/dist/components/SearchInput/SearchInput.d.ts +19 -0
  139. package/dist/components/SearchInput/SearchInput.d.ts.map +1 -0
  140. package/dist/components/SearchInput/index.d.ts +2 -0
  141. package/dist/components/SearchInput/index.d.ts.map +1 -0
  142. package/dist/components/Select/Select.d.ts +25 -0
  143. package/dist/components/Select/Select.d.ts.map +1 -0
  144. package/dist/components/Select/index.d.ts +2 -0
  145. package/dist/components/Select/index.d.ts.map +1 -0
  146. package/dist/components/Sidebar/Sidebar.d.ts +32 -0
  147. package/dist/components/Sidebar/Sidebar.d.ts.map +1 -0
  148. package/dist/components/Sidebar/index.d.ts +2 -0
  149. package/dist/components/Sidebar/index.d.ts.map +1 -0
  150. package/dist/components/Skeleton/Skeleton.d.ts +15 -0
  151. package/dist/components/Skeleton/Skeleton.d.ts.map +1 -0
  152. package/dist/components/Skeleton/index.d.ts +2 -0
  153. package/dist/components/Skeleton/index.d.ts.map +1 -0
  154. package/dist/components/Slider/Slider.d.ts +17 -0
  155. package/dist/components/Slider/Slider.d.ts.map +1 -0
  156. package/dist/components/Slider/index.d.ts +2 -0
  157. package/dist/components/Slider/index.d.ts.map +1 -0
  158. package/dist/components/Spinner/Spinner.d.ts +13 -0
  159. package/dist/components/Spinner/Spinner.d.ts.map +1 -0
  160. package/dist/components/Spinner/index.d.ts +2 -0
  161. package/dist/components/Spinner/index.d.ts.map +1 -0
  162. package/dist/components/StatusIndicator/StatusIndicator.d.ts +14 -0
  163. package/dist/components/StatusIndicator/StatusIndicator.d.ts.map +1 -0
  164. package/dist/components/StatusIndicator/index.d.ts +2 -0
  165. package/dist/components/StatusIndicator/index.d.ts.map +1 -0
  166. package/dist/components/Stepper/Stepper.d.ts +23 -0
  167. package/dist/components/Stepper/Stepper.d.ts.map +1 -0
  168. package/dist/components/Stepper/index.d.ts +2 -0
  169. package/dist/components/Stepper/index.d.ts.map +1 -0
  170. package/dist/components/Switch/Switch.d.ts +16 -0
  171. package/dist/components/Switch/Switch.d.ts.map +1 -0
  172. package/dist/components/Switch/index.d.ts +2 -0
  173. package/dist/components/Switch/index.d.ts.map +1 -0
  174. package/dist/components/Tabs/Tabs.d.ts +23 -0
  175. package/dist/components/Tabs/Tabs.d.ts.map +1 -0
  176. package/dist/components/Tabs/index.d.ts +2 -0
  177. package/dist/components/Tabs/index.d.ts.map +1 -0
  178. package/dist/components/Tag/Tag.d.ts +15 -0
  179. package/dist/components/Tag/Tag.d.ts.map +1 -0
  180. package/dist/components/Tag/index.d.ts +2 -0
  181. package/dist/components/Tag/index.d.ts.map +1 -0
  182. package/dist/components/Textarea/Textarea.d.ts +12 -0
  183. package/dist/components/Textarea/Textarea.d.ts.map +1 -0
  184. package/dist/components/Textarea/index.d.ts +2 -0
  185. package/dist/components/Textarea/index.d.ts.map +1 -0
  186. package/dist/components/TimePicker/TimePicker.d.ts +11 -0
  187. package/dist/components/TimePicker/TimePicker.d.ts.map +1 -0
  188. package/dist/components/TimePicker/index.d.ts +2 -0
  189. package/dist/components/TimePicker/index.d.ts.map +1 -0
  190. package/dist/components/Toast/Toast.d.ts +22 -0
  191. package/dist/components/Toast/Toast.d.ts.map +1 -0
  192. package/dist/components/Toast/index.d.ts +2 -0
  193. package/dist/components/Toast/index.d.ts.map +1 -0
  194. package/dist/components/Tooltip/Tooltip.d.ts +21 -0
  195. package/dist/components/Tooltip/Tooltip.d.ts.map +1 -0
  196. package/dist/components/Tooltip/index.d.ts +2 -0
  197. package/dist/components/Tooltip/index.d.ts.map +1 -0
  198. package/dist/design-system.css +1 -0
  199. package/dist/icons/Icon.d.ts +20 -0
  200. package/dist/icons/Icon.d.ts.map +1 -0
  201. package/dist/icons/index.d.ts +3 -0
  202. package/dist/icons/index.d.ts.map +1 -0
  203. package/dist/index.d.ts +119 -0
  204. package/dist/index.d.ts.map +1 -0
  205. package/dist/index.es.js +50695 -0
  206. package/dist/layouts/index.d.ts +2 -0
  207. package/dist/layouts/index.d.ts.map +1 -0
  208. package/dist/layouts/layouts.d.ts +48 -0
  209. package/dist/layouts/layouts.d.ts.map +1 -0
  210. package/dist/patterns/index.d.ts +2 -0
  211. package/dist/patterns/index.d.ts.map +1 -0
  212. package/dist/patterns/patterns.d.ts +55 -0
  213. package/dist/patterns/patterns.d.ts.map +1 -0
  214. package/dist/primitives/Box/Box.d.ts +68 -0
  215. package/dist/primitives/Box/Box.d.ts.map +1 -0
  216. package/dist/primitives/Box/index.d.ts +2 -0
  217. package/dist/primitives/Box/index.d.ts.map +1 -0
  218. package/dist/primitives/Container/Container.d.ts +14 -0
  219. package/dist/primitives/Container/Container.d.ts.map +1 -0
  220. package/dist/primitives/Container/index.d.ts +2 -0
  221. package/dist/primitives/Container/index.d.ts.map +1 -0
  222. package/dist/primitives/Divider/Divider.d.ts +11 -0
  223. package/dist/primitives/Divider/Divider.d.ts.map +1 -0
  224. package/dist/primitives/Divider/index.d.ts +2 -0
  225. package/dist/primitives/Divider/index.d.ts.map +1 -0
  226. package/dist/primitives/Grid/Grid.d.ts +19 -0
  227. package/dist/primitives/Grid/Grid.d.ts.map +1 -0
  228. package/dist/primitives/Grid/index.d.ts +2 -0
  229. package/dist/primitives/Grid/index.d.ts.map +1 -0
  230. package/dist/primitives/Heading/Heading.d.ts +15 -0
  231. package/dist/primitives/Heading/Heading.d.ts.map +1 -0
  232. package/dist/primitives/Heading/index.d.ts +2 -0
  233. package/dist/primitives/Heading/index.d.ts.map +1 -0
  234. package/dist/primitives/Inline/Inline.d.ts +14 -0
  235. package/dist/primitives/Inline/Inline.d.ts.map +1 -0
  236. package/dist/primitives/Inline/index.d.ts +2 -0
  237. package/dist/primitives/Inline/index.d.ts.map +1 -0
  238. package/dist/primitives/Link/Link.d.ts +13 -0
  239. package/dist/primitives/Link/Link.d.ts.map +1 -0
  240. package/dist/primitives/Link/index.d.ts +2 -0
  241. package/dist/primitives/Link/index.d.ts.map +1 -0
  242. package/dist/primitives/Stack/Stack.d.ts +18 -0
  243. package/dist/primitives/Stack/Stack.d.ts.map +1 -0
  244. package/dist/primitives/Stack/index.d.ts +2 -0
  245. package/dist/primitives/Stack/index.d.ts.map +1 -0
  246. package/dist/primitives/Text/Text.d.ts +25 -0
  247. package/dist/primitives/Text/Text.d.ts.map +1 -0
  248. package/dist/primitives/Text/index.d.ts +2 -0
  249. package/dist/primitives/Text/index.d.ts.map +1 -0
  250. package/package.json +90 -0
  251. package/themes/cardio.css +41 -0
  252. package/themes/onco.css +41 -0
  253. 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.