@windstream/react-shared-components 0.1.75 → 0.1.77

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 (204) hide show
  1. package/README.md +635 -635
  2. package/dist/contentful/index.esm.js +3 -3
  3. package/dist/contentful/index.esm.js.map +1 -1
  4. package/dist/contentful/index.js +3 -3
  5. package/dist/contentful/index.js.map +1 -1
  6. package/dist/index.esm.js +5 -13
  7. package/dist/index.esm.js.map +1 -1
  8. package/dist/index.js +5 -13
  9. package/dist/index.js.map +1 -1
  10. package/dist/next/index.esm.js +2 -2
  11. package/dist/next/index.esm.js.map +1 -1
  12. package/dist/next/index.js +2 -2
  13. package/dist/next/index.js.map +1 -1
  14. package/dist/styles.css +1 -1
  15. package/dist/utils/index.esm.js +1 -1
  16. package/dist/utils/index.esm.js.map +1 -1
  17. package/dist/utils/index.js +1 -1
  18. package/dist/utils/index.js.map +1 -1
  19. package/package.json +185 -185
  20. package/src/components/accordion/Accordion.stories.tsx +230 -230
  21. package/src/components/accordion/index.tsx +70 -70
  22. package/src/components/accordion/types.ts +12 -12
  23. package/src/components/alert-card/AlertCard.stories.tsx +171 -171
  24. package/src/components/alert-card/index.tsx +41 -41
  25. package/src/components/alert-card/types.ts +13 -13
  26. package/src/components/brand-button/BrandButton.stories.tsx +223 -223
  27. package/src/components/brand-button/helpers.ts +35 -35
  28. package/src/components/brand-button/index.tsx +120 -120
  29. package/src/components/brand-button/types.ts +38 -38
  30. package/src/components/button/Button.stories.tsx +108 -108
  31. package/src/components/button/index.tsx +27 -27
  32. package/src/components/button/types.ts +14 -14
  33. package/src/components/call-button/CallButton.stories.tsx +324 -324
  34. package/src/components/call-button/index.tsx +106 -106
  35. package/src/components/call-button/types.ts +16 -16
  36. package/src/components/checkbox/Checkbox.stories.tsx +247 -247
  37. package/src/components/checkbox/index.tsx +197 -197
  38. package/src/components/checkbox/types.ts +27 -27
  39. package/src/components/checklist/Checklist.stories.tsx +150 -150
  40. package/src/components/checklist/index.tsx +61 -61
  41. package/src/components/checklist/types.ts +17 -17
  42. package/src/components/collapse/Collapse.stories.tsx +255 -255
  43. package/src/components/collapse/index.tsx +46 -46
  44. package/src/components/collapse/types.ts +6 -6
  45. package/src/components/divider/Divider.stories.tsx +205 -205
  46. package/src/components/divider/index.tsx +22 -22
  47. package/src/components/divider/type.ts +3 -3
  48. package/src/components/image/Image.stories.tsx +113 -113
  49. package/src/components/image/index.tsx +25 -25
  50. package/src/components/image/types.ts +40 -40
  51. package/src/components/input/Input.stories.tsx +325 -325
  52. package/src/components/input/index.tsx +177 -177
  53. package/src/components/input/types.ts +37 -37
  54. package/src/components/link/Link.stories.tsx +163 -163
  55. package/src/components/link/index.tsx +116 -116
  56. package/src/components/link/types.ts +25 -25
  57. package/src/components/list/List.stories.tsx +272 -272
  58. package/src/components/list/index.tsx +88 -88
  59. package/src/components/list/list-item/index.tsx +38 -38
  60. package/src/components/list/list-item/types.ts +13 -13
  61. package/src/components/list/types.ts +29 -29
  62. package/src/components/material-icon/MaterialIcon.stories.tsx +322 -322
  63. package/src/components/material-icon/constants.ts +99 -99
  64. package/src/components/material-icon/index.tsx +47 -47
  65. package/src/components/material-icon/types.ts +31 -31
  66. package/src/components/modal/Modal.stories.tsx +171 -171
  67. package/src/components/modal/index.tsx +164 -164
  68. package/src/components/modal/types.ts +24 -24
  69. package/src/components/next-image/index.tsx +74 -74
  70. package/src/components/next-image/types.ts +1 -1
  71. package/src/components/pagination/index.tsx +91 -91
  72. package/src/components/pagination/types.ts +6 -6
  73. package/src/components/radio-button/RadioButton.stories.tsx +307 -307
  74. package/src/components/radio-button/index.tsx +75 -75
  75. package/src/components/radio-button/types.ts +21 -21
  76. package/src/components/see-more/SeeMore.stories.tsx +181 -181
  77. package/src/components/see-more/index.tsx +44 -44
  78. package/src/components/see-more/types.ts +4 -4
  79. package/src/components/select/Select.stories.tsx +411 -411
  80. package/src/components/select/index.tsx +155 -155
  81. package/src/components/select/types.ts +36 -36
  82. package/src/components/select-plan-button/SelectPlanButton.stories.tsx +184 -184
  83. package/src/components/select-plan-button/index.tsx +63 -63
  84. package/src/components/select-plan-button/types.ts +17 -17
  85. package/src/components/skeleton/Skeleton.stories.tsx +179 -179
  86. package/src/components/skeleton/index.tsx +61 -61
  87. package/src/components/skeleton/types.ts +4 -4
  88. package/src/components/spinner/Spinner.stories.tsx +335 -335
  89. package/src/components/spinner/index.tsx +44 -44
  90. package/src/components/spinner/types.ts +5 -5
  91. package/src/components/text/Text.stories.tsx +321 -321
  92. package/src/components/text/index.tsx +25 -25
  93. package/src/components/text/types.ts +45 -45
  94. package/src/components/tooltip/Tooltip.stories.tsx +219 -219
  95. package/src/components/tooltip/index.tsx +74 -74
  96. package/src/components/tooltip/types.ts +7 -7
  97. package/src/components/view-cart-button/ViewCartButton.stories.tsx +252 -252
  98. package/src/components/view-cart-button/index.tsx +42 -42
  99. package/src/components/view-cart-button/types.ts +5 -5
  100. package/src/contentful/blocks/accordion/Accordion.stories.mocks.tsx +128 -128
  101. package/src/contentful/blocks/accordion/Accordion.stories.tsx +98 -98
  102. package/src/contentful/blocks/accordion/index.tsx +112 -112
  103. package/src/contentful/blocks/accordion/types.ts +34 -34
  104. package/src/contentful/blocks/address-input-banner/index.tsx +52 -52
  105. package/src/contentful/blocks/address-input-banner/types.ts +14 -14
  106. package/src/contentful/blocks/anchored-bottom-banner/index.tsx +181 -181
  107. package/src/contentful/blocks/anchored-bottom-banner/types.ts +13 -13
  108. package/src/contentful/blocks/blogs-grid/index.tsx +134 -134
  109. package/src/contentful/blocks/blogs-grid/types.ts +26 -26
  110. package/src/contentful/blocks/blogs-grid-base/index.tsx +119 -119
  111. package/src/contentful/blocks/blogs-grid-base/types.ts +36 -36
  112. package/src/contentful/blocks/breadcrumbs/index.tsx +81 -81
  113. package/src/contentful/blocks/breadcrumbs/types.ts +6 -6
  114. package/src/contentful/blocks/button/Button.stories.tsx +40 -40
  115. package/src/contentful/blocks/button/index.tsx +131 -131
  116. package/src/contentful/blocks/button/types.ts +39 -39
  117. package/src/contentful/blocks/callout/Callout.stories.tsx +23 -23
  118. package/src/contentful/blocks/callout/index.tsx +252 -252
  119. package/src/contentful/blocks/callout/types.ts +68 -68
  120. package/src/contentful/blocks/cards/Cards.stories.tsx +23 -23
  121. package/src/contentful/blocks/cards/blog-card/index.tsx +129 -129
  122. package/src/contentful/blocks/cards/blog-card/types.ts +34 -34
  123. package/src/contentful/blocks/cards/floating-image-card/index.tsx +119 -119
  124. package/src/contentful/blocks/cards/floating-image-card/types.ts +30 -30
  125. package/src/contentful/blocks/cards/full-image-card/index.tsx +130 -130
  126. package/src/contentful/blocks/cards/full-image-card/types.ts +29 -29
  127. package/src/contentful/blocks/cards/index.tsx +13 -13
  128. package/src/contentful/blocks/cards/product-card/index.tsx +251 -251
  129. package/src/contentful/blocks/cards/product-card/types.ts +28 -28
  130. package/src/contentful/blocks/cards/simple-card/index.tsx +325 -325
  131. package/src/contentful/blocks/cards/simple-card/types.ts +71 -71
  132. package/src/contentful/blocks/cards/testimonial-card/index.tsx +90 -90
  133. package/src/contentful/blocks/cards/testimonial-card/types.tsx +12 -12
  134. package/src/contentful/blocks/cards/types.ts +1 -1
  135. package/src/contentful/blocks/carousel/Carousel.stories.tsx +23 -23
  136. package/src/contentful/blocks/carousel/helper.tsx +440 -440
  137. package/src/contentful/blocks/carousel/index.tsx +85 -85
  138. package/src/contentful/blocks/carousel/types.ts +144 -144
  139. package/src/contentful/blocks/cart-retention-banner/index.tsx +105 -105
  140. package/src/contentful/blocks/cart-retention-banner/types.ts +11 -11
  141. package/src/contentful/blocks/comparison-table/index.tsx +29 -29
  142. package/src/contentful/blocks/comparison-table/types.ts +6 -6
  143. package/src/contentful/blocks/cookiebanner/index.tsx +146 -146
  144. package/src/contentful/blocks/cookiebanner/type.ts +7 -7
  145. package/src/contentful/blocks/cta-callout/CtaCallout.stories.tsx +46 -46
  146. package/src/contentful/blocks/cta-callout/index.tsx +71 -71
  147. package/src/contentful/blocks/cta-callout/types.ts +26 -26
  148. package/src/contentful/blocks/dynamic-tabs/index.tsx +204 -204
  149. package/src/contentful/blocks/dynamic-tabs/types.ts +21 -21
  150. package/src/contentful/blocks/email-input-block/index.tsx +116 -116
  151. package/src/contentful/blocks/email-input-block/types.ts +16 -16
  152. package/src/contentful/blocks/find-kinetic/FindKinetic.stories.tsx +23 -23
  153. package/src/contentful/blocks/find-kinetic/index.tsx +130 -130
  154. package/src/contentful/blocks/find-kinetic/types.ts +19 -19
  155. package/src/contentful/blocks/floating-banner/FloatingBanner.stories.tsx +34 -34
  156. package/src/contentful/blocks/floating-banner/index.tsx +97 -97
  157. package/src/contentful/blocks/floating-banner/types.ts +22 -22
  158. package/src/contentful/blocks/footer/Footer.stories.tsx +317 -317
  159. package/src/contentful/blocks/footer/index.tsx +91 -91
  160. package/src/contentful/blocks/footer/types.ts +13 -13
  161. package/src/contentful/blocks/image-promo-bar/ImagePromoBar.stories.tsx +23 -23
  162. package/src/contentful/blocks/image-promo-bar/helper.tsx +28 -28
  163. package/src/contentful/blocks/image-promo-bar/index.tsx +246 -246
  164. package/src/contentful/blocks/image-promo-bar/types.ts +44 -44
  165. package/src/contentful/blocks/image-promo-bar/vimeo-embed.tsx +93 -93
  166. package/src/contentful/blocks/image-promo-bar/youtube-embed.tsx +46 -46
  167. package/src/contentful/blocks/modal/constants.ts +53 -53
  168. package/src/contentful/blocks/modal/index.tsx +107 -107
  169. package/src/contentful/blocks/modal/types.ts +12 -12
  170. package/src/contentful/blocks/navigation/desktop-link-groups.tsx/index.tsx +139 -139
  171. package/src/contentful/blocks/navigation/index.tsx +567 -512
  172. package/src/contentful/blocks/navigation/mobile-link-groups.tsx/index.tsx +82 -82
  173. package/src/contentful/blocks/navigation/types.ts +71 -71
  174. package/src/contentful/blocks/primary-hero/PrimaryHero.stories.tsx +23 -23
  175. package/src/contentful/blocks/primary-hero/index.tsx +236 -236
  176. package/src/contentful/blocks/primary-hero/types.ts +37 -37
  177. package/src/contentful/blocks/search-block/index.tsx +90 -90
  178. package/src/contentful/blocks/search-block/types.ts +15 -15
  179. package/src/contentful/blocks/shape-background-wrapper/ShapeBackgroundWrapper.stories.tsx +26 -26
  180. package/src/contentful/blocks/shape-background-wrapper/index.tsx +124 -124
  181. package/src/contentful/blocks/shape-background-wrapper/types.ts +36 -36
  182. package/src/contentful/blocks/text/Text.stories.tsx +23 -23
  183. package/src/contentful/blocks/text/index.tsx +12 -12
  184. package/src/contentful/blocks/text/types.ts +1 -1
  185. package/src/contentful/index.ts +105 -105
  186. package/src/hooks/contentful/use-contentful-rich-text.tsx +309 -309
  187. package/src/hooks/contentful/use-processed-check-list.ts +63 -63
  188. package/src/hooks/use-body-scroll-lock.ts +34 -34
  189. package/src/hooks/use-carousel-swipe.ts +264 -264
  190. package/src/hooks/use-outside-click.ts +17 -17
  191. package/src/index.ts +101 -101
  192. package/src/next/index.ts +5 -5
  193. package/src/setupTests.ts +46 -46
  194. package/src/stories/DocsTemplate.tsx +24 -24
  195. package/src/styles/globals.css +343 -343
  196. package/src/types/global.d.ts +9 -9
  197. package/src/types/micro-components.ts +99 -99
  198. package/src/types/utm.ts +49 -49
  199. package/src/utils/contentful/to-document.ts +24 -24
  200. package/src/utils/cookie.ts +84 -84
  201. package/src/utils/cx.ts +49 -49
  202. package/src/utils/index.ts +41 -41
  203. package/src/utils/speed-card-bg.ts +24 -24
  204. package/src/utils/utm.ts +221 -221
@@ -1,411 +1,411 @@
1
- import { Select } from "./index";
2
-
3
- import { DocsPage } from "@shared/stories/DocsTemplate";
4
- import type { Meta, StoryObj } from "@storybook/react";
5
-
6
- const meta: Meta<typeof Select> = {
7
- title: "Components/Select",
8
- component: Select,
9
- tags: ["autodocs"],
10
- parameters: {
11
- layout: "centered",
12
- docs: {
13
- page: DocsPage,
14
- description: {
15
- component:
16
- "A powerful select component built with react-select, featuring search/filtering, custom styling, and enhanced UX that matches the consumer app pattern.",
17
- },
18
- },
19
- },
20
- argTypes: {
21
- variant: {
22
- control: { type: "select" },
23
- options: ["default", "unstyled"],
24
- description: "Select styling variant",
25
- },
26
- size: {
27
- control: { type: "select" },
28
- options: ["sm", "md"],
29
- description: "Select size",
30
- },
31
- placeholder: {
32
- control: { type: "text" },
33
- description: "Placeholder text",
34
- },
35
- isDisabled: {
36
- control: { type: "boolean" },
37
- description: "Disable the select",
38
- },
39
- hasError: {
40
- control: { type: "boolean" },
41
- description: "Show error state",
42
- },
43
- error: {
44
- control: { type: "text" },
45
- description: "Error message text",
46
- },
47
- helperText: {
48
- control: { type: "text" },
49
- description: "Helper text",
50
- },
51
- label: {
52
- control: { type: "text" },
53
- description: "Label text",
54
- },
55
- isCustomStyle: {
56
- control: { type: "boolean" },
57
- description: "Use custom styling for dropdown indicator and values",
58
- },
59
- isSearchable: {
60
- control: { type: "boolean" },
61
- description: "Enable search/filtering functionality",
62
- },
63
- isClearable: {
64
- control: { type: "boolean" },
65
- description: "Allow clearing the selected value",
66
- },
67
- },
68
- args: {
69
- placeholder: "Select an option...",
70
- variant: "default",
71
- size: "md",
72
- isDisabled: false,
73
- hasError: false,
74
- isCustomStyle: false,
75
- isSearchable: true,
76
- isClearable: false,
77
- options: [
78
- { label: "Option 1", value: "option1" },
79
- { label: "Option 2", value: "option2" },
80
- { label: "Option 3", value: "option3" },
81
- ],
82
- },
83
- };
84
-
85
- export default meta;
86
- type Story = StoryObj<typeof meta>;
87
-
88
- // Default select
89
- export const Default: Story = {
90
- args: {},
91
- };
92
-
93
- // Select with label
94
- export const WithLabel: Story = {
95
- render: (args: any) => (
96
- <div className="space-y-2">
97
- <Select
98
- {...args}
99
- label="Choose an option"
100
- placeholder="Select an option"
101
- />
102
- </div>
103
- ),
104
- args: {
105
- label: "Choose an option",
106
- placeholder: "Select an option",
107
- },
108
- };
109
-
110
- // Error state
111
- export const Error: Story = {
112
- args: {
113
- hasError: true,
114
- error: "This field is required",
115
- placeholder: "Invalid selection",
116
- },
117
- render: (args: any) => (
118
- <div className="space-y-2">
119
- <Select {...args} />
120
- </div>
121
- ),
122
- };
123
-
124
- // With helper text
125
- export const WithHelperText: Story = {
126
- args: {
127
- helperText: "Please select the most appropriate option",
128
- placeholder: "Select an option",
129
- },
130
- };
131
-
132
- // Small select
133
- export const Small: Story = {
134
- args: {
135
- size: "sm",
136
- placeholder: "Small select",
137
- },
138
- };
139
-
140
- // Medium select
141
- export const Medium: Story = {
142
- args: {
143
- size: "md",
144
- placeholder: "Medium select",
145
- },
146
- };
147
-
148
- // Disabled select
149
- export const Disabled: Story = {
150
- args: {
151
- isDisabled: true,
152
- placeholder: "Disabled select",
153
- },
154
- };
155
-
156
- // Unstyled variant
157
- export const Unstyled: Story = {
158
- args: {
159
- variant: "unstyled",
160
- placeholder: "Unstyled select",
161
- },
162
- };
163
-
164
- // Searchable select
165
- export const Searchable: Story = {
166
- args: {
167
- isSearchable: true,
168
- placeholder: "Type to search...",
169
- options: [
170
- { label: "Apple", value: "apple" },
171
- { label: "Banana", value: "banana" },
172
- { label: "Cherry", value: "cherry" },
173
- { label: "Date", value: "date" },
174
- { label: "Elderberry", value: "elderberry" },
175
- { label: "Fig", value: "fig" },
176
- { label: "Grape", value: "grape" },
177
- ],
178
- },
179
- };
180
-
181
- // Clearable select
182
- export const Clearable: Story = {
183
- args: {
184
- isClearable: true,
185
- placeholder: "Select and clear option",
186
- value: { label: "Option 2", value: "option2" },
187
- },
188
- };
189
-
190
- // Custom style select
191
- export const CustomStyle: Story = {
192
- args: {
193
- isCustomStyle: true,
194
- placeholder: "Custom styled select",
195
- options: [
196
- { label: "Custom Option 1", value: "custom1" },
197
- { label: "Custom Option 2", value: "custom2" },
198
- { label: "Custom Option 3", value: "custom3" },
199
- ],
200
- },
201
- };
202
-
203
- // With filtering options
204
- export const WithFiltering: Story = {
205
- args: {
206
- isSearchable: true,
207
- placeholder: "Search with custom filter...",
208
- filterOptions: {
209
- ignoreCase: true,
210
- ignoreAccents: true,
211
- matchFrom: "any",
212
- },
213
- options: [
214
- { label: "São Paulo", value: "sao-paulo" },
215
- { label: "Café", value: "cafe" },
216
- { label: "Naïve", value: "naive" },
217
- { label: "Café au lait", value: "cafe-au-lait" },
218
- { label: "São José", value: "sao-jose" },
219
- ],
220
- },
221
- parameters: {
222
- docs: {
223
- description: {
224
- story:
225
- "Select with custom filtering options that ignore case and accents for better search experience.",
226
- },
227
- },
228
- },
229
- };
230
-
231
- // With many options
232
- export const ManyOptions: Story = {
233
- args: {
234
- placeholder: "Choose a country",
235
- options: [
236
- { label: "United States", value: "us" },
237
- { label: "Canada", value: "ca" },
238
- { label: "United Kingdom", value: "uk" },
239
- { label: "Germany", value: "de" },
240
- { label: "France", value: "fr" },
241
- { label: "Spain", value: "es" },
242
- { label: "Italy", value: "it" },
243
- { label: "Japan", value: "jp" },
244
- { label: "China", value: "cn" },
245
- { label: "Australia", value: "au" },
246
- { label: "Brazil", value: "br" },
247
- { label: "India", value: "in" },
248
- ],
249
- },
250
- };
251
-
252
- // With selected value
253
- export const WithSelectedValue: Story = {
254
- args: {
255
- value: { label: "Option 2", value: "option2" },
256
- placeholder: "Select an option",
257
- },
258
- };
259
-
260
- // All variants showcase
261
- export const AllVariants: Story = {
262
- render: () => (
263
- <div className="space-y-6">
264
- <div className="grid grid-cols-2 gap-4">
265
- <div>
266
- <label className="mb-1 block text-sm font-medium text-gray-700">
267
- Default
268
- </label>
269
- <Select
270
- variant="default"
271
- placeholder="Default select"
272
- options={[
273
- { label: "Option 1", value: "option1" },
274
- { label: "Option 2", value: "option2" },
275
- { label: "Option 3", value: "option3" },
276
- ]}
277
- />
278
- </div>
279
- <div>
280
- <label className="mb-1 block text-sm font-medium text-gray-700">
281
- Error
282
- </label>
283
- <Select
284
- hasError
285
- error="This field is required"
286
- placeholder="Error select"
287
- options={[
288
- { label: "Option 1", value: "option1" },
289
- { label: "Option 2", value: "option2" },
290
- { label: "Option 3", value: "option3" },
291
- ]}
292
- />
293
- </div>
294
- </div>
295
- <div className="grid grid-cols-2 gap-4">
296
- <div>
297
- <label className="mb-1 block text-sm font-medium text-gray-700">
298
- Small
299
- </label>
300
- <Select
301
- size="sm"
302
- placeholder="Small select"
303
- options={[
304
- { label: "Option 1", value: "option1" },
305
- { label: "Option 2", value: "option2" },
306
- { label: "Option 3", value: "option3" },
307
- ]}
308
- />
309
- </div>
310
- <div>
311
- <label className="mb-1 block text-sm font-medium text-gray-700">
312
- Medium
313
- </label>
314
- <Select
315
- size="md"
316
- placeholder="Medium select"
317
- options={[
318
- { label: "Option 1", value: "option1" },
319
- { label: "Option 2", value: "option2" },
320
- { label: "Option 3", value: "option3" },
321
- ]}
322
- />
323
- </div>
324
- </div>
325
- <div className="grid grid-cols-2 gap-4">
326
- <div>
327
- <label className="mb-1 block text-sm font-medium text-gray-700">
328
- Disabled
329
- </label>
330
- <Select
331
- isDisabled
332
- placeholder="Disabled select"
333
- options={[
334
- { label: "Option 1", value: "option1" },
335
- { label: "Option 2", value: "option2" },
336
- { label: "Option 3", value: "option3" },
337
- ]}
338
- />
339
- </div>
340
- <div>
341
- <label className="mb-1 block text-sm font-medium text-gray-700">
342
- With Helper Text
343
- </label>
344
- <Select
345
- helperText="Please select an option"
346
- placeholder="Select with helper"
347
- options={[
348
- { label: "Option 1", value: "option1" },
349
- { label: "Option 2", value: "option2" },
350
- { label: "Option 3", value: "option3" },
351
- ]}
352
- />
353
- </div>
354
- </div>
355
- </div>
356
- ),
357
- parameters: {
358
- docs: {
359
- description: {
360
- story: "Showcase of all select variants, sizes, and states.",
361
- },
362
- },
363
- },
364
- };
365
-
366
- // Form example
367
- export const FormExample: Story = {
368
- render: () => (
369
- <form className="space-y-4">
370
- <div>
371
- <label className="mb-1 block text-sm font-medium text-gray-700">
372
- Country *
373
- </label>
374
- <Select
375
- placeholder="Select your country"
376
- hasError
377
- error="Country is required"
378
- options={[
379
- { label: "United States", value: "us" },
380
- { label: "Canada", value: "ca" },
381
- { label: "United Kingdom", value: "uk" },
382
- { label: "Germany", value: "de" },
383
- { label: "France", value: "fr" },
384
- ]}
385
- />
386
- </div>
387
- <div>
388
- <label className="mb-1 block text-sm font-medium text-gray-700">
389
- State/Province
390
- </label>
391
- <Select
392
- placeholder="Select your state"
393
- helperText="Optional field"
394
- options={[
395
- { label: "California", value: "ca" },
396
- { label: "New York", value: "ny" },
397
- { label: "Texas", value: "tx" },
398
- { label: "Florida", value: "fl" },
399
- ]}
400
- />
401
- </div>
402
- </form>
403
- ),
404
- parameters: {
405
- docs: {
406
- description: {
407
- story: "Example of select components used in a form context.",
408
- },
409
- },
410
- },
411
- };
1
+ import { Select } from "./index";
2
+
3
+ import { DocsPage } from "@shared/stories/DocsTemplate";
4
+ import type { Meta, StoryObj } from "@storybook/react";
5
+
6
+ const meta: Meta<typeof Select> = {
7
+ title: "Components/Select",
8
+ component: Select,
9
+ tags: ["autodocs"],
10
+ parameters: {
11
+ layout: "centered",
12
+ docs: {
13
+ page: DocsPage,
14
+ description: {
15
+ component:
16
+ "A powerful select component built with react-select, featuring search/filtering, custom styling, and enhanced UX that matches the consumer app pattern.",
17
+ },
18
+ },
19
+ },
20
+ argTypes: {
21
+ variant: {
22
+ control: { type: "select" },
23
+ options: ["default", "unstyled"],
24
+ description: "Select styling variant",
25
+ },
26
+ size: {
27
+ control: { type: "select" },
28
+ options: ["sm", "md"],
29
+ description: "Select size",
30
+ },
31
+ placeholder: {
32
+ control: { type: "text" },
33
+ description: "Placeholder text",
34
+ },
35
+ isDisabled: {
36
+ control: { type: "boolean" },
37
+ description: "Disable the select",
38
+ },
39
+ hasError: {
40
+ control: { type: "boolean" },
41
+ description: "Show error state",
42
+ },
43
+ error: {
44
+ control: { type: "text" },
45
+ description: "Error message text",
46
+ },
47
+ helperText: {
48
+ control: { type: "text" },
49
+ description: "Helper text",
50
+ },
51
+ label: {
52
+ control: { type: "text" },
53
+ description: "Label text",
54
+ },
55
+ isCustomStyle: {
56
+ control: { type: "boolean" },
57
+ description: "Use custom styling for dropdown indicator and values",
58
+ },
59
+ isSearchable: {
60
+ control: { type: "boolean" },
61
+ description: "Enable search/filtering functionality",
62
+ },
63
+ isClearable: {
64
+ control: { type: "boolean" },
65
+ description: "Allow clearing the selected value",
66
+ },
67
+ },
68
+ args: {
69
+ placeholder: "Select an option...",
70
+ variant: "default",
71
+ size: "md",
72
+ isDisabled: false,
73
+ hasError: false,
74
+ isCustomStyle: false,
75
+ isSearchable: true,
76
+ isClearable: false,
77
+ options: [
78
+ { label: "Option 1", value: "option1" },
79
+ { label: "Option 2", value: "option2" },
80
+ { label: "Option 3", value: "option3" },
81
+ ],
82
+ },
83
+ };
84
+
85
+ export default meta;
86
+ type Story = StoryObj<typeof meta>;
87
+
88
+ // Default select
89
+ export const Default: Story = {
90
+ args: {},
91
+ };
92
+
93
+ // Select with label
94
+ export const WithLabel: Story = {
95
+ render: (args: any) => (
96
+ <div className="space-y-2">
97
+ <Select
98
+ {...args}
99
+ label="Choose an option"
100
+ placeholder="Select an option"
101
+ />
102
+ </div>
103
+ ),
104
+ args: {
105
+ label: "Choose an option",
106
+ placeholder: "Select an option",
107
+ },
108
+ };
109
+
110
+ // Error state
111
+ export const Error: Story = {
112
+ args: {
113
+ hasError: true,
114
+ error: "This field is required",
115
+ placeholder: "Invalid selection",
116
+ },
117
+ render: (args: any) => (
118
+ <div className="space-y-2">
119
+ <Select {...args} />
120
+ </div>
121
+ ),
122
+ };
123
+
124
+ // With helper text
125
+ export const WithHelperText: Story = {
126
+ args: {
127
+ helperText: "Please select the most appropriate option",
128
+ placeholder: "Select an option",
129
+ },
130
+ };
131
+
132
+ // Small select
133
+ export const Small: Story = {
134
+ args: {
135
+ size: "sm",
136
+ placeholder: "Small select",
137
+ },
138
+ };
139
+
140
+ // Medium select
141
+ export const Medium: Story = {
142
+ args: {
143
+ size: "md",
144
+ placeholder: "Medium select",
145
+ },
146
+ };
147
+
148
+ // Disabled select
149
+ export const Disabled: Story = {
150
+ args: {
151
+ isDisabled: true,
152
+ placeholder: "Disabled select",
153
+ },
154
+ };
155
+
156
+ // Unstyled variant
157
+ export const Unstyled: Story = {
158
+ args: {
159
+ variant: "unstyled",
160
+ placeholder: "Unstyled select",
161
+ },
162
+ };
163
+
164
+ // Searchable select
165
+ export const Searchable: Story = {
166
+ args: {
167
+ isSearchable: true,
168
+ placeholder: "Type to search...",
169
+ options: [
170
+ { label: "Apple", value: "apple" },
171
+ { label: "Banana", value: "banana" },
172
+ { label: "Cherry", value: "cherry" },
173
+ { label: "Date", value: "date" },
174
+ { label: "Elderberry", value: "elderberry" },
175
+ { label: "Fig", value: "fig" },
176
+ { label: "Grape", value: "grape" },
177
+ ],
178
+ },
179
+ };
180
+
181
+ // Clearable select
182
+ export const Clearable: Story = {
183
+ args: {
184
+ isClearable: true,
185
+ placeholder: "Select and clear option",
186
+ value: { label: "Option 2", value: "option2" },
187
+ },
188
+ };
189
+
190
+ // Custom style select
191
+ export const CustomStyle: Story = {
192
+ args: {
193
+ isCustomStyle: true,
194
+ placeholder: "Custom styled select",
195
+ options: [
196
+ { label: "Custom Option 1", value: "custom1" },
197
+ { label: "Custom Option 2", value: "custom2" },
198
+ { label: "Custom Option 3", value: "custom3" },
199
+ ],
200
+ },
201
+ };
202
+
203
+ // With filtering options
204
+ export const WithFiltering: Story = {
205
+ args: {
206
+ isSearchable: true,
207
+ placeholder: "Search with custom filter...",
208
+ filterOptions: {
209
+ ignoreCase: true,
210
+ ignoreAccents: true,
211
+ matchFrom: "any",
212
+ },
213
+ options: [
214
+ { label: "São Paulo", value: "sao-paulo" },
215
+ { label: "Café", value: "cafe" },
216
+ { label: "Naïve", value: "naive" },
217
+ { label: "Café au lait", value: "cafe-au-lait" },
218
+ { label: "São José", value: "sao-jose" },
219
+ ],
220
+ },
221
+ parameters: {
222
+ docs: {
223
+ description: {
224
+ story:
225
+ "Select with custom filtering options that ignore case and accents for better search experience.",
226
+ },
227
+ },
228
+ },
229
+ };
230
+
231
+ // With many options
232
+ export const ManyOptions: Story = {
233
+ args: {
234
+ placeholder: "Choose a country",
235
+ options: [
236
+ { label: "United States", value: "us" },
237
+ { label: "Canada", value: "ca" },
238
+ { label: "United Kingdom", value: "uk" },
239
+ { label: "Germany", value: "de" },
240
+ { label: "France", value: "fr" },
241
+ { label: "Spain", value: "es" },
242
+ { label: "Italy", value: "it" },
243
+ { label: "Japan", value: "jp" },
244
+ { label: "China", value: "cn" },
245
+ { label: "Australia", value: "au" },
246
+ { label: "Brazil", value: "br" },
247
+ { label: "India", value: "in" },
248
+ ],
249
+ },
250
+ };
251
+
252
+ // With selected value
253
+ export const WithSelectedValue: Story = {
254
+ args: {
255
+ value: { label: "Option 2", value: "option2" },
256
+ placeholder: "Select an option",
257
+ },
258
+ };
259
+
260
+ // All variants showcase
261
+ export const AllVariants: Story = {
262
+ render: () => (
263
+ <div className="space-y-6">
264
+ <div className="grid grid-cols-2 gap-4">
265
+ <div>
266
+ <label className="mb-1 block text-sm font-medium text-gray-700">
267
+ Default
268
+ </label>
269
+ <Select
270
+ variant="default"
271
+ placeholder="Default select"
272
+ options={[
273
+ { label: "Option 1", value: "option1" },
274
+ { label: "Option 2", value: "option2" },
275
+ { label: "Option 3", value: "option3" },
276
+ ]}
277
+ />
278
+ </div>
279
+ <div>
280
+ <label className="mb-1 block text-sm font-medium text-gray-700">
281
+ Error
282
+ </label>
283
+ <Select
284
+ hasError
285
+ error="This field is required"
286
+ placeholder="Error select"
287
+ options={[
288
+ { label: "Option 1", value: "option1" },
289
+ { label: "Option 2", value: "option2" },
290
+ { label: "Option 3", value: "option3" },
291
+ ]}
292
+ />
293
+ </div>
294
+ </div>
295
+ <div className="grid grid-cols-2 gap-4">
296
+ <div>
297
+ <label className="mb-1 block text-sm font-medium text-gray-700">
298
+ Small
299
+ </label>
300
+ <Select
301
+ size="sm"
302
+ placeholder="Small select"
303
+ options={[
304
+ { label: "Option 1", value: "option1" },
305
+ { label: "Option 2", value: "option2" },
306
+ { label: "Option 3", value: "option3" },
307
+ ]}
308
+ />
309
+ </div>
310
+ <div>
311
+ <label className="mb-1 block text-sm font-medium text-gray-700">
312
+ Medium
313
+ </label>
314
+ <Select
315
+ size="md"
316
+ placeholder="Medium select"
317
+ options={[
318
+ { label: "Option 1", value: "option1" },
319
+ { label: "Option 2", value: "option2" },
320
+ { label: "Option 3", value: "option3" },
321
+ ]}
322
+ />
323
+ </div>
324
+ </div>
325
+ <div className="grid grid-cols-2 gap-4">
326
+ <div>
327
+ <label className="mb-1 block text-sm font-medium text-gray-700">
328
+ Disabled
329
+ </label>
330
+ <Select
331
+ isDisabled
332
+ placeholder="Disabled select"
333
+ options={[
334
+ { label: "Option 1", value: "option1" },
335
+ { label: "Option 2", value: "option2" },
336
+ { label: "Option 3", value: "option3" },
337
+ ]}
338
+ />
339
+ </div>
340
+ <div>
341
+ <label className="mb-1 block text-sm font-medium text-gray-700">
342
+ With Helper Text
343
+ </label>
344
+ <Select
345
+ helperText="Please select an option"
346
+ placeholder="Select with helper"
347
+ options={[
348
+ { label: "Option 1", value: "option1" },
349
+ { label: "Option 2", value: "option2" },
350
+ { label: "Option 3", value: "option3" },
351
+ ]}
352
+ />
353
+ </div>
354
+ </div>
355
+ </div>
356
+ ),
357
+ parameters: {
358
+ docs: {
359
+ description: {
360
+ story: "Showcase of all select variants, sizes, and states.",
361
+ },
362
+ },
363
+ },
364
+ };
365
+
366
+ // Form example
367
+ export const FormExample: Story = {
368
+ render: () => (
369
+ <form className="space-y-4">
370
+ <div>
371
+ <label className="mb-1 block text-sm font-medium text-gray-700">
372
+ Country *
373
+ </label>
374
+ <Select
375
+ placeholder="Select your country"
376
+ hasError
377
+ error="Country is required"
378
+ options={[
379
+ { label: "United States", value: "us" },
380
+ { label: "Canada", value: "ca" },
381
+ { label: "United Kingdom", value: "uk" },
382
+ { label: "Germany", value: "de" },
383
+ { label: "France", value: "fr" },
384
+ ]}
385
+ />
386
+ </div>
387
+ <div>
388
+ <label className="mb-1 block text-sm font-medium text-gray-700">
389
+ State/Province
390
+ </label>
391
+ <Select
392
+ placeholder="Select your state"
393
+ helperText="Optional field"
394
+ options={[
395
+ { label: "California", value: "ca" },
396
+ { label: "New York", value: "ny" },
397
+ { label: "Texas", value: "tx" },
398
+ { label: "Florida", value: "fl" },
399
+ ]}
400
+ />
401
+ </div>
402
+ </form>
403
+ ),
404
+ parameters: {
405
+ docs: {
406
+ description: {
407
+ story: "Example of select components used in a form context.",
408
+ },
409
+ },
410
+ },
411
+ };