@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.
- package/README.md +45 -45
- package/package.json +2 -2
- package/src/components/accordion/Accordion.astro +248 -248
- package/src/components/accordion/AccordionContent.astro +26 -26
- package/src/components/accordion/AccordionItem.astro +36 -36
- package/src/components/accordion/AccordionTrigger.astro +118 -118
- package/src/components/accordion/CHANGELOG.md +41 -41
- package/src/components/accordion/index.ts +4 -4
- package/src/components/alert/Alert.astro +167 -167
- package/src/components/alert/AlertDescription.astro +24 -24
- package/src/components/alert/AlertTitle.astro +24 -24
- package/src/components/alert/CHANGELOG.md +5 -5
- package/src/components/alert/index.ts +4 -4
- package/src/components/avatar/Avatar.astro +197 -197
- package/src/components/avatar/AvatarBadge.astro +44 -44
- package/src/components/avatar/AvatarFallback.astro +26 -26
- package/src/components/avatar/AvatarGroup.astro +26 -26
- package/src/components/avatar/AvatarGroupCount.astro +30 -30
- package/src/components/avatar/AvatarImage.astro +46 -46
- package/src/components/avatar/CHANGELOG.md +44 -44
- package/src/components/avatar/index.ts +6 -6
- package/src/components/badge/Badge.astro +167 -167
- package/src/components/badge/CHANGELOG.md +49 -49
- package/src/components/badge/index.ts +2 -2
- package/src/components/breadcrumb/Breadcrumb.astro +76 -76
- package/src/components/breadcrumb/BreadcrumbItem.astro +32 -32
- package/src/components/breadcrumb/BreadcrumbList.astro +26 -26
- package/src/components/breadcrumb/BreadcrumbSeparator.astro +26 -26
- package/src/components/breadcrumb/CHANGELOG.md +24 -24
- package/src/components/breadcrumb/index.ts +5 -5
- package/src/components/button/Button.astro +233 -233
- package/src/components/button/CHANGELOG.md +41 -41
- package/src/components/button/index.ts +2 -2
- package/src/components/button-group/ButtonGroup.astro +130 -130
- package/src/components/button-group/ButtonGroupSeparator.astro +30 -30
- package/src/components/button-group/ButtonGroupText.astro +21 -21
- package/src/components/button-group/CHANGELOG.md +34 -34
- package/src/components/button-group/index.ts +3 -3
- package/src/components/callout/CHANGELOG.md +32 -0
- package/src/components/callout/Callout.astro +147 -0
- package/src/components/callout/CalloutDescription.astro +16 -0
- package/src/components/callout/CalloutTitle.astro +16 -0
- package/src/components/callout/index.ts +3 -0
- package/src/components/card/CHANGELOG.md +162 -119
- package/src/components/card/Card.astro +197 -182
- package/src/components/card/CardAction.astro +26 -26
- package/src/components/card/CardContent.astro +28 -28
- package/src/components/card/CardDescription.astro +28 -28
- package/src/components/card/CardFooter.astro +24 -24
- package/src/components/card/CardHeader.astro +30 -30
- package/src/components/card/CardMedia.astro +27 -27
- package/src/components/card/CardMediaActions.astro +21 -0
- package/src/components/card/CardMediaSelect.astro +21 -0
- package/src/components/card/CardOverlay.astro +32 -32
- package/src/components/card/CardTitle.astro +21 -21
- package/src/components/card/index.ts +12 -10
- package/src/components/carousel/CHANGELOG.md +5 -5
- package/src/components/carousel/Carousel.astro +106 -106
- package/src/components/carousel/CarouselSlide.astro +22 -22
- package/src/components/carousel/index.ts +3 -3
- package/src/components/checkbox/CHANGELOG.md +58 -58
- package/src/components/checkbox/Checkbox.astro +159 -159
- package/src/components/checkbox/index.ts +1 -1
- package/src/components/collapsible/CHANGELOG.md +5 -5
- package/src/components/collapsible/Collapsible.astro +202 -202
- package/src/components/collapsible/CollapsibleContent.astro +36 -36
- package/src/components/collapsible/CollapsibleTrigger.astro +34 -34
- package/src/components/collapsible/index.ts +4 -4
- package/src/components/combobox/CHANGELOG.md +27 -27
- package/src/components/combobox/Combobox.astro +365 -365
- package/src/components/combobox/ComboboxContent.astro +37 -37
- package/src/components/combobox/ComboboxEmpty.astro +18 -18
- package/src/components/combobox/ComboboxGroup.astro +19 -19
- package/src/components/combobox/ComboboxInput.astro +74 -74
- package/src/components/combobox/ComboboxItem.astro +39 -39
- package/src/components/combobox/ComboboxLabel.astro +18 -18
- package/src/components/combobox/ComboboxList.astro +21 -21
- package/src/components/combobox/ComboboxSeparator.astro +17 -17
- package/src/components/combobox/ComboboxTrigger.astro +30 -30
- package/src/components/combobox/ComboboxValue.astro +22 -22
- package/src/components/combobox/index.ts +11 -11
- package/src/components/date/CHANGELOG.md +18 -18
- package/src/components/date/Date.astro +137 -137
- package/src/components/date/index.ts +2 -2
- package/src/components/dialog/CHANGELOG.md +39 -39
- package/src/components/dialog/Dialog.astro +196 -196
- package/src/components/dialog/DialogClose.astro +23 -23
- package/src/components/dialog/DialogContent.astro +42 -42
- package/src/components/dialog/DialogDescription.astro +18 -18
- package/src/components/dialog/DialogFooter.astro +18 -18
- package/src/components/dialog/DialogHeader.astro +18 -18
- package/src/components/dialog/DialogOverlay.astro +19 -19
- package/src/components/dialog/DialogTitle.astro +18 -18
- package/src/components/dialog/DialogTrigger.astro +37 -37
- package/src/components/dialog/index.ts +9 -9
- package/src/components/dropdown-menu/CHANGELOG.md +194 -194
- package/src/components/dropdown-menu/DropdownMenu.astro +226 -226
- package/src/components/dropdown-menu/DropdownMenuCheckboxItem.astro +114 -114
- package/src/components/dropdown-menu/DropdownMenuContent.astro +42 -42
- package/src/components/dropdown-menu/DropdownMenuGroup.astro +19 -19
- package/src/components/dropdown-menu/DropdownMenuItem.astro +220 -220
- package/src/components/dropdown-menu/DropdownMenuItemContent.astro +79 -79
- package/src/components/dropdown-menu/DropdownMenuLabel.astro +20 -20
- package/src/components/dropdown-menu/DropdownMenuPortal.astro +13 -13
- package/src/components/dropdown-menu/DropdownMenuRadioGroup.astro +13 -13
- package/src/components/dropdown-menu/DropdownMenuRadioItem.astro +101 -101
- package/src/components/dropdown-menu/DropdownMenuSeparator.astro +18 -18
- package/src/components/dropdown-menu/DropdownMenuShortcut.astro +18 -18
- package/src/components/dropdown-menu/DropdownMenuTrigger.astro +49 -49
- package/src/components/dropdown-menu/dropdown-menu-item-variants.ts +24 -24
- package/src/components/dropdown-menu/index.ts +12 -12
- package/src/components/field/CHANGELOG.md +33 -33
- package/src/components/field/Field.astro +664 -664
- package/src/components/field/FieldContent.astro +20 -20
- package/src/components/field/FieldDescription.astro +22 -22
- package/src/components/field/FieldError.astro +51 -51
- package/src/components/field/FieldGroup.astro +20 -20
- package/src/components/field/FieldLabel.astro +22 -22
- package/src/components/field/FieldLegend.astro +23 -23
- package/src/components/field/FieldSeparator.astro +30 -30
- package/src/components/field/FieldSet.astro +20 -20
- package/src/components/field/FieldTitle.astro +20 -20
- package/src/components/field/index.ts +10 -10
- package/src/components/hover-card/CHANGELOG.md +20 -20
- package/src/components/hover-card/HoverCard.astro +235 -235
- package/src/components/hover-card/HoverCardContent.astro +54 -54
- package/src/components/hover-card/HoverCardTrigger.astro +38 -38
- package/src/components/hover-card/index.ts +3 -3
- package/src/components/input/CHANGELOG.md +44 -29
- package/src/components/input/Input.astro +130 -130
- package/src/components/input/InputOTP.astro +211 -0
- package/src/components/input/index.ts +2 -2
- package/src/components/input-group/CHANGELOG.md +49 -49
- package/src/components/input-group/InputGroup.astro +135 -135
- package/src/components/input-group/InputGroupAddon.astro +49 -49
- package/src/components/input-group/InputGroupButton.astro +58 -58
- package/src/components/input-group/InputGroupInput.astro +18 -18
- package/src/components/input-group/InputGroupText.astro +21 -21
- package/src/components/input-group/InputGroupTextarea.astro +17 -17
- package/src/components/input-group/controlClasses.ts +2 -2
- package/src/components/input-group/index.ts +6 -6
- package/src/components/item/CHANGELOG.md +27 -27
- package/src/components/item/Item.astro +122 -122
- package/src/components/item/ItemActions.astro +21 -21
- package/src/components/item/ItemContent.astro +25 -25
- package/src/components/item/ItemDescription.astro +25 -25
- package/src/components/item/ItemFooter.astro +24 -24
- package/src/components/item/ItemGroup.astro +24 -24
- package/src/components/item/ItemHeader.astro +24 -24
- package/src/components/item/ItemMedia.astro +47 -47
- package/src/components/item/ItemSeparator.astro +21 -21
- package/src/components/item/ItemTitle.astro +25 -25
- package/src/components/item/index.ts +10 -10
- package/src/components/kbd/CHANGELOG.md +5 -5
- package/src/components/kbd/Kbd.astro +145 -145
- package/src/components/kbd/KbdGroup.astro +55 -55
- package/src/components/kbd/index.ts +2 -2
- package/src/components/label/CHANGELOG.md +28 -28
- package/src/components/label/Label.astro +97 -97
- package/src/components/label/index.ts +2 -2
- package/src/components/link-group/CHANGELOG.md +75 -75
- package/src/components/link-group/LinkGroup.astro +67 -67
- package/src/components/link-group/LinkGroupItem.astro +32 -32
- package/src/components/link-group/LinkGroupList.astro +25 -25
- package/src/components/link-group/LinkGroupTitle.astro +22 -22
- package/src/components/link-group/index.ts +5 -5
- package/src/components/link-group/link-group-list-variants.ts +15 -15
- package/src/components/logo/CHANGELOG.md +17 -0
- package/src/components/logo/Logo.astro +90 -0
- package/src/components/logo/index.ts +3 -0
- package/src/components/logo/logo-paths.ts +57 -0
- package/src/components/marquee/CHANGELOG.md +5 -5
- package/src/components/marquee/Marquee.astro +119 -119
- package/src/components/marquee/index.ts +2 -2
- package/src/components/native-select/CHANGELOG.md +5 -5
- package/src/components/native-select/NativeSelect.astro +125 -125
- package/src/components/native-select/NativeSelectOptGroup.astro +14 -14
- package/src/components/native-select/NativeSelectOption.astro +9 -9
- package/src/components/native-select/index.ts +3 -3
- package/src/components/navigation-menu/CHANGELOG.md +63 -63
- package/src/components/navigation-menu/NavigationMenu.astro +414 -414
- package/src/components/navigation-menu/NavigationMenuContent.astro +37 -37
- package/src/components/navigation-menu/NavigationMenuIndicator.astro +24 -24
- package/src/components/navigation-menu/NavigationMenuItem.astro +22 -22
- package/src/components/navigation-menu/NavigationMenuLink.astro +18 -18
- package/src/components/navigation-menu/NavigationMenuList.astro +21 -21
- package/src/components/navigation-menu/NavigationMenuPositioner.astro +44 -44
- package/src/components/navigation-menu/NavigationMenuTrigger.astro +30 -30
- package/src/components/navigation-menu/NavigationMenuViewport.astro +19 -19
- package/src/components/navigation-menu/index.ts +10 -10
- package/src/components/organisms/lightning-sidebar-nav/CHANGELOG.md +50 -0
- package/src/components/organisms/lightning-sidebar-nav/LightningSidebarNav.astro +176 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNav.astro +50 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavGroup.astro +74 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavItem.astro +94 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavProBadge.astro +26 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavSection.astro +71 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavSkeleton.astro +67 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavSubItem.astro +69 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavUsage.astro +78 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceAvatar.astro +46 -0
- package/src/components/organisms/lightning-sidebar-nav/SidebarNavWorkspaceSwitcher.astro +130 -0
- package/src/components/organisms/lightning-sidebar-nav/icons.ts +46 -0
- package/src/components/organisms/lightning-sidebar-nav/index.ts +18 -0
- package/src/components/organisms/lightning-sidebar-nav/types.ts +77 -0
- package/src/components/popover/CHANGELOG.md +20 -20
- package/src/components/popover/Popover.astro +211 -211
- package/src/components/popover/PopoverClose.astro +18 -18
- package/src/components/popover/PopoverContent.astro +50 -50
- package/src/components/popover/PopoverDescription.astro +18 -18
- package/src/components/popover/PopoverHeader.astro +18 -18
- package/src/components/popover/PopoverTitle.astro +18 -18
- package/src/components/popover/PopoverTrigger.astro +35 -35
- package/src/components/popover/index.ts +7 -7
- package/src/components/radio-group/CHANGELOG.md +31 -31
- package/src/components/radio-group/RadioGroup.astro +81 -81
- package/src/components/radio-group/RadioGroupItem.astro +51 -51
- package/src/components/radio-group/index.ts +3 -3
- package/src/components/select/CHANGELOG.md +39 -39
- package/src/components/select/Select.astro +373 -373
- package/src/components/select/SelectContent.astro +91 -91
- package/src/components/select/SelectGroup.astro +19 -19
- package/src/components/select/SelectItem.astro +48 -48
- package/src/components/select/SelectLabel.astro +18 -18
- package/src/components/select/SelectSeparator.astro +17 -17
- package/src/components/select/SelectTrigger.astro +34 -34
- package/src/components/select/SelectValue.astro +22 -22
- package/src/components/select/index.ts +8 -8
- package/src/components/separator/CHANGELOG.md +5 -5
- package/src/components/separator/Separator.astro +60 -60
- package/src/components/separator/index.ts +2 -2
- package/src/components/skeleton/CHANGELOG.md +5 -5
- package/src/components/skeleton/Skeleton.astro +121 -121
- package/src/components/skeleton/index.ts +1 -1
- package/src/components/slider/CHANGELOG.md +5 -5
- package/src/components/slider/Slider.astro +198 -198
- package/src/components/slider/index.ts +1 -1
- package/src/components/spinner/CHANGELOG.md +18 -18
- package/src/components/spinner/Spinner.astro +135 -135
- package/src/components/spinner/index.ts +1 -1
- package/src/components/sticky-surface/CHANGELOG.md +5 -5
- package/src/components/sticky-surface/StickySurface.astro +152 -152
- package/src/components/sticky-surface/index.ts +2 -2
- package/src/components/switch/CHANGELOG.md +29 -29
- package/src/components/switch/Switch.astro +106 -106
- package/src/components/switch/index.ts +1 -1
- package/src/components/table/CHANGELOG.md +24 -24
- package/src/components/table/Table.astro +358 -251
- package/src/components/table/TableBody.astro +17 -18
- package/src/components/table/TableBulkToolbar.astro +37 -0
- package/src/components/table/TableCaption.astro +17 -17
- package/src/components/table/TableCell.astro +45 -21
- package/src/components/table/TableCellText.astro +17 -0
- package/src/components/table/TableColumnMenu.astro +50 -0
- package/src/components/table/TableEditableCell.astro +287 -0
- package/src/components/table/TableEmpty.astro +17 -0
- package/src/components/table/TableFolderCell.astro +38 -0
- package/src/components/table/TableFooter.astro +21 -21
- package/src/components/table/TableHead.astro +90 -21
- package/src/components/table/TableHeader.astro +17 -17
- package/src/components/table/TablePagination.astro +57 -0
- package/src/components/table/TableRow.astro +52 -21
- package/src/components/table/TableSelectAllBanner.astro +34 -0
- package/src/components/table/TableSelectCell.astro +50 -0
- package/src/components/table/TableSkeletonRow.astro +21 -0
- package/src/components/table/index.ts +19 -9
- package/src/components/table/table-cell-variants.ts +29 -0
- package/src/components/tabs/CHANGELOG.md +5 -5
- package/src/components/tabs/Tabs.astro +306 -306
- package/src/components/tabs/TabsContent.astro +47 -47
- package/src/components/tabs/TabsList.astro +69 -69
- package/src/components/tabs/TabsTrigger.astro +40 -40
- package/src/components/tabs/index.ts +6 -6
- package/src/components/textarea/CHANGELOG.md +22 -22
- package/src/components/textarea/Textarea.astro +58 -58
- package/src/components/textarea/index.ts +2 -2
- package/src/components/toggle/CHANGELOG.md +23 -23
- package/src/components/toggle/Toggle.astro +150 -150
- package/src/components/toggle/index.ts +1 -1
- package/src/components/toggle-group/CHANGELOG.md +18 -18
- package/src/components/toggle-group/ToggleGroup.astro +236 -236
- package/src/components/toggle-group/ToggleGroupItem.astro +48 -48
- package/src/components/toggle-group/index.ts +2 -2
- package/src/components/tooltip/CHANGELOG.md +22 -22
- package/src/components/tooltip/Tooltip.astro +357 -357
- package/src/components/tooltip/TooltipContent.astro +85 -85
- package/src/components/tooltip/TooltipTrigger.astro +34 -34
- package/src/components/tooltip/index.ts +3 -3
- package/src/lib/table-controller.ts +1090 -0
- package/src/lib/toggle-group-controller.ts +113 -113
- package/src/lib/toggle-shared.ts +27 -27
- package/src/lib/utils.ts +6 -6
- 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
|
+
|