@windstream/react-shared-components 0.1.91 → 0.1.92

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 (199) hide show
  1. package/README.md +635 -635
  2. package/dist/contentful/index.esm.js +2 -2
  3. package/dist/contentful/index.esm.js.map +1 -1
  4. package/dist/contentful/index.js +2 -2
  5. package/dist/contentful/index.js.map +1 -1
  6. package/dist/index.d.ts +1 -1
  7. package/dist/index.js.map +1 -1
  8. package/dist/styles.css +1 -1
  9. package/package.json +185 -185
  10. package/src/components/accordion/Accordion.stories.tsx +230 -230
  11. package/src/components/accordion/index.tsx +70 -70
  12. package/src/components/accordion/types.ts +12 -12
  13. package/src/components/alert-card/AlertCard.stories.tsx +171 -171
  14. package/src/components/alert-card/index.tsx +41 -41
  15. package/src/components/alert-card/types.ts +13 -13
  16. package/src/components/animation-wrapper/index.tsx +129 -129
  17. package/src/components/animation-wrapper/types.ts +11 -11
  18. package/src/components/brand-button/BrandButton.stories.tsx +223 -223
  19. package/src/components/brand-button/helpers.ts +35 -35
  20. package/src/components/brand-button/index.tsx +120 -120
  21. package/src/components/brand-button/types.ts +38 -38
  22. package/src/components/button/Button.stories.tsx +108 -108
  23. package/src/components/button/index.tsx +27 -27
  24. package/src/components/button/types.ts +14 -14
  25. package/src/components/call-button/CallButton.stories.tsx +324 -324
  26. package/src/components/call-button/index.tsx +106 -106
  27. package/src/components/call-button/types.ts +16 -16
  28. package/src/components/checkbox/Checkbox.stories.tsx +247 -247
  29. package/src/components/checkbox/index.tsx +197 -197
  30. package/src/components/checkbox/types.ts +27 -27
  31. package/src/components/checklist/Checklist.stories.tsx +150 -150
  32. package/src/components/checklist/index.tsx +61 -61
  33. package/src/components/checklist/types.ts +17 -17
  34. package/src/components/collapse/Collapse.stories.tsx +255 -255
  35. package/src/components/collapse/index.tsx +46 -46
  36. package/src/components/collapse/types.ts +6 -6
  37. package/src/components/divider/Divider.stories.tsx +205 -205
  38. package/src/components/divider/index.tsx +22 -22
  39. package/src/components/divider/type.ts +3 -3
  40. package/src/components/image/Image.stories.tsx +113 -113
  41. package/src/components/image/index.tsx +25 -25
  42. package/src/components/image/types.ts +40 -40
  43. package/src/components/input/Input.stories.tsx +325 -325
  44. package/src/components/input/index.tsx +177 -177
  45. package/src/components/input/types.ts +37 -37
  46. package/src/components/link/Link.stories.tsx +163 -163
  47. package/src/components/link/index.tsx +116 -116
  48. package/src/components/link/types.ts +25 -25
  49. package/src/components/list/List.stories.tsx +272 -272
  50. package/src/components/list/index.tsx +88 -88
  51. package/src/components/list/list-item/index.tsx +38 -38
  52. package/src/components/list/list-item/types.ts +13 -13
  53. package/src/components/list/types.ts +29 -29
  54. package/src/components/material-icon/MaterialIcon.stories.tsx +322 -322
  55. package/src/components/material-icon/constants.ts +99 -99
  56. package/src/components/material-icon/index.tsx +47 -47
  57. package/src/components/material-icon/types.ts +31 -31
  58. package/src/components/modal/Modal.stories.tsx +171 -171
  59. package/src/components/modal/index.tsx +164 -164
  60. package/src/components/modal/types.ts +24 -24
  61. package/src/components/next-image/index.tsx +74 -74
  62. package/src/components/next-image/types.ts +1 -1
  63. package/src/components/pagination/index.tsx +91 -91
  64. package/src/components/pagination/types.ts +6 -6
  65. package/src/components/radio-button/RadioButton.stories.tsx +307 -307
  66. package/src/components/radio-button/index.tsx +75 -75
  67. package/src/components/radio-button/types.ts +21 -21
  68. package/src/components/see-more/SeeMore.stories.tsx +181 -181
  69. package/src/components/see-more/index.tsx +44 -44
  70. package/src/components/see-more/types.ts +4 -4
  71. package/src/components/select/Select.stories.tsx +411 -411
  72. package/src/components/select/index.tsx +155 -155
  73. package/src/components/select/types.ts +36 -36
  74. package/src/components/select-plan-button/SelectPlanButton.stories.tsx +184 -184
  75. package/src/components/select-plan-button/index.tsx +63 -63
  76. package/src/components/select-plan-button/types.ts +17 -17
  77. package/src/components/skeleton/Skeleton.stories.tsx +179 -179
  78. package/src/components/skeleton/index.tsx +61 -61
  79. package/src/components/skeleton/types.ts +4 -4
  80. package/src/components/spinner/Spinner.stories.tsx +335 -335
  81. package/src/components/spinner/index.tsx +44 -44
  82. package/src/components/spinner/types.ts +5 -5
  83. package/src/components/text/Text.stories.tsx +321 -321
  84. package/src/components/text/index.tsx +25 -25
  85. package/src/components/text/types.ts +45 -45
  86. package/src/components/tooltip/Tooltip.stories.tsx +219 -219
  87. package/src/components/tooltip/index.tsx +74 -74
  88. package/src/components/tooltip/types.ts +7 -7
  89. package/src/components/view-cart-button/ViewCartButton.stories.tsx +252 -252
  90. package/src/components/view-cart-button/index.tsx +42 -42
  91. package/src/components/view-cart-button/types.ts +5 -5
  92. package/src/contentful/blocks/accordion/Accordion.stories.mocks.tsx +128 -128
  93. package/src/contentful/blocks/accordion/Accordion.stories.tsx +98 -98
  94. package/src/contentful/blocks/accordion/index.tsx +112 -112
  95. package/src/contentful/blocks/accordion/types.ts +34 -34
  96. package/src/contentful/blocks/address-input-banner/index.tsx +52 -52
  97. package/src/contentful/blocks/address-input-banner/types.ts +14 -14
  98. package/src/contentful/blocks/anchored-bottom-banner/index.tsx +181 -181
  99. package/src/contentful/blocks/anchored-bottom-banner/types.ts +13 -13
  100. package/src/contentful/blocks/blogs-grid/BlogGrid.stories.mocks.tsx +144 -144
  101. package/src/contentful/blocks/blogs-grid/BlogGrid.stories.tsx +156 -156
  102. package/src/contentful/blocks/blogs-grid/index.tsx +134 -134
  103. package/src/contentful/blocks/blogs-grid/types.ts +26 -26
  104. package/src/contentful/blocks/blogs-grid-base/index.tsx +119 -119
  105. package/src/contentful/blocks/blogs-grid-base/types.ts +36 -36
  106. package/src/contentful/blocks/breadcrumbs/BreadcrumbNavigation.stories.tsx +147 -147
  107. package/src/contentful/blocks/breadcrumbs/index.tsx +95 -95
  108. package/src/contentful/blocks/breadcrumbs/types.ts +8 -8
  109. package/src/contentful/blocks/button/Button.stories.tsx +40 -40
  110. package/src/contentful/blocks/button/index.tsx +131 -131
  111. package/src/contentful/blocks/button/types.ts +39 -39
  112. package/src/contentful/blocks/callout/Callout.stories.tsx +23 -23
  113. package/src/contentful/blocks/callout/index.tsx +277 -277
  114. package/src/contentful/blocks/callout/types.ts +78 -78
  115. package/src/contentful/blocks/cards/Cards.stories.tsx +23 -23
  116. package/src/contentful/blocks/cards/blog-card/index.tsx +129 -129
  117. package/src/contentful/blocks/cards/blog-card/types.ts +34 -34
  118. package/src/contentful/blocks/cards/floating-image-card/index.tsx +119 -119
  119. package/src/contentful/blocks/cards/floating-image-card/types.ts +30 -30
  120. package/src/contentful/blocks/cards/full-image-card/index.tsx +130 -130
  121. package/src/contentful/blocks/cards/full-image-card/types.ts +29 -29
  122. package/src/contentful/blocks/cards/index.tsx +13 -13
  123. package/src/contentful/blocks/cards/product-card/index.tsx +251 -251
  124. package/src/contentful/blocks/cards/product-card/types.ts +28 -28
  125. package/src/contentful/blocks/cards/simple-card/index.tsx +325 -325
  126. package/src/contentful/blocks/cards/simple-card/types.ts +71 -71
  127. package/src/contentful/blocks/cards/testimonial-card/index.tsx +90 -90
  128. package/src/contentful/blocks/cards/testimonial-card/types.tsx +12 -12
  129. package/src/contentful/blocks/cards/types.ts +1 -1
  130. package/src/contentful/blocks/carousel/Carousel.stories.tsx +23 -23
  131. package/src/contentful/blocks/carousel/helper.tsx +494 -494
  132. package/src/contentful/blocks/carousel/index.tsx +87 -87
  133. package/src/contentful/blocks/carousel/types.ts +145 -145
  134. package/src/contentful/blocks/cart-retention-banner/index.tsx +109 -109
  135. package/src/contentful/blocks/cart-retention-banner/types.ts +11 -11
  136. package/src/contentful/blocks/comparison-table/index.tsx +29 -29
  137. package/src/contentful/blocks/comparison-table/types.ts +6 -6
  138. package/src/contentful/blocks/cookiebanner/index.tsx +146 -146
  139. package/src/contentful/blocks/cookiebanner/type.ts +7 -7
  140. package/src/contentful/blocks/cta-callout/CtaCallout.stories.tsx +46 -46
  141. package/src/contentful/blocks/cta-callout/index.tsx +73 -73
  142. package/src/contentful/blocks/cta-callout/types.ts +26 -26
  143. package/src/contentful/blocks/dynamic-tabs/index.tsx +204 -204
  144. package/src/contentful/blocks/dynamic-tabs/types.ts +21 -21
  145. package/src/contentful/blocks/email-input-block/index.tsx +116 -116
  146. package/src/contentful/blocks/email-input-block/types.ts +16 -16
  147. package/src/contentful/blocks/find-kinetic/FindKinetic.stories.tsx +23 -23
  148. package/src/contentful/blocks/find-kinetic/index.tsx +130 -130
  149. package/src/contentful/blocks/find-kinetic/types.ts +19 -19
  150. package/src/contentful/blocks/floating-banner/FloatingBanner.stories.tsx +34 -34
  151. package/src/contentful/blocks/floating-banner/index.tsx +97 -97
  152. package/src/contentful/blocks/floating-banner/types.ts +22 -22
  153. package/src/contentful/blocks/footer/Footer.stories.tsx +317 -317
  154. package/src/contentful/blocks/footer/index.tsx +91 -91
  155. package/src/contentful/blocks/footer/types.ts +13 -13
  156. package/src/contentful/blocks/image-promo-bar/ImagePromoBar.stories.tsx +23 -23
  157. package/src/contentful/blocks/image-promo-bar/helper.tsx +28 -28
  158. package/src/contentful/blocks/image-promo-bar/index.tsx +246 -246
  159. package/src/contentful/blocks/image-promo-bar/types.ts +44 -44
  160. package/src/contentful/blocks/image-promo-bar/vimeo-embed.tsx +93 -93
  161. package/src/contentful/blocks/image-promo-bar/youtube-embed.tsx +46 -46
  162. package/src/contentful/blocks/modal/constants.ts +53 -53
  163. package/src/contentful/blocks/modal/index.tsx +108 -107
  164. package/src/contentful/blocks/modal/types.ts +12 -12
  165. package/src/contentful/blocks/navigation/desktop-link-groups.tsx/index.tsx +139 -139
  166. package/src/contentful/blocks/navigation/index.tsx +568 -568
  167. package/src/contentful/blocks/navigation/mobile-link-groups.tsx/index.tsx +82 -82
  168. package/src/contentful/blocks/navigation/types.ts +71 -71
  169. package/src/contentful/blocks/primary-hero/PrimaryHero.stories.tsx +23 -23
  170. package/src/contentful/blocks/primary-hero/index.tsx +236 -236
  171. package/src/contentful/blocks/primary-hero/types.ts +37 -37
  172. package/src/contentful/blocks/search-block/index.tsx +90 -90
  173. package/src/contentful/blocks/search-block/types.ts +15 -15
  174. package/src/contentful/blocks/shape-background-wrapper/ShapeBackgroundWrapper.stories.tsx +26 -26
  175. package/src/contentful/blocks/shape-background-wrapper/index.tsx +124 -124
  176. package/src/contentful/blocks/shape-background-wrapper/types.ts +36 -36
  177. package/src/contentful/blocks/text/Text.stories.tsx +23 -23
  178. package/src/contentful/blocks/text/index.tsx +12 -12
  179. package/src/contentful/blocks/text/types.ts +1 -1
  180. package/src/contentful/index.ts +105 -105
  181. package/src/hooks/contentful/use-contentful-rich-text.tsx +309 -309
  182. package/src/hooks/contentful/use-processed-check-list.ts +63 -63
  183. package/src/hooks/use-body-scroll-lock.ts +34 -34
  184. package/src/hooks/use-carousel-swipe.ts +264 -264
  185. package/src/hooks/use-outside-click.ts +17 -17
  186. package/src/index.ts +107 -107
  187. package/src/next/index.ts +5 -5
  188. package/src/setupTests.ts +46 -46
  189. package/src/stories/DocsTemplate.tsx +24 -24
  190. package/src/styles/globals.css +343 -343
  191. package/src/types/global.d.ts +9 -9
  192. package/src/types/micro-components.ts +99 -99
  193. package/src/types/utm.ts +49 -49
  194. package/src/utils/contentful/to-document.ts +24 -24
  195. package/src/utils/cookie.ts +84 -84
  196. package/src/utils/cx.ts +49 -49
  197. package/src/utils/index.ts +41 -41
  198. package/src/utils/speed-card-bg.ts +24 -24
  199. package/src/utils/utm.ts +221 -221
@@ -1,335 +1,335 @@
1
- import { Spinner } from "./index";
2
-
3
- import { DocsPage } from "@shared/stories/DocsTemplate";
4
- import type { Meta, StoryObj } from "@storybook/react";
5
-
6
- const meta: Meta<typeof Spinner> = {
7
- title: "Components/Spinner",
8
- component: Spinner,
9
- tags: ["autodocs"],
10
- parameters: {
11
- layout: "centered",
12
- docs: {
13
- page: DocsPage,
14
- description: {
15
- component:
16
- "A loading spinner component with customizable size, color, and animation.",
17
- },
18
- },
19
- },
20
- argTypes: {
21
- size: {
22
- control: { type: "select" },
23
- options: ["small", "medium", "large", "xlarge"],
24
- description: "Spinner size",
25
- },
26
- color: {
27
- control: { type: "color" },
28
- description: "Spinner color",
29
- },
30
- className: {
31
- control: { type: "text" },
32
- description: "Additional CSS classes",
33
- },
34
- },
35
- args: {
36
- size: "medium",
37
- },
38
- };
39
-
40
- export default meta;
41
- type Story = StoryObj<typeof meta>;
42
-
43
- // Default spinner
44
- export const Default: Story = {
45
- args: {},
46
- };
47
-
48
- // Different sizes
49
- export const Sizes: Story = {
50
- render: () => (
51
- <div className="flex items-center gap-8">
52
- <div className="text-center">
53
- <Spinner size="small" />
54
- <p className="mt-2 text-xs">Small</p>
55
- </div>
56
- <div className="text-center">
57
- <Spinner size="medium" />
58
- <p className="mt-2 text-xs">Medium</p>
59
- </div>
60
- <div className="text-center">
61
- <Spinner size="large" />
62
- <p className="mt-2 text-xs">Large</p>
63
- </div>
64
- <div className="text-center">
65
- <Spinner size="xlarge" />
66
- <p className="mt-2 text-xs">XLarge</p>
67
- </div>
68
- </div>
69
- ),
70
- parameters: {
71
- docs: {
72
- description: {
73
- story: "All available spinner sizes.",
74
- },
75
- },
76
- },
77
- };
78
-
79
- // Colored spinners
80
- export const ColoredSpinners: Story = {
81
- render: () => (
82
- <div className="grid grid-cols-4 gap-6">
83
- <div className="text-center">
84
- <Spinner size="large" color="#3b82f6" />
85
- <p className="mt-2 text-sm text-blue-600">Blue</p>
86
- </div>
87
- <div className="text-center">
88
- <Spinner size="large" color="#10b981" />
89
- <p className="mt-2 text-sm text-green-600">Green</p>
90
- </div>
91
- <div className="text-center">
92
- <Spinner size="large" color="#ef4444" />
93
- <p className="mt-2 text-sm text-red-600">Red</p>
94
- </div>
95
- <div className="text-center">
96
- <Spinner size="large" color="#f59e0b" />
97
- <p className="mt-2 text-sm text-yellow-600">Yellow</p>
98
- </div>
99
- </div>
100
- ),
101
- parameters: {
102
- docs: {
103
- description: {
104
- story: "Spinners with different colors.",
105
- },
106
- },
107
- },
108
- };
109
-
110
- // Spinner with text
111
- export const SpinnerWithText: Story = {
112
- render: () => (
113
- <div className="space-y-6">
114
- <div className="flex items-center gap-3">
115
- <Spinner size="small" />
116
- <span className="text-sm text-gray-600">Loading...</span>
117
- </div>
118
- <div className="flex items-center gap-3">
119
- <Spinner size="medium" />
120
- <span className="text-sm text-gray-600">Processing request...</span>
121
- </div>
122
- <div className="flex items-center gap-3">
123
- <Spinner size="large" />
124
- <span className="text-sm text-gray-600">Saving changes...</span>
125
- </div>
126
- </div>
127
- ),
128
- parameters: {
129
- docs: {
130
- description: {
131
- story: "Spinners used alongside loading text.",
132
- },
133
- },
134
- },
135
- };
136
-
137
- // Button with spinner
138
- export const ButtonWithSpinner: Story = {
139
- render: () => (
140
- <div className="space-y-4">
141
- <button className="flex items-center gap-2 rounded bg-blue-600 px-4 py-2 text-white hover:bg-blue-700 disabled:opacity-50">
142
- <Spinner size="small" color="white" />
143
- <span>Loading...</span>
144
- </button>
145
-
146
- <button className="flex items-center gap-2 rounded bg-gray-600 px-4 py-2 text-white hover:bg-gray-700 disabled:opacity-50">
147
- <Spinner size="small" color="white" />
148
- <span>Processing...</span>
149
- </button>
150
-
151
- <button className="flex items-center gap-2 rounded bg-green-600 px-4 py-2 text-white hover:bg-green-700 disabled:opacity-50">
152
- <Spinner size="small" color="white" />
153
- <span>Saving...</span>
154
- </button>
155
- </div>
156
- ),
157
- parameters: {
158
- docs: {
159
- description: {
160
- story: "Spinners integrated into buttons for loading states.",
161
- },
162
- },
163
- },
164
- };
165
-
166
- // Card with spinner
167
- export const CardWithSpinner: Story = {
168
- render: () => (
169
- <div className="grid grid-cols-2 gap-6">
170
- <div className="rounded-lg border p-6">
171
- <div className="flex h-32 items-center justify-center">
172
- <div className="text-center">
173
- <Spinner size="large" />
174
- <p className="mt-3 text-sm text-gray-600">Loading content...</p>
175
- </div>
176
- </div>
177
- </div>
178
-
179
- <div className="rounded-lg border p-6">
180
- <div className="flex h-32 items-center justify-center">
181
- <div className="text-center">
182
- <Spinner size="large" color="#10b981" />
183
- <p className="mt-3 text-sm text-gray-600">Processing data...</p>
184
- </div>
185
- </div>
186
- </div>
187
- </div>
188
- ),
189
- parameters: {
190
- docs: {
191
- description: {
192
- story: "Spinners in card layouts for content loading states.",
193
- },
194
- },
195
- },
196
- };
197
-
198
- // Inline spinner
199
- export const InlineSpinner: Story = {
200
- render: () => (
201
- <div className="space-y-4">
202
- <p className="text-gray-700">
203
- This is some text with an inline{" "}
204
- <Spinner size="small" className="mx-1 inline" /> spinner.
205
- </p>
206
-
207
- <p className="text-gray-700">
208
- Another example with a{" "}
209
- <Spinner size="small" color="#ef4444" className="mx-1 inline" /> colored
210
- spinner.
211
- </p>
212
-
213
- <div className="flex items-center gap-2">
214
- <span>Status:</span>
215
- <Spinner size="small" />
216
- <span className="text-sm text-gray-500">Checking...</span>
217
- </div>
218
- </div>
219
- ),
220
- parameters: {
221
- docs: {
222
- description: {
223
- story: "Inline spinners within text content.",
224
- },
225
- },
226
- },
227
- };
228
-
229
- // Loading states
230
- export const LoadingStates: Story = {
231
- render: () => (
232
- <div className="space-y-6">
233
- <div className="rounded-lg border p-4">
234
- <h3 className="mb-2 font-medium">Initial Loading</h3>
235
- <div className="flex items-center gap-3">
236
- <Spinner size="medium" />
237
- <span className="text-sm text-gray-600">Loading application...</span>
238
- </div>
239
- </div>
240
-
241
- <div className="rounded-lg border p-4">
242
- <h3 className="mb-2 font-medium">Data Fetching</h3>
243
- <div className="flex items-center gap-3">
244
- <Spinner size="medium" color="#3b82f6" />
245
- <span className="text-sm text-gray-600">Fetching user data...</span>
246
- </div>
247
- </div>
248
-
249
- <div className="rounded-lg border p-4">
250
- <h3 className="mb-2 font-medium">Form Submission</h3>
251
- <div className="flex items-center gap-3">
252
- <Spinner size="medium" color="#10b981" />
253
- <span className="text-sm text-gray-600">Submitting form...</span>
254
- </div>
255
- </div>
256
-
257
- <div className="rounded-lg border p-4">
258
- <h3 className="mb-2 font-medium">File Upload</h3>
259
- <div className="flex items-center gap-3">
260
- <Spinner size="medium" color="#f59e0b" />
261
- <span className="text-sm text-gray-600">Uploading file...</span>
262
- </div>
263
- </div>
264
- </div>
265
- ),
266
- parameters: {
267
- docs: {
268
- description: {
269
- story: "Different loading states with appropriate messaging.",
270
- },
271
- },
272
- },
273
- };
274
-
275
- // All variants showcase
276
- export const AllVariants: Story = {
277
- render: () => (
278
- <div className="space-y-8">
279
- <div>
280
- <h3 className="mb-4 text-lg font-semibold">Spinner Sizes</h3>
281
- <div className="flex items-center gap-8">
282
- <div className="text-center">
283
- <Spinner size="small" />
284
- <p className="mt-2 text-xs">Small</p>
285
- </div>
286
- <div className="text-center">
287
- <Spinner size="medium" />
288
- <p className="mt-2 text-xs">Medium</p>
289
- </div>
290
- <div className="text-center">
291
- <Spinner size="large" />
292
- <p className="mt-2 text-xs">Large</p>
293
- </div>
294
- <div className="text-center">
295
- <Spinner size="xlarge" />
296
- <p className="mt-2 text-xs">XLarge</p>
297
- </div>
298
- </div>
299
- </div>
300
-
301
- <div>
302
- <h3 className="mb-4 text-lg font-semibold">Color Variants</h3>
303
- <div className="grid grid-cols-5 gap-4">
304
- <div className="text-center">
305
- <Spinner size="large" color="#3b82f6" />
306
- <p className="mt-2 text-xs text-blue-600">Blue</p>
307
- </div>
308
- <div className="text-center">
309
- <Spinner size="large" color="#10b981" />
310
- <p className="mt-2 text-xs text-green-600">Green</p>
311
- </div>
312
- <div className="text-center">
313
- <Spinner size="large" color="#ef4444" />
314
- <p className="mt-2 text-xs text-red-600">Red</p>
315
- </div>
316
- <div className="text-center">
317
- <Spinner size="large" color="#f59e0b" />
318
- <p className="mt-2 text-xs text-yellow-600">Yellow</p>
319
- </div>
320
- <div className="text-center">
321
- <Spinner size="large" color="#8b5cf6" />
322
- <p className="mt-2 text-xs text-purple-600">Purple</p>
323
- </div>
324
- </div>
325
- </div>
326
- </div>
327
- ),
328
- parameters: {
329
- docs: {
330
- description: {
331
- story: "Complete showcase of all spinner sizes and colors.",
332
- },
333
- },
334
- },
335
- };
1
+ import { Spinner } from "./index";
2
+
3
+ import { DocsPage } from "@shared/stories/DocsTemplate";
4
+ import type { Meta, StoryObj } from "@storybook/react";
5
+
6
+ const meta: Meta<typeof Spinner> = {
7
+ title: "Components/Spinner",
8
+ component: Spinner,
9
+ tags: ["autodocs"],
10
+ parameters: {
11
+ layout: "centered",
12
+ docs: {
13
+ page: DocsPage,
14
+ description: {
15
+ component:
16
+ "A loading spinner component with customizable size, color, and animation.",
17
+ },
18
+ },
19
+ },
20
+ argTypes: {
21
+ size: {
22
+ control: { type: "select" },
23
+ options: ["small", "medium", "large", "xlarge"],
24
+ description: "Spinner size",
25
+ },
26
+ color: {
27
+ control: { type: "color" },
28
+ description: "Spinner color",
29
+ },
30
+ className: {
31
+ control: { type: "text" },
32
+ description: "Additional CSS classes",
33
+ },
34
+ },
35
+ args: {
36
+ size: "medium",
37
+ },
38
+ };
39
+
40
+ export default meta;
41
+ type Story = StoryObj<typeof meta>;
42
+
43
+ // Default spinner
44
+ export const Default: Story = {
45
+ args: {},
46
+ };
47
+
48
+ // Different sizes
49
+ export const Sizes: Story = {
50
+ render: () => (
51
+ <div className="flex items-center gap-8">
52
+ <div className="text-center">
53
+ <Spinner size="small" />
54
+ <p className="mt-2 text-xs">Small</p>
55
+ </div>
56
+ <div className="text-center">
57
+ <Spinner size="medium" />
58
+ <p className="mt-2 text-xs">Medium</p>
59
+ </div>
60
+ <div className="text-center">
61
+ <Spinner size="large" />
62
+ <p className="mt-2 text-xs">Large</p>
63
+ </div>
64
+ <div className="text-center">
65
+ <Spinner size="xlarge" />
66
+ <p className="mt-2 text-xs">XLarge</p>
67
+ </div>
68
+ </div>
69
+ ),
70
+ parameters: {
71
+ docs: {
72
+ description: {
73
+ story: "All available spinner sizes.",
74
+ },
75
+ },
76
+ },
77
+ };
78
+
79
+ // Colored spinners
80
+ export const ColoredSpinners: Story = {
81
+ render: () => (
82
+ <div className="grid grid-cols-4 gap-6">
83
+ <div className="text-center">
84
+ <Spinner size="large" color="#3b82f6" />
85
+ <p className="mt-2 text-sm text-blue-600">Blue</p>
86
+ </div>
87
+ <div className="text-center">
88
+ <Spinner size="large" color="#10b981" />
89
+ <p className="mt-2 text-sm text-green-600">Green</p>
90
+ </div>
91
+ <div className="text-center">
92
+ <Spinner size="large" color="#ef4444" />
93
+ <p className="mt-2 text-sm text-red-600">Red</p>
94
+ </div>
95
+ <div className="text-center">
96
+ <Spinner size="large" color="#f59e0b" />
97
+ <p className="mt-2 text-sm text-yellow-600">Yellow</p>
98
+ </div>
99
+ </div>
100
+ ),
101
+ parameters: {
102
+ docs: {
103
+ description: {
104
+ story: "Spinners with different colors.",
105
+ },
106
+ },
107
+ },
108
+ };
109
+
110
+ // Spinner with text
111
+ export const SpinnerWithText: Story = {
112
+ render: () => (
113
+ <div className="space-y-6">
114
+ <div className="flex items-center gap-3">
115
+ <Spinner size="small" />
116
+ <span className="text-sm text-gray-600">Loading...</span>
117
+ </div>
118
+ <div className="flex items-center gap-3">
119
+ <Spinner size="medium" />
120
+ <span className="text-sm text-gray-600">Processing request...</span>
121
+ </div>
122
+ <div className="flex items-center gap-3">
123
+ <Spinner size="large" />
124
+ <span className="text-sm text-gray-600">Saving changes...</span>
125
+ </div>
126
+ </div>
127
+ ),
128
+ parameters: {
129
+ docs: {
130
+ description: {
131
+ story: "Spinners used alongside loading text.",
132
+ },
133
+ },
134
+ },
135
+ };
136
+
137
+ // Button with spinner
138
+ export const ButtonWithSpinner: Story = {
139
+ render: () => (
140
+ <div className="space-y-4">
141
+ <button className="flex items-center gap-2 rounded bg-blue-600 px-4 py-2 text-white hover:bg-blue-700 disabled:opacity-50">
142
+ <Spinner size="small" color="white" />
143
+ <span>Loading...</span>
144
+ </button>
145
+
146
+ <button className="flex items-center gap-2 rounded bg-gray-600 px-4 py-2 text-white hover:bg-gray-700 disabled:opacity-50">
147
+ <Spinner size="small" color="white" />
148
+ <span>Processing...</span>
149
+ </button>
150
+
151
+ <button className="flex items-center gap-2 rounded bg-green-600 px-4 py-2 text-white hover:bg-green-700 disabled:opacity-50">
152
+ <Spinner size="small" color="white" />
153
+ <span>Saving...</span>
154
+ </button>
155
+ </div>
156
+ ),
157
+ parameters: {
158
+ docs: {
159
+ description: {
160
+ story: "Spinners integrated into buttons for loading states.",
161
+ },
162
+ },
163
+ },
164
+ };
165
+
166
+ // Card with spinner
167
+ export const CardWithSpinner: Story = {
168
+ render: () => (
169
+ <div className="grid grid-cols-2 gap-6">
170
+ <div className="rounded-lg border p-6">
171
+ <div className="flex h-32 items-center justify-center">
172
+ <div className="text-center">
173
+ <Spinner size="large" />
174
+ <p className="mt-3 text-sm text-gray-600">Loading content...</p>
175
+ </div>
176
+ </div>
177
+ </div>
178
+
179
+ <div className="rounded-lg border p-6">
180
+ <div className="flex h-32 items-center justify-center">
181
+ <div className="text-center">
182
+ <Spinner size="large" color="#10b981" />
183
+ <p className="mt-3 text-sm text-gray-600">Processing data...</p>
184
+ </div>
185
+ </div>
186
+ </div>
187
+ </div>
188
+ ),
189
+ parameters: {
190
+ docs: {
191
+ description: {
192
+ story: "Spinners in card layouts for content loading states.",
193
+ },
194
+ },
195
+ },
196
+ };
197
+
198
+ // Inline spinner
199
+ export const InlineSpinner: Story = {
200
+ render: () => (
201
+ <div className="space-y-4">
202
+ <p className="text-gray-700">
203
+ This is some text with an inline{" "}
204
+ <Spinner size="small" className="mx-1 inline" /> spinner.
205
+ </p>
206
+
207
+ <p className="text-gray-700">
208
+ Another example with a{" "}
209
+ <Spinner size="small" color="#ef4444" className="mx-1 inline" /> colored
210
+ spinner.
211
+ </p>
212
+
213
+ <div className="flex items-center gap-2">
214
+ <span>Status:</span>
215
+ <Spinner size="small" />
216
+ <span className="text-sm text-gray-500">Checking...</span>
217
+ </div>
218
+ </div>
219
+ ),
220
+ parameters: {
221
+ docs: {
222
+ description: {
223
+ story: "Inline spinners within text content.",
224
+ },
225
+ },
226
+ },
227
+ };
228
+
229
+ // Loading states
230
+ export const LoadingStates: Story = {
231
+ render: () => (
232
+ <div className="space-y-6">
233
+ <div className="rounded-lg border p-4">
234
+ <h3 className="mb-2 font-medium">Initial Loading</h3>
235
+ <div className="flex items-center gap-3">
236
+ <Spinner size="medium" />
237
+ <span className="text-sm text-gray-600">Loading application...</span>
238
+ </div>
239
+ </div>
240
+
241
+ <div className="rounded-lg border p-4">
242
+ <h3 className="mb-2 font-medium">Data Fetching</h3>
243
+ <div className="flex items-center gap-3">
244
+ <Spinner size="medium" color="#3b82f6" />
245
+ <span className="text-sm text-gray-600">Fetching user data...</span>
246
+ </div>
247
+ </div>
248
+
249
+ <div className="rounded-lg border p-4">
250
+ <h3 className="mb-2 font-medium">Form Submission</h3>
251
+ <div className="flex items-center gap-3">
252
+ <Spinner size="medium" color="#10b981" />
253
+ <span className="text-sm text-gray-600">Submitting form...</span>
254
+ </div>
255
+ </div>
256
+
257
+ <div className="rounded-lg border p-4">
258
+ <h3 className="mb-2 font-medium">File Upload</h3>
259
+ <div className="flex items-center gap-3">
260
+ <Spinner size="medium" color="#f59e0b" />
261
+ <span className="text-sm text-gray-600">Uploading file...</span>
262
+ </div>
263
+ </div>
264
+ </div>
265
+ ),
266
+ parameters: {
267
+ docs: {
268
+ description: {
269
+ story: "Different loading states with appropriate messaging.",
270
+ },
271
+ },
272
+ },
273
+ };
274
+
275
+ // All variants showcase
276
+ export const AllVariants: Story = {
277
+ render: () => (
278
+ <div className="space-y-8">
279
+ <div>
280
+ <h3 className="mb-4 text-lg font-semibold">Spinner Sizes</h3>
281
+ <div className="flex items-center gap-8">
282
+ <div className="text-center">
283
+ <Spinner size="small" />
284
+ <p className="mt-2 text-xs">Small</p>
285
+ </div>
286
+ <div className="text-center">
287
+ <Spinner size="medium" />
288
+ <p className="mt-2 text-xs">Medium</p>
289
+ </div>
290
+ <div className="text-center">
291
+ <Spinner size="large" />
292
+ <p className="mt-2 text-xs">Large</p>
293
+ </div>
294
+ <div className="text-center">
295
+ <Spinner size="xlarge" />
296
+ <p className="mt-2 text-xs">XLarge</p>
297
+ </div>
298
+ </div>
299
+ </div>
300
+
301
+ <div>
302
+ <h3 className="mb-4 text-lg font-semibold">Color Variants</h3>
303
+ <div className="grid grid-cols-5 gap-4">
304
+ <div className="text-center">
305
+ <Spinner size="large" color="#3b82f6" />
306
+ <p className="mt-2 text-xs text-blue-600">Blue</p>
307
+ </div>
308
+ <div className="text-center">
309
+ <Spinner size="large" color="#10b981" />
310
+ <p className="mt-2 text-xs text-green-600">Green</p>
311
+ </div>
312
+ <div className="text-center">
313
+ <Spinner size="large" color="#ef4444" />
314
+ <p className="mt-2 text-xs text-red-600">Red</p>
315
+ </div>
316
+ <div className="text-center">
317
+ <Spinner size="large" color="#f59e0b" />
318
+ <p className="mt-2 text-xs text-yellow-600">Yellow</p>
319
+ </div>
320
+ <div className="text-center">
321
+ <Spinner size="large" color="#8b5cf6" />
322
+ <p className="mt-2 text-xs text-purple-600">Purple</p>
323
+ </div>
324
+ </div>
325
+ </div>
326
+ </div>
327
+ ),
328
+ parameters: {
329
+ docs: {
330
+ description: {
331
+ story: "Complete showcase of all spinner sizes and colors.",
332
+ },
333
+ },
334
+ },
335
+ };