siesa-ui-kit 1.0.5 → 1.0.6

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 (198) hide show
  1. package/dist/index.cjs +1479 -0
  2. package/dist/index.cjs.map +1 -0
  3. package/dist/index.js +1479 -0
  4. package/dist/index.js.map +1 -0
  5. package/package.json +23 -14
  6. package/claude/agents/siesa-ui-kit-specialist.md +0 -2401
  7. package/claude/prompts/component-template.md +0 -121
  8. package/claude/settings.local.json +0 -61
  9. package/docs/border-radius.md +0 -1261
  10. package/docs/colors.md +0 -832
  11. package/docs/dark-mode-guide.md +0 -1426
  12. package/docs/filters.md +0 -1243
  13. package/docs/icons.md +0 -1283
  14. package/docs/shadows.md +0 -1377
  15. package/docs/spacing.md +0 -1684
  16. package/docs/typography.md +0 -1268
  17. package/postcss.config.cjs +0 -6
  18. package/src/App.css +0 -42
  19. package/src/App.tsx +0 -8
  20. package/src/ButtonTest.tsx +0 -147
  21. package/src/assets/fonts/README.md +0 -261
  22. package/src/assets/fonts/SiesaBT/SiesaBT-Bold.otf +0 -0
  23. package/src/assets/fonts/SiesaBT/SiesaBT-Light.otf +0 -0
  24. package/src/assets/fonts/SiesaBT/SiesaBT-Regular.otf +0 -0
  25. package/src/assets/react.svg +0 -1
  26. package/src/components/Alert/Alert.stories.tsx +0 -332
  27. package/src/components/Alert/Alert.tsx +0 -106
  28. package/src/components/Alert/Alert.types.ts +0 -54
  29. package/src/components/Avatar/Avatar.stories.tsx +0 -494
  30. package/src/components/Avatar/Avatar.tsx +0 -143
  31. package/src/components/Avatar/Avatar.types.ts +0 -53
  32. package/src/components/Badge/Badge.stories.tsx +0 -339
  33. package/src/components/Badge/Badge.tsx +0 -278
  34. package/src/components/Badge/Badge.types.ts +0 -58
  35. package/src/components/Button/Button.stories.tsx +0 -950
  36. package/src/components/Button/Button.tsx +0 -337
  37. package/src/components/Button/Button.types.ts +0 -180
  38. package/src/components/Button/icons.tsx +0 -87
  39. package/src/components/Button/index.ts +0 -3
  40. package/src/components/Checkbox/Checkbox.stories.tsx +0 -453
  41. package/src/components/Checkbox/Checkbox.tsx +0 -208
  42. package/src/components/Checkbox/Checkbox.types.ts +0 -61
  43. package/src/components/DescriptionList/DescriptionList.stories.tsx +0 -250
  44. package/src/components/DescriptionList/DescriptionList.tsx +0 -96
  45. package/src/components/DescriptionList/DescriptionList.types.ts +0 -29
  46. package/src/components/Divider/Divider.stories.tsx +0 -263
  47. package/src/components/Divider/Divider.tsx +0 -80
  48. package/src/components/Divider/Divider.types.ts +0 -24
  49. package/src/components/Dropdown/Dropdown.stories.tsx +0 -552
  50. package/src/components/Dropdown/Dropdown.tsx +0 -422
  51. package/src/components/Dropdown/Dropdown.types.ts +0 -146
  52. package/src/components/Dropdown/README.md +0 -266
  53. package/src/components/Dropdown/icons.tsx +0 -72
  54. package/src/components/Dropdown/index.ts +0 -8
  55. package/src/components/Input/Input.stories.tsx +0 -583
  56. package/src/components/Input/Input.tsx +0 -204
  57. package/src/components/Input/Input.types.ts +0 -80
  58. package/src/components/Input/icons.tsx +0 -145
  59. package/src/components/Input/index.ts +0 -2
  60. package/src/components/LoginView/LoginView.stories.tsx +0 -148
  61. package/src/components/LoginView/LoginView.tsx +0 -426
  62. package/src/components/LoginView/LoginView.types.ts +0 -52
  63. package/src/components/LoginView/README.md +0 -396
  64. package/src/components/LoginView/icons.tsx +0 -85
  65. package/src/components/LoginView/index.ts +0 -3
  66. package/src/components/Navbar/Navbar.stories.tsx +0 -810
  67. package/src/components/Navbar/Navbar.tsx +0 -755
  68. package/src/components/Navbar/Navbar.types.ts +0 -219
  69. package/src/components/Navbar/README.md +0 -279
  70. package/src/components/Navbar/icons.tsx +0 -102
  71. package/src/components/Navbar/index.ts +0 -8
  72. package/src/components/NavigationBar/NavigationBar.stories.tsx +0 -406
  73. package/src/components/NavigationBar/NavigationBar.tsx +0 -246
  74. package/src/components/NavigationBar/NavigationBar.types.ts +0 -74
  75. package/src/components/NavigationBar/README.md +0 -469
  76. package/src/components/NavigationBar/index.ts +0 -2
  77. package/src/components/NavigationRail/NavigationRail.stories.tsx +0 -417
  78. package/src/components/NavigationRail/NavigationRail.tsx +0 -418
  79. package/src/components/NavigationRail/NavigationRail.types.ts +0 -109
  80. package/src/components/NavigationRail/README.md +0 -224
  81. package/src/components/NavigationRail/index.ts +0 -2
  82. package/src/components/Notification/Notification.stories.tsx +0 -513
  83. package/src/components/Notification/Notification.tsx +0 -145
  84. package/src/components/Notification/Notification.types.ts +0 -142
  85. package/src/components/Notification/README.md +0 -409
  86. package/src/components/Notification/index.ts +0 -3
  87. package/src/components/POSConvention/POSConvention.stories.tsx +0 -235
  88. package/src/components/POSConvention/POSConvention.tsx +0 -129
  89. package/src/components/POSConvention/POSConvention.types.ts +0 -38
  90. package/src/components/POSConvention/README.md +0 -123
  91. package/src/components/POSConvention/icons.tsx +0 -45
  92. package/src/components/POSConvention/index.ts +0 -3
  93. package/src/components/POSLocationButton/POSLocationButton.stories.tsx +0 -531
  94. package/src/components/POSLocationButton/POSLocationButton.tsx +0 -247
  95. package/src/components/POSLocationButton/POSLocationButton.types.ts +0 -87
  96. package/src/components/POSLocationButton/README.md +0 -253
  97. package/src/components/POSLocationButton/icons.tsx +0 -120
  98. package/src/components/POSLocationButton/index.ts +0 -14
  99. package/src/components/POSNumberButton/POSNumberButton.stories.tsx +0 -415
  100. package/src/components/POSNumberButton/POSNumberButton.tsx +0 -179
  101. package/src/components/POSNumberButton/POSNumberButton.types.ts +0 -51
  102. package/src/components/POSNumberButton/README.md +0 -321
  103. package/src/components/POSNumberButton/index.ts +0 -3
  104. package/src/components/POSProductButton/POSProductButton.stories.tsx +0 -318
  105. package/src/components/POSProductButton/POSProductButton.tsx +0 -152
  106. package/src/components/POSProductButton/POSProductButton.types.ts +0 -46
  107. package/src/components/POSProductButton/README.md +0 -269
  108. package/src/components/POSProductButton/index.ts +0 -2
  109. package/src/components/POSProductCard/POSProductCard.stories.tsx +0 -642
  110. package/src/components/POSProductCard/POSProductCard.tsx +0 -208
  111. package/src/components/POSProductCard/POSProductCard.types.ts +0 -76
  112. package/src/components/POSProductCard/README.md +0 -179
  113. package/src/components/POSProductCard/icons.tsx +0 -26
  114. package/src/components/POSProductCard/index.ts +0 -2
  115. package/src/components/POSProductSidebarItems/POSProductSidebarItems.stories.tsx +0 -753
  116. package/src/components/POSProductSidebarItems/POSProductSidebarItems.tsx +0 -332
  117. package/src/components/POSProductSidebarItems/POSProductSidebarItems.types.ts +0 -119
  118. package/src/components/POSProductSidebarItems/README.md +0 -198
  119. package/src/components/POSProductSidebarItems/icons.tsx +0 -21
  120. package/src/components/POSProductSidebarItems/index.ts +0 -3
  121. package/src/components/POSTable/POSTable.stories.tsx +0 -737
  122. package/src/components/POSTable/POSTable.tsx +0 -401
  123. package/src/components/POSTable/POSTable.types.ts +0 -83
  124. package/src/components/POSTable/README.md +0 -286
  125. package/src/components/POSTable/index.ts +0 -7
  126. package/src/components/Pagination/Pagination.stories.tsx +0 -555
  127. package/src/components/Pagination/Pagination.tsx +0 -286
  128. package/src/components/Pagination/Pagination.types.ts +0 -93
  129. package/src/components/Pagination/README.md +0 -298
  130. package/src/components/Pagination/icons.tsx +0 -47
  131. package/src/components/Pagination/index.ts +0 -3
  132. package/src/components/Quantity/Quantity.stories.tsx +0 -457
  133. package/src/components/Quantity/Quantity.tsx +0 -289
  134. package/src/components/Quantity/Quantity.types.ts +0 -70
  135. package/src/components/Radio/Radio.stories.tsx +0 -523
  136. package/src/components/Radio/Radio.tsx +0 -170
  137. package/src/components/Radio/Radio.types.ts +0 -122
  138. package/src/components/Select/README.md +0 -299
  139. package/src/components/Select/Select.stories.tsx +0 -673
  140. package/src/components/Select/Select.tsx +0 -454
  141. package/src/components/Select/Select.types.ts +0 -148
  142. package/src/components/Select/icons.tsx +0 -50
  143. package/src/components/Select/index.ts +0 -3
  144. package/src/components/SignUpView/SignUpView.stories.tsx +0 -129
  145. package/src/components/SignUpView/SignUpView.tsx +0 -503
  146. package/src/components/SignUpView/SignUpView.types.ts +0 -58
  147. package/src/components/SignUpView/icons.tsx +0 -71
  148. package/src/components/SignUpView/index.ts +0 -3
  149. package/src/components/Switch/README.md +0 -112
  150. package/src/components/Switch/Switch.stories.tsx +0 -550
  151. package/src/components/Switch/Switch.tsx +0 -246
  152. package/src/components/Switch/Switch.types.ts +0 -67
  153. package/src/components/Table/README.md +0 -369
  154. package/src/components/Table/Table.stories.tsx +0 -805
  155. package/src/components/Table/Table.tsx +0 -688
  156. package/src/components/Table/Table.types.ts +0 -204
  157. package/src/components/Table/index.ts +0 -9
  158. package/src/components/Tabs/README.md +0 -201
  159. package/src/components/Tabs/Tabs.stories.tsx +0 -580
  160. package/src/components/Tabs/Tabs.tsx +0 -356
  161. package/src/components/Tabs/Tabs.types.ts +0 -127
  162. package/src/components/Tabs/icons.tsx +0 -129
  163. package/src/components/Tabs/index.ts +0 -11
  164. package/src/components/Textarea/Textarea.stories.tsx +0 -535
  165. package/src/components/Textarea/Textarea.tsx +0 -188
  166. package/src/components/Textarea/Textarea.types.ts +0 -54
  167. package/src/context/ThemeContext.tsx +0 -99
  168. package/src/context/index.ts +0 -1
  169. package/src/index.css +0 -29
  170. package/src/index.ts +0 -39
  171. package/src/main.tsx +0 -10
  172. package/src/views/ProductsView/ProductsView.stories.tsx +0 -344
  173. package/src/views/ProductsView/ProductsView.tsx +0 -480
  174. package/src/views/ProductsView/ProductsView.types.ts +0 -238
  175. package/src/views/ProductsView/README.md +0 -312
  176. package/src/views/ProductsView/icons.tsx +0 -38
  177. package/src/views/ProductsView/index.ts +0 -8
  178. package/src/views/RecoverPasswordView/README.md +0 -269
  179. package/src/views/RecoverPasswordView/RecoverPasswordView.stories.tsx +0 -131
  180. package/src/views/RecoverPasswordView/RecoverPasswordView.tsx +0 -376
  181. package/src/views/RecoverPasswordView/RecoverPasswordView.types.ts +0 -56
  182. package/src/views/RecoverPasswordView/icons.tsx +0 -17
  183. package/src/views/RecoverPasswordView/index.ts +0 -2
  184. package/src/views/TableLayoutView/README.md +0 -268
  185. package/src/views/TableLayoutView/TableLayoutView.stories.tsx +0 -235
  186. package/src/views/TableLayoutView/TableLayoutView.tsx +0 -461
  187. package/src/views/TableLayoutView/TableLayoutView.types.ts +0 -209
  188. package/src/views/TableLayoutView/icons.tsx +0 -113
  189. package/src/views/TableLayoutView/index.ts +0 -6
  190. package/storybook/main.ts +0 -20
  191. package/storybook/preview.tsx +0 -84
  192. package/storybook/vitest.setup.ts +0 -7
  193. package/tailwind.config.js +0 -128
  194. /package/{public → dist}/,Business Logo.png +0 -0
  195. /package/{public → dist}/.Siesa Logo.png +0 -0
  196. /package/{public → dist}/bg_siesa.png +0 -0
  197. /package/{public → dist}/siesa_logo_mobile.png +0 -0
  198. /package/{public → dist}/vite.svg +0 -0
@@ -1,247 +0,0 @@
1
- import React from 'react';
2
- import type { POSLocationButtonProps } from './POSLocationButton.types';
3
- import { CheckIcon, XMarkIcon, CalendarIcon, NoSymbolIcon, UsersIcon } from './icons';
4
-
5
- /**
6
- * POSLocationButton del sistema de diseño Siesa
7
- *
8
- * Botón especializado para punto de venta (POS) que muestra el estado de disponibilidad
9
- * de una ubicación física (mesa, salón, terraza, etc.) con indicadores visuales claros.
10
- *
11
- * **Estados de disponibilidad (status):**
12
- * - `available`: Disponible (verde/lime) con icono ✓
13
- * - `occupied`: Ocupada (naranja/yellow) con icono ✗
14
- * - `reserved`: Reservada (morado/purple) con icono 📅
15
- * - `outOfService`: Fuera de servicio (gris/zinc) con icono 🚫
16
- *
17
- * **Estados visuales (state):**
18
- * - `enabled`: Estado normal con fondo blanco/dark
19
- * - `actived`: Estado seleccionado con fondo coloreado
20
- *
21
- * **Características:**
22
- * - Ancho flexible: por defecto ocupa el 100% del contenedor (fullWidth=true)
23
- * - Altura fija: 68px (optimizado para interfaces POS)
24
- * - Muestra nombre de ubicación y capacidad (ej: "1/8 mesas")
25
- * - Badge visual con icono y texto del estado
26
- * - Dark mode completo en todos los estados
27
- * - Focus ring adaptativo
28
- * - Transiciones suaves
29
- *
30
- * Mejores prácticas implementadas:
31
- * - Orden de modificadores: {responsive}:{dark}:{state}:{utility}
32
- * - Dark mode con estrategia 'class' (darkMode: 'class')
33
- * - Tokens de color consistentes con la documentación
34
- * - Type safety con TypeScript estricto
35
- * - Accesibilidad con ARIA labels
36
- *
37
- * @see docs/colors.md - Sistema de colores
38
- * @see docs/typography.md - Sistema tipográfico
39
- * @see docs/spacing.md - Sistema de espaciado
40
- *
41
- * @example
42
- * ```tsx
43
- * // Ubicación disponible
44
- * <POSLocationButton
45
- * locationName="Antejardín"
46
- * status="available"
47
- * capacity={{ current: 1, total: 8 }}
48
- * onClick={() => console.log('Seleccionado')}
49
- * />
50
- *
51
- * // Ubicación ocupada y seleccionada
52
- * <POSLocationButton
53
- * locationName="Terraza"
54
- * status="occupied"
55
- * state="actived"
56
- * capacity={{ current: 5, total: 8 }}
57
- * />
58
- *
59
- * // Ubicación reservada
60
- * <POSLocationButton
61
- * locationName="Salón Principal"
62
- * status="reserved"
63
- * capacity={{ current: 3, total: 12 }}
64
- * />
65
- *
66
- * // Fuera de servicio
67
- * <POSLocationButton
68
- * locationName="Bar"
69
- * status="outOfService"
70
- * disabled
71
- * />
72
- * ```
73
- */
74
- export const POSLocationButton: React.FC<POSLocationButtonProps> = ({
75
- locationName,
76
- status = 'available',
77
- state = 'enabled',
78
- capacity,
79
- onClick,
80
- disabled = false,
81
- className = '',
82
- ariaLabel,
83
- fullWidth = true,
84
- }) => {
85
- // ===== CONFIGURACIÓN DE COLORES POR STATUS =====
86
- // Mapeo de colores según especificaciones de Figma (pixel-perfect)
87
- const statusConfig = {
88
- available: {
89
- // Azul Primary Custom (según Figma: #0e79fd)
90
- textColor: 'text-primary-custom-600 dark:text-primary-custom-600',
91
- badgeBg: 'bg-primary-custom-100 dark:bg-blue-900/30',
92
- badgeText: 'text-primary-custom-600 dark:text-blue-400',
93
- activedBg: 'bg-primary-custom-100 dark:bg-blue-900/30',
94
- icon: CheckIcon,
95
- badgeLabel: 'Disponible',
96
- },
97
- occupied: {
98
- // Naranja/Yellow (según Figma: #af460e para texto, #fcedc9 para fondo)
99
- textColor: 'text-[#af460e] dark:text-orange-400',
100
- badgeBg: 'bg-[#fcedc9] dark:bg-yellow-900/30',
101
- badgeText: 'text-[#af460e] dark:text-orange-400',
102
- activedBg: 'bg-[#fcedc9] dark:bg-yellow-900/30',
103
- icon: XMarkIcon,
104
- badgeLabel: 'Ocupada',
105
- },
106
- reserved: {
107
- // Morado/Purple (según Figma: #7e22ce para texto, #f3e8ff para fondo)
108
- textColor: 'text-[#7e22ce] dark:text-fuchsia-400',
109
- badgeBg: 'bg-[#f3e8ff] dark:bg-purple-900/30',
110
- badgeText: 'text-[#7e22ce] dark:text-purple-400',
111
- activedBg: 'bg-[#f3e8ff] dark:bg-purple-900/30',
112
- icon: CalendarIcon,
113
- badgeLabel: 'Reservada',
114
- },
115
- outOfService: {
116
- // Gris/Zinc (según Figma: #3f3f46 para texto, #f4f4f5 para fondo)
117
- textColor: 'text-[#3f3f46] dark:text-zinc-400',
118
- badgeBg: 'bg-[#f4f4f5] dark:bg-zinc-800/30',
119
- badgeText: 'text-content-tertiary dark:text-zinc-400',
120
- activedBg: 'bg-[#f4f4f5] dark:bg-zinc-800/30',
121
- icon: NoSymbolIcon,
122
- badgeLabel: 'F. de Servicio',
123
- },
124
- };
125
-
126
- const config = statusConfig[status];
127
- const StatusIcon = config.icon;
128
-
129
- // ===== CLASES DE FONDO SEGÚN STATE =====
130
- const backgroundClasses =
131
- state === 'actived'
132
- ? config.activedBg // Fondo coloreado cuando está activo
133
- : 'bg-white dark:bg-dark-bg-primary'; // Fondo blanco/dark cuando está enabled
134
-
135
- // ===== CLASES DE ANCHO =====
136
- const widthClasses = fullWidth ? 'w-full' : 'w-[189px]';
137
-
138
- // ===== CLASES BASE =====
139
- const baseClasses = `
140
- flex
141
- flex-col
142
- items-stretch
143
- justify-between
144
- ${widthClasses}
145
- h-[68px]
146
- p-2
147
- rounded-lg
148
- cursor-pointer
149
- transition-all
150
- duration-150
151
- focus:outline-none
152
- focus:ring-2
153
- focus:ring-primary-custom-400
154
- focus:ring-offset-2
155
- dark:focus:ring-dark-border-custom
156
- dark:focus:ring-offset-dark-bg-primary
157
- hover:shadow-md
158
- active:scale-[0.98]
159
- disabled:opacity-50
160
- disabled:cursor-not-allowed
161
- disabled:pointer-events-none
162
- `;
163
-
164
- // ===== COMBINAR CLASES =====
165
- const buttonClasses = [baseClasses, backgroundClasses, className]
166
- .join(' ')
167
- .replace(/\s+/g, ' ')
168
- .trim();
169
-
170
- // ===== FORMATEAR TEXTO DE CAPACIDAD =====
171
- const capacityText = capacity
172
- ? `${capacity.current}/${capacity.total} mesas`
173
- : null;
174
-
175
- return (
176
- <button
177
- className={buttonClasses}
178
- onClick={onClick}
179
- disabled={disabled}
180
- aria-label={ariaLabel || `${locationName} - ${config.badgeLabel}`}
181
- type="button"
182
- >
183
- {/* ===== TÍTULO (Nombre de ubicación) ===== */}
184
- <div
185
- className={`
186
- text-base
187
- font-bold
188
- leading-6
189
- ${config.textColor}
190
- `
191
- .replace(/\s+/g, ' ')
192
- .trim()}
193
- >
194
- {locationName}
195
- </div>
196
-
197
- {/* ===== CONTENIDO (Capacidad + Badge) ===== */}
198
- <div className="flex items-center justify-between">
199
- {/* Capacidad (izquierda) */}
200
- {capacityText && (
201
- <div className="flex items-center gap-1">
202
- <UsersIcon className={config.textColor} />
203
- <span
204
- className={`
205
- text-[10px]
206
- leading-[12px]
207
- ${config.textColor}
208
- `
209
- .replace(/\s+/g, ' ')
210
- .trim()}
211
- >
212
- {capacityText}
213
- </span>
214
- </div>
215
- )}
216
-
217
- {/* Badge (derecha) */}
218
- <div
219
- className={`
220
- inline-flex
221
- items-center
222
- gap-1
223
- px-1.5
224
- py-1
225
- rounded-md
226
- ${config.badgeBg}
227
- `
228
- .replace(/\s+/g, ' ')
229
- .trim()}
230
- >
231
- <StatusIcon className={config.badgeText} />
232
- <span
233
- className={`
234
- text-xs
235
- leading-4
236
- ${config.badgeText}
237
- `
238
- .replace(/\s+/g, ' ')
239
- .trim()}
240
- >
241
- {config.badgeLabel}
242
- </span>
243
- </div>
244
- </div>
245
- </button>
246
- );
247
- };
@@ -1,87 +0,0 @@
1
- import type { MouseEvent } from 'react';
2
-
3
- /**
4
- * Estado de disponibilidad de la ubicación POS
5
- * - available: Disponible (verde/lime)
6
- * - occupied: Ocupada (naranja/yellow)
7
- * - reserved: Reservada (morado/purple)
8
- * - outOfService: Fuera de servicio (gris/zinc)
9
- */
10
- export type POSLocationStatus = 'available' | 'occupied' | 'reserved' | 'outOfService';
11
-
12
- /**
13
- * Estado visual del botón
14
- * - enabled: Estado normal (fondo blanco/dark-bg-primary)
15
- * - actived: Estado activo/seleccionado (fondo con color del badge)
16
- */
17
- export type POSLocationState = 'enabled' | 'actived';
18
-
19
- /**
20
- * Información de capacidad de la ubicación
21
- */
22
- export interface POSLocationCapacity {
23
- /**
24
- * Número actual de mesas/espacios ocupados
25
- */
26
- current: number;
27
-
28
- /**
29
- * Total de mesas/espacios disponibles
30
- */
31
- total: number;
32
- }
33
-
34
- /**
35
- * Props del componente POSLocationButton
36
- */
37
- export interface POSLocationButtonProps {
38
- /**
39
- * Nombre de la ubicación (ej: "Antejardín", "Terraza", "Salón Principal")
40
- */
41
- locationName: string;
42
-
43
- /**
44
- * Estado de disponibilidad de la ubicación
45
- * @default 'available'
46
- */
47
- status?: POSLocationStatus;
48
-
49
- /**
50
- * Estado visual del botón (enabled o actived)
51
- * @default 'enabled'
52
- */
53
- state?: POSLocationState;
54
-
55
- /**
56
- * Información de capacidad (mesas ocupadas/total)
57
- * Ejemplo: { current: 1, total: 8 } → "1/8 mesas"
58
- */
59
- capacity?: POSLocationCapacity;
60
-
61
- /**
62
- * Función a ejecutar al hacer clic en el botón
63
- */
64
- onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
65
-
66
- /**
67
- * Si el botón está deshabilitado
68
- * @default false
69
- */
70
- disabled?: boolean;
71
-
72
- /**
73
- * Clases CSS adicionales
74
- */
75
- className?: string;
76
-
77
- /**
78
- * Label para accesibilidad (ARIA)
79
- */
80
- ariaLabel?: string;
81
-
82
- /**
83
- * Si el botón ocupa todo el ancho disponible del contenedor padre
84
- * @default true
85
- */
86
- fullWidth?: boolean;
87
- }
@@ -1,253 +0,0 @@
1
- # POSLocationButton
2
-
3
- Botón especializado para punto de venta (POS) que muestra el estado de disponibilidad de una ubicación física (mesa, salón, terraza, etc.) con indicadores visuales claros.
4
-
5
- ## 📋 Características
6
-
7
- - ✅ **4 estados de disponibilidad**: Available, Occupied, Reserved, Out of Service
8
- - ✅ **2 estados visuales**: Enabled (normal) y Actived (seleccionado)
9
- - ✅ **Información de capacidad**: Muestra mesas ocupadas/total
10
- - ✅ **Iconos visuales**: Cada estado tiene su icono distintivo
11
- - ✅ **Dark mode completo**: Todos los estados adaptados para modo oscuro
12
- - ✅ **Tamaño fijo**: 189x68px optimizado para interfaces POS
13
- - ✅ **Accesibilidad**: ARIA labels y estados semánticos
14
- - ✅ **TypeScript**: Type safety completo
15
-
16
- ## 🎨 Estados de Disponibilidad
17
-
18
- | Status | Color | Icono | Uso |
19
- |--------|-------|-------|-----|
20
- | `available` | Verde/Lime | ✓ | Ubicación disponible para asignar |
21
- | `occupied` | Naranja/Yellow | ✗ | Ubicación actualmente en uso |
22
- | `reserved` | Morado/Purple | 📅 | Ubicación reservada para uso futuro |
23
- | `outOfService` | Gris/Zinc | 🚫 | Ubicación fuera de servicio temporalmente |
24
-
25
- ## 🔧 Estados Visuales
26
-
27
- | State | Descripción | Uso |
28
- |-------|-------------|-----|
29
- | `enabled` | Estado normal con fondo blanco/dark | Vista por defecto |
30
- | `actived` | Estado seleccionado con fondo coloreado | Ubicación actualmente seleccionada en la interfaz |
31
-
32
- ## 📦 Instalación
33
-
34
- ```tsx
35
- import { POSLocationButton } from '@/components/POSLocationButton';
36
- ```
37
-
38
- ## 🚀 Uso Básico
39
-
40
- ```tsx
41
- // Ubicación disponible
42
- <POSLocationButton
43
- locationName="Antejardín"
44
- status="available"
45
- capacity={{ current: 1, total: 8 }}
46
- onClick={() => console.log('Seleccionado')}
47
- />
48
- ```
49
-
50
- ## 📖 Ejemplos
51
-
52
- ### Dashboard de Restaurante
53
-
54
- ```tsx
55
- <div className="grid grid-cols-2 gap-3">
56
- <POSLocationButton
57
- locationName="Antejardín"
58
- status="available"
59
- capacity={{ current: 1, total: 8 }}
60
- />
61
- <POSLocationButton
62
- locationName="Terraza"
63
- status="occupied"
64
- capacity={{ current: 5, total: 8 }}
65
- />
66
- <POSLocationButton
67
- locationName="Salón Principal"
68
- status="reserved"
69
- capacity={{ current: 3, total: 12 }}
70
- />
71
- <POSLocationButton
72
- locationName="Bar"
73
- status="outOfService"
74
- disabled
75
- />
76
- </div>
77
- ```
78
-
79
- ### Ubicación Seleccionada
80
-
81
- ```tsx
82
- // Estado normal
83
- <POSLocationButton
84
- locationName="Terraza"
85
- status="available"
86
- capacity={{ current: 2, total: 10 }}
87
- />
88
-
89
- // Estado seleccionado (actived)
90
- <POSLocationButton
91
- locationName="Salón VIP"
92
- status="available"
93
- state="actived"
94
- capacity={{ current: 1, total: 6 }}
95
- />
96
- ```
97
-
98
- ### Sin Información de Capacidad
99
-
100
- ```tsx
101
- <POSLocationButton
102
- locationName="Área de Espera"
103
- status="available"
104
- />
105
- ```
106
-
107
- ### Ubicación Deshabilitada
108
-
109
- ```tsx
110
- <POSLocationButton
111
- locationName="Bar"
112
- status="outOfService"
113
- disabled
114
- />
115
- ```
116
-
117
- ## 🎯 Props
118
-
119
- ### POSLocationButtonProps
120
-
121
- | Prop | Tipo | Default | Descripción |
122
- |------|------|---------|-------------|
123
- | `locationName` | `string` | **requerido** | Nombre de la ubicación (ej: "Antejardín", "Terraza") |
124
- | `status` | `POSLocationStatus` | `'available'` | Estado de disponibilidad |
125
- | `state` | `POSLocationState` | `'enabled'` | Estado visual del botón |
126
- | `capacity` | `POSLocationCapacity` | `undefined` | Información de capacidad (mesas ocupadas/total) |
127
- | `onClick` | `(event) => void` | `undefined` | Función a ejecutar al hacer clic |
128
- | `disabled` | `boolean` | `false` | Si el botón está deshabilitado |
129
- | `className` | `string` | `''` | Clases CSS adicionales |
130
- | `ariaLabel` | `string` | `undefined` | Label para accesibilidad (ARIA) |
131
-
132
- ### POSLocationStatus
133
-
134
- ```typescript
135
- type POSLocationStatus = 'available' | 'occupied' | 'reserved' | 'outOfService';
136
- ```
137
-
138
- ### POSLocationState
139
-
140
- ```typescript
141
- type POSLocationState = 'enabled' | 'actived';
142
- ```
143
-
144
- ### POSLocationCapacity
145
-
146
- ```typescript
147
- interface POSLocationCapacity {
148
- current: number; // Número actual de mesas/espacios ocupados
149
- total: number; // Total de mesas/espacios disponibles
150
- }
151
- ```
152
-
153
- ## 🎨 Especificaciones de Diseño
154
-
155
- ### Tamaños
156
-
157
- - **Ancho**: 189px (fijo)
158
- - **Alto**: 68px (fijo)
159
- - **Padding**: 8px
160
- - **Border radius**: 8px (rounded-lg)
161
-
162
- ### Tipografía
163
-
164
- - **Título (locationName)**: 16px Bold (text-base font-bold), line-height 24px
165
- - **Capacidad**: 10px Regular, line-height 12px
166
- - **Badge**: 12px Regular (text-xs), line-height 16px
167
-
168
- ### Colores (Light Mode)
169
-
170
- | Status | Texto | Badge Fondo | Badge Texto |
171
- |--------|-------|-------------|-------------|
172
- | `available` | `#4d7c0f` (lime-700) | `#ecfccb` (lime-100) | `#4d7c0f` (lime-700) |
173
- | `occupied` | `#af460e` (orange-700) | `#fcedc9` (yellow-100) | `#af460e` (orange-700) |
174
- | `reserved` | `#7e22ce` (purple-700) | `#f3e8ff` (purple-100) | `#7e22ce` (purple-700) |
175
- | `outOfService` | `#3f3f46` (zinc-700) | `#f4f4f5` (zinc-100) | `#71717a` (zinc-500) |
176
-
177
- ### Colores (Dark Mode)
178
-
179
- | Status | Texto | Badge Fondo | Badge Texto |
180
- |--------|-------|-------------|-------------|
181
- | `available` | `#4d7c0f` (lime-700) | `lime-900/30` | `#a3e635` (lime-400) |
182
- | `occupied` | `#af460e` (orange-700) | `yellow-900/30` | `#facc15` (yellow-400) |
183
- | `reserved` | `#7e22ce` (purple-700) | `purple-900/30` | `#c084fc` (purple-400) |
184
- | `outOfService` | `#3f3f46` (zinc-700) | `zinc-800/30` | `#a1a1aa` (zinc-400) |
185
-
186
- ## ♿ Accesibilidad
187
-
188
- - **ARIA labels**: Cada botón incluye un aria-label descriptivo por defecto
189
- - **Estados semánticos**: Los estados disabled y actived son accesibles
190
- - **Contraste**: Todos los colores cumplen con WCAG AA
191
- - **Focus ring**: Anillo de enfoque visible y adaptativo
192
-
193
- ## 🌓 Dark Mode
194
-
195
- El componente se adapta automáticamente al modo oscuro usando la estrategia `class` de Tailwind CSS. Todos los colores tienen variantes dark optimizadas para mantener la legibilidad y el contraste.
196
-
197
- ## 🔗 Archivos Relacionados
198
-
199
- - `POSLocationButton.tsx` - Componente principal
200
- - `POSLocationButton.types.ts` - TypeScript types
201
- - `POSLocationButton.stories.tsx` - Stories de Storybook
202
- - `icons.tsx` - Iconos del componente
203
- - `index.ts` - Exports
204
-
205
- ## 📚 Referencias
206
-
207
- - **Figma**: [POSLocationButton Specs](https://www.figma.com/design/5XNqf2YTxvwemxwo1LMQ6j/Siesa-UI-Kit?node-id=4368-30644)
208
- - **Documentación**: `docs/colors.md`, `docs/typography.md`, `docs/spacing.md`
209
- - **Referencia**: `src/components/Button/` - Patrón de implementación
210
-
211
- ## ✅ Checklist de Implementación
212
-
213
- - [x] Componente con JSDoc completo
214
- - [x] Dark mode en todos los estados
215
- - [x] TypeScript types estrictos
216
- - [x] 4 estados de disponibilidad (available, occupied, reserved, outOfService)
217
- - [x] 2 estados visuales (enabled, actived)
218
- - [x] Información de capacidad opcional
219
- - [x] Iconos visuales distintivos
220
- - [x] Focus rings adaptativos
221
- - [x] Stories de Storybook completas
222
- - [x] README con ejemplos
223
- - [x] Accesibilidad (ARIA)
224
- - [x] Validación con build
225
-
226
- ## 🎯 Casos de Uso
227
-
228
- ### ✅ Ideal para:
229
-
230
- - Sistemas POS de restaurantes
231
- - Gestión de mesas y ubicaciones
232
- - Dashboards de disponibilidad
233
- - Interfaces de asignación de recursos
234
- - Aplicaciones de reservas
235
-
236
- ### ❌ No usar para:
237
-
238
- - Botones de acción genéricos (usar `Button` en su lugar)
239
- - Navegación principal (usar `NavigationBar` o `NavigationRail`)
240
- - Formularios (usar `Button` estándar)
241
-
242
- ## 📝 Notas
243
-
244
- - El componente tiene un tamaño fijo de 189x68px optimizado para interfaces POS
245
- - Si no se proporciona `capacity`, solo se muestra el nombre y el estado
246
- - El estado `actived` es puramente visual y debe ser manejado por el componente padre
247
- - Para interfaces responsive, considera usar un grid adaptativo para organizar múltiples botones
248
-
249
- ---
250
-
251
- **Versión**: 1.0.0
252
- **Última actualización**: 2025-11-24
253
- **Mantenido por**: Equipo Siesa UI Kit
@@ -1,120 +0,0 @@
1
- import React from 'react';
2
-
3
- /**
4
- * Icono Check (✓) para estado Available
5
- * Tamaño: 12x12px
6
- */
7
- export const CheckIcon: React.FC<{ className?: string }> = ({ className = '' }) => (
8
- <svg
9
- width="12"
10
- height="12"
11
- viewBox="0 0 12 12"
12
- fill="none"
13
- xmlns="http://www.w3.org/2000/svg"
14
- className={className}
15
- >
16
- <path
17
- d="M10 3L4.5 8.5L2 6"
18
- stroke="currentColor"
19
- strokeWidth="1.5"
20
- strokeLinecap="round"
21
- strokeLinejoin="round"
22
- />
23
- </svg>
24
- );
25
-
26
- /**
27
- * Icono X Mark para estado Occupied
28
- * Tamaño: 12x12px
29
- */
30
- export const XMarkIcon: React.FC<{ className?: string }> = ({ className = '' }) => (
31
- <svg
32
- width="12"
33
- height="12"
34
- viewBox="0 0 12 12"
35
- fill="none"
36
- xmlns="http://www.w3.org/2000/svg"
37
- className={className}
38
- >
39
- <path
40
- d="M9 3L3 9M3 3L9 9"
41
- stroke="currentColor"
42
- strokeWidth="1.5"
43
- strokeLinecap="round"
44
- strokeLinejoin="round"
45
- />
46
- </svg>
47
- );
48
-
49
- /**
50
- * Icono Calendar para estado Reserved
51
- * Tamaño: 12x12px
52
- */
53
- export const CalendarIcon: React.FC<{ className?: string }> = ({ className = '' }) => (
54
- <svg
55
- width="12"
56
- height="12"
57
- viewBox="0 0 12 12"
58
- fill="none"
59
- xmlns="http://www.w3.org/2000/svg"
60
- className={className}
61
- >
62
- <path
63
- d="M10.5 5H1.5M8.5 1V3M3.5 1V3M3.25 11H8.75C9.57843 11 10.25 10.3284 10.25 9.5V3.5C10.25 2.67157 9.57843 2 8.75 2H3.25C2.42157 2 1.75 2.67157 1.75 3.5V9.5C1.75 10.3284 2.42157 11 3.25 11Z"
64
- stroke="currentColor"
65
- strokeWidth="1.5"
66
- strokeLinecap="round"
67
- strokeLinejoin="round"
68
- />
69
- </svg>
70
- );
71
-
72
- /**
73
- * Icono No Symbol (Prohibido) para estado Out of Service
74
- * Tamaño: 12x12px
75
- */
76
- export const NoSymbolIcon: React.FC<{ className?: string }> = ({ className = '' }) => (
77
- <svg
78
- width="12"
79
- height="12"
80
- viewBox="0 0 12 12"
81
- fill="none"
82
- xmlns="http://www.w3.org/2000/svg"
83
- className={className}
84
- >
85
- <path
86
- d="M10.5 6C10.5 8.48528 8.48528 10.5 6 10.5C3.51472 10.5 1.5 8.48528 1.5 6C1.5 3.51472 3.51472 1.5 6 1.5C8.48528 1.5 10.5 3.51472 10.5 6Z"
87
- stroke="currentColor"
88
- strokeWidth="1.5"
89
- />
90
- <path
91
- d="M9.18198 2.81802L2.81802 9.18198"
92
- stroke="currentColor"
93
- strokeWidth="1.5"
94
- strokeLinecap="round"
95
- />
96
- </svg>
97
- );
98
-
99
- /**
100
- * Icono de Usuario/Personas para mostrar capacidad
101
- * Tamaño: 13x10px (según especificaciones de Figma)
102
- */
103
- export const UsersIcon: React.FC<{ className?: string }> = ({ className = '' }) => (
104
- <svg
105
- width="13"
106
- height="10"
107
- viewBox="0 0 13 10"
108
- fill="none"
109
- xmlns="http://www.w3.org/2000/svg"
110
- className={className}
111
- >
112
- <path
113
- d="M9.25 9V8C9.25 6.89543 8.35457 6 7.25 6H2.75C1.64543 6 0.75 6.89543 0.75 8V9M12.25 9V8C12.25 6.89543 11.3546 6 10.25 6H9.75M7 2.5C7 3.60457 6.10457 4.5 5 4.5C3.89543 4.5 3 3.60457 3 2.5C3 1.39543 3.89543 0.5 5 0.5C6.10457 0.5 7 1.39543 7 2.5ZM10 2C10 2.82843 9.32843 3.5 8.5 3.5C7.67157 3.5 7 2.82843 7 2C7 1.17157 7.67157 0.5 8.5 0.5C9.32843 0.5 10 1.17157 10 2Z"
114
- stroke="currentColor"
115
- strokeWidth="1"
116
- strokeLinecap="round"
117
- strokeLinejoin="round"
118
- />
119
- </svg>
120
- );