siesa-ui-kit 1.0.2 → 1.0.4

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 (189) hide show
  1. package/README.md +115 -115
  2. package/bin/install.cjs +502 -502
  3. package/bin/prepare-publish.cjs +28 -28
  4. package/bin/restore-folders.cjs +28 -28
  5. package/claude/agents/siesa-ui-kit-specialist.md +2445 -0
  6. package/claude/prompts/component-template.md +121 -0
  7. package/claude/prompts/siesa-ui-kit.md +28 -0
  8. package/claude/settings.local.json +67 -2
  9. package/dist/components/Button/icons.d.ts +6 -5
  10. package/dist/components/Button/icons.d.ts.map +1 -1
  11. package/dist/components/DropdownItemCollapsible/DropdownItemCollapsible.d.ts.map +1 -1
  12. package/dist/components/DropdownItemCollapsible/DropdownItemCollapsible.types.d.ts +21 -0
  13. package/dist/components/DropdownItemCollapsible/DropdownItemCollapsible.types.d.ts.map +1 -1
  14. package/dist/components/NavigationRailCommercial/NavigationRailCommercial.d.ts +122 -0
  15. package/dist/components/NavigationRailCommercial/NavigationRailCommercial.d.ts.map +1 -0
  16. package/dist/components/NavigationRailCommercial/NavigationRailCommercial.types.d.ts +139 -0
  17. package/dist/components/NavigationRailCommercial/NavigationRailCommercial.types.d.ts.map +1 -0
  18. package/dist/components/NavigationRailCommercial/icons.d.ts +33 -0
  19. package/dist/components/NavigationRailCommercial/icons.d.ts.map +1 -0
  20. package/dist/components/NavigationRailCommercial/index.d.ts +4 -0
  21. package/dist/components/NavigationRailCommercial/index.d.ts.map +1 -0
  22. package/dist/components/NavigationRailItem/NavigationRailItem.d.ts.map +1 -1
  23. package/dist/components/NavigationRailItem/NavigationRailItem.types.d.ts +7 -0
  24. package/dist/components/NavigationRailItem/NavigationRailItem.types.d.ts.map +1 -1
  25. package/dist/components/NavigationRailTypes/NavigationRailTypes.d.ts.map +1 -1
  26. package/dist/components/NavigationRailTypes/NavigationRailTypes.types.d.ts +41 -0
  27. package/dist/components/NavigationRailTypes/NavigationRailTypes.types.d.ts.map +1 -1
  28. package/dist/components/NavigationRailTypes/icons.d.ts +15 -29
  29. package/dist/components/NavigationRailTypes/icons.d.ts.map +1 -1
  30. package/dist/components/Select/Select.d.ts.map +1 -1
  31. package/dist/components/Select/icons.d.ts +6 -2
  32. package/dist/components/Select/icons.d.ts.map +1 -1
  33. package/dist/index.d.ts +32 -0
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/siesa-ui-kit.cjs +404 -190
  36. package/dist/siesa-ui-kit.cjs.map +1 -1
  37. package/dist/siesa-ui-kit.mjs +6590 -1506
  38. package/dist/siesa-ui-kit.mjs.map +1 -1
  39. package/dist/views/LayoutCommercial/LayoutCommercial.d.ts +48 -0
  40. package/dist/views/LayoutCommercial/LayoutCommercial.d.ts.map +1 -0
  41. package/dist/views/LayoutCommercial/LayoutCommercial.types.d.ts +49 -0
  42. package/dist/views/LayoutCommercial/LayoutCommercial.types.d.ts.map +1 -0
  43. package/dist/views/LayoutCommercial/index.d.ts +3 -0
  44. package/dist/views/LayoutCommercial/index.d.ts.map +1 -0
  45. package/docs/icons.md +12 -31
  46. package/package.json +111 -110
  47. package/src/components/Avatar/Avatar.stories.tsx +494 -494
  48. package/src/components/Button/Button.stories.tsx +950 -950
  49. package/src/components/Button/Button.tsx +337 -337
  50. package/src/components/Button/Button.types.ts +180 -180
  51. package/src/components/Button/icons.tsx +23 -62
  52. package/src/components/DescriptionList/DescriptionList.stories.tsx +250 -250
  53. package/src/components/Divider/Divider.stories.tsx +263 -263
  54. package/src/components/DropdownItemCollapsible/DropdownItemCollapsible.stories.tsx +317 -317
  55. package/src/components/DropdownItemCollapsible/DropdownItemCollapsible.tsx +307 -287
  56. package/src/components/DropdownItemCollapsible/DropdownItemCollapsible.types.ts +136 -111
  57. package/src/components/DropdownItemCollapsible/README.md +264 -264
  58. package/src/components/DropdownItemCollapsible/icons.tsx +57 -57
  59. package/src/components/DropdownItemCollapsible/index.ts +12 -12
  60. package/src/components/DropdownItemHeading/DropdownItemHeading.stories.tsx +386 -386
  61. package/src/components/DropdownItemHeading/DropdownItemHeading.tsx +216 -216
  62. package/src/components/DropdownItemHeading/DropdownItemHeading.types.ts +93 -93
  63. package/src/components/DropdownItemHeading/README.md +573 -573
  64. package/src/components/DropdownItemHeading/icons.tsx +125 -125
  65. package/src/components/DropdownItemHeading/index.ts +3 -3
  66. package/src/components/Input/Input.stories.tsx +583 -583
  67. package/src/components/LoginView/LoginView.stories.tsx +148 -148
  68. package/src/components/LoginView/LoginView.tsx +426 -426
  69. package/src/components/LoginView/LoginView.types.ts +52 -52
  70. package/src/components/LoginView/README.md +396 -396
  71. package/src/components/LoginView/icons.tsx +85 -85
  72. package/src/components/LoginView/index.ts +3 -3
  73. package/src/components/Navbar/Navbar.stories.tsx +810 -810
  74. package/src/components/Navbar/Navbar.tsx +755 -755
  75. package/src/components/Navbar/Navbar.types.ts +219 -219
  76. package/src/components/Navbar/README.md +279 -279
  77. package/src/components/Navbar/index.ts +8 -8
  78. package/src/components/NavigationRailCommercial/NavigationRailCommercial.stories.tsx +464 -0
  79. package/src/components/NavigationRailCommercial/NavigationRailCommercial.tsx +301 -0
  80. package/src/components/NavigationRailCommercial/NavigationRailCommercial.types.ts +162 -0
  81. package/src/components/NavigationRailCommercial/README.md +251 -0
  82. package/src/components/NavigationRailCommercial/icons.tsx +54 -0
  83. package/src/components/NavigationRailCommercial/index.ts +6 -0
  84. package/src/components/NavigationRailItem/NavigationRailItem.stories.tsx +667 -667
  85. package/src/components/NavigationRailItem/NavigationRailItem.tsx +314 -313
  86. package/src/components/NavigationRailItem/NavigationRailItem.types.ts +175 -167
  87. package/src/components/NavigationRailItem/README.md +476 -476
  88. package/src/components/NavigationRailItem/index.ts +2 -2
  89. package/src/components/NavigationRailPanel/NavigationRailPanel.stories.tsx +462 -462
  90. package/src/components/NavigationRailPanel/NavigationRailPanel.tsx +332 -332
  91. package/src/components/NavigationRailPanel/NavigationRailPanel.types.ts +178 -178
  92. package/src/components/NavigationRailPanel/README.md +461 -461
  93. package/src/components/NavigationRailPanel/index.ts +6 -6
  94. package/src/components/NavigationRailTypes/NavigationRailTypes.stories.tsx +682 -528
  95. package/src/components/NavigationRailTypes/NavigationRailTypes.tsx +363 -378
  96. package/src/components/NavigationRailTypes/NavigationRailTypes.types.ts +178 -130
  97. package/src/components/NavigationRailTypes/README.md +573 -573
  98. package/src/components/NavigationRailTypes/icons.tsx +76 -141
  99. package/src/components/NavigationRailTypes/index.ts +7 -7
  100. package/src/components/Notification/Notification.stories.tsx +513 -513
  101. package/src/components/Notification/Notification.tsx +145 -145
  102. package/src/components/Notification/Notification.types.ts +142 -142
  103. package/src/components/Notification/README.md +409 -409
  104. package/src/components/POSConvention/POSConvention.stories.tsx +235 -235
  105. package/src/components/POSConvention/POSConvention.tsx +129 -129
  106. package/src/components/POSConvention/POSConvention.types.ts +38 -38
  107. package/src/components/POSConvention/README.md +123 -123
  108. package/src/components/POSConvention/icons.tsx +45 -45
  109. package/src/components/POSConvention/index.ts +3 -3
  110. package/src/components/POSLocationButton/POSLocationButton.stories.tsx +531 -531
  111. package/src/components/POSLocationButton/POSLocationButton.tsx +247 -247
  112. package/src/components/POSLocationButton/POSLocationButton.types.ts +87 -87
  113. package/src/components/POSLocationButton/README.md +253 -253
  114. package/src/components/POSLocationButton/icons.tsx +120 -120
  115. package/src/components/POSLocationButton/index.ts +14 -14
  116. package/src/components/POSNumberButton/POSNumberButton.stories.tsx +415 -415
  117. package/src/components/POSNumberButton/POSNumberButton.tsx +179 -179
  118. package/src/components/POSNumberButton/POSNumberButton.types.ts +51 -51
  119. package/src/components/POSNumberButton/README.md +321 -321
  120. package/src/components/POSNumberButton/index.ts +3 -3
  121. package/src/components/POSProductButton/POSProductButton.stories.tsx +318 -318
  122. package/src/components/POSProductCard/POSProductCard.stories.tsx +642 -642
  123. package/src/components/POSProductCard/POSProductCard.tsx +208 -208
  124. package/src/components/POSProductCard/POSProductCard.types.ts +76 -76
  125. package/src/components/POSProductCard/README.md +179 -179
  126. package/src/components/POSProductCard/icons.tsx +26 -26
  127. package/src/components/POSProductCard/index.ts +2 -2
  128. package/src/components/POSProductSidebarItems/POSProductSidebarItems.stories.tsx +753 -753
  129. package/src/components/POSProductSidebarItems/POSProductSidebarItems.tsx +332 -332
  130. package/src/components/POSProductSidebarItems/POSProductSidebarItems.types.ts +119 -119
  131. package/src/components/POSProductSidebarItems/README.md +198 -198
  132. package/src/components/POSProductSidebarItems/icons.tsx +21 -21
  133. package/src/components/POSProductSidebarItems/index.ts +3 -3
  134. package/src/components/POSTable/POSTable.stories.tsx +737 -737
  135. package/src/components/POSTable/POSTable.tsx +401 -401
  136. package/src/components/POSTable/README.md +286 -286
  137. package/src/components/Quantity/Quantity.stories.tsx +457 -457
  138. package/src/components/Radio/Radio.stories.tsx +523 -523
  139. package/src/components/Radio/Radio.tsx +1 -1
  140. package/src/components/Select/Select.stories.tsx +32 -0
  141. package/src/components/Select/Select.tsx +457 -454
  142. package/src/components/Select/icons.tsx +16 -41
  143. package/src/components/SignUpView/SignUpView.stories.tsx +129 -129
  144. package/src/components/SignUpView/SignUpView.tsx +503 -503
  145. package/src/components/SignUpView/SignUpView.types.ts +58 -58
  146. package/src/components/SignUpView/icons.tsx +71 -71
  147. package/src/components/SignUpView/index.ts +3 -3
  148. package/src/components/Switch/README.md +112 -112
  149. package/src/components/Switch/Switch.stories.tsx +550 -550
  150. package/src/components/Switch/Switch.tsx +246 -246
  151. package/src/components/Switch/Switch.types.ts +67 -67
  152. package/src/components/Table/Table.stories.tsx +805 -805
  153. package/src/components/Tabs/README.md +201 -201
  154. package/src/components/Tabs/Tabs.stories.tsx +580 -580
  155. package/src/components/Tabs/Tabs.tsx +356 -356
  156. package/src/components/Tabs/Tabs.types.ts +127 -127
  157. package/src/components/Tabs/icons.tsx +129 -129
  158. package/src/components/Tabs/index.ts +11 -11
  159. package/src/components/Textarea/Textarea.stories.tsx +535 -535
  160. package/src/index.ts +133 -102
  161. package/src/views/LayoutCommercial/LayoutCommercial.stories.tsx +374 -0
  162. package/src/views/LayoutCommercial/LayoutCommercial.tsx +125 -0
  163. package/src/views/LayoutCommercial/LayoutCommercial.types.ts +54 -0
  164. package/src/views/LayoutCommercial/README.md +286 -0
  165. package/src/views/LayoutCommercial/index.ts +2 -0
  166. package/src/views/ListView/ListView.stories.tsx +329 -329
  167. package/src/views/ListView/ListView.tsx +570 -570
  168. package/src/views/ListView/ListView.types.ts +211 -211
  169. package/src/views/ListView/icons.tsx +282 -282
  170. package/src/views/ListView/index.ts +11 -11
  171. package/src/views/LoginView/LoginView.tsx +426 -426
  172. package/src/views/ProductsView/ProductsView.stories.tsx +344 -344
  173. package/src/views/ProductsView/ProductsView.tsx +480 -480
  174. package/src/views/ProductsView/ProductsView.types.ts +238 -238
  175. package/src/views/ProductsView/README.md +312 -312
  176. package/src/views/ProductsView/icons.tsx +38 -38
  177. package/src/views/ProductsView/index.ts +8 -8
  178. package/src/views/RecoverPasswordView/RecoverPasswordView.tsx +376 -376
  179. package/src/views/SignUpView/SignUpView.tsx +503 -503
  180. package/src/views/TableLayoutView/README.md +268 -268
  181. package/src/views/TableLayoutView/TableLayoutView.stories.tsx +235 -235
  182. package/src/views/TableLayoutView/TableLayoutView.tsx +461 -461
  183. package/src/views/TableLayoutView/TableLayoutView.types.ts +209 -209
  184. package/src/views/TableLayoutView/icons.tsx +113 -113
  185. package/src/views/TableLayoutView/index.ts +6 -6
  186. package/storybook/main.ts +19 -19
  187. package/storybook/preview.tsx +84 -84
  188. package/storybook/vitest.setup.ts +6 -6
  189. package/tailwind.config.js +128 -128
@@ -1,378 +1,363 @@
1
- import React, { useState } from 'react';
2
- import type { NavigationRailTypesProps, NavigationRailItem } from './NavigationRailTypes.types';
3
- import { ChevronRightIcon, ChevronLeftIcon, ClockIcon, MagnifyingGlassIcon } from './icons';
4
- import { Button } from '../Button/Button';
5
- import { Divider } from '../Divider/Divider';
6
- import { DropdownItemCollapsible } from '../DropdownItemCollapsible/DropdownItemCollapsible';
7
-
8
- /**
9
- * Componente NavigationRailTypes del sistema de diseño Siesa
10
- *
11
- * Barra de navegación lateral que permite dos modos visuales:
12
- * - **Collapsed (Colapsado)**: 80px width, solo iconos con botón de búsqueda
13
- * - **Expanded (Expandido)**: 215px width, con labels y búsqueda integrada
14
- *
15
- * **Características:**
16
- * - Dos modos: collapsed e expanded (toggle con botón "Colapsar")
17
- * - Soporta items con badges de notificación
18
- * - Items colapsables para agrupar navegación relacionada
19
- * - Botón "Recientes" en footer
20
- * - Búsqueda integrada (solo en modo expanded)
21
- * - Dark mode completo
22
- * - Focus rings adaptativos
23
- *
24
- * **Especificaciones de Figma:**
25
- * - Collapsed: 80px width, items con height 44px + gap 12px
26
- * - Expanded: 215px width, items reutilizan DropdownItemCollapsible
27
- * - Icono search: 16x16px, azul (#0e79fd)
28
- * - Borde derecho: 1px solid #e4e4e7 (collapsed)
29
- * - Borde izquierdo: 1px solid #e4e4e7 (expanded)
30
- * - Height total: 900px (scroll si necesario)
31
- *
32
- * **Estructura:**
33
- * 1. Header (Search en expanded) - altura variable
34
- * 2. Menu & Destinations - flex 1 con items scrollables
35
- * 3. Footer - Actions con divider y botones
36
- *
37
- * **Estados de Items:**
38
- * - `default`: Text color content-primary
39
- * - `hover`: Fondo hover-overlay, icon color content-custom-primary
40
- * - `active`: Fondo custom-primary, text color custom-primary
41
- * - `disabled`: Opacity 50%, sin interacción
42
- *
43
- * **Colores (Light Mode):**
44
- * - Background: background-primary (#ffffff)
45
- * - Borders: border-primary (#e4e4e7)
46
- * - Text: content-primary (#18181b)
47
- * - Icons: content-secondary (#a1a1aa)
48
- * - Icon hover: content-custom-primary (#0e79fd)
49
- * - Divider: border-primary (#e4e4e7)
50
- * - Search input: bg-primary, border-primary, placeholder: content-tertiary
51
- *
52
- * **Colores (Dark Mode):**
53
- * - Background: background-primary/dark (#09090b)
54
- * - Borders: border-primary/dark (#3f3f46)
55
- * - Text: content-primary/dark (#fafafa)
56
- * - Icons: content-secondary/dark (#a1a1aa)
57
- * - Icon hover: content-custom-primary/dark (#bfe2fe)
58
- * - Divider: border-primary/dark (#3f3f46)
59
- *
60
- * **Tipografía:**
61
- * - Items labels: Paragraph/Small (14px, Regular, line-height 20px)
62
- * - Heading: Paragraph/Tiny (12px, Regular, line-height 16px) - si aplica
63
- * - Button labels: Label Small (14px, Bold)
64
- *
65
- * @see docs/colors.md - Sistema de colores
66
- * @see docs/typography.md - Sistema tipográfico
67
- * @see docs/spacing.md - Sistema de espaciado (gap-3, px-4, py-2, etc)
68
- * @see https://www.figma.com/design/5XNqf2YTxvwemxwo1LMQ6j/Siesa-UI-Kit?node-id=6135-36219
69
- *
70
- * @example
71
- * ```tsx
72
- * const navItems: NavigationRailItem[] = [
73
- * {
74
- * id: 'home',
75
- * label: 'Home',
76
- * icon: <HomeIcon />,
77
- * active: true,
78
- * onClick: () => navigate('/home'),
79
- * },
80
- * {
81
- * id: 'users',
82
- * label: 'Users',
83
- * icon: <UsersIcon />,
84
- * badge: true,
85
- * onClick: () => navigate('/users'),
86
- * },
87
- * ];
88
- *
89
- * const [isCollapsed, setIsCollapsed] = useState(true);
90
- *
91
- * <NavigationRailTypes
92
- * collapsed={isCollapsed}
93
- * items={navItems}
94
- * showRecentButton={true}
95
- * onCollapsedChange={setIsCollapsed}
96
- * onItemClick={(index, item) => console.log('Selected:', item.id)}
97
- * />
98
- * ```
99
- *
100
- * @see NavigationRailTypes.types.ts - Props e interfaces
101
- */
102
- export const NavigationRailTypes = React.forwardRef<
103
- HTMLDivElement,
104
- NavigationRailTypesProps
105
- >(
106
- (
107
- {
108
- collapsed = true,
109
- items = [],
110
- showRecentButton = true,
111
- onCollapsedChange,
112
- onItemClick,
113
- className,
114
- },
115
- ref
116
- ) => {
117
- const [searchQuery, setSearchQuery] = useState('');
118
-
119
- const handleCollapsedToggle = () => {
120
- onCollapsedChange?.(!collapsed);
121
- };
122
-
123
- const handleItemClick = (index: number, item: NavigationRailItem) => {
124
- item.onClick?.(new Event('click') as any);
125
- onItemClick?.(index, item);
126
- };
127
-
128
- return (
129
- <div
130
- ref={ref}
131
- className={`
132
- ${collapsed ? 'w-[80px]' : 'w-[215px]'}
133
- bg-background-primary dark:bg-background-primary
134
- dark:border-border-primary dark:border-l
135
- ${collapsed ? 'border-r dark:border-border-primary border-border-primary' : 'border-l dark:border-border-primary border-border-primary'}
136
- border-solid
137
- h-[900px]
138
- flex flex-col
139
- items-center
140
- relative
141
- transition-all duration-300
142
- ${className || ''}
143
- `}
144
- >
145
- {/* Sección de búsqueda - solo en modo expandido */}
146
- {!collapsed && (
147
- <div className="w-full flex flex-col gap-3 px-3 py-3 relative shrink-0">
148
- <div className="w-full flex flex-col gap-2 items-start relative shrink-0">
149
- <div className="w-full bg-background-primary dark:bg-background-primary border border-border-primary dark:border-border-primary border-solid flex items-center overflow-hidden px-3 py-1.5 relative rounded-lg shadow-sm shrink-0">
150
- <div className="flex flex-1 gap-2 items-center min-h-px min-w-px relative shrink-0">
151
- <MagnifyingGlassIcon className="opacity-50 overflow-clip relative shrink-0 size-4 text-content-secondary dark:text-content-secondary" />
152
- <input
153
- type="text"
154
- placeholder="Buscar módulo"
155
- value={searchQuery}
156
- onChange={(e) => setSearchQuery(e.target.value)}
157
- className="
158
- flex-1 bg-transparent
159
- font-['SiesaBT',sans-serif] font-normal text-sm leading-5
160
- text-content-primary dark:text-content-primary
161
- placeholder:text-content-tertiary dark:placeholder:text-content-tertiary
162
- outline-none
163
- "
164
- />
165
- </div>
166
- </div>
167
- </div>
168
- <Divider className="w-full" />
169
- </div>
170
- )}
171
-
172
- {/* Main content - Menu & Destinations */}
173
- <div
174
- className={`
175
- flex-1 flex flex-col
176
- items-center min-h-px min-w-px
177
- relative shrink-0
178
- px-0
179
- ${collapsed
180
- ? 'gap-7 py-2 w-[80px]'
181
- : 'gap-0.5 p-3 w-full bg-background-primary dark:bg-background-primary border-l dark:border-border-primary border-border-primary border-solid'
182
- }
183
- `}
184
- >
185
- {/* Botón Search en collapsed */}
186
- {collapsed && (
187
- <Button
188
- type="default"
189
- size="xl"
190
- iconOnly
191
- leftIcon={<MagnifyingGlassIcon className="overflow-clip relative shrink-0 size-4 text-primary-inverse-content dark:text-primary-inverse-content" />}
192
- ariaLabel="Search"
193
- />
194
- )}
195
-
196
- {/* Items container */}
197
- <div
198
- className={`
199
- flex flex-col items-center min-h-px min-w-px
200
- relative shrink-0
201
- flex-1
202
- overflow-y-auto
203
- ${collapsed
204
- ? 'gap-3 leading-none w-[80px]'
205
- : 'gap-0.5 p-3 w-full'
206
- }
207
- `}
208
- >
209
- {items.length === 0 ? (
210
- // Items de demo/ejemplo
211
- <>
212
- {collapsed &&
213
- Array.from({ length: 4 }).map((_, idx) => (
214
- <div
215
- key={`demo-collapsed-${idx}`}
216
- className={`
217
- flex flex-col gap-1 items-center
218
- px-0.5 py-0 relative
219
- `}
220
- >
221
- <div className="flex flex-col items-center justify-center overflow-clip px-4 py-1 relative rounded-full shrink-0">
222
- <svg
223
- className="overflow-clip relative shrink-0 size-4 text-content-secondary dark:text-content-secondary"
224
- fill="none"
225
- viewBox="0 0 24 24"
226
- stroke="currentColor"
227
- >
228
- <path
229
- strokeLinecap="round"
230
- strokeLinejoin="round"
231
- strokeWidth={2}
232
- d="M3 12a9 9 0 1118 0 9 9 0 01-18 0z"
233
- />
234
- </svg>
235
- </div>
236
- </div>
237
- ))}
238
-
239
- {!collapsed &&
240
- Array.from({ length: 6 }).map((_, idx) => (
241
- <DropdownItemCollapsible
242
- key={`demo-expanded-${idx}`}
243
- label="Item"
244
- showDivider={false}
245
- showHeading={false}
246
- />
247
- ))}
248
- </>
249
- ) : collapsed ? (
250
- // Items reales - collapsed mode
251
- <>
252
- {items.map((item, idx) => (
253
- <button
254
- key={item.id}
255
- onClick={() => handleItemClick(idx, item)}
256
- disabled={item.disabled}
257
- className={`
258
- flex flex-col gap-1 items-center
259
- px-0.5 py-0
260
- relative
261
- rounded-full
262
- focus:outline-none focus:ring-4 focus:ring-offset-2
263
- focus:ring-primary-custom-400 focus:ring-offset-background-primary
264
- dark:focus:ring-offset-background-primary
265
- hover:opacity-80
266
- disabled:opacity-50 disabled:pointer-events-none
267
- transition-all duration-200
268
- ${item.active ? 'text-background-inverse-custom-primary dark:text-background-inverse-custom-primary' : 'text-content-secondary dark:text-content-secondary'}
269
- `}
270
- aria-label={item.ariaLabel || item.label}
271
- >
272
- <div className="flex flex-col items-center justify-center overflow-clip px-4 py-1 relative rounded-full shrink-0">
273
- {item.icon}
274
- </div>
275
- {(item.badge || item.badgeCount) && (
276
- <div
277
- className={`
278
- absolute top-0 right-0
279
- ${item.badgeCount
280
- ? 'w-5 h-5 text-xs font-bold flex items-center justify-center rounded-full'
281
- : 'w-2 h-2 rounded-full'
282
- }
283
- ${item.badgeColor === 'blue'
284
- ? 'bg-primary-custom-600 dark:bg-primary-custom-600 text-primary-inverse-content'
285
- : 'bg-red-600 dark:bg-red-600 text-white'
286
- }
287
- `}
288
- >
289
- {item.badgeCount ? (item.badgeCount > 99 ? '99+' : item.badgeCount) : ''}
290
- </div>
291
- )}
292
- </button>
293
- ))}
294
- </>
295
- ) : (
296
- // Items reales - expanded mode
297
- <>
298
- {items.map((item, idx) => (
299
- <div key={item.id} className="w-full">
300
- {/* TODO: Implementar items expandidos usando DropdownItemCollapsible */}
301
- <DropdownItemCollapsible
302
- label={item.label}
303
- icon={item.icon}
304
- showDivider={idx < items.length - 1}
305
- showHeading={false}
306
- disabled={item.disabled}
307
- onClick={() => handleItemClick(idx, item)}
308
- />
309
- </div>
310
- ))}
311
- </>
312
- )}
313
- </div>
314
-
315
- {/* Footer - Actions */}
316
- <div className={`w-full flex flex-col gap-3 items-center relative shrink-0 ${!collapsed ? 'px-3' : ''}`}>
317
- <Divider className="w-full" />
318
-
319
- <div
320
- className={`
321
- flex flex-col gap-3 relative shrink-0
322
- ${collapsed ? 'items-start px-3' : 'w-full items-stretch'}
323
- `}
324
- >
325
- {/* Botón Recientes */}
326
- {showRecentButton && collapsed && (
327
- <Button
328
- type="outline"
329
- size="base"
330
- iconOnly
331
- leftIcon={<ClockIcon className="size-4 text-primary-custom-600 dark:text-primary-custom-600" />}
332
- ariaLabel="Recientes"
333
- />
334
- )}
335
-
336
- {showRecentButton && !collapsed && (
337
- <Button
338
- type="outline"
339
- size="base"
340
- leftIcon={<ClockIcon className="size-4 text-primary-custom-600 dark:text-primary-custom-600" />}
341
- fullWidth
342
- >
343
- Recientes
344
- </Button>
345
- )}
346
-
347
- {/* Botón Colapsar/Expandir */}
348
- {collapsed ? (
349
- <Button
350
- type="plain"
351
- size="base"
352
- iconOnly
353
- leftIcon={<ChevronRightIcon className="overflow-clip relative shrink-0 size-4 text-background-inverse-custom-primary dark:text-background-inverse-custom-primary" />}
354
- onClick={handleCollapsedToggle}
355
- ariaLabel="Expandir"
356
- />
357
- ) : (
358
- <Button
359
- type="outline"
360
- size="base"
361
- leftIcon={<ChevronLeftIcon className="overflow-clip relative shrink-0 size-4 text-content-custom-primary dark:text-content-custom-primary" />}
362
- onClick={handleCollapsedToggle}
363
- fullWidth
364
- >
365
- Colapsar
366
- </Button>
367
- )}
368
- </div>
369
- </div>
370
- </div>
371
- </div>
372
- );
373
- }
374
- );
375
-
376
- NavigationRailTypes.displayName = 'NavigationRailTypes';
377
-
378
- export default NavigationRailTypes;
1
+ import React, { useState } from 'react';
2
+ import type { NavigationRailTypesProps, NavigationRailItem } from './NavigationRailTypes.types';
3
+ import { ChevronRightIcon, ChevronLeftIcon, ClockIcon, MagnifyingGlassIcon } from './icons';
4
+ import { Button } from '../Button/Button';
5
+ import { Divider } from '../Divider/Divider';
6
+ import { DropdownItemCollapsible } from '../DropdownItemCollapsible/DropdownItemCollapsible';
7
+ import { NavigationRailItem as NavigationRailItemComponent } from '../NavigationRailItem/NavigationRailItem';
8
+ import { Input } from '../Input/Input';
9
+
10
+ /**
11
+ * Componente NavigationRailTypes del sistema de diseño Siesa
12
+ *
13
+ * Barra de navegación lateral que permite dos modos visuales:
14
+ * - **Collapsed (Colapsado)**: 80px width, solo iconos con botón de búsqueda
15
+ * - **Expanded (Expandido)**: 215px width, con labels y búsqueda integrada
16
+ *
17
+ * **Características:**
18
+ * - Dos modos: collapsed e expanded (toggle con botón "Colapsar")
19
+ * - Soporta items con badges de notificación
20
+ * - Items colapsables para agrupar navegación relacionada
21
+ * - Botón "Recientes" en footer
22
+ * - Búsqueda integrada (solo en modo expanded)
23
+ * - Dark mode completo
24
+ * - Focus rings adaptativos
25
+ *
26
+ * **Especificaciones de Figma:**
27
+ * - Collapsed: 80px width, items con height 44px + gap 12px
28
+ * - Expanded: 215px width, items reutilizan DropdownItemCollapsible
29
+ * - Icono search: 16x16px, azul (#0e79fd)
30
+ * - Borde derecho: 1px solid #e4e4e7 (collapsed)
31
+ * - Borde izquierdo: 1px solid #e4e4e7 (expanded)
32
+ * - Height total: 900px (scroll si necesario)
33
+ *
34
+ * **Estructura:**
35
+ * 1. Header (Search en expanded) - altura variable
36
+ * 2. Menu & Destinations - flex 1 con items scrollables
37
+ * 3. Footer - Actions con divider y botones
38
+ *
39
+ * **Estados de Items:**
40
+ * - `default`: Text color content-primary
41
+ * - `hover`: Fondo hover-overlay, icon color content-custom-primary
42
+ * - `active`: Fondo custom-primary, text color custom-primary
43
+ * - `disabled`: Opacity 50%, sin interacción
44
+ *
45
+ * **Colores (Light Mode):**
46
+ * - Background: background-primary (#ffffff)
47
+ * - Borders: border-primary (#e4e4e7)
48
+ * - Text: content-primary (#18181b)
49
+ * - Icons: content-secondary (#a1a1aa)
50
+ * - Icon hover: content-custom-primary (#0e79fd)
51
+ * - Divider: border-primary (#e4e4e7)
52
+ * - Search input: bg-primary, border-primary, placeholder: content-tertiary
53
+ *
54
+ * **Colores (Dark Mode):**
55
+ * - Background: background-primary/dark (#09090b)
56
+ * - Borders: border-primary/dark (#3f3f46)
57
+ * - Text: content-primary/dark (#fafafa)
58
+ * - Icons: content-secondary/dark (#a1a1aa)
59
+ * - Icon hover: content-custom-primary/dark (#bfe2fe)
60
+ * - Divider: border-primary/dark (#3f3f46)
61
+ *
62
+ * **Tipografía:**
63
+ * - Items labels: Paragraph/Small (14px, Regular, line-height 20px)
64
+ * - Heading: Paragraph/Tiny (12px, Regular, line-height 16px) - si aplica
65
+ * - Button labels: Label Small (14px, Bold)
66
+ *
67
+ * @see docs/colors.md - Sistema de colores
68
+ * @see docs/typography.md - Sistema tipográfico
69
+ * @see docs/spacing.md - Sistema de espaciado (gap-3, px-4, py-2, etc)
70
+ * @see https://www.figma.com/design/5XNqf2YTxvwemxwo1LMQ6j/Siesa-UI-Kit?node-id=6135-36219
71
+ *
72
+ * @example
73
+ * ```tsx
74
+ * const navItems: NavigationRailItem[] = [
75
+ * {
76
+ * id: 'home',
77
+ * label: 'Home',
78
+ * icon: <HomeIcon />,
79
+ * active: true,
80
+ * onClick: () => navigate('/home'),
81
+ * },
82
+ * {
83
+ * id: 'users',
84
+ * label: 'Users',
85
+ * icon: <UsersIcon />,
86
+ * badge: true,
87
+ * onClick: () => navigate('/users'),
88
+ * },
89
+ * ];
90
+ *
91
+ * const [isCollapsed, setIsCollapsed] = useState(true);
92
+ *
93
+ * <NavigationRailTypes
94
+ * collapsed={isCollapsed}
95
+ * items={navItems}
96
+ * showRecentButton={true}
97
+ * onCollapsedChange={setIsCollapsed}
98
+ * onItemClick={(index, item) => console.log('Selected:', item.id)}
99
+ * />
100
+ * ```
101
+ *
102
+ * @see NavigationRailTypes.types.ts - Props e interfaces
103
+ */
104
+ export const NavigationRailTypes = React.forwardRef<
105
+ HTMLDivElement,
106
+ NavigationRailTypesProps
107
+ >(
108
+ (
109
+ {
110
+ collapsed = true,
111
+ items = [],
112
+ showRecentButton = true,
113
+ showSearchButton = true,
114
+ onCollapsedChange,
115
+ onItemClick,
116
+ onItemHover,
117
+ className,
118
+ labels = {},
119
+ },
120
+ ref
121
+ ) => {
122
+ const [searchQuery, setSearchQuery] = useState('');
123
+
124
+ // Labels con valores por defecto
125
+ const finalLabels = {
126
+ searchButton: labels.searchButton ?? 'Search',
127
+ searchPlaceholder: labels.searchPlaceholder ?? 'Buscar módulo',
128
+ recentButton: labels.recentButton ?? 'Recientes',
129
+ collapseButton: labels.collapseButton ?? 'Colapsar',
130
+ expandButton: labels.expandButton ?? 'Expandir',
131
+ };
132
+
133
+ const handleCollapsedToggle = () => {
134
+ onCollapsedChange?.(!collapsed);
135
+ };
136
+
137
+ const handleItemClick = (index: number, item: NavigationRailItem) => {
138
+ item.onClick?.(new Event('click') as any);
139
+ onItemClick?.(index, item);
140
+ };
141
+
142
+ const handleItemHover = (index: number, item: NavigationRailItem) => {
143
+ onItemHover?.(index, item);
144
+ };
145
+
146
+ return (
147
+ <div
148
+ ref={ref}
149
+ className={`
150
+ ${collapsed ? 'w-[80px]' : 'w-[215px]'}
151
+ h-full
152
+ bg-background-primary dark:bg-background-primary
153
+ ${collapsed ? 'border-r border-border-primary dark:border-border-primary' : 'border-l border-r border-border-primary dark:border-border-primary'}
154
+ border-solid
155
+ flex flex-col
156
+ items-center
157
+ relative
158
+ transition-all duration-300
159
+ ${className || ''}
160
+ `}
161
+ >
162
+ {/* Sección de búsqueda - solo en modo expandido */}
163
+ {!collapsed && (
164
+ <div className="w-full flex flex-col gap-3 px-3 py-3 relative shrink-0">
165
+ <Input
166
+ placeholder={finalLabels.searchPlaceholder}
167
+ value={searchQuery}
168
+ onChange={(e) => setSearchQuery(e.target.value)}
169
+ leftIcon={<MagnifyingGlassIcon className="size-4 text-content-secondary dark:text-content-secondary" />}
170
+ fullWidth
171
+ />
172
+ <Divider className="w-full" />
173
+ </div>
174
+ )}
175
+
176
+ {/* Main content - Menu & Destinations */}
177
+ <div
178
+ className={`
179
+ flex-1 flex flex-col
180
+ items-center min-h-px min-w-px
181
+ relative shrink-0
182
+ px-0
183
+ ${collapsed
184
+ ? 'gap-7 py-2 w-[80px]'
185
+ : 'gap-0.5 p-3 w-full bg-background-primary dark:bg-background-primary border-l dark:border-border-primary border-border-primary border-solid'
186
+ }
187
+ `}
188
+ >
189
+ {/* Botón Search en collapsed */}
190
+ {collapsed && showSearchButton && (
191
+ <Button
192
+ type="default"
193
+ size="xl"
194
+ iconOnly
195
+ leftIcon={<MagnifyingGlassIcon className="overflow-clip relative shrink-0 size-4 text-primary-inverse-content dark:text-primary-inverse-content" />}
196
+ ariaLabel={finalLabels.searchButton}
197
+ />
198
+ )}
199
+
200
+ {/* Items container */}
201
+ <div
202
+ className={`
203
+ flex flex-col items-center min-h-px min-w-px
204
+ relative shrink-0
205
+ flex-1
206
+ overflow-hidden
207
+ ${collapsed
208
+ ? 'gap-3 leading-none w-[80px]'
209
+ : 'gap-0.5 p-3 w-full'
210
+ }
211
+ `}
212
+ >
213
+ {items.length === 0 ? (
214
+ // Items de demo/ejemplo
215
+ <>
216
+ {collapsed &&
217
+ Array.from({ length: 4 }).map((_, idx) => (
218
+ <NavigationRailItemComponent
219
+ key={`demo-collapsed-${idx}`}
220
+ id={`demo-collapsed-${idx}`}
221
+ label="Item"
222
+ icon={
223
+ <svg
224
+ className="size-4"
225
+ fill="none"
226
+ viewBox="0 0 24 24"
227
+ stroke="currentColor"
228
+ >
229
+ <path
230
+ strokeLinecap="round"
231
+ strokeLinejoin="round"
232
+ strokeWidth={2}
233
+ d="M3 12a9 9 0 1118 0 9 9 0 01-18 0z"
234
+ />
235
+ </svg>
236
+ }
237
+ showLabelText={false}
238
+ />
239
+ ))}
240
+
241
+ {!collapsed &&
242
+ Array.from({ length: 6 }).map((_, idx) => (
243
+ <DropdownItemCollapsible
244
+ key={`demo-expanded-${idx}`}
245
+ label="Item"
246
+ showDivider={false}
247
+ showHeading={false}
248
+ />
249
+ ))}
250
+ </>
251
+ ) : collapsed ? (
252
+ // Items reales - collapsed mode
253
+ <>
254
+ {items.map((item, idx) => (
255
+ <NavigationRailItemComponent
256
+ key={item.id}
257
+ id={item.id}
258
+ label={item.label}
259
+ icon={item.icon}
260
+ selected={item.active}
261
+ disabled={item.disabled}
262
+ badge={item.badge}
263
+ badgeCount={item.badgeCount}
264
+ ariaLabel={item.ariaLabel}
265
+ showLabelText={false}
266
+ onClick={() => handleItemClick(idx, item)}
267
+ onMouseEnter={() => handleItemHover(idx, item)}
268
+ />
269
+ ))}
270
+ </>
271
+ ) : (
272
+ // Items reales - expanded mode
273
+ <>
274
+ {items.map((item, idx) => {
275
+ const isCollapsible = (item as any).children && (item as any).children.length > 0;
276
+ return (
277
+ <div key={item.id} className="w-full">
278
+ <DropdownItemCollapsible
279
+ label={item.label}
280
+ icon={item.icon}
281
+ selected={item.active}
282
+ disabled={item.disabled}
283
+ badge={item.badge}
284
+ badgeCount={item.badgeCount}
285
+ badgeColor={item.badgeColor as any}
286
+ showDivider={false}
287
+ showHeading={false}
288
+ isCollapsible={isCollapsible}
289
+ defaultOpen={(item as any).defaultOpen}
290
+ children={isCollapsible ? (item as any).children : undefined}
291
+ onClick={() => handleItemClick(idx, item)}
292
+ />
293
+ </div>
294
+ );
295
+ })}
296
+ </>
297
+ )}
298
+ </div>
299
+
300
+ {/* Footer - Actions */}
301
+ <div className={`w-full flex flex-col gap-3 items-center relative shrink-0 ${!collapsed ? 'px-3' : ''}`}>
302
+ <Divider className="w-full" />
303
+
304
+ <div
305
+ className={`
306
+ flex flex-col gap-3 relative shrink-0 w-full
307
+ ${collapsed ? 'items-stretch px-3' : 'items-stretch'}
308
+ `}
309
+ >
310
+ {/* Botón Recientes */}
311
+ {showRecentButton && collapsed && (
312
+ <Button
313
+ type="outline"
314
+ size="base"
315
+ fullWidth
316
+ leftIcon={<ClockIcon className="size-4 text-primary-custom-600 dark:text-primary-custom-600" />}
317
+ ariaLabel={finalLabels.recentButton}
318
+ />
319
+ )}
320
+
321
+ {showRecentButton && !collapsed && (
322
+ <Button
323
+ type="outline"
324
+ size="base"
325
+ leftIcon={<ClockIcon className="size-4 text-primary-custom-600 dark:text-primary-custom-600" />}
326
+ fullWidth
327
+ >
328
+ {finalLabels.recentButton}
329
+ </Button>
330
+ )}
331
+
332
+ {/* Botón Colapsar/Expandir */}
333
+ {collapsed ? (
334
+ <Button
335
+ type="plain"
336
+ size="base"
337
+ fullWidth
338
+ leftIcon={<ChevronRightIcon className="overflow-clip relative shrink-0 size-4 text-background-inverse-custom-primary dark:text-background-inverse-custom-primary" />}
339
+ onClick={handleCollapsedToggle}
340
+ ariaLabel={finalLabels.expandButton}
341
+ />
342
+ ) : (
343
+ <Button
344
+ type="outline"
345
+ size="base"
346
+ leftIcon={<ChevronLeftIcon className="overflow-clip relative shrink-0 size-4 text-content-custom-primary dark:text-content-custom-primary" />}
347
+ onClick={handleCollapsedToggle}
348
+ fullWidth
349
+ >
350
+ {finalLabels.collapseButton}
351
+ </Button>
352
+ )}
353
+ </div>
354
+ </div>
355
+ </div>
356
+ </div>
357
+ );
358
+ }
359
+ );
360
+
361
+ NavigationRailTypes.displayName = 'NavigationRailTypes';
362
+
363
+ export default NavigationRailTypes;