@cl-light-ds/ui 0.1.0 → 0.2.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 (171) 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/alert/Alert.astro +167 -167
  8. package/src/components/alert/AlertDescription.astro +24 -24
  9. package/src/components/alert/AlertTitle.astro +24 -24
  10. package/src/components/avatar/Avatar.astro +197 -197
  11. package/src/components/avatar/AvatarBadge.astro +44 -44
  12. package/src/components/avatar/AvatarFallback.astro +26 -26
  13. package/src/components/avatar/AvatarGroup.astro +26 -26
  14. package/src/components/avatar/AvatarGroupCount.astro +30 -30
  15. package/src/components/avatar/AvatarImage.astro +46 -46
  16. package/src/components/badge/Badge.astro +167 -167
  17. package/src/components/breadcrumb/Breadcrumb.astro +76 -76
  18. package/src/components/breadcrumb/BreadcrumbItem.astro +32 -32
  19. package/src/components/breadcrumb/BreadcrumbList.astro +26 -26
  20. package/src/components/breadcrumb/BreadcrumbSeparator.astro +26 -26
  21. package/src/components/button/Button.astro +233 -233
  22. package/src/components/button-group/ButtonGroup.astro +130 -130
  23. package/src/components/button-group/ButtonGroupSeparator.astro +30 -30
  24. package/src/components/button-group/ButtonGroupText.astro +21 -21
  25. package/src/components/card/Card.astro +182 -182
  26. package/src/components/card/CardAction.astro +26 -26
  27. package/src/components/card/CardContent.astro +28 -28
  28. package/src/components/card/CardDescription.astro +28 -28
  29. package/src/components/card/CardFooter.astro +24 -24
  30. package/src/components/card/CardHeader.astro +30 -30
  31. package/src/components/card/CardMedia.astro +27 -27
  32. package/src/components/card/CardOverlay.astro +32 -32
  33. package/src/components/card/CardTitle.astro +21 -21
  34. package/src/components/carousel/Carousel.astro +106 -106
  35. package/src/components/carousel/CarouselSlide.astro +22 -22
  36. package/src/components/checkbox/Checkbox.astro +159 -159
  37. package/src/components/collapsible/Collapsible.astro +202 -202
  38. package/src/components/collapsible/CollapsibleContent.astro +36 -36
  39. package/src/components/collapsible/CollapsibleTrigger.astro +34 -34
  40. package/src/components/combobox/Combobox.astro +365 -365
  41. package/src/components/combobox/ComboboxContent.astro +37 -37
  42. package/src/components/combobox/ComboboxEmpty.astro +18 -18
  43. package/src/components/combobox/ComboboxGroup.astro +19 -19
  44. package/src/components/combobox/ComboboxInput.astro +74 -74
  45. package/src/components/combobox/ComboboxItem.astro +39 -39
  46. package/src/components/combobox/ComboboxLabel.astro +18 -18
  47. package/src/components/combobox/ComboboxList.astro +21 -21
  48. package/src/components/combobox/ComboboxSeparator.astro +17 -17
  49. package/src/components/combobox/ComboboxTrigger.astro +30 -30
  50. package/src/components/combobox/ComboboxValue.astro +22 -22
  51. package/src/components/date/Date.astro +137 -137
  52. package/src/components/dialog/Dialog.astro +196 -196
  53. package/src/components/dialog/DialogClose.astro +23 -23
  54. package/src/components/dialog/DialogContent.astro +42 -42
  55. package/src/components/dialog/DialogDescription.astro +18 -18
  56. package/src/components/dialog/DialogFooter.astro +18 -18
  57. package/src/components/dialog/DialogHeader.astro +18 -18
  58. package/src/components/dialog/DialogOverlay.astro +19 -19
  59. package/src/components/dialog/DialogTitle.astro +18 -18
  60. package/src/components/dialog/DialogTrigger.astro +37 -37
  61. package/src/components/dropdown-menu/DropdownMenu.astro +226 -226
  62. package/src/components/dropdown-menu/DropdownMenuCheckboxItem.astro +114 -114
  63. package/src/components/dropdown-menu/DropdownMenuContent.astro +42 -42
  64. package/src/components/dropdown-menu/DropdownMenuGroup.astro +19 -19
  65. package/src/components/dropdown-menu/DropdownMenuItem.astro +220 -220
  66. package/src/components/dropdown-menu/DropdownMenuLabel.astro +20 -20
  67. package/src/components/dropdown-menu/DropdownMenuRadioItem.astro +101 -101
  68. package/src/components/dropdown-menu/DropdownMenuSeparator.astro +18 -18
  69. package/src/components/dropdown-menu/DropdownMenuShortcut.astro +18 -18
  70. package/src/components/dropdown-menu/DropdownMenuTrigger.astro +49 -49
  71. package/src/components/field/Field.astro +664 -664
  72. package/src/components/field/FieldContent.astro +20 -20
  73. package/src/components/field/FieldDescription.astro +22 -22
  74. package/src/components/field/FieldError.astro +51 -51
  75. package/src/components/field/FieldGroup.astro +20 -20
  76. package/src/components/field/FieldLabel.astro +22 -22
  77. package/src/components/field/FieldLegend.astro +23 -23
  78. package/src/components/field/FieldSeparator.astro +30 -30
  79. package/src/components/field/FieldSet.astro +20 -20
  80. package/src/components/field/FieldTitle.astro +20 -20
  81. package/src/components/hover-card/HoverCard.astro +235 -235
  82. package/src/components/hover-card/HoverCardContent.astro +54 -54
  83. package/src/components/hover-card/HoverCardTrigger.astro +38 -38
  84. package/src/components/input/Input.astro +130 -130
  85. package/src/components/input-group/InputGroup.astro +135 -135
  86. package/src/components/input-group/InputGroupAddon.astro +49 -49
  87. package/src/components/input-group/InputGroupButton.astro +58 -58
  88. package/src/components/input-group/InputGroupInput.astro +18 -18
  89. package/src/components/input-group/InputGroupText.astro +21 -21
  90. package/src/components/input-group/InputGroupTextarea.astro +17 -17
  91. package/src/components/item/Item.astro +122 -122
  92. package/src/components/item/ItemActions.astro +21 -21
  93. package/src/components/item/ItemContent.astro +25 -25
  94. package/src/components/item/ItemDescription.astro +25 -25
  95. package/src/components/item/ItemFooter.astro +24 -24
  96. package/src/components/item/ItemGroup.astro +24 -24
  97. package/src/components/item/ItemHeader.astro +24 -24
  98. package/src/components/item/ItemMedia.astro +47 -47
  99. package/src/components/item/ItemSeparator.astro +21 -21
  100. package/src/components/item/ItemTitle.astro +25 -25
  101. package/src/components/kbd/Kbd.astro +145 -145
  102. package/src/components/kbd/KbdGroup.astro +55 -55
  103. package/src/components/label/Label.astro +97 -97
  104. package/src/components/link-group/LinkGroup.astro +67 -67
  105. package/src/components/link-group/LinkGroupItem.astro +32 -32
  106. package/src/components/link-group/LinkGroupList.astro +25 -25
  107. package/src/components/link-group/LinkGroupTitle.astro +22 -22
  108. package/src/components/marquee/Marquee.astro +119 -119
  109. package/src/components/native-select/NativeSelect.astro +125 -125
  110. package/src/components/native-select/NativeSelectOptGroup.astro +14 -14
  111. package/src/components/navigation-menu/NavigationMenu.astro +414 -414
  112. package/src/components/navigation-menu/NavigationMenuContent.astro +37 -37
  113. package/src/components/navigation-menu/NavigationMenuIndicator.astro +24 -24
  114. package/src/components/navigation-menu/NavigationMenuItem.astro +22 -22
  115. package/src/components/navigation-menu/NavigationMenuLink.astro +18 -18
  116. package/src/components/navigation-menu/NavigationMenuList.astro +21 -21
  117. package/src/components/navigation-menu/NavigationMenuPositioner.astro +44 -44
  118. package/src/components/navigation-menu/NavigationMenuTrigger.astro +30 -30
  119. package/src/components/navigation-menu/NavigationMenuViewport.astro +19 -19
  120. package/src/components/popover/CHANGELOG.md +17 -2
  121. package/src/components/popover/Popover.astro +211 -210
  122. package/src/components/popover/PopoverClose.astro +18 -18
  123. package/src/components/popover/PopoverContent.astro +50 -49
  124. package/src/components/popover/PopoverDescription.astro +18 -18
  125. package/src/components/popover/PopoverHeader.astro +18 -18
  126. package/src/components/popover/PopoverTitle.astro +18 -18
  127. package/src/components/popover/PopoverTrigger.astro +35 -29
  128. package/src/components/radio-group/CHANGELOG.md +23 -1
  129. package/src/components/radio-group/RadioGroup.astro +81 -81
  130. package/src/components/radio-group/RadioGroupItem.astro +51 -42
  131. package/src/components/select/Select.astro +373 -373
  132. package/src/components/select/SelectContent.astro +91 -91
  133. package/src/components/select/SelectGroup.astro +19 -19
  134. package/src/components/select/SelectItem.astro +48 -48
  135. package/src/components/select/SelectLabel.astro +18 -18
  136. package/src/components/select/SelectSeparator.astro +17 -17
  137. package/src/components/select/SelectTrigger.astro +34 -34
  138. package/src/components/select/SelectValue.astro +22 -22
  139. package/src/components/separator/Separator.astro +60 -60
  140. package/src/components/skeleton/Skeleton.astro +121 -121
  141. package/src/components/slider/Slider.astro +198 -198
  142. package/src/components/spinner/CHANGELOG.md +14 -1
  143. package/src/components/spinner/Spinner.astro +135 -134
  144. package/src/components/sticky-surface/StickySurface.astro +152 -152
  145. package/src/components/switch/CHANGELOG.md +20 -0
  146. package/src/components/switch/Switch.astro +106 -106
  147. package/src/components/table/CHANGELOG.md +21 -2
  148. package/src/components/table/Table.astro +251 -250
  149. package/src/components/table/TableBody.astro +18 -18
  150. package/src/components/table/TableCaption.astro +17 -17
  151. package/src/components/table/TableCell.astro +21 -21
  152. package/src/components/table/TableFooter.astro +21 -21
  153. package/src/components/table/TableHead.astro +21 -21
  154. package/src/components/table/TableHeader.astro +17 -17
  155. package/src/components/table/TableRow.astro +21 -21
  156. package/src/components/tabs/Tabs.astro +306 -306
  157. package/src/components/tabs/TabsContent.astro +47 -47
  158. package/src/components/tabs/TabsList.astro +69 -69
  159. package/src/components/tabs/TabsTrigger.astro +40 -40
  160. package/src/components/textarea/CHANGELOG.md +18 -1
  161. package/src/components/textarea/Textarea.astro +58 -36
  162. package/src/components/toggle/CHANGELOG.md +19 -1
  163. package/src/components/toggle/Toggle.astro +150 -138
  164. package/src/components/toggle-group/CHANGELOG.md +14 -1
  165. package/src/components/toggle-group/ToggleGroup.astro +236 -224
  166. package/src/components/toggle-group/ToggleGroupItem.astro +48 -48
  167. package/src/components/tooltip/CHANGELOG.md +19 -2
  168. package/src/components/tooltip/Tooltip.astro +357 -331
  169. package/src/components/tooltip/TooltipContent.astro +85 -60
  170. package/src/components/tooltip/TooltipTrigger.astro +34 -34
  171. package/src/lib/toggle-shared.ts +3 -2
@@ -1,24 +1,24 @@
1
- ---
2
- import { cn } from "@cl-light-ds/ui/lib/utils";
3
- import type { HTMLAttributes, HTMLTag } from "astro/types";
4
-
5
- interface Props extends HTMLAttributes<"div"> {
6
- as?: HTMLTag;
7
- class?: string;
8
- }
9
-
10
- const {
11
- as: Tag = "div",
12
- class: className = "",
13
- ...rest
14
- } = Astro.props as Props;
15
- ---
16
-
17
- <Tag
18
- {...rest}
19
- role="list"
20
- data-slot="item-group"
21
- class={cn("gap-4 has-data-[size=sm]:gap-2.5 group/item-group flex flex-col", className)}
22
- >
23
- <slot />
24
- </Tag>
1
+ ---
2
+ import { cn } from "@cl-light-ds/ui/lib/utils";
3
+ import type { HTMLAttributes, HTMLTag } from "astro/types";
4
+
5
+ interface Props extends HTMLAttributes<"div"> {
6
+ as?: HTMLTag;
7
+ class?: string;
8
+ }
9
+
10
+ const {
11
+ as: Tag = "div",
12
+ class: className = "",
13
+ ...rest
14
+ } = Astro.props as Props;
15
+ ---
16
+
17
+ <Tag
18
+ {...rest}
19
+ role="list"
20
+ data-slot="item-group"
21
+ class={cn("gap-4 has-data-[size=sm]:gap-2.5 group/item-group flex flex-col", className)}
22
+ >
23
+ <slot />
24
+ </Tag>
@@ -1,24 +1,24 @@
1
- ---
2
- import { cn } from "@cl-light-ds/ui/lib/utils";
3
- import type { HTMLAttributes } from "astro/types";
4
-
5
- interface Props extends HTMLAttributes<"div"> {
6
- class?: string;
7
- }
8
-
9
- const {
10
- class: className = "",
11
- ...rest
12
- } = Astro.props as Props;
13
- ---
14
-
15
- <div
16
- {...rest}
17
- data-slot="item-header"
18
- class={cn(
19
- "gap-2 flex basis-full items-center justify-between",
20
- className,
21
- )}
22
- >
23
- <slot />
24
- </div>
1
+ ---
2
+ import { cn } from "@cl-light-ds/ui/lib/utils";
3
+ import type { HTMLAttributes } from "astro/types";
4
+
5
+ interface Props extends HTMLAttributes<"div"> {
6
+ class?: string;
7
+ }
8
+
9
+ const {
10
+ class: className = "",
11
+ ...rest
12
+ } = Astro.props as Props;
13
+ ---
14
+
15
+ <div
16
+ {...rest}
17
+ data-slot="item-header"
18
+ class={cn(
19
+ "gap-2 flex basis-full items-center justify-between",
20
+ className,
21
+ )}
22
+ >
23
+ <slot />
24
+ </div>
@@ -1,47 +1,47 @@
1
- ---
2
- import { cva } from "class-variance-authority";
3
- import { cn } from "@cl-light-ds/ui/lib/utils";
4
- import type { HTMLAttributes } from "astro/types";
5
-
6
- type ItemMediaVariant = "default" | "icon" | "image";
7
-
8
- interface Props extends HTMLAttributes<"div"> {
9
- mediaVariant?: ItemMediaVariant;
10
- class?: string;
11
- }
12
-
13
- const {
14
- class: className = "",
15
- mediaVariant = "default",
16
- ...rest
17
- } = Astro.props as Props;
18
-
19
- const itemMediaVariants = cva(
20
- "flex shrink-0 items-center justify-center [&_svg]:pointer-events-none group-has-[[data-slot=item-description]]/item:self-start group-has-[[data-slot=item-description]]/item:translate-y-0.5 group-data-[size=header]/item:translate-y-0 group-data-[size=header]/item:self-auto",
21
- {
22
- variants: {
23
- variant: {
24
- default: "bg-transparent",
25
- icon: "[&_svg:not([class*='size-'])]:size-4",
26
- image:
27
- "size-10 overflow-hidden rounded-sm group-data-[size=sm]/item:size-8 group-data-[size=header]/item:size-auto group-data-[size=header]/item:w-full group-data-[size=header]/item:aspect-square [&_img]:size-full [&_img]:object-cover",
28
- },
29
- },
30
- defaultVariants: {
31
- variant: "default",
32
- },
33
- },
34
- );
35
- ---
36
-
37
- <div
38
- {...rest}
39
- data-slot="item-media"
40
- class={cn(
41
- "gap-2 group-has-data-[slot=item-description]/item:translate-y-0.5 group-has-data-[slot=item-description]/item:self-start group-data-[size=header]/item:translate-y-0 group-data-[size=header]/item:self-auto",
42
- itemMediaVariants({ variant: mediaVariant }),
43
- className,
44
- )}
45
- >
46
- <slot />
47
- </div>
1
+ ---
2
+ import { cva } from "class-variance-authority";
3
+ import { cn } from "@cl-light-ds/ui/lib/utils";
4
+ import type { HTMLAttributes } from "astro/types";
5
+
6
+ type ItemMediaVariant = "default" | "icon" | "image";
7
+
8
+ interface Props extends HTMLAttributes<"div"> {
9
+ mediaVariant?: ItemMediaVariant;
10
+ class?: string;
11
+ }
12
+
13
+ const {
14
+ class: className = "",
15
+ mediaVariant = "default",
16
+ ...rest
17
+ } = Astro.props as Props;
18
+
19
+ const itemMediaVariants = cva(
20
+ "flex shrink-0 items-center justify-center [&_svg]:pointer-events-none group-has-[[data-slot=item-description]]/item:self-start group-has-[[data-slot=item-description]]/item:translate-y-0.5 group-data-[size=header]/item:translate-y-0 group-data-[size=header]/item:self-auto",
21
+ {
22
+ variants: {
23
+ variant: {
24
+ default: "bg-transparent",
25
+ icon: "[&_svg:not([class*='size-'])]:size-4",
26
+ image:
27
+ "size-10 overflow-hidden rounded-sm group-data-[size=sm]/item:size-8 group-data-[size=header]/item:size-auto group-data-[size=header]/item:w-full group-data-[size=header]/item:aspect-square [&_img]:size-full [&_img]:object-cover",
28
+ },
29
+ },
30
+ defaultVariants: {
31
+ variant: "default",
32
+ },
33
+ },
34
+ );
35
+ ---
36
+
37
+ <div
38
+ {...rest}
39
+ data-slot="item-media"
40
+ class={cn(
41
+ "gap-2 group-has-data-[slot=item-description]/item:translate-y-0.5 group-has-data-[slot=item-description]/item:self-start group-data-[size=header]/item:translate-y-0 group-data-[size=header]/item:self-auto",
42
+ itemMediaVariants({ variant: mediaVariant }),
43
+ className,
44
+ )}
45
+ >
46
+ <slot />
47
+ </div>
@@ -1,21 +1,21 @@
1
- ---
2
- import { cn } from "@cl-light-ds/ui/lib/utils";
3
- import { Separator } from "../separator";
4
- import type { HTMLAttributes } from "astro/types";
5
-
6
- interface Props extends HTMLAttributes<"div"> {
7
- class?: string;
8
- }
9
-
10
- const {
11
- class: className = "",
12
- ...rest
13
- } = Astro.props as Props;
14
- ---
15
-
16
- <Separator
17
- {...rest}
18
- data-slot="item-separator"
19
- aria-hidden="true"
20
- class={cn("my-2", className)}
21
- />
1
+ ---
2
+ import { cn } from "@cl-light-ds/ui/lib/utils";
3
+ import { Separator } from "../separator";
4
+ import type { HTMLAttributes } from "astro/types";
5
+
6
+ interface Props extends HTMLAttributes<"div"> {
7
+ class?: string;
8
+ }
9
+
10
+ const {
11
+ class: className = "",
12
+ ...rest
13
+ } = Astro.props as Props;
14
+ ---
15
+
16
+ <Separator
17
+ {...rest}
18
+ data-slot="item-separator"
19
+ aria-hidden="true"
20
+ class={cn("my-2", className)}
21
+ />
@@ -1,25 +1,25 @@
1
- ---
2
- import { cn } from "@cl-light-ds/ui/lib/utils";
3
- import type { HTMLAttributes } from "astro/types";
4
-
5
- interface Props extends HTMLAttributes<"div"> {
6
- class?: string;
7
- }
8
-
9
- const {
10
- class: className = "",
11
- ...rest
12
- } = Astro.props as Props;
13
- ---
14
-
15
- <div
16
- {...rest}
17
- data-slot="item-title"
18
- class={cn(
19
- "gap-2 text-sm leading-snug font-semibold underline-offset-4 cn-font-heading",
20
- "flex w-fit items-center",
21
- className,
22
- )}
23
- >
24
- <slot />
25
- </div>
1
+ ---
2
+ import { cn } from "@cl-light-ds/ui/lib/utils";
3
+ import type { HTMLAttributes } from "astro/types";
4
+
5
+ interface Props extends HTMLAttributes<"div"> {
6
+ class?: string;
7
+ }
8
+
9
+ const {
10
+ class: className = "",
11
+ ...rest
12
+ } = Astro.props as Props;
13
+ ---
14
+
15
+ <div
16
+ {...rest}
17
+ data-slot="item-title"
18
+ class={cn(
19
+ "gap-2 text-sm leading-snug font-semibold underline-offset-4 cn-font-heading",
20
+ "flex w-fit items-center",
21
+ className,
22
+ )}
23
+ >
24
+ <slot />
25
+ </div>
@@ -1,145 +1,145 @@
1
- ---
2
- /**
3
- * @component Kbd
4
- * @title Kbd
5
- * @description A visual indicator for keyboard keys and shortcuts, styled to match system keyboard key appearance.
6
- * @status stable
7
- *
8
- * @preview
9
- *
10
- * <div class="flex flex-col items-center gap-4">
11
- * <KbdGroup>
12
- * <Kbd>⌘</Kbd>
13
- * <Kbd>⇧</Kbd>
14
- * <Kbd>⌥</Kbd>
15
- * <Kbd>⌃</Kbd>
16
- * </KbdGroup>
17
- * <KbdGroup>
18
- * <Kbd>Ctrl</Kbd>
19
- * <span>+</span>
20
- * <Kbd>B</Kbd>
21
- * </KbdGroup>
22
- * <KbdGroup>
23
- * <Kbd>⌘</Kbd>
24
- * <Kbd>K</Kbd>
25
- * </KbdGroup>
26
- * </div>
27
- *
28
- * @usage
29
- *
30
- * ```astro nocollapse
31
- * ---
32
- * import { Kbd, KbdGroup } from '@bejamas/ui/components/kbd';
33
- * ---
34
- *
35
- * <KbdGroup>
36
- * <Kbd>⌘</Kbd>
37
- * <Kbd>K</Kbd>
38
- * </KbdGroup>
39
- *
40
- * <KbdGroup>
41
- * <Kbd>Ctrl</Kbd>
42
- * <span>+</span>
43
- * <Kbd>B</Kbd>
44
- * </KbdGroup>
45
- * ```
46
- *
47
- * @examples
48
- *
49
- * ### Group
50
- *
51
- * Use the `KbdGroup` component to group keyboard keys together.
52
- *
53
- * <div class="flex flex-col items-center gap-4">
54
- * <p class="text-muted-foreground text-sm">
55
- * Use{" "}
56
- * <KbdGroup>
57
- * <Kbd>Ctrl + B</Kbd>
58
- * <Kbd>Ctrl + K</Kbd>
59
- * </KbdGroup>{" "}
60
- * to open the command palette
61
- * </p>
62
- * </div>
63
- *
64
- * ### Button
65
- *
66
- * Use the `Kbd` component inside a `Button` component to display a keyboard key inside a button.
67
- *
68
- * <Button variant="outline">
69
- * Accept <Kbd class="translate-x-0.5">
70
- * ⏎
71
- * </Kbd>
72
- * </Button>
73
- *
74
- * ### Tooltip
75
- *
76
- * You can use the `Kbd` component inside a `Tooltip` component to display a tooltip with a keyboard key.
77
- *
78
- * <div class="flex flex-wrap gap-4">
79
- * <Tooltip>
80
- * <TooltipTrigger asChild>
81
- * <Button variant="outline">Save</Button>
82
- * </TooltipTrigger>
83
- * <TooltipContent class="pr-1.5">
84
- * <div class="flex items-center gap-2">
85
- * Save Changes <Kbd>S</Kbd>
86
- * </div>
87
- * </TooltipContent>
88
- * </Tooltip>
89
- * <Tooltip>
90
- * <TooltipTrigger asChild>
91
- * <Button variant="outline">Print</Button>
92
- * </TooltipTrigger>
93
- * <TooltipContent class="pr-1.5">
94
- * <div class="flex items-center gap-2">
95
- * Print Document <KbdGroup>
96
- * <Kbd>Ctrl</Kbd>
97
- * <Kbd>P</Kbd>
98
- * </KbdGroup>
99
- * </div>
100
- * </TooltipContent>
101
- * </Tooltip>
102
- * </div>
103
- *
104
- * ### Input Group
105
- *
106
- * You can use the `Kbd` component inside a `InputGroupAddon` component to display a keyboard key inside an input group.
107
- *
108
- * <div class="flex w-full max-w-xs flex-col gap-6">
109
- * <InputGroup>
110
- * <InputGroupInput placeholder="Search..." />
111
- * <InputGroupAddon>
112
- * <SearchIcon />
113
- * </InputGroupAddon>
114
- * <InputGroupAddon align="inline-end">
115
- * <Kbd>⌘</Kbd>
116
- * <Kbd>K</Kbd>
117
- * </InputGroupAddon>
118
- * </InputGroup>
119
- * </div>
120
- *
121
- * @props
122
- * - class?: string — Additional classes for styling.
123
- */
124
-
125
- import { cn } from "@cl-light-ds/ui/lib/utils";
126
-
127
- const { class: className = "", ...props } = Astro.props;
128
- ---
129
-
130
- <kbd
131
- data-slot="kbd"
132
- class={cn("bg-muted text-muted-foreground in-data-[slot=tooltip-content]:bg-background/20 in-data-[slot=tooltip-content]:text-background dark:in-data-[slot=tooltip-content]:bg-background/10 h-5 w-fit min-w-5 gap-1 rounded-sm px-1 font-sans text-xs font-medium [&_svg:not([class*='size-'])]:size-3",
133
- "bg-muted text-muted-foreground",
134
- "[[data-slot=tooltip-content]_&]:bg-background/20 [[data-slot=tooltip-content]_&]:text-background",
135
- "dark:[[data-slot=tooltip-content]_&]:bg-background/10",
136
- "h-5 w-fit min-w-5 gap-1 rounded-sm px-1",
137
- "font-sans text-xs font-medium",
138
- "[&_svg:not([class*='size-'])]:size-3",
139
- "pointer-events-none inline-flex items-center justify-center select-none",
140
- className,
141
- )}
142
- {...props}
143
- >
144
- <slot />
145
- </kbd>
1
+ ---
2
+ /**
3
+ * @component Kbd
4
+ * @title Kbd
5
+ * @description A visual indicator for keyboard keys and shortcuts, styled to match system keyboard key appearance.
6
+ * @status stable
7
+ *
8
+ * @preview
9
+ *
10
+ * <div class="flex flex-col items-center gap-4">
11
+ * <KbdGroup>
12
+ * <Kbd>⌘</Kbd>
13
+ * <Kbd>⇧</Kbd>
14
+ * <Kbd>⌥</Kbd>
15
+ * <Kbd>⌃</Kbd>
16
+ * </KbdGroup>
17
+ * <KbdGroup>
18
+ * <Kbd>Ctrl</Kbd>
19
+ * <span>+</span>
20
+ * <Kbd>B</Kbd>
21
+ * </KbdGroup>
22
+ * <KbdGroup>
23
+ * <Kbd>⌘</Kbd>
24
+ * <Kbd>K</Kbd>
25
+ * </KbdGroup>
26
+ * </div>
27
+ *
28
+ * @usage
29
+ *
30
+ * ```astro nocollapse
31
+ * ---
32
+ * import { Kbd, KbdGroup } from '@bejamas/ui/components/kbd';
33
+ * ---
34
+ *
35
+ * <KbdGroup>
36
+ * <Kbd>⌘</Kbd>
37
+ * <Kbd>K</Kbd>
38
+ * </KbdGroup>
39
+ *
40
+ * <KbdGroup>
41
+ * <Kbd>Ctrl</Kbd>
42
+ * <span>+</span>
43
+ * <Kbd>B</Kbd>
44
+ * </KbdGroup>
45
+ * ```
46
+ *
47
+ * @examples
48
+ *
49
+ * ### Group
50
+ *
51
+ * Use the `KbdGroup` component to group keyboard keys together.
52
+ *
53
+ * <div class="flex flex-col items-center gap-4">
54
+ * <p class="text-muted-foreground text-sm">
55
+ * Use{" "}
56
+ * <KbdGroup>
57
+ * <Kbd>Ctrl + B</Kbd>
58
+ * <Kbd>Ctrl + K</Kbd>
59
+ * </KbdGroup>{" "}
60
+ * to open the command palette
61
+ * </p>
62
+ * </div>
63
+ *
64
+ * ### Button
65
+ *
66
+ * Use the `Kbd` component inside a `Button` component to display a keyboard key inside a button.
67
+ *
68
+ * <Button variant="outline">
69
+ * Accept <Kbd class="translate-x-0.5">
70
+ * ⏎
71
+ * </Kbd>
72
+ * </Button>
73
+ *
74
+ * ### Tooltip
75
+ *
76
+ * You can use the `Kbd` component inside a `Tooltip` component to display a tooltip with a keyboard key.
77
+ *
78
+ * <div class="flex flex-wrap gap-4">
79
+ * <Tooltip>
80
+ * <TooltipTrigger asChild>
81
+ * <Button variant="outline">Save</Button>
82
+ * </TooltipTrigger>
83
+ * <TooltipContent class="pr-1.5">
84
+ * <div class="flex items-center gap-2">
85
+ * Save Changes <Kbd>S</Kbd>
86
+ * </div>
87
+ * </TooltipContent>
88
+ * </Tooltip>
89
+ * <Tooltip>
90
+ * <TooltipTrigger asChild>
91
+ * <Button variant="outline">Print</Button>
92
+ * </TooltipTrigger>
93
+ * <TooltipContent class="pr-1.5">
94
+ * <div class="flex items-center gap-2">
95
+ * Print Document <KbdGroup>
96
+ * <Kbd>Ctrl</Kbd>
97
+ * <Kbd>P</Kbd>
98
+ * </KbdGroup>
99
+ * </div>
100
+ * </TooltipContent>
101
+ * </Tooltip>
102
+ * </div>
103
+ *
104
+ * ### Input Group
105
+ *
106
+ * You can use the `Kbd` component inside a `InputGroupAddon` component to display a keyboard key inside an input group.
107
+ *
108
+ * <div class="flex w-full max-w-xs flex-col gap-6">
109
+ * <InputGroup>
110
+ * <InputGroupInput placeholder="Search..." />
111
+ * <InputGroupAddon>
112
+ * <SearchIcon />
113
+ * </InputGroupAddon>
114
+ * <InputGroupAddon align="inline-end">
115
+ * <Kbd>⌘</Kbd>
116
+ * <Kbd>K</Kbd>
117
+ * </InputGroupAddon>
118
+ * </InputGroup>
119
+ * </div>
120
+ *
121
+ * @props
122
+ * - class?: string — Additional classes for styling.
123
+ */
124
+
125
+ import { cn } from "@cl-light-ds/ui/lib/utils";
126
+
127
+ const { class: className = "", ...props } = Astro.props;
128
+ ---
129
+
130
+ <kbd
131
+ data-slot="kbd"
132
+ class={cn("bg-muted text-muted-foreground in-data-[slot=tooltip-content]:bg-background/20 in-data-[slot=tooltip-content]:text-background dark:in-data-[slot=tooltip-content]:bg-background/10 h-5 w-fit min-w-5 gap-1 rounded-sm px-1 font-sans text-xs font-medium [&_svg:not([class*='size-'])]:size-3",
133
+ "bg-muted text-muted-foreground",
134
+ "[[data-slot=tooltip-content]_&]:bg-background/20 [[data-slot=tooltip-content]_&]:text-background",
135
+ "dark:[[data-slot=tooltip-content]_&]:bg-background/10",
136
+ "h-5 w-fit min-w-5 gap-1 rounded-sm px-1",
137
+ "font-sans text-xs font-medium",
138
+ "[&_svg:not([class*='size-'])]:size-3",
139
+ "pointer-events-none inline-flex items-center justify-center select-none",
140
+ className,
141
+ )}
142
+ {...props}
143
+ >
144
+ <slot />
145
+ </kbd>