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,462 +1,462 @@
1
- import type { Meta, StoryObj } from '@storybook/react';
2
- import { NavigationRailPanel } from './NavigationRailPanel';
3
-
4
- const meta: Meta<typeof NavigationRailPanel> = {
5
- title: 'Components/NavigationRailPanel',
6
- component: NavigationRailPanel,
7
- parameters: {
8
- layout: 'centered',
9
- docs: {
10
- description: {
11
- component:
12
- 'Panel de navegación vertical (rail) que puede contener múltiples secciones de items, búsqueda y encabezados.',
13
- },
14
- },
15
- },
16
- tags: ['autodocs'],
17
- };
18
-
19
- export default meta;
20
- type Story = StoryObj<typeof NavigationRailPanel>;
21
-
22
- /**
23
- * Ejemplo completo con todas las características:
24
- * - Encabezado (DropdownItemHeading)
25
- * - Input de búsqueda
26
- * - Múltiples secciones con items colapsables y simples
27
- */
28
- export const Default: Story = {
29
- args: {
30
- height: 900,
31
- width: 248,
32
- showHeading: true,
33
- heading: {
34
- label: 'Settings',
35
- description: 'Configure your preferences',
36
- iconName: 'cog-6-tooth',
37
- actionLabel: 'Clear',
38
- showAction: true,
39
- onActionClick: () => console.log('Clear action clicked'),
40
- },
41
- showSearch: true,
42
- search: {
43
- placeholder: 'Buscar módulo',
44
- onChange: (value) => console.log('Search value:', value),
45
- },
46
- sections: [
47
- {
48
- heading: 'Section 1',
49
- showDivider: true,
50
- items: [
51
- {
52
- label: 'Collapsible Item 1',
53
- isCollapsible: true,
54
- children: [
55
- { label: 'Sub Item 1' },
56
- { label: 'Sub Item 2' },
57
- { label: 'Sub Item 3' },
58
- ],
59
- },
60
- {
61
- label: 'Simple Item 1',
62
- isCollapsible: false,
63
- },
64
- {
65
- label: 'Simple Item 2',
66
- isCollapsible: false,
67
- },
68
- ],
69
- },
70
- {
71
- heading: 'Section 2',
72
- showDivider: true,
73
- items: [
74
- {
75
- label: 'Collapsible Item 2',
76
- isCollapsible: true,
77
- children: [
78
- { label: 'Sub Item A' },
79
- { label: 'Sub Item B' },
80
- ],
81
- },
82
- {
83
- label: 'Simple Item 3',
84
- isCollapsible: false,
85
- },
86
- ],
87
- },
88
- {
89
- heading: 'Section 3',
90
- showDivider: false,
91
- items: [
92
- {
93
- label: 'Simple Item 4',
94
- isCollapsible: false,
95
- },
96
- {
97
- label: 'Simple Item 5',
98
- isCollapsible: false,
99
- },
100
- {
101
- label: 'Simple Item 6',
102
- isCollapsible: false,
103
- },
104
- ],
105
- },
106
- ],
107
- },
108
- render: (args) => (
109
- <div className="flex h-screen w-screen bg-gray-100">
110
- <NavigationRailPanel {...args} />
111
- <div className="flex-1 p-8 bg-white">
112
- <h1 className="text-3xl font-bold mb-4">Main Content</h1>
113
- <p className="text-gray-600">
114
- Click on items in the NavigationRailPanel to see the interaction.
115
- </p>
116
- </div>
117
- </div>
118
- ),
119
- };
120
-
121
- /**
122
- * Ejemplo simplificado sin encabezado ni búsqueda
123
- */
124
- export const Minimal: Story = {
125
- args: {
126
- height: 600,
127
- width: 248,
128
- showHeading: false,
129
- showSearch: false,
130
- items: [
131
- {
132
- label: 'Dashboard',
133
- isCollapsible: false,
134
- },
135
- {
136
- label: 'Users',
137
- isCollapsible: false,
138
- },
139
- {
140
- label: 'Settings',
141
- isCollapsible: false,
142
- },
143
- {
144
- label: 'Help',
145
- isCollapsible: false,
146
- },
147
- ],
148
- },
149
- };
150
-
151
- /**
152
- * Ejemplo con solo items colapsables
153
- */
154
- export const OnlyCollapsible: Story = {
155
- args: {
156
- height: 700,
157
- width: 248,
158
- showHeading: true,
159
- heading: {
160
- label: 'Menu',
161
- description: 'Select a category',
162
- iconName: 'bars-3',
163
- },
164
- showSearch: true,
165
- items: [
166
- {
167
- label: 'Category 1',
168
- isCollapsible: true,
169
- children: [
170
- { label: 'Option 1' },
171
- { label: 'Option 2' },
172
- { label: 'Option 3' },
173
- ],
174
- },
175
- {
176
- label: 'Category 2',
177
- isCollapsible: true,
178
- children: [
179
- { label: 'Option A' },
180
- { label: 'Option B' },
181
- ],
182
- },
183
- {
184
- label: 'Category 3',
185
- isCollapsible: true,
186
- children: [
187
- { label: 'Opción X' },
188
- { label: 'Opción Y' },
189
- { label: 'Opción Z' },
190
- ],
191
- },
192
- ],
193
- },
194
- };
195
-
196
- /**
197
- * Ejemplo con items deshabilitados
198
- */
199
- export const WithDisabledItems: Story = {
200
- args: {
201
- height: 600,
202
- width: 248,
203
- showHeading: false,
204
- showSearch: true,
205
- items: [
206
- {
207
- label: 'Active Item 1',
208
- isCollapsible: false,
209
- },
210
- {
211
- label: 'Disabled Item',
212
- isCollapsible: false,
213
- disabled: true,
214
- },
215
- {
216
- label: 'Active Item 2',
217
- isCollapsible: true,
218
- children: [
219
- { label: 'Sub Item 1' },
220
- { label: 'Sub Item 2 (disabled)', disabled: true },
221
- { label: 'Sub Item 3' },
222
- ],
223
- },
224
- {
225
- label: 'Disabled Collapsible',
226
- isCollapsible: true,
227
- disabled: true,
228
- children: [
229
- { label: 'Sub Item A' },
230
- { label: 'Sub Item B' },
231
- ],
232
- },
233
- ],
234
- },
235
- };
236
-
237
- /**
238
- * Ejemplo con mucho contenido para probar scroll
239
- */
240
- export const WithScroll: Story = {
241
- args: {
242
- height: 600,
243
- width: 248,
244
- showHeading: true,
245
- heading: {
246
- label: 'Large Menu',
247
- description: 'Scroll to see more items',
248
- iconName: 'list-bullet',
249
- },
250
- showSearch: true,
251
- sections: [
252
- {
253
- heading: 'Group 1',
254
- items: Array.from({ length: 5 }, (_, i) => ({
255
- label: `Item ${i + 1}`,
256
- isCollapsible: false,
257
- })),
258
- },
259
- {
260
- heading: 'Group 2',
261
- items: Array.from({ length: 5 }, (_, i) => ({
262
- label: `Item ${i + 6}`,
263
- isCollapsible: true,
264
- children: [
265
- { label: 'Sub 1' },
266
- { label: 'Sub 2' },
267
- ],
268
- })),
269
- },
270
- {
271
- heading: 'Group 3',
272
- items: Array.from({ length: 5 }, (_, i) => ({
273
- label: `Item ${i + 11}`,
274
- isCollapsible: false,
275
- })),
276
- },
277
- {
278
- heading: 'Group 4',
279
- items: Array.from({ length: 5 }, (_, i) => ({
280
- label: `Item ${i + 16}`,
281
- isCollapsible: false,
282
- })),
283
- },
284
- ],
285
- },
286
- };
287
-
288
- /**
289
- * Ejemplo con diferentes alturas
290
- */
291
- export const SmallHeight: Story = {
292
- args: {
293
- height: 400,
294
- width: 248,
295
- showHeading: false,
296
- showSearch: true,
297
- items: [
298
- {
299
- label: 'Item 1',
300
- isCollapsible: false,
301
- },
302
- {
303
- label: 'Item 2',
304
- isCollapsible: false,
305
- },
306
- {
307
- label: 'Item 3',
308
- isCollapsible: false,
309
- },
310
- ],
311
- },
312
- };
313
-
314
- /**
315
- * Ejemplo con callbacks de interacción
316
- */
317
- export const WithCallbacks: Story = {
318
- args: {
319
- height: 700,
320
- width: 248,
321
- showHeading: true,
322
- heading: {
323
- label: 'Interactive Panel',
324
- description: 'Check console for events',
325
- iconName: 'cursor-arrow-rays',
326
- actionLabel: 'Reset',
327
- showAction: true,
328
- onActionClick: () => console.log('Reset clicked'),
329
- },
330
- showSearch: true,
331
- search: {
332
- placeholder: 'Search...',
333
- onChange: (value) => console.log('Search:', value),
334
- },
335
- items: [
336
- {
337
- label: 'Item with Click',
338
- isCollapsible: false,
339
- onClick: () => console.log('Item 1 clicked'),
340
- },
341
- {
342
- label: 'Collapsible with Change',
343
- isCollapsible: true,
344
- children: [
345
- {
346
- label: 'Sub Item',
347
- onClick: (e) => {
348
- e.stopPropagation();
349
- console.log('Sub Item clicked');
350
- },
351
- },
352
- ],
353
- onOpenChange: (open) => console.log('Collapsible toggled:', open),
354
- },
355
- {
356
- label: 'Another Item',
357
- isCollapsible: false,
358
- onClick: () => console.log('Item 3 clicked'),
359
- },
360
- ],
361
- },
362
- };
363
-
364
- /**
365
- * Ejemplo con panel sin heading ni búsqueda, solo items
366
- */
367
- export const CleanLayout: Story = {
368
- args: {
369
- height: 800,
370
- width: 248,
371
- showHeading: false,
372
- showSearch: false,
373
- sections: [
374
- {
375
- heading: 'NAVIGATION',
376
- items: [
377
- {
378
- label: 'Dashboard',
379
- isCollapsible: false,
380
- },
381
- {
382
- label: 'Analytics',
383
- isCollapsible: false,
384
- },
385
- ],
386
- },
387
- {
388
- heading: 'MANAGEMENT',
389
- items: [
390
- {
391
- label: 'Users',
392
- isCollapsible: true,
393
- children: [
394
- { label: 'Active Users' },
395
- { label: 'Inactive Users' },
396
- { label: 'Pending Users' },
397
- ],
398
- },
399
- {
400
- label: 'Roles',
401
- isCollapsible: true,
402
- children: [
403
- { label: 'Admin' },
404
- { label: 'User' },
405
- { label: 'Guest' },
406
- ],
407
- },
408
- ],
409
- },
410
- {
411
- heading: 'SETTINGS',
412
- items: [
413
- {
414
- label: 'Preferences',
415
- isCollapsible: false,
416
- },
417
- {
418
- label: 'Integrations',
419
- isCollapsible: false,
420
- },
421
- {
422
- label: 'Advanced',
423
- isCollapsible: false,
424
- },
425
- ],
426
- },
427
- ],
428
- },
429
- };
430
-
431
- /**
432
- * Ejemplo con solo búsqueda, sin encabezado
433
- */
434
- export const SearchOnly: Story = {
435
- args: {
436
- height: 600,
437
- width: 248,
438
- showHeading: false,
439
- showSearch: true,
440
- search: {
441
- placeholder: 'Search items...',
442
- },
443
- items: [
444
- {
445
- label: 'Item 1',
446
- isCollapsible: false,
447
- },
448
- {
449
- label: 'Item 2',
450
- isCollapsible: false,
451
- },
452
- {
453
- label: 'Item 3',
454
- isCollapsible: false,
455
- },
456
- {
457
- label: 'Item 4',
458
- isCollapsible: false,
459
- },
460
- ],
461
- },
462
- };
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { NavigationRailPanel } from './NavigationRailPanel';
3
+
4
+ const meta: Meta<typeof NavigationRailPanel> = {
5
+ title: 'Components/NavigationRailPanel',
6
+ component: NavigationRailPanel,
7
+ parameters: {
8
+ layout: 'centered',
9
+ docs: {
10
+ description: {
11
+ component:
12
+ 'Panel de navegación vertical (rail) que puede contener múltiples secciones de items, búsqueda y encabezados.',
13
+ },
14
+ },
15
+ },
16
+ tags: ['autodocs'],
17
+ };
18
+
19
+ export default meta;
20
+ type Story = StoryObj<typeof NavigationRailPanel>;
21
+
22
+ /**
23
+ * Ejemplo completo con todas las características:
24
+ * - Encabezado (DropdownItemHeading)
25
+ * - Input de búsqueda
26
+ * - Múltiples secciones con items colapsables y simples
27
+ */
28
+ export const Default: Story = {
29
+ args: {
30
+ height: 900,
31
+ width: 248,
32
+ showHeading: true,
33
+ heading: {
34
+ label: 'Settings',
35
+ description: 'Configure your preferences',
36
+ iconName: 'cog-6-tooth',
37
+ actionLabel: 'Clear',
38
+ showAction: true,
39
+ onActionClick: () => console.log('Clear action clicked'),
40
+ },
41
+ showSearch: true,
42
+ search: {
43
+ placeholder: 'Buscar módulo',
44
+ onChange: (value) => console.log('Search value:', value),
45
+ },
46
+ sections: [
47
+ {
48
+ heading: 'Section 1',
49
+ showDivider: true,
50
+ items: [
51
+ {
52
+ label: 'Collapsible Item 1',
53
+ isCollapsible: true,
54
+ children: [
55
+ { label: 'Sub Item 1' },
56
+ { label: 'Sub Item 2' },
57
+ { label: 'Sub Item 3' },
58
+ ],
59
+ },
60
+ {
61
+ label: 'Simple Item 1',
62
+ isCollapsible: false,
63
+ },
64
+ {
65
+ label: 'Simple Item 2',
66
+ isCollapsible: false,
67
+ },
68
+ ],
69
+ },
70
+ {
71
+ heading: 'Section 2',
72
+ showDivider: true,
73
+ items: [
74
+ {
75
+ label: 'Collapsible Item 2',
76
+ isCollapsible: true,
77
+ children: [
78
+ { label: 'Sub Item A' },
79
+ { label: 'Sub Item B' },
80
+ ],
81
+ },
82
+ {
83
+ label: 'Simple Item 3',
84
+ isCollapsible: false,
85
+ },
86
+ ],
87
+ },
88
+ {
89
+ heading: 'Section 3',
90
+ showDivider: false,
91
+ items: [
92
+ {
93
+ label: 'Simple Item 4',
94
+ isCollapsible: false,
95
+ },
96
+ {
97
+ label: 'Simple Item 5',
98
+ isCollapsible: false,
99
+ },
100
+ {
101
+ label: 'Simple Item 6',
102
+ isCollapsible: false,
103
+ },
104
+ ],
105
+ },
106
+ ],
107
+ },
108
+ render: (args) => (
109
+ <div className="flex h-screen w-screen bg-gray-100">
110
+ <NavigationRailPanel {...args} />
111
+ <div className="flex-1 p-8 bg-white">
112
+ <h1 className="text-3xl font-bold mb-4">Main Content</h1>
113
+ <p className="text-gray-600">
114
+ Click on items in the NavigationRailPanel to see the interaction.
115
+ </p>
116
+ </div>
117
+ </div>
118
+ ),
119
+ };
120
+
121
+ /**
122
+ * Ejemplo simplificado sin encabezado ni búsqueda
123
+ */
124
+ export const Minimal: Story = {
125
+ args: {
126
+ height: 600,
127
+ width: 248,
128
+ showHeading: false,
129
+ showSearch: false,
130
+ items: [
131
+ {
132
+ label: 'Dashboard',
133
+ isCollapsible: false,
134
+ },
135
+ {
136
+ label: 'Users',
137
+ isCollapsible: false,
138
+ },
139
+ {
140
+ label: 'Settings',
141
+ isCollapsible: false,
142
+ },
143
+ {
144
+ label: 'Help',
145
+ isCollapsible: false,
146
+ },
147
+ ],
148
+ },
149
+ };
150
+
151
+ /**
152
+ * Ejemplo con solo items colapsables
153
+ */
154
+ export const OnlyCollapsible: Story = {
155
+ args: {
156
+ height: 700,
157
+ width: 248,
158
+ showHeading: true,
159
+ heading: {
160
+ label: 'Menu',
161
+ description: 'Select a category',
162
+ iconName: 'bars-3',
163
+ },
164
+ showSearch: true,
165
+ items: [
166
+ {
167
+ label: 'Category 1',
168
+ isCollapsible: true,
169
+ children: [
170
+ { label: 'Option 1' },
171
+ { label: 'Option 2' },
172
+ { label: 'Option 3' },
173
+ ],
174
+ },
175
+ {
176
+ label: 'Category 2',
177
+ isCollapsible: true,
178
+ children: [
179
+ { label: 'Option A' },
180
+ { label: 'Option B' },
181
+ ],
182
+ },
183
+ {
184
+ label: 'Category 3',
185
+ isCollapsible: true,
186
+ children: [
187
+ { label: 'Opción X' },
188
+ { label: 'Opción Y' },
189
+ { label: 'Opción Z' },
190
+ ],
191
+ },
192
+ ],
193
+ },
194
+ };
195
+
196
+ /**
197
+ * Ejemplo con items deshabilitados
198
+ */
199
+ export const WithDisabledItems: Story = {
200
+ args: {
201
+ height: 600,
202
+ width: 248,
203
+ showHeading: false,
204
+ showSearch: true,
205
+ items: [
206
+ {
207
+ label: 'Active Item 1',
208
+ isCollapsible: false,
209
+ },
210
+ {
211
+ label: 'Disabled Item',
212
+ isCollapsible: false,
213
+ disabled: true,
214
+ },
215
+ {
216
+ label: 'Active Item 2',
217
+ isCollapsible: true,
218
+ children: [
219
+ { label: 'Sub Item 1' },
220
+ { label: 'Sub Item 2 (disabled)', disabled: true },
221
+ { label: 'Sub Item 3' },
222
+ ],
223
+ },
224
+ {
225
+ label: 'Disabled Collapsible',
226
+ isCollapsible: true,
227
+ disabled: true,
228
+ children: [
229
+ { label: 'Sub Item A' },
230
+ { label: 'Sub Item B' },
231
+ ],
232
+ },
233
+ ],
234
+ },
235
+ };
236
+
237
+ /**
238
+ * Ejemplo con mucho contenido para probar scroll
239
+ */
240
+ export const WithScroll: Story = {
241
+ args: {
242
+ height: 600,
243
+ width: 248,
244
+ showHeading: true,
245
+ heading: {
246
+ label: 'Large Menu',
247
+ description: 'Scroll to see more items',
248
+ iconName: 'list-bullet',
249
+ },
250
+ showSearch: true,
251
+ sections: [
252
+ {
253
+ heading: 'Group 1',
254
+ items: Array.from({ length: 5 }, (_, i) => ({
255
+ label: `Item ${i + 1}`,
256
+ isCollapsible: false,
257
+ })),
258
+ },
259
+ {
260
+ heading: 'Group 2',
261
+ items: Array.from({ length: 5 }, (_, i) => ({
262
+ label: `Item ${i + 6}`,
263
+ isCollapsible: true,
264
+ children: [
265
+ { label: 'Sub 1' },
266
+ { label: 'Sub 2' },
267
+ ],
268
+ })),
269
+ },
270
+ {
271
+ heading: 'Group 3',
272
+ items: Array.from({ length: 5 }, (_, i) => ({
273
+ label: `Item ${i + 11}`,
274
+ isCollapsible: false,
275
+ })),
276
+ },
277
+ {
278
+ heading: 'Group 4',
279
+ items: Array.from({ length: 5 }, (_, i) => ({
280
+ label: `Item ${i + 16}`,
281
+ isCollapsible: false,
282
+ })),
283
+ },
284
+ ],
285
+ },
286
+ };
287
+
288
+ /**
289
+ * Ejemplo con diferentes alturas
290
+ */
291
+ export const SmallHeight: Story = {
292
+ args: {
293
+ height: 400,
294
+ width: 248,
295
+ showHeading: false,
296
+ showSearch: true,
297
+ items: [
298
+ {
299
+ label: 'Item 1',
300
+ isCollapsible: false,
301
+ },
302
+ {
303
+ label: 'Item 2',
304
+ isCollapsible: false,
305
+ },
306
+ {
307
+ label: 'Item 3',
308
+ isCollapsible: false,
309
+ },
310
+ ],
311
+ },
312
+ };
313
+
314
+ /**
315
+ * Ejemplo con callbacks de interacción
316
+ */
317
+ export const WithCallbacks: Story = {
318
+ args: {
319
+ height: 700,
320
+ width: 248,
321
+ showHeading: true,
322
+ heading: {
323
+ label: 'Interactive Panel',
324
+ description: 'Check console for events',
325
+ iconName: 'cursor-arrow-rays',
326
+ actionLabel: 'Reset',
327
+ showAction: true,
328
+ onActionClick: () => console.log('Reset clicked'),
329
+ },
330
+ showSearch: true,
331
+ search: {
332
+ placeholder: 'Search...',
333
+ onChange: (value) => console.log('Search:', value),
334
+ },
335
+ items: [
336
+ {
337
+ label: 'Item with Click',
338
+ isCollapsible: false,
339
+ onClick: () => console.log('Item 1 clicked'),
340
+ },
341
+ {
342
+ label: 'Collapsible with Change',
343
+ isCollapsible: true,
344
+ children: [
345
+ {
346
+ label: 'Sub Item',
347
+ onClick: (e) => {
348
+ e.stopPropagation();
349
+ console.log('Sub Item clicked');
350
+ },
351
+ },
352
+ ],
353
+ onOpenChange: (open) => console.log('Collapsible toggled:', open),
354
+ },
355
+ {
356
+ label: 'Another Item',
357
+ isCollapsible: false,
358
+ onClick: () => console.log('Item 3 clicked'),
359
+ },
360
+ ],
361
+ },
362
+ };
363
+
364
+ /**
365
+ * Ejemplo con panel sin heading ni búsqueda, solo items
366
+ */
367
+ export const CleanLayout: Story = {
368
+ args: {
369
+ height: 800,
370
+ width: 248,
371
+ showHeading: false,
372
+ showSearch: false,
373
+ sections: [
374
+ {
375
+ heading: 'NAVIGATION',
376
+ items: [
377
+ {
378
+ label: 'Dashboard',
379
+ isCollapsible: false,
380
+ },
381
+ {
382
+ label: 'Analytics',
383
+ isCollapsible: false,
384
+ },
385
+ ],
386
+ },
387
+ {
388
+ heading: 'MANAGEMENT',
389
+ items: [
390
+ {
391
+ label: 'Users',
392
+ isCollapsible: true,
393
+ children: [
394
+ { label: 'Active Users' },
395
+ { label: 'Inactive Users' },
396
+ { label: 'Pending Users' },
397
+ ],
398
+ },
399
+ {
400
+ label: 'Roles',
401
+ isCollapsible: true,
402
+ children: [
403
+ { label: 'Admin' },
404
+ { label: 'User' },
405
+ { label: 'Guest' },
406
+ ],
407
+ },
408
+ ],
409
+ },
410
+ {
411
+ heading: 'SETTINGS',
412
+ items: [
413
+ {
414
+ label: 'Preferences',
415
+ isCollapsible: false,
416
+ },
417
+ {
418
+ label: 'Integrations',
419
+ isCollapsible: false,
420
+ },
421
+ {
422
+ label: 'Advanced',
423
+ isCollapsible: false,
424
+ },
425
+ ],
426
+ },
427
+ ],
428
+ },
429
+ };
430
+
431
+ /**
432
+ * Ejemplo con solo búsqueda, sin encabezado
433
+ */
434
+ export const SearchOnly: Story = {
435
+ args: {
436
+ height: 600,
437
+ width: 248,
438
+ showHeading: false,
439
+ showSearch: true,
440
+ search: {
441
+ placeholder: 'Search items...',
442
+ },
443
+ items: [
444
+ {
445
+ label: 'Item 1',
446
+ isCollapsible: false,
447
+ },
448
+ {
449
+ label: 'Item 2',
450
+ isCollapsible: false,
451
+ },
452
+ {
453
+ label: 'Item 3',
454
+ isCollapsible: false,
455
+ },
456
+ {
457
+ label: 'Item 4',
458
+ isCollapsible: false,
459
+ },
460
+ ],
461
+ },
462
+ };