@foundrykit/primitives 2.0.6 → 2.0.8

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 (319) hide show
  1. package/.turbo/turbo-build.log +233 -108
  2. package/.turbo/turbo-type-check.log +1 -1
  3. package/CHANGELOG.md +18 -0
  4. package/README.md +39 -136
  5. package/dist/chunk-25N35Z5M.js +42 -0
  6. package/dist/chunk-2JOT4DV4.js +66 -0
  7. package/dist/chunk-2PXD7LAX.js +172 -0
  8. package/dist/{chunk-VSXKLSEP.js → chunk-3BAO7TAS.js} +2 -2
  9. package/dist/chunk-3MEIDBWZ.js +225 -0
  10. package/dist/{chunk-A3U73FA7.js → chunk-3UKWAM5M.js} +2 -2
  11. package/dist/chunk-44I6VK3H.js +105 -0
  12. package/dist/chunk-46UI3AUE.js +62 -0
  13. package/dist/{chunk-AADRFFPH.js → chunk-5OSYIETI.js} +4 -4
  14. package/dist/chunk-67UXTT4O.js +116 -0
  15. package/dist/{chunk-J57CV3VT.js → chunk-6DRII3XC.js} +2 -2
  16. package/dist/chunk-727ACUWN.js +82 -0
  17. package/dist/chunk-76APYFRN.js +29 -0
  18. package/dist/chunk-AJAAMJYH.js +12 -0
  19. package/dist/chunk-BIFBYERK.js +69 -0
  20. package/dist/{chunk-PHMEWMFS.js → chunk-D4X2ZO5T.js} +7 -7
  21. package/dist/{chunk-UZIMC7AQ.js → chunk-DFGLEAZI.js} +2 -2
  22. package/dist/chunk-DKBMAFIR.js +65 -0
  23. package/dist/{chunk-U2EIVYWP.js → chunk-DXZ4GUQO.js} +2 -2
  24. package/dist/chunk-ED6T7ZZN.js +130 -0
  25. package/dist/{chunk-J4CRGO2P.js → chunk-EDKSYP4L.js} +2 -2
  26. package/dist/chunk-EEAK2RWF.js +23 -0
  27. package/dist/{chunk-FYCANIVJ.js → chunk-FF5D53KL.js} +2 -2
  28. package/dist/chunk-FIRYLO5W.js +253 -0
  29. package/dist/chunk-GPEL656S.js +84 -0
  30. package/dist/chunk-JKKCRFYB.js +36 -0
  31. package/dist/chunk-JTSIBZS4.js +194 -0
  32. package/dist/{chunk-QL4XJD7Y.js → chunk-MCXSVXO4.js} +2 -2
  33. package/dist/chunk-MMZJQ7RW.js +33 -0
  34. package/dist/{chunk-4GPFVBO2.js → chunk-MYIUX3DT.js} +3 -3
  35. package/dist/chunk-PAO3DSEF.js +48 -0
  36. package/dist/chunk-PLLG76QJ.js +32 -0
  37. package/dist/chunk-R3IEOV2B.js +155 -0
  38. package/dist/{chunk-KZMSLRLW.js → chunk-RDQF3IQE.js} +2 -2
  39. package/dist/{chunk-XQAJQKO7.js → chunk-SUEPE6OX.js} +3 -3
  40. package/dist/chunk-TA23RNS4.js +162 -0
  41. package/dist/chunk-TRXU4SOJ.js +224 -0
  42. package/dist/chunk-VA4MKQN7.js +40 -0
  43. package/dist/chunk-VPBVKBZ7.js +25 -0
  44. package/dist/{chunk-I44GXEPN.js → chunk-XVIHRZGJ.js} +1 -1
  45. package/dist/chunk-YT2ZIMZI.js +16 -0
  46. package/dist/components/accordion/index.cjs +104 -0
  47. package/dist/components/accordion/index.d.cts +25 -0
  48. package/dist/components/accordion/index.d.ts +25 -0
  49. package/dist/components/accordion/index.js +13 -0
  50. package/dist/components/alert/index.cjs +96 -0
  51. package/dist/components/alert/index.d.cts +28 -0
  52. package/dist/components/alert/index.d.ts +28 -0
  53. package/dist/components/alert/index.js +12 -0
  54. package/dist/components/alert-dialog/index.cjs +200 -0
  55. package/dist/components/alert-dialog/index.d.cts +42 -0
  56. package/dist/components/alert-dialog/index.d.ts +42 -0
  57. package/dist/components/alert-dialog/index.js +27 -0
  58. package/dist/components/aspect-ratio/index.cjs +47 -0
  59. package/dist/components/aspect-ratio/index.d.cts +19 -0
  60. package/dist/components/aspect-ratio/index.d.ts +19 -0
  61. package/dist/components/aspect-ratio/index.js +7 -0
  62. package/dist/components/avatar/index.cjs +1 -1
  63. package/dist/components/avatar/index.d.cts +16 -1
  64. package/dist/components/avatar/index.d.ts +16 -1
  65. package/dist/components/avatar/index.js +1 -1
  66. package/dist/components/badge/index.cjs +5 -5
  67. package/dist/components/badge/index.d.cts +13 -2
  68. package/dist/components/badge/index.d.ts +13 -2
  69. package/dist/components/badge/index.js +1 -1
  70. package/dist/components/breadcrumb/index.cjs +2 -2
  71. package/dist/components/breadcrumb/index.d.cts +19 -0
  72. package/dist/components/breadcrumb/index.d.ts +19 -0
  73. package/dist/components/breadcrumb/index.js +1 -1
  74. package/dist/components/button/index.cjs +18 -8
  75. package/dist/components/button/index.d.cts +15 -2
  76. package/dist/components/button/index.d.ts +15 -2
  77. package/dist/components/button/index.js +1 -1
  78. package/dist/components/button-group/index.cjs +142 -0
  79. package/dist/components/button-group/index.d.cts +33 -0
  80. package/dist/components/button-group/index.d.ts +33 -0
  81. package/dist/components/button-group/index.js +13 -0
  82. package/dist/components/card/index.cjs +2 -2
  83. package/dist/components/card/index.d.cts +16 -0
  84. package/dist/components/card/index.d.ts +16 -0
  85. package/dist/components/card/index.js +1 -1
  86. package/dist/components/checkbox/index.cjs +2 -2
  87. package/dist/components/checkbox/index.d.cts +11 -1
  88. package/dist/components/checkbox/index.d.ts +11 -1
  89. package/dist/components/checkbox/index.js +1 -1
  90. package/dist/components/collapsible/index.cjs +73 -0
  91. package/dist/components/collapsible/index.d.cts +22 -0
  92. package/dist/components/collapsible/index.d.ts +22 -0
  93. package/dist/components/collapsible/index.js +11 -0
  94. package/dist/components/context-menu/index.cjs +274 -0
  95. package/dist/components/context-menu/index.d.cts +48 -0
  96. package/dist/components/context-menu/index.d.ts +48 -0
  97. package/dist/components/context-menu/index.js +35 -0
  98. package/dist/components/direction/index.cjs +39 -0
  99. package/dist/components/direction/index.d.cts +20 -0
  100. package/dist/components/direction/index.d.ts +20 -0
  101. package/dist/components/direction/index.js +9 -0
  102. package/dist/components/drawer/index.cjs +164 -0
  103. package/dist/components/drawer/index.d.cts +35 -0
  104. package/dist/components/drawer/index.d.ts +35 -0
  105. package/dist/components/drawer/index.js +25 -0
  106. package/dist/components/dropdown/index.cjs +7 -7
  107. package/dist/components/dropdown/index.d.cts +25 -1
  108. package/dist/components/dropdown/index.d.ts +25 -1
  109. package/dist/components/dropdown/index.js +1 -1
  110. package/dist/components/empty/index.cjs +135 -0
  111. package/dist/components/empty/index.d.cts +38 -0
  112. package/dist/components/empty/index.d.ts +38 -0
  113. package/dist/components/empty/index.js +18 -0
  114. package/dist/components/field/index.cjs +269 -0
  115. package/dist/components/field/index.d.cts +42 -0
  116. package/dist/components/field/index.d.ts +42 -0
  117. package/dist/components/field/index.js +27 -0
  118. package/dist/components/hover-card/index.cjs +77 -0
  119. package/dist/components/hover-card/index.d.cts +22 -0
  120. package/dist/components/hover-card/index.d.ts +22 -0
  121. package/dist/components/hover-card/index.js +11 -0
  122. package/dist/components/input/index.cjs +2 -2
  123. package/dist/components/input/index.d.cts +11 -2
  124. package/dist/components/input/index.d.ts +11 -2
  125. package/dist/components/input/index.js +1 -1
  126. package/dist/components/item/index.cjs +262 -0
  127. package/dist/components/item/index.d.cts +47 -0
  128. package/dist/components/item/index.d.ts +47 -0
  129. package/dist/components/item/index.js +29 -0
  130. package/dist/components/kbd/index.cjs +57 -0
  131. package/dist/components/kbd/index.d.cts +19 -0
  132. package/dist/components/kbd/index.d.ts +19 -0
  133. package/dist/components/kbd/index.js +8 -0
  134. package/dist/components/label/index.cjs +2 -2
  135. package/dist/components/label/index.d.cts +10 -1
  136. package/dist/components/label/index.d.ts +10 -1
  137. package/dist/components/label/index.js +1 -1
  138. package/dist/components/menubar/index.cjs +303 -0
  139. package/dist/components/menubar/index.d.cts +49 -0
  140. package/dist/components/menubar/index.d.ts +49 -0
  141. package/dist/components/menubar/index.js +37 -0
  142. package/dist/components/native-select/index.cjs +53 -0
  143. package/dist/components/native-select/index.d.cts +19 -0
  144. package/dist/components/native-select/index.d.ts +19 -0
  145. package/dist/components/native-select/index.js +6 -0
  146. package/dist/components/navigation-menu/index.cjs +215 -0
  147. package/dist/components/navigation-menu/index.d.cts +37 -0
  148. package/dist/components/navigation-menu/index.d.ts +37 -0
  149. package/dist/components/navigation-menu/index.js +23 -0
  150. package/dist/components/popover/index.cjs +2 -2
  151. package/dist/components/popover/index.d.cts +14 -1
  152. package/dist/components/popover/index.d.ts +14 -1
  153. package/dist/components/popover/index.js +1 -1
  154. package/dist/components/progress/index.cjs +68 -0
  155. package/dist/components/progress/index.d.cts +16 -0
  156. package/dist/components/progress/index.d.ts +16 -0
  157. package/dist/components/progress/index.js +7 -0
  158. package/dist/components/radio-group/index.cjs +3 -3
  159. package/dist/components/radio-group/index.d.cts +15 -1
  160. package/dist/components/radio-group/index.d.ts +15 -1
  161. package/dist/components/radio-group/index.js +1 -1
  162. package/dist/components/resizable/index.cjs +75 -0
  163. package/dist/components/resizable/index.d.cts +25 -0
  164. package/dist/components/resizable/index.d.ts +25 -0
  165. package/dist/components/resizable/index.js +11 -0
  166. package/dist/components/scroll-area/index.cjs +3 -3
  167. package/dist/components/scroll-area/index.d.cts +14 -1
  168. package/dist/components/scroll-area/index.d.ts +14 -1
  169. package/dist/components/scroll-area/index.js +1 -1
  170. package/dist/components/select/index.cjs +4 -4
  171. package/dist/components/select/index.d.cts +19 -1
  172. package/dist/components/select/index.d.ts +19 -1
  173. package/dist/components/select/index.js +1 -1
  174. package/dist/components/separator/index.cjs +2 -2
  175. package/dist/components/separator/index.d.cts +12 -1
  176. package/dist/components/separator/index.d.ts +12 -1
  177. package/dist/components/separator/index.js +1 -1
  178. package/dist/components/skeleton/index.d.cts +9 -0
  179. package/dist/components/skeleton/index.d.ts +9 -0
  180. package/dist/components/slider/index.cjs +100 -0
  181. package/dist/components/slider/index.d.cts +18 -0
  182. package/dist/components/slider/index.d.ts +18 -0
  183. package/dist/components/slider/index.js +7 -0
  184. package/dist/components/sonner/index.cjs +51 -0
  185. package/dist/components/sonner/index.d.cts +18 -0
  186. package/dist/components/sonner/index.d.ts +18 -0
  187. package/dist/components/sonner/index.js +9 -0
  188. package/dist/components/spinner/index.cjs +47 -0
  189. package/dist/components/spinner/index.d.cts +17 -0
  190. package/dist/components/spinner/index.d.ts +17 -0
  191. package/dist/components/spinner/index.js +6 -0
  192. package/dist/components/switch/index.cjs +2 -2
  193. package/dist/components/switch/index.d.cts +11 -1
  194. package/dist/components/switch/index.d.ts +11 -1
  195. package/dist/components/switch/index.js +1 -1
  196. package/dist/components/table/index.cjs +147 -0
  197. package/dist/components/table/index.d.cts +35 -0
  198. package/dist/components/table/index.d.ts +35 -0
  199. package/dist/components/table/index.js +20 -0
  200. package/dist/components/tabs/index.cjs +2 -2
  201. package/dist/components/tabs/index.d.cts +18 -1
  202. package/dist/components/tabs/index.d.ts +18 -1
  203. package/dist/components/tabs/index.js +1 -1
  204. package/dist/components/textarea/index.cjs +1 -1
  205. package/dist/components/textarea/index.d.cts +9 -0
  206. package/dist/components/textarea/index.d.ts +9 -0
  207. package/dist/components/textarea/index.js +1 -1
  208. package/dist/components/toggle-group/index.cjs +120 -0
  209. package/dist/components/toggle-group/index.d.cts +27 -0
  210. package/dist/components/toggle-group/index.d.ts +27 -0
  211. package/dist/components/toggle-group/index.js +9 -0
  212. package/dist/components/typography/index.cjs +197 -0
  213. package/dist/components/typography/index.d.cts +28 -0
  214. package/dist/components/typography/index.d.ts +28 -0
  215. package/dist/components/typography/index.js +28 -0
  216. package/dist/index.cjs +3272 -781
  217. package/dist/index.d.cts +128 -24
  218. package/dist/index.d.ts +128 -24
  219. package/dist/index.js +485 -144
  220. package/package.json +25 -8
  221. package/postcss.config.mjs +1 -1
  222. package/registry.json +18 -5
  223. package/src/components/accordion/config.ts +28 -0
  224. package/src/components/accordion/index.tsx +80 -0
  225. package/src/components/alert/config.ts +40 -0
  226. package/src/components/alert/index.tsx +80 -0
  227. package/src/components/alert-dialog/config.ts +28 -0
  228. package/src/components/alert-dialog/index.tsx +188 -0
  229. package/src/components/aspect-ratio/config.ts +27 -0
  230. package/src/components/aspect-ratio/index.tsx +24 -0
  231. package/src/components/avatar/config.ts +1 -1
  232. package/src/components/avatar/index.tsx +18 -4
  233. package/src/components/badge/config.ts +1 -1
  234. package/src/components/badge/index.tsx +17 -7
  235. package/src/components/breadcrumb/config.ts +1 -1
  236. package/src/components/breadcrumb/index.tsx +24 -6
  237. package/src/components/button/config.ts +21 -1
  238. package/src/components/button/index.tsx +33 -9
  239. package/src/components/button-group/config.ts +39 -0
  240. package/src/components/button-group/index.tsx +99 -0
  241. package/src/components/card/config.ts +1 -1
  242. package/src/components/card/index.tsx +21 -6
  243. package/src/components/checkbox/config.ts +1 -1
  244. package/src/components/checkbox/index.tsx +13 -4
  245. package/src/components/collapsible/config.ts +27 -0
  246. package/src/components/collapsible/index.tsx +47 -0
  247. package/src/components/context-menu/config.ts +28 -0
  248. package/src/components/context-menu/index.tsx +271 -0
  249. package/src/components/dialog/config.ts +1 -1
  250. package/src/components/dialog/index.tsx +25 -6
  251. package/src/components/direction/config.ts +28 -0
  252. package/src/components/direction/index.tsx +27 -0
  253. package/src/components/drawer/config.ts +28 -0
  254. package/src/components/drawer/index.tsx +153 -0
  255. package/src/components/dropdown/config.ts +1 -1
  256. package/src/components/dropdown/index.tsx +37 -14
  257. package/src/components/empty/config.ts +38 -0
  258. package/src/components/empty/index.tsx +127 -0
  259. package/src/components/field/config.ts +40 -0
  260. package/src/components/field/index.tsx +252 -0
  261. package/src/components/hover-card/config.ts +27 -0
  262. package/src/components/hover-card/index.tsx +56 -0
  263. package/src/components/input/config.ts +1 -1
  264. package/src/components/input/index.tsx +13 -5
  265. package/src/components/input-group/index.tsx +33 -12
  266. package/src/components/item/config.ts +52 -0
  267. package/src/components/item/index.tsx +215 -0
  268. package/src/components/kbd/config.ts +38 -0
  269. package/src/components/kbd/index.tsx +40 -0
  270. package/src/components/label/config.ts +1 -1
  271. package/src/components/label/index.tsx +12 -4
  272. package/src/components/menubar/config.ts +28 -0
  273. package/src/components/menubar/index.tsx +295 -0
  274. package/src/components/native-select/config.ts +40 -0
  275. package/src/components/native-select/index.tsx +40 -0
  276. package/src/components/navigation-menu/config.ts +32 -0
  277. package/src/components/navigation-menu/index.tsx +188 -0
  278. package/src/components/popover/config.ts +1 -1
  279. package/src/components/popover/index.tsx +17 -5
  280. package/src/components/progress/config.ts +42 -0
  281. package/src/components/progress/index.tsx +39 -0
  282. package/src/components/radio-group/config.ts +1 -1
  283. package/src/components/radio-group/index.tsx +18 -5
  284. package/src/components/resizable/config.ts +28 -0
  285. package/src/components/resizable/index.tsx +67 -0
  286. package/src/components/scroll-area/index.tsx +17 -5
  287. package/src/components/select/config.ts +1 -1
  288. package/src/components/select/index.tsx +23 -6
  289. package/src/components/separator/config.ts +1 -1
  290. package/src/components/separator/index.tsx +14 -4
  291. package/src/components/sheet/index.tsx +21 -7
  292. package/src/components/skeleton/config.ts +1 -1
  293. package/src/components/skeleton/index.tsx +9 -0
  294. package/src/components/slider/config.ts +46 -0
  295. package/src/components/slider/index.tsx +73 -0
  296. package/src/components/sonner/config.ts +27 -0
  297. package/src/components/sonner/index.tsx +37 -0
  298. package/src/components/spinner/config.ts +40 -0
  299. package/src/components/spinner/index.tsx +30 -0
  300. package/src/components/switch/config.ts +1 -1
  301. package/src/components/switch/index.tsx +13 -4
  302. package/src/components/table/config.ts +38 -0
  303. package/src/components/table/index.tsx +135 -0
  304. package/src/components/tabs/config.ts +1 -1
  305. package/src/components/tabs/index.tsx +21 -5
  306. package/src/components/textarea/config.ts +1 -1
  307. package/src/components/textarea/index.tsx +11 -3
  308. package/src/components/toggle/index.tsx +20 -8
  309. package/src/components/toggle-group/config.ts +46 -0
  310. package/src/components/toggle-group/index.tsx +106 -0
  311. package/src/components/tooltip/index.tsx +19 -5
  312. package/src/components/typography/config.ts +38 -0
  313. package/src/components/typography/index.tsx +172 -0
  314. package/src/index.ts +239 -53
  315. package/tsup.config.ts +25 -0
  316. package/dist/chunk-FUWID6MC.js +0 -42
  317. package/dist/chunk-YTUI6MCB.js +0 -52
  318. package/eslint.config.js +0 -4
  319. package/dist/{chunk-VVNIYCKH.js → chunk-3TZXV53R.js} +1 -1
@@ -1,10 +1,22 @@
1
1
  'use client';
2
2
 
3
- import * as React from 'react';
4
- import * as AvatarPrimitive from '@radix-ui/react-avatar';
5
-
6
3
  import { cn } from '@foundrykit/utils';
4
+ import * as AvatarPrimitive from '@radix-ui/react-avatar';
5
+ import type * as React from 'react';
7
6
 
7
+ /**
8
+ * Circular avatar container built on Radix `Avatar.Root`. Compose with
9
+ * {@link AvatarImage} and {@link AvatarFallback}; the fallback shows while the
10
+ * image is loading or unavailable. Defaults to a `size-8` rounded shape.
11
+ *
12
+ * @example
13
+ * ```tsx
14
+ * <Avatar>
15
+ * <AvatarImage src="/user.png" alt="Jane" />
16
+ * <AvatarFallback>JD</AvatarFallback>
17
+ * </Avatar>
18
+ * ```
19
+ */
8
20
  function Avatar({
9
21
  className,
10
22
  ...props
@@ -21,6 +33,7 @@ function Avatar({
21
33
  );
22
34
  }
23
35
 
36
+ /** Image element (Radix `Avatar.Image`) rendered inside an {@link Avatar}. */
24
37
  function AvatarImage({
25
38
  className,
26
39
  ...props
@@ -34,6 +47,7 @@ function AvatarImage({
34
47
  );
35
48
  }
36
49
 
50
+ /** Fallback (Radix `Avatar.Fallback`) shown when the image cannot be displayed. */
37
51
  function AvatarFallback({
38
52
  className,
39
53
  ...props
@@ -50,4 +64,4 @@ function AvatarFallback({
50
64
  );
51
65
  }
52
66
 
53
- export { Avatar, AvatarImage, AvatarFallback };
67
+ export { Avatar, AvatarFallback, AvatarImage };
@@ -1,4 +1,4 @@
1
- import { ComponentConfig } from '@foundrykit/types';
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
2
 
3
3
  export const badgeConfig: ComponentConfig = {
4
4
  name: 'Badge',
@@ -1,20 +1,19 @@
1
- import * as React from 'react';
1
+ import { cn } from '@foundrykit/utils';
2
2
  import { Slot } from '@radix-ui/react-slot';
3
3
  import { cva, type VariantProps } from 'class-variance-authority';
4
-
5
- import { cn } from '@foundrykit/utils';
4
+ import type * as React from 'react';
6
5
 
7
6
  const badgeVariants = cva(
8
- 'inline-flex items-center justify-center rounded-md border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden',
7
+ 'focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive inline-flex w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-md border px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] [&>svg]:pointer-events-none [&>svg]:size-3',
9
8
  {
10
9
  variants: {
11
10
  variant: {
12
11
  default:
13
- 'border-transparent bg-primary text-primary-foreground [a&]:hover:bg-primary/90',
12
+ 'bg-primary text-primary-foreground [a&]:hover:bg-primary/90 border-transparent',
14
13
  secondary:
15
- 'border-transparent bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/90',
14
+ 'bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/90 border-transparent',
16
15
  destructive:
17
- 'border-transparent bg-destructive text-white [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60',
16
+ 'bg-destructive [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60 border-transparent text-white',
18
17
  outline:
19
18
  'text-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground',
20
19
  },
@@ -25,6 +24,17 @@ const badgeVariants = cva(
25
24
  }
26
25
  );
27
26
 
27
+ /**
28
+ * Small inline label/status indicator styled via {@link badgeVariants} with a
29
+ * `variant` (default, secondary, destructive, outline). Renders a `<span>` by
30
+ * default; pass `asChild` to render another element (e.g. a link) via Radix
31
+ * `Slot` while keeping the badge styling.
32
+ *
33
+ * @example
34
+ * ```tsx
35
+ * <Badge variant="secondary">Beta</Badge>
36
+ * ```
37
+ */
28
38
  function Badge({
29
39
  className,
30
40
  variant,
@@ -1,4 +1,4 @@
1
- import { ComponentConfig } from '@foundrykit/types';
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
2
 
3
3
  export const breadcrumbConfig: ComponentConfig = {
4
4
  name: 'Breadcrumb',
@@ -1,9 +1,25 @@
1
- import * as React from 'react';
1
+ import { cn } from '@foundrykit/utils';
2
2
  import { Slot } from '@radix-ui/react-slot';
3
3
  import { ChevronRight, MoreHorizontal } from 'lucide-react';
4
+ import type * as React from 'react';
4
5
 
5
- import { cn } from '@foundrykit/utils';
6
-
6
+ /**
7
+ * Breadcrumb navigation landmark (`<nav aria-label="breadcrumb">`). Compose the
8
+ * trail with {@link BreadcrumbList}, {@link BreadcrumbItem},
9
+ * {@link BreadcrumbLink}, {@link BreadcrumbPage} (current page),
10
+ * {@link BreadcrumbSeparator} and {@link BreadcrumbEllipsis}.
11
+ *
12
+ * @example
13
+ * ```tsx
14
+ * <Breadcrumb>
15
+ * <BreadcrumbList>
16
+ * <BreadcrumbItem><BreadcrumbLink href="/">Home</BreadcrumbLink></BreadcrumbItem>
17
+ * <BreadcrumbSeparator />
18
+ * <BreadcrumbItem><BreadcrumbPage>Settings</BreadcrumbPage></BreadcrumbItem>
19
+ * </BreadcrumbList>
20
+ * </Breadcrumb>
21
+ * ```
22
+ */
7
23
  function Breadcrumb({ ...props }: React.ComponentProps<'nav'>) {
8
24
  return <nav aria-label='breadcrumb' data-slot='breadcrumb' {...props} />;
9
25
  }
@@ -13,7 +29,7 @@ function BreadcrumbList({ className, ...props }: React.ComponentProps<'ol'>) {
13
29
  <ol
14
30
  data-slot='breadcrumb-list'
15
31
  className={cn(
16
- 'text-muted-foreground flex flex-wrap items-center gap-1.5 break-words text-sm sm:gap-2.5',
32
+ 'text-muted-foreground flex flex-wrap items-center gap-1.5 text-sm break-words sm:gap-2.5',
17
33
  className
18
34
  )}
19
35
  {...props}
@@ -31,6 +47,7 @@ function BreadcrumbItem({ className, ...props }: React.ComponentProps<'li'>) {
31
47
  );
32
48
  }
33
49
 
50
+ /** Interactive breadcrumb link (`<a>`, or any element via `asChild` + Radix `Slot`). */
34
51
  function BreadcrumbLink({
35
52
  asChild,
36
53
  className,
@@ -62,6 +79,7 @@ function BreadcrumbPage({ className, ...props }: React.ComponentProps<'span'>) {
62
79
  );
63
80
  }
64
81
 
82
+ /** Visual separator between items; defaults to a chevron when no children are given. */
65
83
  function BreadcrumbSeparator({
66
84
  children,
67
85
  className,
@@ -100,10 +118,10 @@ function BreadcrumbEllipsis({
100
118
 
101
119
  export {
102
120
  Breadcrumb,
103
- BreadcrumbList,
121
+ BreadcrumbEllipsis,
104
122
  BreadcrumbItem,
105
123
  BreadcrumbLink,
124
+ BreadcrumbList,
106
125
  BreadcrumbPage,
107
126
  BreadcrumbSeparator,
108
- BreadcrumbEllipsis,
109
127
  };
@@ -1,4 +1,4 @@
1
- import { ComponentConfig } from '@foundrykit/types';
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
2
 
3
3
  export const buttonConfig: ComponentConfig = {
4
4
  name: 'Button',
@@ -50,6 +50,26 @@ export const buttonConfig: ComponentConfig = {
50
50
  props: { variant: 'destructive', children: 'Destructive Button' },
51
51
  },
52
52
  },
53
+ {
54
+ name: 'Inline Link',
55
+ description: 'Inline text link that inherits the surrounding text color',
56
+ code: '<Button variant="inline-link">Inline link</Button>',
57
+ preview: {
58
+ type: 'component',
59
+ component: 'Button',
60
+ props: { variant: 'inline-link', children: 'Inline link' },
61
+ },
62
+ },
63
+ {
64
+ name: 'Nav Link',
65
+ description: 'Navigation link styling for nav bars and menus',
66
+ code: '<Button variant="navlink">Nav link</Button>',
67
+ preview: {
68
+ type: 'component',
69
+ component: 'Button',
70
+ props: { variant: 'navlink', children: 'Nav link' },
71
+ },
72
+ },
53
73
  {
54
74
  name: 'Small',
55
75
  description: 'Small button size',
@@ -1,33 +1,44 @@
1
- import * as React from 'react';
1
+ import { cn } from '@foundrykit/utils';
2
2
  import { Slot } from '@radix-ui/react-slot';
3
3
  import { cva, type VariantProps } from 'class-variance-authority';
4
-
5
- import { cn } from '@foundrykit/utils';
4
+ import type * as React from 'react';
6
5
 
7
6
  const buttonVariants = cva(
8
- "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
7
+ "focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive inline-flex shrink-0 items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-all outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
9
8
  {
10
9
  variants: {
11
10
  variant: {
12
11
  default:
13
- 'bg-primary text-primary-foreground shadow-xs hover:bg-primary/90',
12
+ 'bg-primary text-primary-foreground hover:bg-primary/90 shadow-xs',
14
13
  destructive:
15
- 'bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60',
14
+ 'bg-destructive hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60 text-white shadow-xs',
16
15
  outline:
17
- 'border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50',
16
+ 'bg-background hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 border shadow-xs',
18
17
  secondary:
19
- 'bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80',
18
+ 'bg-secondary text-secondary-foreground hover:bg-secondary/80 shadow-xs',
20
19
  ghost:
21
20
  'hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50',
22
21
  link: 'text-primary underline-offset-4 hover:underline',
22
+ 'inline-link':
23
+ 'inline align-baseline text-inherit underline underline-offset-4 hover:text-inherit',
24
+ navlink:
25
+ 'text-foreground hover:text-accent-foreground underline-offset-4 hover:underline',
23
26
  },
24
27
  size: {
25
28
  default: 'h-9 px-4 py-2 has-[>svg]:px-3',
26
- sm: 'h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5',
29
+ sm: 'h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5',
27
30
  lg: 'h-10 rounded-md px-6 has-[>svg]:px-4',
28
31
  icon: 'size-9',
29
32
  },
30
33
  },
34
+ // The link-style variants read as inline text, not a button box: strip the
35
+ // height/padding/radius that `size` would otherwise apply, across all sizes.
36
+ compoundVariants: [
37
+ {
38
+ variant: ['inline-link', 'navlink'],
39
+ className: 'h-auto rounded-none p-0 has-[>svg]:px-0',
40
+ },
41
+ ],
31
42
  defaultVariants: {
32
43
  variant: 'default',
33
44
  size: 'default',
@@ -38,9 +49,22 @@ const buttonVariants = cva(
38
49
  export interface ButtonProps
39
50
  extends React.ComponentProps<'button'>,
40
51
  VariantProps<typeof buttonVariants> {
52
+ /** Render as the child element (via Radix `Slot`) instead of a `<button>`. */
41
53
  asChild?: boolean;
42
54
  }
43
55
 
56
+ /**
57
+ * Clickable button with `variant` (default, destructive, outline, secondary,
58
+ * ghost, link, inline-link, navlink) and `size` (default, sm, lg, icon) styles from
59
+ * {@link buttonVariants}. Pass `asChild` to render a different element (e.g. a
60
+ * link) while keeping the button styling.
61
+ *
62
+ * @example
63
+ * ```tsx
64
+ * <Button variant="outline" size="sm">Cancel</Button>
65
+ * <Button asChild><a href="/docs">Docs</a></Button>
66
+ * ```
67
+ */
44
68
  function Button({
45
69
  className,
46
70
  variant,
@@ -0,0 +1,39 @@
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
+
3
+ export const ButtonGroupConfig: ComponentConfig = {
4
+ name: 'Button Group',
5
+ description: 'Groups related buttons into a single connected cluster.',
6
+ category: 'primitives',
7
+ tags: ['button-group', 'button', 'layout'],
8
+ preview: {
9
+ type: 'static',
10
+ html: '<div class="flex h-12 w-full items-center justify-center rounded-md bg-gray-200"><div class="flex"><div class="h-8 rounded-l-md border border-gray-300 bg-white px-3 text-sm leading-8 text-gray-600">One</div><div class="h-8 border border-l-0 border-gray-300 bg-white px-3 text-sm leading-8 text-gray-600">Two</div><div class="h-8 rounded-r-md border border-l-0 border-gray-300 bg-white px-3 text-sm leading-8 text-gray-600">Three</div></div></div>',
11
+ },
12
+ variants: [
13
+ {
14
+ name: 'Horizontal',
15
+ description: 'Default horizontal button group',
16
+ code: '<ButtonGroup><Button>One</Button><Button>Two</Button></ButtonGroup>',
17
+ preview: {
18
+ type: 'component',
19
+ component: 'ButtonGroup',
20
+ props: {},
21
+ },
22
+ },
23
+ {
24
+ name: 'Vertical',
25
+ description: 'Vertically stacked button group',
26
+ code: '<ButtonGroup orientation="vertical"><Button>One</Button><Button>Two</Button></ButtonGroup>',
27
+ preview: {
28
+ type: 'component',
29
+ component: 'ButtonGroup',
30
+ props: {
31
+ orientation: 'vertical',
32
+ },
33
+ },
34
+ },
35
+ ],
36
+ dependencies: ['utils', 'separator'],
37
+ packageDependencies: ['@radix-ui/react-slot', 'class-variance-authority'],
38
+ files: ['components/primitives/button-group/index.tsx'],
39
+ };
@@ -0,0 +1,99 @@
1
+ import { cn } from '@foundrykit/utils';
2
+ import { Slot } from '@radix-ui/react-slot';
3
+ import { cva, type VariantProps } from 'class-variance-authority';
4
+ import type * as React from 'react';
5
+ import { Separator } from '../separator/index.js';
6
+
7
+ const buttonGroupVariants = cva(
8
+ "flex w-fit items-stretch has-[>[data-slot=button-group]]:gap-2 [&>*]:focus-visible:relative [&>*]:focus-visible:z-10 [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1",
9
+ {
10
+ variants: {
11
+ orientation: {
12
+ horizontal:
13
+ '[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none',
14
+ vertical:
15
+ 'flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none',
16
+ },
17
+ },
18
+ defaultVariants: {
19
+ orientation: 'horizontal',
20
+ },
21
+ }
22
+ );
23
+
24
+ /**
25
+ * Groups related buttons (and compatible controls) into a single connected
26
+ * cluster, merging their adjacent borders and corners. Use `orientation`
27
+ * (`horizontal`/`vertical`) and compose with {@link ButtonGroupText} and
28
+ * {@link ButtonGroupSeparator}.
29
+ *
30
+ * @example
31
+ * ```tsx
32
+ * <ButtonGroup>
33
+ * <Button variant="outline">Prev</Button>
34
+ * <Button variant="outline">Next</Button>
35
+ * </ButtonGroup>
36
+ * ```
37
+ */
38
+ function ButtonGroup({
39
+ className,
40
+ orientation,
41
+ ...props
42
+ }: React.ComponentProps<'div'> & VariantProps<typeof buttonGroupVariants>) {
43
+ return (
44
+ <div
45
+ data-slot='button-group'
46
+ data-orientation={orientation}
47
+ role='group'
48
+ className={cn(buttonGroupVariants({ orientation }), className)}
49
+ {...props}
50
+ />
51
+ );
52
+ }
53
+
54
+ /** Non-interactive label segment inside a {@link ButtonGroup}; set `asChild` to render custom markup. */
55
+ function ButtonGroupText({
56
+ className,
57
+ asChild = false,
58
+ ...props
59
+ }: React.ComponentProps<'div'> & {
60
+ asChild?: boolean;
61
+ }) {
62
+ const Comp = asChild ? Slot : 'div';
63
+ return (
64
+ <Comp
65
+ data-slot='button-group-text'
66
+ className={cn(
67
+ "bg-muted flex items-center gap-2 rounded-md border px-4 text-sm font-medium shadow-xs [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
68
+ className
69
+ )}
70
+ {...props}
71
+ />
72
+ );
73
+ }
74
+
75
+ /** Divider between segments of a {@link ButtonGroup}; defaults to a vertical orientation. */
76
+ function ButtonGroupSeparator({
77
+ className,
78
+ orientation = 'vertical',
79
+ ...props
80
+ }: React.ComponentProps<typeof Separator>) {
81
+ return (
82
+ <Separator
83
+ data-slot='button-group-separator'
84
+ orientation={orientation}
85
+ className={cn(
86
+ 'bg-input relative !m-0 self-stretch data-[orientation=vertical]:h-auto',
87
+ className
88
+ )}
89
+ {...props}
90
+ />
91
+ );
92
+ }
93
+
94
+ export {
95
+ ButtonGroup,
96
+ ButtonGroupSeparator,
97
+ ButtonGroupText,
98
+ buttonGroupVariants,
99
+ };
@@ -1,4 +1,4 @@
1
- import { ComponentConfig } from '@foundrykit/types';
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
2
 
3
3
  export const cardConfig: ComponentConfig = {
4
4
  name: 'Card',
@@ -1,7 +1,22 @@
1
- import * as React from 'react';
2
-
3
1
  import { cn } from '@foundrykit/utils';
2
+ import * as React from 'react';
4
3
 
4
+ /**
5
+ * Bordered, rounded surface container for grouping related content. Compose with
6
+ * {@link CardHeader}, {@link CardTitle}, {@link CardDescription},
7
+ * {@link CardContent} and {@link CardFooter}. Forwards its ref to the root `<div>`.
8
+ *
9
+ * @example
10
+ * ```tsx
11
+ * <Card>
12
+ * <CardHeader>
13
+ * <CardTitle>Title</CardTitle>
14
+ * <CardDescription>Subtitle</CardDescription>
15
+ * </CardHeader>
16
+ * <CardContent>Body</CardContent>
17
+ * </Card>
18
+ * ```
19
+ */
5
20
  const Card = React.forwardRef<
6
21
  HTMLDivElement,
7
22
  React.HTMLAttributes<HTMLDivElement>
@@ -35,7 +50,7 @@ const CardTitle = React.forwardRef<
35
50
  >(({ className, ...props }, ref) => (
36
51
  <h3
37
52
  ref={ref}
38
- className={cn('font-semibold leading-none tracking-tight', className)}
53
+ className={cn('leading-none font-semibold tracking-tight', className)}
39
54
  {...props}
40
55
  />
41
56
  ));
@@ -75,9 +90,9 @@ CardFooter.displayName = 'CardFooter';
75
90
 
76
91
  export {
77
92
  Card,
78
- CardHeader,
93
+ CardContent,
94
+ CardDescription,
79
95
  CardFooter,
96
+ CardHeader,
80
97
  CardTitle,
81
- CardDescription,
82
- CardContent,
83
98
  };
@@ -1,4 +1,4 @@
1
- import { ComponentConfig } from '@foundrykit/types';
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
2
 
3
3
  export const checkboxConfig: ComponentConfig = {
4
4
  name: 'Checkbox',
@@ -1,11 +1,20 @@
1
1
  'use client';
2
2
 
3
- import * as React from 'react';
3
+ import { cn } from '@foundrykit/utils';
4
4
  import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
5
5
  import { CheckIcon } from 'lucide-react';
6
+ import type * as React from 'react';
6
7
 
7
- import { cn } from '@foundrykit/utils';
8
-
8
+ /**
9
+ * Checkbox built on Radix `Checkbox.Root`, rendering a check icon in its
10
+ * indicator when checked. Supports controlled/uncontrolled state, indeterminate,
11
+ * disabled and `aria-invalid` styling via the underlying Radix props.
12
+ *
13
+ * @example
14
+ * ```tsx
15
+ * <Checkbox checked={value} onCheckedChange={setValue} />
16
+ * ```
17
+ */
9
18
  function Checkbox({
10
19
  className,
11
20
  ...props
@@ -14,7 +23,7 @@ function Checkbox({
14
23
  <CheckboxPrimitive.Root
15
24
  data-slot='checkbox'
16
25
  className={cn(
17
- 'border-input dark:bg-input/30 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground dark:data-[state=checked]:bg-primary data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive shadow-xs peer size-4 shrink-0 rounded-[4px] border outline-none transition-shadow focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50',
26
+ 'border-input dark:bg-input/30 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground dark:data-[state=checked]:bg-primary data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive peer size-4 shrink-0 rounded-[4px] border shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50',
18
27
  className
19
28
  )}
20
29
  {...props}
@@ -0,0 +1,27 @@
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
+
3
+ export const CollapsibleConfig: ComponentConfig = {
4
+ name: 'Collapsible',
5
+ description: 'An interactive component which expands and collapses content.',
6
+ category: 'primitives',
7
+ tags: ['collapsible', 'disclosure', 'interactive'],
8
+ preview: {
9
+ type: 'static',
10
+ html: '<div class="flex h-12 w-full items-center rounded-md border border-gray-300 bg-gray-100 px-3"><span class="text-sm text-gray-600">Collapsible</span></div>',
11
+ },
12
+ variants: [
13
+ {
14
+ name: 'Default',
15
+ description: 'Default collapsible',
16
+ code: '<Collapsible>...</Collapsible>',
17
+ preview: {
18
+ type: 'component',
19
+ component: 'Collapsible',
20
+ props: {},
21
+ },
22
+ },
23
+ ],
24
+ dependencies: ['utils'],
25
+ packageDependencies: ['@radix-ui/react-collapsible'],
26
+ files: ['components/primitives/collapsible/index.tsx'],
27
+ };
@@ -0,0 +1,47 @@
1
+ 'use client';
2
+
3
+ import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
4
+ import type * as React from 'react';
5
+
6
+ /**
7
+ * Interactive component that expands and collapses a panel, built on Radix
8
+ * `Collapsible.Root`. Compose with {@link CollapsibleTrigger} and
9
+ * {@link CollapsibleContent}.
10
+ *
11
+ * @example
12
+ * ```tsx
13
+ * <Collapsible>
14
+ * <CollapsibleTrigger>Toggle</CollapsibleTrigger>
15
+ * <CollapsibleContent>Hidden content</CollapsibleContent>
16
+ * </Collapsible>
17
+ * ```
18
+ */
19
+ function Collapsible({
20
+ ...props
21
+ }: React.ComponentProps<typeof CollapsiblePrimitive.Root>) {
22
+ return <CollapsiblePrimitive.Root data-slot='collapsible' {...props} />;
23
+ }
24
+
25
+ function CollapsibleTrigger({
26
+ ...props
27
+ }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>) {
28
+ return (
29
+ <CollapsiblePrimitive.CollapsibleTrigger
30
+ data-slot='collapsible-trigger'
31
+ {...props}
32
+ />
33
+ );
34
+ }
35
+
36
+ function CollapsibleContent({
37
+ ...props
38
+ }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>) {
39
+ return (
40
+ <CollapsiblePrimitive.CollapsibleContent
41
+ data-slot='collapsible-content'
42
+ {...props}
43
+ />
44
+ );
45
+ }
46
+
47
+ export { Collapsible, CollapsibleContent, CollapsibleTrigger };
@@ -0,0 +1,28 @@
1
+ import type { ComponentConfig } from '@foundrykit/types';
2
+
3
+ export const ContextMenuConfig: ComponentConfig = {
4
+ name: 'Context Menu',
5
+ description:
6
+ 'Displays a menu to the user, such as a set of actions or functions, triggered by a right click.',
7
+ category: 'primitives',
8
+ tags: ['context-menu', 'menu', 'overlay', 'interactive'],
9
+ preview: {
10
+ type: 'static',
11
+ html: '<div class="flex h-12 w-full items-center rounded-md border border-gray-300 bg-gray-100 px-3"><span class="text-sm text-gray-600">Context Menu</span></div>',
12
+ },
13
+ variants: [
14
+ {
15
+ name: 'Default',
16
+ description: 'Default context menu',
17
+ code: '<ContextMenu>...</ContextMenu>',
18
+ preview: {
19
+ type: 'component',
20
+ component: 'ContextMenu',
21
+ props: {},
22
+ },
23
+ },
24
+ ],
25
+ dependencies: ['utils'],
26
+ packageDependencies: ['@radix-ui/react-context-menu', 'lucide-react'],
27
+ files: ['components/primitives/context-menu/index.tsx'],
28
+ };