@cl-light-ds/ui 0.2.0 → 0.3.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 (283) hide show
  1. package/README.md +45 -45
  2. package/package.json +1 -1
  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/card/CHANGELOG.md +162 -119
  40. package/src/components/card/Card.astro +197 -182
  41. package/src/components/card/CardAction.astro +26 -26
  42. package/src/components/card/CardContent.astro +28 -28
  43. package/src/components/card/CardDescription.astro +28 -28
  44. package/src/components/card/CardFooter.astro +24 -24
  45. package/src/components/card/CardHeader.astro +30 -30
  46. package/src/components/card/CardMedia.astro +27 -27
  47. package/src/components/card/CardMediaActions.astro +21 -0
  48. package/src/components/card/CardMediaSelect.astro +21 -0
  49. package/src/components/card/CardOverlay.astro +32 -32
  50. package/src/components/card/CardTitle.astro +21 -21
  51. package/src/components/card/index.ts +12 -10
  52. package/src/components/carousel/CHANGELOG.md +5 -5
  53. package/src/components/carousel/Carousel.astro +106 -106
  54. package/src/components/carousel/CarouselSlide.astro +22 -22
  55. package/src/components/carousel/index.ts +3 -3
  56. package/src/components/checkbox/CHANGELOG.md +58 -58
  57. package/src/components/checkbox/Checkbox.astro +159 -159
  58. package/src/components/checkbox/index.ts +1 -1
  59. package/src/components/collapsible/CHANGELOG.md +5 -5
  60. package/src/components/collapsible/Collapsible.astro +202 -202
  61. package/src/components/collapsible/CollapsibleContent.astro +36 -36
  62. package/src/components/collapsible/CollapsibleTrigger.astro +34 -34
  63. package/src/components/collapsible/index.ts +4 -4
  64. package/src/components/combobox/CHANGELOG.md +27 -27
  65. package/src/components/combobox/Combobox.astro +365 -365
  66. package/src/components/combobox/ComboboxContent.astro +37 -37
  67. package/src/components/combobox/ComboboxEmpty.astro +18 -18
  68. package/src/components/combobox/ComboboxGroup.astro +19 -19
  69. package/src/components/combobox/ComboboxInput.astro +74 -74
  70. package/src/components/combobox/ComboboxItem.astro +39 -39
  71. package/src/components/combobox/ComboboxLabel.astro +18 -18
  72. package/src/components/combobox/ComboboxList.astro +21 -21
  73. package/src/components/combobox/ComboboxSeparator.astro +17 -17
  74. package/src/components/combobox/ComboboxTrigger.astro +30 -30
  75. package/src/components/combobox/ComboboxValue.astro +22 -22
  76. package/src/components/combobox/index.ts +11 -11
  77. package/src/components/date/CHANGELOG.md +18 -18
  78. package/src/components/date/Date.astro +137 -137
  79. package/src/components/date/index.ts +2 -2
  80. package/src/components/dialog/CHANGELOG.md +39 -39
  81. package/src/components/dialog/Dialog.astro +196 -196
  82. package/src/components/dialog/DialogClose.astro +23 -23
  83. package/src/components/dialog/DialogContent.astro +42 -42
  84. package/src/components/dialog/DialogDescription.astro +18 -18
  85. package/src/components/dialog/DialogFooter.astro +18 -18
  86. package/src/components/dialog/DialogHeader.astro +18 -18
  87. package/src/components/dialog/DialogOverlay.astro +19 -19
  88. package/src/components/dialog/DialogTitle.astro +18 -18
  89. package/src/components/dialog/DialogTrigger.astro +37 -37
  90. package/src/components/dialog/index.ts +9 -9
  91. package/src/components/dropdown-menu/CHANGELOG.md +194 -194
  92. package/src/components/dropdown-menu/DropdownMenu.astro +226 -226
  93. package/src/components/dropdown-menu/DropdownMenuCheckboxItem.astro +114 -114
  94. package/src/components/dropdown-menu/DropdownMenuContent.astro +42 -42
  95. package/src/components/dropdown-menu/DropdownMenuGroup.astro +19 -19
  96. package/src/components/dropdown-menu/DropdownMenuItem.astro +220 -220
  97. package/src/components/dropdown-menu/DropdownMenuItemContent.astro +79 -79
  98. package/src/components/dropdown-menu/DropdownMenuLabel.astro +20 -20
  99. package/src/components/dropdown-menu/DropdownMenuPortal.astro +13 -13
  100. package/src/components/dropdown-menu/DropdownMenuRadioGroup.astro +13 -13
  101. package/src/components/dropdown-menu/DropdownMenuRadioItem.astro +101 -101
  102. package/src/components/dropdown-menu/DropdownMenuSeparator.astro +18 -18
  103. package/src/components/dropdown-menu/DropdownMenuShortcut.astro +18 -18
  104. package/src/components/dropdown-menu/DropdownMenuTrigger.astro +49 -49
  105. package/src/components/dropdown-menu/dropdown-menu-item-variants.ts +24 -24
  106. package/src/components/dropdown-menu/index.ts +12 -12
  107. package/src/components/field/CHANGELOG.md +33 -33
  108. package/src/components/field/Field.astro +664 -664
  109. package/src/components/field/FieldContent.astro +20 -20
  110. package/src/components/field/FieldDescription.astro +22 -22
  111. package/src/components/field/FieldError.astro +51 -51
  112. package/src/components/field/FieldGroup.astro +20 -20
  113. package/src/components/field/FieldLabel.astro +22 -22
  114. package/src/components/field/FieldLegend.astro +23 -23
  115. package/src/components/field/FieldSeparator.astro +30 -30
  116. package/src/components/field/FieldSet.astro +20 -20
  117. package/src/components/field/FieldTitle.astro +20 -20
  118. package/src/components/field/index.ts +10 -10
  119. package/src/components/hover-card/CHANGELOG.md +20 -20
  120. package/src/components/hover-card/HoverCard.astro +235 -235
  121. package/src/components/hover-card/HoverCardContent.astro +54 -54
  122. package/src/components/hover-card/HoverCardTrigger.astro +38 -38
  123. package/src/components/hover-card/index.ts +3 -3
  124. package/src/components/input/CHANGELOG.md +29 -29
  125. package/src/components/input/Input.astro +130 -130
  126. package/src/components/input/index.ts +2 -2
  127. package/src/components/input-group/CHANGELOG.md +49 -49
  128. package/src/components/input-group/InputGroup.astro +135 -135
  129. package/src/components/input-group/InputGroupAddon.astro +49 -49
  130. package/src/components/input-group/InputGroupButton.astro +58 -58
  131. package/src/components/input-group/InputGroupInput.astro +18 -18
  132. package/src/components/input-group/InputGroupText.astro +21 -21
  133. package/src/components/input-group/InputGroupTextarea.astro +17 -17
  134. package/src/components/input-group/controlClasses.ts +2 -2
  135. package/src/components/input-group/index.ts +6 -6
  136. package/src/components/item/CHANGELOG.md +27 -27
  137. package/src/components/item/Item.astro +122 -122
  138. package/src/components/item/ItemActions.astro +21 -21
  139. package/src/components/item/ItemContent.astro +25 -25
  140. package/src/components/item/ItemDescription.astro +25 -25
  141. package/src/components/item/ItemFooter.astro +24 -24
  142. package/src/components/item/ItemGroup.astro +24 -24
  143. package/src/components/item/ItemHeader.astro +24 -24
  144. package/src/components/item/ItemMedia.astro +47 -47
  145. package/src/components/item/ItemSeparator.astro +21 -21
  146. package/src/components/item/ItemTitle.astro +25 -25
  147. package/src/components/item/index.ts +10 -10
  148. package/src/components/kbd/CHANGELOG.md +5 -5
  149. package/src/components/kbd/Kbd.astro +145 -145
  150. package/src/components/kbd/KbdGroup.astro +55 -55
  151. package/src/components/kbd/index.ts +2 -2
  152. package/src/components/label/CHANGELOG.md +28 -28
  153. package/src/components/label/Label.astro +97 -97
  154. package/src/components/label/index.ts +2 -2
  155. package/src/components/link-group/CHANGELOG.md +75 -75
  156. package/src/components/link-group/LinkGroup.astro +67 -67
  157. package/src/components/link-group/LinkGroupItem.astro +32 -32
  158. package/src/components/link-group/LinkGroupList.astro +25 -25
  159. package/src/components/link-group/LinkGroupTitle.astro +22 -22
  160. package/src/components/link-group/index.ts +5 -5
  161. package/src/components/link-group/link-group-list-variants.ts +15 -15
  162. package/src/components/marquee/CHANGELOG.md +5 -5
  163. package/src/components/marquee/Marquee.astro +119 -119
  164. package/src/components/marquee/index.ts +2 -2
  165. package/src/components/native-select/CHANGELOG.md +5 -5
  166. package/src/components/native-select/NativeSelect.astro +125 -125
  167. package/src/components/native-select/NativeSelectOptGroup.astro +14 -14
  168. package/src/components/native-select/NativeSelectOption.astro +9 -9
  169. package/src/components/native-select/index.ts +3 -3
  170. package/src/components/navigation-menu/CHANGELOG.md +63 -63
  171. package/src/components/navigation-menu/NavigationMenu.astro +414 -414
  172. package/src/components/navigation-menu/NavigationMenuContent.astro +37 -37
  173. package/src/components/navigation-menu/NavigationMenuIndicator.astro +24 -24
  174. package/src/components/navigation-menu/NavigationMenuItem.astro +22 -22
  175. package/src/components/navigation-menu/NavigationMenuLink.astro +18 -18
  176. package/src/components/navigation-menu/NavigationMenuList.astro +21 -21
  177. package/src/components/navigation-menu/NavigationMenuPositioner.astro +44 -44
  178. package/src/components/navigation-menu/NavigationMenuTrigger.astro +30 -30
  179. package/src/components/navigation-menu/NavigationMenuViewport.astro +19 -19
  180. package/src/components/navigation-menu/index.ts +10 -10
  181. package/src/components/organisms/lightning-sidebar-nav/CHANGELOG.md +50 -0
  182. package/src/components/organisms/lightning-sidebar-nav/LightningSidebarNav.astro +176 -0
  183. package/src/components/organisms/lightning-sidebar-nav/SidebarNav.astro +50 -0
  184. package/src/components/organisms/lightning-sidebar-nav/SidebarNavGroup.astro +74 -0
  185. package/src/components/organisms/lightning-sidebar-nav/SidebarNavItem.astro +94 -0
  186. package/src/components/organisms/lightning-sidebar-nav/SidebarNavProBadge.astro +26 -0
  187. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSection.astro +71 -0
  188. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSkeleton.astro +67 -0
  189. package/src/components/organisms/lightning-sidebar-nav/SidebarNavSubItem.astro +69 -0
  190. package/src/components/organisms/lightning-sidebar-nav/SidebarNavUsage.astro +78 -0
  191. package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceAvatar.astro +46 -0
  192. package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceSwitcher.astro +130 -0
  193. package/src/components/organisms/lightning-sidebar-nav/icons.ts +46 -0
  194. package/src/components/organisms/lightning-sidebar-nav/index.ts +18 -0
  195. package/src/components/organisms/lightning-sidebar-nav/types.ts +77 -0
  196. package/src/components/popover/CHANGELOG.md +20 -20
  197. package/src/components/popover/Popover.astro +211 -211
  198. package/src/components/popover/PopoverClose.astro +18 -18
  199. package/src/components/popover/PopoverContent.astro +50 -50
  200. package/src/components/popover/PopoverDescription.astro +18 -18
  201. package/src/components/popover/PopoverHeader.astro +18 -18
  202. package/src/components/popover/PopoverTitle.astro +18 -18
  203. package/src/components/popover/PopoverTrigger.astro +35 -35
  204. package/src/components/popover/index.ts +7 -7
  205. package/src/components/radio-group/CHANGELOG.md +31 -31
  206. package/src/components/radio-group/RadioGroup.astro +81 -81
  207. package/src/components/radio-group/RadioGroupItem.astro +51 -51
  208. package/src/components/radio-group/index.ts +3 -3
  209. package/src/components/select/CHANGELOG.md +39 -39
  210. package/src/components/select/Select.astro +373 -373
  211. package/src/components/select/SelectContent.astro +91 -91
  212. package/src/components/select/SelectGroup.astro +19 -19
  213. package/src/components/select/SelectItem.astro +48 -48
  214. package/src/components/select/SelectLabel.astro +18 -18
  215. package/src/components/select/SelectSeparator.astro +17 -17
  216. package/src/components/select/SelectTrigger.astro +34 -34
  217. package/src/components/select/SelectValue.astro +22 -22
  218. package/src/components/select/index.ts +8 -8
  219. package/src/components/separator/CHANGELOG.md +5 -5
  220. package/src/components/separator/Separator.astro +60 -60
  221. package/src/components/separator/index.ts +2 -2
  222. package/src/components/skeleton/CHANGELOG.md +5 -5
  223. package/src/components/skeleton/Skeleton.astro +121 -121
  224. package/src/components/skeleton/index.ts +1 -1
  225. package/src/components/slider/CHANGELOG.md +5 -5
  226. package/src/components/slider/Slider.astro +198 -198
  227. package/src/components/slider/index.ts +1 -1
  228. package/src/components/spinner/CHANGELOG.md +18 -18
  229. package/src/components/spinner/Spinner.astro +135 -135
  230. package/src/components/spinner/index.ts +1 -1
  231. package/src/components/sticky-surface/CHANGELOG.md +5 -5
  232. package/src/components/sticky-surface/StickySurface.astro +152 -152
  233. package/src/components/sticky-surface/index.ts +2 -2
  234. package/src/components/switch/CHANGELOG.md +29 -29
  235. package/src/components/switch/Switch.astro +106 -106
  236. package/src/components/switch/index.ts +1 -1
  237. package/src/components/table/CHANGELOG.md +24 -24
  238. package/src/components/table/Table.astro +358 -251
  239. package/src/components/table/TableBody.astro +17 -18
  240. package/src/components/table/TableBulkToolbar.astro +37 -0
  241. package/src/components/table/TableCaption.astro +17 -17
  242. package/src/components/table/TableCell.astro +45 -21
  243. package/src/components/table/TableCellText.astro +17 -0
  244. package/src/components/table/TableColumnMenu.astro +50 -0
  245. package/src/components/table/TableEditableCell.astro +287 -0
  246. package/src/components/table/TableEmpty.astro +17 -0
  247. package/src/components/table/TableFolderCell.astro +38 -0
  248. package/src/components/table/TableFooter.astro +21 -21
  249. package/src/components/table/TableHead.astro +90 -21
  250. package/src/components/table/TableHeader.astro +17 -17
  251. package/src/components/table/TablePagination.astro +57 -0
  252. package/src/components/table/TableRow.astro +52 -21
  253. package/src/components/table/TableSelectAllBanner.astro +34 -0
  254. package/src/components/table/TableSelectCell.astro +50 -0
  255. package/src/components/table/TableSkeletonRow.astro +21 -0
  256. package/src/components/table/index.ts +19 -9
  257. package/src/components/table/table-cell-variants.ts +29 -0
  258. package/src/components/tabs/CHANGELOG.md +5 -5
  259. package/src/components/tabs/Tabs.astro +306 -306
  260. package/src/components/tabs/TabsContent.astro +47 -47
  261. package/src/components/tabs/TabsList.astro +69 -69
  262. package/src/components/tabs/TabsTrigger.astro +40 -40
  263. package/src/components/tabs/index.ts +6 -6
  264. package/src/components/textarea/CHANGELOG.md +22 -22
  265. package/src/components/textarea/Textarea.astro +58 -58
  266. package/src/components/textarea/index.ts +2 -2
  267. package/src/components/toggle/CHANGELOG.md +23 -23
  268. package/src/components/toggle/Toggle.astro +150 -150
  269. package/src/components/toggle/index.ts +1 -1
  270. package/src/components/toggle-group/CHANGELOG.md +18 -18
  271. package/src/components/toggle-group/ToggleGroup.astro +236 -236
  272. package/src/components/toggle-group/ToggleGroupItem.astro +48 -48
  273. package/src/components/toggle-group/index.ts +2 -2
  274. package/src/components/tooltip/CHANGELOG.md +22 -22
  275. package/src/components/tooltip/Tooltip.astro +357 -357
  276. package/src/components/tooltip/TooltipContent.astro +85 -85
  277. package/src/components/tooltip/TooltipTrigger.astro +34 -34
  278. package/src/components/tooltip/index.ts +3 -3
  279. package/src/lib/table-controller.ts +1090 -0
  280. package/src/lib/toggle-group-controller.ts +113 -113
  281. package/src/lib/toggle-shared.ts +27 -27
  282. package/src/lib/utils.ts +6 -6
  283. package/src/styles/globals.css +197 -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
+