@cl-light-ds/ui 0.2.0 → 0.4.0

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 (293) hide show
  1. package/README.md +45 -45
  2. package/package.json +2 -2
  3. package/src/components/accordion/Accordion.astro +248 -248
  4. package/src/components/accordion/AccordionContent.astro +26 -26
  5. package/src/components/accordion/AccordionItem.astro +36 -36
  6. package/src/components/accordion/AccordionTrigger.astro +118 -118
  7. package/src/components/accordion/CHANGELOG.md +41 -41
  8. package/src/components/accordion/index.ts +4 -4
  9. package/src/components/alert/Alert.astro +167 -167
  10. package/src/components/alert/AlertDescription.astro +24 -24
  11. package/src/components/alert/AlertTitle.astro +24 -24
  12. package/src/components/alert/CHANGELOG.md +5 -5
  13. package/src/components/alert/index.ts +4 -4
  14. package/src/components/avatar/Avatar.astro +197 -197
  15. package/src/components/avatar/AvatarBadge.astro +44 -44
  16. package/src/components/avatar/AvatarFallback.astro +26 -26
  17. package/src/components/avatar/AvatarGroup.astro +26 -26
  18. package/src/components/avatar/AvatarGroupCount.astro +30 -30
  19. package/src/components/avatar/AvatarImage.astro +46 -46
  20. package/src/components/avatar/CHANGELOG.md +44 -44
  21. package/src/components/avatar/index.ts +6 -6
  22. package/src/components/badge/Badge.astro +167 -167
  23. package/src/components/badge/CHANGELOG.md +49 -49
  24. package/src/components/badge/index.ts +2 -2
  25. package/src/components/breadcrumb/Breadcrumb.astro +76 -76
  26. package/src/components/breadcrumb/BreadcrumbItem.astro +32 -32
  27. package/src/components/breadcrumb/BreadcrumbList.astro +26 -26
  28. package/src/components/breadcrumb/BreadcrumbSeparator.astro +26 -26
  29. package/src/components/breadcrumb/CHANGELOG.md +24 -24
  30. package/src/components/breadcrumb/index.ts +5 -5
  31. package/src/components/button/Button.astro +233 -233
  32. package/src/components/button/CHANGELOG.md +41 -41
  33. package/src/components/button/index.ts +2 -2
  34. package/src/components/button-group/ButtonGroup.astro +130 -130
  35. package/src/components/button-group/ButtonGroupSeparator.astro +30 -30
  36. package/src/components/button-group/ButtonGroupText.astro +21 -21
  37. package/src/components/button-group/CHANGELOG.md +34 -34
  38. package/src/components/button-group/index.ts +3 -3
  39. package/src/components/callout/CHANGELOG.md +32 -0
  40. package/src/components/callout/Callout.astro +147 -0
  41. package/src/components/callout/CalloutDescription.astro +16 -0
  42. package/src/components/callout/CalloutTitle.astro +16 -0
  43. package/src/components/callout/index.ts +3 -0
  44. package/src/components/card/CHANGELOG.md +162 -119
  45. package/src/components/card/Card.astro +197 -182
  46. package/src/components/card/CardAction.astro +26 -26
  47. package/src/components/card/CardContent.astro +28 -28
  48. package/src/components/card/CardDescription.astro +28 -28
  49. package/src/components/card/CardFooter.astro +24 -24
  50. package/src/components/card/CardHeader.astro +30 -30
  51. package/src/components/card/CardMedia.astro +27 -27
  52. package/src/components/card/CardMediaActions.astro +21 -0
  53. package/src/components/card/CardMediaSelect.astro +21 -0
  54. package/src/components/card/CardOverlay.astro +32 -32
  55. package/src/components/card/CardTitle.astro +21 -21
  56. package/src/components/card/index.ts +12 -10
  57. package/src/components/carousel/CHANGELOG.md +5 -5
  58. package/src/components/carousel/Carousel.astro +106 -106
  59. package/src/components/carousel/CarouselSlide.astro +22 -22
  60. package/src/components/carousel/index.ts +3 -3
  61. package/src/components/checkbox/CHANGELOG.md +58 -58
  62. package/src/components/checkbox/Checkbox.astro +159 -159
  63. package/src/components/checkbox/index.ts +1 -1
  64. package/src/components/collapsible/CHANGELOG.md +5 -5
  65. package/src/components/collapsible/Collapsible.astro +202 -202
  66. package/src/components/collapsible/CollapsibleContent.astro +36 -36
  67. package/src/components/collapsible/CollapsibleTrigger.astro +34 -34
  68. package/src/components/collapsible/index.ts +4 -4
  69. package/src/components/combobox/CHANGELOG.md +27 -27
  70. package/src/components/combobox/Combobox.astro +365 -365
  71. package/src/components/combobox/ComboboxContent.astro +37 -37
  72. package/src/components/combobox/ComboboxEmpty.astro +18 -18
  73. package/src/components/combobox/ComboboxGroup.astro +19 -19
  74. package/src/components/combobox/ComboboxInput.astro +74 -74
  75. package/src/components/combobox/ComboboxItem.astro +39 -39
  76. package/src/components/combobox/ComboboxLabel.astro +18 -18
  77. package/src/components/combobox/ComboboxList.astro +21 -21
  78. package/src/components/combobox/ComboboxSeparator.astro +17 -17
  79. package/src/components/combobox/ComboboxTrigger.astro +30 -30
  80. package/src/components/combobox/ComboboxValue.astro +22 -22
  81. package/src/components/combobox/index.ts +11 -11
  82. package/src/components/date/CHANGELOG.md +18 -18
  83. package/src/components/date/Date.astro +137 -137
  84. package/src/components/date/index.ts +2 -2
  85. package/src/components/dialog/CHANGELOG.md +39 -39
  86. package/src/components/dialog/Dialog.astro +196 -196
  87. package/src/components/dialog/DialogClose.astro +23 -23
  88. package/src/components/dialog/DialogContent.astro +42 -42
  89. package/src/components/dialog/DialogDescription.astro +18 -18
  90. package/src/components/dialog/DialogFooter.astro +18 -18
  91. package/src/components/dialog/DialogHeader.astro +18 -18
  92. package/src/components/dialog/DialogOverlay.astro +19 -19
  93. package/src/components/dialog/DialogTitle.astro +18 -18
  94. package/src/components/dialog/DialogTrigger.astro +37 -37
  95. package/src/components/dialog/index.ts +9 -9
  96. package/src/components/dropdown-menu/CHANGELOG.md +194 -194
  97. package/src/components/dropdown-menu/DropdownMenu.astro +226 -226
  98. package/src/components/dropdown-menu/DropdownMenuCheckboxItem.astro +114 -114
  99. package/src/components/dropdown-menu/DropdownMenuContent.astro +42 -42
  100. package/src/components/dropdown-menu/DropdownMenuGroup.astro +19 -19
  101. package/src/components/dropdown-menu/DropdownMenuItem.astro +220 -220
  102. package/src/components/dropdown-menu/DropdownMenuItemContent.astro +79 -79
  103. package/src/components/dropdown-menu/DropdownMenuLabel.astro +20 -20
  104. package/src/components/dropdown-menu/DropdownMenuPortal.astro +13 -13
  105. package/src/components/dropdown-menu/DropdownMenuRadioGroup.astro +13 -13
  106. package/src/components/dropdown-menu/DropdownMenuRadioItem.astro +101 -101
  107. package/src/components/dropdown-menu/DropdownMenuSeparator.astro +18 -18
  108. package/src/components/dropdown-menu/DropdownMenuShortcut.astro +18 -18
  109. package/src/components/dropdown-menu/DropdownMenuTrigger.astro +49 -49
  110. package/src/components/dropdown-menu/dropdown-menu-item-variants.ts +24 -24
  111. package/src/components/dropdown-menu/index.ts +12 -12
  112. package/src/components/field/CHANGELOG.md +33 -33
  113. package/src/components/field/Field.astro +664 -664
  114. package/src/components/field/FieldContent.astro +20 -20
  115. package/src/components/field/FieldDescription.astro +22 -22
  116. package/src/components/field/FieldError.astro +51 -51
  117. package/src/components/field/FieldGroup.astro +20 -20
  118. package/src/components/field/FieldLabel.astro +22 -22
  119. package/src/components/field/FieldLegend.astro +23 -23
  120. package/src/components/field/FieldSeparator.astro +30 -30
  121. package/src/components/field/FieldSet.astro +20 -20
  122. package/src/components/field/FieldTitle.astro +20 -20
  123. package/src/components/field/index.ts +10 -10
  124. package/src/components/hover-card/CHANGELOG.md +20 -20
  125. package/src/components/hover-card/HoverCard.astro +235 -235
  126. package/src/components/hover-card/HoverCardContent.astro +54 -54
  127. package/src/components/hover-card/HoverCardTrigger.astro +38 -38
  128. package/src/components/hover-card/index.ts +3 -3
  129. package/src/components/input/CHANGELOG.md +44 -29
  130. package/src/components/input/Input.astro +130 -130
  131. package/src/components/input/InputOTP.astro +211 -0
  132. package/src/components/input/index.ts +2 -2
  133. package/src/components/input-group/CHANGELOG.md +49 -49
  134. package/src/components/input-group/InputGroup.astro +135 -135
  135. package/src/components/input-group/InputGroupAddon.astro +49 -49
  136. package/src/components/input-group/InputGroupButton.astro +58 -58
  137. package/src/components/input-group/InputGroupInput.astro +18 -18
  138. package/src/components/input-group/InputGroupText.astro +21 -21
  139. package/src/components/input-group/InputGroupTextarea.astro +17 -17
  140. package/src/components/input-group/controlClasses.ts +2 -2
  141. package/src/components/input-group/index.ts +6 -6
  142. package/src/components/item/CHANGELOG.md +27 -27
  143. package/src/components/item/Item.astro +122 -122
  144. package/src/components/item/ItemActions.astro +21 -21
  145. package/src/components/item/ItemContent.astro +25 -25
  146. package/src/components/item/ItemDescription.astro +25 -25
  147. package/src/components/item/ItemFooter.astro +24 -24
  148. package/src/components/item/ItemGroup.astro +24 -24
  149. package/src/components/item/ItemHeader.astro +24 -24
  150. package/src/components/item/ItemMedia.astro +47 -47
  151. package/src/components/item/ItemSeparator.astro +21 -21
  152. package/src/components/item/ItemTitle.astro +25 -25
  153. package/src/components/item/index.ts +10 -10
  154. package/src/components/kbd/CHANGELOG.md +5 -5
  155. package/src/components/kbd/Kbd.astro +145 -145
  156. package/src/components/kbd/KbdGroup.astro +55 -55
  157. package/src/components/kbd/index.ts +2 -2
  158. package/src/components/label/CHANGELOG.md +28 -28
  159. package/src/components/label/Label.astro +97 -97
  160. package/src/components/label/index.ts +2 -2
  161. package/src/components/link-group/CHANGELOG.md +75 -75
  162. package/src/components/link-group/LinkGroup.astro +67 -67
  163. package/src/components/link-group/LinkGroupItem.astro +32 -32
  164. package/src/components/link-group/LinkGroupList.astro +25 -25
  165. package/src/components/link-group/LinkGroupTitle.astro +22 -22
  166. package/src/components/link-group/index.ts +5 -5
  167. package/src/components/link-group/link-group-list-variants.ts +15 -15
  168. package/src/components/logo/CHANGELOG.md +17 -0
  169. package/src/components/logo/Logo.astro +90 -0
  170. package/src/components/logo/index.ts +3 -0
  171. package/src/components/logo/logo-paths.ts +57 -0
  172. package/src/components/marquee/CHANGELOG.md +5 -5
  173. package/src/components/marquee/Marquee.astro +119 -119
  174. package/src/components/marquee/index.ts +2 -2
  175. package/src/components/native-select/CHANGELOG.md +5 -5
  176. package/src/components/native-select/NativeSelect.astro +125 -125
  177. package/src/components/native-select/NativeSelectOptGroup.astro +14 -14
  178. package/src/components/native-select/NativeSelectOption.astro +9 -9
  179. package/src/components/native-select/index.ts +3 -3
  180. package/src/components/navigation-menu/CHANGELOG.md +63 -63
  181. package/src/components/navigation-menu/NavigationMenu.astro +414 -414
  182. package/src/components/navigation-menu/NavigationMenuContent.astro +37 -37
  183. package/src/components/navigation-menu/NavigationMenuIndicator.astro +24 -24
  184. package/src/components/navigation-menu/NavigationMenuItem.astro +22 -22
  185. package/src/components/navigation-menu/NavigationMenuLink.astro +18 -18
  186. package/src/components/navigation-menu/NavigationMenuList.astro +21 -21
  187. package/src/components/navigation-menu/NavigationMenuPositioner.astro +44 -44
  188. package/src/components/navigation-menu/NavigationMenuTrigger.astro +30 -30
  189. package/src/components/navigation-menu/NavigationMenuViewport.astro +19 -19
  190. package/src/components/navigation-menu/index.ts +10 -10
  191. package/src/components/organisms/lightning-sidebar-nav/CHANGELOG.md +50 -0
  192. package/src/components/organisms/lightning-sidebar-nav/LightningSidebarNav.astro +176 -0
  193. package/src/components/organisms/lightning-sidebar-nav/SidebarNav.astro +50 -0
  194. package/src/components/organisms/lightning-sidebar-nav/SidebarNavGroup.astro +74 -0
  195. package/src/components/organisms/lightning-sidebar-nav/SidebarNavItem.astro +94 -0
  196. package/src/components/organisms/lightning-sidebar-nav/SidebarNavProBadge.astro +26 -0
  197. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSection.astro +71 -0
  198. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSkeleton.astro +67 -0
  199. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSubItem.astro +69 -0
  200. package/src/components/organisms/lightning-sidebar-nav/SidebarNavUsage.astro +78 -0
  201. package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceAvatar.astro +46 -0
  202. package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceSwitcher.astro +130 -0
  203. package/src/components/organisms/lightning-sidebar-nav/icons.ts +46 -0
  204. package/src/components/organisms/lightning-sidebar-nav/index.ts +18 -0
  205. package/src/components/organisms/lightning-sidebar-nav/types.ts +77 -0
  206. package/src/components/popover/CHANGELOG.md +20 -20
  207. package/src/components/popover/Popover.astro +211 -211
  208. package/src/components/popover/PopoverClose.astro +18 -18
  209. package/src/components/popover/PopoverContent.astro +50 -50
  210. package/src/components/popover/PopoverDescription.astro +18 -18
  211. package/src/components/popover/PopoverHeader.astro +18 -18
  212. package/src/components/popover/PopoverTitle.astro +18 -18
  213. package/src/components/popover/PopoverTrigger.astro +35 -35
  214. package/src/components/popover/index.ts +7 -7
  215. package/src/components/radio-group/CHANGELOG.md +31 -31
  216. package/src/components/radio-group/RadioGroup.astro +81 -81
  217. package/src/components/radio-group/RadioGroupItem.astro +51 -51
  218. package/src/components/radio-group/index.ts +3 -3
  219. package/src/components/select/CHANGELOG.md +39 -39
  220. package/src/components/select/Select.astro +373 -373
  221. package/src/components/select/SelectContent.astro +91 -91
  222. package/src/components/select/SelectGroup.astro +19 -19
  223. package/src/components/select/SelectItem.astro +48 -48
  224. package/src/components/select/SelectLabel.astro +18 -18
  225. package/src/components/select/SelectSeparator.astro +17 -17
  226. package/src/components/select/SelectTrigger.astro +34 -34
  227. package/src/components/select/SelectValue.astro +22 -22
  228. package/src/components/select/index.ts +8 -8
  229. package/src/components/separator/CHANGELOG.md +5 -5
  230. package/src/components/separator/Separator.astro +60 -60
  231. package/src/components/separator/index.ts +2 -2
  232. package/src/components/skeleton/CHANGELOG.md +5 -5
  233. package/src/components/skeleton/Skeleton.astro +121 -121
  234. package/src/components/skeleton/index.ts +1 -1
  235. package/src/components/slider/CHANGELOG.md +5 -5
  236. package/src/components/slider/Slider.astro +198 -198
  237. package/src/components/slider/index.ts +1 -1
  238. package/src/components/spinner/CHANGELOG.md +18 -18
  239. package/src/components/spinner/Spinner.astro +135 -135
  240. package/src/components/spinner/index.ts +1 -1
  241. package/src/components/sticky-surface/CHANGELOG.md +5 -5
  242. package/src/components/sticky-surface/StickySurface.astro +152 -152
  243. package/src/components/sticky-surface/index.ts +2 -2
  244. package/src/components/switch/CHANGELOG.md +29 -29
  245. package/src/components/switch/Switch.astro +106 -106
  246. package/src/components/switch/index.ts +1 -1
  247. package/src/components/table/CHANGELOG.md +24 -24
  248. package/src/components/table/Table.astro +358 -251
  249. package/src/components/table/TableBody.astro +17 -18
  250. package/src/components/table/TableBulkToolbar.astro +37 -0
  251. package/src/components/table/TableCaption.astro +17 -17
  252. package/src/components/table/TableCell.astro +45 -21
  253. package/src/components/table/TableCellText.astro +17 -0
  254. package/src/components/table/TableColumnMenu.astro +50 -0
  255. package/src/components/table/TableEditableCell.astro +287 -0
  256. package/src/components/table/TableEmpty.astro +17 -0
  257. package/src/components/table/TableFolderCell.astro +38 -0
  258. package/src/components/table/TableFooter.astro +21 -21
  259. package/src/components/table/TableHead.astro +90 -21
  260. package/src/components/table/TableHeader.astro +17 -17
  261. package/src/components/table/TablePagination.astro +57 -0
  262. package/src/components/table/TableRow.astro +52 -21
  263. package/src/components/table/TableSelectAllBanner.astro +34 -0
  264. package/src/components/table/TableSelectCell.astro +50 -0
  265. package/src/components/table/TableSkeletonRow.astro +21 -0
  266. package/src/components/table/index.ts +19 -9
  267. package/src/components/table/table-cell-variants.ts +29 -0
  268. package/src/components/tabs/CHANGELOG.md +5 -5
  269. package/src/components/tabs/Tabs.astro +306 -306
  270. package/src/components/tabs/TabsContent.astro +47 -47
  271. package/src/components/tabs/TabsList.astro +69 -69
  272. package/src/components/tabs/TabsTrigger.astro +40 -40
  273. package/src/components/tabs/index.ts +6 -6
  274. package/src/components/textarea/CHANGELOG.md +22 -22
  275. package/src/components/textarea/Textarea.astro +58 -58
  276. package/src/components/textarea/index.ts +2 -2
  277. package/src/components/toggle/CHANGELOG.md +23 -23
  278. package/src/components/toggle/Toggle.astro +150 -150
  279. package/src/components/toggle/index.ts +1 -1
  280. package/src/components/toggle-group/CHANGELOG.md +18 -18
  281. package/src/components/toggle-group/ToggleGroup.astro +236 -236
  282. package/src/components/toggle-group/ToggleGroupItem.astro +48 -48
  283. package/src/components/toggle-group/index.ts +2 -2
  284. package/src/components/tooltip/CHANGELOG.md +22 -22
  285. package/src/components/tooltip/Tooltip.astro +357 -357
  286. package/src/components/tooltip/TooltipContent.astro +85 -85
  287. package/src/components/tooltip/TooltipTrigger.astro +34 -34
  288. package/src/components/tooltip/index.ts +3 -3
  289. package/src/lib/table-controller.ts +1090 -0
  290. package/src/lib/toggle-group-controller.ts +113 -113
  291. package/src/lib/toggle-shared.ts +27 -27
  292. package/src/lib/utils.ts +6 -6
  293. package/src/styles/globals.css +209 -177
@@ -1 +1 @@
1
- export { default as Slider } from "./Slider.astro";
1
+ export { default as Slider } from "./Slider.astro";
@@ -1,18 +1,18 @@
1
- # Changelog
2
-
3
- All notable changes to the `Spinner` component will be documented in this file.
4
-
5
- ## 2026-09-18 — Figma alignment (ClickLearn Lightning Design Library, node `5455-18523`)
6
-
7
- Figma documents Spinner as four discrete sizes: Extra Small (12px), Small (16px), Medium (24px), Large (32px) — all rendered in a consistent primary-blue color.
8
-
9
- ### Fixed
10
-
11
- - Added the missing `@figmaUrl`.
12
- - Default color: added `text-primary` so the spinner's `stroke="currentColor"` resolves to primary blue (`#3785e0`, confirmed against Figma) by default, matching every size shown in Figma — previously it had no default color at all and just inherited whatever ambient text color happened to be in scope.
13
- - Fixed a real regression that default color change caused: the storybook's own "Badge" example nests a bare `<Spinner data-icon />` inside the default (solid primary-blue) `Badge` variant — with the new default, the spinner became invisible (blue icon on blue background). Fixed by explicitly overriding it to `class="text-primary-foreground"` in that one case (both in the storybook page and the identical demo duplicated in `Spinner.astro`'s own JSDoc), matching the badge's own foreground token. All other compositions (outline/secondary badges, disabled buttons — which force `bg-muted` regardless of variant, so never collide with primary blue) were unaffected.
14
-
15
- ### Notes
16
-
17
- - No new `size` prop added — the existing "use a `size-*` utility class" pattern already produces Figma's exact four sizes (`size-3`/`size-4`/`size-6`/`size-8` = 12/16/24/32px), confirmed already documented in the component's own JSDoc and storybook page. Relabeled the storybook "Size" demo with Figma's own names (Extra Small/Small/Medium/Large) for clarity.
18
- - Stroke width and animation were already correct — no Figma evidence suggested otherwise.
1
+ # Changelog
2
+
3
+ All notable changes to the `Spinner` component will be documented in this file.
4
+
5
+ ## 2026-09-18 — Figma alignment (ClickLearn Lightning Design Library, node `5455-18523`)
6
+
7
+ Figma documents Spinner as four discrete sizes: Extra Small (12px), Small (16px), Medium (24px), Large (32px) — all rendered in a consistent primary-blue color.
8
+
9
+ ### Fixed
10
+
11
+ - Added the missing `@figmaUrl`.
12
+ - Default color: added `text-primary` so the spinner's `stroke="currentColor"` resolves to primary blue (`#3785e0`, confirmed against Figma) by default, matching every size shown in Figma — previously it had no default color at all and just inherited whatever ambient text color happened to be in scope.
13
+ - Fixed a real regression that default color change caused: the storybook's own "Badge" example nests a bare `<Spinner data-icon />` inside the default (solid primary-blue) `Badge` variant — with the new default, the spinner became invisible (blue icon on blue background). Fixed by explicitly overriding it to `class="text-primary-foreground"` in that one case (both in the storybook page and the identical demo duplicated in `Spinner.astro`'s own JSDoc), matching the badge's own foreground token. All other compositions (outline/secondary badges, disabled buttons — which force `bg-muted` regardless of variant, so never collide with primary blue) were unaffected.
14
+
15
+ ### Notes
16
+
17
+ - No new `size` prop added — the existing "use a `size-*` utility class" pattern already produces Figma's exact four sizes (`size-3`/`size-4`/`size-6`/`size-8` = 12/16/24/32px), confirmed already documented in the component's own JSDoc and storybook page. Relabeled the storybook "Size" demo with Figma's own names (Extra Small/Small/Medium/Large) for clarity.
18
+ - Stroke width and animation were already correct — no Figma evidence suggested otherwise.
@@ -1,135 +1,135 @@
1
- ---
2
- /**
3
- * @component Spinner
4
- * @title Spinner
5
- * @description A loading indicator component that displays an animated spinning icon.
6
- * @figmaUrl https://www.figma.com/design/qXkzdqZ3QPQqgckU3AwIAH/ClickLearn-Lightning-Design-Library?node-id=5455-18523
7
- *
8
- * @preview
9
- *
10
- * <Item variant="muted" class="w-full max-w-xs">
11
- * <ItemMedia>
12
- * <Spinner />
13
- * </ItemMedia>
14
- * <ItemContent>
15
- * <ItemTitle class="line-clamp-1">Submitting Contact Form...</ItemTitle>
16
- * </ItemContent>
17
- * </Item>
18
- *
19
- * @usage
20
- *
21
- * ```astro nocollapse
22
- * ---
23
- * import { Spinner } from '@bejamas/ui/components/spinner';
24
- * ---
25
- *
26
- * <Spinner />
27
- * ```
28
- *
29
- * ## Customization
30
- *
31
- * You can replace the default spinner icon with any other icon by editing the `Spinner` component.
32
- *
33
- * ```astro showLineNumbers title="components/ui/spinner/Spinner.astro" nocollapse nopreview
34
- * ---
35
- * import { cn } from "@cl-light-ds/ui/lib/utils";
36
- * import { Loader as LoaderIcon } from "@lucide/astro";
37
- *
38
- * const { class: className = "", ...props } = Astro.props;
39
- * ---
40
- *
41
- * <LoaderIcon
42
- * data-slot="spinner"
43
- * role="status"
44
- * aria-label="Loading"
45
- * class={cn("cn-spinner", "size-4 animate-spin", className)}
46
- * {...props}
47
- * />
48
- * ```
49
- *
50
- * @examples
51
- *
52
- * ### Size
53
- *
54
- * Use the `size-*` utility class to change the size of the spinner.
55
- *
56
- * <div class="flex items-center gap-6">
57
- * <Spinner class="size-3" />
58
- * <Spinner class="size-4" />
59
- * <Spinner class="size-6" />
60
- * <Spinner class="size-8" />
61
- * </div>
62
- *
63
- * ### Button
64
- *
65
- * Add a spinner to a button to indicate a loading state. Remember to use the `data-icon` attribute for proper spacing.
66
- *
67
- * <div class="flex flex-col items-center gap-4">
68
- * <Button disabled size="sm">
69
- * <Spinner data-icon />
70
- * Loading...
71
- * </Button>
72
- * <Button variant="outline" disabled size="sm">
73
- * <Spinner data-icon />
74
- * Please wait
75
- * </Button>
76
- * <Button variant="secondary" disabled size="sm">
77
- * <Spinner data-icon />
78
- * Processing
79
- * </Button>
80
- * </div>
81
- *
82
- * ### Badge
83
- *
84
- * Add a spinner to a badge to indicate a loading state.
85
- *
86
- * <div class="flex items-center gap-4 [--radius:1.2rem]">
87
- * <Badge>
88
- * <Spinner data-icon class="text-primary-foreground" />
89
- * Syncing
90
- * </Badge>
91
- * <Badge variant="secondary">
92
- * <Spinner data-icon />
93
- * Updating
94
- * </Badge>
95
- * <Badge variant="outline">
96
- * <Spinner data-icon />
97
- * Processing
98
- * </Badge>
99
- * </div>
100
- *
101
- * ### Input Group
102
- *
103
- * <div class="flex w-full max-w-md flex-col gap-4">
104
- * <InputGroup>
105
- * <InputGroupInput placeholder="Send a message..." disabled />
106
- * <InputGroupAddon align="inline-end">
107
- * <Spinner />
108
- * </InputGroupAddon>
109
- * </InputGroup>
110
- * <InputGroup>
111
- * <InputGroupTextarea placeholder="Send a message..." disabled />
112
- * <InputGroupAddon align="block-end">
113
- * <Spinner /> Validating...
114
- * <InputGroupButton class="ml-auto" variant="default">
115
- * <ArrowUpIcon />
116
- * <span class="sr-only">Send</span>
117
- * </InputGroupButton>
118
- * </InputGroupAddon>
119
- * </InputGroup>
120
- * </div>
121
- *
122
- * @props
123
- * - class?: string — Additional classes for styling (e.g., size-3, size-6).
124
- */
125
-
126
- import { cn } from "@cl-light-ds/ui/lib/utils";
127
-
128
- const { class: className = "", ...props } = Astro.props;
129
- ---
130
-
131
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" data-slot="spinner"
132
- role="status"
133
- aria-label="Loading"
134
- class={cn("text-primary", "size-4 animate-spin", className)}
135
- {...props}><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12a9 9 0 1 1-6.219-8.56"/></svg>
1
+ ---
2
+ /**
3
+ * @component Spinner
4
+ * @title Spinner
5
+ * @description A loading indicator component that displays an animated spinning icon.
6
+ * @figmaUrl https://www.figma.com/design/qXkzdqZ3QPQqgckU3AwIAH/ClickLearn-Lightning-Design-Library?node-id=5455-18523
7
+ *
8
+ * @preview
9
+ *
10
+ * <Item variant="muted" class="w-full max-w-xs">
11
+ * <ItemMedia>
12
+ * <Spinner />
13
+ * </ItemMedia>
14
+ * <ItemContent>
15
+ * <ItemTitle class="line-clamp-1">Submitting Contact Form...</ItemTitle>
16
+ * </ItemContent>
17
+ * </Item>
18
+ *
19
+ * @usage
20
+ *
21
+ * ```astro nocollapse
22
+ * ---
23
+ * import { Spinner } from '@bejamas/ui/components/spinner';
24
+ * ---
25
+ *
26
+ * <Spinner />
27
+ * ```
28
+ *
29
+ * ## Customization
30
+ *
31
+ * You can replace the default spinner icon with any other icon by editing the `Spinner` component.
32
+ *
33
+ * ```astro showLineNumbers title="components/ui/spinner/Spinner.astro" nocollapse nopreview
34
+ * ---
35
+ * import { cn } from "@cl-light-ds/ui/lib/utils";
36
+ * import { Loader as LoaderIcon } from "@lucide/astro";
37
+ *
38
+ * const { class: className = "", ...props } = Astro.props;
39
+ * ---
40
+ *
41
+ * <LoaderIcon
42
+ * data-slot="spinner"
43
+ * role="status"
44
+ * aria-label="Loading"
45
+ * class={cn("cn-spinner", "size-4 animate-spin", className)}
46
+ * {...props}
47
+ * />
48
+ * ```
49
+ *
50
+ * @examples
51
+ *
52
+ * ### Size
53
+ *
54
+ * Use the `size-*` utility class to change the size of the spinner.
55
+ *
56
+ * <div class="flex items-center gap-6">
57
+ * <Spinner class="size-3" />
58
+ * <Spinner class="size-4" />
59
+ * <Spinner class="size-6" />
60
+ * <Spinner class="size-8" />
61
+ * </div>
62
+ *
63
+ * ### Button
64
+ *
65
+ * Add a spinner to a button to indicate a loading state. Remember to use the `data-icon` attribute for proper spacing.
66
+ *
67
+ * <div class="flex flex-col items-center gap-4">
68
+ * <Button disabled size="sm">
69
+ * <Spinner data-icon />
70
+ * Loading...
71
+ * </Button>
72
+ * <Button variant="outline" disabled size="sm">
73
+ * <Spinner data-icon />
74
+ * Please wait
75
+ * </Button>
76
+ * <Button variant="secondary" disabled size="sm">
77
+ * <Spinner data-icon />
78
+ * Processing
79
+ * </Button>
80
+ * </div>
81
+ *
82
+ * ### Badge
83
+ *
84
+ * Add a spinner to a badge to indicate a loading state.
85
+ *
86
+ * <div class="flex items-center gap-4 [--radius:1.2rem]">
87
+ * <Badge>
88
+ * <Spinner data-icon class="text-primary-foreground" />
89
+ * Syncing
90
+ * </Badge>
91
+ * <Badge variant="secondary">
92
+ * <Spinner data-icon />
93
+ * Updating
94
+ * </Badge>
95
+ * <Badge variant="outline">
96
+ * <Spinner data-icon />
97
+ * Processing
98
+ * </Badge>
99
+ * </div>
100
+ *
101
+ * ### Input Group
102
+ *
103
+ * <div class="flex w-full max-w-md flex-col gap-4">
104
+ * <InputGroup>
105
+ * <InputGroupInput placeholder="Send a message..." disabled />
106
+ * <InputGroupAddon align="inline-end">
107
+ * <Spinner />
108
+ * </InputGroupAddon>
109
+ * </InputGroup>
110
+ * <InputGroup>
111
+ * <InputGroupTextarea placeholder="Send a message..." disabled />
112
+ * <InputGroupAddon align="block-end">
113
+ * <Spinner /> Validating...
114
+ * <InputGroupButton class="ml-auto" variant="default">
115
+ * <ArrowUpIcon />
116
+ * <span class="sr-only">Send</span>
117
+ * </InputGroupButton>
118
+ * </InputGroupAddon>
119
+ * </InputGroup>
120
+ * </div>
121
+ *
122
+ * @props
123
+ * - class?: string — Additional classes for styling (e.g., size-3, size-6).
124
+ */
125
+
126
+ import { cn } from "@cl-light-ds/ui/lib/utils";
127
+
128
+ const { class: className = "", ...props } = Astro.props;
129
+ ---
130
+
131
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" data-slot="spinner"
132
+ role="status"
133
+ aria-label="Loading"
134
+ class={cn("text-primary", "size-4 animate-spin", className)}
135
+ {...props}><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12a9 9 0 1 1-6.219-8.56"/></svg>
@@ -1 +1 @@
1
- export { default as Spinner } from "./Spinner.astro";
1
+ export { default as Spinner } from "./Spinner.astro";
@@ -1,5 +1,5 @@
1
- # Changelog
2
-
3
- All notable changes to the `StickySurface` component will be documented in this file.
4
-
5
- ## Unreleased
1
+ # Changelog
2
+
3
+ All notable changes to the `StickySurface` component will be documented in this file.
4
+
5
+ ## Unreleased
@@ -1,152 +1,152 @@
1
- ---
2
- /**
3
- * @component StickySurface
4
- * @title Sticky Surface
5
- * @description A sticky surface component with scroll-based effects (border, shadow, surface swap, shrink, glass).
6
- * @figmaUrl
7
- *
8
- * @preview
9
- *
10
- * <div class="overflow-y-auto max-h-[320px] w-full bg-border px-8 border-border">
11
- * <div class="h-[1000px] bg-muted">
12
- * <StickySurface effects={["line", "elevate"]} threshold="1rem" observeStuck class="bg-background p-4 flex justify-between items-center">
13
- * <p>Scroll inside!</p>
14
- * <div class="flex items-center gap-2">
15
- * <Button size="sm" variant="outline" class="group-[.is-stuck]/surface:opacity-0 will-change-transform group-[.is-stuck]/surface:blur-sm transition-all duration-300 ease-out">Log in</Button>
16
- * <Button size="sm" class="w-24 group-[.is-stuck]/surface:w-28 duration-500 ease-out">
17
- * <span class="group-[.is-stuck]/surface:blur-sm group-[.is-stuck]/surface:opacity-0 absolute group-[.is-stuck]/surface:hidden transition-discrete duration-500 ease-out">Contact</span>
18
- * <span class="group-[.is-stuck]/surface:blur-none group-[.is-stuck]/surface:opacity-100 group-[.is-stuck]/surface:delay-150 opacity-0 transition-all blur-sm duration-500 ease-out">Get a demo</span>
19
- * </Button>
20
- * </div>
21
- * </StickySurface>
22
- * </div>
23
- * </div>
24
- *
25
- * @usage
26
- *
27
- * ```astro nocollapse
28
- * ---
29
- * import { StickySurface } from '@bejamas/ui/components/sticky-surface';
30
- * ---
31
- *
32
- * <StickySurface effects={["line", "elevate"]} threshold="1rem">
33
- * <!-- Your content here -->
34
- * </StickySurface>
35
- * ```
36
- */
37
-
38
- import type { HTMLTag } from "astro/types";
39
- import { cva } from "class-variance-authority";
40
- import { cn } from "@cl-light-ds/ui/lib/utils";
41
-
42
- interface Props {
43
- as?: HTMLTag;
44
- threshold?: string | number;
45
- effects?: Array<"line" | "elevate" | "backdrop">;
46
- class?: string;
47
- style?: string;
48
- observeStuck?: boolean;
49
- }
50
-
51
- const {
52
- as = "div",
53
- threshold = "16px",
54
- effects = [],
55
- class: className = "",
56
- style = "",
57
- ...props
58
- } = Astro.props as Props;
59
-
60
- // Compose effect booleans for easier use
61
- const hasLine = effects.includes("line");
62
- const hasElevate = effects.includes("elevate");
63
- const hasBackdrop = effects.includes("backdrop");
64
-
65
- // CSS variable tokens (can be overridden via Tailwind arbitrary props)
66
- const defaultVars = {
67
- '--stuck-shadow': '0 2px 8px 0 rgb(0 0 0 / 0.06)',
68
- '--stuck-threshold': typeof threshold === "number" ? `${threshold}px` : threshold,
69
- };
70
-
71
-
72
- const Tag = as;
73
-
74
- // cva for sticky surface effects
75
- const stickySurfaceVariants = cva(
76
- [
77
- "group/surface", "sticky", "top-0", "z-50", "w-full", "transition-all", "duration-300", "will-change-transform"
78
- ],
79
- {
80
- variants: {
81
- line: {
82
- true: "after:content-[''] after:pointer-events-none after:absolute after:inset-x-0 after:bottom-0 after:h-px after:bg-black/15 after:opacity-0 supports-[animation-timeline:scroll()]:after:[animation:show-line_linear_both] supports-[animation-timeline:scroll()]:after:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:after:[animation-range:0_var(--stuck-threshold)]"
83
- },
84
- elevate: {
85
- true: "shadow-none supports-[animation-timeline:scroll()]:[animation:stuck-shadow_linear_both] supports-[animation-timeline:scroll()]:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:[animation-range:0_var(--stuck-threshold)]"
86
- },
87
- backdrop: {
88
- true: "backdrop-blur supports-[animation-timeline:scroll()]:[animation:stuck-backdrop_linear_both] supports-[animation-timeline:scroll()]:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:[animation-range:0_var(--stuck-threshold)]"
89
- }
90
- }
91
- }
92
- );
93
-
94
- const effectClasses = cn(
95
- "",
96
- stickySurfaceVariants({
97
- line: hasLine,
98
- elevate: hasElevate,
99
- backdrop: hasBackdrop
100
- }),
101
- className
102
- );
103
-
104
- const styleVars = Object.entries(defaultVars)
105
- ?.map(([k, v]) => `${k}:${v}`)
106
- ?.join(";");
107
- ---
108
-
109
- <Tag
110
- class={effectClasses}
111
- style={`${styleVars};${style}`}
112
- data-sticky-surface
113
- {...props}
114
- >
115
- <slot />
116
- </Tag>
117
-
118
- <style>
119
- @supports (animation-timeline: scroll()) {
120
- /* Line fade-in */
121
- @keyframes show-line {
122
- from { opacity: 0 }
123
- to { opacity: 1 }
124
- }
125
- /* Shadow fade-in */
126
- @keyframes stuck-shadow {
127
- from { box-shadow: none }
128
- to { box-shadow: var(--stuck-shadow) }
129
- }
130
- }
131
- </style>
132
-
133
-
134
- {Astro.props.observeStuck && (
135
- <script is:inline>
136
- (() => {
137
- const surfaces = document.querySelectorAll('[data-sticky-surface]');
138
- surfaces.forEach(surface => {
139
- // Insert a 1px sentinel right before the sticky element
140
- const sentinel = document.createElement('div');
141
- sentinel.style.cssText = 'position:relative;height:0;opacity:0;visibility:hidden;';
142
- surface.parentNode?.insertBefore(sentinel, surface);
143
-
144
- const io = new IntersectionObserver(([e]) => {
145
- surface.classList.toggle('is-stuck', !e.isIntersecting);
146
- }, { threshold: [0, 1] });
147
-
148
- io.observe(sentinel);
149
- });
150
- })();
151
- </script>
152
- )}
1
+ ---
2
+ /**
3
+ * @component StickySurface
4
+ * @title Sticky Surface
5
+ * @description A sticky surface component with scroll-based effects (border, shadow, surface swap, shrink, glass).
6
+ * @figmaUrl
7
+ *
8
+ * @preview
9
+ *
10
+ * <div class="overflow-y-auto max-h-[320px] w-full bg-border px-8 border-border">
11
+ * <div class="h-[1000px] bg-muted">
12
+ * <StickySurface effects={["line", "elevate"]} threshold="1rem" observeStuck class="bg-background p-4 flex justify-between items-center">
13
+ * <p>Scroll inside!</p>
14
+ * <div class="flex items-center gap-2">
15
+ * <Button size="sm" variant="outline" class="group-[.is-stuck]/surface:opacity-0 will-change-transform group-[.is-stuck]/surface:blur-sm transition-all duration-300 ease-out">Log in</Button>
16
+ * <Button size="sm" class="w-24 group-[.is-stuck]/surface:w-28 duration-500 ease-out">
17
+ * <span class="group-[.is-stuck]/surface:blur-sm group-[.is-stuck]/surface:opacity-0 absolute group-[.is-stuck]/surface:hidden transition-discrete duration-500 ease-out">Contact</span>
18
+ * <span class="group-[.is-stuck]/surface:blur-none group-[.is-stuck]/surface:opacity-100 group-[.is-stuck]/surface:delay-150 opacity-0 transition-all blur-sm duration-500 ease-out">Get a demo</span>
19
+ * </Button>
20
+ * </div>
21
+ * </StickySurface>
22
+ * </div>
23
+ * </div>
24
+ *
25
+ * @usage
26
+ *
27
+ * ```astro nocollapse
28
+ * ---
29
+ * import { StickySurface } from '@bejamas/ui/components/sticky-surface';
30
+ * ---
31
+ *
32
+ * <StickySurface effects={["line", "elevate"]} threshold="1rem">
33
+ * <!-- Your content here -->
34
+ * </StickySurface>
35
+ * ```
36
+ */
37
+
38
+ import type { HTMLTag } from "astro/types";
39
+ import { cva } from "class-variance-authority";
40
+ import { cn } from "@cl-light-ds/ui/lib/utils";
41
+
42
+ interface Props {
43
+ as?: HTMLTag;
44
+ threshold?: string | number;
45
+ effects?: Array<"line" | "elevate" | "backdrop">;
46
+ class?: string;
47
+ style?: string;
48
+ observeStuck?: boolean;
49
+ }
50
+
51
+ const {
52
+ as = "div",
53
+ threshold = "16px",
54
+ effects = [],
55
+ class: className = "",
56
+ style = "",
57
+ ...props
58
+ } = Astro.props as Props;
59
+
60
+ // Compose effect booleans for easier use
61
+ const hasLine = effects.includes("line");
62
+ const hasElevate = effects.includes("elevate");
63
+ const hasBackdrop = effects.includes("backdrop");
64
+
65
+ // CSS variable tokens (can be overridden via Tailwind arbitrary props)
66
+ const defaultVars = {
67
+ '--stuck-shadow': '0 2px 8px 0 rgb(0 0 0 / 0.06)',
68
+ '--stuck-threshold': typeof threshold === "number" ? `${threshold}px` : threshold,
69
+ };
70
+
71
+
72
+ const Tag = as;
73
+
74
+ // cva for sticky surface effects
75
+ const stickySurfaceVariants = cva(
76
+ [
77
+ "group/surface", "sticky", "top-0", "z-50", "w-full", "transition-all", "duration-300", "will-change-transform"
78
+ ],
79
+ {
80
+ variants: {
81
+ line: {
82
+ true: "after:content-[''] after:pointer-events-none after:absolute after:inset-x-0 after:bottom-0 after:h-px after:bg-black/15 after:opacity-0 supports-[animation-timeline:scroll()]:after:[animation:show-line_linear_both] supports-[animation-timeline:scroll()]:after:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:after:[animation-range:0_var(--stuck-threshold)]"
83
+ },
84
+ elevate: {
85
+ true: "shadow-none supports-[animation-timeline:scroll()]:[animation:stuck-shadow_linear_both] supports-[animation-timeline:scroll()]:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:[animation-range:0_var(--stuck-threshold)]"
86
+ },
87
+ backdrop: {
88
+ true: "backdrop-blur supports-[animation-timeline:scroll()]:[animation:stuck-backdrop_linear_both] supports-[animation-timeline:scroll()]:[animation-timeline:scroll(nearest_block)] supports-[animation-timeline:scroll()]:[animation-range:0_var(--stuck-threshold)]"
89
+ }
90
+ }
91
+ }
92
+ );
93
+
94
+ const effectClasses = cn(
95
+ "",
96
+ stickySurfaceVariants({
97
+ line: hasLine,
98
+ elevate: hasElevate,
99
+ backdrop: hasBackdrop
100
+ }),
101
+ className
102
+ );
103
+
104
+ const styleVars = Object.entries(defaultVars)
105
+ ?.map(([k, v]) => `${k}:${v}`)
106
+ ?.join(";");
107
+ ---
108
+
109
+ <Tag
110
+ class={effectClasses}
111
+ style={`${styleVars};${style}`}
112
+ data-sticky-surface
113
+ {...props}
114
+ >
115
+ <slot />
116
+ </Tag>
117
+
118
+ <style>
119
+ @supports (animation-timeline: scroll()) {
120
+ /* Line fade-in */
121
+ @keyframes show-line {
122
+ from { opacity: 0 }
123
+ to { opacity: 1 }
124
+ }
125
+ /* Shadow fade-in */
126
+ @keyframes stuck-shadow {
127
+ from { box-shadow: none }
128
+ to { box-shadow: var(--stuck-shadow) }
129
+ }
130
+ }
131
+ </style>
132
+
133
+
134
+ {Astro.props.observeStuck && (
135
+ <script is:inline>
136
+ (() => {
137
+ const surfaces = document.querySelectorAll('[data-sticky-surface]');
138
+ surfaces.forEach(surface => {
139
+ // Insert a 1px sentinel right before the sticky element
140
+ const sentinel = document.createElement('div');
141
+ sentinel.style.cssText = 'position:relative;height:0;opacity:0;visibility:hidden;';
142
+ surface.parentNode?.insertBefore(sentinel, surface);
143
+
144
+ const io = new IntersectionObserver(([e]) => {
145
+ surface.classList.toggle('is-stuck', !e.isIntersecting);
146
+ }, { threshold: [0, 1] });
147
+
148
+ io.observe(sentinel);
149
+ });
150
+ })();
151
+ </script>
152
+ )}
@@ -1,2 +1,2 @@
1
- export { default as StickySurface } from "./StickySurface.astro";
2
-
1
+ export { default as StickySurface } from "./StickySurface.astro";
2
+